cn.easyproject.easycommons.commondao

Interface CommonDAO

All Known Implementing Classes:

CommonDAOImpl, CommonDAOSpringImpl

public interface CommonDAO

Hibernate CommonDAO

Since:

1.0.0

Author:

Ray, inthinkcolor@gmail.com, easyproject.cn

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_QUERY_CACHE_REGION

Method Summary

Modifier and Type	Method and Description
void	batchUpdateSQL(String sql, Object[] values) 使用JDBC执行原生的批量SQL，单参数语句值列表
void	batchUpdateSQL(String sql, Object[][] values) 使用JDBC执行原生的批量SQL，多参数语句值列表
void	delete(Class c, Serializable id) 删除
void	delete(Object o) 删除对象
Integer	deleteByValues(Class cls, String idFieldName, String[] values) 批量删除，对使用,分隔的列表执行删除
void	deleteCascadeByValues(Class cls, String fieldName, String[] values) 带级联的批量删除，对使用,分隔的列表执行删除，deleteByValues不支持级联删除
void	evict(Class c) 清除二级缓存中所有的c对象
void	evict(Class c, Serializable id) 清除二级缓存中OID为id的c对象
void	evictAll() 清除二级缓存中所有对象
void	evictCollectionRegion(String collectionRegion) 清除二级缓存中指定类的集合属性
void	evictCollectionRegion(String collectionRegion, Serializable id) 清除二级缓存中指定id类的集合属性
void	evictQueries() 清除默认区域的查询缓存策略，如果默认为空，则清除所有标准区域查询缓存策略
void	evictQueries(String queryCacheRegion) 清除指定区域策略的查询缓存
<T> T	find(Class c, Serializable id) 通过Id查询
List	find(String jpql) 按条件根据jpql查询
List	find(String jpql, EasyCriteria easyCriteria) 按条件根据jpql查询
List	find(String jpql, Map<String,Object> values) 根据jpql查询
List	findAll(Class cls) 查询所有
List	findByCache(String jpql) 带查询缓存查询， 查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略
List	findByCache(String jpql, EasyCriteria easyCriteria) 带查询缓存查询， 查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略
List	findByCache(String jpql, Map<String,Object> values) 带查询缓存查询， 查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略
List	findByCache(String jpql, String queryCacheRegion) 查询缓存,需要指定具体的缓存策略区域
List	findByCache(String jpql, String queryCacheRegion, EasyCriteria easyCriteria) 查询缓存,需要指定具体的缓存策略区域
List	findByCache(String jpql, String queryCacheRegion, Map<String,Object> values) 查询缓存,需要指定具体的缓存策略区域
void	findByPage(PageBean pageBean) 分页查询
void	findByPage(PageBean pageBean, EasyCriteria easyCriteria) 分页查询
void	findByPage(PageBean pageBean, Map<String,Object> values) 分页查询
List	findByProperty(Class cls, String propertyName, Object value) 简单查询，按照字段查询
List	findByPropertyIgnoreCase(Class cls, String propertyName, String value) 按照字段查询，不区分大小写
List	findBySQL(String sql) 执行Native SQL，返回封装的对象集合
List	findBySQL(String sql, Class resultClass) 执行Native SQL，返回封装的 Map 对象集合
List	findBySQL(String sql, Class resultClass, EasyCriteria easyCriteria) 执行Native SQL，返回封装的 Map 对象集合
List	findBySQL(String sql, Class resultClass, Map<String,Object> values) 执行Native SQL，返回封装的对象集合
List	findBySQL(String sql, EasyCriteria easyCriteria) 执行Native SQL，返回封装的对象集合
List	findBySQL(String sql, Map<String,Object> values) 执行Native SQL，返回封装的对象集合
int	findCount(String jpql) 通过jpql语句查询总条数
int	findCount(String jpql, EasyCriteria easyCriteria) 通过jpql语句查询总条数
int	findCount(String jpql, Map<String,Object> values) 通过jpql语句查询总条数
List	findMapResultBySQL(String sql) 执行Native SQL，返回封装的 Map 对象集合
List	findMapResultBySQL(String sql, EasyCriteria easyCriteria) 执行Native SQL，返回封装的 Map 对象集合
List	findMapResultBySQL(String sql, Map<String,Object> values) 执行Native SQL，返回封装的 Map 对象集合
int	findMaxPage(String jpql, int rowsPerPage) 查询数据条数，并根据每页条数计算总页数
int	findMaxPage(String jpql, int rowsPerPage, EasyCriteria easyCriteria) 查询数据条数，并根据每页条数计算总页数
int	findMaxPage(String jpql, int rowsPerPage, Map<String,Object> values) 查询数据条数，并根据每页条数计算总页数
List	findNamedQuery(String name) 执行命名查询
List	findNamedQuery(String name, Map<String,Object> values) 执行命名查询
List	findNamedQueryByCache(String name, String queryCacheRegion, Map<String,Object> values) 执行命名查询
List	findTop(String jpql, int topCount) 查询前topCount条数据
List	findTop(String jpql, int topCount, EasyCriteria easyCriteria) 查询前topCount条数据
List	findTop(String jpql, int topCount, Map<String,Object> values) 查询前topCount条数据
<T> T	findVal(String jpql) 查询单个（单行单列）数据，如最大值，最小值等等
<T> T	findVal(String jpql, EasyCriteria easyCriteria) 查询单个（单行单列）数据，如最大值，最小值等等
<T> T	findVal(String jpql, Map<String,Object> values) 查询单个（单行单列）数据，如最大值，最小值等等
javax.persistence.EntityManager	getCurrentEntityManager() 获取EntityManager
javax.persistence.EntityManagerFactory	getEntityManagerFactory() 获取EntityManagerFactory，主要用来手动清除缓存
void	initialize(Object proxy) 初始化关联的对象
void	initializeDeep(Collection collection) 将集合中的对象深度初始化
void	merge(Object o) 修改对象
void	persist(Object o) 新增
void	updateByJpql(String jpql) 通过jpql语句进行批量修改（更新，删除）
void	updateByJpql(String jpql, Map<String,Object> values) 通过jpql语句进行批量修改（更新，删除）
void	updateBySQL(String sql) 使用JDBC执行原生的增删改SQL语句
void	updateBySQL(String sql, Map<String,Object> values) 使用JDBC执行原生的增删改SQL语句

