Merge branch 'master' into master

Author: sugan0tech

.all-contributorsrc

@@ -2641,7 +2641,107 @@
       "contributions": [
         "doc",
         "code"
-      ]      
+      ]
+    },
+    {
+      "login": "Upendra-Allagadda",
+      "name": "Allagadda Sai Upendranath",
+      "avatar_url": "https://avatars.githubusercontent.com/u/25962010?v=4",
+      "profile": "https://github.com/Upendra-Allagadda",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "mathbraga",
+      "name": "Matheus Braga",
+      "avatar_url": "https://avatars.githubusercontent.com/u/31048764?v=4",
+      "profile": "https://www.linkedin.com/in/mobraga/",
+      "contributions": [
+        "translation",
+        "doc"
+      ]
+    },
+    {
+      "login": "satyabarghav",
+      "name": "Appari Satya Barghav",
+      "avatar_url": "https://avatars.githubusercontent.com/u/36763910?v=4",
+      "profile": "https://github.com/satyabarghav",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "mribeirodantas",
+      "name": "Marcel Ribeiro-Dantas",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1023197?v=4",
+      "profile": "http://mribeirodantas.me",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "hamexhanif",
+      "name": "Muhammad Hanif Amrullah",
+      "avatar_url": "https://avatars.githubusercontent.com/u/74542852?v=4",
+      "profile": "https://github.com/hamexhanif",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "JackH408",
+      "name": "JackH408",
+      "avatar_url": "https://avatars.githubusercontent.com/u/141727294?v=4",
+      "profile": "https://github.com/JackH408",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "versus2004",
+      "name": "Shubham",
+      "avatar_url": "https://avatars.githubusercontent.com/u/132815243?v=4",
+      "profile": "https://github.com/versus2004",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "inishantjain",
+      "name": "Nishant Jain",
+      "avatar_url": "https://avatars.githubusercontent.com/u/121454072?v=4",
+      "profile": "https://github.com/inishantjain",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "hallowshaw",
+      "name": "Rhitam Chaudhury",
+      "avatar_url": "https://avatars.githubusercontent.com/u/90751158?v=4",
+      "profile": "https://github.com/hallowshaw",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "JerryZhao275",
+      "name": "JerryZhao275",
+      "avatar_url": "https://avatars.githubusercontent.com/u/132061401?v=4",
+      "profile": "https://github.com/JerryZhao275",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "leonardol",
+      "name": "Leonardo Lisanti",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1445890?v=4",
+      "profile": "https://twitter.com/llisant",
+      "contributions": [
+        "translation"
+      ]
     }
   ],
   "contributorsPerLine": 7,

README.md

