Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "EclipseLink/Dependencies"

(→‎Oracle JDBC)
(→‎Third Party Dependencies)
(64 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
The following is a list of Dependencies that EclipseLink requires to compile all components.   
 
The following is a list of Dependencies that EclipseLink requires to compile all components.   
 +
__TOC__
  
−
* [http://asm.objectweb.org/ ASM|]  
+
{|{{BMTableStyle}}
−
** Version: 1.5.3 + ojc patch
+
|-{{BMTHStyle}}
−
** internalized into org.eclipse.persistence.libraries.asm.  
+
! Library Name
−
** Required for lazy loading in JPA in a Java SE environment
+
! Version
−
** [http://asm.objectweb.org/license.html License]
+
! Files
−
* [http://www.antlr.org/ ANTLR]  
+
! License
−
** Version: 3.0
+
! IP Bug
−
** internalized into org.eclipse.persistence.antlr.  
+
! Notes
−
** Required for using JPQL.  
+
|-
−
** [http://www.antlr.org/license.html License]
+
| [http://asm.objectweb.org/ ASM] || 1.5.3 + ojc patch || none || [http://asm.objectweb.org/license.html License] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1605 APPROVED-1605] || Internalized into org.eclipse.persistence.internal.libraries.asm. Used for byte-code weaving of persistent classes
−
* JTA
+
|-
−
** Version 1.1
+
| [http://www.antlr.org/ ANTLR] || 3.0 || none || [http://www.antlr.org/license.html License]|| [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1695 APPROVED-1695] || Internalized into org.eclipse.persistence.internal.libraries.antlr. <br> Required for parsing JPQL.
−
** Only required when using JTA. Typically provided by host container offering JTA.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| JTA || 1.1 || jta.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1613 APPROVED-1613] || Only required when using JTA. Generally provided by host container.
−
* JMS
+
|-
−
** Version 1.1
+
| JMS || 1.1 || jms.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1614 APPROVED-1614] || Only required when using JMS cache coordination. Typically provided by host container.
−
** Only required when using JMS cache coordination. Typically provided by host container offering JMS or JMS provider.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| JPA (EJB 3.0)|| 1.0 || persistence.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1616 APPROVED-1616] || Only required when using JPA. Required in JavaSE but always included in JavaEE5 containers..
−
* JPA
+
|-
−
** Version 1.0  
+
| EJB || 3.0 || ejb.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1794 APPROVED-1794] || Only required for compilation of MessageDrivenBean code. Included in JavaEE5 containers.
−
** Only required when using JPA. Required for standalone usage but already included in host containers (EJB3/Spring).  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| [http://java.sun.com/j2ee/connector/download.html JavaEE Connector Architecture (JCA)] || 1.5 || connector.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0 ] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1621 APPROVED-1621] || Only required when using EIS data source support through JCA.
−
* JAXB
+
|-
−
** Version 2.0  
+
| [https://jaxb.dev.java.net JAXB API] || [https://jaxb.dev.java.net/2.0.3/ 2.0.3] || jaxb-api.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1617 APPROVED-1617] || Only required when using JAXB 2.0 (Not required for native OXM usage). Always included in JavaEE5 containers.
−
** Only required when using JAXB 2.0. Not required for native OXM usage. Always included in JavaEE5 containers.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| [https://jaxb.dev.java.net JAXB XJC] || [https://jaxb.dev.java.net/2.0.3/ 2.0.3] || jaxb-xjc.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1787 APPROVED-1787]|| Only required when using JAXB 2.0 Schema Compiler (Not required for native OXM usage). Always included in JavaEE5 containers.
−
* StAX
+
|-
−
** Version 1.0  
+
| [https://jaxb.dev.java.net JAXB RI] || [https://jaxb.dev.java.net/2.0.3/ 2.0.3] || jaxb-impl.jar  || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1788 APPROVED-1788]|| Only required when using JAXB 2.0 Schema Compiler (Not required for native OXM usage). Always included in JavaEE5 containers.
−
** Only required when using JAXB 2.0. Not required for native OXM usage. Always included in JavaEE5 containers.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| StAX <br>(Included in JAXB 2.0) || 1.0 || jsr173_1.0_api.jar  || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1618 APPROVED-1618] || Optional processing style in MOXy. <br>Always included in JavaEE5 containers.
−
* JavaMail API
+
|-
−
** Version 1.4
+
| Java Activation Framework <br>(Included in JAXB 2.0) || 1.1 || activation.jar || [http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1620 APPROVED-1620] || Required for Web Service attachment handling in MOXy.<br> Always included in JavaEE5 containers.<br> Available from [http://download.eclipse.org/tools/orbit/downloads/drops/R200709171314/bundles/javax.activation_1.1.0.v200706111329.jar Orbit]
−
** Only required when using JAXB 2.0. Not required for native OXM usage. Always included in JavaEE5 containers.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| [http://java.sun.com/products/javamail/downloads/index.html JavaMail] || 1.4 || mail.jar ||[http://www.sun.com/cddl/cddl.html CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1619 APPROVED-1619] || Required for Web Service attachment handling in MOXy.<br> Always included in JavaEE5 containers. <br> Available from [http://download.eclipse.org/tools/orbit/downloads/drops/R200706192011/bundles/javax.mail_1.4.0.v200706111329.jar Orbit]
−
* Java Activation Framework
+
|-
−
** Version 1.1
+
| [http://www.osoa.org/download/attachments/36/Java-SDO-Spec-v2.1.0-FINAL.pdf?version=1 Service Data Objects (SDO)] || 2.1 || commonj-sdo.jar || [http://www.osoa.org/download/attachments/36/Java-SDO-Spec-v2.1.0-FINAL.pdf?version=1 Custom License] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1622 APPROVED-1622] || Only required when using SDO functionality.
−
** Only required when using JAXB 2.0. Not required for native OXM usage. Always included in JavaEE5 containers.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
| [http://sourceforge.net/projects/wsdl4j WSDL4J] || 1.6.2 || wsdl4j.jar || [http://wsdl4j.cvs.sourceforge.net/*checkout*/wsdl4j/wsdl4j/license.html?revision=1.2 Common Public License 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=1701 APPROVED-1701] || Required by DBWS
−
* J2EE Connector
+
|-
−
** Version 1.4
+
| [https://saaj.dev.java.net SOAP with Attachments API for Java] || 1.3 || saaj-api-1.3.jar || [https://glassfish.dev.java.net/public/CDDL+GPL.html dual licensed GPL 2.0 and CDDL 1.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=2291 PARALLEL_IP/APPROVED_FOR_CHECKIN-2291] || Required by DBWS
−
** Only required when using JAXB 2.0. Not required for native OXM usage. Always included in JavaEE5 containers.  
+
|-
−
** [http://www.sun.com/cddl/cddl.html License]
+
|-
−
* Service Data Objects (SDO)  
+
| [http://xerces.apache.org/ Xerces] || 2.9.0 || xercesImpl.jar || [http://www.apache.org/licenses/LICENSE-2.0.html Apache Software License Version 2.0] || [https://dev.eclipse.org/ipzilla/show_bug.cgi?id=2046 APPROVED-2046] || Only required by Workbench Utility.
−
** Version 2.1  
+
|-
−
** Only required when using SDO functionality.
+
|}
−
** Custom License.  [http://www.osoa.org/download/attachments/36/Java-SDO-Spec-v2.1.0-FINAL.pdf?version=1 Link to Spec]
+
  
 
== Third Party Dependencies ==
 
== Third Party Dependencies ==
  
−
As per the [http://www.eclipse.org/org/documents/Eclipse_Policy_and_Procedure_for_3rd_Party_Dependencies_Final.pdf Policy and Procedure for 3rd Party Dependencies] the EclipseLink project has the following works-with dependencies.
+
As per the [http://www.eclipse.org/org/documents/Eclipse_Policy_and_Procedure_for_3rd_Party_Dependencies_Final.pdf Policy and Procedure for 3rd Party Dependencies] the EclipseLink project has the following works-with dependencies. EclipseLink's pre-req behavior is as documented in the [[EclipseLink/IPLog | IP Log]] working with standard data source access APIs and compatible implementations.
  
−
==== Oracle JDBC ====
+
The following dependencies are optional '''works-with''' capabilities available for those users who wish to access advanced features of the Oracle database and therefore have the corresponding libraries available from their database distribution. The functionality that leverages the additional features is isolated within SVN at: /foundation/org.eclipse.persistence.oracle . Both the Eclipse projects and ANT targets provided enable users to build and test EclipseLink without these optional dependencies or if they want to use these they can configure either Eclipse IDE variables or customize ANT properties files to provide the location of their works-with Oracle JDBC libraries.
−
* JDBC
+
−
** Library: ojdbc*.jar (various library options possible)
+
−
*** org.eclipse.persistence.platform.database.oracle.converters.JGeometryConverter
+
−
***
+
−
* Spatial
+
−
** Library: sdoapi.jar
+
−
*** org.eclipse.persistence.platform.database.oracle.converters.JGeometryConverter
+
−
* Oracle XDB
+
−
** Library: xmlparserv2.jar
+
−
** Oracle Database Platform extensions for XMLType conversions
+
−
*** org.eclipse.persistence.internal.platform.database.oracle.xdb.XMLTypeBindCallCustomParameter
+
−
*** org.eclipse.persistence.internal.platform.database.oracle.xdb.XMLTypeFactoryImpl
+
−
** Mapping (subclass of DirectToFieldMapping)
+
−
*** org.eclipse.persistence.mappings.xdb.DirectToXMLTypeMapping
+
−
* OracleAQ
+
−
** Library aqapi.jar
+
−
*** org.eclipse.persistence.internal.eis.adapters.aq.* (5 classes)
+
  
−
==== Oracle XDK ====
+
{|{{BMTableStyle}}
 +
|-{{BMTHStyle}}
 +
! Library
 +
! Jars
 +
! License
 +
! Notes
 +
|-
 +
| [http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html Oracle JDBC] || ojdbc*.jar || [http://www.oracle.com/technology/software/htdocs/devlic.html OTN] || org.eclipse.persistence.platform.database.oracle.Oracle8Platform <br> org.eclipse.persistence.platform.database.oracle.Oracle9Platform <br> org.eclipse.persistence.platform.database.oracle.Oracle10Platform <br> org.eclipse.persistence.internal.platform.database.oracle.XMLTypeFactory <br> org.eclipse.persistence.platform.database.oracle.converters.JGeometryConverter
 +
|-
 +
| [http://www.oracle.com/technology/software/products/spatial/index.html Oracle Spatial Java Class Library]  || sdoapi.jar || [http://www.oracle.com/technology/software/htdocs/devlic.html OTN] || org.eclipse.persistence.platform.database.oracle.converters.JGeometryConverter <br> Note: This version is for use with Oracle 10g Spatial 10.1.0.2, 10.1.0.1, 9iR2, 9iR1, and with JDK 1.4.2 or higher.
 +
|-
 +
| [http://www.oracle.com/technology/tech/xml/xdk/xdkprod10g.html Oracle XDK] || xml.jar <br> xmlparserv2.jar <br> xdb.jar || [http://www.oracle.com/technology/software/htdocs/devlic.html OTN] || XMLTypeBindCallCustomParameter & XMLTypeFactoryImpl (org.eclipse.persistence.internal.platform.database.oracle.xdb) <br> DirectToXMLTypeMapping(org.eclipse.persistence.mappings.xdb) <br> org.eclipse.persistence.platform.xml.xdk.* (5 classes)
 +
|-
 +
| [http://www.oracle.com/technology/products/dataint/index.html Oracle AQ] || aqapi.jar || [http://www.oracle.com/technology/software/htdocs/devlic.html OTN] || org.eclipse.persistence.internal.eis.adapters.aq.* (5 classes) <br> Note: Seems to only be available from the database distribution.
 +
|-
 +
| [http://www.oracle.com/technetwork/database/enterprise-edition/downloads/ucp-112010-099129.html Oracle UCP] || ucp.jar || [http://www.oracle.com/technology/software/htdocs/devlic.html OTN] || org.eclipse.persistence.platform.database.oracle.ucp.* (1 class) <br> Note: Seems to only be available from the database distribution.
 +
|-
 +
|}
  
−
* XML Platform
+
[[Category:EclipseLink|Dependencies]]
−
* Library: xdb.jar
+
−
* Classes:
+
−
** org.eclipse.persistence.platform.xml.xdk.* (5 classes)
+

Revision as of 11:13, 7 March 2011

The following is a list of Dependencies that EclipseLink requires to compile all components.

Library Name Version Files License IP Bug Notes
ASM 1.5.3 + ojc patch none License APPROVED-1605 Internalized into org.eclipse.persistence.internal.libraries.asm. Used for byte-code weaving of persistent classes
ANTLR 3.0 none License APPROVED-1695 Internalized into org.eclipse.persistence.internal.libraries.antlr.
Required for parsing JPQL.
JTA 1.1 jta.jar CDDL 1.0 APPROVED-1613 Only required when using JTA. Generally provided by host container.
JMS 1.1 jms.jar CDDL 1.0 APPROVED-1614 Only required when using JMS cache coordination. Typically provided by host container.
JPA (EJB 3.0) 1.0 persistence.jar CDDL 1.0 APPROVED-1616 Only required when using JPA. Required in JavaSE but always included in JavaEE5 containers..
EJB 3.0 ejb.jar CDDL 1.0 APPROVED-1794 Only required for compilation of MessageDrivenBean code. Included in JavaEE5 containers.
JavaEE Connector Architecture (JCA) 1.5 connector.jar CDDL 1.0 APPROVED-1621 Only required when using EIS data source support through JCA.
JAXB API 2.0.3 jaxb-api.jar CDDL 1.0 APPROVED-1617 Only required when using JAXB 2.0 (Not required for native OXM usage). Always included in JavaEE5 containers.
JAXB XJC 2.0.3 jaxb-xjc.jar CDDL 1.0 APPROVED-1787 Only required when using JAXB 2.0 Schema Compiler (Not required for native OXM usage). Always included in JavaEE5 containers.
JAXB RI 2.0.3 jaxb-impl.jar CDDL 1.0 APPROVED-1788 Only required when using JAXB 2.0 Schema Compiler (Not required for native OXM usage). Always included in JavaEE5 containers.
StAX
(Included in JAXB 2.0) 		1.0 jsr173_1.0_api.jar CDDL 1.0 APPROVED-1618 Optional processing style in MOXy.
Always included in JavaEE5 containers.
Java Activation Framework
(Included in JAXB 2.0) 		1.1 activation.jar CDDL 1.0 APPROVED-1620 Required for Web Service attachment handling in MOXy.
Always included in JavaEE5 containers.
Available from Orbit
JavaMail 1.4 mail.jar CDDL 1.0 APPROVED-1619 Required for Web Service attachment handling in MOXy.
Always included in JavaEE5 containers.
Available from Orbit
Service Data Objects (SDO) 2.1 commonj-sdo.jar Custom License APPROVED-1622 Only required when using SDO functionality.
WSDL4J 1.6.2 wsdl4j.jar Common Public License 1.0 APPROVED-1701 Required by DBWS
SOAP with Attachments API for Java 1.3 saaj-api-1.3.jar dual licensed GPL 2.0 and CDDL 1.0 PARALLEL_IP/APPROVED_FOR_CHECKIN-2291 Required by DBWS
Xerces 2.9.0 xercesImpl.jar Apache Software License Version 2.0 APPROVED-2046 Only required by Workbench Utility.

Third Party Dependencies

As per the Policy and Procedure for 3rd Party Dependencies the EclipseLink project has the following works-with dependencies. EclipseLink's pre-req behavior is as documented in the IP Log working with standard data source access APIs and compatible implementations.

The following dependencies are optional works-with capabilities available for those users who wish to access advanced features of the Oracle database and therefore have the corresponding libraries available from their database distribution. The functionality that leverages the additional features is isolated within SVN at: /foundation/org.eclipse.persistence.oracle . Both the Eclipse projects and ANT targets provided enable users to build and test EclipseLink without these optional dependencies or if they want to use these they can configure either Eclipse IDE variables or customize ANT properties files to provide the location of their works-with Oracle JDBC libraries.

Library Jars License Notes
Oracle JDBC ojdbc*.jar OTN org.eclipse.persistence.platform.database.oracle.Oracle8Platform
org.eclipse.persistence.platform.database.oracle.Oracle9Platform
org.eclipse.persistence.platform.database.oracle.Oracle10Platform
org.eclipse.persistence.internal.platform.database.oracle.XMLTypeFactory
org.eclipse.persistence.platform.database.oracle.converters.JGeometryConverter
Oracle Spatial Java Class Library sdoapi.jar OTN org.eclipse.persistence.platform.database.oracle.converters.JGeometryConverter
Note: This version is for use with Oracle 10g Spatial 10.1.0.2, 10.1.0.1, 9iR2, 9iR1, and with JDK 1.4.2 or higher.
Oracle XDK xml.jar
xmlparserv2.jar
xdb.jar 		OTN XMLTypeBindCallCustomParameter & XMLTypeFactoryImpl (org.eclipse.persistence.internal.platform.database.oracle.xdb)
DirectToXMLTypeMapping(org.eclipse.persistence.mappings.xdb)
org.eclipse.persistence.platform.xml.xdk.* (5 classes)
Oracle AQ aqapi.jar OTN org.eclipse.persistence.internal.eis.adapters.aq.* (5 classes)
Note: Seems to only be available from the database distribution.
Oracle UCP ucp.jar OTN org.eclipse.persistence.platform.database.oracle.ucp.* (1 class)
Note: Seems to only be available from the database distribution.
Retrieved from "https://wiki.eclipse.org/index.php?title=EclipseLink/Dependencies&oldid=241376"

Back to the top