在JAX-RS中，将列表作为响应返回的最可移植（或标准）方式是什么？

Question

嗯，任何人都可以说这个问题已经被问到并回答了。不要紧，我也找到他们了。

• JAX-RS：如何在返回响应对象时自动序列化集合？
• 通过GenericEntity在RESTful响应对象中使用Java-generics模板类型

我对使用列表 响应的方式并不感到困惑，只是对可移植性不太相信。

@XmlRootElement
public class Stock {

    @XmlAttribute
    private Long id;
}

@GET
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
public List<Stock> readStocks() {
    final List<Stock> list = getStocks();
    return list;
}

据了解，GlassFish和WileFly工作。

<stocks> <!-- automatic plural? -->
  <stock xmlns="http://...">
  </stock>\
  <stock xmlns="http://...">
  </stock>
</stocks>

<collection> <!-- fixed? -->
  <stock xmlns="http://...">
  </stock>\
  <stock xmlns="http://...">
  </stock>
</collection>

和JSON（我认为它可能因提供者而异）

[
    {
        "id": 1
    },
    {
        "id": 2
    }
]

有时，当容器找不到MessageBodyWriter时，我会发现一个问题。所以我确实喜欢这个。

@GET
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
public GenericEntity<List<T>> readStocks() {
    return new GenericEntity<List<Stock>>(getStocks()) {};
}

@GET
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
public Response readStocks() {
    return Response.ok(new GenericEntity<List<Stock>>(getStocks()) {}).build();
}

@XmlRootElement
public class Stocks {
    @XmlElement
    private List<Stock> stock;
}

@GET
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
public Stocks readStocks() {
    final Stocks entity; ///
    return Response.ok(entity).build();
}

根据4.2.4标准实体提供者(JSR-339)，list不在强制预打包MessageBody(ReaderWriter)的列表中。

列表 是否标准化？或者哪种方式最便携？

Answer 1

list实际上不是问题。对于iswritable，JSON和XML的MBWs通常总是返回true。这就是他们如何能够处理你抛出的所有类型。这与类型擦除有关。genericentity的目的是缓存泛型类型参数，这允许MBW知道要封送为什么类型。

请注意，GenericEntity通常在返回Response时使用。想象一下这个案子

public Response get() {
    List<Somthing> l = service.get();
    return Response.ok(l).build();
}

由于类型擦除，在实体到达类型时，MBW无法知道该类型。对于某个提供者来说，这并不重要。例如，对于Jackson，它通常不需要知道类型，因为它只是内省属性以进行序列化。但是对于Moxy/JAXB，它本质上需要了解类。这就是genericentity发挥作用的地方。

List<String> list = new ArrayList<String>();
GenericEntity<List<String>> entity = new GenericEntity<List<String>>(list) {};
Response response = Response.ok(entity).build();