Struts2 下载取消报异常解决办法

问题概要：
在struts2中使用result里type=”stream”的结果类型时，可以实现文件的下载管理，使用时也是比较顺畅，但是当在“下载提示窗口”中点击“取消按钮”时，总是报出“java.lang.IllegalStateException”异常，异常内容如下：

2011-1-8 20:34:20 org.apache.catalina.core.StandardWrapperValve invoke  
严重: Servlet.service() for servlet default threw exception  
java.lang.IllegalStateException  
    at org.apache.catalina.connector.ResponseFacade.sendError(ResponseFacade.java:407)  
    at javax.servlet.http.HttpServletResponseWrapper.sendError(HttpServletResponseWrapper.java:108)  
    at com.opensymphony.module.sitemesh.filter.PageResponseWrapper.sendError(PageResponseWrapper.java:176)  
    at javax.servlet.http.HttpServletResponseWrapper.sendError(HttpServletResponseWrapper.java:108)  
    at org.apache.struts2.dispatcher.Dispatcher.sendError(Dispatcher.java:770)  
    at org.apache.struts2.dispatcher.Dispatcher.serviceAction(Dispatcher.java:505)  
    at org.apache.struts2.dispatcher.FilterDispatcher.doFilter(FilterDispatcher.java:395)  
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
    at com.opensymphony.sitemesh.webapp.SiteMeshFilter.obtainContent(SiteMeshFilter.java:129)  
    at com.opensymphony.sitemesh.webapp.SiteMeshFilter.doFilter(SiteMeshFilter.java:77)  
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
    at org.apache.struts2.dispatcher.ActionContextCleanUp.doFilter(ActionContextCleanUp.java:102)  
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
    at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)  
    at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)  
    at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)  
    at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)  
    at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)  
    at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)  
    at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:852)  
    at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)  
    at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)  
    at java.lang.Thread.run(Thread.java:662)  

网络解决办法：
（虽然该办法可行，但是本人并不提倡。具体原因在之后解释。）
在网络中查询解决办法大多是使用异常处理的办法，其内容如下：

<package name="default" extends="struts-default"> 
  <global-results> 
    <result name="client-abort-exception">/ignored.jsp</result> 
  </global-results> 
</package> 

<package name="main" extends="struts-default"> 
  <exception-mapping result="client-abort-exception" exception="org.apache.catalina.connector.ClientAbortException"/>
  <action name="download" class="com.DownloadAction"> 
  <result name="success" type="stream"> 
    <param name="inputName">targetFile</param> 
    <param name="contentDisposition">filename=""</param> 
    <param name="buffersize">4096</param> 
  </result> 
  </action>
</package> 

也就是说，如果抛出了ClientAbortException异常，那就跳转到“ignored.jsp”这个页面，这个页面中什么内容都没有。
还有一种办法是在页面进行try..catch，之后什么都不做

异常原因分析：
stream对应的类是org.apache.struts2.dispatcher.StreamResult，该类的处理过程如下：
1。配置其中result标签下的各个参数
2。从服务器中获取输入流，并同时与客户端建立输出流（服务器与客户端链接通过Socket进行连接）
3。当点击“保存”或“打开”时，开始传输数据。如果点击“取消”，关闭所有的流。
这里要注意的是，但是实际发现Socket并没有断开！并且流也没有关闭！这一点非常重要！
所以在JSP容器通过Response获取输出流之前，前面的流并没有关闭，所以会造成该异常的报出。

本文解决办法：
在前面所说的网络解决办法中，使用的是一种躲避的方式解决该问题，也就是置之不理。
这里提供一个办法可以从根本上解决该问题，但是需要下载插件，在附件中有下载，这个插件很小，才4KB而已。
《如果附件下载后文件损坏，可以到http://down.51cto.com/data/519367下载资源，不需要下载豆。》
具体做法如下：
1。将附件解压获取struts2-sunspoter-stream-1.0.jar，并复制在/WEB-INF/lib下
2。在原有的struts.xml的基础上进行相应的配置，配置如下例

<package name="default" namespace="/" extends="struts-default">  
<!-- 添加如下内容 -->  
<result-types>  
<result-type   
name="streamx" class="com.sunspoter.lib.web.struts2.dispatcher.StreamResultX"/>  
</result-types>  

<action name="download" class="com.DownloadAction">  
<!-- type改写 -->               
<result name="success" type="streamx">  
                 <param name="inputName">download</param>  
                 <param name="bufferSize">4096</param>  
                 <param name="contentDisposition">filename=""</param>  
                 <param name="contentCharSet">UTF-8</param>  
             </result>  
</action>  
</package>  

在这种方式下，只需添加一个result-type，将原有的result中type改为“streamx”，其他一律不变，在这种情况下，点击“取消”的同时也关闭了流，不会再报出该异常。
之后的执行“取消”后的结果如下：（配置了”log4j.properties”才能看到该结果）

21:23:44,676  WARN StreamResult:45 - StreamResultX Warn : socket write error 

如果出现该警告说明正确执行，该警告说明，Socket非正常中断，但是流确实已经关闭，自此再也不用看到上面出现的讨厌异常结果。