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