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/Development/ServerPlatform/NetweaverPlatform"
< EclipseLink | Development
| (11 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
==Documentation== | ==Documentation== | ||
| + | ===Description=== | ||
| + | The NetWeaver server platform is a subclass of the <tt>ServerPlatform</tt> class that can be used by customers using SAP NetWeaver Application Server Java: | ||
| + | <pre> | ||
| + | org.eclipse.persistence.platform.server.sap.SAPNetWeaver_7_1_Platform | ||
| + | </pre> | ||
| + | Starting with release 2.1 it is contained in the standard EclipseLink repository:<br> | ||
| + | <tt>svn+ssh://dev.eclipse.org/svnroot/rt/org.eclipse.persistence/trunk/foundation/org.eclipse.persistence.core/src/org/eclipse/persistence/platform/server/sap/SAPNetWeaver_7_1_Platform.java</tt> | ||
| + | |||
===Supported Versions=== | ===Supported Versions=== | ||
| − | The NetWeaver server platform allows using EclipseLink within SAP NetWeaver Application Server Java | + | The NetWeaver server platform allows using EclipseLink within SAP NetWeaver Application Server Java and works with the following versions: |
| − | * SAP NetWeaver 7.1 including EHP 1 | + | * SAP NetWeaver 7.1 including EHP 1 (should work, but not yet tested) |
* SAP NetWeaver 7.2 | * SAP NetWeaver 7.2 | ||
* SAP NetWeaver 7.3 (not yet publicly available) | * SAP NetWeaver 7.3 (not yet publicly available) | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
===Using the NetWeaver Platform=== | ===Using the NetWeaver Platform=== | ||
| − | The recommended deployment option is to create a separate deployable application (i.e. an SDA file) containing | + | The recommended deployment option is to create a separate deployable application (i.e. an SDA file) containing the '''eclipselink.jar''' file |
and to reference that application from your Java EE application. See the [http://help.sap.com/saphelp_nwce10/helpdata/en/44/f447a8d62b0484e10000000a155369/frameset.htm NetWeaver Help Portal] for a description how to do this using SAP NetWeaver Developer Studio. | and to reference that application from your Java EE application. See the [http://help.sap.com/saphelp_nwce10/helpdata/en/44/f447a8d62b0484e10000000a155369/frameset.htm NetWeaver Help Portal] for a description how to do this using SAP NetWeaver Developer Studio. | ||
| Line 21: | Line 23: | ||
<provider>org.eclipse.persistence.jpa.PersistenceProvider</provider> | <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider> | ||
</pre> | </pre> | ||
| − | * Include the following property at the end of each persistence unit so that EclipseLink | + | * Include the following property at the end of each persistence unit so that EclipseLink makes use of the NetWeaver platform: |
<pre> | <pre> | ||
<properties> | <properties> | ||
| − | <property name="eclipselink.target-server" value=" | + | <property name="eclipselink.target-server" value="NetWeaver_7_1"/> |
</properties> | </properties> | ||
| − | </pre> | + | </pre> |
| + | : Note that <tt>NetWeaver_7_1</tt> is a short name that refers to the NetWeaver platform class. You can also specify the fully qualified class name here. | ||
| + | |||
| + | See also this [http://www.sdn.sap.com/irj/scn/weblogs?blog=/pub/wlg/19824 blog on the SAP Developer Network]. | ||
| + | |||
===Limitations=== | ===Limitations=== | ||
* SAP NetWeaver AS Java (version 7.1 to 7.3) is a Java EE 5 server, hence supporting only JPA 1.0. | * SAP NetWeaver AS Java (version 7.1 to 7.3) is a Java EE 5 server, hence supporting only JPA 1.0. | ||
* Dynamic weaving cannot be used inside SAP NetWeaver AS Java. Applications should use static weaving instead. | * Dynamic weaving cannot be used inside SAP NetWeaver AS Java. Applications should use static weaving instead. | ||
| + | |||
| + | ==Level of Testing== | ||
| + | See [[EclipseLink/Development/ServerPlatform/NetweaverPlatform/Testing]] for details on the level of testing. | ||
Latest revision as of 02:12, 16 May 2011
Contents
Documentation
Description
The NetWeaver server platform is a subclass of the ServerPlatform class that can be used by customers using SAP NetWeaver Application Server Java:
org.eclipse.persistence.platform.server.sap.SAPNetWeaver_7_1_Platform
Starting with release 2.1 it is contained in the standard EclipseLink repository:
svn+ssh://dev.eclipse.org/svnroot/rt/org.eclipse.persistence/trunk/foundation/org.eclipse.persistence.core/src/org/eclipse/persistence/platform/server/sap/SAPNetWeaver_7_1_Platform.java
Supported Versions
The NetWeaver server platform allows using EclipseLink within SAP NetWeaver Application Server Java and works with the following versions:
- SAP NetWeaver 7.1 including EHP 1 (should work, but not yet tested)
- SAP NetWeaver 7.2
- SAP NetWeaver 7.3 (not yet publicly available)
Using the NetWeaver Platform
The recommended deployment option is to create a separate deployable application (i.e. an SDA file) containing the eclipselink.jar file and to reference that application from your Java EE application. See the NetWeaver Help Portal for a description how to do this using SAP NetWeaver Developer Studio.
In order to use EclipseLink in your application, the persistence.xml file must contain the following entries:
- Add a <provider> tag to each of the defined persistence units (must be the first line after the <persistence-unit> tag) so that EclipseLink will be used as the JPA provider for the respective persistence unit:
<provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
- Include the following property at the end of each persistence unit so that EclipseLink makes use of the NetWeaver platform:
<properties> <property name="eclipselink.target-server" value="NetWeaver_7_1"/> </properties>
- Note that NetWeaver_7_1 is a short name that refers to the NetWeaver platform class. You can also specify the fully qualified class name here.
See also this blog on the SAP Developer Network.
Limitations
- SAP NetWeaver AS Java (version 7.1 to 7.3) is a Java EE 5 server, hence supporting only JPA 1.0.
- Dynamic weaving cannot be used inside SAP NetWeaver AS Java. Applications should use static weaving instead.
Level of Testing
See EclipseLink/Development/ServerPlatform/NetweaverPlatform/Testing for details on the level of testing.