您可以從指令行來建立 Liberty 應用程式用戶端。
關於這項作業
只能在
client.xml 檔中啟用 Java™ EE Application Client 7.0 特性。
程序
- 開啟指令行,然後切換至 wlp/bin 目錄。 在下列範例中,path_to_liberty 指定 Liberty 在您作業系統上的安裝位置。
Windows 系統上的範例:C:\Users\mo>
cd path_to_liberty\wlp\bin
Linux 上的範例:mo@machine01:~>
cd path_to_liberty/wlp/bin
- 執行下列指令來建立用戶端,其中 client_name 是您想提供給用戶端的名稱。如果您沒有指定用戶端名稱,會使用 defaultClient。
Windows 系統上的範例:C:\wlp\bin>
client create client_name
Linux 上的範例:mo@machine01:~>
client create client_name
client create client_name
如果順利建立用戶端,您會收到下列訊息:已建立用戶端 client_name。
您可以在
wlp/usr/clients/client_name 目錄中找到 client.xml 檔。檔案含有 javaeeClient-7.0
特性。
小心: 如果預設用戶端已存在,您會收到錯誤。如果預設用戶端不存在,會建立 defaultClient。
- 準備一個含有用戶端模組 (.jar) 的應用程式檔案 (.ear),以執行您的用戶端應用程式。 在用戶端模組的 MANIFEST.MF 中指定一個主類別,例如:
Manifest-Version: 1.0
Main-Class: com.ibm.ws.addressbook.ContactServiceClient_XMLInject
- 將 EAR 檔放在 wlp/usr/clients/client_name/apps 目錄之下。
- 更新 client.xml 檔以配置應用程式,例如:
<client>
<featureManager>
<feature>javaeeClient-7.0</feature>
<featureManager>
<application id="CLIENT_APP" name="CLIENT_APP" type="ear" location="clientApp.ear"/>
</client>
如果指定的用戶端已存在,則不會建立用戶端,且您會收到異常狀況訊息:
CWWKE0005E: 無法啟動執行時期環境。
CWWKE0904E: 不可能建立名稱是 client_name 的用戶端,因為用戶端目錄 C:\wlp\usr\clients\client_name 已存在。
下一步
您可以在
client.xml 檔中新增
appSecurityClient-1.0 特性,為您的應用程式用戶端啟用安全(SSL、CSIv2、JAAS):
<featureManager>
<feature>javaeeClient-7.0</feature>
<feature>appSecurityClient-1.0</feature>
</featureManager>
如需在應用程式用戶端上配置安全的相關資訊,請參閱配置 Liberty 應用程式用戶端儲存器及其應用程式的安全。