1 Introduction
This chapter includes the following sections:
About Oracle TopLink
Use TopLink to design, implement, deploy, and optimize an advanced object-persistence and object-transformation layer that supports a variety of data sources and formats, including the following:
-
JPA – For object-relational persistence, supporting the JPA (Java Persistence API) specification and a native API
-
NoSQL – For object persistence of non-relational NoSQL and EIS databases through JPA and a native API
-
JAXB – For object-XML transformation, supporting the JAXB (Java Architecture for XML Binding) specification and a native API
-
JSON – For object-JSON (JavaScript Object Notation) transformation
-
DBWS – For generation of web services from database tables and stored procedures
The TopLink native API includes:
-
Relational – For transactional persistence of Java objects to a relational database accessed using Java Database Connectivity (JDBC) drivers.
-
Object-Relational Data Type – For transactional persistence of Java objects to special-purpose structured data source representations optimized for storage in object-relational data type databases such as Oracle Database.
-
Enterprise information system (EIS) – For transactional persistence of Java objects to a non-relational data source accessed using a Java EE Connector architecture (JCA) adapter and any supported EIS record type, including indexed, mapped, or XML.
-
XML – For non-transactional, non-prescription (in-memory) conversion between Java objects and XML Schema Document (XSD)-based XML documents using Java Architecture for XML Binding (JAXB).
Oracle TopLink lets you quickly capture and define object-to-data source and object-to-data representation mappings in a flexible, efficient metadata format.
The Oracle TopLink runtime lets your application exploit this mapping metadata with a simple session facade that provides in-depth support for standard APIs such as JPA, and JAXB as well as TopLink-specific extensions to those standards.
Review Understanding Oracle TopLink for more information about TopLink.
About This Documentation
Oracle TopLink includes EclipseLink, the reference implementation of the Java Persistence Architecture (JPA) 2.2 specification, as its persistence provider. It also includes many enhancements and extensions.
EclipseLink is the reference implementation of the Java Persistence Architecture (JPA) 2.2 specification It also includes many enhancements and extensions.
This document explains the TopLink enhancements and extensions to JPA. Please refer to the JPA specification for full documentation of core JPA. Where appropriate, this documentation provides links to the pertinent section of the specification.
Other Resources
For more information, see:
-
Java Persistence specification for complete information about JPA,
http://jcp.org/en/jsr/detail?id=338
-
EclipseLink Documentation Center for more information about EclipseLink support of JPA,
http://www.eclipse.org/eclipselink/documentation/
-
The EclipseLink API reference documentation (Javadoc) for complete information on core JPA plus the EclipseLink enhancements,
http://www.eclipse.org/eclipselink/api/
-
The schema for the JPA persistence configuration file,
https://www.oracle.com/webfolder/technetwork/jsc/xml/ns/persistence/persistence_2_1.xsd
-
The schema for the persistence object/relational mapping file,
https://www.oracle.com/webfolder/technetwork/jsc/xml/ns/persistence/orm_2_1.xsd
-
The schema for the native EclipseLink mapping file,
http://www.eclipse.org/eclipselink/xsds/eclipselink_orm_2_2.xsd
-
-
Examples that display the use of a number of EclipseLink JPA features,
http://wiki.eclipse.org/EclipseLink/Examples
-
JavaEE and JPA tutorial. Although this tutorial does not include TopLink-specific information, it does contain useful information to help you implement JPA 2.1 applications,
https://docs.oracle.com/javaee/7/tutorial/partpersist.htm#BNBPY
-
Java Persistence, a wiki-based "open book" about JPA 2.1,
https://en.wikibooks.org/wiki/Java_Persistence/What_is_new_in_JPA_2.1%3F