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

org.w3c.domパッケージに関する注意事項を表6-18に示します。

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

項番注意事項
1DOMConfigurationオブジェクトに設定可能なパラメタを表6-19に示します。設定可能なパラメタは,getParameterNamesメソッドの戻り値,およびcanSetParameterメソッドの戻り値とは一致しません。また,設定不可の値を設定しても,例外が発生しない場合があります。設定不可の値を設定した場合の動作は保証しません。
2DOMConfigurationオブジェクトのパラメタ名は,大文字と小文字が区別されません。
3DOM Level 3では,従来のDOM Level 2のインタフェースに対して新しいメソッドが追加されています。例えば,AttrインタフェースにはisIdメソッドが追加されています。通常のアプリケーションプログラムがこれらのインタフェースをimplementsすることはありませんが,もしimplementsしている場合は,DOM Level 3で追加されたメソッドの実装をアプリケーションに追加する必要があります。
4XMLSchemaで属性のデフォルト値を定義して,その属性に対応するAttrノードを削除したとき,getSpecifiedメソッドの戻り値がfalseである属性ノードは生成されません。
5DocumentオブジェクトのnormalizeDocumentメソッドはサポートしていません。
6DocumentオブジェクトのadoptNodeメソッドはサポートしていません。代わりに,DocumentオブジェクトのimportNodeメソッドとNodeオブジェクトのremoveChildメソッドを組み合わせて使用してください。
7DocumentオブジェクトのgetInputEncodingメソッドおよびEntityオブジェクトのgetInputEncodingメソッドはサポートしていません。
8次の条件がすべて重なるとき,DocumentオブジェクトのrenameNode(Node n, String namespaceURI, String qualifiedName)メソッドを実行してもDOMException例外は発生しません。
  • 引数nが名前空間をサポートしないAttrオブジェクトである。
  • 引数namespaceURIがnullである。
  • 引数qualifiedNameが不正な修飾名である。
また,引数nにElementまたはAttrオブジェクトを指定し,かつ,引数qualifiedNameにnullを指定した場合,DOMException例外ではなくNullPointerException例外が発生します。
9Attrオブジェクト,Textオブジェクト,EntityReferenceオブジェクト,CDATASectionオブジェクト,DocumentTypeオブジェクト,DocumentFragmentオブジェクトのgetBaseURIメソッドではURIの取得ができません。
10TextオブジェクトのreplaceWholeText(String)メソッドはEntityReferenceノードを含まないDOMツリーに適用してください。
11DOMLocatorオブジェクトのgetByteOffsetの戻り値は常に-1です。
12DOMErrorHandlerオブジェクトのhandleErrorメソッドの引数DOMErrorにgetRelatedDataメソッドを適用したときの戻り値のオブジェクトは,Nodeオブジェクトとは限りません。エラーメッセージを表すStringオブジェクトが戻り値となる場合があります。

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

パラメタの名前設定可能な値
canonical-formfalse
cdata-sectionstrue,false
check-character-normalizationfalse
commentstrue,false
datatype-normalizationfalse
element-content-whitespacetrue
entitiestrue,false
error-handlerDOMErrorHandlerオブジェクト
infosettrue,false
namespacestrue
namespace-declarationstrue,false
normalize-charactersfalse
schema-location設定できません
schema-type設定できません
split-cdata-sectionstrue,false
validatefalse
validate-if-schemafalse
well-formedtrue
resource-resolverLSResourceResolverオブジェクト