链接更新

  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非正常中断，但是流确实已经关闭，自此再也不用看到上面出现的讨厌异常结果。