软件工程结对第二次作业
项目描述
我们在刚开始上课的时候介绍过一个小学四则运算自动生成程序的例子，请实现它，要求：
能够自动生成四则运算练习题
可以定制题目数量
用户可以选择运算符
用户设置最大数（如十以内、百以内等）
用户选择是否有括号、是否有小数
用户选择输出方式（如输出到文件、打印机等）
最好能提供图形用户界面（根据自己能力选做，以完成上述功能为主）
项目分工
驾驶员：孙虎 博客地址
领航员: 王禹涵
代码审查表
|
重要性 |
激活 |
级别 |
检查项 |
|
总计 |
|||
|
命名 |
|||
|
重要 |
N |
20 |
命名规则是否与所采用的规范保持一致？ |
| N |
20 |
是否遵循了最小长度最多信息原则？ |
|
|
重要 |
N |
50 |
has/can/is前缀的函数是否返回布尔型？ |
|
注释 |
|||
|
重要 |
Y |
10 |
注释是否较清晰且必要？ |
|
重要 |
Y |
10 |
复杂的分支流程是否已经被注释？ |
| N |
10 |
距离较远的}是否已经被注释？ |
|
| N |
10 |
非通用变量是否全部被注释？ |
|
|
重要 | N |
10 |
函数是否已经有文档注释？（功能、输入、返回及其他可选） |
| N |
10 |
特殊用法是否被注释？ |
|
|
声明、空白、缩进 |
|||
| N |
20 |
每行是否只声明了一个变量？（特别是那些可能出错的类型） |
|
|
重要 |
N |
40 |
变量是否已经在定义的同时初始化？ |
|
重要 |
Y |
10 |
类属性是否都执行了初始化？ |
|
Y |
20 |
代码段落是否被合适地以空行分隔？ |
|
|
Y |
20 |
是否合理地使用了空格使程序更清晰？ |
|
|
Y |
20 |
代码行长度是否在要求之内？ |
|
|
Y |
20 |
折行是否恰当？ |
|
|
语句/功能分布/规模 |
|||
|
Y |
20 |
包含复合语句的{}是否成对出现并符合规范？ |
|
|
Y |
20 |
是否给单个的循环、条件语句也加了{}？ |
|
|
Y |
20 |
if/if-else/if-else if-else/do-while/switch-case语句的格式是否符合规范？ |
|
|
Y |
20 |
单个变量是否只做单个用途？ |
|
|
重要 |
Y |
10 |
单行是否只有单个功能？（不要使用；进行多行合并） |
|
重要 |
Y |
10 |
单个函数是否执行了单个功能并与其命名相符？ |
|
Y |
20 |
操作符＋＋和— —操作符的应用是否复合规范？ |
|
|
规模 |
|||
|
重要 |
Y |
10 |
单个函数不超过规定行数？ |
|
重要 |
Y |
10 |
缩进层数是否不超过规定？ |
|
重要 |
Y |
10 |
是否已经消除了所有警告？ |
|
重要 |
Y |
40 |
常数变量是否声明为final？ |
|
重要 |
Y |
10 |
对象使用前是否进行了检查？ |
|
重要 |
Y |
10 |
局部对象变量使用后是否被复位为NULL？ |
|
重要 |
Y |
10 |
对数组的访问是否是安全的？（合法的index取值为[0, MAX_SIZE-1]）。 |
|
重要 |
Y |
10 |
是否确认没有同名变量局部重复定义问题? |
|
Y |
20 |
程序中是否只使用了简单的表达式？ |
|
|
重要 |
Y |
20 |
是否已经用（）使操作符优先级明确化？ |
|
重要 |
Y |
20 |
所有判断是否都使用了（常量==变量）的形式？ |
| N |
80 |
是否消除了流程悬挂？ |
|
|
重要 |
N |
80 |
是否每个if-else if-else语句都有最后一个else以确保处理了全集？ |
|
重要 |
N |
80 |
是否每个switch-case语句都有最后一个default以确保处理了全集？ |
|
Y |
20 |
for循环是否都使用了包含下限不包含上限的形式？（k=0; k<MAX） |
|
|
重要 |
N |
40 |
XML标记书写是否完整，字符串的拼写是否正确? |
| N |
40 |
对于流操作代码的异常捕获是否有finally操作以关闭流对象? |
|
|
Y |
20 |
退出代码段时是否对临时对象做了释放处理? |
|
|
重要 |
N |
40 |
对浮点数值的相等判断是否是恰当的？（严禁使用==直接判断） |
|
可靠性（函数） |
|||
|
重要 | N |
20 |
入口对象是否都被进行了判断不为空？ |
|
重要 |
Y |
60 |
入口数据的合法范围是否都被进行了判断？(尤其是数组) |
|
重要 |
Y |
20 |
是否对有异常抛出的方法都执行了try...catch保护？ |
|
重要 |
Y |
80 |
是否函数的所有分支都有返回值？ |
|
重要 |
N |
50 |
int的返回值是否合理？（负值为失败，非负值成功） |
| N |
20 |
对于反复进行了int返回值判断是否定义了函数来处理？ |
|
|
Y |
20 |
关键代码是否做了捕获异常处理? |
|
|
重要 |
N |
60 |
是否确保函数返回CORBA对象的任何一个属性都不能为null? |
|
重要 |
N |
60 |
是否对方法返回值对象做了null检查，该返回值定义时是否被初始化? |
|
重要 |
N |
60 |
是否对同步对象的遍历访问做了代码同步? |
|
重要 |
N |
80 |
是否确认在对Map对象使用迭代遍历过程中没有做增减元素操作？ |
|
重要 |
Y |
20 |
线程处理函数循环内部是否有异常捕获处理，防止线程抛出异常而退出? |
| N |
20 |
原子操作代码异常中断，使用的相关外部变量是否恢复先前状态? |
|
|
重要 |
Y |
20 |
函数对错误的处理是恰当的？ |
|
可维护性 |
|||
|
重要 |
Y |
20 |
实现代码中是否消除了直接常量？（用于计数起点的简单常数例外） |
|
Y |
20 |
是否消除了导致结构模糊的连续赋值？（如a= (b=d+c )） |
|
| N |
20 |
是否每个return前都要有日志记录? |
|
| N |
20 |
是否有冗余判断语句？（如：if (b) return true; else return false;） |
|
| N |
20 |
是否把方法中的重复代码抽象成私有函数? |
import org.junit.Assert;
import org.junit.Test;
import static org.junit.Assert.*;
public class CalTest {
@Test
public void createBasic0() throws Exception {
int[] checkall={1,1,1,10,50,1};
Assert.assertArrayEquals(checkall,Cal.createBasic(1,1,1,10,50,1));
}
@Test
public void createBasic1() throws Exception {
int[] checkall={1,1,1,10,50,1};
Assert.assertArrayEquals(checkall,Cal.createBasic(1,1,1,10,50,1));
}
@Test
public void createBasic2() throws Exception {
int[] checkall={1,0,1,10,50,1};
Assert.assertArrayEquals(checkall,Cal.createBasic(1,0,1,10,50,1));
}
@Test
public void createBasic3() throws Exception {
int[] checkall={1,1,0,10,50,1};
Assert.assertArrayEquals(checkall,Cal.createBasic(1,1,0,10,50,1));
}
@Test
public void createBasic4() throws Exception {
int[] checkall={1,1,1,10,50,0};
Assert.assertArrayEquals(checkall,Cal.createBasic(1,1,1,10,50,0));
}
}
测试结果截图
##项目总结
本次四则运算生成算法是我和孙虎同学第一次真正意义上的合作项目，孙虎同学的代码写的很好，能够满足程序基本要求，但是在注释和命名方面
做的不好，代码不易理解，变量的命名只是随便的使用英文字母，这个项目使用的字母比较多，我写测试用例是经常忘掉哪个字母代表的含义。
合作过程中我们互相给了对方不少帮助，我对java不太熟悉，孙虎同学为我写测试代码提供了很多帮助，我也找出了一些代码中的bug，两个人合
作的确比一个人来的更加有效率。代码中还有一些未实现的部分，比如图形用户界面我们并没有做出来，我们两个都有责任，五一放假玩的比较欢，
学习用时间比较少。
这次作为领航员我的工作量相对较小，主要是提一些建议以及进行测试，但是收获颇多，刚开始写测试用例的时候我想的是这是随机生成的数学算
式，不可能有预期值，我一度陷入了迷茫中，这时同伴建议我不用考虑结果，从过程中进行测试，我想到了在函数调用的时候立flag的测试方法并
加以实现，思维定势害人啊，陷入僵局时同伴的提醒的确是至关重要。
