ASP.NET Core 3.0 入门

课程简介

与2.x相比发生的一些变化，项目结构、Blazor、SignalR、gRPC等
视频预计结构
- ASP.NET Core 3.0项目架构简介
- ASP.NET Core MVC 简介
- Blazor
- SignalR
- Web API
- gRPC
- 发布

一. 创建项目

dotnet core 本质上是控制台应用

DI 依赖注入（Dependency Injection）

IoC 容器（Inversion of Control）控制反转
- 注册（服务）
- 请求实例
- 实例的生命周期
生命周期
- Transient（每次被请求都会生成一个新的实例，最短）
- Scoped（一次 Web 请求产生一次实例，较长）
- Singleton（从应用程序启动到停止，只创建一次，最长）

1. ConfigureServices

services.AddControllersWithViews();
services.AddControllers();
// 别的类每次请求 IClock 这个接口时，都会返回一个 ChinaClock 类的实例
// services.AddSingleton<IClock, ChinaClock>();
services.AddSingleton<IClock, UtcClock>();

当需要更改接口的实现类的时候，只需要在依赖注入中修改即可。

public class HomeController: Controller
{   // 不需要更改
    public HomeController(IClock clock)
    {
    
    }
}

1.1 DI 的优点

解耦，没有强依赖。
- 利于单元测试
不需要了解具体的服务类
也不需要管理服务类的生命周期

2. Configure

针对 HTTP 请求，建立管道

2.1 ASP.NET Core 管道（pipeline）

放在管道中处理请求的东西（请求的数据，或者一些Web Server的东西），叫做中间件
Auth 身份认证，MVC 框架，Static Files 静态文件（HTML，JS，CSS）

2.2 中间件注册（顺序非常重要）

// 在开发环境中，一些没有被处理或者捕获的异常就会传到这里，展示成一个页面
if (env.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}

// 不使用这个中间件就无法访问静态文件（HTML，JS，CSS）
// 它可以放在 UesRouting 前，因为不需要知道路由信息
app.UseStaticFiles();

// 将 HTTP 请求转换为 HTTPS 请求，强制用户使用 TLS 协议（SLL）
app.UseHttpsRedirection();

// 身份认证，必须放在 UseEndpoints 前面，因为在使用 MVC 等之前就应该完成身份认证
app.UseAuthtication();

// 路由中间件，检查在应用中已经被注册的端点，这些端点有可能是被 MVC 注册的， 也有可能是RazorPages 注册的。
// 会判断这个 HTTP 请求是在哪个端点上出现的，并把这些信息传达给后面需要用到这些信息的中间件。
app.UseRouting();

// 端点中间件，对端点进行注册
app.UseEndpoints(endpoints = >
{
    endpoints.MapGet(pattern:"/", requestDelegate:async context =>
    {
        await context.Response.WriteAsync(text: "Hello World!");
    });
    // MVC
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
    
    // Attribute：类似在Controller上加上[Route("api/[Controller]")]
    // 注意, services.AddControllers(); 和 endpoints.MapControllers(); 方法成对出现,。
    endpoints.MapControllers();
});

2.3 端点 endpoint

端点就是进来的 HTTP 请求的 URL 的结尾那部分，这部分会被中间件进行处理。
/{controller} /{action}
/home /index

为什么要将 ”路由“ 从 MVC 中分离出来，配合其他中间件使用呢？

2.4 ASP.NET Core 应用的多样性

MVC：/Home /Index
Razor Pages：/SomePage
SignalR：/Hub /Chat

3. 自带的 Kestrel 服务器

Visual Studio 会配置IIS服务器，但 ASP.NET Core 应用程式本身也会带有一个小型的服务器 Kestrel

3.1 launchSettings.json

iisSettings， IISExpress 服务器的设置，如果删除后面 profiles 中的 IISExpress 的话，可以把这里的iisSettings也进行删除
profiles 配置，在这里可以配置多个服务器
- 默认有 IISExpress 服务器和 Kestrel 服务器

4. 自定义 ConfigureDevelopment 方法

// 自定义 ConfigureDevelopment 方法
public void ConfigureDevelopment(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ...
}

// 如果找不到自定义的 Configure 方法，就会执行默认的
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 通过 IWebHostEnvironment 进行注入
    // 可以是 IsDevelopment()，也可以是 IsProduction()，还可以自定义 IsEnvironment("OK")
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
}

// ConfigureServices()方法也可以自定义配置，还可以对Starup 类进行自定义（例如StartupDevelopment）

5. 静态文件

手动创建 wwwroot 文件夹（css，js，image）
使用 app.UseStaticFiles() 中间件就可以让 wwwroot 里的静态文件变的可访问（例如：localhost:5000/images/logo.png）

二. 包管理

服务器端（后端）：Nuget
前端：Npm
- 添加 npm Configuration File （package.json）
libman.json（右键--管理客户端）

1. 合并 CSS 文件，并对其进行压缩

建立 bundleconfig.json 文件

[
    // 合并
    {
        "outputFileName":"wwwroot/css/all.min.css",
        "innputFiles":[
            "wwwroot/lib/bootstrap/dist/css/bootstrap.css",
            "wwwroot/css/site.css"
        ]
    },
    
    // 移动 + 压缩
    {
        "outputFileName":"wwwroot/css/bootstrap.css",
        "innputFiles":[
            "wwwroot/lib/bootstrap/dist/css/bootstrap.css"
        ],
        "minify":{
            "enabled":true
        }
    }
]

