MimeHeaders

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 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`

构造方法详细信息

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

概述