第二次结对编程作业

在文章开头给出结对同学的博客链接、本作业博客的链接、你所Fork的同名仓库的Github项目地址（2分）

       结对同学链接：https://www.cnblogs.com/huckleberry/p/11708269.html

        Github项目：https://github.com/BloodyVampire/thirteenwater

• 给出具体分工（2分）

       翟鑫亮负责算法的设计，张伟佳负责接口连接，UI两人共同承担

• 给出PSP表格（2分）

PSP2.1	Personal Software Process Stages	预估耗时(分钟)	实际耗时(分钟)
Planning	计划	80	100
· Estimate	· 估计这个任务需要多少时间	60	90
Development	开发	1500	1600
· Analysis	· 需求分析 (包括学习新技术)	600	700
· Design Spec	· 生成设计文档	50	30
· Design Review	· 设计复审	100	80
· Coding Standard	· 代码规范 (为目前的开发制定或选择合适的规范)	30	30
· Design	· 具体设计	800	930
· Coding	· 具体编码	500	600
· Code Review	· 代码复审	40	30
· Test	· 测试(自我测试，修改代码，提交修改)	50	80
Reporting	报告	110	100
· Test Repor	· 测试报告	40	30
· Size Measurement	· 计算工作量	20	10
· Postmortem & Process Improvement Plan	· 事后总结, 并提出改进计划	50	60
	· 合计	4030	4470

 

• 网络接口的使用（3分）

  // 身份验证
        function check()
        {
            $.ajax({
                url:'https://api.shisanshui.rtxux.xyz/auth/validate',
                type:'GET',
                headers:{
                    "Content-Type":'application/json',
                    "X-Auth-Token":localStorage.getItem('token')
                },
                dataType:'json',
                success:function(data){
                    if (data['data']['user_id']==null)
                    {
                        alert("登录过期，请重试");
                        window.location.href='login.html';
                    }
                    else{
                        document.getElementById("chupai").onclick=function () {
                            document.getElementById("fapai").style.display="block"
                            document.getElementById("chupai").style.display="none"
                        }        
                        if (localStorage.getItem('card')!=null)
                            showCard();
                        if (localStorage.getItem('gameid')!=null)
                            document.getElementById('gameid').innerText="房间:"+localStorage.getItem('gameid');
                    }
                },
                error:function(data){
                    alert("登录过期，请重试");
                }
            });  
        }

 

 // 开始对局
        function openGame()
        {
            $.ajax({
                url:'https://api.shisanshui.rtxux.xyz/game/open',
                type:'POST',
                dataType:'json',
                headers:{
                    'X-Auth-Token':localStorage.getItem('token')
                },
                success:function(data){
                    document.getElementById("chupai").style.display="block";
                    document.getElementById("fapai").style.display="none";
                    document.getElementById('gameid').innerText="房间:"+data['data']['id'];
                    localStorage.setItem("gameid",data['data']['id']);
                    localStorage.setItem("card",data['data']['card']);
                    showCard();
                },
                error:function(data){
                    alert("匹配异常，请重试");
                }
            });
        }

• 代码组织与内部实现设计（类图）（6分）

     

 

• 算法的关键与关键实现部分流程图（6分）

此次的算法主要涉及到制作扑克、洗牌和对前中后三堆牌的选择三部分。

1、制作扑克

利用两个字符串数组将扑克的花色和数值保存起来，再用循环将不同花色所对应

的数值扑克制作出来保存到map<int,string>中并将牌号保存到vector<int> oldarr中。

2、洗牌

调用distribute方法里的随机分配函数将根据系统时间产生随机数，在循环里选择该

扑克号存入vector<int> newarr中。

3、分堆选择

由于十三水中的牌型比较多，所以我们依次从大牌型到小牌型考虑。先分后堆，再分中堆，最后前堆。

 

 

• 关键代码解释（3分）

void get_rand_number(vector<int> oldarr, vector<int> &newarr)
{    
    int value;
    srand((int)time(0)); //拿当前系统时间作为种子，由于时间是变化的，种子变化，可以产生不相同的随机数。
    /* 发牌的时候对于已经分配的数据不再修改 */
    for (int index=52;index>0; index--)
    {
        value =rand() % index;
        newarr.push_back(oldarr[value]);
        oldarr.erase(oldarr.begin() + value);        
    }
}

以上代码中的srand（）保证了洗牌的随机性。

