hibernate2 参考文档之三.txt

Hibernate使用说明书

 
hibernate.show_sql 把所有的SQL语句都输出到控制台(可以作为log功能的一个替代)
取值. true | false 
 
hibernate.hbm2ddl.auto 自动输出schema创建DDL语句.
取值. update | create | create-drop 
 

3.5.1. SQL Dialects SQL 方言
你总是可以为你的数据库设置一个hibernate.dialect方言，它是net.sf.hibernate.dialect.Dialect 的一个子类。如果你不需要使用基于native或者sequence的主键自动生成算法，或者悲观锁定（使用Session.lock() 或 Query.setLockMode())的话，方言就可以不必指定。然而，假若你指定了一个方言，Hibernate会为上面列出的一些属性使用特殊默认值，省得你手工指定它们。 

Table 3.4. Hibernate SQL 方言 (hibernate.dialect)

RDBMS 方言 
DB2 net.sf.hibernate.dialect.DB2Dialect 
MySQL net.sf.hibernate.dialect.MySQLDialect 
SAP DB net.sf.hibernate.dialect.SAPDBDialect 
Oracle (所有版本) net.sf.hibernate.dialect.OracleDialect 
Oracle 9 net.sf.hibernate.dialect.Oracle9Dialect 
Sybase net.sf.hibernate.dialect.SybaseDialect 
Sybase Anywhere net.sf.hibernate.dialect.SybaseAnywhereDialect 
Progress net.sf.hibernate.dialect.ProgressDialect 
Mckoi SQL net.sf.hibernate.dialect.MckoiDialect 
Interbase net.sf.hibernate.dialect.InterbaseDialect 
Pointbase net.sf.hibernate.dialect.PointbaseDialect 
PostgreSQL net.sf.hibernate.dialect.PostgreSQLDialect 
HypersonicSQL net.sf.hibernate.dialect.HSQLDialect 
Microsoft SQL Server net.sf.hibernate.dialect.SybaseDialect 
Ingres net.sf.hibernate.dialect.IngresDialect 
Informix net.sf.hibernate.dialect.InformixDialect 
FrontBase net.sf.hibernate.dialect.FrontbaseDialect 

3.5.2. 外连接抓取（Outer Join Fetching ）
如果你的数据库支持ANSI或者Oracle风格的外连接，外连接抓取可能提高性能，因为可以限制和数据库交互的数量（代价是数据库自身进行了更多的工作）。外连接抓取允许你在一个select语句中就可以得到一个由多对一或者一对一连接构成的对象图。 

默认情况下，抓取在叶对象，拥有代理的对象或者产生对自身的引用时终止。对一个特定关联来说，通过在XML映射文件中设置outer-join属性可以控制是否开启抓取功能。也可以设置hibernate.use_outer_join为false来全局关闭此功能。 你也可以通过hibernate.max_fetch_depth来设置抓取得对象图的最大深度。 

3.5.3. 二进制流
Oracle限制通过它的JDBC驱动传递的byte数组的大小。如果你希望使用很大数量的binary或者serializable 类型的话，你需要打开hibernate.jdbc.use_streams_for_binary。这只能通过JVM级别设定 

3.5.4. 在控制台记录SQL
hibernate.show_sql强制Hibernate把每一句SQL语句都写到控制台。这是作为打开log的一个简易替代。 

3.5.5. 自定义 ConnectionProvider
你可以自定义你的获取JDBC连接的策略，只需要实现net.sf.hibernate.connection.ConnectionProvider接口。在hibernate.connection.provider_class设置你自己的实现的类名。 

3.5.6. 常用数据库属性
几个配置属性影响除了DatasourceConnectionProvider之外的所有内置连接提供者.它们是： hibernate.connection.driver_class, hibernate.connection.url, hibernate.connection.username and hibernate.connection.password. 

hibernate.connection.isolation应该指定为一个整数值。(查阅java.sql.Connection可以得到值的含义，但注意大多数数据库不会支持所有的隔离级别。) 

专用的连接属性可以通过在"hibernate.connnection"后面加上属性名来指定。比如，你可以通过hibernate.connnection.charSet指定一个charSet。 

3.5.7. 自定义CacheProvider
通过实现net.sf.hibernate.cache.CacheProvider接口，你可以整合一个JVM级别（或者集群的）缓存进来。你可以通过hibernate.cache.provider_class选择某个子定义的实现。 

3.5.8. 事务策略
如果你希望使用Hibernate的Transaction API,你必须通过hibernate.transaction.factory_class属性指定一个Transaction实例的工厂类。 内置的两个标准选择是： 

net.sf.hibernate.transaction.JDBCTransactionFactory
使用数据库(JDBC)事务

