javax.xml.soap
類別 MimeHeaders

java.lang.Object
  javax.xml.soap.MimeHeaders

public class MimeHeaders
extends Object

MimeHeader 物件的容器，這些物件表示出現在訊息的 MIME 部分的 MIME 頭。

此類別主要在應用程序要根據某些 MIME 頭和值來檢索特定的附件時使用。該類別最有可能由 AttachmentPart 的實作和 SAAJ API 的其他與 MIME 有關的部分使用。

另請參見：

SOAPMessage.getAttachments(), AttachmentPart

建構子摘要

MimeHeaders()
建構一個用空 Vector 物件初始化的預設 MimeHeaders 物件。

方法摘要

void	addHeader(String name, String value) 將帶有指定名稱和值的 MimeHeader 物件添加到此 MimeHeaders 物件的頭列表。
Iterator	getAllHeaders() 返回此 MimeHeaders 物件中的所有 MimeHeader。
String[]	getHeader(String name) 以 String 物件陣列的形式返回指定頭的所有值。
Iterator	getMatchingHeaders(String[] names) 返回其名稱與給定名稱陣列中的任一名稱比對的所有 MimeHeader 物件。
Iterator	getNonMatchingHeaders(String[] names) 返回其名稱與給定名稱陣列中的任何名稱都不比對的所有 MimeHeader 物件。
void	removeAllHeaders() 從此 MimeHeaders 物件中移除所有頭條目。
void	removeHeader(String name) 移除其名稱與給定名稱比對的所有 MimeHeader 物件。
void	setHeader(String name, String value) 將其名稱與給定名稱比對的第一個頭條目的當前值替換為給定值，如果現有的頭名稱都不比對，則添加一個新的頭。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

MimeHeaders

public MimeHeaders()

建構一個用空 Vector 物件初始化的預設 MimeHeaders 物件。

方法詳細資訊

getHeader

public String[] getHeader(String name)

以 String 物件陣列的形式返回指定頭的所有值。

參數：

name - 將返回其值的頭的名稱

返回：

帶有指定頭的所有值的 String 陣列

另請參見：

setHeader(java.lang.String, java.lang.String)

setHeader

public void setHeader(String name,
                      String value)

將其名稱與給定名稱比對的第一個頭條目的當前值替換為給定值，如果現有的頭名稱都不比對，則添加一個新的頭。此方法還移第一個比對頭之後的所有比對的頭。

注意，RFC822 頭只能包含 US-ASCII 字元。

參數：

name - 一個 String，帶有要搜尋的頭的名稱

value - 一個 String，帶有用來替換指定頭的當前值的值

拋出：

IllegalArgumentException - 如果設置 MIME 頭名稱或值時存在問題

另請參見：

getHeader(java.lang.String)

addHeader

public void addHeader(String name,
                      String value)

將帶有指定名稱和值的 MimeHeader 物件添加到此 MimeHeaders 物件的頭列表。

注意，RFC822 頭只能包含 US-ASCII 字元。

參數：

name - 一個 String，帶有要添加的頭的名稱

value - 一個 String，帶有要添加的頭的值

拋出：

IllegalArgumentException - 如果添加 MIME 頭名稱或值時存在問題

removeHeader

public void removeHeader(String name)

移除其名稱與給定名稱比對的所有 MimeHeader 物件。

參數：

name - 一個 String，帶有要搜尋的頭名稱

removeAllHeaders

public void removeAllHeaders()

從此 MimeHeaders 物件中移除所有頭條目。

getAllHeaders

public Iterator getAllHeaders()

返回此 MimeHeaders 物件中的所有 MimeHeader。

返回：

一個 Iterator 物件，可在此 MimeHeaders 物件的 MimeHeader 物件列表上進行迭代

getMatchingHeaders

public Iterator getMatchingHeaders(String[] names)

返回其名稱與給定名稱陣列中的任一名稱比對的所有 MimeHeader 物件。

參數：

names - 帶有要搜尋的名稱的 String 物件陣列

返回：

一個 Iterator 物件，可在其名稱與給定列表中的任一名稱比對的 MimeHeader 物件上進行迭代

getNonMatchingHeaders

public Iterator getNonMatchingHeaders(String[] names)

返回其名稱與給定名稱陣列中的任何名稱都不比對的所有 MimeHeader 物件。

參數：

names - 帶有要搜尋的名稱的 String 物件陣列

返回：

一個 Iterator 物件，可在其名稱與給定列表中的任何名稱都不比對的 MimeHeader 物件上進行迭代