第五章 Hibernate核心API介绍与其使用

5.1 Configuration接口
5.1.1加载hibernate.cfg.xml并完成系统的配置
Configuration接口的作用是对Hibernate进行配置、并启动Hibernate和连接数据库系统。
在Hibernate的启动过程中，Configuration类的实例首先定位缺省XML配置文件（hibernate.cfg.xml），并读取关的配置项目，然后创建出一个SessionFactory对象。根5.1.2据Configuration对象创建一个SessionFactory对象。

Configuration cfg = new Configuration();
		cfg.configure();
		SessionFactory sessionFactory = cfg.buildSessionFactory();

5.1.3 也可以采用自定义的XML配置文件（少用）
可以指定开发者自己的*.hbm.xml文件的位置，而不是使用默认的classpath下面的hibernate.cfg.xml。但需要在代码中指示开发者自定义的XML配置文件。

cfg.configure("hibernate2.cfg.xml");

5.2 SessionFactory接口

5.2.1 利用工厂类SessionFactory中取得Session的实例

Session session = sessionFactory.openSession();

5.2.2 SessionFactory并不是轻量级的
但要注意的是SessionFactory并不是轻量级的！（占内存）
实际上它的设计者的意图是让它能在整个应用中共享。

5.2.3 每个数据存储源对应创建一个SessionFactory（单例）

5.2.4 SessionFactory的缓存
可分为两类：内置缓存和外置缓存。

5.2.4.1 SessionFactory的内置缓存中存放了Hibernate配置信息和映射元数据信息、同时也缓存了Hibernate自动生成的SQL语句等；

5.2.4.2 SessionFactory的外置缓存是一个可配置的缓存插件
在默认情况下，SessionFactory不会启用这个缓存插件。
外置缓存能存放大量数据库数据的拷贝，外置缓存的物理介质可以是内存或者硬盘。


5.3 Session接口

5.3.1轻量级的类
在Hibernate中，实例化的Session是一个轻量级的类，创建和销毁它都不会占用很多资源。
这在实际项目中确实很重要，因为在客户程序中，可能会不断地创建以及销毁Session对象，如果Session的开销太大，会给系统带来不良影响。

5.3.2非线程安全的(一请求---一线程----一session---一事务)

值得注意的是Session对象是非线程安全的，因此最好是一个线程只创建一个Session对象（将它设计为局部对象）。

private static ThreadLocal threadSession = new ThreadLocal();
public static Session getThreadLocalSession(){
		Session s = (Session) threadSession.get();
		if(s == null){
			s = sessionFactory.openSession();
			threadSession.set(s);
		}
		return s;
	}

5.3.3 Session看作介于数据连接与事务管理一种中间接口
我们可以将session想象成一个持久对象的缓冲区，Hibernate能检测到这些持久对象的改变，并及时刷新数据库。

5.3.4 每一个Session实例和一个数据库事务绑定
通常将每一个Session实例和一个数据库事务绑定，也就是说，每执行一个数据库事务（操作），都应该先创建一个新的Session实例。
如果事务执行中出现异常，应该撤销事务；同时不论事务执行成功与否，最后都应该调用Session的close()方法，从而释放Session实例占用的资源。

5.3.5如何获得Session对象
首先创建SessionFactory对象，应用程序如果访问多个数据源时，则应该产生多个SessionFactory；但是仅仅为了服务于某个请求时，不要创建一个新的 SessionFactory，因为创建SessionFactory 需要耗费大量的资源。

然后根据SessionFactory再创建Session对象

5.3.6 Session的编程规则---需要随时更新和释放
注意：应该要session.close()语句放在finally语句块中。

5.3.7 Sessin 接口中针对单条记录的基本的CURD操作方法

1、save();

session.save(Object);//session的save方法是向数据库中保存一个对象

2、delete()

 session.delete(Object);//Object对象需要有ID。对象删除后，对象状态为Transistent状态

3、load()

Session.load(Class arg0, Serializable arg1) throws HibernateException

* arg0:需要加载对象的类，例如：User.class
* arg1:查询条件(实现了序列化接口的对象)：例"4028818a245fdd0301245fdd06380001"字符串已经实现了序列化接口。如果是数值类类型，则hibernate会自动使用包装类，例如 1
* 此方法返回类型为Object，但返回的是代理对象。
* 执行此方法时不会立即发出查询SQL语句。只有在使用对象时，它才发出查询SQL语句，加载对象。
* 因为load方法实现了lazy(称为延迟加载、赖加载)
* 延迟加载：只有真正使用这个对象的时候，才加载(才发出SQL语句)
* hibernate延迟加载实现原理是代理方式。
* 采用load()方法加载数据，如果数据库中没有相应的记录，则会抛出异常对象不找到(org.hibernate.ObjectNotFoundException)

