快速入门：在 Java 中使用 Azure Cache for Redis 和 Redisson Redis 客户端

在本快速入门中，你将 Azure Cache for Redis 合并到 Java 应用中，该应用使用 Redisson Redis 客户端和 JCP 标准 JCache API。 这些服务使用户可以访问安全专用缓存，该缓存可从 Azure 内的任何应用程序进行访问。 针对如何选择要用于 Redis 连接的 Azure 标识，本文提供了两个选项。

本快速入门使用 Maven 原型功能为应用生成基架。 快速入门指引你修改生成的代码，从而实现可运行的示例应用。 如果要直接跳到已完成的代码，请参阅 GitHub 上的 Java 快速入门。

• Azure 订阅 - 创建订阅
• 使用 Microsoft Entra ID 进行缓存身份验证
• Apache Maven

以下步骤演示了如何为 Java 应用设置工作环境。 可以选择使用 Microsoft Entra ID（推荐）或访问密钥来对 Azure Cache for Redis 进行身份验证。

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

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

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

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

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 ID 身份验证（建议）
   • 访问密钥身份验证

   <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 ID 身份验证（建议）
   • 访问密钥身份验证

   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 Cache for Redis 从 Java 应用程序与 Reis Redis 客户端和 JCache 配合使用。 请继续学习下一个快速入门，将 Azure Cache for Redis 与 ASP.NET Web 应用配合使用。