MathExam小学一二年级计算题生成器v1.0

一、预估与实际

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

二、需求分析

我通过在网络搜索的方式了解到，小学一年级数学有如下的几个特点：

• 特点1：一年级数学只有加减法。
• 特点2：只有三位数以下的加减。
• 特点3：得出的结果不能为负数，因此当式子为减法式子时，前面的数字要小雨后面的数字。
• 特点4：二年级数学有加减乘除。
• 特点5：二年级数学有余数。
• 特点6：二年级数学除法的除数只有个位数。

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

• 使用的数字应为[0,100)
• 除数的数字应[1,10)

三、设计

1. 设计思路

• 根据题目要求，最终需要写入文本out.txt中，因此要先创建文本。
• 数字需要随机得出，因此需要简历随机数。
• 随机出来的式子需要写入文本，因此需要多个数组进行存储。
• 答案需要的格式为“等式+答案”，并且还需要判断符号以及是否有余数，所以需要if{} else if{}进行判断。
  需要写入文本out.txt，所以需要BufferedWriter( )和循环，将数组里的数据一 一写入文本中。
• 文本末尾需显示当前时间，因此创建Date，提取当前系统时间。

2. 实现方案

• 准备工作：先在Github上创建仓库，克隆到本地...

• 技术关键点：
  • 数组会越界，从而导致程序无法正常运行，因此循环时需要注意循环体是否达到要求，是否有问题。
  • 使用随机数Random( )时，需要注意随机数生成范围，比如除数的范围只有【1-9】
  • 当式子为减法时，减数要等于或小于被减数。
  • 使用 BufferedWriter( )将存入数组的数据一一输入文本 out.txt 里面。
  • 使用正则表达式、Pattern、Matcher判断输入参数是否达标，不达标则提示重新输入，并给予格式。
  • 使用 DateFormat( )获取系统当前时间。

四、编码

请说明你如何按照设计思路进行编码，并记录你在开发中遇到的问题，与解决过程

1. 调试日志

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

• 在for循环中，存放数据的数组因为循环体出错，反复循环多次，导致越界，是程序无法正常运行。最后通过system.out.println打印出数组，判断出循环问题。
• 在写入正则表达式之后，关于Boolean的判定，一开始使用的是 matcher.find()，后来发现只要数据带有相关的数字就会通过检验，因此改换成matcher.matches() ，成功将参数范围以及类型进行限定。
• 当参数只写入一个的时候，程序出现问题，使用args.length判断输入参数的长度，再传参时，如果args.length==1则默认年级为1年级。

2. 关键代码

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

• 通过main函数中String[] args的参数，进行正则表达式的判断，最后传入create（）方法内。
• count表示要生成的题数，grade表示对应的年级。
• 使用random（）随机生成数字。

public static void create(int count,int grade) {       Date date = new Date();    DateFormat dt = DateFormat.getDateTimeInstance();    dt.format(date);        File file = new File ("out.txt");//创建文本    FileWriter fw=null;        try {            fw = new FileWriter(file);                } catch (IOException e) {            // TODO 自动生成的 catch 块            e.printStackTrace();        }           BufferedWriter bw = new BufferedWriter(fw);    int first=0,symbol=0,second=0,mark=0,w=0;    int [] an=new int[count];//创建数组，用于存储数据，存储答案。    int [] bn=new int[count];//存储第一个数字，式子的第一个数；    int [] cn=new int[count];//存储第二个数字，用于判断符号；    int [] dn=new int[count];//存储第三个数字，式子的第二个数    int [] en=new int[count];//存储余数；    Random r =new Random();     while(w 

3. 代码规范

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

• 第一条：代码中的变量名不能以下划线开始也不能以下划线结束。
• 第二条：代码中的命名严禁使用拼音与英文混合，更不许使用中文命名。
• 第三条：常量命名全部大写，单词键用下划线隔开，力求语义表达完整，不要嫌名字长。
• 第四条：类型与中括号紧挨相连来定义数组。
• 第五条：杜绝完全不规范的缩写，避免忘文不知义。
• 第六条：第四条：不要使用一个常量类维护所有常量，按常量功能进行归类，分开维护。并人工检查代码是否符合规范

五、测试

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

参数个数	测试用例	结果
一个参数	java MathExam6360 10	运行正常
	java MathExam6360 0	提示错误，需重新输入
	java MathExam6360 00001	提示错误，需重新输入
	java MathExam6360 a	提示错误，需重新输入
	java MathExam6360 10000	提示错误，需重新输入
	java MathExam6360 -1	提示错误，需重新输入
	java MathExam6360 0.1	提示错误，需重新输入
2个参数	java MathExam6360 10 2	运行正常
	java MathExam6360 10 20	提示错误，需重新输入
	java MathExam6360 10 a	提示错误，需重新输入
	java MathExam6301 d 2	提示错误，需重新输入
	java MathExam6301 0001 2	提示错误，需重新输入
	java MathExam6301 100 0.1	提示错误，需重新输入
	java MathExam6360 10	运行正常

六、总结

请总结过程中的教训和经验，思考

• 在写代码的过程中，每功课一次目标，其实内心是很欢喜的，因为这代表着我在攻克这目标之前所用的时间都得到了相应的回报，我的水平并不高，因此可能功课每一步的时间花费的比其他人都要长，不过我也确实在这次的过程中学到了一些东西，严格来说其实不算是学到，而是把上学期所学过的，所用过的进行了一次巩固。当然水平不足的我少不了翻看曾经的PPT、作业以及上网查询某一些函数的用法。
• 由于水平不足，其实我的代码有着冗余，还是在同学的指导下，发现了其中一些代码冗余的地方。而且刚开始决定敲代码时，并没有程序进行相应规划以及设计，属于想到什么就写什么，因此遇到了问题时，总是手忙脚乱的找错误。倒是养出了给代码注释的习惯，方便之后出错可以迅速查找。
• 相比于其他人，我确实是自愧不如，敲代码的时间四五天有余，虽然最后敲出来了成果，但是却依然比不得其他同学，还有许多需要改进的地方。使用正则表达式限制了输入参数的类型以及范围，最开始使用的matcher.find（）的boolean判断，却总能被判断正确，即使输入参数不对。之后再同学的建议下修改成matcher.matche（）的boolean判断，总算成功限定了参数类型和范围。
• 这一次的作业，让我受益良多，即使代码看多了脑壳会疼，不过在完成目标后，那种可以令人上瘾的感觉，实在是欲罢不能，这或许是我坚持那么久去推敲代码的动力吧。