test

Sun GlassFish Enterprise Server v3 管理ガイド

JavaMail リソースの管理

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

次のような JavaMail 設定を指定できます。

ここでは、次のテーマを取り上げます。

ProcedureJavaMail リソースを作成する

JavaMail セッションリソースを作成するには、リモートモードでサブコマンド create-javamail-resource を使用します。JavaMail セッションリソースの JNDI 名は通例、mail/ の命名サブコンテキスト (例: mail/MyMailSession.) を含みます。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. create-javamail-resource(1) サブコマンドを使用して、JavaMail リソースを作成します。

    このサブコマンドのプロパティーについては、このマニュアルページに記載されています。

  3. 変更内容を適用するために、Enterprise Server を再起動します。

    「ドメインの再起動」を参照してください。

例 18–1 JavaMail リソースの作成

この例は、mail/MyMailSession という名前の JavaMail リソースを作成します。--fromaddress オプションでエスケープ文字 (\) を使用して、ドット (.) とアットマーク (@) を区別します。 


asadmin> create-javamail-resource --mailhost localhost 
--mailuser sample --fromaddress sample\@sun\.com mail/MyMailSession 
Command create-javamail-resource executed successfully.
参照

コマンド行に asadmin help create-javamail-resource と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

ProcedureJavaMail リソースを一覧表示する

既存の JavaMail セッションリソースを一覧表示するには、リモートモードで list-javamail-resources サブコマンドを使用します。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-javamail-resources(1) サブコマンドを使用して、JavaMail リソースを一覧表示します。

例 18–2 JavaMail リソースの一覧表示

この例は、localhost の JavaMail リソースを一覧表示します。


asadmin> list-javamail-resources 
mail/MyMailSession
Command list-javamail-resources executed successfuly.
参照

コマンド行に asadmin help list-javamail-resources と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。

ProcedureJavaMail リソースを更新する

  1. list-javamail-resources(1) サブコマンドを使用して、JavaMail リソースを一覧表示します。

  2. set(1) サブコマンドを使用して、指定した JavaMail リソースの値を変更します。

    リソースは、ドット表記名で指定します。

例 18–3 JavaMail リソースの更新

この例は、joeserver を joe に変更します。


asadmin> set server.resources.mail-resource.mail/
MyMailSession.user=joeserver.resources.mail-resource.mail/
MyMailSession.user=joe
Command set executed successfully.

ProcedureJavaMail リソースを削除する

JavaMail セッションリソースを削除するには、リモートモードで delete-javamail-resource サブコマンドを使用します。

始める前に

サブコマンド delete-javamail-resource を実行するには、指定のリソースへの参照を削除しておく必要があります。

  1. サーバーが実行されていることを確認します。

    リモートサブコマンドには、実行中のサーバーが必要です。

  2. list-javamail-resources(1) サブコマンドを使用して、JavaMail リソースを一覧表示します。

  3. delete-javamail-resource(1) サブコマンドを使用して、JavaMail リソースを削除します。

  4. 変更内容を適用するために、Enterprise Server を再起動します。

    「ドメインの再起動」を参照してください。

例 18–4 JavaMail リソースの削除

この例は、mail/MyMailSession という名前の JavaMail セッションリソースを削除します。


asadmin> delete-javamail-resource  mail/MyMailSession 
Command delete-javamail-resource executed successfully.
参照

コマンド行に asadmin help delete-javamail-resource と入力して、このサブコマンドの完全な構文とオプションを確認することもできます。