Field Detail

DEFAULT_QUERY_CACHE_REGION

static final String DEFAULT_QUERY_CACHE_REGION

See Also:

Constant Field Values

Method Detail

batchUpdateSQL

void batchUpdateSQL(String sql,
                    Object[] values)

使用JDBC执行原生的批量SQL，单参数语句值列表

Parameters:

sql - SQL语句

values - 单参数语句值列表

batchUpdateSQL

void batchUpdateSQL(String sql,
                    Object[][] values)

使用JDBC执行原生的批量SQL，多参数语句值列表

Parameters:

sql - SQL语句

values - 多参数语句值列表

delete

void delete(Class c,
            Serializable id)

删除

Parameters:

c - 类型

id - OID

delete

void delete(Object o)

删除对象

Parameters:

o - 实体对象

deleteByValues

Integer deleteByValues(Class cls,
                       String idFieldName,
                       String[] values)

批量删除，对使用,分隔的列表执行删除

Parameters:

c - 类型ls 类型

id - OIDFieldName 删除条件字段

values - 语句参数值列表List 要删除的字段列表，使用,分隔

Returns:

deleteCascadeByValues

void deleteCascadeByValues(Class cls,
                           String fieldName,
                           String[] values)

带级联的批量删除，对使用,分隔的列表执行删除，deleteByValues不支持级联删除

Parameters:

cls - 类型

fieldName - 删除条件字段

values - 集合值列表

evict

void evict(Class c)

清除二级缓存中所有的c对象

Parameters:

c - 类型

evict

void evict(Class c,
           Serializable id)

清除二级缓存中OID为id的c对象

Parameters:

c - 类型

id - OID

evictAll

void evictAll()

清除二级缓存中所有对象

Parameters:

c - 类型

id - OID

evictCollectionRegion

void evictCollectionRegion(String collectionRegion)

清除二级缓存中指定类的集合属性

Parameters:

collectionRegion - 查询缓存区域

evictCollectionRegion

void evictCollectionRegion(String collectionRegion,
                           Serializable id)

清除二级缓存中指定id类的集合属性

Parameters:

collectionRegion - 查询缓存区域

id - OID

evictQueries

void evictQueries()

清除默认区域的查询缓存策略，如果默认为空，则清除所有标准区域查询缓存策略

evictQueries

void evictQueries(String queryCacheRegion)

清除指定区域策略的查询缓存

Parameters:

queryCacheRegion - 指定查询缓存区域

find

<T> T find(Class c,
           Serializable id)

通过Id查询

Parameters:

c - 类型

id - OID

Returns:

find

List find(String jpql)

按条件根据jpql查询

Parameters:

jpql - jpql语句 jpql

Returns:

find

List find(String jpql,
          EasyCriteria easyCriteria)

按条件根据jpql查询

Parameters:

jpql - jpql语句 jpql

easyCriteria - EasyCriteria条件对象

Returns:

find

List find(String jpql,
          Map<String,Object> values)

根据jpql查询

Parameters:

jpql - jpql语句 jpql

values - 语句参数值列表 参数列表

