hudson.matrix
Class MatrixRun

java.lang.Object
  hudson.model.AbstractModelObject
      hudson.model.Actionable
          hudson.model.Run<P,R>
              hudson.model.AbstractBuild<P,B>
                  hudson.model.Build<MatrixConfiguration,MatrixRun>
                      hudson.matrix.MatrixRun

All Implemented Interfaces:

ExtensionPoint, DescriptorByNameOwner, ModelObject, PersistenceRoot, Queue.Executable, Saveable, SearchableModelObject, SearchItem, AccessControlled, Comparable<MatrixRun>, Runnable, ModelObjectWithContextMenu, OnMaster

public class MatrixRun
extends Build<MatrixConfiguration,MatrixRun>

Execution of MatrixConfiguration.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from class hudson.model.Build

Build.BuildExecution, Build.RunnerImpl

Nested classes/interfaces inherited from class hudson.model.AbstractBuild

AbstractBuild.AbstractBuildExecution, AbstractBuild.AbstractRunner, AbstractBuild.DependencyChange

Nested classes/interfaces inherited from class hudson.model.Run

Run.Artifact, Run.ArtifactList, Run.KeepLogBuildBadge, Run.RedirectUp, Run.RunExecution, Run.Runner, Run.RunnerAbortedException, Run.Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface jenkins.model.ModelObjectWithContextMenu

ModelObjectWithContextMenu.ContextMenu, ModelObjectWithContextMenu.MenuItem

Field Summary

Fields inherited from class hudson.model.AbstractBuild

buildEnvironments

Fields inherited from class hudson.model.Run

ARTIFACTS, charset, DELETE, description, duration, FEED_ADAPTER, FEED_ADAPTER_LATEST, ID_FORMATTER, LIST_CUTOFF, number, ORDER_BY_DATE, PERMISSIONS, project, result, state, timestamp, TREE_CUTOFF, UPDATE, XSTREAM, XSTREAM2

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

MatrixRun(MatrixConfiguration job)

MatrixRun(MatrixConfiguration job, Calendar timestamp)

MatrixRun(MatrixConfiguration project, File buildDir)

Method Summary

Map<String,String>	getBuildVariables() Provides additional variables and their values to Builders.
String	getDisplayName()
MatrixConfiguration	getParent() The project this build is for.
MatrixBuild	getParentBuild() Gets the MatrixBuild that has the same build number.
AbstractBuild<?,?>	getRootBuild() The same as getParentBuild().
String	getUpUrl() Used to render the side panel "Back to project" link.
String	getWhyKeepLog() If the parent MatrixBuild is kept, keep this record too.
void	run() Invoked by Executor to performs a build.

Methods inherited from class hudson.model.Build

createRunner

Methods inherited from class hudson.model.AbstractBuild

doStop, doStop, due, getAggregatedTestResultAction, getBuildFingerprints, getBuildVariableResolver, getBuiltOn, getBuiltOnStr, getChangeSet, getCulprits, getDependencyChanges, getDownstreamBuilds, getDownstreamBuilds, getDownstreamRelationship, getEnvironment, getEnvironments, getHudsonVersion, getModuleRoot, getModuleRoots, getNextBuild, getPersistentActions, getPreviousBuild, getProject, getSensitiveBuildVariables, getTestResultAction, getTransitiveUpstreamBuilds, getUpstreamBuilds, getUpstreamRelationship, getUpstreamRelationshipBuild, getWorkspace, hasChangeSetComputed, hasParticipant, setBuiltOnStr, setWorkspace

Methods inherited from class hudson.model.Run

