本文在IntelliJ IDEA 2017.2.1下创建第一个Hibernate 5.2.10项目。本文只介绍Hibernate作为ORM框架如何以面向对象的思想操纵数据库,所以只是建立Java项目;如果将Hibernate应用于Java Web三层结构中Dao层(数据访问层),则需要建立Java Web项目。
一、准备工作
本例程所使用的版本:
IntelliJ IDEA 2017.2.1 + MySQL Community Server 5.7.19 + Hibernate-Release-5.2.10.Final + Mysql-Connector-Java-5.1.43 + JUnit 4.12(Hibernate作为数据访问层框架,故本机需要安装数据库和在项目中添加相应的JDBC驱动)。
所需IDE和数据库软件:
IntelliJ IDEA 2017下载
MySQL Community Server 5.7 下载
所需框架和JAR包:
Hibernate 5下载
MySQL-JDBC驱动
JUnit4
二、创建项目流程
新建项目:
选择Java(或者Java Enterprise),勾选“Hibernate”。由于IDEA集成了Hibernate,可以选择Hibernate集成的Hibernate 5.2.10,也可以选择自己下载好的Hibernate框架。若选择“Download”,则点击Next:
或者选择“Use library”,则使用本地已经下载好的lib,点击“Create”直接导入即可:
一般只需导入 hibernate-5.2.10\required\下10个JAR包即可:
点击Next:
设置项目名和项目所在位置,然后点击Finish:
项目构建完成后的项目结构如下,会自动生成hibernate.cfg.xml文件和Main.java(可以删除此文件)文件:
依次打开“File > Project Structure”:
点击“Modules > Dependencies”,点击“+”,添加MySQL-JDBC驱动和JUnit4:
点击New Library,选择从Maven仓库(Maven仓库即类似于手机上的应用商店,Maven仓库把绝大多数jar包和框架集中起来便于用户下载使用)下载jar包还是导入本地已经下载的jar包:
若从Maven下载jar包,则在搜索栏中输入jar包名,支持模糊搜索:
点击Add Selected:
点击OK:
所有jar包添加成功:
修改hibernate.cfg.xml文件,并创建实体类StudentEntity.java文件和与实体对应的ORM映射StudentEntity.hbm.xml文件,创建一个测试类StudentTest.java:
StudentEntity.java代码如下:packagecom.rcnjtech.entity;
importjava.util.Date;
publicclassStudentEntity {
privateint id;
private String name;
private String sex;
//注意使用java.util.Date包下的日期类型
private Date birthday;
publicStudentEntity() {
}
publicStudentEntity(int id, String name, String sex, Date birthday) {
this.id = id;
this.name = name;
this.sex = sex;
this.birthday = birthday;
}
publicintgetId() {
return id;
}
publicvoidsetId(int id) {
this.id = id;
}
public String getName() {
return name;
}
publicvoidsetName(String name) {
this.name = name;
}
public String getSex() {
return sex;
}
publicvoidsetSex(String sex) {
this.sex = sex;
}
public Date getBirthday() {
return birthday;
}
publicvoidsetBirthday(Date birthday) {
this.birthday = birthday;
}
}
StudentEntity.hbm.xml代码如下:<?xml version="1.0" encoding="utf-8" ?>
hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
hibernate.cfg.xml代码如下:<?xml version='1.0' encoding='utf-8'?>
hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD//EN"
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
jdbc:mysql://localhost:3306/mvc?useUnicode=true&characterEncoding=UTF-8
com.mysql.jdbc.Driver
root
5820MS
org.hibernate.dialect.MySQL5Dialect
true
true
create
StudentTest.java代码如下:importcom.rcnjtech.entity.StudentEntity;
importorg.hibernate.Session;
importorg.hibernate.SessionFactory;
importorg.hibernate.Transaction;
importorg.hibernate.cfg.Configuration;
importorg.junit.After;
importorg.junit.Before;
importorg.junit.Test;
importjava.util.Date;
publicclassStudentTest {
private SessionFactory sessionFactory;
private Session session;
private Transaction transaction;
@Before
publicvoidinit() {
Configuration config = new Configuration().configure();
sessionFactory = config.buildSessionFactory();
session = sessionFactory.openSession();
transaction = session.beginTransaction();
}
@After
publicvoiddestroy() {
transaction.commit();
session.close();
sessionFactory.close();
}
@Test
publicvoidtestStudent() {
StudentEntity student = new StudentEntity(1, "张三", "男", new Date());
session.save(student);
}
}
进行单元测试,运行StudentTest.java里的testStudent()方法,即向数据库创建表并添加一条数据,单元测试通过:
打开MySQL 5.7 Command Line Client,发现MVC数据库下成功建立了Student表,同时也成功向Student表中添加了一条数据:1 | 张三 | 男 | 2017-08-03 22:01:57。
至此,在IntelliJ IDEA 2017.2.1下的第一个Hibernate 5.2.10项目就成功配置并运行了。
三、遇到一些问题
1、单元测试通过,并且也成功向数据库中添加表和数据,但项目仍有报错的地方,但此处的可以忽略,因为并没有错,可按照下图所示方法消除红色信息。
2、关于Dialect属性的设置。当dialect设置为org.hibernate.dialect.MySQLDialect时,单元测试插入一条数据,发现会报了很多错误,令人头皮发麻。
然而当dialect设置为org.hibernate.dialect.MySQL5Dialect时,单元测试正常通过,数据库里也成功插入一条数据。
查看org.hibernate.dialect.MySQL5Dialect和org.hibernate.dialect.MySQLDialect源码,MySQL5Dialect继承于MySQLDialect,并且从类注释可以看出MySQL5Dialect适用于MySQL 5.x版本,MySQLDialect适用于MySQL 5之前的版本。
org.hibernate.dialect.MySQL5Dialect.java:/**
* An SQL dialect for MySQL 5.x specific features.
*
* @author Steve Ebersole
*/
publicclassMySQL5DialectextendsMySQLDialect {
....
}
org.hibernate.dialect.MySQLDialect.java:
/**
* An SQL dialect for MySQL (prior to 5.x).
*
* @author Gavin King
*/
@SuppressWarnings("deprecation")
publicclassMySQLDialectextendsDialect {
....
}
故当MySQL 版本在5.0以上时dialect属性建议设置为org.hibernate.dialect.MySQL5Dialect。