JavaWeb文件上传下载功能深入分析（二）

Z时代
2024-01-10
分类：IT

接着上一篇叙述：

二、文件上传与下载

Struts2开发的三板斧，页面jsp―配置文件struts2.xml―-还有动作类Action

文件上传前提：

form表单的method必须是post

form表单的enctype必须是multipart/form-data

提供type=”file”的上传输入域

Struts 对文件上传的支持的一些规则

1、单文件上传

开发步骤：

1）、在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org/下载

2）、第二步：编写upfile.jsp ,把form表的enctype设置为：“multipart/form-data“，如下：


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="/struts-tags" prefix="s"%>
<body>
  <s:actionerror/>
  <hr/>
  <s:fielderror></s:fielderror>
  <form action="${pageContext.request.contextPath}/upload1.action" method="post" enctype="multipart/form-data"><!-- 以MIME的方式传递
-->
    用户名：<input type="text" name="username"/><br/>
    靓照：<input type="file" name="photo"/><br/>
    <input type="submit" value="上传"/>
  </form>
 </body>

编写错误页面error.jsp


 <body>
  服务器忙，一会再试。
 </body>

success.jsp


 <body>
  上传成功
 </body>

3）、编写UploadAction1 类：在Action类中添加属性，属性对应于表单中文件字段的名称：


package com.itheima.actions;
import java.io.File;
import java.io.IOException;
import org.apache.commons.io.FileUtils;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
//文件上传：fileUpload拦截器完成的
public class UploadAction1 extends ActionSupport {
  private String username;
  private File photo;//和表单的上传字段名保持一致。类型是File类型的
  private String photoFileName;//上传的文件名
  private String photoContentType;//上传文件的MIME类型
  //省略getter和setter方法
  public String upload(){
    System.out.println(photoFileName+":"+photoContentType);
    //普通字段：
    System.out.println(username);
    //上传字段：上传到某个文件夹。存到应用的images目录下
    String realPath = ServletActionContext.getServletContext().getRealPath("/images");
    File directory = new File(realPath);
    if(!directory.exists()){
      directory.mkdirs();
    }
    try {
      FileUtils.copyFile(photo, new File(directory, photoFileName));
      return SUCCESS;
    } catch (IOException e) {
      e.printStackTrace();
      return ERROR;
    }
  }
}

在struts.xml文件中增加如下配置


<action name="upload1" class="com.itheima.actions.UploadAction1" method="upload">
  <interceptor-ref name="defaultStack">
    <param name="fileUpload.allowedTypes">image/jpeg,image/png</param>
    <param name="fileUpload.allowedExtensionsSet">jpg,jpeg,png</param>
  </interceptor-ref>
  <result>/success.jsp</result>
  <result name="error">/error.jsp</result>
  <result name="input">/index.jsp</result>
</action>

原理分析：

a 、FileUpload 拦截器负责处理文件的上传操作, 它是默认的 defaultStack 拦截器栈的一员. 拦截器有 3 个属性可以设置.

•maximumSize: 上传文件的最大长度(以字节为单位), 默认值为 2 MB

•allowedTypes: 允许上传文件的类型, 各类型之间以逗号分隔

•allowedExtensions: 允许上传文件扩展名, 各扩展名之间以逗号分隔

可以在 struts.xml 文件中覆盖这 3 个属性

b、超出大小或非法文件的上传，会报错（转向一个input的视图）

通过：

<s:actionError/> <s:feildError/>显示错误消息的提示

c、错误消息提示改为中文版：借助国际化的消息资源文件

如果是通过配置全局默认参数引起的错误，最好用全局的消息资源文件。

struts2默认的提示资源文件：struts2-core-**.jar 的org.apache.struts2的struts-message.properties文件中。比着key值覆盖对应的value即可。

配置如下:

struts.messages.error.uploading=Error uploading: {0}

struts.messages.error.file.too.large=File too large: {0} "{1}" "{2}" {3}

struts.messages.error.content.type.not.allowed=Content-Type not allowed: {0} "{1}" "{2}" {3}

struts.messages.error.file.extension.not.allowed=File extension not allowed: {0} "{1}" "{2}" {3}

{0}:<input type=“file” name=“uploadImage”>中name属性的值

{1}:上传文件的真实名称

