- java.lang.Object
-
- javax.xml.soap.MimeHeaders
-
public class MimeHeaders extends Object
一个容纳MimeHeader
对象的容器,它们表示消息的MIME部分中存在的MIME头。该类主要用于当应用程序想要基于某些MIME头和值检索特定附件时。 这个类最有可能由实现的
AttachmentPart
和SAAJ API的其他依赖MIME的部分使用。- 从以下版本开始:
- 1.6
- 另请参见:
-
SOAPMessage.getAttachments()
,AttachmentPart
-
-
构造方法摘要
构造方法 Constructor 描述 MimeHeaders()
构造一个默认的MimeHeaders
对象,并使用一个空的Vector
对象进行初始化。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 void
addHeader(String name, String value)
添加一个MimeHeader
具有指定名称和值的这个对象MimeHeaders
头的对象的列表。Iterator<MimeHeader>
getAllHeaders()
返回所有MimeHeader
在这个SMimeHeaders
对象。String[]
getHeader(String name)
将指定标题的所有值作为String
对象的数组String
。Iterator<MimeHeader>
getMatchingHeaders(String[] names)
返回名称与给定名称数组中的名称相匹配的所有MimeHeader
对象。Iterator<MimeHeader>
getNonMatchingHeaders(String[] names)
返回名称与给定名称数组中的名称不匹配的所有MimeHeader
对象。void
removeAllHeaders()
从此MimeHeaders
对象中删除所有标题条目。void
removeHeader(String name)
删除名称与给定名称匹配的所有MimeHeader
对象。void
setHeader(String name, String value)
将名称与给定名称匹配的第一个标题条目的当前值替换为给定值,如果没有现有的标题名称匹配,则添加一个新标题。
-
-
-
方法详细信息
-
getHeader
public String[] getHeader(String name)
将指定标题的所有值作为String
对象的数组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<MimeHeader> getAllHeaders()
返回所有MimeHeader
在这个SMimeHeaders
对象。- 结果
-
一个
Iterator
对象在这MimeHeaders
对象的列表中的MimeHeader
对象
-
getMatchingHeaders
public Iterator<MimeHeader> getMatchingHeaders(String[] names)
返回名称与给定名称数组中的名称相匹配的所有MimeHeader
对象。- 参数
-
names
- 一个String
对象的数组,要搜索的名称 - 结果
-
一个
Iterator
对象在MimeHeader
对象,它们的名称相匹配的名称中的一个给定列表
-
getNonMatchingHeaders
public Iterator<MimeHeader> getNonMatchingHeaders(String[] names)
返回名称与给定名称数组中的名称不匹配的所有MimeHeader
对象。- 参数
-
names
- 具有要搜索的名称的String
对象的数组 - 结果
-
an
Iterator
object over theMimeHeader
objects whose name does not match one of the names in the given list
-
-