hudson.matrix

Class MatrixBuild

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Actionable

hudson.model.Run<P,R>

hudson.model.AbstractBuild<MatrixProject,MatrixBuild>

hudson.matrix.MatrixBuild

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.DescriptorByNameOwner, hudson.model.ModelObject, hudson.model.PersistenceRoot, hudson.model.Queue.Executable, hudson.model.Saveable, hudson.search.SearchableModelObject, hudson.search.SearchItem, hudson.security.AccessControlled, Comparable<MatrixBuild>, Runnable, jenkins.model.lazy.LazyBuildMixIn.LazyLoadingRun<MatrixProject,MatrixBuild>, jenkins.model.ModelObjectWithContextMenu, jenkins.util.io.OnMaster

public class MatrixBuild
extends hudson.model.AbstractBuild<MatrixProject,MatrixBuild>

Build of MatrixProject.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	MatrixBuild.MatrixBuildExecution Object that lives from the start of MatrixBuild execution to its end.
class	MatrixBuild.RunPtr Used by view to render a ball for MatrixRun.

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

hudson.model.AbstractBuild.AbstractBuildExecution, hudson.model.AbstractBuild.AbstractRunner, hudson.model.AbstractBuild.DependencyChange

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

hudson.model.Run.Artifact, hudson.model.Run.ArtifactList, hudson.model.Run.KeepLogBuildBadge, hudson.model.Run.RedirectUp, hudson.model.Run.RunExecution, hudson.model.Run.Runner, hudson.model.Run.RunnerAbortedException, hudson.model.Run.StatusSummarizer, hudson.model.Run.Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

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

jenkins.model.ModelObjectWithContextMenu.ContextMenu, jenkins.model.ModelObjectWithContextMenu.ContextMenuVisibility, jenkins.model.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, LIST_CUTOFF, nextBuild, number, ORDER_BY_DATE, PERMISSIONS, previousBuild, project, QUEUE_ID_UNKNOWN, result, timestamp, TREE_CUTOFF, UPDATE, XSTREAM, XSTREAM2

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor and Description
MatrixBuild(MatrixProject job)
MatrixBuild(MatrixProject job, Calendar timestamp)
MatrixBuild(MatrixProject project, File buildDir)

Method Summary

Modifier and Type	Method and Description
void	delete() Delete build and its child builds.
void	doDoDeleteAll(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp) Deprecated. since TODO, kept not to break REST clients.
MatrixBuild	getBaseBuild() Returns the base MatrixBuild that this build originates from.
hudson.model.Fingerprint.RangeSet	getDownstreamRelationship(hudson.model.AbstractProject that)
Object	getDynamic(String token, org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp)
MatrixRun	getExactRun(Combination c) Like getRun(Combination), but do not approximate the result by earlier execution of the given combination (which is done for partial rebuild of the matrix.)
List<MatrixRun>	getExactRuns() Returns all MatrixRuns for exactly this MatrixBuild.
Layouter<MatrixBuild.RunPtr>	getLayouter()
MatrixRun	getRun(Combination c) Gets the MatrixRun in this build that corresponds to the given combination.
List<MatrixRun>	getRuns() Returns all MatrixRuns for this MatrixBuild.
String	getWhyKeepLog()
boolean	isLinkedBy(MatrixBuild b)
boolean	isPartial() True if this build didn't do a full build and it is depending on the result of the previous build.
Object	readResolve()
void	run()
void	setBaseBuild(MatrixBuild baseBuild) Sets the base build from which this build is derived.

Methods inherited from class hudson.model.AbstractBuild

addAction, createReference, doStop, doStop, dropLinks, due, getAggregatedTestResultAction, getBuildFingerprints, getBuildVariableResolver, getBuildVariables, getBuiltOn, getBuiltOnStr, getChangeSet, getChangeSets, getCulprits, getDependencyChanges, getDownstreamBuilds, getDownstreamBuilds, getEnvironment, getEnvironments, getHudsonVersion, getModuleRoot, getModuleRoots, getNextBuild, getPersistentActions, getPreviousBuild, getProject, getRootBuild, getRunMixIn, getSensitiveBuildVariables, getTestResultAction, getTransitiveUpstreamBuilds, getUpstreamBuilds, getUpstreamRelationship, getUpstreamRelationshipBuild, getUpUrl, getWorkspace, hasChangeSetComputed, hasParticipant, setBuiltOnStr, setWorkspace

