com.j_phone.system
クラス MailAgent

java.lang.Object
  |
  +--com.j_phone.system.MailAgent

public class MailAgent
extends java.lang.Object

MailAgentクラスは、メールの送受信処理を行うためのクラスです。

メールの送受信はgetInstance()メソッドによって取得した MailAgentインスタンスによって行います。

メールを送信する場合、 メールの送受信の結果を待ち受けるリスナをsetMailTransportListener()によって設定し、 send()メソッドによって送信します。

メールサーバから受信していないメールの続きを受信する場合、 メールの送受信の結果を待ち受けるリスナをsetMailTransportListener()によって設定し、 receiveRemainder()メソッドによって受信します。 メールデータに受信していない続きがあるかどうかは、MailDataインタフェースのhasRemainder()メソッドによって取得します。

導入されたバージョン:
JSCL 1.2

メソッドの概要
 int checkMailSize(MailData data)
          メールの送信サイズを取得します。
static MailAgent getInstance()
          唯一の MailAgent インスタンスを取得します。
 void receiveRemainder(MailData data)
          メールサーバから受信していないメールの続きを受信します。
 void send(MailData data)
          メールを送信します。
 void setMailTransportListener(MailTransportListener listener)
          メールの送受信の結果を待ち受けるリスナを設定します。
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

getInstance

public static MailAgent getInstance()
唯一の MailAgent インスタンスを取得します。

MailAgent の操作を行う場合は、このメソッドでインスタンスを取得して下さい。

戻り値:
MailAgent のインスタンス

setMailTransportListener

public void setMailTransportListener(MailTransportListener listener)
メールの送受信の結果を待ち受けるリスナを設定します。
パラメータ:
listener - 登録するリスナ

send

public void send(MailData data)
          throws java.io.IOException
メールを送信します。 送信結果は、setMailTransportListener()メソッドで設定したMailTransportListenerに通知されます。 メール送信後はネイティブシステムの送信メールボックスの内容が変わるため、送信メールボックスのメールデータの再取得を行ってください。
パラメータ:
data - メールデータ
例外:
SecurityException - アクセスの制限された Java アプリケーションから呼び出された場合、またはユーザーキャンセルの場合に発生する
NullPointerException - dataに null が指定された場合に発生する
java.lang.IllegalArgumentException - フォーマットエラーの場合に発生する
IllegalStateException - 受信中又は送信中の場合に発生する
java.io.IOException - 送信できなかった場合に発生する

receiveRemainder

public void receiveRemainder(MailData data)
                      throws java.io.IOException
メールサーバから受信していないメールの続きを受信します。 受信結果は、setMailTransportListener()メソッドで設定したMailTransportListenerに通知されます。 メール受信後はネイティブシステムの受信メールボックスの内容が変わるため、受信メールボックスのメールデータの再取得を行ってください。
パラメータ:
data - メールデータ
例外:
NullPointerException - dataに null が指定された場合に発生する
IllegalStateException - 受信中又は送信中の場合に発生する
java.io.IOException - 受信できなかった場合に発生する
SecurityException - ユーザーキャンセルの場合に発生する

checkMailSize

public int checkMailSize(MailData data)
                  throws java.io.IOException
メールの送信サイズを取得します。 指定されたメールデータを送信するときの送信サイズを返します。
パラメータ:
data - メールデータ
戻り値:
送信時サイズ(単位はバイト)
例外:
NullPointerException - dataに null が指定された場合に発生する
java.lang.IllegalArgumentException - フォーマットエラーの場合に発生する
java.io.IOException - サイズチェックが行えない場合に発生する