Minimal hosting for ASP.NET

04/29/2021 03:00:53 | China Standard Time

在今年即将发布的 .NET 6 中，引入了一种全新的、创建 Web 应用程序的方法 "Minimal hosting"。这是一种快速创建 Web 应用程序的方法，可以极大程度的简化创建一个 ASP.NET 应用程序所需的步骤。这篇文章将会介绍一下 Minimal hosting for ASP.NET 的具体细节。

## Minimal hosting 是什么？

[Minimal hosting](https://github.com/dotnet/aspnetcore/issues/30354 "Minimal hosting") 是 ASP.NET 的一种全新的、创建 Web 应用程序的方法，是一种低仪式，快速创建 Web 应用程序的方法。可以极大程度的降低创建一个 Web 应用程序的成本，简化创建 ASP.NET 应用程序所需的步骤。

这是一个全新的 API，并没有改变任何现有的 Host，因此不会对现有的应用程序产生任何影响。

![](https://corehome.oss-accelerate.aliyuncs.com/blogs/2098dd9c-ff13-40f8-9d01-8a710fcd47cf.jpg)

看起来有些类似 Feather HTTP ，Feather HTTP 是一个基于 ASP.NET 的轻量级，低仪式的 API，可以用来快速的创建 Web 应用程序。

```csharp
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;

var app = WebApplication.Create(args);

app.MapGet("/", async http =>
{
	await http.Response.WriteAsync("Hello World");
});

await app.RunAsync();
```

仓库地址如下

[![ReadMe Card](https://github-readme-stats.vercel.app/api/pin/?username=featherhttp&repo=framework)](https://github.com/featherhttp/framework)

Minimal hosting 的目标正是简化创建 ASP.NET 应用程序所需的步骤。

## 使用 Minimal hosting

- 相似的体验
	- Minimal hosting 依旧建立在 ASP.NET Core 之上。
	- 你可以利用现有的 middleware 和 frameworks。
	- 你可以在 IServiceCollection、IHostBuilder、IWebHostBuilder 上使用现有的扩展方法。

- 变化的内容
	- Minimal hosting 需要更改 DI 注册模式。
	- 可测试性

## Minimal hosting 案例

#### Hello World

```csharp
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;

var app = WebApplication.Create(args);

app.MapGet("/", async http =>
{
	await http.Response.WriteAsync("Hello World");
});

await app.RunAsync();
```

#### Hello MVC

```csharp
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();

var app = builder.Build();
app.MapControllers();
await app.RunAsync();

public class HomeController : ControllerBase
{
	[HttpGet("/")]
	public string HelloWorld() => "Hello World";
}
```

#### 与第三方 ASP.NET Core 框架集成（Carter）

```csharp
using Carter;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddCarter();

var app = builder.Build();
app.Listen("http://localhost:3000");
app.MapCarter();
await app.RunAsync();

public class HomeModule : CarterModule
{
	public HomeModule()
	{
		Get("/", async (req, res) => await res.WriteAsync("Hello from Carter!"));
	}
}
```

#### 利用现有生态系统的扩展方法

```csharp
using System.Threading.Tasks;
using Autofac;
using Autofac.Extensions.DependencyInjection;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using Serilog;

var builder = WebApplication.CreateBuilder(args);

builder.Configuration.AddYamlFile("appsettings.yml", optional: true);

builder.Host.UseSerilog((context, configuration)
	=> configuration
		.Enrich
		.FromLogContext()
		.WriteTo
		.Console()
	);

builder.Host.UseServiceProviderFactory(new AutofacServiceProviderFactory());

builder.Host.ConfigureContainer<ContainerBuilder>(b =>
{
	// Register services using Autofac specific methods here
});

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
	app.UseDeveloperExceptionPage();
}

app.UseRouting();

app.MapGet("/", async http =>
{
	await http.Response.WriteAsync("Hello World");
});

await app.RunAsync("http://localhost:3000");
```

TOP