.NET Core 开源项目 Anet 在路上

今天给大家介绍我刚开源的一个 .NET Core 项目：Anet。Anet 的目标是实现一个 .NET Core 通用库、通用框架和通用模板。我给它的定义是：

A .NET Core Common Lib, Framework and Boilerplate.

它的取名正是来自于这句话的前面四个字母：ANET。Anet 的宗旨是打造一个简单易用的快速开发项目模板，适用于 Console 应用和 Web 应用。

但是这个项目它还处于开发阶段，我现只是起了个头，目前只封装了一些简单的功能，不过已实现的部分已经可以投入使用了。

项目地址：https://github.com/liamwang/anet

为什么选择 Anet?

目前很多 .NET 开源框架模板（比如 ABP）都比较重，学习成本高，使用起来很多条条框框，比较麻烦。在实际开发中，经常要做一些小服务或小工具，选这种重型的框架可能就不太合适了。而 Anet 就是为了解决这个问题，它追求的是简单易用，适合快速开发一个微服务或小工具。

一个简单的任务轮循例子

下面演示如何通过 Anet 来实现一个简单任务轮循程序，模拟一个发送消息的任务调度服务。这个示例在 GitHub 有 Sample，我就不贴所有代码了，只选重点。

实际场景应该是这样的，每隔几秒钟从缓存队列中获取要发送的消息，调用其它接口执行发送，并且需要有日志。如果出现异常，服务不能终止或崩溃，即需要有容错机制（一般还会有重试机制等，就不在这例子中讲了）。Anet 封装了一个 JobScheduler，它可以满足大部分的这一类需求。

首先创建一个 Console（.NET Core）应用，安装 Anet 包：

dotnet add package Anet

然后添加一个 MessageJob 类，使它实现 IJob 接口，代码如下：

public class MessageJob : IJob
{
    private readonly ILogger<MessageJob> _logger;
    public MessageJob(ILogger<MessageJob> logger)
    {
        _logger = logger;
    }

    public Task ExecuteAsync()
    {
        return Task.Run(() =>
        {
            // 模拟发送消息
            _logger.LogInformation("正在发送消息...");
            Thread.Sleep(3000);
            _logger.LogInformation("消息发送成功。");
        });
    }

    public Task OnExceptionAsync(Exception ex)
    {
        _logger.LogError(ex, "发送消息出错。");
        return Task.FromResult(0);
    }
}

每个 Console 程序都需要先调用 AnetGlobal 中的 InitConsoleApp 方法来初始化，通过这个方法内可以进行一些自定义配置。

在 Program.cs 中添编写如下代码：

public class Program
{
    public static SettingsModel Settings { get; set; }

    static void Main(string[] args)
    {
        Console.Title = "Aet 示例 - 简单任务调度程序";

        // 初始化应用
        AnetGlobal.InitConsoleApp((config, services) =>
        {
            // 绑定配置
            Settings = new SettingsModel();
            config.Bind(Settings);

            // 注册服务
            services.AddTransient<MessageJob>();
        });

        // 1. 简单任务调度示例
        JobScheduler.StartNew<MessageJob>(Settings.JobIntervalSeconds);

        // ...（其它示例）

        // 等待 Ctrl+C 或关闭窗口
        JobScheduler.WaitForShutdown();
    }
}