Pro JPA 2: Mastering the Java™ Persistence API

Books for Professionals......Page 2
Contents at a Glance......Page 6
Contents......Page 7
Foreword......Page 22
About the Author......Page 23
About the Technical Reviewer......Page 24
Acknowledgments......Page 25
This Book Is For You......Page 26
Contacting Us......Page 27
Introduction......Page 29
Object-Relational Mapping......Page 30
Class Representation......Page 31
Relationships......Page 33
Inheritance......Page 35
JDBC......Page 37
Java Data Objects......Page 38
Why Another Standard?......Page 39
EJB 3.0 and JPA 1.0......Page 40
Overview......Page 41
Mobile Entities......Page 42
Summary......Page 43
Entity Overview......Page 45
Granularity......Page 46
XML......Page 47
Creating an Entity......Page 48
Entity Manager......Page 50
Obtaining an Entity Manager......Page 51
Finding an Entity......Page 52
Removing an Entity......Page 53
Transactions......Page 54
Queries......Page 55
Putting It All Together......Page 56
Persistence Unit......Page 58
Persistence Archive......Page 59
Summary......Page 60
Application Component Models......Page 61
Session Beans......Page 62
Defining a Stateless Session Bean......Page 63
Lifecycle Callbacks......Page 65
Remote Business Interfaces......Page 66
Defining a Stateful Session Bean......Page 67
Lifecycle Callbacks......Page 69
Defining a Singleton Session Bean......Page 70
Singleton Concurrency......Page 71
Defining a Message-Driven Bean......Page 73
Servlets......Page 74
Dependency Lookup......Page 75
Field Injection......Page 77
Setter Injection......Page 78
Referencing a Persistence Context......Page 79
Referencing Enterprise JavaBeans......Page 80
Transaction Management......Page 81
Transaction Review......Page 82
Transaction Demarcation......Page 83
Container-Managed Transactions......Page 84
Bean-Managed Transactions......Page 86
Using a Stateful Session Bean......Page 88
Using a Message-Driven Bean......Page 90
Adding the Entity Manager......Page 91
Defining the Component......Page 92
Defining the User Interface......Page 94
Summary......Page 95
Persistence Annotations......Page 97
Field Access......Page 98
Mixed Access......Page 99
Mapping to a Table......Page 101
Mapping Simple Types......Page 102
Column Mappings......Page 103
Lazy Fetching......Page 104
Large Objects......Page 105
Enumerated Types......Page 106
Transient State......Page 108
Primary Key Types......Page 109
Automatic Id Generation......Page 110
Id Generation Using a Table......Page 111
Id Generation Using a Database Sequence......Page 113
Id Generation Using Database Identity......Page 114
Directionality......Page 115
Ordinality......Page 117
Many-to-One Mappings......Page 118
Using Join Columns......Page 119
One-to-One Mappings......Page 121
Bidirectional One-to-One Mappings......Page 122
One-to-Many Mappings......Page 123
Many-to-Many Mappings......Page 125
Using Join Tables......Page 127
Unidirectional Collection Mappings......Page 128
Lazy Relationships......Page 129
Embedded Objects......Page 130
Summary......Page 134
Relationships and Element Collections......Page 135
Using Different Collection Types......Page 138
Ordering By Entity or Element Attribute......Page 139
Persistently Ordered Lists......Page 140
Maps......Page 142
Keying By Basic Type......Page 143
Keying by Entity Attribute......Page 146
Keying by Embeddable Type......Page 147
Keying by Entity......Page 151
Untyped Maps......Page 152
Rules for Maps......Page 153
Duplicates......Page 154
Best Practices......Page 156
Summary......Page 157
Persistence Contexts......Page 159
Transaction-Scoped......Page 160
Extended......Page 161
Application-Managed Entity Managers......Page 164
JTA Transaction Management......Page 166
Transaction-Scoped Persistence Contexts......Page 167
Extended Persistence Contexts......Page 169
Application-Managed Persistence Contexts......Page 172
Resource-Local Transactions......Page 175
Transaction Rollback and Entity State......Page 177
Persisting an Entity......Page 178
Finding an Entity......Page 179
Removing an Entity......Page 180
Cascading Operations......Page 181
Cascade Persist......Page 182
Cascade Remove......Page 183
Clearing the Persistence Context......Page 184
Synchronization with the Database......Page 185
Detachment......Page 187
Merging Detached Entities......Page 189
Working with Detached Entities......Page 192
Planning for Detachment......Page 194
Avoiding Detachment......Page 196
Merge Strategies......Page 200
Summary......Page 205
Java Persistence Query Language......Page 207
Getting Started......Page 208
Joins Between Entities......Page 209
Query Parameters......Page 210
Dynamic Query Definition......Page 211
Named Query Definition......Page 213
Parameter Types......Page 215
Executing Queries......Page 216
Working with Query Results......Page 218
Optimizing Read-Only Queries......Page 219
Special Result Types......Page 220
Query Paging......Page 221
Queries and Uncommitted Changes......Page 223
Query Timeouts......Page 226
Using Bulk Update and Delete......Page 227
Bulk Delete and Relationships......Page 229
Query Hints......Page 230
Named Queries......Page 231
Stateless Session Beans......Page 232
Summary......Page 233
Introduction......Page 235
Example Data Model......Page 236
Example Application......Page 237
Select Queries......Page 239
Path Expressions......Page 240
Entities and Objects......Page 241
Combining Expressions......Page 242
Inheritance and Polymorphism......Page 243
Joins......Page 244
Basic Expression Form......Page 251
LIKE Expressions......Page 252
Subqueries......Page 253
IN Expressions......Page 254
Collection Expressions......Page 255
Scalar Expressions......Page 256
Literals......Page 257
Function Expressions......Page 258
CASE Expressions......Page 259
Aggregate Queries......Page 261
SUM......Page 263
HAVING Clause......Page 264
Delete Queries......Page 265
Summary......Page 266
Overview......Page 267
The Criteria API......Page 268
Dynamic Queries......Page 269
Creating a Query Definition......Page 272
Criteria Objects and Mutability......Page 274
Query Roots......Page 275
Path Expressions......Page 276
Selecting Single Expressions......Page 277
Selecting Multiple Expressions......Page 278
The FROM Clause......Page 279
Inner and Outer Joins......Page 280
Fetch Joins......Page 281
Building Expressions......Page 282
Predicates......Page 285
Subqueries......Page 286
In Expressions......Page 289
Case Expressions......Page 290
The ORDER BY Clause......Page 292
The Metamodel API......Page 293
Strongly Typed API Overview......Page 295
The Canonical Metamodel......Page 296
Using the Canonical Metamodel......Page 297
Generating the Canonical Metamodel......Page 298
Summary......Page 299
Table and Column Names......Page 301
Advanced Embedded Mappings......Page 303
Overriding Embedded Relationships......Page 304
Id Class......Page 306
Embedded Id Class......Page 308
Derived Identifiers......Page 309
Basic Rules for Derived Identifiers......Page 310
Shared Primary Key......Page 311
Multiple Mapped Attributes......Page 312
Using EmbeddedId......Page 314
Read-Only Mappings......Page 316
Advanced Relationships......Page 317
Using Join Tables......Page 318
Avoiding Join Tables......Page 319
Compound Join Columns......Page 320
Orphan Removal......Page 322
Mapping Relationship State......Page 323
Multiple Tables......Page 325
Class Hierarchies......Page 328
Mapped Superclasses......Page 329
Abstract and Concrete Classes......Page 331
Single-Table Strategy......Page 332
Joined Strategy......Page 335
Table-per-Concrete-Class Strategy......Page 337
Mixed Inheritance......Page 339
Summary......Page 341
SQL Queries......Page 343
Native Queries versus JDBC......Page 344
Defining and Executing SQL Queries......Page 346
SQL Result Set Mapping......Page 348
Mapping Column Aliases......Page 349
Mapping Scalar Result Columns......Page 350
Mapping Compound Keys......Page 352
Mapping Inheritance......Page 353
PrePersist and PostPersist......Page 354
Callback Methods......Page 355
Attaching Entity Listeners to Entities......Page 357
Inheriting Callback Methods......Page 359
Lifecycle Event Invocation Order......Page 360
Validation......Page 363
Using Constraints......Page 364
Invoking Validation......Page 365
Validation Groups......Page 366
Constraint Annotations......Page 368
Constraint Implementation Classes......Page 369
Validation in JPA......Page 370
Setting Lifecycle Validation Groups......Page 371
Entity Operations......Page 372
Refreshing Entity State......Page 373
Optimistic Locking......Page 376
Versioning......Page 377
Advanced Optimistic Locking Modes......Page 378
Recovering from Optimistic Failures......Page 383
Pessimistic Locking Modes......Page 386
Pessimistic Timeouts......Page 388
Sorting Through the Layers......Page 389
Shared Cache......Page 391
Static Configuration of the Cache......Page 393
Dynamic Cache Management......Page 394
PersistenceUnitUtil......Page 396
Summary......Page 397
XML Mapping Files......Page 399
The Metadata Puzzle......Page 400
Disabling Annotations......Page 401
metadata-complete......Page 402
Persistence Unit Defaults......Page 403
delimited-identifiers......Page 404
cascade-persist......Page 405
Mapping File Defaults......Page 406
schema......Page 407
access......Page 408
sequence-generator......Page 409
named-query......Page 410
named-native-query......Page 411
sql-result-set-mapping......Page 412
Attributes......Page 413
Tables......Page 414
Identifier Mappings......Page 415
Simple Mappings......Page 417
Relationship and Collection Mappings......Page 419
Embedded Object Mappings......Page 426
Inheritance Mappings......Page 429
Entity Listeners......Page 432
Summary......Page 434
Configuring Persistence Units......Page 435
Persistence Provider......Page 436
Data Source......Page 437
Mapping Files......Page 438
Local Classes......Page 439
Explicitly Listed Classes......Page 440
Shared Cache Mode......Page 441
Adding Vendor Properties......Page 442
Deployment Classpath......Page 443
EJB JAR......Page 444
Web Archive......Page 446
Persistence Archive......Page 447
Outside the Server......Page 448
Data Source......Page 449
Listing the Entities......Page 450
Schema Generation......Page 451
Unique Constraints......Page 452
String-Based Columns......Page 453
Defining the Column......Page 454
Summary......Page 455
Testing Enterprise Applications......Page 457
Terminology......Page 458
Testing Outside the Server......Page 459
Test Frameworks......Page 460
Testing Entities......Page 461
Testing Entities in Components......Page 462
The Entity Manager in Unit Tests......Page 464
Using the Entity Manager......Page 467
Test Setup and Teardown......Page 469
Switching Configurations for Testing......Page 470
Minimizing Database Connections......Page 472
Transaction Management......Page 473
Container-Managed Entity Managers......Page 478
Other Services......Page 480
Using an Embedded EJB Container for Integration Testing......Page 481
Summary......Page 483
Migrating from CMP Entity Beans......Page 485
Scoping the Challenge......Page 486
Converting the Business Interface......Page 487
Converting the Home Interface......Page 491
Migrating from JDBC......Page 495
Migrating from Other ORM Solutions......Page 496
Fine-Grained Transfer Objects......Page 497
Coarse-Grained Transfer Objects......Page 499
Session Façade......Page 500
Data Access Object......Page 502
Business Object......Page 506
Active Record......Page 507
Summary......Page 508
Index......Page 509