hibernate常用API详解

根据个人使用Hibernate的经验，介绍一下Hibernate的多种不同的查询和CUD操作，这些东西在日常开发中非常常用，希望对大家有所帮助。

以下示例均以两张表为例：member和userinfo，member帐号信息表外键关联userinfo用户基本信息表，主键自动生成即可

然后映射出的POJO如下：

public class Userinfo  implements Serializable{

　　// primary key

private java.lang.Integer id;

// fields

private java.lang.String name;

private java.lang.String code;

private java.lang.String birthday;

private java.lang.String address;

private java.util.Date createTime;

private java.lang.Integer deleteFlag;

// collections

private java.util.Set<com.bless.model.Member> members;

//省略 getter setter

}

public class Member implements Serializable{

　　// primary key

private java.lang.Integer id;

// fields

private java.lang.String loginCode;

private java.lang.String password;

private java.lang.Integer deleteFlag;

// many to one

private com.bless.model.Userinfo fkUserinfo;

//省略getter setter

}

1、Hibernate提供多种方法查询数据库数据

下面以一个最简单的查询为例：SELECT * FROM TABLE为例

1-1简单HQL语句查询

Hibernate提供了HQL查询，HQL是Hibernate推荐语句，它屏蔽了不同数据库SQL不兼容的问题，使用HQL写的查询语句在主流数据库上都能执行。

执行HQL需要创建Query对象：getSession().createQuery(hql语句);

简单HQL格式：FROM POJO 对应SQL语句：SELECT * FROM POJO对应的表名

千万注意：HQL语句中的表名和字段名不是数据库的表名和字段名，而是对应ORM映射POJO的类名和属性名！

Java代码

Query query = baseDao.getQuery("FROM Member");

List<Member> lstM = query.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

结果:一句SQL将所有结果查询出来

如果修改一下for循环的代码，查询FK的name：

Java代码

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getName());

}

结果:一句SQL查询Member表，每一次for循环又发一句SQL查询Userinfo表

总结：被查询表中如果有外键关联，在执行查询时能将外键关联字段的值查询出来，但如果想查询关联表的其它字段会另外发SQL，这个特别要注意！

1-2简单SQL语句查询

Hibernate同样支持写SQL，对原生SQL查询执行的控制是通过SQLQuery接口进行的，通过执行Session.createSQLQuery()获取这个接口

Java代码

SQLQuery sql = baseDao.getSQLQuery("SELECT * FROM member");

//查询出的结果放到指定POJO中

sql.addEntity(Member.class);

List<Member> lstM = sql.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

结果:一句SQL将所有结果查询出来

如果修改一下for循环的代码，查询FK的name，结果与前面使用HQL查询一样：一句SQL查询Member表，随后每一次for循环又发一句SQL查询Userinfo表

1-3Hibernate条件查询（Criteria）

HQL极为强大，但是有些人希望能够动态的使用一种面向对象API创建查询，而非在他们的Java代码中嵌入字符串。对于那部分人来说，Hibernate提供了直观的Criteria查询API。

获取Hibernate的Criteria对象方法：getSession().createCriteria(Class对象);

Java代码

Criteria crit = baseDao.getCriteria(Member.class);

List<Member> lstM = crit.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

其实上面这种方式就是发了一句SQL：SELECT * FROM member

结果：一句SQL将所有结果查询出来

如果修改一下for循环的代码，查询FK的name，结果与前面情况一样

2、在简单的select from table基础上，加上分页和排序

以此为例：查询第11条~20条数据，按照ID降序排列

2-1使用HQL

Java代码

Query query = baseDao.getQuery("FROM Member m ORDER BY m.id DESC");

query.setFirstResult(10);

query.setMaxResults(10);

List<Member> lstM = query.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

2-2使用SQL

Java代码

SQLQuery sql = baseDao.getSQLQuery("SELECT * FROM member m ORDER BY m.id DESC");

sql.setFirstResult(10);

sql.setMaxResults(10);

//查询出的结果放到指定POJO中

sql.addEntity(Member.class);

List<Member> lstM = sql.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

2-3使用Criteria

Java代码

Criteria crit = baseDao.getCriteria(Member.class);

crit.setFirstResult(10);

crit.setMaxResults(10);

crit.addOrder(Order.desc("id"));

