Syntax für EJB-Endpunkt-URLs
Im Rahmen der Entwicklung eines standardisierten SOAP-over-JMS-Protokolls wurde eine Syntax für JMS-Endpunkt-URLs (Java™ Message Service) definiert. Der JMS-Endpunkt-URL wird verwendet, um mit dem JMS-Transport auf JAX-WS- (Java API for XML Web Services) oder JAX-RPC-Web-Services (Java API for XML-based RPC) zuzugreifen. Dieser URL gibt das JMS-Ziel und die Verbindungsfactory sowie den Namen der Portkomponente für die Web-Service-Anforderung an. Dieser Endpunkt-URL gleicht dem HTTP-Endpunkt-URL, der Host und Port sowie Stammkontext und Name der Portkomponente angibt.

IBM® und andere Anbieter arbeiten seit 2005 an der Spezifikation SOAP over JMS des World Wide Web Consortium (W3C). Die Spezifikation wurde zur Prüfung an das World Wide Web Consortium (W3C) übergeben, und es wurde eine Arbeitsgruppe ins Leben gerufen. Ein gemeinsamer Entwurf dieses Dokuments wurde im Oktober 2007 veröffentlicht. Application Server unterstützt den aktuellen Entwurf der W3C-Spezifikation.

jms:jndi:<JNDI-Name_des_Ziels>?<Eigenschaft>=<Wert>&<Eigenschaft>=<Wert>&...
Der URL setzt sich wie folgt zusammen: Transporttyp jms:,
gefolgt von der Angabe jndi:, dem JNDI-Namen der Zielwarteschlange oder des Zieltopics,
der Abfragezeichenfolge, die eine Liste von Eigenschafts/Wert-Paaren mit den JMS-Endpunktdaten enthält. Die Variante jndi:
bedeutet, dass JNDI zur Lokalisierung von Objektnamen in der Zeichenfolge des Endpunkt-URLs verwendet wird. sptcfgDie in der URL-Zeichenfolge unterstützten Eigenschaften sind im Folgenden beschrieben:
Eigenschaftsname | Beschreibung |
---|---|
jndiConnectionFactoryName | Gibt den JNDI-Namen der Verbindungsfactory an, die von der Clientlaufzeit verwendet wird, um eine Verbindung zur JMS-Messaging-Engine herzustellen. |
targetService | Gibt den Namen der Portkomponente an, an die die Anforderung verteilt wird. |
Eigenschaftsname | Beschreibung |
---|---|
jndiInitialContextFactory | Gibt den Namen der zu verwendenden Klasse der Ausgangskontextfactory an. Dieser Wert wird der Eigenschaft java.naming.factory.initial zugeordnet. |
jndiURL | Gibt den URL des JNDI-Providers an. Dieser Wert wird der Eigenschaft java.naming.provider.url zugeordnet. |
Eigenschaftsname | Beschreibung |
---|---|
deliveryMode | Gibt an, ob die Anforderungsnachricht persistent sein soll. Die gültigen Werte sind PERSISTENT und NON_PERSISTENT. Der Standardwert ist NON_PERSISTENT. |
timeToLive | Gibt die Lebensdauer der Anforderungsnachricht in Millisekunden an. Der Wert 0 steht für eine unbegrenzte Lebensdauer. Wenn Sie diesen Parameter nicht angeben, wird der von JMS definierte Standardwert verwendet. |
priority | Gibt die JMS-Priorität der Anforderungsnachricht an. Dieser Wert muss eine positive ganze Zahl zwischen 0, der niedrigsten Priorität, und 9, der höchsten Priorität, sein. Wenn Sie diesen Parameter nicht angeben, wird der von JMS definierte Standardwert verwendet. |
replyToName | Gibt den JNDI-Namen des JMS-Ziels an, an das die Antwortnachricht gesendet wird. Wenn Sie diese optionale Eigenschaft verwenden, kann der Client eine vorab definierte, permanente Warteschlange anstelle einer temporären Warteschlange für den Empfang von Antworten verwenden. |
messageType | Gibt den für die Anforderungsnachricht zu verwendenden Nachrichtentyp an. Der Wert BYTES gibt an, dass das Objekt "javax.jms.BytesMessage" verwendet wird. Der Wert TEXT gibt an, dass das Objekt "javax.jms.TextMessage" verwendet wird. Der Standardwert ist BYTES. |
Die erforderlichen Eigenschaften jndiConnectionFactoryName und targetService müssen in der Zeichenfolge des JMS-Endpunkt-URL enthalten sein. Die restlichen Eigenschaften sind optional.
Wenn Sie Werte für die Eigenschaften deliveryMode, timeToLive und priority in der JMS-Anforderung festlegen, werden diese Werte von der JMS-Anforderungsnachricht an die entsprechende JMS-Antwortnachricht weitergegeben.
Weitere Informationen zu diesem Branchenstandard finden Sie in der Spezifikation SOAP over Java Message Service in der Dokumentation "Web-Service-Spezifikationen und APIs".