尝试应用修订会导致异常

Question

我已经按照步骤使用iText 5.5.9创建注释和应用修订。 这是我的代码：

using (var stamper = new PdfStamper(pdfReader, new FileStream(newFilePath, FileMode.Create)))
{
    // Redact the values.
    var pdfAnot1 = new PdfAnnotation(stamper.Writer, new Rectangle(165f, 685f, 320f, 702f));
    pdfAnot1.Title = "First Page";
    pdfAnot1.Put(PdfName.SUBTYPE, PdfName.REDACT);
    pdfAnot1.Put(PdfName.IC, new PdfArray(new[] { 0f, 0f, 0f }));
    pdfAnot1.Put(PdfName.OC, new PdfArray(new[] { 1f, 0f, 0f })); // red outline
    stamper.AddAnnotation(pdfAnot1, 1);
    for (var i = 1; i <= pdfReader.NumberOfPages; i++)
    {
        var pdfAnot2 = new PdfAnnotation(stamper.Writer, new Rectangle(220f, 752f, 420f, 768f));
        pdfAnot2.Title = "Header";
        pdfAnot2.Put(PdfName.SUBTYPE, PdfName.REDACT);
        pdfAnot2.Put(PdfName.IC, new PdfArray(new[] { 0f, 0f, 0f }));
        pdfAnot2.Put(PdfName.OC, new PdfArray(new[] { 1f, 0f, 0f })); // red outline
        stamper.AddAnnotation(pdfAnot2, i);
    }

    var cleaner = new PdfCleanUpProcessor(stamper);
    cleaner.CleanUp();
}

但是，我总是在PdfCleanUpProcessor构造上收到以下异常：

你调用的对象是空的。 在iTextSharp.xtra.iTextSharp.text.pdf.pdfcleanup.PdfCleanUppp.TextShar.s.xl。 pdf.pdfcleanup.PdfCleanUpProcessor..ctor（PdfStamper pdfStamper）

似乎在annotDict的分配上的extractLocationsFromRedactAnnots中产生了一个空引用，因此下一行引发异常：

    /**
     * Extracts locations from the redact annotations contained in the document and applied to the given page.
     */
    private IList<PdfCleanUpLocation> ExtractLocationsFromRedactAnnots(int page, PdfDictionary pageDict) {
        List<PdfCleanUpLocation> locations = new List<PdfCleanUpLocation>();

        if (pageDict.Contains(PdfName.ANNOTS)) {
            PdfArray annotsArray = pageDict.GetAsArray(PdfName.ANNOTS);

            for (int i = 0; i < annotsArray.Size; ++i) {
                PdfIndirectReference annotIndirRef = annotsArray.GetAsIndirectObject(i);
                PdfDictionary annotDict = annotsArray.GetAsDict(i);
                PdfName annotSubtype = annotDict.GetAsName(PdfName.SUBTYPE);

                if (annotSubtype.Equals(PdfName.REDACT)) {
                    SaveRedactAnnotIndirRef(page, annotIndirRef.ToString());
                    locations.AddRange(ExtractLocationsFromRedactAnnot(page, i, annotDict));
                }
            }
        }

        return locations;
    }

知道为什么会这样吗？ PDF示例在这里 。

Answer 1

这里有两个问题，一个是在OP的代码中，另一个是在iText（Sharp）中。

OP的代码中的问题

必须意识到， PdfReader / PdfStamper对的体系结构不是内存中的文档的结构，该文档仅在最后被保存。 取而代之的是，通常将压模的操作尽快写入输出流，并且对压模上的其他代码不一定可见。

这样做的理由是，iText体系结构（在7.x之前的版本中可能看起来很疯狂）被构建为允许使用低资源占用的操作。 在可能必须并行处理许多PDF的服务器应用程序中，这一点非常重要。

在当前情况下，OP的代码首先添加Redact批注，然后在同一运行中尝试使用这些批注进行清理。 这是行不通的。 相反，OP应该在一次通过中添加注释，并在第二次应用清理，即

using (PdfReader pdfReader = new PdfReader(source))
using (var stamper = new PdfStamper(pdfReader, new FileStream(temp, FileMode.Create)))
{
    // ... add REDACT annotations
}

using (PdfReader pdfReader = new PdfReader(temp))
using (var stamper = new PdfStamper(pdfReader, new FileStream(dest, FileMode.Create)))
{
    var cleaner = new PdfCleanUpProcessor(stamper);
    cleaner.CleanUp();
}

还是根本不使用Redact注释：毕竟，为什么只添加注释以立即将其再次删除。 为此， PdfCleanUpProcessor具有第二个构造函数，直接PdfCleanUpProcessor提供清理位置：

/**
 * Creates a {@link com.itextpdf.text.pdf.pdfcleanup.PdfCleanUpProcessor} object based on the
 * given {@link java.util.List} of {@link com.itextpdf.text.pdf.pdfcleanup.PdfCleanUpLocation}s
 * representing regions to be erased from the document.
 *
 * @param pdfCleanUpLocations list of locations to be cleaned up {@see PdfCleanUpLocation}
 * @param pdfStamper          A{@link com.itextpdf.text.pdf.PdfStamper} object representing the document which redaction
 *                            applies to.
 */
public PdfCleanUpProcessor(IList<PdfCleanUpLocation> pdfCleanUpLocations, PdfStamper pdfStamper)

iText（Sharp）中的问题

所述PdfCleanUpProcessor具有构件字典clippingRects到纂注释区域可以通过在索引它们的页面Annots阵列中加入：

private IList<PdfCleanUpLocation> ExtractLocationsFromRedactAnnot(int page, int annotIndex, PdfDictionary annotDict) {
    ...
    clippingRects.Add(annotIndex, markedRectangles); 
    ...
}

因此，如果多个页面上的文档在其各自的页面Annots数组中具有带有相同索引的Redact注释，则此方法在不同的调用中将尝试使用相同的键将多个条目添加到成员clippingRects 。 .Net Dictionary类不允许这样做，并引发异常。

因此，如果仅注释了一页 ，则由Redact批注进行的iTextSharp修订仅适用于仅具有Redact批注的文档！

此功能的最初开发是在Java中进行的，而在Java clippingRects是一个HashMap ，它允许覆盖条目，因此此处不会引发任何异常。 此外，由于clippingRects的内容仅在特殊情况下使用（在Redact条目中使用RO或OverlayText ），所以错误的条目通常不会造成任何危害，因此可能尚未可再现地观察到。