46.3. 根资源类
概述 复制链接链接已复制到粘贴板!
root 资源类是实施 RESTful Web 服务的 JAX-RS 的入口点。它被解码为 @Path
,用于指定服务实施的资源的根 URI。其方法可直接对资源实施操作,或提供对子资源的访问。
要求 复制链接链接已复制到粘贴板!
类必须使用
@Path
注释进行解码。指定路径是服务实施的所有资源的根 URI。如果 root 资源类指定其路径是 小部件,其方法之一实施
GET
动词,则 小部件 上的GET
会调用该方法。如果子资源指定其 URI 为 {id},则子资源的完整 URI 模板是 widgets/{id},它将处理对 URI (如 widgets/12 和 widgets/42 )发出的请求。类必须具有公共构造器,才能调用运行时。
运行时必须能够为所有构造器的参数提供值。constructor 的参数可以包含使用 JAX-RS 参数注释的参数。有关参数注解的更多信息,请参阅 第 47 章 将信息传递给资源类和方法。
-
至少一个类方法使用 HTTP 动词注释或
@Path
注释进行解码。
Example 复制链接链接已复制到粘贴板!
例 46.3 “根资源类” 显示提供子资源访问权限的 root 资源类。
例 46.3. 根资源类
例 46.3 “根资源类” 中的类满足 root 资源类的所有要求。
类使用 @Path
注释进行解码。服务公开的资源的 root URI 是 customerservice。
类具有公共构造器。在这种情况下,no 参数构造器用于简单。
类为资源实施四个 HTTP 动词。
该类还通过 getOrder ()
方法提供对子资源的访问。子资源的 URI (使用 @Path
注释指定)是 customerservice/order/id。子资源由 Order
类实现。
有关实现子资源的详情,请参考 第 46.5 节 “使用子资源”。