Hibernate笔记 3：核心API - 版本历史

Eijux：/* SQLQuery */

2022-07-15T09:54:46Z

SQLQuery

←上一版本		2022年7月15日 (五) 17:54的版本
第619行：		第619行：
	<span style="color: blue; font-size: 120%;">'''SQLQuery'''</span> 接口：用于接收一个【'''sql 语句'''】进行查询，然后调用 list() 或者 uniqueResult() 方法进行查询。		<span style="color: blue; font-size: 120%;">'''SQLQuery'''</span> 接口：用于接收一个【'''sql 语句'''】进行查询，然后调用 list() 或者 uniqueResult() 方法进行查询。

	~~但是 sql 语句不会直接封装到实体对象中，'''需要手动写代码才可以封装为实体中'''。~~		采用 HQL 或 QBC 检索方式时，Hibernate 生成标准的 SQL 查询语句，适用于所有的数据库平台，因此这两种检索方式都是跨平台的。但有的应用程序可能需要根据底层数据库的 SQL 方言，来生成一些特殊的查询语句。在这种情况下，可以利用 Hibernate 提供的 SQL 检索方式。

			<span style="color: blue">'''但是 sql 语句不会直接封装到实体对象中，需要手动写代码才可以封装为实体中。'''</span>
	示例：		示例：
	# 未封装的查询：（查询结果为基本对象集合）		# 未封装的查询：（查询结果为基本对象集合）

Eijux：/* Criteria */

2022-07-15T05:56:10Z

Criteria

←上一版本		2022年7月15日 (五) 13:56的版本
第533行：		第533行：

	==== 使用 ====		==== 使用 ====
	用到的“接口/~~类”：~~		用到的“接口/类”：【注意区别：“Criteria”与“Criterion”】

	1、<span style="color: blue">'''org.hibernate.criterion.Criterion'''</span> ：Hibernate ~~提供的一个面向对象“~~'''查询条件接口'''”。		1、<span style="color: blue">'''org.hibernate.Criteria'''</span> ：Hibernate 提供的一个面向对象<span style="color: blue">“'''查询接口'''”</span>。

			2、<span style="color: blue">'''org.hibernate.criterion.Criterion'''</span> ：Hibernate 提供的一个面向对象<span style="color: blue">“'''查询条件接口'''”</span>。
	——“一个单独的查询就是 Criterion 接口的一个实例”。		——“一个单独的查询就是 Criterion 接口的一个实例”。

	2、<span style="color: blue">'''Restrictions'''</span> ~~类：提供了一系列用于设定查询条件的静态方法，用于创建~~ Criterion ~~对象。~~		3、<span style="color: blue">'''org.hibernate.criterion.Restrictions'''</span> 类：提供了一系列用于设定查询条件的静态方法，<span style="color: blue">'''用于创建 Criterion 对象'''</span>。


	~~总结：——【注意区别：“Criteria”与“Criterion”】~~
	~~Criteria 是“查询”接口；~~
	~~Criterion 是“查询条件”接口； ——Restrictions 类用于创建 Criterion 对象。~~

	使用 Criteria 对象的步骤：		使用 Criteria 对象的步骤：

Eijux：/* 常用方法 */

2022-06-15T04:00:26Z

常用方法

←上一版本		2022年6月15日 (三) 12:00的版本
第330行：		第330行：
	</syntaxhighlight>		</syntaxhighlight>
	#: 如上，两个 load 方法均会发送查询到数据库。如果注释掉 clear，则第二次 load 不发送查询到数据库，而是直接使用第一次 load 的缓存（两次 load 的是同一个记录）。		#: 如上，两个 load 方法均会发送查询到数据库。如果注释掉 clear，则第二次 load 不发送查询到数据库，而是直接使用第一次 load 的缓存（两次 load 的是同一个记录）。
	# '''flush()'''：'''~~强制同步数据（从内存到数据库）~~'''~~。【执行过程：先清除缓存，再执行相关 SQL 语句。——见：~~<big>'''[[Hibernate笔记 ~~4：核心知识~~#~~Flush机制~~]]'''</big>】		# '''flush()'''：'''Session 缓存刷出'''（到数据库）。
	#* 在默认的情况下 session.commit() 之前时，其实执行了一个 flush 命令。		#: 【即，<span style="color: blue">“'''缓存清理'''”</span>，强制同步数据（从内存到数据库） ——见：<big>'''[[Hibernate笔记 4：核心知识：Session缓存#缓存清理机制（缓存刷出）]]'''</big>】
	~~#* 只有部分 SQL 语句（update、insert、delete），才需要 flush。~~		#* 在默认的情况下 session.commit() 之前时，其实执行了一个 flush 命令。 ——【一般不需要手动调用该方法】
	~~#** 对于“session.save()”方法：~~		#* 可以通过 '''<syntaxhighlight lang="Java" inline>session.setFlushMode(FlushMode)</syntaxhighlight>''' 来设置“'''刷新时机'''”：
	#**: 如果主键生成策略是“由数据库生成”（native），则 session.save 的同时就发出 SQL 语句（insert）。否则（uuid），session.save 不会发出 SQL 语句。【？？？】		# '''evict()'''：'''从 session 缓存中逐出该对象'''。
	#* 可以通过 <syntaxhighlight lang="Java" inline>session.setFlushMode(FlushMode);</syntaxhighlight> 来设置“'''~~刷新模式~~'''”：
	~~#*: FlushMode 的枚举值：~~
	~~#*#“FlushMode.ALWAYS”：任何一条 SQL 语句，都会 flush 一次；~~
	~~#*#“FlushMode.AUTO”：自动 flush(默认)；~~
	~~#*#“FlushMode.COMMIT”：只有在 commit 时才 flush；~~
	~~#*#“FlushMode.MANUAL”：手动 flush；~~
	~~#*#“FlushMode.NEVER”：永远不 flush。（此选项在性能优化时可能用，比如 session 取数据为只读时用，这样就不需要与数据库同步了）~~
	~~#** 设置 flush 模式（FlushMode），应该在 session 开启事务之前。~~
	# '''evict()'''：'''从 session ~~缓存（EntityEntries属性）中逐出该对象~~'''。
	#* 与 commit 同时使用，会抛出异常。【？？？】		#* 与 commit 同时使用，会抛出异常。【？？？】
	#*: 示例：		#*: 示例：
