|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjavax.mail.Service
javax.mail.Transport
public abstract class Transport
メッセージトランスポートをモデル化する抽象クラスです。 サブクラスは実際の実装を提供します。
Transport
は Service
クラスを拡張します。
トランスポートの命名、トランスポートへの接続、
接続イベントのリスニングの為の多数の共通メソッドを提供します。
Service
,
ConnectionEvent
,
TransportEvent
フィールドの概要 |
---|
クラス javax.mail.Service から継承されたフィールド |
---|
debug, session, url |
コンストラクタの概要 | |
---|---|
Transport(Session session,
URLName urlname)
コンストラクタです。 |
メソッドの概要 | |
---|---|
void |
addTransportListener(TransportListener l)
Transport イベントのリスナーを追加します。 |
protected void |
notifyTransportListeners(int type,
Address[] validSent,
Address[] validUnsent,
Address[] invalid,
Message msg)
全ての TransportListener に通知します。 |
void |
removeTransportListener(TransportListener l)
Transport イベントのリスナーを削除します。 |
static void |
send(Message msg)
メッセージを送信します。 |
static void |
send(Message msg,
Address[] addresses)
指定されたアドレスにメッセージを送信します。 |
abstract void |
sendMessage(Message msg,
Address[] addresses)
Message を指定されたリストのアドレスに送信します。 |
クラス javax.mail.Service から継承されたメソッド |
---|
addConnectionListener, close, connect, connect, connect, connect, finalize, getURLName, isConnected, notifyConnectionListeners, protocolConnect, queueEvent, removeConnectionListener, setConnected, setURLName, toString |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
---|
public Transport(Session session, URLName urlname)
session
- この Transport の Session オブジェクトurlname
- この Transport に使用される URLName オブジェクトメソッドの詳細 |
---|
public static void send(Message msg) throws MessagingException
Message
メソッド getAllRecipients
から返される) に、
各アドレスに適切なメッセージトランスポートを使用して送信されます。
send
メソッドは、メッセージを送信する前に、
メッセージ上で saveChanges
メソッドを呼び出します。メッセージの送信中、Transport により受信者アドレスの何れかについて無効である事が検出された場合、 SendFailedException がスローされます。 クライアントはこの例外を検査する事で、障害の詳細情報を得る事ができます。 メッセージが有効なアドレスに無事送信されているかどうかは、Transport 実装に依存します。 詳細については SendFailedException を参照して下さい。 又、送信が正常に終了した事は、メッセージが最終的な受信者に届いた事を意味しません。 配信の後の段階で障害が発生する事もあります。 Transport が受信者への配信に関するメッセージを受け取ったら、その後に発生する障害は、 配信されなかったメッセージの返信等、別の仕組みを通して報告される必要があります。
msg
- 送信するメッセージ
SendFailedException
- メッセージが受信者の一部又は全部に送信できなかった場合
MessagingException
Message.saveChanges()
,
Message.getAllRecipients()
,
send(Message, Address[])
,
SendFailedException
public static void send(Message msg, Address[] addresses) throws MessagingException
send
メソッドは、メッセージを送信する前に、
メッセージ上で saveChanges
メソッドを呼び出します。
msg
- 送信するメッセージaddresses
- メッセージ送信先のアドレス
SendFailedException
- メッセージが受信者の一部又は全部に送信できなかった場合
MessagingException
Message.saveChanges()
,
send(Message)
,
SendFailedException
public abstract void sendMessage(Message msg, Address[] addresses) throws MessagingException
静的な send
メソッドとは異なり、sendMessage
メソッドは、
メッセージ上で saveChanges
メソッドを呼び出しません。
呼び出し側がこの呼び出しを行う必要があります。
msg
- 送信される Messageaddresses
- このメッセージの送信先アドレスのリスト
SendFailedException
- 無効なアドレスの為に送信が失敗した場合
MessagingException
- 接続が終了している場合、又は接続状態にない場合TransportEvent
public void addTransportListener(TransportListener l)
ここで提供されるデフォルトの実装は、 このリスナーを内部の TransportListener リストに追加します。
l
- Transport イベントの ListenerTransportEvent
public void removeTransportListener(TransportListener l)
ここで提供されるデフォルトの実装は、 このリスナーを内部の TransportListener リストから削除します。
l
- リスナーaddTransportListener(javax.mail.event.TransportListener)
protected void notifyTransportListeners(int type, Address[] validSent, Address[] validUnsent, Address[] invalid, Message msg)
提供されるデフォルトの実装は、イベントを内部イベントキューに入れます。 イベントディスパッチャスレッドはキューからイベントを出し、 登録された TransportListener にディスパッチします。 イベントのディスパッチは別個のスレッドで起こるため、デッドロック問題を防ぎます。
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |