SchedulerX:Spring ジョブと SchedulerX の統合

手順 1：依存関係の追加

Spring Boot アプリケーションで、SchedulerX の依存関係を pom.xml ファイルに追加します。

schedulerx2.version には最新のエージェントバージョンを使用してください。詳細については、「エージェントリリースノート」をご参照ください。

<dependency>
  <groupId>com.aliyun.schedulerx</groupId>
  <artifactId>schedulerx2-spring-boot-starter</artifactId>
  <version>${schedulerx2.version}</version>
  <!-- Logback を使用する場合は、Log4j と Log4j2 を除外する必要があります。 -->
  <exclusions>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-api</artifactId>
    </exclusion>
    <exclusion>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-core</artifactId>
    </exclusion>
    <exclusion>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
    </exclusion>
  </exclusions>
</dependency>

@SpringBootApplication
@EnableScheduling /** Spring のスケジュールジョブを有効にします。*/
public class SchedulerXWorkerApplication {
    public static void main(String[] args) {
        SpringApplication.run(SchedulerXWorkerApplication.class, args);
    }
}
/** ネイティブの Spring スケジュールジョブクラスです。*/
@Service
public class SpringScheduledProcessor {
    @Scheduled(cron = "0/2 * * * * ?")
    public void hello() {
        logger.info(DateUtil.now() + " hello world. start");
        logger.info(DateUtil.now() + " hello world. end");
    }
}

手順 3 (任意)：タスクの手動作成

1. SchedulerX コンソールにログインします。

2. 左側のナビゲーションペインで、[task management] をクリックします。

3. [task management] ページで Create Task をクリックします。タスクタイプとして [SpringSchedule] を選択し、クラス名とメソッド名を設定します。

   パラメーター	説明
   [Name]	タスクを識別するための一意の名前。
   [Description]	タスクの検索と管理に役立つ任意の説明。
   [Application ID]	タスクが属するアプリケーション グループ。ドロップダウンリストからオプションを選択します。
   [Job Type]	タスクのプロセッサータイプ。有効な値： Java、Shell、Python、Go、HTTP、Node.js、[SpringSchedule]、XXL-JOB、DataWorks。Shell、Python、または Go を選択した場合、スクリプトエディターが表示されます。 このチュートリアルでは、[SpringSchedule] を選択します。
   Spring Schedule の設定	タスクの完全修飾クラス名とメソッド名。
   [Execution Mode]	複数のインスタンスでタスクをどのように実行するかを指定します。次のモードがサポートされています： スタンドアロン実行：ランダムに選択された 1 つのインスタンスでタスクを実行します。 ブロードキャスト実行：すべてのインスタンスで同時にタスクを実行します。 説明 詳細設定は、選択された実行モードによって変わります。
   [Priority]	同じアプリケーション内の複数のタスクが同じインスタンスで実行可能な状態になった場合、優先度の高いタスクが先に実行されます。SchedulerX は、プリエンプティブな優先度付きキューを使用して、異なるインスタンス間でも高優先度のタスクが確実に先に実行されるようにします。詳細については、「優先度付きキューによるアプリケーションレベルのスロットリング」をご参照ください。
   [Job Parameters]	実行時にジョブコンテキストから取得できるカスタム文字列。

4. スケジュールを設定します。

   説明

   コンソールで設定したスケジュールは、コード内の @Scheduled アノテーションで指定されたスケジュールを上書きします。ただし、コード内のアノテーションは保持する必要があります。

   次の表では、時間ベースのパラメーターについて説明します。

   パラメーター	説明
   [Time Type]	none：タスクはスケジュールされず、通常はワークフローによってトリガーされます。 cron：タスクは Cron 式を使用してスケジュールされます。 api：タスクは API 呼び出しによってトリガーされます。 fixed_rate：タスクは固定頻度でトリガーされます。 second_delay：タスクは秒単位の固定遅延の後にトリガーされます。 one_time：タスクは 1 回だけ実行されます。
   [Cron Expression] (cron 時間タイプのみ)	標準の Cron 式を入力します。組み込みツールを使用して式を生成し、検証することもできます。
   固定頻度 (fixed_rate 時間タイプのみ)	間隔を秒単位で入力します。値は 60 以上である必要があります。たとえば、値 200 は、タスクが 200 秒ごとに実行されることを意味します。
   固定遅延 (second_delay 時間タイプのみ)	遅延を秒単位で入力します。値は 1 から 60 の範囲である必要があります。たとえば、値 5 は、タスクがスケジュールされた時刻の 5 秒後にトリガーされることを意味します。

   次の表では、詳細設定パラメーターについて説明します。

   パラメーター	説明
   [Data Timestamp Offset]	データタイムスタンプとスケジュール時刻のオフセット。この値は実行時にジョブコンテキストから取得できます。
   [Time Zone]	ビジネス要件に基づいてタイムゾーンを選択します。リージョンタイムゾーンと標準 GMT タイムゾーンの両方がサポートされています。
   [Calendar]	営業日カレンダーや金融日カレンダーなどのカレンダーを選択して、タスクの実行を特定の日に制限できます。

5. アラートルールと通知チャネルを設定します。詳細については、「通知先の管理」をご参照ください。

   これらの手順を完了すると、SchedulerX が Spring ジョブを管理し、ビジュアルモニタリング、ログクエリ、実行トレース、アラートなどのエンタープライズ級の機能を提供します。