public class ClientDataSourceFactory extends java.lang.Object 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
interface. This interface contains a single method,
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 2.0 product.
|Constructor and Description|
|Modifier and Type||Method and Description|
Reconstructs a Derby client-driver data source object from a JNDI data source reference.
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
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.
refObj- the possibly
nullobject containing location or reference information that can be used in creating an object
name- the name of this object relative to
nullif no name is specified
nameContext- context relative to which the name parameter is specified, or
nullif name is relative to the default initial context.
nullenvironment that is used in creating the object.
nullif no attempt to create the object is made.
java.lang.Exception- if recreating the object fails