如何解决为 Java 中的现有 API 生成 RAML 文件
我是 RAML 的新手,我正在寻找一种工具或任何可以通过传递一些细节来创建 RAML 文件的方法。如果我尝试手动为现有 API 编写 RAML 文件会花费很多时间。
以下是所需的 RAML 文件格式。
%rAML 1.0
baseUri: https://api.test.com/abc
title: Test
version: v1
traits:
id-required:
headers:
id:
type: string
secret:
type: string
/test/:
description:Test API
post:
is: [id-required]
description: Test
body:
application/json:
example: !include examples/TestRequest.json
type: !include schemas/TestRequestSchema.json
responses:
200:
body:
application/json:
example: !include examples/TestResponse.json
type: !include schemas/TestResponseSchema.json
400:
body:
application/json:
example: !include examples/TestErrorResponse.json
type: !include schemas/TestResponseSchema.json
谢谢, 拉恰纳
解决方法
您可以使用 DocDog。
从那里它从现有的源代码创建 RAML。
如果是 SpringBoot,您可以使用 -lang=spring
轻松运行它。如果是纯JAVA,你可以在你的代码中添加注释(参见readme.md或示例),以便DogDoc可以理解。
希望对你有帮助: https://github.com/skalski/docdog
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。