新版 Jorenoe 文档

JoreNoe Doc

🎉 JoreNoe Package

📖 线上文档

📦 安装方法

Build

NuGet

Downloads

CreateTime

Laster Commit

NuGet Downloads

Install-Package JoreNoe -Version Laster
install-package Jorenoe -version 7.4.6

📂 文档目录

ORM使用

  • Dapper教程

  • EntityFramework.Core教程

Redis扩展如何使用

发送Email消息扩展如何使用

辅助开发帮助类或者函数如何使用

NetCore中间件使用

RabbitMQ如何使用

ORM使用说明

JoreNoe包目前支持数据库:Mysql , SqlServer

支持,ORM框架 Dapper,EFCore

🏗 1. Dapper 使用指南

📌 第一步:引用依赖

在代码中引入 JoreNoe.DB.Dapper,确保 Dapper 能够正确使用。


🛠 第二步:注册 Dapper 服务

在应用程序启动时,将 Dapper 添加到 依赖注入容器。 在 Startup.cs 文件中的 ConfigureServices 方法中,调用 AddJoreNoeDapper 进行注册:

🔹 最新版本支持 单库 & 多库模式

单库模式

多库模式 版本:v7.5.0之后使用方式

多库模式 多库模式 版本:v7.5.0 之前使用方式


获取数据库链接

🚀 第三步:使用 Dapper 服务

🔹 在业务逻辑中使用 Repository


🔍 获取数据库属性



✅ 总结:

  • 支持单库 & 多库模式

  • 支持依赖注入 & 手动实例化

  • 提供数据库连接 & 批量插入配置

  • 便捷的 Repository 操作,提升开发效率

🚀 Dapper + JoreNoe 让数据操作更简单! 🎯

🏗 2. EntityFramework.Core 使用指南

📌 第一步:项目结构

仓储项目 中创建以下文件:

数据访问层 中创建 DbContext 文件:


🛠 第二步:代码实现

1️⃣ RepositoryModule.cs - 依赖注入模块

2️⃣ IntegratedPlatformSupporRegister.cs - 注册 DbContext

3️⃣ IntegratedPlatformSupporDBContext.cs - 数据库上下文


🔹 第三步:注册 AutoFac 依赖

在项目根目录创建 Autofac.json,调整模块配置:

1️⃣ WebApi 项目 Program.cs 配置

2️⃣ 在 Startup.cs 里注册 AutoFac


🚀 实战使用示例


✅ 总结

  • 支持 AutoFac 依赖注入,模块化管理依赖

  • 统一管理数据库上下文,支持多数据库配置

  • 提供自动查询过滤器,提升数据查询效率

  • 可扩展性强,适用于企业级应用

🚀 EFCore + JoreNoe 让数据访问更简单高效! 🎯

🏗 3.Redis 使用说明

如何使用

1. 注入 JoreNoe Redis 中注册上下文

📌 步骤 1:注入 Redis

🔗 步骤3:手动创建实例并调用

🏗 4.发送消息

📧目前支持:Email

📌1.邮箱发送

如何使用

🏗 5.帮助扩展方法

🚀支持:boolean,字典转SQL,映射,实体转字典,Resolve扩展

🔗1.bool 扩展方法

🔗2.映射(AutoMapper)

🔗3.Resolve扩展

🔗4.网络请求HttpClientAPI

🔗4.1注入方式

🔗4.2 直接使用方式

🔗5.Swagger暗黑主题

🚀6.中间件的使用

🔗1.全局错误日志中间件

🔗2.全局运行日志中间件

🔗3.全局方法控制中间件

📌 中间件说明

该中间件依赖于 Redis,在项目启动时,会将所有 控制器方法 写入 Redis,默认存储格式如下:

  • Key控制器/方法名

  • Value:

    • true:可用状态 ✅(正常访问)

    • false:不可用状态 ❌(请求将直接返回预设内容,如 “拒绝访问”)

⚙️ 配置项

  • LocalCacheDurationInMinutes:本地缓存有效时间,默认 30 分钟,可根据需求自行调整。

  • ReturnMessage:被拒绝后响应的内容,默认为:"Access Denied",可自定义设置,支持HTML

🔗4.全局IP请求控制中间件

📌 中间件说明

该中间件依赖于 Redis,在项目启动时,会将 非法请求的IP 写入 Redis,默认存储格式如下:

  • KeyProjectBlackLists

  • Value:[127.0.0.1]:❌(请求将直接返回预设内容)

  • 默认返回内容存储在Reids中key如下

  • Key:DeniedReturnMessage

⚙️ 配置项

  • maxRequestCount:每spanTime/ 多少次 ,必填

  • spanTime:spanTime内支持请求多少次,同一个IP,必填

  • TimeSpanLocalCache:本地缓存时间,拒绝访问响应内容和黑名单IP存储

  • isEnabledRequestLimit:是否启用计数限制,如启用将在每spantime=1分钟/maxRequestCount=100次,每分钟请求超过一百次后记录次IP拒绝访问,如不启用将不进行限制,可手动添加黑名单到Reids数组中

🚀 7.RabbitMQ使用

🔗1.初始化

📌注意 如果只推送 不接受按照第一步初始化即可,如果需要接受请按一下配置

🔗2.使用 推送 和 接受

📜 版权声明

版权所有 © JoreNoe。保留所有权利。

📞 联系方式

📧 Email: jorenoe@163.com 🌍 官网: JoreNoe 官方网站


JoreNoe 感谢您的支持!🚀

Last updated