泽西不遵守@Produces的响应媒体类型规则

Question

我可能误解了泽西岛规范，即响应的媒体类型，当一种方法可以产生几种方法之一时。根据 https://jersey.java.net/documentation/latest/jaxrs-resources.html#d0e1785，我认为当@Produces（..）注释中列出的两种媒体类型与传入的 Accept 标头匹配时，Jersey 将遵循注释中与这些类型关联的任何权重，或者如果权重未决定获胜者，则选择第一个权重。

下面的代码演示了这在实践中是如何不行为的。在最后两种情况下，当请求不明确时，我期望JSON响应，但我得到的是XML。我对留档的理解是不正确的吗？还是这可能是泽西的一个缺陷？

我尝试过的事情：

1. 从模型中删除@XmlRootElement注释。最后两个案例通过，但第二个案例因没有合适的作者而出现分歧
2. 从资源方法返回Object。结果是案例的通过/失败状态没有变化
3. 从资源类的@Produces（..）注释中删除权重（JSON媒体类型仍然列在第一位）。结果是案例的通过/失败状态没有变化

这个例子是在Ubuntu 14.04上使用Jersey 2.10和Java 1.8_05构建的。

package demo;

import java.net.URI;
import java.util.Arrays;
import java.util.concurrent.Executors;
import java.util.concurrent.ThreadFactory;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.client.ClientBuilder;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
import javax.xml.bind.annotation.XmlRootElement;

import org.glassfish.jersey.jdkhttp.JdkHttpServerFactory;
import org.glassfish.jersey.server.ResourceConfig;

import com.sun.net.httpserver.HttpServer;

public class DemonstrateAmbiguousMediaType {

    private static final String BASE_URI = "http://localhost:8092/";

    public static void main(final String[] args) {

        final HttpServer server = startServer();

        try {

            /*
             * These cases work fine.
             */
            check("application/json", "application/json");
            check("application/xml", "application/xml");

            /*
             * These cases should pass according to Jersey
             * documentation for @Produces
             * https://jersey.java.net/documentation/latest/jaxrs-resources.html#d0e1785
             * but they do not.
             */
            check("application/json", "application/*");
            check("application/json", "*/*");

        } finally {
            server.stop(0);
        }

    }

    private static void check(final String expected, final String... acceptTypes) {

        final MediaType atype = fetchAs(acceptTypes).getMediaType();
        final String actual = atype.getType() + "/" + atype.getSubtype();

        System.out.println(Arrays.asList(acceptTypes) + ":"
            + (expected.equals(actual) ? "pass" : "fail"));

    }

    private static Response fetchAs(final String[] acceptable) {

        return ClientBuilder.newClient()
                            .target(BASE_URI)
                            .path("model")
                            .request()
                            .accept(acceptable)
                            .get();

    }

    private static HttpServer startServer() {
        final ResourceConfig config = new ResourceConfig(Resource.class);
        final HttpServer rval = JdkHttpServerFactory.createHttpServer(
                URI.create(BASE_URI), config, false);
        rval.setExecutor(Executors.newCachedThreadPool(new ThreadFactory() {

            @Override
            public Thread newThread(Runnable r) {
                final Thread rval = new Thread(r);
                rval.setDaemon(true);
                return rval;
            }
        }));
        rval.start();
        return rval;
    }

    @XmlRootElement
    public static class Model {

        public int a = 10;
        public String b = "Bbb";

    }

    @Path("/model")
    @Produces({ "application/json; q=0.9", "application/xml; q=0.5" })
    public static class Resource {

        @GET
        public Model getModel() {
            return new Model();
        }

    }

}

Answer 1

我误读了规范。在@Produces（…）注释中，质量参数名称是qs而不是q。当质量参数指定正确时，上述所有情况都通过。

然而，当质量参数被删除时，最终的案例不会通过。根据泽西岛的文件，应该选择第一个列出的，但不是。