com.atlassian.bamboo.ww2.beans

Class DecoratedPlan

java.lang.Object

com.atlassian.bamboo.ww2.beans.DecoratedPlan

All Implemented Interfaces:

BambooIdProvider, PlanIdentifier, PlanKeyProvider, DescriptionProvider, NameProvider, DecoratedNavObject

Direct Known Subclasses:

DecoratedPlan.DecoratedBranch

@Immutable
public abstract class DecoratedPlan
extends Object
implements DecoratedNavObject, PlanIdentifier

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DecoratedPlan.DecoratedBranch Branches are top level branch plans.
static class	DecoratedPlan.DecoratedPlanBranchGist

Field Summary

Fields inherited from interface com.atlassian.bamboo.plan.PlanIdentifier

NAME_DELIMITER

Fields inherited from interface com.atlassian.bamboo.plan.PlanKeyProvider

getPlanKey

Method Summary

Modifier and Type	Method and Description
com.google.common.collect.ImmutableList<DecoratedPlan.DecoratedPlanBranchGist>	getBranches()
abstract @Nullable String	getBranchName()
@Nullable String	getBranchPlanKey() Return the the branch plan key.
@NotNull String	getBuildKey()
@NotNull String	getBuildName()
@NotNull Optional<Long>	getDatabaseId()
String	getDescription()
@NotNull String	getDisplayName()
long	getId()
@NotNull String	getKey()
com.google.common.collect.ImmutableList<String>	getLabelNames()
@Nullable String	getLinkedJiraIssue()
abstract @Nullable DecoratedPlan	getMaster() The master plan iff the plan is a branched plan and it has a master.
@NotNull String	getMasterChainKey() Return the main chain key for this plan.
long	getMasterId()
@NotNull Optional<Long>	getMasterIdIfExists()
@Nullable String	getMasterJobKey() Return the job key of this plan.
@NotNull String	getName()
@NotNull com.google.common.collect.ImmutableList<? extends DecoratedNavGroupObject>	getNavGroups()
abstract @Nullable DecoratedPlan	getParent()
abstract @Nullable PlanBranchWorkflow	getPlanBranchWorkflow()
@NotNull PlanKey	getPlanKey()
@NotNull PlanType	getPlanType()
@NotNull ProjectIdentifier	getProject()
abstract List<DeploymentProject>	getRelatedDeploymentProjects()
com.google.common.collect.ImmutableList<DecoratedStage>	getStages()
abstract @Nullable DecoratedStage	getStageWithName(@NotNull String stageName) Retrieve the named stage.
@Nullable DecoratedNavObjectStatus	getStatus()
@NotNull String	getType()
boolean	isRemoteJiraLinkRequired()
boolean	isResult()
boolean	isSuspendedFromBuilding()
@Nullable String	replaceKey(String url, DecoratedNavObject originalObject) Given an existing url (may be directly from the originalObject or may be with a static ${planKey} reference) generate the new url for this object
void	setLabels(com.google.common.collect.ImmutableList<String> labels)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getKey

@NotNull
public @NotNull String getKey()

Specified by:

getKey in interface DecoratedNavObject

Returns:

full key of the object

getBuildKey

@NotNull
public @NotNull String getBuildKey()

Specified by:

getBuildKey in interface PlanIdentifier

getDisplayName

@NotNull
public @NotNull String getDisplayName()

Specified by:

getDisplayName in interface DecoratedNavObject

Returns:

display name of this object

getNavGroups

@NotNull
public @NotNull com.google.common.collect.ImmutableList<? extends DecoratedNavGroupObject> getNavGroups()

Specified by:

getNavGroups in interface DecoratedNavObject

Returns:

any children groups of this object

getParent

@Nullable
public abstract @Nullable DecoratedPlan getParent()

Specified by:

getParent in interface DecoratedNavObject

Returns:

the parent of this object (does not take into account groups)

getPlanType

@NotNull
public @NotNull PlanType getPlanType()

Specified by:

getPlanType in interface PlanIdentifier

Specified by:

getPlanType in interface DecoratedNavObject

Returns:

plantype associated with this object.

getStatus

@Nullable
public @Nullable DecoratedNavObjectStatus getStatus()

Specified by:

getStatus in interface DecoratedNavObject

Returns:

provide the status of this object if applicable

replaceKey

@Nullable
public @Nullable String replaceKey(String url,
                                             DecoratedNavObject originalObject)

Description copied from interface: DecoratedNavObject

Given an existing url (may be directly from the originalObject or may be with a static ${planKey} reference) generate the new url for this object

Specified by:

replaceKey in interface DecoratedNavObject

Parameters:

url - - to manipulate

originalObject - - the object the original url may have belonged to

Returns:

the new url referencing this object

getMaster

@Nullable
public abstract @Nullable DecoratedPlan getMaster()

Description copied from interface: DecoratedNavObject

The master plan iff the plan is a branched plan and it has a master.

Specified by:

getMaster in interface DecoratedNavObject

Returns:

getId

public long getId()

Specified by:

getId in interface BambooIdProvider

Specified by:

getId in interface PlanIdentifier

getDatabaseId

@NotNull
public @NotNull Optional<Long> getDatabaseId()

Specified by:

getDatabaseId in interface PlanIdentifier

getPlanKey

@NotNull
public @NotNull PlanKey getPlanKey()

Specified by:

getPlanKey in interface PlanIdentifier

Specified by:

getPlanKey in interface PlanKeyProvider

getName

@NotNull
public @NotNull String getName()

Specified by:

getName in interface PlanIdentifier

Specified by:

getName in interface DescriptionProvider

Specified by:

getName in interface NameProvider

getProject

@NotNull
public @NotNull ProjectIdentifier getProject()

Specified by:

getProject in interface PlanIdentifier

getBuildName

@NotNull
public @NotNull String getBuildName()

Specified by:

getBuildName in interface PlanIdentifier

getDescription

public String getDescription()

Specified by:

getDescription in interface DescriptionProvider

getMasterId

public long getMasterId()

Specified by:

getMasterId in interface PlanIdentifier

getMasterIdIfExists

@NotNull
public @NotNull Optional<Long> getMasterIdIfExists()

Specified by:

getMasterIdIfExists in interface PlanIdentifier

getLabelNames

public com.google.common.collect.ImmutableList<String> getLabelNames()

getType

@NotNull
public @NotNull String getType()

Specified by:

getType in interface DecoratedNavObject

Returns:

plantype associated with this object.

isResult

public boolean isResult()

Specified by:

isResult in interface DecoratedNavObject

Returns:

true if the nav object represents a result otherwise false

isSuspendedFromBuilding

public boolean isSuspendedFromBuilding()

Specified by:

isSuspendedFromBuilding in interface PlanIdentifier

getStages

public com.google.common.collect.ImmutableList<DecoratedStage> getStages()

getBranches

public com.google.common.collect.ImmutableList<DecoratedPlan.DecoratedPlanBranchGist> getBranches()

setLabels

public void setLabels(com.google.common.collect.ImmutableList<String> labels)

getBranchName

@Nullable
public abstract @Nullable String getBranchName()

getPlanBranchWorkflow

@Nullable
public abstract @Nullable PlanBranchWorkflow getPlanBranchWorkflow()

getLinkedJiraIssue

@Nullable
public @Nullable String getLinkedJiraIssue()

isRemoteJiraLinkRequired

public boolean isRemoteJiraLinkRequired()

getMasterChainKey

@NotNull
public @NotNull String getMasterChainKey()

Return the main chain key for this plan. In case of a Chain Key (PROJ-PLAN) this key will be returned. In case of a Job Key (PROJ-PLAN-JOB), this will return a main chain key (PROJ-PLAN). In case of a Branch Key (PROJ-PLAN10), this will return the key of the main chain (PROJ-PLAN).

Returns:

chainKey

getMasterJobKey

@Nullable
public @Nullable String getMasterJobKey()

Return the job key of this plan. In case this class represents a chain key or a branch key, this will return null.

Returns:

the job key or null

getBranchPlanKey

@Nullable
public @Nullable String getBranchPlanKey()

Return the the branch plan key. If this does not represent a branch plan, we return null.

Returns:

the branch plan key or null

getRelatedDeploymentProjects

public abstract List<DeploymentProject> getRelatedDeploymentProjects()

getStageWithName

@Nullable
public abstract @Nullable DecoratedStage getStageWithName(@NotNull
                                                                    @NotNull String stageName)

Retrieve the named stage. If the stage is not found it indicates that the stage has been deleted or renamed but the result remains.