net.emphased.malle

Interface Mail

public interface Mail

Fluent mail builder. This is the main interface to use when composing and sending a mail message.

Depending on whether it's multipart or not (i.e. created with mail(true) or mail(false)) certain methods will throw UnsupportedOperationException. A non-multipart message doesn't support:

• Having both plain and HTML bodies within a single message. See plain(String), html(String), body(BodyType, String).
• Attachments (regular and inline). See attachment(InputStreamSupplier, String, String), inline(InputStreamSupplier, String, String) (and other variants of these methods).

Minimal usage example:

 MailSystem mailSystem = ... ;

 mailSystem.mail()
           .from("me@example.com")
           .to("you@example.com")
           .subject("Hello there")
           .html("<p>Hey hey hey</p>")
           .send();
 

See Also:

MailSystem

Field Summary

Fields

Modifier and Type	Field and Description
static Encoding	DEFAULT_ATTACHMENT_ENCODING
static Encoding	DEFAULT_BODY_ENCODING
static Charset	DEFAULT_CHARSET

Method Summary

Methods

Modifier and Type	Method and Description
Mail	address(AddressType type, Iterable<String> addresses)
Mail	address(AddressType type, String addresses)
Mail	address(AddressType type, String[] addresses)
Mail	address(AddressType type, String address, String personal)
Mail	attachment(InputStreamSupplier content, String name)
Mail	attachment(InputStreamSupplier content, String name, String type)
Mail	attachmentEncoding(Encoding encoding)
Mail	bcc(Iterable<String> addresses)
Mail	bcc(String addresses)
Mail	bcc(String[] addresses)
Mail	bcc(String address, String personal)
Mail	body(BodyType type, String value)
Mail	bodyEncoding(Encoding encoding)
Mail	cc(Iterable<String> addresses)
Mail	cc(String addresses)
Mail	cc(String[] addresses)
Mail	cc(String address, String personal)
Mail	charset(Charset charset)
Mail	charset(String charset)
Mail	from(Iterable<String> addresses)
Mail	from(String addresses)
Mail	from(String[] addresses)
Mail	from(String address, String personal)
Mail	header(String name, String value)
Mail	html(String html)
Mail	id(String id)
Mail	inline(InputStreamSupplier content, String id)
Mail	inline(InputStreamSupplier content, String id, String type)
Mail	plain(String plain)
Mail	priority(int priority)
Mail	replyTo(Iterable<String> addresses)
Mail	replyTo(String addresses)
Mail	replyTo(String[] addresses)
Mail	replyTo(String address, String personal)
Mail	send()
Mail	subject(String subject)
Mail	template(String name, Locale locale, Map<String,?> context)
Mail	template(String name, Locale locale, Object... context)
Mail	template(String name, Map<String,?> context)
Mail	template(String name, Object... context)
Mail	to(Iterable<String> addresses)
Mail	to(String addresses)
Mail	to(String[] addresses)
Mail	to(String address, String personal)
Mail	writeTo(OutputStream outputStream)
Mail	writeTo(Path path)
Mail	writeTo(String path)

Field Detail

DEFAULT_CHARSET

static final Charset DEFAULT_CHARSET

DEFAULT_BODY_ENCODING

static final Encoding DEFAULT_BODY_ENCODING

DEFAULT_ATTACHMENT_ENCODING

static final Encoding DEFAULT_ATTACHMENT_ENCODING

Method Detail

charset

Mail charset(Charset charset)

charset

Mail charset(String charset)

bodyEncoding

Mail bodyEncoding(@Nullable
                Encoding encoding)

attachmentEncoding

Mail attachmentEncoding(Encoding encoding)

id

Mail id(String id)

priority

Mail priority(int priority)

from

Mail from(Iterable<String> addresses)

from

Mail from(String[] addresses)

from

Mail from(String addresses)

from

Mail from(String address,
        @Nullable
        String personal)

replyTo

Mail replyTo(Iterable<String> addresses)

replyTo

Mail replyTo(String[] addresses)

replyTo

Mail replyTo(String addresses)

replyTo

Mail replyTo(String address,
           @Nullable
           String personal)

to

Mail to(Iterable<String> addresses)

to

Mail to(String[] addresses)

to

Mail to(String addresses)

to

Mail to(String address,
      @Nullable
      String personal)

cc

Mail cc(Iterable<String> addresses)

cc

Mail cc(String[] addresses)

cc

Mail cc(String address,
      @Nullable
      String personal)

cc

Mail cc(String addresses)

bcc

Mail bcc(Iterable<String> addresses)

bcc

Mail bcc(String[] addresses)

bcc

Mail bcc(String address,
       @Nullable
       String personal)

bcc

Mail bcc(String addresses)

address

Mail address(AddressType type,
           Iterable<String> addresses)

address

Mail address(AddressType type,
           String[] addresses)

address

Mail address(AddressType type,
           String addresses)

address

Mail address(AddressType type,
           String address,
           @Nullable
           String personal)

subject

Mail subject(String subject)

header

Mail header(String name,
          String value)

plain

Mail plain(String plain)

html

Mail html(String html)

body

Mail body(BodyType type,
        String value)

attachment

Mail attachment(InputStreamSupplier content,
              String name,
              @Nullable
              String type)

attachment

Mail attachment(InputStreamSupplier content,
              String name)

inline

Mail inline(InputStreamSupplier content,
          String id,
          @Nullable
          String type)

inline

Mail inline(InputStreamSupplier content,
          String id)

template

Mail template(String name,
            @Nullable
            Locale locale,
            Map<String,?> context)

template

Mail template(String name,
            @Nullable
            Locale locale,
            Object... context)

template

Mail template(String name,
            Map<String,?> context)

template

Mail template(String name,
            Object... context)

send

Mail send()

writeTo

Mail writeTo(OutputStream outputStream)

writeTo

Mail writeTo(Path path)

writeTo

Mail writeTo(String path)