定義 Spring Boot 應用程式的內容。

名稱 類型 預設值 說明

applicationArgument

string

定義應用程式引數,以便傳遞給 Spring Boot 應用程式啟動類別的主要方法。

autoStart

boolean

true

指出伺服器是否會自動啟動應用程式。

classloaderRef

最上層 classloader 元素的參照(字串)。

定義應用程式類別載入器的設定。

id

字串

唯一的配置 ID。

location

檔案、目錄或 URL。
必要

應用程式的位置,以伺服器層次應用程式目錄的絕對路徑或相對路徑表示。

name

string

應用程式的名稱。

startAfterRef

最上層 application 元素的參照清單(逗點區隔的字串)。

指定在此應用程式可以開始啟動之前,需要先啟動的應用程式。

classloader

定義應用程式類別載入器的設定。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec, ibm-api, api, stable, third-party。如果將字首 + 或 - 新增到 API 類型,會分別從 API 類型的預設集合新增或移除那些 API 類型。字首的一般用法 +third-party 結果是 "spec, ibm-api, api, stable, third-party"。字首 -api,結果是 "spec, ibm-api, stable"。

classProviderRef

最上層 resourceAdapter 元素的參照清單(逗點區隔的字串)。

類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。

commonLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

程式庫參照的清單。 函式庫類別實體與其他類別載入器共用。

delegation

  • parentFirst

  • parentLast

parentFirst

控制父類別載入器在此類別載入器之前或之後使用。 如果選取母項優先,則會先委派給原生母項,再搜尋類別路徑。 如果選取母項最後,則會先搜尋類別路徑,再委派給原生母項。
parentFirst
母項優先
parentLast
母項最後

overrideLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入程式的類別路徑之前,會先搜尋引用的函式庫類別路徑。

privateLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入器的類別路徑後,會搜尋引用的函式庫類別路徑。

classloader > classProvider

類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。

名稱 類型 預設值 說明

autoStart

boolean

將資源配接器配置為在部署資源配接器時自動啟動,或延遲到注入或查閱資源時才自動啟動。

classloaderRef

最上層 classloader 元素的參照(字串)。

定義應用程式類別載入器的設定。

id

字串

唯一的配置 ID。

location

檔案、目錄或 URL。
必要

定義要安裝之 RAR 檔的路徑。

useJandex

boolean

如果應用程式中提供 Jandex 索引檔,則會啟用它們。

classloader > classProvider > appProperties

提供自訂內容給應用程式。

classloader > classProvider > appProperties > property

提供特定的自訂內容給應用程式。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

提供應用程式範圍的內容名稱。

value

string

提供應用程式範圍的內容值。

classloader > classProvider > customize

針對使用指定介面及/或實作類別的啟動規格、受管理物件或 Connection Factory,自訂其配置內容元素。

名稱 類型 預設值 說明

implementation

string

應自訂其配置內容元素的實作類別完整名稱。

interface

string

應自訂其配置內容元素的介面類別完整名稱。

suffix

string

置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果在自訂配置內容元素時省略了字尾或將它留白,則不會使用字尾。

classloader > classProvider > web-ext

Web 應用程式的延伸內容。

名稱 類型 預設值 說明

auto-encode-requests

boolean

決定是否自動編碼要求。

auto-encode-responses

boolean

決定是否自動編碼回應。

autoload-filters

boolean

決定是否自動載入過濾器。

context-root

string

定義 Web 應用程式的環境定義根目錄。

default-error-page

string

指定將作為 Web 應用程式預設錯誤頁面的頁面。

enable-directory-browsing

boolean

指定是否為這個 Web 應用程式啟用目錄瀏覽。

enable-file-serving

boolean

指定是否為這個 Web 應用程式啟用檔案處理。

enable-serving-servlets-by-class-name

boolean

啟用依類別名稱處理的 Servlet

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

pre-compile-jsps

boolean

指定當 Web 應用程式啟動時是否要編譯 JSP 頁面。

classloader > classProvider > web-ext > file-serving-attribute

指定 Web 應用程式是否容許處理檔案。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

classloader > classProvider > web-ext > invoker-attribute

指定呼叫程式的屬性。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

classloader > classProvider > web-ext > jsp-attribute

指定會影響 JSP 行為的屬性。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

classloader > classProvider > web-ext > mime-filter

MIME 過濾器的內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

mime-type

string

Mime 過濾器的類型。

target

string

Mime 過濾器的目標。

classloader > classProvider > web-ext > resource-ref

資源參照的內容。

名稱 類型 預設值 說明

branch-coupling

  • LOOSE

  • TIGHT

指定要使用鬆散或緊密連結。

commit-priority

int

0

定義資源參照的確定優先順序。

id

字串

唯一的配置 ID。

isolation-level

  • TRANSACTION_NONE

  • TRANSACTION_READ_COMMITTED

  • TRANSACTION_READ_UNCOMMITTED

  • TRANSACTION_REPEATABLE_READ

  • TRANSACTION_SERIALIZABLE

定義交易隔離層次。

name

string

資源參照的名稱。

classloader > classProvider > webservices-bnd

Web 服務連結用來自訂 Web 服務端點,以及配置 Web 服務提供者和 Web 服務用戶端兩者的安全設定。

classloader > classProvider > webservices-bnd > http-publishing

在所有 Web 服務端點都使用 HTTP 通訊協定的情況下,HTTP 發佈用來指定發佈配置。

名稱 類型 預設值 說明

context-root

string

環境定義根目錄屬性用來指定 EJB 型 JAX-WS 應用程式中之 EJB 模組的環境定義根目錄。

id

字串

唯一的配置 ID。

classloader > classProvider > webservices-bnd > http-publishing > webservice-security

Web 服務安全元素用來配置 POJO Web 服務和 EJB 型 Web 服務的角色型授權。

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > login-config

登入配置屬性用來配置鑑別方法和領域名稱,並且只會對 JAR 檔中的 EJB 型 Web 服務起作用。如果在部署描述子檔案中指定了相同的屬性,會使用部署描述子中的值。

名稱 類型 預設值 說明

auth-method

string

授權方法用來配置 Web 應用程式的鑑別機制。

realm-name

string

領域名稱元素指定 HTTP 基本授權中使用的領域名稱

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > login-config > form-login-config

表單登入配置元素指定表單型登入中應使用的登入和錯誤頁面。如果未使用表單型鑑別,則會忽略這些元素。

名稱 類型 預設值 說明

form-error-page

string

form-error-page 元素定義可在 Web 應用程式中找到錯誤頁面的位置,此錯誤頁面會在登入不成功時顯示。路徑的開頭是一個前導 /,會解譯成與 WAR 根目錄相對。

form-login-page

string

表單登入頁面元素定義可在 Web 應用程式中找到登入頁面的位置。路徑的開頭是一個前導 /,會解譯成與 WAR 根目錄相對。

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint

安全限制屬性用來使安全限制與一或多個 Web 資源集合產生關聯。安全限制只是充當 Web 應用程式中之部署描述子或註釋的補充配置。

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint > auth-constraint

授權限制元素用來指定應允許其存取資源集合的使用者角色。

名稱 類型 預設值 說明

role-name

string
這指定為子元素,而不是指定為 XML 屬性.

授權限制的角色名稱應與部署描述子中所定義的安全角色名稱相對應。

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint > user-data-constraint

使用者資料限制元素用來定義應如何保護用戶端與儲存器之間的資料通訊。

名稱 類型 預設值 說明

transport-guarantee

int

傳輸保證指定用戶端之間應如何進行通訊。如果值為 INTEGRAL,則應用程式會要求在傳送過程中不應變更資料。如果值為 CONFIDENTIAL,則資料在傳送過程中應為機密。值 NONE 表示沒有傳輸保證。

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint > web-resource-collection

Web 資源集合元素用來識別安全限制的資源。

名稱 類型 預設值 說明

http-method

string

指定要套用安全限制的 HTTP 方法

http-method-omission

string

指定不應套用安全限制的 HTTP 方法

id

字串

唯一的配置 ID。

url-pattern

string

URL 型樣用來識別 Web 資源集合中的一組資源。

web-resource-name

string

Web 資源集合的名稱

classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-role

安全角色屬性含有安全角色的定義。只會充當 Web 應用程式中之部署描述子或註釋的補充配置。

名稱 類型 預設值 說明

role-name

string

授權限制的角色名稱應與部署描述子中所定義的安全角色名稱相對應。

classloader > classProvider > webservices-bnd > service-ref

服務參照元素用來定義 Web 服務用戶端的 Web 服務參照配置。

名稱 類型 預設值 說明

component-name

string

如果 EJB 模組中使用了服務參照,則元件名稱屬性用來指定 EJB Bean 名稱。

id

字串

唯一的配置 ID。

name

string

名稱屬性用來指定 Web 服務參照的名稱。

port-address

string

埠位址屬性用來指定 Web 服務埠的位址(如果所參照的 Web 服務只有一埠)。

wsdl-location

string

WSDL 位置屬性用來指定要置換之 WSDL 位置的 URL。

classloader > classProvider > webservices-bnd > service-ref > port

埠元素用來定義 Web 服務參照相關聯的埠配置。

名稱 類型 預設值 說明

address

string

位址屬性用來指定 Web 服務埠的位址,並置換 service-ref 元素中所定義的埠位址屬性值。

id

字串

唯一的配置 ID。

key-alias

string

金鑰別名屬性用來指定用戶端憑證的別名。如果未指定此屬性,且 Web 服務提供者支援用戶端憑證,則會以金鑰儲存庫中的第一份憑證作為這個屬性的值。此屬性也可以置換 server.xml 檔 ssl 元素中所定義的 clientKeyAlias 屬性。

name

string

埠名稱用來指定 Web 服務埠的名稱。

namespace

string

名稱空間屬性用來指定 Web 服務埠的名稱空間。連結適用於具有相同名稱和名稱空間的埠。否則,連結適用於具有相同名稱的埠。

password

可逆的編碼密碼(字串)

密碼屬性用來指定基本鑑別的密碼。可以對密碼進行編碼。

ssl-ref

string

SSL 參照屬性會參照至 server.xml 檔中所定義的 ssl 元素。如果未指定此屬性,但是伺服器支援傳輸層次安全,則服務用戶端會使用預設 SSL 配置。

username

string

使用者名稱屬性用來指定基本鑑別的使用者名稱。

classloader > classProvider > webservices-bnd > service-ref > port > properties

內容元素用來定義 Web 服務端點或用戶端的內容。屬性可以具有任何名稱和任何值。

classloader > classProvider > webservices-bnd > service-ref > properties

內容元素用來定義 Web 服務端點或用戶端的內容。屬性可以具有任何名稱和任何值。

classloader > classProvider > webservices-bnd > webservice-endpoint

Web 服務端點用來為指定的服務實例指定連結。

名稱 類型 預設值 說明

address

string

位址用來指定服務端點被置換的位址。

id

字串

唯一的配置 ID。

port-component-name

string

埠元件名稱用來指定埠元件的名稱。

classloader > classProvider > webservices-bnd > webservice-endpoint-properties

Web 服務端點內容用來為相同模組中的所有 Web 服務端點定義預設內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

classloader > commonLibrary

程式庫參照的清單。 函式庫類別實體與其他類別載入器共用。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

classloader > commonLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

classloader > commonLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

classloader > commonLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

classloader > commonLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

classloader > overrideLibrary

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入程式的類別路徑之前,會先搜尋引用的函式庫類別路徑。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

classloader > overrideLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

classloader > overrideLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

classloader > overrideLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

classloader > overrideLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

classloader > privateLibrary

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入器的類別路徑後,會搜尋引用的函式庫類別路徑。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

classloader > privateLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

classloader > privateLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

classloader > privateLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

classloader > privateLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter

指定在此應用程式可以開始啟動之前,需要先啟動的應用程式。

名稱 類型 預設值 說明

autoStart

boolean

true

指出伺服器是否會自動啟動應用程式。

classloaderRef

最上層 classloader 元素的參照(字串)。

定義應用程式類別載入器的設定。

context-root

string

應用程式的環境定義根目錄。

id

字串

唯一的配置 ID。

location

檔案、目錄或 URL。
必要

應用程式的位置,以伺服器層次應用程式目錄的絕對路徑或相對路徑表示。

name

string

應用程式的名稱。

startAfterRef

最上層 application 元素的參照清單(逗點區隔的字串)。

指定在此應用程式可以開始啟動之前,需要先啟動的應用程式。

type

string

應用程式保存檔的類型。

useJandex

boolean

如果應用程式中提供 Jandex 索引檔,則會啟用它們。

startAfter > appProperties

提供自訂內容給應用程式。

startAfter > appProperties > property

提供特定的自訂內容給應用程式。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

提供應用程式範圍的內容名稱。

value

string

提供應用程式範圍的內容值。

startAfter > application-bnd

定義套用至應用程式連結的內容。

startAfter > application-bnd > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > application-bnd > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > application-bnd > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > application-bnd > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > application-bnd > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > application-bnd > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > application-bnd > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > application-bnd > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > application-bnd > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > application-bnd > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > application-bnd > security-role

對映到網域使用者登錄中的使用者和群組的角色。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

安全角色的名稱。

startAfter > application-bnd > security-role > group

安全角色的群組。

名稱 類型 預設值 說明

access-id

string

主體的存取 ID。

id

字串

唯一的配置 ID。

name

string

主體的名稱。

startAfter > application-bnd > security-role > run-as

從一個 Bean 存取另一個 Bean 所需的使用者 ID 和密碼。

名稱 類型 預設值 說明

password

可逆的編碼密碼(字串)

