Scheduler実装サービス jp.ossc.nimbus.service.scheduler2.DefaultSchedulerService

jp.ossc.nimbus.service.scheduler2.DefaultSchedulerServiceは、スケジュールをQueueを使って非同期処理するScheduler実装サービスです。

このサービスは、実行すべきスケジュールを監視するスレッドを１つ持ちます。
監視スレッドは、定期的にスケジュールを管理するScheduleManagerに「現在実行すべきスケジュール」を問い合わせます。
「現在実行すべきスケジュール」が存在する場合、スケジュールを取得して、Queueにスケジュールを投入します。その際、ScheduleManagerに依頼して、スケジュールの状態を「投入」に変更します。
また、このサービスは、内部にQueueHandlerContainerを持ちQueueに投入されたスケジュールを受けとる処理スレッドをプールしています。
処理スレッドは、Queueからスケジュールを受け取ると、ScheduleExecutorにスケジュールの実行を依頼します。その際、ScheduleManagerに依頼して、スケジュールの状態を「実行中」に変更します。
その後、ScheduleExecutorの応答に応じて、ScheduleManagerに依頼してスケジュールの状態を「正常終了」、「異常終了」、「中断」、「リトライ」などに変更します。

スケジューラのクラスタ化は、Active-Active構成とActive-Standby構成の２パターンあります。
クラスタ化する場合、前提として、ScheduleManagerの実装サービスが、サーバを跨いでもスケジュールを共有できる実装である必要があります。

Active-Active構成の場合は、それぞれのサーバ上のスケジューラは、互いの存在を意識する事なく動作します。
そのため、利点としては、分散設計が単純である（フェイルオーバがない）ことです。
逆に欠点は、サーバ間でスケジュールの処理割り当ての調整を行わないため、ロードバランスとしては、適切には行われません。取ったもの勝ちで処理していきます。但し、属性ExecutorKeyでスケジューラに論理的な名前を与える事が可能で、スケジュール毎に処理するスケジューラを指定する事で、静的にロードバランスを決める事はできます。

Active-Standby構成の場合は、スケジューラは、どこか１台のサーバのみが稼働します。但し、待機系のサーバは、純粋に待機している訳ではなく、スケジュールを実行するScheduleExecutorは稼働します。つまり、スケジュールを監視して投入するサーバは１台ですが、実行は全サーバのどこかにロードバランスして、実行することで、負荷分散を行います。
そのため、利点としては、各サーバの負荷に応じてロードバランスを行う事ができ、リソースを有効に活用できる事です。もちろん、Active-Active構成の時と同様に、スケジュール毎に静的なロードバランスを指定する事もできます。但し、待機系のスケジューラは稼働しないため、スケジュール割り当てのための論理名は、ScheduleExecutorの属性ExecutorKeyで設定します。
逆に、欠点としては、分散設計が複雑である（フェイルオーバがあり、稼働系と待機系で異なる挙動をしている）ことです。
ロードバランスのポリシーは、jp.ossc.nimbus.service.keepalive.KeepAliveCheckerSelectorサービスの実装クラスに依存します。

このサービスは、複合的なサービスで、以下のサービスを下位サービスとして使用します。

下位サービスインタフェース	用途
jp.ossc.nimbus.service.scheduler2.ScheduleManager	実行すべきスケジュールを取得する。
jp.ossc.nimbus.service.scheduler2.ScheduleExecutor	スケジュールの実行を依頼する。
jp.ossc.nimbus.service.keepalive.ClusterService	スケジューラをクラスタ化する。
jp.ossc.nimbus.service.sequence.Sequence	スケジュールの処理通番を発行する。
jp.ossc.nimbus.service.context.ThreadContextService	スケジュールの処理通番を設定する。
jp.ossc.nimbus.service.transaction.TransactionManagerFactory	javax.transaction.TransactionManagerを取得する
jp.ossc.nimbus.service.queue.Queue	スケジュールの実行を非同期に行うためのキュー。

