com.atlassian.bamboo.plugins.bitbucket

Class BitbucketRepository

java.lang.Object

com.atlassian.bamboo.v2.build.BaseBuildConfigurationAwarePlugin

com.atlassian.bamboo.v2.build.BaseConfigurablePlugin

com.atlassian.bamboo.repository.AbstractRepository

com.atlassian.bamboo.repository.AbstractStandaloneRepository

com.atlassian.bamboo.plugins.bitbucket.BitbucketRepository

All Implemented Interfaces:

SharedCredentialDepender, ConvertibleFromConfig, InitablePluginModule, GitRepositoryFacade, AdvancedConfigurationAwareRepository, BranchAwareRepository, BranchDetectionCapableRepository, BranchInformationProvider, BranchMergingAwareRepository, CachingAwareRepository, CustomVariableProviderRepository, DeploymentAwareRepository, FilterChangesetAwareRepository, IncludeExcludeAwareRepository, OnceOffCapableRepository, PushCapableRepository, QuietPeriodAwareRepository, Repository, ScmTypePublishingRepository, StandaloneRepository, TestConnectionAwareRepository, EditActionAwareRepository, UniqueRevisionIdRepository, DescriptionProvider, NameProvider, BambooPluginModule, BuildConfigurationAwarePlugin, ConfigurablePlugin, RenderableBuildConfiguration, CustomSourceDirectoryAwareRepository, RepositoryV2, RequirementsAwareRepository, Serializable

public class BitbucketRepository
extends AbstractStandaloneRepository
implements BranchInformationProvider, BranchMergingAwareRepository, CachingAwareRepository, CustomSourceDirectoryAwareRepository, CustomVariableProviderRepository, DeploymentAwareRepository, GitRepositoryFacade, PushCapableRepository, RequirementsAwareRepository, UniqueRevisionIdRepository, ScmTypePublishingRepository, TestConnectionAwareRepository, SharedCredentialDepender, EditActionAwareRepository

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.bamboo.repository.CachingAwareRepository

CachingAwareRepository.CachableOperation

Field Summary

Fields

Modifier and Type	Field and Description
static String	REPOSITORY_BITBUCKET_ACCESS_LEVEL
static String	REPOSITORY_BITBUCKET_AUTHENTICATION_TYPE
static String	REPOSITORY_BITBUCKET_BRANCH
static String	REPOSITORY_BITBUCKET_COMMAND_TIMEOUT
static String	REPOSITORY_BITBUCKET_FETCH_WHOLE_REPOSITORY
static String	REPOSITORY_BITBUCKET_GIT_LFS
static String	REPOSITORY_BITBUCKET_GIT_USE_REMOTE_AGENT_CACHE
static String	REPOSITORY_BITBUCKET_GIT_USE_SHALLOW_CLONES
static String	REPOSITORY_BITBUCKET_GIT_USE_SUBMODULES
static String	REPOSITORY_BITBUCKET_OWNER
static String	REPOSITORY_BITBUCKET_PASSWORD
static String	REPOSITORY_BITBUCKET_PASSWORD_CHANGE
static String	REPOSITORY_BITBUCKET_PASSWORD_CREDENTIALS_SOURCE
static String	REPOSITORY_BITBUCKET_PASSWORD_SHARED_CREDENTIALS_DELETED
static String	REPOSITORY_BITBUCKET_PASSWORD_SHARED_CREDENTIALS_ID
static String	REPOSITORY_BITBUCKET_REPOSITORY
static String	REPOSITORY_BITBUCKET_SSH_CREDENTIALS_SOURCE
static String	REPOSITORY_BITBUCKET_SSH_KEY
static String	REPOSITORY_BITBUCKET_SSH_PASSPHRASE
static String	REPOSITORY_BITBUCKET_SSH_SHARED_CREDENTIALS_DELETED
static String	REPOSITORY_BITBUCKET_SSH_SHARED_CREDENTIALS_ID
static String	REPOSITORY_BITBUCKET_TEMPORARY_PASSWORD
static String	REPOSITORY_BITBUCKET_TEMPORARY_SSH_KEY_CHANGE
static String	REPOSITORY_BITBUCKET_TEMPORARY_SSH_KEY_FROM_FILE
static String	REPOSITORY_BITBUCKET_TEMPORARY_SSH_PASSPHRASE
static String	REPOSITORY_BITBUCKET_TEMPORARY_SSH_PASSPHRASE_CHANGE
static String	REPOSITORY_BITBUCKET_USERNAME
static String	REPOSITORY_BITBUCKET_VERBOSE_LOGS
static String	REPOSITORY_BITBUCKET_WEBHOOKS_ENABLED