從一個 Bean 存取另一個 Bean 所需的使用者密碼。其值可以用明碼或編碼形式儲存。如果要將密碼編碼,請搭配使用 securityUtility 工具與編碼選項。

userid

string

從一個 Bean 存取另一個 Bean 所需的使用者 ID。

startAfter > application-bnd > security-role > special-subject

持有安全角色的特殊主體名稱。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

type

  • ALL_AUTHENTICATED_USERS

  • EVERYONE

下列其中一種特殊主體類型:ALL_AUTHENTICATED_USERS、EVERYONE。

startAfter > application-bnd > security-role > user

安全角色的使用者。

名稱 類型 預設值 說明

access-id

string

主體的存取 ID。

id

字串

唯一的配置 ID。

name

string

主體的名稱。

startAfter > application-client-bnd

定義套用至應用程式用戶端的內容。

startAfter > application-client-bnd > data-source

定義應用程式用戶端的資料來源。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > application-client-bnd > ejb-ref

應用程式用戶端中的 EJB 參照。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > application-client-bnd > env-entry

定義應用程式用戶端的環境項目。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > application-client-bnd > message-destination-ref

應用程式用戶端中的訊息目的地參照。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > application-client-bnd > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > application-client-bnd > resource-ref

應用程式用戶端中的資源參照。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > application-client-bnd > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > application-client-bnd > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > application-client-bnd > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > application-client-bnd > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > application-ext

定義內容以延伸應用程式。

名稱 類型 預設值 說明

shared-session-context

boolean

指出模組之間是否共用階段作業環境定義。

startAfter > classloader

定義應用程式類別載入器的設定。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec, ibm-api, api, stable, third-party。如果將字首 + 或 - 新增到 API 類型,會分別從 API 類型的預設集合新增或移除那些 API 類型。字首的一般用法 +third-party 結果是 "spec, ibm-api, api, stable, third-party"。字首 -api,結果是 "spec, ibm-api, stable"。

classProviderRef

最上層 resourceAdapter 元素的參照清單(逗點區隔的字串)。

類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。

commonLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

程式庫參照的清單。 函式庫類別實體與其他類別載入器共用。

delegation

  • parentFirst

  • parentLast

parentFirst

控制父類別載入器在此類別載入器之前或之後使用。 如果選取母項優先,則會先委派給原生母項,再搜尋類別路徑。 如果選取母項最後,則會先搜尋類別路徑,再委派給原生母項。
parentFirst
母項優先
parentLast
母項最後

overrideLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入程式的類別路徑之前,會先搜尋引用的函式庫類別路徑。

privateLibraryRef

最上層 library 元素的參照清單(逗點區隔的字串)。

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入器的類別路徑後,會搜尋引用的函式庫類別路徑。

startAfter > classloader > classProvider

類別提供者參照清單。當搜尋類別或資源時,這個類別載入器會搜尋其本身的類別路徑,之後委派給指定的類別提供者。

名稱 類型 預設值 說明

autoStart

boolean

將資源配接器配置為在部署資源配接器時自動啟動,或延遲到注入或查閱資源時才自動啟動。

classloaderRef

最上層 classloader 元素的參照(字串)。

定義應用程式類別載入器的設定。

id

字串

唯一的配置 ID。

location

檔案、目錄或 URL。
必要

定義要安裝之 RAR 檔的路徑。

useJandex

boolean

如果應用程式中提供 Jandex 索引檔,則會啟用它們。

startAfter > classloader > classProvider > appProperties

提供自訂內容給應用程式。

startAfter > classloader > classProvider > appProperties > property

提供特定的自訂內容給應用程式。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

提供應用程式範圍的內容名稱。

value

string

提供應用程式範圍的內容值。

startAfter > classloader > classProvider > customize

針對使用指定介面及/或實作類別的啟動規格、受管理物件或 Connection Factory,自訂其配置內容元素。

名稱 類型 預設值 說明

implementation

string

應自訂其配置內容元素的實作類別完整名稱。

interface

string

應自訂其配置內容元素的介面類別完整名稱。

suffix

string

置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果在自訂配置內容元素時省略了字尾或將它留白,則不會使用字尾。

startAfter > classloader > classProvider > web-ext

Web 應用程式的延伸內容。

名稱 類型 預設值 說明

auto-encode-requests

boolean

決定是否自動編碼要求。

auto-encode-responses

boolean

決定是否自動編碼回應。

autoload-filters

boolean

決定是否自動載入過濾器。

context-root

string

定義 Web 應用程式的環境定義根目錄。

default-error-page

string

指定將作為 Web 應用程式預設錯誤頁面的頁面。

enable-directory-browsing

boolean

指定是否為這個 Web 應用程式啟用目錄瀏覽。

enable-file-serving

boolean

指定是否為這個 Web 應用程式啟用檔案處理。

enable-serving-servlets-by-class-name

boolean

啟用依類別名稱處理的 Servlet

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

pre-compile-jsps

boolean

指定當 Web 應用程式啟動時是否要編譯 JSP 頁面。

startAfter > classloader > classProvider > web-ext > file-serving-attribute

指定 Web 應用程式是否容許處理檔案。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

startAfter > classloader > classProvider > web-ext > invoker-attribute

指定呼叫程式的屬性。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

startAfter > classloader > classProvider > web-ext > jsp-attribute

指定會影響 JSP 行為的屬性。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

startAfter > classloader > classProvider > web-ext > mime-filter

MIME 過濾器的內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

mime-type

string

Mime 過濾器的類型。

target

string

Mime 過濾器的目標。

startAfter > classloader > classProvider > web-ext > resource-ref

資源參照的內容。

名稱 類型 預設值 說明

branch-coupling

  • LOOSE

  • TIGHT

指定要使用鬆散或緊密連結。

commit-priority

int

0

定義資源參照的確定優先順序。

id

字串

唯一的配置 ID。

isolation-level

  • TRANSACTION_NONE

  • TRANSACTION_READ_COMMITTED

  • TRANSACTION_READ_UNCOMMITTED

  • TRANSACTION_REPEATABLE_READ

  • TRANSACTION_SERIALIZABLE

定義交易隔離層次。

name

string

資源參照的名稱。

startAfter > classloader > classProvider > webservices-bnd

Web 服務連結用來自訂 Web 服務端點,以及配置 Web 服務提供者和 Web 服務用戶端兩者的安全設定。

startAfter > classloader > classProvider > webservices-bnd > http-publishing

在所有 Web 服務端點都使用 HTTP 通訊協定的情況下,HTTP 發佈用來指定發佈配置。

名稱 類型 預設值 說明

context-root

string

環境定義根目錄屬性用來指定 EJB 型 JAX-WS 應用程式中之 EJB 模組的環境定義根目錄。

id

字串

唯一的配置 ID。

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security

Web 服務安全元素用來配置 POJO Web 服務和 EJB 型 Web 服務的角色型授權。

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > login-config

