首页 > Struts2

Struts2单个文件上传实例（超详细）

< 上一页Struts2文件上传简介 Struts2文件上传限制大小和类型下一页 >
通过《Struts2文件上传简介》的学习，读者对如何使用 Struts2 框架进行文件上传已经有了一定的了解。本节将通过具体案例演示如何在 Struts2 项目中实现单个文件上传。此案例要求在文件上传成功后，跳转到上传结果页面，页面中要显示上传文件的信息。

1. 创建项目

在 MyEclipse 中创建一个名称为 struts2Demo06 的 Web 项目，添加 Struts2 所需的 JAR 包，并在 web.xml 中配置 Struts2 的核心过滤器。

2. 创建上传页面

在项目的 WebContent 目录下创建一个名称为 fileUpload.jsp 的文件，使用该文件作为文件上传页面。编辑后如下所示。
  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2. pageEncoding="UTF-8"%>
  3. <%@taglib prefix="s" uri="/struts-tags"%>
  4. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  5. <html>
  6. <head>
  7. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  8. <title>上传页面</title>
  9. </head>
  10. <body>
  11. <center>
  12.     <s:form action="fileUpload" method="post" enctype="Multipart/form-data">
  13.         <s:file name="file" label="上传文件" />
  14.         <s:submit value="上传" />
  15.     </s:form>
  16. </center>
  17. </body>
  18. </html>
在上述页面代码中，创建了一个 form 表单，并修改 form 表单的 enctype 属性值为 multipart/form-data，以及修改 method 属性值为 post，然后使用 <s:file> 标签创建一个上传文本框，并使用 <s:submit> 标签创建了上传按钮。

3. 创建 Action

在 src 下新建一个名称为 com.mengma.action 的包，在包中新建一个名称为 FileUploadAction 的类，该类用于接收上传的文件，并执行上传方法，编辑后如下所示。 
  1. package com.mengma.action;
  2.  
  3. import java.io.File;
  4. import java.io.FileInputStream;
  5. import java.io.FileOutputStream;
  6. import java.io.InputStream;
  7. import java.io.OutputStream;
  8.  
  9. import org.apache.struts2.ServletActionContext;
  10.  
  11. import com.opensymphony.xwork2.ActionSupport;
  12.  
  13. public class FileUploadAction extends ActionSupport {
  14.     private static final long serialVersionUID = 1L;
  15.     private File file; // 提交的文件
  16.     private String fileFileName; // 提交的 file 的名字
  17.     private String fileContentType; // 提交的file的类型
  18.  
  19.     // 此处省略三个属性的getter和setter方法
  20.     public String execute() throws Exception {
  21.         // 文件输入流
  22.         InputStream is = new FileInputStream(file);
  23.         // 设置文件保存的目录
  24.         String uploadPath = ServletActionContext.getServletContext()
  25.                 .getRealPath("/upload");
  26.         // 设置目标文件
  27.         File toFile = new File(uploadPath, this.getFileFileName());
  28.         // 文件输出流
  29.         OutputStream os = new FileOutputStream(toFile);
  30.         byte[] buffer = new byte[1024];
  31.         int length = 0;
  32.         // 读取file文件输出到toFile文件中
  33.         while (-1 != (length = is.read(buffer, 0, buffer.length))) {
  34.             os.write(buffer);
  35.         }
  36.         // 关闭输入流和输出流
  37.         is.close();
  38.         os.close();
  39.         return SUCCESS;
  40.     }
  41.  
  42.     public File getFile() {
  43.         return file;
  44.     }
  45.  
  46.     public void setFile(File file) {
  47.         this.file = file;
  48.     }
  49.  
  50.     public String getFileFileName() {
  51.         return fileFileName;
  52.     }
  53.  
  54.     public void setFileFileName(String fileFileName) {
  55.         this.fileFileName = fileFileName;
  56.     }
  57.  
  58.     public String getFileContentType() {
  59.         return fileContentType;
  60.     }
  61.  
  62.     public void setFileContentType(String fileContentType) {
  63.         this.fileContentType = fileContentType;
  64.     }
  65.  
  66. }
上述文件中，声明了 file（上传的文件）、fileFileName（上传的文件名称）和 fileContentType（上传的文件类型）三个属性，其中 file 属性的名称与表单中文本域的参数必须相同，并且要为 File 类型，它用于保存封装的上传文件。

一般来说，Action 中的属性与表单中提交的参数是相对应的，但在此表单中并没有提交 fileFileName 和 fileContentType 这两个参数，因为这两个参数是由 FileUploadIntercepter（文件上传拦截器）负责填充的，FileUploadIntercepter 会对其属性值进行设置。fileFileName 属性用于保存上传文件名称，fileContentType 属性用于保存上传文件的类型。

在 execute() 方法中通过输入流读取 File 文件中的数据，通过取得上传文件名和上传目录设置一个目标文件，并通过循环输出流将数据写入到目标文件中，最后关闭输入/输出流。

4. 创建配置文件

在 src 下创建 Struts2 的配置文件 struts.xml，编辑后如下所示。 
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE struts PUBLIC
  3.     "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
  4.     "http://struts.apache.org/dtds/struts-2.3.dtd">
  5. <struts>
  6. <package name="struts2" namespace="/" extends="struts-default">
  7.   <action name="fileUpload" class="com.mengma.action.FileUploadAction">
  8.    <result name="success">/result.jsp</result>
  9.   </action>
  10. </package>
  11. </struts>

5. 创建结果页面

在项目的 WebContent 目录下新建一个名称为 result 的页面文件，此文件用于显示上传的结果，包括上传文件的名称及类型，编辑后如下所示。 
  1. <%@ page language="java" contentType="text/html; charset=UTF-8"
  2.     pageEncoding="UTF-8"%>
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  4. <html>
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. <title>结果页面</title>
  8. </head>
  9. <body>
  10.     <h2>文件上传成功！</h2>
  11.     上传文件名：${fileFileName }
  12.     <br /> 上传文件类型：${fileContentType }
  13. </body>
  14. </html>
部署项目，在浏览器的地址栏中输入地址 http://localhost:8080/struts2Demo06/fileUpload.jsp 后，即可显示如图 1 所示的上传页面。
上传页面
图 1  上传页面

单击图 1 中的【选择文件】按钮，打开文件选择框，选择需要上传的文件后，单击【上传】按钮进行文件上传操作，上传成功后跳转到上传结果页面，如图 2 所示。

上传结果页面
图 2  上传结果页面

打开上传目录，可以看到新上传的文件，如图 3 所示。

上传目录upload
图 3  上传目录upload

需要注意的是，在上传文件前，需要在项目的 WebContent 路径下新建一个名称为 upload 的文件夹作为上传目录，如果没有此目录，则会出现系统找不到文件路径的异常。
< 上一页Struts2文件上传简介 Struts2文件上传限制大小和类型下一页 >