Overview | Package | Class | Tree | Deprecated | Index | Help

3.00.12
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## interbase.interclient
Class ObjectFactory

    java.lang.Object
      |
      +--interbase.interclient.ObjectFactory

All Implemented Interfaces:
  javax.naming.spi.ObjectFactory

public class ObjectFactory
extends Object
implements javax.naming.spi.ObjectFactory

The component that actually reconstructs a 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 javax.naming.spi.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 2.0 product.

Since:
  JDBC 2 Standard Extension, proposed for InterClient 3.0
Version:
  JNDI 1.1.1
See Also:
  `DataSource`

Constructor Summary
`ObjectFactory()`

Method Summary
`Object` | `getObjectInstance(Object refObj, javax.naming.Name name, javax.naming.Context nameCtx, Hashtable env)` Reconstructs an InterClient data source object from a JNDI data source reference.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### ObjectFactory

    public ObjectFactory()

Method Detail

### getObjectInstance

    public Object getObjectInstance(Object refObj,
                                    javax.naming.Name name,
                                    javax.naming.Context nameCtx,
                                    Hashtable env)
                             throws Exception

  Reconstructs an InterClient data source object from a JNDI data source reference.

  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.

  Specified by:
    `getObjectInstance` in interface `javax.naming.spi.ObjectFactory`
  Since:
    JDBC 2 Standard Extension, proposed for InterClient 3.0

Overview | Package | Class | Tree | Deprecated | Index | Help

3.00.12
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Send comments or suggestions to interclient@borland.com