--- old/src/java.xml.ws/share/classes/javax/xml/soap/Node.java 2015-07-09 12:13:54.000000000 +0200
+++ new/src/java.xml.ws/share/classes/javax/xml/soap/Node.java 2015-07-09 12:13:53.000000000 +0200
@@ -1,5 +1,5 @@
/*
- * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@@ -35,19 +35,19 @@
*/
public interface Node extends org.w3c.dom.Node {
/**
- * Returns the value of this node if this is a Text
node or the
+ * Returns the value of this node if this is a {@code Text} node or the
* value of the immediate child of this node otherwise.
- * If there is an immediate child of this Node
that it is a
- * Text
node then it's value will be returned. If there is
- * more than one Text
node then the value of the first
- * Text
Node will be returned.
- * Otherwise null
is returned.
- *
- * @return a String
with the text of this node if this is a
- * Text
node or the text contained by the first
- * immediate child of this Node
object that is a
- * Text
object if such a child exists;
- * null
otherwise.
+ * If there is an immediate child of this {@code Node} that it is a
+ * {@code Text} node then it's value will be returned. If there is
+ * more than one {@code Text} node then the value of the first
+ * {@code Text} Node will be returned.
+ * Otherwise {@code null} is returned.
+ *
+ * @return a {@code String} with the text of this node if this is a
+ * {@code Text} node or the text contained by the first
+ * immediate child of this {@code Node} object that is a
+ * {@code Text} object if such a child exists;
+ * {@code null} otherwise.
*/
public String getValue();
@@ -55,24 +55,24 @@
* If this is a Text node then this method will set its value,
* otherwise it sets the value of the immediate (Text) child of this node.
* The value of the immediate child of this node can be set only if, there is
- * one child node and that node is a Text
node, or if
- * there are no children in which case a child Text
node will be
+ * one child node and that node is a {@code Text} node, or if
+ * there are no children in which case a child {@code Text} node will be
* created.
*
- * @exception IllegalStateException if the node is not a Text
+ * @exception IllegalStateException if the node is not a {@code Text}
* node and either has more than one child node or has a child
- * node that is not a Text
node.
+ * node that is not a {@code Text} node.
*
* @since 1.6, SAAJ 1.2
*/
public void setValue(String value);
/**
- * Sets the parent of this Node
object to the given
- * SOAPElement
object.
+ * Sets the parent of this {@code Node} object to the given
+ * {@code SOAPElement} object.
*
- * @param parent the SOAPElement
object to be set as
- * the parent of this Node
object
+ * @param parent the {@code SOAPElement} object to be set as
+ * the parent of this {@code Node} object
*
* @exception SOAPException if there is a problem in setting the
* parent to the given element
@@ -81,13 +81,13 @@
public void setParentElement(SOAPElement parent) throws SOAPException;
/**
- * Returns the parent element of this Node
object.
- * This method can throw an UnsupportedOperationException
+ * Returns the parent element of this {@code Node} object.
+ * This method can throw an {@code UnsupportedOperationException}
* if the tree is not kept in memory.
*
- * @return the SOAPElement
object that is the parent of
- * this Node
object or null
if this
- * Node
object is root
+ * @return the {@code SOAPElement} object that is the parent of
+ * this {@code Node} object or {@code null} if this
+ * {@code Node} object is root
*
* @exception UnsupportedOperationException if the whole tree is not
* kept in memory
@@ -96,18 +96,18 @@
public SOAPElement getParentElement();
/**
- * Removes this Node
object from the tree.
+ * Removes this {@code Node} object from the tree.
*/
public void detachNode();
/**
- * Notifies the implementation that this Node
+ * Notifies the implementation that this {@code Node}
* object is no longer being used by the application and that the
* implementation is free to reuse this object for nodes that may
* be created later.
*
- * Calling the method recycleNode
implies that the method
- * detachNode
has been called previously.
+ * Calling the method {@code recycleNode} implies that the method
+ * {@code detachNode} has been called previously.
*/
public void recycleNode();