结对项目：四则运算web

1）Coding.Net项目地址

https://git.coding.net/DandelionClaw/WEB_Calculator.git

注：本项目为web端，并且需要连接SQL Server数据库。

可使用已注册用户名：admin 密码：“admin”登录，或注册新用户登录。

首页目录为/WEB_Calculator/mysite/WebRoot/index.jsp。

　　队友：顾思宇 2016011993（后端 领头羊）

　　　我 ：程  羚 2016012050（前端 小羊）　

队友博客：http://www.cnblogs.com/DandelionClaw/p/8759867.html

---

2）PSP表格

（估计将在程序的各个模块的开发上耗费的时间）

　　注：计划时间与实际用时融合在了一张表格上

---

3）接口设计说明

看教科书和其它资料中关于Information Hiding, Interface Design, Loose Coupling的章节，说明你们在结对编程中是如何利用这些方法对接口进行设计的。（3'）

Information Hiding : 信息隐藏。在这次结对编程中，我们把计算核心和输入输出处理全部封装在core模块中，通过接口将core模块和外界联系起来，但具体的实现和错误处理都被隐藏在模块中。

Interface Design : 由于和结对队友所用语言不同，我们之间的对接至关重要，我们定义了一套公共的接口，极大程度的方便了各个模块之间的通讯。

Loose Coupling : 松耦合，通过模块的封装减少了通过接口连接的各个模块的影响。

---

4）计算模块接口的设计与实现过程

设计包括代码如何组织，比如会有几个类，几个函数，他们之间关系如何，关键函数是否需要画出流程图？说明你的算法的关键（不必列出源代码），以及独到之处。（4'）

我主要负责前端，核心算法这一块主要是队友在做，

在计算模块，我主要负责了：未输入结果时防止跳转并进行相应提示，以及最终结果界面对接。

---

5) 计算模块接口部分的性能改进。

记录在改进计算模块性能上所花费的时间，描述你改进的思路，并展示一张性能分析图，并展示你程序中消耗最大的函数。（4'）

在性能改进这一块我花费了大约2小时，除了将原本的命令行程序扩展命令格式以外，我还优化了字符串存储方式，详细内容如下：

当输入参数为时 效能分析图为

经分析String内存占用较大，原因是因为我用一个String存储了全部的算式并且没有释放内存，优化代码后性能明显改善了许多。

另外我还发现了一个有趣的现象，当代码执行完成后，内存并没有释放而是叠加了起来，如图所示：

当题目为50时内存变化，之后内存不断攀升达到一定数值后稳定下来。

当我再次输入50时，内存变化

经研究发现这是因为java特殊的内存释放机制所导致的。

---

6）计算模块部分单元测试展示。

展示出项目部分单元测试代码，并说明测试的函数，构造测试数据的思路。并将单元测试得到的测试覆盖率截图，发表在博客中。只需要测试命令行部分，且该部分覆盖率到90%以上，否则单元测试部分视作无效。（6'）

我的测试思路是测试所有的正常和异常情况，确保程序能够正常运行。

    @Test
    public void testMain(){//本函数为正确输入形式，并打乱了命令输入顺序
        String[] args = {"-o","2","-n","20","-c","-b","-m","1","100"};
        command.main(args);
    }
    @Test
    public void testMain1(){//本函数只正确输入了-n命令，但没有输入另一个必须输入的命令-m
        String[] args = {"-n","20"};
        command.main(args);
    }
    @Test
    public void testMain2(){//本函数测试不输入任何命令的情况
        String[] args = {};
        command.main(args);
    }
    @Test
    public void testMain3(){//本函数测试输入了必须输入的-n、-m命令，但-m命令少输入了一个参数
        String[] args = {"-n","20","-m","1"};
        command.main(args);
    }
    @Test
    public void testMain4(){//本函数测试输入错误命令
        String[] args = {"aaaa"};
        command.main(args);
    }
    @Test
    public void testMain5(){//本函数测试输入了-n命令，但缺少了参数
        String[] args = {"-n"};
        command.main(args);
    }
    @Test
    public void testMain6(){//本函数测试输入了-0命令，但缺少了参数
        String[] args = {"-o"};
        command.main(args);
    }
    @Test
    public void testMain7(){//本函数测试输入了必须输入的-n、-m命令，但-n参数范围错误
        String[] args = {"-n","1000000","-m","1","100"};
        command.main(args);
    }
    @Test
    public void testMain8(){//本函数测试输入了必须输入的-n、-m命令，但-n参数类型错误
        String[] args = {"-n","aaa","-m","1","100"};
        command.main(args);
    }
    @Test
    public void testMain9(){//本函数测试输入了必须输入的-n、-m命令，但-m参数范围错误
        String[] args = {"-n","10","-m","100","50"};
        command.main(args);
    }
    @Test
    public void testMain10(){//本函数本函数测试输入了必须输入的-n、-m命令，但-o参数范围错误
        String[] args = {"-n","10","-m","1","100","-o","-100"};
        command.main(args);
    }

