将Web页面中的输入元素封装为一个(请求)数据对象,这个对象就是ActionInvocation类型。
对于Xwork 而言,前端的Webwork 组件为其提供的是一个Map 类型的数据结构。
而Action面向的却是Model对象所提供的数据结构。
写一个辅助类完成对这两种数据结构的转换工作,并在每次Action调用之前由框架代码调用它完成转换工作。
Xwork通过Interceptor实现了这一步骤,从而我们可以根据需要,灵活的配置所需的Interceptor。
从而为Action提供可扩展的预处理、后处理过程。
ActionInvocation 是Xworks 中Action 调度的核心。
而对Interceptor 的调度,也正是由ActionInvocation负责。
ActionInvocation 是一个接口,而DefaultActionInvocation 则是Webwork 对ActionInvocation的默认实现。
Interceptor 的调度流程大致如下:
1. ActionInvocation初始化时,根据配置,加载Action相关的所有Interceptor。
下面是ActionInvocation.init方法中相关代码:
private void init() throws Exception {
......
List interceptorList = new ArrayList(proxy.getConfig().getInterceptors());
interceptors = interceptorList.iterator();
}
2. 通过ActionInvocation.invoke方法调用Action实现时,执行Interceptor:
下面是DefaultActionInvocation中Action调度代码:
public String invoke() throws Exception {
if (executed)
throw new IllegalStateException("Action has already executed");
if (interceptors.hasNext()) {
Interceptor interceptor = (Interceptor) interceptors.next();
resultCode = interceptor.intercept(this);
} else
resultCode = invokeAction(getAction(), proxy.getConfig());
if (!executed) {
if (preResultListeners != null) {
Iterator iterator = preResultListeners.iterator();
while (iterator.hasNext()) {
PreResultListener listener
= (PreResultListener) iterator.next();
listener.beforeResult(this, resultCode);
}
}
if (proxy.getExecuteResult())
executeResult();
executed = true;
}
return resultCode;
}
所有的拦截器都必须实现Interceptor 接口。
public interface Interceptor {
void destroy();
void init();
String intercept(ActionInvocation invocation) throws Exception;
}
在Interceptor实现中,抽象实现AroundInterceptor得到了最广泛的应用(扩展),它增加了预处理(before)和后处理(after)方法的定义。
AroundInterceptor.java:
public abstract class AroundInterceptor implements Interceptor
{
protected Log log = LogFactory.getLog(this.getClass());
public void destroy() {
}
public void init() {
}
public String intercept(ActionInvocation invocation) throws Exception {
String result = null;
before(invocation);
result = invocation.invoke();
after(invocation, result);
return result;
}
protected abstract void after(ActionInvocation actioninvocation, String string) throws Exception;
protected abstract void before(ActionInvocation actioninvocation)
throws Exception;
}
AroundInterceptor.invoke 方法中,调用了参数invocation的invoke 方法。
最后,结合最常用的ParametersInterceptor,看看Xwork 是如何通过Interceptor,将Webwork传入的Map类型数据结构,转换为Action所需的Java 模型对象。
ParametersInterceptor.java:
public class ParametersInterceptor extends AroundInterceptor {
protected void after(ActionInvocation dispatcher, String result) throws Exception {
}
protected void before(ActionInvocation invocation) throws Exception
{
if (!(invocation.getAction() instanceof NoParameters)) {
final Map parameters = ActionContext.getContext().getParameters();
if (log.isDebugEnabled()) {
log.debug("Setting params " + parameters);
}
ActionContext invocationContext = invocation.getInvocationContext();
try {
invocationContext.put(InstantiatingNullHandler.CREATE_NULL_OBJECTS,Boolean.TRUE);
invocationContext.put(XWorkMethodAccessor.DENY_METHOD_EXECUTION,Boolean.TRUE);
invocationContext.put(XWorkConverter.REPORT_CONVERSION_ERRORS,Boolean.TRUE);
if (parameters != null) {
final OgnlValueStack stack = ActionContext.getContext().getValueStack();
for (Iterator iterator = parameters.entrySet().iterator();iterator.hasNext();) {
Map.Entry entry = (Map.Entry) iterator.next();
stack.setValue(entry.getKey().toString(),entry.getValue());
}
}
} finally {
invocationContext.put(InstantiatingNullHandler.CREATE_NULL_OBJECTS,Boolean.FALSE);
invocationContext.put(XWorkMethodAccessor.DENY_METHOD_EXECUTION,Boolean.FALSE);
invocationContext.put(XWorkConverter.REPORT_CONVERSION_ERRORS,Boolean.FALSE);
}
}
}
}
ParametersInterceptor 扩展了抽象类AroundInterceptor。并在其预处理方法(before)中实现了数据的转换。
数据转换的过程并不复杂:
1.首先由ActionContext获得Map型的参数集parameters。
2.由ActionContext获得值栈(OgnlValueStack)。
3.遍历parameters中的各项数据。
4.通过OgnlValueStack,根据数据的键值,为Model 对象填充属性数据。
OgnlValueStack 是http://www.ognl.org4提供的一套可读写对象属性的类库
上面的代码中并没有发现将Model对象入栈的部分,是由于ActionInvocation在初始化的时候已经预先完成了压栈工作,如DefaultActionInvocation.init方法中代码所示:
private void init() throws Exception {
Map contextMap = createContextMap();
createAction();
if (pushAction) {
stack.push(action); //压栈
}
.....
}
对于Xwork 而言,前端的Webwork 组件为其提供的是一个Map 类型的数据结构。
而Action面向的却是Model对象所提供的数据结构。
写一个辅助类完成对这两种数据结构的转换工作,并在每次Action调用之前由框架代码调用它完成转换工作。
Xwork通过Interceptor实现了这一步骤,从而我们可以根据需要,灵活的配置所需的Interceptor。
从而为Action提供可扩展的预处理、后处理过程。
ActionInvocation 是Xworks 中Action 调度的核心。
而对Interceptor 的调度,也正是由ActionInvocation负责。
ActionInvocation 是一个接口,而DefaultActionInvocation 则是Webwork 对ActionInvocation的默认实现。
Interceptor 的调度流程大致如下:
1. ActionInvocation初始化时,根据配置,加载Action相关的所有Interceptor。
下面是ActionInvocation.init方法中相关代码:
private void init() throws Exception {
......
List interceptorList = new ArrayList(proxy.getConfig().getInterceptors());
interceptors = interceptorList.iterator();
}
2. 通过ActionInvocation.invoke方法调用Action实现时,执行Interceptor:
下面是DefaultActionInvocation中Action调度代码:
public String invoke() throws Exception {
if (executed)
throw new IllegalStateException("Action has already executed");
if (interceptors.hasNext()) {
Interceptor interceptor = (Interceptor) interceptors.next();
resultCode = interceptor.intercept(this);
} else
resultCode = invokeAction(getAction(), proxy.getConfig());
if (!executed) {
if (preResultListeners != null) {
Iterator iterator = preResultListeners.iterator();
while (iterator.hasNext()) {
PreResultListener listener
= (PreResultListener) iterator.next();
listener.beforeResult(this, resultCode);
}
}
if (proxy.getExecuteResult())
executeResult();
executed = true;
}
return resultCode;
}
所有的拦截器都必须实现Interceptor 接口。
public interface Interceptor {
void destroy();
void init();
String intercept(ActionInvocation invocation) throws Exception;
}
在Interceptor实现中,抽象实现AroundInterceptor得到了最广泛的应用(扩展),它增加了预处理(before)和后处理(after)方法的定义。
AroundInterceptor.java:
public abstract class AroundInterceptor implements Interceptor
{
protected Log log = LogFactory.getLog(this.getClass());
public void destroy() {
}
public void init() {
}
public String intercept(ActionInvocation invocation) throws Exception {
String result = null;
before(invocation);
result = invocation.invoke();
after(invocation, result);
return result;
}
protected abstract void after(ActionInvocation actioninvocation, String string) throws Exception;
protected abstract void before(ActionInvocation actioninvocation)
throws Exception;
}
AroundInterceptor.invoke 方法中,调用了参数invocation的invoke 方法。
最后,结合最常用的ParametersInterceptor,看看Xwork 是如何通过Interceptor,将Webwork传入的Map类型数据结构,转换为Action所需的Java 模型对象。
ParametersInterceptor.java:
public class ParametersInterceptor extends AroundInterceptor {
protected void after(ActionInvocation dispatcher, String result) throws Exception {
}
protected void before(ActionInvocation invocation) throws Exception
{
if (!(invocation.getAction() instanceof NoParameters)) {
final Map parameters = ActionContext.getContext().getParameters();
if (log.isDebugEnabled()) {
log.debug("Setting params " + parameters);
}
ActionContext invocationContext = invocation.getInvocationContext();
try {
invocationContext.put(InstantiatingNullHandler.CREATE_NULL_OBJECTS,Boolean.TRUE);
invocationContext.put(XWorkMethodAccessor.DENY_METHOD_EXECUTION,Boolean.TRUE);
invocationContext.put(XWorkConverter.REPORT_CONVERSION_ERRORS,Boolean.TRUE);
if (parameters != null) {
final OgnlValueStack stack = ActionContext.getContext().getValueStack();
for (Iterator iterator = parameters.entrySet().iterator();iterator.hasNext();) {
Map.Entry entry = (Map.Entry) iterator.next();
stack.setValue(entry.getKey().toString(),entry.getValue());
}
}
} finally {
invocationContext.put(InstantiatingNullHandler.CREATE_NULL_OBJECTS,Boolean.FALSE);
invocationContext.put(XWorkMethodAccessor.DENY_METHOD_EXECUTION,Boolean.FALSE);
invocationContext.put(XWorkConverter.REPORT_CONVERSION_ERRORS,Boolean.FALSE);
}
}
}
}
ParametersInterceptor 扩展了抽象类AroundInterceptor。并在其预处理方法(before)中实现了数据的转换。
数据转换的过程并不复杂:
1.首先由ActionContext获得Map型的参数集parameters。
2.由ActionContext获得值栈(OgnlValueStack)。
3.遍历parameters中的各项数据。
4.通过OgnlValueStack,根据数据的键值,为Model 对象填充属性数据。
OgnlValueStack 是http://www.ognl.org4提供的一套可读写对象属性的类库
上面的代码中并没有发现将Model对象入栈的部分,是由于ActionInvocation在初始化的时候已经预先完成了压栈工作,如DefaultActionInvocation.init方法中代码所示:
private void init() throws Exception {
Map contextMap = createContextMap();
createAction();
if (pushAction) {
stack.push(action); //压栈
}
.....
}