Merge branch 'release/0.1'

Author: mohamed-taman

.gitignore

@@ -53,3 +53,6 @@ build/
 
 ### VS Code ###
 .vscode/
+
+## Drawio source files ##
+*.drawio

.mvn/wrapper/MavenWrapperDownloader.java

@@ -0,0 +1,117 @@
+/*
+ * Copyright 2007-present 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.
+ */
+import java.net.*;
+import java.io.*;
+import java.nio.channels.*;
+import java.util.Properties;
+
+public class MavenWrapperDownloader {
+
+    private static final String WRAPPER_VERSION = "0.5.6";
+    /**
+     * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
+     */
+    private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"
+        + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";
+
+    /**
+     * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to
+     * use instead of the default one.
+     */
+    private static final String MAVEN_WRAPPER_PROPERTIES_PATH =
+            ".mvn/wrapper/maven-wrapper.properties";
+
+    /**
+     * Path where the maven-wrapper.jar will be saved to.
+     */
+    private static final String MAVEN_WRAPPER_JAR_PATH =
+            ".mvn/wrapper/maven-wrapper.jar";
+
+    /**
+     * Name of the property which should be used to override the default download url for the wrapper.
+     */
+    private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";
+
+    public static void main(String args[]) {
+        System.out.println("- Downloader started");
+        File baseDirectory = new File(args[0]);
+        System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());
+
+        // If the maven-wrapper.properties exists, read it and check if it contains a custom
+        // wrapperUrl parameter.
+        File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);
+        String url = DEFAULT_DOWNLOAD_URL;
+        if(mavenWrapperPropertyFile.exists()) {
+            FileInputStream mavenWrapperPropertyFileInputStream = null;
+            try {
+                mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);
+                Properties mavenWrapperProperties = new Properties();
+                mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);
+                url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);
+            } catch (IOException e) {
+                System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");
+            } finally {
+                try {
+                    if(mavenWrapperPropertyFileInputStream != null) {
+                        mavenWrapperPropertyFileInputStream.close();
+                    }
+                } catch (IOException e) {
+                    // Ignore ...
+                }
+            }
+        }
+        System.out.println("- Downloading from: " + url);
+
+        File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);
+        if(!outputFile.getParentFile().exists()) {
+            if(!outputFile.getParentFile().mkdirs()) {
+                System.out.println(
+                        "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");
+            }
+        }
+        System.out.println("- Downloading to: " + outputFile.getAbsolutePath());
+        try {
+            downloadFileFromURL(url, outputFile);
+            System.out.println("Done");
+            System.exit(0);
+        } catch (Throwable e) {
+            System.out.println("- Error downloading");
+            e.printStackTrace();
+            System.exit(1);
+        }
+    }
+
+    private static void downloadFileFromURL(String urlString, File destination) throws Exception {
+        if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {
+            String username = System.getenv("MVNW_USERNAME");
+            char[] password = System.getenv("MVNW_PASSWORD").toCharArray();
+            Authenticator.setDefault(new Authenticator() {
+                @Override
+                protected PasswordAuthentication getPasswordAuthentication() {
+                    return new PasswordAuthentication(username, password);
+                }
+            });
+        }
+        URL website = new URL(urlString);
+        ReadableByteChannel rbc;
+        rbc = Channels.newChannel(website.openStream());
+        FileOutputStream fos = new FileOutputStream(destination);
+        fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
+        fos.close();
+        rbc.close();
+    }
+
+}

.mvn/wrapper/maven-wrapper.jar

@@ -0,0 +1,2 @@
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar

.mvn/wrapper/maven-wrapper.properties

