org.opengion.fukurou.fileexec

## クラス DirWatch

- java.lang.Object
- - org.opengion.fukurou.fileexec.DirWatch

- すべての実装されたインタフェース:
    java.lang.Runnable

      public class DirWatch
      extends java.lang.Object
      implements java.lang.Runnable

       フォルダに残っているファイルを再実行するためのプログラムです。

       通常は、FileWatch で、パスを監視していますが、場合によっては、
       イベントを拾いそこねることがあります。それを、フォルダスキャンして、拾い上げます。
       １０秒間隔で繰り返しスキャンします。条件は、３０秒以上前のファイルです。

  変更履歴:

    7.0.0.0 (2017/07/07) 新規作成

  バージョン
    7.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK1.8,

- - ### フィールドのサマリー

    フィールド
    修飾子とタイプ | フィールドと説明
    --- | ---
    `static long` | `INIT_DELAY` 最初にスキャンを実行するまでの遅延時間(秒) の初期値
    `static long` | `PERIOD` スキャンする間隔(秒) の初期値
    `static long` | `TIME_DIFF` ファイルのタイムスタンプとの差のチェック(秒) の初期値
    `static java.lang.String` | `USAGE` main メソッドから呼ばれる ヘルプメッセージです。

  - ### コンストラクタのサマリー

    コンストラクタ
    コンストラクタと説明
    `DirWatch(java.nio.file.Path sPath)` スキャンパスを引数に作成される、コンストラクタです。
    `DirWatch(java.nio.file.Path sPath, boolean useTree)` スキャンパスと関数型インターフェースフォルダを引数に作成される、コンストラクタです。

  - ### メソッドのサマリー

    すべてのメソッド staticメソッド インスタンス・メソッド concreteメソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `void` | `callback(java.util.function.Consumer act)` ファイルパスを、引数に取る Consumer ダオブジェクトを設定します。
    `static void` | `main(java.lang.String[] args)` 引数に監視対象のフォルダと、拡張子を指定します。
    `void` | `run()` Runnableインターフェースのrunメソッドです。
    `void` | `setPathEndsWith(java.lang.String[] endKey)` 指定のパスが、指定の文字列と、終端一致(endsWith) したパスのみ、callback されます。
    `void` | `setPathMatcher(java.nio.file.PathMatcher pathMch)` 指定のパスの照合操作で、パターンに一致したパスのみ、callback されます。
    `void` | `start()` 内部でScheduledExecutorServiceを作成して、ScheduledFuture に、自身をスケジュールします。
    `void` | `start(long initDelay, long period, long timeDiff)` 内部でScheduledExecutorServiceを作成して、ScheduledFuture に、自身をスケジュールします。
    `void` | `stop()` 内部で作成した ScheduledFutureをキャンセルします。

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### フィールドの詳細

    - #### INIT_DELAY

          public static final long INIT_DELAY

      最初にスキャンを実行するまでの遅延時間(秒) の初期値
      関連項目:
        定数フィールド値

    - #### PERIOD

          public static final long PERIOD

      スキャンする間隔(秒) の初期値
      関連項目:
        定数フィールド値

    - #### TIME_DIFF

          public static final long TIME_DIFF

      ファイルのタイムスタンプとの差のチェック(秒) の初期値
      関連項目:
        定数フィールド値

    - #### USAGE

          public static final java.lang.String USAGE

      main メソッドから呼ばれる ヘルプメッセージです。 "Usage: java jp.euromap.eu63.util.DirWatch dir [-SF sufix]... [-S] [-D delay(s)] [-P period(s)] [-T timeDiff(s)]"
      関連項目:
        定数フィールド値

  - ### コンストラクタの詳細

    - #### DirWatch

          public DirWatch(java.nio.file.Path sPath)

      スキャンパスを引数に作成される、コンストラクタです。 ここでは、階層検索しない(useTree=false)で、インスタンス化します。
      パラメータ:
        `sPath` - 検索対象となるスキャンパス

    - #### DirWatch

          public DirWatch(java.nio.file.Path sPath,
                          boolean useTree)

      スキャンパスと関数型インターフェースフォルダを引数に作成される、コンストラクタです。
      パラメータ:
        `sPath` - 検索対象となるスキャンパス
        `useTree` - 階層スキャンするかどうか(true:する/false:しない)

  - ### メソッドの詳細

    - #### setPathMatcher

          public void setPathMatcher(java.nio.file.PathMatcher pathMch)

      指定のパスの照合操作で、パターンに一致したパスのみ、callback されます。 ここで指定したパターンの一致を判定し、一致した場合は、callback されます。 指定しない場合は、すべて許可されたことになります。 なお、#setPathEndsWith(String...) と、この設定は同時には行うことは出来ません。
      パラメータ:
        `pathMch` - パスの照合操作のパターン
      関連項目:
        `PathMatcher`, `setPathEndsWith(String...)`

    - #### setPathEndsWith

          public void setPathEndsWith(java.lang.String[] endKey)

      指定のパスが、指定の文字列と、終端一致(endsWith) したパスのみ、callback されます。 これは、#setPathMatcher(PathMatcher) の簡易指定版です。 指定の終端文字列(一般には拡張子)のうち、ひとつでも一致すれば、true となりcallback されます。 指定しない場合(null)は、すべて許可されたことになります。 終端文字列の判定には、大文字小文字の区別を行いません。 なお、#setPathMatcher(PathMatcher) と、この設定は同時には行うことは出来ません。
      パラメータ:
        `endKey` - パスの終端一致のパターン
      関連項目:
        `setPathMatcher(PathMatcher)`

    - #### callback

          public void callback(java.util.function.Consumer act)

      ファイルパスを、引数に取る Consumer ダオブジェクトを設定します。 これは、関数型インタフェースなので、ラムダ式またはメソッド参照の代入先として使用できます。 イベントが発生したときの ファイルパス(監視フォルダで、resolveされた、正式なフルパス)を引数に、 accept(Path) メソッドが呼ばれます。
      パラメータ:
        `act` - 1つの入力(ファイルパス) を受け取る関数型インタフェース
      関連項目:
        `Consumer.accept(Object)`

    - #### start

          public void start()

      内部でScheduledExecutorServiceを作成して、ScheduledFuture に、自身をスケジュールします。 初期値( initDelay=5L , period=10L , timeDiff=30L ) で、 スキャンを開始します。 #start( 5L , 10L , 30L ) と同じです。

    - #### start

          public void start(long initDelay,
                            long period,
                            long timeDiff)

      内部でScheduledExecutorServiceを作成して、ScheduledFuture に、自身をスケジュールします。 スキャン開始の遅延時間と、スキャン間隔、ファイルのタイムスタンプとの比較を指定して、スキャンを開始します。 ファイルのタイムスタンプとの差とは、ある一定時間経過したファイルのみ、action をcall します。
      パラメータ:
        `initDelay` - 最初にスキャンを実行するまでの遅延時間(秒)
        `period` - スキャンする間隔(秒)
        `timeDiff` - ファイルのタイムスタンプとの差のチェック(秒)

    - #### stop

          public void stop()

      内部で作成した ScheduledFutureをキャンセルします。

    - #### run

          public void run()

      Runnableインターフェースのrunメソッドです。 規定のスケジュール時刻が来ると、呼ばれる runメソッドです。 ここで、条件に一致したPathオブジェクトが存在すれば、コンストラクタで渡した 関数型インターフェースがcallされます。
      定義:
        `run` インタフェース内 `java.lang.Runnable`
      変更履歴:

        6.8.2.2 (2017/11/02) ネットワークパスのチェックを行います。

    - #### main

          public static void main(java.lang.String[] args)

      引数に監視対象のフォルダと、拡張子を指定します。 スキャンパスの初期値は、起動ﾌｫﾙﾀﾞです。 -D 最初にスキャンを実行するまでの遅延時間(秒) -P スキャンする間隔(秒) -T ファイルのタイムスタンプとの差のチェック(秒) -S 階層スキャンする場合は、-S を付けます。 -SF ファイルの拡張子(後ろからのマッチング)を指定します。複数指定することが出来ます。 テストなので、６０秒後に、終了します。 "Usage: java jp.euromap.eu63.util.DirWatch dir [-SF sufix]... [-S] [-D delay(s)] [-P period(s)] [-T timeDiff(s)]"
      パラメータ:
        `args` - コマンド引数配列

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.