hibernate api文档的学习摘要day1

最新推荐文章于 2020-02-21 21:25:19 发布

wep12

最新推荐文章于 2020-02-21 21:25:19 发布

阅读量318

点赞数 1

本文链接：https://blog.csdn.net/wep12/article/details/43449537

版权

持久化类，私有化属性并设置getter，setter方法，构造一个无参构造器。

映射文件的配置

1。基本结构：

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
        "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
        "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

<hibernate-mapping>
[...]
</hibernate-mapping>

在hibernate-mapping标签（tag）之间, 含有一个class元素。所有的持久化实体类都需要一个这样的映射，来把类对象映射到SQL数据库里的表。

<hibernate-mapping>

    <class name="events.Event" table="EVENTS">

    </class>

</hibernate-mapping>
每个实例对应着数据库表中的一行。配置由Hibernate的标识符生成策略来产生代理主键字段。            
<hibernate-mapping>

    <class name="events.Event" table="EVENTS">
        <id name="id" column="EVENT_ID">
            <generator class="native"/>
        </id>
    </class>

</hibernate-mapping>
id元素是标识符属性的声明，name="id" 声明了Java属性的名字 － Hibernate会使用getId()和setId()来访问它。  column属性则告诉Hibernate, 我们使用EVENTS表的哪个字段作为主键。嵌套的generator元素指定了标识符生成策略，在这里我们指定native，它根据已配置的数据库（方言）自动选择最佳的标识符生成策略。Hibernate支持由数据库生成，全局唯一性（globally unique）和应用程序指定（或者你自己为任何已有策略所写的扩展）这些策略来生成标识符。             
  最后我们在映射文件里面包含需要持久化属性的声明。默认情况下，类里面的属性都被视为非持久化的：            
<hibernate-mapping>

    <class name="events.Event" table="EVENTS">
        <id name="id" column="EVENT_ID">
            <generator class="native"/>
        </id>
        <property name="date" type="timestamp" column="EVENT_DATE"/>
        <property name="title"/>
    </class>

</hibernate-mapping>
和id元素一样，property元素的name属性告诉Hibernate使用哪个getter和setter方法。在此例中，Hibernate会寻找getDate()/setDate(), 以及getTitle()/setTitle()。     为什么date属性的映射含有column attribute，而title却没有？当没有设定column attribute 的时候，Hibernate缺省地使用JavaBean的属性名作为字段名。对于title，这样工作得很好。然而，date在多数的数据库里，是一个保留关键字，所以我们最好把它映射成一个不同的名字。    另一有趣的事情是title属性缺少一个type attribute。我们在映射文件里声明并使用的类型，却不是我们期望的那样，是Java数据类型，同时也不是SQL数据库的数据类型。这些类型就是所谓的Hibernate 映射类型（mapping types），它们能把Java数据类型转换到SQL数据类型，反之亦然。再次重申，如果在映射文件中没有设置type属性的话，Hibernate会自己试着去确定正确的转换类型和它的映射类型。在某些情况下这个自动检测机制（在Java 类上使用反射机制）不会产生你所期待或需要的缺省值。date属性就是个很好的例子，Hibernate无法知道这个属性（java.util.Date类型的）应该被映射成：SQL date，或timestamp，还是time 字段。在此例中，把这个属性映射成timestamp 转换器，这样我们预留了日期和时间的全部信息。            
应该把这个映射文件保存为Event.hbm.xml，且就在EventJava类的源文件目录下。映射文件可随意地命名，但hbm.xml的后缀已成为Hibernate开发者社区的约定
2. hibernate配置文件
  为了保存Hibernate的配置，我们可以使用一个简单的hibernate.properties文件，或者一个稍微复杂的hibernate.cfg.xml，甚至可以完全使用程序来配置Hibernate。多数用户更喜欢使用XML配置文件：            
