org.apache.maven.shared.invoker
Interface InvocationRequest

All Known Implementing Classes:

DefaultInvocationRequest

public interface InvocationRequest

Specifies the parameters used to control a Maven invocation.

Version:

$Id: InvocationRequest.java 807415 2009-08-24 22:32:16Z olamy $

Field Summary

static java.lang.String	CHECKSUM_POLICY_FAIL The strict checksum policy which fails the build if a corrupt artifact is detected.
static java.lang.String	CHECKSUM_POLICY_WARN The lax checksum policy which only outputs a warning if a corrupt artifact is detected.
static java.lang.String	REACTOR_FAIL_AT_END The failure mode "fail-at-end" where the build is only failed at its very end if necessary.
static java.lang.String	REACTOR_FAIL_FAST The failure mode "fail-fast" where the build is stopped by the first failure.
static java.lang.String	REACTOR_FAIL_NEVER The failure mode "fail-never" in which Maven will always exit with code 0 regardless of build failures.

Method Summary

InvocationRequest	activateReactor(java.lang.String[] includes, java.lang.String[] excludes) Dynamically constructs a reactor using the subdirectories of the current directory
InvocationRequest	addShellEnvironment(java.lang.String name, java.lang.String value) Adds the specified environment variable to the Maven invocation.
java.lang.String[]	getActivatedReactorExcludes() Gets the list of subdirectory patterns to exclude from search
java.lang.String[]	getActivatedReactorIncludes() Gets the list of subdirectory patterns to search
java.io.File	getBaseDirectory() Gets the path to the base directory of the POM for the Maven invocation.
java.io.File	getBaseDirectory(java.io.File defaultDirectory) Gets the path to the base directory of the POM for the Maven invocation.
InvocationOutputHandler	getErrorHandler(InvocationOutputHandler defaultHandler) Gets the handler used to capture the error output from the Maven build.
java.lang.String	getFailureBehavior() Gets the failure mode of the Maven invocation.
java.lang.String	getGlobalChecksumPolicy() Gets the checksum mode of the Maven invocation.
java.util.List	getGoals() Gets the goals for the Maven invocation.
java.io.InputStream	getInputStream(java.io.InputStream defaultStream) Gets the input stream used to provide input for the invoked Maven build.
java.io.File	getJavaHome() Gets the path to the base directory of the Java installation used to run Maven.
java.io.File	getLocalRepositoryDirectory(java.io.File defaultDirectory) Gets the path to the base directory of the local repository to use for the Maven invocation.
java.lang.String	getMavenOpts() Gets the value of the MAVEN_OPTS environment variable.
InvocationOutputHandler	getOutputHandler(InvocationOutputHandler defaultHandler) Gets the handler used to capture the standard output from the Maven build.
java.io.File	getPomFile() Gets the path to the POM for the Maven invocation.
java.lang.String	getPomFileName() Gets the (unqualified) filename of the POM for the Maven invocation.
java.util.List	getProfiles() Gets the profiles for the Maven invocation.
java.util.Properties	getProperties() Gets the system properties for the Maven invocation.
java.util.Map	getShellEnvironments() Gets the environment variables for the Maven invocation.
java.io.File	getUserSettingsFile() Gets the path to the user settings for the Maven invocation.
boolean	isActivatedReactor() Gets whether Maven should search subdirectories to build a dynamic reactor
boolean	isDebug() Gets the debug mode of the Maven invocation.
boolean	isInteractive() Gets the interaction mode of the Maven invocation.
boolean	isNonPluginUpdates() Indicates whether Maven should check for plugin updates.
boolean	isOffline() Gets the network mode of the Maven invocation.
boolean	isRecursive() Gets the recursion behavior of a reactor invocation.
boolean	isShellEnvironmentInherited() Indicates whether the environment variables of the current process should be propagated to the Maven invocation.
boolean	isShowErrors() Gets the exception output mode of the Maven invocation.
boolean	isShowVersion() The show version behaviour (-V option)
boolean	isUpdateSnapshots() Indicates whether Maven should enforce an update check for plugins and snapshots.
InvocationRequest	setBaseDirectory(java.io.File basedir) Sets the path to the base directory of the POM for the Maven invocation.
InvocationRequest	setDebug(boolean debug) Sets the debug mode of the Maven invocation.
InvocationRequest	setErrorHandler(InvocationOutputHandler errorHandler) Sets the handler used to capture the error output from the Maven build.
InvocationRequest	setFailureBehavior(java.lang.String failureBehavior) Sets the failure mode of the Maven invocation.
InvocationRequest	setGlobalChecksumPolicy(java.lang.String globalChecksumPolicy) Sets the checksum mode of the Maven invocation.
InvocationRequest	setGoals(java.util.List goals) Sets the goals for the Maven invocation.
InvocationRequest	setInputStream(java.io.InputStream inputStream) Sets the input stream used to provide input for the invoked Maven build.
InvocationRequest	setInteractive(boolean interactive) Sets the interaction mode of the Maven invocation.
InvocationRequest	setJavaHome(java.io.File javaHome) Sets the path to the base directory of the Java installation used to run Maven.
InvocationRequest	setLocalRepositoryDirectory(java.io.File localRepository) Sets the path to the base directory of the local repository to use for the Maven invocation.
InvocationRequest	setMavenOpts(java.lang.String mavenOpts) Sets the value of the MAVEN_OPTS environment variable.
InvocationRequest	setNonPluginUpdates(boolean nonPluginUpdates) Specifies whether Maven should check for plugin updates.
InvocationRequest	setOffline(boolean offline) Sets the network mode of the Maven invocation.
InvocationRequest	setOutputHandler(InvocationOutputHandler outputHandler) Sets the handler used to capture the standard output from the Maven build.
InvocationRequest	setPomFile(java.io.File pomFile) Sets the path to the POM for the Maven invocation.
InvocationRequest	setPomFileName(java.lang.String pomFilename) Sets the (unqualified) filename of the POM for the Maven invocation.
InvocationRequest	setProfiles(java.util.List profiles) Sets the profiles for the Maven invocation.
InvocationRequest	setProperties(java.util.Properties properties) Sets the system properties for the Maven invocation.
InvocationRequest	setRecursive(boolean recursive) Sets the recursion behavior of a reactor invocation.
InvocationRequest	setShellEnvironmentInherited(boolean shellEnvironmentInherited) Specifies whether the environment variables of the current process should be propagated to the Maven invocation.
InvocationRequest	setShowErrors(boolean showErrors) Sets the exception output mode of the Maven invocation.
InvocationRequest	setShowVersion(boolean showVersion) enable displaying version without stopping the build (-V cli option)
InvocationRequest	setUpdateSnapshots(boolean updateSnapshots) Specifies whether Maven should enforce an update check for plugins and snapshots.
InvocationRequest	setUserSettingsFile(java.io.File userSettings) Sets the path to the user settings for the Maven invocation.