登入配置屬性用來配置鑑別方法和領域名稱,並且只會對 JAR 檔中的 EJB 型 Web 服務起作用。如果在部署描述子檔案中指定了相同的屬性,會使用部署描述子中的值。

名稱 類型 預設值 說明

auth-method

string

授權方法用來配置 Web 應用程式的鑑別機制。

realm-name

string

領域名稱元素指定 HTTP 基本授權中使用的領域名稱

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > login-config > form-login-config

表單登入配置元素指定表單型登入中應使用的登入和錯誤頁面。如果未使用表單型鑑別,則會忽略這些元素。

名稱 類型 預設值 說明

form-error-page

string

form-error-page 元素定義可在 Web 應用程式中找到錯誤頁面的位置,此錯誤頁面會在登入不成功時顯示。路徑的開頭是一個前導 /,會解譯成與 WAR 根目錄相對。

form-login-page

string

表單登入頁面元素定義可在 Web 應用程式中找到登入頁面的位置。路徑的開頭是一個前導 /,會解譯成與 WAR 根目錄相對。

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint

安全限制屬性用來使安全限制與一或多個 Web 資源集合產生關聯。安全限制只是充當 Web 應用程式中之部署描述子或註釋的補充配置。

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint > auth-constraint

授權限制元素用來指定應允許其存取資源集合的使用者角色。

名稱 類型 預設值 說明

role-name

string
這指定為子元素,而不是指定為 XML 屬性.

授權限制的角色名稱應與部署描述子中所定義的安全角色名稱相對應。

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint > user-data-constraint

使用者資料限制元素用來定義應如何保護用戶端與儲存器之間的資料通訊。

名稱 類型 預設值 說明

transport-guarantee

int

傳輸保證指定用戶端之間應如何進行通訊。如果值為 INTEGRAL,則應用程式會要求在傳送過程中不應變更資料。如果值為 CONFIDENTIAL,則資料在傳送過程中應為機密。值 NONE 表示沒有傳輸保證。

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-constraint > web-resource-collection

Web 資源集合元素用來識別安全限制的資源。

名稱 類型 預設值 說明

http-method

string

指定要套用安全限制的 HTTP 方法

http-method-omission

string

指定不應套用安全限制的 HTTP 方法

id

字串

唯一的配置 ID。

url-pattern

string

URL 型樣用來識別 Web 資源集合中的一組資源。

web-resource-name

string

Web 資源集合的名稱

startAfter > classloader > classProvider > webservices-bnd > http-publishing > webservice-security > security-role

安全角色屬性含有安全角色的定義。只會充當 Web 應用程式中之部署描述子或註釋的補充配置。

名稱 類型 預設值 說明

role-name

string

授權限制的角色名稱應與部署描述子中所定義的安全角色名稱相對應。

startAfter > classloader > classProvider > webservices-bnd > service-ref

服務參照元素用來定義 Web 服務用戶端的 Web 服務參照配置。

名稱 類型 預設值 說明

component-name

string

如果 EJB 模組中使用了服務參照,則元件名稱屬性用來指定 EJB Bean 名稱。

id

字串

唯一的配置 ID。

name

string

名稱屬性用來指定 Web 服務參照的名稱。

port-address

string

埠位址屬性用來指定 Web 服務埠的位址(如果所參照的 Web 服務只有一埠)。

wsdl-location

string

WSDL 位置屬性用來指定要置換之 WSDL 位置的 URL。

startAfter > classloader > classProvider > webservices-bnd > service-ref > port

埠元素用來定義 Web 服務參照相關聯的埠配置。

名稱 類型 預設值 說明

address

string

位址屬性用來指定 Web 服務埠的位址,並置換 service-ref 元素中所定義的埠位址屬性值。

id

字串

唯一的配置 ID。

key-alias

string

金鑰別名屬性用來指定用戶端憑證的別名。如果未指定此屬性,且 Web 服務提供者支援用戶端憑證,則會以金鑰儲存庫中的第一份憑證作為這個屬性的值。此屬性也可以置換 server.xml 檔 ssl 元素中所定義的 clientKeyAlias 屬性。

name

string

埠名稱用來指定 Web 服務埠的名稱。

namespace

string

名稱空間屬性用來指定 Web 服務埠的名稱空間。連結適用於具有相同名稱和名稱空間的埠。否則,連結適用於具有相同名稱的埠。

password

可逆的編碼密碼(字串)

密碼屬性用來指定基本鑑別的密碼。可以對密碼進行編碼。

ssl-ref

string

SSL 參照屬性會參照至 server.xml 檔中所定義的 ssl 元素。如果未指定此屬性,但是伺服器支援傳輸層次安全,則服務用戶端會使用預設 SSL 配置。

username

string

使用者名稱屬性用來指定基本鑑別的使用者名稱。

startAfter > classloader > classProvider > webservices-bnd > service-ref > port > properties

內容元素用來定義 Web 服務端點或用戶端的內容。屬性可以具有任何名稱和任何值。

startAfter > classloader > classProvider > webservices-bnd > service-ref > properties

內容元素用來定義 Web 服務端點或用戶端的內容。屬性可以具有任何名稱和任何值。

startAfter > classloader > classProvider > webservices-bnd > webservice-endpoint

Web 服務端點用來為指定的服務實例指定連結。

名稱 類型 預設值 說明

address

string

位址用來指定服務端點被置換的位址。

id

字串

唯一的配置 ID。

port-component-name

string

埠元件名稱用來指定埠元件的名稱。

startAfter > classloader > classProvider > webservices-bnd > webservice-endpoint-properties

Web 服務端點內容用來為相同模組中的所有 Web 服務端點定義預設內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > classloader > commonLibrary

程式庫參照的清單。 函式庫類別實體與其他類別載入器共用。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

startAfter > classloader > commonLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter > classloader > commonLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

startAfter > classloader > commonLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

startAfter > classloader > commonLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter > classloader > overrideLibrary

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入程式的類別路徑之前,會先搜尋引用的函式庫類別路徑。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

startAfter > classloader > overrideLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter > classloader > overrideLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

startAfter > classloader > overrideLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

startAfter > classloader > overrideLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter > classloader > privateLibrary

程式庫參照的清單。 函式庫類別實體對此類別載入器而言是唯一的,獨立於其他類別載入器的類別實體。 在搜尋此類別載入器的類別路徑後,會搜尋引用的函式庫類別路徑。

名稱 類型 預設值 說明

apiTypeVisibility

string

spec,ibm-api,api,stable

這個類別載入器支援這種 API 套件的類型。值是下列 API 套件之任何組合的逗點區隔清單:spec、ibm-api、api、stable、third-party。

description

string

管理者的共用程式庫說明

filesetRef

最上層 fileset 元素的參照清單(逗點區隔的字串)。

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

id

字串

唯一的配置 ID。

name

string

管理者的共用程式庫名稱

