java-二维码工具类（QRCodeUtils）

工具类提供了多种生成二维码的方式，用户可以选择使用默认的宽高（300x300），也可以自定义宽度和高度来生成二维码图片。首先，QRCodeUtils类提供了一个静态方法generateQRCode，接受字符串和文件路径作为参数。在这个方法中，使用ZXing库来生成二维码。ZXing是一个流行的开源库，用于生成和解析二维码。首先，创建一个BitMatrix对象来保存二维码的位图表示。然后，使用Mat

Flying_Fish_roe

1859人浏览 · 2024-09-30 14:33:08

Flying_Fish_roe · 2024-09-30 14:33:08 发布

首先，确保你在项目中引入了 zxing 库。可以通过 Maven 引入以下依赖：

<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>core</artifactId>
    <version>3.4.0</version>
</dependency>
<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>javase</artifactId>
    <version>3.4.0</version>
</dependency>

QRCodeUtils 实现代码：

import com.google.zxing.BarcodeFormat;
import com.google.zxing.BinaryBitmap;
import com.google.zxing.DecodeHintType;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatReader;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.common.HybridBinarizer;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.client.j2se.BufferedImageLuminanceSource;
import com.google.zxing.Result;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Path;
import java.util.HashMap;
import java.util.Map;

/**
 * QRCodeUtils 是一个二维码操作工具类，支持二维码生成、保存、解析等功能。
 */
public class QRCodeUtils {

    // 定义二维码图片的默认宽度和高度
    private static final int WIDTH = 300;
    private static final int HEIGHT = 300;

    // 定义二维码图片的格式
    private static final String IMAGE_FORMAT = "png";

    /**
     * 生成二维码并将其保存到指定路径
     *
     * @param content  二维码的内容
     * @param filePath 二维码保存的文件路径
     * @throws Exception 如果二维码生成失败
     */
    public static void generateQRCode(String content, String filePath) throws Exception {
        generateQRCode(content, filePath, WIDTH, HEIGHT);
    }

    /**
     * 生成二维码并将其保存到指定路径，支持自定义宽高
     *
     * @param content  二维码的内容
     * @param filePath 二维码保存的文件路径
     * @param width    二维码的宽度
     * @param height   二维码的高度
     * @throws Exception 如果二维码生成失败
     */
    public static void generateQRCode(String content, String filePath, int width, int height) throws Exception {
        // 设置二维码参数
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H); // 高级别容错
        hints.put(EncodeHintType.MARGIN, 1); // 边距

        // 生成二维码矩阵
        BitMatrix bitMatrix = new MultiFormatWriter().encode(content, BarcodeFormat.QR_CODE, width, height, hints);

        // 将二维码图片保存到指定路径
        Path path = new File(filePath).toPath();
        MatrixToImageWriter.writeToPath(bitMatrix, IMAGE_FORMAT, path);
    }

    /**
     * 生成二维码并返回 BufferedImage 对象
     *
     * @param content 二维码的内容
     * @return BufferedImage 二维码图片
     * @throws Exception 如果二维码生成失败
     */
    public static BufferedImage generateQRCodeImage(String content) throws Exception {
        return generateQRCodeImage(content, WIDTH, HEIGHT);
    }

    /**
     * 生成二维码并返回 BufferedImage 对象，支持自定义宽高
     *
     * @param content 二维码的内容
     * @param width   二维码的宽度
     * @param height  二维码的高度
     * @return BufferedImage 二维码图片
     * @throws Exception 如果二维码生成失败
     */
    public static BufferedImage generateQRCodeImage(String content, int width, int height) throws Exception {
        // 设置二维码参数
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H); // 高级别容错
        hints.put(EncodeHintType.MARGIN, 1); // 边距

        // 生成二维码矩阵
        BitMatrix bitMatrix = new MultiFormatWriter().encode(content, BarcodeFormat.QR_CODE, width, height, hints);

        // 将二维码矩阵转换为 BufferedImage 对象
        return MatrixToImageWriter.toBufferedImage(bitMatrix);
    }

    /**
     * 解析二维码图片，获取其中的内容
     *
     * @param filePath 二维码图片的文件路径
     * @return 二维码的内容
     * @throws Exception 如果二维码解析失败
     */
    public static String decodeQRCode(String filePath) throws Exception {
        File file = new File(filePath);
        BufferedImage bufferedImage = ImageIO.read(file);
        return decodeQRCode(bufferedImage);
    }

    /**
     * 解析二维码图片，获取其中的内容
     *
     * @param bufferedImage 二维码的 BufferedImage 对象
     * @return 二维码的内容
     * @throws Exception 如果二维码解析失败
     */
    public static String decodeQRCode(BufferedImage bufferedImage) throws Exception {
        // 创建 BinaryBitmap 对象
        BufferedImageLuminanceSource luminanceSource = new BufferedImageLuminanceSource(bufferedImage);
        BinaryBitmap binaryBitmap = new BinaryBitmap(new HybridBinarizer(luminanceSource));

        // 设置解码参数
        Map<DecodeHintType, Object> hints = new HashMap<>();
        hints.put(DecodeHintType.CHARACTER_SET, "UTF-8");

        // 解码二维码
        Result result = new MultiFormatReader().decode(binaryBitmap, hints);
        return result.getText();
    }

    /**
     * 保存二维码图片到指定文件路径
     *
     * @param image    BufferedImage 对象
     * @param filePath 保存文件路径
     * @throws IOException 如果保存失败
     */
    public static void saveQRCodeImage(BufferedImage image, String filePath) throws IOException {
        File file = new File(filePath);
        ImageIO.write(image, IMAGE_FORMAT, file);
    }

    public static void main(String[] args) {
        try {
            // 生成二维码
            String content = "https://example.com";
            String filePath = "example_qr_code.png";
            generateQRCode(content, filePath);
            System.out.println("二维码已生成，文件路径: " + filePath);

            // 解析二维码
            String decodedContent = decodeQRCode(filePath);
            System.out.println("二维码内容: " + decodedContent);

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}