to.etc.smtp

Class MailBuilder

java.lang.Object

to.etc.smtp.MailBuilder

public class MailBuilder
extends Object

Utility class to generate email messages containing embedded HTML and plaintext, and allowing for attachment images. This generates an HTML and text-only message at the same time.

Author:

Frits Jalvingh Created on Jan 22, 2010

Constructor Summary

Constructors

Constructor and Description
MailBuilder() Creates mail builder that automatically creates html header and body.

Method Summary

Modifier and Type	Method and Description
MailBuilder	addAttachment(String name, File source) Add attachment to the email
MailBuilder	append(String s) Just add verbatim text, without anything else.
MailBuilder	appendHTML(String s)
MailBuilder	appendText(String s)
MailBuilder	b(String s)
Message	createMessage()
static MailBuilder	createNondecoratedMailBuilder() Creates mail builder that allows full control over HTML content.
StringBuilder	getHtmlBuffer()
StringBuilder	getTextBuffer()
MailBuilder	i(String s)
MailBuilder	image(String name, Class<?> rbase, String rname, String mime)
MailBuilder	image(String name, File source, String mime) Append an image as an attachment, and embed the image in the HTML stream.
MailBuilder	image(String name, String mime, to.etc.smtp.MailBuilder.Attachment a)
void	initialize(String subject)
MailBuilder	link(String url, String text) Render a link in HTML, embedding "text" in the link.
MailBuilder	linkNoText(String url, String text)
static void	main(String[] args)
MailBuilder	nl()
void	send(Message m) Send it.
void	send(SmtpTransport t, Address from, Address to)
void	send(SmtpTransport t, Address from, List<Address> dest)
MailBuilder	ttl(String s)

Methods inherited from class java.lang.Object

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

Constructor Detail

MailBuilder

public MailBuilder()

Creates mail builder that automatically creates html header and body. To have full control over HTML content use createNondecoratedMailBuilder()

Method Detail

createNondecoratedMailBuilder

@Nonnull
public static MailBuilder createNondecoratedMailBuilder()

Creates mail builder that allows full control over HTML content.

Returns:

See Also:

m_decorateHtml

initialize

public void initialize(String subject)

append

public MailBuilder append(String s)

Just add verbatim text, without anything else. Quotes all html content.

Parameters:

s -

Returns:

appendText

public MailBuilder appendText(String s)

getHtmlBuffer

public StringBuilder getHtmlBuffer()

getTextBuffer

public StringBuilder getTextBuffer()

appendHTML

public MailBuilder appendHTML(String s)

ttl

public MailBuilder ttl(String s)

i

public MailBuilder i(String s)

b

public MailBuilder b(String s)

nl

public MailBuilder nl()

link

public MailBuilder link(String url,
                        String text)

Render a link in HTML, embedding "text" in the link. The text message will show

 text (link)
 

Parameters:

rurl -

text -

Returns:

linkNoText

public MailBuilder linkNoText(String url,
                              String text)

image

public MailBuilder image(String name,
                         File source,
                         String mime)
                  throws Exception

Append an image as an attachment, and embed the image in the HTML stream. The text stream just contains a reference like (see image xxx). The image must be a supported mime type.

Parameters:

name -

source -

Returns:

Throws:

Exception

addAttachment

@Nonnull
public MailBuilder addAttachment(@Nonnull
                                          String name,
                                          @Nonnull
                                          File source)
                                   throws Exception

Add attachment to the email

Parameters:

name - Name of an attachment

source - of attachment

Returns:

Throws:

Exception

image

public MailBuilder image(String name,
                         String mime,
                         to.etc.smtp.MailBuilder.Attachment a)
                  throws Exception

Throws:

Exception

image

public MailBuilder image(String name,
                         Class<?> rbase,
                         String rname,
                         String mime)
                  throws Exception

Throws:

Exception

send

public void send(Message m)
          throws Exception

Send it.

Parameters:

dest -

Throws:

Exception

createMessage

@Nonnull
public Message createMessage()

send

public void send(SmtpTransport t,
                 Address from,
                 List<Address> dest)
          throws Exception

Throws:

Exception

send

public void send(SmtpTransport t,
                 Address from,
                 Address to)
          throws Exception

Throws:

Exception

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception