RAML 1.0 包含多个带有资源的文件

Question

我想在多个文件中定义 REST 资源并将它们包含在单个 RAML 文件中我试过 this 但我总是遇到 RAML 错误

Main.raml #%RAML 1.0 title: Main RAML file to include All APIs version: v1 baseUri: http://api.samplehost.com /student: !include student.raml

student.raml

#%RAML 1.0 title: student APIs version: v1 baseUri: http://api.samplehost.com /student: get: # ..etc

但我在包含的文件中收到未知错误：未知节点：'title' in Main.raml

当我从包含的文件 'student.raml' 中删除 'title' 我在 student.raml 文件

中得到了 Unknown Missing required 属性 'title'

Answer 1

我认为用 RAML 做不到这一点。

对我来说，解决这个问题的最佳方法是使用 RAML 库并使用资源类型、特征和类型与您要公开的路由相关联。

有关详细信息，请参阅 RAML 1.0 documentation。

Answer 2

根据 raml-org issue，您的 student.raml 文件应包含如下内容：

get:

这里的重要部分是删除第一行

#%RAML 1.0

RAML 1.0 include multiple files with resources