openGionopenGion
5.6.1.0

org.opengion.fukurou.util
クラス Attributes

java.lang.Object
  上位を拡張 org.opengion.fukurou.util.Attributes

public final class Attributes
extends java.lang.Object

Attributes.java は、String 型キーにString型値を Map するクラスです。 HTMLのPOST/GET等の受け渡しや、String型の引数が多い場合に効果があります。 特に、getAttributes( String[] param ) による属性リスト作成は、 HTMLタグの属性定義を行う上で,非常に便利に利用できます。 この実装は同期化されません。

バージョン
4.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

コンストラクタの概要
Attributes()
          デフォルトコンストラクター
Attributes(Attributes att)
          Attributesオブジェクト を与えて新しく作成するコンストラクター
 
メソッドの概要
 void add(java.lang.String key, java.lang.String value)
          指定された値と指定されたキーをこのマップに追加します マップ自身のキーは、ユニークである為、既存の値に対して、 新しく値を追加します。
 void add(java.lang.String key, java.lang.String value, java.lang.String sepa)
          指定された値と指定されたキーをこのマップに追加します マップ自身のキーは、ユニークである為、既存の値に対して、 新しく値を追加します。
 void addAttributes(Attributes att)
          Attributes 属性を、既存の属性に追加します。
 void clear()
          マップからマッピングをすべて削除します 。
 java.lang.String get(java.lang.String key)
          マップが指定のキーをマップする値を返します。
 java.lang.String getAttribute()
          マップに含まれているキーと属性のペアを タグの属性リストの形式ですべて返します。
 java.lang.String getAttribute(java.lang.String[] keys)
          マップに含まれているキーと属性のペアを タグの属性リストの形式で返します。
 java.lang.String[] getKeyArray()
          マップに含まれているキーの配列を返します。
 java.lang.String remove(java.lang.String key)
          このキーにマッピングがある場合に、そのマッピングをマップから削除します
 void set(java.lang.String key, java.lang.String value)
          指定された値と指定されたキーをこのマップに関連付けます 指定されたキーに、null を関連付けることはできません。
 void set(java.lang.String key, java.lang.String value, java.lang.String def)
          指定された値と指定されたキーをこのマップに関連付けます set( String key,String value ) との違いは、value が null の場合に、def を代わりにセットすることです。
 int size()
          マップ内のキーと値のマッピングの数を返します。
 java.lang.String toString()
          このオブジェクトの文字列表現を返します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

Attributes

public Attributes()
デフォルトコンストラクター


Attributes

public Attributes(Attributes att)
Attributesオブジェクト を与えて新しく作成するコンストラクター

パラメータ:
att - Attributesオブジェクト
メソッドの詳細

clear

public void clear()
マップからマッピングをすべて削除します 。


get

public java.lang.String get(java.lang.String key)
マップが指定のキーをマップする値を返します。 マップがこのキーのマッピングを保持していない場合は null を返します。戻り値の null は、マップがキーのマッピングを 保持していないことを示すとはかぎりません。つまり、マップが 明示的にキーを null にマップすることもあります。

パラメータ:
key - 関連付けられた値が返されるキー(大文字小文字は同値)
戻り値:
マップが、指定されたキーにマッピングしている値。 このキーに対するマッピングがマップにない場合は null

set

public void set(java.lang.String key,
                java.lang.String value)
指定された値と指定されたキーをこのマップに関連付けます 指定されたキーに、null を関連付けることはできません。 (もちろん、"":ゼロストリング は登録できます。) なぜなら、getAttribute( String[] keys ) 等で値が null の キーは、取得できない為です。 また、すでに何らかの値がセットされている所に、null をセットした 場合は、前の値をなにも変更しません。 通常、値をクリアしたい場合は、 remove( String key ) を利用してください。

パラメータ:
key - 指定される値が関連付けられるキー(大文字小文字は同値)
value - 指定されるキーに関連付けられる値

