Struts+Spring+Hibernate上传下载 －－之四

Web层实现

　　1、Web层的构件和交互流程

　　Web层包括主要3个功能：

　　·上传文件。

　　·列出所有已经上传的文件列表，以供点击下载。

　　·下载文件。

　　Web层实现构件包括与2个JSP页面，1个ActionForm及一个Action：

　　·file-upload.jsp：上传文件的页面。

　　·file-list.jsp：已经上传文件的列表页面。

　　·FileActionForm：file-upload.jsp页面表单对应的ActionForm。

　　·FileAction：继承org.apache.struts.actions.DispatchAction的Action，这样这个Action就可以通过一个URL参数区分中响应不同的请求。

　　Web层的这些构件的交互流程如图 6所示

图 6 Web层Struts流程图

　　其中，在执行文件上传的请求时，FileAction在执行文件上传后，forward到loadAllFile出口中，loadAllFile加载数据库中所有已经上传的记录，然后forward到名为fileListPage的出口中，调用file-list.jsp页面显示已经上传的记录。
     2、FileAction功能

　　Struts 1.0的Action有一个弱项：一个Action只能处理一种请求，Struts 1.1中引入了一个DispatchAction，允许通过URL参数指定调用Action中的某个方法，如http://yourwebsite/fileAction.do?method=upload即调用FileAction中的upload方法。通过这种方式，我们就可以将一些相关的请求集中到一个Action当中编写，而没有必要为某个请求操作编写一个Action类。但是参数名是要在struts-config.xml中配置的：

1. ＜struts-config＞
2. ＜form-beans＞
3. ＜form-bean name="fileActionForm" type="sshfile.web.FileActionForm" /＞
4. ＜/form-beans＞
5. ＜action-mappings＞
6. ＜action name="fileActionForm" parameter="method" path="/fileAction"
7. type="sshfile.web.FileAction"＞
8. ＜forward name="fileListPage" path="/file-list.jsp" /＞
9. ＜forward name="loadAllFile" path="/fileAction.do?method=listAllFile" /＞
10. ＜/action＞
11. ＜/action-mappings＞
12. ＜/struts-config＞

　　第6行的parameter="method"指定了承载方法名的参数，第9行中，我们还配置了一个调用FileAction不同方法的Action出口。

　　FileAction共有3个请求响应的方法，它们分别是：

　　·upload(…)：处理上传文件的请求。

　　·listAllFile(…)：处理加载数据库表中所有记录的请求。

　　·download（…）：处理下载文件的请求。

　　下面我们分别对这3个请求处理方法进行讲解。

　　2.1 上传文件

　　上传文件的请求处理方法非常简单，简之言之，就是从Spring容器中获取业务层处理类FileService，调用其save(FileActionForm form)方法上传文件，如下所示：

1. public class FileAction
2. extends DispatchAction
3. {
4. //将上传文件保存到数据库中
5. public ActionForward upload(ActionMapping mapping, ActionForm form,
6. HttpServletRequest request,
7. HttpServletResponse response)
8. {
9. FileActionForm fileForm = (FileActionForm) form;
10. FileService fileService = getFileService();
11. fileService.save(fileForm);
12. return mapping.findForward("loadAllFile");
13. }
14. //从Spring容器中获取FileService对象
15. private FileService getFileService()
16. {
17. ApplicationContext appContext = WebApplicationContextUtils.
18. getWebApplicationContext(this.getServlet().getServletContext());
19. return (FileService) appContext.getBean("fileService");
20. }
21. …
22. }

　　由于FileAction其它两个请求处理方法也需要从Spring容器中获取FileService实例，所以我们特别提供了一个getFileService()方法（第15~21行）。重构的一条原则就是："发现代码中有重复的表达式，将其提取为一个变量；发现类中有重复的代码段，将其提取为一个方法；发现不同类中有相同的方法，将其提取为一个类"。在真实的系统中，往往拥有多个Action和多个Service类，这时一个比较好的设置思路是，提供一个获取所有Service实现对象的工具类，这样就可以将Spring 的Service配置信息屏蔽在一个类中，否则Service的配置名字散落在程序各处，维护性是很差的。

　　2.2 列出所有已经上传的文件

　　listAllFile方法调用Servie层方法加载T_FILE表中所有记录，并将其保存在Request域中，然后forward到列表页面中：

1. public class FileAction
2. extends DispatchAction
3. {
4. …
5. public ActionForward listAllFile(ActionMapping mapping, ActionForm form,
6. HttpServletRequest request,
7. HttpServletResponse response)
8. throws ModuleException
9. {
10. FileService fileService = getFileService();
11. List fileList = fileService.getAllFile();
12. request.setAttribute("fileList",fileList);
13. return mapping.findForward("fileListPage");
14. }
15. }