Fields inherited from class com.atlassian.bamboo.repository.AbstractRepository

administrationConfigurationAccessor, BUILD_TRIGGER_IP, buildDirectoryManager, buildLoggerManager, customVariableContext, featureManager, REPO_PREFIX, repositoryModuleDescriptor, templateRenderer, textProvider

Fields inherited from class com.atlassian.bamboo.v2.build.BaseBuildConfigurationAwarePlugin

moduleDescriptor

Fields inherited from interface com.atlassian.bamboo.repository.Repository

SELECTED_REPOSITORY, UNKNOWN_HOST

Fields inherited from interface com.atlassian.bamboo.plugins.git.GitRepositoryFacade

GIT_REPOSITORIES_OF_PLAN

Fields inherited from interface com.atlassian.bamboo.repository.TestConnectionAwareRepository

HOST_KEY

Fields inherited from interface com.atlassian.bamboo.repository.IncludeExcludeAwareRepository

FILTER_PATTERN_EXCLUDE, FILTER_PATTERN_INCLUDE, FILTER_PATTERN_NONE, FILTER_PATTERN_OPTION, FILTER_PATTERN_REGEX

Fields inherited from interface com.atlassian.bamboo.repository.FilterChangesetAwareRepository

CHANGESET_FILTER_PATTERN_REGEX, MAVEN_RELEASE_PLUGIN_EXCLUSION_PATTERN

Constructor Summary

Constructors

Constructor and Description
BitbucketRepository()

Method Summary

