webwork拦截器interceptor 之 ActionInvocation 意义(转载)

“将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方法中相关代码：

Java代码:

private void init() throws Exception ...{    
……    
List interceptorList = new   
ArrayList(proxy.getConfig().getInterceptors());    
interceptors

2. 通过ActionInvocation.invoke方法调用Action实现时，执行Interceptor: 
下面是DefaultActionInvocation中Action调度代码： 
Java代码:

public String <SPAN class=undefined>invoke</SPAN>() 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 = <SPAN class=undefined>invoke</SPAN>Action(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:

Java代码:

public abstract class AroundInterceptor implements Interceptor    
...{    
    protected Log log = LogFactory.getLog(this.getClass());    
        
    public void destroy() ...{    
    }    
        
    public void init() ...{    
    }    
        
    public String intercept(<SPAN class=hilite1>ActionInvocation</SPAN> invocation) throws Exception ...{    
    String result = null;    
    before(invocation);    
    result = invocation.<SPAN class=undefined>invoke</SPAN>();    
    after(invocation, result);    
    return result;    
    }    
        
    protected abstract void after    
    (<SPAN class=hilite1>ActionInvocation</SPAN> <SPAN class=hilite1>actioninvocation</SPAN>, String string) throws Exception;    
        
    protected abstract void before(<SPAN class=hilite1>ActionInvocation</SPAN> <SPAN class=hilite1>actioninvocation</SPAN>)    
    throws Exception;    
}

AroundInterceptor.invoke 方法中，调用了参数invocation的invoke 方法。 

最后，结合最常用的ParametersInterceptor，看看Xwork 是如何通过Interceptor，将Webwork传入的Map类型数据结构，转换为Action所需的Java 模型对象。 

ParametersInterceptor.java: 
Java代码:

public class ParametersInterceptor extends AroundInterceptor ...{    
protected void after(<SPAN class=hilite1>ActionInvocation</SPAN> dispatcher, String result)    
throws Exception ...{    
}    
protected void before(<SPAN class=hilite1>ActionInvocation</SPAN> 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）中实现了数据的转换。 
数据转换的过程并不复杂: 
⑴ 首先由ActionContext获得Map型的参数集parameters。 
⑵ 由ActionContext获得值栈（OgnlValueStack）。 
⑶ 遍历parameters中的各项数据。 
⑷ 通过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); //压栈 
} 
…… 
}