当前位置：首页 > news >正文

SpringBoot 引用 ZXing 生成二维码条形码

news 2025/6/8 7:18:03

ZXing，全名为"Zebra Crossing"，是一个开源的Java

库，用于二维码的生成和解析。它是一个强大的工具，可以用于生成QR码以及解析包括QR码在内的多种二维码格式。ZXing提供了多种编程语言的API，使开发者能够轻松集成二维码功能到他们的应用中。它支持多种平台，包括Android、iOS、Java等。除了QR码，ZXing还支持解析其他一维码和二维码，例如EAN、UPC、DataMatrix等。

使用ZXing库，你可以轻松地将QR码功能集成到你的软件开发项目中，无论是生成QR码以供分享，还是解析QR码以获取其中的信息。在实际使用中，你可以添加注释来解释代码中的关键部分，以帮助其他开发者理解你的实现。这对于团队协作和维护代码非常有帮助。

1. Springboot 整合ZXing

1.1添加ZXing依赖

在你的Maven项目的pom.xml文件中添加ZXing库的依赖非常简单。你可以在<dependencies>标签内添加以下ZXing依赖：

<dependencies><!-- 其他依赖 --><dependency><groupId>com.google.zxing</groupId><artifactId>core</artifactId><version>3.4.1</version> <!-- 请使用最新版本 --></dependency>
</dependencies>

添加了这个依赖后，Maven会自动下载并添加ZXing库到你的项目中。然后，你可以在你的Java代码中使用ZXing库来生成和解析二维码。

1.2生成二维码

以下是一个示例的Java服务类，其中包含了生成QR码的方法，使用了ZXing库来实现。我将详细说明相关参数以帮助你理解代码：

package com.todoitbo.baseSpringbootDasmart.csdn;import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;import javax.imageio.ImageIO;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.File;
import java.util.HashMap;
import java.util.Map;public class QRCodeGeneratorService {// 生成QR码的方法public void generateQRCode(String data, int width, int height, String filePath) {try {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); // 错误纠正级别hints.put(EncodeHintType.MARGIN, 1); // 二维码边距MultiFormatWriter writer = new MultiFormatWriter();BitMatrix bitMatrix = writer.encode(data, BarcodeFormat.QR_CODE, width, height, hints);// 创建BufferedImage对象来表示QR码BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);for (int x = 0; x < width; x++) {for (int y = 0; y < height; y++) {image.setRGB(x, y, bitMatrix.get(x, y) ? Color.BLACK.getRGB() : Color.WHITE.getRGB());}}// 将QR码保存到文件File qrCodeFile = new File(filePath);ImageIO.write(image, "png", qrCodeFile);System.out.println("QR码已生成并保存到: " + filePath);} catch (Exception e) {e.printStackTrace();}}public static void main(String[] args) {QRCodeGeneratorService qrCodeGenerator = new QRCodeGeneratorService();String data = "https://todoitbo.fun"; // 要存储在QR码中的数据int width = 300; // QR码的宽度int height = 300; // QR码的高度String filePath = "qrcode.png"; // 生成的QR码文件的路径qrCodeGenerator.generateQRCode(data, width, height, filePath);}
}

在上面的代码中，generateQRCode方法接受四个参数：

data：要存储在QR码中的数据，可以是文本、URL等。
width：QR码的宽度（像素）。
height：QR码的高度（像素）。
filePath：生成的QR码文件的保存路径。

方法使用ZXing库的MultiFormatWriter来生成QR码，并将QR码保存到指定路径的文件中。确保根据你的需求修改这些参数以生成你想要的QR码。

1.3生成条形码

如果你想生成条形码，你可以使用ZXing库来实现。下面是一个示例的Java服务类，其中包含了生成条形码的方法，并详细说明了相关参数：

import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import javax.imageio.ImageIO;
import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;public class BarcodeGeneratorService {// 生成条形码的方法public void generateBarcode(String data, int width, int height, String filePath) {try {Map<EncodeHintType, Object> hints = new HashMap<>();hints.put(EncodeHintType.CHARACTER_SET, "UTF-8"); // 设置字符编码MultiFormatWriter writer = new MultiFormatWriter();BitMatrix bitMatrix = writer.encode(data, BarcodeFormat.CODE_128, width, height, hints);// 创建BufferedImage对象来表示条形码BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);for (int x = 0; x < width; x++) {for (int y = 0; y < height; y++) {image.setRGB(x, y, bitMatrix.get(x, y) ? 0 : 0xFFFFFF); // 生成黑色条和白色背景的条形码}}// 将条形码保存到文件File barcodeFile = new File(filePath);ImageIO.write(image, "png", barcodeFile);System.out.println("条形码已生成并保存到: " + filePath);} catch (Exception e) {e.printStackTrace();}}public static void main(String[] args) {BarcodeGeneratorService barcodeGenerator = new BarcodeGeneratorService();String data = "123456789"; // 要存储在条形码中的数据int width = 200; // 条形码的宽度int height = 100; // 条形码的高度String filePath = "barcode.png"; // 生成的条形码文件的路径barcodeGenerator.generateBarcode(data, width, height, filePath);}
}

在上面的代码中，generateBarcode方法接受四个参数：