HttpServletResponse

摘要: 摘自《深入体验JAVA WEB开发内幕——核心基础》，如有版权问题，请联系我。

一、HttpServletResponse

Web服务器回送给Web客户端的HTTP响应消息分为三个部分：状态行、响应消息头、消息正文（也叫实体内容）。Servlet程序通过调用ServletResponse对象的方法可以向客户端回送基本的响应消息。HttpServletResponse是专用于HTTP协议的ServletResponse子接口，它用于封装HTTP响应消息，允许操控HTTP协议相关数据，包括响应头和状态码。

二、响应消息

1、产生响应状态行

HTTP响应消息的响应状态行可分为三个部分：HTTP版本、状态代码和一条相关的提示消息，如：

HTTP/1.1    200    OK

2、构建响应消息头

（1）ServletResponse和HttpServletResponse接口中定义了若干用于产生http响应消息中的头字段的方法。如addHeader(String name, String value)，用于增加一个同名的响应头；setHeader(String name, String value)，用新的设置值取代原来的设置值。

setContentType方法

setContentType方法用于设置Servlet输出内容的MIME类型（网页文档类型"text/html"，文本类型"text/plain"，这个类型也作用于PrintWriter对象输出文本内容所采用的编码），对于HTTP协议来说，就是设置Content-Type响应头字段的值。在MIME类型后面还可以指定响应内容所使用的字符集类型，例如："text/html; charset=GB2312"，如果在MIME类型后面没有指定，且使用getWriter方法返回的PrintWriter对象输出文本内容时，Tomcat5.x将在MIME类型后面默认增加“ISO8859-1”的字符编码类型。

setCharacterEncoding方法

该方法是在Servlet API 2.4规范中新增的方法，用于设置输出内容的MIME声明中的字符集编码，对HTTP协议来说，就是设置Context-Type头字段中的字符集编码部分。如果没有设置Content-Type头字段，则setCharacterEncoding 设置的字符集类型不会出现在HTML的响应头中，但是它对PrintWriter对象输出文本内容时所采用的字符集编码仍然有效。setCharacterEncoding
比 setContentType setLocale拥有更高的优先级，会覆盖后面两者所设置的字符集编码。

区别详解：http://hi.baidu.com/chenlinping/item/f0b7668e2e4a52c8b171545f

（2）关于响应头的应用

让浏览器定时刷新网页或跳转至其他页面

HTTP协议中定义了一个Refresh头字段，用于告诉浏览器过多少秒后自动刷新页面。在refresh头字段的时间设置后面还可以用分号隔开，指定url地址，让浏览器在指定时间值后自动去访问该url。

response.setHeader("Refresh", "2; URL=http://www.oschina.net");

禁止浏览器缓存当前文档内容

有三个HTTP响应头字段都可以禁止浏览器缓存当前页面，如下：

response.setDateHeader("Expires", 0);
response.setHeader("Cache-Control", "no-cache");
response.setHeader("Pragma", "no-cache");

不是所有的浏览器都能完全支持上面三个响应头，因此最好同时使用。

使用<meta>标签模拟响应消息头

如果不会服务器端编程的普通HTML页面制作者也想借助HTTP消息的响应头字段来实现一些特殊功能，为此，HTML语言中专门定义了<meta>标签的http-equiv属性来在HTML文档中模拟HTTP响应消息头，当浏览器读取到HTML文档中具有http-equiv属性的<meta>标签时，它会用于处理服务器发送响应消息头一样的方式进行处理。

<meta http-equiv="Expires" content="0">
<meta http-equiv="Cache-Control" content="no-cache">
<meta http-equiv="Pragma" content="no-cache">

<meta>标签的一个最常见的应用就是用来设置当前页面的字符集编码

<meta http-equiv="Content-Type" content="text/html" charset="GB2312">

3、创建响应正文

Servlet程序通过ServletResponse对象将响应正文传递给Servlet引擎，再由Servlet引擎将响应正文输出到客户端。但ServletResponse并未定义直接输出响应正文的方法（如prinltln这种方法），而是定义了一些方法（getWriter方法）来返回Servlet引擎提供的输出流对象，再由Servlet程序通过这个输出流对象将响应正文写入到Servlet引擎。

（1）getOutputStream与getWriter方法

getOutputStream方法用于返回Servlet引擎创建的字节输出流对象，Servlet程序可以按字节形式输出响应正文。

getWriter方法用于返回Servlet引擎创建的字符输出流对象，Servlet程序可以按字符形式输出响应正文。

getOutputStream方法返回的字节输出流对象的类型为ServletOutputStream，它可以直接输出字节数组中的二进制数据。

getWriter方法将Servlet引擎的数据缓冲区包装成PrintWriter类型的字符输出流对象后返回，PrintWriter对象可以直接输出字符文本内容。

getOutputStream和getWriter这两个方法互相排斥，调用了其中的任何一个方法后，就不能再调用另一方法。  

此外：

setContentType方法或setCharacterEncoding方法设置的字符集编码只对PrintWriter对象输出的内容起作用；ServletOutputStream对象采用ISO8859-1编码将数据输出到缓冲区，如果ISO8859-1不支持该字符，会报CharConversionException。

哪怕setContentType设置的编码不影响ServletOutputStream对象输出的内容，但调用该方法后，响应消息依旧包含Content-Type请求头，即浏览器依然是按MIME后跟着编码来显示网页。

（2）输出缓冲区

Servlet程序输出的HTTP消息的响应正文不是直接发送给客户端，而是首先被写入到Servlet引擎提供的一个输出缓冲区中。

© 著作权归作者所有