Java Struts文件上传和下载详解

Struts2文件上传

Struts
2框架提供了内置支持处理文件上传使用基于HTML表单的文件上传。上传一个文件时,它通常会被存储在一个临时目录中,他们应该由Action类进行处理或移动到一个永久的目录,以确保数据不丢失。

请注意,服务器有一个安全策略可能会禁止写到目录以外的临时目录和属于web应用的目录。

在Struts中的文件上传是通过预先定义的拦截文件上传拦截器这是可通过org.apache.struts2.interceptor.FileUploadInterceptor类的defaultStack中的一部分。仍然可以使用在struts.xml中设置各种参数,我们将在下面看到。

概述

  • Struts就是基于mvc模式的框架!(struts其实也是servlet封装,提高开发效率!)
  • Struts开发步骤:
    1. web项目,引入struts – jar包
    2. web.xml中,引入struts的核心功能, 配置过滤器

<!-- 引入struts核心过滤器 -->
    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>struts2</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
  1. 开发action

// 开发action: 处理请求
public class HelloAction extends ActionSupport {

    // 处理请求
    public String execute() throws Exception {
        System.out.println("访问到了action,正在处理请求");
        System.out.println("调用service");
        return "success";
    }
}
  1. 配置action : src/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>
    <package name="xxxx" extends="struts-default">
        <action name="hello" class="cn.itcast.action.HelloAction" method="execute">
            <result name="success">/success.jsp</result>
        </action>
    </package> 
</struts>

视图文件index.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">

    <title>My JSP 'index.jsp' starting page</title>

    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">    
    <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
    <meta http-equiv="description" content="This is my page">
    <!--
    <link rel="stylesheet" type="text/css" href="styles.css">
    -->

  </head>

  <body>
 <form action="Upload.action" method="post" enctype="multipart/form-data">
      <label for="myFile">你要上传的文件</label>
      <input type="file" name="myFile" /><br>

      <input type="submit" value="上传"/>
   </form>
  </body>
</html>

在上面的例子中值得注意几点说明。首先,表单的enctype属性设置为multipart/
form-data。这应该是设置为使得处理文件上传文件上传。下一个点值得注意的是表单的
action方法上传和文件上传字段的名称 –
myFile。我们需要这些信息创建操作方法和struts配置。

接下来让我们创建一个简单的 jsp 文件的success.jsp
结果显示我们的文件上传的情况下成功。

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<%@ 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>文件上传</title>
</head>
<body>
成功
</body>
</html>

Struts框架学习

  • 框架学习概述

    • 框架 : 软件中的框架,是一种半成品;
      我们项目开发需要在框架的基础上进行!因为框架已经实现了一些功能,这样就可以提高开发效率!
  • Struts2框架 :

    • Struts1最早的一种基于mvc模式的框架;Struts2
      是在Struts1的基础上,融合了xwork的功能;
      也可以说,Struts2 = struts1 + xwork
    • Struts2框架预先实现了一些功能:
      1. 请求数据自动封装
      2. 文件上传的功能
      3. 对国际化功能的简化
      4. 数据效验功能
  • Struts2开发流程:一定要使用2.1版本以上

    1. 引入jar文件 :
    • commons-fileupload-1.2.2.jar : 文件上传相关包
    • “ commons-io-2.0.1.jar
    • struts2-core-2.3.4.1.jar : struts2核心功能包
    • xwork-core-2.3.4.1.jar : Xwork核心包
    • ognl-3.0.5.jar : Ognl表达式功能支持表(页面取值类似于EL表达式)
    • commons-lang3-3.1.jar : struts对java.lang包的扩展
    • freemarker-2.3.19.jar : struts的标签模板库jar文件
    • javassist-3.11.0.GA.jar : struts对字节码的处理相关jar
    1. 配置web.xml
    2. Tomcat启动->
    3. 加载自身web.xml—
    4. 加载所有项目的web.xml,
    5. 通过在项目的web.xml中引入过滤器(Struts的核心功能的初始化,通过过滤器完成)

    - filter 执行流程 :  
      - `` init/ `` : 启动执行
      - `` doFilter/ `` : 用户访问执行
      - `` idestroy `` : 销毁执行
    

