com.atlassian.bamboo.plan.stage

Interface StageService

public interface StageService

Service for performing stage related configuration

Since:

TODO

Method Summary

Methods

Modifier and Type	Method and Description
ImmutableChainStage	addStage(PlanKey planKey, String name, String description, boolean isManual) Adds a new stage to the specified plan.
void	deleteStage(PlanKey planKey, long stageId, BambooClosures.Throwing1<ImmutableChainStage,WebValidationException>... runBefore) Deletes the given stage and any jobs under the stage.
ImmutableChainStage	getStage(PlanKey planKey, long stageId) Get an individual stage from a plan
List<ImmutableChainStage>	getStagesForPlan(PlanKey planKey) Get all stages in a plan, in order
ImmutableChainStage	updateStage(PlanKey planKey, long stageId, String name, String description, boolean manual, Integer index, BambooClosures.Throwing1<ImmutableChainStage,WebValidationException>... runBefore) Update the details of a stage.
ErrorCollection	validateStageForAdd(PlanKey planKey, String name, String description, boolean isManual) Validates a new stage for the specified plan.
ErrorCollection	validateStageForUpdate(PlanKey planKey, long stageId, String name, String description, boolean manual) Validates editing of a stage.

Method Detail

getStagesForPlan

@NotNull
List<ImmutableChainStage> getStagesForPlan(@NotNull
                                                 PlanKey planKey)
                                           throws WebValidationException

Get all stages in a plan, in order

Parameters:

planKey - of plan

Returns:

list of immutable stages

Throws:

NotFoundException - if the plan does not exist

org.acegisecurity.AccessDeniedException - if user has no WRITE access to the plan

WebValidationException

getStage

@NotNull
ImmutableChainStage getStage(@NotNull
                                   PlanKey planKey,
                                   long stageId)
                             throws WebValidationException

Get an individual stage from a plan

Parameters:

planKey - the plan the stage belongs to

stageId - the id of the stage

Returns:

ImmutableChainStage representing the stage if it exists

Throws:

NotFoundException - if the plan or stage does not exist

org.acegisecurity.AccessDeniedException - if user has no WRITE access to the plan

WebValidationException

addStage

@NotNull
ImmutableChainStage addStage(@NotNull
                                   PlanKey planKey,
                                   @NotNull
                                   String name,
                                   @Nullable
                                   String description,
                                   boolean isManual)
                             throws WebValidationException

Adds a new stage to the specified plan. Currently will be added to the end of the list // todo allow people to add a stage to a specific index?

Parameters:

planKey - of plan to add stage to

name - of stage

description - of stage

isManual - true if this stage is a manual stage

Returns:

created chain stage

Throws:

WebValidationException - if plan does not exist or it is not of the correct type, or if validation fails

validateStageForAdd

@NotNull
ErrorCollection validateStageForAdd(@NotNull
                                          PlanKey planKey,
                                          @Nullable
                                          String name,
                                          @Nullable
                                          String description,
                                          boolean isManual)
                                    throws WebValidationException

Validates a new stage for the specified plan.

Parameters:

planKey - of plan to add stage to

name - of stage

description - of stage

isManual - true if this stage is a manual stage

Returns:

error collection containing any validation errors against the stage data.

Throws:

WebValidationException - if plan does not exist or it is not of the correct type

validateStageForUpdate

@NotNull
ErrorCollection validateStageForUpdate(@NotNull
                                             PlanKey planKey,
                                             long stageId,
                                             @Nullable
                                             String name,
                                             @Nullable
                                             String description,
                                             boolean manual)
                                       throws WebValidationException

Validates editing of a stage.

Parameters:

planKey - of plan stage belongs to

stageId - if of the stage being edited

name - new name of stage

description - new description of stage

manual - new value for id stage is manual or not

Returns:

error collection containing any validation errors that may have occurred against stage data.

Throws:

WebValidationException

updateStage

@NotNull
ImmutableChainStage updateStage(@NotNull
                                      PlanKey planKey,
                                      long stageId,
                                      @NotNull
                                      String name,
                                      @NotNull
                                      String description,
                                      boolean manual,
                                      @Nullable
                                      Integer index,
                                      @NotNull
                                      BambooClosures.Throwing1<ImmutableChainStage,WebValidationException>... runBefore)
                                throws WebValidationException

Update the details of a stage.

Parameters:

planKey - key of the plan the stage belongs to

stageId - if of the stage being updated

name - the name of the stage

description - the description of the stage

manual - indicates if the stage runs automatically or needs manual intervention

index - position of the stage in the plan structure

Returns:

ImmutableChainStage representing the updated stage

Throws:

WebValidationException - if invalid

deleteStage

void deleteStage(@NotNull
               PlanKey planKey,
               long stageId,
               @NotNull
               BambooClosures.Throwing1<ImmutableChainStage,WebValidationException>... runBefore)
                 throws WebValidationException

Deletes the given stage and any jobs under the stage.

Parameters:

planKey - key for the plan the stage belongs to.

stageId - id if of the stage being deleted.

runBefore - code to execute after security and validation has passed but before the deletion occurs.

Throws:

WebValidationException