Краткое руководство. Использование Кэш Azure для Redis в Java с клиентом Redisson Redisis

В этом кратком руководстве описано, как включить Кэш Azure для Redis в приложение Java с помощью клиента Redisson Redis и JCP standard JCache API. Эти службы предоставляют доступ к защищенному выделенному кэшу, доступному из любого приложения в Azure. В этой статье приведены два варианта выбора удостоверения Azure, используемого для подключения Redis.

Переход к коду на GitHub

В этом кратком руководстве используется функция архетипа Maven для создания шаблонов для приложения. В кратком руководстве показано, как изменить созданный код, чтобы прибыть к рабочему образцу приложения. Если вы хотите перейти прямо к завершенный код, ознакомьтесь с кратким руководством по Java на GitHub.

Предпосылки

• Подписка Azure — создайте бесплатную учетную запись.
• Использование идентификатора Microsoft Entra для проверки подлинности кэша
• Apache Maven

Настройка рабочей среды

Ниже показано, как настроить рабочую среду для приложения Java. Вы можете пройти проверку подлинности с помощью Кэш Azure для Redis с помощью идентификатора Microsoft Entra (рекомендуется) или ключей доступа.

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export USER_NAME=<user-name>
export REDIS_CACHE_PORT=10000

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export USER_NAME=<user-name>
export REDIS_CACHE_PORT=6380

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export REDIS_CACHE_KEY=<your-primary-access-key>
export REDIS_CACHE_PORT=10000

export REDIS_CACHE_HOSTNAME=<your-host-name>.redis.cache.windows.net
export REDIS_CACHE_KEY=<your-primary-access-key>
export REDIS_CACHE_PORT=6380

Создание нового приложения Java

1. Используйте Maven для создания нового приложения краткого руководства:

   mvn archetype:generate \
       -DarchetypeGroupId=org.apache.maven.archetypes \
       -DarchetypeArtifactId=maven-archetype-quickstart \
       -DarchetypeVersion=1.3 \
       -DinteractiveMode=false \
       -DgroupId=example.demo \
       -DartifactId=redis-redisson-test \
       -Dversion=1.0
   

2. Перейдите в новый каталог проекта redis-redisson-test .

3. Откройте файл pom.xml и добавьте зависимость для Redisson:

   • Проверка подлинности идентификатора Microsoft Entra (рекомендуется)
   • Проверка подлинности ключа доступа

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.15.0</version> <!-- {x-version-update;com.azure:azure-identity;dependency} -->
   </dependency>
   
   <dependency>
       <groupId>org.redisson</groupId>
       <artifactId>redisson</artifactId>
       <version>3.36.0</version> <!-- {x-version-update;org.redisson:redisson;external_dependency} -->
   </dependency>
   

4. Сохраните файл pom.xml .

5. Откройте файл App.java и замените существующий код представленным ниже:

   • Проверка подлинности идентификатора Microsoft Entra (рекомендуется)
   • Проверка подлинности ключа доступа

   package example.demo;
   
   import com.azure.core.credential.TokenRequestContext;
   import com.azure.identity.DefaultAzureCredential;
   import com.azure.identity.DefaultAzureCredentialBuilder;
   import org.redisson.Redisson;
   import org.redisson.api.RedissonClient;
   import org.redisson.config.Config;
   import org.redisson.jcache.configuration.RedissonConfiguration;
   
   import javax.cache.Cache;
   import javax.cache.CacheManager;
   import javax.cache.Caching;
   import javax.cache.configuration.Configuration;
   import javax.cache.configuration.MutableConfiguration;
   import java.time.LocalDateTime;
   
   /**
    * Redis test
    *
    */
   public class App {
       public static void main(String[] args) {
   
           Config redissonconfig = getConfig();
   
           RedissonClient redissonClient = Redisson.create(redissonconfig);
   
           MutableConfiguration<String, String> jcacheConfig = new MutableConfiguration<>();
           Configuration<String, String> config = RedissonConfiguration.fromInstance(redissonClient, jcacheConfig);
   
           // Perform cache operations using JCache
           CacheManager manager = Caching.getCachingProvider().getCacheManager();
           Cache<String, String> map = manager.createCache("test", config);
   
           // Simple get and put of string data into the cache
           System.out.println("\nCache Command  : GET Message");
           System.out.println("Cache Response : " + map.get("Message"));
   
           System.out.println("\nCache Command  : SET Message");
           map.put("Message",
                   String.format("Hello! The cache is working from Java! %s", LocalDateTime.now()));
   
           // Demonstrate "SET Message" executed as expected
           System.out.println("\nCache Command  : GET Message");
           System.out.println("Cache Response : " + map.get("Message"));
   
           redissonClient.shutdown();
   
       }
   
       private static Config getConfig() {
           //Construct a Token Credential from Identity library, e.g. DefaultAzureCredential / ClientSecretCredential / Client    CertificateCredential / ManagedIdentityCredential etc.
           DefaultAzureCredential defaultAzureCredential = new DefaultAzureCredentialBuilder().build();
   
           // Fetch a Microsoft Entra token to be used for authentication.
           String token = defaultAzureCredential
                   .getToken(new TokenRequestContext()
                           .addScopes("https://redis.azure.com/.default")).block().getToken();
   
           // Connect to the Azure Cache for Redis over the TLS/SSL port using the key
           Config redissonconfig = new Config();
           redissonconfig.useSingleServer()
                   .setAddress(String.format("rediss://%s:%s", System.getenv("REDIS_CACHE_HOSTNAME"),  System.getenv("REDIS_CACHE_PORT")))
                   .setUsername(System.getenv("USER_NAME")) // (Required) Username is Object ID of your managed identity or service principal
                   .setPassword(token); // Microsoft Entra access token as password is required.
           return redissonconfig;
       }
   }
   
   

6. Сохраните App.java.

Создание и запуск приложения

Выполните следующую команду Maven для построения и запуска приложения:

mvn compile exec:java -Dexec.mainClass=example.demo.App

В следующих выходных данных можно увидеть, что Message ключ ранее имел кэшированное значение, которое было задано в последнем запуске. Приложение обновило кэшированное значение.

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java! 2023-12-05T15:13:11.398873

Cache Command  : SET Message

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java! 2023-12-05T15:45:45.748667

Очистите ресурсы

Если вы планируете продолжить работу со следующим руководством, вы можете сохранить ресурсы, созданные в этом кратком руководстве, и повторно использовать их.

В противном случае, если вы закончили работу с примером приложения из краткого руководства, вы можете удалить ресурсы Azure, созданные в текущем руководстве, чтобы избежать ненужных расходов.

1. Войдите в портал Azure и выберитеГруппы ресурсов.

2. Введите имя группы ресурсов в текстовое поле Фильтровать по имени. Инструкции для этой статьи использовали группу ресурсов с именем TestResources. В группе ресурсов в списке результатов выберите "Тестовые ресурсы " и "Удалить группу ресурсов".

   

3. Введите имя группы ресурсов, чтобы подтвердить удаление, а затем нажмите кнопку "Удалить".

Через некоторое время группа ресурсов и все ее ресурсы будут удалены.

Дальнейшие шаги

Из этого краткого руководства вы узнали, как использовать Кэш Azure для Redis из приложения Java с клиентом Redisson Redis и JCache. Переходите к следующему краткому руководству по использованию кэша Azure для Redis в веб-приложениях ASP.NET.