Author: bdelacretaz
Date: Thu May 16 09:21:20 2013
New Revision: 1483271
URL: http://svn.apache.org/r1483271
Log:
fix lists formatting
Modified:
sling/site/trunk/content/documentation/the-sling-engine/resources.mdtext
Modified:
sling/site/trunk/content/documentation/the-sling-engine/resources.mdtext
URL:
http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/the-sling-engine/resources.mdtext?rev=1483271&r1=1483270&r2=1483271&view=diff
==============================================================================
--- sling/site/trunk/content/documentation/the-sling-engine/resources.mdtext
(original)
+++ sling/site/trunk/content/documentation/the-sling-engine/resources.mdtext
Thu May 16 09:21:20 2013
@@ -24,10 +24,9 @@ The general algorithm of the two methods
1. Call `HttpServletRequest.getScheme(), .getServerName(), getServerPort` to
get an absolute path out of the request URL: \[scheme\]({{ refs.scheme.path
}})/\[host\].\[port\]\[path\] (`resolve(HttpServletRequest, String)` method
only, which)
1. Check whether any virtual path matches the absolute path. If such a match
exists, the next step is entered with the match.
1. Apply a list of mappings in order to create a mapped path. The first mapped
path resolving to a Resource is assumed success and the Resource found is
returned.
-1. If no mapping created a mapped path addressing an existing Resource, the
method fails and returns:
-
- * The `resolve(String)` and `resolve(HttpServletRequest,String)` methods
return a `NonExistingResource`
- * The `getResource(String path)` and `getResource(Resource base, String
path)` methods return null
+1. If no mapping created a mapped path addressing an existing Resource, the
method fails and returns a `NonExistingResource` (for the
+`resolve(String)` and `resolve(HttpServletRequest,String)`) or null (for the
`getResource(String path)`
+and `getResource(Resource base, String path)` methods).
The virtual path mapping may be used to create shortcut URLs for otherwise
long and complicated URLs. An example of such an URL might be the main
administrative page of a CMS system. So, administrators may access the root of
the web application and directed to the main administrative page.