try {
    session = sf.openSession();
    session.beginTransaction();
    User user = (User)session.load(User.class,1);
    //只有在使用对象时，它才发出查询SQL语句，加载对象。
    System.out.println("user.name=" + user.getName());

    //因为此的user为persistent状态，所以数据库进行同步为龙哥。
    user.setName("发哥");

    session.getTransaction().commit();
} catch (HibernateException e) {
    e.printStackTrace();
    session.getTransaction().rollback();
} finally{
    if (session != null){
    if (session.isOpen())
    session.close();
}

4、Get()

 Session.get(Class arg0, Serializable arg1)方法

* arg0:需要加载对象的类，例如：User.class
* arg1:查询条件(实现了序列化接口的对象)：
例"4028818a245fdd0301245fdd06380001"字符串已经实现了序列化接口。如果是基数类型，则hibernate会自动转换成包装类，如 1
返回值： 此方法返回类型为Object，也就是对象，然后我们再强行转换为需要加载的对象就可以了。
如果数据不存在，则返回null;
注：执行此方法时立即发出查询SQL语句。加载User对象
加载数据库中存在的数据，代码如下：

try {
     session = sf.openSession();
     session.beginTransaction();

     / * 此方法返回类型为Object，也就是对象，然后我们再强行转换为需要加载 的对象就可以了。如果数据不存在，则返回null
       * 执行此方法时立即发出查询SQL语句。加载User对象。
       */
     User user = (User)session.get(User.class, 1);

     //数据加载完后的状态为persistent状态。数据将与数据库同步。
     System.out.println("user.name=" + user.getName());

     //因为此的user为persistent状态，所以数据库进行同步为龙哥。
     user.setName("龙哥");
  
     session.getTransaction().commit();
} catch (HibernateException e) {
     e.printStackTrace();
     session.getTransaction().rollback();
} finally{
     if (session != null){
     if (session.isOpen()){
         session.close();
     }
}

5、load()与get()区别
不存在对应记录时表现不一样；
load返回的是代理对象，等到真正使用对象的内容时才发出sql语句，这样就要求在第一次使用对象时，要求session处于open状态，否则出错
get直接从数据库加载，不会延迟加载
get()和load()只根据主键查询，不能根据其它字段查询，如果想根据非主键查询，可以使用HQL

6、update()
用来更新detached对象，更新完成后转为为persistent状态(默认更新全部字段)
更新transient对象会报错(没有ID)
更新自己设定ID的transient对象可以(默认更新全部字段)
persistent状态的对象，只要设定字段不同的值，在session提交时，会自动更新(默认更新全部字段)
更新部分更新的字段(更改了哪个字段就更新哪个字段的内容)
方法1：update/updatable属性
xml：设定<property>标签的update属性，设置在更新时是否参数更新

<property name="name" update="false"/>

注意：update可取值为true(默认)：参与更新；false：更新时不参与更新
annotateon:设定@Column的updatable属性值，true参与更新，false：不参与更新

@Column(updatable=false)
public String getTitle() {return title;}

注意：此种方法很少用，因为它不灵活
方法二：dynamic-update属性
注意：此方法目前只适合xml方式，JAP1.0 annotation没有对应的
在实体类的映射文件中的<class>标签中，使用dynamic-update属性，true：表示修改了哪个字段就更新哪个字段，其它字段不更新，但要求是同一个session(不能跨session),如果跨了session同样会更新所有的字段内容。
<class name="com.bjsxt.Student" dynamic-update="true">
代码：

@Test
public void testUpdate5() {
Session session = sessionFactory.getCurrentSession();
session.beginTransaction();
Student s = (Student)session.get(Student.class, 1);
s.setName("zhangsan5");
//提交时，会只更新name字段，因为此时的s为persistent状态
session.getTransaction().commit();
s.setName("z4");
Session session2 = sessionFactory.getCurrentSession();
session2.beginTransaction();
//更新时，会更新所有的字段，因为此时的s不是persistent状态
session2.update(s);
session2.getTransaction().commit();}

如果需要跨session实现更新修改的部分字段，需要使用session.merget()方法,合并字段内容

@Test
public void testUpdate6() {
Session session = sessionFactory.getCurrentSession();
session.beginTransaction();
Student s = (Student)session.get(Student.class, 1);
s.setName("zhangsan6");
session.getTransaction().commit();
s.setName("z4");
Session session2 = sessionFactory.getCurrentSession();
session2.beginTransaction();
session2.merge(s);
session2.getTransaction().commit()}

这样虽然可以实现部分字段更新，但这样会多出一条select语句，因为在字段数据合并时，需要比较字段内容是否已变化，就需要从数据库中取出这条记录进行比较
使用HQL(EJBQL)面向对象的查询语言(建议)

@Test
public void testUpdate7() {
Session session = sessionFactory.getCurrentSession();
session.beginTransaction();
Query q = session.createQuery(
"update Student s set s.name='z5' where s.id = 1");
q.executeUpdate();
session.getTransaction().commit();
} 

7、saveOrUpdate()
在执行的时候hibernate会检查，如果对象在数据库中已经有对应的记录(是指主键)，则会更新update，否则会添加数据save

8、clear()
清除session缓存
无论是load还是get，都会首先查找缓存(一级缓存，也叫session级缓存)，如果没有，才会去数据库查找，调用clear()方法可以强制清除session缓存

Session session = sessionFactory.getCurrentSession();
session.beginTransaction();
Teacher t = (Teacher)session.load(Teacher.class, 1);
System.out.println(t.getName());
session.clear();
Teacher t2 = (Teacher)session.load(Teacher.class, 1);
System.out.println(t2.getName());
session.getTransaction().commit();

注意：这样就会发出两条SELECT语句，如果把session.clear()去除，则只会发出一条SELECT语句，因为第二次load时，是使用session缓存中ID为1的对象，而这个对象已经在第一次load到缓存中 了。
9、flush()
在hibernate中也存在flush这个功能，在默认的情况下session.commit()之前时，其实执行了一个flush命令。
Session.flush功能：
清理缓存；
执行sql(确定是执行SQL语句(确定生成update、insert、delete语句等),然后执行SQL语句。)


Session在什么情况下执行flush:
默认在事务提交时执行；
注意：flush时，可以自己设定,使用session.setFlushMode(FlushMode)来指定。
<pre name="code" class="java" session.setFlushMode(FlushMode);

   FlushMode的枚举值：
    FlushMode.ALWAYS：任务一条SQL语句，都会flush一次
    FlushMode.AUTO ：自动flush(默认)
    FlushMode.COMMIT: 只有在commit时才flush
FlushMode.MANUAL：手动flush。
FlushMode.NEVER ：永远不flush  此选项在性能优化时可能用，比如session取数据为只读时用，这样就不需要与数据库同步了

注意：设置flush模式时，需要在session开启事务之前设置。
可以显示的调用flush；
在执行查询前，如:iterate.
注：如果主键生成策略是uuid等不是由数据库生成的，则session.save()时并不会发出SQL语句，只有flush时才会发出SQL语句，但如果主键生成策略是native由数据库生成的，则session.save的同时就发出SQL语句。


10、evict()
例如：session.evict(user)
作用：从session缓存(EntityEntries属性)中逐出该对象
但是与commit同时使用，会抛出异常

session = HibernateUtils.getSession();
tx = session.beginTransaction();

User1 user = new User1();
user.setName("李四");
user.setPassword("123");
user.setCreateTime(new Date());
user.setExpireTime(new Date());

//利用Hibernate将实体类对象保存到数据库中，因为user主键生成策略采用的是uuid，所以调用完成save后，只是将user纳入session的管理，不会发出insert语句，但是id已经生成，session中的existsInDatabase状态为false
session.save(user);

session.evict(user);//从session缓存(EntityEntries属性)中逐出该对象
//无法成功提交，因为hibernate在清理缓存时，在session的临时集合(insertions)中取出user对象进行insert操作后需要更新entityEntries属性中的existsInDatabase为true,而我们采用evict已经将user从session中逐出了，所以找不到相关数据,无法更新，抛出异常。

tx.commit();

解决在逐出session缓存中的对象不抛出异常的方法：

//在session.evict()之前进行显示的调用session.flush()方法就可以了。
session.save(user);

//flush后hibernate会清理缓存，会将user对象保存到数据库中，将session中的insertions中的user对象清除，并且会设置session中的existsInDatabase状态为false
session.flush();

session.evict(user);//从session缓存(EntityEntries属性)中逐出该对象

//可以成功提交，因为hibernate在清理缓存时，在Session的insertions中集合中无法找到user对象所以不会发出insert语句，也不会更新session中existsInDatabase的状态。
tx.commit();

5.4 Transaction接口

 Transaction tx = null;
		try{
			tx = session.beginTransaction();
			session.save(obj);
			tx.commit();
		}catch(HibernateException e){
			if(tx != null){
				tx.rollback();
			}
			throw e;
		}finally{
			if(session != null){
				session.close();
			}
		}
	}