Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Protected Ctors](https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#proctors) \| [Methods](https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#inhmethods)
# DocumentBuilderFactory
` public abstract class DocumentBuilderFactory `
` extends https://developer.android.com/reference/java/lang/Object ` ` `
|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | javax.xml.parsers.DocumentBuilderFactory |
*** ** * ** ***
Defines a factory API that enables applications to obtain a parser that produces DOM object trees from XML documents.
## Summary
| ### Protected constructors ||
|---|---|
| ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#DocumentBuilderFactory()() ` |
| ### Public methods ||
|---|---|
| ` abstract https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#getAttribute(java.lang.String)(https://developer.android.com/reference/java/lang/String name) ` Allows the user to retrieve specific attributes on the underlying implementation. |
| ` abstract boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#getFeature(java.lang.String)(https://developer.android.com/reference/java/lang/String name) `
Get the state of the named feature. |
| ` https://developer.android.com/reference/javax/xml/validation/Schema` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#getSchema()() ` Gets the `https://developer.android.com/reference/javax/xml/validation/Schema` object specified through the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setSchema(javax.xml.validation.Schema)` method. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isCoalescing()() ` Indicates whether or not the factory is configured to produce parsers which converts CDATA nodes to Text nodes and appends it to the adjacent (if any) Text node. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isExpandEntityReferences()() ` Indicates whether or not the factory is configured to produce parsers which expand entity reference nodes. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isIgnoringComments()() ` Indicates whether or not the factory is configured to produce parsers which ignores comments. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isIgnoringElementContentWhitespace()() ` Indicates whether or not the factory is configured to produce parsers which ignore ignorable whitespace in element content. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isNamespaceAware()() ` Indicates whether or not the factory is configured to produce parsers which are namespace aware. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isValidating()() ` Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse. |
| ` boolean` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isXIncludeAware()() `
Get state of XInclude processing. |
| ` static https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDefaultInstance()() ` Creates a new instance of the `DocumentBuilderFactory` builtin system-default implementation. |
| ` static https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDefaultNSInstance()() ` Creates a new NamespaceAware instance of the `DocumentBuilderFactory` builtin system-default implementation. |
| ` abstract https://developer.android.com/reference/javax/xml/parsers/DocumentBuilder` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDocumentBuilder()() ` Creates a new instance of a `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilder` using the currently configured parameters. |
| ` static https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newInstance()() ` Returns Android's implementation of `DocumentBuilderFactory`. |
| ` static https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newInstance(java.lang.String,%20java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/String factoryClassName, https://developer.android.com/reference/java/lang/ClassLoader classLoader) ` Returns an instance of the named implementation of `DocumentBuilderFactory`. |
| ` static https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newNSInstance(java.lang.String,%20java.lang.ClassLoader)(https://developer.android.com/reference/java/lang/String factoryClassName, https://developer.android.com/reference/java/lang/ClassLoader classLoader) ` Creates a new NamespaceAware instance of a `DocumentBuilderFactory` from the class name. |
| ` static https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newNSInstance()() ` Creates a new NamespaceAware, Android-specific instance of a `DocumentBuilderFactory`. |
| ` abstract void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setAttribute(java.lang.String,%20java.lang.Object)(https://developer.android.com/reference/java/lang/String name, https://developer.android.com/reference/java/lang/Object value) ` Allows the user to set specific attributes on the underlying implementation. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setCoalescing(boolean)(boolean coalescing) ` Specifies that the parser produced by this code will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setExpandEntityReferences(boolean)(boolean expandEntityRef) ` Specifies that the parser produced by this code will expand entity reference nodes. |
| ` abstract void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setFeature(java.lang.String,%20boolean)(https://developer.android.com/reference/java/lang/String name, boolean value) `
Set a feature for this `DocumentBuilderFactory` and `DocumentBuilder`s created by this factory. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setIgnoringComments(boolean)(boolean ignoreComments) `
Specifies that the parser produced by this code will ignore comments. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setIgnoringElementContentWhitespace(boolean)(boolean whitespace) ` Specifies that the parsers created by this factory must eliminate whitespace in element content (sometimes known loosely as 'ignorable whitespace') when parsing XML documents (see XML Rec 2.10). |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setNamespaceAware(boolean)(boolean awareness) ` Specifies that the parser produced by this code will provide support for XML namespaces. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setSchema(javax.xml.validation.Schema)(https://developer.android.com/reference/javax/xml/validation/Schema schema) `
Set the `https://developer.android.com/reference/javax/xml/validation/Schema` to be used by parsers created from this factory. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setValidating(boolean)(boolean validating) ` Specifies that the parser produced by this code will validate documents as they are parsed. |
| ` void` | ` https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setXIncludeAware(boolean)(boolean state) `
Set state of XInclude processing. |
### Inherited methods
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*.
## Protected constructors
### DocumentBuilderFactory
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
protected DocumentBuilderFactory ()
```
## Public methods
### getAttribute
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public abstract Object getAttribute (String name)
```
Allows the user to retrieve specific attributes on the underlying implementation.
| Parameters ||
|---|---|
| `name` | `String`: The name of the attribute.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Object` | value The value of the attribute.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | thrown if the underlying implementation doesn't recognize the attribute. |
### getFeature
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public abstract boolean getFeature (String name)
```
Get the state of the named feature.
Feature names are fully qualified `https://developer.android.com/reference/java/net/URI`s. Implementations may define their own features. An `https://developer.android.com/reference/javax/xml/parsers/ParserConfigurationException` is thrown if this `DocumentBuilderFactory` or the `DocumentBuilder`s it creates cannot support the feature. It is possible for an `DocumentBuilderFactory` to expose a feature value but be unable to change its state.
| Parameters ||
|---|---|
| `name` | `String`: Feature name.
|
| Returns ||
|---|---|
| `boolean` | State of the named feature.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/ParserConfigurationException` | if this `DocumentBuilderFactory` or the `DocumentBuilder`s it creates cannot support this feature. |
### getSchema
Added in [API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public Schema getSchema ()
```
Gets the `https://developer.android.com/reference/javax/xml/validation/Schema` object specified through the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setSchema(javax.xml.validation.Schema)` method.
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/validation/Schema` | the `https://developer.android.com/reference/javax/xml/validation/Schema` object that was last set through the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setSchema(javax.xml.validation.Schema)` method, or null if the method was not invoked since a `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` is created.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/UnsupportedOperationException` | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
### isCoalescing
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isCoalescing ()
```
Indicates whether or not the factory is configured to produce parsers which converts CDATA nodes to Text nodes and appends it to the adjacent (if any) Text node.
| Returns ||
|---|---|
| `boolean` | true if the factory is configured to produce parsers which converts CDATA nodes to Text nodes and appends it to the adjacent (if any) Text node; false otherwise.
|
### isExpandEntityReferences
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isExpandEntityReferences ()
```
Indicates whether or not the factory is configured to produce parsers which expand entity reference nodes.
| Returns ||
|---|---|
| `boolean` | true if the factory is configured to produce parsers which expand entity reference nodes; false otherwise.
|
### isIgnoringComments
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isIgnoringComments ()
```
Indicates whether or not the factory is configured to produce parsers which ignores comments.
| Returns ||
|---|---|
| `boolean` | true if the factory is configured to produce parsers which ignores comments; false otherwise.
|
### isIgnoringElementContentWhitespace
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isIgnoringElementContentWhitespace ()
```
Indicates whether or not the factory is configured to produce parsers which ignore ignorable whitespace in element content.
| Returns ||
|---|---|
| `boolean` | true if the factory is configured to produce parsers which ignore ignorable whitespace in element content; false otherwise.
|
### isNamespaceAware
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isNamespaceAware ()
```
Indicates whether or not the factory is configured to produce parsers which are namespace aware.
| Returns ||
|---|---|
| `boolean` | true if the factory is configured to produce parsers which are namespace aware; false otherwise.
|
### isValidating
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isValidating ()
```
Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse.
| Returns ||
|---|---|
| `boolean` | true if the factory is configured to produce parsers which validate the XML content during parse; false otherwise.
|
### isXIncludeAware
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public boolean isXIncludeAware ()
```
Get state of XInclude processing.
| Returns ||
|---|---|
| `boolean` | current state of XInclude processing
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/UnsupportedOperationException` | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
### newDefaultInstance
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static DocumentBuilderFactory newDefaultInstance ()
```
Creates a new instance of the `DocumentBuilderFactory` builtin system-default implementation.
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | A new instance of the `DocumentBuilderFactory` builtin system-default implementation.
|
### newDefaultNSInstance
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static DocumentBuilderFactory newDefaultNSInstance ()
```
Creates a new NamespaceAware instance of the `DocumentBuilderFactory` builtin system-default implementation. Parsers produced by the factory instance provides support for XML namespaces by default.
##### Implementation Requirements:
- In addition to creating a factory instance using the same process as `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDefaultInstance()`, this method must set NamespaceAware to true.
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | a new instance of the `DocumentBuilderFactory` builtin system-default implementation.
|
### newDocumentBuilder
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public abstract DocumentBuilder newDocumentBuilder ()
```
Creates a new instance of a `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilder` using the currently configured parameters.
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilder` | A new instance of a DocumentBuilder.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/ParserConfigurationException` | if a DocumentBuilder cannot be created which satisfies the configuration requested. |
### newInstance
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static DocumentBuilderFactory newInstance ()
```
Returns Android's implementation of `DocumentBuilderFactory`. Unlike other Java implementations, this method does not consult system properties, property files, or the services API. On Android this is the same as `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDefaultInstance()`.
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | a new DocumentBuilderFactory.
|
### newInstance
Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static DocumentBuilderFactory newInstance (String factoryClassName,
ClassLoader classLoader)
```
Returns an instance of the named implementation of `DocumentBuilderFactory`.
| Parameters ||
|---|---|
| `factoryClassName` | `String`
|
| `classLoader` | `ClassLoader`
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` |
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/FactoryConfigurationError` | if `factoryClassName` is not available or cannot be instantiated. |
### newNSInstance
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static DocumentBuilderFactory newNSInstance (String factoryClassName,
ClassLoader classLoader)
```
Creates a new NamespaceAware instance of a `DocumentBuilderFactory` from the class name. Parsers produced by the factory instance provides support for XML namespaces by default.
##### Implementation Requirements:
- In addition to creating a factory instance using the same process as `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newInstance(java.lang.String,%20java.lang.ClassLoader)`, this method must set NamespaceAware to true.
| Parameters ||
|---|---|
| `factoryClassName` | `String`: a fully qualified factory class name that provides implementation of `javax.xml.parsers.DocumentBuilderFactory`.
|
| `classLoader` | `ClassLoader`: the `ClassLoader` used to load the factory class. If it is `null`, the current `Thread`'s context classLoader is used to load the factory class.
|
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | a new instance of a `DocumentBuilderFactory`
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/FactoryConfigurationError` | if `factoryClassName` is `null`, or the factory class cannot be loaded, instantiated. |
### newNSInstance
Added in [API level 37](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public static DocumentBuilderFactory newNSInstance ()
```
Creates a new NamespaceAware, Android-specific instance of a `DocumentBuilderFactory`. Unlike other Java implementations, this method does not consult system properties, property files, or the services API. On Android this is the same as `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDefaultNSInstance()`.
##### Implementation Requirements:
- In addition to creating a factory instance using the same process as `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newInstance()`, this method must set NamespaceAware to true.
| Returns ||
|---|---|
| `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory` | a new instance of a `DocumentBuilderFactory`
|
### setAttribute
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public abstract void setAttribute (String name,
Object value)
```
Allows the user to set specific attributes on the underlying implementation.
| Parameters ||
|---|---|
| `name` | `String`: The name of the attribute.
|
| `value` | `Object`: The value of the attribute.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/IllegalArgumentException` | thrown if the underlying implementation doesn't recognize the attribute. |
### setCoalescing
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setCoalescing (boolean coalescing)
```
Specifies that the parser produced by this code will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node. By default the value of this is set to `false`
| Parameters ||
|---|---|
| `coalescing` | `boolean`: true if the parser produced will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node; false otherwise.
|
### setExpandEntityReferences
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setExpandEntityReferences (boolean expandEntityRef)
```
Specifies that the parser produced by this code will expand entity reference nodes. By default the value of this is set to `true`
| Parameters ||
|---|---|
| `expandEntityRef` | `boolean`: true if the parser produced will expand entity reference nodes; false otherwise.
|
### setFeature
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public abstract void setFeature (String name,
boolean value)
```
Set a feature for this `DocumentBuilderFactory` and `DocumentBuilder`s created by this factory.
Feature names are fully qualified `https://developer.android.com/reference/java/net/URI`s. Implementations may define their own features. An `https://developer.android.com/reference/javax/xml/parsers/ParserConfigurationException` is thrown if this `DocumentBuilderFactory` or the `DocumentBuilder`s it creates cannot support the feature. It is possible for an `DocumentBuilderFactory` to expose a feature value but be unable to change its state.
Earlier versions of this documentation have mandated support for the `https://developer.android.com/reference/javax/xml/XMLConstants#FEATURE_SECURE_PROCESSING` feature, but this is not a supported feature on any version of Android.
| Parameters ||
|---|---|
| `name` | `String`: Feature name.
|
| `value` | `boolean`: Is feature state `true` or `false`.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/NullPointerException` | If the `name` parameter is null. |
| `https://developer.android.com/reference/javax/xml/parsers/ParserConfigurationException` | if this `DocumentBuilderFactory` or the `DocumentBuilder`s it creates cannot support this feature. |
### setIgnoringComments
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setIgnoringComments (boolean ignoreComments)
```
Specifies that the parser produced by this code will ignore comments. By default the value of this is set to `false `.
| Parameters ||
|---|---|
| `ignoreComments` | `boolean`: `boolean` value to ignore comments during processing
|
### setIgnoringElementContentWhitespace
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setIgnoringElementContentWhitespace (boolean whitespace)
```
Specifies that the parsers created by this factory must eliminate whitespace in element content (sometimes known loosely as 'ignorable whitespace') when parsing XML documents (see XML Rec 2.10). Note that only whitespace which is directly contained within element content that has an element only content model (see XML Rec 3.2.1) will be eliminated. Due to reliance on the content model this setting requires the parser to be in validating mode. By default the value of this is set to `false`.
| Parameters ||
|---|---|
| `whitespace` | `boolean`: true if the parser created must eliminate whitespace in the element content when parsing XML documents; false otherwise.
|
### setNamespaceAware
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setNamespaceAware (boolean awareness)
```
Specifies that the parser produced by this code will provide support for XML namespaces. By default the value of this is set to `false`
| Parameters ||
|---|---|
| `awareness` | `boolean`: true if the parser produced will provide support for XML namespaces; false otherwise.
|
### setSchema
Added in [API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setSchema (Schema schema)
```
Set the `https://developer.android.com/reference/javax/xml/validation/Schema` to be used by parsers created from this factory.
When a `https://developer.android.com/reference/javax/xml/validation/Schema` is non-null, a parser will use a validator created from it to validate documents before it passes information down to the application.
When errors are found by the validator, the parser is responsible to report them to the user-specified `https://developer.android.com/reference/org/xml/sax/ErrorHandler` (or if the error handler is not set, ignore them or throw them), just like any other errors found by the parser itself. In other words, if the user-specified `https://developer.android.com/reference/org/xml/sax/ErrorHandler` is set, it must receive those errors, and if not, they must be treated according to the implementation specific default error handling rules.
A validator may modify the outcome of a parse (for example by adding default values that were missing in documents), and a parser is responsible to make sure that the application will receive modified DOM trees.
Initially, null is set as the `https://developer.android.com/reference/javax/xml/validation/Schema`.
This processing will take effect even if the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#isValidating()` method returns false.
It is an error to use the `http://java.sun.com/xml/jaxp/properties/schemaSource` property and/or the `http://java.sun.com/xml/jaxp/properties/schemaLanguage` property in conjunction with a `https://developer.android.com/reference/javax/xml/validation/Schema` object. Such configuration will cause a `https://developer.android.com/reference/javax/xml/parsers/ParserConfigurationException` exception when the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#newDocumentBuilder()` is invoked.
#### Note for implementors
A parser must be able to work with any `https://developer.android.com/reference/javax/xml/validation/Schema` implementation. However, parsers and schemas are allowed to use implementation-specific custom mechanisms as long as they yield the result described in the specification.
| Parameters ||
|---|---|
| `schema` | `Schema`: `Schema` to use or `null` to remove a schema.
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/UnsupportedOperationException` | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
### setValidating
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setValidating (boolean validating)
```
Specifies that the parser produced by this code will validate documents as they are parsed. By default the value of this is set to `false`.
Note that "the validation" here means [a validating parser](http://www.w3.org/TR/REC-xml#proc-types) as defined in the XML recommendation. In other words, it essentially just controls the DTD validation. (except the legacy two properties defined in JAXP 1.2. See [here](https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#validationCompatibility) for more details.)
To use modern schema languages such as W3C XML Schema or RELAX NG instead of DTD, you can configure your parser to be a non-validating parser by leaving the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setValidating(boolean)` method false, then use the `https://developer.android.com/reference/javax/xml/parsers/DocumentBuilderFactory#setSchema(javax.xml.validation.Schema)` method to associate a schema to a parser.
| Parameters ||
|---|---|
| `validating` | `boolean`: true if the parser produced will validate documents as they are parsed; false otherwise.
|
### setXIncludeAware
Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setXIncludeAware (boolean state)
```
Set state of XInclude processing.
If XInclude markup is found in the document instance, should it be processed as specified in [XML Inclusions (XInclude) Version 1.0](http://www.w3.org/TR/xinclude/).
XInclude processing defaults to `false`.
| Parameters ||
|---|---|
| `state` | `boolean`: Set XInclude processing to `true` or `false`
|
| Throws ||
|---|---|
| `https://developer.android.com/reference/java/lang/UnsupportedOperationException` | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |