javax.mail

Class Transport

Known Direct Subclasses:
NNTPTransport, SMTPTransport

public abstract class Transport
extends Service

A message transport mechanism that can be used to deliver messages.
Version:
1.4
Author:
Chris Burdess

Field Summary

Fields inherited from class javax.mail.Service

debug, session, url

Constructor Summary

Transport(Session session, URLName url)
Constructor.

Method Summary

void
addTransportListener(TransportListener l)
Adds a listener for transport events.
protected void
notifyTransportListeners(int type, Address[] validSent, Address[] validUnsent, Address[] invalid, Message msg)
Notifies all transport listeners.
void
removeTransportListener(TransportListener l)
Removes a transport event listener.
static void
send(Message msg)
Sends the specified message.
static void
send(Message msg, Address[] addresses)
Sends the message to the specified addresses, ignoring any recipients specified in the message itself.
abstract void
sendMessage(Message msg, Address[] addresses)
Sends the message to the specified list of addresses.

Methods inherited from class javax.mail.Service

addConnectionListener, close, connect, connect, connect, connect, getURLName, isConnected, notifyConnectionListeners, protocolConnect, queueEvent, removeConnectionListener, setConnected, setURLName, toString

Constructor Details

Transport

public Transport(Session session,
                 URLName url)
Constructor.
Parameters:
session - the session context for this transport
url - a URLName to be used for this transport

Method Details

addTransportListener

public void addTransportListener(TransportListener l)
Adds a listener for transport events.

notifyTransportListeners

protected void notifyTransportListeners(int type,
                                        Address[] validSent,
                                        Address[] validUnsent,
                                        Address[] invalid,
                                        Message msg)
Notifies all transport listeners.

removeTransportListener

public void removeTransportListener(TransportListener l)
Removes a transport event listener.

send

public static void send(Message msg)
            throws MessagingException
Sends the specified message. The message will be sent to all recipient addresses specified in the message, using transports appropriate to each address (specified by the javamail.address.map resource).
Parameters:
msg - the message to send

send

public static void send(Message msg,
                        Address[] addresses)
            throws MessagingException
Sends the message to the specified addresses, ignoring any recipients specified in the message itself.
Parameters:
msg - the message to send
addresses - the addresses to which to send the message

sendMessage

public abstract void sendMessage(Message msg,
                                 Address[] addresses)
            throws MessagingException
Sends the message to the specified list of addresses.
Parameters:
msg - the message to be sent
addresses - the addresses to send this message to
Throws:
MessagingException - if the transport is not connected

© Copyright 2003, 2004 The Free Software Foundation, All rights reserved