当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

MimeHeaders (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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