モジュール java.base

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

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

導入されたバージョン:

1.2

外部仕様

• JARファイルの仕様

関連項目:

• Manifest

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

ネストされたクラス

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

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

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ビューを返します。

クラスjava.lang.Objectで宣言されたメソッド

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

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

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

フィールド詳細

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