blob: 30c1123aa70ce56fa04fb170b0a1f8f02f96b28b [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<title>Introduction | EclipseLink 3.0.x Jakarta Persistence API (JPA) Extensions Reference</title>
<meta name="generator" content="Oracle DARB XHTML Converter (Mode = document) - Version 1.0.22 Build 1" />
<meta name="date" content="2014-06-10T10:29:48Z" />
<meta name="description" content="This chapter introduces EclipseLink. EclipseLink is an advanced, object-persistence and object-transformation framework that provides development tools and run-time capabilities that reduce development and maintenance efforts, and increase enterprise application functionality." />
<meta name="robots" content="noarchive" />
<meta name="doctitle" content="Introduction" />
<meta name="relnum" content="Release 3.0" />
<link rel="stylesheet" type="text/css" href="../../../dcommon/style.css" media="screen" />
<link rel="copyright" href="http://www.eclipse.org/org/documents/epl-v10.php" title="Copyright" type="text/html" />
<link rel="start" href="../../index.htm" title="Home" type="text/html" />
<link rel="contents" href="toc.htm" title="Contents" type="text/html" />
<link rel="prev" href="preface.htm" title="Previous" type="text/html" />
<link rel="next" href="annotations_ref.htm" title="Next" type="text/html" />
<!-- START: Disqus --><script type="text/javascript"> var disqus_developer = 0; </script><!-- END: Disqus --><!-- START: Sharethis --><script type="text/javascript">var switchTo5x=true;</script><script type="text/javascript" src="http://w.sharethis.com/button/buttons.js"></script><script type="text/javascript" src="http://s.sharethis.com/loader.js"></script> <!-- END: Sharethis --></head>
<body bgcolor="#FFFFFF"><iframe id="docheader" frameborder="0" framemargin="0" scrolling="no" src="../../../dcommon/header.html"></iframe><script src="http://www.google.com/jsapi" type="text/javascript"></script><script type="text/javascript"> google.load('search', '1', {language : 'en'}); google.setOnLoadCallback(function() { var customSearchOptions = {}; var googleAnalyticsOptions = {}; googleAnalyticsOptions['queryParameter'] = 'q'; googleAnalyticsOptions['categoryParameter'] = ''; customSearchOptions['googleAnalyticsOptions'] = googleAnalyticsOptions; var customSearchControl = new google.search.CustomSearchControl( '016171230611334810008:4sqnhke2any', customSearchOptions); customSearchControl.setResultSetSize(google.search.Search.FILTERED_CSE_RESULTSET); var options = new google.search.DrawOptions(); options.setSearchFormRoot('cse-search-form'); customSearchControl.draw('cse', options); }, true);</script><link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" /><div id="cse" style="width:100%;"></div>
<div class="header"><a id="top" name="top"></a>
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" valign="top"><div class="booktitle">Jakarta Persistence API (JPA) Extensions Reference for EclipseLink,
Release 3.0</div></td>
<td valign="bottom" align="right" width="144">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td>&nbsp;</td>
<td align="center" valign="top"><a href="toc.htm"><img src="../../../dcommon/images/contents.png" alt="Go To Table Of Contents" border="0" height="16" width="16" /><br />
</td><td>&nbsp;</td><td align="center"><a href="../../../" target="_top" class="external text" title="Search" rel="nofollow"><img src="../../../dcommon/images/search.png" alt="Search" style="border:0;" /><br /><span class="mini"></span></a></td><td>&nbsp;</td><td align="center"><a href="../../eclipselink_jpa_extensions.pdf" title="PDF" target="_blank"><img src="../../../dcommon/images/pdf_icon.png" style="padding-right:5px;border:0" alt="PDF"></a></td><td align="center"><a href="#disqus_thread" title="Comments""><img src="../../../dcommon/images/comments.png" style="padding-right:5px;border:0" alt="Comments"><br /><span class="mini">Comments</span></a>
</tr>
</table>
</td>
</tr>
</table>
<hr />
<table class="navigation simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100" align="center">
<tr>
<td align="center"><a href="preface.htm"><img src="../../../dcommon/images/larrow.png" alt="Previous" border="0" height="16" width="16" /></a></td>
<td align="center"><a href="annotations_ref.htm"><img src="../../../dcommon/images/rarrow.png" alt="Next" border="0" height="16" width="16" /></a></td>
<td>&nbsp;</td>
</tr>
</table>
</div>
<!-- class="header" -->
<div class="ind"><!-- End Header --><a id="TLJPA0302" name="TLJPA0302"></a> <a id="sthref6" name="sthref6"></a>
<h1 class="chapter"><font face="arial, helvetica, sans-serif" color="#330099"><span class="secnum">1</span> Introduction</font></h1>
<a id="TLJPA54052" name="TLJPA54052"></a>
<p>This chapter introduces EclipseLink. EclipseLink is an advanced, object-persistence and object-transformation framework that provides development tools and run-time capabilities that reduce development and maintenance efforts, and increase enterprise application functionality.</p>
<p>This chapter includes the following sections:</p>
<ul>
<li>
<p><a href="#CEGHCAJB">About EclipseLink</a></p>
</li>
<li>
<p><a href="#CHDEJIEC">About This Documentation</a></p>
</li>
</ul>
<a id="CEGHCAJB" name="CEGHCAJB"></a><a id="TLJPA303" name="TLJPA303"></a>
<div class="sect1"><!-- infolevel="all" infotype="General" -->
<h2 class="sect1"><font face="arial, helvetica, sans-serif" color="#330099">About EclipseLink</font></h2>
<p>EclipseLink is suitable for use with a wide range of Java Enterprise Edition (Jakarta EE) and Java application architectures. Use EclipseLink 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:</p>
<ul>
<li>
<p>JPA &ndash; For object-relational persistence, supporting the JPA (Jakarta Persistence API) specification and a native API</p>
</li>
<li>
<p>NoSQL &ndash; For object persistence of non-relational NoSQL and EIS databases through JPA and a native API</p>
</li>
<li>
<p>JAXB &ndash; For object-XML transformation, supporting the JAXB (Java Architecture for XML Binding) specification and a native API</p>
</li>
<li>
<p>JSON &ndash; For object-JSON (JavaScript Object Notation) transformation</p>
</li>
<li>
<p>DBWS &ndash; For generation of web services from database tables and stored procedures</p>
</li>
</ul>
<p>The EclipseLink native API includes:</p>
<ul>
<li>
<p>Relational &ndash; For transactional persistence of Java objects to a relational database accessed using Java Database Connectivity (JDBC) drivers.</p>
</li>
<li>
<p>Object-Relational Data Type &ndash; 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.</p>
</li>
<li>
<p>Enterprise information system (EIS) &ndash; For transactional persistence of Java objects to a non-relational data source accessed using a Jakarta EE Connector architecture (JCA) adapter and any supported EIS record type, including indexed, mapped, or XML.</p>
</li>
<li>
<p>XML &ndash; 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).</p>
</li>
</ul>
<p>EclipseLink includes support for EJB 3.0 and the Jakarta Persistence API (JPA) in Jakarta EE and Java SE environments including integration with a variety of application servers including:</p>
<ul>
<li>
<p>Oracle WebLogic Server</p>
</li>
<li>
<p>Oracle Glassfish Server</p>
</li>
<li>
<p>JBoss Web Server</p>
</li>
<li>
<p>IBM WebSphere application server</p>
</li>
<li>
<p>SAP NetWeaver</p>
</li>
<li>
<p>Oracle Containers for Jakarta EE (OC4J)</p>
</li>
<li>
<p>Various other web containers, such as Apache Tomcat, Eclipse Gemini, IBM WebSphere CE, and SpringSource tcServer</p>
</li>
</ul>
<p>EclipseLink lets you quickly capture and define object-to-data source and object-to-data representation mappings in a flexible, efficient metadata format.</p>
<p>The EclipseLink 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 EclipseLink-specific extensions to those standards.</p>
</div>
<!-- class="sect1" -->
<a id="CHDEJIEC" name="CHDEJIEC"></a><a id="TLJPA304" name="TLJPA304"></a>
<div class="sect1"><!-- infolevel="all" infotype="General" -->
<h2 class="sect1"><font face="arial, helvetica, sans-serif" color="#330099">About This Documentation</font></h2>
<p>EclipseLink is the reference implementation of the Java Persistence Architecture (JPA) 2.0 specification It also includes many enhancements and extensions.</p>
<p>This document explains the EclipseLink 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.</p>
<a id="TLJPA305" name="TLJPA305"></a>
<div class="sect2"><!-- infolevel="all" infotype="General" --><a id="sthref7" name="sthref7"></a>
<h3 class="sect2"><font face="arial, helvetica, sans-serif" color="#330099">Other Resources</font></h3>
<p>For more information, see:</p>
<ul>
<li>
<p>Java Persistence specification for complete information about JPA<code><a href="http://jcp.org/en/jsr/detail?id=317">http://jcp.org/en/jsr/detail?id=317</a></code></p>
</li>
<li>
<p>EclipseLink Documentation Center for more information about EclipseLink support of JPA. <code><a href="http://www.eclipse.org/eclipselink/documentation/">http://www.eclipse.org/eclipselink/documentation/</a></code></p>
</li>
<li>
<p>The EclipseLink API reference documentation (Javadoc) for complete information on core JPA plus the EclipseLink enhancements<code><a href="http://www.eclipse.org/eclipselink/api/">http://www.eclipse.org/eclipselink/api/</a></code></p>
<ul>
<li>
<p>The schema for the JPA persistence configuration file<code><a href="http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd</a></code></p>
</li>
<li>
<p>The schema for the persistence object/relational mapping file<code><a href="http://java.sun.com/xml/ns/persistence/orm_2_0.xsd">http://java.sun.com/xml/ns/persistence/orm_2_0.xsd</a></code></p>
</li>
<li>
<p>The schema for the native EclipseLink mapping file<code><a href="http://www.eclipse.org/eclipselink/xsds/eclipselink_orm_2_0.xsd">http://www.eclipse.org/eclipselink/xsds/eclipselink_orm_2_0.xsd</a></code></p>
</li>
</ul>
</li>
<li>
<p>Examples that display the use of a number of EclipseLink JPA features<code><a href="http://wiki.eclipse.org/EclipseLink/Examples/">http://wiki.eclipse.org/EclipseLink/Examples/</a></code></p>
</li>
<li>
<p>JavaEE and JPA tutorial. Although this tutorial does not include EclipseLink-specific information, it does contain useful information to help you implement JPA 2.0 applications. <code><a href="http://download.oracle.com/javaee/5/tutorial/doc/bnbpy.html">http://download.oracle.com/javaee/5/tutorial/doc/bnbpy.html</a></code></p>
</li>
<li>
<p>Java Persistence, a wiki-based "open book" about JPA 2.0<code><a href="http://en.wikibooks.org/wiki/Java_Persistence">http://en.wikibooks.org/wiki/Java_Persistence</a></code></p>
</li>
</ul>
</div>
<!-- class="sect2" --></div>
<!-- class="sect1" --></div>
<!-- class="ind" -->
<!-- Start Footer -->
<div class="footer">
<hr />
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100%">
<col width="33%" />
<col width="*" />
<col width="33%" />
<tr>
<td valign="bottom">
<table class="navigation simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="100" align="center">
<col width="*" />
<col width="48%" />
<col width="48%" />
<tr>
<td>&nbsp;</td>
<td align="center"><a href="preface.htm"><img src="../../../dcommon/images/larrow.png" alt="Previous" border="0" height="16" width="16" /></a></td>
<td align="center"><a href="annotations_ref.htm"><img src="../../../dcommon/images/rarrow.png" alt="Next" border="0" height="16" width="16" /></a></td>
</tr>
</table>
</td>
<td align="center" width="34%"><a href="http://www.eclipse.org/eclipselink/" title="EclipseLink home"><img src="../../../dcommon/images/ellogo.png" alt="EclipseLink" width="150" border="0" /></a><br />
</td>
<td valign="bottom" align="right">
<table class="simple oac_no_warn" summary="" cellspacing="0" cellpadding="0" width="225">
<tr>
<td>&nbsp;</td>
<td align="center" valign="top"><a href="toc.htm"><img src="../../../dcommon/images/contents.png" alt="Go To Table Of Contents" border="0" height="16" width="16" /><br />
</td><td>&nbsp;</td><td align="center"><a href="../../../" target="_top" class="external text" title="Search" rel="nofollow"><img src="../../../dcommon/images/search.png" alt="Search" style="border:0;" /><br /><span class="mini"></span></a></td><td>&nbsp;</td><td align="center"><a href="../../eclipselink_jpa_extensions.pdf" title="PDF" target="_blank"><img src="../../../dcommon/images/pdf_icon.png" style="padding-right:5px;border:0" alt="PDF"></a></td><td align="center"><a href="#disqus_thread" title="Comments""><img src="../../../dcommon/images/comments.png" style="padding-right:5px;border:0" alt="Comments"><br /><span class="mini">Comments</span></a>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!-- class="footer" -->
<div id="copyright">Copyright &copy; 2014 by The Eclipse Foundation under the <a href="http://www.eclipse.org/org/documents/epl-v10.php">Eclipse Public License (EPL)</a><br /> <script type="text/javascript">var LastUpdated = document.lastModified;document.writeln ("Updated: " + LastUpdated);</script> </div><!-- START: Analytics --><script type="text/javascript"> var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-1608008-2']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); </script><!-- END: Analytics --><!-- START: Sharethis --><script>var options={ "publisher": "e2fe9e07-fab6-4f84-83ea-0991b429842c", "position": "right", "ad": { "visible": false, "openDelay": 5, "closeDelay": 0}};var st_hover_widget = new sharethis.widgets.hoverbuttons(options);</script><!-- END: Sharethis --></body>
</html>