第二十八章. Jetty 插件

Chapter 28. The Jetty Plugin

Jetty 插件扩展自 War 插件，并添加了一些任务，这些任务可以让你在构建时部署你的 web 应用程序到一个嵌入的 Jetty web 容器中。
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. 用法

28.1. Usage

要使用 Jetty 的插件，请在构建脚本中包含以下内容：
To use the Jetty plugin, include in your build script:

示例 28.1. 使用 Jetty 插件 - Example 28.1. Using the Jetty plugin

build.gradle

apply plugin: 'jetty'

28.2. 任务

28.2. Tasks

Jetty 插件定义了以下任务：
The Jetty plugin defines the following tasks:

表 28.1. Jetty 插件——任务 - Table 28.1. Jetty plugin - tasks

任务名称 Task name	依赖于 Depends on	类型 Type	描述 Description
`jettyRun`	`compile`	`JettyRun`	启动 Jetty 实例并部署上 exploded web 应用程序。 Starts a Jetty instance and deploys the exploded web application to it.
`jettyRunWar`	`war`	`JettyRunWar`	启动 Jetty 实例并部署上 WAR 包。 Starts a Jetty instance and deploys the WAR to it.
`jettyStop`	-	`JettyStop`	停止 Jetty 实例。 Stops the Jetty instance.

图 28.1. Jetty 插件——任务 - Figure 28.1. Jetty plugin - tasks

28.3. 项目布局

28.3. Project layout

Jetty 插件使用和 War 插件相同的布局。
The Jetty plugin uses the same layout as the War plugin.

28.4. 依赖管理

28.4. Dependency management

Jetty 插件不定义任何依赖配置。
The Jetty plugin does not define any dependency configurations.

28.5. 公约属性

28.5. Convention properties

Jetty 插件定义了以下公约属性：
The Jetty plugin defines the following convention properties:

表 28.2. Jetty 插件——属性 - Table 28.2. Jetty plugin - properties

属性名称 Property name	类型 Type	默认值 Default value	描述 Description
`contextPath`	`String`	WAR 文件的基本名称 WAR file base name	Jetty 容器中的应用程序部署位置。 The application deployment location within the Jetty container.
`httpPort`	`Integer`	`8080`	Jetty 应监听的 HTTP 请求的 TCP 端口。 The TCP port which Jetty should listen for HTTP requests on.
`stopPort`	`Integer`	`null`	Jetty 应监听的管理请求的 TCP 端口。 The TCP port which Jetty should listen for admin requests on.
`stopKey`	`String`	`null`	当请求 Jetty 停止时，传递给它的 key。 The key to pass to Jetty when requesting it to stop.

这些属性都由一个 JettyPluginConvention 公约对象提供。
These properties are provided by a JettyPluginConvention convention object.