Difference between revisions of "EclipseLink/Maven"

Revision as of 12:38, 22 August 2012

The EclipseLink project currently produces a maven repository for its releases

http://download.eclipse.org/rt/eclipselink/maven.repo

Example POM

To help users diagnose Maven issues, we have created a basic POM that simply establishes EclipseLink dependencies (currenly using the 2.4.0 release). Executing it will verify your connection to the repository. Alternate Repository URLs are discussed. The POM can be found [here].

If you have any questions about using it, or experience problems, please let us know on our users mailing list or forum.

Identifiers

Group Id: org.eclipse.persistence

Runtime Dependencies (from Orbit)

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

• 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

• 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

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

Versioning

Available Released Versions

• 2.4.0
• 2.3.3
• 2.3.2
• 2.3.1
• 2.3.0
• 2.2.1
• 2.2.0
• 2.1.3
• 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.5.0
• 2.4.1
• 2.3.4

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>