Java中使用ZXing和QRCode生成二维码的示例详解
作者:码农研究僧
生成二维码在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
在Maven项目中,需要在pom.xml中添加QRCode的依赖:
以上就是Java中使用ZXing和QRCode生成二维码的示例详解的详细内容,更多关于Java ZXing和QRCode生成二维码的资料请关注脚本之家其它相关文章!
