Chapter 28. The Jetty Plugin

The Jetty plugin extends the War plugin to add tasks which allow you to deploy your web application to a Jetty web container embedded in the build.

28.1. Usage

To use the Jetty plugin, include the following in your build script:

Example 28.1. Using the Jetty plugin

build.gradle

apply plugin: 'jetty'

The Jetty plugin defines the following tasks:

Table 28.1. Jetty plugin - tasks

Task name	Depends on	Type	Description
`jettyRun`	`compile`	`JettyRun`	Starts a Jetty instance and deploys the exploded web application to it.
`jettyRunWar`	`war`	`JettyRunWar`	Starts a Jetty instance and deploys the WAR to it.
`jettyStop`	-	`JettyStop`	Stops the Jetty instance.

Figure 28.1. Jetty plugin - tasks

The Jetty plugin uses the same layout as the War plugin.

The Jetty plugin does not define any dependency configurations.

The Jetty plugin defines the following convention properties:

Table 28.2. Jetty plugin - properties

Property name	Type	Default value	Description
`contextPath`	`String`	WAR file base name	The application deployment location within the Jetty container.
`httpPort`	`Integer`	`8080`	The TCP port which Jetty should listen for HTTP requests on.
`stopPort`	`Integer`	`null`	The TCP port which Jetty should listen for admin requests on.
`stopKey`	`String`	`null`	The key to pass to Jetty when requesting it to stop.

These properties are provided by a JettyPluginConvention convention object.