IXPath

```
@StableMinor(version="10.2",
             sinceVersion="8.1")
public interface IXPath
```
Document navigator helper.

Since:

8.1.0

Version:

$Revision: 20413 $ $Date: 2017-07-20 19:57:40 +0000 (Thu, 20 Jul 2017) $

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`Map<String,Object>`	`getMap(String xpath)` Selects a node with the given XPath and converts it to a `Map`, by using `toMap(Node)`.
`Map<String,Object>`	`getMap(String xpath, Node context)` Selects a node with the given XPath and converts it to a `Map`, by using `toMap(Node)`.
`List<Map<String,Object>>`	`getMaps(String xpath)` Selects nodes with the given XPath and converts them to a `List` of `Map`, by using `toMap(Node)` in each of these nodes.
`List<Map<String,Object>>`	`getMaps(String xpath, Node context)` Selects nodes with the given XPath and converts them to a `List` of `Map`, by using `toMap(Node)` in each of these nodes.
`List<Node>`	`selectNodes(String xpath)` Returns a `node list` with the selected nodes by the given XPath using the document in context.
`List<Node>`	`selectNodes(String xpath, Node context)` Returns a `node list` with the selected nodes by the given XPath in the given `context`.
`Node`	`selectSingleNode(String xpath)` Returns a single node selected by the given XPath expression using the document in context.
`Node`	`selectSingleNode(String xpath, Node context)` Returns a single node selected by the given XPath expression in the given `context`.
`Map<String,Object>`	`toMap(Node node)` Returns a Map object based on the given node.
`String`	`valueOf(String xpath, Node context)` Returns the string representation of the evaluated XPath in the given context.

- Method Detail
  - valueOf
```
String valueOf(String xpath,
               Node context)
```
    Returns the string representation of the evaluated XPath in the given context.
    
    Parameters:
    
    xpath - the XPath expression.
    
    context - the context node.
    
    Returns:
    
    the string representation of the evaluated XPath in the given context.
    
    Since:
    
    8.1.0
  - selectNodes
```
List<Node> selectNodes(String xpath)
```
    Returns a node list with the selected nodes by the given XPath using the document in context.
    
    Parameters:
    
    xpath - the XPath expression.
    
    Returns:
    
    a node list with the selected nodes by the given XPath.
    
    Since:
    
    8.1.0
  - selectNodes
```
List<Node> selectNodes(String xpath,
                       Node context)
```
    Returns a node list with the selected nodes by the given XPath in the given context.
    
    Parameters:
    
    xpath - the XPath expression.
    
    context - the context node.
    
    Returns:
    
    a node list with the selected nodes by the given XPath.
    
    Since:
    
    8.1.0
  - selectSingleNode
```
Node selectSingleNode(String xpath)
```
    Returns a single node selected by the given XPath expression using the document in context. If more than one node is selected, the first one is returned. If there's no such node, null is returned.
    
    Parameters:
    
    xpath - the XPath expression.
    
    Returns:
    
    a single node selected by the given XPath expression
    
    Since:
    
    8.1.0
  - selectSingleNode
```
Node selectSingleNode(String xpath,
                      Node context)
```
    Returns a single node selected by the given XPath expression in the given context. If more than one node is selected, the first one is returned. If there's no such node, null is returned.
    
    Parameters:
    
    xpath - the XPath expression.
    
    context - the context node.
    
    Returns:
    
    a single node selected by the given XPath expression
    
    Since:
    
    8.1.0
  - toMap
