在数字化时代，二维码作为信息快速传递的桥梁，广泛应用于各种场景。从支付、身份验证到产品追溯，二维码的身影无处不在。而作为一名开发者，掌握如何在应用中动态生成二维码成为了一项必备技能。今天，我们就来深入探索如何使用Spring Boot框架，结合Google的ZXing库，实现一个能够生成随机内容二维码的Web服务。
起步：搭建Spring Boot环境
首先，确保你的开发环境已安装Java和Maven或Gradle。接着，通过Spring Initializr（https://start.spring.io/）快速生成一个Spring Boot项目。在依赖选择中，除了Spring Web外，我们还需要添加spring-boot-starter-thymeleaf用于前端页面渲染（如果你打算通过Web界面展示二维码），但本例将侧重于后端生成逻辑。
引入ZXing库
在pom.xml中添加ZXing的依赖，ZXing是一个开源的Java库，用于处理条形码和二维码的生成与解析。
xml
com.google.zxing
core
3.4.1
com.google.zxing
javase
3.4.1
编写二维码生成逻辑
在Spring Boot项目中，创建一个服务类来封装二维码生成的逻辑。这里我们使用ZXing的QRCodeWriter类。
java
import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.WriterException;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.HashMap;
import java.util.Map;
@Service
public class QRCodeGeneratorService {
public byte[] generateQRCode(String text) throws WriterException, IOException {
int width = 300;
int height = 300;
Map<EncodeHintType, Object> hints = new HashMap<>();
hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
BitMatrix bitMatrix = new MultiFormatWriter().encode(text, BarcodeFormat.QR_CODE, width, height, hints);
Path path = Files.createTempFile("qr-code-", ".png");
MatrixToImageWriter.writeToPath(bitMatrix, "PNG", path);
// 假设你希望直接返回图片字节流，这里可改为读取文件到字节数组
// 这里简化处理，实际应用中可能需要不同的返回方式
return Files.readAllBytes(path);
}
}
注意：上述代码直接生成文件并返回文件内容的字节流作为示例。在实际应用中，你可能需要将二维码直接写入HTTP响应中，或者将字节流传递给前端进行显示。
整合到Web层
接下来，在Controller中调用这个服务，提供一个RESTful接口供外部调用。
java
@RestController
public class QRCodeController {
@Autowired
private QRCodeGeneratorService qrCodeGeneratorService;
@GetMapping("/generate-qrcode")
public ResponseEntity<byte[]> generateQRCode(@RequestParam String text) {
try {
byte[] qrCodeImage = qrCodeGeneratorService.generateQRCode(text);
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.IMAGE_PNG);
return ResponseEntity.ok()
.headers(headers)
.body(qrCodeImage);
} catch (Exception e) {
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
}
}
}
至此，我们已经完成了使用Spring Boot结合ZXing库生成随机二维码的基本流程。你可以通过访问/generate-qrcode?text=你的内容来测试你的API，并看到生成的二维码图片。这只是起点，你还可以进一步探索如何优化存储、提升性能、增加安全性等高级话题。
