Tomcat源码学习(16)How Tomcat works（转）

创建一个HttpResponse对象

    HttpResponse类实现了javax.servlet.http.HttpServletResponse。跟随它的是一个叫做HttpResponseFacade的façade类。Figure 3.3显示了HttpResponse类和它的相关类的UML图。

    在第2章中，你使用的是一个部分实现的HttpResponse类。例如，它的getWriter方法，在它的其中一个print方法被调用的时候，返回一个不会自动清除的java.io.PrintWriter对象。在本章中应用程序将会修复这个问题。为了理解它是如何修复的，你需要知道Writer是什么东西来的。
    在一个servlet里边，你使用PrintWriter来写字节。你可以使用任何你希望的编码，但是这些字节将会以字节流的形式发送到浏览器去。因此，第2章中ex02.pyrmont.HttpResponse类的getWriter方法就不奇怪了：

public PrintWriter getWriter() {
// if autoflush is true, println() will flush,
// but print() will not.
// the output argument is an OutputStream
   writer = new PrintWriter(output, true);
   return writer;
}

    请看，我们是如何构造一个PrintWriter对象的?就是通过传递一个java.io.OutputStream实例来实现的。你传递给PrintWriter的print或println方法的任何东西都是通过底下的OutputStream进行发送的。
    在本章中，你为PrintWriter使用ex03.pyrmont.connector.ResponseStream类的一个实例来替代
OutputStream。需要注意的是，类ResponseStream是间接的从类java.io.OutputStream传递过去的。
    同样的你使用了继承于PrintWriter的类ex03.pyrmont.connector.ResponseWriter。
类ResponseWriter覆盖了所有的print和println方法，并且让这些方法的任何调用把输出自动清除到底下的
OutputStream去。因此，我们使用一个带底层ResponseStream对象的ResponseWriter实例。
    我们可以通过传递一个ResponseStream对象实例来初始化类ResponseWriter。然而，我们使用一个java.io.OutputStreamWriter对象充当ResponseWriter对象和ResponseStream对象之间的桥梁。
    通过OutputStreamWriter，写进去的字符通过一种特定的字符集被编码成字节。这种字符集可以使用名字来设定，或者明确给出，或者使用平台可接受的默认字符集。write方法的每次调用都会导致在给定的字符上编码转换器的调用。在写入底层的输出流之前，生成的字节都会累积到一个缓冲区中。缓冲区的大小可以自己设定，但是对大多数场景来说，默认的就足够大了。注意的是，传递给write方法的字符是没有被缓冲的。
    因此，getWriter方法如下所示:

public PrintWriter getWriter() throws IOException {
   ResponseStream newStream = new ResponseStream(this);
   newStream.setCommit(false);
   OutputStreamWriter osr =
       new OutputStreamWriter(newStream, getCharacterEncoding());
   writer = new ResponseWriter(osr);
   return writer;
}

静态资源处理器和Servlet处理器

    类ServletProcessor类似于第2章中的类ex02.pyrmont.ServletProcessor。它们都只有一个方法：process。然而ex03.pyrmont.connector.ServletProcessor中的process方法接受一个HttpRequest和
HttpResponse，代替了Requese和Response实例。下面是本章中process的方法签名：

public void process(HttpRequest request, HttpResponse response) {

    另外，process方法使用HttpRequestFacade和HttpResponseFacade作为
request和response的facade类。另外，在调用了servlet的service方法之后，它调用了类HttpResponse的
finishResponse方法。

servlet = (Servlet) myClass.newInstance();
HttpRequestFacade requestPacade = new HttpRequestFacade(request);
HttpResponseFacade responseFacade = new HttpResponseFacade(response);
servlet.service(requestFacade, responseFacade);
((HttpResponse) response).finishResponse();

    类StaticResourceProcessor几乎等同于类ex02.pyrmont.StaticResourceProcessor。

运行应用程序

   要在Windows上运行该应用程序，在工作目录下面敲入以下命令：

java -classpath ./lib/servlet.jar;./ ex03.pyrmont.startup.Bootstrap

    在Linux下，你使用一个冒号来分隔两个库：

java -classpath ./lib/servlet.jar:./ ex03.pyrmont.startup.Bootstrap

    要显示index.html，使用下面的URL:

http://localhost:808O/index.html

    要调用PrimitiveServlet，让浏览器指向下面的URL：

http://localhost:8080/servlet/PrimitiveServlet

    在你的浏览器中将会看到下面的内容：

Hello. Roses are red.
Violets are blue.

    注意：在第2章中运行PrimitiveServlet不会看到第二行。
    你也可以调用ModernServet，在第2章中它不能运行在servlet容器中。下面是相应的URL：

http://localhost:8080/servlet/ModernServlet

    注意：ModernServlet的源代码在工作目录的webroot文件夹可以找到。
    你可以加上一个查询字符串到URL中去测试servlet。加入你使用下面的URL来运行ModernServlet的话，将显示Figure 3.4中的运行结果。

http://localhost:8080/servlet/ModernServlet?userName=tarzan&password=pwd

Figure 3.4: Running ModernServlet

总结

    在本章中，你已经知道了连接器是如何工作的。建立起来的连接器是Tomcat4的默认连接器的简化版本。正如你所知道的，因为默认连接器并不高效，所以已经被弃用了。例如，所有的HTTP请求头部都被解析了，即使它们没有在servlet中使用过。因此，默认连接器很慢，并且已经被Coyote所代替了。Coyote是一个更快的连接器，它的源代码可以在Apache软件基金会的网站中下载。不管怎样，默认连接器作为一个优秀的学习工具，将会在第4章中详细讨论。