feat(#277): fix all the code offences

jcabi · Dec 5, 2024 · 5709e1a · 5709e1a
1 parent 4520d07
commit 5709e1a
Show file tree

Hide file tree

Showing 4 changed files with 23 additions and 5 deletions.
diff --git a/src/main/java/com/jcabi/xml/SaxonDocument.java b/src/main/java/com/jcabi/xml/SaxonDocument.java
@@ -200,7 +200,13 @@ public XML merge(final NamespaceContext context) {
         );
     }
 
-    @Override
+    /**
+     * Retrieve DOM node, represented by this wrapper.
+     * This method works exactly the same as {@link #deepCopy()}.
+     * @deprecated Use {@link #inner()} or {@link #deepCopy()} instead.
+     * @return Deep copy of the inner DOM node.
+     */
+    @Deprecated
     public Node node() {
         throw new UnsupportedOperationException(
             String.format(SaxonDocument.UNSUPPORTED, "node")

diff --git a/src/main/java/com/jcabi/xml/StrictXML.java b/src/main/java/com/jcabi/xml/StrictXML.java
@@ -156,7 +156,13 @@ public XML merge(final NamespaceContext context) {
         return this.origin.merge(context);
     }
 
-    @Override
+    /**
+     * Retrieve DOM node, represented by this wrapper.
+     * This method works exactly the same as {@link #deepCopy()}.
+     * @deprecated Use {@link #inner()} or {@link #deepCopy()} instead.
+     * @return Deep copy of the inner DOM node.
+     */
+    @Deprecated
     public Node node() {
         return this.origin.deepCopy();
     }

diff --git a/src/main/java/com/jcabi/xml/XML.java b/src/main/java/com/jcabi/xml/XML.java
@@ -161,9 +161,9 @@ public interface XML {
 
     /**
      * Retrieve DOM node, represented by this wrapper.
-     * This method is deprecated, use {@link #inner()} ()} and {@link #deepCopy()} methods instead.
      * This method works exactly the same as {@link #deepCopy()}.
-     * @return DOM node
+     * @deprecated Use {@link #inner()} or {@link #deepCopy()} instead.
+     * @return Deep copy of the inner DOM node.
      */
     @Deprecated
     Node node();

diff --git a/src/main/java/com/jcabi/xml/XMLDocument.java b/src/main/java/com/jcabi/xml/XMLDocument.java
@@ -308,7 +308,13 @@ public int hashCode() {
         return this.cache.hashCode();
     }
 
-    @Override
+    /**
+     * Retrieve DOM node, represented by this wrapper.
+     * This method works exactly the same as {@link #deepCopy()}.
+     * @deprecated Use {@link #inner()} or {@link #deepCopy()} instead.
+     * @return Deep copy of the inner DOM node.
+     */
+    @Deprecated
     public Node node() {
         return this.deepCopy();
     }