Oracle9iAS TopLink Foundation Library Guide Release 2 (9.0.3) Part Number B10064-01 |
|
The TopLink session configuration file, called sessions.xml, is a Java ResourceBundle that is read in using the locale. It may be necessary to rename the sessions.xml file to a locale specific name. For example TopLink_en_US.properties instead of sessions.xml.
Each TopLink project belongs to a TopLink session. To deploy beans that belong to different projects, add an appropriate TopLink session information section in the sessions.xml file as demonstrated in the Account Demo's sample
# The XML Jar Location XMLJarLocation = SPECIFY_JAR_LOCATION_HERE # The TopLink session information for the beans in the Account Demo session.YOUR_SESSION_NAME.projectClass = examples.ejb.cmp.account.AccountProject session.YOUR_SESSION_NAME.platform = oracle.toplink.internal.databaseaccess.OraclePlatform session.YOUR_SESSION_NAME.profile = false session.YOUR_SESSION_NAME.logProfile = false session.YOUR_SESSION_NAME.logMessages = true session.YOUR_SESSION_NAME.logDebug = true session.YOUR_SESSION_NAME.logExceptions = true session.YOUR_SESSION_NAME.useExternalConnectionPooling = true session.YOUR_SESSION_NAME.useExternalTransactionController = true session.YOUR_SESSION_NAME.externalTransactionController = oracle.toplink.jts.was.WebSphereJTSExternalTransactionController session.YOUR_SESSION_NAME.writePoolMax = 1 session.YOUR_SESSION_NAME.writePoolMin = 1 session.YOUR_SESSION_NAME.readPoolMax = 1 session.YOUR_SESSION_NAME.readPoolMin = 1 session.YOUR_SESSION_NAME.amendmentClass = examples.ejb.cmp.order.SessionAmendment session.YOUR_SESSION_NAME.amendmentMethod = configureSession
The toplink_session_name environment variable set in the bean's deployment descriptor.
The property XMLJarLocation points to the directory in which your .jar files have been saved.
It is necessary to have a TopLink project class file. You can generate a project class file using the TopLink Session Console.
The database platform. This can also be specified in the TopLink project.
This flag indicates whether or not to use the profiler. The profiler can be used to log a summary of each query that is executed. This may be used during development but for optimized performance it is recommended that this be disabled during production.
Set debug messages logging. Debug messages will be dumped through TopLink to the session's log. By default this is System.out, but can be set to any Writer.
Toggle exception logging.
If set to true then a DataSource must be set for the bean. This DataSource is used for all database connections. If this is set to false then TopLink uses its own internal connection pooling.
If set to true then TopLink database calls are synchronized with the container's "Transaction Manager".
This is specific to your application server and coordinates with the appropriate JTS. For example, for IBM WebSphere set this to oracle.toplink.jts.was
.WebSphereJTSExternalTransactionController
This is set only when an external transaction controller is not being used. It indicates the maximum number of write connections in the TopLink connection pool.
This is set only when an external transaction controller is not being used. It indicates the minimum/initial number of write connections in the TopLink connection pool.
This is set only when an external transaction controller is not being used. It indicates the maximum number of read connections in the TopLink connection pool.
This is set only when an external transaction controller is not being used. It indicates the minimum/initial number of read connections in the TopLink connection pool.
The class that contains the public class that amends the session.
A public static method that takes a oracle.toplink.threetier.ServerSession as a parameter. This method is run when the TopLink session is created during bean deployment.
The sessions.xml file is similar in function to the TOPLink.properties files from previous version of TopLink. If you are upgrading from a version of TopLink hat used the TOPLink.properties file, the following table, which identifies settings in the TopLink.properties file and their equivalents in the sessions.xml file, will be of use to you.
|
Copyright © 2002 Oracle Corporation. All Rights Reserved. |
|