zxing(二维码生成与读取)

1. maven

        <dependency><groupId>com.google.zxing</groupId><artifactId>core</artifactId><version>3.3.0</version></dependency><!--        如果是 web 应用添加--><dependency><groupId>com.google.zxing</groupId><artifactId>javase</artifactId><version>3.3.0</version></dependency>

2. API

1. 基础API(部分)

2.2 常量

类	描述	常量	描述	图例与示例
BarcodeFormat	条码类型	AZTEC	阿兹特克条形码
		CODABAR	自检条码，用于读取印刷形式的条码，特别是使用点阵打印机印刷的条码。它的典型用途包含 Fed-Ex 包裹和血库单
		CODE_39	第一个同时使用数字和字母的条码。它是一种可变长度的条码，最多可同时对 43 个字母数字字符进行编码。它最常用于军事和汽车行业。
		CODE_93	Code 93 条码比 Code 39 条码更新、更安全且更紧凑，能读取字母和数字。它用于军事和汽车领域，还被加拿大邮政用来对特殊投递信息进行编码。
		CODE_128	密度最高的一款条码，也是在潜在信息存储方面功能最全的一维条码。它可以解码全部128 ASCII 字符
		DATA_MATRIX	二维条码
		EAN_8	国际物品编码协会制 定的一种商品用条码，EAN-8 条码是 EAN-13 条码的压缩版 EAN_8: 8位数字    EAN_13: 13位数字
		EAN_13
		ITF	交叉二五条码
		MAXICODE		没有编码器
		PDF_417	一种堆叠式二维条码
		QR_CODE	二维码
		RSS_14		没有编码器
		RSS_EXPANDED		没有编码器
		UPC_A	由 12 位数字组成
		UPC_E	UPC-E 是标准尺寸的 UPC-A 数字条码的压缩版
		UPC_EAN_EXTENSION		没有编码器
EncodeHintType	编码时的额外参数	ERROR_CORRECTION	容错率，指定容错等级，例如二维码中使用的ErrorCorrectionLevel, Aztec使用Integer
		CHARACTER_SET	编码集
		DATA_MATRIX_SHAPE	指定生成的数据矩阵的形状，类型为SymbolShapeHint
		MIN_SIZE	最小数量
		MAX_SIZE	最大数量
		MARGIN	边距
		PDF417_COMPACT	指定是否使用PDF417紧凑模式, 类型Boolean
		PDF417_COMPACTION	指定PDF417的紧凑类型
		PDF417_DIMENSIONS	指定PDF417的最大最小行列数
		AZTEC_LAYERS	AZTEC编码层数
		QR_VERSION	指定二维码版本，版本越高越复杂，反而不容易解析
DecodeHintType	解码时的额外参数	OTHER
		PURE_BARCODE	Boolean类型，指定图片是一个纯粹的二维码
		POSSIBLE_FORMATS	可能的编码格式，List类型
		CHARACTER_SET	编码字符集，通常指定UTF-8
		TRY_HARDER	花更多的时间用于寻找图上的编码，优化准确性，但不优化速度，Boolean类型
		ALLOWED_LENGTHS	允许的编码数据长度 - 拒绝多余的数据。不懂这是什么，int[]类型
		ASSUME_CODE_39_CHECK_DIGIT	CODE 39 使用
		ASSUME_GS1	使用GS1编码来解析
		RETURN_CODABAR_START_END	CODABAR编码使用
		NEED_RESULT_POINT_CALLBACK	当解析到可能的结束点时进行回调  ResultPointCallback
		ALLOWED_EAN_EXTENSIONS	允许EAN或UPC编码有额外的长度int[]
ErrorCorrectionLevel	容错率，指定容错等级	L	1
		M	0
		Q	3
		H	2
SymbolShapeHint	数据矩阵的形状	FORCE_NONE	无
		FORCE_SQUARE	正方形
		FORCE_RECTANGLE	长方形
MatrixToImageConfig	条码颜色	BLACK	黑色
		WHITE	白色

3. 示例

3.1 二维码生成

        MultiFormatWriter qrCodeWriter=new MultiFormatWriter();Map<EncodeHintType, Object> hints = new HashMap<>();hints.put(EncodeHintType.CHARACTER_SET, "utf-8");hints.put(EncodeHintType.MARGIN,1);   //先设置margin为1BitMatrix bitMatrix = qrCodeWriter.encode("https://www.baidu.com", BarcodeFormat.QR_CODE, 500, 500,hints);Path path = FileSystems.getDefault().getPath("D:\\demo\\zxing\\"+System.currentTimeMillis()+"—QR_CODE.png");MatrixToImageWriter.writeToPath(bitMatrix, "PNG", path,new MatrixToImageConfig( -100000,-1777216));