Returns:

findAll

List findAll(Class cls)

查询所有

Parameters:

c - 类型ls

Returns:

findByCache

List findByCache(String jpql)

带查询缓存查询， 查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略

Parameters:

jpql - jpql语句

Returns:

findByCache

List findByCache(String jpql,
                 EasyCriteria easyCriteria)

带查询缓存查询， 查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略

Parameters:

jpql - jpql语句

easyCriteria - EasyCriteria条件对象

Returns:

findByCache

List findByCache(String jpql,
                 Map<String,Object> values)

带查询缓存查询， 查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略

Parameters:

jpql - jpql语句

values - 语句参数值列表

Returns:

findByCache

List findByCache(String jpql,
                 String queryCacheRegion,
                 EasyCriteria easyCriteria)

查询缓存,需要指定具体的缓存策略区域

Parameters:

jpql - jpql语句

queryCacheRegion - 指定查询缓存区域

easyCriteria - EasyCriteria条件对象

Returns:

findByCache

List findByCache(String jpql,
                 String queryCacheRegion)

查询缓存,需要指定具体的缓存策略区域

Parameters:

jpql - jpql语句

queryCacheRegion - 指定查询缓存区域

Returns:

findByCache

List findByCache(String jpql,
                 String queryCacheRegion,
                 Map<String,Object> values)

查询缓存,需要指定具体的缓存策略区域

Parameters:

jpql - jpql语句

queryCacheRegion - 指定查询缓存区域

values - 语句参数值列表

Returns:

findByPage

void findByPage(PageBean pageBean)

分页查询

Parameters:

pageBean -

values - 语句参数值列表

findByPage

void findByPage(PageBean pageBean,
                EasyCriteria easyCriteria)

分页查询

Parameters:

pageBean -

easyCriteria - 按条件分页查询方法

findByPage

void findByPage(PageBean pageBean,
                Map<String,Object> values)

分页查询

Parameters:

pageBean -

values - 语句参数值列表

findByProperty

List findByProperty(Class cls,
                    String propertyName,
                    Object value)

简单查询，按照字段查询

Parameters:

c - 类型ls

propertyName - 属性名

value - 属性值

Returns:

findByPropertyIgnoreCase

List findByPropertyIgnoreCase(Class cls,
                              String propertyName,
                              String value)

按照字段查询，不区分大小写

Parameters:

c - 类型ls

propertyName - 属性名

value - 属性值

Returns:

findBySQL

List findBySQL(String sql,
               Class resultClass)

执行Native SQL，返回封装的 Map 对象集合

Parameters:

sql - SQL语句

resultClass - 类型 封装的类型

Returns:

查询的结果封装为transformers指定的类型

findBySQL

List findBySQL(String sql,
               Class resultClass,
               EasyCriteria easyCriteria)

执行Native SQL，返回封装的 Map 对象集合

Parameters:

sql - SQL语句

resultClass - 类型 封装的类型

easyCriteria - EasyCriteria条件对象

Returns:

查询的结果封装为transformers指定的类型

findBySQL

List findBySQL(String sql,
               Class resultClass,
               Map<String,Object> values)

执行Native SQL，返回封装的对象集合

Parameters:

sql - SQL语句

resultClass - 类型 封装的类型

values - 语句参数值列表

Returns:

查询的结果封装为c指定的实体

findBySQL

List findBySQL(String sql)

执行Native SQL，返回封装的对象集合

Parameters:

sql - SQL语句

Returns:

查询的结果，多列时转换为Object[]

findBySQL

List findBySQL(String sql,
               EasyCriteria easyCriteria)

执行Native SQL，返回封装的对象集合

Parameters:

sql - SQL语句

easyCriteria - EasyCriteria条件对象

Returns:

查询的结果，多列时转换为Object[]

findBySQL

List findBySQL(String sql,
               Map<String,Object> values)

执行Native SQL，返回封装的对象集合

Parameters:

sql - SQL语句

values - 语句参数值列表

Returns:

查询的结果，多列时转换为Object[]

findCount

int findCount(String jpql)

通过jpql语句查询总条数

Parameters:

jpql - jpql语句

Returns:

总条数

findCount

int findCount(String jpql,
              EasyCriteria easyCriteria)

通过jpql语句查询总条数

Parameters:

jpql - jpql语句

easyCriteria - EasyCriteria条件对象

Returns:

总条数

findCount

int findCount(String jpql,
              Map<String,Object> values)

通过jpql语句查询总条数

Parameters:

jpql - jpql语句

values - 语句参数值列表

Returns:

总条数

findMapResultBySQL

List findMapResultBySQL(String sql)

执行Native SQL，返回封装的 Map 对象集合

Parameters:

sql - SQL语句

Returns:

查询的结果封装为transformers指定的类型

findMapResultBySQL

List findMapResultBySQL(String sql,
                        EasyCriteria easyCriteria)

执行Native SQL，返回封装的 Map 对象集合

Parameters:

sql - SQL语句

easyCriteria - EasyCriteria条件对象

Returns:

查询的结果封装为transformers指定的类型

findMapResultBySQL

List findMapResultBySQL(String sql,
                        Map<String,Object> values)

执行Native SQL，返回封装的 Map 对象集合

Parameters:

sql - SQL语句

values - 语句参数值列表

Returns:

查询的结果封装为transformers指定的类型

findMaxPage

int findMaxPage(String jpql,
                int rowsPerPage)

查询数据条数，并根据每页条数计算总页数

Parameters:

jpql - 查询条数的语句

rowsPerPage - 每页显示条数

Returns:

总页数

findMaxPage

int findMaxPage(String jpql,
                int rowsPerPage,
                EasyCriteria easyCriteria)

查询数据条数，并根据每页条数计算总页数

Parameters:

jpql - 查询条数的语句

rowsPerPage - 每页显示条数

easyCriteria - EasyCriteria条件对象

Returns:

总页数

findMaxPage

int findMaxPage(String jpql,
                int rowsPerPage,
                Map<String,Object> values)

查询数据条数，并根据每页条数计算总页数

Parameters:

jpql - 查询条数的语句

rowsPerPage - 每页显示条数

values - 语句参数值列表

Returns:

总页数

findNamedQuery

List findNamedQuery(String name)

执行命名查询

Parameters:

name - queryName

Returns:

findNamedQuery

List findNamedQuery(String name,
                    Map<String,Object> values)

执行命名查询

Parameters:

name - queryName

values - 语句参数值列表

Returns:

findNamedQueryByCache

List findNamedQueryByCache(String name,
                           String queryCacheRegion,
                           Map<String,Object> values)

执行命名查询

Parameters:

name - queryName

queryCacheRegion - 指定查询缓存区域

values - 语句参数值列表

Returns:

findTop

List findTop(String jpql,
             int topCount)

查询前topCount条数据

Parameters:

jpql - jpql语句

topCount -

Returns:

findTop

List findTop(String jpql,
             int topCount,
             EasyCriteria easyCriteria)

查询前topCount条数据

Parameters:

jpql - jpql语句

topCount -

easyCriteria - EasyCriteria条件对象

Returns:

findTop

List findTop(String jpql,
             int topCount,
             Map<String,Object> values)

查询前topCount条数据

Parameters:

jpql - jpql语句

topCount -

values - 语句参数值列表

Returns:

findVal

<T> T findVal(String jpql)

查询单个（单行单列）数据，如最大值，最小值等等

Parameters:

jpql - 单个数据查询语句

Returns:

查询到的单个值

findVal

<T> T findVal(String jpql,
              EasyCriteria easyCriteria)

查询单个（单行单列）数据，如最大值，最小值等等

Parameters:

jpql - 单个数据查询语句

easyCriteria - EasyCriteria条件对象

Returns:

查询到的单个值

findVal

<T> T findVal(String jpql,
              Map<String,Object> values)

查询单个（单行单列）数据，如最大值，最小值等等

Parameters:

jpql - 单个数据查询语句

values - 语句占位符对应的值

Returns:

查询到的单个值

getCurrentEntityManager

javax.persistence.EntityManager getCurrentEntityManager()

获取EntityManager

Returns:

getEntityManagerFactory

javax.persistence.EntityManagerFactory getEntityManagerFactory()

获取EntityManagerFactory，主要用来手动清除缓存

Returns:

initialize

void initialize(Object proxy)

初始化关联的对象

Parameters:

proxy -

initializeDeep

void initializeDeep(Collection collection)

将集合中的对象深度初始化

Parameters:

collection -

merge

void merge(Object o)

修改对象

Parameters:

o - 实体对象

persist

void persist(Object o)

新增

Parameters:

o - 实体对象

updateByJpql

void updateByJpql(String jpql)

通过jpql语句进行批量修改（更新，删除）

Parameters:

jpql - jpql语句

updateByJpql

void updateByJpql(String jpql,
                  Map<String,Object> values)

通过jpql语句进行批量修改（更新，删除）

Parameters:

jpql - jpql语句

values - 语句参数值列表

updateBySQL

void updateBySQL(String sql)

使用JDBC执行原生的增删改SQL语句

Parameters:

sql - SQL语句

updateBySQL

void updateBySQL(String sql,
                 Map<String,Object> values)

使用JDBC执行原生的增删改SQL语句

Parameters:

sql - SQL语句

values - 语句参数值列表