Class ReferenceableUtils

java.lang.Object

com.mchange.v2.naming.ReferenceableUtils

public final class ReferenceableUtils
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ReferenceableUtils.ExtractRec	Deprecated. nesting references seemed useful until I realized that references are Serializable and can be stored in a BinaryRefAddr.

Field Summary

Fields

Modifier and Type	Field	Description
static final Set	ALL_FACTORY_CLASS_NAMES

Method Summary

Modifier and Type	Method	Description
static boolean	acceptDeserializedInitialContextEnvironment(PropertiesConfig pcfg)
static void	appendToReference(Reference appendTo, Reference orig)	Deprecated. nesting references seemed useful until I realized that references are Serializable and can be stored in a BinaryRefAddr.
static void	assertAcceptableName(Object jndiName, PropertiesConfig pcfg)
static ReferenceableUtils.ExtractRec	extractNestedReference(Reference extractFrom, int index)	Deprecated. nesting references seemed useful until I realized that references are Serializable and can be stored in a BinaryRefAddr.
static String	literalNullToNull(String s)	A null string value in a Reference sometimes goes to the literal "null".
static Object	referenceToObject(Reference ref, Name name, Context nameCtx, Hashtable env)
static Object	referenceToObject(Reference ref, Name name, Context nameCtx, Hashtable env, PropertiesConfig pcfg)
static Object	referenceToObject(Reference ref, Name name, Context nameCtx, Hashtable env, Set allowedFactoryClassNames)	The allowedFactoryClassNames whitelist test can be (but generally should not be) circumvented by explicitly providing ReferenceUtils.ALL_FACTORY_CLASS_NAMES as the argument allowedFactoryClassNames.
static Object	referenceToObject(Reference ref, Name name, Context nameCtx, Hashtable env, Set allowedFactoryClassNames, PropertiesConfig pcfg)	The allowedFactoryClassNames whitelist test can be (but generally should not be) circumvented by explicitly providing ReferenceUtils.ALL_FACTORY_CLASS_NAMES as the argument allowedFactoryClassNames.
static boolean	supportReferenceRemoteFactoryClassLocation(PropertiesConfig pcfg)

Methods inherited from class Object

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

Field Details

ALL_FACTORY_CLASS_NAMES

public static final Set ALL_FACTORY_CLASS_NAMES

Method Details

literalNullToNull

public static String literalNullToNull(String s)

A null string value in a Reference sometimes goes to the literal "null". Sigh. We convert this string to a Java null.

referenceToObject

public static Object referenceToObject(Reference ref,
 Name name,
 Context nameCtx,
 Hashtable env)
                                throws NamingException

Throws:

NamingException

referenceToObject

public static Object referenceToObject(Reference ref,
 Name name,
 Context nameCtx,
 Hashtable env,
 PropertiesConfig pcfg)
                                throws NamingException

Throws:

NamingException

referenceToObject

public static Object referenceToObject(Reference ref,
 Name name,
 Context nameCtx,
 Hashtable env,
 Set allowedFactoryClassNames)
                                throws NamingException

The allowedFactoryClassNames whitelist test can be (but generally should not be) circumvented by explicitly providing ReferenceUtils.ALL_FACTORY_CLASS_NAMES as the argument allowedFactoryClassNames. allowedFactoryClassNames must not be null. (A NullPointerException will be provoked if it is.)

Throws:

NamingException

referenceToObject

public static Object referenceToObject(Reference ref,
 Name name,
 Context nameCtx,
 Hashtable env,
 Set allowedFactoryClassNames,
 PropertiesConfig pcfg)
                                throws NamingException

The allowedFactoryClassNames whitelist test can be (but generally should not be) circumvented by explicitly providing ReferenceUtils.ALL_FACTORY_CLASS_NAMES as the argument allowedFactoryClassNames. allowedFactoryClassNames must not be null. (A NullPointerException will be provoked if it is.)

Throws:

NamingException

assertAcceptableName

public static void assertAcceptableName(Object jndiName,
 PropertiesConfig pcfg)
                                 throws NamingException

Throws:

NamingException

supportReferenceRemoteFactoryClassLocation

public static boolean supportReferenceRemoteFactoryClassLocation(PropertiesConfig pcfg)

acceptDeserializedInitialContextEnvironment

public static boolean acceptDeserializedInitialContextEnvironment(PropertiesConfig pcfg)

appendToReference

public static void appendToReference(Reference appendTo,
 Reference orig)
                              throws NamingException

Deprecated.

nesting references seemed useful until I realized that references are Serializable and can be stored in a BinaryRefAddr. Oops.

Throws:

NamingException

extractNestedReference

public static ReferenceableUtils.ExtractRec extractNestedReference(Reference extractFrom,
 int index)
                                                            throws NamingException

Deprecated.

nesting references seemed useful until I realized that references are Serializable and can be stored in a BinaryRefAddr. Oops.

Throws:

NamingException