链接更新

  1. GITHUB : https://github.com/41zone/StreamResultX

  2. 版本 1.2 : http://sunspot.blog.51cto.com/372554/1334379推荐

  3. 版本 1.1 : http://sunspot.blog.51cto.com/372554/681472

正文

 有关struts2下载组件的具体介绍我就在此略过了,看此文的同志想必大多是碰到这样让人很是不爽的问题。
 下面就将该问题的最终解决办法介绍如下。


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

  1. 2011-1-820:34:20 org.apache.catalina.core.StandardWrapperValve invoke  

  2. 严重: Servlet.service() for servlet default threw exception  

  3. java.lang.IllegalStateException  

  4. at org.apache.catalina.connector.ResponseFacade.sendError(ResponseFacade.java:407)  

  5. at javax.servlet.http.HttpServletResponseWrapper.sendError(HttpServletResponseWrapper.java:108)  

  6. at com.opensymphony.module.sitemesh.filter.PageResponseWrapper.sendError(PageResponseWrapper.java:176)  

  7. at javax.servlet.http.HttpServletResponseWrapper.sendError(HttpServletResponseWrapper.java:108)  

  8. at org.apache.struts2.dispatcher.Dispatcher.sendError(Dispatcher.java:770)  

  9. at org.apache.struts2.dispatcher.Dispatcher.serviceAction(Dispatcher.java:505)  

  10. at org.apache.struts2.dispatcher.FilterDispatcher.doFilter(FilterDispatcher.java:395)  

  11. at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  

  12. at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  

  13. at com.opensymphony.sitemesh.webapp.SiteMeshFilter.obtainContent(SiteMeshFilter.java:129)  

  14. at com.opensymphony.sitemesh.webapp.SiteMeshFilter.doFilter(SiteMeshFilter.java:77)  

  15. at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  

  16. at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  

  17. at org.apache.struts2.dispatcher.ActionContextCleanUp.doFilter(ActionContextCleanUp.java:102)  

  18. at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  

  19. at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  

  20. at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)  

  21. at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)  

  22. at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)  

  23. at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)  

  24. at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)  

  25. at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)  

  26. at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:852)  

  27. at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)  

  28. at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)  

  29. at java.lang.Thread.run(Thread.java:662)  



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

  1. <packagename="default"extends="struts-default">

  2.  <global-results>

  3. <resultname="client-abort-exception">/ignored.jsp</result>

  4.  </global-results>

  5. </package>

  6. <packagename="main"extends="struts-default">

  7.  <exception-mappingresult="client-abort-exception"exception="org.apache.catalina.connector.ClientAbortException"/>

  8.  <action name="download" class="com.DownloadAction">

  9.  <resultname="success"type="stream">

  10. <paramname="inputName">targetFile</param>

  11. <paramname="contentDisposition">filename=""</param>

  12. <paramname="buffersize">4096</param>

  13.  </result>

  14.  </action>

  15. </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的基础上进行相应的配置,配置如下例

  1. <package name="default" namespace="/"extends="struts-default">  

  2. <!-- 添加如下内容 -->  

  3. <result-types>  

  4. <result-type  

  5. name="streamx"class="com.sunspoter.lib.web.struts2.dispatcher.StreamResultX"/>  

  6. </result-types>  

  7. <action name="download"class="com.DownloadAction">  

  8. <!-- type改写 -->              

  9. <result name="success" type="streamx">  

  10. <param name="inputName">download</param>  

  11. <param name="bufferSize">4096</param>  

  12. <param name="contentDisposition">filename=""</param>  

  13. <param name="contentCharSet">UTF-8</param>  

  14. </result>  

  15. </action>  

  16. </package>  


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

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

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