モジュール 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
関連項目:
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
      属性名と属性の値のマッピングです。

  • コンストラクタの詳細

    • 属性

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

    • 属性

      public Attributes​(int size)
      指定された初期サイズで、新しい空のAttributesオブジェクトを構築します。
      パラメータ:
      size - 属性の初期番号

    • 属性

      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
      戻り値:
      このオブジェクトのハッシュ・コード値。
      関連項目:
      Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

    • clone

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