Package org.apache.commons.mail.util

Class MimeMessageParser

java.lang.Object
org.apache.commons.mail.util.MimeMessageParser
public class MimeMessageParser extends Object
Parses a MimeMessage and stores the individual parts such a plain text, HTML text and attachments.
Since:
1.3

  • Constructor Details

    • MimeMessageParser

      public MimeMessageParser(MimeMessage mimeMessage)
      Constructs an instance with the MimeMessage to be extracted.
      Parameters:
      mimeMessage - the message to parse

  • Method Details

    • findAttachmentByCid

      public javax.activation.DataSource findAttachmentByCid(String cid)
      Find an attachment using its content-id.

      The content-id must be stripped of any angle brackets, i.e. "part1" instead of "<part1>".

      Parameters:
      cid - the content-id of the attachment
      Returns:
      the corresponding datasource or null if nothing was found
      Since:
      1.3.4

    • findAttachmentByName

      public javax.activation.DataSource findAttachmentByName(String name)
      Find an attachment using its name.
      Parameters:
      name - the name of the attachment
      Returns:
      the corresponding datasource or null if nothing was found

    • getAttachmentList

      public List<javax.activation.DataSource> getAttachmentList()
      Gets the attachment list.
      Returns:
      Returns the attachment list.

    • getBcc

      public List<Address> getBcc() throws MessagingException
      Gets the BCC Address list.
      Returns:
      the 'BCC' recipients of the message
      Throws:
      MessagingException - determining the recipients failed

    • getCc

      public List<Address> getCc() throws MessagingException
      Gets the CC Address list.
      Returns:
      the 'CC' recipients of the message
      Throws:
      MessagingException - determining the recipients failed

    • getContentIds

      public Collection<String> getContentIds()
      Returns a collection of all content-ids in the parsed message.

      The content-ids are stripped of any angle brackets, i.e. "part1" instead of "<part1>".

      Returns:
      the collection of content ids.
      Since:
      1.3.4

    • getFrom

      public String getFrom() throws MessagingException
      Gets the FROM field.
      Returns:
      the FROM field of the message
      Throws:
      MessagingException - parsing the mime message failed

    • getHtmlContent

      public String getHtmlContent()
      Gets the htmlContent if any.
      Returns:
      Returns the htmlContent if any

    • getMimeMessage

      public MimeMessage getMimeMessage()
      Gets the MimeMessage.
      Returns:
      Returns the mimeMessage.

    • getPlainContent

      public String getPlainContent()
      Gets the plain content if any.
      Returns:
      Returns the plainContent if any

    • getReplyTo

      public String getReplyTo() throws MessagingException
      Gets the 'replyTo' address of the email.
      Returns:
      the 'replyTo' address of the email
      Throws:
      MessagingException - parsing the mime message failed

    • getSubject

      public String getSubject() throws MessagingException
      Gets the MIME message subject.
      Returns:
      the MIME message subject.
      Throws:
      MessagingException - parsing the mime message failed.

    • getTo

      public List<Address> getTo() throws MessagingException
      Gets the MIME message 'to' list.
      Returns:
      the 'to' recipients of the message.
      Throws:
      MessagingException - determining the recipients failed

    • hasAttachments

      public boolean hasAttachments()
      Tests if attachments are present.
      Returns:
      true if attachments are present.

    • hasHtmlContent

      public boolean hasHtmlContent()
      Tests is HTML content is present.
      Returns:
      true if HTML content is present.

    • hasPlainContent

      public boolean hasPlainContent()
      Tests is plain content is present.
      Returns:
      true if a plain content is present.

    • isMultipart

      public boolean isMultipart()
      Tests whether this is multipart.
      Returns:
      Returns the isMultiPart.

    • parse

      public MimeMessageParser parse() throws MessagingException, IOException
      Does the actual extraction.
      Returns:
      this instance
      Throws:
      MessagingException - parsing the mime message failed
      IOException - parsing the mime message failed