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
protected 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

getPlanKeyFunction, 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 String	getBranchName()
String	getBranchPlanKey() Return the the branch plan key.
String	getBuildKey() This objects specific portion of the key.
String	getBuildName()
Optional<Long>	getDatabaseId()
String	getDescription()
String	getDisplayName()
long	getId() Returns database id of the plan.
String	getKey()
com.google.common.collect.ImmutableList<String>	getLabelNames()
String	getLinkedJiraIssue()
abstract DecoratedPlan	getMaster() The master plan iff the plan is a branched plan and it has a master.
String	getMasterChainKey() Return the main chain key for this plan.
long	getMasterId()
Optional<Long>	getMasterIdIfExists()
String	getMasterJobKey() Return the job key of this plan.
String	getName() Returns the full name for the build in the form of "project name - build name" e.g.
com.google.common.collect.ImmutableList<? extends DecoratedNavGroupObject>	getNavGroups()
abstract DecoratedPlan	getParent()
abstract PlanBranchWorkflow	getPlanBranchWorkflow()
PlanKey	getPlanKey() Get the PlanKey identifier for this Plan
PlanType	getPlanType()
ProjectIdentifier	getProject() Returns the parent Project
abstract List<DeploymentProject>	getRelatedDeploymentProjects()
com.google.common.collect.ImmutableList<DecoratedStage>	getStages()
abstract DecoratedStage	getStageWithName(String stageName) Retrieve the named stage.
DecoratedNavObjectStatus	getStatus()
String	getType()
boolean	isRemoteJiraLinkRequired()
boolean	isResult()
boolean	isSuspendedFromBuilding() Checks if the build has been enabled / disabled.
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 String getKey()

Specified by:

getKey in interface DecoratedNavObject

Returns:

full key of the object

getBuildKey

@NotNull
public String getBuildKey()

Description copied from interface: PlanIdentifier

This objects specific portion of the key. You probably want to use PlanIdentifier.getPlanKey().

Specified by:

getBuildKey in interface PlanIdentifier

Returns:

This objects specific portion of the key

getDisplayName

@NotNull
public String getDisplayName()

Specified by:

getDisplayName in interface DecoratedNavObject

Returns:

display name of this object

getNavGroups

@NotNull
public 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 DecoratedPlan getParent()

Specified by:

getParent in interface DecoratedNavObject

Returns:

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

getPlanType

@NotNull
public PlanType getPlanType()

Specified by:

getPlanType in interface PlanIdentifier

Specified by:

getPlanType in interface DecoratedNavObject

Returns:

plantype associated with this object.

getStatus

@Nullable
public DecoratedNavObjectStatus getStatus()

Specified by:

getStatus in interface DecoratedNavObject

Returns:

provide the status of this object if applicable

replaceKey

@Nullable
public 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 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()

Description copied from interface: PlanIdentifier

Returns database id of the plan. Use of PlanIdentifier.getDatabaseId() should be preferred.

Specified by:

getId in interface BambooIdProvider

Specified by:

getId in interface PlanIdentifier

getDatabaseId

@NotNull
public Optional<Long> getDatabaseId()

Specified by:

getDatabaseId in interface PlanIdentifier

Returns:

database id of the plan or empty if this plan is not a DB object.

getPlanKey

@NotNull
public PlanKey getPlanKey()

Description copied from interface: PlanIdentifier

Get the PlanKey identifier for this Plan

Specified by:

getPlanKey in interface PlanIdentifier

Specified by:

getPlanKey in interface PlanKeyProvider

Returns:

planKey

getName

@NotNull
public String getName()

Description copied from interface: PlanIdentifier

Returns the full name for the build in the form of "project name - build name" e.g. "Confluence - HEAD"

Specified by:

getName in interface PlanIdentifier

Specified by:

getName in interface DescriptionProvider

Specified by:

getName in interface NameProvider

Returns:

String

getProject

@NotNull
public ProjectIdentifier getProject()

Description copied from interface: PlanIdentifier

Returns the parent Project

Specified by:

getProject in interface PlanIdentifier

Returns:

Project. Never null

getBuildName

@NotNull
public String getBuildName()

Specified by:

getBuildName in interface PlanIdentifier

Returns:

The plan specific portion of the name (without the project and/or parent's names). You probably want to use PlanIdentifier.getName()

getDescription

public String getDescription()

Specified by:

getDescription in interface DescriptionProvider

getMasterId

public long getMasterId()

Specified by:

getMasterId in interface PlanIdentifier

Returns:

database id of master of this Plan or -1 if none.

getMasterIdIfExists

@NotNull
public Optional<Long> getMasterIdIfExists()

Specified by:

getMasterIdIfExists in interface PlanIdentifier

Returns:

database id of master of this Plan or empty if none.

getLabelNames

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

getType

@NotNull
public 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()

Description copied from interface: PlanIdentifier

Checks if the build has been enabled / disabled.

Specified by:

isSuspendedFromBuilding in interface PlanIdentifier

Returns:

true if plan is disabled

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 String getBranchName()

getPlanBranchWorkflow

@Nullable
public abstract PlanBranchWorkflow getPlanBranchWorkflow()

getLinkedJiraIssue

@Nullable
public String getLinkedJiraIssue()

isRemoteJiraLinkRequired

public boolean isRemoteJiraLinkRequired()

getMasterChainKey

@NotNull
public 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 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 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 DecoratedStage getStageWithName(@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.