cloud.agileframework.jpa.dao

类 Dao

java.lang.Object

cloud.agileframework.jpa.dao.Dao

public class Dao
extends Object

作者:

佟盟 on 2017/11/15

构造器概要

构造器

构造器和说明
Dao()

方法概要

限定符和类型	方法和说明
static boolean	canCastClass(Class<?> clazz)
boolean	contains(Object o)
long	count(Class<?> tableClass) 查询指定tableClass对应表的总数
<T> void	delete(T o) 根据提供的对象参数，作为例子，查询出结果并删除
<T> void	deleteAll(Class<T> tableClass) 删除全部(逐一删除)
<T> void	deleteAllInBatch(Class<T> tableClass) 删除全部(一次性删除)
<T> boolean	deleteById(Class<T> tableClass, Object id) 删除
<T> void	deleteInBatch(Class<T> tableClass, Iterable<?> ids)
<T> void	deleteInBatch(Class<T> tableClass, Object[] ids) 根据主键与实体类型，部分删除，删除对象集(一次性删除)
<T> void	deleteInBatch(Iterable<T> list) 根据表映射类型的对象集合，部分删除，删除对象集(一次性删除)，无返回值
boolean	existsById(Class<?> tableClass, Object id) 根据表实体类型与主键值，判断数据是否存在
<T> List<T>	findAll(Class<T> tableClass) 指定tableClass对应表的全表查询
<T> org.springframework.data.domain.Page<T>	findAll(Class<T> tableClass, int page, int size) 查询指定tableClass对应表的全表分页
<T> List<T>	findAll(Class<T> tableClass, org.springframework.data.domain.Sort sort) 指定tableClass对应表的全表查询,并排序
<T> List<T>	findAll(String sql, Class<T> clazz, Integer firstResult, Integer maxResults, Object... parameters) 根据sql语句查询指定类型clazz列表
<T> List<T>	findAll(String sql, Class<T> clazz, Object... parameters) 根据sql语句查询指定类型clazz列表
<T> List<T>	findAll(String sql, Class<T> clazz, Object parameters) 根据sql查询结果为List类型的结果集
<T> List<T>	findAll(T object) 按照例子查询多条
<T> org.springframework.data.domain.Page<T>	findAll(T object, int page, int size) 按照例子查询多条分页
<T> org.springframework.data.domain.Page<T>	findAll(T object, int page, int size, org.springframework.data.domain.Sort sort) 按照例子对象查询多条分页
<T> org.springframework.data.domain.Page<T>	findAll(T object, org.springframework.data.domain.PageRequest pageRequest)
<T> List<T>	findAll(T object, org.springframework.data.domain.Sort sort) 按照例子查询多条/排序
<T> List<T>	findAllByArrayId(Class<T> tableClass, Object... ids) 根据实体类型tableClass与主键值集合ids，查询实体列表
<T> List<T>	findAllByExample(org.springframework.data.domain.Example<T> example) 根据例子查询列表
<T> List<T>	findAllByExample(org.springframework.data.domain.Example<T> example, org.springframework.data.domain.Sort sort) 根据例子查询列表
<T> List<T>	findAllById(Class<T> tableClass, Iterable<?> ids) 根据实体类型tableClass与主键值集合ids，查询实体列表
List<Map<String,Object>>	findAllBySQL(String sql, Object... parameters) 根据sql语句查询列表，结果类型为List>
List<Map<String,Object>>	findAllBySQL(String sql, Object parameters) 根据sql语句查询列表，结果类型为List>
<T> T	findOne(Class<T> clazz, Object id) 根据主键，查询单条
<T> T	findOne(String sql, Class<T> clazz, Object... parameters) 根据sql查询出单条数据，并映射成指定clazz类型
<T> T	findOne(String sql, Class<T> clazz, Object parameters) 根据sql查询出单条数据，并映射成指定clazz类型
<T> T	findOne(T object) 按照例子查询单条
Map<String,Object>	findOneToMap(String sql, Object... parameters)
Map<String,Object>	findOneToMap(String sql, Object parameters)
<T> org.springframework.data.domain.Page<T>	findPageBySQL(String sql, int page, int size, Class<T> clazz, Object... parameters) 分页查询，自动生成条数汇总sql语句
<T> org.springframework.data.domain.Page<T>	findPageBySQL(String sql, int page, int size, Class<T> clazz, Object parameters) 分页查询，自动生成条数汇总sql语句
org.springframework.data.domain.Page<Map<String,Object>>	findPageBySQL(String sql, int page, int size, Object... parameters) 分页查询，自动生成条数汇总sql语句
org.springframework.data.domain.Page<Map<String,Object>>	findPageBySQL(String sql, int page, int size, Object parameters) 分页查询，自动生成条数汇总sql语句
<T> org.springframework.data.domain.Page<T>	findPageBySQL(String sql, String countSql, int page, int size, Class<T> clazz, Object... parameters) 分页查询
Object	findParameter(String sql, Object... parameters) 查询结果预判为一个字段值
Object	findParameter(String sql, Object parameters) 查询结果预判为一个字段值
void	flush() 刷新数据库中全部表
void	flush(Class<?> tableClass) 刷新数据库中指定tableClass类型实体对应的表
Connection	getConnection() 获取数据库连接
javax.persistence.EntityManager	getEntityManager() 获取EntityManager，操作jpa api的入口
Field	getIdField(Class<?> clazz) 获取ORM中的主键字段
<T,ID> org.springframework.data.jpa.repository.support.SimpleJpaRepository<T,ID>	getRepository(Class<T> tableClass) 根据java类型获取对应的数据库表的JpaRepository对象
void	refresh(Object o) 刷新数据库数据到实体类当中
<T> boolean	save(Iterable<T> list) 批量保存
void	save(Object o) 保存
<T> List<T>	saveAndReturn(Iterable<T> list) 批量保存
<T> T	saveAndReturn(T o) 保存
<T> T	saveAndReturn(T o, boolean isFlush) 保存并刷新
<T> T	saveOrUpdate(T o)
<T> T	update(T o) 更新或新增
int	updateBySQL(String sql, Object... parameters) sql形式写操作
int	updateBySQL(String sql, Object parameters) sql形式写操作
<T> T	updateOfNotNull(T o) 更新或新增非空字段，空字段不进行更新
static void	validatePageInfo(int page, int size)

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

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