set

public void set(java.lang.String key,
                java.lang.String value,
                java.lang.String def)
指定された値と指定されたキーをこのマップに関連付けます set( String key,String value ) との違いは、value が null の場合に、def を代わりにセットすることです。 ただし、value が null で、def も null の場合は、 なにもセットされません。

パラメータ:
key - 指定される値が関連付けられるキー(大文字小文字は同値)
value - 指定されるキーに関連付けられる値
def - value が null の場合にキーに関連付けられる値

add

public void add(java.lang.String key,
                java.lang.String value)
指定された値と指定されたキーをこのマップに追加します マップ自身のキーは、ユニークである為、既存の値に対して、 新しく値を追加します。 追加する方法は、値の文字列の結合です。このメソッドでは、 デフォルトのスペースで結合します。 値が null または、すでにそのキーに同一の値が関連付けられている場合は、 何もしません。

パラメータ:
key - 指定される値が関連付けられるキー(大文字小文字は同値)
value - 指定されるキーの値に、追加される値

add

public void add(java.lang.String key,
                java.lang.String value,
                java.lang.String sepa)
指定された値と指定されたキーをこのマップに追加します マップ自身のキーは、ユニークである為、既存の値に対して、 新しく値を追加します。 追加する方法は、値の文字列の結合です。このメソッドでは、 引数 sepa で文字列を結合します。 値が null または、sepa が null または、すでにそのキーに 同一の値が関連付けられている場合は、何もしません。

パラメータ:
key - 指定される値が関連付けられるキー(大文字小文字は同値)
value - 指定されるキーの値に、追加される値
sepa - 値を連結するときの文字列

addAttributes

public void addAttributes(Attributes att)
Attributes 属性を、既存の属性に追加します。 すでに同一キーの属性が存在している場合は,上書きで 置き換えます。 引数 att が null の場合は,何もしません。

パラメータ:
att - Attributes属性

remove

public java.lang.String remove(java.lang.String key)
このキーにマッピングがある場合に、そのマッピングをマップから削除します

パラメータ:
key - マッピングがマップから削除されるキー(大文字小文字は同値)
戻り値:
このキーにマッピングがある場合に、そのマッピングをマップから削除します 指定されたキーに関連した以前の値。key にマッピングがなかった場合は null。

size

public int size()
マップ内のキーと値のマッピングの数を返します。

戻り値:
インタフェース Map 内の size

getKeyArray

public java.lang.String[] getKeyArray()
マップに含まれているキーの配列を返します。 ここでは、キーの配列はソートして返します。

戻り値:
マップに含まれているキーの配列

getAttribute

public java.lang.String getAttribute(java.lang.String[] keys)
マップに含まれているキーと属性のペアを タグの属性リストの形式で返します。 key1="value1" key2="value2" key3="value3" .... の形式で、value が null の 場合は,key そのもののペアを出力しません。 value が空文字列 "" の場合は,key="" で出力します。 引数には,key として出力したい値を配列文字列で渡します。 これは、拡張性に乏しい(すべて出せば,属性項目の追加に対応できる。) 方法ですが、タグ毎に異なる属性のみを管理するには,厳格に出力 タグ属性を定義したいという思いから,導入しました。

パラメータ:
keys - 指定 key の配列文字列(大文字小文字は同値)
戻り値:
キーと属性のペアをタグの属性リストの形式で返します

getAttribute

public java.lang.String getAttribute()
マップに含まれているキーと属性のペアを タグの属性リストの形式ですべて返します。 なお、value が null の場合は,key そのもののペアを出力しません。 value が空文字列 "" の場合は,key="" で出力します。

戻り値:
キーと属性のペアをタグの属性リストの形式で返します

toString

public java.lang.String toString()
このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。

オーバーライド:
クラス java.lang.Object 内の toString
戻り値:
オブジェクトの文字列表現

openGion 5.6.1.0

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