React前端jsPdf转Java后端PDFBox：获取页末位置与默认布局设置

我正在将基于jsPdf的React前端PDF生成功能迁移到Java后端（使用PDFBox），希望沿用前端的实现思路——为章节、标题、图片等内容创建静态方法。在插入新内容前，需要获取当前页面已有内容最后一行的垂直位置，前端是通过一个对象手动记录并管理这类排版信息的。现存在两个核心问题：

1. PDFBox中能否获取该垂直位置？
2. 能否在文档层面定义页面布局（如边距等），使新增页面默认继承这些属性？

附前端jsPdf的配置代码片段：

const pdfOptions: PdfOptions = {
    currentX: 10,
    currentY: 30,
    newPageY: 15,
    doubleSpacing: 10,
    onehalfspacing: 7.5,
    subSectionSpacing: 6,
    singlespacing: 5,
    endOfPageTextTreshold: doc.internal.pageSize.height - 40,
    endOfPageImageTreshold: doc.internal.pageSize.height - 20,
    pageWidth: doc.internal.pageSize.width,
    leftMargin: 10, // used in imageTargetSize
    rightMargin: 10, // used in imageTargetSize
    imageTargetSize: doc.internal.pageSize.width * 0.8 - (10 + 10),
    imagePixelWidth: 640,
    imagePixelHeight: 480,
    fontSizes: {
      title: 16,
      subTitle: 12,
      normalSize: 10,
      small: 9,
      footNoteSize: 8,
    },
  };

一、获取当前页面最后内容的垂直位置 #

PDFBox本身没有直接提供“获取最后一行Y坐标”的API，因为它的内容绘制是基于底层坐标操作，不会自动跟踪内容位置。但你可以完全沿用前端的思路，手动维护一个排版状态对象来记录当前Y坐标：

• 创建自定义排版上下文类（如PdfLayoutContext），封装currentY、边距、行间距、字体大小等与排版相关的属性，和前端pdfOptions一一对应。
• 每次绘制文本、图片后，根据内容的实际高度（比如文本行高、图片高度）更新currentY的值。
• 换页时，将currentY重置为新页面的起始位置（对应前端的newPageY）。

示例代码 #

// 自定义排版上下文类
class PdfLayoutContext {
    private float currentY;
    private final float leftMargin;
    private final float rightMargin;
    private final float pageHeight;
    private final float newPageY;
    private final float subSectionSpacing;
    // 可添加其他排版属性：行间距、字体大小配置等

    public PdfLayoutContext(float leftMargin, float rightMargin, float pageHeight, float newPageY, float subSectionSpacing) {
        this.leftMargin = leftMargin;
        this.rightMargin = rightMargin;
        this.pageHeight = pageHeight;
        this.newPageY = newPageY;
        this.subSectionSpacing = subSectionSpacing;
        this.currentY = newPageY; // 初始化首页面起始Y坐标
    }

    public float getCurrentY() {
        return currentY;
    }

    public float getLeftMargin() {
        return leftMargin;
    }

    // 更新Y坐标：内容高度 + 后续间距
    public void updateY(float contentHeight) {
        this.currentY += contentHeight + subSectionSpacing;
    }

    // 换页时重置Y坐标
    public void resetForNewPage() {
        this.currentY = newPageY;
    }
}

绘制文本时更新上下文的示例：

// 初始化文档、页面、内容流及排版上下文
PDDocument document = new PDDocument();
PDPage page = new PDPage(PDRectangle.A4);
document.addPage(page);
PDPageContentStream contentStream = new PDPageContentStream(document, page);
PdfLayoutContext context = new PdfLayoutContext(10, 10, page.getMediaBox().getHeight(), 15, 6);

// 绘制标题并更新Y坐标
PDType1Font titleFont = PDType1Font.HELVETICA_BOLD;
int titleFontSize = 16;
String titleText = "第一章 系统概述";
// 计算文本高度：字体边界盒高度 * 字号比例
float titleHeight = titleFont.getFontDescriptor().getFontBoundingBox().getHeight() / 1000 * titleFontSize;

contentStream.beginText();
contentStream.setFont(titleFont, titleFontSize);
contentStream.newLineAtOffset(context.getLeftMargin(), context.getCurrentY());
contentStream.showText(titleText);
contentStream.endText();

// 更新当前Y坐标
context.updateY(titleHeight);

二、定义文档层面的默认页面布局 #

PDFBox支持通过自定义页面创建逻辑，让所有新增页面继承预设的布局属性（如边距、尺寸）：

1. 定义全局页面配置类，统一管理页面尺寸、边距等参数。
2. 封装生成默认页面的工具方法，在方法中设置页面的媒体框、裁剪框（对应边距）。
3. 每次添加新页面时，调用该工具方法，而非直接new PDPage()。

示例代码 #

// 全局页面配置
class PdfGlobalConfig {
    public static final PDRectangle PAGE_SIZE = PDRectangle.A4;
    public static final float LEFT_MARGIN = 10;
    public static final float RIGHT_MARGIN = 10;
    public static final float TOP_MARGIN = 30;
    public static final float BOTTOM_MARGIN = 40;
}

// 生成带默认布局的页面
public static PDPage createDefaultPage() {
    PDPage page = new PDPage(PdfGlobalConfig.PAGE_SIZE);
    PDRectangle mediaBox = page.getMediaBox();
    // 设置裁剪框，实现边距效果
    PDRectangle cropBox = new PDRectangle(
        mediaBox.getLowerLeftX() + PdfGlobalConfig.LEFT_MARGIN,
        mediaBox.getLowerLeftY() + PdfGlobalConfig.BOTTOM_MARGIN,
        mediaBox.getWidth() - PdfGlobalConfig.LEFT_MARGIN - PdfGlobalConfig.RIGHT_MARGIN,
        mediaBox.getHeight() - PdfGlobalConfig.TOP_MARGIN - PdfGlobalConfig.BOTTOM_MARGIN
    );
    page.setCropBox(cropBox);
    return page;
}

// 使用示例
PDDocument document = new PDDocument();
// 添加第一个页面
document.addPage(createDefaultPage());
// 添加新页面时自动继承布局
document.addPage(createDefaultPage());

内容的提问来源于stack exchange，提问作者Tauwin