循序渐进写一个 Servlet (1) - 介绍相关的接口和类

发表于 更新于 分类于 Waline： 阅读次数：

Servlet（Server Applet），全称 Java Servlet，是用 Java 编写的服务器端程序。其主要功能在于交互式地浏览和修改数据，生成动态 Web 内容。本系列将一步步地写出一个 Servlet 程序。

这篇博文将介绍一些后面会用到的接口和类。

常用的类和接口

javax.servlet.Servlet

javax.servlet.Servlet 是一个接口，它定义了一个 servlet 必须要实现的方法，包括如何初始化一个 servlet，如何让这个 servlet 处理请求，以及如何将这个 servlet 从容器中移除，即 “生命周期方法”。它们被调用的顺序，即 servlet 的生命周期，是这样的：

  1. 容器生成这个 servlet 的对象，然后调用其 init() 方法完成初始化步骤
  2. 当收到请求之后，会调用其 service() 方法来处理请求
  3. 当这个 servlet 停止服务时，destroy() 方法会被调用并准备销毁

Servlet 的启动时间由 web.xml 中 load-on-startup 属性决定，当值为负数或未设定该属性时，容器可以自由决定何时初始化该 servlet；当值为零或正整数时，容器需要在启动时就初始化该 servlet，此时该属性的值代表初始化的优先级，值越小优先级越高，对于有相同优先级的 servlet，容器可以自行决定加载顺序。

当应用被重新部署，或者在容器停机时，servlet 会被销毁，同时 servet 无法被手动销毁。

除了生命周期方法外，Servlet 接口还有两个方法：

  1. getServletConfig() 可以让 servlet 取到启动相关的信息
  2. getServletInfo() 用来获取 servlet 相关的信息，如作者、版本号、版权信息等

javax.servlet.GenericServlet

GenericServlet 类是一个抽象类，定义了一个协议无关的，通用的 servlet 实现。

它预置了 ServletConfig 接口的实现，并且简易实现了 Servlet 接口中的 init() 方法和 destroy() 方法，开发人员只需要覆盖 service() 方法。

javax.servlet.http.HttpServlet

HttpServlet 类提供了一个用于处理 HTTP 请求的 servlet 基类。一个 HttpServlet 的子类至少需要覆盖一个方法，而且通常是覆盖如下几个方法：

  1. doGet()，以实现对 HTTP GET 请求的处理
  2. doPost()，以实现对 HTTP POST 请求的处理
  3. doPut()，以实现对 HTTP PUT 请求的处理
  4. doDelete()，以实现对 HTTP DELETE 请求的处理
  5. init() 和 destroy()，以管理 servlet 生命周期内所需的资源
  6. getServletInfo()，可以用来自定义 servlet 返回哪些关于自身的信息

此外，不建议直接覆盖 service() 方法，因为 HttpServlet#service() 方法中已经实现了根据 HTTP 请求类型调用对应的 doXXX() 方法。

如果某个 HTTP 方法对应的 doXXX() 方法没有被覆盖，则视为该 servlet 不支持这个 HTTP 方法。如在没有覆盖 doGet() 时收到 HTTP GET 请求，则会返回 HTTP 405 METHOD NOT ALLOWED (对应HTTP 1.1) 错误码，或 HTTP 400 BAD REQUEST (对应其他HTTP版本) 错误码。

需要注意的是，HttpServlet 类并没有实现 HTTP CONNECT 和 HTTP PATCH 方法。当请求这两个方法，或其他非标准方法时，将会返回 HTTP 501 NOT IMPLEMENTED 错误码。

常用的常量

  • HTTP 方法相关的常量位于 HttpServlet 类中，是 String 类型，命名规则为 METHOD_方法，如 METHOD_GET
  • HTTP 状态码相关的常量位于 HttpServletResponse 类中，是 int 类型，命名规则为 SC_状态码名，如 SC_OK、SC_NOT_FOUND

系列博文