public abstract class DocumentBuilder extends Object
Document
を取得できます。
このクラスのインスタンスはDocumentBuilderFactory.newDocumentBuilder()
メソッドにより取得できます。 このクラスのインスタンスを取得すると、さまざまな入力ソースからXMLドキュメントを構文解析できます。 これらの入力ソースには、InputStream、File、URL、およびSAX InputSourceがあります。
このクラスはSAX APIのいくつかのクラスを再利用します。 この場合、基本となるDOM実装の実装側がSAXパーサーを使用してXMLドキュメントをDocument
に構文解析する必要はありません。 実装がこれらの既存のAPIを使用してアプリケーションと通信する必要があるだけです。
- 導入されたバージョン:
- 1.4
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 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ツリーの構築に使用するDOMDocument
オブジェクトの新しいインスタンスを取得します。Document
parse(File f)
指定されたファイルの内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。Document
parse(InputStream is)
指定されたInputStream
の内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。Document
parse(InputStream is, String systemId)
指定されたInputStream
の内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。Document
parse(String uri)
指定されたURIの内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。abstract Document
parse(InputSource is)
指定された入力ソースの内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。void
reset()
このDocumentBuilder
を元の構成にリセットします。abstract void
setEntityResolver(EntityResolver er)
構文解析するXMLドキュメントに存在するエンティティを解決するのに使用されるEntityResolver
を指定します。abstract void
setErrorHandler(ErrorHandler eh)
パーサーによって使用されるErrorHandler
を指定します。
-
コンストラクタの詳細
-
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ドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。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ドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。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ドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。 URIがnull
の場合はIllegalArgumentException
がスローされます。- パラメータ:
uri
- 構文解析されるコンテンツの場所。- 戻り値:
- 新しいDOM Documentオブジェクト。
- 例外:
IOException
- 入出力エラーが発生した場合。SAXException
- 構文解析エラーが発生した場合。IllegalArgumentException
-uri
がnull
の場合- 関連項目:
DocumentHandler
-
parse
public Document parse(File f) throws SAXException, IOException指定されたファイルの内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。File
がnull
の場合はIllegalArgumentException
がスローされます。- パラメータ:
f
- 構文解析対象のXMLを含むファイル。- 戻り値:
- 新しいDOM Documentオブジェクト。
- 例外:
IOException
- 入出力エラーが発生した場合。SAXException
- 構文解析エラーが発生した場合。IllegalArgumentException
-f
がnull
の場合- 関連項目:
DocumentHandler
-
parse
public abstract Document parse(InputSource is) throws SAXException, IOException指定された入力ソースの内容をXMLドキュメントとして構文解析し、新しいDOMDocument
オブジェクトを返します。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ツリーの構築に使用するDOMDocument
オブジェクトの新しいインスタンスを取得します。- 戻り値:
- 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)
-