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 File Specification。

從以下版本開始：

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 的副本，實作方法如下: public Object clone() { return new Attributes(this); } 由於屬性名稱和值本身不可變，因此可以安全地修改返回的 Attributes，而不會影響原始值。
boolean	containsKey(Object name) 如果此 Map 套件含指定的屬性名稱（鍵），則返回 true。
boolean	containsValue(Object value) 如果此 Map 將一個或多個屬性名稱（鍵）映射到指定值，則返回 true。
Set<Map.Entry<Object,Object>>	entrySet() 返回此 Map 所包含的屬性名稱-值映射關係的 Collection 視圖。
boolean	equals(Object o) 將指定的 Attributes 物件與此 Map 進行相等性比較。
Object	get(Object name) 返回指定的屬性名稱的值，如果未找到屬性名稱，則返回 null。
String	getValue(Attributes.Name name) 返回指定的 Attributes.Name 的值，如果未找到，則返回 null。
String	getValue(String name) 返回指定屬性名稱的值，如果未找到，則返回 null。
int	hashCode() 返回此 Map 的雜湊碼值。
boolean	isEmpty() 如果此 Map 不包含屬性，則返回 true。
Set<Object>	keySet() 返回此 Map 所包含的屬性名稱（鍵）的 Set 視圖。
Object	put(Object name, Object value) 在此 Map 中將指定的值關聯到指定的屬性名稱（鍵）。
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 以前包含了屬性名稱的映射關係，則舊值將被替換。

指定者：

介面 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 將一個或多個屬性名稱（鍵）映射到指定值，則返回 true。

指定者：

介面 Map<Object,Object> 中的 containsValue

參數：

value - 屬性值

返回：

如果此 Map 將一個或多個屬性名稱映射到指定值，則返回 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

返回：

此映射中包含的鍵的 set 視圖

values

public Collection<Object> values()

返回此 Map 所包含的屬性值的 Collection 視圖。

指定者：

介面 Map<Object,Object> 中的 values

返回：

此映射中包含的值的 collection 視圖

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

返回此 Map 所包含的屬性名稱-值映射關係的 Collection 視圖。

指定者：

介面 Map<Object,Object> 中的 entrySet

返回：

此映射中包含的映射關係的 set 視圖

equals

public boolean equals(Object o)

將指定的 Attributes 物件與此 Map 進行相等性比較。如果給定對象也是 Attributes 的實例，且兩個 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，而不會影響原始值。

覆寫：

類別 Object 中的 clone

返回：

此實例的一個副本。

另請參見：

Cloneable