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

Verbinding zonder wachtwoord maakt gebruik van Microsoft Entra verificatie om verbinding te maken met Azure services zonder referenties op te slaan in de toepassing, de configuratiebestanden of in 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 met een 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 met JMS managed identity

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 Authenticate a managed identity with Microsoft Entra ID to access 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 om een nieuwe verbinding te JmsTemplate maken, die resource-intensief 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.2.0 en 6.2.0):

Monsters

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