From: Nigel Deakin <nigel.deakin_at_oracle.com>
Date: Thu, 06 Dec 2012 17:57:29 +0000

I have logged this JIRA issue:
http://java.net/jira/browse/JMS_SPEC-107
Extend connection consumer API to support shared durable and non-durable subscriptions

Now that JMS_SPEC-40 has added shared-durable and non-durable subscriptions to JMS, the connection consumer API needs to
be extended to support them.

So in addition to the existing methods on Connection:

ConnectionConsumer createConnectionConsumer(
    Destination destination, String messageSelector, ServerSessionPool sessionPool,
    int maxMessages)

(Queues or unshared non-durable topic subscriptions, clientId optional)

ConnectionConsumer createDurableConnectionConsumer(
    Topic topic, String subscriptionName, String messageSelector, ServerSessionPool sessionPool,
    int maxMessages)

(Unshared durable topic subscriptions, clientId required)

we also need

ConnectionConsumer createSharedConnectionConsumer(
    Topic topic, String subscriptionName, String messageSelector, ServerSessionPool sessionPool,
    int maxMessages)

(Shared non-durable topic subscriptions, clientId optional)

ConnectionConsumer createSharedDurableConnectionConsumer(
    Topic topic, String subscriptionName, String messageSelector, ServerSessionPool sessionPool,
    int maxMessages)

(Shared durable topic subscriptions, clientId optional)

I have drafted the necessary Javadoc, which you can view at
http://jms-spec.java.net/2.0-SNAPSHOT/apidocs/javax/jms/Connection.html#createSharedDurableConnectionConsumer%28javax.jms.Topic,%20java.lang.String,%20java.lang.String,%20javax.jms.ServerSessionPool,%20int%29

and
http://jms-spec.java.net/2.0-SNAPSHOT/apidocs/javax/jms/Connection.html#createSharedConnectionConsumer%28javax.jms.Topic,%20java.lang.String,%20java.lang.String,%20javax.jms.ServerSessionPool,%20int%29

Nigel