Struts+Spring+Hibernate实现上传下载（二）

业务层

　　1、业务层接口

　　"面向接口而非面向类编程"是Spring不遗余力所推荐的编程原则，这条原则也已经为大部开发者所接受；此外，JDK的动态代理只对接口有效，否则必须使用CGLIB生成目标类的子类。我们依从于Spring的倡导为业务类定义一个接口：

　　代码 7 业务层操作接口

1. public interface FileService 2. { 3. void save(FileActionForm fileForm);//将提交的上传文件保存到数据表中 4. List getAllFile();//得到T_FILE所示记录 5. void write(OutputStream os,String fileId);//将某个文件的文件数据写出到输出流中 6. String getFileName(String fileId);//获取文件名 7. }

　　其中save(FileActionForm fileForm)方法，将封装在fileForm中的上传文件保存到数据库中，这里我们使用FileActionForm作为方法入参，FileActionForm是Web层的表单数据对象，它封装了提交表单的数据。将FileActionForm直接作为业务层的接口入参，相当于将Web层传播到业务层中去，即将业务层绑定在特定的Web层实现技术中，按照分层模型学院派的观点，这是一种反模块化的设计，但在"一般"的业务系统并无需提供多种UI界面，系统Web层将来切换到另一种实现技术的可能性也微乎其微，所以笔者觉得没有必要为了这个业务层完全独立于调用层的过高目标而去搞一个额外的隔离层，浪费了原材料不说，还将系统搞得过于复杂，相比于其它原则，"简单"始终是最大的一条原则。

　　getAllFile()负责获取T_FILE表所有记录，以便在网页上显示出来。

　　而getFileName(String fileId)和write(OutputStream os,String fileId)则用于下载某个特定的文件。具体的调用是将Web层将response.getOutputStream()传给write(OutputStream os,String fileId)接口，业务层直接将文件数据输出到这个响应流中。具体实现请参见错误！未找到引用源。节下载文件部分。

　　2、业务层接口实现类

　　FileService的实现类为FileServiceImpl，其中save(FileActionForm fileForm)的实现如下所示：

　　代码 8 业务接口实现类之save()

1. … 2. public class FileServiceImpl 3. implements FileService 4. { 5. private TfileDAO tfileDAO; 6. public void save(FileActionForm fileForm) 7. { 8. Tfile tfile = new Tfile(); 9. try 10. { 11. tfile.setFileContent(fileForm.getFileContent().getFileData()); 12. } 13. catch (FileNotFoundException ex) 14. { 15. throw new RuntimeException(ex); 16. } 17. catch (IOException ex) 18. { 19. throw new RuntimeException(ex); 20. } 21. tfile.setFileName(fileForm.getFileContent().getFileName()); 22. tfile.setRemark(fileForm.getRemark()); 23. tfileDAO.save(tfile); 24. } 25. … 26. }

　　在save(FileActionForm fileForm)方法里，完成两个步骤：

　　其一，象在水桶间倒水一样，将FileActionForm对象中的数据倒入到Tfile对象中；

　　其二，调用TfileDAO保存数据。

　　需要特别注意的是代码的第11行，FileActionForm的fileContent属性为org.apache.struts.upload.FormFile类型，FormFile提供了一个方便的方法getFileData()，即可获取文件的二进制数据。通过解读FormFile接口实现类DiskFile的原码，我们可能知道FormFile本身并不缓存文件的数据，只有实际调用getFileData()时，才从磁盘文件输入流中获取数据。由于FormFile使用流读取方式获取数据，本身没有缓存文件的所有数据，所以对于上传超大体积的文件，也是没有问题的；但是，由于数据持久层的Tfile使用byte[]来缓存文件的数据，所以并不适合处理超大体积的文件（如100M），对于超大体积的文件，依然需要使用java.sql.Blob类型以常规流操作的方式来处理。

　　此外，通过FileForm的getFileName()方法就可以获得上传文件的文件名，如第21行代码所示。

　　write(OutputStream os,String fileId)方法的实现，如代码 9所示：

　　代码 9 业务接口实现类之write()

1. … 2. public class FileServiceImpl 3. implements FileService 4. { 5. 6. public void write(OutputStream os, String fileId) 7. { 8. Tfile tfile = tfileDAO.findByFildId(fileId); 9. try 10. { 11. os.write(tfile.getFileContent()); 12. os.flush(); 13. } 14. catch (IOException ex) 15. { 16. throw new RuntimeException(ex); 17. } 18. } 19. … 20. }

　　write(OutputStream os,String fileId)也简单地分为两个操作步骤，首先，根据fileId加载表记录，然后将fileContent写入到输出流中。

　　3、Spring事务配置

　　下面，我们来看如何在Spring配置文件中为FileService配置声明性的事务

1. ＜beans＞ 2. … 3. ＜bean id="transactionManager" 4. class="org.springframework.orm.hibernate3.HibernateTransactionManager"＞ 5. ＜property name="sessionFactory" ref="sessionFactory"/＞ 6. ＜/bean＞ 7. ＜!-- 事务处理的AOP配置 //--＞ 8. ＜bean id="txProxyTemplate" abstract="true" 9. class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"＞ 10. ＜property name="transactionManager" ref="transactionManager"/＞ 11. ＜property name="transactionAttributes"＞ 12. ＜props＞ 13. ＜prop key="get*"＞PROPAGATION_REQUIRED,readOnly＜/prop＞ 14. ＜prop key="find*"＞PROPAGATION_REQUIRED,readOnly＜/prop＞ 15. ＜prop key="save"＞PROPAGATION_REQUIRED＜/prop＞ 16. ＜prop key="write"＞PROPAGATION_REQUIRED,readOnly＜/prop＞ 17. ＜/props＞ 18. ＜/property＞ 19. ＜/bean＞ 20. ＜bean id="fileService" parent="txProxyTemplate"＞ 21. ＜property name="target"＞ 22. ＜bean class="sshfile.service.FileServiceImpl"＞ 23. ＜property name="tfileDAO" ref="tfileDAO"/＞ 24. ＜/bean＞ 25. ＜/property＞ 26. ＜/bean＞ 27. ＜/beans＞

　　Spring的事务配置包括两个部分：

　　其一，定义事务管理器transactionManager，使用HibernateTransactionManager实现事务管理；

　　其二，对各个业务接口进行定义，其实txProxyTemplate和fileService是父子节点的关系，本来可以将txProxyTemplate定义的内容合并到fileService中一起定义，由于我们的系统仅有一个业务接口需要定义，所以将其定义的一部分抽象到父节点txProxyTemplate中意义确实不大，但是对于真实的系统，往往拥有为数众多的业务接口需要定义，将这些业务接口定义内容的共同部分抽取到一个父节点中，然后在子节点中通过parent进行关联，就可以大大简化业务接口的配置了。

　　父节点txProxyTemplate注入了事务管理器，此外还定义了业务接口事务管理的方法（允许通过通配符的方式进行匹配声明，如前两个接口方法），有些接口方法仅对数据进行读操作，而另一些接口方法需要涉及到数据的更改。对于前者，可以通过readOnly标识出来，这样有利于操作性能的提高，需要注意的是由于父类节点定义的Bean仅是子节点配置信息的抽象，并不能具体实现化一个Bean对象，所以需要特别标注为abstract="true"，如第8行所示。

　　fileService作为一个目标类被注入到事务代理器中，而fileService实现类所需要的tfileDAO实例，通过引用3.2节中定义的tfileDAO Bean注入。
 　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所提供的方便类，相信这些知识对您的开发都有所裨益。