BUG-865: deprecate publicly-visible constructor

XmlStreamUtils should become a final class in the future, deprecate the
protected constructor so that we can remove it in the future.

Change-Id: I29d31e3b4e569ec80953b12cba9d1024c2298d30
Signed-off-by: Robert Varga <robert.varga@pantheon.sk>

diff --git a/yang/yang-data-impl/src/main/java/org/opendaylight/yangtools/yang/data/impl/codec/xml/XmlStreamUtils.java b/yang/yang-data-impl/src/main/java/org/opendaylight/yangtools/yang/data/impl/codec/xml/XmlStreamUtils.java
index ca84b1051c4ad58b3a24e944931bec2c8a18ba58..b1f9805517e5248471cfc8d07a7ee8129ead1da1 100644 (file)
--- a/yang/yang-data-impl/src/main/java/org/opendaylight/yangtools/yang/data/impl/codec/xml/XmlStreamUtils.java
+++ b/yang/yang-data-impl/src/main/java/org/opendaylight/yangtools/yang/data/impl/codec/xml/XmlStreamUtils.java
@@ -43,6 +43,11 @@ public class XmlStreamUtils {
     private final XmlCodecProvider codecProvider;
     private final Optional<SchemaContext> schemaContext;
 
+    /**
+     * @deprecated Use {@link #create(XmlCodecProvider)} instead. This method will be hidden and the class
+     *             made final in a future release.
+     */
+    @Deprecated
     protected XmlStreamUtils(final XmlCodecProvider codecProvider) {
         this(codecProvider, null);
     }
@@ -59,7 +64,11 @@ public class XmlStreamUtils {
      * @return A new instance
      */
     public static XmlStreamUtils create(final XmlCodecProvider codecProvider) {
-        return new XmlStreamUtils(codecProvider);
+        return new XmlStreamUtils(codecProvider, null);
+    }
+
+    public static XmlStreamUtils create(final XmlCodecProvider codecProvider, final SchemaContext schemaContext) {
+        return new XmlStreamUtils(codecProvider, schemaContext);
     }
 
     @VisibleForTesting
@@ -212,8 +221,4 @@ public class XmlStreamUtils {
             writer.writeNamespace(p, ns);
         }
     }
-
-    public static XmlStreamUtils create(final XmlCodecProvider codecProvider, final SchemaContext schemaContext) {
-        return new XmlStreamUtils(codecProvider, schemaContext);
-    }
 }