org.vibur.dbcp.pool

Interface ViburObjectFactory

All Superinterfaces:

org.vibur.objectpool.PoolObjectFactory<ConnHolder>

All Known Implementing Classes:

ConnectionFactory

public interface ViburObjectFactory
extends org.vibur.objectpool.PoolObjectFactory<ConnHolder>

Defines the operations that are specific to Vibur ConnectionFactory. These are the factory's version manipulation methods and the create connection with credentials method.

Author:

Simeon Malchev

Method Summary

Modifier and Type	Method and Description
boolean	compareAndSetVersion(int expect, int update) Atomically sets the version value to the given updated value if the current value == the expected value.
ConnHolder	create()
ConnHolder	create(Connector connector) Creates a new ConnHolder object using the given connector.
int	version() Gets the current version value.

Methods inherited from interface org.vibur.objectpool.PoolObjectFactory

destroy, readyToRestore, readyToTake

Method Detail

create

ConnHolder create()
           throws ViburDBCPException

Specified by:

create in interface org.vibur.objectpool.PoolObjectFactory<ConnHolder>

Throws:

ViburDBCPException - if cannot create or initialize the raw JDBC Connection

create

ConnHolder create(Connector connector)
           throws ViburDBCPException

Creates a new ConnHolder object using the given connector. This object is presumed to be ready (and valid) for immediate use. This method never return null.

Parameters:

connector - the JDBC connector; it contains the database credentials

Throws:

ViburDBCPException - if cannot create or initialize the raw JDBC Connection

version

int version()

Gets the current version value.

Returns:

the current version value

compareAndSetVersion

boolean compareAndSetVersion(int expect,
                             int update)

Atomically sets the version value to the given updated value if the current value == the expected value.

Parameters:

expect - the expected version value

update - the new version value

Returns:

true if successful. False return indicates that the actual value was not equal to the expected value.