Embed Doc
Copy Link
Readcast
Collections

CommentGo Back

Download

Hibernate Reference Documentation

Version: 3.1

Table of Contents

Preface..........................................................................................................................................viii

1. Introduction to Hibernate

...........................................................................................................11.1. Preface..............................................................................................................................11.2. Part 1 - The first Hibernate Application...............................................................................11.2.1. The first class..........................................................................................................11.2.2. The mapping file.....................................................................................................21.2.3. Hibernate configuration...........................................................................................41.2.4. Building with Ant....................................................................................................61.2.5. Startup and helpers..................................................................................................61.2.6. Loading and storing objects......................................................................................81.3. Part 2 - Mapping associations............................................................................................101.3.1. Mapping the Person class.......................................................................................101.3.2. A unidirectional Set-based association....................................................................111.3.3. Working the association.........................................................................................121.3.4. Collection of values...............................................................................................131.3.5. Bi-directional associations.....................................................................................141.3.6. Working bi-directional links...................................................................................151.4. Part 3 - The EventManager web application.......................................................................161.4.1. Writing the basic servlet........................................................................................161.4.2. Processing and rendering.......................................................................................171.4.3. Deploying and testing............................................................................................181.5. Summary.........................................................................................................................19

2. Architecture

..............................................................................................................................202.1. Overview.........................................................................................................................202.2. Instance states..................................................................................................................222.3. JMX Integration...............................................................................................................222.4. JCA Support....................................................................................................................232.5. Contextual Sessions..........................................................................................................23

3. Configuration

............................................................................................................................253.1. Programmatic configuration..............................................................................................253.2. Obtaining a SessionFactory...............................................................................................253.3. JDBC connections............................................................................................................263.4. Optional configuration properties......................................................................................273.4.1. SQL Dialects.........................................................................................................323.4.2. Outer Join Fetching...............................................................................................333.4.3. Binary Streams......................................................................................................343.4.4. Second-level and query cache.................................................................................343.4.5. Query Language Substitution.................................................................................343.4.6. Hibernate statistics................................................................................................343.5. Logging...........................................................................................................................343.6. Implementing a NamingStrategy.......................................................................................353.7. XML configuration file.....................................................................................................353.8. J2EE Application Server integration..................................................................................363.8.1. Transaction strategy configuration..........................................................................373.8.2. JNDI-bound SessionFactory...................................................................................383.8.3. Current Session context management with JTA.......................................................383.8.4. JMX deployment...................................................................................................39

4. Persistent Classes

......................................................................................................................40Hibernate 3.1 ii

4.1. A simple POJO example...................................................................................................404.1.1. Implement a no-argument constructor.....................................................................414.1.2. Provide an identifier property (optional)..................................................................414.1.3. Prefer non-final classes (optional)...........................................................................414.1.4. Declare accessors and mutators for persistent fields (optional)..................................424.2. Implementing inheritance.................................................................................................424.3. Implementing equals() and hashCode()..............................................................................424.4. Dynamic models..............................................................................................................434.5. Tuplizers.........................................................................................................................45

5. Basic O/R Mapping

...................................................................................................................475.1. Mapping declaration.........................................................................................................475.1.1. Doctype................................................................................................................485.1.2. hibernate-mapping.................................................................................................485.1.3. class.....................................................................................................................495.1.4. id..........................................................................................................................515.1.4.1. Generator...................................................................................................525.1.4.2. Hi/lo algorithm...........................................................................................535.1.4.3. UUID algorithm.........................................................................................535.1.4.4. Identity columns and sequences...................................................................535.1.4.5. Assigned identifiers....................................................................................545.1.4.6. Primary keys assigned by triggers................................................................545.1.5. composite-id.........................................................................................................545.1.6. discriminator.........................................................................................................555.1.7. version (optional)..................................................................................................565.1.8. timestamp (optional)..............................................................................................565.1.9. property................................................................................................................575.1.10. many-to-one........................................................................................................585.1.11. one-to-one...........................................................................................................605.1.12. natural-id............................................................................................................625.1.13. component, dynamic-component..........................................................................625.1.14. properties............................................................................................................635.1.15. subclass..............................................................................................................645.1.16. joined-subclass....................................................................................................645.1.17. union-subclass.....................................................................................................655.1.18. join.....................................................................................................................665.1.19. key.....................................................................................................................675.1.20. column and formula elements...............................................................................675.1.21. import.................................................................................................................685.1.22. any.....................................................................................................................685.2. Hibernate Types...............................................................................................................695.2.1. Entities and values.................................................................................................695.2.2. Basic value types...................................................................................................705.2.3. Custom value types...............................................................................................715.3. Mapping a class more than once........................................................................................725.4. SQL quoted identifiers......................................................................................................725.5. Metadata alternatives........................................................................................................725.5.1. Using XDoclet markup..........................................................................................735.5.2. Using JDK 5.0 Annotations....................................................................................745.6. Generated Properties........................................................................................................755.7. Auxiliary Database Objects...............................................................................................75

6. Collection Mapping

...................................................................................................................776.1. Persistent collections........................................................................................................77HIBERNATE - Relational Persistence for Idiomatic JavaHibernate 3.1 iii

of 00

Hibernate Reference

Hibernate reference is a complete reference to what you can and cannot do with Hibernate as an ORM tool in your application.

Download or Print

3,272 Reads

Info and Rating

Category:	Uncategorized.
Rating:	(8 Ratings)
Upload Date:	01/21/2009
Copyright:	Attribution Non-commercial
Tags:	ORM Hibernate mappings object relational mapping xbm hibernate mappings (more tags) ORM Hibernate mappings object relational mapping xbm hibernate mappings spring orm Internet & Technology (fewer)