Modifier and Type	Method and Description
void	addDefaultValues(@NotNull BuildConfiguration buildConfiguration) Extension point for adding default values to the form for RenderableBuildConfiguration.getEditHtml(com.atlassian.bamboo.ww2.actions.build.admin.create.BuildConfiguration, com.atlassian.bamboo.plan.Plan)
BitbucketAuthenticationType	authenticationType()
void	beforeEditPageRendering(@NotNull org.apache.commons.configuration.HierarchicalConfiguration configuration) Action to be taken before rendering the edit page.
ErrorCollection	beforeSave(@NotNull org.apache.commons.configuration.HierarchicalConfiguration configuration) Action to be taken before repository is saved from the UI.
@NotNull BuildRepositoryChanges	collectChangesForRevision(@NotNull PlanKey planKey, @NotNull String targetRevision) Collects the changes for the targetRevision.
@NotNull BuildRepositoryChanges	collectChangesSinceLastBuild(@NotNull String planKey, @Nullable String lastVcsRevisionKey) Collects the changes since the lastVcsRevisionKey.
@NotNull String	commit(@NotNull File sourceDirectory, @NotNull String message) Perform a commit (dvcs commit).
BitbucketAccessLevel	getAccessLevel()
@NotNull List<NameValuePair>	getAccessLevels()
CacheId	getCacheId(@NotNull CachingAwareRepository.CachableOperation cachableOperation) Cache id has to fulfill the following: Given two Repository objects A and B, returning equal CacheId (in terms of equals()) and a cachable operation foo(), in the following sequence of calls made in a short time period: 1.
CapabilityContext	getCapabilityContext()
@NotNull Map<String,String>	getCustomVariables() Return a map containing name->value mapping of the variables.
CommitContext	getFirstCommit() Retrieve the commit that created the Branch.
@Nullable GitRepository	getGitRepository()
String	getHost() What's the repository server host
CommitContext	getLastCommit() Retrieve last commit on the branch set on this Repository.
@NotNull String	getName() The display name for the repository type
@NotNull List<VcsBranch>	getOpenBranches(@Nullable String context) Set of open branches that are discovered in the repository.
String	getOptionDescription()
@Nullable String	getOwner()
@Nullable String	getPassword()
BitbucketPasswordCredentialsSource	getPasswordCredentialsSource()
@NotNull List<NameValuePair>	getPasswordCredentialsSources()
@NotNull List<NameValuePair>	getPasswordSharedCredentials()
@Nullable Long	getPasswordSharedCredentialsId()
@NotNull Map<String,String>	getPlanRepositoryVariables() Return a map containing name->value mapping of the plan repository format variables.
@NotNull List<NameValuePair>	getPrivateRepositoryAuthenticationTypes()
String	getRealRepositoryUrl()
String	getRepositoryOwner()
String	getRepositorySlug()
@NotNull Set<Requirement>	getRequirements()
String	getScm() Get a string representing the name of the repository type.
@NotNull Iterable<Long>	getSharedCredentialIds() Returns a list of shared credential ids used by this class.
BitbucketSshCredentialsSource	getSshCredentialsSource()
@NotNull List<NameValuePair>	getSshCredentialsSources()
@NotNull List<NameValuePair>	getSshSharedCredentials()
@Nullable String	getUsername()
@NotNull VcsBranch	getVcsBranch()
boolean	isCachingSupportedFor(@NotNull CachingAwareRepository.CachableOperation cachableOperation)
boolean	isFetchWholeRepository()
boolean	isMergingSupported()
boolean	isRepositoryDifferent(@NotNull Repository repository) Checks if the current repo is the same as the given repository
boolean	isVerboseLogs()
boolean	mergeWorkspaceWith(@NotNull BuildContext buildContext, @NotNull File checkoutDirectory, @NotNull String targetRevision) Merges a workspace located in checkout directory with the target revision.
void	populateFromConfig(@NotNull org.apache.commons.configuration.HierarchicalConfiguration config) Update the current object with data in the HierarchicalConfiguration
void	prepareConfigObject(@NotNull BuildConfiguration buildConfiguration) Do any preprocessing work before validation occurs.
void	pushRevision(@NotNull File sourceDirectory, @Nullable String vcsRevisionKey) Push the specified revision to the remote directory.
@NotNull String	retrieveSourceCode(@NotNull BuildContext buildContext, @Nullable String vcsRevisionKey, @NotNull File sourceDirectory) Checks out the latest source code from an appropriate repository to specified directory
@NotNull String	retrieveSourceCode(@NotNull BuildContext buildContext, @Nullable String vcsRevisionKey, @NotNull File sourceDirectory, int depth) Checks out the latest source code from an appropriate repository to specified directory
void	setBitbucketApiService(BitbucketApiService bitbucketApiService)
void	setBitbucketValidationHelper(BitbucketValidationHelper bitbucketValidationHelper)
void	setCapabilityContext(CapabilityContext capabilityContext)
void	setCredentialsAccessor(CredentialsAccessor credentialsAccessor)
void	setI18nResolver(com.atlassian.sal.api.message.I18nResolver i18nResolver)
void	setRepositoryHelperService(BitbucketRepositoryHelperService repositoryHelperService)
void	setRepositoryManager(RepositoryManager repositoryManager)
void	setVcsBranch(@NotNull VcsBranch branch) Set and prepare the repository for using an arbitrary branch.
@NotNull ErrorCollection	testConnection(long timeout, @NotNull TimeUnit unit) Test connection to the repository within the given timeout.
@NotNull org.apache.commons.configuration.HierarchicalConfiguration	toConfiguration() Generate a HierarchicalConfiguration from the current state of the object
boolean	usePollingForBranchDetection() If Bamboo generic detection polling should be used for this repository
@NotNull ErrorCollection	validate(@NotNull BuildConfiguration configuration) Validates the properties in the BuildConfiguration object.
@NotNull ErrorCollection	validateForConnectionTesting(@NotNull BuildConfiguration configuration) A method similar to BuildConfigurationAwarePlugin.validate(BuildConfiguration) used to validate repository configuration before connection testing.

Methods inherited from class com.atlassian.bamboo.repository.AbstractStandaloneRepository

getAdvancedEditHtml, getAdvancedViewHtml, getEditHtml, getViewHtml, getViewHtml

Methods inherited from class com.atlassian.bamboo.repository.AbstractRepository

checkConnection, customizeBuildRequirements, getAdvancedEditHtml, getAdvancedViewHtml, getBranchIntegrationEditHtml, getChangesetFilterPatternRegex, getDefaultTriggerModule, getDescription, getEditHtml, getFilterFilePatternOption, getFilterFilePatternRegex, getKey, getLocationIdentifier, getMavenPomCheckoutAccessEditHtml, getMaxCommitsToReturn, getMaxRetries, getMinimalEditHtml, getPollingTriggerModule, getQuietPeriod, getShortKey, getSourceCodeDirectory, getSystemWideExclusionPatterns, getViewHtml, getWorkingDirectory, init, isAdvancedOptionEnabled, isQuietPeriodEnabled, isWorkspaceEmpty, removeBuildRequirements, setAdministrationConfigurationAccessor, setBuildDirectoryManager, setBuildLoggerManager, setChangesetFilterPatternRegex, setCustomVariableContext, setFeatureManager, setFilterFilePatternOption, setFilterFilePatternRegex, setTemplateRenderer, setTextProvider, setWorkingDir, substituteString, toMergeCapableRepository

Methods inherited from class com.atlassian.bamboo.v2.build.BaseBuildConfigurationAwarePlugin

