モジュール java.base
パッケージ 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
    関連項目:
    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)
      指定されたAttributesオブジェクトとこの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ビューを返します。

    • フィールドの詳細

      • 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)
        指定されたAttributesオブジェクトとこのMapが等しいかどうかを比較します。 指定されたオブジェクトがAttributesのインスタンスであり、2つのAttributesオブジェクトが同じマッピングを示す場合はtrueを返します。
        定義:
        インタフェースMap<Object,​Object>内のequals
        オーバーライド:
        equals、クラスObject
        パラメータ:
        o - 比較対象のObject
        戻り値:
        指定されたObjectがこのMapと等しい場合はtrue
        関連項目:
        Object.hashCode()、HashMap

      • clone

        public Object clone()
        次のように実装された、Attributesのコピーを返します。 
             public Object clone() { return new Attributes(this); }
        属性名および値はそれら自身が不変なので、返されたAttributesは、元のAttributesに影響を及ぼさずに安全に変更できます。
        オーバーライド:
        clone、クラスObject
        戻り値:
        このインスタンスの複製。
        関連項目:
        Cloneable