hudson.maven

Class MavenModule

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Actionable

hudson.model.AbstractItem

hudson.model.Job<P,R>

hudson.model.AbstractProject<P,R>

hudson.maven.AbstractMavenProject<MavenModule,MavenBuild>

hudson.maven.MavenModule

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.BuildableItem, hudson.model.DescriptorByNameOwner, hudson.model.Item, hudson.model.ModelObject, hudson.model.PersistenceRoot, hudson.model.queue.SubTask, hudson.model.Queue.Task, hudson.model.ResourceActivity, hudson.model.Saveable, hudson.search.SearchableModelObject, hudson.search.SearchItem, hudson.security.AccessControlled, hudson.tasks.Maven.ProjectWithMaven, jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<MavenModule,MavenBuild>, jenkins.model.ModelObjectWithChildren, jenkins.model.ModelObjectWithContextMenu, jenkins.model.ParameterizedJobMixIn.ParameterizedJob, jenkins.util.io.OnMaster, org.kohsuke.stapler.HttpDeletable, org.kohsuke.stapler.StaplerOverridable

public class MavenModule
extends AbstractMavenProject<MavenModule,MavenBuild>
implements hudson.model.Saveable

Job that builds projects based on Maven2.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from class hudson.maven.AbstractMavenProject

AbstractMavenProject.MavenModuleDependency

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

hudson.model.AbstractProject.AbstractProjectDescriptor, hudson.model.AbstractProject.BecauseOfBuildInProgress, hudson.model.AbstractProject.BecauseOfDownstreamBuildInProgress, hudson.model.AbstractProject.BecauseOfUpstreamBuildInProgress, hudson.model.AbstractProject.LabelValidator

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

hudson.model.Job.LastItemListener

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.AbstractProject

ABORT, blockBuildWhenDownstreamBuilding, blockBuildWhenUpstreamBuilding, BUILD_NOW_TEXT, builds, disabled, transientActions, triggers

Fields inherited from class hudson.model.Job

HISTORY_ADAPTER, nextBuildNumber, properties, runIdMigrator

Fields inherited from class hudson.model.AbstractItem

description, name, PRONOUN

Fields inherited from interface hudson.model.Saveable

NOOP

Fields inherited from interface hudson.model.Item

BUILD, CANCEL, CONFIGURE, CREATE, DELETE, DISCOVER, EXTENDED_READ, PERMISSIONS, READ, WIPEOUT, WORKSPACE

Method Summary

Modifier and Type	Method and Description
protected void	addTransientActionsFromBuild(MavenBuild build, List<hudson.model.Action> collection, Set<Class> added)
ModuleDependency	asDependency() Gets groupId+artifactId+version as ModuleDependency.
protected void	buildDependencyGraph(hudson.model.DependencyGraph graph)
protected List<MavenReporter>	createReporters() Creates a list of MavenReporters to be used for a build of this project.
protected void	doSetName(String name)
protected Collection<MavenModule>	getAllMavenModules() Returns all Maven modules in this Jenkins instance.
String	getArtifactId() Short-cut for getModuleName().artifactId
hudson.model.Label	getAssignedLabel() MavenModule uses the workspace of the MavenModuleSet, so it always needs to be built on the same slave as the parent.
protected Class<MavenBuild>	getBuildClass()
List<MavenModule>	getChildren() Gets all the child modules (that are listed in the <module> element in our POM).
Set<ModuleDependency>	getDependencies() defensive copy of ModuleDependency
String	getDisplayName()
String	getGoals() Gets the list of goals to execute for this module.
String	getGroupId() Short-cut for getModuleName().groupId
hudson.model.JDK	getJDK()
hudson.tasks.LogRotator	getLogRotator() MavenModule follows the same log rotation schedule as its parent.
ModuleName	getModuleName()
String	getPackaging() Packaging type of the module.
MavenModuleSet	getParent()
String	getPronoun()
hudson.util.DescribableList<hudson.tasks.Publisher,hudson.model.Descriptor<hudson.tasks.Publisher>>	getPublishersList()
String	getRelativePath() Relative path to this module's root directory from the workspace of a MavenModuleSet.
hudson.util.DescribableList<MavenReporter,hudson.model.Descriptor<MavenReporter>>	getReporters() List of active MavenReporters configured for this module.
String	getShortUrl()
List<MavenModule>	getSubsidiaries() Computes the list of MavenModules that are 'under' this POM filesystem-wise.
String	getUserConfiguredGoals() Gets the list of goals specified by the user, without taking inheritance and POM default goals into account.
String	getVersion() Gets the version number in Maven POM as of the last build.
hudson.model.Resource	getWorkspaceResource() Deprecated. as of 1.319 in AbstractProject.
hudson.tasks.Maven.MavenInstallation	inferMavenInstallation()
boolean	isBuildable()
boolean	isFingerprintConfigured()
boolean	isNameEditable()
boolean	isSameModule(hudson.maven.PomInfo pom) Returns if the given POM likely describes the same module with the same dependencies.
protected MavenBuild	newBuild()
void	onLoad(hudson.model.ItemGroup<? extends hudson.model.Item> parent, String name)
protected void	performDelete()
void	setLogRotator(hudson.tasks.LogRotator logRotator) Deprecated. Not allowed to configure log rotation per module.
protected void	submit(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp)
boolean	supportsLogRotator()
String	toString() for debug purpose
protected void	updateTransientActions()

