使用Spring HATEOAS嵌套嵌入HAL

Question

我正在寻找HAL中嵌套_embedded如何使用Spring HATEOAS API编程的例子。最佳实践是什么？

下面是我想要实现的一个例子：

{
    "_links": {
        "self": { "href": "/invoices" }
    },
    "_embedded": {
        "invoices": [
            {
                "_links": {
                    "self": { "href": "/invoice/1" }
                },
                "_embedded": {
                    "items": [
                        { "_links": { "self": { "href": "/product/1" }}, "id": 1, "name": "Super cheap Macbook Pro", "price": 2.99 }
                    ]
                },
                "id": 1,
                "total": 2.99,
                "no_items": 1
            },
            {
                "_links": {
                    "self": { "href": "/invoice/2" }
                },
                "_embedded": {
                    "items": [
                        { "_links": { "self": { "href": "/product/2" }}, "id": 2, "name": "Raspberry Pi", "price": 34.87 },
                        { "_links": { "self": { "href": "/product/3" }}, "id": 3, "name": "Random product", "price": 30 },
                        { "_links": { "self": { "href": "/product/4" }}, "id": 4, "name": "More randomness", "price": 30 }
                    ]
                },
                "id": 2,
                "total": 94.87,
                "no_items": 3
            }
        ]
    }
}

Answer 1

通过Spring Data REST和Spring HATEOAS，我看到了两种轻松实现所需的方法。

1. 创建一个发票和项目实体，并只为发票实体创建一个存储库。这将内联项目。不利的一面是，您无法对项目本身进行查询，这可能不是您想要的。
2. 创建两个实体，并为它们创建存储库。现在在发票存储库上创建一个摘录，可以查询，并且嵌入了项目和相应的链接集合。但是也有一个缺点：嵌入的项目上没有链接。我认为你应该能够通过使用投影中的资源来包含链接。

请参阅使用带物品的订单的一些示例代码：

@Data
@Entity
public class Item {
  @Id
  @GeneratedValue
  private Long id;
  private String name;
}

@Data
@Entity
@Table(name = "customer_order")
public class Order {
  @Id
  @GeneratedValue
  private Long id;
  private String name;
  @OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
  private Collection<Item> items;
}

public interface ItemRepository extends CrudRepository<Item, Long> {
}

@RepositoryRestResource(excerptProjection = InlineItems.class)
public interface OrderRepository extends CrudRepository<Order, Long> {
}

@Projection(name = "inlineItems", types = Order.class)
public interface InlineItems {
  String getName();

  Collection<Item> getItems();
}

您可以像这样查询订单GEThttp://localhost:8080/orders/1?projection=inlineItems，这将导致以下结果：

{
  "name": "My Order",
  "items": [
    {
      "name": "Banana"
    },
    {
      "name": "Apple"
    }
  ],
  "_links": {
    "self": {
      "href": "http://localhost:8090/api/orders/1"
    },
    "order": {
      "href": "http://localhost:8090/api/orders/1{?projection}",
      "templated": true
    },
    "items": {
      "href": "http://localhost:8090/api/orders/1/items"
    }
  }
}