org.wildfly.naming.client

Class AbstractContext

java.lang.Object

org.wildfly.naming.client.AbstractContext

All Implemented Interfaces:

AutoCloseable, Context

Direct Known Subclasses:

AbstractFederatingContext, RelativeContext

public abstract class AbstractContext
extends Object
implements Context, AutoCloseable

An abstract Context implementation which does not support federation of naming systems (i.e. binding contexts from other naming systems). Such contexts can use names that do not follow the composite name syntax constraints, and may perform better.

Author:

David M. Lloyd

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

Constructors

Modifier	Constructor and Description
protected	AbstractContext() Construct a new instance.
protected	AbstractContext(FastHashtable<String,Object> environment) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
Object	addToEnvironment(String propName, Object propVal)
void	bind(Name name, Object obj)
void	bind(String name, Object obj)
protected void	bindNative(Name name, Object obj)
Name	composeName(Name name, Name prefix)
String	composeName(String name, String prefix)
Context	createSubcontext(Name name)
Context	createSubcontext(String name)
protected Context	createSubcontextNative(Name name)
protected Name	decomposeName(CompositeName compositeName)
void	destroySubcontext(Name name)
void	destroySubcontext(String name)
protected void	destroySubcontextNative(Name name)
FastHashtable<String,Object>	getEnvironment()
NameParser	getNameParser(Name name)
NameParser	getNameParser(String name)
NameParser	getNativeNameParser() Get the native name parser for this context.
CloseableNamingEnumeration<NameClassPair>	list(Name name)
CloseableNamingEnumeration<NameClassPair>	list(String name)
CloseableNamingEnumeration<Binding>	listBindings(Name name)
CloseableNamingEnumeration<Binding>	listBindings(String name)
protected abstract CloseableNamingEnumeration<Binding>	listBindingsNative(Name name)
protected abstract CloseableNamingEnumeration<NameClassPair>	listNative(Name name)
Object	lookup(Name name)
Object	lookup(String name)
Object	lookupLink(Name name)
Object	lookupLink(String name)
protected abstract Object	lookupLinkNative(Name name)
protected abstract Object	lookupNative(Name name) Look up a compound name within this naming system.
protected static NamingException	nameNotFound(Name name)
protected static OperationNotSupportedException	notSupported()
protected static NoPermissionException	readOnlyContext()
void	rebind(Name name, Object obj)
void	rebind(String name, Object obj)
protected void	rebindNative(Name name, Object obj)
Object	removeFromEnvironment(String propName)
void	rename(Name oldName, Name newName)
void	rename(String oldName, String newName)
protected void	renameNative(Name oldName, Name newName)
void	unbind(Name name)
void	unbind(String name)
protected void	unbindNative(Name name)

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.naming.Context

close, getNameInNamespace

Methods inherited from interface java.lang.AutoCloseable

close

Constructor Detail

AbstractContext

protected AbstractContext(FastHashtable<String,Object> environment)

Construct a new instance. The given environment map is used directly; the caller is responsible for creating a copy if a copy is needed.

Parameters:

environment - the environment map to use

AbstractContext

protected AbstractContext()

Construct a new instance. A new, empty environment map is created for this context.

Method Detail

getNativeNameParser

public NameParser getNativeNameParser()

Get the native name parser for this context. The name parser should always yield a compound name; returning a composite name may cause undefined results or infinite loops or recursion. The default implementation returns a name parser for SimpleName instances but may be overridden as desired.

Returns:

the name parser

lookup

public Object lookup(String name)
              throws NamingException

Specified by:

lookup in interface Context

Throws:

NamingException

lookup

public Object lookup(Name name)
              throws NamingException

Specified by:

lookup in interface Context

Throws:

NamingException

lookupNative

protected abstract Object lookupNative(Name name)
                                throws NamingException

Look up a compound name within this naming system. The given name is guaranteed not to be a CompositeName.

Parameters:

name - the (compound) name (not null)

Returns:

the binding value

Throws:

NamingException - if an error occurs

lookupLink

public Object lookupLink(String name)
                  throws NamingException

Specified by:

lookupLink in interface Context

Throws:

NamingException

lookupLink

public Object lookupLink(Name name)
                  throws NamingException

Specified by:

lookupLink in interface Context

Throws:

NamingException

lookupLinkNative

protected abstract Object lookupLinkNative(Name name)
                                    throws NamingException

Throws:

NamingException

bind

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

Specified by:

bind in interface Context

Throws:

NamingException

bind

