|
|
| (21 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| − | Note: This page describes an extension of EclipseLink that is part of the EclipseLink incubator. Incubator projects are published so the community can use them either to progress towards having them included in the main product, or to use in their own implementations. They have been tested to varying levels and as such, we recommend doing your own testing before including any of this code in a production-level product. Please report any issues via the bug listed below: | + | '''Note: This page has become obsolete as the server platform for SAP NetWeaver has been promoted from incubation to the main EclipseLink repository starting with release 2.1.''' |
| | | | |
| − | ==Bug==
| + | Information on the NetWeaver server platform is maintained [[EclipseLink/Development/ServerPlatform/NetweaverPlatform|here]]. |
| − | | + | |
| − | {{bug|287167}}
| + | |
| − | | + | |
| − | ==Description==
| + | |
| − | | + | |
| − | This is a subclass of ServerPlatform that can be used by customers using SAP NetWeaver Application Server Java.
| + | |
| − | | + | |
| − | ==Documentation==
| + | |
| − | ===Supported Versions===
| + | |
| − | The NetWeaver server platform allows using EclipseLink within SAP NetWeaver Application Server Java. The following versions are supported:
| + | |
| − | * SAP NetWeaver 7.1 including EHP 1
| + | |
| − | * SAP NetWeaver 7.2
| + | |
| − | * SAP NetWeaver 7.3 (not yet publicly available)
| + | |
| − | ===Building the NetWeaver Platform===
| + | |
| − | As a prerequisite, you must have checked out the EclipseLink sources from the trunk branch and performed a successful ant-based build. See [[EclipseLink/Building]] for detailed instructions.
| + | |
| − | You should then:
| + | |
| − | # Checkout the NetWeaver Platform extension from the location given [[EclipseLink/Development/Incubator/Extensions/NetWeaverPlatform#Location|below]].
| + | |
| − | # Edit the '''build.properties''' file in the checked out sources so that the property '''trunk.dir''' points to the root of the EclipseLink source tree (trunk).
| + | |
| − | # Call ''''ant''''.
| + | |
| − | As a result, you should get a file called '''netweaver_platform.jar''', which you can place alongside with the standard '''eclipselink.jar'''.
| + | |
| − | ===Using the NetWeaver Platform===
| + | |
| − | The recommended deployment option is to create a separate deployable application (i.e. an SDA file) containing both '''eclipselink.jar''' and '''netweaver_platform.jar'''
| + | |
| − | 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.
| + | |
| − | | + | |
| − | 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:
| + | |
| − | <pre>
| + | |
| − | <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
| + | |
| − | </pre>
| + | |
| − | * Include the following property at the end of each persistence unit so that EclipseLink will make use of the NetWeaver platform:
| + | |
| − | <pre>
| + | |
| − | <properties>
| + | |
| − | <property name="eclipselink.target-server" value="org.eclipse.persistence.extensions.platform.server.SAPNetWeaver_7_1_Platform"/>
| + | |
| − | </properties>
| + | |
| − | </pre>
| + | |
| − | ===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.
| + | |
| − | | + | |
| − | ==Location==
| + | |
| − | | + | |
| − | svn+ssh://dev.eclipse.org/svnroot/rt/org.eclipse.persistence/incubator/extensions/trunk/org.eclipse.persistence.platform.server.netweaver
| + | |
| − | | + | |
| − | ==Level of Testing==
| + | |
| − | Testing of the NetWeaver platform is done using the JPA server test suite.
| + | |
| − | ===Test Result Summary===
| + | |
| − | * Sept 3, 2009 - Initial check-in, compile only. Changes to existing EclipseLink classes not integrated.
| + | |
| − | * Dec 22, 2009 - EclipseLink server tests from trunk (2.1 stream) pass on SAP NetWeaver 7.1, ehp 3 with the following exceptions:
| + | |
| − | * Criteria tests should not be executed as the SAP NetWeaver server supports JPA 1.0 only: https://bugs.eclipse.org/bugs/show_bug.cgi?id=298407
| + | |
| − | * Test .../advanced/EntityManagerJUnitTestSuite.testSetRollbackOnly fails due to https://bugs.eclipse.org/bugs/show_bug.cgi?id=297558
| + | |
| − | | + | |
| − | ===Running the JPA tests on SAP NetWeaver AS Java===
| + | |
| − | 1. Follow the instructions to run the JPA tests against application servers: [[EclipseLink/Development/Testing/JPA#Running_JPA_tests_against_Application_Servers_Using_Ant]]
| + | |
| − | | + | |
| − | 2. Copy '''test.properties''' to the '''<user_home>''' directory and edit the properties as described here (step 7.): [[EclipseLink/Development/Testing/JPA#Configuration]]<br>
| + | |
| − | Additionally, set the following properties to disable weaving:
| + | |
| − | * test.agent=-Dignore
| + | |
| − | * test.weaving=-DTEST_NO_WEAVING=true
| + | |
| − | * server.weaving=false
| + | |
| − | | + | |
| − | 3. Copy '''netweaver.properties''' to '''<user_home>''' and edit those properties that are marked as user dependent.
| + | |
| − | | + | |
| − | 4. Prepare the NetWeaver server for the JPA server tests<br>
| + | |
| − | 4.1. Use the NetWeaver Administrator to deploy the JDBC driver of the database to use for testing. Use the name configured in property '''netweaver.datasource.driver.deployname''' in file '''<user_home>/netweaver.property'''.
| + | |
| − | (TODO: Link to help portal)
| + | |
| − | | + | |
| − | 5. Apply additional patches
| + | |
| − | * {{bug|287167}} - Server Platform for SAP NetWeaver 7.1
| + | |
| − | * {{bug|303472}} - Data source for JPA testing on NetWeaver server should use vendor_sql
| + | |
| − | | + | |
| − | 6. Make a full build of eclipselink: Go to the '''<trunk>''' directory, and execute ''''ant''''.
| + | |
| − | | + | |
| − | 7. Execute the tests:
| + | |
| − | | + | |
| − | 7.1 Call ''''ant server-setup''''.<br>
| + | |
| − | 7.2 Call ''''ant server-test''''.<br>
| + | |
| − | 7.3 Call ''''ant server-reset''''.
| + | |
| − | | + | |
| − | == Location of tests and examples==
| + | |
| − | | + | |
| − | No specific tests or examples have been written
| + | |
