DEPRECATED Use `com.bea.p13n.util.JndiHelper```

# com.beasys.commerce.axiom.util.helper
JNDIHelper Class

public class JNDIHelper
extends `Object`
implements `com.beasys.commerce.axiom.util.ToolkitConstants`

Single point of access to the application server. This should make it easy to swap out servers, and processes.

Hierarchy
  `Object`
  `JNDIHelper`

All Implemented Interfaces
  `com.beasys.commerce.axiom.util.ToolkitConstants`

## Constructor Summary

JNDIHelper()

## Method Summary

`public static void` | `bind`(`String` name, `Object` obj) Bind an object into the local naming context.
`public static void` | `bind`(`Context` ctx, `String` name, `Object` obj) Bind an object to name in the given context.
`public static `Context`` | `create`(`Hashtable` props) Create a new context based on the properties file.
`public static `Hashtable`` | `createDefault`() Create the default context hashtable for creating the InitialContext.
`protected static `Context`` | `createSubcontext`(`Context` initial, `String` name) Create a subcontext for the given name.
`public static `Context`` | `getDefaultContext`() The default context.
`public static `Object`` | `getHome`(`String` homeName) Safely retrieve an EJBHome by passing it through the PortableRemoteObject.narrow method, using the EJBMetaData.
`public static `Object`` | `getHome`(`Context` ctx, `String` homeName) Get home.
`public static `Object`` | `getService`(`String` aLookupName) Connect to a reference in JNDI referred to by the lookup name.
`public static `Object`` | `lookup`(`String` aLookupName) Connect to a reference in JNDI referred to by the lookup name.

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

## Constructor Detail

### JNDIHelper

    public JNDIHelper()

## Method Detail

### bind(String, Object) Method

    public static void bind(String name,
                            Object obj)
         throws NamingException

Bind an object into the local naming context.

#### Parameters

name
  the name (can be multi-part).

obj
  the object.

#### Exceptions

``NamingException``
  thrown on a naming error.

Related Topics

``JNDIHelper.bind(Context, String, Object)``
``JNDIHelper.getDefaultContext()``

### bind(Context, String, Object) Method

    public static void bind(Context ctx,
                            String name,
                            Object obj)
         throws NamingException

Bind an object to name in the given context.

This supports binding multi-part names by creating the required sub Contexts as needed. If an object is already bound there, this will do a rebind.

#### Parameters

ctx
  the naming Context.

name
  the name (can be multi-part).

obj
  the object.

#### Exceptions

``NamingException``
  thrown on a naming error.

Related Topics

``JNDIHelper.createSubcontext(Context, String)``

### create(Hashtable) Method

    public static Context create(Hashtable props)
         throws NamingException

Create a new context based on the properties file.

#### Parameters

props
  the properties for the JNDI implementation.

#### Returns

`Context`

#### Exceptions

``NamingException``

### createDefault() Method

    public static Hashtable createDefault()

Create the default context hashtable for creating the InitialContext.

#### Returns

`Hashtable`

### createSubcontext(Context, String) Method

    protected static Context createSubcontext(Context initial,
                                              String name)
         throws NamingException

Create a subcontext for the given name.

This will not create the last portion of the name.

#### Parameters

initial
  the initial context to start at.

name
  the name (can be multi-part).

#### Returns

the subcontext.

#### Exceptions

``NamingException``
  thrown is the name cannot be created.

### getDefaultContext() Method

    public static Context getDefaultContext()

The default context. This will look to see if a default context has been created

### getHome(String) Method

    public static Object getHome(String homeName)
         throws ToolkitException

Safely retrieve an EJBHome by passing it through the PortableRemoteObject.narrow method, using the EJBMetaData.

If rmi-iiop is not being used, this will just do a lookup.

#### Parameters

homeName
  the JNDI name of the home.

#### Returns

the home, safely narrowed to the home interface class.

#### Exceptions

``ToolkitException``
  thrown on a lookup error.

### getHome(Context, String) Method

    public static Object getHome(Context ctx,
                                 String homeName)
         throws NamingException

Get home.

#### Returns

`Object`

#### Exceptions

``NamingException``

### getService(String) Method

DEPRECATED See lookup

    public static Object getService(String aLookupName)
         throws ToolkitException

Connect to a reference in JNDI referred to by the lookup name.

#### Parameters

aLookupName
  the lookup name.

#### Returns

Object the object referenced by the name. Use this to get handles to Home interfaces, RMI objects, etc.

#### Exceptions

``ToolkitException``
  holder for any exception

### lookup(String) Method

    public static Object lookup(String aLookupName)
         throws ToolkitException

Connect to a reference in JNDI referred to by the lookup name.

#### Parameters

aLookupName
  the lookup name.

#### Returns

Object the object referenced by the name. Use this to get handles to Home interfaces, RMI objects, etc.

#### Exceptions

``ToolkitException``
  holder for any exception