iText 7 中固定区域内超长文本的渲染与布局异常处理

在iText 7中，将动态生成且可能超长的文本渲染到预设的固定尺寸矩形区域时，开发者常遇到`IllegalArgumentException`。本文旨在深入探讨这一问题，并提供一个基于自定义`ParagraphRenderer`的解决方案，该方案允许在不预先测量文本长度的情况下，确保文本内容能够被正确地绘制并限制在指定区域内，有效避免因文本溢出导致的布局异常。

理解 iText 7 中的文本布局挑战

在PDF文档生成过程中，经常需要将可变长度的字符串放置到预定义的矩形区域内。iText 7 提供了强大的布局引擎，通过 Canvas、Paragraph 和 Renderer 等组件来管理内容定位和渲染。然而，当尝试将一个可能超出其容器尺寸的 Paragraph 添加到 Canvas 时，尤其是在 Canvas 自身也定义了固定绘制区域的情况下，可能会遇到运行时异常。

典型的场景是，开发者定义了一个 Rectangle 作为绘制区域，并使用 Canvas 将 Paragraph 添加到该区域。如果 Paragraph 中的文本内容过长，即使 Paragraph 本身设置了宽度和高度限制，iText 7 的默认布局机制在某些版本或特定配置下，可能无法正确处理文本溢出，从而抛出 java.lang.IllegalArgumentException: fromIndex(0) > toIndex(-1) 这样的错误。这个异常通常发生在 ParagraphRenderer 尝试计算和分割文本行时，表明其内部索引计算出现了问题，未能找到有效的文本片段进行渲染。

以下是一个可能导致此问题的示例代码：

import com.itextpdf.kernel.geom.PageSize;
import com.itextpdf.kernel.geom.Rectangle;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfPage;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.kernel.pdf.canvas.PdfCanvas;
import com.itextpdf.layout.Canvas;
import com.itextpdf.layout.element.BlockElement;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.properties.TextAlignment;
import com.itextpdf.layout.font.PdfFont;
import com.itextpdf.layout.font.PdfFontFactory;

import java.io.IOException;

public class ITextLongTextIssue {

    public static void main(String[] args) throws IOException {
        try (PdfWriter writer = new PdfWriter("test_problem.pdf");
             PdfDocument pdf = new PdfDocument(writer)) {
            PdfPage currentPage = pdf.addNewPage(PageSize.A4);
            Rectangle rect = new Rectangle(
                    75f,
                    currentPage.getPageSize().getHeight() - 315f - 22f,
                    75f,
                    22f
            );

            PdfFont currentFont = PdfFontFactory.createFont("Helvetica", "Cp1252");

            // 尝试添加一个超长文本段落
            Paragraph p = (new Paragraph("Some longer value that definitely exceeds the small rectangle width"))
                    .setFont(currentFont)
                    .setFontSize(12f)
                    .setWidth(75f) // 段落宽度与矩形相同
                    .setHeight(22f) // 段落高度与矩形相同
                    .setTextAlignment(TextAlignment.LEFT);

            // 预期可能在此处抛出异常
            (new Canvas(new PdfCanvas(currentPage), pdf, rect))
                    .add((BlockElement) p);
        }
        System.out.println("PDF generated successfully (or failed with exception).");
    }
}

登录后复制

当 Paragraph 中的文本 Some longer value that definitely exceeds the small rectangle width 超出 rect 定义的 75f 宽度时，上述代码在旧版 iText 7 中可能触发异常。

解决方案：自定义 ParagraphRenderer

解决此问题的关键在于更精细地控制 Paragraph 的渲染区域。iText 7 允许通过自定义 Renderer 来重写元素的布局行为。对于 Paragraph 而言，我们可以通过创建一个自定义的 ParagraphRenderer 并重写其 initElementAreas 方法来明确告知它可用的绘制区域。

initElementAreas 方法负责初始化元素可用的布局区域列表。通过在此方法中返回一个包含我们目标 Rectangle 的列表，我们强制 Paragraph 的渲染器将该矩形作为其唯一的布局空间。这样，无论文本多长，ParagraphRenderer 都会尝试将其内容绘制到这个预设的矩形中，超出部分将被自动裁剪，从而避免布局异常。

标签： java apache ai pdf 区别 canva asic