<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
        "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>

    <session-factory>

        <!-- Database connection settings -->
        <property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
        <property name="connection.url">jdbc:hsqldb:hsql://localhost</property>
        <property name="connection.username">sa</property>
        <property name="connection.password"></property>

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

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

        <!-- Enable Hibernate's automatic session context management -->
        <property name="current_session_context_class">thread</property>

        <!-- Disable the second-level cache  -->
        <property name="cache.provider_class">org.hibernate.cache.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>

        <mapping resource="events/Event.hbm.xml"/>

    </session-factory>

</hibernate-configuration>
注意这个XML配置使用了一个不同的DTD。在这里，我们配置了Hibernate的SessionFactory－一个关联于特定数据库全局的工厂（factory）。如果你要使用多个数据库，就要用多个的<session-factory>，通常把它们放在多个配置文件中（为了更容易启动）。            
最开始的4个property元素包含必要的JDBC连接信息。方言（dialect）的property元素指明Hibernate 生成的特定SQL变量。你很快会看到，Hibernate对持久化上下文的自动session管理就会派上用场。 打开hbm2ddl.auto选项将自动生成数据库模式（schema）－	直接加入数据库中。当然这个选项也可以被关闭（通过去除这个配置选项）或者通过Ant任务SchemaExport的帮助来把数据库schema重定向到文件中。最后，在配置中为持久化类加入映射文件。  
3.创建辅助类启动hibernate           
public class HibernateUtil {

    private static final SessionFactory sessionFactory;

    static {
        try {
            // Create the SessionFactory from hibernate.cfg.xml
            sessionFactory = new Configuration().configure().buildSessionFactory();
        } catch (Throwable ex) {
            // Make sure you log the exception, as it might be swallowed
            System.err.println("Initial SessionFactory creation failed." + ex);
            throw new ExceptionInInitializerError(ex);
        }
    }

    public static SessionFactory getSessionFactory() {
        return sessionFactory;
    }

}
4.关联映射

4.1 单向Set-based的关联

public class Person {

    private Set events = new HashSet();

    public Set getEvents() {
        return events;
    }

    public void setEvents(Set events) {
        this.events = events;
    }
}

在映射这个关联之前，先考虑一下此关联的另外一端。很显然，我们可以保持这个关联是单向的。或者，我们可以在Event里创建另外一个集合，如果希望能够双向地导航，如：anEvent.getParticipants()。从功能的角度来说，这并不是必须的。因为你总可以显式地执行一个查询，以获得某个特定event的所有参与者。这是个在设计时需要做出的选择，完全由你来决定，但此讨论中关于关联的阶数是清楚的：即两端都是“多”值的，我们把它叫做多对多(many-to-many)关联。因而，我们使用Hibernate的多对多映射：

<class name="events.Person" table="PERSON">
    <id name="id" column="PERSON_ID">
        <generator class="native"/>
    </id>
    <property name="age"/>
    <property name="firstname"/>
    <property name="lastname"/>
    <set name="events" table="PERSON_EVENT">
        <key column="PERSON_ID"/>
        <many-to-many column="EVENT_ID" class="events.Event"/>
    </set>
</class>

Hibernate支持各种各样的集合映射，<set>使用的最为普遍。对于多对多关联（或叫n:m实体关系）, 需要一个关联表（association table）。表里面的每一行代表从person到event的一个关联。表名是由set元素的table属性配置的。关联里面的标识符字段名，对于person的一端，是由<key>元素定义，而event一端的字段名是由<many-to-many>元素的column属性定义。你也必须告诉Hibernate集合中对象的类（也就是位于这个集合所代表的关联另外一端的类）。

因而这个映射的数据库schema是：

    _____________        __________________
   |             |      |                  |       _____________
   |   EVENTS    |      |   PERSON_EVENT   |      |             |
   |_____________|      |__________________|      |    PERSON   |
   |             |      |                  |      |_____________|
   | *EVENT_ID   | <--> | *EVENT_ID        |      |             |
   |  EVENT_DATE |      | *PERSON_ID       | <--> | *PERSON_ID  |
   |  TITLE      |      |__________________|      |  AGE        |
   |_____________|                                |  FIRSTNAME  |
                                                  |  LASTNAME   |
                                                  |_____________|

