Iterator getMatchingHeaders(String[] names) Method

Description

The javax.xml.soap.MimeHeaders.getMatchingHeaders(String[] name) method returns all the MimeHeader objects whose name matches a name in the given array of names.

Declaration

Following is the declaration for javax.xml.soap.MimeHeaders.getMatchingHeaders(String[] name) method

Iterator getMatchingHeaders(String[] names) 

Parameters

name − a String with the name of the header to be retrieved.

Return Value

a String array with all of the values for the specified header.

Example

The following example shows the usage of javax.xml.soap.MimeHeaders.getMatchingHeaders(String[] name) method.

package com.tutorialspoint;

import java.io.ByteArrayInputStream;
import java.util.Iterator;

import javax.xml.soap.MessageFactory;
import javax.xml.soap.MimeHeader;
import javax.xml.soap.MimeHeaders;
import javax.xml.soap.SOAPConstants;
import javax.xml.soap.SOAPMessage;

public class MimeHeadersDemo {
   public static void main(String[] args) {
      try {
         //create a default message factory
         MessageFactory messageFactory = MessageFactory.newInstance(
         SOAPConstants.SOAP_1_2_PROTOCOL);

         String contents = "Hello World!";
         // add raw content
         ByteArrayInputStream bis = new ByteArrayInputStream(
         contents.getBytes());

         MimeHeaders headers = new MimeHeaders();
   
         headers.addHeader("Content-Type", "text/xml");
         headers.addHeader("Encoding", "UTF-8");

         // create a new SOAPMessage
         SOAPMessage message = MessageFactory
            .newInstance()
            .createMessage(headers,bis);
   
         String[] names ={"Content-Type","Encoding" };

         Iterator<MimeHeader> iterator = message
            .getMimeHeaders().getMatchingHeaders(names);
         while(iterator.hasNext()){
            MimeHeader header = iterator.next();
            System.out.println("Mime Header Name: " 
               + header.getName());
            System.out.println("Mime Header value: " 
               + header.getValue());
         }
      } catch (Exception ex) {
         ex.printStackTrace();
      }
   }
}

If we compile the code and execute it, this will produce the following result −

Mime Header Name: Content-Type
Mime Header value: text/xml
Mime Header Name: Encoding
Mime Header value: UTF-8