Cosminexus V9 アプリケーションサーバ Cosminexus XML Processor ユーザーズガイド

[目次][用語][索引][前へ][次へ]

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

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