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(javax.mail.internet.MimeMessage message)
      Constructs an instance with the MimeMessage to be extracted.
      Parameters:
      message - the message to parse

  • Method Details

    • parse

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

    • getTo

      public List<javax.mail.Address> getTo() throws Exception
      Returns:
      the 'to' recipients of the message
      Throws:
      Exception - determining the recipients failed

    • getCc

      public List<javax.mail.Address> getCc() throws Exception
      Returns:
      the 'cc' recipients of the message
      Throws:
      Exception - determining the recipients failed

    • getBcc

      public List<javax.mail.Address> getBcc() throws Exception
      Returns:
      the 'bcc' recipients of the message
      Throws:
      Exception - determining the recipients failed

    • getFrom

      public String getFrom() throws Exception
      Returns:
      the 'from' field of the message
      Throws:
      Exception - parsing the mime message failed

    • getReplyTo

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

    • getSubject

      public String getSubject() throws Exception
      Returns:
      the mail subject
      Throws:
      Exception - parsing the mime message failed

    • parse

      protected void parse(javax.mail.Multipart parent, javax.mail.internet.MimePart part) throws javax.mail.MessagingException, IOException
      Extracts the content of a MimeMessage recursively.
      Parameters:
      parent - the parent multi-part
      part - the current MimePart
      Throws:
      javax.mail.MessagingException - parsing the MimeMessage failed
      IOException - parsing the MimeMessage failed

    • createDataSource

      protected DataSource createDataSource(javax.mail.Multipart parent, javax.mail.internet.MimePart part) throws javax.mail.MessagingException, IOException
      Parses the MimePart to create a DataSource.
      Parameters:
      parent - the parent multi-part
      part - the current part to be processed
      Returns:
      the DataSource
      Throws:
      javax.mail.MessagingException - creating the DataSource failed
      IOException - creating the DataSource failed

    • getMimeMessage

      public javax.mail.internet.MimeMessage getMimeMessage()
      Returns:
      Returns the mimeMessage.

    • isMultipart

      public boolean isMultipart()
      Returns:
      Returns the isMultiPart.

    • getPlainContent

      public String getPlainContent()
      Returns:
      Returns the plainContent if any

    • getAttachmentList

      public List<DataSource> getAttachmentList()
      Returns:
      Returns the attachmentList.

    • 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

    • getHtmlContent

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

    • hasPlainContent

      public boolean hasPlainContent()
      Returns:
      true if a plain content is available

    • hasHtmlContent

      public boolean hasHtmlContent()
      Returns:
      true if HTML content is available

    • hasAttachments

      public boolean hasAttachments()
      Returns:
      true if attachments are available

    • findAttachmentByName

      public 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

    • findAttachmentByCid

      public 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

    • getDataSourceName

      protected String getDataSourceName(javax.mail.Part part, DataSource dataSource) throws javax.mail.MessagingException, UnsupportedEncodingException
      Determines the name of the data source if it is not already set.
      Parameters:
      part - the mail part
      dataSource - the data source
      Returns:
      the name of the data source or null if no name can be determined
      Throws:
      javax.mail.MessagingException - accessing the part failed
      UnsupportedEncodingException - decoding the text failed