public class DefaultRequestToViewNameTranslator extends ObjectSE implements RequestToViewNameTranslator
RequestToViewNameTranslator
。DispatcherServlet
コンテキストで viewNameTranslator
Bean として明示的に定義できます。それ以外の場合は、プレーンなデフォルトのインスタンスが使用されます。
デフォルトの変換では、URI のファイル拡張子だけでなく、先頭と末尾のスラッシュも削除され、構成された prefix
および suffix
が適切に追加された結果がビュー名として返されます。
先頭のスラッシュとファイル拡張子の除去は、それぞれ stripLeadingSlash
プロパティと stripExtension
プロパティを使用して無効にできます。
名前の変換を表示するリクエストの例を以下に示します。
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
コンストラクターと説明 |
---|
DefaultRequestToViewNameTranslator() |
修飾子と型 | メソッドと説明 |
---|---|
StringSE | getViewName(HttpServletRequestEE request) 構成されたパラメーターに基づいて、受信 HttpServletRequest EE のリクエスト URI をビュー名に変換します。 |
void | setAlwaysUseFullPath(boolean alwaysUseFullPath) 使用すべきではありません。 5.3 以降、パスは外部で解決され、 ServletRequestPathUtils.getCachedPathValue(ServletRequest) で取得されます |
void | setPrefix(StringSE prefix) 生成されたビュー名の前に付ける接頭辞を設定します。 |
void | setRemoveSemicolonContent(boolean removeSemicolonContent) 使用すべきではありません。 5.3 以降、パスは外部で解決され、 ServletRequestPathUtils.getCachedPathValue(ServletRequest) で取得されます |
void | setSeparator(StringSE separator) ' / ' を置き換える値をビュー名のセパレーターとして設定します。 |
void | setStripExtension(boolean stripExtension) ビュー名を生成するときに、ファイル拡張子を URI から削除するかどうかを設定します。 |
void | setStripLeadingSlash(boolean stripLeadingSlash) ビュー名を生成するときに、先頭のスラッシュを URI から削除するかどうかを設定します。 |
void | setStripTrailingSlash(boolean stripTrailingSlash) ビュー名を生成するときに、末尾のスラッシュを URI から削除するかどうかを設定します。 |
void | setSuffix(StringSE suffix) 生成されたビュー名に追加するサフィックスを設定します。 |
void | setUrlDecode(boolean urlDecode) 使用すべきではありません。 5.3 以降、パスは外部で解決され、 ServletRequestPathUtils.getCachedPathValue(ServletRequest) で取得されます |
void | setUrlPathHelper(UrlPathHelper urlPathHelper) 使用すべきではありません。 5.3 以降、パスは外部で解決され、 ServletRequestPathUtils.getCachedPathValue(ServletRequest) で取得されます |
protected StringSE | transformPath(StringSE lookupPath) リクエスト URI を変換し(webapp のコンテキストで)、スラッシュと拡張子を取り除き、必要に応じてセパレーターを置き換えます。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public void setPrefix(@Nullable StringSE prefix)
prefix
- 生成されたビュー名の前に付ける接頭辞 public void setSuffix(@Nullable StringSE suffix)
suffix
- 生成されたビュー名に追加するサフィックス public void setSeparator(StringSE separator)
/
' を置き換える値をビュー名のセパレーターとして設定します。デフォルトの動作では、セパレーターとして "/
" がそのまま残されます。public void setStripLeadingSlash(boolean stripLeadingSlash)
public void setStripTrailingSlash(boolean stripTrailingSlash)
public void setStripExtension(boolean stripExtension)
@DeprecatedSE public void setAlwaysUseFullPath(boolean alwaysUseFullPath)
ServletRequestPathUtils.getCachedPathValue(ServletRequest)
で取得されます。UrlPathHelper
の同じプロパティへのショートカット。@DeprecatedSE public void setUrlDecode(boolean urlDecode)
ServletRequestPathUtils.getCachedPathValue(ServletRequest)
で取得されます。UrlPathHelper
の同じプロパティへのショートカット。@DeprecatedSE public void setRemoveSemicolonContent(boolean removeSemicolonContent)
ServletRequestPathUtils.getCachedPathValue(ServletRequest)
で取得されます。@DeprecatedSE public void setUrlPathHelper(UrlPathHelper urlPathHelper)
ServletRequestPathUtils.getCachedPathValue(ServletRequest)
で取得されます。UrlPathHelper
を設定します。これを使用して、デフォルトの UrlPathHelper をカスタムサブクラスでオーバーライドするか、複数の Web コンポーネント間で共通の UrlPathHelper 設定を共有します。
public StringSE getViewName(HttpServletRequestEE request)
HttpServletRequest
EE のリクエスト URI をビュー名に変換します。RequestToViewNameTranslator
の getViewName
request
- ビュー名が解決されるコンテキストを提供する受信 HttpServletRequest
EEnull
IllegalArgumentExceptionSE
- 解析された RequestPath も文字列 lookupPath も解決されておらず、リクエスト属性としてキャッシュされていない場合。ServletRequestPathUtils.getCachedPath(ServletRequest)
, transformPath(java.lang.String)