JavaWeb框架_Struts2_(七)----->文件的上传和下载

　　这个章节是Struts2框架应用最广泛的三个版块（上传下载、国际化、校验输入）之一，所以这一版块的学习还蛮重要的。

1. 章节目录

Struts2文件上传
- 单文件上传
- 拦截器实现文件过滤
- 文件上传常量配置
- Struts2多文件上传
Struts2文件下载

2. 具体内容

2.1Struts2文件上传

2.1.1单文件上传

　　本小节通过一个示例讲解Struts2如何实现单文件的上传。

（1）先写一个选择上传单文件页面（select.jsp）

<%@ taglib prefix="s" uri="/struts-tags" %>
<%--
  Created by IntelliJ IDEA.
  User: mairr
  Date: 17-12-7
  Time: 下午9:04
  To change this template use File | Settings | File Templates.
--%>


<%@ page contentType="text/html;charset=UTF-8" import="java.util.*" language="java" pageEncoding="UTF-8" %>

<html>
<head>
    <title>upload_test</title>
</head>

<body>
    <s:form action="upload" method="post" theme="simple" enctype="multipart/form-data">
        输入帐号：<s:textfield name="uid"/><br>
        选择头像：<s:file name="headImage"/><br>
        <s:submit value="提交"/>
　　　　
　　　　　<s:fielderror/>
　　　　
    </s:form>
</body>
</html>

　　如下所示的一个上传选择界面框：

（2）当文件上传页面提交请求时，请求发送到upload.action，这是一个Struts2的Action，该Action处理上传请求，具体的UploadAction类代码如下：

package action;

import com.opensymphony.xwork2.ActionSupport;
import org.apache.commons.io.FileUtils;
import org.apache.struts2.ServletActionContext;
import java.io.File;
import java.io.IOException;

public class UploadAction extends ActionSupport {
    private String uid;        　　　　　　　　　// 封装帐号（uid）请求参数属性
    private File headImage;     　　　　　　　　// 封装上传文件域属性
    private String headImageContentType;     // 封装上传文件类型的属性
    private String headImageFileName;　　　 　// 封装上传文件属性

    public String getUid() {
        return uid;
    }
    public void setUid(String uid) {
        this.uid = uid;
    }

    public File getHeadImage() {
        return headImage;
    }
    public void setHeadImage(File headImage) {
        this.headImage = headImage;
    }

    public String getHeadImageContentType() {
        return headImageContentType;
    }
    public void setHeadImageContentType(String headImageContentType) {
        this.headImageContentType = headImageContentType;
    }

    public String getHeadImageFileName() {
        return headImageFileName;
    }
    public void setHeadImageFileName(String headImageFileName) {
        this.headImageFileName = headImageFileName;
    }

    public String execute() throws IOException {
        // 上传文件的保存位置在“/image”,该位置在tomcat服务器的“webapps”之中
        String  realpath= ServletActionContext.getServletContext().getRealPath("/image");

        // 声明文件目录image，如果文件名不存在就建一个呗～
        File file = new File(realpath);
        if(!file.exists()){
            file.mkdirs();
        }

        // 实现文件上传，也就是做了一个方法调用～
        FileUtils.copyFile(headImage,new File(file,headImageFileName));
        return SUCCESS;
    }
}

　　需要注意的是，上面的Action除了包含两个表单域的name属性外，还包含headImageContentType和headImageFileName两个属性，这两个属性分别能用于封装上传文件的文件类型、上传文件的文件名。可以这样认为：如果表单中包含一个name属性为xxx的文件域，则对应的Action需要使用3个属性来封装文件域信息：

类型为java.io.File的xxx属性来封装文件域的信息;
类型为String的xxxFileName属性封装了该文件域对应的文本内容;
类型为String的xxxContentType属性封装了该文件域对应的文件类型。

　　所以，在Action的execute方法中，可以直接通过这3个属性获取上传文件的文件名、文件类型和文件内容。

（3）接下来进行UploadAction的配置（struts.xml文件配置），具体代码如下：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE struts PUBLIC
        "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
        "http://struts.apache.org/dtds/struts-2.5.dtd">

<struts>
    <!--指定国际化资源文件（下一章会讲到）-->
    <constant name="struts.custom.i18n.resources" value="messageResource"/>

    <!--设置Struts应用的解码集-->
    <constant name="struts.i18n.encoding" value="utf-8"/>
　　 
　　<!-- ---  包配置  ---- -->
    <package name="default" namespace="/" extends="struts-default">
        <action name="upload" class="action.UploadAction">
            <result>/uploadSuccess.jsp</result>
        </action>
    </package>
</struts>

（4）最后写一个上传成功页面（uploadSuccess.jsp）

<%@ page contentType="text/html;charset=UTF-8" language="java" %>

<html>
<head>
    <title>上传初始页</title>
</head>
<body>
    上传成功!<br>

    <!--输入表单里的用户帐号属性-->
    用户帐号：<s:property value="uid"/><br>

    <!--根据上传文件名字,显示上传头像-->
    您的头像：<img src="<s:property value="'image/' + headImageFileName"/> " alt="图像无法显示"/>
