Spring Boot ：生成二维码

时间：2025-02-21 08:11:50

二维码（QR Code）是一种方便的编码方式，被广泛用于各种场景，如支付、信息分享等。在 Spring Boot 项目中，我们可以使用 ZXing（Zebra Crossing）库来生成二维码。本文将介绍如何在 Spring Boot 项目中实现二维码的生成，包括引入依赖、创建服务类，并提供详细的代码示例。

1. 引入依赖

首先，在 Spring Boot 项目的 文件中引入 ZXing 相关的依赖：

<dependency>
    <groupId></groupId>
    <artifactId>core</artifactId>
    <version>3.5.3</version>
</dependency>
<dependency>
    <groupId></groupId>
    <artifactId>javase</artifactId>
    <version>3.5.3</version>
</dependency>

2. 创建二维码生成服务类

创建一个服务类 QRCodeGenerationService，用于生成二维码图像：

import ;
import ;
import ;
import ;
import .;
import ;
import ;

import ;
import ;
import ;
import ;
import ;
import ;
import ;

@Service
public class QRCodeGenerationService {

    private static final String CHARSET = "UTF-8";
    private static final int QR_CODE_WIDTH = 300;
    private static final int QR_CODE_HEIGHT = 300;
    private static final String TEMP_DIR = ("");

    public byte[] generateQRCodeImage(String text) throws WriterException, IOException {
        QRCodeWriter qrCodeWriter = new QRCodeWriter();
        Map<EncodeHintType, Object> hintMap = new HashMap<>();
        (EncodeHintType.CHARACTER_SET, CHARSET);
        BitMatrix bitMatrix = (text, BarcodeFormat.QR_CODE, QR_CODE_WIDTH, QR_CODE_HEIGHT, hintMap);
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        (bitMatrix, "PNG", outputStream);
        return ();
    }

    public String saveQRCodeImageToTempFile(String text) throws WriterException, IOException {
        QRCodeWriter qrCodeWriter = new QRCodeWriter();
        Map<EncodeHintType, Object> hintMap = new HashMap<>();
        (EncodeHintType.CHARACTER_SET, CHARSET);
        BitMatrix bitMatrix = (text, BarcodeFormat.QR_CODE, QR_CODE_WIDTH, QR_CODE_HEIGHT, hintMap);
        Path tempFilePath = ((TEMP_DIR), "qr_", ".png");
        (bitMatrix, "PNG", tempFilePath);
        return ();
    }
}

3. 创建控制器类

创建一个控制器类 QRCodeProcessingController，提供生成二维码的接口：

import ;
import ;
import ;
import ;
import ;
import ;
import ;

import ;

@RestController
public class QRCodeProcessingController {

    @Autowired
    private QRCodeGenerationService qrCodeGenerationService;

    @PostMapping("/generateQRCode")
    public ResponseEntity<String> generateQRCode(@RequestParam String content) {
        try {
            String qrCodeUrl = (content);
            return new ResponseEntity<>(qrCodeUrl, );
        } catch (IOException | WriterException e) {
            ();
            return new ResponseEntity<>((), HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }
}

完整代码结构

src
├── main
│   ├── java
│   │   └── com
│   │       └── example
│   │           └── qrcode
│   │               ├── controller
│   │               │   └── 
│   │               ├── service
│   │               │   ├── 
│   │               │   └── 
│   │               └── 
│   └── resources
│       └──

4. 测试生成二维码

使用前端界面输入文本并生成二维码。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Generate QR Code</title>
</head>
<body>
    <textarea id="textInput" rows="4" cols="50" placeholder="Enter text here"></textarea><br>
    <button onclick="generateQRCode()">Generate QR Code</button><br>
    <img id="qrCodeImage" src="" alt="QR Code">
    
    <script>
        function generateQRCode() {
            var text = ("textInput").value;
            var xhr = new XMLHttpRequest();
            ("POST", "http://localhost:8080/generateQRCode", true);
            ("Content-Type", "application/x-www-form-urlencoded");
             = function() {
                if ( == 4 &&  == 200) {
                    var qrCodeUrl = ;
                    ("qrCodeImage").src = qrCodeUrl;
                }
            };
            ("content=" + encodeURIComponent(text));
        }
</script>
</body>
</html>

总结

通过本文，我们成功地在 Spring Boot 项目中集成了 ZXing 库，并实现了生成二维码的功能。我们通过引入依赖、创建二维码生成服务类和控制器类，实现了二维码图像的生成和展示。这种方式可以帮助我们在各种应用场景中生成二维码，方便信息的快速传递和分享。

相关文章