Methods inherited from class hudson.maven.AbstractMavenProject

createTransientActions

Methods inherited from class hudson.model.AbstractProject

_getRuns, addProperty, addToList, addTrigger, blockBuildWhenDownstreamBuilding, blockBuildWhenUpstreamBuilding, buildDescribable, buildDescribable, checkAbortPermission, checkout, createExecutable, createHistoryWidget, disable, doBuild, doBuild, doBuildWithParameters, doBuildWithParameters, doCancelQueue, doCheckRetryCount, doConfigSubmit, doDisable, doDoWipeOutWorkspace, doEnable, doPolling, doRssChangelog, doWs, enable, findNearest, findNearest, getActions, getAssignedLabelString, getAuthToken, getBuild, getBuildByNumber, getBuildingDownstream, getBuildingUpstream, getBuildNowText, getBuildTriggerUpstreamProjects, getCauseOfBlockage, getCustomWorkspace, getDefaultAuthentication, getDefaultAuthentication, getDelay, getDownstreamProjects, getEnvironment, getFirstBuild, getHasCustomQuietPeriod, getIconColor, getLastBuild, getLastBuiltOn, getLazyBuildMixIn, getModuleRoot, getModuleRoots, getNearestBuild, getNearestOldBuild, getOwnerTask, getProminentActions, getQueueItem, getQuietPeriod, getRelationship, getRelevantLabels, getResourceActivities, getResourceList, getRootProject, getSameNodeConstraint, getScm, getScmCheckoutRetryCount, getScmCheckoutStrategy, getSomeBuildWithWorkspace, getSomeWorkspace, getSubTasks, getTransitiveDownstreamProjects, getTransitiveUpstreamProjects, getTrigger, getTriggers, getUpstreamProjects, getWhyBlocked, getWorkspace, hasAbortPermission, hasCustomScmCheckoutRetryCount, hasParticipant, isBuildBlocked, isConcurrentBuild, isConfigurable, isDisabled, isInQueue, isParameterized, loadBuild, makeDisabled, makeSearchIndex, onCreatedFromScratch, poll, pollSCMChanges, removeFromList, removeRun, removeTrigger, resolveForCLI, save, scheduleBuild, scheduleBuild, scheduleBuild, scheduleBuild, scheduleBuild, scheduleBuild2, scheduleBuild2, scheduleBuild2, scheduleBuild2, schedulePolling, setAssignedLabel, setAssignedNode, setBlockBuildWhenDownstreamBuilding, setBlockBuildWhenUpstreamBuilding, setConcurrentBuild, setCustomWorkspace, setJDK, setQuietPeriod, setScm, setScmCheckoutStrategy, supportsMakeDisabled, triggers

Methods inherited from class hudson.model.Job

assignBuildNumber, delete, doBuildStatus, doChildrenContextMenu, doDescription, doDoRename, doRssAll, doRssFailed, getACL, getAllJobs, getAllProperties, getBuildDir, getBuildDiscarder, getBuildForCLI, getBuildHealth, getBuildHealthReports, getBuilds, getBuilds, getBuildsAsMap, getBuildsByTimestamp, getBuildStatusIconClassName, getBuildStatusUrl, getBuildTimeGraph, getCharacteristicEnvVars, getDynamic, getEstimatedDuration, getEstimatedDurationCandidates, getLastBuildsOverThreshold, getLastCompletedBuild, getLastFailedBuild, getLastStableBuild, getLastSuccessfulBuild, getLastUnstableBuild, getLastUnsuccessfulBuild, getNewBuilds, getNextBuildNumber, getOverrides, getPermalinks, getProperties, getProperty, getProperty, getTimeline, getWidgets, isBuilding, isHoldOffBuildUntilSave, isKeepDependencies, isLogUpdated, logRotate, movedTo, onCopiedFrom, removeProperty, removeProperty, renameTo, saveNextBuildNumber, setBuildDiscarder, updateNextBuildNumber

