oracle.jbo.common.ampool
Interface ApplicationPool

All Known Implementing Classes:

ApplicationPoolImpl

public interface ApplicationPool

This is the ApplicationPool interface. It needs to be implemented by any class that is intended to provide a customized pool interface. Look at ApplicationPoolImpl for the default implementation. View Implementation of ApplicationPool View Implementation of ApplicationPoolImpl

Method Summary

void	checkin(ApplicationModule instance) Checks in an application instance that had previously been checked out.
ApplicationModule	checkout() Checks out an application instance from the pool.
ApplicationModule	createNewInstance() This create a new instance of an application without looking for an available instance in the pool.
java.lang.String	getApplicationModuleClass() Return the class name of the application modules being managed by the pool.
java.lang.String	getConnectString() Return the connect string of the application modules being managed by the application pool.
java.util.Hashtable	getEnvironment() Returns the Hashtable that was used to initialie the Contect for the application modules.
ApplicationModule	getInstance(int nIndex) Returns the application instance represented by the instance index.
int	getInstanceCount() Returns the number of instances that the Application Pool has created.
java.lang.String	getPoolName() Returns the pool's name.
java.util.Hashtable	getUserData() returns the User Data hashtable.
void	initialize(java.lang.String sPoolName, java.lang.String sApplicationModule, java.lang.String sConnectString, java.util.Hashtable env) This initializes the ApplicationPool.
boolean	isAvailable(ApplicationModule instance) Returns true if the application module is available
void	releaseInstances() Causes the pool to release all the application isntances that have been created so far.
void	setAvailable(ApplicationModule instance, boolean bSet) Sets the instance to available or not
void	setUserData(java.util.Hashtable data) Replaces the userData with the new Hashtable.

Method Detail

initialize

public void initialize(java.lang.String sPoolName,
                       java.lang.String sApplicationModule,
                       java.lang.String sConnectString,
                       java.util.Hashtable env)
                throws java.lang.Exception

This initializes the ApplicationPool. The Pool name should be unique with respect to any other pools. An exception will be thrown on any errors such as duplicate pool name or mismatched information within the connectInfo parameter. Take a close look at the ConnectInfo documentation since it controls the key information for initializing the application pool.

getApplicationModuleClass

public java.lang.String getApplicationModuleClass()

Return the class name of the application modules being managed by the pool.

getConnectString

public java.lang.String getConnectString()

Return the connect string of the application modules being managed by the application pool.

getEnvironment

public java.util.Hashtable getEnvironment()

Returns the Hashtable that was used to initialie the Contect for the application modules.

checkin

public void checkin(ApplicationModule instance)

Checks in an application instance that had previously been checked out. This makes the application instance avalable for subsequent checkout requests from this pool.

isAvailable

public boolean isAvailable(ApplicationModule instance)

Returns true if the application module is available

setAvailable

public void setAvailable(ApplicationModule instance,
                         boolean bSet)

Sets the instance to available or not

checkout

public ApplicationModule checkout()

Checks out an application instance from the pool. If the pool doesn't have any available instances, it will create a new instance and return it to the caller.

releaseInstances

public void releaseInstances()

Causes the pool to release all the application isntances that have been created so far. The remove() method is called on the Application Modules being represented by the application instance class

getInstanceCount

public int getInstanceCount()

Returns the number of instances that the Application Pool has created.

createNewInstance

public ApplicationModule createNewInstance()

This create a new instance of an application without looking for an available instance in the pool. This method should not be called directly, you should call checkout() .

getInstance

public ApplicationModule getInstance(int nIndex)

Returns the application instance represented by the instance index.

getPoolName

public java.lang.String getPoolName()

Returns the pool's name.

getUserData

public java.util.Hashtable getUserData()

returns the User Data hashtable. This is a generic container for any settings the user would like to associate with this application pool.

setUserData

public void setUserData(java.util.Hashtable data)

Replaces the userData with the new Hashtable.