GPathResult (groovy-xml 2.3.0-rc-1 API)

groovy.util.slurpersupport.GPathResult

All Implemented Interfaces:

groovy.lang.Writable, groovy.lang.Buildable, Iterable
```
public abstract class GPathResult
extends groovy.lang.GroovyObjectSupport
```
Base class for representing lazy evaluated GPath expressions.
Authors:
John Wilson

Field Summary

Fields
Modifiers	Name	Description
`protected String`	`name`
`protected Map`	`namespaceMap`
`protected String`	`namespacePrefix`
`protected Map`	`namespaceTagHints`
`protected GPathResult`	`parent`

Constructor Summary

Constructors
Constructor and description
`GPathResult (GPathResult parent, String name, String namespacePrefix, Map namespaceTagHints)` Creates a new GPathResult named `name` with the parent `parent`, the namespacePrefix `namespacePrefix` and the namespaceTagHints specified in the `namespaceTagHints` Map.

Methods Summary

Methods
Type	Name and description
`protected void`	`appendNode(Object newValue)`
`Iterator`	`breadthFirst()` Provides an Iterator over all the nodes of this GPathResult using a breadth-first traversal.
`Iterator`	`childNodes()`
`GPathResult`	`children()` Returns the children of this GPathResult as a GPathResult object.
`GPathResult`	`declareNamespace(Map newNamespaceMapping)` Adds the specified map of prefix to namespace mappings to this GPathResult.
`Iterator`	`depthFirst()` Provides an Iterator over all the nodes of this GPathResult using a depth-first traversal.
`boolean`	`equals(Object obj)`
`GPathResult`	`find(groovy.lang.Closure closure)`
`GPathResult`	`findAll(groovy.lang.Closure closure)`
`Object`	`getAt(int index)` Supports the subscript operator for a GPathResult.
`Object`	`getAt(groovy.lang.IntRange range)` Supports the range subscript operator for a GPathResult.
`groovy.lang.Closure`	`getBody()`
`Object`	`getProperty(String property)` Returns the specified Property of this GPathResult.
`boolean`	`isEmpty()` Returns true if the GPathResult is empty, i.e. if, and only if, `size()` is 0.
`Iterator`	`iterator()`
`Object`	`leftShift(Object newValue)` Overloads the left shift operator to provide an easy way to lazily append Objects to this GPathResult.
`List`	`list()` Creates a list of objects representing this GPathResult.
`String`	`lookupNamespace(String prefix)` Returns the namespace mapped to the specified prefix.
`String`	`name()`
`Iterator`	`nodeIterator()`
`GPathResult`	`parent()` Returns as GPathResult with the parent nodes of the current GPathResult
`GPathResult`	`parents()`
`Object`	`plus(Object newValue)` Lazily adds the specified Object to this GPathResult.
`GPathResult`	`pop()` Returns the parent of this GPathResult.
`void`	`putAt(int index, Object newValue)`
`protected void`	`replaceBody(Object newValue)`
`protected void`	`replaceNode(groovy.lang.Closure newValue)`
`void`	`setMetaClass(groovy.lang.MetaClass metaClass)` Replaces the MetaClass of this GPathResult.
`void`	`setProperty(String property, Object newValue)` Replaces the specified property of this GPathResult with a new value.
`int`	`size()` Returns the size of this GPathResult.
`String`	`text()`
`BigDecimal`	`toBigDecimal()` Converts the text of this GPathResult to a BigDecimal object.
`BigInteger`	`toBigInteger()` Converts the text of this GPathResult to a BigInteger object.
`Boolean`	`toBoolean()` Converts the text of this GPathResult to a Boolean object.
`Double`	`toDouble()` Converts the text of this GPathResult to a Double object.
`Float`	`toFloat()` Converts the text of this GPathResult to a Float object.
`Integer`	`toInteger()` Converts the text of this GPathResult to a Integer object.
`Long`	`toLong()` Converts the text of this GPathResult to a Long object.
`String`	`toString()` Returns the text of this GPathResult.
`URI`	`toURI()` Converts the text of this GPathResult to a URI object.
`URL`	`toURL()` Converts the text of this GPathResult to a URL object.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class groovy.lang.GroovyObjectSupport`	groovy.lang.GroovyObjectSupport#getMetaClass(), groovy.lang.GroovyObjectSupport#setMetaClass(groovy.lang.MetaClass), groovy.lang.GroovyObjectSupport#invokeMethod(java.lang.String, java.lang.Object), groovy.lang.GroovyObjectSupport#setProperty(java.lang.String, java.lang.Object), groovy.lang.GroovyObjectSupport#getProperty(java.lang.String), groovy.lang.GroovyObjectSupport#wait(long, int), groovy.lang.GroovyObjectSupport#wait(long), groovy.lang.GroovyObjectSupport#wait(), groovy.lang.GroovyObjectSupport#equals(java.lang.Object), groovy.lang.GroovyObjectSupport#toString(), groovy.lang.GroovyObjectSupport#hashCode(), groovy.lang.GroovyObjectSupport#getClass(), groovy.lang.GroovyObjectSupport#notify(), groovy.lang.GroovyObjectSupport#notifyAll()
`class Object`	`wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll`

- Field Detail
  - protected final String name
  - protected final Map namespaceMap
  - protected final String namespacePrefix
  - protected final Map namespaceTagHints
  - protected final GPathResult parent
- Constructor Detail
  - public GPathResult(GPathResult parent, String name, String namespacePrefix, Map namespaceTagHints)
    
    Creates a new GPathResult named name with the parent parent, the namespacePrefix namespacePrefix and the namespaceTagHints specified in the namespaceTagHints Map.
    Parameters:
    parent - the GPathResult prior to the application of the expression creating this GPathResult
    name - if the GPathResult corresponds to something with a name, e.g. a node
    namespacePrefix - the namespace prefix if any
    namespaceTagHints - the known tag to namespace mappings
- Method Detail
  - protected void appendNode(Object newValue)
  - public Iterator breadthFirst()
    
    Provides an Iterator over all the nodes of this GPathResult using a breadth-first traversal.
    Returns:
    the Iterator of (breadth-first) ordered GPathResults
  - public Iterator childNodes()
  - public GPathResult children()
    
    Returns the children of this GPathResult as a GPathResult object.
    Returns:
    the children of this GPathResult
  - public GPathResult declareNamespace(Map newNamespaceMapping)
    
    Adds the specified map of prefix to namespace mappings to this GPathResult. Already existing prefixes are overwritten.
    Parameters:
    newNamespaceMapping - the mappings to add
    Returns:
    this
  - public Iterator depthFirst()
    
    Provides an Iterator over all the nodes of this GPathResult using a depth-first traversal.
    Returns:
    the Iterator of (depth-first) ordered GPathResults
  - public boolean equals(Object obj)
  - public GPathResult find(groovy.lang.Closure closure)
  - public GPathResult findAll(groovy.lang.Closure closure)
  - public Object getAt(int index)
    
    Supports the subscript operator for a GPathResult.
```
 def text = """
 <characterList>
   <character/>
   <character>
     <name>Gromit</name>
   </character>
 </characterList>"""

 GPathResult characterList = new XmlSlurper().parseText(text)

 assert characterList.character[1].name == 'Gromit'
 
