第四节: 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(2).RepeatForever())
                                  .EndAt(DateTimeOffset.Now.AddSeconds(60))    //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(2).RepeatForever())    //每隔两秒执行一次
                                 .EndAt(DateTimeOffset.Now.AddSeconds(60))    //60s后结束
                                 .ForJob("job1", "jobGroup1")    //通过表名和组名进行关联
                                 .Build();
                var trigger2 = TriggerBuilder.Create()
                               .UsingJobData("name", "ypf2")   //附加信息
                               .UsingJobData("age", "age2")
                               .StartNow()     //马上开启
                               .WithSimpleSchedule(x => x.WithIntervalInSeconds(5).RepeatForever())      //每隔5秒执行一次
                               .EndAt(DateTimeOffset.Now.AddSeconds(60))    //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(2).RepeatForever())    //每隔两秒执行一次
                                 .EndAt(DateTimeOffset.Now.AddSeconds(60))    //60s后结束
                                 .Build();
                var trigger2 = TriggerBuilder.Create()
                               .UsingJobData("name", "ypf2")   //附加信息
                               .UsingJobData("age", "age2")
                               .StartNow()     //马上开启
                               .WithSimpleSchedule(x => x.WithIntervalInSeconds(5).RepeatForever())      //每隔5秒执行一次
                               .EndAt(DateTimeOffset.Now.AddSeconds(60))    //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的触发时间相同，优先级越大的越先执行。