Oracle® TopLink

1.1 oracle.toplink.annotations.*

This package includes the classes that you can use to configure TopLink-specific options using annotations instead of project.xml and sessions.xml deployment XML files.

1.2 oracle.toplink.config.*

This package contains the classes that you can use with JPA to specify TopLink-specific options using JPA vendor extensions.

1.3 oracle.toplink.descriptors.*

Use the ClassDescriptor method useSoftIdentityMap to select a soft identity map.

Use DescriptorQueryManager method setExpressionQueryCacheMaxSize(int) to set maximum query cache size for expressions.

1.4 oracle.toplink.expressions.spatial.*

The classes in this package provide query and expressions support that allows your TopLink-enabled application to take advantage of Oracle Spatial, the Oracle Enterprise Edition option that provides advanced spatial features to support high-end Geographical Information System (GIS) and Location Based Service (LBS) solutions.

Using TopLink, you can map persistent fields to an Oracle Spatial database schema and create and execute Oracle Spatial queries with all the ease of use that TopLink expressions provide.

1.5 oracle.toplink.expressions.Expression

You can use the following new Expression methods:

• currentDateDate

• leftTrim(Object)

• like(Expresion, Expression)

1.6 oracle.toplink.mappings.*

Use the PropertyAssociation class as a generic association object to map hashtable or hashmap containers where the key and value primitives or independent objects.Use the ForeignReferenceMapping method setJoinFetch(int) to indicate whether the referenced object(s) should always be joined on read queries. A join-fetch can either use an ForeignReferenceMapping.INNER_JOIN or ForeignReferenceMapping.OUTER_JOIN.

1.7 oracle.toplink.mappings.converters.*

Use the EnumTypeConverter converter to match a fixed number of database data values to a Java enum object value. Use this class when the values on the database and in the Java enum differ. To create an object type converter, simply specify the set of conversion value pairs. A default value and one-way conversion are also supported for legacy data situations.

1.8 oracle.toplink.platform.database.converters.*

You can add a StructConverter class to a DatabasePlatform to allow custom processing of advanced java.sql.Struct types that require some processing immediately before writing to the database or immediately after reading from the database.

1.9 oracle.toplink.platform.database.*

This package provides the following new database platform classes:

• DerbyPlatform

• JavaDBPlatform

• oracle.Oracle11Platform

• PostgreSQLPlatform

This package also provides the oracle.toplink.platform.database.oracle.converters.JGeometryConverter class that TopLink uses to support Oracle Spatial (see also Section 1.4, "oracle.toplink.expressions.spatial.*").

1.10 oracle.toplink.queryframework.*

This package provides the following new classes:

• ColumnResult

• ConstructorReportItem

• DeleteAllQuery

• EntityResult

• FieldResult

• ModifyAllQuery

• ObjectBuildingQuery

• ResultSetMappingQuery

• SQLResult

• SQLResultSetMapping

1.11 oracle.toplink.queryframework.*

You can use the following new ObjectLevelReadQuery methods:

• addNonFetchJoinedAttribute(Expression)

• addNonFetchJoinedAttribute(String)

• setIsReadOnly(boolean)

• setShouldOuterJoinSubclasses(boolean)

You can use the following new ReportQuery methods:

• addAttribute(String, Expression, Class)

• beginAddingConstructorArguments(Class)

• endAddingConstructorArguments

• returnWithoutReportQueryResult

• setHavingExpression(Expression)

You can use the following new StoredProcedureCall methods:

• add*(.., int, String)

1.12 oracle.toplink.tools.schemaframework.*

Use the new UniqueKeyConstraint class to define a unique key constraint on a database table.

1.13 oracle.toplink.tools.sessionconfiguration.*

By implementing the new DescriptorCustomizer interface, you can create a class to customize a specific ClassDescriptor using the toplink.descriptor.customizer.ENTITY property.

You can use the new XMLSessionConfigLoader methods:

• setClassLoader(ClassLoader)

• setSessionName(String)

• setShouldCheckClassLoader(boolean)

• setShouldLogin(boolean)

• setShouldRefresh(boolean)

1.14 oracle.toplink.tools.sessionmanagement.*

You can use SessionManager method getSession(XMLSessionConfigLoader) to load a TopLink session with a specific instance of XMLSessionConfigLoader.

1.15 oracle.toplink.transaction.sunas.*

You can use class SunAS9TransactionController to integrate with the Sun Application Server 9 transaction controller.

1.16 oracle.toplink.weaving.*

Use the classes in this package to perform static weaving of your persistent classes. Using the StaticWeaveAntTask, you can perform static weaving as part of your build process.

1.17 oracle.toplink.PersistenceProvider

Use this class to acquire a JPA persistence provider instance for JPA outside of a Java EE container.

5.1 JPA Persistence Provider Implementation

In 11g (11.1.1), TopLink uses eclipselink.jar to provide JPA 1.0 support. Refer to http://www.eclipse.org/eclipselink for more information.

5.2 SDO Implemenatation

In 11g (11.1.1), TopLink uses eclipselink.jar to provide SDO 2.0.1 support. Refer to http://www.eclipse.org/eclipselink for more information.

5.3 Session Finalizers Disabled by Default

In 11g (11.1.1), session finalizers are disabled by default to improve performance.

To enable session finalizers, use Session method setIsFinalizersEnabled(true).

5.4 Vector and Hashtable Return Types Changed to List or Map

Any Session or ClassDescriptor method that returns Vector or Hashtable will eventually be changed to return List or Map, respectively. To future proof your application code, cast Vector and Hashtable return types to List or Map, respectively. For example, although the Javadoc for ClassDescriptor method getMappings is java.util.Vector, you should cast the returned value to List:

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

Other changes that now return Map, include the following:

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