当然还有很多拦截器栈,我们先来看拦截器
拦截器名< xmlnamespace prefix ="o" ns ="urn:schemas-microsoft-com:office:office" /> |
AliasInterceptor |
【别名拦截器】 |
配置名 |
alias | |
描述 |
允许参数在跨越多个请求时使用不同别名,这个拦截器可将多个action使用不同名字链接起来,然后用于处理同一信息 | |
对应的类 |
com.opensymphony.xwork2.interceptor.AliasInterceptor | |
拦截器名 |
ActionAutowiringInterceptor |
【自动装配拦截器】 |
配置名 |
autowiring | |
描述 |
信息自动装配的拦截器,主要用于当struts2和Spring整合时,Struts可以使用自动装配的方式来访问Spring容器中的Bean. | |
对应的类 |
com.opensymphony.xwork2.spring.interceptor.ActionAutowiringInterceptor | |
拦截器名 |
ChainingInterceptor |
【链拦截器】 |
配置名 |
chain | |
描述 |
允许当前action能够使用上一个被执行action的属性,这个拦截器通常要和“chain”结果类型一起使用(<result type=”chain”…/>) | |
对应的类 |
com.opensymphony.xwork2.interceptor.ChainingInterceptor | |
拦截器名 |
Checkbox Interceptor |
【多选框拦截器】 |
配置名 |
checkbox | |
描述 |
为没有被选定的多选框增加一个值为false的参数,协助管理多选框(在HTTP请求里,那些没有被选定的多选框通常是没有任何信息的) | |
对应的类 |
org.apache.struts2.interceptor.CheckboxInterceptor | |
拦截器名 |
ConversionErrorInterceptor |
【转换错误拦截器】 |
配置名 |
conversionError | |
描述 |
将转换错误的信息(包括转换的字符串和参数类型等)存放到action的字段错误集里去 | |
对应的类 |
org.apache.struts2.interceptor.StrutsConversionErrorInterceptor | |
拦截器名 |
CookieInterceptor |
【Cookie拦截器】 |
配置名 |
cookie | |
描述 |
使用配置的name,value来指定cookies | |
对应的类 |
org.apache.struts2.interceptor.CookieInterceptor | |
拦截器名 |
ClearSessionInterceptor |
【清除Session拦截器】 |
配置名 |
clearSession | |
描述 |
负责销毁HttpSeesion | |
对应的类 |
N/A | |
拦截器名 |
CreateSessionInterceptor |
【会话创建拦截器】 |
配置名 |
createSession | |
描述 |
自动创建一个HttpSession会话(如果会话不存在),用来为需要使用到HttpSession的拦截器服务 | |
对应的类 |
org.apache.struts2.interceptor.CreateSessionInterceptor | |
拦截器名 |
DebuggingInterceptor |
【调试拦截器】 |
配置名 |
debugging | |
描述 |
当使用Struts2的开发模式时,此拦截器会提供更多的调试信息,为开发者提供几种不同调试界面 | |
对应的类 |
org.apache.struts2.interceptor.debugging.DebuggingInterceptor | |
拦截器名 |
ExternalReferencesInterceptor |
【扩展引用拦截器】 |
配置名 |
externalRef | |
描述 |
负责扩展引用 | |
对应的类 |
com.opensymphony.xwork2.interceptor.ExternalReferencesInterceptor | |
拦截器名 |
ExecuteAndWaitInterceptor |
【执行和等待拦截器】 |
配置名 |
execAndWait | |
描述 |
当action在后台执行时,给用户显示一个过渡性的等待页面 | |
对应的类 |
org.apache.struts2.interceptor.ExecuteAndWaitInterceptor | |
拦截器名 |
ExceptionMappingInterceptor |
【异常拦截器】 |
配置名 |
exception | |
描述 |
将action抛出的异常映射到结果,这样就通过重定向来自动处理异常,一般情况下,应该为最后一个拦截器 | |
对应的类 |
com.opensymphony.xwork2.interceptor.ExceptionMappingInterceptor | |
拦截器名 |
FileUploadInterceptor |
【文件上传拦截器】 |
配置名 |
fileUpload | |
描述 |
此拦截器主要用于文件上传,它负责解析表单中文件域的内容 | |
对应的类 |
org.apache.struts2.interceptor.FileUploadInterceptor | |
拦截器名 |
Internatio-nalization Interceptor |
【国际化拦截器】 |
配置名 |
i18n | |
描述 |
这是支持国际化的拦截器,它负责把所选的语言、区域放入用户Session中。 | |
对应的类 |
com.opensymphony.xwork2.interceptor.I18nInterceptor | |
拦截器名 |
Logging Interceptor |
【日志拦截器】 |
配置名 |
logger | |
描述 |
通过输出被执行action的名字,提供简单的日志功能,记录用于追踪的信息(可位于拦截器序列的不同位置) | |
对应的类 |
com.opensymphony.xwork2.interceptor.LoggingInterceptor | |
拦截器名 |
Message Store Interceptor |
【消息存储拦截器】 |
配置名 |
store | |
描述 |
在会话中为action存储和检索消息、字段错误以及action错误,该拦截器要求action实现ValidationAware接口 | |
对应的类 |
org.apache.struts2.interceptor.MessageStoreInterceptor | |
拦截器名 |
Model Driven Interceptor |
【模型驱动拦截器】 |
配置名 |
modelDriven | |
描述 |
这是一个用于模型驱动的拦截器,当某个Action类实现了ModelDriven接口时,它负责把getModel()方法的结果放入ValueStack中 | |
对应的类 |
com.opensymphony.xwork2.interceptor.ModelDrivenInterceptor | |
拦截器名 |
Scoped Model Driven Interceptor |
【作用域模型驱动拦截器】 |
配置名 |
scopedModelDriven | |
描述 |
如果一个Action实现了一个ScopedModelDriven接口,该拦截器负责从指定生存范围中找出指定的Modol,并将通过setModel方法将该Model传给Action实例 | |
对应的类 |
com.opensymphony.xwork2.interceptor.ScopedModelDrivenInterceptor | |
拦截器名 |
Parameters Interceptor |
【参数拦截器】 |
配置名 |
params | |
描述 |
这是最基本的一个拦截器,它负责解析HTTP请求中的参数,并将参数值设置成Action对应的属性值 | |
对应的类 |
com.opensymphony.xwork2.interceptor.ParametersInterceptor | |
拦截器名 |
Parameter Filter Interceptor |
【参数过滤拦截器】 |
配置名 |
N/A | |
描述 |
控制action对参数的访问(非默认配置) | |
对应的类 |
org.apache.struts2.interceptor.ProfilingActivationInterceptor | |
拦截器名 |
Prepare Interceptor |
【预备拦截器】 |
配置名 |
prepare | |
描述 |
如果action实现Preparable接口,将会调用该拦截器的prepare()方法 | |
对应的类 |
com.opensymphony.xwork2.interceptor.PrepareInterceptor | |
拦截器名 |
Profiling Interceptor |
【概要拦截器】 |
配置名 |
profiling | |
描述 |
允许action记录简单的概要信息日志 | |
对应的类 |
com.opensymphony.xwork2.interceptor.StaticParametersInterceptor | |
拦截器名 |
Scope Interceptor |
【作用域拦截器】 |
配置名 |
scope | |
描述 |
这是范围转换拦截器,它可以将Action状态信息保存到HttpSession范围,或者保存到ServletContext范围内。 | |
对应的类 |
org.apache.struts2.interceptor.ScopeInterceptor | |
拦截器名 |
Servlet Configuration Interceptor |
【Servlet配置拦截器】 |
配置名 |
servletConfig | |
描述 |
如果某个Action需要直接访问ServletAPI,就是通过这个拦截器实现,它提供访问HttpServletRequest和HttpServletResponse的方法,以map的方式访问 | |
对应的类 |
org.apache.struts2.interceptor.ServletConfigInterceptor | |
拦截器名 |
Static Parameters Interceptor |
【静态参数拦截器】 |
配置名 |
staticParams | |
描述 |
设置action里的静态定义值(通过action配置里的param标签来实现);这个拦截器负责将struts.xml文件中<action>标签下<param>标签中的参数传入action | |
对应的类 |
com.opensymphony.xwork2.interceptor.StaticParametersInterceptor | |
拦截器名 |
Roles Interceptor |
【角色拦截器】 |
配置名 |
roles | |
描述 |
这是一个JAAS(Java Authentication and Authorization Service, Java授权和认证服务)拦截器,只有当浏览者取得合适的授权后,才可以调用被该拦截器拦截的Action | |
对应的类 |
org.apache.struts2.interceptor.RolesInterceptor | |
拦截器名 |
Timer Interceptor |
【计时拦截器】 |
配置名 |
timer | |
描述 |
以执行action所花时间的形式,简单记录action概要信息,此拦截器负责输出Action的执行时间,可以利用此拦截器分析该Action的性能瓶颈 | |
对应的类 |
com.opensymphony.xwork2.interceptor.TimerInterceptor | |
拦截器名 |
Token Interceptor |
【令牌拦截器】 |
配置名 |
token | |
描述 |
检查action的合法令牌,以防止重复提交表单,当表单被多次提交时,跳转到一个错误页面 | |
对应的类 |
org.apache.struts2.interceptor.TokenInterceptor | |
拦截器名 |
Token Session Interceptor |
【令牌会话拦截器】 |
配置名 |
tokenSession | |
描述 |
功能与令牌拦截器相同,但是对于非法令牌,提交的数据将保存在会话中,不跳转到错误页面,再次生成与第一次相同的页面。 | |
对应的类 |
org.apache.struts2.interceptor.TokenSessionStoreInterceptor | |
拦截器名 |
ValidationInterceptor |
【验证拦截器】 |
配置名 |
validation | |
描述 |
通过执行在xxxAction-validation.xml中定义的校验器,从而完成数据校验。 | |
对应的类 |
org.apache.struts2.interceptor.validation.AnnotationValidationInterceptor | |
拦截器名 |
Workflow Interceptor |
【工作流拦截器】 |
配置名 |
workflow | |
描述 |
为action定义默认的工作流,一般跟在validation等其他拦截器后,当验证失败时,不执行action然后重定向到INPUT视图 | |
对应的类 |
com.opensymphony.xwork2.interceptor.DefaultWorkflowInterceptor | |
拦截器名 |
JsonValidationInterceptor |
【Json拦截器】 |
配置名 |
jsonValidation | |
描述 |
验证失败,此拦截器可以将fieldErrors和actionErrors两个属性给序列化成json返回给客户端 | |
对应的类 |
com.opensymphony.xwork2.interceptor.annotations.AnnotationWorkflowInterceptor |
以上就是struts2默认的拦截器,我们大部分时间是不需要单独配置这些拦截器的,一般都是配置对应的拦截器栈,下面我们来看对应的拦截器栈都有哪些?都是做什么的?
已配置栈名 |
包含的拦截器 |
描 述 |
basicStack |
exception、servletConfig、prepare、checkbox、params、conversionError |
如使用栈,最起码要使用这几个拦截器 |
validationWorkflowStack |
basicStack、validation、workflow |
在基本栈的基础上增加验证和工作流特性 |
fileUploadStack |
fileUpload、basicStack |
在基本栈的基础上增加文件上传特性 |
modelDrivenStack |
modelDriven、basicStack |
在基本栈的基础上增加模型功能特性 |
chainStack |
chain、basicStack |
在基本栈的基础上增加链接特性 |
i18nStack |
i18n、basicStack |
在基本栈的基础上增加区域持久化特性 |
paramPrepareParamsStack |
exception、alias、params、servletConfig、prepare、i18n、chain、modelDriven、file-Upload、checkbox、staticParams、params、conversionError、vali- dation、workflow |
提供包括前action(pre-action)方法调用的完整栈。params栈使用两次:第一次是在调用prepare()方法之前提供参数,第二次是在预备阶段为可能被检索的对象重新使用参数 |
defaultStack |
exception、alias、servlet- Config、prepare、i18n、chain、debugging、profiling、scoped- ModelDriven、modelDriven、fileUpload、checkbox、static- Params、params、conversion- Error、validation、workflow |
提供一个完整栈,包括调试和概要 |
executeAndWaitStack |
execAndWait、defaultStack、execAndWait |
提供执行与等待栈,比如在上传文件时需要向用户显示一个等待页面时,就可以使用这个栈 |
如果不配置拦截器,默认使用他自己的defaultStack,我们看到,defaultStack包含了基本上所有的拦截器,所以基本上都能满足我们的需求,但是我们一般情况下用不了这么多拦截器栈的,经过这么多拦截器栈肯定会影响性能的,所以我们可以根据不通的场景,选择合适的拦截器栈。如下面的action只需要上传,那我们只需要添加上次的拦截器即可!
<?xml version="1.0" encoding="UTF-8"?>< xmlnamespace prefix ="o" ns ="urn:schemas-microsoft-com:office:office" />
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<package name="upload" namespace="/front/upload" extends="struts-default">
<!-- 对应报下面值包含fileUploadStack拦截器栈 -->
<default-interceptor-ref name="fileUploadStack"></default-interceptor-ref>
<action name="upload"class="com.shunwang.passport.actu.web.ActuUploadAction">
</action>
</package>
</struts>