1. 添加ZXing依赖到Spring Boot项目
场景描述: 在需要快速、高效地生成二维码或条形码的应用中,如电子票务、产品追踪、个人身份验证等,集成ZXing库至Spring Boot项目是至关重要的一步。
在项目的pom.xml
文件中添加以下依赖以引入ZXing库:
xmlCopy code<dependencies>
<!-- 添加ZXing库依赖 -->
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>core</artifactId>
<version>3.5.2</version> <!-- 使用最新版本以确保最佳性能和功能 -->
</dependency>
</dependencies>
使用最新版本的ZXing库可以确保你的应用具备最新的二维码和条形码生成能力,包括更好的性能和支持更多格式。
2. 创建二维码生成服务
场景描述: 此服务类适用于需要将URL、文本信息或其他数据快速转换为二维码图像的场合,如商业广告、社交媒体共享、安全验证等。
代码示例与注释:
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;
/**
* 生成二维码图像类
*
* @author songzixian
*/
public class QRCodeService {
/**
* 生成二维码图像
*
* @param text 要编码的文本
* @param width 二维码图像宽度
* @param height 二维码图像高度
* @param filePath 文件存储路径
* @return 生成的二维码图像的字节数组
*/
public void generateQRCode(String text, 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);
// 使用QRCodeWriter生成二维码矩阵信息
MultiFormatWriter writer = new MultiFormatWriter();
BitMatrix bitMatrix = writer.encode(text, BarcodeFormat.QR_CODE, width, height, hints);
// 将二维码矩阵信息转换为图像
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());
}
}
// 江二维码保存成文件
File qrCodeFile = new File(filePath);
ImageIO.write(image, "png", qrCodeFile);
System.out.println("二维码生成成功: " + filePath);
} catch (Exception e) {
e.printStackTrace();
}
}
/**
* 测试
*/
public static void main(String[] args) {
QRCodeService qrCodeGenerator = new QRCodeService();
// 要存储在二维码中的文本数据
String text = "https://songzixian.com";
// 二维码的宽度
int width = 300;
// 二维码的高度
int height = 300;
// 二维码存储路径
String filePath = "D:\\data\\qrcode.png";
qrCodeGenerator.generateQRCode(text, width, height, filePath);
}
}
此服务类提供了一个generateQRCode
方法,该方法可以将任意文本(如URL或文本信息)转换为指定大小的二维码图像,并保存至指定路径。
3. 创建条形码生成服务
场景描述: 适用于零售、库存管理、物流追踪等需要快速生成条形码的业务场景。
代码示例与注释:
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.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
/**
* 生成条形图像类
*
* @author songzixian
*/
public class barCodeService {
/**
* 生成条形码图像
*
* @param text 要编码的数据
* @param width 条形码图像宽度
* @param height 条形码图像高度
* @param filePath 文件存储路径
* @return 生成的条形码图像的字节数组
* @throws IOException 当图像写入过程中出现问题时抛出
*/
public void generateBarcode(String text, int width, int height, String filePath) {
try {
// 定义二维码参数
Map<EncodeHintType, Object> hints = new HashMap<>();
// 设置字符编码
hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
// 使用QRCodeWriter生成条形码码矩阵信息
MultiFormatWriter writer = new MultiFormatWriter();
BitMatrix bitMatrix = writer.encode(text, 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) {
barCodeService barcodeGenerator = new barCodeService();
// 要存储在条形码中的数据
String text = "1234567890";
// 条形码的宽度
int width = 200;
// 条形码的高度
int height = 30;
String filePath = "D:\\data\\barCode.png";
barcodeGenerator.generateBarcode(text, width, height, filePath);
}
}
此服务类通过generateBarcode
方法生成条形码,支持将数字或文本信息转换为条形码,非常适合产品编码和库存管理系统。
把上面的代码复制到你的Spring Boot的Service代码中,就成功地在Spring Boot应用中整合了ZXing库,可以生成二维码和条形码了。