Jetty 9嵌入式开发手册

Jetty 9嵌入式开发手册

Jetty有一个标语，“不要部署你的应用在Jetty上，部署Jetty在你的应用中”。这意味着可选择使用Jetty捆绑你的应用作为一个标准 WAR进行部署。Jetty设计成一个软件组件，可以实例化并且使用在Java程序中，例如：如何POJO。但是另外一种方法，以嵌入式模式运行 Jetty，这意味着把HTTP模块放入到你的应用中，而不是把你的应用放入到HTTP服务中。

本教程引导你逐步从最简单的Jetty服务实例到使用标准部署描述运行多个Web应用。大部分示例的源代码是标准Jetty项目的一部分。

在学习该教程之前，完成一个HelloWorld教程是值得的。该教程可以在“嵌入式Jetty网络研讨会记录”中找到。

Jetty版本：本教程的代码来自于Jetty7，但是也应该在Jetty 8中可以使用。对于最新的稳定版本，参考最新发行版的链接代码。可能与本教程中给出的代码例子有稍微的不同。

概述

为了嵌入Jetty服务，通常执行下面的步骤：

1）创建一个服务

2）添加和配置连接器

3）添加和配置处理器

4）添加和配置Servlet、Webapp到处理器

5）启动服务

6）等待（join服务防止主线程退出）

创建一个服务

下面的代码来自于SimplestServer.jar，实例化和运行一个最简单的Jetty服务

https://www.360docs.net/doc/442758708.html,/jetty/stable-9/xref/org/eclipse/jetty/emb edded/SimplestServer.html

public class SimplestServer

{

public static void main(String[] args) throws Exception

{

Server server = new Server(8080);

server.start();

server.join();

}

}

在端口8080上运行一个HTTP服务。这不是非常有用的服务，因为它不处理，对于每个请求只是返回一个404错误。

编写处理器

为了生成请求的响应，Jetty要求在服务上设置一个Handler。一个处理器可能：

1）检查和修改HTTP请求

2）生成完整的HTTP详情

3）调用其他的处理器（参见HandlerWrapper）

4）选择一个或者多个处理器调用（参考HandlerCollection）

https://www.360docs.net/doc/442758708.html,/jetty/stable-9/xref/org/eclipse/jetty/ser ver/handler/HandlerWrapper.html

Hello world处理器：

下面代码基于HelloHandler.java，显示一个简单的Helloworld处理器。public classHelloHandler extends AbstractHandler

{

public void handle(String

target,RequestbaseRequest,HttpServletRequest

request,HttpServletResponse response)

throws IOException, ServletException

{

response.setContentType("text/html;charset=utf-8");

response.setStatus(HttpServletResponse.SC_OK);

baseRequest.setHandled(true);

response.getWriter().println("

HelloWorld

");

}

}

传递给handle方法的参数包括：

1） target - 请求的目标，它可以是一个URI或者命名分发器的名称

2） baseRequest – Jetty可变请求对象，它总是解包的

3） request - 不可变的请求对象，它可能已经被封装

4） response - 响应，它可能已经被封装

处理器设置请求的状态，内容类型，在使用writer生成请求体之前标注请求已经处理（后续就不再处理）。

下面的代码来自于OneHandler.java，显示Jetty服务如何使用该处理器。

public staticvoid main(String[] args) throws Exception

{

Server server = new Server(8080);

server.setHandler(new HelloHandler());

server.start();

server.join();

}

现在你知道基于Jetty编写一个HTTP服务所需要了解的所有东西。然而，复杂的请求处理通常使用多处理器构建。我们在后面章节中看看它是如何组合处理器的。你能查看Jetty的org.eclipse.jetty.server.handler包中有那些可用处理器。