91 Configuring Server Sessions

This chapter describes the various components that you must configure to use server and client sessions.

This chapter includes the following sections:

• Introduction to Server Session Configuration

• Configuring Internal Connection Pools

• Configuring External Connection Pools

Table 91-1 lists the configurable options for server sessions.

91.1 Introduction to Server Session Configuration

Table 91-1 lists the configurable options for server sessions.

Table 91-1 Configurable Options for Server Sessions

Option to Configure	Oracle JDeveloper	TopLink Workbench	Java
Internal connection pools (see Section 91.2, "Configuring Internal Connection Pools")
Primary mapping project (see Section 89.2, "Configuring a Primary Mapping Project")
Session login (see Section 89.3, "Configuring a Session Login")
Logging (see Section 89.4, "Configuring Logging")
External connection pools (see Section 91.3, "Configuring External Connection Pools")
Multiple mapping projects (see Section 89.5, "Configuring Multiple Mapping Projects")
Performance profiler (see Section 89.6, "Configuring a Performance Profiler")
Exception handler (see Section 89.7, "Configuring an Exception Handler")
Session customizer class (see Section 89.8, "Configuring a Session Customizer Class")
Server platform (see Section 89.9, "Configuring the Server Platform")
Session event listener (see Section 89.10, "Configuring Session Event Listeners")
Coordinated cache (see Section 103, "Configuring a Coordinated Cache")
Integrity checker (see Section 89.11, "Configuring the Integrity Checker")
Named queries (see Section 89.13, "Configuring Named Queries at the Session Level")

91.2 Configuring Internal Connection Pools

An internal connection pool is a collection of reusable connections to a single data source provided by any session that persists to a data source. By default, such a session provides both an internal read and write connection pool.

In this case, you can do the following:

• Configure read and write connection pool options such as minimum and maximum number of connections, alternate connection configuration, and properties (arbitrary, application-specific named values).

• Create named connection pools for whatever application-specific purpose you choose.

• Create sequence connection pools that TopLink uses exclusively for obtaining object identifiers.

For more information about creating and configuring internal connection pools, see the following:

• Chapter 100, "Creating an Internal Connection Pool"

• Chapter 101, "Configuring an Internal Connection Pool"

For more information about configuring the type of connection pool your session uses, see Section 97.4, "Configuring External Connection Pooling".

91.3 Configuring External Connection Pools

An external connection pool is a collection of reusable connections to a single data source provided by a JDBC driver or Java EE container.

By default, a session uses internal connection pools (see Section 91.2, "Configuring Internal Connection Pools"). For more information about configuring a session to use an external connection pool, see Section 97.4, "Configuring External Connection Pooling".