Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Table of Contents
maxLevel3
minLevel2

Description

Wiki Markup
{snippet:id=javadoc|javadoc=true|url=org.apache.struts2.dispatcher.mapper.ActionMapper}

...

Wiki Markup
{snippet:id=action-example|lang=xml|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}

Redirect prefix

Wiki Markup
{snippet:id=redirect|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}
Wiki Markup
{snippet:id=redirect-example|lang=xml|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}

Redirect-action prefix

Wiki Markup
{snippet:id=redirect-action|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}
Wiki Markup
{snippet:id=redirect-action-example|lang=xml|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}

Custom ActionMapper

You can define your own ActionMapper by implementing org.apache.struts2.dispatcher.mapper.ActionMapper then configuring Struts 2 to use the new class in struts.xml

...

Possible uses of the ActionMapper include defining your own, cleaner namespaces, such as URLs like /person/1, which would be similar to a request to /getPerson.action?personID=1 using the DefaultActionMapper.

CompositeActionMapper

A composite action mapper that is capable of delegating to a series of ActionMapper if the former failed to obtained a valid ActionMapping or uri.

It is configured through struts.xml. For example, with the following entries in struts.xml

Code Block
xml

<constant name="struts.mapper.class" value="composite" />
<constant name="struts.mapper.composite" value="struts,restful,restful2" />

When CompositeActionMapper#getMapping(HttpServletRequest, ConfigurationManager) or CompositeActionMapper#getUriFromActionMapping(ActionMapping) is invoked, CompositeActionMapper would go through these ActionMappers in sequence starting from ActionMapper identified by struts.mapper.composite.1, followed by struts.mapper.composite.2 and finally struts.mapper.composite.3 (in this case) until either one of the ActionMapper return a valid result (not null) or it runs out of ActionMapper in which case it will just return null for both CompositeActionMapper#getMapping(HttpServletRequest, ConfigurationManager) and CompositeActionMapper#getUriFromActionMapping(ActionMapping) methods.

For example with the following in struts.xml:

Code Block
xml

<constant name="struts.mapper.class" value="composite" />
<constant name="struts.mapper.composite" value="struts,restful" />

CompositeActionMapper will be configured with 2 ActionMapper, namely "struts" which is org.apache.struts2.dispatcher.mapper.DefaultActionMapper and "restful" which is org.apache.struts2.dispatcher.mapper.RestfulActionMapperRestfulActionMapper. CompositeActionMapper would consult each of them in order described above.

PrefixBasedActionMapper

Wiki Markup
{snippet:id=description|javadoc=true|url=org.apache.struts2.dispatcher.mapper.CompositeActionMapper}PrefixBasedActionMapper}

PrefixBasedActionProxyFactory

Wiki Markup
{snippet:id=description|javadoc=true|url=org.apache.struts2.impl.PrefixBasedActionProxyFactory}

ActionMapper and ActionMapping

...

objects

The ActionMapper fetches the ActionMapping object corresponding to a given request. Essentially, the ActionMapping is a data transfer object that collects together details such as the Action class and method to execute. The mapping is utilized by the Dispatcher and various user interface components. It is customizable through struts.mapper.class entry in struts.properties or struts.xml. Note that the value of this constant is the name of the bean of the new mapper.

...

Code Block
public class MyCustomActionMapper implements ActionMapper {
  public ActionMapping getMapping(HttpServletRequest request,
                                   ConfigurationManager configManager) {
    ....
  }

  public String getUriFromActionMapping(ActionMapping mapping) {
     ....
  }
}

(lightbulb) See also: RestfulActionMapper

...