Java集成Zxing和OpenCV实现二维码生成与识别工具类

于 2025-04-22 13:44:23 发布
阅读量327 收藏 5
点赞数 4
分类专栏： JAVA Spring-Boot 文章标签： java opencv
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45626288/article/details/147413331
版权

Java集成Zxing和OpenCV实现二维码生成与识别工具类

本文将介绍如何使用Java集成Zxing和OpenCV库，实现二维码的生成和识别功能。识别方法支持多种输入形式，包括File对象、文件路径和Base64编码。

一、环境准备

  1. 添加Maven依赖
<dependencies>
    <!-- Zxing核心库 -->
    <dependency>
        <groupId>com.google.zxing</groupId>
        <artifactId>core</artifactId>
        <version>3.5.2</version>
    </dependency>
    <dependency>
        <groupId>com.google.zxing</groupId>
        <artifactId>javase</artifactId>
        <version>3.5.2</version>
    </dependency>
    
    <!-- OpenCV库 -->
    <dependency>
        <groupId>org.openpnp</groupId>
        <artifactId>opencv</artifactId>
        <version>4.5.5-1</version>
    </dependency>
    
    <!-- 其他工具类 -->
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.11.0</version>
    </dependency>
</dependencies>
  1. OpenCV库加载

在使用OpenCV功能前，需要先加载本地库：

static {
    // 加载OpenCV本地库 
    nu.pattern.OpenCV.loadLocally();
}

二、二维码生成工具类

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.WriterException;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.QRCodeWriter;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
 
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;
import java.util.Base64;
import java.util.HashMap;
import java.util.Map;
 
public class QRCodeGenerator {
    
    private static final int DEFAULT_WIDTH = 300;
    private static final int DEFAULT_HEIGHT = 300;
    private static final String DEFAULT_FORMAT = "png";
    
    /
     * 生成二维码图片 
     * @param content 二维码内容 
     * @param width 宽度 
     * @param height 高度 
     * @return BufferedImage对象 
     */
    public static BufferedImage generateQRCodeImage(String content, int width, int height) throws WriterException {
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H);
        hints.put(EncodeHintType.MARGIN, 1);
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        
        QRCodeWriter qrCodeWriter = new QRCodeWriter();
        BitMatrix bitMatrix = qrCodeWriter.encode(content, BarcodeFormat.QR_CODE, width, height, hints);
        
        return MatrixToImageWriter.toBufferedImage(bitMatrix);
    }
    
    /
     * 生成二维码并保存到文件 
     * @param content 二维码内容 
     * @param width 宽度 
     * @param height 高度 
     * @param filePath 文件路径 
     */
    public static void generateQRCodeToFile(String content, int width, int height, String filePath) 
            throws WriterException, IOException {
        BufferedImage image = generateQRCodeImage(content, width, height);
        ImageIO.write(image, DEFAULT_FORMAT, new File(filePath));
    }
    
    /
     * 生成二维码并返回Base64编码 
     * @param content 二维码内容 
     * @param width 宽度 
     * @param height 高度 
     * @return Base64编码字符串 
     */
    public static String generateQRCodeToBase64(String content, int width, int height) 
            throws WriterException, IOException {
        BufferedImage image = generateQRCodeImage(content, width, height);
        ByteArrayOutputStream os = new ByteArrayOutputStream();
        ImageIO.write(image, DEFAULT_FORMAT, os);
        return Base64.getEncoder().encodeToString(os.toByteArray());
    }
}

三、二维码识别工具类

import com.google.zxing.*;
import com.google.zxing.client.j2se.BufferedImageLuminanceSource;
import com.google.zxing.common.HybridBinarizer;
import org.opencv.core.*;
import org.opencv.imgcodecs.Imgcodecs;
import org.opencv.imgproc.Imgproc;
 
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.IOException;
import java.util.Base64;
import java.util.EnumMap;
import java.util.Map;
 
public class QRCodeRecognizer {
    
    static {
        // 加载OpenCV本地库 
        nu.pattern.OpenCV.loadLocally();
    }
    
    /
     * 识别二维码内容 - 通过File对象 
     * @param file 二维码图片文件 
     * @return 识别结果 
     */
    public static String recognizeQRCode(File file) throws IOException, NotFoundException {
        BufferedImage image = ImageIO.read(file);
        return decodeQRCode(image);
    }
    