　　file-list.jsp页面使用Struts标签展示出保存在Request域中的记录：

1. ＜%@page contentType="text/html; charset=GBK"%＞
2. ＜%@taglib uri="/WEB-INF/struts-logic.tld" prefix="logic"%＞
3. ＜%@taglib uri="/WEB-INF/struts-bean.tld" prefix="bean"%＞
4. ＜html＞
5. ＜head＞
6. ＜title＞file-download＜/title＞
7. ＜/head＞
8. ＜body bgcolor="#ffffff"＞
9. ＜ol＞
10. ＜logic:iterate id="item" name="fileList" scope="request"＞
11. ＜li＞
12. ＜a href='fileAction.do?method=download&fileId=
13. ＜bean:write name="item"property="fileId"/＞'＞
14. ＜bean:write name="item" property="fileName"/＞
15. ＜/a＞
16. ＜/li＞
17. ＜/logic:iterate＞
18. ＜/ol＞
19. ＜/body＞
20. ＜/html＞

　　展现页面的每条记录挂接着一个链接地址，形如：fileAction.do?method=download&fileId=xxx，method参数指定了这个请求由FileAction的download方法来响应，fileId指定了记录的主键。

　　由于在FileActionForm中，我们定义了fileId的属性，所以在download响应方法中，我们将可以从FileActionForm中取得fileId的值。这里涉及到一个处理多个请求Action所对应的ActionForm的设计问题，由于原来的Action只能对应一个请求，那么原来的ActionForm非常简单，它仅需要将这个请求的参数项作为其属性就可以了，但现在一个Action对应多个请求，每个请求所对应的参数项是不一样的，此时的ActionForm的属性就必须是多请求参数项的并集了。所以，除了文件上传请求所对应的fileContent和remark属性外还包括文件下载的fileId属性：

图 7 FileActionForm

　　当然这样会造成属性的冗余，比如在文件上传的请求中，只会用到fileContent和remark属性，而在文件下载的请求时，只会使用到fileId属性。但这种冗余是会带来好处的--它使得一个Action可以处理多个请求。

　　2.3 下载文件

　　在列表页面中点击一个文件下载，其请求由FileAction的download方法来响应，download方法调用业务层的FileService方法，获取文件数据并写出到response的响应流中。通过合理设置HTTP响应头参数，将响应流在客户端表现为一个下载文件对话框，其代码如下所示：

　　代码 10 业务接口实现类之download

1. public class FileAction
2. extends DispatchAction
3. {
4. …
5. public ActionForward download(ActionMapping mapping, ActionForm form,
6. HttpServletRequest request,
7. HttpServletResponse response)
8. throws ModuleException
9. {
10. FileActionForm fileForm = (FileActionForm) form;
11. FileService fileService = getFileService();
12. String fileName = fileService.getFileName(fileForm.getFileId());
13. try
14. {
15. response.setContentType("application/x-msdownload");
16. response.setHeader("Content-Disposition",
17. "attachment;" + " filename="+
18. new String(fileName.getBytes(), "ISO-8859-1"));
19. fileService.write(response.getOutputStream(), fileForm.getFileId());
20. }
21. catch (Exception e)
22. {
23. throw new ModuleException(e.getMessage());
24. }
25. return null;
26. }
27. }

　　第15~18行，设置HTTP响应头，将响应类型设置为application/x-msdownload MIME类型，则响应流在IE中将弹出一个文件下载的对话框，如图 4所示。IE所支持的MIME类型多达26种，您可以通过这个网址查看其他的MIME类型：

http://msdn.microsoft.com/workshop/networking/moniker/overview/appendix_a.asp。

　　如果下载文件的文件名含有中文字符，如果不对其进行硬编码，如第18行所示，客户文件下载对话框中出现的文件名将会发生乱码。
第19行代码获得response的输出流，作为FileServie write(OutputStream os,String fileId)的入参，这样文件的内容将写到response的输出流中。

　　3、web.xml文件的配置

　　Spring容器在何时启动呢？我可以在Web容器初始化来执行启动Spring容器的操作，Spring提供了两种方式启动的方法：

　　·通过org.springframework.web.context .ContextLoaderListener容器监听器，在Web容器初始化时触发初始化Spring容器，在web.xml中通过＜listener＞＜/listener＞对其进行配置。