4.2 双向关联

接下来我们将映射双向关联（bi-directional association）－在Java里让person和event可以从关联的任何一端访问另一端。当然，数据库schema没有改变，我们仍然需要多对多的阶数。一个关系型数据库要比网络编程语言更加灵活，所以它并不需要任何像导航方向（navigation direction）的东西－数据可以用任何可能的方式进行查看和获取。

首先，把一个参与者（person）的集合加入Event类中：

private Set participants = new HashSet();

public Set getParticipants() {
    return participants;
}

public void setParticipants(Set participants) {
    this.participants = participants;
}

在Event.hbm.xml里面也映射这个关联。

<set name="participants" table="PERSON_EVENT" inverse="true">
    <key column="EVENT_ID"/>
    <many-to-many column="PERSON_ID" class="events.Person"/>
</set>

如你所见，两个映射文件里都有普通的set映射。注意在两个映射文件中，互换了key和many-to-many的字段名。这里最重要的是Event映射文件里增加了set元素的inverse="true"属性。

这意味着在需要的时候，Hibernate能在关联的另一端－ Person类得到两个实体间关联的信息。这将会极大地帮助你理解双向关联是如何在两个实体间被创建的。

表 3.3. Hibernate配置属性

属性名	用途
`hibernate.dialect`	一个Hibernate `Dialect`类名允许Hibernate针对特定的关系数据库生成优化的SQL. 取值 `full.classname.of.Dialect`
`hibernate.show_sql`	输出所有SQL语句到控制台.有一个另外的选择是把`org.hibernate.SQL`这个log category设为`debug`。 eg. `true` \| `false`
`hibernate.format_sql`	在log和console中打印出更漂亮的SQL。取值 `true` \| `false`
`hibernate.default_schema`	在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上. 取值 `SCHEMA_NAME`
`hibernate.default_catalog`	在生成的SQL中, 将给定的catalog附加于非全限定名的表名上. 取值 `CATALOG_NAME`
`hibernate.session_factory_name`	`SessionFactory`创建后，将自动使用这个名字绑定到JNDI中. 取值 `jndi/composite/name`
`hibernate.max_fetch_depth`	为单向关联(一对一, 多对一)的外连接抓取（outer join fetch）树设置最大深度. 值为`0`意味着将关闭默认的外连接抓取. 取值建议在`0`到`3`之间取值
`hibernate.default_batch_fetch_size`	为Hibernate关联的批量抓取设置默认数量. 取值建议的取值为`4`, `8`, 和`16`
`hibernate.default_entity_mode`	为由这个`SessionFactory`打开的所有Session指定默认的实体表现模式. 取值 `dynamic-map`, `dom4j`, `pojo`
`hibernate.order_updates`	强制Hibernate按照被更新数据的主键，为SQL更新排序。这么做将减少在高并发系统中事务的死锁。取值 `true` \| `false`
`hibernate.generate_statistics`	如果开启, Hibernate将收集有助于性能调节的统计数据. 取值 `true` \| `false`
`hibernate.use_identifer_rollback`	如果开启, 在对象被删除时生成的标识属性将被重设为默认值. 取值 `true` \| `false`
`hibernate.use_sql_comments`	如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为`false`. 取值 `true` \| `false`

表 3.4. Hibernate JDBC和连接(connection)属性

