在 worker service 中使用 quartz.net

  • 以下示例基于 Quartz.Net 3.0.7（在最新的 3.1-beta2 中已经包含了支持 Microsoft DI 的方法）

在 worker service 中，通过官网示例，会发现 quartz.net 并未生效，究其原因系 DI 未注入导致，原生 quartz.net（3.0.7）是通过 CreateInstance 来创建实例的，本文旨在解决在 Worker Service、Console 中使用 quartz.net 无效的问题。

项目结构如下：

初始化

JobSchedule.cs

用来配置 Job，如果需要更多配置，可以扩展该类。

public class JobSchedule
{
    public JobSchedule(Type jobType, string cronExpression)
    {
        JobType = jobType;
        CronExpression = cronExpression;
    }

    public Type JobType { get; }
    public string CronExpression { get; }
}

基于 .NET CORE 3.1 提供的 worker service 来创建 windows 服务

.NET CORE 3.1 提供了 worker service 这么一个模板，可以方便开发者来创建”windows 服务程序“（同样可发布于 linux）。本篇以 centos 7.6 为发布环境，简要说明如何使用 worker service 来创建服务，并部署发布到 centos 中。

你可以通过以下命令来查看本地安装的 .net core 环境：

dotnet   --version  # 笔者为 3.1.301

你可以通过以下命令来查看是否含有 worker service 模板：

dotnet  new  -l

安装

方式1：命令行形式安装

你可以通过如下命令在当前解决方案中安装：

Elasticsearch.Nest 教程系列 10-4 常用类型：Union Type | 类型合并

ES 中的某些API参数可以接受多个 JSON 数据结构，例如，搜索请求时对 source 过滤可以接受：

  • bool：可以通过布尔值来禁用 _source 检索。
  • string、string[]：可以使用字符串来设定通配符，以此来控制返回 _source 中的哪些部分。
  • object：一个包含 includs 和 excluds 属性的对象，来分别控制需要在 _source 中需要“包含”和“排除”的部分。

在 NEST 中，可以使用 Union<First，Second> 类型。

隐式转换

Union<TFirst，TSecond>具有隐式运算符，可从 TFirst 或 TSecond 的实例转换为Union<TFirst，TSecond> 的实例：

Union<bool, ISourceFilter> sourceFilterFalse = false;

Union<bool, ISourceFilter> sourceFilterInterface = new SourceFilter
{
    Includes = new [] { "foo.*" }
};

Elasticsearch.Nest 教程系列 10-3 常用类型：Date math expressions | 日期数字表达式

在“查询/过滤”的时候支持使用日期类型的数学表达式。表达式以“锚定”日期开始，该日期可以是现在，也可以是以“||”结尾的日期字符串。它后面可以是一个数学表达式，支持 +，- 和 /（四舍五入）。支持的单位有：

  • y (year)
  • M (month)
  • w (week)
  • d (day)
  • h (hour)
  • m (minute)
  • s (second)

ES 中的 Date Math。

常规示例

使用 DateMath 提供的静态方法：

Expect("2020-01-23T00:00:00").WhenSerializing(Nest.DateMath.Anchored(new DateTime(2020,01, 23)));

Elasticsearch.Nest 教程系列 10-2 常用类型：Distance Units | 距离单位

在 ES 的 GEO 相关查询中，你会使用到“距离”这个概念，Nest 提供了 Distance 类来帮助你创建“距离”。

通过 Distance 构造函数

var unitComposed = new Distance(25);
var unitComposedWithUnits = new Distance(25, Nest.DistanceUnit.Meters);

也可以使用指定距离单位的字符串，如下：

Expect("25m")
    .WhenSerializing(unitComposed)
    .WhenSerializing(unitComposedWithUnits);

Elasticsearch.Nest 教程系列 10-1 常用类型：Time Units | 时间单位

当你需要在 ES 中指定时间相关的操作时：如超时时间，持续时间，可以使用 Nest 提供的 Time 数据类型。

Time 构造函数

最长用的方法：

var unitString = new Time("2d");
var unitComposed = new Time(2, Nest.TimeUnit.Day);
var unitTimeSpan = new Time(TimeSpan.FromDays(2));
var unitMilliseconds = new Time(1000 * 60 * 60 * 24 * 2);

Elasticsearch.Nest 教程系列 9-7 转换：Indices Paths | 索引路径

Elasticsearch 中的某些API在请求的 URI 中回需要使用索引名称，索引名称的集合或特殊的 _all 标记（表示所有索引），以指定在哪个(哪些)索引上进行请求。

在 Nest 中，这些索引的名称通过 Indices 类型来进行指定。

显式指定

以下几种类型会隐式转换：

  • string。
  • 逗号分隔的 string。
  • string 数组。
  • 已经在 ConnectionSettings 上设置相关类型的索引名称的 CLR 类。
  • IndexName 类
  • IndexName 数组