6 Coherenceのサンプルの実行

CoherenceのガイドおよびチュートリアルはCoherence GitHubリポジトリでホストされ、サンプル - ガイドおよびチュートリアルの概要に文書化されるようになりました。これらの例は、Coherence 15c (15.1.1.0.0)以降に対して実行できます。

ノート:

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

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

Coherenceのサンプルについて

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

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

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

サンプルの取得

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

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

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

前提条件

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

Coherence 15c (15.1.1.0.0)を使用したサンプルの実行

Coherence 15c (15.1.1.0.0)を使用してサンプルを実行するには、次の手順を実行します。

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

前提条件のインストール

Oracle Coherenceをインストールした後、サンプルを実行するには、必要な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/15.1.1/coherence-bom.15.1.1.pom \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bom/15.1.1/coherence-bom.15.1.1.pom

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

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-bedrock.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bedrock/15.1.1/coherence-bedrock.15.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/15.1.1/coherence-bedrock-testing-support.15.1.1.pom

mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-grpc.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-grpc/15.1.1/coherence-grpc.15.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/15.1.1/coherence-grpc-proxy.15.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/15.1.1/coherence-java-client.15.1.1.pom
            
mvn install:install-file -Dfile=$COHERENCE_HOME/lib/coherence-json.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-json/15.1.1/coherence-json.15.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/15.1.1/coherence-cdi-server.15.1.1.pom

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

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

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-bedrock.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bedrock\15.1.1\coherence-bedrock.15.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\15.1.1\coherence-bedrock-testing-support.15.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-grpc.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-grpc\15.1.1\coherence-grpc.15.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\15.1.1\coherence-grpc-proxy.15.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\15.1.1\coherence-java-client.15.1.1.pom

mvn install:install-file -Dfile=%COHERENCE_HOME%\lib\coherence-json.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-json\15.1.1\coherence-json.15.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\15.1.1\coherence-cdi-server.15.1.1.pom

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

POF注釈処理に必須:

Linux/Macの場合:
mvn install:install-file -Dfile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/pof-maven-plugin/15.1.1/pof-maven-plugin.15.1.1.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/pof-maven-plugin/15.1.1/pof-maven-plugin.15.1.1.pom
mvn install:install-file -Dfile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/com.oracle.coherence.gradle.plugin/15.1.1/com.oracle.coherence.gradle.plugin.15.1.1.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/com.oracle.coherence.gradle.plugin/15.1.1/com.oracle.coherence.gradle.plugin.15.1.1.pom
Windowsの場合:
mvn install:install-file -Dfile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\pof-maven-plugin\15.1.1\pof-maven-plugin.15.1.1.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\pof-maven-plugin\15.1.1\pof-maven-plugin.15.1.1.pom
mvn install:install-file -Dfile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\com.oracle.coherence.gradle.plugin\15.1.1\com.oracle.coherence.gradle.plugin.15.1.1.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\com.oracle.coherence.gradle.plugin\15.1.1\com.oracle.coherence.gradle.plugin.15.1.1.pom

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

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

次に例を示します。

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