#539 - Add spring-data-geode-examples module.

Author: Patrick Johnson

.gitignore

@@ -7,3 +7,7 @@ target/
 #IntelliJ Stuff
 .idea
 *.iml
+
+#Geode Stuff
+*.log
+*.dat

README.md

@@ -6,6 +6,17 @@ This repository contains example projects for the different Spring Data modules
 
 We have separate folders for the samples of individual modules:
 
+## Spring Data for Apache Geode
+
+* `events` - In this example the test will make use of event handlers and async event queue to handle events.
+* `expiration-eviction` - In these examples the server is configured to delete entries after a certain idle period or after a Time-To-Live period (expiration0 or remove data from memory when certain thresholds are reached (eviction).
+* `function-invocation` - In this example the server will have 3 functions registered. The client will invoke each of the functions.
+* `queries` - In this example a client will query the data in various ways using OQl, continuous queries, and Apache Lucene indexes.
+* `security` - In this example the servers and clients are set up with security (username/password) authentication using Geode Security and Apache Shiro.
+* `storage` - In this example the server is configured to store data off of hte JVM heap using the `@EnableOffHeap` annotation and to compress region data using SnappyCompressor`.
+* `transactions` - In this example the client will perform operations within a transaction. First, it will do a successful transaction where entries are saved to the server, and then a failed transaction where all changes are reverted.
+* `wan` - In these example two servers are deployed. One server populates itself with data, and the other server gets populated with that data via WAN replication.
+
 ## Spring Data JPA
 
 * `eclipselink` - Sample project to show how to use Spring Data JPA with Spring Boot and [Eclipselink](https://www.eclipse.org/eclipselink/).

geode/README.md

@@ -0,0 +1,22 @@
+Spring Data For GemFire and Apache Geode Examples
+=========================================================
+
+This project provides a number of examples to get you started using Spring Data for Apache Geode or Pivotal GemFire. These examples are designed to work with [Spring Data for Pivotal GemFire](http://projects.spring.io/spring-data-gemfire) 2.0.9-RELEASE or higher and are organized into the following sub projects:
+
+It is important to note that all examples will follow the prescribed Maven directory structure.
+
+Examples:
+
+* **events** - In this example the test will make use of event handlers and async event queue to handle events.
+* **expiration-eviction** - In these examples the server is configured to delete entries after a certain idle period or after a Time-To-Live period (expiration0 or remove data from memory when certain thresholds are reached (eviction).
+* **function-invocation** - In this example the server will have 3 functions registered. The client will invoke each of the functions.
+* **queries** - In this example a client will query the data in various ways using OQl, continuous queries, and Apache Lucene indexes.
+* **security** - In this example the servers and clients are set up with security (username/password) authentication using Geode Security and Apache Shiro.
+* **storage** - In this example the server is configured to store data off of hte JVM heap using the `@EnableOffHeap` annotation and to compress region data using SnappyCompressor`.
+* **transactions** - In this example the client will perform operations within a transaction. First, it will do a successful transaction where entries are saved to the server, and then a failed transaction where all changes are reverted.
+* **wan** - In these example two servers are deployed. One server populates itself with data, and the other server gets populated with that data via WAN replication.
+
+# Running The Examples
+
+Each example has at least one test file located in the test directory. The examples are driven by the tests, so simply run the test either through your IDE or via the commandline. 
+The logging level of the examples is set to "error", so there will be no output. To see output, simply find the `logback.xml` file located in src/test/resources and set the loglevel to "info".

geode/events/README.md

@@ -0,0 +1,5 @@
+# Events Example
+
+In this example you will how to handle events using Async event queue, Cache Listeners, Cache Loaders, and Cache Writers.
+    
+NOTE: Inorder to see output, you must change the loglevel from "error" to "info" in the `logback.xml` file located under src/test/resources.

geode/events/pom.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>example.springdata.geode</groupId>
+        <artifactId>spring-data-geode-examples</artifactId>
+        <version>1.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>events</artifactId>
+
+    <dependencies>
+
+    </dependencies>
+
+</project>

geode/events/src/main/java/example/springdata/geode/server/events/Address.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2020 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package example.springdata.geode.server.events;
+
+import lombok.Data;
+
+import java.io.Serializable;
+
+/**
+ * An address used in the examples.
+ *
+ * @author Oliver Gierke
+ * @author Udo Kohlmeyer
+ * @author Patrick Johnson
+ */
+@Data
+public class Address implements Serializable {
+	private String street;
+	private String city;
+	private String country;
+
+	public Address(String street, String city, String country) {
+		this.street = street;
+		this.city = city;
+		this.country = country;
+	}
+}

geode/events/src/main/java/example/springdata/geode/server/events/Customer.java

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2020 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package example.springdata.geode.server.events;
+
+import lombok.Data;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.gemfire.mapping.annotation.Region;
+
+import java.io.Serializable;
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * A customer used for Lucene examples.
+ *
+ * @author Udo Kohlmeyer
+ * @author Patrick Johnson
+ */
+@Data
+@Region(name = "Customers")
+public class Customer implements Serializable {
+
+	@Id
+	private Long id;
+	private EmailAddress emailAddress;
+	private String firstName;
+	private String lastName;
+	private List<Address> addresses;
+
+	public Customer(Long id, EmailAddress emailAddress, String firstName, String lastName, Address... addresses) {
+		this.id = id;
+		this.emailAddress = emailAddress;
+		this.firstName = firstName;
+		this.lastName = lastName;
+		this.addresses = Arrays.asList(addresses);
+	}
+}

geode/events/src/main/java/example/springdata/geode/server/events/CustomerCacheWriter.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright 2020 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package example.springdata.geode.server.events;
+
+import org.apache.geode.cache.CacheWriterException;
+import org.apache.geode.cache.EntryEvent;
+import org.apache.geode.cache.util.CacheWriterAdapter;
+import org.apache.geode.internal.cache.EntryEventImpl;
+import org.springframework.stereotype.Component;
+
+@Component
+public class CustomerCacheWriter extends CacheWriterAdapter<Long, Customer> {
+
+	@Override
+	public void beforeCreate(EntryEvent<Long, Customer> event) throws CacheWriterException {
+		EntryEventImpl e = (EntryEventImpl) event;
+		super.beforeCreate(e);
+	}
+}

geode/events/src/main/java/example/springdata/geode/server/events/CustomerRepository.java

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2020 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package example.springdata.geode.server.events;
+
+import org.springframework.data.repository.CrudRepository;
+
+public interface CustomerRepository extends CrudRepository<Customer, Long> {
+}

geode/events/src/main/java/example/springdata/geode/server/events/EmailAddress.java

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2020 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package example.springdata.geode.server.events;
+
+import lombok.Data;
+
+import java.io.Serializable;
+
+/**
+ * Value object to represent email addresses.
+ *
+ * @author Udo Kohlmeyer
+ * @author Patrick Johnson
+ */
+@Data
+public class EmailAddress implements Serializable {
+	private String value;
+
+	public EmailAddress(String value) {
+
+		this.value = value;
+	}
+}

geode/events/src/main/java/example/springdata/geode/server/events/EventServer.java

@@ -0,0 +1,96 @@
+/*
+ * Copyright 2020 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package example.springdata.geode.server.events;
+
+import org.apache.geode.cache.Region;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.boot.ApplicationRunner;
+import org.springframework.boot.WebApplicationType;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.builder.SpringApplicationBuilder;
+import org.springframework.context.annotation.Bean;
+
+import java.math.BigDecimal;
+import java.util.List;
+import java.util.Random;
+import java.util.stream.IntStream;
+import java.util.stream.LongStream;
+
+@SpringBootApplication(scanBasePackageClasses = EventServerConfig.class)
+public class EventServer {
+
+	private Logger logger = LoggerFactory.getLogger(this.getClass());
+
+	public static void main(String[] args) {
+		new SpringApplicationBuilder(EventServer.class)
+				.web(WebApplicationType.NONE)
+				.build()
+				.run(args);
+	}
+
+	@Bean
+	public ApplicationRunner runner(CustomerRepository customerRepository, OrderRepository orderRepository,
+									ProductRepository productRepository, OrderProductSummaryRepository orderProductSummaryRepository, @Qualifier("Products") Region<Long, Product> products) {
+		return args -> {
+			createCustomerData(customerRepository);
+
+			createProducts(productRepository);
+
+			createOrders(productRepository, orderRepository);
+
+			logger.info("Completed creating orders ");
+
+			final List<OrderProductSummary> allForProductID = orderProductSummaryRepository.findAllForProductID(3L);
+			allForProductID.forEach(orderProductSummary -> logger.info("orderProductSummary = " + orderProductSummary));
+		};
+	}
+
+	private void createOrders(ProductRepository productRepository, OrderRepository orderRepository) {
+		Random random = new Random(System.nanoTime());
+		Address address = new Address("it", "doesn't", "matter");
+		LongStream.rangeClosed(1, 10).forEach((orderId) ->
+				LongStream.rangeClosed(1, 300).forEach((customerId) -> {
+					Order order = new Order(orderId, customerId, address);
+					IntStream.rangeClosed(0, random.nextInt(3) + 1).forEach((lineItemCount) -> {
+						int quantity = random.nextInt(3) + 1;
+						long productId = random.nextInt(3) + 1;
+						order.add(new LineItem(productRepository.findById(productId).get(), quantity));
+					});
+					orderRepository.save(order);
+				}));
+	}
+
+	private void createProducts(ProductRepository productRepository) {
+		productRepository.save(new Product(1L, "Apple iPod", new BigDecimal("99.99"),
+				"An Apple portable music player"));
+		productRepository.save(new Product(2L, "Apple iPad", new BigDecimal("499.99"),
+				"An Apple tablet device"));
+		Product macbook = new Product(3L, "Apple macBook", new BigDecimal("899.99"),
+				"An Apple notebook computer");
+		macbook.addAttribute("warranty", "included");
+		productRepository.save(macbook);
+	}
+
+	private void createCustomerData(CustomerRepository customerRepository) {
+		LongStream.rangeClosed(0, 300)
+				.parallel()
+				.forEach(customerId ->
+						customerRepository.save(new Customer(customerId, new EmailAddress(customerId + "@2.com"), "John" + customerId, "Smith" + customerId)));
+	}
+}