跳转到正文

基础 Component

基础 Component 对应 own-springboot-component,提供可复用的技术能力,供基础 Business 和应用项目使用,不依赖 Business 项目。

首次接入先阅读统一 Dependencies了解 Java、Spring Boot 和 BOM 基线;只使用组件时可选择 Component BOM,已有项目统一 BOM 时无需重复导入。

模块范围

分类能力范围
基础能力公共常量、配置属性、Web 基础支持、通用业务模型与工具
认证与安全身份认证、测试认证、Token、权限、开放接口、敏感操作确认与敏感信息校验
请求参数客户端、设备、版本和 Token 等公共请求参数解析
数据与存储MyBatis、Elasticsearch、统一存储与缓存
消息与日志消息队列、短信、系统日志采集与扩展接口
通用工具加密、Excel、日期时间等工具

其中通用业务模型与工具属于 Component 的复用能力;账号、组织等具体业务域归入基础 Business

模块文档

  • Constant 基础工具:公共常量、响应异常、Hook,以及集合分页、文件图片与脱敏编码工具。
  • Base 基础组件:统一 Web 响应、异常处理和 JSON 格式,提供 TraceId、会话用户契约与上下文任务执行。
  • Base Business 通用 CRUD:复用实体转换、Mapper、服务 Hook、分页和关系绑定抽象。
  • Authentication 身份适配:将应用身份来源接入统一会话用户、权限模型和状态扩展。
  • Store 组件:统一访问本地与 Redis 数据,提供查询缓存、作用域锁和限流。
  • 系统日志组件:采集接口操作、发起人和响应,交给保存器处理。

其他模块的使用文档待补充。

公开源码与方法参考

Component 源码仓库保留当前仓库地址;恢复公开权限后可匿名浏览,未公开时需要仓库访问权限。各模块概览新增“重点文件与方法”入口;正文中的类、方法链接指向实际源码文件,参考页按本次核对提交固定版本,便于对照实现。

模块方法参考
Authentication重点文件与方法
Base重点文件与方法
CRUD重点文件与方法
Constant重点文件与方法
Store重点文件与方法
日志采集重点文件与方法