第四节: Quartz.Net五大构件之Trigger通用用法(常用方法、优先级、与job关联等)

一. 简介

1. 几个类型：

　　①：TriggerBuilder：用来创建ITrigger实例

　　②：ITrigger：触发器实例

2.常用的几个方法

　　①.StartNow：Trigger马上触发.

　　②.StartAt和EndAt：设置Trigger触发的开始时间和结束时间 （省略设置开始时间的话，默认从当前时间开始执行）

　　③.UsingJobData：给Trigger添加一些附加值（通过context.Trigger.JobDataMap获取）

　　④.WithDescription：用来描述该触发器，并没有什么实际左右

　　⑤.WithPriority：设置Trigger的优先级，默认为5，数字越大，优先级越高.（该优先级用于一个job对应多个Trigger，且Trigger的触发时间相同，优先级越大的越先执行）

　　⑥.ForJob：将job和trigger进行关联，该方法有多个重载，关联后ScheduleJob方法进行调度时，只需将trigger传入进去即可

二.  Job和Trigger关联问题

(1). 1个job对应1个trigger：调用ScheduleJob(IJobDetail jobDetail, ITrigger trigger)，直接关联即可，无须做特别处理

(2). 1个job对应多个trigger：有两种方案解决

　　方案A： 将job持久化（StoreDurably(true)）,然后通过AddJob方法加入调度池中，Trigger上通过ForJob方法和指定job进行关联，然后调用ScheduleJob(ITrigger trigger)方法，将trigger全部加入调度池中，最后Start开启即可

　　方案B： 创建job和trigger都不需要关联，也不需要特殊设置，最后将trigger加入一个HashSet<ITrigger>池中，通过一次性通过 ScheduleJob(IJobDetail jobDetail, Collection.ISet<ITrigger> triggersForJob, bool replace)进行关联

(3). 2个job对应1个trigger (不常用)

　　利用JobChainingJobListener实现

 代码分享：

             //1. 创建Schedule
             IScheduler scheduler = StdSchedulerFactory.GetDefaultScheduler();
             //2. 创建Job
             var job1 = JobBuilder.Create<HelloJob3>()
                     .WithIdentity("job1", "jobGroup1")
                     .StoreDurably(true)
                     .Build();
             var job2 = JobBuilder.Create<HelloJob>()
                     .WithIdentity("job2", "jobGroup2")
                     .StoreDurably(true)
                     .Build();
             /********************************* 下面测试job和 Trigger的关联问题  (与下面Trigger优先级的测试互不影响)**************************************/

             #region 情况1：1个job对应1个trigger
             {
                 var trigger = TriggerBuilder.Create()
                                   .UsingJobData("name", "ypf1")   //附加信息
                                   .UsingJobData("age", "age1")
                                   .StartAt(DateBuilder.EvenSecondDateAfterNow()) //表示下一个秒整点开启，比如现在9点19分20秒，那么9点20分21s整开启
                                   .WithSimpleSchedule(x => x.WithIntervalInSeconds().RepeatForever())
                                   .EndAt(DateTimeOffset.Now.AddSeconds())    //60s后结束
                                   .Build();
                 scheduler.ScheduleJob(job1, trigger);
                 scheduler.Start();
             }
             #endregion

             #region 情况2:1个job对应多个Trigger
             //方案1
             {
                 var trigger1 = TriggerBuilder.Create()
                                  .UsingJobData("name", "ypf1")   //附加信息
                                  .UsingJobData("age", "age1")
                                  .StartNow()     //马上开启
                                  .WithSimpleSchedule(x => x.WithIntervalInSeconds().RepeatForever())    //每隔两秒执行一次
                                  .EndAt(DateTimeOffset.Now.AddSeconds())    //60s后结束
                                  .ForJob("job1", "jobGroup1")    //通过表名和组名进行关联
                                  .Build();
                 var trigger2 = TriggerBuilder.Create()
                                .UsingJobData("name", "ypf2")   //附加信息
                                .UsingJobData("age", "age2")
                                .StartNow()     //马上开启
                                .WithSimpleSchedule(x => x.WithIntervalInSeconds().RepeatForever())      //每隔5秒执行一次
                                .EndAt(DateTimeOffset.Now.AddSeconds())    //60s后结束
                                .ForJob(job1)    //直接IJobDetail关联
                                .Build();

                 scheduler.AddJob(job1, true);
                 scheduler.ScheduleJob(trigger1);
                 scheduler.ScheduleJob(trigger2);
                 scheduler.Start();
             }
             //方案2
             {
                 var trigger1 = TriggerBuilder.Create()
                                  .UsingJobData("name", "ypf1")   //附加信息
                                  .UsingJobData("age", "age1")
                                  .StartNow()     //马上开启
                                  .WithSimpleSchedule(x => x.WithIntervalInSeconds().RepeatForever())    //每隔两秒执行一次
                                  .EndAt(DateTimeOffset.Now.AddSeconds())    //60s后结束
                                  .Build();
                 var trigger2 = TriggerBuilder.Create()
                                .UsingJobData("name", "ypf2")   //附加信息
                                .UsingJobData("age", "age2")
                                .StartNow()     //马上开启
                                .WithSimpleSchedule(x => x.WithIntervalInSeconds().RepeatForever())      //每隔5秒执行一次
                                .EndAt(DateTimeOffset.Now.AddSeconds())    //60s后结束
                                .Build();

                 Quartz.Collection.HashSet<ITrigger> triggerHash = new Quartz.Collection.HashSet<ITrigger>();
                 triggerHash.Add(trigger1);
                 triggerHash.Add(trigger2);
                 scheduler.ScheduleJob(job1, triggerHash, true);
                 scheduler.Start();
             }
             #endregion

             #region 情况3：2个job对应1个trigger
             {
                 //每s执行一次
                 var trigger = TriggerBuilder.Create().WithCronSchedule("/1 * * * * ?").Build();

                 JobChainingJobListener listener = new JobChainingJobListener("mytest");
                 listener.AddJobChainLink(job1.Key, job2.Key);
                 scheduler.ListenerManager.AddJobListener(listener);

                 scheduler.AddJob(job2, true);
                 scheduler.ScheduleJob(job1, trigger);
                 scheduler.Start();
             }
             #endregion

三. Trigger的优先级（未完）

　　利用WithPriority方法，该优先级用于一个job对应多个Trigger，且Trigger的触发时间相同，优先级越大的越先执行。