Hibernate 示例 – HelloWorld 示例逐步简介

Hibernate 示例 – HelloWorld 示例逐步简介

原文: https://howtodoinjava.com/hibernate/hibernate-3-introduction-and-writing-hello-world-application/

Hibernate 由 Gavin King 在 2001 年启动,它是使用 EJB2 样式实体 bean 的替代方法。 当时,它的任务是通过简化复杂性并允许缺少功能来为 EJB2 提供更好的持久化。

Hibernate 使用其映射文件和配置文件来实现其目标。 随着 JDK 1.5 在 Java 社区中引入注解,Hibernate 社区开始致力于支持注解的 Hibernate 3。 Hiberate 的当前版本是Hiberate 5

在带有注解的 Hiberate 示例中,我们将学习有关 Hiberate 的更多信息,并逐步为初学者构建第一个正在运行的示例应用。

Table of Contents

What is hibernate
How hibernate works
Relation of hibernate with JPA
Hibernate HelloWorld example

什么是 Hibernate

Hibernate 是 Java 的开源对象关系映射工具。 它提供了一个框架,用于将面向对象的域模型映射到传统的关系数据库。 Hibernate 不仅负责从 Java 类到数据库表(以及从 Java 数据类型到 SQL 数据类型)的映射,而且还提供数据查询和检索功能,并且可以显着减少开发时间,否则将花费大量时间在 SQL 和 JDBC 中进行手动数据处理 。

通过配置 XML 文件或使用 Java 注解将 Java 类映射到数据库表。 提供了用于安排类之间的一对多多对多关系的设施。

除了管理对象之间的关联之外,Hibernate 还可以管理自反关联,其中对象与自己类型的其他实例具有一对多关系。

Hibernate 如何运作

Hiberate 不会妨碍我们; 也不会迫使我们改变对象的行为方式。 这些对象无需实现任何神奇的接口即可拥有持久的能力。 我们要做的全部工作是将一些元数据放入注解的形式,这些注解告诉 hibernate 在与数据库映射时如何使用它们。 在运行时,hibernate 读取这些注解并使用此信息来构建查询以发送到某些关系数据库。

Hibernate 中有一个简单直观的 API,可以对数据库表示的对象执行查询,以更改我们通常在程序中与它们正常交互的那些对象,然后告诉 Hibernate 保存更改。 创建新对象也同样简单。 我们只是以常规方式创建它们,并使用注解将它们告知 Hibernate,以便它们可以存储到数据库中。

Hiberate 与 JPA 的关系

JPA(Java 持久化 API)是持久化供应器要实现的规范。 Hibernate 就是这样的 JPA 规范的实现。 我们可以使用 JPA 注解对注解进行尽可能多的注解,但是如果没有实现,将不会发生任何事情。

可以将 JPA 视为必须遵循的准则/规范或接口,而 Hibernate JPA 实现是符合 JPA 定义的 API 并提供底层功能的代码。

当我们将 Hibernate 与 JPA 一起使用时,实际上是在使用 Hibernate JPA 实现。 这样做的好处是我们可以将 JPA 的 Hiberate 实现换成 JPA 规范的另一种实现。

当我们使用直接 Hiberate 时,由于其他 ORM 可能使用不同的方法/配置和注解,因此您将锁定到实现中,因此我们不能仅切换到另一个 ORM。

Java Hibernate HelloWorld 示例

让我们逐步创建一个 Hiberate 的 HelloWorld 示例。 在此示例中,我创建了一个Employee类并声明了四个属性idemailfirstnamelastname

我希望id属性应自动生成,以便应用代码不存储员工 ID 的本地缓存。

到目前为止,我们的目标是要在第一个应用中进行制作。 让我们确定需要创建的文件。

  1. hibernate.cfg.xml - 此配置文件将用于存储数据库连接信息和架构级别设置。
  2. EmployeeEntity.java - 此类将引用具有 Hiberate 注解的 Java POJO。
  3. HibernateUtil.java – 此类将具有工具方法,这些方法将用于创建会话工厂和会话对象。
  4. TestHibernate.java - 此类将用于测试我们的配置设置和Emplyee实体注解。

在进入代码之前,让我们看一下项目的设置并添加 maven 依赖项,这些依赖项需要添加到pom.xml以包括所有编译时间和运行时依赖项。

1. 创建一个 Maven 项目

mvn-create-java-project

2. 使项目支持 Eclipse

Adding-eclipse-support in maven project

3. 将 Java 项目导入到 Eclipse 工作区

Import java project in eclipse

以上步骤将创建最小设置。 现在该添加 Hiberate 依赖项了。

4. Hiberate Maven 依赖项

