HyperSQL Database 2.7.4 · org.hsqldb.jdbc.JDBCDataSourceFactory

A JNDI ObjectFactory for creating data sources supported by HyperSQL JDBCDataSource for plain connections for the end user. JDBCPool for pooled plain connections for the end user. JDBCPooledDataSource for PooleConnection objects used by external connection pooling software. JDBCXADataSource for XAConnection objects used by external connection pooling software.

Field Summary

Modifier and Type	Field and Description
private static final String	bdsClassName class names
private static final String	databaseName
private static final String	loginTimeoutName
private static final String	passwordName
private static final String	pdsClassName
private static final String	poolClassName
private static final String	urlName supported properties
private static final String	userName
private static final String	userNameName
private static final String	xdsClassName

Constructor Summary

Access	Constructor and Description
public	JDBCDataSourceFactory()

Method Summary

Modifier and Type	Method and Description
public static DataSource	Returns: the data source instance createDataSource(Properties properties props) Static method to create a JDBCDataSource instance using the given properties for url, user, password, etc.
public Object	Returns: A newly created JDBCDataSource object; null if an object cannot be created. getObjectInstance(Object The reference information used in creating a Datasource object. obj, Name ignored name, Context ignored nameCtx, Hashtable<K, V> ignored environment) Implements javax.naming.spi.ObjectFactory.getObjectInstance. Creates a DataSource object using the javax.naming.Reference object specified.

Modifier and Type

Method and Description

public static DataSource

Returns:

the data source instance

createDataSource(Properties

properties

props)

Static method to create a JDBCDataSource instance using the given properties for url, user, password, etc.

public Object

Returns:

A newly created JDBCDataSource object; null if an object cannot be created.

getObjectInstance(Object

The reference information used in creating a Datasource object.

obj, Name

ignored

name, Context

ignored

nameCtx, Hashtable<K, V>

ignored

environment)

Implements javax.naming.spi.ObjectFactory.getObjectInstance.

Creates a DataSource object using the javax.naming.Reference object specified.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

bdsClassName	back to summary
private static final String bdsClassName class names

databaseName	back to summary
private static final String databaseName

loginTimeoutName	back to summary
private static final String loginTimeoutName

passwordName	back to summary
private static final String passwordName

pdsClassName	back to summary
private static final String pdsClassName

poolClassName	back to summary
private static final String poolClassName

urlName	back to summary
private static final String urlName supported properties

userName	back to summary
private static final String userName

userNameName	back to summary
private static final String userNameName

xdsClassName	back to summary
private static final String xdsClassName

Constructor Detail

JDBCDataSourceFactory	back to summary
public JDBCDataSourceFactory()

Method Detail

createDataSource	back to summary
public static DataSource createDataSource(Properties props) throws Exception Static method to create a JDBCDataSource instance using the given properties for url, user, password, etc. Parameters props:Properties properties Returns:DataSource the data source instance Exceptions Exception: on any error

createDataSource

back to summary

public static DataSource createDataSource(Properties props) throws Exception

Static method to create a JDBCDataSource instance using the given properties for url, user, password, etc.

Parameters

props:Properties: properties

Returns:DataSource

the data source instance

Exceptions

Exception:: on any error

getObjectInstance	back to summary
public Object getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<K, V> environment) throws Exception Implements javax.naming.spi.ObjectFactory.getObjectInstance. Creates a DataSource object using the javax.naming.Reference object specified. The Reference object's class name should be one of the four supported data source class names and it must support the properties, database, user and password. It may optionally support the loginTimeout property. HyperSQL's JDBCPooledDataSource and JDBCXADataSource object are intended as factories used by a connection pooling DataSource. JDBCDataSource is a factory for normal connections and can be accessed directly by user applications. JDBCPool is a connection pool accessed directly by user applications. Parameters obj:Object The reference information used in creating a Datasource object. name:Name ignored nameCtx:Context ignored environment:Hashtable<K, V> ignored Returns:Object A newly created JDBCDataSource object; null if an object cannot be created. Exceptions Exception: is thrown if database or user is null or invalid

getObjectInstance

back to summary

public Object getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<K, V> environment) throws Exception

Implements javax.naming.spi.ObjectFactory.getObjectInstance.

Creates a DataSource object using the javax.naming.Reference object specified.

The Reference object's class name should be one of the four supported data source class names and it must support the properties, database, user and password. It may optionally support the loginTimeout property. HyperSQL's JDBCPooledDataSource and JDBCXADataSource object are intended as factories used by a connection pooling DataSource.

JDBCDataSource is a factory for normal connections and can be accessed directly by user applications.

JDBCPool is a connection pool accessed directly by user applications.

Parameters

obj:Object: The reference information used in creating a Datasource object.
name:Name: ignored
nameCtx:Context: ignored
environment:Hashtable<K, V>: ignored

Returns:Object

A newly created JDBCDataSource object; null if an object cannot be created.

Exceptions

Exception:: is thrown if database or user is null or invalid

public Class JDBCDataSourceFactory

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail