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

 更新时间:2024年09月27日 10:30:57   作者:码农研究僧  
生成二维码在Java中有多种方法,常用的是通过第三方库来实现,比较流行的库包括 ZXing (Zebra Crossing) 和 QRCode,本文小编就给大家介绍了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</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;
import 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));
    }
}

截图如下:

另外一个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 Exception {
        // 定义二维码的参数
        Map<EncodeHintType, Object> hints = new HashMap<>();
        // 设置编码字符集
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        // 设置二维码的容错级别,较高容错级别适合损坏或部分覆盖的二维码
        hints.put(EncodeHintType.ERROR_CORRECTION, com.google.zxing.qrcode.decoder.ErrorCorrectionLevel.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();
        }
    }
}

3. QRCode

QRGen的xml依赖包

QRGen JavaSE » 3.0.1的xml依赖包

在Maven项目中,需要在pom.xml中添加QRCode的依赖:

以上就是Java中使用ZXing和QRCode生成二维码的示例详解的详细内容,更多关于Java ZXing和QRCode生成二维码的资料请关注脚本之家其它相关文章!

相关文章

  • Spring条件注解用法案例分析

    Spring条件注解用法案例分析

    这篇文章主要介绍了Spring条件注解用法,结合具体实例形式分析了Spring条件注解相关原理、使用方法及操作注意事项,需要的朋友可以参考下
    2019-11-11
  • Springboot3集成Knife4j的步骤以及使用(最完整版)

    Springboot3集成Knife4j的步骤以及使用(最完整版)

    这篇文章主要介绍了Springboot3集成Knife4j的步骤以及使用的相关资料,Knife4j是一种增强Swagger的工具,支持黑色主题和更多配置选项,它与swagger-bootstrap-ui相比,提供了更现代的外观和更多的功能,需要的朋友可以参考下
    2024-11-11
  • SpringBoot源码 PropertySource解析

    SpringBoot源码 PropertySource解析

    PropertySource是spring中对于键值属性的一种抽象,主要是name和sourcePropertyResolver是对PropertySource提供对外的统一数据处理,对于占位符的处理委托于PropertyPlaceholderHelper,对Springboot 源码 PropertySource相关知识感兴趣的朋友一起看看吧
    2023-01-01
  • SpringJDBC源码初探之DataSource类详解

    SpringJDBC源码初探之DataSource类详解

    文章介绍了Java JDBC规范中的DataSource接口及其在Spring框架中的增强功能,包括连接池、事务管理等,重点分析了三种核心实现
    2025-08-08
  • 使用FeignClient设置动态Url

    使用FeignClient设置动态Url

    这篇文章主要介绍了使用FeignClient设置动态Url方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-06-06
  • Spring依赖注入Dependency Injection的三种方式

    Spring依赖注入Dependency Injection的三种方式

    依赖注入(Dependency Injection)和控制反转(Inversion of Control)是同一个概念。具体含义是:当某个角色(可能是一个Java实例,调用者)需要另一个角色(另一个Java实例,被调用者)的协助时,在传统的程序设计过程中,通常由调用者来创建被调用者的实例
    2023-02-02
  • 剖析SpringCloud Feign中所隐藏的坑

    剖析SpringCloud Feign中所隐藏的坑

    这篇文章主要为大家介绍了剖析SpringCloud Feign中所隐藏的坑示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • Java实现AES加密算法的简单示例分享

    Java实现AES加密算法的简单示例分享

    这篇文章主要介绍了Java实现AES加密算法的简单示例分享,AES算法是基于对密码值的置换和替代,需要的朋友可以参考下
    2016-04-04
  • jvm-jstack常用的用法示例

    jvm-jstack常用的用法示例

    jstack 是一个常用的用于分析 Java 进程的工具。它可以显示 Java 进程中所有线程状态和堆栈信息,帮助定位 Java 进程中的问题,这篇文章主要介绍了jvm-jstack常用的用法示例,需要的朋友可以参考下
    2023-06-06
  • Spring Boot使用MyBatis进行两个表的关联

    Spring Boot使用MyBatis进行两个表的关联

    本文主要介绍了Spring Boot使用MyBatis进行两个表的关联,通过实例演示了如何使用MyBatis的XML映射文件和注解实现关联操作,具有一定的参考价值,感兴趣的可以了解一下
    2023-09-09

最新评论