基于struts2--实现文件上传下载

1. 文件的上传:

1). 表单需要注意的 3 点
①. method="post"     ②. enctype="mulitipart/form-data"      ③. <s:file name=""></s:file>

<s:form action="testUpload" theme="simple" enctype="multipart/form-data" method="post">
	<s:fielderror name="file"></s:fielderror>
	<s:actionerror/>
	<s:text name="file"/><s:file name="file"></s:file>
	<br>
	<s:text name="desc"/><s:textfield name="desc[0]"></s:textfield>
	<br><br>
	<s:submit></s:submit>
</s:form>

2). Struts2 的文件上传实际上使用的是 Commons FileUpload 组件, 所以需要导入
commons-fileupload-1.3.jar
commons-io-2.0.1.jar

3). Struts2 进行文件上传需要使用 FileUpload 拦截器

4). 基本的文件的上传: 直接在 Action 中定义如下 3 个属性, 并提供对应的 getter 和 setter  (注意：变量的命名)

//文件对应的 File 对象
private File [fileFieldName];
//文件类型
private String [fileFieldName]ContentType;
//文件名
private String [fileFieldName]FileName;

5). 使用 IO 流进行文件的上传即可. （同时上传多个文件）

ServletContext servletContext = ServletActionContext.getServletContext();
//		
//		for (int i = 0; i < file.size(); i++) {
//			String dir = servletContext.getRealPath("/file/"+fileFileName.get(i));
//			System.out.println(dir);
//			byte [] buffer = new byte[1024];
//			
//			try {
//				FileOutputStream out = new FileOutputStream(dir);
//				FileInputStream in = new FileInputStream(file.get(i));
//				int len=0;
//				while((len =in.read(buffer))!=-1){//此处(len =in.read(buffer))一定不要忘记用括号括起来，否则报错
//					out.write(buffer, 0, len);
//				}
//				
//				in.close();
//				out.close();
//			} catch (Exception e) {
//				e.printStackTrace();
//			}
//		}		

6). 一次传多个文件怎么办 ?
若传递多个文件, 则上述的 3 个属性, 可以改为 List 类型! 多个文件域的 name 属性值需要一致. （注意每个变量名的命名规则）

private List<File> file;
private List<String> fileContentType;
private List<String> fileFileName;
private List<String> desc;

7). 可以对上传的文件进行限制吗 ? 例如扩展名, 内容类型, 上传文件的大小 ? 若可以, 则若出错, 显示什么错误消息呢 ? 消息可以定制吗 ? 
可以的!
可以通过配置 FileUploadInterceptor 拦截器的参数的方式来进行限制

maximumSize (optional) - 默认的最大值为 2M. 上传的单个文件的最大值
allowedTypes (optional) - 允许的上传文件的类型. 多个使用 , 分割
allowedExtensions (optional) - 允许的上传文件的扩展名. 多个使用 , 分割.

<!-- 通过配置FileUploadInterceptor 拦截器的参数来限制上传文件 -->
<interceptors>
	<interceptor-stack name="lym">
		<interceptor-ref name="defaultStack">
		
			<!-- 文件一次上传的总大小为2MB -->
			<param name="fileUpload.maximumSize">2097152</param>
			<!-- 上传文件的内容类型，多个类型之间用逗号分隔 -->
			<param name="fileUpload.allowedTypes">text/html,text/xml,text/plain</param>
			<!-- 上传文件的扩展名，多个扩展名之间用逗号分隔(注意：扩展名前面没有点) -->
			<param name="fileUpload.allowedExtensions">html,xml,jar,txt</param>
			
		</interceptor-ref>
	</interceptor-stack>
</interceptors>
<!-- 注意：拦截器配置好后别忘了使用 -->
<default-interceptor-ref name="lym"></default-interceptor-ref>

注意: 在 org.apache.struts2 下的 default.properties 中有对上传的文件总的大小的限制. 可以使用常量的方式来修改该限制

<!-- 修改上传文件的总大小 -->
<constant name="struts.multipart.maxSize" value="10000000" />

定制错误消息. 可以在国际化资源文件中定义如下的消息:
struts.messages.error.uploading - 文件上传出错的消息

struts.messages.error.file.too.large - 文件超过最大值的消息

struts.messages.error.content.type.not.allowed - 文件内容类型不合法的消息

struts.messages.error.file.extension.not.allowed - 文件扩展名不合法的消息
问题: 此种方式定制的消息并不完善. 可以参考 org.apache.struts2 下的 struts-messages.properties, 可以提供更多的定制信息.

2. 文件的下载:

1). Struts2 中使用 type="stream" 的 result 进行下载即可

<!-- 文件下载 -->
<action name="testDownload" class="com.lym.struts2.download.app.DownloadAction">
	<result type="stream">
		<param name="bufferSize">2048</param>
		<param name="contentType">text/html</param>
	</result>
</action>

2). 具体使用细节参看 struts-2.3.15.3-all/struts-2.3.15.3/docs/WW/docs/stream-result.html

3). 可以为 stream 的 result 设定如下参数
contentType: 结果类型 (default = text/plain)
contentLength: 下载的文件的长度
contentDisposition: 设定 Content-Dispositoin 响应头. 该响应头指定接应是一个文件下载类型, 一般取值为  attachment;filename="document.pdf".
(default = "attachment;filename=ajax.html").
inputName: 指定文件输入流的 getter 定义的那个属性的名字. (default = inputStream).
bufferSize: 缓存的大小. (default = 1024).
allowCaching: 是否允许使用缓存  (default = true)
contentCharSet: 指定下载的字符集 

4). 以上参数可以在 Action 中以 getter 方法的方式提供，也可以通过参数配置.

