java.util.jar
クラス Attributes

java.lang.Object
  java.util.jar.Attributes

すべての実装されたインタフェース:

Cloneable, Map<Object,Object>

public class Attributes
extends Object
implements Map<Object,Object>, Cloneable

Attributes クラスは、Manifest 属性名を関連する文字列値にマッピングします。有効な属性名では、大文字と小文字が区別されません。また、[0-9a-zA-Z_-] セット内の ASCII 文字に制限され、70 文字を超えることはできません。属性値には任意の文字を含めることができ、出力ストリームへの書き込み時に UTF8 にエンコードされます。有効な属性名および値の詳細は、「JAR ファイルの仕様」を参照してください。

導入されたバージョン:

1.2

関連項目:

Manifest

入れ子のクラスの概要

static class

Attributes.Name Attributes.Name クラスは、この Map に格納される属性名を表します。

インタフェース java.util.Map から継承された入れ子のクラス/インタフェース

Map.Entry<K,V>

フィールドの概要

protected Map<Object,Object>

map 属性名と属性の値のマッピングです。

コンストラクタの概要

Attributes()
デフォルトのサイズで、新しい空の Attributes オブジェクトを構築します。

Attributes(Attributes attr)
指定された Attributes オブジェクトと同じ属性名と属性の値のマッピングで、新しい Attributes オブジェクトを構築します。

Attributes(int size)
指定された初期サイズで、新しい空の Attributes オブジェクトを構築します。

メソッドの概要

void	clear() この Map からすべての属性を削除します。
Object	clone() 次のように実装された、Attributes のコピーを返します。
boolean	containsKey(Object name) 指定された属性名 (キー) がこの Map に格納される場合に true を返します。
boolean	containsValue(Object value) この Map が 1 つ以上の属性名 (キー) を指定された値にマップしている場合に、true を返します。
Set<Map.Entry<Object,Object>>	entrySet() この Map に格納されている属性名と属性の値とのマッピングの Collection ビューを返します。
boolean	equals(Object o) 指定された Attributes オブジェクトとこの Map が等しいかどうかを比較します。
Object	get(Object name) 指定された属性名の値を返します。
String	getValue(Attributes.Name name) 指定された Attributes.Name の値を返します。
String	getValue(String name) 文字列で指定された属性名の値を返します。
int	hashCode() この Map のハッシュコード値を返します。
boolean	isEmpty() この Map に属性が格納されていない場合に true を返します。
Set<Object>	keySet() この Map に格納されている属性名 (キー) の Set ビューを返します。
Object	put(Object name, Object value) 指定された値と指定された属性名 (キー) をこのマップに関連付けます。
void	putAll(Map<?,?> attr) 指定された Attributes から、属性名と属性の値とのマッピングをすべてこの Map にコピーします。
String	putValue(String name, String value) 指定された値を、String として指定された属性名に関連付けます。
Object	remove(Object name) 指定された名前 (キー) を持つ属性を、この Map から削除します。
int	size() この Map にある属性の数を返します。
Collection<Object>	values() この Map に格納されている属性の値の Collection ビューを返します。

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

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

map

protected Map<Object,Object> map

属性名と属性の値のマッピングです。

コンストラクタの詳細

Attributes

public Attributes()

デフォルトのサイズで、新しい空の Attributes オブジェクトを構築します。

Attributes

public Attributes(int size)

指定された初期サイズで、新しい空の Attributes オブジェクトを構築します。

パラメータ:

size - 属性の初期番号

Attributes

public Attributes(Attributes attr)

指定された Attributes オブジェクトと同じ属性名と属性の値のマッピングで、新しい Attributes オブジェクトを構築します。

パラメータ:

attr - 指定された Attributes

メソッドの詳細

get

public Object get(Object name)

指定された属性名の値を返します。属性名が見つからない場合は null を返します。

定義:

インタフェース Map<Object,Object> 内の get

パラメータ:

name - 属性名

戻り値:

指定された属性名の値。見つからない場合は null

getValue

public String getValue(String name)

文字列で指定された属性名の値を返します。属性が見つからない場合は null を返します。属性名の大文字と小文字は区別されません。

このメソッドは、次のように定義されます。

            return (String)get(new Attributes.Name((String)name));
 

パラメータ:

name - 属性名の文字列

戻り値:

指定された属性名の String 値。見つからない場合は null

例外:

IllegalArgumentException - 属性名が無効な場合

getValue

public String getValue(Attributes.Name name)

指定された Attributes.Name の値を返します。属性が見つからない場合は null を返します。

このメソッドは、次のように定義されます。

return (String)get(name);
 

パラメータ:

name - Attributes.Name オブジェクト

