org.apache.qpid.jms.provider.amqp

Class AmqpSupport

java.lang.Object

org.apache.qpid.jms.provider.amqp.AmqpSupport

public class AmqpSupport
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.qpid.proton.amqp.Symbol	ANONYMOUS_RELAY
static org.apache.qpid.proton.amqp.Symbol	CONNECTION_OPEN_FAILED
static org.apache.qpid.proton.amqp.Symbol	CONTAINER_ID
static org.apache.qpid.proton.amqp.Symbol	COPY
static org.apache.qpid.proton.amqp.Symbol	DELAYED_DELIVERY
static org.apache.qpid.proton.amqp.Symbol	DYNAMIC_NODE_LIFETIME_POLICY
static org.apache.qpid.proton.amqp.Symbol	FAILOVER_SERVER_LIST
static org.apache.qpid.proton.amqp.Symbol	GLOBAL
static org.apache.qpid.proton.amqp.Symbol	INVALID_FIELD
static org.apache.qpid.proton.amqp.Symbol	JMS_NO_LOCAL_SYMBOL
static org.apache.qpid.proton.amqp.Symbol	JMS_SELECTOR_SYMBOL
static org.apache.qpid.proton.amqp.messaging.Modified	MODIFIED_FAILED
static org.apache.qpid.proton.amqp.messaging.Modified	MODIFIED_FAILED_UNDELIVERABLE
static org.apache.qpid.proton.amqp.Symbol	NETWORK_HOST
static org.apache.qpid.proton.amqp.Symbol	OPEN_HOSTNAME
static org.apache.qpid.proton.amqp.Symbol	PATH
static org.apache.qpid.proton.amqp.Symbol	PLATFORM
static org.apache.qpid.proton.amqp.Symbol	PORT
static org.apache.qpid.proton.amqp.Symbol	PRODUCT
static org.apache.qpid.proton.amqp.Symbol	QUEUE_PREFIX
static org.apache.qpid.proton.amqp.messaging.Rejected	REJECTED
static org.apache.qpid.proton.amqp.Symbol	SCHEME
static org.apache.qpid.proton.amqp.Symbol	SHARED
static org.apache.qpid.proton.amqp.Symbol	SHARED_SUBS
static org.apache.qpid.proton.amqp.Symbol	SOLE_CONNECTION_CAPABILITY
static String	SUB_NAME_DELIMITER
static String	TEMP_QUEUE_CREATOR
static String	TEMP_TOPIC_CREATOR
static org.apache.qpid.proton.amqp.Symbol	TOPIC_PREFIX
static org.apache.qpid.proton.amqp.Symbol	VERSION

Constructor Summary

Constructors

Constructor and Description
AmqpSupport()

Method Summary

Modifier and Type	Method and Description
static ProviderConnectionRemotelyClosedException	convertToConnectionClosedException(AmqpProvider provider, org.apache.qpid.proton.engine.Endpoint endpoint, org.apache.qpid.proton.amqp.transport.ErrorCondition errorCondition) Given an ErrorCondition instance create a new Exception that best matches the error type that indicates the connection creation failed for some reason.
static ProviderException	convertToNonFatalException(AmqpProvider provider, org.apache.qpid.proton.engine.Endpoint endpoint, org.apache.qpid.proton.amqp.transport.ErrorCondition errorCondition) Given an ErrorCondition instance create a new Exception that best matches the error type that indicates a non-fatal error usually at the link level such as link closed remotely or link create failed due to security access issues.
static ProviderConnectionRemotelyClosedException	createRedirectException(AmqpProvider provider, org.apache.qpid.proton.amqp.Symbol error, String message, org.apache.qpid.proton.amqp.transport.ErrorCondition condition) When a redirect type exception is received this method is called to create the appropriate redirect exception type containing the error details needed.
static String	extractErrorMessage(org.apache.qpid.proton.amqp.transport.ErrorCondition errorCondition) Attempt to read and return the embedded error message in the given ErrorCondition object.

Methods inherited from class java.lang.Object

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

Field Detail

SOLE_CONNECTION_CAPABILITY

public static final org.apache.qpid.proton.amqp.Symbol SOLE_CONNECTION_CAPABILITY

ANONYMOUS_RELAY

public static final org.apache.qpid.proton.amqp.Symbol ANONYMOUS_RELAY

DELAYED_DELIVERY

public static final org.apache.qpid.proton.amqp.Symbol DELAYED_DELIVERY

SHARED_SUBS

public static final org.apache.qpid.proton.amqp.Symbol SHARED_SUBS

CONNECTION_OPEN_FAILED

public static final org.apache.qpid.proton.amqp.Symbol CONNECTION_OPEN_FAILED

INVALID_FIELD

public static final org.apache.qpid.proton.amqp.Symbol INVALID_FIELD

CONTAINER_ID

public static final org.apache.qpid.proton.amqp.Symbol CONTAINER_ID

FAILOVER_SERVER_LIST

public static final org.apache.qpid.proton.amqp.Symbol FAILOVER_SERVER_LIST

PATH

public static final org.apache.qpid.proton.amqp.Symbol PATH

SCHEME

public static final org.apache.qpid.proton.amqp.Symbol SCHEME

PORT

public static final org.apache.qpid.proton.amqp.Symbol PORT

NETWORK_HOST

public static final org.apache.qpid.proton.amqp.Symbol NETWORK_HOST

OPEN_HOSTNAME

public static final org.apache.qpid.proton.amqp.Symbol OPEN_HOSTNAME

QUEUE_PREFIX

public static final org.apache.qpid.proton.amqp.Symbol QUEUE_PREFIX

TOPIC_PREFIX

public static final org.apache.qpid.proton.amqp.Symbol TOPIC_PREFIX

PRODUCT

public static final org.apache.qpid.proton.amqp.Symbol PRODUCT

VERSION

public static final org.apache.qpid.proton.amqp.Symbol VERSION

PLATFORM

public static final org.apache.qpid.proton.amqp.Symbol PLATFORM

COPY

public static final org.apache.qpid.proton.amqp.Symbol COPY

JMS_NO_LOCAL_SYMBOL

public static final org.apache.qpid.proton.amqp.Symbol JMS_NO_LOCAL_SYMBOL

JMS_SELECTOR_SYMBOL

public static final org.apache.qpid.proton.amqp.Symbol JMS_SELECTOR_SYMBOL

SHARED

public static final org.apache.qpid.proton.amqp.Symbol SHARED

GLOBAL

public static final org.apache.qpid.proton.amqp.Symbol GLOBAL

REJECTED

public static final org.apache.qpid.proton.amqp.messaging.Rejected REJECTED

MODIFIED_FAILED

public static final org.apache.qpid.proton.amqp.messaging.Modified MODIFIED_FAILED

MODIFIED_FAILED_UNDELIVERABLE

public static final org.apache.qpid.proton.amqp.messaging.Modified MODIFIED_FAILED_UNDELIVERABLE

DYNAMIC_NODE_LIFETIME_POLICY

public static final org.apache.qpid.proton.amqp.Symbol DYNAMIC_NODE_LIFETIME_POLICY

TEMP_QUEUE_CREATOR

public static final String TEMP_QUEUE_CREATOR

See Also:

Constant Field Values

TEMP_TOPIC_CREATOR

public static final String TEMP_TOPIC_CREATOR

See Also:

Constant Field Values

SUB_NAME_DELIMITER

public static final String SUB_NAME_DELIMITER

See Also:

Constant Field Values

Constructor Detail

AmqpSupport

public AmqpSupport()

Method Detail

convertToConnectionClosedException

public static ProviderConnectionRemotelyClosedException convertToConnectionClosedException(AmqpProvider provider,
                                                                                           org.apache.qpid.proton.engine.Endpoint endpoint,
                                                                                           org.apache.qpid.proton.amqp.transport.ErrorCondition errorCondition)

Given an ErrorCondition instance create a new Exception that best matches the error type that indicates the connection creation failed for some reason.

Parameters:

provider - the AMQP provider instance that originates this exception

endpoint - The target of the error.

errorCondition - The ErrorCondition returned from the remote peer.

Returns:

a new Exception instance that best matches the ErrorCondition value.

convertToNonFatalException

public static ProviderException convertToNonFatalException(AmqpProvider provider,
                                                           org.apache.qpid.proton.engine.Endpoint endpoint,
                                                           org.apache.qpid.proton.amqp.transport.ErrorCondition errorCondition)

Given an ErrorCondition instance create a new Exception that best matches the error type that indicates a non-fatal error usually at the link level such as link closed remotely or link create failed due to security access issues.

Parameters:

provider - the AMQP provider instance that originates this exception

endpoint - The target of the error.

errorCondition - The ErrorCondition returned from the remote peer.

Returns:

a new Exception instance that best matches the ErrorCondition value.

extractErrorMessage

public static String extractErrorMessage(org.apache.qpid.proton.amqp.transport.ErrorCondition errorCondition)

Attempt to read and return the embedded error message in the given ErrorCondition object. If no message can be extracted a generic message is returned.

Parameters:

errorCondition - The ErrorCondition to extract the error message from.

Returns:

an error message extracted from the given ErrorCondition.

createRedirectException

public static ProviderConnectionRemotelyClosedException createRedirectException(AmqpProvider provider,
                                                                                org.apache.qpid.proton.amqp.Symbol error,
                                                                                String message,
                                                                                org.apache.qpid.proton.amqp.transport.ErrorCondition condition)

When a redirect type exception is received this method is called to create the appropriate redirect exception type containing the error details needed.

Parameters:

provider - the AMQP provider instance that originates this exception

error - the Symbol that defines the redirection error type.

message - the basic error message that should used or amended for the returned exception.

condition - the ErrorCondition that describes the redirection.

Returns:

an Exception that captures the details of the redirection error.