<!-- 引入struts核心过滤器 -->
    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>struts2</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    - StrutsPrepareAndExecuteFilter : 核心过滤器(``struts2-core-2.3.4.1.jar``)
      - 注意 : 使用的struts的版本不同,核心过滤器类是不一样的!
  1. 开发Action
  2. action类, 也叫做动作类; 一般继承ActionSupport类, 即处理请求的类(
    struts中的action类取代之前的servlet )
  3. action中的业务方法,处理具体的请求

  - 必须返回String
  - 方法不能有参数

public class HelloAction extends ActionSupport {
    // 处理请求
    public String execute() throws Exception {}
}
  1. 配置struts.xml

- package : 定义一个包; 包的作用是管理action(通常,一个业务模板用一个包)
- name : 包的名字, 包名不能重复
- extends : 当前包继承自哪个包, 在struts中,包一定要继承 `` struts-default ``, `` struts-default ``在struts-default.xml中定的包
- abstract : 表示当前包是否为抽象包; 抽象包中不能有action的定义,否则运行时期报错
  - `` abstract=true `` : 只有当当前的包被其他包继承时候才用!
  - 例如:

<package name="basePackage" extends="struts-default" abstract="true"></package>
<package name="user" extends="basePackage">

- namespace : 名称空间,默认为"/", 作为路径的一部分, 访问路径=  http://localhost:8080/项目/名称空间/ActionName
- action : 配置请求路径与Action类的映射关系
  - `` name> `` : 请求路径名称
  - `` class> `` : 请求处理的aciton类的全名
  - `` method> `` : 请求处理方法  
- result
  - `` name> `` : action处理方法返回值 
  - `` <type> `` : 跳转的结果类型
  - 标签体中指定跳转的页面
  • Struts2执行流程

    • 服务器启动 : (1, 2)

      1. 加载项目web.xml
      2. 创建Struts核心过滤器对象, 执行filter->init()
      • struts-default.xml : 核心功能的初始化
      • struts-plugin.xml : struts相关插件
      • struts.xml : 用户编写的配置文件
    • 访问 : (3, 4, 5)

      1. 用户访问Action, 服务器根据访问路径名称,找对应的aciton配置,
        创建action对象
      2. 执行默认拦截器栈中定义的18个拦截器
      3. 执行action的业务处理方法
    • 面试题 : 拦截器什么时候执行? (访问/启动)
      先执行action类创建,先执行拦截器?

      1. 用户访问时候按顺序执行18个拦截器;
      2. 先执行Action类的创建,再执行拦截器;
        最后拦截器执行完,再执行业务方法

  • struts-default.xml, 详解

    • 目录:struts2-core-2.3.4.1.jar/ struts-default.xml
    • 内容:
      1. bean节点指定struts在运行的时候创建的对象类型
        2.指定struts-default包
        【用户写的package(struts.xml)一样要继承此包 】
    • package struts-default 包中定义了:
      a. 跳转的结果类型(<result-type>)

      • dispatcher : 转发(不指定默认为转发)
      • redirect : 重定向
      • redirectAction : 重定向到action资源
      • stream : 文件下载的时候用
        b. 定义了所有的拦截器(<interceptors>)
      • 定义了32个拦截器) :
        为了拦截器引用方便,可以通过定义栈的方式引用拦截器,此时如果引用了栈,栈中的拦截器都会被引用!
      • defaultStack : 默认的栈,其中定义默认要执行的18个拦截器!
        c. 默认执行的拦截器栈、默认执行的action :
      • <default-interceptor-ref name=”defaultStack”/>
      • <default-class-ref
        class=”com.opensymphony.xwork2.ActionSupport” />
  • 共性问题

  • 问题1:Struts.xml配置文件没有提示

    • 解决a:

      1. 找到struts-2.0.dtd文件, 拷贝到某个目录:d:/dtd /..
        (不要用中文目录)
      2. 让MyEclipse关联到上面dtd文件,windows -> preferences
        -> 搜索xml catalog
      • 配置:
        • Location : 上面配置的dtd目录
        • Key : -//Apache Software Foundation//DTD Struts
          Configuration 2.0//EN
    • 解决b:让机器连接互联网,工具会自动下载dtd文件,缓存到MyEclipse中!

创建action类: 处理上传文件

package com.oumyye.FileUpload;

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

