Verwenden von Azure Service Bus mit JMS

Dieser Artikel gilt für:✅ Version 4.19.0 ✅ Version 5.19.0

In diesem Artikel wird beschrieben, wie Sie Azure Service Bus mit der JMS-API verwenden, die in das Spring JMS-Framework integriert ist.

Kernfunktionen

Kennwortlose Verbindung

Die kennwortlose Verbindung verwendet die Microsoft Entra-Authentifizierung zum Herstellen einer Verbindung mit Azure-Diensten, ohne Anmeldeinformationen in der Anwendung, den Konfigurationsdateien oder in Umgebungsvariablen zu speichern. Die Microsoft Entra-Authentifizierung ist ein Mechanismus zum Herstellen einer Verbindung mit Azure Service Bus mithilfe von Identitäten, die in der Microsoft Entra-ID definiert sind. Mit der Microsoft Entra-Authentifizierung können Sie Service Bus und andere Microsoft-Dienste an einem zentralen Ort verwalten, wodurch die Berechtigungsverwaltung vereinfacht wird.

Funktionsweise

Spring Cloud Azure erstellt zunächst je nach Anwendungsauthentifizierungskonfiguration eine der folgenden Arten von Anmeldeinformationen:

• ClientSecretCredential
• ClientCertificateCredential
• UsernamePasswordCredential
• ManagedIdentityCredential

Wenn keine dieser Arten von Anmeldeinformationen gefunden wird, wird die Anmeldeinformationskette über DefaultTokenCredential verwendet, um Anmeldeinformationen von Anwendungseigenschaften, Umgebungsvariablen, verwalteter Identität oder IDEs abzurufen. Weitere Informationen finden Sie unter Spring Cloud Azure authentication.

Setup von Abhängigkeiten

Fügen Sie die folgenden Abhängigkeiten hinzu, wenn Sie Ihre Spring JMS-Anwendung migrieren möchten, um Azure Service Bus zu verwenden.

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-servicebus-jms</artifactId>
</dependency>

Konfiguration

In der folgenden Tabelle werden die konfigurierbaren Eigenschaften bei Verwendung der Spring JMS-Unterstützung beschrieben:

Weitere Informationen finden Sie unter Spring JMS Document.

Grundlegende Nutzung

Herstellen einer Verbindung mit Azure Service Bus JMS ohne Kennwort

Konfigurieren Sie die folgenden Eigenschaften in Ihrer application.yml Datei:

spring:
  jms:
    servicebus:
      namespace: ${AZURE_SERVICEBUS_NAMESPACE}
      pricing-tier: ${PRICING_TIER}
      passwordless-enabled: true

Herstellen einer Verbindung mit Azure Service Bus mit JMS verwenden verwaltete Identität

1. Um die verwaltete Identität zu verwenden, aktivieren Sie die verwaltete Identität für Ihren Dienst, und weisen Sie die Azure Service Bus Data Owner Rolle zu. Weitere Informationen finden Sie unter Authentifizieren einer verwalteten Identität mit Microsoft Entra ID für den Zugriff auf Azure Service Bus-Ressourcen.

2. Konfigurieren Sie die folgenden Eigenschaften in Ihrer application.yml Datei:

   spring:
     cloud:
       azure:
         credential:
           managed-identity-enabled: true
     jms:
       servicebus:
         namespace: ${AZURE_SERVICEBUS_NAMESPACE}
         pricing-tier: ${PRICING_TIER}
         passwordless-enabled: true
   

   Wichtig

   Wenn Sie die vom Benutzer zugewiesene verwaltete Identität verwenden, müssen Sie auch die Eigenschaft spring.cloud.azure.credential.client-id mit Ihrer vom Benutzer zugewiesenen verwalteten Identitätsclient-ID hinzufügen.

Herstellen einer Verbindung mit Azure Service Bus JMS mithilfe der Verbindungszeichenfolge

Fügen Sie die folgenden Eigenschaften hinzu, und Sie können loslegen.

spring:
  jms:
    servicebus:
      connection-string: ${AZURE_SERVICEBUS_CONNECTION_STRING}
      pricing-tier: ${PRICING_TIER}

Verbindungen

Spring Cloud Azure bietet die folgenden drei Verbindungsfactory-Optionen für die Verbindung mit Azure Service Bus JMS:

• JmsPoolConnectionFactory: Legen Sie spring.jms.servicebus.pool.enabled=true fest, oder lassen Sie sowohl Pool- als auch Cacheeinstellungen deaktiviert, um den Standardwert zu verwenden. Diese Factory verwaltet einen Verbindungspool mit anpassbaren Optionen wie spring.jms.servicebus.pool.max-connections. Weitere Konfigurationseinstellungen für Pools, die mit dem Präfix spring.jms.servicebus.pool. versehen sind, sind im Abschnitt Configuration ausführlich beschrieben. Dieses Setup verbessert die Leistung, indem die Lastenausgleichsfunktion von Azure Service Bus genutzt wird und Datenverkehr über mehrere Endpunkte verteilt wird.

• CachingConnectionFactory: Legen Sie spring.jms.cache.enabled=true fest, und lassen Sie spring.jms.servicebus.pool.enabled nicht festgelegt. Diese Factory verwendet eine einzige Verbindung für alle Aufrufe von JmsTemplate, wodurch der Aufwand für die Erstellung von Verbindungen reduziert wird, was ideal für Szenarien mit geringem Datenverkehr ist. Dieser Modus nutzt jedoch nicht die Lastenausgleichsfunktion von Azure Service Bus.

• ServiceBusJmsConnectionFactory: Legen Sie spring.jms.servicebus.pool.enabled=false und spring.jms.cache.enabled=false so fest, dass ServiceBusJmsConnectionFactory direkt und ohne Pooling oder Zwischenspeicherung verwendet werden soll. In diesem Modus erstellt jeder Aufruf von JmsTemplate eine neue Verbindung, die ressourcenintensiv und weniger effizient sein kann.

Für optimale Leistung und Lastverteilung empfehlen wir die Verwendung von JmsPoolConnectionFactory durch Festlegen von spring.jms.servicebus.pool.enabled=true. Vermeiden Sie das Umbrechen einer JmsPoolConnectionFactory mit einem CachingConnectionFactory oder ServiceBusJmsConnectionFactory, da dadurch Poolvorteile vermieden werden können, was dazu führen kann, dass inaktive Verbindungen aufbewahrt werden, nachdem sie aus dem Pool entfernt wurden.

Proben

Weitere Informationen finden Sie in den Azure-spring-boot-samples Repository auf GitHub.