coder 爱翻译 How Tomcat Works 第三章 第一部分

第三章: Connector

在正式开始这个应用之前，我们先以org.apache.catalina.util包下的StringManager作为开始。这个类用来处理在应用程序中和Cacalina本身错误信息的国际化。

The StringManager Class

一个像Tomcat这样大的应用需要很小心地处理错误信息。Tomcat的错误信息对系统管理员和servlet程序员都是非常有用的。例如：Tomcat的logs错误信息可以让系统管理员很精确地定位异常的发生。对servlet程序员，Tomcat发送javax.servlet.ServletException抛出的特定的错误信息，让程序员知道他的servlet出了什么问题。

Tomcat的解决办法是在properties文件中存储错误信息，所以编辑它们就很容易。但是在Tomcat中有几百个类，存储所有的被使用类的错误信息在一个大的properties文件中很容易为维护带来麻烦(a maintenance nightmare)。为了避免这种情况，Tomcat为每一个包分配一个properties文件。例如：在org.apache.catalina.connector包下的properties文件包含所有在这包下类可能抛出的的错误信息。每个properties文件由org.apache.catalina.util.StringManager类的实例处理。当Tomcat一运行，就会有许多的StringMnager类的实例生成。每一个包对应一个StringManager实例来读取一个properties文件具体内容。由于Tomcat的广泛应用，提供多种语言的错误信息就显得很有必要了。现在支持有三种语言。英语版本的错误信息是叫做LocalStrings.properties的文件。另外两种是西班牙语和日语，分别为：LocalString_es和LocalString_js.properties文件。

当一个包中的类需要在该包的properties文件中查询一个错误信息时，它首先要获得一个StringManager实例。但是，同一个包下面的许多类可能需要一个StringManager。浪费资源来为每一个需要的错误信息的对象来创建一个StringManager实例。
如果你熟悉设计模式，你可以很正确地想到StringManager是一个单例类。唯一的构造函数是private修饰。所以你不能使用new关键字来类的外面实例化它。你可以通过传递一个包名，调用public static getManager方法来获得一个实例。每一个实例以它的包名为key存储在Hashtable中。

private static Hashtable managers = new Hashtable(); 
public synchronized static StringManager getManager(String packageName) { 
StringManager mgr = (StringManager)managers.get(packageName); 
if (mgr == null) { 
mgr = new StringManager(packageName); 
managers.put(packageName, mgr);
}
return mgr; 
}

例如：使用ex03.pyrmont.connector.http包下的StringManager：

StringManager sm = StringManager.getManager("ex03.pyrmont.connector.http");

在ex03.pyrmont.connector.http包下，你可以找到3个properties文件：
LocalStrings.properties, LocalStrings_es.properties 和LocalStrings_ja.properties。这些文件会被StringManager实例使用。使用哪一个文件取决于服务器运行的应用的区域设置。如果你打开LocalStrings.properties文件，第一行没有注释的代码：

httpConnector.alreadyInitialized=HTTP connector has already been initialized

为了获取错误信息，可以使用StringManager类的getString方法。这个方法需要传递一个错误代号码(error code)。

public String getString(String key)

把httpConnector.alreadyInitialized作为参数传递给getString方法返回：
HTTP connector has already been initialized。

The Application

开始这一部分，我们把应用分成模块。连接器模块所包含的类可以分组成为5个类别：

 The connector and its supporting class (HttpConnector and HttpProcessor). 连接器和它支持的类
 The class representing HTTP requests (HttpRequest) and its supporting classes.代表HTTP请求和其支持的类.
 The class representing HTTP responses (HttpResponse) and its supporting classes.代表HTTP响应及其支持的类
 Facade classes (HttpRequestFacade and HttpResponseFacade). Facade类(门面类)
 The Constant class.

核心模块包含2个类：ServletProcessor和StaticResourceProcessor

第二章的HttpServer类是负责等待HTTP请求和生成request和response对象。在这章，等待HTTP请求的任务给了HttpConnector实例，而创建request和response对象的任务分配给了HttpProcessor实例。