public class FileUploadAction extends ActionSupport{
        private File myFile;
       private String myFileContentType;
       private String myFileFileName;
       private String destPath;
    /**
     * 
     */
    private static final long serialVersionUID = 1L;
    @Override
    public String execute() throws Exception {
        // TODO Auto-generated method stub
         destPath = "e:/upload/"; 
          try{
              System.out.println("Src File name: " + myFile);  
              System.out.println("我的文件名"+myFileFileName);
              System.out.println("我的文件类型"+ myFileContentType);
              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;
    }
    public String getDestPath() {
        return destPath;
    }
    public void setDestPath(String destPath) {
        this.destPath = destPath;
    }
    public static long getSerialversionuid() {
        return serialVersionUID;
    }
}

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>
 <!-- struts在运行时候会加载这个总配置文件: src/struts.xml -->    

 <!-- 总配置文件中引入其他所有的配置文件 -->
 <include file="aw/struts/a_action/page1.xml"></include>
 <include file="aw/struts/b_execute/page2.xml"></include>
</struts>
  • page1.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>
    <package name="hello" extends="struts-default" namespace="/">
        <action name="hello" class="aw.struts.a_action.HelloAction" method="add">
            <result name="success">list</result>
        </action>
    </package> 
</struts>
  • page2.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>
    <package name="user" extends="struts-default" namespace="/">
        <action name="login" class="aw.struts.b_execute.UserAction" method="login">
            <result name="login">/index.jsp</result>
        </action>
    </package> 
</struts>

配置文件:

可以使用恒定的标签在应用程序
struts.xml文件,像我一样改变要上传的文件的最大大小。让我们有我们的在struts.xml如下:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd">
<struts>
    <constant name="struts.devMode" value="false" />
    <!-- 指定每次请求到达,重新加载资源文件 -->
    <constant name="struts.i18n.reload" value="true" />
    <!-- 指定每次配置文件更改后,自动重新加载 -->
    <constant name="struts.configuration.xml.reload" value="true" />
    <!-- 把主题配置为simple -->
    <constant name="struts.ui.theme" value="simple" />

    <!-- 指定允许上传的文件最大字节数。默认值是2097152(2M) -->
    <constant name="struts.multipart.maxSize" value="10701096" />
<!--文件上传-->
    <package name="upload" namespace="/" extends="struts-default">
        <action name="Upload" class="com.oumyye.FileUpload.FileUploadAction">
            <result name="success">/success.jsp</result>
            <result name="input">/index.jsp</result>
        </action>

<!--文件下载-->
         <action name="FileDownload" class="com.oumyye.action.FileDownload">  
           <result name="success" type="stream">  
               <param name="contentType">text/plain</param>  
               <param name="contentDisposition">attachment;fileName="${fileName}"</param>  
               <param name="inputName">downloadFile</param>  
               <param name="bufferSize">1024</param>  
           </result>  
       </action>  
    </package>
</struts>

以下是web.xml文件中的内容,与Struts2的基本配置一样

<?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" version="3.0">
  <display-name>Struts2_1000_FileUpload</display-name>
  <filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>*.action</url-pattern>
  </filter-mapping>
</web-app>

Struts2配置

  • Struts2中的Action开发的几种方式

    • 第一种方法 : 继承ActionSupport, 如果使用struts数据校验功能,
      必须继承此类
    • 第二种方法 : 实现Action接口
    • 第三种方法 : 不实现任何接口, 不继承任何类
  • 通配符 :

    • 在Struts2的配置信息中, 可以使用 *{1} 可以优化配置

 <!-- 使用通配符优化上面的步骤 -->
         <!-- http://localhost:8080/struts02/user_login -->
         <action name="user_*" namespace="/user" class="aw.status.a_config.UserAction" method="{1}" >
            <result name="{1}">/{1}.jsp</result>            
        </action>
  • Struts2中的路径匹配原则
    1、获得请求路径的URI,例如url是:/Struts2_01/hello_a/a/b/helloWorld.action
    2、首先查询namespace为 /hello_a/a/b 的package,
    如果存在这个package,则在这个package中查询名字为helloWorld的action,如果不存在这个package则转步骤3
    3、查询namespace为 /hello_a/a 的package,
    如果存在这个package,则在这个package中寻找名字为helloWorld的action,
    如果不存在这个package,则转步骤4
    4、查询namespace为 /hello_a 的package,
    如果存在这个package,则在这个package中寻找名字为helloWorld的action,如果仍然不存在这个package,则转步骤5
    5、查询默认的namaspace的package,
    查询名字为helloWorld的action(默认的命名空间为空字符串“/” )
    如果还是找不到,页面提示404找不到action的异常。

