RAML 定义可重用子路由

Posted

技术标签:

【中文标题】RAML 定义可重用子路由【英文标题】:RAML definition reusable sub-route 【发布时间】:2017-07-01 16:13:31 【问题描述】:

我们的 api 将有一个可重用的 /posts 子路由,它将应用于不同的***路由。

例如:

/me/posts 
/users/user-id/posts
... 

帖子示例:

/posts 
    /post-id
        /likes 
        /comments 
            /comment-id
... 

帖子也会有固定的子路由、参数等。 用 RAML 定义这种默认的、可重用的子路由的标准方法是什么?

当然,可以决定扭转这一局面并创建一个 /posts 端点,但我认为不应根据 RAML 功能更改 API 定义。此外,如果我想要的话,我应该能够让多个端点指向同一个资源。

如果您有答案,请根据要求分享一个示例

【问题讨论】:

【参考方案1】:

您可以定义一个 ResourceType 并指定您在许多地方使用它。您可以在同一个文件或作为库操作的外部文件中执行此操作。

http://raml.org/developers/whats-new-raml-10

【讨论】:

不幸的是,这似乎效果不佳。 RecourceTypes 作为继承形式的抽象级别存在。我想要的是将自定义子路由添加到不同的端点。特质似乎也不能很好地发挥作用。

以上是关于RAML 定义可重用子路由的主要内容,如果未能解决你的问题,请参考以下文章