SchedulerX:Spring ジョブ

ステップ 1：pom.xml ファイルに依存関係を追加する

アプリケーションの pom.xml ファイルに依存関係とメインクラスを追加します。この例では、Spring Boot アプリケーションを使用します。

schedulerx2.version を SchedulerX エージェントの最新バージョンに置き換えます。詳細については、「エージェントリリースノート」をご参照ください。

<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. 左側のナビゲーションペインで、[タスク管理] をクリックします。

3. [タスク管理] ページで、[タスクの作成] をクリックします。[タスクタイプ] を [SpringSchedule] に設定し、クラス名とメソッド名を構成します。

   パラメータ	説明
   タスク名	作成するジョブの名前。
   説明	ジョブの説明。ジョブの検索と管理を容易にするために、簡潔で明確な説明を指定します。
   アプリケーション ID	ジョブが属するグループ。ドロップダウンリストから値を選択します。
   タスクタイプ	ジョブの作成に使用するプログラミング言語。有効な値は、Java、Shell、Python、Golang、Http、Node.js、XXL-JOB、DataWorks です。Shell、Python、または Golang を選択すると、エディタが表示されます。エディタにスクリプトを入力できます。 この例では、このパラメータは SpringSchedule に設定されています。
   spring scheduleConfiguration	ジョブの完全なクラス名とメソッド名。
   実行モード	ジョブを実行するモード。次の実行モードがサポートされています。 スタンドアロン操作：ジョブはランダムなワーカーで実行されます。 ブロードキャスト実行：ジョブはすべてのワーカーで同時に実行され、システムはすべてのワーカーがジョブを完了するまで待機します。 説明 [詳細設定] セクションのパラメータは、選択した実行モードによって異なります。
   優先度	同じアプリケーションの複数のジョブが同じワーカーで同時に実行される場合、優先度の高いジョブが最初に実行されます。ただし、同じアプリケーションの複数のジョブが複数のワーカーで実行される場合、優先度の異なるジョブは異なるワーカーにスケジュールされます。この場合、優先度の低いジョブが最初に実行される可能性があります。SchedulerX はプリエンプティブキューを使用してこの問題を回避し、キュー内の優先度の高いジョブが最初にトリガーされるようにします。詳細については、「プリエンプティブキュー」をご参照ください。
   タスクパラメータ	SchedulerX がジョブを実行するときにコンテキストから取得できるランダムな文字列。

4. トリガー頻度を構成します。

   説明

   SchedulerX コンソールで指定された頻度が優先され、スケジュールされた Spring ジョブのコード内のネイティブアノテーション @Scheduled の構成は無効になります。ただし、アノテーションはコード内に保持されます。

   次の表にパラメータを示します。

   パラメータ	説明
   時間タイプ	なし：ジョブはワークフローを使用してトリガーされます。 cron：ジョブは cron 式に基づいてスケジュールされます。 api：ジョブは API 操作を呼び出すことによってトリガーされます。 fixed_rate：ジョブは指定された間隔でトリガーされます。 second_delay：ジョブは 1 ～ 60 秒の遅延でトリガーされます。 one_time：ジョブは指定された時点で 1 回だけトリガーされます。
   Cron 式	ジョブのスケジュールに使用される cron 式。cron 構文に基づいて cron 式を手動で入力できます。また、SchedulerX が提供するツールを使用して、有効な cron 式を自動的に生成することもできます。
   固定頻度	ジョブがトリガーされる間隔。このパラメータは、[タスクタイプ] パラメータが fixed_rate に設定されている場合にのみ使用できます。値は 60 より大きい必要があります。単位：秒。たとえば、値 200 は、ジョブが 200 秒間隔でトリガーされることを示します。
   固定遅延	固定遅延。このパラメータは、[タスクタイプ] パラメータが second_delay に設定されている場合にのみ使用できます。有効な値：1 ～ 60。単位：秒。たとえば、値 5 は、ジョブが 5 秒の遅延でトリガーされることを示します。

   次の表に、高度なタイミング構成を示します。

   パラメータ	説明
   時間オフセット	処理するデータのタイムスタンプとジョブがトリガーされる時間のオフセットを指定します。SchedulerX がジョブを実行するときに、コンテキストからオフセット値を取得できます。
   タイムゾーン	ビジネス要件に基づいて、国または地域のタイムゾーンを選択するか、GMT タイムゾーンを選択します。
   カレンダー	[平日] または [営業日] を選択します。

5. アラート条件と通知方法を構成します。通知方法の詳細については、「通知連絡先と通知連絡先グループ」をご参照ください。

   構成が完了すると、SchedulerX はスケジュールされた Spring ジョブを実行できます。コンソールは、視覚化された管理と制御、ジョブログクエリ、実行チェーンビュー、ジョブ実行通知とアラートなど、エンタープライズレベルの O&M 機能をネイティブ Spring ジョブに提供します。