目錄位置和內容
在 Liberty 設定檔中,許多目錄都有相關聯的內容。 當您配置伺服器時,這些內容可用來指定檔案位置。
目錄或檔案 | 內容 | 說明 |
---|---|---|
wlp/ | wlp.install.dir | 安裝根目錄 |
+- bin/ | 用來管理安裝的 Script。 例如:server。 | |
+- clients/ | Liberty 設定檔用戶端和小型用戶端檔案庫。例如,restConnector.jar。 | |
+- jython/ | Jython 型 Script | |
+- dev/ | 開發人員資源(API、SPI、規格和工具)的根目錄 | |
+- api/ | 依預設,在編譯和執行時期都能使用的公用 API | |
+- ibm/ | Liberty 設定檔中可用的 API | |
+- javadoc/ | Java™ 文件保存檔 | |
+- spec/ | 依預設,在編譯和執行時期都能使用的公用規格 API | |
+- third-party/ | 在編譯時期預設為可用,在執行時期,必須指定在配置中(利用應用程式 classloader 元素的 apiTypeVisibility 屬性來指定)的協力廠商 API。 | |
+- spi/ | 依預設在編譯和執行時期都能使用的公用 SPI | |
+- ibm/ | Liberty 設定檔中可用的 SPI | |
+- javadoc/ | 用於 SPI 的 Java 文件保存檔 | |
+- spec/ | 依預設在編譯和執行時期都能使用的公用規格 SPI | |
+- tools/ | Liberty 設定檔的 Ant 外掛程式 | |
+- etc/ | 適用於所有伺服器的使用者自訂伺服器變數(選用) | |
+- server.env | 預設伺服器 Script 環境變數(選用) | |
+- client.env | 預設用戶端 Script 環境變數(選用) | |
+- jvm.options | 預設 JVM 選項(選用) | |
+- lafiles/ | 授權資訊檔 | |
+- lib/ | 平台執行時期環境 | |
+- templates/ | 執行時期自訂作業範本和範例 | |
![]() |
![]() |
![]() ![]() |
+- server/ | 建立伺服器時的伺服器範本 | |
+- usr/ | wlp.user.dir | 使用者目錄 |
+- extension/ | usr.extension.dir | 使用者開發的特性 |
+- shared/ | ||
+- apps/ | shared.app.dir | 共用應用程式 |
+- config/ | shared.config.dir | 共用配置檔 |
+- resources/ | shared.resource.dir | 共用資源定義:配接器、資料來源 |
+- servers/ | 共用伺服器目錄 | |
+- server_name | server.config.dir | 伺服器配置目錄。利用 ${server.config.dir} 來參照伺服器特定配置(應用程式)。 |
+- bootstrap.properties | 伺服器引導內容(選用) | |
+- jvm.options | 伺服器 JVM 選項,用來取代 wlp/etc/jvm.options 中的值(選用) | |
+- server.env | 與 wlp/etc/server.env 合併的伺服器 Script 環境變數(選用) | |
+- server.xml | 伺服器配置重疊(必要) | |
+- apps/ | 應用程式的伺服器配置 | |
+- dropins/ | 伺服器預設應用程式 dropins 資料夾(選用) | |
+- application_name | 應用程式資料夾或保存檔(選用) | |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
+- server_name | server.output.dir | 伺服器輸出目錄。利用 ${server.output.dir} 來說明伺服器產生的構件(日誌檔和工作區)。 |
+- logs/ | 伺服器日誌檔,其中包括 FFDC 日誌(伺服器第一次執行之後,目錄就會存在) | |
+- console.log | 基本伺服器狀態和作業訊息 | |
+- trace_timestamp.log | 含時間戳記的追蹤訊息,詳細層次取決於現行追蹤配置 | |
+- ffdc/ | 「首次失敗資料擷取 (FFDC)」輸出目錄 | |
+- ffdc_timestamp/ | 「首次失敗資料擷取 (FFDC)」輸出,通常包括與要求的作業失敗之相關診斷資料的選擇性記憶體傾出 | |
+- workarea/ | 伺服器作業時所建立的檔案(伺服器第一次執行之後,目錄就會存在) | |
![]() |
共用用戶端目錄 | |
+- client_name | 用戶端配置目錄。 | |
+- bootstrap.properties | 用戶端引導內容(選用) | |
+- client.jvm.options | 用戶端 JVM 選項,會取代 wlp/etc/client.jvm.options 中的值(選用) | |
+- client.xml | 用戶端配置重疊(必要) | |
+- apps/ | 應用程式的用戶端配置 | |
+- logs/ | 伺服器日誌檔,包括 FFDC 日誌(用戶端第一次執行之後,目錄就會存在) | |
+- trace_timestamp.log | 含時間戳記的追蹤訊息,詳細層次取決於現行追蹤配置 | |
+- ffdc/ | 「首次失敗資料擷取 (FFDC)」輸出目錄 | |
+- ffdc_timestamp/ | 「首次失敗資料擷取 (FFDC)」輸出,通常包括與要求的作業失敗之相關診斷資料的選擇性記憶體傾出 | |
+- workarea/ | 用戶端運作時所建立的檔案(用戶端第一次執行之後,目錄就會存在) |
如果有各目錄的相關內容,在配置伺服器時,您可以利用這些內容來指定檔案位置。 如需範例,請參閱將應用程式部署到 Liberty 設定檔。
提示: 如果要確保配置具有可攜性,請使用最明確的適用內容,不要依賴資源之間的關係。
比方說,在某些配置中,安裝位置 ${wlp.install.dir} 可能不是自訂實例 ${wlp.user.dir} 的母項。
程式化存取位置內容
位置內容可以利用 server.xml 檔中的 jndiEntry 配置元素,以您選擇的名稱來連結到 JNDI 名稱空間中,例如:
<jndiEntry jndiName="serverName" value="${wlp.server.name}"/>
在伺服器(應用程式、共用程式庫或特性)中執行的任何程式碼都可以通過 JNDI 查閱來存取這些項目:
Object serverName = new InitialContext().lookup("serverName");
如需如何在配置中使用 JNDI 項目的相關資訊,請參閱從伺服器配置檔使用常數的 JNDI 連結。
特性程式碼也可以利用核心提供的系統程式設計介面 (SPI) 來解析這些內容的值,例如:
ServiceReference <WsLocationAdmin>locationAdminRef = bundleContext.getServiceReference(WsLocationAdmin.class);
WsLocationAdmin locationAdmin = bundleContext.getService(locationAdminRef);
String serverName = locationAdmin.resolveString("${wlp.server.name}");