Servlet源码解析初步

­ 如何写一个Servlet类？围绕这个问题，可以看一下Servlet的类结构。首先Servlet类也是一个Java类，只不过这个类比较特殊，它不能单独运行，必须要依托Servlet容器才能运行，Servlet类是一个组件，供Servlet引擎调用。既然是这样，那么Servlet类和Servlet引擎必然要遵循一套规范，以约束彼此的行为，遵循规范编写的Servlet类可以运行在任何符合规范的Servlet引擎上。那我们就看看，如何编写一个符合规范的Servlet。首先看一下要编写一个Servlet基本类图的结构（图是从网上找的）：

其中Servlet接口是所有Servlet的父接口，Servlet规范为了方便实现Servlet类，提供了一个抽象类GenericServlet，它提供了Servlet的默认实现，可以通过继承自GenericServlet类来简化编程。Servlet主要是处理Http请求的，所以有提供了HttpServlet，它继承自GenericServlet，一般来说，我们编写的大部分Servlet都继承自HttpServlet。在上边的类图结构中，ServletConfig接口封装了代表Servlet容器的对象（ServletContext）,和Servlet初始化信息，为了方便编程GenericServlet实现了此接口。在下面的源码分析中有详细的解释。
Servlet的生命周期
Servlet相当与Servlet容器的组件，Servlet接口定义了三个方法用于实现Servlet的声明周期，分别是：
（1）初始化init(ServletConfig config)：每个Servlet只能初始化一次，初始化的时候，Servlet引擎将一个ServletConfig对象传递进来，里面包含了这个Servlet的初始化参数，具体的Servlet类应该使用一个私有引用保存这个config。Servlet可以有构造方法，init在构造方法之后执行；
（2）处理请求service(ServletRequest,ServletResponse)：只有在init方法成功执行后才能处理请求，每次请求都会调用service方法；
（3）销毁destroy()：当要从容器中移除该Servlet时，会调用destroy方法，用来关闭资源，做一些清理工作，只调用一次。
同时Servlet接口还定义了getServletConfig()方法，就是返回init方法中传递进来的config，下面是Servlet的源码：

[java] view plain copyimport java.io.IOException;  /**  * 所有servlet都要实现的接口  * Servlet是供Servlet引擎调用的Java类，它相当于Servlet引擎的组件  * 在Servlet接口中定义了三个方法，也被称为Servlet的声明周期：  * void init(ServletConfig config):Servlet被初始化时被Servlet引擎调用，只执行一次，且后于构造方法  * void service(ServletRequet,ServletResponse)：响应请求，每当有一个请求，Servlet引擎就调用该方法  * void destroy():Servlet被销毁时被Servlet引擎调用，用于关闭资源等服务  * 以上三个方法都是被Servlet引擎（容器）调用  * 除了以上方法之外，还提供了个方法：  * ServletConfig getServletConfig:一个ServletConfig对象，在init方法被传递进来，包含了Servlet的初始化信息和  * 代表Servlet容器的对象(ServletContext)  * String getServletInfo():返回该Servlet的基本信息  */  public interface Servlet {      /**      * 被servlet引擎调用用于初始化该Servlet，只有在该方法完成之后，才能响应请求      * 如果init方法抛出了异常，则一定不能响应请求。init方法在构造方法之后执行。      * Servlet引擎会把ServletConfig对象传进来      */      public void init(ServletConfig config) throws ServletException;      /**      * 返回ServletConfig对象，其中包含着初始化信息和初始化参数      * @see #init      */      public ServletConfig getServletConfig();      /**      * 响应请求，必须在init(Servletconfig config)成功后才能执行      */      public void service(ServletRequest req, ServletResponse res)              throws ServletException, IOException;      /**返回基本信息*/      public String getServletInfo();      /**      * 被Servlet引擎调用，用来关闭资源，或者做一些清楚工作      */      public void destroy();  }  

Servlet的默认实现

