注:最新版本1.1 查看 http://sunspot.blog.51cto.com/372554/681472,修正BadVersionClass
有關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非正常中斷,但是流確實已經關閉,自此再也不用看到上面出現的討厭異常結果。