homework-05

1.准备工作

　　队伍成员：梁杰，夏天晗，谢祖三。

　　周五晚上吃完饭，我们就开始了讨论。

　　这次的要求是写服务器，客户端以及游戏结果动态显示。很明显是三个部分，我们也就顺其自然， 一人一个部分。梁杰负责服务器，我负责游戏结果的动态显示，谢祖三负责客户端。

　　客户端、服务器使用的语言是Python，Python简洁明了，写起来很流畅。而游戏结果的动态呈现则是使用了JS+Html5。

　　这次我们并没有像前两次一样大家一起编程，而是分配完任务之后大家分别完成最后再一起测试。主要考虑到实际开发中团队成员不可能每次都在一起开发，主要还是要分工来做的。

 

2.具体思路

　　虽然是分工合作，但是开始仍然要进行讨论。经过我们的讨论，第5次作业的难点大概有这些：

　　难点1：服务器和客户端如何通信

　　服务器和客户端通信是重中之重，如果这个搞不定那后面都不用做了。对于这个问题，我们的主要思路是为客户端和服务器定义一套命令规则，比如客户端发送的数据如果以“check”开头，服务器就会返回当前的状态；如果以“sign” 开头，服务器就会注册用户。同样，客户端也会根据服务器返回的数据执行不同的操作。

 

　　难点2：服务器和展示页面如何通信

　　这个也是一个大问题，我们参考了其他开发教程中服务器和页面的开发模式，最后决定采用数据接口来解决。数据接口就是说服务器和页面约定好一种数据格式，然后当页面访问服务器时，服务器就按照约定好的格式返回数据，页面再进行解析并显示。

 

　　难点3：如何应对多客户端

　　我们想做的是真正实用的服务器，所以只能处理单客户端是肯定不够的。对于多客户端，最直接的思路就是多线程。由于Python对多线程的支持非常好，我们实现起来也不是特别难。

 

　　难点4：大家如何协同开发

　　这是我们关注的一个重点，也是我们希望学到东西的一个环节。讨论完之后就进入 开发阶段，大家如何在身处不同地方的情况下协同开发，我们并没有一个成熟的方案。不过经过我们的讨论，最后还是决定采用“同时开发”，“连环组合”，“统 一测试”的方案。“同时开发”是指分配完任务之后大家同时完成自己的任务；“连环组合”是指大家完成自己的任务之后，一环一环进行组合，首先是客户端服务器组合，然后是服务器页面组合，确保出现问题可以第一时间定位；“统一测试”是指组合完成并成功运行之后，大家一起进行测试，看看在多机情况下是否可以正常运行。

　　

3.实际编写

　   我编写的是数据呈现的这块内容。

　　刚开始我是想使用原生的JS来完成，但是考虑到这次作业的时间较紧，于是决定采用Jquery和网上的一些用于绘制数据图表的插件来协助完成。这一块工作的一大难点就是与服务器之间的数据沟通。由于一开始服务器的设置有一些问题，导致页面一直没有足够权限从服务器获取结果。所以也就只能一边和梁杰交流错误信息，一边去查解决方法。

　　结果呈现这一块很多时候需要随着服务器代码的更新而做一些变动，总的来说这一块的编写并不难，由于借用了网上一些较为成熟的插件，使得最后的实现效果还算不错。

　　最后统一测试的时候不像我们想象的那么顺利。本来我们考虑用路由器，但是连上路由之后发现互相都无法ping通，更不用说玩游戏了。后来折腾了半天，用网线互联搞定了。还得感谢谢祖三同学带了一根网线过来……

 

 

三、测试功能

　　采用人工测试。

　　

　　首先开启服务端：

$ python goldserver.py 1

　　

　　可以看到服务器开启成功，正在等待客户端连接。

　　1是指第一种游戏类型，也就是每个用户提交1个数字。如果参数改成2就是第二种游戏类型。

　　这里说明一下，游戏进行中也是可以连接服务器的，但是这样的话新连接的客户端成绩是0，对于其他客户端来说可能不太公平，所以我们留了一段时间来让所有客户端连接服务器，然后统一开始游戏。

　　然后我们运行自动连接脚本，将所有客户端连接到服务器：

 

$ python auto_play.py

　　我们可以看到有大量客户端连接到了服务器：

 

　　然后稍等一会，游戏就开始了：

　　可以看到服务器会输出游戏轮数，每轮黄金点。

　　

　　然后我们来看看页面展示，打开result.html，可以看到上面是动态黄金点的表：

 

　　这个表会随着游戏进行自动更新。

　　

　　页面下方是动态用户排名：

　　

　　同样会自动更新。

　

四、总结

　　这是我们第三次结对编程，这次并没有采用之前的一起编程的方式，而是创新的采 用了一种“分布式编程”的方式来完成作业。虽然大家实际开发中遇到了很多没有想到的问题，但是通过我们的努力，所有的问题都被克服了。总的来说，这次的作业完成的比较满意，老师的要求也全部达到了。

 

 

五、独特之处

　　这里单独把独特之处列出来，方便大家查看。

　　

　　多线程：

　　　　多线程是处理高并发客户端的利器，如果没有多线程很难保证在较短的游戏时间内处理所有用户请求。

　　命令规则：

　　　　命令规则是指客户端和服务器之间通信的标准。我们采用的主要是类命令的格 式，所以叫做命令规则。例如：sign username password 就是注册用户的命令，play username password 34 就是参与游戏的命令。这种方式简单有效，便于开发。

　　数据接口：

　　　　数据接口主要是处理服务器和页面间的通信。我们约定的数据类型是json格式，也就是说每当页面向服务器请求数据时，服务器会将所有黄金点以及当前用户排名封装成json格式数据返回给页面，然后页面解析json数据并进行更新。

　　动态更新：

　　　　动态更新主要是在页面内部使用定时的js来进行异步刷新，从而保证随服务器的游戏进程动态更新黄金点和用户排名。

　　

六、时间统计

 

Personal Software Process Stages	时间百分比(%)	实际花费的时间 (分钟)	原来估计的时间 (分钟)
计划	10%	36	24
·         估计这个任务需要多少时间， 把工作细化并大致排序	10%	36	24
开发	85%	306	204
·         需求分析 (包括学习新技术)	15%	54	36
·         设计复审 (和同事审核设计文 档)	10%	36	24
·         代码规范 (制定合适的规范)	5%	18	12
·         具体设计	10%	36	24
·         具体编码	35%	126	84
·         代码复审	5%	18	12
·         测试（自我测试，修改代码， 提交修改）	5%	18	12
总结报告	5%	18	12
总计	100%	总用时  360