因行动设备的流行而跟着带动起来的 QR Code,是众多条码类型的其中一种,它让我们的生活更便利,传递信息的速度更快,省下许多使用键盘打字的时间。如果要产生出 QR Code,已经有许多相关的现成工具能够使用,甚至还能直接在网页上产生。只是有的时候还是会遇到需要在自己的程序中加入产生 QR Code 的状况,像是需要产生大量的 QR Code 时,或是想要让自己的程序能不依赖其他工具就能独立使用。这篇文章,将会探讨如何使用 Java 编程语言产生 QR Code。当然,因为是 Java 程序,因此在 Android SDK 上也是可以用的。

从以上链接可以直接取得用 Java 语言写的 QR Code Library,另外还有提供 PHP 以及 Ruby 的版本。这个 Library 用了许多文件来存了不同大小以及不同容错率的 QR Code 所使用的数据,算是有点小肥。在使用这个 Java 版本的 Library 的时候,会发现有许多不知道是在做什么用的 API,因此笔者另外写了 MagicQRCode 函数库来取代官方的,使用起来会简单很多。MagicQRCode 可以至 GitHub 取得:

MagicQRCode 函数库的使用方法十分简单,只要两行就可以产生出 QR Code:

QRCodeEncoder qr = new QRCodeEncoder("QR Code的内容");
boolean[][] qrData = qr.encode();

也可以多加一行 setErrorCorrect 方法,来设置 QR Code 的容错率。愈高的容错率数据量将愈大,但可以有效避免当条码模糊不清,或是有部份受损时,造成无法辨识的情形。

QRCodeEncoder qr = new QRCodeEncoder("QR Code的内容");
qr.setErrorCorrect(QRCodeEncoder.ErrorCorrect.MAX);
boolean[][] qrData = qr.encode();

qrData 是一个二维的 boolean 数组,数组的大小会根据编码的文字长度和容错率而有所变动,但这个数组一定是个方形数组(长度相同)。如果要将 qrData 转成我们平常看到由黑白两色组成的图片,可以参考以下代码,将其绘制成图形:

JavaFX 绘制 QR Code
public static void drawQRCode(final Canvas canvas, final boolean[][] qrData) {
    final int width = (int)canvas.getWidth();
    final int height = (int)canvas.getHeight();
    final GraphicsContext gc = canvas.getGraphicsContext2D();

    //画背景(全白)
    gc.setFill(Color.WHITE);
    gc.fillRect(0, 0, width, height);

    final int imageSize = Math.min(width, height);
    final int length = qrData.length;
    final int size = imageSize / length;
    final int actualImageSize = size * length;
    final int offsetImageX = (width - actualImageSize) / 2;
    final int offsetImageY = (height - actualImageSize) / 2;

    //画数据(true为黑色)
    gc.setFill(Color.BLACK);
    for (int i = 0; i < length; i++) {
        for (int j = 0; j < length; j++) {
            if (qrData[i][j]) {
                final int x = i * size + offsetImageX;
                final int y = j * size + offsetImageY;
                gc.fillRect(x, y, size, size);
            }
        }
    }
}

Java 程序产生的 QR Code

Android SDK 绘制 QR Code
public static void drawQRCode(final Canvas canvas, final boolean[][] qrData) {
    final Paint paint = new Paint();
    final int width = canvas.getWidth();
    final int height = canvas.getHeight();
    
    //画背景(全白)
    paint.setColor(Color.WHITE);
    canvas.drawRect(new Rect(0, 0, width, height), paint);
    
    final int imageSize = Math.min(width, height);
    final int length = qrData.length;
    final int size = imageSize / length;
    final int actualImageSize = size * length;
    final int offsetImageX = (width - actualImageSize) / 2;
    final int offsetImageY = (height - actualImageSize) / 2;
    
    //画数据(true为黑色)
    paint.setColor(Color.BLACK);
    for (int i = 0; i < length; i++) {
        for (int j = 0; j < length; j++) {
            if (qrData[i][j]) {
                final int x = i * size + offsetImageX;
                final int y = j * size + offsetImageY;
                canvas.drawRect(new Rect(x, y, x + size, y + size), paint);
            }
        }
    }
}