org.dvb.internet
Interface EmailClient

All Superinterfaces:
InternetClient, javax.tv.service.selection.ServiceContentHandler

public interface EmailClient
extends InternetClient

Interface supporting the operations required on an email client.


Method Summary
 void createMessage(java.lang.String to, java.lang.String subject, java.lang.String messageBody)
          Create a new email message.
 
Methods inherited from interface org.dvb.internet.InternetClient
addInternetClientListener, getService, getServiceContentLocators, removeInternetClientListener
 

Method Detail

createMessage

public void createMessage(java.lang.String to,
                          java.lang.String subject,
                          java.lang.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.
java.lang.IllegalArgumentException - if the destination address is an empty string.