com.atlassian.bamboo.plan.branch

Interface BranchCreationFacade

All Known Implementing Classes:

BranchCreationFacadeImpl

@ExperimentalApi
public interface BranchCreationFacade

Facade that orchestrates plan branches creation

Method Summary

Modifier and Type	Method and Description
ChainBranchCreationResult	createChainBranch(ImmutableChain chain, PlanBranchWorkflow planBranchWorkflow, String branchName, String branchDescription, VcsBranch vcsBranch, PlanCreationService.EnablePlan enablePlan, boolean enableExpiry) Given a branch name and (optionally) vcs branch name, creates a plan branch, overriding repository definition.
ChainBranchCreationResult	createChainBranch(ImmutableChain chain, PlanBranchWorkflow planBranchWorkflow, String branchName, String branchDescription, VcsBranch vcsBranch, PlanCreationService.EnablePlan enablePlan, boolean enableExpiry, com.atlassian.struts.ValidationAware validationAware) Given a branch name and (optionally) vcs branch name, creates a plan branch, overriding repository definition.
List<ChainBranchCreationResult>	createManualBranches(ImmutableChain chain, Collection<VcsBranch> branches, ErrorCollection errorCollection, PlanCreationService.EnablePlan enablePlan) Given a list of branches names, create plan branches for them under give chain.
void	createOrEnableChainsBranches(List<ImmutableChain> chains, PlanBranchWorkflow planBranchWorkflow, Function<VcsBranchConfigurator,VcsBranch> vcsBranchProvider, Function<ImmutableChain,BuildConfiguration> buildConfigurationProvider, Consumer<PlanKey> planBranchConsumer) Given a list of plans and a vcs branch creates plan branches for those chains, queuing RSS execution if required.
void	enableExistingChainBranch(ImmutableChain masterChain, ImmutableChainBranch existingChainBranch) Enables existing chain branch, queuing RSS execution if required.
List<VcsBranch>	getOpenBranches(ImmutableChain chain, ErrorCollection errorCollection) Returns a list of currently open branches for the chain's default repository List ordering determined by underlying repository (preference is for native ordering e.g.
boolean	scheduleBranchListInitialisation(Chain chain) Schedules initialisation of existing vcs branch list.

Method Detail

createOrEnableChainsBranches

void createOrEnableChainsBranches(@NotNull
                                  List<ImmutableChain> chains,
                                  @NotNull
                                  PlanBranchWorkflow planBranchWorkflow,
                                  @NotNull
                                  Function<VcsBranchConfigurator,VcsBranch> vcsBranchProvider,
                                  @NotNull
                                  Function<ImmutableChain,BuildConfiguration> buildConfigurationProvider,
                                  @NotNull
                                  Consumer<PlanKey> planBranchConsumer)

Given a list of plans and a vcs branch creates plan branches for those chains, queuing RSS execution if required.

If branch name conflicts with an existing plan branch, the name will be automatically generated.

Parameters:

chains - list of plans for which plan branches should be created

planBranchWorkflow - workflow which led to creation of these branches

vcsBranchProvider - provides VcsBranch to use when overriding repository definition

buildConfigurationProvider - provides a default fragment of configuration to create the chain branch with

planBranchConsumer - code should be executed before triggering events that new plan created

enableExistingChainBranch

void enableExistingChainBranch(@NotNull
                               ImmutableChain masterChain,
                               @NotNull
                               ImmutableChainBranch existingChainBranch)

Enables existing chain branch, queuing RSS execution if required. Does nothing if chain branch doesn't exist.

createManualBranches

@NotNull
List<ChainBranchCreationResult> createManualBranches(@NotNull
                                                              ImmutableChain chain,
                                                              @NotNull
                                                              Collection<VcsBranch> branches,
                                                              @Nullable
                                                              ErrorCollection errorCollection,
                                                              @NotNull
                                                              PlanCreationService.EnablePlan enablePlan)

Given a list of branches names, create plan branches for them under give chain. Enqueues RSS execution if required. Branches created using this method are excluded from expiration by default. Branches are considered to be "manual branches"

