您的位置: 首页  >  IT文章  >  Struts2 下传单文件详解

Struts2 下传单文件详解

分类: IT文章 • 2024-01-13 22:49:00
Struts2 上传单文件详解

 

  •  表单的enctype属性指定的是表单数据的编码方式,该属性有如下三个值:
     1.application/x-www-form-urlencoded: 这是默认的编码方式,它只处理表单域里的value属性值,采用这种编码方式的表单会将表单域处理成URL编码方法.
     2.multipart/form-data: 这种编码方式会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数里.
     3.text/plain: 这种编码方式当表单的action属性为mailto:URL的形式时比较方便,这种方式主要适用于直接通过表单发送邮件的方式.

 

1.  上传文件的JSP:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib uri="/struts-tags" prefix="s"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>文件上传</title>
</head>
<body>
	<div style="color:red">
		<s:fielderror/>
	</div>
	<!-- 为了完成文件上传,设置该表单的enctype属性为multipart/form-data -->
	<form action="upload.action" method="post" enctype="multipart/form-data">
		选择文件:<input type="file" name="upload" />
		<input type="submit" value="上传" />
	</form>
</body>
</html>

 

2.  下面是处理上传请求的Action类代码:

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.util.Date;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.Action;

public class UploadAction implements Action {
	//封装上传文件域的属性
	private File upload;
	//封装上传文件类型的属性
	private String uploadContentType;
	//封装上传文件名的属性
	private String uploadFileName;
	//接受依赖注入的属性
	private String savePath;
	
	public void setSavePath(String savePath){
		this.savePath = savePath;
	}
	public String getSavePath(){
		return savePath;
	}
	public File getUpload() {
		return upload;
	}
	public void setUpload(File upload) {
		this.upload = upload;
	}
	public String getUploadContentType() {
		return uploadContentType;
	}
	public void setUploadContentType(String uploadContentType) {
		this.uploadContentType = uploadContentType;
	}
	public String getUploadFileName() {
		return uploadFileName;
	}
	public void setUploadFileName(String uploadFileName) {
		this.uploadFileName = uploadFileName;
	}
	@Override
	public String execute() throws Exception {
		String newFileName = null; // 新的文件名
		long now = new Date().getTime(); // 得到当前时间自1970年1月1日0时0分0秒开始流逝的毫秒数,将这个毫秒数作为上传文件新的文件名
		//得到保存上传文件的目录的真实路径
		File filePath = new File(ServletActionContext.getRequest().getRealPath(savePath));
		//如果目录不存在就创建
		if(!filePath.exists())
			filePath.mkdir();
		//判断文件是否有扩展名
		int index = uploadFileName.lastIndexOf('.');
		if(index != -1)
			newFileName = now + uploadFileName.substring(index);
		else
			newFileName = Long.toString(now);

		// 以服务器的文件保存地址加上新的文件名建立上传文件输出流
		FileOutputStream fos = new FileOutputStream(new File(filePath,newFileName));
		// 以上传文件建立一个上传文件流
		FileInputStream fis = new FileInputStream(upload);
		byte[] buffer = new byte[1024*10];
		int len = 0;
		while((len=fis.read(buffer)) > 0 ){
			fos.write(buffer, 0, len);
		}
		fis.close();
		fos.close();
		return SUCCESS;
	}
}
  • 值得注意的是，上面的Action还包含了两个属性：uploadFileName和uploadContentType，这两个属性分别用于封装上传文件的文件名、上传文件的文件类型。Action类直接通过File类属性直接封装了上传文件内容，但这个File属性无法获取上传文件的名和文件类型，所以Struts2直接将文件域中包含的上传文件名和文件类型的信息封装到uploadFileName和uploadContentType属性中。可以认为：如果表单中包含一个name属性为xxx的文件域，则对应Action需要使用3个属性来封装该文件域的信息：
    • 类型为File的xxx属性封装了该文件域对应的文件内容。
    • 类型为String的xxxFileName属性封装了该文件域对应的文件的文件名。
    • 类型为String的xxxContentType属性封装了该文件域对应的文件的文件类型。

