Hibernate的SQLQuery与Query占位符传参

Hibernate支持SQLQuery（特定数据库平台有关的sql语句）和Query（hql）查询方式，当然还有Criteria对象查询方式；本文介绍SQLQuery和Query的几种传参的方式和注意事项；

SQLQuery

1、查询结果映射到map，：param传参

public List> findMapBySql(String sql, Map params) {
      SQLQuery sqlQuery = this.getCurrentSession().createSQLQuery(sql);
      sqlQuery=getSqlQueryByMap(sqlQuery,params);
      return sqlQuery.setResultTransformer(Transformers.ALIAS_TO_ENTITY_MAP).list();
    } 

public SQLQuery getSqlQueryByMap(SQLQuery sqlQuery,Map params){
        if (params != null && !params.isEmpty()) {
            for (String key : params.keySet()) {
                Object obj = params.get(key);
                if (obj instanceof Collection)
                    sqlQuery.setParameterList(key, (Collection) obj);
                else if (obj instanceof Object[])
                    sqlQuery.setParameterList(key, (Object[]) obj);
                else
                    sqlQuery.setParameter(key, obj);

            }
        }
        return sqlQuery;
    }

返回的数据是一个map类型的列表，参数通过map传递，参数类型为：param；

调用示例：

String sql="select id,user_name,create_date_time from tbl_user where code=:code"
Map<String,Object> params=new HashMap<>();
params.put("code","test");
List<Map<String,Object>> users=this.findMapBySql(sql,params);

如果需要转化为实体的集合，需要自己处理

2、查询结果映射到实体，：param传参

 public  List find(String sql, Map params, Class clazz) {

        SQLQuery query = this.getCurrentSession().createSQLQuery(sql);
        query=getSqlQueryByMap(query,params);
        query.setResultTransformer(Transformers.aliasToBean(clazz));
        return query.list();
    }

返回的数据是一个实体的列表，参数通过map传递，参数类型为：param，需要注意的是，数据库字段必须和映射的实体字段一一对应，而且存在getter/setter方法，不然会报错。

调用示例：

String sql="select id,user_name,create_date_time from tbl_user where code=:code"
Map<String,Object> params=new HashMap<>();
params.put("code","test");
List<User> users=this.find(sql,params,User.class);

则需要User实体中有user_name,create_date_time的属性定义，而不是userName,createDateTime,当然可以通过制定别名解决这个问题；

还有如下的一种方式，也可以获取实体列表

   public  List findBySql(String sql, Class<T> clazz) {

        SQLQuery sqlQuery = this.getCurrentSession().createSQLQuery(sql);
        sqlQuery.addEntity(clazz);
        return sqlQuery.list();
    }

同样是获取实体列表，下面的方式是将找到数据库字段名对应的实体属性名，比如sql->user_name会映射到entity->userName，注意：@Transient的实体是不会赋值的，对应的查询结果不会注入到entity;

3、查询结果映射到map或实体，？传参

  public List findMapBySql(String sql, Object[] params, Type[] types, Class clazz) {

        SQLQuery query = this.getCurrentSession().createSQLQuery(sql);
        if (clazz != null) {
            query.setResultTransformer(Transformers.aliasToBean(clazz));
        } else {
            query.setResultTransformer(Transformers.ALIAS_TO_ENTITY_MAP);
        }
        query.setParameters(params, types);
        return query.list();
    }

返回的数据是一个列表，根据clazz参数判断返回的map类型的列表还是实体列表，参数使用了？占位符，在集合参数中比如in，需要用多个?代替;

调用示例：

String sql="select id,user_name,create_date_time from tbl_user where code like ? and id in (?,?,?)"
Object[] params=new Object[]{"%test%",1,3,5};
Type[] types=new Type[]{Hibernate.String,Hibernate,Integer,Hibernate.Integer,Hibernate.Integer};
ListString,Object>> users=this.findMapBySql(sql,params,types,null);

Query

通过HQL语句查询数据，查询结果也同SQLQuery类型：

1. 支持setResultTransformer把查询结果映射到实体列表或者map列表
2. 支持通过setParameters（？传参）
3. setParameter/setParameterList（：param传参）
4. 不支持addEntity映射到实体（因为hql本文是和实体绑定的）

此外，Hiberante查询还支持Criteria和Example两种方式；