jax-rs jax-ws

在本文中，我们来看一下JAX-RS中与资源方法匹配的HTTP请求 。 它是JAX-RS的最基本功能之一。 通常，使用JAX-RS API的开发人员不会接触（或真正不需要知道） 匹配过程的细节，请放心，由于我们的RESTful，JAX-RS运行时会在后台悄悄地推出其算法。客户端保持那些HTTP请求的到来！

万一术语请求资源方法匹配对您来说是陌生的–就是JAX-RS提供程序通过它向您的资源类之一（使用@Path装饰）的特定方法分配HTTP请求的过程。 可以使用JAX-RS规范文档来详细解释这一点（ 不过，在本文中，我们将仅介绍冰山一角！ ）

主要标准

在请求匹配过程中要考虑哪些因素？

• HTTP请求URI
• HTTP请求方法（GET，PUT，POST，DELETE等）
• HTTP请求的媒体类型
• 请求的响应的媒体类型

高级步骤

粗略的图表应该会有所帮助。 在此之前，这里是示例场景

• 两个资源类 – Books.java，Movies.java
• Books.java中的资源方法路径 – / books /，/ books / {id}（URI路径参数），/ books？{isbn}（URI查询参数）
• HTTP请求URI – / books？isbn = xyz

谁会赢 ？

@Path("books")
public class Books{@Produces("application/json")@GETpublic List<Book> findAll(){//find all books}@Produces("application/json")@GET@Path("{id}")public Book findById(@PathParam("id") String bookId){//find book by id e.g. /books/123}@Produces("application/json")@GETpublic Book findByISBN(@QueryParam("isbn") String bookISBN){//find book by ISBN e.g. /books?isbn=xyz}
}

@Path("movies")
public class Books{@Produces("application/json")@GETpublic List<Movie> findAll(){//find all movies e.g. /movies/}@Produces("application/json")@GET@Path("{name}")public Movie findById(@PathParam("name") String name){//find movie by name e.g. /movies/SourceCode}
}

JAX-RS请求方法匹配过程

分解正在发生的事情

• 将可能匹配的候选对象缩小到一组资源类

这是通过将HTTP请求URI与资源类上@Path注释的值进行匹配来完成的

• 从上一步的资源类集中，找到一组可能匹配的候选方法（将算法应用于过滤后的资源类集）
• 归结为可以处理HTTP请求的确切方法

将HTTP请求谓词与HTTP方法特定的注释（@ GET，@ POST等）进行比较，将Content-Type标头指定的请求媒体类型与@Consumes注释中指定的媒体类型以及指定的响应媒体类型进行比较将Accept标头中的“首选项”与@Produces批注中指定的媒体类型进行比较

我强烈建议您查看org.glassfish.jersey.server.internal.routing包中实现类的Jersey服务器端逻辑 ，以加深了解。 您可以查看的一些类/实现是

• MatchResultInitializerRouter
• SubResourceLocatorRouter
• 方法选择路由器
• 路径匹配路由器

是时候挖了……。？

祝您黑客愉快！

翻译自: https://www.javacodegeeks.com/2015/03/quick-peek-at-jax-rs-request-to-method-matching.html

jax-rs jax-ws