<dependency>
	<groupid>org.hibernate</groupid>
	<artifactid>hibernate-commons-annotations</artifactid>
	<version>3.0.0.ga</version>
</dependency>
<dependency>
	<groupid>org.hibernate</groupid>
	<artifactid>hibernate-annotations</artifactid>
	<version>3.3.0.ga</version>
</dependency>
<dependency>
	<groupid>mysql</groupid>
	<artifactid>mysql-connector-java</artifactid>
	<version>5.1.6</version>
</dependency>
<dependency>
	<groupid>antlr</groupid>
	<artifactid>antlr</artifactid>
	<version>2.7.6</version>
</dependency>
<dependency>
	<groupid>commons-collections</groupid>
	<artifactid>commons-collections</artifactid>
	<version>3.1</version>
</dependency>
<dependency>
	<groupid>dom4j</groupid>
	<artifactid>dom4j</artifactid>
	<version>1.6.1</version>
</dependency>
<dependency>
	<groupid>javassist</groupid>
	<artifactid>javassist</artifactid>
	<version>3.4.GA</version>
</dependency>
<dependency>
	<groupid>javax.transaction</groupid>
	<artifactid>jta</artifactid>
	<version>1.1</version>
</dependency>
<dependency>
	<groupid>org.slf4j</groupid>
	<artifactid>slf4j-api</artifactid>
	<version>1.5.6</version>
</dependency>
<dependency>
	<groupid>org.slf4j</groupid>
	<artifactid>slf4j-log4j12</artifactid>
	<version>1.5.6</version>
</dependency>

请注意,在此 Hiberate 示例中,我们并没有使用所有的 Maven 依赖项,但是当我们开始扩展应用时将使用它们。

5. Hiberate 配置

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
        <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql://localhost:3306/hibernatetest</property>
        <property name="hibernate.connection.password">lg225295</property>
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
        <property name="show_sql">true</property>
		<property name="hbm2ddl.auto">update</property>
        <mapping class="hibernate.test.dto.EmployeeEntity"></mapping>
    </session-factory>
</hibernate-configuration>

运行此 Hiberate 示例之前,请不要忘记设置正确的密码。

6. Hiberate 实体类

package hibernate.test.dto;

import java.io.Serializable;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.UniqueConstraint;

import org.hibernate.annotations.OptimisticLockType;

@Entity
@org.hibernate.annotations.Entity(optimisticLock = OptimisticLockType.ALL)
@Table(name = "Employee", uniqueConstraints = {
		@UniqueConstraint(columnNames = "ID"),
		@UniqueConstraint(columnNames = "EMAIL") })
public class EmployeeEntity implements Serializable {

	private static final long serialVersionUID = -1798070786993154676L;

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

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

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

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

	// Accessors and mutators for all four fields
}

7. Hiberate 会话工厂

package hibernate.test;

import java.io.File;

import org.hibernate.SessionFactory;
import org.hibernate.cfg.AnnotationConfiguration;

public class HibernateUtil 
{
	private static final SessionFactory sessionFactory = buildSessionFactory();

	private static SessionFactory buildSessionFactory() 
	{
		try {
			// Create the SessionFactory from hibernate.cfg.xml
			return new AnnotationConfiguration().configure(
					new File("hibernate.cgf.xml")).buildSessionFactory();

		} catch (Throwable ex) {
			// Make sure you log the exception, as it might be swallowed
			System.err.println("Initial SessionFactory creation failed." + ex);
			throw new ExceptionInInitializerError(ex);
		}
	}

	public static SessionFactory getSessionFactory() {
		return sessionFactory;
	}

	public static void shutdown() {
		// Close caches and connection pools
		getSessionFactory().close();
	}
}

请不要忘记使用hibernate.cgf.xml的正确路径。

8. 演示

package hibernate.test;

import hibernate.test.dto.EmployeeEntity;
import org.hibernate.Session;

public class TestHibernate {

	public static void main(String[] args) {
		Session session = HibernateUtil.getSessionFactory().openSession();
		session.beginTransaction();

		// Add new Employee object
		EmployeeEntity emp = new EmployeeEntity();
		emp.setEmail("demo-user@mail.com");
		emp.setFirstName("demo");
		emp.setLastName("user");

		session.save(emp);

		session.getTransaction().commit();
		HibernateUtil.shutdown();
	}
}

上面的代码将在数据库中创建一个新的表Employee,并在此表中插入一行。 在日志中,您可以验证已执行的插入语句。

Hibernate: insert into Employee (EMAIL, FIRST_NAME, LAST_NAME) values (?, ?, ?)

如果您在运行 Hiberate 的 HelloWorld 示例时遇到问题,请给我评论,我将很高兴与您讨论问题。

学习愉快!

下载源码

参考文献:

Hiberate 首页