JavaWeb学习-Servlet系列-5-继承HttpServlet类-模板方法设计模式

水深无声 2022-02-03 01:04 358阅读 0赞

这篇来学习实现Servlet的第三中方法，这种方法也是实际项目开发中采用的方法，通过实现HttpServlet类，这种方法也叫模板设计模式。

**1. J2ee API 文档查看HttpServlet类**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTE1NDE5NDY_size_16_color_FFFFFF_t_70][]

需要知道这几点：

1）这个HttpServlet类实现了前面文章介绍的 GenericServlet 类，是这个类的子类。

2）这个HttpServlet类新加了一些doXXX方法，例如doPost和doGet，Post和Get我们知道是http请求方法。

3）继承HttpServlet的类必须需要实现上面截图列出几个方法的一个，待会我们试一试不重新一个方法试试。

4）几乎没有理由重写service方法，我们在文章最后来解释。

**2. 写一个类继承HttpServlet类**

写一个ServletDemo3.java类，继承HttpServlet，这个继承之后默认不需要在子类中重写相关方法的，例如不需要重写service()方法，因为在HttpServlet中已经帮我们重写了servicel方法。

package com.anthony.servlet;
    
    import javax.servlet.http.HttpServlet;
    
    public class ServletDemo3 extends HttpServlet {
    
    }

在web.xml中为这个servlet类添加一个map映射

<?xml version="1.0" encoding="UTF-8"?>
    <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
      
      <servlet>
      	<servlet-name>servletDemo1</servlet-name>
      	<servlet-class>com.anthony.servlet.ServletDemo1</servlet-class>
      </servlet>
      
      
      <servlet-mapping>
      	<servlet-name>servletDemo1</servlet-name>
      	<url-pattern>/demo</url-pattern>
      	
      </servlet-mapping>
      
      <servlet>
      	<servlet-name>servletDemo3</servlet-name>
      	<servlet-class>com.anthony.servlet.ServletDemo3</servlet-class>
      </servlet>
      
      <servlet-mapping>
      	<servlet-name>servletDemo3</servlet-name>
      	<url-pattern>/demo3</url-pattern>
      </servlet-mapping>
      
      <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
      </welcome-file-list>
      
      
    </web-app>

重新发布到tomcat服务器，浏览器输入 http://localhost:8080/Servlet01/demo3

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTE1NDE5NDY_size_16_color_FFFFFF_t_70 1][]

首先，看到这个报错是正常的，不是代码问题，因为在HttpServlet类中自己实现的service方法就是这样代码逻辑实现的，下面我们看源码来解释。

**4.阅读HttpServlet类源码**

这里我们来找一找我们浏览器为社么要给显示一个“HTTP method GET is not supported by this URL”的错误。在Eclipse上点击HttpServlet进入到这个类的源码，找到下面重写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);
        }

我们看到@Override就明白，HttpServlet类重写了Servlet接口的service方法。所以在运行ServletDemo3的实例过程中，本来是执行servlet接口的service方法，但是由于HttpServlet重写这个方法，所以变成执行这个子类重写的service方法。HttpServletRequest是ServletRequest的子类，同理HttpServletResponse。先是在try语句块中，把父类带来参数req和res强制转换成HttpServletRequest和HttpServletResponse对象。如果不是http请求或者响应就报异常。关键最后还是调用了一个service()方法，这个service是HttpServlet中自己新写的一个重载方法。所以，我们去看这个重载方法的源码。

protected void service(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {
    
            String method = req.getMethod();
    
            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_POST)) {
                doPost(req, resp);
        }

我上面删除了其他Http请求类型的代码，我们只看doGet和doPost。一上来，执行 String method = req.getMethod(); 来获取请求消息行中的请求方法是什么。下面继续走，如果这个请求是Get方法，就去执行doGet(req, resp);， 下面我们跳转到doGet()方法去看源码。

protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException
        {
            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);
            }
        }

在这个doGet方法中，先获取协议是不是http/1.1, 然后判断，如果是http/1.1，就执行resp.sendError(）的方法，接下来我们来看看这个msg的内容是什么。我们找到apache-tomcat-8.5.40-src.zip文件（前面文章解释过去tomcat网站下载这个文件），解压到本地，然后找到这个文件路径去打开资源文件apache-tomcat-8.5.40-src\\java\\javax\\servlet\\http

http.method_get_not_supported=HTTP method GET is not supported by this URL
    http.method_post_not_supported=HTTP method POST is not supported by this URL
    http.method_put_not_supported=HTTP method PUT is not supported by this URL
    http.method_delete_not_supported=Http method DELETE is not supported by this URL

第一行这个字符串就是我们在浏览器中出现的字符串，提醒以下，这里获取资源文件的key和value就是使用了ResourceBundle这个类。

**5. 重写doGet和doPost方法**

上面我们实验过继承HttpServlet类但是不重写任何方法的效果，现在我们知道了浏览器为什么报这个错误，所以需要重写几个方法，让打印消息改成我们自己的msg。

package com.anthony.servlet;
    
    import java.io.IOException;
    
    import javax.servlet.ServletException;
    import javax.servlet.http.HttpServlet;
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    
    public class ServletDemo3 extends HttpServlet {
    
    	@Override
    	protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    		System.out.println("************Run doGet************");
    		
    	}
    
    	@Override
    	protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    		System.out.println("************Run doGet************");
    	}
    	
    }

重新发布到tomcat服务区，浏览器打开页面，就不会报错，显示一个空白页，而且Eclipse控制台输出“Run doGet”。 因为我们写的类重写了doGet和doPost方法，所以运行过程，运行到HttpServlet中doGet()方法就会调用我们重写的方法。

**5. 为什么不能重写service方法**

因为HttpServlet类中的serivce方法是实现了模板方法，如果你写Servlet类继承了HttpServlet类，那么重写servic方法之后就失去了模板方法的意义。这种模板方法的设计模式，就是我们实际项目中开发采用的方法。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTE1NDE5NDY_size_16_color_FFFFFF_t_70]: /images/20220203/2dd2f34092c14ca1858c04b72097a099.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTE1NDE5NDY_size_16_color_FFFFFF_t_70 1]: /images/20220203/3cab068c42184a2293b40b6d90d9cbfc.png