com.solacesystems.jcsmp

Enum DeliveryMode

java.lang.Object

java.lang.Enum<DeliveryMode>

com.solacesystems.jcsmp.DeliveryMode

All Implemented Interfaces:

Serializable, Comparable<DeliveryMode>

public enum DeliveryMode
extends Enum<DeliveryMode>

Represents the message delivery mode. Each type is associated with a set of delivery characteristics and guarantees. The valid modes are:

• NON_PERSISTENT
• PERSISTENT
• DIRECT (the default)

Enum Constant Summary

Enum Constants

Enum Constant and Description
DIRECT This mode provides at-most-once message delivery.
NON_PERSISTENT This mode is functionally the same as Persistent.
PERSISTENT This mode provides once-and-only-once message delivery.

Method Summary

Methods

Modifier and Type	Method and Description
static DeliveryMode	valueOf(String name) Returns the enum constant of this type with the specified name.
static DeliveryMode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

PERSISTENT

public static final DeliveryMode PERSISTENT

This mode provides once-and-only-once message delivery. A Persistent delivery mode is used for Guaranteed Messaging, and this delivery mode is most appropriate for applications that require persistent storage of the messages they send or intend to receive. Persistent messages have the following characteristics:

• They cannot be discarded or lost (once they are acknowledged by the appliance).
• They cannot be reordered in the event of network topology changes.
• They cannot be delivered more than once to a single client (unless the redelivered message flag is applied).
• When they match subscriptions on durable endpoints, they are retained for a client when that client is not connected.

Persistent messages are most appropriate for applications that require persistent storage of the messages they send or intend to receive. The quality of service offered by Guaranteed Messaging is analogous to JMS Persistent messaging with durable subscriptions.

NON_PERSISTENT

public static final DeliveryMode NON_PERSISTENT

This mode is functionally the same as Persistent. It exists to facilitate interaction with JMS applications. In most situations where you want to use Guaranteed Messaging, it is recommended that you use a Persistent delivery mode.

DIRECT

public static final DeliveryMode DIRECT

This mode provides at-most-once message delivery. Direct messages have the following characteristics:

• They are not retained for clients that are not connected to a Solace appliance.
• They can be discarded when congestion or system failures are encountered.
• They can be reordered in the event of network topology changes.

Direct messages are most appropriate for messaging applications that require very high-rate or very low-latency message transmission. Direct Messaging enables applications to efficiently publish messages to a large number of clients with matching subscriptions.

Method Detail

values

public static DeliveryMode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DeliveryMode c : DeliveryMode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static DeliveryMode valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null