hudson.maven

Class MavenModuleSetBuild

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Actionable

hudson.model.Run<P,R>

hudson.model.AbstractBuild<P,B>

hudson.maven.AbstractMavenBuild<MavenModuleSet,MavenModuleSetBuild>

hudson.maven.MavenModuleSetBuild

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<MavenModuleSetBuild>, Runnable, jenkins.model.lazy.LazyBuildMixIn.LazyLoadingRun<MavenModuleSet,MavenModuleSetBuild>, jenkins.model.ModelObjectWithContextMenu, jenkins.util.io.OnMaster

public class MavenModuleSetBuild
extends AbstractMavenBuild<MavenModuleSet,MavenModuleSetBuild>

Build for MavenModuleSet.

A "build" of MavenModuleSet consists of:

1. Update the workspace.
2. Parse POMs
3. Trigger module builds.

This object remembers the changelog and what MavenBuilds are done on this.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MavenModuleSetBuild.SimpleTransferListener will log in the TaskListener when transferFailed and transferSucceeded

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

Modifier and Type	Field and Description
static boolean	debug Extra verbose debug switch.

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
MavenModuleSetBuild(MavenModuleSet job)
MavenModuleSetBuild(MavenModuleSet project, File buildDir)

Method Summary

Modifier and Type	Method and Description
void	delete()
void	deleteArtifacts()
<T extends hudson.model.Action> List<T>	findModuleBuildActions(Class<T> action) Finds Actions from all the module builds that belong to this MavenModuleSetBuild.
hudson.model.Fingerprint.RangeSet	getDownstreamRelationship(hudson.model.AbstractProject that)
Object	getDynamic(String token, org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp)
hudson.EnvVars	getEnvironment(hudson.model.TaskListener log) Exposes MAVEN_OPTS to forked processes.
long	getEstimatedDuration() Returns the estimated duration for this builds.
MavenAggregatedArtifactRecord	getMavenArtifacts() Information about artifacts produced by Maven.
String	getMavenOpts(hudson.model.TaskListener listener, hudson.EnvVars envVars) Obtains the fully resolved MAVEN_OPTS with all the tokens and variables expanded.
String	getMavenVersionUsed() Gets the version of Maven used for build.
Map<MavenModule,List<MavenBuild>>	getModuleBuilds() Computes the module builds that correspond to this build.
Map<MavenModule,MavenBuild>	getModuleLastBuilds() Computes the latest module builds that correspond to this build.
MavenModuleSet	getParent()
hudson.model.Result	getResult() Displays the combined status of all modules.
protected Boolean	isRelease() Check if the current build is a release or not.
protected void	onLoad()
void	registerAsProjectAction(MavenReporter reporter)
void	run()
void	setMavenVersionUsed(String mavenVersionUsed)

Methods inherited from class hudson.maven.AbstractMavenBuild

expandTokens

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, getEnvironments, getHudsonVersion, getModuleRoot, getModuleRoots, getNextBuild, getPersistentActions, getPreviousBuild, getProject, getRootBuild, getRunMixIn, getSensitiveBuildVariables, getTestResultAction, getTransitiveUpstreamBuilds, getUpstreamBuilds, getUpstreamRelationship, getUpstreamRelationshipBuild, getUpUrl, getWhyKeepLog, getWorkspace, hasChangeSetComputed, hasParticipant, setBuiltOnStr, setWorkspace

Methods inherited from class hudson.model.Run

_this, canToggleLogKeep, checkPermission, compareTo, 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, getExecutor, getExternalizableId, getFullDisplayName, getHasArtifacts, getIconColor, getId, getLog, getLog, getLogFile, getLogInputStream, getLogReader, getLogText, getNumber, getOneOffExecutor, getPreviousBuildInProgress, getPreviousBuildsOverThreshold, getPreviousBuiltBuild, getPreviousCompletedBuild, getPreviousFailedBuild, getPreviousNotFailedBuild, getPreviousSuccessfulBuild, getQueueId, getRootDir, getSearchUrl, getStartTimeInMillis, getTime, getTimeInMillis, getTimestamp, getTimestampString, getTimestampString2, getTransientActions, getTruncatedDescription, getUrl, hasCustomDisplayName, hasntStartedYet, hasPermission, isBuilding, isInProgress, isKeepLog, isLogUpdated, keepLog, keepLog, makeSearchIndex, onEndBuilding, 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, toString, wait, wait, wait

Methods inherited from interface hudson.model.Queue.Executable

toString

Field Detail

debug

public static boolean debug

Extra verbose debug switch.

Constructor Detail

MavenModuleSetBuild

public MavenModuleSetBuild(MavenModuleSet job)
                    throws IOException

Throws:

IOException

MavenModuleSetBuild

