High Quality
Open the downloaded document, and select print from the file menu (PDF reader required).
NHibernate Reference Documentation
Version: 1.2.0
Table of Contents
Preface...........................................................................................................................................vii
...........................................................................11.1. Getting started with NHibernate..........................................................................................11.2. First persistent class...........................................................................................................21.3. Mapping the cat.................................................................................................................31.4. Playing with cats................................................................................................................41.5. Finally...............................................................................................................................6
................................................................................................................................72.1. Overview...........................................................................................................................72.2. Instance states....................................................................................................................92.3. Contextual Sessions............................................................................................................9
..................................................................................................113.1. Programmatic Configuration.............................................................................................113.2. Obtaining an ISessionFactory............................................................................................123.3. User provided ADO.NET connection................................................................................123.4. NHibernate provided ADO.NET connection......................................................................123.5. Optional configuration properties......................................................................................143.5.1. SQL Dialects.........................................................................................................163.5.2. Outer Join Fetching...............................................................................................173.5.3. Custom ICacheProvider.........................................................................................173.5.4. Query Language Substitution.................................................................................183.6. Logging...........................................................................................................................183.7. Implementing an INamingStrategy....................................................................................183.8. XML Configuration File...................................................................................................18
......................................................................................................................204.1. A simple POCO example..................................................................................................204.1.1. Declare accessors and mutators for persistent fields.................................................214.1.2. Implement a default constructor.............................................................................214.1.3. Provide an identifier property (optional)..................................................................214.1.4. Prefer non-sealed classes and virtual methods (optional)..........................................214.2. Implementing inheritance.................................................................................................224.3. Implementing Equals() and GetHashCode().......................................................................224.4. Lifecycle Callbacks..........................................................................................................234.5. IValidatable callback ........................................................................................................24
...................................................................................................................255.1. Mapping declaration.........................................................................................................255.1.1. XML Namespace..................................................................................................255.1.2. hibernate-mapping.................................................................................................265.1.3. class.....................................................................................................................265.1.4. id..........................................................................................................................285.1.4.1. generator....................................................................................................285.1.4.2. Hi/Lo Algorithm.........................................................................................305.1.4.3. UUID Hex Algorithm.................................................................................305.1.4.4. UUID String Algorithm..............................................................................305.1.4.5. GUID Algorithms.......................................................................................305.1.4.6. Identity columns and Sequences..................................................................305.1.4.7. Assigned Identifiers....................................................................................315.1.5. composite-id.........................................................................................................31NHibernate 1.2.0 ii
5.1.6. discriminator.........................................................................................................325.1.7. version (optional)..................................................................................................325.1.8. timestamp (optional)..............................................................................................335.1.9. property................................................................................................................335.1.10. many-to-one........................................................................................................365.1.11. one-to-one...........................................................................................................375.1.12. component, dynamic-component..........................................................................385.1.13. subclass..............................................................................................................395.1.14. joined-subclass....................................................................................................395.1.15. map, set, list, bag.................................................................................................405.1.16. import.................................................................................................................405.2. NHibernate Types............................................................................................................415.2.1. Entities and values.................................................................................................415.2.2. Basic value types...................................................................................................415.2.3. Custom value types...............................................................................................435.2.4. Any type mappings................................................................................................445.3. SQL quoted identifiers......................................................................................................455.4. Modular mapping files......................................................................................................455.5. Generated Properties........................................................................................................465.6. Auxiliary Database Objects...............................................................................................46
...................................................................................................................486.1. Persistent Collections.......................................................................................................486.2. Mapping a Collection.......................................................................................................496.3. Collections of Values and Many-To-Many Associations.....................................................506.4. One-To-Many Associations..............................................................................................526.5. Lazy Initialization............................................................................................................536.6. Sorted Collections............................................................................................................546.7. Using an <idbag>.............................................................................................................556.8. Bidirectional Associations................................................................................................556.9. Ternary Associations........................................................................................................566.10. Heterogeneous Associations............................................................................................576.11. Collection examples.......................................................................................................57
................................................................................................................607.1. Dependent objects............................................................................................................607.2. Collections of dependent objects.......................................................................................617.3. Components as IDictionary indices....................................................................................627.4. Components as composite identifiers.................................................................................627.5. Dynamic components.......................................................................................................64
.................................................................................................................658.1. The Three Strategies.........................................................................................................658.2. Limitations......................................................................................................................67
....................................................................................................699.1. Creating a persistent object...............................................................................................699.2. Loading an object.............................................................................................................699.3. Querying.........................................................................................................................709.3.1. Scalar queries........................................................................................................719.3.2. The IQuery interface..............................................................................................729.3.3. Filtering collections...............................................................................................739.3.4. Criteria queries......................................................................................................739.3.5. Queries in native SQL............................................................................................739.4. Updating objects..............................................................................................................749.4.1. Updating in the same ISession................................................................................74NHibernate - Relational Persistence for Idiomatic .NETNHibernate 1.2.0 iii
Add a Comment