为什么返回类型为 Iterable<MyClass> 的 jax-rs 服务有效而 Collection<MyClass> 无效？

Question

假设我有一个简单的 Person 类，其名称和姓氏作为属性。还假设我有一个简单的休息服务，它带有返回人员列表的 get 端点。

public class Person {
    // name and last name properties plus getters and setters
}

// Service
@Stateless
@LocalBean
@Path("test")
public class SimpleRestService {
    //Suppose people is initialized and contains actual people
    private ArrayList<Person> people;

    @GET
    @PATH("/people/iterable")
    public Iterable<Person> getPeople(){
        //This one works
        return people;
    }

    @GET
    @PATH("/people/collection")
    public Collection<Person> getPeople(){
        //This one fails. HTTP 500. Nothing on server.log ...
        return people;
    }
}

第一个端点 test/people/iterable 可以正常工作，而 test/people/collection 会因 HTTP 500 而失败。有人对此有所了解吗？

Answer 1

Jersey 有一个注册表，将@Produces 中的 MIME 类型与声明方法返回的 Java 类型以及处理对象以产生响应的有效负载的处理程序相关联。它有一个将Iterable 和List 转换为JSON Array 的处理程序。它还有一个将Map 转换为JSON Object 的处理程序。 Java 接口Collection 的问题在于，没有迹象表明它应该表示为顺序集合（JSON Array）还是命名项的无序集合（JSON Object）。因此，默认情况下没有注册用于将Collection 转换为application/json 的处理程序。这就是您的应用程序服务器上记录的异常中的消息所指示的内容。