org.dvb.internet

Interface EmailClient

All Superinterfaces:

InternetClient, ServiceContentHandler

public interface EmailClient
extends InternetClient

Interface supporting the operations required on an email client.

Method Summary

Methods

Modifier and Type	Method and Description
void	createMessage(String to, String subject, String messageBody) Create a new email message.

Methods inherited from interface org.dvb.internet.InternetClient

addInternetClientListener, getService, getServiceContentLocators, removeInternetClientListener

Method Detail

createMessage

void createMessage(String to,
                 String subject,
                 String messageBody)
                   throws ClientNotRunningException

Create a new email message. If any of the parameters are an empty string, the user will be prompted for the missing information.

This is an asynchronous operation, whose success or failure will be indicated by an InternetClientSuccessEvent or InternetClientFailureEvent or one of their subclasses.

Parameters:

to - the address to which the email should be sent.

subject - the subject for the email.

messageBody - the body of the message.

Throws:

NullPointerException - if any of the to address, subject or message body are null.

ClientNotRunningException - if the client is not currently running.

IllegalArgumentException - if the destination address is an empty string.