public void bind(Name name,
                 Object obj)
          throws NamingException

Specified by:

bind in interface Context

Throws:

NamingException

bindNative

protected void bindNative(Name name,
                          Object obj)
                   throws NamingException

Throws:

NamingException

rebind

public void rebind(String name,
                   Object obj)
            throws NamingException

Specified by:

rebind in interface Context

Throws:

NamingException

rebind

public void rebind(Name name,
                   Object obj)
            throws NamingException

Specified by:

rebind in interface Context

Throws:

NamingException

rebindNative

protected void rebindNative(Name name,
                            Object obj)
                     throws NamingException

Throws:

NamingException

unbind

public void unbind(String name)
            throws NamingException

Specified by:

unbind in interface Context

Throws:

NamingException

unbind

public void unbind(Name name)
            throws NamingException

Specified by:

unbind in interface Context

Throws:

NamingException

unbindNative

protected void unbindNative(Name name)
                     throws NamingException

Throws:

NamingException

rename

public void rename(String oldName,
                   String newName)
            throws NamingException

Specified by:

rename in interface Context

Throws:

NamingException

rename

public void rename(Name oldName,
                   Name newName)
            throws NamingException

Specified by:

rename in interface Context

Throws:

NamingException

renameNative

protected void renameNative(Name oldName,
                            Name newName)
                     throws NamingException

Throws:

NamingException

list

public CloseableNamingEnumeration<NameClassPair> list(String name)
                                               throws NamingException

Specified by:

list in interface Context

Throws:

NamingException

list

public CloseableNamingEnumeration<NameClassPair> list(Name name)
                                               throws NamingException

Specified by:

list in interface Context

Throws:

NamingException

listNative

protected abstract CloseableNamingEnumeration<NameClassPair> listNative(Name name)
                                                                 throws NamingException

Throws:

NamingException

listBindings

public CloseableNamingEnumeration<Binding> listBindings(String name)
                                                 throws NamingException

Specified by:

listBindings in interface Context

Throws:

NamingException

listBindings

public CloseableNamingEnumeration<Binding> listBindings(Name name)
                                                 throws NamingException

Specified by:

listBindings in interface Context

Throws:

NamingException

listBindingsNative

protected abstract CloseableNamingEnumeration<Binding> listBindingsNative(Name name)
                                                                   throws NamingException

Throws:

NamingException

destroySubcontext

public void destroySubcontext(String name)
                       throws NamingException

Specified by:

destroySubcontext in interface Context

Throws:

NamingException

destroySubcontext

public void destroySubcontext(Name name)
                       throws NamingException

Specified by:

destroySubcontext in interface Context

Throws:

NamingException

destroySubcontextNative

protected void destroySubcontextNative(Name name)
                                throws NamingException

Throws:

NamingException

createSubcontext

public Context createSubcontext(String name)
                         throws NamingException

Specified by:

createSubcontext in interface Context

Throws:

NamingException

createSubcontext

public Context createSubcontext(Name name)
                         throws NamingException

Specified by:

createSubcontext in interface Context

Throws:

NamingException

createSubcontextNative

protected Context createSubcontextNative(Name name)
                                  throws NamingException

Throws:

NamingException

composeName

public Name composeName(Name name,
                        Name prefix)
                 throws NamingException

Specified by:

composeName in interface Context

Throws:

NamingException

composeName

public String composeName(String name,
                          String prefix)
                   throws NamingException

Specified by:

composeName in interface Context

Throws:

NamingException

getNameParser

public NameParser getNameParser(Name name)
                         throws NamingException

Specified by:

getNameParser in interface Context

Throws:

NamingException

getNameParser

public NameParser getNameParser(String name)
                         throws NamingException

Specified by:

getNameParser in interface Context

Throws:

NamingException

decomposeName

protected Name decomposeName(CompositeName compositeName)
                      throws NamingException

Throws:

NamingException

addToEnvironment

public Object addToEnvironment(String propName,
                               Object propVal)

Specified by:

addToEnvironment in interface Context

removeFromEnvironment

public Object removeFromEnvironment(String propName)

Specified by:

removeFromEnvironment in interface Context

getEnvironment

public FastHashtable<String,Object> getEnvironment()
                                            throws NamingException

Specified by:

getEnvironment in interface Context

Throws:

NamingException

nameNotFound

protected static NamingException nameNotFound(Name name)

readOnlyContext

protected static NoPermissionException readOnlyContext()

notSupported

protected static OperationNotSupportedException notSupported()