深入Jetty源码之Connector

public  interface Connector  extends LifeCycle { 
     //  Connector名字，默认值hostname:port
    String getName();
     //  打开当前Connector
     void open()  throws IOException;
     //  关闭当前Connector
     void close()  throws IOException;
     //  对Server的引用
     void setServer(Server server);
    Server getServer();

     //  在处理请求消息头时使用的Buffer大小
     int getRequestHeaderSize();
     void setRequestHeaderSize( int size);
     //  在处理响应消息头时使用的Buffer大小
     int getResponseHeaderSize();
     void setResponseHeaderSize( int size);
     //  在处理请求消息内容时使用的Buffer大小
     int getRequestBufferSize();
     void setRequestBufferSize( int requestBufferSize);
     //  在处理响应消息内容使用的Buffer大小
     int getResponseBufferSize();
     void setResponseBufferSize( int responseBufferSize);
     //  在处理请求消息时使用的Buffer工厂
    Buffers getRequestBuffers();
     //  在处理响应消息时使用的Buffer工厂
    Buffers getResponseBuffers();

     // User Data Constraint的配置可以是None、Integral、Confidential，对这三种值的解释：
     // None：A value of NONE means that the application does not require any transport guarantees.
     // Integral：A value of INTEGRAL means that the application requires the data sent between the client and server to be sent in such a way that it can't be changed in transit.
     // Confidential：A value of CONFIDENTIAL means that the application requires the data to be transmitted in a fashion that prevents other entities from observing the contents of the transmission on.
     // In most cases, the presence of the INTEGRAL or CONFIDENTIAL flag indicates that the use of SSL is required. 参考： 这里
     // 如果配置了user-data-constraint为Integral或confidential表示所有相应请求都会重定向到使用Integral/Confidential Schema/Port构建的新的URL中。
     int getIntegralPort();
    String getIntegralScheme();
     boolean isIntegral(Request request);
     int getConfidentialPort();
    String getConfidentialScheme();
     boolean isConfidential(Request request);

     / / 在将HttpConnection交给Server中的Handlers处理前，根据当前Connector，自定义一些EndPoint和Request的配置，如设置EndPoint的MaxIdleTime，Request的timestamp，
     / / 清除SelectChannelEndPoint中的idleTimestamp，检查forward头等。
     void customize(EndPoint endpoint, Request request)  throws IOException;

     / / 主要用于SelectChannelConnector中，重置SelectChannelEndPoint中的idleTimestamp，即重新计时idle的时间。
    / /  它在每个Request处理结束，EndPoint还未关闭，并且当前连接属于keep-alive类型的时候被调用。
     void persist(EndPoint endpoint)  throws IOException;

     / / 底层的链接实例，如ServerSocket、ServerSocketChannel等。
    Object getConnection();
    
     / /是否对"X-Forwarded-For"头进行DNS名字解析
     boolean getResolveNames();
    
     / / 当前Connector绑定的主机名、端口号等。貌似在Connector的实现中没有一个默认的主机名。
     / /  由于端口号可以设置为0，表示由操作系统随机的分配一个还没有被使用的端口，因而这里由LocalPort用于存储Connector实际上绑定的端口号；
     / /  其中-1表示这个Connector还未开启，-2表示Connector已经关闭。
    String getHost();
     void setHost(String hostname);
     void setPort( int port);
     int getPort();
     int getLocalPort();
    
     / / Socket的最大空闲时间，以及在资源比较少(如线程池中的任务数比最大可用线程数要多)的情况下的最大空闲时间，当空闲时间超过这个时间后关闭当前连接(Socket)。
     int getMaxIdleTime();
     void setMaxIdleTime( int ms);
     int getLowResourceMaxIdleTime();
     void setLowResourceMaxIdleTime( int ms);

     / / 是否当前Connector处于LowResources状态，即线程池中的任务数比最大可用线程数要多
     public  boolean isLowResources();

     /*  ------------------------以下是一些获取和当前Connector相关的统计信息------------------------------------  */
     / / 打开或关闭统计功能
     public  void setStatsOn( boolean on);
     / / 统计功能的开闭状态
     public  boolean getStatsOn();
     / / 重置统计数据，以及统计开始时间
     public  void statsReset();
     / / 统计信息的开启时间戳
     public  long getStatsOnMs();

     / / 当前Connector处理的请求数
     public  int getRequests();
     / / 当前Connector接收到过的连接数
     public  int getConnections() ;
     / / 当前Connector所有当前还处于打开状态的连接数
     public  int getConnectionsOpen() ;
     / / 当前Connector历史上同时处于打开状态的最大连接数
     public  int getConnectionsOpenMax() ;
     / / 当前Connector所有连接的持续时间总和
     public  long getConnectionsDurationTotal();
     / / 当前Connector的最长连接持续时间
     public  long getConnectionsDurationMax();
     / / 当前Connector平均连接持续时间
     public  double getConnectionsDurationMean() ;
     / / 当前Connector所有连接持续时间的标准偏差
     public  double getConnectionsDurationStdDev() ;
     / / 当前Connector的所有连接的平均请求数
     public  double getConnectionsRequestsMean() ;
     / / 当前Connector的所有连接的请求数标准偏差
     public  double getConnectionsRequestsStdDev() ;
     / / 当前Connector的所有连接的最大请求数
     public  int getConnectionsRequestsMax();
}

protected  void connectionOpened(Connection connection)
protected  void connectionUpgraded(Connection oldConnection, Connection newConnection)
protected  void connectionClosed(Connection connection)