NETPPRO一组独立中间件的类库 NetPro.rar

<p align="center"> <img src="docs/images/netpro2.png"> </p> # NetPro [Pages](https://leonkou.github.io/NetPro/)  ### 🕰️ 活跃分支 * 👉[*dev_6.0* branch](https://github.com/LeonKou/NetPro/tree/dev_3.1) ## 简要 .NetpPro是一组独立中间件的类库统称，具有轻量级，依赖小，易用使用且高效。 在以往的开发中我们常常封装内置一堆组件作为框架进行使用，项目是否使用这些组件功能都将统统加载，组件无法插拔，往往都是集成度和依赖较高，导致新的学习成本，对于长期维护埋下了很大隐患；而不做封装又要面对杂乱的注入顺序和繁琐重复的的初始化逻辑，有没有办法既可以按需引用又可以避免这些初始化逻辑并且都能以各组件原生的方式调用， NetPro就是为解决以上问题而创建。 所有组件在[/src/Library](https://github.com/LeonKou/NetPro/tree/dev_6.0/src/Library)路径下，每个组件已有详尽的使用说明文档README.md 组件可在任意项目中使用，不强依赖NetPro环境，支持按需引用，引用即自动初始化，免去各类中间件繁琐初始化操作，支持`net3.1` `net6.0`。NetPro项目在基于核心包`NetPro.Startup`基础上提供了其他周边常用中间件，其核心封装逻辑也是尽可能的暴露原生方法，不对开发人员产生过多不必要的学习成本。 基于`NetPro.Startup`的有两个关键插件包： - `NetPro.Web.Api` 用于开发webapi项目 - `NetPro.Grpc` 用于开发grpc项目 其他的所有[NetPro](https://github.com/LeonKou/NetPro/tree/dev_6.0/src/Library)中间件都是可插拔，按需引用，每个组件都相对轻量，没有强关联NetPro，即使非.NetPro框架也可使用。如果基于`NetPro.Web.Api`或 `NetPro.Grpc`引用的NetPro中间件，支持引用即`自动执行`初始化逻辑。 ### 架构图 <p align="center"> <img src="docs/images/netproinfo.png"> </p> #### 提供的中间件包含不限于以下： `FreeSql`,`Autofac` , `Automapper`,`apollo`,`App.Metrics`, `CsRedisCore`,`StackExchange.Redis`,`Serilog`, `MiniProfiler`,`FluentValidation`,`IdGen`, `MongoDb`,`Dapper`,`RedLock.Net`, `Sentry`,`RabbitMQ.Client`,`SkyAPM`, `Swagger`,`WebApiClient.Core`, `TimeZoneConverter`,`healthcheck` `exceptionless` ### 使用 ##### 各组件已发布Nuget包，可单独使用，如需插件化和自动执行初始化请使用`NetPro.Web.Api`或者`NetPro.Grpc` ##### 支持的组件 - [](https://nuget.org/packages/NetPro.Web.Api) [NetPro.Web.Api](https://github.com/LeonKou/NetPro.Web.Api) （NetPro.Web.Api） - [](https://nuget.org/packages/NetPro.MQTTClient) [NetPro.MQTTClient](https://github.com/LeonKou/NetPro.MQTTClient) （物联网MQTTClient客户端） - [](https://nuget.org/packages/NetPro.Globalization) [NetPro.Globalization](https://github.com/LeonKou/NetPro.Globalization) （多语言全球化） - [](https://nuget.org/packages/NetPro.Cors) [NetPro.Cors](https://github.com/LeonKou/NetPro.Cors) （NetPro.Cors 跨域配置） - [](https://nuget.org/packages/NetPro.ConsulClient) [NetPro.ConsulClient](https://github.com/LeonKou/NetPro.ConsulClient) （NetPro.ConsulClient 服务注册发现组件，只需引用即可无需额外操作） - [](https://nuget.org/packages/NetPro.TypeFinder) [NetPro.TypeFinder](https://github.com/LeonKou/NetPro.TypeFinder) （dll检索，反射） - [](https://nuget.org/packages/NetPro.Utility) [NetPro.Utility](https://github.com/LeonKou/NetPro.Utility) （包含常用帮助类） - [](https://nuget.org/packages/NetPro.Authentication) [NetPro.Authentication](https://github.com/LeonKou/NetPro.Authentication) （认证相关） - [](https://nuget.org/packages/NetPro.EasyNetQ) [NetPro.EasyNetQ](https://github.com/LeonKou/NetPro.EasyNetQ) （EasyNetQ，支持多server） - [](https://nuget.org/packages/NetPro.Checker) [NetPro.Checker](https://github.com/LeonKou/NetPro.Checker) （组件健康检查） - [](https://nuget.org/packages/NetPro.MongoDb ) [NetPro.MongoDb ](https://github.com/LeonKou/NetPro.MongoDb ) （mongodbi） - [](https://nuget.org/packages/NetPro.CsRedis) [NetPro.CsRedis](https://github.com/LeonKou/NetPro.CsRedis) （redis推荐使用此组件；CsRedis分布式锁） - [](https://nuget.org/packages/NetPro.RedisManager ) [NetPro.RedisManager ](https://github.com/LeonKou/NetPro.RedisManager ) （Redis组件，包含CsRedis，StackExchangeRedis，分布式锁） - [](https://nuget.org/packages/NetPro.Swagger ) [NetPro.Swagger ](https://github.com/LeonKou/NetPro.Swagger ) （Swagger，包含认证，文件上传，公共参，个性主题） - [](https://nuget.org/packages/NetPro.Sign ) [NetPro.Sign ](https://github.com/LeonKou/NetPro.Sign ) （签名） - [](https://nuget.org/packages/NetPro.ResponseCache ) [NetPro.ResponseCache ](https://github.com/LeonKou/NetPro.ResponseCache ) （响应缓存） - [](https://nuget.org/packages/NetPro.Analysic) [NetPro.Analysic](https://github.com/LeonKou/NetPro.Analysic)(请求分析控制，可精细配置同ip一定时间的错误数和正确数，超过阈值拦截熔断访问) --- 具体参考 NetPro\src\Template\API\Content（插模块插件)项目 webapi项目引用 `NetPro.Web.Api` [](https://nuget.org/packages/NetPro.Web.Api) 引用最新nuget即可 Package Manager方式: `Install-Package NetPro.Web.Api -Version 3.1.2` .NET CLI 方式: `dotnet add package NetPro.Web.Api --version 3.1.2` PackageReference:`<PackageReference Include="NetPro.Web.Api" Version="3.1.2" />` .NET CLI 方式: `paket add NetPro.Web.Api --version 3.1.2` --- ## 通过脚手架创建项目(推荐) ### 1、安装netproapi[](https://nuget.org/packages/netproapi)脚手架 执行以下命令安装脚手架 ``` dotnet new -i netproapi::* ``` ### 2、使用脚手架创建项目 在指定的项目文件夹中执行以下命令 ``` dotnet new netproapi -n 项目名称 ``` 例如当前项目为IAM ``` dotnet new netproapi -n IAM ``` 执行以上命令将自动创建WebApi代码解决方案 ## 手动创建项目 * 修改`Program.cs` ```csharp Environment.SetEnvironmentVariable("ASPNETCORE_HOSTINGSTARTUPASSEMBLIES", "NetPro.Startup"); var host = Host.CreateDefaultBuilder(args) .ConfigureAppConfiguration((hostingContext, config) => { ApolloClientHelper.ApolloConfig(hostingContext, config, args); }); host.Build().Run(); ``` * 增加 `EndpointsStartup.cs`文件配置 可加多个继承了INetProStartup接口的启动类来控制启动顺序和初始化 此文件继承`INetProStartup`接口，提供了microsoft原生依赖注入能力，所有组件注入放于此 ，Startup.cs将不接受组件注入 ```csharp // <aut