net.sf.hibernate.transaction.JTATransactionFactory
使用JTA(假若已经存在一个事务，Session会在这个上下文中工作，否则会启动一个新的事务。）


你也可以自行定义你的事务策略（比如说，一个CORBA事务服务）。 

如果你希望在JTA环境中为可变数据使用JVM级别的缓存，你必须指定一个获取JTA TransactionManager的策略。 

Table 3.5. JTA TransactionManagers

事务工厂类 Application Server 
net.sf.hibernate.transaction.JBossTransactionManagerLookup JBoss 
net.sf.hibernate.transaction.WeblogicTransactionManagerLookup Weblogic 
net.sf.hibernate.transaction.WebSphereTransactionManagerLookup WebSphere 
net.sf.hibernate.transaction.OrionTransactionManagerLookup Orion 
net.sf.hibernate.transaction.ResinTransactionManagerLookup Resin 
net.sf.hibernate.transaction.JOTMTransactionManagerLookup JOTM 
net.sf.hibernate.transaction.JOnASTransactionManagerLookup JOnAS 
net.sf.hibernate.transaction.JRun4TransactionManagerLookup JRun4 

3.5.9. 绑定SessionFactory到JNDI
假若你希望把SessionFactory绑定到一个JNDI命名空间，用hibernate.session_factory_name这个属性指定一个名字（比如，java:comp/env/hibernate/SessionFactory）。如果这个属性省略了，SessionFactory不会被绑定到JNDI。（在一个只读的JNDI默认值实现的环境中，这特别有用。比如，Tomcat。) 

当把SessionFactory 绑定到JNDI,Hibernate会使用hibernate.jndi.url,hibernate.jndi.class的值来获得一个初始化上下文的实例。如果他们没有指定，就会使用默认的InitialContext。 

如果你选择使用JNDI,EJB或者其他工具类就可以通过JNDI查询得到SessionFactory。 

3.5.10. 查询语言替换 
你可以使用hibernate.query.substitutions定义新的Hibernate查询短语。比如说： 

hibernate.query.substitutions true=1, false=0
会在生成的SQL中把短语true和 false替换成整数值。 

hibernate.query.substitutions toLowercase=LOWER
这可以让你重新命名SQL的LOWER函数。 

3.6. XML配置文件
另一种配置属性的方法是把所有的配置都放在一个名为hibernate.cfg.xml的文件中。这个文件应该放在你的CLASSPATH的根目录中。 

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 2.0//EN"

 "http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">

<hibernate-configuration>

    <!-- a SessionFactory instance listed as /jndi/name -->
    <session-factory 
        name="java:comp/env/hibernate/SessionFactory">

        <!-- properties -->
        <property name="connection.datasource">my/first/datasource</property>
        <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
        <property name="show_sql">false</property>
        <property name="use_outer_join">true</property>
        <property name="transaction.factory_class">net.sf.hibernate.transaction.JTATransactionFactory</property>
        <property name="jta.UserTransaction">java:comp/UserTransaction</property>

        <!-- mapping files -->
        <mapping resource="eg/Edge.hbm.xml"/>
        <mapping resource="eg/Vertex.hbm.xml"/>

    </session-factory>

</hibernate-configuration>
配置Hibernate只需如此简单： 

SessionFactory sf = new Configuration().configure().buildSessionFactory();
你可以使用另外一个名字的配置文件： 

SessionFactory sf = new Configuration()
    .configure("catdb.cfg.xml")
    .buildSessionFactory();
3.7. Logging
通过Apache commons-logging，Hibernate记录很多事件。commons-logging服务会直接输出到Apache log4j(如果你把log4j.jar放在你的classpath里),或者JDK1.4 logging（如果你运行JDK 1.4或以上版本）。你可以从http://jakarta.apache.org下载log4j。要使用log4j,你需要在你的classpath中放置一个log4j.properties文件。Hibernate发行包中包含一个示例的properties配置文件。 

我们强烈建议你熟悉Hibernate的log信息。Hibernate的很多工作都会尽量详细的留下log,也没有让它变的难以阅读。这是用来解决问题的最基本的设施。 

3.8. NamingStrategy（命名策略)
net.sf.hibernate.cfg.NamingStrategy接口允许你对数据库对象指定“命名标准”。你可以定义从Java标识符自动生成数据库标识符的规则，或者是映射文件中给出的“逻辑”字段名和表名处理为“物理”表名和字段名的规则。这个功能可以让映射文件变得简洁，消除无用的噪音（比如TBL_前缀等）。Hibernate使用的默认策略是几乎什么都不错。你可以在增加映射(add mappings)之前调用Configuration.setNamingStrategy()来指定不同的策略。 

SessionFactory sf = new Configuration()
    .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)
    .addFile("Vertex.hbm.xml")
    .addFile("Edge.hbm.xml")
    .buildSessionFactory();
net.sf.hibernate.cfg.ImprovedNamingStrategy 是一个内置的策略，对某些程序，你可以把它作为改造的起点。 


--------------------------------------------------------------------------------
Prev  Up  Next 
Chapter 2. 体系结构  Home  Chapter 4. 持久化类(Persistent Classes)