HibernateFacade (jessma-core 3.5.1 API)

java.lang.Object
- org.jessma.dao.AbstractFacade<HibernateSessionMgr,org.hibernate.Session>
- - org.jessma.dao.hbn.HibernateFacade

```
public abstract class HibernateFacade
extends AbstractFacade<HibernateSessionMgr,org.hibernate.Session>
```
作者:

Kingfisher 功能：封装Session的数据库访问方法，支持以下查询 / 更新操作： 1、HQL 查询 / 更新 2、QBC 查询 / 更新 3、SQL 查询 / 更新异常处理：操作失败时，所有方法都抛出 DAOException 使用方法： 1、用自己实现的DAO类继承于本类，能得到相应的便利方法操作 Hibernate 2、在自己实现的数据访问 Facade 类中继承或直接使用本类，能得到相应的便利方法操作 Hibernate

构造器概要

构造器
限定符构造器和说明

protected HibernateFacade(HibernateSessionMgr mgr)

构造器
限定符	构造器和说明
`protected`	`HibernateFacade(HibernateSessionMgr mgr)`

方法概要

方法
限定符和类型	方法和说明
`protected void`	`clear()` 清空 `Session` 缓存
`protected <T> void`	`delete(List<T> objs)` 根据指定的实体对象列表删除记录
`protected <T> void`	`delete(T o)` 根据指定的实体对象删除记录
`protected <T> void`	`evict(List<T> objs)` 清除缓存中的实体对象
`protected <T> void`	`evict(T o)` 清除缓存中的实体对象
`protected void`	`flush()` 刷新 `Session` 缓存
`protected <T> List<T>`	`get(Class<T> objClass, List<Serializable> ids)` 根据主键列表获取实体对象列表
`protected <T> T`	`get(Class<T> objClass, Serializable id)` 根据主键获取实体对象
`protected <T> List<T>`	`hqlQuery(int firstResult, int maxResults, String hql, Object... params)` 根据起始记录和最大记录数执行HQL查询
`protected <T> List<T>`	`hqlQuery(String hql, Object... params)` 执行HQL查询
`protected <T> List<T>`	`hqlQuery2(int firstResult, int maxResults, String hql, KV<String,Object>... params)` 根据起始记录、最大记录数和命名参数执行HQL查询
`protected <T> List<T>`	`hqlQuery2(String hql, KV<String,Object>... params)` 根据命名参数执行HQL查询
`protected int`	`hqlUpdate(String hql, Object... params)` 执行HQL更新
`protected int`	`hqlUpdate2(String hql, KV<String,Object>... params)` 根据命名参数执行HQL更新
`protected <T> List<T>`	`load(Class<T> objClass, List<Serializable> ids)` 根据主键列表获取实体对象列表
`protected <T> T`	`load(Class<T> objClass, Serializable id)` 根据主键获取实体对象
`protected <T> List<T>`	`merge(List<T> objs)` 把指定的实体对象列表同步到数据库
`protected <T> T`	`merge(T o)` 把指定的实体对象同步到数据库
`protected <T> List<T>`	`namedQuery(int firstResult, int maxResults, String queryName, Object... params)` 根据起始记录和最大记录数执行命名查询
`protected <T> List<T>`	`namedQuery(String queryName, Object... params)` 执行命名查询
`protected <T> List<T>`	`namedQuery2(int firstResult, int maxResults, String queryName, KV<String,Object>... params)` 根据起始记录最大记录数和命名参数执行命名查询
`protected <T> List<T>`	`namedQuery2(String queryName, KV<String,Object>... params)` 根据命名参数执行命名查询
`protected int`	`namedUpdate(String queryName, Object... params)` 执行命名更新
`protected int`	`namedUpdate2(String queryName, KV<String,Object>... params)` 根据命名参数执行命名更新
`protected <T> List<T>`	`qbcQuery(Class<?> cls, org.hibernate.criterion.Criterion... criterions)` 执行QBC查询
`protected <T> List<T>`	`qbcQuery(Class<?> cls, org.hibernate.criterion.Order[] orders, org.hibernate.criterion.Criterion... criterions)` 执行QBC查询，并对结果排序
`protected <T> List<T>`	`qbcQuery(int firstResult, int maxResults, Class<?> cls, org.hibernate.criterion.Criterion... criterions)` 根据起始记录和最大记录数执行QBC查询
`protected <T> List<T>`	`qbcQuery(int firstResult, int maxResults, Class<?> cls, org.hibernate.criterion.Order[] orders, org.hibernate.criterion.Criterion... criterions)` 根据起始记录和最大记录数执行QBC查询，并对结果排序
`protected <T> List<Serializable>`	`save(List<T> objs)` 根据指定的实体对象列表插入记录
`protected <T> Serializable`	`save(T o)` 根据指定的实体对象插入记录
`protected <T> void`	`saveOrUpdate(List<T> objs)` 根据指定的实体对象列表插入或更新记录
`protected <T> void`	`saveOrUpdate(T o)` 根据指定的实体对象列表插入或更新记录
`protected <T> List<T>`	`sqlQuery(int firstResult, int maxResults, String sql, Class<?> clazz, Object... params)` 根据起始记录和最大记录数执行SQL查询
`protected <T> List<T>`	`sqlQuery(int firstResult, int maxResults, String sql, Object... params)` 根据起始记录和最大记录数执行SQL查询
`protected <T> List<T>`	`sqlQuery(String sql, Class<?> clazz, Object... params)` 执行SQL查询
`protected <T> List<T>`	`sqlQuery(String sql, Object... params)` 执行SQL查询
`protected <T> List<T>`	`sqlQuery2(int firstResult, int maxResults, String sql, KV<String,org.hibernate.type.Type>[] scalars, Object... params)` 根据起始记录和最大记录数执行SQL查询，并以指定的Scalars格式返回查询结果
`protected <T> List<T>`	`sqlQuery2(String sql, KV<String,org.hibernate.type.Type>[] scalars, Object... params)` 执行SQL查询，并以指定的Scalars格式返回查询结果
`protected <T> List<T>`	`sqlQuery3(int firstResult, int maxResults, String sql, KV<String,Object>[] entities, Object... params)` 执行SQL查询，并根据Entities返回查询结果
`protected <T> List<T>`	`sqlQuery3(String sql, KV<String,Object>[] entities, Object... params)` 执行SQL查询，并根据Entities返回查询结果
`protected <T> List<T>`	`sqlQuery4(int firstResult, int maxResults, String sql, KV<String,Object>[] entities, KV<String,String>[] joins, Object... params)` 根据起始记录和最大记录数执行SQL查询，并根据Entities和Joins返回查询结果
`protected <T> List<T>`	`sqlQuery4(String sql, KV<String,Object>[] entities, KV<String,String>[] joins, Object... params)` 执行SQL查询，并根据Entities和Joins返回查询结果
`protected int`	`sqlUpdate(String sql, Object... params)` 执行SQL更新
`protected <T> void`	`update(List<T> objs)` 根据指定的实体对象列表更新记录
`protected <T> void`	`update(T o)` 根据指定的实体对象更新记录

