7.4. Jakarta RESTful Web 服务和 RESTEasy 应用更改

JBoss EAP 8.0 中删除了以下提供程序：

JBoss EAP 8.0 中删除了以下内容，因为它们现在有 Jakarta RESTful Web 服务替换。

现在，您应该使用 registerProvider （） 和 registerProviderInstance （） 方法。

本节提供有关 JBoss EAP 的 RESTEasy 中一些其他更改的信息。

如需有关文本媒体类型和字符集的更多信息，请参阅 JBoss EAP 7.4 开发 Web 服务应用 中的文本媒体类型和 字符集。

在 RESTEasy 2 中，即使存在具有相同 URI 的另一个子资源，子资源 locator 也可以成功执行。这个行为根据规格不正确。

在 RESTEasy 3 中，当子资源和子资源 locator 中有模糊的 URI 时，调用子资源将成功；但调用子资源 locator 将导致 HTTP 状态 405 方法 Not Allowed 错误。

以下示例包含子资源方法和子资源 locator 上的模糊 @Path 注释。注意端点 anotherResource 和 anotherResourceLocator 的 URI 相同。这两个端点之间的区别在于 anotherResource 方法与 REST 动词 POST 关联。anotherResourceLocator 方法不与任何 REST 动词关联。根据规范，将始终选择具有 REST 动词的端点（本例中为 anotherResource 方法）。

@Path("myResource")
public class ExampleSubResources {
    @POST
    @Path("items")
    @Produces("text/plain")
    public Response anotherResource(String text) {
        return Response.ok("ok").build();
    }

    @Path("items")
    @Produces("text/plain")
    public SubResource anotherResourceLocator() {
        return new SubResource();
    }
}

JBoss EAP 8 中删除了 RESTEasy SPI 提供程序。

JBoss EAP 6.4 中包含的 Jackson 版本已更改。从 JBoss EAP 7 开始，Jackson 供应商已从 resteasy-jackson-provider 改为 resteasy-jackson2-provider。

升级到 resteasy-jackson2-provider 需要一些软件包更改。例如，Jackson 注解软件包已从 org.codehaus.jackson.annotate 改为 com.fasterxml.jackson.annotation。

JBoss EAP 8.1 支持 RESTEasy 6.2。如果您计划将 Spring 6.0 框架与 JBoss EAP 8.1 搭配使用，则必须使用 Java 17。

Spring 4.0 框架引入了对 Java 8 的支持。如果您计划将 RESTEasy 3.x 与 Spring 集成，请确保将 4.2.x 指定为部署中的最小 Spring 版本，因为这是 JBoss EAP 7 支持的最早稳定版本。

自 JBoss EAP 7 起，Easy Jettison JSON 提供程序已被弃用，默认情况下不再添加到部署中。建议您切换到推荐的 RESTEasy Jackson 供应商。如果您希望继续使用 Jettison 供应商，您必须在 jboss-deployment-descriptor.xml 文件中定义一个明确的依赖关系，如下例所示。

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
  <deployment>
    <exclusions>
      <module name="org.jboss.resteasy.resteasy-jackson2-provider"/>
      <module name="org.jboss.resteasy.resteasy-jackson-provider"/>
    </exclusions>
    <dependencies>
      <module name="org.jboss.resteasy.resteasy-jettison-provider" services="import"/>
    </dependencies>
  </deployment>
</jboss-deployment-structure>

有关如何定义显式依赖项的更多信息，请参阅 JBoss EAP 7.4 开发指南中的 向部署添加明确模块依赖。

MicroProfile 是规范的名称，开发人员可以用于配置应用和微服务在多个环境中运行，而无需修改或重新打包这些应用程序。在以前的版本中，MicroProfile 作为技术预览提供 JBoss EAP 7.3，但自此后已被删除。MicroProfile 现在仅适用于 JBoss EAP XP。