上一节:
下一节:

  Struts - 文件上传

  • 简述

    Struts 2 框架为使用“HTML 格式的基于表单的文件上传”处理文件上传提供了内置支持。当一个文件被上传时，它通常会被存储在一个临时目录中，它们应该被你的 Action 类处理或移动到一个永久目录中，以确保数据不会丢失。
    注意 − 服务器可能制定了安全策略，禁止您写入临时目录和属于您的 Web 应用程序的目录以外的目录。
    Struts 中的文件上传可以通过一个预定义的拦截器调用 FileUpload 拦截器可通过 org.apache.struts2.interceptor.FileUploadInterceptor 类获得，并作为defaultStack. 您仍然可以在 struts.xml 中使用它来设置各种参数，我们将在下面看到。

  • 创建视图文件

    让我们从创建浏览和上传选定文件所需的视图开始。所以让我们创建一个index.jsp 使用纯 HTML 上传表单，允许用户上传文件 - 
    
<%@ page language = "java" contentType = "text/html; charset = ISO-8859-1"
   pageEncoding = "ISO-8859-1"%>
<%@ taglib prefix = "s" uri = "/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
   "http://www.w3.org/TR/html4/loose.dtd">
<html>
   <head>
      <title>File Upload</title>
   </head>
   
   <body>
      <form action = "upload" method = "post" enctype = "multipart/form-data">
         <label for = "myFile">Upload your file</label>
         <input type = "file" name = "myFile" />
         <input type = "submit" value = "Upload"/>
      </form>
   </body>
</html>
    在上面的例子中有几点值得注意。首先，表单的enctype设置为multipart/form-data. 应设置此项，以便文件上传拦截器成功处理文件上传。下一点要注意的是表单的操作方法upload 以及文件上传字段的名称 - 即 myFile. 我们需要这些信息来创建 action 方法和 struts 配置。
    接下来，让我们创建一个简单的jsp文件 success.jsp 显示我们文件上传的结果，以防它成功。 
    
<%@ page contentType = "text/html; charset = UTF-8" %>
<%@ taglib prefix = "s" uri = "/struts-tags" %>
<html>
   <head>
      <title>File Upload Success</title>
   </head>
   
   <body>
      You have successfully uploaded <s:property value = "myFileFileName"/>
   </body>
</html>
    以下将是结果文件 error.jsp 如果上传文件时出现错误 - 
    
<%@ page contentType = "text/html; charset = UTF-8" %>
<%@ taglib prefix = "s" uri = "/struts-tags" %>
<html>
   <head>
      <title>File Upload Error</title>
   </head>
   
   <body>
      There has been an error in uploading the file.
   </body>
</html>

  • 创建动作类

    接下来，让我们创建一个名为的 Java 类 uploadFile.java 这将负责上传文件并将该文件存储在安全位置 - 
    
package com.jc2182.struts2;
import java.io.File;
import org.apache.commons.io.FileUtils;
import java.io.IOException; 
import com.opensymphony.xwork2.ActionSupport;
public class uploadFile extends ActionSupport {
   private File myFile;
   private String myFileContentType;
   private String myFileFileName;
   private String destPath;
   public String execute() {
      /* Copy file to a safe location */
      destPath = "C:/apache-tomcat-6.0.33/work/";
      try {
         System.out.println("Src File name: " + myFile);
         System.out.println("Dst File name: " + myFileFileName);
             
         File destFile  = new File(destPath, myFileFileName);
         FileUtils.copyFile(myFile, destFile);
  
      } catch(IOException e) {
         e.printStackTrace();
         return ERROR;
      }
      return SUCCESS;
   }
   
   public File getMyFile() {
      return myFile;
   }
   
   public void setMyFile(File myFile) {
      this.myFile = myFile;
   }
   
   public String getMyFileContentType() {
      return myFileContentType;
   }
   
   public void setMyFileContentType(String myFileContentType) {
      this.myFileContentType = myFileContentType;
   }
   
   public String getMyFileFileName() {
      return myFileFileName;
   }
   