从类继承的方法 org.jessma.dao.AbstractFacade
getManager, getSession

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

- 构造器详细资料
  - HibernateFacade
```
protected HibernateFacade(HibernateSessionMgr mgr)
```
- 方法详细资料
  - save
```
protected <T> Serializable save(T o)
```
    根据指定的实体对象插入记录
    
    参数:
    o - : 要插入的对象
    
    返回:
    : 主键值
  - save
```
protected <T> List<Serializable> save(List<T> objs)
```
    根据指定的实体对象列表插入记录
    
    参数:
    objs - : 要插入的对象列表
    
    返回:
    : 主键值列表
  - update
```
protected <T> void update(T o)
```
    根据指定的实体对象更新记录
    
    参数:
    o - : 要更新的对象
  - update
```
protected <T> void update(List<T> objs)
```
    根据指定的实体对象列表更新记录
    
    参数:
    objs - : 要更新的对象列表
  - saveOrUpdate
```
protected <T> void saveOrUpdate(T o)
```
    根据指定的实体对象列表插入或更新记录
    
    参数:
    o - : 要插入或更新的对象
  - saveOrUpdate
```
protected <T> void saveOrUpdate(List<T> objs)
```
    根据指定的实体对象列表插入或更新记录
    
    参数:
    objs - : 要插入或更新的对象列表
  - delete
