Module org.hsqldb

Class JDBCDataSourceFactory

  • All Implemented Interfaces:
    javax.naming.spi.ObjectFactory

    public class JDBCDataSourceFactory
    extends java.lang.Object
    implements javax.naming.spi.ObjectFactory
    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.
    Author:
    Darin DeForest (deforest@users dot sourceforge.net) original version, Fred Toussi (fredt@users dot sourceforge.net)
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static javax.sql.DataSource createDataSource​(java.util.Properties props)
      Static method to create a JDBCDataSource instance using the given properties for url, user, password, etc.
      java.lang.Object getObjectInstance​(java.lang.Object obj, javax.naming.Name name, javax.naming.Context nameCtx, java.util.Hashtable environment)
      Creates a DataSource object using the javax.naming.Reference object specified.
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • JDBCDataSourceFactory

        public JDBCDataSourceFactory()
    • Method Detail

      • createDataSource

        public static javax.sql.DataSource createDataSource​(java.util.Properties props)
                                                     throws java.lang.Exception
        Static method to create a JDBCDataSource instance using the given properties for url, user, password, etc.
        Parameters:
        props - properties
        Returns:
        the data source instance
        Throws:
        java.lang.Exception - on any error
      • getObjectInstance

        public java.lang.Object getObjectInstance​(java.lang.Object obj,
                                                  javax.naming.Name name,
                                                  javax.naming.Context nameCtx,
                                                  java.util.Hashtable environment)
                                           throws java.lang.Exception
        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.

        Specified by:
        getObjectInstance in interface javax.naming.spi.ObjectFactory
        Parameters:
        obj - The reference information used in creating a Datasource object.
        name - ignored
        nameCtx - ignored
        environment - ignored
        Returns:
        A newly created JDBCDataSource object; null if an object cannot be created.
        Throws:
        java.lang.Exception - is thrown if database or user is null or invalid