泽西岛：未设置content-type时，@ Consumes不太起作用

Question

我试图弄清楚@Consumes在这里如何工作。

我有一个如下所示的简化资源，并且我只希望此资源使用“ application / vnd.myApp + xml”。

@Path("/app")
@Consumes("application/vnd.myApp+xml")
@Produces("application/vnd.myApp+xml")
public class AppResource {
    @POST
    public Response postStuff() {
        ...
    }
}

我有以下测试用例：

public class AppResourceTest extends JerseyTest {
    @Test
    public void testApp() {
        // #1: Works fine
        ClientResponse response = resource().path("app")
                    .accept("application/vnd.myApp+xml")
                    .post(ClientResponse.class);

        ...

        // #2: Throws a 415 Unsupported Media Type
        ClientResponse response = resource().path("app")
                    .accept("application/vnd.myApp+xml")
                    .type("text/plain")
                    .post(ClientResponse.class);

        ...

        // #3: Works fine
        ClientResponse response = resource().path("app")
                    .accept("application/vnd.myApp+xml")
                    .type("application/vnd.myApp+xml")
                    .post(ClientResponse.class);

        ...
    }
}

从上面的3个测试中，＃2和＃3按预期工作。

至于＃1，如果我没有设置content-type，为什么它也不会抛出415？

Answer 1

基于@Consumes
api（http://jsr311.java.net/nonav/releases/1.0/javax/ws/rs/Consumes.html）和HTTP类型规范（http://www.w3.org/Protocols/
rfc2616 /
rfc2616-sec7.html＃sec7.2.1

）以及您所看到的行为，我认为可以得出以下泽西实现的结论是安全的：

如果客户端未设置Content-Type，则Jersey不会默认设置，但允许它通过任何/所有@Consumes注释。

如果为URI设置了多个@Consumes {不同类型}，并且客户端未设置Content-
Type，则Jersey将默认为第一个@Consumes批注或可接受类型列表中的第一个类型。

设置“接受”标头值时，Jersey将找到最佳拟合方法来执行。如果最适合多种方法，则默认为第一个定义的方法。

总结@Consumes仅在且仅当客户端设置了Content-Type时才充当过滤器，否则Jersey将尝试查找最合适的匹配项。这确实符合HTTP规范：

任何包含实体主体的HTTP / 1.1消息都应包含定义该主体媒体类型的Content-Type头字段。当且仅当Content-
Type字段未提供媒体类型时，接收方可以通过检查其内容和/或用于标识资源的URI的名称扩展来尝试猜测媒体类型。如果媒体类型仍然未知，则接收者应将其视为“应用程序/八位字节流”类型。

如果目标是让@Consumes充当白名单，则可以使用servlet过滤器将未设置任何请求的内容类型默认为内容类型。