3. 以下是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>
	<!-- 指定国际化资源文件的baseName为globalMessage -->
	<constant name="struts.custom.i18n.resources" value="globalMessage" />
	<!-- 设置该应用使用的解码集 -->
	<constant name="struts.i18n.encoding" value="UTF-8" />
	<package name="lee" extends="struts-default">
		<!-- 配置处理文件的Action -->
		<action name="upload" class="lee.UploadAction">
			<!-- 配置fileUpload的拦截器 -->
			<interceptor-ref name="fileUpload">
				<!-- 配置允许上传的文件类型 -->
		 		<param name="allowedTypes">image/bmp,image/png,image/gif,image/jpg,image/pjpeg,image/jpeg</param>
		 		<!-- 配置允许上传的文件大小 -->
		 		<param name="maximumSize">500000</param>
		 	</interceptor-ref>
		 	<interceptor-ref name="defaultStack" />
		 	<!-- 设置Action的属性值,文件保存路径 -->
		 	<param name="savePath">/upload</param>
		 	<!-- 配置Struts2默认的视图页面 -->
			<result>/succ.jsp</result>
			<!-- 配置该应用的input逻辑视图 -->
			<result name="input">/upload.jsp</result>
		</action>
	</package>
</struts>
  •  Struts2 中文件上传的过滤器是fileUpload，配置fileUpload拦截器时，可以为其指定两个参数：
    • allwedTypes: 该参数指定允许上传的文件类型，多个文件类型之间以逗号隔开。
    • maximumSize：该参数指定允许上传的文件大小，单位是字节。
  • 当文件过滤失败后，系统自动转入input逻辑视图，因此必须为该Action配置名为input的逻辑视图。除此之外，还必须显示地为该Action配置defaultStack的拦截器引用，并将defaultStack放到fileUpload拦截器后。

4.   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_2_5.xsd" id="WebApp_ID" version="2.5">
  <display-name>test</display-name>
  <!-- 定义Struts2 的核心Filter -->
  <filter>
		<filter-name>struts</filter-name>
		<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
	</filter>
	<!-- 定义Struts2核心Filter拦截的URL -->
	<filter-mapping>
		<filter-name>struts</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
</web-app>

5. 输入错误提示
       如果上传失败，系统返回原来的上传页面，并输入提示信息,采用国际化信息替换系统默认的提示信息
      globalMessage.properties 文件的代码：

struts.messages.error.uploading=文件上传错误
  struts.messages.error.content.type.not.allowed=不允许上传这种类型的文件
  struts.messages.error.file.too.large=上传的文件超过了限制的长度
  • 当每次上传文件时，都可以在Tomcat的控制台看见如下所示的输入信息：
      INFO(org.apache.Struts2.dispatcher.Dispatcher:624)-Unable to find 'struts.multipart.saveDir'property setting.Defaulting to javax.servlet.context.tempdir
      INFO(org.apache.Struts2.interceptor.FileUploadInterceptor:277)-Removing file upload D:\tomcat5520\work/Catalina\localhost\simpleUpload\ upload_103b2706_112b45dc4a3_8000_00000001.tmp
    • 其中第一个提示信息说，系统找不到struts.multipart.saveDir属性的设置，默认使用javax.servlet.context.tempdir路径，这是因为Struts2执行文件上传过程中，需要指定一个临时文件夹，如果没有指定临时文件夹，系统默认使用javax.servlet.context.tempdir，在Tomcat安装路径下的work\Catalina\localhost\路径下。
    • 第二个提示信息说，系统正在删除一个临时文件，该临时文件就是上传过程中产生的临时文件。
        如果为了避免文件上传是使用Tomcat的工作路径为临时路径，则应该设置struts.multipart.saveDir属性。设置该属性可以通过struts.properties文件设置，如：

      struts.multipart.saveDir = /tmp

      也可以通过Struts.xml文件的常量配置，如：<constant name="struts.multipart.saveDir" value="/tmp"/>
    • 除此之外，还有一个文件上传的属性：struts.multipart.maxSize，该属性设置整个表单请求内容的最大字节数。

相关推荐