Jetty Connector学习笔记

http://www.blogjava.net/DLevin/archive/2014/05/01/413022.html

Connector概述

Connector是Jetty中可以直接接受客户端连接的抽象，一个Connector监听Jetty服务器的一个端口，所有客户端的连接请求首先通过该端口，而后由操作系统分配一个新的端口(Socket)与客户端进行数据通信(先握手，然后建立连接，但是使用不同的端口)。不同的Connector实现可以使用不同的底层结构，如Socket Connector、NIO Connector等，也可以使用不同的协议，如Ssl Connector、AJP Connector，从而在不同的Connector中配置不同的EndPoint和Connection。EndPoint用于连接(Socket)的读写数据(参见深入Jetty源码之EndPoint)，Connection用于关联Request、Response、EndPoint、Server，并将解析出来的Request、Response传递给在Server中注册的Handler来处理(参见深入Jetty源码之Connection)。在Jetty中Connector的有：SocketConnector、SslSocketConnector、Ajp13SocketConnector、BlockingChannelConnector、SelectChannelConnector、SslSelectChannelConnector、LocalConnector、NestedConnector等，其类图如下。

Connector类图

首先Connector实现了LifeCycle接口，在启动Jetty服务器时，会调用其的start方法，用于初始化Connector内部状态，并打开Connector以接受客户端的请求(调用open方法)；而在停止Jetty服务器时会调用其stop方法，以关闭Connector以及内部元件(如Connection等)以及做一些清理工作。因而open、close方法是Connector中用于处理生命周期的方法；对每个Connector都有name字段用于标记该Connector，默认值为：hostname:port；Connector中还有Server的引用，可以从中获取ThreadPool，并作为Handler的容器被使用(在创建HttpConnection时，Server实例作为构造函数参数传入，并在handleRequest()方法中将解析出来的Request、Response传递给Server注册的Handler)；Connector还定义了一些用于配置当前Connector的方法，如Buffer Size、Max Idle Time、Low Resource Max Idle Time，以及一些统计信息，如当前Connector总共处理过的请求数、总共处理过的连接数、当前打开的连接数等信息。

AbstractConnector实现

Jetty中所有的Connector都继承自AbstractConnector，而它自身继承自HttpBuffers，HttpBuffers包含了Request、Response的Buffer工厂的创建以及相应Size的配置。AbstractConnector还包含了Name、Server、maxIdleTime以及一些统计信息的引用，用于实现Connector接口中的方法，只是一些Get、Set方法，不详述。除了Connector接口相关的配置，AbstractConnector还为定义了两个字段：_acceptQueueSize用于表示ServerSocket 或ServerSocketChannel中最大可等待的请求数，_acceptors用于表示用于调用ServerSocket或ServerSocketChannel中accept方法的线程数，建议这个数字小于或等于可用处理器的2倍。

在AbstractConnector中还定义了Acceptor内部类，它实现了Runnable接口，在其run方法实现中，它将自己的Thread实例赋值给AbstractConnector中的_acceptorThread数组中acceptor号对应的bucket，并更新线程名为：<name> Acceptor<index> <Connector.toString>。然后根据配置的_acceptorPriorityOffset设置当前线程的priority。只要当前Connector处于Running状态，并且底层链接实例不为null，不断的调用accept方法()。在退出的finally语句快中清理_acceptorThread数组中相应的Bucket值为null，并将线程原来的Name、Priority设置回来。

AbstractConnector实现了doStart()方法，它首先保证Server实例的存在；然后打开当前Connector(调用其open()方法)，并调用父类的doStart方法(这里是HttpBuffers，用于初始化对应的Buffers)；如果没有自定义的ThreadPool，则从Server中获取ThreadPool；最后根据acceptors的值创建_acceptorThread数组，将acceptors个Acceptor实例dispatch给ThreadPool。在doStop方法实现中，它首先调用close方法，然后对非Server中的ThreadPool调用其stop方法，再调用父类的doStop方法清理Buffers的引用，最后遍历_acceptorThread数据，调用每个Thread的interrupt方法。