startAfter > classloader > privateLibrary > file

新增 JAR 或 ZIP 檔案,以包含在此函式庫的類別路徑中。 指定的 JAR 或 ZIP 中包含的類別和資源可供此函式庫載入。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案的路徑
必要

檔案的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter > classloader > privateLibrary > fileset

指定要包含在此函式庫類別路徑中的 JAR 或 ZIP 檔案集

名稱 類型 預設值 說明

caseSensitive

boolean

true

指出搜尋是否應該區分大小寫的布林值(預設值:true)。

dir

目錄的路徑

${server.config.dir}

搜尋檔案的基本目錄。

excludes

string

要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。

id

字串

唯一的配置 ID。

includes

string

*

要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。

scanInterval

精準度是毫秒的時間量

0

掃描間隔,用來判定是否從檔案集新增或移除檔案。 不會掃描個別檔案。 時間間隔的字尾是 h-小時、m-分鐘、s-秒及ms-毫秒,例如 2ms 或 5s。 依預設會停用掃描間隔,並透過將掃描間隔 scanInterval 設為 0 來手動停用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

startAfter > classloader > privateLibrary > folder

新增資料夾,以包含在此函式庫的類別路徑中。 指定資料夾及其子資料夾中所包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

dir

目錄的路徑
必要

資料夾的路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

id

字串

唯一的配置 ID。

startAfter > classloader > privateLibrary > path

新增 JAR 檔案、ZIP 檔案或資料夾,以包含在此函式庫的類別路徑中。 如果指定的路徑是 JAR 或 ZIP 檔案,則指定的 JAR 或 ZIP 檔案中所包含的類和資源可供此函式庫載入。 如果指定的路徑是資料夾,則指定資料夾及其子資料夾中包含的類別和資源可供此函式庫載入。 指定資料夾中包含的 JAR 和 ZIP 檔案不會新增至此函式庫的類別路徑。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

檔案、目錄或 URL。
必要

路徑可以是完全限定路徑或相對路徑。 相對路徑是相對於 $ {server.config.dir} 屬性的值。

startAfter > ejb-jar-bnd

EJB 連結描述子會定義 EJB 模組的連結資訊。

名稱 類型 預設值 說明

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

startAfter > ejb-jar-bnd > interceptor

攔截程式的連結內容。

名稱 類型 預設值 說明

class

string

攔截程式的類別名稱。

id

字串

唯一的配置 ID。

startAfter > ejb-jar-bnd > interceptor > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > ejb-jar-bnd > interceptor > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > ejb-jar-bnd > interceptor > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > ejb-jar-bnd > interceptor > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > ejb-jar-bnd > interceptor > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > ejb-jar-bnd > interceptor > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > ejb-jar-bnd > interceptor > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > ejb-jar-bnd > interceptor > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > ejb-jar-bnd > interceptor > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > ejb-jar-bnd > interceptor > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > ejb-jar-bnd > message-destination

訊息目的地的連結內容。

名稱 類型 預設值 說明

binding-name

string

訊息目的地的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地的名稱。

startAfter > ejb-jar-bnd > message-driven

訊息驅動 Bean 的連結內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string
必要

Enterprise Bean 的名稱。

startAfter > ejb-jar-bnd > message-driven > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > ejb-jar-bnd > message-driven > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > ejb-jar-bnd > message-driven > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > ejb-jar-bnd > message-driven > jca-adapter

定義訊息驅動 Bean 的 JCA 配接器。

名稱 類型 預設值 說明

activation-spec-auth-alias

string

指定啟動規格的鑑別別名。

activation-spec-binding-name

string
必要

指定啟動規格的連結名稱。

destination-binding-name

string

指定 JCA 配接器的目的地連結名稱。

startAfter > ejb-jar-bnd > message-driven > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > ejb-jar-bnd > message-driven > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > ejb-jar-bnd > message-driven > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > ejb-jar-bnd > message-driven > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > ejb-jar-bnd > message-driven > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > ejb-jar-bnd > message-driven > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > ejb-jar-bnd > message-driven > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > ejb-jar-bnd > session

Session Bean 的連結內容。

名稱 類型 預設值 說明

component-id

string

Session Bean 的元件 ID。

id

字串

唯一的配置 ID。

local-home-binding-name

string

Session Bean 的本端起始位置連結名稱。

name

string
必要

Enterprise Bean 的名稱。

remote-home-binding-name

string

Session Bean 的遠端起始位置連結名稱。

simple-binding-name

string

指定 Session Bean 的簡式連結名稱。

startAfter > ejb-jar-bnd > session > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > ejb-jar-bnd > session > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > ejb-jar-bnd > session > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > ejb-jar-bnd > session > interface

指定階段作業介面。

名稱 類型 預設值 說明

binding-name

string

指定介面的連結名稱。

class

string

介面的類別名稱。

id

字串

唯一的配置 ID。

startAfter > ejb-jar-bnd > session > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > ejb-jar-bnd > session > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > ejb-jar-bnd > session > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > ejb-jar-bnd > session > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > ejb-jar-bnd > session > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > ejb-jar-bnd > session > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > ejb-jar-bnd > session > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > ejb-jar-ext

EJB 應用程式的延伸內容。

名稱 類型 預設值 說明

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

startAfter > ejb-jar-ext > message-driven

訊息驅動 Bean 的延伸內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string
必要

Enterprise Bean 的名稱。

startAfter > ejb-jar-ext > message-driven > bean-cache

EJB 的快取設定。

名稱 類型 預設值 說明

activation-policy

  • ONCE

  • TRANSACTION

指定 EJB 在工作區中的位置點。

startAfter > ejb-jar-ext > message-driven > global-transaction

指定這個 Enterprise Bean 的廣域交易。

名稱 類型 預設值 說明

send-wsat-context

boolean

false

決定是否在送出的要求中傳送 Web 服務原子交易。

transaction-time-out

int

0

指定廣域交易的逾時。

startAfter > ejb-jar-ext > message-driven > local-transaction

指定這個 Enterprise Bean 的區域交易。

名稱 類型 預設值 說明

resolver

  • APPLICATION

  • CONTAINER_AT_BOUNDARY

定義區域交易的解析器。值可以是 APPLICATION 或 CONTAINER_AT_BOUNDARY。

shareable

boolean

false

定義區域交易是否可共用。

unresolved-action

  • COMMIT

  • ROLLBACK

定義未解析之動作的行為。值可以是 ROLLBACK 或 COMMIT。

startAfter > ejb-jar-ext > message-driven > resource-ref

指定這個 Enterprise Bean 的資源參照。

名稱 類型 預設值 說明

branch-coupling

  • LOOSE

  • TIGHT

指定要使用鬆散或緊密連結。

commit-priority

int

0

定義資源參照的確定優先順序。

id

字串

唯一的配置 ID。

