Jetty嵌入式配置(一)

Jetty 的基本架构
下图是 Jetty 的基本架构图，整个 Jetty 的核心组件由 Server 和 Connector 两个组件构成，整个 Server 组件是基于 Handler 容器工作的，它类似与 Tomcat 的 Container 容器，Jetty 与 Tomcat 的比较在后面详细介绍。Jetty 中另外一个比不可少的组件是 Connector，它负责接受客户端的连接请求，并将请求分配给一个处理队列去执行。

图 1. Jetty 的基本架构

[img]http://dl2.iteye.com/upload/attachment/0087/5125/47a5ef56-0be0-3790-81ea-01993a7b9c06.jpg[/img]


Jetty 中还有一些可有可无的组件，我们可以在它上做扩展。如 JMX，我们可以定义一些 Mbean 把它加到 Server 中，当 Server 启动的时候，这些 Bean 就会一起工作。

Jetty安装

       <dependency>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-server</artifactId>
            <version>7.6.11.v20130520</version>
        </dependency>

创建Jetty 服务:

public static void main(String[] args) throws Exception {
     Server server = new Server(8080);
     server.start();
     server.join();
}

Server 是Jetty的核心类，运行此类就可以启动Jetty服务,访问服务地址：http://localhost:8080/
虽然服务正常启动，但是在服务中没有加入任何Handle,所以访问的时候会返回404 error.

创建Handler：

public class HelloHandler extends AbstractHandler {

	public void handle(String target, Request baseRequest,
			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>Hello World</h1>");
	}
}

Jetty是面向Handler架构的，就像Spring面向bean架构，Ibatis面向statement架构一样。
将自定义的HelloHandler加入到Server中如下：

public static void main(String[] args) throws Exception {
     Server server = new Server(8080);
     server.setHandler(new HelloHandler());
     server.start();
     server.join();
}

重新执行此类，访问服务地址：http://localhost:8080/，访问效果如下：

[img]http://dl2.iteye.com/upload/attachment/0087/5127/685b5231-6484-3047-add0-5fe1b7b9347e.jpg[/img]

当我们在浏览器里敲入 http://localhost:8080 时的请求将会代理到 Server 类的 handle 方法，Server 的 handle 的方法将请求代理给 ContextHandler 的 handle 方法，ContextHandler 又调用 HelloHandler 的 handle 方法。这个调用方式是不是和 Servlet 的工作方式类似，在启动之前初始化，然后创建对象后调用 Servlet 的 service 方法。


配置Connectors：
让Jetty基于NIO的方式工作，实现类为：org.eclipse.jetty.server.nio.SelectChannelConnector，Jetty 在启动时将会创建 NIO 的工作环境，它会创建 HttpConnection 类用来解析和封装 HTTP1.1 的协议，ConnectorEndPoint 类是以 NIO 的处理方式处理连接请求 ，请求线程池为org.eclipse.jetty.util.thread.QueuedThreadPool

public static void main(String[] args) throws Exception {
     Server server = new Server(8080);
     QueuedThreadPool threadPool = new QueuedThreadPool();
     threadPool.setMinThreads(10);
     threadPool.setMaxThreads(500);
     server.setThreadPool(threadPool);

     SelectChannelConnector connector = new SelectChannelConnector();
     connector.setPort(8080);
     //每个请求被accept前允许等待的连接数
     connector.setAcceptQueueSize(50);
     //同事监听read事件的线程数
     connector.setAcceptors(2);
     //连接最大空闲时间，默认是200000，-1表示一直连接
     connector.setMaxIdleTime(3000);

     server.addConnector(connector);
     server.setHandler(new HelloHandler());
     server.start();
     server.join();
}

创建一个 Selector 相当于一个观察者，打开一个 Server 端通道，把这个 server 通道注册到观察者上并且指定监听的事件。然后遍历这个观察者观察到事件，取出感兴趣的事件再处理。这里有个最核心的地方就是，我们不需要为每个被观察者创建一个线程来监控它随时发生的事件。而是把这些被观察者都注册一个地方统一管理，然后由它把触发的事件统一发送给感兴趣的程序模块。这里的核心是能够统一的管理每个被观察者的事件，所以我们就可以把服务端上每个建立的连接传送和接受数据作为一个事件统一管理，这样就不必要每个连接需要一个线程来维护了。

这里需要注意的地方时，很多人认为监听 SelectionKey.OP_ACCEPT 事件就已经是非阻塞方式了，其实 Jetty 仍然是用一个线程来监听客户端的连接请求，当接受到请求后，把这个请求再注册到 Selector 上，然后才是非阻塞方式执行。这个地方还有一个容易引起误解的地方是：认为 Jetty 以 NIO 方式工作只会有一个线程来处理所有的请求，甚至会认为不同用户会在服务端共享一个线程从而会导致基于 ThreadLocal 的程序会出现问题，其实从 Jetty 的源码中能够发现，真正共享一个线程的处理只是在监听不同连接的数据传送事件上，比如有多个连接已经建立，传统方式是当没有数据传输时，线程是阻塞的也就是一直在等待下一个数据的到来，而 NIO 的处理方式是只有一个线程在等待所有连接的数据的到来，而当某个连接数据到来时 Jetty 会把它分配给这个连接对应的处理线程去处理，所以不同连接的处理线程仍然是独立的。

配置Web Application Context：

Web Applications context是一个变异的ServletContextHandler,它配全web.xml用来配置Servlet、Filter和其他特性。

public static void main(String[] args) throws Exception {
     		String rootDir = "./webapp";
		String contextPath = "/";

		System.setProperty("file.encoding", "utf-8");
		Server server = new Server();
		QueuedThreadPool threadPool = new QueuedThreadPool();
		threadPool.setMinThreads(10);
		threadPool.setMaxThreads(500);
		server.setThreadPool(threadPool);

		SelectChannelConnector connector = new SelectChannelConnector();
		connector.setPort(8080);
		// 每个请求被accept前允许等待的连接数
		connector.setAcceptQueueSize(50);
		// 同事监听read事件的线程数
		connector.setAcceptors(2);
		// 连接最大空闲时间，默认是200000，-1表示一直连接
		connector.setMaxIdleTime(3000);

		server.addConnector(connector);

		WebAppContext context = new WebAppContext(rootDir, contextPath);
		context.setOverrideDescriptors(Arrays.asList(new String[] {    Jetty.class.getResource("/") + "web_override.xml" }));

		context.setParentLoaderPriority(true);
		server.setHandler(context);

		server.start();
		server.join();
}