rest - 在 CXF 中公开 RAML 合约而不是 WADL

Question

我是 REST 世界的新手，在大多数 CXF 示例中，我看到有一个配置可以在发布时在 REST 服务中公开 WADL。

就像是

Available RESTful services:
Endpoint address: http://localhost:8080/ouat-servicesImpl/api
WADL : http://localhost:8080/ouat-servicesImpl/api?_wadl

然后，当点击

<application>
  <grammars/>
  <resources base="http://localhost:8080/ouat-servicesImpl/api">
    <resource path="/topics">
      <method name="POST">
        <request>
          <representation mediaType="application/json"/>
        </request>
        <response>
          <representation mediaType="application/json"/>
        </response>
      </method>
    </resource>
  </resources>
</application>

我正在学习 RAML 及其在合同创建中的好处。有什么办法可以在这个 CXF“主页”服务页面中公开 RAML 合约？还是我混合了 RAML 和 WADL 的概念/目的？实际上我认为这两种方式都是暴露服务合同的方式，但我认为 RAML 更完整

Answer 1

假设您将 CXF 服务打包为 WAR，以下是基于我正在处理的真实项目的实现目标的方法：

• 将 RAML 和 JSON 文件拖放到 webroot 文件夹下：https://github.com/openanalytics/RPooli/tree/master/webapp/src/main/webapp/raml
• 模板baseUri，因此可以在运行时注入：https ://github.com/openanalytics/RPooli/blob/master/webapp/src/main/webapp/raml/api_v1.raml#L21
• 声明.raml它好像是一个 JSP，所以注入可以工作：https ://github.com/openanalytics/RPooli/blob/master/webapp/src/main/webapp/WEB-INF/web.xml#L70
• 添加 RAML mime 类型：https ://github.com/openanalytics/RPooli/blob/master/webapp/src/main/webapp/WEB-INF/web.xml#L76-L79
• 添加一个过滤器来计算的动态部分baseUri：https ://github.com/openanalytics/RPooli/blob/master/webapp/src/main/java/eu/openanalytics/rpooli/web/BaseUriInjectionFilter.java
• 在 web.xml 中连接它：https ://github.com/openanalytics/RPooli/blob/master/webapp/src/main/java/eu/openanalytics/rpooli/web/BaseUriInjectionFilter.java

奖励积分：

• 嵌入 RAML API 控制台：https ://github.com/openanalytics/RPooli/tree/master/webapp/src/main/webapp/raml/ui
• 并从 web-app 主页重定向到它：https ://github.com/openanalytics/RPooli/blob/master/webapp/src/main/webapp/index.html