com.openexchange.mail.parser

Class MailMessageParser

java.lang.Object

com.openexchange.mail.parser.MailMessageParser

public final class MailMessageParser
extends java.lang.Object

MailMessageParser - A callback parser to parse instances of MailMessage by invoking the handleXXX() methods of given MailMessageHandler object

Author:

Thorben Betten

Constructor Summary

Constructors

Constructor and Description
MailMessageParser() Constructor

Method Summary

Methods

Modifier and Type	Method and Description
MailMessageParser	addMimeFilter(MimeFilter mimeFilter) Adds specified MIME filter.
static java.lang.String	generateFilename(java.lang.String sequenceId, java.lang.String baseMimeType) Generates a filename consisting of common prefix "Part_" and part's sequence ID appended
static java.lang.String	getFileName(java.lang.String rawFileName, java.lang.String sequenceId, java.lang.String baseMimeType) Generates an appropriate filename from either specified rawFileName if not null or generates a filename composed with "Part_" + sequenceId
static java.lang.String	getSequenceId(java.lang.String prefix, int partCount) Composes part's sequence ID from given prefix and part's count
java.util.List<com.openexchange.exception.OXException>	getWarnings() Gets possible warnings occurred during parsing.
void	parseMailMessage(MailMessage mail, MailMessageHandler handler) Parses specified mail using given handler as call-back
void	parseMailMessage(MailMessage mail, MailMessageHandler handler, java.lang.String prefix) Parses specified mail using given handler as call-back and given initial prefix for mail part identifiers; e.g.
MailMessageParser	reset() Resets this parser and returns itself
MailMessageParser	setInlineDetectorBehavior(boolean strict) Switches the INLINE detector behavior.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MailMessageParser

public MailMessageParser()

Constructor

Method Detail

setInlineDetectorBehavior

public MailMessageParser setInlineDetectorBehavior(boolean strict)

Switches the INLINE detector behavior.

Parameters:

strict - true to perform strict INLINE detector behavior; otherwise false

Returns:

This parser with new behavior applied

addMimeFilter

public MailMessageParser addMimeFilter(MimeFilter mimeFilter)

Adds specified MIME filter.

Parameters:

mimeFilter - The MIME filter

Returns:

This parser with MIME filter applied

getWarnings

public java.util.List<com.openexchange.exception.OXException> getWarnings()

Gets possible warnings occurred during parsing.

Returns:

The warnings

reset

public MailMessageParser reset()

Resets this parser and returns itself

Returns:

The parser itself

parseMailMessage

public void parseMailMessage(MailMessage mail,
                    MailMessageHandler handler)
                      throws com.openexchange.exception.OXException

Parses specified mail using given handler as call-back

Parameters:

mail - The mail to parse

handler - The call-back handler

Throws:

com.openexchange.exception.OXException - If parsing specified mail fails

parseMailMessage

public void parseMailMessage(MailMessage mail,
                    MailMessageHandler handler,
                    java.lang.String prefix)
                      throws com.openexchange.exception.OXException

Parses specified mail using given handler as call-back and given initial prefix for mail part identifiers; e.g. "1.1".

Parameters:

mail - The mail to parse

handler - The call-back handler

prefix - The initial prefix for mail part identifiers; e.g. "1.1"

Throws:

com.openexchange.exception.OXException - If parsing specified mail fails

getFileName

public static java.lang.String getFileName(java.lang.String rawFileName,
                           java.lang.String sequenceId,
                           java.lang.String baseMimeType)

Generates an appropriate filename from either specified rawFileName if not null or generates a filename composed with "Part_" + sequenceId

Parameters:

rawFileName - The raw filename obtained from mail part

sequenceId - The part's sequence ID

baseMimeType - The base MIME type to look up an appropriate file extension, if rawFileName is null

Returns:

An appropriate filename

getSequenceId

public static java.lang.String getSequenceId(java.lang.String prefix,
                             int partCount)

Composes part's sequence ID from given prefix and part's count

Parameters:

prefix - The prefix (may be null)

partCount - The part count

Returns:

The sequence ID

generateFilename

public static java.lang.String generateFilename(java.lang.String sequenceId,
                                java.lang.String baseMimeType)

Generates a filename consisting of common prefix "Part_" and part's sequence ID appended

Parameters:

sequenceId - Part's sequence ID

baseMimeType - The base MIME type to look up an appropriate file extension if rawFileName is null

Returns:

The generated filename