public class ReferenceableDataSource extends BasicEmbeddedDataSource40 implements javax.naming.spi.ObjectFactory
This factory reconstructs a Derby data source object when it is retrieved
from JNDI. References are needed since many naming services don't have the
ability to store Java objects in their serialized form. When a data source
object is bound in this type of naming service the
Reference
for that object is actually stored by the
JNDI implementation, not the data source object itself.
A JNDI administrator is responsible for making sure that both the object factory and data source implementation classes provided by a JDBC driver vendor are accessible to the JNDI service provider at runtime.
An object factory implements the ObjectFactory
interface. This interface contains a single method, getObjectInstance
which is called by a JNDI service provider to reconstruct an object when that
object is retrieved from JNDI. A JDBC driver vendor should provide an object
factory as part of their JDBC product.
Modifier and Type | Field and Description |
---|---|
private static java.lang.Class<?>[] |
BOOLEAN_ARG |
private static java.lang.Class<?>[] |
INT_ARG |
private static long |
serialVersionUID |
private static java.lang.Class<?>[] |
SHORT_ARG |
private static java.lang.Class<?>[] |
STRING_ARG |
attributesAsPassword, connectionAttributes, createDatabase, databaseName, dataSourceName, description, driver, jdbcurl, loginTimeout, shutdownDatabase
Constructor and Description |
---|
ReferenceableDataSource() |
Modifier and Type | Method and Description |
---|---|
java.lang.Object |
getObjectInstance(java.lang.Object refObj,
javax.naming.Name name,
javax.naming.Context nameContext,
java.util.Hashtable<?,?> environment)
Reconstructs a Derby embedded-driver data source object from a JNDI data
source reference.
|
private static void |
setBeanProperties(java.lang.Object ds,
javax.naming.Reference ref) |
equals, findDriver, getAttributesAsPassword, getConnection, getConnection, getConnection, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getLoginTimeout, getLogWriter, getParentLogger, getPassword, getShutdownDatabase, getUser, hashCode, isWrapperFor, setAttributesAsPassword, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setLoginTimeout, setLogWriter, setPassword, setShutdownDatabase, setupResourceAdapter, setUser, unwrap, update
private static final long serialVersionUID
private static final java.lang.Class<?>[] STRING_ARG
private static final java.lang.Class<?>[] INT_ARG
private static final java.lang.Class<?>[] BOOLEAN_ARG
private static final java.lang.Class<?>[] SHORT_ARG
public java.lang.Object getObjectInstance(java.lang.Object refObj, javax.naming.Name name, javax.naming.Context nameContext, java.util.Hashtable<?,?> environment) throws java.lang.Exception
The getObjectInstance
method is passed a reference that
corresponds to the object being retrieved as its first parameter. The
other parameters are optional in the case of JDBC data source objects.
The object factory should use the information contained in the reference
to reconstruct the data source. If for some reason, a data source
object cannot be reconstructed from the reference, a value of
null
may be returned. This allows other object factories that may
be registered in JNDI to be tried. If an exception is thrown then no
other object factories are tried.
getObjectInstance
in interface javax.naming.spi.ObjectFactory
refObj
- the possibly null
object containing location or
reference information that can be used in creating an objectname
- the name of this object relative to nameContext
, or
null
if no name is specifiednameContext
- context relative to which the name parameter is
specified, or null
if name is relative to the default
initial context.environment
- possibly null
environment that is used in
creating the object.null
if no attempt to create the
object is made.java.lang.Exception
- if recreating the object failsprivate static void setBeanProperties(java.lang.Object ds, javax.naming.Reference ref) throws java.lang.Exception
java.lang.Exception
Apache Derby V10.13 Internals - Copyright © 2004,2016 The Apache Software Foundation. All Rights Reserved.