getTemplateRenderer, populateContextForEdit, populateContextForView

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.atlassian.bamboo.repository.Repository

checkConnection, getKey, getLocationIdentifier, getMinimalEditHtml, getShortKey

Methods inherited from interface com.atlassian.bamboo.v2.build.repository.RepositoryV2

getSourceCodeDirectory

Methods inherited from interface com.atlassian.bamboo.v2.build.ConfigurablePlugin

customizeBuildRequirements, removeBuildRequirements

Methods inherited from interface com.atlassian.bamboo.v2.build.BuildConfigurationAwarePlugin

isConfigurationMissing

Methods inherited from interface com.atlassian.bamboo.plugin.InitablePluginModule

init

Methods inherited from interface com.atlassian.bamboo.v2.build.RenderableBuildConfiguration

getEditHtml, getViewHtml

Methods inherited from interface com.atlassian.bamboo.utils.DescriptionProvider

getDescription

Methods inherited from interface com.atlassian.bamboo.repository.BranchMergingAwareRepository

getBranchIntegrationEditHtml

Field Detail

REPOSITORY_BITBUCKET_ACCESS_LEVEL

public static final String REPOSITORY_BITBUCKET_ACCESS_LEVEL

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_AUTHENTICATION_TYPE

public static final String REPOSITORY_BITBUCKET_AUTHENTICATION_TYPE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_OWNER

public static final String REPOSITORY_BITBUCKET_OWNER

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_USERNAME

public static final String REPOSITORY_BITBUCKET_USERNAME

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_PASSWORD

public static final String REPOSITORY_BITBUCKET_PASSWORD

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_PASSWORD_CREDENTIALS_SOURCE

public static final String REPOSITORY_BITBUCKET_PASSWORD_CREDENTIALS_SOURCE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_PASSWORD_SHARED_CREDENTIALS_ID

public static final String REPOSITORY_BITBUCKET_PASSWORD_SHARED_CREDENTIALS_ID

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_PASSWORD_SHARED_CREDENTIALS_DELETED

public static final String REPOSITORY_BITBUCKET_PASSWORD_SHARED_CREDENTIALS_DELETED

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_REPOSITORY

public static final String REPOSITORY_BITBUCKET_REPOSITORY

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_SSH_CREDENTIALS_SOURCE

public static final String REPOSITORY_BITBUCKET_SSH_CREDENTIALS_SOURCE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_SSH_SHARED_CREDENTIALS_ID

public static final String REPOSITORY_BITBUCKET_SSH_SHARED_CREDENTIALS_ID

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_SSH_SHARED_CREDENTIALS_DELETED

public static final String REPOSITORY_BITBUCKET_SSH_SHARED_CREDENTIALS_DELETED

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_SSH_KEY

public static final String REPOSITORY_BITBUCKET_SSH_KEY

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_SSH_PASSPHRASE

public static final String REPOSITORY_BITBUCKET_SSH_PASSPHRASE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_BRANCH

public static final String REPOSITORY_BITBUCKET_BRANCH

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_COMMAND_TIMEOUT

public static final String REPOSITORY_BITBUCKET_COMMAND_TIMEOUT

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_VERBOSE_LOGS

public static final String REPOSITORY_BITBUCKET_VERBOSE_LOGS

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_FETCH_WHOLE_REPOSITORY

public static final String REPOSITORY_BITBUCKET_FETCH_WHOLE_REPOSITORY

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_GIT_USE_SHALLOW_CLONES

public static final String REPOSITORY_BITBUCKET_GIT_USE_SHALLOW_CLONES

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_GIT_LFS

public static final String REPOSITORY_BITBUCKET_GIT_LFS

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_GIT_USE_SUBMODULES

public static final String REPOSITORY_BITBUCKET_GIT_USE_SUBMODULES

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_GIT_USE_REMOTE_AGENT_CACHE

public static final String REPOSITORY_BITBUCKET_GIT_USE_REMOTE_AGENT_CACHE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_TEMPORARY_PASSWORD

public static final String REPOSITORY_BITBUCKET_TEMPORARY_PASSWORD

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_PASSWORD_CHANGE

public static final String REPOSITORY_BITBUCKET_PASSWORD_CHANGE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_TEMPORARY_SSH_PASSPHRASE

public static final String REPOSITORY_BITBUCKET_TEMPORARY_SSH_PASSPHRASE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_TEMPORARY_SSH_PASSPHRASE_CHANGE

public static final String REPOSITORY_BITBUCKET_TEMPORARY_SSH_PASSPHRASE_CHANGE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_TEMPORARY_SSH_KEY_FROM_FILE

public static final String REPOSITORY_BITBUCKET_TEMPORARY_SSH_KEY_FROM_FILE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_TEMPORARY_SSH_KEY_CHANGE

public static final String REPOSITORY_BITBUCKET_TEMPORARY_SSH_KEY_CHANGE

See Also:

Constant Field Values

REPOSITORY_BITBUCKET_WEBHOOKS_ENABLED

public static final String REPOSITORY_BITBUCKET_WEBHOOKS_ENABLED

See Also:

Constant Field Values

Constructor Detail

BitbucketRepository

public BitbucketRepository()

Method Detail

getName

@NotNull
public @NotNull String getName()

Description copied from interface: Repository

The display name for the repository type

Specified by:

getName in interface Repository

Specified by:

getName in interface DescriptionProvider

Specified by:

getName in interface NameProvider

getScm

public String getScm()

Description copied from interface: ScmTypePublishingRepository

Get a string representing the name of the repository type. (e.g. "git")

Specified by:

getScm in interface ScmTypePublishingRepository

Returns:

a string representing the name of the repository type. (e.g. "git")

getHost

public String getHost()

Description copied from interface: Repository

What's the repository server host

Specified by:

getHost in interface Repository

Returns:

The host!

isRepositoryDifferent

public boolean isRepositoryDifferent(@NotNull
                                     @NotNull Repository repository)

Description copied from interface: RepositoryV2

Checks if the current repo is the same as the given repository

Specified by:

isRepositoryDifferent in interface RepositoryV2

Parameters:

repository - to compare against

Returns:

true of repositories are different, false if the same;

addDefaultValues

public void addDefaultValues(@NotNull
                             @NotNull BuildConfiguration buildConfiguration)

Description copied from interface: BuildConfigurationAwarePlugin

Extension point for adding default values to the form for RenderableBuildConfiguration.getEditHtml(com.atlassian.bamboo.ww2.actions.build.admin.create.BuildConfiguration, com.atlassian.bamboo.plan.Plan)

Specified by:

addDefaultValues in interface BuildConfigurationAwarePlugin

Overrides:

addDefaultValues in class AbstractRepository

Parameters:

buildConfiguration - -

beforeEditPageRendering

public void beforeEditPageRendering(@NotNull
                                    @NotNull org.apache.commons.configuration.HierarchicalConfiguration configuration)

Description copied from interface: EditActionAwareRepository

Action to be taken before rendering the edit page. Configuration can be modified by this method. Example use is verifying configuration so that proper warnings can be displayed before user takes any action.

Specified by:

beforeEditPageRendering in interface EditActionAwareRepository

Parameters:

configuration - configuration to be loaded into the UI

beforeSave

public ErrorCollection beforeSave(@NotNull
                                  @NotNull org.apache.commons.configuration.HierarchicalConfiguration configuration)

Description copied from interface: EditActionAwareRepository

Action to be taken before repository is saved from the UI. The method is called after the validate() method and only if validation is successful. If this method returns with error the configuration is not saved. Configuration can be modified by this method and the changes will be persisted.

Specified by:

beforeSave in interface EditActionAwareRepository

Returns:

collection of error messages. Should be empty if call is successful.

prepareConfigObject

public void prepareConfigObject(@NotNull
                                @NotNull BuildConfiguration buildConfiguration)

Description copied from interface: BuildConfigurationAwarePlugin

Do any preprocessing work before validation occurs. For repository, builder and web repository plugins this will only be called if the plugin is select by the user.

Specified by:

prepareConfigObject in interface BuildConfigurationAwarePlugin

Overrides:

prepareConfigObject in class BaseBuildConfigurationAwarePlugin

Parameters:

buildConfiguration - -

populateFromConfig

public void populateFromConfig(@NotNull
                               @NotNull org.apache.commons.configuration.HierarchicalConfiguration config)

Description copied from interface: ConvertibleFromConfig

Update the current object with data in the HierarchicalConfiguration

Specified by:

populateFromConfig in interface ConvertibleFromConfig

Overrides:

populateFromConfig in class AbstractRepository

toConfiguration

@NotNull
public @NotNull org.apache.commons.configuration.HierarchicalConfiguration toConfiguration()

Description copied from interface: ConvertibleFromConfig

Generate a HierarchicalConfiguration from the current state of the object

Specified by:

toConfiguration in interface ConvertibleFromConfig

Overrides:

toConfiguration in class AbstractRepository

Returns:

Always returns an HierarchicalConfiguration. Never null

