zoukankan      html  css  js  c++  java
  • (转)Hibernate的配置详解

    http://blog.csdn.net/yerenyuan_pku/article/details/65041077

    在《Hibernate快速入门》一文中,我有讲到Hibernate的两个配置文件,今天就来详细地介绍这两个配置文件。

    Hibernate的配置详解

    在Hibernate中,我们使用时主要有两种配置文件:

    1. 核心配置文件——hibernate.cfg.xml(主要描述Hibernate的相关配置)
    2. 映射配置文件——xxx.hbm.xml

    核心配置文件

    Hibernate的核心配置文件,即hibernate.cfg.xml,主要用来描述Hibernate的相关配置。对于Hibernate的核心配置文件它有两种方式:

    1. hibernate.cfg.xml
    2. hibernate.properties

    我们在开发中使用比较多的是hibernate.cfg.xml这种方式,原因是它的配置能力更强,并且易于修改。所以我主要讲解的是hibernate.cfg.xml这种配置方式。 
    我以《Hibernate快速入门》一文案例中的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>
            <!-- 配置关于数据库连接的四个项:driverClass  url username password -->
            <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
            <property name="hibernate.connection.url">jdbc:mysql:///hibernateTest</property>
            <property name="hibernate.connection.username">root</property>
            <property name="hibernate.connection.password">yezi</property>
    
            <!-- 可以将向数据库发送的SQL语句显示出来 -->
            <property name="hibernate.show_sql">true</property>
            <!-- 格式化SQL语句 -->
            <property name="hibernate.format_sql">true</property>
            <!-- hibernate的方言 -->
            <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
    
            <!-- 配置hibernate的映射文件所在的位置 -->
            <mapping resource="cn/itheima/domain/Customer.hbm.xml" />
        </session-factory>
    </hibernate-configuration>
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23

    可将以上配置文件的内容分为3部分来看待:

    1. 加载数据库相关信息

      <!-- 配置关于数据库连接的四个项:driverClass  url username password -->
      <property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
      <property name="hibernate.connection.url">jdbc:mysql:///hibernateTest</property>
      <property name="hibernate.connection.username">root</property>
      <property name="hibernate.connection.password">yezi</property>
      • 1
      • 2
      • 3
      • 4
      • 5
      • 1
      • 2
      • 3
      • 4
      • 5
    2. Hibernate的相关配置

      <!-- 可以将向数据库发送的SQL语句显示出来 -->
      <property name="hibernate.show_sql">true</property>
      <!-- 格式化SQL语句 -->
      <property name="hibernate.format_sql">true</property>
      <!-- hibernate的方言 -->
      <property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
    3. 加载映射配置文件

      <!-- 配置hibernate的映射文件所在的位置 -->
      <mapping resource="cn/itheima/domain/Customer.hbm.xml" />
      • 1
      • 2
      • 1
      • 2

    提示:对于hibernate.cfg.xml配置文件中的内容可以参考project/etc/hibernate.properties文件中的配置。 
    查阅hibernate.properties文件,可发现有如下内容:

    #hibernate.hbm2ddl.auto create-drop
    #hibernate.hbm2ddl.auto create
    #hibernate.hbm2ddl.auto update
    #hibernate.hbm2ddl.auto validate

    那么hibernate.hbm2ddl.auto这个属性到底是个什么东东昵?这儿我就来详解讲讲。先说结论:配置这个属性后,我们可以进行表的自动创建。该属性有4个取值:

    • create-drop 
      每次都会创建一个新的表,执行完成后就删除。一般在测试中使用。
    • create 
      每次都会创建一个新的表,但不删除。一般也是在测试中使用。下面我来举例说明该属性值,要知道我也是在《Hibernate快速入门》一文案例的基础上来讲解的。 
      首先在hibernate.cfg.xml配置文件中加入如下内容:

      <!-- 自动创建表 -->
      <property name="hibernate.hbm2ddl.auto">create</property>
      • 1
      • 2
      • 1
      • 2

      然后执行单元测试类——HibernateTest1.java中的saveCustomerTest()方法:

      public class HibernateTest1 {
      
          // 保存一个Customer
          @Test
          public void saveCustomerTest() {
              // 创建一个Customer
              Customer c = new Customer();
              c.setName("叶子叶");
              c.setAddress("天门");
      
              // 使用Hibernate的API来完成将Customer信息保存到mysql数据库中的操作
              Configuration config = new Configuration().configure(); // Hibernate框架加载hibernate.cfg.xml文件
              SessionFactory sessionFactory = config.buildSessionFactory();
              Session session = sessionFactory.openSession(); // 相当于得到一个Connection
              // 开启事务
              Transaction transaction = session.beginTransaction();
      
              // 操作
              session.save(c);
      
              // 事务提交
              // session.getTransaction().commit();
              transaction.commit();
              session.close();
              sessionFactory.close();
          }
      
          ......
      }
    • 记住在测试以上方法之前,要确保数据库里面没有t_customer表。不出意外,我们就能在Eclipse的控制台上看到建表语句:

      create table hibernateTest.t_customer (
          id integer not null auto_increment,
          name varchar(20),
          address varchar(50),
          sex varchar(20),
          primary key (id)
      )
    • 和向t_customer表中插入的SQL语句:

      insert 
      into
          hibernateTest.t_customer
          (name, address, sex) 
      values
          (?, ?, ?)
    • update 
      如果数据库中有表,不创建,没有表则创建;如果映射不匹配,会自动更新表结构。 
      首先在hibernate.cfg.xml配置文件中加入如下内容:

      <!-- 自动创建表 -->
      <property name="hibernate.hbm2ddl.auto">update</property>
    • 然后在实体类——Customer.java中增加一个属性private String sex;

      public class Customer {
      
          private int id;
          private String name;
          private String address;
          private String sex;
      
          public Customer() {
              super();
          }
      
          public Customer(String name, String address) {
              super();
              this.name = name;
              this.address = address;
          }
      
          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 getAddress() {
              return address;
          }
          public void setAddress(String address) {
              this.address = address;
          }
          public String getSex() {
              return sex;
          }
          public void setSex(String sex) {
              this.sex = sex;
          }
          @Override
          public String toString() {
              return "Customer [id=" + id + ", name=" + name + ", address=" + address + "]";
          }
      
      }
    • 接着修改实体类的映射配置文件(Customer.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 package="cn.itheima.domain">
          <!-- 
              name:即实体类的全名
              table:映射到数据库里面的那个表的名称
              catalog:数据库的名称
           -->
          <class name="Customer" table="t_customer" catalog="hibernateTest">
              <!-- class下必须要有一个id的子元素 -->
              <!-- id是用于描述主键的 -->
              <id name="id" column="id">
                  <!-- 主键生成策略 -->
                  <generator class="native"></generator>
              </id>
              <!-- 
                  使用property来描述属性与字段的对应关系
                  如果length忽略不写,且你的表是自动创建这种方案,那么length的默认长度是255
              -->
              <property name="name" column="name" length="20"></property>
              <property name="address" column="address" length="50"></property>
              <property name="sex" column="sex" length="20"></property>
          </class>
      </hibernate-mapping>
    • 最后测试单元测试类——HibernateTest1.java中的saveCustomerTest()方法:

      public class HibernateTest1 {
      
          // 保存一个Customer
          @Test
          public void saveCustomerTest() {
              // 创建一个Customer
              Customer c = new Customer();
              c.setName("叶子");
              c.setAddress("天门");
              c.setSex("男");
      
              // 使用Hibernate的API来完成将Customer信息保存到mysql数据库中的操作
              Configuration config = new Configuration().configure(); // Hibernate框架加载hibernate.cfg.xml文件
              SessionFactory sessionFactory = config.buildSessionFactory();
              Session session = sessionFactory.openSession(); // 相当于得到一个Connection
              // 开启事务
              Transaction transaction = session.beginTransaction();
      
              // 操作
              session.save(c);
      
              // 事务提交
              // session.getTransaction().commit();
              transaction.commit();
              session.close();
              sessionFactory.close();
          }
      
          ......
      }
    • 查看t_customer表可发现: 

      这已说明了如果映射不匹配,会自动更新表结构。但是注意:只能添加,不能说我这个表里面有3个字段,我映射2个了,然后它就帮我删了,这是不行的!

    • validate 
      只会使用存在的表,并且会对映射关系进行校验。 
      对于validate的测试,可参考update。只须在hibernate.cfg.xml配置文件中加入如下内容:

      <!-- 自动创建表 -->
      <property name="hibernate.hbm2ddl.auto">validate</property>
      • 1
      • 2
      • 1
      • 2

      这时运行单元测试类——HibernateTest1.java中的saveCustomerTest()方法,会发现如下异常:

      org.hibernate.tool.schema.spi.SchemaManagementException: Schema-validation: missing column [sex] in table [t_customer]
          at org.hibernate.tool.schema.internal.SchemaValidatorImpl.validateTable(SchemaValidatorImpl.java:85)
          at org.hibernate.tool.schema.internal.SchemaValidatorImpl.doValidation(SchemaValidatorImpl.java:50)
          at org.hibernate.tool.hbm2ddl.SchemaValidator.validate(SchemaValidator.java:91)
          at org.hibernate.internal.SessionFactoryImpl.<init>(SessionFactoryImpl.java:473)
          at org.hibernate.boot.internal.SessionFactoryBuilderImpl.build(SessionFactoryBuilderImpl.java:444)
          at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:708)
          at org.hibernate.cfg.Configuration.buildSessionFactory(Configuration.java:724)
          at cn.itheima.test.HibernateTest1.saveCustomerTest(HibernateTest1.java:27)
          at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
          at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
          at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
          at java.lang.reflect.Method.invoke(Unknown Source)
          at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:50)
          at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
          at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
          at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
          at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
          at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
          at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
          at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
          at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
          at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
          at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
          at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
          at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
          at org.eclipse.jdt.internal.junit4.runner.JUnit4TestReference.run(JUnit4TestReference.java:86)
          at org.eclipse.jdt.internal.junit.runner.TestExecution.run(TestExecution.java:38)
          at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:459)
          at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:675)
          at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.run(RemoteTestRunner.java:382)
          at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.main(RemoteTestRunner.java:192)
    • 也即说明了如果表结构与映射文件不匹配,会报异常。

    映射配置文件

    映射配置文件的名称是类名.hbm.xml,它一般放置在实体类所在的包下。这个配置文件的主要作用是建立表与类之间的映射关系。下面我来粗略地介绍一下该映射配置文件,当然你可以在以后的Hibernate学习中逐渐地补全一些细枝末节。

    1. 统一声明包名,这样在<class>中就不需要写类的全名。

      <hibernate-mapping package="cn.itheima.domain">
          <class name="Customer" table="t_customer" catalog="hibernateTest">
              ....
          </class>
      </hibernate-mapping>
    2. 关于<class>标签配置的详细介绍:

      • name属性:类的全名称。
      • table属性:映射到数据库里面的那个表的名称,可以省略,这时表的名称就与类名一致。
      • catalog属性:数据库名称,可以省略,如果省略,则参考核心配置文件中url路径中的库名称。
    3. 关于<id>标签配置的详细介绍:

      <hibernate-mapping package="cn.itheima.domain">
          <class name="Customer" table="t_customer" catalog="hibernateTest">
              <!-- class下必须要有一个id的子元素 -->
              <!-- id是用于描述主键的 -->
              <id name="id" column="id" type="int"> <!-- java数据类型 -->
                  <!-- 主键生成策略 -->
                  <generator class="native"></generator>
              </id>
              ......
          </class>
      </hibernate-mapping>
    4. 首先该标签必须存在。<id>是用于建立类中的属性与表中的主键映射。

      • name:类中的属性名称
      • column:表中的主键名称,column也可以省略,这时列名就与类中属性名称一致
      • length:字段长度,如果length忽略不写,且你的表是自动创建这种方案,那么length的默认长度是255
      • type属性:指定类型
      • <generator>它主要是描述主键生成策略,这里就不做篇幅来介绍了,请看后面的文章。
    5. 关于<property>标签 
      它是描述类中属性与表中非主键字段的映射关系。

    关于Hibernate映射配置文件中的类型问题

    对于type属性它的取值可以有三种:

    1. Java中的数据类型
    2. Hibernate中的数据类型
    3. SQL的数据类型

    可参考下表: 
    这里写图片描述 
    那么我实体类(Customer.java)的映射配置文件可以写为:

    <?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 package="cn.itheima.domain">
        <!-- 
            name:即实体类的全名
            table:映射到数据库里面的那个表的名称
            catalog:数据库的名称
         -->
        <class name="Customer" table="t_customer" catalog="hibernateTest">
            <!-- class下必须要有一个id的子元素 -->
            <!-- id是用于描述主键的 -->
            <id name="id" column="id" type="int"> <!-- java数据类型 -->
                <!-- 主键生成策略 -->
                <generator class="native"></generator>
            </id>
            <!-- 
                使用property来描述属性与字段的对应关系
                如果length忽略不写,且你的表是自动创建这种方案,那么length的默认长度是255
            -->
            <property name="name" column="name" length="20" type="string"></property> <!-- Hibernate数据类型 -->
            <property name="address">
                <column name="address" length="50" sql-type="varchar(50)"></column> <!-- SQL的数据类型 -->
            </property>
            <property name="sex" column="sex" length="20"></property>
        </class>
    </hibernate-mapping>
  • 相关阅读:
    认识EXTJS
    Ext面向对象开发实践(turn)
    20多个在线操作系统(webOS)一览
    一个成功的博客必须知道的80个博客工具
    163.com免费邮箱背后的传奇故事
    Android ListView的滚动条始终显示并且滚动条样式自定义
    eclipse不格式化注释
    Android横屏竖屏切换
    喝茶的好处
    Android设置Gridview中的内容不滚动,然后控件中的内容随便添加的效果。
  • 原文地址:https://www.cnblogs.com/telwanggs/p/6963613.html
Copyright © 2011-2022 走看看