14.2 アプリケーションプログラム上でのログ出力先の指定方法

アプリケーションプログラムからログの出力先を指定する方法を次に示します。

  1. Enterprise SearchのJavaインターフェース内のIwsSearchLoggerインターフェースを実装したログクラスを作成し,アプリケーションプログラムのログへメッセージを出力する処理を実装します。
  2. 1で作成したクラスのインスタンスを,IwsSearcherクラスのインスタンスに,検索実行前にセットします。

IwsSearchLoggerクラスには各ログ出力時に実行されるコールバックメソッド(errorwarninfodebugtrace)と,それぞれのコールバックメソッドを呼び出すかどうかを判定するコールバックメソッド(isErrorEnabledisWarnEnabledisInfoEnabledisDebugEnabledisTraceEnabled)が定義されています。

それぞれのコールバックメソッドを呼び出すかどうかを判定するコールバックメソッド(isErrorEnabledisWarnEnabledisInfoEnabledisDebugEnabledisTraceEnabled)でtrueを返したときだけ,ログ出力時に実行されるコールバックメソッド(errorwarninfodebugtrace)を呼び出します。ログを出力しない場合,それぞれのコールバックメソッドを呼び出すかどうかを判定するコールバックメソッド(isErrorEnabledisWarnEnabledisInfoEnabledisDebugEnabledisTraceEnabled)でfalseを返した方がEnterprise SearchのJavaインターフェースの処理性能が上がります。

アプリケーションプログラムを運用している間は,エラーログのみ出力する運用を推奨します。障害時の調査や,アプリケーションプログラム開発時の検索動作の確認に,エラー以外のログ情報を必要に応じて出力してください。