Partager via


Entités Java message service (JMS) 2.0

Les applications clientes se connectant à Azure Service Bus Premium et utilisant la bibliothèque JMS Azure Service Bus peuvent se servir des entités ci-dessous.

Files d’attente

Les files d’attente dans JMS sont sémantiquement comparables aux files d’attente Service Bus traditionnelles.

Pour créer une file d’attente, utilisez les méthodes ci-dessous dans la classe JMSContext :

Queue createQueue(String queueName)

Rubriques

Les rubriques dans JMS sont sémantiquement comparables aux files d’attente Service Bus traditionnelles.

Pour créer une rubrique, utilisez les méthodes ci-dessous dans la classe JMSContext :

Topic createTopic(String topicName)

Files d’attente temporaires

Si une application cliente nécessite une entité temporaire qui existe pendant la durée de vie de l’application, elle peut utiliser des files d’attente temporaires. Ces entités sont utilisées dans le modèle Demande-Réponse.

Pour créer une file d’attente temporaire, utilisez les méthodes ci-dessous dans la classe JMSContext :

TemporaryQueue createTemporaryQueue()

Rubriques temporaires

Tout comme les files d’attente temporaires, des rubriques temporaires permettent la publication/l’abonnement via une entité temporaire qui existe pendant la durée de vie de l’application.

Pour créer une rubrique temporaire, utilisez les méthodes ci-dessous dans la classe JMSContext :

TemporaryTopic createTemporaryTopic()

JMS (Java Message Service) et abonnements

Bien qu’elles soient sémantiquement similaires aux Abonnements (qui, en fait, existent sur une rubrique et activent la sémantique de publication/abonnement), les spécifications de Java Message Service présentent les concepts d’attributs Partagé, Non partagé, **Durable et Non durable pour un abonnement donné.

Notes

Les abonnements ci-dessous sont disponibles dans le niveau Azure Service Bus Premium pour les applications clientes se connectant à Azure Service Bus à l’aide de la bibliothèque JMS Azure Service Bus.

Seuls les abonnements durables peuvent être créés avec le portail Azure.

Abonnements durables partagés

Un abonnement durable partagé est utilisé lorsque tous les messages publiés sur une rubrique doivent être reçus et traités par une application, que l’application consomme ou non activement l’abonnement à tout moment.

Toute application authentifiée pour recevoir des messages de Service Bus peut en recevoir de l’abonnement durable partagé.

Pour créer un abonnement durable partagé, utilisez les méthodes ci-dessous sur la classe JMSContext

JMSConsumer createSharedDurableConsumer(Topic topic, String name)

JMSConsumer createSharedDurableConsumer(Topic topic, String name, String messageSelector)

L’abonnement durable partagé continue à exister, sauf s’il est supprimé à l’aide de la méthode unsubscribe sur la classe JMSContext.

void unsubscribe(String name)

Abonnements durables non partagés

À l’instar d’un abonnement durable partagé, un abonnement durable non partagé est utilisé lorsque tous les messages publiés sur une rubrique doivent être reçus et traités par une application, que l’application consomme ou non activement l’abonnement.

Toutefois, étant donné qu’il s’agit d’un abonnement non partagé, seule l’application qui a créé l’abonnement peut recevoir des messages de ce dernier.

Pour créer un abonnement durable non partagé, utilisez les méthodes ci-dessous à partir de la classe JMSContext

JMSConsumer createDurableConsumer(Topic topic, String name)

JMSConsumer createDurableConsumer(Topic topic, String name, String messageSelector, boolean noLocal)

Notes

La fonctionnalité noLocal n’est actuellement pas prise en charge et est ignorée.

L’abonnement durable non partagé continue à exister, sauf s’il est supprimé à l’aide de la méthode unsubscribe sur la classe JMSContext.

void unsubscribe(String name)

Abonnements non durables partagés

Un abonnement partagé non durable est utilisé lorsque plusieurs applications clientes doivent recevoir et traiter des messages d’un seul abonnement, uniquement jusqu’à ce qu’ils les consomment/les reçoivent activement.

Étant donné que l’abonnement n’est pas durable, il n’est pas persistant. Les messages ne sont pas reçus par cet abonnement lorsqu’il n’y a aucun consommateur actif.

Pour créer un abonnement partagé non durable, créez un JmsConsumer comme indiqué dans les méthodes ci-dessous de la classe JMSContext

JMSConsumer createSharedConsumer(Topic topic, String sharedSubscriptionName)

JMSConsumer createSharedConsumer(Topic topic, String sharedSubscriptionName, String messageSelector)

L’abonnement partagé non durable continue d’exister jusqu’à ce qu’il y ait des consommateurs actifs qui le reçoivent.

Abonnements non durables non partagés

Un abonnement non partagé non durable est utilisé lorsque l’application cliente doit recevoir et traiter des messages d’un seul abonnement, uniquement jusqu’à ce qu’elle les consomme/les reçoive activement. Un seul consommateur peut exister sur cet abonnement, autrement dit le client qui a créé l’abonnement.

Étant donné que l’abonnement n’est pas durable, il n’est pas persistant. Les messages ne sont pas reçus par cet abonnement lorsqu’il n’y a aucun consommateur actif.

Pour créer un abonnement non-partagé non durable, créez un JMSConsumer comme indiqué dans les méthodes ci-dessous de la classe JMSContext

JMSConsumer createConsumer(Destination destination)

JMSConsumer createConsumer(Destination destination, String messageSelector)

JMSConsumer createConsumer(Destination destination, String messageSelector, boolean noLocal)

Notes

La fonctionnalité noLocal n’est actuellement pas prise en charge et est ignorée.

L’abonnement non partagé non durable continue d’exister jusqu’à ce qu’il y ait un consommateur actif qui le reçoit.

Sélecteurs de messages

À l’instar des filtres et actions qui existent pour les abonnements Service Bus standard, les sélecteurs de messages existent pour les abonnements JMS.

Les sélecteurs de messages peuvent être configurés sur chacun des abonnements JMS et exister sous la forme d’une condition de filtre sur les propriétés d’en-tête de message. Seuls les messages avec des propriétés d’en-tête correspondant à l’expression du sélecteur de messages sont remis. La valeur Null ou une chaîne vide indique qu’il n’existe aucun sélecteur de message pour l’abonnement/le consommateur JMS.

Concepts supplémentaires pour les abonnements Java Message Service (JMS) 2.0

Étendue du client

Les abonnements, tels qu’ils sont spécifiés dans l’API Java Message Service (JMS) 2.0, peuvent être ou non étendus à une ou à des applications clientes spécifiques (identifiées avec l’élément clientId approprié).

Une fois l’abonnement délimité, il n’est accessible qu’à partir d’applications clientes qui ont le même ID client.

Toute tentative d’accès à un abonnement délimité sur un ID client particulier (par exemple, clientId1) depuis une application ayant un autre ID client (par exemple, clientId2) entraîne la création d’un autre abonnement délimité sur l’autre ID client (clientId2).

Notes

L’ID client peut prendre la valeur null ou être vide, mais il doit correspondre à l’ID client défini sur l’application cliente JMS. Pour Azure Service Bus, un ID client null et un ID client vide ont le même comportement.

Si l’ID client est défini sur la valeur null ou qu’il est vide, il n’est accessible qu’aux applications clientes dont l’ID client est également défini sur null ou est vide.

Partageabilité

Les abonnements partagés permettent à plusieurs clients/consommateurs (autrement dit, des objets JMSConsumer) de recevoir les messages qu’ils envoient.

Notes

Les abonnements partagés dont l’étendue correspond à un ID client spécifique sont toujours accessibles par plusieurs clients/consommateurs (c’est-à-dire des objets JMSConsumer), mais chacune des applications clientes doit avoir le même ID client.

Les abonnements non partagés n’autorisent qu’un seul client/consommateur (c’est-à-dire l’objet JMSConsumer) à recevoir les messages qu’ils envoient. Si un objet JMSConsumer est créé sur un abonnement non partagé alors qu’il a déjà une écoute JMSConsumer active des messages qu’il contient, une exception JMSException est déclenchée.

Durabilité

Les abonnements durables sont conservés et continuent à collecter des messages à partir de la rubrique, qu’une application (JMSConsumer) consomme ou non des messages à partir de celle-ci.

Les abonnements non durables ne sont pas rendus persistants et recueillent des messages à partir de la rubrique tant qu’une application (JMSConsumer) utilise des messages de celle-ci.

Représentation d’abonnements étendus aux clients

Étant donné que les abonnements (JMS) étendus aux clients doivent coexister avec les abonnements existants, la façon dont les abonnements étendus aux clients (JMS) sont représentés suit le format ci-dessous.

  • <NOM-ABONNEMENT>$<ID-CLIENT>$D (pour les abonnements durables)
  • <NOM-ABONNEMENT>$<ID-CLIENT>$ND (pour les abonnements non durables)

Ici, $ est le délimiteur.

Étapes suivantes

Pour plus d’informations et des exemples d’utilisation de la messagerie Service Bus, consultez les rubriques avancées suivantes :