lets-mica/mica

Spring Cloud 微服务开发核心工具集。工具类、验证码、http、redis、ip2region、xss 等，开箱即用。 🔝 🔝 记得右上角点个star 关注更新！

🌐 mica（云母）

Mica，Spring Cloud 微服务开发核心包，支持 web 和 webflux。

简体中文 | English

🔖 版本说明

最新版本	spring boot 版本	spring cloud 版本	状态
3.3.2	3.3.x	2023	✅
3.2.8	3.2.x	2023	✅
3.1.12	3.1.x	2022	❌
3.0.8	3.0.x	2022	❌
2.7.18.5	2.7.x	2021	✅
2.6.8	2.6.x	2021	❌
2.5.8	2.5.x	2020	❌
2.4.11	2.4.x	2020	❌
2.1.1-GA	2.2.x ~ 2.3.x	Hoxton	❌

🏷️ 版本号说明

release 版本号格式为 x.x.x， 基本上保持跟 Spring boot 一致。

snapshots 版本号格式为 x.x.x-SNAPSHOT。

注意：snapshots 版本 push 后会自动发布，及时响应修复最新的 bug 和需求。

📝 使用文档

使用文档详见：https://www.dreamlu.net/mica2x/index.html（mica2.x 使用文档）

更新记录详见：Mica 更新记录

🌱 mica 生态

• mica-auto (Spring boot starter 利器): https://gitee.com/596392912/mica-auto
• mica-weixin（jfinal weixin 的 spring boot starter）: https://gitee.com/596392912/mica-weixin
• mica-mqtt（基于 t-io 实现的 mqtt组件）: https://gitee.com/596392912/mica-mqtt
• Spring cloud 微服务 http2 方案（h2c）: https://gitee.com/596392912/spring-cloud-java11
• mica-security（mica权限系统 vue 改造中）: https://gitee.com/596392912/mica-security

🐛 已知问题

lombok 生成的 method 问题：projectlombok/lombok#1861

对于 xX 类属性名，第一个小写，第二个大写的 bean 属性名，Map -> Bean 或 Bean -> Map 存在问题。

不打算做兼容，待 lombok 新版修复。

📌 开源协议

软著编号：2020SR0411603

📄 协议解释

LGPL（GNU Lesser General Public License）

LGPL 是 GPL 的一个为主要为类库使用设计的开源协议。和 GPL 要求任何使用/修改/衍生之 GPL 类库的的软件必须采用 GPL 协议不同。LGPL 允许商业软件通过类库引用(link)方式使用 LGPL 类库而不需要开源商业软件的代码。这使得采用 LGPL 协议的开源代码可以被商业软件作为类库引用并发布和销售。

但是如果修改 LGPL 协议的代码或者衍生，则所有修改的代码，涉及修改部分的额外代码和衍生的代码都必须采用 LGPL 协议。因此 LGPL 协议的开源代码很适合作为第三方类库被商业软件引用，但不适合希望以 LGPL 协议代码为基础，通过修改和衍生的方式做二次开发的商业软件采用。

✅ 用户权益

允许以引入不改源码的形式免费用于学习、毕设、公司项目、私活等。

特殊情况修改代码，但仍然想闭源需经过作者同意。

对未经过授权和不遵循 LGPL 协议二次开源或者商业化我们将追究到底。

参考请注明：参考自 mica：https://github.com/lets-mica/mica ，另请遵循 LGPL 协议。

注意：若禁止条款被发现有权追讨 19999 的授权费。

🗃️ 授权用户（最佳实践）

• pigx 宇宙最强微服务（架构师必备）：https://pig4cloud.com
• bladex 完整的线上解决方案（企业生产必备）：https://bladex.vip

🔍️ 相关链接

• mica 源码 Github：https://github.com/lets-mica
• mica 源码 Gitee（码云）：https://gitee.com/596392912/mica
• mica 性能压测：https://github.com/lets-mica/mica-jmh
• 文档地址（官网）：http://wiki.dreamlu.net
• 文档地址（语雀-可关注订阅）：https://www.yuque.com/dreamlu

🍻 开源推荐

• Avue 一款基于 vue 可配置化的神奇框架：https://gitee.com/smallweigit/avue
• pig 宇宙最强微服务（架构师必备）：https://gitee.com/log4j/pig
• SpringBlade 完整的线上解决方案（企业开发必备）：https://gitee.com/smallc/SpringBlade
• IJPay 支付 SDK 让支付触手可及：https://gitee.com/javen205/IJPay
• JustAuth 史上最全的整合第三方登录的开源库: https://github.com/zhangyd-c/JustAuth
• spring-boot-demo 深度学习并实战 spring boot 的项目: https://github.com/xkcoding/spring-boot-demo

💚 鸣谢

感谢 JetBrains 提供的免费开源 License：

📱 微信公众号

JAVA架构日记，精彩内容每日推荐！