android.sax
Class RootElement

java.lang.Object
  android.sax.Element
      android.sax.RootElement

public class RootElement
extends Element

The root XML element. The entry point for this API. Not safe for concurrent use.

For example, passing this XML:

 <feed xmlns='http://www.w3.org/2005/Atom'>
   <entry>
     <id>bob</id>
   </entry>
 </feed>
 

to this code:

 static final String ATOM_NAMESPACE = "http://www.w3.org/2005/Atom";

 ...
 
 RootElement root = new RootElement(ATOM_NAMESPACE, "feed");
 Element entry = root.getChild(ATOM_NAMESPACE, "entry");
 entry.getChild(ATOM_NAMESPACE, "id").setEndTextElementListener(
   new EndTextElementListener() {
     public void end(String body) {
       System.out.println("Entry ID: " + body);
     }
   });

 XMLReader reader = ...;
 reader.setContentHandler(root.getContentHandler());
 reader.parse(...);
 

would output:

 Entry ID: bob
 

Nested Class Summary

(package private) class

RootElement.Handler

Field Summary

(package private) RootElement.Handler

handler

Fields inherited from class android.sax.Element

children, depth, endElementListener, endTextElementListener, localName, parent, requiredChilden, startElementListener, uri, visited

Constructor Summary

RootElement(String localName)
Constructs a new root element with the given name.

RootElement(String uri, String localName)
Constructs a new root element with the given name.

Method Summary

ContentHandler

getContentHandler() Gets the SAX ContentHandler.

Methods inherited from class android.sax.Element

checkRequiredChildren, getChild, getChild, requireChild, requireChild, resetRequiredChildren, setElementListener, setEndElementListener, setEndTextElementListener, setStartElementListener, setTextElementListener, toString, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

handler

final RootElement.Handler handler

Constructor Detail

RootElement

public RootElement(String uri,
                   String localName)

Constructs a new root element with the given name.

Parameters:

uri - the namespace

localName - the local name

RootElement

public RootElement(String localName)

Constructs a new root element with the given name. Uses an empty string as the namespace.

Parameters:

localName - the local name

Method Detail

getContentHandler

public ContentHandler getContentHandler()

Gets the SAX ContentHandler. Pass this to your SAX parser.