この章では、JavaMail API を使用するアプリケーションのリソースを設定する方法について説明します。この章には次の節が含まれています。
JavaMail API はメールシステムをモデル化する一連の抽象 API です。この API は、メールおよびメッセージングアプリケーションを構築するための、プラットフォームにもプロトコルにも依存しないフレームワークを提供します。JavaMail API では電子メールの送受信機能が提供されます。サービスプロバイダは特定のプロトコルを実装します。
JavaMail API は、Java プラットフォームのオプションパッケージとして実装され、また J2EE プラットフォームの一部としても利用できます。
Application Server には、JavaMail API とともに、アプリケーションコンポーネントがインターネットを介して電子メール通知を送信したり IMAP や POP3 メールサーバーからの電子メールを読んだりするための JavaMail サービスプロバイダが含まれています。
JavaMail API の詳細については、JavaMail Web サイト (http://java.sun.com/products/javamail/) を参照してください。
ツリーコンポーネントで、「リソース」ノードを開き、次に「JavaMail セッション」ノードを選択します。
「JavaMail セッション」ページで、「新規」をクリックします。
「JavaMail セッションを作成」ページが表示されます。
「JNDI 名」フィールドに、セッション名を入力します。
JavaMail リソースのネーミングサブコンテキストプレフィックス mail/ を使用することをお勧めします。次に例を示します。mail/MySession
「メールホスト」フィールドに、デフォルトメールサーバーのホスト名を入力します。
プロトコル固有のホストプロパティーが提供されていない場合、Store オブジェクトと Transport オブジェクトの接続メソッドはこの値を使用します。この名前は実際のホスト名として解決可能でなければいけません。
「デフォルトユーザー」フィールドで、メールサーバーへの接続時に渡すユーザー名を入力します。
プロトコル固有の username プロパティーが提供されていない場合、Store オブジェクトと Transport オブジェクトの接続メソッドはこの値を使用します。
「デフォルトの返信用アドレス」フィールドで、デフォルトユーザーの電子メールアドレスを username@host.domain の形式で入力します。
このときメールセッションを有効にしない場合は、「有効」チェックボックスを選択解除します。
デフォルト以外のストアやトランスポートプロトコルを使用するように Application Server のメールプロバイダを設定し直した場合にのみ、「詳細」フィールドでフィールド値を変更します。
デフォルトで、ストアプロトコルは imap、ストアプロトコルクラスは com.sun.mail.imap.IMAPStore、トランスポートプロトコルは smtp、トランスポートプロトコルクラスは com.sun.mail.smtp.SMTPTransport になっています。
このメールセッションのプロトコルトレースなど、ほかのデバッグ出力を有効にするには、「デバッグ」チェックボックスにチェックマークを付けます。
JavaMail のログレベルを FINE またはそれ以上に設定した場合、デバッグ出力が生成され、システムのログファイルに取り込まれます。ログレベルの設定の詳細については、「ログレベルを設定する」を参照してください。
プロトコル固有のホストや username プロパティーなど、アプリケーションが必要とするプロパティーを追加するには、「追加プロパティー」フィールドで「プロパティーを追加」をクリックします。
JavaMail API マニュアルには、使用可能なプロパティーのリストがあります (http://java.sun.com/products/javamail/javadocs/index.html)。
「ターゲット」領域で、次を実行します。
「了解」をクリックして、セッションを保存します。
create-javamail-resource
ツリーコンポーネントで、「リソース」ノードを開き、次に「JavaMail セッション」ノードを選択します。
「JavaMail セッション」ページで、編集するセッションを選択します。
「JavaMail セッションを編集」ページで、次のタスクを実行できます。
「ターゲット」タブをクリックして、「JavaMail セッションターゲット」ページを表示します。このページで、次を実行します。
「保存」をクリックして変更を保存するか、または「デフォルトを読み込み」をクリックしてメールセッションのデフォルト値を復元します。
ツリーコンポーネントで、「リソース」ノードを開き、次に「JavaMail セッション」ノードを選択します。
「JavaMail セッション」ページで、削除するセッション名のとなりのチェックボックスにチェックマークを付けます。
「削除」をクリックします。
delete-javamail-resource