isolation-level

  • TRANSACTION_NONE

  • TRANSACTION_READ_COMMITTED

  • TRANSACTION_READ_UNCOMMITTED

  • TRANSACTION_REPEATABLE_READ

  • TRANSACTION_SERIALIZABLE

定義交易隔離層次。

name

string

資源參照的名稱。

startAfter > ejb-jar-ext > message-driven > start-at-app-start

控制 Bean 是否在應用程式啟動時啟動。

名稱 類型 預設值 說明

value

boolean

false

「應用程式啟動時啟動」內容的值。

startAfter > ejb-jar-ext > session

Session Bean 的延伸內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string
必要

Enterprise Bean 的名稱。

startAfter > ejb-jar-ext > session > bean-cache

EJB 的快取設定。

名稱 類型 預設值 說明

activation-policy

  • ONCE

  • TRANSACTION

指定 EJB 在工作區中的位置點。

startAfter > ejb-jar-ext > session > global-transaction

指定這個 Enterprise Bean 的廣域交易。

名稱 類型 預設值 說明

send-wsat-context

boolean

false

決定是否在送出的要求中傳送 Web 服務原子交易。

transaction-time-out

int

0

指定廣域交易的逾時。

startAfter > ejb-jar-ext > session > local-transaction

指定這個 Enterprise Bean 的區域交易。

名稱 類型 預設值 說明

resolver

  • APPLICATION

  • CONTAINER_AT_BOUNDARY

定義區域交易的解析器。值可以是 APPLICATION 或 CONTAINER_AT_BOUNDARY。

shareable

boolean

false

定義區域交易是否可共用。

unresolved-action

  • COMMIT

  • ROLLBACK

定義未解析之動作的行為。值可以是 ROLLBACK 或 COMMIT。

startAfter > ejb-jar-ext > session > resource-ref

指定這個 Enterprise Bean 的資源參照。

名稱 類型 預設值 說明

branch-coupling

  • LOOSE

  • TIGHT

指定要使用鬆散或緊密連結。

commit-priority

int

0

定義資源參照的確定優先順序。

id

字串

唯一的配置 ID。

isolation-level

  • TRANSACTION_NONE

  • TRANSACTION_READ_COMMITTED

  • TRANSACTION_READ_UNCOMMITTED

  • TRANSACTION_REPEATABLE_READ

  • TRANSACTION_SERIALIZABLE

定義交易隔離層次。

name

string

資源參照的名稱。

startAfter > ejb-jar-ext > session > start-at-app-start

控制 Bean 是否在應用程式啟動時啟動。

名稱 類型 預設值 說明

value

boolean

false

「應用程式啟動時啟動」內容的值。

startAfter > ejb-jar-ext > session > time-out

指定 Session Bean 的逾時值。

名稱 類型 預設值 說明

value

精準度是秒鐘的時間量

0

逾時的值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。

startAfter > managed-bean-bnd

指定受管理 Bean 的連結。

名稱 類型 預設值 說明

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

startAfter > managed-bean-bnd > interceptor

定義受管理 Bean 連結的攔截程式。

名稱 類型 預設值 說明

class

string

攔截程式的類別名稱。

id

字串

唯一的配置 ID。

startAfter > managed-bean-bnd > interceptor > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > managed-bean-bnd > interceptor > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > managed-bean-bnd > interceptor > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > managed-bean-bnd > interceptor > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > managed-bean-bnd > interceptor > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > managed-bean-bnd > interceptor > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > managed-bean-bnd > interceptor > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > managed-bean-bnd > interceptor > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > managed-bean-bnd > interceptor > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > managed-bean-bnd > interceptor > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > managed-bean-bnd > managed-bean

指定這項連結的受管理 Bean。

名稱 類型 預設值 說明

class

string
必要

指定受管理 Bean 的類別名稱。

id

字串

唯一的配置 ID。

startAfter > managed-bean-bnd > managed-bean > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > managed-bean-bnd > managed-bean > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > managed-bean-bnd > managed-bean > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > managed-bean-bnd > managed-bean > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > managed-bean-bnd > managed-bean > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > managed-bean-bnd > managed-bean > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > managed-bean-bnd > managed-bean > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > managed-bean-bnd > managed-bean > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > managed-bean-bnd > managed-bean > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > managed-bean-bnd > managed-bean > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > mcpServer

設定 MCP 伺服器功能。

名稱 類型 預設值 說明

moduleName

string

EAR 檔案中的模組名稱。 選取此設定所適用的模組。

path

string

/mcp

此 MCP 端點的 URL 路徑,以模組上下文根目錄為基準。 設定該模組內的 MCP 端點路徑。

stateless

boolean

false

無狀態模式會停用伺服器對 MCP 會話的追蹤功能。 此模式可消除叢集環境中對工作階段親和性的需求。 否則,同一台伺服器會處理來自相同 MCP 會話的請求。 由於伺服器上不儲存任何會話資料,任何伺服器實例皆可處理任何請求,這簡化了負載平衡與水平擴展的操作。 然而,無狀態模式也會停用依賴於會話追蹤或串聯獨立 HTTP 請求的MCP功能,例如取消工具呼叫。

startAfter > resourceAdapter

指定內嵌在應用程式中的資源配接器的配置。

名稱 類型 預設值 說明

alias

string

${id}

置換資源配接器的預設 ID。資源配接器的配置內容元素名稱中會使用 ID,進而用來判定資源配接器提供之任何資源的配置內容元素名稱。資源配接器的配置內容元素名稱的格式是 properties.<APP_NAME>.<ALIAS>,其中 <APP_NAME> 是應用程式名稱,<ALIAS> 是所配置的別名。如果沒有指定,會將別名預設為資源配接器的模組名稱。

autoStart

boolean

將資源配接器配置為在部署資源配接器時自動啟動,或延遲到注入或查閱資源時才自動啟動。

contextServiceRef

最上層 contextService 元素的參照(字串)。

配置如何擷取環境定義並延伸到執行緒。

id

string
必要

識別要套用這項配置之內嵌資源配接器模組的名稱。

startAfter > resourceAdapter > contextService

配置如何擷取環境定義並延伸到執行緒。

名稱 類型 預設值 說明

jndiName

string

JNDI 名稱

onError

  • FAIL

  • IGNORE

  • WARN

WARN

決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。

進階內容

baseContextRef

最上層 contextService 元素的參照(字串)。

指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。

startAfter > resourceAdapter > contextService > baseContext

指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

jndiName

string

JNDI 名稱

onError

  • FAIL

  • IGNORE

  • WARN

WARN

決定要對配置錯誤採取的回應動作。舉例來說,如果為這項 contextService 配置了 securityContext,但是未啟用安全特性,則 onError 會決定失敗、發出警告,或是忽略不正確的配置部分。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。

進階內容

baseContextRef

最上層 contextService 元素的參照(字串)。

指定基本環境定義服務,以從中繼承尚未定義在這項環境定義服務中的環境定義。

