クラス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文字を超えることはできません。 名前の後にはコロンと空白を付ける必要があります。結合された長さは72文字を超えません。 属性値には任意の文字を含めることができ、出力ストリームへの書込み時にUTF8にエンコードされます。 有効な属性名および値の詳細については、JARファイル仕様を参照してください。

このマップとそのビューには、LinkedHashMapと同様に、予測可能な反復順序、つまりキーがマップに挿入された順序があります。

導入されたバージョン:

1.2

外部仕様

• JARファイルの仕様

関連項目:

• Manifest

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
static class	Attributes.Name	Attributes.Nameクラスは、このMapに格納される属性名を表します。

インタフェースMapで宣言されたネストされたクラス/インタフェース

Map.Entry<K,V>

修飾子と型	インタフェース	説明
static interface	Map.Entry<K,V>	マップのエントリ(キーと値のペア)です。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected Map<Object,Object>	map	属性名と属性の値のマッピングです。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
Attributes()	デフォルトのサイズで、新しい空のAttributesオブジェクトを構築します。
Attributes(int size)	指定された初期サイズで、新しい空のAttributesオブジェクトを構築します。
Attributes(Attributes attr)	指定されたAttributesオブジェクトと同じ属性名と属性の値のマッピングで、新しい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)	指定されたオブジェクトを、等価性のために基礎となるmapと比較します。
Object	get(Object name)	指定された属性名の値を返します。属性名が見つからない場合はnullを返します。
String	getValue(String name)	文字列で指定された属性名の値を返します。属性が見つからない場合はnullを返します。
String	getValue(Attributes.Name name)	指定されたAttributes.Nameの値を返します。属性が見つからない場合はnullを返します。
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ビューを返します。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

インタフェースMapで宣言されたメソッド

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

修飾子と型	メソッド	説明
default Object	compute(Object key, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)	指定されたキーとその現在のマップされた値のマッピングをコンピュートしようとします。現在のマッピング(オプションの操作)がない場合はnullです。
default Object	computeIfAbsent(Object key, Function<? super Object, ? extends Object> mappingFunction)	指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、指定されたマッピング関数を使用してその値をコンピュートし、null (オプションの操作)でないかぎりこのマップに入力します。
default Object	computeIfPresent(Object key, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)	指定されたキーの値が存在し、null以外の場合は、キーとその現在のマップされた値(オプションの操作)を指定して、新しいマッピングのコンピュートを試みます。
default void	forEach(BiConsumer<? super Object, ? super Object> action)	このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。
default Object	getOrDefault(Object key, Object defaultValue)	指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合はdefaultValueを返します。
default Object	merge(Object key, Object value, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)	指定されたキーがまだ値に関連付けられていない場合、またはnullに関連付けられている場合は、指定されたnull以外の値(オプションの操作)に関連付けます。
default Object	putIfAbsent(Object key, Object value)	指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、そのキーは指定された値に関連付けられ、nullを返します。それ以外の場合は、現在の値(オプションの操作)を返します。
default boolean	remove(Object key, Object value)	指定されたキーが現在、指定された値(オプションの操作)にマップされている場合にのみ、そのキーのエントリを削除します。
default Object	replace(Object key, Object value)	指定されたキーのエントリが、現在値(オプションの操作)にマップされている場合にのみ、そのエントリを置換します。
default boolean	replace(Object key, Object oldValue, Object newValue)	指定された値(オプションの操作)に現在マップされている場合にのみ、指定されたキーのエントリを置換します。
default void	replaceAll(BiFunction<? super Object, ? super Object, ? extends Object> function)	すべてのエントリが処理されるか、関数が例外(オプションの操作)をスローするまで、各エントリの値を、そのエントリの指定された関数を呼び出した結果に置き換えます。

フィールド詳細

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 - attrが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)

指定されたオブジェクトを、等価性のために基礎となるmapと比較します。 指定されたオブジェクトもマップであり、2つのマップが同じマッピングを表す場合はtrueを返します。

定義:

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

オーバーライド:

equals、クラスObject

パラメータ:

o - 比較対象のObject

戻り値:

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

関連項目:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

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

定義:

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

オーバーライド:

hashCode、クラスObject

戻り値:

マップのハッシュ・コード値

関連項目:

• Map.Entry.hashCode()
• Object.equals(Object)
• Map.equals(Object)

clone

public Object clone()

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

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

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

オーバーライド:

clone、クラスObject

戻り値:

このインスタンスの複製。

関連項目:

• Cloneable