Java中使用ZXing和QRCode生成二维码的示例详解_开发_开发者

1. 基本知识

生成二维码在Java中有多种方法，常用的是通过第三方库来实现，比较流行的库包括 ZXing (Zebra Crossing) 和 QRCode

ZXing库中的核心API

MultiFormatWriter.encode()：生成二维码矩阵
MatrixToImageWriter.writeToPath()：将二维码矩阵保存为图片文件

QRCode库中的核心API

QRCode.from(content)：从内容生成二维码
withSize(width, height)：设置二维码的尺寸
file()：生成二维码并保存为图片文件

ZXing库功能强大，适合生成复杂的二维码且提供了细粒度的控制

QRCode库使用简单，快速生成二维码，适合基础需求

二维码是一种将信息编码为二维图形的技术，常用于存储URL、文本、数字等信息。它由黑白模块组成，通常可以通过扫描来解码

生成二维码的过程主要分为两个步骤：

编码：将需要存储的信息（如URL、文本等）编码为二维码的黑白模块
绘制：根据编码信息绘制出二维码图像，通常可以保存为PNG、JPG等格式

使用ZXing生成二维码 ZXing是最常用的Java二维码生成库，支持多种格式（例如二维码、条形码）

其核心类包括：

MultiFormatWriter：用于生成二维码的核心类
BitMatrix：二维码的矩阵表示，用于保存黑白模块的分布
MatrixToImageWriter：将二维码矩阵转化为图片

二维码的参数设置

宽度和高度：二维码图片的尺寸，通常是正方形
编码字符集：通常使用UTF-8编码，确保支持中文等特殊字符
错误纠正级别：二维码的容错能力，可以通过调整纠错级别提高二维码的鲁棒性

2. ZXing

依赖库配置（Maven项目）

在Maven项目中，需要在pom.XML中添加ZXing的依赖：

<dependencies>
    <dependency>
        <groupId>com.google.zxing</groupId>
        <artifactId>core</artifactId>
        <version>3.4.1</version>
    </dependency>
    <dependency>
        <groupId>com.google.zxing</groupId>
        <artifactId>javase</artifactId>
        <version>3.4.1&http://www.devze.comlt;/version>
    </dependency>
</dependencies>

Demo如下：

import com.google.zxing.BarcodeFormat;
import com.google.zxing.Writer;
import com.google.zxing.WriterException;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.QRCodeWriter;

import javax.imageio.ImageIO;
import java.awt.*;
import java.awt.image.BufferedImage;
iphpmport java.io.File;
import java.io.IOException;

public class QRCodeGenerator {

    public static void main(String[] args) {
        // 要编码的文本
        String data = "Hello, QR Code!";
        // 生成的二维码图片文件路径
        String filePath = "qrcode.png";

        try {
            // 调用生成二维码的方法
            generateQRCodeImage(data, 300, 300, filePath);
            System.out.println("二维码生成成功！");
        } catch (WriterException | IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 生成二维码图像并保存到文件
     *
     * @param text   要编码的文本
     * @param width  图像宽度
     * @param height 图像高度
     * @param filePath 保存文件路径
     * @throws WriterException 生成二维码异常
     * @throws IOException     IO异常
     */
    private static void generateQRCodeImage(String text, int width, int height, String filePath)
            throws WriterException, IOException {
        // 创建 QRCodeWriter 实例
        QRCodeWriter qrCodeWriter = new QRCodeWriter();
        // 生成 BitMatrix，表示二维码的黑白矩阵
        BitMatrix bitMatrix = qrCodeWriter.encode(text, BarcodeFormat.QR_CODE, width, height);

        // 创建一个 BufferedImage，用于绘制图像
        BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
        image.createGraphics();

        // 获取图形上下文
        Graphics2D graphics = (Graphics2D) image.getGraphics();
        // 设置背景色为白色
        graphics.setColor(Color.WHITE);
        graphics.fillRect(0, 0, width, height);
        // 设置前景色为黑色
        graphics.setColor(Color.BLACK);

        // 在图像上绘制二维码的黑色矩阵
        for (int i = 0; i < width; i++) {
            for (int j = 0; j < height; j++) {
                if (bitMatrix.get(i, j)) {
                    // 如果当前位置为黑色，填充一个像素
                    graphics.fillRect(i, j, 1, 1);
                }
            }
        }

        // 将图像保存为 PNG 文件
        ImageIO.write(image, "png", new File(filePath));
    }
}

截图如下：

Java中使用ZXing和QRCode生成二维码的示例详解

另外一个Demo：

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.client.j2se.MatrixToImageWriter;

import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.HashMap;
import java.util.Map;

public class QRCodeGenerator {

    /**
     * 生成二维码
     * @param content 二维码中包含的内容，如URL或文本
     * @param width   二维码的宽度
     * @param height  二维码的高度
     * @param filePath 保存二维码图片的路径
     * @throws Exception 可能抛出的异常
     */
    public static void generateQRCode(String content, int width, int height, String filePath) throws Exceptijson {
        // 定义二维码的参数
        Map<EncodeHintType, Object> hints = new HashMap<>();
        // 设置编码字符集
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        // 设置二维码的容错级别，较高容错级别适合损坏或部分覆盖的二维码
        hints.put(EncodeHintType.ERROR_CORRECTION, com.google.zxing.qrcode.decoder.ErrorCorrectionLeveljavascript.H);

        // 生成二维码的BitMatrix（二维码的矩阵表示）
        BitMatrix bitMatrix = new MultiFormatWriter().encode(content, BarcodeFormat.QR_CODE, width, height, hints);

        // 将二维码矩阵保存为图片文件
        Path path = Paths.get(filePath);
        MatrixToImageWriter.writeToPath(bitMatrix, "PNG", path);

        System.out.println("二维码已成功生成，保存路径: " + filePath);
    }

    public static void main(String[] args) {
        try {
            // 生成二维码的内容
            String content = "https://www.example.com";
            // 设置二维码的宽度和高度
            int width = 300;
            int height = 300;
            // 保存二维码图片的路径
            String filePath = "qr_code.png";

            // 调用生成二维码方法
            generateQRCode(content, width, height, filePath);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}