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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策