From 6677d1091d5a06d696cb0fd96d922e8db3f2cc73 Mon Sep 17 00:00:00 2001
From: protopapa <natassa.prt@gmail.com>
Date: Thu, 23 Jun 2016 22:54:44 +0200
Subject: [PATCH] implementation of microservices architectural pattern #296

---
 aggregator-microservices/README.md            |  29 ++++++
 .../aggregator-service/pom.xml                |  88 ++++++++++++++++++
 .../aggregator/microservices/Aggregator.java  |  58 ++++++++++++
 .../aggregator/microservices/App.java         |  39 ++++++++
 .../aggregator/microservices/Product.java     |  57 ++++++++++++
 .../ProductInformationClient.java             |  32 +++++++
 .../ProductInformationClientImpl.java         |  51 ++++++++++
 .../microservices/ProductInventoryClient.java |  31 ++++++
 .../ProductInventoryClientImpl.java           |  51 ++++++++++
 .../src/main/resources/application.properties |  24 +++++
 .../microservices/AggregatorTest.java         |  67 +++++++++++++
 .../etc/aggregator-microservice.png           | Bin 0 -> 41304 bytes
 .../information-microservice/pom.xml          |  79 ++++++++++++++++
 .../microservice/InformationApplication.java  |  37 ++++++++
 .../microservice/InformationController.java   |  41 ++++++++
 .../src/main/resources/application.properties |  24 +++++
 .../InformationControllerTest.java            |  39 ++++++++
 .../inventory-microservice/pom.xml            |  79 ++++++++++++++++
 .../microservice/InventoryApplication.java    |  38 ++++++++
 .../microservice/InventoryController.java     |  42 +++++++++
 .../src/main/resources/application.properties |  24 +++++
 .../microservice/InventoryControllerTest.java |  38 ++++++++
 aggregator-microservices/pom.xml              |  43 +++++++++
 pom.xml                                       |   1 +
 24 files changed, 1012 insertions(+)
 create mode 100644 aggregator-microservices/README.md
 create mode 100644 aggregator-microservices/aggregator-service/pom.xml
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
 create mode 100644 aggregator-microservices/aggregator-service/src/main/resources/application.properties
 create mode 100644 aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
 create mode 100644 aggregator-microservices/etc/aggregator-microservice.png
 create mode 100644 aggregator-microservices/information-microservice/pom.xml
 create mode 100644 aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java
 create mode 100644 aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
 create mode 100644 aggregator-microservices/information-microservice/src/main/resources/application.properties
 create mode 100644 aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
 create mode 100644 aggregator-microservices/inventory-microservice/pom.xml
 create mode 100644 aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java
 create mode 100644 aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
 create mode 100644 aggregator-microservices/inventory-microservice/src/main/resources/application.properties
 create mode 100644 aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
 create mode 100644 aggregator-microservices/pom.xml

