15.4. ハンドラーの設定
JBoss EAP では、次の 2 種類のハンドラーを設定できます。
- ファイルハンドラー
- リバースプロキシーハンドラー
ファイルハンドラー は静的ファイルを提供します。各ファイルハンドラーは仮想ホストの場所にアタッチされている必要があります。リバースプロキシーハンドラー を使用すると、JBoss EAP は高性能なリバースプロキシーとして機能できます。
15.4.1. ハンドラーを設定するためのデフォルトの Undertow サブシステム設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss EAP はデフォルトでファイルハンドラーを提供します。このリファレンスでは、ハンドラーの Undertow サブシステムのデフォルト設定について説明します。
<subsystem xmlns="{UndertowSubsystemNamespace}" default-server="default-server" default-virtual-host="default-host" default-servlet-container="default" default-security-domain="other">
<buffer-cache name="default"/>
<server name="default-server">
...
</server>
<servlet-container name="default">
...
</servlet-container>
<handlers>
<file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
</handlers>
</subsystem>
15.4.2. 管理 CLI を使用してファイルハンドラーを管理する リンクのコピーリンクがクリップボードにコピーされました!
この手順では、管理 CLI を使用して Undertow サブシステム内のファイルハンドラーを管理する方法について説明します。必要に応じて、既存のファイルハンドラーを更新したり、新しいファイルハンドラーを作成したり、ファイルハンドラーを削除したりできます。
前提条件
- 管理 CLI にアクセスできる。
- サーバー設定を変更する権限がある。
手順
既存のファイルハンドラーの更新
- 管理 CLI へ接続します。
ファイルハンドラーの属性を更新するには、次のコマンドを実行します。
---- /subsystem=undertow/configuration=handler/file=welcome-content:write-attribute(name=case-sensitive,value=true) ----変更を適用するには、サーバーをリロードします。
---- reload ----
新規ファイルハンドラーの作成
- 管理 CLI へ接続します。
新しいファイルハンドラーを作成するには、次のコマンドを実行します。
---- /subsystem=undertow/configuration=handler/file=new-file-handler:add(path="${jboss.home.dir}/welcome-content") ----[WARNING] ==== If you set a file handler's `path` directly to a file instead of a directory, any `location` elements that reference that file handler must not end with a forward slash (`/`). Otherwise, the server will return a `404 - Not Found` response. ====
ファイルハンドラーの削除
- 管理 CLI へ接続します。
ファイルハンドラーを削除するには、次のコマンドを実行します。
---- /subsystem=undertow/configuration=handler/file=new-file-handler:remove ----変更を適用するには、サーバーをリロードします。
---- reload ----