不用再等后端的接口啦！这个开源项目花2分钟就能模拟出后端接口(后端开源接口项目模拟)

HelloGitHub-嘉文

这里是 HelloGitHub 推出的《讲解开源项目》系列，今天给大家带来一款开源免费的模拟后端 API 的工具：moco

没学过后端开发的也能快速上手这个开源项目，靓仔靓妹们不必再辛苦等待后端开发 API，从而有更多的时间逛 HelloGitHub 体验更多有趣的开源项目。
接下来本文将用带你快速上手 moco 这个开源工具，让你不再卡在后端接口的开发进度上，一骑绝尘！

项目地址：https://github.com/dreamhead/moco

我做前端或者客户端开发，对我有什么用？

我做后端开发，对我有什么用？

JDK1.8+(推荐1.8版本)2.2 下载 jar 包

点击此处下载 jar 包

新建 hello.json 文件，写入以下内容

[{"description":"moco快速开始示例","request":{"uri":"/hello"},"response":{"text":"HelloGitHub"}}]

目录结构如下

├──hello.json//API接口配置文件├──moco-runner-1.1.0-standalone.jar//下载的模拟API的工具2.4 运行项目

在该目录下运行

java-jarmoco-runner-1.1.0-standalone.jarhttp-p9999-chello.json

moco-runner-1.1.0-standalone.jar：运行程序的路径（刚刚下载的包的路径）

http：选择服务类型（有 http、https、socket）

-p 9999：设置服务端口 9999

-c hello.json：设置配置文件路径（刚刚新建的配置文件）

在浏览器中访问一下地址

localhost:9999/hello

效果如图所示

三、详细用法

刚刚的你应该十分轻松地模拟一个简单的后端 API，是不是很有成就感？但是你使用或者开发过后端 API 你就也许知道：一个合格的后端 API 不应该仅仅局限如此。
一个合格的后端 API 应该能包括：请求方法、请求 URL、请求参数、请求头、请求体、返回状态码、返回提示信息、返回头和返回体等内容。

如何使用 moco 这个开源项目模拟出一个合格的后端接口呢？接下来就带你一步步了解详细用法。

[{"description":"moco基本结构","request":{"uri":"/hello","method":"post"},"response":{"text":"HelloGitHub"}}]json 文件的最层是一个 [] 数组，里面可以封装多个 API（示例只有一个 API）因为 json 配置文件不支持注释，所以这个 API 的注释你可以写到 description 里面request 可以包含请求的所有内容response 可以包含返回的所有内容3.2 模拟一个基本的 RESTful API

[{"description":"模拟一个基本的RESTfulAPI","request":{"uri":"/hello2","method":"post","headers":{"Content-Type":"application/json","Accept":"application/json","token":"header.playload.signature","Accept-Charset":"utf8"},"cookies":{"login":"true"},"json":{"name":"zhangsan","age":13}},"response":{"json":{"message":"测试成功"},"latency":{"duration":2,"unit":"second"},"headers":{"Content-Type":"application/json","token":"new-header.new-playload.new-signature"},"cookies":{"login":{"value":"true","domain":"localhost","secure":"true","httpOnly":"true","path":"/"}}}}]method：请求方法headers：请求头cookies：请求 Cookiesjson：请求体的一种类型（还有 froms 表单等类型）response 返回值的 headers 、json、cookies 也类似latency 模拟服务器卡顿（因为模拟的后端 API 返回数据几乎是瞬间的，这里我们让其卡顿 2 秒）

测试

这里我们使用 GitHub 上面开源免费的 API 测试软件 Postman 进行测试

（1）url、请求方法、请求头和 Cookies

（2）请求体（json）

（3）测试效果

点击 Send 发送，并在下方 response 查看测试效果

查看返回的请求头

查看返回的 Cookies

查看全局 Cookies

3.3 附件下载

有时候我们需要模拟文件下载，moco 如何实现呢？

[{"description":"moco附件下载","request":{"uri":"/hello"},"response":{"attachment":{"filename":"demo.txt","file":"demo.txt"}}}]

文件目录

├──hello.json//API接口配置文件├──moco-runner-1.1.0-standalone.jar//模拟API的工具├──demo.txt//要下载的文件，这里可以使用相对路径

localhost:9999/hello 即可下载 demo.txt 文件

如果我们刷新页面想获得不同的内容 moco 如何实现呢？

[{"description":"moco轮询数据","request":{"uri":"/hello"},"response":{"cycle":[{"text":"hello1"},{"text":"hello2"},{"text":"hello3"}]}}]

访问 localhost:9999/hello 会依次得到如下内容

hello1hello2hello3hello1hello2...3.5 重定向

有时候我们想重定向页面 moco 如何实现呢？

[{"description":"moco重定向","request":{"uri":"/hello"},"redirectTo":"https://hellogithub.com"}]

访问 localhost:9999/hello 会自动重定向到 https://hellogithub.com

moco 还支持一些运算符，比如正则表达式。

[{"description":"moco正则表达式","request":{"uri":{"match":"/hello/\\w"}},"response":{"text":"HelloGitHub"}}]

可以通过正则表达式匹配的链接访问，比如

localhost:9999/hello/jarvanlocalhost:9999/hello/bmft3.7 使用模板

有的时候我们的返回参数依赖于请求参数（比如编码类型），这个时候我们就可以用 template 模板来实现，我们可以在模板中通过 req 来表示发送的请求 。

{"description":"moco使用模板","request":{"uri":"/hello","method":"post"},"response":{"text":{"template":"${req.method}"}}}

返回的值是

{"text":"post"}四、最后

看到这里，想必你已经了解开源项目 moco 的基本使用了，是不是觉得很有意思？这里给出一个小建议，如果想真正使用这个开源项目 moco，建议参考官方文档去「实践」，这是最快捷，最有效地使用开源项目的办法。
「实践」就是巩固的最佳方法，希望你能在实践中体验设计程序的快乐！

至此，感谢热爱开源的小伙伴们的阅读。
HelloGitHub 会定时不断介绍 GitHub 上有趣的开源免费的项目，如果你对开源项目感兴趣，那就关注我们收到第一时间的文章推送吧。

如果本文有为你带来一点点帮助，就请在右下角帮我点个赞吧！