二郎蛇

通过布鲁霍·贝纳维德斯

免责声明

自我支撑……漫长的帖子即将到来。

我花了很长时间写这篇博客文章&＃xff0c;主要原因是它涵盖了许多不同的主题。 这将是关于的博客文章

• 黑客马拉松
• TDD
• 游戏开发
• 功能语言中的数据类型抽象
• Erlang
• 位串语法
• RESTful API
• 多种工具&＃xff0c;例如牛仔&＃xff0c;混合器&＃xff0c;步道&＃xff0c;大摇大摆&＃xff0c;拉塞等。

历史

很久以前&＃xff0c;当我还是个孩子的时候&＃xff0c;我就开始用QBasic编程&＃xff0c;而且&＃xff0c;众所周知&＃xff0c;QBasic附带了两个小游戏。 其中之一就是半字节

快进了25年……您会在Erlang Solutions找到我&＃xff0c;试图在Roberto Romero和HernánRivas Acosta的帮助下为我们的下一次黑客马拉松提出主题。 我们想要一个可以在单个屏幕上观看的多人游戏。 当然我们想出了蛇 &＃xff01;

黑客马拉松

每年在Erlang Solutions&＃xff0c;我们都会从项目中休假一天&＃xff0c;我们将所有的时间花在庆祝我们最爱的项目上&＃xff1a; 编程 。 2014年&＃xff0c;我们举办了“一日构建您的应用”竞赛&＃xff0c;并取得了不错的成绩。 对于2015年的版本&＃xff0c;我们决定推出一款多人游戏&＃xff0c;由组织者设置服务器&＃xff0c;然后由团队开发客户。 我将在本博文的其余部分中显示的代码全部来自Hernán&＃xff0c;Roberto和我自己开发的游戏服务器。

目标

蛇的主要目标当然是用于Hackathon。 但是我也有一个隐藏的议程&＃xff1a;由于该项目将在github上开源&＃xff0c;因此我想以此为例来说明我们的工作方式。 我希望能够使人们了解IRC&＃xff0c;erlang问题&＃xff0c;reddit&＃xff0c;stackoverflow等问题&＃xff0c;并提出诸如“嘿&＃xff01; 您如何在Erlang中建立网络服务器&＃xff1f;” 告诉他们“看看这里。 这就是您的做法&＃xff01;”。 考虑到这一点&＃xff0c;我们面对这个项目就好像它是一个客户项目一样&＃xff0c;事实证明&＃xff0c;我们的客户 &＃xff08;我们的开发人员&＃xff09;实际上是我们遇到过的最艰难的客户之一。

建筑

那么&＃xff0c;我们如何为蛇游戏构建多人服务器&＃xff1f; 我们首先将其分为3个主要部分&＃xff1a;

• 一个显示游戏进度的网页。
• 提供网页并提供RESTful API以便实时更新的Web服务器。
• 一个游戏服务器&＃xff0c;它为客户端提供了连接方法。

对于网页&＃xff0c;我们使用纯HTML和一些Javascript&＃xff08;至少可以告诉我&＃xff0c;这对我来说不是很有趣&＃xff1a;P&＃xff09;。 有趣的是 实时的一部分。 我们在SSE上实现了该功能&＃xff08;通常如此&＃xff09;。 在游戏中&＃xff0c;网站看起来像这样&＃xff1a;

从服务器的角度来看&＃xff0c;我们使用Cowboy on Trails实现了RESTful API&＃xff0c;并使用swagger对其进行了文档记录。 最终看起来像这样&＃xff1a;

另一方面&＃xff0c;我们决定为客户开发人员提供2个选择。 他们可以只使用相同的RESTful API和SSE连接与服务器进行通信&＃xff0c;也可以使用我们的HDP协议。

HDP是运行在UDP上的快速协议。 它由Hernán开发&＃xff0c;并以kafka风格记录下来&＃xff0c;供所有人使用。 它专门用于蛇&＃xff0c;但可以轻松地在其他项目中复制。

内部架构

在内部&＃xff0c;正如您在github上看到的那样&＃xff0c;代码分为多个文件夹和多个模块&＃xff0c;我们可以分别对其进行测试。

一方面&＃xff0c;我们拥有游戏的基本构建块&＃xff1a;规则&＃xff08;在spts_core &＃xff09;被实现为每个游戏及其实体&＃xff08;表示为Data Types或Models &＃xff0c;每个都有其自己的模块和不透明类型&＃xff09;的gen_fsm 。 您可以在spts_serpents看到我们的方法&＃xff1a;

我们还为API的不同端点提供了多个牛仔处理程序。 所有这些都是使用混合器构建的&＃xff0c;以“继承”来自spts_base_handler功能。

为了将事件从核心报告给SSE或HDP客户端&＃xff0c;我们使用gen_event但是为了简化我们的生活&＃xff0c;我们实现了一个简单的gen_event处理程序&＃xff0c;该处理程序反过来只需要在您的客户端中实现一个功能&＃xff1a; notify(pid(), event()) 。 我们称它为spts_gen_event_handler 。 我们使用相同的处理程序为核心编写测试&＃xff0c;而无需依赖任何类型的客户端。

对于HDP&＃xff0c;我们编写了一个异步UDP侦听器&＃xff0c;该侦听器为每个连接的客户端启动gen_server &＃xff08;UDP中没有实际的连接&＃xff09;。 之所以简单&＃xff0c;是因为我们将所有协议解析/验证逻辑抽象到了自己的模块&＃xff1a; spts_hdp 。 该模块本身就是Erlang 位语法的强大示例。 它展示了列表综合&＃xff0c;结合了二进制综合和许多惊人的二进制模式匹配表达式。 我的最爱&＃xff1a;

开发方法论

并且&＃xff0c;为了创建所有这些&＃xff0c;我们使用了通常的方法&＃xff1a; TDD 。 为此&＃xff0c;我们使用common_test进行了工作&＃xff0c;您可以在此处看到一些冗长的测试套件列表。 我们已经写了许多有关TDD&＃xff0c;代码覆盖率甚至是元测试的博客文章&＃xff0c;因此在这里我不再赘述。 请记住&＃xff0c;如果您需要这些示例&＃xff0c;那么这里就足够了。

客户

如果您问自己&＃xff0c;那里有没有客户的例子&＃xff1f; 是的&＃xff0c;他们在这里 。 我自己开发了所有这些程序&＃xff0c;您可以从头开始或使用spts_cli创建自己的程序 。

结果

结论

我们最终实现了我的两个目标。 一方面&＃xff0c;我可以说我们举办了一场非同寻常的Hackathon&＃xff0c;很多人在编码时开心地玩耍。 另一方面&＃xff0c;现在我们有了一个很好的例子&＃xff0c;说明了如何在Erlang Solutions上构建东西以向全世界展示。 您也可以享受它&＃xff01; 做就是了…

…并在浏览器中打开http&＃xff1a;// localhost&＃xff1a;8585开始播放&＃xff01;

而且&＃xff0c;当然&＃xff0c;就像我小时候对Nibbles所做的那样&＃xff0c;最有趣的部分是当您开始修改代码以使毒蛇吃了毒果后变得更胖&＃xff0c;更瘦&＃xff0c;随意喝酒时……

天啊&＃xff01; 我必须执行&＃xff01; 再见&＃xff0c;我9岁&＃xff0c;我有重要的事情要做...

最初于 2018 年4月26日 发布在 www.erlang-solutions.com 上。

该博客文章最初于2015年11月13日为inaka.net撰写。

From: https://hackernoon.com/erlang-serpents-3eca35bf7c6d