如何在 Java 中使用 Redis 缓存与 GroupDocs.Conversion

Redis 是一种支持字符串、哈希、列表、集合等的数据结构的内存存储。Redis 是功能强大的开源内存数据结构存储，可用作数据库、缓存和消息代理。当您学习 如何使用 Redis 与 GroupDocs.Conversion 结合时，您为 Java 应用程序提供了一个快速的缓存层，显著降低文档转换延迟。在本指南中，我们将完整演示 redis cache java tutorial，从环境搭建到实际使用，让您立即看到性能提升。

快速答案

• 使用 Redis 与 GroupDocs 的主要好处是什么？ 通过避免重复转换，实现更快的文档检索。
• 哪个 Maven 构件添加了 GroupDocs.Conversion？ com.groupdocs:groupdocs-conversion。
• 如何将 Java 连接到 Redis？ 使用类似 ConnectionMultiplexer.Connect("localhost") 的 Java Redis 连接示例。
• 我可以自定义缓存键吗？ 可以 —— redis cache key prefix 让您组织条目。
• 生产环境是否需要许可证？ 需要，有效的 GroupDocs.Conversion 许可证是必需的。

ConnectionMultiplexer 是 StackExchange.Redis 库中的客户端类，负责管理到 Redis 服务器的连接。

什么是 GroupDocs.Conversion for Java？

GroupDocs.Conversion for Java 是一个库，可将 80 多种文件格式转换为 PDF、图像和其他输出。它提供统一的 API，实现高质量、服务器端的文档转换，无需安装 Microsoft Office。它支持转换为 PDF、图像、HTML 等多种格式，并提供水印、分页和自定义渲染设置等选项。

为什么要在 GroupDocs.Conversion 中使用 Redis？

将 Redis 作为缓存层可将重复请求的转换时间削减 最高达 90 %，并在处理大批量时将 CPU 使用率降低 约 70 %。这些量化的优势说明了为何众多企业在高吞吐量文档服务中采用此模式。

前置条件

必需的库和依赖

1. Java Development Kit (JDK)： 8 版或更高。
2. Redis 服务器： 本地运行或可远程访问。
3. GroupDocs.Conversion for Java： 通过 Maven 添加（见下文 maven dependency groupdocs 部分）。

环境搭建

• 按照 this guide 安装 Redis。
• 使用合适的 JDK 配置您的 IDE（IntelliJ IDEA、Eclipse 等）。

知识前提

• 基础的 Java 与面向对象概念。
• 熟悉 Maven 进行依赖管理。
• 理解缓存原理以及它为何对文档转换重要。

设置 GroupDocs.Conversion for Java

GroupDocs.Conversion 库是执行格式转换的核心引擎。将以下 Maven 代码片段添加到您的 pom.xml，即可获取官方包：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

许可证获取

1. 免费试用： 前往 GroupDocs 注册并下载试用版。
2. 临时许可证： 在 purchase page 请求延长评估的临时许可证。
3. 购买： 商业使用请通过其 buy page 购买许可证。

获取许可证后，您可以实例化转换器：

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.ConvertOptions;

// Initialize the Converter object with a document path
Converter converter = new Converter("path/to/your/document");

实施指南

Redis 缓存集成概述

我们将创建一个实现 ICache 的自定义 RedisCache 类。该类演示了 java redis connection example，并展示了如何使用 redis cache key prefix。

RedisCache 是 GroupDocs 的 ICache 接口的自定义实现，用于在 Redis 中存储转换结果。

步骤 1：创建 RedisCache 类

下面是完整实现。请保持代码原样，包括所有必需的导入和缓存键处理逻辑。

import com.groupdocs.conversion.caching.ICache;
import StackExchange.Redis;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import java.util.List;

public class RedisCache implements ICache, AutoCloseable {
    private String _cacheKeyPrefix = "GroupDocs:";
    private ConnectionMultiplexer _redis;
    private IDatabase _db;
    
    public RedisCache() {
        _redis = ConnectionMultiplexer.Connect("localhost");
        _db = _redis.GetDatabase();
    }

    public void Set(String key, Serializable data) throws IOException {
        String prefixedKey = GetPrefixedKey(key);
        try (ObjectOutputStream oos = new ObjectOutputStream(_db.StreamWrite())) {
            oos.writeObject(data);
            _db.StringSet(prefixedKey, oos.toString());
        }
    }

    public boolean TryGetValue(String key, Object value) {
        String prefixedKey = GetPrefixedKey(key);
        byte[] serializedData = _db.StringGet(prefixKey).ToArray();
        if (serializedData != null) {
            try (ObjectInputStream ois = new ObjectInputStream(new ByteArrayInputStream(serializedData))) {
                value = ois.readObject();
                return true;
            } catch (IOException | ClassNotFoundException e) {
                e.printStackTrace();
            }
        }
        return false;
    }

    public List<String> GetKeys(String filter) {
        return _db.Keys(_cacheKeyPrefix + "*" + filter + "*").Select(k -> k.ToString().Replace(_cacheKeyPrefix, "")).ToList();
    }

    private String GetPrefixedKey(String key) {
        return _cacheKeyPrefix + key;
    }

    @Override
    public void close() throws Exception {
        _redis.Dispose();
    }
}

步骤 2：在 GroupDocs.Conversion 中使用 Redis 缓存

