クラス PageableHandlerMethodArgumentResolverSupport
java.lang.ObjectSE
org.springframework.data.web.PageableHandlerMethodArgumentResolverSupport
ハンドラーメソッド引数リゾルバーに Web リクエストからページング情報を作成するメソッドを提供する基本クラスです。これにより、コントローラーメソッドに
Pageable インスタンスを挿入できます。解析されるリクエストプロパティは、ページ番号の場合はデフォルトで page、ページサイズの場合はデフォルトで size に設定できます。 必要に応じて、リクエスト内の他のパラメーターと区別するためにパラメーターを prefixed にすることができます。
- 導入:
- 2.2
- 作成者:
- Mark Paluch, Vedran Pavic
- 関連事項:
コンストラクターの概要
コンストラクターメソッドのサマリー
修飾子と型メソッド説明protected int受け入れられる最大ページサイズを取得します。protected PageablegetPageable(MethodParameter methodParameter, StringSE pageString, StringSE pageSizeString) protected StringSEリクエストでページ番号を見つけるために使用されるパラメーター名を取得します。protected StringSEgetParameterNameToUse(StringSE source, MethodParameter parameter) Pageable情報を検索するリクエストパラメーターの名前を返します。protected StringSEリクエストでページサイズを見つけるために使用されるパラメーター名を取得します。booleanisFallbackPageable(Pageable pageable) 指定されたPageableがフォールバックであるかどうかを返します。protected booleanリクエストパラメーターで 1 から始まるページ番号インデックスを公開して想定するかどうかを示します。voidsetFallbackPageable(Pageable fallbackPageable) 解決するメソッドパラメーターでPageableDefaultが見つからない場合に、フォールバックとして使用されるようにPageableを構成します。voidsetMaxPageSize(int maxPageSize) 受け入れられる最大ページサイズを設定します。voidsetOneIndexedParameters(boolean oneIndexedParameters) リクエストパラメーターで 1 から始まるページ番号インデックスを公開して想定するかどうかを構成します。voidsetPageParameterName(StringSE pageParameterName) リクエストでページ番号を見つけるために使用されるパラメーター名を構成します。voidページ番号とページサイズのパラメーターの前に付加する一般的なプレフィックスを構成します。voidsetQualifierDelimiter(StringSE qualifierDelimiter) 修飾子と実際のページ番号およびサイズのプロパティの間に使用される区切り文字。voidsetSizeParameterName(StringSE sizeParameterName) リクエストでページサイズを見つけるために使用されるパラメーター名を設定します。
コンストラクターの詳細
PageableHandlerMethodArgumentResolverSupport
public PageableHandlerMethodArgumentResolverSupport()
メソッドの詳細
setFallbackPageable
解決するメソッドパラメーターでPageableDefaultが見つからない場合に、フォールバックとして使用されるようにPageableを構成します。これを Pageable#unpaged() に設定した場合、リクエストで
Pageableデータが見つからない場合に備えて、コントローラーメソッドがunpagedインスタンスを取得することに注意してください。- パラメーター:
fallbackPageable- 一般的なフォールバックとして使用されるPageable。
isFallbackPageable
指定されたPageableがフォールバックであるかどうかを返します。- パラメーター:
pageable- null でもかまいません。- 戻り値:
setMaxPageSize
public void setMaxPageSize(int maxPageSize) 受け入れる最大ページサイズを設定します。これにより、ページサイズの上限を設定して、OutOfMemoryErrorSE を発行しようとする潜在的な攻撃を防ぐことができます。デフォルトはDEFAULT_MAX_PAGE_SIZEです。- パラメーター:
maxPageSize- 設定する maxPageSize
getMaxPageSize
protected int getMaxPageSize()受け入れられる最大ページサイズを取得します。これにより、ページサイズの上限を設定して、OutOfMemoryErrorSE を発行しようとする潜在的な攻撃を防ぐことができます。デフォルトは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は認定されている可能性があります。- 戻り値:
- リクエストパラメーターの名前。