ifs.fnd.sf.storage

Class FndAbstractConnectionManager

java.lang.Object

ifs.fnd.sf.storage.FndAbstractConnectionManager

All Implemented Interfaces:

FndConnectionManager

Direct Known Subclasses:

FndStaConnectionManager

public abstract class FndAbstractConnectionManager
extends java.lang.Object
implements FndConnectionManager

Framework internal class: Abstract class for management of database connections.

This is a framework internal class! Backward compatibility is not guaranteed.

Constructor Summary

Constructors

Constructor and Description
FndAbstractConnectionManager()

Method Summary

Modifier and Type	Method and Description
protected abstract FndConnection	getConnection(java.lang.String username, java.lang.String password) Framework specific (J2EE or STA) method for getting a database connection.
java.lang.String	getCurrentDatabaseUser() Gets current database user name.
FndConnection	getPlsqlConnection() Get a PLSQL connection for current application user and current language.
FndConnection	getPlsqlConnection(java.lang.String user, java.lang.String language) Get a database connection for a PLSQL session.
FndConnection	getPlsqlGatewayConnection(java.lang.String user) Get a database connection for a PLSQL session.
void	getSystemConnection(FndSystemConnectionAccess caller, java.lang.Object param) Gets a system user (IFSSYS) connection to database.
boolean	isTaggedConnectionMode() Indicates if this connection manager gets connections from Tagged Connection Pool or from J2EE connection pool.
boolean	isTaggedConnectionStateful() Indicates if the current dedicated session is allowed to keep transaction and cursor state between client requests.
void	returnConnection(FndConnection con) Returns the connection which is no longer needed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FndAbstractConnectionManager

public FndAbstractConnectionManager()

Method Detail

getConnection

protected abstract FndConnection getConnection(java.lang.String username,
                                               java.lang.String password)
                                        throws IfsException

Framework specific (J2EE or STA) method for getting a database connection. Username and password may be null if this information is included in a configuration file.

Parameters:

username - the database user on whose behalf the connection is being made.

password - the user's password.

Returns:

database connection

Throws:

IfsException

isTaggedConnectionStateful

public boolean isTaggedConnectionStateful()

Description copied from interface: FndConnectionManager

Indicates if the current dedicated session is allowed to keep transaction and cursor state between client requests.

Specified by:

isTaggedConnectionStateful in interface FndConnectionManager

isTaggedConnectionMode

public boolean isTaggedConnectionMode()

Description copied from interface: FndConnectionManager

Indicates if this connection manager gets connections from Tagged Connection Pool or from J2EE connection pool.

Specified by:

isTaggedConnectionMode in interface FndConnectionManager

Returns:

true database connections are fetched from Tagged Connection Pool, false otherwise

getPlsqlConnection

public FndConnection getPlsqlConnection(java.lang.String user,
                                        java.lang.String language)
                                 throws IfsException

Get a database connection for a PLSQL session.

Specified by:

getPlsqlConnection in interface FndConnectionManager

Parameters:

user - user name passed to PLSQL initialization procedure

language - this parameter is ignored, instead current language is passed to PLSQL initialization procedure

Returns:

database connection

Throws:

IfsException

getPlsqlGatewayConnection

public FndConnection getPlsqlGatewayConnection(java.lang.String user)
                                        throws IfsException

Get a database connection for a PLSQL session. The method is used by Plsql Gateway. If this method is called in proxy-user mode then the caller must commit/rollback the transaction before closing/returning this connection.

Specified by:

getPlsqlGatewayConnection in interface FndConnectionManager

Parameters:

user - user name passed to PLSQL initialization procedure

Returns:

database connection

Throws:

IfsException

getPlsqlConnection

public FndConnection getPlsqlConnection()
                                 throws IfsException

Get a PLSQL connection for current application user and current language.

Specified by:

getPlsqlConnection in interface FndConnectionManager

Returns:

database connection

Throws:

IfsException

getSystemConnection

public void getSystemConnection(FndSystemConnectionAccess caller,
                                java.lang.Object param)
                         throws IfsException

Gets a system user (IFSSYS) connection to database. The method will call the callback method setSystemConnection. The created connection will be not initialized by a call to Init_Fnd_Session. Only selected classes in java server framework are allowed to call this method.

Specified by:

getSystemConnection in interface FndConnectionManager

Parameters:

caller - an instance that wants to use a system connection

param - an object that will be passed to the callback method setSystemConnection

Throws:

IfsException

See Also:

FndSystemConnectionAccess.setSystemConnection

returnConnection

public void returnConnection(FndConnection con)
                      throws IfsException

Returns the connection which is no longer needed.

Specified by:

returnConnection in interface FndConnectionManager

Throws:

IfsException

getCurrentDatabaseUser

public java.lang.String getCurrentDatabaseUser()

Gets current database user name.

Specified by:

getCurrentDatabaseUser in interface FndConnectionManager

Returns:

system user (IFSSYS)