构造器详细资料

Dao

public Dao()

方法详细资料

getRepository

public <T,ID> org.springframework.data.jpa.repository.support.SimpleJpaRepository<T,ID> getRepository(Class<T> tableClass)

根据java类型获取对应的数据库表的JpaRepository对象

类型参数:

T - 表对应的实体类型

ID - 主键类型

参数:

tableClass - 表对应的实体类型

返回:

对应的数据库表的JpaRepository对象

getEntityManager

public javax.persistence.EntityManager getEntityManager()

获取EntityManager，操作jpa api的入口

返回:

EntityManager

save

public void save(Object o)

保存

参数:

o - ORM对象

save

public <T> boolean save(Iterable<T> list)

批量保存

类型参数:

T - 表对应的实体类型

参数:

list - 表对应的实体类型的对象列表

返回:

是否保存成功

getConnection

public Connection getConnection()

获取数据库连接

返回:

Connection

contains

public boolean contains(Object o)

saveOrUpdate

public <T> T saveOrUpdate(T o)

saveAndReturn

public <T> T saveAndReturn(T o,
                           boolean isFlush)

保存并刷新

类型参数:

T - 泛型

参数:

o - 表对应的实体类型的对象

isFlush - 是否刷新

返回:

保存后的对象

saveAndReturn

public <T> T saveAndReturn(T o)

保存

类型参数:

T - 泛型

参数:

o - 要保存的对象

返回:

保存后的对象

saveAndReturn

public <T> List<T> saveAndReturn(Iterable<T> list)

批量保存

类型参数:

T - 表对应的实体类型

参数:

list - 要保存的对象列表

返回:

保存后的数据集

existsById

public boolean existsById(Class<?> tableClass,
                          Object id)

根据表实体类型与主键值，判断数据是否存在

参数:

tableClass - 表对应的实体类型

id - 数据主键

返回:

是否存在

flush