在各个子类的accept方法实现中，他们在获取客户端过来的Socket连接后，都会对该Socket做一些配置，即调用AbstractConnector的configure方法，它首先设置Socket的TCP_NODELAY为true，即禁用Nagle算法(关于禁用的理由可以参考：http://jerrypeng.me/2013/08/mythical-40ms-delay-and-tcp-nodelay/#sec-4-2，简单的，如果该值为false，则TCP的数据包要么达到TCP Segment Size，要么收到一个Ack，才会发送出去，即有Delay)；然后如果设置了_soLingerTime，则开启Socket中SO_LINGER选项，否则，关闭该选项(SO_LINGER选项用于控制关闭一个Socket的行为，如果开启了该选项，则在关闭Socket时会等待_soLingerTime时间，此时如果有数据还未发送完，则会发送这些数据；如果关闭了该选项，则Socket的关闭会立即返回，此时也有可能继续发送未发送完成的数据，具体参考：http://blog.csdn.net/factor2000/article/details/3929816)。

在ServerSocket和ServerSocketChannel中还有一个SO_REUSEADDR的配置，一般来说当一个端口被释放后会等待两分钟再被使用，此时如果重启服务器，可能会导致启动时的绑定错误，设置该值可以让端口释放后可以立即被使用(具体参考：http://www.cnblogs.com/mydomain/archive/2011/08/23/2150567.html)。在AbstractConnector中可以使用setReuseAddress方法来配置，默认该值设置为true。

AbstractConnector中还实现了customize方法，它在forwarded设置为true的情况下设置相应的attribute：javax.servlet.request.cipher_suite, javax.servlet.request.ssl_session_id，以及Request中对应Host、Server等头信息。这个逻辑具体含义目前还不是很了解。

文章摘抄至 http://blog.csdn.net/kongxx/article/details/7218787

在嵌入运行Jetty的时候，有时候想要启动两个端口，或者通过一个Jetty server提供多个不同服务，比如说使用8080来指定默认访问端口，使用8433指定https访问端口等等，此时就可以通过创建多个Connector来解决。

SocketConnector实现

有了AbstractConnector的实现，SocketConnector的实现就变的非常简单了，它保存了一个EndPoint的Set，表示所有在这个Connector下正在使用的EndPoint，然后是ServerSocket，在open方法中创建，并在getConnection()方法中返回，还有一个localPort字段，当ServerSocket被创建时从ServerSocket实例中获取，并在getLocalPort()方法中返回。在close方法中关闭ServerSocket，并设置localPort为-2；在accept方法中，调用ServerSocket的accept方法，返回一个Socket，调用configure方法对新创建的Socket做一些基本的配置，然后使用该Socket创建ConnectorEndPoint，并调用其dispatch方法；在customize方法中，在调用AbstractConnector的customize方法的同时还设置ConnectorEndPoint的MaxIdleTime，即设置Socket的SO_TIMEOUT选项，用于配置该Socket的空闲可等待时间；在doStart中会先清理ConnectorEndPoint的集合，而在doStop中会关闭所有还处于打开状态的ConnectorEndPoint。

SelectChannelConnector实现

SelectChannelConnector内部使用ServerSocketChannel，在open方法中创建ServerSocketChannel，配置其为非blocking模式，并设置localPort值；在accept方法中调用ServerSocket的accept方法获得一个SocketChannel，配置该Channel为非blocking模式，调用AbstractChannel的configure方法做相应Socket配置，最后将该SocketChannel注册给ConnectorSelectManager；在doStart方法中，它会初始化ConnectorSelectManager的SelectSets值为acceptors值、MaxIdleTime、LowResourceConnections、LowResourcesMaxIdleTime等值，并启动该Manager，并dispatch acceptors个线程，不断的调用Manager的doSelect方法；在close方法中会先stop ConnectorSelectManager，然后关闭ServerSocketChannel，设置localPort为-2；在customize方法中会清除SelectChannelEndPoint的idleTimestamp，重置其MaxIdleTime以及重置Request中的timestamp的值；在persist方法中会重置SelectChannelEndPoint中idleTimestamp的值。

1. 首先创建一个Server类，其中创建了两个Connector实例，一个绑定到了8080端口，另一个绑定到了9090端口：

package com.google.code.garbagecan.jettystudy.sample2;  
  
import org.eclipse.jetty.server.Connector;  
import org.eclipse.jetty.server.Server;  
import org.eclipse.jetty.server.nio.SelectChannelConnector;  
  
public class MyServer {  
    public static void main(String[] args) throws Exception {  
        Server server = new Server();  
  
        SelectChannelConnector connector1 = new SelectChannelConnector();  
        connector1.setPort(8080);  
  
        SelectChannelConnector connector2 = new SelectChannelConnector();  
        connector2.setPort(9090);  
  
        server.setConnectors(new Connector[] { connector1, connector2 });  
  
        server.setHandler(new HelloHandler());  
  
        server.start();  
        server.join();  
    }  
}

2. 创建一个Handler类，用了处理所有客户端的请求

package com.google.code.garbagecan.jettystudy.sample2;  
  
import java.io.IOException;  
  
import javax.servlet.ServletException;  
import javax.servlet.http.HttpServletRequest;  
import javax.servlet.http.HttpServletResponse;  
  
import org.eclipse.jetty.server.Request;  
import org.eclipse.jetty.server.handler.AbstractHandler;  
  
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>");  
        response.getWriter().println("<li>Request url: " + target + "</li>");  
        response.getWriter().println("<li>Server port: " + request.getServerPort() + "</li>");  
    }  
}

3. 运行MyServer类，通过浏览器分别访问http://localhost:8080/和http://localhost:9090/。

Jetty Connector学习笔记

猜你喜欢