List<Member> lstM = crit.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

3、数据库查询核心是条件，绝大多数SQL都会带有WHERE子句，下面介绍简单的WHERE查询

以此为例：SELECT * FROM member m WHERE m.login_code like ‘kaka%’ AND m.password in (‘12345’, ‘123451’,’123452’) AND m.delete_flag=0;这里面有like、in和=三种查询

特别注意：绝对不推荐直接在SQL语句后面拼接参数值：“*** WHERE id=”+id+” AND name like ”+name+”%”;这种方式可能会造成很严重的后果：每一个不同的id值都会在内存中创建一个SQL请求对象，如果id多并且多次执行该句SQL很可能出现宕机状况！推荐使用下面这些赋值方式，下面的方式都只会在内存中创建一个SQL请求对象。

3-1-1使用HQL“WHERE 字段=?”的形式给条件赋值

这种打?号传值的方式在JDBC是非常常见的了，使用HQL语句也可以通过这种方式赋值：

Java代码

Query query = baseDao.getQuery("FROM Member m WHERE m.loginCode LIKE ? AND m.password in (?,?,?) AND m.deleteFlag=?");

query.setParameter(0, "kaka%");

query.setParameter(1, "12345");

query.setParameter(2, "123451");

query.setParameter(3, "123452");

query.setParameter(4, 0);

List<Member> lstM = query.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

通过query.setParameter(int,Obejct)方法即可给每个?赋值，注意第一个参数是从下标0开始！

3-1-2使用HQL “WHERE 字段=:key”的形式给条件赋值

这种赋值方式是HQL特有的，什么意思呢，直接看例子分析：

Java代码

Query query = baseDao.getQuery("FROM Member m WHERE m.loginCode LIKE :code AND m.password in (:pwd) AND m.deleteFlag=:flag");

query.setParameter("code", "kaka%");

query.setParameterList("pwd", new String[]{"12345","123451","123452"});

query.setParameter("flag", 0);

List<Member> lstM = query.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

上面例子关键代码是Query调用setParameter(String,Object)和setParameterList两个方法，前者是赋单一值，后者是赋多个值（特别适合in查询赋值）。这两种赋值方法都需要传两参数：第一个参数是key值，对应HQL语句中的“:xxx”；第二个参数是value值，就对应key的实际值。这种传值比3-1-1更准确方便：一来不用担心下标错位的问题，二来如果存在”xx,xx,xx”这种格式的参数可以使用setParameterList方法，屡试不爽！

3-2-1使用SQL“WHERE 字段=?”的形式给参数赋值

Java代码

SQLQuery sql = baseDao.getSQLQuery("SELECT * FROM Member m WHERE m.login_code LIKE ? AND m.password in (?,?,?) AND m.delete_flag=?");

sql.setParameter(0, "kaka%");

sql.setParameter(1, "12345");

sql.setParameter(2, "123451");

sql.setParameter(3, "123452");

sql.setParameter(4, 0);

sql.addEntity(Member.class);

List<Member> lstM = sql.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

上面这段代码与3-1-2的代码极其相似，但是有以下几点区别：①使用SQLQuery的形式查询；②SQL语句m.login_code和m.delete_flag与前面的HQL里面不对应，前面说了HQL里面对应的是POJO（也就是Member类）的属性，而SQL语句是直接对应数据库的字段名！

3-2-2使用SQL “WHERE 字段=:key”的形式给条件赋值

注意这种key/value赋值的形式是通过SQLQuery对象创建的SQL才能用，下面这段代码是能查询出结果的

Java代码

SQLQuery sql = baseDao.getSQLQuery("SELECT * FROM Member m WHERE m.login_code LIKE :code AND m.password in (:pwd) AND m.delete_flag=:flag");

sql.setParameter("code", "kaka%");

sql.setParameterList("pwd", new String[]{"12345","123451","123452"});

sql.setParameter("flag", 0);

sql.addEntity(Member.class);

List<Member> lstM = sql.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

3-3使用Criteria来实现查询

其实Criteria出现的主要原因就是为了处理复杂的条件查询，开发人员在使用SQL编写复杂查询条件时很容易出错，Hibernate就提供了Criteria这样一个方便的API，开发人员用Java来写查询条件，最后由Hibernate转换成SQL去执行。