Methods inherited from class hudson.model.AbstractItem

checkPermission, delete, doConfigDotXml, doDoDelete, doReload, doSubmitDescription, getAbsoluteUrl, getApi, getConfigFile, getDescription, getDescriptorByName, getDisplayNameOrNull, getFullDisplayName, getFullName, getName, getRelativeDisplayNameFrom, getRelativeNameFrom, getRelativeNameFrom, getRelativeNameFromGroup, getRootDir, getSearchName, getSearchUrl, getUrl, hasPermission, setDescription, setDisplayName, setDisplayNameOrNull, updateByXml, updateByXml

Methods inherited from class hudson.model.Actionable

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

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, 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.Saveable

save

Methods inherited from interface hudson.model.Queue.Task

getFullDisplayName, getName, getUrl

Methods inherited from interface hudson.model.queue.SubTask

getEstimatedDuration

Methods inherited from interface hudson.model.Item

delete, getAbsoluteUrl, getAllJobs, getFullDisplayName, getFullName, getName, getRelativeNameFrom, getRelativeNameFrom, getUrl, onCopiedFrom

Methods inherited from interface hudson.model.PersistenceRoot

getRootDir

Methods inherited from interface hudson.search.SearchableModelObject

getSearch

Methods inherited from interface hudson.search.SearchItem

getSearchIndex, getSearchName, getSearchUrl

Methods inherited from interface hudson.security.AccessControlled

checkPermission, getACL, hasPermission

Method Detail

getLogRotator

public hudson.tasks.LogRotator getLogRotator()

MavenModule follows the same log rotation schedule as its parent.

Overrides:

getLogRotator in class hudson.model.Job<MavenModule,MavenBuild>

setLogRotator

public void setLogRotator(hudson.tasks.LogRotator logRotator)

Deprecated. Not allowed to configure log rotation per module.

Overrides:

setLogRotator in class hudson.model.Job<MavenModule,MavenBuild>

supportsLogRotator

public boolean supportsLogRotator()

Overrides:

supportsLogRotator in class hudson.model.Job<MavenModule,MavenBuild>

isBuildable

public boolean isBuildable()

Overrides:

isBuildable in class hudson.model.AbstractProject<MavenModule,MavenBuild>

getSubsidiaries

public List<MavenModule> getSubsidiaries()

Computes the list of MavenModules that are 'under' this POM filesystem-wise. The list doens't include this module itself.

Note that this doesn't necessary has anything to do with the module inheritance structure or parent/child relationship of the POM.

isSameModule

public boolean isSameModule(hudson.maven.PomInfo pom)

Returns if the given POM likely describes the same module with the same dependencies. Implementation needs not be 100% accurate in the true case, but it MUST return false if is not the same.

doSetName

protected void doSetName(String name)

Overrides:

doSetName in class hudson.model.AbstractItem

onLoad

public void onLoad(hudson.model.ItemGroup<? extends hudson.model.Item> parent,
                   String name)
            throws IOException

Specified by:

onLoad in interface hudson.model.Item

Overrides:

onLoad in class hudson.model.AbstractProject<MavenModule,MavenBuild>

Throws:

IOException

getRelativePath

public String getRelativePath()

Relative path to this module's root directory from the workspace of a MavenModuleSet. The path separator is normalized to '/'.

getVersion

public String getVersion()

Gets the version number in Maven POM as of the last build.

Returns:

This method can return null if Jenkins loaded old data that didn't record this information, so that situation needs to be handled gracefully.

Since:

1.199

getPackaging

public String getPackaging()

Packaging type of the module. pom, jar, maven-plugin, ejb, war, ear, rar, par or other custom types.

Since:

2.1

getGroupId

public String getGroupId()

Short-cut for getModuleName().groupId

Since:

2.1

getArtifactId

public String getArtifactId()

Short-cut for getModuleName().artifactId

Since:

2.1

getGoals

public String getGoals()

Gets the list of goals to execute for this module.

getUserConfiguredGoals

public String getUserConfiguredGoals()

Gets the list of goals specified by the user, without taking inheritance and POM default goals into account.

This is only used to present the UI screen, and in all the other cases getGoals() should be used.

getPublishersList

public hudson.util.DescribableList<hudson.tasks.Publisher,hudson.model.Descriptor<hudson.tasks.Publisher>> getPublishersList()

Specified by:

getPublishersList in class hudson.model.AbstractProject<MavenModule,MavenBuild>

getJDK

public hudson.model.JDK getJDK()

Overrides:

getJDK in class hudson.model.AbstractProject<MavenModule,MavenBuild>

getBuildClass

protected Class<MavenBuild> getBuildClass()

Specified by:

