16：选项数据热更新：让服务感知配置的变化-开发实战

.NET Core开发实战前文传送门：

16 | 选项数据热更新：让服务感知配置的变化

选项框架还有两个关键类型：

1、IOptionsMonitor

2、IOptionsSnapshot

场景：

1、范围作用域类型使用 IOptinsSnapshot

2、单例服务使用 IOptionsMonitor

通过代码更新选项：

IPostConfigureOptions

延续上一节的代码，但是做一些特殊处理，之前注册 Order 服务用的是单例模式，这里改为 Scoped 模式

public void ConfigureServices(IServiceCollection services)
{
    services.Configure<OrderServiceOptions>(Configuration.GetSection("OrderService"));
    //services.AddSingleton<IOrderService, OrderService>();
    services.AddScoped<IOrderService, OrderService>();
    services.AddControllers();
}

service 还是使用 IOptions

public class OrderService : IOrderService
{
    IOptions<OrderServiceOptions> _options;
    
    public OrderService(IOptions<OrderServiceOptions> options)
    {
        _options = options;
    }

    public int ShowMaxOrderCount()
    {
        return _options.Value.MaxOrderCount;
    }
}

启动程序，输出如下：

orderService.ShowMaxOrderCount:200

修改配置

{
    "OrderService": {
    "MaxOrderCount": 2000
  }
}

启动程序，输出如下：

orderService.ShowMaxOrderCount:200

输出值还是200

那么如何能够读到新的配置呢？

只需要把 IOptions 换成 IOptionsSnapshot 即可

{
    "OrderService": {
    "MaxOrderCount": 2000
  }
}

这是因为我们的服务注册的是 Scoped 模式，并且使用 Snapshot 来读取配置，每次请求都会重新计算并读取配置

那如果我们的服务是单例的时候怎么办呢？

把服务注册改为单例模式

services.AddSingleton<IOrderService, OrderService>();

这里需要使用另一个接口，把 Snapshot 改为 Monitor

IOptionsMonitor<OrderServiceOptions> _options;

public OrderService(IOptionsMonitor<OrderServiceOptions> options)
{
    ...
}

Monitor 与 Snapshot 的定义略微有些不同，它获取值是需要用 CurrentValue 字段

public int ShowMaxOrderCount()
{
    return _options.CurrentValue.MaxOrderCount;
}

启动程序，修改配置文件，刷新浏览器，可以看到输出了修改后的数据，也就是说单例对象同时也能读取到最新的配置

如果说我想知道配置的值发生变化并且通知到我的 Options 怎么做呢？

首先看一下 Monitor 的定义

namespace Microsoft.Extensions.Options
{
  public interface IOptionsMonitor<out TOptions>
  {

    TOptions CurrentValue { get; }

    TOptions Get(string name);

    IDisposable OnChange(Action<TOptions, string> listener);
  }
}

它有一个 OnChange 方法，也就是说可以监听它的变更

public OrderService(IOptionsMonitor<OrderServiceOptions> options)
{
    _options = options;

    _options.OnChange(option =>
    {
        Console.WriteLine($"配置更新了，最新的值是:{_options.CurrentValue.MaxOrderCount}");
    });
}

启动程序，修改配置，可以看到输出配置变化，也就是说可以在单例模式下监听到 Options 的变化

通常情况下，在设计服务的时候，会在 ConfigureServices 添加配置注入、服务注入，但是当配置多起来的时候，注入代码就会非常多

那么如何使代码结构更加良好？

实际上可以把服务注册的代码放在静态扩展方法里，使得 ConfigureServices 更加简洁

namespace Microsoft.Extensions.DependencyInjection
{
    public static class OrderServiceExtensions
    {
        public static IServiceCollection AddOrderService(this IServiceCollection services,IConfiguration configuration)
        {

            services.Configure<OrderServiceOptions>(configuration);
            services.AddSingleton<IOrderService, OrderService>();
            return services;
        }
    }
}

这样在 Startup 的注册就变得更为简单了

services.AddOrderService(Configuration.GetSection("OrderService"));

我们在设计系统的时候会涉及大量的 service，所以我们可以把 service 的注册提炼在扩展方法里，不同的模块用不同的扩展方法隔开，使模块之间更加清晰，代码的结构也更加的清晰

那么实际上我们在设计服务的时候，还有一些特殊的述求，比如说把配置读取出来之后，还需要在内存里面进行一些特殊的处理，我们就可以使用动态配置的方式

动态配置的方式是在我们的 Configure 的代码之后，调用 PostConfigure 的方法，这里需要配置 OrderServiceOptions

{
    public static class OrderServiceExtensions
    {
        public static IServiceCollection AddOrderService(this IServiceCollection services,IConfiguration configuration)
        {

            services.Configure<OrderServiceOptions>(configuration);
            
            services.PostConfigure<OrderServiceOptions>(options =>
            {
                options.MaxOrderCount += 20;
            });
            
            services.AddSingleton<IOrderService, OrderService>();
            return services;
        }
    }
}

启动程序，可以看到输出动态增加了20