Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

EclipseLink/Examples/JPA/Migration/TopLinkEssentials

This how-to discusses how a user can migrate to using EclipseLink JPA from TopLink Essentials

Persistence.xml

Persistence Provider

Modify the persistence provider from

  <provider>oracle.toplink.essentials.PersistenceProvider</provider>

or

  <provider>oracle.toplink.essentials.ejb.cmp3.EntityManagerFactoryProvider</provider>

to

  <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>

Properties

When migrating the Persistence.xml the primary change in the persistence unit properties is converting from using "toplink.*" to "eclipselink.*"

target-server

Verify in particular that you have the eclipselink.target-server property set - especially if you are migrating from TopLink Essentials to EclipseLink - where the provider and target-server were defaulted.

  • 1) Check that your datasource is configured in transactional mode - usually the default.
  • 2) Check your persistence.xml has a target-server property - this will affect transactions.
    • Note: by default GlassFish V2 would have defaulted this "target-server" value when using TopLink Essentials because that persistence provider is the one loaded by default - When using the EclipseLink JPA provider.

You will need to specify target-server it in order to get server platform specific functionality surrounding a transaction manager acquire using "java:appserver/TransactionManager" in the SunAS9TransactionController.

    <property name="eclipselink.target-server" value="SunAS9"/>
  • 3) Other things to verify

ORM.XML

TopLink Essentials uses the JPA 1.0 defined orm.xml schema and thus is compatible with EclipseLink. The only content changes that should be made is conversion of any query hints used in the configuration.

Query Hints

Annotations

Query Hints

Java API

Query Hints

  • Java code: customer PU properties and query hints
    • Use of EclipseLink native API where TLE native API was used
  • Side-effects of the migration
    • Change from default access type when using ORM.XML

Custom Mapping Definitions

Using the Package Rename Utility

See Package Renamer

Back to the top