3.2 二维码解码

        BufferedImage image = ImageIO.read(new File("D:\\demo\\zxing\\1592875410059—QR_CODE_1.png"));LuminanceSource luminanceSource = new BufferedImageLuminanceSource(image);Binarizer binarizer = new HybridBinarizer(luminanceSource);BinaryBitmap binaryBitmap = new BinaryBitmap(binarizer);Map<DecodeHintType, Object> hints = new HashMap<>();hints.put(DecodeHintType.CHARACTER_SET, "utf-8");hints.put(DecodeHintType.TRY_HARDER, Boolean.TRUE);hints.put(DecodeHintType.POSSIBLE_FORMATS, BarcodeFormat.QR_CODE);Result result = new QRCodeReader().decode(binaryBitmap, hints);System.out.println(result.getText());

3.3 带loge,背景图片及文字的二维码工具类

package com.example.project.demo;import com.google.zxing.*;
import com.google.zxing.client.j2se.MatrixToImageWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
import org.apache.commons.lang3.StringUtils;
import javax.imageio.ImageIO;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.*;/*** 二维码工具类*/
public class BarcodeUtils {private static final int QRCOLOR = 0xFF000000; // 二维码颜色 默认是黑色private static final int BGWHITE = 0xFFFFFFFF; // 背景颜色private static final int WIDTH = 215; // 二维码宽private static final int HEIGHT = 215; // 二维码高private static final int WORDHEIGHT = 235; // 加文字二维码高/*** 用于设置QR二维码参数*/private static Map<EncodeHintType, Object> hints = new HashMap<EncodeHintType, Object>() {private static final long serialVersionUID = 1L;{// 设置QR二维码的纠错级别（H为最高级别）具体级别信息put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H);// 设置编码方式put(EncodeHintType.CHARACTER_SET, "utf-8");put(EncodeHintType.MARGIN, 0);}};/*** 设置 Graphics2D 属性  （抗锯齿）** @param graphics2D*/private static void setGraphics2D(Graphics2D graphics2D) {graphics2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);graphics2D.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL, RenderingHints.VALUE_STROKE_DEFAULT);Stroke s = new BasicStroke(1, BasicStroke.CAP_ROUND, BasicStroke.JOIN_MITER);graphics2D.setStroke(s);}/*** 生成二维码图片存储到filePath中** @param content  二维码内容* @param filePath 成二维码图片保存路径* @return*/public static boolean createImg(String content, String filePath) {boolean flag = false;try {MultiFormatWriter multiFormatWriter = new MultiFormatWriter();BitMatrix bitMatrix = multiFormatWriter.encode(content, BarcodeFormat.QR_CODE, WIDTH, HEIGHT, hints);// 图片输出路径String code = content.split("=")[1]; // 设备编号File file = new File(filePath + "//PSD" + code + ".jpg");if (!file.exists()) {// 如果文件夹不存在则创建file.mkdirs();}// 输出二维码图片到文件夹MatrixToImageWriter.writeToFile(bitMatrix, "jpg", file);flag = true;} catch (IOException e) {e.printStackTrace();} catch (Exception e) {e.printStackTrace();}return flag;}/*** 把带logo的二维码下面加上文字** @param image* @param words* @return*/private static BufferedImage insertWords(BufferedImage image, String words) {// 新的图片，把带logo的二维码下面加上文字if (StringUtils.isNotEmpty(words)) {//创建一个带透明色的BufferedImage对象BufferedImage outImage = new BufferedImage(WIDTH, WORDHEIGHT, BufferedImage.TYPE_INT_ARGB);Graphics2D outg = outImage.createGraphics();setGraphics2D(outg);// 画二维码到新的面板outg.drawImage(image, 0, 0, image.getWidth(), image.getHeight(), null);// 画文字到新的面板Color color = new Color(183, 183, 183);outg.setColor(color);// 字体、字型、字号outg.setFont(new Font("微软雅黑", Font.PLAIN, 18));//文字长度int strWidth = outg.getFontMetrics().stringWidth(words);//总长度减去文字长度的一半  （居中显示）int wordStartX = (WIDTH - strWidth) / 2;//height + (outImage.getHeight() - height) / 2 + 12int wordStartY = HEIGHT + 10;// 画文字outg.drawString(words, wordStartX, wordStartY);outg.dispose();outImage.flush();return outImage;}return null;}/*** @param logoFile loge图片的路径* @param bgFile   背景图片的路径* @param codeFile 图片输出路径* @param qrUrl    二维码内容* @param words    二维码下面的文字* @description 生成带logo的二维码图片 二维码下面带文字*/public static void drawLogoQRCode(File logoFile, File bgFile, File codeFile, String qrUrl, String words) {try {MultiFormatWriter multiFormatWriter = new MultiFormatWriter();// 参数顺序分别为：编码内容，编码类型，生成图片宽度，生成图片高度，设置参数BitMatrix bm = multiFormatWriter.encode(qrUrl, BarcodeFormat.QR_CODE, WIDTH, HEIGHT, hints);BufferedImage image = new BufferedImage(WIDTH, HEIGHT, BufferedImage.TYPE_INT_RGB);// 开始利用二维码数据创建Bitmap图片，分别设为黑（0xFFFFFFFF）白（0xFF000000）两色for (int x = 0; x < WIDTH; x++) {for (int y = 0; y < HEIGHT; y++) {image.setRGB(x, y, bm.get(x, y) ? QRCOLOR : BGWHITE);}}//把logo画到二维码上面if (Objects.nonNull(logoFile) && logoFile.exists()) {// 构建绘图对象Graphics2D g = image.createGraphics();setGraphics2D(g);// 读取Logo图片BufferedImage logo = ImageIO.read(logoFile);// 开始绘制logo图片 等比缩放：（width * 2 / 10 height * 2 / 10）不需缩放直接使用图片宽高//width * 2 / 5 height * 2 / 5  logo绘制在中心点位置g.drawImage(logo, WIDTH * 2 / 5, HEIGHT * 2 / 5, logo.getWidth(), logo.getHeight(), null);g.dispose();logo.flush();}// 新的图片，把带logo的二维码下面加上文字image = insertWords(image, words);image.flush();ImageIO.write(image, "png", codeFile);} catch (Exception e) {e.printStackTrace();}}public static void main(String[] args) {//logoFile logoFile = new File("D:\\demo\\zxing\\1592875410059—QR_CODE_1.png");//背景图片File bgFile = new File("D:\\demo\\zxing\\1.jpg");//生成图片File qrCodeFile = new File("D:\\demo\\zxing\\12345.png");//二维码内容String url = "https://w.url.cn/s/AYmfAV3";//二维码下面的文字String words = "PSD000001";drawLogoQRCode(logoFile, bgFile, qrCodeFile, url, words);}
}