```
Map<String,Object> toMap(Node node)
```
    Returns a Map object based on the given node.
    The conversion rules are as follows:
    Elements
    
    A XML element node will behave depending on its nature.
    If the element node is a simple element node, then its value will become available under the node name.
    For example, the given XML node:
    If the node is referenced like var myValue = myMap.myNode;, the variable myValue will have the value Some textother textanother text.
    It is important to notice that no white space will be automatically included between text and CDATA nodes.
    If the element node is a simple element node with attributes, then its value will become available under the $ object, inside the node object.
    For example, the given XML node:
    
    If the node is referenced like var myValue = myMap.myNode.$;, the variable myValue will have the value Some textother textanother text.
    It is important to notice that no white space will be automatically included between text and CDATA nodes.
    If the node is a complex node then its text (inner CDATA sections and text nodes) will not be accessible. This kind of node is simply a container for inner nodes.
    For example, the given XML node:
    
    The text of node myNode will not be accessible at all and the text of node myOtherNode will be accessible using myMap.myNode.myOtherNode.
    Another aspect of element nodes is when they are automatically wrapped in arrays. It happens in the following situations:
    
    If some element node has at least one sibling node with the very same name.
    
    If an element node has the attribute lumIsArray with the value true.
    
    If the parent node of some element node has a name that is the concatenation of the child node with the "s" suffix and the child element node either doesn't have the lumIsArray attribute or the value of lumIsArray attribute is not false.
    
    If the element node has the name row and its parent node name is data and the child element node either doesn't have the lumIsArray attribute or the value of lumIsArray attribute is not false.
    
    Attributes
    
    A XML element node attribute named myAttribute becomes available using the name $myAttribute. For example, the given XML node:
    Makes the attribute myAttribute available using myNode.$myAttribute.
    Simple element node
    
    Simple element node is a node that has the following aspects:
    
    Has no attributes.
    
    All of inner nodes are either CDATA sections or text nodes (comments are ignored).
    
    Simple element node with attributes
    
    Simple element node with attributes is a node that has the following aspects:
    
    Has at least one attribute.
    
    All of inner nodes are either CDATA sections or text nodes (comments are ignored).
    
    Simple element node value
    
    The value of a simple element node is the concatenation of all inner CDATA sections and text nodes.
    
    Complex node
    
    A complex node is a node that has at least one inner node that is neither a CDATA section nor a text node.
    Parameters:
    
    node - the node to be transformed in Map.
    
    Returns:
    
    a object based on the given node.
    
    Since:
    
    8.1.0
  - getMap
```
Map<String,Object> getMap(String xpath,
                          Node context)
```
    Selects a node with the given XPath and converts it to a Map, by using toMap(Node). If no node could be resolved with the given XPath, null will be returned.
    
    Parameters:
    
    xpath - the XPath.
    
    context - the context the given XPath is resolved from.
    
    Returns:
    
    the found node's map representation or null if no node matches the given XPath.
    
    Since:
    
    8.2.0
  - getMap
```
Map<String,Object> getMap(String xpath)
```
    Selects a node with the given XPath and converts it to a Map, by using toMap(Node). If no node could be resolved with the given XPath, null will be returned.
    
    Parameters:
    
    xpath - the XPath.
    
    Returns:
    
    the found node's map representation or null if no node matches the given XPath.
    
    Since:
    
    8.2.0
  - getMaps
```
List<Map<String,Object>> getMaps(String xpath,
                                 Node context)
```
    Selects nodes with the given XPath and converts them to a List of Map, by using toMap(Node) in each of these nodes. If no node could be resolved with the given XPath, an empty list will be returned.
    
    Parameters:
    
    xpath - the XPath.
    
    context - the context the given XPath is resolved from.
    
    Returns:
    
    the found nodes' list of maps representation.
    
    Since:
    
    8.2.0
  - getMaps
```
List<Map<String,Object>> getMaps(String xpath)
```
    Selects nodes with the given XPath and converts them to a List of Map, by using toMap(Node) in each of these nodes. If no node could be resolved with the given XPath, an empty list will be returned.
    
    Parameters:
    
    xpath - the XPath.
    
    Returns:
    
    the found nodes' list of maps representation.
    
    Since:
    
    8.2.0

Interface IXPath

Method Summary

Method Detail

valueOf

selectNodes

selectNodes

selectSingleNode

selectSingleNode

toMap

getMap

getMap

getMaps

getMaps