Page History

Description

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

DefaultActionMapper

By default, the DefaultActionMapper is used:

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

Method prefix

{snippet:id=method|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}

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

Action prefix

{snippet:id=action|javadoc=true|url=org.apache.struts2.dispatcher.mapper.DefaultActionMapper}

{snippet:id=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

<bean type="org.apache.struts2.dispatcher.mapper.ActionMapper" name="mymapper" class="com.mycompany.myapp.MyActionMapper" />
<constant name="struts.mapper.class" value="mymapper" />

...

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

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

...

For example with the following in struts.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

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

PrefixBasedActionProxyFactory

{snippet:id=description|javadoc=true|url=org.apache.struts2.

...

factory.PrefixBasedActionProxyFactory}

ActionMapper and ActionMapping objects

...

<bean type="org.apache.struts2.dispatcher.mapper.ActionMapper" name="mymapper" class="com.mycompany.myapp.MyActionMapper" />
<constant name="struts.mapper.class" value="mymapper" />

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

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

See also: RestfulActionMapper

Next: Action Proxy & ActionProxy Factory