[RELEASE] iText 7 pdfSweep 3.0.1

Author: iText-CI

pom.xml

@@ -5,12 +5,12 @@
   <parent>
     <groupId>com.itextpdf</groupId>
     <artifactId>root</artifactId>
-    <version>7.2.0</version>
+    <version>7.2.3</version>
     <relativePath />
   </parent>
 
   <artifactId>cleanup</artifactId>
-  <version>3.0.0</version>
+  <version>3.0.1</version>
 
   <name>pdfSweep</name>
   <description>Redact PDF documents. If you have to share PDFs with different departments or send them out of house, but they
@@ -52,7 +52,7 @@
     <dependency>
       <groupId>org.apache.commons</groupId>
       <artifactId>commons-imaging</artifactId>
-      <version>1.0-SNAPSHOT</version>
+      <version>1.0-alpha1</version>
     </dependency>
     <dependency>
       <groupId>com.itextpdf</groupId>

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify
@@ -55,13 +55,19 @@ This file is part of the iText (R) project.
 import java.util.List;
 import java.util.Set;
 
+/**
+ * An event listener which handles cleanup related events.
+ */
 public class PdfCleanUpEventListener implements IEventListener {
     private static final String textDataExpected = "Text data expected.";
     private static final String imageDataExpected = "Image data expected.";
     private static final String pathDataExpected = "Path data expected.";
 
     private List<IEventData> content = new ArrayList<>();
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public void eventOccurred(IEventData data, EventType type) {
         switch (type) {
@@ -134,6 +140,9 @@ PathRenderInfo getEncounteredPath() {
 
     }
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public Set<EventType> getSupportedEvents() {
         return null;

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify
@@ -106,6 +106,9 @@ This file is part of the iText (R) project.
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+/**
+ * PDF content stream processor, which filters content to be cleaned up.
+ */
 public class PdfCleanUpProcessor extends PdfCanvasProcessor {
 
     private static final Set<String> TEXT_SHOWING_OPERATORS = Collections.unmodifiableSet(new HashSet<String>(

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify
@@ -183,6 +183,13 @@ public PdfCleanUpTool(PdfDocument pdfDocument, List<PdfCleanUpLocation> cleanUpL
         }
     }
 
+    /**
+     * Adds a {@link PdfCleanUpLocation} to be cleaned up.
+     *
+     * @param cleanUpLocation a {@link PdfCleanUpLocation} to be cleaned up
+     *
+     * @return this {@link PdfCleanUpTool}
+     */
     public PdfCleanUpTool addCleanupLocation(PdfCleanUpLocation cleanUpLocation) {
         List<PdfCleanUpLocation> pgLocations = this.pdfCleanUpLocations.get(cleanUpLocation.getPage());
         if (pgLocations == null) {
@@ -362,7 +369,7 @@ private List<Rectangle> translateQuadPointsToRectangles(PdfArray quadPoints) {
      * Remove the redaction annotations.
      * This method is called after the annotations are processed.
      *
-     * @throws IOException
+     * @throws IOException signals that an I/O exception has occurred during redaction.
      */
     private void removeRedactAnnots() throws IOException {
         for (PdfRedactAnnotation annotation : redactAnnotations.keySet()) {

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

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

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

src/main/java/com/itextpdf/pdfcleanup/actions/data/PdfSweepProductData.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify
@@ -51,9 +51,9 @@ public class PdfSweepProductData {
     public static final String PDF_SWEEP_PRODUCT_NAME = "pdfSweep";
     public static final String PDF_SWEEP_PUBLIC_PRODUCT_NAME = PDF_SWEEP_PRODUCT_NAME;
 
-    private static final String PDF_SWEEP_VERSION = "3.0.0";
+    private static final String PDF_SWEEP_VERSION = "3.0.1";
     private static final int PDF_SWEEP_COPYRIGHT_SINCE = 2000;
-    private static final int PDF_SWEEP_COPYRIGHT_TO = 2021;
+    private static final int PDF_SWEEP_COPYRIGHT_TO = 2022;
 
     private static final ProductData PDF_SWEEP_PRODUCT_DATA = new ProductData(PDF_SWEEP_PUBLIC_PRODUCT_NAME,
             PDF_SWEEP_PRODUCT_NAME, PDF_SWEEP_VERSION, PDF_SWEEP_COPYRIGHT_SINCE, PDF_SWEEP_COPYRIGHT_TO);

src/main/java/com/itextpdf/pdfcleanup/actions/event/PdfSweepProductEvent.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

src/main/java/com/itextpdf/pdfcleanup/autosweep/CommonRegex.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

src/main/java/com/itextpdf/pdfcleanup/autosweep/CompositeCleanupStrategy.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify
@@ -62,21 +62,33 @@ This file is part of the iText (R) project.
 
 
 /**
- * This class is a composite pattern for {@code ICleanupStrategy}
+ * This class is a composite pattern for {@link ICleanupStrategy}.
  * It allows users to have multiple ICleanupStrategy implementations and bundle them as one.
  */
 public class CompositeCleanupStrategy implements ICleanupStrategy {
 
     private Map<Integer, Set<IPdfTextLocation>> locations = new HashMap<>();
     private List<ICleanupStrategy> strategies = new ArrayList<>();
 
+    /**
+     * Creates a {@link CompositeCleanupStrategy composite pattern} for {@link ICleanupStrategy cleanup strategies}.
+     */
     public CompositeCleanupStrategy() {
     }
 
-    public void add(ICleanupStrategy ies) {
-        strategies.add(ies);
+    /**
+     * Adds a {@link ICleanupStrategy cleanup strategy} to this {@link CompositeCleanupStrategy composite pattern}.
+     *
+     * @param strategy a {@link ICleanupStrategy cleanup strategy} to be added to this
+     *     {@link CompositeCleanupStrategy composite pattern}.
+     */
+    public void add(ICleanupStrategy strategy) {
+        strategies.add(strategy);
     }
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public Collection<IPdfTextLocation> getResultantLocations() {
         locations.clear();
@@ -104,10 +116,12 @@ public int compare(IPdfTextLocation l1, IPdfTextLocation l2) {
             }
         });
 
-        // return
         return rectangles;
     }
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public Color getRedactionColor(IPdfTextLocation location) {
         for (int i = 0; i < strategies.size(); i++) {
@@ -118,13 +132,19 @@ public Color getRedactionColor(IPdfTextLocation location) {
         return ColorConstants.BLACK;
     }
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public void eventOccurred(IEventData data, EventType type) {
         for (ILocationExtractionStrategy s : strategies) {
             s.eventOccurred(data, type);
         }
     }
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public Set<EventType> getSupportedEvents() {
         Set<EventType> evts = new HashSet<>();
@@ -136,13 +156,20 @@ public Set<EventType> getSupportedEvents() {
         return evts.isEmpty() ? null : evts;
     }
 
-    public ICleanupStrategy reset()
-    {
-        CompositeCleanupStrategy retval = new CompositeCleanupStrategy();
-        for(ICleanupStrategy s : strategies)
-        {
-            retval.add(s.reset());
+    /**
+     * Returns a {@link ICleanupStrategy cleanup strategy} which represents
+     * a reset {@link CompositeCleanupStrategy composite cleanup strategy}.
+     *
+     * <p>
+     * Note that all the inner {@link ICleanupStrategy strategies} will be reset as well.
+     *
+     * @return a reset {@link CompositeCleanupStrategy composite strategy}
+     */
+    public ICleanupStrategy reset() {
+        CompositeCleanupStrategy resetCompositeStrategy = new CompositeCleanupStrategy();
+        for(ICleanupStrategy s : strategies) {
+            resetCompositeStrategy.add(s.reset());
         }
-        return retval;
+        return resetCompositeStrategy;
     }
 }

src/main/java/com/itextpdf/pdfcleanup/autosweep/ICleanupStrategy.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

src/main/java/com/itextpdf/pdfcleanup/autosweep/PdfAutoSweepTools.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify

src/main/java/com/itextpdf/pdfcleanup/autosweep/RegexBasedCleanupStrategy.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is free software; you can redistribute it and/or modify
@@ -57,26 +57,51 @@ public class RegexBasedCleanupStrategy extends RegexBasedLocationExtractionStrat
     private Pattern pattern;
     private Color redactionColor = ColorConstants.BLACK;
 
+    /**
+     * Creates an object of regular expression based cleanup strategy.
+     *
+     * @param regex regular expression on which cleanup strategy will be based
+     */
     public RegexBasedCleanupStrategy(String regex) {
         super(regex);
         this.pattern = Pattern.compile(regex);
     }
 
+    /**
+     * Creates an object of regular expression based cleanup strategy.
+     *
+     * @param pattern {@link Pattern} pattern on which cleanup strategy will be based
+     */
     public RegexBasedCleanupStrategy(Pattern pattern) {
         super(pattern);
         this.pattern = pattern;
     }
 
+    /**
+     * {@inheritDoc}
+     */
     @Override
     public Color getRedactionColor(IPdfTextLocation location) {
         return redactionColor;
     }
 
+    /**
+     * Sets the color in which redaction is to take place.
+     *
+     * @param color the color in which redaction is to take place
+     * 
+     * @return this {@link RegexBasedCleanupStrategy strategy}
+     */
     public RegexBasedCleanupStrategy setRedactionColor(Color color) {
         this.redactionColor = color;
         return this;
     }
 
+    /**
+     * Returns an {@link ICleanupStrategy} object which is set to this regular pattern and redaction color.
+     *
+     * @return a reset {@link ICleanupStrategy cleanup strategy}
+     */
     public ICleanupStrategy reset() {
         return new RegexBasedCleanupStrategy(pattern).setRedactionColor(redactionColor);
     }

src/main/java/com/itextpdf/pdfcleanup/exceptions/CleanupExceptionMessageConstant.java

@@ -1,6 +1,6 @@
 /*
     This file is part of the iText (R) project.
-    Copyright (c) 1998-2021 iText Group NV
+    Copyright (c) 1998-2022 iText Group NV
     Authors: iText Software.
 
     This program is offered under a commercial and under the AGPL license.