第 53 章 注解继承

摘要

JAX-RS 注释可以通过子类和实施注释接口的类来继承。继承机制允许子类和实施类覆盖从其父级继承的注解。

概述

继承是 Java 中更强大的机制之一，因为它允许开发人员创建能够满足特定需求的通用对象。JAX-RS 通过允许将类映射到来自超级类的资源使用的注解来保留此电源。

JAX-RS 的注解继承也扩展为支持接口。实施类继承其实施接口中使用的 JAX-RS 注释。

JAX-RS 继承规则提供了覆盖继承注解的机制。但是，无法从超级类或接口继承的构造中完全删除 JAX-RS 注解。

继承规则

资源类从它实施的接口继承任何 JAX-RS 注释。资源类也会从扩展的任何超级类继承任何 JAX-RS 注解。从超级类继承的注解优先于从 符号继承的注解。

在 例 53.1 “注解继承” 中显示的代码示例中，Kaijin 类的 getMonster （） 方法继承了 Kaiju 接口的 @Path、@GET 和 @PathParam 注解。

例 53.1. 注解继承

public interface Kaiju
{
  @GET
  @Path("/{id}")
  public Monster getMonster(@PathParam("id") int id);
  ...
}

@Path("/kaijin")
public class Kaijin implements Kaiju
{
  public Monster getMonster(int id)
  {
    ...
  }
  ...
}

覆盖继承的注解

覆盖继承的注解就像提供新注解一样容易。如果子类或实施类为方法提供自己的 JAX-RS 注释，则忽略该方法的所有 JAX-RS 注释。

在 例 53.2 “覆盖注解继承” 中显示的代码示例中，Kaijin 类的 getMonster （） 方法不会从 Kaiju 接口继承任何注解。实施类覆盖 @Produces 注释，它会导致从接口中的所有注解被忽略。

例 53.2. 覆盖注解继承

public interface Kaiju
{
  @GET
  @Path("/{id}")
  @Produces("text/xml");
  public Monster getMonster(@PathParam("id") int id);
  ...
}

@Path("/kaijin")
public class Kaijin implements Kaiju
{

  @GET
  @Path("/{id}")
  @Produces("application/octect-stream");
  public Monster getMonster(@PathParam("id") int id)
  {
    ...
  }
  ...
}