6.14 org.w3c.dom.lsパッケージに関する注意事項

org.w3c.dom.lsパッケージに関する注意事項を次の表に示します。

表6-25 org.w3c.dom.lsパッケージに関する注意事項

項番注意事項
1DOMImplementationLSインタフェースのcreateLSParser(short mode, String schemaType)メソッドの引数modeにはDOMImplementationLS. MODE_SYNCHRONOUSだけを指定できます。また,引数schemaTypeにはnull,"http://www.w3.org/2001/XMLSchema","http://www.w3.org/TR/REC-xml"のどれかを指定できます。
2LSParserオブジェクトにgetDomConfigメソッドを適用して得られるDOMConfigurationオブジェクトに設定可能なパラメタを表6-26に示します。これに加えて,「6.12 org.w3c.domパッケージに関する注意事項」の表6-23に示したパラメタも設定可能です。設定可能なパラメタは,getParameterNamesメソッドの戻り値,およびcanSetParameterメソッドの戻り値とは一致しません。また,設定不可の値を設定しても,例外が発生しない場合があります。設定不可の値を設定した場合の動作は保証しません。
3LSParserオブジェクトのcharset-overrides-xml-encodingパラメタに値を設定しても,無視されます。
4LSParserインタフェースのparseWithContextメソッドはサポートしていません。
5LSParserオブジェクトのsetNewLineメソッドはサポートしていません。
6LSParserオブジェクトでは,XML1.1文書を解析できません。
7LSParserオブジェクトのstartElementメソッドは,ルート要素については呼び出されません。
8LSParserオブジェクトでの解析時,およびLSSerializerオブジェクトでの直列化時にLSException例外が発生したとき,getMessage()メソッドの戻り値がnullになる場合があります。この場合は,LSParserFilterやLSSerializerFilterのユーザ実装クラスで例外が発生している可能性があります。
9LSSerializerオブジェクトにgetDomConfigメソッドを適用して得られるDOMConfigurationオブジェクトに設定可能なパラメタを表6-27に示します。これに加えて,「6.12 org.w3c.domパッケージに関する注意事項」の表6-23に示したパラメタも設定可能です。設定可能なパラメタは,getParameterNamesメソッドの戻り値,およびcanSetParameterメソッドの戻り値とは一致しません。また,設定不可の値を設定しても,例外が発生しない場合があります。設定不可の値を設定した場合の動作は保証しません。
10LSSerializeオブジェクトのwrite,writeToString,およびwriteToURIメソッドの引数nodeArgに,Document,DocumentFragment,Element以外のノードを指定した場合,それらのノードは直列化されません。
11LSSerializeオブジェクトのwrite,writeToString,およびwriteToURIメソッドは,名前空間が無効なノードを直列化できません。
12LSSerializerインタフェースのgetNewLineメソッドで得られる行末シーケンス文字のデフォルト値は,"¥n"です。
13ProcessingInstructionオブジェクトが持つ処理命令の内容に文字列「?>」が含まれるとき,そのProcessingInstructionオブジェクトを直列化してもエラーは通知されません。
14LSParserでパースした場合,Documentオブジェクトから取得したDocumentTypeオブジェクトの内容を変更してもDOMException例外が発生しないことがあります。

表6-26 DOMConfigurationオブジェクトに設定可能なパラメタ(LSParserオブジェクト)

パラメタの名前設定可能な値
charset-overrides-xml-encodingtrue,false
disallow-doctypefalse
ignore-unknown-character-denormalizationstrue
supported-media-types-onlyfalse

表6-27 DOMConfigurationオブジェクトに設定可能なパラメタ(LSSerializerオブジェクト)

パラメタの名前設定可能な値
discard-default-contenttrue,false
format-pretty-printfalse
ignore-unknown-character-denormalizationstrue
xml-declarationtrue,false