Java Base64工具类，提供常用（文件、图片、PDF、URL）转换方法，欢迎留言完善...（原创博文，欢迎转载）

矫情吗；* 2022-12-23 11:15 176阅读 0赞

**原创博文，欢迎转载，转载时请务必附上博文链接，感谢您的尊重。**

# **前言** #

通过本篇的学习，你将学会Base64在实战中的使用，此工具包提供了常用的方法，如下：

1.  text明文【转】Base64字符串；
2.  text的Base64字符串【转】明文；
3.  文件（图片、pdf等）【转】Base64；
4.  Base64【转】文件（图片、pdf等）；
5.  将pdf的Base64编码格式【转为】img的Base64编码格式，只限最后一页的Base64编码；
6.  将pdf的Base64编码格式【转为】img的Base64编码格式，并将所有页合成一张图片的Base64编码；
7.  ...

有关Base64编码(Encode)与解码(Decode)的基础知识，请请看我另一篇博文：[关于Base64编码(Encode)与解码(Decode)的几种方式，这里面有道道][Base64_Encode_Decode]

--------------------

# 一、所需的包 #

**注意：**java.util.Base64是JDK1.8中新增的类，所以它只支持JDK1.8及以后的版本，如果你的JDK版本低于1.8，请使用org.apache.commons.codec.binary.Base64.

下面的包，是用于Base64的pdf转img使用的，如果不需要要，可以不引用，并删掉对应的方法（前言中的5和6）。

<dependency>
    		<groupId>org.apache.pdfbox</groupId>
    		<artifactId>fontbox</artifactId>
    		<version>2.0.1</version>
    	</dependency>
    	<dependency>
    		<groupId>org.apache.pdfbox</groupId>
    		<artifactId>pdfbox</artifactId>
    		<version>2.0.1</version>
    	</dependency>

--------------------

# 二、Base64Util #

Base64Util类，代码如下（可以直接复制使用，直接运行main方法看效果）：

