Jetty使用教程（一）——开始使用Jetty

时间  2020-08-21 标签 jetty 使用 教程 开始

1、Jetty简介

1.1 什么是Jetty

　　Jetty是一个提供HHTP服务器、HTTP客户端和javax.servlet容器的开源项目。
 
　　这个入门教程分为五个部分：
  • 第一部分部分重点介绍如何使用Jetty，它提供以下信息，如什么是Jetty，从哪能够下载它，怎么在像Maven同样的仓库中找到它。这一部分一样会提供启动Jetty和如何配置Jetty的快速入门。
  • 第二部分从更细致的方面介绍Jetty的配置，介绍怎么用Jetty来部署一个web应用程序，怎么配置容器和链接，以及如何实现SSL和其它安全措施。
  • Jetty的管理员应该关注第三部分。从启动Jetty容器开始到session管理，日志记录，HTTP/2支持和Jetty优化，这一章节将帮助Jetty管理员得到更多关于Jetty服务之外的知识，这一章节一样包含容器最经常使用的特性配置如JNDI和JMX。
  • 针对使用Jetty的高级用户，第四部分着重于Jetty的开发，本章节的重点是如何将Jetty嵌入一个已经存在的应用程序中。这部分包含几个简单的例子和操做Jetty框架的指南。这一部分一样包含如何使用Jetty的maven插件以及Jetty调试。
  • 最后一个部分是引用部分，也包含Jetty的架构信息，Jetty的XML语法介绍，以及常见问题的解析，这章也介绍如何参与Jetty社区，如何贡献代码，以及如何寻求帮助。

1.2 如何选择Jetty的版本

　　Jetty9是Jetty的最近一个版本且比以前的版本有很大的改进，其中一个改进是Jetty全部特性已经体如今Jetty9的文档里。因此对于不少使用Jetty老版本的用户，咱们建议使用Jetty9，咱们也表示将会在接下来的几年里积极维护这一个版本。
 
表格1.1Jetty版本
版本 Year Home JVM 协议 Servlet JSP 状态

9.3php

2015html

Eclipsejava

1.8web

HTTP/1.1 (RFC 7230), HTTP/2 (RFC 7540), redis

WebSocket (RFC 6455, JSR 356), FastCGIspring

3.1shell

2.3数据库

 稳定版本

9.2apache

2014数组

Eclipse

1.7

HTTP/1.1 RFC2616, javax.websocket, SPDY v3

3.1

2.3

稳定版本

8

2009-

Eclipse/Codehaus

1.6

HTTP/1.1 RFC2616, WebSocket RFC 6455, SPDY v3

3.0

2.2

珍贵版本

7

2008-

Eclipse/Codehaus

1.5

HTTP/1.1 RFC2616, WebSocket RFC 6455, SPDY v3

2.5

2.1

珍贵版本

6

2006-2010

Codehaus

1.4-1.5

HTTP/1.1 RFC2616

2.5

2.0

已经做废

5

2003-2009

Sourceforge

1.2-1.5

HTTP/1.1 RFC2616

2.4

2.0

已经做废

4

2001-2006

Sourceforge

1.2, J2ME

HTTP/1.1 RFC2616

2.3

1.2

远古时期

3

1999-2002

Sourceforge

1.2

HTTP/1.1 RFC2068

2.2

1.1

石器时代

2

1998-2000

Mortbay

1.1

HTTP/1.0 RFC1945

2.1

1.0

传说级别

1

1995-1998

Mortbay

1.0

HTTP/1.0 RFC1945

-

-

神话级别

1.3 Jetty 和Java EE Web规范

　　Jetty实现的Java EE规范主要是Servlet规范，最新的Java EE平台介绍了一个新的Web 规范，建议开发者只须要大部分技术中的一部分便可。然而Jetty没有实现Web 规范中全部的技术，Jetty设计为一个容器，可使用插件自由扩展想要的功能。

1.3.1 Java EE 7 Web规范

　　在Java EE7的规范中，更新了一些重要的功能以及添加了一些新的：
 
表格1.2 JavaEE7 Web Profile
JSR 名称 jetty-9.1.x是否包含 支持插件

JSR 340

Servlet Specification API 3.1

Yes

  

JSR 344

Java Server Faces 2.2 (JSF)

No

Yes, Mojarra or MyFaces

JSR 245 / JSR 341

Java Server Pages 2.3/Java Expression Language 3.0 (JSP/EL)

Yes

Yes

JSR 52

Java Standard Tag Library 1.2 (JSTL)

Yes

Yes

JSR 45

Debugging Support for Other Languages 1.0

Yes (via JSP)

Yes (via JSP)

JSR 346

Contexts and Dependency Injection for the 

JavaEE Platform 1.1 (Web Beans)

No

Yes, Weld

JSR 330

Dependency Injection for Java 1.0

No

Yes as part of a CDI implementation, Weld

JSR 316

Managed Beans 1.0

No

Yes, as part of another technology

JSR 345

Enterprise JavaBeans 3.2 Lite

No

  

JSR 338

Java Persistance 2.1 (JPA)

No

Yes, eg Hibernate

JSR 250

Common Annotations for the Java Platform 1.2

Yes

Partially (for non-core Servlet Spec annotations)

JSR 907

Java Transaction API 1.2 (JTA)

Yes

Yes

JSR 349

Bean Validation 1.1

No

Yes as part of another technology eg JSF, or 

a stand-alone implementation such as Hiberate Validator

JSR 339

Java API for RESTful Web Services 2.0 (JAX-RS)

No

  

JSR 356

