Module  java.xml.ws
软件包  javax.xml.soap

Class MimeHeaders


  • public class MimeHeaders
extends Object
    一个容纳MimeHeader对象的容器，它们表示消息的MIME部分中存在的MIME头。

    该类主要用于当应用程序想要基于某些MIME头和值检索特定附件时。 这个类最有可能由实现的AttachmentPart和SAAJ API的其他依赖MIME的部分使用。

    从以下版本开始：
    1.6
    另请参见：
    SOAPMessage.getAttachments() ， AttachmentPart

    • 构造方法详细信息

      • MimeHeaders

        public MimeHeaders​()
        构造一个默认 MimeHeaders用空初始化的对象 Vector对象。

    • 方法详细信息

      • 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在这个S MimeHeaders对象。
        结果
        一个 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 the MimeHeader objects whose name does not match one of the names in the given list