开源跨平台的.NET Core,还没上车的赶紧的,来不及解释了……
本系列文章,主要分享一些.NET Core比较优秀的社区资料和微软官方资料。我进行了知识点归类,让大家可以更清晰的学习.NET Core。
首先感谢资料原作者的贡献。
介绍.NET历史、开源之路、基础、路由、依赖注入DI、HttpContext、cookie|session、HttpClient、gRPC、单元测试、发布部署等等。
介绍.NET工程化、AOP、异常处理、缓存、日志、响应优化、上传下载、健康检查、后台任务、认证和授权、安全性(Https、CORS、CSRF)、EF Core 等等
第三篇:.NET Core 学习资料精选:高级&微服务架构
介绍性能、原理、微服务架构、Docker、DDD等知识
这是第一篇,知识点如图:
.NET 简介
#、.NET 开源之路
2014.11月 .NET Core 项目启动,2016.06月 .NET Core 1.0 发布
.NET Core 3.0 新特性:支持 Windows 桌面应用(windows only)
【翻译】.NET Core3.1发布(及各版本支持时长)
.NET Core Roadmap
[翻译] .NET 官宣跨平台 UI 框架 MAUI (.NET 6)
#、.NET Core提供的特性
1.免费和最宽松的开源协议
.NET Core从属于.NET基金会,由微软进行官方支持。使用最宽松的MIT和Apache 2开源协议,文档协议遵循CC-BY。这将允许任何人任何组织和企业任意处置,包括使用,复制,修改,合并,发表,分发,再授权,或者销售。唯一的限制是,软件中必须包含上述版权和许可提示,后者协议将会除了为用户提供版权许可之外,还有专利许可,并且授权是免费,无排他性的(任何个人和企业都能获得授权)并且永久不可撤销,用户使用.NET Core完全不用担心收费问题,你可以很自由的部署在任何地方.
2.轻量级、跨平台
3.组件化、模块化、IOC+Nuget、中间件
4.高性能
5.统一了MVC和WebAPI编程模型
a) 比如:ASP.NET Core 中MVC 和Web API 直接或间接继承同一个基类 ControllerBase,提供可使用的API也一致化
b) 比如:旧ASP.NET时代,写全局filter需要针对MVC 和Web API 分别编写代码,但在ASP.NET Core,直接使用一套中间件代码即可
6.可测试性
7.微服务、容器化支持
8.标准化 .NET API 规范- .NET STANDARD
#、迁移到.NET Core
目前市面上还存在很多传统 .NET 旧项目,我们需要根据公司情况决定是否升级到.NET Core。
如果需要进行旧项目升级的,可以参考文章:《.NET项目迁移到.NET Core操作指南》
VS和.NET Core安装
Vistual Studio
[坑]安装 .Net Core 2.2 SDK后,VS2017依然不能设置core2.2为目标框架
把.net Core 项目迁移到VS2019 for MAC(无需改一行代码)
调试
VS2019自带 反编译 与 Reflector 反编译工具比较
Visual Studio 2017中使用SourceLink调试Nuget包源码(SourceLink方式)
Visual Studio 2017调试开源项目代码(下载源代码文件方式)
VS Code 开发.NET Core
.NET Core SDK
安装 .NET Core Runtime 和.NET Core SDK
Linux/MacOS 安装 .NET Core SDK 命令
.NET Core 卸载工具 (dotnet-core-uninstall)
【微软官方文档】ASP.NET Core *.* 个版本新特性
基础
术语:
.NET Core RID 目录 (参数:-r|--runtime)
.NET Core 目标框架 (参数:-f|--framework)
dotnet publish 发布的文件中包含pdb文件,不论模式是Debug还是Release。可以通过配置:
<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
<DebugType>None</DebugType>
<DebugSymbols>false</DebugSymbols>
……
</PropertyGroup>
--self-contained 自包含参数。将.NET Core运行时及.NET Core类库随应用一起打包,这样可以完全避免老项目在系统.NET Core运行时升级时,带来莫名异常的问题
.NET Core 运行程序注意事项(dotnet dll 与 dotnet run)
core api 支持情况
ASP.NET Core 端口配置
Asp.Net Core WebAPI 端口修改(host.json)
ASP.NET Core 中使用多个环境(开发、预发布、生产)- 默认为 Production
ASP.NET Core 返回类型ActionResult|ActionResult<T>|Dto
ASP.NET Core 动作结果(ActionResult)
ASP.NET Core 中控制器操作的多路径返回类型(IActionResult)
.NET Core 3.0 新的 System.Text.Json API
配置
ASP.NET Core 中的配置(json、xml、命令行、环境变量、内存变量等)
ASP.NET Core 中IOptions、IOptionsMonitor以及IOptionsSnapshot
.Net Core 自定义配置源从远程API读取配置(ConfigurationProvider)
路由、模型绑定
ASP.NET Core WebAPI中,Controller标注 [ApiController] 特性,其路由只能使用[route]特性方式
ASP.NET Core MVC 构建可读性更高的ASP.NET Core 路由
ASP.NET Core 3.x 为什么采用新的 Endpoint Routing 路由系统
ASP.NET Core 中的自定义模型绑定(IModelBinder)
ASP.NET Core API默认支持的InputFormatters:application/json-patch+json、application/json、text/json、application/*+json
ASP.NET Core API默认支持的OutputFormatters:text/plain、application/json、text/json、application/*+json
ASP.NET Core Web API 入参解析InputFormatter
ASP.NET Core Web API 对输入流stream的支持
ASP.Net Core Web Api中异步视频流的IOutputFormatter
控制反转、依赖注入
什么是控制反转,和依赖注入:
依赖倒置原则(Dependence inversion principle,DIP):软件设计原则,要依赖于抽象,不要依赖具体实现。
控制反转(Inversion of Control,IoC):IOC是一种实现DIP原则的模式。平常我们需要一个类对象的时候需要new出来,而现在我们把new一个类对象的工作交给了IOC容器,当我们需要一个类对象的时候直接向IOC容器要,就可以了,这个就是控制反转。(控制权交个了IOC容器)
依赖注入(Dependency Injection,DI):DI是实现IOC的一种方式。当我需要一个类对象,IOC容器给我们这个类对象的过程其实就是依赖注入,依赖注入有构造函数注入和属性注入。
官方推荐通过构造函数。这也是所谓的显式依赖。Asp.Net Core 的标准依赖注入容器不支持属性注入。(可以使用autofac或者其他来实现属性注入)
可以参考 OSharp 框架,设计三个全局注入接口,来实现自动化注入:ISingletonDependency 和 ITransientDependency 、 IScopedDependency ( 单例、瞬时、范围)。
案例1:使用nlog时,想根据需要使用不同的配置文件Nlog.config 写日志时,就可以使用文章中介绍的 Factory 命名注入方案来实现
案例2:使用分布式缓存 IDistributedCache 时,想根据需要在一个项目中同时使用redis和sqlserver
ASP.NET Core 中多个接口对应同一个实现的正确姿势
[OSharp]使用 IServiceProvider.GetService<T>() 实现按需注入,优化性能
在WPF中使用.NET Core 3.0依赖项注入和服务提供程序
#、ASP.NET Core 结合 Autofac 的使用
Asp.Net Core 2.0 之旅---AutoFacIOC容器的使用教程(批量注入)
Asp.Net Core 2.0 之旅---AutoFac仓储泛型的依赖注入(泛型注入)
Asp.Net Core 2.0 之旅---数据访问仓储模式的事务管理(uow+rp)
ASP.NET Core 技巧之伪属性注入(属性注入会造成类型的依赖关系隐藏,测试不友好等)
ASP.NET Core 中使用Autofac实现属性注入的代码片段
public IServiceProvider ConfigureServices(IServiceCollection services) { // 第一步:替换系统默认Controller创建器(否则Controller下面无法使用属性注入) // 在 services.AddMvc() 之前 services.Replace(ServiceDescriptor.Transient<IControllerActivator, ServiceBasedControllerActivator>()); services.AddMvc(); var builder = new ContainerBuilder(); // 第二步:找到所有Controller的类型 // 通过Autofac对Controller类型进行属性注册 PropertiesAutowired() var assembly = this.GetType().GetTypeInfo().Assembly; var manager = new ApplicationPartManager(); manager.ApplicationParts.Add(new AssemblyPart(assembly)); manager.FeatureProviders.Add(new ControllerFeatureProvider()); var feature = new ControllerFeature(); manager.PopulateFeature(feature); builder.RegisterTypes(feature.Controllers.Select(ti => ti.AsType()).ToArray()).PropertiesAutowired(); // 第三步:配置 ContainerBuilder,返回 IServiceProvider builder.Populate(services); return new AutofacServiceProvider(builder.Build()); }
#、构造函数注入&属性注入
描述来源于Abp.io中文文档:查看详情
构造方法注入
是将依赖项注入类的首选方式.这样,除非提供了所有构造方法注入的依赖项,否则无法构造类.因此,该类明确的声明了它必需的服务.
属性注入
public class MyService : ITransientDependency
{
public ILogger<MyService> Logger { get; set; }
public MyService()
{
Logger = NullLogger<MyService>.Instance;
}
}
对于属性注入依赖项,使用公开的setter声明公共属性.这允许DI框架在创建类之后设置它.
属性注入依赖项通常被视为可选依赖项.这意味着没有它们,服务也可以正常工作.Logger就是这样的依赖项,MyService可以继续工作而无需日志记录.
为了使依赖项成为可选的,我们通常会为依赖项设置默认/后备(fallback)值.在此示例中,NullLogger用作后备.因此,如果DI框架或你在创建MyService后未设置Logger属性,则MyService依然可以工作但不写日志.
属性注入的一个限制是你不能在构造函数中使用依赖项,因为它是在对象构造之后设置的.
当你想要设计一个默认注入了一些公共服务的基类时,属性注入也很有用.如果你打算使用构造方法注入,那么所有派生类也应该将依赖的服务注入到它们自己的构造方法中,这使得开发更加困难.但是,对于非可选服务使用属性注入要非常小心,因为它使得类的要求难以清楚地看到.
ASP.NET Core WebAPI
创建ASP.NET Core Web API (ControllerBase、参数绑定源)
版本控制
ASP.Net Core WebAPI 几种版本控制对比(nuget:Microsoft.AspNetCore.Mvc.Versioning)
ASP.NET Core 构建带有版本控制的 API 接口(结合SwaggerUI)
WebApi管理和性能测试工具WebApiBenchmarks
ASP.NET Core AutoWrapper 自定义响应输出
ASP.NET Core:MVC 与 Razor Pages
ASP.NET Core MVC 静态文件目录配置与访问授权
ASP.NET Core 中的特殊视图文件(_Layout.cshtml、_ViewStart.cshtml、_ViewImports.cshtml)
新的 Razor 机制
ASP.NET Core 中的 Razor 页面介绍(OnGet、OnPost、单页多Handler方式)
ASP.NET Core 中 Razor 页面的IPageFilter
ASP.NET Core 中 Razor 页面的路由和应用约定
ASP.NET Core Razor 配置:预编译,动态编译,混合编译
WebForm & MVC & Razor Pages
[译]ASP.Net Core 2.0中的Razor Page不是WebForm
ASP.NET Core Razor页面简化了 ASP.NET MVC 应用程序
HttpContext
ASP.NET Core 中访问 HttpContext 的方法
ASP.NET Core 中通过IHttpContextAccessor实现公用静态HttpContext
状态管理
常见方式:Cookie、Session、TempData、查询字符串、HttpContext.Items、缓存、依赖关系注入
Cookie 的 SameSite 属性(注意http>>https重定向跨域导致的cookie丢失问题)
#、session
ASP.NET Core 在通用数据保护条例规则下使用 session
#、cookie
ASP.NET Core SameSite 设置引起 Cookie 在 QQ 浏览器中不起作用
[github]ASP.NET Core CookieManager
通信
#、HttpClient
传统.NET HttpClient坑
ASP.NET Core HttpClient的各种用法、生命周期管理
DotNetCore 使用Http请求及基于 Polly 的处理故障
DotNetCore 中 HttpClientFactory 类源码分析
#、RPC
Grpc
.NET Core 中的 gRPC 客户端工厂集成(依赖注入)
两个gRPC的C#库:grpc-dotnet vs Grpc.Core
Grpc调试:AspNetCore.Grpc.Swagger 由微软提供(.NET5.0版本)--(github issue)
支持使用Restful API方式调用Grpc方法:GrpcJsonTranscoder
[github]基于gRPC的实时网络引擎:MagicOnion
DotNetty
[github]Azure开源的网络通信框架DotNetty
#、SignalR
[如鹏网九节公开课].NET Core 中使用SignalR实现聊天服务器
发布部署
.Net Core 跨平台:一个简单程序的多平台(windows、Linux、osx)发布
在Linux上使用 pm2 守护你的 .NET Core 应用程序--(pm2 github starts 31.1k)
在Linux上使用Nginx + supervisor部署ASP.NET Core程序--(supervisor github starts 5.8k)
配置 ASP.NET Core 以使用代理服务器和负载均衡器
使用 Nginx 在 Linux 上托管 ASP.NET Core
使用 Apache 在 Linux 上托管 ASP.NET Core
单元测试
.NET Core 和 .NET Standard 单元测试最佳做法
使用 dotnet test 和 xUnit 在 .NET Core 中进行 C# 单元测试
使用 dotnet test 和 NUnit 在 .NET Core 中进行 C# 单元测试
使用 dotnet test 和 MSTest 在 .NET Core 中进行 C# 单元测试
使用 dotnet test --filter 进行选择性单元测试
视频教程
ASP.NET Core MVC 2.x 全面教程 -- solenovex
ASP.NET Core 3.0 入门视频 -- solenovex
一些坑
dotnet core windows和linux的时区处理 (开源库:nodatime)
其他资料推荐
==============================================================================
over,谢谢查阅,觉得文章对你有收获,请多帮推荐。欢迎向我提供更好的资料信息。