HttpServletResponse进一步学习

HttpServletResponse进一步学习

创建响应正文：

•getOutputStream与getWriter方法

•与getWriter方法相关的一些小疑问

•输出缓冲区

•实现动态文件内容的下载

•图像访问计数器

 

getOutputStream与getWriter方法：

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

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

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

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

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

•Servlet程序向ServletOutputStream或PrintWriter对象中写入的数据将被Servlet引擎获取，Servlet引擎将这些数据当作响应消息的正文，然后再与响应状态行和各响应头组合后输出到客户端。

•Serlvet的service方法结束后，Servlet引擎将检查getWriter或getOutputStream方法返回的输出流对象是否已经调用过close方法，如果没有，Servlet引擎将调用close方法关闭该输出流对象。   

选择getOutputStream和getWriter方法的要点：

•PrintWriter对象输出字符文本内容时，它内部还是将字符串转换成了某种字符集编码的字节数组后再进行输出，使用PrintWriter对象的好处就是不用编程人员自己来完成字符串到字节数组的转换。

•使用ServletOutputStream对象也能输出内容全为文本字符的网页文档，但是，如果网页文档内容是在Servlet程序内部使用文本字符串动态拼凑和创建出来的，则需要先将字符文本转换成字节数组后输出。

•如果一个网页文档内容全部为字符文本，但是这些内容可以直接从一个字节输入流中读取出来，然后再原封不动地输出到客户端，那么就应该使用ServletOutputStream对象直接进行输出，而不要使用PrintWriter对象进行输出。    

 

输出缓冲区：

•Servlet程序输出的HTTP消息的响应正文首先被写入到Servlet引擎提供的一个输出缓冲区中，直到输出缓冲区被填满或者Servlet程序已经写入了所有的响应内容，缓冲区中的内容才会被Servlet引擎发送到客户端。

•使用输出缓冲区后，Servlet引擎就可以将响应状态行、各响应头和响应正文严格按照HTTP消息的位置顺序进行调整后再输出到客户端。

•如果在提交响应到客户端时，输出缓冲区中已经装入了所有的响应内容，Servlet引擎将计算响应正文部分的大小并自动设置Content-Length头字段。

•如果在提交响应到客户端时，输出缓冲区中装入的内容只是全部响应内容的一部分， Servlet引擎将使用HTTP 1.1的chunked编码方式（通过设置Transfer-Encoding头字段来指定）传输响应内容。

输出缓冲区-有关方法：

•setBufferSize方法

•getBufferSize方法

•flushBuffer方法

•reset方法

•isCommitted方法

什么是动态文件内容的下载：

•只要让超链接的URL地址指向一个exe或zip等类型的文件，用户单击这个超链接就可以将该资源文件下载到客户端。

•如果要下载的文件并不真正存在于WEB服务器的文件系统中，而是需要用一个Servlet程序临时在服务器内存中动态产生后再传送到客户端，那该如何实现呢？

如何实现动态文件内容的下载：

•需要通过HttpServletResponse.setContentType方法设置Content-Type头字段的值为浏览器无法使用某种方式或激活某个程序来处理的MIME类型，例如，“application/octet-stream”或“application/x-msdownload”等。

•需要通过HttpServletResponse.setHeader方法设置Content-Disposition头的值为“attachment; filename =文件名”。

•应该调用HttpServletResponse.getOutputStream方法返回的ServletOutputStream对象来向客户端写入附件文件内容，而不应使用HttpServletResponse.getWriter方法返回的PrintWriter对象。

图像访问计数器-介绍：

•网页每次被访问时，页面的访问次数都要发生改变，所以这个功能必须通过服务器端的程序来实现。

•一些WEB站点只能输出静态页面内容，没有开放运行服务器端程序的功能，无法直接在这些只支持静态内容的WEB站点上编写服务器端程序来实现页面访问次数的统计和显示功能。 

•一些具有执行服务器端程序功能的WEB站点推出了免费的页面访问计数器，只要在位于任何站点的一个静态HTML页面中增加一条该站点提供的HTML语句，该语句就能显示出该静态页面的访问次数。

•一个站点要想能统计另外一个站点上的某个HTML页面的访问次数，必须让任何一个浏览器在每次访问那个HTML页面都通知这个一下站点，这可以通过在静态HTML页面中增加两种特殊的标签来实现：<img>标签和设置src属性的<script>标签。  

<img>标签的三个重要特性：

•一个包含有图像的网页文件中并没有包含真正的图像数据内容，而只是使用<img>标签指明了图像的URL地址。

举例：本网页已被浏览了<img src= "count.gif ">次

•<img>标签的src属性也可以指向当前页面所在WEB服务器之外的其他WEB服务器上的图像文件。

