com.atlassian.bamboo.repository
Interface BranchDetectionCapableRepository

All Superinterfaces:
BambooPluginModule, BranchAwareRepository, BuildConfigurationAwarePlugin, ConfigurablePlugin, ConvertibleFromConfig, DescriptionProvider, InitablePluginModule, NameProvider, RenderableBuildConfiguration, Repository, RepositoryV2, java.io.Serializable
All Known Subinterfaces:
BitbucketDelegatedRepository
All Known Implementing Classes:
AppLinksSvnRepository, BitbucketRepository, HgRepository, SvnRepository

public interface BranchDetectionCapableRepository
extends BranchAwareRepository

Repository that supports retrieving information about open branches. Used for monitoring plans for new branches.

Since:
4.0
See Also:
Repository

Field Summary
 
Fields inherited from interface com.atlassian.bamboo.repository.Repository
SELECTED_REPOSITORY, UNKNOWN_HOST
 
Method Summary
 CommitContext getFirstCommit()
          Retrieve the commit that created the Branch.
 CommitContext getLastCommit()
          Retrieve last commit on the branch set on this Repository.
 java.util.List<VcsBranch> getOpenBranches(java.lang.String context)
          Set of open branches that are discovered in the repository.
 
Methods inherited from interface com.atlassian.bamboo.repository.BranchAwareRepository
getVcsBranch, setVcsBranch
 
Methods inherited from interface com.atlassian.bamboo.repository.Repository
checkConnection, getHost, getKey, getLocationIdentifier, getMinimalEditHtml, getName, getShortKey
 
Methods inherited from interface com.atlassian.bamboo.fieldvalue.ConvertibleFromConfig
populateFromConfig, toConfiguration
 
Methods inherited from interface com.atlassian.bamboo.v2.build.repository.RepositoryV2
collectChangesSinceLastBuild, getSourceCodeDirectory, isRepositoryDifferent
 
Methods inherited from interface com.atlassian.bamboo.v2.build.ConfigurablePlugin
customizeBuildRequirements, removeBuildRequirements
 
Methods inherited from interface com.atlassian.bamboo.v2.build.BuildConfigurationAwarePlugin
addDefaultValues, prepareConfigObject, validate
 
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
 

Method Detail

getOpenBranches

@NotNull
java.util.List<VcsBranch> getOpenBranches(@Nullable
                                                  java.lang.String context)
                                          throws RepositoryException
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).

Returns:
List of branch names. May be empty.
Throws:
RepositoryException

getLastCommit

@Nullable
CommitContext getLastCommit()
                            throws RepositoryException
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.

Returns:
the last commit or null if N/A
Throws:
RepositoryException

getFirstCommit

@Nullable
CommitContext getFirstCommit()
                             throws RepositoryException
Retrieve the commit that created the Branch.

Returns:
the first commit to the branch
Throws:
RepositoryException


Copyright © 2013 Atlassian Software Systems Pty Ltd. All Rights Reserved.