com.kddi.io
インタフェース IMAP4MailConnection　[Phase2〜]

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

javax.microedition.io.Connection

public interface IMAP4MailConnection

extends javax.microedition.io.Connection

IMAP4 メールを扱うための Connection インターフェイスです。

Connector.open メソッドの "mailto:" スキームに対応します。

 // Connection を開く。
 IMAP4MailConnection conn =
     ( IMAP4MailConnection ) Connector.open( "mailto://someone@somewhere.example.com" );
                                          // "//" は省略できます。

 // 送信先を追加。
 conn.addTo( "anyone@example.com" );

 // カーボンコピー送信先を追加。
 conn.addCc( "myself@example.com" );

 // ブラインドカーボンコピー送信先を追加。
 PersonalInfo friend = AddressBook.getEmailAddress();
 conn.addBcc( friend );

 // 件名を設定。
 conn.setSubject( "Hello" );

 // 本文を設定。
 conn.setContent( "Hello, everybody!" );

 // 送信。
 conn.send();

 // メールクライアント動作中は send() から戻らない。

 // Connection を閉じる。
 conn.close();
 

メソッドの概要

void	addBcc(PersonalInfo person) Bcc: の追加。
void	addBcc(java.lang.String address) Bcc: の追加。
void	addCc(PersonalInfo person) Cc: の追加。
void	addCc(java.lang.String address) Cc: の追加。
void	addTo(PersonalInfo person) To: の追加。
void	addTo(java.lang.String address) To: の追加。
java.lang.String[]	getBcc() ブラインドカーボンコピー送信先リストの取得。
java.lang.String[]	getCc() カーボンコピー送信先リストの取得。
java.lang.String	getContent() 本文の取得。
long	getLength() 本文の長さを取得。
java.lang.String	getSubject() 件名の取得。
java.lang.String[]	getTo() 送信先リストの取得。
void	send() メールの送信。
void	setContent(java.lang.String content) 本文の設定。
void	setSubject(java.lang.String subject) 件名の設定。

インタフェース javax.microedition.io.Connection から継承したメソッド

close

メソッドの詳細

addTo

public void addTo(java.lang.String address)
           throws java.io.IOException,
                  java.lang.IllegalArgumentException

To: の追加。

追加できるアドレスの長さは 64 バイト以内です。

パラメータ:

address - 送信先。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な address が指定されたときに送出。

addTo

public void addTo(PersonalInfo person)
           throws java.io.IOException,
                  java.lang.IllegalArgumentException

To: の追加。

パラメータ:

person - 送信先。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な address が指定されたときに送出。

getTo

public java.lang.String[] getTo()
                         throws java.io.IOException

送信先リストの取得。

戻り値:

To: フィールドに含まれているアドレスの配列。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

addCc

public void addCc(java.lang.String address)
           throws java.io.IOException,
                  java.lang.IllegalArgumentException

Cc: の追加。

追加できるアドレスの長さは 64 バイト以内です。

パラメータ:

address - カーボンコピーの送信先。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な address が指定されたときに送出。

addCc

public void addCc(PersonalInfo person)
           throws java.io.IOException,
                  java.lang.IllegalArgumentException

Cc: の追加。

パラメータ:

person - カーボンコピーの送信先。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な address が指定されたときに送出。

getCc

public java.lang.String[] getCc()
                         throws java.io.IOException

カーボンコピー送信先リストの取得。

戻り値:

Cc: フィールドに含まれているアドレスの配列。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

addBcc

public void addBcc(java.lang.String address)
            throws java.io.IOException,
                   java.lang.IllegalArgumentException

Bcc: の追加。

追加できるアドレスの長さは 64 バイト以内です。

パラメータ:

address - ブラインドカーボンコピーの送信先。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な address が指定されたときに送出。

addBcc

public void addBcc(PersonalInfo person)
            throws java.io.IOException,
                   java.lang.IllegalArgumentException

Bcc: の追加。

パラメータ:

person - ブラインドカーボンコピーの送信先。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な address が指定されたときに送出。

getBcc

public java.lang.String[] getBcc()
                          throws java.io.IOException

ブラインドカーボンコピー送信先リストの取得。

戻り値:

Bcc: フィールドに含まれているアドレスの配列。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

setContent

public void setContent(java.lang.String content)
                throws java.io.IOException,
                       java.lang.IllegalArgumentException

本文の設定。

設定できる本文の長さは 1000 バイト以内です。

パラメータ:

content - 本文。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な content が指定されたときに送出。

getContent

public java.lang.String getContent()
                            throws java.io.IOException

本文の取得。

戻り値:

本文。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

setSubject

public void setSubject(java.lang.String subject)
                throws java.io.IOException,
                       java.lang.IllegalArgumentException

件名の設定。

設定できる件名の長さは 100 バイト以内です。

パラメータ:

subject - 件名。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

java.lang.IllegalArgumentException - 不正な subject が指定されたときに送出。

getSubject

public java.lang.String getSubject()
                            throws java.io.IOException

件名の取得。

戻り値:

件名。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

send

public void send()
          throws java.io.IOException

メールの送信。

例外:

java.io.IOException - I/O エラーが発生したときに送出。

getLength

public long getLength()
               throws java.io.IOException

本文の長さを取得。

戻り値:

本文の長さ（バイト数）。

例外:

java.io.IOException - I/O エラーが発生したときに送出。