Field Detail

REACTOR_FAIL_FAST

public static final java.lang.String REACTOR_FAIL_FAST

The failure mode "fail-fast" where the build is stopped by the first failure.

See Also:

Constant Field Values

REACTOR_FAIL_AT_END

public static final java.lang.String REACTOR_FAIL_AT_END

The failure mode "fail-at-end" where the build is only failed at its very end if necessary.

See Also:

Constant Field Values

REACTOR_FAIL_NEVER

public static final java.lang.String REACTOR_FAIL_NEVER

The failure mode "fail-never" in which Maven will always exit with code 0 regardless of build failures.

See Also:

Constant Field Values

CHECKSUM_POLICY_FAIL

public static final java.lang.String CHECKSUM_POLICY_FAIL

The strict checksum policy which fails the build if a corrupt artifact is detected.

See Also:

Constant Field Values

CHECKSUM_POLICY_WARN

public static final java.lang.String CHECKSUM_POLICY_WARN

The lax checksum policy which only outputs a warning if a corrupt artifact is detected.

See Also:

Constant Field Values

Method Detail

isInteractive

public boolean isInteractive()

Gets the interaction mode of the Maven invocation. By default, Maven is executed in batch mode.

Returns:

true if Maven should be executed in interactive mode, false if the batch mode is used.

isOffline

public boolean isOffline()

Gets the network mode of the Maven invocation. By default, Maven is executed in online mode.

Returns:

true if Maven should be executed in offline mode, false if the online mode is used.

isUpdateSnapshots

public boolean isUpdateSnapshots()

Indicates whether Maven should enforce an update check for plugins and snapshots. By default, no update check is performed.

Returns:

true if plugins and snapshots should be updated, false otherwise.

isRecursive

public boolean isRecursive()

Gets the recursion behavior of a reactor invocation. By default, Maven will recursive the build into sub modules.

