Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Integration Server Built-In Services | XML Folder | Summary of Elements in this Folder | pub.xml:getNextXMLNode
 
pub.xml:getNextXMLNode
WmPublic. Gets the next XML node from a NodeIterator.
Input Parameters
iterator
com.wm.app.b2b.util.NodeIterator NodeIterator from which to retrieve the next node.
Output Parameters
next
Document Conditional. The requested node. Will be null when the NodeIterator has no more nodes to return. Otherwise, next will contain the following:
Key
Description
name
String Element type name of the node. If the element belongs to a namespace and the namespace was declared at the time the NodeIterator was constructed, name will have the prefix declared for that namespace. If the namespace is not declared, name will use prefix that occurs in the XML.
node
XML node identified by the input criteria used to originally generate the NodeIterator. node will be one of the following types and depends on what was supplied to the node input parameter for the pub.xml:getXMLNodeIterator: service:
*com.wm.lang.xml.Node
*enhanced XML node
It is possible that all calls to getNextXMLNode on a given NodeIterator will yield the same document instance, where the values of the instance's entries vary. For this reason, applications should assume that each call to getNextXMLNode invalidates the document returned by the previous call. This approach maximizes the speed of the server and minimizes the use of resources.
Usage Notes
A NodeIterator is acquired via the service pub.xml:getXMLNodeIterator. The output of that service is a document (IData object) containing the element type name of the node and the node itself. The instance of this document is only valid until the next getNextXMLNode call on the same NodeIterator, because getNextXMLNode uses the same document object for each call.