首页 > 代码库 > 深入分析JavaWeb Item47 -- Struts2拦截器与文件上传下载
深入分析JavaWeb Item47 -- Struts2拦截器与文件上传下载
一、struts2中的拦截器(框架功能核心)
1、过滤器VS拦截器
过滤器VS拦截器功能是一回事。
过滤器是Servlet规范中的技术,能够对请求和响应进行过滤。
拦截器是Struts2框架中的技术。实现AOP(面向切面)的编程思想。是可插拔的, 能够对訪问某个 Action 方法之前或之后实施拦截。
拦截器栈(Interceptor Stack): 将拦截器按一定的顺序联结成一条链. 在訪问被拦截的方法时, Struts2拦截器链中的拦截器就会按其之前定义的顺序被依次调用
Struts2运行原理 - 底层分析
2、自己定义拦截器
struts2定义了一个拦截器接口Interceptor接口。
Interceptor接口里面有三个抽象方法
- init: 该方法将在拦截器被创建后马上被调用, 它在拦截器的生命周期内仅仅被调用一次. 能够在该方法中对相关资源进行必要的初始化
- interecept: 每拦截一个动作请求, 该方法就会被调用一次.
- destroy: 该方法将在拦截器被销毁之前被调用, 它在拦截器的生命周期内也仅仅被调用一次.
Struts 会依次调用程序猿为某个 Action 而注冊的每个拦截器的 interecept 方法.每次调用 interecept 方法时, Struts 会传递一个 ActionInvocation 接口的实例.
ActionInvocation: 代表一个给定动作的运行状态, 拦截器能够从该类的对象里获得与该动作相关联的 Action 对象和 Result 对象. 在完毕拦截器自己的任务之后, 拦截器将调用 ActionInvocation 对象的 invoke 方法前进到 Action 处理流程的下一个环节.
还能够调用 ActionInvocation 对象的 addPreResultListener 方法给 ActionInvocation 对象 “挂” 上一个或多个 PreResultListener 监听器. 该监听器对象能够在动作运行完毕之后, 開始运行动作结果之前做些事情
自己定义拦截器步骤:
a、编写一个类。实现com.opensymphony.xwork2.interceptor.Interceptor接口,或者继承
com.opensymphony.xwork2.interceptor.AbstractInterceptor类。(适配器模式),一般都选择继承AbstractInterceptor(拦截器会驻留内存)。
由于AbstractInterceptor 类实现了 Interceptor 接口. 并为 init, destroy 提供了一个空白的实现
编写两个拦截器InterceptorDemo1 ,和InterceptorDemo2
package com.itheima.interceptor;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
public class InterceptorDemo1 extends AbstractInterceptor {
//动作的每次訪问都会调用该方法
public String intercept(ActionInvocation invocation) throws Exception {
System.out.println("拦截前Demo1");
String rtvalue = http://www.mamicode.com/invocation.invoke();//放行,这里为什么返回string?
由于终于的结果返回的Action的Result。而action的结果是string类型
System.out.println("拦截后Demo1");
return rtvalue;
}
}
package com.itheima.interceptor;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
import com.opensymphony.xwork2.interceptor.PreResultListener;
public class InterceptorDemo2 extends AbstractInterceptor {
//动作的每次訪问都会调用该方法
public String intercept(ActionInvocation invocation) throws Exception {
// invocation.addPreResultListener(new PreResultListener() {
//
// public void beforeResult(ActionInvocation invocation, String resultCode) {
// System.out.println("结果显示前");
// }
// });
System.out.println("拦截前Demo2");
String rtvalue = http://www.mamicode.com/invocation.invoke();//放行
System.out.println("拦截后Demo2");
return rtvalue;
}
}
b、须要在struts.xml中进行定义,定义拦截器,先定义在使用。
<package name="p1" extends="struts-default">
<!-- 定义拦截器:仅仅对当前包有效 -->
<interceptors>
<interceptor name="interceprotDemo1" class="com.itheima.interceptor.InterceptorDemo1"></interceptor>
<interceptor name="interceprotDemo2" class="com.itheima.interceptor.InterceptorDemo2"></interceptor>
</interceptors>
</package>
c、在动作配置中就能够使用了
<action name="action1" class="com.itheima.action.Demo1Action" method="execute">
<!-- 使用定义的拦截器。如过没有指定不论什么的拦截器,默认使用default-stack栈中的全部拦截器。
一旦指定了不论什么一个拦截器,默认的就无效了
-->
<interceptor-ref name="interceprotDemo1"></interceptor-ref>
<interceptor-ref name="interceprotDemo2"></interceptor-ref>
<result>/success.jsp</result>
</action>
实现动作类Demo1Action
package com.itheima.action;
import com.opensymphony.xwork2.ActionSupport;
public class Demo1Action extends ActionSupport {
@Override
public String execute() throws Exception {
System.out.println("execute运行了");
return SUCCESS;
}
}
运行结果
由于struts2中如文件上传。数据验证,封装请求參数到action等功能都是由系统默认的defaultStack中的拦截器实现的,所以我们定义的拦截器须要引用系统默认的defaultStack,这样应用才干够使用struts2框架提供的众多功能。
如过没有指定不论什么的拦截器。默认使用default-stack栈中的全部拦截器;一旦指定了不论什么一个拦截器,默认的就无效了除了要使用自己定义的拦截器之外,还要使用defaultStack,能够这么办
方法一:(自己使用),仅仅需在action中配置自己定义的和defaultStack默认的就能够了。
方法二:(大家都用的时候),假设希望包下的全部action都使用自己定义的拦截器, 要使用拦截器栈 interceptor-stack,定义一个interceptor-stack。然后在action中能够通过<default-interceptor-ref name=“mydefaultStack”/>
把拦截器定义为默认拦截器,mydefaultStack名字能够自己取。
<interceptors>
<interceptor name="interceprotDemo1" class="com.itheima.interceptor.InterceptorDemo1"></interceptor>
<interceptor name="interceprotDemo2" class="com.itheima.interceptor.InterceptorDemo2"></interceptor>
<interceptor-stack name="mydefaultStack">
<interceptor-ref name="defaultStack"></interceptor-ref>
<interceptor-ref name="interceprotDemo1"></interceptor-ref>
<interceptor-ref name="interceprotDemo2"></interceptor-ref>
</interceptor-stack>
</interceptors>
<action name="action3" class="com.itheima.action.LoginAction" method="login">
<interceptor-ref name="mydefaultStack"></interceptor-ref>
<result>/success.jsp</result>
</action>
3、Struts2 自带的拦截器
案例1:检查用户是否登录
1、 编写页面login.jsp
<body>
<form action="${pageContext.request.contextPath}/login.action" method="post">
<input type="text" name="username"/><br/>
<input type="text" name="password"/><br/>
<input type="submit" value="登录"/>
</form>
</body>
2、编写登录校验的拦截器LoginCheckInterceptor 类
package com.itheima.interceptor;
import javax.servlet.http.HttpSession;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
public class LoginCheckInterceptor extends AbstractInterceptor {
public String intercept(ActionInvocation invocation) throws Exception {
HttpSession session = ServletActionContext.getRequest().getSession();//通过ServletActionContext对象获得session对象
Object user = session.getAttribute("user");
if(user==null){
//没有登录
return "login";//返回到某个逻辑视图
}
return invocation.invoke();//放行
}
}
3、编写配置文件struts.xml
<package name="p2" extends="struts-default">
<interceptors>
<interceptor name="loginCheckInterceptor" class="com.itheima.interceptor.LoginCheckInterceptor"></interceptor>
<interceptor-stack name="mydefaultStack">
<interceptor-ref name="defaultStack"></interceptor-ref>
<interceptor-ref name="loginCheckInterceptor"></interceptor-ref>
</interceptor-stack>
</interceptors>
<action name="login" class="com.itheima.action.CustomerAction" method="login">
<result>/login.jsp</result>
</action>
</package>
4、编写动作类CustomerAction
package com.itheima.action;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
public class CustomerAction extends ActionSupport {
public String login(){
System.out.println("登录");
ServletActionContext.getRequest().getSession().setAttribute("user", "ppp");
return SUCCESS;
}
}
案例2:监測动作方法的运行效率
编写时间监測过滤器TimerInterceptor
package com.itheima.interceptor;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
public class TimerInterceptor extends AbstractInterceptor {
public String intercept(ActionInvocation invocation) throws Exception {
long time = System.nanoTime();
String rtvalue = http://www.mamicode.com/invocation.invoke();"hljs-string">"运行耗时:"+(System.nanoTime()-time)+"纳秒");
return rtvalue;
}
}
编写配置文件
<package name="p2" extends="struts-default">
<interceptors>
<interceptor name="loginCheckInterceptor" class="com.itheima.interceptor.LoginCheckInterceptor"></interceptor>
<interceptor name="timerInterceptor" class="com.itheima.interceptor.TimerInterceptor"></interceptor>
<interceptor-stack name="mydefaultStack">
<interceptor-ref name="defaultStack"></interceptor-ref>
<interceptor-ref name="loginCheckInterceptor"></interceptor-ref>
<interceptor-ref name="timerInterceptor"></interceptor-ref>
</interceptor-stack>
</interceptors>
<result name="login">/login.jsp</result>
</action>
</package>
从上面能够看出。在一个action 中能够配置多个过滤器。
4、自己定义拦截器:能够指定拦截的方法或不拦截的方法
能够指定拦截的方法或不拦截的方法。编写过滤器时。能够实现类MethodFilterInterceptor。里面有两个字段,通过注入參数就能够指定那些不拦截。两个參数仅仅要用一个就可以,当拦截较少是,能够用includeMethods ,当拦截较多是。能够用排除的方法excludeMethods 。
excludeMethods = Collections.emptySet();//排除那些
includeMethods = Collections.emptySet();//包含那些
案例:再续登录校验的样例。
1、编写过滤器LoginCheckInterceptor
package com.itheima.interceptor;
import javax.servlet.http.HttpSession;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
import com.opensymphony.xwork2.interceptor.MethodFilterInterceptor;
public class LoginCheckInterceptor extends MethodFilterInterceptor {
protected String doIntercept(ActionInvocation invocation) throws Exception {
HttpSession session = ServletActionContext.getRequest().getSession();
Object user = session.getAttribute("user");
if(user==null){
//没有登录
return "login";//返回到某个逻辑视图
}
return invocation.invoke();//放行
}
}
2、编写配置文件
3、编写动作类CustomerAction
package com.itheima.action;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
public class CustomerAction extends ActionSupport {
public String add(){
System.out.println("调用add的service方法");
return SUCCESS;
}
public String edit(){
System.out.println("调用edit的service方法");
return SUCCESS;
}
public String login(){
System.out.println("登录");
ServletActionContext.getRequest().getSession().setAttribute("user", "ppp");
return SUCCESS;
}
}
4、编写页面
addCustomer.jsp
<body>
加入客户
</body>
editCustomer.jsp
<body>
改动客户
</body>
login.jsp
<body>
<form action="${pageContext.request.contextPath}/login.action" method="post">
<input type="text" name="username"/><br/>
<input type="text" name="password"/><br/>
<input type="submit" value="登录"/>
</form>
</body>
success.jsp
<body>
oyeah
</body>
二、文件上传与下载
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>
server忙,一会再试。
</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文件载入该资源文件
<!-- 配置上传文件的出错信息的资源文件 -->
<constant name="struts.custom.i18n.resources" value=http://www.mamicode.com/“cn….xxx.fileuploadmessage“/>
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>
拦截器和文件上传就写到这里了。好累!
深入分析JavaWeb Item47 -- Struts2拦截器与文件上传下载