public void flush(Class<?> tableClass)

刷新数据库中指定tableClass类型实体对应的表

参数:

tableClass - 表对应的实体类型

flush

public void flush()

刷新数据库中全部表

refresh

public void refresh(Object o)

刷新数据库数据到实体类当中

参数:

o - 表对应的实体类型的对象

update

public <T> T update(T o)

更新或新增

类型参数:

T - 表对应的实体类型

参数:

o - ORM对象

返回:

返回更新后的数据

updateOfNotNull

public <T> T updateOfNotNull(T o)
                      throws org.hibernate.id.IdentifierGenerationException,
                             IllegalAccessException

更新或新增非空字段，空字段不进行更新

类型参数:

T - 表映射实体类型的对象

参数:

o - 表映射实体类型的对象

返回:

返回更新后的数据

抛出:

org.hibernate.id.IdentifierGenerationException - 异常

IllegalAccessException - 异常

delete

public <T> void delete(T o)

根据提供的对象参数，作为例子，查询出结果并删除

参数:

o - 表实体对象

deleteById

public <T> boolean deleteById(Class<T> tableClass,
                              Object id)

删除

类型参数:

T - 查询的目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

id - 删除的主键标识

deleteAll

public <T> void deleteAll(Class<T> tableClass)

删除全部(逐一删除)

类型参数:

T - 查询的目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

deleteAllInBatch

public <T> void deleteAllInBatch(Class<T> tableClass)

删除全部(一次性删除)

类型参数:

T - 查询的目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

getIdField

public Field getIdField(Class<?> clazz)
                 throws org.hibernate.id.IdentifierGenerationException

获取ORM中的主键字段

参数:

clazz - 查询的目标表对应实体类型，Entity

返回:

主键属性

抛出:

org.hibernate.id.IdentifierGenerationException - tableClass实体类型中没有找到@ID的注解，识别成主键字段

deleteInBatch

public <T> void deleteInBatch(Class<T> tableClass,
                              Object[] ids)

根据主键与实体类型，部分删除，删除对象集(一次性删除)

类型参数:

T - 查询的目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

ids - 主键数组

deleteInBatch

public <T> void deleteInBatch(Class<T> tableClass,
                              Iterable<?> ids)

deleteInBatch

public <T> void deleteInBatch(Iterable<T> list)

根据表映射类型的对象集合，部分删除，删除对象集(一次性删除)，无返回值

类型参数:

T - 删除对象集合的对象类型，用于生成sql语句时与对应的表进行绑定

参数:

list - 需要删除的对象列表

findOne

public <T> T findOne(Class<T> clazz,
                     Object id)

根据主键，查询单条

类型参数:

T - 查询的目标表对应实体类型

参数:

clazz - 查询的目标表对应实体类型，Entity

id - 主键

返回:

clazz类型对象

findOne

public <T> T findOne(T object)

按照例子查询单条

类型参数:

T - 查询的表的映射实体类型

参数:

object - 查询一句的例子对象

返回:

返回查询结果

findOne

public <T> T findOne(String sql,
                     Class<T> clazz,
                     Object... parameters)

根据sql查询出单条数据，并映射成指定clazz类型

类型参数:

T - 查询的表的映射实体类型

参数:

sql - sql

clazz - 查询的目标表对应实体类型，Entity

parameters - 对象数组格式的sql语句中的参数集合，使用?方式占位

返回:

查询的结果

findOne

public <T> T findOne(String sql,
                     Class<T> clazz,
                     Object parameters)

根据sql查询出单条数据，并映射成指定clazz类型

类型参数:

T - 查询的表的映射实体类型

参数:

sql - 原生sql，使用{Map的key值}形式占位

clazz - 查询的目标表对应实体类型，Entity

parameters - Map形式参数集合

返回:

查询的结果

canCastClass

public static boolean canCastClass(Class<?> clazz)

findAll

public <T> List<T> findAll(T object)

按照例子查询多条

类型参数:

T - 查询的表的映射实体类型

参数:

object - 例子对象

返回:

查询结果数据集合

findAll

public <T> List<T> findAll(T object,
                           org.springframework.data.domain.Sort sort)

