使用Java Servlet生成动态二维码

欢迎来到Java学习路线专栏~探索Java中的静态变量与实例变量

---

• ☆* o(≧▽≦)o *☆嗨~我是IT·陈寒
• ✨博客主页：IT·陈寒的博客
• 该系列文章专栏：Java学习路线
• 其他专栏：Java学习路线 Java面试技巧 Java实战项目 AIGC人工智能 数据结构学习
• 文章作者技术和水平有限，如果文中出现错误，希望大家能指正
• 欢迎大家关注！ ❤️

---

在现代互联网时代，二维码广泛应用于各个领域，包括支付、认证、信息传递等。在Web开发中，通过Java Servlet生成动态二维码是一个常见的需求。本文将介绍如何使用Java Servlet结合Google的ZXing库生成动态二维码，并通过Servlet将生成的二维码直接返回给浏览器。

引入ZXing库

首先，确保你的项目中引入了ZXing库。你可以通过Maven在pom.xml文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>com.google.zxinggroupId>
        <artifactId>coreartifactId>
        <version>3.4.0version>
    dependency>
    <dependency>
        <groupId>com.google.zxinggroupId>
        <artifactId>javaseartifactId>
        <version>3.4.0version>
    dependency>
dependencies>

创建QRCodeServlet

package servlet;

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;

import javax.imageio.ImageIO;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.awt.image.BufferedImage;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

@WebServlet("/qrcode")
public class QRCodeServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // 获取需要生成二维码的数据，这里可以通过请求参数或其他方式获取
        String data = "Hello, QR Code!";
        System.out.println(data + ".....");

        // 生成二维码的 BufferedImage
        BufferedImage image = generateQRCode(data, 150, 150);

        // 设置响应的内容类型为图片
        response.setContentType("image/png");

        // 将二维码写入 HttpServletResponse 的输出流
        assert image != null;
        ImageIO.write(image, "png", response.getOutputStream());
    }

    private BufferedImage generateQRCode(String data, int width, int height) {
        try {

            System.out.println("1..........");
            // 设置二维码参数
            Map<EncodeHintType, Object> hintMap = new HashMap<>();
            hintMap.put(EncodeHintType.CHARACTER_SET, "UTF-8");
            hintMap.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.L);

            // 创建位矩阵(BitMatrix)来表示二维码
            BitMatrix bitMatrix = new MultiFormatWriter().encode(data, BarcodeFormat.QR_CODE, width, height, hintMap);

            // 将位矩阵渲染成二维码图片
            BufferedImage bufferedImage = MatrixToImageWriter.toBufferedImage(bitMatrix);

            // 返回生成的二维码图片
            return bufferedImage;
        } catch (Exception e) {
            System.err.println("Error generating QR Code: " + e.getMessage());
            return null;
        }
    }
}

在上述代码中，我们创建了一个名为QRCodeServlet的Servlet，用于处理客户端的请求。当浏览器访问/qrcode路径时，该Servlet将生成一个包含指定数据的二维码图片，并将其以PNG格式写入HttpServletResponse的输出流中。

部署到Servlet容器

确保你的Java Web项目已经正确部署到Servlet容器中，例如Tomcat。启动Tomcat后，你可以通过访问http://localhost:8080/your_project_context/qrcode来查看生成的二维码图片。

拓展功能

1. 动态生成二维码内容

你可以通过获取请求参数等方式，使生成的二维码内容更具动态性。例如，从请求参数中获取文本信息：

String data = request.getParameter("text");

2. 调整二维码尺寸

可以根据需要调整生成的二维码图片的尺寸，通过修改width和height参数。

3. 错误修正级别

通过修改hintMap.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.L);中的ErrorCorrectionLevel，可以调整二维码的错误修正级别，包括L、M、Q和H。级别越高，二维码越复杂，但对损坏的容忍度也越高。

4. 日志输出

在实际项目中，建议使用日志框架输出日志，而不是直接在控制台打印。你可以集成类似Log4j或SLF4J的日志框架，以便更好地管理和监控日志信息。

结语

通过上述步骤，你可以轻松在Java Web项目中生成动态二维码，并在浏览器中显示。这为诸如会员卡、活动邀请等场景提供了便捷的解决方案。希望这篇文章对你理解和应用Java生成二维码有所帮助。

---

结尾 ❤️ 感谢您的支持和鼓励！
您可能感兴趣的内容：

• 【Java面试技巧】Java面试八股文 - 掌握面试必备知识（目录篇）
• 【Java学习路线】2023年完整版Java学习路线图
• 【AIGC人工智能】Chat GPT是什么，初学者怎么使用Chat GPT，需要注意些什么
• 【Java实战项目】SpringBoot+SSM实战：打造高效便捷的企业级Java外卖订购系统
• 【数据结构学习】从零起步：学习数据结构的完整路径