请求范围的上下文字段注入到RESTEasy单例中

Question

当尝试在OSGi中将RESTEasy与单例资源嵌入时（使用类似于resteasy-osgi-bundle的方式），令我惊讶的@Context UriInfo是，在每个请求中都注入了有效的字段。

进一步挖掘我发现代理魔术和ThreadLocal在ResteasyProviderFactory。很好，但是我在RESTEasy的文档和JAX-RS规范中都找不到任何有关此类行为的参考。

在Jersey文档中，我们可以找到以下内容：

特定请求对象存在例外，该请求对象甚至可以注入到具有单例作用域的资源的构造函数或类字段中[ OP]。对于这些对象，运行时将注入能够同时处理更多请求的代理。这些请求的对象是HttpHeaders，Request，UriInfo，SecurityContext。可以使用@Context注释注入这些代理。

它在RESTEasy中的外观如何？当前的实施是稳定的还是试验性的？可以注入单例的请求特定类的集合是什么？

Answer 1

这不是实验性的。此行为（针对一组公共对象）在JAX-RS规范中指定。规范页面中没有链接到某个特定部分的锚点，但是您应该看的是第5章：上下文。我将在此处发布一些代码段。

5.1并发
上下文是特定于特定请求的，但是某些JAX-RS组件（具有不同于每个请求的生命周期的提供程序和资源类）的实例可能需要支持多个并发请求。当注入第5.2节中列出的一种类型的实例时，提供的实例必须能够为特定请求选择正确的上下文。使用线程本地代理是实现此目的的常用方法。

5.2上下文类型
本节描述可用于资源类，提供程序和Application子类的上下文的类型。

5.2.1应用

Application可以使用@Context注释将应用程序提供的子类的实例注入到类字段或方法参数中。对Application子类实例的访问允许将配置信息集中在该类中。注意，不能将其注入Application子类本身，因为这将创建循环依赖项。

5.2.2 URI和URI模板

UriInfo可以使用@Context注释将的实例注入类字段或方法参数中。UriInfo提供有关请求URI组件的静态和动态的按请求的信息。例如，以下将返回请求中任何查询参数的名称：

5.2.3标头

HttpHeaders可以使用@Context注释将的实例注入类字段或方法参数中。HttpHeaders提供以地图形式或通过强类型便捷方法访问请求标头信息的方式。例如，以下将返回请求中所有标头的名称：

5.2.4内容协商和前提条件

JAX-RS使用该Request接口简化了对内容协商和前提条件的支持。Request可以使用@Context注释将的实例注入类字段或方法参数中。的方法Request允许呼叫者，以确定最佳匹配表示变种，并评估资源的当前状态是否在请求任何先决条件匹配…

5.2.5安全上下文

该SecurityContext接口提供对有关当前请求的安全性上下文信息的访问。SecurityContext可以使用@Context注释将的实例注入类字段或方法参数中。SecurityContext提供对当前用户主体的访问的方法，有关请求者承担的角色的信息，请求是否通过安全通道到达以及所使用的身份验证方案的信息。

5.2.6提供者

该Providers界面允许根据一组搜索条件来查找提供程序实例。Providers可以使用@Context注释将的实例注入类字段或方法参数中。

需要注意的一件事是，可以注入更多类型，但是上面未列出的任何类型都是特定于实现的。这是RESTeasy文档第15章中的列表。

该@Context注释可以让你的注入情况下javax.ws.rs.core.HttpHeaders，javax.ws.rs.core.UriInfo，javax.ws.rs.core.Request，javax.servlet.HttpServletRequest，javax.servlet.HttpServletResponse，javax.servlet.ServletConfig，javax.servlet.ServletContext，和javax.ws.rs.core.SecurityContext对象。

尽管文档没有在字段注入和参数注入之间进行任何区分，但据我所记得，我认为我能够将其HttpServletRequest注入到字段中。但是我只测试它们以确保。