# 6.2.3 嵌套命名关系

如果仔细看看程序清单 6.3，会发现顶级元素像这样：

```
{
    "_embedded": {
        "tacoResourceList": [
            ...
        ]
    }    
}
```

最值得注意的是 tacoResourceList 这个名称，它源于 List\<Resource> 中创建的 Resources 对象实例，虽然不太可能，但是如果将 TacoResource 类名称重构为其他名称，那么 JSON 中的字段名将会需要更改以与之匹配，这可能会破坏任何依赖该名称的客户端。

@Relation 注解可以帮助打破 JSON 字段名与 Java 中定义的资源类型类名之间的耦合。通过在 TacoResource 上使用 @Relationip 注解，可以指定 Spring HATEOAS 应该如何在 JSON 结果中字段的命名：

```java
@Relation(value="taco", collectionRelation="tacos")
public class TacoResources extends ResourcesSupport {
    ...
}
```

在这里，已经指定当资源对象中使用 TacoResource 对象列表时，应该将其命名为 tacos。虽然在我们的 API 中没有使用它，但是一个 TacoResource 对象应该在 JSON 中被称为 taco。

因此，从 `/design/recent` 返回的 JSON 现在看起来是这样的（无论在 TacoResource 上执行或不执行什么重构）：

```
{
    "_embedded": {
        "tacos": [
            ...
        ]
    }
}
```

Spring HATEOAS 使向 API 添加链接变得非常简单明了。尽管如此，它确实添加了几行不需要的代码。因此，一些开发人员可能会选择不在他们的 API 中使用 HATEOAS，即使这意味着如果 API 的 URL 模式发生变化，客户端代码可能会被破坏。

如果在存储库中使用 Spring Data，可能会有一个双赢的方案。让我们看看 Spring Data REST 如何根据第 3 章中使用 Spring Data 创建的数据存储库自动创建 API。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://potoyang.gitbook.io/spring-in-action-v5/di-6-zhang-chuang-jian-rest-fu-wu/6.2-qi-yong-chao-mei-ti/6.2.3-qian-tao-ming-ming-guan-xi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.