package com.custom.webui.util; import org.apache.pdfbox.pdmodel.PDDocument; import org.apache.pdfbox.pdmodel.PDPage; import org.apache.pdfbox.pdmodel.PDPageContentStream; import org.apache.pdfbox.pdmodel.common.PDRectangle; import org.apache.pdfbox.pdmodel.font.PDType0Font; import java.io.Closeable; import java.io.IOException; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; /** * 极简的 PDF 排版器:把一段段文字按 A4 页面排下来,自动换行、自动翻页、带页码。 * *
按**字符**而不是单词断行:中文没有词间空格,按单词断会得到一整段不断行的文本。 * 同时做两件小事: *
字体缺字形这一点是必须处理的:Arial Unicode 这类字体覆盖了中日韩, * 但不含 emoji(U+1F600 等)。PDFBox 遇到缺字形会抛异常, * 表现就是「对话里有表情符号,整个 PDF 导出就失败」—— * 一个 emoji 毁掉整份导出,显然不可接受,所以替换成方框继续导。 * *
字形判断走字体句柄的 cmap 查询,**不能**用 * {@code PDType0Font.hasGlyph()}:实测它对本该存在的全角逗号也会返回 * false,那样中文标点会被整片替换成方框(详见 {@link PdfFontSupport})。 */ private String sanitize(String raw) { StringBuilder sb = new StringBuilder(raw.length() + 16); int i = 0; while (i < raw.length()) { int cp = raw.codePointAt(i); i += Character.charCount(cp); if (cp == '\r') { continue; } if (cp == '\t') { sb.append(" "); continue; } if (cp != '\n' && Character.isISOControl(cp)) { continue; } if (cp == '\n' || hasGlyph(cp)) { sb.appendCodePoint(cp); } else { sb.append(REPLACEMENT); } } return sb.toString(); } private boolean hasGlyph(int codePoint) { Boolean cached = glyphCache.get(codePoint); if (cached != null) { return cached; } boolean has = handle.hasGlyph(codePoint); glyphCache.put(codePoint, has); return has; } private void ensureSpace(float needed) throws IOException { if (cursorY - needed < CURSOR_BOTTOM) { newPage(); } } private void newPage() throws IOException { if (stream != null) { stream.close(); } PDPage page = new PDPage(PDRectangle.A4); document.addPage(page); pages.add(page); // compress=true 让内容流走 Flate 压缩;resetContext=true 保证每页图形状态独立 stream = new PDPageContentStream(document, page, PDPageContentStream.AppendMode.APPEND, true, true); cursorY = CURSOR_TOP; } @Override public void close() throws IOException { if (finished) { return; } finished = true; if (stream != null) { stream.close(); stream = null; } writeFooters(); } /** * 补画页码。 * *
必须在全部内容写完之后做:页码要落在「第 N 页 / 共 M 页」上, * 而 M 只有写到最后才知道。用 APPEND 模式重新打开每一页的内容流即可。 */ private void writeFooters() throws IOException { int total = pages.size(); for (int index = 0; index < total; index++) { String text = "第 " + (index + 1) + " 页 / 共 " + total + " 页"; float size = 8f; float width = widthOf(text, size); try (PDPageContentStream footer = new PDPageContentStream( document, pages.get(index), PDPageContentStream.AppendMode.APPEND, true, true)) { footer.setNonStrokingColor(0.62f, 0.65f, 0.70f); footer.beginText(); footer.setFont(font, size); footer.newLineAtOffset((PAGE_WIDTH - width) / 2f, MARGIN / 2f); footer.showText(text); footer.endText(); } } } }