BizWorks Toolkit插件使用过程中的常见问题和相应解决方案_云原生应用组装平台 BizWorks-阿里云帮助中心

本文介绍BizWorks Toolkit插件使用过程中的常见问题和相应解决方案。

在项目中没有找到文档中提到的modules.yaml怎么办？

解决方案：

解决方案：

请检查BizWorks Toolkit插件是否完全配置正确，IDEA平台界面右下角的BizWorks图标是否为下图状态，若未配置完成请重新配置。具体操作，请参见配置BizWorks Toolkit（适用于0.12.0之前版本）。
请检查本地代码平台模型的缓存是否为最新状态，您可尝试重新获取平台模型。具体操作，请参见获取平台模型最新状态。
请检查本地代码是否可以编译通过，BizWorks注解（例如：@DomainObject、@ApplicationService等）是否可以正常引用。更多信息，请参见BizWorks Toolkit插件使用项目前提和快速标记代码为模型。

说明

相互覆盖不会阻断扫描上报，但无法保证上报后平台模型的正确性。您可以临时忽略，但建议修改。

问题原因：

相互覆盖指的是在不同的Package下，存在拥有相同BizWorks模型类型（例如：领域对象、结构对象等）且同名的两个类。

因为扫描会覆盖所有标记BizWorks注解和被依赖的类（相关信息，请参见什么是依赖），且映射到平台模型的时候code为类名，不包含Package。所以对于映射为平台模型的Java类型，需要保证类名不同。

解决方案：

修改类的名称，确保不重复。您可以直接使用IDEA提供的Rename（Shift+F6）功能（建议使用）。

当方法重载时，您可通过quickFix方式或手动方式为Method注解中指定code属性。如果注解中code属性存在且有值的情况下，BizWorks Toolkit插件则会将code值作为方法唯一编码上报至平台；如果code不存在，则以方法名作为方法唯一编码上报至平台。

方法重载时quickFix提示如下：

方法重载时正确情况示例如下：

泛型类型会实例化为一个结构对象上报。

泛型类型的使用，会去掉尖括号，将类型与类型参数拼接在一起成为新的结构对象Code，示例如下：

GenericExample<ObjectA> ->  GenericExampleObjectA
GenericExample<GenericExample<ObjectB> -> GenericExampleGenericExampleObjectB

如果泛型使用并未提供参数类型, 或使用单个通配符?，则默认参数类型为Object。如果泛型的参数类型使用通配符表达则取其上界类型。示例如下：

GenericExample -> GenericExampleObject
GenericExample<?> -> GenericExampleObject
GenericExample<? extends ObjectA> -> GenericExampleObjectA

为了防止内部类类名冲突，内部类会在外部类类名后拼接内部类类名为平台的code。具体示例如下，外部类A正常上报为 A，A的内部类InnerClassB会上报为AInnerClassB。

@StructureObject
class A {

    @StructureObject
    Class InnerClassB {

    }
}

当前平台对枚举类型无特殊处理，扫描的时候会作为一个普通的结构对象上报。

解决方案：

您可以通过BizWorks规约扫描查看当前目录下类是否符合平台规则。具体操作，请参见触发检查和快速修复本地代码。

解决方案：

请检查File > Settings > BizWorks > 关联平台配置路径下的关联代码package在项目中是否正确存在。具体操作，请参见配置关联平台和配置modules.yaml。
请检查项目是否正确导入且构建通过。具体操作，请参见使用BizWorks Toolkit注意事项。
请检查BizWorks注解（例如：@DomainObject、@ApplicationService等）是否正确标注。具体操作，请参见快速标记代码为模型。