Merge branch 'iluwatar:master' into master

extension-objects/README.md

@@ -1,18 +1,24 @@
 ---
-title: Extension objects
-category: Behavioral
+title: Extension Objects
+category: Structural
 language: en
 tag:
- - Extensibility
+    - Encapsulation
+    - Extensibility
+    - Object composition
+    - Polymorphism
 ---
 
-# Extention Objects Pattern
+## Also known as
+
+* Interface Extensions
 
 ## Intent
-Anticipate that an object’s interface needs to be extended in the future. Additional
-interfaces are defined by extension objects.
+
+The Extension Objects pattern allows for the flexible extension of an object's behavior without modifying its structure, by attaching additional objects that can dynamically add new functionality.
 
 ## Explanation
+
 Real-world example
 
 > Suppose you are developing a Java-based game for a client, and in the middle of the development process, new features are suggested. The Extension Objects pattern empowers your program to adapt to unforeseen changes with minimal refactoring, especially when integrating additional functionalities into your project.
@@ -27,10 +33,10 @@ Wikipedia says
 
 **Programmatic example**
 
-The aim of utilising the Extension Objects pattern is to implement new features/functionality without having to refactor every class.
-The following examples shows utilising this pattern for an Enemy class extending Entity within a game:
+The aim of utilising the Extension Objects pattern is to implement new features/functionality without having to refactor every class. The following examples shows utilising this pattern for an Enemy class extending Entity within a game:
 
 Primary App class to execute our program from.
+
 ```java
 public class App {
     public static void main(String[] args) {
@@ -50,7 +56,9 @@ public class App {
     }
 }
 ```
+
 Enemy class with initial actions and extensions.
+
 ```java
 class Enemy extends Entity {
     public Enemy(String name) {
@@ -72,7 +80,9 @@ class Enemy extends Entity {
     }
 }
 ```
+
 EnemyExtension class with overriding extendAction() method.
+
 ```java
 class EnemyExtension implements EntityExtension {
     @Override
@@ -81,7 +91,9 @@ class EnemyExtension implements EntityExtension {
     }
 }
 ```
+
 Entity class which will be extended by Enemy.
+
 ```java
 class Entity {
     private String name;
@@ -105,32 +117,62 @@ class Entity {
     }
 }
 ```
+
 EntityExtension interface to be used by EnemyExtension.
+
 ```java
 interface EntityExtension {
     void extendedAction();
 }
 ```
+
 Program output:
+
 ```markdown
 Enemy performs the initial action.
 Enemy wants to attack you.
 Enemy has advanced towards you!
 ```
-In this example, the Extension Objects pattern allows the enemy entity to perform unique initial actions and advanced actions when specific extensions are applied. This pattern provides flexibility and extensibility to the codebase while minimizing the need for major code changes.
 
+In this example, the Extension Objects pattern allows the enemy entity to perform unique initial actions and advanced actions when specific extensions are applied. This pattern provides flexibility and extensibility to the codebase while minimizing the need for major code changes.
 
 ## Class diagram
+
 ![Extension_objects](./etc/extension_obj.png "Extension objects")
 
 ## Applicability
-Use the Extension Objects pattern when:
 
-* you need to support the addition of new or unforeseen interfaces to existing classes and you don't want to impact clients that don't need this new interface. Extension Objects lets you keep related operations together by defining them in a separate class
-* a class representing a key abstraction plays different roles for different clients. The number of roles the class can play should be open-ended. There is a need to preserve the key abstraction itself. For example, a customer object is still a customer object even if different subsystems view it differently.
-* a class should be extensible with new behavior without subclassing from it.
+This pattern is applicable in scenarios where an object's functionality needs to be extended at runtime, avoiding the complications of subclassing. It's particularly useful in systems where object capabilities need to be augmented post-deployment, or where the capabilities might vary significantly across instances.
 
-## Real world examples
+## Known Uses
 
