Entity služby zpráv Java (JMS) 2.0

Klientské aplikace, které se připojují k Azure Service Bus Premium a používají knihovnu Azure Service Bus JMS, můžou používat následující entity.

Fronty

Fronty v JMS jsou sémanticky srovnatelné s tradičními frontami služby Service Bus.

K vytvoření fronty použijte následující metody ve JMSContext třídě :

Queue createQueue(String queueName)

Témata

Témata v JMS jsou sémanticky srovnatelná s tradičními tématy služby Service Bus.

Pokud chcete vytvořit téma, použijte následující metody ve JMSContext třídě -

Topic createTopic(String topicName)

Dočasné fronty

Pokud klientská aplikace vyžaduje dočasnou entitu, která existuje po celou dobu života aplikace, může použít dočasné fronty. Tyto entity se používají ve vzoru Požadavek-Odpověď .

Pokud chcete vytvořit dočasnou frontu, použijte následující metody ve JMSContext třídě :

TemporaryQueue createTemporaryQueue()

Dočasná témata

Stejně jako dočasné fronty existují i dočasná témata, která umožňují publikování a přihlášení k odběru prostřednictvím dočasné entity, která existuje po celou dobu životnosti aplikace.

Chcete-li vytvořit dočasné téma, použijte následující metody ve JMSContext třídě -

TemporaryTopic createTemporaryTopic()

Odběry JMS (Java Message Service)

I když jsou sémanticky podobné předplatným (to znamená, že existují v tématu a umožňují sémantiku publikování/odběru), specifikace služby Zpráv v Javě zavádí pro dané předplatné koncepty atributů Shared (Sdílené), Unshared (Nesdílené), **Durable (Trvalý) a Non-durable (Non-durable ).

Sdílená odolná předplatná

Sdílený trvalý odběr se používá, když všechny zprávy publikované v tématu mají být přijaty a zpracovány aplikací, bez ohledu na to, zda aplikace neustále aktivně využívá z odběru.

Jakákoli aplikace, která je ověřená pro příjem ze služby Service Bus, může přijímat ze sdíleného trvalého předplatného.

Pokud chcete vytvořit sdílené trvalé předplatné, použijte následující metody ve JMSContext třídě :

JMSConsumer createSharedDurableConsumer(Topic topic, String name)

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

Sdílené trvalé předplatné bude dál existovat, dokud se nevymaže pomocí unsubscribe metody ve JMSContext třídě .

void unsubscribe(String name)

Nesdílené trvalé předplatná

Podobně jako u sdíleného trvalého odběru se nesdílený trvalý odběr používá, když všechny zprávy publikované v tématu mají být přijaty a zpracovány aplikací, bez ohledu na to, zda aplikace aktivně využívá odběr.

Vzhledem k tomu, že se jedná o nesdílené předplatné, může z něj přijímat pouze aplikace, která předplatné vytvořila.

Pokud chcete vytvořit nesdílené trvalé předplatné, použijte následující metody z JMSContext třídy :

JMSConsumer createDurableConsumer(Topic topic, String name)

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

Trvalé nesdílené předplatné bude dál existovat, pokud se neodstraní pomocí unsubscribe metody ve JMSContext třídě .

void unsubscribe(String name)

Sdílená trvalá předplatná

Sdílené trvalé předplatné se používá v případě, že více klientských aplikací potřebuje přijímat a zpracovávat zprávy z jednoho předplatného, pouze do doby, než je aktivně využívají nebo z něj přijímají.

Vzhledem k tomu, že předplatné není trvalé, není trvalé. Toto předplatné nepřijímá zprávy, pokud v něm nejsou žádní aktivní příjemci.

Pokud chcete vytvořit sdílené trvalé předplatné, vytvořte z JMSContext třídy metodu JmsConsumer , jak je znázorněno v následujících metodách :

JMSConsumer createSharedConsumer(Topic topic, String sharedSubscriptionName)

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