validateForConnectionTesting

@NotNull
public @NotNull ErrorCollection validateForConnectionTesting(@NotNull
                                                                      @NotNull BuildConfiguration configuration)

Description copied from interface: TestConnectionAwareRepository

A method similar to BuildConfigurationAwarePlugin.validate(BuildConfiguration) used to validate repository configuration before connection testing. This method may be more relaxed than normal validation. Additionally, different error messages may be displayed (e.g. related to impossibility of transferring files).

Specified by:

validateForConnectionTesting in interface TestConnectionAwareRepository

Parameters:

configuration - repository configuration to validate

Returns:

validation errors

validate

@NotNull
public @NotNull ErrorCollection validate(@NotNull
                                                  @NotNull BuildConfiguration configuration)

Description copied from interface: BuildConfigurationAwarePlugin

Validates the properties in the BuildConfiguration object. The name of the properties match those passed in through the form fragments in RenderableBuildConfiguration.getEditHtml(com.atlassian.bamboo.ww2.actions.build.admin.create.BuildConfiguration, com.atlassian.bamboo.plan.Plan) template.

Specified by:

validate in interface BuildConfigurationAwarePlugin

Overrides:

validate in class AbstractRepository

Parameters:

configuration - -

Returns:

ErrorCollection keyed by the field name.

getPasswordSharedCredentialsId

@Nullable
public @Nullable Long getPasswordSharedCredentialsId()

getSharedCredentialIds

@NotNull
public @NotNull Iterable<Long> getSharedCredentialIds()

Description copied from interface: SharedCredentialDepender

Returns a list of shared credential ids used by this class.

Specified by:

getSharedCredentialIds in interface SharedCredentialDepender

Returns:

the list of shared credential ids used by this class.

getPasswordCredentialsSources

@NotNull
public @NotNull List<NameValuePair> getPasswordCredentialsSources()

getSshCredentialsSources

@NotNull
public @NotNull List<NameValuePair> getSshCredentialsSources()

getPasswordSharedCredentials

@NotNull
public @NotNull List<NameValuePair> getPasswordSharedCredentials()

getSshSharedCredentials

@NotNull
public @NotNull List<NameValuePair> getSshSharedCredentials()

getAccessLevels

@NotNull
public @NotNull List<NameValuePair> getAccessLevels()

getPrivateRepositoryAuthenticationTypes

@NotNull
public @NotNull List<NameValuePair> getPrivateRepositoryAuthenticationTypes()

collectChangesForRevision

@NotNull
public @NotNull BuildRepositoryChanges collectChangesForRevision(@NotNull
                                                                          @NotNull PlanKey planKey,
                                                                          @NotNull
                                                                          @NotNull String targetRevision)
                                                                   throws RepositoryException

Description copied from interface: OnceOffCapableRepository

Collects the changes for the targetRevision. This method is called only on server side (never on agent).

Specified by:

collectChangesForRevision in interface OnceOffCapableRepository

Overrides:

collectChangesForRevision in class AbstractRepository

Returns:

A build changes object with the appropriate build changes (that is - with the single commit data relevant for targetRevision)

Throws:

RepositoryException - if something goes wrong

collectChangesSinceLastBuild

@NotNull
public @NotNull BuildRepositoryChanges collectChangesSinceLastBuild(@NotNull
                                                                             @NotNull String planKey,
                                                                             @Nullable
                                                                             @Nullable String lastVcsRevisionKey)
                                                                      throws RepositoryException

Description copied from interface: RepositoryV2

Collects the changes since the lastVcsRevisionKey. This method is called only on server side (never on agent).

Specified by:

collectChangesSinceLastBuild in interface RepositoryV2

lastVcsRevisionKey - can be null, if null you should ensure the correct vcsrevisionkey is returned in the BuildChanges object.

Returns:

A build changes object with the appropriate build changes

Throws:

RepositoryException - if something goes wrong

retrieveSourceCode

@NotNull
public @NotNull String retrieveSourceCode(@NotNull
                                                   @NotNull BuildContext buildContext,
                                                   @Nullable
                                                   @Nullable String vcsRevisionKey,
                                                   @NotNull
                                                   @NotNull File sourceDirectory)
                                            throws RepositoryException

Description copied from interface: CustomSourceDirectoryAwareRepository

Checks out the latest source code from an appropriate repository to specified directory

Specified by:

retrieveSourceCode in interface CustomSourceDirectoryAwareRepository

vcsRevisionKey - - may be null if you want latest code

sourceDirectory - - directory to checkout to

Returns:

vcsRevisionKey - the revision

Throws:

RepositoryException

