零点.Net Core 接触
一、Program.cs类与Startup类
1、一切从Main开始,Main方法包含了是整个应用程序的入口
ASP.NET Core应用程序可以配置和启动主机(Host)。
主机负责应用程序启动和生存期管理,配置服务器和请求处理管道。
主机还可以设置日志记录、依赖关系注入和配置。
而host主机又包括Web主机(IWebHostBuilder)和通用主机(IHostBuilder)。
1、可选择性地包括 ConfigureServices 方法以配置应用的服务。
2、必须包括 Configure 方法以创建应用的请求处理管道。
Startup 方法体如下:
public class Startup { // 使用此方法向容器添加服务 public void ConfigureServices(IServiceCollection services) { ... } // 使用此方法配置HTTP请求管道 public void Configure(IApplicationBuilder app) { ... } }
二、进程托管(进程内托管、进程外托管)
1、进程内托管
1、进程外托管
进程内托管还是进程外托管区别:
可以通过获取进程名:
三、Web服务器
1、有2个Web服务器-内部Web服务器和外部Web服务器:
内部服务器是Kestrel,外部服务器可以是IIS、Nginx、Apache
2、什么是Kestrel Web Server?
Kestrel是ASP.NET Core的跨平台Web服务器。
Kestrel中用于托管应用程序的进程是dotnet.exe
四、中间件
什么是中间件?
ASP.NET Core 中 HTTP 管道使用中间件组合处理的方式,是能够处理Http请求或者响应请求。
而中间件(Middleware)是ASP.NET Core中的一个重要特性。
所谓中间件就是嵌入到应用管道中用于处理请求和响应的一段代码。
对于写代码的人而言,一切皆中间件。
业务逻辑/数据访问/等等一切都需要以中间件的方式来呈现。
ASP.NET Core Middleware可以分为两种类型:
1、Conventional Middleware
2、IMiddleware
如何实现自定义中间件:
一、内联中间件(in-line middleware)
public class Startup { public void Configure(IApplicationBuilder app) { app.Use(async (context, next) => { // Do work that doesn't write to the Response. await next.Invoke(); // Do logging or other work that doesn't write to the Response. }); } }
IApplicationBuilder 定义用于配置应用请求管道的类
IApplicationBuilder
的扩展方法:Run
、Map
、MapWhen
及
Use(this IApplicationBuilder app, Func<HttpContext, Func<Task>, Task> middleware)
,
最终都会调用IApplicationBuilder
接口中的
Use(Func<RequestDelegate, RequestDelegate> middleware)
方法来实现向请求处理管道中注入中间件,后面会对源码做分析。
演示:
1、通常新建一个空的 ASP.NET Core Web Application
在启动类里可以看到这么一句:
// Startup.cs // ... app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); }); // ...
这就是一个匿名函数实现的中间件,虽然内容比较少。
可以看到通过匿名函数实现的中间件是内嵌在启动类文件中的,因此通常也叫做内联中间件。
具体案例:
修改启动类代码如下:
// Startup.cs using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; using System; namespace CoreTest { public class Startup { public void ConfigureServices(IServiceCollection services) { } public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } // 使用匿名函数实现一个内联中间件 app.Use(async (context, next) => { throw new NotImplementedException("一个使用匿名函数,但未实现具体内容的内联中间件"); }); app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); }); } } }
这里我们在 app.Run
之前使用 app.Use
添加一个匿名函数实现的内联中间件,按照中间件的注册顺序,
当发起请求时,会抛出一个异常 NotImplementedException("一个使用匿名函数,但未实现具体内容的内联中间件")。
F5 启动下,看看页面:
再来调整下启动类,代码如下:
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; namespace CoreTest { public class Startup { public void ConfigureServices(IServiceCollection services) { } public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } // 使用匿名函数实现一个内联中间件 app.Use(async (context, next) => { // 这里不对 request 做任何处理,直接调用下一个中间件 await next.Invoke(); }); app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); }); } } }
这里我们在 app.Run
之前使用 app.Use
添加一个匿名函数实现的内联中间件,该中间件没有对 request 做任何处理,
只是一个空的空间件,按照中间件的注册顺序,当发起请求时,页面应该显示 Hello World!
.
匿名函数不是很直观,但是用内联的方式可以快速开始一些开发,不用新建一个中间件类,不用专门想个不一样的名字,小场景下是非常方便实用的。
2、实现接口(自定义中间件类)
通过实现接口 IMiddleware
编写自定义中间件,这是一种强类型的方式,我们需要必须强制按照接口的定义来实现.
接口 IMiddleware 定义如下:
using System.Threading.Tasks; namespace Microsoft.AspNetCore.Http { public interface IMiddleware { Task InvokeAsync(HttpContext context, RequestDelegate next); } }
可以看到接口 IMiddleware 的命名空间是 Microsoft.AspNetCore.Http
,需要实现的方法是InvokeAsync()
// 新建类 MyMiddleware.cs using Microsoft.AspNetCore.Http; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; namespace CoreTest { public class MyMiddleware : IMiddleware { public Task InvokeAsync(HttpContext context, RequestDelegate next) { throw new NotImplementedException(); } } }
按照上面实现的中间件 MyMiddleware
,在执行时应该会抛出 NotImplementedException
.
使用接口实现的中间件需要在先在服务容器中注册否则
具体代码注册代码:
// Startup.cs using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; namespace WebApplication1 { public class Startup { public void ConfigureServices(IServiceCollection services) { // 在服务容器中注册自定义中间件 services.AddSingleton<MyMiddleware>(); } public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } // 使用 UseMiddleware() 把自定义中间件添加到管道中 app.UseMiddleware<MyMiddleware>(); app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); }); } } }
然后 F5 启动,页面上可以看到如下结果:
抛出了一个 NotImplementedException
.
改造下 MyMiddleware
中间件
using Microsoft.AspNetCore.Http; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; namespace CoreTest { public class MyMiddleware: IMiddleware { public async Task InvokeAsync(HttpContext context, RequestDelegate next) { // 这里不对 request 做任何处理,直接调用下一个中间件 await next(context); } } }
这里相当于我们实现了一个叫做 MyMiddleware
的中间件,但是并没有对请求进行任何处理,页面上应该正常显示 Hello World!
字符串.
F5 启动看看
3、约定方式(自定义中间件类)
编程世界有这么一句话,叫"约定大于配置".
那么编写中间件的约定是什么呢?
新建一个类,类名叫做 MyMiddleware
好了,代码如下:
using Microsoft.AspNetCore.Http; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; namespace CoreTest { public class MyMiddleware { // 1. 需要实现一个构造函数,参数为 RequestDelegate public MyMiddleware(RequestDelegate next) { } // 2. 需要实现一个叫做 InvokeAsync 方法 public async Task InvokeAsync(HttpContext context) { throw new NotImplementedException("这是一个按照约定方式编写的中间件,但未实现具体内容"); } } }
约定的内容,就是满足2个需要...不满足需要则异常.
然后我们把这个中间件,注册到管道中,以便使用
// Startup.cs using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; namespace CoreTest { public class Startup { public void ConfigureServices(IServiceCollection services) { } public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } // 注册自定义中间件 // 注册顺序=1 app.UseMiddleware<MyMiddleware>(); app.Run(async (context) => { await context.Response.WriteAsync("Hello World!"); }); } } }
F5 启动,来看看效果
调整下中间件,让请求能正常响应输出 Hello World!
using Microsoft.AspNetCore.Http; using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; namespace CoreTest { public class MyMiddleware { private readonly RequestDelegate _next; // 需要实现一个构造函数,参数为 RequestDelegate public MyMiddleware(RequestDelegate next) { _next = next; } // 需要实现一个叫做 InvokeAsync 方法 public async Task InvokeAsync(HttpContext context) { // 不处理任何 request, 直接调用下一个中间件 await _next.Invoke(context); } } }
F5 启动,看看效果
五、管道
ASP.NET Core的处理流程是一个管道,而中间件是装配到管道中的用于处理请求和响应的组件
点到为止