按照例子查询多条/排序

类型参数:

T - 查询的表的映射实体类型

参数:

object - 例子对象

sort - 排序对象

返回:

查询结果数据集合

findAllByExample

public <T> List<T> findAllByExample(org.springframework.data.domain.Example<T> example)

根据例子查询列表

类型参数:

T - 泛型

参数:

example - 例子

返回:

列表

findAllByExample

public <T> List<T> findAllByExample(org.springframework.data.domain.Example<T> example,
                                    org.springframework.data.domain.Sort sort)

根据例子查询列表

类型参数:

T - 泛型

参数:

example - 例子

sort - 排序

返回:

列表

findAll

public <T> org.springframework.data.domain.Page<T> findAll(T object,
                                                           int page,
                                                           int size)

按照例子查询多条分页

类型参数:

T - 查询的表的映射实体类型

参数:

object - 例子对象

page - 第几页

size - 每页条数

返回:

分页对象

findAll

public <T> org.springframework.data.domain.Page<T> findAll(T object,
                                                           int page,
                                                           int size,
                                                           org.springframework.data.domain.Sort sort)

按照例子对象查询多条分页

类型参数:

T - 查询的表的映射实体类型

参数:

object - 例子对象

page - 第几页

size - 每页条数

sort - 排序对象

返回:

分页信息

findAll

public <T> org.springframework.data.domain.Page<T> findAll(T object,
                                                           org.springframework.data.domain.PageRequest pageRequest)

findAll

public <T> List<T> findAll(String sql,
                           Class<T> clazz,
                           Integer firstResult,
                           Integer maxResults,
                           Object... parameters)

根据sql语句查询指定类型clazz列表

类型参数:

T - 指定返回类型

参数:

sql - 查询的sql语句，参数使用？占位

clazz - 希望查询结果映射成的实体类型

firstResult - 第一条数据

maxResults - 最大条数据

parameters - 对象数组类型的参数集合

返回:

结果集

findAll

public <T> List<T> findAll(String sql,
                           Class<T> clazz,
                           Object... parameters)

根据sql语句查询指定类型clazz列表

类型参数:

T - 指定返回类型

参数:

sql - 查询的sql语句，参数使用？占位

clazz - 希望查询结果映射成的实体类型

parameters - 对象数组类型的参数集合

返回:

结果集

findAll

public <T> List<T> findAll(String sql,
                           Class<T> clazz,
                           Object parameters)

根据sql查询结果为List类型的结果集

类型参数:

T - 查询结果需要映射的实体类型

参数:

sql - 查询sql语句，使用{Map的key值}形式占位

clazz - 查询结果需要映射的实体

parameters - Map类型参数集合

返回:

类型的结果集

validatePageInfo

public static void validatePageInfo(int page,
                                    int size)
                             throws IllegalArgumentException

抛出:

IllegalArgumentException

findPageBySQL

public <T> org.springframework.data.domain.Page<T> findPageBySQL(String sql,
                                                                 String countSql,
                                                                 int page,
                                                                 int size,
                                                                 Class<T> clazz,
                                                                 Object... parameters)

分页查询

参数:

sql - 查询的sql语句

countSql - 统计总数的sql语句

page - 第几页

size - 页大小

parameters - 对象数组类型的参数集合

返回:

Page类型的查询结果

findPageBySQL

public org.springframework.data.domain.Page<Map<String,Object>> findPageBySQL(String sql,
                                                                              int page,
                                                                              int size,
                                                                              Object parameters)

分页查询，自动生成条数汇总sql语句

参数:

sql - 原生sql，参数使用{Map的key值}形式占位

page - 第几页

size - 页大小

parameters - Map类型参数集合

返回:

分页Page类型结果

findPageBySQL

public org.springframework.data.domain.Page<Map<String,Object>> findPageBySQL(String sql,
                                                                              int page,
                                                                              int size,
                                                                              Object... parameters)

分页查询，自动生成条数汇总sql语句

参数:

sql - 原生sql，参数使用?形式占位

page - 第几页

size - 页大小

parameters - 对象数组类型参数集合

返回:

分页Page类型结果

findPageBySQL