    • 合法路径 :
      • http://localhost:8080/struts/user/user_login
      • http://localhost:8080/struts/user/a/b/c/v/v/v/user_login
    • 不合法路径 :
      • http://localhost:8080/struts/a/user/user_login
  • 默认访问后缀

    • Struts1 与 Struts2的区别 :
      • Struts1中默认访问后缀是.do
      • Struts2中默认访问后缀是.action
    • 如何修改默认的访问后缀 :
      1. Struts2的访问后缀在哪里定义? ->
        Struts-core-2.3.4-1.jar/org.apache.struts/default.properties中84行struts.action.extension=action,,
      2. 修改struts.xml文件

    <!-- 1. 修改Struts默认的访问后缀 -->
    <constant name="struts.action.extension" value="action,do,"></constant>
  • Struts2常量

    • 常量的配置 :

      1. 指定默认编码集,作用于HttpServletRequest的setCharacterEncoding方法
        和freemarker 、velocity的输出 :
        <constant name="struts.i18n.encoding" value="UTF-8"/>
      2. 自定义后缀修改常量 :
        <constant name="struts.action.extension" value="do"/>
      3. 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭
        :
        <constant name="struts.serve.static.browserCache" value="false"/>
      4. 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开
        :
        <constant name="struts.configuration.xml.reload" value="true"/>
      5. 开发模式下使用,这样可以打印出更详细的错误信息 :
        <constant name="struts.devMode" value="true" />
      6. 默认的视图主题 :
        <constant name="struts.ui.theme" value="simple" />
      7. 与spring集成时,指定由spring负责action对象的创建 :
        <constant name="struts.objectFactory" value="spring" />
      8. 该属性设置Struts2是否支持动态方法调用,该属性的默认值是true。如果需要关闭动态方法调用,则可设置该属性为
        false :
        <constant name="struts.enable.DynamicMethodInvocation" value="false"/>
      • actionName + ! + 方法名称
      1. 上传文件的大小限制 :
        <constant name="struts.multipart.maxSize" value=“10701096"/>
    • 全局跳转视图的配置 : (一定要放在action前面)

<!-- 配置全局跳转视图 -->
        <global-results>
            <result name="success">/index.jsp</result>
        </global-results>
  • 配置各项默认值 :

         <!-- 
             name  只配置了访问路径名称
             class 默认执行的action在struts-default有配置
                    <default-class-ref class="com.opensymphony.xwork2.ActionSupport" />
             method  默认为execute
             默认的方法execute返回值为success,对应的页面去全局视图找。

          -->
         <action name="test"></action>

        <!-- 什么情况不配置class? 即处理的aciton -->
        <!-- 答案: 当只是需要跳转到WEB-INF下资源的时候。 -->
         <action name="test2">
            <result name="success" >/WEB-INF/index.jsp</result>
         </action>

上述代码即可完成文件上传

Struts2核心业务

  • 数据处理 : 对数据处理的所有方法, 都是把数据保存到域中
    1. 直接获取ServletAPI
    2. 通过ActionContext获取不同的Map

import java.util.Map;
import javax.servlet.ServletContext;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;
// 数据处理
public class DataAction_bak extends ActionSupport{
    @Override
    public String execute() throws Exception {
        // 1. 请求数据封装; 
        // 2. 调用Service处理业务逻辑,拿到结果数据    
        // 3. 数据保存到域中       
        /*
        // Struts中对数据操作,方式1: 直接拿到ServletApi, 执行操作
        HttpServletRequest request = ServletActionContext.getRequest();
        HttpSession session = request.getSession();
        ServletContext application = ServletActionContext.getServletContext();
        // 操作
        request.setAttribute("request_data", "request_data1");
        session.setAttribute("session_data", "session_data1");
        application.setAttribute("application_data", "application_data1");
        */
        // 【推荐:解耦的方式实现对数据的操作】
        // Struts中对数据操作,方式2: 通过ActionContext类 
        ActionContext ac = ActionContext.getContext();
        // 得到Struts对HttpServletRequest对象进行了封装,封装为一个map
        // 拿到表示request对象的map
        Map<String,Object> request =  ac.getContextMap(); 
        // 拿到表示session对象的map
        Map<String, Object> session = ac.getSession();
        // 拿到表示servletContext对象的map
        Map<String, Object> application = ac.getApplication();

        // 数据
        request.put("request_data", "request_data1_actionContext");
        session.put("session_data", "session_data1_actionContext");
        application.put("application_data", "application_data1_actionContext");

        return SUCCESS;
    }
}
  1. 实现接口的方法

import java.util.Map;
import org.apache.struts2.interceptor.ApplicationAware;
import org.apache.struts2.interceptor.RequestAware;
import org.apache.struts2.interceptor.SessionAware;
import com.opensymphony.xwork2.ActionSupport;
// 数据处理, 方式3: 实现接口的方法
public class DataAction extends ActionSupport implements RequestAware, SessionAware, ApplicationAware{
    private Map<String, Object> request;
    private Map<String, Object> session;
    private Map<String, Object> application;
    // struts运行时候,会把代表request的map对象注入
    @Override
    public void setRequest(Map<String, Object> request) {
        this.request = request;
    }
    // 注入session
    @Override
    public void setSession(Map<String, Object> session) {
        this.session = session;
    }
    // 注入application
    @Override
    public void setApplication(Map<String, Object> application) {
        this.application = application;
    }
    @Override
    public String execute() throws Exception {

        // 数据
        request.put("request_data", "request_data1_actionAware");
        session.put("session_data", "session_data1_actionAware");
        application.put("application_data", "application_data1_actionAware");
//      
        return SUCCESS;
    }
}
  • 请求数据自动封装

