A RESTの構成要素

この付録では、REST構成デプロイメント・ディスクリプタに関する詳細リファレンスと、ディスクリプタの簡単な概要を示します。

この付録では次の項について説明します。

REST構成ファイル
要素リファレンス

A.1 REST構成ファイル

REST構成デプロイメント・ディスクリプタにより、REST実装の構成を指定します。ディスクリプタのデフォルト名はcoherence-rest-config.xmlで、クラスパス上で見つかる必要があります。tangosol.coherence.rest.configシステム・プロパティを使用して、名前をオーバーライドできます。例:

-Dtangosol.coherence.rest.config=MyConfig.xml

REST構成デプロイメント・ディスクリプタのスキーマは、coherence-rest-config.xsdファイルに定義されます。XSDファイルはcoherence.jarライブラリのルートにおいて次のWeb URLにあります。

http://xmlns.oracle.com/coherence/coherence-rest-config/1.1/coherence-rest-config.xsd

<rest>要素は構成ファイルのルート要素で、一般的にXSDとCoherenceのネームスペース参照およびcoherence-rest-config.xsdファイルの場所が含まれています。例:

<?xml version='1.0'?>

<rest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns="http://xmlns.oracle.com/coherence/coherence-rest-config"
   xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-rest-config
   coherence-rest-config.xsd">

注意:

xsi:schemaLocation属性でWeb URLを参照した場合でも、coherence.jarライブラリにあるスキーマは必ず実行時に使用されます。
xsi:schemaLocation属性を省略してスキーマ検証を無効にできます。
デフォルトのキャラクタ・セットがASCIIではなくEBCDICである環境にCoherenceをデプロイする場合、このデプロイメント・ディスクリプタ・ファイルがASCII形式であり、ランタイム環境にバイナリ形式でデプロイされることを確認してください。

要素リファレンス

表A-1に、非終端REST構成要素のすべてを示します。

表A-1 RESTの構成要素

要素	使用場所
aggregator	aggregators
aggregators	rest
engine	query-engines
marshaller	resource
processor	processors
processors	rest
query	resource
query-engines	rest
resource	resources
resources	rest
rest	root element

aggregator

使用場所: aggregators

説明

aggregator要素は、キャッシュにあるデータの集計に使用するカスタム・アグリゲータの定義に使用されます。各aggregator要素には、アグリゲータ・クラスまたはアグリゲータのファクトリ・クラスと名前との間における単一バインディングが含まれている必要があります。

要素

表A-2でaggregator要素の下位要素を説明します。

表A-2 aggregatorの下位要素

要素	必須/ オプション	説明
<`name`>	必須	アグリゲータ・クラスまたはアグリゲータのファクトリ・クラスにバインドされるREST用URLで使用する名前を指定します。
<`class`>	必須	名前にバインドされるカスタム・アグリゲータ・クラスまたはカスタム・アグリゲータのファクトリ・クラスの完全修飾名を指定します。このクラスは`com.tangosol.util.EntryAggregator`または`com.tangosol.coherence.rest.util.aggregator.AggregatorFactory`インタフェースをそれぞれ実装する必要があります。

aggregators

使用場所: rest

説明

aggregators要素には、任意の数のカスタム・アグリゲータ定義が格納されます。

要素

表A-3でaggregators要素の下位要素を説明します。

表A-3 aggregatorsの下位要素

要素	必須/ オプション	説明
`<aggregator>`	必須	アグリゲータ・クラスまたはアグリゲータのファクトリ・クラスと名前との間における単一バインディングを指定します。

engine

使用場所: query-engines

説明

engines要素は、名前と問合せエンジン実装クラスとの間の単一バインディングを含みます。カスタム問合せエンジンには、com.tangosol.coherence.rest.query.QueryEngineとcom.tangosol.coherence.rest.query.Queryインタフェースを実装する必要があります。カスタム実装は、com.tangosol.coherence.rest.query.AbstractQueryEngineベース・クラスも拡張します。これにより、問合せ式の分析やパラメータ・バインドの処理を実行する有用なメソッドが提供されます。

要素

表A-4で、engine要素のサブ要素を説明します。

表A-4 engineの下位要素

要素	必須/ オプション	説明
`<name>`	必須	問合せエンジンの名前を指定します。
`<class-name>`	必須	問合せエンジン実装クラスの完全修飾名を指定します。

