-------------------------------------------------------------------------------
 Phosphoresce ContentNotifier INSTALL
-------------------------------------------------------------------------------
                                                                     2006/10/12


■ 使用方法

  コマンドラインの第一引数に通知処理を行う為の各種定義がされているプロパティ
  ファイルを指定して実行を行うことで、定義に沿ったチェックが行わます。
  チェックされた結果通知対象となった場合にメールにて通知が行われます。

  ※ Laucherを使用する場合は第二引数が当アプリケーションの第一引数となります。


■ 起動処理情報定義プロパティファイル定義

□ 通知処理プロパティファイル(notifier.properties)

  notify.name
    通知処理名を定義します。

  notify.check.strategy
    チェック処理を委譲するクラスを定義します。

  notify.check.strategy.properties
    チェック処理を行うクラスが使用するプロパティファイルを定義します。

  notify.mail.properties
    メール送信処理の定義を行うプロパティファイルを定義します。

  notify.onerror.call
    通知処理中に例外が発生した場合にその旨を連絡するか真偽値で定義します。

  notify.onerror.address
    通知処理中に例外が発生した場合にその旨を連絡するアドレスを定義します。

  notify.onerror.stacktrace
    通知処理中に例外が発生した場合にトレース出力を真偽値で定義します。

  notify.onerror.logfile
    通知処理中に例外が発生した場合に出力するログファイル名を定義します。

  notify.onerror.subject(※)
    通知処理中に例外が発生した場合に送信するメールの題名を定義します。

  notify.onerror.message(※)
    通知処理中に例外が発生した場合に送信するメールのメッセージを定義します。

  ※ 本文内に以下の変数を記述することで動的に文章内に値が設定されます。
    ${timestamp}    "yyyy/MM/dd HH:mm:ss"形式の処理時刻
    ${date}         "yyyy/MM/dd"形式の処理日付
    ${time}         "HH:mm:ss"形式の処理時刻
    ${name}         notify.nameで定義した通知処理名
    ${logfile}      notify.onerror.logfileで定義したログファイル名

□ メール送信定義プロパティファイル(mail.properties)

  mail.debug
    メール送信時のデバッグを出力するか真偽値で定義します。

  mail.charset
    メール送信時の文字コードを定義します(ディフォルトはISO-2022-JP)。

  mail.smtp
    メール送信に使用するSMTPサーバを定義します。

  mail.address.from
    メール送信者アドレスを定義します。

  mail.address.to
    メール送信先アドレスを定義します、これは複数定義可能でカンマ区切りで定義します。

  mail.subject(※)
    メールの表題を定義します。

  mail.attach
    メールにファイルを添付する場合は定義します、これは複数定義可能でカンマ区切りで定義します。

  mail.template(※)
    メール本文を定義します。

  mail.template.file(※)
    メール本文を別ファイルとして用意する場合は定義します、mail.templateより優先されます。

  ※ 本文内に以下の変数を記述することで動的に文章内に値が設定されます(mail.template.fileについてはファイル内のテキストにおいて)。
    ${timestamp}    "yyyy/MM/dd HH:mm:ss"形式の送信時刻
    ${date}         "yyyy/MM/dd"形式の送信日付
    ${time}         "HH:mm:ss"形式の送信時刻

  launcher.debug       : 起動処理時にデバッグ情報を出力するか真偽値で定義します。
  launcher.library     : 参照するライブラリまたはパスを定義します(※)
  launcher.mainclass   : 起動するメインメソッドを持ったクラスを定義します。

  ※複数定義を行う場合はカンマ区切りで定義します。


■ チェック処理クラスについて
  org.phosphoresce.contentnotifier.strategy.CheckStrategyを実装したクラスを定義することが出来ます。
  これらのクラスは自由に作成することが出来、そのクラスに対してクラスパスを張ることで使用が可能です。
  また、ディフォルトのチェッククラスとして以下のクラスが用意されています。

□ ContentStringCheckStrategy
  これは指定されたテキストファイル内に特定の文字が含まれる場合に通知する為のクラスです。
  以下に示すプロパティ定義を元にチェック処理が実行されます。
  
  check.file       チェック対象ファイル
  check.string     チェックする文字列




--
                                            http://phosphoresce.sourceforge.jp/
                                   http://sourceforge.jp/projects/phosphoresce/
                                                              Hisanori Kitagawa