属性名	用途
`hibernate.jdbc.fetch_size`	非零值，指定JDBC抓取数量的大小 (调用`Statement.setFetchSize()`).
`hibernate.jdbc.batch_size`	非零值，允许Hibernate使用JDBC2的批量更新. 取值建议取`5`到`30`之间的值
`hibernate.jdbc.batch_versioned_data`	如果你想让你的JDBC驱动从`executeBatch()`返回正确的行计数 , 那么将此属性设为`true`(开启这个选项通常是安全的). 同时，Hibernate将为自动版本化的数据使用批量DML. 默认值为`false`. eg. `true` \| `false`
`hibernate.jdbc.factory_class`	选择一个自定义的`Batcher`. 多数应用程序不需要这个配置属性. eg. `classname.of.Batcher`
`hibernate.jdbc.use_scrollable_resultset`	允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时，这个选项才是必要的, 否则Hibernate会使用连接的元数据. 取值 `true` \| `false`
`hibernate.jdbc.use_streams_for_binary`	在JDBC读写`binary (二进制)`或`serializable (可序列化)` 的类型时使用流(stream)(系统级属性). 取值 `true` \| `false`
`hibernate.jdbc.use_get_generated_keys`	在数据插入数据库之后，允许使用JDBC3 `PreparedStatement.getGeneratedKeys()` 来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标识生成器时遇到问题，请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力. 取值 `true\|false`
`hibernate.connection.provider_class`	自定义`ConnectionProvider`的类名, 此类用来向Hibernate提供JDBC连接. 取值 `classname.of.ConnectionProvider`
`hibernate.connection.isolation`	设置JDBC事务隔离级别. 查看`java.sql.Connection`来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别. 取值 `1, 2, 4, 8`
`hibernate.connection.autocommit`	允许被缓存的JDBC连接开启自动提交(autocommit) (不建议). 取值 `true` \| `false`
`hibernate.connection.release_mode`	指定Hibernate在何时释放JDBC连接. 默认情况下,直到Session被显式关闭或被断开连接时,才会释放JDBC连接. 对于应用程序服务器的JTA数据源, 你应当使用`after_statement`, 这样在每次JDBC调用后，都会主动的释放连接. 对于非JTA的连接, 使用`after_transaction`在每个事务结束时释放连接是合理的. `auto`将为JTA和CMT事务策略选择`after_statement`, 为JDBC事务策略选择`after_transaction`. 取值 `on_close` \| `after_transaction` \| `after_statement` \| `auto`
`hibernate.connection.<propertyName>`	将JDBC属性`propertyName`传递到`DriverManager.getConnection()`中去.
`hibernate.jndi.<propertyName>`	将属性`propertyName`传递到JNDI `InitialContextFactory`中去.

表 3.8. Hibernate SQL方言 (hibernate.dialect)

RDBMS	方言
DB2	`org.hibernate.dialect.DB2Dialect`
DB2 AS/400	`org.hibernate.dialect.DB2400Dialect`
DB2 OS390	`org.hibernate.dialect.DB2390Dialect`
PostgreSQL	`org.hibernate.dialect.PostgreSQLDialect`
MySQL	`org.hibernate.dialect.MySQLDialect`
MySQL with InnoDB	`org.hibernate.dialect.MySQLInnoDBDialect`
MySQL with MyISAM	`org.hibernate.dialect.MySQLMyISAMDialect`
Oracle (any version)	`org.hibernate.dialect.OracleDialect`
Oracle 9i/10g	`org.hibernate.dialect.Oracle9Dialect`
Sybase	`org.hibernate.dialect.SybaseDialect`
Sybase Anywhere	`org.hibernate.dialect.SybaseAnywhereDialect`
Microsoft SQL Server	`org.hibernate.dialect.SQLServerDialect`
SAP DB	`org.hibernate.dialect.SAPDBDialect`
Informix	`org.hibernate.dialect.InformixDialect`
HypersonicSQL	`org.hibernate.dialect.HSQLDialect`
Ingres	`org.hibernate.dialect.IngresDialect`
Progress	`org.hibernate.dialect.ProgressDialect`
Mckoi SQL	`org.hibernate.dialect.MckoiDialect`
Interbase	`org.hibernate.dialect.InterbaseDialect`
Pointbase	`org.hibernate.dialect.PointbaseDialect`
FrontBase	`org.hibernate.dialect.FrontbaseDialect`
Firebird	`org.hibernate.dialect.FirebirdDialect`