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

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 对象上进行迭代

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。