Apache Tomcat 11 設定リファレンス

• はじめに
• 属性
  1. 共通属性
  2. 標準実装
• ネストされたコンポーネント
• 特別な機能

Resources要素は、Webアプリケーションで利用可能なすべてのリソースを表します。これには、クラス、JARファイル、HTML、JSP、およびWebアプリケーションに貢献するその他のファイルが含まれます。これらのリソースのソースとしてディレクトリ、JARファイル、WARを使用する実装が提供されており、リソースの実装は、データベースやバージョン管理されたリポジトリに保存されたファイルなどの他の形式のファイルをサポートするように拡張できます。

リソースはデフォルトでキャッシュされます。

注: ファイルシステムに基づかないResources実装でWebアプリケーションを実行できるのは、Webアプリケーションが自身のリソースへの直接ファイルシステムアクセスに依存せず、ServletContextインターフェースのメソッドを使用してそれらにアクセスする場合のみです。

Resources要素は、Contextコンポーネント内にネストすることができます。含まれていない場合、デフォルトのファイルシステムベースのResourcesが自動的に作成され、これはほとんどの要件で十分です。

Webアプリケーションのメインリソースは、Contextで定義されたdocBaseによって定義されます。追加の設定やリソースは、1つ以上のネストされたコンポーネントを定義することによってWebアプリケーションで利用可能にすることができます。

PreResources

PreResourcesはメインリソースの前に検索されます。これらは定義された順序で検索されます。PreResourcesを設定するには、<Resources>要素の内部に<PreResources>要素を以下の属性と共にネストします

JARリソース

JarResourcesはメインリソースの後に検索されますが、PostResourcesの前に検索されます。これらは定義された順序で検索されます。JarResourcesを設定するには、<Resources>要素の内部に<JarResources>要素をネストします。設定属性はPreResourcesと同じです。

Webアプリケーションの起動中、JARスキャンプロセスはスキャンされたJARの/META-INF/resources下のコンテンツをチェックします。見つかった場合、この静的コンテンツはJarResourcesに追加されます。

Post-resources

PostResourcesはリソースJARの後に検索されます。これらは定義された順序で検索されます。PostResourcesを設定するには、<Resources>要素の内部に<PostResources>要素をネストします。設定属性はPreResourcesと同じです。

順序

上記のリソースセットに加えて、標準実装は/WEB-INF/classesにマッピングされたJARファイルに含まれるクラスを表すClassResourcesも保持します。これにより、他のコンポーネントは、/WEB-INF/classesを検索するための1回の呼び出しに続いて/WEB-INF/lib内のJARを検索するための別の呼び出しを行う代わりに、単一の呼び出しでクラスを検索できます。Webアプリケーションが起動すると、ClassResourcesは/WEB-INF/libにマッピングされたJARから生成されます。

したがって、完全な検索順序は次のとおりです

• PreResources
• MainResources
• ClassResources
• JarResources
• PostResources

Webアプリケーション起動時のClassResourcesおよびJarResourcesの生成は、目的の動作を得るためにJARベースのリソースを正しく追加するよう注意が必要であることを意味します。次の例を考えてみましょう

<Resources>
  <PostResources base="D:\Projects\external\classes"
                 className="org.apache.catalina.webresources.DirResourceSet"
                 webAppMount="/WEB-INF/classes"/>
  <PostResources base="D:\Projects\lib\library1.jar"
                 className="org.apache.catalina.webresources.FileResourceSet"
                 webAppMount="/WEB-INF/lib/library1.jar"/>
</Resources>

両方のリソースがPostResourcesであるため、D:\Projects\lib\library1.jarよりも前にD:\Projects\external\classesがクラスの検索対象となると予想されるかもしれません。しかし、FileResourceSetを使用してJARを追加すると、JARは/WEB-INF/libにマッピングされ、アプリケーション起動時に/WEB-INF/lib内の他のJARと共に処理されます。JARファイルからのクラスはClassResourcesに追加され、これはD:\Projects\external\classesからのクラスよりも先に検索されることを意味します。D:\Projects\external\classesがD:\Projects\lib\library1.jarよりも先に検索されることが望ましい動作である場合は、わずかに異なる設定が必要です

<Resources>
  <PostResources base="D:\Projects\external\classes"
                 className="org.apache.catalina.webresources.DirResourceSet"
                 webAppMount="/WEB-INF/classes"/>
  <PostResources base="D:\Projects\lib\library1.jar"
                 className="org.apache.catalina.webresources.JarResourceSet"
                 webAppMount="/WEB-INF/classes"/>
</Resources>

要するに、JARファイルはFileResourceSetを使用して/WEB-INF/libにマッピングするのではなく、JarResourceSetとして/WEB-INF/classesにマッピングして追加する必要があります。

キャッシュ戦略

静的リソースのキャッシングに対する追加の制御は、カスタムキャッシュ戦略を構成することで実現できます。カスタムキャッシュ戦略を構成するには、<Resources>要素の内部に<CacheStrategy>要素を以下の属性と共にネストします

Resources要素には特別な機能は関連付けられていません。