Support event meta info

DEVSIX-1958

Author: IdamkinI

src/main/java/com/itextpdf/pdfcleanup/PdfCleanUpTool.java

@@ -52,6 +52,7 @@ This file is part of the iText (R) project.
 import com.itextpdf.kernel.colors.DeviceGray;
 import com.itextpdf.kernel.colors.DeviceRgb;
 import com.itextpdf.kernel.counter.EventCounterHandler;
+import com.itextpdf.kernel.counter.event.IMetaInfo;
 import com.itextpdf.kernel.font.PdfFont;
 import com.itextpdf.kernel.font.PdfFontFactory;
 import com.itextpdf.kernel.geom.Rectangle;
@@ -116,6 +117,8 @@ public class PdfCleanUpTool {
 
     private boolean processAnnotations;
 
+    private IMetaInfo cleanupMetaInfo;
+
     /**
      * Check if page annotations will be processed
      * Default: True
@@ -253,6 +256,18 @@ public PdfCleanUpTool addCleanupLocation(PdfCleanUpLocation cleanUpLocation) {
         return this;
     }
 
+    /**
+     * Sets the cleanup meta info that will be passed to the {@link com.itextpdf.kernel.counter.EventCounter}
+     * with {@link PdfSweepEvent} and can be used to determine event origin.
+     *
+     * @param metaInfo the meta info to set.
+     * @return this instance
+     */
+    public PdfCleanUpTool setEventCountingMetaInfo(IMetaInfo metaInfo) {
+        this.cleanupMetaInfo = metaInfo;
+        return this;
+    }
+
     /**
      * Cleans the document by erasing all the areas which are either provided or
      * extracted from redaction annotations.
@@ -268,7 +283,7 @@ public void cleanUp() throws IOException {
             removeRedactAnnots();
         }
         pdfCleanUpLocations.clear();
-        EventCounterHandler.getInstance().onEvent(PdfSweepEvent.CLEANUP, getClass());
+        EventCounterHandler.getInstance().onEvent(PdfSweepEvent.CLEANUP, cleanupMetaInfo, getClass());
     }
 
     /**