7.2. サーバースクリプトの作成

カスタムスクリプトを作成して、Data Grid サーバーに追加します。

Data Grid サーバーのスクリプトは javax.script API をベースとしており、JVM ベースの ScriptEngine 実装と互換性があります。

Hello World スクリプトの例

以下は、1 つの Data Grid サーバーで実行され、1 つのパラメーターを持ち、JavaScript を使用する簡単な例です。

// mode=local,language=javascript,parameters=[greetee]
"Hello " + greetee

上記のスクリプトを実行するときに、greetee パラメーターの値を渡すと、Data Grid は "Hello ${value}" を返します。

メタデータは、スクリプトの実行中に Data Grid サーバーが使用するスクリプトに関する追加の情報を提供します。

スクリプトメタデータは、スクリプトの最初の行でコメントを追加する property=value ペアです。以下に例を示します。

// name=test, language=javascript
// mode=local, parameters=[a,b,c]

表7.1 メタデータプロパティー
プロパティー	説明
`mode`	実行モードを定義し、次の値を持ちます。 `local` は、リクエストを処理するノードのみがスクリプトを実行します。ただし、スクリプトはクラスター化された操作を引き続き呼び出すことができます。 `distributed` Data Grid は、クラスター化されたエグゼキューターを使用してノード間でスクリプトを実行します。
`言語`	スクリプトを実行する ScriptEngine を指定します。
`extension`	ScriptEngine を設定する代替方法としてファイル名の拡張子を指定します。
`role`	ユーザーがスクリプトを実行する必要があるロールを指定します。
`parameters`	このスクリプトの有効なパラメーター名の配列を指定します。このリストに含まれていないパラメーターを指定する呼び出しによって例外が生じます。
`datatype`	オプションで、データおよびパラメーターおよび戻り値を保存する MediaType(MIME タイプ) を設定します。このプロパティーは、特定のデータフォーマットのみをサポートするリモートクライアントに便利です。現在、データに String UTF-8 形式を使用するように、`text/plain; charset=utf-8` のみを設定できます。

Data Grid は、内部オブジェクトをスクリプト実行のバインディングとして公開します。

バインディング	説明
`cache`	スクリプトが実行されるキャッシュを指定します。
`marshaller`	データをキャッシュにシリアル化するために使用するマーシャラーを指定します。
`cacheManager`	キャッシュの `cacheManager` を指定します。
`scriptingManager`	スクリプトを実行するスクリプトマネージャーのインスタンスを指定します。このバインディングを使用して、スクリプトから他のスクリプトを実行することができます。

Data Grid を使用すると、スクリプトを実行するためのバインディングとして名前付きパラメーターを渡すことができます。

パラメーターは name,value のペアで、name は文字列、value はマーシャラーが解釈できる任意の値になります。

以下のスクリプトの例では、multiplicand と multiplier の 2 つのパラメーターがあります。このスクリプトは multiplicand の値を取り、その値を multiplier の値で乗算します。

// mode=local,language=javascript
multiplicand * multiplier

上記のスクリプトを実行すると、Data Grid は式の評価の結果で応答します。