以下に簡単なサービス定義を示します。

 <?xml version="1.0" encoding="Shift_JIS"?>
 <!DOCTYPE server PUBLIC
   "-//Nimbus//DTD Nimbus 1.0//JA"
   "http://nimbus.sourceforge.jp/dtd/nimbus-service_1_0.dtd">
 
 <server>
     
     <manager>
         
         <!-- スケジューラサービス -->
         <service name="Scheduler"
                  code="jp.ossc.nimbus.service.scheduler2.DefaultSchedulerService">
             
             <!-- ScheduleManagerサービスのサービス名を設定する -->
             <attribute name="ScheduleManagerServiceName">#ScheduleManager</attribute>
             
             <!-- ScheduleExecuterサービスのサービス名を設定する -->
             <attribute name="ScheduleExecutorServiceName">#ScheduleExecutor</attribute>
             
             <!-- スケジュール実行スレッド数を設定する -->
             <attribute name="ScheduleDispatcherSize">5</attribute>
             
             <depends>ScheduleManager</depends>
             <depends>ScheduleExecutor</depends>
             
         </service>
         
         <!-- ScheduleManagerサービス -->
         <service name="ScheduleManager"
                  code="jp.ossc.nimbus.service.scheduler2.DefaultScheduleManagerService">
             <attribute name="ScheduleMasterServiceNames">
                 #ScheduleMaster1
                 #ScheduleMaster2
                 #ScheduleMaster3
                 #ScheduleMaster4
             </attribute>
             <attribute name="PersistDir">./schedule</attribute>
             <depends>
                 <!-- スケジュールマスタ1
                     08:00:00にFlow1を実行するスケジュール
                 -->
                 <service name="ScheduleMaster1"
                          code="jp.ossc.nimbus.service.scheduler2.DefaultScheduleMaster">
                     <attribute name="Id">Schedule1</attribute>
                     <attribute name="TaskName">Flow1</attribute>
                     <attribute name="StartTime">// 08:00:00 000</attribute>
                 </service>
             </depends>
             <depends>
                 <!-- スケジュールマスタ2
                     スケジュールマスタ1の終了を待って、08:00:00にFlow2を実行するスケジュール
                 -->
                 <service name="ScheduleMaster2"
                          code="jp.ossc.nimbus.service.scheduler2.DefaultScheduleMaster">
                     <attribute name="Id">Schedule2</attribute>
                     <attribute name="TaskName">Flow2</attribute>
                     <attribute name="StartTime">// 08:00:00 000</attribute>
                     <attribute name="Input">100</attribute>
                     <attribute name="Depends">Schedule1</attribute>
                 </service>
             </depends>
             <depends>
                 <!-- スケジュールマスタ3
                     スケジュールマスタ2の終了を待って、08:01:00から08:02:00まで5秒間隔にFlow3を実行するスケジュール
                 -->
                 <service name="ScheduleMaster3"
                          code="jp.ossc.nimbus.service.scheduler2.DefaultScheduleMaster">
                     <attribute name="Id">Schedule3</attribute>
                     <attribute name="TaskName">Flow3</attribute>
                     <attribute name="StartTime">// 08:01:00 000</attribute>
                     <attribute name="EndTime">// 08:02:00 000</attribute>
                     <attribute name="RepeatInterval">5000</attribute>
                     <attribute name="Depends">Schedule2</attribute>
                 </service>
             </depends>
             <depends>
                 <!-- スケジュールマスタ4
                     スケジュールマスタ1とスケジュールマスタ3の終了を待って、08:00:00から08:03:00までFlow4の結果でリトライを指示される限り、10秒間隔でFlow4を実行するスケジュール
                     08:03:00に達しても、リトライを指示された場合は、エラー終了する
                 -->
                 <service name="ScheduleMaster4"
                          code="jp.ossc.nimbus.service.scheduler2.DefaultScheduleMaster">
                     <attribute name="Id">Schedule4</attribute>
                     <attribute name="TaskName">Flow4</attribute>
                     <attribute name="StartTime">// 08:00:00 000</attribute>
                     <attribute name="Depends">Schedule1,Schedule3</attribute>
                     <attribute name="RetryInterval">10000</attribute>
                     <attribute name="RetryEndTime">// 08:03:00 000</attribute>
                 </service>
             </depends>
             
         </service>
         
         <!-- ScheduleExecuterサービス -->
         <service name="ScheduleExecutor"
                  code="jp.ossc.nimbus.service.scheduler2.BeanFlowScheduleExecutorService">
             <attribute name="ScheduleManagerServiceName">#ScheduleManager</attribute>
             <attribute name="BeanFlowInvokerFactoryServiceName">#BeanFlowInvokerFactory</attribute>
             <depends>ScheduleManager</depends>
             <depends>BeanFlowInvokerFactory</depends>
         </service>
         
         <!-- BeanFlowInvokerを生成するBeanFlowInvokerFactoryサービス -->
         <service name="BeanFlowInvokerFactory"
                  code="jp.ossc.nimbus.service.beancontrol.DefaultBeanFlowInvokerFactoryService">
             <attribute name="DirPaths">flows</attribute>
             <attribute name="BeanFlowInvokerAccessClass">jp.ossc.nimbus.service.beancontrol.BeanFlowInvokerAccessImpl2</attribute>
             <attribute name="Validate">true</attribute>
         </service>
         
     </manager>
     
 </server>

