JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。