_this, addAction, canToggleLogKeep, checkPermission, compareTo, delete, deleteArtifacts, doArtifact, doBuildNumber, doBuildStatus, doBuildTimestamp, doConfigSubmit, doConsoleText, doDoDelete, doProgressiveLog, doSubmitDescription, doToggleLogKeep, execute, fromExternalizableId, getAbsoluteUrl, getACL, getApi, getArtifacts, getArtifactsDir, getArtifactsUpTo, getBadgeActions, getBuildStatusSummary, getBuildStatusUrl, getCause, getCauses, getCharacteristicEnvVars, getCharset, getDescription, getDescriptorByName, getDuration, getDurationString, getDynamic, getEnvironment, getEnvVars, getEstimatedDuration, getExecutor, getExternalizableId, getFullDisplayName, getHasArtifacts, getIconColor, getId, getIDFormatter, getLog, getLog, getLogFile, getLogInputStream, getLogReader, getLogText, getNumber, getOneOffExecutor, getPreviousBuildInProgress, getPreviousBuildsOverThreshold, getPreviousBuiltBuild, getPreviousCompletedBuild, getPreviousFailedBuild, getPreviousNotFailedBuild, getPreviousSuccessfulBuild, getResult, getRootDir, getSearchUrl, getStartTimeInMillis, getTime, getTimeInMillis, getTimestamp, getTimestampString, getTimestampString2, getTransientActions, getTruncatedDescription, getUrl, hasCustomDisplayName, hasntStartedYet, hasPermission, isBuilding, isKeepLog, isLogUpdated, keepLog, keepLog, makeSearchIndex, onEndBuilding, onLoad, onStartBuilding, reload, run, save, setDescription, setDisplayName, setResult, submit, toString, writeLogTo, writeWholeLogTo

Methods inherited from class hudson.model.Actionable

doContextMenu, getAction, getAction, getActions, getActions

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, getSearchName, requirePOST, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.model.Queue.Executable

getEstimatedDuration, toString

Constructor Detail

MatrixRun

public MatrixRun(MatrixConfiguration job)
          throws IOException

Throws:

IOException

MatrixRun

public MatrixRun(MatrixConfiguration job,
                 Calendar timestamp)

MatrixRun

public MatrixRun(MatrixConfiguration project,
                 File buildDir)
          throws IOException

Throws:

IOException

Method Detail

getUpUrl

public String getUpUrl()

Description copied from class: AbstractBuild

Used to render the side panel "Back to project" link.

In a rare situation where a build can be reached from multiple paths, returning different URLs from this method based on situations might be desirable.

If you override this method, you'll most likely also want to override Run.getDisplayName().

Overrides:

getUpUrl in class AbstractBuild<MatrixConfiguration,MatrixRun>

getParentBuild

public MatrixBuild getParentBuild()

Gets the MatrixBuild that has the same build number.

Returns:

null if no such build exists, which happens when the module build is manually triggered.

getRootBuild

public AbstractBuild<?,?> getRootBuild()

The same as getParentBuild().

Overrides:

getRootBuild in class AbstractBuild<MatrixConfiguration,MatrixRun>

Returns:

never null. In the worst case the build dominates itself.

See Also:

AbstractProject.getRootProject()

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface ModelObject

Overrides:

getDisplayName in class Run<MatrixConfiguration,MatrixRun>

getBuildVariables

public Map<String,String> getBuildVariables()

Description copied from class: AbstractBuild

Provides additional variables and their values to Builders.

This mechanism is used by MatrixConfiguration to pass the configuration values to the current build. It is up to Builders to decide whether they want to recognize the values or how to use them.

This also includes build parameters if a build is parameterized.

Overrides:

getBuildVariables in class AbstractBuild<MatrixConfiguration,MatrixRun>

Returns:

The returned map is mutable so that subtypes can put more values.

getWhyKeepLog

public String getWhyKeepLog()

If the parent MatrixBuild is kept, keep this record too.

Overrides:

getWhyKeepLog in class AbstractBuild<MatrixConfiguration,MatrixRun>

getParent

public MatrixConfiguration getParent()

Description copied from class: Run

The project this build is for.

Specified by:

getParent in interface Queue.Executable

Overrides:

getParent in class Run<MatrixConfiguration,MatrixRun>

run

public void run()

Description copied from class: AbstractBuild

Invoked by Executor to performs a build.

Specified by:

run in interface Queue.Executable

Specified by:

run in interface Runnable

Overrides:

run in class Build<MatrixConfiguration,MatrixRun>