EclipseLink 1.0_1.0 M7 - 20080508 API Reference - Incubation

org.eclipse.persistence.sessions.server
Class ConnectionPolicy

java.lang.Object
  extended by org.eclipse.persistence.sessions.server.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:
ServerSession, Serialized Form

Field Summary
protected  boolean isLazy
           
protected  Login login
           
protected  java.lang.String poolName
           
protected  java.util.Map properties
           
protected  boolean shouldUseExclusiveConnection
           
 
Constructor Summary
ConnectionPolicy()
          PUBLIC: A connection policy is used to define how the client session connection should be acquired.
ConnectionPolicy(Login login)
          PUBLIC: A connection policy is used to define how the client session connection should be acquired.
ConnectionPolicy(java.lang.String poolName)
          PUBLIC: A connection policy is used to define how the client session connection should be acquired.
 
Method Summary
 java.lang.Object clone()
          INTERNAL: Clone the query
 void dontUseLazyConnection()
          PUBLIC: A lazy connection only acquires a physical connection when a transaction is started and releases the connection when the transaction completes.
 Login getLogin()
          PUBLIC: Return the login to use for this connection.
 java.lang.String getPoolName()
          PUBLIC: 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)
          PUBLIC: Returns the property associated with the corresponding key.
 boolean hasLogin()
          PUBLIC: Return if a login is used, only one of login and pool can be used.
 boolean hasProperties()
          PUBLIC: Returns true if properties are available on the Connection Policy
 boolean isLazy()
          PUBLIC: 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.
 boolean isPooled()
          INTERNAL: Return if part of a connection pool.
 boolean isUserDefinedConnection()
          INTERNAL: Return if part of a connection pool.
 java.lang.Object removeProperty(java.lang.Object key)
          PUBLIC: This method is used to remove a custom property from the Connection Policy.
 void setIsLazy(boolean isLazy)
          PUBLIC: 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)
          PUBLIC: Set the login to use for this connection.
 void setPoolName(java.lang.String poolName)
          PUBLIC: Set the pool name or null if not part of a pool.
 void setProperty(java.lang.Object key, java.lang.Object property)
          PUBLIC: Use this method to set custom properties on the Connection Policy.
 void setShouldUseExclusiveConnection(boolean useExclusiveConnection)
          PUBLIC: If set to true the acquired client session should acquire an exclusive connection for all database interaction.
 boolean shouldUseExclusiveConnection()
          PUBLIC: Returns true if the acquired client session should acquire an exclusive connection for all database interaction.
 java.lang.String toString()
          INTERNAL: return a string representation of this ConnectionPolicy
 void useLazyConnection()
          PUBLIC: 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, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

login

protected Login login

poolName

protected java.lang.String poolName

isLazy

protected boolean isLazy

shouldUseExclusiveConnection

protected boolean shouldUseExclusiveConnection

properties

protected java.util.Map properties
Constructor Detail

ConnectionPolicy

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


ConnectionPolicy

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


ConnectionPolicy

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

Method Detail

clone

public java.lang.Object clone()
INTERNAL: Clone the query

Overrides:
clone in class java.lang.Object

dontUseLazyConnection

public void dontUseLazyConnection()
PUBLIC: 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()
PUBLIC: Return the login to use for this connection. Client sessions support using a separate user login for database modification.


getPoolName

public java.lang.String getPoolName()
PUBLIC: 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)
PUBLIC: Returns the property associated with the corresponding key. These properties will be available to connection events.


hasLogin

public boolean hasLogin()
PUBLIC: Return if a login is used, only one of login and pool can be used.


hasProperties

public boolean hasProperties()
PUBLIC: Returns true if properties are available on the Connection Policy


isLazy

public boolean isLazy()
PUBLIC: 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.


isPooled

public boolean isPooled()
INTERNAL: Return if part of a connection pool.


isUserDefinedConnection

public boolean isUserDefinedConnection()
INTERNAL: Return if part of a connection pool.


removeProperty

public java.lang.Object removeProperty(java.lang.Object key)
PUBLIC: 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)
PUBLIC: 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)
PUBLIC: Set the login to use for this connection. Client sessions support using a separate 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)
PUBLIC: Set the pool name or null if not part of a pool.


setProperty

public void setProperty(java.lang.Object key,
                        java.lang.Object property)
PUBLIC: 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)
PUBLIC: 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()
PUBLIC: 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.


toString

public java.lang.String toString()
INTERNAL: return a string representation of this ConnectionPolicy

Overrides:
toString in class java.lang.Object

useLazyConnection

public void useLazyConnection()
PUBLIC: A lazy connection only acquires a physical connection when a transaction is started and releases the connection when the transaction completes.


EclipseLink 1.0_1.0 M7 - 20080508 API Reference - Incubation