getBuildClass in class hudson.model.AbstractProject<MavenModule,MavenBuild>

newBuild

protected MavenBuild newBuild()
                       throws IOException

Overrides:

newBuild in class hudson.model.AbstractProject<MavenModule,MavenBuild>

Throws:

IOException

getModuleName

public ModuleName getModuleName()

asDependency

public ModuleDependency asDependency()

Gets groupId+artifactId+version as ModuleDependency.

getShortUrl

public String getShortUrl()

Specified by:

getShortUrl in interface hudson.model.Item

Overrides:

getShortUrl in class hudson.model.AbstractItem

getDisplayName

@Exported(visibility=2)
public String getDisplayName()

Specified by:

getDisplayName in interface hudson.model.Item

Specified by:

getDisplayName in interface hudson.model.ModelObject

Specified by:

getDisplayName in interface hudson.model.ResourceActivity

Overrides:

getDisplayName in class hudson.model.AbstractItem

getPronoun

public String getPronoun()

Overrides:

getPronoun in class hudson.model.AbstractProject<MavenModule,MavenBuild>

isNameEditable

public boolean isNameEditable()

Overrides:

isNameEditable in class hudson.model.Job<MavenModule,MavenBuild>

getParent

public MavenModuleSet getParent()

Specified by:

getParent in interface hudson.model.Item

Overrides:

getParent in class hudson.model.AbstractItem

getChildren

public List<MavenModule> getChildren()

Gets all the child modules (that are listed in the <module> element in our POM).

This method returns null if this information is not recorded. This happens for compatibility reason.

Since:

1.133

getAssignedLabel

public hudson.model.Label getAssignedLabel()

MavenModule uses the workspace of the MavenModuleSet, so it always needs to be built on the same slave as the parent.

Specified by:

getAssignedLabel in interface hudson.model.queue.SubTask

Overrides:

getAssignedLabel in class hudson.model.AbstractProject<MavenModule,MavenBuild>

getWorkspaceResource

public hudson.model.Resource getWorkspaceResource()

Deprecated. as of 1.319 in AbstractProject.

Workspace of a MavenModule is a part of the parent's workspace.

That is, MavenModuleSet builds are incompatible with any MavenModule builds, whereas MavenModule builds are compatible with each other.

Overrides:

getWorkspaceResource in class hudson.model.AbstractProject<MavenModule,MavenBuild>

isFingerprintConfigured

public boolean isFingerprintConfigured()

Specified by:

isFingerprintConfigured in class hudson.model.AbstractProject<MavenModule,MavenBuild>

updateTransientActions

protected void updateTransientActions()

Overrides:

updateTransientActions in class hudson.model.AbstractProject<MavenModule,MavenBuild>

buildDependencyGraph

protected void buildDependencyGraph(hudson.model.DependencyGraph graph)

Overrides:

buildDependencyGraph in class hudson.model.AbstractProject<MavenModule,MavenBuild>

getAllMavenModules

protected Collection<MavenModule> getAllMavenModules()

Returns all Maven modules in this Jenkins instance.

addTransientActionsFromBuild

protected void addTransientActionsFromBuild(MavenBuild build,
                                            List<hudson.model.Action> collection,
                                            Set<Class> added)

Specified by:

addTransientActionsFromBuild in class AbstractMavenProject<MavenModule,MavenBuild>

collection - Add the transient actions to this collection.

inferMavenInstallation

public hudson.tasks.Maven.MavenInstallation inferMavenInstallation()

Specified by:

inferMavenInstallation in interface hudson.tasks.Maven.ProjectWithMaven

getReporters

public hudson.util.DescribableList<MavenReporter,hudson.model.Descriptor<MavenReporter>> getReporters()

List of active MavenReporters configured for this module.

submit

protected void submit(org.kohsuke.stapler.StaplerRequest req,
                      org.kohsuke.stapler.StaplerResponse rsp)
               throws IOException,
                      javax.servlet.ServletException,
                      hudson.model.Descriptor.FormException

Overrides:

submit in class hudson.model.AbstractProject<MavenModule,MavenBuild>

Throws:

IOException

javax.servlet.ServletException

hudson.model.Descriptor.FormException

performDelete

protected void performDelete()
                      throws IOException,
                             InterruptedException

Overrides:

performDelete in class hudson.model.AbstractProject<MavenModule,MavenBuild>

Throws:

IOException

InterruptedException

createReporters

protected List<MavenReporter> createReporters()

Creates a list of MavenReporters to be used for a build of this project.

getDependencies

public Set<ModuleDependency> getDependencies()

defensive copy of ModuleDependency

Since:

2.2

toString

public String toString()

for debug purpose

Overrides:

toString in class hudson.model.AbstractItem