Skip to content

RAF Framework企业级微服务中间件接入层

消除微服务重复建设——Redis、MQ、多数据源、全局异常,引入即得,不引入零侵入

20+Starters
Spring Boot 3.4基础框架
Java 17+运行环境
4 大云厂商KMS 多云支持
0 侵入不引入零副作用
OWASP安全合规
CORE CAPABILITIES

四大核心能力

从接入规范到安全合规,覆盖微服务开发的全部横切关注点。

01

按需接入,零副作用

所有组件默认关闭。raf.{component}.enabled=true 一行启用,不引入 Starter 则零自动装配、零 Bean 注册,对现有工程完全无侵入。

@ConditionalOnProperty
02

全链路规范,开箱即得

RafResult<T> 统一响应、四层异常体系、HTTP 请求日志、分布式 TraceId 全链路传播。团队无需自定义规范,接入即对齐。

RFC-compliant
03

内置可观测,无需额外搭建

慢 SQL 300ms/500ms 双阈值告警、线程池 Prometheus 指标暴露、优雅停机 30s 等待、Sentry 错误上报,生产监控开箱即用。

Production-grade
04

多云安全,通过企业审计

网关层 ECIES 加密 + ECDSA 签名 + 防重放,多云 KMS 统一密钥管理,Jasypt 配置加密,XSS 过滤。通过 OWASP / Fortify 安全扫描。

OWASP-compliant
DESIGN PHILOSOPHY

三条核心设计原则

不是另一个脚手架,而是一个中间件接入层。每一条原则都来自真实的团队痛点。

01
热插拔,不引入零侵入
每个微服务项目都要重复写 Redis 配置、MQ 消费者、多数据源路由、全局异常处理。RAF 把这些横切关注点封装成独立 Starter,引入依赖即生效,不引入则对工程完全透明。
raf.redis.enabled=true
02
零硬编码,配置与代码彻底解耦
地址、密钥、账号等所有环境配置全部由外部配置中心(Nacos)注入。代码仓库中不存在任何环境相关的硬编码值,同一份制品可在开发、测试、生产环境无缝流转。
spring.cloud.nacos.config.server-addr=${NACOS_ADDR}
03
双接入模式,适配任何团队规范
Maven 单继承限制是企业项目的常见约束。RAF 同时支持 parent 继承和 BOM 组合两种方式,无论团队是否已有父工程,都能以最小改动完成接入,不破坏现有工程结构。
<type>pom</type><scope>import</scope>
ARCHITECTURE

四层模块体系

从依赖治理到业务接入,每一层职责清晰、边界分明。
业务项目只需选择所需 Starter,其余全部由框架托管。

BOM
raf-framework-dependencies
统一管理所有第三方依赖版本,业务项目无需关心版本冲突
PARENT
raf-framework-parent
提供 Maven 插件配置、flatten 版本展开、编译参数统一设置
CORE
raf-framework-core
自动配置实现层:Jackson、异常处理、TraceId、工具类等核心能力
STARTER
raf-framework-*-starter
按功能拆分的热插拔组件,引入即可用,不引入零副作用

Released under the MIT License.