Methods inherited from class hudson.model.Run

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

Methods inherited from class hudson.model.Actionable

doContextMenu, getAction, getAction, getActions, getActions, getAllActions, replaceAction

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, wait, wait, wait

Methods inherited from interface hudson.model.Queue.Executable

getEstimatedDuration, toString

Constructor Detail

MatrixBuild

public MatrixBuild(MatrixProject job)
            throws IOException

Throws:

IOException

MatrixBuild

public MatrixBuild(MatrixProject job,
                   Calendar timestamp)

MatrixBuild

public MatrixBuild(MatrixProject project,
                   File buildDir)
            throws IOException

Throws:

IOException

Method Detail

readResolve

public Object readResolve()

delete

public void delete()
            throws IOException

Delete build and its child builds.

Overrides:

delete in class hudson.model.Run<MatrixProject,MatrixBuild>

Throws:

IOException

Since:

TODO

doDoDeleteAll

@Deprecated
public void doDoDeleteAll(org.kohsuke.stapler.StaplerRequest req,
                                      org.kohsuke.stapler.StaplerResponse rsp)
                               throws IOException,
                                      javax.servlet.ServletException

Deprecated. since TODO, kept not to break REST clients.

Deletes the build and all matrix configurations in this build when the button is pressed.

Throws:

IOException

javax.servlet.ServletException

getLayouter

public Layouter<MatrixBuild.RunPtr> getLayouter()

setBaseBuild

public void setBaseBuild(MatrixBuild baseBuild)

Sets the base build from which this build is derived.

Since:

1.416

getBaseBuild

public MatrixBuild getBaseBuild()

Returns the base MatrixBuild that this build originates from.

If this build is a partial build, unexecuted MatrixRuns are delegated to this build number.

getRun

public MatrixRun getRun(Combination c)

Gets the MatrixRun in this build that corresponds to the given combination.

getExactRun

public MatrixRun getExactRun(Combination c)

Like getRun(Combination), but do not approximate the result by earlier execution of the given combination (which is done for partial rebuild of the matrix.)

getRuns

@Exported
public List<MatrixRun> getRuns()

Returns all MatrixRuns for this MatrixBuild.

getExactRuns

public List<MatrixRun> getExactRuns()

Returns all MatrixRuns for exactly this MatrixBuild.

Unlike getRuns(), this method excludes those runs that didn't run and got inherited.

Since:

1.413

getWhyKeepLog

public String getWhyKeepLog()

Overrides:

getWhyKeepLog in class hudson.model.AbstractBuild<MatrixProject,MatrixBuild>

isLinkedBy

public boolean isLinkedBy(MatrixBuild b)

Returns:

True if another MatrixBuild build (passed as a parameter) depends on this build.

Since:

1.481

isPartial

public boolean isPartial()

True if this build didn't do a full build and it is depending on the result of the previous build.

getDynamic

public Object getDynamic(String token,
                         org.kohsuke.stapler.StaplerRequest req,
                         org.kohsuke.stapler.StaplerResponse rsp)

Overrides:

getDynamic in class hudson.model.Run<MatrixProject,MatrixBuild>

run

public void run()

Specified by:

run in interface hudson.model.Queue.Executable

Specified by:

run in interface Runnable

Specified by:

run in class hudson.model.AbstractBuild<MatrixProject,MatrixBuild>

getDownstreamRelationship

public hudson.model.Fingerprint.RangeSet getDownstreamRelationship(hudson.model.AbstractProject that)

Overrides:

getDownstreamRelationship in class hudson.model.AbstractBuild<MatrixProject,MatrixBuild>