HibernateDAO (Matrix :: 数据库类库 1.5.2 API)

java.lang.Object
- net.matrix.sql.hibernate.HibernateDAO<T,ID>

类型参数:
T - DAO 操作的对象类型
ID - 主键类型
```
public class HibernateDAO<T,ID extends Serializable>
extends Object
```
封装 Hibernate 原生 API 的 DAO 泛型基类。

字段概要

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

protected Class<T> entityClass

protected org.slf4j.Logger logger

protected org.hibernate.SessionFactory sessionFactory

字段
限定符和类型	字段和说明
`protected Class<T>`	`entityClass`
`protected org.slf4j.Logger`	`logger`
`protected org.hibernate.SessionFactory`	`sessionFactory`

构造器概要

构造器
构造器和说明
`HibernateDAO(org.hibernate.SessionFactory sessionFactory)` 通过子类的泛型定义取得对象类型 Class。
`HibernateDAO(org.hibernate.SessionFactory sessionFactory, Class<T> entityClass)`

方法概要

方法
限定符和类型	方法和说明
`int`	`batchExecute(String hql, Map<String,?> values)` 执行HQL进行批量修改/删除操作.
`int`	`batchExecute(String hql, Object... values)` 执行HQL进行批量修改/删除操作.
`org.hibernate.Criteria`	`createCriteria(org.hibernate.criterion.Criterion... criterions)` 根据Criterion条件创建Criteria.
`org.hibernate.Query`	`createQuery(String queryString, Map<String,?> values)` 根据查询HQL与参数列表创建Query对象.
`org.hibernate.Query`	`createQuery(String queryString, Object... values)` 根据查询HQL与参数列表创建Query对象.
`void`	`delete(ID id)` 按 id 删除对象。
`void`	`delete(T entity)` 删除对象。
`org.hibernate.Criteria`	`distinct(org.hibernate.Criteria criteria)` 为Criteria添加distinct transformer.
`org.hibernate.Query`	`distinct(org.hibernate.Query query)` 为Query添加distinct transformer.
`List<T>`	`find(org.hibernate.criterion.Criterion... criterions)` 按Criteria查询对象列表.
`<X> List<X>`	`find(String hql, Map<String,?> values)` 按HQL查询对象列表.
`<X> List<X>`	`find(String hql, Object... values)` 按HQL查询对象列表.
`List<T>`	`findBy(String propertyName, Object value)` 按属性查找对象列表，匹配方式为相等。
`T`	`findUnique(org.hibernate.criterion.Criterion... criterions)` 按Criteria查询唯一对象.
`<X> X`	`findUnique(String hql, Map<String,?> values)` 按HQL查询唯一对象.
`<X> X`	`findUnique(String hql, Object... values)` 按HQL查询唯一对象.
`T`	`findUniqueBy(String propertyName, Object value)` 按属性查找唯一对象，匹配方式为相等。
`void`	`flush()` Flush当前Session.
`List<T>`	`get(Collection<ID> ids)` 按 id 列表获取对象列表。
`T`	`get(ID id)` 按 id 获取对象。
`List<T>`	`getAll()` 获取全部对象。
`List<T>`	`getAll(String orderByProperty, boolean isAsc)` 获取全部对象，支持按属性行序。
`String`	`getIdName()` 取得对象的主键名.
`org.hibernate.Session`	`getSession()` 取得当前 Session。
`org.hibernate.SessionFactory`	`getSessionFactory()` 取得 sessionFactory。
`void`	`initProxyObject(Object proxy)` 初始化对象.
`boolean`	`isPropertyUnique(String propertyName, Object newValue, Object oldValue)` 判断对象的属性值在数据库内是否唯一.
`void`	`save(T entity)` 保存新增或修改的对象。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - logger
```
protected final org.slf4j.Logger logger
```
  - sessionFactory
```
protected org.hibernate.SessionFactory sessionFactory
```
  - entityClass
```
protected Class<T> entityClass
```
- 构造器详细资料
  - HibernateDAO
```
public HibernateDAO(org.hibernate.SessionFactory sessionFactory)
```
    通过子类的泛型定义取得对象类型 Class。如： public class UserDao extends HibernateDAO
  - HibernateDAO
```
public HibernateDAO(org.hibernate.SessionFactory sessionFactory,
            Class<T> entityClass)
```
- 方法详细资料
  - getSessionFactory
```
public org.hibernate.SessionFactory getSessionFactory()
```
    取得 sessionFactory。
  - getSession
```
public org.hibernate.Session getSession()
```
    取得当前 Session。
  - save
```
public void save(T entity)
```
    保存新增或修改的对象。
  - delete
```
public void delete(T entity)
```
    删除对象。
    
    参数:
    entity - 对象必须是 session 中的对象或含 id 属性的 transient 对象
  - delete
```
public void delete(ID id)
```
    按 id 删除对象。
  - get
```
public T get(ID id)
```
    按 id 获取对象。
  - get
