Deprecate svg node renderer mapper interface

DEVSIX-4157

Author: BezrukovM

svg/src/main/java/com/itextpdf/svg/renderers/factories/DefaultSvgNodeRendererFactory.java

@@ -67,8 +67,7 @@ public class DefaultSvgNodeRendererFactory implements ISvgNodeRendererFactory {
     private Collection<String> ignoredTags = new HashSet<>();
 
     /**
-     * Default constructor which uses the default {@link ISvgNodeRendererMapper}
-     * implementation.
+     * Default constructor with default {@link ISvgNodeRenderer} creation logic.
      */
     public DefaultSvgNodeRendererFactory() {
         this(new DefaultSvgNodeRendererMapper());
@@ -80,7 +79,11 @@ public DefaultSvgNodeRendererFactory() {
      *
      * @param mapper the custom mapper implementation - if null, then we fall
      * back to the {@link DefaultSvgNodeRendererMapper}
+     * @deprecated Will be removed in 7.2. The user should use the custom
+     * {@link ISvgNodeRendererFactory} implementation (or the custom
+     * @link DefaultSvgNodeRendererFactory} extension) to create extensions of the factory.
      */
+    @Deprecated
     public DefaultSvgNodeRendererFactory(ISvgNodeRendererMapper mapper) {
         if (mapper != null) {
             rendererMap.putAll(mapper.getMapping());

svg/src/main/java/com/itextpdf/svg/renderers/factories/DefaultSvgNodeRendererMapper.java

@@ -73,7 +73,14 @@ This file is part of the iText (R) project.
  * default in the {@link DefaultSvgNodeRendererFactory}. It contains the mapping
  * of the default implementations, provided by this project for the standard SVG
  * tags as defined in the SVG Specification.
+ *
+ * @deprecated The public access to this class will be removed in 7.2. The class itself can become
+ * either package private or the inner private static class for
+ * the {@link DefaultSvgNodeRendererFactory}. Users should override {@link ISvgNodeRendererFactory}
+ * (or at least {@link DefaultSvgNodeRendererFactory}) and should not deal with the mapping class
+ * as it's more of an implementation detail.
  */
+@Deprecated
 public class DefaultSvgNodeRendererMapper implements ISvgNodeRendererMapper {
 
     @Override

svg/src/main/java/com/itextpdf/svg/renderers/factories/ISvgNodeRendererMapper.java

@@ -51,7 +51,13 @@ This file is part of the iText (R) project.
  * Interface that will provide a mapping from SVG tag names to Renderers that
  * will be able to draw them. It's used in {@link DefaultSvgNodeRendererFactory}
  * to allow customizability in client code, and dependency injection in tests.
+ *
+ * @deprecated The interface will be removed in 7.2, while its implementation
+ * ({@link DefaultSvgNodeRendererMapper}) will be used as our internal class. Users should
+ * override {@link ISvgNodeRendererFactory} (or at least {@link DefaultSvgNodeRendererFactory})
+ * and should not deal with the mapping class as it's more of an implementation detail.
  */
+@Deprecated
 public interface ISvgNodeRendererMapper {
 
     /**