看到有人在问Struts2的文件上传, 想起自己买的李刚的《struts2权威指南》,书中已有很详细的介绍,只是自己一下子记不起来了, 真的很遗憾,说明自己学得还不够扎实,所以自己整理了一下发上来。下面是上传的代码:
文件上传页面 文件上传页面中,包含两个表单域,文件标题和文件浏览域——当然,为了能完成文件上传,我们应该将这两个表单域所在表单的enctype属性设置为multipart/form-data。该页面的代码如下所示:
上面页面只是一个普通的HTML页面,没有任何的动态部分,当该页面提交请求时,请求发送到upload.action,这是一个Struts2的Action。 Struts2的Action无需负责处理HttpServletRequest请求,正如前面介绍的,Struts2的Action已经与Servlet API彻底分离了,Struts2框架负责解析HttpServletRequest请求中的参数,包括文件域。Struts2使用File类型来封装文件域,下面是处理上传请求的Action类代码。
上面的Action与普通的Action并没有太大的不同,一样提供了upload和title两个属性,这两个属性分别对应前面的两个表单域的name属性,用于封装两个表单域的请求参数。 值得注意的是:上面Action还包含了两个属性:uploadFileName和uploadContentType,这两个属性分别用于封装上传文件的文件名、上传文件的文件类型。这两个属性,体现了Struts2设计的灵巧、简化之处,Action类直接通过File类型属性直接封装了上传文件的文件内容,但这个File属性无法获取上传文件的文件名和文件类型,所以Struts2直接将文件域中包含的上传文件名和文件类型的信息封装到uploadFileName和uploadContentType属性中。可以认为:如果表单中包含一个name属性为xxx的文件域,则对应Action需要使用三个属性来封装该文件域的信息: 类型为File的xxx属性封装了该文件域对应的文件内容。 类型为String的xxxFileName属性封装了该文件域对应的文件的文件名。 类型为String的xxxContentType属性封装了该文件域对应的文件的文件名。 通过上面的三个属性,可以更简单地实现文件上传,所以在execute方法,可以直接通过调用getXxx()方法来获取上传文件的文件名、文件类型和文件内容。 除此之外,上面Action中还包含了一个savePath的属性,该属性的值通过配置文件来设置,从而允许动态设置该属性的值——这也是典型的依赖注入。 提示:Struts2的Action中的属性,功能非常丰富,除了可以用于封装HTTP请求参数,也可以封装Action的处理结果。不仅仅如此,Action的属性的还可通过在Struts2配置文件进行配置,接收Struts2框架的注入,允许在配置文件中为该属性动态指定值。 配置文件上传的Action 配置Struts2文件上传的Action与配置普通Action并没有太大的不同,一样是指定该Action的name,以及该Action的实现类。当然,还应该为该Action配置<result .../>元素。与之前的Action配置存在的一个小小区别是该Action还配置了一个<param .../>元素,该元素用于为该Action的属性动态分配属性值。 下面是该应用的struts.xml配置文件代码。
上面配置文件除了使用<param .../>元素设置了upload Action的savePath属性值外,与前面的Action几乎完全一样——这再次体现了Struts2的简单设计。 提示:上面配置文件还设置了一个struts.i18n.encoding的常量,该常量设置解析请求参数时所用的解码集。为了处理中文请求参数,故此处才用GBK解码集。 下面看web.xml文件的配置:
可能读者已经注意到了上面配置文件中增加了ActionContextCleanUp的配置,这个类也是一个Filter,它的作用是方便Struts2与Sitemesh的整合,与文件上传本来没有太大关系。此处也加载了该Filter的原因是:笔者在开发Struts2的文件上传应用过程中,发现有时候会出现一些未知的异常,但加入了该Filter配置后,系统一切正常。 提示:在文件上传应用中加载ActionContextCleanUp的配置不会引起任何异常,因为该类本来就是 FilterDispatcher的辅助类。 配置了该Web应用后,如果我们在如图6.7所示的页面中输入文件标题,并浏览到需要上传的文件,然后单击“上传”按钮,该上传请求将被UploadAction处理,处理结束后转入succ.jsp页面,该页面使用了简单的Struts2标签来显示上传的图片。 succ.jsp页面的代码如下:
上传成功应该可以看到文件上传的图片 通过上面的开发过程,不难发现通过Struts2实现文件上传确实是一件简单的事情。只要我们将文件域与Action中一个类型为File的属性关联,就可以轻松访问到上传文件的文件内容——至于Struts2使用何种Multipart解析器,对开发者完全透明。