オブジェクトの XML への投影の概要

基礎編

オブジェクトを XML に投影するという表現は、オブジェクトを XML ドキュメントとして使用可能にする方法を定義することを意味します。オブジェクトを XML に投影するには、オブジェクトを定義するクラスのスーパークラス・リストに %XML.AdaptorOpens in a new tab を追加します。そのクラスで使用する他のオブジェクト・クラスも同様です。ただし、少数の例外があります。

また、この作業は、オブジェクトを定義したりそのクラスを XML 対応にするクラスの XML プロジェクションの定義とも呼びます。

動作内容

クラスの XML プロジェクションを定義すると、以下のようになります。

• システムでは、さらにクラスの INT コードを生成して、クラスのインスタンスを XML ドキュメントとして使用できるようにします(このコードはクラスのコンパイル時に生成されます。編集はしないでください)。

• クラスの各プロパティは、%XML.PropertyParametersOpens in a new tab から自動的に継承します。

• %XML.AdaptorOpens in a new tab により、クラスの XML 関連パラメータがクラスに追加されます。

• %XML.PropertyParametersOpens in a new tab により、プロパティの XML 関連パラメータがクラスのプロパティに追加されます。

• データ型プロパティにより、LogicalToXSD() メソッドと XSDToLogical() メソッドが定義されます。これによって、XML への出力または XML からの入力が行われたときにデータがどのように変換されるかが制御されます。

次に、既定のプロジェクションがニーズに適合しない場合は、必要に応じて、クラスの XML 関連パラメータを編集します。

プロジェクション・オプション

指定されたクラスに対する XML プロジェクションは、そのクラスのインスタンスがどのように XML ドキュメントに対応するか、また XML ドキュメントがどのようにそのクラスのインスタンスに対応するかを決定します。以下はその例です。

以下の方法を含めて、XML プロジェクションは多くの方法で制御できます。

• プロパティの投影先の構造を制御する。例えば、単純なプロパティは要素または属性として投影できます。それ以外は、これまでの例で示してきたように、投影できません。

• XML の要素名と属性名を制御する。

• 要素と属性が割り当てられた XML ネームスペースを制御する。

• InterSystems IRIS クラスが XML スキーマにどのようにマッピングされるかについて、詳細を制御する。

これらのパラメータの大半は、XML 対応クラスを使用するすべてのシナリオに影響します。このドキュメントに記載されているとおり、いくつかのパラメータは、特定のシナリオでのみ適用されます。

InterSystems IRIS における関連ツール

クラスの XML プロジェクションを定義すると、InterSystems IRIS のツールの多くにアクセスできます。それらのツールは、多くの実用的アプリケーションに適してします。以下のいずれの方法でも、これらのツールを使用してクラスを操作できます。

• そのクラスのオブジェクトを XML ドキュメントにエクスポートする。

• XML ドキュメントを InterSystems IRIS にインポートする。これによって、そのクラスの新規インスタンスが作成され、保存できます。

• そのクラスのオブジェクトを、Web サービスおよび Web クライアントの引数として使用する。

• XML スキーマを生成する。InterSystems IRIS では、クラスの XML タイプが暗黙的に定義され、そのクラスのオブジェクトを使用する際に、前述した方法のいずれかで検証に使用されます。

InterSystems IRIS には、InterSystems IRIS クラスに対応していない任意の XML ドキュメントを含めて、XML ドキュメントを操作するためのツールが用意されています。これらのツールでは、DOM、XPath、および XSLT がサポートされています。

InterSystems IRIS では、InterSystems IRIS SAX (Simple API for XML) パーサを使用して、着信と発信の XML ドキュメントを検証し、解析します。InterSystems IRIS SAX パーサは、標準 Xerces ライブラリを使用した、組み込みの SAX XML 検証パーサです。InterSystems IRIS SAX は、高性能なプロセス内コールイン・メカニズムを使用して、InterSystems IRIS プロセスと通信します。パーサを微調整したり、独自のカスタム SAX インタフェース・クラスを用意できます。

ここに記載されている XML ツールのいずれかを使用する方法の詳細は、"XML ツールの使用法" を参照してください。

Web サービスおよびクライアントの詳細は、"Web サービスおよび Web クライアントの作成" を参照してください。

XML ドキュメントに対して考えられるアプリケーション

XML ドキュメントは、以下のように、さまざまな実用的アプリケーションで使用できます。

• メッセージ・アプリケーションで、標準形式として使用できます。これには、業界標準のプロトコルのほかに、ローカルなソリューションも含まれます。

• アプリケーションとユーザ間の、データ変換のための標準形式として使用できます。

• 外部データ・ストレージに対する、標準的な表現として使用できます。これには、従来のデータベース・レコードや、ドキュメントのようなより複雑なコンテンツも含まれる場合があります。

• Web サービスと Web クライアントの間で送信される SOAP メッセージのペイロードとして使用できます。

• クラス定義における XData ブロックの内容として使用できます。"クラスの定義と使用" の "XData ブロック" を参照してください。