org.wildfly.naming.client.remote

Class RemoteNamingProviderFactory

java.lang.Object

org.wildfly.naming.client.remote.RemoteNamingProviderFactory

All Implemented Interfaces:

NamingProviderFactory

@MetaInfServices
public final class RemoteNamingProviderFactory
extends Object
implements NamingProviderFactory

Author:

David M. Lloyd

Field Summary

Fields

Modifier and Type	Field and Description
static String	USE_SEPARATE_CONNECTION An environment attribute indicating that a separate Remoting connection should be used for this initial context.

Constructor Summary

Constructors

Constructor and Description
RemoteNamingProviderFactory()

Method Summary

Modifier and Type	Method and Description
NamingProvider	createProvider(URI providerUri, FastHashtable<String,Object> env) Create the naming provider instance for a provider URI.
boolean	supportsUriScheme(String providerScheme) Determine if this provider supports the given PROVIDER_URL scheme.

Methods inherited from class java.lang.Object

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

Field Detail

USE_SEPARATE_CONNECTION

public static final String USE_SEPARATE_CONNECTION

An environment attribute indicating that a separate Remoting connection should be used for this initial context. Normally, it is preferable to use managed connections, but in some special circumstances it is expedient to create an unmanaged, separate connection. Note that using unmanaged connections can result in additional resource consumption and should be avoided in most situations.

Separate connections use the captured authentication context for authentication decisions unless a principal or authentication configuration is set in the environment.

A separate connection's lifespan is bound to the lifespan of the InitialContext that it belongs to. It must be closed to prevent possible resource exhaustion.

See Also:

Constant Field Values

Constructor Detail

RemoteNamingProviderFactory

public RemoteNamingProviderFactory()

Method Detail

supportsUriScheme

public boolean supportsUriScheme(String providerScheme)

Description copied from interface: NamingProviderFactory

Determine if this provider supports the given PROVIDER_URL scheme.

Specified by:

supportsUriScheme in interface NamingProviderFactory

Parameters:

providerScheme - the provider URL scheme, or null if no provider URL was given

Returns:

true if this provider supports the given schemes, false otherwise

createProvider

public NamingProvider createProvider(URI providerUri,
                                     FastHashtable<String,Object> env)
                              throws NamingException

Description copied from interface: NamingProviderFactory

Create the naming provider instance for a provider URI.

Specified by:

createProvider in interface NamingProviderFactory

Parameters:

providerUri - the URI from the Context.PROVIDER_URL environment property, or null if none was given

env - a copy of the environment which may be consumed directly by the provider (not null)

Returns:

the root context (must not be null)

Throws:

NamingException - if the root context creation failed for some reason