Returns:

true if sub modules should be build, false otherwise.

isActivatedReactor

public boolean isActivatedReactor()

Gets whether Maven should search subdirectories to build a dynamic reactor

Returns:

true if we should search subdirectories, false otherwise

getActivatedReactorIncludes

public java.lang.String[] getActivatedReactorIncludes()

Gets the list of subdirectory patterns to search

Returns:

list of subdirectory patterns to search, or null in which case defaults should be used

getActivatedReactorExcludes

public java.lang.String[] getActivatedReactorExcludes()

Gets the list of subdirectory patterns to exclude from search

Returns:

list of subdirectory patterns to exclude search, or null in which case nothing should be excluded

isDebug

public boolean isDebug()

Gets the debug mode of the Maven invocation. By default, Maven is executed in normal mode.

Returns:

true if Maven should be executed in debug mode, false if the normal mode should be used.

isShowErrors

public boolean isShowErrors()

Gets the exception output mode of the Maven invocation. By default, Maven will not print stack traces of build exceptions.

Returns:

true if Maven should print stack traces, false otherwise.

isShellEnvironmentInherited

public boolean isShellEnvironmentInherited()

Indicates whether the environment variables of the current process should be propagated to the Maven invocation. By default, the current environment variables are inherited by the new Maven invocation.

Returns:

true if the environment variables should be propagated, false otherwise.

isNonPluginUpdates

public boolean isNonPluginUpdates()

Indicates whether Maven should check for plugin updates. By default, plugin updates are not suppressed.

Returns:

true if plugin updates should be suppressed, false otherwise.

getFailureBehavior

public java.lang.String getFailureBehavior()

Gets the failure mode of the Maven invocation. By default, the mode REACTOR_FAIL_FAST is used.

Returns:

The failure mode, one of REACTOR_FAIL_FAST, REACTOR_FAIL_AT_END and REACTOR_FAIL_NEVER.

getLocalRepositoryDirectory

public java.io.File getLocalRepositoryDirectory(java.io.File defaultDirectory)

Gets the path to the base directory of the local repository to use for the Maven invocation.

Parameters:

defaultDirectory - The default location to use if no location is configured for this request, may be null.

Returns:

The path to the base directory of the local repository or null to use the location from the settings.xml.

getInputStream

public java.io.InputStream getInputStream(java.io.InputStream defaultStream)

Gets the input stream used to provide input for the invoked Maven build. This is in particular useful when invoking Maven in interactive mode.

Returns:

The input stream used to provide input for the invoked Maven build or null if not set.

getOutputHandler

public InvocationOutputHandler getOutputHandler(InvocationOutputHandler defaultHandler)

Gets the handler used to capture the standard output from the Maven build.

Returns:

The output handler or null if not set.

getErrorHandler

public InvocationOutputHandler getErrorHandler(InvocationOutputHandler defaultHandler)

Gets the handler used to capture the error output from the Maven build.

Returns:

The error handler or null if not set.

getPomFile

public java.io.File getPomFile()

Gets the path to the POM for the Maven invocation. If no base directory is set, the parent directory of this POM will be used as the working directory for the Maven invocation.

Returns:

The path to the POM for the Maven invocation or null if not set.

getPomFileName

public java.lang.String getPomFileName()

Gets the (unqualified) filename of the POM for the Maven invocation. This setting is ignored if getPomFile() does not return null. Otherwise, the base directory is assumed to contain a POM with this name. By default, a file named pom.xml is used.

Returns:

The (unqualified) filename of the POM for the Maven invocation or null if not set.

getBaseDirectory

public java.io.File getBaseDirectory()

Gets the path to the base directory of the POM for the Maven invocation. If getPomFile() does not return null, this setting only affects the working directory for the Maven invocation.

Returns:

The path to the base directory of the POM or null if not set.

getBaseDirectory

public java.io.File getBaseDirectory(java.io.File defaultDirectory)

Gets the path to the base directory of the POM for the Maven invocation. If getPomFile() does not return null, this setting only affects the working directory for the Maven invocation.

Parameters:

defaultDirectory - The default base directory to use if none is configured for this request, may be null.

Returns:

The path to the base directory of the POM or null if not set.

getJavaHome

public java.io.File getJavaHome()

Gets the path to the base directory of the Java installation used to run Maven.

Returns:

The path to the base directory of the Java installation used to run Maven or null to use the default Java home.

getProperties

