# DocumentBuilderFactory

public abstract class **DocumentBuilderFactory** extends [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)  
Defines a factory API that enables applications to obtain a
parser that produces DOM object trees from XML documents.

### Protected Constructor Summary

|---|---|
|   | [DocumentBuilderFactory](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#DocumentBuilderFactory())() |

### Public Method Summary

|---|---|
| abstract [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [getAttribute](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#getAttribute(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name) Allows the user to retrieve specific attributes on the underlying implementation. |
| abstract boolean | [getFeature](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#getFeature(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name) Get the state of the named feature. |
| [Schema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html) | [getSchema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#getSchema())() Gets the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` object specified through the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setSchema(javax.xml.validation.Schema)` method. |
| boolean | [isCoalescing](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#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 | [isExpandEntityReferences](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#isExpandEntityReferences())() Indicates whether or not the factory is configured to produce parsers which expand entity reference nodes. |
| boolean | [isIgnoringComments](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#isIgnoringComments())() Indicates whether or not the factory is configured to produce parsers which ignores comments. |
| boolean | [isIgnoringElementContentWhitespace](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#isIgnoringElementContentWhitespace())() Indicates whether or not the factory is configured to produce parsers which ignore ignorable whitespace in element content. |
| boolean | [isNamespaceAware](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#isNamespaceAware())() Indicates whether or not the factory is configured to produce parsers which are namespace aware. |
| boolean | [isValidating](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#isValidating())() Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse. |
| boolean | [isXIncludeAware](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#isXIncludeAware())() Get state of XInclude processing. |
| abstract [DocumentBuilder](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilder.html) | [newDocumentBuilder](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#newDocumentBuilder())() Creates a new instance of a `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilder.html` using the currently configured parameters. |
| static [DocumentBuilderFactory](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html) | [newInstance](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#newInstance(java.lang.String,%20java.lang.ClassLoader))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) factoryClassName, [ClassLoader](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/ClassLoader.html) classLoader) Returns an instance of the named implementation of `DocumentBuilderFactory`. |
| static [DocumentBuilderFactory](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html) | [newInstance](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#newInstance())() Returns Android's implementation of `DocumentBuilderFactory`. |
| abstract void | [setAttribute](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setAttribute(java.lang.String,%20java.lang.Object))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name, [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) value) Allows the user to set specific attributes on the underlying implementation. |
| void | [setCoalescing](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#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 | [setExpandEntityReferences](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setExpandEntityReferences(boolean))(boolean expandEntityRef) Specifies that the parser produced by this code will expand entity reference nodes. |
| abstract void | [setFeature](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setFeature(java.lang.String,%20boolean))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name, boolean value) Set a feature for this `DocumentBuilderFactory` and `DocumentBuilder`s created by this factory. |
| void | [setIgnoringComments](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setIgnoringComments(boolean))(boolean ignoreComments) Specifies that the parser produced by this code will ignore comments. |
| void | [setIgnoringElementContentWhitespace](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#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 | [setNamespaceAware](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setNamespaceAware(boolean))(boolean awareness) Specifies that the parser produced by this code will provide support for XML namespaces. |
| void | [setSchema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setSchema(javax.xml.validation.Schema))([Schema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html) schema) Set the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` to be used by parsers created from this factory. |
| void | [setValidating](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setValidating(boolean))(boolean validating) Specifies that the parser produced by this code will validate documents as they are parsed. |
| void | [setXIncludeAware](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setXIncludeAware(boolean))(boolean state) Set state of XInclude processing. |

### Inherited Method Summary

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notify())() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| final void | [notifyAll](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notifyAll())() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Protected Constructors

#### protected
**DocumentBuilderFactory**
()

<br />

## Public Methods

#### public abstract [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)
**getAttribute**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name)

Allows the user to retrieve specific attributes on the underlying
implementation.

##### Parameters

| name | The name of the attribute. |
|---|---|

##### Returns

- value The value of the attribute.

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | thrown if the underlying implementation doesn't recognize the attribute. |
|---|---|

#### public abstract boolean
**getFeature**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name)

<br />

Get the state of the named feature.


Feature names are fully qualified `https://developers.google.com/j2objc/javadoc/jre/reference/java/net/URI.html`s.
Implementations may define their own features.
An `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/ParserConfigurationException.html` 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.

<br />

##### Parameters

| name | Feature name. |
|---|---|

##### Returns

- State of the named feature.

##### Throws

| [ParserConfigurationException](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/ParserConfigurationException.html) | if this `DocumentBuilderFactory` or the `DocumentBuilder`s it creates cannot support this feature. |
|---|---|

#### public [Schema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html)
**getSchema**
()

Gets the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` object specified through
the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setSchema(javax.xml.validation.Schema)` method.

##### Returns

- the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` object that was last set through the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setSchema(javax.xml.validation.Schema)` method, or null if the method was not invoked since a `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html` is created.

##### Throws

| [UnsupportedOperationException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/UnsupportedOperationException.html) | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
|---|---|

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

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

#### public boolean
**isExpandEntityReferences**
()

Indicates whether or not the factory is configured to produce
parsers which expand entity reference nodes.

##### Returns

- true if the factory is configured to produce parsers which expand entity reference nodes; false otherwise.

#### public boolean
**isIgnoringComments**
()

Indicates whether or not the factory is configured to produce
parsers which ignores comments.

##### Returns

- true if the factory is configured to produce parsers which ignores comments; false otherwise.

#### public boolean
**isIgnoringElementContentWhitespace**
()

Indicates whether or not the factory is configured to produce
parsers which ignore ignorable whitespace in element content.

##### Returns

- true if the factory is configured to produce parsers which ignore ignorable whitespace in element content; false otherwise.

#### public boolean
**isNamespaceAware**
()

Indicates whether or not the factory is configured to produce
parsers which are namespace aware.

##### Returns

- true if the factory is configured to produce parsers which are namespace aware; false otherwise.

#### public boolean
**isValidating**
()

Indicates whether or not the factory is configured to produce
parsers which validate the XML content during parse.

##### Returns

- true if the factory is configured to produce parsers which validate the XML content during parse; false otherwise.

#### public boolean
**isXIncludeAware**
()

<br />

Get state of XInclude processing.

<br />

##### Returns

- current state of XInclude processing

##### Throws

| [UnsupportedOperationException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/UnsupportedOperationException.html) | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
|---|---|

#### public abstract [DocumentBuilder](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilder.html)
**newDocumentBuilder**
()

Creates a new instance of a `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilder.html`
using the currently configured parameters.

##### Returns

- A new instance of a DocumentBuilder.

##### Throws

| [ParserConfigurationException](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/ParserConfigurationException.html) | if a DocumentBuilder cannot be created which satisfies the configuration requested. |
|---|---|

#### public static [DocumentBuilderFactory](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html)
**newInstance**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) factoryClassName, [ClassLoader](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/ClassLoader.html) classLoader)

Returns an instance of the named implementation of `DocumentBuilderFactory`.

##### Parameters

| factoryClassName |   |
| classLoader |   |
|---|---|

##### Throws

| [FactoryConfigurationError](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/FactoryConfigurationError.html) | if `factoryClassName` is not available or cannot be instantiated. |
|---|---|

#### public static [DocumentBuilderFactory](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html)
**newInstance**
()

Returns Android's implementation of `DocumentBuilderFactory`.
Unlike other Java implementations, this method does not consult system
properties, property files, or the services API.

##### Returns

- a new DocumentBuilderFactory.

#### public abstract void
**setAttribute**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name, [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) value)

Allows the user to set specific attributes on the underlying
implementation.

##### Parameters

| name | The name of the attribute. |
| value | The value of the attribute. |
|---|---|

##### Throws

| [IllegalArgumentException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/IllegalArgumentException.html) | thrown if the underlying implementation doesn't recognize the attribute. |
|---|---|

#### 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 | true if the parser produced will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node; false otherwise. |
|---|---|

#### 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 | true if the parser produced will expand entity reference nodes; false otherwise. |
|---|---|

#### public abstract void
**setFeature**
([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) name, boolean value)

<br />

Set a feature for this `DocumentBuilderFactory` and `DocumentBuilder`s created by this factory.


Feature names are fully qualified `https://developers.google.com/j2objc/javadoc/jre/reference/java/net/URI.html`s.
Implementations may define their own features.
An `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/ParserConfigurationException.html` 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.


All implementations are required to support the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/XMLConstants.html#FEATURE_SECURE_PROCESSING` feature.
When the feature is:

- `true`: the implementation will limit XML processing to conform to implementation limits. Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources. If XML processing is limited for security reasons, it will be reported via a call to the registered `https://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/ErrorHandler.html#fatalError(org.xml.sax.SAXParseException)`. See `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilder.html#setErrorHandler(org.xml.sax.ErrorHandler)`.
- `false`: the implementation will processing XML according to the XML specifications without regard to possible implementation limits.

<br />

##### Parameters

| name | Feature name. |
| value | Is feature state `true` or `false`. |
|---|---|

##### Throws

| [ParserConfigurationException](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/ParserConfigurationException.html) | if this `DocumentBuilderFactory` or the `DocumentBuilder`s it creates cannot support this feature. |
| [NullPointerException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/NullPointerException.html) | If the `name` parameter is null. |
|---|---|

#### public void
**setIgnoringComments**
(boolean ignoreComments)

<br />

Specifies that the parser produced by this code will
ignore comments. By default the value of this is set to `false
`.

<br />

##### Parameters

| ignoreComments | `boolean` value to ignore comments during processing |
|---|---|

#### 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 | true if the parser created must eliminate whitespace in the element content when parsing XML documents; false otherwise. |
|---|---|

#### 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 | true if the parser produced will provide support for XML namespaces; false otherwise. |
|---|---|

#### public void
**setSchema**
([Schema](https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html) schema)

<br />

Set the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` to be used by parsers created
from this factory.


When a `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` 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://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/ErrorHandler.html`
(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://developers.google.com/j2objc/javadoc/jre/reference/org/xml/sax/ErrorHandler.html`
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://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html`.


This processing will take effect even if
the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#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://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html` object.
Such configuration will cause a `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/ParserConfigurationException.html`
exception when the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#newDocumentBuilder()` is invoked.

#### Note for implementors


A parser must be able to work with any `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/validation/Schema.html`
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` to use or `null` to remove a schema. |
|---|---|

##### Throws

| [UnsupportedOperationException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/UnsupportedOperationException.html) | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
|---|---|

#### 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://developers.google.com/j2objc/javadoc/jre/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://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setValidating(boolean)`
method false, then use the `https://developers.google.com/j2objc/javadoc/jre/reference/javax/xml/parsers/DocumentBuilderFactory.html#setSchema(javax.xml.validation.Schema)`
method to associate a schema to a parser.

<br />

##### Parameters

| validating | true if the parser produced will validate documents as they are parsed; false otherwise. |
|---|---|

#### public void
**setXIncludeAware**
(boolean state)

<br />

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

<br />

##### Parameters

| state | Set XInclude processing to `true` or `false` |
|---|---|

##### Throws

| [UnsupportedOperationException](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/UnsupportedOperationException.html) | For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown. |
|---|---|