Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 General Concepts

• 1.1 What is TopLink?
  • 1.1.1 What Is the Object-Persistence Impedance Mismatch?
  • 1.1.2 The TopLink Solution
• 1.2 TopLink Key Features
• 1.3 TopLink Metadata
• 1.4 TopLink Components
  • 1.4.1 EclipseLink Core
  • 1.4.2 Object-Relational (JPA 2.0)
  • 1.4.3 Object-XML (JAXB)
    • 1.4.3.1 TopLink SDO
  • 1.4.4 Database Web Services (DBWS)
  • 1.4.5 TopLink Grid
• 1.5 TopLink Application Architectures
  • 1.5.1 Three-Tier Architectures
    • 1.5.1.1 EJB Session Bean Facade
  • 1.5.2 Java SE or Thick Client
  • 1.5.3 Web Services
  • 1.5.4 TopLink Database Web Services
• 1.6 Mappings
  • 1.6.1 Relational Mappings
  • 1.6.2 Object-Relational Data Type Mappings
  • 1.6.3 Object-XML Data Type Mappings
• 1.7 TopLink/EclipseLink API

2 Building Blocks of a TopLink Project

• 2.1 Building Blocks for Object-Relational Mapping
  • 2.1.1 Object-Relational Entity Architecture
    • 2.1.1.1 Entities
    • 2.1.1.2 Persistence and Persistence Units
    • 2.1.1.3 Entity Managers
  • 2.1.2 Adding Metadata Using Annotations
  • 2.1.3 Configuration Files
    • 2.1.3.1 About the Default Configuration Values
    • 2.1.3.2 Configuring Persistence Units Using persistence.xml
    • 2.1.3.3 Specifying TopLink Object-Relational Mappings Using eclipselink-orm.xml
  • 2.1.4 Data Sources
  • 2.1.5 TopLink Caches
    • 2.1.5.1 Defining Cache Behavior
    • 2.1.5.2 Caching in Clustered Environments
  • 2.1.6 Database Queries
    • 2.1.6.1 JPQL
    • 2.1.6.2 Criteria Queries
    • 2.1.6.3 Query Hints
    • 2.1.6.4 Advanced TopLink Native Query Support
• 2.2 Building Blocks for Object-XML Mapping
  • 2.2.1 Using TopLink Object-XML as the JAXB Provider
  • 2.2.2 Object-XML Architecture
    • 2.2.2.1 JAXB Contexts and JAXB Context Factories
  • 2.2.3 Serving Metadata for Object-XML
  • 2.2.4 XML Bindings
  • 2.2.5 Specifying TopLink Object-XML Mappings Using eclipselink-oxm.xml
  • 2.2.6 Querying Objects by XPath

3 Development Tools for TopLink

• 3.1 Oracle JDeveloper
• 3.2 Oracle Enterprise Pack for Eclipse
• 3.3 Eclipse
• 3.4 NetBeans