|Apache Qpid - AMQP Messaging for Java JMS, C++, Python, Ruby, and .NET||Apache Qpid Documentation|
Settings for a subscription. More...
|SubscriptionSettings (FlowControl flow=FlowControl::unlimited(), AcceptMode accept=ACCEPT_MODE_EXPLICIT, AcquireMode acquire=ACQUIRE_MODE_PRE_ACQUIRED, unsigned int autoAck_=1, CompletionMode completion=COMPLETE_ON_DELIVERY)|
|< Flow control settings. |
|< ACCEPT_MODE_EXPLICIT or ACCEPT_MODE_NONE |
|< ACQUIRE_MODE_PRE_ACQUIRED or ACQUIRE_MODE_NOT_ACQUIRED |
|In windowing mode, completion of a message will cause the credit used up by that message to be reallocated. |
|If set, requests that no other subscriber be allowed to access the queue while this subscription is active. |
|unsigned int||autoAck_ =
< Flow control settings.
< ACCEPT_MODE_EXPLICIT or ACCEPT_MODE_NONE
The acquireMode determines whether messages are locked for the subscriber when delivered, and thus are not delivered to any other subscriber unless this subscriber releases them.
The default is ACQUIRE_MODE_PRE_ACQUIRED meaning that the subscriber expects to have been given that message exclusively (i.e. the message will not be given to any other subscriber unless released explicitly or by this subscribers session failing without having accepted the message).
Delivery of message in ACQUIRE_MODE_NOT_ACQUIRED mode means the message will still be available for other subscribers to receive. The application can if desired acquire a (set of) messages through an explicit acquire call - see Subscription::acquire().
|unsigned int qpid::client::SubscriptionSettings::autoAck|
< ACQUIRE_MODE_PRE_ACQUIRED or ACQUIRE_MODE_NOT_ACQUIRED
Configures the frequency at which messages are automatically accepted (e.g. a value of 5 means that messages are accepted in batches of 5). A value of 0 means no automatic acknowledgement will occur and the application will itself be responsible for accepting messages.
In windowing mode, completion of a message will cause the credit used up by that message to be reallocated.
The subscriptions completion mode controls how completion is managed.
If set to COMPLETE_ON_DELIVERY (which is the default), messages will be marked as completed once they have been received. The server will be explicitly notified of all completed messages for the session when the next accept is sent through the subscription (either explictly or through autAck). However the server may also periodically request information on the completed messages.
If set to COMPLETE_ON_ACCEPT, messages will be marked as completed once they are accepted (via the Subscription class) and the server will also be notified of all completed messages for the session.
If set to MANUAL_COMPLETION the application is responsible for completing messages (