Quartz.NET 作业调度（二）：Job通过 JobBuilder 的 Create 方法，指定一个作业任务（一个实

JobBuilder

Create

通过 JobBuilder 的 Create 方法，指定一个作业任务（一个实现了 IJob 接口的 Job 类）。IJob 接口只有一个 Execute 方法，我们需要在 Execute 方法中完善我们要执行的业务代码。

IJobDetail job = JobBuilder.Create<HelloJob>()
                           .Build();

public class HelloJob : IJob
{
	public async Task Execute(IJobExecutionContext context)
	{
		await Console.Out.WriteLineAsync("Hi,everybody");
	}
}

Execute 方法中的 context 参数包含作业执行的所有上下文信息，我们可以通过 context 中的一些属性获取需要的数据。如：

context.Scheduler 调度器信息
context.Trigger 触发器信息
context.JobDetail 作业信息
context.ScheduledFireTimeUtc 当前触发时间
context.NextFireTimeUtc 下一次将被触发时间
……

Identity

Job 注册到 Quartz 调度器的时候需要设置一个标识的 key，同时可以为 key 设置一个组，方便我们对 Job 分类，在同一个组内的 key 必须是唯一的。

IJobDetail job = JobBuilder.Create<HelloJob>()
                 .WithIdentity("job1", "jobGroup1");

UsingJobData

通过 JobBuilder 的 UsingJobData 方法我们可以为这个 Job 设置一些附属信息，当 Job 被执行的时候，我们在 Execute 方法中通过 context.JobDetail.JobDataMap 获取这些信息以供业务代码使用，也可以通过定义同名的属性，它将会自动注入到属性值。

var jobDataMap = new JobDataMap();
jobDataMap.Add("name", "beck");

JobBuilder.Create<HelloJob>()
                .WithIdentity("job1", "jobGroup1");
                .UsingJobData(jobDataMap)

public class HelloJob : IJob
{
    // 映射JobDetail.JobDataMap的name
	public string Name { get; set; }
	public async Task Execute(IJobExecutionContext context)
	{
		//var name = context.JobDetail.JobDataMap["name"].ToString();
		await Console.Out.WriteLineAsync($"Hi {Name}");
	}
}

注意：Job 和 Trigger 中都可以通过 UsingJobData 来设置附属信息，在 Execute 方法中，context.MergedJobDataMap 属性中既包含 Job 的 DataMap，也包含 Trigger 的 DataMap。当存在同名的参数时，Trigger 会覆盖 Job 的参数值。

StoreDurably

默认情况下，当 Job 没有对应的 Trigger 时，Job 是不能直接被加入调度器中的，或者在 Trigger 过期之后，没有关联 Trigger 的 Job 也会被删除。我们可以通过 JobBuilder 的 StoreDurably 使 Job 独立存储于调度器中。

JobBuilder.Create<HelloJob>()
                .WithIdentity("job1", "jobGroup1")
                .UsingJobData(jobDataMap)
                .StoreDurably();

Job

State

Job 默认是无状态的，每次执行 Job ，context.JobDetail 获取到值都是原始数据，对其的任何修改都不会生效。
如：我们试图修改 JobDataMap 中的 times 属性，希望每次执行后都加1。

var jobDataMap = new JobDataMap();
jobDataMap.Add("times", 1);

public class HelloJob : IJob
{
	public int Times { get; set; }
	public async Task Execute(IJobExecutionContext context)
	{
		context.JobDetail.JobDataMap["times"] = Times + 1;
		await Console.Out.WriteLineAsync($"execute {Times} times");
	}
}

无状态的结果

实际并不会有效，Job 注册之后，调度器内保存了这个对象，默认情况下是每次通过反射new一个新实例来执行的，所以每次修改必然不会有效。但我们可以通过在 Job 类上加上 PersistJobDataAfterExecution Attribute，就可以非常简单的把 Job 变成有状态。

[PersistJobDataAfterExecution]
public class HelloJob : IJob
{
	// ...
}

有状态的结果

Concurrency

当多个 Trigger 同时触发一个 Job 或者一个 Job 执行较长，Trigger 条件已经被多次触发，这种情况下，Job 就出现了并发问题。在并发情况下，数据的准确性必然会有影响。

我们设置 Trigger 触发周期为1s一次，在 Job 的 Exceute 方法中加入代码：

Thread.Sleep(2000);

并发的结果

很明显结果的错误的，但这时我们可以通过在 Job 类上加上 DisallowConcurrentExecution Attribute，就可以完美解决并发问题。

[DisallowConcurrentExecution]
public class HelloJob : IJob
{
	// ...
}

无并发的结果

Quartz.NET 作业调度（二）：Job