通过 Nuget 安装 BuildBundlerMinifier ，然后生成

三. 使用 MVC 相关技术

Controller
Tag Helper
Settings
View Component
Razor Page

1. Tag Helper

添加 Razor View Imports
全局添加 Tag Helper

@addTagHelper "*, Microsoft.AspNetCore.Mvc.TagHelpers"

Tag Helper 设定环境

<environmet include="Development">
    <link rel="stylesheet" asp-href-include="css/*" asp-href-exclude="css/all.min.css" />
</environmet>

<environmet exinclude="Development">
    <link rel="stylesheet" asp-href-include="all.min.css" />
</environmet>

<!-- 防止图片被缓存 -->
<img asp-append-version="true" alt="Logo" src="images/logo.png" />

四. ASP.NET Core 的配置信息

Key-Value 键值对
内存里、JSON、XML、INI等文件，或者系统环境变量
配置信息与配置系统是解耦的
可以依赖注入

1. ASP.NET Core 的配置信息源（顺序查找，相同时后面覆盖前面）

appsettings.json
- appsettings.{Environment}.json
Secret Manager
环境变量
命令行参数

appsettings.json

{
    "Three":{
        "Threshold":30
    }
}

Startup：

private readonly IConfiguration _configuration;

public Startup(IConfiguration configuration)
{
    _configuration = configuration;
    // var three = _configuration["Three:Threshold"];
}

public void ConfigureServices(IServiceCollection services)
{
    services.Configure<ThreeOptions>(_configuration.GetSection("Three"));
    // ...
}

Controller：

private readonly IOptions<ThreeOptions> _threeOptions;

public HomeController(IOptions<ThreeOptions> threeOptions)
{
    _threeOptions = threeOptions;
}

Razor：

@inject IOptions<ThreeOptions> options

清除默认源

Program：

Host.ConfigureAppConfiguration((context, configBuilder) =>
                               {
                                   configBuilder.Sources.Clear();
                                   configBulider.AddJsonFile("nick.json");
                               })

五. View Component

为什么Partial View 不行？因为没法添加业务逻辑
如果在 Controller 里面写呢？那就无法到处复用
ChildAction呢？开销太大，它需要走完整个Controller的生命周期

1. View Component

就像Partial View ，但是还带有一个迷你的Controller，在这里也可以写业务逻辑
可以使用Razor语法来渲染View Component

ViewComponent / CompanySummaryViewComponent.cs ：

public class CompanySummaryViewComponent: ViewComponent
{
    public async Task<IViewComponentResult> InvokeAsync()
    {
        // ...
        return View();
    }
}

六. Razor Page

所有的 MVC 都放在 Pages 目录下的页面中

七. SignalR

实时的 Web 应用（Server 主动发送到 Client）

1. SignalR "底层"技术

SignalR 使用了三种“底层”技术来实现实时Web，它们分别是Long Polling，

Server Sent Events 和 WebSocket

1.1 Polling

Polling是实现实时Web的一种笨方法，它就是通过定期的向服务器发送请求，来查看服务器的数据是否有变化
如果服务器的数据没有变化，那么就返回204 No Content；如果有变化就把最新的数据发送给客户端
这就是Polling，很简单，但是比较浪费资源
SignalR没有采用Polling这种技术

1.2 Long Polling

Long Polling和Polling有类似的地方，客户端都是发送请求到服务器。但是不同之处是：如果服务器没有新数据要发送给客户端的话，那么服务器会继续保持连接，直到有新的数据产生，服务器才把新的数据返回给客户端
如果请求发出后一段时间内没有响应，那么请求就会超时。这时，客户端会再次发出请求

1.3 Server Sent Event（SSE）

使用SSE的话，Web服务器可以在任何时间把数据发送到浏览器，可以称之为推送，而浏览器则会监听进来的信息，这些信息就像流数据一样，这个连接也会一直保持开放，直到服务器主动关闭它
浏览器会使用一个叫做 EventSource 的对象用来处理传过来的信息
单项的，有连接次数限制，并且只支持文本类型

1.4 Web Socket

Web Socket 是不同于 HTTP 的另一个 TCP 协议，它使得浏览器和服务器之间的交互式通信变得可能。使用 WebSocket，消息可以从服务器发往客户端，也可以用客户端发往服务器，并且没有 HTTP 那样的延迟。信息流没有完成的时候，TCP Socket 通常是保持打开的状态
使用线代浏览器时，SignalR 大部分情况下都会使用Web Socket，这也是最有效的传输方式
全双工通信：客户端和服务器可以同时往对方发送信息
并且不受 SSE 的那个浏览器连接数限制（6个），大部分浏览器对 Web Socket 连接数的限制是50个
消息类型：可以是文本和二进制，Web Socket 也支持流媒体（音频和视频）
其实正常的 HTTP 请求也使用了 TCP Socket。Web Socket 标准使用了握手机制把用于 HTTP 的 Socket 升级为使用 WS 协议的 Web Socket socket

1.5 Web Socket 生命周期

所有的一切都发生在 TCP Soket 里面

TCP Socket

|__________________________________|

| HTTP握手通信/数据交换关闭 |