## groovy.util
Class Node

    java.lang.Object
      groovy.util.Node

All Implemented Interfaces:
  Serializable

    public class Node

extends Object
implements Serializable

Represents an arbitrary tree node which can be used for structured metadata or any arbitrary XML-like tree. A node can have a name, a value and an optional Map of attributes. Typically the name is a String and a value is either a String or a List of other Nodes, though the types are extensible to provide a flexible structure, e.g. you could use a QName as the name which includes a namespace URI and a local name. Or a JMX ObjectName etc. So this class can represent metadata like `{foo a=1 b="abc"}` or nested metadata like `{foo a=1 b="123" { bar x=12 text="hello" }}`

Version:
  $Revision: 10937 $
Author:
  James Strachan, Paul King
See Also:
  Serialized Form

Constructor Summary
`Node(Node parent, Object name)`
`Node(Node parent, Object name, Map attributes)`
`Node(Node parent, Object name, Map attributes, Object value)`
`Node(Node parent, Object name, Object value)`

Method Summary
`boolean` `append(Node child)`
`Node` `appendNode(Object name)`
`Node` `appendNode(Object name, Map attributes)`
`Node` `appendNode(Object name, Map attributes, Object value)`
`Node` `appendNode(Object name, Object value)`
`Object` `attribute(Object key)`
`Map` `attributes()`
`List` `breadthFirst()` Provide a collection of all the nodes in the tree using a breadth-first traversal.
`List` `children()`
`List` `depthFirst()` Provide a collection of all the nodes in the tree using a depth first traversal.
`Object` `get(String key)` Provides lookup of elements by non-namespaced name
`NodeList` `getAt(QName name)` Provides lookup of elements by QName.
`Iterator` `iterator()`
`Object` `name()`
`Node` `parent()`
`void` `print(PrintWriter out)`
`boolean` `remove(Node child)`
`void` `setValue(Object value)`
`String` `text()`
`String` `toString()`
`Object` `value()`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### Node

    public Node(Node parent,
                Object name)

### Node

    public Node(Node parent,
                Object name,
                Object value)

### Node

    public Node(Node parent,
                Object name,
                Map attributes)

### Node

    public Node(Node parent,
                Object name,
                Map attributes,
                Object value)

Method Detail

### append

    public boolean append(Node child)

### remove

    public boolean remove(Node child)

### appendNode

    public Node appendNode(Object name,
                           Map attributes)

### appendNode

    public Node appendNode(Object name)

### appendNode

    public Node appendNode(Object name,
                           Object value)

### appendNode

    public Node appendNode(Object name,
                           Map attributes,
                           Object value)

### text

    public String text()

### iterator

    public Iterator iterator()

### children

    public List children()

### attributes

    public Map attributes()

### attribute

    public Object attribute(Object key)

### name

    public Object name()

### value

    public Object value()

### setValue

    public void setValue(Object value)

### parent

    public Node parent()

### get

    public Object get(String key)

  Provides lookup of elements by non-namespaced name

  Parameters:
    `key` - the name (or shortcut key) of the node(s) of interest
  Returns:
    the nodes which match key

### getAt

    public NodeList getAt(QName name)

  Provides lookup of elements by QName.

  Parameters:
    `name` - the QName of interest
  Returns:
    the nodes matching name

### depthFirst

    public List depthFirst()

  Provide a collection of all the nodes in the tree using a depth first traversal.

  Returns:
    the list of (depth-first) ordered nodes

### breadthFirst

    public List breadthFirst()

  Provide a collection of all the nodes in the tree using a breadth-first traversal.

  Returns:
    the list of (breadth-first) ordered nodes

### toString

    public String toString()

  Overrides:
    `toString` in class `Object`

### print

    public void print(PrintWriter out)

Copyright © 2003-2008 The Codehaus. All rights reserved.