hibernate参数

梦里梦外; 2022-10-31 01:57 91阅读 0赞

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

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

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

**表 3.5.  Hibernate缓存属性**

<table>     
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.provider_class</span></td> 
   <td>自定义的<span style="font-family:新宋体">CacheProvider</span>的类名. 取值 <span style="font-family:新宋体">classname.of.CacheProvider</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.use_minimal_puts</span></td> 
   <td>以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的. 取值 <span style="font-family:新宋体">true|false</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.use_query_cache</span></td> 
   <td>允许查询缓存, 个别查询仍然需要被设置为可缓存的. 取值 <span style="font-family:新宋体">true|false</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.use_second_level_cache</span></td> 
   <td>能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定<span style="font-family:新宋体">&lt;cache&gt;</span>的类，会默认开启二级缓存. 取值 <span style="font-family:新宋体">true|false</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.query_cache_factory</span></td> 
   <td>自定义实现<span style="font-family:新宋体">QueryCache</span>接口的类名, 默认为内建的<span style="font-family:新宋体">StandardQueryCache</span>. 取值 <span style="font-family:新宋体">classname.of.QueryCache</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.region_prefix</span></td> 
   <td>二级缓存区域名的前缀. 取值 <span style="font-family:新宋体">prefix</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cache.use_structured_entries</span></td> 
   <td>强制Hibernate以更人性化的格式将数据存入二级缓存. 取值 <span style="font-family:新宋体">true|false</span></td> 
  </tr> 
 </tbody> 
</table>

**表 3.6.  Hibernate事务属性**

<table>     
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.transaction.factory_class</span></td> 
   <td>一个<span style="font-family:新宋体">TransactionFactory</span>的类名, 用于Hibernate <span style="font-family:新宋体">Transaction</span> API (默认为<span style="font-family:新宋体">JDBCTransactionFactory</span>). 取值 <span style="font-family:新宋体">classname.of.TransactionFactory</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">jta.UserTransaction</span></td> 
   <td>一个JNDI名字，被<span style="font-family:新宋体">JTATransactionFactory</span>用来从应用服务器获取JTA <span style="font-family:新宋体">UserTransaction</span>. 取值  <span style="font-family:新宋体">jndi/composite/name</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.transaction.manager_lookup_class</span></td> 
   <td>一个<span style="font-family:新宋体">TransactionManagerLookup</span>的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类. 取值 <span style="font-family:新宋体">classname.of.TransactionManagerLookup</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.transaction.flush_before_completion</span></td> 
   <td>如果开启, session在事务完成后将被自动清洗(flush)。 现在更好的方法是使用自动session上下文管理。取值  <span style="font-family:新宋体">true</span> | <span style="font-family:新宋体">false</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.transaction.auto_close_session</span></td> 
   <td>如果开启, session在事务完成后将被自动关闭。 现在更好的方法是使用自动session上下文管理。取值 <span style="font-family:新宋体">true</span> | <span style="font-family:新宋体">false</span></td> 
  </tr> 
 </tbody> 
</table>

**表 3.7.  其他属性**

<table>     
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.current_session_context_class</span></td> 
   <td>为"当前" <span style="font-family:新宋体">Session</span>指定一个(自定义的)策略。eg. <span style="font-family:新宋体">jta</span> | <span style="font-family:新宋体">thread</span> | <span style="font-family:新宋体">custom.Class</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.query.factory_class</span></td> 
   <td>选择HQL解析器的实现. 取值 <span style="font-family:新宋体">org.hibernate.hql.ast.ASTQueryTranslatorFactory</span> or <span style="font-family:新宋体">org.hibernate.hql.classic.ClassicQueryTranslatorFactory</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.query.substitutions</span></td> 
   <td>将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字). 取值 <span style="font-family:新宋体">hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.hbm2ddl.auto</span></td> 
   <td>在<span style="font-family:新宋体">SessionFactory</span>创建时，自动检查数据库结构，或者将数据库schema的DDL导出到数据库. 使用 <span style="font-family:新宋体">create-drop</span>时,在显式关闭<span style="font-family:新宋体">SessionFactory</span>时，将drop掉数据库schema. 取值 <span style="font-family:新宋体">validate</span> | <span style="font-family:新宋体">update</span> | <span style="font-family:新宋体">create</span> | <span style="font-family:新宋体">create-drop</span></td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">hibernate.cglib.use_reflection_optimizer</span></td> 
   <td>开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在<span style="font-family:新宋体">hibernate.cfg.xml</span>中设置此属性. 取值 <span style="font-family:新宋体">true</span> | <span style="font-family:新宋体">false</span></td> 
  </tr> 
 </tbody> 