```
    Parameters:
    index - an index
    Returns:
    the value at the given index
  - public Object getAt(groovy.lang.IntRange range)
    
    Supports the range subscript operator for a GPathResult.
```
 def text = """
 <characterList>
   <character>Wallace</character>
   <character>Gromit</character>
   <character>Shaun</character>
 </characterList>"""

 GPathResult characterList = new XmlSlurper().parseText(text)

 assert characterList.character[1..2].join(',') == 'Gromit,Shaun'
 
```
    Parameters:
    range - a Range indicating the items to get
    Returns:
    a new list based on range borders
  - public groovy.lang.Closure getBody()
  - public Object getProperty(String property)
    
    Returns the specified Property of this GPathResult.
    Realizes the follow shortcuts:
    - '..' for parent()
    - '*' for children()
    - '**' for depthFirst()
    - '@' for attribute access
    Parameters:
    property - the Property to fetch
  - public boolean isEmpty()
    
    Returns true if the GPathResult is empty, i.e. if, and only if, size() is 0.
    Returns:
    true if the GPathResult is empty
  - public Iterator iterator()
  - public Object leftShift(Object newValue)
    
    Overloads the left shift operator to provide an easy way to lazily append Objects to this GPathResult.
    Parameters:
    newValue - the Object to append
    Returns:
    this
  - public List list()
    
    Creates a list of objects representing this GPathResult.
    Returns:
    a list representing of this GPathResult
  - public String lookupNamespace(String prefix)
    
    Returns the namespace mapped to the specified prefix.
    Parameters:
    prefix - the prefix lookup
    Returns:
    the namespace of the prefix
  - public String name()
  - public Iterator nodeIterator()
  - public GPathResult parent()
    
    Returns as GPathResult with the parent nodes of the current GPathResult
    Returns:
    the parents GPathResult or this for the root
  - public GPathResult parents()
  - public Object plus(Object newValue)
    
    Lazily adds the specified Object to this GPathResult.
    Parameters:
    newValue - the Object to add
    Returns:
    this
  - public GPathResult pop()
    
    Returns the parent of this GPathResult. If this GPathResult has no parent the GPathResult itself is returned. This is no navigation in the XML tree. It is backtracking on the GPath expression chain. It is the behavior of parent() prior to 2.2.0. Backtracking on '..' actually goes down one level in the tree again. find() and findAll() are popped along with the level they have been applied to.
    Returns:
    the parent or this
  - public void putAt(int index, Object newValue)
  - protected void replaceBody(Object newValue)
  - protected void replaceNode(groovy.lang.Closure newValue)
  - @Override public void setMetaClass(groovy.lang.MetaClass metaClass)
    
    Replaces the MetaClass of this GPathResult.
    Parameters:
    metaClass - the new MetaClass
  - public void setProperty(String property, Object newValue)
    
    Replaces the specified property of this GPathResult with a new value.
    Parameters:
    property - the property of this GPathResult to replace
    newValue - the new value of the property
  - public int size()
    
    Returns the size of this GPathResult.
    Returns:
    the size of this GPathResult
  - public String text()
  - public BigDecimal toBigDecimal()
    
    Converts the text of this GPathResult to a BigDecimal object.
    Returns:
    the GPathResult, converted to a BigDecimal
  - public BigInteger toBigInteger()
    
    Converts the text of this GPathResult to a BigInteger object.
    Returns:
    the GPathResult, converted to a BigInteger
  - public Boolean toBoolean()
    
    Converts the text of this GPathResult to a Boolean object.
    Returns:
    the GPathResult, converted to a Boolean
  - public Double toDouble()
    
    Converts the text of this GPathResult to a Double object.
    Returns:
    the GPathResult, converted to a Double
  - public Float toFloat()
    
    Converts the text of this GPathResult to a Float object.
    Returns:
    the GPathResult, converted to a Float
  - public Integer toInteger()
    
    Converts the text of this GPathResult to a Integer object.
    Returns:
    the GPathResult, converted to a Integer
  - public Long toLong()
    
    Converts the text of this GPathResult to a Long object.
    Returns:
    the GPathResult, converted to a Long
  - public String toString()
    
    Returns the text of this GPathResult.
    Returns:
    the GPathResult, converted to a String
  - public URI toURI()
    
    Converts the text of this GPathResult to a URI object.
    Returns:
    the GPathResult, converted to a URI
  - public URL toURL()
    
    Converts the text of this GPathResult to a URL object.
    Returns:
    the GPathResult, converted to a URL

Summary:
Field
Constructor
Method

| Detail:
Field
Constructor
Method

[Java] Class GPathResult

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

protected final String name

protected final Map namespaceMap

protected final String namespacePrefix

protected final Map namespaceTagHints

protected final GPathResult parent

Constructor Detail

public GPathResult(GPathResult parent, String name, String namespacePrefix, Map namespaceTagHints)

Method Detail

protected void appendNode(Object newValue)

public Iterator breadthFirst()

public Iterator childNodes()

public GPathResult children()

public GPathResult declareNamespace(Map newNamespaceMapping)

public Iterator depthFirst()

public boolean equals(Object obj)

public GPathResult find(groovy.lang.Closure closure)

public GPathResult findAll(groovy.lang.Closure closure)

public Object getAt(int index)

public Object getAt(groovy.lang.IntRange range)

public groovy.lang.Closure getBody()

public Object getProperty(String property)

public boolean isEmpty()

public Iterator iterator()

public Object leftShift(Object newValue)

public List list()

public String lookupNamespace(String prefix)

public String name()

public Iterator nodeIterator()

public GPathResult parent()

public GPathResult parents()

public Object plus(Object newValue)

public GPathResult pop()

public void putAt(int index, Object newValue)

protected void replaceBody(Object newValue)

protected void replaceNode(groovy.lang.Closure newValue)

@Override public void setMetaClass(groovy.lang.MetaClass metaClass)

public void setProperty(String property, Object newValue)

public int size()

public String text()

public BigDecimal toBigDecimal()

public BigInteger toBigInteger()

public Boolean toBoolean()

public Double toDouble()

public Float toFloat()

public Integer toInteger()

public Long toLong()

public String toString()

public URI toURI()

public URL toURL()