以下に、クラスタ構成でActive-Active構成の場合の、サービス定義を示します。

 <?xml version="1.0" encoding="Shift_JIS"?>
 <!DOCTYPE server PUBLIC
   "-//Nimbus//DTD Nimbus 1.0//JA"
   "http://nimbus.sourceforge.jp/dtd/nimbus-service_1_0.dtd">
 
 <server>
     
     <manager>
         
         <!-- スケジューラサービス -->
         <service name="Scheduler"
                  code="jp.ossc.nimbus.service.scheduler2.DefaultSchedulerService">
             <attribute name="ScheduleManagerServiceName">#ScheduleManager</attribute>
             <attribute name="ScheduleExecutorServiceName">#ScheduleExecutor</attribute>
             <attribute name="ScheduleDispatcherSize">5</attribute>
             
             <!-- 実行キーを設定する -->
             <attribute name="ExecutorKey">
                 <invoke name="getHostName"><target><static-invoke code="java.net.InetAddress" name="getLocalHost"/></target></invoke> 
             </attribute>
             
             <depends>ScheduleManager</depends>
             <depends>ScheduleExecutor</depends>
             
         </service>
         
         <!-- ScheduleManagerサービス -->
         <service name="ScheduleManager"
                  code="jp.ossc.nimbus.service.scheduler2.DatabaseScheduleManagerService">
             <attribute name="ConnectionFactoryServiceName">#ConnectionFactory</attribute>
             <attribute name="SequenceServiceName">#Sequence</attribute>
             
             <!-- 実行可能スケジュールを検索する際にレコードをロックするかどうかを設定する -->
             <attribute name="LockForFindExecutable">true</attribute>
             
             <depends>ConnectionFactory</depends>
             <depends>Sequence</depends>
         </service>
         
         <!-- JDBCドライバ経由でConnectionを取得するConnectionFactoryサービス -->
         <service name="ConnectionFactory"
                  code="jp.ossc.nimbus.service.connection.JDBCConnectionFactoryService">
             <attribute name="DriverName">oracle.jdbc.driver.OracleDriver</attribute>
             <attribute name="ConnectionURL">jdbc:oracle:thin:@192.174.1.11:1521:SAMPLE</attribute>
             <attribute name="UserName">hgoe</attribute>
             <attribute name="Password">fuga</attribute>
         </service>
         
         <!-- 通番を発行するSequenceサービス -->
         <service name="Sequence"
                  code="jp.ossc.nimbus.service.sequence.StringSequenceService">
             <attribute name="Format">TIME_SEQ(yyyyMMdd,5)</attribute>
         </service>
         
         <!-- ScheduleExecuterサービス -->
         <service name="ScheduleExecutor"
                  code="jp.ossc.nimbus.service.scheduler2.BeanFlowScheduleExecutorService">
             <attribute name="ScheduleManagerServiceName">#ScheduleManager</attribute>
             <attribute name="BeanFlowInvokerFactoryServiceName">#BeanFlowInvokerFactory</attribute>
             <depends>ScheduleManager</depends>
             <depends>BeanFlowInvokerFactory</depends>
         </service>
         
         <!-- BeanFlowInvokerを生成するBeanFlowInvokerFactoryサービス -->
         <service name="BeanFlowInvokerFactory"
                  code="jp.ossc.nimbus.service.beancontrol.DefaultBeanFlowInvokerFactoryService">
             <attribute name="DirPaths">flows</attribute>
             <attribute name="BeanFlowInvokerAccessClass">jp.ossc.nimbus.service.beancontrol.BeanFlowInvokerAccessImpl2</attribute>
             <attribute name="Validate">true</attribute>
         </service>
         
     </manager>
     
 </server>

