CommonDAO (EasyCommonDAO-JPA-EclipseLink 1.4.0-RELEASE API)

所有已知实现类:

CommonDAOImpl, CommonDAOSpringImpl
```
public interface CommonDAO
```
JPA CommonDAO

从以下版本开始:

1.0.0

作者:

Ray, inthinkcolor@gmail.com, easyproject.cn

字段概要

字段
限定符和类型字段和说明

static String DEFAULT_QUERY_CACHE_REGION

字段
限定符和类型	字段和说明
`static String`	`DEFAULT_QUERY_CACHE_REGION`

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`void`	`batchUpdateSQL(String sql, Object[] values)` 使用JDBC执行原生的批量SQL，单参数语句值列表
`void`	`batchUpdateSQL(String sql, Object[][] values)` 使用JDBC执行原生的批量SQL，多参数语句值列表
`Integer`	`deleteByValues(Class cls, String fieldName, Object[] values)` 使用 Query 语句批量删除，不支持级联
`void`	`deleteCascadeByValues(Class cls, String fieldName, Object[] values)` 使用 Query 语句批量删除，支持级联
`void`	`evict(Class cls)` 清除二级缓存中所有的c对象
`void`	`evict(Class cls, Serializable id)` 清除二级缓存中OID为id的c对象
`void`	`evictAll()` 清除二级缓存中所有对象
`void`	`evictQueries()` 清除默认区域的查询缓存策略，如果默认为空，则清除所有标准区域查询缓存策略
`void`	`evictQueries(String queryCacheRegion)` 清除指定区域策略的查询缓存
`<T> T`	`find(Class cls, Serializable id)` 通过Id查询
`List`	`find(String jpql, EasyCriteria easyCriteria)` 按条件根据jpql查询
`List`	`find(String jpql, Object... values)` 根据jpql查询
`List`	`findAll(Class cls)` 查询所有
`List`	`findByCache(String jpql, EasyCriteria easyCriteria)` 带查询缓存查询，查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略
`List`	`findByCache(String jpql, Object... values)` 带查询缓存查询，查询缓存，使用DEFAULT_QUERY_CACHE_REGION指定区域的缓存，如DEFAULT_QUERY_CACHE_REGION==null或=="",则使用默认标准区域缓存策略
`void`	`findByPage(PageBean pageBean)` 分页查询
`void`	`findByPage(PageBean pageBean, EasyCriteria easyCriteria)` 分页查询
`void`	`findByPage(PageBean pageBean, List values)` 分页查询
`List`	`findByProperty(Class cls, String propertyName, Object value)` 简单查询，按照字段查询
`List`	`findByPropertyIgnoreCase(Class cls, String propertyName, String value)` 按照字段查询，不区分大小写
`List`	`findBySQL(String sql, Class resultClass, EasyCriteria easyCriteria)` 执行Native SQL，返回封装的 Map 对象集合
`List`	`findBySQL(String sql, Class resultClass, Object... values)` 执行Native SQL，返回封装的对象集合
`List`	`findBySQL(String sql, EasyCriteria easyCriteria)` 执行Native SQL，返回封装的对象集合
`List`	`findBySQL(String sql, Object... values)` 执行Native SQL，返回封装的对象集合
`int`	`findCount(String jpql, EasyCriteria easyCriteria)` 通过jpql语句查询总条数
`int`	`findCount(String jpql, Object... values)` 通过jpql语句查询总条数
`List`	`findMapResultBySQL(String sql, EasyCriteria easyCriteria)` 执行Native SQL，返回封装的 Map 对象集合
`List`	`findMapResultBySQL(String sql, Object... values)` 执行Native SQL，返回封装的 Map 对象集合
`int`	`findMaxPage(String jpql, int rowsPerPage, EasyCriteria easyCriteria)` 查询数据条数，并根据每页条数计算总页数
`int`	`findMaxPage(String jpql, int rowsPerPage, Object... values)` 查询数据条数，并根据每页条数计算总页数
`List`	`findNamedQuery(String name, Object... values)` 执行命名查询
`List`	`findNamedQueryByCache(String name, String queryCacheRegion, Object... values)` 执行命名查询
`List`	`findTop(String jpql, int topCount, EasyCriteria easyCriteria)` 查询前topCount条数据
`List`	`findTop(String jpql, int topCount, Object... values)` 查询前topCount条数据
`<T> T`	`findVal(String jpql, EasyCriteria easyCriteria)` 查询单个（单行单列）数据，如最大值，最小值等等
`<T> T`	`findVal(String jpql, 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`	`remove(Class cls, Serializable id)` 删除持久对象
`void`	`remove(Object o)` 删除持久对象
`void`	`updateByJpql(String jpql, Object... values)` 通过jpql语句进行批量修改（更新，删除）
`void`	`updateBySQL(String sql, Object... values)` 使用JDBC执行原生的增删改SQL语句

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

接口 CommonDAO

字段概要

方法概要

字段详细资料

DEFAULT_QUERY_CACHE_REGION

方法详细资料

batchUpdateSQL

batchUpdateSQL

remove

remove

deleteByValues

deleteCascadeByValues

evict

evict

evictAll

evictQueries

evictQueries

find

find

find

findAll

findByCache

findByCache

findByPage

findByPage

findByPage

findByProperty

findByPropertyIgnoreCase

findBySQL

findBySQL

findBySQL

findBySQL

findCount

findCount

findMapResultBySQL

findMapResultBySQL

findMaxPage

findMaxPage

findNamedQuery

findNamedQueryByCache

findTop

findTop

findVal

findVal

getCurrentEntityManager

getEntityManagerFactory

initialize

initializeDeep

merge

persist

updateByJpql

updateBySQL