public <T> org.springframework.data.domain.Page<T> findPageBySQL(String sql,
                                                                 int page,
                                                                 int size,
                                                                 Class<T> clazz,
                                                                 Object... parameters)

分页查询，自动生成条数汇总sql语句

参数:

sql - 原生sql，参数使用{Map的key值}形式占位

page - 第几页

size - 页大小

parameters - Map类型参数集合

返回:

分页Page类型结果

findPageBySQL

public <T> org.springframework.data.domain.Page<T> findPageBySQL(String sql,
                                                                 int page,
                                                                 int size,
                                                                 Class<T> clazz,
                                                                 Object parameters)

分页查询，自动生成条数汇总sql语句

参数:

sql - 原生sql，参数使用{Map的key值}形式占位

page - 第几页

size - 页大小

parameters - Map类型参数集合

返回:

分页Page类型结果

findAllBySQL

public List<Map<String,Object>> findAllBySQL(String sql,
                                             Object... parameters)

根据sql语句查询列表，结果类型为List>

参数:

sql - 查询的sql语句，参数使用？占位

parameters - 对象数组形式参数集合

返回:

结果类型为List套Map的查询结果

findAllBySQL

public List<Map<String,Object>> findAllBySQL(String sql,
                                             Object parameters)

根据sql语句查询列表，结果类型为List>

参数:

sql - 查询sql语句，参数使用{Map的key值}形式占位

parameters - Map类型参数集合

返回:

结果类型为List套Map的查询结果

findOneToMap

public Map<String,Object> findOneToMap(String sql,
                                       Object parameters)

findOneToMap

public Map<String,Object> findOneToMap(String sql,
                                       Object... parameters)

findParameter

public Object findParameter(String sql,
                            Object... parameters)

查询结果预判为一个字段值

参数:

sql - 查询的sql语句，参数使用？占位

parameters - 对象数组形式参数集合

返回:

结果为一个查询字段值

findParameter

public Object findParameter(String sql,
                            Object parameters)

查询结果预判为一个字段值

参数:

sql - 查询sql语句，参数使用{Map的key值}形式占位

parameters - Map类型参数集合

返回:

结果为一个查询字段值

updateBySQL

public int updateBySQL(String sql,
                       Object... parameters)

sql形式写操作

参数:

sql - 查询的sql语句，参数使用？占位

parameters - 对象数组形式参数集合

返回:

影响条数

updateBySQL

public int updateBySQL(String sql,
                       Object parameters)

sql形式写操作

参数:

sql - 查询sql语句，参数使用{Map的key值}形式占位

parameters - Map类型参数集合

返回:

影响条数

findAllById

public <T> List<T> findAllById(Class<T> tableClass,
                               Iterable<?> ids)

根据实体类型tableClass与主键值集合ids，查询实体列表

类型参数:

T - 目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

ids - 主键值集合

返回:

返回查询出的实体列表

findAllByArrayId

public <T> List<T> findAllByArrayId(Class<T> tableClass,
                                    Object... ids)

根据实体类型tableClass与主键值集合ids，查询实体列表

类型参数:

T - 目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

ids - 主键值集合，数组类型

返回:

返回查询出的实体列表

findAll

public <T> org.springframework.data.domain.Page<T> findAll(Class<T> tableClass,
                                                           int page,
                                                           int size)

查询指定tableClass对应表的全表分页

类型参数:

T - 目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

page - 第几页

size - 页大小

返回:

内容为实体的Page类型分页结果

findAll

public <T> List<T> findAll(Class<T> tableClass)

指定tableClass对应表的全表查询

类型参数:

T - 目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

返回:

内容为实体的List类型结果集

findAll

public <T> List<T> findAll(Class<T> tableClass,
                           org.springframework.data.domain.Sort sort)

指定tableClass对应表的全表查询,并排序

类型参数:

T - 目标表对应实体类型

参数:

tableClass - 查询的目标表对应实体类型，Entity

sort - 排序信息

返回:

内容为实体的List类型结果集

count

public long count(Class<?> tableClass)

查询指定tableClass对应表的总数

参数:

tableClass - 查询的目标表对应实体类型，Entity

返回:

查询条数