ts.util.resource
クラス AbstractResource

java.lang.Object
  上位を拡張 ts.util.resource.AbstractResource
すべての実装されたインタフェース:
Resource
直系の既知のサブクラス:
DefaultResource, XmlResource

public abstract class AbstractResource
extends java.lang.Object
implements Resource

リソースクラスの抽象クラス。
リソースクラスに共通の実装を定義する。

バージョン:
$Revision: 1.1.1.1 $, $Date: 2010-10-16 00:03:48 $
作成者:
佐藤隆之.

フィールドの概要
 
インタフェース ts.util.resource.Resource から継承されたフィールド
EMPTY
 
コンストラクタの概要
AbstractResource()
          デフォルトコンストラクタ。
AbstractResource(AbstractResource res)
          コピーコンストラクタ。
 
メソッドの概要
 java.lang.String attributeMatchMark()
          キーの属性の名前と値を結び付ける文字を取得する。
 java.lang.String[] attributeParenthesis()
          キーの属性を囲む文字を取得する。
 java.lang.String attributeSeparator()
          キーの属性の区切り文字を取得する。
 java.lang.String elementSeparator()
          キーの要素の区切り文字を取得する。
 char getAttributeMatchMark()
          推奨されていません。 char変数の使用を避けるため廃止。代わりにattributeMatchMark()を使用して下さい。
 char[] getAttributeParenthesis()
          推奨されていません。 char変数の使用を避けるため廃止。代わりにattributeParenthesis()を使用して下さい。
 char getAttributeSeparator()
          推奨されていません。 char変数の使用を避けるため廃止。代わりにattributeSeparator()を使用して下さい。
 char getElementSeparator()
          推奨されていません。 char変数の使用を避けるため廃止。代わりにelementSeparator()を使用して下さい。
protected  java.io.InputStream getInputStream(java.lang.String path)
          指定されたパスから入力ストリームを取得する。
protected  java.lang.String getNameOfKeyElement(java.lang.String keyElem)
          指定されたキー要素の要素名を取得する。
protected  java.io.OutputStream getOutputStream(java.lang.String path)
          指定されたパスの出力ストリームを取得する。
 java.lang.String getPath()
          ロードしたリソースファイルのパスを取得する。
protected  java.util.List<java.lang.String[]> listAttributesOfKeyElement(java.lang.String keyElem)
          指定されたキー要素の属性の名前と値の組を列挙する。
protected abstract  void load(java.io.InputStream stream)
          引数の入力ストリームからリソースファイルの内容を読み込む。
 void load(java.lang.String path)
          指定されたパスのリソースファイルを読み込む。
protected abstract  void save(java.io.OutputStream stream)
          引数の出力ストリームに、このオブジェクトが保持している内容を保存する。
 void save(java.lang.String path)
          指定されたパスのファイルに、このオブジェクトが保持している内容を保存する。
protected  void setAttributeMatchMark(char mark)
          推奨されていません。 char変数の使用を避けるため廃止。代わりにsetAttributeMatchMark(String)を使用して下さい。
protected  void setAttributeMatchMark(java.lang.String mark)
          キーの属性の名前と値を結び付ける文字を設定する。
protected  void setAttributeParenthesis(char openPar, char closePar)
          推奨されていません。 char変数の使用を避けるため廃止。代わりにsetAttributeParenthesis(String,String)を使用して下さい。
protected  void setAttributeParenthesis(java.lang.String openPar, java.lang.String closePar)
          キーの属性を囲む文字を設定する。
protected  void setAttributeSeparator(char separator)
          推奨されていません。 char変数の使用を避けるため廃止。代わりにsetAttributeSeparator(char)を使用して下さい。
protected  void setAttributeSeparator(java.lang.String separator)
          キーの属性の区切り文字を設定する。
protected  void setElementSeparator(char separator)
          推奨されていません。 char変数の使用を避けるため廃止。代わりにsetElementSeparator(String)を使用して下さい。
protected  void setElementSeparator(java.lang.String separator)
          キーの要素の区切り文字を設定する。
protected  java.util.List<java.lang.String> splitKey(java.lang.String key)
          キーを要素ごとに分割する。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
インタフェース ts.util.resource.Resource から継承されたメソッド
getAttributes, getChildren, getFirstAttribute, getFirstChild, getFirstValue, getOrCreateFirstChild, getValues, removeChildren, setFirstValue
 

