为共享模型创建代码片段

Question

是否可以为不同响应结构之间共享的嵌套bean生成代码片段?

地址模型

class Address {
String state;
Integer postcode;
}

端点1 (R1)的响应

{
"status": 1,
"address": {
"state": "abc",
"postcode": 3
}
}

端点2的响应(R2)

{
"id": 2,
"currentAddress": {
"state": "abc",
"postcode": 2
}
}

我想为Address模型生成一次代码片段，并在为R1和R2生成的代码片段中重用它。

Answer 1

如参考文档中所述，您可以使用subsectionWithPath("address")和subsectionWithPath("currentAddress")来记录R1和R2中的地址子节，然后交叉链接到文档中详细描述地址结构的单独部分。REST文档示例展示了这种交叉链接的一个示例。

要详细描述地址结构，您可以使用responseFields和beneathPath的组合来生成响应的特定部分的代码片段。