Servlet基本结构的源码解析(转)

刺骨的言语ヽ痛彻心扉 2021-10-16 01:38 204阅读 0赞

如何写一个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实现了此接口。在下面的源码分析中有详细的解释。

![SouthEast][]

**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的源码：

import 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()。

/\*\*  
 \* 对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)，告诉浏览器直接使用缓存。

import 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容器的对象，具体的解释都在源码中了：

/\*\*  
 \* 在一个Servlet被初始化是被Serlvet容器传递给init方法  
 \* 包含了Servletd的配置信息。它提供了两个方法用于Servlet的初始化参数：  
 \* public String getInitParameter(String name):获取指定参数的值  
 \* public Enumeration<String> getInitParameterNames():获得所有的参数名称，遍历该Enumeration，可获得所有参数  
 \* 不得不吐槽一下，Enumeration都已经被Iterator取代了，竟然还在用这个，真土  
 \* 初始参数是在Servlet的配置中指定的，如下面的示例就指定了名字和年龄，可以通过上面两个方法获得这些值：  
 \* <servlet>  
 \*   <servlet-name>LifeCircle</servlet-name>  
 \*  <servlet-class>com.servlet.base.LifeCircle</servlet-class>  
 \*   <init-param>  
 \*    <param-name>name</param-name>  
 \*     <param-value>caoxiaoyong</param-value>  
 \*  </init-param>  
 \*  <init-param>  
 \*    <param-name>age</param-name>  
 \*    <param-value>25</param-value>  
 \*  </init-param>  
 \*</servlet>  
 \*----------------------------------------------  
 \*还有一个方法用于获取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类。如果认真的分析了上面四个接口或类的源码，我想收获的不止这一点。  
 ————————————————   
**版权声明：本文为CSDN博主「喻红叶」的原创文章，遵循CC 4.0 by-sa版权协议，转载请附上原文出处链接及本声明。  
原文链接：https://blog.csdn.net/yuhongye111/article/details/38946909**

[SouthEast]: /images/20211015/15a78a4abc4b45eca068abf378d14017.png