Parameters:

chain - chain for which plan branches should be created

branches - branches to create

errorCollection - to add errors to, if you don't supply an error collection, they will just get logged

enablePlan - defines whether newly created branches should be enabled or disabled after creation

Returns:

collection of branch keys (for created lightweight branches) and RSS executions futures (for enqueued divergent branches)

createChainBranch

@NotNull
ChainBranchCreationResult createChainBranch(@NotNull
                                                     ImmutableChain chain,
                                                     @NotNull
                                                     PlanBranchWorkflow planBranchWorkflow,
                                                     @NotNull
                                                     String branchName,
                                                     @Nullable
                                                     String branchDescription,
                                                     @Nullable
                                                     VcsBranch vcsBranch,
                                                     @NotNull
                                                     PlanCreationService.EnablePlan enablePlan,
                                                     boolean enableExpiry)
                                              throws PlanCreationDeniedException,
                                                     WebValidationException

Given a branch name and (optionally) vcs branch name, creates a plan branch, overriding repository definition. Returns either plan branch key if lightweight branch was created or future reference if divergent branch creation has been queued.

Parameters:

chain - chain for which plan branches should be created

planBranchWorkflow - workflow which led to creation of this chain branch

branchName - name of plan branch to create

branchDescription - optional description of the new branch

vcsBranch - VCS branch to use when overriding repository definition

enablePlan - defines whether newly created branches should be enabled or disabled after creation

enableExpiry - defines whether created branch can be removed due to branch expiration detection

Returns:

Throws:

PlanCreationDeniedException - if chain branch creation was denied for any reason

WebValidationException - if there were validation errors

createChainBranch

@Nullable
ChainBranchCreationResult createChainBranch(@NotNull
                                                      ImmutableChain chain,
                                                      @NotNull
                                                      PlanBranchWorkflow planBranchWorkflow,
                                                      @NotNull
                                                      String branchName,
                                                      @Nullable
                                                      String branchDescription,
                                                      @Nullable
                                                      VcsBranch vcsBranch,
                                                      @NotNull
                                                      PlanCreationService.EnablePlan enablePlan,
                                                      boolean enableExpiry,
                                                      @NotNull
                                                      com.atlassian.struts.ValidationAware validationAware)
                                               throws PlanCreationDeniedException

Given a branch name and (optionally) vcs branch name, creates a plan branch, overriding repository definition. Returns either plan branch key if lightweight branch was created or future reference if divergent branch creation has been queued.

Parameters:

chain - chain to create branches under

planBranchWorkflow - which workflow led to creation of this chain branch

branchName - name of plan branch to create

branchDescription - optional description of the new branch

vcsBranch - VCS branch to use when overriding repository definition

enablePlan - defines whether newly created branches should be enabled or disabled after creation

enableExpiry - defines whether created branch can be removed due to branch expiration detection

validationAware - to add errors to

Returns:

Null if there were validation errors. Otherwise either key of newly created lightweight plan branch or RSS execution future for enqueued divergent branch

Throws:

PlanCreationDeniedException - if chain branch creation was denied for any reason

scheduleBranchListInitialisation

boolean scheduleBranchListInitialisation(@NotNull
                                         Chain chain)

Schedules initialisation of existing vcs branch list. The next branch detection for the chain will only seek for existing branches but will not create any ChainBranches.

Parameters:

chain - chain which vcs branches list should be initialized

Returns:

false if another detection for this chain is already in progress or in queue

Throws:

IllegalStateException - if plan doesn't have default repository

getOpenBranches

@Nullable
List<VcsBranch> getOpenBranches(@NotNull
                                          ImmutableChain chain,
                                          @Nullable
                                          ErrorCollection errorCollection)

Returns a list of currently open branches for the chain's default repository List ordering determined by underlying repository (preference is for native ordering e.g. last updated first for hg)

Parameters:

chain - to find branches for

errorCollection - to add errors to

Returns:

a list of currently open branches for the chain's default repository or null if there were errors fetching branches list