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 |