HBuilder 入门(5) / 编写一个登录页面 - Ajax交互

    上一篇分享了如何进行页面的设计，接下来我们该完成客户端与服务器的交互的部分了。正如上一篇所说，这种交互我们使用的是AJAX方式，页面不会因为刷新而现实大白页。

    交互这部分可以分成两个部分：服务器端和客户端。

    服务端以Java语言为例子（因为我只做过Java的）。其实 c#或者php等语言实现起来也都是基本一样的，可以当做参考。

    如果你正在使用SpringMVC，那么就简单了，因为Spring已经封装了Ajax的调用方式。如果像我一样，没有使用SpringMVC，那么很遗憾，你需要一个能够解析json的库。经过比较，我选择了 jackson 这个工具。注意：在写这个文章的时间点，在网上搜索的jackson网站已经迁移到了github，所以，请使用本文提供的新的链接。

    下面的例子也是基于jackson解析的。如果你使用了SpringMVC，或者其他解析json的工具，或者其他语言如PHP，应该也是差不多的。 

    下面来看一下一个登录过程的流程：

    


 
    流程虽然比较多，但是很容易理解。先从客户端看起。

    首先就是通过Ajax的方式，将用户名和密码发送给客户端。为了安全，我们不能直接发送明文的密码，必须将密码加密。可选择的方式很多，一般都是不可逆的hash方式，如md5, sha1的方式加密。在本例中我们选择 md5的方式加密。javascript里的md5现成的方法很多，大家自己寻找一个合适的吧。但是标准就是：小，快，使用简单。

    接下来就是ajax的使用。mui 提供了ajax的使用方法，请参看这里。 不过如果你按照文档那样，每个ajax调用都写那么一堆代码，一会你的代码就会臃肿不堪。所以，我对ajax调用又做了一个简单的封装，避免每次都设置相同的参数：

function postData(url, data, callback, waitingDialog) {
	
	mui.ajax(url,{
		data:'data='+JSON.stringify(data),
		dataType:'json',
		type:'post',
		contentType:"application/x-www-form-urlencoded; charset=utf-8",
		timeout:60000,
		success:callback,
		error:function(xhr,type,errorThrown){
			waitingDialog.close();
			mui.alert("<网络连接失败，请重新尝试一下>", "错误", "OK", null);
		}
	});
}

data 属性：就是要传递给服务端的数据。之所以要加上 'data=' 这个东西，就是为了让服务器端知道变量的名字是 "data" 。而传递的json 数据，也必须通过JSON.stringify方式转换成字符串。

contentType属性：这个很重要。如果没有这个，你在后台得到的中文字符串就会是乱码。其实如果你熟悉Jquery，对这个属性应该不会陌生。

error属性：出错的处理。这里的 waitingDialog 是一个等待的对话框。在点击登录按钮后，会显示一个等待的对话框。无论出错了，还是正常处理了，都必须要关闭这个等待的对话框。同时用 mui.alert 显示了一个错误的消息。

    以上就是 ajax 的请求函数。

    接下来看看登录按钮的处理：

