结对项目博客

一、项目地址：

URL测试地址：http://47.93.197.5:8080/RCalculator/index.jsp

coding.net仓库地址：https://git.coding.net/aspirinone/RCalculator.git

结对伙伴：甘彩娈

二、预计各模块开发时间（PSP）

PSP	任务内容	计划时间（min）	完成时间（min）
Planning	计划	60	120
Estimate	估计这个任务需要多少时间，并规划大致工作步骤	60	120
Development	开发	2880	2880
Analysis	需求分析	60	60
Design Spec	生成文档	30	30
Design Review	设计复审	150	150
Coding Standard	代码规范	150	150
Design	具体设计	200	200
Coding	具体编码	1800	1800
Code Review	代码复审	370	370
Test	测试	120	120
Reporting	报告	180	180
Test Report	测试报告	120	120
Size Measurement	计算工作量	20	20
Postmortem & Process Improvement Plan	事后总结, 并提出过程改进计划	40	40

三、接口设计

通过看书和查阅资料，我学习到：

信息隐藏（Information Hiding）：信息隐藏指在设计和确定模块时，使得一个模块内包含的特定信息（过程或数据），对于不需要这些信息的其他模块来说，是不可访问的。为什么要隐藏？一是为了隐藏复杂度，这样你就不用再去应付他，除非你要特别关注的时候；二是为了隐藏变化源，这样当变化发生时，其影响就能被限制在局部范围内。复杂度的根源包括复杂的数据类型、文件结构等。

接口设计(Interface Design)：接口，在JAVA编程语言中是一个抽象类型，是抽象方法的集合，接口通常以interface来声明。一个类通过继承接口的方式，从而来继承接口的抽象方法。

接口设计需要考虑哪些方面：1.接口的命名 2.请求参数 3.支持的协议 4.TPS、并发数、响应时长 5.数据存储、DB选型、缓存选型 6.是否需要依赖于第三方 7.接口是否拆分 8.接口是否需要幂等 9.防刷 10.接口限流、降级 11.负载均衡器支持 12.如何部署 13.是否需要服务治理 14.是否存在单点 15.接口是否用资源包、预加载还是内置 16.是否需要本地缓存 17.是否需要分布式缓存、缓存穿透怎么办 18.是否需要白名单

松耦合（Loose Coupling）：很多复杂问题的解决都是通过增加中间层来实现的。系统集成、点对点的对接，系统间相互的依赖性太大，增加一个中间层实现松耦合性。开发语言上，想让对象与对象间松耦合，通过增加抽象类或者接口来做到。松耦合的目标是最小化依赖，但要付出使系统更加复杂的代价。

松耦合架构：

四、类与函数

类：

