应用服务包括服务方法以及扩展点,并定义了接口出入参,从而在脚手架中就能生成对应代码,以便开发人员完成具体实现。本文为您介绍如何创建应用服务,以及相关的编辑、删除等操作。

前提条件

新建应用服务

  1. 登录BizWorks,单击左侧导航栏1图标。在概览页面的左上角,单击1图标,从项目下拉列表中选择目标项目实例。1
  2. 单击1图标,在领域建模导航栏中,选择技术建模 > 业务域
  3. 业务域页面,单击目标业务域名称后,在目标业务域版本列表中,单击目标版本。
  4. 在目标业务域的技术建模页面,单击应用服务页签后,单击应用服务列表
  5. 单击新建应用服务1
  6. 新建应用服务面板,设置基本信息,包括应用服务名称编码描述(非必填)。应用服务基本信息
    说明 编码英文字母和数字的组合,长度不得超过80个字符,需以大写字母开头,且在业务域内唯一。
  7. 单击应用服务页签,单击添加应用服务方法。在应用服务方法面板,配置以下信息,并单击确认
    表 1. 应用服务参数配置说明
    参数说明
    应用服务方法名称自定义应用服务方法的名称。
    编码英文字母和数字的组合,长度不得超过80个字符,需以小写字母开头,且在应用服务内唯一。
    描述应用服务方法描述,非必填。
    应用服务方法入参单击添加入参,配置应用服务方法的入参。入参可以设置多个,如何配置入参,请参见下表应用服务方法入参示例
    说明 在未创建结构对象时,应用服务的出入参无法选择对象类型
    应用服务方法出参单击添加出参,配置应用服务方法的出参。出参最多仅可设置一个。如未设置出参,则返回值为void
    业务域扩展点单击添加扩展点,填写业务扩展点的名称、编码,配置入参和出参。您可以添加多个扩展点。1
    说明
    • 在未创建结构对象时,扩展点的出入参无法选择对象类型
    • 业务扩展点和业务扩展点入参编码支持字符、数字的组合,长度不得超过80个字符,需以小写字母开头,且在应用服务内唯一。
    表 2. 应用服务方法入参示例
    应用服务方法名称编码入参名称入参编码入参类型必填出参类型
    创建订单Create订单SalesOrderDTOSalesOrderDTOYBoolean
    更新订单Update订单SalesOrderDTOSalesOrderDTOYBoolean
    根据ID删除订单DeleteByID订单IDIDLongYBoolean
    根据ID查询订单FindByID订单IDIDLongYSalesOrderDTO
    根据条件查询FindByCondition查询条件ConditionQueryConditionY符合条件的分页列表
  8. 单击新建应用服务面板左下角的创建,保存配置信息。您可以在应用服务列表中查看、编辑或删除您创建的应用服务。
    表 3. 应用服务生成规则与示例
    属性生成格式示例说明
    应用服务名称数据模型名称+服务订单服务由于名称长度限制100位,因此如果数据模型名称长度超过98位,需要截取前98位再加上“服务”。如果是更新已有应用服务,原名称将被覆盖。
    应用服务编码数据模型编码+ServiceSalesOrderService由于名称长度限制32位,因此如果数据模型编码长度超过29位,需要截取前29位再加上“Service”。
    应用服务描述如果是新建的应用服务,备注字段默认为空;如果是覆盖已有的服务,备注字段不变,保持原有值。

编辑应用服务

  1. 在应用服务列表中,单击目标应用服务名称或目标应用服务右侧操作列下的编辑
  2. 编辑应用服务面板,修改配置信息。

删除应用服务

  1. 在应用服务列表中,单击目标服务右侧操作列下的删除
  2. 删除对话框中,单击删除