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>.