Apache Tomcat 10 配置参考

• 简介
• 属性
  1. 通用属性
  2. 标准实现
• 嵌套组件
• 特殊功能

Resources 元素表示 Web 应用程序可用的所有资源。这包括类、JAR 文件、HTML、JSP 和有助于 Web 应用程序的任何其他文件。提供了实现来使用目录、JAR 文件和 WAR 作为这些资源的来源，并且可以扩展资源实现以提供对以其他形式存储的文件的支持，例如数据库或版本化存储库。

默认情况下，资源会被缓存。

注意：只有当 Web 应用程序不依赖于对其自身资源的直接文件系统访问，并使用 ServletContext 接口中的方法来访问它们时，才能使用基于非文件系统的 Resources 实现运行 Web 应用程序。

Resources 元素可以嵌套在 Context 组件内。如果未包含，将自动创建一个基于文件系统的默认 Resources，这足以满足大多数要求。

Web 应用程序的主要资源由为 Context 定义的 docBase 定义。可以通过定义一个或多个嵌套组件向 Web 应用程序提供其他配置设置和/或资源。

PreResources

在主资源之前搜索 PreResources。将按定义的顺序搜索它们。要配置 PreResources，请在 <Resources> 元素内嵌套一个 <PreResources> 元素，该元素具有以下属性

JAR 资源

JarResources 在主资源之后但 PostResources 之前进行搜索。它们将按定义的顺序进行搜索。要配置 JarResources，请在 <Resources> 元素内嵌套一个 <JarResources> 元素。配置属性与 PreResources 相同。

在 Web 应用程序启动期间，JAR 扫描过程将检查扫描的 JAR 中 /META-INF/resources 下的内容。如果找到，则此静态内容将被添加到 JarResources。

后置资源

PostResources 在资源 JAR 之后进行搜索。它们将按定义的顺序进行搜索。要配置 PostResources，请在 <Resources> 元素内嵌套一个 <PostResources> 元素。配置属性与 PreResources 相同。

排序

除了上述资源集外，标准实现还维护 ClassResources，它表示映射到 /WEB-INF/classes 的 JAR 文件中包含的类。这允许其他组件通过一次调用来搜索类，而不是一次调用来搜索 /WEB-INF/classes，然后另一次调用来搜索 /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 文件应作为映射到 /WEB-INF/classes 的 JarResourceSet 添加，而不是使用映射到 /WEB-INF/lib 的 FileResourceSet。

缓存策略

通过配置自定义缓存策略，可以获得对静态资源缓存的更多控制。要配置自定义缓存策略，请将 <CacheStrategy> 元素嵌套在 <Resources> 元素中，并使用以下属性

Resources 元素不具有任何特殊功能。