精华内容
下载资源
问答
  • Jetty使用总结

    2014-11-14 16:01:59
    Jetty使用总结
  • 第一部分部分重点介绍如何使用Jetty,它提供如下信息,如什么是Jetty,从哪可以下载它,怎么在像Maven一样的仓库中找到它。这一部分同样会提供启动Jetty和如何配置Jetty的快速入门。 第二部分从更细致...

    一、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版本

    版本YearHomeJVM协议ServletJSP状态

    9.3

    2015

    Eclipse

    1.8

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

    WebSocket (RFC 6455, JSR 356), FastCGI

    3.1

    2.3

    稳定版本

    9.2

    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

    JSRNameIncluded with jetty-9.0.xPluggable

    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>

     

     二、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

    LocationDescription

    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重定向使用的示例应用

    三、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

    展开全文
  • Jetty使用

    2018-08-29 17:05:26
    0.何为Jetty Jetty是Eclipse的一个项目,可以提供HTTP客户端,HTTP服务端和Java Servlet容器。...1.Jetty使用 1-1 添加Jetty的pom依赖 &lt;dependency&gt; &lt;groupId&gt;org...

    0.何为Jetty

    Jetty是Eclipse的一个项目,可以提供HTTP客户端,HTTP服务端和Java Servlet容器。

    Jetty的下载地址:Jetty https://www.eclipse.org/jetty/download.html

    1.Jetty的使用

    1-1 添加Jetty的pom依赖

    <dependency>
      <groupId>org.eclipse.jetty</groupId>
      <artifactId>jetty-project</artifactId>
      <version>${project.version}</version>
    </dependency>

    1-2 Jetty目录说明

    目录

    说明

    license-eplv10-aslv20.html

    Jetty的证书

    README.txt

    Readme

    VERSION.txt

    发布信息

    bin/

    Jetty运行在Unix系统下所需的shell脚本组件

    demo-base/

    包括一些采用Jetty运行的demo

    etc/

    Jetty的xml配置文件目录

    lib/

    Jetty运行所需Jar包

    logs/

    请求日志的目录

    modules/

    模块定义目录

    notice.html

    证书和期望

    resources/

    包含Classpath运行时需要的额外资源,通过配置文件激活

    start.ini

    File containing the arguments that are added to the effective command line (modules, properties and XML configuration files)

    start.jar

    运行Jetty的Jar包

    webapps/

    在Jetty默认配置下的项目目录

    1-3 Jetty的运行

    需要在命令行下cd进Jetty的根目录,然后执行java -jar start.jar

     

    2.Jetty的通用配置

    2-1 创建新的JettyBase 和JettyHome

    jetty.home:包括Jetty的运行包,xml 配置文件等文件的Jetty目录

    jetty.base:包括特定项目的目录

    如下的命令将会创建一个新的Jetty Base目录,并且激活Http服务和进行项目部署:

    # 定义新的JettyBase 并且启动项目
    > 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
    # 部署项目,并且激活Http服务
    > java -jar $JETTY_HOME/start.jar --create-startd
    INFO : Base directory was modified
    > java -jar $JETTY_HOME/start.jar --add-to-start=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.4.11.v20180605.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

    2-2 改变Jetty的运行端口

    > cd $JETTY_BASE
    > java -jar $JETTY_HOME/start.jar jetty.http.port=8081
    ...

    2-3 添加Https的SSL证书

    > java -jar $JETTY_HOME/start.jar --add-to-start=https,http2
    
    ALERT: There are enabled module(s) with licenses.
    The following 1 module(s):
     + contains software not provided by the Eclipse Foundation!
     + contains software not covered by the Eclipse Public License!
     + has not been audited for compliance with its license
    
     Module: alpn-impl/alpn-8
      + ALPN is a hosted at github under the GPL v2 with ClassPath Exception.
      + ALPN replaces/modifies OpenJDK classes in the sun.security.ssl package.
      + http://github.com/jetty-project/jetty-alpn
      + http://openjdk.java.net/legal/gplv2+ce.html
    
    Proceed (y/N)? y
    INFO  : alpn-impl/alpn-1.8.0_92 dynamic dependency of alpn-impl/alpn-8
    INFO  : alpn            transitively enabled, ini template available with --add-to-start=alpn
    INFO  : alpn-impl/alpn-8 dynamic dependency of alpn
    INFO  : http2           initialized in ${jetty.base}/start.d/http2.ini
    INFO  : https           initialized in ${jetty.base}/start.d/https.ini
    INFO  : ssl             transitively enabled, ini template available with --add-to-start=ssl
    MKDIR : ${jetty.base}/lib/alpn
    DOWNLD: https://repo1.maven.org/maven2/org/mortbay/jetty/alpn/alpn-boot/8.1.8.v20160420/alpn-boot-8.1.8.v20160420.jar to ${jetty.base}/lib/alpn/alpn-boot-8.1.8.v20160420.jar
    MKDIR : ${jetty.base}/etc
    COPY  : ${jetty.home}/modules/ssl/keystore to ${jetty.base}/etc/keystore
    INFO  : Base directory was modified
    
    > java -jar $JETTY_HOME/start.jar
    [...]
    2017-05-22 12:48:23.271:INFO:oejs.AbstractConnector:main: Started ServerConnector@134d0064{SSL,[ssl, alpn, h2, http/1.1]}{0.0.0.0:8443}
    [...]

     

     

     

    展开全文
  • Jetty使用攻略

    千次阅读 2016-09-26 20:41:32
    jetty作为一款小型的web容器用处很大,因为其小巧强大,经常作为嵌入式的组件处理http交互。 Jetty 作为一个独立的 Servlet 引擎可以独立提供 Web 服务,但是... 实际上 Jetty 的工作方式非常简单,当 Jetty 接受到一

    jetty作为一款小型的web容器用处很大,因为其小巧强大,经常作为嵌入式的组件处理http交互。
    Jetty 作为一个独立的 Servlet 引擎可以独立提供 Web 服务,但是它也可以与其他 Web 应用服务器集成,所以它可以提供基于两种协议工作,一个是 HTTP,一个是 AJP 协议,本文介绍jetty处理http请求的应用。 实际上 Jetty 的工作方式非常简单,当 Jetty 接受到一个请求时,Jetty 就把这个请求交给在 Server 中注册的代理 Handler 去执行,如何执行你注册的 Handler,同样由你去规定,Jetty 要做的就是调用你注册的第一个 Handler 的 handle
    下面自己对jetty的使用。
    动起来:
    1.下载jetty:http://www.eclipse.org/jetty/documentation/current/quick-start-getting-started.html#jetty-downloading
    2.在项目中引入包

    3.写一个Servlet处理类。

    public class LoginServlet extends HttpServlet {
          public void doGet(HttpServletRequest request, 
                HttpServletResponse response) throws IOException  {
                String username= request.getParameter( "username");
                String password= request.getParameter( "password");
    
                  response.setContentType( "text/html;charset=utf-8"); 
    
                  //返回html 页面 
                  response.getWriter().println( "<html>"); 
                  response.getWriter().println( "<head>");    
                  response.getWriter().println( "<title>登录信息</title>" );     
                  response.getWriter().println( "</head>");   
                  response.getWriter().println( "<body>");    
                  response.getWriter().println( "欢迎【" + username + "】用户登录成功!!!" );   
                  response.getWriter().println( "</body>");   
                  response.getWriter().println( "</html>");                  
    
          }
    
           public void doPost(HttpServletRequest request, 
                      HttpServletResponse response) throws IOException  {
                 //doGet(request,response);
                 response.sendRedirect( "/web-inf/jsp/default.jsp");
           }
    }

    4.设置jetty启动项

    public class JettyServer {
    
          public static void main(String[] args) throws Exception {
                Server server= new Server(8080);
    
                ServletContextHandler context= new ServletContextHandler(ServletContextHandler.SESSIONS );
                 context.setContextPath( "/");
    
                 server.setHandler( context);
    
                 context.addServlet( new ServletHolder( new LoginServlet()),"/here");
    
                 server.start();
                 server.join();
          }
    
    }

    5.启动并输入地址:
    http://localhost:8080/here
    至此,jetty简单运行成功。

    在springMVC中使用jetty
    1.引入pom文件:

    <project xmlns= "http://maven.apache.org/POM/4.0.0" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
      < modelVersion>4.0.0</modelVersion >
      < groupId> com.lango.test</ groupId>
      < artifactId> springMvcJetty</ artifactId>
      < packaging> war</ packaging>
      < version> 0.0.1-SNAPSHOT</ version>
      < name> springMvcJetty Maven Webapp</ name>
      < url> http://maven.apache.org</ url>
      < dependencies>
        <dependency >
          <groupId >junit</groupId>
          <artifactId >junit</artifactId>
          <version >3.8.1 </version >
          <scope >test </scope >
        </dependency >
          <dependency >
                       <groupId >org.eclipse.jetty </groupId >
                       <artifactId >jetty-io</artifactId >
                       <version >8.1.8.v20121106 </version >
                 </dependency >
                 <dependency >
                       <groupId >org.eclipse.jetty </groupId >
                       <artifactId >jetty-io</artifactId >
                       <version >8.1.8.v20121106 </version >
                 </dependency >
                 <dependency >
                       <groupId >org.eclipse.jetty </groupId >
                       <artifactId >jetty-webapp</artifactId >
                       <version >8.1.8.v20121106 </version >
                 </dependency >
                 <dependency >
                       <groupId >org.eclipse.jetty </groupId >
                       <artifactId >jetty-server</ artifactId>
                       <version >8.1.8.v20121106 </version >
                 </dependency >
                 <dependency >
                       <groupId >org.eclipse.jetty </groupId >
                       <artifactId >jetty-servlet</artifactId >
                       <version >8.1.8.v20121106 </version >
                 </dependency >
                 <dependency >
                       <groupId >org.springframework </groupId >
                       <artifactId >spring-context </artifactId >
                       <version >4.1.4.RELEASE </version >
                 </dependency >
                 <dependency >
                       <groupId >org.springframework </groupId >
                       <artifactId >spring- jms</ artifactId>
                       <version >4.1.6.RELEASE </version >
                 </dependency >
                 <dependency >
                       <groupId >org.springframework </groupId >
                       <artifactId >spring-test </artifactId >
                       <version >4.1.4.RELEASE </version >
                 </dependency >
                 <dependency >
                       <groupId >org.springframework </groupId >
                       <artifactId >spring-web </artifactId >
                       <version >4.1.4.RELEASE </version >
                 </dependency >
                 <dependency >
                       <groupId >org.springframework </groupId >
                       <artifactId >spring- webmvc</ artifactId>
                       <version >4.1.4.RELEASE </version >
                 </dependency >
                 <dependency >
                       <groupId >org.springframework </groupId >
                       <artifactId >spring-context-support </artifactId >
                       <version >4.1.4.RELEASE </version >
                 </dependency >
      </ dependencies>
      < build>
        <finalName >springMvcJetty </finalName >
      </ build>
    </project>

    2.配置jetty服务器:

    public class jettyT {
    
          public static void main(String[] args) throws Exception {
                 Server server= new Server(8080);
    
             ServletContextHandler context= new ServletContextHandler(ServletContextHandler.SESSIONS );
              context.setContextPath( "/");
    
              //使用spring的Servlet处理  
              DispatcherServlet servlet= new DispatcherServlet();
             servlet.setContextConfigLocation( "classpath*:springMvcJetty/spring-jetty.xml" );
             context.addServlet( new ServletHolder(servlet), "/");
    
             HandlerList handlers= new HandlerList();
             handlers.addHandler( context);
             server.setHandler( handlers);
    
                ThreadPool pool = new ExecutorThreadPool(
                            Executors. newCachedThreadPool());
             server.setThreadPool( pool);
    
             Connector connector= new SelectChannelConnector();
             connector.setPort(8080); //此处要与前面设置的 jetty端口一致。
             server.setConnectors( new Connector[]{ connector});
    
              server.start();
              server.join();
          }
    }

    3.其中的spring-jetty.xml配置:

    <?xml version="1.0" encoding= "UTF-8"?>
    <beans xmlns= "http://www.springframework.org/schema/beans"
           xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
           xmlns:tx= "http://www.springframework.org/schema/tx" xmlns:mvc= "http://www.springframework.org/schema/mvc"
           xmlns:aop= "http://www.springframework.org/schema/aop" xmlns:p= "http://www.springframework.org/schema/p"
           xsi:schemaLocation= "http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.0.xsd
                http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
                http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
                http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
                http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd
                " >
                 <!-- 注解扫描包 -->
          <context:annotation-config />
                 <context:component-scan base-package ="springMvc"
                 use-default-filters= "false">
                 <context:include-filter type ="annotation" expression= "org.springframework.stereotype.Controller" />
          </context:component-scan >
                 <!-- 开启注解 -->
          <mvc:annotation-driven >
    
          </mvc:annotation-driven >
    </beans>

    4.写一个controller:

    @Controller
    @RequestMapping("/home" )
    public class Home {
    
          @RequestMapping("/index")
          @ResponseBody
          public String Index(HttpServletRequest request){
                String name= request.getParameter( "name");
    
                 return name+ "你好";
          }
    }

    在浏览器中访问http://localhost:8080/home/index,就可以了。

    扩展: Jetty 有一个处理长连接的机制:一个被称为 Continuations 的特性。利用 Continuation 机制,Jetty 可以使得一个线程能够用来同时处理多个从客户端发送过来的异步请求。 Continuations 机制维护一个队列,当请求在suspend方法之后就加入队列,等到超时或者调用 resume方法时,在交由线程处理。这使得jetty特别适合处理聊天室之类的应用。
    参考:http://www.eclipse.org/jetty/documentation/current/

    https://www.ibm.com/developerworks/cn/web/wa-lo-jetty/

    展开全文
  • 来源:... 这个入门教程分为五个部分:第一部分部分重点介绍如何使用Jetty,它提供如下信息,如什么是Jetty,从哪可以下载它,怎么在像Maven一样的仓库中找...

    来源:https://blog.csdn.net/qq_37878579/article/details/78404931

    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版本
    版本YearHomeJVM协议ServletJSP状态

    9.3

    2015

    Eclipse

    1.8

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

    WebSocket (RFC 6455, JSR 356), FastCGI

    3.1

    2.3

    稳定版本

    9.2

    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

    JSRNameIncluded with jetty-9.0.xPluggable

    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>
    复制代码

     二、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

    LocationDescription

    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.。然而在JETTYHOME/webappswebJetty404JETTYHOME/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 JETTYHOME/start.jaraddtostartd=http,deployjavajarJETTYHOME/start.jar−−add−to−startd=http,deploy命令为当前基目录添加标准文件及文件夹,然后java−jarJETTY_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重定向使用的示例应用

    三、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启动原理使用命令行,使用 JETTYBASE/start.iniJETTYBASE/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文件通常位于JETTYHOME/modules/JETTYHOME/modules/文件夹下,但是额外增加的或者编辑过的通常放在JETTY_BASE/module下,如果一个模块需要被修改,最好的做法是在修改前从JETTYHOME/modules/.modJETTYHOME/modules/拷贝∗.mod到JETTY_BASE/modules/


    XML files:  

    xml文件一般用与IoC以及spring使用,用在命令行或者模块定义中。xml文件里面的配置将被注入到描述服务的一个对象里。通常改变属性的方法是改变对应的ini文件。xml文件通常放在JETTYHOME/etc/xmlJETTYHOME/etc/下,但是新增的或者被编辑的xml应该被放在JETTY_BASE/etc/下,如果xml配置文件有修改的必要,最好的做法是在修改前将xml文件从JETTYHOME/etcJETTYHOME/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。 

     

    展开全文
  • Spring-Boot-Jetty-WebSocket-示例 这是如何使用Spring Boot配置Jetty WebSocket的基本示例。 有关更多信息,请阅读我的博客文章-
  • jetty使用

    2019-03-22 03:00:18
    NULL 博文链接:https://szcs10138456.iteye.com/blog/1011072
  • jetty-jdk7使用版本

    2019-01-02 11:14:32
    支持jdk7的jetty服务器,本想免费下载的,但没有分数为0的选项,点个1分,意思意思
  • 深入jetty使用详解

    2020-12-31 20:27:23
    Jetty 这个项目成立于 1995 年,现在已经有非常多的成功产品基于 Jetty,比如 Apache Geromino, JBoss, IBM Tivoli, Cisco SESM 等。Jetty 可以用来作为一个传统的 Web 服务器,也可以作为一个动态的内容服务器,...
  • jetty使用步骤

    千次阅读 2018-06-03 22:58:28
    --------- jetty使用步骤 --------- 1、首先到其官网下载jetty压缩包,直接解压到某个目录下。2、cmd进入D:\jetty\demo-base&gt;: 【java -jar D:\jetty\start.jar】3、到浏览器输入【http://localhost:8080】...
  • Jetty使用教程

    万次阅读 2019-02-25 15:25:33
    Jetty比较简单,和Tomcat大致相同,本文主要描述jetty9以上版本的使用jetty9版本对jetty的目录结构和使用都有了一些明显的改动。 Jetty较于Tomcat属于轻量级,而且在处理高并发细粒度请求的场景下显得更快速高效...
  • eclipse在线安装Jetty使用教程

    千次阅读 2017-07-21 11:08:11
    一.eclipse中jetty插件安装:  打开eclipse,依次点击菜单Help->Eclipse Marketplace,在Find后面的框中...使用jetty发布项目: 选中项目—>右键—>Run As—>Run with Jetty,即发布成功 访问http://localhost:80
  • Jetty配置支持https

    2016-07-05 14:57:06
    Jetty配置支持HTTPS以及受信网站证书生成方式
  • Jetty之webSocket使用案例

    万次阅读 2018-01-09 15:37:06
    以前使用的tomcat,没接触过jetty,最近使用jettyjetty相对Tomcat,给我第一个使用感觉,那就是加载速度比tomcat快多了。而jetty还有一个最大的优点是tomcat不能达到的优势。 jetty倡导嵌入式开发,什么叫...
  • maven的项目用jetty 服务器启动项目时配置此段配置,就可以实现热部署(意思就是eclipse改了代码可以不用重启服务器)
  • 主要介绍了java 在Jetty9中使用HttpSessionListener和Filter的相关资料,需要的朋友可以参考下
  • spring Boot 使用jetty

    千次阅读 2018-09-06 15:11:54
    如果想使用jetty,pom配置也是很简单的 1.第一步移除Tomcat依赖  &lt;dependency&gt;  &lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;  &lt;artifactId&gt;spring-...
  • Jetty9 配置使用HTTPS证书,访问你的服务器更安全,更好的配置方法。
  • springboot中使用jetty服务器

    千次阅读 2019-09-18 10:56:30
    修改pom.xml 1、加入依赖 <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jetty</artifactId> <...
  • jetty 使用servlet

    2013-12-04 10:24:45
    在嵌入式Jetty中,有时候我们想运行一些的Servlet,此时就需要创建创建Context,然后让自己的Servlet运行在这些ServletContext中。   package hb.jetty; import java.io.IOException; import javax.servlet....
  • 可以看到,目前 Jetty 的最新版本是 Jetty9,这里我们使用 9.2。注意:使用 Jetty9.2+ 需要 JDK 1.7 及以上版本 项目结构 bin:可执行脚本文件 Jetty:服务器基目录 etc:Jetty 模块定义的XML配置文件的目录 ...
  • java 嵌入式的Web服务器jetty使用例子

    万次阅读 2015-12-08 18:27:17
    //不使用jetty.xml配置文件启动 //http://hbiao68.iteye.com/blog/2111007 public class SimpleServerStart { //http://127.0.0.1:9999/simple/ //http://127.0.0.1:9999/simple/servlet public static void main...
  • eclipse在线安装Jetty使用教程:http://blog.csdn.net/qq_34851184/article/details/75634256 Jetty 的基本架构 Jetty 目前的是一个比较被看好的 Servlet 引擎,它的架构比较简单,也是一个可扩展性和非常灵活...
  • Jetty

    2019-04-02 01:55:15
    NULL 博文链接:https://tristan-s.iteye.com/blog/1452494
  • jetty输出大量日志如下: 12 Jan 2016 18:59:25.828 WARN nio[243]-Dispatched Failed! SCEP@34b2eaa5{l(/127.0.0.1:29829)r(/127.0.0.1:8080),s=-1,open=true,ishut=false,oshut=false,rb=false,wb=false,w=true,...
  • 禁止 Jetty 使用映射缓存

    千次阅读 2013-03-07 15:05:35
    当你想试图去修改正在被访问的资源文件,像 CSS、JS、FTL等,这时候你修改完成想保存的时候,是保存不了的。你必须停掉 Jetty 容器(如果是在CMD下运行的 Jetty 容器,按 Ctrl + C 停掉 ...究其原因,这是 Jetty 使用

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 90,134
精华内容 36,053
关键字:

jetty使用