org.opengion.fukurou.system

## クラス ThrowUtil

- java.lang.Object
- - org.opengion.fukurou.system.ThrowUtil

-     public final class ThrowUtil
      extends java.lang.Object

       ThrowUtil.java は、共通的に使用される Throwable,Exception関連メソッドを集約した、クラスです。

       StringUtil にあったメソッドを、こちらに移動させました。

  変更履歴:

    6.4.2.0 (2016/01/29) 新規作成
    6.4.3.2 (2016/02/19) 全面書き換え

  機能分類
    ユーティリティ
  バージョン
    6.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK8.0,

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

    すべてのメソッド staticメソッド concreteメソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `static java.lang.String` | `ogStackTrace(java.lang.String msg, java.lang.Throwable th)` Throwable の printStackTrace() 結果の内、opengion に関する箇所だけを文字列に変換して返します。
    `static java.lang.String` | `ogStackTrace(java.lang.Throwable th)` Throwable の printStackTrace() 結果の内、opengion に関する箇所だけを文字列に変換して返します。
    `static java.lang.String` | `ogThrowMsg(java.lang.String msg)` 発生元を示すクラス、メソッド、行番号とともに、メッセージを合成した文字列を返します。
    `static java.lang.String` | `ogThrowMsg(java.lang.String msg, java.lang.Throwable th)` 発生元を示すクラス、メソッド、行番号とともに、メッセージを合成した文字列を返します。

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

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

- - ### メソッドの詳細

    - #### ogStackTrace

          public static java.lang.String ogStackTrace(java.lang.Throwable th)

      Throwable の printStackTrace() 結果の内、opengion に関する箇所だけを文字列に変換して返します。
      パラメータ:
        `th` - printStackTraceすべき元のThrowableオブジェクト
      戻り値:
        Throwableの詳細メッセージ( th.printStackTrace() )
      変更履歴:

        6.4.2.0 (2016/01/29) StringUtil にあったメソッドを移動。
        6.4.2.0 (2016/01/29) すべてのスタックトレースを行っていたが、絞り込みます。

    - #### ogStackTrace

          public static java.lang.String ogStackTrace(java.lang.String msg,
                                                      java.lang.Throwable th)

      Throwable の printStackTrace() 結果の内、opengion に関する箇所だけを文字列に変換して返します。 printStackTrace() すると、膨大なメッセージが表示されるため、その中の、"org.opengion" を 含む箇所だけを、抜粋します。 また、同じ内容のエラーも除外します。 先頭から、MIN_STACK_SIZE 行は、元のままのメッセージを出力します。 Throwable#getCause() で、再帰的に原因をさかのぼります。
      パラメータ:
        `msg` - 合成したいメッセージ
        `th` - 元のThrowableオブジェクト
      戻り値:
        Throwableの詳細メッセージ( StackTraceElement の抜粋 )
      変更履歴:

        5.7.2.0 (2014/01/10) 新規作成
        6.4.2.0 (2016/01/29) StringUtil にあったメソッドを移動し、msg 引数を追加。
        6.4.3.2 (2016/02/19) (通常try-with-resources文によって)抑制された例外も出力します。
        6.5.0.1 (2016/10/21) メッセージに、BuildNumber.ENGINE_INFO を含める。

    - #### ogThrowMsg

          public static java.lang.String ogThrowMsg(java.lang.String msg)

      発生元を示すクラス、メソッド、行番号とともに、メッセージを合成した文字列を返します。 通常、System.out.println() で済ましていたエラーメッセージに対して、 エラー発生場所を特定する為の情報を付与したメッセージを作成します。 発生場所の行番号は、このメソッド（実施は、オーバーロード先）で new Throwable して、取得します。 呼ぶ場所で、new Throwable() する代わりの簡易目祖度になります。
      パラメータ:
        `msg` - 合成したいメッセージ
      戻り値:
        発生元を示すクラス、メソッド、行番号とともに、メッセージを合成した文字列
      変更履歴:

        6.4.2.0 (2016/01/29) 新規作成。

    - #### ogThrowMsg

          public static java.lang.String ogThrowMsg(java.lang.String msg,
                                                    java.lang.Throwable th)

      発生元を示すクラス、メソッド、行番号とともに、メッセージを合成した文字列を返します。 通常、System.out.println() で済ましていたエラーメッセージに対して、 エラー発生場所を特定する為の情報を付与したメッセージを作成します。 行番号は、引数のThrowableの最初の情報のみ使用する為、通常は、このメソッドを 呼ぶ場所で、new Throwable() します。 発生クラスは、org.opengion か、org.apache.jsp.jsp を含む３行のみの簡易メッセージとします。
      パラメータ:
        `msg` - 合成したいメッセージ
        `th` - 元のThrowableオブジェクト
      戻り値:
        発生元を示すクラス、メソッド、行番号とともに、メッセージを合成した文字列
      変更履歴:

        6.3.6.1 (2015/08/28) 新規作成
        6.3.6.1 (2015/08/28) メッセージに、th.getLocalizedMessage() を含める。
        6.3.9.0 (2015/11/06) thのnullチェックを先に行う。
        6.4.2.0 (2016/01/29) StringUtil にあったメソッドを移動するとともに、メソッド名を、ogErrMsg → ogThrowMsg に変更。
        6.5.0.1 (2016/10/21) メッセージに、BuildNumber.ENGINE_INFO を含める。

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