Oracle9iAS TopLink

Release Notes

Release 2 (9.0.3)

August 2002

Part No. B10159-01

This document describes the changes between Release 2 (9.0.3) and previous versions, as well as how developers using previous versions can use Release 2 (9.0.3) and easily make use of the new capabilities. This document also summarizes the differences between Toplink and its documented functionality.

This document specifically discusses

1 New Features

1.1 TopLink Deployment and Development Licenses

Oracle9iAS TopLink Release 2 (9.0.3) no longer requires a license file for the Foundation Libraries or the TopLink Mapping Workbench. You are not allowed to ship the TopLink Mapping Workbench or expose any of the TopLink APIs as part of an end-user application. Refer to the software license agreement with regards to limitations about including the TopLink Foundation Library .jars, as part of a packaged end-user application.

1.2 TopLink Tour, Examples, and Demos

Oracle9iAS TopLink Release 2 (9.0.3) includes many new features and improvements. To help you get started, we have included a tour, examples and demos that illustrate many of the changes. The tour, examples, and demos are accessed through the Demonstration tab of the documentation web page.

To access the documentation page from a Windows environment, click the Windows Start menu, select Programs > Oracle9iAS TopLink > Examples.

To access the documetation page from a non-Windows environment, open the <INSTALL_DIR>/doc/demos.htm file.

1.3 Cache Synchronization over JMS

TopLink now provides communication integration with JMS for our cache synchronization feature. This makes cache synchronization setup easier and improves the scalability of cache synchronization.

1.4 TopLink Web Client

The TopLink Web Client provides a web-based interface that allows interaction with any TopLink ServerSession deployed on a particular application server. In particular, the TopLink Web Client supports Oracle9iAS Containers for J2EE (oc4j).

TopLink Web Client allows you to inspect and edit the persistent objects associated with ServerSessions. The TopLink Web Client is a web application that can be deployed on Oracle9iAS, IBM WebSphere Server4.0 and on BEA WebLogic Server6.1 and 7.0. See TopLink Web Client for more information.

1.5 Non-relational demo and Attunity Support

TopLink now supports access to non-relational datasources through the Attunity Connect JDBC driver. A demonstration of TopLink working with Attunity Connect and a DISAM datasource is included with the release. The demonstration shows how the TopLink Mapping Workbench can be used to map the data that Attunity ships with their demo database. It also includes a sample program that demonstrates basic TopLink functionality with the demo data.

2 Name Changes for Packages and Directories

In Oracle9iAS TopLink Release 2 (9.0.3), the package names have changed. Toplink provides a tool to help you migrate to the new names if you are upgrading from a previous version of TopLink to Oracle9iAS TopLink Release 2 (9.0.3). Consult the Package Renamer for more information.

2.1 Renaming Packages in Your Source Code

In this release, the package structure has been changed to conform with Oracle9i standards and conventions for packages. The base package for the entire structure is now oracle.toplink.

Toplink provides a tool to facilitate migration to the new package names if you are upgrading from 2.x, 3.x or 4.6 to Oracle9iAS TopLink Release 2 (9.0.3). Consult the Package Renamer for more information.

Note:

The time required by the package renamer to process files is directly related to the size of the files being renamed such that larger files take longer to process. In particular, files over 1 Mb will take a significant amount of time to process.

2.2 New Database Platform Directory

In this release, the location of the Database Platform directory has been renamed to platforms. In addition, the root tag <DatabasePlatform> in each .xml file has been renamed to <platforms>. If your application uses customized platforms, you must update the root tag in each .xml file.

3 Resolved Problems

Following is a list of issues resolved in this version of TopLink.

Issue ID	Resolution
2408	A `NullPointerException` is no longer thrown when deleting a large number of objects from a CacheIdentityMap. A more descriptive `ValidationException` is now thrown.
2718	A `NullPointerException` is no longer thrown when using an incorrectly configured one-to-one mapping with Proxy Indirection. Instead, a more descriptive `ValidationException` is now thrown.
3791	The `getField()` method in Expression can now be used without a fully-qualified field name when used after `getTable()`.
4139	The `previous()` method in ScrollableCursor now works correctly.
4143	Changes that add to or remove from the target of a one-to-many relationship without changing the source are now correctly detected and passed to the remote server when using Cache Synchronization.
4204	A Concurrency Exception is no longer thrown when a rollback occurs as a result of Pessimistic Locking.
4220	When getting a SessionBroker from a SessionManager, the SessionBroker's sessions are now properly registered. Prior to TopLink 4.5, a `ValidationException` was thrown when a session was acquired in this manner.

4 API Modifications

In this release, all packages, many classes, and some methods have been renamed. As a result, there are several new packages, classes, and methods, but in name only. Their functionality has not changed unless otherwise specified in this section.

4.1 New Classes

Class: Oracle9iJTSExternalTransactionController

Package: oracle.toplink.jts.oracle9i

Feature: JTS controller for Oracle9iAS.

Description: This class implements the registration of asynchronization object according to the Oracle9iAS implementation

Oracle is a registered trademark, and Oracle9i is a trademark or registered trademark of Oracle Corporation. Other names may be trademarks of their respective owners.