二维码登录原理及生成与解析

v一、前言

　　这几天在研究二维码的扫码登录。初来乍到，还有好多东西不懂。在网上看到有人写了一些通过QRCode或者Zxing实现二维码的生成和解码。一时兴起，决定自己亲手试一试。本人是通过QRCode实现的，下面具体的说一下。

v二、二维码原理

　　基础知识参考：http://news.cnblogs.com/n/191671/

　　很重要的一部分知识：二维码一共有 40 个尺寸。官方叫版本 Version。Version 1 是 21 x 21 的矩阵，Version 2 是 25 x 25 的矩阵，Version 3 是 29 的尺寸，每增加一个 version，就会增加 4 的尺寸，公式是：(V-1)*4 + 21（V是版本号） 最高 Version 40，(40-1)*4+21 = 177，所以最高是 177 x 177 的正方形。

v三、二维码生成和解码工具

v1.效果如下图所示。

生成二维码（不含有logo）                                                   生成二维码（带有logo）

对应的解码

　　工具很简单，但是很实用。界面还可以美化，功能还可以加强，初心只是为了练习一下二维码的生成和解析。

v2.二维码生成和解析的核心类

v3.具体注意的地方

//二维码 SIZE
private static final int CODE_IMG_SIZE = 235;
// LOGO SIZE (为了插入图片的完整性，我们选择在最中间插入，而且长宽建议为整个二维码的1/7至1/4)
private static final int INSERT_IMG_SIZE = CODE_IMG_SIZE/5;

　　对于二维码图片大小还是不会计算，如果有人看到这里，方便的话可以告诉小弟一声。我这里的这个值（235）是通过设定好QrcodeVersion(版本15)，以及绘制图像时偏移量pixoff=2和black区域的size=3，最终生成图片后，将图片通过ps打开，然后确定图片的尺寸信息。

　　还有就是中间的logo不要过大，否则会导致QRCode解析出错，但是手机扫码不一定会出错。感觉手机扫码解析比QRCode解析能力强。

Qrcode qrcodeHandler = new Qrcode();
// 设置二维码排错率，可选L(7%)、M(15%)、Q(25%)、H(30%)，排错率越高可存储的信息越少，但对二维码清晰度的要求越小
qrcodeHandler.setQrcodeErrorCorrect(‘M‘);
qrcodeHandler.setQrcodeEncodeMode(‘B‘);
// 设置设置二维码尺寸，取值范围1-40，值越大尺寸越大，可存储的信息越大
qrcodeHandler.setQrcodeVersion(15);  

　　一般设置version就好了，网上好多都是7或者8，我尝试下更大的值，15的话二维码看起来很密集。

// 设置偏移量，不设置可能导致解析出错
final int pixoff = 2;
final int sz = 3;
// 输出内容> 二维码
if (contentBytes.length > 0 && contentBytes.length < 800) {
　　boolean[][] codeOut = qrcodeHandler.calQrcode(contentBytes);
　　for (int i = 0; i < codeOut.length; i++) {
        for (int j = 0; j < codeOut.length; j++) {
              if (codeOut[j][i]) {
                   gs.fillRect(j * sz + pixoff, i * sz + pixoff, sz, sz);
              }
         }
   }
}

　　绘制black区域的时候要设置偏移量，要不然可能导致二维码识别出错。 black区域的大小根据实际情况来就好。

v四、二维码登录原理

v1.原理图

　　按照自己的理解画的，结合上图，看一下代码吧。

v2.GetQrCodeController.java

/**
 * @author hjzgg
 * 获取二维码图片
 */
@Controller
public class GetQrCodeController {
    @RequestMapping(value="/getTwoDemensionCode")
    @ResponseBody
    public String getTwoDemensionCode(HttpServletRequest request){
        String uuid = UUID.randomUUID().toString().substring(0, 8);
        String ip = "localhost";
        try {
            ip = InetAddress.getLocalHost().getHostAddress();
        } catch (UnknownHostException e) {
            e.printStackTrace();
        }
        //二维码内容
        String content = "http://" + ip + ":8080/yycc-portal/loginPage?uuid=" + uuid;
        //生成二维码
        String imgName =  uuid + "_" + (int) (new Date().getTime() / 1000) + ".png";
        String imgPath = request.getServletContext().getRealPath("/") + imgName;
        //String insertImgPath = request.getServletContext().getRealPath("/")+"img/hjz.jpg";
        TwoDimensionCode handler = new TwoDimensionCode();
        handler.encoderQRCode(content, imgPath, "png", null);

        //生成的图片访问地址
        String qrCodeImg = "http://" + ip + ":8080/yycc-portal/" + imgName;
        JSONObject json = new JSONObject();
        json.put("uuid", uuid);
        json.put("qrCodeImg", qrCodeImg);
        return json.toString();
    }
}

　　用户请求扫码方式登录，后台生成二维码，将uuid和二维码访问地址传给用户。

v3.LongConnectionCheckController.java

@Controller
public class LongConnectionCheckController {
    private static final int LONG_TIME_WAIT = 30000;//30s
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    @RequestMapping(value="/longUserCheck")
    public String longUserCheck(String uuid){
        long inTime = new Date().getTime();
        Boolean bool = true;
        while (bool) {
            try {
                Thread.sleep(500);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            //检测登录
            UserVo userVo = (UserVo) redisTemplate.opsForValue().get(uuid);
            System.out.println("LongConnectionCheckAction:" + userVo);
            if(userVo != null){
                redisTemplate.delete(uuid);
                return "forward:/loginTest?username=" + userVo.getUsername() + "&password=" + userVo.getPassword();
            }else{
                if(new Date().getTime() - inTime > LONG_TIME_WAIT){
                    bool = false;
                    redisTemplate.delete(uuid);
                }
            }
        }
        return "forward:/longConnectionFail";
    }

    @RequestMapping(value="/longConnectionFail")
    @ResponseBody
    public String longConnectionFail(){
        JSONObject json = new JSONObject();
        json.put("success", false);
        json.put("message", "长连接已断开!");
        return json.toString();
    }
}

　　用户获得uuid和二维码之后，请求后台的长连接（携带uuid），不断检测uuid是否有对应的用户信息，如果有则转到登录模块（携带登录信息）。

v4.PhoneLoginController.java

/**
 * @author hjzgg
 *    手机登录验证
 */
@Controller
public class PhoneLoginController {

    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    @RequestMapping(value="/phoneLogin")
    public void phoneLogin(String uuid, String username, String password){
        UserVo user = (UserVo) redisTemplate.opsForValue().get(uuid);
        if(user == null) {
            user = new UserVo(username, password);
        }
        System.out.println(user);
        redisTemplate.opsForValue().set(uuid, user);
    }

    @RequestMapping(value="/loginPage")
    public String loginPage(HttpServletRequest request, String uuid){
        request.setAttribute("uuid", uuid);
        return "phone_login";
    }
}

　　用户通过手机扫码之后，在手机端输入用户信息，然后进行验证（携带uuid），后台更新uuid对应的用户信息，以便长连接可以检测到用户登录信息。

v五、源码下载

　　二维码登录例子以及二维码生成解析工具源码下载：https://github.com/hjzgg/QRCodeLoginDemo