Command.java(核心）：用于命令行测试生成运算式。

MakeText.java 和 ResultComeOut.java 相互调用用于生成符合的运算式，主要用于两个地方，命令行测试和实际网页生成运算式。

GetAnswer.java：生成算式答案。

函数：

Command.java中用到的函数：主函数（用于分析输入的参数），并调用了MakeText.java 和ResultComeOut.java

MakeText.java中用到的函数：

private static String doText( int lower , int upper , int operatorCount , String isMultiply , String isBracket) 通过参数解析、Random类形成随机数以及随机运算符形成符合参数要求的运算式的验证，并且调用ResultComeOut.java的方法判断运算式是否符合要求。

creat ( int expressionNum , int lower , int upper , int operatorCount , String isMultiply, String isBracket) 把创建的打印输出流赋给系统。

public static int [ ] index ( int n , int m )

ResultComeOut.java中用到的函数：

public int jisuan ( String ex , int lower , int upper ) 运用调度场算法和逆波兰表达式，用栈进行运算。

int calculate ( int a , int b , String tmp , int lower ,int upper ) 处理加减运算并排除与题目条件不符的式子。

五、接口部分的性能改进与性能分析图

记录了在改进计算模块性能上所花费的时间，简化代码的冗杂度，尽量模块化处理，其性能分析图如下：

六、单元测试及测试覆盖率截图

为了充分测试ResultComeOut.java，使用单元测试Test_ResultComeOut.java:

七、异常处理说明

前端部分：

限定只能输入正整数：判断是否符合正则表达式 ^d+$ 。如果不符合，则报错。

限定只能输入小于10000的正整数：判断是否符合正则表达式 ^(?!00)(?:[0-9]{1,3}|1000)$ 。如果不符合，则报错。

默认是否包含乘除号和括号为否：<input type="radio" cheked="">，目的是为了防止空指针异常。

$("#num1").blur(function(){
        var reg = /^(?!00)(?:[0-9]{1,3}|1000)$/;
        var regExp = new RegExp(reg);
        if(!regExp.test(this.value)||this.value==""){
            var tip = "*小于1万的正整数";
            $("#a").html(tip);
        }
        else{
            $("#a").html("");
        }
    })

后端部分：

在 MakeText.java 部分需要将生成的运算式打印成.txt文件：

try {
                    PrintStream ps = new PrintStream("result.txt","UTF-8");
                    System.setOut(ps);
                    ArrayList<String> ex = mt.create(n, lower, upper, o, c, b);
                    for(String es:ex){
                        System.out.println(es);
                    }
 
                     
                } catch (Exception e) {
                    // TODO: handle exception
                    System.out.println("File Error!");
                }

在Command.java中有大量的异常处理，提示参数不合法问题，具体形式以System.out.println(问题内容)呈现。　

if (args[i].equals("-n")) {
                ifn = true;
                try {
                    n = Integer.parseInt(args[i + 1]);
                } catch (Exception e) {
                    // TODO: handle exception
                    System.out.println("Please input interger betweeen 1 and 10000");
                }
 
                if (n <= 0 || n > 10000) {
                    ifrun = false;
                    System.out.println("Please input interger betweeen 1 and 10000");
                }
                if(i < args.length-1){
                    i++;
                    }else{
                        System.out.println("after -n you need to input a interger, please try again");
                    }
            }

八、界面模块的详细设计过程：

项目含六个页面index.jsp、 problem.jsp、zuoti.jsp、grade.jsp、bgrade.jsp和login.jsp；所有页面均实现了多语言环境，可以中英文切换。index.html用于定制题目，并生成题目的txt文件，problem.html使用用户上传的文件，在页面上做题，给出答题时间与答题正确题数。index.jsp用于定制题目，可跳转至zuoti.jsp进行答题，用户可以看见答题时间与答题正确题数。problem.jsp使用用户上传的文件，在页面上做题，给出答题时间与答题正确题数。

1.前端页面组成

2.登陆/注册界面

3.首页：定制出题要求、上传计算文件

4.定制题目后出现答题界面

5.提交答案后用 js 局部刷新提示答题用时和正确率

判断正确率是通过对比用户答案的数组，与后台传到前台的答案数组对比，并显示出来。

6.点击右侧头像，出项“历史成绩”，可以显示所有用户的最好成绩

定时器的使用：

<script type="text/javascript">
    var c=0
    var t
    var r
    window.onload=timedCount()
    function timedCount()
    {
    document.getElementById('txt').value = c
    c=c+1
    t=setTimeout("timedCount()",1000)
    }
</script>

后端的界面设计：

九、界面模块与计算模块的对接

index.jsp：是用户输入参数与上传文档的界面。后台获取参数并运用 MakeText.java 中的doText() 解析参数，生成符合要求的式子后，用creat（）方法把创建的打印输出流赋给系统。

problem.jsp：是用户使用上传的文档显示题目，并答题的界面。使用GetAnswer.java 中的方法给出答案。前段将用户输入的值作为一个数组，与后台上传的答案数组进行比较，最后打印出用户做对的题目数量。

$("#show").click(function(){
        var txt=$("#txt").val();
        var answer=document.getElementByClassName("answer");
        var ture=document.getElementByClassName("ture");
        var but=document.getElementById("show")
        var yes=0;
        var no=0
        for(i=0;i<answer.length;i++){
            if(answer[i].value==ture[i].value){
                yes++;
            }
            else{
                no++;
            }
        }
        var txt1='<input style="border:none;outline:medium;box-shadow:0px 0px 0px;50px;">'+yes+'</input>';
        $("#myDiv").hide();
        $("#top").html('<p>您做题用时为'+txt+'秒<br>做对'+txt1+'题</p>');
    })

十一、结对编程的优缺点，结对成员评价

结对编程优点：

1.在合作的过程中如果遇到问题，两个人一起解决会提高效率，更快发现解决问题的方法。

2.结对编程中可以互相鼓励，互相督促，不容易产生懈怠。

3.结对编程中可以互相学习彼此擅长的地方，有利于自身代码水平的提高。

4.结对编程有助于及时的代码复审。

结对编程的缺点：

1.结对编程要求两个人都有时间，这对两个人的时间协调有一定要求。

对结对队友的评价：

彩娈宝宝在做项目过程中很积极，从不懈怠；我们经常交流，每次都能听得进彼此的意见，合作得非常愉快；她在分工时从不偷懒，也不推脱任务；她遇到困难的时候能积极地去寻找方法，而不是烦躁和抱怨，她很有正能量。至于缺点，实在是没什么缺点了。

十二、各模块实际所用时间（PSP）

PSP	任务内容	计划时间（min）	完成时间（min）
Planning	计划	60	120
Estimate	估计这个任务需要多少时间，并规划大致工作步骤	60	120
Development	开发	2880	3000
Analysis	需求分析	60	60
Design Spec	生成文档	30	30
Design Review	设计复审	150	150
Coding Standard	代码规范	150	150
Design	具体设计	200	200
Coding	具体编码	1800	1920
Code Review	代码复审	370	370
Test	测试	120	120
Reporting	报告	180	180
Test Report	测试报告	120	120
Size Measurement	计算工作量	20	20
Postmortem & Process Improvement Plan	事后总结, 并提出过程改进计划	40	40

十三、附加功能：中英文的切换、多用户的成绩记录

中文版

英文版：

韩文版：

记录所有用户中的最好成绩：

十三、总结

在不断改进代码的过程中，学到了很多新知识。结对编程也能督促我不断修正自己的代码，并纠正之前自己敲代码的一些陋习。总之，收获很多。