戻り値:

指定された Attribute.Name の String 値。見つからない場合は null

put

public Object put(Object name,
                  Object value)

指定された値と指定された属性名 (キー) をこのマップに関連付けます。属性名へのマッピングがすでに Map にある場合は、以前からある値が置き換えられます。

定義:

インタフェース Map<Object,Object> 内の put

パラメータ:

name - 属性名

value - 属性値

戻り値:

属性の以前の値。値がない場合は null

例外:

ClassCastException - 名前が Attributes.Name でない場合、あるいは値が String ではない場合

putValue

public String putValue(String name,
                       String value)

指定された値を、String として指定された属性名に関連付けます。指定される属性名では、大文字と小文字を区別しません。属性名へのマッピングがすでに Map にある場合は、以前からある値が置き換えられます。

このメソッドは、次のように定義されます。

            return (String)put(new Attributes.Name(name), value);
 

パラメータ:

name - 属性名の文字列

value - 属性値

戻り値:

属性の以前の値。値がない場合は null

例外:

IllegalArgumentException - 属性名が無効な場合

remove

public Object remove(Object name)

指定された名前 (キー) を持つ属性を、この Map から削除します。以前からある値を返します。値がない場合は null を返します。

定義:

インタフェース Map<Object,Object> 内の remove

パラメータ:

name - 属性名

戻り値:

属性の以前の値。値がない場合は null

containsValue

public boolean containsValue(Object value)

この Map が 1 つ以上の属性名 (キー) を指定された値にマップしている場合に、true を返します。

定義:

インタフェース Map<Object,Object> 内の containsValue

パラメータ:

value - 属性値

戻り値:

この Map が 1 つ以上の属性名を指定された値にマップしている場合は true

containsKey

public boolean containsKey(Object name)

指定された属性名 (キー) がこの Map に格納される場合に true を返します。

定義:

インタフェース Map<Object,Object> 内の containsKey

パラメータ:

name - 属性名

戻り値:

指定された属性名がこの Map に格納される場合は true

putAll

public void putAll(Map<?,?> attr)

指定された Attributes から、属性名と属性の値とのマッピングをすべてこの Map にコピーします。重複するマッピングは置き換えられます。

定義:

インタフェース Map<Object,Object> 内の putAll

パラメータ:

attr - このマップに格納される Attributes

例外:

ClassCastException - 属性が Attributes ではない場合

clear

public void clear()

この Map からすべての属性を削除します。

定義:

インタフェース Map<Object,Object> 内の clear

size

public int size()

この Map にある属性の数を返します。

定義:

インタフェース Map<Object,Object> 内の size

戻り値:

マップ内のキーと値のマッピングの数

isEmpty

public boolean isEmpty()

この Map に属性が格納されていない場合に true を返します。

定義:

インタフェース Map<Object,Object> 内の isEmpty

戻り値:

マップがキーと値のマッピングを保持しない場合は true

keySet

public Set<Object> keySet()

この Map に格納されている属性名 (キー) の Set ビューを返します。

定義:

インタフェース Map<Object,Object> 内の keySet

戻り値:

マップに含まれているキーのセットビュー

values

public Collection<Object> values()

この Map に格納されている属性の値の Collection ビューを返します。

定義:

インタフェース Map<Object,Object> 内の values

戻り値:

マップ内に含まれている値のコレクションビュー

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

この Map に格納されている属性名と属性の値とのマッピングの Collection ビューを返します。

定義:

インタフェース Map<Object,Object> 内の entrySet

戻り値:

マップ内に保持されているマッピングのセットビュー

equals

public boolean equals(Object o)

指定された Attributes オブジェクトとこの Map が等しいかどうかを比較します。指定されたオブジェクトが Attributes のインスタンスであり、2 つの Attributes オブジェクトが同じマッピングを示す場合は true を返します。

定義:

インタフェース Map<Object,Object> 内の equals

オーバーライド:

クラス Object 内の equals

パラメータ:

o - 比較対象の Object

戻り値:

指定された Object がこの Map と等しい場合は true

関連項目:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

この Map のハッシュコード値を返します。

定義:

インタフェース Map<Object,Object> 内の hashCode

オーバーライド:

クラス Object 内の hashCode

戻り値:

このオブジェクトのハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable

clone

public Object clone()

次のように実装された、Attributes のコピーを返します。

public Object clone() { return new Attributes(this); }
 

属性名および値はそれら自身が不変なので、返された Attributes は、元の Attributes に影響を及ぼさずに安全に変更できます。

オーバーライド:

クラス Object 内の clone

戻り値:

このインスタンスの複製

関連項目:

Cloneable