com.dynamic.sql.plugins.pagination

类 PageInfo<T>

java.lang.Object

com.dynamic.sql.plugins.pagination.AbstractPage

com.dynamic.sql.plugins.pagination.PageInfo<T>

直接已知子类:

ConditionPageInfo

public class PageInfo<T>
extends AbstractPage

字段概要

从类继承的字段 com.dynamic.sql.plugins.pagination.AbstractPage

log, pageIndex, pagePluginTypeName, pageSize, total, totalPage

构造器概要

构造器

限定符	构造器和说明
	PageInfo(int pageIndex, int pageSize)
protected	PageInfo(int pageIndex, int pageSize, String pagePluginTypeName)

方法概要

限定符和类型	方法和说明
static <T> PageInfo<T>	empty() 快速构建空分页对象，默认页码为 1，页大小为 10，数据为 null。
static <T> PageInfo<T>	empty(int pageIndex, int pageSize) 快速构建空分页对象，指定页码和页大小，数据为 null。
static <T> PageInfo<T>	empty(int pageIndex, int pageSize, T records) 快速构建空分页对象，支持自定义页码、页大小和数据内容。
int	getRealSize()
T	getRecords()
boolean	isEmpty() 判断当前分页结果是否为空。
boolean	isNotEmpty() 判断当前分页结果是否非空。
void	selectNextPage() 移动到下一页并查询数据，更新当前对象。
PageInfo<T>	selectNextPage(Supplier<T> selectSupplier) 已过时。 方法设计不合理，不需要重新返回对象，也不需要重复传递查询语句
void	setRecords(T records) 设置分页记录数据。
void	setTotal(long total) 设置总记录数。
String	toString()

从类继承的方法 com.dynamic.sql.plugins.pagination.AbstractPage

getCacheTotal, getPageIndex, getPagePluginTypeName, getPageSize, getTotal, getTotalPage, hasNextPage, hasPreviousPage, initTotalPage

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

PageInfo

public PageInfo(int pageIndex,
                int pageSize)

PageInfo

protected PageInfo(int pageIndex,
                   int pageSize,
                   String pagePluginTypeName)

方法详细资料

getRecords

public T getRecords()

getRealSize

public int getRealSize()

empty

public static <T> PageInfo<T> empty()

快速构建空分页对象，默认页码为 1，页大小为 10，数据为 null。

类型参数:

T - 记录类型

返回:

空的 PageInfo 对象

empty

public static <T> PageInfo<T> empty(int pageIndex,
                                    int pageSize)

快速构建空分页对象，指定页码和页大小，数据为 null。

类型参数:

T - 记录类型

参数:

pageIndex - 页码，通常从 1 开始

pageSize - 每页条数

返回:

空的 PageInfo 对象

empty

public static <T> PageInfo<T> empty(int pageIndex,
                                    int pageSize,
                                    T records)

快速构建空分页对象，支持自定义页码、页大小和数据内容。

类型参数:

T - 记录类型

参数:

pageIndex - 页码，通常从 1 开始

pageSize - 每页条数

records - 数据内容，允许传空集合

返回:

空的 PageInfo 对象

isEmpty

public boolean isEmpty()

判断当前分页结果是否为空。

该方法检查分页查询结果（records）的实际大小。如果结果集是 Collection 或 Map 类型， 则根据其大小判断；如果结果集类型不受支持，将抛出异常。

返回:

true 如果当前分页结果为空（大小为 0）；false 如果结果非空（大小大于 0）。

抛出:

IllegalStateException - 如果 records 的类型不受支持（非 Collection 或 Map）。

另请参阅:

获取实际记录数。, 存储的分页记录。

isNotEmpty

public boolean isNotEmpty()

判断当前分页结果是否非空。

该方法是 isEmpty() 的逻辑否定，用于检查分页查询结果（records）是否包含任何记录。 如果结果集是 Collection 或 Map 类型，则根据其大小判断；如果结果集类型不受支持，将抛出异常。

返回:

true 如果当前分页结果非空（大小大于 0）；false 如果结果为空（大小为 0）。

抛出:

IllegalStateException - 如果 records 的类型不受支持（非 Collection 或 Map）。

另请参阅:

检查结果是否为空。, 获取实际记录数。, 存储的分页记录。

selectNextPage

@Deprecated
public PageInfo<T> selectNextPage(Supplier<T> selectSupplier)

已过时。 方法设计不合理，不需要重新返回对象，也不需要重复传递查询语句

查询下一页的记录并返回相同的对象。

此方法会将当前的页码 pageIndex 自增 ，然后执行查询 Supplier 获取下一页的数据。该方法在实现时优化了查询逻辑，避免了每次都进行总记录数的统计（count 查询）， 从而提高查询性能。

参数:

selectSupplier - 查询方法，来源于SqlContext.select()

返回:

返回下一页的 MapPage 对象，包含更新后的分页信息和查询结果。

另请参阅:

selectNextPage()

selectNextPage

public void selectNextPage()

移动到下一页并查询数据，更新当前对象。

此方法会将当前页码 pageIndex 自增，并使用已存储的查询方法 selectSupplier 获取下一页的数据。调用后，当前 PageInfo 对象将被更新，而不会返回新的对象。

该方法优化了查询逻辑，避免每次分页查询时重复统计总记录数（count 查询）， 适用于高性能分页场景。

注意：调用此方法后，当前对象的数据会被更新，调用者无需重新赋值。

setRecords

public void setRecords(T records)

设置分页记录数据。

参数:

records - 当前页的数据记录，类型为泛型 T

setTotal

public void setTotal(long total)

设置总记录数。
这里重写了setTotal方法，仅仅是为了放开权限，允许用户手动创建分页对象后可以设置新值

覆盖:

setTotal 在类中 AbstractPage

参数:

total - 所有数据的总条数

toString

public String toString()

覆盖:

toString 在类中 Object