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