org.gvsig.fmap.dal.resource.db

Class AbstractDBResourceNoBlocker

java.lang.Object

org.gvsig.fmap.dal.resource.spi.AbstractResource

org.gvsig.fmap.dal.resource.spi.AbstractNonBlockingResource

org.gvsig.fmap.dal.resource.db.AbstractDBResourceNoBlocker

All Implemented Interfaces:

Resource, ResourceProvider, Observable, WeakReferencingObservable

Direct Known Subclasses:

JDBCResource

public abstract class AbstractDBResourceNoBlocker
extends AbstractNonBlockingResource

Abstract Data Base Resource implementation that allow the concurrent access.

Useful for Pooled Data Base Access.

Field Summary

Fields inherited from class org.gvsig.fmap.dal.resource.spi.AbstractResource

lock, multiResourcelock

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDBResourceNoBlocker(DBResourceParameters parameters) Default constructor

Method Summary

Modifier and Type	Method and Description
void	connect() Establish connection to data base
protected abstract void	connectToDB() final implementation method to Establish connection to data base Called from get()
protected boolean	equals(Comparable v1, Comparable v2)
Object	get() Return a connection to the data base.
Object	getConnection() Return a connection to the data base.
protected abstract Object	getTheConnection() final implementation method to get a connection to data base Called from connect() This method is called with the connection establish
abstract boolean	isConnected() inform if connection to the data base is established
boolean	isThis(ResourceParameters parameters) Check if parameters is the same for this resource.

Methods inherited from class org.gvsig.fmap.dal.resource.spi.AbstractNonBlockingResource

execute

Methods inherited from class org.gvsig.fmap.dal.resource.spi.AbstractResource

addConsumer, addObserver, addObservers, closeRequest, deleteObserver, deleteObservers, executeBegins, executeEnds, getConsumerAt, getConsumersCount, getData, getLastTimeOpen, getLastTimeUsed, getName, getParameters, inUse, isOpen, notifyChanges, notifyClose, notifyDispose, notifyObserver, notifyOpen, openCount, performExecution, prepare, prepare, removeConsumer, setData, updateLastTimeOpen, updateLastTimeUsed

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDBResourceNoBlocker

protected AbstractDBResourceNoBlocker(DBResourceParameters parameters)
                               throws InitializeException

Default constructor

Parameters:

parameters -

Throws:

InitializeException

Method Detail

get

public Object get()
           throws AccessResourceException

Return a connection to the data base.
Connect to the Data Base if is needed

Specified by:

get in interface Resource

Specified by:

get in class AbstractResource

Returns:

connection to the data base

Throws:

AccessResourceException - if there is an error while accessing the resource

getConnection

public Object getConnection()
                     throws AccessResourceException

Return a connection to the data base.
Connect to the Data Base if is needed

Returns:

connection to the data base

Throws:

AccessResourceException

See Also:

get()

isConnected

public abstract boolean isConnected()

inform if connection to the data base is established

Returns:

connect

public final void connect()
                   throws DataException

Establish connection to data base

Throws:

DataException

connectToDB

protected abstract void connectToDB()
                             throws DataException

final implementation method to Establish connection to data base
Called from get()

Throws:

DataException

getTheConnection

protected abstract Object getTheConnection()
                                    throws DataException

final implementation method to get a connection to data base
Called from connect()

This method is called with the connection establish

Throws:

DataException

isThis

public boolean isThis(ResourceParameters parameters)
               throws ResourceException

Check if parameters is the same for this resource.

Note: override this method to add checks for specify final implementation parameters

Throws:

ResourceException

See Also:

AbstractResource#isThis(ResourceParameters)

equals

protected boolean equals(Comparable v1,
                         Comparable v2)