// 登录处理，还记得我们上一篇写得的按钮关联的事件吧
document.getElementById("loginBtn").addEventListener('tap', function(){
  // 显示一个等待的对话框
  var wd = plus.nativeUI.showWaiting();
  // 构造要传递的json数据
  // $id 是一个通过 id 取得对象的方法，
  // 内容就是 return document.getElementById();
  var data = {"userName": $id('username').value, 
          "userPassword":md5Hash($id('userpassword').value)
    };
  // 调用ajax
  postData(SERVER_HOST + MODULE_LOGIN, //服务端的URL
    data,// json 数据
    function(data) {
      wd.close(); // 调用成功，先关闭等待的对话框
      if(data.result != "checkOK") {
        // 如果密码错误，提示一下信息
        mui.alert("用户名或密码错误", "登录错误", "关闭");
        return;
      }
      // 保存token，以便于下次自动登录
      localStorage.setItem(TOKEN_USER, $id('username').value);
      localStorage.setItem(TOKEN_LOGIN, data.token);
      // 清空用户名，密码
      $id('username').value = "";
      $id("userpassword").value = "";
      // 打开下一个画面
      mui.openWindow(
        {
          url:'mainShow.html',
          id:'mainShow',
        }
      );
    },
    wd//传递给postData的最后一个参数，失败的时候关闭等待对话框
  );
});

    上面的代码都有注释，但是有的地方还是说明一下。

    plus.nativeUI.showWaiting(); 这是一个原生的调用，并非用 div 来模拟对话框。这也是HBuilder的强力武器之一：Native.js。Native.js的概念，在第一篇入门文章里有介绍。具体的API用法，请参照官方的文档，里边有一个 Native.js 的部分。

    传递给服务器端的数据的部分，正如流程里所示，对密码进行了加密。对于 ajax 的调用，使用了之前封装的 postData 方法。

    返回值是一个 json 对象，变量名字为 data。如果 data.result 不等于 "checkOK" ，那么就认为密码错误，提示错误信息。

    注意：在实际的应用中，判断返回数据的有效性，最好不使用字符串，而是使用数字。如 1表示密码错误，0表示校验通过。并且，对于返回值的格式，最好有统一的格式定义。之前我为了尽快完成功能，只是随意地使用了各种字符串，各种变量来处理返回的状态，等到程序大到一定程度的时候，就发现这很混乱，不容易维护了。

    保存 token ，是为了下次打开程序的时候能自动登录，无需再次输入用户名和密码。

    之后，有一个清除用户名和密码的操作。为什么需要这个操作？在 webview 的理解这篇文章说过，页面的webview 创建完毕后，是不会自己销毁的。虽然你后面可以再次迁移到别的webview，但是新的webview也只是覆盖在了之前的webview上。当我们的程序有注销的功能的时候，需要再次显示登录画面。如果登录画面没有经过 销毁-> 再构建的过程，那么显示登录画面的时候，就会显示出来你上次输入的用户名和密码。所以，我们在这里手动清空一下。

    之后，使用 mui.openWindow 打开下一个页面。

    接下来是服务器端的部分。在ajax中，我们给服务器端传递的参数名字叫 data，那么无论你是使用java也好，还是php 也好，都需要从 request 中取出 "data" 这个变量。这个变量的值就是字符串化的json。

    本例使用的 jackson 来解析 json 数据，代码很简单：

ObjectMapper mapper = new ObjectMapper();
UserData userData = mapper.readValue(data, UserData.class);

     UserData就是一个定义了用户名和密码变量的class，没有任何的逻辑。（按照Domain Driven Desgin的概念，它就是一个值对象，而不是实体，此乃题外话）

    接下来就是查询数据库，验证用户名，密码是否有效。如果有效的话，我们要创建一个token返回给前台。为了保持唯一性，这个token 最好是和用户名相关联的。简单点的方法：md5(用户名+系统时间+随机数)。而且我们要把这个token保存在数据库里。为了安全，可以设置一个有效期。

    处理完毕后，使用 jackson 构造json数据，返回就可以了，简单的例子：

response.setContentType("application/json");
		response.setCharacterEncoding("UTF-8");
		try {
			response.getWriter().print(json);
			response.getWriter().flush();
			response.getWriter().close();
			
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

    这样，登录的客户端和服务器端的部分就完成了。

    当用户再次打开应用的时候，先判断localstorage 里是否保存有 token。如果有 token ，那么就通过ajax发送给服务器，服务器判断token 的有效性，如果验证通过，那么自动登录就成功，否则失败。

    至此，登录的流程就处理完毕了。想必大家对HBuilder的强大之处也有所了解吧。

    之后会再分享一下webview迁移的参数传递，和稍微复杂的页面构造的心得。