管理 Jax-RS/Jersey 中的嵌套资源，该资源有时应表现为非嵌套资源

Question

我正在使用 Jax-RS Jersey 开发简单的 API。假设我正在考虑某个国家/地区商店销售的商品的域。

我的设计包括这两个调用：

• /webapi/items
• /webapi/store/1/items

他们都应该返回一个物品清单，第一个应该返回在那个国家销售的所有物品，第二个应该只返回商店编号 1 销售的物品。

我当然有两个资源，一个处理所有关于商品的请求的 ItemResource，以及一个处理所有关于商店的请求的 StoreResource。

@Path("items")
class ItemResource {

@GET
public List<Item> getAllItems(){
}

.

@Path("stores")
class StoreResource

@GET
@Path("/{storeId}/items")
public List<Item> getItemsSoldByStore(@PathParam("storeId") long storeId) {
}

我想做的是将第二个请求传递给 ItemResource，以避免 StoreResource 和模型类 Item 或专门为管理项目而创建的数据库接口（如 DAO）之间的耦合。 我知道我可以将 ItemResource 视为子资源或 StoreResource 的嵌套资源，但关键是这并不总是正确的，因为有时我想在不传递商店 ID 的情况下调用 ItemResource 来获取所有项目（这是第一个请求 http://foo.com/webapi/items 的情况。 我想在 ItemResource 上保留 @Path("items") 注释，以便它处理对 /items 端点的每个请求。

在这种情况下正确的设计是什么？感谢您的帮助。

Answer 1

您可以通过从父资源返回资源来创建嵌套资源。

// Parent resource
@Path("stores")
class StoreResource {

  @GET
  @Path("/{storeId}/items")
  public List<Item> getItemsSoldByStore(@PathParam("storeId") long storeId) {
     return ItemResource(storeId);
  }
}

// nested resource

class ItemResource {

  @GET
  @Path("{storeId}")
  public List<Item> getAllItems(@PathParam("storeId")){
     // return your items
  }
}