```
protected <T> void delete(T o)
```
    根据指定的实体对象删除记录
    
    参数:
    o - : 要删除的对象
  - delete
```
protected <T> void delete(List<T> objs)
```
    根据指定的实体对象列表删除记录
    
    参数:
    objs - : 要删除的对象列表
  - merge
```
protected <T> T merge(T o)
```
    把指定的实体对象同步到数据库
    
    参数:
    o - : 要同步的对象
    
    返回:
    : 同步后的对象
  - merge
```
protected <T> List<T> merge(List<T> objs)
```
    把指定的实体对象列表同步到数据库
    
    参数:
    objs - : 要同步的对象列表
    
    返回:
    : 同步后的对象列表
  - get
```
protected <T> T get(Class<T> objClass,
        Serializable id)
```
    根据主键获取实体对象
    
    参数:
    objClass - : 要加载的对象类型
    id - : 主键
    
    返回:
    : 加载的对象，如果找不到则返回 NULL
  - get
```
protected <T> List<T> get(Class<T> objClass,
              List<Serializable> ids)
```
    根据主键列表获取实体对象列表
    
    参数:
    objClass - : 要加载的对象类型
    ids - : 主键列表
    
    返回:
    : 加载的对象列表，如果找不到则对应的列表项为 NULL
  - load
```
protected <T> T load(Class<T> objClass,
         Serializable id)
```
    根据主键获取实体对象
    
    参数:
    objClass - : 要加载的对象类型
    id - : 主键
    
    返回:
    : 加载的对象，如果找不到则抛出异常
  - load
```
protected <T> List<T> load(Class<T> objClass,
               List<Serializable> ids)
```
    根据主键列表获取实体对象列表
    
    参数:
    objClass - : 要加载的对象类型
    ids - : 主键列表
    
    返回:
    : 加载的对象列表，如果其中一个找不到则抛出异常
  - evict
```
protected <T> void evict(T o)
```
    清除缓存中的实体对象
    
    参数:
    o - : 要清除的对象
  - evict
```
protected <T> void evict(List<T> objs)
```
    清除缓存中的实体对象
    
    参数:
    objs - : 要清除的对象列表
  - clear
```
protected void clear()
```
    清空 Session 缓存
  - flush
```
protected void flush()
```
    刷新 Session 缓存
  - hqlQuery
```
protected <T> List<T> hqlQuery(String hql,
                   Object... params)
```
    执行HQL查询
    
    参数:
    hql - : HQL 查询语句
    params - : 查询参数
    
    返回:
    : 查询结果
  - hqlQuery
```
protected <T> List<T> hqlQuery(int firstResult,
                   int maxResults,
                   String hql,
                   Object... params)
```
    根据起始记录和最大记录数执行HQL查询
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    hql - : HQL 查询语句
    params - : 查询参数
    
    返回:
    : 查询结果
  - hqlQuery2
```
protected <T> List<T> hqlQuery2(String hql,
                    KV<String,Object>... params)
```
    根据命名参数执行HQL查询
    
    参数:
    hql - : HQL 查询语句
    params - : 查询参数（命名参数：参数名称－参数值）
    
    返回:
    : 查询结果
  - hqlQuery2
```
protected <T> List<T> hqlQuery2(int firstResult,
                    int maxResults,
                    String hql,
                    KV<String,Object>... params)
```
    根据起始记录、最大记录数和命名参数执行HQL查询
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    hql - : HQL 查询语句
    params - : 查询参数（命名参数：参数名称－参数值）
    
    返回:
    : 查询结果
  - hqlUpdate