以下に、クラスタ構成でActive-Standby構成の場合の、サービス定義を示します。

 <?xml version="1.0" encoding="Shift_JIS"?>
 <!DOCTYPE server PUBLIC
   "-//Nimbus//DTD Nimbus 1.0//JA"
   "http://nimbus.sourceforge.jp/dtd/nimbus-service_1_0.dtd">
 
 <server>
     
     <manager>
         
         <!-- スケジューラサービス -->
         <service name="Scheduler"
                  code="jp.ossc.nimbus.service.scheduler2.DefaultSchedulerService">
             <attribute name="ScheduleManagerServiceName">#ScheduleManager</attribute>
             <attribute name="ScheduleExecutorServiceName">#ScheduleExecutor</attribute>
             <attribute name="ScheduleDispatcherSize">5</attribute>
             
             <!-- クラスタサービスのサービス名を設定する -->
             <attribute name="ClusterServiceName">#Cluster</attribute>
             
             <depends>ScheduleManager</depends>
             <depends>ScheduleExecutor</depends>
             <depends>Cluster</depends>
         </service>
         
         <!-- ScheduleManagerサービス -->
         <service name="ScheduleManager"
                  code="jp.ossc.nimbus.service.scheduler2.DatabaseScheduleManagerService">
             <attribute name="ConnectionFactoryServiceName">#ConnectionFactory</attribute>
             <attribute name="SequenceServiceName">#Sequence</attribute>
             
             <!-- クラスタサービスのサービス名を設定する -->
             <attribute name="ClusterServiceName">#Cluster</attribute>
             
             <depends>ConnectionFactory</depends>
             <depends>Sequence</depends>
             <depends>Cluster</depends>
         </service>
         
         <!-- JDBCドライバ経由でConnectionを取得するConnectionFactoryサービス -->
         <service name="ConnectionFactory"
                  code="jp.ossc.nimbus.service.connection.JDBCConnectionFactoryService">
             <attribute name="DriverName">oracle.jdbc.driver.OracleDriver</attribute>
             <attribute name="ConnectionURL">jdbc:oracle:thin:@192.174.1.11:1521:SAMPLE</attribute>
             <attribute name="UserName">hgoe</attribute>
             <attribute name="Password">fuga</attribute>
         </service>
         
         <!-- 通番を発行するSequenceサービス -->
         <service name="Sequence"
                  code="jp.ossc.nimbus.service.sequence.StringSequenceService">
             <attribute name="Format">TIME_SEQ(yyyyMMdd,5)</attribute>
         </service>
         
         <!-- クラスタ化されたScheduleExecuterを呼び出すプロキシサービス -->
         <service name="ScheduleExecutor"
                  code="jp.ossc.nimbus.service.proxy.RemoteClientService">
             <attribute name="RemoteInterfaceClassName">jp.ossc.nimbus.service.scheduler2.ScheduleExecutor</attribute>
             <attribute name="InvokerServiceName">#ClusterInvoker</attribute>
             <depends>ClusterInvoker</depends>
             <depends>LocalScheduleExecutor</depends>
         </service>
         
         <!-- クラスタ呼び出しサービス -->
         <service name="ClusterInvoker"
                  code="jp.ossc.nimbus.service.scheduler2.ScheduleExecutorClusterInvokerService">
             <attribute name="KeepAliveCheckerSelectorServiceName">#KeepAliveCheckerSelector</attribute>
             <depends>KeepAliveCheckerSelector</depends>
         </service>
         
         <!-- 生存監視サービス -->
         <service name="KeepAliveCheckerSelector"
                  code="jp.ossc.nimbus.service.keepalive.RoundRobinKeepAliveCheckerSelectorService">
             <attribute name="ClusterServiceName">#Cluster</attribute>
             <depends>Cluster</depends>
         </service>
         
         <!-- クラスタサービス -->
         <service name="Cluster"
                  code="jp.ossc.nimbus.service.keepalive.ClusterService">
             <attribute name="LocalAddress">0.0.0.0</attribute>
             <attribute name="MulticastGroupAddress">239.0.0.10</attribute>
             <attribute name="HeartBeatRetryCount">2</attribute>
             <attribute name="JoinOnStart">false</attribute>
         </service>
         
         <!-- ローカルのScheduleExecuterサービス -->
         <service name="LocalScheduleExecutor"
                  code="jp.ossc.nimbus.service.scheduler2.BeanFlowScheduleExecutorService">
             <attribute name="ScheduleManagerServiceName">#ScheduleManager</attribute>
             <attribute name="BeanFlowInvokerFactoryServiceName">#BeanFlowInvokerFactory</attribute>
             
             <!-- 実行キーを設定する -->
             <attribute name="ExecutorKey">
                 <invoke name="getHostName"><target><static-invoke code="java.net.InetAddress" name="getLocalHost"/></target></invoke> 
             </attribute>
             
             <depends>ScheduleManager</depends>
             <depends>BeanFlowInvokerFactory</depends>
         </service>
         
         <!-- BeanFlowInvokerを生成するBeanFlowInvokerFactoryサービス -->
         <service name="BeanFlowInvokerFactory"
                  code="jp.ossc.nimbus.service.beancontrol.DefaultBeanFlowInvokerFactoryService">
             <attribute name="DirPaths">flows</attribute>
             <attribute name="BeanFlowInvokerAccessClass">jp.ossc.nimbus.service.beancontrol.BeanFlowInvokerAccessImpl2</attribute>
             <attribute name="Validate">true</attribute>
         </service>
         
     </manager>
     
 </server>

スケジューラ/高機能スケジューラ/Scheduler

nimbus (1.2.4)	2018-01-25 20:02
nimbus-sample (1.2.4)	2018-01-26 17:06

Nimbus

最近の更新 (Recent Changes)

2019-08-28

2019-08-27

Neueste Datei-Release

Wikiガイド(Guide)

サイドバー (Side Bar)

Scheduler実装サービス jp.ossc.nimbus.service.scheduler2.DefaultSchedulerService