　　·通过Servlet org.springframework.web.context.ContextLoaderServlet，将其配置为自动启动的Servlet，在Web容器初始化时，通过这个Servlet启动Spring容器。

　　在初始化Spring容器之前，必须先初始化log4J的引擎，Spring也提供了容器监听器和自动启动Servlet两种方式对log4J引擎进行初始化：

　　·org.springframework.web.util .Log4jConfigListener

　　·org.springframework.web.util.Log4jConfigServlet

　　下面我们来说明如何配置web.xml启动Spring容器：

　　代码 11 web.xml中对应Spring的配置内容

1. ＜web-app＞
2. ＜context-param＞
3. ＜param-name＞contextConfigLocation＜/param-name＞
4. ＜param-value＞/WEB-INF/applicationContext.xml＜/param-value＞
5. ＜/context-param＞
6. ＜context-param＞
7. ＜param-name＞log4jConfigLocation＜/param-name＞
8. ＜param-value＞/WEB-INF/log4j.properties＜/param-value＞
9. ＜/context-param＞
10. ＜servlet＞
11. ＜servlet-name＞log4jInitServlet＜/servlet-name＞
12. ＜servlet-class＞org.springframework.web.util.Log4jConfigServlet＜/servlet-class＞
13. ＜load-on-startup＞1＜/load-on-startup＞
14. ＜/servlet＞
15. ＜servlet＞
16. ＜servlet-name＞springInitServlet＜/servlet-name＞
17. ＜servlet-class＞org.springframework.web.context.ContextLoaderServlet＜/servlet-class＞
18. ＜load-on-startup＞2＜/load-on-startup＞
19. ＜/servlet＞
20. …
21. ＜/web-app＞

　　启动Spring容器时，需要得到两个信息：Spring配置文件的地址和Log4J属性文件，这两上信息分别通过contextConfigLocationWeb和log4jConfigLocation容器参数指定，如果有多个Spring配置文件，则用逗号隔开，如：

/WEB-INF/applicationContext_1.xml, /WEB-INF/applicationContext_1.xm2

　　由于在启动ContextLoaderServlet之前，必须事先初始化Log4J的引擎，所以Log4jConfigServlet必须在ContextLoaderServlet之前启动，这通过＜load-on-startup＞来指定它们启动的先后顺序。

　　乱码是开发Web应用程序一个比较老套又常见问题，由于不同Web应用服务器的默认编码是不一样的，为了方便Web应用在不同的Web应用服务器上移植，最好的做法是Web程序自身来处理编码转换的工作。经典的作法是在web.xml中配置一个编码转换过滤器，Spring就提供了一个编码过滤器类CharacterEncodingFilter，下面，我们为应用配置上这个过滤器：

1. ＜web-app＞
2. …
3. ＜filter＞
4. ＜filter-name＞encodingFilter＜/filter-name＞
5. ＜filter-class＞org.springframework.web.filter.CharacterEncodingFilter＜/filter-class＞
6. ＜init-param＞
7. ＜param-name＞encoding＜/param-name＞
8. ＜param-value＞GBK＜/param-value＞
9. ＜/init-param＞
10. ＜/filter＞
11. ＜filter-mapping＞
12. ＜filter-name＞encodingFilter＜/filter-name＞
13. ＜url-pattern＞/*＜/url-pattern＞
14. ＜/filter-mapping＞
15. …
16. ＜/web-app＞

　　Spring的过滤器类是org.springframework.web.filter.CharacterEncodingFilter，通过encoding参数指定编码转换类型为GBK，＜filter-mapping＞的配置使该过滤器截获所有的请示。

　　Struts的框架也需要在web.xml中配置，想必读者朋友对Struts的配置都很熟悉，故在此不再提及，请参见本文所提供的源码。

　　总结

　　本文通过一个文件上传下载的Web应用，讲解了如何构建基于SSH的Web应用，通过Struts和FormFile，Spring的LobHandler以及Spring为HibernateBlob处理所提供的用户类BlobByteArrayType ，实现上传和下载文件的功能仅需要廖廖数行的代码即告完成。读者只需对程序作稍许的调整，即可处理Clob字段：

　　·领域对象对应Clob字段的属性声明为String类型；

　　·映射文件对应Clob字段的属性声明为org.springframework.orm.hibernate3.support.ClobStringType类型。

　　本文通过SSH对文件上传下载简捷完美的实现得以管中窥豹了解SSH强强联合构建Web应用的强大优势。在行文中，还穿插了一些分层的设计经验，配置技巧和Spring所提供的方便类，相信这些知识对您的开发都有所裨益。