entry : documentProperties.entrySet()) {\n String key = entry.getKey();\n Object value = entry.getValue();\n\n // Append key-value pair\n builder.append(\"[\").append(key).append(\" : \").append(value).append(\"]\");\n\n // Add comma if not last property\n if (++currentPropertyIndex < numProperties) {\n builder.append(\", \");\n }\n }\n\n builder.append(\"]\");\n return builder.toString();\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument;\n\nimport com.iluwatar.abstractdocument.domain.Car;\nimport com.iluwatar.abstractdocument.domain.enums.Property;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * The Abstract Document pattern enables handling additional, non-static properties. This pattern\n * uses concept of traits to enable type safety and separate properties of different classes into\n * set of interfaces.\n *\n * In Abstract Document pattern,({@link AbstractDocument}) fully implements {@link Document})\n * interface. Traits are then defined to enable access to properties in usual, static way.\n */\n@Slf4j\npublic class App {\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(String[] args) {\n LOGGER.info(\"Constructing parts and car\");\n\n var wheelProperties =\n Map.of(\n Property.TYPE.toString(), \"wheel\",\n Property.MODEL.toString(), \"15C\",\n Property.PRICE.toString(), 100L);\n\n var doorProperties =\n Map.of(\n Property.TYPE.toString(), \"door\",\n Property.MODEL.toString(), \"Lambo\",\n Property.PRICE.toString(), 300L);\n\n var carProperties =\n Map.of(\n Property.MODEL.toString(),\n \"300SL\",\n Property.PRICE.toString(),\n 10000L,\n Property.PARTS.toString(),\n List.of(wheelProperties, doorProperties));\n\n var car = new Car(carProperties);\n\n LOGGER.info(\"Here is our car:\");\n LOGGER.info(\"-> model: {}\", car.getModel().orElseThrow());\n LOGGER.info(\"-> price: {}\", car.getPrice().orElseThrow());\n LOGGER.info(\"-> parts: \");\n car.getParts()\n .forEach(\n p ->\n LOGGER.info(\n \"\\t{}/{}/{}\",\n p.getType().orElse(null),\n p.getModel().orElse(null),\n p.getPrice().orElse(null)));\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/Document.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument;\n\nimport java.util.Map;\nimport java.util.function.Function;\nimport java.util.stream.Stream;\n\n/** Document interface. */\npublic interface Document {\n\n /**\n * Puts the value related to the key.\n *\n * @param key element key\n * @param value element value\n * @return Void\n */\n Void put(String key, Object value);\n\n /**\n * Gets the value for the key.\n *\n * @param key element key\n * @return value or null\n */\n Object get(String key);\n\n /**\n * Gets the stream of child documents.\n *\n * @param key element key\n * @param constructor constructor of child class\n * @return child documents\n */\n Stream children(String key, Function, T> constructor);\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Car.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain;\n\nimport com.iluwatar.abstractdocument.AbstractDocument;\nimport java.util.Map;\n\n/** Car entity. */\npublic class Car extends AbstractDocument implements HasModel, HasPrice, HasParts {\n\n public Car(Map properties) {\n super(properties);\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasModel.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain;\n\nimport com.iluwatar.abstractdocument.Document;\nimport com.iluwatar.abstractdocument.domain.enums.Property;\nimport java.util.Optional;\n\n/** HasModel trait for static access to 'model' property. */\npublic interface HasModel extends Document {\n\n default Optional getModel() {\n return Optional.ofNullable((String) get(Property.MODEL.toString()));\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasParts.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain;\n\nimport com.iluwatar.abstractdocument.Document;\nimport com.iluwatar.abstractdocument.domain.enums.Property;\nimport java.util.stream.Stream;\n\n/** HasParts trait for static access to 'parts' property. */\npublic interface HasParts extends Document {\n\n default Stream getParts() {\n return children(Property.PARTS.toString(), Part::new);\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasPrice.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain;\n\nimport com.iluwatar.abstractdocument.Document;\nimport com.iluwatar.abstractdocument.domain.enums.Property;\nimport java.util.Optional;\n\n/** HasPrice trait for static access to 'price' property. */\npublic interface HasPrice extends Document {\n\n default Optional getPrice() {\n return Optional.ofNullable((Number) get(Property.PRICE.toString()));\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasType.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain;\n\nimport com.iluwatar.abstractdocument.Document;\nimport com.iluwatar.abstractdocument.domain.enums.Property;\nimport java.util.Optional;\n\n/** HasType trait for static access to 'type' property. */\npublic interface HasType extends Document {\n\n default Optional getType() {\n return Optional.ofNullable((String) get(Property.TYPE.toString()));\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Part.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain;\n\nimport com.iluwatar.abstractdocument.AbstractDocument;\nimport java.util.Map;\n\n/** Part entity. */\npublic class Part extends AbstractDocument implements HasType, HasModel, HasPrice {\n\n public Part(Map properties) {\n super(properties);\n }\n}\n"
},
{
"path": "abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/enums/Property.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument.domain.enums;\n\n/** Enum To Describe Property type. */\npublic enum Property {\n PARTS,\n TYPE,\n PRICE,\n MODEL\n}\n"
},
{
"path": "abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument;\n\nimport static org.junit.jupiter.api.Assertions.*;\n\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\n\n/** AbstractDocument test class */\nclass AbstractDocumentTest {\n\n private static final String KEY = \"key\";\n private static final String VALUE = \"value\";\n\n private static class DocumentImplementation extends AbstractDocument {\n\n DocumentImplementation(Map properties) {\n super(properties);\n }\n }\n\n private final DocumentImplementation document = new DocumentImplementation(new HashMap<>());\n\n @Test\n void shouldPutAndGetValue() {\n document.put(KEY, VALUE);\n assertEquals(VALUE, document.get(KEY));\n }\n\n @Test\n void shouldRetrieveChildren() {\n var children = List.of(Map.of(), Map.of());\n\n document.put(KEY, children);\n\n var childrenStream = document.children(KEY, DocumentImplementation::new);\n assertNotNull(children);\n assertEquals(2, childrenStream.count());\n }\n\n @Test\n void shouldRetrieveEmptyStreamForNonExistingChildren() {\n var children = document.children(KEY, DocumentImplementation::new);\n assertNotNull(children);\n assertEquals(0, children.count());\n }\n\n @Test\n void shouldIncludePropsInToString() {\n var props = Map.of(KEY, (Object) VALUE);\n var document = new DocumentImplementation(props);\n assertTrue(document.toString().contains(KEY));\n assertTrue(document.toString().contains(VALUE));\n }\n\n @Test\n void shouldHandleExceptionDuringConstruction() {\n Map invalidProperties =\n null; // Invalid properties, causing NullPointerException\n\n // Throw null pointer exception\n assertThrows(\n NullPointerException.class,\n () -> {\n // Attempt to construct a document with invalid properties\n new DocumentImplementation(invalidProperties);\n });\n }\n\n @Test\n void shouldPutAndGetNestedDocument() {\n // Creating a nested document\n DocumentImplementation nestedDocument = new DocumentImplementation(new HashMap<>());\n nestedDocument.put(\"nestedKey\", \"nestedValue\");\n\n document.put(\"nested\", nestedDocument);\n\n // Retrieving the nested document\n DocumentImplementation retrievedNestedDocument =\n (DocumentImplementation) document.get(\"nested\");\n\n assertNotNull(retrievedNestedDocument);\n assertEquals(\"nestedValue\", retrievedNestedDocument.get(\"nestedKey\"));\n }\n\n @Test\n void shouldUpdateExistingValue() {\n // Arrange\n final String key = \"key\";\n final String originalValue = \"originalValue\";\n final String updatedValue = \"updatedValue\";\n\n // Initializing the value\n document.put(key, originalValue);\n\n // Verifying that the initial value is retrieved correctly\n assertEquals(originalValue, document.get(key));\n\n // Updating the value\n document.put(key, updatedValue);\n\n // Verifying that the updated value is retrieved correctly\n assertEquals(updatedValue, document.get(key));\n }\n}\n"
},
{
"path": "abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Simple App test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n * Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteAppWithoutException() {\n assertDoesNotThrow(() -> App.main(null));\n }\n}\n"
},
{
"path": "abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractdocument;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport com.iluwatar.abstractdocument.domain.Car;\nimport com.iluwatar.abstractdocument.domain.Part;\nimport com.iluwatar.abstractdocument.domain.enums.Property;\nimport java.util.List;\nimport java.util.Map;\nimport org.junit.jupiter.api.Test;\n\n/** Test for Part and Car */\nclass DomainTest {\n\n private static final String TEST_PART_TYPE = \"test-part-type\";\n private static final String TEST_PART_MODEL = \"test-part-model\";\n private static final long TEST_PART_PRICE = 0L;\n\n private static final String TEST_CAR_MODEL = \"test-car-model\";\n private static final long TEST_CAR_PRICE = 1L;\n\n @Test\n void shouldConstructPart() {\n var partProperties =\n Map.of(\n Property.TYPE.toString(), TEST_PART_TYPE,\n Property.MODEL.toString(), TEST_PART_MODEL,\n Property.PRICE.toString(), (Object) TEST_PART_PRICE);\n var part = new Part(partProperties);\n assertEquals(TEST_PART_TYPE, part.getType().orElseThrow());\n assertEquals(TEST_PART_MODEL, part.getModel().orElseThrow());\n assertEquals(TEST_PART_PRICE, part.getPrice().orElseThrow());\n }\n\n @Test\n void shouldConstructCar() {\n var carProperties =\n Map.of(\n Property.MODEL.toString(), TEST_CAR_MODEL,\n Property.PRICE.toString(), TEST_CAR_PRICE,\n Property.PARTS.toString(), List.of(Map.of(), Map.of()));\n var car = new Car(carProperties);\n assertEquals(TEST_CAR_MODEL, car.getModel().orElseThrow());\n assertEquals(TEST_CAR_PRICE, car.getPrice().orElseThrow());\n assertEquals(2, car.getParts().count());\n }\n}\n"
},
{
"path": "abstract-factory/.gitignore",
"content": "/target/\n"
},
{
"path": "abstract-factory/README.md",
"content": "---\ntitle: \"Abstract Factory Pattern in Java: Mastering Object Creation Elegantly\"\nshortTitle: Abstract Factory\ndescription: \"Learn the Abstract Factory pattern in Java with real-world examples, class diagrams, and tutorials. Understand its intent, applicability, benefits, and known uses to enhance your design pattern knowledge.\"\ncategory: Creational\nlanguage: en\ntag:\n - Abstraction\n - Decoupling\n - Gang of Four\n - Instantiation\n - Polymorphism\n---\n\n## Also known as\n\n* Kit\n\n## Intent of Abstract Factory Design Pattern\n\nThe Abstract Factory pattern in Java provides an interface for creating families of related or dependent objects without specifying their concrete classes, enhancing modularity and flexibility in software design.\n\n## Detailed Explanation of Abstract Factory Pattern with Real-World Examples\n\nReal-world example\n\n> Imagine a furniture company that uses the Abstract Factory pattern in Java to produce various styles of furniture: modern, Victorian, and rustic. Each style includes products like chairs, tables, and sofas. To ensure consistency within each style, the company uses an Abstract Factory pattern.\n>\n> In this scenario, the Abstract Factory is an interface for creating families of related furniture objects (chairs, tables, sofas). Each concrete factory (ModernFurnitureFactory, VictorianFurnitureFactory, RusticFurnitureFactory) implements the Abstract Factory interface and creates a set of products that match the specific style. This way, clients can create a whole set of modern or Victorian furniture without worrying about the details of their instantiation. This maintains a consistent style and allows easy swapping of one style of furniture for another.\n\nIn plain words\n\n> A factory of factories; a factory that groups the individual but related/dependent factories together without specifying their concrete classes.\n\nWikipedia says\n\n> The abstract factory pattern provides a way to encapsulate a group of individual factories that have a common theme without specifying their concrete classes\n\nClass diagram\n\n![Abstract Factory class diagram](./etc/abstract-factory.urm.png \"Abstract Factory class diagram\")\n\n## Programmatic Example of Abstract Factory in Java\n\nTo create a kingdom using the Abstract Factory pattern in Java, we need objects with a common theme. The elven kingdom needs an elven king, elven castle, and elven army whereas the orcish kingdom needs an orcish king, orcish castle, and orcish army. There is a dependency between the objects in the kingdom.\n\nTranslating the kingdom example above. First of all, we have some interfaces and implementation for the objects in the kingdom.\n\n```java\npublic interface Castle {\n String getDescription();\n}\n\npublic interface King {\n String getDescription();\n}\n\npublic interface Army {\n String getDescription();\n}\n\n// Elven implementations ->\npublic class ElfCastle implements Castle {\n static final String DESCRIPTION = \"This is the elven castle!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n\npublic class ElfKing implements King {\n static final String DESCRIPTION = \"This is the elven king!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n\npublic class ElfArmy implements Army {\n static final String DESCRIPTION = \"This is the elven Army!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n\n// Orcish implementations similarly -> ...\n```\n\nThen we have the abstraction and implementations for the kingdom factory.\n\n```java\npublic interface KingdomFactory {\n Castle createCastle();\n\n King createKing();\n\n Army createArmy();\n}\n\npublic class ElfKingdomFactory implements KingdomFactory {\n\n @Override\n public Castle createCastle() {\n return new ElfCastle();\n }\n\n @Override\n public King createKing() {\n return new ElfKing();\n }\n\n @Override\n public Army createArmy() {\n return new ElfArmy();\n }\n}\n\n// Orcish implementations similarly -> ...\n```\n\nNow, we can design a factory for our different kingdom factories. In this example, we created `FactoryMaker`, responsible for returning an instance of either `ElfKingdomFactory` or `OrcKingdomFactory`. The client can use `FactoryMaker` to create the desired concrete factory which, in turn, will produce different concrete objects (derived from `Army`, `King`, `Castle`). In this example, we also used an enum to parameterize which type of kingdom factory the client will ask for.\n\n```java\npublic static class FactoryMaker {\n\n public enum KingdomType {\n ELF, ORC\n }\n\n public static KingdomFactory makeFactory(KingdomType type) {\n return switch (type) {\n case ELF -> new ElfKingdomFactory();\n case ORC -> new OrcKingdomFactory();\n };\n }\n}\n```\n\nHere is the main function of our example application:\n\n```java\nLOGGER.info(\"elf kingdom\");\ncreateKingdom(Kingdom.FactoryMaker.KingdomType.ELF);\nLOGGER.info(kingdom.getArmy().getDescription());\nLOGGER.info(kingdom.getCastle().getDescription());\nLOGGER.info(kingdom.getKing().getDescription());\n\nLOGGER.info(\"orc kingdom\");\ncreateKingdom(Kingdom.FactoryMaker.KingdomType.ORC);\nLOGGER.info(kingdom.getArmy().getDescription());\nLOGGER.info(kingdom.getCastle().getDescription());\nLOGGER.info(kingdom.getKing().getDescription());\n```\n\nThe program output:\n\n```\n07:35:46.340 [main] INFO com.iluwatar.abstractfactory.App -- elf kingdom\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- This is the elven army!\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- This is the elven castle!\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- This is the elven king!\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- orc kingdom\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- This is the orc army!\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- This is the orc castle!\n07:35:46.343 [main] INFO com.iluwatar.abstractfactory.App -- This is the orc king!\n```\n\n## When to Use the Abstract Factory Pattern in Java\n\nUse the Abstract Factory pattern in Java when:\n\n* The system should be independent of how its products are created, composed, and represented.\n* You need to configure the system with one of multiple families of products.\n* A family of related product objects must be used together, enforcing consistency.\n* You want to provide a class library of products, exposing only their interfaces, not their implementations.\n* The lifetime of dependencies is shorter than the consumer's lifetime.\n* Dependencies need to be constructed using runtime values or parameters.\n* You need to choose which product to use from a family at runtime.\n* Adding new products or families should not require changes to existing code.\n\n## Abstract Factory Pattern Java Tutorials\n\n* [Abstract Factory Design Pattern in Java (DigitalOcean)](https://www.digitalocean.com/community/tutorials/abstract-factory-design-pattern-in-java)\n* [Abstract Factory(Refactoring Guru)](https://refactoring.guru/design-patterns/abstract-factory)\n\n## Benefits and Trade-offs of Abstract Factory Pattern\n\nBenefits:\n\n* Flexibility: Easily switch between product families without code modifications.\n\n* Decoupling: Client code only interacts with abstract interfaces, promoting portability and maintainability.\n\n* Reusability: Abstract factories and products facilitate component reuse across projects.\n\n* Maintainability: Changes to individual product families are localized, simplifying updates.\n\nTrade-offs:\n\n* Complexity: Defining abstract interfaces and concrete factories adds initial overhead.\n\n* Indirectness: Client code interacts with products indirectly through factories, potentially reducing transparency.\n\n## Real-World Applications of Abstract Factory Pattern in Java\n\n* Java Swing's `LookAndFeel` classes for providing different look-and-feel options.\n* Various implementations in the Java Abstract Window Toolkit (AWT) for creating different GUI components.\n* [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html)\n* [javax.xml.transform.TransformerFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/transform/TransformerFactory.html#newInstance--)\n* [javax.xml.xpath.XPathFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/xpath/XPathFactory.html#newInstance--)\n\n## Related Java Design Patterns\n\n* [Factory Method](https://java-design-patterns.com/patterns/factory-method/): Abstract Factory uses Factory Methods to create products.\n* [Singleton](https://java-design-patterns.com/patterns/singleton/): Abstract Factory classes are often implemented as Singletons.\n* [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/): Similar to Abstract Factory but focuses on configuring and managing a set of related objects in a flexible way.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Design Patterns in Java](https://amzn.to/3Syw0vC)\n* [Head First Design Patterns: Building Extensible and Maintainable Object-Oriented Software](https://amzn.to/49NGldq)\n* [Java Design Patterns: A Hands-On Experience with Real-World Examples](https://amzn.to/3HWNf4U)\n"
},
{
"path": "abstract-factory/etc/abstract-factory.urm.puml",
"content": "@startuml\npackage com.iluwatar.abstractfactory {\n class App {\n - LOGGER : Logger {static}\n - army : Army\n - castle : Castle\n - king : King\n + App()\n + createKingdom(factory : KingdomFactory)\n + getArmy() : Army\n ~ getArmy(factory : KingdomFactory) : Army\n + getCastle() : Castle\n ~ getCastle(factory : KingdomFactory) : Castle\n + getKing() : King\n ~ getKing(factory : KingdomFactory) : King\n + main(args : String[]) {static}\n - setArmy(army : Army)\n - setCastle(castle : Castle)\n - setKing(king : King)\n }\n class FactoryMaker {\n + FactoryMaker()\n + makeFactory(type : KingdomType) : KingdomFactory {static}\n }\n enum KingdomType {\n + ELF {static}\n + ORC {static}\n + valueOf(name : String) : KingdomType {static}\n + values() : KingdomType[] {static}\n }\n interface Army {\n + getDescription() : String {abstract}\n }\n interface Castle {\n + getDescription() : String {abstract}\n }\n class ElfArmy {\n ~ DESCRIPTION : String {static}\n + ElfArmy()\n + getDescription() : String\n }\n class ElfCastle {\n ~ DESCRIPTION : String {static}\n + ElfCastle()\n + getDescription() : String\n }\n class ElfKing {\n ~ DESCRIPTION : String {static}\n + ElfKing()\n + getDescription() : String\n }\n class ElfKingdomFactory {\n + ElfKingdomFactory()\n + createArmy() : Army\n + createCastle() : Castle\n + createKing() : King\n }\n interface King {\n + getDescription() : String {abstract}\n }\n interface KingdomFactory {\n + createArmy() : Army {abstract}\n + createCastle() : Castle {abstract}\n + createKing() : King {abstract}\n }\n class OrcArmy {\n ~ DESCRIPTION : String {static}\n + OrcArmy()\n + getDescription() : String\n }\n class OrcCastle {\n ~ DESCRIPTION : String {static}\n + OrcCastle()\n + getDescription() : String\n }\n class OrcKing {\n ~ DESCRIPTION : String {static}\n + OrcKing()\n + getDescription() : String\n }\n class OrcKingdomFactory {\n + OrcKingdomFactory()\n + createArmy() : Army\n + createCastle() : Castle\n + createKing() : King\n }\n}\nKingdomType ..+ FactoryMaker\nApp --> \"-castle\" Castle\nFactoryMaker ..+ App\nApp --> \"-king\" King\nApp --> \"-army\" Army\nElfArmy ..|> Army \nElfCastle ..|> Castle \nElfKing ..|> King \nElfKingdomFactory ..|> KingdomFactory \nOrcArmy ..|> Army \nOrcCastle ..|> Castle \nOrcKing ..|> King \nOrcKingdomFactory ..|> KingdomFactory \n@enduml"
},
{
"path": "abstract-factory/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n abstract-factory \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.abstractfactory.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that\n * have a common theme without specifying their concrete classes. In normal usage, the client\n * software creates a concrete implementation of the abstract factory and then uses the generic\n * interface of the factory to create the concrete objects that are part of the theme. The client\n * does not know (or care) which concrete objects it gets from each of these internal factories,\n * since it uses only the generic interfaces of their products. This pattern separates the details\n * of implementation of a set of objects from their general usage and relies on object composition,\n * as object creation is implemented in methods exposed in the factory interface.\n *\n *
The essence of the Abstract Factory pattern is a factory interface ({@link KingdomFactory})\n * and its implementations ( {@link ElfKingdomFactory}, {@link OrcKingdomFactory}). The example uses\n * both concrete implementations to create a king, a castle, and an army.\n */\n@Slf4j\n@Getter\npublic class App implements Runnable {\n\n private final Kingdom kingdom = new Kingdom();\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(String[] args) {\n var app = new App();\n app.run();\n }\n\n @Override\n public void run() {\n LOGGER.info(\"elf kingdom\");\n createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);\n LOGGER.info(kingdom.getArmy().getDescription());\n LOGGER.info(kingdom.getCastle().getDescription());\n LOGGER.info(kingdom.getKing().getDescription());\n\n LOGGER.info(\"orc kingdom\");\n createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);\n LOGGER.info(kingdom.getArmy().getDescription());\n LOGGER.info(kingdom.getCastle().getDescription());\n LOGGER.info(kingdom.getKing().getDescription());\n }\n\n /**\n * Creates kingdom.\n *\n * @param kingdomType type of Kingdom\n */\n public void createKingdom(final Kingdom.FactoryMaker.KingdomType kingdomType) {\n final KingdomFactory kingdomFactory = Kingdom.FactoryMaker.makeFactory(kingdomType);\n kingdom.setKing(kingdomFactory.createKing());\n kingdom.setCastle(kingdomFactory.createCastle());\n kingdom.setArmy(kingdomFactory.createArmy());\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** Army interface. */\npublic interface Army {\n\n String getDescription();\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** Castle interface. */\npublic interface Castle {\n\n String getDescription();\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** ElfArmy. */\npublic class ElfArmy implements Army {\n\n static final String DESCRIPTION = \"This is the elven army!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** ElfCastle. */\npublic class ElfCastle implements Castle {\n\n static final String DESCRIPTION = \"This is the elven castle!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** ElfKing. */\npublic class ElfKing implements King {\n\n static final String DESCRIPTION = \"This is the elven king!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** ElfKingdomFactory concrete factory. */\npublic class ElfKingdomFactory implements KingdomFactory {\n\n @Override\n public Castle createCastle() {\n return new ElfCastle();\n }\n\n @Override\n public King createKing() {\n return new ElfKing();\n }\n\n @Override\n public Army createArmy() {\n return new ElfArmy();\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** King interface. */\npublic interface King {\n\n String getDescription();\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\nimport lombok.Getter;\nimport lombok.Setter;\n\n/** Helper class to manufacture {@link KingdomFactory} beans. */\n@Getter\n@Setter\npublic class Kingdom {\n\n private King king;\n private Castle castle;\n private Army army;\n\n /** The factory of kingdom factories. */\n public static class FactoryMaker {\n\n /** Enumeration for the different types of Kingdoms. */\n public enum KingdomType {\n ELF,\n ORC\n }\n\n /** The factory method to create KingdomFactory concrete objects. */\n public static KingdomFactory makeFactory(KingdomType type) {\n return switch (type) {\n case ELF -> new ElfKingdomFactory();\n case ORC -> new OrcKingdomFactory();\n };\n }\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** KingdomFactory factory interface. */\npublic interface KingdomFactory {\n\n Castle createCastle();\n\n King createKing();\n\n Army createArmy();\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** OrcArmy. */\npublic class OrcArmy implements Army {\n\n static final String DESCRIPTION = \"This is the orc army!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** OrcCastle. */\npublic class OrcCastle implements Castle {\n\n static final String DESCRIPTION = \"This is the orc castle!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** OrcKing. */\npublic class OrcKing implements King {\n\n static final String DESCRIPTION = \"This is the orc king!\";\n\n @Override\n public String getDescription() {\n return DESCRIPTION;\n }\n}\n"
},
{
"path": "abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\n/** OrcKingdomFactory concrete factory. */\npublic class OrcKingdomFactory implements KingdomFactory {\n\n @Override\n public Castle createCastle() {\n return new OrcCastle();\n }\n\n @Override\n public King createKing() {\n return new OrcKing();\n }\n\n @Override\n public Army createArmy() {\n return new OrcArmy();\n }\n}\n"
},
{
"path": "abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests for abstract factory. */\nclass AbstractFactoryTest {\n\n private final App app = new App();\n\n @Test\n void verifyKingCreation() {\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);\n final var kingdom = app.getKingdom();\n\n final var elfKing = kingdom.getKing();\n assertTrue(elfKing instanceof ElfKing);\n assertEquals(ElfKing.DESCRIPTION, elfKing.getDescription());\n\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);\n final var orcKing = kingdom.getKing();\n assertTrue(orcKing instanceof OrcKing);\n assertEquals(OrcKing.DESCRIPTION, orcKing.getDescription());\n }\n\n @Test\n void verifyCastleCreation() {\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);\n final var kingdom = app.getKingdom();\n\n final var elfCastle = kingdom.getCastle();\n assertTrue(elfCastle instanceof ElfCastle);\n assertEquals(ElfCastle.DESCRIPTION, elfCastle.getDescription());\n\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);\n final var orcCastle = kingdom.getCastle();\n assertTrue(orcCastle instanceof OrcCastle);\n assertEquals(OrcCastle.DESCRIPTION, orcCastle.getDescription());\n }\n\n @Test\n void verifyArmyCreation() {\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);\n final var kingdom = app.getKingdom();\n\n final var elfArmy = kingdom.getArmy();\n assertTrue(elfArmy instanceof ElfArmy);\n assertEquals(ElfArmy.DESCRIPTION, elfArmy.getDescription());\n\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);\n final var orcArmy = kingdom.getArmy();\n assertTrue(orcArmy instanceof OrcArmy);\n assertEquals(OrcArmy.DESCRIPTION, orcArmy.getDescription());\n }\n\n @Test\n void verifyElfKingdomCreation() {\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);\n final var kingdom = app.getKingdom();\n\n final var king = kingdom.getKing();\n final var castle = kingdom.getCastle();\n final var army = kingdom.getArmy();\n assertTrue(king instanceof ElfKing);\n assertEquals(ElfKing.DESCRIPTION, king.getDescription());\n assertTrue(castle instanceof ElfCastle);\n assertEquals(ElfCastle.DESCRIPTION, castle.getDescription());\n assertTrue(army instanceof ElfArmy);\n assertEquals(ElfArmy.DESCRIPTION, army.getDescription());\n }\n\n @Test\n void verifyOrcKingdomCreation() {\n app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);\n final var kingdom = app.getKingdom();\n\n final var king = kingdom.getKing();\n final var castle = kingdom.getCastle();\n final var army = kingdom.getArmy();\n assertTrue(king instanceof OrcKing);\n assertEquals(OrcKing.DESCRIPTION, king.getDescription());\n assertTrue(castle instanceof OrcCastle);\n assertEquals(OrcCastle.DESCRIPTION, castle.getDescription());\n assertTrue(army instanceof OrcArmy);\n assertEquals(OrcArmy.DESCRIPTION, army.getDescription());\n }\n}\n"
},
{
"path": "abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.abstractfactory;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Check whether the execution of the main method in {@link App} throws an exception. */\nclass AppTest {\n\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "active-object/README.md",
"content": "---\ntitle: \"Active Object Pattern in Java: Achieving Efficient Asynchronous Processing\"\nshortTitle: Active Object\ndescription: \"Learn about the Active Object design pattern in Java. This guide covers asynchronous behavior, concurrency, and practical examples to enhance your Java applications' performance.\"\ncategory: Concurrency\nlanguage: en\ntag:\n - Asynchronous\n - Decoupling\n - Messaging\n - Synchronization\n - Thread management\n---\n\n## Intent of Active Object Design Pattern\n\nThe Active Object pattern provides a reliable method for asynchronous processing in Java, ensuring responsive applications and efficient thread management. It achieves this by encapsulating tasks within objects that have their own thread and message queue. This separation keeps the main thread responsive and avoids issues like direct thread manipulation or shared state access.\n\n## Detailed Explanation of Active Object Pattern with Real-World Examples\n\nReal-world example\n\n> Imagine a busy restaurant where customers place orders with waiters. Instead of the waiters going to the kitchen to prepare the food themselves, they write the orders on slips and hand them to a dispatcher. The dispatcher manages a pool of chefs who prepare the meals asynchronously. Once a chef is free, they pick up the next order from the queue, prepare the dish, and notify the waiter when it's ready for serving.\n>\n> In this analogy, the waiters represent the client threads, the dispatcher represents the scheduler, and the chefs represent the method execution in separate threads. This setup allows the waiters to continue taking orders without being blocked by the food preparation process, much like the Active Object pattern decouples method invocation from execution to enhance concurrency.\n\nIn plain words\n\n> The Active Object pattern decouples method execution from method invocation to improve concurrency and responsiveness in multithreaded applications.\n\nWikipedia says\n\n> The active object design pattern decouples method execution from method invocation for objects that each reside in their own thread of control.[1] The goal is to introduce concurrency, by using asynchronous method invocation and a scheduler for handling requests.\n>\n> The pattern consists of six elements:\n>\n> * A proxy, which provides an interface towards clients with publicly accessible methods.\n> * An interface which defines the method request on an active object.\n> * A list of pending requests from clients.\n> * A scheduler, which decides which request to execute next.\n> * The implementation of the active object method.\n> * A callback or variable for the client to receive the result.\n\nSequence diagram\n\n\n\n\n## Programmatic Example of Active Object in Java\n\nThis section explains how the Active Object design pattern works in Java, highlighting its use in asynchronous task management and concurrency control.\n\nThe Orcs are known for their wildness and untameable soul. It seems like they have their own thread of control based on previous behavior. To implement a creature that has its own thread of control mechanism and expose its API only and not the execution itself, we can use the Active Object pattern.\n\n```java\npublic abstract class ActiveCreature {\n private final Logger logger = LoggerFactory.getLogger(ActiveCreature.class.getName());\n\n private BlockingQueue requests;\n\n private String name;\n\n private Thread thread;\n\n public ActiveCreature(String name) {\n this.name = name;\n this.requests = new LinkedBlockingQueue();\n thread = new Thread(new Runnable() {\n @Override\n public void run() {\n while (true) {\n try {\n requests.take().run();\n } catch (InterruptedException e) {\n logger.error(e.getMessage());\n }\n }\n }\n }\n );\n thread.start();\n }\n\n public void eat() throws InterruptedException {\n requests.put(new Runnable() {\n @Override\n public void run() {\n logger.info(\"{} is eating!\", name());\n logger.info(\"{} has finished eating!\", name());\n }\n }\n );\n }\n\n public void roam() throws InterruptedException {\n requests.put(new Runnable() {\n @Override\n public void run() {\n logger.info(\"{} has started to roam the wastelands.\", name());\n }\n }\n );\n }\n\n public String name() {\n return this.name;\n }\n}\n```\n\nWe can see that any class that will extend the `ActiveCreature` class will have its own thread of control to invoke and execute methods.\n\nFor example, the `Orc` class:\n\n```java\npublic class Orc extends ActiveCreature {\n\n public Orc(String name) {\n super(name);\n }\n}\n```\n\nNow, we can create multiple creatures such as orcs, tell them to eat and roam, and they will execute it on their own thread of control:\n\n```java\npublic class App implements Runnable {\n\n private static final Logger logger = LoggerFactory.getLogger(App.class.getName());\n\n private static final int NUM_CREATURES = 3;\n\n public static void main(String[] args) {\n var app = new App();\n app.run();\n }\n\n @Override\n public void run() {\n List creatures = new ArrayList<>();\n try {\n for (int i = 0; i < NUM_CREATURES; i++) {\n creatures.add(new Orc(Orc.class.getSimpleName() + i));\n creatures.get(i).eat();\n creatures.get(i).roam();\n }\n Thread.sleep(1000);\n } catch (InterruptedException e) {\n logger.error(e.getMessage());\n Thread.currentThread().interrupt();\n } finally {\n for (int i = 0; i < NUM_CREATURES; i++) {\n creatures.get(i).kill(0);\n }\n }\n }\n}\n```\n\nProgram output:\n\n```\n09:00:02.501 [Thread-0] INFO com.iluwatar.activeobject.ActiveCreature -- Orc0 is eating!\n09:00:02.501 [Thread-2] INFO com.iluwatar.activeobject.ActiveCreature -- Orc2 is eating!\n09:00:02.501 [Thread-1] INFO com.iluwatar.activeobject.ActiveCreature -- Orc1 is eating!\n09:00:02.504 [Thread-0] INFO com.iluwatar.activeobject.ActiveCreature -- Orc0 has finished eating!\n09:00:02.504 [Thread-1] INFO com.iluwatar.activeobject.ActiveCreature -- Orc1 has finished eating!\n09:00:02.504 [Thread-0] INFO com.iluwatar.activeobject.ActiveCreature -- Orc0 has started to roam in the wastelands.\n09:00:02.504 [Thread-2] INFO com.iluwatar.activeobject.ActiveCreature -- Orc2 has finished eating!\n09:00:02.504 [Thread-1] INFO com.iluwatar.activeobject.ActiveCreature -- Orc1 has started to roam in the wastelands.\n09:00:02.504 [Thread-2] INFO com.iluwatar.activeobject.ActiveCreature -- Orc2 has started to roam in the wastelands.\n```\n\n## When to Use the Active Object Pattern in Java\n\nUse the Active Object pattern in Java when:\n\n* when you need to handle asynchronous tasks without blocking the main thread, ensuring better performance and responsiveness.\n* When you need to interact with external resources asynchronously.\n* When you want to improve the responsiveness of your application.\n* When you need to manage concurrent tasks in a modular and maintainable way.\n\n## Active Object Pattern Java Tutorials\n\n* [Android and Java Concurrency: The Active Object Pattern(Douglas Schmidt)](https://www.youtube.com/watch?v=Cd8t2u5Qmvc)\n\n## Real-World Applications of Active Object Pattern in Java\n\n* Real-time trading systems where transaction requests are handled asynchronously.\n* GUIs where long-running tasks are executed in the background without freezing the user interface.\n* Game programming to handle concurrent updates to game state or AI computations.\n\n## Benefits and Trade-offs of Active Object Pattern\n\nDiscover the benefits and trade-offs of using the Active Object pattern in Java, including improved thread safety and potential overhead concerns.\n\nBenefits:\n\n* Improves responsiveness of the main thread.\n* Encapsulates concurrency concerns within objects.\n* Promotes better code organization and maintainability.\n* Provides thread safety and avoids shared state access problems.\n\nTrade-offs:\n\n* Introduces additional overhead due to message passing and thread management.\n* May not be suitable for all types of concurrency problems.\n\n## Related Java Design Patterns\n\n* [Command](https://java-design-patterns.com/patterns/command/): Encapsulates a request as an object, similarly to how the Active Object pattern encapsulates method calls.\n* [Promise](https://java-design-patterns.com/patterns/promise/): Provides a means to retrieve the result of an asynchronous method call, often used in conjunction with Active Object.\n* [Proxy](https://java-design-patterns.com/patterns/proxy/): The Active Object pattern can use a proxy to handle method invocations asynchronously.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object Software](https://amzn.to/3HYqrBE)\n* [Concurrent Programming in Java: Design Principles and Patterns](https://amzn.to/498SRVq)\n* [Java Concurrency in Practice](https://amzn.to/4aRMruW)\n* [Learning Concurrent Programming in Scala](https://amzn.to/3UE07nV)\n* [Pattern Languages of Program Design 3](https://amzn.to/3OI1j61)\n* [Pattern-Oriented Software Architecture Volume 2: Patterns for Concurrent and Networked Objects](https://amzn.to/3UgC24V)\n"
},
{
"path": "active-object/etc/active-object.urm.puml",
"content": "@startuml\npackage com.iluwatar.activeobject {\n abstract class ActiveCreature {\n - logger : Logger\n - name : String\n - requests : BlockingQueue\n - thread : Thread\n + ActiveCreature(name : String)\n + eat()\n + name() : String\n + roam()\n }\n class App {\n - creatures : Integer\n - logger : Logger\n + App()\n + main(args : String[]) {static}\n + run()\n }\n class Orc {\n + Orc(name : String)\n }\n}\nOrc --|> ActiveCreature \n@enduml"
},
{
"path": "active-object/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n active-object \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.activeobject.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.activeobject;\n\nimport java.util.concurrent.BlockingQueue;\nimport java.util.concurrent.LinkedBlockingQueue;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\n\n/** ActiveCreature class is the base of the active object example. */\npublic abstract class ActiveCreature {\n\n private static final Logger logger = LoggerFactory.getLogger(ActiveCreature.class.getName());\n\n private BlockingQueue requests;\n\n private String name;\n\n private Thread thread; // Thread of execution.\n\n private int status; // status of the thread of execution.\n\n /** Constructor and initialization. */\n protected ActiveCreature(String name) {\n this.name = name;\n this.status = 0;\n this.requests = new LinkedBlockingQueue<>();\n thread =\n new Thread(\n () -> {\n boolean infinite = true;\n while (infinite) {\n try {\n requests.take().run();\n } catch (InterruptedException e) {\n if (this.status != 0) {\n logger.error(\"Thread was interrupted. --> {}\", e.getMessage());\n }\n infinite = false;\n Thread.currentThread().interrupt();\n }\n }\n });\n thread.start();\n }\n\n /**\n * Eats the porridge.\n *\n * @throws InterruptedException due to firing a new Runnable.\n */\n public void eat() throws InterruptedException {\n requests.put(\n () -> {\n logger.info(\"{} is eating!\", name());\n logger.info(\"{} has finished eating!\", name());\n });\n }\n\n /**\n * Roam the wastelands.\n *\n * @throws InterruptedException due to firing a new Runnable.\n */\n public void roam() throws InterruptedException {\n requests.put(() -> logger.info(\"{} has started to roam in the wastelands.\", name()));\n }\n\n /**\n * Returns the name of the creature.\n *\n * @return the name of the creature.\n */\n public String name() {\n return this.name;\n }\n\n /**\n * Kills the thread of execution.\n *\n * @param status of the thread of execution. 0 == OK, the rest is logging an error.\n */\n public void kill(int status) {\n this.status = status;\n this.thread.interrupt();\n }\n\n /**\n * Returns the status of the thread of execution.\n *\n * @return the status of the thread of execution.\n */\n public int getStatus() {\n return this.status;\n }\n}\n"
},
{
"path": "active-object/src/main/java/com/iluwatar/activeobject/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.activeobject;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\n\n/**\n * The Active Object pattern helps to solve synchronization difficulties without using\n * 'synchronized' methods. The active object will contain a thread-safe data structure (such as\n * BlockingQueue) and use to synchronize method calls by moving the logic of the method into an\n * invocator(usually a Runnable) and store it in the DSA.\n *\n * In this example, we fire 20 threads to modify a value in the target class.\n */\npublic class App implements Runnable {\n\n private static final Logger logger = LoggerFactory.getLogger(App.class.getName());\n\n private static final int NUM_CREATURES = 3;\n\n /**\n * Program entry point.\n *\n * @param args command line arguments.\n */\n public static void main(String[] args) {\n var app = new App();\n app.run();\n }\n\n @Override\n public void run() {\n List creatures = new ArrayList<>();\n try {\n for (int i = 0; i < NUM_CREATURES; i++) {\n creatures.add(new Orc(Orc.class.getSimpleName() + i));\n creatures.get(i).eat();\n creatures.get(i).roam();\n }\n Thread.sleep(1000);\n } catch (InterruptedException e) {\n logger.error(e.getMessage());\n Thread.currentThread().interrupt();\n } finally {\n for (int i = 0; i < NUM_CREATURES; i++) {\n creatures.get(i).kill(0);\n }\n }\n }\n}\n"
},
{
"path": "active-object/src/main/java/com/iluwatar/activeobject/Orc.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.activeobject;\n\n/** An implementation of the ActiveCreature class. */\npublic class Orc extends ActiveCreature {\n\n public Orc(String name) {\n super(name);\n }\n}\n"
},
{
"path": "active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.activeobject;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport org.junit.jupiter.api.Test;\n\nclass ActiveCreatureTest {\n\n @Test\n void executionTest() throws InterruptedException {\n ActiveCreature orc = new Orc(\"orc1\");\n assertEquals(\"orc1\", orc.name());\n assertEquals(0, orc.getStatus());\n orc.eat();\n orc.roam();\n orc.kill(0);\n }\n}\n"
},
{
"path": "active-object/src/test/java/com/iluwatar/activeobject/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.activeobject;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\nclass AppTest {\n\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "actor-model/README.md",
"content": "---\ntitle: \"Actor Model Pattern in Java: Building Concurrent Systems with Elegance\"\nshortTitle: Actor Model\ndescription: \"Explore the Actor Model pattern in Java with real-world examples and practical implementation. Learn how to build scalable, message-driven systems using actors, messages, and asynchronous communication.\"\ncategory: Concurrency\nlanguage: en\ntag:\n - Concurrency\n - Messaging\n - Isolation\n - Asynchronous\n - Distributed Systems\n - Actor Model\n---\n\n## Also Known As\n\n- Message-passing concurrency\n- Actor-based concurrency\n\n---\n\n## Intent of Actor Model Pattern\n\nThe Actor Model pattern enables the construction of highly concurrent, distributed, and fault-tolerant systems by using isolated components (actors) that interact exclusively through asynchronous message passing.\n\n---\n\n## Detailed Explanation of Actor Model Pattern with Real-World Examples\n\n### 📦 Real-world Example\n\nImagine a customer service system:\n- Each **customer support agent** is an **actor**.\n- Customers **send questions (messages)** to agents.\n- Each agent handles one request at a time and can **respond asynchronously** without interfering with other agents.\n\n---\n\n### 🧠 In Plain Words\n\n> \"Actors are like independent workers that never share memory and only communicate through messages.\"\n\n---\n\n### 📖 Wikipedia Says\n\n> [Actor model](https://en.wikipedia.org/wiki/Actor_model) is a mathematical model of concurrent computation that treats \"actors\" as the universal primitives of concurrent computation.\n\n---\n\n### 🧹 Architecture Diagram\n\n\n\n---\n\n## Programmatic Example of Actor Model Pattern in Java\n\n### Actor.java\n\n```java\npublic abstract class Actor implements Runnable {\n\n @Setter @Getter private String actorId;\n private final BlockingQueue mailbox = new LinkedBlockingQueue<>();\n private volatile boolean active = true; \n\n\n public void send(Message message) {\n mailbox.add(message); \n }\n\n public void stop() {\n active = false; \n }\n\n @Override\n public void run() {\n \n }\n\n protected abstract void onReceive(Message message);\n}\n\n```\n\n### Message.java\n\n```java\n\n@AllArgsConstructor\n@Getter\n@Setter\npublic class Message {\n private final String content;\n private final String senderId;\n}\n```\n\n### ActorSystem.java\n\n```java\npublic class ActorSystem {\n public void startActor(Actor actor) {\n String actorId = \"actor-\" + idCounter.incrementAndGet(); // Generate a new and unique ID\n actor.setActorId(actorId); // assign the actor it's ID\n actorRegister.put(actorId, actor); // Register and save the actor with it's ID\n executor.submit(actor); // Run the actor in a thread\n }\n public Actor getActorById(String actorId) {\n return actorRegister.get(actorId); // Find by Id\n }\n\n public void shutdown() {\n executor.shutdownNow(); // Stop all threads\n }\n}\n```\n\n### App.java\n\n```java\npublic class App {\n public static void main(String[] args) {\n ActorSystem system = new ActorSystem();\n Actor srijan = new ExampleActor(system);\n Actor ansh = new ExampleActor2(system);\n\n system.startActor(srijan);\n system.startActor(ansh);\n ansh.send(new Message(\"Hello ansh\", srijan.getActorId()));\n srijan.send(new Message(\"Hello srijan!\", ansh.getActorId()));\n\n Thread.sleep(1000); // Give time for messages to process\n\n srijan.stop(); // Stop the actor gracefully\n ansh.stop();\n system.shutdown(); // Stop the actor system\n }\n}\n```\n\n---\n\n## When to Use the Actor Model Pattern in Java\n\n- When building **concurrent or distributed systems**\n- When you want **no shared mutable state**\n- When you need **asynchronous, message-driven communication**\n- When components should be **isolated and loosely coupled**\n\n---\n\n## Actor Model Pattern Java Tutorials\n\n- [Baeldung – Akka with Java](https://www.baeldung.com/java-akka)\n- [Vaughn Vernon – Reactive Messaging Patterns](https://vaughnvernon.co/?p=1143)\n\n---\n\n## Real-World Applications of Actor Model Pattern in Java\n\n- [Akka Framework](https://akka.io/)\n- [Erlang and Elixir concurrency](https://www.erlang.org/)\n- [Microsoft Orleans](https://learn.microsoft.com/en-us/dotnet/orleans/)\n- JVM-based game engines and simulators\n\n---\n\n## Benefits and Trade-offs of Actor Model Pattern\n\n### ✅ Benefits\n- High concurrency support\n- Easy scaling across threads or machines\n- Fault isolation and recovery\n- Message ordering within actors\n\n### ⚠️ Trade-offs\n- Harder to debug due to asynchronous behavior\n- Slight performance overhead due to message queues\n- More complex to design than simple method calls\n\n---\n\n## Related Java Design Patterns\n\n- [Command Pattern](../command)\n- [Mediator Pattern](../mediator)\n- [Event-Driven Architecture](../event-driven-architecture)\n- [Observer Pattern](../observer)\n\n---\n\n## References and Credits\n\n- *Programming Erlang*, Joe Armstrong\n- *Reactive Design Patterns*, Roland Kuhn\n- *The Actor Model in 10 Minutes*, [InfoQ Article](https://www.infoq.com/articles/actor-model/)\n- [Akka Documentation](https://doc.akka.io/docs/akka/current/index.html)\n\n"
},
{
"path": "actor-model/etc/actor-model.urm.puml",
"content": "@startuml actor-model\n\ntitle Actor Model - UML Class Diagram\n\nclass ActorSystem {\n +actorOf(actor: Actor): Actor\n +shutdown(): void\n}\n\nclass Actor {\n -mailbox: BlockingQueue\n -active: boolean\n +send(message: Message): void\n +stop(): void\n +run(): void\n #onReceive(message: Message): void\n}\n\nclass ExampleActor {\n +onReceive(message: Message): void\n}\n\nclass Message {\n -content: String\n -sender: Actor\n +getContent(): String\n +getSender(): Actor\n}\n\nActorSystem --> Actor : creates\nActor <|-- ExampleActor : extends\nActor --> Message : processes\nExampleActor --> Message : uses\n\n@enduml\n"
},
{
"path": "actor-model/pom.xml",
"content": "\n\n\n\n 4.0.0 \n\n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n\n actor-model \n Actor Model \n\n \n \n \n \n org.junit \n junit-bom \n 5.11.0 \n pom \n import \n \n \n \n\n \n \n org.junit.jupiter \n junit-jupiter-api \n test \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.junit.platform \n junit-platform-launcher \n test \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n\n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n 3.3.0 \n \n \n jar-with-dependencies \n \n \n \n com.iluwatar.actormodel.App \n \n \n \n \n \n make-assembly \n package \n \n single \n \n \n \n\n \n \n \n\n \n"
},
{
"path": "actor-model/src/main/java/com/iluwatar/actormodel/Actor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.actormodel;\n\nimport java.util.concurrent.BlockingQueue;\nimport java.util.concurrent.LinkedBlockingQueue;\nimport lombok.Getter;\nimport lombok.Setter;\n\npublic abstract class Actor implements Runnable {\n\n @Setter @Getter private String actorId;\n private final BlockingQueue mailbox = new LinkedBlockingQueue<>();\n private volatile boolean active =\n true; // always read from main memory and written back to main memory,\n\n // rather than being cached in a thread's local memory. To make it consistent to all Actors\n\n public void send(Message message) {\n mailbox.add(message); // Add message to queue\n }\n\n public void stop() {\n active = false; // Stop the actor loop\n }\n\n @Override\n public void run() {\n while (active) {\n try {\n Message message = mailbox.take(); // Wait for a message\n onReceive(message); // Process it\n } catch (InterruptedException e) {\n Thread.currentThread().interrupt();\n }\n }\n }\n\n // Child classes must define what to do with a message\n protected abstract void onReceive(Message message);\n}\n"
},
{
"path": "actor-model/src/main/java/com/iluwatar/actormodel/ActorSystem.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.actormodel;\n\nimport java.util.concurrent.ConcurrentHashMap;\nimport java.util.concurrent.ExecutorService;\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.atomic.AtomicInteger;\n\npublic class ActorSystem {\n private final ExecutorService executor = Executors.newCachedThreadPool();\n private final ConcurrentHashMap actorRegister = new ConcurrentHashMap<>();\n private final AtomicInteger idCounter = new AtomicInteger(0);\n\n public void startActor(Actor actor) {\n String actorId = \"actor-\" + idCounter.incrementAndGet(); // Generate a new and unique ID\n actor.setActorId(actorId); // assign the actor it's ID\n actorRegister.put(actorId, actor); // Register and save the actor with it's ID\n executor.submit(actor); // Run the actor in a thread\n }\n\n public Actor getActorById(String actorId) {\n return actorRegister.get(actorId); // Find by Id\n }\n\n public void shutdown() {\n executor.shutdownNow(); // Stop all threads\n }\n}\n"
},
{
"path": "actor-model/src/main/java/com/iluwatar/actormodel/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\n\n/**\n * The Actor Model is a design pattern used to handle concurrency in a safe, scalable, and\n * message-driven way.\n *\n * In the Actor Model: - An **Actor** is an independent unit that has its own state and behavior.\n * - Actors **communicate only through messages** — they do not share memory. - An **ActorSystem**\n * is responsible for creating, starting, and managing the lifecycle of actors. - Messages are\n * delivered asynchronously, and each actor processes them one at a time.\n *\n *
💡 Key benefits: - No shared memory = no need for complex thread-safety - Easy to scale with\n * many actors - Suitable for highly concurrent or distributed systems\n *\n *
🔍 This example demonstrates the Actor Model: - `ActorSystem` starts two actors: `srijan` and\n * `ansh`. - `ExampleActor` and `ExampleActor2` extend the `Actor` class and override the\n * `onReceive()` method to handle messages. - Actors communicate using `send()` to pass `Message`\n * objects that include the message content and sender's ID. - The actors process messages\n * **asynchronously in separate threads**, and we allow a short delay (`Thread.sleep`) to let them\n * run. - The system is shut down gracefully at the end.\n */\npackage com.iluwatar.actormodel;\n\npublic class App {\n public static void main(String[] args) throws InterruptedException {\n ActorSystem system = new ActorSystem();\n Actor srijan = new ExampleActor(system);\n Actor ansh = new ExampleActor2(system);\n\n system.startActor(srijan);\n system.startActor(ansh);\n ansh.send(new Message(\"Hello ansh\", srijan.getActorId()));\n srijan.send(new Message(\"Hello srijan!\", ansh.getActorId()));\n\n Thread.sleep(1000); // Give time for messages to process\n\n srijan.stop(); // Stop the actor gracefully\n ansh.stop();\n system.shutdown(); // Stop the actor system\n }\n}\n"
},
{
"path": "actor-model/src/main/java/com/iluwatar/actormodel/ExampleActor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.actormodel;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\n\n@Slf4j\npublic class ExampleActor extends Actor {\n private final ActorSystem actorSystem;\n @Getter private final List receivedMessages = new ArrayList<>();\n\n public ExampleActor(ActorSystem actorSystem) {\n this.actorSystem = actorSystem;\n }\n\n // Logger log = Logger.getLogger(getClass().getName());\n\n @Override\n protected void onReceive(Message message) {\n LOGGER.info(\n \"[{}]Received : {} from : [{}]\", getActorId(), message.getContent(), message.getSenderId());\n Actor sender = actorSystem.getActorById(message.getSenderId()); // sender actor id\n // Reply of the message\n if (sender != null && !message.getSenderId().equals(getActorId())) {\n sender.send(new Message(\"I got your message \", getActorId()));\n }\n }\n}\n"
},
{
"path": "actor-model/src/main/java/com/iluwatar/actormodel/ExampleActor2.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.actormodel;\n\nimport java.util.ArrayList;\nimport java.util.List;\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\n\n@Slf4j\npublic class ExampleActor2 extends Actor {\n private final ActorSystem actorSystem;\n @Getter private final List receivedMessages = new ArrayList<>();\n\n public ExampleActor2(ActorSystem actorSystem) {\n this.actorSystem = actorSystem;\n }\n\n @Override\n protected void onReceive(Message message) {\n receivedMessages.add(message.getContent());\n LOGGER.info(\"[{}]Received : {}\", getActorId(), message.getContent());\n }\n}\n"
},
{
"path": "actor-model/src/main/java/com/iluwatar/actormodel/Message.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.actormodel;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Getter;\n\n@AllArgsConstructor\n@Getter\npublic class Message {\n private final String content;\n private final String senderId;\n}\n"
},
{
"path": "actor-model/src/test/java/com/iluwatar/actor/ActorModelTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.actor;\n\nimport static org.junit.jupiter.api.Assertions.*;\n\nimport com.iluwatar.actormodel.ActorSystem;\nimport com.iluwatar.actormodel.App;\nimport com.iluwatar.actormodel.ExampleActor;\nimport com.iluwatar.actormodel.ExampleActor2;\nimport com.iluwatar.actormodel.Message;\nimport org.junit.jupiter.api.Test;\n\npublic class ActorModelTest {\n @Test\n void testMainMethod() throws InterruptedException {\n App.main(new String[] {});\n }\n\n @Test\n public void testMessagePassing() throws InterruptedException {\n ActorSystem system = new ActorSystem();\n\n ExampleActor srijan = new ExampleActor(system);\n ExampleActor2 ansh = new ExampleActor2(system);\n\n system.startActor(srijan);\n system.startActor(ansh);\n\n // Ansh recieves a message from Srijan\n ansh.send(new Message(\"Hello ansh\", srijan.getActorId()));\n\n // Wait briefly to allow async processing\n Thread.sleep(200);\n\n // Check that Srijan received the message\n assertTrue(\n ansh.getReceivedMessages().contains(\"Hello ansh\"),\n \"ansh should receive the message from Srijan\");\n }\n}\n"
},
{
"path": "acyclic-visitor/README.md",
"content": "---\ntitle: \"Acyclic Visitor Pattern in Java: Streamlining Object Interactions\"\nshortTitle: Acyclic Visitor\ndescription: \"Learn about the Acyclic Visitor pattern in Java. This guide explains how it decouples operations from object hierarchies, providing examples and real-world applications.\"\ncategory: Behavioral\nlanguage: en\ntag:\n - Decoupling\n - Extensibility\n - Interface\n - Object composition\n---\n\n## Intent of Acyclic Visitor Design Pattern\n\nThe Acyclic Visitor pattern in Java decouples operations from an object hierarchy, providing a flexible design for various applications.\n\n## Detailed Explanation of Acyclic Visitor Pattern with Real-World Examples\n\nReal-world example\n\n> An analogous real-world example of the Acyclic Visitor pattern in Java is a museum guide system, demonstrating the practical application of this design pattern. Imagine a museum with various exhibits like paintings, sculptures, and historical artifacts. The museum has different types of guides (audio guide, human guide, virtual reality guide) that provide information about each exhibit. Instead of modifying the exhibits every time a new guide type is introduced, each guide implements an interface to visit different exhibit types. This way, the museum can add new types of guides without altering the existing exhibits, ensuring that the system remains extensible and maintainable without forming any dependency cycles.\n\nIn plain words\n\n> Acyclic Visitor allows functions to be added to existing class hierarchies without modifying the hierarchies.\n\n[WikiWikiWeb](https://wiki.c2.com/?AcyclicVisitor) says\n\n> The Acyclic Visitor pattern allows new functions to be added to existing class hierarchies without affecting those hierarchies, and without creating the dependency cycles that are inherent to the GangOfFour VisitorPattern.\n\nSequence diagram\n\n![Acyclic Visitor sequence diagram](./etc/acyclic-visitor-sequence-diagram.png \"Acyclic Visitor sequence diagram\")\n\n\n## Programmatic Example of Acyclic Visitor in Java\n\nIn this Java example, we have a hierarchy of modem classes illustrating the Acyclic Visitor pattern. The modems in this hierarchy need to be visited by an external algorithm based on filtering criteria (is it Unix or DOS compatible modem).\n\nHere's the `Modem` hierarchy.\n\n```java\npublic abstract class Modem {\n public abstract void accept(ModemVisitor modemVisitor);\n}\n\npublic class Zoom extends Modem {\n\n // Other properties and methods...\n\n @Override\n public void accept(ModemVisitor modemVisitor) {\n if (modemVisitor instanceof ZoomVisitor) {\n ((ZoomVisitor) modemVisitor).visit(this);\n } else {\n LOGGER.info(\"Only ZoomVisitor is allowed to visit Zoom modem\");\n }\n }\n}\n\npublic class Hayes extends Modem {\n\n // Other properties and methods...\n\n @Override\n public void accept(ModemVisitor modemVisitor) {\n if (modemVisitor instanceof HayesVisitor) {\n ((HayesVisitor) modemVisitor).visit(this);\n } else {\n LOGGER.info(\"Only HayesVisitor is allowed to visit Hayes modem\");\n }\n }\n}\n```\n\nNext, we introduce the `ModemVisitor` hierarchy.\n\n```java\npublic interface ModemVisitor {\n}\n\npublic interface HayesVisitor extends ModemVisitor {\n void visit(Hayes hayes);\n}\n\npublic interface ZoomVisitor extends ModemVisitor {\n void visit(Zoom zoom);\n}\n\npublic interface AllModemVisitor extends ZoomVisitor, HayesVisitor {\n}\n\npublic class ConfigureForDosVisitor implements AllModemVisitor {\n\n // Other properties and methods...\n\n @Override\n public void visit(Hayes hayes) {\n LOGGER.info(hayes + \" used with Dos configurator.\");\n }\n\n @Override\n public void visit(Zoom zoom) {\n LOGGER.info(zoom + \" used with Dos configurator.\");\n }\n}\n\npublic class ConfigureForUnixVisitor implements ZoomVisitor {\n\n // Other properties and methods...\n\n @Override\n public void visit(Zoom zoom) {\n LOGGER.info(zoom + \" used with Unix configurator.\");\n }\n}\n```\n\nFinally, here are the visitors in action.\n\n```java\npublic static void main(String[] args) {\n var conUnix = new ConfigureForUnixVisitor();\n var conDos = new ConfigureForDosVisitor();\n\n var zoom = new Zoom();\n var hayes = new Hayes();\n\n hayes.accept(conDos); // Hayes modem with Dos configurator\n zoom.accept(conDos); // Zoom modem with Dos configurator\n hayes.accept(conUnix); // Hayes modem with Unix configurator\n zoom.accept(conUnix); // Zoom modem with Unix configurator \n}\n```\n\nProgram output:\n\n```\n09:15:11.125 [main] INFO com.iluwatar.acyclicvisitor.ConfigureForDosVisitor -- Hayes modem used with Dos configurator.\n09:15:11.127 [main] INFO com.iluwatar.acyclicvisitor.ConfigureForDosVisitor -- Zoom modem used with Dos configurator.\n09:15:11.127 [main] INFO com.iluwatar.acyclicvisitor.Hayes -- Only HayesVisitor is allowed to visit Hayes modem\n09:15:11.127 [main] INFO com.iluwatar.acyclicvisitor.ConfigureForUnixVisitor -- Zoom modem used with Unix configurator.\n```\n\n## When to Use the Acyclic Visitor Pattern in Java\n\nThis pattern can be used:\n\n* When you need to add a new function to an existing hierarchy without the need to alter or affect that hierarchy.\n* When there are functions that operate upon a hierarchy, but which do not belong in the hierarchy itself. e.g. the ConfigureForDOS / ConfigureForUnix / ConfigureForX issue.\n* When you need to perform very different operations on an object depending upon its type.\n* When the visited class hierarchy will be frequently extended with new derivatives of the Element class.\n* When the recompilation, relinking, retesting or redistribution of the derivatives of Element is very expensive.\n\n## Acyclic Visitor Pattern Java Tutorials\n\n* [The Acyclic Visitor Pattern (Code Crafter)](https://codecrafter.blogspot.com/2012/12/the-acyclic-visitor-pattern.html)\n\n## Benefits and Trade-offs of Acyclic Visitor Pattern\n\nBenefits:\n\n* Extensible: New operations can be added easily without changing the object structure.\n* Decoupled: Reduces coupling between the objects and the operations on them.\n* No dependency cycles: Ensures acyclic dependencies, improving maintainability and reducing complexity.\n\nTrade-offs:\n\n* Increased complexity: Can introduce additional complexity with the need for multiple visitor interfaces.\n* Maintenance overhead: Modifying the object hierarchy requires updating all visitors.\n\n## Related Java Design Patterns\n\n* [Composite](https://java-design-patterns.com/patterns/composite/): Often used in conjunction with Acyclic Visitor to allow treating individual objects and compositions uniformly.\n* [Decorator](https://java-design-patterns.com/patterns/decorator/): Can be used alongside to add responsibilities to objects dynamically.\n* [Visitor](https://java-design-patterns.com/patterns/visitor/): The Acyclic Visitor pattern is a variation of the Visitor pattern that avoids cyclic dependencies.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Head First Design Patterns: Building Extensible and Maintainable Object-Oriented Software](https://amzn.to/49NGldq)\n* [Java Design Patterns: A Hands-On Experience with Real-World Examples](https://amzn.to/3yhh525)\n* [Patterns in Java: A Catalog of Reusable Design Patterns Illustrated with UML](https://amzn.to/4bOtzwF)\n* [Acyclic Visitor (Robert C. Martin)](http://condor.depaul.edu/dmumaugh/OOT/Design-Principles/acv.pdf)\n* [Acyclic Visitor (WikiWikiWeb)](https://wiki.c2.com/?AcyclicVisitor)\n"
},
{
"path": "acyclic-visitor/etc/acyclic-visitor.urm.puml",
"content": "@startuml\npackage com.iluwatar.acyclicvisitor {\n interface AllModemVisitor {\n }\n class App {\n + App()\n + main(args : String[]) {static}\n }\n class ConfigureForDosVisitor {\n - LOGGER : Logger {static}\n + ConfigureForDosVisitor()\n + visit(hayes : Hayes)\n + visit(zoom : Zoom)\n }\n class ConfigureForUnixVisitor {\n - LOGGER : Logger {static}\n + ConfigureForUnixVisitor()\n + visit(zoom : Zoom)\n }\n class Hayes {\n - LOGGER : Logger {static}\n + Hayes()\n + accept(modemVisitor : ModemVisitor)\n + toString() : String\n }\n interface HayesVisitor {\n + visit(Hayes) {abstract}\n }\n abstract class Modem {\n + Modem()\n + accept(ModemVisitor) {abstract}\n }\n interface ModemVisitor {\n }\n class Zoom {\n - LOGGER : Logger {static}\n + Zoom()\n + accept(modemVisitor : ModemVisitor)\n + toString() : String\n }\n interface ZoomVisitor {\n + visit(Zoom) {abstract}\n }\n}\nAllModemVisitor --|> ZoomVisitor \nAllModemVisitor --|> HayesVisitor \nConfigureForDosVisitor ..|> AllModemVisitor \nConfigureForUnixVisitor ..|> ZoomVisitor \nHayes --|> Modem \nHayesVisitor --|> ModemVisitor \nZoom --|> Modem \nZoomVisitor --|> ModemVisitor \n@enduml"
},
{
"path": "acyclic-visitor/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n acyclic-visitor \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.mockito \n mockito-core \n test \n \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.acyclicvisitor.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\n/**\n * All ModemVisitor interface extends all visitor interfaces. This interface provides ease of use\n * when a visitor needs to visit all modem types.\n */\npublic interface AllModemVisitor extends ZoomVisitor, HayesVisitor {}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\n/**\n * The Acyclic Visitor pattern allows new functions to be added to existing class hierarchies\n * without affecting those hierarchies, and without creating the dependency cycles that are inherent\n * to the GoF Visitor pattern, by making the Visitor base class degenerate\n *\n * In this example the visitor base class is {@link ModemVisitor}. The base class of the visited\n * hierarchy is {@link Modem} and has two children {@link Hayes} and {@link Zoom} each one having\n * its own visitor interface {@link HayesVisitor} and {@link ZoomVisitor} respectively. {@link\n * ConfigureForUnixVisitor} and {@link ConfigureForDosVisitor} implement each derivative's visit\n * method only if it is required\n */\npublic class App {\n\n /** Program's entry point. */\n public static void main(String[] args) {\n var conUnix = new ConfigureForUnixVisitor();\n var conDos = new ConfigureForDosVisitor();\n\n var zoom = new Zoom();\n var hayes = new Hayes();\n\n hayes.accept(conDos); // Hayes modem with Dos configurator\n zoom.accept(conDos); // Zoom modem with Dos configurator\n hayes.accept(conUnix); // Hayes modem with Unix configurator\n zoom.accept(conUnix); // Zoom modem with Unix configurator\n }\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * ConfigureForDosVisitor class implements both zoom's and hayes' visit method for Dos manufacturer.\n */\n@Slf4j\npublic class ConfigureForDosVisitor implements AllModemVisitor {\n\n @Override\n public void visit(Hayes hayes) {\n LOGGER.info(hayes + \" used with Dos configurator.\");\n }\n\n @Override\n public void visit(Zoom zoom) {\n LOGGER.info(zoom + \" used with Dos configurator.\");\n }\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * ConfigureForUnixVisitor class implements zoom's visit method for Unix manufacturer, unlike\n * traditional visitor pattern, this class may selectively implement visit for other modems.\n */\n@Slf4j\npublic class ConfigureForUnixVisitor implements ZoomVisitor {\n\n @Override\n public void visit(Zoom zoom) {\n LOGGER.info(zoom + \" used with Unix configurator.\");\n }\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** Hayes class implements its accept method. */\n@Slf4j\npublic class Hayes implements Modem {\n\n /** Accepts all visitors but honors only HayesVisitor. */\n @Override\n public void accept(ModemVisitor modemVisitor) {\n if (modemVisitor instanceof HayesVisitor) {\n ((HayesVisitor) modemVisitor).visit(this);\n } else {\n LOGGER.info(\"Only HayesVisitor is allowed to visit Hayes modem\");\n }\n }\n\n /** Hayes' modem's toString method. */\n @Override\n public String toString() {\n return \"Hayes modem\";\n }\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/HayesVisitor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\n/** HayesVisitor interface. */\npublic interface HayesVisitor extends ModemVisitor {\n void visit(Hayes hayes);\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Modem.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\n/** //Modem abstract class. converted to an interface */\npublic interface Modem {\n void accept(ModemVisitor modemVisitor);\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\n/**\n * ModemVisitor interface does not contain any visit methods so that it does not depend on the\n * visited hierarchy. Each derivative's visit method is declared in its own visitor interface\n */\npublic interface ModemVisitor {\n // Visitor is a degenerate base class for all visitors.\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** Zoom class implements its accept method. */\n@Slf4j\npublic class Zoom implements Modem {\n\n /** Accepts all visitors but honors only ZoomVisitor. */\n @Override\n public void accept(ModemVisitor modemVisitor) {\n if (modemVisitor instanceof ZoomVisitor) {\n ((ZoomVisitor) modemVisitor).visit(this);\n } else {\n LOGGER.info(\"Only ZoomVisitor is allowed to visit Zoom modem\");\n }\n }\n\n /** Zoom modem's toString method. */\n @Override\n public String toString() {\n return \"Zoom modem\";\n }\n}\n"
},
{
"path": "acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ZoomVisitor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\n/** ZoomVisitor interface. */\npublic interface ZoomVisitor extends ModemVisitor {\n void visit(Zoom zoom);\n}\n"
},
{
"path": "acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests that the Acyclic Visitor example runs without errors. */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n *
Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.*;\n\nimport org.junit.jupiter.api.Test;\n\n/** Hayes test class */\nclass HayesTest {\n\n @Test\n void testAcceptForDos() {\n var hayes = new Hayes();\n var mockVisitor = mock(ConfigureForDosVisitor.class);\n\n hayes.accept(mockVisitor);\n verify((HayesVisitor) mockVisitor).visit(eq(hayes));\n }\n\n @Test\n void testAcceptForUnix() {\n var hayes = new Hayes();\n var mockVisitor = mock(ConfigureForUnixVisitor.class);\n\n hayes.accept(mockVisitor);\n\n verifyNoMoreInteractions(mockVisitor);\n }\n}\n"
},
{
"path": "acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.acyclicvisitor;\n\nimport static org.mockito.ArgumentMatchers.eq;\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.verify;\n\nimport org.junit.jupiter.api.Test;\n\n/** Zoom test class */\nclass ZoomTest {\n\n @Test\n void testAcceptForDos() {\n var zoom = new Zoom();\n var mockVisitor = mock(ConfigureForDosVisitor.class);\n\n zoom.accept(mockVisitor);\n verify((ZoomVisitor) mockVisitor).visit(eq(zoom));\n }\n\n @Test\n void testAcceptForUnix() {\n var zoom = new Zoom();\n var mockVisitor = mock(ConfigureForUnixVisitor.class);\n\n zoom.accept(mockVisitor);\n verify((ZoomVisitor) mockVisitor).visit(eq(zoom));\n }\n}\n"
},
{
"path": "adapter/README.md",
"content": "---\ntitle: \"Adapter Pattern in Java: Seamless Integration of Incompatible Systems\"\nshortTitle: Adapter\ndescription: \"Learn how the Adapter Design Pattern works in Java with detailed examples and use cases. Understand how it enables compatibility between incompatible interfaces.\"\ncategory: Structural\nlanguage: en\ntag:\n - Compatibility\n - Decoupling\n - Gang of Four\n - Interface\n - Object composition\n - Wrapping\n---\n\n## Also known as\n\n* Wrapper\n\n## Intent of Adapter Design Pattern\n\nThe Adapter Design Pattern in Java converts the interface of a class into another interface that clients expect, enabling compatibility.\n\n## Detailed Explanation of Adapter Pattern with Real-World Examples\n\nReal-world example\n\n> Consider that you have some pictures on your memory card and you need to transfer them to your computer. To transfer them, you need some kind of adapter that is compatible with your computer ports so that you can attach a memory card to your computer. In this case card reader is an adapter. Another example would be the famous power adapter; a three-legged plug can't be connected to a two-pronged outlet, it needs to use a power adapter that makes it compatible with the two-pronged outlets. Yet another example would be a translator translating words spoken by one person to another\n\nIn plain words\n\n> Adapter pattern lets you wrap an otherwise incompatible object in an adapter to make it compatible with another class.\n\nWikipedia says\n\n> In software engineering, the adapter pattern is a software design pattern that allows the interface of an existing class to be used as another interface. It is often used to make existing classes work with others without modifying their source code.\n\nSequence diagram\n\n![Adapter sequence diagram](./etc/adapter-sequence-diagram.png \"Adapter sequence diagram\")\n\n## Programmatic Example of Adapter Pattern in Java\n\nThe Adapter Pattern example in Java shows how a class with an incompatible interface can be adapted to work with another class.\n\nConsider a wannabe captain that can only use rowing boats but can't sail at all.\n\nFirst, we have interfaces `RowingBoat` and `FishingBoat`\n\n```java\npublic interface RowingBoat {\n void row();\n}\n\n@Slf4j\npublic class FishingBoat {\n public void sail() {\n LOGGER.info(\"The fishing boat is sailing\");\n }\n}\n```\n\nThe captain expects an implementation of `RowingBoat` interface to be able to move.\n\n```java\npublic class Captain {\n\n private final RowingBoat rowingBoat;\n\n // default constructor and setter for rowingBoat\n public Captain(RowingBoat rowingBoat) {\n this.rowingBoat = rowingBoat;\n }\n\n public void row() {\n rowingBoat.row();\n }\n}\n```\n\nNow, let's say the pirates are coming and our captain needs to escape but there is only a fishing boat available. We need to create an adapter that allows the captain to operate the fishing boat with his rowing boat skills.\n\n```java\n@Slf4j\npublic class FishingBoatAdapter implements RowingBoat {\n\n private final FishingBoat boat;\n\n public FishingBoatAdapter() {\n boat = new FishingBoat();\n }\n\n @Override\n public void row() {\n boat.sail();\n }\n}\n```\n\nNow the `Captain` can use the `FishingBoat` to escape the pirates.\n\n```java\n public static void main(final String[] args) {\n // The captain can only operate rowing boats but with adapter he is able to\n // use fishing boats as well\n var captain = new Captain(new FishingBoatAdapter());\n captain.row();\n}\n```\n\nThe program outputs:\n\n```\n10:25:08.074 [main] INFO com.iluwatar.adapter.FishingBoat -- The fishing boat is sailing\n```\n\n## When to Use the Adapter Pattern in Java\n\nUse the Adapter pattern in Java when\n\n* You want to use an existing class, and its interface does not match the one you need\n* You want to create a reusable class that cooperates with unrelated or unforeseen classes, that is, classes that don't necessarily have compatible interfaces\n* You need to use several existing subclasses, but it's impractical to adapt their interface by subclassing everyone. An object adapter can adapt the interface of its parent class.\n* Most of the applications using third-party libraries use adapters as a middle layer between the application and the 3rd party library to decouple the application from the library. If another library has to be used only an adapter for the new library is required without having to change the application code.\n\n## Adapter Pattern Java Tutorials\n\n* [Using the Adapter Design Pattern in Java (Dzone)](https://dzone.com/articles/adapter-design-pattern-in-java)\n* [Adapter in Java (Refactoring Guru)](https://refactoring.guru/design-patterns/adapter/java/example)\n* [The Adapter Pattern in Java (Baeldung)](https://www.baeldung.com/java-adapter-pattern)\n* [Adapter Design Pattern (GeeksForGeeks)](https://www.geeksforgeeks.org/adapter-pattern/)\n\n## Benefits and Trade-offs of Adapter Pattern\n\nClass and object adapters offer different benefits and drawbacks. A class adapter adapts the Adaptee to the Target by binding to a specific Adaptee class, which means it cannot adapt a class and all its subclasses. This type of adapter allows the Adapter to override some of the Adaptee’s behavior because the Adapter is a subclass of the Adaptee. Additionally, it introduces only one object without needing extra pointer indirection to reach the Adaptee.\n\nOn the other hand, an object adapter allows a single Adapter to work with multiple Adaptees, including the Adaptee and all its subclasses. This type of adapter can add functionality to all Adaptees simultaneously. However, it makes overriding the Adaptee’s behavior more difficult, as it requires subclassing the Adaptee and having the Adapter refer to this subclass instead of the Adaptee itself.\n\n## Real-World Applications of Adapter Pattern in Java\n\n* `java.io.InputStreamReader` and `java.io.OutputStreamWriter` in the Java IO library.\n* GUI component libraries that allow for plug-ins or adapters to convert between different GUI component interfaces.\n* [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29)\n* [java.util.Collections#list()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#list-java.util.Enumeration-)\n* [java.util.Collections#enumeration()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#enumeration-java.util.Collection-)\n* [javax.xml.bind.annotation.adapters.XMLAdapter](http://docs.oracle.com/javase/8/docs/api/javax/xml/bind/annotation/adapters/XmlAdapter.html#marshal-BoundType-)\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Effective Java](https://amzn.to/4cGk2Jz)\n* [Head First Design Patterns: Building Extensible and Maintainable Object-Oriented Software](https://amzn.to/49NGldq)\n* [J2EE Design Patterns](https://amzn.to/4dpzgmx)\n* [Refactoring to Patterns](https://amzn.to/3VOO4F5)\n"
},
{
"path": "adapter/etc/adapter.urm.puml",
"content": "@startuml\npackage com.iluwatar.adapter {\n class App {\n - App()\n + main(args : String[]) {static}\n }\n class Captain {\n - rowingBoat : RowingBoat\n + Captain()\n + Captain(boat : RowingBoat)\n ~ row()\n ~ setRowingBoat(boat : RowingBoat)\n }\n ~class FishingBoat {\n - LOGGER : Logger {static}\n ~ FishingBoat()\n ~ sail()\n }\n class FishingBoatAdapter {\n - boat : FishingBoat\n + FishingBoatAdapter()\n + row()\n }\n interface RowingBoat {\n + row() {abstract}\n }\n}\nFishingBoatAdapter --> \"-boat\" FishingBoat\nCaptain --> \"-rowingBoat\" RowingBoat\nFishingBoatAdapter ..|> RowingBoat \n@enduml"
},
{
"path": "adapter/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n adapter \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.mockito \n mockito-core \n test \n \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.adapter.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "adapter/src/main/java/com/iluwatar/adapter/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.adapter;\n\n/**\n * An adapter helps two incompatible interfaces to work together. This is the real world definition\n * for an adapter. Interfaces may be incompatible but the inner functionality should suit the need.\n * The Adapter design pattern allows otherwise incompatible classes to work together by converting\n * the interface of one class into an interface expected by the clients.\n *\n *
There are two variations of the Adapter pattern: The class adapter implements the adaptee's\n * interface whereas the object adapter uses composition to contain the adaptee in the adapter\n * object. This example uses the object adapter approach.\n *\n *
The Adapter ({@link FishingBoatAdapter}) converts the interface of the adaptee class ({@link\n * FishingBoat}) into a suitable one expected by the client ({@link RowingBoat}).\n *\n *
The story of this implementation is this. beans;\n\n private static final String FISHING_BEAN = \"fisher\";\n\n private static final String ROWING_BEAN = \"captain\";\n\n /** This method runs before the test execution and sets the bean objects in the beans Map. */\n @BeforeEach\n void setup() {\n beans = new HashMap<>();\n\n var fishingBoatAdapter = spy(new FishingBoatAdapter());\n beans.put(FISHING_BEAN, fishingBoatAdapter);\n\n var captain = new Captain();\n captain.setRowingBoat((FishingBoatAdapter) beans.get(FISHING_BEAN));\n beans.put(ROWING_BEAN, captain);\n }\n\n /**\n * This test asserts that when we use the row() method on a captain bean(client), it is internally\n * calling sail method on the fishing boat object. The Adapter ({@link FishingBoatAdapter} )\n * converts the interface of the target class ( {@link FishingBoat}) into a suitable one expected\n * by the client ({@link Captain} ).\n */\n @Test\n void testAdapter() {\n var captain = (Captain) beans.get(ROWING_BEAN);\n\n // when captain moves\n captain.row();\n\n // the captain internally calls the battleship object to move\n var adapter = (RowingBoat) beans.get(FISHING_BEAN);\n verify(adapter).row();\n }\n}\n"
},
{
"path": "adapter/src/test/java/com/iluwatar/adapter/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.adapter;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests that Adapter example runs without errors. */\nclass AppTest {\n\n /** Check whether the execution of the main method in {@link App} throws an exception. */\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "ambassador/README.md",
"content": "---\ntitle: \"Ambassador Pattern in Java: Simplifying Remote Resource Management\"\nshortTitle: Ambassador\ndescription: \"Explore the Ambassador Pattern in Java, its benefits, use cases, and practical examples. Learn how to decouple and offload common functionalities to improve system performance and maintainability.\"\ncategory: Integration\nlanguage: en\ntag:\n - API design\n - Decoupling\n - Fault tolerance\n - Proxy\n - Resilience\n - Scalability\n---\n\n## Intent of Ambassador Design Pattern\n\nThe Ambassador Pattern in Java helps offload common functionalities such as monitoring, logging, and routing from a shared resource to a helper service instance, enhancing performance and maintainability in distributed systems.\n\n## Detailed Explanation of Ambassador Pattern with Real-World Examples\n\nReal-world example\n\n> Imagine a busy hotel where guests frequently request restaurant reservations, event tickets, or transportation arrangements. Instead of each guest individually contacting these services, the hotel provides a concierge. The concierge handles these tasks on behalf of the guests, ensuring that reservations are made smoothly, tickets are booked on time, and transportation is scheduled efficiently.\n>\n> In this analogy, the guests are the client services, the external providers (restaurants, ticket vendors, transportation) are the remote services, and the concierge represents the ambassador service. This setup allows the guests to focus on enjoying their stay while the concierge manages the complexities of external interactions, providing a seamless and enhanced experience.\n\nIn plain words\n\n> With the Ambassador pattern, we can implement less-frequent polling from clients along with latency checks and logging.\n\nMicrosoft documentation states\n\n> An ambassador service can be thought of as an out-of-process proxy which is co-located with the client. This pattern can be useful for offloading common client connectivity tasks such as monitoring, logging, routing, security (such as TLS), and resiliency patterns in a language agnostic way. It is often used with legacy applications, or other applications that are difficult to modify, in order to extend their networking capabilities. It can also enable a specialized team to implement those features.\n\nSequence diagram\n\n![Ambassador sequence diagram](./etc/ambassador-sequence-diagram.png \"Ambassador sequence diagram\")\n\n## Programmatic Example of Ambassador Pattern in Java\n\nIn this example of the Ambassador Pattern in Java, we demonstrate how to implement latency checks, logging, and retry mechanisms to improve system reliability.\n\nA remote service has many clients accessing a function it provides. The service is a legacy application and is impossible to update. Large numbers of requests from users are causing connectivity issues. New rules for request frequency should be implemented along with latency checks and client-side logging.\n\nWith the above introduction in mind we will imitate the functionality in this example. We have an interface implemented by the remote service as well as the ambassador service.\n\n```java\ninterface RemoteServiceInterface {\n long doRemoteFunction(int value) throws Exception;\n}\n```\n\nA remote services represented as a singleton.\n\n```java\n\n@Slf4j\npublic class RemoteService implements RemoteServiceInterface {\n private static RemoteService service = null;\n\n static synchronized RemoteService getRemoteService() {\n if (service == null) {\n service = new RemoteService();\n }\n return service;\n }\n\n private RemoteService() {\n }\n\n @Override\n public long doRemoteFunction(int value) {\n long waitTime = (long) Math.floor(Math.random() * 1000);\n\n try {\n sleep(waitTime);\n } catch (InterruptedException e) {\n LOGGER.error(\"Thread sleep interrupted\", e);\n }\n\n return waitTime >= 200 ? value * 10 : -1;\n }\n}\n```\n\nA service ambassador adds additional features such as logging and latency checks.\n\n```java\n\n@Slf4j\npublic class ServiceAmbassador implements RemoteServiceInterface {\n private static final int RETRIES = 3;\n private static final int DELAY_MS = 3000;\n\n ServiceAmbassador() {\n }\n\n @Override\n public long doRemoteFunction(int value) {\n return safeCall(value);\n }\n\n private long checkLatency(int value) {\n var startTime = System.currentTimeMillis();\n var result = RemoteService.getRemoteService().doRemoteFunction(value);\n var timeTaken = System.currentTimeMillis() - startTime;\n\n LOGGER.info(\"Time taken (ms): \" + timeTaken);\n return result;\n }\n\n private long safeCall(int value) {\n var retries = 0;\n var result = (long) FAILURE;\n\n for (int i = 0; i < RETRIES; i++) {\n if (retries >= RETRIES) {\n return FAILURE;\n }\n\n if ((result = checkLatency(value)) == FAILURE) {\n LOGGER.info(\"Failed to reach remote: (\" + (i + 1) + \")\");\n retries++;\n try {\n sleep(DELAY_MS);\n } catch (InterruptedException e) {\n LOGGER.error(\"Thread sleep state interrupted\", e);\n }\n } else {\n break;\n }\n }\n return result;\n }\n}\n```\n\nA client has a local service ambassador used to interact with the remote service.\n\n```java\n\n@Slf4j\npublic class Client {\n private final ServiceAmbassador serviceAmbassador = new ServiceAmbassador();\n\n long useService(int value) {\n var result = serviceAmbassador.doRemoteFunction(value);\n LOGGER.info(\"Service result: \" + result);\n return result;\n }\n}\n```\n\nHere are two clients using the service.\n\n```java\npublic class App {\n public static void main(String[] args) {\n var host1 = new Client();\n var host2 = new Client();\n host1.useService(12);\n host2.useService(73);\n }\n}\n```\n\nHere's the output for running the example:\n\n```java\nTime taken(ms):111\nService result:120\nTime taken(ms):931\nFailed to reach remote:(1)\nTime taken(ms):665\nFailed to reach remote:(2)\nTime taken(ms):538\nFailed to reach remote:(3)\nService result:-1\n```\n\n## When to Use the Ambassador Pattern in Java\n\n* The Ambassador Pattern is particularly beneficial for Cloud Native and Microservices Architectures in Java. It helps in monitoring, logging, and securing inter-service communication, making it ideal for distributed systems.\n* Legacy System Integration: Facilitates communication with newer services by handling necessary but non-core functionalities.\n* Performance Enhancement: Can be used to cache results or compress data to improve communication efficiency.\n\nTypical use cases include:\n\n* Control access to another object\n* Implement logging\n* Implement circuit breaking\n* Offload remote service tasks\n* Facilitate network connection\n\n## Benefits and Trade-offs of Ambassador Pattern\n\nBenefits:\n\n* Separation of Concerns: Offloads cross-cutting concerns from the service logic, leading to cleaner, more maintainable code.\n* Reusable Infrastructure Logic: The ambassador pattern allows the same logic (e.g., logging, monitoring) to be reused across multiple services.\n* Improved Security: Centralizes security features like SSL termination or authentication, reducing the risk of misconfiguration.\n* Flexibility: Makes it easier to update or replace infrastructure concerns without modifying the service code.\n\nTrade-offs:\n\n* Increased Complexity: Adds another layer to the architecture, which can complicate the system design and debugging.\n* Potential Performance Overhead: The additional network hop can introduce latency and overhead, particularly if not optimized.\n* Deployment Overhead: Requires additional resources and management for deploying and scaling ambassador services.\n\n## Real-World Applications of Ambassador Pattern in Java\n\n* Service Mesh Implementations: In a service mesh architecture, like Istio or Linkerd, the Ambassador pattern is often employed as a sidecar proxy that handles inter-service communications. This includes tasks such as service discovery, routing, load balancing, telemetry (metrics and tracing), and security (authentication and authorization).\n* API Gateways: API gateways can use the Ambassador pattern to encapsulate common functionalities like rate limiting, caching, request shaping, and authentication. This allows backend services to focus on their core business logic without being burdened by these cross-cutting concerns.\n* Logging and Monitoring: An Ambassador can aggregate logs and metrics from various services and forward them to centralized monitoring tools like Prometheus or ELK Stack (Elasticsearch, Logstash, Kibana). This simplifies the logging and monitoring setup for each service and provides a unified view of the system's health.\n* Security: Security-related functionalities such as SSL/TLS termination, identity verification, and encryption can be managed by an Ambassador. This ensures consistent security practices across services and reduces the likelihood of security breaches due to misconfigurations.\n* Resilience: The Ambassador can implement resilience patterns like circuit breakers, retries, and timeouts. For instance, Netflix's Hystrix library can be used within an Ambassador to prevent cascading failures in a microservices ecosystem.\n* Database Proxy: Ambassadors can act as proxies for database connections, providing functionalities like connection pooling, read/write splitting for replicas, and query caching. This offloads significant complexity from the application services.\n* Legacy System Integration: In scenarios where modern microservices need to communicate with legacy systems, an Ambassador can serve as an intermediary that translates protocols, handles necessary transformations, and implements modern security practices, easing the integration process.\n* Network Optimization: For services deployed across different geographical locations or cloud regions, Ambassadors can optimize communication by compressing data, batching requests, or even implementing smart routing to reduce latency and costs.\n* [Kubernetes-native API gateway for microservices](https://github.com/datawire/ambassador)\n\n## Related Java Design Patterns\n\n* [Circuit Breaker](https://java-design-patterns.com/patterns/circuit-breaker/): Often used in conjunction to manage fault tolerance by stopping calls to an unresponsive service.\n* [Decorator](https://java-design-patterns.com/patterns/decorator/): The decorator pattern is used to add functionality to an object dynamically, while the ambassador pattern is used to offload functionality to a separate object.\n* [Proxy](https://java-design-patterns.com/patterns/proxy/): Shares similarities with the proxy pattern, but the ambassador pattern specifically focuses on offloading ancillary functionalities.\n* Sidecar: A similar pattern used in the context of containerized applications, where a sidecar container provides additional functionality to the main application container.\n\n## References and Credits\n\n* [Building Microservices: Designing Fine-Grained Systems](https://amzn.to/43aGpSR)\n* [Cloud Native Patterns: Designing Change-tolerant Software](https://amzn.to/3wUAl4O)\n* [Designing Distributed Systems: Patterns and Paradigms for Scalable, Reliable Services](https://amzn.to/3T9g9Uj)\n* [Microservices Patterns: With examples in Java](https://amzn.to/3UyWD5O)\n* [Ambassador pattern (Microsoft)](https://docs.microsoft.com/en-us/azure/architecture/patterns/ambassador)\n"
},
{
"path": "ambassador/etc/ambassador.urm.puml",
"content": "@startuml\npackage com.iluwatar.ambassador.util {\n interface RandomProvider {\n + random() : double {abstract}\n }\n}\npackage com.iluwatar.ambassador {\n class App {\n + App()\n + main(args : String[]) {static}\n }\n class Client {\n - LOGGER : Logger {static}\n - serviceAmbassador : ServiceAmbassador\n + Client()\n ~ useService(value : int) : long\n }\n class RemoteService {\n - LOGGER : Logger {static}\n - THRESHOLD : int {static}\n - randomProvider : RandomProvider\n - service : RemoteService {static}\n - RemoteService()\n ~ RemoteService(randomProvider : RandomProvider)\n + doRemoteFunction(value : int) : long\n ~ getRemoteService() : RemoteService {static}\n }\n ~interface RemoteServiceInterface {\n + FAILURE : int {static}\n + doRemoteFunction(int) : long {abstract}\n }\n class ServiceAmbassador {\n - DELAY_MS : int {static}\n - LOGGER : Logger {static}\n - RETRIES : int {static}\n ~ ServiceAmbassador()\n - checkLatency(value : int) : long\n + doRemoteFunction(value : int) : long\n - safeCall(value : int) : long\n }\n}\nRemoteService --> \"-service\" RemoteService\nClient --> \"-serviceAmbassador\" ServiceAmbassador\nRemoteService --> \"-randomProvider\" RandomProvider\nRemoteService ..|> RemoteServiceInterface \nServiceAmbassador ..|> RemoteServiceInterface \n@enduml"
},
{
"path": "ambassador/pom.xml",
"content": "\n\n\n \n java-design-patterns \n com.iluwatar \n 1.26.0-SNAPSHOT \n \n 4.0.0 \n ambassador \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.ambassador.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\n/**\n * The ambassador pattern creates a helper service that sends network requests on behalf of a\n * client. It is often used in cloud-based applications to offload features of a remote service.\n *\n * An ambassador service can be thought of as an out-of-process proxy that is co-located with the\n * client. Similar to the proxy design pattern, the ambassador service provides an interface for\n * another remote service. In addition to the interface, the ambassador provides extra functionality\n * and features, specifically offloaded common connectivity tasks. This usually consists of\n * monitoring, logging, routing, security etc. This is extremely useful in legacy applications where\n * the codebase is difficult to modify and allows for improvements in the application's networking\n * capabilities.\n *\n *
In this example, we will the ({@link ServiceAmbassador}) class represents the ambassador while\n * the ({@link RemoteService}) class represents a remote application.\n */\npublic class App {\n\n /** Entry point. */\n public static void main(String[] args) {\n var host1 = new Client();\n var host2 = new Client();\n host1.useService(12);\n host2.useService(73);\n }\n}\n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/Client.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** A simple Client. */\n@Slf4j\npublic class Client {\n\n private final ServiceAmbassador serviceAmbassador = new ServiceAmbassador();\n\n long useService(int value) {\n var result = serviceAmbassador.doRemoteFunction(value);\n LOGGER.info(\"Service result: {}\", result);\n return result;\n }\n}\n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport static java.lang.Thread.sleep;\n\nimport com.iluwatar.ambassador.util.RandomProvider;\nimport lombok.extern.slf4j.Slf4j;\n\n/** A remote legacy application represented by a Singleton implementation. */\n@Slf4j\npublic class RemoteService implements RemoteServiceInterface {\n private static final int THRESHOLD = 200;\n private static RemoteService service = null;\n private final RandomProvider randomProvider;\n\n static synchronized RemoteService getRemoteService() {\n if (service == null) {\n service = new RemoteService();\n }\n return service;\n }\n\n private RemoteService() {\n this(Math::random);\n }\n\n /** This constructor is used for testing purposes only. */\n RemoteService(RandomProvider randomProvider) {\n this.randomProvider = randomProvider;\n }\n\n /**\n * Remote function takes a value and multiplies it by 10 taking a random amount of time. Will\n * sometimes return -1. This imitates connectivity issues a client might have to account for.\n *\n * @param value integer value to be multiplied.\n * @return if waitTime is less than {@link RemoteService#THRESHOLD}, it returns value * 10,\n * otherwise {@link RemoteServiceStatus#FAILURE}.\n */\n @Override\n public long doRemoteFunction(int value) {\n\n long waitTime = (long) Math.floor(randomProvider.random() * 1000);\n\n try {\n sleep(waitTime);\n } catch (InterruptedException e) {\n LOGGER.error(\"Thread sleep state interrupted\", e);\n Thread.currentThread().interrupt();\n }\n return waitTime <= THRESHOLD\n ? value * 10\n : RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue();\n }\n}\n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\n/** Interface shared by ({@link RemoteService}) and ({@link ServiceAmbassador}). */\ninterface RemoteServiceInterface {\n\n long doRemoteFunction(int value);\n}\n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport lombok.Getter;\n\n/**\n * Holds information regarding the status of the Remote Service.\n *\n *
This Enum replaces the integer value previously stored in {@link RemoteServiceInterface} as\n * SonarCloud was identifying it as an issue. All test cases have been checked after changes,\n * without failures.\n */\npublic enum RemoteServiceStatus {\n FAILURE(-1);\n\n @Getter private final long remoteServiceStatusValue;\n\n RemoteServiceStatus(long remoteServiceStatusValue) {\n this.remoteServiceStatusValue = remoteServiceStatusValue;\n }\n}\n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport static com.iluwatar.ambassador.RemoteServiceStatus.FAILURE;\nimport static java.lang.Thread.sleep;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * ServiceAmbassador provides an interface for a ({@link Client}) to access ({@link RemoteService}).\n * The interface adds logging, latency testing and usage of the service in a safe way that will not\n * add stress to the remote service when connectivity issues occur.\n */\n@Slf4j\npublic class ServiceAmbassador implements RemoteServiceInterface {\n\n private static final int RETRIES = 3;\n private static final int DELAY_MS = 3000;\n\n ServiceAmbassador() {}\n\n @Override\n public long doRemoteFunction(int value) {\n return safeCall(value);\n }\n\n private long checkLatency(int value) {\n var startTime = System.currentTimeMillis();\n var result = RemoteService.getRemoteService().doRemoteFunction(value);\n var timeTaken = System.currentTimeMillis() - startTime;\n\n LOGGER.info(\"Time taken (ms): {}\", timeTaken);\n return result;\n }\n\n private long safeCall(int value) {\n var retries = 0;\n var result = FAILURE.getRemoteServiceStatusValue();\n\n for (int i = 0; i < RETRIES; i++) {\n if (retries >= RETRIES) {\n return FAILURE.getRemoteServiceStatusValue();\n }\n\n if ((result = checkLatency(value)) == FAILURE.getRemoteServiceStatusValue()) {\n LOGGER.info(\"Failed to reach remote: ({})\", i + 1);\n retries++;\n try {\n sleep(DELAY_MS);\n } catch (InterruptedException e) {\n LOGGER.error(\"Thread sleep state interrupted\", e);\n Thread.currentThread().interrupt();\n }\n } else {\n break;\n }\n }\n return result;\n }\n}\n"
},
{
"path": "ambassador/src/main/java/com/iluwatar/ambassador/util/RandomProvider.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador.util;\n\n/** An interface for randomness. Useful for testing purposes. */\npublic interface RandomProvider {\n double random();\n}\n"
},
{
"path": "ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Application test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n *
Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\n\n/** Test for {@link Client} */\nclass ClientTest {\n\n @Test\n void test() {\n Client client = new Client();\n var result = client.useService(10);\n\n assertTrue(\n result == 100 || result == RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue());\n }\n}\n"
},
{
"path": "ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport com.iluwatar.ambassador.util.RandomProvider;\nimport org.junit.jupiter.api.Test;\n\n/** Test for {@link RemoteService} */\nclass RemoteServiceTest {\n\n @Test\n void testFailedCall() {\n var remoteService = new RemoteService(new StaticRandomProvider(0.21));\n var result = remoteService.doRemoteFunction(10);\n assertEquals(RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue(), result);\n }\n\n @Test\n void testSuccessfulCall() {\n var remoteService = new RemoteService(new StaticRandomProvider(0.2));\n var result = remoteService.doRemoteFunction(10);\n assertEquals(100, result);\n }\n\n private static class StaticRandomProvider implements RandomProvider {\n private final double value;\n\n StaticRandomProvider(double value) {\n this.value = value;\n }\n\n @Override\n public double random() {\n return value;\n }\n }\n}\n"
},
{
"path": "ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.ambassador;\n\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\n\n/** Test for {@link ServiceAmbassador} */\nclass ServiceAmbassadorTest {\n\n @Test\n void test() {\n long result = new ServiceAmbassador().doRemoteFunction(10);\n assertTrue(\n result == 100 || result == RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue());\n }\n}\n"
},
{
"path": "anti-corruption-layer/README.md",
"content": "---\ntitle: \"Anti-Corruption Layer Pattern in Java: Ensuring System Integrity Amidst Legacy Systems\"\nshortTitle: Anti-Corruption Layer\ndescription: \"Learn how the Anti-Corruption Layer design pattern helps in decoupling subsystems, preventing data corruption, and facilitating seamless integration in Java applications.\"\ncategory: Integration\nlanguage: en\ntag:\n - Architecture\n - Decoupling\n - Integration\n - Isolation\n - Layered architecture\n - Migration\n - Modernization\n - Refactoring\n - Wrapping\n---\n\n## Also known as\n\n* ACL\n* Interface layer\n* Translation layer\n\n## Intent of Anti-Corruption Layer Design Pattern\n\nThe Anti-Corruption Layer (ACL) is a crucial design pattern in Java development, particularly for system integration and maintaining data integrity. Implement a façade or adapter layer between different subsystems that don't share the same semantics. It translates between different data formats and systems, ensuring that the integration between systems does not lead to corruption of business logic or data integrity.\n\n## Detailed Explanation of Anti-Corruption Layer Pattern with Real-World Examples\n\nReal-world example\n\n> This example demonstrates how the Anti-Corruption Layer ensures seamless integration between legacy systems and modern platforms, crucial for maintaining business logic integrity during system migration.\n> \n> Imagine a large retail company transitioning its inventory management system from an old legacy software to a new modern platform. The legacy system has been in use for decades and contains complex business rules and data formats that are incompatible with the new system. Instead of directly connecting the new system to the legacy one, the company implements an Anti-Corruption Layer (ACL).\n> \n> The ACL acts as a mediator, translating and adapting data between the two systems. When the new system requests inventory data, the ACL translates the request into a format the legacy system understands, retrieves the data, and then translates it back into a format suitable for the new system. This approach ensures that the new system remains unaffected by the intricacies of the legacy system, preventing corruption of data and business logic while facilitating a smooth transition.\n\nIn plain words\n\n> The Anti-Corruption Layer design pattern protects a system from the complexities and changes of external systems by providing an intermediary translation layer.\n\n[Microsoft's documentation](https://learn.microsoft.com/en-us/azure/architecture/patterns/anti-corruption-layer) says\n\n> Implement a façade or adapter layer between different subsystems that don't share the same semantics. This layer translates requests that one subsystem makes to the other subsystem. Use this pattern to ensure that an application's design is not limited by dependencies on outside subsystems. This pattern was first described by Eric Evans in Domain-Driven Design.\n\nSequence diagram\n\n![Anti-Corruption Layer sequence diagram](./etc/anti-corruption-layer-sequence-diagram.png \"Anti-Corruption Layer sequence diagram\")\n\n## Programmatic Example of Anti-Corruption Layer Pattern in Java\n\nThe ACL design pattern in Java provides an intermediary layer that translates data formats, ensuring that integration between different systems does not lead to data corruption.\n\nHere are 2 shop-ordering systems: `Legacy` and `Modern`.\n\nThe aforementioned systems have different domain models and have to operate simultaneously. Since they work independently the orders can come either from the `Legacy` or `Modern` system. Therefore, the system that receives the legacyOrder needs to check if the legacyOrder is valid and not present in the other system. Then it can place the legacyOrder in its own system.\n\nBut for that, the system needs to know the domain model of the other system and to avoid that, the anti-corruption layer(ACL) is introduced. The ACL is a layer that translates the domain model of the `Legacy` system to the domain model of the `Modern` system and vice versa. Also, it hides all other operations with the other system, uncoupling the systems.\n\nDomain model of the `Legacy` system:\n\n```java\npublic class LegacyOrder {\n private String id;\n private String customer;\n private String item;\n private String qty;\n private String price;\n}\n```\n\nDomain model of the `Modern` system:\n\n```java\npublic class ModernOrder {\n private String id;\n private Customer customer;\n\n private Shipment shipment;\n\n private String extra;\n}\n\npublic class Customer {\n private String address;\n}\n\npublic class Shipment {\n private String item;\n private String qty;\n private String price;\n}\n```\n\nAnti-corruption layer:\n\n```java\npublic class AntiCorruptionLayer {\n\n @Autowired\n private ModernShop modernShop;\n\n @Autowired\n private LegacyShop legacyShop;\n\n public Optional findOrderInModernSystem(String id) {\n return modernShop.findOrder(id).map(o -> /* map to legacyOrder*/);\n }\n\n public Optional findOrderInLegacySystem(String id) {\n return legacyShop.findOrder(id).map(o -> /* map to modernOrder*/);\n }\n\n}\n```\n\nThe connection between the systems. Wherever the `Legacy` or `Modern` system needs to communicate with the counterpart the ACL needs to be used to avoid corrupting the current domain model. The example below shows how the `Legacy` system places an order with a validation from the `Modern` system.\n\n```java\npublic class LegacyShop {\n @Autowired\n private AntiCorruptionLayer acl;\n\n public void placeOrder(LegacyOrder legacyOrder) throws ShopException {\n\n String id = legacyOrder.getId();\n\n Optional orderInModernSystem = acl.findOrderInModernSystem(id);\n\n if (orderInModernSystem.isPresent()) {\n // order is already in the modern system\n } else {\n // place order in the current system\n }\n }\n}\n```\n\n## When to Use the Anti-Corruption Layer Pattern in Java\n\nUse this pattern when:\n\n* A migration is planned to happen over multiple stages, but integration between new and legacy systems needs to be maintained\n* Two or more subsystems have different semantics, but still need to communicate\n* When integrating with legacy systems or external systems where direct integration might pollute the domain model of the new system\n* In scenarios where different subsystems within a larger system use different data formats or structures\n* When there is a need to ensure loose coupling between different subsystems or external services to facilitate easier maintenance and scalability\n\n## Anti-Corruption Layer Pattern Java Tutorials\n\n* [Anti-Corruption Layer (Microsoft)](https://learn.microsoft.com/en-us/azure/architecture/patterns/anti-corruption-layer)\n* [Anti-Corruption Layer Pattern (Amazon)](https://docs.aws.amazon.com/prescriptive-guidance/latest/cloud-design-patterns/acl.html)\n\n## Real-World Applications of Anti-Corruption Layer Pattern in Java\n\n* Microservices architectures where individual services must communicate without being tightly coupled to each other’s data schemas\n* Enterprise systems integration, especially when integrating modern systems with legacy systems\n* In bounded contexts within Domain-Driven Design (DDD) to maintain the integrity of a domain model when interacting with external systems or subsystems\n\n## Benefits and Trade-offs of Anti-Corruption Layer Pattern\n\nBenefits:\n\n* Protects the integrity of the domain model by providing a clear boundary\n* Promotes loose coupling between systems, making the system more resilient to changes in external systems\n* Facilitates cleaner and more maintainable code by isolating integration code from business logic\n\nTrade-offs:\n\n* Introduces additional complexity and potential performance overhead due to the translation process\n* Requires extra effort in design and implementation to ensure the layer is effective without becoming a bottleneck\n* Can lead to duplication of models if not carefully managed\n\n## Related Java Design Patterns\n\n* [Adapter](https://java-design-patterns.com/patterns/adapter/): The Anti-Corruption Layer can be implemented using the Adapter pattern to translate between different data formats or structures\n* [Facade](https://java-design-patterns.com/patterns/facade/): The Anti-Corruption Layer can be seen as a specialized form of the Facade pattern that is used to isolate different subsystems\n* [Gateway](https://java-design-patterns.com/patterns/gateway/): The Anti-Corruption Layer can be used as a Gateway to external systems to provide a unified interface\n\n## References and Credits\n\n* [Domain-Driven Design: Tackling Complexity in the Heart of Software](https://amzn.to/3vptcJz)\n* [Implementing Domain-Driven Design](https://amzn.to/3ISOSRA)\n* [Patterns of Enterprise Application Architecture](https://amzn.to/3WfKBPR)\n"
},
{
"path": "anti-corruption-layer/etc/anti-corruption-layer.urm.puml",
"content": "@startuml\npackage com.iluwatar.corruption {\nclass LegacyShop {\n private Store store;\n private AntiCorruptionLayer acl;\n}\n\nclass ModernShop {\n private Store store;\n private AntiCorruptionLayer acl;\n}\n\nclass AntiCorruptionLayer{\n private LegacyShop legacyShop;\n private ModernShop modernShop;\n\n\n }\nLegacyShop ---> \"findOrderInModernSystem\" AntiCorruptionLayer\nModernShop ---> \"findOrderInLegacySystem\" AntiCorruptionLayer\nAntiCorruptionLayer ..|> ModernShop\nAntiCorruptionLayer ..|> LegacyShop\n}\n\n@enduml"
},
{
"path": "anti-corruption-layer/pom.xml",
"content": "\n\n\n \n java-design-patterns \n com.iluwatar \n 1.26.0-SNAPSHOT \n \n 4.0.0 \n anti-corruption-layer \n jar \n \n \n org.springframework.boot \n spring-boot-starter \n \n \n org.springframework.boot \n spring-boot-starter-test \n test \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.corruption.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption;\n\nimport org.springframework.boot.SpringApplication;\nimport org.springframework.boot.autoconfigure.SpringBootApplication;\n\n/**\n * This layer translates communications between the two systems, allowing one system to remain\n * unchanged while the other can avoid compromising its design and technological approach.\n */\n@SpringBootApplication\npublic class App {\n\n public static void main(String[] args) {\n SpringApplication.run(App.class, args);\n }\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/package-info.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\n/**\n * Context and problem Most applications rely on other systems for some data or functionality. For\n * example, when a legacy application is migrated to a modern system, it may still need existing\n * legacy resources. New features must be able to call the legacy system. This is especially true of\n * gradual migrations, where different features of a larger application are moved to a modern system\n * over time.\n *\n * Often these legacy systems suffer from quality issues such as convoluted data schemas or\n * obsolete APIs. The features and technologies used in legacy systems can vary widely from more\n * modern systems. To interoperate with the legacy system, the new application may need to support\n * outdated infrastructure, protocols, data models, APIs, or other features that you wouldn't\n * otherwise put into a modern application.\n *\n *
Maintaining access between new and legacy systems can force the new system to adhere to at\n * least some of the legacy system's APIs or other semantics. When these legacy features have\n * quality issues, supporting them \"corrupts\" what might otherwise be a cleanly designed modern\n * application. Similar issues can arise with any external system that your development team doesn't\n * control, not just legacy systems.\n *\n *
Solution Isolate the different subsystems by placing an anti-corruption layer between them.\n * This layer translates communications between the two systems, allowing one system to remain\n * unchanged while the other can avoid compromising its design and technological approach.\n */\npackage com.iluwatar.corruption;\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/AntiCorruptionLayer.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system;\n\nimport com.iluwatar.corruption.system.legacy.LegacyShop;\nimport com.iluwatar.corruption.system.modern.Customer;\nimport com.iluwatar.corruption.system.modern.ModernOrder;\nimport com.iluwatar.corruption.system.modern.Shipment;\nimport java.util.Optional;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\n\n/**\n * The class represents an anti-corruption layer. The main purpose of the class is to provide a\n * layer between the modern and legacy systems. The class is responsible for converting the data\n * from one system to another decoupling the systems to each other\n *\n *
It allows using one system a domain model of the other system without changing the domain\n * model of the system.\n */\n@Service\npublic class AntiCorruptionLayer {\n\n @Autowired private LegacyShop legacyShop;\n\n /**\n * The method converts the order from the legacy system to the modern system.\n *\n * @param id the id of the order\n * @return the order in the modern system\n */\n public Optional findOrderInLegacySystem(String id) {\n\n return legacyShop\n .findOrder(id)\n .map(\n o ->\n new ModernOrder(\n o.getId(),\n new Customer(o.getCustomer()),\n new Shipment(o.getItem(), o.getQty(), o.getPrice()),\n \"\"));\n }\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/DataStore.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system;\n\nimport java.util.HashMap;\nimport java.util.Optional;\n\n/**\n * The class represents a data store for the modern system.\n *\n * @param the type of the value stored in the data store\n */\npublic abstract class DataStore {\n private final HashMap inner;\n\n public DataStore() {\n inner = new HashMap<>();\n }\n\n public Optional get(String key) {\n return Optional.ofNullable(inner.get(key));\n }\n\n public Optional put(String key, V value) {\n return Optional.ofNullable(inner.put(key, value));\n }\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/ShopException.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system;\n\n/** The class represents a general exception for the shop. */\npublic class ShopException extends Exception {\n public ShopException(String message) {\n super(message);\n }\n\n /**\n * Throws an exception that the order is already placed but has an incorrect data.\n *\n * @param lhs the incoming order\n * @param rhs the existing order\n * @return the exception\n * @throws ShopException the exception\n */\n public static ShopException throwIncorrectData(String lhs, String rhs) throws ShopException {\n throw new ShopException(\n \"The order is already placed but has an incorrect data:\\n\"\n + \"Incoming order: \"\n + lhs\n + \"\\n\"\n + \"Existing order: \"\n + rhs);\n }\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/legacy/LegacyOrder.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.legacy;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\n\n/**\n * The class represents an order in the legacy system. The class is used by the legacy system to\n * store the data.\n */\n@Data\n@AllArgsConstructor\npublic class LegacyOrder {\n private String id;\n private String customer;\n\n private String item;\n private int qty;\n private int price;\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/legacy/LegacyShop.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.legacy;\n\nimport java.util.Optional;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\n\n/**\n * The class represents a legacy shop system. The main purpose is to place the order from the\n * customers.\n */\n@Service\npublic class LegacyShop {\n @Autowired private LegacyStore store;\n\n /**\n * Places the order in the legacy system. If the order is already present in the modern system,\n * then the order is placed only if the data is the same. If the order is not present in the\n * modern system, then the order is placed in the legacy system.\n */\n public void placeOrder(LegacyOrder legacyOrder) {\n store.put(legacyOrder.getId(), legacyOrder);\n }\n\n /** Finds the order in the legacy system. */\n public Optional findOrder(String orderId) {\n return store.get(orderId);\n }\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/legacy/LegacyStore.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.legacy;\n\nimport com.iluwatar.corruption.system.DataStore;\nimport org.springframework.stereotype.Service;\n\n/**\n * The class represents a data store for the legacy system. The class is used by the legacy system\n * to store the data.\n */\n@Service\npublic class LegacyStore extends DataStore {}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/modern/Customer.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.modern;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\n\n/** The class represents a customer in the modern system. */\n@Data\n@AllArgsConstructor\npublic class Customer {\n private String address;\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/modern/ModernOrder.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.modern;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\n\n/** The class represents an order in the modern system. */\n@Data\n@AllArgsConstructor\npublic class ModernOrder {\n private String id;\n private Customer customer;\n\n private Shipment shipment;\n\n private String extra;\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/modern/ModernShop.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.modern;\n\nimport com.iluwatar.corruption.system.AntiCorruptionLayer;\nimport com.iluwatar.corruption.system.ShopException;\nimport java.util.Optional;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.stereotype.Service;\n\n/**\n * The class represents a modern shop system. The main purpose of the class is to place orders and\n * find orders.\n */\n@Service\npublic class ModernShop {\n @Autowired private ModernStore store;\n\n @Autowired private AntiCorruptionLayer acl;\n\n /**\n * Places the order in the modern system. If the order is already present in the legacy system,\n * then no need to place it again.\n */\n public void placeOrder(ModernOrder order) throws ShopException {\n\n String id = order.getId();\n // check if the order is already present in the legacy system\n Optional orderInObsoleteSystem = acl.findOrderInLegacySystem(id);\n\n if (orderInObsoleteSystem.isPresent()) {\n var legacyOrder = orderInObsoleteSystem.get();\n if (!order.equals(legacyOrder)) {\n throw ShopException.throwIncorrectData(legacyOrder.toString(), order.toString());\n }\n } else {\n store.put(id, order);\n }\n }\n\n /** Finds the order in the modern system. */\n public Optional findOrder(String orderId) {\n return store.get(orderId);\n }\n}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/modern/ModernStore.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.modern;\n\nimport com.iluwatar.corruption.system.DataStore;\nimport org.springframework.stereotype.Service;\n\n/** The class represents a data store for the modern system. */\n@Service\npublic class ModernStore extends DataStore {}\n"
},
{
"path": "anti-corruption-layer/src/main/java/com/iluwatar/corruption/system/modern/Shipment.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system.modern;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\n\n/**\n * The class represents a shipment in the modern system. The class is used by the modern system to\n * store the data.\n */\n@Data\n@AllArgsConstructor\npublic class Shipment {\n private String item;\n private int qty;\n private int price;\n}\n"
},
{
"path": "anti-corruption-layer/src/main/resources/application.properties",
"content": ""
},
{
"path": "anti-corruption-layer/src/test/java/com/iluwatar/corruption/system/AntiCorruptionLayerTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.corruption.system;\n\nimport static org.junit.jupiter.api.Assertions.*;\n\nimport com.iluwatar.corruption.system.legacy.LegacyOrder;\nimport com.iluwatar.corruption.system.legacy.LegacyShop;\nimport com.iluwatar.corruption.system.modern.Customer;\nimport com.iluwatar.corruption.system.modern.ModernOrder;\nimport com.iluwatar.corruption.system.modern.ModernShop;\nimport com.iluwatar.corruption.system.modern.Shipment;\nimport java.util.Optional;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.ExtendWith;\nimport org.springframework.beans.factory.annotation.Autowired;\nimport org.springframework.boot.test.context.SpringBootTest;\nimport org.springframework.test.context.junit.jupiter.SpringExtension;\n\n@ExtendWith(SpringExtension.class)\n@SpringBootTest\npublic class AntiCorruptionLayerTest {\n\n @Autowired private LegacyShop legacyShop;\n\n @Autowired private ModernShop modernShop;\n\n /**\n * Test the anti-corruption layer. Main intention is to demonstrate how the anti-corruption layer\n * works. The 2 shops (modern and legacy) should operate independently and in the same time\n * synchronize the data.\n */\n @Test\n public void antiCorruptionLayerTest() throws ShopException {\n // a new order comes to the legacy shop.\n LegacyOrder legacyOrder = new LegacyOrder(\"1\", \"addr1\", \"item1\", 1, 1);\n // place the order in the legacy shop.\n legacyShop.placeOrder(legacyOrder);\n // the order is placed as usual since there is no other orders with the id in the both systems.\n Optional legacyOrderWithIdOne = legacyShop.findOrder(\"1\");\n assertEquals(Optional.of(legacyOrder), legacyOrderWithIdOne);\n\n // a new order (or maybe just the same order) appears in the modern shop\n ModernOrder modernOrder =\n new ModernOrder(\"1\", new Customer(\"addr1\"), new Shipment(\"item1\", 1, 1), \"\");\n // the system places it, but it checks if there is an order with the same id in the legacy shop.\n modernShop.placeOrder(modernOrder);\n\n Optional modernOrderWithIdOne = modernShop.findOrder(\"1\");\n // there is no new order placed since there is already an order with the same id in the legacy\n // shop.\n assertTrue(modernOrderWithIdOne.isEmpty());\n }\n\n /**\n * Test the anti-corruption layer when a conflict occurs between systems. This test ensures that\n * an exception is thrown when conflicting orders are placed.\n */\n @Test\n public void antiCorruptionLayerWithExTest() throws ShopException {\n // a new order comes to the legacy shop.\n LegacyOrder legacyOrder = new LegacyOrder(\"1\", \"addr1\", \"item1\", 1, 1);\n // place the order in the legacy shop.\n legacyShop.placeOrder(legacyOrder);\n // the order is placed as usual since there is no other orders with the id in the both systems.\n Optional legacyOrderWithIdOne = legacyShop.findOrder(\"1\");\n assertEquals(Optional.of(legacyOrder), legacyOrderWithIdOne);\n // a new order but with the same id and different data appears in the modern shop\n ModernOrder modernOrder =\n new ModernOrder(\"1\", new Customer(\"addr1\"), new Shipment(\"item1\", 10, 1), \"\");\n // the system rejects the order since there are 2 orders with contradiction there.\n assertThrows(ShopException.class, () -> modernShop.placeOrder(modernOrder));\n }\n}\n"
},
{
"path": "arrange-act-assert/README.md",
"content": "---\ntitle: \"Arrange/Act/Assert Pattern in Java: Enhance Testing Clarity and Simplicity\"\nshortTitle: Arrange/Act/Assert\ndescription: \"Learn how to use the Arrange/Act/Assert pattern to structure your unit tests in Java. Improve readability and maintainability of your code with clear testing phases.\"\ncategory: Testing\nlanguage: en\ntag:\n - Code simplification\n - Isolation\n - Testing\n---\n\n## Also known as\n\n* Given/When/Then\n\n## Intent of Arrange/Act/Assert Design Pattern\n\nThe Arrange/Act/Assert pattern is essential in unit testing in Java. This testing method structures unit tests clearly by dividing them into three distinct sections: setup (Arrange), execution (Act), and verification (Assert).\n\n## Detailed Explanation of Arrange/Act/Assert Pattern with Real-World Examples\n\nReal-world example\n\n> Imagine you are organizing a small event. To ensure everything runs smoothly, you follow a pattern similar to Arrange/Act/Assert:\n>\n> 1. **Arrange**: You set up the venue, prepare the guest list, arrange seating, and organize the catering.\n> 2. **Act**: You conduct the event according to the plan, welcoming guests, serving food, and following the schedule.\n> 3. **Assert**: After the event, you evaluate its success by checking guest feedback, ensuring all tasks were completed, and reviewing if everything went as planned.\n>\n> This clear separation of preparation, execution, and evaluation helps ensure the event is well-organized and successful, mirroring the structured approach of the Arrange/Act/Assert pattern in software testing.\n\nIn plain words\n\n> Arrange/Act/Assert is a testing pattern that organizes tests into three clear steps for easy maintenance.\n\nWikiWikiWeb says\n\n> Arrange/Act/Assert is a pattern for arranging and formatting code in UnitTest methods.\n\nFlowchart\n\n![Arrange/Act/Assert flowchart](./etc/arrange-act-assert-flowchart.png \"Arrange/Act/Assert flowchart\")\n\n## Programmatic Example of Arrange/Act/Assert Pattern in Java\n\nWe need to write comprehensive and clear unit test suite for a class. Using the Arrange/Act/Assert pattern in Java testing ensures clarity.\n\nLet's first introduce our `Cash` class to be unit tested.\n\n```java\npublic class Cash {\n\n private int amount;\n\n Cash(int amount) {\n this.amount = amount;\n }\n\n void plus(int addend) {\n amount += addend;\n }\n\n boolean minus(int subtrahend) {\n if (amount >= subtrahend) {\n amount -= subtrahend;\n return true;\n } else {\n return false;\n }\n }\n\n int count() {\n return amount;\n }\n}\n```\n\nThen we write our unit tests according to Arrange/Act/Assert pattern. Notice the clearly separated steps for each unit test.\n\n```java\nclass CashAAATest {\n\n @Test\n void testPlus() {\n //Arrange\n var cash = new Cash(3);\n //Act\n cash.plus(4);\n //Assert\n assertEquals(7, cash.count());\n }\n\n @Test\n void testMinus() {\n //Arrange\n var cash = new Cash(8);\n //Act\n var result = cash.minus(5);\n //Assert\n assertTrue(result);\n assertEquals(3, cash.count());\n }\n\n @Test\n void testInsufficientMinus() {\n //Arrange\n var cash = new Cash(1);\n //Act\n var result = cash.minus(6);\n //Assert\n assertFalse(result);\n assertEquals(1, cash.count());\n }\n\n @Test\n void testUpdate() {\n //Arrange\n var cash = new Cash(5);\n //Act\n cash.plus(6);\n var result = cash.minus(3);\n //Assert\n assertTrue(result);\n assertEquals(8, cash.count());\n }\n}\n```\n\n## When to Use the Arrange/Act/Assert Pattern in Java\n\nUse Arrange/Act/Assert pattern when\n\n* Unit testing, especially within the context of TDD and BDD\n* Anywhere clarity and structure are needed in test cases\n\n## Real-World Applications of Arrange/Act/Assert Pattern in Java\n\n* This pattern is particularly useful when practicing TDD and/or BDD methodologies in Java.\n* Utilized in various programming languages and testing frameworks, such as JUnit (Java), NUnit (.NET), and xUnit frameworks.\n\n## Benefits and Trade-offs of Arrange/Act/Assert Pattern\n\nBenefits:\n\n* Improved readability of tests by clearly separating the setup, action, and verification steps.\n* Easier maintenance and understanding of tests, as each test is structured in a predictable way.\n* Facilitates debugging by isolating test failures to specific phases within the test.\n\nTrade-offs:\n\n* May introduce redundancy in tests, as similar arrangements may be repeated across tests.\n* Some complex tests might not fit neatly into this structure, requiring additional context or setup outside these three phases.\n\n## Related Java Design Patterns\n\n* [Page Object](https://java-design-patterns.com/patterns/page-object/): A pattern for organizing UI tests that can be used in conjunction with Arrange/Act/Assert.\n\n## References and Credits\n\n* [The Art of Unit Testing: with examples in C#](https://amzn.to/49IbdwO)\n* [Test Driven Development: By Example](https://amzn.to/3wEwKbF)\n* [Unit Testing Principles, Practices, and Patterns: Effective testing styles, patterns, and reliable automation for unit testing, mocking, and integration testing with examples in C#](https://amzn.to/4ayjpiM)\n* [xUnit Test Patterns: Refactoring Test Code](https://amzn.to/4dHGDpm)\n* [Arrange, Act, Assert: What is AAA Testing?](https://blog.ncrunch.net/post/arrange-act-assert-aaa-testing.aspx)\n* [Bill Wake: 3A – Arrange, Act, Assert (NCrunch)](https://xp123.com/articles/3a-arrange-act-assert/)\n* [GivenWhenThen (Martin Fowler)](https://martinfowler.com/bliki/GivenWhenThen.html)\n"
},
{
"path": "arrange-act-assert/etc/arrange-act-assert.urm.puml",
"content": "@startuml\npackage com.iluwatar.arrangeactassert {\n class Cash {\n - amount : int\n ~ Cash(amount : int)\n ~ count() : int\n ~ minus(subtrahend : int) : boolean\n ~ plus(addend : int)\n }\n}\n@enduml"
},
{
"path": "arrange-act-assert/pom.xml",
"content": "\n\n\n \n java-design-patterns \n com.iluwatar \n 1.26.0-SNAPSHOT \n \n 4.0.0 \n arrange-act-assert \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n"
},
{
"path": "arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.arrangeactassert;\n\nimport lombok.AllArgsConstructor;\n\n/**\n * Arrange/Act/Assert (AAA) is a unit test pattern. In this simple example, we have a ({@link Cash})\n * object for plus, minus and counting amount.\n */\n@AllArgsConstructor\npublic class Cash {\n\n private int amount;\n\n // plus\n void plus(int addend) {\n amount += addend;\n }\n\n // minus\n boolean minus(int subtrahend) {\n if (amount >= subtrahend) {\n amount -= subtrahend;\n return true;\n } else {\n return false;\n }\n }\n\n // count\n int count() {\n return amount;\n }\n}\n"
},
{
"path": "arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.arrangeactassert;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Arrange/Act/Assert (AAA) is a pattern for organizing unit tests. It is a way to structure your\n * tests, so they're easier to read, maintain and enhance.\n *\n * It breaks tests down into three clear and distinct steps:\n *\n *
1. Arrange: Perform the setup and initialization required for the test.\n *\n *
2. Act: Take action(s) required for the test.\n *\n *
3. Assert: Verify the outcome(s) of the test.\n *\n *
This pattern has several significant benefits. It creates a clear separation between a test's\n * setup, operations, and results. This structure makes the code easier to read and understand. If\n * you place the steps in order and format your code to separate them, you can scan a test and\n * quickly comprehend what it does.\n *\n *
It also enforces a certain degree of discipline when you write your tests. You have to think\n * clearly about the three steps your test will perform. But it makes tests more natural to write at\n * the same time since you already have an outline.\n *\n *
In ({@link CashAAATest}) we have four test methods. Each of them has only one reason to change\n * and one reason to fail. In a large and complicated code base, tests that honor the single\n * responsibility principle are much easier to troubleshoot.\n */\nclass CashAAATest {\n\n @Test\n void testPlus() {\n // Arrange\n var cash = new Cash(3);\n // Act\n cash.plus(4);\n // Assert\n assertEquals(7, cash.count());\n }\n\n @Test\n void testMinus() {\n // Arrange\n var cash = new Cash(8);\n // Act\n var result = cash.minus(5);\n // Assert\n assertTrue(result);\n assertEquals(3, cash.count());\n }\n\n @Test\n void testInsufficientMinus() {\n // Arrange\n var cash = new Cash(1);\n // Act\n var result = cash.minus(6);\n // Assert\n assertFalse(result);\n assertEquals(1, cash.count());\n }\n\n @Test\n void testUpdate() {\n // Arrange\n var cash = new Cash(5);\n // Act\n cash.plus(6);\n var result = cash.minus(3);\n // Assert\n assertTrue(result);\n assertEquals(8, cash.count());\n }\n}\n"
},
{
"path": "arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.arrangeactassert;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertFalse;\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * ({@link CashAAATest}) is an anti-example of AAA pattern. This test is functionally correct, but\n * with the addition of a new feature, it needs refactoring. There are an awful lot of steps in that\n * test method, but it verifies the class' important behavior in just eleven lines. It violates the\n * single responsibility principle. If this test method failed after a small code change, it might\n * take some digging to discover why.\n */\nclass CashAntiAAATest {\n\n @Test\n void testCash() {\n // initialize\n var cash = new Cash(3);\n // test plus\n cash.plus(4);\n assertEquals(7, cash.count());\n // test minus\n cash = new Cash(8);\n assertTrue(cash.minus(5));\n assertEquals(3, cash.count());\n assertFalse(cash.minus(6));\n assertEquals(3, cash.count());\n // test update\n cash.plus(5);\n assertTrue(cash.minus(5));\n assertEquals(3, cash.count());\n }\n}\n"
},
{
"path": "async-method-invocation/README.md",
"content": "---\ntitle: \"Async Method Invocation Pattern in Java: Elevate Performance with Asynchronous Programming\"\nshortTitle: Async Method Invocation\ndescription: \"Learn about the Async Method Invocation pattern in Java for asynchronous method calls, enhancing concurrency, scalability, and responsiveness in your applications. Explore real-world examples and code implementations.\"\ncategory: Concurrency\nlanguage: en\ntag:\n - Asynchronous\n - Decoupling\n - Reactive\n - Scalability\n - Thread management\n---\n\n## Also known as\n\n* Asynchronous Procedure Call\n\n## Intent of Async Method Invocation Design Pattern\n\nThe Async Method Invocation pattern is designed to enhance concurrency by allowing methods to be called asynchronously. This pattern helps in executing parallel tasks, reducing wait times, and improving system throughput.\n\n## Detailed Explanation of Async Method Invocation Pattern with Real-World Examples\n\nReal-world example\n\n> Asynchronous method invocation enables non-blocking operations, allowing multiple processes to run concurrently. This pattern is particularly useful in applications requiring high scalability and performance, such as web servers and microservices.\n> \n> In the context of space rockets, an analogous example of the Async Method Invocation pattern can be seen in the communication between the mission control center and the onboard systems of the rocket. When mission control sends a command to the rocket to adjust its trajectory or perform a system check, they do not wait idly for the rocket to complete the task and report back. Instead, mission control continues to monitor other aspects of the mission and manage different tasks. The rocket executes the command asynchronously and sends a status update or result back to mission control once the operation is complete. This allows mission control to efficiently manage multiple concurrent operations without being blocked by any single task, similar to how asynchronous method invocation works in software systems.\n\nIn plain words\n\n> Asynchronous method invocation starts task processing and returns immediately before the task is ready. The results of the task processing are returned to the caller later.\n\nWikipedia says\n\n> In multithreaded computer programming, asynchronous method invocation (AMI), also known as asynchronous method calls or the asynchronous pattern is a design pattern in which the call site is not blocked while waiting for the called code to finish. Instead, the calling thread is notified when the reply arrives. Polling for a reply is an undesired option.\n\nSequence diagram\n\n![Async Method Invocation sequence diagram](./etc/async-method-invocation-sequence-diagram.png \"Async Method Invocation sequence diagram\")\n\n## Programmatic Example of Async Method Invocation Pattern in Java\n\nConsider a scenario where multiple tasks need to be executed simultaneously. Using the Async Method Invocation pattern, you can initiate these tasks without waiting for each to complete, thus optimizing resource usage and reducing latency.\n\nIn this example, we are launching space rockets and deploying lunar rovers.\n\nThe application demonstrates the async method invocation pattern. The key parts of the pattern are`AsyncResult` which is an intermediate container for an asynchronously evaluated value, `AsyncCallback` which can be provided to be executed on task completion and `AsyncExecutor` that manages the execution of the async tasks.\n\n```java\npublic interface AsyncResult {\n boolean isCompleted();\n\n T getValue() throws ExecutionException;\n\n void await() throws InterruptedException;\n}\n```\n\n```java\npublic interface AsyncCallback {\n void onComplete(T value);\n\n void onError(Exception ex);\n}\n```\n\n```java\npublic interface AsyncExecutor {\n AsyncResult startProcess(Callable task);\n\n AsyncResult startProcess(Callable task, AsyncCallback callback);\n\n T endProcess(AsyncResult asyncResult) throws ExecutionException, InterruptedException;\n}\n```\n\n`ThreadAsyncExecutor` is an implementation of `AsyncExecutor`. Some of its key parts are highlighted next.\n\n```java\npublic class ThreadAsyncExecutor implements AsyncExecutor {\n\n @Override\n public AsyncResult startProcess(Callable task) {\n return startProcess(task, null);\n }\n\n @Override\n public AsyncResult startProcess(Callable task, AsyncCallback callback) {\n var result = new CompletableResult<>(callback);\n new Thread(\n () -> {\n try {\n result.setValue(task.call());\n } catch (Exception ex) {\n result.setException(ex);\n }\n },\n \"executor-\" + idx.incrementAndGet())\n .start();\n return result;\n }\n\n @Override\n public T endProcess(AsyncResult asyncResult)\n throws ExecutionException, InterruptedException {\n if (!asyncResult.isCompleted()) {\n asyncResult.await();\n }\n return asyncResult.getValue();\n }\n}\n```\n\nThen we are ready to launch some rockets to see how everything works together.\n\n```java\n public static void main(String[] args) throws Exception {\n // construct a new executor that will run async tasks\n var executor = new ThreadAsyncExecutor();\n\n // start few async tasks with varying processing times, two last with callback handlers\n final var asyncResult1 = executor.startProcess(lazyval(10, 500));\n final var asyncResult2 = executor.startProcess(lazyval(\"test\", 300));\n final var asyncResult3 = executor.startProcess(lazyval(50L, 700));\n final var asyncResult4 = executor.startProcess(lazyval(20, 400),\n callback(\"Deploying lunar rover\"));\n final var asyncResult5 =\n executor.startProcess(lazyval(\"callback\", 600), callback(\"Deploying lunar rover\"));\n\n // emulate processing in the current thread while async tasks are running in their own threads\n Thread.sleep(350); // Oh boy, we are working hard here\n log(\"Mission command is sipping coffee\");\n\n // wait for completion of the tasks\n final var result1 = executor.endProcess(asyncResult1);\n final var result2 = executor.endProcess(asyncResult2);\n final var result3 = executor.endProcess(asyncResult3);\n asyncResult4.await();\n asyncResult5.await();\n\n // log the results of the tasks, callbacks log immediately when complete\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, result1));\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, result2));\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, result3));\n}\n```\n\nHere's the program console output.\n\n```\n21:47:08.227[executor-2]INFO com.iluwatar.async.method.invocation.App-Space rocket launched successfully\n21:47:08.269[main]INFO com.iluwatar.async.method.invocation.App-Mission command is sipping coffee\n21:47:08.318[executor-4]INFO com.iluwatar.async.method.invocation.App-Space rocket<20>launched successfully\n21:47:08.335[executor-4]INFO com.iluwatar.async.method.invocation.App-Deploying lunar rover<20>\n21:47:08.414[executor-1]INFO com.iluwatar.async.method.invocation.App-Space rocket<10>launched successfully\n21:47:08.519[executor-5]INFO com.iluwatar.async.method.invocation.App-Space rocket launched successfully\n21:47:08.519[executor-5]INFO com.iluwatar.async.method.invocation.App-Deploying lunar rover\n21:47:08.616[executor-3]INFO com.iluwatar.async.method.invocation.App-Space rocket<50>launched successfully\n21:47:08.617[main]INFO com.iluwatar.async.method.invocation.App-Space rocket<10>launch complete\n21:47:08.617[main]INFO com.iluwatar.async.method.invocation.App-Space rocket launch complete\n21:47:08.618[main]INFO com.iluwatar.async.method.invocation.App-Space rocket<50>launch complete\n```\n\n## When to Use the Async Method Invocation Pattern in Java\n\nThis pattern is ideal for applications needing to manage multiple parallel tasks efficiently. It is commonly used in scenarios such as handling background processes, improving user interface responsiveness, and managing asynchronous data processing.\n\nUse the async method invocation pattern when\n\n* When operations do not need to complete before proceeding with the next steps in a program.\n* For tasks that are resource-intensive or time-consuming, such as IO operations, network requests, or complex computations, where making the operation synchronous would significantly impact performance or user experience.\n* In GUI applications to prevent freezing or unresponsiveness during long-running tasks.\n* In web applications for non-blocking IO operations.\n\n## Real-World Applications of Async Method Invocation Pattern in Java\n\nMany modern applications leverage the Async Method Invocation pattern, including web servers handling concurrent requests, microservices architectures, and systems requiring intensive background processing.\n\n* Web servers handling HTTP requests asynchronously to improve throughput and reduce latency.\n* Desktop and mobile applications using background threads to perform time-consuming operations without blocking the user interface.\n* Microservices architectures where services perform asynchronous communications via messaging queues or event streams.\n* [FutureTask](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/FutureTask.html)\n* [CompletableFuture](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html)\n* [ExecutorService](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html)\n* [Task-based Asynchronous Pattern](https://msdn.microsoft.com/en-us/library/hh873175.aspx)\n\n## Benefits and Trade-offs of Async Method Invocation Pattern\n\nWhile this pattern offers significant performance benefits, it also introduces complexity in error handling and resource management. Proper implementation is essential to avoid potential pitfalls such as race conditions and deadlocks.\n\nBenefits:\n\n* Improved Responsiveness: The main thread or application flow remains unblocked, improving the user experience in GUI applications and overall responsiveness.\n* Better Resource Utilization: By enabling parallel execution, system resources (like CPU and IO) are utilized more efficiently, potentially improving the application's throughput.\n* Scalability: Easier to scale applications, as tasks can be distributed across available resources more effectively.\n\nTrade-offs:\n\n* Complexity: Introducing asynchronous operations can complicate the codebase, making it more challenging to understand, debug, and maintain.\n* Resource Management: Requires careful management of threads or execution contexts, which can introduce overhead and potential resource exhaustion issues.\n* Error Handling: Asynchronous operations can make error handling more complex, as exceptions may occur in different threads or at different times.\n\n## Related Java Design Patterns\n\nThe Async Method Invocation pattern often works well with other design patterns like the Command Pattern for encapsulating requests, the Observer Pattern for event handling, and the Promise Pattern for managing asynchronous results.\n\n* [Command](https://java-design-patterns.com/patterns/command/): Asynchronous method invocation can be used to implement the Command pattern, where commands are executed asynchronously.\n* [Observer](https://java-design-patterns.com/patterns/observer/): Asynchronous method invocation can be used to notify observers asynchronously when a subject's state changes.\n* [Promise](https://java-design-patterns.com/patterns/promise/): The AsyncResult interface can be considered a form of Promise, representing a value that may not be available yet.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3Ti1N4f)\n* [Effective Java](https://amzn.to/4cGk2Jz)\n* [Java Concurrency in Practice](https://amzn.to/4ab97VU)\n"
},
{
"path": "async-method-invocation/etc/async-method-invocation.urm.puml",
"content": "@startuml\npackage com.iluwatar.async.method.invocation {\n class App {\n - LOGGER : Logger {static}\n + App()\n - callback(name : String) : AsyncCallback {static}\n - lazyval(value : T, delayMillis : long) : Callable {static}\n - log(msg : String) {static}\n + main(args : String[]) {static}\n }\n interface AsyncCallback {\n + onComplete(T) {abstract}\n + onError(Exception) {abstract}\n }\n interface AsyncExecutor {\n + endProcess(AsyncResult) : T {abstract}\n + startProcess(Callable) : AsyncResult {abstract}\n + startProcess(Callable, AsyncCallback) : AsyncResult {abstract}\n }\n interface AsyncResult {\n + await() {abstract}\n + getValue() : T {abstract}\n + isCompleted() : boolean {abstract}\n }\n class ThreadAsyncExecutor {\n - idx : AtomicInteger\n + ThreadAsyncExecutor()\n + endProcess(asyncResult : AsyncResult) : T\n + startProcess(task : Callable) : AsyncResult\n + startProcess(task : Callable, callback : AsyncCallback) : AsyncResult\n }\n -class CompletableResult {\n ~ COMPLETED : int {static}\n ~ FAILED : int {static}\n ~ RUNNING : int {static}\n ~ callback : AsyncCallback\n ~ exception : Exception\n ~ lock : Object\n ~ state : int\n ~ value : T\n ~ CompletableResult(callback : AsyncCallback)\n + await()\n + getValue() : T\n ~ hasCallback() : boolean\n + isCompleted() : boolean\n ~ setException(exception : Exception)\n ~ setValue(value : T)\n }\n}\nThreadAsyncExecutor ..|> AsyncCallback\nThreadAsyncExecutor ..|> AsyncResult\nThreadAsyncExecutor ..|> AsyncExecutor\nCompletableResult ..+ ThreadAsyncExecutor\nCompletableResult ..|> AsyncResult\n@enduml\n"
},
{
"path": "async-method-invocation/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n async-method-invocation \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.mockito \n mockito-core \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.async.method.invocation.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\nimport java.util.concurrent.Callable;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * In this example, we are launching space rockets and deploying lunar rovers.\n *\n * The application demonstrates the async method invocation pattern. The key parts of the pattern\n * are AsyncResult which is an intermediate container for an asynchronously evaluated\n * value, AsyncCallback which can be provided to be executed on task completion and\n * AsyncExecutor that manages the execution of the async tasks.\n *\n *
The main method shows example flow of async invocations. The main thread starts multiple tasks\n * with variable durations and then continues its own work. When the main thread has done it's job\n * it collects the results of the async tasks. Two of the tasks are handled with callbacks, meaning\n * the callbacks are executed immediately when the tasks complete.\n *\n *
Noteworthy difference of thread usage between the async results and callbacks is that the\n * async results are collected in the main thread but the callbacks are executed within the worker\n * threads. This should be noted when working with thread pools.\n *\n *
Java provides its own implementations of async method invocation pattern. FutureTask,\n * CompletableFuture and ExecutorService are the real world implementations of this pattern. But due\n * to the nature of parallel programming, the implementations are not trivial. This example does not\n * take all possible scenarios into account but rather provides a simple version that helps to\n * understand the pattern.\n *\n * @see AsyncResult\n * @see AsyncCallback\n * @see AsyncExecutor\n * @see java.util.concurrent.FutureTask\n * @see java.util.concurrent.CompletableFuture\n * @see java.util.concurrent.ExecutorService\n */\n@Slf4j\npublic class App {\n\n private static final String ROCKET_LAUNCH_LOG_PATTERN = \"Space rocket <%s> launched successfully\";\n\n /** Program entry point. */\n public static void main(String[] args) throws Exception {\n // construct a new executor that will run async tasks\n var executor = new ThreadAsyncExecutor();\n\n // start few async tasks with varying processing times, two last with callback handlers\n final var asyncResult1 = executor.startProcess(lazyval(10, 500));\n final var asyncResult2 = executor.startProcess(lazyval(\"test\", 300));\n final var asyncResult3 = executor.startProcess(lazyval(50L, 700));\n final var asyncResult4 =\n executor.startProcess(lazyval(20, 400), callback(\"Deploying lunar rover\"));\n final var asyncResult5 =\n executor.startProcess(lazyval(\"callback\", 600), callback(\"Deploying lunar rover\"));\n\n // emulate processing in the current thread while async tasks are running in their own threads\n Thread.sleep(350); // Oh boy, we are working hard here\n log(\"Mission command is sipping coffee\");\n\n // wait for completion of the tasks\n final var result1 = executor.endProcess(asyncResult1);\n final var result2 = executor.endProcess(asyncResult2);\n final var result3 = executor.endProcess(asyncResult3);\n asyncResult4.await();\n asyncResult5.await();\n\n // log the results of the tasks, callbacks log immediately when complete\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, result1));\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, result2));\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, result3));\n }\n\n /**\n * Creates a callable that lazily evaluates to given value with artificial delay.\n *\n * @param value value to evaluate\n * @param delayMillis artificial delay in milliseconds\n * @return new callable for lazy evaluation\n */\n private static Callable lazyval(T value, long delayMillis) {\n return () -> {\n Thread.sleep(delayMillis);\n log(String.format(ROCKET_LAUNCH_LOG_PATTERN, value));\n return value;\n };\n }\n\n /**\n * Creates a simple callback that logs the complete status of the async result.\n *\n * @param name callback name\n * @return new async callback\n */\n private static AsyncCallback callback(String name) {\n return new AsyncCallback<>() {\n @Override\n public void onComplete(T value) {\n log(name + \" <\" + value + \">\");\n }\n\n @Override\n public void onError(Exception ex) {\n log(name + \" failed: \" + ex.getMessage());\n }\n };\n }\n\n private static void log(String msg) {\n LOGGER.info(msg);\n }\n}\n"
},
{
"path": "async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\n/**\n * AsyncCallback interface.\n *\n * @param Type of Result\n */\npublic interface AsyncCallback {\n\n /**\n * Complete handler which is executed when async task is completed.\n *\n * @param value the evaluated value from async task\n */\n void onComplete(T value);\n\n /**\n * Error handler which is executed when async task fails execution.\n *\n * @param ex exception which was thrown during async task execution(non-null)\n */\n void onError(Exception ex);\n}\n"
},
{
"path": "async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.ExecutionException;\n\n/** AsyncExecutor interface. */\npublic interface AsyncExecutor {\n\n /**\n * Starts processing of an async task. Returns immediately with async result.\n *\n * @param task task to be executed asynchronously\n * @return async result for the task\n */\n AsyncResult startProcess(Callable task);\n\n /**\n * Starts processing of an async task. Returns immediately with async result. Executes callback\n * when the task is completed.\n *\n * @param task task to be executed asynchronously\n * @param callback callback to be executed on task completion\n * @return async result for the task\n */\n AsyncResult startProcess(Callable task, AsyncCallback callback);\n\n /**\n * Ends processing of an async task. Blocks the current thread if necessary and returns the\n * evaluated value of the completed task.\n *\n * @param asyncResult async result of a task\n * @return evaluated value of the completed task\n * @throws ExecutionException if execution has failed, containing the root cause\n * @throws InterruptedException if the execution is interrupted\n */\n T endProcess(AsyncResult asyncResult) throws ExecutionException, InterruptedException;\n}\n"
},
{
"path": "async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\nimport java.util.concurrent.ExecutionException;\n\n/**\n * AsyncResult interface.\n *\n * @param parameter returned when getValue is invoked\n */\npublic interface AsyncResult {\n\n /**\n * Status of the async task execution.\n *\n * @return true if execution is completed or failed\n */\n boolean isCompleted();\n\n /**\n * Gets the value of completed async task.\n *\n * @return evaluated value or throws ExecutionException if execution has failed\n * @throws ExecutionException if execution has failed, containing the root cause\n * @throws IllegalStateException if execution is not completed\n */\n T getValue() throws ExecutionException;\n\n /**\n * Blocks the current thread until the async task is completed.\n *\n * @throws InterruptedException if the execution is interrupted\n */\n void await() throws InterruptedException;\n}\n"
},
{
"path": "async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.ExecutionException;\nimport java.util.concurrent.atomic.AtomicInteger;\n\n/** Implementation of async executor that creates a new thread for every task. */\npublic class ThreadAsyncExecutor implements AsyncExecutor {\n\n /** Index for thread naming. */\n private final AtomicInteger idx = new AtomicInteger(0);\n\n @Override\n public AsyncResult startProcess(Callable task) {\n return startProcess(task, null);\n }\n\n @Override\n public AsyncResult startProcess(Callable task, AsyncCallback callback) {\n var result = new CompletableResult<>(callback);\n new Thread(\n () -> {\n try {\n result.setValue(task.call());\n } catch (Exception ex) {\n result.setException(ex);\n }\n },\n \"executor-\" + idx.incrementAndGet())\n .start();\n return result;\n }\n\n @Override\n public T endProcess(AsyncResult asyncResult)\n throws ExecutionException, InterruptedException {\n if (!asyncResult.isCompleted()) {\n asyncResult.await();\n }\n return asyncResult.getValue();\n }\n\n /**\n * Simple implementation of async result that allows completing it successfully with a value or\n * exceptionally with an exception. A really simplified version from its real life cousins\n * FutureTask and CompletableFuture.\n *\n * @see java.util.concurrent.FutureTask\n * @see java.util.concurrent.CompletableFuture\n */\n private static class CompletableResult implements AsyncResult {\n\n static final int RUNNING = 1;\n static final int FAILED = 2;\n static final int COMPLETED = 3;\n\n final Object lock;\n final AsyncCallback callback;\n\n volatile int state = RUNNING;\n T value;\n Exception exception;\n\n CompletableResult(AsyncCallback callback) {\n this.lock = new Object();\n this.callback = callback;\n }\n\n boolean hasCallback() {\n return callback != null;\n }\n\n /**\n * Sets the value from successful execution and executes callback if available. Notifies any\n * thread waiting for completion.\n *\n * @param value value of the evaluated task\n */\n void setValue(T value) {\n this.value = value;\n this.state = COMPLETED;\n if (hasCallback()) {\n callback.onComplete(value);\n }\n synchronized (lock) {\n lock.notifyAll();\n }\n }\n\n /**\n * Sets the exception from failed execution and executes callback if available. Notifies any\n * thread waiting for completion.\n *\n * @param exception exception of the failed task\n */\n void setException(Exception exception) {\n this.exception = exception;\n this.state = FAILED;\n if (hasCallback()) {\n callback.onError(exception);\n }\n synchronized (lock) {\n lock.notifyAll();\n }\n }\n\n @Override\n public boolean isCompleted() {\n return state > RUNNING;\n }\n\n @Override\n public T getValue() throws ExecutionException {\n if (state == COMPLETED) {\n return value;\n } else if (state == FAILED) {\n throw new ExecutionException(exception);\n } else {\n throw new IllegalStateException(\"Execution not completed yet\");\n }\n }\n\n @Override\n public void await() throws InterruptedException {\n synchronized (lock) {\n while (!isCompleted()) {\n lock.wait();\n }\n }\n }\n }\n}\n"
},
{
"path": "async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Application test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n * Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutorTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.async.method.invocation;\n\nimport static java.time.Duration.ofMillis;\nimport static org.junit.jupiter.api.Assertions.*;\nimport static org.mockito.ArgumentMatchers.*;\nimport static org.mockito.Mockito.timeout;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.verifyNoMoreInteractions;\nimport static org.mockito.Mockito.when;\nimport static org.mockito.internal.verification.VerificationModeFactory.times;\n\nimport java.util.concurrent.Callable;\nimport java.util.concurrent.ExecutionException;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.mockito.ArgumentCaptor;\nimport org.mockito.Captor;\nimport org.mockito.Mock;\nimport org.mockito.MockitoAnnotations;\n\n/** ThreadAsyncExecutorTest */\nclass ThreadAsyncExecutorTest {\n\n @Captor private ArgumentCaptor exceptionCaptor;\n\n @Mock private Callable task;\n\n @Mock private AsyncCallback callback;\n\n @BeforeEach\n void setUp() {\n MockitoAnnotations.openMocks(this);\n }\n\n /** Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable)} */\n @Test\n void testSuccessfulTaskWithoutCallback() {\n assertTimeout(\n ofMillis(3000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n\n final var result = new Object();\n when(task.call()).thenReturn(result);\n\n final var asyncResult = executor.startProcess(task);\n assertNotNull(asyncResult);\n asyncResult.await(); // Prevent timing issues, and wait until the result is available\n assertTrue(asyncResult.isCompleted());\n\n // Our task should only execute once ...\n verify(task, times(1)).call();\n\n // ... and the result should be exactly the same object\n assertSame(result, asyncResult.getValue());\n });\n }\n\n /**\n * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable,\n * AsyncCallback)}\n */\n @Test\n void testSuccessfulTaskWithCallback() {\n assertTimeout(\n ofMillis(3000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n\n final var result = new Object();\n when(task.call()).thenReturn(result);\n\n final var asyncResult = executor.startProcess(task, callback);\n assertNotNull(asyncResult);\n asyncResult.await(); // Prevent timing issues, and wait until the result is available\n assertTrue(asyncResult.isCompleted());\n\n // Our task should only execute once ...\n verify(task, times(1)).call();\n\n // ... same for the callback, we expect our object\n verify(callback, times(1)).onComplete(eq(result));\n verify(callback, times(0)).onError(exceptionCaptor.capture());\n\n // ... and the result should be exactly the same object\n assertSame(result, asyncResult.getValue());\n });\n }\n\n /**\n * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable)} when a\n * task takes a while to execute\n */\n @Test\n void testLongRunningTaskWithoutCallback() {\n assertTimeout(\n ofMillis(5000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n\n final var result = new Object();\n when(task.call())\n .thenAnswer(\n i -> {\n Thread.sleep(1500);\n return result;\n });\n\n final var asyncResult = executor.startProcess(task);\n assertNotNull(asyncResult);\n assertFalse(asyncResult.isCompleted());\n\n try {\n asyncResult.getValue();\n fail(\n \"Expected IllegalStateException when calling AsyncResult#getValue on a non-completed task\");\n } catch (IllegalStateException e) {\n assertNotNull(e.getMessage());\n }\n\n // Our task should only execute once, but it can take a while ...\n verify(task, timeout(3000).times(1)).call();\n\n // Prevent timing issues, and wait until the result is available\n asyncResult.await();\n assertTrue(asyncResult.isCompleted());\n verifyNoMoreInteractions(task);\n\n // ... and the result should be exactly the same object\n assertSame(result, asyncResult.getValue());\n });\n }\n\n /**\n * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable,\n * AsyncCallback)} when a task takes a while to execute\n */\n @Test\n void testLongRunningTaskWithCallback() {\n assertTimeout(\n ofMillis(5000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n\n final var result = new Object();\n when(task.call())\n .thenAnswer(\n i -> {\n Thread.sleep(1500);\n return result;\n });\n\n final var asyncResult = executor.startProcess(task, callback);\n assertNotNull(asyncResult);\n assertFalse(asyncResult.isCompleted());\n\n verifyNoMoreInteractions(callback);\n\n try {\n asyncResult.getValue();\n fail(\n \"Expected IllegalStateException when calling AsyncResult#getValue on a non-completed task\");\n } catch (IllegalStateException e) {\n assertNotNull(e.getMessage());\n }\n\n // Our task should only execute once, but it can take a while ...\n verify(task, timeout(3000).times(1)).call();\n verify(callback, timeout(3000).times(1)).onComplete(eq(result));\n verify(callback, times(0)).onError(isA(Exception.class));\n\n // Prevent timing issues, and wait until the result is available\n asyncResult.await();\n assertTrue(asyncResult.isCompleted());\n verifyNoMoreInteractions(task, callback);\n\n // ... and the result should be exactly the same object\n assertSame(result, asyncResult.getValue());\n });\n }\n\n /**\n * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable)} when a\n * task takes a while to execute, while waiting on the result using {@link\n * ThreadAsyncExecutor#endProcess(AsyncResult)}\n */\n @Test\n void testEndProcess() {\n assertTimeout(\n ofMillis(5000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n\n final var result = new Object();\n when(task.call())\n .thenAnswer(\n i -> {\n Thread.sleep(1500);\n return result;\n });\n\n final var asyncResult = executor.startProcess(task);\n assertNotNull(asyncResult);\n assertFalse(asyncResult.isCompleted());\n\n try {\n asyncResult.getValue();\n fail(\n \"Expected IllegalStateException when calling AsyncResult#getValue on a non-completed task\");\n } catch (IllegalStateException e) {\n assertNotNull(e.getMessage());\n }\n\n assertSame(result, executor.endProcess(asyncResult));\n verify(task, times(1)).call();\n assertTrue(asyncResult.isCompleted());\n\n // Calling end process a second time while already finished should give the same result\n assertSame(result, executor.endProcess(asyncResult));\n verifyNoMoreInteractions(task);\n });\n }\n\n /**\n * Test used to verify the behaviour of {@link ThreadAsyncExecutor#startProcess(Callable)} when\n * the callable is 'null'\n */\n @Test\n void testNullTask() {\n assertTimeout(\n ofMillis(3000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n final var asyncResult = executor.startProcess(null);\n\n assertNotNull(\n asyncResult,\n \"The AsyncResult should not be 'null', even though the task was 'null'.\");\n asyncResult.await(); // Prevent timing issues, and wait until the result is available\n assertTrue(asyncResult.isCompleted());\n\n try {\n asyncResult.getValue();\n fail(\"Expected ExecutionException with NPE as cause\");\n } catch (final ExecutionException e) {\n assertNotNull(e.getMessage());\n assertNotNull(e.getCause());\n assertEquals(NullPointerException.class, e.getCause().getClass());\n }\n });\n }\n\n /**\n * Test used to verify the behaviour of {@link ThreadAsyncExecutor#startProcess(Callable,\n * AsyncCallback)} when the callable is 'null', but the asynchronous callback is provided\n */\n @Test\n void testNullTaskWithCallback() {\n assertTimeout(\n ofMillis(3000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n final var asyncResult = executor.startProcess(null, callback);\n\n assertNotNull(\n asyncResult,\n \"The AsyncResult should not be 'null', even though the task was 'null'.\");\n asyncResult.await(); // Prevent timing issues, and wait until the result is available\n assertTrue(asyncResult.isCompleted());\n verify(callback, times(0)).onComplete(any());\n verify(callback, times(1)).onError(exceptionCaptor.capture());\n\n final var exception = exceptionCaptor.getValue();\n assertNotNull(exception);\n\n assertEquals(NullPointerException.class, exception.getClass());\n\n try {\n asyncResult.getValue();\n fail(\"Expected ExecutionException with NPE as cause\");\n } catch (final ExecutionException e) {\n assertNotNull(e.getMessage());\n assertNotNull(e.getCause());\n assertEquals(NullPointerException.class, e.getCause().getClass());\n }\n });\n }\n\n /**\n * Test used to verify the behaviour of {@link ThreadAsyncExecutor#startProcess(Callable,\n * AsyncCallback)} when both the callable and the asynchronous callback are 'null'\n */\n @Test\n void testNullTaskWithNullCallback() {\n assertTimeout(\n ofMillis(3000),\n () -> {\n // Instantiate a new executor and start a new 'null' task ...\n final var executor = new ThreadAsyncExecutor();\n final var asyncResult = executor.startProcess(null, null);\n\n assertNotNull(\n asyncResult,\n \"The AsyncResult should not be 'null', even though the task and callback were 'null'.\");\n asyncResult.await(); // Prevent timing issues, and wait until the result is available\n assertTrue(asyncResult.isCompleted());\n\n try {\n asyncResult.getValue();\n fail(\"Expected ExecutionException with NPE as cause\");\n } catch (final ExecutionException e) {\n assertNotNull(e.getMessage());\n assertNotNull(e.getCause());\n assertEquals(NullPointerException.class, e.getCause().getClass());\n }\n });\n }\n}\n"
},
{
"path": "backpressure/README.md",
"content": "---\ntitle: \"Backpressure Pattern in Java: Gracefully regulate producer-to-consumer data flow to prevent overload.\"\nshortTitle: Backpressure\ndescription: \"Dive into the Backpressure design pattern in Java through practical examples, discovering how it prevents overload while ensuring stability and peak performance by aligning data flow with consumer capacity.\"\ncategory: Concurrency\nlanguage: en\ntag:\n - Asynchronous\n - Event-driven\n - Reactive\n - Resilience\n---\n\n## Also known as\n\n* Flow Control\n* Rate Limiting Mechanism\n\n## Intent of the Backpressure Design Pattern\n\nControl the rate of data production so downstream consumers are not overwhelmed by excessive load.\n\n## Detailed Explanation of Backpressure Pattern with Real-World Examples\n\nReal-world example\n\n> Imagine a busy coffee shop where multiple baristas brew drinks (producers), and a single barista is responsible for carefully crafting latte art (consumer). If drinks are brewed faster than the latte-art barista can decorate them, they pile up, risking quality issues or discarded drinks. By introducing a pacing system—only sending new cups once the latte-art barista is ready—everyone stays synchronized, ensuring minimal waste and a consistently enjoyable customer experience.\n\nIn plain words\n\n> The Backpressure design pattern is a flow control mechanism that prevents overwhelming a system by regulating data production based on the consumer’s processing capacity.\n\nWikipedia says\n\n> Back pressure (or backpressure) is the term for a resistance to the desired flow of fluid through pipes. Obstructions or tight bends create backpressure via friction loss and pressure drop. In distributed systems in particular event-driven architecture, back pressure is a technique to regulate flow of data, ensuring that components do not become overwhelmed.\n\nSequence diagram\n\n\n\n## Programmatic Example of Backpressure Pattern in Java\n\nThis example demonstrates how backpressure can be implemented using Project Reactor. We begin by creating a simple publisher that emits a stream of integers, introducing a small delay to mimic a slower production rate:\n\n```java\npublic class Publisher {\n public static Flux publish(int start, int count, int delay) {\n return Flux.range(start, count).delayElements(Duration.ofMillis(delay)).log();\n }\n}\n```\n\nNext, we define a custom subscriber by extending Reactor’s BaseSubscriber. It simulates slow processing by sleeping for 500ms per item. Initially, the subscriber requests ten items; for every five items processed, it requests five more:\n\n```java\npublic class Subscriber extends BaseSubscriber {\n\n private static final Logger logger = LoggerFactory.getLogger(Subscriber.class);\n\n @Override\n protected void hookOnSubscribe(@NonNull Subscription subscription) {\n logger.info(\"subscribe()\");\n request(10); //request 10 items initially\n }\n\n @Override\n protected void hookOnNext(@NonNull Integer value) {\n processItem();\n logger.info(\"process({})\", value);\n if (value % 5 == 0) {\n // request for the next 5 items after processing first 5\n request(5);\n }\n }\n\n @Override\n protected void hookOnComplete() {\n //completed processing.\n }\n\n private void processItem() {\n try {\n Thread.sleep(500); // simulate slow processing\n } catch (InterruptedException e) {\n logger.error(e.getMessage(), e);\n }\n }\n}\n```\n\nFinally, in the `main` method, we publish a range of integers and subscribe using the custom subscriber. A short sleep in the main thread allows the emission, backpressure requests, and processing to be fully observed:\n\n```java\npublic static void main(String[] args) throws InterruptedException {\n Subscriber sub = new Subscriber();\n Publisher.publish(1, 8, 200).subscribe(sub);\n Thread.sleep(5000); //wait for execution\n \n}\n```\n\nBelow is an example of the program’s output. It shows the subscriber’s log entries, including when it requests more data and when each integer is processed:\n\n```\n23:09:55.746 [main] DEBUG reactor.util.Loggers -- Using Slf4j logging framework\n23:09:55.762 [main] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onSubscribe(FluxConcatMapNoPrefetch.FluxConcatMapNoPrefetchSubscriber)\n23:09:55.762 [main] INFO com.iluwatar.backpressure.Subscriber -- subscribe()\n23:09:55.763 [main] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- request(10)\n23:09:55.969 [parallel-1] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(1)\n23:09:56.475 [parallel-1] INFO com.iluwatar.backpressure.Subscriber -- process(1)\n23:09:56.680 [parallel-2] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(2)\n23:09:57.185 [parallel-2] INFO com.iluwatar.backpressure.Subscriber -- process(2)\n23:09:57.389 [parallel-3] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(3)\n23:09:57.894 [parallel-3] INFO com.iluwatar.backpressure.Subscriber -- process(3)\n23:09:58.099 [parallel-4] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(4)\n23:09:58.599 [parallel-4] INFO com.iluwatar.backpressure.Subscriber -- process(4)\n23:09:58.805 [parallel-5] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(5)\n23:09:59.311 [parallel-5] INFO com.iluwatar.backpressure.Subscriber -- process(5)\n23:09:59.311 [parallel-5] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- request(5)\n23:09:59.516 [parallel-6] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(6)\n23:10:00.018 [parallel-6] INFO com.iluwatar.backpressure.Subscriber -- process(6)\n23:10:00.223 [parallel-7] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(7)\n23:10:00.729 [parallel-7] INFO com.iluwatar.backpressure.Subscriber -- process(7)\n23:10:00.930 [parallel-8] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onNext(8)\n23:10:01.436 [parallel-8] INFO com.iluwatar.backpressure.Subscriber -- process(8)\n23:10:01.437 [parallel-8] INFO reactor.Flux.ConcatMapNoPrefetch.1 -- onComplete()\n```\n\n## When to Use the Backpressure Pattern In Java\n\n* Use in Java systems where data is produced at high velocity and consumers risk overload.\n* Applicable in reactive or event-driven architectures to maintain stability under varying load conditions.\n\n## Benefits and Trade-offs of Backpressure Pattern\n\nBenefits:\n\n* Protects consumers from saturation and resource exhaustion.\n\nTrade-offs:\n\n* Introduces possible delays if production must slow down to match consumer capacity.\n* Requires careful orchestration in complex systems with multiple concurrent data sources.\n\n## Related Java Design Patterns\n\n* [Observer Pattern](https://java-design-patterns.com/patterns/observer/): Both patterns involve a producer notifying consumers. Observer is synchronous and tightly coupled (observers know the subject).\n* [Publish-Subscribe Pattern](https://java-design-patterns.com/patterns/publish-subscribe/): Both patterns deal with asynchronous data flow and can work together to manage message distribution and consumption effectively.\n\n## References and Credits\n\n* [Backpressure Explained (RedHat Developers Blog)](https://developers.redhat.com/articles/backpressure-explained)\n* [Hands-On Reactive Programming in Spring 5](https://amzn.to/3YuYfyO)\n* [Reactive Programming with RxJava: Creating Asynchronous, Event-Based Applications](https://amzn.to/42negbf)\n* [Reactive Streams in Java](https://amzn.to/3RJjUzA)\n* [Reactive Streams Specification](https://www.reactive-streams.org/)\n"
},
{
"path": "backpressure/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n\n backpressure \n\n \n \n io.projectreactor \n reactor-core \n 3.8.0-M1 \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n io.projectreactor \n reactor-test \n 3.8.0-RC1 \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.backpressure.App \n \n \n \n \n \n \n \n \n "
},
{
"path": "backpressure/src/main/java/com/iluwatar/backpressure/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport java.util.concurrent.CountDownLatch;\n\n/**\n * The Backpressure pattern is a flow control mechanism. It allows a consumer to signal to a\n * producer to slow down or stop sending data when it's overwhelmed.\n * Prevents memory overflow, CPU thrashing, and resource exhaustion.\n * Ensures fair usage of resources in distributed systems.\n * Avoids buffer bloat and latency spikes. Key concepts of this design paradigm involves\n * Publisher/Producer: Generates data.\n * Subscriber/Consumer: Receives and processes data.\n *\n * In this example we will create a {@link Publisher} and a {@link Subscriber}. Publisher\n * will emit a stream of integer values with a predefined delay. Subscriber takes 500 ms to\n * process one integer. Since the subscriber can't process the items fast enough we apply\n * backpressure to the publisher so that it will request 10 items first, process 5 items and\n * request for the next 5 again. After processing 5 items subscriber will keep requesting for\n * another 5 until the stream ends.\n */\npublic class App {\n\n protected static CountDownLatch latch;\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(String[] args) throws InterruptedException {\n\n /*\n * This custom subscriber applies backpressure:\n * - Has a processing delay of 0.5 milliseconds\n * - Requests 10 items initially\n * - Process 5 items and request for the next 5 items\n */\n Subscriber sub = new Subscriber();\n // slow publisher emit 15 numbers with a delay of 200 milliseconds\n Publisher.publish(1, 17, 200).subscribe(sub);\n\n latch = new CountDownLatch(1);\n latch.await();\n\n sub = new Subscriber();\n // fast publisher emit 15 numbers with a delay of 1 millisecond\n Publisher.publish(1, 17, 1).subscribe(sub);\n\n latch = new CountDownLatch(1);\n latch.await();\n }\n}\n"
},
{
"path": "backpressure/src/main/java/com/iluwatar/backpressure/Publisher.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport java.time.Duration;\nimport reactor.core.publisher.Flux;\n\n/** This class is the publisher that generates the data stream. */\npublic class Publisher {\n\n private Publisher() {}\n\n /**\n * On message method will trigger when the subscribed event is published.\n *\n * @param start starting integer\n * @param count how many integers to emit\n * @param delay delay between each item in milliseconds\n * @return a flux stream of integers\n */\n public static Flux publish(int start, int count, int delay) {\n return Flux.range(start, count).delayElements(Duration.ofMillis(delay)).log();\n }\n}\n"
},
{
"path": "backpressure/src/main/java/com/iluwatar/backpressure/Subscriber.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport lombok.NonNull;\nimport lombok.extern.slf4j.Slf4j;\nimport org.reactivestreams.Subscription;\nimport reactor.core.publisher.BaseSubscriber;\n\n/** This class is the custom subscriber that subscribes to the data stream. */\n@Slf4j\npublic class Subscriber extends BaseSubscriber {\n\n @Override\n protected void hookOnSubscribe(@NonNull Subscription subscription) {\n request(10); // request 10 items initially\n }\n\n @Override\n protected void hookOnNext(@NonNull Integer value) {\n processItem();\n LOGGER.info(\"process({})\", value);\n if (value % 5 == 0) {\n // request for the next 5 items after processing first 5\n request(5);\n }\n }\n\n @Override\n protected void hookOnComplete() {\n App.latch.countDown();\n }\n\n private void processItem() {\n try {\n Thread.sleep(500); // simulate slow processing\n } catch (InterruptedException e) {\n LOGGER.error(e.getMessage(), e);\n Thread.currentThread().interrupt();\n }\n }\n}\n"
},
{
"path": "backpressure/src/test/java/com/iluwatar/backpressure/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\npublic class AppTest {\n\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "backpressure/src/test/java/com/iluwatar/backpressure/LoggerExtension.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport ch.qos.logback.classic.Logger;\nimport ch.qos.logback.classic.spi.ILoggingEvent;\nimport ch.qos.logback.core.read.ListAppender;\nimport java.util.List;\nimport java.util.stream.Collectors;\nimport org.junit.jupiter.api.extension.AfterEachCallback;\nimport org.junit.jupiter.api.extension.BeforeEachCallback;\nimport org.junit.jupiter.api.extension.ExtensionContext;\nimport org.slf4j.LoggerFactory;\n\npublic class LoggerExtension implements BeforeEachCallback, AfterEachCallback {\n\n private final ListAppender listAppender = new ListAppender<>();\n private final Logger logger = (Logger) LoggerFactory.getLogger(Logger.ROOT_LOGGER_NAME);\n\n @Override\n public void afterEach(ExtensionContext extensionContext) {\n listAppender.stop();\n listAppender.list.clear();\n logger.detachAppender(listAppender);\n }\n\n @Override\n public void beforeEach(ExtensionContext extensionContext) {\n logger.addAppender(listAppender);\n listAppender.start();\n }\n\n public List getFormattedMessages() {\n return listAppender.list.stream()\n .map(ILoggingEvent::getFormattedMessage)\n .collect(Collectors.toList());\n }\n}\n"
},
{
"path": "backpressure/src/test/java/com/iluwatar/backpressure/PublisherTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport static com.iluwatar.backpressure.Publisher.publish;\n\nimport java.time.Duration;\nimport org.junit.jupiter.api.Test;\nimport reactor.core.publisher.Flux;\nimport reactor.test.StepVerifier;\n\npublic class PublisherTest {\n\n @Test\n public void testPublish() {\n\n Flux flux = publish(1, 3, 200);\n\n StepVerifier.withVirtualTime(() -> flux)\n .expectSubscription()\n .expectNoEvent(Duration.ofMillis(200))\n .expectNext(1)\n .expectNoEvent(Duration.ofSeconds(200))\n .expectNext(2)\n .expectNoEvent(Duration.ofSeconds(200))\n .expectNext(3)\n .verifyComplete();\n }\n}\n"
},
{
"path": "backpressure/src/test/java/com/iluwatar/backpressure/SubscriberTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.backpressure;\n\nimport static org.junit.jupiter.api.Assertions.assertTrue;\n\nimport java.util.concurrent.CountDownLatch;\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.extension.RegisterExtension;\n\npublic class SubscriberTest {\n\n @RegisterExtension public LoggerExtension loggerExtension = new LoggerExtension();\n\n @Test\n public void testSubscribe() throws InterruptedException {\n\n Subscriber sub = new Subscriber();\n Publisher.publish(1, 8, 100).subscribe(sub);\n\n App.latch = new CountDownLatch(1);\n App.latch.await();\n\n String result = String.join(\",\", loggerExtension.getFormattedMessages());\n assertTrue(\n result.endsWith(\n \"onSubscribe(FluxConcatMapNoPrefetch.\"\n + \"FluxConcatMapNoPrefetchSubscriber),request(10),onNext(1),process(1),onNext(2),\"\n + \"process(2),onNext(3),process(3),onNext(4),process(4),onNext(5),process(5),request(5),\"\n + \"onNext(6),process(6),onNext(7),process(7),onNext(8),process(8),onComplete()\"));\n }\n}\n"
},
{
"path": "balking/README.md",
"content": "---\ntitle: \"Balking Pattern in Java: Smart Control Over Java Execution\"\nshortTitle: Balking\ndescription: \"Learn the Balking design pattern in Java, a concurrency pattern that prevents code execution in inappropriate states. Discover examples, use cases, and benefits.\"\ncategory: Concurrency\nlanguage: en\ntag:\n - Concurrency\n - Decoupling\n - Fault tolerance\n - Synchronization\n---\n\n## Intent of Balking Design Pattern\n\nThe Balking Pattern in Java is a concurrency design pattern that prevents an object from executing certain code if it is in an incomplete or inappropriate state. This pattern is crucial for managing state and concurrency in multithreaded Java applications.\n\n## Detailed Explanation of Balking Pattern with Real-World Examples\n\nReal-world example\n\n> A real-world analogy of the Balking design pattern can be seen in a laundry service. Imagine a washing machine at a laundromat that only starts washing clothes if the door is properly closed and locked. If a user tries to start the machine while the door is open, the machine balks and does nothing. This ensures that the washing process only begins when it is safe to do so, preventing water spillage and potential damage to the machine. Similarly, the Balking pattern in software design ensures that operations are only executed when the object is in an appropriate state, preventing erroneous actions and maintaining system stability.\n\nIn plain words\n\n> Using the balking pattern, a certain code executes only if the object is in particular state.\n\nWikipedia says\n\n> The balking pattern is a software design pattern that only executes an action on an object when the object is in a particular state. For example, if an object reads ZIP files and a calling method invokes a get method on the object when the ZIP file is not open, the object would \"balk\" at the request.\n\nFlowchart\n\n\n\n## Programmatic Example of Balking Pattern in Java\n\nThis example demonstrates the Balking Pattern in a multithreaded Java application, highlighting state management and concurrency control. The Balking Pattern is exemplified by a washing machine's start button that initiates washing only if the machine is idle. This ensures state management and prevents concurrent issues.\n\nThere's a start-button in a washing machine to initiate the laundry washing. When the washing machine is inactive the button works as expected, but if it's already washing the button does nothing.\n\nIn this example implementation, `WashingMachine` is an object that has two states in which it can be: ENABLED and WASHING. If the machine is ENABLED, the state changes to WASHING using a thread-safe method. On the other hand, if it already has been washing and any other thread executes `wash`it won't do that and returns without doing anything.\n\nHere are the relevant parts of the `WashingMachine` class.\n\n```java\n\n@Slf4j\npublic class WashingMachine {\n\n private final DelayProvider delayProvider;\n private WashingMachineState washingMachineState;\n\n public WashingMachine(DelayProvider delayProvider) {\n this.delayProvider = delayProvider;\n this.washingMachineState = WashingMachineState.ENABLED;\n }\n\n public WashingMachineState getWashingMachineState() {\n return washingMachineState;\n }\n\n public void wash() {\n synchronized (this) {\n var machineState = getWashingMachineState();\n LOGGER.info(\"{}: Actual machine state: {}\", Thread.currentThread().getName(), machineState);\n if (this.washingMachineState == WashingMachineState.WASHING) {\n LOGGER.error(\"Cannot wash if the machine has been already washing!\");\n return;\n }\n this.washingMachineState = WashingMachineState.WASHING;\n }\n LOGGER.info(\"{}: Doing the washing\", Thread.currentThread().getName());\n this.delayProvider.executeAfterDelay(50, TimeUnit.MILLISECONDS, this::endOfWashing);\n }\n\n public synchronized void endOfWashing() {\n washingMachineState = WashingMachineState.ENABLED;\n LOGGER.info(\"{}: Washing completed.\", Thread.currentThread().getId());\n }\n}\n```\n\nHere's the simple `DelayProvider` interface used by the `WashingMachine`.\n\n```java\npublic interface DelayProvider {\n void executeAfterDelay(long interval, TimeUnit timeUnit, Runnable task);\n}\n```\n\nNow, we introduce the application using the `WashingMachine`.\n\n```java\npublic static void main(String... args) {\n final var washingMachine = new WashingMachine();\n var executorService = Executors.newFixedThreadPool(3);\n for (int i = 0; i < 3; i++) {\n executorService.execute(washingMachine::wash);\n }\n executorService.shutdown();\n try {\n if (!executorService.awaitTermination(10, TimeUnit.SECONDS)) {\n executorService.shutdownNow();\n }\n } catch (InterruptedException ie) {\n LOGGER.error(\"ERROR: Waiting on executor service shutdown!\");\n Thread.currentThread().interrupt();\n }\n}\n```\n\nHere is the console output of the program.\n\n```\n14:02:52.268 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-2: Actual machine state: ENABLED\n14:02:52.272 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-2: Doing the washing\n14:02:52.272 [pool-1-thread-3] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-3: Actual machine state: WASHING\n14:02:52.273 [pool-1-thread-3] ERROR com.iluwatar.balking.WashingMachine - Cannot wash if the machine has been already washing!\n14:02:52.273 [pool-1-thread-1] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-1: Actual machine state: WASHING\n14:02:52.273 [pool-1-thread-1] ERROR com.iluwatar.balking.WashingMachine - Cannot wash if the machine has been already washing!\n14:02:52.324 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - 14: Washing completed.\n```\n\n## When to Use the Balking Pattern in Java\n\nUse the Balking pattern when\n\n* You want to invoke an action on an object only when it is in a particular state\n* Objects are generally only in a state that is prone to balking temporarily but for an unknown amount of time\n* In multithreaded applications where certain actions should only proceed when specific conditions are met, and those conditions are expected to change over time due to external factors or concurrent operations.\n\n## Real-World Applications of Balking Pattern in Java\n\n* Resource pooling, where resources are only allocated if they are in a valid state for allocation.\n* Thread management, where threads only proceed with tasks if certain conditions (like task availability or resource locks) are met.\n\n## Benefits and Trade-offs of Balking Pattern\n\nBenefits:\n\n* Reduces unnecessary lock acquisitions in situations where actions cannot proceed, enhancing performance in concurrent applications.\n* Encourages clear separation of state management and behavior, leading to cleaner code.\n* Simplifies the handling of operations that should only be performed under certain conditions without cluttering the caller code with state checks.\n\nTrade-offs:\n\n* Can introduce complexity by obscuring the conditions under which actions are taken or ignored, potentially making the system harder to debug and understand.\n* May lead to missed opportunities or actions if the state changes are not properly monitored or if the balking condition is too restrictive.\n\n## Related Java Design Patterns\n\n* [Double-Checked Locking](https://java-design-patterns.com/patterns/double-checked-locking/): Ensures that initialization occurs only when necessary and avoids unnecessary locking, which is related to Balking in terms of conditionally executing logic based on the object's state.\n* [Guarded Suspension](https://java-design-patterns.com/patterns/guarded-suspension/): Similar in ensuring actions are only performed when an object is in a certain state, but typically involves waiting until the state is valid.\n* [State](https://java-design-patterns.com/patterns/state/): The State pattern can be used in conjunction with Balking to manage the states and transitions of the object.\n\n## References and Credits\n\n* [Concurrent Programming in Java : Design Principles and Patterns](https://amzn.to/4dIBqxL)\n* [Java Concurrency in Practice](https://amzn.to/4aRMruW)\n* [Patterns in Java: A Catalog of Reusable Design Patterns Illustrated with UML](https://amzn.to/4bOtzwF)\n"
},
{
"path": "balking/etc/balking.ucls",
"content": "\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n "
},
{
"path": "balking/etc/balking.urm.puml",
"content": "@startuml\npackage com.iluwatar.balking {\n class App {\n - LOGGER : Logger {static}\n + App()\n + main(args : String[]) {static}\n }\n interface DelayProvider {\n + executeAfterDelay(long, TimeUnit, Runnable) {abstract}\n }\n class WashingMachine {\n - LOGGER : Logger {static}\n - delayProvider : DelayProvider\n - washingMachineState : WashingMachineState\n + WashingMachine()\n + WashingMachine(delayProvider : DelayProvider)\n + endOfWashing()\n + getWashingMachineState() : WashingMachineState\n + wash()\n }\n enum WashingMachineState {\n + ENABLED {static}\n + WASHING {static}\n + valueOf(name : String) : WashingMachineState {static}\n + values() : WashingMachineState[] {static}\n }\n}\nWashingMachine --> \"-washingMachineState\" WashingMachineState\nWashingMachine --> \"-delayProvider\" DelayProvider\n@enduml"
},
{
"path": "balking/pom.xml",
"content": "\n\n\n \n java-design-patterns \n com.iluwatar \n 1.26.0-SNAPSHOT \n \n 4.0.0 \n balking \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.balking.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "balking/src/main/java/com/iluwatar/balking/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.balking;\n\nimport java.util.concurrent.Executors;\nimport java.util.concurrent.TimeUnit;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * In Balking Design Pattern if an object’s method is invoked when it is in an inappropriate state,\n * then the method will return without doing anything. Objects that use this pattern are generally\n * only in a state that is prone to balking temporarily but for an unknown amount of time\n *\n * In this example implementation, {@link WashingMachine} is an object that has two states in\n * which it can be: ENABLED and WASHING. If the machine is ENABLED, the state changes to WASHING\n * using a thread-safe method. On the other hand, if it already has been washing and any other\n * thread executes {@link WashingMachine#wash()} it won't do that and returns without doing\n * anything.\n */\n@Slf4j\npublic class App {\n\n /**\n * Entry Point.\n *\n * @param args the command line arguments - not used\n */\n public static void main(String... args) {\n final var washingMachine = new WashingMachine();\n var executorService = Executors.newFixedThreadPool(3);\n for (int i = 0; i < 3; i++) {\n executorService.execute(washingMachine::wash);\n }\n executorService.shutdown();\n try {\n if (!executorService.awaitTermination(10, TimeUnit.SECONDS)) {\n executorService.shutdownNow();\n }\n } catch (InterruptedException ie) {\n LOGGER.error(\"ERROR: Waiting on executor service shutdown!\");\n Thread.currentThread().interrupt();\n }\n }\n}\n"
},
{
"path": "balking/src/main/java/com/iluwatar/balking/DelayProvider.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.balking;\n\nimport java.util.concurrent.TimeUnit;\n\n/** An interface to simulate delay while executing some work. */\npublic interface DelayProvider {\n void executeAfterDelay(long interval, TimeUnit timeUnit, Runnable task);\n}\n"
},
{
"path": "balking/src/main/java/com/iluwatar/balking/WashingMachine.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.balking;\n\nimport java.util.concurrent.TimeUnit;\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\n\n/** Washing machine class. */\n@Slf4j\npublic class WashingMachine {\n\n private final DelayProvider delayProvider;\n\n @Getter private WashingMachineState washingMachineState;\n\n /** Creates a new instance of WashingMachine. */\n public WashingMachine() {\n this(\n (interval, timeUnit, task) -> {\n try {\n Thread.sleep(timeUnit.toMillis(interval));\n } catch (InterruptedException ie) {\n LOGGER.error(\"\", ie);\n Thread.currentThread().interrupt();\n }\n task.run();\n });\n }\n\n /**\n * Creates a new instance of WashingMachine using provided delayProvider. This constructor is used\n * only for unit testing purposes.\n */\n public WashingMachine(DelayProvider delayProvider) {\n this.delayProvider = delayProvider;\n this.washingMachineState = WashingMachineState.ENABLED;\n }\n\n /** Method responsible for washing if the object is in appropriate state. */\n public void wash() {\n synchronized (this) {\n var machineState = getWashingMachineState();\n LOGGER.info(\"{}: Actual machine state: {}\", Thread.currentThread().getName(), machineState);\n if (this.washingMachineState == WashingMachineState.WASHING) {\n LOGGER.error(\"Cannot wash if the machine has been already washing!\");\n return;\n }\n this.washingMachineState = WashingMachineState.WASHING;\n }\n LOGGER.info(\"{}: Doing the washing\", Thread.currentThread().getName());\n\n this.delayProvider.executeAfterDelay(50, TimeUnit.MILLISECONDS, this::endOfWashing);\n }\n\n /** Method is responsible for ending the washing by changing machine state. */\n public synchronized void endOfWashing() {\n washingMachineState = WashingMachineState.ENABLED;\n LOGGER.info(\"{}: Washing completed.\", Thread.currentThread().getId());\n }\n}\n"
},
{
"path": "balking/src/main/java/com/iluwatar/balking/WashingMachineState.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.balking;\n\n/**\n * WashingMachineState enum describes in which state machine is, it can be enabled and ready to work\n * as well as during washing.\n */\npublic enum WashingMachineState {\n ENABLED,\n WASHING\n}\n"
},
{
"path": "balking/src/test/java/com/iluwatar/balking/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.balking;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\nimport org.junit.jupiter.api.function.Executable;\n\n/** Application test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n *
Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow((Executable) App::main);\n }\n}\n"
},
{
"path": "balking/src/test/java/com/iluwatar/balking/WashingMachineTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.balking;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.util.concurrent.TimeUnit;\nimport org.junit.jupiter.api.Test;\n\n/** Tests for {@link WashingMachine} */\nclass WashingMachineTest {\n\n private final FakeDelayProvider fakeDelayProvider = new FakeDelayProvider();\n\n @Test\n void wash() {\n var washingMachine = new WashingMachine(fakeDelayProvider);\n\n washingMachine.wash();\n washingMachine.wash();\n\n var machineStateGlobal = washingMachine.getWashingMachineState();\n\n fakeDelayProvider.task.run();\n\n // washing machine remains in washing state\n assertEquals(WashingMachineState.WASHING, machineStateGlobal);\n\n // washing machine goes back to enabled state\n assertEquals(WashingMachineState.ENABLED, washingMachine.getWashingMachineState());\n }\n\n @Test\n void endOfWashing() {\n var washingMachine = new WashingMachine();\n washingMachine.wash();\n assertEquals(WashingMachineState.ENABLED, washingMachine.getWashingMachineState());\n }\n\n private static class FakeDelayProvider implements DelayProvider {\n private Runnable task;\n\n @Override\n public void executeAfterDelay(long interval, TimeUnit timeUnit, Runnable task) {\n this.task = task;\n }\n }\n}\n"
},
{
"path": "bloc/README.md",
"content": "---\ntitle: \"Bloc Pattern in Java: State Management Simplified\"\nshortTitle: Bloc\ndescription: \"Learn how the Bloc pattern helps manage state changes in Java applications. This guide covers dynamic listener management, real-world examples, and clean code practices for state management.\"\ncategory: Architectural\nlanguage: en\ntag:\n - Abstraction\n - Data binding\n - Decoupling\n - Event-driven\n - Presentation\n - Reactive\n - Reusability\n - State tracking\n---\n\n## Also known as\n\n* Business Logic Component\n* Business Logic Controller\n\n## Intent of the Bloc Pattern\n\nThe Bloc pattern manages the state of an object and allows for dynamically notifying interested listeners about state changes. It separates state management logic from the rest of the application, improving code organization and flexibility.\n\n## Detailed explanation of the Bloc pattern with real-World examples\n\nReal-world example\n\n> Consider a digital counter application where multiple parts of the UI need to be updated whenever the counter changes. For example, a label displaying the counter value and an activity log showing changes. Instead of directly modifying these UI components, the Bloc pattern manages the counter state and notifies all registered listeners about the state change. Listeners can dynamically subscribe or unsubscribe from receiving updates.\n\nIn plain words\n\n> The Bloc pattern manages a single state object and dynamically notifies registered listeners whenever the state changes.\n\nWikipedia says\n\n> While not a formalized \"Gang of Four\" design pattern, Bloc is widely used in state-driven applications. It centralizes state management and propagates state changes to registered observers, following principles of separation of concerns.\n\nSequence diagram\n\n\n\n## Programmatic Example of the Bloc Pattern in Java\n\nThis example demonstrates how to implement the Bloc pattern using Java and Swing. The pattern separates the state of the application from UI components, and provides a reactive, event-driven approach to managing updates.\n\nCore components of the Bloc Pattern include a `State` object, a `Bloc` class responsible for managing and updating that state, and interfaces (`StateListener` and `ListenerManager`) for subscribing to changes.\n\nThe `State` class represents the application's data at any given time.\n\n```java\npublic record State(int value) {}\n```\n\nThe `ListenerManager` interface declares methods to add and remove listeners, as well as retrieve them.\n\n```java\npublic interface ListenerManager {\n void addListener(StateListener listener);\n void removeListener(StateListener listener);\n List> getListeners();\n}\n```\n\nThe `StateListener` interface defines how a listener reacts to state changes.\n\n```java\npublic interface StateListener {\n void onStateChange(T state);\n}\n```\n\nThe `Bloc` class maintains the current state and notifies listeners of updates. It provides `increment` and `decrement` methods to update state and automatically notify registered listeners.\n\n```java\npublic class Bloc implements ListenerManager {\n\n private State currentState;\n private final List> listeners = new ArrayList<>();\n\n public Bloc() {\n this.currentState = new State(0);\n }\n\n @Override\n public void addListener(StateListener listener) {\n listeners.add(listener);\n listener.onStateChange(currentState);\n }\n\n @Override\n public void removeListener(StateListener listener) {\n listeners.remove(listener);\n }\n\n @Override\n public List> getListeners() {\n return Collections.unmodifiableList(listeners);\n }\n\n private void emitState(State newState) {\n currentState = newState;\n for (StateListener listener : listeners) {\n listener.onStateChange(currentState);\n }\n }\n\n public void increment() {\n emitState(new State(currentState.value() + 1));\n }\n\n public void decrement() {\n emitState(new State(currentState.value() - 1));\n }\n}\n```\n\nThis class demonstrates how to integrate the Bloc pattern with a simple Swing GUI. It sets up a counter, buttons to change the state, and a toggle to enable or disable the listener dynamically.\n\n```java\npublic class Main {\n public static void main(String[] args) {\n BlocUi blocUi = new BlocUi();\n blocUi.createAndShowUi();\n }\n}\n\npublic class BlocUi {\n\n public void createAndShowUi() {\n final Bloc bloc = new Bloc();\n\n JFrame frame = new JFrame(\"BloC example\");\n frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);\n frame.setSize(400, 300);\n\n JLabel counterLabel = new JLabel(\"Counter: 0\", SwingConstants.CENTER);\n counterLabel.setFont(new Font(\"Arial\", Font.BOLD, 20));\n\n JButton decrementButton = new JButton(\"Decrement\");\n JButton toggleListenerButton = new JButton(\"Disable Listener\");\n JButton incrementButton = new JButton(\"Increment\");\n\n frame.setLayout(new BorderLayout());\n frame.add(counterLabel, BorderLayout.CENTER);\n frame.add(incrementButton, BorderLayout.NORTH);\n frame.add(decrementButton, BorderLayout.SOUTH);\n frame.add(toggleListenerButton, BorderLayout.EAST);\n\n StateListener stateListener = state -> counterLabel.setText(\"Counter: \" + state.value());\n\n bloc.addListener(stateListener);\n\n toggleListenerButton.addActionListener(\n e -> {\n if (bloc.getListeners().contains(stateListener)) {\n bloc.removeListener(stateListener);\n toggleListenerButton.setText(\"Enable Listener\");\n } else {\n bloc.addListener(stateListener);\n toggleListenerButton.setText(\"Disable Listener\");\n }\n });\n\n incrementButton.addActionListener(e -> bloc.increment());\n decrementButton.addActionListener(e -> bloc.decrement());\n\n frame.setVisible(true);\n }\n}\n```\n\n### Program Output\n\n- **On Increment** \n `Counter: 1`\n\n- **On Decrement** \n `Counter: 0`\n\n- **Dynamic Listener Toggle** \n - Listener disabled: Counter stops updating. \n - Listener enabled: Counter updates again.\n\n## When to Use the Bloc Pattern\n\nUse the Bloc pattern when:\n\n* When you want a clean separation of business logic and UI in Java applications\n* When you need a reactive approach to updating UI based on state changes\n* When you want to avoid coupling controllers or presenters directly to data manipulation\n* When multiple UI elements need access to the same business logic\n\n## Real-World Applications of Bloc Pattern\n\n* Java-based desktop applications that require real-time UI updates\n* Backend-driven Java frameworks that separate service layers from presentation\n* Cross-platform applications where the logic must remain consistent regardless of the UI technology\n\n## Benefits and Trade-offs of Bloc Pattern\n\nBenefits:\n\n* Simplifies UI components by removing direct business logic\n* Improves testability by isolating state and behavior\n* Encourages code reuse by centralizing data flows\n* Enhances maintainability through clear separation of concerns\n\nTrade-offs:\n\n* May introduce additional boilerplate code for managing streams or observers\n* Requires careful design to avoid a monolithic “god” component\n* Demands consistent reactive programming practices to be effective\n\n## Related Patterns\n\n- [Observer](https://java-design-patterns.com/patterns/observer/): Bloc is a specialized implementation of the Observer pattern.\n- [Mediator](https://java-design-patterns.com/patterns/mediator/): Orchestrates interactions among multiple objects through a central component\n- [MVC](https://java-design-patterns.com/patterns/model-view-controller/): Shares the idea of separating concerns between layers\n\n## References and Credits\n\n* [Bloc architecture(bloclibrary.dev)](https://bloclibrary.dev/architecture/)\n* [Clean Architecture: A Craftsman's Guide to Software Structure and Design](https://amzn.to/3UoKkaR)\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Effective Java](https://amzn.to/4cGk2Jz)\n* [Event-Driven Programming in Java (Oracle)](https://www.oracle.com/java/)\n* [Java Swing Documentation (Oracle)](https://docs.oracle.com/javase/tutorial/uiswing/)\n"
},
{
"path": "bloc/etc/bloc.puml",
"content": "@startuml\npackage com.iluwatar.bloc {\n\n class State {\n - value : int\n + State(value : int)\n + getValue() : int\n }\n\n interface StateListener {\n + onStateChange(state : T)\n }\n\n interface ListenerManager {\n + addListener(listener : StateListener)\n + removeListener(listener : StateListener)\n + getListeners() : List>\n }\n\n class BloC {\n - currentState : State\n - listeners : List>\n + BloC()\n + addListener(listener : StateListener)\n + removeListener(listener : StateListener)\n + getListeners() : List>\n - emitState(newState : State)\n + increment()\n + decrement()\n }\n\n class Main {\n + main(args : String[])\n }\n\n ListenerManager <|.. BloC\n StateListener <|.. BloC\n BloC o-- State\n BloC *-- StateListener\n}\n@enduml\n"
},
{
"path": "bloc/etc/bloc.urm.puml",
"content": "@startuml\npackage com.iluwatar.bloc {\n class Bloc {\n - currentState : State\n - listeners : List>\n + Bloc()\n + addListener(listener : StateListener)\n + decrement()\n - emitState(newState : State)\n + getListeners() : List>\n + increment()\n + removeListener(listener : StateListener)\n }\n class BlocUi {\n + BlocUi()\n + createAndShowUi()\n }\n interface ListenerManager {\n + addListener(StateListener) {abstract}\n + getListeners() : List> {abstract}\n + removeListener(StateListener) {abstract}\n }\n class Main {\n + Main()\n + main(args : String[]) {static}\n }\n interface StateListener {\n + onStateChange(T) {abstract}\n }\n}\nBloc ..|> ListenerManager \n@enduml"
},
{
"path": "bloc/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n bloc \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.testng \n testng \n 7.11.0 \n test \n \n \n org.assertj \n assertj-core \n 3.27.3 \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.bloc.Main \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "bloc/src/main/java/com/iluwatar/bloc/Bloc.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\nimport java.util.ArrayList;\nimport java.util.Collections;\nimport java.util.List;\n\n/**\n * The Bloc class is responsible for managing the current state and notifying registered listeners\n * whenever the state changes. It implements the ListenerManager interface, allowing listeners to be\n * added, removed, and notified of state changes.\n */\npublic class Bloc implements ListenerManager {\n\n private State currentState;\n private final List> listeners = new ArrayList<>();\n\n /** Constructs a new Bloc instance with an initial state of value 0. */\n public Bloc() {\n this.currentState = new State(0);\n }\n\n /**\n * Adds a listener to receive state change notifications.\n *\n * @param listener the listener to add\n */\n @Override\n public void addListener(StateListener listener) {\n listeners.add(listener);\n listener.onStateChange(currentState);\n }\n\n /**\n * Removes a listener from receiving state change notifications.\n *\n * @param listener the listener to remove\n */\n @Override\n public void removeListener(StateListener listener) {\n listeners.remove(listener);\n }\n\n /**\n * Returns an unmodifiable list of all registered listeners.\n *\n * @return an unmodifiable list of listeners\n */\n @Override\n public List> getListeners() {\n return Collections.unmodifiableList(listeners);\n }\n\n /**\n * Emits a new state and notifies all registered listeners of the change.\n *\n * @param newState the new state to emit\n */\n private void emitState(State newState) {\n currentState = newState;\n for (StateListener listener : listeners) {\n listener.onStateChange(currentState);\n }\n }\n\n /** Increments the current state value by 1 and notifies listeners of the change. */\n public void increment() {\n emitState(new State(currentState.value() + 1));\n }\n\n /** Decrements the current state value by 1 and notifies listeners of the change. */\n public void decrement() {\n emitState(new State(currentState.value() - 1));\n }\n}\n"
},
{
"path": "bloc/src/main/java/com/iluwatar/bloc/BlocUi.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\nimport java.awt.BorderLayout;\nimport java.awt.Font;\nimport javax.swing.JButton;\nimport javax.swing.JFrame;\nimport javax.swing.JLabel;\nimport javax.swing.SwingConstants;\nimport javax.swing.WindowConstants;\n\n/** The BlocUI class handles the creation and management of the UI components. */\npublic class BlocUi {\n\n /** Creates and shows the UI. */\n public void createAndShowUi() {\n // Create a Bloc instance to manage the state\n final Bloc bloc = new Bloc();\n\n // setting up a frame window with a title\n JFrame frame = new JFrame(\"BloC example\");\n frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);\n frame.setSize(400, 300);\n\n // label to display the counter value\n JLabel counterLabel = new JLabel(\"Counter: 0\", SwingConstants.CENTER);\n counterLabel.setFont(new Font(\"Arial\", Font.BOLD, 20));\n\n // buttons for increment, decrement, and toggling listener\n JButton decrementButton = new JButton(\"Decrement\");\n JButton toggleListenerButton = new JButton(\"Disable Listener\");\n JButton incrementButton = new JButton(\"Increment\");\n\n frame.setLayout(new BorderLayout());\n frame.add(counterLabel, BorderLayout.CENTER);\n frame.add(incrementButton, BorderLayout.NORTH);\n frame.add(decrementButton, BorderLayout.SOUTH);\n frame.add(toggleListenerButton, BorderLayout.EAST);\n\n // making a state listener to update the counter label when the state changes\n StateListener stateListener = state -> counterLabel.setText(\"Counter: \" + state.value());\n\n // adding the listener to the Bloc instance\n bloc.addListener(stateListener);\n\n toggleListenerButton.addActionListener(\n e -> {\n if (bloc.getListeners().contains(stateListener)) {\n bloc.removeListener(stateListener);\n toggleListenerButton.setText(\"Enable Listener\");\n } else {\n bloc.addListener(stateListener);\n toggleListenerButton.setText(\"Disable Listener\");\n }\n });\n\n incrementButton.addActionListener(e -> bloc.increment());\n decrementButton.addActionListener(e -> bloc.decrement());\n\n frame.setVisible(true);\n }\n}\n"
},
{
"path": "bloc/src/main/java/com/iluwatar/bloc/ListenerManager.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\nimport java.util.List;\n\n/**\n * Interface for managing listeners for state changes.\n *\n * @param The type of state to be handled by the listeners.\n */\npublic interface ListenerManager {\n\n /**\n * Adds a listener that will be notified of state changes.\n *\n * @param listener the listener to be added\n */\n void addListener(StateListener listener);\n\n /**\n * Removes a listener so that it no longer receives state change notifications.\n *\n * @param listener the listener to be removed\n */\n void removeListener(StateListener listener);\n\n /**\n * Returns a list of all listeners currently registered for state changes.\n *\n * @return a list of registered listeners\n */\n List> getListeners();\n}\n"
},
{
"path": "bloc/src/main/java/com/iluwatar/bloc/Main.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\n/**\n * The BLoC (Business Logic Component) pattern is a software design pattern primarily used in\n * Flutter applications. It facilitates the separation of business logic from UI code, making the\n * application more modular, testable, and scalable. The BLoC pattern uses streams to manage the\n * flow of data and state changes, allowing widgets to react to new states as they arrive. In the\n * BLoC pattern, the application is divided into three key components: - Input streams: Represent\n * user interactions or external events fed into the BLoC. - Business logic: Processes the input and\n * determines the resulting state or actions. - Output streams: Emit the updated state for the UI to\n * consume. The BLoC pattern is especially useful in reactive programming scenarios and aligns well\n * with the declarative nature of Flutter. By using this pattern, developers can ensure a clear\n * separation of concerns, enhance reusability, and maintain consistent state management throughout\n * the application.\n */\npublic class Main {\n\n /**\n * The entry point of the application. Initializes the GUI.\n *\n * @param args command-line arguments (not used in this example)\n */\n public static void main(String[] args) {\n BlocUi blocUi = new BlocUi();\n blocUi.createAndShowUi();\n }\n}\n"
},
{
"path": "bloc/src/main/java/com/iluwatar/bloc/State.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\n/**\n * The {@code State} class represents a state with an integer value. This class encapsulates the\n * value and provides methods to retrieve it.\n */\npublic record State(int value) {}\n"
},
{
"path": "bloc/src/main/java/com/iluwatar/bloc/StateListener.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\n/**\n * The {@code StateListener} interface defines the contract for listening to state changes.\n * Implementations of this interface should handle state changes and define actions to take when the\n * state changes.\n *\n * @param the type of state that this listener will handle\n */\npublic interface StateListener {\n\n /**\n * This method is called when the state has changed.\n *\n * @param state the updated state\n */\n void onStateChange(T state);\n}\n"
},
{
"path": "bloc/src/test/java/com/iluwatar/bloc/BlocTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\nimport static org.junit.jupiter.api.Assertions.*;\n\nimport java.util.concurrent.atomic.AtomicInteger;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\n\nclass BlocTest {\n private Bloc bloc;\n private AtomicInteger stateValue;\n\n @BeforeEach\n void setUp() {\n bloc = new Bloc();\n stateValue = new AtomicInteger(0);\n }\n\n @Test\n void initialState() {\n assertTrue(bloc.getListeners().isEmpty(), \"No listeners should be present initially.\");\n }\n\n @Test\n void IncrementUpdateState() {\n bloc.addListener(state -> stateValue.set(state.value()));\n bloc.increment();\n assertEquals(1, stateValue.get(), \"State should increment to 1\");\n }\n\n @Test\n void DecrementUpdateState() {\n bloc.addListener(state -> stateValue.set(state.value()));\n bloc.decrement();\n assertEquals(-1, stateValue.get(), \"State should decrement to -1\");\n }\n\n @Test\n void addingListener() {\n bloc.addListener(state -> {});\n assertEquals(1, bloc.getListeners().size(), \"Listener count should be 1.\");\n }\n\n @Test\n void removingListener() {\n StateListener listener = state -> {};\n bloc.addListener(listener);\n bloc.removeListener(listener);\n assertTrue(bloc.getListeners().isEmpty(), \"Listener count should be 0 after removal.\");\n }\n\n @Test\n void multipleListeners() {\n AtomicInteger secondValue = new AtomicInteger();\n bloc.addListener(state -> stateValue.set(state.value()));\n bloc.addListener(state -> secondValue.set(state.value()));\n bloc.increment();\n assertEquals(1, stateValue.get(), \"First listener should receive state 1.\");\n assertEquals(1, secondValue.get(), \"Second listener should receive state 1.\");\n }\n}\n"
},
{
"path": "bloc/src/test/java/com/iluwatar/bloc/BlocUiTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bloc;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport java.awt.*;\nimport javax.swing.*;\nimport org.junit.jupiter.api.AfterEach;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\n\nclass BlocUiTest {\n\n private JFrame frame;\n private JLabel counterLabel;\n private JButton incrementButton;\n private JButton decrementButton;\n private JButton toggleListenerButton;\n private Bloc bloc;\n private StateListener stateListener;\n\n @BeforeEach\n void setUp() {\n bloc = new Bloc(); // Re-initialize the Bloc for each test\n\n frame = new JFrame(\"BloC example\");\n frame.setDefaultCloseOperation(WindowConstants.DISPOSE_ON_CLOSE);\n frame.setSize(400, 300);\n\n counterLabel = new JLabel(\"Counter: 0\", SwingConstants.CENTER);\n counterLabel.setFont(new Font(\"Arial\", Font.BOLD, 20));\n\n incrementButton = new JButton(\"Increment\");\n decrementButton = new JButton(\"Decrement\");\n toggleListenerButton = new JButton(\"Disable Listener\");\n\n frame.setLayout(new BorderLayout());\n frame.add(counterLabel, BorderLayout.CENTER);\n frame.add(incrementButton, BorderLayout.NORTH);\n frame.add(decrementButton, BorderLayout.SOUTH);\n frame.add(toggleListenerButton, BorderLayout.EAST);\n\n stateListener = state -> counterLabel.setText(\"Counter: \" + state.value());\n bloc.addListener(stateListener);\n\n incrementButton.addActionListener(e -> bloc.increment());\n decrementButton.addActionListener(e -> bloc.decrement());\n toggleListenerButton.addActionListener(\n e -> {\n if (bloc.getListeners().contains(stateListener)) {\n bloc.removeListener(stateListener);\n toggleListenerButton.setText(\"Enable Listener\");\n } else {\n bloc.addListener(stateListener);\n toggleListenerButton.setText(\"Disable Listener\");\n }\n });\n\n frame.setVisible(true);\n }\n\n @AfterEach\n void tearDown() {\n frame.dispose();\n bloc = new Bloc(); // Reset Bloc state after each test to avoid state carryover\n }\n\n @Test\n void testIncrementButton() {\n simulateButtonClick(incrementButton);\n assertEquals(\"Counter: 1\", counterLabel.getText());\n }\n\n @Test\n void testDecrementButton() {\n simulateButtonClick(decrementButton);\n assertEquals(\"Counter: -1\", counterLabel.getText());\n }\n\n @Test\n void testToggleListenerButton() {\n // Disable listener\n simulateButtonClick(toggleListenerButton);\n simulateButtonClick(incrementButton);\n assertEquals(\"Counter: 0\", counterLabel.getText()); // Listener is disabled\n\n // Enable listener\n simulateButtonClick(toggleListenerButton);\n simulateButtonClick(incrementButton);\n assertEquals(\"Counter: 2\", counterLabel.getText()); // Listener is re-enabled\n }\n\n private void simulateButtonClick(JButton button) {\n for (var listener : button.getActionListeners()) {\n listener.actionPerformed(null);\n }\n }\n}\n"
},
{
"path": "bridge/README.md",
"content": "---\ntitle: \"Bridge Pattern in Java: Decouple Abstraction from Implementation\"\nshortTitle: Bridge\ndescription: \"Learn about the Bridge design pattern in Java. Decouple abstraction from implementation to enhance flexibility and extensibility. Explore real-world examples, class diagrams, and use cases.\"\ncategory: Structural\nlanguage: en\ntag:\n - Abstraction\n - Decoupling\n - Extensibility\n - Gang of Four\n - Object composition\n---\n\n## Also known as\n\n* Handle/Body\n\n## Intent of Bridge Design Pattern\n\nThe Bridge design pattern is a structural pattern in Java that decouples an abstraction from its implementation, allowing both to vary independently. This pattern is essential for developing flexible and extensible software systems.\n\n## Detailed Explanation of Bridge Pattern with Real-World Examples\n\nReal-world example\n\n> In Java, the Bridge pattern is commonly used in GUI frameworks, database drivers, and device drivers. For instance, a universal remote control (abstraction) can operate various TV brands (implementations) through a consistent interface.\n>\n> Imagine a universal remote control (abstraction) that can operate different brands and types of televisions (implementations). The remote control provides a consistent interface for operations like turning on/off, changing channels, and adjusting the volume. Each television brand or type has its own specific implementation of these operations. By using the Bridge pattern, the remote control interface is decoupled from the television implementations, allowing the remote control to work with any television regardless of its brand or internal workings. This separation allows new television models to be added without changing the remote control's code, and different remote controls can be developed to work with the same set of televisions.\n\nIn Plain Words\n\n> Bridge pattern is about preferring composition to inheritance. Implementation details are pushed from a hierarchy to another object with a separate hierarchy.\n\nWikipedia says\n\n> The bridge pattern is a design pattern used in software engineering that is meant to \"decouple an abstraction from its implementation so that the two can vary independently\"\n\nSequence diagram\n\n\n\n## Programmatic Example of Bridge Pattern in Java\n\nImagine you have a weapon that can have various enchantments, and you need to combine different weapons with different enchantments. How would you handle this? Would you create multiple copies of each weapon, each with a different enchantment, or would you create separate enchantments and apply them to the weapon as needed? The Bridge pattern enables you to do the latter.\n\nHere we have the `Weapon` hierarchy:\n\n```java\npublic interface Weapon {\n void wield();\n\n void swing();\n\n void unwield();\n\n Enchantment getEnchantment();\n}\n\npublic class Sword implements Weapon {\n\n private final Enchantment enchantment;\n\n public Sword(Enchantment enchantment) {\n this.enchantment = enchantment;\n }\n\n @Override\n public void wield() {\n LOGGER.info(\"The sword is wielded.\");\n enchantment.onActivate();\n }\n\n @Override\n public void swing() {\n LOGGER.info(\"The sword is swung.\");\n enchantment.apply();\n }\n\n @Override\n public void unwield() {\n LOGGER.info(\"The sword is unwielded.\");\n enchantment.onDeactivate();\n }\n\n @Override\n public Enchantment getEnchantment() {\n return enchantment;\n }\n}\n\npublic class Hammer implements Weapon {\n\n private final Enchantment enchantment;\n\n public Hammer(Enchantment enchantment) {\n this.enchantment = enchantment;\n }\n\n @Override\n public void wield() {\n LOGGER.info(\"The hammer is wielded.\");\n enchantment.onActivate();\n }\n\n @Override\n public void swing() {\n LOGGER.info(\"The hammer is swung.\");\n enchantment.apply();\n }\n\n @Override\n public void unwield() {\n LOGGER.info(\"The hammer is unwielded.\");\n enchantment.onDeactivate();\n }\n\n @Override\n public Enchantment getEnchantment() {\n return enchantment;\n }\n}\n```\n\nHere's the separate `Enchantment` hierarchy:\n\n```java\npublic interface Enchantment {\n void onActivate();\n\n void apply();\n\n void onDeactivate();\n}\n\npublic class FlyingEnchantment implements Enchantment {\n\n @Override\n public void onActivate() {\n LOGGER.info(\"The item begins to glow faintly.\");\n }\n\n @Override\n public void apply() {\n LOGGER.info(\"The item flies and strikes the enemies finally returning to owner's hand.\");\n }\n\n @Override\n public void onDeactivate() {\n LOGGER.info(\"The item's glow fades.\");\n }\n}\n\npublic class SoulEatingEnchantment implements Enchantment {\n\n @Override\n public void onActivate() {\n LOGGER.info(\"The item spreads bloodlust.\");\n }\n\n @Override\n public void apply() {\n LOGGER.info(\"The item eats the soul of enemies.\");\n }\n\n @Override\n public void onDeactivate() {\n LOGGER.info(\"Bloodlust slowly disappears.\");\n }\n}\n```\n\nHere are both hierarchies in action:\n\n```java\npublic static void main(String[] args) {\n LOGGER.info(\"The knight receives an enchanted sword.\");\n var enchantedSword = new Sword(new SoulEatingEnchantment());\n enchantedSword.wield();\n enchantedSword.swing();\n enchantedSword.unwield();\n\n LOGGER.info(\"The valkyrie receives an enchanted hammer.\");\n var hammer = new Hammer(new FlyingEnchantment());\n hammer.wield();\n hammer.swing();\n hammer.unwield();\n}\n```\n\nHere's the console output.\n\n```\nThe knight receives an enchanted sword.\nThe sword is wielded.\nThe item spreads bloodlust.\nThe sword is swung.\nThe item eats the soul of enemies.\nThe sword is unwielded.\nBloodlust slowly disappears.\nThe valkyrie receives an enchanted hammer.\nThe hammer is wielded.\nThe item begins to glow faintly.\nThe hammer is swung.\nThe item flies and strikes the enemies finally returning to owner's hand.\nThe hammer is unwielded.\nThe item's glow fades.\n```\n\n## When to Use the Bridge Pattern in Java\n\nConsider using the Bridge pattern when:\n\n* You need to avoid a permanent binding between an abstraction and its implementation, such as when the implementation must be chosen or switched at runtime.\n* Both the abstractions and their implementations should be extendable via subclassing, allowing independent extension of each component.\n* Changes to the implementation of an abstraction should not affect clients, meaning their code should not require recompilation.\n* You encounter a large number of classes in your hierarchy, indicating the need to split an object into two parts, a concept referred to as \"nested generalizations\" by Rumbaugh.\n* You want to share an implementation among multiple objects, potentially using reference counting, while keeping this detail hidden from the client, as exemplified by Coplien's String class, where multiple objects can share the same string representation.\n\n## Bridge Pattern Java Tutorials\n\n* [Bridge Pattern Tutorial (DigitalOcean)](https://www.digitalocean.com/community/tutorials/bridge-design-pattern-java)\n\n## Real-World Applications of Bridge Pattern in Java\n\n* GUI Frameworks where the abstraction is the window, and the implementation could be the underlying OS windowing system.\n* Database Drivers where the abstraction is a generic database interface, and the implementations are database-specific drivers.\n* Device Drivers where the abstraction is the device-independent code, and the implementation is the device-dependent code.\n\n## Benefits and Trade-offs of Bridge Pattern\n\nBenefits:\n\n* Decoupling Interface and Implementation: The Bridge pattern enhances modularity by separating the interface (the high-level operations) from the implementation (the low-level operations).\n* Improved Extensibility: You can extend the abstraction and implementation hierarchies independently.\n* Hiding Implementation Details: Clients only see the abstraction's interface, not its implementation.\n\nTrade-offs:\n\n* Increased Complexity: The pattern can complicate the system architecture and code, especially for clients unfamiliar with the pattern.\n* Runtime Overhead: The extra layer of abstraction can introduce a performance penalty, although it is often negligible in practice.\n\n## Related Java Design Patterns\n\n* [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/): The Abstract Factory pattern can be used along with the Bridge pattern to create platforms that are independent of the concrete classes used to create their objects.\n* [Adapter](https://java-design-patterns.com/patterns/adapter/): The Adapter pattern is used to provide a different interface to an object, while the Bridge pattern is used to separate an object's interface from its implementation.\n* [Composite](https://java-design-patterns.com/patterns/composite/): The Bridge pattern is often used with the Composite pattern to model the implementation details of a component.\n* [Strategy](https://java-design-patterns.com/patterns/strategy/): The Strategy pattern is like the Bridge pattern, but with a different intent. Both patterns are based on composition: Strategy uses composition to change the behavior of a class, while Bridge uses composition to separate an abstraction from its implementation.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Head First Design Patterns: Building Extensible and Maintainable Object-Oriented Software](https://amzn.to/49NGldq)\n* [Java Design Patterns: A Hands-On Experience with Real-World Examples](https://amzn.to/3yhh525)\n* [Pattern-Oriented Software Architecture Volume 1: A System of Patterns](https://amzn.to/3TEnhtl)\n* [Patterns of Enterprise Application Architecture](https://amzn.to/3WfKBPR)\n"
},
{
"path": "bridge/etc/bridge.urm.puml",
"content": "@startuml\npackage com.iluwatar.bridge {\n class App {\n - LOGGER : Logger {static}\n + App()\n + main(args : String[]) {static}\n }\n interface Enchantment {\n + apply() {abstract}\n + onActivate() {abstract}\n + onDeactivate() {abstract}\n }\n class FlyingEnchantment {\n - LOGGER : Logger {static}\n + FlyingEnchantment()\n + apply()\n + onActivate()\n + onDeactivate()\n }\n class Hammer {\n - LOGGER : Logger {static}\n - enchantment : Enchantment\n + Hammer(enchantment : Enchantment)\n + getEnchantment() : Enchantment\n + swing()\n + unwield()\n + wield()\n }\n class SoulEatingEnchantment {\n - LOGGER : Logger {static}\n + SoulEatingEnchantment()\n + apply()\n + onActivate()\n + onDeactivate()\n }\n class Sword {\n - LOGGER : Logger {static}\n - enchantment : Enchantment\n + Sword(enchantment : Enchantment)\n + getEnchantment() : Enchantment\n + swing()\n + unwield()\n + wield()\n }\n interface Weapon {\n + getEnchantment() : Enchantment {abstract}\n + swing() {abstract}\n + unwield() {abstract}\n + wield() {abstract}\n }\n}\nSword --> \"-enchantment\" Enchantment\nHammer --> \"-enchantment\" Enchantment\nFlyingEnchantment ..|> Enchantment \nHammer ..|> Weapon \nSoulEatingEnchantment ..|> Enchantment \nSword ..|> Weapon \n@enduml"
},
{
"path": "bridge/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n bridge \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.mockito \n mockito-core \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.bridge.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * Composition over inheritance. The Bridge pattern can also be thought of as two layers of\n * abstraction. With Bridge, you can decouple an abstraction from its implementation so that the two\n * can vary independently.\n *\n * In Bridge pattern both abstraction ({@link Weapon}) and implementation ( {@link Enchantment})\n * have their own class hierarchies. The interface of the implementations can be changed without\n * affecting the clients.\n *\n *
In this example we have two class hierarchies. One of weapons and another one of enchantments.\n * We can easily combine any weapon with any enchantment using composition instead of creating deep\n * class hierarchy.\n */\n@Slf4j\npublic class App {\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(String[] args) {\n LOGGER.info(\"The knight receives an enchanted sword.\");\n var enchantedSword = new Sword(new SoulEatingEnchantment());\n enchantedSword.wield();\n enchantedSword.swing();\n enchantedSword.unwield();\n\n LOGGER.info(\"The valkyrie receives an enchanted hammer.\");\n var hammer = new Hammer(new FlyingEnchantment());\n hammer.wield();\n hammer.swing();\n hammer.unwield();\n }\n}\n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/Enchantment.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\n/** Enchantment. */\npublic interface Enchantment {\n\n void onActivate();\n\n void apply();\n\n void onDeactivate();\n}\n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** FlyingEnchantment. */\n@Slf4j\npublic class FlyingEnchantment implements Enchantment {\n\n @Override\n public void onActivate() {\n LOGGER.info(\"The item begins to glow faintly.\");\n }\n\n @Override\n public void apply() {\n LOGGER.info(\"The item flies and strikes the enemies finally returning to owner's hand.\");\n }\n\n @Override\n public void onDeactivate() {\n LOGGER.info(\"The item's glow fades.\");\n }\n}\n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/Hammer.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\n\n/** Hammer. */\n@Slf4j\n@AllArgsConstructor\npublic class Hammer implements Weapon {\n\n private final Enchantment enchantment;\n\n @Override\n public void wield() {\n LOGGER.info(\"The hammer is wielded.\");\n enchantment.onActivate();\n }\n\n @Override\n public void swing() {\n LOGGER.info(\"The hammer is swung.\");\n enchantment.apply();\n }\n\n @Override\n public void unwield() {\n LOGGER.info(\"The hammer is unwielded.\");\n enchantment.onDeactivate();\n }\n\n @Override\n public Enchantment getEnchantment() {\n return enchantment;\n }\n}\n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** SoulEatingEnchantment. */\n@Slf4j\npublic class SoulEatingEnchantment implements Enchantment {\n\n @Override\n public void onActivate() {\n LOGGER.info(\"The item spreads bloodlust.\");\n }\n\n @Override\n public void apply() {\n LOGGER.info(\"The item eats the soul of enemies.\");\n }\n\n @Override\n public void onDeactivate() {\n LOGGER.info(\"Bloodlust slowly disappears.\");\n }\n}\n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/Sword.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport lombok.AllArgsConstructor;\nimport lombok.extern.slf4j.Slf4j;\n\n/** Sword. */\n@Slf4j\n@AllArgsConstructor\npublic class Sword implements Weapon {\n\n private final Enchantment enchantment;\n\n @Override\n public void wield() {\n LOGGER.info(\"The sword is wielded.\");\n enchantment.onActivate();\n }\n\n @Override\n public void swing() {\n LOGGER.info(\"The sword is swung.\");\n enchantment.apply();\n }\n\n @Override\n public void unwield() {\n LOGGER.info(\"The sword is unwielded.\");\n enchantment.onDeactivate();\n }\n\n @Override\n public Enchantment getEnchantment() {\n return enchantment;\n }\n}\n"
},
{
"path": "bridge/src/main/java/com/iluwatar/bridge/Weapon.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\n/** Weapon. */\npublic interface Weapon {\n\n void wield();\n\n void swing();\n\n void unwield();\n\n Enchantment getEnchantment();\n}\n"
},
{
"path": "bridge/src/test/java/com/iluwatar/bridge/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Application test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n *
Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "bridge/src/test/java/com/iluwatar/bridge/HammerTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests for hammer */\nclass HammerTest extends WeaponTest {\n\n /**\n * Invoke all possible actions on the weapon and check if the actions are executed on the actual\n * underlying weapon implementation.\n */\n @Test\n void testHammer() {\n final var hammer = spy(new Hammer(mock(FlyingEnchantment.class)));\n testBasicWeaponActions(hammer);\n }\n}\n"
},
{
"path": "bridge/src/test/java/com/iluwatar/bridge/SwordTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport static org.mockito.Mockito.mock;\nimport static org.mockito.Mockito.spy;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests for sword */\nclass SwordTest extends WeaponTest {\n\n /**\n * Invoke all possible actions on the weapon and check if the actions are executed on the actual\n * underlying weapon implementation.\n */\n @Test\n void testSword() {\n final var sword = spy(new Sword(mock(FlyingEnchantment.class)));\n testBasicWeaponActions(sword);\n }\n}\n"
},
{
"path": "bridge/src/test/java/com/iluwatar/bridge/WeaponTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bridge;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.mockito.Mockito.verify;\nimport static org.mockito.Mockito.verifyNoMoreInteractions;\n\n/** Base class for weapon tests */\nabstract class WeaponTest {\n\n /**\n * Invoke the basic actions of the given weapon, and test if the underlying enchantment\n * implementation is invoked\n */\n final void testBasicWeaponActions(final Weapon weapon) {\n assertNotNull(weapon);\n var enchantment = weapon.getEnchantment();\n assertNotNull(enchantment);\n assertNotNull(weapon.getEnchantment());\n\n weapon.swing();\n verify(enchantment).apply();\n verifyNoMoreInteractions(enchantment);\n\n weapon.wield();\n verify(enchantment).onActivate();\n verifyNoMoreInteractions(enchantment);\n\n weapon.unwield();\n verify(enchantment).onDeactivate();\n verifyNoMoreInteractions(enchantment);\n }\n}\n"
},
{
"path": "builder/.gitignore",
"content": "/target/\n"
},
{
"path": "builder/README.md",
"content": "---\ntitle: \"Builder Pattern in Java: Crafting Custom Objects with Clarity\"\nshortTitle: Builder\ndescription: \"Discover the Builder design pattern in Java, a powerful creational pattern that simplifies object construction. Learn how to separate the construction of a complex object from its representation with practical examples and use cases.\"\ncategory: Creational\nlanguage: en\ntag:\n - Gang of Four\n - Instantiation\n - Object composition\n---\n\n## Intent of Builder Design Pattern\n\nThe Builder design pattern in Java, a fundamental creational pattern, allows for the step-by-step construction of complex objects. It separates the construction of a complex object from its representation so that the same construction process can create different representations.\n\n## Detailed Explanation of Builder Pattern with Real-World Examples\n\nReal-world example\n\n> The Java Builder pattern is particularly useful in scenarios where object creation involves numerous parameters.\n> \n> Imagine you are building a customizable sandwich at a deli. The Builder design pattern in this context would involve a SandwichBuilder that allows you to specify each component of the sandwich, such as the type of bread, meat, cheese, vegetables, and condiments. Instead of having to know how to construct the sandwich from scratch, you use the SandwichBuilder to add each desired component step-by-step, ensuring you get exactly the sandwich you want. This separation of construction from the final product representation ensures that the same construction process can yield different types of sandwiches based on the specified components.\n\nIn plain words\n\n> Allows you to create different flavors of an object while avoiding constructor pollution. Useful when there could be several flavors of an object. Or when there are a lot of steps involved in creation of an object.\n\nWikipedia says\n\n> The builder pattern is an object creation software design pattern with the intentions of finding a solution to the telescoping constructor antipattern.\n\nWith that in mind, let's explain what the telescoping constructor antipattern is. At some point, we have all encountered a constructor like the one below:\n\n```java\npublic Hero(Profession profession,String name,HairType hairType,HairColor hairColor,Armor armor,Weapon weapon){\n // Value assignments\n}\n```\n\nAs you can see, the number of constructor parameters can quickly become overwhelming, making it difficult to understand their arrangement. Additionally, this list of parameters might continue to grow if you decide to add more options in the future. This is known as the telescoping constructor antipattern.\n\nSequence diagram\n\n\n\n## Programmatic Example of Builder Pattern in Java\n\nIn this Java Builder pattern example, we construct different types of `Hero` objects with varying attributes.\n\nImagine a character generator for a role-playing game. The simplest option is to let the computer generate the character for you. However, if you prefer to manually select character details such as profession, gender, hair color, etc., the character creation becomes a step-by-step process that concludes once all selections are made.\n\nA more sensible approach is to use the Builder pattern. First, let's consider the `Hero` that we want to create:\n\n```java\npublic final class Hero {\n private final Profession profession;\n private final String name;\n private final HairType hairType;\n private final HairColor hairColor;\n private final Armor armor;\n private final Weapon weapon;\n\n private Hero(Builder builder) {\n this.profession = builder.profession;\n this.name = builder.name;\n this.hairColor = builder.hairColor;\n this.hairType = builder.hairType;\n this.weapon = builder.weapon;\n this.armor = builder.armor;\n }\n}\n```\n\nThen we have the `Builder`:\n\n```java\n public static class Builder {\n private final Profession profession;\n private final String name;\n private HairType hairType;\n private HairColor hairColor;\n private Armor armor;\n private Weapon weapon;\n\n public Builder(Profession profession, String name) {\n if (profession == null || name == null) {\n throw new IllegalArgumentException(\"profession and name can not be null\");\n }\n this.profession = profession;\n this.name = name;\n }\n\n public Builder withHairType(HairType hairType) {\n this.hairType = hairType;\n return this;\n }\n\n public Builder withHairColor(HairColor hairColor) {\n this.hairColor = hairColor;\n return this;\n }\n\n public Builder withArmor(Armor armor) {\n this.armor = armor;\n return this;\n }\n\n public Builder withWeapon(Weapon weapon) {\n this.weapon = weapon;\n return this;\n }\n\n public Hero build() {\n return new Hero(this);\n }\n}\n```\n\nThen it can be used as:\n\n```java\n public static void main(String[] args) {\n\n var mage = new Hero.Builder(Profession.MAGE, \"Riobard\")\n .withHairColor(HairColor.BLACK)\n .withWeapon(Weapon.DAGGER)\n .build();\n LOGGER.info(mage.toString());\n\n var warrior = new Hero.Builder(Profession.WARRIOR, \"Amberjill\")\n .withHairColor(HairColor.BLOND)\n .withHairType(HairType.LONG_CURLY).withArmor(Armor.CHAIN_MAIL).withWeapon(Weapon.SWORD)\n .build();\n LOGGER.info(warrior.toString());\n\n var thief = new Hero.Builder(Profession.THIEF, \"Desmond\")\n .withHairType(HairType.BALD)\n .withWeapon(Weapon.BOW)\n .build();\n LOGGER.info(thief.toString());\n}\n```\n\nProgram output:\n\n```\n16:28:06.058 [main] INFO com.iluwatar.builder.App -- This is a mage named Riobard with black hair and wielding a dagger.\n16:28:06.060 [main] INFO com.iluwatar.builder.App -- This is a warrior named Amberjill with blond long curly hair wearing chain mail and wielding a sword.\n16:28:06.060 [main] INFO com.iluwatar.builder.App -- This is a thief named Desmond with bald head and wielding a bow.\n```\n\n## When to Use the Builder Pattern in Java\n\nUse the Builder pattern when\n\n* The Builder pattern is ideal for Java applications requiring complex object creation.\n* The algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled\n* The construction process must allow different representations for the object that's constructed\n* It's particularly useful when a product requires a lot of steps to be created and when these steps need to be executed in a specific sequence\n\n## Builder Pattern Java Tutorials\n\n* [Builder Design Pattern in Java (DigitalOcean)](https://www.journaldev.com/1425/builder-design-pattern-in-java)\n* [Builder (Refactoring Guru)](https://refactoring.guru/design-patterns/builder)\n* [Exploring Joshua Bloch’s Builder design pattern in Java (Java Magazine)](https://blogs.oracle.com/javamagazine/post/exploring-joshua-blochs-builder-design-pattern-in-java)\n\n## Real-World Applications of Builder Pattern in Java\n\n* StringBuilder in Java for constructing strings.\n* java.lang.StringBuffer used to create mutable string objects.\n* Java.nio.ByteBuffer as well as similar buffers such as FloatBuffer, IntBuffer, and others\n* javax.swing.GroupLayout.Group#addComponent()\n* Various GUI builders in IDEs that construct UI components.\n* All implementations of [java.lang.Appendable](http://docs.oracle.com/javase/8/docs/api/java/lang/Appendable.html)\n* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder)\n* [Apache Commons Option.Builder](https://commons.apache.org/proper/commons-cli/apidocs/org/apache/commons/cli/Option.Builder.html)\n\n## Benefits and Trade-offs of Builder Pattern\n\nBenefits:\n\n* More control over the construction process compared to other creational patterns\n* Supports constructing objects step-by-step, defer construction steps or run steps recursively\n* Can construct objects that require a complex assembly of sub-objects. The final product is detached from the parts that make it up, as well as their assembly process\n* Single Responsibility Principle. You can isolate complex construction code from the business logic of the product\n\nTrade-offs:\n\n* The overall complexity of the code can increase since the pattern requires creating multiple new classes\n* May increase memory usage due to the necessity of creating multiple builder objects\n\n## Related Java Design Patterns\n\n* [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/): Can be used in conjunction with Builder to build parts of a complex object.\n* [Prototype](https://java-design-patterns.com/patterns/prototype/): Builders often create objects from a prototype.\n* [Step Builder](https://java-design-patterns.com/patterns/step-builder/): It is a variation of the Builder pattern that generates a complex object using a step-by-step approach. The Step Builder pattern is a good choice when you need to build an object with a large number of optional parameters, and you want to avoid the telescoping constructor antipattern.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Effective Java](https://amzn.to/4cGk2Jz)\n* [Head First Design Patterns: Building Extensible and Maintainable Object-Oriented Software](https://amzn.to/49NGldq)\n* [Refactoring to Patterns](https://amzn.to/3VOO4F5)\n"
},
{
"path": "builder/etc/builder.urm.puml",
"content": "@startuml\npackage com.iluwatar.builder {\n class App {\n - LOGGER : Logger {static}\n + App()\n + main(args : String[]) {static}\n }\n enum Armor {\n + CHAIN_MAIL {static}\n + CLOTHES {static}\n + LEATHER {static}\n + PLATE_MAIL {static}\n - title : String\n + toString() : String\n + valueOf(name : String) : Armor {static}\n + values() : Armor[] {static}\n }\n enum HairColor {\n + BLACK {static}\n + BLOND {static}\n + BROWN {static}\n + RED {static}\n + WHITE {static}\n + toString() : String\n + valueOf(name : String) : HairColor {static}\n + values() : HairColor[] {static}\n }\n enum HairType {\n + BALD {static}\n + CURLY {static}\n + LONG_CURLY {static}\n + LONG_STRAIGHT {static}\n + SHORT {static}\n - title : String\n + toString() : String\n + valueOf(name : String) : HairType {static}\n + values() : HairType[] {static}\n }\n class Hero {\n - armor : Armor\n - hairColor : HairColor\n - hairType : HairType\n - name : String\n - profession : Profession\n - weapon : Weapon\n - Hero(builder : Builder)\n + getArmor() : Armor\n + getHairColor() : HairColor\n + getHairType() : HairType\n + getName() : String\n + getProfession() : Profession\n + getWeapon() : Weapon\n + toString() : String\n }\n class Builder {\n - armor : Armor\n - hairColor : HairColor\n - hairType : HairType\n - name : String\n - profession : Profession\n - weapon : Weapon\n + Builder(profession : Profession, name : String)\n + build() : Hero\n + withArmor(armor : Armor) : Builder\n + withHairColor(hairColor : HairColor) : Builder\n + withHairType(hairType : HairType) : Builder\n + withWeapon(weapon : Weapon) : Builder\n }\n enum Profession {\n + MAGE {static}\n + PRIEST {static}\n + THIEF {static}\n + WARRIOR {static}\n + toString() : String\n + valueOf(name : String) : Profession {static}\n + values() : Profession[] {static}\n }\n enum Weapon {\n + AXE {static}\n + BOW {static}\n + DAGGER {static}\n + SWORD {static}\n + WARHAMMER {static}\n + toString() : String\n + valueOf(name : String) : Weapon {static}\n + values() : Weapon[] {static}\n }\n}\nHero --> \"-profession\" Profession\nBuilder ..+ Hero\nHero --> \"-armor\" Armor\nBuilder --> \"-hairColor\" HairColor\nBuilder --> \"-weapon\" Weapon\nBuilder --> \"-hairType\" HairType\nHero --> \"-hairColor\" HairColor\nBuilder --> \"-profession\" Profession\nHero --> \"-weapon\" Weapon\nHero --> \"-hairType\" HairType\nBuilder --> \"-armor\" Armor\n@enduml"
},
{
"path": "builder/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n builder \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.builder.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\nimport com.iluwatar.builder.Hero.Builder;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * The intention of the Builder pattern is to find a solution to the telescoping constructor\n * antipattern. The telescoping constructor antipattern occurs when the increase of object\n * constructor parameter combination leads to an exponential list of constructors. Instead of using\n * numerous constructors, the builder pattern uses another object, a builder, that receives each\n * initialization parameter step by step and then returns the resulting constructed object at once.\n *\n *
The Builder pattern has another benefit. It can be used for objects that contain flat data\n * (html code, SQL query, X.509 certificate...), that is to say, data that can't be easily edited.\n * This type of data cannot be edited step by step and must be edited at once. The best way to\n * construct such an object is to use a builder class.\n *\n *
In this example we have the Builder pattern variation as described by Joshua Bloch in\n * Effective Java 2nd Edition.\n *\n *
We want to build {@link Hero} objects, but its construction is complex because of the many\n * parameters needed. To aid the user we introduce {@link Builder} class. {@link Hero.Builder} takes\n * the minimum parameters to build {@link Hero} object in its constructor. After that additional\n * configuration for the {@link Hero} object can be done using the fluent {@link Builder} interface.\n * When configuration is ready the build method is called to receive the final {@link Hero} object.\n */\n@Slf4j\npublic class App {\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(String[] args) {\n\n var mage =\n new Hero.Builder(Profession.MAGE, \"Riobard\")\n .withHairColor(HairColor.BLACK)\n .withWeapon(Weapon.DAGGER)\n .build();\n LOGGER.info(mage.toString());\n\n var warrior =\n new Hero.Builder(Profession.WARRIOR, \"Amberjill\")\n .withHairColor(HairColor.BLOND)\n .withHairType(HairType.LONG_CURLY)\n .withArmor(Armor.CHAIN_MAIL)\n .withWeapon(Weapon.SWORD)\n .build();\n LOGGER.info(warrior.toString());\n\n var thief =\n new Hero.Builder(Profession.THIEF, \"Desmond\")\n .withHairType(HairType.BALD)\n .withWeapon(Weapon.BOW)\n .build();\n LOGGER.info(thief.toString());\n }\n}\n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/Armor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\nimport lombok.AllArgsConstructor;\n\n/** Armor enumeration. */\n@AllArgsConstructor\npublic enum Armor {\n CLOTHES(\"clothes\"),\n LEATHER(\"leather\"),\n CHAIN_MAIL(\"chain mail\"),\n PLATE_MAIL(\"plate mail\");\n\n private final String title;\n\n @Override\n public String toString() {\n return title;\n }\n}\n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/HairColor.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\n/** HairColor enumeration. */\npublic enum HairColor {\n WHITE,\n BLOND,\n RED,\n BROWN,\n BLACK;\n\n @Override\n public String toString() {\n return name().toLowerCase();\n }\n}\n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/HairType.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\nimport lombok.AllArgsConstructor;\n\n/** HairType enumeration. */\n@AllArgsConstructor\npublic enum HairType {\n BALD(\"bald\"),\n SHORT(\"short\"),\n CURLY(\"curly\"),\n LONG_STRAIGHT(\"long straight\"),\n LONG_CURLY(\"long curly\");\n\n private final String title;\n\n @Override\n public String toString() {\n return title;\n }\n}\n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/Hero.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\n/** Hero,the record class. */\npublic record Hero(\n Profession profession,\n String name,\n HairType hairType,\n HairColor hairColor,\n Armor armor,\n Weapon weapon) {\n\n private Hero(Builder builder) {\n this(\n builder.profession,\n builder.name,\n builder.hairType,\n builder.hairColor,\n builder.armor,\n builder.weapon);\n }\n\n @Override\n public String toString() {\n\n var sb = new StringBuilder();\n sb.append(\"This is a \").append(profession).append(\" named \").append(name);\n if (hairColor != null || hairType != null) {\n sb.append(\" with \");\n if (hairColor != null) {\n sb.append(hairColor).append(' ');\n }\n if (hairType != null) {\n sb.append(hairType).append(' ');\n }\n sb.append(hairType != HairType.BALD ? \"hair\" : \"head\");\n }\n if (armor != null) {\n sb.append(\" wearing \").append(armor);\n }\n if (weapon != null) {\n sb.append(\" and wielding a \").append(weapon);\n }\n sb.append('.');\n return sb.toString();\n }\n\n /** The builder class. */\n public static class Builder {\n\n private final Profession profession;\n private final String name;\n private HairType hairType;\n private HairColor hairColor;\n private Armor armor;\n private Weapon weapon;\n\n /** Constructor. */\n public Builder(Profession profession, String name) {\n if (profession == null || name == null) {\n throw new IllegalArgumentException(\"profession and name can not be null\");\n }\n this.profession = profession;\n this.name = name;\n }\n\n public Builder withHairType(HairType hairType) {\n this.hairType = hairType;\n return this;\n }\n\n public Builder withHairColor(HairColor hairColor) {\n this.hairColor = hairColor;\n return this;\n }\n\n public Builder withArmor(Armor armor) {\n this.armor = armor;\n return this;\n }\n\n public Builder withWeapon(Weapon weapon) {\n this.weapon = weapon;\n return this;\n }\n\n public Hero build() {\n return new Hero(this);\n }\n }\n}\n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/Profession.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\n/** Profession enumeration. */\npublic enum Profession {\n WARRIOR,\n THIEF,\n MAGE,\n PRIEST;\n\n @Override\n public String toString() {\n return name().toLowerCase();\n }\n}\n"
},
{
"path": "builder/src/main/java/com/iluwatar/builder/Weapon.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\n/** Weapon enumeration. */\npublic enum Weapon {\n DAGGER,\n SWORD,\n AXE,\n WARHAMMER,\n BOW;\n\n @Override\n public String toString() {\n return name().toLowerCase();\n }\n}\n"
},
{
"path": "builder/src/test/java/com/iluwatar/builder/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Application test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n *
Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "builder/src/test/java/com/iluwatar/builder/HeroTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.builder;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\n\nimport org.junit.jupiter.api.Test;\n\n/** HeroTest */\nclass HeroTest {\n\n /** Test if we get the expected exception when trying to create a hero without a profession */\n @Test\n void testMissingProfession() {\n assertThrows(IllegalArgumentException.class, () -> new Hero.Builder(null, \"Sir without a job\"));\n }\n\n /** Test if we get the expected exception when trying to create a hero without a name */\n @Test\n void testMissingName() {\n assertThrows(IllegalArgumentException.class, () -> new Hero.Builder(Profession.THIEF, null));\n }\n\n /** Test if the hero build by the builder has the correct attributes, as requested */\n @Test\n void testBuildHero() {\n final String heroName = \"Sir Lancelot\";\n\n final var hero =\n new Hero.Builder(Profession.WARRIOR, heroName)\n .withArmor(Armor.CHAIN_MAIL)\n .withWeapon(Weapon.SWORD)\n .withHairType(HairType.LONG_CURLY)\n .withHairColor(HairColor.BLOND)\n .build();\n\n assertNotNull(hero);\n assertNotNull(hero.toString());\n assertEquals(Profession.WARRIOR, hero.profession());\n assertEquals(heroName, hero.name());\n assertEquals(Armor.CHAIN_MAIL, hero.armor());\n assertEquals(Weapon.SWORD, hero.weapon());\n assertEquals(HairType.LONG_CURLY, hero.hairType());\n assertEquals(HairColor.BLOND, hero.hairColor());\n }\n}\n"
},
{
"path": "business-delegate/README.md",
"content": "---\ntitle: \"Business Delegate Pattern in Java: Simplifying Business Service Interaction\"\nshortTitle: Business Delegate\ndescription: \"Learn about the Business Delegate pattern in Java. This design pattern adds an abstraction layer between presentation and business tiers, ensuring loose coupling and easier service interaction. Includes examples and class diagrams.\"\ncategory: Structural\nlanguage: en\ntag:\n - Business\n - Decoupling\n - Delegation\n - Enterprise patterns\n - Layered architecture\n---\n\n## Also known as\n\n* Service Representative\n\n## Intent of Business Delegate Design Pattern\n\nThe Business Delegate pattern is a structural design pattern in Java that adds an abstraction layer between the presentation and business tiers. By using the pattern we gain loose coupling between the tiers and encapsulate knowledge about how to locate, connect to, and interact with the business objects that make up the application.\n\n## Detailed Explanation of Business Delegate Pattern with Real-World Examples\n\nReal-world example\n\n> In an Enterprise application using Java EE, the Business Delegate pattern helps manage interactions between different business services.\n> \n> Imagine a restaurant where the waitstaff serves as intermediaries between the customers and the kitchen. When a customer places an order, the waiter takes the order to the kitchen, relays any specific requests, and later brings the prepared food back to the customer. The waitstaff abstracts the complexity of the kitchen operations from the customers, allowing the chefs to focus solely on cooking without needing to interact directly with customers. This setup allows both the customer service (presentation tier) and the kitchen (business service) to operate independently and efficiently. The waitstaff acts as the Business Delegate, managing communication and ensuring smooth interactions between the two distinct areas.\n\nIn Plain Words\n\n> Business Delegate adds an abstraction layer between the presentation and business tiers.\n\nWikipedia says\n\n> Business Delegate is a Java EE design pattern. This pattern is directing to reduce the coupling in between business services and the connected presentation tier, and to hide the implementation details of services (including lookup and accessibility of EJB architecture). Business Delegates acts as an adaptor to invoke business objects from the presentation tier.\n\nSequence diagram\n\n\n\n## Programmatic Example of Business Delegate Pattern in Java\n\nThe following Java code demonstrates how to implement the Business Delegate pattern. This pattern is particularly useful in applications requiring loose coupling and efficient service interaction.\n\nA mobile phone application promises to stream any movie in existence to your device. It captures the user's search string and passes this on to the Business Delegate. The Business Delegate selects the most suitable video streaming service and plays the video from there.\n\nFirst, we have an abstraction for video streaming services and a couple of implementations.\n\n```java\npublic interface VideoStreamingService {\n void doProcessing();\n}\n\n@Slf4j\npublic class NetflixService implements VideoStreamingService {\n @Override\n public void doProcessing() {\n LOGGER.info(\"NetflixService is now processing\");\n }\n}\n\n@Slf4j\npublic class YouTubeService implements VideoStreamingService {\n @Override\n public void doProcessing() {\n LOGGER.info(\"YouTubeService is now processing\");\n }\n}\n```\n\nThen, we have a lookup service that decides which video streaming service to use.\n\n```java\n\n@Setter\npublic class BusinessLookup {\n\n private NetflixService netflixService;\n private YouTubeService youTubeService;\n\n public VideoStreamingService getBusinessService(String movie) {\n if (movie.toLowerCase(Locale.ROOT).contains(\"die hard\")) {\n return netflixService;\n } else {\n return youTubeService;\n }\n }\n}\n```\n\nThe Business Delegate uses a business lookup to route movie playback requests to a suitable video streaming service.\n\n```java\n\n@Setter\npublic class BusinessDelegate {\n\n private BusinessLookup lookupService;\n\n public void playbackMovie(String movie) {\n VideoStreamingService videoStreamingService = lookupService.getBusinessService(movie);\n videoStreamingService.doProcessing();\n }\n}\n```\n\nThe mobile client utilizes Business Delegate to call the business tier.\n\n```java\npublic class MobileClient {\n\n private final BusinessDelegate businessDelegate;\n\n public MobileClient(BusinessDelegate businessDelegate) {\n this.businessDelegate = businessDelegate;\n }\n\n public void playbackMovie(String movie) {\n businessDelegate.playbackMovie(movie);\n }\n}\n```\n\nFinally, we can demonstrate the complete example in action.\n\n```java\npublic static void main(String[] args) {\n\n // prepare the objects\n var businessDelegate = new BusinessDelegate();\n var businessLookup = new BusinessLookup();\n businessLookup.setNetflixService(new NetflixService());\n businessLookup.setYouTubeService(new YouTubeService());\n businessDelegate.setLookupService(businessLookup);\n\n // create the client and use the business delegate\n var client = new MobileClient(businessDelegate);\n client.playbackMovie(\"Die Hard 2\");\n client.playbackMovie(\"Maradona: The Greatest Ever\");\n}\n```\n\nHere is the console output.\n\n```\n21:15:33.790 [main] INFO com.iluwatar.business.delegate.NetflixService - NetflixService is now processing\n21:15:33.794 [main] INFO com.iluwatar.business.delegate.YouTubeService - YouTubeService is now processing\n```\n\n## When to Use the Business Delegate Pattern in Java\n\nUse the Business Delegate pattern when\n\n* You need loose coupling between presentation and business tiers or need to abstract service lookups.\n* You want to orchestrate calls to multiple business services\n* You want to encapsulate service lookups and service calls\n* There is a need to abstract and encapsulate the communication between the client tier and business services\n\n## Business Delegate Pattern Java Tutorials\n\n* [Design Patterns - Business Delegate Pattern (TutorialsPoint)](https://www.tutorialspoint.com/design_pattern/business_delegate_pattern.htm)\n\n## Real-World Applications of Business Delegate Pattern in Java\n\n* Enterprise applications using Java EE (Java Platform, Enterprise Edition)\n* Applications requiring remote access to business services\n\n## Benefits and Trade-offs of Business Delegate Pattern\n\nBenefits:\n\n* Decoupling of Presentation and Business Tiers: Allows the client tier and business services to evolve independently.\n* Location Transparency: Clients remain unaffected by changes in the location or the instantiation of business services.\n* Reuse and Scalability: Business Delegate objects can be reused by multiple clients, and the pattern supports load balancing and scalability.\n\nTrade-offs:\n\n* Complexity: Introduces additional layers and abstractions, which may increase complexity.\n* Performance Overhead: The additional indirection may incur a slight performance penalty.\n\n## Related Java Design Patterns\n\n* [Service Locator](https://java-design-patterns.com/patterns/service-locator/): Business Delegate uses Service Locator to locate business services.\n* [Session Facade](https://java-design-patterns.com/patterns/session-facade/): Business Delegate may use Session Facade to provide a unified interface to a set of business services.\n* [Composite Entity](https://java-design-patterns.com/patterns/composite-entity/): Business Delegate may use Composite Entity to manage the state of business services.\n\n## References and Credits\n\n* [Core J2EE Patterns: Best Practices and Design Strategies](https://amzn.to/4cAbDap)\n* [J2EE Design Patterns](https://amzn.to/4dpzgmx)\n* [Patterns of Enterprise Application Architecture](https://amzn.to/3WfKBPR)\n"
},
{
"path": "business-delegate/etc/business-delegate.urm.puml",
"content": "@startuml\npackage com.iluwatar.business.delegate {\n class App {\n + App()\n + main(args : String[]) {static}\n }\n class BusinessDelegate {\n - lookupService : BusinessLookup\n + BusinessDelegate()\n + playbackMovie(movie : String)\n + setLookupService(lookupService : BusinessLookup)\n }\n class BusinessLookup {\n - netflixService : NetflixService\n - youTubeService : YouTubeService\n + BusinessLookup()\n + getBusinessService(movie : String) : VideoStreamingService\n + setNetflixService(netflixService : NetflixService)\n + setYouTubeService(youTubeService : YouTubeService)\n }\n class MobileClient {\n - businessDelegate : BusinessDelegate\n + MobileClient(businessDelegate : BusinessDelegate)\n + playbackMovie(movie : String)\n }\n class NetflixService {\n - LOGGER : Logger {static}\n + NetflixService()\n + doProcessing()\n }\n interface VideoStreamingService {\n + doProcessing() {abstract}\n }\n class YouTubeService {\n - LOGGER : Logger {static}\n + YouTubeService()\n + doProcessing()\n }\n}\nBusinessLookup --> \"-netflixService\" NetflixService\nBusinessLookup --> \"-youTubeService\" YouTubeService\nMobileClient --> \"-businessDelegate\" BusinessDelegate\nBusinessDelegate --> \"-lookupService\" BusinessLookup\nNetflixService ..|> VideoStreamingService \nYouTubeService ..|> VideoStreamingService \n@enduml"
},
{
"path": "business-delegate/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n business-delegate \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.mockito \n mockito-core \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.business.delegate.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\n/**\n * The Business Delegate pattern adds an abstraction layer between the presentation and business\n * tiers. By using the pattern we gain loose coupling between the tiers. The Business Delegate\n * encapsulates knowledge about how to locate, connect to, and interact with the business objects\n * that make up the application.\n *\n *
Some of the services the Business Delegate uses are instantiated directly, and some can be\n * retrieved through service lookups. The Business Delegate itself may contain business logic too\n * potentially tying together multiple service calls, exception handling, retrying etc.\n *\n *
In this example the client ({@link MobileClient}) utilizes a business delegate ( {@link\n * BusinessDelegate}) to search for movies in video streaming services. The Business Delegate then\n * selects the appropriate service and makes the service call.\n */\npublic class App {\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(String[] args) {\n\n // prepare the objects\n var businessDelegate = new BusinessDelegate();\n var businessLookup = new BusinessLookup();\n businessLookup.setNetflixService(new NetflixService());\n businessLookup.setYouTubeService(new YouTubeService());\n businessDelegate.setLookupService(businessLookup);\n\n // create the client and use the business delegate\n var client = new MobileClient(businessDelegate);\n client.playbackMovie(\"Die Hard 2\");\n client.playbackMovie(\"Maradona: The Greatest Ever\");\n }\n}\n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\nimport lombok.Setter;\n\n/** BusinessDelegate separates the presentation and business tiers. */\n@Setter\npublic class BusinessDelegate {\n\n private BusinessLookup lookupService;\n\n public void playbackMovie(String movie) {\n VideoStreamingService videoStreamingService = lookupService.getBusinessService(movie);\n videoStreamingService.doProcessing();\n }\n}\n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\nimport java.util.Locale;\nimport lombok.Setter;\n\n/** Class for performing service lookups. */\n@Setter\npublic class BusinessLookup {\n\n private NetflixService netflixService;\n\n private YouTubeService youTubeService;\n\n /**\n * Gets service instance based on given movie search string.\n *\n * @param movie Search string for the movie.\n * @return Service instance.\n */\n public VideoStreamingService getBusinessService(String movie) {\n if (movie.toLowerCase(Locale.ROOT).contains(\"die hard\")) {\n return netflixService;\n } else {\n return youTubeService;\n }\n }\n}\n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/MobileClient.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\n/** MobileClient utilizes BusinessDelegate to call the business tier. */\npublic class MobileClient {\n\n private final BusinessDelegate businessDelegate;\n\n public MobileClient(BusinessDelegate businessDelegate) {\n this.businessDelegate = businessDelegate;\n }\n\n public void playbackMovie(String movie) {\n businessDelegate.playbackMovie(movie);\n }\n}\n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/NetflixService.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** NetflixService implementation. */\n@Slf4j\npublic class NetflixService implements VideoStreamingService {\n\n @Override\n public void doProcessing() {\n LOGGER.info(\"NetflixService is now processing\");\n }\n}\n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/VideoStreamingService.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\n/** Interface for video streaming service implementations. */\npublic interface VideoStreamingService {\n\n void doProcessing();\n}\n"
},
{
"path": "business-delegate/src/main/java/com/iluwatar/business/delegate/YouTubeService.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** YouTubeService implementation. */\n@Slf4j\npublic class YouTubeService implements VideoStreamingService {\n\n @Override\n public void doProcessing() {\n LOGGER.info(\"YouTubeService is now processing\");\n }\n}\n"
},
{
"path": "business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests that Business Delegate example runs without errors. */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n *
Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.business.delegate;\n\nimport static org.mockito.ArgumentMatchers.anyString;\nimport static org.mockito.Mockito.spy;\nimport static org.mockito.Mockito.times;\nimport static org.mockito.Mockito.verify;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\n\n/** Tests for the {@link BusinessDelegate} */\nclass BusinessDelegateTest {\n\n private NetflixService netflixService;\n\n private YouTubeService youTubeService;\n\n private BusinessDelegate businessDelegate;\n\n /**\n * This method sets up the instance variables of this test class. It is executed before the\n * execution of every test.\n */\n @BeforeEach\n void setup() {\n netflixService = spy(new NetflixService());\n youTubeService = spy(new YouTubeService());\n\n BusinessLookup businessLookup = spy(new BusinessLookup());\n businessLookup.setNetflixService(netflixService);\n businessLookup.setYouTubeService(youTubeService);\n\n businessDelegate = spy(new BusinessDelegate());\n businessDelegate.setLookupService(businessLookup);\n }\n\n /**\n * In this example the client ({@link MobileClient}) utilizes a business delegate ( {@link\n * BusinessDelegate}) to execute a task. The Business Delegate then selects the appropriate\n * service and makes the service call.\n */\n @Test\n void testBusinessDelegate() {\n\n // setup a client object\n var client = new MobileClient(businessDelegate);\n\n // action\n client.playbackMovie(\"Die hard\");\n\n // verifying that the businessDelegate was used by client during playbackMovie() method.\n verify(businessDelegate).playbackMovie(anyString());\n verify(netflixService).doProcessing();\n\n // action\n client.playbackMovie(\"Maradona\");\n\n // verifying that the businessDelegate was used by client during doTask() method.\n verify(businessDelegate, times(2)).playbackMovie(anyString());\n verify(youTubeService).doProcessing();\n }\n}\n"
},
{
"path": "bytecode/README.md",
"content": "---\ntitle: \"Bytecode Pattern in Java: Interpreting Instructions with Custom Virtual Machines\"\nshortTitle: Bytecode\ndescription: \"Explore the Bytecode design pattern in Java, including its implementation, real-world examples, and use cases for efficient virtual machine instruction handling.\"\ncategory: Behavioral\nlanguage: en\ntag:\n - Abstraction\n - Code simplification\n - Encapsulation\n - Game programming\n - Performance\n - Runtime\n---\n\n## Intent of Bytecode Design Pattern\n\nThe Bytecode design pattern in Java allows encoding behavior as instructions for a virtual machine, making it a powerful tool in game development and other applications.\n\n## Detailed Explanation of Bytecode Pattern with Real-World Examples\n\nReal-world example\n\n> An analogous real-world example of the Bytecode design pattern can be seen in the process of translating a book into multiple languages. Instead of directly translating the book from the original language into every other language, the book is first translated into a common intermediate language, like Esperanto. This intermediate version is easier to translate because it is simpler and more structured. Translators for each target language then translate from Esperanto into their specific languages. This approach ensures consistency, reduces errors, and simplifies the translation process, similar to how bytecode serves as an intermediate representation to optimize and facilitate the execution of high-level programming languages across different platforms.\n\nIn plain words\n\n> Bytecode pattern enables behavior driven by data instead of code.\n\n[gameprogrammingpatterns.com](https://gameprogrammingpatterns.com/bytecode.html) documentation states:\n\n> An instruction set defines the low-level operations that can be performed. A series of instructions is encoded as a sequence of bytes. A virtual machine executes these instructions one at a time, using a stack for intermediate values. By combining instructions, complex high-level behavior can be defined.\n\nSequence diagram\n\n\n\n## Programmatic Example of Bytecode Pattern in Java\n\nIn this programmatic example, we show how the Bytecode pattern in Java can simplify the execution of complex virtual machine instructions through a well-defined set of operations. This real-world example demonstrates how the Bytecode design pattern in Java can streamline game programming by allowing wizards' behavior to be easily adjusted through bytecode instructions.\n\nA team is working on a new game where wizards battle against each other. The wizard behavior needs to be carefully adjusted and iterated hundreds of times through playtesting. It's not optimal to ask the programmer to make changes each time the game designer wants to vary the behavior, so the wizard behavior is implemented as a data-driven virtual machine.\n\nOne of the most important game objects is the `Wizard` class.\n\n```java\n\n@AllArgsConstructor\n@Setter\n@Getter\n@Slf4j\npublic class Wizard {\n\n private int health;\n private int agility;\n private int wisdom;\n private int numberOfPlayedSounds;\n private int numberOfSpawnedParticles;\n\n public void playSound() {\n LOGGER.info(\"Playing sound\");\n numberOfPlayedSounds++;\n }\n\n public void spawnParticles() {\n LOGGER.info(\"Spawning particles\");\n numberOfSpawnedParticles++;\n }\n}\n```\n\nNext, we show the available instructions for our virtual machine. Each of the instructions has its own semantics on how it operates with the stack data. For example, the ADD instruction takes the top two items from the stack, adds them together and pushes the result to the stack.\n\n```java\n\n@AllArgsConstructor\n@Getter\npublic enum Instruction {\n\n LITERAL(1), // e.g. \"LITERAL 0\", push 0 to stack\n SET_HEALTH(2), // e.g. \"SET_HEALTH\", pop health and wizard number, call set health\n SET_WISDOM(3), // e.g. \"SET_WISDOM\", pop wisdom and wizard number, call set wisdom\n SET_AGILITY(4), // e.g. \"SET_AGILITY\", pop agility and wizard number, call set agility\n PLAY_SOUND(5), // e.g. \"PLAY_SOUND\", pop value as wizard number, call play sound\n SPAWN_PARTICLES(6), // e.g. \"SPAWN_PARTICLES\", pop value as wizard number, call spawn particles\n GET_HEALTH(7), // e.g. \"GET_HEALTH\", pop value as wizard number, push wizard's health\n GET_AGILITY(8), // e.g. \"GET_AGILITY\", pop value as wizard number, push wizard's agility\n GET_WISDOM(9), // e.g. \"GET_WISDOM\", pop value as wizard number, push wizard's wisdom\n ADD(10), // e.g. \"ADD\", pop 2 values, push their sum\n DIVIDE(11); // e.g. \"DIVIDE\", pop 2 values, push their division\n \n // Other properties and methods...\n}\n```\n\nAt the heart of our example is the `VirtualMachine` class. It takes instructions as input and executes them to provide the game object behavior.\n\n```java\n\n@Getter\n@Slf4j\npublic class VirtualMachine {\n\n private final Stack stack = new Stack<>();\n\n private final Wizard[] wizards = new Wizard[2];\n\n public VirtualMachine() {\n wizards[0] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32),\n 0, 0);\n wizards[1] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32),\n 0, 0);\n }\n\n public VirtualMachine(Wizard wizard1, Wizard wizard2) {\n wizards[0] = wizard1;\n wizards[1] = wizard2;\n }\n\n public void execute(int[] bytecode) {\n for (var i = 0; i < bytecode.length; i++) {\n Instruction instruction = Instruction.getInstruction(bytecode[i]);\n switch (instruction) {\n case LITERAL:\n // Read the next byte from the bytecode.\n int value = bytecode[++i];\n // Push the next value to stack\n stack.push(value);\n break;\n case SET_AGILITY:\n var amount = stack.pop();\n var wizard = stack.pop();\n setAgility(wizard, amount);\n break;\n case SET_WISDOM:\n amount = stack.pop();\n wizard = stack.pop();\n setWisdom(wizard, amount);\n break;\n case SET_HEALTH:\n amount = stack.pop();\n wizard = stack.pop();\n setHealth(wizard, amount);\n break;\n case GET_HEALTH:\n wizard = stack.pop();\n stack.push(getHealth(wizard));\n break;\n case GET_AGILITY:\n wizard = stack.pop();\n stack.push(getAgility(wizard));\n break;\n case GET_WISDOM:\n wizard = stack.pop();\n stack.push(getWisdom(wizard));\n break;\n case ADD:\n var a = stack.pop();\n var b = stack.pop();\n stack.push(a + b);\n break;\n case DIVIDE:\n a = stack.pop();\n b = stack.pop();\n stack.push(b / a);\n break;\n case PLAY_SOUND:\n wizard = stack.pop();\n getWizards()[wizard].playSound();\n break;\n case SPAWN_PARTICLES:\n wizard = stack.pop();\n getWizards()[wizard].spawnParticles();\n break;\n default:\n throw new IllegalArgumentException(\"Invalid instruction value\");\n }\n LOGGER.info(\"Executed \" + instruction.name() + \", Stack contains \" + getStack());\n }\n }\n\n public void setHealth(int wizard, int amount) {\n wizards[wizard].setHealth(amount);\n }\n\n // Other properties and methods...\n}\n```\n\nNow we can show the full example utilizing the virtual machine.\n\n```java\npublic static void main(String[] args) {\n\n var vm = new VirtualMachine(\n new Wizard(45, 7, 11, 0, 0),\n new Wizard(36, 18, 8, 0, 0));\n\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(String.format(HEALTH_PATTERN, \"GET\")));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(GET_AGILITY));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(GET_WISDOM));\n vm.execute(InstructionConverterUtil.convertToByteCode(ADD));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_2));\n vm.execute(InstructionConverterUtil.convertToByteCode(DIVIDE));\n vm.execute(InstructionConverterUtil.convertToByteCode(ADD));\n vm.execute(InstructionConverterUtil.convertToByteCode(String.format(HEALTH_PATTERN, \"SET\")));\n}\n```\n\nHere is the console output.\n\n```\n16:20:10.193 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0]\n16:20:10.196 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 0]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed GET_HEALTH, Stack contains [0, 45]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 45, 0]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed GET_AGILITY, Stack contains [0, 45, 7]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 45, 7, 0]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed GET_WISDOM, Stack contains [0, 45, 7, 11]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed ADD, Stack contains [0, 45, 18]\n16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 45, 18, 2]\n16:20:10.198 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed DIVIDE, Stack contains [0, 45, 9]\n16:20:10.198 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed ADD, Stack contains [0, 54]\n16:20:10.198 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed SET_HEALTH, Stack contains []\n```\n\nUtilizing the Bytecode design pattern in Java can significantly enhance the flexibility and maintainability of your virtual machine-based applications.\n\n## When to Use the Bytecode Pattern in Java\n\nUse the Bytecode pattern when you have a lot of behavior you need to define and your game’s implementation language isn’t a good fit because:\n\n* It’s too low-level, making it tedious or error-prone to program in.\n* Iterating on it takes too long due to slow compile times or other tooling issues.\n* It has too much trust. If you want to ensure the behavior being defined can’t break the game, you need to sandbox it from the rest of the codebase.\n\n## Real-World Applications of Bytecode Pattern in Java\n\n* Java Virtual Machine (JVM) uses bytecode to allow Java programs to run on any device that has JVM installed\n* Python compiles its scripts to bytecode which is then interpreted by Python Virtual Machine\n* The .NET Framework uses a form of bytecode called Microsoft Intermediate Language (MSIL)\n\n## Benefits and Trade-offs of Bytecode Pattern\n\nBenefits:\n\n* Portability: Programs can run on any platform that has a compatible VM.\n* Security: The VM can enforce security checks on the bytecode.\n* Performance: JIT compilers can optimize bytecode at runtime, potentially improving performance over interpreted code.\n\nTrade-offs:\n\n* Overhead: Running bytecode typically involves more overhead than running native code, potentially affecting performance.\n* Complexity: Implementing and maintaining a VM adds complexity to the system.\n\n## Related Java Design Patterns\n\n* [Interpreter](https://java-design-patterns.com/patterns/interpreter/) is often used within the implementation of VMs to interpret bytecode instructions\n* [Command](https://java-design-patterns.com/patterns/command/): Bytecode instructions can be seen as commands executed by the VM.\n* [Factory Method](https://java-design-patterns.com/patterns/factory-method/): VMs may use factory methods to instantiate operations or instructions defined in the bytecode.\n\n## References and Credits\n\n* [Game Programming Patterns](https://amzn.to/3K96fOn)\n* [Programming Language Pragmatics](https://amzn.to/49Tusnn)\n* [Bytecode (Game Programming Patterns)](http://gameprogrammingpatterns.com/bytecode.html)\n"
},
{
"path": "bytecode/etc/bytecode.urm.puml",
"content": "@startuml\npackage com.iluwatar.bytecode {\n class App {\n - LOGGER : Logger {static}\n + App()\n + main(args : String[]) {static}\n }\n enum Instruction {\n + ADD {static}\n + DIVIDE {static}\n + GET_AGILITY {static}\n + GET_HEALTH {static}\n + GET_WISDOM {static}\n + LITERAL {static}\n + PLAY_SOUND {static}\n + SET_AGILITY {static}\n + SET_HEALTH {static}\n + SET_WISDOM {static}\n + SPAWN_PARTICLES {static}\n - intValue : int\n + getInstruction(value : int) : Instruction {static}\n + getIntValue() : int\n + valueOf(name : String) : Instruction {static}\n + values() : Instruction[] {static}\n }\n class VirtualMachine {\n - LOGGER : Logger {static}\n - stack : Stack\n - wizards : Wizard[]\n + VirtualMachine()\n + VirtualMachine(wizard1 : Wizard, wizard2 : Wizard)\n + execute(bytecode : int[])\n + getAgility(wizard : int) : int\n + getHealth(wizard : int) : int\n + getStack() : Stack\n + getWisdom(wizard : int) : int\n + getWizards() : Wizard[]\n - randomInt(min : int, max : int) : int\n + setAgility(wizard : int, amount : int)\n + setHealth(wizard : int, amount : int)\n + setWisdom(wizard : int, amount : int)\n }\n class Wizard {\n - LOGGER : Logger {static}\n - agility : int\n - health : int\n - numberOfPlayedSounds : int\n - numberOfSpawnedParticles : int\n - wisdom : int\n + Wizard(health : int, agility : int, wisdom : int, numberOfPlayedSounds : int, numberOfSpawnedParticles : int)\n + getAgility() : int\n + getHealth() : int\n + getNumberOfPlayedSounds() : int\n + getNumberOfSpawnedParticles() : int\n + getWisdom() : int\n + playSound()\n + setAgility(agility : int)\n + setHealth(health : int)\n + setNumberOfPlayedSounds(numberOfPlayedSounds : int)\n + setNumberOfSpawnedParticles(numberOfSpawnedParticles : int)\n + setWisdom(wisdom : int)\n + spawnParticles()\n }\n}\npackage com.iluwatar.bytecode.util {\n class InstructionConverterUtil {\n + InstructionConverterUtil()\n + convertToByteCode(instructions : String) : int[] {static}\n - isValidInstruction(instruction : String) : boolean {static}\n - isValidInt(value : String) : boolean {static}\n }\n}\n@enduml"
},
{
"path": "bytecode/pom.xml",
"content": "\n\n\n \n java-design-patterns \n com.iluwatar \n 1.26.0-SNAPSHOT \n \n 4.0.0 \n bytecode \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.bytecode.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "bytecode/src/main/java/com/iluwatar/bytecode/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode;\n\nimport com.iluwatar.bytecode.util.InstructionConverterUtil;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * The intention of Bytecode pattern is to give behavior the flexibility of data by encoding it as\n * instructions for a virtual machine. An instruction set defines the low-level operations that can\n * be performed. A series of instructions is encoded as a sequence of bytes. A virtual machine\n * executes these instructions one at a time, using a stack for intermediate values. By combining\n * instructions, complex high-level behavior can be defined.\n *\n * This pattern should be used when there is a need to define high number of behaviours and\n * implementation engine is not a good choice because It is too lowe level Iterating on it takes too\n * long due to slow compile times or other tooling issues. It has too much trust. If you want to\n * ensure the behavior being defined can’t break the game, you need to sandbox it from the rest of\n * the codebase.\n */\n@Slf4j\npublic class App {\n\n private static final String LITERAL_0 = \"LITERAL 0\";\n private static final String HEALTH_PATTERN = \"%s_HEALTH\";\n private static final String GET_AGILITY = \"GET_AGILITY\";\n private static final String GET_WISDOM = \"GET_WISDOM\";\n private static final String ADD = \"ADD\";\n private static final String LITERAL_2 = \"LITERAL 2\";\n private static final String DIVIDE = \"DIVIDE\";\n\n /**\n * Main app method.\n *\n * @param args command line args\n */\n public static void main(String[] args) {\n\n var vm = new VirtualMachine(new Wizard(45, 7, 11, 0, 0), new Wizard(36, 18, 8, 0, 0));\n\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(String.format(HEALTH_PATTERN, \"GET\")));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(GET_AGILITY));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_0));\n vm.execute(InstructionConverterUtil.convertToByteCode(GET_WISDOM));\n vm.execute(InstructionConverterUtil.convertToByteCode(ADD));\n vm.execute(InstructionConverterUtil.convertToByteCode(LITERAL_2));\n vm.execute(InstructionConverterUtil.convertToByteCode(DIVIDE));\n vm.execute(InstructionConverterUtil.convertToByteCode(ADD));\n vm.execute(InstructionConverterUtil.convertToByteCode(String.format(HEALTH_PATTERN, \"SET\")));\n }\n}\n"
},
{
"path": "bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Getter;\n\n/** Representation of instructions understandable by virtual machine. */\n@AllArgsConstructor\n@Getter\npublic enum Instruction {\n LITERAL(1), // e.g. \"LITERAL 0\", push 0 to stack\n SET_HEALTH(2), // e.g. \"SET_HEALTH\", pop health and wizard number, call set health\n SET_WISDOM(3), // e.g. \"SET_WISDOM\", pop wisdom and wizard number, call set wisdom\n SET_AGILITY(4), // e.g. \"SET_AGILITY\", pop agility and wizard number, call set agility\n PLAY_SOUND(5), // e.g. \"PLAY_SOUND\", pop value as wizard number, call play sound\n SPAWN_PARTICLES(6), // e.g. \"SPAWN_PARTICLES\", pop value as wizard number, call spawn particles\n GET_HEALTH(7), // e.g. \"GET_HEALTH\", pop value as wizard number, push wizard's health\n GET_AGILITY(8), // e.g. \"GET_AGILITY\", pop value as wizard number, push wizard's agility\n GET_WISDOM(9), // e.g. \"GET_WISDOM\", pop value as wizard number, push wizard's wisdom\n ADD(10), // e.g. \"ADD\", pop 2 values, push their sum\n DIVIDE(11); // e.g. \"DIVIDE\", pop 2 values, push their division\n\n private final int intValue;\n\n /**\n * Converts integer value to Instruction.\n *\n * @param value value of instruction\n * @return representation of the instruction\n */\n public static Instruction getInstruction(int value) {\n for (var i = 0; i < Instruction.values().length; i++) {\n if (Instruction.values()[i].getIntValue() == value) {\n return Instruction.values()[i];\n }\n }\n throw new IllegalArgumentException(\"Invalid instruction value\");\n }\n}\n"
},
{
"path": "bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode;\n\nimport java.util.Stack;\nimport java.util.concurrent.ThreadLocalRandom;\nimport lombok.Getter;\nimport lombok.extern.slf4j.Slf4j;\n\n/** Implementation of virtual machine. */\n@Getter\n@Slf4j\npublic class VirtualMachine {\n\n private final Stack stack = new Stack<>();\n\n private final Wizard[] wizards = new Wizard[2];\n\n /** No-args constructor. */\n public VirtualMachine() {\n wizards[0] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32), 0, 0);\n wizards[1] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32), 0, 0);\n }\n\n /** Constructor taking the wizards as arguments. */\n public VirtualMachine(Wizard wizard1, Wizard wizard2) {\n wizards[0] = wizard1;\n wizards[1] = wizard2;\n }\n\n /**\n * Executes provided bytecode.\n *\n * @param bytecode to execute\n */\n public void execute(int[] bytecode) {\n for (var i = 0; i < bytecode.length; i++) {\n Instruction instruction = Instruction.getInstruction(bytecode[i]);\n switch (instruction) {\n case LITERAL -> { // Read the next byte from the bytecode.\n int value = bytecode[++i];\n // Push the next value to stack\n stack.push(value);\n }\n case SET_AGILITY -> {\n var amount = stack.pop();\n var wizard = stack.pop();\n setAgility(wizard, amount);\n }\n case SET_WISDOM -> {\n var amount = stack.pop();\n var wizard = stack.pop();\n setWisdom(wizard, amount);\n }\n case SET_HEALTH -> {\n var amount = stack.pop();\n var wizard = stack.pop();\n setHealth(wizard, amount);\n }\n case GET_HEALTH -> {\n var wizard = stack.pop();\n stack.push(getHealth(wizard));\n }\n case GET_AGILITY -> {\n var wizard = stack.pop();\n stack.push(getAgility(wizard));\n }\n case GET_WISDOM -> {\n var wizard = stack.pop();\n stack.push(getWisdom(wizard));\n }\n case ADD -> {\n var a = stack.pop();\n var b = stack.pop();\n stack.push(a + b);\n }\n case DIVIDE -> {\n var a = stack.pop();\n var b = stack.pop();\n stack.push(b / a);\n }\n case PLAY_SOUND -> {\n var wizard = stack.pop();\n getWizards()[wizard].playSound();\n }\n case SPAWN_PARTICLES -> {\n var wizard = stack.pop();\n getWizards()[wizard].spawnParticles();\n }\n default -> {\n throw new IllegalArgumentException(\"Invalid instruction value\");\n }\n }\n LOGGER.info(\"Executed \" + instruction.name() + \", Stack contains \" + getStack());\n }\n }\n\n public void setHealth(int wizard, int amount) {\n wizards[wizard].setHealth(amount);\n }\n\n public void setWisdom(int wizard, int amount) {\n wizards[wizard].setWisdom(amount);\n }\n\n public void setAgility(int wizard, int amount) {\n wizards[wizard].setAgility(amount);\n }\n\n public int getHealth(int wizard) {\n return wizards[wizard].getHealth();\n }\n\n public int getWisdom(int wizard) {\n return wizards[wizard].getWisdom();\n }\n\n public int getAgility(int wizard) {\n return wizards[wizard].getAgility();\n }\n\n private int randomInt(int min, int max) {\n return ThreadLocalRandom.current().nextInt(min, max + 1);\n }\n}\n"
},
{
"path": "bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Getter;\nimport lombok.Setter;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * This class represent game objects which properties can be changed by instructions interpreted by\n * virtual machine.\n */\n@AllArgsConstructor\n@Setter\n@Getter\n@Slf4j\npublic class Wizard {\n\n private int health;\n private int agility;\n private int wisdom;\n private int numberOfPlayedSounds;\n private int numberOfSpawnedParticles;\n\n public void playSound() {\n LOGGER.info(\"Playing sound\");\n numberOfPlayedSounds++;\n }\n\n public void spawnParticles() {\n LOGGER.info(\"Spawning particles\");\n numberOfSpawnedParticles++;\n }\n}\n"
},
{
"path": "bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode.util;\n\nimport com.iluwatar.bytecode.Instruction;\n\n/** Utility class used for instruction validation and conversion. */\npublic class InstructionConverterUtil {\n /**\n * Converts instructions represented as String.\n *\n * @param instructions to convert\n * @return array of int representing bytecode\n */\n public static int[] convertToByteCode(String instructions) {\n if (instructions == null || instructions.trim().length() == 0) {\n return new int[0];\n }\n\n var splitedInstructions = instructions.trim().split(\" \");\n var bytecode = new int[splitedInstructions.length];\n for (var i = 0; i < splitedInstructions.length; i++) {\n if (isValidInstruction(splitedInstructions[i])) {\n bytecode[i] = Instruction.valueOf(splitedInstructions[i]).getIntValue();\n } else if (isValidInt(splitedInstructions[i])) {\n bytecode[i] = Integer.parseInt(splitedInstructions[i]);\n } else {\n var errorMessage = \"Invalid instruction or number: \" + splitedInstructions[i];\n throw new IllegalArgumentException(errorMessage);\n }\n }\n\n return bytecode;\n }\n\n private static boolean isValidInstruction(String instruction) {\n try {\n Instruction.valueOf(instruction);\n return true;\n } catch (IllegalArgumentException e) {\n return false;\n }\n }\n\n private static boolean isValidInt(String value) {\n try {\n Integer.parseInt(value);\n return true;\n } catch (NumberFormatException e) {\n return false;\n }\n }\n}\n"
},
{
"path": "bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Application test */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n * Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode;\n\nimport static com.iluwatar.bytecode.Instruction.*;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.junit.jupiter.api.Assertions.assertThrows;\n\nimport org.junit.jupiter.api.Test;\n\n/** Test for {@link VirtualMachine} */\nclass VirtualMachineTest {\n\n @Test\n void testLiteral() {\n var bytecode = new int[2];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = 10;\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(1, vm.getStack().size());\n assertEquals(Integer.valueOf(10), vm.getStack().pop());\n }\n\n @Test\n void testSetHealth() {\n var wizardNumber = 0;\n var bytecode = new int[5];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = wizardNumber;\n bytecode[2] = LITERAL.getIntValue();\n bytecode[3] = 50; // health amount\n bytecode[4] = SET_HEALTH.getIntValue();\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(50, vm.getWizards()[wizardNumber].getHealth());\n }\n\n @Test\n void testSetAgility() {\n var wizardNumber = 0;\n var bytecode = new int[5];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = wizardNumber;\n bytecode[2] = LITERAL.getIntValue();\n bytecode[3] = 50; // agility amount\n bytecode[4] = SET_AGILITY.getIntValue();\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(50, vm.getWizards()[wizardNumber].getAgility());\n }\n\n @Test\n void testSetWisdom() {\n var wizardNumber = 0;\n var bytecode = new int[5];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = wizardNumber;\n bytecode[2] = LITERAL.getIntValue();\n bytecode[3] = 50; // wisdom amount\n bytecode[4] = SET_WISDOM.getIntValue();\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(50, vm.getWizards()[wizardNumber].getWisdom());\n }\n\n @Test\n void testGetHealth() {\n var wizardNumber = 0;\n var bytecode = new int[8];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = wizardNumber;\n bytecode[2] = LITERAL.getIntValue();\n bytecode[3] = 50; // health amount\n bytecode[4] = SET_HEALTH.getIntValue();\n bytecode[5] = LITERAL.getIntValue();\n bytecode[6] = wizardNumber;\n bytecode[7] = GET_HEALTH.getIntValue();\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(Integer.valueOf(50), vm.getStack().pop());\n }\n\n @Test\n void testPlaySound() {\n var wizardNumber = 0;\n var bytecode = new int[3];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = wizardNumber;\n bytecode[2] = PLAY_SOUND.getIntValue();\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(0, vm.getStack().size());\n assertEquals(1, vm.getWizards()[0].getNumberOfPlayedSounds());\n }\n\n @Test\n void testSpawnParticles() {\n var wizardNumber = 0;\n var bytecode = new int[3];\n bytecode[0] = LITERAL.getIntValue();\n bytecode[1] = wizardNumber;\n bytecode[2] = SPAWN_PARTICLES.getIntValue();\n\n var vm = new VirtualMachine();\n vm.execute(bytecode);\n\n assertEquals(0, vm.getStack().size());\n assertEquals(1, vm.getWizards()[0].getNumberOfSpawnedParticles());\n }\n\n @Test\n void testInvalidInstruction() {\n var bytecode = new int[1];\n bytecode[0] = 999;\n var vm = new VirtualMachine();\n\n assertThrows(IllegalArgumentException.class, () -> vm.execute(bytecode));\n }\n}\n"
},
{
"path": "bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.bytecode.util;\n\nimport com.iluwatar.bytecode.Instruction;\nimport org.junit.jupiter.api.Assertions;\nimport org.junit.jupiter.api.Test;\n\n/** Test for {@link InstructionConverterUtil} */\nclass InstructionConverterUtilTest {\n\n @Test\n void testEmptyInstruction() {\n var instruction = \"\";\n\n var bytecode = InstructionConverterUtil.convertToByteCode(instruction);\n\n Assertions.assertEquals(0, bytecode.length);\n }\n\n @Test\n void testInstructions() {\n var instructions =\n \"LITERAL 35 SET_HEALTH SET_WISDOM SET_AGILITY PLAY_SOUND\"\n + \" SPAWN_PARTICLES GET_HEALTH ADD DIVIDE\";\n\n var bytecode = InstructionConverterUtil.convertToByteCode(instructions);\n\n Assertions.assertEquals(10, bytecode.length);\n Assertions.assertEquals(Instruction.LITERAL.getIntValue(), bytecode[0]);\n Assertions.assertEquals(35, bytecode[1]);\n Assertions.assertEquals(Instruction.SET_HEALTH.getIntValue(), bytecode[2]);\n Assertions.assertEquals(Instruction.SET_WISDOM.getIntValue(), bytecode[3]);\n Assertions.assertEquals(Instruction.SET_AGILITY.getIntValue(), bytecode[4]);\n Assertions.assertEquals(Instruction.PLAY_SOUND.getIntValue(), bytecode[5]);\n Assertions.assertEquals(Instruction.SPAWN_PARTICLES.getIntValue(), bytecode[6]);\n Assertions.assertEquals(Instruction.GET_HEALTH.getIntValue(), bytecode[7]);\n Assertions.assertEquals(Instruction.ADD.getIntValue(), bytecode[8]);\n Assertions.assertEquals(Instruction.DIVIDE.getIntValue(), bytecode[9]);\n }\n}\n"
},
{
"path": "caching/.gitignore",
"content": "/target/\n"
},
{
"path": "caching/README.md",
"content": "---\ntitle: \"Caching Pattern in Java: Accelerating Data Access Speeds\"\nshortTitle: Caching\ndescription: \"Learn how to optimize performance with the Java Caching Design Pattern. Explore various caching strategies, real-world examples, and implementation techniques for efficient resource management.\"\ncategory: Performance optimization\nlanguage: en\ntag:\n - Caching\n - Data access\n - Performance\n - Resource management\n---\n\n## Also known as\n\n* Cache\n* Temporary Storage\n\n## Intent of Caching Design Pattern\n\nThe Java Caching Design Pattern is crucial for performance optimization and resource management. It involves various caching strategies such as write-through, read-through, and LRU cache to ensure efficient data access. The caching pattern avoids expensive re-acquisition of resources by not releasing them immediately after use. The resources retain their identity, are kept in some fast-access storage, and are re-used to avoid having to acquire them again.\n\n## Detailed Explanation of Caching Pattern with Real-World Examples\n\nReal-world example\n\n> A real-world example of the Caching Design Pattern in Java is a library's catalog system. By caching frequently searched book results, the system reduces database load and enhances performance. When patrons frequently search for popular books, the system can cache the results of these searches. Instead of querying the database every time a user searches for a popular book, the system quickly retrieves the results from the cache. This reduces the load on the database and provides faster response times for users, enhancing their overall experience. However, the system must also ensure that the cache is updated when new books are added or existing ones are checked out, to maintain accurate information.\n\nIn plain words\n\n> Caching pattern keeps frequently needed data in fast-access storage to improve performance.\n\nWikipedia says\n\n> In computing, a cache is a hardware or software component that stores data so that future requests for that data can be served faster; the data stored in a cache might be the result of an earlier computation or a copy of data stored elsewhere. A cache hit occurs when the requested data can be found in a cache, while a cache miss occurs when it cannot. Cache hits are served by reading data from the cache, which is faster than recomputing a result or reading from a slower data store; thus, the more requests that can be served from the cache, the faster the system performs.\n\nFlowchart\n\n\n\n## Programmatic Example of Caching Pattern in Java\n\nIn this programmatic example, we demonstrate different Java caching strategies, including write-through, write-around, and write-behind, using a user account management system.\n\nA team is working on a website that provides new homes for abandoned cats. People can post their cats on the website after registering, but all the new posts require approval from one of the site moderators. The user accounts of the site moderators contain a specific flag and the data is stored in a MongoDB database. Checking for the moderator flag each time a post is viewed becomes expensive, and it's a good idea to utilize caching here.\n\nLet's first look at the data layer of our application. The interesting classes are `UserAccount` which is a simple Java object containing the user account details, and `DbManager` interface which handles reading and writing of these objects to/from database.\n\n```java\n\n@Data\n@AllArgsConstructor\n@ToString\n@EqualsAndHashCode\npublic class UserAccount {\n private String userId;\n private String userName;\n private String additionalInfo;\n}\n\npublic interface DbManager {\n\n void connect();\n\n void disconnect();\n\n UserAccount readFromDb(String userId);\n\n UserAccount writeToDb(UserAccount userAccount);\n\n UserAccount updateDb(UserAccount userAccount);\n\n UserAccount upsertDb(UserAccount userAccount);\n}\n```\n\nIn the example, we are demonstrating various different caching policies. The following caching strategies are implemented in Java: Write-through, Write-around, Write-behind, and Cache-aside. Each strategy offers unique benefits for improving performance and reducing load on the database.\n\n* Write-through writes data to the cache and DB in a single transaction\n* Write-around writes data immediately into the DB instead of the cache\n* Write-behind writes data into the cache initially whilst the data is only written into the DB when the cache is full\n* Cache-aside pushes the responsibility of keeping the data synchronized in both data sources to the application itself\n* Read-through strategy is also included in the aforementioned strategies, and it returns data from the cache to the caller if it exists, otherwise queries from DB and stores it into the cache for future use.\n\nThe cache implementation in `LruCache` is a hash table accompanied by a doubly linked-list. The linked-list helps in capturing and maintaining the LRU data in the cache. When data is queried (from the cache), added (to the cache), or updated, the data is moved to the front of the list to depict itself as the most-recently-used data. The LRU data is always at the end of the list.\n\n```java\n\n@Slf4j\npublic class LruCache {\n\n static class Node {\n String userId;\n UserAccount userAccount;\n Node previous;\n Node next;\n\n public Node(String userId, UserAccount userAccount) {\n this.userId = userId;\n this.userAccount = userAccount;\n }\n }\n\n // Other properties and methods...\n\n public LruCache(int capacity) {\n this.capacity = capacity;\n }\n\n public UserAccount get(String userId) {\n if (cache.containsKey(userId)) {\n var node = cache.get(userId);\n remove(node);\n setHead(node);\n return node.userAccount;\n }\n return null;\n }\n\n public void set(String userId, UserAccount userAccount) {\n if (cache.containsKey(userId)) {\n var old = cache.get(userId);\n old.userAccount = userAccount;\n remove(old);\n setHead(old);\n } else {\n var newNode = new Node(userId, userAccount);\n if (cache.size() >= capacity) {\n LOGGER.info(\"# Cache is FULL! Removing {} from cache...\", end.userId);\n cache.remove(end.userId); // remove LRU data from cache.\n remove(end);\n setHead(newNode);\n } else {\n setHead(newNode);\n }\n cache.put(userId, newNode);\n }\n }\n\n public boolean contains(String userId) {\n return cache.containsKey(userId);\n }\n\n public void remove(Node node) { /* ... */ }\n\n public void setHead(Node node) { /* ... */ }\n\n public void invalidate(String userId) { /* ... */ }\n\n public boolean isFull() { /* ... */ }\n\n public UserAccount getLruData() { /* ... */ }\n\n public void clear() { /* ... */ }\n\n public List getCacheDataInListForm() { /* ... */ }\n\n public void setCapacity(int newCapacity) { /* ... */ }\n}\n```\n\nThe next layer we are going to look at is `CacheStore` which implements the different caching strategies.\n\n```java\n\n@Slf4j\npublic class CacheStore {\n\n private static final int CAPACITY = 3;\n private static LruCache cache;\n private final DbManager dbManager;\n\n // Other properties and methods...\n\n public UserAccount readThrough(final String userId) {\n if (cache.contains(userId)) {\n LOGGER.info(\"# Found in Cache!\");\n return cache.get(userId);\n }\n LOGGER.info(\"# Not found in cache! Go to DB!!\");\n UserAccount userAccount = dbManager.readFromDb(userId);\n cache.set(userId, userAccount);\n return userAccount;\n }\n\n public void writeThrough(final UserAccount userAccount) {\n if (cache.contains(userAccount.getUserId())) {\n dbManager.updateDb(userAccount);\n } else {\n dbManager.writeToDb(userAccount);\n }\n cache.set(userAccount.getUserId(), userAccount);\n }\n\n public void writeAround(final UserAccount userAccount) {\n if (cache.contains(userAccount.getUserId())) {\n dbManager.updateDb(userAccount);\n // Cache data has been updated -- remove older\n cache.invalidate(userAccount.getUserId());\n // version from cache.\n } else {\n dbManager.writeToDb(userAccount);\n }\n }\n\n public static void clearCache() {\n if (cache != null) {\n cache.clear();\n }\n }\n\n public static void flushCache() {\n LOGGER.info(\"# flushCache...\");\n Optional.ofNullable(cache)\n .map(LruCache::getCacheDataInListForm)\n .orElse(List.of())\n .forEach(DbManager::updateDb);\n }\n\n // ... omitted the implementation of other caching strategies ...\n\n}\n```\n\n`AppManager` helps to bridge the gap in communication between the main class and the application's back-end. DB connection is initialized through this class. The chosen caching strategy/policy is also initialized here. Before the cache can be used, the size of the cache has to be set. Depending on the chosen caching policy, `AppManager` will call the appropriate function in the `CacheStore` class.\n\n```java\n\n@Slf4j\npublic final class AppManager {\n\n private static CachingPolicy cachingPolicy;\n private final DbManager dbManager;\n private final CacheStore cacheStore;\n\n private AppManager() {\n }\n\n public void initDb() { /* ... */ }\n\n public static void initCachingPolicy(CachingPolicy policy) { /* ... */ }\n\n public static void initCacheCapacity(int capacity) { /* ... */ }\n\n public UserAccount find(final String userId) {\n LOGGER.info(\"Trying to find {} in cache\", userId);\n if (cachingPolicy == CachingPolicy.THROUGH\n || cachingPolicy == CachingPolicy.AROUND) {\n return cacheStore.readThrough(userId);\n } else if (cachingPolicy == CachingPolicy.BEHIND) {\n return cacheStore.readThroughWithWriteBackPolicy(userId);\n } else if (cachingPolicy == CachingPolicy.ASIDE) {\n return findAside(userId);\n }\n return null;\n }\n\n public void save(final UserAccount userAccount) {\n LOGGER.info(\"Save record!\");\n if (cachingPolicy == CachingPolicy.THROUGH) {\n cacheStore.writeThrough(userAccount);\n } else if (cachingPolicy == CachingPolicy.AROUND) {\n cacheStore.writeAround(userAccount);\n } else if (cachingPolicy == CachingPolicy.BEHIND) {\n cacheStore.writeBehind(userAccount);\n } else if (cachingPolicy == CachingPolicy.ASIDE) {\n saveAside(userAccount);\n }\n }\n\n public static String printCacheContent() {\n return CacheStore.print();\n }\n\n // Other properties and methods...\n}\n```\n\nHere is what we do in the main class of the application.\n\n```java\n\n@Slf4j\npublic class App {\n\n public static void main(final String[] args) {\n boolean isDbMongo = isDbMongo(args);\n if (isDbMongo) {\n LOGGER.info(\"Using the Mongo database engine to run the application.\");\n } else {\n LOGGER.info(\"Using the 'in Memory' database to run the application.\");\n }\n App app = new App(isDbMongo);\n app.useReadAndWriteThroughStrategy();\n String splitLine = \"==============================================\";\n LOGGER.info(splitLine);\n app.useReadThroughAndWriteAroundStrategy();\n LOGGER.info(splitLine);\n app.useReadThroughAndWriteBehindStrategy();\n LOGGER.info(splitLine);\n app.useCacheAsideStategy();\n LOGGER.info(splitLine);\n }\n\n public void useReadAndWriteThroughStrategy() {\n LOGGER.info(\"# CachingPolicy.THROUGH\");\n appManager.initCachingPolicy(CachingPolicy.THROUGH);\n\n var userAccount1 = new UserAccount(\"001\", \"John\", \"He is a boy.\");\n\n appManager.save(userAccount1);\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"001\");\n appManager.find(\"001\");\n }\n\n public void useReadThroughAndWriteAroundStrategy() { /* ... */ }\n\n public void useReadThroughAndWriteBehindStrategy() { /* ... */ }\n\n public void useCacheAsideStrategy() { /* ... */ }\n}\n```\n\nThe program output:\n\n```\n17:00:56.302 [main] INFO com.iluwatar.caching.App -- Using the 'in Memory' database to run the application.\n17:00:56.304 [main] INFO com.iluwatar.caching.App -- # CachingPolicy.THROUGH\n17:00:56.305 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.308 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=001, userName=John, additionalInfo=He is a boy.)\n----\n17:00:56.308 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 001 in cache\n17:00:56.309 [main] INFO com.iluwatar.caching.CacheStore -- # Found in Cache!\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 001 in cache\n17:00:56.309 [main] INFO com.iluwatar.caching.CacheStore -- # Found in Cache!\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- ==============================================\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- # CachingPolicy.AROUND\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\n----\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 002 in cache\n17:00:56.309 [main] INFO com.iluwatar.caching.CacheStore -- # Not found in cache! Go to DB!!\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=002, userName=Jane, additionalInfo=She is a girl.)\n----\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 002 in cache\n17:00:56.309 [main] INFO com.iluwatar.caching.CacheStore -- # Found in Cache!\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.309 [main] INFO com.iluwatar.caching.LruCache -- # 002 has been updated! Removing older version from cache...\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\n----\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 002 in cache\n17:00:56.309 [main] INFO com.iluwatar.caching.CacheStore -- # Not found in cache! Go to DB!!\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=002, userName=Jane G., additionalInfo=She is a girl.)\n----\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 002 in cache\n17:00:56.309 [main] INFO com.iluwatar.caching.CacheStore -- # Found in Cache!\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- ==============================================\n17:00:56.309 [main] INFO com.iluwatar.caching.App -- # CachingPolicy.BEHIND\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.309 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=005, userName=Isaac, additionalInfo=He is allergic to mustard.)\nUserAccount(userId=004, userName=Rita, additionalInfo=She hates cats.)\nUserAccount(userId=003, userName=Adam, additionalInfo=He likes food.)\n----\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 003 in cache\n17:00:56.310 [main] INFO com.iluwatar.caching.CacheStore -- # Found in cache!\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=003, userName=Adam, additionalInfo=He likes food.)\nUserAccount(userId=005, userName=Isaac, additionalInfo=He is allergic to mustard.)\nUserAccount(userId=004, userName=Rita, additionalInfo=She hates cats.)\n----\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.310 [main] INFO com.iluwatar.caching.CacheStore -- # Cache is FULL! Writing LRU data to DB...\n17:00:56.310 [main] INFO com.iluwatar.caching.LruCache -- # Cache is FULL! Removing 004 from cache...\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=006, userName=Yasha, additionalInfo=She is an only child.)\nUserAccount(userId=003, userName=Adam, additionalInfo=He likes food.)\nUserAccount(userId=005, userName=Isaac, additionalInfo=He is allergic to mustard.)\n----\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 004 in cache\n17:00:56.310 [main] INFO com.iluwatar.caching.CacheStore -- # Not found in Cache!\n17:00:56.310 [main] INFO com.iluwatar.caching.CacheStore -- # Cache is FULL! Writing LRU data to DB...\n17:00:56.310 [main] INFO com.iluwatar.caching.LruCache -- # Cache is FULL! Removing 005 from cache...\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=004, userName=Rita, additionalInfo=She hates cats.)\nUserAccount(userId=006, userName=Yasha, additionalInfo=She is an only child.)\nUserAccount(userId=003, userName=Adam, additionalInfo=He likes food.)\n----\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- ==============================================\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- # CachingPolicy.ASIDE\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\n----\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Save record!\n17:00:56.310 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\n----\n17:00:56.310 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 003 in cache\n17:00:56.313 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=003, userName=Adam, additionalInfo=He likes food.)\n----\n17:00:56.313 [main] INFO com.iluwatar.caching.AppManager -- Trying to find 004 in cache\n17:00:56.313 [main] INFO com.iluwatar.caching.App -- \n--CACHE CONTENT--\nUserAccount(userId=004, userName=Rita, additionalInfo=She hates cats.)\nUserAccount(userId=003, userName=Adam, additionalInfo=He likes food.)\n----\n17:00:56.313 [main] INFO com.iluwatar.caching.App -- ==============================================\n17:00:56.314 [Thread-0] INFO com.iluwatar.caching.CacheStore -- # flushCache...\n```\n\nImplementing the Java Caching Design Pattern using various strategies like LRU cache and write-through caching significantly enhances application performance and scalability.\n\n## When to Use the Caching Pattern in Java\n\nUse the Caching pattern when\n\n* Repetitious acquisition, initialization, and release of the same resource cause unnecessary performance overhead\n* In scenarios where the cost of recomputing or re-fetching data is significantly higher than storing and retrieving it from cache\n* For read-heavy applications with relatively static data or data that changes infrequently\n\n## Real-World Applications of Caching Pattern in Java\n\n* Web page caching to reduce server load and improve response time\n* Database query caching to avoid repeated expensive SQL queries\n* Caching results of CPU-intensive computations\n* Content Delivery Networks (CDNs) for caching static resources like images, CSS, and JavaScript files closer to the end users\n\n## Benefits and Trade-offs of Caching Pattern\n\nBenefits:\n\n* Improved Performance: Significantly reduces data access latency, leading to faster application performance\n* Reduced Load: Decreases the load on the underlying data source, which can lead to cost savings and increased longevity of the resource\n* Scalability: Enhances the scalability of applications by efficiently handling increases in load without proportional increases in resource utilization\n\nTrade-Offs:\n\n* Complexity: Introduces complexity in terms of cache invalidation, consistency, and synchronization\n* Resource Utilization: Requires additional memory or storage resources to maintain the cache\n* Stale Data: There's a risk of serving outdated data if the cache is not properly invalidated or updated when the underlying data changes\n\n## Related Java Design Patterns\n\n* [Proxy](https://java-design-patterns.com/patterns/proxy/): Caching can be implemented using the Proxy pattern, where the proxy object intercepts requests and returns cached data if available\n* [Observer](https://java-design-patterns.com/patterns/observer/): Can be used to notify the cache when the underlying data changes, so that it can be updated or invalidated accordingly\n* [Decorator](https://java-design-patterns.com/patterns/decorator/): Can be used to add caching behavior to an existing object without modifying its code\n* [Strategy](https://java-design-patterns.com/patterns/strategy/): Different caching strategies can be implemented using the Strategy pattern, allowing the application to switch between them at runtime\n\n## References and Credits\n\n* [Effective Java](https://amzn.to/4cGk2Jz)\n* [High Performance Browser Networking](https://amzn.to/3TiNNY4)\n* [Java EE 8 High Performance](https://amzn.to/44T8vmH)\n* [Java Performance: In-Depth Advice for Tuning and Programming Java 8, 11, and Beyond](https://amzn.to/3yyD58W)\n* [Java Performance: The Definitive Guide: Getting the Most Out of Your Code](https://amzn.to/3Wu5neF)\n* [Patterns of Enterprise Application Architecture](https://amzn.to/3PMAHRZ)\n* [Scalable Internet Architectures](https://amzn.to/48V3ni9)\n* [Write-through, write-around, write-back: Cache explained (ComputerWeekly)](http://www.computerweekly.com/feature/Write-through-write-around-write-back-Cache-explained)\n* [Cache-Aside Pattern (Microsoft)](https://docs.microsoft.com/en-us/azure/architecture/patterns/cache-aside)\n"
},
{
"path": "caching/docker-compose.yml",
"content": "#\n# This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n#\n# The MIT License\n# Copyright © 2014-2022 Ilkka Seppälä\n#\n# Permission is hereby granted, free of charge, to any person obtaining a copy\n# of this software and associated documentation files (the \"Software\"), to deal\n# in the Software without restriction, including without limitation the rights\n# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the Software is\n# furnished to do so, subject to the following conditions:\n#\n# The above copyright notice and this permission notice shall be included in\n# all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n# THE SOFTWARE.\n#\n\nversion: '3.7'\nservices:\n mongodb_container:\n image: mongo:latest\n environment:\n MONGO_INITDB_ROOT_USERNAME: root\n MONGO_INITDB_ROOT_PASSWORD: rootpassword\n ports:\n - '27017:27017'\n volumes:\n - ./mongo-data/:/data/db\n"
},
{
"path": "caching/etc/caching.ucls",
"content": "\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "caching/etc/caching.urm.puml",
"content": "@startuml\npackage com.iluwatar.caching.constants {\n class CachingConstants {\n + ADD_INFO : String {static}\n + USER_ACCOUNT : String {static}\n + USER_ID : String {static}\n + USER_NAME : String {static}\n + CachingConstants()\n }\n}\npackage com.iluwatar.caching {\n class App {\n - LOGGER : Logger {static}\n + App()\n + main(args : String[]) {static}\n + useCacheAsideStrategy()\n + useReadAndWriteThroughStrategy()\n + useReadThroughAndWriteAroundStrategy()\n + useReadThroughAndWriteBehindStrategy()\n }\n class AppManager {\n - cachingPolicy : CachingPolicy {static}\n - AppManager()\n + find(userId : String) : UserAccount {static}\n - findAside(userId : String) : UserAccount {static}\n + initCacheCapacity(capacity : int) {static}\n + initCachingPolicy(policy : CachingPolicy) {static}\n + initDb(useMongoDb : boolean) {static}\n + printCacheContent() : String {static}\n + save(userAccount : UserAccount) {static}\n - saveAside(userAccount : UserAccount) {static}\n }\n class CacheStore {\n - LOGGER : Logger {static}\n - cache : LruCache {static}\n - CacheStore()\n + clearCache() {static}\n + flushCache() {static}\n + get(userId : String) : UserAccount {static}\n + initCapacity(capacity : int) {static}\n + invalidate(userId : String) {static}\n + print() : String {static}\n + readThrough(userId : String) : UserAccount {static}\n + readThroughWithWriteBackPolicy(userId : String) : UserAccount {static}\n + set(userId : String, userAccount : UserAccount) {static}\n + writeAround(userAccount : UserAccount) {static}\n + writeBehind(userAccount : UserAccount) {static}\n + writeThrough(userAccount : UserAccount) {static}\n }\n enum CachingPolicy {\n + AROUND {static}\n + ASIDE {static}\n + BEHIND {static}\n + THROUGH {static}\n - policy : String\n + getPolicy() : String\n + valueOf(name : String) : CachingPolicy {static}\n + values() : CachingPolicy[] {static}\n }\n class DbManager {\n - db : MongoDatabase {static}\n - mongoClient : MongoClient {static}\n - useMongoDB : boolean {static}\n - virtualDB : Map {static}\n - DbManager()\n + connect() {static}\n + createVirtualDb() {static}\n + readFromDb(userId : String) : UserAccount {static}\n + updateDb(userAccount : UserAccount) {static}\n + upsertDb(userAccount : UserAccount) {static}\n + writeToDb(userAccount : UserAccount) {static}\n }\n class LruCache {\n - LOGGER : Logger {static}\n ~ cache : Map\n ~ capacity : int\n ~ end : Node\n ~ head : Node\n + LruCache(capacity : int)\n + clear()\n + contains(userId : String) : boolean\n + get(userId : String) : UserAccount\n + getCacheDataInListForm() : List\n + getLruData() : UserAccount\n + invalidate(userId : String)\n + isFull() : boolean\n + remove(node : Node)\n + set(userId : String, userAccount : UserAccount)\n + setCapacity(newCapacity : int)\n + setHead(node : Node)\n }\n ~class Node {\n ~ next : Node\n ~ previous : Node\n ~ userAccount : UserAccount\n ~ userId : String\n + Node(this$0 : String, userId : UserAccount)\n }\n class UserAccount {\n - additionalInfo : String\n - userId : String\n - userName : String\n + UserAccount(userId : String, userName : String, additionalInfo : String)\n + getAdditionalInfo() : String\n + getUserId() : String\n + getUserName() : String\n + setAdditionalInfo(additionalInfo : String)\n + setUserId(userId : String)\n + setUserName(userName : String)\n + toString() : String\n }\n}\nNode --+ LruCache\nLruCache --> \"-head\" Node\nNode --> \"-previous\" Node\nAppManager --> \"-cachingPolicy\" CachingPolicy\nNode --> \"-userAccount\" UserAccount\nCacheStore --> \"-cache\" LruCache\n@enduml\n"
},
{
"path": "caching/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n caching \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n org.mockito \n mockito-core \n test \n \n \n org.mongodb \n bson \n \n \n org.mongodb \n mongodb-driver-legacy \n \n \n \n \n \n \n org.apache.maven.plugins \n maven-surefire-plugin \n \n false \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.caching.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport com.iluwatar.caching.database.DbManager;\nimport com.iluwatar.caching.database.DbManagerFactory;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * The Caching pattern describes how to avoid expensive re-acquisition of resources by not releasing\n * the resources immediately after their use. The resources retain their identity, are kept in some\n * fast-access storage, and are re-used to avoid having to acquire them again. There are four main\n * caching strategies/techniques in this pattern; each with their own pros and cons. They are \n * write-through which writes data to the cache and DB in a single transaction, \n * write-around which writes data immediately into the DB instead of the cache, \n * write-behind which writes data into the cache initially whilst the data is only written\n * into the DB when the cache is full, and cache-aside which pushes the responsibility\n * of keeping the data synchronized in both data sources to the application itself. The \n * read-through strategy is also included in the mentioned four strategies -- returns data\n * from the cache to the caller if it exists else queries from DB and stores it into\n * the cache for future use. These strategies determine when the data in the cache should be written\n * back to the backing store (i.e. Database) and help keep both data sources\n * synchronized/up-to-date. This pattern can improve performance and also helps to\n * maintainconsistency between data held in the cache and the data in the underlying data store.\n *\n * In this example, the user account ({@link UserAccount}) entity is used as the underlying\n * application data. The cache itself is implemented as an internal (Java) data structure. It adopts\n * a Least-Recently-Used (LRU) strategy for evicting data from itself when its full. The four\n * strategies are individually tested. The testing of the cache is restricted towards saving and\n * querying of user accounts from the underlying data store( {@link DbManager}). The main class (\n * {@link App} is not aware of the underlying mechanics of the application (i.e. save and query) and\n * whether the data is coming from the cache or the DB (i.e. separation of concern). The AppManager\n * ({@link AppManager}) handles the transaction of data to-and-from the underlying data store\n * (depending on the preferred caching policy/strategy).\n *\n *
{@literal App --> AppManager --> CacheStore/LRUCache/CachingPolicy --> DBManager} \n *\n *
There are 2 ways to launch the application. - to use \"in Memory\" database. - to use the\n * MongoDb as a database\n *\n *
To run the application with \"in Memory\" database, just launch it without parameters Example:\n * 'java -jar app.jar'\n *\n *
To run the application with MongoDb you need to be installed the MongoDb in your system, or to\n * launch it in the docker container. You may launch docker container from the root of current\n * module with command: 'docker-compose up' Then you can start the application with parameter\n * --mongo Example: 'java -jar app.jar --mongo'\n *\n * @see CacheStore\n * @see LruCache\n * @see CachingPolicy\n */\n@Slf4j\npublic class App {\n /** Constant parameter name to use mongoDB. */\n private static final String USE_MONGO_DB = \"--mongo\";\n\n /** Application manager. */\n private final AppManager appManager;\n\n /**\n * Constructor of current App.\n *\n * @param isMongo boolean\n */\n public App(final boolean isMongo) {\n DbManager dbManager = DbManagerFactory.initDb(isMongo);\n appManager = new AppManager(dbManager);\n appManager.initDb();\n }\n\n /**\n * Program entry point.\n *\n * @param args command line args\n */\n public static void main(final String[] args) {\n // VirtualDB (instead of MongoDB) was used in running the JUnit tests\n // and the App class to avoid Maven compilation errors. Set flag to\n // true to run the tests with MongoDB (provided that MongoDB is\n // installed and socket connection is open).\n boolean isDbMongo = isDbMongo(args);\n if (isDbMongo) {\n LOGGER.info(\"Using the Mongo database engine to run the application.\");\n } else {\n LOGGER.info(\"Using the 'in Memory' database to run the application.\");\n }\n App app = new App(isDbMongo);\n app.useReadAndWriteThroughStrategy();\n String splitLine = \"==============================================\";\n LOGGER.info(splitLine);\n app.useReadThroughAndWriteAroundStrategy();\n LOGGER.info(splitLine);\n app.useReadThroughAndWriteBehindStrategy();\n LOGGER.info(splitLine);\n app.useCacheAsideStrategy();\n LOGGER.info(splitLine);\n }\n\n /**\n * Check the input parameters. if\n *\n * @param args input params\n * @return true if there is \"--mongo\" parameter in arguments\n */\n private static boolean isDbMongo(final String[] args) {\n for (String arg : args) {\n if (arg.equals(USE_MONGO_DB)) {\n return true;\n }\n }\n return false;\n }\n\n /** Read-through and write-through. */\n public void useReadAndWriteThroughStrategy() {\n LOGGER.info(\"# CachingPolicy.THROUGH\");\n appManager.initCachingPolicy(CachingPolicy.THROUGH);\n\n var userAccount1 = new UserAccount(\"001\", \"John\", \"He is a boy.\");\n\n appManager.save(userAccount1);\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"001\");\n appManager.find(\"001\");\n }\n\n /** Read-through and write-around. */\n public void useReadThroughAndWriteAroundStrategy() {\n LOGGER.info(\"# CachingPolicy.AROUND\");\n appManager.initCachingPolicy(CachingPolicy.AROUND);\n\n var userAccount2 = new UserAccount(\"002\", \"Jane\", \"She is a girl.\");\n\n appManager.save(userAccount2);\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"002\");\n LOGGER.info(appManager.printCacheContent());\n userAccount2 = appManager.find(\"002\");\n userAccount2.setUserName(\"Jane G.\");\n appManager.save(userAccount2);\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"002\");\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"002\");\n }\n\n /** Read-through and write-behind. */\n public void useReadThroughAndWriteBehindStrategy() {\n LOGGER.info(\"# CachingPolicy.BEHIND\");\n appManager.initCachingPolicy(CachingPolicy.BEHIND);\n\n var userAccount3 = new UserAccount(\"003\", \"Adam\", \"He likes food.\");\n var userAccount4 = new UserAccount(\"004\", \"Rita\", \"She hates cats.\");\n var userAccount5 = new UserAccount(\"005\", \"Isaac\", \"He is allergic to mustard.\");\n\n appManager.save(userAccount3);\n appManager.save(userAccount4);\n appManager.save(userAccount5);\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"003\");\n LOGGER.info(appManager.printCacheContent());\n UserAccount userAccount6 = new UserAccount(\"006\", \"Yasha\", \"She is an only child.\");\n appManager.save(userAccount6);\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"004\");\n LOGGER.info(appManager.printCacheContent());\n }\n\n /** Cache-Aside. */\n public void useCacheAsideStrategy() {\n LOGGER.info(\"# CachingPolicy.ASIDE\");\n appManager.initCachingPolicy(CachingPolicy.ASIDE);\n LOGGER.info(appManager.printCacheContent());\n\n var userAccount3 = new UserAccount(\"003\", \"Adam\", \"He likes food.\");\n var userAccount4 = new UserAccount(\"004\", \"Rita\", \"She hates cats.\");\n var userAccount5 = new UserAccount(\"005\", \"Isaac\", \"He is allergic to mustard.\");\n appManager.save(userAccount3);\n appManager.save(userAccount4);\n appManager.save(userAccount5);\n\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"003\");\n LOGGER.info(appManager.printCacheContent());\n appManager.find(\"004\");\n LOGGER.info(appManager.printCacheContent());\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/AppManager.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport com.iluwatar.caching.database.DbManager;\nimport java.util.Optional;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * AppManager helps to bridge the gap in communication between the main class and the application's\n * back-end. DB connection is initialized through this class. The chosen caching strategy/policy is\n * also initialized here. Before the cache can be used, the size of the cache has to be set.\n * Depending on the chosen caching policy, AppManager will call the appropriate function in the\n * CacheStore class.\n */\n@Slf4j\npublic class AppManager {\n /** Caching Policy. */\n private CachingPolicy cachingPolicy;\n\n /** Database Manager. */\n private final DbManager dbManager;\n\n /** Cache Store. */\n private final CacheStore cacheStore;\n\n /**\n * Constructor.\n *\n * @param newDbManager database manager\n */\n public AppManager(final DbManager newDbManager) {\n this.dbManager = newDbManager;\n this.cacheStore = new CacheStore(newDbManager);\n }\n\n /**\n * Developer/Tester is able to choose whether the application should use MongoDB as its underlying\n * data storage or a simple Java data structure to (temporarily) store the data/objects during\n * runtime.\n */\n public void initDb() {\n dbManager.connect();\n }\n\n /**\n * Initialize caching policy.\n *\n * @param policy is a {@link CachingPolicy}\n */\n public void initCachingPolicy(final CachingPolicy policy) {\n cachingPolicy = policy;\n if (cachingPolicy == CachingPolicy.BEHIND) {\n Runtime.getRuntime().addShutdownHook(new Thread(cacheStore::flushCache));\n }\n cacheStore.clearCache();\n }\n\n /**\n * Find user account.\n *\n * @param userId String\n * @return {@link UserAccount}\n */\n public UserAccount find(final String userId) {\n LOGGER.info(\"Trying to find {} in cache\", userId);\n if (cachingPolicy == CachingPolicy.THROUGH || cachingPolicy == CachingPolicy.AROUND) {\n return cacheStore.readThrough(userId);\n } else if (cachingPolicy == CachingPolicy.BEHIND) {\n return cacheStore.readThroughWithWriteBackPolicy(userId);\n } else if (cachingPolicy == CachingPolicy.ASIDE) {\n return findAside(userId);\n }\n return null;\n }\n\n /**\n * Save user account.\n *\n * @param userAccount {@link UserAccount}\n */\n public void save(final UserAccount userAccount) {\n LOGGER.info(\"Save record!\");\n if (cachingPolicy == CachingPolicy.THROUGH) {\n cacheStore.writeThrough(userAccount);\n } else if (cachingPolicy == CachingPolicy.AROUND) {\n cacheStore.writeAround(userAccount);\n } else if (cachingPolicy == CachingPolicy.BEHIND) {\n cacheStore.writeBehind(userAccount);\n } else if (cachingPolicy == CachingPolicy.ASIDE) {\n saveAside(userAccount);\n }\n }\n\n /**\n * Returns String.\n *\n * @return String\n */\n public String printCacheContent() {\n return cacheStore.print();\n }\n\n /**\n * Cache-Aside save user account helper.\n *\n * @param userAccount {@link UserAccount}\n */\n private void saveAside(final UserAccount userAccount) {\n dbManager.updateDb(userAccount);\n cacheStore.invalidate(userAccount.getUserId());\n }\n\n /**\n * Cache-Aside find user account helper.\n *\n * @param userId String\n * @return {@link UserAccount}\n */\n private UserAccount findAside(final String userId) {\n return Optional.ofNullable(cacheStore.get(userId))\n .or(\n () -> {\n Optional userAccount = Optional.ofNullable(dbManager.readFromDb(userId));\n userAccount.ifPresent(account -> cacheStore.set(userId, account));\n return userAccount;\n })\n .orElse(null);\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/CacheStore.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport com.iluwatar.caching.database.DbManager;\nimport java.util.List;\nimport java.util.Optional;\nimport java.util.stream.Collectors;\nimport lombok.extern.slf4j.Slf4j;\n\n/** The caching strategies are implemented in this class. */\n@Slf4j\npublic class CacheStore {\n /** Cache capacity. */\n private static final int CAPACITY = 3;\n\n /** Lru cache see {@link LruCache}. */\n private LruCache cache;\n\n /** DbManager. */\n private final DbManager dbManager;\n\n /**\n * Cache Store.\n *\n * @param dataBaseManager {@link DbManager}\n */\n public CacheStore(final DbManager dataBaseManager) {\n this.dbManager = dataBaseManager;\n initCapacity(CAPACITY);\n }\n\n /**\n * Init cache capacity.\n *\n * @param capacity int\n */\n public void initCapacity(final int capacity) {\n if (cache == null) {\n cache = new LruCache(capacity);\n } else {\n cache.setCapacity(capacity);\n }\n }\n\n /**\n * Get user account using read-through cache.\n *\n * @param userId {@link String}\n * @return {@link UserAccount}\n */\n public UserAccount readThrough(final String userId) {\n if (cache.contains(userId)) {\n LOGGER.info(\"# Found in Cache!\");\n return cache.get(userId);\n }\n LOGGER.info(\"# Not found in cache! Go to DB!!\");\n UserAccount userAccount = dbManager.readFromDb(userId);\n cache.set(userId, userAccount);\n return userAccount;\n }\n\n /**\n * Get user account using write-through cache.\n *\n * @param userAccount {@link UserAccount}\n */\n public void writeThrough(final UserAccount userAccount) {\n if (cache.contains(userAccount.getUserId())) {\n dbManager.updateDb(userAccount);\n } else {\n dbManager.writeToDb(userAccount);\n }\n cache.set(userAccount.getUserId(), userAccount);\n }\n\n /**\n * Get user account using write-around cache.\n *\n * @param userAccount {@link UserAccount}\n */\n public void writeAround(final UserAccount userAccount) {\n if (cache.contains(userAccount.getUserId())) {\n dbManager.updateDb(userAccount);\n // Cache data has been updated -- remove older\n cache.invalidate(userAccount.getUserId());\n // version from cache.\n } else {\n dbManager.writeToDb(userAccount);\n }\n }\n\n /**\n * Get user account using read-through cache with write-back policy.\n *\n * @param userId {@link String}\n * @return {@link UserAccount}\n */\n public UserAccount readThroughWithWriteBackPolicy(final String userId) {\n if (cache.contains(userId)) {\n LOGGER.info(\"# Found in cache!\");\n return cache.get(userId);\n }\n LOGGER.info(\"# Not found in Cache!\");\n UserAccount userAccount = dbManager.readFromDb(userId);\n if (cache.isFull()) {\n LOGGER.info(\"# Cache is FULL! Writing LRU data to DB...\");\n UserAccount toBeWrittenToDb = cache.getLruData();\n dbManager.upsertDb(toBeWrittenToDb);\n }\n cache.set(userId, userAccount);\n return userAccount;\n }\n\n /**\n * Set user account.\n *\n * @param userAccount {@link UserAccount}\n */\n public void writeBehind(final UserAccount userAccount) {\n if (cache.isFull() && !cache.contains(userAccount.getUserId())) {\n LOGGER.info(\"# Cache is FULL! Writing LRU data to DB...\");\n UserAccount toBeWrittenToDb = cache.getLruData();\n dbManager.upsertDb(toBeWrittenToDb);\n }\n cache.set(userAccount.getUserId(), userAccount);\n }\n\n /** Clears cache. */\n public void clearCache() {\n if (cache != null) {\n cache.clear();\n }\n }\n\n /** Writes remaining content in the cache into the DB. */\n public void flushCache() {\n LOGGER.info(\"# flushCache...\");\n Optional.ofNullable(cache)\n .map(LruCache::getCacheDataInListForm)\n .orElse(List.of())\n .forEach(dbManager::updateDb);\n dbManager.disconnect();\n }\n\n /**\n * Print user accounts.\n *\n * @return {@link String}\n */\n public String print() {\n return Optional.ofNullable(cache)\n .map(LruCache::getCacheDataInListForm)\n .orElse(List.of())\n .stream()\n .map(userAccount -> userAccount.toString() + \"\\n\")\n .collect(Collectors.joining(\"\", \"\\n--CACHE CONTENT--\\n\", \"----\"));\n }\n\n /**\n * Delegate to backing cache store.\n *\n * @param userId {@link String}\n * @return {@link UserAccount}\n */\n public UserAccount get(final String userId) {\n return cache.get(userId);\n }\n\n /**\n * Delegate to backing cache store.\n *\n * @param userId {@link String}\n * @param userAccount {@link UserAccount}\n */\n public void set(final String userId, final UserAccount userAccount) {\n cache.set(userId, userAccount);\n }\n\n /**\n * Delegate to backing cache store.\n *\n * @param userId {@link String}\n */\n public void invalidate(final String userId) {\n cache.invalidate(userId);\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/CachingPolicy.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Getter;\n\n/** Enum class containing the four caching strategies implemented in the pattern. */\n@AllArgsConstructor\n@Getter\npublic enum CachingPolicy {\n /** Through. */\n THROUGH(\"through\"),\n /** AROUND. */\n AROUND(\"around\"),\n /** BEHIND. */\n BEHIND(\"behind\"),\n /** ASIDE. */\n ASIDE(\"aside\");\n\n /** Policy value. */\n private final String policy;\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/LruCache.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport java.util.ArrayList;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * Data structure/implementation of the application's cache. The data structure consists of a hash\n * table attached with a doubly linked-list. The linked-list helps in capturing and maintaining the\n * LRU data in the cache. When a data is queried (from the cache), added (to the cache), or updated,\n * the data is moved to the front of the list to depict itself as the most-recently-used data. The\n * LRU data is always at the end of the list.\n */\n@Slf4j\npublic class LruCache {\n /** Static class Node. */\n static class Node {\n /** user id. */\n private final String userId;\n\n /** User Account. */\n private UserAccount userAccount;\n\n /** previous. */\n private Node previous;\n\n /** next. */\n private Node next;\n\n /**\n * Node definition.\n *\n * @param id String\n * @param account {@link UserAccount}\n */\n Node(final String id, final UserAccount account) {\n this.userId = id;\n this.userAccount = account;\n }\n }\n\n /** Capacity of Cache. */\n private int capacity;\n\n /** Cache {@link HashMap}. */\n private Map cache = new HashMap<>();\n\n /** Head. */\n private Node head;\n\n /** End. */\n private Node end;\n\n /**\n * Constructor.\n *\n * @param cap Integer.\n */\n public LruCache(final int cap) {\n this.capacity = cap;\n }\n\n /**\n * Get user account.\n *\n * @param userId String\n * @return {@link UserAccount}\n */\n public UserAccount get(final String userId) {\n if (cache.containsKey(userId)) {\n var node = cache.get(userId);\n remove(node);\n setHead(node);\n return node.userAccount;\n }\n return null;\n }\n\n /**\n * Remove node from linked list.\n *\n * @param node {@link Node}\n */\n public void remove(final Node node) {\n if (node.previous != null) {\n node.previous.next = node.next;\n } else {\n head = node.next;\n }\n if (node.next != null) {\n node.next.previous = node.previous;\n } else {\n end = node.previous;\n }\n }\n\n /**\n * Move node to the front of the list.\n *\n * @param node {@link Node}\n */\n public void setHead(final Node node) {\n node.next = head;\n node.previous = null;\n if (head != null) {\n head.previous = node;\n }\n head = node;\n if (end == null) {\n end = head;\n }\n }\n\n /**\n * Set user account.\n *\n * @param userAccount {@link UserAccount}\n * @param userId {@link String}\n */\n public void set(final String userId, final UserAccount userAccount) {\n if (cache.containsKey(userId)) {\n var old = cache.get(userId);\n old.userAccount = userAccount;\n remove(old);\n setHead(old);\n } else {\n var newNode = new Node(userId, userAccount);\n if (cache.size() >= capacity) {\n LOGGER.info(\"# Cache is FULL! Removing {} from cache...\", end.userId);\n cache.remove(end.userId); // remove LRU data from cache.\n remove(end);\n setHead(newNode);\n } else {\n setHead(newNode);\n }\n cache.put(userId, newNode);\n }\n }\n\n /**\n * Check if Cache contains the userId.\n *\n * @param userId {@link String}\n * @return boolean\n */\n public boolean contains(final String userId) {\n return cache.containsKey(userId);\n }\n\n /**\n * Invalidate cache for user.\n *\n * @param userId {@link String}\n */\n public void invalidate(final String userId) {\n var toBeRemoved = cache.remove(userId);\n if (toBeRemoved != null) {\n LOGGER.info(\"# {} has been updated! \" + \"Removing older version from cache...\", userId);\n remove(toBeRemoved);\n }\n }\n\n /**\n * Check if the cache is full.\n *\n * @return boolean\n */\n public boolean isFull() {\n return cache.size() >= capacity;\n }\n\n /**\n * Get LRU data.\n *\n * @return {@link UserAccount}\n */\n public UserAccount getLruData() {\n return end.userAccount;\n }\n\n /** Clear cache. */\n public void clear() {\n head = null;\n end = null;\n cache.clear();\n }\n\n /**\n * Returns cache data in list form.\n *\n * @return {@link List}\n */\n public List getCacheDataInListForm() {\n var listOfCacheData = new ArrayList();\n var temp = head;\n while (temp != null) {\n listOfCacheData.add(temp.userAccount);\n temp = temp.next;\n }\n return listOfCacheData;\n }\n\n /**\n * Set cache capacity.\n *\n * @param newCapacity int\n */\n public void setCapacity(final int newCapacity) {\n if (capacity > newCapacity) {\n // Behavior can be modified to accommodate\n // for decrease in cache size. For now, we'll\n clear();\n // just clear the cache.\n } else {\n this.capacity = newCapacity;\n }\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/UserAccount.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport lombok.AllArgsConstructor;\nimport lombok.Data;\nimport lombok.EqualsAndHashCode;\nimport lombok.ToString;\n\n/** Entity class (stored in cache and DB) used in the application. */\n@Data\n@AllArgsConstructor\n@ToString\n@EqualsAndHashCode\npublic class UserAccount {\n /** User Id. */\n private String userId;\n\n /** User Name. */\n private String userName;\n\n /** Additional Info. */\n private String additionalInfo;\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/constants/CachingConstants.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching.constants;\n\n/** Constant class for defining constants. */\npublic final class CachingConstants {\n /** User Account. */\n public static final String USER_ACCOUNT = \"user_accounts\";\n\n /** User ID. */\n public static final String USER_ID = \"userID\";\n\n /** User Name. */\n public static final String USER_NAME = \"userName\";\n\n /** Additional Info. */\n public static final String ADD_INFO = \"additionalInfo\";\n\n /** Constructor. */\n private CachingConstants() {}\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/constants/package-info.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\n/** Constants. */\npackage com.iluwatar.caching.constants;\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/database/DbManager.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching.database;\n\nimport com.iluwatar.caching.UserAccount;\n\n/**\n * DBManager handles the communication with the underlying data store i.e. Database. It contains the\n * implemented methods for querying, inserting, and updating data. MongoDB was used as the database\n * for the application.\n */\npublic interface DbManager {\n /** Connect to DB. */\n void connect();\n\n /** Disconnect from DB. */\n void disconnect();\n\n /**\n * Read from DB.\n *\n * @param userId {@link String}\n * @return {@link UserAccount}\n */\n UserAccount readFromDb(String userId);\n\n /**\n * Write to DB.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n UserAccount writeToDb(UserAccount userAccount);\n\n /**\n * Update record.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n UserAccount updateDb(UserAccount userAccount);\n\n /**\n * Update record or Insert if not exists.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n UserAccount upsertDb(UserAccount userAccount);\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/database/DbManagerFactory.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching.database;\n\n/** Creates the database connection according the input parameter. */\npublic final class DbManagerFactory {\n /** Private constructor. */\n private DbManagerFactory() {}\n\n /**\n * Init database.\n *\n * @param isMongo boolean\n * @return {@link DbManager}\n */\n public static DbManager initDb(final boolean isMongo) {\n if (isMongo) {\n return new MongoDb();\n }\n return new VirtualDb();\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/database/MongoDb.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching.database;\n\nimport static com.iluwatar.caching.constants.CachingConstants.ADD_INFO;\nimport static com.iluwatar.caching.constants.CachingConstants.USER_ACCOUNT;\nimport static com.iluwatar.caching.constants.CachingConstants.USER_ID;\nimport static com.iluwatar.caching.constants.CachingConstants.USER_NAME;\n\nimport com.iluwatar.caching.UserAccount;\nimport com.iluwatar.caching.constants.CachingConstants;\nimport com.mongodb.MongoClient;\nimport com.mongodb.MongoClientOptions;\nimport com.mongodb.MongoCredential;\nimport com.mongodb.ServerAddress;\nimport com.mongodb.client.MongoDatabase;\nimport com.mongodb.client.model.UpdateOptions;\nimport lombok.extern.slf4j.Slf4j;\nimport org.bson.Document;\n\n/** Implementation of DatabaseManager. implements base methods to work with MongoDb. */\n@Slf4j\npublic class MongoDb implements DbManager {\n private static final String DATABASE_NAME = \"admin\";\n private static final String MONGO_USER = \"root\";\n private static final String MONGO_PASSWORD = \"rootpassword\";\n private MongoClient client;\n private MongoDatabase db;\n\n void setDb(MongoDatabase db) {\n this.db = db;\n }\n\n /** Connect to Db. Check th connection */\n @Override\n public void connect() {\n MongoCredential mongoCredential =\n MongoCredential.createCredential(MONGO_USER, DATABASE_NAME, MONGO_PASSWORD.toCharArray());\n MongoClientOptions options = MongoClientOptions.builder().build();\n client = new MongoClient(new ServerAddress(), mongoCredential, options);\n db = client.getDatabase(DATABASE_NAME);\n }\n\n @Override\n public void disconnect() {\n client.close();\n }\n\n /**\n * Read data from DB.\n *\n * @param userId {@link String}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount readFromDb(final String userId) {\n var iterable =\n db.getCollection(CachingConstants.USER_ACCOUNT).find(new Document(USER_ID, userId));\n if (iterable.first() == null) {\n return null;\n }\n Document doc = iterable.first();\n if (doc != null) {\n String userName = doc.getString(USER_NAME);\n String appInfo = doc.getString(ADD_INFO);\n return new UserAccount(userId, userName, appInfo);\n } else {\n return null;\n }\n }\n\n /**\n * Write data to DB.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount writeToDb(final UserAccount userAccount) {\n db.getCollection(USER_ACCOUNT)\n .insertOne(\n new Document(USER_ID, userAccount.getUserId())\n .append(USER_NAME, userAccount.getUserName())\n .append(ADD_INFO, userAccount.getAdditionalInfo()));\n return userAccount;\n }\n\n /**\n * Update DB.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount updateDb(final UserAccount userAccount) {\n Document id = new Document(USER_ID, userAccount.getUserId());\n Document dataSet =\n new Document(USER_NAME, userAccount.getUserName())\n .append(ADD_INFO, userAccount.getAdditionalInfo());\n db.getCollection(CachingConstants.USER_ACCOUNT).updateOne(id, new Document(\"$set\", dataSet));\n return userAccount;\n }\n\n /**\n * Update data if exists.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount upsertDb(final UserAccount userAccount) {\n String userId = userAccount.getUserId();\n String userName = userAccount.getUserName();\n String additionalInfo = userAccount.getAdditionalInfo();\n db.getCollection(CachingConstants.USER_ACCOUNT)\n .updateOne(\n new Document(USER_ID, userId),\n new Document(\n \"$set\",\n new Document(USER_ID, userId)\n .append(USER_NAME, userName)\n .append(ADD_INFO, additionalInfo)),\n new UpdateOptions().upsert(true));\n return userAccount;\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/database/VirtualDb.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching.database;\n\nimport com.iluwatar.caching.UserAccount;\nimport java.util.HashMap;\nimport java.util.Map;\n\n/** Implementation of DatabaseManager. implements base methods to work with hashMap as database. */\npublic class VirtualDb implements DbManager {\n /** Virtual DataBase. */\n private Map db;\n\n /** Creates new HashMap. */\n @Override\n public void connect() {\n db = new HashMap<>();\n }\n\n @Override\n public void disconnect() {\n db = null;\n }\n\n /**\n * Read from Db.\n *\n * @param userId {@link String}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount readFromDb(final String userId) {\n if (db.containsKey(userId)) {\n return db.get(userId);\n }\n return null;\n }\n\n /**\n * Write to DB.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount writeToDb(final UserAccount userAccount) {\n db.put(userAccount.getUserId(), userAccount);\n return userAccount;\n }\n\n /**\n * Update reecord in DB.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount updateDb(final UserAccount userAccount) {\n return writeToDb(userAccount);\n }\n\n /**\n * Update.\n *\n * @param userAccount {@link UserAccount}\n * @return {@link UserAccount}\n */\n @Override\n public UserAccount upsertDb(final UserAccount userAccount) {\n return updateDb(userAccount);\n }\n}\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/database/package-info.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\n/** Database classes. */\npackage com.iluwatar.caching.database;\n"
},
{
"path": "caching/src/main/java/com/iluwatar/caching/package-info.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n"
},
{
"path": "caching/src/test/java/com/iluwatar/caching/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests that Caching example runs without errors. */\nclass AppTest {\n /**\n * Issue: Add at least one assertion to this test case.\n *\n * Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "caching/src/test/java/com/iluwatar/caching/CachingTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching;\n\nimport static org.junit.jupiter.api.Assertions.assertNotNull;\n\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\n\n/** Application test */\nclass CachingTest {\n private App app;\n\n /** Setup of application test includes: initializing DB connection and cache size/capacity. */\n @BeforeEach\n void setUp() {\n // VirtualDB (instead of MongoDB) was used in running the JUnit tests\n // to avoid Maven compilation errors. Set flag to true to run the\n // tests with MongoDB (provided that MongoDB is installed and socket\n // connection is open).\n app = new App(false);\n }\n\n @Test\n void testReadAndWriteThroughStrategy() {\n assertNotNull(app);\n app.useReadAndWriteThroughStrategy();\n }\n\n @Test\n void testReadThroughAndWriteAroundStrategy() {\n assertNotNull(app);\n app.useReadThroughAndWriteAroundStrategy();\n }\n\n @Test\n void testReadThroughAndWriteBehindStrategy() {\n assertNotNull(app);\n app.useReadThroughAndWriteBehindStrategy();\n }\n\n @Test\n void testCacheAsideStrategy() {\n assertNotNull(app);\n app.useCacheAsideStrategy();\n }\n}\n"
},
{
"path": "caching/src/test/java/com/iluwatar/caching/database/MongoDbTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.caching.database;\n\nimport static com.iluwatar.caching.constants.CachingConstants.ADD_INFO;\nimport static com.iluwatar.caching.constants.CachingConstants.USER_ID;\nimport static com.iluwatar.caching.constants.CachingConstants.USER_NAME;\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\nimport static org.junit.jupiter.api.Assertions.assertEquals;\nimport static org.mockito.Mockito.*;\n\nimport com.iluwatar.caching.UserAccount;\nimport com.iluwatar.caching.constants.CachingConstants;\nimport com.mongodb.client.FindIterable;\nimport com.mongodb.client.MongoCollection;\nimport com.mongodb.client.MongoDatabase;\nimport org.bson.Document;\nimport org.junit.jupiter.api.BeforeEach;\nimport org.junit.jupiter.api.Test;\nimport org.mockito.Mock;\n\nclass MongoDbTest {\n private static final String ID = \"123\";\n private static final String NAME = \"Some user\";\n private static final String ADDITIONAL_INFO = \"Some app Info\";\n\n @Mock MongoDatabase db;\n private MongoDb mongoDb = new MongoDb();\n\n private UserAccount userAccount;\n\n @BeforeEach\n void init() {\n db = mock(MongoDatabase.class);\n mongoDb.setDb(db);\n userAccount = new UserAccount(ID, NAME, ADDITIONAL_INFO);\n }\n\n @Test\n void connect() {\n assertDoesNotThrow(() -> mongoDb.connect());\n }\n\n @Test\n void readFromDb() {\n Document document =\n new Document(USER_ID, ID).append(USER_NAME, NAME).append(ADD_INFO, ADDITIONAL_INFO);\n MongoCollection mongoCollection = mock(MongoCollection.class);\n when(db.getCollection(CachingConstants.USER_ACCOUNT)).thenReturn(mongoCollection);\n\n FindIterable findIterable = mock(FindIterable.class);\n when(mongoCollection.find(any(Document.class))).thenReturn(findIterable);\n\n when(findIterable.first()).thenReturn(document);\n\n assertEquals(mongoDb.readFromDb(ID), userAccount);\n }\n\n @Test\n void writeToDb() {\n MongoCollection mongoCollection = mock(MongoCollection.class);\n when(db.getCollection(CachingConstants.USER_ACCOUNT)).thenReturn(mongoCollection);\n assertDoesNotThrow(\n () -> {\n mongoDb.writeToDb(userAccount);\n });\n }\n\n @Test\n void updateDb() {\n MongoCollection mongoCollection = mock(MongoCollection.class);\n when(db.getCollection(CachingConstants.USER_ACCOUNT)).thenReturn(mongoCollection);\n assertDoesNotThrow(\n () -> {\n mongoDb.updateDb(userAccount);\n });\n }\n\n @Test\n void upsertDb() {\n MongoCollection mongoCollection = mock(MongoCollection.class);\n when(db.getCollection(CachingConstants.USER_ACCOUNT)).thenReturn(mongoCollection);\n assertDoesNotThrow(\n () -> {\n mongoDb.upsertDb(userAccount);\n });\n }\n}\n"
},
{
"path": "callback/README.md",
"content": "---\ntitle: \"Callback Pattern in Java: Mastering Asynchronous Communication\"\nshortTitle: Callback\ndescription: \"Learn about the Java Callback Design Pattern, including its intent, usage scenarios, benefits, trade-offs, and real-world examples. Understand how to implement and effectively use callbacks in your Java applications.\"\ncategory: Functional\nlanguage: en\ntag:\n - Asynchronous\n - Decoupling\n - Idiom\n - Reactive\n---\n\n## Also known as\n\n* Call-After\n* Event-Subscription\n* Listener\n\n## Intent of Callback Design Pattern\n\nThe Java Callback Design Pattern is a piece of executable code passed as an argument to other code, which is expected to call back (execute) the argument at a convenient time.\n\n## Detailed Explanation of Callback Pattern with Real-World Examples\n\nReal-world example\n\n> A real-world analogy for the Callback design pattern can be found in the restaurant industry. Imagine a situation where you place an order at a busy restaurant. Instead of waiting at the counter for your food to be ready, you provide the cashier with your phone number. Once your order is prepared, the kitchen staff calls or sends a text message to notify you that your meal is ready for pickup.\n>\n> In this analogy, placing your order is analogous to initiating an asynchronous task. Providing your phone number is akin to passing a callback function. The kitchen preparing your order represents the asynchronous processing, and the notification you receive is the callback being executed, allowing you to retrieve your meal without having to wait idly. This separation of task initiation and task completion is the essence of the Callback design pattern.\n\nIn plain words\n\n> Callback is a method passed to an executor which will be called at a defined moment.\n\nWikipedia says\n\n> In computer programming, a callback, also known as a \"call-after\" function, is any executable code that is passed as an argument to other code; that other code is expected to call back (execute) the argument at a given time.\n\nSequence diagram\n\n\n\n## Programmatic Example of Callback Pattern in Java\n\nWe need to be notified after the executing task has finished. We pass a callback method for the executor and wait for it to call back on us.\n\n`Callback` is a simple interface with single method.\n\n```java\npublic interface Callback {\n\n void call();\n}\n```\n\nNext we define `Task` that will execute the callback after the task execution has finished.\n\n```java\npublic abstract class Task {\n\n final void executeWith(Callback callback) {\n execute();\n Optional.ofNullable(callback).ifPresent(Callback::call);\n }\n\n public abstract void execute();\n}\n\n@Slf4j\npublic final class SimpleTask extends Task {\n\n @Override\n public void execute() {\n LOGGER.info(\"Perform some important activity and after call the callback method.\");\n }\n}\n```\n\nFinally, here's how we execute a task and receive a callback when it's finished.\n\n```java\npublic static void main(final String[] args) {\n var task = new SimpleTask();\n task.executeWith(() -> LOGGER.info(\"I'm done now.\"));\n}\n```\n\nProgram output:\n\n```\n17:12:11.680 [main] INFO com.iluwatar.callback.SimpleTask -- Perform some important activity and after call the callback method.\n17:12:11.682 [main] INFO com.iluwatar.callback.App -- I'm done now.\n```\n\n## When to Use the Callback Pattern in Java\n\nUse the Callback pattern when\n\n* Asynchronous event handling in GUI applications or event-driven systems\n* Implementing notification mechanisms where certain events need to trigger actions in other components.\n* Decoupling modules or components that need to interact without having a direct dependency on each other\n\n## Real-World Applications of Callback Pattern in Java\n\n* GUI frameworks often use callbacks for event handling, such as user interactions (clicks, key presses)\n* Node.js heavily relies on callbacks for non-blocking I/O operations\n* Frameworks that deal with asynchronous operations, like Promises in JavaScript, use callbacks to handle the resolution or rejection of asynchronous tasks\n* [CyclicBarrier](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CyclicBarrier.html#CyclicBarrier%28int,%20java.lang.Runnable%29) constructor can accept a callback that will be triggered every time a barrier is tripped.\n\n## Benefits and Trade-offs of Callback Pattern\n\nBenefits:\n\n* Decouples the execution logic of an operation from the signaling or notification logic, enhancing modularity and reusability\n* Facilitates asynchronous processing, improving the responsiveness and scalability of applications\n* Enables a reactive programming model where components can react to events as they occur\n\nTrade-offs:\n\n* Callback hell or pyramid of doom: Deeply nested callbacks can lead to code that is hard to read and maintain\n* Inversion of control can lead to harder-to-follow code flow, making debugging more challenging\n* Potential issues with error handling, especially in languages or environments where exceptions are used, as errors might need to be propagated through callbacks\n\n## Related Java Design Patterns\n\n* [Command](https://java-design-patterns.com/patterns/command/): Callbacks can be implemented as Command objects in scenarios where more flexibility or statefulness is required in the callback operation\n* [Observer](https://java-design-patterns.com/patterns/observer/): Callbacks can be seen as a more dynamic and lightweight form of the Observer pattern, with the ability to subscribe and unsubscribe callback functions dynamically\n* [Promise](https://java-design-patterns.com/patterns/promise/): In some languages or frameworks, Promises or Futures can be used to handle asynchronous operations more cleanly, often using callbacks for success or failure cases\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Effective Java](https://amzn.to/4cGk2Jz)\n* [Java Concurrency in Practice](https://amzn.to/4aRMruW)\n"
},
{
"path": "callback/etc/callback.ucls",
"content": "\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n "
},
{
"path": "callback/etc/callback.urm.puml",
"content": "@startuml\npackage com.iluwatar.callback {\n class App {\n - LOGGER : Logger {static}\n - App()\n + main(args : String[]) {static}\n }\n interface Callback {\n + call() {abstract}\n }\n class SimpleTask {\n - LOGGER : Logger {static}\n + SimpleTask()\n + execute()\n }\n abstract class Task {\n + Task()\n + execute() {abstract}\n ~ executeWith(callback : Callback)\n }\n}\nSimpleTask --|> Task \n@enduml"
},
{
"path": "callback/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n callback \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n com.iluwatar.callback.App \n \n \n \n \n \n \n \n \n \n"
},
{
"path": "callback/src/main/java/com/iluwatar/callback/App.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/**\n * Callback pattern is more native for functional languages where functions are treated as\n * first-class citizens. Prior to Java 8 callbacks can be simulated using simple (alike command)\n * interfaces.\n */\n@Slf4j\npublic final class App {\n\n private App() {}\n\n /** Program entry point. */\n public static void main(final String[] args) {\n var task = new SimpleTask();\n task.executeWith(() -> LOGGER.info(\"I'm done now.\"));\n }\n}\n"
},
{
"path": "callback/src/main/java/com/iluwatar/callback/Callback.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n\n/** Callback interface. */\npublic interface Callback {\n\n void call();\n}\n"
},
{
"path": "callback/src/main/java/com/iluwatar/callback/SimpleTask.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n\nimport lombok.extern.slf4j.Slf4j;\n\n/** Implementation of task that need to be executed. */\n@Slf4j\npublic final class SimpleTask extends Task {\n\n @Override\n public void execute() {\n LOGGER.info(\"Perform some important activity and after call the callback method.\");\n }\n}\n"
},
{
"path": "callback/src/main/java/com/iluwatar/callback/Task.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n\nimport java.util.Optional;\n\n/** Template-method class for callback hook execution. */\npublic abstract class Task {\n\n /** Execute with callback. */\n final void executeWith(Callback callback) {\n execute();\n Optional.ofNullable(callback).ifPresent(Callback::call);\n }\n\n public abstract void execute();\n}\n"
},
{
"path": "callback/src/main/java/com/iluwatar/callback/package-info.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n"
},
{
"path": "callback/src/test/java/com/iluwatar/callback/AppTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n\nimport static org.junit.jupiter.api.Assertions.assertDoesNotThrow;\n\nimport org.junit.jupiter.api.Test;\n\n/** Tests that Callback example runs without errors. */\nclass AppTest {\n\n /**\n * Issue: Add at least one assertion to this test case.\n *\n * Solution: Inserted assertion to check whether the execution of the main method in {@link\n * App} throws an exception.\n */\n @Test\n void shouldExecuteApplicationWithoutException() {\n\n assertDoesNotThrow(() -> App.main(new String[] {}));\n }\n}\n"
},
{
"path": "callback/src/test/java/com/iluwatar/callback/CallbackTest.java",
"content": "/*\n * This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).\n *\n * The MIT License\n * Copyright © 2014-2022 Ilkka Seppälä\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n * THE SOFTWARE.\n */\npackage com.iluwatar.callback;\n\nimport static org.junit.jupiter.api.Assertions.assertEquals;\n\nimport org.junit.jupiter.api.Test;\n\n/**\n * Add a field as a counter. Every time the callback method is called increment this field. Unit\n * test checks that the field is being incremented.\n *\n *
Could be done with mock objects as well where the call method call is verified.\n */\nclass CallbackTest {\n\n private Integer callingCount = 0;\n\n @Test\n void test() {\n Callback callback = () -> callingCount++;\n\n var task = new SimpleTask();\n\n assertEquals(Integer.valueOf(0), callingCount, \"Initial calling count of 0\");\n\n task.executeWith(callback);\n\n assertEquals(Integer.valueOf(1), callingCount, \"Callback called once\");\n\n task.executeWith(callback);\n\n assertEquals(Integer.valueOf(2), callingCount, \"Callback called twice\");\n }\n}\n"
},
{
"path": "chain-of-responsibility/README.md",
"content": "---\ntitle: \"Chain of Responsibility Pattern in Java: Building Robust Request Handling Mechanisms\"\nshortTitle: Chain of Responsibility\ndescription: \"Learn the Chain of Responsibility design pattern in Java with real-world examples, code snippets, and class diagrams. Enhance your coding skills with our detailed explanations.\"\ncategory: Behavioral\nlanguage: en\ntag:\n - Decoupling\n - Event-driven\n - Gang of Four\n - Messaging\n---\n\n## Also known as\n\n* Chain of Command\n* Chain of Objects\n* Responsibility Chain\n\n## Intent of Chain of Responsibility Design Pattern\n\nThe Chain of Responsibility pattern in Java is a behavioral design pattern that decouples the sender of a request from its receivers by giving more than one object a chance to handle the request. The receiving objects are chained and the request is passed along the chain until an object handles it.\n\n## Detailed Explanation of Chain of Responsibility Pattern with Real-World Examples\n\nReal-world example\n\n> A real-world example of the Chain of Responsibility pattern in Java is a technical support call center. When implementing this Java design pattern, each level of support represents a handler in the chain. When a customer calls in with an issue, the call is first received by a front-line support representative. If the issue is simple, the representative handles it directly. If the issue is more complex, the representative forwards the call to a second-level support technician. This process continues, with the call being escalated through multiple levels of support until it reaches a specialist who can resolve the problem. Each level of support represents a handler in the chain, and the call is passed along the chain until it finds an appropriate handler, thereby decoupling the request from the specific receiver.\n\nIn plain words\n\n> It helps to build a chain of objects. A request enters from one end and keeps going from an object to another until it finds a suitable handler.\n\nWikipedia says\n\n> In object-oriented design, the chain-of-responsibility pattern is a design pattern consisting of a source of command objects and a series of processing objects. Each processing object contains logic that defines the types of command objects that it can handle; the rest are passed to the next processing object in the chain.\n\nFlowchart\n\n\n\n## Programmatic Example of Chain of Responsibility Pattern\n\nIn this Java example, the Orc King gives orders which are processed by a chain of command representing the Chain of Responsibility pattern. Learn how to implement this design pattern in Java with the following code snippet.\n\nThe Orc King gives loud orders to his army. The closest one to react is the commander, then an officer, and then a soldier. The commander, officer, and soldier form a chain of responsibility.\n\nFirst, we have the `Request` class:\n\n```java\n@Getter\npublic class Request {\n\n private final RequestType requestType;\n private final String requestDescription;\n private boolean handled;\n\n public Request(final RequestType requestType, final String requestDescription) {\n this.requestType = Objects.requireNonNull(requestType);\n this.requestDescription = Objects.requireNonNull(requestDescription);\n }\n\n public void markHandled() {\n this.handled = true;\n }\n\n @Override\n public String toString() {\n return getRequestDescription();\n }\n}\n\npublic enum RequestType {\n DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX\n}\n```\n\nNext, we show the `RequestHandler` hierarchy.\n\n```java\npublic interface RequestHandler {\n\n boolean canHandleRequest(Request req);\n\n int getPriority();\n\n void handle(Request req);\n\n String name();\n}\n\n@Slf4j\npublic class OrcCommander implements RequestHandler {\n @Override\n public boolean canHandleRequest(Request req) {\n return req.getRequestType() == RequestType.DEFEND_CASTLE;\n }\n\n @Override\n public int getPriority() {\n return 2;\n }\n\n @Override\n public void handle(Request req) {\n req.markHandled();\n LOGGER.info(\"{} handling request \\\"{}\\\"\", name(), req);\n }\n\n @Override\n public String name() {\n return \"Orc commander\";\n }\n}\n\n// OrcOfficer and OrcSoldier are defined similarly as OrcCommander ...\n\n```\n\nThe `OrcKing` gives the orders and forms the chain.\n\n```java\npublic class OrcKing {\n\n private List handlers;\n\n public OrcKing() {\n buildChain();\n }\n\n private void buildChain() {\n handlers = Arrays.asList(new OrcCommander(), new OrcOfficer(), new OrcSoldier());\n }\n\n public void makeRequest(Request req) {\n handlers\n .stream()\n .sorted(Comparator.comparing(RequestHandler::getPriority))\n .filter(handler -> handler.canHandleRequest(req))\n .findFirst()\n .ifPresent(handler -> handler.handle(req));\n }\n}\n```\n\nThe chain of responsibility in action.\n\n```java\n public static void main(String[] args) {\n\n var king = new OrcKing();\n king.makeRequest(new Request(RequestType.DEFEND_CASTLE, \"defend castle\"));\n king.makeRequest(new Request(RequestType.TORTURE_PRISONER, \"torture prisoner\"));\n king.makeRequest(new Request(RequestType.COLLECT_TAX, \"collect tax\"));\n}\n```\n\nThe console output:\n\n```\nOrc commander handling request \"defend castle\"\nOrc officer handling request \"torture prisoner\"\nOrc soldier handling request \"collect tax\"\n```\n\n## When to Use the Chain of Responsibility Pattern in Java\n\nUse Chain of Responsibility when\n\n* More than one object may handle a request, and the handler isn't known a priori. The handler should be ascertained automatically.\n* You want to issue a request to one of several objects without specifying the receiver explicitly.\n* The set of objects that can handle a request should be specified dynamically.\n\n## Real-World Applications of Chain of Responsibility Pattern in Java\n\n* Event bubbling in GUI frameworks where an event might be handled at multiple levels of a UI component hierarchy\n* Middleware frameworks where a request passes through a chain of processing objects\n* Logging frameworks where messages can be passed through a series of loggers, each possibly handling them differently\n* [java.util.logging.Logger#log()](http://docs.oracle.com/javase/8/docs/api/java/util/logging/Logger.html#log%28java.util.logging.Level,%20java.lang.String%29)\n* [Apache Commons Chain](https://commons.apache.org/proper/commons-chain/index.html)\n* [javax.servlet.Filter#doFilter()](http://docs.oracle.com/javaee/7/api/javax/servlet/Filter.html#doFilter-javax.servlet.ServletRequest-javax.servlet.ServletResponse-javax.servlet.FilterChain-)\n\n## Benefits and Trade-offs of Chain of Responsibility Pattern\n\nBenefits:\n\n* Reduced coupling. The sender of a request does not need to know the concrete handler that will process the request.\n* Increased flexibility in assigning responsibilities to objects. You can add or change responsibilities for handling a request by changing the members and order of the chain.\n* Allows you to set a default handler if no concrete handler can handle the request.\n\nTrade-Offs:\n\n* It can be challenging to debug and understand the flow, especially if the chain is long and complex.\n* The request might end up unhandled if the chain doesn't include a catch-all handler.\n* Performance concerns might arise due to potentially going through several handlers before finding the right one, or not finding it at all.\n\n## Related Java Design Patterns\n\n* [Command](https://java-design-patterns.com/patterns/command/): can be used to encapsulate a request as an object, which might be passed along the chain.\n* [Composite](https://java-design-patterns.com/patterns/composite/): the Chain of Responsibility is often applied in conjunction with the Composite pattern.\n* [Decorator](https://java-design-patterns.com/patterns/decorator/): decorators can be chained in a similar manner as responsibilities in the Chain of Responsibility pattern.\n\n## References and Credits\n\n* [Design Patterns: Elements of Reusable Object-Oriented Software](https://amzn.to/3w0pvKI)\n* [Head First Design Patterns: Building Extensible and Maintainable Object-Oriented Software](https://amzn.to/49NGldq)\n* [Pattern-Oriented Software Architecture, Volume 1: A System of Patterns](https://amzn.to/3PAJUg5)\n* [Refactoring to Patterns](https://amzn.to/3VOO4F5)\n* [Pattern languages of program design 3](https://amzn.to/4a4NxTH)\n"
},
{
"path": "chain-of-responsibility/etc/chain-of-responsibility.urm.puml",
"content": "@startuml\npackage com.iluwatar.chain {\n class App {\n + App()\n + main(args : String[]) {static}\n }\n class OrcCommander {\n - LOGGER : Logger {static}\n + OrcCommander()\n + canHandleRequest(req : Request) : boolean\n + getPriority() : int\n + handle(req : Request)\n + name() : String\n }\n class OrcKing {\n - handlers : List\n + OrcKing()\n - buildChain()\n + makeRequest(req : Request)\n }\n class OrcOfficer {\n - LOGGER : Logger {static}\n + OrcOfficer()\n + canHandleRequest(req : Request) : boolean\n + getPriority() : int\n + handle(req : Request)\n + name() : String\n }\n class OrcSoldier {\n - LOGGER : Logger {static}\n + OrcSoldier()\n + canHandleRequest(req : Request) : boolean\n + getPriority() : int\n + handle(req : Request)\n + name() : String\n }\n class Request {\n - handled : boolean\n - requestDescription : String\n - requestType : RequestType\n + Request(requestType : RequestType, requestDescription : String)\n + getRequestDescription() : String\n + getRequestType() : RequestType\n + isHandled() : boolean\n + markHandled()\n + toString() : String\n }\n interface RequestHandler {\n + canHandleRequest(Request) : boolean {abstract}\n + getPriority() : int {abstract}\n + handle(Request) {abstract}\n + name() : String {abstract}\n }\n enum RequestType {\n + COLLECT_TAX {static}\n + DEFEND_CASTLE {static}\n + TORTURE_PRISONER {static}\n + valueOf(name : String) : RequestType {static}\n + values() : RequestType[] {static}\n }\n}\nOrcKing --> \"-handlers\" RequestHandler\nRequest --> \"-requestType\" RequestType\nOrcCommander ..|> RequestHandler \nOrcOfficer ..|> RequestHandler \nOrcSoldier ..|> RequestHandler \n@enduml"
},
{
"path": "chain-of-responsibility/pom.xml",
"content": "\n\n\n 4.0.0 \n \n com.iluwatar \n java-design-patterns \n 1.26.0-SNAPSHOT \n \n chain-of-responsibility \n \n \n org.slf4j \n slf4j-api \n \n \n ch.qos.logback \n logback-classic \n \n \n org.junit.jupiter \n junit-jupiter-engine \n test \n \n \n \n \n \n org.apache.maven.plugins \n maven-assembly-plugin \n \n \n \n \n \n
![\"Ilkka](\"https://avatars1.githubusercontent.com/u/582346?v=4?s=100\")
![\"Subhrodip](\"https://avatars0.githubusercontent.com/u/13291222?v=4?s=100\")
![\"amit1307\"/](\"https://avatars0.githubusercontent.com/u/23420222?v=4?s=100\")
![\"Narendra](\"https://avatars2.githubusercontent.com/u/1792515?v=4?s=100\")
![\"Jeroen](\"https://avatars1.githubusercontent.com/u/1545460?v=4?s=100\")
![\"Joseph](\"https://avatars0.githubusercontent.com/u/4526195?v=4?s=100\")
![\"Thomas\"/](\"https://avatars1.githubusercontent.com/u/22516154?v=4?s=100\")
![\"Anurag](\"https://avatars1.githubusercontent.com/u/6075379?v=4?s=100\")
![\"Markus](\"https://avatars1.githubusercontent.com/u/3317416?v=4?s=100\")
![\"Sabiq](\"https://avatars1.githubusercontent.com/u/19510920?v=4?s=100\")
![\"Amit](\"https://avatars3.githubusercontent.com/u/5253764?v=4?s=100\")
![\"Piyush](\"https://avatars3.githubusercontent.com/u/10268029?v=4?s=100\")
![\"joshzambales\"/](\"https://avatars1.githubusercontent.com/u/8704552?v=4?s=100\")
![\"Kamil](\"https://avatars2.githubusercontent.com/u/7272996?v=4?s=100\")
![\"Zafar](\"https://avatars2.githubusercontent.com/u/660742?v=4?s=100\")
![\"Paul](\"https://avatars1.githubusercontent.com/u/1147749?v=4?s=100\")
![\"Argyro](\"https://avatars0.githubusercontent.com/u/22822639?v=4?s=100\")
![\"TylerMcConville\"/](\"https://avatars0.githubusercontent.com/u/4946449?v=4?s=100\")
![\"saksham93\"/](\"https://avatars1.githubusercontent.com/u/37399540?v=4?s=100\")
![\"nikhilbarar\"/](\"https://avatars2.githubusercontent.com/u/37332144?v=4?s=100\")
![\"Colin](\"https://avatars2.githubusercontent.com/u/10725674?v=4?s=100\")
![\"Ruslan\"/](\"https://avatars2.githubusercontent.com/u/1503411?v=4?s=100\")
![\"Juho](\"https://avatars1.githubusercontent.com/u/4745294?v=4?s=100\")
![\"Dheeraj](\"https://avatars2.githubusercontent.com/u/7002230?v=4?s=100\")
![\"Bernardo](\"https://avatars0.githubusercontent.com/u/8271090?v=4?s=100\")
![\"Aleksandar](\"https://avatars0.githubusercontent.com/u/19871727?v=4?s=100\")
![\"Yusuf](\"https://avatars2.githubusercontent.com/u/1049483?v=4?s=100\")
![\"Mihály](\"https://avatars2.githubusercontent.com/u/1001491?v=4?s=100\")
![\"Stanislav](\"https://avatars0.githubusercontent.com/u/17639945?v=4?s=100\")
![\"GVSharma\"/](\"https://avatars1.githubusercontent.com/u/6648152?v=4?s=100\")
![\"Srđan](\"https://avatars1.githubusercontent.com/u/22815104?v=4?s=100\")
![\"Petros](\"https://avatars3.githubusercontent.com/u/5484694?v=4?s=100\")
![\"Pramod](\"https://avatars1.githubusercontent.com/u/2184241?v=4?s=100\")
![\"Amarnath](\"https://avatars0.githubusercontent.com/u/4599623?v=4?s=100\")
![\"Anurag870\"/](\"https://avatars1.githubusercontent.com/u/6295975?v=4?s=100\")
![\"Wes](\"https://avatars0.githubusercontent.com/u/1685953?v=4?s=100\")
![\"Harshraj](\"https://avatars2.githubusercontent.com/u/22811531?v=4?s=100\")
![\"Martin](\"https://avatars1.githubusercontent.com/u/26136934?v=4?s=100\")
![\"Alexandru](\"https://avatars1.githubusercontent.com/u/5720977?v=4?s=100\")
![\"Artur](\"https://avatars3.githubusercontent.com/u/7372215?v=4?s=100\")
![\"anthony\"/](\"https://avatars3.githubusercontent.com/u/10249255?v=4?s=100\")
![\"Christian](\"https://avatars1.githubusercontent.com/u/9342724?v=4?s=100\")
![\"Dima](\"https://avatars2.githubusercontent.com/u/5390492?v=4?s=100\")
![\"Joshua](\"https://avatars3.githubusercontent.com/u/22243493?v=4?s=100\")
![\"Kai](\"https://avatars0.githubusercontent.com/u/110982?v=4?s=100\")
![\"lbroman\"/](\"https://avatars1.githubusercontent.com/u/86007?v=4?s=100\")
![\"Przemek\"/](\"https://avatars1.githubusercontent.com/u/3254609?v=4?s=100\")
![\"Prafful](\"https://avatars0.githubusercontent.com/u/14350274?v=4?s=100\")
![\"Sanket](\"https://avatars1.githubusercontent.com/u/6478783?v=4?s=100\")
![\"staillebois\"/](\"https://avatars0.githubusercontent.com/u/23701200?v=4?s=100\")
![\"Krisztián](\"https://avatars3.githubusercontent.com/u/17962817?v=4?s=100\")
![\"Alexander](\"https://avatars0.githubusercontent.com/u/4307918?v=4?s=100\")
![\"Yosfik](\"https://avatars3.githubusercontent.com/u/4850270?v=4?s=100\")
![\"Agustí](\"https://avatars0.githubusercontent.com/u/8149332?v=4?s=100\")
![\"Juan](\"https://avatars3.githubusercontent.com/u/7390500?v=4?s=100\")
![\"Luigi](\"https://avatars0.githubusercontent.com/u/9956006?v=4?s=100\")
![\"Katarzyna](\"https://avatars2.githubusercontent.com/u/18425745?v=4?s=100\")
![\"adamski.pro\"/](\"https://avatars1.githubusercontent.com/u/6537430?v=4?s=100\")
![\"Shengli](\"https://avatars0.githubusercontent.com/u/17060584?v=4?s=100\")
![\"Boris\"/](\"https://avatars2.githubusercontent.com/u/29834592?v=4?s=100\")
![\"Dmitry](\"https://avatars3.githubusercontent.com/u/1798156?v=4?s=100\")
![\"靳阳\"/](\"https://avatars0.githubusercontent.com/u/3983683?v=4?s=100\")
![\"hoangnam2261\"/](\"https://avatars2.githubusercontent.com/u/31692990?v=4?s=100\")
![\"Arpit](\"https://avatars2.githubusercontent.com/u/10098713?v=4?s=100\")
![\"Jón](\"https://avatars2.githubusercontent.com/u/6115148?v=4?s=100\")
![\"Kirill](\"https://avatars3.githubusercontent.com/u/16112495?v=4?s=100\")
![\"Mitchell](\"https://avatars0.githubusercontent.com/u/16233245?v=4?s=100\")
![\"Ranjeet\"/](\"https://avatars0.githubusercontent.com/u/1992972?v=4?s=100\")
![\"PhoenixYip\"/](\"https://avatars3.githubusercontent.com/u/3234786?v=4?s=100\")
![\"M](\"https://avatars1.githubusercontent.com/u/6280554?v=4?s=100\")
![\"kanwarpreet25\"/](\"https://avatars0.githubusercontent.com/u/39183641?v=4?s=100\")
![\"Leon](\"https://avatars3.githubusercontent.com/u/13071508?v=4?s=100\")
![\"Per](\"https://avatars2.githubusercontent.com/u/7052193?v=4?s=100\")
![\"Evan](\"https://avatars2.githubusercontent.com/u/10975700?v=4?s=100\")
![\"AnaghaSasikumar\"/](\"https://avatars2.githubusercontent.com/u/42939261?v=4?s=100\")
![\"Christoffer](\"https://avatars1.githubusercontent.com/u/767643?v=4?s=100\")
![\"Dominik](\"https://avatars0.githubusercontent.com/u/1516800?v=4?s=100\")
![\"Hannes\"/](\"https://avatars3.githubusercontent.com/u/1679437?v=4?s=100\")
![\"Leo](\"https://avatars0.githubusercontent.com/u/1211969?v=4?s=100\")
![\"Zhang](\"https://avatars0.githubusercontent.com/u/14066422?v=4?s=100\")
![\"Christopher](\"https://avatars0.githubusercontent.com/u/1112973?v=4?s=100\")
![\"George](\"https://avatars2.githubusercontent.com/u/22855493?v=4?s=100\")
![\"Hemant](\"https://avatars1.githubusercontent.com/u/7418012?v=4?s=100\")
![\"Kevin](\"https://avatars1.githubusercontent.com/u/12736734?v=4?s=100\")
![\"George](\"https://avatars1.githubusercontent.com/u/2019896?v=4?s=100\")
![\"Mahendran](\"https://avatars1.githubusercontent.com/u/8975264?v=4?s=100\")
![\"Azureyjt\"/](\"https://avatars2.githubusercontent.com/u/18476317?v=4?s=100\")
![\"gans\"/](\"https://avatars2.githubusercontent.com/u/3133265?v=4?s=100\")
![\"Matt\"/](\"https://avatars0.githubusercontent.com/u/24470582?v=4?s=100\")
![\"Gopinath](\"https://avatars2.githubusercontent.com/u/10210778?v=4?s=100\")
![\"Hoswey\"/](\"https://avatars3.githubusercontent.com/u/3689445?v=4?s=100\")
![\"Amit](\"https://avatars3.githubusercontent.com/u/7566692?v=4?s=100\")
![\"gwildor28\"/](\"https://avatars0.githubusercontent.com/u/16000365?v=4?s=100\")
![\"田浩\"/](\"https://avatars1.githubusercontent.com/u/2404785?v=4?s=100\")
![\"Stamatis](\"https://avatars1.githubusercontent.com/u/6773603?v=4?s=100\")
![\"qza\"/](\"https://avatars3.githubusercontent.com/u/233149?v=4?s=100\")
![\"Rodolfo](\"https://avatars1.githubusercontent.com/u/20662669?v=4?s=100\")
![\"Ankur](\"https://avatars2.githubusercontent.com/u/2236616?v=4?s=100\")
![\"Ovidijus](\"https://avatars0.githubusercontent.com/u/20372387?v=4?s=100\")
![\"Robert](\"https://avatars1.githubusercontent.com/u/9137432?v=4?s=100\")
![\"Tapio](\"https://avatars3.githubusercontent.com/u/1641063?v=4?s=100\")
![\"Yuri](\"https://avatars0.githubusercontent.com/u/1595733?v=4?s=100\")
![\"Varun](\"https://avatars0.githubusercontent.com/u/7676016?v=4?s=100\")
![\"Aditya](\"https://avatars2.githubusercontent.com/u/25523604?v=4?s=100\")
![\"grzesiekkedzior\"/](\"https://avatars3.githubusercontent.com/u/23739158?v=4?s=100\")
![\"Sivasubramani](\"https://avatars2.githubusercontent.com/u/51107434?v=4?s=100\")
![\"Sami](\"https://avatars2.githubusercontent.com/u/99457?v=4?s=100\")
![\"Janne](\"https://avatars0.githubusercontent.com/u/557751?v=4?s=100\")
![\"Boris-Chengbiao](\"https://avatars1.githubusercontent.com/u/2302947?v=4?s=100\")
![\"Jacob](\"https://avatars2.githubusercontent.com/u/10779515?v=4?s=100\")
![\"Richard](\"https://avatars3.githubusercontent.com/u/14842151?v=4?s=100\")
![\"Rachel](\"https://avatars0.githubusercontent.com/u/22792183?v=4?s=100\")
![\"Zaerald](\"https://avatars0.githubusercontent.com/u/21978370?v=4?s=100\")
![\"Lars](\"https://avatars1.githubusercontent.com/u/456426?v=4?s=100\")
![\"Mike](\"https://avatars2.githubusercontent.com/u/21277644?v=4?s=100\")
![\"Matt](\"https://avatars1.githubusercontent.com/u/6307904?v=4?s=100\")
![\"Manan\"/](\"https://avatars3.githubusercontent.com/u/21033516?v=4?s=100\")
![\"Nishant](\"https://avatars2.githubusercontent.com/u/15331971?v=4?s=100\")
![\"Peeyush\"/](\"https://avatars0.githubusercontent.com/u/5496024?v=4?s=100\")
![\"Rakesh\"/](\"https://avatars1.githubusercontent.com/u/10645273?v=4?s=100\")
![\"Wei](\"https://avatars0.githubusercontent.com/u/8037883?v=4?s=100\")
![\"Ashish](\"https://avatars3.githubusercontent.com/u/23194128?v=4?s=100\")
![\"洪月阳\"/](\"https://avatars1.githubusercontent.com/u/41055099?v=4?s=100\")
![\"xdvrx1\"/](\"https://avatars0.githubusercontent.com/u/47092464?v=4?s=100\")
![\"Bethan](\"https://avatars3.githubusercontent.com/u/13121570?v=4?s=100\")
![\"Toxic](\"https://avatars0.githubusercontent.com/u/45225562?v=4?s=100\")
![\"Edy](\"https://avatars1.githubusercontent.com/u/1098102?v=4?s=100\")
![\"Michał](\"https://avatars0.githubusercontent.com/u/15279585?v=4?s=100\")
![\"Stefan](\"https://avatars1.githubusercontent.com/u/711349?v=4?s=100\")
![\"Fedor](\"https://avatars3.githubusercontent.com/u/43882212?v=4?s=100\")
![\"samilAyoub\"/](\"https://avatars0.githubusercontent.com/u/61546990?v=4?s=100\")
![\"Vladislav](\"https://avatars0.githubusercontent.com/u/29997701?v=4?s=100\")
![\"Swaraj\"/](\"https://avatars2.githubusercontent.com/u/6285049?v=4?s=100\")
![\"Christoph](\"https://avatars0.githubusercontent.com/u/4465376?v=4?s=100\")
![\"Ascênio\"/](\"https://avatars1.githubusercontent.com/u/7662016?v=4?s=100\")
![\"Domenico](\"https://avatars2.githubusercontent.com/u/24280982?v=4?s=100\")
![\"Akash](\"https://avatars2.githubusercontent.com/u/3483277?v=4?s=100\")
![\"Pavlo](\"https://avatars2.githubusercontent.com/u/7019769?v=4?s=100\")
![\"Eiman\"/](\"https://avatars0.githubusercontent.com/u/20307301?v=4?s=100\")
![\"Rocky\"/](\"https://avatars0.githubusercontent.com/u/42976136?v=4?s=100\")
![\"Ibrahim](\"https://avatars2.githubusercontent.com/u/21141301?v=4?s=100\")
![\"Girish](\"https://avatars3.githubusercontent.com/u/5161548?v=4?s=100\")
![\"Omar](\"https://avatars0.githubusercontent.com/u/59054172?v=4?s=100\")
![\"Jeff](\"https://avatars0.githubusercontent.com/u/3521562?v=4?s=100\")
![\"Vivek](\"https://avatars1.githubusercontent.com/u/12713808?v=4?s=100\")
![\"siavash\"/](\"https://avatars2.githubusercontent.com/u/18074419?v=4?s=100\")
![\"ruchpeanuts\"/](\"https://avatars0.githubusercontent.com/u/29301900?v=4?s=100\")
![\"warp125\"/](\"https://avatars1.githubusercontent.com/u/48073115?v=4?s=100\")
![\"KHADIR](\"https://avatars1.githubusercontent.com/u/45130488?v=4?s=100\")
![\"ignite1771\"/](\"https://avatars2.githubusercontent.com/u/59446563?v=4?s=100\")
![\"Halil](\"https://avatars1.githubusercontent.com/u/22895118?v=4?s=100\")
![\"Rohit](\"https://avatars.githubusercontent.com/u/20845565?v=4?s=100\")
![\"byoungju94\"/](\"https://avatars.githubusercontent.com/u/42516378?v=4?s=100\")
![\"Moustafa](\"https://avatars.githubusercontent.com/u/38836727?v=4?s=100\")
![\"Martel](\"https://avatars.githubusercontent.com/u/19147333?v=4?s=100\")
![\"va1m\"/](\"https://avatars.githubusercontent.com/u/17025445?v=4?s=100\")
![\"Noam](\"https://avatars.githubusercontent.com/u/31648669?v=4?s=100\")
![\"yonghong](\"https://avatars.githubusercontent.com/u/14086462?v=4?s=100\")
![\"jinishavora\"/](\"https://avatars.githubusercontent.com/u/40777762?v=4?s=100\")
![\"Elvys](\"https://avatars.githubusercontent.com/u/50836521?v=4?s=100\")
![\"zWeBrain\"/](\"https://avatars.githubusercontent.com/u/46642512?v=4?s=100\")
![\"余林颖\"/](\"https://avatars.githubusercontent.com/u/22493821?v=4?s=100\")
![\"Alain\"/](\"https://avatars.githubusercontent.com/u/6988911?v=4?s=100\")
![\"VR\"/](\"https://avatars.githubusercontent.com/u/30525467?v=4?s=100\")
![\"JackieNim\"/](\"https://avatars.githubusercontent.com/u/4138836?v=4?s=100\")
![\"EdisonE3\"/](\"https://avatars.githubusercontent.com/u/52118917?v=4?s=100\")
![\"Tao\"/](\"https://avatars.githubusercontent.com/u/66189688?v=4?s=100\")
![\"Juan](\"https://avatars.githubusercontent.com/u/16357060?v=4?s=100\")
![\"Xenilo137\"/](\"https://avatars.githubusercontent.com/u/24865069?v=4?s=100\")
![\"Samuel](\"https://avatars.githubusercontent.com/u/17254162?v=4?s=100\")
![\"Marlo](\"https://avatars.githubusercontent.com/u/40809563?v=4?s=100\")
![\"AndriyPyzh\"/](\"https://avatars.githubusercontent.com/u/57706635?v=4?s=100\")
![\"karthikbhat13\"/](\"https://avatars.githubusercontent.com/u/22431014?v=4?s=100\")
![\"Morteza](\"https://avatars.githubusercontent.com/u/1329687?v=4?s=100\")
![\"Nagaraj](\"https://avatars.githubusercontent.com/u/3784194?v=4?s=100\")
![\"Francesco](\"https://avatars.githubusercontent.com/u/7107651?v=4?s=100\")
![\"Conny](\"https://avatars.githubusercontent.com/u/71334757?v=4?s=100\")
![\"Muklas](\"https://avatars.githubusercontent.com/u/43443753?v=4?s=100\")
![\"Vadim\"/](\"https://avatars.githubusercontent.com/u/38704817?v=4?s=100\")
![\"Simran](\"https://avatars.githubusercontent.com/u/62168475?v=4?s=100\")
![\"JCarlos\"/](\"https://avatars.githubusercontent.com/u/3101238?v=4?s=100\")
![\"Ali](\"https://avatars.githubusercontent.com/u/60359433?v=4?s=100\")
![\"Carl](\"https://avatars.githubusercontent.com/u/1594624?v=4?s=100\")
![\"Mozartus\"/](\"https://avatars.githubusercontent.com/u/32893711?v=4?s=100\")
![\"Manvi](\"https://avatars.githubusercontent.com/u/55682355?v=4?s=100\")
![\"Anum](\"https://avatars.githubusercontent.com/u/39243539?v=4?s=100\")
![\"Reo](\"https://avatars.githubusercontent.com/u/47747828?v=4?s=100\")
![\"Fiordy\"/](\"https://avatars.githubusercontent.com/u/53420573?v=4?s=100\")
![\"Harshal\"/](\"https://avatars.githubusercontent.com/u/37841724?v=4?s=100\")
![\"Abhinav](\"https://avatars.githubusercontent.com/u/89785800?v=4?s=100\")
![\"Kevin\"/](\"https://avatars.githubusercontent.com/u/47126749?v=4?s=100\")
![\"Shrirang\"/](\"https://avatars.githubusercontent.com/u/28738668?v=4?s=100\")
![\"interactwithankush\"/](\"https://avatars.githubusercontent.com/u/18613127?v=4?s=100\")
![\"CharlieYu\"/](\"https://avatars.githubusercontent.com/u/17566866?v=4?s=100\")
![\"Leisterbecker\"/](\"https://avatars.githubusercontent.com/u/20650323?v=4?s=100\")
![\"DragonDreamer\"/](\"https://avatars.githubusercontent.com/u/35420129?v=4?s=100\")
![\"ShivanshCharak\"/](\"https://avatars.githubusercontent.com/u/96943825?v=4?s=100\")
![\"HattoriHenzo\"/](\"https://avatars.githubusercontent.com/u/5141285?v=4?s=100\")
![\"Arnab](\"https://avatars.githubusercontent.com/u/51032928?v=4?s=100\")
![\"MohanaRao](\"https://avatars.githubusercontent.com/u/1470114?v=4?s=100\")
![\"Yonatan](\"https://avatars.githubusercontent.com/u/14914865?v=4?s=100\")
![\"Oliani\"/](\"https://avatars.githubusercontent.com/u/25756378?v=4?s=100\")
![\"Renjie](\"https://avatars.githubusercontent.com/u/64826925?v=4?s=100\")
![\"perfect](\"https://avatars.githubusercontent.com/u/54127694?v=4?s=100\")
![\"xyllq999\"/](\"https://avatars.githubusercontent.com/u/72729433?v=4?s=100\")
![\"Mohamed](\"https://avatars.githubusercontent.com/u/91405690?v=4?s=100\")
![\"Karshil](\"https://avatars.githubusercontent.com/u/37497287?v=4?s=100\")
![\"kongleong86\"/](\"https://avatars.githubusercontent.com/u/3745455?v=4?s=100\")
![\"Aitor](\"https://avatars.githubusercontent.com/u/64830228?v=4?s=100\")
![\"Victor](\"https://avatars.githubusercontent.com/u/20733994?v=4?s=100\")
![\"Minh](\"https://avatars.githubusercontent.com/u/10632233?v=4?s=100\")
![\"yiichan\"/](\"https://avatars.githubusercontent.com/u/30886176?v=4?s=100\")
![\"Pan](\"https://avatars.githubusercontent.com/u/43316964?v=4?s=100\")
![\"zhoumengyks\"/](\"https://avatars.githubusercontent.com/u/111965739?v=4?s=100\")
![\"you\"/](\"https://avatars.githubusercontent.com/u/57100752?v=4?s=100\")
![\"Thanks\"/](\"https://avatars.githubusercontent.com/u/1121545?v=4?s=100\")
![\"LazyProgrammer\"/](\"https://avatars.githubusercontent.com/u/87204946?v=4?s=100\")
![\"Mohammed](\"https://avatars.githubusercontent.com/u/85175130?v=4?s=100\")
![\"Bruno](\"https://avatars.githubusercontent.com/u/39165280?v=4?s=100\")
![\"SammanPali\"/](\"https://avatars.githubusercontent.com/u/110753804?v=4?s=100\")
![\"Qixiang](\"https://avatars.githubusercontent.com/u/79553089?v=4?s=100\")
![\"Shourya](\"https://avatars.githubusercontent.com/u/72398499?v=4?s=100\")
![\"Alan\"/](\"https://avatars.githubusercontent.com/u/55138532?v=4?s=100\")
![\"JanFidor\"/](\"https://avatars.githubusercontent.com/u/66260538?v=4?s=100\")
![\"Anton](\"https://avatars.githubusercontent.com/u/129260?v=4?s=100\")
![\"steph88ss\"/](\"https://avatars.githubusercontent.com/u/111041594?v=4?s=100\")
![\"Yujan](\"https://avatars.githubusercontent.com/u/63731234?v=4?s=100\")
![\"yusha-g\"/](\"https://avatars.githubusercontent.com/u/110189579?v=4?s=100\")
![\"Robert](\"https://avatars.githubusercontent.com/u/20912167?v=4?s=100\")
![\"Bipin](\"https://avatars.githubusercontent.com/u/21119358?v=4?s=100\")
![\"KyleSong30\"/](\"https://avatars.githubusercontent.com/u/100892032?v=4?s=100\")
![\"u7281975\"/](\"https://avatars.githubusercontent.com/u/111095623?v=4?s=100\")
![\"harshalkhachane\"/](\"https://avatars.githubusercontent.com/u/92866584?v=4?s=100\")
![\"Tejas](\"https://avatars.githubusercontent.com/u/95495584?v=4?s=100\")
![\"Sudarsan](\"https://avatars.githubusercontent.com/u/3091087?v=4?s=100\")
![\"Vaibhav](\"https://avatars.githubusercontent.com/u/78676331?v=4?s=100\")
![\"u7275858\"/](\"https://avatars.githubusercontent.com/u/110969489?v=4?s=100\")
![\"prasad-333\"/](\"https://avatars.githubusercontent.com/u/37048768?v=4?s=100\")
![\"JurenXu\"/](\"https://avatars.githubusercontent.com/u/101047547?v=4?s=100\")
![\"murphShaw\"/](\"https://avatars.githubusercontent.com/u/111167533?v=4?s=100\")
![\"XianWu99\"/](\"https://avatars.githubusercontent.com/u/111103319?v=4?s=100\")
![\"JoshuaSinglaANU\"/](\"https://avatars.githubusercontent.com/u/109902734?v=4?s=100\")
![\"Ricardo](\"https://avatars.githubusercontent.com/u/36955909?v=4?s=100\")
![\"Farid](\"https://avatars.githubusercontent.com/u/72947724?v=4?s=100\")
![\"Vinícius](\"https://avatars.githubusercontent.com/u/91766068?v=4?s=100\")
![\"Stefanel](\"https://avatars.githubusercontent.com/u/25990078?v=4?s=100\")
![\"Prince](\"https://avatars.githubusercontent.com/u/79313705?v=4?s=100\")
![\"WuLang\"/](\"https://avatars.githubusercontent.com/u/48200100?v=4?s=100\")
![\"Hugo](\"https://avatars.githubusercontent.com/u/54300585?v=4?s=100\")
![\"Shivanagouda](\"https://avatars.githubusercontent.com/u/88313126?v=4?s=100\")
![\"Aparna\"/](\"https://avatars.githubusercontent.com/u/13827254?v=4?s=100\")
![\"Girolamo](\"https://avatars.githubusercontent.com/u/56109364?v=4?s=100\")
![\"Chak-C\"/](\"https://avatars.githubusercontent.com/u/114961815?v=4?s=100\")
![\"Nakul](\"https://avatars.githubusercontent.com/u/39953357?v=4?s=100\")
![\"KarmaTashiCat\"/](\"https://avatars.githubusercontent.com/u/76797146?v=4?s=100\")
![\"marikattt\"/](\"https://avatars.githubusercontent.com/u/49302558?v=4?s=100\")
![\"Hashvardhan](\"https://avatars.githubusercontent.com/u/84663071?v=4?s=100\")
![\"YongHwan\"/](\"https://avatars.githubusercontent.com/u/67625677?v=4?s=100\")
![\"Shogo](\"https://avatars.githubusercontent.com/u/10365357?v=4?s=100\")
![\"Eugene\"/](\"https://avatars.githubusercontent.com/u/48804404?v=4?s=100\")
![\"Piyush\"/](\"https://avatars.githubusercontent.com/u/118425491?v=4?s=100\")
![\"Rahul](\"https://avatars.githubusercontent.com/u/517415?v=4?s=100\")
![\"Bharath](\"https://avatars.githubusercontent.com/u/49526472?v=4?s=100\")
![\"Saiteja](\"https://avatars.githubusercontent.com/u/13088886?v=4?s=100\")
![\"Enrique](\"https://avatars.githubusercontent.com/u/115318468?v=4?s=100\")
![\"Ramil](\"https://avatars.githubusercontent.com/u/13589365?v=4?s=100\")
![\"东方未白\"/](\"https://avatars.githubusercontent.com/u/50656114?v=4?s=100\")
![\"Fredrik](\"https://avatars.githubusercontent.com/u/62488841?v=4?s=100\")
![\"akshatarora0013\"/](\"https://avatars.githubusercontent.com/u/102645021?v=4?s=100\")
![\"Mughees](\"https://avatars.githubusercontent.com/u/45170085?v=4?s=100\")
![\"behappyleee\"/](\"https://avatars.githubusercontent.com/u/72903623?v=4?s=100\")
![\"Ayush](\"https://avatars.githubusercontent.com/u/116510022?v=4?s=100\")
![\"Anthony](\"https://avatars.githubusercontent.com/u/55814237?v=4?s=100\")
![\"trananso\"/](\"https://avatars.githubusercontent.com/u/37683428?v=4?s=100\")
![\"Giammaria](\"https://avatars.githubusercontent.com/u/102854627?v=4?s=100\")
![\"Saiful](\"https://avatars.githubusercontent.com/u/36008396?v=4?s=100\")
![\"JabezBrew\"/](\"https://avatars.githubusercontent.com/u/74483609?v=4?s=100\")
![\"konstantin-goldman\"/](\"https://avatars.githubusercontent.com/u/47669472?v=4?s=100\")
![\"Tien](\"https://avatars.githubusercontent.com/u/39063457?v=4?s=100\")
![\"Vladimir\"/](\"https://avatars.githubusercontent.com/u/49140851?v=4?s=100\")
![\"Surjendu\"/](\"https://avatars.githubusercontent.com/u/101238933?v=4?s=100\")
![\"bakazhou\"/](\"https://avatars.githubusercontent.com/u/81795984?v=4?s=100\")
![\"Owen](\"https://avatars.githubusercontent.com/u/43698890?v=4?s=100\")
![\"Stavros](\"https://avatars.githubusercontent.com/u/20283468?v=4?s=100\")
![\"Syyed](\"https://avatars.githubusercontent.com/u/20753671?v=4?s=100\")
![\"JiaDi](\"https://avatars.githubusercontent.com/u/95570096?v=4?s=100\")
![\"Sanchit](\"https://avatars.githubusercontent.com/u/16536741?v=4?s=100\")
![\"Md](\"https://avatars.githubusercontent.com/u/48361160?v=4?s=100\")
![\"Antonio](\"https://avatars.githubusercontent.com/u/39912670?v=4?s=100\")
![\"Allagadda](\"https://avatars.githubusercontent.com/u/25962010?v=4?s=100\")
![\"Matheus](\"https://avatars.githubusercontent.com/u/31048764?v=4?s=100\")
![\"Appari](\"https://avatars.githubusercontent.com/u/36763910?v=4?s=100\")
![\"Marcel](\"https://avatars.githubusercontent.com/u/1023197?v=4?s=100\")
![\"Muhammad](\"https://avatars.githubusercontent.com/u/74542852?v=4?s=100\")
![\"JackH408\"/](\"https://avatars.githubusercontent.com/u/141727294?v=4?s=100\")
![\"Shubham\"/](\"https://avatars.githubusercontent.com/u/132815243?v=4?s=100\")
![\"Nishant](\"https://avatars.githubusercontent.com/u/121454072?v=4?s=100\")
![\"Rhitam](\"https://avatars.githubusercontent.com/u/90751158?v=4?s=100\")
![\"JerryZhao275\"/](\"https://avatars.githubusercontent.com/u/132061401?v=4?s=100\")
![\"Leonardo](\"https://avatars.githubusercontent.com/u/1445890?v=4?s=100\")
![\"Yennifer](\"https://avatars.githubusercontent.com/u/19285706?v=4?s=100\")
![\"jnniu-n\"/](\"https://avatars.githubusercontent.com/u/141746282?v=4?s=100\")
![\"Miguel](\"https://avatars.githubusercontent.com/u/48435117?v=4?s=100\")
![\"Suwan](\"https://avatars.githubusercontent.com/u/86839778?v=4?s=100\")
![\"alok\"/](\"https://avatars.githubusercontent.com/u/97467835?v=4?s=100\")
![\"Daniel](\"https://avatars.githubusercontent.com/u/53951425?v=4?s=100\")
![\"Sam](\"https://avatars.githubusercontent.com/u/105279107?v=4?s=100\")
![\"João](\"https://avatars.githubusercontent.com/u/104360594?v=4?s=100\")
![\"Hong](\"https://avatars.githubusercontent.com/u/89684956?v=4?s=100\")
![\"Doksanbir\"/](\"https://avatars.githubusercontent.com/u/7249450?v=4?s=100\")
![\"Chant3ll3\"/](\"https://avatars.githubusercontent.com/u/141697333?v=4?s=100\")
![\"Jakub](\"https://avatars.githubusercontent.com/u/58841343?v=4?s=100\")
![\"believe\"/](\"https://avatars.githubusercontent.com/u/28935461?v=4?s=100\")
![\"egg0102030405\"/](\"https://avatars.githubusercontent.com/u/59650695?v=4?s=100\")
![\"Ved](\"https://avatars.githubusercontent.com/u/77259804?v=4?s=100\")
![\"NewMorning\"/](\"https://avatars.githubusercontent.com/u/95869761?v=4?s=100\")
![\"资深老萌新\"/](\"https://avatars.githubusercontent.com/u/98251397?v=4?s=100\")
![\"Seunghwan](\"https://avatars.githubusercontent.com/u/113348293?v=4?s=100\")
![\"sugavanesh\"/](\"https://avatars.githubusercontent.com/u/71312159?v=4?s=100\")
![\"FinnS-F\"/](\"https://avatars.githubusercontent.com/u/126026830?v=4?s=100\")
![\"jerryyummy\"/](\"https://avatars.githubusercontent.com/u/62087610?v=4?s=100\")
![\"Manoj](\"https://avatars.githubusercontent.com/u/28005510?v=4?s=100\")
![\"Aditya\"/](\"https://avatars.githubusercontent.com/u/76624290?v=4?s=100\")
![\"nooynayr\"/](\"https://avatars.githubusercontent.com/u/141696269?v=4?s=100\")
![\"CYBERCRUX2\"/](\"https://avatars.githubusercontent.com/u/41006191?v=4?s=100\")
![\"Luis](\"https://avatars.githubusercontent.com/u/44934142?v=4?s=100\")
![\"guqing\"/](\"https://avatars.githubusercontent.com/u/38999863?v=4?s=100\")
![\"Sashir](\"https://avatars.githubusercontent.com/u/14045506?v=4?s=100\")
![\"omahs\"/](\"https://avatars.githubusercontent.com/u/73983677?v=4?s=100\")
![\"leif](\"https://avatars.githubusercontent.com/u/4026636?v=4?s=100\")
![\"Jun](\"https://avatars.githubusercontent.com/u/20232155?v=4?s=100\")
![\"Kishalay](\"https://avatars.githubusercontent.com/u/71012321?v=4?s=100\")
![\"drishtii7\"/](\"https://avatars.githubusercontent.com/u/82076566?v=4?s=100\")
![\"David](\"https://avatars.githubusercontent.com/u/53974843?v=4?s=100\")
![\"Roman](\"https://avatars.githubusercontent.com/u/61774094?v=4?s=100\")
![\"Riley\"/](\"https://avatars.githubusercontent.com/u/144370752?v=4?s=100\")
![\"k1w1dev\"/](\"https://avatars.githubusercontent.com/u/121696782?v=4?s=100\")
![\"dev-yugantar\"/](\"https://avatars.githubusercontent.com/u/153066190?v=4?s=100\")
![\"Adelya\"/](\"https://avatars.githubusercontent.com/u/65678470?v=4?s=100\")
![\"gatlanagaprasanna\"/](\"https://avatars.githubusercontent.com/u/154739216?v=4?s=100\")
![\"Avinash](\"https://avatars.githubusercontent.com/u/37360069?v=4?s=100\")
![\"Mayank](\"https://avatars.githubusercontent.com/u/97609699?v=4?s=100\")
![\"romannimets\"/](\"https://avatars.githubusercontent.com/u/137268574?v=4?s=100\")
![\"Joel\"/](\"https://avatars.githubusercontent.com/u/60149879?v=4?s=100\")
![\"Walyson](\"https://avatars.githubusercontent.com/u/125759796?v=4?s=100\")
![\"Xcyq\"/](\"https://avatars.githubusercontent.com/u/39086666?v=4?s=100\")
![\"Ritabrata\"/](\"https://avatars.githubusercontent.com/u/60834250?v=4?s=100\")
![\"Trivikram](\"https://avatars.githubusercontent.com/u/16024985?v=4?s=100\")
![\"Vincent](\"https://avatars.githubusercontent.com/u/3204600?v=4?s=100\")
![\"Antoine](\"https://avatars.githubusercontent.com/u/79988396?v=4?s=100\")
![\"QinShower\"/](\"https://avatars.githubusercontent.com/u/43347407?v=4?s=100\")
![\"LakshyaPunyani-01\"/](\"https://avatars.githubusercontent.com/u/103628913?v=4?s=100\")
![\"jasonjyu\"/](\"https://avatars.githubusercontent.com/u/10333076?v=4?s=100\")
![\"jeffmorrison\"/](\"https://avatars.githubusercontent.com/u/26047158?v=4?s=100\")
![\"David](\"https://avatars.githubusercontent.com/u/10840681?v=4?s=100\")
![\"Patrick](\"https://avatars.githubusercontent.com/u/12052783?v=4?s=100\")
![\"Juyeon\"/](\"https://avatars.githubusercontent.com/u/62143949?v=4?s=100\")
![\"Mammad](\"https://avatars.githubusercontent.com/u/66476643?v=4?s=100\")
![\"Salma\"/](\"https://avatars.githubusercontent.com/u/121863224?v=4?s=100\")
![\"Arpit](\"https://avatars.githubusercontent.com/u/182847716?v=4?s=100\")
![\"Maya\"/](\"https://avatars.githubusercontent.com/u/111644421?v=4?s=100\")
![\"HabibaMekay\"/](\"https://avatars.githubusercontent.com/u/133516736?v=4?s=100\")
![\"Ahmed-Taha-981\"/](\"https://avatars.githubusercontent.com/u/122402269?v=4?s=100\")
![\"Malak](\"https://avatars.githubusercontent.com/u/67643605?v=4?s=100\")
![\"BiKangNing\"/](\"https://avatars.githubusercontent.com/u/164312726?v=4?s=100\")
![\"Tarun](\"https://avatars.githubusercontent.com/u/138651451?v=4?s=100\")
![\"Shahd](\"https://avatars.githubusercontent.com/u/132148556?v=4?s=100\")
![\"Mehdi](\"https://avatars.githubusercontent.com/u/24210842?v=4?s=100\")
![\"Clint](\"https://avatars.githubusercontent.com/u/111376518?v=4?s=100\")
![\"darkhyper24\"/](\"https://avatars.githubusercontent.com/u/132711528?v=4?s=100\")
![\"Mohaned](\"https://avatars.githubusercontent.com/u/105852138?v=4?s=100\")
![\"Maxim](\"https://avatars.githubusercontent.com/u/154841002?v=4?s=100\")
![\"Harshita](\"https://avatars.githubusercontent.com/u/65297242?v=4?s=100\")
![\"smile-ab\"/](\"https://avatars.githubusercontent.com/u/202159894?v=4?s=100\")
![\"Francisco-G-P\"/](\"https://avatars.githubusercontent.com/u/186766789?v=4?s=100\")
![\"Gabriel](\"https://avatars.githubusercontent.com/u/137895372?v=4?s=100\")
![\"Deniz](\"https://avatars.githubusercontent.com/u/93663085?v=4?s=100\")
![\"John](\"https://avatars.githubusercontent.com/u/70539458?v=4?s=100\")
![\"Sanura](\"https://avatars.githubusercontent.com/u/16178588?v=4?s=100\")
![\"Kim](\"https://avatars.githubusercontent.com/u/31699375?v=4?s=100\")
![\"Suchismita](\"https://avatars.githubusercontent.com/u/68535074?v=4?s=100\")
![\"ssrijan-007-sys\"/](\"https://avatars.githubusercontent.com/u/137605821?v=4?s=100\")
![\"e5LA\"/](\"https://avatars.githubusercontent.com/u/208197507?v=4?s=100\")
![\"Maziyar](\"https://avatars.githubusercontent.com/u/122622721?v=4?s=100\")
![\"yoobin_mion\"/](\"https://avatars.githubusercontent.com/u/113106136?v=4?s=100\")
![\"Soumik](\"https://avatars.githubusercontent.com/u/46843689?v=4?s=100\")
![\"Naman](\"https://avatars.githubusercontent.com/u/82610773?v=4?s=100\")
![\"Thanh](\"https://avatars.githubusercontent.com/u/92111552?v=4?s=100\")
![\"Soham](\"https://avatars.githubusercontent.com/u/121136639?v=4?s=100\")
![\"Olexandr88\"/](\"https://avatars.githubusercontent.com/u/93856062?v=4?s=100\")