@

一、团队介绍

成员姓名	任务分配	成员课程设计博客链接
兰泽祥（组长）	数据库，斗地主规则的实现，人机自动出牌的算法，实体类的设计	JAVA面向对象编程课程设计——web版斗地主
吴修恩	JSP界面的设计，前后端数据的交互，servlet设计，动态更新界面	Java课程设计---web版斗地主

二、项目GIT地址

fight_against_landlords

三、项目git提交记录截图

四、项目功能架构图、主要功能流程图

五、面向对象设计类图

1、CardGames类图：该类为牌局组类，与2的牌局类不同的是，牌局组对象里包含了一个Map以及牌局标识ID。

2、CardGame类图：该类为牌局对象，包含了一个牌局中需要用到的地主牌，3副手牌，地主标识，是否出牌的标识等等。

3、Card类图：该类为卡牌对象，用于存放54张扑克牌，只包含了卡牌的名称，即图片名

4、UserUserInformation类图：该类为用户信息类，包含了用户信息有用户的账号，昵称和积分

5、User类图：该类为用户类，包含了用户的账号密码

六、项目运行截图与屏幕录制

1、登录界面

2、注册界面

3、初始界面

4、排行榜界面

5、游戏界面

6、项目运行屏幕录制（主要展示多人同时进行游戏）

七、项目关键代码

1、通过Ajax提交数据

本次课设中是调用jQuery中的ajax（）方法进行发送请求的，所以首先需引入jQuery。

type: 所要请求的方式（post或get）。
url: 发送请求的地址。
contentType：内容编码类型，默认为"application/x-www-form-urlencoded"。该默认值适合大多数应用场合。但是要传输复杂的json对象时就须要使用application/json 。
traditional: 有true和false两种值，默认的话，traditional为false，即jquery会深度序列化参数对象，servrlet api 无法处理， 而设为true便可阻止深度序列化。这样就可以在Java后台通过request.getParameterValues() 就可以简单获取数组了。(适用于简单的字符串数组，复杂的对象还是使用默认值，在后台再使用流进行读取)
success: 载入成功后执行回调函数

还有个getJSON专门请求json数据，格式为$.getJSON(url,[data],[callback])
url：string类型， 发送请求地址
data ：可选参数， 待发送 Key/value 参数 ，同get，post类型的data
callback ：可选参数，载入成功时回调函数，同get，post类型的callback

后台数据返回：

后台可以定义一个map集合，然后将键值对一一对应，最后使用JSON.toJSONString（）方法转化为json字符串返回给前端。

2、斗地主规则的设计

既然是一个游戏，那就要有规则，其中最主要的就是，判断所选的牌型是否正确，即是否符合规则。在牌型符合规则时，需要判断是否能够出牌。
在判断所选的牌型是否符合规则的设计中，因为规则中的牌型是固定的，所以设计了一个常量CardType类，这个常量类中包括了符合斗地主规则的所有可选牌型以及不允许出牌的常量。

判断牌型的时候，需要根据所选的牌的数量，以及各个牌型的特征，如：连对的基本特征为，需要连续3对，并且这三对的数值是连续的等等，来判断用户所选的牌是否为规则内的牌型，是的话返回相应的牌型，供后面的算法判断，如果不是则返回c0，服务器就会给客户端相应的反馈，禁止用户出所选的牌。

判断完牌型后，如果返回的不是c0，则需要判断用户是否能够出所选的牌。在这个判断中，首先就需要判断用户是主动出牌还是跟牌，如果为主动出牌，则服务器就会给客户端相应的反馈，同意用户出牌；如果为被动出牌，则需要判断当前用户所选的牌，与前面的用户出的最大的牌进行比较。
当前面出的牌不是炸弹，而用户选的牌型为炸弹时，既可以出牌。当用户选的牌型不为炸弹时，需要判断该用户所选的牌是否与前面用户所出的牌型相符合，若符合，则判断该用户所选的牌是否比前面用户所出的牌大，若符合则允许出牌，否则禁止用户出牌。

八、项目代码扫描结果及改正

使用阿里巴巴静态扫描工具对我们的项目进行扫描，得到的结果为：79 Blockers， 15 Criticals， 240 Majors。经过3个多小时的修改，将所有工具给我们的建议，全部修改完。


九、尚待改进

1、本次课设只有一周的时间，时间赶，任务重，没有在界面上画太多的时间，所以这个界面有点丑陋。
2、我们这次课程设计写的程序已经支持多人同时进行游戏，但是只能是单机游戏，尚未实现多人进行同一场游戏。
3、我们所设计的机器人算法比较直白，比较“傻”，可以深入研究，甚至是通过人工智能的算法来提高人机的出牌机制，使得人机变得更“聪明”。

十、附录

1、我们写的课程设计是JAVA web项目，故我们买了一个阿里云学生服务器，在课程设计结束时，我们已经将我们的项目部署到了该服务器上，有效期至2019-02-16。大家有兴趣了解一下的可以访问：网络版单机斗地主。
2、项目部署方法