com.google.gerrit.server.mail.receive

Class RawMailParser

java.lang.Object

com.google.gerrit.server.mail.receive.RawMailParser

public class RawMailParser
extends Object

RawMailParser parses raw email content received through POP3 or IMAP into an internal MailMessage.

Constructor Summary

Constructors

Constructor and Description
RawMailParser()

Method Summary

Modifier and Type	Method and Description
static MailMessage	parse(int[] chars) Parses a MailMessage from an array of characters.
static MailMessage	parse(String raw) Parses a MailMessage from a string.

Methods inherited from class java.lang.Object

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

Constructor Detail

RawMailParser

public RawMailParser()

Method Detail

parse

public static MailMessage parse(String raw)
                         throws MailParsingException

Parses a MailMessage from a string.

Parameters:

raw - String as received over the wire

Returns:

Parsed MailMessage

Throws:

MailParsingException

parse

public static MailMessage parse(int[] chars)
                         throws MailParsingException

Parses a MailMessage from an array of characters. Note that the character array is int-typed. This method is only used by POP3, which specifies that all transferred characters are US-ASCII (RFC 6856). When reading the input in Java, io.Reader yields ints. These can be safely converted to chars as all US-ASCII characters fit in a char. If emails contain non-ASCII characters, such as UTF runes, these will be encoded in ASCII using either Base64 or quoted-printable encoding.

Parameters:

chars - Array as received over the wire

Returns:

Parsed MailMessage

Throws:

MailParsingException