   public void setMyFileFileName(String myFileFileName) {
      this.myFileFileName = myFileFileName;
   }
}
    这 uploadFile.java是一个非常简单的类。需要注意的重要一点是 FileUpload 拦截器和 Parameters Interceptor 一起为我们完成了所有繁重的工作。
    FileUpload 拦截器默认为您提供三个参数。它们以以下模式命名 -
    • [your file name parameter] − 这是用户上传的实际文件。在这个例子中，它将是“myFile”
    • [your file name parameter]ContentType- 这是上传文件的内容类型。在这个例子中，它将是“myFileContentType”
    • [your file name parameter]FileName- 这是上传的文件的名称。在这个例子中，它将是“myFileFileName”
    由于 Struts 拦截器，我们可以使用这三个参数。我们所要做的就是在我们的 Action 类中创建三个具有正确名称的参数，这些变量会自动为我们自动连接。所以，在上面的例子中，我们有三个参数和一个 action 方法，如果一切顺利，它只会返回“success”，否则返回“error”。

  • 配置文件

    以下是控制文件上传过程的 Struts2 配置属性 -
    序号 属性和描述
    1
    struts.multipart.maxSize
    要作为文件上传接受的文件的最大大小（以字节为单位）。默认为 250M。
    2
    struts.multipart.parser
    用于上传多部分表单的库。默认是jakarta
    3
    struts.multipart.saveDir
    存储临时文件的位置。默认情况下是 javax.servlet.context.tempdir。
    为了更改这些设置中的任何一个，您可以使用 constant 标记在您的应用程序 struts.xml 文件中，就像我更改要上传的文件的最大大小一样。
    让我们有我们的 struts.xml 如下 - 
    
<?xml version = "1.0" Encoding = "UTF-8"?>
<!DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
   <constant name = "struts.devMode" value = "true" />
   <constant name = "struts.multipart.maxSize" value = "1000000" />
   <package name = "helloworld" extends = "struts-default">
      <action name = "upload" class = "com.jc2182.struts2.uploadFile">
         <result name = "success">/success.jsp</result>
         <result name = "error">/error.jsp</result>
      </action>
   </package>
</struts>
    自从， FileUpload拦截器是默认拦截器堆栈的一部分，我们不需要显式配置它。但是，您可以在 <action> 中添加 <interceptor-ref> 标签。fileUpload 拦截器有两个参数 (a) maximumSize 和 (b) allowedTypes.
    maximumSize 参数设置允许的最大文件大小（默认值约为 2MB）。allowedTypes 参数是一个逗号分隔的接受内容 (MIME) 类型列表，如下所示 - 
    
<action name = "upload" class = "com.jc2182.struts2.uploadFile">
   <interceptor-ref name = "basicStack">
   <interceptor-ref name = "fileUpload">
      <param name = "allowedTypes">image/jpeg,image/gif</param>
   </interceptor-ref>
   <result name = "success">/success.jsp</result>
   <result name = "error">/error.jsp</result>
</action>
    以下是内容 web.xml 文件 - 
    
<?xml version = "1.0" Encoding = "UTF-8"?>
<web-app xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xmlns = "http://java.sun.com/xml/ns/javaee" 
   xmlns:web = "http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   id = "WebApp_ID" version = "3.0">
   
   <display-name>Struts 2</display-name>
   
   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
   
   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.FilterDispatcher
      </filter-class>
   </filter>
   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>
</web-app>
    现在右键单击项目名称并单击 Export > WAR File创建一个战争文件。然后将此 WAR 部署到 Tomcat 的 webapps 目录中。最后，启动Tomcat服务器并尝试访问URLhttp://localhost:8080/HelloWorldStruts2/upload.jsp. 这将产生以下屏幕 -
    你好世界 Struts 7
    现在使用浏览按钮选择一个文件“Contacts.txt”，然后单击上传按钮将文件上传到您的服务器，您应该会看到下一页。您可以检查上传的文件应该保存在 C:\apache-tomcat-6.0.33\work 中。
    你好世界 Struts 8
    请注意，FileUpload Interceptor 会自动删除上传的文件，因此您必须在删除之前以编程方式将上传的文件保存在某个位置。

  • 错误信息

    fileUplaod 拦截器使用几个默认的错误消息键 -
    序号 错误信息键和描述
    1
    struts.messages.error.uploading
    无法上传文件时发生的一般错误。
    2
    struts.messages.error.file.too.large
    当上传的文件过大（由 maximumSize 指定）时发生。
    3
    struts.messages.error.content.type.not.allowed
    当上传的文件与指定的预期内容类型不匹配时发生。
    您可以覆盖这些消息的文本 WebContent/WEB-INF/classes/messages.properties 资源文件。
上一节:
下一节: