[17.0.0.3 以及更新版本]

啟用 MicroProfile 配置 API

如果要將 Liberty 伺服器配置成執行啟用 MicroProfile 配置 API 的應用程式,您必須為伺服器設定特性。

程序

  1. 使用「MicroProfile 配置 API」資訊,決定您的程式碼需要哪些配置參數。考量如何儲存這些配置值,以及這些配置值在各服務之間及服務的整個生命期限期間,可能出現的變化,以下是服務的生命期限過程:
    • 開發
    • 測試
    • 組合與安裝
    • 執行時期服務的調整與失效接手
  2. 配置特性。更新 server.xml 檔,以新增特性。 例如:
    <featureManager>
        <feature>mpConfig-1.1</feature>
    </featureManager>

    Liberty 可以配置成支援 MicroProfile 1.1 特性,作法是在 server.xml 檔中設定 microProfile-1.1。不過,「MicroProfile 配置 API」是在 MicroProfile 1.1 版之後產生,無法利用該特性來提供它。

    [18.0.0.1 以及更新版本]您可以配置 server.xml 檔,以使用 mpConfig-1.2 特性,而不使用 mpConfig-1.1 特性。如果要啟用 mpConfig-1.2 特性,請在 server.xml 檔中新增下列特性定義:
    <featureManager>
        <feature>mpConfig-1.2</feature>
    </featureManager>
    如需 mpConfig-1.2 的相關資訊,請參閱位於 https://github.com/eclipse/microprofile-config/releases/tag/1.2.1 的 MicroProfile 配置 1.2.1 規格。
  3. 建立適當的配置值來源。 比方說,內容檔可以與應用程式一起包裝,並可在之後置換值來源。在應用程式組合期間,使用 EAR 組件、Liberty 共用程式庫或伺服器程序環境變數中的內容檔,就可以這樣做。
  4. 使用 API 來存取配置值。

指示主題類型的圖示 作業主題

檔名:twlp_microprofile_appconfig_setup.html