JAX-RS 和 HTTP“选项”

一则或许对你有用的小广告

欢迎加入小哈的星球 ,你将获得:专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡/ 赠书活动

目前,正在 星球 内带小伙伴们做第一个项目:全栈前后端分离博客项目,采用技术栈 Spring Boot + Mybatis Plus + Vue 3.x + Vite 4手把手,前端 + 后端全栈开发,从 0 到 1 讲解每个功能点开发步骤,1v1 答疑,陪伴式直到项目上线,目前已更新了 204 小节,累计 32w+ 字,讲解图:1416 张,还在持续爆肝中,后续还会上新更多项目,目标是将 Java 领域典型的项目都整上,如秒杀系统、在线商城、IM 即时通讯、权限管理等等,已有 870+ 小伙伴加入,欢迎点击围观

JAX-RS 规范 为 HTTP OPTIONS 命令定义了合理的默认值。我实际上偶然发现了这个!不确定这是非常明显的(如果是,请善待,不要嘲笑我!)

发现

对于下面代码片段中表示的 JAX-RS 资源,如果您对 http://host:port/context-root/user URI 执行 HTTP OPTIONS 命令,您会惊讶地发现 没有 获得 HTTP 状态 404 – Not发现 错误消息 [ 至少我很惊讶,当然,直到我查看了 JAX-RS 规范文档 ;-) ]


 @Path("user")
public class UserResource {
@GET
@Path("{id}")
public Response find(@PathParam("id") String id) {
    return Response.ok().build();
}

@PUT
public Response create(/*User user*/) {
    return Response.ok().build();
}

@DELETE
@Path("{id}")
public Response delete(@PathParam("id") String id) {
    return Response.ok().build();
}

}


它给了我 WADL 作为回应。甜的 ! :-)


须知

  • 如果有一个用@OPTIONS 注释的显式资源方法,那么相应的逻辑将被执行并且默认行为将被抑制(现在这是显而易见的!)
  • 这并不意味着您可以在 RESTful 应用程序中的任何随机 URI 执行 OPTIONS 命令。这在请求匹配过程之后开始,并且仅适用于由资源类中的 @Path 注释定义的有效 URI。
  • 我在 Glass Fish 4.1 上使用 Jersey 2.10 进行了测试。这是规范规定的标准功能,因此它适用于任何符合 JAX-RS 的实现(例如 RESTEasy)