首页天道酬勤,

,

张世龙 05-05 21:23 113次浏览

8种机械键盘轴体的比较

本人,买写代码的键盘,红轴和茶轴怎么选?

rest风格的接口规范

介绍rest风格的接口的设计、开发、测试(分别模拟客户端和服务器端)和协作方法。

Swagger是rest风格的定义描述语义。 以Swagger为中心,OpenSource世界提供了一系列工具,涵盖rest风格的接口定义、接口代码生成等。 可以直接导入到Postman中,也可以通过mock方式模拟接口调用。

接口定义还可以规范参数格式、有效值范围等合法性检查。 安装swagger工具1 $ NPM安装- g swagger-CLI

$ npm install -g swagger-diff

2. API定义文件

的所有接口定义都是在. yaml文件中描述的,位于RestAPI/yaml路径下。

文件|定义|场景

如何检查yaml语法1$ swagger validate Edi.yaml

4. yaml自动生成markdown文档1$ cd doc/RestAPIs/

$ ././疯狂的荷花/swagger2markup

$ git commit-m ' updatedyamlmdfiles '

$ git push

在/doc/RestAPIs下,根据yaml定义生成markdown文档,并将git提交到存储库。

服务器端代码1$ java -jar疯狂荷花/swagger-codegen-CLI.jar generate-lnode js-server-idoc/RES tapis/YAML/- oskeleler

node.js代码在skeleton/nodejs路径下生成。 然后,使用代码集成工具将新的接口更改集成到scc-src项目中。

6 .生成客户端javascript代码1$ java -jar疯狂荷花/swagger-codegen-CLI.jar generate-l JavaScript-idoc/RES tapis/YAML

客户端javascript代码在skeleton/javascript路径下生成,并使用代码合并工具将新的接口更改合并到scc-react项目中。

安卓客户端代码1$ java -jar疯狂荷花/swagger-codegen-CLI.jar generate-ljava-c疯狂荷花/Android _ config.JSON--

Android客户端的java代码在skeleton/android路径中生成,并使用代码合并工具将新的接口更改合并到scc-mobile中;

8.IOs客户端代码1$ java -jar疯狂荷花/swagger-codegen-CLI.jar generate-lo bjc-idoc/RES tapis/YAML/- oskeleton /

iOS客户端的objective-c代码在skeleton/objc路径中生成,并使用代码合并工具将新的接口更改合并到scc-mobile中。

8. mock模式模拟接口

mock模式用于模拟在swagger中定义的接口。 1$ cd skeleton/nodejs/

$ NPM安装

$ node。

1$斯瓦格

引入Postman测试

可以将yaml文件直接导入postman中,然后在postman中开始服务器端测试。

参考资料:

,