JavaWeb三大组件之Servlet

JavaWeb有三大组件：Servlet、Listener、Filter。本文将介绍Servlet，主要从Servlet的简单介绍、调用图、生命周期、使用方法、与Servlet有关的常用对象等进行介绍。一直想写一篇关于Servlet的总结很久了，但因为Servlet的内容比较多，也比较重要，所以一直拖到现在。

一、Servlet简介

什么是Servlet？

Servlet是运行在Web服务器或应用服务器上的程序，它是作为来自Web浏览器或其他HTTP客户端的请求和HTTP服务器上的数据库或应用程序之间的中间层。

Servlet任务

Servlet主要执行以下任务：

• 读取客户端（浏览器）发送的显式的数据。这包括网页上的 HTML 表单，或者也可以是来自 applet 或自定义的 HTTP 客户端程序的表单。
• 读取客户端（浏览器）发送的隐式的 HTTP 请求数据。这包括 cookies、媒体类型和浏览器能理解的压缩格式等等。
• 处理数据并生成结果。这个过程可能需要访问数据库，执行 RMI 或 CORBA 调用，调用 Web 服务，或者直接计算得出对应的响应。
• 发送显式的数据（即文档）到客户端（浏览器）。该文档的格式可以是多种多样的，包括文本文件（HTML 或 XML）、二进制文件（GIF 图像）、Excel 等。
• 发送隐式的 HTTP 响应到客户端（浏览器）。这包括告诉浏览器或其他客户端被返回的文档类型（例如 HTML），设置 cookies 和缓存参数，以及其他类似的任务。

即Servlet通常需要做的事情就是接受请求、处理请求、做出响应。

二、Servlet调用图及生命周期

Servlet调用图

Servlet调用图如下：

Servlet生命周期

Servlet生命周期即Servlet从创建到销毁的整个过程，主要包括这几个过程：

• 调用init()方法进行初始化；
• 调用service()方法处理客户端请求；
• 调用destroy()方法终止；
• 最后被JVM的垃圾回收器回收。

重点是service()方法，我们主要通过该方法完成对客户端的请求进行处理及响应。

三、使用方法

Servlet是一个接口，sun公司提供了两个默认实现该接口的类：GenericServlet、HttpServlet。而我们实际开发中，主要用到了HttpServlet这个类，HttpServlet指能够处理HTTP请求的servlet，它在原有Servlet接口上添加了一些与HTTP协议处理方法，它比Servlet接口的功能更为强大。
HttpServlet在实现Servlet接口时，重写了service()方法，该方法体内的代码会自动判别用户的请求方式，如GET请求时，则调用doGet()方法；POST请求时，则调用doPost()方法。因此，当我们实际开发时，主要通过定义类继承HttpServlet，然后重写其中的doGet()、doPost()等方法来处理请求，而不是直接重写service()方法。下面以自定义继承自HttpServlet的类为例，说明Servlet的使用流程。

定义Servlet类继承HttpServlet，重写doGet、doPost

public class TestServlet extends HttpServlet{
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.setCharacterEncoding("UTF-8");

        resp.getWriter().write("hello!");
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        super.doPost(req, resp);
    }
}

在doGet()、doPost()方法中根据实际需求加入我们需要对请求进行处理的代码。

对Servlet进行配置及映射

编写好Servlet之后，就需要在web.xml文件中完成对Servlet的配置及映射。

<servlet>
<!-- servlet-name 就是给servlet起个别名 -->
<servlet-name>testServlet</servlet-name>
<!-- servlet-class 指定到我们定义的Servlet类 -->
<servlet-class>com.zhuanget.TestServlet</servlet-class>
<!-- init-param可加入Servlet的初始化参量 -->
<!--<init-param>-->
<!--<param-name></param-name>-->
<!--<param-value></param-value>-->
<!--</init-param>-->
</servlet>
<servlet-mapping>
<servlet-name>testServlet</servlet-name>
<!-- 请求url -->
<url-pattern>/test</url-pattern>
</servlet-mapping>

在Servlet 3.0及之后的规范，还可以使用WebServlet注解的形式来完成servlet配置。
这样就完成了Servlet的定义及配置，Servlet就可以使用了。

四、常用对象

ServletContext对象

一个web应用中，所有的Servlet共享同一个ServletContext对象，因此Servlet对象之间可以通过ServletContext对象来实现通讯。有关ServletContext对象的介绍，可查看我在JavaWeb四大域对象中的介绍：JavaWeb四大域对象。

HttpServletRequest对象

Web服务器收到客户端的http请求，会针对每一次请求，分别创建一个用于代表请求的request对象、和代表响应的response对象。
request和response对象既然代表请求和响应，那我们要获取客户机提交过来的数据，只需要找request对象就行了。要向客户机输出数据，只需要找response对象就行了。
HttpServletRequest对象代表客户端的请求，当客户端通过HTTP协议访问服务器时，HTTP请求头中的所有信息都封装在这个对象中，通过这个对象提供的方法，可以获得客户端请求的所有信息。

1.获取客户机请求参数

主要方法：

• String getParameter(String str)
• String[] getParameterValues(String name)
• Enumeration getParameterNames()
• Map getParameterMap()

2.获得客户机信息

主要方法：

• getRequestURL方法返回客户端发出请求时的完整URL。
• getRequestURI方法返回请求行中的资源名部分。
• getQueryString 方法返回请求行中的参数部分。
• getPathInfo方法返回请求URL中的额外路径信息。额外路径信息是请求URL中的位于Servlet的路径之后和查询参数之前的内容，它以“/”开头。
• getRemoteAddr方法返回发出请求的客户机的IP地址。
• getRemoteHost方法返回发出请求的客户机的完整主机名。
• getRemotePort方法返回客户机所使用的网络端口号。
• getLocalAddr方法返回WEB服务器的IP地址。
• getLocalName方法返回WEB服务器的主机名。

3.获得客户机请求头

• getHeader(string name)方法:String
• getHeaders(String name)方法:Enumeration
• getHeaderNames()方法

HttpServletResponse对象

API

1、负责向客户端发送数据的相关方法：getOutputStream()、getWriter()；
2、负责向客户端发送响应头的相关方法：addDateHeader()、addHeader()、addIntHeader()、setDateHeader()、setHeader()、setIntHeader()。
3、负责向客户端发送响应状态码的相关方法setStatus。
4、响应状态码的常量：404：SC_NOT_FOUND、200：SC_OK、500：SC_INTERNAL_SERVER_ERROR。

应用

1、使用OutputStream（由Response.getOutputStream得到）流向客户端输出数据。
2、使用PrintWriter（由Response.getWriter得到）流向客户端输出数据。
3、文件下载
4、通过response实现请求重定向，实现：response.sendRedirect(String location)
sendRedirect内部实现原理：使用response设置302状态码和设置location响应头实现。

细节问题

• getOutputStream和getWriter这两个方法互相排斥，调用了其中的任何一个方法后，就不能调用另一个方法。
• Servlet的service方法结束后，Servlet引擎将检查getWriter或者getOutputStream方法返回的输出流对象是否已经调用过close方法，如果没有，将调用close关闭该输出流对象。