パッケージ org.apache.commons.logging

インターフェース Log

すべての既知の実装クラス:
NoOpLog, SimpleLog
public interface Log
ロギング API を抽象化する単純なロギングインターフェース。LogFactory によって正常にインスタンス化するには、このインターフェースを実装するクラスに、このログの「名前」を表す単一の文字列パラメーターを受け取るコンストラクターが必要です。

Log で使用される 6 つのログレベルは（順番に）あります。

  1. トレース (最も深刻ではない)
  2. デバッグ
  3. 情報
  4. 警告
  5. エラー
  6. 致命的 (最も深刻な)
これらのログレベルの、基盤となるログシステムで使用される概念へのマッピングは、実装によって異なります。ただし、実装では、この順序付けが期待どおりに動作することを確認する必要があります。

多くの場合、パフォーマンスはロギングの問題です。適切なプロパティを調べることにより、コンポーネントはコストのかかる操作（ログに記録される情報の生成）を回避できます。

以下に例を示します。

    if (log.isDebugEnabled()) {
        ... do something expensive ...
        log.debug(theResult);
    }

基盤となるロギングシステムの構成は、通常、そのシステムでサポートされているメカニズムを介して、ロギング API の外部で行われます。

導入:
5.0
作成者:
Juergen Hoeller (for thespring-jclvariant)

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    debug(ObjectSE message)
    デバッグログレベルでメッセージを記録します。
    void
    debug(ObjectSE message, ThrowableSE t)
    エラーをデバッグログレベルで記録します。
    void
    error(ObjectSE message)
    エラーログレベルでメッセージを記録します。
    void
    error(ObjectSE message, ThrowableSE t)
    エラーログレベルでエラーを記録します。
    void
    fatal(ObjectSE message)
    致命的なログレベルでメッセージを記録します。
    void
    fatal(ObjectSE message, ThrowableSE t)
    致命的なログレベルでエラーを記録します。
    void
    info(ObjectSE message)
    情報ログレベルでメッセージを記録します。
    void
    info(ObjectSE message, ThrowableSE t)
    情報ログレベルでエラーを記録します。
    boolean
    isDebugEnabled()
    デバッグログは現在有効になっていますか？
    boolean
    isErrorEnabled()
    エラーログは現在有効になっていますか？
    boolean
    isFatalEnabled()
    致命的なログは現在有効になっていますか？
    boolean
    isInfoEnabled()
    情報ログは現在有効になっていますか？
    boolean
    isTraceEnabled()
    トレースロギングは現在有効ですか？
    boolean
    isWarnEnabled()
    警告ログは現在有効になっていますか？
    void
    trace(ObjectSE message)
    トレースログレベルでメッセージを記録します。
    void
    trace(ObjectSE message, ThrowableSE t)
    エラーをトレースログレベルで記録します。
    void
    warn(ObjectSE message)
    警告ログレベルでメッセージを記録します。
    void
    warn(ObjectSE message, ThrowableSE t)
    警告ログレベルでエラーを記録します。

  • メソッドの詳細

    • isFatalEnabled

      boolean isFatalEnabled()
      致命的なログは現在有効になっていますか？

      このメソッドを呼び出すと、ログレベルが致命的なレベルを超えている場合に、負荷の高い操作（String 連結など）を実行する必要がなくなります。

      戻り値:
      基になるロガーで致命的が有効になっている場合は true。

    • isErrorEnabled

      boolean isErrorEnabled()
      エラーログは現在有効になっていますか？

      ログレベルがエラー以上の場合に、このメソッドを呼び出して、負荷の高い操作（String 連結など）を実行する必要がないようにします。

      戻り値:
      基本となるロガーでエラーが有効になっている場合は true。

    • isWarnEnabled

      boolean isWarnEnabled()
      警告ログは現在有効になっていますか？

      このメソッドを呼び出すと、ログレベルが警告以上の場合に、負荷の高い操作（String 連結など）を実行する必要がなくなります。

      戻り値:
      基本となるロガーで警告が有効になっている場合は true。

    • isInfoEnabled

      boolean isInfoEnabled()
      情報ログは現在有効になっていますか？

      ログレベルが info よりも大きい場合に、このメソッドを呼び出して、負荷の高い操作（たとえば、String 連結）を実行する必要がないようにします。

      戻り値:
      基本となるロガーで情報が有効になっている場合は true。

    • isDebugEnabled

      boolean isDebugEnabled()
      デバッグログは現在有効になっていますか？

      ログレベルがデバッグ以上の場合に、このメソッドを呼び出して、負荷の高い操作（String 連結など）を実行する必要がないようにします。

      戻り値:
      基本となるロガーでデバッグが有効になっている場合は true。

    • isTraceEnabled

      boolean isTraceEnabled()
      トレースロギングは現在有効ですか？

      ログレベルがトレース以上の場合に、このメソッドを呼び出して、負荷の高い操作（String 連結など）を実行する必要をなくします。

      戻り値:
      基本となるロガーでトレースが有効になっている場合は true。

    • fatal

      void fatal(ObjectSE message)
      致命的なログレベルでメッセージを記録します。
      パラメーター:
      message - このメッセージをログに記録する

    • fatal

      void fatal(ObjectSE message, ThrowableSE t)
      致命的なログレベルでエラーを記録します。
      パラメーター:
      message - このメッセージをログに記録する
      t - この原因を記録する

    • error

      void error(ObjectSE message)
      エラーログレベルでメッセージを記録します。
      パラメーター:
      message - このメッセージをログに記録する

    • error

      void error(ObjectSE message, ThrowableSE t)
      エラーログレベルでエラーを記録します。
      パラメーター:
      message - このメッセージをログに記録する
      t - この原因を記録する

    • warn

      void warn(ObjectSE message)
      警告ログレベルでメッセージを記録します。
      パラメーター:
      message - このメッセージをログに記録する

    • warn

      void warn(ObjectSE message, ThrowableSE t)
      警告ログレベルでエラーを記録します。
      パラメーター:
      message - このメッセージをログに記録する
      t - この原因を記録する

    • info

      void info(ObjectSE message)
      情報ログレベルでメッセージを記録します。
      パラメーター:
      message - このメッセージをログに記録する

    • info

      void info(ObjectSE message, ThrowableSE t)
      情報ログレベルでエラーを記録します。
      パラメーター:
      message - このメッセージをログに記録する
      t - この原因を記録する

    • debug

      void debug(ObjectSE message)
      デバッグログレベルでメッセージを記録します。
      パラメーター:
      message - このメッセージをログに記録する

    • debug

      void debug(ObjectSE message, ThrowableSE t)
      エラーをデバッグログレベルで記録します。
      パラメーター:
      message - このメッセージをログに記録する
      t - この原因を記録する

    • trace

      void trace(ObjectSE message)
      トレースログレベルでメッセージを記録します。
      パラメーター:
      message - このメッセージをログに記録する

    • trace

      void trace(ObjectSE message, ThrowableSE t)
      エラーをトレースログレベルで記録します。
      パラメーター:
      message - このメッセージをログに記録する
      t - この原因を記録する