Running the Coherence Examples

6 Running the Coherence Examples

Coherence guides and tutorials are now hosted on the Coherence GitHub Repository and are documented here: Examples - Guides & Tutorials Overview. These examples can be run against Coherence 14c (14.1.2.0.0) and above.

Note:

In the rest of the document, examples refer to both guides and tutorials.

This chapter includes the following sections:

About Coherence Examples
There are two subsets of examples: Guides and Tutorials.
Obtaining the Examples
The examples are hosted on the Coherence GitHub repository.
Prerequisites
Each example has documentation outlining the prerequisites for building and running the specific example.
Running Examples Using Coherence 14c (14.1.2.0.0)

About Coherence Examples

There are two subsets of examples: Guides and Tutorials.

Guides - These simple guides are designed to be a quick hands-on introduction to a specific feature of Coherence. In most cases, they require nothing more than a Coherence jar and an IDE (or a text editor). Guides are typically built as a combination of Maven and Gradle project, including the corresponding wrappers for those tools, making them simple to build as stand-alone projects without needing to build the whole Coherence source tree.

Tutorials - These tutorials provide a deeper understanding of larger Coherence features and concepts that cannot usually be explained with a few simple code snippets. They might, for example, require a running Coherence cluster to properly show a feature. Tutorials are typically built as a combination of Maven and Gradle project, including the corresponding wrappers for those tools, making them simple to build as stand-alone projects without needing to build the whole Coherence source tree.

Parent topic: Running the Coherence Examples

Obtaining the Examples

The examples are hosted on the Coherence GitHub repository.

In a directory of your choice, clone the examples using the following:

git clone https://github.com/oracle/coherence.git

This command clones the examples into a directory called coherence, off the current directory. You can find the examples in the prj/examples sub-directory.

The documentation for the examples is available online. See Examples - Guides & Tutorials Overview.

Parent topic: Running the Coherence Examples

Prerequisites

Each example has documentation outlining the prerequisites for building and running the specific example.

As a minimum, you will require the following:

JDK 17
Maven 3.8+ or Gradle 4+. See Maven and Gradle.
You can also import the code straight into your IDE such as IntelliJ IDEA.

Parent topic: Running the Coherence Examples

Running Examples Using Coherence 14c (14.1.2.0.0)

Perform the following procedures to run examples using Coherence 14c (14.1.2.0.0).

This section includes the following topics:

Parent topic: Running the Coherence Examples

Installing the Prerequisites

After you have installed Oracle Coherence, you must install the required Coherence Maven poms and jars to run the examples. This step is required only once.

Set the COHERENCE_HOME environment variable to the coherence directory under your installation directory. For example, if Coherence is installed in the /u01/coherenceHome location, then COHERENCE_HOME=/u01/coherenceHome/coherence.

Run the following commands to install the various artifacts which are the minimum requirements for most of the examples.

Note:

You can also use the maven-sync plug-in to install all artifacts. See Introduction to the Maven Synchronization Plug-In in Developing Applications Using Continuous Integration.

For Linux/Mac:

mvn install:install-file  -Dpackaging=pom -Dfile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bom/14.1.2/coherence-bom.14.1.2.pom \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/coherence-bom/14.1.2/coherence-bom.14.1.2.pom

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

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

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

Required for 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.2/coherence-cdi-server.14.1.2.pom

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

For Windows:

mvn install:install-file  -Dpackaging=pom -Dfile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bom\14.1.2\coherence-bom.14.1.2.pom ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\coherence-bom\14.1.2\coherence-bom.14.1.2.pom

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

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

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

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

Required for 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.2\coherence-cdi-server.14.1.2.pom

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

Required for POF annotations processing:

For Linux/Mac:

mvn install:install-file -Dfile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/pof-maven-plugin/14.1.2/pof-maven-plugin.14.1.2.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/pof-maven-plugin/14.1.2/pof-maven-plugin.14.1.2.pom
mvn install:install-file -Dfile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/com.oracle.coherence.gradle.plugin/14.1.2/com.oracle.coherence.gradle.plugin.14.1.2.jar \
    -DpomFile=$COHERENCE_HOME/plugins/maven/com/oracle/coherence/com.oracle.coherence.gradle.plugin/14.1.2/com.oracle.coherence.gradle.plugin.14.1.2.pom

For Windows:

mvn install:install-file -Dfile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\pof-maven-plugin\14.1.2\pof-maven-plugin.14.1.2.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\pof-maven-plugin\14.1.2\pof-maven-plugin.14.1.2.pom
mvn install:install-file -Dfile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\com.oracle.coherence.gradle.plugin\14.1.2\com.oracle.coherence.gradle.plugin.14.1.2.jar ^
    -DpomFile=%COHERENCE_HOME%\plugins\maven\com\oracle\coherence\com.oracle.coherence.gradle.plugin\14.1.2\com.oracle.coherence.gradle.plugin.14.1.2.pom

Parent topic: Running Examples Using Coherence 14c (14.1.2.0.0)

Building and Running Any Example

To run any of the examples, you must change the group id and revision using the -D option in mvnw or the -P option in gradlew commands to set the Coherence version and group ID you are using.

Examples are shown below:

Maven:

./mvnw -Dcoherence.group.id=com.oracle.coherence -Drevision=14.1.2-0-0 clean verify

Gradle:

./gradlew -PcoherenceGroupId=com.oracle.coherence -PcoherenceVersion=14.1.2-0-0 clean build

Parent topic: Running Examples Using Coherence 14c (14.1.2.0.0)