{2}:上传文件保存到临时目录的名称

{3}:上传文件的类型(对struts.messages.error.file.too.large是上传文件的大小)

源码：

修改显示错误的资源文件的信息

第一步:创建新的资源文件例如fileuploadmessage.properties,放置在src下

在该资源文件中增加如下信息

struts.messages.error.uploading=上传错误: {0}

struts.messages.error.file.too.large=上传文件太大: {0} "{1}" "{2}" {3}

struts.messages.error.content.type.not.allowed=上传文件的类型不允许: {0} "{1}" "{2}" {3}

struts.messages.error.file.extension.not.allowed=上传文件的后缀名不允许: {0} "{1}" "{2}" {3}

第二步:在struts.xml文件加载该资源文件

2、多文件上传

上传多个文件, 可以使用数组或 List，其他和单文件上传类似。


package com.itheima.actions;
import java.io.File;
import java.io.IOException;
import org.apache.commons.io.FileUtils;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
//文件上传：fileUpload拦截器完成的
public class UploadAction2 extends ActionSupport {
  private String username;
  private File[] photo;//和表单的上传字段名保持一致。类型是File类型的 .数组或List
  private String[] photoFileName;//上传的文件名
  private String[] photoContentType;//上传文件的MIME类型
  public String upload(){
    //上传字段：上传到某个文件夹。存到应用的images目录下
    String realPath = ServletActionContext.getServletContext().getRealPath("/images");
    File directory = new File(realPath);
    if(!directory.exists()){
      directory.mkdirs();
    }
    try {
      for(int i=0;i<photo.length;i++){
        FileUtils.copyFile(photo[i], new File(directory, photoFileName[i]));
      }
      return SUCCESS;
    } catch (IOException e) {
      e.printStackTrace();
      return ERROR;
    }
  }
}

3、文件下载

原理：struts2提供了stream结果类型，该结果类型就是专门用于支持文件下载功能的

指定stream结果类型需要指定一个 inputName参数，该参数指定一个输入流，提供被下载文件的入口

编码步骤：

1）、动作类DownloadAction ：


package com.itheima.actions;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.InputStream;
import java.net.URLEncoder;
import org.apache.commons.io.FilenameUtils;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
public class DownloadAction extends ActionSupport {
  private InputStream image;//用in有问题的
  private String filename;//文件名
  private long filesize;
  public InputStream getImage() {
    return image;
  }
  public void setImage(InputStream image) {
    this.image = image;
  }
  public String getFilename() {
    return filename;
  }
  public long getFilesize() {
    return filesize;
  }
  public String download() throws Exception{
    //给image字节流赋值
    String fileRealPath = ServletActionContext.getServletContext().getRealPath("/WEB-INF/classes/霉女.jpg");
    filename = FilenameUtils.getName(fileRealPath);
    //方式一：中文文件要进行URL编码
//   filename = URLEncoder.encode(filename, "UTF-8");
    filesize = new File(fileRealPath).length();
    System.out.println(filename);
    image = new FileInputStream(fileRealPath);
    return SUCCESS;
  }
}

struts.xml配置文件：主要是对stream类型的结果进行配置


<struts>
  <constant name="struts.devMode" value="true" />
  <constant name="struts.ognl.allowStaticMethodAccess" value="true" />
    <action name="download" class="com.itheima.actions.DownloadAction" method="download">
      <result type="stream">
        <param name="inputName">image</param><!--动作类中InputStream的字段名，需要在Action中提供getTargetFile方法，返回inputStream-->
        <param name="contentType">application/octet-stream</param><!--告诉浏览器响应头，文件的MIME格式，调用Action中的getContentType方法-->
        <!-- 在struts.xml中使用OGNL表达式获取动作类中属性的值。 调用动作类中的 getFilename()-->
        <!-- 中文文件名编码:方式二.使用OGNL表达式,调用URLEncode的静态方法 -->
        <!-- 默认OGNL调用静态方法是不行的,需要开启一个常量开关.struts.ognl.allowStaticMethodAccess=true -->
        <param name="contentDisposition">attachment;filename=${@java.net.URLEncoder@encode(filename,'UTF-8')}</param><!-- 告诉浏览器的下载方式-->
        <param name="contentLength">${filesize}</param>
      </result>
    </action>
  </package>
</struts>