Table of Contents
Preface ............................................................................................................................................iv
1. Setting up an annotations project ................................................................................................1
1.1. Requirements .....................................................................................................................1
1.2. Configuration .....................................................................................................................1
1.3. Properties ..........................................................................................................................2
1.4. Logging ............................................................................................................................. 3
2. Entity Beans ................................................................................................................................ 4
2.1. Intro ..................................................................................................................................4
2.2. Mapping with EJB3/JPA Annotations .................................................................................. 4
2.2.1. Declaring an entity bean ..........................................................................................4
2.2.1.1. Defining the table .........................................................................................4
2.2.1.2. Versioning for optimistic locking ...................................................................5
2.2.2. Mapping simple properties .......................................................................................5
2.2.2.1. Declaring basic property mappings ................................................................ 5
2.2.2.2. Declaring column attributes ........................................................................... 7
2.2.2.3. Embedded objects (aka components) ..............................................................7
2.2.2.4. Non-annotated property defaults .................................................................... 9
2.2.. Mapping identifier properties .....................................................................................9
2.2.4. Mapping inheritance .............................................................................................. 12
2.2.4.1. Table per class ............................................................................................ 13
2.2.4.2. Single table per class hierarchy .................................................................... 13
2.2.4.3. Joined subclasses ........................................................................................ 13
2.2.4.4. Inherit properties from superclasses ............................................................. 14
2.2.5. Mapping entity bean associations/relationships ........................................................ 15
2.2.5.1. One-to-one ................................................................................................. 15
2.2.5.2. Many-to-one ............................................................................................... 17
2.2.5.3. Collections ................................................................................................. 18
2.2.5.4. Transitive persistence with cascading ........................................................... 23
2.2.5.5. Association fetching ................................................................................... 24
2.2.6. Mapping composite primary and foreign keys ......................................................... 24
2.2.7. Mapping secondary tables ...................................................................................... 25
2.3. Mapping Queries .............................................................................................................. 26
2.3.Mapping JPAQL/HQL queries. Mapping JPAQL/HQL queries .................................... 26
2.3.2. Mapping native queries .......................................................................................... 27
2.4. Hibernate Annotation Extensions ...................................................................................... 30
2.4.1. Entity ................................................................................................................... 30
2.4.Identifier. Identifier ................................................................................................... 32
2.4.Identifier.1. Generators ...................................................................................... 32
2.4.Identifier.2. @NaturalId .................................................................................... 33
2.4.3. Property ................................................................................................................ 33
2.4.3.1. Access type ................................................................................................ 33
2.4.3.2. Formula ..................................................................................................... 35
2.4.3.3. Type .......................................................................................................... 35
2.4.3.4. Index ......................................................................................................... 36
2.4.3.5. @Parent ..................................................................................................... 36
2.4.3.6. Generated properties ................................................................................... 36
2.4.3.7. @Target ..................................................................................................... 36
2.4.3.8. Optimistic lock ........................................................................................... 37
Hibernate 3.4.0.GA ii