marshaller

使用場所: resource

説明

キャッシュ・エントリのキーと値のクラスとマーシャリング処理クラス(それらのクラスのインスタンスでマーシャリングとアンマーシャリングに使用)との間におけるバインドがマーシャリング要素にはあります。

要素

表A-5でmarshaller要素の下位要素を説明します。

表A-5 marshallerの下位要素

要素	必須/ オプション	説明
`<media-type>`	必須	マーシャリング用に使用するメディアの名前を指定します。CoherenceではXMLとJSONのデータ出力のデフォルト実装が用意されています。
`<class-name>`	必須	`com.tangosol.coherence.rest.io.Marshaller`インタフェースを実装するカスタム・クラスの完全修飾名を指定します。キャッシュに格納されるキャッシュ・エントリ値のマーシャリングとアンマーシャリングに実装が使用されます。マーシャリング処理は、それぞれのオブジェクト・タイプとメディア・タイプに対して構成されます。

processor

使用場所: processors

説明

processor要素は、キャッシュにあるデータの処理に使用するカスタム入力プロセッサの定義に使用されます。各processor要素には、プロセッサのファクトリ・クラスと名前との間における単一バインディングが含まれている必要があります。

要素

表A-6でprocessor要素の下位要素を説明します。

表A-6 processorの下位要素

要素	必須/ オプション	説明
`<name>`	必須	プロセッサのファクトリ・クラスにバインドされるREST用URLで使用する名前を指定します。
`<class-name>`	必須	名前にバインドされるカスタム・プロセッサのファクトリ・クラスの完全修飾名を指定します。このクラスは`com.tangosol.coherence.rest.util.processor.ProcessorFactory`インタフェースを実装する必要があります。

processors

使用場所: rest

説明

processors要素には、任意の数のカスタム・プロセッサ定義が格納されます。

要素

表A-7でprocessors要素の下位要素を説明します。

表A-7 processorsの下位要素

要素	必須/ オプション	説明
`<processor>`	必須	プロセッサのファクトリ・クラスと名前との間における単一バインディングを指定します。

query

使用場所: resources

説明

query要素は、名前付き問合せを定義します。名前付き問合せにより、REST URLで構成済の問合せ式を名前で実行できます。

GET http://host:port/cacheName/namedQuery?param1=value1,param2=value2...

名前付き問合せ定義は、問合せ名と実行する問合せ式間のバインディングから成ります。リソースに対して複数の名前付き問合せを構成できます。この問合せ要素では、次の属性がサポートされています。

max-results: 名前付き問合せに返す結果の最大数を指定します。この値は、<resource>要素のmax-results属性よりも優先されます。
engine: キャッシュに対する問合せ式の実行を受け持つ問合せエンジンの実装を指定します。属性が指定されていない場合のデフォルト値はDEFAULTであり、問合せ式をURLエンコードのCohQL式(CohQLの述語句)として指定する必要があることを示します。カスタム問合せエンジン実装の構成の詳細は、<query-engines>要素を参照してください。

要素

表A-8で、query要素のサブ要素を説明します。

表A-8 queryの下位要素

要素	必須/ オプション	説明
`<name>`	必須	queryの名前を指定します。
`<expression>`	必須	問合せ名にバインドする問合せ式を指定します。

query-engines

使用場所: rest

説明

query-engines要素には、任意の数のカスタム問合せエンジン定義が格納されます。問合せエンジンは、キャッシュに対して問合せ式を実行します。直接問合せおよび名前付き問合せは、基盤となる問合せエンジンに、それらの問合せの実行を依存しています。デフォルトの問合せエンジンは、URLエンコードのCohQL式(CohQLの述語句)として指定された問合せ式を実行するために提供されています。また、カスタム問合せエンジンを必要時に定義できます。

要素

表A-9で、query-engines要素のサブ要素を説明します。

表A-9 query-enginesのサブ要素

要素	必須/ オプション	説明
`<engine>`	必須	名前と問合せエンジン実装クラスの間における単一バインディングを指定します。

resource

使用場所: resources

説明

resource要素によりキャッシュ・エントリのマーシャリングとアンマーシャリングに使用するメタデータを渡します。キャッシュ名とキャッシュ・エントリ・キーと値クラスとの間における単一バインディングがメタデータに含まれます。

次の属性を使用できます。