import org.apache.commons.lang3.StringUtils;
    import org.apache.pdfbox.pdmodel.PDDocument;
    import org.apache.pdfbox.rendering.ImageType;
    import org.apache.pdfbox.rendering.PDFRenderer;
    import java.awt.image.BufferedImage;
    import java.io.*;
    import javax.imageio.ImageIO;
    import java.util.Base64;
    
    public class Base64Utils {
    
        // Base64 编码与解码
        private static final Base64.Decoder DECODER_64 = Base64.getDecoder();
        private static final Base64.Encoder ENCODER_64 = Base64.getEncoder();
    
        // dpi越大转换后的图片越清晰，相对转换速度越慢
        private static final Integer DPI = 200;
    
        // 编码、解码格式
        private static final String CODE_FORMATE = "UTF-8";
    
        /**
         * 1. text明文 转 Base64字符串
         * @param text  明文
         * @return      Base64 字符串
         */
        public static String textToBase64Str(String text) {
            if (StringUtils.isBlank(text)) {
                return text;
            }
            String encodedToStr = null;
            try {
                encodedToStr = ENCODER_64.encodeToString(text.getBytes(CODE_FORMATE));
            } catch (UnsupportedEncodingException e) {
                e.getMessage();
            }
            return encodedToStr;
        }
    
        /**
         * 2. text的Base64字符串 转 明文
         * @param base64Str text的Base64字符串
         * @return          text明文
         */
        public static String base64StrToText(String base64Str) {
            if (StringUtils.isBlank(base64Str)) {
                return base64Str;
            }
            String byteToText = null;
            try {
                byteToText = new String(DECODER_64.decode(base64Str), CODE_FORMATE);
            } catch (UnsupportedEncodingException e) {
                e.getMessage();
            }
            return byteToText;
        }
    
        /**
         * 3. 文件（图片、pdf） 转 Base64字符串
         * @param file  需要转Base64的文件
         * @return      Base64 字符串
         */
        public static String fileToBase64Str(File file) throws IOException {
            String base64Str = null;
            FileInputStream fin = null;
            BufferedInputStream bin = null;
            ByteArrayOutputStream baos = null;
            BufferedOutputStream bout = null;
            try {
                fin = new FileInputStream(file);
                bin = new BufferedInputStream(fin);
                baos = new ByteArrayOutputStream();
                bout = new BufferedOutputStream(baos);
                // io
                byte[] buffer = new byte[1024];
                int len = bin.read(buffer);
                while(len != -1){
                    bout.write(buffer, 0, len);
                    len = bin.read(buffer);
                }
                // 刷新此输出流，强制写出所有缓冲的输出字节
                bout.flush();
                byte[] bytes = baos.toByteArray();
                // Base64字符编码
                base64Str = ENCODER_64.encodeToString(bytes).trim();
            } catch (IOException e) {
                e.getMessage();
            } finally{
                try {
                    fin.close();
                    bin.close();
                    bout.close();
                } catch (IOException e) {
                    e.getMessage();
                }
            }
            return base64Str;
        }
    
        /**
         * 4. Base64字符串 转 文件（图片、pdf） -- 多用于测试
         * @param base64Content Base64 字符串
         * @param filePath      存放路径
         */
        public static void base64ContentToFile(String base64Content, String filePath) throws IOException{
            BufferedInputStream bis = null;
            FileOutputStream fos = null;
            BufferedOutputStream bos = null;
            try {
                // Base64解码到字符数组
                byte[] bytes =  DECODER_64.decode(base64Content);
                ByteArrayInputStream byteInputStream = new ByteArrayInputStream(bytes);
                bis = new BufferedInputStream(byteInputStream);
                File file = new File(filePath);
                File path = file.getParentFile();
                if(!path.exists()){
                    path.mkdirs();
                }
                fos = new FileOutputStream(file);
                bos = new BufferedOutputStream(fos);
                // io
                byte[] buffer = new byte[1024];
                int length = bis.read(buffer);
                while(length != -1){
                    bos.write(buffer, 0, length);
                    length = bis.read(buffer);
                }
                // 刷新此输出流，强制写出所有缓冲的输出字节
                bos.flush();
            } catch (IOException e) {
                e.getMessage();
            }finally{
                try {
                    bis.close();
                    fos.close();
                    bos.close();
                } catch (IOException e) {
                    e.getMessage();
                }
            }
        }
    
        /**
         * 5. 将pdf的base64编码格式 转为 img的base64编码格式，只限最后一页
         * @param base64Pdf  pdf的base64编码
         * @return           image的base64编码
         */
        public static String base64PdfToJpgBase64(String base64Pdf){
            if (StringUtils.isBlank(base64Pdf)){
                return base64Pdf;
            }
            String jpg_base64 = null;
            PDDocument doc = null;
            try {
                // Base64解码
                byte[] pdf_bytes = DECODER_64.decode(base64Pdf);
                // 利用PdfBox生成图像
                doc = PDDocument.load(pdf_bytes);
                int size = doc.getNumberOfPages();
                for (int i = 0; i < size; i++) {
                    BufferedImage image = new PDFRenderer(doc).renderImageWithDPI(i, DPI, ImageType.RGB);
                    // io流
                    ByteArrayOutputStream baos = new ByteArrayOutputStream();
                    // 写入流中
                    ImageIO.write(image, "jpg", baos);
                    // 转换成字节
                    byte[] jpg_Bytes = baos.toByteArray();
                    // Base64编码
                    jpg_base64 = ENCODER_64.encodeToString(jpg_Bytes).trim();
                    // 删除 \r\n
                    jpg_base64 = jpg_base64.replaceAll("\n|\n", "");
                }
            } catch (IOException e) {
                e.getMessage();
            } finally {
                if (doc != null) {
                    try {
                        doc.close();
                    } catch (IOException e) {
                        e.getMessage();
                    }
                }
            }
            return jpg_base64;
        }
    
        /**
         * 6. 将pdf的base64编码格式 转为 img的base64编码格式，并将所有页合成一张图片
         * @param pdfBase64Str  pdf的base64编码
         * @return              image的base64编码
         */
        public static String base64PdfToJpgBase64ForOne(String pdfBase64Str){
            if (StringUtils.isBlank(pdfBase64Str)){
                return pdfBase64Str;
            }
            String jpg_base64 = null;
            PDDocument doc = new PDDocument();
            // io
            ByteArrayOutputStream baos = new ByteArrayOutputStream();
            try {
                // Base64解码
                byte[] pdf_bytes = DECODER_64.decode(pdfBase64Str);
                doc = PDDocument.load(pdf_bytes);
                int size = doc.getNumberOfPages();
                /* 图像合并使用的参数 */
                // 定义宽度
                int width = 0;
                // 保存一张图片中的RGB数据
                int[] singleImgRGB;
                // 定义高度，后面用于叠加
                int shiftHeight = 0;
                // 保存每张图片的像素值
                BufferedImage imageResult = null;
                // 利用PdfBox生成图像
                PDDocument pdDocument = doc;
                PDFRenderer renderer = new PDFRenderer(pdDocument);
                /* 根据总页数, 按照50页生成一张长图片的逻辑, 进行拆分 */
                // 每50页转成1张图片,有多少转多少
                int pageLength = size;
                // 总计循环的次数
                int totalCount = pdDocument.getNumberOfPages() / pageLength + 1;
                for (int m = 0; m < totalCount; m++) {
                    for (int i = 0; i < pageLength; i++) {
                        int pageIndex = i + (m * pageLength);
                        if (pageIndex == pdDocument.getNumberOfPages()) {
                            System.out.println("循环次数 m = " + m);
                            break;
                        }
                        // dpi越大，则图片越清晰，图片越大，转换耗费的时间也越多
                        BufferedImage image = renderer.renderImageWithDPI(pageIndex, DPI, ImageType.RGB);
                        int imageHeight = image.getHeight();
                        int imageWidth = image.getWidth();
                        if (i == 0) {
                            // 计算高度和偏移量
                            // 使用第一张图片宽度;
                            width = imageWidth;
                            // 保存每页图片的像素值
                            // 加个判断：如果m次循环后所剩的图片总数小于pageLength，则图片高度按剩余的张数绘制，否则会出现长图片下面全是黑色的情况
                            if ((pdDocument.getNumberOfPages() - m * pageLength) < pageLength) {
                                imageResult = new BufferedImage(width, imageHeight * (pdDocument.getNumberOfPages() - m * pageLength), BufferedImage.TYPE_INT_RGB);
                            } else {
                                imageResult = new BufferedImage(width, imageHeight * pageLength, BufferedImage.TYPE_INT_RGB);
                            }
                        } else {
                            // 将高度不断累加
                            shiftHeight += imageHeight;
                        }
                        singleImgRGB = image.getRGB(0, 0, width, imageHeight, null, 0, width);
                        imageResult.setRGB(0, shiftHeight, width, imageHeight, singleImgRGB, 0, width);
                    }
                    // 这个很重要，下面会有说明
                    shiftHeight = 0;
                }
                pdDocument.close();
                // 写入流中
                ImageIO.write(imageResult, "jpg", baos);
                // 转换成字节
                byte[] jpg_Bytes = baos.toByteArray();
                // 转换成base64串
                jpg_base64 = ENCODER_64.encodeToString(jpg_Bytes).trim();
                // 删除 \r\n
                jpg_base64 = jpg_base64.replaceAll("\n|\n", "");
            } catch (IOException e) {
                e.getMessage();
            } finally {
                if (baos != null) {
                    try {
                        baos.close();
                    } catch (IOException e) {
                        e.getMessage();
                    }
                }
                if (doc != null) {
                    try {
                        doc.close();
                    } catch (IOException e) {
                        e.getMessage();
                    }
                }
            }
            return jpg_base64;
        }
    
        // 测试
        public static void main(String args[]){
            // 1.测试：text明文 转 Base64字符串
            String text = "这是一串需要编码的明文，可以是URL、图片、文件或其他。";
            String result_1 = Base64Utils.textToBase64Str(text);
            System.out.println("text明文 转 Base64字符串：" + text + " → 经Base64编码后 → " + result_1);
    
            // 2.测试：text的Base64字符串 转 明文
            String base64Str = "6L+Z5piv5LiA5Liy6ZyA6KaB57yW56CB55qE5piO5paH77yM5Y+v5Lul5pivVVJM44CB5Zu+54mH44CB5paH5Lu25oiW5YW25LuW44CC";
            String result_2 = Base64Utils.base64StrToText(base64Str);
            System.out.println("text的Base64字符串 转 明文：" + base64Str + " → 经Base64解码后 → " + result_2);
    
            // 3.测试：文件 转 Base64
            // 4.测试：Base64 转 文件
            try {
                File filePath = new File("D:\\downloads\\test.pdf");
                String tempBase64Str = Base64Utils.fileToBase64Str(filePath);
                System.out.println("文件 转 Base64，完成，使用方法【4】反转验证。");
                Base64Utils.base64ContentToFile(tempBase64Str, "D:\\downloads\\test_4.pdf");
            } catch (IOException e) {
                e.getMessage();
            }
            System.out.println("文件与Base64互转，完成，方法【4】通常用于测试。");
    
            // 5.测试：将pdf的base64编码格式 转为 img的base64编码格式，只限最后一页
            try {
                File filePath = new File("D:\\downloads\\test.pdf");
                String tempBase64Str_1 = Base64Utils.fileToBase64Str(filePath);
                String tempBase64Str_2 = Base64Utils.base64PdfToJpgBase64(tempBase64Str_1);
                Base64Utils.base64ContentToFile(tempBase64Str_2, "D:\\downloads\\pdf_to_image_5.jpg");
            } catch (IOException e) {
                e.getMessage();
            }
            System.out.println("将pdf的base64编码格式 转为 img的base64编码格式，只限最后一页，完成。");
    
            // 6.测试：将pdf的base64编码格式 转为 img的base64编码格式，并合成一张图片
            try {
                File filePath = new File("D:\\downloads\\test.pdf");
                String tempBase64Str_1 = Base64Utils.fileToBase64Str(filePath);
                String tempBase64Str_2 = Base64Utils.base64PdfToJpgBase64ForOne(tempBase64Str_1);
                Base64Utils.base64ContentToFile(tempBase64Str_2, "D:\\downloads\\pdf_to_image_6.jpg");
            } catch (IOException e) {
                e.getMessage();
            }
            System.out.println("将pdf的base64编码格式 转为 img的base64编码格式，并将所有页合成一张图片，完成。");
        }
    }

