- 導入されたバージョン:
- 1.4
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明abstract boolean
getFeature
(String name) org.xml.sax.XMLReaderの基本となる実装で要求された特定のプロパティを返します。setSchema(Schema schema)
メソッドによって指定されたSchema
オブジェクトを取得します。boolean
ファクトリが名前空間を認識するパーサーを作成するように構成されているかどうかを示します。boolean
構文解析時にXMLコンテンツを検証するパーサーを作成するようにファクトリが構成されているかどうかを示します。boolean
XInclude処理の状態を取得します。static SAXParserFactory
SAXParserFactory
組み込みシステムのデフォルト実装の新しいインスタンスを作成します。static SAXParserFactory
SAXParserFactory
組込みシステムのデフォルト実装の新しいNamespaceAwareインスタンスを作成します。static SAXParserFactory
SAXParserFactory
の新しいインスタンスを取得します。static SAXParserFactory
newInstance
(String factoryClassName, ClassLoader classLoader) クラス名からSAXParserFactory
の新しいインスタンスを取得します。static SAXParserFactory
SAXParserFactory
の新しいNamespaceAwareインスタンスを作成します。static SAXParserFactory
newNSInstance
(String factoryClassName, ClassLoader classLoader) クラス名からSAXParserFactory
の新しいNamespaceAwareインスタンスを作成します。abstract SAXParser
現在構成されているファクトリ・パラメータを使用してSAXParserの新しいインスタンスを作成します。abstract void
setFeature
(String name, boolean value) org.xml.sax.XMLReaderの基本となる実装に特定の機能を設定します。void
setNamespaceAware
(boolean awareness) このファクトリで作成されたパーサーがXML名前空間をサポートするように指定します。void
このファクトリから作成されたパーサーによって使用されるSchema
を設定します。void
setValidating
(boolean validating) このファクトリで作成されたパーサーが構文解析時にドキュメントの妥当性を検証するように指定します。void
setXIncludeAware
(boolean state) XInclude処理の状態を設定します。
-
コンストラクタの詳細
-
SAXParserFactory
protected SAXParserFactory()newInstance()
を強制的に使用するprotectedコンストラクタです。
-
-
メソッドの詳細
-
newDefaultNSInstance
public static SAXParserFactory newDefaultNSInstance()SAXParserFactory
組込みシステムのデフォルト実装の新しいNamespaceAwareインスタンスを作成します。 ファクトリ・インスタンスによって生成されたパーサーは、デフォルトでXMLネームスペースのサポートを提供します。- 実装要件:
- このメソッドは、
newDefaultInstance()
と同じプロセスを使用してファクトリ・インスタンスを作成するだけでなく、NamespaceAwareをtrueに設定する必要があります。 - 戻り値:
SAXParserFactory
組込みシステムのデフォルトの実装の新しいインスタンス。- 導入されたバージョン:
- 13
-
newNSInstance
public static SAXParserFactory newNSInstance()SAXParserFactory
の新しいNamespaceAwareインスタンスを作成します。 ファクトリ・インスタンスによって生成されたパーサーは、デフォルトでXMLネームスペースのサポートを提供します。- 実装要件:
- このメソッドは、
newInstance()
と同じプロセスを使用してファクトリ・インスタンスを作成するだけでなく、NamespaceAwareをtrueに設定する必要があります。 - 戻り値:
SAXParserFactory
の新規インスタンス- 例外:
FactoryConfigurationError
- サービス構成エラーが発生した場合、または実装が使用できないかインスタンス化できない場合。- 導入されたバージョン:
- 13
-
newNSInstance
public static SAXParserFactory newNSInstance(String factoryClassName, ClassLoader classLoader) クラス名からSAXParserFactory
の新しいNamespaceAwareインスタンスを作成します。 ファクトリ・インスタンスによって生成されたパーサーは、デフォルトでXMLネームスペースのサポートを提供します。- 実装要件:
- このメソッドは、
newInstance(java.lang.String, java.lang.ClassLoader)
と同じプロセスを使用してファクトリ・インスタンスを作成するだけでなく、NamespaceAwareをtrueに設定する必要があります。 - パラメータ:
factoryClassName
-javax.xml.parsers.SAXParserFactory
の実装を提供する完全修飾ファクトリ・クラス名。classLoader
- ファクトリ・クラスをロードするために使用するClassLoader
。null
の場合、現在のThread
コンテキストclassLoaderがファクトリ・クラスをロードするために使用されます。- 戻り値:
SAXParserFactory
の新規インスタンス- 例外:
FactoryConfigurationError
-factoryClassName
がnull
、またはファクトリ・クラスをロードまたはインスタンス化できない場合。- 導入されたバージョン:
- 13
-
newDefaultInstance
public static SAXParserFactory newDefaultInstance()SAXParserFactory
組み込みシステムのデフォルト実装の新しいインスタンスを作成します。- 戻り値:
SAXParserFactory
組み込みシステムのデフォルト実装の新しいインスタンス。- 導入されたバージョン:
- 9
-
newInstance
public static SAXParserFactory newInstance()SAXParserFactory
の新しいインスタンスを取得します。 このメソッドは、「JAXPルックアップ・メカニズム」を使用して、ロードするSAXParserFactory
実装クラスを決定します。アプリケーションが
SAXParserFactory
,への参照を取得すると、ファクトリを使用してパーサーのインスタンスを構成および取得できます。トラブルシューティングのヒント
jaxp.debug
システム・プロパティを設定すると、このメソッドは実行中の処理や検索している場所に関する大量のデバッグ・メッセージをSystem.err
に出力します。SAXParser
のロードに問題がある場合、次のようにします。java -Djaxp.debug=1 YourProgram ....
- 戻り値:
- SAXParserFactoryの新しいインスタンス。
- 例外:
FactoryConfigurationError
- サービス構成エラーが発生した場合、または実装が使用できないかインスタンス化できない場合。
-
newInstance
public static SAXParserFactory newInstance(String factoryClassName, ClassLoader classLoader) クラス名からSAXParserFactory
の新しいインスタンスを取得します。 この関数は、クラス・パスに複数のプロバイダがある場合に便利です。 どのプロバイダがロードされるかを指定できるため、アプリケーションをさらに制御できます。アプリケーションが
SAXParserFactory
への参照を取得すると、ファクトリを使用してパーサーのインスタンスを構成および取得できます。トラブルシューティングのヒント
jaxp.debug
システム・プロパティを設定すると、このメソッドは実行中の処理や検索している場所に関する大量のデバッグ・メッセージをSystem.err
に出力します。問題がある場合、次のようにします。
java -Djaxp.debug=1 YourProgram ....
- パラメータ:
factoryClassName
-javax.xml.parsers.SAXParserFactory
の実装を提供する完全修飾のファクトリ・クラス名。classLoader
- ファクトリ・クラスのロードに使用されるClassLoader
。null
の場合は、現在のThread
のコンテキストclassLoaderが、ファクトリ・クラスのロードに使用されます。- 戻り値:
SAXParserFactory
の新しいインスタンス- 例外:
FactoryConfigurationError
-factoryClassName
がnull
、またはファクトリ・クラスをロードまたはインスタンス化できない場合。- 導入されたバージョン:
- 1.6
- 関連項目:
-
newSAXParser
public abstract SAXParser newSAXParser() throws ParserConfigurationException, SAXException現在構成されているファクトリ・パラメータを使用してSAXParserの新しいインスタンスを作成します。- 戻り値:
- SAXParserの新しいインスタンス。
- 例外:
ParserConfigurationException
- 要求された構成を満たすパーサーを生成できない場合。SAXException
- SAXエラーの場合。
-
setNamespaceAware
public void setNamespaceAware(boolean awareness) このファクトリで作成されたパーサーがXML名前空間をサポートするように指定します。 デフォルトでは、この値はfalse
に設定されます。- パラメータ:
awareness
- このコードで作成されたパーサーがXML名前空間をサポートする場合はtrue、そうでない場合はfalse。
-
setValidating
public void setValidating(boolean validating) このファクトリで作成されたパーサーが構文解析時にドキュメントの妥当性を検証するように指定します。 デフォルトでは、この値はfalse
に設定されます。ここで言う「検証」とは、XML勧告で定義されている妥当性を検証するパーサーという意味です。 つまり、実質的にはDTD検証を制御するだけということです。ただし、JAXP 1.2に定義されている従来の2つのプロパティを除きます。
DTDではなく、W3C XML SchemaまたはRELAX NGなどの新しいスキーマ言語を使用する場合は、
setValidating(boolean)
メソッドをfalse
にして妥当性を検証しないパーサーとして構成してから、setSchema(Schema)
メソッドでスキーマをパーサーに関連付けます。- パラメータ:
validating
- このコードで作成されたパーサーが構文解析時にドキュメントの妥当性を検証する場合はtrue、そうでない場合はfalse。
-
isNamespaceAware
public boolean isNamespaceAware()ファクトリが名前空間を認識するパーサーを作成するように構成されているかどうかを示します。- 戻り値:
- ファクトリが名前空間を認識するパーサーを作成するように構成されている場合はtrue、そうでない場合はfalse。
-
isValidating
public boolean isValidating()構文解析時にXMLコンテンツを検証するパーサーを作成するようにファクトリが構成されているかどうかを示します。- 戻り値:
- 構文解析時にXMLコンテンツを検証するパーサーを作成するようにファクトリが構成されている場合はtrue、そうでない場合はfalse。
-
setFeature
public abstract void setFeature(String name, boolean value) throws ParserConfigurationException, SAXNotRecognizedException, SAXNotSupportedException org.xml.sax.XMLReaderの基本となる実装に特定の機能を設定します。 コア機能とコア・プロパティのリストについては、http://www.saxproject.org/のサイトを参照してください。実装はすべて、
XMLConstants.FEATURE_SECURE_PROCESSING
機能をサポートしている必要があります。 この機能については次のとおりです。-
true
: 実装は実装限界に準拠するXML処理を制限します。 例は、エンティティ拡張制限や大容量のリソースを消費するXMLスキーマなど。 セキュリティ上の理由からXML処理が制限される場合は、登録済みのErrorHandler.fatalError(SAXParseException exception)
へ呼出しを介して報告されます。 ハンドラ仕様については、SAXParser
parse
メソッドを参照してください。 -
機能が
false
の場合、実装は、実装限界にかまわず、XML仕様に従ってXMLを処理します。
- パラメータ:
name
- 設定される機能の名前。value
- 設定される機能の値。- 例外:
ParserConfigurationException
- 要求された構成を満たすパーサーを生成できない場合。SAXNotRecognizedException
- 基本となるXMLReaderがプロパティ名を認識しない場合。SAXNotSupportedException
- 基本となるXMLReaderはプロパティ名を認識するが、そのプロパティをサポートしない場合。NullPointerException
-name
パラメータがnullである場合。- 関連項目:
-
-
getFeature
public abstract boolean getFeature(String name) throws ParserConfigurationException, SAXNotRecognizedException, SAXNotSupportedException org.xml.sax.XMLReaderの基本となる実装で要求された特定のプロパティを返します。- パラメータ:
name
- 取り出されるプロパティの名前。- 戻り値:
- 要求されたプロパティの値。
- 例外:
ParserConfigurationException
- 要求された構成を満たすパーサーを生成できない場合。SAXNotRecognizedException
- 基本となるXMLReaderがプロパティ名を認識しない場合。SAXNotSupportedException
- 基本となるXMLReaderはプロパティ名を認識するが、そのプロパティをサポートしない場合。- 関連項目:
-
getSchema
public Schema getSchema()setSchema(Schema schema)
メソッドによって指定されたSchema
オブジェクトを取得します。- 戻り値:
setSchema(Schema)
メソッドを介して最後に設定されたSchema
オブジェクト、またはSAXParserFactory
が作成されてからメソッドが呼び出されていない場合はnull。- 例外:
UnsupportedOperationException
- 実装がこのメソッドをオーバーライドしない場合- 導入されたバージョン:
- 1.5
-
setSchema
public void setSchema(Schema schema) このファクトリから作成されたパーサーによって使用されるSchema
を設定します。Schema
がnull以外の場合、パーサーは、情報をアプリケーションに渡す前に、ドキュメントを検証するために作成されたバリデータを使用します。バリデータによって警告、エラー、重大なエラーが検出されると、パーサーは自身がこれらのエラーを検出した場合と同様にこれらを処理する必要があります。 つまり、ユーザー指定の
ErrorHandler
が設定されている場合は、これらのエラーを受け取り、そうでない場合は実装固有のデフォルトのエラー処理規則に従って処理される必要があります。バリデータはSAXイベント・ストリームを変更することがあり(たとえば、ドキュメントから失われていたデフォルト値を追加するなど)、パーサーはこれらの変更されたイベント・ストリームをアプリケーションが確実に受け取るようにする役割を持ちます。
最初に、
null
がSchema
として設定されます。この処理は
isValidating()
メソッドがfalse
を返した場合でも有効です。http://java.sun.com/xml/jaxp/properties/schemaSource
プロパティまたはhttp://java.sun.com/xml/jaxp/properties/schemaLanguage
プロパティをnull以外のSchema
オブジェクトと一緒に使用するとエラーになります。 これらのプロパティがSAXParser
に設定されていると、そのような構成によってSAXException
例外が発生します。実装時のノート
パーサーは、あらゆる
Schema
実装で動作できる必要があります。 ただし、パーサーおよびスキーマが仕様に記載されている結果を出すかぎり、実装固有のカスタム・メカニズムを使用できます。- パラメータ:
schema
- 使用するSchema
、スキーマを削除するにはnull
。- 例外:
UnsupportedOperationException
- 実装がこのメソッドをオーバーライドしない場合- 導入されたバージョン:
- 1.5
-
setXIncludeAware
public void setXIncludeAware(boolean state) XInclude処理の状態を設定します。ドキュメント・インスタンスにXIncludeマークアップが見つかった場合、「XML Inclusions (XInclude) Version 1.0」に指定されているとおりに処理する必要があります。
XInclude処理のデフォルトは
false
に設定されます。- パラメータ:
state
- XInclude処理をtrue
またはfalse
に設定する- 例外:
UnsupportedOperationException
- 実装がこのメソッドをオーバーライドしない場合- 導入されたバージョン:
- 1.5
-
isXIncludeAware
public boolean isXIncludeAware()XInclude処理の状態を取得します。- 戻り値:
- XInclude処理の現在の状態
- 例外:
UnsupportedOperationException
- 実装がこのメソッドをオーバーライドしない場合- 導入されたバージョン:
- 1.5
-