RAML 工作组发布 RAML 1.0 与 API Workbench

  • Abel Avram
  • 姚梦龙

2015 年 12 月 6 日

话题:JavaScript架构

近日,RAML 社区发布了 RAML 1.0、API Workbench、一个 JavaScript RAML 解析器和一个 Java RAML 解析器。

RAML 1.0 是一个候选发布版,但它已接近完成,在 11 月底就会完成最后的小修小补。规范定义了语言与特性。相比于 0.8 来说,RAML 1.0 有了如下的新特性:

  • 数据类型——描述数据的能力。它支持内置类型——string,number,integer,boolean,date,file 及继承于它的那些类型。它也含有 enums, arrays, maps, unions,而复杂的数据类型可以由它们构建而成。
  • 库——使用 namespace 来 include 预定义资源,数据类型,资产的能力
  • 覆盖——包括描述,注释和来自其他 RAML 文件的例子
  • 注释——支持超出 RAML 1.0 定义的第三方 metadata
  • 改进安全架构

重要通知:接下来 InfoQ 将会选择性地将部分优秀内容首发在微信公众号中,欢迎关注 InfoQ 微信公众号第一时间阅读精品内容。

和 RAML 1.0 同时公布的还有一个叫做 API Workbench 的基于Atom的 IDE。这个 IDE 可用来设计,构建,测试,写文档及分享用 RAML 定义的 APIs。它兼容 RAML 0.8 和 RAML 1.0。这个 API Workbench 支持代码补全,关键词提示,引用,路径,公共值,类型特性等等。这个 IDE 在架构,引用,资源,模式,行这几个层面上执行自动的校验。新的组成部分也可以在向导的帮助下进行创建。

MuleSoft 也贡献了两个解析器,一个是用于 JavaScript/TypeScript 的,另一个用于 Java。它们现在都处于 beta 版。其他的解析器——包括.NET,Go,JavaScript,PHP,Python,Ruby,Scala 的——还有其他的工具也正处于 RAML 项目库中的不同开发阶段。

RAML 背后有很多供应商在支撑,它们的业务涉及了 APIs 的创建,使用和管理。这些公司有 AWS,CA Technologies,Cisco,Software AG,VMware,当然,还有 MuleSoft。

查看英文原文:The RAML Workgroup Announces RAML 1.0 and API Workbench


感谢张龙对本文的审校。

给 InfoQ 中文站投稿或者参与内容翻译工作,请邮件至editors@cn.infoq.com。也欢迎大家通过新浪微博(@InfoQ@丁晓昀),微信(微信号:InfoQChina)关注我们,并与我们的编辑和其他读者朋友交流(欢迎加入 InfoQ 读者交流群(已满),InfoQ 读者交流群(#2))。

JavaScript架构