应用服务包括服务方法以及扩展点,并定义了接口出入参,从而在脚手架中就能生成对应代码,以便开发人员完成具体实现。本文为您介绍如何创建应用服务,以及相关的编辑、删除等操作。
前提条件
- 当前账号拥有项目权限。
- 已完成业务域的创建。具体操作,请参见创建与管理业务域。
新建应用服务
- 登录BizWorks,单击左侧导航栏
图标。在概览页面的左上角,单击
图标,从项目下拉列表中选择目标项目实例。
- 单击
图标,在领域建模导航栏中,选择 。
- 在业务域页面,单击目标业务域名称后,在目标业务域版本列表中,单击目标版本。
- 在目标业务域的技术建模页面,单击应用服务页签后,单击应用服务列表。
- 单击新建应用服务。
- 在新建应用服务面板,设置基本信息,包括应用服务名称、编码和描述(非必填)。说明 编码为英文字母和数字的组合,长度不得超过80个字符,需以大写字母开头,且在业务域内唯一。
- 单击应用服务页签,单击添加应用服务方法。在应用服务方法面板,配置以下信息,并单击确认。
表 1. 应用服务参数配置说明 参数 说明 应用服务方法名称 自定义应用服务方法的名称。 编码 英文字母和数字的组合,长度不得超过80个字符,需以小写字母开头,且在应用服务内唯一。 描述 应用服务方法描述,非必填。 应用服务方法入参 单击添加入参,配置应用服务方法的入参。入参可以设置多个,如何配置入参,请参见下表《应用服务方法入参示例》。 说明 在未创建结构对象时,应用服务的出入参无法选择对象类型。应用服务方法出参 单击添加出参,配置应用服务方法的出参。出参最多仅可设置一个。如未设置出参,则返回值为 void
。业务域扩展点 单击添加扩展点,填写业务扩展点的名称、编码,配置入参和出参。您可以添加多个扩展点。 说明- 在未创建结构对象时,扩展点的出入参无法选择对象类型。
- 业务扩展点和业务扩展点入参编码支持字符、数字的组合,长度不得超过80个字符,需以小写字母开头,且在应用服务内唯一。
表 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 符合条件的分页列表 - 单击新建应用服务面板左下角的创建,保存配置信息。您可以在应用服务列表中查看、编辑或删除您创建的应用服务。
表 3. 应用服务生成规则与示例 属性 生成格式 示例 说明 应用服务名称 数据模型名称+服务 订单服务 由于名称长度限制100位,因此如果数据模型名称长度超过98位,需要截取前98位再加上“服务”。如果是更新已有应用服务,原名称将被覆盖。 应用服务编码 数据模型编码+Service SalesOrderService 由于名称长度限制32位,因此如果数据模型编码长度超过29位,需要截取前29位再加上“Service”。 应用服务描述 无 无 如果是新建的应用服务,备注字段默认为空;如果是覆盖已有的服务,备注字段不变,保持原有值。
编辑应用服务
- 在应用服务列表中,单击目标应用服务名称或目标应用服务右侧操作列下的编辑。
- 在编辑应用服务面板,修改配置信息。
删除应用服务
- 在应用服务列表中,单击目标服务右侧操作列下的删除。
- 在删除对话框中,单击删除。