现在我们将缓存接入转换工作流。此代码片段展示了一个 convert documents pdf java 示例，先检查缓存再调用 GroupDocs.Conversion。

// Example usage of RedisCache with GroupDocs.Conversion
public void ConvertAndCacheDocument(String filePath) throws IOException {
    String cacheKey = "converted:" + filePath;
    Object cachedResult;

    if (cacheRedis.TryGetValue(cacheKey, cachedResult)) {
        System.out.println("Retrieved from cache: " + cachedResult);
    } else {
        // Perform conversion
        Converter converter = new Converter(filePath);
        ConvertOptions options = new PdfConvertOptions();
        byte[] result = converter.Convert(() -> new ByteArrayOutputStream(), options);

        // Cache the conversion result
        cacheRedis.Set(cacheKey, result);
        System.out.println("Conversion performed and cached.");
    }
}

关键配置选项

• _cacheKeyPrefix – 调整此 redis cache key prefix 以对相关条目进行分组（例如 "Docs:"）。
• ConnectionMultiplexer 设置 – 为分布式 Redis 集群调优连接池、超时或 SSL。

Redis 如何提升转换速度？

首次加载文档后，将生成的字节数组存入 Redis，后续调用时直接读取——消除了重复的 CPU 密集型转换。通过缓存二进制输出，平均响应时间可从数秒降至数毫秒，尤其对频繁访问的热门文档效果显著。

什么是 Redis 缓存键前缀？

redis cache key prefix 是在每个缓存条目键前添加的短字符串，用于对数据进行分段（例如 "Docs:" 用于文档缓存，"Thumb:" 用于缩略图）。使用唯一前缀可防止多个应用共享同一 Redis 实例时出现键冲突。

如何在 Java 中配置 Redis 连接？

创建 ConnectionMultiplexer 实例并提供 Redis 服务器地址，可选密码和 SSL 设置。简单本地部署时，调用 ConnectionMultiplexer.Connect("localhost")。生产集群则需传入逗号分隔的节点列表，并使用 ConfigurationOptions 配置故障转移和负载均衡。

如何以编程方式清除 Redis 缓存？

调用 Redis 数据库的 KeyDelete 方法并使用匹配前缀的模式（例如 _db.KeyDelete("Docs:*")）一次性删除所有缓存的转换结果，适用于部署期间或源文件变更时。也可以使用 SCAN 命令遍历匹配键后再删除，这在大数据集下更安全。

KeyDelete 是 Redis 数据库客户端的方法，用于删除符合给定模式的键。

实际应用场景

1. 文档转换工作流： 缓存 PDF 或图像输出，以即时响应重复请求。
2. 内容分发网络（CDN）： 将缓存的二进制文件存入 Redis，实现快速边缘分发。
3. 批处理系统： 在多个批次运行之间复用转换结果，节省 CPU 周期。

性能考虑因素

优化 Redis 缓存使用

• 内存管理： 设置合适的 maxmemory 与驱逐策略（如 volatile-lru）。
• 驱逐策略： 根据使用模式选择 LRU、LFU 或基于 TTL 的过期方式。
• 序列化开销： 示例使用 Java 序列化；如需更紧凑的负载，可考虑 protobuf 或 JSON。

使用 GroupDocs.Conversion 的 Java 内存管理

通过流式处理结果 (ByteArrayOutputStream) 并及时释放资源。RedisCache 实现了 AutoCloseable，确保 Redis 连接能够正确释放。

常见问题与故障排除

常见问答

Q: 我可以在远程 Redis 集群上使用此方案吗？
A: 可以。将 "localhost" 替换为集群端点，并为 ConnectionMultiplexer 配置 SSL 与密码认证。

Q: 如何更改 redis cache key prefix？
A: 修改 RedisCache 中的 _cacheKeyPrefix 字段。使用唯一前缀有助于避免跨应用的键冲突。

Q: 有办法以编程方式清除缓存吗？
A: 调用 _db.KeyDelete(pattern)，或使用 GetKeys 获取匹配键后在循环中删除。

Q: 这是否适用于除 PDF 之外的文档转换？
A: 完全可以。将 PdfConvertOptions 替换为相应的 ConvertOptions 子类（如 DocxConvertOptions）。

Q: 需要哪个版本的 GroupDocs.Conversion？
A: 本教程在 GroupDocs.Conversion 25.2 上测试通过，更新的版本也应兼容。

结论

通过掌握 如何使用 Redis 与 GroupDocs.Conversion 的结合，您已经构建了一个强大的缓存层，显著缩短转换时间，降低服务器负载，提升终端用户体验。继续尝试不同的 redis cache key prefixes、驱逐策略和序列化格式，以针对您的具体工作负载微调性能。

后续步骤

• 尝试不同的驱逐策略（LRU、TTL）。
• 对大批量文档进行内存使用分析。
• 探索 GroupDocs 的高级功能，如水印或多页转换。

Last Updated: 2026-07-24
Tested With: GroupDocs.Conversion 25.2
Author: GroupDocs

相关教程

• How to Cache Documents in Java Using Redis & GroupDocs
• How to Cache Files in Java with GroupDocs.Conversion – A Comprehensive Guide for Efficient Document Conversion
• Implement Custom Cache Java – GroupDocs Conversion Cache