DocumentBuilder (Java Platform SE 8)

java.lang.Object
- javax.xml.parsers.DocumentBuilder

```
public abstract class DocumentBuilder
extends Object
```
XMLドキュメントからDOM Documentインスタンスを取得するAPIを定義します。このクラスを使用すると、アプリケーション・プログラマはXMLからDocumentを取得できます。
このクラスのインスタンスはDocumentBuilderFactory.newDocumentBuilder()メソッドにより取得できます。このクラスのインスタンスを取得すると、さまざまな入力ソースからXMLドキュメントを構文解析できます。これらの入力ソースには、InputStream、File、URL、およびSAX InputSourceがあります。
このクラスはSAX APIのいくつかのクラスを再利用します。この場合、基本となるDOM実装の実装側がSAXパーサーを使用してXMLドキュメントをDocumentに構文解析する必要はありません。実装がこれらの既存のAPIを使用してアプリケーションと通信する必要があるだけです。

コンストラクタのサマリー

コンストラクタ
修飾子コンストラクタと説明

protected DocumentBuilder()
protectedコンストラクタです。

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`DocumentBuilder()` protectedコンストラクタです。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`abstract DOMImplementation`	`getDOMImplementation()` `DOMImplementation`オブジェクトのインスタンスを取得します。
`Schema`	`getSchema()` XMLプロセッサによって使用される`Schema`への参照を取得します。
`abstract boolean`	`isNamespaceAware()` このパーサーが名前空間を認識するように構成されているかどうかを示します。
`abstract boolean`	`isValidating()` このパーサーがXMLドキュメントを検証するように構成されているかどうかを示します。
`boolean`	`isXIncludeAware()` このパーサーのXInclude処理モードを取得します。
`abstract Document`	`newDocument()` DOMツリーの構築に使用するDOM `Document`オブジェクトの新しいインスタンスを取得します。
`Document`	`parse(File f)` 指定されたファイルの内容をXMLドキュメントとして構文解析し、新しいDOM `Document`オブジェクトを返します。
`abstract Document`	`parse(InputSource is)` 指定された入力ソースの内容をXMLドキュメントとして構文解析し、新しいDOM `Document`オブジェクトを返します。
`Document`	`parse(InputStream is)` 指定された`InputStream`の内容をXMLドキュメントとして構文解析し、新しいDOM `Document`オブジェクトを返します。
`Document`	`parse(InputStream is, String systemId)` 指定された`InputStream`の内容をXMLドキュメントとして構文解析し、新しいDOM `Document`オブジェクトを返します。
`Document`	`parse(String uri)` 指定されたURIの内容をXMLドキュメントとして構文解析し、新しいDOM `Document`オブジェクトを返します。
`void`	`reset()` この`DocumentBuilder`を元の構成にリセットします。
`abstract void`	`setEntityResolver(EntityResolver er)` 構文解析するXMLドキュメントに存在するエンティティを解決するのに使用される`EntityResolver`を指定します。
`abstract void`	`setErrorHandler(ErrorHandler eh)` パーサーによって使用される`ErrorHandler`を指定します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - DocumentBuilder
```
protected DocumentBuilder()
```
    protectedコンストラクタです。
- メソッドの詳細
  - reset
```
public void reset()
```
    このDocumentBuilderを元の構成にリセットします。
    
    DocumentBuilderは、DocumentBuilderFactory.newDocumentBuilder()で作成された時点の状態にリセットされます。reset()は、既存のDocumentBuilderの再使用を許可するように設計されているため、新しいDocumentBuilderの作成に関連するリソースを節約できます。
    
    DocumentBuilderをリセットした場合、同じEntityResolverまたはErrorHandler Object (たとえば、Object.equals(Object obj))を持つことは保証されません。機能的に同じEntityResolverおよびErrorHandlerを持つことは保証されます。
    
    例外:
    
    UnsupportedOperationException - 実装がこのメソッドをオーバーライドしない場合。
    
    導入されたバージョン:
    
    1.5
  - parse
```
public Document parse(InputStream is)
               throws SAXException,
                      IOException
```
    指定されたInputStreamの内容をXMLドキュメントとして構文解析し、新しいDOM Documentオブジェクトを返します。InputStreamがnullの場合はIllegalArgumentExceptionがスローされます。
    
    パラメータ:
    
    is - 構文解析されるコンテンツを含むInputStream。
    
    戻り値:
    
    InputStreamの構文解析結果のDocument
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    SAXException - 構文解析エラーが発生した場合。
    
    IllegalArgumentException - isがnullの場合
    
    関連項目:
    
    DocumentHandler
  - parse
```
public Document parse(InputStream is,
                      String systemId)
               throws SAXException,
                      IOException
```
    指定されたInputStreamの内容をXMLドキュメントとして構文解析し、新しいDOM Documentオブジェクトを返します。InputStreamがnullの場合はIllegalArgumentExceptionがスローされます。
    
    パラメータ:
    
    is - 構文解析されるコンテンツを含むInputStream。
    
    systemId - 相対URIを解決するためのベースを提供。
    
    戻り値:
    
    新しいDOM Documentオブジェクト。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    SAXException - 構文解析エラーが発生した場合。
    
    IllegalArgumentException - isがnullの場合
    
    関連項目:
    
    DocumentHandler
  - parse