retrieveSourceCode

@NotNull
public @NotNull String retrieveSourceCode(@NotNull
                                                   @NotNull BuildContext buildContext,
                                                   @Nullable
                                                   @Nullable String vcsRevisionKey,
                                                   @NotNull
                                                   @NotNull File sourceDirectory,
                                                   int depth)
                                            throws RepositoryException

Description copied from interface: BranchMergingAwareRepository

Checks out the latest source code from an appropriate repository to specified directory

Specified by:

retrieveSourceCode in interface BranchMergingAwareRepository

vcsRevisionKey - - may be null if you want latest code

sourceDirectory - - directory to checkout to

depth - - how many historical revisions we'd like to check out (-1 means all revisions)

Returns:

vcsRevisionKey - the revision

Throws:

RepositoryException

testConnection

@NotNull
public @NotNull ErrorCollection testConnection(long timeout,
                                                        @NotNull
                                                        @NotNull TimeUnit unit)

Description copied from interface: TestConnectionAwareRepository

Test connection to the repository within the given timeout. The method should stop executing after the given time elapses.

Specified by:

testConnection in interface TestConnectionAwareRepository

Parameters:

timeout - the maximum time to wait

unit - the time unit of the timeout argument

Returns:

Errors discovered during testing connection. Empty error collection should be returned if connection was successful. The errors should be translated to error messages, rather than field errors. Field errors are used by Bamboo to handle special cases.

getRequirements

@NotNull
public @NotNull Set<Requirement> getRequirements()

Specified by:

getRequirements in interface RequirementsAwareRepository

setBitbucketApiService

public void setBitbucketApiService(BitbucketApiService bitbucketApiService)

setRepositoryHelperService

public void setRepositoryHelperService(BitbucketRepositoryHelperService repositoryHelperService)

setI18nResolver

public void setI18nResolver(com.atlassian.sal.api.message.I18nResolver i18nResolver)

setRepositoryManager

public void setRepositoryManager(RepositoryManager repositoryManager)

setCredentialsAccessor

public void setCredentialsAccessor(CredentialsAccessor credentialsAccessor)

setBitbucketValidationHelper

public void setBitbucketValidationHelper(BitbucketValidationHelper bitbucketValidationHelper)

getCapabilityContext

public CapabilityContext getCapabilityContext()

setCapabilityContext

public void setCapabilityContext(CapabilityContext capabilityContext)

getRealRepositoryUrl

public String getRealRepositoryUrl()

isVerboseLogs

public boolean isVerboseLogs()

isFetchWholeRepository

public boolean isFetchWholeRepository()

getOptionDescription

public String getOptionDescription()

getCacheId

public CacheId getCacheId(@NotNull
                          @NotNull CachingAwareRepository.CachableOperation cachableOperation)

Description copied from interface: CachingAwareRepository

Cache id has to fulfill the following: Given two Repository objects A and B, returning equal CacheId (in terms of equals()) and a cachable operation foo(), in the following sequence of calls made in a short time period: 1. A::foo() 2. B::foo() 3. A::foo() the result of B::foo() should be the same as either the first or the second call to A::foo().

Specified by:

getCacheId in interface CachingAwareRepository

Returns:

the cache id of repository, null if the supplied operation cannot be cached

isCachingSupportedFor

public boolean isCachingSupportedFor(@NotNull
                                     @NotNull CachingAwareRepository.CachableOperation cachableOperation)

Specified by:

isCachingSupportedFor in interface CachingAwareRepository

Returns:

true if the repository supports generation of CacheIds for a given operation

getOpenBranches

@NotNull
public @NotNull List<VcsBranch> getOpenBranches(@Nullable
                                                         @Nullable String context)
                                                  throws RepositoryException

Description copied from interface: BranchDetectionCapableRepository

Set of open branches that are discovered in the repository. Returns empty collection if no branches at all (can that happen?). Used for monitoring repositories for new branches. An open branch is a branch that is considered 'open' by underlying VCS - it has nothing to do with the actual development on that branch (recent commits or so).

Specified by:

getOpenBranches in interface BranchDetectionCapableRepository

Returns:

List of branch names. May be empty.

Throws:

RepositoryException

getOwner

@Nullable
public @Nullable String getOwner()

getUsername

@Nullable
public @Nullable String getUsername()

getPassword

@Nullable
public @Nullable String getPassword()

getAccessLevel

public BitbucketAccessLevel getAccessLevel()

authenticationType

public BitbucketAuthenticationType authenticationType()

getPasswordCredentialsSource

public BitbucketPasswordCredentialsSource getPasswordCredentialsSource()

