HTML Parser Home Page

org.htmlparser.util
Class NodeList

java.lang.Object
  extended by org.htmlparser.util.NodeList
All Implemented Interfaces:
Serializable

public class NodeList
extends Object
implements Serializable

See Also:
Serialized Form

Constructor Summary
NodeList()
           
NodeList(Node node)
          Create a one element node list.
 
Method Summary
 void add(Node node)
           
 void add(NodeList list)
          Add another node list to this one.
 String asString()
           
 boolean contains(Node node)
          Check to see if the NodeList contains the supplied Node.
 void copyToNodeArray(Node[] array)
           
 Node elementAt(int i)
           
 SimpleNodeIterator elements()
           
 NodeList extractAllNodesThatMatch(NodeFilter filter)
          Filter the list with the given filter non-recursively.
 NodeList extractAllNodesThatMatch(NodeFilter filter, boolean recursive)
          Filter the list with the given filter.
 int indexOf(Node node)
          Finds the index of the supplied Node.
 void keepAllNodesThatMatch(NodeFilter filter)
          Remove nodes not matching the given filter non-recursively.
 void keepAllNodesThatMatch(NodeFilter filter, boolean recursive)
          Remove nodes not matching the given filter.
 void prepend(Node node)
          Insert the given node at the head of the list.
 Node remove(int index)
          Remove the node at index.
 boolean remove(Node node)
          Remove the supplied Node from the list.
 void removeAll()
           
 int size()
           
 String toHtml()
          Convert this nodelist into the equivalent HTML.
 String toHtml(boolean verbatim)
          Convert this nodelist into the equivalent HTML.
 Node[] toNodeArray()
           
 String toString()
          Return the contents of the list as a string.
 void visitAllNodesWith(NodeVisitor visitor)
          Utility to apply a visitor to a node list.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

NodeList

public NodeList()

NodeList

public NodeList(Node node)
Create a one element node list.

Parameters:
node - The initial node to add.
Method Detail

add

public void add(Node node)

add

public void add(NodeList list)
Add another node list to this one.

Parameters:
list - The list to add.

prepend

public void prepend(Node node)
Insert the given node at the head of the list.

Parameters:
node - The new first element.

size

public int size()

elementAt

public Node elementAt(int i)

elements

public SimpleNodeIterator elements()

toNodeArray

public Node[] toNodeArray()

copyToNodeArray

public void copyToNodeArray(Node[] array)

asString

public String asString()

toHtml

public String toHtml(boolean verbatim)
Convert this nodelist into the equivalent HTML.

Parameters:
verbatim - If true return as close to the original page text as possible.
Returns:
The contents of the list as HTML text.

toHtml

public String toHtml()
Convert this nodelist into the equivalent HTML.

Returns:
The contents of the list as HTML text.

remove

public Node remove(int index)
Remove the node at index.

Parameters:
index - The index of the node to remove.
Returns:
The node that was removed.

removeAll

public void removeAll()

contains

public boolean contains(Node node)
Check to see if the NodeList contains the supplied Node.

Parameters:
node - The node to look for.
Returns:
True is the Node is in this NodeList.

indexOf

public int indexOf(Node node)
Finds the index of the supplied Node.

Parameters:
node - The node to look for.
Returns:
The index of the node in the list or -1 if it isn't found.

remove

public boolean remove(Node node)
Remove the supplied Node from the list.

Parameters:
node - The node to remove.
Returns:
True if the node was found and removed from the list.

toString

public String toString()
Return the contents of the list as a string. Suitable for debugging.

Overrides:
toString in class Object
Returns:
A string representation of the list.

extractAllNodesThatMatch

public NodeList extractAllNodesThatMatch(NodeFilter filter)
Filter the list with the given filter non-recursively.

Parameters:
filter - The filter to use.
Returns:
A new node array containing the nodes accepted by the filter. This is a linear list and preserves the nested structure of the returned nodes only.

extractAllNodesThatMatch

public NodeList extractAllNodesThatMatch(NodeFilter filter,
                                         boolean recursive)
Filter the list with the given filter.

Parameters:
filter - The filter to use.
recursive - If true digs into the children recursively.
Returns:
A new node array containing the nodes accepted by the filter. This is a linear list and preserves the nested structure of the returned nodes only.

keepAllNodesThatMatch

public void keepAllNodesThatMatch(NodeFilter filter)
Remove nodes not matching the given filter non-recursively.

Parameters:
filter - The filter to use.

keepAllNodesThatMatch

public void keepAllNodesThatMatch(NodeFilter filter,
                                  boolean recursive)
Remove nodes not matching the given filter.

Parameters:
filter - The filter to use.
recursive - If true digs into the children recursively.

visitAllNodesWith

public void visitAllNodesWith(NodeVisitor visitor)
                       throws ParserException
Utility to apply a visitor to a node list. Provides for a visitor to modify the contents of a page and get the modified HTML as a string with code like this:
 Parser parser = new Parser ("http://whatever");
 NodeList list = parser.parse (null); // no filter
 list.visitAllNodesWith (visitor);
 System.out.println (list.toHtml ());
 

Throws:
ParserException

© 2006 Derrick Oswald
Sep 17, 2006

HTML Parser is an open source library released under Common Public License. SourceForge.net