com.sun.xml.ws.rx.rm.api

Enum ReliableMessagingFeature.DeliveryAssurance

java.lang.Object

java.lang.Enum<ReliableMessagingFeature.DeliveryAssurance>

com.sun.xml.ws.rx.rm.api.ReliableMessagingFeature.DeliveryAssurance

All Implemented Interfaces:

Serializable, Comparable<ReliableMessagingFeature.DeliveryAssurance>

Enclosing class:

ReliableMessagingFeature

public static enum ReliableMessagingFeature.DeliveryAssurance
extends Enum<ReliableMessagingFeature.DeliveryAssurance>

Defines the enumeration of Delivery Assurance options, which can be supported by RM Sources and RM Destinations.

See Also:

EXACTLY_ONCE, AT_LEAST_ONCE, AT_MOST_ONCE

Enum Constant Summary

Enum Constants

Enum Constant and Description
AT_LEAST_ONCE Each message is to be delivered at least once, or else an error will be raised by the RM Source and/or RM Destination.
AT_MOST_ONCE Each message is to be delivered at most once.
EXACTLY_ONCE Each message is to be delivered exactly once; if a message cannot be delivered then an error will be raised by the RM Source and/or RM Destination.

Method Summary

Modifier and Type	Method and Description
static ReliableMessagingFeature.DeliveryAssurance	getDefault() Provides a default delivery assurance value.
static ReliableMessagingFeature.DeliveryAssurance	valueOf(String name) Returns the enum constant of this type with the specified name.
static ReliableMessagingFeature.DeliveryAssurance[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

EXACTLY_ONCE

public static final ReliableMessagingFeature.DeliveryAssurance EXACTLY_ONCE

Each message is to be delivered exactly once; if a message cannot be delivered then an error will be raised by the RM Source and/or RM Destination. The requirement on an RM Source is that it should retry transmission of every message sent by the Application Source until it receives an acknowledgement from the RM Destination. The requirement on the RM Destination is that it should retry the transfer to the Application Destination of any message that it accepts from the RM Source until that message has been successfully delivered, and that it must not deliver a duplicate of a message that has already been delivered.

See Also:

ReliableMessagingFeature.DeliveryAssurance

AT_LEAST_ONCE

public static final ReliableMessagingFeature.DeliveryAssurance AT_LEAST_ONCE

Each message is to be delivered at least once, or else an error will be raised by the RM Source and/or RM Destination. The requirement on an RM Source is that it should retry transmission of every message sent by the Application Source until it receives an acknowledgement from the RM Destination. The requirement on the RM Destination is that it should retry the transfer to the Application Destination of any message that it accepts from the RM Source, until that message has been successfully delivered. There is no requirement for the RM Destination to apply duplicate message filtering.

See Also:

ReliableMessagingFeature.DeliveryAssurance

AT_MOST_ONCE

public static final ReliableMessagingFeature.DeliveryAssurance AT_MOST_ONCE

Each message is to be delivered at most once. The RM Source may retry transmission of unacknowledged messages, but is not required to do so. The requirement on the RM Destination is that it must filter out duplicate messages, i.e. that it must not deliver a duplicate of a message that has already been delivered.

See Also:

ReliableMessagingFeature.DeliveryAssurance

Method Detail

values

public static ReliableMessagingFeature.DeliveryAssurance[] 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 (ReliableMessagingFeature.DeliveryAssurance c : ReliableMessagingFeature.DeliveryAssurance.values())
    System.out.println(c);

Returns:

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

valueOf

public static ReliableMessagingFeature.DeliveryAssurance 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

getDefault

public static ReliableMessagingFeature.DeliveryAssurance getDefault()

Provides a default delivery assurance value.

Returns:

a default delivery assurance value. Currently returns EXACTLY_ONCE.

See Also:

ReliableMessagingFeature.DeliveryAssurance