从 @EndUserText.label 看懂 SAP ABAP CDS Annotation 的结构设计

在 ABAP CDS 开发里，经常会看到这样一行代码。@EndUserText.label:'TextLabel'它看起来非常简单，一个@，一段用点号连接起来的名字，再跟一个值。很多刚开始接触 CDS 的开发人员会把它理解成某种类似 Java Annotation 或 C# Attribute 的语法糖，只要知道它能够给 CDS 字段增加描述信息就够了。可当 CDS 模型逐渐复杂，代码里出现@AbapCatalog、@AccessControl、@ObjectModel、@Semantics、@Consumption、@UI、@Search、@Metadata等大量 annotation 之后，仅仅靠记忆 annotation 名称就会变得非常痛苦。真正需要建立起来的并不是一张 annotation 名称清单，而是一套关于 annotation 结构的思维模型。一旦理解了 main annotation、sub-annotation、annotation value 之间的关系，再面对几十种甚至几百种 CDS annotation 时，代码看起来就不再像一堆零散的配置项，而更接近一棵具有明确层次的元数据树。