startAfter > resourceAdapter > contextService > baseContext > classloaderContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > baseContext > jeeMetadataContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > baseContext > securityContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > baseContext > syncToOSThreadContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > baseContext > zosWLMContext

唯一的配置 ID。

名稱 類型 預設值 說明

daemonTransactionClass

string

ASYNCDMN

當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。

defaultTransactionClass

string

ASYNCBN

當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。

id

字串

唯一的配置 ID。

wlm

  • New

  • Propagate

  • PropagateOrNew

Propagate

指出應如何處理「非常駐程式」工作的 WLM 環境定義。
New
一律建立新的 WLM 環境定義。
Propagate
使用相同的 WLM 環境定義(若有的話)。
PropagateOrNew
使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。

startAfter > resourceAdapter > contextService > classloaderContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > jeeMetadataContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > securityContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > syncToOSThreadContext

唯一的配置 ID。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

startAfter > resourceAdapter > contextService > zosWLMContext

唯一的配置 ID。

名稱 類型 預設值 說明

daemonTransactionClass

string

ASYNCDMN

當為「常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。

defaultTransactionClass

string

ASYNCBN

當為「非常駐程式」工作建立新的 WLM 環境定義時,要提供給 WLM 來分類工作的「交易類別」名稱。

id

字串

唯一的配置 ID。

wlm

  • New

  • Propagate

  • PropagateOrNew

Propagate

指出應如何處理「非常駐程式」工作的 WLM 環境定義。
New
一律建立新的 WLM 環境定義。
Propagate
使用相同的 WLM 環境定義(若有的話)。
PropagateOrNew
使用相同的 WLM 環境定義,或是在沒有現行環境定義時新建一個。

startAfter > resourceAdapter > customize

針對使用指定介面及/或實作類別的啟動規格、受管理物件或 Connection Factory,自訂其配置內容元素。

名稱 類型 預設值 說明

implementation

string

應自訂其配置內容元素的實作類別完整名稱。

interface

string

應自訂其配置內容元素的介面類別完整名稱。

suffix

string

置換配置內容元素的預設字尾。例如,properties.rarModule1.CustomConnectionFactory 中的 "CustomConnectionFactory"。當資源配接器提供了多種類型的 Connection Factory、受管理物件或端點啟動時,使用字尾有助於釐清。如果在自訂配置內容元素時省略了字尾或將它留白,則不會使用字尾。

startAfter > web-bnd

指定 Web 應用程式的連結內容。

名稱 類型 預設值 說明

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

startAfter > web-bnd > data-source

指定資料來源的連結。

名稱 類型 預設值 說明

binding-name

string

資料來源連結名稱。

id

字串

唯一的配置 ID。

name

string

資料來源名稱。

startAfter > web-bnd > ejb-ref

指定 EJB 參照的連結。

名稱 類型 預設值 說明

binding-name

string

EJB 參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

EJB 參照的名稱。

startAfter > web-bnd > env-entry

指定環境項目的連結。

名稱 類型 預設值 說明

binding-name

string

環境項目的連結名稱。

id

字串

唯一的配置 ID。

name

string

環境項目的名稱。

value

string

環境項目的值。

startAfter > web-bnd > message-destination-ref

指定訊息目的地參照的連結。

名稱 類型 預設值 說明

binding-name

string

訊息目的地參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

訊息目的地參照的名稱。

startAfter > web-bnd > resource-env-ref

指定資源環境參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源環境參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源環境參照的名稱。

startAfter > web-bnd > resource-ref

指定資源參照的連結。

名稱 類型 預設值 說明

binding-name

string

資源參照的連結名稱。

id

字串

唯一的配置 ID。

name

string

資源參照的名稱。

startAfter > web-bnd > resource-ref > authentication-alias

資源參照的鑑別別名。

名稱 類型 預設值 說明

nameRef

最上層 authData 元素的參照(字串)。

鑑別別名。

startAfter > web-bnd > resource-ref > authentication-alias > name

鑑別別名。

名稱 類型 預設值 說明

krb5Principal

string

要使用的 Kerberos principal 名稱或 Kerberos 服務名稱。

krb5TicketCache

檔案的路徑

將在其中儲存 Kerberos 主體名稱或服務名稱的 Kerberos 認證的檔案位置。又稱為 Kerberos 認證快取 (ccache)

password

可逆的編碼密碼(字串)

連接至 EIS 時要使用的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。

user

string

連接至 EIS 時要使用的使用者名稱。

startAfter > web-bnd > resource-ref > custom-login-configuration

指定自訂登入配置內容。

名稱 類型 預設值 說明

name

string

自訂登入配置的名稱。

startAfter > web-bnd > resource-ref > custom-login-configuration > property

定義自訂登入配置的內容。

名稱 類型 預設值 說明

description

string

內容的說明。

id

字串

唯一的配置 ID。

name

string

內容的名稱。

value

string

內容的值。

startAfter > web-bnd > virtual-host

指定用於 Web 應用程式的虛擬主機。

名稱 類型 預設值 說明

name

string

虛擬主機的名稱

startAfter > web-ext

Web 應用程式的延伸內容。

名稱 類型 預設值 說明

auto-encode-requests

boolean

決定是否自動編碼要求。

auto-encode-responses

boolean

決定是否自動編碼回應。

autoload-filters

boolean

決定是否自動載入過濾器。

context-root

string

定義 Web 應用程式的環境定義根目錄。

default-error-page

string

指定將作為 Web 應用程式預設錯誤頁面的頁面。

enable-directory-browsing

boolean

指定是否為這個 Web 應用程式啟用目錄瀏覽。

enable-file-serving

boolean

指定是否為這個 Web 應用程式啟用檔案處理。

enable-serving-servlets-by-class-name

boolean

啟用依類別名稱處理的 Servlet

moduleName

string

模組名稱指定要套用連結或延伸配置的個別模組。

pre-compile-jsps

boolean

指定當 Web 應用程式啟動時是否要編譯 JSP 頁面。

startAfter > web-ext > file-serving-attribute

指定 Web 應用程式是否容許處理檔案。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

startAfter > web-ext > invoker-attribute

指定呼叫程式的屬性。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

startAfter > web-ext > jsp-attribute

指定會影響 JSP 行為的屬性。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

name

string

屬性名稱。

value

string

屬性值。

startAfter > web-ext > mime-filter

MIME 過濾器的內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。

mime-type

string

Mime 過濾器的類型。

target

string

Mime 過濾器的目標。

startAfter > web-ext > resource-ref

資源參照的內容。

名稱 類型 預設值 說明

branch-coupling

  • LOOSE

  • TIGHT

指定要使用鬆散或緊密連結。

commit-priority

int

0

定義資源參照的確定優先順序。

id

字串

唯一的配置 ID。

