You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@struts.apache.org by lu...@apache.org on 2017/12/08 08:31:04 UTC
[struts-site] 01/08: Cleans up page
This is an automated email from the ASF dual-hosted git repository.
lukaszlenart pushed a commit to branch restful
in repository https://gitbox.apache.org/repos/asf/struts-site.git
commit 9c1e22d65dadb4cea0689afe8e10ef5e03b0dc7b
Author: Lukasz Lenart <lu...@apache.org>
AuthorDate: Fri Dec 8 08:14:31 2017 +0100
Cleans up page
---
source/core-developers/action-mapper.md | 93 ++++++++++++---------------------
1 file changed, 33 insertions(+), 60 deletions(-)
diff --git a/source/core-developers/action-mapper.md b/source/core-developers/action-mapper.md
index a68d84d..1640acd 100644
--- a/source/core-developers/action-mapper.md
+++ b/source/core-developers/action-mapper.md
@@ -133,74 +133,47 @@ and "restful" which is `org.apache.struts2.dispatcher.mapper.RestfulActionMapper
## PrefixBasedActionMapper
-{% comment %}start snippet id=description|javadoc=true|url=org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper {% endcomment %}
-<p> <p>
+A prefix based action mapper that is capable of delegating to other `ActionMapper`s based on the request's prefix.
+It is configured through `struts.xml`. For example, with the following entries in `struts.xml`:
- A prefix based action mapper that is capable of delegating to other {@link ActionMapper}s based on the request's prefix.<br>
-
- It is configured through struts.xml<br>
-
- For example, with the following entries in struts.properties
-
- </p>
-
-
-
- <pre>
-
- <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper"/>
-
- <constant name="struts.mapper.prefixMapping" value="/communities:pseudoRestful,/communityTags:pseudoRestful,/events:pseudoRestful,/mediaList:pseudoRestful,/users:pseudoRestful,/community:struts,/communityTag:struts,/event:struts,/media:struts,/user:struts,:struts"/>
-
- </pre>
-
-
-
- <p>
-
- When {@link PrefixBasedActionMapper#getMapping(HttpServletRequest, ConfigurationManager)} or
-
- {@link PrefixBasedActionMapper#getUriFromActionMapping(ActionMapping)} is invoked,
-
- {@link PrefixBasedActionMapper} will check each possible prefix (url prefix terminating just before a /) to find the most specific ActionMapper that returns a mapping when asked to map the request. If none are found, null is returned for both
-
- {@link PrefixBasedActionMapper#getMapping(HttpServletRequest, ConfigurationManager)} and
-
- {@link PrefixBasedActionMapper#getUriFromActionMapping(ActionMapping)} methods.
-
- </p>
-
-
-
-</p>
-{% comment %}end snippet id=description|javadoc=true|url=org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper {% endcomment %}
+```xml
+<constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper"/>
+
+<constant name="struts.mapper.prefixMapping" value="
+ /communities:pseudoRestful,
+ /communityTags:pseudoRestful,
+ /events:pseudoRestful,
+ /mediaList:pseudoRestful,
+ /users:pseudoRestful,
+ /community:struts,
+ /communityTag:struts,
+ /event:struts,
+ /media:struts,
+ /user:struts,:struts
+"/>
+```
+When `PrefixBasedActionMapper#getMapping(HttpServletRequest, ConfigurationManager)}` or `PrefixBasedActionMapper#getUriFromActionMapping(ActionMapping)}`
+is invoked, `PrefixBasedActionMapper` will check each possible prefix (url prefix terminating just before a `/`) to find
+the most specific `ActionMapper` that returns a mapping when asked to map the request. If none are found, null is returned
+for both `PrefixBasedActionMapper#getMapping(HttpServletRequest, ConfigurationManager)}` and
+`PrefixBasedActionMapper#getUriFromActionMapping(ActionMapping)}` methods.
-__PrefixBasedActionProxyFactory__
+### PrefixBasedActionProxyFactory
-{% comment %}start snippet id=description|javadoc=true|url=org.apache.struts2.factory.PrefixBasedActionProxyFactory {% endcomment %}
-<p> <p>
- Prefix based factory should be used with {@link org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper}
- to use appropriate {@link com.opensymphony.xwork2.ActionProxyFactory} connected with given
- {@link org.apache.struts2.dispatcher.mapper.ActionMapper}
- </p>
+Prefix based factory should be used with `org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper` to use
+appropriate {@link com.opensymphony.xwork2.ActionProxyFactory} connected with given `org.apache.struts2.dispatcher.mapper.ActionMapper`.
- <p>
- Add below entry to struts.xml to enable the factory:
- </p>
+Add below entry to `struts.xml` to enable the factory:
- <pre>
- <constant name="struts.actionProxyFactory" value="prefix"/>
- </pre>
+```xml
+<constant name="struts.actionProxyFactory" value="prefix"/>
+```
- <p>
- The factory will use the same set of patterns as defined with:
- </p>
+The factory will use the same set of patterns as defined with:
- <pre>
+```xml
<constant name="struts.mapper.prefixMapping" value="..."/>
- </pre>
-</p>
-{% comment %}end snippet id=description|javadoc=true|url=org.apache.struts2.factory.PrefixBasedActionProxyFactory {% endcomment %}
+```
## ActionMapper and ActionMapping objects
--
To stop receiving notification emails like this one, please contact
"commits@struts.apache.org" <co...@struts.apache.org>.