Difference between revisions of "EclipseLink/Maven"

From Eclipsepedia

Jump to: navigation, search
(Group Id: org.eclipse.persistence)
(Group Id: org.eclipse.persistence)
Line 13: Line 13:
 
! Artifact Id
 
! Artifact Id
 
! Description
 
! Description
 +
|-
 +
| javax.persistence || EclipseLink version of the javax.persistence classes (OSGi enabled)
 +
|-
 +
|
 
|-
 
|-
 
| eclipselink || The non-OSGI EclipseLink jar (includes the functionality below)
 
| eclipselink || The non-OSGI EclipseLink jar (includes the functionality below)
Line 31: Line 35:
 
|-  
 
|-  
 
| org.eclipse.persistence.oracle || OSGI fragment bundle with Oracle-DB specific EclipseLink extensions
 
| org.eclipse.persistence.oracle || OSGI fragment bundle with Oracle-DB specific EclipseLink extensions
|-
 
|
 
|-
 
| javax.persistence || EclipseLink version of the javax.persistence classes (OSGi enabled)
 
 
|}
 
|}
  

Revision as of 15:24, 3 January 2012

Contents

Location

The use of the Eclipse mirrors for Maven repositories has been reported to cause varying issues from artifacts being reported as unavailable to local maven repository corruption. Therefore, instead of using the mirrored download URL:

it is recommended that you use the unmirrored URL to directly access the EclipseLink Maven repository on the Eclipse download site instead:

Identifiers

Group Id: org.eclipse.persistence

Artifact Id Description
javax.persistence EclipseLink version of the javax.persistence classes (OSGi enabled)
eclipselink The non-OSGI EclipseLink jar (includes the functionality below)
org.eclipse.persistence.core EclipseLink core OSGI bundle
org.eclipse.persistence.jpa EclipseLink JPA OSGI bundle
org.eclipse.persistence.moxy EclipseLink MOXY OSGI bundle
org.eclipse.persistence.sdo EclipseLink SDO OSGI bundle
org.eclipse.persistence.dbws EclipseLink DBWS OSGI bundle
org.eclipse.persistence.asm EclipseLink ASM OSGI bundle
org.eclipse.persistence.antlr EclipseLink ANTLR OSGI bundle
org.eclipse.persistence.oracle OSGI fragment bundle with Oracle-DB specific EclipseLink extensions

Runtime Dependencies (from Orbit)

Group Id Artifact Id Description
commonj.sdo commonj.sdo OSGI-enabled SDO API bundle
javax.activation javax.activation OSGI-enabled javax.activation API bundle
javax.mail javax.mail OSGI-enabled javax.mail bundle
javax.servlet javax.servlet OSGI-enabled javax.servlet bundle
javax.xml.bind javax.xml.bind OSGI-enabled javax.xml.bind bundle
javax.xml.stream javax.xml.stream OSGI-enabled javax.xml.stream bundle


What bundles should I get

The following lists what you should get based on your needs

Full functionality - non OSGI

This is the recommended way of getting EclipseLink unless you are using OSGi, or you want to explicitly exclude certain parts of EclipseLink

  • eclipselink
  • javax.persistence (optional - only needed if you are using JPA outside of a Java EE container)

JPA Only

  • JPA
  • Core (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Antlr (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Asm (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • javax.persistence
  • Oracle (optional - only needed to access Oracle DB specific functionality)

MOXy Only

  • MOXy
  • Core (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Antlr (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Asm (starting in 2.0.0 should be retrieved by maven dependency mechanism)

SDO Only

  • SDO
  • MOXy
  • Core (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Antlr (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Asm (starting in 2.0.0 should be retrieved by maven dependency mechanism)

Core Only

  • Core (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Antlr (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Asm (starting in 2.0.0 should be retrieved by maven dependency mechanism)
  • Oracle (optional - only needed to access Oracle DB specific functionality)

Versioning

Available Released Versions

  • 2.2.0
  • 2.1.2
  • 2.1.1
  • 2.1.0
  • 2.0.2
  • 2.0.1
  • 2.0.0
    • JPA 2.0 Implementation release
  • 1.2.0
  • 1.1.4
    • final 1.1.x patchset
  • 1.1.3
  • 1.1.2
    • Eclipse Galileo Release
  • 1.1.1
  • 1.1.0
  • 1.0.2
  • 1.0.1
  • 1.0

NOTE: javax.persistence (JPA 2.0) has been released as version 2.0.0, 2.0.1, 2.0.2, and 2.0.3

Releases Under development

  • 2.3.0
  • 2.2.1
  • 2.1.3
  • 2.0.3
  • 1.2.1

Under development releases have the following additional naming conventions

  • <releaseNumber>-SNAPSHOT (The most recent nightly build e.g. 2.1.0-SNAPSHOT)
  • <releaseNumber>-Mx (For milestones, replace x with the milestone number e.g. 2.0.0-M1)
  • <releaseNumber>-RCx (For release candidates, replace x with the release candidate number e.g. 2.0.0-RC1)

Sample pom.xml entries


<dependencies>
  <dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>eclipselink</artifactId>
    <version>2.0.0</version>
    <scope>compile</scope>
       ...
  </dependency>
</dependencies>
      ...
<repositories>
  <repository>
     <id>EclipseLink Repo</id>
     <!-- note that ampersands in this URL are escaped because this is in an xml file -
            un-escape them to use in browser 
     -->
     <url>http://www.eclipse.org/downloads/download.php?r=1&amp;nf=1&amp;file=/rt/eclipselink/maven.repo</url>
     <!-- use this for javax.persistence
     <snapshots>
        <enabled>true</enabled>
     </snapshots> -->
  </repository>    
      ...
</repositories>