在这章，HTTP请求对象就是实现了javax.servlet.http.HttpServletRequest接口的HttpRequest类。一个HttpRequest对象会被转型为一个HttpServletRequest实例，然后传递给servlet的service方法调用。此外，每一个HttpRequest实例必须填充它自己的字段(fields)以便servlet可以使用它们。HttpRequest对象中的包括URI，查询字符串，参数，cookies和其他头部信息等需要被赋值。因为连接器不知道哪个值需要被servlet调用，所以连接器必须解析所有HTTP请求获取的值。但是，解析一个HTTP请求包括字符串和其他操作是有很大开销的，连接器可以保存许多CPU周期以便只解析那些servlet真正只需要的值。例如：如果servlet不需要任何请求参数(不调用getParameter等javax.servlet.http.HttpServletRequest方法)，这时连接器就不需要解析这些从查询字符串或者HTTP请求体的参数。Tomcat的默认连接器更加高效：在servlet到了真的需要的时候才去执行参数解析。

Tomcat默认的连接器和我们这个连接器使用SocketInputStream类来读取从socket的InputStream字节流。SocketInputStream的实例是包装了socket的getInputStream方法返回的java.io.InputStream实例。SocketInputStream类提供2个重要的方法：readRequestLine和readHeader。ReadRequestLine返回一个HTTP请求的第一行内容,例如:URI,方法(POST等)，HTTP版本。因为处理来自socket的输入流的字节流意味着读取第一个字节到最后一个字节。(但是不会向回读取 backwards)，所以readRequestLine必须只被调用一次且必须在调用readHeader方法之后。每次调用readHeader方法是用来获取一个头部信息的name/value对。它会被重复调用，直到读完所有的头信息。readRequestLine的返回值是一个HttpRequestLine实例，readHeader的返回值是一个HttpHeader对象。下面我们讨论HttpRequestLine和HttpHeader类。

HttpProcessor对象创建HttpRequest实例，然后必须填充他们的字段。HttpProcessor类，使用parse方法，解析一个HTTP请求的请求行和头部信息。这些被解析的结果会填充在HttpProcessor对象的字段中。但是，这parse方法不会解析在请求体或查询字符串的参数。这个任务交给了HttpRequest对象自己解决。只有servlet需要一个参数的时候，这个参数它才会在查询字符串或请求体中解析。

我们一下面几个小部分开始详细介绍这个应用：

 Starting the Application 开始这个应用程序
 The Connector  连接器
 Creating an HttpRequest Object 创建一个HttpRequest对象
 Creating an HttpResponse Object 创建一个HttpResponse对象
 Static resource processor and servlet processor 静态资源处理器和servlet处理器
 Running the Application 运行这个应用程序

Starting the Application

从Bootstrap类开始： bootstrap(自举或引导程序)

Listing 3.1: The Bootstrap class 

package ex03.pyrmont.startup; 
import ex03.pyrmont.connector.http.HttpConnector; 
public final class Bootstrap { 
public static void main(String[] args) { 
HttpConnector connector = new HttpConnector(); connector.start();
} 
}

Bootstrap类的主函数实例化了HttpConnector类和调用它的start方法。下面是HttpConnector：

Listing 3.2: The HttpConnector class's start method 

package ex03.pyrmont.connector.http; 
import java.io.IOException; 
import java.net.InetAddress; 
import java.net.ServerSocket; 
import java.net.Socket; 
public class HttpConnector implements Runnable { 
boolean stopped; 
private String scheme = "http"; 
public String getScheme() { 
return scheme;
} 
public void run() { 
ServerSocket serverSocket = null; 
int port = 8080;
try { 
serverSocket = new ServerSocket(port, 1, InetAddress.getByName("127.0.0.1"));
} catch (IOException e) { 
e.printStackTrace(); 
System.exit(1); 
} 
while (!stopped) {
// Accept the next incoming connection from the server socket 
Socket socket = null; 
try { 
socket = serverSocket.accept(); 
} catch (Exception e) { 
continue; 
} 
// Hand this socket off to an HttpProcessor 
HttpProcessor processor = new HttpProcessor(this);
 			processor.process(socket); 
}
} 
public void start() { 
Thread thread = new Thread(this); 
thread.start ();
} 
}