diff --git a/aggregator-microservices/README.md b/aggregator-microservices/README.md
new file mode 100644
index 000000000..e65f26d9a
--- /dev/null
+++ b/aggregator-microservices/README.md
@@ -0,0 +1,29 @@
+---
+layout: pattern
+title: Aggregator Microservices
+folder: aggregator-microservices
+permalink: /patterns/aggregator-microservices/
+categories: Architectural
+tags:
+- Java
+- Spring
+---
+
+## Intent
+
+The user makes a single call to the Aggregator, and the aggregator then calls each relevant microservice and collects
+the data, apply business logic to it, and further publish is as a REST Endpoint.
+More variations of the aggregator are: 
+- Proxy Microservice Design Pattern: A different microservice is called upon the business need. 
+- Chained Microservice Design Pattern: In this case each microservice is dependent/ chained to a series 
+of other microservices.
+
+![alt text](./etc/aggregator-microservice.png "Aggregator Microservice")
+
+## Applicability
+
+Use the Aggregator Microservices pattern when you need a unified API for various microservices, regardless the client device.
+
+## Credits
+
+* [Microservice Design Patterns](http://blog.arungupta.me/microservice-design-patterns/)
diff --git a/aggregator-microservices/aggregator-service/pom.xml b/aggregator-microservices/aggregator-service/pom.xml
new file mode 100644
index 000000000..5a3490559
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/pom.xml
@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright (c) 2014 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>aggregator-microservices</artifactId>
+        <groupId>com.iluwatar</groupId>
+        <version>1.12.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>aggregator-service</artifactId>
+    <packaging>jar</packaging>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-dependencies</artifactId>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-webmvc</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-core</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.apache.httpcomponents</groupId>
+            <artifactId>httpclient</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <version>${spring-boot.version}</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
\ No newline at end of file
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
new file mode 100644
index 000000000..639349db9
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
@@ -0,0 +1,58 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.annotation.Resource;
+
+/**
+ * The aggregator aggregates calls on various micro-services, collects
+ * data and further publishes them under a REST endpoint.
+ */
+@RestController
+public class Aggregator {
+
+
+  @Resource
+  private ProductInformationClient informationClient;
+
+  @Resource
+  private ProductInventoryClient inventoryClient;
+
+
+  /**
+   * Retrieves product data.
+   *
+   * @return a Product.
+   */
+  @RequestMapping("/product")
+  public Product getProduct() {
+    Product product = new Product();
+    product.setTitle(informationClient.getProductTitle());
+    product.setProductInventories(inventoryClient.getProductInventories());
+    return product;
+  }
+
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java
new file mode 100644
index 000000000..25bb9ee6f
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java
@@ -0,0 +1,39 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class App {
+
+  /**
+   * Program entry point
+   *
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    SpringApplication.run(App.class, args);
+  }
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
new file mode 100644
index 000000000..edf0c121d
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
@@ -0,0 +1,57 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+/**
+ * Encapsulates all the data for a Product that clients will request.
+ */
+public class Product {
+
+  /**
+   * The title of the product.
+   */
+  private String title;
+
+
+  /**
+   * The inventories of the product.
+   */
+  private int productInventories;
+
+  public String getTitle() {
+    return title;
+  }
+
+  public void setTitle(String title) {
+    this.title = title;
+  }
+
+  public int getProductInventories() {
+    return productInventories;
+  }
+
+  public void setProductInventories(int productInventories) {
+    this.productInventories = productInventories;
+  }
+
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java
new file mode 100644
index 000000000..863db4759
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java
@@ -0,0 +1,32 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+/**
+ * Interface for the Information micro-service.
+ */
+public interface ProductInformationClient {
+
+  String getProductTitle();
+
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
new file mode 100644
index 000000000..580875c12
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
@@ -0,0 +1,51 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+import org.apache.http.client.methods.CloseableHttpResponse;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.impl.client.CloseableHttpClient;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.util.EntityUtils;
+
+import java.io.IOException;
+
+/**
+ * An adapter to communicate with information micro-service.
+ */
+public class ProductInformationClientImpl implements ProductInformationClient {
+
+  @Override
+  public String getProductTitle() {
+    String response = null;
+    try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
+      HttpGet httpGet = new HttpGet("http://localhost:51515/information");
+      try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) {
+        response = EntityUtils.toString(httpResponse.getEntity());
+      }
+    } catch (IOException e) {
+      e.printStackTrace();
+    }
+    return response;
+  }
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java
new file mode 100644
index 000000000..22be900b3
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java
@@ -0,0 +1,31 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+/**
+ * Interface to Inventory micro-service.
+ */
+public interface ProductInventoryClient {
+
+  int getProductInventories();
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
new file mode 100644
index 000000000..e399fb836
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
@@ -0,0 +1,51 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+import org.apache.http.client.methods.CloseableHttpResponse;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.impl.client.CloseableHttpClient;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.util.EntityUtils;
+
+import java.io.IOException;
+
+/**
+ * An adapter to communicate with inventory micro-service.
+ */
+public class ProductInventoryClientImpl implements ProductInventoryClient {
+
+  @Override
+  public int getProductInventories() {
+    String response = "0";
+    try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
+      HttpGet httpGet = new HttpGet("http://localhost:51516/inventories");
+      try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) {
+        response = EntityUtils.toString(httpResponse.getEntity());
+      }
+    } catch (IOException e) {
+      e.printStackTrace();
+    }
+    return Integer.parseInt(response);
+  }
+}
diff --git a/aggregator-microservices/aggregator-service/src/main/resources/application.properties b/aggregator-microservices/aggregator-service/src/main/resources/application.properties
new file mode 100644
index 000000000..69f581712
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/main/resources/application.properties
@@ -0,0 +1,24 @@
+#
+# The MIT License
+# Copyright (c) 2014 Ilkka Seppälä
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+server.port=50004
\ No newline at end of file
diff --git a/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java b/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
new file mode 100644
index 000000000..95d36fe25
--- /dev/null
+++ b/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
@@ -0,0 +1,67 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.aggregator.microservices;
+
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+import static org.junit.Assert.assertEquals;
+import static org.mockito.Mockito.when;
+
+public class AggregatorTest {
+
+  @InjectMocks
+  private Aggregator aggregator;
+
+  @Mock
+  private ProductInformationClient informationClient;
+
+  @Mock
+  private ProductInventoryClient inventoryClient;
+
+  @Before
+  public void setup() {
+    MockitoAnnotations.initMocks(this);
+  }
+
+  /**
+   * Tests getting the data for a desktop client
+   */
+  @Test
+  public void testGetProduct() {
+    String title = "The Product Title.";
+    int inventories = 5;
+
+    when(informationClient.getProductTitle()).thenReturn(title);
+    when(inventoryClient.getProductInventories()).thenReturn(inventories);
+
+    Product testProduct = aggregator.getProduct();
+
+    assertEquals(title, testProduct.getTitle());
+    assertEquals(inventories, testProduct.getProductInventories());
+  }
+
+}
\ No newline at end of file
diff --git a/aggregator-microservices/etc/aggregator-microservice.png b/aggregator-microservices/etc/aggregator-microservice.png
new file mode 100644
index 0000000000000000000000000000000000000000..ad344a7e1e0fa72633fb06e53ae4ddc0a0695ae4
GIT binary patch
literal 41304
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
VO<=Ole#r-)vsQMN6&9Y6{|ESr0>A(O

literal 0
HcmV?d00001

diff --git a/aggregator-microservices/information-microservice/pom.xml b/aggregator-microservices/information-microservice/pom.xml
new file mode 100644
index 000000000..844c2a3d7
--- /dev/null
+++ b/aggregator-microservices/information-microservice/pom.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright (c) 2014 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>aggregator-microservices</artifactId>
+        <groupId>com.iluwatar</groupId>
+        <version>1.12.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>information-microservice</artifactId>
+    <packaging>jar</packaging>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-dependencies</artifactId>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-webmvc</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <version>${spring-boot.version}</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java
new file mode 100644
index 000000000..c93219c17
--- /dev/null
+++ b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java
@@ -0,0 +1,37 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.information.microservice;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * Inventory Application starts container (Spring Boot) and exposes the Inventory micro-service.
+ */
+@SpringBootApplication
+public class InformationApplication {
+
+  public static void main(String[] args) {
+    SpringApplication.run(InformationApplication.class, args);
+  }
+}
diff --git a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
new file mode 100644
index 000000000..37ec45c1b
--- /dev/null
+++ b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
@@ -0,0 +1,41 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.information.microservice;
+
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class InformationController {
+
+  /**
+   * Endpoint to retrieve a product's informations.
+   *
+   * @return product inventory.
+   */
+  @RequestMapping(value = "/information", method = RequestMethod.GET)
+  public String getProductTitle() {
+    return "The Product Title.";
+  }
+}
diff --git a/aggregator-microservices/information-microservice/src/main/resources/application.properties b/aggregator-microservices/information-microservice/src/main/resources/application.properties
new file mode 100644
index 000000000..3c8452f1f
--- /dev/null
+++ b/aggregator-microservices/information-microservice/src/main/resources/application.properties
@@ -0,0 +1,24 @@
+#
+# The MIT License
+# Copyright (c) 2014 Ilkka Seppälä
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+server.port=51515
\ No newline at end of file
diff --git a/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java b/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
new file mode 100644
index 000000000..9c3a6b98d
--- /dev/null
+++ b/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
@@ -0,0 +1,39 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.information.microservice;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+public class InformationControllerTest {
+
+  @Test
+  public void shouldGetProductTitle() {
+    InformationController infoController = new InformationController();
+
+    String title = infoController.getProductTitle();
+
+    Assert.assertEquals("The Product Title.", title);
+  }
+
+}
\ No newline at end of file
diff --git a/aggregator-microservices/inventory-microservice/pom.xml b/aggregator-microservices/inventory-microservice/pom.xml
new file mode 100644
index 000000000..9fee7db5b
--- /dev/null
+++ b/aggregator-microservices/inventory-microservice/pom.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright (c) 2014 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>aggregator-microservices</artifactId>
+        <groupId>com.iluwatar</groupId>
+        <version>1.12.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>inventory-microservice</artifactId>
+    <packaging>jar</packaging>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-dependencies</artifactId>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-webmvc</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <version>${spring-boot.version}</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>repackage</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
\ No newline at end of file
diff --git a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java
new file mode 100644
index 000000000..3e2cf9e60
--- /dev/null
+++ b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java
@@ -0,0 +1,38 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.inventory.microservice;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * Inventory Application starts container (Spring Boot) and exposes the Inventory micro-service.
+ */
+@SpringBootApplication
+public class InventoryApplication {
+
+  public static void main(String[] args) {
+    SpringApplication.run(InventoryApplication.class, args);
+  }
+
+}
diff --git a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
new file mode 100644
index 000000000..483e28bf3
--- /dev/null
+++ b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
@@ -0,0 +1,42 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.inventory.microservice;
+
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class InventoryController {
+
+  /**
+   * Endpoint to retrieve a product's inventories.
+   *
+   * @return product inventory.
+   */
+  @RequestMapping(value = "/inventories", method = RequestMethod.GET)
+  public int getProductInventories() {
+    return 5;
+  }
+
+}
diff --git a/aggregator-microservices/inventory-microservice/src/main/resources/application.properties b/aggregator-microservices/inventory-microservice/src/main/resources/application.properties
new file mode 100644
index 000000000..36f7589fc
--- /dev/null
+++ b/aggregator-microservices/inventory-microservice/src/main/resources/application.properties
@@ -0,0 +1,24 @@
+#
+# The MIT License
+# Copyright (c) 2014 Ilkka Seppälä
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+server.port=51516
\ No newline at end of file
diff --git a/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java b/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
new file mode 100644
index 000000000..787ec0e61
--- /dev/null
+++ b/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
@@ -0,0 +1,38 @@
+/**
+ * The MIT License
+ * Copyright (c) 2014 Ilkka Seppälä
+ * <p/>
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * <p/>
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * <p/>
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.iluwatar.inventory.microservice;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+public class InventoryControllerTest {
+
+  @Test
+  public void testGetProductInventories() throws Exception {
+    InventoryController inventoryController = new InventoryController();
+
+    int numberOfInventories = inventoryController.getProductInventories();
+
+    Assert.assertEquals(5, numberOfInventories);
+  }
+}
\ No newline at end of file
diff --git a/aggregator-microservices/pom.xml b/aggregator-microservices/pom.xml
new file mode 100644
index 000000000..d2f0a40dd
--- /dev/null
+++ b/aggregator-microservices/pom.xml
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright (c) 2014 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>java-design-patterns</artifactId>
+        <groupId>com.iluwatar</groupId>
+        <version>1.12.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>aggregator-microservices</artifactId>
+    <packaging>pom</packaging>
+
+    <modules>
+        <module>information-microservice</module>
+        <module>aggregator-service</module>
+        <module>inventory-microservice</module>
+    </modules>
+</project>
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 0e3318fb6..9469941f5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -126,6 +126,7 @@
 		<module>semaphore</module>
 		<module>hexagonal</module>
 		<module>abstract-document</module>
+		<module>aggregator-microservices</module>
 	</modules>
 
 	<dependencyManagement>
-- 
GitLab