存量应用集成BizWorks实践

1. 创建应用。具体操作请参见创建空应用。

   创建空应用用于承载存量应用，将存量应用的代码仓库关联到新建的应用中。

2. 创建一个空的限界上下文，创建与管理限界上下文。

   该限界上下文用来承载存量应用所上报的模型。

3. 在新创建的应用内，关联限界上下文。具体操作，请参见管理模型。

   以便于将应用对应的代码所实现的模型，可以通过平台或IDE插件上报到限界上下文中进行可视化管理。

应用服务@ApplicationService

应用服务注解示例代码如下：

@ApplicationService(name = "活动中心业务域", desc = "韵达活动中心业务域测试")
public interface ActivityServiceApi {


    @ReturnValue(value = "SingleResponse结构验证", name = "SingleResponse结构验证")
    @Method(value = "创建抽奖活动", name = "创建抽奖活动")
    SingleResponse createLotteryActivity(@Parameter(value = "createLotteryActivityRequest描述", name = "createLotteryActivityRequest", required = true) 
                                         @RequestBody BaseRequest<CreateLotteryActivityRequest> createLotteryActivityRequest);
  
  }

此示例中包含了对@ApplicationService，@ReturnValue，@Method，@Parameter注解的使用样例。

应用服务的结构对象@StructureObject

通常应用服务的出入参数如果为Java对象，该Java对象都应被标注为结构对象。

结构对象注解示例代码如下：

@Getter
@Setter
@StructureObject(  name = "客户结构对象DTO", desc = "客户结构对象DTO")
public class BaseRequest<T> implements Serializable {

    @Field(value = "应用的appKey", name = "应用的appKey")
    private String appKey;

    @Field(value = "操作者", name = "操作者")
    private String operator;

}

领域对象@DomainObject（实体对象）及@ValueObject（值对象）

领域对象注解示例代码如下：

@Getter
@Setter
@DomainObject(isAggregateRoot = true, name = "客户", desc = "客户描述")
public class RuleDictE extends BaseEntity {

    @Field(value = "主键id描述", name = "主键id")
    private Long id;
    @Field(value = "名称描述", name = "名称")
    private String name;
    @Field(value = "编码描述", name = "编码")
    private String code;
    @Field(value = "value描述", name = "value")
    private String value;
    @Field(value = "描述", name = "描述")
    private String description;
    @Field(value = "是否删除描述", name = "是否删除")
    private Byte deleted;
    @Field(value = "创建时间描述", name = "创建时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date createTime;
    @Field(value = "修改时间描述", name = "修改时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date modifyTime;
    @Field(value = "创建人描述", name = "创建人")
    private String createBy;
    @Field(value = "修改人描述", name = "修改人")
    private String modifyBy;
}

@ValueObject( name = "值对象", desc = "值对象描述")
public class RuleTemplateDetailE extends BaseEntity {

	/**
	 * 序列号
	 */
	private static final long serialVersionUID = 1L;
	@Field(value = "规则模板明细id描述", name = "规则模板明细id")
	private Long id;
	@Field(value = "规则名称", name = "规则名称")
	private String name;
	@Field(value = "规则模板id描述", name = "规则模板id")
	private Long ruleTemplateId;
	@Field(value = "规则字典code描述", name = "规则字典code")
	private String ruleDictCode;
	@Field(value = "字段类型描述", name = "字段类型")
	private String ruleDictType;
	
	
}

此示例中包含了对@DomainObject，@ValueObject，@Field注解的使用样例。

领域服务@DomainService

领域服务注解示例代码如下：

@Component
@Slf4j
@DomainService(name = "活动领域服务", desc = "活动领域服务描述")
public class ActivityDomainService {

    /**
     * 1.更新活动
     * 2.推送redis
     *
     * @param activityE
     * @return
     */
    @ReturnValue(value = "SingleResponse描述", name = "SingleResponse")
    @Method(value = "更新活动描述", name = "更新活动")
    public Boolean updateActivity(@Parameter(desc = "Activity描述", name = "Activity", required = true) Activity activity) {
       
        return true;
    }


}

此示例中包含了对@DomainService，@ReturnValue，@Method，@Parameter注解的使用样例。

商业能力@BusinessCapabilityService

商业能力注解示例代码如下：

@BusinessCapabilityService(desc = "ActivityServiceApi desc", name = "ActivityServiceApi name")
public interface ActivityServiceApi {


    @ReturnValue(value = "SingleResponse结构验证", name = "SingleResponse结构验证")
    @Method(value = "创建抽奖活动", name = "创建抽奖活动")
    SingleResponse createLotteryActivity(@Parameter(value = "createLotteryActivityRequest描述", name = "createLotteryActivityRequest", required = true)
                                         @RequestBody BaseRequest<CreateLotteryActivityRequest> createLotteryActivityRequest);

	
	
}

此示例中包含了对@BusinessCapabilityService，@ReturnValue，@Method，@Parameter注解的使用样例。

商业能力的结构对象@StructureObject

通常商业能力服务的方法出入参数若为Java对象，该Java对象都应被标注为结构对象。

商业能力结构对象注解示例代码如下：

@JsonInclude(JsonInclude.Include.NON_NULL)
@Getter
@Setter
@StructureObject( name = "客户结构对象DTO", desc = "客户结构对象DTO")
public class User<T> implements Serializable {

    @Field(value = "应用的appKey", name = "应用的appKey")
    private String appKey;

    @Field(value = "操作者", name = "操作者")
    private String operator;

    @Field(value = "操作者所属的组织id", name = "操作者所属的组织id")
    private String operatorOrgId;

    @Field(value = "操作者所属的组织类型", name = "操作者所属的组织类型")
    private String operatorOrgType;


}

此示例中包含了对@StructureObject，@Field注解的使用样例。