com.sun.xml.ws.rm
Enum ReliableMessagingFeature.DeliveryAssurance

java.lang.Object
  extended by java.lang.Enum<ReliableMessagingFeature.DeliveryAssurance>
      extended by com.sun.xml.ws.rm.ReliableMessagingFeature.DeliveryAssurance
All Implemented Interfaces:
java.io.Serializable, java.lang.Comparable<ReliableMessagingFeature.DeliveryAssurance>
Enclosing class:
ReliableMessagingFeature

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

This enumeration defines a number 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
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
static ReliableMessagingFeature.DeliveryAssurance getDefault()
          Provides a default delivery assurance value.
static ReliableMessagingFeature.DeliveryAssurance valueOf(java.lang.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're declared.
 
Methods inherited from class java.lang.Enum
clone, compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
 
Methods inherited from class java.lang.Object
finalize, 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 final ReliableMessagingFeature.DeliveryAssurance[] values()
Returns an array containing the constants of this enum type, in the order they're 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're declared

valueOf

public static ReliableMessagingFeature.DeliveryAssurance valueOf(java.lang.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:
java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

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