•浏览器并不关心<img>标签所需的图像数据在服务器端是如何产生，它只知道去访问src属性指定的URL资源，并把服务器返回的数据当作一个图像的内容来显示。服务器返回的图像数据可以直接从一个静态图像文件中读取，也可以通过Servlet程序在内存中动态创建。

页面访问计数器的技术实现细节：

•Servlet程序输出的图像格式为jpeg，它应告诉浏览器其所输出的实体内容的MIME类型为image/jpeg。

•因为图像是二进制数据，所以应该调用HttpServletResponse.getOutputStream方法返回的ServletOutputStream对象来向客户端写入图像数据。

•java.awt.image.BufferedImage类用于在内存中创建一幅图像，具体的图像内容则可以通过调用其图形上下文对象（java.awt.Graphics）的各种绘图方法生成。

•在内存图像中绘制访问次数时，必须限定显示的位数，如果访问次数超过七位，则用数字9999999显示，如果访问次数不足七位，则在前面补充相应个数的0。

•每个引用该Servlet程序的静态页面的URL都对应一个各自的访问次数，每个URL及其访问次数需要使用数据库系统来进行存储，对于简单的实验，也可以采用一个属性文件来进行存储。当前引用页面的URL可以通过Referer请求头获取。

•JDK中提供了一个javax.imageio.ImageIO类，它的write方法可以将BufferedImage对象中的图像编码成jpeg格式的图像数据后写入到一个OutputStream流对象中。

图像访问计数器-更多思考：

•如果要自行设置Content-Length头字段，该如何处理？

•在实际应用中，往往采用为每个页面分配一个id号的方式来区分和跟踪每个静态HTML页面，请编写一个具体应用案例。

<img src=http://主机地址:8080/it315/CountServlet?id=本页面的id号>

•借鉴其中的动态图像生成技术，可以根据数据库系统中的数据动态产生出的各类数据分析图（直方图、饼状图、折线图等），甚至是股票走势图。

•使用设置src属性的<script>标签也可以实现统计和显示页面访问次数的功能，请编写一个具体应用案例。

•借鉴网页访问计数器的设计思想统，www.it315.org站点还为其他站点的页面提供了一个“显示来访者的IP地址和地区信息”的功能，请描述一下其实现过程？ 

多学两招：如何动态产生大小可变的图像：

•涉及到的类：

java.awt.image.BufferedImage

java.awt.image.ImageIO

java.awt.geom.AffineTransform

java.awt.image.AffineTransformOp

•AffineTransformOp类的filter方法用于完成具体的转换操作：

public final BufferedImage filter(BufferedImage src,BufferedImage dst)

•如果要对一个图像文件进行转换，可以先调用ImageIO.read方法从该文件输入流中读取图像数据并生成一个BufferedImage对象，然后调用AffineTransformOp.filter方法进行转换，最后再调用ImageIO.write方法将转换得到的BufferedImage对象写入到一个文件输出流中。

•一个AffineTransform对象定义了一种具体的转换方式，在创建AffineTransformOp对象时，需要为其传递一个AffineTransform对象：

public AffineTransformOp(AffineTransform xform,int interpolationType)

•如果仅仅是需要改变图像的大小，可以调用AffineTransform.getScaleInstance这个静态方法来创建：

public static AffineTransform getScaleInstance(double sx, double sy)

请求重定向与请求转发：

•RequestDispatcher接口

•用include方法实现资源包含

•用forward方法实现请求转发

•请求转发的运行流程

•用sendRedirect方法实现请求重定向

•请求重定向的运行流程

•请求重定向与请求转发的比较

•缺省Servlet的缓存问题

RequestDispatcher接口：

•RequestDispatcher实例对象是由Servlet引擎创建的，它用于包装一个要被其他资源调用的资源（例如，Servlet、HTML文件、JSP文件等），并可以通过其中的方法将客户端的请求转发给所包装的资源。

•RequestDispatcher接口中定义了两个方法：forward方法和include方法。

•forward和include方法接收的两个参数必须是传递给当前Servlet的service方法的那两个ServletRequest和ServletResponse对象，或者是对它们进行了包装的ServletRequestWrapper 或ServletResponseWrapper对象。

•获取RequestDispatcher对象的方法：

üServletContext.getRequestDispatcher （参数只能是以“/”开头的路径）

üServletContext.getNamedDispatcher

üServletRequest.getRequestDispatcher （参数可以是不以“/”开头的路径）

用include方法实现资源包含：

•RequestDispatcher.include方法用于将RequestDispatcher对象封装的资源内容作为当前响应内容的一部分包含进来，从而实现可编程的服务器端包含功能。

•被包含的Servlet程序不能改变响应消息的状态码和响应头，如果它里面存在这样的语句，这些语句的执行结果将被忽略。

