com.nttdocomo.system
クラス Mail

Object
  |
  +--com.nttdocomo.system.Mail

すべての実装インタフェース:

MailConstants

public final class Mail

extends Object

implements MailConstants

ネイティブのメーラから取得したメールを定義します。

ネイティブデータへのアクセス機能およびそのXObjectとの関係の基本については、 XObjectクラスの説明を参照してください。

メール機能では、メールの取得や送信を行うクラスと メールそのものを表すクラスが区別されています。 このクラスはメールそのものを表しますが、 メールの取得や送信はMailAgentクラスで行います。

MailAgent.getLastIncomingメソッドにより、 未読メール中で最新のメール1通を取得することができます。 取得されたメール(Mailオブジェクト)には、 サブジェクト(XString)、 日付(XStringとして取得可能)、 宛先アドレス(XString)、 差出人アドレス(XString)およびその電話帳IDが設定されています。 本文を取得することはできません。

導入されたバージョン:

DoJa-3.0

関連項目:

Mail

フィールドの概要

インタフェース com.nttdocomo.system.MailConstants から継承したフィールド

ADDRESS_DOMAIN, ADDRESS_FULL, ADDRESS_USER, RECEIVED, SENT, UNSENT

メソッドの概要

XString	getDateString(String pattern) 送信日時(XString)を取得します。
XString	getFrom(int part) 差出人アドレス(XString)を取得します。
int[][]	getPhoneBookID() 差出人の電話帳エントリのIDを取得します。
XString[]	getRecipients(int part) 宛先アドレス(XString)を取得します。
XString	getSubject() サブジェクト(XString)を取得します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getDateString

public XString getDateString(String pattern)

送信日時(XString)を取得します。 日時のフォーマットの指定方法については、 CallRecordの説明を参照してください。

パラメータ:

pattern - 日時のフォーマットを記述するパターンを指定します。

戻り値:

送信日時を返します。

例外:

NullPointerException - 引数 pattern が null である場合に発生します。

IllegalArgumentException - 引数 pattern に不正なフォーマット文字列が指定された場合に発生します。

getSubject

public XString getSubject()

サブジェクト(XString)を取得します。

戻り値:

サブジェクトを返します。 サブジェクトがない場合、空文字列のXStringを返します。

getFrom

public XString getFrom(int part)

差出人アドレス(XString)を取得します。

パラメータ:

part - アドレス中の取得する部分を指定します。 ADDRESS_FULL、 ADDRESS_USER、 ADDRESS_DOMAIN のいずれかを指定します。

戻り値:

差出人アドレスを返します。

例外:

IllegalArgumentException - 引数 part の値が不正な場合に発生します。

getPhoneBookID

public int[][] getPhoneBookID()

差出人の電話帳エントリのIDを取得します。 差出人のメールアドレスが登録されている電話帳エントリのIDを返します。

戻り値の配列をint [][] idとすると、 id[i][0]には、i番目に見つかった電話帳エントリIDそのものが返ります。 id[i][1]には、その電話帳エントリに登録されているメールアドレス中の インデックス値が返ります。 すなわち、相手のメールアドレスは、
PhoneBook.getEntry(id[i][0]).getMailAddress(id[i][1], ADDRESS_FULL)です。

複数のエントリにマッチする場合、 そのすべてのエントリを返すかどうかは機種依存ですが、 少なくとも1つのエントリの情報を返します。

戻り値:

相手の電話帳エントリIDを返します。 電話帳エントリに登録されていない場合、 nullが返ります。 返される配列は、このオブジェクトが内部で保持している配列のコピーです。

getRecipients

public XString[] getRecipients(int part)

宛先アドレス(XString)を取得します。
自分以外の宛先アドレスがない場合、null が返ります。 したがって、PDC 端末では常に null が返ります。

パラメータ:

part - アドレス中の取得する部分を指定します。 ADDRESS_FULL、 ADDRESS_USER、 ADDRESS_DOMAIN のいずれかを指定します。

戻り値:

宛先アドレスを配列で返します。 自分以外の宛先アドレスがない場合、nullを返します。 返される配列は、このオブジェクトが内部で保持している配列のコピーです。

例外:

IllegalArgumentException - 引数 part の値が不正な場合に発生します。