Package org.wildfly.naming.client.remote

Class RemoteNamingProvider

  • All Implemented Interfaces:
    AutoCloseable, NamingProvider
    public final class RemoteNamingProvider
extends Object
implements NamingProvider
    A provider for JBoss Remoting-based JNDI contexts. Any scheme which uses JBoss Remoting using this provider will share a connection and a captured security context.
    Author:
    David M. Lloyd

    • Method Detail

      • getEndpoint

        public org.jboss.remoting3.Endpoint getEndpoint()
        Get the Remoting endpoint for this provider.
        Returns:
        the Remoting endpoint for this provider (not null)

      • getPeerIdentityForNaming

        public org.jboss.remoting3.ConnectionPeerIdentity getPeerIdentityForNaming()
                                                                    throws NamingException
        Get the connection peer identity for a naming operation. If the connection is not configured as immediate, then the connection will not actually be established until this method is called. The resultant connection should be closed and discarded in the event of an error, in order to facilitate automatic reconnection.
        Specified by:
        getPeerIdentityForNaming in interface NamingProvider
        Returns:
        the connection peer identity (not null)
        Throws:
        NamingException - if connecting, authenticating, or re-authenticating the peer failed

      • getPeerIdentityForNamingUsingRetry

        public org.jboss.remoting3.ConnectionPeerIdentity getPeerIdentityForNamingUsingRetry​(RetryContext context)
                                                                              throws NamingException
        Description copied from interface: NamingProvider
        Get a peer identity to use for context operations, retrying on failure. The identity may be fixed or it may vary, depending on the context configuration. If the provider has multiple locations, a location is randomly selected. If the retry context is null, a retry will not occur.
        Specified by:
        getPeerIdentityForNamingUsingRetry in interface NamingProvider
        Parameters:
        context - the retry context for storing state required when retrying
        Returns:
        the peer identity to use (must not be null)
        Throws:
        NamingException - if connecting, authenticating, or re-authenticating the peer failed

      • getPeerIdentityForNaming

        public org.jboss.remoting3.ConnectionPeerIdentity getPeerIdentityForNaming​(URI location)
                                                                    throws NamingException
        Get the connection peer identity for a naming operation. If the connection is not configured as immediate, then the connection will not actually be established until this method is called. The resultant connection should be closed and discarded in the event of an error, in order to facilitate automatic reconnection.
        Specified by:
        getPeerIdentityForNaming in interface NamingProvider
        Parameters:
        location - a location from ProviderEnvironment.getProviderUris() (must not be null)
        Returns:
        the connection peer identity (not null)
        Throws:
        NamingException - if connecting, authenticating, or re-authenticating the peer failed

      • getPeerIdentity

        public org.jboss.remoting3.ConnectionPeerIdentity getPeerIdentity​(URI location)
                                                           throws IOException
        Get the connection peer identity. If the connection is not configured as immediate, then the connection will not actually be established until this method is called. The resultant connection should be closed and discarded in the event of an error, in order to facilitate automatic reconnection.
        Parameters:
        location - a location from ProviderEnvironment.getProviderUris() (must not be null)
        Returns:
        the connection peer identity (not null)
        Throws:
        org.wildfly.security.auth.AuthenticationException - if authenticating or re-authenticating the peer failed
        IOException - if connecting the peer failed

      • getFuturePeerIdentity

        public org.xnio.IoFuture<org.jboss.remoting3.ConnectionPeerIdentity> getFuturePeerIdentity​(URI location)
        Get the future connection peer identity. If the connection is not configured as immediate, then the connection will not actually be established until this method is called. The resultant connection should be closed and discarded in the event of an error, in order to facilitate automatic reconnection.
        Parameters:
        location - a location from ProviderEnvironment.getProviderUris() (must not be null)
        Returns:
        the future connection peer identity (not null)