Jump to: navigation, search

Difference between revisions of "EclipseLink/Maven"

(Sample pom.xml entries)
m
(31 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
__TOC__  
 
__TOC__  
 
</div> </div>
 
</div> </div>
The EclipseLink project currently produces a maven repository for its releases
+
The EclipseLink project currently produces a maven repository for its nightly, milestone, and release builds.
  
<div align="center">'''http://download.eclipse.org/rt/eclipselink/maven.repo'''</div>
+
<div align="center">'''https://oss.sonatype.org/content/groups/staging'''</div>
 +
 
 +
<div align="center">[https://oss.sonatype.org/index.html#nexus-search;gav~org.eclipse.persistence Browse Repo]</div>
  
 
If you have any questions about using it, or experience problems, please let us know on our users mailing list or forum.  
 
If you have any questions about using it, or experience problems, please let us know on our users mailing list or forum.  
Line 12: Line 14:
 
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 [[http://www.eclipse.org/downloads/download.php?file=/rt/eclipselink/pom.xml here]].  
 
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 [[http://www.eclipse.org/downloads/download.php?file=/rt/eclipselink/pom.xml here]].  
  
=== <repository> ===
+
=== Repositories ===
 +
 
 +
Within your pom.xml you will need to specify the EclipseLink repository (within <repositories>).
 +
 
 +
==== oss.sonatype.org: 2.4.2 and Later ====
 +
 
 +
The EclipseLink project has switched to publishing its builds through oss.sonatype org during the 2.4.2/2.5.0 development. The staging repo will provide access to SNAPSHOT and named milestone and release candidate builds. To access these use:
  
Within your pom.xml you will need to specify the EclipseLink repository using:
 
 
<source lang="xml">
 
<source lang="xml">
 
<repository>
 
<repository>
   <id>EclipseLink Repo</id>
+
<id>oss.sonatype.org</id>
 +
<name>OSS Sonatype Staging</name>
 +
<url>https://oss.sonatype.org/content/groups/staging</url>
 +
</repository>
 +
</source>
 +
 
 +
When the 2.4.2 and above releases are finalized they will be published to [http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.eclipse.persistence%22 Maven Central] where no additional  repository configuration will be required.
 +
 
 +
==== Custom Repo: 2.4 and Earlier ====
 +
 
 +
For builds prior to EclipseLink 2.5 please use:
 +
 
 +
<source lang="xml">
 +
<repository>
 +
   <id>EclipseLink</id>
 
   <url>http://download.eclipse.org/rt/eclipselink/maven.repo</url>
 
   <url>http://download.eclipse.org/rt/eclipselink/maven.repo</url>
 
</repository>
 
</repository>
Line 27: Line 48:
  
 
<source lang="xml">
 
<source lang="xml">
<dependency>\
+
<dependency>
 
   <groupId>org.eclipse.persistence</groupId>
 
   <groupId>org.eclipse.persistence</groupId>
 
   <artifactId>{artifact}</artifactId>
 
   <artifactId>{artifact}</artifactId>
Line 34: Line 55:
 
</dependency>
 
</dependency>
 
</source>
 
</source>
 +
 +
The following are the primary artifacts. All listed dependencies are also included in this repository.
  
 
{|{{BMTableStyle}}
 
{|{{BMTableStyle}}
Line 39: Line 62:
 
! Artifact Id  
 
! Artifact Id  
 
! Description
 
! Description
 +
! Dependencies
 +
! 2.4.0 POM
 
|-
 
|-
 
| eclipselink  
 
| eclipselink  
| The non-OSGI EclipseLink jar (includes the functionality below)
+
| The full eclipselink.jar (non-OSGi) including the full capabilities of all of the following artifact bundles and fragments.
|-
+
| javax.persistence<br/>commonj.sdo
| org.eclipse.persistence.antlr
+
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/eclipselink/2.4.0/eclipselink-2.4.0.pom POM]
| EclipseLink's 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  
 
| org.eclipse.persistence.jpa  
| EclipseLink JPA OSGI bundle
+
| EclipseLink JPA (OSGi bundle): Use this artifact if you only want EclipseLink's JPA capabilities for relational databases. If accessing an Oracle database then you will also want the '''org.eclipse.persistence.oracle''' artifact.
|-
+
| javax.persistence<br/>org.eclipse.persistence.asm<br/>org.eclipse.persistence.antlr<br/>org.eclipse.persistence.jpa.jpql<br/>org.eclipse.persistence.core
| org.eclipse.persistence.jpa.modelgen
+
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/org.eclipse.persistence.jpa/2.4.0/org.eclipse.persistence.jpa-2.4.0.pom POM]
| EclipseLink Modelgen pre-processor (non-OSGI)
+
 
|-
 
|-
 
| org.eclipse.persistence.moxy  
 
| org.eclipse.persistence.moxy  
| EclipseLink MOXY OSGI bundle
+
| EclipseLink MOXy (OSGi bundle): Use this artifact if you only want EclipseLink's Object-XML binding and JAXB implementation. This also includes JSON binding support.
 +
| org.eclipse.persistence.core
 +
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/org.eclipse.persistence.moxy/2.4.0/org.eclipse.persistence.moxy-2.4.0.pom POM]
 
|-
 
|-
 
| org.eclipse.persistence.nosql  
 
| org.eclipse.persistence.nosql  
| OSGI fragment of Core bundle for NoSQL support (including MongoDB)
+
| EclipseLink NoSQL (OSGi fragment): Provides NoSQL support extending org.eclipse.persistence.core.
 +
| javax.persistence<br/>org.eclipse.persistence.asm<br/>org.eclipse.persistence.antlr<br/>org.eclipse.persistence.jpa.jpql<br/>org.eclipse.persistence.core<br/>
 +
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/org.eclipse.persistence.nosql/2.4.0/org.eclipse.persistence.nosql-2.4.0.pom POM]
 
|-
 
|-
 
| org.eclipse.persistence.oracle  
 
| org.eclipse.persistence.oracle  
| OSGI fragment of Core bundle with Oracle-DB specific EclipseLink extensions
+
| EclipseLink JPA for Oracle (OSGi fragment): Extended Oracle database capabilities extending the core bundle with specific Oracle JDBC dependencies.
 +
| javax.persistence<br/>org.eclipse.persistence.asm<br/>org.eclipse.persistence.core
 +
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/org.eclipse.persistence.oracle/2.4.0/org.eclipse.persistence.oracle-2.4.0.pom POM]
 
|-
 
|-
 
| org.eclipse.persistence.oracle.nosql  
 
| org.eclipse.persistence.oracle.nosql  
| OSGI fragment of Core bundle for Oracle specific NoSQL support
+
| EclipseLink NoSQL for Oracle (OSGI fragment): Oracle specific NoSQL support extending core bundle.
 +
| javax.persistence<br/>org.eclipse.persistence.asm<br/>org.eclipse.persistence.antlr<br/>org.eclipse.persistence.jpa.jpql<br/>org.eclipse.persistence.core<br/>org.eclipse.persistence.nosql
 +
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/org.eclipse.persistence.oracle.nosql/2.4.0/org.eclipse.persistence.oracle.nosql-2.4.0.pom POM]
 +
|-
 +
| org.eclipse.persistence.dbws
 +
| EclipseLink DBWS OSGI bundle
 +
|-
 +
| org.eclipse.persistence.jpa.modelgen
 +
| EclipseLink Modelgen pre-processor (non-OSGI)
 
|-
 
|-
 
| org.eclipse.persistence.osgi  
 
| org.eclipse.persistence.osgi  
Line 78: Line 106:
 
| org.eclipse.persistence.sdo  
 
| org.eclipse.persistence.sdo  
 
| EclipseLink SDO OSGI bundle
 
| EclipseLink SDO OSGI bundle
|-
 
| javax.persistence
 
| EclipseLink version of the javax.persistence classes (OSGi enabled)
 
 
|-
 
|-
 
| org.eclipse.persistence.equinox  
 
| org.eclipse.persistence.equinox  
Line 95: Line 120:
 
|}
 
|}
  
== What bundles should I get ==
+
== Versions ==
  
The following lists what you should get based on your needs
+
For the available EclipseLink release versions please refer to the [http://www.eclipse.org/eclipselink/releases/ releases page]. It is the 3 digit number that is used. For access to nightly or milestone builds please see [[EclipseLink/Maven/NightlyMilestones]]
  
==== Full functionality - non OSGI ====
+
== Sample pom.xml (Staging) ==
  
This is the recommended way of getting EclipseLink unless you are using OSGi, or you want to explicitly exclude certain parts of EclipseLink
+
The following pom.xml illustrates access the EclipseLink 2.5.0-RC1 from our staging repository.
 
+
*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''
+
 
+
*&lt;releaseNumber&gt;-SNAPSHOT (The most recent nightly build e.g. 2.1.0-SNAPSHOT)
+
*&lt;releaseNumber&gt;-Mx (For milestones, replace x with the milestone number e.g. 2.0.0-M1)
+
*&lt;releaseNumber&gt;-RCx (For release candidates, replace x with the release candidate number e.g. 2.0.0-RC1)
+
 
+
== Sample pom.xml  ==
+
 
+
The following pom.xml is from an EclipseLink example that uses JPA to access a MySQL database and leverages JUnit for testing.
+
  
 
<source lang="xml">
 
<source lang="xml">
 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 
<modelVersion>4.0.0</modelVersion>
 
<modelVersion>4.0.0</modelVersion>
 
+
<groupId>eclipselink.example.jpa</groupId>
<groupId>org.eclipse.persistence.example</groupId>
+
<artifactId>simple</artifactId>
<artifactId>Employee</artifactId>
+
<version>2.5.0-SNAPSHOT</version>
<version>0.0.1-SNAPSHOT</version>
+
<packaging>jar</packaging>
+
 
+
<name>Employee Example</name>
+
<url>http://wiki.eclipse.org/EclipseLink/Examples/JPA/Employee</url>
+
<description>Simple JPA example using annotations.</description>
+
 
+
<properties>
+
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+
<eclipselink.version>2.4.0</eclipselink.version>
+
</properties>
+
 
+
 
<repositories>
 
<repositories>
 
<repository>
 
<repository>
<id>EclipseLink</id>
+
<id>oss.sonatype.org</id>
<url>http://download.eclipse.org/rt/eclipselink/maven.repo</url>
+
<name>OSS Sonatype Staging</name>
 +
<url>https://oss.sonatype.org/content/groups/staging</url>
 
</repository>
 
</repository>
 
</repositories>
 
</repositories>
 
+
 
<dependencies>
 
<dependencies>
 
<!-- eclipselink.jar with dependencies except commonj.sdo -->
 
 
<dependency>
 
<dependency>
 
<groupId>org.eclipse.persistence</groupId>
 
<groupId>org.eclipse.persistence</groupId>
 
<artifactId>eclipselink</artifactId>
 
<artifactId>eclipselink</artifactId>
<version>${eclipselink.version}</version>
+
<version>2.5.0-RC1</version>
 
<exclusions>
 
<exclusions>
 
<exclusion>
 
<exclusion>
 +
<groupId>org.eclipse.persistence</groupId>
 
<artifactId>commonj.sdo</artifactId>
 
<artifactId>commonj.sdo</artifactId>
<groupId>commonj.sdo</groupId>
 
 
</exclusion>
 
</exclusion>
 
</exclusions>
 
</exclusions>
</dependency>
 
 
<dependency>
 
<groupId>mysql</groupId>
 
<artifactId>mysql-connector-java</artifactId>
 
<version>5.1.21</version>
 
</dependency>
 
 
<dependency>
 
<groupId>junit</groupId>
 
<artifactId>junit</artifactId>
 
<version>4.8.2</version>
 
 
</dependency>
 
</dependency>
 
</dependencies>
 
</dependencies>
 +
</project>
 +
</source>
  
<build>
+
== Issues With Nexus ==
<plugins>
+
<plugin>
+
<groupId>org.apache.maven.plugins</groupId>
+
<artifactId>maven-compiler-plugin</artifactId>
+
<version>2.5.1</version>
+
<configuration>
+
<source>1.6</source>
+
<target>1.6</target>
+
</configuration>
+
</plugin>
+
  
<plugin>
+
The current repository have some issues when used with Nexus. Here are some [http://wiki.eclipse.org/EclipseLink/Maven/Nexus  workarounds].
<groupId>org.apache.maven.plugins</groupId>
+
<artifactId>maven-surefire-plugin</artifactId>
+
<version>2.10</version>
+
<configuration>
+
<test>tests.AllTests</test>
+
<argLine>-javaagent:${user.home}\.m2\repository\org\eclipse\persistence\eclipselink\2.4.0\eclipselink-2.4.0.jar</argLine>
+
</configuration>
+
</plugin>
+
</plugins>
+
</build>
+
 
+
</project>
+
</source>
+
  
 
[[Category:EclipseLink|Maven]]
 
[[Category:EclipseLink|Maven]]

Revision as of 15:48, 7 May 2013

The EclipseLink project currently produces a maven repository for its nightly, milestone, and release builds.

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

Repositories

Within your pom.xml you will need to specify the EclipseLink repository (within <repositories>).

oss.sonatype.org: 2.4.2 and Later

The EclipseLink project has switched to publishing its builds through oss.sonatype org during the 2.4.2/2.5.0 development. The staging repo will provide access to SNAPSHOT and named milestone and release candidate builds. To access these use:

<repository>
	<id>oss.sonatype.org</id>
	<name>OSS Sonatype Staging</name>
	<url>https://oss.sonatype.org/content/groups/staging</url>
</repository>

When the 2.4.2 and above releases are finalized they will be published to Maven Central where no additional repository configuration will be required.

Custom Repo: 2.4 and Earlier

For builds prior to EclipseLink 2.5 please use:

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

<dependencies>

The artifacts can then be added to you pom as follows. The complete list of available artifacts and their usage is below.

<dependency>
   <groupId>org.eclipse.persistence</groupId>
   <artifactId>{artifact}</artifactId>
   <version>{version}</version>
   <scope>compile</scope>
</dependency>

The following are the primary artifacts. All listed dependencies are also included in this repository.

Artifact Id Description Dependencies 2.4.0 POM
eclipselink The full eclipselink.jar (non-OSGi) including the full capabilities of all of the following artifact bundles and fragments. javax.persistence
commonj.sdo
POM
org.eclipse.persistence.jpa EclipseLink JPA (OSGi bundle): Use this artifact if you only want EclipseLink's JPA capabilities for relational databases. If accessing an Oracle database then you will also want the org.eclipse.persistence.oracle artifact. javax.persistence
org.eclipse.persistence.asm
org.eclipse.persistence.antlr
org.eclipse.persistence.jpa.jpql
org.eclipse.persistence.core
POM
org.eclipse.persistence.moxy EclipseLink MOXy (OSGi bundle): Use this artifact if you only want EclipseLink's Object-XML binding and JAXB implementation. This also includes JSON binding support. org.eclipse.persistence.core POM
org.eclipse.persistence.nosql EclipseLink NoSQL (OSGi fragment): Provides NoSQL support extending org.eclipse.persistence.core. javax.persistence
org.eclipse.persistence.asm
org.eclipse.persistence.antlr
org.eclipse.persistence.jpa.jpql
org.eclipse.persistence.core
POM
org.eclipse.persistence.oracle EclipseLink JPA for Oracle (OSGi fragment): Extended Oracle database capabilities extending the core bundle with specific Oracle JDBC dependencies. javax.persistence
org.eclipse.persistence.asm
org.eclipse.persistence.core
POM
org.eclipse.persistence.oracle.nosql EclipseLink NoSQL for Oracle (OSGI fragment): Oracle specific NoSQL support extending core bundle. javax.persistence
org.eclipse.persistence.asm
org.eclipse.persistence.antlr
org.eclipse.persistence.jpa.jpql
org.eclipse.persistence.core
org.eclipse.persistence.nosql
POM
org.eclipse.persistence.dbws EclipseLink DBWS OSGI bundle
org.eclipse.persistence.jpa.modelgen EclipseLink Modelgen pre-processor (non-OSGI)
org.eclipse.persistence.osgi
org.eclipse.persistence.sdo EclipseLink SDO OSGI bundle
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

Versions

For the available EclipseLink release versions please refer to the releases page. It is the 3 digit number that is used. For access to nightly or milestone builds please see EclipseLink/Maven/NightlyMilestones

Sample pom.xml (Staging)

The following pom.xml illustrates access the EclipseLink 2.5.0-RC1 from our staging repository.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>eclipselink.example.jpa</groupId>
	<artifactId>simple</artifactId>
	<version>2.5.0-SNAPSHOT</version>
 
	<repositories>
		<repository>
			<id>oss.sonatype.org</id>
			<name>OSS Sonatype Staging</name>
			<url>https://oss.sonatype.org/content/groups/staging</url>
		</repository>
	</repositories>
 
	<dependencies>
		<dependency>
			<groupId>org.eclipse.persistence</groupId>
			<artifactId>eclipselink</artifactId>
			<version>2.5.0-RC1</version>
			<exclusions>
				<exclusion>
					<groupId>org.eclipse.persistence</groupId>
					<artifactId>commonj.sdo</artifactId>
				</exclusion>
			</exclusions>
		</dependency>
	</dependencies>
</project>

Issues With Nexus

The current repository have some issues when used with Nexus. Here are some workarounds.