前面已經介紹了Hibernate的一點知識,現在我們來一步一步開發Hibernate程序來學習。在這里我使用IDEA作為開發工具,Gradle作為項目構建工具。當然在實際中不一定必須使用這兩個工具,我們可以選擇自己習慣使用的工具。只要正確的添加了Hibernate相關類以及數據庫驅動,我們就能正確的運行Hibernate程序了。
新建項目
使用IDEA新建一個Gradle項目,新建之后,在build.gradle
文件中添加如下內容:
group 'yitian.learning'
version '1.0-SNAPSHOT'
apply plugin: 'java'
apply plugin: 'war'
apply from: 'https://raw.github.com/akhikhl/gretty/master/pluginScripts/gretty.plugin'
apply plugin: 'eclipse'
apply plugin: 'idea'
sourceCompatibility = 1.8
targetCompatibility = 1.8
repositories {
mavenCentral()
}
dependencies {
compile group: 'javax.servlet', name: 'javax.servlet-api', version: '3.1.0'
// compile group: 'mysql', name: 'mysql-connector-java', version: '6.0.5'
compile group: 'mysql', name: 'mysql-connector-java', version: '5.1.40'
compile group: 'org.hibernate', name: 'hibernate-core', version: '5.2.5.Final'
testCompile group: 'junit', name: 'junit', version: '4.12'
}
在Gradle解決項目依賴之后,我們就可以開始搭建Hibernate開發環境了。
SessionFactory
SessionFactory是Hibernate最重要的一個類,也是我們配置和使用Hibernate的第一步。它類似于我們學習JDBC時候的數據庫連接,SessionFactory會為我們管理做好所有事情。一般情況下一個項目只需要一個SessionFactory就可以了。我們需要做的,就是編寫它的配置文件hibernate.cfg.xml
:
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="connection.url">jdbc:mysql://localhost:3306/htest?useSSL=false</property>
<property name="connection.username">root</property>
<property name="connection.password">12345678</property>
<property name="dialect">org.hibernate.dialect.MySQLDialect</property>
<property name="show_sql">true</property>
<property name="format_sql">true</property>
<property name="hbm2ddl.auto">create</property>
</session-factory>
</hibernate-configuration>
以上就是Hibernate的配置文件,有JDBC開發經驗的同學應該很熟悉前面幾項內容吧。重點是后面這幾項。
- dialect 代表的是Hibernate使用的方言。Hibernate設計時候考慮到了多種數據庫,所以這里需要指定我們使用的數據庫。在這里我是用的就是MySQL數據庫。
- show_sql 代表的是在Hibernate會在運行的時候同時將所執行的SQL語句輸出到控制臺上,方便我們開發調試。
- format_sql 代表將上面輸出的SQL語句格式化,方便我們開發。
- hbm2ddl.auto 代表的是數據庫的生成策略。在這里使用create代表每次運行程序都重新創建數據庫。這也是我們開發時常用的選項。
配置文件寫好之后,我們就可以開始創建SessionFactory了。隨著Hibernate的更新,SessionFactory的創建方式也發生了變化。以前我看視頻教程的時候,我照著老師的創建方式創建SessionFactory的時候,Hibernate提示我老師講的那種方式已經過時了。不過現在我直接看的Hibernate官方文檔,所以下面這個方式應該是比較新的。
package yitian.data;
import org.hibernate.SessionFactory;
import org.hibernate.boot.MetadataSources;
import org.hibernate.boot.registry.StandardServiceRegistry;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
public class HibernateUtil {
private static SessionFactory sessionFactory;
static {
final StandardServiceRegistry registry = new StandardServiceRegistryBuilder()
.configure()
.build();
try {
sessionFactory = new MetadataSources(registry).buildMetadata().buildSessionFactory();
} catch (Exception e) {
StandardServiceRegistryBuilder.destroy(registry);
throw new RuntimeException(e);
}
}
public static SessionFactory getSessionFactory() {
return sessionFactory;
}
}
這就是我的SessionFactory創建類,為了省事我直接寫為了靜態類,實際情況中一般使用Spring來管理Hibernate SessionFactory的生命周期。重點是靜態初始化塊中的代碼,這就是Hibernate的初始化方式。StandardServiceRegistryBuilder
類會搜索我們剛才寫的hibernate.cfg.xml
配置文件,所以為了保證正確的初始化SessionFactory,一般情況下需要將hibernate.cfg.xml
放在CLASSPATH下。由于我用的是Gradle,所以配置文件要放在resources
文件夾下。如果是普通的Java Web項目,就放在webapps/WEB-INF
下。一開始我直接從Hibernate官方教程抄的代碼,結果它直接在catch中吃掉了異常,導致我一天沒搞明白錯誤在哪里。因此在這里我加上了拋出語句。
接下來測試一下SessionFactory是否配置成功。我在這里將單元測試寫在src/test/java
文件夾中,以便讓Gradle自動運行這些測試。
package yitian.data;
import org.hibernate.SessionFactory;
import org.junit.*;
public class HibernateTest {
private static SessionFactory factory;
@BeforeClass
public static void init() {
factory = HibernateUtil.getSessionFactory();
}
@Test
public void testHibernate() {
Assert.assertNotNull(factory);
}
@AfterClass
public static void clean() {
factory.close();
}
}
這個單元測試很簡單,就是看一下SessionFactory是否為空。使用Gradle的話運行一下gradle test
命令即可。如果沒有使用Gradle的話也可以使用Eclipse或者IDEA提供的單元測試工具來測試。