AttachmentPart getMatchingMimeHeaders() Method

Description

The Javax.xml.soap.AttachmentPart.getMatchingMimeHeaders(String[] names) method retrieves all the headers for this AttachmentPart object as an iterator over the MimeHeader objects.

Declaration

Following is the declaration for javax.xml.soap.AttachmentPart.getMatchingMimeHeaders() method

public abstract Iterator getMatchingMimeHeaders(String[] names)

Parameters

names − a String array with the name(s) of the MIME headers to be returned

Return Value

This method returns all of the MIME headers that match one of the names in the given array as an Iterator object

Exception

NA

Example

The following example shows the usage of javax.xml.soap.AttachmentPart.getMatchingMimeHeaders() method.

package com.tutorialspoint;

import java.util.Iterator;
import javax.activation.DataHandler;
import javax.xml.soap.*;

public class AttachmentPartDemo {

   public static void main(String[] args) {
      try {

         // create a new SOAPMessage
         SOAPMessage message = MessageFactory.newInstance().createMessage();

         // create a string as a new attachment 
         String attachment = "This is an attachment";

         // get the data handler and assign the attachment
         DataHandler handler = new DataHandler(attachment, "HandlerHeader");

         // create the attachment part
         AttachmentPart attachPart = message.createAttachmentPart(handler);

         // add a MIMEHeader
         attachPart.addMimeHeader("SecondHeader", "header");

         // add the attachment part in the message
         message.addAttachmentPart(attachPart);

         String[] headers = {"FirstHeader", "SecondHeader"};

         // get the matching headers for headers array
         Iterator iterator = attachPart.getMatchingMimeHeaders(headers);

         // print them
         while (iterator.hasNext()) {
            MimeHeader header = (MimeHeader) iterator.next();
            System.out.println("" + header.getName());
         }
      } catch (Exception ex) {
         ex.printStackTrace();
      }
   }
}

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

SecondHeader