hudson.tasks

Class Maven

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Builder

hudson.tasks.Maven

All Implemented Interfaces:

ExtensionPoint, Describable<Builder>, BuildStep

public class Maven
extends Builder

Build by using Maven.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Maven.DescriptorImpl
static class	Maven.MavenInstallation Represents a Maven installation in a system.
static class	Maven.MavenInstaller Automatic Maven installer from apache.org.
static interface	Maven.ProjectWithMaven Optional interface that can be implemented by AbstractProject that has "contextual" Maven.MavenInstallation associated with it.

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface hudson.tasks.BuildStep

BuildStep.PublisherList

Field Summary

Fields

Modifier and Type	Field and Description
static Maven.DescriptorImpl	DESCRIPTOR Deprecated. as of 1.286 Use Jenkins.getDescriptorByType(Class) to obtain the current instance. For compatibility, this field retains the last created Maven.DescriptorImpl. TODO: fix sonar plugin that depends on this. That's the only plugin that depends on this field.
String	jvmOptions MAVEN_OPTS if not null.
String	mavenName Identifies Maven.MavenInstallation to be used.
String	pom Optional POM file path relative to the workspace.
String	properties Optional properties to be passed to Maven.
String	targets The targets and other maven options.
boolean	usePrivateRepository If true, the build will use its own local Maven repository via "-Dmaven.repo.local=...".

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor and Description
Maven(String targets, String name)
Maven(String targets, String name, String pom, String properties, String jvmOptions)
Maven(String targets, String name, String pom, String properties, String jvmOptions, boolean usePrivateRepository)
Maven(String targets, String name, String pom, String properties, String jvmOptions, boolean usePrivateRepository, SettingsProvider settings, GlobalSettingsProvider globalSettings)
Maven(String targets, String name, String pom, String properties, String jvmOptions, boolean usePrivateRepository, SettingsProvider settings, GlobalSettingsProvider globalSettings, boolean injectBuildVariables)

Method Summary

Modifier and Type	Method and Description
protected void	buildEnvVars(EnvVars env, Maven.MavenInstallation mi) Build up the environment variables toward the Maven launch.
Maven.DescriptorImpl	getDescriptor() Gets the descriptor for this instance.
GlobalSettingsProvider	getGlobalSettings()
Maven.MavenInstallation	getMaven() Gets the Maven to invoke, or null to invoke the default one.
SettingsProvider	getSettings()
String	getTargets()
boolean	isInjectBuildVariables()
boolean	perform(AbstractBuild<?,?> build, Launcher launcher, BuildListener listener) Runs the step over the given build and reports the progress to the listener.
protected void	setGlobalSettings(GlobalSettingsProvider globalSettings)
protected void	setSettings(SettingsProvider settings)
void	setUsePrivateRepository(boolean usePrivateRepository)
boolean	usesPrivateRepository()
protected void	wrapUpArguments(ArgumentListBuilder args, String normalizedTarget, AbstractBuild<?,?> build, Launcher launcher, BuildListener listener) Allows the derived type to make additional modifications to the arguments list.

Methods inherited from class hudson.tasks.Builder

all, getRequiredMonitorService, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, getProjectAction, getProjectActions, perform, prebuild

Methods inherited from class java.lang.Object

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

Field Detail

targets

public final String targets

The targets and other maven options. Can be separated by SP or NL.

mavenName

public final String mavenName

Identifies Maven.MavenInstallation to be used.

jvmOptions

public final String jvmOptions

MAVEN_OPTS if not null.

pom

public final String pom

Optional POM file path relative to the workspace. Used for the Maven '-f' option.

properties

public final String properties

Optional properties to be passed to Maven. Follows Properties syntax.

usePrivateRepository

public boolean usePrivateRepository

If true, the build will use its own local Maven repository via "-Dmaven.repo.local=...".

This would consume additional disk space, but provides isolation with other builds on the same machine, such as mixing SNAPSHOTS. Maven also doesn't try to coordinate the concurrent access to Maven repositories from multiple Maven process, so this helps there too. Identical to logic used in maven-plugin.

Since:

1.322

DESCRIPTOR

@Deprecated
public static Maven.DescriptorImpl DESCRIPTOR

Deprecated. as of 1.286 Use Jenkins.getDescriptorByType(Class) to obtain the current instance. For compatibility, this field retains the last created Maven.DescriptorImpl. TODO: fix sonar plugin that depends on this. That's the only plugin that depends on this field.

