Java代码扫描与平台模型映射的特殊规则_云原生应用组装平台 BizWorks(BizWorks)-阿里云帮助中心

本文介绍Java代码扫描与平台模型映射的特殊规则。

Java类型与平台类型映射

说明

所有的映射通过插件上报都会在元数据中记录代码中的实际类型，再次生成代码时可以原样生成。但通过平台上报的类型可能会丢失真实的类型信息。

基础类型、包装类型映射

Java基础类型扫描上报成对应包装类型：例如：int -> Integer , boolean -> Boolean。

数组、集合类型映射

数组扫描上报为建模平台中的List。
继承或实现java.util.Collection，且非继承或实现java.util.Set的类型扫描上报为建模平台中的List，例如List、ArrayList等。
继承或实现java.util.Set的类型扫描上报为建模平台中的Set，例如：Set、HashSet等。
继承或实现java.util.Map的类型扫描上报为建模平台中的Map，例如：Map、HashMap等。

泛型类型映射

泛型类型使用

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

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

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

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

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

泛型类型定义

泛型类型的定义扫描上报的时候，类名会去掉类型参数原样上报，参数类型在类内部的使用会使用其上界替换。具体如下代码示例所示。

public class Demo<T> { private T f; }
public class Demo2<T extends Demo3DTO> { private T f; }

上述的两个示例，上报后分别为Demo和Demo2两个结构对象。

Demo的字段f类型会被扫描上报为Object。
Demo2的字段f类型会被扫描上报为Demo3DTO。

枚举类型映射

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

不深入扫描解析的场景

特定的包

对一些公共包下的类，其内容、结构等对业务模型设计使用基本无影响，则认为无进一步解析必要，仅会上报类型名，以保证平台类型依赖正确。当前不解析的包有：

"java.",
"javax.",
"org.slf4j",
"org.apache.commons.logging",
"org.springframework.context",
"sun"

一定的依赖深度

当前扫描，对于未标记为模型，但被模型依赖到（例如：字段类型、方法出入参、继承类型等）的普通Java类型，会作为结构对象扫描上报到平台。

例如，A为结构对象，B、C、D、E为普通Java类无注解。但A的字段f1类型为B，这种情况下认为A的类型表达依赖B的类型，即A -> B。同样，我们假设A -> B，A -> C，B -> D，D -> E。A对B、C直接依赖，对D、E间接依赖。则除了A本身被扫描为结构对象，B、C、D、E都会被扫描为结构对象。

说明

为防止代码中模型依赖的其他类（未标记为模型）依赖关系不断传递、层级过深，故扫描过程以标记的模型为出发点，目前最多只解析n层依赖深度。到达n层后，仅上报类型名，以保证平台类型依赖正确。
当前依赖深度层数n不可配置，固定为3。

其他特殊映射

继承关系

平台内置基本类型包含Date与BigDecimal。Java中java.util.Date和java.math.BigDecimal扫描上报会被映射为平台的这两种基本类型。

因为平台暂不支持继承基本类型，故在Java中继承java.util.Date和java.math.BigDecimal的继承关系在扫描上报的时候会被忽略。例如，class CustomDateTime extends java.util.Date{}，上报到平台后CustomDateTime无父对象。