GenericServlet实现了Servlet接口，同时也实现了ServletConfig接口，之所以实现ServletConfig接口是为了方便编程。下面代码中的注释已经很清楚了，不过还是要说一下init方法，在GenericServlet中提供了两个init方法：
（1）重写Servlet接口的init(ServletConfig config)方法，GenericSerlvet内部用私有属性保存此config，初始化工作调用无参的init()方法；
（2）重载的无参init()方法，子类应该覆盖这个方法，它会被有参数的init方法调用。之所以这么设计是为了方便编程，前面提到，如果重写父类的init(ServletConfig)方法，需要调用super.init(config)，或者自己保存config，没必要增加这麻烦，直接继承自无参的init。Servlet引擎调用的init(ServletConfig)方法，而在init(ServletConfig)在最后调用了无参的init()。

[java] view plain copy/**  * 对Servlet接口的方法提供了默认是实现，通过继承GenericServlet方法，可以方便别写Servlet  * 1.首先需要注意的一点是它实现了ServletConfig接口，在Servlet的init(ServletConfig config)方法  * 中，Servlet容器会把一个ServletConfig传递进来，但是这个config只能在init()方法中使用，如果想在其他  * 方法中是使用，则需要使用一个似有引用把config保存起来,供getServletConfig()调用。  * GenericServlet也是这样做的，它有一个ServletConfig属性，在init(ServletConfig config)中  * 保存传递进来的config。  * 但同时它还实现了ServletConfig接口，这样做的目的是方便编程，在需要使用ServletConfig的方法时，  * 无需先获得ServletConfig对象，而可以直接使用这些方法。其实GenericServlet也仅仅是简单的调用  * config的相关方法，相当于一个代理。  *   * 2.GenericServlet实现了两个init方法  * 一个是重写Serlvet接口的init(ServletConfig)方法，使用该方法获得ServletConfig对象  * 它会在最后调用无参的init()方法；  * 一个是重载的无参init()方法  * 子类应该选择重写无参的init()方法，为什么呢？  * 如果重写init(ServletConfig)方法，那么首先需要在第一行调用super(config)  * 要不然，就得自己去保存传递进来的ServletConfig对象，增加不必要的麻烦  * 其次，重写无参的init()方法，会被有参数的init(ServletConfig)调用，达到同样的目的  * 结论：无参的init()方法就是为了方便子类覆盖  */  public abstract class GenericServlet implements Servlet, ServletConfig,          java.io.Serializable {      private static final long serialVersionUID = 1L;      private transient ServletConfig config;      public GenericServlet() {          // NOOP      }      @Override      public void destroy() {          // NOOP by default      }      /**实现ServletConfig接口的方法*/      public String getInitParameter(String name) {          return getServletConfig().getInitParameter(name);      }      public Enumeration<String> getInitParameterNames() {          return getServletConfig().getInitParameterNames();      }      @Override      public ServletContext getServletContext() {          return getServletConfig().getServletContext();      }      @Override      public String getServletName() {          return config.getServletName();      }      @Override      public ServletConfig getServletConfig() {          return config;      }      @Override      public String getServletInfo() {          return "";      }      /**      * 注意，这个方法会在最后调用无参的init()方法      * 子类应该选择覆盖init()方法      */      @Override      public void init(ServletConfig config) throws ServletException {          this.config = config;          this.init();      }      /**默认空实现，子类如果要覆盖init方法的话，应该选择覆盖此方法      * init(ServletConfig)会在最后调用这个方法      * */      public void init() throws ServletException {          // NOOP by default      }      public void log(String msg) {          getServletContext().log(getServletName() + ": " + msg);      }      public void log(String message, Throwable t) {          getServletContext().log(getServletName() + ": " + message, t);      }      @Override      public abstract void service(ServletRequest req, ServletResponse res)              throws ServletException, IOException;  }  

处理HTTP请求

为了方便处理HTTP请求，Servlet规范定义了HttpServlet抽象类，通过实现HttpServlet类可以把重点放到业务逻辑的实现上，而不是去处理和Servlet引擎的交互。HttpServlet针对每种HTTP的请求方式都提供了具体的doXXX方法，其中最常用的还是doGet和doPost方法。在理解HttpServlet类时，最重要的是理解Servlet的生命周期，Servlet引擎在处理请求是调用的是哪个方法？是Servlet接口规定的service(ServletRequest,ServletResponse)方法，在HttpServlet类中，处理请求的方法依然是首先调用service方法，service方法根据不同的请求方式，把请求转发到具体的doXXX方法中。
在这里有两个HTTP字段需要注意，一个是响应实体首部Last-Modified，表示Servlet的修改时间；一个是请求头部，If-Modified-Since，如果资源在指定的时间之后没有修改过，那么表示缓存有效，可以直接使用缓存。HttpServlet.getLastModified()方法用于返回当前内容修改的时间。Service在处理请求时，需要根据其返回值的不同需要做相应的处理：
（1）如果其返回值是-1，则二话不说，直接响应本次请求；
（2）如果是一个正数，且请求头中没有If-Modified-Since字段，或者If-Modified-Since字段表示的时间比getLastModified()返回的之间旧，表示缓存无效，需要处理本次请求。比如，如果当前修改时间是2014年9月1日，请求头中的If-Modified-Since表示的时间是2014年8月1日，也就是说请求中这样说到：如果在2014年8月1日之后没有修改过资源，那么缓存有效。但是很明显，这种情形下，缓存已经失效了。同时把Last-Modified字段写入响应头中
（3）返回值是整数，但是请求头中If-Modified-Since表示的时间新于getLastModified()表示的时间，那么表示缓存有效，服务器直接返回一个304(Not Modified)，告诉浏览器直接使用缓存。

[java] view plain copyimport java.io.IOException;  import java.io.OutputStreamWriter;  import java.io.PrintWriter;  import java.io.UnsupportedEncodingException;  import java.lang.reflect.Method;  import java.text.MessageFormat;  import java.util.Enumeration;  import java.util.ResourceBundle;  import javax.servlet.GenericServlet;  import javax.servlet.ServletException;  import javax.servlet.ServletOutputStream;  import javax.servlet.ServletRequest;  import javax.servlet.ServletResponse;  /**  * 会方便处理HTTP请求的Servlet而提供的抽象类，继承了GenericServlet  * 我们写的绝大多数Servlet都应该继承自HttpServlet  * HttpServlet根据不同的http请求提供了不同的方法：  * doGet:如果servlet支持http GET方法  * doPost:如果servlet支持http POST方法  * 以上两个方法最常用，其他的还有doPut,doDelete,doHead,doOptions,doTrace  *  * @author  Various  */  public abstract class HttpServlet extends GenericServlet {      private static final long serialVersionUID = 1L;      //HTTP的各种方法      private static final String METHOD_DELETE = "DELETE";      private static final String METHOD_HEAD = "HEAD";      private static final String METHOD_GET = "GET";      private static final String METHOD_OPTIONS = "OPTIONS";      private static final String METHOD_POST = "POST";      private static final String METHOD_PUT = "PUT";      private static final String METHOD_TRACE = "TRACE";      private static final String HEADER_IFMODSINCE = "If-Modified-Since";      private static final String HEADER_LASTMOD = "Last-Modified";      private static final String LSTRING_FILE =          "javax.servlet.http.LocalStrings";      private static ResourceBundle lStrings =          ResourceBundle.getBundle(LSTRING_FILE);      /**      * 被service()方法调用去处理GET请求      * 重写此方法以支持GET请求同样也自动的支持HEAD请求      * 一个HEAD请求就是一个GET请求，只不过HEAD请求只返回首部，不返回响应实体部分      * 子类如果要支持GET方法，就必须要重写次方法，因为HttpServlet的默认实现是      * 发送错误      */      protected void doGet(HttpServletRequest req, HttpServletResponse resp)          throws ServletException, IOException      {          //返回使用的协议，protocol/majorVersion,如HTTP/1.1          String protocol = req.getProtocol();          String msg = lStrings.getString("http.method_get_not_supported");          //由于是默认实现，根据不同的协议，直接报错          if (protocol.endsWith("1.1")) {              resp.sendError(HttpServletResponse.SC_METHOD_NOT_ALLOWED, msg);          } else {              resp.sendError(HttpServletResponse.SC_BAD_REQUEST, msg);          }      }      /**      * 返回的值代表当前输出响应内容的修改时间，总是返回-1，子类可重写      * getLastModified方法是一个回调方法，由HttpServlet的service方法调用，      * service方法可以根据返回值在响应消息中自动生成Last_Modified头字段（最后被修改的时间）      * Servlet受到一个GET方式的请求时，HttpServlet重载的service方法在调用doGet之前，会先      * 调用本方法，并根据返回值来决定是否调用doGet方法和在响应消息是是否生成Last_Modified字段      * 具体规则如下：      * 1.如果是一个负数（本方法默认实现），直接调用doGet方法      * 2.如果是一个正数，且请求消息中没有包含If-Modified-Since请求头，或者请求头中的时间值      *   比返回值旧时,这说明要么是第一次请求，要么是缓存过期了，service将根据返回值生成一个      *   Last-Modified字段，并调用doGet方法      * 3.本方法返回值是一个正数，且请求消息中包含的If-Modified-Since的时间值比返回值新或者相同，      * 说明缓存有效,service方法将不调用doGet方法，而是返回304(Not Modified)告诉浏览器缓存仍然有效      */      protected long getLastModified(HttpServletRequest req) {          return -1;      }     /**     * 没有相应实体，其他与GET方法相同，也正是通过调用doGet来完成请求     */      protected void doHead(HttpServletRequest req, HttpServletResponse resp)          throws ServletException, IOException {          //本类的内部类          NoBodyResponse response = new NoBodyResponse(resp);          doGet(req, response);          response.setContentLength();      }      /**      * 也是被service方法调用，默认实现是报错,参考doGet方法      */      protected void doPost(HttpServletRequest req, HttpServletResponse resp)          throws ServletException, IOException {          String protocol = req.getProtocol();          String msg = lStrings.getString("http.method_post_not_supported");          if (protocol.endsWith("1.1")) {              resp.sendError(HttpServletResponse.SC_METHOD_NOT_ALLOWED, msg);          } else {              resp.sendError(HttpServletResponse.SC_BAD_REQUEST, msg);          }      }      /**      * 被Servlet容器调用，完成请求      * 把请求转发到具体的方法上，通过调用重载的service(HttpServletRequest,HttpServletResponse)      * 完成这个方法做的事情就是把request和response转换成HttpServerRequest,HttpServletResponse,      * 具体的转发工作由重载的service方法完成      */      @Override      public void service(ServletRequest req, ServletResponse res)          throws ServletException, IOException {          HttpServletRequest  request;          HttpServletResponse response;          try {              request = (HttpServletRequest) req;              response = (HttpServletResponse) res;          } catch (ClassCastException e) {              throw new ServletException("non-HTTP request or response");          }          service(request, response);      }      /**      * 处理标准的HTTP请求，此方法把具体的请求转发到相应的doXXX方法上      * 被service(ServletRequest，ServletResponse)调用      * 没有理由重写此方法      */      protected void service(HttpServletRequest req, HttpServletResponse resp)          throws ServletException, IOException {          //返回HTTP的请求方式，如GET,POST,HEAD          String method = req.getMethod();          /**          * 如果是GET方式          * 1.首先通过getLastModified(req)获得修改时间          *  i.如果修改时间==-1，不管请求是怎样的，直接调用doGet          *  ii.如果不是-1，则需要获取请求中的If-Modified_Since的值，保存到ifModifiedSince变量中          *     如果请求头中没有If-Modified-Since字段，则ifModifiedSince=-1,通过比较lastModified          *     和ifModifiedSince的值来判断缓存是否过期:          *     如果lastModified代表的日期比ifModifiedSince代表的日期新时，则说明缓存失效了，          *     比如lastModified代表9月1号修改的，ifModifiedSince为8月1号，           *     意思是如果自8月1号没有修改过的话,则可以使用缓存，很明显已经修改过了，          *     所以不能使用缓存,这个时候要调用doGet方法响应，同时在相应头设置Last-Modified的值。          *     如果lastModified代表的时间比ifModifiedSince旧时，也就是没有修改过，          *     则返回304（Not Modified）告诉浏览器，直接使用缓存。          * 2.判断是何种方式，调用具体的doXXX方法          *               */          if (method.equals(METHOD_GET)) {              long lastModified = getLastModified(req);              if (lastModified == -1) {                  // servlet doesn't support if-modified-since, no reason                  // to go through further expensive logic                  doGet(req, resp);              } else {                  long ifModifiedSince;                  try {                      ifModifiedSince = req.getDateHeader(HEADER_IFMODSINCE);                  } catch (IllegalArgumentException iae) {                      // Invalid date header - proceed as if none was set                      ifModifiedSince = -1;                  }                  if (ifModifiedSince < (lastModified / 1000 * 1000)) {                      // If the servlet mod time is later, call doGet()                      // Round down to the nearest second for a proper compare                      // A ifModifiedSince of -1 will always be less                      maybeSetLastModified(resp, lastModified);                      doGet(req, resp);                  } else {                      resp.setStatus(HttpServletResponse.SC_NOT_MODIFIED);                  }              }          } else if (method.equals(METHOD_HEAD)) {              long lastModified = getLastModified(req);              maybeSetLastModified(resp, lastModified);              doHead(req, resp);          } else if (method.equals(METHOD_POST)) {              doPost(req, resp);          } else if (method.equals(METHOD_PUT)) {              doPut(req, resp);          } else if (method.equals(METHOD_DELETE)) {              doDelete(req, resp);          } else if (method.equals(METHOD_OPTIONS)) {              doOptions(req,resp);          } else if (method.equals(METHOD_TRACE)) {              doTrace(req,resp);          } else {              //没有适合的响应方法，只能报错了              String errMsg = lStrings.getString("http.method_not_implemented");              Object[] errArgs = new Object[1];              errArgs[0] = method;              errMsg = MessageFormat.format(errMsg, errArgs);              resp.sendError(HttpServletResponse.SC_NOT_IMPLEMENTED, errMsg);          }      }      /*      * 设置响应的实体首部字段Lat-Modified      */      private void maybeSetLastModified(HttpServletResponse resp,                                        long lastModified) {          if (resp.containsHeader(HEADER_LASTMOD))              return;          if (lastModified >= 0)              resp.setDateHeader(HEADER_LASTMOD, lastModified);      }  }  

ServletConfig

ServletConfig封装了Serlvet的初始化参数，同时其内部包含代表Servlet容器的对象，具体的解释都在源码中了：
[java] view plain copy

/**
* 在一个Servlet被初始化是被Serlvet容器传递给init方法
* 包含了Servletd的配置信息。它提供了两个方法用于Servlet的初始化参数：
* public String getInitParameter(String name):获取指定参数的值
* public Enumeration getInitParameterNames():获得所有的参数名称，遍历该Enumeration，可获得所有参数
* 不得不吐槽一下，Enumeration都已经被Iterator取代了，竟然还在用这个，真土
* 初始参数是在Servlet的配置中指定的，如下面的示例就指定了名字和年龄，可以通过上面两个方法获得这些值：
*
* LifeCircle
* com.servlet.base.LifeCircle
*
* name
* caoxiaoyong
*
*
* age
* 25
*
*
*———————————————-
*还有一个方法用于获取Serlvet容器的对象:
*public ServletContext getServletContext()
*/
public interface ServletConfig {

/**返回Servlet的名称 */  public String getServletName();  public ServletContext getServletContext();  public String getInitParameter(String name);  public Enumeration<String> getInitParameterNames();  

}
通过上面的分析，我们应该能很清晰的回答如何编写一个Servlet类了：如果是处理Http请求，则继承自HttpServlet类，并根据请求方法去覆盖相应的doXXX方法；如果不是Http请求，则继承GenericServlet类。如果认真的分析了上面四个接口或类的源码，我想收获的不止这一点。