```
protected int hqlUpdate(String hql,
            Object... params)
```
    执行HQL更新
    
    参数:
    hql - : HQL更新语句
    params - : 查询参数
    
    返回:
    : 执行结果（影响的行数）
  - hqlUpdate2
```
protected int hqlUpdate2(String hql,
             KV<String,Object>... params)
```
    根据命名参数执行HQL更新
    
    参数:
    hql - : HQL更新语句
    params - : 查询参数（命名参数：参数名称－参数值）
    
    返回:
    : 执行结果（影响的行数）
  - namedQuery
```
protected <T> List<T> namedQuery(String queryName,
                     Object... params)
```
    执行命名查询
    
    参数:
    queryName - : 查询名称
    params - : 查询参数
    
    返回:
    : 查询结果
  - namedQuery
```
protected <T> List<T> namedQuery(int firstResult,
                     int maxResults,
                     String queryName,
                     Object... params)
```
    根据起始记录和最大记录数执行命名查询
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    queryName - : 查询名称
    params - : 查询参数
    
    返回:
    : 查询结果
  - namedQuery2
```
protected <T> List<T> namedQuery2(String queryName,
                      KV<String,Object>... params)
```
    根据命名参数执行命名查询
    
    参数:
    queryName - : 查询名称
    params - : 查询参数（命名参数：参数名称－参数值）
    
    返回:
    : 查询结果
  - namedQuery2
```
protected <T> List<T> namedQuery2(int firstResult,
                      int maxResults,
                      String queryName,
                      KV<String,Object>... params)
```
    根据起始记录最大记录数和命名参数执行命名查询
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    queryName - : 查询名称
    params - : 查询参数（命名参数：参数名称－参数值）
    
    返回:
    : 查询结果
  - namedUpdate
```
protected int namedUpdate(String queryName,
              Object... params)
```
    执行命名更新
    
    参数:
    queryName - : 查询名称
    params - : 查询参数
    
    返回:
    : 更新结果（影响的行数）
  - namedUpdate2
```
protected int namedUpdate2(String queryName,
               KV<String,Object>... params)
```
    根据命名参数执行命名更新
    
    参数:
    queryName - : 查询名称
    params - : 查询参数（命名参数：参数名称－参数值）
    
    返回:
    : 更新结果（影响的行数）
  - qbcQuery
```
protected <T> List<T> qbcQuery(Class<?> cls,
                   org.hibernate.criterion.Criterion... criterions)
```
    执行QBC查询
    
    参数:
    cls - : 要查询的实体类
    criterions - : 查询条件
    
    返回:
    : 查询结果
  - qbcQuery
```
protected <T> List<T> qbcQuery(int firstResult,
                   int maxResults,
                   Class<?> cls,
                   org.hibernate.criterion.Criterion... criterions)
```
    根据起始记录和最大记录数执行QBC查询
    
    参数:
    cls - : 要查询的实体类
    criterions - : 查询条件
    
    返回:
    : 查询结果
  - qbcQuery
```
protected <T> List<T> qbcQuery(Class<?> cls,
                   org.hibernate.criterion.Order[] orders,
                   org.hibernate.criterion.Criterion... criterions)
```
    执行QBC查询，并对结果排序
    
    参数:
    cls - : 要查询的实体类
    orders - : 排序策略
    criterions - : 查询条件
    
    返回:
    : 查询结果
  - qbcQuery
```
protected <T> List<T> qbcQuery(int firstResult,
                   int maxResults,
                   Class<?> cls,
                   org.hibernate.criterion.Order[] orders,
                   org.hibernate.criterion.Criterion... criterions)
```
    根据起始记录和最大记录数执行QBC查询，并对结果排序
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    cls - : 要查询的实体类
    orders - : 排序策略
    criterions - : 查询条件
    
    返回:
    : 查询结果
  - sqlQuery