Sdílené předplatné, které není trvalé, bude dál existovat, dokud nebudou aktivní příjemci, kteří ho budou dostávat.

Nesdílená předplatná, která nejsou trvalá

Nesdílené předplatné se používá v případě, že klientská aplikace potřebuje přijímat a zpracovávat zprávy z předplatného, pouze do doby, než je aktivně využívá. V tomto předplatném může existovat pouze jeden příjemce, to znamená klient, který předplatné vytvořil.

Vzhledem k tomu, že předplatné není trvalé, není trvalé. Toto předplatné nepřijímá zprávy, pokud v něm není aktivní příjemce.

Pokud chcete vytvořit nesdílené trvalé předplatné, vytvořte JMSConsumer z JMSContext třídy , jak je znázorněno v následujících metodách :

JMSConsumer createConsumer(Destination destination)

JMSConsumer createConsumer(Destination destination, String messageSelector)

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

Nesdílené předplatné bude dál existovat, dokud nebude aktivní příjemce, který ho bude přijímat.

Selektory zpráv

Stejně jako filtry a akce existují u běžných odběrů služby Service Bus, i pro předplatná JMS existují selektory zpráv .

Selektory zpráv lze nastavit u každého z odběrů JMS a existují jako podmínka filtru ve vlastnostech záhlaví zprávy. Doručují se pouze zprávy s vlastnostmi záhlaví odpovídajícími výrazu selektoru zpráv. Hodnota null nebo prázdný řetězec označuje, že pro předplatné nebo příjemce JMS neexistuje žádný selektor zpráv.

Další koncepty odběrů služby Java Message Service (JMS) 2.0

Rozsah klienta

Předplatná, jak je uvedeno v rozhraní JAVA Message Service (JMS) 2.0 API, můžou, ale nemusí být vymezená na konkrétní klientské aplikace (označené příslušnými clientId).

Jakmile je předplatné vymezeno, je k němu možné přistupovat pouze z klientských aplikací, které mají stejné ID klienta.

Všechny pokusy o přístup k předplatnému s oborem určitého ID klienta (například clientId1) z aplikace, která má jiné ID klienta (například clientId2), povedou k vytvoření dalšího předplatného vymezeného na jiné ID klienta (clientId2).

Možnosti sdílení

Sdílené odběry umožňují více klientům/příjemcům (tj. objektů JMSConsumer) přijímat od nich zprávy.

Nesdílené odběry umožňují pouze jednomu klientovi nebo příjemci (tj. objektU JMSConsumer) přijímat zprávy od nich. JMSConsumer Pokud se vytvoří v nesdíleném odběru, ale už má aktivní JMSConsumer naslouchání zpráv, JMSException vyvolá se chyba .

Stálost

Trvalé odběry jsou trvalé a nadále shromažďují zprávy z tématu, bez ohledu na to, jestli aplikace (JMSConsumer) zprávy z tohoto tématu využívá.

Odběry , které nejsou trvalé a shromažďují zprávy z tématu, dokud aplikace (JMSConsumer) z tématu zprávy z tématu spotřebovává.

Reprezentace předplatných s vymezeným klientem

Vzhledem k tomu, že předplatná JMS s oborem klienta (JMS) musí existovat současně s existujícími předplatnými, způsob znázornění předplatných s oborem klienta (JMS) se řídí následujícím formátem.

• <SUBSCRIPTION-NAME>$<CLIENT-ID>$D (pro trvalá předplatná)
• <SUBSCRIPTION-NAME>$<CLIENT-ID>$ND (pro předplatná, která nejsou trvalá)

$ Tady je oddělovač.

Další kroky

Další informace a příklady použití zasílání zpráv služby Service Bus najdete v následujících pokročilých tématech:

• Přehled zasílání zpráv služby Service Bus
• Použití rozhraní API služby Java Message Service 2.0 s Azure Service Bus Premium