hibernate-3.2.5.ga的hibernate.properties

######################
### Query Language ###
######################

## define query language constants / function names
##将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字).取值hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC
##Y代替yes，用N代替no
hibernate.query.substitutions yes 'Y', no 'N'

## select the classic query parser
##可以替换查询工厂
##选择HQL解析器的实现.取值org.hibernate.hql.ast.ASTQueryTranslatorFactory or org.hibernate.hql.classic.ClassicQueryTranslatorFactory
#hibernate.query.factory_class org.hibernate.hql.classic.ClassicQueryTranslatorFactory

 

#################
### Platforms ###
#################
##hibernate.connection.<propertyName>是将JDBC属性propertyName传递到DriverManager.getConnection()中去.

## JNDI Datasource
##在应用服务器中提供数据源的情况下，可以用到如下参数。让数据源管理连接而Hibernate不管理连接了。
#hibernate.connection.datasource jdbc/test
#hibernate.connection.username db2
#hibernate.connection.password db2

##下面为各种数据库连接的配置
## HypersonicSQL

hibernate.dialect org.hibernate.dialect.HSQLDialect##一个Hibernate Dialect类名允许Hibernate针对特定的关系数据库生成优化的SQL.取值full.classname.of.Dialect
hibernate.connection.driver_class org.hsqldb.jdbcDriver
hibernate.connection.username sa
hibernate.connection.password
hibernate.connection.url jdbc:hsqldb:./build/db/hsqldb/hibernate
#hibernate.connection.url jdbc:hsqldb:hsql://localhost
#hibernate.connection.url jdbc:hsqldb:test

## H2 (www.h2database.com)
#hibernate.dialect org.hibernate.dialect.H2Dialect
#hibernate.connection.driver_class org.h2.Driver
#hibernate.connection.username sa
#hibernate.connection.password
#hibernate.connection.url jdbc:h2:mem:./build/db/h2/hibernate
#hibernate.connection.url jdbc:h2:testdb/h2test
#hibernate.connection.url jdbc:h2:mem:imdb1
#hibernate.connection.url jdbc:h2:tcp://dbserv:8084/sample;  
#hibernate.connection.url jdbc:h2:ssl://secureserv:8085/sample;  
#hibernate.connection.url jdbc:h2:ssl://secureserv/testdb;cipher=AES

## MySQL

#hibernate.dialect org.hibernate.dialect.MySQLDialect
#hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect
#hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect
#hibernate.connection.driver_class com.mysql.jdbc.Driver
#hibernate.connection.url jdbc:mysql:///test
#hibernate.connection.username gavin
#hibernate.connection.password

## Oracle

#hibernate.dialect org.hibernate.dialect.OracleDialect
#hibernate.dialect org.hibernate.dialect.Oracle9Dialect
#hibernate.connection.driver_class oracle.jdbc.driver.OracleDriver
#hibernate.connection.username ora
#hibernate.connection.password ora
#hibernate.connection.url jdbc:oracle:thin:@localhost:1521:orcl
#hibernate.connection.url jdbc:oracle:thin:@localhost:1522:XE

## PostgreSQL

#hibernate.dialect org.hibernate.dialect.PostgreSQLDialect
#hibernate.connection.driver_class org.postgresql.Driver
#hibernate.connection.url jdbc:postgresql:template1
#hibernate.connection.username pg
#hibernate.connection.password

## DB2

#hibernate.dialect org.hibernate.dialect.DB2Dialect
#hibernate.connection.driver_class com.ibm.db2.jcc.DB2Driver
#hibernate.connection.driver_class COM.ibm.db2.jdbc.app.DB2Driver
#hibernate.connection.url jdbc:db2://localhost:50000/somename
#hibernate.connection.url jdbc:db2:somename
#hibernate.connection.username db2
#hibernate.connection.password db2

## TimesTen

#hibernate.dialect org.hibernate.dialect.TimesTenDialect
#hibernate.connection.driver_class com.timesten.jdbc.TimesTenDriver
#hibernate.connection.url jdbc:timesten:direct:test
#hibernate.connection.username
#hibernate.connection.password

## DB2/400

#hibernate.dialect org.hibernate.dialect.DB2400Dialect
#hibernate.connection.username user
#hibernate.connection.password password

## Native driver
#hibernate.connection.driver_class COM.ibm.db2.jdbc.app.DB2Driver
#hibernate.connection.url jdbc:db2://systemname

