EclipseLink/UserGuide/JPA

The EclipseLink JPA User's Guide

EclipseLink Home

Introduction:	About EclipseLink	Release Notes	FAQs	Javadoc (API)
Basic:	Configuration	Entities	Mapping	Caching	Querying	Transactions
Advanced:	Performance	Platforms	Dynamic
	Search the EclipseLink JPA documentation wiki.

---

Complete Table of Contents:

Introduction

• Introduction
  • About EclipseLink
  • Object-Persistence Impedance Mismatch
  • EclipseLink Application Architectures
• About This Documentation

Basic JPA Development

• Basic JPA Development
  • About EclipseLink JPA
  • JPA Configuration Basics
    • Configuring Persistence Units Using persistence.xml
    • Adding Metadata Using Annotations
    • Specifying Object-Relational Mappings Using orm.xml
    • About the Default Configuration Values
    • Specifying EclipseLink Object-Relational Mappings Using eclipselink-orm.xml
    • Overriding and Merging Metadata Settings
  • Configuring Entities
    • Identity
      • @Id
      • @IdClass
      • @EmbeddedId
      • @GeneratedValue
      • @TableGenerator
      • @SequenceGenerator
      • Advanced Identity Generation
    • Tables
      • @Table
      • @SecondaryTable
      • Advanced Multiple Table Configuration
    • Inheritance
      • @Inheritance
      • @MappedSuperclass
      • Advanced Inheritance Configuration
    • Embedded Objects
      • @Embeddable
      • @EmbeddedId
      • @Embedded
      • @ElementCollection
      • Advanced Embeddable Configuration
  • Configuring Mappings
    • Basic Mappings
      • @Basic
      • @Enumerated
      • @Temporal
      • @Lob
      • @Transient
      • @Column
      • Default Conversions and Converters
        • @Converter
        • @TypeConverter
        • @ObjectTypeConverter
        • @StructConverter
        • @Convert
      • Lazy Basics
    • Relationship Mappings
      • • @OneToOne
        • @ManyToOne
        • @Embedded
        • @VariableOneToOne
      • Common Relationship Configurations
        • @JoinFetch
        • @BatchFetch
      • Collection Mappings
        • Common Collection Configurations
        • OneToMany
        • ManyToMany
        • ElementCollection
    • Locking
      • Optimistic Locking
  • Caching
    • Caching Overview
    • @Cache
    • Shared and Isolated
    • Type and Size
    • Expiration
    • Coordination
  • Querying
    • JPQL
    • Criteria
    • Native SQL Queries
    • StoredProcedures
    • Query Hints
    • Query Casting (new in EL 2.1)
    • Batch Reading (new in EL 2.1)
    • Query Keys (new in EL 2.1)
    • Support for Native Database Functions (new in EL 2.1)
    • JPA Query Improvements (2.1)
  • Transactions
    • Handling Concurrency Violations

Advanced JPA Development

• Advanced JPA Development
  • Customizers
    • @Customizer
    • SessionCustomizer
  • @Transformation
  • Returning
  • Instantiation and Copying
  • Interfaces
  • Events
  • Fetch Groups
  • Additional Criteria (new in EL 2.2)
  • History
  • Data Partitioning (new in EL 2.2)
  • @Struct and @Array types
  • XML Types
  • Dynamic
  • Schema Generation
    • @CascadeOnDelete (new in EL 2.2)
    • @Index (new in EL 2.2)
    • Appending strings to CREATE TABLE statements (new in EL 2.2)
  • JPA RESTful Services (new in EL 2.2)
  • Performance
    • Performance Monitoring and Profiling
      • Performance Profiling
      • Fetch Group Monitoring
      • Performance Monitoring (new in EL 2.2)
      • Query Monitoring
  • Weaving
    • Configuring Dynamic Weaving
    • Configuring Static Weaving
    • Weaving POJO Classes
    • Weaving and Java EE Application Servers
    • Disabling Weaving with Persistence Unit Properties
  • Database and Application Server Support
  • Extensible Entities
  • External Mappings
  • Composite Persistence Units
  • Stored Procedure and PL/SQL Support
  • Single-Table Multi-Tenancy