コンストラクタの詳細

AbstractResource

public AbstractResource()
デフォルトコンストラクタ。


AbstractResource

public AbstractResource(AbstractResource res)
コピーコンストラクタ。

パラメータ:
res - コピー元のリソースオブジェクト。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。
メソッドの詳細

setElementSeparator

@Deprecated
protected void setElementSeparator(char separator)
推奨されていません。 char変数の使用を避けるため廃止。代わりにsetElementSeparator(String)を使用して下さい。

キーの要素の区切り文字を設定する。

パラメータ:
separator - キーの要素の区切り文字。

setElementSeparator

protected void setElementSeparator(java.lang.String separator)
キーの要素の区切り文字を設定する。
引数の文字列が1文字でない場合は例外をスローする。

パラメータ:
separator - キーの要素の区切り文字。
例外:
java.lang.IllegalArgumentException - 引数の文字列が1文字でない場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)

getElementSeparator

@Deprecated
public char getElementSeparator()
推奨されていません。 char変数の使用を避けるため廃止。代わりにelementSeparator()を使用して下さい。

キーの要素の区切り文字を取得する。

戻り値:
キーの要素の区切り文字。

elementSeparator

public java.lang.String elementSeparator()
キーの要素の区切り文字を取得する。

戻り値:
キーの要素の区切り文字。

setAttributeParenthesis

@Deprecated
protected void setAttributeParenthesis(char openPar,
                                                  char closePar)
推奨されていません。 char変数の使用を避けるため廃止。代わりにsetAttributeParenthesis(String,String)を使用して下さい。

キーの属性を囲む文字を設定する。

パラメータ:
openPar - キーの属性を囲む開き括弧。
closePar - キーの属性を囲む閉じ括弧。

setAttributeParenthesis

protected void setAttributeParenthesis(java.lang.String openPar,
                                       java.lang.String closePar)
キーの属性を囲む文字を設定する。
引数の文字列が1文字でない場合は例外をスローする。

パラメータ:
openPar - キーの属性を囲む開き括弧。
closePar - キーの属性を囲む閉じ括弧。
例外:
java.lang.IllegalArgumentException - 引数の文字列が1文字でない場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)

getAttributeParenthesis

@Deprecated
public char[] getAttributeParenthesis()
推奨されていません。 char変数の使用を避けるため廃止。代わりにattributeParenthesis()を使用して下さい。

キーの属性を囲む文字を取得する。

戻り値:
キーの属性を囲む文字の配列。

attributeParenthesis

public java.lang.String[] attributeParenthesis()
キーの属性を囲む文字を取得する。

戻り値:
キーの属性を囲む文字の配列。

setAttributeSeparator

@Deprecated
protected void setAttributeSeparator(char separator)
推奨されていません。 char変数の使用を避けるため廃止。代わりにsetAttributeSeparator(char)を使用して下さい。

キーの属性の区切り文字を設定する。

パラメータ:
separator - キーの属性の区切り文字。

setAttributeSeparator

protected void setAttributeSeparator(java.lang.String separator)
キーの属性の区切り文字を設定する。
引数の文字列が1文字でない場合は例外をスローする。

パラメータ:
separator - キーの属性の区切り文字。
例外:
java.lang.IllegalArgumentException - 引数の文字列が1文字でない場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)

getAttributeSeparator

@Deprecated
public char getAttributeSeparator()
推奨されていません。 char変数の使用を避けるため廃止。代わりにattributeSeparator()を使用して下さい。

キーの属性の区切り文字を取得する。

戻り値:
キーの属性の区切り文字。

attributeSeparator

public java.lang.String attributeSeparator()
キーの属性の区切り文字を取得する。

戻り値:
キーの属性の区切り文字。

setAttributeMatchMark

@Deprecated
protected void setAttributeMatchMark(char mark)
推奨されていません。 char変数の使用を避けるため廃止。代わりにsetAttributeMatchMark(String)を使用して下さい。

キーの属性の名前と値を結び付ける文字を設定する。

パラメータ:
mark - キーの属性の名前と値を結び付ける文字。

setAttributeMatchMark

protected void setAttributeMatchMark(java.lang.String mark)
キーの属性の名前と値を結び付ける文字を設定する。
引数の文字列が1文字でない場合は例外をスローする。