11个测试函数均运行正确

覆盖率达到了90%以上

---

7）计算模块部分异常处理说明。

在博客中详细介绍每种异常的设计目标。

每种异常都要选择一个单元测试样例发布在博客中，并指明错误对应的场景。（5'）

我负责的主要有：

1.js提示：main界面定制题目时，不可有非正常输入，

核心jquery代码

2.js：index界面登录时，对未注册用户拦截，组织页面跳转

这里只贴出核心的代码：

// 判断用户名密码的js
//数据库一般存储的密码是md5格式，判断密码是否正确时，先将密码转为md5格式，再判断；（转md5格式，先引用md5js，再写hex_md5("2121212") 即可）
$(function() {
　　　　　//根据localStorage中是否有值，判断用户是否登录过
        if(window.localStorage){  //用户登录过
            var name1 = localStorage.getItem("usename"); //获取存储的用户名
            var pwd1 = localStorage.getItem("pwd");        //获取存储的密码
            $("input[name=usename]").val(name1);         //用户名赋值
            $("input[name=pwd]").val(pwd1);                //密码赋值
        }else{
            $("input[name=usename]").val("");
            $("input[name=pwd]").val("");
        }
    })
　　//点击登录按钮
    $('#btnYes').click(function (event) {       
        if($("input[name=usename]").val()=="") {  //用户名为空时
            $(".mixfirm").show();
            mixfirm("用户名不能为空");
            setTimeout(function() {
                $(".mixfirm").hide();
            },1000);
            return false;
        }
        if($("input[name=pwd]").val()=="") {  //密码为空
            $(".mixfirm").show();
            mixfirm("密码不能为空");
            setTimeout(function() {
                $(".mixfirm").hide();
            },1000);
            return false;
        }

        var list1 = $("input[name=usename]").val();   //获取当前输入的用户名，根据用户名查SQL
        sql("select * from Users where usename='"+list1+"'",function(data) {
            if(data!=null) {  //如果用户名存在
                var ps1 = data.pwd;  //获取数据库密码
                var ps2 = hex_md5($("input[name=pwd]").val());   //获取输入的密码，并转成md5格式
                if(ps1 == ps2) {  //如果输入的密码正确，执行loginAfter方法
                    //用ttyu平台获取所有用户的信息的方法，可以在此写SQL直接查数据库
　　　　　　　　　　　　$("#form1").send({ table: "Users", action: "login", backAfter: "loginAfter" });
                }else {  //密码错误，弹框提示
                    $(".mixfirm").show();
                    mixfirm("密码错误");
                    setTimeout(function() {
                        $(".mixfirm").hide();
                    },1000);
                    return false;
                }
               
            }else{  //用户名不存在
                $(".mixfirm").show();
                mixfirm("该用户不存在");
                setTimeout(function() {
                    $(".mixfirm").hide();
                },1000);
                return false;
            }
           
        })
    });
    //登录回调函数
    function loginAfter(result) {  //result -- 所有用户信息
        try {
            ttyu.user.saveUser(result);  //当前用户信息
            var names = $("input[name=usename]").val();  //获取输入的用户名
            var pwds = $("input[name=pwd]").val();         //获取输入的密码
            localStorage.setItem("usename",names);       //本地存储
            localStorage.setItem("pwd",pwds);
           // location = "index.html";                       //跳转到首页面
        } catch (e) {
            firm(result);
        }
    }

　　

---

8）界面模块的详细设计过程。