    1. JSP表单数据提交到Action中的属性(属性要写Setter方法)
    2. JSP表单数据提交到Action中的对象属性中(对象属性一定要具备getter和setter方法)

    实现原理 : 参数拦截器

  • 类型转换器

    • Struts中jsp提交的数据, struct会自动转化为action中属性的类型,
      对于基本数据类型以及日期数据类型都会自动转化,
      **日期类型只支持: yyyy-MM-dd格式 **
    • 局部类型转换器
      • Struts2中如何配置自定义转换器?
        1、自定义转换器继承StrutsTypeConverter
        2、重写convertFromString和convertToString方法
        3、注册转换器
        3.1 在Action所在包中建立 :
        Action类名-conversion.properties -> (user类
        就叫做userAction-conversion.properties) ,
        文件一定要与Action类放在同一个包下面
        3.2 在3.1文件中添加以下数据:
        需要转换的字段名=自定义转换器类的权限定名
        user.birthday=aw.structs.convertor.DateTypeConvertor
      • 总结 :
        以上的转换器注册时候是与Action的名字相耦合的,因此只能在自己的Action中内部使用,称之为局部转换器注册方式。(Action与文件要同步,
        转换器类可以随便放在任意包下面)
      • 自定义类型转换器

import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Map;
import org.apache.struts2.util.StrutsTypeConverter;
// 自定义类型转换器类
public class MyConverter extends StrutsTypeConverter {
    // 新需求: 要求项目中要支持的格式,如: yyyy-MM-dd/yyyyMMdd/yyyy年MM月dd日..
    // 先定义项目中支持的转换的格式
    DateFormat[] df = { new SimpleDateFormat("yyyy-MM-dd"),
            new SimpleDateFormat("yyyyMMdd"),
            new SimpleDateFormat("yyyy年MM月dd日") };
    /**
     * 把String转换为指定的类型 【String To Date】
     * 
     * @param context : 当前上下文环境
     * @param values :  jsp表单提交的字符串的值
     * @param toClass : 要转换为的目标类型
     */
    @Override
    public Object convertFromString(Map context, String[] values, Class toClass) {
        // 判断: 内容不能为空
        if (values == null || values.length == 0) {
            return null;
        }
        // 判断类型必须为Date
        if (Date.class != toClass) {
            return null;
        }
        // 迭代:转换失败继续下一个格式的转换; 转换成功就直接返回
        for (int i=0; i<df.length; i++) {
            try {
                return df[i].parse(values[0]);
            } catch (ParseException e) {
                continue;
            }
        }
        return null;
    }
    @Override
    public String convertToString(Map context, Object o) {
        return null;
    }
}
  • 全局类型转换器
    • Struts2中如何自定义全局类型转换器?实现的接口和继承的类都是相同的,本质上就是配置的方式不同。
    • 实现
      1. 自定义转换器继承StrutsTypeConverter
      2. 重写convertFromString和convertToString方法
      3. 注册转换器
      4. 在项目src目录下建立以下固定文件 :
        xwork-conversion.properties
      5. 在3.1文件中添加以下数据,
        需要转换的类类型=转换器类的权限定名, 如:
        java.util.Date = aw.strtus.converter.DateConverter
    • 总结 : 该拦截器负责对错误信息进行拦截器
      <interceptor name="conversionError“ class="org.apache.struts2.interceptor.StrutsConversionErrorInterceptor"/>

文件下载

Struts2文件上传/下载

