Action that is defined in
* {@link ContextLoaderPlugIn ContextLoaderPlugIn's}
* {@link WebApplicationContext}.
*
* The proxy is defined in the Struts config file, specifying this
* class as the action class. This class will delegate to a Struts
* Action bean in the ContextLoaderPlugIn context.
*
*
<action path="/login" type="org.springframework.web.struts.DelegatingActionProxy"/>* * The name of the
Action bean in the
* WebApplicationContext will be determined from the mapping
* path and module prefix. This can be customized by overriding the
* determineActionBeanName method.
*
* Example: *
A corresponding bean definition in the ContextLoaderPlugin
* context would look as follows; notice that the Action is now
* able to leverage fully Spring's configuration facilities:
*
*
* <bean name="/login" class="myapp.MyAction"> * <property name="...">...</property> * </bean>* * Note that you can use a single
ContextLoaderPlugIn for all
* Struts modules. That context can in turn be loaded from multiple XML files,
* for example split according to Struts modules. Alternatively, define one
* ContextLoaderPlugIn per Struts module, specifying appropriate
* "contextConfigLocation" parameters. In both cases, the Spring bean name
* has to include the module prefix.
*
* If you want to avoid having to specify DelegatingActionProxy
* as the Action type in your struts-config file (for example to
* be able to generate your Struts config file with XDoclet) consider using the
* {@link DelegatingRequestProcessor DelegatingRequestProcessor}.
* The latter's disadvantage is that it might conflict with the need
* for a different RequestProcessor subclass.
*
*
The default implementation delegates to the {@link DelegatingActionUtils}
* class as much as possible, to reuse as much code as possible with
* DelegatingRequestProcessor and
* {@link DelegatingTilesRequestProcessor}.
*
*
Note: The idea of delegating to Spring-managed Struts Actions originated in
* Don Brown's Spring Struts Plugin.
* ContextLoaderPlugIn and DelegatingActionProxy
* constitute a clean-room implementation of the same idea, essentially
* superseding the original plugin. Many thanks to Don Brown and Matt Raible
* for the original work and for the agreement to reimplement the idea in
* Spring proper!
*
* @author Juergen Hoeller
* @since 1.0.1
* @see #determineActionBeanName
* @see DelegatingRequestProcessor
* @see DelegatingTilesRequestProcessor
* @see DelegatingActionUtils
* @see ContextLoaderPlugIn
*/
public class DelegatingActionProxy extends Action {
/**
* Pass the execute call on to the Spring-managed delegate Action.
* @see #getDelegateAction
*/
public ActionForward execute(
ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response)
throws Exception {
Action delegateAction = getDelegateAction(mapping);
return delegateAction.execute(mapping, form, request, response);
}
/**
* Return the delegate Action for the given mapping.
*
The default implementation determines a bean name from the
* given ActionMapping and looks up the corresponding bean in
* the {@link WebApplicationContext}.
* @param mapping the Struts ActionMapping
* @return the delegate Action
* @throws BeansException if thrown by WebApplicationContext methods
* @see #determineActionBeanName
*/
protected Action getDelegateAction(ActionMapping mapping) throws BeansException {
WebApplicationContext wac = getWebApplicationContext(getServlet(), mapping.getModuleConfig());
String beanName = determineActionBeanName(mapping);
return (Action) wac.getBean(beanName, Action.class);
}
/**
* Fetch ContextLoaderPlugIn's {@link WebApplicationContext} from the
* ServletContext, falling back to the root
* WebApplicationContext.
*
This context is supposed to contain the Struts Action
* beans to delegate to.
* @param actionServlet the associated ActionServlet
* @param moduleConfig the associated ModuleConfig
* @return the WebApplicationContext
* @throws IllegalStateException if no WebApplicationContext could be found
* @see DelegatingActionUtils#findRequiredWebApplicationContext
* @see ContextLoaderPlugIn#SERVLET_CONTEXT_PREFIX
*/
protected WebApplicationContext getWebApplicationContext(
ActionServlet actionServlet, ModuleConfig moduleConfig) throws IllegalStateException {
return DelegatingActionUtils.findRequiredWebApplicationContext(actionServlet, moduleConfig);
}
/**
* Determine the name of the Action bean, to be looked up in
* the WebApplicationContext.
*
The default implementation takes the
* {@link org.apache.struts.action.ActionMapping#getPath mapping path} and
* prepends the
* {@link org.apache.struts.config.ModuleConfig#getPrefix module prefix},
* if any.
* @param mapping the Struts ActionMapping
* @return the name of the Action bean
* @see DelegatingActionUtils#determineActionBeanName
* @see org.apache.struts.action.ActionMapping#getPath
* @see org.apache.struts.config.ModuleConfig#getPrefix
*/
protected String determineActionBeanName(ActionMapping mapping) {
return DelegatingActionUtils.determineActionBeanName(mapping);
}
}