org.eclipse.jetty.maven.plugin

Class JettyRunMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.eclipse.jetty.maven.plugin.AbstractJettyMojo

org.cipango.plugin.AbstractCipangoMojo

org.eclipse.jetty.maven.plugin.JettyRunMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

Direct Known Subclasses:

JettyStartMojo

public class JettyRunMojo
extends AbstractCipangoMojo

This goal is used in-situ on a Maven project without first requiring that the project is assembled into a war, saving time during the development cycle. The plugin forks a parallel lifecycle to ensure that the "compile" phase has been completed before invoking Jetty. This means that you do not need to explicity execute a "mvn compile" first. It also means that a "mvn clean jetty:run" will ensure that a full fresh compile is done before invoking Jetty.

Once invoked, the plugin can be configured to run continuously, scanning for changes in the project and automatically performing a hot redeploy when necessary. This allows the developer to concentrate on coding changes to the project using their IDE of choice and have those changes immediately and transparently reflected in the running web container, eliminating development time that is wasted on rebuilding, reassembling and redeploying.

You may also specify the location of a jetty.xml file whose contents will be applied before any plugin configuration. This can be used, for example, to deploy a static webapp that is not part of your maven build.

There is a reference guide to the configuration parameters for this plugin, and more detailed information with examples in the Configuration Guide.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.io.File	classesDirectory The directory containing generated classes.
static java.lang.String	DEFAULT_WEBAPP_SRC
protected java.util.List<java.io.File>	extraScanTargets Extra scan targets as a list
static java.lang.String	FAKE_WEBAPP
protected ScanTargetPattern[]	scanTargetPatterns List of directories with ant-style <include> and <exclude> patterns for extra targets to periodically scan for changes.
protected java.io.File[]	scanTargets List of files or directories to additionally periodically scan for changes.
protected java.io.File	testClassesDirectory The directory containing generated test classes.
protected boolean	useTestScope If true, the <testOutputDirectory> and the dependencies of <scope>test<scope> will be put first on the runtime classpath.
protected java.util.List<org.apache.maven.artifact.Artifact>	warArtifacts List of deps that are wars
protected WarPluginInfo	warPluginInfo maven-war-plugin reference
protected java.io.File	webAppSourceDirectory Root directory for all html/jsp etc files
protected java.lang.String	webXml The default location of the web.xml file.

Fields inherited from class org.cipango.plugin.AbstractCipangoMojo

addDefaultConnectors, annotationsEnabled, extraConfigurationClasses, SIP_HOST_PROPERTY, SIP_PORT_PROPERTY, sipApp, sipDefaultXml

Fields inherited from class org.eclipse.jetty.maven.plugin.AbstractJettyMojo

consoleScanner, contextHandlers, contextXml, daemon, dumpOnStart, excludedGoals, execution, httpConnector, jettyXml, loginServices, pluginArtifacts, PORT_SYSPROPERTY, project, projectArtifacts, reload, requestLog, scanIntervalSeconds, scanList, scanner, scannerListeners, server, skip, stopKey, stopPort, systemProperties, systemPropertiesFile, useProvidedScope, webApp

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
JettyRunMojo()

Method Summary

Modifier and Type	Method and Description
void	checkPomConfiguration() Verify the configuration given in the pom.
void	configureScanner()
void	configureWebApplication() Subclasses should invoke this to setup basic info on the webapp
void	execute()
protected org.apache.maven.artifact.Artifact	getArtifactForOverlay(OverlayConfig o, java.util.List<org.apache.maven.artifact.Artifact> warArtifacts)
void	restartWebApp(boolean reconfigureScanner)

Methods inherited from class org.cipango.plugin.AbstractCipangoMojo

applyJettyXml, finishConfigurationBeforeStart

Methods inherited from class org.eclipse.jetty.maven.plugin.AbstractJettyMojo

configurePluginClasspath, findJettyWebXmlFile, getJettyXmlFiles, isExcluded, isPluginArtifact, setSystemProperties, setSystemPropertiesFile, startConsoleScanner, startJetty

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_WEBAPP_SRC

public static final java.lang.String DEFAULT_WEBAPP_SRC

FAKE_WEBAPP

public static final java.lang.String FAKE_WEBAPP

See Also:

Constant Field Values

useTestScope

protected boolean useTestScope

If true, the <testOutputDirectory> and the dependencies of <scope>test<scope> will be put first on the runtime classpath.

webXml

protected java.lang.String webXml

The default location of the web.xml file. Will be used if <webApp><descriptor> is not set.

classesDirectory

protected java.io.File classesDirectory

The directory containing generated classes.

testClassesDirectory

protected java.io.File testClassesDirectory

The directory containing generated test classes.

webAppSourceDirectory

protected java.io.File webAppSourceDirectory

Root directory for all html/jsp etc files

scanTargets

protected java.io.File[] scanTargets

List of files or directories to additionally periodically scan for changes. Optional.

scanTargetPatterns

protected ScanTargetPattern[] scanTargetPatterns

List of directories with ant-style <include> and <exclude> patterns for extra targets to periodically scan for changes. Can be used instead of, or in conjunction with <scanTargets>.Optional.

extraScanTargets

protected java.util.List<java.io.File> extraScanTargets

Extra scan targets as a list

warPluginInfo

protected WarPluginInfo warPluginInfo

maven-war-plugin reference

warArtifacts

protected java.util.List<org.apache.maven.artifact.Artifact> warArtifacts

List of deps that are wars

Constructor Detail

JettyRunMojo

public JettyRunMojo()

Method Detail

execute

public void execute()
             throws org.apache.maven.plugin.MojoExecutionException,
                    org.apache.maven.plugin.MojoFailureException

Specified by:

execute in interface org.apache.maven.plugin.Mojo

Overrides:

execute in class AbstractCipangoMojo

Throws:

org.apache.maven.plugin.MojoExecutionException

org.apache.maven.plugin.MojoFailureException

See Also:

AbstractJettyMojo.execute()

checkPomConfiguration

public void checkPomConfiguration()
                           throws org.apache.maven.plugin.MojoExecutionException

Verify the configuration given in the pom.

Specified by:

checkPomConfiguration in class AbstractJettyMojo

Throws:

org.apache.maven.plugin.MojoExecutionException

See Also:

AbstractJettyMojo.checkPomConfiguration()

configureWebApplication

public void configureWebApplication()
                             throws java.lang.Exception

Description copied from class: AbstractJettyMojo

Subclasses should invoke this to setup basic info on the webapp

Overrides:

configureWebApplication in class AbstractCipangoMojo

Throws:

org.apache.maven.plugin.MojoExecutionException

java.lang.Exception

See Also:

AbstractJettyMojo.configureWebApplication()

configureScanner

public void configureScanner()
                      throws org.apache.maven.plugin.MojoExecutionException

Specified by:

configureScanner in class AbstractJettyMojo

Throws:

org.apache.maven.plugin.MojoExecutionException

See Also:

AbstractJettyMojo.configureScanner()

restartWebApp

public void restartWebApp(boolean reconfigureScanner)
                   throws java.lang.Exception

Specified by:

restartWebApp in class AbstractJettyMojo

Throws:

java.lang.Exception

See Also:

AbstractJettyMojo.restartWebApp(boolean)

getArtifactForOverlay

protected org.apache.maven.artifact.Artifact getArtifactForOverlay(OverlayConfig o,
                                                                   java.util.List<org.apache.maven.artifact.Artifact> warArtifacts)

Parameters:

o -

warArtifacts -

Returns: