SimpleAuthenticator

１．まずは簡単そうなやつから

まずは、一番簡単そうな「ユーザＩＤ／パスワードの入力」を行うコンポーネントを作ってみます。

２．JavaMailにおける認証について

コンポーネントの説明の前に、まずJavaMailにおける認証について説明します。
JavaMail APIを利用する際には、まずSession オブジェクトを作成します。
また、Sessionオブジェクトは直接newで作成することはできず、必ずstaticメソッド getInstance()メソッド、または getDefaultInstance()メソッドを呼び出して作成します。

public static Session getInstance(java.util.Properties props,
                                  Authenticator authenticator)

public static Session getDefaultInstance(java.util.Properties props,
                                         Authenticator authenticator)

第１引数にはPropertiesオブジェクトを指定します。ここで指定した内容に基づき、JavaMailの各クラスの動作を指定します。
特に指定する必要が無い場合には、System.getProperties()を渡しておけば良いみたいです。
第２引数にはjavax.mail.Authenticator を指定するようになっています。（このAuthenticatorは、Java2から導入されたjava.net.Authenticatorとは別物です）


ここで指定したAuthenticatorオブジェクトは、メールサーバからの認証が要求された際に、JavaMailから使用されます。
JavaMailは、認証に必要となるユーザＩＤ／パスワードの組み合わせを、Authenticatorに問い合わせます。 問い合わせを受けたAuthenticatorオブジェクトは、ユーザＩＤ／パスワードを含んだ javax.mail.PasswordAuthentication オブジェクトを返します。
（このPasswordAuthenticationは、Java2から導入されたjava.net.PasswordAuthenticationとは別物です） このように、ユーザＩＤ／パスワードを指定する方法がAuthenticatorという形で分離されているおかげで、 認証方法を割と自由に設定できるようになっています。 例えば、設定ファイルからユーザＩＤ／パスワードを読み込んでもよいし、ＩＣカードによる認証も考えられます。
プログラマは、任意の方法でPasswordAuthenticationを作成するAuthenticatorのサブクラスを定義し、 Sessionのインスタンスを作成する際に引数として渡せば良いわけです。

３．SimpleAuthenticator

「画面上にダイアログを表示し、ユーザＩＤ／パスワードを入力させる」というAuthenticatorのサブクラスを作ってみました。
使い方はとても簡単です。

// SimpleAuthenticatorをインポートする。
import jp.gr.java_conf.roadster.beans.mail.SimpleAuthenticator;
//...
// Authenticatorオブジェクトを作成する。
Authenticator auth = new SimpleAuthenticator(frame); // frame は親Frameのインスタンス
Session session = Session.getInstance(props, auth);

これで、メールサーバからの認証が要求された時点で画面上にこのようなダイアログボックスが表示されるようになります。

４．ダウンロード

ダウンロードは、My classesのページからできます。

５．次回予告

次回は、「フォルダをツリー表示するコンポーネント」を作成してみます。