如何远程关闭一个ASP.NET Core应用？

在《历数依赖注入的N种玩法》演示系统自动注册服务的实例中，我们会发现输出的列表包含两个特殊的服务，它们的对应的服务接口分别是IApplicationLifetime和IHostingEnvironment，我们将分别实现这两个接口的服务统称在ApplicationLifetime和HostingEnvironment。我们从其命名即可以看出ApplicationLifetime与应用的声明周期有关，而HostingEnvironment则用来表示当前的执行环境，本篇文章我们着重来了解ApplicationLifetime与整个AASP.NET Core应用的生命周期有何关系。[本文已经同步到《ASP.NET Core框架揭秘》之中]

目录
一、ApplicationLifetime
二、WebHost的Run方法
三、远程关闭应用

一、ApplicationLifetime

从命名的角度来看，ApplicationLifetime貌似是对当前应用生命周期的描述，而实际上它存在的目的仅仅是在应用启动和关闭时对相关组件发送相应的信号或者通知而已。如下面的代码片段所示，IApplicationLifetime接口具有三个CancellationToken类型的属性（ApplicationStarted、ApplicationStopping和ApplicationStopped），如果需要在应用自动和终止前后执行某种操作，我们可以注册相应的回调在这三个CancellationToken对象上。除了这三个类型为CancellationToken的属性，IApplicationLifetime接口还定义了一个StopApplication方法，我们可以调用这个方法发送关闭应用的信号，并最终真正地关闭应用。

public interface IApplicationLifetime
{
    CancellationToken ApplicationStarted { get; }
    CancellationToken ApplicationStopping { get; }
    CancellationToken ApplicationStopped { get; }

    void StopApplication();
}

ASP.NET Core默认使用的ApplicationLifetime是具有如下定义的一个同名类型。可以看出它实现的三个属性返回的CancellationToken对象是通过三个对应的CancellationTokenSource生成。除了实现IApplicationLifetime接口的StopApplication方法用于发送“正在关闭”通知之外，这个类型还定义了额外两个方法（NotifyStarted和NotifyStopped）用于发送“已经开启/关闭”的通知。

public class ApplicationLifetime : IApplicationLifetime
{
    private readonly CancellationTokenSource _startedSource = new CancellationTokenSource();
    private readonly CancellationTokenSource _stoppedSource = new CancellationTokenSource();
    private readonly CancellationTokenSource _stoppingSource = new CancellationTokenSource();

    public CancellationToken ApplicationStarted
    {
        get { return _startedSource.Token; }
    }
    public CancellationToken ApplicationStopped
    {
        get { return _stoppedSource.Token; }
    }
    public CancellationToken ApplicationStopping
    {
        get { return _stoppingSource.Token; }
    }

    public void NotifyStarted()
    {
        _startedSource.Cancel(false);
    }
    public void NotifyStopped()
    {
        _stoppedSource.Cancel(false);
    }
    public void StopApplication()
    {
        _stoppingSource.Cancel(false);
    }
}

当WebHost因Start方法的执行而被开启的时候，它最终会调用ApplicationLifetime的NotifyStarted方法对外发送应用被成功启动的信号。不知道读者朋友们又被注意到，WebHost仅仅定义了启动应用的Start方法，并不曾定义终止应用的Stop或者Close方法，它仅仅在Dispose方法中调用了ApplicationLifetime的StopApplication方法。

public class WebHost : IWebHost
{
    private ApplicationLifetime _applicationLifetime;
    public IServiceProvider Services { get;}

    public void Start()
    {
       ...
        _applicationLifetime.NotifyStarted();
    }

    public void Dispose()
    {
        _applicationLifetime.StopApplication();
        (this.Services as IDisposable)?.Dispose();
        _applicationLifetime.NotifyStopped();
    }
    ...
}

二、WebHost的Run方法

我们知道启动应用最终是通过调用作为宿主的WebHost的Start方法来完成的，但是我们之前演示的所有实例都不曾显式地调用过这个方法，我们调用的是它的扩展方法Run。毫无疑问，WebHost的Run方法肯定会调用Start方法来开启WebHost，但是除此之外，这个Run方法还有何特别之处呢？

Run方法的目的除了启动WebHost之外，它实际上会阻塞当前进程直到应用关闭。我们知道应用的关闭的意图是通过利用ApplicationLifetime发送相应信号的方式实现的，所以这个Run方法在启动WebHost的时候，会以阻塞当前线程的方式等待直至接收到这个信号。如下所示的代码片段基本上体现了这两个扩展方法Run的实现逻辑。

