|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator
public class DefaultRequestToViewNameTranslator
Simply transforms the URI of the incoming request into the view name.
Can be explicitly defined as the "viewNameTranslator" bean in a
DispatcherServlet
context; else,
a plain default instance will be used.
The default transformation simply strips the leading slash and file
extension of the URI and returns the result as the view name with the
configured "prefix"
and and
"suffix"
added as appropriate.
The stripping of the leading slash and file extension can be disabled
using the "stripLeadingSlash"
and
"stripExtension"
properties,
respectively.
Find below some examples of request to view name translation.
http://localhost:8080/gamecast/display.html -> display http://localhost:8080/gamecast/displayShoppingCart.html -> displayShoppingCart http://localhost:8080/gamecast/admin/index.html -> admin/index
RequestToViewNameTranslator
,
ViewResolver
Constructor Summary | |
---|---|
DefaultRequestToViewNameTranslator()
|
Method Summary | |
---|---|
String |
getViewName(HttpServletRequest request)
Translates the request URI of the incoming HttpServletRequest to the
view name based on the configured parameters. |
void |
setAlwaysUseFullPath(boolean alwaysUseFullPath)
Set if URL lookup should always use the full path within the current servlet context. |
void |
setPrefix(String prefix)
Set the prefix to prepend to generated view names. |
void |
setSeparator(String separator)
Set the value that will replace ' / ' as the separator
in the view name. |
void |
setStripExtension(boolean stripExtension)
Set whether or not file extensions should be stripped from the URI when generating the view name. |
void |
setStripLeadingSlash(boolean stripLeadingSlash)
Set whether or not leading slashes should be stripped from the URI when generating the view name. |
void |
setSuffix(String suffix)
Set the suffix to append to generated view names. |
void |
setUrlDecode(boolean urlDecode)
Set if the context path and request URI should be URL-decoded. |
void |
setUrlPathHelper(UrlPathHelper urlPathHelper)
Set the UrlPathHelper to use for
the resolution of lookup paths. |
protected String |
transformPath(String lookupPath)
Transform the request URI (in the context of the webapp) stripping slashes and extensions, and replacing the separator as required. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DefaultRequestToViewNameTranslator()
Method Detail |
---|
public void setPrefix(String prefix)
prefix
- the prefix to prepend to generated view namespublic void setSuffix(String suffix)
suffix
- the suffix to append to generated view namespublic void setSeparator(String separator)
/
' as the separator
in the view name. The default behavior simply leaves '/
'
as the separator.
separator
- the desired separator valuepublic void setStripLeadingSlash(boolean stripLeadingSlash)
stripLeadingSlash
- true
if leading slashes are to be strippedpublic void setStripExtension(boolean stripExtension)
stripExtension
- true
if file extensions should be strippedpublic void setAlwaysUseFullPath(boolean alwaysUseFullPath)
alwaysUseFullPath
- true
if URL lookup should always use the full pathUrlPathHelper.setAlwaysUseFullPath(boolean)
public void setUrlDecode(boolean urlDecode)
Uses either the request encoding or the default encoding according to the Servlet spec (ISO-8859-1).
Note: Setting this to "true" requires JDK 1.4 if the encoding differs from the VM's platform default encoding, as JDK 1.3's URLDecoder class does not offer a way to specify the encoding.
urlDecode
- true
if the context path and request URI should be URL-decodedUrlPathHelper.setUrlDecode(boolean)
public void setUrlPathHelper(UrlPathHelper urlPathHelper)
UrlPathHelper
to use for
the resolution of lookup paths.
Use this to override the default UrlPathHelper with a custom subclass, or to share common UrlPathHelper settings across multiple web components.
urlPathHelper
- the desired helper
IllegalArgumentException
- if the supplied UrlPathHelper is null
public final String getViewName(HttpServletRequest request)
HttpServletRequest
to the
view name based on the configured parameters.
getViewName
in interface RequestToViewNameTranslator
request
- the incoming HttpServletRequest
providing
the context from which a view name is to be resolved
null
)UrlPathHelper.getLookupPathForRequest(javax.servlet.http.HttpServletRequest)
,
transformPath(java.lang.String)
protected String transformPath(String lookupPath)
lookupPath
- the lookup path for the current request,
as determined by the UrlPathHelper
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |