Merge branch 'iluwatar:master' into master

Author: sugan0tech

Diff for: .all-contributorsrc

@@ -3222,6 +3222,78 @@
       "contributions": [
         "translation"
       ]
+    },
+    {
+      "login": "LakshyaPunyani-01",
+      "name": "LakshyaPunyani-01",
+      "avatar_url": "https://avatars.githubusercontent.com/u/103628913?v=4",
+      "profile": "https://github.com/LakshyaPunyani-01",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jasonjyu",
+      "name": "jasonjyu",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10333076?v=4",
+      "profile": "https://github.com/jasonjyu",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jeffmorrison",
+      "name": "jeffmorrison",
+      "avatar_url": "https://avatars.githubusercontent.com/u/26047158?v=4",
+      "profile": "https://github.com/jeffmorrison",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "dmgodoy",
+      "name": "David M.",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10840681?v=4",
+      "profile": "https://github.com/dmgodoy",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "apophizzz",
+      "name": "Patrick Kleindienst",
+      "avatar_url": "https://avatars.githubusercontent.com/u/12052783?v=4",
+      "profile": "https://github.com/apophizzz",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "proceane",
+      "name": "Juyeon",
+      "avatar_url": "https://avatars.githubusercontent.com/u/62143949?v=4",
+      "profile": "https://github.com/proceane",
+      "contributions": [
+        "translation"
+      ]
+    },
+    {
+      "login": "mammadyahyayev",
+      "name": "Mammad Yahyayev",
+      "avatar_url": "https://avatars.githubusercontent.com/u/66476643?v=4",
+      "profile": "https://mammadyahya.vercel.app",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "SalmaAzeem",
+      "name": "Salma",
+      "avatar_url": "https://avatars.githubusercontent.com/u/121863224?v=4",
+      "profile": "https://github.com/SalmaAzeem",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 6,

Diff for: README.md

@@ -6,7 +6,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-353-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-361-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -530,6 +530,18 @@ This project is licensed under the terms of the MIT license.
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/vvanghelle"><img src="https://avatars.githubusercontent.com/u/3204600?v=4?s=100" width="100px;" alt="Vincent Vanghelle"/><br /><sub><b>Vincent Vanghelle</b></sub></a><br /><a href="#translation-vvanghelle" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/antoheri"><img src="https://avatars.githubusercontent.com/u/79988396?v=4?s=100" width="100px;" alt="Antoine Héritier"/><br /><sub><b>Antoine Héritier</b></sub></a><br /><a href="#translation-antoheri" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="16.66%"><a href="https://github.com/fishandsheep"><img src="https://avatars.githubusercontent.com/u/43347407?v=4?s=100" width="100px;" alt="QinShower"/><br /><sub><b>QinShower</b></sub></a><br /><a href="#translation-fishandsheep" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/LakshyaPunyani-01"><img src="https://avatars.githubusercontent.com/u/103628913?v=4?s=100" width="100px;" alt="LakshyaPunyani-01"/><br /><sub><b>LakshyaPunyani-01</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=LakshyaPunyani-01" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/jasonjyu"><img src="https://avatars.githubusercontent.com/u/10333076?v=4?s=100" width="100px;" alt="jasonjyu"/><br /><sub><b>jasonjyu</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jasonjyu" title="Code">💻</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/jeffmorrison"><img src="https://avatars.githubusercontent.com/u/26047158?v=4?s=100" width="100px;" alt="jeffmorrison"/><br /><sub><b>jeffmorrison</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jeffmorrison" title="Code">💻</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/dmgodoy"><img src="https://avatars.githubusercontent.com/u/10840681?v=4?s=100" width="100px;" alt="David M."/><br /><sub><b>David M.</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dmgodoy" title="Code">💻</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/apophizzz"><img src="https://avatars.githubusercontent.com/u/12052783?v=4?s=100" width="100px;" alt="Patrick Kleindienst"/><br /><sub><b>Patrick Kleindienst</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=apophizzz" title="Code">💻</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/proceane"><img src="https://avatars.githubusercontent.com/u/62143949?v=4?s=100" width="100px;" alt="Juyeon"/><br /><sub><b>Juyeon</b></sub></a><br /><a href="#translation-proceane" title="Translation">🌍</a></td>
+      <td align="center" valign="top" width="16.66%"><a href="https://mammadyahya.vercel.app"><img src="https://avatars.githubusercontent.com/u/66476643?v=4?s=100" width="100px;" alt="Mammad Yahyayev"/><br /><sub><b>Mammad Yahyayev</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mammadyahyayev" title="Documentation">📖</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="16.66%"><a href="https://github.com/SalmaAzeem"><img src="https://avatars.githubusercontent.com/u/121863224?v=4?s=100" width="100px;" alt="Salma"/><br /><sub><b>Salma</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=SalmaAzeem" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

Diff for: abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java

@@ -114,12 +114,16 @@ void shouldUpdateExistingValue() {
     final String originalValue = "originalValue";
     final String updatedValue = "updatedValue";
 
+    // Initializing the value
     document.put(key, originalValue);
 
+    // Verifying that the initial value is retrieved correctly
+    assertEquals(originalValue, document.get(key));
+
     // Updating the value
     document.put(key, updatedValue);
 
-    //Verifying that the updated value is retrieved correctly
+    // Verifying that the updated value is retrieved correctly
     assertEquals(updatedValue, document.get(key));
   }
 }

