[Servlet]深入研究HttpServlet

HttpServlet概述

在大多数的Web应用程序中，客户端都是通过Http协议去访问服务器端的资源，而我们编写的Servlet主要是用于Http协议的请求和响应处理。为了快速开发应用于Http协议的Servlet类，Sun公司在javax.servlet.http包中提供了一个抽象类HttpServlet，它继承于GenericServlet，用于创建适合基于Http协议的Web Servlet。

public abstract class HttpServlet extends GenericServlet {}

下列表中罗列了HttpServlet的所有方法：

下面我们就针对HttpServlet抽象类中提供的各个方法进行讨论。

重写的service()方法

在HttpServlet类中提供了两种重载的service()方法：

 public abstract class HttpServlet extends GenericServlet {
    @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);
}
    protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        String method = req.getMethod();
        if (method.equals(METHOD_GET)) {
            long lastModified = getLastModified(req);
            maybeSetLastModified(resp, lastModified);
            doGet(req, resp);
        } 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);
        }
}

通过查看HttpServlet的源代码我们可以知道，第一个service()方法是GenericServlet类中的Service()方法的实现。在该service()方法中将ServletRequest和ServletResponse对象转换成HttpServletRequest（继承于ServletRequest接口）和HttpServletResponse（继承于ServletResponse接口），然后调用了第二个service()方法，对客户端的请求进行处理。

在第二个service()方法中，针对Http 1.1协议中定义的7种请求方式Get、Post、Head、Put、Delete、Trace和Options提供了7种处理方法。这7种方法的参数类型及异常抛出类型与HttpServlet类中的第二个service()方法是一致的。当Servlet容器接收到一个针对HttpServlet对象的请求时，调用该对象的方法顺序如下：

• 调用公用service()方法，将参数类型转换成HttpServletRequest和HttpServletResponse，然后调用受保护的service()方法。
• 在受保护的service()方法中，获取Http请求方法的名字，然后根据请求方法的类型，调用响应的doXXX()方法。

因此，我们在自定义Servlet继承于HttpServlet的时候，通常不需要重写service()方法，只需重写响应的doXXX()方法即可。

七种请求处理方法

在HttpServlet抽象类中提供了针对Http 1.1协议中定义的7种请求方式Get、Post、Head、Put、Delete、Trace和Options提供了7种处理方法：

• protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
• protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
• protected void doHead(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
• protected void doPut(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
• protected void doDelete(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
• protected void doTrace(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException
• protected void doOptions(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException

这7种处理请求的方法中，HttpServlet类对Trace和Options方法做了适当的实现，因此我们不需要重写doTrace()和doOptions()方法。而对于其他的5种请求处理方法，HttpServlet类提供的实现都是返回Http错误。对于Http 1.0的客户端请求，这些方法返回的状态码为400，表示客户端发送的请求在语法上是错误的。对于Http 1.1的客户端请求，这些方法返回的状态码为405，表示对于指定资源的请求方法不被允许。

而对于Http协议的实际应用来讲，我们最常用的是Get和Post，所以在自定义Servlet时，常重写doGet()和doPost()两个请求处理方法。其中doGet()方法用来处理Get方式的请求，doPost()方法用来处理Post方式的请求，下面我们通过一个案例来看一看：

• 创建一个HTML页面用于发送客户端请求。

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>index.html</title>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <h1>GET方式请求</h1>
    <form id="userinfo" method="get" action="threeServlet">
        用户名:<input type="text" id="username" name="username">
        <input type="submit" id="submit" value="提交">
    </form>
    <h1>POST方式请求</h1>
    <form id="userinfo" method="post" action="threeServlet">
        用户名:<input type="text" id="username" name="username">
        <input type="submit" id="submit" value="提交">
    </form>
  </body>
</html>

• 创建一个Servlet用于处理请求。

public class ThreeServlet extends HttpServlet {
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("这是GET方式发送的请求,Servlet使用doGet()方法来处理.");
    }
    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("这是POST方式发送的请求,Servlet使用doPost()方法来处理.");
    }
}

• 配置web.xml文件。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" 
    xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  <servlet>
<servlet-name>ThreeServlet</servlet-name>
    <servlet-class>app.java.servlet.ThreeServlet</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>ThreeServlet</servlet-name>
    <url-pattern>/threeServlet</url-pattern>
  </servlet-mapping>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
</web-app>

• 将Web工程发布到Tomcat服务器，并启动Tomcat服务器。
• 打开浏览器，在地址栏中输入http://localhost:8080/08_servlet/index.html。

利用GET方式发送请求，控制台会打印doGet()方法的内容。利用POST方式发送请求，控制台会打印doPost()方法的内容。

转载说明：请注明作者及原文链接，谢谢！