6.14 org.w3c.dom.lsパッケージに関する注意事項
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例外が発生しないことがあります。 |
パラメタの名前 |
設定可能な値 |
---|---|
charset-overrides-xml-encoding |
true,false |
disallow-doctype |
false |
ignore-unknown-character-denormalizations |
true |
supported-media-types-only |
false |
パラメタの名前 |
設定可能な値 |
---|---|
discard-default-content |
true,false |
format-pretty-print |
false |
ignore-unknown-character-denormalizations |
true |
xml-declaration |
true,false |