org.pinus4j.datalayer

Interface IShardingSlaveQuery

All Superinterfaces:

IDataQuery

All Known Implementing Classes:

ShardingJdbcSlaveQueryImpl

public interface IShardingSlaveQuery
extends IDataQuery

从库查询操作接口.

Author:

duanbn

Method Summary

Modifier and Type	Method and Description
<T> T	findByPkFromSlave(Number pk, IShardingKey<?> shardingValue, Class<T> clazz, boolean useCache, EnumDBMasterSlave slave) 一个从分库分表, 根据主键查询.
<T> List<T>	findByPkListFromSlave(List<? extends Number> pks, IShardingKey<?> shardingValue, Class<T> clazz, boolean useCache, EnumDBMasterSlave slave) 一个从分库分表, 根据多个主键查询.
<T> List<T>	findByPksFromSlave(IShardingKey<?> shardingKey, Class<T> clazz, EnumDBMasterSlave slave, boolean useCache, Number... pks)
<T> List<T>	findByPksFromSlave(IShardingKey<?> shardingValue, Class<T> clazz, EnumDBMasterSlave slave, Number... pks) 一个从分库分表, 根据多个主键查询.
<T> List<T>	findByQueryFromSlave(IQuery query, IShardingKey<?> shardingValue, Class<T> clazz, boolean useCache, EnumDBMasterSlave slave) 根据查询条件对象进行查询.
<T> List<T>	findByShardingPairFromSlave(List<? extends Number> pks, List<IShardingKey<?>> shardingValues, Class<T> clazz, boolean useCache, EnumDBMasterSlave slave) 多个从分库分表, 根据多个主键查询.
<T> List<T>	findByShardingPairFromSlave(List<IShardingKey<?>> shardingValues, Class<T> clazz, EnumDBMasterSlave slave, Number... pks) Deprecated.
List<Map<String,Object>>	findBySqlFromSlave(SQL sql, IShardingKey<?> shardingValue, EnumDBMasterSlave slave) 一个从分库分表, 根据条件查询.
<T> T	findOneByQueryFromSlave(IQuery query, IShardingKey<?> shardingValue, Class<T> clazz, boolean useCache, EnumDBMasterSlave slave) 根据查询条件获取一条数据.
Number	getCountFromSlave(IShardingKey<?> shardingValue, Class<?> clazz, boolean useCache, EnumDBMasterSlave slave) 获取从分库分表记录总数.
void	setPrimaryCache(IPrimaryCache primaryCache) 设置缓存.
void	setSecondCache(ISecondCache secondCache) 设置二级缓存.

Methods inherited from interface org.pinus4j.datalayer.IDataQuery

getDBCluster, getPrimaryCache, getSecondCache, setDBCluster

Method Detail

getCountFromSlave

Number getCountFromSlave(IShardingKey<?> shardingValue,
                         Class<?> clazz,
                         boolean useCache,
                         EnumDBMasterSlave slave)

获取从分库分表记录总数.

Parameters:

shardingValue - 分库分表因子

clazz - 数据对象

Returns:

表记录总数

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findByPkFromSlave

<T> T findByPkFromSlave(Number pk,
                        IShardingKey<?> shardingValue,
                        Class<T> clazz,
                        boolean useCache,
                        EnumDBMasterSlave slave)

一个从分库分表, 根据主键查询.

Parameters:

pk - 主键

shardingValue - 分库分表因子

clazz - 数据对象类型

slave - 主从库枚举

Returns:

查询结果

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findOneByQueryFromSlave

<T> T findOneByQueryFromSlave(IQuery query,
                              IShardingKey<?> shardingValue,
                              Class<T> clazz,
                              boolean useCache,
                              EnumDBMasterSlave slave)

根据查询条件获取一条数据. 如果查询到多条则返回第一条.

Parameters:

query -

shardingValue -

clazz -

slave -

Returns:

查询结果，找不到返回null

findByPksFromSlave

<T> List<T> findByPksFromSlave(IShardingKey<?> shardingValue,
                               Class<T> clazz,
                               EnumDBMasterSlave slave,
                               Number... pks)

一个从分库分表, 根据多个主键查询.

Parameters:

shardingValue - 分库分表因子

clazz - 数据对象类型

slave - 主从库枚举

pks - 主键

Returns:

查询结果

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findByPksFromSlave

<T> List<T> findByPksFromSlave(IShardingKey<?> shardingKey,
                               Class<T> clazz,
                               EnumDBMasterSlave slave,
                               boolean useCache,
                               Number... pks)

findByPkListFromSlave

<T> List<T> findByPkListFromSlave(List<? extends Number> pks,
                                  IShardingKey<?> shardingValue,
                                  Class<T> clazz,
                                  boolean useCache,
                                  EnumDBMasterSlave slave)

一个从分库分表, 根据多个主键查询.

Parameters:

pks - 主键

shardingValue - 分库分表因子

clazz - 数据对象类型

slave - 主从库枚举

Returns:

查询结果

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findByShardingPairFromSlave

@Deprecated
<T> List<T> findByShardingPairFromSlave(List<IShardingKey<?>> shardingValues,
                                                    Class<T> clazz,
                                                    EnumDBMasterSlave slave,
                                                    Number... pks)

Deprecated.

多个从分库分表, 根据多个主键查询.

Parameters:

shardingValues - 分库分表因子

clazz - 数据对象类型

slave - 主从库枚举

pks - 主键

Returns:

查询结果

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findByShardingPairFromSlave

<T> List<T> findByShardingPairFromSlave(List<? extends Number> pks,
                                        List<IShardingKey<?>> shardingValues,
                                        Class<T> clazz,
                                        boolean useCache,
                                        EnumDBMasterSlave slave)

多个从分库分表, 根据多个主键查询.

Parameters:

pks - 主键

shardingValues - 分库分表因子

clazz - 数据对象类型

slave - 主从库枚举

Returns:

查询结果

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findBySqlFromSlave

List<Map<String,Object>> findBySqlFromSlave(SQL sql,
                                            IShardingKey<?> shardingValue,
                                            EnumDBMasterSlave slave)

一个从分库分表, 根据条件查询.

Parameters:

sql - 查询语句

shardingValue - 分库分表因子

slave - 主从库枚举

Returns:

查询结果

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

findByQueryFromSlave

<T> List<T> findByQueryFromSlave(IQuery query,
                                 IShardingKey<?> shardingValue,
                                 Class<T> clazz,
                                 boolean useCache,
                                 EnumDBMasterSlave slave)

根据查询条件对象进行查询.

Parameters:

query - 查询条件

shardingValue - 分库分表因子

slave - 从库查询

Throws:

DBOperationException - 操作失败

IllegalArgumentException - 输入参数错误

setPrimaryCache

void setPrimaryCache(IPrimaryCache primaryCache)

设置缓存.

Specified by:

setPrimaryCache in interface IDataQuery

setSecondCache

void setSecondCache(ISecondCache secondCache)

设置二级缓存.

Specified by:

setSecondCache in interface IDataQuery

Parameters:

secondCache -