</body>
</html>

　　上传过程图：

　　（a）选择图片

　　（b）确认选择

　　（c）提交之后，显示上传成功

2.1.2 拦截器实现文件的过滤

　　Struts2提供了一个名为fileUpload拦截器，通过配置该拦截器可以轻松地实现文件过滤。为了让fileUpload拦截器起作用，只需要在处理文件上传的Action中配置该拦截器引用即可。
　　配置fileUpload拦截器时可以指定如下两个参数：

allowTypes：该参数指定允许上传文件的类型，多个文件类型之间以英文逗号隔开;
maximumSize：该参数指定允许上传文件的大小，单位是字节。

　　当文件过滤失败后，系统自动转入input逻辑视图，因此必须为Action配置名为input的逻辑视图。

（1）通过拦截器来实现文件过滤的struts.xml配置文件如下：

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE struts PUBLIC
        "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
        "http://struts.apache.org/dtds/struts-2.5.dtd">

<struts>
    <!--指定国际化资源文件（下一讲会讲到）-->
    <constant name="struts.custom.i18n.resources" value="messageResource"/>

    <!--设置Struts应用的解码集-->
    <constant name="struts.i18n.encoding" value="utf-8"/>

    <!--package中加入拦截器-->
    <package name="default" namespace="/" extends="struts-default">
        <interceptors>
            <!--配置拦截器栈(在拦截器章节有讲述)-->
            <interceptor-stack name="myStack">
                <!--配置fileUpload拦截器-->
                <interceptor-ref name="fileUpload">
                    <!--配置允许上传文件的类型（此处要注意的是png图片在ie浏览器中是image/x-png类型）-->
                    <param name="allowedTypes">image/x-png,image/bmp,image/gif,image/jpeg,image/jpg</param>
                    <!--配置允许上传文件大小拦截器，单位是字节（2的16次幂=65536（64k））-->
                    <param name="maximumSize">65536</param>
                </interceptor-ref>
                <interceptor-ref name="defaultStack"/>
            </interceptor-stack>
        </interceptors>

        <action name="upload" class="action.UploadAction">
            <!--使用拦截器栈-->
            <interceptor-ref name="myStack"/>
            <result>/uploadSuccess.jsp</result>

            <!--过滤失败，系统会转入input逻辑视图，这里配置其返回选择界面-->
            <result name="input">/select.jsp</result>
        </action>
    </package>
</struts>

　　格式不对和容量大于64kb会上传失败，直接返回重新选择的界面。如果上传失败，系统需要回应上传失败信息。因此，需要在文件上传页selectFile.jsp页面中加上“<s:filederror/>”——->(我直接加到了selectFile.jsp代码中，你可以回看上面)

（a）文件格式不对

——(提交之后)——->

（b）文件大小超过了限额

——-（提交之后）—–>

2.1.3 文件上传的常量配置

　　上传文件时，系统默认使用web服务器的工作路径作为临时路径。为了避免文件上传时候使用Web服务器的工作路径作为临时路径，则应该设置struts.multipart.saveDir常量。该常量指定上传文件的临时保存路径。该常量配置示例如下：

 <constant name="struts.multipart.saveDir" value="HOME/....(写上路径)..."/>

　　此外，还有一个文件上传的常量struts.multipart.maxSize。该常量指定struts.mutipart.maxSize。该常量指定在struts2文件上传中整个请求内容所允许的最大字节数，默认为2097152（即2MB）。该常量配置示例如下：

<constant name="struts.multipart.maxSize" value="209971520"/>

2.1.4 Struts2多文件上传

　　在Struts2应用中，如果一个页面有多个文件域需要实现上传，则可以为每个文件域提供三个属性，分别封装该文件域对应的文件名、文件类型和文件内容。多文件上传与单文件上传没有什么区别，仅仅是利用数组同时上传多个文件的方式。

　　在处理多文件上传时，要注意改变的是，在Action类中，需要使用三个数组分别封装文件名、文件类型和文件内容。

 // 实现单文件上传代码如下：
FileUtils.copyFile(headImage,new File(file,headImageFileName));

        
 // 实现多文件下载代码如下：
for(int i = 0; i < headImage.length(); i++){
    File uploadImage = headImage[i];
    FileUtils.copyFile(uploadImage,new File(file,headImageFileName[i]));
 }

2.2 Struts2文件下载

　　利用Struts2来处理文件的下载的问题时，能够解决下载文件的文件名为中英文等等都不出现乱码。此外，还能够在用户下载之前进行检查，判断用户是否有足够的权限来下载该文件等。下面用一个示例来讲解文件的下载：

（1）先写一个下载页面：(index.jsp)

<%--
  Created by IntelliJ IDEA.
  User: mairr
  Date: 17-12-9
  Time: 下午2:20
  To change this template use File | Settings | File Templates.
--%>
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>


