Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "EclipseLink/Maven"
(→) |
(→Issues With Nexus) |
||
| (12 intermediate revisions by 2 users not shown) | |||
| Line 17: | Line 17: | ||
<source lang="xml"> | <source lang="xml"> | ||
<repository> | <repository> | ||
| − | <id>EclipseLink | + | <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 45: | Line 45: | ||
|- | |- | ||
| eclipselink | | eclipselink | ||
| − | | The full eclipselink.jar | + | | The full eclipselink.jar (non-OSGi) including the full capabilities of all of the following artifact bundles and fragments. |
| javax.persistence<br/>commonj.sdo | | javax.persistence<br/>commonj.sdo | ||
| [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/eclipselink/2.4.0/eclipselink-2.4.0.pom POM] | | [http://download.eclipse.org/rt/eclipselink/maven.repo/org/eclipse/persistence/eclipselink/2.4.0/eclipselink-2.4.0.pom POM] | ||
|- | |- | ||
| org.eclipse.persistence.jpa | | org.eclipse.persistence.jpa | ||
| − | | EclipseLink JPA: 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. | + | | 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 | | javax.persistence<br/>org.eclipse.persistence.asm<br/>org.eclipse.persistence.antlr<br/>org.eclipse.persistence.jpa.jpql<br/>org.eclipse.persistence.core | ||
| [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] | | [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] | ||
|- | |- | ||
| org.eclipse.persistence.moxy | | org.eclipse.persistence.moxy | ||
| − | | EclipseLink MOXy: Use this artifact if you only want EclipseLink's Object-XML binding and JAXB implementation. This also includes JSON binding support. | + | | 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 | | 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] | | [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 | ||
| − | | EclipseLink NoSQL: | + | | 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 | ||
| − | | | + | | 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 | + | | 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 | | org.eclipse.persistence.dbws | ||
| Line 93: | Line 99: | ||
|} | |} | ||
| − | == | + | == Versions == |
| − | + | 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]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
== Sample pom.xml == | == Sample pom.xml == | ||
| Line 237: | Line 167: | ||
</project> | </project> | ||
</source> | </source> | ||
| + | |||
| + | == Issues With Nexus == | ||
| + | |||
| + | The current repository have some issues when used with Nexus. Here are some [http://wiki.eclipse.org/EclipseLink/Maven/Nexus workarounds]. | ||
[[Category:EclipseLink|Maven]] | [[Category:EclipseLink|Maven]] | ||
Revision as of 11:07, 17 October 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</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
The following pom.xml is from an EclipseLink example that uses JPA to access a MySQL database and leverages JUnit for testing.
<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>org.eclipse.persistence.example</groupId> <artifactId>Employee</artifactId> <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> <repository> <id>EclipseLink</id> <url>http://download.eclipse.org/rt/eclipselink/maven.repo</url> </repository> </repositories> <dependencies> <!-- eclipselink.jar with dependencies except commonj.sdo --> <dependency> <groupId>org.eclipse.persistence</groupId> <artifactId>eclipselink</artifactId> <version>${eclipselink.version}</version> <exclusions> <exclusion> <artifactId>commonj.sdo</artifactId> <groupId>commonj.sdo</groupId> </exclusion> </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> </dependencies> <build> ... </build> </project>
Issues With Nexus
The current repository have some issues when used with Nexus. Here are some workarounds.