@@ -1,2 +1,225 @@
-# Springy Store Microservices
-This project is a development of a small set of Microservices spring boot based projects, that implement cloud-native recommendations to show how Microservices should be built, using the following cutting edge technologies like Docker, Kubernetes, Elasticsearch Stack, Java SE 14, MySQL database, MongoDB, and Reactive Programming, with many more.
+# Springy Store μServices
+
+- This project is a development of a small set of Spring Boot based Microservices projects, that implement cloud-native intuitive, design patterns and coding best practices.
+- The project follows [**CloudNative**](https://www.cncf.io/) recommendations and The [**twelve-factor app**](https://12factor.net/) methodology for building *software-as-a-service apps* to show how μServices should be built and deployed.
+- The project is using cutting edge technologies like Docker, Kubernetes, Elasticsearch Stack for logging and monitoring, Java SE 14, MySQL database, MongoDB, TDD, unit, integration & performance testing and Reactive Programming, and many more.
+
+------
+
+I am developing this project as stages, and all such stages are documented under project **Springy Store μServices** [wiki page](https://github.com/mohamed-taman/Springy-Store-Microservices/wiki). each such stage will be a release so you can go back and forward between releases to see the differences and how adding things solve specific problems we face.
+
+For example; in the first stage (1st release) I just created project structure, basic services skeleton, integration between them, and finally write integration testing as well as semi-automated testing for the whole services functionality.
+
+At 1st stage the **recommendation** and **review** microservices generate local in-memory data and **product composite service** calls the other three services (*product*, *recommendation*, and *review*) statically to generate client aggregate response for a specific product. Therefore in: 
+
+- The second stage I will introduce **database integration**, then in 
+- The third stage I will introduce **Dockerization** of our services and **docker-compose**, and in 
+- The fourth stage I will introduce **service discovery**, and so on.
+
+## Getting started
+
+The first stage aka (**Release v1.0**) is about creating and implementing a set of project Microservices.
+
+### Creating a Set of Cooperating Microservices
+
+The following topics are covered in this 1st stage (other stages topics will be documented in a project wiki):
+
+- Introducing the microservice landscape.
+- Generating skeleton microservices.
+- Adding RESTful APIs.
+- Adding a **product composite**, **product**, **recommendation**, and **review** microservices.
+- Adding error handling.
+- Testing the APIs manually.
+- Adding automated tests of microservices in isolation.
+- Adding semi-automated tests to a microservice landscape.
+
+### System Boundary - μServices Landscape
+
+![System Boundary](docs/stage1/Springy%20Store%20Application%20MS%20Landscape.png)
+
+### Required software
+
+The following software pieces are initially required:
+
+1. **Git**: it can be downloaded and installed from https://git-scm.com/downloads.
+
+2. **Java 14**: it can be downloaded and installed from https://www.oracle.com/technetwork/java/javase/downloads/index.html.
+
+3. **curl**: this command-line tool for testing HTTP-based APIs can be downloaded and installed from https://curl.haxx.se/download.html.
+
+4. **jq**: This command-line JSON processor can be downloaded and installed from https://stedolan.github.io/jq/download/.
+
+5. Spring Boot Initializer: This *Initializer* generates *spring* boot project with just what you need to start quickly! start from here https://start.spring.io/.
+
+   > For each future stage, I will list the newly required software. 
+
+Follow the installation guide for each software website and check your software versions from the command line to verify that they are installed correctly.
+
+## Using an IDE
+
+I recommend that you work with your Java code using an IDE that supports the development of Spring Boot applications such as Spring Tool Suite or IntelliJ IDEA Ultimate Edition. So you can use the Spring Boot Dashboard to run the services, run each microservice test case and many more.
+
+All that you want to do is just fire up your IDE **->** open or import the parent folder `springy-store-microservices` and everything will be ready for you.
+
+## Playing With Spring Store Project
+
+### Cloning It
+
+First open **git bash** command line, then simply you can clone the project under any of your favorite places as the following:
+
+```bash
+> git clone https://github.com/mohamed-taman/Springy-Store-Microservices.git
+```
+
+### Build & Test Them In Isolation
+
+To build and run test cases for each service & shared modules in the project we need to do the following:
+
+#### First: Build & Install Shared Dependencies
+
+> This is done for the first time only or any new version of shared modules..
+
+To build and install `store-utils`, `store-api`, `store-chassis`  libraries, from the root folder `springy-store-microservices` run the following commands:
+
+```bash
+mohamed.taman@DTLNV8 ~/springy-store-microservices 
+λ ./setup.sh
+```
+
+and you should expect output like this:
+
+```bash
+mohamed.taman@DTLNV8 ~/Springy Store Microservices 
+λ ./setup.sh
+
+Installing all Springy store core shared modules
+................................................
+
+1- Installing shared [Utilities] module...
+Done successfully.
+
+2- Installing shared [APIs] module...
+Done successfully.
+
+3- Installing [parent project] module...
+Done successfully.
+
+Wooohooo, building & installing all project modules are finished successfully.
+and the project is ready for the next step. :)
+```
+
+#### Second: Build & Test Microservices
+
+Now it is time to build our **4 microservices** and run each service integration test in isolation by running the following commands:
+
+```bash
+mohamed.taman@DTLNV8 ~/springy-store-microservices 
+λ cd store-chassis
+mohamed.taman@DTLNV8 ~/springy-store-microservices/store-chassis
+λ mvn clean verify
+```
+
+All build commands and test suite for each microservice should run successfully and the final output should be like this:
+
+```bash
+[INFO] ------------------------------------------------------------------------
+[INFO] Reactor Summary:
+[INFO]
+[INFO] Springy Store APIs 1.0-SNAPSHOT .................... SUCCESS [  3.048 s]
+[INFO] Springy Store Utils 1.0-SNAPSHOT ................... SUCCESS [  2.107 s]
+[INFO] Springy Store Chassis 0.0.1-SNAPSHOT ............... SUCCESS [  0.865 s]
+[INFO] Product Composite Service 0.0.1-SNAPSHOT ........... SUCCESS [ 11.086 s]
+[INFO] Product Service 0.0.1-SNAPSHOT ..................... SUCCESS [  9.795 s]
+[INFO] Review Service 0.0.1-SNAPSHOT ...................... SUCCESS [  9.214 s]
+[INFO] Recommendation Service 0.0.1-SNAPSHOT .............. SUCCESS [  9.288 s]
+[INFO] ------------------------------------------------------------------------
+[INFO] BUILD SUCCESS
+[INFO] ------------------------------------------------------------------------
+[INFO] Total time:  46.006 s
+[INFO] Finished at: 2020-04-01T17:07:52+02:00
+[INFO] ------------------------------------------------------------------------
+```
+
+### Running Them
+
+Now it is time to run all of them, and it is very simple just run the following two commands:
+
+```bash
+mohamed.taman@DTLNV8 ~/springy-store-microservices/store-chassis
+λ cd ..
+mohamed.taman@DTLNV8 ~/springy-store-microservices 
+λ ./run-em-all.sh
+```
+
+All the services will run in parallel and their output will be printed to the console. 
+
+### Testing Them All
+
+Now it is time to test all functionality of the application as one part. and to do so just run the following automation test script:
+
+```bash
+mohamed.taman@DTLNV8 ~/springy-store-microservices 
+λ ./test-em-all.sh
+```
+
+The result should be something like this:
+
+```bash
+Starting [Springy Store] full functionality testing....
+
+HOST=localhost
+PORT=9080
+Test OK (HTTP Code: 200)
+Test OK (actual value: 1)
+Test OK (actual value: 3)
+Test OK (actual value: 3)
+Test OK (HTTP Code: 404, {"httpStatus":"NOT_FOUND","message":"No product found for productId: 13","path":"/product-composite/13","time":"2020-04-01@14:51:48.812+0200"})
+Test OK (HTTP Code: 200)
+Test OK (actual value: 113)
+Test OK (actual value: 0)
+Test OK (actual value: 3)
+Test OK (HTTP Code: 200)
+Test OK (actual value: 213)
+Test OK (actual value: 3)
+Test OK (actual value: 0)
+Test OK (HTTP Code: 422, {"httpStatus":"UNPROCESSABLE_ENTITY","message":"Invalid productId: -1","path":"/product-composite/-1","time":"2020-04-01@14:51:49.763+0200"})
+Test OK (actual value: "Invalid productId: -1")
+Test OK (HTTP Code: 400, {"timestamp":"2020-04-01T12:51:49.965+0000","path":"/product-composite/invalidProductId","status":400,"error":"Bad Request","message":"Type mismatch."})
+Test OK (actual value: "Type mismatch.")
+```
+
+### Closing The Story
+
+And to close the story, we will need to shutdown Microservices manually service by service, hahaha just kidding, run the following script to shutdown them all:
+
+```bash
+mohamed.taman@DTLNV8 ~/springy-store-microservices 
+λ ./stop-em-all.sh
+```
+
+ and the output should be as the following:
+
+```bash
+Stopping [Springy Store] μServices ....
+---------------------------------------
+
+Stopping Microservice at port 9080 ....
+{"message":"Shutting down, bye..."}
+Microservice at port 9080 stopped successfully ....
+
+Stopping Microservice at port 9081 ....
+{"message":"Shutting down, bye..."}
+Microservice at port 9081 stopped successfully ....
+
+Stopping Microservice at port 9082 ....
+{"message":"Shutting down, bye..."}
+Microservice at port 9082 stopped successfully ....
+
+Stopping Microservice at port 9083 ....
+{"message":"Shutting down, bye..."}
+Microservice at port 9083 stopped successfully ....
+```
+
+### The End
+
+Happy coding :)

README.md

@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2020-04-01T16:42:39.773Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/12.9.3 Chrome/80.0.3987.158 Electron/8.2.0 Safari/537.36" etag="fDBcLv3HnAtoRhQ4TFjc" version="12.9.3" type="device"><diagram id="_t4D4tSkYDaTQ3sDm7r4" name="Page-1">7VpZk6M2EP41fvQUh8H249ieTVI1W7W1diXZfZOhObICESF85NdHAmHAgA3seDxJ2fMwqLt19PV1I3ukL4PDLxRF3mdiAx5pin0Y6auRpqmKNuH/BOWYUYy5lhFc6ttSqCCs/X8gnympiW9DXBFkhGDmR1WiRcIQLFahIUrJvirmEFzdNUIu1AhrC+E69Q/fZp6kqua8YPwKvuvJrWfaNGMEKBeWmsQessm+RNJfRvqSEsKyp+CwBCyMl9slm/ephXs6GIWQdZnAQjc8qGOydTYINr99M8zvX8czeTZ2zBUGm+svh4Qyj7gkRPiloC4oSUIbxKoKHxUyr4REnKhy4l/A2FE6EyWMcJLHAiy52Z5io1ZVJCkmCbXgwvnzkEDUBXZBzjgZnEcqkAAYPfJ5FDBi/q56DiRDxj3JFVblD9KwPYysqvewMrclPf4p5j8Z+fCbXC4drA6V0VGO7uCd6V29oz28c9E75l29k627QziRO400E/PjLhzCFS67zfw7ITljHKeGf+YC6jQ6FEz+5Ir/XyixE0sssCRBRGKfQb4wP2e2diaZk7f0nCJPYBFMaOUEI01X+Gc+r+9bnVulxREKO2lkCI2yaFBS3l5WIMENCQ0QbtjZWJQ0zPbquP/e4+YZc7YlTxBRGO95wR9wir7eM5q8N1q+jBbLKw7rq+UgK5f5Dgp8fMz4fFkURFks6BOBERGk26IwrvFS+WXTLAsDov2neYB3wHwLiZNCAsOmdp6DqJ/6ukVeHH4cA/Wdk70uRNS5r9dAd74FV7zaEgP9wqx/Sq2ux2CVfFZpijqi5nm2zoyySq1RqRmOj/HyBDa6jWDmWCKiGSU/oMQxrRlsHallXsjUfJyVJNU4nWcHlMHhcj2p47+cMMk7ddngq6Yc74t2WVONjOaVOuVc7s1LhtFaMjqnfmPJOBWCnPAVdj7sS67eNri/KVi39Odjcqoo7dl0DX0HYWDvXQbVR6PjIR9gewuwzQrrFcjtgnrVsH9f1HsDVDPNKqrpyr1RzXw/VLNIEEBo8+6ehA90e6DbA93+Z+imfjh0mw58ze+NGWXA6XxHcPVe4AF3D7h7wN1HhbvzV9T7w506/S/dOTffGrzNHbTe8RK6xcPvdAmt18rTEvtC2XMvxh6KxGMS4GeLiWBeiNDloIBf0RbwF3HTLNpqfbUljJGAC2DBWCDrh5t6uJQETvoprfGMfVfMZeQsr0jCsB/yBMq/BW3320+lkqFoT0Y1mfRaLunKe6bSvLV18NTGiiMMNfZK1VfTeWFsbAtmknGOrBuvKAzhNo66VON24O61dbe+qMtCA+7Q47yWKK8otGNLBHshKezdUiR4xLFqxFYRPyQhnJUHSUIy5DE4rCETAt+2U3RsKjxVxCynw0yOP8nGY/U7UBuF6Eb99WxSLzhGQ5bot8qS/EcI5SwxFutjzCDg5IUwFOL7GKsP67oGV5U9OpHjEnxODfF3G5dO8hJecqna5FLtZi7V2oFP6/yOILw7lo4ScGFxewAdADs1VBWxbHR94Wp/rxC9Wu0roYj6oSu8s+Y1VsDRcxRhHltnN1Y9vhUU8FWzWtSxflzUdHLp1q0zijeu8pzwHpBmEp+JhwKeMJqyQQHqYIVooLb3UpanfZx2TkJkpz4pvVR8M1ATBZwHHycYxWiTduDj1CpNaEY49jg4/fWXx1GPv88OQDizjnBm+qlD7Q0AT6u/M+lqA96pan/A48Pid3Apr/RrQv3lXw==</diagram></mxfile>