近日,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))。
活动推荐:
2023年9月3-5日,「QCon全球软件开发大会·北京站」 将在北京•富力万丽酒店举办。此次大会以「启航·AIGC软件工程变革」为主题,策划了大前端融合提效、大模型应用落地、面向 AI 的存储、AIGC 浪潮下的研发效能提升、LLMOps、异构算力、微服务架构治理、业务安全技术、构建未来软件的编程语言、FinOps 等近30个精彩专题。咨询购票可联系票务经理 18514549229(微信同手机号)。
评论