1. Oracle Coherenceのインストール
  2. Coherenceのサンプルの実行

6 Coherenceのサンプルの実行

CoherenceのガイドおよびチュートリアルはCoherence GitHubリポジトリでホストされ、サンプル - ガイドおよびチュートリアルの概要に文書化されるようになりました。これらのサンプルは、Coherence 14.1.1.2206.x Feature PackバージョンとCoherence Community Edition (CE)バージョン22.06以降の両方に対して実行できます。

ノート:

このドキュメントの残りの部分で、サンプルはガイドとチュートリアルの両方を指します。

この章の内容は次のとおりです。

  • Coherenceのサンプルについて
    サンプルには、ガイドとチュートリアルの2つのサブセットがあります。
  • サンプルの取得
    サンプルは、Coherence Community EditionのGitHubリポジトリでホストされます。
  • 前提条件
    各サンプルには、特定のサンプルをビルドおよび実行するための前提条件の概要を説明するドキュメントがあります。
  • サンプルのビルドおよび実行
    サンプルをビルドおよび実行する方法は、Community Edition (CE)とCoherence 14.1.1.2206 Feature Packのどちらのリリースに対してサンプルを実行するかによって異なります。

Coherenceのサンプルについて

サンプルには、ガイドとチュートリアルの2つのサブセットがあります。

ガイド - これらの単純なガイドは、Coherenceの特定の機能に関する簡単で実践的な紹介になるように設計されています。ほとんどの場合、Coherence jarおよびIDE(または、テキスト・エディタ)のみが必要です。ガイドは通常、MavenプロジェクトとGradleプロジェクトの組合せとしてビルドされ、これらのツールに対応するラッパーが含まれるため、Coherenceソース・ツリー全体をビルドする必要なく、スタンドアロン・プロジェクトとして簡単にビルドできます。

チュートリアル - これらのチュートリアルでは、少数の単純なコード・スニペットで通常説明できない大規模なCoherenceの機能および概念をより深く理解できます。たとえば、機能を正しく示すために、稼働しているCoherenceクラスタが必要な場合があります。チュートリアルは通常、MavenプロジェクトとGradleプロジェクトの組合せとしてビルドされ、これらのツールに対応するラッパーが含まれるため、Coherenceソース・ツリー全体をビルドする必要なく、スタンドアロン・プロジェクトとして簡単にビルドできます。

親トピック: Coherenceのサンプルの実行

サンプルの取得

サンプルは、Coherence Community EditionのGitHubリポジトリでホストされます。Oracle Coherence Community Editionを参照してください。
選択したディレクトリで、次を使用してサンプルをクローニングします:
git clone https://github.com/oracle/coherence.git

このコマンドは、現在のディレクトリのcoherenceというディレクトリにサンプルをクローニングします。サンプルは、prj/examplesサブディレクトリにあります。

サンプルのドキュメントはオンラインで入手できます。サンプル - ガイドおよびチュートリアルの概要を参照してください。

親トピック: Coherenceのサンプルの実行

前提条件

各サンプルには、特定のサンプルをビルドおよび実行するための前提条件の概要を説明するドキュメントがあります。
少なくとも、次のものが必要です:
  • JDK11
  • Maven 3.8以上またはGradle 4以上。MavenおよびGradleを参照してください。
  • IntelliJ IDEAなどのコードをIDEに直接インポートすることもできます。

親トピック: Coherenceのサンプルの実行

サンプルのビルドおよび実行

サンプルをビルドおよび実行する方法は、Community Edition (CE)とCoherence 14.1.1.2206 Feature Packのどちらのリリースに対してサンプルを実行するかによって異なります。

親トピック: Coherenceのサンプルの実行

Coherence Community Editionを使用したサンプルの実行

Coherence Community Edition (CE)を使用してサンプルを実行するには、次のステップを実行します:
  1. クローニングしたcoherenceディレクトリに移動します。
  2. 使用しているCEバージョンのタグをチェックアウトします(すべてのサンプルで1回のみ必要)。たとえば、22.06の場合は次を使用します:
    git checkout v22.06
  3. 実行する特定のサンプルのドキュメントに従います。

親トピック: サンプルのビルドおよび実行

Coherence 14.1.1.2206 Feature Packを使用したサンプルの実行

この項には次のトピックが含まれます:

親トピック: サンプルのビルドおよび実行

前提条件のインストール

Feature Packをインストールした後、サンプルを実行するには、必要なCoherence Maven pomおよびjarをインストールする必要があります。このステップが必要なのは1回のみです。

COHERENCE_HOME環境変数を、インストール・ディレクトリの下のcoherenceディレクトリに設定します。たとえば、Coherenceが/u01/coherenceHomeの場所にインストールされている場合、COHERENCE_HOME=/u01/coherenceHome/coherenceです。

次のコマンドを実行して、ほとんどのサンプルの最小要件である様々なアーティファクトをインストールします。

ノート:

maven-syncプラグインを使用して、すべてのアーティファクトをインストールすることもできます。『継続的統合によるアプリケーションの開発』のMaven同期プラグインの概要に関する項を参照してください。
Linux/Macの場合:
mvn install:install-file  -Dpackaging=pom -Dfile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bom/14.1.1/coherence-bom.14.1.1.pom \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bom/14.1.1/coherence-bom.14.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence/14.1.1/coherence.14.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-bedrock.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bedrock/14.1.1/coherence-bedrock.14.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-bedrock-testing-support.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bedrock-testing-support/14.1.1/coherence-bedrock-testing-support.14.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-grpc.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-grpc/14.1.1/coherence-grpc.14.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-grpc-proxy.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-grpc-proxy/14.1.1/coherence-grpc-proxy.14.1.1.pom
    
mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-java-client.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-java-client/14.1.1/coherence-java-client.14.1.1.pom
            
mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-json.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-json/14.1.1/coherence-json.14.1.1.pom
GraphQLに必須:
mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-cdi-server.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-cdi-server/14.1.1/coherence-cdi-server.14.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-cdi.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-cdi/14.1.1/coherence-cdi.14.1.1.pom
Windowsの場合:
mvn install:install-file  -Dpackaging=pom -Dfile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bom\14.1.1\coherence-bom.14.1.1.pom ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bom\14.1.1\coherence-bom.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence\14.1.1\coherence.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-bedrock.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bedrock\14.1.1\coherence-bedrock.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-bedrock-testing-support.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bedrock-testing-support\14.1.1\coherence-bedrock-testing-support.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-grpc.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-grpc\14.1.1\coherence-grpc.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-grpc-proxy.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-grpc-proxy\14.1.1\coherence-grpc-proxy.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-java-client.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-java-client\14.1.1\coherence-java-client.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-json.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-json\14.1.1\coherence-json.14.1.1.pom
GraphQLに必須:
mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-cdi-server.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-cdi-server\14.1.1\coherence-cdi-server.14.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-cdi.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-cdi\14.1.1\coherence-cdi.14.1.1.pom
任意のサンプルのビルドおよび実行

いずれかのサンプルを実行するには、mvnwの-Dオプションを使用してグループIDおよびリビジョンを変更するか、gradlewコマンドの-Pオプションを使用して、使用しているCoherenceのバージョンおよびグループIDを設定する必要があります。

次に例を示します。

Maven:
./mvnw -Dcoherence.group.id=com.oracle.coherence -Drevision=14.1.1-2206-1 clean verify
Gradle:
./gradlew -PcoherenceGroupId=com.oracle.coherence -PcoherenceVersion=14.1.1-2206-1 clean build