Jetty 9嵌入式开发

官方网址:http://www.eclipse.org/jetty/

下载地址:http://download.eclipse.org/jetty/stable-9/dist/

文档网址:http://www.eclipse.org/jetty/documentation/

当前Jetty网址上推荐使用的稳定版本:Jetty9.0。

介绍

      Jetty9内容位于http://www.eclipse.org/jetty/documentation

      直接链接:

http://www.eclipse.org/jetty/documentation/current/embedding-jetty.html

      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服务

http://download.eclipse.org/jetty/stable-9/xref/org/eclipse/jetty/embedded/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)

http://download.eclipse.org/jetty/stable-9/xref/org/eclipse/jetty/server/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("<h1>HelloWorld</h1>");

    }

}

传递给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包中有那些可用处理器。

相关推荐