Java API for Websocket 1.0

Yes

No

JSR 353

Java API for JSON Processing 1.0 (JSON-P)

No

Yes, eg JSON-P reference implementation

JSR 318

Interceptors 1.2

No

Yes as part of a CDI implementation

1.3.2 Jetty EE 6 Web Profile

　　下面介绍JavaEE6 Web Profile，以及与Jetty的关系

表格 1.3. Java EE 6 Web Profile

JSR Name Included with jetty-9.0.x Pluggable

JSR 315

Servlet Specification API 3.0

Yes

  

JSR 314

JavaServer Faces 2.0 (JSF)

No

Yes, for example, Mojarra or MyFaces

JSR 245

JavaServer Pages 2.2/Java Expression

Language 2.2 (JSP/EL)

Yes

Yes

JSR 52

Java Standard Tag Library 1.2 (JSTL)

Yes

Yes

JSR 45

Debugging Support for Other Languages 1.0

Yes (via JSP)

Yes (via JSP)

JSR 299

Contexts and Dependency Injection for

the Java EE Platform 1.0 (Web Beans)

No

Yes, Weld or OpenWebBeans

JSR 330

Dependency Injection for Java 1.0

No

Yes as part of a CDI implementation, Weld

JSR 316

Managed Beans 1.0

No

Yes, as part of another technology.

JSR 318

Enterprise JavaBeans 3.1

No

Yes, OpenEJB

JSR 317

Java Persistance 2.0 (JPA)

No

Yes, Hibernate

JSR 250

Common Annotations for the Java Platform

Yes

Partially (for non-core Servlet Spec annotations)

JSR 907

Java Transaction API (JTA)

Yes

Implementations are pluggable, such as Atomikos, JOTM, 

Jencks (Geronimo Transaction Manager)

JSR 303

Bean Validation 1.0

No

Yes as part of another technology (JSF), or a stand-alone 

implementation such as Hiberate Validator

1.4 在Maven中获取Jetty

1.4.1 Maven坐标

　　Jetty从一开始就已经存在于Maven中心了，因此Maven的坐标在最近几年也发生了变化，当Jetty基于SourceForge管理时Maven的groupId是org.mortbay.jetty，当Jetty 7来到eclipse后groupId也改变了。
Jetty的POM坐标以下 
<dependency>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-project</artifactId>
  <version>${project.version}</version>
</dependency>

 1.4.2 在Maven中心的更新日志

　　Jetty不一样版本的更新日志记录在一个叫作VERSIONS.txt的文件中，也能够在Maven中心找到，坐标以下 
<dependency>
  <groupId>org.eclipse.jetty</groupId>
  <artifactId>jetty-project</artifactId>
  <version>${project.version}</version>
  <classifier>version</classifier>
  <type>txt</type>
</dependency>

 2、Jetty的使用

　　你能够经过多种方式将Jetty植入使用的程序中，在不一样的系统中使用它，或者作为一个独立的服务器来使用，这一节介绍了后者，即做为一个单独的服务器来部署web应用。

2.1 下载Jetty

2.1.1 下载Jetty项目

　　Jetty的下载网页为：https://www.eclipse.org/jetty/download.html
　　若是jdk环境支持尽可能使用最新版本，将下载后的解压放在使用的位置，之后章节将使用JETTY_HOME或者 $(jetty.home)来表明Jetty的存放路径。

2.1.2 Jetty工程简介

　　Jetty全部顶级目录简介：

表格 2.1. Contents

Location Description

license-eplv10-aslv20.html

Jetty的许可文件

README.txt

有用的开始信息

VERSION.txt

版本信息

bin/

存放在Unix系统下运行的shell脚本

demo-base/

一个可运行包含示例web应用的Jetty服务器基目录

etc/

Jetty的配置文件

lib/

Jetty运行所必须的jar文件

logs/

日志

modules/

各个模块

notice.html

许可信息等

resources/

包含新增到classpath配置文件夹，如log4j.properties

start.ini

存放启动信息

start.jar

运行Jetty的jar

webapps/

一个用来存放运行在默认配置下的Jetty Web应用目录

2.2 运行Jetty

　　执行如下代码，Jetty会在默认8080端口运行 
cd $JETTY_HOME
java -jar start.jar

 　　若执行成功会输出如下信息

2015-06-04 10:50:44.806:INFO::main: Logging initialized @334ms
2015-06-04 10:50:44.858:WARN:oejs.HomeBaseWarning:main: This instance of Jetty is not running from a separate {jetty.base} directory, this is not recommended. See documentation at http://www.eclipse.org/jetty/documentation/current/startup.html
2015-06-04 10:50:44.995:INFO:oejs.Server:main: jetty-9.3.0.v20150601
2015-06-04 10:50:45.012:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:///opt/jetty-distribution-9.3.0.v20150601/webapps/] at interval 1
2015-06-04 10:50:45.030:INFO:oejs.ServerConnector:main: Started ServerConnector@19dfb72a{HTTP/1.1,[http/1.1]}{0.0.0.0:8080}
2015-06-04 10:50:45.030:INFO:oejs.Server:main: Started @558ms

　　你能够经过浏览器访问http://localhost:8080.。然而在$JETTY_HOME/webapps目录下并无部署任何web应用，因此你将会看到一个Jetty提供的404错误页面，并不推荐在$JETTY_HOME下运行Jetty，而是建议运行一个Jetty基础应用。错误页面以下

2.2.1 基础应用例子

