# 3.1\. 可編程的配置方式
一個`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配置屬性的方式, 其他可選方式還包括:
1. 傳一個`java.util.Properties`實例給 `Configuration.setProperties()`.
2. 將`hibernate.properties`放置在類路徑(classpath)的根目錄下 (root directory).
3. 通過`java -Dproperty=value`來設置系統 (`System`)屬性.
4. 在`hibernate.cfg.xml`中加入元素 `<property>` (稍后討論).
如果想盡快體驗Hibernate, `hibernate.properties`是最簡單的方式.
`Configuration`實例被設計成啟動期間（startup-time）對象, 一旦`SessionFactory`創建完成它就被丟棄了.
- 前言
- 1. 翻譯說明
- 2. 版權聲明
- 第 1 章 Hibernate入門
- 1.1. 前言
- 1.2. 第一部分 － 第一個Hibernate應用程序
- 1.2.1. 第一個class
- 1.2.2. 映射文件
- 1.2.3. Hibernate配置
- 1.2.4. 用Ant構建
- 1.2.5. 啟動和輔助類
- 1.2.6. 加載并存儲對象
- 1.3. 第二部分 － 關聯映射
- 1.3.1. 映射Person類
- 1.3.2. 單向Set-based的關聯
- 1.3.3. 使關聯工作
- 1.3.4. 值類型的集合
- 1.3.5. 雙向關聯
- 1.3.6. 使雙向連起來
- 1.4. 第三部分 - EventManager web應用程序
- 1.4.1. 編寫基本的servlet
- 1.4.2. 處理與渲染
- 1.4.3. 部署與測試
- 1.5. 總結
- 第 2 章 體系結構(Architecture)
- 2.1. 概況(Overview)
- 2.2. 實例狀態
- 2.3. JMX整合
- 2.4. 對JCA的支持
- 2.5. 上下文相關的（Contextual）Session
- 第 3 章 配置
- 3.1. 可編程的配置方式
- 3.2. 獲得SessionFactory
- 3.3. JDBC連接
- 3.4. 可選的配置屬性
- 3.4.1. SQL方言
- 3.4.2. 外連接抓取(Outer Join Fetching)
- 3.4.3. 二進制流 (Binary Streams)
- 3.4.4. 二級緩存與查詢緩存
- 3.4.5. 查詢語言中的替換
- 3.4.6. Hibernate的統計(statistics)機制
- 3.5. 日志
- 3.6. 實現NamingStrategy
- 3.7. XML配置文件
- 3.8. J2EE應用程序服務器的集成
- 3.8.1. 事務策略配置
- 3.8.2. JNDI綁定的SessionFactory
- 3.8.3. 在JTA環境下使用Current Session context (當前session上下文)管理
- 3.8.4. JMX部署
- 第 4 章 持久化類(Persistent Classes)
- 4.1. 一個簡單的POJO例子
- 4.1.1. 實現一個默認的（即無參數的）構造方法（constructor）
- 4.1.2. 提供一個標識屬性（identifier property）（可選）
- 4.1.3. 使用非final的類 (可選)
- 4.1.4. 為持久化字段聲明訪問器(accessors)和是否可變的標志(mutators)(可選)
- 4.2. 實現繼承（Inheritance）
- 4.3. 實現equals()和hashCode()
- 4.4. 動態模型(Dynamic models)
- 4.5. 元組片斷映射(Tuplizers)
- 第 5 章 對象/關系數據庫映射基礎(Basic O/R Mapping)
- 5.1. 映射定義（Mapping declaration）
- 5.1.1. Doctype
- 5.1.1.1. EntityResolver
- 5.1.2. hibernate-mapping
- 5.1.3. class
- 5.1.4. id
- 5.1.4.1. Generator
- 5.1.4.2. 高/低位算法（Hi/Lo Algorithm）
- 5.1.4.3. UUID算法（UUID Algorithm ）
- 5.1.4.4. 標識字段和序列（Identity columns and Sequences）
- 5.1.4.5. 程序分配的標識符（Assigned Identifiers）
- 5.1.4.6. 觸發器實現的主鍵生成器（Primary keys assigned by triggers）
- 5.1.5. composite-id
- 5.1.6. 鑒別器（discriminator）
- 5.1.7. 版本（version）(可選)
- 5.1.8. timestamp (可選)
- 5.1.9. property
- 5.1.10. 多對一（many-to-one）
- 5.1.11. 一對一
- 5.1.12. 自然ID(natural-id)
- 5.1.13. 組件(component), 動態組件(dynamic-component)
- 5.1.14. properties
- 5.1.15. 子類(subclass)
- 5.1.16. 連接的子類(joined-subclass)
- 5.1.17. 聯合子類(union-subclass)
- 5.1.18. 連接(join)
- 5.1.19. 鍵(key)
- 5.1.20. 字段和規則元素（column and formula elements）
- 5.1.21. 引用(import)
- 5.1.22. any
- 5.2. Hibernate 的類型
- 5.2.1. 實體(Entities)和值(values)
- 5.2.2. 基本值類型
- 5.2.3. 自定義值類型
- 5.3. 多次映射同一個類
- 5.4. SQL中引號包圍的標識符
- 5.5. 其他元數據(Metadata)
- 5.5.1. 使用 XDoclet 標記
- 5.5.2. 使用 JDK 5.0 的注解(Annotation)
- 5.6. 數據庫生成屬性（Generated Properties）
- 5.7. 輔助數據庫對象(Auxiliary Database Objects)
- 第 6 章 集合類(Collections)映射
- 6.1. 持久化集合類(Persistent collections)
- 6.2. 集合映射（ Collection mappings ）
- 6.2.1. 集合外鍵(Collection foreign keys)
- 6.2.2. 集合元素（Collection elements）
- 6.2.3. 索引集合類(Indexed collections)
- 6.2.4. 值集合于多對多關聯(Collections of values and many-to-many associations)
- 6.2.5. 一對多關聯（One-to-many Associations）
- 6.3. 高級集合映射（Advanced collection mappings）
- 6.3.1. 有序集合（Sorted collections）
- 6.3.2. 雙向關聯（Bidirectional associations）
- 6.3.3. 雙向關聯，涉及有序集合類
- 6.3.4. 三重關聯（Ternary associations）
- 6.3.5. 使用<idbag>
- 6.4. 集合例子（Collection example）
- 第 7 章 關聯關系映射
- 7.1. 介紹
- 7.2. 單向關聯（Unidirectional associations）
- 7.2.1. 多對一(many to one)
- 7.2.2. 一對一（one to one）
- 7.2.3. 一對多（one to many）
- 7.3. 使用連接表的單向關聯（Unidirectional associations with join tables）
- 7.3.1. 一對多(one to many)
- 7.3.2. 多對一（many to one）
- 7.3.3. 一對一（one to one）
- 7.3.4. 多對多（many to many）
- 7.4. 雙向關聯（Bidirectional associations）
- 7.4.1. 一對多（one to many) / 多對一（many to one）
- 7.4.2. 一對一（one to one）
- 7.5. 使用連接表的雙向關聯（Bidirectional associations with join tables）
- 7.5.1. 一對多（one to many） /多對一（ many to one）
- 7.5.2. 一對一（one to one）
- 7.5.3. 多對多（many to many）
- 7.6. 更復雜的關聯映射
- 第 8 章 組件（Component）映射
- 8.1. 依賴對象（Dependent objects）
- 8.2. 在集合中出現的依賴對象 (Collections of dependent objects)
- 8.3. 組件作為Map的索引（Components as Map indices ）
- 8.4. 組件作為聯合標識符(Components as composite identifiers)
- 8.5. 動態組件 （Dynamic components）
- 第 9 章 繼承映射(Inheritance Mappings)
- 9.1. 三種策略
- 9.1.1. 每個類分層結構一張表(Table per class hierarchy)
- 9.1.2. 每個子類一張表(Table per subclass)
- 9.1.3. 每個子類一張表(Table per subclass)，使用辨別標志(Discriminator)
- 9.1.4. 混合使用“每個類分層結構一張表”和“每個子類一張表”
- 9.1.5. 每個具體類一張表(Table per concrete class)
- 9.1.6. Table per concrete class, using implicit polymorphism
- 9.1.7. 隱式多態和其他繼承映射混合使用
- 9.2. 限制
- 第 10 章 與對象共事
- 10.1. Hibernate對象狀態(object states)
- 10.2. 使對象持久化
- 10.3. 裝載對象
- 10.4. 查詢
- 10.4.1. 執行查詢
- 10.4.1.1. 迭代式獲取結果(Iterating results)
- 10.4.1.2. 返回元組(tuples)的查詢
- 10.4.1.3. 標量(Scalar)結果
- 10.4.1.4. 綁定參數
- 10.4.1.5. 分頁
- 10.4.1.6. 可滾動遍歷(Scrollable iteration)
- 10.4.1.7. 外置命名查詢(Externalizing named queries)
- 10.4.2. 過濾集合
- 10.4.3. 條件查詢(Criteria queries)
- 10.4.4. 使用原生SQL的查詢
- 10.5. 修改持久對象
- 10.6. 修改脫管(Detached)對象
- 10.7. 自動狀態檢測
- 10.8. 刪除持久對象
- 10.9. 在兩個不同數據庫間復制對象
- 10.10. Session刷出(flush)
- 10.11. 傳播性持久化(transitive persistence)
- 10.12. 使用元數據
- 第 11 章 事務和并發
- 11.1. Session和事務范圍(transaction scope)
- 11.1.1. 操作單元(Unit of work)
- 11.1.2. 長對話
- 11.1.3. 關注對象標識(Considering object identity)
- 11.1.4. 常見問題
- 11.2. 數據庫事務聲明
- 11.2.1. 非托管環境
- 11.2.2. 使用JTA
- 11.2.3. 異常處理
- 11.2.4. 事務超時
- 11.3. 樂觀并發控制(Optimistic concurrency control)
- 11.3.1. 應用程序級別的版本檢查(Application version checking)
- 11.3.2. 擴展周期的session和自動版本化
- 11.3.3. 脫管對象(deatched object)和自動版本化
- 11.3.4. 定制自動版本化行為
- 11.4. 悲觀鎖定(Pessimistic Locking)
- 11.5. 連接釋放模式(Connection Release Modes)
- 第 12 章 攔截器與事件(Interceptors and events)
- 12.1. 攔截器(Interceptors)
- 12.2. 事件系統(Event system)
- 12.3. Hibernate的聲明式安全機制
- 第 13 章 批量處理（Batch processing）
- 13.1. 批量插入（Batch inserts）
- 13.2. 批量更新（Batch updates）
- 13.3. StatelessSession (無狀態session)接口
- 13.4. DML(數據操作語言)風格的操作(DML-style operations)
- 第 14 章 HQL: Hibernate查詢語言
- 14.1. 大小寫敏感性問題
- 14.2. from子句
- 14.3. 關聯(Association)與連接(Join)
- 14.4. join 語法的形式
- 14.5. select子句
- 14.6. 聚集函數
- 14.7. 多態查詢
- 14.8. where子句
- 14.9. 表達式
- 14.10. order by子句
- 14.11. group by子句
- 14.12. 子查詢
- 14.13. HQL示例
- 14.14. 批量的UPDATE和DELETE
- 14.15. 小技巧 & 小竅門
- 第 15 章 條件查詢(Criteria Queries)
- 15.1. 創建一個Criteria 實例
- 15.2. 限制結果集內容
- 15.3. 結果集排序
- 15.4. 關聯
- 15.5. 動態關聯抓取
- 15.6. 查詢示例
- 15.7. 投影(Projections)、聚合（aggregation）和分組（grouping）
- 15.8. 離線(detached)查詢和子查詢
- 15.9. 根據自然標識查詢(Queries by natural identifier)
- 第 16 章 Native SQL查詢
- 16.1. 使用SQLQuery
- 16.1.1. 標量查詢（Scalar queries）
- 16.1.2. 實體查詢(Entity queries)
- 16.1.3. 處理關聯和集合類(Handling associations and collections)
- 16.1.4. 返回多個實體(Returning multiple entities)
- 16.1.4.1. 別名和屬性引用(Alias and property references)
- 16.1.5. 返回非受管實體(Returning non-managed entities)
- 16.1.6. 處理繼承（Handling inheritance）
- 16.1.7. 參數（Parameters）
- 16.2. 命名SQL查詢
- 16.2.1. 使用return-property來明確地指定字段/別名
- 16.2.2. 使用存儲過程來查詢
- 16.2.2.1. 使用存儲過程的規則和限制
- 16.3. 定制SQL用來create，update和delete
- 16.4. 定制裝載SQL
- 第 17 章 過濾數據
- 17.1. Hibernate 過濾器(filters)
- 第 18 章 XML映射
- 18.1. 用XML數據進行工作
- 18.1.1. 指定同時映射XML和類
- 18.1.2. 只定義XML映射
- 18.2. XML映射元數據
- 18.3. 操作XML數據
- 第 19 章 提升性能
- 19.1. 抓取策略(Fetching strategies)
- 19.1.1. 操作延遲加載的關聯
- 19.1.2. 調整抓取策略（Tuning fetch strategies）
- 19.1.3. 單端關聯代理（Single-ended association proxies）
- 19.1.4. 實例化集合和代理（Initializing collections and proxies）
- 19.1.5. 使用批量抓取（Using batch fetching）
- 19.1.6. 使用子查詢抓取（Using subselect fetching）
- 19.1.7. 使用延遲屬性抓取（Using lazy property fetching）
- 19.2. 二級緩存（The Second Level Cache）
- 19.2.1. 緩存映射（Cache mappings）
- 19.2.2. 策略：只讀緩存（Strategy: read only）
- 19.2.3. 策略:讀/寫緩存（Strategy: read/write）
- 19.2.4. 策略:非嚴格讀/寫緩存（Strategy: nonstrict read/write）
- 19.2.5. 策略:事務緩存（transactional）
- 19.3. 管理緩存（Managing the caches）
- 19.4. 查詢緩存（The Query Cache）
- 19.5. 理解集合性能（Understanding Collection performance）
- 19.5.1. 分類（Taxonomy）
- 19.5.2. Lists, maps 和sets用于更新效率最高
- 19.5.3. Bag和list是反向集合類中效率最高的
- 19.5.4. 一次性刪除（One shot delete）
- 19.6. 監測性能（Monitoring performance）
- 19.6.1. 監測SessionFactory
- 19.6.2. 數據記錄（Metrics）
- 第 20 章 工具箱指南
- 20.1. Schema自動生成（Automatic schema generation）
- 20.1.1. 對schema定制化(Customizing the schema)
- 20.1.2. 運行該工具
- 20.1.3. 屬性(Properties)
- 20.1.4. 使用Ant(Using Ant)
- 20.1.5. 對schema的增量更新(Incremental schema updates)
- 20.1.6. 用Ant來增量更新schema(Using Ant for incremental schema updates)
- 20.1.7. Schema 校驗
- 20.1.8. 使用Ant進行schema校驗
- 第 21 章 示例：父子關系(Parent Child Relationships)
- 21.1. 關于collections需要注意的一點
- 21.2. 雙向的一對多關系(Bidirectional one-to-many)
- 21.3. 級聯生命周期（Cascading lifecycle）
- 21.4. 級聯與未保存值（Cascades and unsaved-value）
- 21.5. 結論
- 第 22 章 示例：Weblog 應用程序
- 22.1. 持久化類
- 22.2. Hibernate 映射
- 22.3. Hibernate 代碼
- 第 23 章 示例：復雜映射實例
- 23.1. Employer（雇主)/Employee(雇員)
- 23.2. Author(作家)/Work(作品)
- 23.3. Customer(客戶)/Order(訂單)/Product(產品)
- 23.4. 雜例
- 23.4.1. "Typed" one-to-one association
- 23.4.2. Composite key example
- 23.4.3. 共有組合鍵屬性的多對多(Many-to-many with shared composite key attribute)
- 23.4.4. Content based discrimination
- 23.4.5. Associations on alternate keys
- 第 24 章 最佳實踐(Best Practices)