第350行：		第341行：
	tx = session.beginTransaction();		tx = session.beginTransaction();

	~~User1~~ user = new ~~User1~~();		User user = new User();
	user.setName("李四");		user.setName("李四");
	user.setPassword("123");		user.setPassword("123");
第361行：		第352行：
	session.save(user);		session.save(user);

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

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

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

Eijux：/* Transaction */

2022-06-14T01:02:52Z

Transaction

←上一版本		2022年6月14日 (二) 09:02的版本
第404行：		第404行：
	此外，get() 和 load() '''只根据主键查询'''，不能根据其它字段查询，如果想根据非主键查询，可以使用 '''HQL'''。		此外，get() 和 load() '''只根据主键查询'''，不能根据其它字段查询，如果想根据非主键查询，可以使用 '''HQL'''。

	== Transaction ==		== Transaction 接口 ==
	Hibernate 进行持久化操作时（CRUD）必须进行事务控制。		Hibernate 进行持久化操作时（CRUD）必须进行事务控制。

Eijux：/* SQLQuery */

2022-06-14T00:48:44Z

SQLQuery

←上一版本		2022年6月14日 (二) 08:48的版本
第636行：		第636行：
	# 未封装的查询：（查询结果为基本对象集合）		# 未封装的查询：（查询结果为基本对象集合）
	#: <syntaxhighlight lang="Java" highlight="">		#: <syntaxhighlight lang="Java" highlight="">
	SQLQuery sqlQuery = session.createSQLQuery("select * from ~~est—customer~~");		SQLQuery sqlQuery = session.createSQLQuery("select * from cst_customer");

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

Eijux：/* Session */

2022-06-12T19:25:00Z

Session

←上一版本		2022年6月13日 (一) 03:25的版本
第89行：		第89行：
	详见：'''[[Hibernate笔记 2：配置文件详解#配置：连接池]]'''		详见：'''[[Hibernate笔记 2：配置文件详解#配置：连接池]]'''

	== Session ==		== Session 接口 ==
	Session 用于管理一个数据库的任务单元（增、删、改、查），它是 Java 应用和 Hibernate 之间主要运行接口，是抽象持久性服务概念的主要 API。		Session 用于管理一个数据库的任务单元（增、删、改、查），它是 Java 应用和 Hibernate 之间主要运行接口，是抽象持久性服务概念的主要 API。

Eijux：/* Configuration 接口 */

2022-06-12T19:23:51Z

Configuration 接口

←上一版本		2022年6月13日 (一) 03:23的版本
第1行：		第1行：
	[[category:Hibernate]]		[[category:Hibernate]]

	== Configuration 接口 ==		== 关于 ==
			注意：以下 API 多数为接口，在开发时使用的一般是其实现类。

			如：
			1、'''SessionFactory''' 接口 —— '''SessionFactoryImpl''' 类
			2、'''Session''' 接口 —— '''SessionImpl''' 类

			见：<big>'''[[Hibernate源码分析：入门代码流程]]'''</big>

			== Configuration 类 ==
	Configuration 仅仅是作为一个初始化时的对象，一个 Configeration 实例代表 Hibernate 所有 Java 类到 Sql 数据库映射的集合。		Configuration 仅仅是作为一个初始化时的对象，一个 Configeration 实例代表 Hibernate 所有 Java 类到 Sql 数据库映射的集合。

Eijux：/* 生成方式 */

2022-06-10T20:28:16Z

生成方式

