JAVA/CORBA クラス

parseXML メソッド
例

添付ファイルの内容を解析し、XML の DOM ツリーを生成します。

メモ このメソッドは Release 5.0.3 で新しく追加されました。

定義位置

EmbeddedObject、Item、MIMEEntity

構文

public org.w3c.dom.Document parseXML(boolean validate)
   throws NotesException, java.io.IOException, org.xml.sax.SAXException

パラメータ

boolean validate


戻り値

org.w3c.dom.Document


使用法

スタンドアロンのアプリケーションでは、lotus.domino クラスの classpath に NCSO.jar または Notes.jar ファイルを含める必要があります。さらに XML パーサーを使用するには、使用する環境の classpath に XML4j.jar ファイルを含め、XSL プロセッサを使用するには、classpath に LotusXSL.jar ファイルを含める必要があります。

メモ transformXML メソッドのみを使用する場合でも、環境の classpath に XML4j.jar を含めなければなりません。

ブラウザで実行されるアプレットでは、XML パーサーを使用するにはアプレット自体に XML4j.jar と XML4j.cab ファイルの両方あるいはいずれかを含める必要があります。XSL プロセッサを使用するには、アプレット自体に LotusXSL.jar と LotusXSL.cab ファイルの両方あるいはいずれかを含めるだけでなく、XML4j.jar と XML4j.cab ファイルの両方あるいはいずれかを含める必要があります。

変換の途中に生じたエラーは System.err に送られます。

XML ストリームに相対 URL または部分 URL が含まれる場合、parseXML メソッドまたは transformXML メソッドは、この部分 URL を InputStream の元となるデータベース内のページとして解釈します。たとえば、parseXML または transformXML メソッドは、<!DOCTYPE software-release-note SYSTEM "readme.dtd"> という XML ストリームを検出すると、ソースストリームの元のデータベースから「readme.dtd」という名前のページを検索します。

EmbeddedObject.parseXML は一時ファイルを作成します。このファイルは、EmbeddedObject が再利用されるときに削除されます。

メモ このメソッドは、Release 7.0 で、URL に位置する DTD を処理するように機能強化されました。しかし、URL を使用する場合、サーバー上の負荷が重すぎると、DOMParser.Process() は断続的に失敗してエラー #4602「DOM parser operation failed」を出し、タイムアウトになります。この場合、呼び出しアプリケーションは再試行する必要があります。

例
関連項目