第12章 REST インターフェース
Red Hat JBoss Data Grid は、REST インターフェースを提供します。REST API の主な利点は、クライアントとサーバー間で疎結合が可能になることです。クライアントライブラリーおよびバインディングの特定のバージョンに対する依存性がなくなります。REST API によりオーバーヘッドが発生し、REST クライアントまたはカスタムコードが REST 呼び出しを認識し、作成する必要があります。
JBoss Data Grid の REST API と対話するには、HTTP クライアントライブラリーのみが必要です。Java の場合は Apache HTTP Commons Client が推奨されます。または、java.net API を使用できます。
重要
以下の例では、REST セキュリティーが REST コネクターで無効にされていることを前提とします。REST セキュリティーを無効にするには、コネクターから
security-domain および auth-method パラメーターを削除します。
12.1. REST インターフェースコネクター リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
REST コネクターは Web サブシステムが必要である点で、Hot Rod および Memcached コネクターとは異なります。したがって、ソケットバインディング、ワーカースレッド、タイムアウトなどの設定は、Web サブシステムで実行する必要があります。
REST インターフェースがサーバーで有効にされると、通常これをデータの追加、削除、および取得のために使用できます。これらのプロセスについての詳細は、JBoss Data Grid の 『Developer Guide』 を参照してください。
12.1.1. REST コネクターの設定 リンクのコピーリンクがクリップボードにコピーされました!
リンクのコピーリンクがクリップボードにコピーされました!
次の手順を使用して、Red Hat JBoss Data Grid のリモートクライアントサーバーモードで
rest-connector 要素を設定します。
手順12.1 リモートクライアントサーバーモード用 REST コネクターの設定
rest-connector 要素は、REST コネクターの設定情報を指定します。
cache-containerパラメーターは、REST コネクターで使用されるキャッシュコンテナーを指定します。これは必須パラメーターです。context-pathパラメーターは、REST コネクターのコンテキストパスを指定します。このパラメーターのデフォルト値は空の文字列 ("") です。これはオプションパラメーターです。security-domainパラメーターは、REST エンドポイントへのアクセスを認証するためにセキュリティーサブシステムで宣言された指定済みドメインを使用することを指定します。これはオプションパラメーターです。このパラメーターが省略されると、認証は実行されません。auth-methodパラメーターは、エンドポイントのクレデンシャルを取得するために使用するメソッドを指定します。このパラメーターのデフォルト値はBASICです。サポートされる別の値にはBASIC、DIGEST、およびCLIENT-CERTがあります。これはオプションパラメーターです。security-modeパラメーターは、書き込み操作 (PUT、POST、DELETE など) または読み取り操作 (GET や HEAD など) に対してのみ認証が必要かどうかを指定します。このパラメーターの有効な値はWRITE(書き込み操作のみを認証する場合) またはREAD_WRITE(読み書き操作を認証する場合) です。このパラメーターのデフォルト値はREAD_WRITEです。