真·小学出题器设计报告

一、预估与实际

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

二、需求分析

我通过百度的方式了解到，小学一年级数学和二年级有如下的几个特点：

特点1：小学数学一年级上学期学习20以内的加减。
特点2：小学数学一年级下学期学习20以上的加减。
特点3：小学数学一年级学习顺数，倒数，单数，双数。
特点4：小学数学一年级学习比较大小和第几。
特点5：小学数学二年级学习九九乘法表。
特点6：小学数学一年级学习不借位的除法。
特点7：小学数学一年级学习除法的余数。

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

加减时使用的数字小于100。
100以内的减法不能出现负数，即被减数小于减数。
乘除时使用的数字小于10。
100以内的除法不能出现分数，即被除数小于除数。
除法时候除数被除数不能为0。

三、设计

1. 设计思路

说明你如何设计这个程序

设计一个一年级的出题类和二年级的出题类，以及一个取余数的方法，和一个选择年级的方法。
算法的关键的关键是随机生成限制内的数，以及随机的加减乘除。
判断随机数是否为0，被减数要大于减数，被除数也要大于除数。

2. 实现方案

写出具体实现的步骤

准备工作：先在Github上创建仓库，克隆到本地。
技术关键点：梳理一下设计思路，如何解决余数的显示以及筛选随机数的限制。
先解决一年级的出题库，在根据一年级的代码改成二年级的乘除的出题库。

四、编码

根据设计思路开始，先写出一年级的出题库，设置静态私有变量。对x和y的进行随机数的赋值。然后输出题目以及将题目和答案保存到数组里面输出来。最后将这些输入到文本里，并保存到电脑上。最后在将一年级提出来设计成类，根据一年级的代码方式形成二年级的代码方式。

1. 调试日志

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

比如：

在设计余数类的时候，（x%y==y）时输出出错，整出依旧显示余数0，例如8/1=1...0。解决方法将（x%y==y）判断改成(x%y) == 0。
在choiceGrade(i, g)在输出文件代码上面，这样就无法保存到文件中输出出来。解决方法将choiceGrade(i, g);放在输出文件代码下方。

2. 关键代码

    for (int i = 0; i < n; i++) {
    //随机10以内的X和y,并且生成一个0到1子内的f。
        x = new Random().nextInt(10) + 1;
        y = new Random().nextInt(10) + 1;
        f = (int)(Math.random()*2);
        //判断 f是否为0，0为加法。以及x和y不等于0。
        if ( f == 0 && y!=0 && x!=0) {
            System.out.println("(" + (i+1) + ")" +" " + x + "*" + y + " " + "=" + " ");
            str[i] = "(" + (i+1) + ")" +" " + x + "*" + y + " " + "=" + " " + (x*y);
        }
        else {
        //判断被除数小于除数。如果小于交换位置。
            if (x-y < 0 ) {
                System.out.println("(" + (i+1) + ")" +" " + y + "/" + x + " " + "=" + " ");
                str[i] = "(" + (i+1) + ")" +" " + y + "/" + x + " " + "=" + " " + (y/x) + judgementRemainder(y,x);//judgementRemainder(y,x)是一个判断余数的类
            }
            else {
                System.out.println("(" + (i+1) + ")" +" " + x + "/" + y + " " + "=" + " ");
                str[i] = "(" + (i+1) + ")" +" " + x + "/" + y + " " + "=" + " " + (x/y) + judgementRemainder(x,y);
            }
        }
    }

3. 代码规范

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

第一条代码中的命名均不能以下划线或美元符号开始，也不能一下划线或美元符号结束。
第二条代码中的命名严禁使用拼音与英文混合的方式，更不允许直接使用中文的方式。
第三条杜绝完全不规范的缩写，避免忘文不知义。
第四条为了达到代码自己自解释的目标，任何自定义编程元素在命名时，使用精良完整的单词组合来表达其意。但是有些名称实在过于长，这个可以适当的缩写，不要忘文不知义就可以。
第五条代码中的命名严禁使用拼音与英文混合的方式，更不允许直接使用中文的方式。

五、测试

输入5 2 预计显示5道二年级题目
输入5 1预计显示5道一年级题目
输入超过2以上年级是显示其他

六、总结

第一次设计小的软件，看似不是很难。但实则考虑的东西太多了。作为一个程序开发人员的角度上，要将程序设计得简洁，高效。作为一个用户角度上来看应该要注重软件的使用是否方便。
在代码的使用中要严格按照代码规范进行编写。

出题器