Package com.atlassian.bamboo.v2.build

Interface BuildContext

All Superinterfaces:
BuildIdentifier, CommonContext, Serializable
All Known Implementing Classes:
BuildContextImpl
@ThreadSafe @PublicApi public interface BuildContext extends CommonContext, BuildIdentifier
A class that encapsulates how to build a particular plan at a given instance

  • Method Details

    • getParentBuildContext

      @Nullable @Nullable BuildContext getParentBuildContext()
      If this context is for ImmutableJob returns context of owner chain, null otherwise. Note: modifying parent context by job-level actions, such as PreJobAction is not thread safe and is not supported.
      Returns:
      the BuildContext of the parent Plan execution. Should return null if the current BuildContext is for a TopLevelPlan

    • getBuildDefinition

      @NotNull @NotNull BuildDefinition getBuildDefinition()
      Returns:
      BuildDefinition associated with Plan this context relates to

    • getArtifactContext

      @NotNull @NotNull ArtifactContext getArtifactContext()
      Specified by:
      getArtifactContext in interface CommonContext
      Returns:
      Artifact data associated with Plan

    • getBuildChanges

      @NotNull @NotNull BuildChanges getBuildChanges()
      Returns the build changes, if any, that represents the changes that triggered this build.
      Returns:
      Never null. WIll return a build changes object with the appropriate list of changes, the list will be null if no changes were found.

    • setBuildChanges

      void setBuildChanges(BuildChanges buildChanges)

    • getBuildResult

      @NotNull @NotNull CurrentBuildResult getBuildResult()
      The information about the results of a build
      Returns:
      CurrentBuildResult

    • getRelevantRepositoryIds

      @NotNull @NotNull Set<Long> getRelevantRepositoryIds()
      Returns:
      a set of repository id's that are relevant to this particular job, i.e. these jobs do checkout of that repository

    • getCheckoutLocation

      @NotNull @NotNull Map<Long,String> getCheckoutLocation()
      Map holds final checkout where repository was checked out by VcsCheckoutTask Elements are kept in order of checkout
      Returns:
      map of repositoryId as Long and checkout location as String

    • isBranch

      boolean isBranch()
      Provides information if context refers to the branch of the Chain
      Returns:
      true if context refers to the chain branch

    • isOnceOff

      boolean isOnceOff()
      Provides information if context refers to the "once-off" build - a build that have been run with customized revision
      Returns:
      true if context refers to the chain branch

    • isCustomBuild

      boolean isCustomBuild()
      Provides information if context refers to the build that had some variables overwritten
      Returns:
      true if context refers to the build with overwritten variables

    • getBandanaContext

      @NotNull @NotNull BambooBandanaContext getBandanaContext()
      BandanaContext of the plan.
      Returns:
      BandanaContext of the plan

    • setVariableContext

      void setVariableContext(@NotNull @NotNull VariableContext variableContext)

    • getMaximumBuildWarningsCount

      long getMaximumBuildWarningsCount()

    • getMergeResult

      @Nullable @Nullable MergeResultContext getMergeResult()
      If a build performs merge, this method returns the result.
      Since:
      9.0

    • setMergeResult

      void setMergeResult(@Nullable @Nullable MergeResultContext mergeResult)
      Since:
      9.0