使用 JAX-RS 2.0 上下文对象以获取有关请求的更多信息
Java API for RESTful Web Services (JAX-RS) 2.0 为应用程序子类、根资源类和提供者提供不同类型的上下文。可使用 @Context 注释将 HttpHeaders、UriInfo、HttpServletRequest 之类的上下文对象插入至应用程序子类、根资源类和提供者中的类字段或方法参数。
关于此任务
可使用对提供者(客户机和服务器)、资源类(仅服务器)和应用程序子类(仅服务器)可用的以下上下文对象:
上下文对象 | 类型 | 描述 |
---|---|---|
应用程序 | 类 | 可使用 @Context 注释将应用程序提供的应用程序子类的实例插入到类字段或方法参数中。对应用程序子类实例的访问允许将配置信息集中到该类中。 注: 此应用程序子类不能插入到应用程序子类自身中,因为这会导致循环依赖性。
|
UriInfo | 接口 | UriInfo 接口提供有关请求 URI 组件的静态和动态信息(针对每个请求)。 |
HttpHeaders | 接口 | HttpHeaders 接口提供对映射表单中的请求头信息的访问或通过强类型便利方法进行的访问。 |
Request | 接口 | Request 接口允许调用者确定最佳匹配表示变体并评估资源的当前状态是否与请求中的任何前置条件匹配。 |
SecurityContext | 接口 | SecurityContext 接口提供对有关当前请求的安全上下文的信息的访问。 |
Providers | 接口 | Providers 接口允许根据一组搜索条件查找提供者实例。 |
ResourceContext | 接口 | ResourceContext 接口提供对缺省范围(针对每个请求)中的资源或子资源类的实例化和初始化的访问。 |
Configuration | 接口 | 客户机和服务器运行时配置都可通过 @Context 注入。这些配置可注入到提供者(客户机或服务器)及资源类(仅服务器)中。 |