第 5 章 JavaMail リソースの設定

Application Server には JavaMail API が含まれています。JavaMail API はメールシステムをモデル化する一連の抽象 API です。この API は、メールとメッセージングアプリケーションを構築するための、プラットフォームにもプロトコルにも依存しないフレームワークを提供します。JavaMail API には、電子メッセージの読み取りと送信のための機能が備えられています。サービスプロバイダは特定のプロトコルを実装します。JavaMail API を使用して、アプリケーションに電子メール機能を追加できます。JavaMail は Java アプリケーションから、ネットワークまたはインターネット上の IMAP (Internet Message Access Protocol) および SMTP (メール転送プロトコル) 対応のメールサーバーにアクセスできます。メールサーバー機能はないため、JavaMail を使用するにはメールサーバーにアクセスする必要があります。

JavaMail API は、Java プラットフォームのオプションパッケージとして実装され、J2EE プラットフォームの一部としても使用できます。

Application Server には、JavaMail API とともに、アプリケーションコンポーネントがインターネットを介して電子メール通知を送信したり IMAP や POP3 メールサーバーからの電子メールを読んだりするための JavaMail サービスプロバイダが含まれています。

JavaMail API の詳細については、http://java.sun.com/products/javamail/ の JavaMail Web サイトを参照してください。

ここでは、次の内容について説明します。

JavaMail セッションの作成

Application Server で JavaMail を設定して使用するには、Application Server 管理コンソールでメールセッションを作成します。これにより、サーバー側コンポーネントとアプリケーションは、JavaMail サービスに割り当てられたセッションプロパティーを使用して、JNDI を使用して JavaMail サービスにアクセスできます。メールセッションを作成する際に、管理コンソールで、メールホスト、トランスポートプロトコルとストアプロトコル、およびデフォルトのメールユーザーを指定できるため、JavaMail を使用するコンポーネントはこれらのプロパティーを設定する必要がありません。Application Server は単一のセッションオブジェクトを作成して、JNDI を介してセッションオブジェクトを必要とするすべてのコンポーネントに使用できるようにするため、電子メールを大量に使用するアプリケーションで役立ちます。

管理コンソールを使用して JavaMail セッションを作成するには、「リソース」—>「JavaMail セッション」の順に選択します。次のように JavaMail 設定を指定します。

• 「JNDI 名」: メールセッションの一意な名前。JavaMail リソースのネーミングサブコンテキストプレフィックス mail/ を使用することをお勧めします。次に例を示します。mail/MySession

• 「メールホスト」: デフォルトメールサーバーのホスト名。プロトコル固有のホストプロパティーが提供されていない場合、Store オブジェクトと Transport オブジェクトの接続メソッドはこの値を使用します。この名前は実際のホスト名として解決可能でなければいけません。

• 「デフォルトユーザー」: メールサーバーへの接続時に渡されるユーザー名。プロトコル固有の username プロパティーが提供されていない場合、Store オブジェクトと Transport オブジェクトの接続メソッドはこの値を使用します。

• 「デフォルトの返信用アドレス」: デフォルトユーザーの電子メールアドレス。次の形式で入力します。username@host.domain

• 「説明」: コンポーネントの説明を入力します。

• 「状態」: このときメールセッションを有効にしない場合は、「有効」チェックボックスを選択解除します。

さらに、メールプロバイダが、デフォルト以外のストアやトランスポートプロトコルを使用するように設定し直した場合にのみ、次の詳細設定を定義します。

• 「ストアプロトコル」: 使用するストアオブジェクト通信の方法を定義します。デフォルトでは、ストアプロトコルは imap です。

• 「ストアプロトコルクラス」: 目的のストアプロトコルを実装するストア通信メソッドクラスを指定します。デフォルトでは、ストアプロトコルクラスは com.sun.mail.imap.IMAPStore です。

• 「転送プロトコル」: トランスポート通信の方法を指定します。デフォルトでは、トランスポートプロトコルは smtp です。

• 「転送プロトコルクラス」: トランスポートクラスの通信メソッドを定義します。デフォルトでは、トランスポートプロトコルクラスは com.sun.mail.smtp.SMTPTransport です。

• 「デバッグ」: このメールセッションのプロトコルトレースなど、追加のデバッグ出力を有効にするには、このチェックボックスにチェックマークを付けます。JavaMail のログレベルが「FINE」以上に設定されている場合は、デバッグ出力が生成され、それがシステムログファイルに記録されます。

• 「追加プロパティ」: プロトコル固有のホストやユーザー名のプロパティーなどアプリケーションに必要なプロパティーを作成します。JavaMail API マニュアルには、使用可能なプロパティーのリストがあります。