  • Struts2支持文件上传、默认使用的是fileupload工具。导入struts2包的时候可见。
  • 文件上传细节处理: (Struts2默认可以上传的文件大小是2M)
    • Struts2上传文件大小配置
      • 如果上传的文件大于2M,查看控制台错误信息如下 :
        org.apache.commons.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size (77817949) exceeds the configured maximum (2097152)
      • 异常分析 :
        该异常信息是common-fileupload组件输出的,而非是Struts2框架。
      • 设置上传组件的文件大小限制

       <!-- 设置最大上传的大小是80M (80M必须算出来, 不能写80*1024*1024)-->
       <constant name="struts.multipart.maxSize" value="83886080"></constant>

- Struts2上传文件大小配置(文件上传拦截器)

Struts2中是使用FileUpload拦截器进行文件上传的
       <interceptor name="fileUpload" class="org.apache.struts2.interceptor.FileUploadInterceptor"/>
       <interceptor-stack name="defaultStack">
                 <interceptor-ref name="fileUpload"/>
                 ….
       </interceptor-stack>
  • Struts2限制上传文件类型 : (限制后缀)
    • 通过拦截器注入参数(写在<action>内部)
      • FileUploadInterceptor 拦截器API
        • maximumSize :
          上传文件的最大长度(以字节为单位)默认值为2MB
        • allowedTypes : 允许上传文件的类型,
          各类型之间以逗号分隔
        • allowedExtensions : 允许上传文件扩展名,
          各扩展名之间以逗号分隔
      • 配置拦截器参数 :
        允许类型和扩展名同时配置的时候是否可以上传看它们两个的交集

<!-- 限制运行上传的文件的类型 -->
            <interceptor-ref name="defaultStack">
                <!-- 限制运行的文件的扩展名 -->
                <param name="fileUpload.allowedExtensions">txt,jpg,jar</param>

                <!-- 限制运行的类型   【与上面同时使用,取交集】
                <param name="fileUpload.allowedTypes">text/plain</param>
                -->
            </interceptor-ref>
  • 文件上传与下载的代码及配置文件 :
    • 文件上传代码 :

import java.io.File;
import org.apache.commons.io.FileUtils;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
public class FileUpload extends ActionSupport {
    // 对应表单:<input type="file" name="file1">
    private File file1; 
    // 文件名
    private String file1FileName;
    // 文件的类型(MIME)
    private String file1ContentType;
    public void setFile1(File file1) {
        this.file1 = file1;
    }
    public void setFile1FileName(String file1FileName) {
        this.file1FileName = file1FileName;
    }
    public void setFile1ContentType(String file1ContentType) {
        this.file1ContentType = file1ContentType;
    }

    @Override
    public String execute() throws Exception {
        /******拿到上传的文件,进行处理******/
        // 把文件上传到upload目录

        // 获取上传的目录路径
        String path = ServletActionContext.getServletContext().getRealPath("/upload");
        // 创建目标文件对象
        File destFile = new File(path,file1FileName);
        // 把上传的文件,拷贝到目标文件中
        FileUtils.copyFile(file1, destFile);

        return SUCCESS;
    }
}
  • 文件下载代码 :

import java.io.File;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.Map;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;
/**
   * 文件下载
   * 1. 显示所有要下载文件的列表
   * 2. 文件下载
   */
public class DownAction extends ActionSupport {
    /*************1. 显示所有要下载文件的列表*********************/
    public String list() throws Exception {
        //得到upload目录路径
        String path = ServletActionContext.getServletContext().getRealPath("/upload");
        // 目录对象
        File file  = new File(path);
        // 得到所有要下载的文件的文件名
        String[] fileNames =  file.list();
        // 保存
        ActionContext ac = ActionContext.getContext();
        // 得到代表request的map (第二种方式)
        Map<String,Object> request= (Map<String, Object>) ac.get("request");
        request.put("fileNames", fileNames);
        return "list";
    }

