Skip to content

rwinch/spring-boot-data-geode

 
 

Build Status

Spring Boot for Apache Geode & Pivotal GemFire

Spring Boot for Apache Geode & Pivotal GemFire extends Spring Boot with auto-configuration support as well as other convention or configuration features to simplify the development of Spring applications using either Apache Geode or Pivotal GemFire in a Spring context.

This project builds on both Spring Data for Apache Geode and Spring Data for Pivotal GemFire as well as Spring Boot.

Project Goals

This project adds Spring Boot auto-configuration support for both Apache Geode and Pivotal GemFire.

Among other things, this project builds on Spring Boot as well as Spring Data for Apache Geode & Pivotal GemFire and additionally offers…​

  1. Auto-configures an Apache Geode or Pivotal GemFire (PCC) ClientCache instance automatically when either Spring Data for Apache Geode or Spring Data for Pivotal GemFire are on the application’s CLASSPATH.

  2. Auto-configures either Apache Geode or Pivotal GemFire (PCC) as a caching provider in Spring’s Cache Abstraction when either Spring Data for Apache Geode or Spring Data for Pivotal GemFire are on the application’s CLASSPATH.

  3. Auto-configures Spring Data for Apache Geode or Spring Data for Pivotal GemFire Repositories when Spring Data for Apache Geode or Spring Data for Pivotal GemFire are on the application’s CLASSPATH and Spring Boot detects SDG Repositories in your Spring Boot application.

  4. Provides additional support for Spring Boot/Spring Data for Apache Geode/Pivotal GemFire applications deployed to PCF using Pivotal Cloud Cache (PCC). Additionally, if your application requires (HTTP) Session State Caching services, you can also take advantage of Spring Session for Apache Geode/Pivotal GemFire.

This, along with many other benefits, are provided by this project.

Documentation

Table 1. Example Apache Geode Applications using Spring Boot
Version Reference Documentation Javadoc Samples

current

Ref Docs

Javadoc

Samples

1.0.1.RELEASE

Ref Docs

Javadoc

Samples

1.0.2.BUILD-SNAPSHOT

Ref Docs

Javadoc

Samples

1.1.6.RELEASE

Ref Docs

Javadoc

Samples

1.1.7.BUILD-SNAPSHOT

Ref Docs

Javadoc

Samples

1.2.5.RELEASE

Ref Docs

Javadoc

Samples

1.2.6.BUILD-SNAPSHOT

Ref Docs

Javadoc

Samples

1.3.0.M2

Ref Docs

Javadoc

Samples

1.3.0.BUILD-SNAPSHOT

Ref Docs

Javadoc

Samples

Examples

The single, most relevant "source of truth" on how to get started quickly and effectively, using Spring Boot for Apache Geode & Pivotal GemFire (SBDG) to solve problems, is to start with the Samples. There, you will find different examples with documentation and code showing you how to use SBDG to appropriately handle specific application concerns, like Caching.

You can find an example of using SBDG in the Pivotal Cloud Cache (PCC) Pizza Store GitHub repository, which is a Spring Boot, Pivotal GemFire ClientCache application that connects to PCC when the app is deployed to PCF.

The boot-example found in the Contacts Application Reference Implementation for Spring Data for Apache Geode & Pivotal GemFire (SDG) uses SBDG to manage Books in a System of Record Use Case.

Then, there is a series of examples that walks a user through a series of steps starting by building a simple, Spring Boot client application using the Apache Geode API only. Next, the app is rebuilt using Spring Data for Apache Geode (SDG) to show the simplifications that SDG affords you as a developer. Finally, the app is rebuilt once more using SBDG to demonstrate the power of Apache Geode when combined with Spring Boot. The example can be found in the PCCDemo GitHub repository. Each app can be deployed to PCF and bound to a Pivotal Cloud Cache service instance. With SBDG, little to no code or configuration changes are necessary to run the app locally and then later deploy the same app to a managed environment like PCF. It just works!

Finally, the Temperature Service example is an Internet of Things (IoT) and Event Stream Processing (ESP) Use Case that manages Temperature Sensors and Monitors and uses SBDG to make the application configuration and implementation as simple as can be.

Overtime, we will be adding even more relevant and practical examples, so please keep checking back.

Spring Boot Project Site

You can find the documentation, issue management, support, samples, and guides for using Spring Boot at https://projects.spring.io/spring-boot/

Code of Conduct

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to spring-code-of-conduct@pivotal.io.

License

Spring Boot, Spring Boot for Apache Geode and Spring Boot for Pivotal GemFire is Open Source Software released under the Apache 2.0 license.

About

Spring Boot Support for Apache Geode and Pivotal GemFire

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.8%
  • Other 0.2%