應用服務包括服務方法以及擴展點,并定義了接口出入參,從而在腳手架中就能生成對應代碼,以便開發人員完成具體實現。本文為您介紹如何創建應用服務,以及相關的編輯、刪除等操作。
前提條件
當前賬號擁有項目權限。
已完成限界上下文的創建。具體操作,請參見創建與管理限界上下文。
新建應用服務
登錄BizWorks,在選擇平臺下拉列表中選中建模平臺。
單擊頁面右上角圖標或其文本框區域,在下拉列表中單擊目標項目名稱后,單擊建模頁簽。在建模導航欄中,選擇 。
在限界上下文頁面,單擊目標限界上下文名稱。
在目標限界上下文導航欄中,單擊應用服務。在應用服務頁面,單擊新建應用服務。
您可以單擊去推導,在映射推導。
頁面做應用服務的推導。具體操作,請參見在新建應用服務面板,設置基本信息,包括應用服務名稱、編碼和描述(非必填)。
說明編碼為英文字母和數字的組合,長度不得超過80個字符,需以大寫字母開頭,且在限界上下文內唯一。
單擊應用服務頁簽,單擊添加應用服務方法。在應用服務方法面板,配置以下信息,并單擊創建。
表 1. 應用服務參數配置說明 參數
說明
應用服務方法名稱
自定義應用服務方法的名稱。
編碼
英文字母和數字的組合,長度不得超過80個字符,需以小寫字母開頭,且在應用服務內唯一。
描述
應用服務方法描述,非必填。
應用服務方法入參
單擊添加入參,配置應用服務方法的入參。入參可以設置多個,如何配置入參,請參見下表《應用服務方法入參示例》。
說明在未創建結構對象時,應用服務的出入參無法選擇對象類型。
應用服務方法出參
單擊添加出參,配置應用服務方法的出參。出參最多僅可設置一個。如未設置出參,則返回值為
void
。表 2. 應用服務方法入參示例 應用服務方法名稱
編碼
入參名稱
入參編碼
入參類型
必填
出參類型
創建訂單
Create
訂單
SalesOrderDTO
SalesOrderDTO
Y
Boolean
更新訂單
Update
訂單
SalesOrderDTO
SalesOrderDTO
Y
Boolean
根據ID刪除訂單
DeleteByID
訂單ID
ID
Long
Y
Boolean
根據ID查詢訂單
FindByID
訂單ID
ID
Long
Y
SalesOrderDTO
根據條件查詢
FindByCondition
查詢條件
Condition
QueryCondition
Y
符合條件的分頁列表
單擊新建應用服務面板左下角的創建,保存配置信息。您可以在應用服務列表中查看、編輯或刪除您創建的應用服務。
可選:應用服務生成規則與示例如下表所示。
屬性
生成格式
示例
說明
應用服務名稱
模型名稱+服務
訂單服務
由于名稱長度限制100位,因此如果數據模型名稱長度超過98位,需要截取前98位再加上“服務”。如果是更新已有應用服務,原名稱將被覆蓋。
應用服務編碼
模型編碼+Service
SalesOrderService
由于名稱長度限制32位,因此如果數據模型編碼長度超過29位,需要截取前29位再加上“Service”。
應用服務描述
無
無
如果是新建的應用服務,備注字段默認為空;如果是覆蓋已有的服務,備注字段不變,保持原有值。
編輯應用服務
在應用服務列表中,單擊目標應用服務名稱或目標應用服務右側操作列下的編輯。
在編輯應用服務面板,修改配置信息。
刪除應用服務
在應用服務列表中,單擊目標服務右側操作列下的刪除。
在二次確認對話框中,單擊刪除。