Home > Guides > Core Developers Guide > Action Proxy & ActionProxy Factory |

Apache Struts 2 Documentation
Action Proxy & ActionProxy Factory
Edit Page Browse Space Add Page Add News

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.

## Customization

### ActionProxyFactory

     ActionProxyFactory.setFactory(new MyActionProxyFactory() {

        // Do something interesting...

     });

### ActionProxy

     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 {
            ....
       }
       ....
     });

### ActionInvocation

     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 {
              // Do implementation of ActionInvocation here
              .....
        }
        ...
     });

## Next: Configuration Provider & Configuration