<param name="bufferSize">2048</param>
<param name="contentType">text/html</param>

3. 表单的重复提交问题

1). 什么是表单的重复提交
> 在不刷新表单页面的前提下: 
>> 多次点击提交按钮
>> 已经提交成功, 按 "回退" 之后, 再点击 "提交按钮".
>> 在控制器响应页面的形式为转发情况下，若已经提交成功, 然后点击 "刷新(F5)"
> 注意:
>> 若刷新表单页面, 再提交表单不算重复提交
>> 若使用的是 redirect 的响应类型, 已经提交成功后, 再点击 "刷新", 不是表单的重复提交

2). 表单重复提交的危害:  
 > 加重了服务器的负担
 > 可能导致错误操作. 

3). Struts2 解决表单的重复提交问题:

I. 在 s:form 中添加 s:token 子标签：

Struts 提供的 token 标签可以用来生成一个独一无二的标记.
这个标签必须嵌套在 form 标签的内部使用, 它将在表单里插入一个隐藏字段并把标记值（隐藏域的字段的值）保存在HttpSession 对象里. 
Token 标签必须与 Token 或 TokenSession 拦截器配合使用, 这两个拦截器都能对标记进行处理. 

> 生成一个隐藏域
> 在 session 添加一个属性值
> 隐藏域的值和 session 的属性值是一致的. 

II. 使用 Token 或 TokenSession 拦截器. 
> 这两个拦截器均不在默认的拦截器栈中, 所以需要手工配置一下（注意：在配置Token 和 TokenSession拦截器的时候放在defaultStack拦截器的前面，以次来提高性能）
> 若使用 Token 拦截器, 则需要配置一个 name=invalid.token 的 result （注意：配置的是result的name属性，而不是type属性）
例如：<result name="invalid.token">/token_error.jsp</result>

> 若使用 TokenSession 拦截器, 则不需要配置任何其它的 result

	<!-- 解决表单的重复提交问题的拦截器配置 -->
	<action name="testToken" class="com.lym.struts2.token.app.TokenAction">
		<!-- 因为defaultStack拦截器栈中没有token拦截器，所以此处需要自己手动的配一个拦截器  -->
		<!-- 
		<interceptor-ref name="token"></interceptor-ref>
		 -->
		 <interceptor-ref name="tokenSession"></interceptor-ref>
		<interceptor-ref name="defaultStack"></interceptor-ref>
		<result>/success.jsp</result>
		<result name="invalid.token">/token_error.jsp</result>
	</action>

III. Token VS TokenSession
> 都是解决表单重复提交问题的
> 使用 token 拦截器会转到 invalid.token 这个 result
> 使用 tokenSession 拦截器则还会响应那个目标页面, 但不会执行 tokenSession 的后续拦截器（也就是说，Action类的方法不会被执行）. 就像什么都没发生过一样!

IV. 使用token拦截器的时候，可以使用 s:actionerror 标签来显示重复提交的错误消息. 

该错误消息可以在国际化资源文件中覆盖. 该消息可以在 struts-messages.properties 文件中找到

struts.messages.invalid.token=The form has already been processed or no token was supplied, please try again.

4. 自定义拦截器
1). 具体步骤
I. 定义一个拦截器的类
> 可以实现 Interceptor 接口，也可以继承 AbstractInterceptor 抽象类
MyInterceptor.java
package com.lym.struts2.interceptor;

import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;

public class MyInterceptor extends AbstractInterceptor {
/**
* 自定义拦截器需要添加 ActionInvocation 的 invoke()方法来调用其他的拦截器，
* 也可以不调用 ActionInvocation 的 invoke() 方法，直接返回结果. 那么后续的拦截器和 Action 方法将不会被调用.
* Struts 会渲染自定义拦截器 intercept 方法返回值对应的 result
*/
private static final long serialVersionUID = 1L;
@Override
public String intercept(ActionInvocation arg0) throws Exception {
System.out.println("before interceptor...");
String result = arg0.invoke();
System.out.println("after interceptor...");

return result;
}
}

II. 在 struts.xml 文件配置.
 >  可以在action中使用自定义的拦截器，也可以把自定义拦截器添加到默认拦截器栈中来使用。 


<interceptors>

<interceptor name="hello" class="com.atguigu.struts2.interceptors.MyInterceptor"></interceptor>

</interceptors>
<!-- 在action中使用自定义拦截器 -->
<action name="testToken" class="com.atguigu.struts2.token.app.TokenAction">
<interceptor-ref name="hello"></interceptor-ref>
<interceptor-ref name="defaultStack"></interceptor-ref>
<result>/success.jsp</result>
<result name="invalid.token">/token-error.jsp</result>
</action>

<!-- 把自定义拦截器添加到拦截器栈中 -->
<interceptors>
<!-- 自定义拦截器 -->
<interceptor name="hello" class="com.lym.struts2.interceptor.MyInterceptor"></interceptor>
<interceptor-stack name="lym">
<interceptor-ref name="hello"></interceptor-ref>
<interceptor-ref name="defaultStack">
<param name="fileUpload.maximumSize">2097152</param>
<param name="fileUpload.allowedTypes">text/html,text/xml,text/plain,application/octet-stream</param>
</interceptor-ref>
</interceptor-stack>
</interceptors>
<!-- 注意：拦截器配置好后别忘了使用 -->
<default-interceptor-ref name="lym"></default-interceptor-ref>

III. 注意: 在自定义的拦截器中可以选择不调用 ActionInvocation 的 invoke() 方法. 那么后续的拦截器和 Action 方法将不会被调用.
Struts 会渲染自定义拦截器 intercept 方法返回值对应的 result