This is the home of Apache Geode examples that are bundled with the project. Contributions[2] and corrections are welcome. Please talk to us about your suggestions at [email protected] or submit a pull request.
The gradle build will automatically download and install a Geode release in the
build
directory. You can run an example with the following gradle targets:
build
- compiles the example and runs unit testsstart
- initializes the Geode clusterrun
- runs the example Applicationstop
- shuts down the clusterrunAll
- invokes start, run, stop
The commands you need to invoke will be given in the README.md
file. Sample
usage:
$ ./gradle :replicated:start
$ ./gradle :replicated:run
$ ./gradle :replicated:stop
$ ./gradle runAll
The following sections call out ready-made examples or new examples that could be built. You may want to start your journey with the Apache Geode in 15 minutes or Less tutorial.
- Replicated Region
- Partitioned Region
- Put Multiple Values at Once
- Persistence
- OQL (Querying)
- PDX & Serialization
- Lucene Indexing
- OQL Indexing
- Functions
- CacheLoader & CacheWriter
- Listeners
- Async Event Queues
- Continuous Querying
- Transactions
- Eviction
- Expiration
- Overflow
- Security
- Off-heap
- WAN Gateway
- Durable subscriptions
- Delta propagation
- Network partition detection
- D-lock
- Compression
- Resource manager
- PDX Advanced
This section has self-contained little projects that illustrate a use case or an integration with other projects.
- SpringBoot Application
- HTTP Session replication
- Redis
- Memcached
- Spark Connector
Follow this approach to add a new example:
- Create a subdirectory with a descriptive name like
cache-writer
- Create a
README.md
file in the example subproject to walk the user through the tutorial - Create a Java class with a main method in the
org.apache.geode.examples.$name.Example
class - Create a cluster initialization script in
scripts/start.gfsh
- Create a cluster shutdown script in
scripts/stop.gfsh
The scripts should contain gfsh
commands for starting locators, servers, and
creating regions--everything that the example program will need to use. Where
appropriate you should also add unit tests. To customize the build you can add
a build.gradle
file.
Note that the build may fail if you do not add ASF license headers or use the
correct formatting (you can fix formatting with gradle spotlessApply
).
- [1] https://cwiki.apache.org/confluence/display/GEODE/Criteria+for+Code+Submissions
- [2] https://cwiki.apache.org/confluence/display/GEODE/How+to+Contribute
- [3] http://www.apache.org/licenses/#clas
This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.
The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.
The following provides more details on the included cryptographic software:
- Apache Geode is designed to be used with Java Secure Socket Extension (JSSE) and Java Cryptography Extension (JCE). The JCE Unlimited Strength Jurisdiction Policy may need to be installed separately to use keystore passwords with 7 or more characters.
- Apache Geode links to and uses OpenSSL ciphers.