第 3 章 配置 - Hibernate reference 3.2.0 ga 正式版中文参考手册
目录
由于Hibernate是为了能在各种不同环境下工作而设计的, 因此存在着大量的配置参数. 幸运的是多数配置参数都
有比较直观的默认值, 并有随Hibernate一同分发的配置样例hibernate.properties
(位于etc/)来展示各种配置选项. 所需做的仅仅是将这个样例文件复制到类路径
(classpath)下并做一些自定义的修改.
一个org.hibernate.cfg.Configuration实例代表了一个应用程序中Java类型
到SQL数据库映射的完整集合. Configuration被用来构建一个(不可变的
(immutable))SessionFactory. 映射定义则由不同的XML映射定义文件编译而来.
你可以直接实例化Configuration来获取一个实例，并为它指定XML映射定义
文件. 如果映射定
义文件在类路径(classpath)中, 请使用addResource():
Configuration cfg = new Configuration()
.addResource("Item.hbm.xml")
.addResource("Bid.hbm.xml");
一个替代方法（有时是更好的选择）是，指定被映射的类，让Hibernate帮你寻找映射定义文件:
Configuration cfg = new Configuration()
.addClass(org.hibernate.auction.Item.class)
.addClass(org.hibernate.auction.Bid.class);
Hibernate将会在类路径(classpath)中寻找名字为
/org/hibernate/auction/Item.hbm.xml和
/org/hibernate/auction/Bid.hbm.xml映射定义文件.
这种方式消除了任何对文件名的硬编码(hardcoded).
Configuration也允许你指定配置属性:
Configuration cfg = new Configuration()
.addClass(org.hibernate.auction.Item.class)
.addClass(org.hibernate.auction.Bid.class)
.setProperty("hibernate.dialect", "org.hibernate.dialect.MySQLInnoDBDialect")
.setProperty("hibernate.connection.datasource", "java:comp/env/jdbc/test")
.setProperty("hibernate.order_updates", "true");
当然这不是唯一的传递Hibernate配置属性的方式, 其他可选方式还包括:
传一个
java.util.Properties实例给Configuration.setProperties().将
hibernate.properties放置在类路径(classpath)的根目录下 (root directory).通过
java -Dproperty=value来设置系统 (System)属性.在
hibernate.cfg.xml中加入元素<property>(稍后讨论).
如果想尽快体验Hibernate, hibernate.properties是最简单的方式.
Configuration实例被设计成启动期间（startup-time）对象,
一旦SessionFactory创建完成它就被丢弃了.