《口算大作战 2》DLC:算法真奇妙

211614331 王诚荣　　　　211614354 陈斌　--第一次结对作业

DLC

DLC：三年级混合运算模块现已更新！现在您可以愉快的使用三年级题库啦。同时您必须拥有本体才能使用此DLC

一、开发时间表

PSP2.1	Personal Software Process Stages	预估耗时（分钟）	实际耗时（分钟）
Planning	计划
• Estimate	• 估计这个任务需要多少时间	10	5
Development	开发
• Analysis	• 需求分析 (包括学习新技术)	10	10
• Design Spec	• 生成设计文档	10	15
• Design Review	• 设计复审	5	5
• Coding Standard	• 代码规范 (为目前的开发制定合适的规范)	5	10
• Design	• 具体设计	30	60
• Coding	• 具体编码	300	1320
• Code Review	• 代码复审	30	35
• Test	• 测试（自我测试，修改代码，提交修改）	60	100
Reporting	报告
• Test Repor	• 测试报告	40	60
• Size Measurement	• 计算工作量	5	5
• Postmortem & Process Improvement Plan	• 事后总结, 并提出过程改进计划	20	15
	合计	525	1640

二、用户需求分析

本次的需求分析，我没有去过多的研究，因为在作业博客中，已经有了明确的需求：

运算符在2～4个，至少两个不同的运算符
可以加括号
减法运算的结果不能有负数
除法运算除数不能为0，不能有余数
同时要有一二年级的题库在里面
要分别满足一二三年级运算的需求

经过分析，我认为，这个程序应当：

**一二年级只要符合上次作业的需求即可，不需要再次分析 **
三年级加减乘除中都不能有负数
且在除法中，需要特别关注程序除零时的异常处理

三、项目设计分析

1. 设计思路

这次作业由于是结对作业，因此我们有一些明确的分工。在分析完需求之后，我们发现，四则运算是需要重点攻克的难题，但是如果两个人把全部的时间都放在这个地方的话，那么进度一定会被拖慢，无法正常完成任务。所以我们在经过讨论之后，决定先一起讨论一下四则运算的逻辑和解决办法，然后由我负责三年级四则运算的编码，我的队友则负责完成其他模块功能的实现，以此来满足任务需求。最后再把所有的代码整合在一起，完成此次任务。

因此，下面我主要介绍的是 “《口算大作战 2》DLC：算法真奇妙 ” 这个部分的具体细节

首先，我要大声的说：一个好的算法是真的很厉害！！！逆波兰大法好！！！算法真奇妙！！！（ps：至于具体为什么，等下我就吐槽一下我编码时的辛酸史）
首先，我和我的队友需要攻克逆波兰表达式的实现方法，以及背后的逻辑
为此我设计了两个类，一个是不断出题并把题目喂给四则运算类，另一个是四则运算类，其中使用了逆波兰和调度场算法来解决四则运算的问题。（我也说一下我们整个程序所用到的类：共有九个类，三年级模块两个类，一二年级四个类，一个运算父类，一个主方法，一个输出类）

设计类图如下：

在本次设计中，遇到了一个关键的问题，就是中缀表达式如何转后缀表达式，以及逆波兰算法。在这个地方，我觉得没有什么比两张张动态图更能理清思路了，通过这两张图片，以及博客说明，我理清了逆波兰和调度场的大致思路。图片转自算法表达式求值--逆波兰算法介绍：

调度场是用栈的方式来存储遍历的题目结果，并且以特定的规则弹栈和压栈。首先要有两个栈，一个是临时栈，一个是用来存储后缀表达式的栈。然后遍历题目，当为数字时，直接压入后缀栈，遇到符号时，左括号直接进栈，加减乘除要和临时栈顶比较优先级，和是否同级，如果优先级高直接压入临时栈，如果是同级或者优先级低，则临时栈要弹出栈顶--并把栈顶放入后缀栈，以此循环，直到准备进入的符号优先级比栈顶高（此处要注意空栈的情况）。当遇到右括号是，右括号直接抛弃，临时栈开始弹栈--并压入后缀栈，直到临时栈的栈顶为左括号，然后将左括号抛弃

2. 实现方案

准备工作：先在Github上创建仓库，克隆到本地，在本地新建Pair_211614331_211614354文件夹，在eclipes中创建工程
技术关键点：
- 逆波兰算法的实现（理解，外加各种空栈异常判断）
- 随机出题目的逻辑，以及加括号时的逻辑判断

四、引擎模块

写在前面的小花絮：

在一开始，我并没有打算使用调度场和逆波兰算法，我有点想自己尝试着写出四则运算的解决办法。于是我开始了异常艰难的旅程。可以说编码的一大半时间都放在了这里。在当时，我的想法是，既然四则运算，括号优先级最高，那么我是不是可以先遍历题目，找到最里面的一个括号，再调用函数把括号里的值算出来，得到结果后，返回个题目，然后继续遍历，寻找括号。