</table>

### 3.4.1.  SQL方言 ###

你应当总是为你的数据库将hibernate.dialect属性设置成正确的 org.hibernate.dialect.Dialect子类. 如果你指定一种方言, Hibernate将为上面列出的一些属性使用合理的默认值, 为你省去了手工指定它们的功夫.

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

<table>     
 <thead> 
  <tr> 
   <th>RDBMS</th> 
   <th>方言</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>DB2</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.DB2Dialect</span></td> 
  </tr> 
  <tr> 
   <td>DB2 AS/400</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.DB2400Dialect</span></td> 
  </tr> 
  <tr> 
   <td>DB2 OS390</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.DB2390Dialect</span></td> 
  </tr> 
  <tr> 
   <td>PostgreSQL</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.PostgreSQLDialect</span></td> 
  </tr> 
  <tr> 
   <td>MySQL</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.MySQLDialect</span></td> 
  </tr> 
  <tr> 
   <td>MySQL with InnoDB</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.MySQLInnoDBDialect</span></td> 
  </tr> 
  <tr> 
   <td>MySQL with MyISAM</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.MySQLMyISAMDialect</span></td> 
  </tr> 
  <tr> 
   <td>Oracle (any version)</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.OracleDialect</span></td> 
  </tr> 
  <tr> 
   <td>Oracle 9i/10g</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.Oracle9Dialect</span></td> 
  </tr> 
  <tr> 
   <td>Sybase</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.SybaseDialect</span></td> 
  </tr> 
  <tr> 
   <td>Sybase Anywhere</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.SybaseAnywhereDialect</span></td> 
  </tr> 
  <tr> 
   <td>Microsoft SQL Server</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.SQLServerDialect</span></td> 
  </tr> 
  <tr> 
   <td>SAP DB</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.SAPDBDialect</span></td> 
  </tr> 
  <tr> 
   <td>Informix</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.InformixDialect</span></td> 
  </tr> 
  <tr> 
   <td>HypersonicSQL</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.HSQLDialect</span></td> 
  </tr> 
  <tr> 
   <td>Ingres</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.IngresDialect</span></td> 
  </tr> 
  <tr> 
   <td>Progress</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.ProgressDialect</span></td> 
  </tr> 
  <tr> 
   <td>Mckoi SQL</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.MckoiDialect</span></td> 
  </tr> 
  <tr> 
   <td>Interbase</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.InterbaseDialect</span></td> 
  </tr> 
  <tr> 
   <td>Pointbase</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.PointbaseDialect</span></td> 
  </tr> 
  <tr> 
   <td>FrontBase</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.FrontbaseDialect</span></td> 
  </tr> 
  <tr> 
   <td>Firebird</td> 
   <td><span style="font-family:新宋体">org.hibernate.dialect.FirebirdDialect</span></td> 
  </tr> 
 </tbody> 
</table>

**表 3.9.  Hibernate日志类别**

<table>     
 <thead> 
  <tr> 
   <th>类别</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.SQL</span></td> 
   <td>在所有SQL DML语句被执行时为它们记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.type</span></td> 
   <td>为所有JDBC参数记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.tool.hbm2ddl</span></td> 
   <td>在所有SQL DDL语句执行时为它们记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.pretty</span></td> 
   <td>在session清洗(flush)时，为所有与其关联的实体(最多20个)的状态记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.cache</span></td> 
   <td>为所有二级缓存的活动记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction</span></td> 
   <td>为事务相关的活动记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.jdbc</span></td> 
   <td>为所有JDBC资源的获取记录日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.hql.AST</span></td> 
   <td>在解析查询的时候,记录HQL和SQL的AST分析日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.secure</span></td> 
   <td>为JAAS认证请求做日志</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate</span></td> 
   <td>为任何Hibernate相关信息做日志 (信息量较大, 但对查错非常有帮助)</td> 
  </tr> 
 </tbody> 
</table>

**表 3.10. JTA TransactionManagers**

