EasilyNET

注意: 由于本项目一般会试用和支持最新版本的.NET SDK,所以为了保证你能正常编译,请确保运行之前安装当前最新版本的 SDK

解决 git 不区分大小

git config core.ignorecase false

本项目为 docker-compose 的编排,用于展示项目的效果以及单独为项目启动一些服务.

• 目前包含的服务列表如下:

服务名称	服务描述	端口映射	镜像名称
Garnet	超高性能分布式缓存	3278	ghcr.io/joesdu/garnet:latest
RabbitMQ	消息队列	15672	ghcr.io/joesdu/rabbitmq-dlx:latest
AspireDashboard	可观测性	18888,4317	mcr.microsoft.com/dotnet/nightly/aspire-dashboard:latest

• 使用 docker-compose 启动 MongoDB 副本集集群,使用本项目中的 yml 文件启动 MongoDB 副本集集群

docker compose -f docker-compose.mongo.rs.yml up -d

EasilyNET Packages

• AES,DES,RC4,TripleDES,RSA,SM2,SM3,SM4 加密,验签等算法
• 基于 MongoDB 的分布式锁
• 基于 RabbitMQ 的消息总线实现
• 对 MongoDB 驱动的一些封装,方便使用以及一些常用的默认配置
• 雪花 ID,一些常用的数据类型,枚举,扩展方法等
• 自动模块化注入服务
• MongoDB 添加 DateOnly 和 TimeOnly 的支持
• MongoDB GridFS 用法的简单支持(常用用法)和使用案例.
• 在 WebAPI 中集成一些常见的过滤器和中间件
• 对 Swagger 文档添加分组,隐藏 API 和添加部分数据类型默认值显示的支持,方便前端工程师查阅
• 对 MongoDB 执行命令添加个性化输出.(EasilyNET.Mongo.ConsoleDebug)
• 部分库的使用案例

Core

NuGet Package	Version	Download	Document
EasilyNET.Core			文档
EasilyNET.WebCore			文档
EasilyNET.WebCore.Swagger			文档

Framework

NuGet Package	Version	Download	Document
EasilyNET.AutoDependencyInjection			文档
EasilyNET.RabbitBus.AspNetCore			文档
EasilyNET.Security			文档

Mongo

NuGet Package	Version	Download	Document
EasilyNET.Mongo.AspNetCore			文档
EasilyNET.Mongo.ConsoleDebug			文档
EasilyNET.MongoDistributedLock			文档
EasilyNET.MongoDistributedLock.AspNetCore			文档
EasilyNET.MongoGridFS.AspNetCore			文档
EasilyNET.MongoSerializer.AspNetCore			文档

感谢 JetBrains 对本项目的支持!

如何为本项目做出贡献

• Fork 本项目到你自己的仓库.
• 创建一个属于你自己的分支,名字随便你怎么取.
• 然后提交代码到你自己仓库的分支上.
• 然后到本项目创建一个 PR.
• 等待管理员合并 PR 后即可删除掉你自己的仓库.

Git 贡献提交规范

• 使用 Emoji 参考 | Emoji 中文含义

代号	说明
feat	新功能(feature)
fix	修复 bug,可以是 QA 发现的 BUG,也可以是研发自己发现的 BUG
docs	文档(documentation)
style	格式(不影响代码运行的变动)
refactor	重构(即不是新增功能,也不是修改 bug 的代码变动)
perf	优化相关,比如提升性能、体验
test	增加测试
chore	构建过程或辅助工具的变动
revert	回滚到上一个版本
merge	代码合并
sync	同步主线或分支的 Bug