Azure Service Bus gebruiken met JMS

In dit artikel wordt beschreven hoe u Azure Service Bus gebruikt met de JMS-API die is geïntegreerd in het Spring JMS-framework.

Kernfuncties

Verbinding zonder wachtwoord

Een verbinding zonder wachtwoord maakt gebruik van Microsoft Entra-authenticatie om verbinding te maken met Azure-services zonder aanmeldingsgegevens op te slaan in de toepassing, de configuratiebestanden ervan of omgevingsvariabelen. Microsoft Entra verificatie is een mechanisme voor het maken van verbinding met Azure Service Bus met behulp van identiteiten die zijn gedefinieerd in Microsoft Entra ID. Met Microsoft Entra verificatie kunt u Service Bus en andere Microsoft-services op een centrale locatie beheren, waardoor het beheer van machtigingen wordt vereenvoudigd.

Hoe het werkt

Spring Cloud Azure bouwt eerst een van de volgende typen referenties, afhankelijk van de configuratie van de toepassingsverificatie:

• ClientSecretCredential
• ClientCertificateCredential
• UsernamePasswordCredential
• ManagedIdentityCredential

Als geen van deze typen referenties wordt gevonden, wordt de referentieketen via DefaultTokenCredential gebruikt om referenties te verkrijgen van toepassingseigenschappen, omgevingsvariabelen, beheerde identiteit of IDE's. Zie Spring Cloud Azure authentication voor meer informatie.

Afhankelijkheid instellen

Voeg de volgende afhankelijkheden toe als u uw Spring JMS-toepassing wilt migreren om Azure Service Bus te gebruiken.

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

Configuratie

In de volgende tabel worden de configureerbare eigenschappen beschreven bij het gebruik van spring JMS-ondersteuning:

Zie Spring JMS-documentvoor meer informatie.

Basisgebruik

Verbinding maken met Azure Service Bus JMS zonder wachtwoord

Configureer de volgende eigenschappen in uw application.yml-bestand:

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

Verbinding maken met Azure Service Bus via JMS met een beheerde identiteit

1. Als u de beheerde identiteit wilt gebruiken, schakelt u de beheerde identiteit voor uw service in en wijst u de rol Azure Service Bus Data Owner toe. Zie Een beheerde identiteit verifiëren met Microsoft Entra ID om toegang te krijgen tot Azure Service Bus-resources voor meer informatie.

2. Configureer de volgende eigenschappen in uw application.yml-bestand:

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

   Belangrijk

   Als u een door de gebruiker toegewezen beheerde identiteit gebruikt, moet u ook de eigenschap toevoegen spring.cloud.azure.credential.client-id met de door de gebruiker toegewezen client-id van de beheerde identiteit.

Verbinding maken met Azure Service Bus JMS met behulp van verbindingsreeks

Voeg de volgende eigenschappen toe en u kunt aan de slag.

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

Verbindingen

Spring Cloud Azure biedt de volgende drie verbindingsfactory-opties voor het maken van verbinding met Azure Service Bus JMS:

• JmsPoolConnectionFactory: Deze fabriek onderhoudt een verbindingsgroep met aanpasbare opties zoals spring.jms.servicebus.pool.max-connections. Meer configuratie-instellingen voor pools , voorafgegaan door spring.jms.servicebus.pool. - worden beschreven in de sectie Configuratie . Deze installatie verbetert de prestaties door gebruik te maken van de taakverdelingsfunctie van Azure Service Bus, waardoor verkeer over meerdere eindpunten wordt verdeeld.

• CachingConnectionFactory: Deze fabriek gebruikt één verbinding voor alle aanroepen, JmsTemplatewaardoor de overhead van het maken van verbindingen wordt verminderd, wat ideaal is voor scenario's met weinig verkeer. In deze modus wordt echter geen gebruikgemaakt van de taakverdelingsmogelijkheid van Azure Service Bus.

• ServiceBusJmsConnectionFactory: In deze modus maakt elke aanroep van JmsTemplate een nieuwe verbinding, wat veel resources kan vergen en minder efficiënt kan zijn.

Wanneer alle drie de klassen bestaan in het klaspad, welke wordt gebruikt? In de volgende tabel wordt beschreven welke wordt gebruikt op basis van configuratie-eigenschappen (sinds Spring Cloud Azure 7.1.0 en 6.2.0):

Voorbeelden

Zie de opslagplaats azure-spring-boot-samples op GitHub voor meer informatie.