struts2实现文件上传和下载
在做B/S系统时,通常会涉及到上传文件和下载文件,在没接struts2框架之前,我们都是使用apache下面的commons子项目的FileUpload组件来进行文件的上传,但是那样做的话,代码看起来比较繁琐,而且不灵活,在学习了struts2后,struts2为文件上传下载提供了更好的实现机制,在这里我分别就单文件上传和多文件上传的源代码进行一下讲解,这里需要导入文件下载上传的两个jar文件,一个是commons-fileupload-1.2.2.jar,另一个是commons-io-2.0.1.jar
struts2单文件上传:
首先是一个jsp文件上传页面,这个比较简单,就是一个表单,里面有个文件上传框
<!--在进行文件上传时,表单提交方式一定要是post的方式,因为文件上传时二进制文件可能会很大,还有就是enctype属性,这个属性一定要写成multipart/form-data, 不然就会以二进制文本上传到服务器端--> <s:form action="uploadOne" enctype="multipart/form-data" method="POST"> <s:file name="upload" label="选择文件"/><br> <s:submit name="submit" value="上传文件"/> </s:form>
接下来是uploadOne部分代码,因为struts2对上传和下载都提供了很好的实习机制,所以在action这段我们只需要写很少的代码就行:
public class uploadOne extends ActionSupport { //获取文件 private File upload; //获取文件的类型 private String uploadContentType; //上传文件的名称 private String uploadFileName; //获取文件上传的路径 private String path; @Override public String execute() throws Exception { byte[] bytes=new byte[1024]; //读取文件 FileInputStream fis=new FileInputStream(getUpload()); //写入文件,并设置保存目录的路径 FileOutputStream fos=new FileOutputStream(getPath()+"\\"+getUploadFileName()); int length=fis.read(bytes); while (length>0){ fos.write(bytes,0,length); length=fis.read(bytes); } fos.close(); fos.flush(); fis.close(); return SUCCESS; } //获取上传文件的保存路径 //通过读取存放目录获得保存路径 public String getPath() { return ServletActionContext.getServletContext().getRealPath(path); } public void setPath(String path) { this.path = path; } public File getUpload() { return upload; } public void setUpload(File upload) { this.upload = upload; } public String getUploadContentType() { return uploadContentType; } public void setUploadContentType(String uploadContentType) { this.uploadContentType = uploadContentType; } public String getUploadFileName() { return uploadFileName; } public void setUploadFileName(String uploadFileName) { this.uploadFileName = uploadFileName; } }
首先我们要清楚一点,这里的upload并不是真正指代jsp上传过来的文件,当文件上传过来时,struts2首先会寻找struts.multipart.saveDir(这个是在default.properties里面有)这个name所指定的存放位置,我们可以新建一个struts.properties属性文件来指定这个临时文件存放位置,如果没有指定,那么文件会存放在tomcat的apache-tomcat-7.0.29\work\Catalina\localhost\目录下,然后我们可以指定文件上传后的存放位置,通过输出流将其写到流里面就行了,这时我们就可以在文件夹里看到我们上传的文件了。
struts.xml配置
<action name="uploadOne" class="cn.happy.action.uploadOne"> <!--通过param参数设置保存目录的路径--> <param name="path">/upload</param> <result name="success">oneUpload/two.jsp</result> </action>
文件上传后我们还需要将其下载下来,其实struts2的文件下载原理很简单,就是定义一个输入流,然后将文件写到输入流里面就行,关键配置还是在struts.xml这个配置文件里配置:
FileDownloadAction代码如下:
//读取下载文件的目录 private String inputPath; //下载文件的文件名 private String fileName; //读取下载文件的输入流 private InputStream inputStream; //下载文件的类型 private String contntType; //创建InputStream输入流 public InputStream getInputStream() throws FileNotFoundException { String path= ServletActionContext.getServletContext().getRealPath(inputPath); return new BufferedInputStream(new FileInputStream(path+"\\"+fileName)); } public void setInputStream(InputStream inputStream) { this.inputStream = inputStream; } public String getInputPath() { return inputPath; } public void setInputPath(String inputPath) { this.inputPath = inputPath; } public String getFileName() { return fileName; } public void setFileName(String fileName) { this.fileName = fileName; }
struts.xml配置
<action name="first" class="cn.happy.action.FileAction"> <param name="inputPath">/upload</param> <result name="success" type="stream"> <!-- 指定下载文件的内容类型,text/plain是默认类型 --> <param name="contntType">application/octet-stream</param> <!-- inputName默认值是inputStream,如果action中用于读取 下载文件内容的属性名是inputStream,那么可以省略这个参数 --> <param name="inputName">inputStream</param> <!--动态获取文件名,从Action中的取得filename--> <param name="contentDisposition"> attachment;filename="${fileName}" </param> <param name="bufferSize">2048</param> </result>
struts.xml配置文件有几个地方我们要注意,首先是result的类型,以前我们定义一个action,result那里我们基本上都不写type属性,因为其默认是请求转发(dispatcher)的方式,除了这个属性一般还有redirect(重定向)等这些值,在这里因为我们用的是文件下载,所以type一定要定义成stream类型,告诉action这是文件下载的result,result元素里面一般还有param子元素,这个是用来设定文件下载时的参数,inputName这个属性就是得到action中的文件输入流,名字一定要和action中的输入流属性名字相同,然后就是contentDisposition属性,这个属性一般用来指定我们希望通过怎么样的方式来处理下载的文件,如果值是attachment,则会弹出一个下载框,让用户选择是否下载,如果不设定这个值,那么浏览器会首先查看自己能否打开下载的文件,如果能,就会直接打开所下载的文件,(这当然不是我们所需要的),另外一个值就是filename这个就是文件在下载时所提示的文件下载名字。
contentDispoistion参数由两部分组成,前面的部分表示处理文件的形式,如attachement表示在下载是弹出对话框,提示用户保存或者直接打开该文件;而后一部分表示下载文件的文件名称。两部分之间以;进行分隔。
在配置完这些信息后,我们就能过实现文件的下载功能了。
下载文件jsp页面
<a href="first?fileName=ehcache.xml">点击此处下载文件</a>
struts2多文件上传:
其实多文件上传和单文件上传原理一样,单文件上传过去的是单一的File,多文件上传过去的就是一个List<File>集合或者是一个File[]数组,首先我们来看一下前端jsp部分的代码,
<s:form action="more" enctype="multipart/form-data" method="POST"> <s:file name="upload" label="选择文件"/><br> <s:file name="upload" label="选择文件"/><br> <s:submit name="submit" value="上传文件"/> </s:form>
file的名字必须都命名成upload才行,然后处理多文件上传的action代码如下:
public class MoreUploadAction extends ActionSupport{ //获取文件 private List<File> upload; //获取文件的类型 private List<String> uploadContentType; //上传文件的名称 private List<String> uploadFileName; //获取文件上传的路径 private String path; @Override public String execute() throws Exception { byte[] bytes=new byte[1024]; int index=0; for (File item:upload) { FileInputStream inputStream=new FileInputStream(item); FileOutputStream output=new FileOutputStream(getPath()+"\\"+getUploadFileName().get(index++)); int length=inputStream.read(bytes); while (length>0){ output.write(bytes,0,length); length=inputStream.read(bytes); } output.flush(); output.close(); inputStream.close(); } return SUCCESS; } //获取上传文件的保存路径 //通过读取存放目录获得保存路径 public String getPath() { return ServletActionContext.getServletContext().getRealPath(path); } public void setPath(String path) { this.path = path; } public List<File> getUpload() { return upload; } public void setUpload(List<File> upload) { this.upload = upload; } public List<String> getUploadContentType() { return uploadContentType; } public void setUploadContentType(List<String> uploadContentType) { this.uploadContentType = uploadContentType; } public List<String> getUploadFileName() { return uploadFileName; } public void setUploadFileName(List<String> uploadFileName) { this.uploadFileName = uploadFileName; }
struts.xml配置
<!--多文件上传--> <action name="more" class="cn.happy.action.MoreUploadAction"> <!--通过param参数设置保存目录的路径--> <param name="path">/upload</param> <result name="success">moreUpload/two.jsp</result> </action>
这样同样将其写到一个输出流里面,这样我们就可以在文件夹里看到上传的多个文件了
接下来的文件下载就和刚才的文件下载一模一样,struts.xml也是一样的,这里就不再重复了
总结:总的来说,struts2提供的文件上传下载机制简化了我们很多代码,我们可以在以后的项目中使用该机制,同样我们也可以使用FileUpload组件来进行文件的上传,这个都是因个人爱好决定!