isolation-level

  • TRANSACTION_NONE

  • TRANSACTION_READ_COMMITTED

  • TRANSACTION_READ_UNCOMMITTED

  • TRANSACTION_REPEATABLE_READ

  • TRANSACTION_SERIALIZABLE

定義交易隔離層次。

name

string

資源參照的名稱。

startAfter > webservices-bnd

Web 服務連結用來自訂 Web 服務端點,以及配置 Web 服務提供者和 Web 服務用戶端兩者的安全設定。

startAfter > webservices-bnd > http-publishing

在所有 Web 服務端點都使用 HTTP 通訊協定的情況下,HTTP 發佈用來指定發佈配置。

名稱 類型 預設值 說明

context-root

string

環境定義根目錄屬性用來指定 EJB 型 JAX-WS 應用程式中之 EJB 模組的環境定義根目錄。

id

字串

唯一的配置 ID。

startAfter > webservices-bnd > http-publishing > webservice-security

Web 服務安全元素用來配置 POJO Web 服務和 EJB 型 Web 服務的角色型授權。

startAfter > webservices-bnd > http-publishing > webservice-security > login-config

登入配置屬性用來配置鑑別方法和領域名稱,並且只會對 JAR 檔中的 EJB 型 Web 服務起作用。如果在部署描述子檔案中指定了相同的屬性,會使用部署描述子中的值。

名稱 類型 預設值 說明

auth-method

string

授權方法用來配置 Web 應用程式的鑑別機制。

realm-name

string

領域名稱元素指定 HTTP 基本授權中使用的領域名稱

startAfter > webservices-bnd > http-publishing > webservice-security > login-config > form-login-config

表單登入配置元素指定表單型登入中應使用的登入和錯誤頁面。如果未使用表單型鑑別,則會忽略這些元素。

名稱 類型 預設值 說明

form-error-page

string

form-error-page 元素定義可在 Web 應用程式中找到錯誤頁面的位置,此錯誤頁面會在登入不成功時顯示。路徑的開頭是一個前導 /,會解譯成與 WAR 根目錄相對。

form-login-page

string

表單登入頁面元素定義可在 Web 應用程式中找到登入頁面的位置。路徑的開頭是一個前導 /,會解譯成與 WAR 根目錄相對。

startAfter > webservices-bnd > http-publishing > webservice-security > security-constraint

安全限制屬性用來使安全限制與一或多個 Web 資源集合產生關聯。安全限制只是充當 Web 應用程式中之部署描述子或註釋的補充配置。

startAfter > webservices-bnd > http-publishing > webservice-security > security-constraint > auth-constraint

授權限制元素用來指定應允許其存取資源集合的使用者角色。

名稱 類型 預設值 說明

role-name

string
這指定為子元素,而不是指定為 XML 屬性.

授權限制的角色名稱應與部署描述子中所定義的安全角色名稱相對應。

startAfter > webservices-bnd > http-publishing > webservice-security > security-constraint > user-data-constraint

使用者資料限制元素用來定義應如何保護用戶端與儲存器之間的資料通訊。

名稱 類型 預設值 說明

transport-guarantee

int

傳輸保證指定用戶端之間應如何進行通訊。如果值為 INTEGRAL,則應用程式會要求在傳送過程中不應變更資料。如果值為 CONFIDENTIAL,則資料在傳送過程中應為機密。值 NONE 表示沒有傳輸保證。

startAfter > webservices-bnd > http-publishing > webservice-security > security-constraint > web-resource-collection

Web 資源集合元素用來識別安全限制的資源。

名稱 類型 預設值 說明

http-method

string

指定要套用安全限制的 HTTP 方法

http-method-omission

string

指定不應套用安全限制的 HTTP 方法

id

字串

唯一的配置 ID。

url-pattern

string

URL 型樣用來識別 Web 資源集合中的一組資源。

web-resource-name

string

Web 資源集合的名稱

startAfter > webservices-bnd > http-publishing > webservice-security > security-role

安全角色屬性含有安全角色的定義。只會充當 Web 應用程式中之部署描述子或註釋的補充配置。

名稱 類型 預設值 說明

role-name

string

授權限制的角色名稱應與部署描述子中所定義的安全角色名稱相對應。

startAfter > webservices-bnd > service-ref

服務參照元素用來定義 Web 服務用戶端的 Web 服務參照配置。

名稱 類型 預設值 說明

component-name

string

如果 EJB 模組中使用了服務參照,則元件名稱屬性用來指定 EJB Bean 名稱。

id

字串

唯一的配置 ID。

name

string

名稱屬性用來指定 Web 服務參照的名稱。

port-address

string

埠位址屬性用來指定 Web 服務埠的位址(如果所參照的 Web 服務只有一埠)。

wsdl-location

string

WSDL 位置屬性用來指定要置換之 WSDL 位置的 URL。

startAfter > webservices-bnd > service-ref > port

埠元素用來定義 Web 服務參照相關聯的埠配置。

名稱 類型 預設值 說明

address

string

位址屬性用來指定 Web 服務埠的位址,並置換 service-ref 元素中所定義的埠位址屬性值。

id

字串

唯一的配置 ID。

key-alias

string

金鑰別名屬性用來指定用戶端憑證的別名。如果未指定此屬性,且 Web 服務提供者支援用戶端憑證,則會以金鑰儲存庫中的第一份憑證作為這個屬性的值。此屬性也可以置換 server.xml 檔 ssl 元素中所定義的 clientKeyAlias 屬性。

name

string

埠名稱用來指定 Web 服務埠的名稱。

namespace

string

名稱空間屬性用來指定 Web 服務埠的名稱空間。連結適用於具有相同名稱和名稱空間的埠。否則,連結適用於具有相同名稱的埠。

password

可逆的編碼密碼(字串)

密碼屬性用來指定基本鑑別的密碼。可以對密碼進行編碼。

ssl-ref

string

SSL 參照屬性會參照至 server.xml 檔中所定義的 ssl 元素。如果未指定此屬性,但是伺服器支援傳輸層次安全,則服務用戶端會使用預設 SSL 配置。

username

string

使用者名稱屬性用來指定基本鑑別的使用者名稱。

startAfter > webservices-bnd > service-ref > port > properties

內容元素用來定義 Web 服務端點或用戶端的內容。屬性可以具有任何名稱和任何值。

startAfter > webservices-bnd > service-ref > properties

內容元素用來定義 Web 服務端點或用戶端的內容。屬性可以具有任何名稱和任何值。

startAfter > webservices-bnd > webservice-endpoint

Web 服務端點用來為指定的服務實例指定連結。

名稱 類型 預設值 說明

address

string

位址用來指定服務端點被置換的位址。

id

字串

唯一的配置 ID。

port-component-name

string

埠元件名稱用來指定埠元件的名稱。

startAfter > webservices-bnd > webservice-endpoint-properties

Web 服務端點內容用來為相同模組中的所有 Web 服務端點定義預設內容。

名稱 類型 預設值 說明

id

字串

唯一的配置 ID。