public java.util.Properties getProperties()

Gets the system properties for the Maven invocation.

Returns:

The system properties for the Maven invocation or null if not set.

getGoals

public java.util.List getGoals()

Gets the goals for the Maven invocation.

Returns:

The goals for the Maven invocation or null if not set.

getUserSettingsFile

public java.io.File getUserSettingsFile()

Gets the path to the user settings for the Maven invocation.

Returns:

The path to the user settings for the Maven invocation or null to load the user settings from the default location.

getGlobalChecksumPolicy

public java.lang.String getGlobalChecksumPolicy()

Gets the checksum mode of the Maven invocation.

Returns:

The checksum mode, one of CHECKSUM_POLICY_WARN and CHECKSUM_POLICY_FAIL.

getProfiles

public java.util.List getProfiles()

Gets the profiles for the Maven invocation.

Returns:

The profiles for the Maven invocation or null if not set.

getShellEnvironments

public java.util.Map getShellEnvironments()

Gets the environment variables for the Maven invocation.

Returns:

The environment variables for the Maven invocation or null if not set.

getMavenOpts

public java.lang.String getMavenOpts()

Gets the value of the MAVEN_OPTS environment variable.

Returns:

The value of the MAVEN_OPTS environment variable or null if not set.

isShowVersion

public boolean isShowVersion()

The show version behaviour (-V option)

Returns:

The show version behaviour

Since:

2.0.11

setInteractive

public InvocationRequest setInteractive(boolean interactive)

Sets the interaction mode of the Maven invocation.

Parameters:

interactive - true if Maven should be executed in interactive mode, false if the batch mode is used.

Returns:

This invocation request.

setOffline

public InvocationRequest setOffline(boolean offline)

Sets the network mode of the Maven invocation.

Parameters:

offline - true if Maven should be executed in offline mode, false if the online mode is used.

Returns:

This invocation request.

setDebug

public InvocationRequest setDebug(boolean debug)

Sets the debug mode of the Maven invocation.

Parameters:

debug - true if Maven should be executed in debug mode, false if the normal mode should be used.

Returns:

This invocation request.

setShowErrors

public InvocationRequest setShowErrors(boolean showErrors)

Sets the exception output mode of the Maven invocation.

Parameters:

showErrors - true if Maven should print stack traces, false otherwise.

Returns:

This invocation request.

setUpdateSnapshots

public InvocationRequest setUpdateSnapshots(boolean updateSnapshots)

Specifies whether Maven should enforce an update check for plugins and snapshots.

Parameters:

updateSnapshots - true if plugins and snapshots should be updated, false otherwise.

Returns:

This invocation request.

setFailureBehavior

public InvocationRequest setFailureBehavior(java.lang.String failureBehavior)

Sets the failure mode of the Maven invocation.

Parameters:

failureBehavior - The failure mode, must be one of REACTOR_FAIL_FAST, REACTOR_FAIL_AT_END and REACTOR_FAIL_NEVER.

Returns:

This invocation request.

activateReactor

public InvocationRequest activateReactor(java.lang.String[] includes,
                                         java.lang.String[] excludes)

Dynamically constructs a reactor using the subdirectories of the current directory

Parameters:

includes - a list of filename patterns to include, or null, in which case the default is */pom.xml

excludes - a list of filename patterns to exclude, or null, in which case nothing is excluded

Returns:

This invocation request

setLocalRepositoryDirectory

public InvocationRequest setLocalRepositoryDirectory(java.io.File localRepository)

Sets the path to the base directory of the local repository to use for the Maven invocation.

Parameters:

localRepository - The path to the base directory of the local repository, may be null.

Returns:

This invocation request.

setInputStream

public InvocationRequest setInputStream(java.io.InputStream inputStream)

Sets the input stream used to provide input for the invoked Maven build. This is in particular useful when invoking Maven in interactive mode.

Parameters:

inputStream - The input stream used to provide input for the invoked Maven build, may be null if not required.

Returns:

This invocation request.

setOutputHandler

public InvocationRequest setOutputHandler(InvocationOutputHandler outputHandler)

Sets the handler used to capture the standard output from the Maven build.

Parameters:

outputHandler - The output handler, may be null if the output is not of interest.

Returns:

This invocation request.

setErrorHandler

public InvocationRequest setErrorHandler(InvocationOutputHandler errorHandler)

Sets the handler used to capture the error output from the Maven build.

Parameters:

