web进修之—Hibernate起步（1）

web进修之—Hibernate起步（1）

一、简介

• ORM（Object/Relational Mapping）
• 支持JPA（Java Persistence API）
• 易配置（包括xml和annotation）、可定制（最大、最小配置）、可扩展
• 中间层

二、准备

下载Hibernate

到Hibernate官网下载，建议选择final版本进行下载，本片博客基于4.2.21.Final进行学习。

Hibernate下载后的目录结构介绍

• hibernate-release-4.2.21.Final
  
  • documentation Hibernate文档
  • lib Hibernate所有的库文件
    
    • envers 做数据库版本控制
    • JPA Hibernate 对JPA的实现
    • optional 包含连接池、缓存
    • osgi 与osgi继承所需jar包
    • require Hibernate基本jar包
  • project Hibernate源码
  • changelog.txt 版本修改日志
  • hibernate_logo.gif logo
  • lgpl.txt 遵循的开原协议

H2简介

H2 database
- 开源、支持JDBC API
- 支持内存模式
- 支持web控制台
- 嵌入式数据库：大约1.5m的jar文件。

其他

• 到h2官网下载安装（包含windows安装包和其他平台）
• 本实验使用intellij开发

三、第一个例子

新建工程

在intellij中File->new->project,接下来如下图

选中图中红色框部分，图中的蓝色框是intellij本身支持Hibernate框架，如果选中IDE会自动下载Hibernate依赖的jar包（Intellij的人性化之处，这个功能还没试，有空可以试试）

引入jar包

• 引入Hibernate依赖的jar包，把下载好的Hibernate解压后，把hibernate-release-4.2.21.Final\lib\required下面的8个jar包copy到WEB-INFO下面lib（自己新建一个），然后选中所有的jar包右键选择add as library,添加到工程的依赖库中
• 按照第2步的方式，引入H2数据库连接所需jar包h2-1.4.190.jar

详细代码

• 新建包下面的model类Video

package org.lep.hibernate.model;

/**
 * Created by lvep on 2016/3/15.
 */
public class Video {
    private long id;
    private String name ;
    private String url;

    // 测试如果没有一个默认无参的构造函数会怎么样
    // 结果：Hibernate的model必须一个默认无参的构造函数以便Hibernate使用reflect创建对象
    // 但是普通的java类可以不显式声明一个无参构造函数，JVM在运行时会自动分配一个
    // ?:那为什么Hibernate不能使用JVM动态创建的无参构造函数？是因为无法访问？还是。。。。
    public Video() {
        this.id = id;
    }
    public Video(long id) {
        this.id = id;
    }

    /**
     * get和set方法是建议的，但不是必须的
     * @return
     */
    public long getId() {
        return id;
    }

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

    public String getName() {
        return name;
    }

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

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    @Override
    public String toString() {
        return "Video{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", url='" + url + '\'' +
                '}';
    }
}

• Hibernate全局配置文件放在src根目录下，也就是classpath下

<!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>
        <!-- Database connection settings -->
        <!-- 注意修改为自己的数据库驱动，连接url，用户名（sa为H2数据库默认用户名），密码-->
        <property name="connection.driver_class">org.h2.Driver</property>
        <property name="connection.url">jdbc:h2:mem:test;DB_CLOSE_DELAY=-1;MVCC=TRUE</property>
        <property name="connection.username">sa</property>
        <property name="connection.password"/>

        <!-- JDBC connection pool (use the built-in) -->
        <property name="connection.pool_size">1</property>

        <!-- SQL dialect -->
        <property name="dialect">org.hibernate.dialect.H2Dialect</property>

        <!-- Disable the second-level cache  -->
        <property name="cache.provider_class">org.hibernate.cache.internal.NoCacheProvider</property>

        <!-- Echo all executed SQL to stdout -->
        <property name="show_sql">true</property>

        <!-- Drop and re-create the database schema on startup -->
        <property name="hbm2ddl.auto">create</property>

        <!-- 此处设置为第6步添加的Video实体类映射到数据库的配置文件video.hbm.xml -->
        <mapping resource="org/lep/hibernate/model/video.hbm.xml"/>

    </session-factory>
</hibernate-configuration>

• 在Video所在包下面添加model映射到数据库的配置文件video.hbm.xml

<hibernate-mapping package="org.lep.hibernate.model">

    <class name="Video" table="video">
        <id name="id" column="video_ID">
            <generator class="increment"/>
        </id>
        <property name="name" type="string" column="video_name"/>
        <property name="url" type="string" column="video_url"/>
    </class>

</hibernate-mapping>

• 如果没有column属性，hibernate默认会将字段名称作为列名，当类的字段名称为数据库保留关键字的时候注意字段和列名映射
• 因为Hibernate会使用reflect来确定映射类型，所以如果不指定映射到数据库的类型，即不指定type=”string”，会影响容器启动的性能，建议制定类型。

测试

编写测试类（需要先引入Junit4，在intellij开发环境中只需要在要测试的方法上写@Test，然后使用Alt+Insert快捷键就可以快速导入junit，由此可见IDE的强大之处）

package org.lep.hibernate.model.test;

import junit.framework.TestCase;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;
import org.junit.Test;
import org.lep.hibernate.model.Video;

import java.util.List;

/**
 * Created by lvep on 2016/3/15.
 */
public class TestApi extends TestCase {
    private SessionFactory sessionFactory;

    @Override
    public void setUp() throws Exception {
        super.setUp();
        // 初始化sessionFactory，由于Hibernate配置文件放在了classpath下，所以不用指定配置文件位置
        sessionFactory = new Configuration().configure().buildSessionFactory();

    }

    @Override
    public void tearDown() throws Exception {
        super.tearDown();
        if(sessionFactory != null){
            sessionFactory.close();
        }
    }

    @Test
    public void testBasicUsage(){
        Session session = sessionFactory.openSession();
        session.beginTransaction();
        Video v1 = new Video();
        v1.setName("1.avi");
        v1.setUrl("http://200007041.vod.myqcloud.com/200007041_3fe5e304ea5311e59289eb529c79e6bd.f20.mp4");
        session.save(v1);
        session.getTransaction().commit();
        session.close();

        session = sessionFactory.openSession();
        session.beginTransaction();
        List videos = session.createQuery("from Video").list();
        for(Video v : (List<Video>)videos){
            System.out.println(v);
        }
        session.getTransaction().commit();
        session.close();
    }
}

回顾分析

Hibernate一般使用步骤

• 引入必要的jar包（必要的只有8个，如果需要用到比如缓存之类的再另行引入）
• 创建model实体类，注意保留一个无参构造方法
• 创建Hibernate全局配置文件，注意配置文件放置路径
• 创建每一个model映射到数据库的配置文件，一般放置在该实体类包目录下
• 使用Configuration初始化SessionFactory
• 使用SessionFactory创建Session
• 拿到Session之后就可已经进行增删改查，为所欲为了

四、总结

1. 以前就学习过Hibernate，不过也是皮毛，好久没用也都忘得差不多了，不过学习过的好处就是再重新捡起来就快的多了，但是还是没能养成一个积累知识的好习惯，第一篇这么认真的blog
2. 因为学习过一点，所以可能对于初学者来说这篇博客还是不够详细，如果有幸被大家看到有什么问题，欢迎拍砖