在博客中详细介绍界面模块是如何设计的，并写一些必要的代码说明解释实现过程。(5')

界面模块设计：（用图更清晰~）

实现过程：

1. index.jsp 登陆界面

注册页面与之相像

2. main.jsp

html代码相对简单，用了css+jquery进行美化

界面图见        12）附加功能版块

3. replyonline.jsp

利用数据库+servlt 实现了逐个答题功能，并加上了异常处理。比较喜欢在这个界面做的button按钮，在下面给出了button按钮的css样式，喜欢的可以采纳

button{
  margin: 20px;
}
button a{
  color: black;
}
.button{
  margin:60px 220px;
  margin-top: 60px;
}
.bt{
  -webkit-transition: all 300ms cubic-bezier(0.19, 1, 0.22, 1);
  transition: all 300ms cubic-bezier(0.19, 1, 0.22, 1);
  -webkit-transform: translateX(47px);
  will-change: transform;
  z-index: 3;
  overflow: hidden;
  border-radius: 40px;
  padding: 12px 15px;
  background: #43CB9D;
  color: white;
  font-size: 16px;
  font-weight: 500;
  letter-spacing: 1px;
  line-height: 1;
  text-transform: uppercase;
}
.bt:before {
  -webkit-transition: opacity 300ms ease-out, -webkit-transform 0ms 300ms;
  transition: opacity 300ms ease-out, -webkit-transform 0ms 300ms;
  transition: opacity 300ms ease-out, transform 0ms 300ms;
  transition: opacity 300ms ease-out, transform 0ms 300ms, -webkit-transform 0ms 300ms;
  opacity: 0;
  -webkit-transform-origin: center center;
          transform-origin: center center;
  -webkit-transform: scale(0);
          transform: scale(0);
  will-change: transform, opacity;
  content: "";
  display: block;
  z-index: -1;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background: #3FE2D9;
  border-radius: 40px;
}
.bt{
  float: left;
}

　　

 提交结果页面与之相似，在上面的gif图里可以看见效果。

---

9）界面模块与计算模块的对接

详细地描述UI模块的设计与两个模块的对接，并在博客中截图实现的功能。(4')

(1)UI设计

我们现在纸上完成了基本的UI 界面设计，然后由我负责实现和美化，详细内容在8.中都已说明。

(2)前后端对接

我采用servlet+JavaBean+form表单的方法将前后端联系起来。

例如在产生算式时，用form表单将用户输入的参数获取至servlet，将命令行程序import进servlet中，使用接口调用命令行程序产生算式。然后将生成的算式保存至数据库中，再在前端使用JavaBean链接数据库，把算式输出到前端。用户注册、答题等同理。

(3)功能展示

①登录和注册功能：

    

②附加功能1 多语言功能：

③题库生成功能，若参数错误前后端均提供了异常处理，前端显示提示并使得表单无法提交，后端throw catch处理异常。

④做题功能，计时功能，本次正确率统计功能，错题展示功能

⑤附加功能2 分用户历史做题记录展示，并显示最佳记录

---

10）结对过程

　　我们小队分工比较明确，队友主要负责后端，我主要负责前端。队友为我们小组的领航员~

我们的第一步：选择了队友的第一次作业代码，队友在原本的基础上面进行更改，我开始做基本的前端页面。我们先自己做自己的，在各自擅长的领域奋斗前行~

我们的第二步：队友开始写单元测试，我继续美化我们的web界面，我们对web界面有比较高的要求，一致认为好的界面是吸引用户的最好手段！

我们的第三步：初步前后端合体，实现一些基本功能，如：题目定制，在线答题，输出结果……因为我们是舍友，进行交流也比较方便，虽然出过一些bug，但是也很快就解决了。开心

我们的第四步：一起为模块增加异常处理，主要为“生成算式数量”异常和登录异常，在核心模块写入后，我们又考虑到用户体验，使用jQuery撰写了相应的及时提醒以及防止跳转，双重保障更贴心呢！

我们的第五步：检查整个项目，并进行优化。

← 队友：顾思宇（大佬）     ：         我（小弟）→

---

11）结对编程的优点和缺点

看教科书和其它参考书，网站中关于结对编程的章节，例如：

http://www.cnblogs.com/xinz/archive/2011/08/07/2130332.html

说明结对编程的优点和缺点。同时指出结对的每一个人的优点和缺点在哪里 (要列出至少三个优点和一个缺点)。(5')

结对编程的优点：

　　　　　　　　1. 在这次结对项目中，我的队友担任的是领航员的角色，我们各有所长，且把这份长处最大化。所以我觉得结对编程最大的好处在于1+1>2，做出的项目会更加的完美。

　　　　　　　　2. 在编程中，相互讨论，可以更快更有效地解决问题。比如在这次项目中，我们在做jQuery表单验证时，防止页面跳转的点怎么也做不出来，尝试过百度给的所有解决方法，大晚上把所有宿舍串了一遍也没

　　　　　　　　　 解决，然后有天闲聊，聊着聊着就聊出了一个新的方法。也验证了那句，语言是思维碰撞的开始。

　　　　　　　　3. 最深有感触的一点：bug解决的更快了！

结对编程的缺点：

1. 对于有不同习惯的同学，在一起编程可能会有比较多的麻烦，导致效率底下。
2. 部分人可能更适合个人编程，而不习惯在编码的时候还要应对他人的感受，甚至导致1+1<1

我可爱的队友：优点1. 能力强，有责任心

　　　　　　　优点2. 人真的真的好，在编程的过程中对我关照有加，

　　　　　　　优点3. 有耐心，在我调bug调到崩溃的适合，她会继续调。。（简直全世界最好的老顾顾）

　　　　　　　缺点：太好了。太棒了，棒到我快开心死！会觉得自己拖了她的后腿...

　　　

---

12）附加题！！！

一、 多语言支持

实现原理：通过jquery+ajax实现。核心思想是通过i18n属性设置多语言的key，然后插件对所有带i18n属性的dom进行扫描处理。但是前端多语言并不仅仅是这一个需求，进而延伸的还有事件函数中需要使用的消息，比如

　　　　　新增一条数据后的提示消息“新增成功”。这时，就需要对普通字符串对象，即String对象进行处理，使其支持多语言。

这里贴出部分代码：

1. 浏览器语言的获取

/**
 * 获取浏览器语言
 * @returns language
 */
function getLang(){
    if(typeof(cacheLang) != "undefined"){
        return cacheLang;
    }
    if (navigator.language) {
        cacheLang = navigator.language.toLowerCase();
        return cacheLang;
    }else {
        cacheLang = navigator.browserLanguage.toLowerCase();
        return cacheLang;
    }
}

获取浏览器语言

2.多语言配置的加载　　

var url = $.type(p) == "string" ? p : "i18n/" + getLang() + ".json";//p为参数，可通过p手动指定配置路径，此时不根据默认路径加载多语言消息配置
$.ajax({
    url : url,
    dataType : 'json',
    type : "GET",
    success : function(data, textStatus, jqXHR) {
        messages = data;//缓存消息
        run(data);//执行dom处理
        callback(self);//回调处理，self为插件本身对象
    },
    error : function(a, b, c) {
        throw "Load i18n message error [" + p + "], cause by : " + b;
    }
});

配置的加载

3.DOM处理

/**
 * 替换国际化消息
 * @param ms 消息对象
 */
function run(ms){
    $("*[i18n]").each(function(){
        var o = $(this);
        var key = o.attr("i18n");//获取key
        var val = o.attr("i18n-set");//获取消息设置目标
        var message = _getMessage(ms, key);//取得消息
        switch(val){//根据不同目标设置到不同的地方
        case undefined:
            o.html(message);
            break;
        case "append":
            o.html(o.html() + message);
            break;
        case "html":
            o.html(message);
            break;
        case "value":
            o.val(message);
            break;
        default:
            o.attr(val, message);
            break;
        }
        o.removeAttr("i18n");//移除属性，避免二次处理
        o.removeAttr("i18n-set");
    });
}

dom处理

 4. 获取多语言的方法

/**
 * 获取多语言消息
 * @param msgs 消息对象
 * @param key 消息名称
 * @returns value 消息
 */
function _getMessage(msgs, key){
    var message;
    try{
        message = msgs[key];
    }catch(e){
        message = key;
    }
    return message;
}
5.实现对String对象的改造
/**
 * 为String提供local方法获取多语言消息
 * @return value 消息
 */
String.prototype.local = function(){
    return _getMessage(messages, this);
}

获取多语言的方法

二、多用户支持

主要通过数据库来实现。

主要通过javaBean+JSP连接数据库来实现，建立Users表和Score表，分别记录用户信息和得分信息。

---

13）团队项目总结

　　　总的来说，这次合作对我而言是一次很愉快又不愉快的经历。愉快在于和舍友有着和睦的交流方式，做项目比起其他小组要轻松许多，也做出了一个自我感觉还不错的作品；不愉快则在于我的后端编码能力较弱，无意中就加大了舍友的重担。其次，做项目的过程本身也让我觉得有一点痛苦，项目时间短任务重，清明三天假期都是在高压中度过，每天都处于早上朝八点到凌晨两点不间歇的紧绷状态，每天晚上躺在床上都会因为想到项目的某个bug而睡不着。一度以为自己可能完成不了这个项目。

　　所幸，我们的结果是好的。再这次合作中，我觉得自己的java编码能力也有了一些提升，希望之后做的团队项目可以更好！