パラメータ:
mark - キーの属性の名前と値を結び付ける文字。
例外:
java.lang.IllegalArgumentException - 引数の文字列が1文字でない場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグ・モードのみ)

getAttributeMatchMark

@Deprecated
public char getAttributeMatchMark()
推奨されていません。 char変数の使用を避けるため廃止。代わりにattributeMatchMark()を使用して下さい。

キーの属性の名前と値を結び付ける文字を取得する。

戻り値:
キーの属性の名前と値を結び付ける文字を取得する。

attributeMatchMark

public java.lang.String attributeMatchMark()
キーの属性の名前と値を結び付ける文字を取得する。

戻り値:
キーの属性の名前と値を結び付ける文字を取得する。

getNameOfKeyElement

protected java.lang.String getNameOfKeyElement(java.lang.String keyElem)
指定されたキー要素の要素名を取得する。
splitKeyメソッドによって分割されたキー要素から 要素名を取り出す。

パラメータ:
keyElem - キー要素。
戻り値:
要素名。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

listAttributesOfKeyElement

protected java.util.List<java.lang.String[]> listAttributesOfKeyElement(java.lang.String keyElem)
指定されたキー要素の属性の名前と値の組を列挙する。
splitKeyメソッドによって分割されたキー要素から 属性を取り出し、属性の名前と値の配列を列挙オブジェクトに格納して返す。

パラメータ:
keyElem - キー要素。
戻り値:
属性の名前と値の配列を格納した列挙オブジェクト。
例外:
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

splitKey

protected java.util.List<java.lang.String> splitKey(java.lang.String key)
                                             throws IllegalKeyException
キーを要素ごとに分割する。
分割する際にキーの書式の検証も行い、以下に反する場合に例外をスローする。

パラメータ:
key - キー。
例外:
IllegalKeyException - キーが不正な場合。

getPath

public java.lang.String getPath()
ロードしたリソースファイルのパスを取得する。
まだ一度もリソースファイルの読み込みを行っていない場合は、空文字列を返す。

戻り値:
ロードしたリソースファイルのパス。

load

public void load(java.lang.String path)
          throws java.io.FileNotFoundException,
                 java.io.IOException
指定されたパスのリソースファイルを読み込む。

パラメータ:
path - リソースファイルのパス。
例外:
java.io.FileNotFoundException - 指定されたパスのファイルが見つからなかった 場合。
java.io.IOException - ファイルの読み込み中に例外が発生した場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

getInputStream

protected java.io.InputStream getInputStream(java.lang.String path)
                                      throws java.io.FileNotFoundException,
                                             java.io.IOException
指定されたパスから入力ストリームを取得する。

パラメータ:
path - リソースファイルのパス。
戻り値:
引数のパスに対する入力ストリーム。
例外:
java.io.FileNotFoundException - 指定されたパスのファイルが見つからなかった 場合。
java.io.IOException - 入力ストリームのオープン時に例外が発生した場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

load

protected abstract void load(java.io.InputStream stream)
                      throws java.io.IOException
引数の入力ストリームからリソースファイルの内容を読み込む。

パラメータ:
stream - 入力ストリーム。
例外:
java.io.IOException - 読み込み中に例外が発生した場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

save

public void save(java.lang.String path)
          throws java.io.IOException
指定されたパスのファイルに、このオブジェクトが保持している内容を保存する。

パラメータ:
path - 保存先のファイルのパス。
例外:
java.io.IOException - ファイルの保存中に例外が発生した場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

getOutputStream

protected java.io.OutputStream getOutputStream(java.lang.String path)
                                        throws java.io.IOException
指定されたパスの出力ストリームを取得する。

パラメータ:
path - 保存先のファイルのパス。
戻り値:
引数のパスに対する出力ストリーム。
例外:
java.io.IOException - 指定されたパスのオープン時に例外が発生した場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

save

protected abstract void save(java.io.OutputStream stream)
                      throws java.io.IOException
引数の出力ストリームに、このオブジェクトが保持している内容を保存する。

パラメータ:
stream - 保存先の出力ストリーム。
例外:
java.io.IOException - ファイルの保存中に例外が発生した場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。


Copyright (C) SATOH Takayuki All Rights Reserved.