クラス LocaleChangeInterceptor
java.lang.ObjectSE
org.springframework.web.servlet.i18n.LocaleChangeInterceptor
- 実装されたすべてのインターフェース:
HandlerInterceptor
構成可能なリクエストパラメーター(デフォルトのパラメーター名: "locale" )を介して、リクエストごとに現在のロケールを変更できるインターセプター。
- 導入:
- 20.06.2003
- 作成者:
- Juergen Hoeller, Rossen Stoyanchev
- 関連事項:
フィールドサマリー
コンストラクターのサマリー
方法の概要
修飾子と型メソッド説明StringSE[]
構成された HTTP メソッドを返します。ロケール変更リクエストでロケール仕様を含むパラメーターの名前を返します。boolean
ロケールパラメーターの無効な値を無視するかどうかを返します。protected LocaleSE
parseLocaleValue
(StringSE localeValue) 指定されたロケール値をリクエストパラメーターから取得したものとして解析します。boolean
preHandle
(HttpServletRequestEE request, HttpServletResponseEE response, ObjectSE handler) ハンドラーの実行前のインターセプトポイント。void
setHttpMethods
(StringSE... httpMethods) ロケールを変更できる HTTP メソッドを構成します。void
setIgnoreInvalidLocale
(boolean ignoreInvalidLocale) ロケールパラメーターの無効な値を無視するかどうかを設定します。void
setParamName
(StringSE paramName) ロケール変更リクエストでロケール仕様を含むパラメーターの名前を設定します。クラス java.lang.ObjectSE から継承されたメソッド
clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE
インターフェース org.springframework.web.servlet.HandlerInterceptor から継承されたメソッド
afterCompletion, postHandle
フィールドの詳細
DEFAULT_PARAM_NAME
ロケール指定パラメーターのデフォルト名: "locale"。- 関連事項:
logger
コンストラクターの詳細
LocaleChangeInterceptor
public LocaleChangeInterceptor()
メソッドの詳細
setParamName
ロケール変更リクエストでロケール仕様を含むパラメーターの名前を設定します。デフォルトは「ロケール」です。getParamName
ロケール変更リクエストでロケール仕様を含むパラメーターの名前を返します。setHttpMethods
ロケールを変更できる HTTP メソッドを構成します。- パラメーター:
httpMethods
- メソッド- 導入:
- 4.2
getHttpMethods
構成された HTTP メソッドを返します。- 導入:
- 4.2
setIgnoreInvalidLocale
public void setIgnoreInvalidLocale(boolean ignoreInvalidLocale) ロケールパラメーターの無効な値を無視するかどうかを設定します。- 導入:
- 4.2.2
isIgnoreInvalidLocale
public boolean isIgnoreInvalidLocale()ロケールパラメーターの無効な値を無視するかどうかを返します。- 導入:
- 4.2.2
preHandle
public boolean preHandle(HttpServletRequestEE request, HttpServletResponseEE response, ObjectSE handler) throws ServletExceptionEE インターフェースからコピーされた説明:HandlerInterceptor
ハンドラーの実行前のインターセプトポイント。HandlerMapping が適切なハンドラーオブジェクトを決定した後、HandlerAdapter がハンドラーを呼び出す前に呼び出されます。DispatcherServlet は、任意の数のインターセプターで構成される実行チェーンでハンドラーを処理し、ハンドラー自体を最後に処理します。このメソッドを使用すると、各インターセプターはチェーンの実行を中止することを決定でき、通常は HTTP エラーを送信するか、カスタムレスポンスを作成します。
注意 : 非同期リクエスト処理には特別な考慮事項が適用されます。詳細については、
AsyncHandlerInterceptor
を参照してください。デフォルトの実装は
true
を返します。- 次で指定:
- インターフェース
HandlerInterceptor
のpreHandle
- パラメーター:
request
- 現在の HTTP リクエストresponse
- 現在の HTTP レスポンスhandler
- 型および / またはインスタンス評価のために、実行するために選択されたハンドラー- 戻り値:
- 実行チェーンが次のインターセプターまたはハンドラー自体を続行する必要がある場合は、
true
。そうでない場合、DispatcherServlet は、このインターセプターがすでにレスポンス自体を処理していると想定します。 - 例外:
ServletExceptionEE
parseLocaleValue
指定されたロケール値をリクエストパラメーターから取得したものとして解析します。デフォルトの実装は
StringUtils.parseLocale(String)
を呼び出し、Locale.toString()
形式と BCP 47 言語タグを受け入れます。- パラメーター:
localeValue
- 解析するロケール値- 戻り値:
- 対応する
Locale
インスタンス - 導入:
- 4.3