activemq-cpp-3.6.0
cms::DeliveryMode Class Reference

This is an Abstract class whose purpose is to provide a container for the delivery mode enumeration for CMS messages. More...

#include <src/main/cms/DeliveryMode.h>

Public Types

enum  DELIVERY_MODE { PERSISTENT = 0, NON_PERSISTENT = 1 }
 Enumeration values for Message Delivery Mode. More...

Public Member Functions

virtual ~DeliveryMode ()

Detailed Description

This is an Abstract class whose purpose is to provide a container for the delivery mode enumeration for CMS messages.

When a client sends a cms::Message it can mark the Message as either Persistent or Non-Persistent. If the client feels that the Message cannot be lost in transit it should mark it as Persistent, otherwise if it is allowable for a Message to occasionally be lost it can mark it as Non-Persistent. This allows the Provider to balance make tradeoffs between balance and Message throughput.

The DeliveryMode covers only the transport of the Message for sending client to its destination and doesn't apply to the receiving Message consumer. The receiving Consumer can drop Message's based on configuration such as memory limits or Message filtering.

A message is guaranteed to be delivered once and only once by a CMS provider if the delivery mode of the message is PERSISTENT and the configuration of the Message consumer allows for it.

Since
1.0

Member Enumeration Documentation

Enumeration values for Message Delivery Mode.

Enumerator:
PERSISTENT 
NON_PERSISTENT 

Constructor & Destructor Documentation

virtual cms::DeliveryMode::~DeliveryMode ( )
virtual

The documentation for this class was generated from the following file: