|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Object | +--com.nttdocomo.system.MailAgent
携帯電話のネイティブのメール機能にアクセスする手段を提供します。
メールの取得および送信(または保存)機能を提供します。
ネイティブデータへのアクセス機能およびそのXObjectとの関係の基本については、
XObject
クラスの説明を参照してください。
メール機能では、
メールの取得や送信を行うクラスと
メールそのものを表すクラスが区別されています。
このクラスはメールの取得や送信を行いますが、
メールそのものはMail
および
MailDraft
クラスのオブジェクトとして表されます。
getLastIncoming
メソッドにより、
最新のメールが未読メールの場合、そのメールを取得することができます。
取得されたメール(Mail
オブジェクト)には、
サブジェクト(XString)、
日付(XStringとして取得可能)、
宛先アドレス(XString)、
差出人アドレス(XString)およびその電話帳IDが設定されています。
メールを新規に作成し、送信(または保存)するためには、
send(String, String[], String)
メソッドまたは
send(String, XString, String)
メソッドを直接呼び出すか、
MailDraft
オブジェクトに対して宛先等を設定して
send(MailDraft)
メソッドを呼び出します。
ネイティブのユーザインタフェースを介して、
メールの送信(または保存)を行うことができます。
送信の成否にかかわらず、
送信に使用したMailDraftオブジェクトの状態は変化しません。
空文字列の宛先アドレスは、不正であるとみなされます。
ミニマムスペック:
Mail
,
MailDraft
メソッドの概要 | |
static Mail |
getLastIncoming()
最新の未読メールを取得します。 |
static boolean |
send(MailDraft mail)
ユーザ操作によりメールを送信します。 |
static boolean |
send(String subject,
String[] addresses,
String body)
ユーザ操作によりメールを送信します。 |
static boolean |
send(String subject,
XString address,
String body)
ユーザ操作によりメールを送信します。 |
クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
メソッドの詳細 |
public static Mail getLastIncoming()
取得されたメール(Mail
オブジェクト)には、
サブジェクト(XString)、
日付(XStringとして取得可能)、
宛先アドレス(XString)、
差出人アドレス(XString)およびその電話帳IDが設定されています。
このメソッドを利用して最新の未読メールを取得しても、 端末のメールピクトやそのメールの未読情報は変化しません。
パーミッションとして携帯電話情報の参照が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。
SecurityException
- パーミッションとして携帯電話情報の参照が許可されているが、
iアプリ個別のユーザ設定により許可されない場合に発生します。
SecurityException
- メールロックにより拒否される場合に発生します。
SecurityException
- ネイティブ独自のセキュリティ設定により、
メールを取得できない場合に発生します。
public static boolean send(String subject, String[] addresses, String body) throws MailException, InterruptedOperationException, StoreException
送信処理においてサーバが正常応答を返した場合、true を返します。 送信処理中にサーバがエラーを返した場合、MailExceptionをスローします。 送信せずに保存した場合も含めて、それ以外の場合には false を返します。 宛先が複数の場合、いずれかの宛先へのメールの送信に失敗した場合、 その失敗の原因に応じて例外を発生またはfalseを返します。 すべての宛先への送信が成功した場合、true を返します。
パーミッションとしてネイティブメーラの利用が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。 このメソッドを呼び出すとサスペンドします。
[DoJa-3.5]
FOMA 端末で、マルチタスク機能によってメーラが起動されていて未保存のデータがある状態の時にこのメソッドが呼ばれた場合、
現在実行中のJavaアプリケーションはサスペンドされ、
ユーザ確認のダイアログが表示されます。
ユーザがメーラの起動を許可した場合は、
ユーザ操作によりメールを送信します。
ユーザが起動を許可しなかった場合は、
このメソッドから戻ってJavaアプリケーションの実行を継続します。
subject
- サブジェクト(通常文字列)を指定します。addresses
- 宛先アドレス(通常文字列)を配列で指定します。body
- 本文(通常文字列)を指定します。
IllegalStateException
- 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
NullPointerException
- 引数 addresses が null でない場合に、
配列中に null の要素があった場合に発生します。
IllegalArgumentException
- 端末がサポートしている数以上のメールアドレスを指定した場合に
発生します。
IllegalArgumentException
- 引数 subject、addresses、bodyの内容のいずれかが、
iモードメールの仕様に準拠していない場合に発生します。
IllegalArgumentException
- メール全体のサイズが
iモードメールの仕様に準拠していない場合に発生します。
SecurityException
- ロック機能などのネイティブ独自のセキュリティ設定により、
メールを送信できない場合に発生します。
StoreException
- 送信または未送信フォルダにメールを追加できないため、
メールを送信できない場合に発生します(STORE_FULL)。
MailException
- User Unknownなどによりサーバ側からメール送信を拒否された場合に発生します。
InterruptedOperationException
- 競合条件などにより、送信操作が異常終了した場合に発生します。
public static boolean send(String subject, XString address, String body) throws MailException, InterruptedOperationException, StoreException
送信処理においてサーバが正常応答を返した場合、true を返します。 送信処理中にサーバがエラーを返した場合、MailExceptionをスローします。 送信せずに保存した場合も含めて、それ以外の場合には false を返します。 宛先が複数の場合、いずれかの宛先へのメールの送信に失敗した場合、 その失敗の原因に応じて例外を発生またはfalseを返します。 すべての宛先への送信が成功した場合、true を返します。
パーミッションとしてネイティブメーラの利用が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。 このメソッドを呼び出すとサスペンドします。
[DoJa-3.5]
FOMA 端末で、マルチタスク機能によってメーラが起動されていて未保存のデータがある状態の時にこのメソッドが呼ばれた場合、
現在実行中のJavaアプリケーションはサスペンドされ、
ユーザ確認のダイアログが表示されます。
ユーザがメーラの起動を許可した場合は、
ユーザ操作によりメールを送信します。
ユーザが起動を許可しなかった場合は、
このメソッドから戻ってJavaアプリケーションの実行を継続します。
subject
- サブジェクト(通常文字列)を指定します。address
- 宛先アドレス(XString)を指定します。body
- 本文(通常文字列)を指定します。
IllegalStateException
- 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
IllegalArgumentException
- 引数 subject、address、bodyの内容のいずれかが、
iモードメールの仕様に準拠していない場合に発生します。
IllegalArgumentException
- メール全体のサイズが
iモードメールの仕様に準拠していない場合に発生します。
SecurityException
- ロック機能などのネイティブ独自のセキュリティ設定により、
メールを送信できない場合に発生します。
StoreException
- 送信または未送信フォルダにメールを追加できないため、
メールを送信できない場合に発生します(STORE_FULL)。
MailException
- User Unknownなどによりサーバ側からメール送信を拒否された場合に発生します。
InterruptedOperationException
- 競合条件などにより、送信操作が異常終了した場合に発生します。
public static boolean send(MailDraft mail) throws MailException, InterruptedOperationException, StoreException
送信処理においてサーバが正常応答を返した場合、true を返します。 送信処理中にサーバがエラーを返した場合、MailExceptionをスローします。 送信せずに保存した場合も含めて、それ以外の場合には false を返します。 宛先が複数の場合、いずれかの宛先へのメールの送信に失敗した場合、 その失敗の原因に応じて例外を発生またはfalseを返します。 すべての宛先への送信が成功した場合、true を返します。
パーミッションとしてネイティブメーラの利用が許可されている トラステッドiアプリのみこのメソッドを呼び出すことができます。 このメソッドを呼び出すとサスペンドします。
[DoJa-3.5]
FOMA 端末で、マルチタスク機能によってメーラが起動されていて未保存のデータがある状態の時にこのメソッドが呼ばれた場合、
現在実行中のJavaアプリケーションはサスペンドされ、
ユーザ確認のダイアログが表示されます。
ユーザがメーラの起動を許可した場合は、
ユーザ操作によりメールを送信します。
ユーザが起動を許可しなかった場合は、
このメソッドから戻ってJavaアプリケーションの実行を継続します。
IllegalStateException
- 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
NullPointerException
- 引数 mail が null の場合に発生します。
IllegalArgumentException
- メール全体のサイズが
iモードメールの仕様に準拠していない場合に発生します。
SecurityException
- ロック機能などのネイティブ独自のセキュリティ設定により、
メールを送信できない場合に発生します。
StoreException
- 送信または未送信フォルダにメールを追加できないため、
メールを送信できない場合に発生します(STORE_FULL)。
MailException
- User Unknownなどによりサーバ側からメール送信を拒否された場合に発生します。
InterruptedOperationException
- 競合条件などにより、送信操作が異常終了した場合に発生します。
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
NTT DoCoMo,Inc.
本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。
Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。
「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。