public static class WebHostExtensions
{
    public static void Run(this IWebHost host)
    {
        using (CancellationTokenSource cts = new CancellationTokenSource())
        {
            //Ctrl+C: 关闭应用
            Console.CancelKeyPress +=  (sender, args) =>
            {
                cts.Cancel();
                args.Cancel = true;
            };
            host.Run(cts.Token);
        }
    }

    public static void Run(this IWebHost host, CancellationToken token)
    {
        using (host)
        {
            //显示应用基本信息
            host.Start();
            IApplicationLifetime applicationLifetime = host.Services.GetService<IApplicationLifetime>();
            token.Register(state => ((IApplicationLifetime)state).StopApplication(), applicationLifetime);
            applicationLifetime.ApplicationStopping.WaitHandle.WaitOne();
        }
    }
}

上面这个代码片段还体现了另一个细节。虽然WebHost实现了IDisposable接口，原则上我们需要在关闭的时候显式地调用其Dispose方法。针对这个方法的调用非常重要，因为它的ServiceProvider只能在这个方法被调用时才能被回收释放。但是之前所有演示的实例都没有这么做，因为Run方法会自动帮助回收释放掉指定的这个WebHost。

三、远程关闭应用

既然WebHost在启动之后会利用ApplicationLifetime等待Stopping信号的发送，这就意味着组成ASP.NET Core管道的服务器和任何一个中间件都可以在适当的时候调用ApplicationLifetime的StopApplication来关闭应用。对于《服务器在管道中的“龙头”地位》介绍的KestrelServer，我们知道在构造这个对象的时候必须指定一个ApplicationLifetime对象，其根本的目的在于当发送某些无法恢复的错误时，它可以利用这个对象关闭应用。

接下来我们通过实例的方式来演示如何在一个中间件中利用这个ApplicationLifetime对象实现对应用的远程关闭，为此我们将这个中间件命名为RemoteStopMiddleware。RemoteStopMiddleware实现远程关闭应用的原理很简单，我们远程发送一个Head请求，并且在该请求中添加一个名为“Stop-Application”的报头传到希望关闭应用的意图，该中间件接收到这个请求之后会关闭应用，而响应中会添加一个“Application-Stopped”报头表明应用已经被关闭。

public class RemoteStopMiddleware
{
    private RequestDelegate _next;
    private const string     RequestHeader      = "Stop-Application";
    private const string     ResponseHeader     = "Application-Stopped";

    public RemoteStopMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context, IApplicationLifetime lifetime)
    {
        if (context.Request.Method == "HEAD" && context.Request.Headers[RequestHeader].FirstOrDefault() == "Yes")
        {
            context.Response.Headers.Add(ResponseHeader, "Yes");
            lifetime.StopApplication();
        }
        else
        {
            await  _next(context);
        }
    }
}

如上所示的代码片段是RemoteStopMiddleware这个中间件的完整定义，实现逻辑很简单，完全没有必要再赘言解释。我们在一个控制台应用中采用如下的程序启动一个Hello World应用，并注册此RemoteStopMiddleware中间件。在启动这个应用之后，我们借助Fiddler发送向目标地址发送三次请求，其中第一次和第三次普通的GET请求，而第二次则是为了远程关闭应用的HEAD请求。如下所示的是三次请求与响应的内容，由于应用被第二次请求关闭，所以第三次请求会返回一个状态码为502的响应。

//第1次请求与响应
GET http://localhost:5000/ HTTP/1.1
User-Agent: Fiddler
Host: localhost:5000

HTTP/1.1 200 OK
Date: Sun, 06 Nov 2016 06:15:03 GMT
Transfer-Encoding: chunked
Server: Kestrel

Hello world!

//第2次请求与响应
HEAD http://localhost:5000/ HTTP/1.1
Stop-Application: Yes
User-Agent: Fiddler
Host: localhost:5000

HTTP/1.1 200 OK
Date: Sun, 06 Nov 2016 06:15:34 GMT
Server: Kestrel
Application-Stopped: Yes

//第3次请求与响应
GET http://localhost:5000/ HTTP/1.1
User-Agent: Fiddler
Host: localhost:5000

HTTP/1.1 502 Fiddler - Connection Failed
Date: Sun, 06 Nov 2016 06:15:44 GMT
Content-Type: text/html; charset=UTF-8
Connection: close
Cache-Control: no-cache, must-revalidate
Timestamp: 14:15:44.790

[Fiddler] The connection to 'localhost' failed...