my_util
クラス LogResource

java.lang.Object
  拡張my_util.LogResource

public class LogResource
extends java.lang.Object

ログを保管するシステム資源の管理を行うサポート・クラスです。

関連項目:
Log

フィールドの概要
protected  java.lang.String encoding
          ログを保管する資源への出力する際の文字エンコーディングの名前
protected  int opened_cnt
          このログ保管先資源を使用している Log インスタンスの数
protected  java.io.PrintStream out
          ログを保管する資源への出力先 PrintStream
 
メソッドの概要
protected static LogResource create(java.lang.String path, java.lang.String encoding)
          ログ保管先を登録します。
protected static void destroy(java.lang.String path)
          ログ保管先のシステム資源登録を取り消す。
static java.lang.String get_encoding(java.lang.String path)
          ログ保管先システム資源の文字エンコーディングを取得します。
static int get_resource_cnt()
          ログ保管先として使用している PrintStream の数を取得します。
static boolean is_registered(java.lang.String path)
          既に登録されているシステム資源かどうかを判定します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

out

protected java.io.PrintStream out
ログを保管する資源への出力先 PrintStream


encoding

protected java.lang.String encoding
ログを保管する資源への出力する際の文字エンコーディングの名前


opened_cnt

protected int opened_cnt
このログ保管先資源を使用している Log インスタンスの数

メソッドの詳細

create

protected static LogResource create(java.lang.String path,
                                    java.lang.String encoding)
                             throws java.lang.Exception
ログ保管先を登録します。登録に成功すると、ログ保管先への出力用 PrintStream が append モードかつ auto-flush モードでオープン されます。
指定されたログ保管先のオープンに失敗した場合、例外が発生します。

パラメータ:
path - ログを保管するシステム資源へのパス。 現在はファイルのみサポート
encoding - ログを保管するシステム資源へ出力する際の 文字エンコーディングの名前。ローカルシステムの デフォルト文字エンコーディングを指定する場合は null を指定する
戻り値:
  • 非 null - ログ保管先システム資源の管理情報
  • null - ログ保管先 path が null か空文字列の場合
例外:
java.io.FileNotFoundException - ログ保管先がディレクトリか オープンできないファイルの場合
java.lang.SecurityException - 書込み権限でオープンできない場合
UnsupportedExcodingException - 指定された文字エンコーディングがサポートされていない場合
java.lang.Exception - すでにオープンされたログ保管先 PrintStream の文字エンコーディングと encoding で指定されたものが 一致していない場合

destroy

protected static void destroy(java.lang.String path)
ログ保管先のシステム資源登録を取り消す。この資源を使用している Log がなければ、出力先 PrintStream がクローズされます。

パラメータ:
path - ログを保管するシステム資源へのパス。 現在はファイルのみサポート

get_resource_cnt

public static int get_resource_cnt()
ログ保管先として使用している PrintStream の数を取得します。


is_registered

public static boolean is_registered(java.lang.String path)
既に登録されているシステム資源かどうかを判定します。

パラメータ:
path - 判定するシステム資源へのパス
戻り値:
  • true 登録されている場合
  • false 登録されていない場合あるいはシステム資源 path が null の場合

get_encoding

public static java.lang.String get_encoding(java.lang.String path)
ログ保管先システム資源の文字エンコーディングを取得します。

パラメータ:
path - システム資源へのパス
戻り値:
  • null システムのデフォルト文字エンコーディングの 場合
  • 空文字列 ("") パスは登録されていない場合あるいは システム資源 path が null の場合
  • 上記以外 文字エンコーディングを示す >