Web サーバーで Java™ サーブレットを管理する
サーブレットはブラウザの要求に応えて Web サーバーで稼働する Java™ プログラムです。Domino® のサーブレットは、Oracle が発行しているオープンスタンダードの「Java™ サーブレット API 仕様」に準拠している必要があります。
このタスクについて
個々のサーブレットの特殊プロパティは、servlets.properties という名前のテキストファイルで指定します。このファイルは、Domino® データディレクトリに置かれています。Java™ サーブレットと servlets.properties ファイルの作成の詳細については、「HCL Domino® Designer ヘルプ」を参照してください。
手順
- 編集するサーバー文書を開きます。
-
[Java サーブレット] で、次のフィールドに必要な情報を設定します。
タブをクリックします。
表 1. Java™ サーブレットフィールド フィールド
アクション
Java™ サーブレットサポート
新しく作成したグループのオプションとして、
- [なし] (デフォルト) -- HTTP タスク起動時に Java™ 仮想マシン (JVM) やサーブレットマネージャがロードされません。
- [Domino® Servlet Manager] -- JVM と Domino® にバンドルされているサーブレットマネージャがロードされます。
- [サードパーティのサーブレットサポート] -- JVM はロードされますが、Domino® サーブレットマネージャはロードされません。IBM® WebSphere® などの Domino® 以外のサーブレットマネージャを使用する場合に選択します。
サーブレット URL パス
URL がサーブレットを参照することを Domino® に伝える URL のパスを入力します。デフォルトは、/servlet です。
クラスパス
サーブレットマネージャと JVM がサーブレットと従属クラスを検索するパスを入力します。Domino® でインストールされる標準の Java™ ライブラリには、自動的にそのクラスのパスが指定されます。この設定により、パスを追加設定できます。また、ディレクトリ、JAR ファイル、ZIP ファイルを指定できます。パスは Domino® データディレクトリからの相対パスか絶対パスです。以下に例を示します。
- domino\servlet は、c:\lotus\domino\data\domino\servlet ディレクトリのファイルを指定します
- c:\apps\myservlets は、c:\apps\myservlets ディレクトリのファイルを指定します
- c:\javamail\mail.jar は、c:\javamail ディレクトリの mail.jar ファイルを指定します
- domino\servlet\sql.zip は、c:\lotus\domino\data\domino\servlet ディレクトリの sql.zip ファイルを指定します
デフォルトは以下のアイコンです。 domino\servlet
サーブレットファイル拡張子
URL がサーブレットを参照することを Domino® に伝える URL のファイル拡張子のリストを入力します。拡張子はそれぞれ servlets.properties ファイルの文により単独のサーブレットにマッピングされる必要があります。デフォルトは、拡張子がありません。
セッション状態トラッキング
新しく作成したグループのオプションとして、
- [有効] (デフォルト) -- Domino® サーブレットマネージャが定期的にすべての HttpSession インスタンスのユーザーの使用状況を調べます。[アイドル状態のセッションのタイムアウト] フィールドで指定した期間にアイドル状態にあるセッションは、自動的に終了します。サーブレットマネージャは HttpSession.invalidate() を呼び出し、サーブレットにセッションが終了することを通知します。
- [無効] -- ユーザーの使用状況は調べられません。
Domino® では、サーブレットが Java™ サーブレット API の HttpSession インターフェースを使用している場合のみ、この設定と次の 3 つの設定が使用されます。HttpSession インターフェースのサポートは、Domino® HTTP セッションの認証機能とは完全に別のものです。
アイドル状態のセッションのタイムアウト
セッションが終了する前にユーザーがアイドル状態でいられる合計時間 (分単位) を入力します。デフォルトは 30 分間です。
最大セッション数
同時にアクティブになれるセッション数を入力します。デフォルトは 1000 です。限度値に達すると、一番長くアイドル状態にあるセッションは終了します。
セッションの保持
新しく作成したグループのオプションとして、
- [有効] -- HTTP タスクが存在する場合、セッションデータは Domino® データディレクトリにある sessdata.ser と呼ばれるディスクファイルに保存されます。Domino® データディレクトリにあるデータは、Domino® によって sessdata.ser という名前のファイルに保存されます。HTTP タスクの再起動時に Domino® によってセッションデータは再ロードされます。また、Domino® では、オブジェクトに java.io.Serializable インターフェースが使用されている場合は、サーブレットがセッションにバインドしているオブジェクトも保存されます。
- [無効] (デフォルト) -- HTTP タスクが存在する場合、すべてのセッションデータが破棄されます。
- サーブレットエンジンで適切な場合は、Web ブラウザ経由でサーブレットファイルへのアクセス権を持つユーザーを特定することにより、サーブレットへのアクセスを制御します。