com.atlassian.bamboo.plugins.hg
Class HgRepository

java.lang.Object
  com.atlassian.bamboo.v2.build.BaseBuildConfigurationAwarePlugin
      com.atlassian.bamboo.v2.build.BaseConfigurablePlugin
          com.atlassian.bamboo.repository.AbstractRepository
              com.atlassian.bamboo.plugins.hg.HgRepository

All Implemented Interfaces:

ConvertibleFromConfig, InitablePluginModule, CleanCheckoutAwareRepository, CleanWorkingDirectoryAwareRepository, CustomVariableProviderRepository, IncludeExcludeAwareRepository, MavenPomAccessorCapableRepository, Repository, DescriptionProvider, NameProvider, BambooPluginModule, BuildConfigurationAwarePlugin, ConfigurablePlugin, PostConfigurableRepository, RepositoryV2, java.io.Serializable

public class HgRepository
extends AbstractRepository
implements PostConfigurableRepository, MavenPomAccessorCapableRepository, CustomVariableProviderRepository

See Also:

Serialized Form

Field Summary

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

BUILD_TRIGGER_IP, buildDirectoryManager, buildLoggerManager, CLEAN_CHECKOUT_PARAM, CLEAN_WORKING_DIRECTORY_PARAM, repositoryModuleDescriptor, templateRenderer, textProvider, variableSubstitutionBean

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.repository.IncludeExcludeAwareRepository

FILTER_PATTERN_EXCLUDE, FILTER_PATTERN_INCLUDE, FILTER_PATTERN_OPTION, FILTER_PATTERN_REGEX

Constructor Summary

HgRepository()

Method Summary

void	addDefaultValues(BuildConfiguration buildConfiguration) Extension point for adding default values to the form for BuildConfigurationAwarePlugin.getEditHtml(com.atlassian.bamboo.ww2.actions.build.admin.create.BuildConfiguration, com.atlassian.bamboo.plan.Plan)
BuildChanges	collectChangesSinceLastBuild(java.lang.String planKey, java.lang.String lastVcsRevisionKey) Collects the changes since the lastVcsRevisionKey
AuthenticationType	getAuthenticationType()
java.util.List<AuthenticationType>	getAuthenticationTypes()
java.lang.String	getBranch()
static java.io.File	getCacheBaseDirectory(BuildDirectoryManager buildDirectoryManager) Separate static method so we can define the cache base directory in one place
java.io.File	getCacheDirectory()
static java.io.File	getCacheDirectory(java.io.File baseDirectory, java.lang.String repositoryUrl, java.lang.String username)
int	getCommandTimeout()
java.util.Map<java.lang.String,java.lang.String>	getCustomVariables() Return a map containing name->value mapping of the variables.
java.lang.String	getHgExeCapability()
java.lang.String	getHost() What's the repository server host
java.lang.String	getLocationIdentifier() A string representing the location of the repository
MavenPomAccessor	getMavenPomAccessor()
java.lang.String	getName() The display name for the repository type
java.lang.String	getPassword()
java.net.URI	getRemoteUri()
java.lang.String	getRepositoryUrl()
boolean	getSshCompression()
java.lang.String	getSshExeCapability()
java.lang.String	getUsername()
boolean	isHgExecutableSet() For configuration screens
boolean	isRepositoryDifferent(Repository repository) Checks if the current repo is the same as the given repository
boolean	isVerboseLogs()
protected boolean	isWorkspaceEmpty(java.io.File sourceCodeDirectory)
void	performPostConfiguration(BuildConfiguration buildConfiguration, Plan plan) Allows any other configuration to be performed after another repository has been created.
void	performPostConfigurationForSelectedRepository(BuildConfiguration buildConfiguration, Plan plan) Allows any other configuration to be performed after this repository has been created
void	populateFromConfig(org.apache.commons.configuration.HierarchicalConfiguration config) Update the current object with data in the HierarchicalConfiguration
void	prepareConfigObject(BuildConfiguration buildConfiguration) Do any preprocessing work before validation occurs.
java.lang.String	retrieveSourceCode(BuildContext buildContext, java.lang.String vcsRevision) Checks out the latest source code to an appropriate repository
java.lang.String	retrieveSourceCode(java.lang.String planKey, java.lang.String vcsRevisionKey) Checks out the latest source code to an appropriate repository
void	setCapabilityContext(CapabilityContext capabilityContext)
void	setTextProvider(com.opensymphony.xwork.TextProvider textProvider)
org.apache.commons.configuration.HierarchicalConfiguration	toConfiguration() Generate a HierarchicalConfiguration from the current state of the object
ErrorCollection	validate(BuildConfiguration buildConfiguration) Validates the properties in the BuildConfiguration object.

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

checkConnection, createStringFromList, customizeBuildRequirements, getDescription, getEditHtml, getFilterFilePatternOption, getFilterFilePatternRegex, getKey, getMavenPomCheckoutAccessEditHtml, getMinimalEditHtml, getShortKey, getSourceCodeDirectory, getTriggerIpAddress, getVariableSubstitutionBean, getViewHtml, getWorkingDirectory, init, isCleanCheckout, isCleanWorkingDirectory, referencesDifferentRepository, removeBuildRequirements, setBuildDirectoryManager, setBuildLoggerManager, setCleanCheckout, setCleanWorkingDirectory, setFilterFilePatternOption, setFilterFilePatternRegex, setReferencesDifferentRepository, setTemplateRenderer, setTriggerIpAddress, setVariableSubstitutionBean, setWorkingDir

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

customizeBuildRequirements, removeBuildRequirements

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

isConfigurationMissing, 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, getMinimalEditHtml, getShortKey, getTriggerIpAddress, setReferencesDifferentRepository

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

