URLPreferringContextDecorator (RHQ Enterprise Container Library 4.5.1 API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.rhq.jndi.context
Class URLPreferringContextDecorator

java.lang.Object
  org.rhq.jndi.context.URLPreferringContextDecorator

All Implemented Interfaces:: Serializable, Context, ContextDecorator

Direct Known Subclasses:: URLPreferringDirContextDecorator, URLPreferringEventContextDecorator

public class URLPreferringContextDecorator
extends Object
implements Context, ContextDecorator, Serializable
extends Object
implements Context, ContextDecorator, Serializable

This is a wrapper class around another Context implementation that prefers to use an URL context for some operation if the JNDI name contains a scheme rather than the original. This is the behavior of InitialContext which we need to restore in the contexts created by the AccessCheckingInitialContextFactoryBuilder (which an InitialContext uses exclusively if the builder is set).

This is important because RHQ server has its own initial context factory builder that creates factories that in turn create contexts. If the default InitialContext implementation was used, we'd never be able to lookup scheme-based names because the default implementation of the InitialContext always uses the default context of the builder if one is installed no matter the scheme in the name.

The AccessCheckingInitialContextFactoryBuilder wraps the context returned by the factory in an instance of this class and thus is restoring the original intended behavior of the InitialContext. It looks at the name being looked up (bound or whatever) and prefers to use the URL context factories if the name contains the scheme (as does the InitialContext if no builder is installed). If the name doesn't contain a scheme, the provided default context factory is used to look up the name.

Author:: Lukas Krejci
See Also:: Serialized Form

Field Summary

Fields inherited from interface javax.naming.Context
`APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES`

Constructor Summary
`URLPreferringContextDecorator()`
`URLPreferringContextDecorator(Context ctx)`

Method Summary
`Object`	`addToEnvironment(String propName, Object propVal)`
`void`	`bind(Name name, Object obj)`
`void`	`bind(String name, Object obj)`
`void`	`close()`
`Name`	`composeName(Name name, Name prefix)`
`String`	`composeName(String name, String prefix)`
`Context`	`createSubcontext(Name name)`
`Context`	`createSubcontext(String name)`
`void`	`destroySubcontext(Name name)`
`void`	`destroySubcontext(String name)`
`boolean`	`equals(Object o)`
`Hashtable<?,?>`	`getEnvironment()`
`String`	`getNameInNamespace()`
`NameParser`	`getNameParser(Name name)`
`NameParser`	`getNameParser(String name)`
`protected Context`	`getOriginal()`
`protected Context`	`getURLOrDefaultInitCtx(Name name)`
`protected Context`	`getURLOrDefaultInitCtx(String name)`
`int`	`hashCode()`
`void`	`init(Context context)`
`NamingEnumeration<NameClassPair>`	`list(Name name)`
`NamingEnumeration<NameClassPair>`	`list(String name)`
`NamingEnumeration<Binding>`	`listBindings(Name name)`
`NamingEnumeration<Binding>`	`listBindings(String name)`
`Object`	`lookup(Name name)`
`Object`	`lookup(String name)`
`Object`	`lookupLink(Name name)`
`Object`	`lookupLink(String name)`
`void`	`rebind(Name name, Object obj)`
`void`	`rebind(String name, Object obj)`
`Object`	`removeFromEnvironment(String propName)`
`void`	`rename(Name oldName, Name newName)`
`void`	`rename(String oldName, String newName)`
`void`	`unbind(Name name)`
`void`	`unbind(String name)`

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

Constructor Detail