    /
     * 识别二维码内容 - 通过文件路径 
     * @param filePath 二维码图片路径 
     * @return 识别结果 
     */
    public static String recognizeQRCode(String filePath) throws IOException, NotFoundException {
        // 使用OpenCV预处理图像提高识别率 
        Mat image = Imgcodecs.imread(filePath);
        if (image.empty()) {
            throw new IOException("无法读取图像文件: " + filePath);
        }
        
        // 转换为灰度图 
        Mat gray = new Mat();
        Imgproc.cvtColor(image, gray, Imgproc.COLOR_BGR2GRAY);
        
        // 二值化处理 
        Mat binary = new Mat();
        Imgproc.threshold(gray, binary, 0, 255, Imgproc.THRESH_BINARY | Imgproc.THRESH_OTSU);
        
        // 转换为BufferedImage 
        BufferedImage bufferedImage = matToBufferedImage(binary);
        return decodeQRCode(bufferedImage);
    }
    
    /
     * 识别二维码内容 - 通过Base64编码 
     * @param base64Str 二维码图片的Base64编码 
     * @return 识别结果 
     */
    public static String recognizeQRCodeFromBase64(String base64Str) throws IOException, NotFoundException {
        byte[] imageBytes = Base64.getDecoder().decode(base64Str);
        ByteArrayInputStream bis = new ByteArrayInputStream(imageBytes);
        BufferedImage image = ImageIO.read(bis);
        return decodeQRCode(image);
    }
    
    /
     * 核心解码方法 
     */
    private static String decodeQRCode(BufferedImage image) throws NotFoundException {
        LuminanceSource source = new BufferedImageLuminanceSource(image);
        BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source));
        
        Map<DecodeHintType, Object> hints = new EnumMap<>(DecodeHintType.class);
        hints.put(DecodeHintType.TRY_HARDER, Boolean.TRUE);
        hints.put(DecodeHintType.CHARACTER_SET, "UTF-8");
        
        Result result = new MultiFormatReader().decode(bitmap, hints);
        return result.getText();
    }
    
    /
     * 将OpenCV的Mat对象转换为BufferedImage 
     */
    private static BufferedImage matToBufferedImage(Mat mat) {
        int type = BufferedImage.TYPE_BYTE_GRAY;
        if (mat.channels() > 1) {
            type = BufferedImage.TYPE_3BYTE_BGR;
        }
        
        byte[] data = new byte[mat.cols() * mat.rows() * (int)mat.elemSize()];
        mat.get(0, 0, data);
        
        BufferedImage image = new BufferedImage(mat.cols(), mat.rows(), type);
        image.getRaster().setDataElements(0, 0, mat.cols(), mat.rows(), data);
        
        return image;
    }
}

四、使用示例

