XQuery ソースの操作

この章では、BEA AquaLogic Data Services Platform のソースビューについて説明します。この章の内容は以下のとおりです。

ソースビューとは

データサービスの基底の XQuery ソースには、通常、次のような特徴があります。

データサービスの XML 型としてスキーマを参照する。
1 つまたは複数の読み取り関数と、必要に応じて、1 つまたは複数の関係関数を定義する。
参照されるサービスのネームスペースを宣言する。
XQuery エンジンに対するさまざまなプラグマディレクティブが含まれる。

また、物理データソースから作成されたデータサービスには、その物理ソースに関連するメタデータが含まれています。たとえば、リレーショナルデータに基づくデータサービスでは、XML フィールド型 (xs:string など)、Xpath、ネイティブサイズ、ネイティブ型、null 可能性の設定などを記述します。

データサービスの開発では、ソースを変更した方が便利になる場合や、ソースの変更が必要な場合が多くあります。

ソースを直接操作して開発やトラブルシューティングを行う方が望ましい場合もあります。 [ソースビュー] タブを使用すると、スキーマと同様に、データサービスのソースコードを直接編集できます。ソースへの変更は、XQuery エディタなどの他のデータサービスモードにすぐに反映されます。同様に、XQuery エディタやデザインビューで変更が行われると、ソースはすぐに更新されます。

XQuery のサポート

AquaLogic Data Services Platform は「XQuery 1.0: An XML Query Language, W3C Working Draft of July, 23, 2004」で規定された XQuery 言語をサポートしています。この仕様で規定されているのどの言語機能でも使用できます。

AquaLogic Data Services Platform では、ソースビューでプラグマとして表示される一連の要素とディレクティブによって、基本の XQuery 構文を補完しています。プラグマは、実装者やベンダが XQuery コード内にカスタムの要素やディレクティブを含めることができる、標準の XQuery 機能です。

XQuery の BEA 実装には、言語の拡張や追加の関数も含まれています。 XQuery の BEA による拡張と、W3C ドキュメントへのリンクについては、AquaLogic Data Services Platform の『XQuery 開発者ガイド』で説明されています。

図 8-1 プラグマ、ネームスペース宣言、および関数を表示するソースビュー

ソースビューの使用

[ソースビュー] タブをクリックすると、ソースビューでファイルを表示できます。特定のクエリ関数のソースビューを開くには、最初に、デザインビューまたは XQuery エディタビューで関数を選択し、次に [ソースビュー] タブをクリックします。

テキストの検索

ソースビューで特定のテキスト文字列を検索できます。WebLogic Workshop の [編集｜検索] コマンドオプションまたは〔Ctrl〕+〔f〕を使用すると、ファイル検索機能にアクセスできます。大文字/小文字の区別の指定、単語検索、ワイルドカード検索パターン、限定的な検索などの、詳細な検索および置換機能が用意されています。見つかった文字列のすべての出現箇所をマークするオプションもあります。

見つかった項目は黄色で強調表示されます。この機能によって、変数の使用などを簡単に追跡することができます。

関数のナビゲーション

便利な機能として、次のような特定の関数呼び出しにマウスをポイントしながら〔Ctrl〕を押すと、特定の関数によって表現されるデータサービスに簡単に移動することができます。

for $fk in f3:ADDRESS()

関数名を繰り返すポップアップをクリックすると、その関数を含むデータサービスがその関数に対して開きます。

コード編集機能

色分け

ソースビュー内の XQuery ドキュメントは、ソースコードのさまざまな要素を強調表示するために色分けされています。デフォルトでは、キーワードが青い太字、コメント (プラグマを含む) がグレー、変数がマゼンタ色です。

[IDE プロパティ] ダイアログ ([ツール｜IDE プロパティ]) で色分けをカスタマイズできます。

コードコンプリーション

ネームスペースプレフィックスがわかっている場合は、関数コンプリーション機能を有効にすることができます。

ネームスペースプレフィックとその後にコロンを入力すると、関数コンプリーションが呼び出されます。ネームスペースプレフィックスは、データサービスまたは XFL ファイルに対応する URI にバインドされている必要があります。もう一つの方法として、プレフィックスとコロンを入力し、続けて〔Ctrl〕+〔Space〕を押すこともできます。

図 8-4 ネームスペースプレフィックスを使用する関数コンプリーション

Xpath 式を完成させる

関数コンプリーション機能は、Xpath 式を完成させるために使用することもできます。

既存の Xpath 式の末尾にカーソルを置きます。
〔Ctrl〕+〔Space〕を押します。
ポップアップリストから適切な要素を選択します (図 8-5)。

図 8-5 ソースビューの XPath コードコンプリーション

ソースビューの XPath コードコンプリーション

エラーの特定

編集の結果、または XQuery エディタで行われた変更の結果としてソースに発生した構文エラーは、ソースビューのスクロールバー上にマークされます (図 8-6)。エラーマークをクリックすると、コードの該当する行にカーソルが移動します。

問題のある実際のコードには赤字の下線が付いています。テキストをマウスでポイントすると、詳細なエラーメッセージが表示されます。

図 8-6 構文エラーがマークされ、マウスでポイントすると詳細のテキストが表示される

ソースビューのコードコンプリーションとエラーの強調表示を追加のクラスでも使用する場合は、Workshop.properties ファイルを編集して、paths.classPath プロパティにクラスファイルまたは JAR ファイルを追加してから、WebLogic Workshop を再起動します。

データ サービス開発者ガイド