name: 名前がRESTのURLパス・セグメント用に理想的でない場合における<cache-name>要素の別名を指定します。この値のデフォルトは、値が指定されていない場合における<cache-name>要素の値です。
max-results: 問合せに返す結果の最大数を指定します。この値は、max-results属性が、<query>または<direct-query>要素内にも定義されている場合に優先されます。

要素

表A-10でresource要素の下位要素を説明します。

表A-10 resourceの下位要素

要素	必須/ オプション	説明
`<cache-name>`	必須	このリソースで公開されるキャッシュの名前を指定します。キャッシュは、キャッシュ構成ファイルで定義する必要があります。
`<key-class>`	必須	このキャッシュに格納されるエントリ・キーのタイプを指定します。
`<value-class>`	必須	このキャッシュに格納されるエントリ値のタイプを指定します。
`<key-converter>`	オプション	`com.tangosol.coherence.rest.KeyConverter`インタフェースを実装するクラスの完全修飾名を指定します。このクラスは、キャッシュ・エントリのキーを文字列に変換したり、REST用URLで使用するキーの文字列表現をキャッシュ・エントリへのアクセスに使用できる適切なオブジェクト・インスタンスに変換するために使用されます。値が渡されない場合、`com.tangosol.coherence.rest.DefaultKeyConverter`クラスがデフォルトで使用されます。デフォルトのクラスには、Javaのプリミティブ、日付およびUUIDにおける文字列変換処理が用意されています。詳細は、Oracle CoherenceのJava APIリファレンスを参照してください。
`<marshaller>`	オプション	`com.tangosol.coherence.rest.io.Marshaller`インタフェースを実装するクラスの完全修飾名を指定します。キャッシュに格納されるキャッシュ・エントリ値のマーシャリングとアンマーシャリングにクラスが使用されます。CoherenceではXMLとJSONのデータ出力のデフォルト実装が用意されています。
`<query>`	オプション	REST URLで、構成済問合せ式の名前による実行を可能にする名前付き問合せの構成情報を指定します。
`<direct-query>`	オプション	REST URLに問合せ式をパラメータ`q`の値として含めることができる、直接問合せの構成情報を指定します。 GET http://host:port/cacheName?q=query 次の属性を使用できます。 `enabled`: リソースで直接問合せをサポートするかどうかを指定します。有効な値は、`true`と`false`です。デフォルト値は`false`です。 `max-results`: 直接問合せに返す結果の最大数を指定します。この値は、`<resource>`要素の`max-results`属性よりも優先されます。 `engine`: キャッシュに対する問合せ式の実行を受け持つ問合せエンジンの実装を指定します。属性が指定されていない場合のデフォルト値は`DEFAULT`であり、問合せ式をURLエンコードのCohQL式(CohQLの述語句)として指定する必要があることを示します。カスタム問合せエンジン実装の構成の詳細は、`<query-engines>`要素を参照してください。

resources

使用場所: rest

説明

リソース要素には、任意の数のリソース定義が格納されます。キャッシュ・エントリのマーシャリングとアンマーシャリングに使用するメタデータをリソース定義により渡します。

要素

表A-11でresources要素の下位要素を説明します。

表A-11 resourcesの下位要素

要素	必須/ オプション	説明
`<resource>`	必須	キャッシュ・エントリ・キーと値クラスとキャッシュ名との間における単一バインディングを指定します。

rest

root element

説明

rest要素は、Coherence REST実装の構成に使用するcoherence-rest-config.xmlファイルのルート要素です。実装ではRESTのWebサービスを使用して、リモート・クライアントでクラスタにあるデータをHTTPでアクセスでき、POFシリアライズを使用する必要はありません。

要素

表A-12でrest要素の下位要素を説明します。

表A-12 restの下位要素

要素	必須/ オプション	説明
`<resources>`	オプション	キャッシュ・エントリのマーシャリングとアンマーシャリングに使用するメタデータを渡すリソース定義の数を指定します。
<`processors>`	オプション	キャッシュにあるデータの処理に使用するカスタム・プロセッサ定義の数を指定します。
`<aggregators>`	オプション	キャッシュにあるデータの集計に使用するカスタム・アグリゲータ定義の数を指定します。
`<query-engines>`	オプション	任意の数のカスタム問合せエンジン定義を指定します。問合せエンジンは実行問合せを処理します。