注解
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;
}