使用 itext html转成pdf的正确姿势

Posted 2022-12-26 明明如月学长

itext html2pdf 网上一些资料不全面，网上很多例子不太靠谱，有很多坑，这里给出工具和常见的坑，可以少走很多弯路。

支持html前端分页符和避免分页的属性。

1、优势

• 转换效果非常理想
• 不需要安装软件

2、依赖3个包 

https://mvnrepository.com/artifact/com.itextpdf/html2pdf/2.1.0

https://mvnrepository.com/artifact/com.itextpdf/forms/7.1.3

https://mvnrepository.com/artifact/com.itextpdf/layout/7.1.3

3、工具类

import com.itextpdf.html2pdf.ConverterProperties;
import com.itextpdf.html2pdf.HtmlConverter;
import com.itextpdf.html2pdf.attach.impl.layout.HtmlPageBreak;
import com.itextpdf.kernel.geom.PageSize;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.IBlockElement;
import com.itextpdf.layout.element.IElement;
import com.itextpdf.layout.font.FontProvider;

import java.io.IOException;
import java.util.List;

/**
* by 明明如月 github :https://github.com/chujianyun
*/

public class Html2PdfUtil 

    /**
     * 字体所在目录
     */
    private static final String FONT_RESOURCE_DIR = "/font";

    /**
     * @param htmlContent html文本
     * @param dest        目的文件路径，如 /xxx/xxx.pdf
     * @throws IOException IO异常
     */
    public static void createPdf(String htmlContent, String dest) throws IOException 
        ConverterProperties props = new ConverterProperties();
        // props.setCharset("UFT-8"); 编码
        FontProvider fp = new FontProvider();
        fp.addStandardPdfFonts();
        // .ttf 字体所在目录
        String resources = Html2PdfUtil.class.getResource(FONT_RESOURCE_DIR).getPath();
        fp.addDirectory(resources);
        props.setFontProvider(fp);
        // html中使用的图片等资源目录（图片也可以直接用url或者base64格式而不放到资源里）
        // props.setBaseUri(resources); 

        List<IElement> elements = HtmlConverter.convertToElements(htmlContent, props);
        PdfDocument pdf = new PdfDocument(new PdfWriter(dest));
        Document document = new Document(pdf, PageSize.A4.rotate(), false);
        for (IElement element : elements) 
            // 分页符
            if (element instanceof HtmlPageBreak) 
                document.add((HtmlPageBreak) element);

            //普通块级元素
             else 
                document.add((IBlockElement) element);
            
        
        document.close();
    

4、主要的坑！！

1. Html尽量规范
2. html不支持float样式（关键字）

3. 不要设置表格最小宽度

----
创作不易，如果本文对你有帮助，欢迎点赞、收藏加关注，你的支持和鼓励，是我创作的最大动力。

---

我正在参加 CSDN 猿创征文：《弃文从工，从小白到蚂蚁工程师，我的 Java 成长之路》，讲述自弃理从文、弃文从工的经历，讲述自己的写作经验、求职经验和工作经验等。
欢迎阅读，也欢迎点赞、评论，为我打 Call ！！