public MavenModuleSetBuild(MavenModuleSet project,
                           File buildDir)
                    throws IOException

Throws:

IOException

Method Detail

onLoad

protected void onLoad()

Overrides:

onLoad in class hudson.model.Run<MavenModuleSet,MavenModuleSetBuild>

getEnvironment

public hudson.EnvVars getEnvironment(hudson.model.TaskListener log)
                              throws IOException,
                                     InterruptedException

Exposes MAVEN_OPTS to forked processes. When we fork Maven, we do so directly by executing Java, thus this environment variable is pointless (we have to tweak JVM launch option correctly instead, which can be seen in MavenProcessFactory), but setting the environment variable explicitly is still useful in case this Maven forks other Maven processes via normal way. See HUDSON-3644.

Overrides:

getEnvironment in class AbstractMavenBuild<MavenModuleSet,MavenModuleSetBuild>

Throws:

IOException

InterruptedException

getResult

public hudson.model.Result getResult()

Displays the combined status of all modules.

More precisely, this picks up the status of this build itself, plus all the latest builds of the modules that belongs to this build.

Overrides:

getResult in class hudson.model.Run<MavenModuleSet,MavenModuleSetBuild>

getModuleBuilds

public Map<MavenModule,List<MavenBuild>> getModuleBuilds()

Computes the module builds that correspond to this build.

A module may be built multiple times (by the user action), so the value is a list.

getEstimatedDuration

public long getEstimatedDuration()

Returns the estimated duration for this builds. Takes only the modules into account which are actually being build in case of incremental builds.

Specified by:

getEstimatedDuration in interface hudson.model.Queue.Executable

Overrides:

getEstimatedDuration in class hudson.model.Run<MavenModuleSet,MavenModuleSetBuild>

Returns:

the estimated duration in milliseconds

Since:

1.383

getMavenVersionUsed

@Exported
public String getMavenVersionUsed()

Gets the version of Maven used for build.

Returns:

null if this build is done by earlier version of Jenkins that didn't record this information (this means the build was done by Maven2.x)

setMavenVersionUsed

public void setMavenVersionUsed(String mavenVersionUsed)
                         throws IOException

Throws:

IOException

delete

public void delete()
            throws IOException

Overrides:

delete in class hudson.model.Run<MavenModuleSet,MavenModuleSetBuild>

Throws:

IOException

deleteArtifacts

public void deleteArtifacts()
                     throws IOException

Overrides:

deleteArtifacts in class hudson.model.Run<MavenModuleSet,MavenModuleSetBuild>

Throws:

IOException

getDynamic

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

Overrides:

getDynamic in class hudson.model.Run<MavenModuleSet,MavenModuleSetBuild>

getMavenArtifacts

@Exported
public MavenAggregatedArtifactRecord getMavenArtifacts()

Information about artifacts produced by Maven.

getModuleLastBuilds

public Map<MavenModule,MavenBuild> getModuleLastBuilds()

Computes the latest module builds that correspond to this build. (when individual modules are built, a new ModuleSetBuild is not created, but rather the new module build falls under the previous ModuleSetBuild)

registerAsProjectAction

public void registerAsProjectAction(MavenReporter reporter)

findModuleBuildActions

public <T extends hudson.model.Action> List<T> findModuleBuildActions(Class<T> action)

Finds Actions from all the module builds that belong to this MavenModuleSetBuild. One action per one MavenModule, and newer ones take precedence over older ones.

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<MavenModuleSet,MavenModuleSetBuild>

getDownstreamRelationship

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

Overrides:

getDownstreamRelationship in class hudson.model.AbstractBuild<MavenModuleSet,MavenModuleSetBuild>

getMavenOpts

public String getMavenOpts(hudson.model.TaskListener listener,
                           hudson.EnvVars envVars)

Description copied from class: AbstractMavenBuild

Obtains the fully resolved MAVEN_OPTS with all the tokens and variables expanded.

Specified by:

getMavenOpts in class AbstractMavenBuild<MavenModuleSet,MavenModuleSetBuild>

envVars - Caller must pass in the environment variables obtained from AbstractMavenBuild.getEnvironment(TaskListener) This method takes this as a parameter as opposed to recomputing it since the caller always have this handy.

See Also:

MavenModuleSet.getMavenOpts()

isRelease

protected Boolean isRelease()

Check if the current build is a release or not. If all its maven modules are not SNAPSHOT then it is a release

Returns:

true if MavenModuleSetBuild is a release

Since:

2.12.2

getParent

public MavenModuleSet getParent()

Specified by:

getParent in interface hudson.model.Queue.Executable

Overrides:

getParent in class hudson.model.AbstractBuild<MavenModuleSet,MavenModuleSetBuild>