软件工程第三次作业评分

一、作业内容

解不同阶的数独

二、对一些问题做说明:

1.主函数参数argc和argv
在命令行输入 Sudoku.exe -m 9 -n 1 -i input1.txt -o output1.txt 时,主函数的参数中,argc表明了字符串个数,argv是字符串数组;在给程序中的变量(盘面数目、阶数、文件名)赋值前,应该先判断标志是什么,比如在argv中扫描到"-i"时,才知道后面紧跟的是输入文件名。
①这样的话,无论助教测试时以怎样的顺序给出参数,程序都可以处理。比如使用 Sudoku.exe -i input1.txt -o output1.tx -n 1 -m 9
②这样还可以使用缺省值。比如,规定在不使用"-m"选项时,程序默认数独的阶数为9。此时的命令行是 Sudoku.exe -i input1.txt -o output1.tx -n 1


2.文件读写
打开或者创建文件时应该使用命令行指定的文件名。不应将文件名固定为“input.txt”(这样的话,输入给的参数就没有使用到),实际上助教在测试时使用的是其他名字的文件;也不应在函数内指定文件的路径,一般助教测试时,目录结构和你的不同;助教测试时,既可以使用绝对路径指定文件,也可以使用相对路径。


3.单元测试
本次作业中这个部分扣分比较多。有的同学贴出了程序的执行结果和参考输出,有的输出了运行过程中的变量或者提示,这些不满足单元测试。还没来得及了解的再阅读现代软件工程讲义 2 开发技术 - 单元测试 & 回归测试并搜索相关资料,结对编程依然有这个部分。从链接中截取了一部分信息:

解释单元测试的结构
从上面这个例子可以看到创建单元测试函数的主要步骤:
(1)设置数据(一个假想的正确的E-mail地址);
(2)使用被测试类型的功能(用E-mail地址来创建一个User类的实体);
(3)比较实际结果和预期的结果(Assert.IsTrue(target!= null);)。


>**好的单元测试的标准** (1)单元测试应该在最低的功能/参数上验证程序的正确性。 …… (7)单元测试应该覆盖所有代码路径,包括错误处理路径,为了保证单元测试的代码覆盖率,单元测试必须测试公开的和私有的函数/方法。 ……

上面的第一点要求程序合理地设计模块接口,如果程序只有一个主函数,就无法达到这一点。

三、评分标准

博客评分标准(45'+10')

  1. 在文章开头给出你的仓库的Github项目地址(1')

  2. 在开始实现程序之前,在下述PSP表格记录下你估计将在程序的各个模块的开发上耗费的时间(3');在你实现完程序之后,记录下你在程序的各个模块上实际花费的时间(2')

  3. 计算模块接口的设计与实现过程。 设计包括代码如何组织,比如会有几个类,几个函数,他们之间关系如何,关键函数是否需要画出流程图?说明你的算法的关键(不必列出源代码),以及独到之处。 (20')
    • 代码组织:类,函数及关系(5'):简单罗列函数(2'),类图+简要功能说明;(5')
    • 算法关键说明(12'):简单说明(6'),举例讲解、画图说明、流程图说明,提出注意事项;关键点说明等(7'-12')。如果使用的是回溯法,在什么时候得到解?在什么时候停止回溯?
    • 独到之处(3'):比如说程序可以解决多解,原理是xxx。

  4. 计算模块接口部分的性能改进。 记录在改进计算模块性能上所花费的时间,描述你改进的思路。(5')
    • 改进的思路(4')
    • 改进效果(1'):试想的改进实际上有效果吗?需要改进前后的性能分析图对比
    • 只有一张性能分析图不加说明不得分

  5. 计算模块部分单元测试展示。 展示出项目部分单元测试代码,并说明测试的函数,构造测试数据的思路;测试数据有覆盖到所有的代码吗?并将单元测试得到的测试结果,发表在博客中。 (10')
    • 测试代码(3')
    • 说明测试函数,测试数据的构造思路(4')
    • 测试结果(3')

  6. 计算模块部分异常处理说明。 在博客中详细介绍每种异常的设计目标。每种异常都要选择一个单元测试样例发布在博客中,并指明错误对应的场景。(4')
    • 设计目标,对应的场景(2')
    • 相应的单元测试代码,样例(2')

  7. Code Quality Analysis工具的分析结果贴图以及你的说明。(3')
    • 贴图证明消除所有警告(1')
    • 说明遇到哪些警告,为什么警告,如何解决(2')
    • 或者遇到的其他问题以及解决

  8. 完成三宫格之上的更高阶级,并在以上各个条目体现出来。(7')
    • 处理三阶之上用到了什么的额外函数?
    • 宫如何处理?宫的大小不一如何处理?
    • 三阶之上的如何测试:测试函数、测试数据、测试结果

程序评分标准(25'+20')

说明:在本次作业描述中,两个数字之间是1个空格,但是发布了2个空格的样例。在本次作业自动化测试中,进行了两种规格样例的测试,得分取两种测试中高的那一个。感谢助教@衡与墨额外进行了二次测试。程序测试详情

  1. 三宫格测评(25')
  2. 之后的阶级每完成一个(3'),其余六个阶级全部完成(20')

四、作业得分详情

博客+程序总分

五、第三次作业得分排行

六、千帆竞发图

七、作业推荐

这篇作业讲解到位,有一个视频:
【2019.09.19】数独(Sudoku)游戏之我见(软工实践第三次作业)

这篇作业的性能分析到位,结合排除法和回溯法,有前后的分析比较,可以作为参考:
软件工程实践2019第三次作业

这篇作业提到了排除、回溯之外的方法,有时间可以学习:
软件工程实践2019第三次作业

八、总结

作业中要求自学的内容比较多,第五次作业结对编程也是这样;请参照评分标准,尽力完成每一个得分点。

原文地址:https://www.cnblogs.com/kofyou/p/11619585.html