feature-examples

Tanzu GemFire feature examples

The examples in this folder are showcase features of GemFire and demonstrate their basic usage.

For details on all GemFire features, see Tanzu GemFire Documentation.

Tanzu GemFire Version

Your client code must link against the same or older version (ignoring patch versions) of Tanzu GemFire as the Tanzu GemFire server it will connect to.

To link against an older version of GemFire, edit the gemfireVersion= line in gradle.properties.

Prerequisites

In order to execute the examples in this project, follow these steps:

1. Ensure JDK 11 or JDK 17 is installed (and set JAVA_HOME if it's not the default). JDK 8 can be used, but some examples such as lucene and luceneSpatial will not work.
2. Download the version of GemFire that you want to use as the server from Broadcom Customer Support
3. Unpack the GemFire TGZ file (e.g. tar xzf vmware-gemfire-10.1.0.tgz)
4. export GEMFIRE_HOME to point to the top level directory inside the extracted GemFire. For example, if you extracted in /tmp/downloads, export GEMFIRE_HOME=/tmp/downloads/vmware-gemfire-10.1.0.
5. When you first run the gradle commands below you'll be prompted to supply credentials. Set gemfireReleaseRepoUser but leave gemfireReleaseRepoPassword blank for instructions how to obtain an access token.

Running an example

You can now run an example with the following gradle targets:

• build - compiles the example and runs unit tests
• start - initializes the Tanzu GemFire cluster
• run - runs the example Application
• stop - shuts down the cluster
• runAll - invokes start, run, stop

The commands you need to run a specific example will be given in the README.md file. Sample usage:

$ ./gradlew :replicated:start
$ ./gradlew :replicated:run
$ ./gradlew :replicated:stop

Catalog of examples

The following sections call out ready-made examples. You may want to start your journey with the Tanzu GemFire Documentation.

Basics

• Replicated Region
• Partitioned Region
• Put Multiple Values at Once
• Functions
• Persistence
• OQL (Querying)

Intermediate

• Serialization
• Lucene Indexing
• OQL Indexing
• Cache Loader
• Cache Writer
• Cache Listeners
• Async Event Queues & Async Event Listeners
• Continuous Querying
• Transaction
• Eviction
• Expiration
• Overflow
• Security & SSL
• Colocation
• Rest
• JSON

Advanced

• Lucene Spatial Indexing
• WAN Gateway
• WAN Gateway Delta
• Durable Messaging for Subscriptions
• Micrometer Metrics
• Compression
• Launchers