<table>     
 <thead> 
  <tr> 
   <th>Transaction工厂类</th> 
   <th align="center">应用程序服务器</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.JBossTransactionManagerLookup</span></td> 
   <td align="center">JBoss</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.WeblogicTransactionManagerLookup</span></td> 
   <td align="center">Weblogic</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.WebSphereTransactionManagerLookup</span></td> 
   <td align="center">WebSphere</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.WebSphereExtendedJTATransactionLookup</span></td> 
   <td align="center">WebSphere 6</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.OrionTransactionManagerLookup</span></td> 
   <td align="center">Orion</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.ResinTransactionManagerLookup</span></td> 
   <td align="center">Resin</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.JOTMTransactionManagerLookup</span></td> 
   <td align="center">JOTM</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.JOnASTransactionManagerLookup</span></td> 
   <td align="center">JOnAS</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.JRun4TransactionManagerLookup</span></td> 
   <td align="center">JRun4</td> 
  </tr> 
  <tr> 
   <td><span style="font-family:新宋体">org.hibernate.transaction.BESTransactionManagerLookup</span></td> 
   <td align="center">Borland ES</td> 
  </tr> 
 </tbody> 
</table>

posted on 2008-04-22 18:28 [ 芦苇][Link 1] 阅读(19939) [ 评论(1)][_1]   [编辑][Link 2]   [收藏][Link 3] 所属分类: [ Hibernate][Hibernate]

![hibernate参数 - 淡紫色呼吸 - 烟雨阁][hibernate_ - _ -]

### Feedback ###

[\#][Link 4]  re: Hibernate 参数设置一览表  2008-10-14 18:13 [芦苇][Link 1]

### SQL方言 ###

**1、Hibernate JDBC属性**

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hibernate.connection.driver_class</td> 
   <td><em><em>jdbc驱动类</em> </em></td> 
  </tr> 
  <tr> 
   <td>hibernate.connection.url</td> 
   <td><em>jdbc URL</em> </td> 
  </tr> 
  <tr> 
   <td>hibernate.connection.username</td> 
   <td><em>数据库用户</em> </td> 
  </tr> 
  <tr> 
   <td>hibernate.connection.password</td> 
   <td><em>数据库用户密码</em> </td> 
  </tr> 
  <tr> 
   <td>hibernate.connection.pool_size</td> 
   <td><em>连接池容量上限数目</em> </td> 
  </tr> 
 </tbody> 
</table>

注：使用C3P0的properties样例代码：

hibernate.connection.driver\_class = org.postgresql.Driver  
hibernate.connection.url = jdbc:postgresql://localhost/mydatabase  
hibernate.connection.username = myuser  
hibernate.connection.password = secret  
hibernate.c3p0.min\_size=5  
hibernate.c3p0.max\_size=20  
hibernate.c3p0.timeout=1800  
hibernate.c3p0.max\_statements=50  
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect

**2、Hibernate的数据源属性**

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hibernate.connection.datasource</td> 
   <td><em>数据源JNDI名字</em></td> 
  </tr> 
  <tr> 
   <td>hibernate.jndi.url</td> 
   <td><em>JNDI提供者的URL</em> (可选)</td> 
  </tr> 
  <tr> 
   <td>hibernate.jndi.class</td> 
   <td><em>JNDI InitialContextFactory类</em> (可选)</td> 
  </tr> 
  <tr> 
   <td>hibernate.connection.username</td> 
   <td><em>数据库用户</em> (可选)</td> 
  </tr> 
  <tr> 
   <td>hibernate.connection.password</td> 
   <td><em>数据库用户密码</em> (可选)</td> 
  </tr> 
 </tbody> 
</table>

注：应用程序服务器JNDI数据源的 hibernate.properties样例代码：

hibernate.connection.datasource = java:/comp/env/jdbc/test  
hibernate.transaction.factory\_class = \\  
    org.hibernate.transaction.JTATransactionFactory  
hibernate.transaction.manager\_lookup\_class = \\  
    org.hibernate.transaction.JBossTransactionManagerLookup  
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect

3、 **Hibernate配置属性（可选）**

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

4、 **Hibernate JDBC和连接(connection)属性**

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

**5、Hibernate缓存属性**

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hibernate.cache.provider_class</td> 
   <td>自定义的CacheProvider的类名. <p>取值classname.of.CacheProvider</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cache.use_minimal_puts</td> 
   <td>以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的. <p>取值true|false</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cache.use_query_cache</td> 
   <td>允许查询缓存, 个别查询仍然需要被设置为可缓存的. <p>取值true|false</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cache.use_second_level_cache</td> 
   <td>能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定&lt;cache&gt;的类，会默认开启二级缓存. <p>取值true|false</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cache.query_cache_factory</td> 
   <td>自定义的实现QueryCache接口的类名, 默认为内建的StandardQueryCache. <p>取值classname.of.QueryCache</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cache.region_prefix</td> 
   <td>二级缓存区域名的前缀. <p>取值prefix</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cache.use_structured_entries</td> 
   <td>强制Hibernate以更人性化的格式将数据存入二级缓存. <p>取值true|false</p> </td> 
  </tr> 
 </tbody> 
</table>

6、 **Hibernate事务属性**

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hibernate.transaction.factory_class</td> 
   <td>一个TransactionFactory的类名, 用于Hibernate Transaction API (默认为JDBCTransactionFactory). <p>取值classname.of.TransactionFactory</p> </td> 
  </tr> 
  <tr> 
   <td>jta.UserTransaction</td> 
   <td>一个JNDI名字，被JTATransactionFactory用来从应用服务器获取JTA UserTransaction. <p>取值jndi/composite/name</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.transaction.manager_lookup_class</td> 
   <td>一个TransactionManagerLookup的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类. <p>取值classname.of.TransactionManagerLookup</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.transaction.flush_before_completion</td> 
   <td>如果开启, session在事务完成后将被自动清洗(flush). (在Hibernate和CMT一起使用时很有用.) <p>取值true | false</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.transaction.auto_close_session</td> 
   <td>如果开启, session在事务完成前将被自动关闭. (在Hibernate和CMT一起使用时很有用.) <p>取值true | false</p> </td> 
  </tr> 
 </tbody> 
</table>

7、 **其他属性**

<table> 
 <thead> 
  <tr> 
   <th>属性名</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>hibernate.query.factory_class</td> 
   <td>选择HQL解析器的实现. <p>取值org.hibernate.hql.ast.ASTQueryTranslatorFactory or  org.hibernate.hql.classic.ClassicQueryTranslatorFactory</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.query.substitutions</td> 
   <td>将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字). <p>取值hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.hbm2ddl.auto</td> 
   <td>在SessionFactory创建时，自动将数据库schema的DDL导出到数据库. 使用 create-drop时,在显式关闭SessionFactory时，将drop掉数据库schema. <p>取值update | create | create-drop</p> </td> 
  </tr> 
  <tr> 
   <td>hibernate.cglib.use_reflection_optimizer</td> 
   <td>开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性. <p>取值true | false</p> </td> 
  </tr> 
 </tbody> 