Constructor Detail

Maven

public Maven(String targets,
             String name)

Maven

public Maven(String targets,
             String name,
             String pom,
             String properties,
             String jvmOptions)

Maven

public Maven(String targets,
             String name,
             String pom,
             String properties,
             String jvmOptions,
             boolean usePrivateRepository)

Maven

public Maven(String targets,
             String name,
             String pom,
             String properties,
             String jvmOptions,
             boolean usePrivateRepository,
             SettingsProvider settings,
             GlobalSettingsProvider globalSettings)

Maven

@DataBoundConstructor
public Maven(String targets,
                                   String name,
                                   String pom,
                                   String properties,
                                   String jvmOptions,
                                   boolean usePrivateRepository,
                                   SettingsProvider settings,
                                   GlobalSettingsProvider globalSettings,
                                   boolean injectBuildVariables)

Method Detail

getTargets

public String getTargets()

getSettings

public SettingsProvider getSettings()

Since:

1.491

setSettings

protected void setSettings(SettingsProvider settings)

getGlobalSettings

public GlobalSettingsProvider getGlobalSettings()

Since:

1.491

setGlobalSettings

protected void setGlobalSettings(GlobalSettingsProvider globalSettings)

setUsePrivateRepository

public void setUsePrivateRepository(boolean usePrivateRepository)

usesPrivateRepository

public boolean usesPrivateRepository()

isInjectBuildVariables

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public boolean isInjectBuildVariables()

getMaven

public Maven.MavenInstallation getMaven()

Gets the Maven to invoke, or null to invoke the default one.

perform

public boolean perform(AbstractBuild<?,?> build,
                       Launcher launcher,
                       BuildListener listener)
                throws IOException,
                       InterruptedException

Description copied from interface: BuildStep

Runs the step over the given build and reports the progress to the listener.

A plugin can contribute the action object to Actionable.getActions() so that a 'report' becomes a part of the persisted data of Build. This is how JUnit plugin attaches the test report to a build page, for example.

When this build step needs to make (direct or indirect) permission checks to ACL (for example, to locate other projects by name, build them, or access their artifacts) then it must be run under a specific Authentication. In such a case, the implementation should check whether Jenkins.getAuthentication() is ACL.SYSTEM, and if so, replace it for the duration of this step with Jenkins.ANONYMOUS. (Either using ACL.impersonate(org.acegisecurity.Authentication), or by making explicit calls to ACL.hasPermission(Authentication, Permission).) This would typically happen when no QueueItemAuthenticator was available, configured, and active.

Specified by:

perform in interface BuildStep

Overrides:

perform in class BuildStepCompatibilityLayer

Returns:

Delegates to SimpleBuildStep.perform(Run, FilePath, Launcher, TaskListener) if possible, always returning true or throwing an error.

Throws:

IOException - If the implementation wants to abort the processing when an IOException happens, it can simply propagate the exception to the caller. This will cause the build to fail, with the default error message. Implementations are encouraged to catch IOException on its own to provide a better error message, if it can do so, so that users have better understanding on why it failed.

InterruptedException - If the build is interrupted by the user (in an attempt to abort the build.) Normally the BuildStep implementations may simply forward the exception it got from its lower-level functions.

wrapUpArguments

protected void wrapUpArguments(ArgumentListBuilder args,
                               String normalizedTarget,
                               AbstractBuild<?,?> build,
                               Launcher launcher,
                               BuildListener listener)
                        throws IOException,
                               InterruptedException

Allows the derived type to make additional modifications to the arguments list.

Throws:

IOException

InterruptedException

Since:

1.344

buildEnvVars

protected void buildEnvVars(EnvVars env,
                            Maven.MavenInstallation mi)
                     throws IOException,
                            InterruptedException

Build up the environment variables toward the Maven launch.

Throws:

IOException

InterruptedException

getDescriptor

public Maven.DescriptorImpl getDescriptor()

Description copied from interface: Describable

Gets the descriptor for this instance.

Descriptor is a singleton for every concrete Describable implementation, so if a.getClass() == b.getClass() then by default a.getDescriptor() == b.getDescriptor() as well. (In rare cases a single implementation class may be used for instances with distinct descriptors.)

Specified by:

getDescriptor in interface Describable<Builder>

Overrides:

getDescriptor in class Builder