to.etc.smtp
Class MailBuilder

java.lang.Object
  extended by to.etc.smtp.MailBuilder

public class MailBuilder
extends java.lang.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
MailBuilder()
           
 
Method Summary
 MailBuilder append(java.lang.String s)
          Just add verbatim text, without anything else.
 MailBuilder appendHTML(java.lang.String s)
           
 MailBuilder appendText(java.lang.String s)
           
 MailBuilder b(java.lang.String s)
           
 java.lang.StringBuilder getHtmlBuffer()
           
 java.lang.StringBuilder getTextBuffer()
           
 MailBuilder i(java.lang.String s)
           
 MailBuilder image(java.lang.String name, java.lang.Class<?> rbase, java.lang.String rname, java.lang.String mime)
           
 MailBuilder image(java.lang.String name, java.io.File source, java.lang.String mime)
          Append an image as an attachment, and embed the image in the HTML stream.
 MailBuilder image(java.lang.String name, java.lang.String mime, to.etc.smtp.MailBuilder.Attachment a)
           
 void initialize(java.lang.String subject)
           
 MailBuilder link(java.lang.String url, java.lang.String text)
          Render a link in HTML, embedding "text" in the link.
 MailBuilder linkNoText(java.lang.String url, java.lang.String text)
           
 MailBuilder nl()
           
 void send(Message m)
          Send it.
 void send(SmtpTransport t, Address from, Address to)
           
 void send(SmtpTransport t, Address from, java.util.List<Address> dest)
           
 MailBuilder ttl(java.lang.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()
Method Detail

initialize

public void initialize(java.lang.String subject)

append

public MailBuilder append(java.lang.String s)
Just add verbatim text, without anything else. Quotes all html content.

Parameters:
s -
Returns:

appendText

public MailBuilder appendText(java.lang.String s)

getHtmlBuffer

public java.lang.StringBuilder getHtmlBuffer()

getTextBuffer

public java.lang.StringBuilder getTextBuffer()

appendHTML

public MailBuilder appendHTML(java.lang.String s)

ttl

public MailBuilder ttl(java.lang.String s)

i

public MailBuilder i(java.lang.String s)

b

public MailBuilder b(java.lang.String s)

nl

public MailBuilder nl()

link

public MailBuilder link(java.lang.String url,
                        java.lang.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(java.lang.String url,
                              java.lang.String text)

image

public MailBuilder image(java.lang.String name,
                         java.io.File source,
                         java.lang.String mime)
                  throws java.lang.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:
java.lang.Exception

image

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

image

public MailBuilder image(java.lang.String name,
                         java.lang.Class<?> rbase,
                         java.lang.String rname,
                         java.lang.String mime)
                  throws java.lang.Exception
Throws:
java.lang.Exception

send

public void send(Message m)
          throws java.lang.Exception
Send it.

Parameters:
dest -
Throws:
java.lang.Exception

send

public void send(SmtpTransport t,
                 Address from,
                 java.util.List<Address> dest)
          throws java.lang.Exception
Throws:
java.lang.Exception

send

public void send(SmtpTransport t,
                 Address from,
                 Address to)
          throws java.lang.Exception
Throws:
java.lang.Exception