## Toolbox driver
#hibernate.connection.driver_class com.ibm.as400.access.AS400JDBCDriver
#hibernate.connection.url jdbc:as400://systemname

## Derby (not supported!)

#hibernate.dialect org.hibernate.dialect.DerbyDialect
#hibernate.connection.driver_class org.apache.derby.jdbc.EmbeddedDriver
#hibernate.connection.username
#hibernate.connection.password
#hibernate.connection.url jdbc:derby:build/db/derby/hibernate;create=true

## Sybase

#hibernate.dialect org.hibernate.dialect.SybaseDialect
#hibernate.connection.driver_class com.sybase.jdbc2.jdbc.SybDriver
#hibernate.connection.username sa
#hibernate.connection.password sasasa
#hibernate.connection.url jdbc:sybase:Tds:co3061835-a:5000/tempdb

## Mckoi SQL

#hibernate.dialect org.hibernate.dialect.MckoiDialect
#hibernate.connection.driver_class com.mckoi.JDBCDriver
#hibernate.connection.url jdbc:mckoi:///
#hibernate.connection.url jdbc:mckoi:local://C:/mckoi1.0.3/db.conf
#hibernate.connection.username admin
#hibernate.connection.password nimda

## SAP DB

#hibernate.dialect org.hibernate.dialect.SAPDBDialect
#hibernate.connection.driver_class com.sap.dbtech.jdbc.DriverSapDB
#hibernate.connection.url jdbc:sapdb://localhost/TST
#hibernate.connection.username TEST
#hibernate.connection.password TEST
#hibernate.query.substitutions yes 'Y', no 'N'

## MS SQL Server

#hibernate.dialect org.hibernate.dialect.SQLServerDialect
#hibernate.connection.username sa
#hibernate.connection.password sa

## JSQL Driver
#hibernate.connection.driver_class com.jnetdirect.jsql.JSQLDriver
#hibernate.connection.url jdbc:JSQLConnect://1E1/test

## JTURBO Driver
#hibernate.connection.driver_class com.newatlanta.jturbo.driver.Driver
#hibernate.connection.url jdbc:JTurbo://1E1:1433/test

## WebLogic Driver
#hibernate.connection.driver_class weblogic.jdbc.mssqlserver4.Driver
#hibernate.connection.url jdbc:weblogic:mssqlserver4:1E1:1433

## Microsoft Driver (not recommended!)
#hibernate.connection.driver_class com.microsoft.jdbc.sqlserver.SQLServerDriver
#hibernate.connection.url jdbc:microsoft:sqlserver://1E1;DatabaseName=test;SelectMethod=cursor

## The New Microsoft Driver
#hibernate.connection.driver_class com.microsoft.sqlserver.jdbc.SQLServerDriver
#hibernate.connection.url jdbc:sqlserver://localhost

## jTDS (since version 0.9)
#hibernate.connection.driver_class net.sourceforge.jtds.jdbc.Driver
#hibernate.connection.url jdbc:jtds:sqlserver://1E1/test

## Interbase

#hibernate.dialect org.hibernate.dialect.InterbaseDialect
#hibernate.connection.username sysdba
#hibernate.connection.password masterkey

## DO NOT specify hibernate.connection.sqlDialect

## InterClient

#hibernate.connection.driver_class interbase.interclient.Driver
#hibernate.connection.url jdbc:interbase://localhost:3060/C:/firebird/test.gdb

## Pure Java

#hibernate.connection.driver_class org.firebirdsql.jdbc.FBDriver
#hibernate.connection.url jdbc:firebirdsql:localhost/3050:/firebird/test.gdb

## Pointbase

#hibernate.dialect org.hibernate.dialect.PointbaseDialect
#hibernate.connection.driver_class com.pointbase.jdbc.jdbcUniversalDriver
#hibernate.connection.url jdbc:pointbase:embedded:sample
#hibernate.connection.username PBPUBLIC
#hibernate.connection.password PBPUBLIC

## Ingres

## older versions (before Ingress 2006)

#hibernate.dialect org.hibernate.dialect.IngresDialect
#hibernate.connection.driver_class ca.edbc.jdbc.EdbcDriver
#hibernate.connection.url jdbc:edbc://localhost:II7/database
#hibernate.connection.username user
#hibernate.connection.password password

## Ingres 2006 or later

#hibernate.dialect org.hibernate.dialect.IngresDialect
#hibernate.connection.driver_class com.ingres.jdbc.IngresDriver
#hibernate.connection.url jdbc:ingres://localhost:II7/database;CURSOR=READONLY;auto=multi
#hibernate.connection.username user
#hibernate.connection.password password

## Mimer SQL

#hibernate.dialect org.hibernate.dialect.MimerSQLDialect
#hibernate.connection.driver_class com.mimer.jdbc.Driver
#hibernate.connection.url jdbc:mimer:multi1
#hibernate.connection.username hibernate
#hibernate.connection.password hibernate

## InterSystems Cache

#hibernate.dialect org.hibernate.dialect.Cache71Dialect
#hibernate.connection.driver_class com.intersys.jdbc.CacheDriver
#hibernate.connection.username _SYSTEM
#hibernate.connection.password SYS
#hibernate.connection.url jdbc:Cache://127.0.0.1:1972/HIBERNATE

#################################
### Hibernate Connection Pool ###
#################################
##各种数据池的配置

##Hibernate内置连接池的配置，用来配置连接数。由于Hibernate内置连接池的缺陷一般不只用而用第三方的连接池
hibernate.connection.pool_size 1

 

###########################
### C3P0 Connection Pool###
###########################

#hibernate.c3p0.max_size 2##连接池最大连接数（必须）
#hibernate.c3p0.min_size 2##连接池最小连接数（必须）
#hibernate.c3p0.timeout 5000##连接超时时长
#hibernate.c3p0.max_statements 100##最大缓存多少个Statement对象
#hibernate.c3p0.idle_test_period 3000##检测时间间隔
#hibernate.c3p0.acquire_increment 2##增长步长
#hibernate.c3p0.validate false##每次连接前验证连接是否可用使用c3p0连接池

 

##############################
### Proxool Connection Pool###
##############################

## Properties for external configuration of Proxool

hibernate.proxool.pool_alias pool1

## Only need one of the following

#hibernate.proxool.existing_pool true
#hibernate.proxool.xml proxool.xml##需要自己的配置文件
#hibernate.proxool.properties proxool.properties

 

#################################
### Plugin ConnectionProvider ###
#################################
##当Hibernate不提供的数据源时可以用下面配置方法，如dbcp在Hibernate3中取消了但想用dbcp
## use a custom ConnectionProvider (if not set, Hibernate will choose a built-in ConnectionProvider using hueristics)
##自定义ConnectionProvider的类名, 此类用来向Hibernate提供JDBC连接.取值classname.of.ConnectionProvider
##连接提供者接口，我们只要实现这个接口,指定我们实现的类
#hibernate.connection.provider_class org.hibernate.connection.DriverManagerConnectionProvider
#hibernate.connection.provider_class org.hibernate.connection.DatasourceConnectionProvider
#hibernate.connection.provider_class org.hibernate.connection.C3P0ConnectionProvider
#hibernate.connection.provider_class org.hibernate.connection.ProxoolConnectionProvider

 

#######################
### Transaction API ###
#######################

## Enable automatic flush during the JTA beforeCompletion() callback
## (This setting is relevant with or without the Transaction API)
##如果开启, session在事务完成后将被自动清洗(flush). (在Hibernate和CMT一起使用时很有用.)取值true | false
#hibernate.transaction.flush_before_completion

## Enable automatic session close at the end of transaction
## (This setting is relevant with or without the Transaction API)
##如果开启, session在事务完成前将被自动关闭. (在Hibernate和CMT一起使用时很有用.)取值true | false
#hibernate.transaction.auto_close_session

## the Transaction API abstracts application code from the underlying JTA or JDBC transactions
##事务工厂
##一个TransactionFactory的类名, 用于Hibernate Transaction API (默认为JDBCTransactionFactory).取值classname.of.TransactionFactory
#hibernate.transaction.factory_class org.hibernate.transaction.JTATransactionFactory
#hibernate.transaction.factory_class org.hibernate.transaction.JDBCTransactionFactory##默认值

## to use JTATransactionFactory, Hibernate must be able to locate the UserTransaction in JNDI
## default is java:comp/UserTransaction
## you do NOT need this setting if you specify hibernate.transaction.manager_lookup_class
##当使用分布式JTA事务工厂必须配置的参数JNDI名
##一个JNDI名字，被JTATransactionFactory用来从应用服务器获取JTA UserTransaction.取值jndi/composite/name
#jta.UserTransaction jta/usertransaction
#jta.UserTransaction javax.transaction.UserTransaction
#jta.UserTransaction UserTransaction

## to use the second-level cache with JTA, Hibernate must be able to obtain the JTA TransactionManager
##一个TransactionManagerLookup的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类.取值classname.of.TransactionManagerLookup
#hibernate.transaction.manager_lookup_class org.hibernate.transaction.JBossTransactionManagerLookup
#hibernate.transaction.manager_lookup_class org.hibernate.transaction.WeblogicTransactionManagerLookup
#hibernate.transaction.manager_lookup_class org.hibernate.transaction.WebSphereTransactionManagerLookup
#hibernate.transaction.manager_lookup_class org.hibernate.transaction.OrionTransactionManagerLookup
#hibernate.transaction.manager_lookup_class org.hibernate.transaction.ResinTransactionManagerLookup

 

##############################
### Miscellaneous Settings ###
##############################

## print all generated SQL to the console
##输出所有SQL语句到控制台.取值true | false
#hibernate.show_sql true

## format SQL in log and console
##在log和console中打印出更漂亮的sql.取值true | false
hibernate.format_sql true

## add comments to the generated SQL
##如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false.取值true | false
#hibernate.use_sql_comments true

## generate statistics
##如果开启, Hibernate将收集有助于性能调节的统计数据.取值true | false
#hibernate.generate_statistics true

## auto schema export
##在SessionFactory创建时，自动将数据库schema的DDL导出到数据库. 使用 create-drop时,在显式关闭SessionFactory时，将drop掉数据库schema.取值update | create | create-drop
#hibernate.hbm2ddl.auto create-drop
#hibernate.hbm2ddl.auto create
#hibernate.hbm2ddl.auto update
#hibernate.hbm2ddl.auto validate

## specify a default schema and catalog for unqualified tablenames
#hibernate.default_schema test##在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上.取值SCHEMA_NAME
#hibernate.default_catalog test##在生成的SQL中, 将给定的catalog附加于没全限定名的表名上.取值CATALOG_NAME

## enable ordering of SQL UPDATEs by primary key
##强制Hibernate按照被更新数据的主键，为SQL更新排序。这么做将减少在高并发系统中事务的死锁。取值true | false
#hibernate.order_updates true

## set the maximum depth of the outer join fetch tree
##为单向关联(一对一, 多对一)的外连接抓取（outer join fetch）树设置最大深度. 值为0意味着将关闭默认的外连接抓取.取值 建议在0到3之间取值
hibernate.max_fetch_depth 1

## set the default batch size for batch fetching
##为Hibernate关联的批量抓取设置默认数量.取值 建议的取值为4, 8, 和16
#hibernate.default_batch_fetch_size 8

## rollback generated identifier values of deleted entities to default values
##如果开启, 在对象被删除时生成的标识属性将被重设为默认值.取值true | false。在删除一个对象时，id值回滚，例如int变成0，字符串变成空值。（原来删除一个对象，但id值还是在的）
#hibernate.use_identifer_rollback true

## enable bytecode reflection optimizer (disabled by default)
##开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性.取值true | false
##用字节码的增长对反射的优化。例如用cglib.jar动态修改字节码来替换掉java中的动态代理起到优化作用
#hibernate.bytecode.use_reflection_optimizer true

 

#####################
### JDBC Settings ###
#####################

## specify a JDBC isolation level
##设置JDBC事务隔离级别. 查看java.sql.Connection来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别.取值1, 2, 4, 8
##数据库的事务的隔离级别。与数据库有关！一般不需要配置，因为每个数据库的隔离级别不一样
#hibernate.connection.isolation 4

## enable JDBC autocommit (not recommended!)
##允许被缓存的JDBC连接开启自动提交(autocommit) (不建议).取值true | false
##JDBC自动提交。默认是关闭的，建议不要修改
#hibernate.connection.autocommit true

## set the JDBC fetch size
##非零值，指定JDBC抓取数量的大小 (调用Statement.setFetchSize()).
##和JDBC一样，设置抓取的大小。例如限制select抓取的大小。与数据库有关！一般对普通数据库没效果，他们没这个功能。
#hibernate.jdbc.fetch_size 25

## set the maximum JDBC 2 batch size (a nonzero value enables batching)
##非零值，允许Hibernate使用JDBC2的批量更新.取值 建议取5到30之间的值
##批量处理更新使用的
#hibernate.jdbc.batch_size 5
#hibernate.jdbc.batch_size 0

## enable batch updates even for versioned data
##如果你想让你的JDBC驱动从executeBatch()返回正确的行计数 , 那么将此属性设为true(开启这个选项通常是安全的). 同时，Hibernate将为自动版本化的数据使用批量DML. 默认值为false.eg.true | false
hibernate.jdbc.batch_versioned_data true

## enable use of JDBC 2 scrollable ResultSets (specifying a Dialect will cause Hibernate to use a sensible default)
##允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时，这个选项才是必要的, 否则Hibernate会使用连接的元数据.取值true | false
##设置可以滚动的结果集。与数据库有关的！
#hibernate.jdbc.use_scrollable_resultset true

## use streams when writing binary types to / from JDBC
##在JDBC读写binary (二进制)或serializable (可序列化) 的类型时使用流(stream)(系统级属性).取值true | false
##设置二进制数据使用流处理，一般对oracle有用，oracle对二进制使用流的处理
hibernate.jdbc.use_streams_for_binary true

## use JDBC 3 PreparedStatement.getGeneratedKeys() to get the identifier of an inserted row
##在数据插入数据库之后，允许使用JDBC3 PreparedStatement.getGeneratedKeys() 来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题，请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力.取值true|false
#hibernate.jdbc.use_get_generated_keys false

## choose a custom JDBC batcher
##选择一个自定义的Batcher. 多数应用程序不需要这个配置属性.eg.classname.of.Batcher
# hibernate.jdbc.factory_class

## enable JDBC result set column alias caching
## (minor performance enhancement for broken JDBC drivers)

# hibernate.jdbc.wrap_result_sets

## choose a custom SQL exception converter

#hibernate.jdbc.sql_exception_converter

 

##########################
### Second-level Cache ###
##########################
##与二级缓存有关的配置
## optimize chache for minimal "puts" instead of minimal "gets" (good for clustered cache)
##以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的.取值true|false
#hibernate.cache.use_minimal_puts true

## set a prefix for cache region names
##二级缓存区域名的前缀.取值prefix
hibernate.cache.region_prefix hibernate.test

## disable the second-level cache
##能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定<cache>的类，会默认开启二级缓存.取值true|false
#hibernate.cache.use_second_level_cache false

## enable the query cache
##允许查询缓存, 个别查询仍然需要被设置为可缓存的.取值true|false
#hibernate.cache.use_query_cache true

## store the second-level cache entries in a more human-friendly format
##强制Hibernate以更人性化的格式将数据存入二级缓存.取值true|false
#hibernate.cache.use_structured_entries true

## choose a cache implementation
##自定义的CacheProvider的类名.取值classname.of.CacheProvider
#hibernate.cache.provider_class org.hibernate.cache.EhCacheProvider
#hibernate.cache.provider_class org.hibernate.cache.EmptyCacheProvider
hibernate.cache.provider_class org.hibernate.cache.HashtableCacheProvider
#hibernate.cache.provider_class org.hibernate.cache.TreeCacheProvider
#hibernate.cache.provider_class org.hibernate.cache.OSCacheProvider
#hibernate.cache.provider_class org.hibernate.cache.SwarmCacheProvider

## choose a custom query cache implementation
##自定义的实现QueryCache接口的类名, 默认为内建的StandardQueryCache.取值classname.of.QueryCache
#hibernate.cache.query_cache_factory

 

############
### JNDI ###
############
##把 SessionFactory挂接到JNDI上
## specify a JNDI name for the SessionFactory

#hibernate.session_factory_name hibernate/session_factory

## Hibernate uses JNDI to bind a name to a SessionFactory and to look up the JTA UserTransaction;
## if hibernate.jndi.* are not specified, Hibernate will use the default InitialContext() which
## is the best approach in an application server
##hibernate.jndi.<propertyName>   是将属性propertyName传递到JNDI InitialContextFactory中去.
#file system
#hibernate.jndi.class com.sun.jndi.fscontext.RefFSContextFactory
#hibernate.jndi.url file:/

#WebSphere
#hibernate.jndi.class com.ibm.websphere.naming.WsnInitialContextFactory
#hibernate.jndi.url iiop://localhost:900/