```
protected <T> List<T> sqlQuery(String sql,
                   Object... params)
```
    执行SQL查询
    
    参数:
    sql - : SQL 查询语句
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery
```
protected <T> List<T> sqlQuery(String sql,
                   Class<?> clazz,
                   Object... params)
```
    执行SQL查询
    
    参数:
    sql - : SQL 查询语句
    clazz - : 要绑定的查询实体
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery
```
protected <T> List<T> sqlQuery(int firstResult,
                   int maxResults,
                   String sql,
                   Object... params)
```
    根据起始记录和最大记录数执行SQL查询
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    sql - : SQL 查询语句
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery
```
protected <T> List<T> sqlQuery(int firstResult,
                   int maxResults,
                   String sql,
                   Class<?> clazz,
                   Object... params)
```
    根据起始记录和最大记录数执行SQL查询
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    sql - : SQL 查询语句
    clazz - : 要绑定的查询实体
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery2
```
protected <T> List<T> sqlQuery2(String sql,
                    KV<String,org.hibernate.type.Type>[] scalars,
                    Object... params)
```
    执行SQL查询，并以指定的Scalars格式返回查询结果
    
    参数:
    sql - : SQL 查询语句
    scalars - : 查询结果转换标量集
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery2
```
protected <T> List<T> sqlQuery2(int firstResult,
                    int maxResults,
                    String sql,
                    KV<String,org.hibernate.type.Type>[] scalars,
                    Object... params)
```
    根据起始记录和最大记录数执行SQL查询，并以指定的Scalars格式返回查询结果
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    sql - : SQL 查询语句
    scalars - : 查询结果转换标量集
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery3
```
protected <T> List<T> sqlQuery3(String sql,
                    KV<String,Object>[] entities,
                    Object... params)
```
    执行SQL查询，并根据Entities返回查询结果
    
    参数:
    entities - : 要绑定的查询实体集合
    sql - : SQL 查询语句
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery3
```
protected <T> List<T> sqlQuery3(int firstResult,
                    int maxResults,
                    String sql,
                    KV<String,Object>[] entities,
                    Object... params)
```
    执行SQL查询，并根据Entities返回查询结果
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    entities - : 要绑定的查询实体集合
    sql - : SQL 查询语句
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery4
```
protected <T> List<T> sqlQuery4(String sql,
                    KV<String,Object>[] entities,
                    KV<String,String>[] joins,
                    Object... params)
```
    执行SQL查询，并根据Entities和Joins返回查询结果
    
    参数:
    sql - : SQL 查询语句
    entities - : 要绑定的查询实体集合
    joins - : 要绑定的连接实体集合
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlQuery4
```
protected <T> List<T> sqlQuery4(int firstResult,
                    int maxResults,
                    String sql,
                    KV<String,Object>[] entities,
                    KV<String,String>[] joins,
                    Object... params)
```
    根据起始记录和最大记录数执行SQL查询，并根据Entities和Joins返回查询结果
    
    参数:
    firstResult - : 起始记录索引
    maxResults - : 最大记录数
    sql - : SQL 查询语句
    entities - : 要绑定的查询实体集合
    joins - : 要绑定的连接实体集合
    params - : 查询参数
    
    返回:
    : 查询结果
  - sqlUpdate
```
protected int sqlUpdate(String sql,
            Object... params)
```
    执行SQL更新
    
    参数:
    sql - : SQL 更新语句
    params - : 查询参数
    
    返回:
    : 更新结果

类 HibernateFacade

构造器概要

方法概要

从类继承的方法 org.jessma.dao.AbstractFacade

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

构造器详细资料

HibernateFacade

方法详细资料

save

save

update

update

saveOrUpdate

saveOrUpdate

delete

delete

merge

merge

get

get

load

load

evict

evict

clear

flush

hqlQuery

hqlQuery

hqlQuery2

hqlQuery2

hqlUpdate

hqlUpdate2

namedQuery

namedQuery

namedQuery2

namedQuery2

namedUpdate

namedUpdate2

qbcQuery

qbcQuery

qbcQuery

qbcQuery

sqlQuery

sqlQuery

sqlQuery

sqlQuery

sqlQuery2

sqlQuery2

sqlQuery3

sqlQuery3

sqlQuery4

sqlQuery4

sqlUpdate