クラス PageableHandlerMethodArgumentResolverSupport
java.lang.ObjectSE
org.springframework.data.web.PageableHandlerMethodArgumentResolverSupport
ハンドラーメソッド引数リゾルバーに Web リクエストからページング情報を作成するメソッドを提供する基本クラスです。これにより、コントローラーメソッドに
Pageable
インスタンスを挿入できます。解析されるリクエストプロパティは、ページ番号の場合はデフォルトで page
、ページサイズの場合はデフォルトで size
に設定できます。 必要に応じて、リクエスト内の他のパラメーターと区別するためにパラメーターを prefixed
にすることができます。
- 導入:
- 2.2
- 作成者:
- Mark Paluch, Vedran Pavic
- 関連事項:
コンストラクターの概要
コンストラクターメソッドのサマリー
修飾子と型メソッド説明protected int
受け入れられる最大ページサイズを取得します。protected Pageable
getPageable
(MethodParameter methodParameter, StringSE pageString, StringSE pageSizeString) protected StringSE
リクエストでページ番号を見つけるために使用されるパラメーター名を取得します。protected StringSE
getParameterNameToUse
(StringSE source, MethodParameter parameter) Pageable
情報を検索するリクエストパラメーターの名前を返します。protected StringSE
リクエストでページサイズを見つけるために使用されるパラメーター名を取得します。boolean
isFallbackPageable
(Pageable pageable) 指定されたPageable
がフォールバックであるかどうかを返します。protected boolean
リクエストパラメーターで 1 から始まるページ番号インデックスを公開して想定するかどうかを示します。void
setFallbackPageable
(Pageable fallbackPageable) 解決するメソッドパラメーターでPageableDefault
が見つからない場合に、フォールバックとして使用されるようにPageable
を構成します。void
setMaxPageSize
(int maxPageSize) 受け入れられる最大ページサイズを設定します。void
setOneIndexedParameters
(boolean oneIndexedParameters) リクエストパラメーターで 1 から始まるページ番号インデックスを公開して想定するかどうかを構成します。void
setPageParameterName
(StringSE pageParameterName) リクエストでページ番号を見つけるために使用されるパラメーター名を構成します。void
ページ番号とページサイズのパラメーターの前に付加する一般的なプレフィックスを構成します。void
setQualifierDelimiter
(StringSE qualifierDelimiter) 修飾子と実際のページ番号およびサイズのプロパティの間に使用される区切り文字。void
setSizeParameterName
(StringSE sizeParameterName) リクエストでページサイズを見つけるために使用されるパラメーター名を設定します。
コンストラクターの詳細
PageableHandlerMethodArgumentResolverSupport
public PageableHandlerMethodArgumentResolverSupport()
メソッドの詳細
setFallbackPageable
解決するメソッドパラメーターでPageableDefault
が見つからない場合に、フォールバックとして使用されるようにPageable
を構成します。これを Pageable#unpaged() に設定した場合、リクエストで
Pageable
データが見つからない場合に備えて、コントローラーメソッドがunpaged
インスタンスを取得することに注意してください。- パラメーター:
fallbackPageable
- 一般的なフォールバックとして使用されるPageable
。
isFallbackPageable
指定されたPageable
がフォールバックであるかどうかを返します。- パラメーター:
pageable
- null でもかまいません。- 戻り値:
setMaxPageSize
public void setMaxPageSize(int maxPageSize) 受け入れる最大ページサイズを設定します。これにより、ページサイズの上限を設定して、OutOfMemoryError
SE を発行しようとする潜在的な攻撃を防ぐことができます。デフォルトはDEFAULT_MAX_PAGE_SIZE
です。- パラメーター:
maxPageSize
- 設定する maxPageSize
getMaxPageSize
protected int getMaxPageSize()受け入れられる最大ページサイズを取得します。これにより、ページサイズの上限を設定して、OutOfMemoryError
SE を発行しようとする潜在的な攻撃を防ぐことができます。デフォルトはDEFAULT_MAX_PAGE_SIZE
です。- 戻り値:
- 許容される最大ページサイズ。
setPageParameterName
リクエストでページ番号を見つけるために使用されるパラメーター名を構成します。デフォルトはpage
です。- パラメーター:
pageParameterName
- 使用するパラメーター名。null または空であってはなりません。
getPageParameterName
リクエストでページ番号を見つけるために使用されるパラメーター名を取得します。デフォルトはpage
です。- 戻り値:
- 使用するパラメーター名。null または空にはできません。
setSizeParameterName
リクエストでページサイズを見つけるために使用されるパラメーター名を設定します。デフォルトはsize
です。- パラメーター:
sizeParameterName
- 使用するパラメーター名。null または空であってはなりません。
getSizeParameterName
リクエストでページサイズを見つけるために使用されるパラメーター名を取得します。デフォルトはsize
です。- 戻り値:
- 使用するパラメーター名。null または空にはできません。
setPrefix
ページ番号とページサイズのパラメーターの前に付加する一般的なプレフィックスを構成します。アプリケーションで使用されているプロパティ名と競合する場合に使用されるプロパティ名に名前空間を付けるのに役立ちます。デフォルトでは、プレフィックスは使用されません。- パラメーター:
prefix
- 使用する接頭辞、またはデフォルトにリセットする場合は null。
setQualifierDelimiter
修飾子と実際のページ番号およびサイズプロパティの間に使用される区切り文字。デフォルトは_
です。foo
の修飾子は、foo_page
のページ番号パラメーターになります。- パラメーター:
qualifierDelimiter
- 使用する区切り文字、またはデフォルトにリセットする場合は null
setOneIndexedParameters
public void setOneIndexedParameters(boolean oneIndexedParameters) リクエストパラメーターで 1 から始まるページ番号インデックスを公開して想定するかどうかを構成します。デフォルトは false です。つまり、リクエストのページ番号 0 は最初のページと同じです。これが true に設定されている場合、リクエストのページ番号 1 は最初のページと見なされます。- パラメーター:
oneIndexedParameters
- 設定する oneIndexedParameters
isOneIndexedParameters
protected boolean isOneIndexedParameters()リクエストパラメーターで 1 から始まるページ番号インデックスを公開して想定するかどうかを示します。デフォルトは false です。つまり、リクエストのページ番号 0 は最初のページと同じです。これが true に設定されている場合、リクエストのページ番号 1 は最初のページと見なされます。- 戻り値:
- リクエストパラメーターで 1 から始まるページ番号インデックスを想定するかどうか。
getPageable
getParameterNameToUse
Pageable
情報を検索するためのリクエストパラメーターの名前を返します。Qualifier
が存在するかどうか、指定されたMethodParameter
をインスペクションし、指定されたソースパラメーター名にプレフィックスを付けます。- パラメーター:
source
- 基本的なパラメーター名。parameter
-MethodParameter
は認定されている可能性があります。- 戻り値:
- リクエストパラメーターの名前。