←上一版本		2022年6月11日 (六) 04:28的版本
第102行：		第102行：
	#* 每次打开都是新的 Session；		#* 每次打开都是新的 Session；
	#* 需要调用 '''close''' 方法以关闭 Session。		#* 需要调用 '''close''' 方法以关闭 Session。
	# '''getCurrentSession()'''：从当前上下文中获取 Session，并'''绑定到当前线程'''；		# '''getCurrentSession()'''：从当前上下文中获取 Session，并<span style="color: blue">'''绑定到当前线程'''</span>；
	#: <syntaxhighlight lang="Java" highlight="">		#: <syntaxhighlight lang="Java" highlight="">
	Session session = sessionFactory.getCurrentSession();		Session session = sessionFactory.getCurrentSession();
	</syntaxhighlight>		</syntaxhighlight>
	#* 第一次调用会创建新的 Session ~~实例，（事务未完成前）同一线程中多次获取的是同一个~~ Session；		#* 第一次调用会创建新的 Session 实例，（如未手动管理，则）同一线程中多次获取的是同一个 Session；
	#* ~~无需手动关闭，事物提交或者回滚时会~~'''~~自动关闭~~''' Session。		#* 无需手动关闭，'''线程结束时会自动关闭''' Session。
	#* 必须配置“'''Session 管理方式'''~~”：（否则会报错“org~~.hibernate.HinerbateException: No CurrentSessionContext configured!”）		#* 必须配置“'''Session 管理方式'''”为：（否则会报错“org.hibernate.HinerbateException: No CurrentSessionContext configured!”）
	#*: <syntaxhighlight lang="xml" highlight="">		#*: <syntaxhighlight lang="xml" highlight="">
	~~<property name="current_session_context_class">thread</property>~~
	或：
	<property name="current_session_context_class">thread</property>		<property name="current_session_context_class">thread</property>
	</syntaxhighlight>		</syntaxhighlight>
	#*: 【详见：'''[[Hibernate笔记 ~~2：配置文件详解~~#~~配置：Session 管理方式~~]]'''】		#*:【详见：<big>'''[[Hibernate笔记 4：核心知识#事务管理]]'''</big>】

	=== 常用方法 ===		=== 常用方法 ===

Eijux：/* Transaction */

2022-06-10T19:13:57Z

Transaction

显示更改

Eijux：/* 常用方法 */

2022-06-10T17:18:19Z

常用方法

←上一版本		2022年6月11日 (六) 01:18的版本
第323行：		第323行：
	</syntaxhighlight>		</syntaxhighlight>
	#: 如上，两个 load 方法均会发送查询到数据库。如果注释掉 clear，则第二次 load 不发送查询到数据库，而是直接使用第一次 load 的缓存（两次 load 的是同一个记录）。		#: 如上，两个 load 方法均会发送查询到数据库。如果注释掉 clear，则第二次 load 不发送查询到数据库，而是直接使用第一次 load 的缓存（两次 load 的是同一个记录）。
	# '''flush()'''：'''强制同步数据（从内存到数据库）'''。		# '''flush()'''：'''强制同步数据（从内存到数据库）'''。【执行过程：先清除缓存，再执行相关 SQL 语句。——见：<big>'''[[Hibernate笔记 4：核心知识#Flush机制]]'''</big>】
	#* 在默认的情况下 session.commit() 之前时，其实执行了一个 flush 命令。		#* 在默认的情况下 session.commit() 之前时，其实执行了一个 flush 命令。
	#* 只有部分 SQL 语句（update、insert、delete），才需要 flush。		#* 只有部分 SQL 语句（update、insert、delete），才需要 flush。
第330行：		第330行：
	#* 可以通过 <syntaxhighlight lang="Java" inline>session.setFlushMode(FlushMode);</syntaxhighlight> 来设置“'''刷新模式'''”：		#* 可以通过 <syntaxhighlight lang="Java" inline>session.setFlushMode(FlushMode);</syntaxhighlight> 来设置“'''刷新模式'''”：
	#*: FlushMode 的枚举值：		#*: FlushMode 的枚举值：
	#*#“FlushMode.~~ALWAYS”：任务一条SQL语句，都会~~ flush 一次；		#*#“FlushMode.ALWAYS”：任何一条 SQL 语句，都会 flush 一次；
	#*#“FlushMode.AUTO”：自动 flush(默认)；		#*#“FlushMode.AUTO”：自动 flush(默认)；
	#*#“FlushMode.COMMIT”：只有在 commit 时才 flush；		#*#“FlushMode.COMMIT”：只有在 commit 时才 flush；

Hibernate笔记 3：核心API - 版本历史

Eijux：​/* SQLQuery */

Eijux：​/* Criteria */

Eijux：​/* 常用方法 */

Eijux：​/* Transaction */

Eijux：​/* SQLQuery */

Eijux：​/* Session */

Eijux：​/* Configuration 接口 */

Eijux：​/* 生成方式 */

Eijux：​/* Transaction */

Eijux：​/* 常用方法 */

Eijux：/* SQLQuery */

Eijux：/* Criteria */

Eijux：/* 常用方法 */

Eijux：/* Transaction */

Eijux：/* SQLQuery */

Eijux：/* Session */

Eijux：/* Configuration 接口 */

Eijux：/* 生成方式 */

Eijux：/* Transaction */

Eijux：/* 常用方法 */