沿着这个思路，我就建立了两个类，一个是找呀找呀找括号的类，一个是复制运算不带括号的四则运算类。经过长时间的编码和除bug，我的程序是可以跑起来的，可以正常解题！！！当时还是有点小激动的。这份喜悦直到我开始大量的出题目时被彻底浇灭了，我的这套解题程序，遇到几个题目还好，当遇到了大量题目时，根本反应不过来，处理速度极慢，尤其是到了四百多题的时候，变的越来越慢，越来越慢，最后就是几秒钟才弹出题目和答案......然后我就迷茫了，这时我去看了室友的解决办法，他使用的是调度场和逆波兰， 哇！真的不敢想象，题目就那样刷的一下，连同答案一起跳出来了！！！这也太快了吧，我的算法是个什么垃圾......

然后我才乖乖的开始学习逆波兰和调度场，学习效率比我快十几倍的算法。所以说，还是那句话：算法真奇妙！！！

1. 调试日志

记录编码调试的日志，请记录下开发过程中的 debug 历程

在使用调度场算法编码的过程中，主要遇到的还是在入栈符号优先级更低，和同级情况下，临时栈弹出后，循环判断时，容易出现空栈的情况。
- 这个问题我一开始也是没有头绪的，就想到一个，使用do-while进行循环判断，但是一直卡在了循环跳出时的判断，因为跳出时判断有多重情况，一个是弹玩就是空栈，一个是栈顶还是优先级大于等于入栈元素。后来我在do-while语句中间，加了一个判断是否为空的语句，当空就直接break循环,才解决的
还有一个问题就是，括号出现的问题，这里我暂时采用的是定位随机的办法，即我事先规定了十多种括号的出现情况，把他们分别存储在字符串中（取名为括号标准定位码），然后用随机的办法，选择一种括号情况，放入事先出好的题目中。这种办法，并没有真正的随机出现括号，但是因为我不带括号的题目是随机生成的，题目各不相同，因此，在一定情况下，也可以看作是随机生成的带括号的四则运算式子。

2. 关键代码

请展示一段程序的关键代码，并解释代码的作用

switch (order) {

				case 1:{

					positionCode="(---)-(---)";    //定位码的几种情况，随机选定后，扫描定位码，发现括号则加入；

					break;        //一部分情况

				}

				case 2:{

					positionCode="--(---)-(---)";

					break;

				}

				case 3:{

					positionCode="--((---)--)";

					break;

				}

				case 4:{

					positionCode="--((---)-(---))";

					break;

				}

				case 5:{

					positionCode="(-----)";

程序产生括号的代码确实不够优雅，但也能临时解决问题，同时其实是可以不用扫描定位码的，可以换一种形式，比如直接存左右括号的位置，这样加入集合也更加迅速。当然，还有真正正牌的随机办法，但我没有想到......

if(!shortStack.isEmpty()) {

					 if(shortStack.peek().matches("[\\+\\-\\*\\/]")) {	// 栈顶为同级或加减

						 do {

							 postFixStack.push(shortStack.pop());//栈顶和入栈的同级，或级别更高

							 if(shortStack.isEmpty())//判断弹玩是否变空

								 break;//弹玩后，变空

						 }while(shortStack.peek().matches("[\\+\\-\\*\\/]") );//栈顶还是这些时

						 shortStack.push(partNumber);	// 把当前元素入栈

					 }

					 else

						 shortStack.push(partNumber);	// 栈顶就是括号的时候，把当前元素入栈

				}

				else

					shortStack.push(partNumber); //是空直接压栈

中缀转后置表达式很大一部分的报错都是因为弹的是空栈，所以理清楚这个，就算是完成了一大步了。

3. 代码规范

请给出本次实验使用的代码规范：

第一条：代码中的命名均不能以下划线或美元符号开始，也不以一下划线或美元符号结束
第二条：代码中的命名严禁使用拼音与英文混合的方式，更不允许直接使用中文的方式
第三条：类名使用UpperCamelCase风格
第四条：方法名、参数名、成员变量、局部变量都统一使用 lowerCamelCase 风格
第五条：杜绝完全不规范的缩写，避免忘文不知义，都以英文单词命名
第六条：采用4个空格缩进，禁止使用tab字符
第七条：不同逻辑、不同语义、不同业务的代码之间插入一个空行分割开来以提升可读性。

4.结对编程

在结对编程中我们在有明确的分工，才尽可能的保证了项目的进度。
同时我们也相互讨论各自所遇到的问题，一开始没有头绪，但双方讨论后，可能就会瞬间想到思路

五、BUG调试

请思考并记录你认为必要的测试点，并记录测试用例与测试结果

六、开发者有话说

好的算法尤其重要，它更轻量也更加高效，在完成我负责的部分里，我们两个都认识到了算法的重要性，真的不一样！！！
同时，当有还要有团队合作的能力，要学会与队友沟通和交流，有时候，思路就是在交流中闪现的，一个人想不到，几个人就会有不一样的思路，俗话说的好，三个臭皮匠，顶个诸葛亮。
当项目越来越大的时候，一个人就很难在规定的时间内完成任务，也就是说，我们在今后一定会经常遇到与他人合作的情况。很大一部分情况中1+1>2，所以在团队中，尽力去做，效果也会翻倍！！！
当然，在沟通时，也要有耐心，同时要想办法把自己的想法表达出来，这点我还是需要学习的。