</table>

8、 **SQL方言  
   Hibernate SQL方言 (hibernate.dialect)**

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

9、 **Hibernate日志类别**

<table> 
 <thead> 
  <tr> 
   <th>类别</th> 
   <th>功能</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>org.hibernate.SQL</td> 
   <td>在所有SQL DML语句被执行时为它们记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.type</td> 
   <td>为所有JDBC参数记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.tool.hbm2ddl</td> 
   <td>在所有SQL DDL语句执行时为它们记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.pretty</td> 
   <td>在session清洗(flush)时，为所有与其关联的实体(最多20个)的状态记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.cache</td> 
   <td>为所有二级缓存的活动记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.transaction</td> 
   <td>为事务相关的活动记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.jdbc</td> 
   <td>为所有JDBC资源的获取记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.hql.ast</td> 
   <td>为HQL和SQL的自动状态转换和其他关于查询解析的信息记录日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate.secure</td> 
   <td>为JAAS认证请求做日志</td> 
  </tr> 
  <tr> 
   <td>org.hibernate</td> 
   <td>为任何Hibernate相关信息做日志 (信息量较大, 但对查错非常有帮助</td> 
  </tr> 
 </tbody> 
</table>

[Link 1]: http://www.blogjava.net/i369/
[_1]: http://www.blogjava.net/i369/articles/194855.html#Post
[Link 2]: http://www.blogjava.net/i369/admin/EditArticles.aspx?postid=194855
[Link 3]: http://www.blogjava.net/i369/AddToFavorite.aspx?id=194855
[Hibernate]: http://www.blogjava.net/i369/category/18312.html
[hibernate_ - _ -]: /images/20221024/296dcb2aa61c4b39b7a40241bb345060.png
[Link 4]: http://www.blogjava.net/i369/articles/194855.html#234281