DoubleRight The past of the world Blog's

Hibernate @NamedQuery教程

Hibernate @NamedQuery教程

原文： https://howtodoinjava.com/hibernate/hibernate-named-query-tutorial/

Hiberate 中的命名查询是一种技术，用于将 HQL 语句分组在单个位置中，并在以后需要使用它们时以某种名称对其进行引用。 它在很大程度上有助于代码清除，因为这些 HQL 语句不再分散在整个代码中。

除了上面的内容，以下是命名查询的一些次要优势：

  1. 快速失败：创建会话工厂时会检查其语法，从而在发生错误时使应用快速失败。
  2. 可重用：可以从多个位置访问和使用它们，从而提高了可重用性。

但是，您必须知道，命名查询确实会使代码的可读性降低，并且有时调试变得更困难，因为您必须找到正在执行的实际查询定义，并且也必须对此有所了解。

性能明智的命名查询并没有多大区别，也不会增加任何开销。

  1. 与实际执行查询的成本相比，将 HQL 查询转换为 SQL 的成本可忽略不计。
  2. 缓存查询的内存开销确实很小。 请记住，Hibernate 无论如何都需要在内存中存储所有实体元数据。

在本教程中，我将提供一个使用注解配置的命名查询的示例。

我有一个DepartmentEntity.java类，它映射到数据库中的Department表。 我编写了两个命名查询，一个用于通过其 ID 更新部门名称，第二个用于通过其 ID 选择部门。

命名查询定义具有两个重要属性：

  • name ：使用 Hiberate 会话定位名称查询的名称。
  • query：在这里，您将给出 HQL 语句以在数据库中执行。

DepartmentEntity.java

@Entity
@Table(name = "DEPARTMENT", uniqueConstraints = {
					@UniqueConstraint(columnNames = "ID"),
					@UniqueConstraint(columnNames = "NAME") })
@NamedQueries
(
	{
		@NamedQuery(name=DepartmentEntity.GET_DEPARTMENT_BY_ID, query=DepartmentEntity.GET_DEPARTMENT_BY_ID_QUERY),
		@NamedQuery(name=DepartmentEntity.UPDATE_DEPARTMENT_BY_ID, query=DepartmentEntity.UPDATE_DEPARTMENT_BY_ID_QUERY)
	}
)
public class DepartmentEntity implements Serializable {

	static final String GET_DEPARTMENT_BY_ID_QUERY = "from DepartmentEntity d where d.id = :id"; 
	public static final String GET_DEPARTMENT_BY_ID = "GET_DEPARTMENT_BY_ID"; 

	static final String UPDATE_DEPARTMENT_BY_ID_QUERY = "UPDATE DepartmentEntity d SET d.name=:name where d.id = :id"; 
	public static final String UPDATE_DEPARTMENT_BY_ID = "UPDATE_DEPARTMENT_BY_ID"; 

	private static final long serialVersionUID = 1L;

	@Id
	@GeneratedValue(strategy = GenerationType.IDENTITY)
	@Column(name = "ID", unique = true, nullable = false)
	private Integer id;

	@Column(name = "NAME", unique = true, nullable = false, length = 100)
	private String name;

	public Integer getId() {
		return id;
	}

	public void setId(Integer id) {
		this.id = id;
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}
}

为了测试，在上面的命名查询中，我编写了以下代码并执行了两个命名查询。

TestHibernateNamedQuery.java

public class TestHibernateNamedQuery 
{
	public static void main(String[] args) 
	{
		//Open the hibernate session
		Session session = HibernateUtil.getSessionFactory().openSession();
		session.beginTransaction();
		try
		{
			//Update record using named query
			Query query = session.getNamedQuery(DepartmentEntity.UPDATE_DEPARTMENT_BY_ID)
										.setInteger("id", 1)
										.setString("name", "Finance");
			query.executeUpdate();

			//Get named query instance
			query = session.getNamedQuery(DepartmentEntity.GET_DEPARTMENT_BY_ID)
										.setInteger("id", 1);
			//Get all departments (instances of DepartmentEntity)
			DepartmentEntity department = (DepartmentEntity) query.uniqueResult();
			System.out.println(department.getName());
		}
		finally
		{
			session.getTransaction().commit();
			HibernateUtil.shutdown();
		}
	}
}

Output in console:

Hibernate: update DEPARTMENT set NAME=? where ID=?
Hibernate: select department0_.ID as ID0_, department0_.NAME as NAME0_ from DEPARTMENT department0_ where department0_.ID=?
Finance

其余支持代码可以在教程最后随附的源代码中找到。

要点：

  1. 使用 JPA 样式查询语言。 例如，使用实体名代替表名。
  2. 优选将命名查询仅用于基于复杂条件选择记录。 不要过多地使用它们，否则就不会在简单的 JDBC 上使用 ORM。
  3. 请记住，命名查询的结果不会缓存在辅助缓存中，只有查询对象本身会被缓存。
  4. 每当在代码中添加任何命名查询时，都要养成添加几个单元测试用例的习惯。 并立即运行那些单元测试用例。
  5. Hiberate 中不能有两个具有相同名称的命名查询。 Hibernate 在这方面显示出快速失败的行为，并且将显示应用启动本身中的错误。

到目前为止，所有这些都与 Hiberate 中的命名查询有关。

让我知道您的想法和建议。

源码下载

祝您学习愉快！

搜索