groovy.util
[Java] Class Node

java.lang.Object
  groovy.util.Node

All Implemented Interfaces:

Serializable

public class Node
extends Object

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" }}

Authors:

James Strachan

Paul King

Version:

\$Revision\$

Node

public Node(Node parent, Object name)

Creates a new Node named name and if a parent is supplied, adds the newly created node as a child of the parent.

Parameters:

parent - the parent node or null if no parent

name - the name of the node

Node

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

Creates a new Node named name with value value and if a parent is supplied, adds the newly created node as a child of the parent.

Parameters:

parent - the parent node or null if no parent

name - the name of the node

value - the Node value, e.g. some text but in general any Object

Node

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

Creates a new Node named name with attributes specified in the attributes Map. If a parent is supplied, the newly created node is added as a child of the parent.

Parameters:

parent - the parent node or null if no parent

name - the name of the node

attributes - a Map of name-value pairs

Node

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

Creates a new Node named name with value value and with attributes specified in the attributes Map. If a parent is supplied, the newly created node is added as a child of the parent.

Parameters:

parent - the parent node or null if no parent

name - the name of the node

attributes - a Map of name-value pairs

value - the Node value, e.g. some text but in general any Object

append

public boolean append(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)

attribute

public Object attribute(Object key)

attributes

public Map attributes()

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

children

public List children()

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

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

iterator

public Iterator iterator()

name

public Object name()

parent

public Node parent()

plus

public void plus(Closure c)

print

public void print(PrintWriter out)

remove

public boolean remove(Node child)

replaceNode

public Node replaceNode(Closure c)

setMetaClass

protected static void setMetaClass(MetaClass metaClass, Class nodeClass)

setValue

public void setValue(Object value)

text

public String text()

toString

public String toString()

value

public Object value()

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