Package org.apache.qpid.protonj2.client.exceptions

Class ClientLinkRedirectedException

  • All Implemented Interfaces:
    java.io.Serializable
    public class ClientLinkRedirectedException
extends ClientLinkRemotelyClosedException
    A ClientLinkRemotelyClosedException type that defines that the remote peer has requested that this link be redirected to some alternative peer. The redirect information can be obtained by calling the getRedirectionURI() method which return the URI of the peer the client is being redirect to. The address is also accessible for use in creating a new link after reconnection.
    See Also:
    Serialized Form

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getAddress()
      The address value that should be used when connecting to the provided host and port and creating a new link instance as directed.
      java.lang.String getHostname()
      the host name of the remote peer where the Sender or Receiver is being redirected.
      java.lang.String getNetworkHost()
      A network level host name that matches either the DNS hostname or IP address of the remote container.
      java.lang.String getPath()
      The path value that should be used when connecting to the provided host and port.
      int getPort()
      A network level port value that should be used when redirecting this connection.
      java.net.URI getRedirectionURI()
      Attempt to construct a URI that represents the location where the redirect is sending the client Sender or Receiver.
      java.lang.String getScheme()
      Returns the connection scheme that should be used when connecting to the remote host and port provided in this redirection.

      • Methods inherited from class java.lang.Throwable

        addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • ClientLinkRedirectedException

        public ClientLinkRedirectedException​(java.lang.String reason,
                                     ClientRedirect redirect,
                                     ErrorCondition condition)
        Create a new instance of the link redirected exception
        Parameters:
        reason - The reason for the link redirect
        redirect - A ClientRedirect object with redirection information.
        condition - The error condition that was provided from the remote peer.

    • Method Detail

      • getHostname

        public java.lang.String getHostname()
        the host name of the remote peer where the Sender or Receiver is being redirected.

        This value should be used in the 'hostname' field of the Open frame, and during SASL negotiation (if used). When using this client to reconnect this value would be assigned to the ConnectionOptions.virtualHost(String) value in the ConnectionOptions passed to the newly created Connection.

        Returns:
        the host name of the remote AMQP container to redirect to.

      • getNetworkHost

        public java.lang.String getNetworkHost()
        A network level host name that matches either the DNS hostname or IP address of the remote container.
        Returns:
        the network level host name value where the connection is being redirected.

      • getPort

        public int getPort()
        A network level port value that should be used when redirecting this connection.
        Returns:
        the network port value where the connection is being redirected.

      • getScheme

        public java.lang.String getScheme()
        Returns the connection scheme that should be used when connecting to the remote host and port provided in this redirection.
        Returns:
        the connection scheme to use when redirecting to the provided host and port.

      • getPath

        public java.lang.String getPath()
        The path value that should be used when connecting to the provided host and port.
        Returns:
        the path value that should be used when redirecting to the provided host and port.

      • getAddress

        public java.lang.String getAddress()
        The address value that should be used when connecting to the provided host and port and creating a new link instance as directed.
        Returns:
        the address value that should be used when redirecting to the provided host and port.

      • getRedirectionURI

        public java.net.URI getRedirectionURI()
                               throws java.lang.Exception
        Attempt to construct a URI that represents the location where the redirect is sending the client Sender or Receiver.
        Returns:
        the URI that represents the redirection.
        Throws:
        java.lang.Exception - if an error occurs while converting the redirect into a URI.