nablarch.core.log (NablarchApi)

Interface Summary
Interface	Description
Logger	ログを出力するインタフェース。ログ出力機能の実装毎に本インタフェースの実装クラスを作成する。
LoggerFactory	`Logger`を生成するインタフェース。ログ出力機能の実装毎に本インタフェースの実装クラスを作成する。 LoggerFactoryは、`LoggerManager`により生成、管理される。 `LoggerManager`は、初期処理においてLoggerFactoryの生成後に`LoggerFactory.initialize(LogSettings)`メソッド、終了処理においてLoggerFactoryを破棄する際に`LoggerFactory.terminate()`メソッドをそれぞれ1度だけ呼び出すので、 LoggerFactoryの初期処理と終了処理は複数スレッドから呼ばれることはない。
LogItem<CTX>	ログの出力項目を取得するインタフェース。

Class Summary
Class	Description
DateItemSupport<CTX>	日時を取得する出力項目の実装をサポートするクラス。
LoggerManager	ログ出力機能の全体を取りまとめるクラス。クラスローダ毎に設定で指定された`LoggerFactory`の生成、保持を行う。ログ出力機能の実装に依存する初期処理、終了処理、`Logger`の生成は`LoggerFactory`に委譲する。クラスローダ毎に`LoggerFactory`を保持するのは、クラスローダ階層により生じる問題に対応するためである。使用する`LoggerFactory`は、プロパティファイルに設定する。プロパティファイルのパスは、システムプロパティを使用して、”nablarch.log.filePath”をキーにファイルパスを指定する。このファイルパスは、クラスパスとファイルシステム上のパスのどちらを指定しても良い。ファイルパスの指定方法は、`FileUtil.getResource(String)`を参照すること。システムプロパティを指定しなかった場合は、クラスパス直下のlog.propertiesを使用する。プロパティファイルが存在しない場合は、例外を送出する。ログの出力先によってはリソースの確保と解放が必要となるため、本クラスは初期処理と終了処理を行う。初期処理は、初回の`Logger`の取得が行われるタイミングで本クラスが内部的に実行する。終了処理は、フレームワーク側で実行するタイミングを判断できないので、ログの出力要求を行うアプリケーション毎にアプリケーションの終了時に`LoggerManager.terminate()`メソッドを呼び出すこと。アプリケーションの終了時とは、例えばWebアプリケーションの場合であれば、 ServletContextListener#contextDestroyedメソッドが呼ばれるタイミングを想定している。
LogSettings	ログ出力機能の設定をロードして保持するクラス。
LogUtil.MaskingMapValueEditor	マップの値をマスキングするクラス。

Package nablarch.core.log Description

ログ出力機能を提供する。