Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/sax/RootElement#pubctors) \| [Methods](https://developer.android.com/reference/android/sax/RootElement#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/sax/RootElement#inhmethods)

# RootElement

*** ** * ** ***


`
public


class
RootElement
`


`


`

`

extends https://developer.android.com/reference/android/sax/Element


`

`


`

|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||
| ↳ | [android.sax.Element](https://developer.android.com/reference/android/sax/Element) ||
|   | ↳ | android.sax.RootElement |

<br />

*** ** * ** ***

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
```

<br />

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/sax/RootElement#RootElement(java.lang.String)(https://developer.android.com/reference/java/lang/String localName) ` Constructs a new root element with the given name. |
| ` https://developer.android.com/reference/android/sax/RootElement#RootElement(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String uri, https://developer.android.com/reference/java/lang/String localName) ` Constructs a new root element with the given name. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/org/xml/sax/ContentHandler` | ` https://developer.android.com/reference/android/sax/RootElement#getContentHandler()() ` Gets the SAX `ContentHandler`. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/android/sax/Element ` |---|---| | ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#getChild(java.lang.String)(https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. | | ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#getChild(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String uri, https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. | | ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#requireChild(java.lang.String)(https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. | | ` https://developer.android.com/reference/android/sax/Element` | ` https://developer.android.com/reference/android/sax/Element#requireChild(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String uri, https://developer.android.com/reference/java/lang/String localName) ` Gets the child element with the given name. | | ` void` | ` https://developer.android.com/reference/android/sax/Element#setElementListener(android.sax.ElementListener)(https://developer.android.com/reference/android/sax/ElementListener elementListener) ` Sets start and end element listeners at the same time. | | ` void` | ` https://developer.android.com/reference/android/sax/Element#setEndElementListener(android.sax.EndElementListener)(https://developer.android.com/reference/android/sax/EndElementListener endElementListener) ` Sets a listener for the end of this element. | | ` void` | ` https://developer.android.com/reference/android/sax/Element#setEndTextElementListener(android.sax.EndTextElementListener)(https://developer.android.com/reference/android/sax/EndTextElementListener endTextElementListener) ` Sets a listener for the end of this text element. | | ` void` | ` https://developer.android.com/reference/android/sax/Element#setStartElementListener(android.sax.StartElementListener)(https://developer.android.com/reference/android/sax/StartElementListener startElementListener) ` Sets a listener for the start of this element. | | ` void` | ` https://developer.android.com/reference/android/sax/Element#setTextElementListener(android.sax.TextElementListener)(https://developer.android.com/reference/android/sax/TextElementListener elementListener) ` Sets start and end text element listeners at the same time. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/sax/Element#toString()() ` Returns a string representation of the object. | ||
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||

## Public constructors

### RootElement

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public RootElement (String localName)
```

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

<br />

| Parameters ||
|---|---|
| `localName` | `String`: the local name <br /> |

### RootElement

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public RootElement (String uri, 
                String localName)
```

Constructs a new root element with the given name.

<br />

| Parameters ||
|---|---|
| `uri` | `String`: the namespace <br /> |
| `localName` | `String`: the local name <br /> |

## Public methods

### getContentHandler

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public ContentHandler getContentHandler ()
```

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

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/org/xml/sax/ContentHandler` | <br /> |