Jakarta RS-API 2.x (jax-rs 2.0、jsr339) 注解篇

注解

Jakarta RS-API 涉及的注解都易理解，参考代码样例。@Context 注解未来将被替换

容器层面

• ApplicationPath 指定 HttpServer 基础路径(所有接口地址的前缀)

HTTP 接口

• Path 指定URL
• Consumes 接收指定 contentType 的请求
• Produces 响应指定 contentType
• DELETE
• GET
• HEAD
• OPTIONS
• PATCH
• POST
• PUT

参数解析

• CookieParam Cookie 中读取参数
• FormParam Form 中读取参数
• HeaderParam Header 中读取参数
• MatrixParam MatrixURI 中读取参数，如：moremaps.com/map/color;lat=50;long=20;scale=32000
• PathParam URL 中读取参数，如： /{id}
• QueryParam URL 中读取参数，如：/test?a=1&b=2
• BeanParam 通过以上注解，构造 Bean 对象

@Path("/user")
public class User {

    @GET
    @Path("/{id}")
    @Produces("application/json;charset=utf-8")
    @Consumes("application/json;charset=utf-8")
    public User getUser(
        @PathParam("id") String id,
        @HeaderParam("name") String name,
        @CookieParam("sex") Integer sex,
        @BeanParam Mybean bean
    
    ) {
        return new User();
    }
}


public class MyBean {
    
    @CookieParam("account")
    private String account;
    
    @HeaderParam("name")
    private String name;
}