--------------------

**总结**

*  上述工具类中的方法，都是小编实际生产中遇到的场景，亲改亲测总结下来的；
 *  方法可以直接复制使用，测试类也已调试好；
 *  由于java.util.Base64是JDK1.8中新增的类，所以该类仅支持JDK1.8及以后的版本；
 *  如果JDK版本低于1.8，需要把java.util.Base64换成org.apache.commons.codec.binary.Base64，具体方法可见【本篇“前言”中提示的博文】。
 *  欢迎大家及时补充，把Util类变的更加完善，让更多的程序员能从中受益。

--------------------

**我是一名小白程序员，您的点赞、评论和关注，是我不懈创作的动力！！  
学无止境，气有浩然，让我们一起加油，乘风破浪，江湖有缘再见。**

[Base64_Encode_Decode]: https://jiming.blog.csdn.net/article/details/109784917

发表评论取消回复

表情：

评论列表（有 0 条评论，176人围观）

还没有评论，来说两句吧...

相关阅读

相关欢迎转载

创造分享，共同成长！本人博客（[https://blog.csdn.net/qq\_48008521][https_blog.csdn.net_qq_480085

叁歲伎倆/ 2023年10月04日 12:09/ 0 赞/ 24 阅读

相关 Java Base64工具类，提供常用（文件、图片、PDF、URL）转换方法，欢迎留言完善...（原创博文，欢迎转载）

原创博文，欢迎转载，转载时请务必附上博文链接，感谢您的尊重。前言通过本篇的学习，你将学会Base64在实战中的使用，此工具包提供了常用的方法，如下： 1. te

矫情吗；*/ 2022年12月23日 11:15/ 0 赞/ 177 阅读

相关 base64图片转换工具类以及base转图片工具

import java.io.FileInputStream; import java.io.FileOutputStream; import java

ゝ一纸荒年。/ 2022年12月22日 14:26/ 0 赞/ 233 阅读

相关【常用工具】java base64加密工具类

java base64加密工具类 import org.apache.commons.codec.binary.Base64; public cla

柔光的暖阳◎/ 2022年11月28日 10:58/ 0 赞/ 131 阅读

相关 Base64工具类

package com.baidu.ueditor; import java.io.BufferedInputStream; import java.io.

骑猪看日落/ 2022年08月20日 14:08/ 0 赞/ 168 阅读

相关 base64生成图片——图片转换变成base64

base64生成图片——图片转换变成base64 如题。下面上货。 package com.xueyou.demo; import org

桃扇骨/ 2022年06月15日 05:22/ 0 赞/ 428 阅读

相关 JAVA base64 工具类

import java.io.UnsupportedEncodingException; import java.util.Iterator; impo

女爷i/ 2022年03月16日 15:38/ 0 赞/ 250 阅读

相关原创装饰者设计模式实例（第一次自己写博文，欢迎指正交流）

以汽车为例子，对汽车进行染色是必须的步骤，但是如果有些车主还喜欢对车把手或者车内部进行不同的染色（这当然是选择性的步骤），那么就非常适合用装饰者设计模式来设计。设计的代码如

以你之姓@/ 2021年12月09日 00:41/ 0 赞/ 76 阅读

相关 JAVA 图片地址路径转换 Base64 工具类

工具类代码： import sun.misc.BASE64Encoder; import java.io.ByteArrayOutputStream;

￡神魔★判官ぃ/ 2021年11月23日 01:16/ 0 赞/ 360 阅读

相关前端图片在线转换Base64 图片编码Base64

首先讲一下什么是图片Base64编码：简单来说，图片的base64编码就是可以将一副图片数据编码成一串字符串，使用该字符串代替图像地址。为什么要用Base64？我们

比眉伴天荒/ 2021年09月14日 03:02/ 0 赞/ 1034 阅读