Apache Tomcat 10 組態參考 (10.1.23) - Jar 掃描器元件

Jar 掃描器元件

Jar 掃描器元素代表用於掃描 Web 應用程式以取得 JAR 檔案和類別檔目錄的元件。通常在 Web 應用程式啟動期間使用，以識別必須在 Web 應用程式初始化程序中處理的組態檔，例如 TLD 或 web-fragment.xml 檔。

Jar 掃描器元素可以巢狀在內容元件內。

例如，您可以在掃描 JAR 檔時包含引導類別路徑

<Context>
  ...
  <JarScanner scanBootstrapClassPath="true"/>
  ...
</Context>

如果未包含 Jar 掃描器元素，系統會自動建立預設的 Jar 掃描器組態，這對於大多數需求而言已足夠。

所有 Jar 掃描器實作都支援下列屬性

屬性	說明
`className`	要使用的實作的 Java 類別名稱。此類別必須實作 `org.apache.tomcat.JarScanner` 介面。如果未指定，將使用標準值 (定義於下方)。

Jar 掃描器 的標準實作是 org.apache.tomcat.util.scan.StandardJarScanner。它支援下列其他屬性 (除了上面所列的共用屬性)

屬性	說明
`scanAllDirectories`	如果為 `true`，將檢查類別路徑上找到的任何目錄，以查看它們是否為已展開的 JAR 檔。預設為 `false`。 Tomcat 透過尋找 META-INF 子目錄來判斷目錄是否為已展開的 JAR 檔案。只有在 META-INF 子目錄存在時，目錄才會被視為已展開的 JAR 檔案。請注意，對於掃描以符合 `@HandlesTypes` 註解的項目，所有目錄都會被掃描，無論是否存在 META-INF 子目錄。
`scanAllFiles`	如果為 `true`，將檢查在類別路徑上找到的任何檔案，以查看它們是否為 Jar 檔案，而不是依賴檔案副檔名為 `.jar`。預設值為 `false`。
`scanClassPath`	如果為 `true`，除了 Web 應用程式之外，還會掃描完整的 Web 應用程式類別路徑，包括共用和一般類別載入器以及系統類別路徑（但不包括引導類別路徑），以尋找 Jar 檔案。預設值為 `true`。
`scanBootstrapClassPath`	如果 scanClassPath 為 `true`，且此為 `true`，也會掃描引導類別路徑以尋找 Jar 檔案。預設值為 `false`。
`scanManifest`	如果為 `true`，將掃描找到的任何 JAR 的 Manifest 檔案，以尋找其他類別路徑項目，並將這些項目新增到要掃描的 URL。預設值為 `true`。

只有 Jar 掃描篩選器可以嵌套在 Jar 掃描器 元素內。

沒有任何特殊功能與 Jar 掃描器 元素相關聯。