　　标准的Jetty应用，有一个demo-base的文件夹，能够不在$JETTY_HOME下运行Jetty，在demo-base文件夹下执行如下命令： 
> cd $JETTY_HOME/demo-base/
> java -jar $JETTY_HOME/start.jar

　　成功运行将有以下信息输出：

2015-06-04 10:55:24.161:INFO::main: Logging initialized @308ms
2015-06-04 10:55:24.431:WARN::main: demo test-realm is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 10:55:24.434:INFO:oejs.Server:main: jetty-9.3.0.v20150601
2015-06-04 10:55:24.457:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/webapps/] at interval 1
2015-06-04 10:55:24.826:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@c038203{/,file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/webapps/ROOT/,AVAILABLE}{/ROOT}
2015-06-04 10:55:24.929:WARN::main: test-jaas webapp is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 10:55:24.978:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@46238e3f{/test-jaas,file:///tmp/jetty-0.0.0.0-8080-test-jaas.war-_test-jaas-any-9105214562680121772.dir/webapp/,AVAILABLE}{/test-jaas.war}
2015-06-04 10:55:25.162:WARN::main: async-rest webapp is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 10:55:25.208:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@6b67034{/async-rest,[file:///tmp/jetty-0.0.0.0-8080-async-rest.war-_async-rest-any-1023939491558622183.dir/webapp/, jar:file:///tmp/jetty-0.0.0.0-8080-async-rest.war-_async-rest-any-1023939491558622183.dir/webapp/WEB-INF/lib/example-async-rest-jar-9.3.0.v20150601.jar!/META-INF/resources],AVAILABLE}{/async-rest.war}
2015-06-04 10:55:25.311:WARN::main: test-jndi webapp is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 10:55:25.386:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@8b96fde{/test-jndi,file:///tmp/jetty-0.0.0.0-8080-test-jndi.war-_test-jndi-any-1692053319754270133.dir/webapp/,AVAILABLE}{/test-jndi.war}
2015-06-04 10:55:25.508:WARN::main: test-spec webapp is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 10:55:25.594:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@69930714{/test-spec,[file:///tmp/jetty-0.0.0.0-8080-test-spec.war-_test-spec-any-5518740932795802823.dir/webapp/, jar:file:///tmp/jetty-0.0.0.0-8080-test-spec.war-_test-spec-any-5518740932795802823.dir/webapp/WEB-INF/lib/test-web-fragment-9.3.0.v20150601.jar!/META-INF/resources],AVAILABLE}{/test-spec.war}
2015-06-04 10:55:25.781:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@3eb7fc54{/proxy,file:///tmp/jetty-0.0.0.0-8080-xref-proxy.war-_xref-proxy-any-3068657547009829038.dir/webapp/,AVAILABLE}{/xref-proxy.war}
2015-06-04 10:55:25.786:INFO:oejsh.ContextHandler:main: Started o.e.j.s.h.MovedContextHandler@59662a0b{/oldContextPath,null,AVAILABLE}
2015-06-04 10:55:25.951:WARN::main: test webapp is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 10:55:26.248:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@4f83df68{/test,file:///tmp/jetty-0.0.0.0-8080-test.war-_test-any-5238659347611323540.dir/webapp/,AVAILABLE}{/test.war}
2015-06-04 10:55:26.255:INFO:oejs.ServerConnector:main: Started ServerConnector@5a9c4ad9{HTTP/1.1,[http/1.1]}{0.0.0.0:8080}
2015-06-04 10:55:26.259:INFO:oejus.SslContextFactory:main: x509={jetty.eclipse.org=jetty} wild={} alias=null for SslContextFactory@23941fb4(file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/etc/keystore,file:///opt/jetty-distribution-9.3.0.v20150601/demo-base/etc/keystore)
2015-06-04 10:55:26.269:INFO:oejs.ServerConnector:main: Started ServerConnector@5d908d47{SSL,[ssl, http/1.1]}{0.0.0.0:8443}
2015-06-04 10:55:26.270:INFO:oejs.Server:main: Started @2417ms

　　如今能够经过浏览器访问 http://localhost:8080，  此时能够看到一个Jetty的欢迎页面，页面上包含几个简单的例子，欢迎页面以下

警告

示例的web应用程序不必定是绝对安全的，因此不该该部署在生产环境上。

　　你能够经过如下命令查看示例应用的配置信息 

> cd $JETTY_HOME/demo-base/
> java -jar $JETTY_HOME/start.jar --list-modules
...
 
> java -jar %JETTY_HOME/start.jar --list-config
...

--list-modules：此命令将返回当前服务全部可用的模块，同时也会显示本地的模块，信息包括模块实现的顺序，依赖模块以及相应的jar信息

--list-config：显示运行环境和配置文件等信息 

2.2.2 建立一个新的Jetty基目录

　　demo-base目录是jetty.base的一个基目录，在Jetty9.1版本中新增长的。一个Jetty基目录容许配置和web应用分开部署，能够方便升级系统。Jetty默认的配置基于两个属性：
jetty.home：这个属性定义了Jetty的路径，jar包，默认模块和默认xml配置（典型有 start.jar，lib等）
jetty.base：这个属性表示一个特殊Jetty服务应用的路径，包括它的日志，配置和web应用（典型有 start.ini，start.d，logs和webapps）
　　如下命令用于建立一个新的根路径，同时激活HTTP connector和web 应用部署模块，而且拷贝一个web应用例子来部署。 
> JETTY_BASE=/tmp/mybase
> mkdir $JETTY_BASE
> cd $JETTY_BASE
> java -jar $JETTY_HOME/start.jar
 
WARNING: Nothing to start, exiting ...
 
Usage: java -jar start.jar [options] [properties] [configs]
java -jar start.jar --help # for more information
 
> java -jar $JETTY_HOME/start.jar --add-to-startd=http,deploy
 
INFO: server initialised (transitively) in ${jetty.base}/start.d/server.ini
INFO: http initialised in ${jetty.base}/start.d/http.ini
INFO: security initialised (transitively) in ${jetty.base}/start.d/security.ini
INFO: servlet initialised (transitively) in ${jetty.base}/start.d/servlet.ini
INFO: webapp initialised (transitively) in ${jetty.base}/start.d/webapp.ini
INFO: deploy initialised in ${jetty.base}/start.d/deploy.ini
MKDIR: ${jetty.base}/webapps
INFO: Base directory was modified
 
> cp $JETTY_HOME/demo-base/webapps/async-rest.war webapps/ROOT.war
> java -jar $JETTY_HOME/start.jar
 
2015-06-04 11:10:16.286:INFO::main: Logging initialized @274ms
2015-06-04 11:10:16.440:INFO:oejs.Server:main: jetty-9.3.0.v20150601
2015-06-04 11:10:16.460:INFO:oejdp.ScanningAppProvider:main: Deployment monitor [file:///tmp/mybase/webapps/] at interval 1
2015-06-04 11:10:16.581:WARN::main: async-rest webapp is deployed. DO NOT USE IN PRODUCTION!
2015-06-04 11:10:16.589:INFO:oejw.StandardDescriptorProcessor:main: NO JSP Support for /, did not find org.eclipse.jetty.jsp.JettyJspServlet
2015-06-04 11:10:16.628:INFO:oejsh.ContextHandler:main: Started o.e.j.w.WebAppContext@1a407d53{/,[file:///tmp/jetty-0.0.0.0-8080-ROOT.war-_-any-4510228025526425427.dir/webapp/, jar:file:///tmp/jetty-0.0.0.0-8080-ROOT.war-_-any-4510228025526425427.dir/webapp/WEB-INF/lib/example-async-rest-jar-9.3.0.v20150601.jar!/META-INF/resources],AVAILABLE}{/ROOT.war}
2015-06-04 11:10:16.645:INFO:oejs.ServerConnector:main: Started ServerConnector@3abbfa04{HTTP/1.1,[http/1.1]}{0.0.0.0:8080}
2015-06-04 11:10:16.646:INFO:oejs.Server:main: Started @634ms

　　以上命令是Linux下的命令，简单解释：建立一个JETTY_BASE环境变量，并建立指定的文件夹，在此文件夹下运行start.jar时提示没有能够启动的东西，系统退出，此时输入java -jar $JETTY_HOME/start.jar --add-to-startd=http,deploy命令为当前基目录添加标准文件及文件夹，而后java -jar $JETTY_HOME/start.jar运行便可运行成功。在Windows下操做以下：

（1）能够手动建立一个空的文件夹，本例使用D:\temp\jetty
（2）在CMD中定位到当前目录下，输入java -jar D:\data\frame\jetty-distribution-9.3.11.v20160721\start.jar （注：D:\data\frame\jetty-distribution-9.3.11.v20160721目录为个人电脑Jetty目录，请输入本机Jetty目录）输出信息以下：
 

（3）输出结果同Linux，再次输入java -jar D:\data\frame\jetty-distribution-9.3.11.v20160721\start.jar --add-to-startd=http,deploy，输出信息以下：

（4）提示信息中说明建立了哪些文件，已经基目录被修改等信息，此时到新建的基目录下能够看到以下新增的东西：
jetty
    |-start.d
        |-deploy.ini
        |-http.ini
        |-server.ini
    |-webapps
（5）启动后，会一样看到404页面，也可同上面的方法，拷贝ROOT项目到当前基目录的webapps下

2.2.3 改变Jetty的端口

　　经过在启动命令中设置jetty.http.port属性的值，可让Jetty运行在修改后的端口上。 
> cd $JETTY_BASE
> java -jar $JETTY_HOME/start.jar jetty.http.port=8081
...

　　另外，能够将要设置的端口属性添加到start.ini或者start.d/http.ini文件中。默认状况，在start.d/http.ini文件中定义的jetty.http.port属性能够被修改为另外一个值。

提示

配置属性信息经过以下方式得到

  • 首先去start.d/http.ini文件中找jetty.http.port=8080配置信息，若找到配置端口即为指定端口
  • 根据模块modules/http.mod文件找到指定配置默认为etc/jetty-http.xml，在此配置文件中有jetty.http.port配置信息，若找到即为此端口配置
  • 若上面两个都没有，则随机一个没有使用的端口

2.2.4 为HTTPS & HTTP2增长SSL

　　可经过以下命令，添加并激活HTTPS和HTTP2模块 
> java -jar $JETTY_HOME/start.jar --add-to-startd=https,http2
[...]
 
> java -jar $JETTY_HOME/start.jar
[...]
 
2015-06-04 13:52:01.933:INFO:oejs.ServerConnector:main: Started ServerConnector@6f1fba17{SSL,[ssl, alpn, h2, http/1.1]}{0.0.0.0:8443}
[...]

 --add-to-startd：此命令在ini文件中设置有效的配置信息，使HTTPS和HTTP2支持SSL链接

　　输入java -jar $JETTY_HOME/start.jar --add-to-startd=https,http2命令后会提示下载一些jar包，输入y按回车，最终提示信息以下，说明操做成功：

2.2.5 修改Jetty的HTTPS端口

　　你能够经过增长jetty.ssl.port启动参数来修改HTTPS的端口信息 
> cd $JETTY_BASE
> java -jar $JETTY_HOME/start.jar jetty.ssl.port=8444

　　除了在命令行增长参数的方法外，还能够在start.ini和start.d/*.ini文件中进行配置，因此若是用户使用--add-to-startd命令来使HTTPS生效，一样也能够在start.d/https.ini文件中进行修改。

2.2.6 更多的start.jar操做选项

　　start.jar的工做是用来翻译命令行内容的，start.ini和start.d目录（包含其中的*.ini文件）生成一个classpath环境，各类属性和配置可使用Jetty相应的xml进行配置，更多的使用方法能够经过使用命令来得到帮助。 
> java -jar $JETTY_HOME/start.jar --help

2.3 部署Web应用

　　Jetty支持热部署，能够自动部署webapps目录下的项目。标准的war文件和Jetty配置文件放置在webapps目录下，经过如下规则进行热部署
  • 例如一个包含 WEB-INF/ 子文件夹的example/文件夹作为一个标准的web应用进行部署，不然就按静态资源部署，context路径为/example（访问路径： http://localhost:8080/example/）；若文件夹名字为ROOT，则访问路径为/；若文件夹名字末尾为.d则此文件夹被忽略（除非被特殊的配置文件引用）
  • 若一个文件example.war被部署在webapps下，则context路径为example/，若是名字为ROOT则访问路径为/，若是example.war文件和example/文件夹同时存在，只有war文件会被部署（这个文件会被当作一个没有被解压的目录来使用）
  • 一个像example.xml的配置文件，若文件中是标准的配置信息，也会被部署，文件中必须包含context path，若是context path和example.xml同时存在，只有example.xml会被部署。
　　若是你有一个标准的web应用，能够直接将其拷贝到webapps文件夹下进行热部署。

2.3.1 Jetty示例Web Application

　　demo-base/webapps文件下的项目包含以下部署和附加的的文件：
 
ROOT/：这个文件夹包含各类静态资源。包含Jetty欢迎页面，默认访问路径为/
test.d：一个包含附加配置文件的文件夹，被test.xml使用用来为test.war增长额外的配置
test.xml：一个context配置文件，用来配置和部署test.war，包含上下文环境和test.d里面的配置附加的配置信息
test.war：在test.xml里面配置的示例web程序
async-rest.war：一个异步示例的web应用程序
test-jaas.war：一个使用JAAS身份验证的web应用程序。
test-jaas.xml：用来配置test-jaas.war的配置文件
test-jndi.war：一个使用JNDI的示例应用
test-jndi.xml：用来配置test-jndi.war的配置文件
test-spec.war：一个使用注解，ServletContainerInitializers 和Servlet 3.0/3.1规范的示例应用
test-spec.xml：用来配置test-spec.war的配置文件
xref-proxy.war：使用代理的一个示例应用
example-moved.xml：一个演示MovedContextHandler重定向使用的示例应用

3、Jetty配置信息介绍

3.1如何配置jetty

3.1.1 Jetty POJO 配置

　　Jetty的核心组件是POJO（Plain Old Java Objects），配置Jetty的过程就是实例化一个Jetty POJOs并对其进行配置的过程，能够经过以下实现：
  • 编写Java代码来直接实例化并配置Jetty对象，这称为嵌入式Jetty。
  • 使用Jetty的xml配置文件，这是一个控制反转框架模式，从xml文件中实例化Jetty对象。 etc/jetty.xml配置文件是Jetty的主要配置文件，可是也有不少etc/jetty-__feature__.xml类型的文件被Jetty使用
  • 使用第三方IOC框架，如Spring来实例化Jetty对象作为一个Spring Beans
　　由于配置Jetty的主要方法是IoC，因此这个文档主要介绍此种方法。

3.1.2 Jetty启动配置文件

　　Jetty使用以下配置文件来实例和启动一个服务，经过start.jar处理
ini files：
Jetty启动原理使用命令行，使用$JETTY_BASE/start.ini和$JETTY_BASE/start.d/*.ini文件来建立一个有效的命令参数参数以下：
  • 激活的模块  --module=name
  • 经过name=value的来为Jetty的IOC配置属性
  • XML files in Jetty IoC (or Spring) XML format
  • 一个标准的Java属性文件包含额外的启动属性
  • 其余start.jar选项(see java -jar start.jar --help)
  • 一些JVM参数组合经过--exec，例如-Xbootclasspath.

提示

在Jetty9，只有Jetty基路径下的配置文件被编辑，属性才会被修改

mod files：
$JETTY_HOME/modules/*.mod文件包含各个模块的定义，能够被--module=name命令激活，每一个mod文件定义：
  • 模块依赖如何排序以及激活
  • 被模块须要而且要就在到classpath的jar包
  • 被模块须要而且内容会被执行的xml文件
  • 被激活模块须要的文件
  • 一个示例的ini文件，当被-add-to-start=name选项激活时使用

Note

常见典型的模块配置信息通长不多被改动，*.mod文件一般位于$JETTY_HOME/modules/文件夹下，可是额外增长的或者编辑过的一般放在 $JETTY_BASE/module下，若是一个模块须要被修改，最好的作法是在修改前从$JETTY_HOME/modules/拷贝*.mod到 $JETTY_BASE/modules/

XML files：　　

xml文件通常用与IoC以及spring使用，用在命令行或者模块定义中。xml文件里面的配置将被注入到描述服务的一个对象里。一般改变属性的方法是改变对应的ini文件。xml文件一般放在$JETTY_HOME/etc/下，可是新增的或者被编辑的xml应该被放在 $JETTY_BASE/etc/下，若是xml配置文件有修改的必要，最好的作法是在修改前将xml文件从$JETTY_HOME/etc拷贝到$JETTY_BASE/etc/ 。
下图是各类配置文件（ini, mod 和 XML）的关系

3.1.3 其它配置文件

　　除了上面描述的配置文件之外，服务的配置信息可使用以下的文件：
Context XML files：
　　全部在/webapps目录下用来被IoC使用的xml文件，用来部署相应的模块，注入信息到HttpContext ，最终建立一个容器。这些多是标准的web应用程序或定制上下文建立的特殊目的的处理器。
web.xml：
　　web.xml用来定义和配置过滤器，servlet或者资源。Jetty WebAppContext组件使用这个XML文件用来：
  • 设置一个web项目的默认的根路径
  • 经过WEB-INF/web.xml进行特殊的配置
  • Interpret descriptor fragments included in the META-INF directory of Jar files within WEB-INF/lib.

Note

一般web应用的web.xml文件应该在WEB-INF/web.xml位置被发现，Jetty还支持多个web.xml，能够在 WEB-INF/web.xml文件加载前或者加载后加载（使用方法见test.xml）

Property Files：
　　标准的Java配置文件，一样适用于Jetty配置：
  • 能够为Jetty IoC增长参数
  • 配置默认日志信息（StdErrLog），其余日志框架也能够经过配置被使用（例如，log4j）
  • 数据库的登陆配置信息等 

3.1.4 Jetty IoC XML使用

　　为了理解Jetty IOC XML使用方法，以下面的示例Java中，嵌入式Jetty服务器实例并配置 
//
//  ========================================================================
//  Copyright (c) 1995-2016 Mort Bay Consulting Pty. Ltd.
//  ------------------------------------------------------------------------
//  All rights reserved. This program and the accompanying materials
//  are made available under the terms of the Eclipse Public License v1.0
//  and Apache License v2.0 which accompanies this distribution.
//
//      The Eclipse Public License is available at
//      http://www.eclipse.org/legal/epl-v10.html
//
//      The Apache License v2.0 is available at
//      http://www.opensource.org/licenses/apache2.0.php
//
//  You may elect to redistribute this code under either of these licenses.
//  ========================================================================
//
package org.eclipse.jetty.embedded;
import org.eclipse.jetty.server.Connector;
import org.eclipse.jetty.server.Handler;
import org.eclipse.jetty.server.Server;
import org.eclipse.jetty.server.ServerConnector;
import org.eclipse.jetty.server.handler.DefaultHandler;
import org.eclipse.jetty.server.handler.HandlerCollection;
import org.eclipse.jetty.servlet.ServletContextHandler;
public class ExampleServer
{
    public static void main( String[] args ) throws Exception
    {
        Server server = new Server();
        ServerConnector connector = new ServerConnector(server);
        connector.setPort(8080);
        server.setConnectors(new Connector[] { connector });
        ServletContextHandler context = new ServletContextHandler();
        context.setContextPath("/");
        context.addServlet(HelloServlet.class, "/hello");
        context.addServlet(AsyncEchoServlet.class, "/echo/*");
        HandlerCollection handlers = new HandlerCollection();
        handlers.setHandlers(new Handler[] { context, new DefaultHandler() });
        server.setHandler(handlers);
        server.start();
        server.join();
    }
}

 

注意事项：
  • 注意Jetty的最低使用的jdk版本，最新版本使用jdk1.8
  • HelloServlet是一个继承了HttpServlet的servlet
  • 运行成功后程序会被挂起，等待用户链接，在浏览器中输入http://localhost:8080/hello便可访问
　　Jetty IoC XML format也容许用户经过XML来实例化应用服务而不用写任何代码（下面配置文件的具体使用方法之后会讲到） 
<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure_9_3.dtd">
<Configure id="ExampleServer" class="org.eclipse.jetty.server.Server">
  <Set name="connectors">
    <Array type="org.eclipse.jetty.server.Connector">
      <Item>
        <New class="org.eclipse.jetty.server.ServerConnector">
          <Arg><Ref refid="ExampleServer"/></Arg>
          <Set name="port">8080</Set>
        </New>
      </Item>
    </Array>
  </Set>
  <New id="context" class="org.eclipse.jetty.servlet.ServletContextHandler">
    <Set name="contextPath">/hello</Set>
    <Call name="addServlet">
      <Arg>org.eclipse.jetty.embedded.HelloServlet</Arg>
      <Arg>/</Arg>
    </Call>
  </New>
  <Set name="handler">
    <New class="org.eclipse.jetty.server.handler.HandlerCollection">
      <Set name="handlers">
        <Array type="org.eclipse.jetty.server.Handler">
          <Item>
            <Ref refid="context" />
          </Item>
          <Item>
            <New class="org.eclipse.jetty.server.handler.DefaultHandler" />
          </Item>
        </Array>
      </Set>
    </New>
  </Set>
</Configure>

 

3.2 能够在Jetty中配置什么

　　这一节将介绍Jetty经常使用的配置。

3.2.1 配置服务

　　Server实例是Jetty服务的重要组成部分，它为其它Jetty组件提供服务和生命周期管理。在标准的Jetty应用中，核心的配置信息在etc/jetty.xml文件中 ，可是你也能够在配置文件中添加其它配置 ，包括：
ThreadPool：
　　服务器实例提供了一个默认ThreadPool实例，用来供其它组件调用。配置线程池的主要参数有最大和最小数量的设置，设置在start.ini文件或者start.d/server.ini文件中。
Handlers：
　　一个Jetty服务器能够只有一个处理程序实例来处理传入的HTTP请求。然而一个处理程序多是一个容器或包装其余处理程序造成一个树的处理程序。在etc/jetty.xml文件中配置的默认的处理程序包含处理程序集合和一个默认的处理程序，根据路径找到相应的处理程序，默认的处理器处理404错误。其余配置信息能够增长处处理树中（例如，jetty-rewrite.xml, jetty-requestlog.xml）， 或者配置一个组件用于热部署处理（例如，jetty-deploy.xml） 。
Server Attributes：
　　服务器能够经过字符串来映射到一个对象上，若是一个对象实现了LifeCycle接口，那么这个对象能够监听这个Jetty服务的启停。一般服务器的属性保存在服务器生命周期内。
Server fields：
　　服务器也有一些特殊的的配置属性，配置在start.ini或者start.d/server.ini文件中，除了控制属性外还有发送时间和http响应的版本。
Connectors：
　　服务器拥有一个链接的集合，用来接收http请求，和其它Jetty支持的协议请求，下一章节将要介绍配置链接。对于服务器能够设置全部的链接也能够增长或者删除个别链接。
Services：
　　服务器能容纳额外的服务对象，有时做为属性，但常常作为有生命周期的bean。

3.2.2配置链接

　　Jetty服务器链接器是一个网络端点接受链接一个或多个协议产生Jetty服务器的请求或消息。在标准Jetty服务器中，能够经过额外的文件增长Jetty服务器支持的协议，例如http.ini，https.ini 和jetty-http2.xml，链接的配置通常都是典型的，以下：
Port：
　　监听TCP/IP链接请求的端口，使用jetty.http.port（或者jetty.ssl.port）属性进行配置，若是没有配置默认8080（TLS默认8443）。
Host：
　　您能够配置一个主机的主机名或IP地址来识别一个特定的网络接口的监听。若是没有设置,或者设置为0.0.0.0,链接器将监听全部主机。能够经过xml文件中jetty.host的这个属性进行设置。
Idle Timeout：
　　时间以毫秒为单位，一个链接的超时时间。
HTTP Configuration：
　　经过HttpConfiguration 实例来配置HTTP链接（包含HTTP， HTTPS 和HTTP2），能够独立于特定的网络协议，标准的Jetty服务经过jetty.xml来配置一个单例的HttpConfiguration对象。
SSL Context Factory：
　　经过本地的密钥来保证ssl链接的安全性。

Note

虚拟主机不能配置链接，用户应该经过虚拟主机的context来实现它们的相应。

Note

Jetty9同时支持链接协议（HTTP，HTTPS，AJP，SPDY）和天然链接（NIO或者BIO），Jetty9之后只有一个主要的链接器ServerConnector

3.2.3配置上下文环境

一个Jetty环境包含一组处理器处理指定路径的请求。一个Jetty环境能够包含默认处理器和用户自定义处理器。

Note

servlet规范定一个web应用。在Jetty规范中一个标准的web项目必须有一个标准的WEB-INF/web.xml文件，用来配置classpath，资源，session处理，登陆，以及servlet，jsp，以及静态资源。标准的web应用须要不多的额外的配置文件。

常见的上下文配置：
contextPath：
　　contextPath 是URL的前缀。例如一个contextPath 是/foo，它将处理 /foo， /foo/index.html， /foo/bar/，and /foo/bar/image.png等请求，可是它不会处理像/，/other/，or /favicon.ico这样的请求，若contextPath是/，则为根contextPath。contextpath能够被默认设置（默认为部署的文件名），也能够在xml里面或者代码里面进行设置，或者在WEB-INF/jetty-web.xml文件中设置。
virtualHost：
　　配置监听主机ip或名称，没有配置的将不会被监听到。
classPath：
　　配置类路径，标准的类路径为 WEB-INF/lib和WEB-INF/classes ，也能够增长额外的路径到classpath下。
attributes：
　　配置属性，能够传递到实体类中，好比javax.servlet.context.tempdir属性用来配置临时目录。
resourceBase：
　　配置资源，这个配置是一个目录，包含各类静态资源信息，能够是图片或者HTML页面。

3.2.3.1 经过API配置上下文

在嵌入式的server，用户能够经过ContextHandler API来配置上下文，示例以下： 
//
//  ========================================================================
//  Copyright (c) 1995-2016 Mort Bay Consulting Pty. Ltd.
//  ------------------------------------------------------------------------
//  All rights reserved. This program and the accompanying materials
//  are made available under the terms of the Eclipse Public License v1.0
//  and Apache License v2.0 which accompanies this distribution.
//
//      The Eclipse Public License is available at
//      http://www.eclipse.org/legal/epl-v10.html
//
//      The Apache License v2.0 is available at
//      http://www.opensource.org/licenses/apache2.0.php
//
//  You may elect to redistribute this code under either of these licenses.
//  ========================================================================
//
package org.eclipse.jetty.embedded;
import org.eclipse.jetty.server.Server;
import org.eclipse.jetty.server.handler.ContextHandler;
public class OneContext
{
    public static void main( String[] args ) throws Exception
    {
        Server server = new Server( 8080 );
        // Add a single handler on context "/hello"
        ContextHandler context = new ContextHandler();
        context.setContextPath( "/hello" );
        context.setHandler( new HelloHandler() );
        // Can be accessed using http://localhost:8080/hello
        server.setHandler( context );
        // Start the server
        server.start();
        server.join();
    }
}

 

3.2.3.2 经过Ioc XML配置上下文

　　用户能够建立一个IoC的XML（或使用spring的Jetty插件） 
<?xml version="1.0"  encoding="UTF-8"?>
<!DOCTYPE Configure PUBLIC
    "-//Mort Bay Consulting//DTD Configure//EN"
    "http://www.eclipse.org/jetty/configure_9_0.dtd">
<!--
  Configure a custom context for serving javadoc as static resources
-->
<Configure class="org.eclipse.jetty.server.handler.ContextHandler">
  <Set name="contextPath">/javadoc</Set>
  <Set name="resourceBase"><SystemProperty name="jetty.home" default="."/>/javadoc/</Set>
  <Set name="handler">
    <New class="org.eclipse.jetty.server.handler.ResourceHandler">
      <Set name="welcomeFiles">
        <Array type="String">
          <Item>index.html</Item>
        </Array>
      </Set>
      <Set name="cacheControl">max-age=3600,public</Set>
    </New>
  </Set>
</Configure>

 

3.2.4 配置web应用

servlet规范定义了一个web应用程序,当调用打包为一个WAR文件（web应用程序存档），Jetty经过以下进行配置：
  • 初始化classpath，在WEB-INF/lib和WEB-INF/classes下。
  • 根据标准的WEB-INF/web.xml进行解析初始化参数，过滤器，监听器，欢迎页面等信息。
  • WEB-INF/jetty-web.xml文件可能包含Jetty IoC的配置。

3.2.4.1 配置contextpath

　　能够增长一个WEB-INF/jetty-web.xml文件用来配置classpath 
<?xml version="1.0"  encoding="UTF-8"?>
<!DOCTYPE Configure PUBLIC
    "-//Mort Bay Consulting//DTD Configure//EN"
    "http://www.eclipse.org/jetty/configure_9_0.dtd">
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
    <Set name="contextPath">/contextpath</Set>
</Configure>

 　　还有一种作法是，不用增长配置文件，在war文件同目录，建一个同名的xml文件，内容以下：

<?xml version="1.0"  encoding="UTF-8"?>
<!DOCTYPE Configure PUBLIC
    "-//Mort Bay Consulting//DTD Configure//EN"
    "http://www.eclipse.org/jetty/configure_9_0.dtd">
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
  <Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/test.war</Set>
  <Set name="contextPath">/test</Set>
</Configure>

 　　配置例子能够参照$JETTY_HOME/webapps/test.xml

3.2.4.2 Web应用部署

Jetty可以部署各类Web应用程序的格式。这是经过 扫描${jetty.base}/webapps 文件夹下
一个Context能够有以下
  • 一个标准的war文件（必须以war结尾）
  • 一个标准的web应用（必须有{dir}/WEB-INF/web.xml 文件）
  • 一个包含静态资源的文件夹
  • 一个Jetty描述XML，引用一个web应用
新WebAppProvider将试图避免双重部署，以及其余须要注意的方面，以下：
  • 隐藏文件将被忽略（以.开头的文件）
  • 以.d开头的文件夹将被忽略
  • 若是一个文件夹和war名字同样，则只有war会部署
  • 若是一个文件夹和同名xml配置，则xml配置的会被部署
  • 若是一个war文件和xml文件同名，则xml配置的会被部署

3.2.4.3 设置身份验证区域

　　身份验证方法和域名校验能够在web.xml里面进行描述： 
...
<login-config>
  <auth-method>BASIC</auth-method>
  <realm-name>Test Realm</realm-name>
</login-config>
...

 　　这个例子使用名为Test Realm.的验证，可是没有说明其是怎么实现的，在Jetty中有几种实现方式，其中一种是HashLoginService能够读取登陆用户，并在配置文件中查找，为了配置HashLoginService用来匹配Test Realm，能够配置$JETTY_BASE/etc/test-realm.xml文件，而且该文件必须在start.ini或者start.d/server.ini中设置。

<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-" "http://www.eclipse.org/jetty/configure_9_3.dtd">
<Configure id="Server" class="org.eclipse.jetty.server.Server">
    <!-- =========================================================== -->
    <!-- Configure Authentication Login Service                      -->
    <!-- Realms may be configured for the entire server here, or     -->
    <!-- they can be configured for a specific web app in a context  -->
    <!-- configuration (see $(jetty.home)/webapps/test.xml for an    -->
    <!-- example).                                                   -->
    <!-- =========================================================== -->
    <Call name="addBean">
      <Arg>
        <New class="org.eclipse.jetty.security.HashLoginService">
          <Set name="name">Test Realm</Set>
          <Set name="config"><Property name="jetty.demo.realm" default="etc/realm.properties"/></Set>
          <Set name="refreshInterval">0</Set>
        </New>
      </Arg>
    </Call>
    <Get class="org.eclipse.jetty.util.log.Log" name="rootLogger">
      <Call name="warn"><Arg>demo test-realm is deployed. DO NOT USE IN PRODUCTION!</Arg></Call>
    </Get>
</Configure>

 　　经过建立和配置LoginService到web应用中，当部署应用时，会经过名字去寻找匹配的登陆Service。 

 

　　以上是翻译的第一部分，Jetty全部目录信息见：http://www.cnblogs.com/yiwangzhibujian/p/5832294.html，后面几个部分比较多可能会分几篇进行翻译，不少地方翻译的时候都不明白是如何使用的，所以有可能翻译不到位，估计等我所有看完后才会理解，那时候我会根据本身的理解写一点新手教程。

联系我们 沪ICP备13005482号-10