Difference between revisions of "EclipseLink/Maven"

Revision as of 10:59, 19 May 2011

Location

The use of the Eclipse mirrors for Maven repositories has been reported to cause problems. Instead of using the mirrored download URL, use this URL to access the EclipseLink Maven repository instead:

• http://www.eclipse.org/downloads/download.php?r=1&nf=1&file=/rt/eclipselink/maven.repo

Identifiers

• Group Id: org.eclipse.persistence

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>
     <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>