+* Extending services in an application server without altering existing code.
+* Plugins in IDEs like IntelliJ IDEA or Eclipse to add features to the base application.
+* Enabling additional features in enterprise software based on license levels.
 * [OpenDoc](https://en.wikipedia.org/wiki/OpenDoc)
 * [Object Linking and Embedding](https://en.wikipedia.org/wiki/Object_Linking_and_Embedding)
+
+## Consequences
+
+Benefits:
+
+* Enhances flexibility by allowing dynamic extension of an object's capabilities.
+* Promotes loose coupling between the base object and its extensions.
+* Supports the [Open/Closed Principle](https://java-design-patterns.com/principles/#open-closed-principle) by keeping the object open for extension but closed for modification.
+
+Trade-offs:
+
+* Can increase complexity due to the management of extension objects.
+* May introduce performance overhead if the interaction between objects and extensions is not efficiently designed.
+
+## Related Patterns
+
+* [Decorator](https://java-design-patterns.com/patterns/decorator/): Similar in intent to add responsibilities dynamically, but uses a different structure.
+* [Composite](https://java-design-patterns.com/patterns/composite/): Also manages a group of objects, which can be seen as a form of extension.
+* [Strategy](https://java-design-patterns.com/patterns/strategy/): Offers an alternative way to change the behavior of an object dynamically.
+
+## Credits
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/4aBMuuL)
+* [Pattern-Oriented Software Architecture: A System of Patterns](https://amzn.to/3Q9YOtX)
+* [Patterns of Enterprise Application Architecture](https://amzn.to/3W6IZYQ)

extension-objects/src/main/java/concreteextensions/Commander.java

@@ -33,12 +33,8 @@
 /**
  * Class defining Commander.
  */
-@Getter
-@RequiredArgsConstructor
 @Slf4j
-public class Commander implements CommanderExtension {
-
-  private final CommanderUnit unit;
+public record Commander(CommanderUnit unit) implements CommanderExtension {
 
   @Override
   public void commanderReady() {

extension-objects/src/main/java/concreteextensions/Sergeant.java

@@ -33,12 +33,8 @@
 /**
  * Class defining Sergeant.
  */
-@Getter
-@RequiredArgsConstructor
 @Slf4j
-public class Sergeant implements SergeantExtension {
-
-  private final SergeantUnit unit;
+public record Sergeant(SergeantUnit unit) implements SergeantExtension {
 
   @Override
   public void sergeantReady() {

extension-objects/src/main/java/concreteextensions/Soldier.java

@@ -33,12 +33,8 @@
 /**
  * Class defining Soldier.
  */
-@Getter
-@RequiredArgsConstructor
 @Slf4j
-public class Soldier implements SoldierExtension {
-
-  private final SoldierUnit unit;
+public record Soldier(SoldierUnit unit) implements SoldierExtension {
 
   @Override
   public void soldierReady() {

extension-objects/src/test/java/concreteextensions/CommanderTest.java

@@ -36,9 +36,7 @@
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
 /**
- * Created by Srdjan on 03-May-17.
- *
- * Modified by ToxicDreamz on 15-Aug-20
+ * CommanderTest
  */
 class CommanderTest {
 
@@ -56,10 +54,9 @@ void shouldExecuteCommanderReady() {
     commander.commanderReady();
 
     List<ILoggingEvent> logsList = listAppender.list;
-    assertEquals("[Commander] " + commander.getUnit().getName() + " is ready!", logsList.get(0)
+    assertEquals("[Commander] " + commander.unit().getName() + " is ready!", logsList.get(0)
         .getMessage());
     assertEquals(Level.INFO, logsList.get(0)
         .getLevel());
   }
-
-}
+}

extension-objects/src/test/java/concreteextensions/SergeantTest.java

@@ -54,7 +54,7 @@ void sergeantReady() {
     sergeant.sergeantReady();
 
     List<ILoggingEvent> logsList = listAppender.list;
-    assertEquals("[Sergeant] " + sergeant.getUnit().getName() + " is ready!", logsList.get(0)
+    assertEquals("[Sergeant] " + sergeant.unit().getName() + " is ready!", logsList.get(0)
         .getMessage());
     assertEquals(Level.INFO, logsList.get(0)
         .getLevel());

extension-objects/src/test/java/concreteextensions/SoldierTest.java

@@ -55,7 +55,7 @@ void soldierReady() {
     soldier.soldierReady();
 
     List<ILoggingEvent> logsList = listAppender.list;
-    assertEquals("[Soldier] " + soldier.getUnit().getName() + " is ready!", logsList.get(0)
+    assertEquals("[Soldier] " + soldier.unit().getName() + " is ready!", logsList.get(0)
         .getMessage());
     assertEquals(Level.INFO, logsList.get(0)
         .getLevel());

extension-objects/src/test/java/units/UnitTest.java

@@ -35,7 +35,7 @@
 class UnitTest {
 
   @Test
-  void testConstGetSet() throws Exception {
+  void testConstGetSet() {
     final var name = "testName";
     final var unit = new Unit(name);
     assertEquals(name, unit.getName());