应用服务包括服务方法以及扩展点,并定义了接口出入参,从而在脚手架中就能生成对应代码,以便开发人员完成具体实现。本文为您介绍如何创建应用服务,以及相关的编辑、删除等操作。
前提条件
当前账号拥有项目权限。
已完成限界上下文的创建。具体操作,请参见创建与管理限界上下文。
新建应用服务
登录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”。
应用服务描述
无
无
如果是新建的应用服务,备注字段默认为空;如果是覆盖已有的服务,备注字段不变,保持原有值。
编辑应用服务
在应用服务列表中,单击目标应用服务名称或目标应用服务右侧操作列下的编辑。
在编辑应用服务面板,修改配置信息。
删除应用服务
在应用服务列表中,单击目标服务右侧操作列下的删除。
在二次确认对话框中,单击删除。
- 本页导读 (1)
- 前提条件
- 新建应用服务
- 编辑应用服务
- 删除应用服务