com.google.gerrit.server.mail.receive

Class RawMailParser

java.lang.Object

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

public class RawMailParser
extends java.lang.Object

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

Method Summary

Modifier and Type	Method and Description
static MailMessage	parse(int[] chars) Parses a MailMessage from an array of characters.
static MailMessage	parse(java.lang.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

Method Detail

parse

public static MailMessage parse(java.lang.String raw)
                         throws MailParsingException

Parses a MailMessage from a string.

Parameters:

raw - String payload as received over the wire

Returns:

parsed MailMessage

Throws:

MailParsingException - in case parsing fails

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 - in case parsing fails