文档

创建和管理应用服务

更新时间:

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

前提条件

新建应用服务

  1. 登录BizWorks,在选择平台下拉列表中选中建模平台image.png

  2. 单击页面右上角a7.png图标或其文本框区域,在下拉列表中单击目标项目名称后,单击建模页签。在建模导航栏中,选择技术建模 > 限界上下文

  3. 限界上下文页面,单击目标限界上下文名称。

  4. 在目标限界上下文导航栏中,单击应用服务。在应用服务页面,单击新建应用服务image.png

    您可以单击去推导,在上下文映射 > 映射推导页面做应用服务的推导。具体操作,请参见映射推导

  5. 新建应用服务面板,设置基本信息,包括应用服务名称编码描述(非必填)。应用服务基本信息

    说明

    编码英文字母和数字的组合,长度不得超过80个字符,需以大写字母开头,且在限界上下文内唯一。

  6. 单击应用服务页签,单击添加应用服务方法。在应用服务方法面板,配置以下信息,并单击创建

    表 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

    符合条件的分页列表

  7. 单击新建应用服务面板左下角的创建,保存配置信息。您可以在应用服务列表中查看、编辑或删除您创建的应用服务。

  8. 可选:应用服务生成规则与示例如下表所示。

    属性

    生成格式

    示例

    说明

    应用服务名称

    模型名称+服务

    订单服务

    由于名称长度限制100位,因此如果数据模型名称长度超过98位,需要截取前98位再加上“服务”。如果是更新已有应用服务,原名称将被覆盖。

    应用服务编码

    模型编码+Service

    SalesOrderService

    由于名称长度限制32位,因此如果数据模型编码长度超过29位,需要截取前29位再加上“Service”。

    应用服务描述

    如果是新建的应用服务,备注字段默认为空;如果是覆盖已有的服务,备注字段不变,保持原有值。

编辑应用服务

  1. 在应用服务列表中,单击目标应用服务名称或目标应用服务右侧操作列下的编辑

  2. 编辑应用服务面板,修改配置信息。

删除应用服务

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

  2. 在二次确认对话框中,单击删除

  • 本页导读 (1)
文档反馈