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:

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