Java代码

Criteria crit = baseDao.getCriteria(Member.class);

crit.add(Restrictions.like("loginCode", "kaka%"));

crit.add(Restrictions.in("password", new String[]{"12345","123451","123452"}));

crit.add(Restrictions.eq("deleteFlag", 0));

List<Member> lstM = crit.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

Criteria对象通过add方法添加查询条件，Restrictions提供了各种各样的查询条件API：like、in、eq、between、or等等。这里要注意一点：像Restrictions.like(key,value)这些方法的key就是POJO中的属性，而不是数据库中的字段！

4、有时候我们调用SQL时不希望查询出表的所有字段（特别是大数据量项目更要考虑），使用纯JDBC写这样的SQL就能实现，但是如果用JDBC，得到值后还要通过ResultSet.getXXX来获取对应数据，这种方式非常麻烦。Hibernate提供了很多解决方案，使我们摆脱频繁的getXX操作。

以此为例：我希望查询Member表的id和fk_userinfo这两个字段

4-1HQL获取指定字段推荐采用面向对象的形式来实现

什么意思呢，假设Member类有一个构造函数Member(int id,int fkId)，我们通过new Member(xx,xx)赋值这样就把值放入Member中了，使用HQL也是这样的：

第一步编写Member构造函数

Java代码

public BaseMember(Integer id, Integer fkId) {

this.id = id;

Userinfo fkUserinfo = new Userinfo(fkId);

this.fkUserinfo = fkUserinfo;

}

第二步编写HQL，注意看SELECT后面的写法，这种写法看起来非常像Java的new Member是吧，只要这样写，通过Query.list()返回的结果就直接存放在List<Member>中了

Java代码

Query query = baseDao.getQuery("SELECT NEW com.bless.model. Member(m.id,m.fkUserinfo.id) FROM Member m");

List<Member> lstM = query.list();

for (Member member : lstM) {

System.out.println("id:"+member.getId()+"   fk_id:"+member.getFkUserinfo().getId());

}

两点说明：

①理论上在编写上面那句HQL时可以这样写的：SELECT NEW Member(m.id,m.fkUserinfo.id) FROM Member m（就是把Member的包名去掉），因为Member类是在Hibernate映射文件Member.hbm.xml中指定了路径的。但是Member在HQL里面是关键字，如果不加包名执行查询的话会报如下错误：java.lang.ClassCastException: org.hibernate.hql.ast.tree.SqlNode cannot be cast to org.hibernate.hql.ast.tree.PathNode。那么如果POJO对象不是*.hbm.xml中映射的类，则注意一定要加上POJO的全路径！

②上面HQL语句有这样一段代码“m.fkUserinfo.id”，这是一种面向对象的写法，表示m对象（Member）下的fkUserinfo属性（Userinfo）下的id，之所以这样写是因为Member表里的fk_userinfo外键关联Userinfo表的id，在编写hbm.xml时通常是将字段fk_userinfo设置成Userinfo对象方便关联自动查询，这也就是为什么在1-1例子中调用.getName()时会自动发送SQL的原因。

4-2使用SQL查询字段

在1-2中我使用setEntity将SELECt *查询出的数据直接映射到Member集合中，但是如果只查询Member表的部分字段就不能这样写了，先看下面这段可正确运行的代码：

Java代码

SQLQuery sql = baseDao.getSQLQuery("SELECT m.id,m.login_code,m.fk_userinfo FROM Member m");

sql.addScalar("login_code", Hibernate.STRING);

sql.addScalar("id", Hibernate.INTEGER);

List<Object[]> lstM = sql.list();

for (Object[] objects : lstM) {

System.out.println("login_code:"+objects[0]+"  id:"+objects[1]);

}

上面这段代码有几个功能点：

①通过SELECT x.xx,x.xxx FROM xx x格式查询出的数据是返回一个List<Object[]>集合，也就是List每一条数据是一个Object数组，代表一行字段，在迭代List集合后通过object[下标]取每个字段数据即可；

②addScalar(字段名,类型名)用于设置返回字段的类型，Hibernate有默认设置字段类型功能，但是如果你希望明确指定每个字段的类型则必须这么写；

