IntelliJ IDEA 2017创建第一个Hibernate 5程序
本文在IntelliJ IDEA 2017.2.1下创建第一个Hibernate 5.2.10项目。本文只介绍Hibernate作为ORM框架如何以面向对象的思想操纵数据库，所以只是建立Java项目；如果将Hibernate应用于Java Web三层结构中Dao层（数据访问层），则需要建立Java Web项目。
若使用Eclipse开发则请转到Eclipse Oxygen创建第一个Hibernate 5程序。
推荐先阅读前导文章：细说创建Hibernate程序的四大步骤
一、准备工作
本例程所使用的版本：
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
二、创建项目流程
(Tips：使用Google Chrome等浏览器可以按住Ctrl键，然后滚动鼠标滚轮可以放大网页，这样便于阅读文章。)
新建项目：
创建新项目
选择Java（或者Java Enterprise），勾选“Hibernate”。由于IDEA集成了Hibernate，可以选择Hibernate集成的Hibernate 5.2.10，也可以选择自己下载好的Hibernate框架。若选择“Download”，则点击Next：
使用IDEA提供的自动下载
或者选择“Use library”，则使用本地已经下载好的lib，点击“Create”直接导入即可：
选择使用本地库
一般只需导入
hibernate-5.2.10\required\下10个JAR包即可：
导入required目录下所有JAR包
点击Next：
点击Next
设置项目名和项目所在位置，然后点击Finish：
项目名称和位置选择
项目构建完成后的项目结构如下，会自动生成hibernate.cfg.xml文件和Main.java（可以删除此文件）文件：
初次打开IDEA
依次打开“File > Project Structure”:
添加其他JAR包
点击“Modules > Dependencies”,点击“+”，添加MySQL-JDBC驱动和JUnit4：
添加其他JAR包
点击New Library，选择从Maven仓库（Maven仓库即类似于手机上的应用商店，Maven仓库把绝大多数jar包和框架集中起来便于用户下载使用）下载jar包还是导入本地已经下载的jar包：
添加其他JAR包
若从Maven下载jar包，则在搜索栏中输入jar包名，支持模糊搜索：
添加其他JAR包
点击Add Selected：
添加其他JAR包
点击OK：
添加其他JAR包
所有jar包添加成功：
所有JAR包导入成功
修改hibernate.cfg.xml文件，并创建实体类StudentEntity.java文件和与实体对应的ORM映射StudentEntity.hbm.xml文件，创建一个测试类StudentTest.java：
第一个项目的结构
StudentEntity.java代码如下：
package com.rcnjtech.entity;
import java.util.Date;
public class StudentEntity {
private int id;
private String name;
private String sex;
//注意使用java.util.Date包下的日期类型
private Date birthday;
public StudentEntity() {
}
public StudentEntity(int id, String name, String sex, Date birthday) {
this.id = id;
this.name = name;
this.sex = sex;
this.birthday = birthday;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
}
StudentEntity.hbm.xml代码如下：
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
<class name="com.rcnjtech.entity.StudentEntity" table="Student" schema="mvc">
<id name="id" type="java.lang.Integer">
<column name="id"/>
<generator class="assigned"/>
</id>
<property name="name" type="java.lang.String">
<column name="name" not-null="true"/>
</property>
<property name="sex" type="java.lang.String">
<column name="sex" not-null="true"/>
</property>
<property name="birthday" type="java.util.Date">
<column name="birthday" not-null="true"/>
</property>
</class>
</hibernate-mapping>
hibernate.cfg.xml代码如下：
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD//EN"
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<!-- 避免中文乱码useUnicode=true&characterEncoding=UTF-8 -->
<property name="connection.url">jdbc:mysql://localhost:3306/mvc?useUnicode=true&characterEncoding=UTF-8</property>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="connection.username">root</property>
<property name="connection.password">5820MS</property>
<!-- 注意dialect的值，否则会出现奇怪的问题 -->
<property name="dialect">org.hibernate.dialect.MySQL5Dialect</property>
<property name="show_sql">true</property>
<property name="format_sql">true</property>
<property name="hbm2ddl.auto">create</property>
<mapping resource="com/rcnjtech/entity/StudentEntity.hbm.xml"/>
</session-factory>
</hibernate-configuration>
StudentTest.java代码如下：
import com.rcnjtech.entity.StudentEntity;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import java.util.Date;
public class StudentTest {
private SessionFactory sessionFactory;
private Session session;
private Transaction transaction;
@Before
public void init() {
Configuration config = new Configuration().configure();
sessionFactory = config.buildSessionFactory();
session = sessionFactory.openSession();
transaction = session.beginTransaction();
}
@After
public void destroy() {
transaction.commit();
session.close();
sessionFactory.close();
}
@Test
public void testStudent() {
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。
打开MySQL CMD进行数据验证
至此，在IntelliJ IDEA 2017.2.1下的第一个Hibernate 5.2.10项目就成功配置并运行了。
三、遇到一些问题
1、单元测试通过，并且也成功向数据库中添加表和数据，但项目仍有报错的地方，但此处的可以忽略，因为并没有错，可按照下图所示方法消除红色信息。
可以忽略的报错
2、关于Dialect属性的设置。当dialect设置为org.hibernate.dialect.MySQLDialect时，单元测试插入一条数据，发现会报了很多错误，令人头皮发麻。
当dialect为MySQLDialect时
报错
报错
然而当dialect设置为org.hibernate.dialect.MySQL5Dialect时，单元测试正常通过，数据库里也成功插入一条数据。
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
*/
public class MySQL5Dialect extends MySQLDialect {
....
}
org.hibernate.dialect.MySQLDialect.java：
/**
* An SQL dialect for MySQL (prior to 5.x).
*
* @author Gavin King
*/
@SuppressWarnings("deprecation")
public class MySQLDialect extends Dialect {
....
}
322
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
