zaqar-specs/specs/newton/lazy-queues-in-subscriptions.rst

Lazy queues in subscriptions

https://blueprints.launchpad.net/zaqar/+spec/lazy-queues-in-subscriptions

Make queues lazy on operations with subscriptions, so the user will be able to subscribe to yet unexisting queue.

Problem description

Queues are designed to be lazy resources in Zaqar's API v1.1 and API v2 in messaging. That means, for example, that the user can post messages to unexisting queue, and the queue will be automatically created. But now queues do not behave like lazy resources on operations with subscriptions. Before creating a subscription, the user must ensure the queue exists, or Zaqar will send error response with HTTP code 400.

Proposed change

Make queues lazy on operations with subscriptions, so the user will be able to subscribe to yet unexisting queue. Make Zaqar do not send error response on queue creation operation in the case queue does not exists.

Advantages:

1. The behavior of API will be more consistent, because after the change queues will be lazy in all situations.
2. It will be easier for the user to work with subscriptions. No need to do pre-check for queue existence, or handle 400 error response from Zaqar, or always pre-create queue.
3. There will be no need to solve currently existing problem when the queue was deleted, but subscriptions to it are still existing. Problem solving will probably require storage driver code to delete also all subscriptions to a queue, when deleting the queue. It may be very undesirable for the user, because subscriptions will not guarantee to be existing till TTL expiration, and will need to be renewed also after queue delete and queue create operations. Proper solution to this problem will complicate behavior in many ways in both Zaqar and client's code. It will be probably backward incompatible change.

The change is backward compatible. Client's code should work after the change.

Drawbacks

None

Alternatives

Two alternatives:

1. Keep the current behavior.
2. There is opinion to make queues non-lazy resources in all situations like it was in API v1. But it will be backward incompatible change to our API v1.1 and API v2, so maybe make it in the distant future.

Both of them will require solving the problem about still active subscriptions to a queue that was deleted.

Implementation

Assignee(s)

Primary assignee:

ubershy

Milestones

Target Milestone for completion:

Newton-1

Work Items

1. Remove checks for queue existence on operations with subscriptions from storage drivers.
2. Remove the code that is catching QueueDoesNotExist exception on operations with subscriptions from transport drivers.
3. Change functional and unit tests accordingly.

Dependencies

None

Note

This work is licensed under a Creative Commons Attribution 3.0 Unported License. http://creativecommons.org/licenses/by/3.0/legalcode