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