com.atlassian.bamboo.plan.cache

Interface ImmutablePlan

All Superinterfaces:

BambooIdProvider, DescriptionProvider, ImmutableEntityWithOid, NameProvider, PlanIdentifier, PlanKeyProvider

All Known Subinterfaces:

Buildable, Chain, ChainBranch, ImmutableBuildable, ImmutableChain, ImmutableChainBranch, ImmutableJob, ImmutableTopLevelPlan, Job, Plan, TopLevelPlan

All Known Implementing Classes:

AbstractChain, AbstractImmutableChain, AbstractImmutablePlan, AbstractPlan, ChainBranchImpl, DefaultChain, DefaultJob, ImmutableChainBranchImpl, ImmutableChainImpl, ImmutableJobImpl

public interface ImmutablePlan
extends PlanIdentifier, ImmutableEntityWithOid

Represents a Plan that is immutable. Since 3.4, all new uses of Chains should prefer this interface to improve cacheability.

Since:

v3.4

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_NUMBER_LOG_ENTRIES
static int	MAX_PREVIOUS_BUILD_FOR_AVE
static String	STATUS_CURRENTLY_BUILDING
static String	STATUS_FAIL
static String	STATUS_NO_BUILDS
static String	STATUS_NOT_RUN
static String	STATUS_SUCCESS

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
long	getAverageBuildDuration() Returns an average duration of the recent builds
BuildDefinition	getBuildDefinition() Returns the BuildDefinition that backs this Plan
BuildLogger	getBuildLogger() Returns the helper object to deal with logging
String	getCurrentStatus()
List<VariableDefinition>	getEffectiveVariables() Return effective list of VariableDefinitions bind to this Plan.
int	getFirstBuildNumber() What the number of the first build we have? It may not be 1 as some may have been removed!
String	getKey() Obtain the plan's unique key (uppercase alphanumeric).
List<String>	getLabelNames()
int	getLastBuildNumber() What was the number of the latest build (may be being built)
ImmutableResultsSummary	getLatestResultsSummary() Get the latest finished result
ImmutablePlan	getMaster() Return the master plan if one exists.
Project	getProject() Returns the parent Project
String	getType() Deprecated. Use PlanIdentifier.getPlanType() instead. Since v4.0.
List<VariableDefinition>	getVariables() Return list of VariableDefinitions bind to this Plan
boolean	hasMaster()
boolean	isActive() Deprecated. since 4.0 use ChainExecutionAccessor.isActive(PlanKey)
boolean	isBusy() Deprecated. since 4.0 use PlanExecutionManager.isBusy(PlanKey)
boolean	isExecuting() Deprecated. since 6.10 use ChainExecutionAccessor.isExecuting(PlanKey)
boolean	isMarkedForDeletion() Is the plan set to be deleted in the future

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

getBuildKey, getBuildName, getDatabaseId, getId, getMasterId, getMasterIdIfExists, getName, getPlanKey, getPlanType, isSuspendedFromBuilding

Methods inherited from interface com.atlassian.bamboo.utils.DescriptionProvider

getDescription

Methods inherited from interface com.atlassian.bamboo.core.ImmutableEntityWithOid

getEntityType, getOid

Field Detail

MAX_NUMBER_LOG_ENTRIES

static final int MAX_NUMBER_LOG_ENTRIES

See Also:

Constant Field Values

MAX_PREVIOUS_BUILD_FOR_AVE

static final int MAX_PREVIOUS_BUILD_FOR_AVE

See Also:

Constant Field Values

STATUS_FAIL

static final String STATUS_FAIL

See Also:

Constant Field Values

STATUS_SUCCESS

static final String STATUS_SUCCESS

See Also:

Constant Field Values

STATUS_CURRENTLY_BUILDING

static final String STATUS_CURRENTLY_BUILDING

See Also:

Constant Field Values

STATUS_NO_BUILDS

static final String STATUS_NO_BUILDS

See Also:

Constant Field Values

STATUS_NOT_RUN

static final String STATUS_NOT_RUN

See Also:

Constant Field Values

Method Detail

getType

@NotNull
 @Deprecated
String getType()

Deprecated. Use PlanIdentifier.getPlanType() instead. Since v4.0.

Returns the string representation of the type. See PlanType and used in Freemarker.

Returns:

the string representation of the type

getKey

@NotNull
String getKey()

Obtain the plan's unique key (uppercase alphanumeric). This includes the project prefix e.g. BAM-MAIN. Prefer PlanIdentifier.getPlanKey()

Returns:

The full key

getCurrentStatus

@NotNull
String getCurrentStatus()

Returns:

a string key as to what the status is. Can be "success", "failure", "current", "none" or "notRun". Mainly used for UI purposes.

isExecuting

@Deprecated
boolean isExecuting()

Deprecated. since 6.10 use ChainExecutionAccessor.isExecuting(PlanKey)

Is the build currently being executed?

Returns:

true if build is being executed

getBuildLogger

@NotNull
BuildLogger getBuildLogger()

Returns the helper object to deal with logging

Returns:

A BuildLogger.

isActive

@Deprecated
boolean isActive()

Deprecated. since 4.0 use ChainExecutionAccessor.isActive(PlanKey)

Is the plan queued or building?

isBusy

@Deprecated
boolean isBusy()

Deprecated. since 4.0 use PlanExecutionManager.isBusy(PlanKey)

Is the Plan "busy". Busy is defined by the plan having a lock held on it. This is done during change detection, dependency listner and the like

Returns:

busy

getFirstBuildNumber

int getFirstBuildNumber()

What the number of the first build we have? It may not be 1 as some may have been removed!

Returns:

The number of the first build

getLastBuildNumber

int getLastBuildNumber()

What was the number of the latest build (may be being built)

Returns:

the build number, zero if the build has not been built

getAverageBuildDuration

long getAverageBuildDuration()

Returns an average duration of the recent builds

Returns:

The duration in milliseconds

isMarkedForDeletion

boolean isMarkedForDeletion()

Is the plan set to be deleted in the future

getBuildDefinition

@NotNull
BuildDefinition getBuildDefinition()

Returns the BuildDefinition that backs this Plan

Returns:

BuildDefinition object.

getProject

@NotNull
Project getProject()

Returns the parent Project

Specified by:

getProject in interface PlanIdentifier

Returns:

Project. Never null

getLabelNames

@NotNull
List<String> getLabelNames()

Returns:

all the names of related labels with a namespace of :label

getLatestResultsSummary

@Nullable
ImmutableResultsSummary getLatestResultsSummary()

Get the latest finished result

Returns:

The summary info for the last completed build. Returns null if there are no build results for this plan

getVariables

@NotNull
List<VariableDefinition> getVariables()

Return list of VariableDefinitions bind to this Plan

Returns:

non-null list of VariableDefinition

getEffectiveVariables

@NotNull
List<VariableDefinition> getEffectiveVariables()

Return effective list of VariableDefinitions bind to this Plan. For master Plans this will return the same result as getVariables(). Non-master plans will produce the sum of: - all master's variables which keys do not appear in result of getVariables() - result of getVariables()

Returns:

non-null list of VariableDefinition

getMaster

@Nullable
ImmutablePlan getMaster()

Return the master plan if one exists. The master is the plan which this one is derived from. Configuration is pulled from the master if one exists.

Returns:

the master Plan if one exists.

hasMaster

boolean hasMaster()

Returns:

true if plan has a master plan