```
public Document parse(String uri)
               throws SAXException,
                      IOException
```
    指定されたURIの内容をXMLドキュメントとして構文解析し、新しいDOM Documentオブジェクトを返します。URIがnullの場合はIllegalArgumentExceptionがスローされます。
    
    パラメータ:
    
    uri - 構文解析されるコンテンツの場所。
    
    戻り値:
    
    新しいDOM Documentオブジェクト。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    SAXException - 構文解析エラーが発生した場合。
    
    IllegalArgumentException - uriがnullの場合
    
    関連項目:
    
    DocumentHandler
  - parse
```
public Document parse(File f)
               throws SAXException,
                      IOException
```
    指定されたファイルの内容をXMLドキュメントとして構文解析し、新しいDOM Documentオブジェクトを返します。Fileがnullの場合はIllegalArgumentExceptionがスローされます。
    
    パラメータ:
    
    f - 構文解析対象のXMLを含むファイル。
    
    戻り値:
    
    新しいDOM Documentオブジェクト。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    SAXException - 構文解析エラーが発生した場合。
    
    IllegalArgumentException - fがnullの場合
    
    関連項目:
    
    DocumentHandler
  - parse
```
public abstract Document parse(InputSource is)
                        throws SAXException,
                               IOException
```
    指定された入力ソースの内容をXMLドキュメントとして構文解析し、新しいDOM Documentオブジェクトを返します。InputSourceがnullの場合はIllegalArgumentExceptionがスローされます。
    
    パラメータ:
    
    is - 構文解析されるコンテンツを含むInputSource。
    
    戻り値:
    
    新しいDOM Documentオブジェクト。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    SAXException - 構文解析エラーが発生した場合。
    
    IllegalArgumentException - isがnullの場合
    
    関連項目:
    
    DocumentHandler
  - isNamespaceAware
```
public abstract boolean isNamespaceAware()
```
    このパーサーが名前空間を認識するように構成されているかどうかを示します。
    
    戻り値:
    
    このパーサーが名前空間を認識するように構成されている場合はtrue、そうでない場合はfalse。
  - isValidating
```
public abstract boolean isValidating()
```
    このパーサーがXMLドキュメントを検証するように構成されているかどうかを示します。
    
    戻り値:
    
    このパーサーがXMLドキュメントを検証するように構成されている場合はtrue、そうでない場合はfalse。
  - setEntityResolver
```
public abstract void setEntityResolver(EntityResolver er)
```
    構文解析するXMLドキュメントに存在するエンティティを解決するのに使用されるEntityResolverを指定します。これをnullに設定すると、デフォルトの実装と動作を使用した基本となる実装になります。
    
    パラメータ:
    
    er - 構文解析するXMLドキュメントに存在するエンティティの解決のために使用されるEntityResolver。
  - setErrorHandler
```
public abstract void setErrorHandler(ErrorHandler eh)
```
    パーサーによって使用されるErrorHandlerを指定します。これをnullに設定すると、デフォルトの実装と動作を使用した基本となる実装になります。
    
    パラメータ:
    
    eh - パーサーによって使用されるErrorHandler。
  - newDocument
```
public abstract Document newDocument()
```
    DOMツリーの構築に使用するDOM Documentオブジェクトの新しいインスタンスを取得します。
    
    戻り値:
    
    DOM Documentオブジェクトの新しいインスタンス。
  - getDOMImplementation
```
public abstract DOMImplementation getDOMImplementation()
```
    DOMImplementationオブジェクトのインスタンスを取得します。
    
    戻り値:
    
    DOMImplementationの新しいインスタンス。
  - getSchema
```
public Schema getSchema()
```
    XMLプロセッサによって使用されるSchemaへの参照を取得します。
    
    スキーマを使用していない場合はnullが返されます。
    
    戻り値:
    
    使用されているSchemaまたは使用されていない場合はnull
    
    例外:
    
    UnsupportedOperationException - 実装がこのメソッドをオーバーライドしない場合
    
    導入されたバージョン:
    
    1.5
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    このパーサーのXInclude処理モードを取得します。
    
    戻り値:
    
    このパーサーがファクトリから作成されたときにDocumentBuilderFactory.isXIncludeAware()から返される値。
    
    例外:
    
    UnsupportedOperationException - 実装がこのメソッドをオーバーライドしない場合
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    
    DocumentBuilderFactory.setXIncludeAware(boolean)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスDocumentBuilder

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

DocumentBuilder

メソッドの詳細

reset

parse

parse

parse

parse

parse

isNamespaceAware

isValidating

setEntityResolver

setErrorHandler

newDocument

getDOMImplementation

getSchema

isXIncludeAware