链接更新

  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.  
       
  2. 严重: Servlet.service() for servlet default threw exception  
    3.  
       
  3. java.lang.IllegalStateException  
    4.  
       
  4. at org.apache.catalina.connector.ResponseFacade.sendError(ResponseFacade.java:407)  
    5.  
       
  5. at javax.servlet.http.HttpServletResponseWrapper.sendError(HttpServletResponseWrapper.java:108)  
    6.  
       
  6. at com.opensymphony.module.sitemesh.filter.PageResponseWrapper.sendError(PageResponseWrapper.java:176)  
    7.  
       
  7. at javax.servlet.http.HttpServletResponseWrapper.sendError(HttpServletResponseWrapper.java:108)  
    8.  
       
  8. at org.apache.struts2.dispatcher.Dispatcher.sendError(Dispatcher.java:770)  
    9.  
       
  9. at org.apache.struts2.dispatcher.Dispatcher.serviceAction(Dispatcher.java:505)  
    10.  
       
  10. at org.apache.struts2.dispatcher.FilterDispatcher.doFilter(FilterDispatcher.java:395)  
    11.  
       
  11. at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
    12.  
       
  12. at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
    13.  
       
  13. at com.opensymphony.sitemesh.webapp.SiteMeshFilter.obtainContent(SiteMeshFilter.java:129)  
    14.  
       
  14. at com.opensymphony.sitemesh.webapp.SiteMeshFilter.doFilter(SiteMeshFilter.java:77)  
    15.  
       
  15. at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
    16.  
       
  16. at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
    17.  
       
  17. at org.apache.struts2.dispatcher.ActionContextCleanUp.doFilter(ActionContextCleanUp.java:102)  
    18.  
       
  18. at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)  
    19.  
       
  19. at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)  
    20.  
       
  20. at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)  
    21.  
       
  21. at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)  
    22.  
       
  22. at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)  
    23.  
       
  23. at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)  
    24.  
       
  24. at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)  
    25.  
       
  25. at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)  
    26.  
       
  26. at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:852)  
    27.  
       
  27. at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)  
    28.  
       
  28. at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)  
    29.  
       
  29. at java.lang.Thread.run(Thread.java:662)  
    30.  
      
 
    
 
    
  
 
  

 
  

 
  
 
    
    
 
     
 网络解决办法：
（虽然该办法可行，但是本人并不提倡。具体原因在之后解释。）
在网络中查询解决办法大多是使用异常处理的办法，其内容如下：
 
      
     
       
  1. <packagename="default"extends="struts-default">
    2.  
       
  2.   <global-results>
    3.  
       
  3. <resultname="client-abort-exception">/ignored.jspresult>
    4.  
       
  4.   global-results>
    5.  
       
  5. package>
    6.  
       
  6. <packagename="main"extends="struts-default">
    7.  
       
  7.   <exception-mappingresult="client-abort-exception"exception="org.apache.catalina.connector.ClientAbortException"/>
    8.  
       
  8.   
    9.  
       
  9.   <resultname="success"type="stream">
    10.  
       
  10. <paramname="inputName">targetFileparam>
    11.  
       
  11. <paramname="contentDisposition">filename=""param>
    12.  
       
  12. <paramname="buffersize">4096param>
    13.  
       
  13.   result>
    14.  
       
  14.   
    15.  
       
  15. package>
    16.  
      
  也就是说，如果抛出了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.  
       
  2.   
    3.  
       
  3.   
    4.  
       
    5.  
       
  5. name="streamx"class="com.sunspoter.lib.web.struts2.dispatcher.StreamResultX"/>  
    6.  
       
  6.   
    7.  
       
  7. "download"class="com.DownloadAction">  
    8.  
       
  8.                
    9.  
       
  9. "success" type="streamx">  
    10.  
       
  10.  "inputName">download  
    11.  
       
  11.  "bufferSize">4096  
    12.  
       
  12.  "contentDisposition">filename=""  
    13.  
       
  13.  "contentCharSet">UTF-8  
    14.  
       
  14.    
    15.  
       
  15.   
    16.  
       
  16. package>  
    17.  
      

在这种方式下，只需添加一个result-type，将原有的result中type改为“streamx”，其他一律不变，在这种情况下，点击“取消”的同时也关闭了流，不会再报出该异常。
  之后的执行“取消”后的结果如下：（配置了"log4j.properties"才能看到该结果）
 
      
     
       
  1. 21:23:44,676  WARN StreamResult:45 - StreamResultX Warn : socket write error 
    2.  
      
如果出现该警告说明正确执行，该警告说明，Socket非正常中断，但是流确实已经关闭，自此再也不用看到上面出现的讨厌异常结果。