•在调用RequestDispatcher.include方法时，Servlet容器不会去调整HttpServletRequest对象中的信息，HttpServletRequest对象仍然保持其初始的URL路径和参数信息。 

缺省Servlet如何创建响应正文：

ServletOutputStream ostream = null;

PrintWriter writer = null;

……

try

{

/*

如果抛出了异常，说明前面已经调用过getWriter方法，

则在异常处理代码中再次调用getWriter方法对writer变量进行赋值。

*/

ostream = response.getOutputStream();

}

catch (IllegalStateException e)

{

/*只有那些文本内容才可以用

PrintWriter对象进行转换输出*/

if ( (contentType == null) ||

(contentType.startsWith("text")) )

{

writer = response.getWriter();

}

else

{

throw e;

}

}

……

//如果已经对writer变量赋值，则执行else从句

if (ostream != null)

{

//将资源中的内容按字节流原封不动地输出到客户端

copy(cacheEntry, renderResult, ostream);

}

else

{

/*将资源中的内容转换成字符文本后

再由PrintWriter对象转换输出*/

copy(cacheEntry, renderResult, writer);

}

用forward方法实现请求转发：

lforward方法用于将请求转发到RequestDispatcher对象封装的资源，Servlet程序在调用这个方法进行转发之前可以对请求进行一些前期的预处理。

l如果在调用forward方法之前，在Servlet程序中写入的部分内容已经被真正地传送到了客户端，forward方法将抛出IllegalStateException异常。

l调用RequestDispatcher.forward方法时，Servlet容器将根据目标资源路径对当前HttpServletRequest对象中的请求路径和参数信息进行调整。

l如果在调用forward方法之前向Servlet引擎的缓冲区中写入了内容，只要写入到缓冲区中的内容还没有被真正输出到客户端，forward方法就可以被正常执行，原来写入到输出缓冲区中的内容将被清空，但是，已写入到HttpServletResponse对象中的响应头字段信息保持有效。

l如果调用者与被调用者的访问URL不属于同一个目录，当被调用者输出的内容中包含有使用相对URL的访问路径时，原来相对被调用者的URL将变成相对于调用者的URL。

用sendRedirect方法实现请求重定向：

lsendRedirect方法用于生成302响应码和Location响应头，从而通知客户端去重新访问Location响应头中指定的URL，其完整的定义语法如下：

public void sendRedirect(java.lang.String location)

throws java.io.IOException

l使用下面两条语句也能完成response.sendRedirect(url)语句所完成的功能：

response.setStatus(response.SC_MOVED_TEMPORARILY );

response.setHeader ("Location", url);

lsendRedirect 方法不仅可以重定向到当前应用程序中的其他资源，它还可以重定向到同一个站点上的其他应用程序中的资源，甚至是使用绝对URL重定向到其他站点的资源。

l如果传递给sendRedirect 方法的相对URL以“/”开头，则是相对于整个WEB站点的根目录，而不是相对于当前WEB应用程序的根目录。

请求重定向与请求转发的比较：

 

•RequestDispatcher.forward方法只能将请求转发给同一个WEB应用中的组件；而HttpServletResponse.sendRedirect 方法还可以重定向到同一个站点上的其他应用程序中的资源，甚至是使用绝对URL重定向到其他站点的资源。

•如果传递给HttpServletResponse.sendRedirect 方法的相对URL以“/”开头，它是相对于整个WEB站点的根目录；如果创建RequestDispatcher对象时指定的相对URL以“/”开头，它是相对于当前WEB应用程序的根目录。

•调用HttpServletResponse.sendRedirect方法重定向的访问过程结束后，浏览器地址栏中显示的URL会发生改变，由初始的URL地址变成重定向的目标URL；调用RequestDispatcher.forward 方法的请求转发过程结束后，浏览器地址栏保持初始的URL地址不变。

•HttpServletResponse.sendRedirect方法对浏览器的请求直接作出响应，响应的结果就是告诉浏览器去重新发出对另外一个URL的访问请求；RequestDispatcher.forward方法在服务器端内部将请求转发给另外一个资源，浏览器只知道发出了请求并得到了响应结果，并不知道在服务器程序内部发生了转发行为。

•RequestDispatcher.forward方法的调用者与被调用者之间共享相同的request对象和response对象，它们属于同一个访问请求和响应过程；而HttpServletResponse.sendRedirect方法调用者与被调用者使用各自的request对象和response对象，它们属于两个独立的访问请求和响应过程。

•无论是RequestDispatcher.forward方法，还是HttpServletResponse.sendRedirect方法，在调用它们之前，都不能有内容已经被实际输出到了客户端。如果缓冲区中已经有了一些内容，这些内容将被从缓冲区中清除。