com.programix.da2
Class DAStore

java.lang.Object
  com.programix.da2.DAStore

All Implemented Interfaces:

DASource

public class DAStore
extends Object
implements DASource

An implementation of DASource that caches the GenericDA implementations that it retrieves from the underlying DASource that is passed during construction. This cache can be cleared with the clearCache() method.

Author:

Paul Hyde

Constructor Summary

DAStore(DASource source)

Method Summary

void	clearCache()
GenericDA	getDA(Class daInterfaceType) Searches for an implementation of the specified interface type.
void	shutdown() This should be called when the DASource is no longer needed to clean up any potential resources being used behind the scenes.

Methods inherited from class java.lang.Object

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

Constructor Detail

DAStore

public DAStore(DASource source)

Method Detail

getDA

public GenericDA getDA(Class daInterfaceType)
                throws DAException

Description copied from interface: DASource

Searches for an implementation of the specified interface type.

Specified by:

getDA in interface DASource

Parameters:

daInterfaceType - the interface type for which an implementation is desired.

Returns:

an implementation of the specified type.

Throws:

DAException - if either no implementation can be found or if there is trouble creating/accessing the implementation.

shutdown

public void shutdown()

Description copied from interface: DASource

This should be called when the DASource is no longer needed to clean up any potential resources being used behind the scenes. Some implementations may have nothing to do when shutdown, but other implementations might have important de-allocation duties to perform.

If there are any "cached" instances of GenericDA that this source is holding, those are individually shutdown by calling this method.

No other methods should be called after this method. Calling other methods after calling this method results in undefined behavior (many times, a ShutdownDAException will be thrown when attempting to invoke those other methods, but there is no requirement that all methods do this).

Calling shutdown() more than one time must be allowed and shutdown() must not complain. Also note that shutdown() never throws any exceptions—it just makes its best effort of close down everything. Implementations must assure that this remains true.

Specified by:

shutdown in interface DASource

clearCache

public void clearCache()