Diff for: bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java

@@ -67,59 +67,60 @@ public void execute(int[] bytecode) {
     for (var i = 0; i < bytecode.length; i++) {
       Instruction instruction = Instruction.getInstruction(bytecode[i]);
       switch (instruction) {
-        case LITERAL:
-          // Read the next byte from the bytecode.
+        case LITERAL -> { // Read the next byte from the bytecode.
           int value = bytecode[++i];
           // Push the next value to stack
           stack.push(value);
-          break;
-        case SET_AGILITY:
+        }
+        case SET_AGILITY -> {
           var amount = stack.pop();
           var wizard = stack.pop();
           setAgility(wizard, amount);
-          break;
-        case SET_WISDOM:
-          amount = stack.pop();
-          wizard = stack.pop();
+        }
+        case SET_WISDOM -> {
+          var amount = stack.pop();
+          var wizard = stack.pop();
           setWisdom(wizard, amount);
-          break;
-        case SET_HEALTH:
-          amount = stack.pop();
-          wizard = stack.pop();
+        }
+        case SET_HEALTH -> {
+          var amount = stack.pop();
+          var wizard = stack.pop();
           setHealth(wizard, amount);
-          break;
-        case GET_HEALTH:
-          wizard = stack.pop();
+        }
+        case GET_HEALTH -> {
+          var wizard = stack.pop();
           stack.push(getHealth(wizard));
-          break;
-        case GET_AGILITY:
-          wizard = stack.pop();
+        }
+        case GET_AGILITY -> {
+          var wizard = stack.pop();
           stack.push(getAgility(wizard));
-          break;
-        case GET_WISDOM:
-          wizard = stack.pop();
+        }
+        case GET_WISDOM -> {
+          var wizard = stack.pop();
           stack.push(getWisdom(wizard));
-          break;
-        case ADD:
+        }
+        case ADD -> {
           var a = stack.pop();
           var b = stack.pop();
           stack.push(a + b);
-          break;
-        case DIVIDE:
-          a = stack.pop();
-          b = stack.pop();
+        }
+        case DIVIDE -> {
+          var a = stack.pop();
+          var b = stack.pop();
           stack.push(b / a);
-          break;
-        case PLAY_SOUND:
-          wizard = stack.pop();
+        }
+        case PLAY_SOUND -> {
+          var wizard = stack.pop();
           getWizards()[wizard].playSound();
-          break;
-        case SPAWN_PARTICLES:
-          wizard = stack.pop();
+
+        }
+        case SPAWN_PARTICLES -> {
+          var wizard = stack.pop();
           getWizards()[wizard].spawnParticles();
-          break;
-        default:
+        }
+        default -> {
           throw new IllegalArgumentException("Invalid instruction value");
+        }
       }
       LOGGER.info("Executed " + instruction.name() + ", Stack contains " + getStack());
     }

Diff for: composite-view/web/header.jsp

@@ -39,11 +39,30 @@
         h1 { text-align: center;}
         h2 { text-align: center;}
         h3 { text-align: center;}
+        nav {
+            text-align: center;
+            margin-bottom: 20px;
+        }
+        .home-link {
+            padding: 10px 20px;
+            background-color: #007bff;
+            color: white;
+            text-decoration: none;
+            border-radius: 5px;
+        }
+        .home-link:hover {
+            background-color: #0056b3;
+        }
     </style>
 </head>
 <body>
+    <nav>
+        <!-- Add a Home button that links back to the homepage -->
+        <a href="/" class="home-link">Home</a>
+    </nav>
+
     <% String todayDateStr = (new Date().toString()); %>
     <h1>Today's Personalized Frontpage</h1>
-    <h2><%=todayDateStr%></h2>
+    <h2><%= todayDateStr %></h2>
 </body>
 </html>

Diff for: dynamic-proxy/pom.xml

@@ -38,7 +38,7 @@
     <dependency>
         <groupId>com.fasterxml.jackson.core</groupId>
         <artifactId>jackson-core</artifactId>
-        <version>2.17.2</version>
+        <version>2.18.1</version>
     </dependency>
     <dependency>
       <groupId>com.fasterxml.jackson.core</groupId>

Diff for: event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java

@@ -43,5 +43,7 @@ public void onEvent(Event e) {
 
   @Override
   public void timePasses(Weekday day) {
+    // This method is intentionally left empty because KingsHand does not handle time-based events directly.
+    // It serves as a placeholder to fulfill the EventObserver interface contract.
   }
 }

Diff for: event-sourcing/pom.xml

@@ -42,7 +42,7 @@
     <dependency>
         <groupId>com.fasterxml.jackson.core</groupId>
         <artifactId>jackson-core</artifactId>
-        <version>2.17.2</version>
+        <version>2.18.1</version>
     </dependency>
     <dependency>
       <groupId>com.fasterxml.jackson.core</groupId>

Diff for: filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java

@@ -30,7 +30,7 @@
 /**
  * Represents system that is aware of threats that are present in it.
  */
-public interface ThreatAwareSystem {
+public interface ThreatAwareSystem<T extends Threat> {
 
   /**
    * Returns the system id.
@@ -43,13 +43,13 @@ public interface ThreatAwareSystem {
    * Returns list of threats for this system.
    * @return list of threats for this system.
    */
-  List<? extends Threat> threats();
+  List<T> threats();
 
   /**
    * Returns the instance of {@link Filterer} helper interface that allows to covariantly
    * specify lower bound for predicate that we want to filter by.
    * @return an instance of {@link Filterer} helper interface.
    */
-  Filterer<? extends ThreatAwareSystem, ? extends Threat> filtered();
+  Filterer<ThreatAwareSystem<T>, T> filtered();
 
 }

Diff for: game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java

@@ -24,10 +24,9 @@
  */
 package com.iluwatar.gameloop;
 
-import static org.junit.jupiter.api.Assertions.assertFalse;
-
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.Assertions;
+import static org.junit.jupiter.api.Assertions.assertFalse;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
@@ -46,6 +45,7 @@ void setup() {
     gameLoop = new GameLoop() {
       @Override
       protected void processGameLoop() {
+        throw new UnsupportedOperationException("Not supported yet.");
       }
     };
   }

Diff for: hexagonal-architecture/pom.xml

@@ -46,7 +46,7 @@
     <dependency>
       <groupId>de.flapdoodle.embed</groupId>
       <artifactId>de.flapdoodle.embed.mongo</artifactId>
-      <version>4.17.0</version>
+      <version>4.18.0</version>
       <scope>test</scope>
     </dependency>
     <dependency>