struts中的invocation

将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);      //压栈

  }

  .....

}