Oracle® TopLink

1 API Deprecated in this Release

In 11g Release 1 (11.1.1.1.0), the classes in the oracle.toplink.* packages (toplink.jar) have been deprecated and replaced with those in org.eclipse.persistence.* (eclipselink.jar).

To use the new 11g Release 1 (11.1.1.1.0) packages, you must use the packageRenameEclipseLink application to rename your packages. Refer to the Oracle TopLink Migration Guide for more information.

In addition, the following tables list the specific APIs deprecated as of 11g Release 1 (11.1.1.1.0). Oracle recommends that you use the replacement API indicated. Deprecated code will be removed in a future release.

• Table 1, "mappings (oracle.toplink.*)"

• Table 2, "descriptors (oracle.toplink.*)"

2 API Removed in this Release

The following classes are removed in 11g Release 1 (11.1.1.1.0) from the toplink.jar:

• OTSTransactionController

• OTSSynchronizationListener

• OracleSequenceDefinition (use SequenceObjectDefinition instead)

• TimeTenSequenceDefinition (use SequenceObjectDefinition instead)

• TopLinkXMLType

• oracle.toplink.remotecommand.XMLCommandConverter

• oracle.toplink.transform.xml.*

  • XMLSource

  • XMLResult

• oracle.toplink.tools.sessionconfiguration.model.clustering.*

  • OrbixCORBAJNDIClusteringConfig

  • VisibrokerCORBAJNDIClusteringConfig

  • EJBJNDIClusteringConfig

• oracle.toplink.jdo

• oracle.toplink.internal.Platform

• oracle.toplink.mappings.*

  • TypeConversionMapping

  • ObjectTypeMapping

  • SerializedObjectMapping

• oracle.toplink.oraclespecific.*

  • Ncharacter

  • NClob

  • Oracle8Platform

  • Oracle9Specific

  • TopLinkXMLType

• oracle.toplink.publicinterface.*

  • DatabaseRow

  • DatabaseSession

  • Descriptor

  • DescriptorEvent

  • DescriptorEventListener

  • DescriptorEventManager

  • DescriptorQueryManager

  • InheritancePolicy

  • Session

  • UnitOfWork

• oracle.toplink.sdk.*

• oracle.toplink.*

  • xml

  • xmlstream

  • xml.tools

  • xml.xerces

  • xml.zip

• toplink-cmp-bean_name.xml

• oracle.toplink.tools.sessionconfiguration.WASXMLLoader

• oracle.toplink.remote.*

  • corba.orbix

  • corba.visibroker

  • ejb

• oracle.toplink.Oracle8Platform

3 Miscellaneous API Changes

You should consider the following miscellaneous API changes:

• Section 3.1, "JPA Persistence Provider Implementation"

• Section 3.2, "SDO Implementation"

• Section 3.3, "Session Finalizers Disabled by Default"

• Section 3.4, "Vector and Hashtable Return Types Changed to List or Map"

List mappings = (List) descriptor.getMappings();

ClassDescriptor.getQueryKeys(); 
ClassDescriptor.getProperties();
DescriptorQueryManager.getQueries();
EISInteraction.getProperties();
Session.getProperties();
Session.getQueries();
getAttributesToAlwaysInclude(); 
getSpecialOperations();
getValuesToExclude(); 

4 Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Deaf/Hard of Hearing Access to Oracle Support Services

To reach Oracle Support Services, use a telecommunications relay service (TRS) to call Oracle Support at 1.800.223.1711. An Oracle Support Services engineer will handle technical issues and provide customer support according to the Oracle service request process. Information about TRS is available at http://www.fcc.gov/cgb/consumerfacts/trs.html, and a list of phone numbers is available at http://www.fcc.gov/cgb/dro/trsphonebk.html.