void getpoker(vector<string> handPoker)
 {
         memset(a,'0', sizeof(a));
         for (string str : handPoker)
         {
             int index;
                 if (str[1] > '1' && str[1] <= '9')            
                    index = (str[1] - '2');                    
                 else if (str[1] == '%')index = 8;                    
                 else if (str[1] == 'J' )index = 9;                    
                 else if (str[1] == 'Q')index = 10;                    
                 else if (str[1] == 'K')index = 11;                    
                 else index = 12;                    
                 y[index]++;
             if (str[0] == '&')
             {            
                 a[0][index] = str[1];
                 x[0]++;                
             }
             else if (str[0] == '$')
             {                
                 a[1][index] = str[1];
                 x[1]++;                
             }
             else if (str[0] == '*')
             {                
                 a[2][index] =str[1];
                 x[2]++;
             }
             else
             {                                          
                a[3][index] =str[1];
                x[3]++;    
             }
         }

}

对扑克数组进行赋值，在构造完后方便后面的各种牌型的判断和牌的“删除”。

 

• 展示性能分析图和程序中消耗最大的函数（1分）

• 描述你改进的思路（5分）

　　可以从性能分析图看出，我们的play函数和lookPoker函数所占的消耗最大。我在lookPoker函数先是对扑克复制到

另一个数组，然后再对这个数组进行特殊字符%的判断，这无疑加大了开销，所以将会直接在原来数组里判断并输出。

7、单元测试（5分）

展示出项目部分单元测试代码，并说明测试的函数，构造测试数据的思路

TEST_METHOD(samecolordragon)
        {
            Operation oper;    
            vector<string> temp;
            temp.push_back("#2"); temp.push_back("#3"); temp.push_back("#4");
            temp.push_back("#5"); temp.push_back("#6"); temp.push_back("#7");
            temp.push_back("#8"); temp.push_back("#9"); temp.push_back("#%");
            temp.push_back("#J"); temp.push_back("#Q"); temp.push_back("#K"); temp.push_back("#A");
            oper.getpoker(temp);
            Assert::IsTrue(oper.samecolordragon());
        }

构造一个存储字符串的向量，向其中存储特殊牌型-----至尊清龙，判断samecolordragon函数是否判断正常。

 

• 贴出Github的代码签入记录（1） 

 

 

• 遇到的代码模块异常或结对困难及解决方法（8分）

• 问题描述（2分）

　　翟鑫亮：对福建十三水这种棋牌游戏的规则很迷，什么各种打枪或者全垒打还有

输赢后如何进行水的划分都不是很清楚。

       张伟佳：完全没有这方面的经验和知识，面对问题一头雾水。

• 做过哪些尝试（2分）

　　翟鑫亮：有从网上看过许多这种十三张类似游戏的规则，发现它们的玩法大差不差

只不过是牌型的叫法不同而已。此外还从网上看了一些关于该游戏的视频。

       张伟佳：上网查询资料，去CSDN找帖子，问问题，去哔哩哔哩看各种教学视频，

视频各有倾向，先从简单的入手，再去看一些倾向性比较强的。　　

• 是否解决（2分 )

　　基本解决

• 有何收获（2分）

　　翟：收获的话，大概应该有两点。第一个就是学会了如何打福州十三水，说实话

还是第一次听过这种玩法，一开始还以为是什么旅游胜地呢。其次的话，接触到了

一些游戏规则设计的算法，学会了更加灵活地解决问题。

       张：学会了intellij idea的使用，可以自己制作简单的网页。期间遇到的问题很多，

解决的时候感觉很崩溃，但解决完后还是蛮开心的。总的来说还是蛮有意义的，锻炼了

自主学习能力。

• 评价你的队友（4分）

翟鑫亮：张伟佳nb，就是没能带我飞。

张伟佳：翟鑫亮nb，能很好地安排任务和时间。

• 值得学习的地方（2分）

翟鑫亮：对bgm的审美很有品味，做事情超认真。

张伟佳：做事情超认真，可以一做就是好久，虽然遇到问题也能看的出来很痛苦，但还是能坚持着去解决，我

就要干会其他的才能接着敲代码。

• 需要改进的地方（2分）

翟鑫亮：在web设计那块做的还需要改进，没能够很好地规划UI。

张伟佳：一开始还是没太放在心上，考完试到后面时间已经不够了，还有好多没有学习。以后应该早做规划，提前把

事情安排好。

• 学习进度条（2分）

 

 

第N周	新增代码（行）	累计代码（行）	本周学习耗时（小时）	累计学习耗时（小时）	重要成长
1	0	0	20	20	学会了原型设计工具的基本使用方法，学会了十三水的玩法
2	340	340	50	60	开始学习网页制作，并着手于算法设计
3	520	860	45	100	网页制作基本成型，开始交互工作；
4	412	1272	60	130	基本完成ai和ui制作