getSshCredentialsSource

public BitbucketSshCredentialsSource getSshCredentialsSource()

getRepositoryOwner

public String getRepositoryOwner()

getRepositorySlug

public String getRepositorySlug()

getVcsBranch

@NotNull
public @NotNull VcsBranch getVcsBranch()

Specified by:

getVcsBranch in interface BranchAwareRepository

Returns:

the branch being used currently by this repository.

setVcsBranch

public void setVcsBranch(@NotNull
                         @NotNull VcsBranch branch)

Description copied from interface: BranchAwareRepository

Set and prepare the repository for using an arbitrary branch. Generally the subsequent getVcsBranch should return the same branch name.

Specified by:

setVcsBranch in interface BranchAwareRepository

getFirstCommit

public CommitContext getFirstCommit()
                             throws RepositoryException

Description copied from interface: BranchDetectionCapableRepository

Retrieve the commit that created the Branch.

Specified by:

getFirstCommit in interface BranchDetectionCapableRepository

Returns:

the first commit to the branch

Throws:

RepositoryException

getLastCommit

public CommitContext getLastCommit()
                            throws RepositoryException

Description copied from interface: BranchDetectionCapableRepository

Retrieve last commit on the branch set on this Repository. Method is used by Chain Branch automatic expiry. If this method returns null Chain Branch is not expired.

Specified by:

getLastCommit in interface BranchDetectionCapableRepository

Returns:

the last commit or null if N/A

Throws:

RepositoryException

mergeWorkspaceWith

public boolean mergeWorkspaceWith(@NotNull
                                  @NotNull BuildContext buildContext,
                                  @NotNull
                                  @NotNull File checkoutDirectory,
                                  @NotNull
                                  @NotNull String targetRevision)
                           throws RepositoryException

Description copied from interface: BranchMergingAwareRepository

Merges a workspace located in checkout directory with the target revision.

Specified by:

mergeWorkspaceWith in interface BranchMergingAwareRepository

Parameters:

buildContext - the build context of build doing the merge

checkoutDirectory - the workspace to use for merge

targetRevision - the revision to merge with

Returns:

true if the result of the merge would result in a non-empty commit

Throws:

RepositoryException

isMergingSupported

public boolean isMergingSupported()

Specified by:

isMergingSupported in interface BranchMergingAwareRepository

pushRevision

public void pushRevision(@NotNull
                         @NotNull File sourceDirectory,
                         @Nullable
                         @Nullable String vcsRevisionKey)
                  throws RepositoryException

Description copied from interface: PushCapableRepository

Push the specified revision to the remote directory. Throws RepositoryException when failed due to connection problems or similar.

Specified by:

pushRevision in interface PushCapableRepository

Parameters:

sourceDirectory - - the working directory of the repository we want to push from

vcsRevisionKey - - the revisionKey (usually a branch name) to push

Throws:

RepositoryException - - when something goes wrong

commit

@NotNull
public @NotNull String commit(@NotNull
                                       @NotNull File sourceDirectory,
                                       @NotNull
                                       @NotNull String message)
                                throws RepositoryException

Description copied from interface: PushCapableRepository

Perform a commit (dvcs commit).

Specified by:

commit in interface PushCapableRepository

Parameters:

sourceDirectory - - which workspace directory to perform the commit

message - - what message use for commit

Returns:

Created commit revision key

Throws:

RepositoryException - - when something goes wrong

usePollingForBranchDetection

public boolean usePollingForBranchDetection()

Description copied from interface: BranchInformationProvider

If Bamboo generic detection polling should be used for this repository

Specified by:

usePollingForBranchDetection in interface BranchInformationProvider

Returns:

getGitRepository

@Nullable
public @Nullable GitRepository getGitRepository()

Specified by:

getGitRepository in interface GitRepositoryFacade

getCustomVariables

@NotNull
public @NotNull Map<String,String> getCustomVariables()

Description copied from interface: CustomVariableProviderRepository

Return a map containing name->value mapping of the variables.

Null values will be filtered out so it's safe to put them in the map.

Specified by:

getCustomVariables in interface CustomVariableProviderRepository

Returns:

Map with variable substitutions

getPlanRepositoryVariables

@NotNull
public @NotNull Map<String,String> getPlanRepositoryVariables()

Description copied from interface: CustomVariableProviderRepository

Return a map containing name->value mapping of the plan repository format variables.

Null values will be filtered out so it's safe to put them in the map.

Specified by:

getPlanRepositoryVariables in interface CustomVariableProviderRepository

Returns:

Map with variable substitutions