oracle.toplink.threetier
Class ConnectionPolicy

java.lang.Object
  oracle.toplink.threetier.ConnectionPolicy

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class ConnectionPolicy
extends java.lang.Object
implements java.lang.Cloneable, java.io.Serializable

Purpose: Used to specify how a client session's should be allocated.

See Also:

oracle.toplink.threetier.ServerSession, Serialized Form

Constructor Summary

ConnectionPolicy()
A connection policy is used to define how the client session connection should be acquired.

ConnectionPolicy(Login login)
A connection policy is used to define how the client session connection should be acquired.

ConnectionPolicy(java.lang.String poolName)
A connection policy is used to define how the client session connection should be acquired.

Method Summary

void	dontUseLazyConnection() A lazy connection only acquires a physical connection when a transaction is started and releases the connection when the transaction completes.
Login	getLogin() Return the login to use for this connection.
java.lang.String	getPoolName() Return the pool name or null if not part of a pool.
java.util.Map	getProperties() ADVANCED: This method will return the collection of custom properties set on the Connection policy.
java.lang.Object	getProperty(java.lang.Object object) Returns the property associated with the corresponding key.
boolean	hasLogin() Return if a login is used, only one of login and pool can be used.
boolean	hasProperties() Returns true if properties are available on the Connection Policy
boolean	isLazy() Return if a lazy connection should be used, a lazy connection only acquire a physical connection when a transaction is started and releases the connection when the transaction completes.
java.lang.Object	removeProperty(java.lang.Object key) This method is used to remove a custom property from the Connection Policy.
void	setIsLazy(boolean isLazy) Set if a lazy connection should be used, a lazy connection only acquire a physical connection when a transaction is started and releases the connection when the transaction completes.
void	setLogin(Login login) Set the login to use for this connection.
void	setPoolName(java.lang.String poolName) Set the pool name or null if not part of a pool.
void	setProperty(java.lang.Object key, java.lang.Object property) Use this method to set custom properties on the Connection Policy.
void	setShouldUseExclusiveConnection(boolean useExclusiveConnection) If set to true the acquired client session should acquire an exclusive connection for all database interaction.
boolean	shouldUseExclusiveConnection() Returns true if the acquired client session should acquire an exclusive connection for all database interaction.
void	useLazyConnection() A lazy connection only acquires a physical connection when a transaction is started and releases the connection when the transaction completes.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ConnectionPolicy

public ConnectionPolicy()

A connection policy is used to define how the client session connection should be acquired.

ConnectionPolicy

public ConnectionPolicy(java.lang.String poolName)

A connection policy is used to define how the client session connection should be acquired.

ConnectionPolicy

public ConnectionPolicy(Login login)

A connection policy is used to define how the client session connection should be acquired.

Method Detail

dontUseLazyConnection

public void dontUseLazyConnection()

A lazy connection only acquires a physical connection when a transaction is started and releases the connection when the transaction completes.

getLogin

public Login getLogin()

Return the login to use for this connection. Client sessions support using a seperate user login for database modification.

getPoolName

public java.lang.String getPoolName()

Return the pool name or null if not part of a pool.

getProperties

public java.util.Map getProperties()

ADVANCED: This method will return the collection of custom properties set on the Connection policy. Note that this will cause the lazy initialization of the HashMap.

getProperty

public java.lang.Object getProperty(java.lang.Object object)

Returns the property associated with the corresponding key. These properties will be available to connection events.

hasLogin

public boolean hasLogin()

Return if a login is used, only one of login and pool can be used.

hasProperties

public boolean hasProperties()

Returns true if properties are available on the Connection Policy

isLazy

public boolean isLazy()

Return if a lazy connection should be used, a lazy connection only acquire a physical connection when a transaction is started and releases the connection when the transaction completes.

removeProperty

public java.lang.Object removeProperty(java.lang.Object key)

This method is used to remove a custom property from the Connection Policy. This method will return the propery removed. If it was not found then null will be returned.

setIsLazy

public void setIsLazy(boolean isLazy)

Set if a lazy connection should be used, a lazy connection only acquire a physical connection when a transaction is started and releases the connection when the transaction completes.

setLogin

public void setLogin(Login login)

Set the login to use for this connection. Client sessions support using a seperate user login for database modification. Pooled connections must use the pool's login and cannot define their own.

setPoolName

public void setPoolName(java.lang.String poolName)

Set the pool name or null if not part of a pool.

setProperty

public void setProperty(java.lang.Object key,
                        java.lang.Object property)

Use this method to set custom properties on the Connection Policy. These properties will be available from within connection events but have no effect on the connection directly.

setShouldUseExclusiveConnection

public void setShouldUseExclusiveConnection(boolean useExclusiveConnection)

If set to true the acquired client session should acquire an exclusive connection for all database interaction. Currently this is only supported with Isolated data, but required for Oracle VPD support.

shouldUseExclusiveConnection

public boolean shouldUseExclusiveConnection()

Returns true if the acquired client session should acquire an exclusive connection for all database interaction. Currently this is only supported with Isolated data, but required for Oracle VPD support.

useLazyConnection

public void useLazyConnection()

A lazy connection only acquires a physical connection when a transaction is started and releases the connection when the transaction completes.