getSourceCodeDirectory, referencesDifferentRepository

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

customizeBuildRequirements, removeBuildRequirements

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

getEditHtml, getViewHtml

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

getDescription

Constructor Detail

HgRepository

public HgRepository()

Method Detail

getName

@NotNull
public java.lang.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

getHost

public java.lang.String getHost()

Description copied from interface: Repository

What's the repository server host

Specified by:

getHost in interface Repository

Returns:

The host!

getLocationIdentifier

@NotNull
public java.lang.String getLocationIdentifier()

Description copied from interface: Repository

A string representing the location of the repository

Specified by:

getLocationIdentifier in interface Repository

Overrides:

getLocationIdentifier in class AbstractRepository

Returns:

isRepositoryDifferent

public boolean isRepositoryDifferent(@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;

getCacheDirectory

@NotNull
public java.io.File getCacheDirectory()
                               throws RepositoryException

Throws:

RepositoryException

getCacheBaseDirectory

public static java.io.File getCacheBaseDirectory(BuildDirectoryManager buildDirectoryManager)

Separate static method so we can define the cache base directory in one place

Parameters:

buildDirectoryManager - buildDirectoryManager to get the locations from

Returns:

base directory where the caches should be created

See Also:

DeleteHgCacheDirectoryOnAgentMessage

getCacheDirectory

@NotNull
public static java.io.File getCacheDirectory(java.io.File baseDirectory,
                                                     java.lang.String repositoryUrl,
                                                     java.lang.String username)

collectChangesSinceLastBuild

@NotNull
public BuildChanges collectChangesSinceLastBuild(@NotNull
                                                         java.lang.String planKey,
                                                         @Nullable
                                                         java.lang.String lastVcsRevisionKey)
                                          throws RepositoryException

Description copied from interface: RepositoryV2

Collects the changes since the lastVcsRevisionKey

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 java.lang.String retrieveSourceCode(@NotNull
                                                   BuildContext buildContext,
                                                   @Nullable
                                                   java.lang.String vcsRevision)
                                    throws RepositoryException

Description copied from interface: RepositoryV2

Checks out the latest source code to an appropriate repository

Specified by:

retrieveSourceCode in interface RepositoryV2

vcsRevision - - may be null if you want latest code

Returns:

vcsRevisionKey - the revision

Throws:

RepositoryException

performPostConfiguration

public void performPostConfiguration(BuildConfiguration buildConfiguration,
                                     Plan plan)

Description copied from interface: PostConfigurableRepository

Allows any other configuration to be performed after another repository has been created.

Specified by:

performPostConfiguration in interface PostConfigurableRepository

performPostConfigurationForSelectedRepository

public void performPostConfigurationForSelectedRepository(BuildConfiguration buildConfiguration,
                                                          Plan plan)

Description copied from interface: PostConfigurableRepository

Allows any other configuration to be performed after this repository has been created

Specified by:

performPostConfigurationForSelectedRepository in interface PostConfigurableRepository

retrieveSourceCode

@NotNull
public java.lang.String retrieveSourceCode(@NotNull
                                                   java.lang.String planKey,
                                                   @Nullable
                                                   java.lang.String vcsRevisionKey)
                                    throws RepositoryException

Description copied from interface: RepositoryV2

Checks out the latest source code to an appropriate repository

Specified by:

retrieveSourceCode in interface RepositoryV2

vcsRevisionKey - - may be null if you want latest code

Returns:

vcsRevisionKey - the revision

Throws:

RepositoryException

addDefaultValues

public void addDefaultValues(@NotNull
                             BuildConfiguration buildConfiguration)

Description copied from interface: BuildConfigurationAwarePlugin

Extension point for adding default values to the form for BuildConfigurationAwarePlugin.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 - - @NotNull

prepareConfigObject

public void prepareConfigObject(@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 - - @NotNull

populateFromConfig

public void populateFromConfig(@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 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

getCustomVariables

@NotNull
public java.util.Map<java.lang.String,java.lang.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

validate

@NotNull
public ErrorCollection validate(@NotNull
                                        BuildConfiguration buildConfiguration)

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 BuildConfigurationAwarePlugin.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:

buildConfiguration - - @NotNull

Returns:

ErrorCollection keyed by the field name. @NotNull

getMavenPomAccessor

@NotNull
public MavenPomAccessor getMavenPomAccessor()

Specified by:

getMavenPomAccessor in interface MavenPomAccessorCapableRepository

isWorkspaceEmpty

protected boolean isWorkspaceEmpty(java.io.File sourceCodeDirectory)

Overrides:

isWorkspaceEmpty in class AbstractRepository

isHgExecutableSet

public boolean isHgExecutableSet()

For configuration screens

Returns:

true if mercurial capability is set

getHgExeCapability

@Nullable
public java.lang.String getHgExeCapability()

getSshExeCapability

@Nullable
public java.lang.String getSshExeCapability()

getRepositoryUrl

public java.lang.String getRepositoryUrl()

getRemoteUri

@Nullable
public java.net.URI getRemoteUri()

getBranch

public java.lang.String getBranch()

getUsername

public java.lang.String getUsername()

getPassword

public java.lang.String getPassword()

getSshCompression

public boolean getSshCompression()

getCommandTimeout

public int getCommandTimeout()

isVerboseLogs

public boolean isVerboseLogs()

setCapabilityContext

public void setCapabilityContext(CapabilityContext capabilityContext)

getAuthenticationTypes

@NotNull
public java.util.List<AuthenticationType> getAuthenticationTypes()

getAuthenticationType

@NotNull
public AuthenticationType getAuthenticationType()

setTextProvider

public void setTextProvider(com.opensymphony.xwork.TextProvider textProvider)

Overrides:

setTextProvider in class AbstractRepository