🌐 mica(云母)

Java CIJAVA 17Mica Maven releaseGitHub

mica 是一套 Spring Boot / Spring Cloud 微服务开发的基础组件与工具包,同时支持 webwebflux

它的定位是一组解耦良好的可插拔组件:每个能力都独立成一个 mica-xxx 模块,按需引依赖,不引入的模块不会进你的 classpath。下面按能力划分为五个分组,点进去看各模块的依赖坐标、配置项与示例代码。

📦 模块导航

基础与核心

模块说明
mica-bom依赖版本统一管理,避免 jar 冲突(建议第一步就引入
mica-core核心工具包:Bean copy 增强、表单枚举、统一返回模型与常用工具类
mica-lite单服务可直接使用的最小集:全局异常处理、上传目录、启动信息打印
mica-auto编译期生成 spring.factories / SPI 配置,开发 starter 的利器(独立项目)

HTTP 与 Web

模块说明
mica-httpokhttp 封装,Fluent 语法 HTTP 客户端
mica-spider基于 mica-http 的爬虫工具,CssQuery 注解实现 HTML → Bean
mica-xss表单 / JSON 字符串的 XSS 处理,支持放行规则
mica-openapiOpenAPI / Swagger 依赖整合(不支持 webflux)

缓存与存储

模块说明
mica-redisRedis cache 增强、分布式限流、key 失效事件、Stream / PubSub
mica-caffeineCaffeine 本地缓存增强,# 号分隔 cache 名与超时
mica-activerecordJFinal ActiveRecord 的 Spring Boot 集成,含可执行 SQL 打印

日志与监控

模块说明
mica-logginglogback 扩展:json 日志、logstash / loki 收集、启动后关闭控制台
mica-metricsDruid 指标收集
mica-prometheus对接 Prometheus http_sd,支持 alert webhook

常用工具

模块说明
mica-captcha图形验证码生成与校验(随机 / 算术),支持多种缓存
mica-qrcode服务端二维码生成 / 识别,支持添加 logo
mica-ip2region离线 IP 归属地查询,内置 xdb 文件
mica-holidays中国法定节假日 / 工作日判断
mica-ddddocr通用验证码识别,基于 ONNX Runtime

🔖 版本说明

最新版本spring boot 版本spring cloud 版本维护状态
4.0.24.0.x2025.1.x
3.5.73.5.x2025
3.4.73.4.x2024
3.3.63.3.x2023
3.2.123.2.x2023
3.1.123.1.x2022
3.0.83.0.x2022
2.7.18.92.7.x2021
2.6.82.6.x2021
2.5.82.5.x2020
2.4.112.4.x2020
2.1.1-GA2.2.x ~ 2.3.xHoxton

release 版本号格式为 x.x.x,基本保持跟 Spring Boot 一致;snapshots 版本号格式为 x.x.x-SNAPSHOTpush 后自动发布。

🚀 快速开始

先用 mica-bom 统一版本,再按需引入具体模块:

xml
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>net.dreamlu</groupId>
      <artifactId>mica-bom</artifactId>
      <version>${mica.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
xml
<dependency>
  <groupId>net.dreamlu</groupId>
  <artifactId>mica-core</artifactId>
</dependency>

模块坐标、配置项与完整示例见上表对应的子模块文档。

🔗 相关链接

🐛 已知问题

lombok 生成的 method 问题:https://github.com/rzwitserloot/lombok/issues/1861

对于 xX 类属性名(第一个小写、第二个大写)的 bean,MapBeanBeanMap 存在问题,不打算做兼容,待 lombok 新版修复。

📌 开源协议

LGPL v3,软著编号2020SR0411603

  • 允许以引入不改源码的形式免费用于学习、毕设、公司项目、私活等。
  • 特殊情况修改代码但仍想闭源,需经过作者同意。
  • 参考请注明:参考自 mica(https://github.com/lets-mica/mica),另请遵循 LGPL 协议。
  • 注意:若禁止条款被发现,有权追讨 19999 的授权费。

LGPL 允许商业软件通过类库引用(link)方式使用而不需要开源自己的代码;但修改或衍生 LGPL 代码,则修改部分与衍生代码都必须采用 LGPL 协议。

🌱 mica 生态

项目说明
mica-autoSpring Boot starter 开发利器,编译期生成配置
mica-net基于 Java AIO 的轻量高性能网络通信框架
mica-ai零 Python 的 Java AI 能力栈
mica-ppocrPP-OCRv6 纯 Java OCR
mica-voiceASR / TTS / 声纹 / VAD / 说话人分离
mica-admin低代码权限管理平台(三端一套代码)
mica-mqtt百万级 Java MQTT 组件(独立站点)