3.4 可带内容文本的条形码工具类

package com.example.project.demo;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 javax.imageio.ImageIO;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileOutputStream;
import java.util.Hashtable;public class Code_128Utils {private static final int WIDTH = 351;private static final int CODEHEIGHT = 55;private static final int HEIGHT = 78;private static final int FONTSIZE = 25;private static final String IMAGETYPE = "JPEG";/**** @param no 条形码内容* @param codePath* @param isShowNum*/public static void createCode(String no, String codePath, Boolean isShowNum) throws Exception {FileOutputStream fos;fos = new FileOutputStream(new File(codePath));int width = WIDTH;int height = CODEHEIGHT;Hashtable<EncodeHintType, String> hints = new Hashtable<EncodeHintType, String>();hints.put(EncodeHintType.CHARACTER_SET, "utf-8");BitMatrix m = new MultiFormatWriter().encode(no,BarcodeFormat.CODE_128, width, height, hints);MatrixToImageWriter.writeToStream(m, IMAGETYPE, fos);fos.flush();fos.close();if(isShowNum){createFont(no, codePath);}}///该方法用来生成二维码字体并且把二维码拼接到字体图片上private static void createFont(String no, String codePath) throws Exception {BufferedImage font = new BufferedImage(WIDTH, HEIGHT,BufferedImage.TYPE_INT_RGB);BufferedImage code = ImageIO.read(new File(codePath));Graphics2D g = (Graphics2D) font.getGraphics();//长宽是总的 字体加二维码的g.clearRect(0, 0, WIDTH, HEIGHT);g.setColor(Color.WHITE);g.fillRect(0, 0, WIDTH, HEIGHT);//字体渲染g.setRenderingHint(RenderingHints.KEY_ANTIALIASING,RenderingHints.VALUE_ANTIALIAS_ON);g.setRenderingHint(RenderingHints.KEY_RENDERING,RenderingHints.VALUE_RENDER_QUALITY);//在图片上把字写好for (int i = 0; i < no.length(); i++) {g.setColor(Color.black);Font font_ = new Font("Consolas", 0, FONTSIZE);g.setFont(font_);g.drawString(no.charAt(i) + "", (FONTSIZE * 2 + WIDTH - no.length()* FONTSIZE)/ 2 + (i - 1) * FONTSIZE, CODEHEIGHT + HEIGHT - CODEHEIGHT);}//然后把二维码加上去 g.drawImage(code, 0, 0, null);g.dispose();//进行图片处理,防止出现模糊int[] rgb = new int[3];for (int i = 0; i < WIDTH; i++) {for (int j = CODEHEIGHT; j < HEIGHT; j++) {int pixel = font.getRGB(i, j);rgb[0] = (pixel & 0xff0000) >> 16;rgb[1] = (pixel & 0xff00) >> 8;rgb[2] = (pixel & 0xff);if (rgb[0] > 125 || rgb[1] > 125 || rgb[2] > 125) {font.setRGB(i, j, -1);}if (rgb[0] < 100 || rgb[1] < 100 || rgb[2] < 100) {font.setRGB(i, j, -16777216);}}}File outputfile = new File(codePath);ImageIO.write(font, IMAGETYPE, outputfile);}public static void main(String[] args) throws Exception {String s = "D:\\demo\\zxing\\"+System.currentTimeMillis()+".jpg";createCode("S1234567", s,false);}
}