Chapter 25. 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.

25.1. Usage

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

Example 25.1. Using the Jetty plugin

build.gradle

apply plugin: 'jetty'

The Jetty plugin defines the following tasks:

Table 25.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 25.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 25.2. Jetty plugin - properties

Property name	Type	Default value	Description
`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.