Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

The ActionProxy obtains the Action class and calls the appropriate method. By default, Actions are obtained through local instantiation, but an Action could also be obtained remotely if an alternative ActionProxy were provided.

An alternative ActionProxy can be configured through ActionProxyFactory. Typically, an ActionProxy will utilize the ActionInvocation to encapsulate the execution of a particular request.

The ActionInvocation determines how an Action is handled: Is it being intercepted? Is there a PreResultListener acting on it?

Essentially, ActionProxy encapsulates how an Action can be obtained. ActionInvocation encapsulates how the Action is executed when a request is invoked

ActionProxy acts as a representation proxy that is responsible for executing a particular Action. This is such that one could have different means of getting an action. Its customizable through ActionProxyFactory.

ActionInvocation represents a particular action invocation and is customizable through ActionProxyFactory as well. It represents how an action is to be executed (eg. having it intercepted, then execute it, having PreResultListener acting on it before the Result is being executed etc).

Customization

ActionProxyFactory

Code Block
 ActionProxyFactory.setFactory(new MyActionProxyFactory() {

    // Do something interesting.....

 });

ActionProxy

Code Block
 ActionProxyFactory.getFactory(new MyActionProxyFactory() {
    ....
    public ActionProxy createActionProxy(Configuration config, 
           String namespace, String actionName, Map extraContext) 
           throws Exception {
        createActionProxy(config, namespace, actionName, extraContext, true);
    }
    public ActionProxy createActionProxy(Configuration config, 
           String namespace, String actionName, Map extraContext, 
           boolean executeResult, boolean cleanupContext) 
           throws Exception {
        ....
   }
   ....
 });

...

Code Block
 ActionProxyFactory.getFactory(new MyActionProxyFactory() {
    ...
    public ActionInvocation createActionInvocation(ActionProxy actionProxy) 
                            throws Exception {
          createActionInvocation(actionProxy, new LinkedHashMap());
    }
    public ActionInvocation createActionInvocation(ActionProxy actionProxy, 
                            Map extraContext) throws Exception {
          createActionInvocation(actionProxy, extraContext, true);
    }
    public ActionInvocation createActionInvocation(ActionProxy actionProxy, 
                            Map extraContext, boolean pushAction) 
                            throws Exception {
          // doDo implementation of ActionInvocation hererhere
          .....
    }
    ...
 });

Next: Configuration Provider & Configuration