errorHandler - The error handler, may be null if the output is not of interest.

Returns:

This invocation request.

setPomFile

public InvocationRequest setPomFile(java.io.File pomFile)

Sets the path to the POM for the Maven invocation. If no base directory is set, the parent directory of this POM will be used as the working directory for the Maven invocation.

Parameters:

pomFile - The path to the POM for the Maven invocation, may be null if not used.

Returns:

This invocation request.

setPomFileName

public InvocationRequest setPomFileName(java.lang.String pomFilename)

Sets the (unqualified) filename of the POM for the Maven invocation. This setting is ignored if getPomFile() does not return null. Otherwise, the base directory is assumed to contain a POM with this name.

Parameters:

pomFilename - The (unqualified) filename of the POM for the Maven invocation, may be null if not used.

Returns:

This invocation request.

setBaseDirectory

public InvocationRequest setBaseDirectory(java.io.File basedir)

Sets the path to the base directory of the POM for the Maven invocation. If getPomFile() does not return null, this setting only affects the working directory for the Maven invocation.

Parameters:

basedir - The path to the base directory of the POM, may be null if not used.

Returns:

This invocation request.

setJavaHome

public InvocationRequest setJavaHome(java.io.File javaHome)

Sets the path to the base directory of the Java installation used to run Maven.

Parameters:

javaHome - The path to the base directory of the Java installation used to run Maven, may be null to use the default Java home.

Returns:

This invocation request.

setProperties

public InvocationRequest setProperties(java.util.Properties properties)

Sets the system properties for the Maven invocation.

Parameters:

properties - The system properties for the Maven invocation, may be null if not set.

Returns:

This invocation request.

setGoals

public InvocationRequest setGoals(java.util.List goals)

Sets the goals for the Maven invocation.

Parameters:

goals - The goals for the Maven invocation, may be null to execute the POMs default goal.

Returns:

This invocation request.

setProfiles

public InvocationRequest setProfiles(java.util.List profiles)

Sets the profiles for the Maven invocation.

Parameters:

profiles - The profiles for the Maven invocation, may be null to use the default profiles.

Returns:

This invocation request.

setShellEnvironmentInherited

public InvocationRequest setShellEnvironmentInherited(boolean shellEnvironmentInherited)

Specifies whether the environment variables of the current process should be propagated to the Maven invocation.

Parameters:

shellEnvironmentInherited - true if the environment variables should be propagated, false otherwise.

Returns:

This invocation request.

setUserSettingsFile

public InvocationRequest setUserSettingsFile(java.io.File userSettings)

Sets the path to the user settings for the Maven invocation.

Parameters:

userSettings - The path to the user settings for the Maven invocation, may be null to load the user settings from the default location.

Returns:

This invocation request.

setGlobalChecksumPolicy

public InvocationRequest setGlobalChecksumPolicy(java.lang.String globalChecksumPolicy)

Sets the checksum mode of the Maven invocation.

Parameters:

globalChecksumPolicy - The checksum mode, must be one of CHECKSUM_POLICY_WARN and CHECKSUM_POLICY_FAIL.

Returns:

This invocation request.

setNonPluginUpdates

public InvocationRequest setNonPluginUpdates(boolean nonPluginUpdates)

Specifies whether Maven should check for plugin updates.

Parameters:

nonPluginUpdates - true if plugin updates should be suppressed, false otherwise.

Returns:

This invocation request.

setRecursive

public InvocationRequest setRecursive(boolean recursive)

Sets the recursion behavior of a reactor invocation.

Parameters:

recursive - true if sub modules should be build, false otherwise.

Returns:

This invocation request.

addShellEnvironment

public InvocationRequest addShellEnvironment(java.lang.String name,
                                             java.lang.String value)

Adds the specified environment variable to the Maven invocation.

Parameters:

name - The name of the environment variable, must not be null.

value - The value of the environment variable, must not be null.

Returns:

This invocation request.

setMavenOpts

public InvocationRequest setMavenOpts(java.lang.String mavenOpts)

Sets the value of the MAVEN_OPTS environment variable.

Parameters:

mavenOpts - The value of the MAVEN_OPTS environment variable, may be null to use the default options.

Returns:

This invocation request.

setShowVersion

public InvocationRequest setShowVersion(boolean showVersion)

enable displaying version without stopping the build (-V cli option)

Parameters:

showVersion - enable displaying version

Returns:

This invocation request.

Since:

2.0.11