javax.mail

Class Transport

public abstract class Transport extends Service

Abstract class modeling a message transport.
Constructor Summary
Transport(Session session, URLName name)
Constructor taking Session and URLName parameters required for Service.
Method Summary
voidaddTransportListener(TransportListener listener)
protected voidnotifyTransportListeners(int type, Address[] validSent, Address[] validUnsent, Address[] invalid, Message message)
voidremoveTransportListener(TransportListener listener)
static voidsend(Message message)
Send a message to all recipient addresses it contains (as returned by getAllRecipients) using message transports appropriate for each address.
static voidsend(Message message, Address[] addresses)
Send a message to all addresses provided irrespective of any recipients contained in the message itself using message transports appropriate for each address.
abstract voidsendMessage(Message message, Address[] addresses)
Send a message to the supplied addresses using this transport; if any of the addresses are invalid then a SendFailedException is thrown.

Constructor Detail

Transport

public Transport(Session session, URLName name)
Constructor taking Session and URLName parameters required for Service.

Parameters: session the Session this transport is for name the location this transport is for

Method Detail

addTransportListener

public void addTransportListener(TransportListener listener)

notifyTransportListeners

protected void notifyTransportListeners(int type, Address[] validSent, Address[] validUnsent, Address[] invalid, Message message)

removeTransportListener

public void removeTransportListener(TransportListener listener)

send

public static void send(Message message)
Send a message to all recipient addresses it contains (as returned by getAllRecipients) using message transports appropriate for each address. Message addresses are checked during submission, but there is no guarantee that the ultimate address is valid or that the message will ever be delivered.

saveChanges will be called before the message is actually sent.

Parameters: message the message to send

Throws: MessagingException if there was a problem sending the message

send

public static void send(Message message, Address[] addresses)
Send a message to all addresses provided irrespective of any recipients contained in the message itself using message transports appropriate for each address. Message addresses are checked during submission, but there is no guarantee that the ultimate address is valid or that the message will ever be delivered.

saveChanges will be called before the message is actually sent.

Parameters: message the message to send addresses the addesses to send to

Throws: MessagingException if there was a problem sending the message

sendMessage

public abstract void sendMessage(Message message, Address[] addresses)
Send a message to the supplied addresses using this transport; if any of the addresses are invalid then a SendFailedException is thrown. Whether the message is actually sent to any of the addresses is undefined.

Unlike the static (Message, Address[]) method, saveChanges is not called. A TransportEvent will be sent to registered listeners once the delivery attempt has been made.

Parameters: message the message to send addresses list of addresses to send it to

Throws: SendFailedException if the send failed MessagingException if there was a problem sending the message