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非正常中斷，但是流確實已經關閉，自此再也不用看到上面出現的討厭異常結果。