    /*************2. 文件下载*********************/
    // 1. 获取要下载的文件的文件名
    private String fileName;
    public void setFileName(String fileName) {
        // 处理传入的参数中问题(get提交)
        try {
            fileName = new String(fileName.getBytes("ISO8859-1"),"UTF-8");
        } catch (UnsupportedEncodingException e) {
            throw new RuntimeException(e);
        }
        // 把处理好的文件名,赋值
        this.fileName = fileName;
    }

    //2. 下载提交的业务方法 (在struts.xml中配置返回stream)
    public String down() throws Exception {
        return "download";
    }

    // 3. 返回文件流的方法
    public InputStream getAttrInputStream(){
        return ServletActionContext.getServletContext().getResourceAsStream("/upload/" + fileName);
    }

    // 4. 下载显示的文件名(浏览器显示的文件名)
    public String getDownFileName() {
        // 需要进行中文编码
        try {
            fileName = URLEncoder.encode(fileName, "UTF-8");
        } catch (UnsupportedEncodingException e) {
            throw new RuntimeException(e);
        }
        return fileName;
    }   
}
  • 配置文件 :

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN"
    "http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
    <package name="upload_" extends="struts-default">
        <!-- 注意: action 的名称不能用关键字"fileUpload" -->
        <action name="fileUploadAction" class="cn.itcast.e_fileupload.FileUpload">

            <!-- 限制运行上传的文件的类型 -->
            <interceptor-ref name="defaultStack">

                <!-- 限制运行的文件的扩展名 -->
                <param name="fileUpload.allowedExtensions">txt,jpg,jar</param>

                <!-- 限制运行的类型   【与上面同时使用,取交集】
                <param name="fileUpload.allowedTypes">text/plain</param>
                -->

            </interceptor-ref>

            <result name="success">/e/success.jsp</result>

            <!-- 配置错误视图 -->
            <result name="input">/e/error.jsp</result>
        </action>

        <action name="down_*" class="cn.itcast.e_fileupload.DownAction" method="{1}">
            <!-- 列表展示 -->
            <result name="list">/e/list.jsp</result>
            <!-- 下载操作 -->
            <result name="download" type="stream">

                <!-- 运行下载的文件的类型:指定为所有的二进制文件类型 -->
               <param name="contentType">application/octet-stream</param>

               <!-- 对应的是Action中属性: 返回流的属性【其实就是getAttrInputStream()】 -->
               <param name="inputName">attrInputStream</param>

               <!-- 下载头,包括:浏览器显示的文件名 -->
               <param name="contentDisposition">attachment;filename=${downFileName}</param>

                <!-- 缓冲区大小设置 -->
               <param name="bufferSize">1024</param>
            </result>
        </action>
    </package>  
</struts>

视图文件filedownload.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
    <title>文件下载</title>
    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">    
    <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
    <meta http-equiv="description" content="This is my page">
    <!--
    <link rel="stylesheet" type="text/css" href="styles.css">
    -->
  </head>
  <body>
    <h2>文件下载内容:</h2><br/>
    Dream.jpg:<a href="FileDownload.action">点击下载</a><br/>
  </body>
</html>

创建action类: 处理上传文件,

package com.oumyye.action;
import java.io.InputStream;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;

//文件下载
public class FileDownload extends ActionSupport{
    private String fileName;
    public String getFileName() {
        return fileName;
    }

    public void setFileName(String fileName) {
        this.fileName = fileName;
    }
    //返回一个输入流,作为一个客户端来说是一个输入流,但对于服务器端是一个 输出流
    public InputStream getDownloadFile() throws Exception
    {

           this.fileName = "hello.jpg" ;
           //获取资源路径
           return ServletActionContext.getServletContext().getResourceAsStream("upload/"+this.fileName) ;
        }
    @Override
    public String execute() throws Exception {   
        return SUCCESS;
    }

}

配置文件同上

下载时可能会出现错误

Can not find a java.io.InputStream with the name [downloadFile] in the invocation stack. Check the <param name="inputName"> tag specified for this action.

可能的原因:

1.文件路径不对,根本就没有取到文件。这种情况下,可以将获得InputStream的那条语句放在system.out.println()中输出一下,若为null,那就是路径不对了,或者说得准确些就根本没有找到文件。

2.在action中没有写配置文件中”<param
name=”inputName”>”后面属性的那个get方法.

发表评论

电子邮件地址不会被公开。 必填项已用*标注