③上面的SQL语句是查询三个字段“m.id,m.login_code,m.fk_userinfo”，但是结果只返回了两个字段的数据，如果在lstM循环体内写objects[2]会报下标越界错误，这是因为addScalar时只设置了login_code和id两个字段，所以要注意如果你希望查询多个字段，而且又希望通过addScalar方法设置返回类型则所有查询的字段都要调用addScalar方法！

④返回的Object数组的值顺序与SQL语句中不同，SQL语句是依照id、login_code的顺序查询，而结果却是login_code、id的顺序返回，这还是因为addScalar方法，返回值是根据addScalar方法顺序来设置值的！

⑤如果只查询Members表的几个字段不能使用addEntity直接将映射到实体中，会报找不到字段值的错误，因为有几个字段是没查询的。

4-3Criteria没有找到返回特定字段的方法，如果谁有解决方案麻烦告知我一声。

5、前面介绍了查询的各种方法，这里再介绍一下通过HQL/SQL执行增删改操作。

增删改都是能改动表结构，所以调用的方法都是相同的，只是语句不同而已，同时需要考虑事务（在执行语句前开启事务，执行语句后提交事务）这样才能保证数据完整性。

5-1 使用HQL实现删除操作

HQL删除是非常简单的，同样创建Query对象，然后调用executeUpdate方法即可，该方法能处理INSERT、UPDATE和DELETE语句。

Java代码

Query q = baseDao.getQuery("DELETE FROM Member m WHERE m BETWEEN 1 AND 10");

System.out.println("删除影响行数:"+q.executeUpdate());

5-2使用SQL实现删除操作

SQL删除也是非常简单的，同样创建SQLQuery对象，然后调用executeUpdate方法即可，该方法能处理INSERT、UPDATE和DELETE语句。

Java代码

SQLQuery q = baseDao.getSQLQuery("DELETE FROM Member WHERE login_code in (:login_code)");

q.setParameterList("login_code", new String[]{"kaka10","kaka11","kaka12"});

System.out.println("删除影响行数:"+q.executeUpdate());

6、介绍Hibernate内置的几个经典API

6-1使用几个常用的

新增一个POJO到数据库：this.getSession().save(arg0)传入参数是一个POJO对象，一定要有hbm.xml映射，Hibernate会根据对象类型发送新增SQL到数据库

更新一条表数据，：this.getSession().update(arg0)传入参数是一个POJO对象，必须有ID，Hibernate会根据id更新数据，而且此方法会将POJO对象所有属性进行更新，也就是说假设Member表login_code为”kaka”，而执行update时Member对象中的logincode未设值，则最终表的login_code值会为null

删除一条表数据：this.getSession().delete(arg0)传入参数是一个POJO对象，必须有ID，其它属性值可以不要

查询操作this.getSession().get(arg0, arg1)传入参数arg0：POJO的Class，参数arg1：POJO的id，根据主键id查询一条字段数据

延迟查询 this.getSession().load(arg0, arg1)传入参数与上面的get方法相同，功能也是根据id查询一条字段，唯一不同的是：get是调用该方法就发送SQL语句并返回数据；load是当使用返回对象时才发送SQL语句查询，如下代码

Java代码

Member m = …load(Member.class,id);

Thread.sleep(1000);

m.getId();

上面的代码肯定要发一条SQL语句查询Member表，如果用的是load方法，则是在睡眠完成运行m.getId()才发送SQL语句；而如果用的是get方法，则是在调用get方法就发送SQL语句了。

6-2经典的更新操作

从6-1的update语句中我们能看到一个弊端：不能定制更新个别字段，只能更新全部字段。Hibernate提供了一种持久化状态的更新机制，这种更新方法非常奇妙：

Java代码

Member member = (Member) getSession().get(Member.class, id);

member.setLoginCode("akaka");

member.setPassword("654321");

猜想上面这段代码会发几句SQL？根据控制台调试发现总共发了两句SQL：一句是SELECT语句查询Member表，另一句是UPDATE语句更新Member表字段，最终查询数据库时发现logincode和password的值都变成了上面设置的值。

这是一种非常好使的UPDATE方法，不用写SQL语句，直接先get后set即可自动发送SQL。

以上介绍的是非常通用的Hibernate API，当然Hibernate还提供了很多其它优秀的功能，比如缓存、复杂映射等等，这些技术需要大家在学会通用API之后再深入了解。