# [045][Crypto模块]设计一个可扩展的加解密框架：策略模式与工厂模式实战

本项目代码: https://gitee.com/yunjiao-source/tutorials4j

在企业级应用中，数据加解密是一个常见需求。然而，加密算法种类繁多（AES、RSA、SM2、SM4 等），且不同场景可能需要更换算法。如果每次都在业务代码中直接调用具体算法，会带来强耦合、难以维护等问题。本文通过一个基于 Spring Boot 的加解密框架设计，介绍如何利用**策略模式**与**工厂模式**构建一个可插拔、易扩展的加解密框架。

## 一、为什么要设计统一的加解密接口？

看一段常见的“坏味道”代码：

```java
// 业务代码中直接依赖具体算法
String encrypted = AESUtil.encrypt(data, key);
String decrypted = AESUtil.decrypt(encrypted, key);
```

当需要从 AES 切换到 SM4，或者从 RSA 切换到 SM2 时，不得不修改所有调用的地方。更糟糕的是，不同算法需要的密钥格式、参数各不相同，业务代码会变得臃肿。

理想的框架应该：
- 提供统一的加解密接口，业务代码只依赖接口。
- 允许通过配置或注解动态切换算法。
- 支持对称加密、非对称加密、摘要（哈希）等不同类别。
- 易于扩展新算法。

## 二、核心接口设计：策略模式

首先定义所有加解密处理器都要实现的接口 `CryptoProcessor`：

```java
public interface CryptoProcessor {
    CryptoCategory getCategory();          // 返回算法类别，如 AES、RSA
    SecretKey getSecretKey();              // 获取当前使用的密钥信息
    CryptoProcessor newInstance();         // 创建新的处理器实例（自动生成密钥）
    CryptoProcessor newInstance(SecretKey secretKey); // 指定密钥创建实例
    String decrypt(String content);
    String encrypt(String content);
}
```

这里使用了**策略模式**：每种算法（AES、SM2、RSA 等）都是一个具体的策略实现类，它们都遵循相同的接口。业务代码只需要持有 `CryptoProcessor` 引用，调用 `encrypt/decrypt` 即可，无需关心底层是哪种算法。

同理，摘要类接口单独定义：

```java
public interface DigestProcessor {
    DigestCategory getCategory();
    SecretKey getSecretKey();
    DigestProcessor newInstance();
    DigestProcessor newInstance(SecretKey secretKey);
    String digest(String content);
    String digest(String content, Charset charset);
}
```

通过接口分离，加解密和摘要两类处理器可以分别管理。

## 三、工厂模式：统一查找与获取

有了多种策略实现，如何根据算法名称或类别快速获取对应的处理器？答案是**工厂模式**。框架中设计了 `CryptoProcessorFactory`：

```java
public class CryptoProcessorFactory {
    public static final CryptoProcessorFactory instance = new CryptoProcessorFactory();
    protected EnumMap<CryptoCategory, CryptoProcessor> processors = new EnumMap<>(CryptoCategory.class);

    public CryptoProcessor findProcessor(CryptoCategory category) {
        CryptoProcessor processor = processors.get(category);
        if (processor == null) {
            throw new CryptoException("根据分类查找加解密处理器未找到, 分类是：" + category);
        }
        return processor;
    }

    public void setProcessors(Map<CryptoCategory, CryptoProcessor> processors) {
        this.processors.putAll(processors);
    }
}
```

`EnumMap` 保证了分类与处理器之间的高效映射。工厂以单例形式存在，方便在框架各处获取。

## 四、Spring 集成：自动注册策略实现

策略类和工厂都准备好了，如何让 Spring 容器自动将所有策略实现注册到工厂中？利用 Spring 的 `ObjectProvider` 和自动配置：

```java
@Configuration
@EnableConfigurationProperties(CryptoProperties.class)
public class CryptoConfiguration {
    @Bean
    @ConditionalOnMissingBean
    CryptoProcessorFactory cryptoProcessorFactory(ObjectProvider<CryptoProcessor> providers) {
        Map<CryptoCategory, CryptoProcessor> processors =
            providers.stream().collect(Collectors.toMap(CryptoProcessor::getCategory, m -> m));
        CryptoProcessorFactory.instance.setProcessors(processors);
        return CryptoProcessorFactory.instance;
    }
}
```