@@ -1,4 +1,4 @@
-<!-- the line below needs to be an empty line C: (its because kramdown isnt
+<!-- the line below needs to be an empty line C: (its because kramdown isn't
      that smart and dearly wants an empty line before a heading to be able to
      display it as such, e.g. website) -->
 
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-289-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-301-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -448,6 +448,19 @@ This project is licensed under the terms of the MIT license.
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/sanchitbansal10"><img src="https://avatars.githubusercontent.com/u/16536741?v=4?s=100" width="100px;" alt="Sanchit Bansal"/><br /><sub><b>Sanchit Bansal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=sanchitbansal10" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/mm-saiful6854"><img src="https://avatars.githubusercontent.com/u/48361160?v=4?s=100" width="100px;" alt="Md Saiful Islam"/><br /><sub><b>Md Saiful Islam</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mm-saiful6854" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/AddeusExMachina"><img src="https://avatars.githubusercontent.com/u/39912670?v=4?s=100" width="100px;" alt="Antonio Addeo"/><br /><sub><b>Antonio Addeo</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=AddeusExMachina" title="Documentation">📖</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=AddeusExMachina" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Upendra-Allagadda"><img src="https://avatars.githubusercontent.com/u/25962010?v=4?s=100" width="100px;" alt="Allagadda Sai Upendranath"/><br /><sub><b>Allagadda Sai Upendranath</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Upendra-Allagadda" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/mobraga/"><img src="https://avatars.githubusercontent.com/u/31048764?v=4?s=100" width="100px;" alt="Matheus Braga"/><br /><sub><b>Matheus Braga</b></sub></a><br /><a href="#translation-mathbraga" title="Translation">🌍</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=mathbraga" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/satyabarghav"><img src="https://avatars.githubusercontent.com/u/36763910?v=4?s=100" width="100px;" alt="Appari Satya Barghav"/><br /><sub><b>Appari Satya Barghav</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=satyabarghav" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://mribeirodantas.me"><img src="https://avatars.githubusercontent.com/u/1023197?v=4?s=100" width="100px;" alt="Marcel Ribeiro-Dantas"/><br /><sub><b>Marcel Ribeiro-Dantas</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mribeirodantas" title="Documentation">📖</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/hamexhanif"><img src="https://avatars.githubusercontent.com/u/74542852?v=4?s=100" width="100px;" alt="Muhammad Hanif Amrullah"/><br /><sub><b>Muhammad Hanif Amrullah</b></sub></a><br /><a href="#translation-hamexhanif" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/JackH408"><img src="https://avatars.githubusercontent.com/u/141727294?v=4?s=100" width="100px;" alt="JackH408"/><br /><sub><b>JackH408</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=JackH408" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/versus2004"><img src="https://avatars.githubusercontent.com/u/132815243?v=4?s=100" width="100px;" alt="Shubham"/><br /><sub><b>Shubham</b></sub></a><br /><a href="#translation-versus2004" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/inishantjain"><img src="https://avatars.githubusercontent.com/u/121454072?v=4?s=100" width="100px;" alt="Nishant Jain"/><br /><sub><b>Nishant Jain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=inishantjain" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/hallowshaw"><img src="https://avatars.githubusercontent.com/u/90751158?v=4?s=100" width="100px;" alt="Rhitam Chaudhury"/><br /><sub><b>Rhitam Chaudhury</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hallowshaw" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/JerryZhao275"><img src="https://avatars.githubusercontent.com/u/132061401?v=4?s=100" width="100px;" alt="JerryZhao275"/><br /><sub><b>JerryZhao275</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=JerryZhao275" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://twitter.com/llisant"><img src="https://avatars.githubusercontent.com/u/1445890?v=4?s=100" width="100px;" alt="Leonardo Lisanti"/><br /><sub><b>Leonardo Lisanti</b></sub></a><br /><a href="#translation-leonardol" title="Translation">🌍</a></td>
     </tr>
   </tbody>
 </table>

adapter/README.md

@@ -107,6 +107,8 @@ Use the Adapter pattern when
 * [Dzone](https://dzone.com/articles/adapter-design-pattern-in-java)
 * [Refactoring Guru](https://refactoring.guru/design-patterns/adapter/java/example)
 * [Baeldung](https://www.baeldung.com/java-adapter-pattern)
+* [GeeksforGeeks](https://www.geeksforgeeks.org/adapter-pattern/)
+
 
 ## Consequences
 Class and object adapters have different trade-offs. A class adapter

adapter/pom.xml

@@ -4,7 +4,7 @@
     This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
 
     The MIT License
-    Copyright © 2014-2022 Ilkka Seppälä
+    Copyright © 2014-2023 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

aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java

@@ -34,7 +34,7 @@
 public class InformationController {
 
   /**
-   * Endpoint to retrieve a product's informations.
+   * Endpoint to retrieve a product's information.
    *
    * @return product inventory.
    */

caching/src/main/java/com/iluwatar/caching/database/DbManagerFactory.java

@@ -25,7 +25,7 @@
 package com.iluwatar.caching.database;
 
 /**
- * Creates the database connection accroding the input parameter.
+ * Creates the database connection according the input parameter.
  */
 public final class DbManagerFactory {
   /**

circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java

@@ -29,7 +29,7 @@
 /**
  * <p>
  * The intention of the Circuit Builder pattern is to handle remote failures robustly, which is to
- * mean that if a service is dependant on n number of other services, and m of them fail, we should
+ * mean that if a service is dependent on n number of other services, and m of them fail, we should
  * be able to recover from that failure by ensuring that the user can still use the services that
  * are actually functional, and resources are not tied up by uselessly by the services which are not
  * working. However, we should also be able to detect when any of the m failing services become

circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java

@@ -74,7 +74,7 @@ public String call() throws RemoteServiceException {
       }
     };
     var circuitBreaker = new DefaultCircuitBreaker(mockService, 1, 1, 100);
-    //Call with the paramater start_time set to huge amount of time in past so that service
+    //Call with the parameter start_time set to huge amount of time in past so that service
     //replies with "Ok". Also, state is CLOSED in start
     var serviceStartTime = System.nanoTime() - 60 * 1000 * 1000 * 1000;
     var response = circuitBreaker.attemptRequest();

commander/README.md

@@ -18,7 +18,7 @@ This pattern can be used when we need to make commits into 2 (or more) databases
 
 ## Explanation
 Handling distributed transactions can be tricky, but if we choose to not handle it carefully, there could be unwanted consequences. Say, we have an e-commerce website which has a Payment microservice and a Shipping microservice. If the shipping is available currently but payment service is not up, or vice versa, how would we deal with it after having already received the order from the user?
-We need a mechanism in place which can handle these kinds of situations. We have to direct the order to either one of the services (in this example, shipping) and then add the order into the database of the other service (in this example, payment), since two databses cannot be updated atomically. If currently unable to do it, there should be a queue where this request can be queued, and there has to be a mechanism which allows for a failure in the queueing as well. All this needs to be done by constant retries while ensuring idempotence (even if the request is made several times, the change should only be applied once) by a commander class, to reach a state of eventual consistency.
+We need a mechanism in place which can handle these kinds of situations. We have to direct the order to either one of the services (in this example, shipping) and then add the order into the database of the other service (in this example, payment), since two databases cannot be updated atomically. If currently unable to do it, there should be a queue where this request can be queued, and there has to be a mechanism which allows for a failure in the queueing as well. All this needs to be done by constant retries while ensuring idempotence (even if the request is made several times, the change should only be applied once) by a commander class, to reach a state of eventual consistency.
 
 ## Credits
 

crtp/README.md

@@ -134,5 +134,5 @@ Use the Curiously Recurring Template Pattern when
 
 ## Credits
 
-* [How do I decrypt "Enum<E extends Enum<E>>"?](http://www.angelikalanger.com/GenericsFAQ/FAQSections/TypeParameters.html#FAQ106)
+* [How do I decrypt "Enum<E extends Enum\<E>>"?](http://www.angelikalanger.com/GenericsFAQ/FAQSections/TypeParameters.html#FAQ106)
 * Chapter 5 Generics, Item 30 in [Effective Java](https://www.amazon.com/gp/product/0134685997/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0134685997&linkCode=as2&tag=javadesignpat-20&linkId=4e349f4b3ff8c50123f8147c828e53eb)