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

java.lang.Object
  |
  +--com.beasys.commerce.axiom.util.helper.JNDIHelper

All Implemented Interfaces:

ToolkitConstants

public class JNDIHelper

extends java.lang.Object

implements ToolkitConstants

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

Version:

$Revision: 2$, $Date: 2/15/00 11:10:04 AM$

Author:

Scott Musson

Fields inherited from interface com.beasys.commerce.axiom.util.ToolkitConstants

DEFAULT_ID_CACHE, DEFAULT_ID_PROCEDURE, DEFAULT_JDBC_POOL_NAME, DEFAULT_JTS_POOL_NAME, DEFAULT_LOGGING_LEVEL, DEFAULT_WEBLOGIC_HOST, DEFAULT_WEBLOGIC_PORT, ID_CACHE, ID_PROCEDURE, JDBC_POOL_NAME, JTS_POOL_NAME, LOG_DEBUG, LOG_ERROR, LOG_FATAL, LOG_INFO, LOG_SECURITY, LOG_WARNING, LOGGING_LEVEL, WEBLOGIC_HOST, WEBLOGIC_PORT

Constructor Summary

JNDIHelper()

Method Summary

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JNDIHelper

public JNDIHelper()

Method Detail

create

public static javax.naming.Context create(java.util.Hashtable props)
                                   throws javax.naming.NamingException

Create a new context based on the properties file.

Parameters:

props - the properties for the JNDI implementation.

Returns:

Context

Throws:

ToolkitException -

getDefaultContext

public static javax.naming.Context getDefaultContext()

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

createDefault

public static java.util.Hashtable createDefault()

Create the default context hashtable for creating the InitialContext.

Returns:

Hashtable

lookup

public static java.lang.Object lookup(java.lang.String aLookupName)
                               throws ToolkitException

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

Parameters:

String - the lookup name.

Returns:

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

Throws:

ToolkitException - holder for any exception

bind

public static void bind(java.lang.String name,
                        java.lang.Object obj)
                 throws javax.naming.NamingException

Bind an object into the local naming context.

Parameters:

name - the name (can be multi-part).

obj - the object.

Throws:

javax.naming.NamingException - thrown on a naming error.

See Also:

bind(javax.naming.Context, java.lang.String, java.lang.Object), getDefaultContext()

bind

public static void bind(javax.naming.Context ctx,
                        java.lang.String name,
                        java.lang.Object obj)
                 throws javax.naming.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.

Throws:

javax.naming.NamingException - thrown on a naming error.

See Also:

createSubcontext(javax.naming.Context, java.lang.String)

createSubcontext

protected static javax.naming.Context createSubcontext(javax.naming.Context initial,
                                                       java.lang.String name)
                                                throws javax.naming.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.

Throws:

javax.naming.NamingException - thrown is the name cannot be created.

getService

public static java.lang.Object getService(java.lang.String aLookupName)
                                   throws ToolkitException

Deprecated. See lookup

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

Parameters:

String - the lookup name.

Returns:

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

Throws:

ToolkitException - holder for any exception

getHome

public static java.lang.Object getHome(java.lang.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.

Throws:

ToolkitException - thrown on a lookup error.

getHome

public static java.lang.Object getHome(javax.naming.Context ctx,
                                       java.lang.String homeName)
                                throws javax.naming.NamingException

Get home.

Parameters:

ctx -

homeName -

Returns:

Object

Throws:

NamingException -