de.cketti.mailto

Class EmailIntentBuilder

java.lang.Object

de.cketti.mailto.EmailIntentBuilder

public final class EmailIntentBuilder
extends java.lang.Object

A helper to create email intents, i.e. Intent.ACTION_SENDTO with a mailto: URI.

Example usage:

 
 EmailIntentBuilder.from(activity)
         .to("alice@example.org")
         .subject("Bug report for 'My awesome app'")
         .body("Something went wrong :(")
         .start();
 
 

This creates an intent containing the following mailto: URI:

 
 mailto:alice@example.org?subject=Bug%20report%20for%20'My%20awesome%20app'&body=Something%20went%20wrong%20%3A(
 
 

See Also:

from(Context)

Method Summary

Modifier and Type	Method and Description
EmailIntentBuilder	bcc(java.util.Collection<java.lang.String> bcc) Add an email address to be used in the "bcc" field.
EmailIntentBuilder	bcc(java.lang.String bcc) Add an email address to be used in the "bcc" field.
EmailIntentBuilder	body(java.lang.String body) Set the text body for this email intent.
android.content.Intent	build() Build the Intent.ACTION_SENDTO intent.
EmailIntentBuilder	cc(java.util.Collection<java.lang.String> cc) Add an email address to be used in the "cc" field.
EmailIntentBuilder	cc(java.lang.String cc) Add an email address to be used in the "cc" field.
static EmailIntentBuilder	from(android.content.Context context) Create a builder to create an Intent.ACTION_SENDTO intent or to launch that intent.
boolean	start() Launch the email intent.
EmailIntentBuilder	subject(java.lang.String subject) Set the subject line for this email intent.
EmailIntentBuilder	to(java.util.Collection<java.lang.String> to) Add a list of email addresses to be used in the "to" field.
EmailIntentBuilder	to(java.lang.String to) Add an email address to be used in the "to" field.

Methods inherited from class java.lang.Object

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

Method Detail

from

public static EmailIntentBuilder from(android.content.Context context)

Create a builder to create an Intent.ACTION_SENDTO intent or to launch that intent.

Parameters:

context - The Context that will be used to launch the intent

Returns:

An email intent builder

to

public EmailIntentBuilder to(java.lang.String to)

Add an email address to be used in the "to" field.

Parameters:

to - the email address to add

Returns:

This EmailIntentBuilder for method chaining

to

public EmailIntentBuilder to(java.util.Collection<java.lang.String> to)

Add a list of email addresses to be used in the "to" field.

Parameters:

to - the email addresses to add

Returns:

This EmailIntentBuilder for method chaining

cc

public EmailIntentBuilder cc(java.lang.String cc)

Add an email address to be used in the "cc" field.

Parameters:

cc - the email address to add

Returns:

This EmailIntentBuilder for method chaining

cc

public EmailIntentBuilder cc(java.util.Collection<java.lang.String> cc)

Add an email address to be used in the "cc" field.

Parameters:

cc - the email addresses to add

Returns:

This EmailIntentBuilder for method chaining

bcc

public EmailIntentBuilder bcc(java.lang.String bcc)

Add an email address to be used in the "bcc" field.

Parameters:

bcc - the email address to add

Returns:

This EmailIntentBuilder for method chaining

bcc

public EmailIntentBuilder bcc(java.util.Collection<java.lang.String> bcc)

Add an email address to be used in the "bcc" field.

Parameters:

bcc - the email addresses to add

Returns:

This EmailIntentBuilder for method chaining

subject

public EmailIntentBuilder subject(java.lang.String subject)

Set the subject line for this email intent.

Parameters:

subject - the email subject line

Returns:

This EmailIntentBuilder for method chaining

body

public EmailIntentBuilder body(java.lang.String body)

Set the text body for this email intent.

Parameters:

body - the text body

Returns:

This EmailIntentBuilder for method chaining

start

public boolean start()

Launch the email intent.

Returns:

false if no activity to handle the email intent could be found; true otherwise

build

public android.content.Intent build()

Build the Intent.ACTION_SENDTO intent.

Returns:

the intent containing the provided information