Jump to: navigation, search

Difference between revisions of "EclipseLink/Maven"

(Identifiers)
Line 22: Line 22:
 
</source>
 
</source>
  
== Identifiers  ==
+
== <dependencies> ==
  
=== Group Id: org.eclipse.persistence  ===
+
{|{{BMTableStyle}}
 
+
|-{{BMTHStyle}}
{|
+
|-
+
 
! Artifact Id  
 
! Artifact Id  
 
! Description
 
! Description
|-
 
| javax.persistence
 
| EclipseLink version of the javax.persistence classes (OSGi enabled)
 
|-
 
| org.eclipse.persistence.equinox
 
| EclipseLink JPA - Equinox OSGi Fragment
 
|-
 
| org.eclipse.persistence.jpa.modelgen.processor
 
| EclipseLink JPA Modelgen Processor (non-OSGi) (Meta-data only)
 
|-
 
| org.eclipse.persistence.tools.oracleddl
 
| Oracle DB model - OSGi bundle
 
|-
 
| org.eclipse.persistence.weaving
 
| EclipseLink JPA - "Weaving for Equinox" OSGi Fragment
 
|-
 
| <br>
 
 
|-
 
|-
 
| eclipselink  
 
| eclipselink  
Line 86: Line 67:
 
| org.eclipse.persistence.sdo  
 
| org.eclipse.persistence.sdo  
 
| EclipseLink SDO OSGI bundle
 
| EclipseLink SDO OSGI bundle
|}
 
 
=== Runtime Dependencies (from Orbit)  ===
 
 
{|
 
 
|-
 
|-
! Group Id
+
| javax.persistence
! Artifact Id
+
| EclipseLink version of the javax.persistence classes (OSGi enabled)
! Description
+
 
|-
 
|-
| commonj.sdo
+
| org.eclipse.persistence.equinox
| commonj.sdo
+
| EclipseLink JPA Equinox OSGi Fragment
| OSGI-enabled SDO API bundle
+
 
|-
 
|-
| javax.activation
+
| org.eclipse.persistence.jpa.modelgen.processor
| javax.activation
+
| EclipseLink JPA Modelgen Processor (non-OSGi) (Meta-data only)
| OSGI-enabled javax.activation API bundle
+
 
|-
 
|-
| javax.mail
+
| org.eclipse.persistence.tools.oracleddl
| javax.mail
+
| Oracle DB model - OSGi bundle
| OSGI-enabled javax.mail bundle
+
 
|-
 
|-
| javax.servlet
+
| org.eclipse.persistence.weaving
| javax.servlet
+
| EclipseLink JPA - "Weaving for Equinox" OSGi Fragment
| 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  ==
 
== What bundles should I get  ==

Revision as of 11:48, 22 August 2012

The EclipseLink project currently produces a maven repository for its releases

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

Configuring your pom.xml

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

<repository>

Within your pom.xml you will need to specify the EclipseLink repository using:

<repository>
   <id>EclipseLink Repo</id>
   <url>http://download.eclipse.org/rt/eclipselink/maven.repo</url>
</repository>

<dependencies>

Artifact Id Description
eclipselink The non-OSGI EclipseLink jar (includes the functionality below)
org.eclipse.persistence.antlr EclipseLink ANTLR OSGI bundle
org.eclipse.persistence.asm EclipseLink ASM OSGI bundle
org.eclipse.persistence.core EclipseLink Core OSGI bundle
org.eclipse.persistence.dbws EclipseLink DBWS OSGI bundle
org.eclipse.persistence.jpa EclipseLink JPA OSGI bundle
org.eclipse.persistence.jpa.modelgen EclipseLink Modelgen pre-processor (non-OSGI)
org.eclipse.persistence.moxy EclipseLink MOXY OSGI bundle
org.eclipse.persistence.nosql OSGI fragment of Core bundle for NoSQL support (including MongoDB)
org.eclipse.persistence.oracle OSGI fragment of Core bundle with Oracle-DB specific EclipseLink extensions
org.eclipse.persistence.oracle.nosql OSGI fragment of Core bundle for Oracle specific NoSQL support
org.eclipse.persistence.osgi
org.eclipse.persistence.sdo EclipseLink SDO OSGI bundle
javax.persistence EclipseLink version of the javax.persistence classes (OSGi enabled)
org.eclipse.persistence.equinox EclipseLink JPA Equinox OSGi Fragment
org.eclipse.persistence.jpa.modelgen.processor EclipseLink JPA Modelgen Processor (non-OSGi) (Meta-data only)
org.eclipse.persistence.tools.oracleddl Oracle DB model - OSGi bundle
org.eclipse.persistence.weaving EclipseLink JPA - "Weaving for Equinox" OSGi Fragment

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>