jodd.mail

Class EMLParser

java.lang.Object

jodd.mail.EMLParser

public class EMLParser
extends java.lang.Object

Developer-friendly class for parsing EML files.

Constructor Summary

Constructors

Constructor and Description
EMLParser()

Method Summary

Modifier and Type	Method and Description
protected T	_this()
static EMLParser	create()
protected jakarta.mail.Session	createSession(java.util.Properties properties) Creates new Session with or without custom Properties.
protected java.util.Properties	getProperties() Returns the Properties.
protected jakarta.mail.Session	getSession() Returns the Session.
ReceivedEmail	parse(byte[] content) Parses EML with provided EML content.
ReceivedEmail	parse(java.io.File emlFile) Starts EML parsing with provided EML File.
protected ReceivedEmail	parse(java.io.InputStream emlContentInputStream) Parses the EML content.
ReceivedEmail	parse(java.lang.String emlContent) Parses EML with provided EML content.
ReceivedEmail	parse(java.lang.String emlContent, java.lang.String charset) Parses EML with provided EML content.
T	set(java.util.Properties properties) Copies properties from given set.
T	set(java.lang.String name, java.lang.String value) Sets property for the Session.
T	useDefaultSession() Uses default Session.

Methods inherited from class java.lang.Object

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

Constructor Detail

EMLParser

public EMLParser()

Method Detail

create

public static EMLParser create()

parse

public ReceivedEmail parse(java.lang.String emlContent,
                           java.lang.String charset)
                    throws java.io.UnsupportedEncodingException,
                           jakarta.mail.MessagingException

Parses EML with provided EML content.

Parameters:

emlContent - String with EML content.

charset - String with charset.

Returns:

ReceivedEmail.

Throws:

java.io.UnsupportedEncodingException - if the named charset is not supported.

jakarta.mail.MessagingException - if MimeMessage cannot be created.

See Also:

parse(byte[])

parse

public ReceivedEmail parse(java.lang.String emlContent)
                    throws jakarta.mail.MessagingException

Parses EML with provided EML content.

Parameters:

emlContent - String with EML content.

Returns:

ReceivedEmail.

Throws:

jakarta.mail.MessagingException - if MimeMessage cannot be created.

See Also:

parse(String, String)

parse

public ReceivedEmail parse(byte[] content)
                    throws jakarta.mail.MessagingException

Parses EML with provided EML content.

Parameters:

content - byte[] with EML content.

Returns:

ReceivedEmail.

Throws:

jakarta.mail.MessagingException - if MimeMessage cannot be created.

See Also:

parse(InputStream)

parse

public ReceivedEmail parse(java.io.File emlFile)
                    throws java.io.FileNotFoundException,
                           jakarta.mail.MessagingException

Starts EML parsing with provided EML File.

Parameters:

emlFile - File with EML content.

Returns:

ReceivedEmail.

Throws:

java.io.FileNotFoundException - if emlFile cannot be found

jakarta.mail.MessagingException - if MimeMessage cannot be created.

See Also:

parse(InputStream)

parse

protected ReceivedEmail parse(java.io.InputStream emlContentInputStream)
                       throws jakarta.mail.MessagingException

Parses the EML content. If Session is not created, default one will be used.

Parameters:

emlContentInputStream - InputStream containing the EML content.

Returns:

ReceivedEmail.

Throws:

jakarta.mail.MessagingException - if MimeMessage cannot be created.

_this

protected T _this()

getSession

protected jakarta.mail.Session getSession()

Returns the Session.

Returns:

the Session.

getProperties

protected java.util.Properties getProperties()

Returns the Properties.

Returns:

the Properties.

createSession

protected jakarta.mail.Session createSession(java.util.Properties properties)

Creates new Session with or without custom Properties.

Parameters:

properties - Custom properties to be used during Session creation. It is acceptable is this value is null.

Returns:

Session with any custom Properties

set

public T set(java.util.Properties properties)
      throws MailException

Copies properties from given set. If Session is already created, exception will be thrown.

Parameters:

properties - Properties to set.

Returns:

this

Throws:

MailException - if the Properties has already been set.

set

public T set(java.lang.String name,
             java.lang.String value)

Sets property for the Session. If Session is already created, an exception will be thrown.

Parameters:

name - Property name to set.

value - Property value to set.

Returns:

this

Throws:

MailException - if the Properties has already been set.

useDefaultSession

public T useDefaultSession()

Uses default Session. Any property will be ignored.

Returns:

this

See Also:

System.getProperties()