- `ObjectProvider<CryptoProcessor>` 会获取容器中所有 `CryptoProcessor` 类型的 Bean（即各个算法的实现类）。
- 通过 `Collectors.toMap` 按照 `getCategory()` 分类建立映射。
- 注入到工厂实例中。

这样做的好处：新增一种算法时，只需编写一个实现 `CryptoProcessor` 的新类，并把它声明为 Spring Bean，工厂就会自动识别，完全符合**开闭原则**。

## 五、枚举与类别的关联

为了统一管理支持的算法类型，定义 `CryptoCategory` 枚举：

```java
public enum CryptoCategory {
    AES, DES, SM2, SM4, RSA;
}
```

每个策略实现类必须返回其中一个类别。例如 `AESCryptoProcessor` 实现 `getCategory()` 返回 `CryptoCategory.AES`。

非对称加密还有一个额外的枚举 `AsymmetricCryptoStrategy`，用于配置文件中选择默认的非对称算法（RSA 或 SM2）：

```java
public enum AsymmetricCryptoStrategy {
    STANDARD(CryptoCategory.RSA),
    SM(CryptoCategory.SM2);
    private final CryptoCategory category;
}
```

## 六、代码示例：如何新增一个国密 SM9 处理器

假设需要新增 SM9 算法（国产标识加密），步骤如下：

1. 在 `CryptoCategory` 中增加 `SM9`。
2. 实现 `CryptoProcessor` 接口：

```java
public class SM9CryptoProcessor implements CryptoProcessor {
    private final SM9 sm9;
    private final SecretKey secretKey;

    public static SM9CryptoProcessor create() { ... }
    public static SM9CryptoProcessor create(SecretKey secretKey) { ... }

    @Override public CryptoCategory getCategory() { return CryptoCategory.SM9; }
    @Override public String encrypt(String content) { ... }
    @Override public String decrypt(String content) { ... }
    // 其他方法...
}
```

3. 将该类声明为 Spring Bean（例如通过 `@Bean` 或 `@Component`）。框架会自动检测并将其注册到 `CryptoProcessorFactory` 中。

业务代码中获取 SM9 处理器：

```java
CryptoProcessor processor = CryptoProcessorFactory.instance.findProcessor(CryptoCategory.SM9);
String encrypted = processor.encrypt("hello");
```

## 七、总结

通过策略模式 + 工厂模式 + Spring 自动注册，我们构建了一个高内聚低耦合的加解密框架。核心优势：

- **可扩展**：新增算法无需修改任何现有代码。
- **可配置**：通过 `@ConfigurationProperties` 可以灵活指定密钥、盐值等。
- **统一接口**：业务代码不再依赖具体加密库（如 Hutool、BouncyCastle），便于后续切换底层实现。
- **类型安全**：使用枚举而非字符串表示算法类别，避免拼写错误。

这种设计思想同样适用于其它中间件集成（如序列化、日志、缓存等），值得在大型项目中推广。


本项目代码: https://gitee.com/yunjiao-source/tutorials4j

[045][Crypto模块]设计一个可扩展的加解密框架：策略模式与工厂模式实战

在企业级应用中，数据加解密是一个常见需求。然而，加密算法种类繁多（AES、RSA、SM2、SM4 等），且不同场景可能需要更换算法。如果每次都在业务代码中直接调用具体算法，会带来强耦合、难以维护等问题。本文通过一个基于 Spring Boot 的加解密框架设计，介绍如何利用**策略模式**与**工厂模式**构建一个可插拔、易扩展的加解密框架

编程语言

开发工具

后端

本文介绍基于SpringBoot的加解密框架设计，采用策略模式与工厂模式实现算法可插拔扩展。框架提供统一接口支持AES、RSA、SM2等多种加密算法，通过自动注册机制实现新增算法零修改，解决业务代码与具体算法的强耦合问题，提升系统可维护性和扩展性。

非对称加密

对称加密

代码解释

中间件

容器

国密

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

[045][Crypto模块]设计一个可扩展的加解密框架：策略模式与工厂模式实战-腾讯云开发者社区-腾讯云

[045][Crypto模块]设计一个可扩展的加解密框架：策略模式与工厂模式实战

[045][Crypto模块]设计一个可扩展的加解密框架：策略模式与工厂模式实战

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