```
public List<T> get(Collection<ID> ids)
```
    按 id 列表获取对象列表。
  - getAll
```
public List<T> getAll()
```
    获取全部对象。
  - getAll
```
public List<T> getAll(String orderByProperty,
             boolean isAsc)
```
    获取全部对象，支持按属性行序。
  - findBy
```
public List<T> findBy(String propertyName,
             Object value)
```
    按属性查找对象列表，匹配方式为相等。
  - findUniqueBy
```
public T findUniqueBy(String propertyName,
             Object value)
```
    按属性查找唯一对象，匹配方式为相等。
  - find
```
public <X> List<X> find(String hql,
               Object... values)
```
    按HQL查询对象列表.
    
    参数:
    values - 数量可变的参数,按顺序绑定.
  - find
```
public <X> List<X> find(String hql,
               Map<String,?> values)
```
    按HQL查询对象列表.
    
    参数:
    values - 命名参数,按名称绑定.
  - findUnique
```
public <X> X findUnique(String hql,
               Object... values)
```
    按HQL查询唯一对象.
    
    参数:
    values - 数量可变的参数,按顺序绑定.
  - findUnique
```
public <X> X findUnique(String hql,
               Map<String,?> values)
```
    按HQL查询唯一对象.
    
    参数:
    values - 命名参数,按名称绑定.
  - batchExecute
```
public int batchExecute(String hql,
               Object... values)
```
    执行HQL进行批量修改/删除操作.
    
    参数:
    values - 数量可变的参数,按顺序绑定.
    
    返回:
    更新记录数.
  - batchExecute
```
public int batchExecute(String hql,
               Map<String,?> values)
```
    执行HQL进行批量修改/删除操作.
    
    参数:
    values - 命名参数,按名称绑定.
    
    返回:
    更新记录数.
  - createQuery
```
public org.hibernate.Query createQuery(String queryString,
                              Object... values)
```
    根据查询HQL与参数列表创建Query对象. 与find()函数可进行更加灵活的操作.
    
    参数:
    values - 数量可变的参数,按顺序绑定.
  - createQuery
```
public org.hibernate.Query createQuery(String queryString,
                              Map<String,?> values)
```
    根据查询HQL与参数列表创建Query对象. 与find()函数可进行更加灵活的操作.
    
    参数:
    values - 命名参数,按名称绑定.
  - find
```
public List<T> find(org.hibernate.criterion.Criterion... criterions)
```
    按Criteria查询对象列表.
    
    参数:
    criterions - 数量可变的Criterion.
  - findUnique
```
public T findUnique(org.hibernate.criterion.Criterion... criterions)
```
    按Criteria查询唯一对象.
    
    参数:
    criterions - 数量可变的Criterion.
  - createCriteria
```
public org.hibernate.Criteria createCriteria(org.hibernate.criterion.Criterion... criterions)
```
    根据Criterion条件创建Criteria. 与find()函数可进行更加灵活的操作.
    
    参数:
    criterions - 数量可变的Criterion.
  - initProxyObject
```
public void initProxyObject(Object proxy)
```
    初始化对象. 使用load()方法得到的仅是对象Proxy, 在传到View层前需要进行初始化. 如果传入entity, 则只初始化entity的直接属性,但不会初始化延迟加载的关联集合和属性. 如需初始化关联属性,需执行: Hibernate.initialize(user.getRoles())，初始化User的直接属性和关联集合. Hibernate.initialize(user.getDescription())，初始化User的直接属性和延迟加载的Description属性.
  - flush
```
public void flush()
```
    Flush当前Session.
  - distinct
```
public org.hibernate.Query distinct(org.hibernate.Query query)
```
    为Query添加distinct transformer. 预加载关联对象的HQL会引起主对象重复, 需要进行distinct处理.
  - distinct
```
public org.hibernate.Criteria distinct(org.hibernate.Criteria criteria)
```
    为Criteria添加distinct transformer. 预加载关联对象的HQL会引起主对象重复, 需要进行distinct处理.
  - getIdName
```
public String getIdName()
```
    取得对象的主键名.
  - isPropertyUnique
```
public boolean isPropertyUnique(String propertyName,
                       Object newValue,
                       Object oldValue)
```
    判断对象的属性值在数据库内是否唯一. 在修改对象的情景下,如果属性新修改的值(value)等于属性原来的值(orgValue)则不作比较.

类 HibernateDAO<T,ID extends Serializable>

字段概要

构造器概要

方法概要

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

字段详细资料

logger

sessionFactory

entityClass

构造器详细资料

HibernateDAO

HibernateDAO

方法详细资料

getSessionFactory

getSession

save

delete

delete

get

get

getAll

getAll

findBy

findUniqueBy

find

find

findUnique

findUnique

batchExecute

batchExecute

createQuery

createQuery

find

findUnique

createCriteria

initProxyObject

flush

distinct

distinct

getIdName

isPropertyUnique