public class QRCodeExample {
    public static void main(String[] args) {
        try {
            // 1. 生成二维码 
            String content = "https://www.example.com";
            String filePath = "qrcode.png";
            
            // 生成并保存二维码 
            QRCodeGenerator.generateQRCodeToFile(content, 300, 300, filePath);
            System.out.println("二维码已生成到: " + filePath);
            
            // 2. 识别二维码 - 通过File对象 
            File qrFile = new File(filePath);
            String decodedContent1 = QRCodeRecognizer.recognizeQRCode(qrFile);
            System.out.println("识别结果(File): " + decodedContent1);
            
            // 3. 识别二维码 - 通过文件路径 
            String decodedContent2 = QRCodeRecognizer.recognizeQRCode(filePath);
            System.out.println("识别结果(文件路径): " + decodedContent2);
            
            // 4. 识别二维码 - 通过Base64 
            String base64 = QRCodeGenerator.generateQRCodeToBase64(content, 300, 300);
            String decodedContent3 = QRCodeRecognizer.recognizeQRCodeFromBase64(base64);
            System.out.println("识别结果(Base64): " + decodedContent3);
            
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

五、关键点说明

  1. OpenCV预处理：在识别二维码时，使用OpenCV对图像进行灰度化和二值化处理，可以显著提高识别率，特别是对低质量或模糊的二维码图像。

  2. 多输入支持：识别方法支持三种输入形式：

    • File对象：直接读取文件
    • 文件路径：使用OpenCV读取并预处理
    • Base64编码：适用于网络传输的场景

  3. 错误处理：方法会抛出IOException和NotFoundException，调用方需要处理这些异常。

  4. 性能优化：

    • 使用TRY_HARDER提示让解码器更努力尝试解码
    • 指定字符集为UTF-8确保中文内容正确识别
    • OpenCV的预处理可以有效提高识别率

六、扩展建议

  1. 添加Logo：可以在生成二维码时添加中心Logo，增强品牌识别度。

  2. 颜色定制：修改生成方法支持自定义前景色和背景色。

  3. 批量处理：扩展工具类支持批量生成和识别二维码。

  4. 性能监控：添加耗时统计和性能监控功能。

这个工具类结合了Zxing的高效二维码生成/识别能力和OpenCV强大的图像处理能力，可以满足大多数Java项目中二维码处理的需求。

SpringBoot生成和解析二维码完整工具类分享（提供Gitee源码）
黄团团的个人博客
08-22 1515
在日常的开发工作当中可能需要实现一个二维码小功能，我参考了网上很多关于SpringBoot生成二维码的教程，最终还是自己封装了一套完整生成二维码的工具类，可以支持基础的黑白二维码、带颜色的二维码、带Logo的二维码、带颜色和Logo的二维码和解析二维码，一共4种非常的全面了，可以生成具体的二维码文件或返回Base64，都是博主自己手写封装好的，这边免费开源给大家一键使用！只求大家一个免费的三连支持！
Java生成二维码快速上手
筱白爱学习！的博客
08-08 508
本文主要介绍使用Java生成二维码,可以实现自定义二维码名称以及二维码内容，也可以设置生成二维码的长和宽，根据测试结论内容越多从而生成二维码的密度越高，同时优化了二维码的纠错能力以及防止乱码，也优化了二维码的留白问题，可实现二维码四周无留白或者留白的间距，废话不多说，接下来看一下如何实现的吧！
SpringBoot整合ZXing生成和解析二维码详解含源码（值得珍藏）
a342874650的专栏
01-30 1269
在当今的数字化时代，二维码已成为信息传递的普遍手段，其应用范围极为广泛，不仅出现在产品标签、活动宣传单上，还渗透到电子支付等各个领域。本文将指导您如何在Spring Boot应用程序中结合使用ZXing库，以便高效地生成和解析二维码。
java实现二维码识别(Zxing)
王家胜的博客
07-01 1563
要求：系统Centos7.x 第一步安装Cmake yum install -y gcc gcc-c++ wget wget https://cmake.org/files/v3.14/cmake-3.14.0.tar.gz tar -zxvf cmake-3.14.0.tar.gz cd cmake-3.14.0 ./bootstrap gmake gmake install 第二步编译...
树莓派+OpenCV+Arduino实现二维码与颜色识别检测及物料抓取总结
热门推荐
.
02-01 2万+
1. 系统总体设计和分析 系统总体分为硬件设计和软件设计,硬件设计就是基于树莓派2代B型和Arduino的硬件基础平台搭建，能够适应小型、灵活的现实需求，并为软件设计提供可观的计算能力承载和算法改进空间。软件设计就是在嵌入式Arduino上构建控制系统，用来控制物料车基本的移动，机器臂的抓取，摄像头的位置等操作，而在树莓派上构建软件开发环境，在OpenCV框架下，通过C++语言实现二维码的检测和...
java生成、识别条形码和二维码
土味儿
06-10 2041
使用zxing开源库BitMatrix可以生成、识别条形码和二维码依赖
OpenCvSharp+ZXing条形码识别
最新发布
gitblog_09727的博客
10-17 310
OpenCvSharp+ZXing条形码识别 【下载地址】OpenCvSharpZXing条形码识别 OpenCvSharp+ZXing条形码识别本项目是基于Visual Studio 2015和C#语言开发的一个实用工具，实现了利用OpenCvSharp库进行图像处理，结合ZXing（“Zebra Crossing”）...
java操作二维码生成与已有图片合成与解析+pc摄像头抓拍
菜鸟零号 kungfu~peng
01-14 890
java操作二维码生成与已有图片合成与解析+pc摄像头抓拍 效果 pom中依赖 <dependency> <groupId>com.google.zxing</groupId> <artifactId>core</artifactId> <version&gt...
Win10 x64环境下基于VS2017和cmake-gui配置使用zxing以及opencv，并实现data metrix码的简单检测
heartinsharp的博客
06-29 2337
Win10 x64环境下基于VS2017和cmake-gui配置使用zxing以及opencv，并实现data metrix码的简单检测
zxing C++ 生成识别二维码库 32位/64位静态编译库
03-04
在C++开发中，使用ZXing库可以方便地集成二维码的生成和识别功能。本资源提供了ZXing库的32位和64位静态编译库版本，适用于Visual Studio环境。 首先，让我们深入了解一下ZXing库的核心功能和工作原理。ZXing，也...
使用zxing识别一幅包含多个二维码的图片
08-08
总之，ZXing是一个强大的条码和二维码处理工具，通过学习和使用，开发者能够轻松地集成二维码识别功能，提升应用程序的实用性和用户体验。对于涉及大量二维码处理的项目，ZXing无疑是首选的解决方案之一。
基于MFC二维码打印工具
08-30
《基于MFC的二维码生成与打印工具详解》 在信息技术高速发展的今天，二维码作为一种便捷的信息载体，被广泛应用于各种场景，如产品标识、网址跳转、电子票务等。而利用编程技术生成并打印二维码，可以进一步提升...
opencv+zbar实现摄像头二维码识别
01-20
本项目是关于如何利用OpenCV库结合ZBar工具，实现在Windows环境下（使用Visual Studio 2010）通过摄像头捕获并识别二维码，并将识别到的Unicode编码转换为中文的过程。 OpenCV（Open Source Computer Vision ...
在Spring Boot项目中连接SQL Server的几种方式
weixin_45626288的博客
06-09 2万+
连接SQL Server是许多Spring Boot项目中常见的需求之一。本篇博客将介绍在Spring Boot项目中配置连接SQL Server的几种方式，并提供相应的依赖和YAML配置示例，帮助开发者轻松地实现数据库连接。
Redission 解锁异常：attempt to unlock lock, not locked by current thread by node id
weixin_45626288的博客
08-12 1万+
Redission是一个流行的分布式锁框架，但有时候在使用过程中，我们可能会遇到一个异常，即：“attempt to unlock lock, not locked by current thread by node id”。总之，当我们在使用Redission分布式锁时，遇到解锁异常时，可以考虑以上的原因和解决方案，以确保我们的分布式锁机制能够正常运行，保护共享资源的安全性。：当一个线程或节点已经获得了该锁，而另一个线程或节点尝试解锁时，就会出现这个异常。：如果锁已经超时自动释放，就不需要再手动解锁。
Java 报错 java.util.ConcurrentModificationException: null 的原因和解决方案
weixin_45626288的博客
07-14 1万+
在 Java 编程中，当使用迭代器或者增强型 for 循环遍历集合或者映射时，有时可能会遇到 java.util.ConcurrentModificationException: null 的异常。这个异常通常在多线程环境下出现，意味着在迭代过程中，集合或者映射的结构发生了变化。本篇博客将为您解析这个异常的原因，并提供相应的解决方案。
nested exception is java.sql.SQLException: connection disabled
weixin_45626288的博客
06-29 1万+
当使用Spring Boot连接数据库时，出现"nested exception is java.sql.SQLException: connection disabled"异常可能是由于数据库配置错误、数据库服务器故障、连接池配置问题或数据库访问权限不足引起的。数据库权限问题：数据库用户可能没有足够的权限来连接数据库或执行所需的操作。验证数据库权限：确保数据库用户具有足够的权限来连接数据库和执行所需的操作。检查数据库连接配置：确保数据库连接的URL、用户名和密码正确配置，并与实际数据库的凭据匹配。
JAVA :Shutdown Signal: channel error； protocol method: #method＜channel.close＞(reply-code=406, reply
weixin_45626288的博客
07-14 9296
在项目开发中，有时可能会遇到 “Shutdown Signal: channel error;protocol method: #method(reply-code=406, reply-text=PRECONDITION_FAILED - unknown delivery tag 0, class-id=60, method-id=80)” 这样的报错信息。该报错通常与消息队列相关，可能会出现在使用 RabbitMQ 等消息中间件时。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

LOVE_DDZ

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值