junco-framework

介绍

一个极致精简的Java的原生云微服务开发框架，能够运行于本地或k3s/k8s作为服务发现，使用约定格式RPC进行调用,RPC的服务发现是应用级的JSON-RPC，开发代码基于接口级使用。

环境要求

• jdk17 及以上

软件架构

• junco-core 核心组件包含Bean容器（用JavaConfig形式的支持读取配置，环境变量覆盖）、IOC（控制反转->依赖注入）、AOP（面向切面->动态代理）、生命周期回调

• junco-jasypt 配置解密扩展组件，按需提供 ENC(...) 配置值解密能力

• junco-web Web服务组件，JAX-RS标准 实现 http1.0, http1.1 基本的接口，支持sse、multipart表单与文件上传，WebSocket 由 junco-websocket 可选模块提供

• junco-web-validator Web请求校验组件，提供参数校验、分组校验与统一校验异常支持

• junco-web-doc Web接口文档组件，提供 OpenAPI 文档导出与文档页面能力

• junco-websocket WebSocket服务组件，支持文本、二进制消息及连接生命周期回调

• junco-rpc 微服务JSON-RPC组件（结合dubbo和feign这2种特性使用注解完成服务提供和消费）

• junco-gateway 微服务网关组件，支持统一代理下游微服务 OpenAPI 文档，并提供轻量聚合入口页

• junco-schedule 轻量定时任务组件，支持 cron/fixedRate/fixedDelay、分布式锁、失败重试与管理端点

• junco-test 框架级测试组件，支持 @JuncoTest、随机端口、Mock/Spy Bean、Web 测试客户端及 Testcontainers 集成

• junco-bom 统一版本管理 BOM，业务项目引入一个 import 即可锁定所有 Junco 模块及推荐依赖版本

• junco-redis-kit Redis工具套件，封装了计数、去重、分布式锁、延时队列、限流和可选 readiness 健康检查

• junco-cache 缓存注解组件，默认提供纯内存实现，支持方法结果缓存、删缓存、写后回填

• junco-cache-redis Redis缓存存储扩展组件，基于junco-redis-kit为junco-cache提供Redis版CacheProvider

• junco-nats NATS消息组件，提供发布订阅、JetStream 可靠消费、死信、重试、积压指标和可选 readiness 健康检查

• junco-jdbc JDBC基础设施组件，默认单数据源，支持多数据源路由、JavaConfig包路由、包通配路由（* 单级包，** 多级包）、@JuncoDataSource、本地事务、JdbcTemplate、健康检查

• junco-jooq jOOQ运行时集成组件，复用junco-jdbc的数据源、事务与连接桥接，提供DSLContext

项目文档

• 兼容性承诺：说明配置项、注解、指标名、RPC 协议、异常结构的 SemVer 兼容范围。
• 运维手册：说明健康检查、readiness、Prometheus、Grafana 和故障排查。
• Metrics 指标说明：说明 Prometheus 指标名、标签、配置和看板迁移建议。
• 安全基线：说明默认安全行为、生产暴露边界、输入校验、运维端点和上线检查。