<html>
  <head>
    <title>test_download</title>
  </head>
  <body>
  　　请下载中文课件：<a href="downLoad.action?downPath=第一章节.doc">中</a><br>
  　　请下载英文课件：<a href="downLoad.action?downPath=chapter01.doc">英</a><br>
  </body>
</html>

（2）在Struts2框架文件下载Action类中，需要提供一个返回InputStream流方法，该输入流代表了被下载文件的入口。该Action类代码如下所示：（DownLoadAction.java）

package action;

import com.opensymphony.xwork2.ActionSupport;
import org.apache.struts2.ServletActionContext;
import util.MyUtil;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;

public class DownLoadAction extends ActionSupport{

    private String downPath;        // 下载时的文件名
    private String contentType;     // 保存文件类型
    private String filename;        // 保存时的文件名

    public String getContentType() {
        return contentType;
    }

    public void setContentType(String contentType) {
        this.contentType = contentType;
    }

    public String getFilename() {
        return filename;
    }

    public void setFilename(String filename) {
        this.filename = filename;
    }

    public String getDownPath() {
        return downPath;
    }
    public void setDownPath(String downPath) {
        try {
            // 解决下载时候的中文文件乱码问题
            downPath = new String(downPath.getBytes("ISO-8859-1"),"UTF-8");
        }catch (UnsupportedEncodingException e){
            e.printStackTrace();
        }
        this.downPath = downPath;
    }

   /*
    *下载用的Action返回一个InputString实例，该方法对应Action配置
    *里面的result的inputName参数，值为inputString
    *
    */

   public InputStream getInputString(){
       return ServletActionContext.getServletContext().getResourceAsStream(downPath);
   }

   public String execute(){
       // 下载保存时的文件名和被下载的文件名一样
       filename = downPath;
       // 下载的文件路径，请在webapps目录下创建images
       downPath = "images/" + downPath;
       // 保存文件的类型

       contentType = "application/x-msdownload";

       /*
        *对下载的文件名按照UTF-8进行编码，解决下载窗口中的中文乱码问题
        * 其中,MyUtil是自己定义的一个类
        */

       filename = MyUtil.toUTF8String(filename);
       return SUCCESS;
   }
}

(3) 在上述的Action类中定义了一个工具类MyUtil，该类中有一个静态方法toUTF8String实现对下载的文件名按照UTF-8进行编码，解决下载窗口中中文乱码的问题：（MyUtil.java）

package util;

import java.io.UnsupportedEncodingException;

public class MyUtil {
    // 对下载文件按照 UTF-8 进行编码

    public static String toUTF8String(String str){
        StringBuffer sb = new StringBuffer();
        int len = str.length();
        for (int i = 0; i < len; i++)
        {
            // 取出字符中的每个字符
            char c = str.charAt(i);
            // Unicode码值在0～255之间，不做处理
            if(c>=0 && c <= 255){
                sb.append(c);
            }else {
                // 转换 UTF-8 编码
                byte b[];
                try{
                    b = Character.toString(c).getBytes("UTF-8");
                }catch(UnsupportedEncodingException e){
                    e.printStackTrace();
                    b = null;
                }
                // 转换为%HH的字符串形式
                for(int j = 0;j < b.length ; j++){
                    int k = b[j];
                    if(k < 0){
                        k &= 255;
                    }
                    sb.append("%" + Integer.toHexString(k).toUpperCase());
                }
            }
        }
        return sb.toString();
    }
}

(4) 最后，完成Action的配置，关键是要配置一个类型为stream的结果，配置时需要指定如下四个属性：

contentType: 指定被下载文件的文件类型;
inputName: 指定被下载文件的入口输入流;
contentDisposition：指定下载的文件名;
bufferSize：指定下载文件时的缓冲大小。

　　具体代码如下：（struts.xml）

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE struts PUBLIC
        "-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
        "http://struts.apache.org/dtds/struts-2.5.dtd">

<struts>
    <package name="default" namespace="/" extends="struts-default">
        <action name="downLoad" class="action.DownLoadAction">
            <!--结果类型为String-->
            <result type="stream">

                <param name="contentType">${contentType}</param>
                <!--默认就是inputStream,它将会指示StreamResult通过
                  inputName属性值的getter和setter方法，如这里就是
                  getInputStream()来获取下载文件的内容,意味着Action
                  要有这个方法
                  -->
                <param name="inputName">inputStream</param>
                 <!--默认为inline（在线打开）,设置为attachment将会告诉浏览器下载
                     该文件,filename指定下载文件时的文件名，若未指定将会以浏览器
                     页面名作为文件名,如：以download.action作为文件名
                   -->
                <param name="contentDisposition">attachment;filename=${filename}</param>
                <!--指定下载文件的缓冲大小-->
                <param name="bufferSize">4096</param>

            </result>
        </action>
    </package>

(5) 最后的下载窗口：

本文链接：http://www.cnblogs.com/Mairr/p/8005178.html

JavaWeb框架_Struts2_(七)----->文件的上传和下载

JavaWeb框架_Struts2_(七)----->文件的上传和下载的更多相关文章

随机推荐

热门专题

目录导航