pax_global_header00006660000000000000000000000064131255053630014515gustar00rootroot0000000000000052 comment=d793160bce695af33e8d0c55b9ffcb3e0f2d6f3f java-design-patterns-1.16.0/000077500000000000000000000000001312550536300156305ustar00rootroot00000000000000java-design-patterns-1.16.0/.gitignore000066400000000000000000000002761312550536300176250ustar00rootroot00000000000000target .metadata .settings .classpath .project *.class # Package Files # *.jar *.war *.ear .idea *.iml *.swp datanucleus.log /bin/ /bin/ /bin/ *.log data-mapper/src/main/resources/log4j.xml java-design-patterns-1.16.0/.travis.yml000066400000000000000000000026741312550536300177520ustar00rootroot00000000000000language: java jdk: - oraclejdk8 env: global: - GH_REF: github.com/iluwatar/java-design-patterns.git - secure: LxTDuNS/rBWIvKkaEqr79ImZAe48mCdoYCF41coxNXgNoippo4GIBArknqtv+XvdkiuRZ1yGyj6pn8GU33c/yn+krddTUkVCwTbVatbalW5jhQjDbHYym/JcxaK9ZS/3JTeGcWrBgiPqHEEDhCf26vPZsXoMSeVCEORVKTp1BSg= - secure: "eoWlW9GyTJY04P8K3pxayXwU9/hmptQg/LfirispQkV9YvmziCfSzXnatnBhNfud98sCzY8BScXnb+OWLTnjLKpId4rtEqb0aJ40Jc32cUKzgzFAUn7cNcDAbUIfyPAGVqyQqfj/11wYSADwWMMOPlW97ExUtoyiH2WenXuRHso=" before_install: - export DISPLAY=:99.0 - sh -e /etc/init.d/xvfb start # default install command is just "mvn install -DskipTests=true -Dmaven.javadoc.skip=true -B -V" install: - mvn install -DskipTests=true -Dmaven.javadoc.skip=true -B -V -e after_success: - mvn clean org.jacoco:jacoco-maven-plugin:prepare-agent package sonar:sonar -Dsonar.host.url=https://sonarqube.com -Dsonar.login=$SONAR_TOKEN - bash update-ghpages.sh # use latest java version available instead of travis default addons: apt: packages: - oracle-java8-installer notifications: email: - iluwatar@gmail.com webhooks: urls: - https://webhooks.gitter.im/e/3319623945358a093a6f on_success: change # options: [always|never|change] default: always on_failure: always # options: [always|never|change] default: always on_start: never # options: [always|never|change] default: always sudo: false # route the build to the container-based infrastructure for a faster build java-design-patterns-1.16.0/CODE_COVERAGE.md000066400000000000000000000007251312550536300201430ustar00rootroot00000000000000# Code Coverage Report generation To generate the code coverage report, execute the following command: > mvn clean verify This will generate code coverage report in each of the modules. In order to view the same, open the following file in your browser. > target/site/jacoco/index.html Please note that the above folder is created under each of the modules. For example: * adapter/target/site/jacoco/index.html * busniess-delegate/target/site/jacoco/index.html java-design-patterns-1.16.0/CONTRIBUTING.MD000066400000000000000000000003161312550536300177610ustar00rootroot00000000000000This is great you have something to contribute! Before going any further please read the [wiki](https://github.com/iluwatar/java-design-patterns/wiki) with conventions and rules we used for this project. java-design-patterns-1.16.0/LICENSE.md000066400000000000000000000020771312550536300172420ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2014-2016 Ilkka Seppälä Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. java-design-patterns-1.16.0/README.md000066400000000000000000000050131312550536300171060ustar00rootroot00000000000000 # Design patterns implemented in Java [![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master)](https://travis-ci.org/iluwatar/java-design-patterns) [![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md) [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Quality Gate](https://sonarqube.com/api/badges/gate?key=com.iluwatar%3Ajava-design-patterns)](https://sonarqube.com/dashboard/index/com.iluwatar%3Ajava-design-patterns) # Introduction Design patterns are formalized best practices that the programmer can use to solve common problems when designing an application or system. Design patterns can speed up the development process by providing tested, proven development paradigms. Reusing design patterns helps to prevent subtle issues that can cause major problems, and it also improves code readability for coders and architects who are familiar with the patterns. # Getting started Before you dive into the material, you should be familiar with various Programming/Software Design Principles. All designs should be as simple as possible. You should start with KISS, YAGNI, and Do The Simplest Thing That Could Possibly Work principles. Complexity and patterns should only be introduced when they are needed for practical extensibility. Once you are familiar with these concepts you can start drilling down into patterns by any of the following approaches - Using difficulty tags, `Difficulty-Beginner`, `Difficulty-Intermediate` & `Difficulty-Expert`. - Using pattern categories, `Creational`, `Behavioral` and others. - Search for a specific pattern. Can't find one? Please report a new pattern [here](https://github.com/iluwatar/java-design-patterns/issues). # How to contribute If you are willing to contribute to the project you will find the relevant information in our [developer wiki](https://github.com/iluwatar/java-design-patterns/wiki). We will help you and answer your questions in the [Gitter chatroom](https://gitter.im/iluwatar/java-design-patterns). # License This project is licensed under the terms of the MIT license. java-design-patterns-1.16.0/_scripts/000077500000000000000000000000001312550536300174565ustar00rootroot00000000000000java-design-patterns-1.16.0/_scripts/postPumlsToServer.firstrun.output000066400000000000000000000451031312550536300263160ustar00rootroot00000000000000parent: half-sync-half-async; artifact: half-sync-half-async Puml Server ID: RScv3SCm3030LU819FRPXg5fIm552tnYPFiyjRi3RkbAaYkdoQr5JBy369vrxz7oaSv6XmPhL3e6TCaJ0msU-CAoilTToyG8DdKOw5z0GzcAlvNAN_WZSD1brBHHPmxv0000 parent: abstract-document; artifact: abstract-document Puml Server ID: PSjB3eCm34NHhPG599vtDyQn85L-ifzX-p3lxEf8Twj3MXGDQvyJMFubChxpKN767gucSq07iinEjSNDOACVNvoAUZr6MWoe3QVE_WRnxZ0Mf38b-hkIGlurX_MyehS7 parent: tolerant-reader; artifact: tolerant-reader Puml Server ID: NSZ14SCm20NHLf829ExfXaYChGn26lZ4xSVdtFRjSrZJx9AkZnFOyI9olkenSEOxGxmjWnXgMvE6viLWfmz_kNI9SLZP38XRqEIuWx1Kd0t5XVjjGVj_DNtMdLD_ parent: event-driven-architecture; artifact: event-driven-architecture Puml Server ID: TOhH3SCW30LNQGS0_tSRnrZ15H1adfFromBzkfFktZQaHT7mzgh0N1yYvoUVXXf7B7Mv1dGWozN9MZmCTlhopQdeidEaoO3wMDHvRI6zzvwAssPYbsfGGRYIGlxN7DxpZDv- parent: publish-subscribe; artifact: publish-subscribe Puml Server ID: PSZB3SCm203GLTe1RExT1XCKKs5YyMdMR--zFRsd66aTNAwFcRdZ1U1uzrDorgXWfykIBJjT2qJhnaI7Dtwm7HnoMjkOoMu12-C7s3LKOhQe4UGo63ZfVtlvwhkMVW40 parent: facade; artifact: facade Puml Server ID: BSP15eCm20N0gxG7CEoz3ILKqvTW7dpq-hhehERTJ7fMJU-l7PYn4ZbVPMlOyvEXBeT13KMEGQtdnM2d7v-yL8sssJ8PKBUWmV64lYnSbHJoRqaVPUReDm00 parent: service-locator; artifact: service-locator Puml Server ID: NSjB3iCm203HgxG7iDdtDeIWX0fZYqzo_MRTtUX9ynOZhPtBzNLchlW0EDxza3nhgs2dQScMdUO0qRenqU6B5xQTGmvh2pFPBM1WF07FSmbnqqcOqu6J_gsNZxvgw0y0 parent: dao; artifact: dao Puml Server ID: 5SR14OKW30N0LhG0oVrt4o6ZE12Ov4NR_thQNQlc5aN2sd82qtz4naywAixOmyNoK8WYvT6fjdWOR7JnpLiHhuTkam4nTUhiRwZm847-J64zpUZj3m00 parent: model-view-presenter; artifact: model-view-presenter Puml Server ID: ROlR3SGW3C1MkGu0-RzjKeXQJWcWFChwPO3xispvQBrmL0hbp-q-xGkWkFBL_8upZBICxjGzbo7GE1OwAlpmmLJ9sjNJH7VIRY1e6q169KvFevMcakrtI_BoD-HGoJE4Nm00 parent: observer; artifact: observer Puml Server ID: FSkn4OGm30NHLg00hFow4KO3PcpP8tr1-pYwx6smQz5Suv2mkbp0y1-HyPlEWYlsSB7S5Q98kJSgDLu66ztyy7Q8brEtmO2OEZNs2Uhxl9u9GVv72cjfHAiV parent: intercepting-filter; artifact: intercepting-filter Puml Server ID: RSfB3i8m303Hgy014k-vZN5DQkIuaJ_q-fGzkz7JtCL8Q-DolUsPAnu0ZcSVadizAzZfi6JBJiS4qJenqU6D7smRXmnh2pFPBM1YN05o_KwyKcoqb-ZFEEcVz_BPLqtz0W00 parent: factory-method; artifact: factory-method Puml Server ID: NSZB3G8n30N0Lg20n7UwCOxPP9MVx6TMT0zdRgEvjoazYeRrMmMsFuYChtmqr7Y6gycQq8aiQr3hSJ7OwEGtfwBUZfas0shJQR3_G2yMBFkaeQYha4B-AeUDl6FqBm00 parent: private-class-data; artifact: private-class-data Puml Server ID: RShR3SCm243HLTe1RFwx3S4eeSB4uf6itmpGlwkZ-nOZhS7b-ZeoLtm07E--InwrLR3JQScMdSu9edLZeiCNBso3GtPh2pFPBM1YF07BvSBaHeeHRJm_SD8VxkMphvhw0m00 parent: async-method-invocation; artifact: async-method-invocation Puml Server ID: TSdB3SCW303GLTe1mFTkunWhk0A3_4dKxTi5UdlIUuhIoCPfuz4Zjhy03EzwIlGyqjbeQR16fJL1HjuOQF362qjZbrFBnWWsTPZeFm3wHwbCZhvQ4RqMOSXIuA1_LzDctJd75m00 parent: execute-around; artifact: execute-around Puml Server ID: NSZ14G8n20NGLhI0XBlT865suoGa0n_NylNixSsxTvEHJTF7xGHsF8YShtfqdFdCK9TbK4ELDQcFl1ZizE8tbwRH3okR0NKBcXm_a7vK4bhOLreZXVnLJPzrvnnV parent: monostate; artifact: monostate Puml Server ID: HSV14OGm20NGLjO23FVj1YEZsGaa0nzjVxrvUszfLdlkaju_9p3ZI-HybwFXp2r3l0w364eTIgtdpM2d7r-yxXBji7Ko86v1ol60TDW8C8G4zLr9rp9J-ny0 parent: thread-pool; artifact: thread-pool Puml Server ID: JSV14SCW30J0Lk82GFzq8uF6a1624IUx_UIPt-xHhMXK2TTN0zP-4pa_-UfeSSOMBzCWXbpceAxnCDZfmpUdAhjVbXO3uhPfyFw1q5oufZMdag3yFuUFl6Be5m00 parent: delegation; artifact: delegation Puml Server ID: JSV14GCX20NGLf82LkxfXbN69OFeu2VRVdBCxRsdUhLiac6F2rZxHHHybwwuyimjKQT37ANEGMfvCpZepHy-ccpjVYm697pJuFq3DJ7f39rEWlhNaZ7Aoc5V parent: chain; artifact: chain Puml Server ID: 9SR13SCm20NGLTe1OkxTXX0KKzd4Wa-pVYlrdTxJN4OTMZ4U7LZv8Wg-ssdejLTgoELGHvDhaesw6HpqvWzlXwQTlYq6D3nfSlv2qjcS5F9VgvXjrHnV parent: resource-acquisition-is-initialization; artifact: resource-acquisition-is-initialization Puml Server ID: ZShR3S8m343HLUW0YV_PnhXMQvGumOzMOdhA1lqxkhgBABLSEQqzzeZfJm33isuIUxxIsMXei4QbqK5QdXXeyCO3oyekcvQ94MpgqD4lWB6FDEA2z4bn2HbQn8leHMponNy13hgvrhHUP_Rs0m00 parent: fluentinterface; artifact: fluentinterface Puml Server ID: NOj93eCm302_KXv0VEzlN6F0bMCYB_3zvjpRQ3IpY97MnkNwEZD7l04SdtP8dlMfOAVBaYqRNHr4wy54Xo_Uk6uSSjWwC9FT0Zh61DYrPY_pyXs9WPF-NIllRLJN7m00 parent: service-layer; artifact: service-layer Puml Server ID: LOl93SCm3C1MQGUmzUysgY8aAcJ5q96WszVV_aW2V8gHriRb-ZWoPxm07E--Inxrhc2dqv8jEvq3HEl6H8SFNjWs3jcjJSnaju21iG3MSmbnK_mkuwJ_qij7dpNq1m00 parent: visitor; artifact: visitor Puml Server ID: DSR14OGm20NGLhG0mtsxmSWeJa8oyD7sTo_xJczLgoqFIM_B1Spu43c_vLHSkMU8rs4GGwcZaxPy6UnqyyFR8Q6dRPC1SGlg7B_Gew4OJeBwVqdlPMPlNm00 parent: double-dispatch; artifact: double-dispatch Puml Server ID: NSbB3iCW303HgpG70Ezx6yTOWSeOv4zp_MRTtUZDCPGa6wV9gqTiVmCOtlKQqVDCPwEbmHgLreGXUMEWmGU_M1hxkBHiZ61JXud-1BILft1fmvz37JZetshQh3kd_000 parent: monad; artifact: monad Puml Server ID: 9SR13SCm20NGLPe1OkxTXjWeSMMm1Pza_LRgExsjMntP97syBc35cyZvAMV7bKU6U9q6CPGwbVh8Xy5E7xvvRnBzj7qn86v1ol4BwJHk9AZ_bNGjAtLy0G00 parent: front-controller; artifact: front-controller Puml Server ID: PSlB3OGm303HLfO24j-t6nCC13bEvC_IFk6yjz6JPgbIE3OAvS_fFkmBe7Zde_ePQnXfwU8adajlK3bkT5Iuy8Tf8wk7f87kf6BGq6R0hlD8xwQTUG9v-SCSslA8nWy0 parent: strategy; artifact: strategy Puml Server ID: FSV13OCm30NGLM00udktCS4AGOaJsTz5tRwSkBstLiqj3WbhombC_n0PtwbKdB67Y-MX44NAerDjSJFOwE8lRuTuBRfD1iJKgRC_88SnfFn8aD-ai9vczFO7 parent: command; artifact: command Puml Server ID: DSgn4OCm30NGLM00h3xR25i7vYpXaxx2-g59zugtTgiZcwIFvGHcV8YSdt9qdBbdYDVR88PIRwK-yc6mqyLVtff4FsoR38XRa7Aye3SgMoD1_RkaQvcfumS0 parent: abstract-factory; artifact: abstract-factory Puml Server ID: PSZB3OD034NHLa81Czwd6sCC39gVxEUWT1_ssLmTtQLqgR5fM7sTmFGtaV6TZu8prd0r6HtQaMKqAZLk1XjT_E6qgPUZfyc0MdTgx0-8LuUn8ErFXdr98NypXxKyezKV parent: flux; artifact: flux Puml Server ID: 7SP14eCm20NGg-W13FlU1YFLE0GpyAazVZk-rPkRLSrDqdKwW14l8kUxx0r7hXdYzJA8eTIhKzEy6UnqyeUNJQBjjWm6n2seS_n3Ryql2UgJajxBoAu_ parent: event-aggregator; artifact: event-aggregator Puml Server ID: PSf13iCW30NHgxG70Ezx6uTOX0eCih-JwvTzTwEdUJSjFKu9wwyBMFuXCdvoRRZY21ShKo6ANEQWrkDXiD6NRqwdUAkQ5WDYwZJOTv3SUqzSgqbbp0qeVvZ3Hbun-Wy0 parent: singleton; artifact: singleton Puml Server ID: HSV14SCm20J0Lk82BFxf1ikCh0n26ZZizfDVVhjRjwfvIhg-Bc35cyZvAQtZoYD3l4w364gTWxhcms2d3z-ydnAzsRuO4BUWmV43HRUcWcaagF-Lz55M3lq2 parent: null-object; artifact: null-object Puml Server ID: JSV14SCm20J0Lk829Fxf1cF6bWSX3JhYzfDdVhjRSx4yDCDU5p3NcoZugMV3bNik3HaETLGPdPhbm-2WcpzS3btjz38PqF15dTSFv6bMndwhW1Jo_vhHwynkNm00 parent: multiton; artifact: multiton Puml Server ID: FST14i8m20NGg-W16lRUXgPCYnD81Zxs-hfozzvJlOywf68yBc3bYoZuRgVYghrIea-7E5gVHZhgPd3Gcp-y7P9w-hOOaF0au_o1h0OKqqdG_saLrbRP-080 parent: composite; artifact: composite Puml Server ID: HSf13eCm30NHgy01YFUzZGaM62LEP7-NwvTTT_EaMTLgoqFIst81Cpv4payv5LVk6U9r6CHGwkYaBHy6EztyvUsGqDEsoO2u1NMED-WTvmY5aA3-LT9xcTdR3m00 parent: api-gateway; artifact: image-microservice Puml Server ID: 3Sp13SCm2030LTe1RFxTXX3aK1biOOZLxPlVlUujHZrFJk-lAsAk3u3ZhatYoYCNEmqBjgWq5AJdna27BzvOJbxIh4oCOBS5Yki1u9JIC7ZZ3pW8HB5nKI4VJtSBSKtNEbFx7m00 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'api-gateway/etc/image-microservice.urm.puml' pumlid: 3Sp13SCm2030LTe1RFxTXX3aK1biOOZLxPlVlUujHZrFJk-lAsAk3u3ZhatYoYCNEmqBjgWq5AJdna27BzvOJbxIh4oCOBS5Yki1u9JIC7ZZ3pW8HB5nKI4VJtSBSKtNEbFx7m00 parent: api-gateway; artifact: api-gateway-service Puml Server ID: JSox3SCm303HLP819FRUXg49cO542_nOyFPncUvUSszHwhbpMdyT4TCt0CDLcyIHdtGsEZLOez8vG7ek33JuueLbPvUcPM84cpeCz2S0fvI6mGjluA1_b-Tt2N5D6tNcw3y0 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'api-gateway/etc/api-gateway-service.urm.puml' pumlid: JSox3SCm303HLP819FRUXg49cO542_nOyFPncUvUSszHwhbpMdyT4TCt0CDLcyIHdtGsEZLOez8vG7ek33JuueLbPvUcPM84cpeCz2S0fvI6mGjluA1_b-Tt2N5D6tNcw3y0 parent: api-gateway; artifact: price-microservice Puml Server ID: 3Sn13iGW243HgqmFeEpdDfGIoqJK8DJqzkFklyq_f56DYyFgvtOVymjWk78Hl-ECoKQzEJVFr1Mana97Wny-c2wUKbeQwCxM9YZE7O13Ka7dXI-m4mmJugH2rlVksSXXcaTe_GC0 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'api-gateway/etc/price-microservice.urm.puml' pumlid: 3Sn13iGW243HgqmFeEpdDfGIoqJK8DJqzkFklyq_f56DYyFgvtOVymjWk78Hl-ECoKQzEJVFr1Mana97Wny-c2wUKbeQwCxM9YZE7O13Ka7dXI-m4mmJugH2rlVksSXXcaTe_GC0 parent: object-pool; artifact: object-pool Puml Server ID: JSV94SCm2030Lk829Fxf1cF6bWU1XYDkFtdcjxiD9Qc3o-LrPQvu0pW-_HnvrLx1JgR9cfrimf1wCD7XnW-sWsESsXPcicl0nFW1RB-PiYqp0KxwVo-VVTMKBm00 parent: adapter; artifact: adapter Puml Server ID: DSR14S8m30J0Lg20M7-wEMnDOiPMFDA9j0yyUEtUkzMHJTF7xI1NF4GSLzaxZtncgDVJgCPIpobzv0N2vOKtjgRHTziMI7KBcOXl10thfxB-Nz9dMJd71m00 parent: hexagonal; artifact: hexagonal Puml Server ID: HSTB4W8X30N0g-W1XkozpPD90LO8L3wEnzUTk-xxq2fvSfhSUiJs1v7XAcr4psSwMrqQh57gcZGaBmICNdZZEDb7qsCZWasT9lm7wln1MmeXZlfVIPjbvvGl parent: value-object; artifact: value-object Puml Server ID: LSZ13SCm20NGLTe1RExTXX2KECBOmfza_VRQszDxDnVBNJFiTG9pVOY2dteqdBdbqf3XK4ULqQbPFWmEklZcikjgXvV9W8Olwhn-e9ijjOpjKW4fv2zgHgypktq1 parent: twin; artifact: twin Puml Server ID: 7SR13OCm30NGLUW0n7UsCS42eyH4zdUpFbNVwNtKQij3qjjo0ICs8kTPJiMLUuPuVGnYAFNff2qdWvrk_l9wIEXfws10t88wno-4gKQ2-az9xsLaRoy0 parent: semaphore; artifact: semaphore Puml Server ID: HSV14SCm20J0Lk82BFxf1ikCfOn06ZZizfDVVhjRjphobFJnQi2ADv7pKwwEbaU6U9q6CPGwbVh8Xy5E7xvvFoNwPVjYGDo2bEC72b5URRgGeFvNqhMirF45 parent: message-channel; artifact: message-channel Puml Server ID: NSZB3SCm203GLTe1RExTXX1akm9YyMdMRy-zFRtdCf8wkLmUCtF72y3nxcFbhAE2dIvBjknqAIof6nCTtlZ1TdAiOMrZ9hi5ACOFe1o1WnjDD6C1Jlg_NgvzbyeN parent: poison-pill; artifact: poison-pill Puml Server ID: JSZ14SCm20NHLf82BExfXiYCJGOX3NpYzkDZRllsgTwjTgcmnmciV145N-rGdFMkbEZJ8OxMvo2rkXWSzE4lRxka7huj1YGyQN3UGMjgpdkh6Gdwlrl5QAk6_G00 parent: aggregator-microservices; artifact: aggregator-service Puml Server ID: JOov3SCm301NIGQGs7iRXYPa1g8ayB7NjuiKwGvtmBrbKC-Tq_hhY5Y-0HXUjKaS-Kbdepc2HrIQ2jBpma23BvvOTdPfeooCO1iEYlu0O6l63MDQKI6Rp-CKOWSE-ey_NzEqhjH-0m00 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'aggregator-microservices/etc/aggregator-service.urm.puml' pumlid: JOov3SCm301NIGQGs7iRXYPa1g8ayB7NjuiKwGvtmBrbKC-Tq_hhY5Y-0HXUjKaS-Kbdepc2HrIQ2jBpma23BvvOTdPfeooCO1iEYlu0O6l63MDQKI6Rp-CKOWSE-ey_NzEqhjH-0m00 parent: aggregator-microservices; artifact: information-microservice Puml Server ID: LSnB3i8m303Hgy016k-vZN5DQXGxaJ_jzUcMtKXFcgSOZTgvV3oEp1Kl0CUhTScZtXNiD2tPij5Ka54N9ZfyySHjvv1ksy9CTWjGZ3i0UtVkcDCt5V9vFquX3k0a4FjCLqoPzgUjNDig7Jy0 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'aggregator-microservices/etc/information-microservice.urm.puml' pumlid: LSnB3i8m303Hgy016k-vZN5DQXGxaJ_jzUcMtKXFcgSOZTgvV3oEp1Kl0CUhTScZtXNiD2tPij5Ka54N9ZfyySHjvv1ksy9CTWjGZ3i0UtVkcDCt5V9vFquX3k0a4FjCLqoPzgUjNDig7Jy0 parent: aggregator-microservices; artifact: inventory-microservice Puml Server ID: LSpB3G8n303HLg20ZUzqOxnMrYXn8d-oedjovJRIIEyfIYrFJckFAsBw2y3mBbNYodSw6mqDrYWqEaZB6mCDFhZmEDcbwZ4nWaqTEleEm5gDAyQmemlPsCOIOWSE0j6riM7VlrVIUfdPsmy0 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'aggregator-microservices/etc/inventory-microservice.urm.puml' pumlid: LSpB3G8n303HLg20ZUzqOxnMrYXn8d-oedjovJRIIEyfIYrFJckFAsBw2y3mBbNYodSw6mqDrYWqEaZB6mCDFhZmEDcbwZ4nWaqTEleEm5gDAyQmemlPsCOIOWSE0j6riM7VlrVIUfdPsmy0 parent: bridge; artifact: bridge Puml Server ID: BSR14SCm20J0Lf82BFxf1akCJ4R26ZZYzkE7zxLljJgoIVfu7S2A3v7pLRhYo3r3l9u6CPHwJjAH5uETllpZhKbejsqn86v1a-CExQwj2mdgqv8-oyev_W00 parent: servant; artifact: servant Puml Server ID: DSkn4O0m20NGLNG0G-ys63cDbv0SV7HzRUnUy-QYkSOkONKwWU4haV6JZe8pjd2nt1MYIBatAZKU1XjTVFEoYvT3by60c3erzW_qdPiL9CY_KrXB8rfz0G00 parent: lazy-loading; artifact: lazy-loading Puml Server ID: LSXB3W8X303Gg-W1e7jlqu66gIc5zED4JwzRTo_lpjeaEwN9xOpO_W0mlEhWEFD89sjBWpHgMnDOyi90WoU-i7Ho7besHf2fmqJ_0GG_xo8BE-i0YlONDMtMdLE- parent: flyweight; artifact: flyweight Puml Server ID: HSV94S8m3030Lg20M7-w4OvYAoCh7Xtnq3ty-Eq-MQlaJcdow17JNm26gpIEdkzqidffa4Qfrm2MN1XeSEADsqxEJRU94MJgCD1_W4C-YxZr08hwNqaRPUQGBm00 parent: mutex; artifact: mutex Puml Server ID: 9SR13OCm30NGLSe0n7UsCS62LB69x6zWV2hrdTxKhFRS9Br_3c34GkHybxtXo3L3l9u6CPHwAhMUDuETldpnl4cqtUR1WBW5ASSlf0bvI53_A-bQHcf_0G00 parent: mediator; artifact: mediator Puml Server ID: FSV14SCm20J0Lk82BFxf1akCJKOW3JhizfDNVhkRUktP9AE_Bc2kDr7mKqx5bKSkYJeSuYXr66dFXy517xvvRxBqz7qo8E6BZDSFPDAKCO84zP-IOMMczIy0 parent: page-object; artifact: page-object Puml Server ID: JSV14OGW30NGLjO28FVj9iOCua1Wme-sxnxtzjvMJLeS6ju-9p3NbyZvoQNYZ3sMkWo36hACJhN5ms2dYszEXwvQB4q6r6rHv_K3JIwQndwfW1Jo_npUyupUNW00 parent: factory-kit; artifact: factory-kit Puml Server ID: JST15i8m20N0g-W14lRU1YcsQ4BooCS-RwzBTpDNSscvQKQx7C1SDwBWi-w68--vD6Gur55bTBAM9uE3dlpcikcotSjaGCCNTLu_q8C58pxbPI25_Bzcz3gpjoy0 parent: property; artifact: property Puml Server ID: FSV13OCm30NGLTe1YEziumOBKYMEPN-3s9wUUdlltRJst2Izlmx0OYLolihUSEGdGxnEXIXAdODQpul1Jby-UTaasgwBCI2kGOFZ1pAV9ewR1FMVaZwAvUWF parent: dependency-injection; artifact: dependency-injection Puml Server ID: RSdB3SCW303GLPe1mFTkunWhSGG6-PEesxS3zFQajubIpyPf_NL6B7y363xra3XpJsUZgS4QbUO0wVbWeC65DvR6BeUMXH5iwZ3GVu36YxMnqgU8NamXKu63_aPD6tNbw5y0 parent: layers; artifact: layers Puml Server ID: BSR13OCm30NGLSe0n7UsCS62L8w9x6yGszD3t-bDpQhc9kdwEO0H2v7pNVQ68zSCyNeQn53gsQbftWns-lB5yoRHTfi70-8Mr3b-8UL7F4XG_otflOpi-W80 parent: producer-consumer; artifact: producer-consumer Puml Server ID: PSjB3iCW303HgxG70Ezx6zTO2HKso9_a-c7VtUX9y-vA8nkdZTSPiVm3O7ZNeyUPttGscXgiKMaAz94t1XhyyCBIsFkXPM44cpe8-WvODbiIMzcdfspXe7-jQL9NodW0 parent: builder; artifact: builder Puml Server ID: DSR94O0m2030LhG0mzzkC64KXs26GzlNZw_TcRLADagJwOWOlW8OFcNdE79B9wkN1ccKUdLWoGS33KwySMdalEioC89C7Jhw5zYIfNrIrFybhPUHNLu0 parent: specification; artifact: specification Puml Server ID: LSX14i8m20NGg-W16lRU1YcsE0d9mCTUNxVkthoxkVJQjQBVJc3bWoZuQeVXh6UbXao7EfhCGTRhOd3Gcp-yxPfs-BOOqF2amVa3vLAnbmd3ffD2_gTLZBPgz2y0 parent: state; artifact: state Puml Server ID: 9SRH3O0m20N0LNG0ox_RO2LQqz867hg-9jxNpKLpZLt2wdG2mrSYuoST1MTiuMAvAqIHSczKQZmCDhhuvcKNBuSkWm4nTMhiNyZ141BaVocifH6jlW00 parent: reader-writer-lock; artifact: reader-writer-lock Puml Server ID: RSZB4S8m303HLg00MtUw4R8cCP5bZpwuVL80jttxx4gIZTFaSKOiVm4OxdhqEFETpaPJWpKgpG5TScEWmGU_M1fxFxGiZ61JXu5-1nXZOolR-gqYaoxWe3-xfeswSiWF parent: interpreter; artifact: interpreter Puml Server ID: JSf13eCm30NHgz034E-vZGaM62Kcih_BzQ6xxjv8yr6hBJT9RzC1Z5Y8dE-oAuvSCyJhPH13gLSdRNapsEdaBy-RXEus3mR4BQXpl21zVnykFmlgVvVqNaRszW00 parent: template-method; artifact: template-method Puml Server ID: NSZ13SCW30NGLPe1mFTkuu0Lg6n0vZjPlpttzlIEFef6bN1zDM3jDv7paw-E5cTiyJ87P22NQTGr7WOxVVZcL6NtQwJ5WFZOPBn_88WjPKWoGPkL1EN_ShZb5QPV parent: feature-toggle; artifact: feature-toggle Puml Server ID: NSZ14G8X30NGLhG0oDrk8XjPd12OvCTjNy_UthpxiAPvIBhUJc37WyZvgdtWp6U6U5i6CTIs9WtDYy5ER_vmEIH6jx8P4BUWoV43lOIHBWMhTnKIjB-gwRFkdFe5 parent: business-delegate; artifact: business-delegate Puml Server ID: POl13SCm3CHMQGU8zUysgYCuBcJ5a4x9-l6_Fu84tzsgvYxf-Zg06HyYvxkqZYE_6UBrD8YXr7DGrxmPxFJZYxTTeZVR9WFY5ZGu5j2wkad4wYgD8IIe_xQaZp9pw0C0 parent: naked-objects; artifact: naked-objects-integtests Puml Server ID: LSmn4iCW30NHgoG70FMvZGmQ6ni48tt5ru_RT3kls7VJqgDAM7yTmF8FaV6TzuOZjd2nCXMYo6KEQZrk1XkT_ELKnTkkQJ4Wfaw3_GbIlgIckPrIu2Ge_vBQyziX3izX8wyO_GS0 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'naked-objects/etc/naked-objects-integtests.urm.puml' pumlid: LSmn4iCW30NHgoG70FMvZGmQ6ni48tt5ru_RT3kls7VJqgDAM7yTmF8FaV6TzuOZjd2nCXMYo6KEQZrk1XkT_ELKnTkkQJ4Wfaw3_GbIlgIckPrIu2Ge_vBQyziX3izX8wyO_GS0 parent: naked-objects; artifact: naked-objects-dom Puml Server ID: LSZ94SCW3030Lf82G7zt8mkDZOC4eyDkF_dcjxFlhZIoSTfudH7BDm33fnuzpjpJsMXgi4QbAT17FXXeSE6DfR7tGyl223Pr4FGVGF73hSpzOWe73lgVqgRKDAahPNm1 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'naked-objects/etc/naked-objects-dom.urm.puml' pumlid: LSZ94SCW3030Lf82G7zt8mkDZOC4eyDkF_dcjxFlhZIoSTfudH7BDm33fnuzpjpJsMXgi4QbAT17FXXeSE6DfR7tGyl223Pr4FGVGF73hSpzOWe73lgVqgRKDAahPNm1 parent: naked-objects; artifact: naked-objects-fixture Puml Server ID: LSX15i8W30N0g-W187jlaq9igH1uoO_r-BfrDs_kJKkFAc7zTW3B7qJ6LzuRZjZ2nSfKY2ANEQZrk1XiTFARKnLlkwR5W9Ww3VOVIFabDStjb08dGVcVz6mVX4aE6td5w5y0 I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file 'naked-objects/etc/naked-objects-fixture.urm.puml' pumlid: LSX15i8W30N0g-W187jlaq9igH1uoO_r-BfrDs_kJKkFAc7zTW3B7qJ6LzuRZjZ2nSfKY2ANEQZrk1XiTFARKnLlkwR5W9Ww3VOVIFabDStjb08dGVcVz6mVX4aE6td5w5y0 parent: model-view-controller; artifact: model-view-controller Puml Server ID: ROl13SCm201NQGUm-NSRQgE42h258Lw_wR-_qvtkoTOaEwNBuuoOwmNWkEl1SUOx5taR5cHHsr1WoOs13X-yi7HQV5YP645k2nJN3Q2ZavIBQPVVwqFajXJjVwdfMcUgV040 parent: proxy; artifact: proxy Puml Server ID: 9SR13OCm30NGLM00udktCS62eCI9x6yesrEfx_Jcehd69c5rEe3X7oBZE-q5HwpXOhahH95oRrHgt0msEldYPHClkow30J5rQko_qB3-VKYG_qjXBOrezGK0 parent: memento; artifact: memento Puml Server ID: DSgn4OCm30NGLM00h3xR2AC3SvRiaxx2-g59zugtDgiz3qdlomNC-10vF-Lik7BF4A_388PIXrBh-J3OwUOlRuT4EssR38XRa7Ay81Lz_o11_RkaQvcf_GS0 parent: decorator; artifact: decorator Puml Server ID: HSV14SCm20J0Lk82BFxf1YF6LaP26ZZizfDVVhjRC-bPDRs_Bc35cyZvAMV3bKU6kao36ehCGQtdms2d3z-yLursshuOKBUWmV43LPNfZEcaaFzA-YWhH_y2 parent: data-mapper; artifact: data-mapper Puml Server ID: JShB3OGm303HLg20nFVjnYGM1CN6ycTfVtFSsnjfzY5jPgUqkLqHwXy0mxUU8wuyqidQ8q4IjJqCO-QBWGOtVh5qyd5AKOmW4mT6Nu2-ZiAekapH_hkcSTNa-GC0 parent: caching; artifact: caching Puml Server ID: DSRB4OKm2030LhG0m_rrWyWaE0bc-6ZxpujxsbMKUXwSrfSMCVq7OFYKAj5oJsUZIuCr2bq3fEU3WGOdthWTx59rcnZ1fWu3_GqGKXEjm47VIzeeCqV_0m00 parent: reactor; artifact: reactor Puml Server ID: DSR14OGm20NGLjO23FVj1f7Hx2Ga0nzjVxtuJc-f9YrtJM-V4vZn9NA-or5nvfQXBiEWXYAZKsrvCzZfnnUlkqOzR9qCg5jGvtX2hYmOJWfvNz9xcTdR7m00 parent: iterator; artifact: iterator Puml Server ID: FSV13OGm30NHLg00uljsOu85HeaJsTzB-yjfBwCtgrfjUKXwMovWneV8-IcduiezGxmEWnXA7PsqvSDWfvk_l1qIUjes6H2teCxnWlGDOpW9wdzAUYypU_i1 parent: callback; artifact: callback Puml Server ID: FSVB4S8m30N0Lg20M7UwUL4qYOciUFGXxSE9s-wp6sjjKgwF8tF6YyXnjxtdKMk5E5-MOjdu6jIrRYIStlXWsIJwRij4fhW53SGFn51TmIT9yZ-jVBHPGxy0 parent: repository; artifact: repository Puml Server ID: JSV13OCm30NGLM00udktCS42eyI9xE-YRjyUUtjlLQij3qblomNCU14vF-LKNBbdYDTX44EfevEsV1ZiTFERjqD2Jzic0-8Mr3b-89SvGZ7yGuBwrvBUoypUlW00 parent: mute-idiom; artifact: mute-idiom Puml Server ID: JSf13iCm20NHgxG7iDdtDjH62PKX5luarq-MtSsJvgtUHdR96AyTcEj357pLJR7dDvT4EnpYgEqmqf4NWuD-V7BfidJpCXcGy4N6wmcoX1Jj-lo2ziUQONMcZHi0 parent: prototype; artifact: prototype Puml Server ID: HSV13OCm30NGLM00udktCS62eCInxE-YRj_UUdjlRLfx7fBUbmkmU14vF-Lik7BF4AzJ8OfIvw3Mys6mqyrltWw9Tkfc38XhqE3uWSmd9Zuc9AZ_bVHHB4V_0W00 parent: step-builder; artifact: step-builder Puml Server ID: LOZ93SCm3C1MQGQmzUysYYqaAcJ5q96i7t_x8KXkh4soKvfypeZfNm33fnuSP-xfPEtI88tQhW4i-M2WmGzlB9sS3oqJ8yZKOQ0lWOLPzcJfAoZQtwXfeyuSyW80 parent: double-checked-locking; artifact: double-checked-locking Puml Server ID: TSdH4SCW203GLTe1bFzkGv1J6qGFeLc_MI1_x-wzkv94uJ1vDVUrFm26LwxTMnonsMYgitgcEQ1BNEXeyCKVfiAxLqqBtTbqmy1z0ygCGpXHOpgv99bqTgt0JW-LmqPUCUGF java-design-patterns-1.16.0/_scripts/postPumlsToServer.py000066400000000000000000000054611312550536300235360ustar00rootroot00000000000000# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # import requests, glob, re, os # taken from here: http://stackoverflow.com/a/13641746 def replace(file, pattern, subst): # Read contents from file as a single string file_handle = open(file, 'r') file_string = file_handle.read() file_handle.close() # Use RE package to allow for replacement (also allowing for (multiline) REGEX) file_string = (re.sub(pattern, subst, file_string)) # Write contents to file. # Using mode 'w' truncates the file. file_handle = open(file, 'w') file_handle.write(file_string) file_handle.close() # list of all puml files fileList = glob.glob('*/etc/*.puml') for puml in fileList: pathSplit = puml.split("/") # parent folder parent = pathSplit[0] # individual artifact/project name artifact = pathSplit[2].replace(".urm.puml", "") print "parent: " + parent + "; artifact: " + artifact # do a POST to the official plantuml hosting site with a little trick "!includeurl" and raw github content data = { 'text': "!includeurl https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/" + puml } r = requests.post('http://plantuml.com/plantuml/uml', data=data) pumlId = r.url.replace("http://plantuml.com/plantuml/uml/", "") # the only thing needed to get a png/svg/ascii from the server back print "Puml Server ID: " + pumlId # add the id so jekyll/liquid can use it if (parent == artifact): replace("./" + parent + "/README.md", "categories:", "pumlid: {}\\ncategories:".format(pumlId)) else: print "I dont want to program this, just add the following lines to the README.md file that corresponds to this puml file '" + puml + "'\npumlid: {}".format(pumlId) java-design-patterns-1.16.0/abstract-document/000077500000000000000000000000001312550536300212475ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/README.md000066400000000000000000000017051312550536300225310ustar00rootroot00000000000000--- layout: pattern title: Abstract Document folder: abstract-document permalink: /patterns/abstract-document/ pumlid: PSjB3eCm34NHhPG599vtDyQn85L-ifzX-p3lxEf8Twj3MXGDQvyJMFubChxpKN767gucSq07iinEjSNDOACVNvoAUZr6MWoe3QVE_WRnxZ0Mf38b-hkIGlurX_MyehS7 categories: Structural tags: - Java - Difficulty-Intermediate --- ## Intent Achieve flexibility of untyped languages and keep the type-safety ![alt text](./etc/abstract-document-base.png "Abstract Document Base") ![alt text](./etc/abstract-document.png "Abstract Document Traits and Domain") ## Applicability Use the Abstract Document Pattern when * there is a need to add new properties on the fly * you want a flexible way to organize domain in tree like structure * you want more loosely coupled system ## Credits * [Wikipedia: Abstract Document Pattern](https://en.wikipedia.org/wiki/Abstract_Document_Pattern) * [Martin Fowler: Dealing with properties](http://martinfowler.com/apsupp/properties.pdf)java-design-patterns-1.16.0/abstract-document/etc/000077500000000000000000000000001312550536300220225ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/etc/abstract-document-base.png000066400000000000000000000351751312550536300270720ustar00rootroot00000000000000PNG  IHDRx:DIDATxo}W/EM4MU\W1c! ΅: !D\7Cpn1:$6Qvb$N!/4&2xi$(&m!AO7~>gΜsWWsϜ=sf泿9s~AԜZM7 h C5)Nk?Ђf[hX09 Yvz @ $F<0,k0 5 fns v{_Mm˽v>vŕWAa7\3(ltnԚAa2"(,ѴDyݱm<^+e僠 kkc~$J_2ehZϵaFS=0+ =d[2vߋdvbi ʞe ".xa`;CY2Mhε܈x9צɞ;Q_bأqqDˎ m6 kzz%I3d]2 h5E̹6 &%0|O(Gm;#OSu!i\b ^%l)lwv8VvTWKmQX^+9Lc}WIP}s OSd3}߉#;\F/oZ1/O Ѵkx9|0\Aa7\CSAalP؍p0l6(F8`P6v#k0( 5<[>uom%ɒ[5(s 3D [n;#3y}卷m Qxb +|'_e?"Yyhױ]zGM(s  brd|m'qB9Ӌ(Y}f tuB#<1*LPڇ䳇Wm݉c?}չgJݖO 2ƿ|e=gxsn̹V2IO2n _Uݭ(ٴ_ß,|9t=)Ʉ lʨ0{Aa7 \+($MgQg"6:b#ˊgKx??z%;nbҥ~ntʬ@XCԡ}-3n̹V*ֱRxX'n&(L_t=d~}/{6?v蓧m}[FCA `(sT3dDbHI7&Anڻ'[_o<.;uݥe\X- Q0ZXG;'O \vO/|to6F[a/X@kbˉ3ZI7&^zKno|b]_}vK^жe\b!_wԑ Q0ZXCcNY w^~UC_, '(sLc#H}*&޴-Z=<[i5(FkulQݠw!)kP6v#k0( 5 fns aAa7¹OḓLґc8& 9wS[:QF°XxL w&qeU;uv#DK iyZg{N s9P-GY]dq{zZ^B(ic :gTޥm}?>Ȁ"X(zQBғ,L<>bJaC:Qp6Jf]fsO.f,O["m@B}ZVL[]dVG>JWHki6vo#ԍփ0nY#Ox r4K$G(z8J6CN-W.bGc^F< 7]\.5[pq?] ;T "09ۋ;FpUfEɞ#ߓٌ|R;_②mJak&ZZ:j֛6!A3 F$sSg"|5BeTrGoZp$d.xU\&JR֒ tmio ʰ$;!A34(Fx°٠\AalP؍p0l6(F8`P6v#k0( 5LU.hA-r 4S y F ;"Hx@a ;5X6v#k0( 5LaUA;F-PxB, B,Dx ܝnNs n!<9\'q:?/6=pU'\w!/*nA&v#D<0( 5 %Ht7/0(F0<&OݨE;O6}]v"r_rI!)8Ny.ռpl40J5mhHp>"AK#wqM)3(FE<ѿp'/MhN5zq QOf=S)0`֭o ] TP> LgϞ%'tC)ҙ3g3@a/f {Ǐ[5/ 8¾ ?ˇ{=~6(6o޼t+ :|ݎ@[l$J &P{֭і-[9t+ Ey|6:H{D]V^V! AHIԚ5kΜ9IزUC(ɹeqW/ H@u AgϞ_vy*_rUe 5 G䊵nh^nrB%r(¡i4^H MG.q֬Y (yzjBlx67ٱcexq ,rJ3;8w1 4+H^ٳߚ3"P8p3;|{}hƍM7{y׻wD9L)p ]AS/r6M8 ^axʝ3a/ +P0(@a pa ~5-(r W9|ݨ5!V+p4-@Pm_k ~(ţfڒR/7(@M0-ImK=9FI$ۉ%JlK0D*\f5k%w٠pku{a$R1R/#V&w[Z,d.k2(@]6&̓P:;JǞ2J=mm.b)0(@aW l)š 4+QCgji|JhfJsfQSbP8X;aW&Lw"!،#q\F/Ö#ްV̋`՗`P8X0A` ð( ^V0 {aP8X0A` OץxK +Pxze庇__~mפoڑ7۠pz|o|ێL^h pvcP8X&]W,+OD>Р<;\e =倽2(@zeD_>z_P-Ȭ J#FA)mJ* Ҧĕlu(\kZ^VW'~~-N)itYLJOK򇏓畳Jz9 V@<}>-WHK*)~^YPbw|J(fFwYml-a a-SShP8X|֫[~QQ|?]5gZyrș(X&erP\1DL|6qR:%\bBR!'IZo&\&kY6Vp/w\d S?oɋK>6߻ҥ+UH' #G%S!LUbn*ɨ'cT>Z?Y`l mYBaA` gmGLةO>+o!eUD8K_ W=PKsS|K$**42n~BqldX Jk hVd VpݼwO깟#x> wz7]՝KSVm& ttOLg%6\k_ژoHaj jѪҶ6VpO/|to:퍷FK5 kl40mBv{p"SC#y1uYPi6,z pPJ 7Ѡp}~#>ġm&_ZR$#5%NvݣźY1E38V4* u I'niwըhj!.2(@&˯p]}hK^%av ŧ^Y6ܽ#\K~D a/ +P0(@a pa a/ +P0(@wƜv\75ca ǔby" :M`AʃŤ<嘹@K[2+=͜ף>,ny=d-a y |c :M_3(@a,$d!N(ʼnV d^'FɌ7F%R#mO ղb&8gPBZKxh݈XjP8XŠƑ0i:;ӷ^GIx(El25lIca:c ~dCC^m{V@ ..& +PXHblGpKXf \ H˗k -*/ gk)k!(kqa3e1I4Q(H+9[0.%J6y\h nP8X0A` ð( ^V0 {aP8X0A` ðժU zSiZ4)B, >X8T0A` ðU ;'&/ҵ?4axF R&nЄ1(ƥp% ϔA`5ƈD:A 3eP8XMw,rOdގUI݇i((*kUkw6y~ c@ (țR%shqs N֭yZld"D\lnE=Ja>-5[AIkm~V2Iԉؖf)'鶘!bbP5'fOڠpJm)F `PTKNҘQ//$n0 HyZL b#E'S&NiހA6'3"v*:A4넒G~kTӴ")]4(R4Sy.2 XxVHaca%MץYY,ך?f{dK.0y/jDi7(F{_]VsRHe"(iҼ!n.QX[j(a@è#5(#r;-lJ{QvN0[ܲ5Cpv< F$ F$<Ǩ8qa b q]c!/;FiY^ݹ>oوM=hݝ2v (E|0W"ۘw然5 xBjb 9WSǹG%<7= `P8XΛ{J/zeG߂pDaؕA` ð( ^V0 {aP8X0A`j-^Tm)p  ðn!U0 {aP8X0A`Uƒ.oſ?(ax )dGȋJ),U?.axv +P0(*PgXir3|?\N,mυ!NIƶ2;}Eϵ4O:_y8 >Ʈx$+ޕ6()O3S2Y򴾘ݐBIYogve9X TWOs N4 @B{6H {=CR7() /CR#_6@\Hv7fypܛ;iV  8xs.6OZ)ˤ'MOY_=^,V]0'%k/Zf{Cq9 9wdwZQtwȂdwE-=lN9W  +}7^R*3 sۆXGUb &~Vk"YI W Bgl ( .%Oo mrW #~[62(@a pa a/ +P0(@a pa a/ +P0(꧰)z#yfU?N8U1o=~.}oΓc=,|oGs֌WP.aP8XPcO=}t V-S0K>_AQ* /GMUP&HSH +ƀpG<} yKJƞT;S Kjw+w|yKJG){įy*ayؘV6 g7,HZV_nЧi:M1f1ب?arzJX9l^NM-IIxooUU$nD b SS ŽV¨ 6 ̵!N G2]bi5rԲ)6jO!NfB-1 JاK{mus賆fjNnBB0VXR7zX fesmhKs̉תj\V0eЪ0aGM+nRZ$1VwH~bЉj3P[* \Zv/ /-{aƒp\Pؚ碘ڹ]/0 Ja>Y$ 7Ea&UCE7/ Fᒹ6< ׶i\$찲@VuHNaF-@ IW†tIVkr ƅM轡46 +1rARx0b ~ET(f̵wsjNQpӆ &_U:Dkk3RXJ'x)#|I(h805Ld^؇mC6Q{TcS1̠p*D כ#&)nSOMQUr;I6 b OLرq'ʒܚŨ٠p0<( ^V0 {aP8X0A` ðժU zSiZ4) 8nU&POzf?mذ&@Pe!( ' C! ƅLϟǸ0@a& C+++M*( ygϮ^V@Pe!D(e˖[A  jR0Ν;w[A ??á* C8/s5$J0֬Y@ȑ# @0/. C_!?܈;w܅^xAUvm ;7 H\LFA_}U$=( y#{۷ر@P5!f͚g{0@a'-,,c($OjyM7*S^ SiZ4)L`2 ST]0 {aP8X0A` ð( ^Vk~tQ_Qt#VkM믪% I)G}\[Шm_k wVu"^ o[GidN$dG^> [: 9z}@acĔt| i^F'lV8Jrl-I^%@ c%pE(\Ta$8yqDkIM4/7 ]DDAK 6ῄCVpe. '\SdaXO1Haba(\|X@dAFn C2R?&PX!kø[ vgzQOMHg.Fl9㈄SޝV0 {aP8X0A` ð( ^V0 {aP8X0A` O^{_>SOdI㭂ܠpowBf,!o<(|cG5YBK MȏNL. +Pؙy]݋w{̿,ggLKS q* w+ v{_yD?|esl aoDab} a³tuTtla c:0,1t$Ș=- lP8X5߻庣S~=bR&/Ph:50wζcp|ft-^@\ea#vjP8X|##m|+&%˯W(L'W(#F,gkjY#Aa($Ν|a~uFOn|dh,,QRBsO 7mP8X6{~c[ףY?}g5YB#u$L&t 3S`P8X?rGㄸ ^|ud俖HhClEe(y4 k\ 7eP8X.}n;>~R͟޶K ^xo$|N4r,̖5żr¼|We +Pر j^۞uϐ%aX3(@aK=/?C 摀V0 {aP8X0A` ð( ^V0 {aP8X0A` W츓=R,LSqfqe{sy cR7W+[Z!0(@al^6]>y'Οca ǔb$y@*E>HyFӞ+z9/ e@,no^Y+JGIm?rS? ΠpU"4%MNԑD+UDQ(p'HPYDj@B}ZVL[]dVGtnJWHki6vo" [ +PXB8XB`pu( 271H^npqXθy)]6g۞P¼&@gk(Z$ZN,L3%jN0 $5 XXMtvv M5˸2qUhuxJ͔hrValA) 2X^8M>.%.(8i3(@a pa a/ +P0(@a pa jժ ZMȩ4-Tn!aB,@a pa a/ +ܝ /sX}p pa a/ +P0(@a pa a/ ),sd$YV~X-;GYCyaC^Dmz#Rs&߆oKU1o=~.}oΓc="z<<1e:M9&puKXL2T~q]=/=)4`p /~?/G^jM-V1R^D$g%|w"%ͣNOIVލ2b/"*+֜o Y3O +ޫ,[@a@7b,6TAÝ9 #y:lnK"O[V -aA`e{]} ۟R[_,QX6 ֝#6 K~D<(J +e?K{]%dT8"gHO6fBs e+ΛLa3=qga,xDrVwwƇ>}NU؀/Q:ܝ\WHw">+KI[a;'|2K?S͵qw٠p*-O=ya(P_jUs9D&֞1~R 7()<)fQH {2 GK`~j" 0ʠpa a/ +P0(@a pa a/ +P0(꧰\)˻ b {klqy7`ؕA`U@68smhԞwV6 kC^Rm 5 Fy7`؍A`ep\9 V8ɵT vcP8X(\6-o\*ϻn +GʵaukC˂Q{ vcP8Xܝkc'n9˵% Fy7`ؑA`UK!68\e@ OA`ULa^ q6&xb̼0Πp0 ;2(@a pa a/ +P0(@a pa a/ )lF]fiu&VQ&WOh{&W^St ot-R3boTQ,V.kvjUHvoH#$ч' (\k5d3   kC6K=I|2t&3VcͤcJQK5 m9`as|o.Z "ޖR~4I6݈P3Q ym.kCC'r%ejeSlԞC>HakZbClO:$(g 5̩Vk՝܄ㅔavilo(ǧZ #6(\6׆D=ȜxeEy. _ v۴) @^Ic%q',fm6 ; oկmba ЛZزFi0()䍷Qlj(lsQLaܮB[s[X0,_op0WVur*bႡآЛZ'Pop\z k[մP.vXY_uZ+:`DBy{QvNpƅ+ aO~5I¦}Pjp7F62Ri016)i9aGM:~T=|Ja+-f;'Ѫ~0zacEO0O XF CS_La0ƒ6_oŽ8째wNa<5EVQS}$X6()<3ars G*KnRsk~fG V0 {aP8X0A` ð( ^VV]Ђ hENզiѤB0A  jR0APh{T3ݺIENDB`java-design-patterns-1.16.0/abstract-document/etc/abstract-document-base.ucls000066400000000000000000000074551312550536300272540ustar00rootroot00000000000000 java-design-patterns-1.16.0/abstract-document/etc/abstract-document.png000066400000000000000000000405101312550536300261470ustar00rootroot00000000000000PNG  IHDR_РAIDATxm%W}@4Rz,/KFK6=(bD/~?KOCoǦ܇ >q r!9۴;0ҷ/H~?[83 i+wBwTF* Uܶs@qRQSp~;0Ol\踞x/IYۗ+OTۏ~8IwpT|bcw;N0N_&¹2QX9tkVo~ϼo?;y}w>xIWcCQ&IHKۺOqRIF"*̡;5/^/yPprϵo<}N-I_{g5i:YYCqrBEI8DCX9tGi>|vE^?W{W }[V}G񂘥X&85!΋"$ھPqG`z'>|Њ+?ז|d^kԀU;NC"c3qG`__߱~=dCߪwVSFoC+\w.F~Ga@{D8?UCw5|~GtG_o=xW:*ք+rAJI|6'H("7HsCXtǝ06ҝ\v z_Y53⎓%"# s;ݭwy߁{~%g!'ND؜# pT qG`pGw;;Œ#4HXfA*0# wVwqGh# qGLsc8B ݨ*CwD~d@;ּKQ-ax,0'HI!UrthhgtH z:{5KK Rr2});ʭ.vO9dS,IrJQ)`d&+mr>⁡ "U)2V$ 5ޓ ҦnOnO=JP8ׅCxwV;_*Av4̓Z n$|Wiki; ?`m*ZmUhϞŝDijb1M|wI<*7Dwdi;H.W ³# ?8;3Ùsɴ]V[H ݱL q* w/}#/rJ&XqBc:o;lv:ՑP³HxqG`'3K􉆋ΏBn'swx'ҁ&KO4Q VB<q+ Lj{?^%*e7/f1L8D-^6Dxϸ(;w];U4Au-,R: 5|/ r 5"5p8nሻq|TO2SR BVhan`z;q+$<hrvs&3W=ARYEIjQ"N14 RY#~d<75y-tFӺcC"< g\~1ǜ욕魭$Hf]&\}U >HU4[cʯ3.?htguZw@b"rV\15YhP Us刪\+/EW4-tFUGPYrM3.?hVΐ5dm6#2fT?R^&b^9N"?U$T ³Hx@#|1k:TnRy1OY#Ť/:&/?ׄ| +ƌT;Of!X[eqDxK2-aZEXfA*0# wVwqGh# #̈;BUgϫ; "@42u]0aÅ Mb*KΙ@{;fP.]ڳg|Ksyhjsrpʕ2&.^xX9h!pA:^{u1onnJɉNCwUW(?Npݾ;rJQ2u̽E~Q=ʂ0c|ꣅXʊ Ɔtm@{o߾ǏDD[&  OK1m2h︺jwl;#m@KKKKfiЉvwО 8p.J)υ LZ@DAnmm`G.\˘^b`\h!Mipo>/vi?#A񾼼6Y{9K(plHzd;fؐb"?iqKL\h3f P!P" E0K0U:`73r Aܻwo<7P `lxQޮLE[P '( 8c1-&0&KKKL(pX]]N$oQ;pQD#GӃp…qAsh`eeegcc#4`%C}DF0cTa{{ @f 6h ˘p}\]]x"2*0yFd H&3rON8g^l!P챵@ 1O}">|X3{wWuvP lllݻA\hGM=rwA T @4فߤ L!csstA-3.tQ9tY6Q`wTΧ>+++}-J FN$E -lomm߿߶-Ѡ-$ L vp•a677[؉ڌVt:طoN cwbnn{ӥZ@Wp'0qkePNg3]0ǃPb{{۶`h;֌&+WhKgHve:^'0 KD{hkimwTrJ=|p_+++N?[]]-5n0 W+/w] mwǣG'\ZZ2R]Bڶ͊#yzrkk+m_xq߾}rzts4eᒶ>@ mwGFiJB qɲyD~:pJYvqNyR`K WS* ѷ݁5rȑ'N,ҴCs`]tI΀P` }tW@ 1xlx\__>8$uW=w\WP`0O ZA磌JJB9Ń[yR w RSN@}XM;P-V` 1 e{Y+++n Y~ܨkkkKqaaa*KVmvb\|Y"|{Gʿv_W,aw=q1ʑjٳn=qWPr;[#[=+ѣJTWZ]@ڜw ; |AcWM[}''岜nbsw}7GP`E풟=Xͤc&y&>RN{g}:eDT>U%PDb80@[Q%sH`ƉAPO4ND wzq"Bh#ԓB&h$$0AD ]uo/~`ћ'eY/<ԄpDCG'O}Kp瑧WZDY5xD&"' *sGg/{pcߋ(˲Fd~W_'b(OYW{Fc 5>XW Lb[QcFVQ:?Ϸ\y oR5|/4YLt `'8MX+arMQspN)0CtOx='' 5SxRZqg#F}G?P D6ҽSg-x:2i+SL>s%r3WV~tX,CE)ӕZMDh9dnR:掷|[GҞw]oٸϫURLcCFR NTWrɥLXkgL1VZz>qr(J--QZC}Ʒ=0cߕHf-r՜3׌mտwLPkcAP&tXz'"7?C#ܱ$Bg@}R:՗n/zJ{n{,k|t-yYB,9(w3;:BDXEKXC;j2_~6nVןcwZ*j7 (qc%F|+`pTw>ъDN+PC;3p߼ *CA%|S+0#?)5tnśd\Ϊ;kA`H#cQCN)PC1qx6b>sK;Fm;vKK%Y LCMDXO8U:;肟Zޟ/_y{ .8YNp(Q;iB&h$$0AD qG' '";B= L8!4HI`ƉAN^4ۘ~ct*CꘟwIC ܙ]҂8;Xi'Q-2*:2I`j*vqDǤ1ӱE%:z0AlvSRaQI>񨤒an`6eG$bnGS6ͧ8 zVaOEDD%eKgG[TU+5eK$hP`hQ`i$0=8td<W*C~yA{@q:$i5և%IUpJ%4Yisi>dS۪ ʖV4V6٪ʠeg`B-UE"DTpw,l{ODe?5 L> HG-6I:X *dnJO[q>Kg*N{p*S>7wIO%eԗ:t秪ʬ L( G( =W7+#]#hl0חQNJRTFe!Fm7E[D wDTE"DT`wWFUm^I{^>7>o@!r}͊\βM ߯s/lO\sjKuaܵ{ў@WRVP&[H{l-!4HI`ƉAPO4ND wzq"Bh#ԓB&hyuA *?0cf;4MD ÝU% '";B= L8!4HI`ƉAݑ'Ҁ"q B`lAv $0AD qG' '";B= L8!4HI`ƉAPO4ND wzq"BhqDx!n&9JnQaVV#]&1FӀ5ۚt\,7h28!y49' nd0L&q~[_eYdeWb7Ne!/~/J1tU\u(94*0B- L_r%j =4$74wtP23sfyM#?Cg^|@&Y< 6xDyމ~a?2LTpRweSS$5/RFԫ̫9(*b˷4R) ˯Q@aQaz~Rnѕ1cX~"lXY u9~\ꚸTZXae\a Jj$UǜrՕ*/X71N.2w;6~qg䧬'jhO4sk -:6N[&[m"Tps sqASAM4+o/d68I{RѽK3ƌkjPE}Nd[⎝B\Hx;-CDiF 25h \.U88_ywyម=SV撕Or[ic*{lxdQEIr3AHTxlY*gTTgGQ/ FКU{KS<ˠtnLe3_+4{5^Bmڬd۰ Rw̟U'?-0J*g̚ǜrkJUt51N.2wí܇BSVWF!JTGtGmC%RLiU}ǝr!wwT~CޫۑTd 65e\a'pwsWQyA1ѕ㡳ͧ9y>}R^_d wdvgux ~UC˩-UU _;:wtr(邀ɀq@'i.\qA'Q..㼂q>A'En.|qA'-.܃qA'!N.cK Љtp5t"h32 \Bԉ6]h-|ߧ6p5Q'B_^^^>p]ƶm666LWc{wQ^|tYp5t"h 2Љqe)A:6w4 @W#@',pGSj9Љ42-t"w12p5=D,Aԃ!D.H+;S\ZZ@:& E2nnn.\ 5S4螺/. p\)xa(<΀:8 eに :S8qec :8AeW#t"' qRvF[ЉTc߾} 2Iw 'Uf[AL#j:W\9_1iRhUcE2wDԉ\ZZ*KMZݻ._YY&Ljx}$=ztuull X I;k/\iǏӒN׏vd9 m`']{atN ,Yޖ3&e L #"رҥKh髐~:M{FNvFhF=E.#g L#")q\MzEk\汹WbeetAC?S?u5*D` طu5s;,\~Bh9;,9';BqGwA9 B'; jI:A]PsNw s98L15i[n2>'qGwA9 q֜;6R%3!.9';NA,˯Qek 5EIn֔|ӵ_ˡk.; jI}o`uδi|Q{3IIXmL; jIfsfsJo  *4iBu>jRw,%o-|nw'IY5K-'.9';Θ|[bwyzEeY#덗 L]PsNw%o{ǟ}x}/,Y3c'VQN83?r'/V;}Ӈ KeA#".9';Ό_?~ߌןDk>L8}QJcGη|FNSֿ-\8}+RQI,SeUm.42qwtԜgF._Ȼ}컲㻯}xh1^9˜;O;&.9';Ό՗n/zɲ~ѵU;ʹw837mg*?5w,VZzX1ݰ𨲙;ծMwtԜgɍO~k?ww#/<']o{aﬦǓ}t}e^r,SG%.9';Θb7s}ءs $kra8{~}jGz|.0*J]PsNw s#NwtԜ!t5$pG .9';BqGwA9 q{np5lPCw7jbqq3sT8;y͕8dwf[L?Cw Xb:o4Z3C$=?q-?wLL+t'H)اanL8eG$b`rqO%4Xt!#[?;ؚ-9ɠuu5$p"~pr4dzaS'CU({"~yy@]$TX$WȪ"m Ji!||/p*r[Q{%(;VwtԜ ,)E)P44jw ktrx57N+D i7'yi>=(AT\dh%O; jIEN=Wwc Cz.k7J-KXNKRtCw*lʼn⩸c5qGwA9 ܱ̤SQyJm)N1S7ϋ҇ &><i!1*} 5[u*eCܱU>q͉J ^g6/ۈ; jI:A]PsNw s#NwtԜ!t5$pG .9'gϫ;!h$:!t΂s#NwtԜ!t5$x+'[9wt}GgA9 B'; jI:A]PsNw s#NwtԜ!t5$k^ 9/v[K?|Mʘw*!lBJ9c 6L!5$~[_eYV-A#NOWv̜]^b_0pqlw#wtԜqǷ7?=݇μ,b3z^We."_P|"wZx+Gyc%{i%Mraaqu_tVN(to(;w1sYVlL]PsN}! ~#~1If~{W5+xp5$qGw[(GvkݐNĮB8+s#NwtԜ!t5$pG .9';BqGwA9 B'; jI:A]PsNb|> @#MMT}_5\8c)wtԜwcF1 ـɨoǥf 5$j͏{O}3/> S, N;F!2.秣{=+<>xlVcH;"D;Տݰy&<#?ee>Yiҩ<9.:y*? sʐu3!WfU62*#4A]PsN_ywyម=SV撕Dy>dh0|?oG9sNJʯ;jgF]PsN_s >~s yLOYKu¬C1`Οv&5wVܱ5k >qGwA9*wҏwn'F]PsNbw!qGwA9 B'; jI:A]PsNw s#NwtԜ!t5$pG .9'1aw>tfC (Sj$cl:1).[ҕk N%o܇󐯬ڑ*ix6&ȦwtԜwcF6Ly6'5 U,&#upǩaw8hc Nl qGwA9w|g?xS}̋ȂU{'&|qigCWԚJEjiqy5$~ͣ_~0)+ɲٝ0!"*} 3^la$5Bt.M3 V>@'qhݱ2C儨6${~ z?kq/T[tS>JhorXK1wtJ-Z{;fHD^]eVMTUceLXlZs  jIT㡳ͧ9y>}R^_dMI;ѕܱ|WP,66iﬖctYeRsg{ѻ9;F:8z5S=o5oTY-N๣l=UXEsjITM#~O] ?5ɲ;K'a:wbXj)SruN'5Q>{zU< ^6 )'-sPVSՒ(ڨz+'":oqGW0ʉPs, ^-lh=XmÈ; jIԸsE_tBkx$_tLSB'ayPQGow; jIԻ]ˤu[ 9#wy:ah匴)?es.#-$.9';BqGwA9 B'; jI:A]PsNw s{r`L@#PH$n"IENDB`java-design-patterns-1.16.0/abstract-document/etc/abstract-document.ucls000066400000000000000000000134471312550536300263420ustar00rootroot00000000000000 java-design-patterns-1.16.0/abstract-document/etc/abstract-document.urm.puml000066400000000000000000000027521312550536300271500ustar00rootroot00000000000000@startuml package com.iluwatar.abstractdocument.domain { class Car { + Car(properties : Map) } interface HasModel { + PROPERTY : String {static} + getModel() : Optional } interface HasParts { + PROPERTY : String {static} + getParts() : Stream } interface HasPrice { + PROPERTY : String {static} + getPrice() : Optional } interface HasType { + PROPERTY : String {static} + getType() : Optional } class Part { + Part(properties : Map) } } package com.iluwatar.abstractdocument { abstract class AbstractDocument { - properties : Map # AbstractDocument(properties : Map) + children(key : String, constructor : Function, T>) : Stream + get(key : String) : Object + put(key : String, value : Object) + toString() : String } class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } interface Document { + children(String, Function, T>) : Stream {abstract} + get(String) : Object {abstract} + put(String, Object) {abstract} } } AbstractDocument ..|> Document Car ..|> HasModel Car ..|> HasPrice Car ..|> HasParts Car --|> AbstractDocument HasModel --|> Document HasParts --|> Document HasPrice --|> Document HasType --|> Document Part ..|> HasType Part ..|> HasModel Part ..|> HasPrice Part --|> AbstractDocument @endumljava-design-patterns-1.16.0/abstract-document/pom.xml000066400000000000000000000035011312550536300225630ustar00rootroot00000000000000 4.0.0 java-design-patterns com.iluwatar 1.16.0 abstract-document junit junit test java-design-patterns-1.16.0/abstract-document/src/000077500000000000000000000000001312550536300220365ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/000077500000000000000000000000001312550536300227625ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/000077500000000000000000000000001312550536300237035ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/000077500000000000000000000000001312550536300244615ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300263115ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/000077500000000000000000000000001312550536300316535ustar00rootroot00000000000000AbstractDocument.java000066400000000000000000000050331312550536300357020ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument; import java.util.List; import java.util.Map; import java.util.Objects; import java.util.Optional; import java.util.function.Function; import java.util.stream.Stream; /** * Abstract implementation of Document interface */ public abstract class AbstractDocument implements Document { private final Map properties; protected AbstractDocument(Map properties) { Objects.requireNonNull(properties, "properties map is required"); this.properties = properties; } @Override public Void put(String key, Object value) { properties.put(key, value); return null; } @Override public Object get(String key) { return properties.get(key); } @Override public Stream children(String key, Function, T> constructor) { Optional>> any = Stream.of(get(key)).filter(el -> el != null) .map(el -> (List>) el).findAny(); return any.isPresent() ? any.get().stream().map(constructor) : Stream.empty(); } @Override public String toString() { StringBuilder builder = new StringBuilder(); builder.append(getClass().getName()).append("["); properties.entrySet() .forEach(e -> builder.append("[").append(e.getKey()).append(" : ").append(e.getValue()).append("]")); builder.append("]"); return builder.toString(); } } java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java000066400000000000000000000064541312550536300332470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument; import com.iluwatar.abstractdocument.domain.Car; import com.iluwatar.abstractdocument.domain.HasModel; import com.iluwatar.abstractdocument.domain.HasParts; import com.iluwatar.abstractdocument.domain.HasPrice; import com.iluwatar.abstractdocument.domain.HasType; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Arrays; import java.util.HashMap; import java.util.Map; /** * The Abstract Document pattern enables handling additional, non-static * properties. This pattern uses concept of traits to enable type safety and * separate properties of different classes into set of interfaces. *

*

* In Abstract Document pattern,({@link AbstractDocument}) fully implements * {@link Document}) interface. Traits are then defined to enable access to * properties in usual, static way. */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Executes the App */ public App() { LOGGER.info("Constructing parts and car"); Map carProperties = new HashMap<>(); carProperties.put(HasModel.PROPERTY, "300SL"); carProperties.put(HasPrice.PROPERTY, 10000L); Map wheelProperties = new HashMap<>(); wheelProperties.put(HasType.PROPERTY, "wheel"); wheelProperties.put(HasModel.PROPERTY, "15C"); wheelProperties.put(HasPrice.PROPERTY, 100L); Map doorProperties = new HashMap<>(); doorProperties.put(HasType.PROPERTY, "door"); doorProperties.put(HasModel.PROPERTY, "Lambo"); doorProperties.put(HasPrice.PROPERTY, 300L); carProperties.put(HasParts.PROPERTY, Arrays.asList(wheelProperties, doorProperties)); Car car = new Car(carProperties); LOGGER.info("Here is our car:"); LOGGER.info("-> model: {}", car.getModel().get()); LOGGER.info("-> price: {}", car.getPrice().get()); LOGGER.info("-> parts: "); car.getParts().forEach(p -> LOGGER.info("\t{}/{}/{}", p.getType().get(), p.getModel().get(), p.getPrice().get())); } /** * Program entry point * * @param args command line args */ public static void main(String[] args) { new App(); } } Document.java000066400000000000000000000035701312550536300342220ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument; import java.util.Map; import java.util.function.Function; import java.util.stream.Stream; /** * Document interface */ public interface Document { /** * Puts the value related to the key * * @param key element key * @param value element value * @return Void */ Void put(String key, Object value); /** * Gets the value for the key * * @param key element key * @return value or null */ Object get(String key); /** * Gets the stream of child documents * * @param key element key * @param constructor constructor of child class * @return child documents */ Stream children(String key, Function, T> constructor); } java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/000077500000000000000000000000001312550536300331225ustar00rootroot00000000000000Car.java000066400000000000000000000026731312550536300344230ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument.domain; import java.util.Map; import com.iluwatar.abstractdocument.AbstractDocument; /** * Car entity */ public class Car extends AbstractDocument implements HasModel, HasPrice, HasParts { public Car(Map properties) { super(properties); } } HasModel.java000066400000000000000000000027631312550536300354120ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument.domain; import java.util.Optional; import com.iluwatar.abstractdocument.Document; /** * HasModel trait for static access to 'model' property */ public interface HasModel extends Document { String PROPERTY = "model"; default Optional getModel() { return Optional.ofNullable((String) get(PROPERTY)); } } HasParts.java000066400000000000000000000027461312550536300354440ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument.domain; import java.util.stream.Stream; import com.iluwatar.abstractdocument.Document; /** * HasParts trait for static access to 'parts' property */ public interface HasParts extends Document { String PROPERTY = "parts"; default Stream getParts() { return children(PROPERTY, Part::new); } } HasPrice.java000066400000000000000000000027631312550536300354140ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument.domain; import java.util.Optional; import com.iluwatar.abstractdocument.Document; /** * HasPrice trait for static access to 'price' property */ public interface HasPrice extends Document { String PROPERTY = "price"; default Optional getPrice() { return Optional.ofNullable((Number) get(PROPERTY)); } } HasType.java000066400000000000000000000027561312550536300352750ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument.domain; import com.iluwatar.abstractdocument.Document; import java.util.Optional; /** * HasType trait for static access to 'type' property */ public interface HasType extends Document { String PROPERTY = "type"; default Optional getType() { return Optional.ofNullable((String) get(PROPERTY)); } } Part.java000066400000000000000000000026751312550536300346260ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument.domain; import java.util.Map; import com.iluwatar.abstractdocument.AbstractDocument; /** * Part entity */ public class Part extends AbstractDocument implements HasType, HasModel, HasPrice { public Part(Map properties) { super(properties); } } java-design-patterns-1.16.0/abstract-document/src/test/000077500000000000000000000000001312550536300230155ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/000077500000000000000000000000001312550536300237365ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/com/000077500000000000000000000000001312550536300245145ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300263445ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/com/iluwatar/abstractdocument/000077500000000000000000000000001312550536300317065ustar00rootroot00000000000000AbstractDocumentTest.java000066400000000000000000000057041312550536300366020ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/com/iluwatar/abstractdocument/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument; import org.junit.Test; import java.util.Arrays; import java.util.HashMap; import java.util.List; import java.util.Map; import java.util.stream.Stream; import static junit.framework.TestCase.assertEquals; import static junit.framework.TestCase.assertNotNull; /** * AbstractDocument test class */ public class AbstractDocumentTest { private static final String KEY = "key"; private static final String VALUE = "value"; private class DocumentImplementation extends AbstractDocument { DocumentImplementation(Map properties) { super(properties); } } private DocumentImplementation document = new DocumentImplementation(new HashMap<>()); @Test public void shouldPutAndGetValue() { document.put(KEY, VALUE); assertEquals(VALUE, document.get(KEY)); } @Test public void shouldRetrieveChildren() { Map child1 = new HashMap<>(); Map child2 = new HashMap<>(); List> children = Arrays.asList(child1, child2); document.put(KEY, children); Stream childrenStream = document.children(KEY, DocumentImplementation::new); assertNotNull(children); assertEquals(2, childrenStream.count()); } @Test public void shouldRetrieveEmptyStreamForNonExistingChildren() { Stream children = document.children(KEY, DocumentImplementation::new); assertNotNull(children); assertEquals(0, children.count()); } @Test public void shouldIncludePropsInToString() { Map props = new HashMap<>(); props.put(KEY, VALUE); DocumentImplementation document = new DocumentImplementation(props); assertNotNull(document.toString().contains(KEY)); assertNotNull(document.toString().contains(VALUE)); } } AppTest.java000066400000000000000000000025161312550536300340560ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/com/iluwatar/abstractdocument/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument; import org.junit.Test; /** * Simple App test */ public class AppTest { @Test public void shouldExecuteAppWithoutException() { App.main(null); } } DomainTest.java000066400000000000000000000057331312550536300345510ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-document/src/test/java/com/iluwatar/abstractdocument/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractdocument; import com.iluwatar.abstractdocument.domain.Car; import com.iluwatar.abstractdocument.domain.HasModel; import com.iluwatar.abstractdocument.domain.HasParts; import com.iluwatar.abstractdocument.domain.HasPrice; import com.iluwatar.abstractdocument.domain.HasType; import com.iluwatar.abstractdocument.domain.Part; import org.junit.Test; import java.util.Arrays; import java.util.HashMap; import java.util.Map; import static junit.framework.TestCase.assertEquals; /** * Test for Part and Car */ public class DomainTest { private static final String TEST_PART_TYPE = "test-part-type"; private static final String TEST_PART_MODEL = "test-part-model"; private static final long TEST_PART_PRICE = 0L; private static final String TEST_CAR_MODEL = "test-car-model"; private static final long TEST_CAR_PRICE = 1L; @Test public void shouldConstructPart() { Map partProperties = new HashMap<>(); partProperties.put(HasType.PROPERTY, TEST_PART_TYPE); partProperties.put(HasModel.PROPERTY, TEST_PART_MODEL); partProperties.put(HasPrice.PROPERTY, TEST_PART_PRICE); Part part = new Part(partProperties); assertEquals(TEST_PART_TYPE, part.getType().get()); assertEquals(TEST_PART_MODEL, part.getModel().get()); assertEquals(TEST_PART_PRICE, part.getPrice().get()); } @Test public void shouldConstructCar() { Map carProperties = new HashMap<>(); carProperties.put(HasModel.PROPERTY, TEST_CAR_MODEL); carProperties.put(HasPrice.PROPERTY, TEST_CAR_PRICE); carProperties.put(HasParts.PROPERTY, Arrays.asList(new HashMap<>(), new HashMap<>())); Car car = new Car(carProperties); assertEquals(TEST_CAR_MODEL, car.getModel().get()); assertEquals(TEST_CAR_PRICE, car.getPrice().get()); assertEquals(2, car.getParts().count()); } } java-design-patterns-1.16.0/abstract-factory/000077500000000000000000000000001312550536300211005ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/.gitignore000066400000000000000000000000111312550536300230600ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/abstract-factory/README.md000066400000000000000000000043511312550536300223620ustar00rootroot00000000000000--- layout: pattern title: Abstract Factory folder: abstract-factory permalink: /patterns/abstract-factory/ pumlid: PSZB3OD034NHLa81Czwd6sCC39gVxEUWT1_ssLmTtQLqgR5fM7sTmFGtaV6TZu8prd0r6HtQaMKqAZLk1XjT_E6qgPUZfyc0MdTgx0-8LuUn8ErFXdr98NypXxKyezKV categories: Creational tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Also known as Kit ## Intent Provide an interface for creating families of related or dependent objects without specifying their concrete classes. ![alt text](./etc/abstract-factory_1.png "Abstract Factory") ## Applicability Use the Abstract Factory pattern when * a system should be independent of how its products are created, composed and represented * a system should be configured with one of multiple families of products * a family of related product objects is designed to be used together, and you need to enforce this constraint * you want to provide a class library of products, and you want to reveal just their interfaces, not their implementations * the lifetime of the dependency is conceptually shorter than the lifetime of the consumer. * you need a run-time value to construct a particular dependency * you want to decide which product to call from a family at runtime. * you need to supply one or more parameters only known at run-time before you can resolve a dependency. ## Use Cases: * Selecting to call the appropriate implementation of FileSystemAcmeService or DatabaseAcmeService or NetworkAcmeService at runtime. * Unit test case writing becomes much easier ## Consequences: * Dependency injection in java hides the service class dependencies that can lead to runtime errors that would have been caught at compile time. ## Real world examples * [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html) * [javax.xml.transform.TransformerFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/transform/TransformerFactory.html#newInstance--) * [javax.xml.xpath.XPathFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/xpath/XPathFactory.html#newInstance--) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/abstract-factory/etc/000077500000000000000000000000001312550536300216535ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/etc/abstract-factory.png000066400000000000000000000522141312550536300256350ustar00rootroot00000000000000PNG  IHDR*8J}Y+3 lZZd4pC2^zW-b)n][HʑQŠƷ[ka-ZX k9a- f`> `XMk[~޳r*}4m- l\+NSeFF QL4-ZX ka-m- f`^ 3Z-XSY=D{4\ b?QN3^W.Yldf} ZX ka-갵0sf̨jZL)1j;~<{q^ϛz!ap#YWtlZX ka-mka0f̜jZ)&yD`itZ'3mES#Y}e`-ZX ka-''a0 ki-k|qpJ5Hs+V6̫\ldȲnu-ZX ka-3&lrZO$7rOJt=4?ܒL#,2uKO+% I̤i| ZX ka-eZ a kaeq 5*iB&a-IX l4 k!MIX iB&a-Ԃ$4"P&a-IX iBP fH$O>@A&a-IX iB-!MZH(?(iB&a-IX l4 k!MIX iB&a-Ԃ$4"P&a-IX iBP fH${O?gv~moï>&rC~ jA~ZB)aP8qi-vZ=Yh3M kb'=tۿ&vo/~o{o?sG M:a/xv} yUj^cTg~7kU++ZqԭFsqf-Gފ겵| f̪[A7乵/C}'5r=@6[U[t'*n<6!ILgkL=ֳs矸|gm!1͇?vSxc5'tPݩR2KvgvdaU &*Pstvef^Y1տA1p[z^C;~Z5ln3NtlUpO˽JhڊӔLmf̪?Lڏ7Ǧ')l-z7ˏ ?gh_yg\}ѽ?Z}7<*)Oiڲu=߼ Zݙka07 f0kZXkMZIqE.O&s@I-s#_ŻP#[<\x 3-bygQ 2o o5ZX ka-Y 9j0l3Z-X4Yz'FfkwꩶQ&n@9&O+k|٪664c#}_[ka-ZX kd- s`X k`-z?}OʍQ1\?r . eRDf%϶m$[8;h4;Z(X ka-ZXK0f9a-ՂfSܒK.uiq'*^xYpI=WWdX4}z 8f,Rzқ4PZX ka-Fka07 f0kZXk5今^VÝ:Θ8 }K-'fg]ʕJ Χ5.]]v[+Y؀yQ gn]`-ZX ka-`>a0 V ֪(?jvT˦@AB&a-IX iUBa3H0IY;0K;($4 k!MZH  "&n-O@A&a-IX iB-!MZH(?(iB&a-IX l4 k!MIX iB&a-Ԃ$4"P&a-IX iBP fH$uȑ]5&X}hk&hkA `3M֢/QFz&a-IX iB-!MZHz\|IX iB&a-Ԃ$4"P&a-IX iBP fH$O>@A&a-IX iB-!MZH'6L4@X 4@X Z&h[lGX iB&a-Ԃ$4w@A&a-IX iB-!MZH(?(iB&a-IX l4 k!MZt3;_K͢ Ʞ$4 k!MZa3IX iҢ姓p_/o͢N ꢰ$4 k!MZa3IX iR3'0 ꖰ$4 k!MZa3IX ihxJk2px+LF7FY[ %ie Ý vd 6e_8RW5Wj7}d |RO]:UtfkZ]Ԋ5- GugWqZEW5S+fsf5"hkZ+ԂgMz2}*]I_!㽛L3_8M: 5#_<ա@wEkFfӬZkM<~w>ZplUkNDWG4]4誵mK-y7ajy+xZpű0F)?=}=ڪ8,k@$Kv"U׎IA'Y(SfAEЙw"fZMVfŎ}I uZ fӯZhjIr"sUkYZ0C6lQLPNqC]֢ga67};{Rræ˸`GܤxOU': G_]~/vFvJMk%%$1_徻fZMְz3 ŷ]m@Zj7H̆Oh@uff+{MU'YklXʏL1?L}&?Ҥߏu'e_e‡(i)L_碫ֲ*06+)hƐx躺j k?ι/dS~Kɭ: _2EModad遢 )c65gjMG?fivGb'YklXʌ,j'_j]U՟ròd{誵lK-J2{osp uuZ &fkZO~'DωlSŗA4*'U2J/7{g`-_̆IϛRY1S@A&a-IX iB-!MZHLv^J_ KWRKӁL k-CRXkrZ*zlޘ)Ιm7i^ay6>֪)mƗIaw(R|i ;ˆ ^X 0@Z k-,ZXXKZAͲҒ7e۵&a-eduf|9Z/ZuOzC*KÑjFuTq _PKl.VւZeꪵL.:gɺeL[lvmIX kc-Y]_ k-(UO|ǯ W//3HUN$۷䗄ܼee0dwpNdXdb-Mwp0Hfl%@ZX ka-tkU,;юb=;ٶ )Ε RPn].vֲZ_|9b-{_uY# ,;zٍ@NZFPh{eZX ka-{Ukvx;{y]Z{*9[\jKmҌs#y. UŮ-7 ka-r̵ 34+Z^{wG ΋bd^;y5 m]{ ֨{eZX ka-{Uk)O;orr[MkMZX&k`3s-Y ka5W}O+^{=~,s2oZ {eZX ka-{Qk{Ow|9uˑ OfwjuSrֲZ،/G:ŷ7/|xp{U,ʢ" Tk[K}UvZbzWZX ka-QWUEE7yJUXWS|evmIX kd-lƗclZ-Xk[|oK³*\TYbֲZN،/\KZ-XkJhYo%%@[Xkւ;k k-CV2mf,֒j/Z PU&'OʎvO{ɶ%v@Yxb-;kޡXK-eZa-+債daYŗZ PbϺ(vF[DzX%eZPZ|b-j߮ k)% ͵r]Xkr4 k!MZH$Z6C&Q~Q $4 k!MZHjA iBDG(H$4 k!MZa3IX itȇz.b>X 4@i8yCef|9 ] Zvwwܹc޽{W^5 K!,r5գˠ͠q8B~i… ~t+ ٳgMRH- !\35񳜳ohZ Kpe!wiȽ{M2\zݻ[`)Z.aK`Ywn5 &gh@V wY]Z!@$&vavcT}͇xmU =F N=]/^cyFdm k5F$|[;B7vΞ=n0dӻ`H-K ܣF7};{="!W 8JB;ο{>Rp^#3^X_dT5YluH; 42>{O#=So5WZn[,{{{W\1 O~Bjr_ykojA|?krpppQ VH-OF(?D8 ] %a 4 )ݰ}ۢZ'O@7la#_888rV8۷]H-MZ@mQ~B-?pܥ B~.8~8I RK?P#p[P wi._& ۦ["MYH!{5<+}Z`HtZuE+8jB~޽{0@=l3J0}ʝa7Ohk7 A "OXQ~/È49z(w>kӭpRAH-ߨ<}=ڪ{;c lւ/^cn4j-op w2υ Mܹs #|k*˒s戨[_džg[I"d-BsMþ!g8B2(/?9%O''A|2Hӛd:}(*̘/QZQ<<|E.'i WO\ `-euj|-Cj-'e5?ι/d+t]<떧,+\y"Y|֭F&+*2}ar=STXZn[Y8Z,SNqzܽ{ѣ @ːZ!FW}O+^4#r@>ۗkّt^[TC=\ޔPPt6źrZ qWm8ħΝ;[I@Z!Fŷ7/|xp{ULVEED 1jy?L)OaXZn[Y8 ]@~Eyib ^Cj 3e5~߹xgŀxYFuP r͒ӹTsn9}<Ι;LAXZn[ p5/wYe'Osq=ӭRk.ݻw1R[*jBx͇xmU Q>,sMǓnu嶵,]sqm_vq .nEgQr)ӭRk.H-ϩ8N{(M䬼,Oq\pe@Y#H,)ixx|R~SZ(?@w!lduu5ӭ3gp=K fj%]!Q/7@(?'Ϭ%r5wYe#;;;'N0 =vؽ{L7ƐZS!gZ'8k8R޽k V#>XU \'Ԃ(?A]pe'䗽A@wA%D ZeZBmQ~B-$pU]B~˅ VXݻw9BBH-%$9ؿX tcf`w)f(?˽{\9vwwMZJH-#pA8RqP~d t R sҥSNn˰,. l… kkk[a"XL7 H-Le_`w%pe?lG|~?NI[ " ~HR qW]C lY^j/NwM ]CyށcGnAjZ6 ĉ[kkk.]2 HḋN@ܾ}G;v>"8⸫P~ {{{` L2 rʝ;wL݅ Lpe0O]B|spVٳgْqX.{QzsBj  W]`9:nE{poKCj%xuJ6 p6C ԩSۦ[U cL: q'Onv%3Z`>d&<;@W S'9q___:[@j]`':&hgoo{[8ՍQ޽{gΜ1 N(?uq(c J܃tVtUӭ ,SWrѽ= iWp2oZ`"vwwMKs98 aD8{|mmX873݊%<qt R z%ӭ ~ӭ S988o6ݐfnCj /wʙ3gw pVAO3??~|{{t+@/@;8vuӭP~p0@jtqV Dܽ{wmmt+2pu(?9™3g:}Y8ʹsV@{Z`K.$%L.O;J;uꔅ)\|*G9^Aj {?A`giBq4Oi.OpppE!r̙'N?~\BmWq(s-}Z` c~ŀ8;ycĉv2(<]`b4%#N0ݨ "Jql'G 9u׿uB3~I7O*Pk׮-pfĉIa;hpҥۤhɟ|Ͷ @j ܸqC9s #ݦqV8P~r >M5Ijaw'?] CjqrOSJ~~we/{qΓ\|H(\zW6 _mȑ#7}8 S9yZ/]f{?Xbx#!8{ԩj"GDp@ܾ}ĉe,Y^^nEVr_R SD~_|cq>q'888Id{"ĿN<@jq*о: <.Op޽USZ~K>gΜ.DމAjq*Hߤ6!.ON~2s` Ѷȵ5Om EH-02?nI@]`O!>'NoiwǎppppmMZ`bYy!8 R^ I9w(?9˽{aW1#?~^[[я~'O4p`' w.\8s"8qoqq'Y___]]Oo& 3hOvw ' 7|Sn.{җt"g86>W\G>?f?ǎS>J@ 7]|c1"8֠T"i4 66 6$X=(?DxrU "=H-Ejې`n[&"P=H-Ej{Zn! VZME{Zn nC-l(n@ Aj-R ܆s[$X=j5!PAj-R ܃r[ Hzjb>PFJ`҂yMpRBZ", -l(kk[̇""P=HrZ6Bj\$j-Pv aTÂuEl|"P=H]@Z55H-m`55HV@ٚtB,VK˟[Kle?q)KpNLrZ4A'SRUL,SxR]H0 jdDed(#&(RX KG}c"P&9ML>oD\KGaJ2kG-"Ejt"l4(evJTO}IX DP ?!ᖔG;u%,+:Oe{$@jZ݂" FAZM jE H-pRmZ6$"V pRmZ"mH0EՃVm("=H-Ejې`n[&"P=H-Ej{Zn! VZME{Zn nC-l(n@ Aj-R ܆s[$X=j5!PAj-R ܃r[ Hzjb{m{tc:İcU]ajE.R ܣvjnӹ.s.``@k(O߼b~4\, GMdk0^J`z+*j s&\@N\"=꥖=|Z!:wo)``@1민oCa1F/ΰ8zgYasj5O!l%A4H-pewt[~H-fqל'tM[&?՗6PnĘ/}1$?%CI5Q4;'۰63Dz琣~G"=M-룣S#ZЕyOǚ`V"lX(ӻb}? o/ ^|2c`23><vGU~6w'P=MFs,Ӓ SIZ󦖕ё 1~ L署#qZ8xVްx+ ;6D H-w͙=SpjT?F [&ʳ~wPak/iãnaVX8~)姠S pkSkK!uJdOƘ7싎T)E VjO8{ّ1bTڰJW_ƹ~YZ4w͙qq)#"!FňA``@yb/>g/|kBak_}귢_fjWmt.{(֦֢9A>{8jс\UgkFZuё|f4n<|;hrˀt䖙=1MNȭap9˞Z939T.ϞrVb1bP$X=j56P܍Og_ [{7ao0&ȎOY^~R׿-`@61)DgwKupQ>cԲ.:TSJʯjU4LqbrLqלə{`zOJ9LIbĠHzjbm /੿O,ꧾzWcol%/v.eyOv$P=MrǷs6O2ojYM2M+?)?%l 濣nӕ9O4[(F [&uǮߓszO/uۖ.$ L6Z ([Ri! 2*{;yY"Y؀yQ )&Ε pR]H0 jRAž( "'H-Dj`.kZMkRW<$PEH .R |H0jB-܃r[H-pm``Մ@q[ H-pRmZ6$"V pRmZ"mH0EՃVm("=H-Ejې`n[&G|"i4 66 6$X=(?դG=igsZn nC-l(n@ Aj-R ܆s[$X=j5!PAj-R ܃r[ HzjB-܃r[H-pm``Մɹ 7 ܆ ܆!܆姚g;lpRmZ"mH0EՃVm("=H-Ejې`n[&"P=H-Ej{Zn! VZME{Zn nC-lp39frېZ=NޜV7p܆z`=ONG 3}Fg‹Z * ÝjIo`f+tark I` >XGuW|Vŀ SZ րƳ, Gj=Qקn' QQ~z>~mzWŀxYR=< 1xlXIh&Hq!邵Bse[`~$[KSlΰ/`ЋRm7L(+?ޗ.bdit2)Uhhw JK9rLR\ŖK(_JΫjZ]#R:Mf(? `e?ι/|wik j=ʺOʸZOݎNO344QV~+>qm'zN/Hyuǜ|=EF.KeGNJM@uG[Sl'rŷ7/|xp{Ug꽴3IC:Q.PY'H.O-7QV~xj{V ir~S:^4 OIF5W*;Mz[fj= UO-7QQ~zm>kb@=wrIrYL3?܊,“S/ZԏSo|v(?t} 2ӬwN|Tt]ʻNo`*um`' :(?-OAuP~r[|(?AmQ~ r3F_)}`5/OAuR~ZM0~4-ҭA`0)*i_Q~ rm>kb@od`JP)|#k4"OAuT泏_|^~U1 ^T"DbLe0nRKl)R+-鬔k20.sեda?wgؗIiu)36FO>XGY_uY#IuLE&)$ŗp)a$$ס&ÙF nՔ]uT/9_<MD7(DͮQV~ s;HyRLVzZ\]~ZXGŭ?>|7~eaܽ┩sSRRͥ[StKbТ~jh}37^o^[iOTmgeKⶤG)|y 9t+r'5FO>XGu9ep)Nyak4"OAu_~/|' :(?-OAuP~r[|(?AmQ~ r{`E 4@(?aKiӧ{JBTG[7oQ~ rm>kb@odS8٬9u} _+ƨh' :*O|ǯ W//K1Q!12 4[Rf|Z2ۖb!ʹ&EQ0բ'3ڣil'hrt{_~[Ǻ,^E&Ֆ4q%Rw(e)*̘/QZQ<<|ELi WO(?@C`e?ι/dʋԒ:a"nyʲ2U%42YѸ fz64QV~+>qm'zN/Hyl$$dTv&r'R'׻{*T'  Au⃗ś/n彁O=BS{?[Μ՟!w W64Qq~߹xgŀxYFuZY-Fu>\rwgXGEI/߷4'eJ932եpK#w\Fŕ?ST|P~f :OΪp%]6Lʋ 57@(?g)~LqA "OAuxW~T<:@4ߒ:D 7}Oo`' :(?-OAu9ؿ-B 4B 4B 4dNHIENDB`java-design-patterns-1.16.0/abstract-factory/etc/abstract-factory.ucls000066400000000000000000000236731312550536300260260ustar00rootroot00000000000000 java-design-patterns-1.16.0/abstract-factory/etc/abstract-factory.urm.puml000066400000000000000000000040731312550536300266300ustar00rootroot00000000000000@startuml package com.iluwatar.abstractfactory { class App { - LOGGER : Logger {static} - army : Army - castle : Castle - king : King + App() + createKingdom(factory : KingdomFactory) + getArmy() : Army ~ getArmy(factory : KingdomFactory) : Army + getCastle() : Castle ~ getCastle(factory : KingdomFactory) : Castle + getKing() : King ~ getKing(factory : KingdomFactory) : King + main(args : String[]) {static} - setArmy(army : Army) - setCastle(castle : Castle) - setKing(king : King) } interface Army { + getDescription() : String {abstract} } interface Castle { + getDescription() : String {abstract} } class ElfArmy { ~ DESCRIPTION : String {static} + ElfArmy() + getDescription() : String } class ElfCastle { ~ DESCRIPTION : String {static} + ElfCastle() + getDescription() : String } class ElfKing { ~ DESCRIPTION : String {static} + ElfKing() + getDescription() : String } class ElfKingdomFactory { + ElfKingdomFactory() + createArmy() : Army + createCastle() : Castle + createKing() : King } interface King { + getDescription() : String {abstract} } interface KingdomFactory { + createArmy() : Army {abstract} + createCastle() : Castle {abstract} + createKing() : King {abstract} } class OrcArmy { ~ DESCRIPTION : String {static} + OrcArmy() + getDescription() : String } class OrcCastle { ~ DESCRIPTION : String {static} + OrcCastle() + getDescription() : String } class OrcKing { ~ DESCRIPTION : String {static} + OrcKing() + getDescription() : String } class OrcKingdomFactory { + OrcKingdomFactory() + createArmy() : Army + createCastle() : Castle + createKing() : King } } App --> "-castle" Castle App --> "-king" King App --> "-army" Army ElfArmy ..|> Army ElfCastle ..|> Castle ElfKing ..|> King ElfKingdomFactory ..|> KingdomFactory OrcArmy ..|> Army OrcCastle ..|> Castle OrcKing ..|> King OrcKingdomFactory ..|> KingdomFactory @endumljava-design-patterns-1.16.0/abstract-factory/etc/abstract-factory_1.png000066400000000000000000001617331312550536300260640ustar00rootroot00000000000000PNG  IHDR=4IDATxXƱQTX`Qc7FDDXFc/Q*ذ AT(`CAb%cc0ߑ̷μ}{ݽ{;3;gM8` H)6"O Z> t_!Ȉ]oNm|dto@`@,˗Aao@`@,ۘ??H]AZajjk֬dccE=cT^^|2(bxߖ{~_ip6`]㄄*'&F;843gvzj<} +*6dvQBի(_߱5jXu=}[@Z*.\m>֭^lйnnNin:_Ok>ܻ/_ߦ؁+\RYo5lj%}[`R. X(ҷI=ڹLsJ^oIdΜ 23;4cs6~zx>Jm}leKg"._.Zڵ5l=a]ЇRyo@`@,۶o/_%Kx\%/޷zuf.y_߱cxqŋ$$DƋVւm}vC/,l޻w1$^AЇڶmJ ]Po#ݻE ۪U/]:h=LoKM>}Ur%i:uZ{rphƥ=v 8ŋLiWl4|RRN`aQX£F}KFMfGB ҇bT9E 6c:vtbǏ\jJ`Ty^Xc׮]S>–"ܮO fpi?MÇBLcbmfUP:11mk"dT)[OAsJ|2(bltft+ɍi͛#kNQÊ.ӥKK.zXnY%XтQzf|ʕ˝;ĥZ*Y#qMp ڵkqС 4j65^ksJ|2(bߦG ;~UibmذfֵkW5kx";..wozfޯzfx&X2sd,--auk$4. Xܷ1xqH+ٳgɅX ,!)V.5 ]oNm|dto@`@, |2(b9E 6. XeF'iW:,OeU|2(bߖ<×]q{&*ٙ[ÇX-W9E 6"spfm~$1z _33|V-<|IG,|2(bߦG'5![Jp"dp:h^o^A嗵cbHd9+\Ǹ'WGoO. X _;Uk?bFO]ˤW֎-}ڛޜ 35-g= O s mzt\V=W1'7N{ȥ.Ty/*dJ6+С] ǞNoŭ2Wf%N>$HPm|~y-^5|zrUCDS9/HNs.]ZRyxsVlIsMw$(6dvQ-C9n} CW W*Si#} ufHf(*':k<&되'Ao@`@,2{h>wmUsiwT_$HPm|[HӜe~$(6dvQ-wݲ֯2 ]oNm|dto@`@, |2(b9E k۶Y&}4c4l%KKYBm|[ 6vRbo@`@,>~<>|xvm:s&ݻQuphֳg4CXؼ>}hjݺVLZ=v̏_Cx|/a̷9g$U&%ms*o󃴕5+]j?zٹ]-4AJjE`/^Қ{\jաCK$.9 ]o6h#^>#{'O7lX [B }V G,8Б_}RZ*Sa`L6Z9m[֧Nl>^vO䯷Nڼo#6dvQm>6e.Vڷo&6~|ozյΞеk+~Am4mgk?eJ;fw{ѱwu4|$/yGGm|c­[&LCj\O(Q499|!.m۷>U>|ZjM^"#x8.ձti3y5*N"FO򎒏9E 6rfnnNݻСI|ڤ9-&ƥ'm\_YD]߿#ʥ]ѣ-~99}׬Y=WNw&sW5Lw|9E 6h^˗ΓuV͇ M s m ]oNm|dto@`@, |2(b'  @E \oM&. XAF'6dvQ 2: s m ]s s  A&\o@`@, |2(b9E6vCթ塄! ]ȼok7sl R9E6E v~.UrO_mE}[JJUG> 逤Xm$s s 9OzВ=VR޽l/]}: K-˗/U_:w.σ޿?jV@zwަLѤ͓c bb>Fr< s Ym<پOJ~=zftil%FE-rJJܢEcV-OScei"VH9s6.|}s$6dvQBo+*p:opac{ɒ:4qcg֟[ZZ,\8-0Vʅ $o\-9=ڙ>ki93Sǎȥڳg[jՑ#+ p5+v9bE 5m*~2͚#5|x[lsܜ[d+Z>|Wsmխ[rrƹ!6dvQBo4a{.[Dv R<&nՠA dΞ@ݻ?F̙ݱkiOeC=:uj6Z-_ϟ\xmUxqLn).nM|yg>_j_Qt˗5U'&Hm6$F FӂI~Sn 177[w\\k}.2JC~}k61. X[;`er04իK6siW:_Vx6t:uRp2=8qbȍx} lWtum}گY#^JL5'$DP35Ǧ^>~~Z5`SS÷!6dvQ"=ߖogatċR;`e"M?jd<֟-[&yo.}M(-RL V߷=rri_G%&FS?$$D.No. Xʹ:x[Ԝm G:׬Yi ˕+޽޶haL /hѲE8-cƹc.ldh>T*0O0fL/vaZ%O+ˡyJNz|'xTuAܮKrqibŤCNK{\ctrjsf}"; (box'O/#5שk +VoU}`~w!]{\;#GX|"_ٻwUhn>s>}6l'K0. !!Z >s WR<\T53kΜ d֤^ .ӥKK.OnkBٝG .hkXr%"#Vիȗ89d/\KSR<<}Cƈ %J}d?Dm= ߅v|ۻw1e˖^Fj.:|x9{͛#+ZTP>]q]\B?8q[wĒN1"O\r J433*Cڵm[Bm7]nW%v/ɱŋ!Fe [.jmt׬M0"  I'(:T"܀&%%N[$y3$2r)+oE6D֊]YM}˶yIuApnnѿfN. Xd%1hKK3Z|x|î?55Uwʳyg7Ɗ%Faj07 . Xķ0@d(0. & )Xm|dto@`@, |2(b9E-u+@26ѰuK.I 6舼506mtM[`+W޿_Vd> % |hXlً/nH|q0nH|h(X`bbԭɀo f͒ %m|8HJJ %mʕ %mŋ˗/ %m|8>T|8m֬ԭ)o͛nH |q0.^,u+@JA```~nH |88{}nH |q0=z[R0f!u+ɓ( B)%GБ~/:)Lmvߤn0lXW8驄o3jTԹ04@ "رu먰~G=|D*uȅy]dǏW}۫WQ.mҞ'<֋^JL.^HBBllկo-6޷ a9d{CE>}mfPls/ СCubȝy-ZVZ~ oFd}[jjllʕ+I3שS28ؓ\C3.٘.^dffJ5Tre א7u Ŋ5[2j545>}Z>ۄ`%bcGE ߦxaP*u=xܹs\m#7c:vtbǏ\jJ`Ty^Xc׮]S>–"ܮO fpi?MÇBLcbmfUP:11mk"dT)[OAs:WMxaP*˗2d.)Ϟn%6mysdک5jXQ…ctiɥ]֭5$<+Zz:Jl/Xrs炸4SUV5k~4 Zv>~KeKZYqrjIm`ofKﻳk}رV4hj΂,,Ӈ뱩换AE ߦxaҦ4|jN\_f%N÷@:xݻF6mt4Qs+Os@B+h|w_?.&]r(ӨcmAj 1czbo2ymLIE.]{6El-/OM"Co~$ ޷MJo GΌ ~v+P!j*tԌʴN:i̷-Z4vժ)LkW9dh{Ho5i|%v-@-A5ٳְy EL'"ZA;x{+׎xF32x¨O^&vD?l_gm\:]Z`4"eւ̷YXgw}3:=z6l0wd脇mE*k&щ O ̷5iRMs$zNi6߷=~zС 6}+2|cZmz|zC;ywAE+x<| ^IIGiϧ3 H$0Xpr]YԴ5͛#"YDps9+DVҙV=W1'7z4?r˪!4Uy6w~|;6$ěM9~{^ mQ!8y2?d֯D#"3C_mV6Ia/I8$ 8_7L$/>f;yՐtϏT5hjmpڵkD̙@ QuphFoC:OhuV[r2Mj1?~ ̇;ۚ*}tJ[vgGҎйs j{: Xks166Vxw"y=hEEsi;> Y>p#U7mWS餂|ҭ[Sh'R̄Ӹަ;ifO> u܆` Zn= iC.lKTҐV#HUÉ*Plo)ۻ)$ƏͥpuΥvm/"޾f̙@ )S1b{~:KoӝD?ᢢΕ\,88s_?dCsI5\Cijzϓ"Ue5U U hukׄ }]%JMN%jȷlz|)ιjՀ"i:$: #ȮΒcgը;|>;*=!EEE+20Xp%'9l2tܟkꇾ;tBS5gFNT5TA683sssC&kHB]NϷ=~rr} ]߿#0qbvA엓ӧjtJӬY=WNw&s1d*xy ӝߦfTԹr ~9i!a02mRդ-"R 1|zDSTnNᢢΕ`L)RhQ3^Wn]U^uС]˗/5|x7FE-+QhHS66V6cb>&{RcΤ~yDz{>tѱyrr,"XPQŃ86c j%A{'Okͩۊ/BN&ȥ\̥e{~`O͜6jX%וM_OyXDL`!΍AT- xtܕ s ֭?3:kk_o#V|W9tЄK ӿѣK4>>Ͱsz[HzU֭[rrƹ-:zEnK(ý:;rNj…c}[@Z*.\oѕ͚գȮٖzvϝ 0cǯj֬=׬ȑS211Bҙ-)"\sq5|6\QZL4o_{r:7+32JaیAz)SXYYկ_ܹBNzAogatċR<}o;p`Qjjo߾}?ʿƍϞ=K~mǎ#G&O?9'nϞ= رclұc@*[aÆ+Vŋ+VHʳgΟ?zAk5yжB'i[Ԝ'=[MM Rx`O7RP ۖ,Wn|/ o*<ؓ'˗̤o ^v7QZwٲ;wBCBy&]Z9[ivvG|D.]b57ڻwUਨs4ԧO$%^ Nу}k׶m۶DnnnGMMMMoNɿeH;"z6mڔ,Y2_(w%rKT>qĜ9s-Qcǎ rXXX>}-Q988]v3T׺u.ZG,,,f͚Eez͓'͛WLSUzLo 21Z]L.mܸqrLLw|<ӧׯ_*{qfOO:c*x޾yH/hj7;*^J0v궄^H^^ʕ+I3m4YT2:m4d =QMNN-oiC.mNIpc5.`4ݺQS~=P!˗|HFٳgT~5'єi1Ipn5n+=Π՚6-6no!fNo#Oa͉.PyŊz}Ï>>#Lʐyvm;-FMmذfֵkW5k8o~_߱A->{A5Tȟ?96j6koG[i(.^ț7G0*\=CލvlAWA5c ݏFgP>>>w՘Ӑ \&i۲rU1sY1i5sY7o[z'с@?1SCJRRtW7[n_?M(6vo6˰[TCJ:7!3)7iRGk'kH3Mnd ʵA,_oI%#=TUMohLӧui-8eJ{kMA1HكGӛKңwգGSSSǓ@*L 倊:7!3)>|-\M+{j>br-c e.ݗw&e8 *gr%øPpQQQ74d&EMj^EgOܛYMA1Hكɿ2K[ 3 'R HG;g5 [f?LnD =du!ALK'Rt1s;roYJA1Hكq_Bb p:?Ҟ,vph6fLl?Ca\kJ5{!h! .**\C!^7tSdU=aಖF`/Zinv/Vpn>= /Fk:ɗ//8 Fwmfh *={nIm饞㗛-A|:ogIpQQQЀA .n3n.O/ZԌ{\];S3b?ާ٭] m˖_Z&]Lkvm;c[l~ F_#7[@ՃLg7ᢢΕАI!cP6Y/]ܛ6U, {:X0 Ppr?[ 6Rpm;w!w6iI ez&Z@Տg7ᢢΕ* \f~OÕ+W׽{ad"/n233Pʕ-\:hRRN`aQX£F}<n(3~ps_71u.|Y/ϚAsiWf݌">*dUg۶YtpCڨ>!!?{.R[Pgr%Toc(*\6 |7_4}ss3:*piii'"A7_"\T\ܹOVܮ]#Z*;thBn_?Pzg.*ZKz}P,TԹm .n2hvYl"M>~|5~>_"LWH^?37kKN% t{Æ z¢8k)wZ@n>b΅oS0Xpw? _3bab02&_O2zF PogIpQQQoClglq.N==!P}GuLgH$0XpsH3U ܗ}D|PQxA '8 nk>"\>s"Ha)0X&!P@jJ7$Ds"Ha)0XC@A%ϒᢢE `!U „u.R),E ApZ h&Ds"SV Ɍ6U u.R),E AdrԓHۏZFHBNXec[z2|[T1IB"\TTԹHA,!PM/BT&nKFn *rZȀB:)4k" w{)2R!С .\ؿѣK4'|a9bE 5b3v[TPo3Y"\TTԹ*H)t3|7K8P!ӥK K2y9s-5|xNQ;m!!ޗ/7jTS?a@ θo(!EEE+A>2A`CvX*U|Ĉ*7hzŋer]s-Mc^*Ì6U<08uHTa!  mҶ_ڠ 'Og 7ݽpa#Rf1⁛򿹏*\6 g n4/'VSi?*RYTp';hqi#3/aFn */p΅oS0XpƐF;^^ʕ+K eڴig1"򿹏*\6 g nԇtN\3nnNMm -Ho#僊:M`[͐ȥu5V|Fo */pUoSv ]aoF[ZZ̜9gdժz12ڤ-Ho#僊:W&3O,8Ĺzpo`KN`?N%FF@ܗ}D|PQxA '8 n<ľ%!EEEA KB6 RVI7$Ds"Ha)0XC@BAY"\TTԹHA,Q!P1BjUᢢE `!U „u.R),E A|47T-"\TTԹHA,!PO8+2 Q=o(5$h!C .**\RX ? ӡCKzhK="\>s/ 1仹{7K6""HHϳ>Zݻ59L$cTCLr*\6 g nG89nÆ5鈒% EǤeKV^l7"mjpsI7AE ߦxa! pƙ?FP$WN|%oD( >o#僊:M`)7ߍ #MEg}D|PQٷ)2E0Xpg7qƊB#MEg}D|PQxA '8Ud||FWVo2h6@79GugH$0XpsHZ>'Y"\TTԹH)+E A/jZc%!EEEALIB5]T-~s?KB:)" j8Z h&Ds"I1)0X' 9I&MY2P,&*2A,Pm bQQQ74 E`2oS0:WЀA( @&}_:)"HW&mwΝ;WVdLjjԭ&>>><@6eHU)t|rJ:$uC2R"ڵB ݓ!?8ߦAoȊ'O\RVdd[sjm*|3gNll QwQqMo@y믿7o /^ܺuԭm۶7n |˖-1bԭ)/_| PqMo@o zjebҐ6l3 r@E9R}*uCڵk={&u+ ԭP/mW\W|&O}v["55z Q)mĸ2n߾-u+mVV υ _.uCrLBR7wޕ!j͐8q" @Vdw,XH}HO6wI 5͛aÆI @NȮ]ٳGꆀr_r6ðqFWWW[M:d5ILLR)$:5jԮ]n8w\``ԭqƵm-׀o~נA[a~___[PƟfrԭP m`͚5R"ٳGy?~|[RRmdd77~I4nEn@/>|PꆨhѢ-ZL`_ĬYSY˗GFFb5jݻWB%-m9Ç7nܠWS.\.u+ %Kn@լ_&'|r*uC|[~QgYbn!a6%xȓ ߏGyN!_z*Q죤;nQ#R @LLϾiӦϟK݊f…u+mلFm*' __5k|QZ8ydBB2.j6....]ŋ?ߥn"##Uv".M4 gϞI eߖ{-u+ WX!u+D!))L28 |rΝUꆈ˛7o̤nd~nݺ .! -ܺuN:*uC ˗/+А 7t_VH wܑ!J rϟ!>l͚5R7ɏ?㥆-k\xO?CٲeNtWti:xHTW\!uCrzzzJ -_<,@roR7D,4hp [!.N ;뺻w-^@TĶ+Z.bW ņ TPiV,Jmof$s~yd39?&"b۷/x ĝm """22, C߼{ɓ'i; ŋ 77nܠ_Ȁ"ue 5Hݺuq<OOϽ{j=!R3gmG6qƎaOvܙOADȳg yO:'+1giio-m*q-mx;++L2IZҥKVooڵkvQ&MD *M٪cǎ>A݆h5V=v kiiڎ!88ӓOWWWu[`;$8P} :99#-k - ^DaݻwC vvv=~ĉuK>|PV-^P߿o߾@nn!>~A0pkcc#v_a <[n>}l\ڹsn߸MN:iOO/^ n¬-[` //`^4 jժ޽{ɓ'>}:bĈ .NHnSҥKF GGƍ.؉T⎨(JiNN%mwԩS&L/6lٳgi b۶m]tVnݪ]EjccӢE muǎ ,헐@ݦݻ-Z͛111|h]iӦ>|X"M7vЁ;ؼy3|Ν:t(UD<{ ʯ_v3fذa>~n "FFF:::*UjԨmw6E@t};8ĝo:%**L٭Y&6h̙ +_}ZlgڬY sss۴iE;ٺu+ɮF *`S)<_4p| 6DEE?ԫ=6vuC3|;6p9sl߾}ҥٍuff&ɮP#~T 2H2>;;hr|z988ԨQC{m RB8-)uynWp͢L\{k׮~v A#… ϟ?'˼||֭UVm۶m/^M wa }ׯִi&M-X0&+ʽlوP+PȇҁD@-s+:FQS*7b`aa1p@-L uE^;<)q6i;ǻtz].C„n{8ễۘ6lf fA <5hX`QZlo>ҁ c`\>PLNv۳gQuLM{{PD俺͚+[oBݬY.Y%oannt1M*ClYIt-g=궂k2eHŊe֭m%68_lJiaq+OA6C3~B__k׮zzzFFFwfx 4,:j ,Sje[(L,R0 l0f!ȒG=vldvk(M۔M=zsyҮ|2aaW g" U ۡ=8E@qaL0Kx 4,:jWl)Uz](3HNv  qYD4@bk eRR+U*t1jJ_o2]t [A9:|DfG|ysх*FM݆Ъ_q4B 52ύ(cx v[7hPiiE|ߵk6iRz*AI;; PQ$tň/S4,#+W.Jt50Xj^Ο?ZX ~lBiaV<݆ЬJ0LE}<7mZU=25OOk#.)-U~ kK||ׯQSUa;zlFT4T4H܄۰zbE- G A657VV Avi/RԪ+%ŭdv_UD*5wQS0A:J+Xn SZXܨ۰Zvhq,@`*0tvszgTԊ6ثFF]~4NrV۶MA4o^Y*kQ;vtlŊAmF,jJU%9|kcd 0u\Z1I?99LE݆#5-1UABerUe1" =_)l.eG}@K`*ZB;y:G~VD Mu}R C`/ą9 `:GtVZƖnfl@an`:v:Gzd0jh*F u! sxQ!me{`J3|6m_Zsϸ0 s6ǷtVLu~k-\ᰒL KNA#;L/zYA|+,Crn㧉FanfnqvàNk?wy {*H,Uw/Y%Kѩ@sqWLiT']dQSQCG$ŅY0(i}lÊ +ƪvCLn;tɎ6clmާH9ᇒP1۴YG0ŅY0<2b)j/rz)cdx#÷ sY![趂jn>'I5iRr&} ~khعukQW"܃lhΜ&zzv_Wqy͚͚svⲯEիWYb"ddcXYΝ~bggTm7? nBB.+ٿ25Hnni۴P܄1q&d_X4?Ned2k?dFd\Ѻm۶9Pr3R_?嗟ϜYG6lXظ+Lê*T(ӥK_wٳ&.G``6 ƌn+V31J}ѶmSwm Ҩۨuf (cx bhuo|-v:ZͤFcJo#ȷv CB]vu@x%%݋K#DSRBB.mۼy}c<޲e6LgTM6%qGkז FVa[k͝;vݬY5j@ի[:9m( q799JS\!ƅYP<IF$|[&+>$~}Dϭ֭6{ ͥn<- !p=Ɣn.[rysty/_qi۴x8Eϵ"bM-5thBw>Xrٲ 0( nzDvmtjVL>={;8:&+0`.-wo-3 sI c_ϰaF;w'rYz\EZFnϷ )v)AP䉍B[˛Q} n 6* 3!,y֞1Kq@q0vuT51j,v%y*'Uprh Dȑ}*W.a-?2#{!<.*h,-g緌 es˗/[jr~}XDYF @mAvlGYqЋPjE*!Sk8 u[Mlg;^$$ۘ2tint Y7ڊ̘1fAӭ[;8l<[?yk޼>\v^5cݺȆ6 &HU$2-_>aٲӼmγђ ;pPVQ}4hP'kTN `䦏P~6ev/ԊTNC- 6%`4gMBCH}n*o4< `}&Hge|P \-Ƒr&i# ׌lܸq(|mf]Y!^=Yu^qg#8Q$@"A"Pu!NK&&ƹ`yJs{` eisSSp"k׮Y k3f 'T^66 '~6e M/|Qc._޼lgkr to%{+C\`lܵ~իWmq^ŅY2~6e= 7mmYYsÆ5m_A5m4-mF#8QӐ)n5˴_ m33Ο?zணF!cm;:7n mѢ#aV==ekprei96{۷ϕH;#=n`+M%O~[c:{6aP>Ԯgk.1Ua3MquUԎncPQ7m4m7َ=nY=u lmb׮s玄11Τ7~V߾)S N*˺n#vZ5 ~56X9lԴ+WUK,Vpօ ًu8ڡ)lic7em {&\_ΜY/:}k׶GD\ݶdɟi'({~To;aʕfWn4Ӷms@EG2332hf2Vp,Ը#EDMqm6m4m`xnm{HOxז.ʕxn#%HvʖYLٳӲ@&7׻sg7-HU>8h5(8 t>Ɩnvhꇸ6u9oQn W23771A|}O:uȲ֭Iw/_n׫W]3.ΥU+}!ffFNk䗉ɷÇ])!P V=Lv*J˳$a86vo@}xj>58(c\>ӊ uqa"0 FQ<@5΢%0@Jn1f )XJPaq&i}mpUM}/J`!J0. `ye az(=a^⛡nnt`&)mm,Hè&SUNb+{df>LHK>5mb)~Z ̷ie%m_އ+kedrh˖ȯf^:/ϧNdlɒ?=;invhU/K8K!(.̂Qy1@<Q+NJt[L’Rrȴ#ԯ_#2ґ|e" g"DM݆Ъ_q4BqP\9L%JF-sFV&Ä@>軺W`ׯ}!:qW4I|I4mZѣffFgR A޾׮ge\x_=xpVwuvC kUen d,bgVLCq\0]\>G7jC.t'}|ݷnۼyK;A"ےʔ)r9;+5nŔ7j $"DR?_?iד'6 o~Mzz;pd脋7u֊ldoddxӧÇ|c ڵS+W._^u/:+Y4' +!0.2.̂Q*V=nѕ5|Ben34lb҃ؼy$m'-[ϟ) [u#F&MM&6XnG.7thw2ݤI*-*fnwժ?}rѩ τ ݨ1N:k)_J0 w۶9៫B5KsPF"̥ËQ۴6XQ+K ˨|L׾J :ʕun GqڵS-O[heFzlCҬY=.YU5Uu[;.B dܾ}SSxxڵe:ge E,͙n檭8Kܨ^6RapG588l; 7j>%݆ Qfz,zM}M:LhR[ Q]}XLi߂/A%A4Rv;Ν;С+bŲG,LEDM%v[v7lXSWWO% +]݊66\A`kn}i` ,_^n*Dt*̸Qj'U/-}0 9*fqwO^nt(kR=G ՇXQm.ٸFud2/Ca&3KtT&&=۶mSmpVJF|MfT^5oѣĨ}_}N ~_ ̗.Y>" fA{I,MTI}izr =Cz3nc)-mpF@1>4L333 nYVZ H ybtOUltʇonIX%WrF߉yqfqk=LWH8wnCA⌼ ]An<ٸ݉a2 QQnS\ ~rL70[XO:D1xkfIJ!6W59L87~ B"=|Xlݺ@BɨQ}s7oNpj3nc/Mt۝;{KeB8~ $qW(|*a˗vpwX~ +%Vݦz:"%onMp2>&@jDm$j0AH:{v'L0$ eTxMvl/8p47jTB^`!p+onn; /^ԣGk9(8]ILta֤͞f `BVșzF&MGœ9#BeSuB*4 Pxt$'O&f).M:GD%/7j2rAB@՚PV۳g*0ݽ{k)zX<ݦJ;DZkn tp\ԛ_- 7Lϟ?(mwFPv!paHυKBv;9 X[~Irme6;@^W24O"ZxIa`9rf).M:n27=J>&@Ŋ Y;( qs؊^wۡM h]݊`ccT"m)008 N!Ge4㺍U}tn4?W. Ww$|=J+ UUzj͚)e"#T6VSׯ/. iSnU`DQ@f&U5seMGLe}H4n[Ir uB^5K3XCn,@k7h +r1֭p[ɂ}Z$;KT6VS XZ΄|Ѻ PA۽{]ybuQ6seMGu(CnTi5UuoҌ6VDڜZ^Ͽ@R[Y-6ٟ7v]Yݯ_{pРNPOAa?A'.o+f}g%Vmp98nu Dvm=ssYC*O^nc6#onIz1ևXQC$jm;L(!6f9l&ʚT(AEVrF M ^mNH@\@D`LL=pxep!dž fANNH9O^nc6#onT>&@jD Mncw!.omiwSXJ}^n0e77QiѺnKJUךUF uo8uF=hn TIhwon,Ӑݔt1pR׮QCGGBv#JR84jۘ7m u?M(9@26ٛJ0\A7{Qدך 6 uuCOCݦ(<@2vg8W6bMM{N21AsaTOcKN׽{Sx|Ć~vm55NuC3xq,eG7jʺ޾P̩Sk>~t;va lӦ?X ۷8<¯||xd_ݻO8p1۰Z+& u? u66t*Yvڒ]B٘\` Cxd_k("j6l.l2rqZqT4uy1@<PJwֲ …,YT@}Yҥ ,/dcѯ55UuC!Π>>.f).̂)nꑳҝLm4а3)Yd Qp!n߾ēlu8Fl;PDTmv;4#@0LEfAƔSav5o$#l_*:jF-JĆ9L@}r~%=_.ۯbcp@aQnv:Y@ qT4htSC݆#*nT{2eJשSDH 2˰TbU';P7($ZOTv}_a;w`@}O}hhteY=j5U ;Da0+UL~s}_a;w(b2u>0ƅY0DG~VjG?F_(,jm_Fqu+.ƅY0tVj;@4n_P5Kvhۡ9Q|BP`*ft9X=P(Vl&v9PeG}] A₩hU`/.̂&X=uSn C*0bEhR&X=jPB&`&Z;4S8Sњ8^\9j;MzZPtMغƆn>@ĝLhQQhp0 *h[ J%pcZSPD1Çt NC-׎;hm]4ncĭ$ڧ@u9s( 4ԶX4i$< Pwww|5g[[ Pɿ>` >}8^0O X=2gգߠAٖV7ٷo߲eh{-رBQÇo>''# SuuDEEaO9;;tVkS󾾾?qqq3f̠9m/x́6Յڎh5{QZZmGmtX|ѣGi{!~%g_h; } 7h 33#Z6:$%%055|2m/DKTTԩSᓶ#|1 ܸq#((#ZCCC6AF ңKvv6m_DNjjΝ;%h"N;֭[7|$Y5kn366677Ve˖K.;܃22e m/yȑ(;wm/DH\\wҹiӦFPQdƍ%ҖSھC^v$##_|"rœ"...999xu_;wh{!rOѲ σV^M qի#ˤIvE u_~߾}i{!~@%''b)fM4qss툨x% 6!wptUf+QQQ5쎘Y233ݻQFoJEP333ggg^O{ / ,Yˋ!,,, {ņ +ҥKI!DFF˼޵kW"l4i3?PUVIF}޼ySn]|ÔY^jffm{ٳ ^^^Ip۷/@|u!g9nͱc>}@DԫWOۤ*K\H}AA&lmm'L@ 񓖖 % uiOkGϲϟ֭kggG-ݻw mkڎЪUBT Hq 6 -*[P ##^GGGzڎT)`3f,jׯ#8q@ux ܸq#"7oޤB\mjsU%CF.ٲe mGA&6:vVJJJʡC$t m_ cǎvDM ͚5{mGIBBq0+6k,^ MlDGGoذ"'+++'' &{#=qD^8}Çm"$--M"}eܽ{&11_*233tfڎhgvame„ G텘+Э[rsscMx*xE=DӇcn-yyyvvv0GWAajSm`VVLJ#`ĉ۷o|vM1P6m`2a8ڄ;wN(f9r$++#ٳM6NIPM6Bm```zzzRRm_{"&&#Z(ƍ vQmZAppD:4$mGLhhh۶m1z۴iA`322LMM?L) kp6uQv ^+W#ݻwSN5jm/DBB(svD{#+n"4/勃Cdd$mGVɡ`ݳgmG̺ubAݦ]!WXA1^zZ?_|Ifee%&&u A 55{7۴Ν;;::B@ 9>>##22q/^ _srr6mTbELHH-,,Ufhhxݮ]^zc7ˮ]wC ~/_h; 6m$==ŋF ;; __-Z.Ho۷ 4Hlll ֭{ "[|yJJ mG5k t8XnRsrr:t/iԨm/ԩSkԨq%{3gr샟_۶mYj 6&$$vmZ͚5kN8ǭ[$7%i;"$.^Xzٳg{eݺu9vݻ/X+ccʕ+sPܹ7mGׯ_Í v=nv?W툘Yhm/@hha˖-}}}fիW~ .]4zn޼ɥ3B!55vDh޼9P!Ů+nwN xbm̚5k׮]\:cmm=c B8Mj׮}Y.=ADDD'dmnCqq̴h>z#&,,yfffqF~tf֭ =$$$4k .իW/YBHHٳi{PuKٿ?mG̘1c<==i{k@M=w yn8s233i;5hҤ /,ʸ}BIjmn{,jܸiw(TmOm֬^ٲ{f2tɒ,yssm̌,SJ֭_8 FjҤNlwíZWX0& 62Ҵi[,YB_6J<B>۷o_^O^ 8߫Wϴ!Eã‡0XbٲeQQQS^EGTje[(,`h#[}6p`GkczȐndѣ;Rbu~(a]cj-˗˗9{v=̝}ڎJpvPimdEW1G]o~TNk7t^"}_h3߸qϜY/>ܦtM& 6Gǝ''gFtppئt>>_~Z6Ki!t[JJ GuCܼy>?~HD0nC!33s͚5-7n r$ Q< A657Z8lXQ35E `Zj%]* t@WPJΞ]߲e#tJuݯ~~4+ V=|m888L>a:vDmۖQx#.~*V,J@$m۴U+o<\_e-c17.b1Uta,|@5iRuk}T ܞ=`}ڰ¸8SXFW۟Xrٲ"mp&}խh3 ׺w amׯ.\L'""ڵk_mKܘՅM\%_玿 (6K˙ GǝkV1wrWdΝ kz:4/S4L;@-((ŋnBk*Ν;iii}AD6pͨ]6>8pI޲e FMn7#v8|qNM1d٦<~|1/+FժU|_Ǎ_u۶m+ɕ+W@v'j%%%}#b#''Yf\39˷M60v)0i0Mtۄ JڵUTg`aR~:}0>~P@yyy l@yamM@a9rzc#&&5rNyl>'1fK6}.l3J)m/nݻYR=MO)~}L98l#Yg^eddx%ґ'hme|Rzu=ew]t)F}x4海f[Vo,|>ifkG+mUV.] FnWkF$͛" N9s&m/FrrrBBBpp0[rgfMw\6ƿ% nm۶)tUm>9 ԩRr}=qb̚4iu[\\\ll,D$RѶj*/V '7;wUMzo?|Zei|x={98l##bY?]ztۮ]ڴiӆ h{h tɓ'q$Sf)lll,}7Xqi57p`3רG"""N> BFF|ZYYa(%ҪU+^ 9"mg֯_z*]8wn7eJRņ‚q&?v/ #{H;ؿE_u-cD5lٳ Q 88x…@mٴi/m/DEnnŋ%lECݖgkk{}FBkFF=mG-u_ׯO AI/\`x6֭P<>=zDuu16m|ml߾=@,yyyf͢ՠnC]h{!*IfCveƟ=^n;߿DpիWk׮MLL< ؟_{H:޽{K-ػw/@x۲<5m !8݆0Nnnnv"##i; @B? )6l@u[nYopуw5aXqqan Ywoi-[.K˙Doݾ}.fdx;L 1!.liӺd?3С۴i Bvm=[u _4iRu?t[bbbnݮ\a@y_AonC͈#h{!6$A^fԩC`"$䲵]ϝ;8m&.^N"ăL"[|;,Yz0j$Ç֠`S^~~\s߼ڼumg]`ѿ6ں-//o/^T;HAbsv?~z4@Q|t~θnqgά}>}صkt#"n[Ovpdc{܉n0pJW i۶9âo mAu[Yiz|_זt)dg{)Ūa;)]ۛa3wܫWBT>|ãX"tSQN8Ν;FQ$>>^"= h; A݆ϟ?0b#22!!!*.n˛3gݸ 2qxnCO\\|^r{eO>U^]QQm㘚AD$lܸ;d;;Y\4۸mw]x1>8d,k׮vA6D$,_&+IMM=ygϊ^d.-btÇF[{i{ * פDL ̷qoCd…7oޤV ذ711텨}v~~>@ƙnذa[2^~-/i; !3իWk֬yY۸myyy+V`9Bll>m/xnCD˘1c|}}i{!޼yӮ];Pqٻw/2|p^ ???,8K:#33`H u"fPΝ툨033SxXηWZ5,,P===T@A݆iӦ>vE˗/ݻG mvqHcǎvD}ƍظ9gΜy mGP!H~!iڴӧOi{!*<==BBBh;"xutt# m˫[nGMMMH~OFͥ0 6DK!7nvD$ȈM͛UVa("2P!ZM߾}i{! ڎ؇C 5kmGϓ'O:w AA݆h5_|Q$66۷ϟ?.v) m˖-ˣXp!mGG\\\`` >!/^055Oڎ +nCoL2 <:uڎ ooo==W^vD?p.cc="bP!7N> ؝:#DEEaSo޼/!]P!ҥ J7Fwqq133߁LaӼys 6ǎ۸q#m/DBnnn1V چ fnnNa}pڎ nCEǴiii999}#p9::ww8^ GnCԫW״ .\?~زea*ѣGϘ1ӧO|Yt)b>}888b|8]aǎ W|LզW^$߆ Z6QȨׯvD̚5P~fff:uD0:xV LQN@@Dom&իW 툀jѢEJJ|ӧwN%F 8l.\ýWBիWƴ@ A͛7$jԨ<'''*^1Š+V\Yãy Dp9s&ɷ!B@݆ `ڎ*U(U0 @G~~~:u ccc'MTvmP^^^i#/P!ٳGkbfQF=}Tan=N:E/Mhժ+ǎ]tijj*Eć6lH #233}||~JRf޽uݻ'fddPM=wA_xEJ`` ]DVV$߆ 1>~ضm[D rrrΝ;ײe-Z9s'fllsNڮ~*UHXtޱc0:QQQzD Adp̤PsN߾}k׮ -884PRRmC^.\XVI&HH6a??ϟvD3fL @-[;Š_~m۶m޼9T\\\\ඇ#kP! +Q,%K@v)5777RA+ȃcbbh;B#4MKIFF ڊAimmM nCݦ"lEgE s=֋/#ùBII4rHѣG\@B i(%&&ZZZx0x;@[Q}?9?l_Qq}YԼW/mZ?DL-UNNsGYF 6$dիM73UW'бg];gdd&dQs[jjʕ+T@<~8***//빰qn{2U-,&7 yy9kiC5lhqVgh.3綛7N9ݻwWq×vYZNcih ؉C/ioZ…ӦN@_N %pqqǎKiYLl< &i:q:}Be8M<Jvpm555&۞>(oef48.FT|6yHӌ_2=&yxlڭqnն/,y,wuWc|}IG__kg7i>MJ:*/eqxJT;*ddܾp4"ͭ0G ٳ2&l9>M4dnKMMz Jviq}پŨ`n tSuuBӍsEt?j).HIHOs&iuұ$׵kϣvۨ?P'9GPT1"E=ܩS[uu՘n]#t@~! `[Ӎ2RRRhD/Ҩ?&&뉰\SZkAnMrvPٳ;uf3qO>mkf8QRW0mڴb/aۘnM6ov!xPR;,28Lg222V^M[' ݤ{!^yyyʲz*Kt}1ʊ B35RiN겗v[NmР̻(͙cdm=ǥmB5m866S>&8ۄ_~9ahp&&,r|;Fm X8sMn\OD>LiHipױGn8텱{WcYXL`P>}zJ]'QQPhOiץKToju"&powp?WrqY,t@:M:(3->>O>z"@ZP]]}qggg'"bͻQS)2ҍZ($ 9xvm;wDu=44TՙBsۻuPWW p lvܖ{VHB Kˇ.c侻EEɌ2P6nBױL:\;\U⋂-?6:''G-իWݓs*Rx< ZRȰ &p= @nk幭m@}UUU^z"-֚s[aashDd,DMMH ܆GX% @֧Og"m3UTTі,)XZJU7Vs۵;B ~aթ\_\O@IBКmٲ\Ϣ9mQ\s^yxPZ]o))$iTV^ƗN[' $z!h󵴴Es(9XK܉#׃O3B퍣ikoSO^I~ɓWϭOVk D{mϞ=D> -n"3cOM<Բ9R~?4 uuz{j|*rsd;eee[NzS $h!A'Op=ێ]q}7sPtS %}'h;* W}0~yyS:p`-0UO>suґIosێP#%;;Hsp TZ|[;[M:6uc%DPvW& i-22ҍ^m+QSϣ//}(];o/_Zʣ]{+S7o䶫W=~c55┕iDZ)XCp=wbm'=gwm,+m:I{;S~v4õ(Q"K.dTW1mX+*vKܩv___];}?cFK-._>"(uEA6-A&sǏ===iDZ/h7n_z"B gӏ[nI_%Z6zShkVbֈ[,eP[4oDT5J&H]3^vqWz2CmݺСuu{+W5p*8idn+--?h4Z96,b'\p̏~>ii)ٳ%%т~,?ƪ0ŋuu,{gmnxJJJpP ECY8mʼnj ;0xm2۞={vrrth @F8;;oذYrl6|< idDMMk_߸&-++HZJ n&-))i<"6Y`kkۤ=<"6C[ - `ۺu |}]~ɮك_ܿIs[zzz]6>r222JII**.Znޝr NGpW`+~;&z[]~~jM<իuX= r9s%ܶv %gd#Fh?xBi>>`g7*ׯo:ܖmccamP)vrӧSgr)*.OKinwȑ#D @l޼*b{s[dsr5k)]_oC/_퓪˔ۘme&r[`5x1N=ZJII4}gR݀GY*wQn'ٙ UkEE'Fl,)SF%%-/AL__[]Bs[~~z6mQ|ZWIoTefZ|رzvv/Iᬢ˗TٺuY]Rx<'q=6CnhE֭['{Ҳ2^II,)nRYyY.V ӧJJJ"Xк9sE"텍v <{@ FO>eo|6 m^JKK mQHHȦMMsSRR•6iJeddܹsl &$55" USSScYXrrm@O'OҶC'Z{޽[ö6ɻކGdr@k|d6qD&i'N [&L`n"mݻₛ6x͛7uwhhmۮ\_ж96Çp.ADvX8;;{zzPmpMݼysܹm?%H6h(--%Gn<ݺuښG BTVV*++?yyoGn6n?H86.&&˫En07_ $rSAAӧO=<<>]Ƚlقm R]]v '^zD-m7(n h UUUΙ3빀AAAz".6x_gώU7I˫WҖ}QbKIIuɁGZ60yyyjjj-ׯiD@L9rŋ\OU{䉷w  #///99966뉴RxuBnf*))ѣdzgϸHk_Nm|iii \OiDm"剉...\OUHNN3f mp Zrذa'qx zݻ/_| sMo677z16ڔCCC|e m J+W,//z"\O"ٳ,'" hD@" ukڵ\O$r"44?S\O$rɓNz"EEEE{?HAAAxx8mH6`׃\D%K.і$Bn:88p=IGim UUUƥ\EBeggӖBn1b"qrss=<̀&6E(5՛&OI{==1K$ B5mڶ%ON>jt,O~O>B{;9ͧIIGۺ,CcG۷FPVVF(={x@Є-3ӧ?F6*m}wNhqnG-) }$.]:DvynBsgZxC::>'uwahJVVV?&QDC;ujѣ}/t\:}#lk X >'@^R^ r[mmjϞݩ3|i^3{Wƹ2M;mӦEh~ tmBy dG`: mDnAXBpԩc<69gj|Ӯ|Ue//gmn*۠AwQh3zK]ۄvk!qn mlX?|FMp4& =܁kr0BLL?:Y:xw.mV`E~݇I<){:э0wjSq5 L#ӧO޽[6* )t阚M-.zzSۄmUV..HI'`zBݿSPQTF- V`۹D畑[^/9hL NQGݮӈvMLFQL{Q=ϿfY]YE/7n\8/2-*jZϞkztꓔtaoߌ*`;Y|~ꯃ4*$ybA#;Yyy9ܹ*Ϙ(z١B۶rK5ӧzǎ ]tB{z;Yc͌3@NÇ:;6 foo3ixRa|ڭ[d'U)x_| b`n#./)8sW[?ܵk%]]SOB998vum1\o3z1*AOܤ:ly ^oєFЎwB&)*vbzfgK y˸T?zt#ׯp=Uhl*`;u0 ;3[So校T*KfOJmlL42o1? K0ü44F/o:AuOϟoHm[ǏÑmXl綇9V vpA 9](B T-3gҥ3N`rcS-=ݯAn+.~Р4΄ CmmP,ێOz K#XV-u{<3gMMQݫܦrY vCn1*(N?nIغ%0j mTՠl re.o^ncFo ؆UX!ܞri;3?ںJIDib2Zޝr NGpW`k]ïߎɿx毾FbCnV`sڵ>>.K9A6'u3N}7JKyLnKM1ٰ6(uʔQ;v|C9[۩3f|`uux=X"mnWϥg֬t<իn>Li\fk"::ZPcJƏR]0zh }ϤzQ%=ݏUF ؃UX!Fl,)SF%%-/AL__[]Bs[~~z6mQ|ZWIoTefZ|رzvv/Iᬢ˗TٺuY]m6 ~OZVk6٣_>55%% Z*+/ jAn 6*@nCn*@nCn*@nCn*kERUcXmp @԰ +ې@ +ې@ +ې@ + zV`rrV`rrV`rrV`~ r]`m @:?8ܢIENDB`java-design-patterns-1.16.0/abstract-factory/pom.xml000066400000000000000000000033711312550536300224210ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 abstract-factory junit junit test java-design-patterns-1.16.0/abstract-factory/src/000077500000000000000000000000001312550536300216675ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/000077500000000000000000000000001312550536300226135ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/000077500000000000000000000000001312550536300235345ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/000077500000000000000000000000001312550536300243125ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300261425ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/000077500000000000000000000000001312550536300313355ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java000066400000000000000000000075321312550536300327270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that have a common theme * without specifying their concrete classes. In normal usage, the client software creates a concrete implementation of * the abstract factory and then uses the generic interface of the factory to create the concrete objects that are part * of the theme. The client does not know (or care) which concrete objects it gets from each of these internal * factories, since it uses only the generic interfaces of their products. This pattern separates the details of * implementation of a set of objects from their general usage and relies on object composition, as object creation is * implemented in methods exposed in the factory interface. *

* The essence of the Abstract Factory pattern is a factory interface ({@link KingdomFactory}) and its implementations ( * {@link ElfKingdomFactory}, {@link OrcKingdomFactory}). The example uses both concrete implementations to create a * king, a castle and an army. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); private King king; private Castle castle; private Army army; /** * Creates kingdom */ public void createKingdom(final KingdomFactory factory) { setKing(factory.createKing()); setCastle(factory.createCastle()); setArmy(factory.createArmy()); } King getKing(final KingdomFactory factory) { return factory.createKing(); } public King getKing() { return king; } private void setKing(final King king) { this.king = king; } Castle getCastle(final KingdomFactory factory) { return factory.createCastle(); } public Castle getCastle() { return castle; } private void setCastle(final Castle castle) { this.castle = castle; } Army getArmy(final KingdomFactory factory) { return factory.createArmy(); } public Army getArmy() { return army; } private void setArmy(final Army army) { this.army = army; } /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { App app = new App(); LOGGER.info("Elf Kingdom"); app.createKingdom(new ElfKingdomFactory()); LOGGER.info(app.getArmy().getDescription()); LOGGER.info(app.getCastle().getDescription()); LOGGER.info(app.getKing().getDescription()); LOGGER.info("Orc Kingdom"); app.createKingdom(new OrcKingdomFactory()); LOGGER.info(app.getArmy().getDescription()); LOGGER.info(app.getCastle().getDescription()); LOGGER.info(app.getKing().getDescription()); } } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java000066400000000000000000000023671312550536300331200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * Army interface * */ public interface Army { String getDescription(); } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java000066400000000000000000000023731312550536300334200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * Castle interface * */ public interface Castle { String getDescription(); } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java000066400000000000000000000025571312550536300335500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * ElfArmy * */ public class ElfArmy implements Army { static final String DESCRIPTION = "This is the Elven Army!"; @Override public String getDescription() { return DESCRIPTION; } } ElfCastle.java000066400000000000000000000025671312550536300337750ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * ElfCastle * */ public class ElfCastle implements Castle { static final String DESCRIPTION = "This is the Elven castle!"; @Override public String getDescription() { return DESCRIPTION; } } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java000066400000000000000000000025571312550536300335300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * ElfKing * */ public class ElfKing implements King { static final String DESCRIPTION = "This is the Elven king!"; @Override public String getDescription() { return DESCRIPTION; } } ElfKingdomFactory.java000066400000000000000000000027171312550536300354770ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * ElfKingdomFactory concrete factory. * */ public class ElfKingdomFactory implements KingdomFactory { public Castle createCastle() { return new ElfCastle(); } public King createKing() { return new ElfKing(); } public Army createArmy() { return new ElfArmy(); } } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java000066400000000000000000000023671312550536300331000ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * King interface * */ public interface King { String getDescription(); } KingdomFactory.java000066400000000000000000000025001312550536300350360ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * KingdomFactory factory interface. * */ public interface KingdomFactory { Castle createCastle(); King createKing(); Army createArmy(); } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java000066400000000000000000000025551312550536300335630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * OrcArmy * */ public class OrcArmy implements Army { static final String DESCRIPTION = "This is the Orc Army!"; @Override public String getDescription() { return DESCRIPTION; } } OrcCastle.java000066400000000000000000000025651312550536300340100ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * OrcCastle * */ public class OrcCastle implements Castle { static final String DESCRIPTION = "This is the Orc castle!"; @Override public String getDescription() { return DESCRIPTION; } } java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java000066400000000000000000000025551312550536300335430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * OrcKing * */ public class OrcKing implements King { static final String DESCRIPTION = "This is the Orc king!"; @Override public String getDescription() { return DESCRIPTION; } } OrcKingdomFactory.java000066400000000000000000000027161312550536300355130ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/main/java/com/iluwatar/abstractfactory/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; /** * * OrcKingdomFactory concrete factory. * */ public class OrcKingdomFactory implements KingdomFactory { public Castle createCastle() { return new OrcCastle(); } public King createKing() { return new OrcKing(); } public Army createArmy() { return new OrcArmy(); } } java-design-patterns-1.16.0/abstract-factory/src/test/000077500000000000000000000000001312550536300226465ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/test/java/000077500000000000000000000000001312550536300235675ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/test/java/com/000077500000000000000000000000001312550536300243455ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300261755ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/test/java/com/iluwatar/abstractfactory/000077500000000000000000000000001312550536300313705ustar00rootroot00000000000000AbstractFactoryTest.java000066400000000000000000000072471312550536300361210ustar00rootroot00000000000000java-design-patterns-1.16.0/abstract-factory/src/test/java/com/iluwatar/abstractfactory/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import org.junit.Before; import org.junit.Test; /** * Test for abstract factory */ public class AbstractFactoryTest { private App app = new App(); private KingdomFactory elfFactory; private KingdomFactory orcFactory; @Before public void setUp() { elfFactory = new ElfKingdomFactory(); orcFactory = new OrcKingdomFactory(); } @Test public void king() { final King elfKing = app.getKing(elfFactory); assertTrue(elfKing instanceof ElfKing); assertEquals(ElfKing.DESCRIPTION, elfKing.getDescription()); final King orcKing = app.getKing(orcFactory); assertTrue(orcKing instanceof OrcKing); assertEquals(OrcKing.DESCRIPTION, orcKing.getDescription()); } @Test public void castle() { final Castle elfCastle = app.getCastle(elfFactory); assertTrue(elfCastle instanceof ElfCastle); assertEquals(ElfCastle.DESCRIPTION, elfCastle.getDescription()); final Castle orcCastle = app.getCastle(orcFactory); assertTrue(orcCastle instanceof OrcCastle); assertEquals(OrcCastle.DESCRIPTION, orcCastle.getDescription()); } @Test public void army() { final Army elfArmy = app.getArmy(elfFactory); assertTrue(elfArmy instanceof ElfArmy); assertEquals(ElfArmy.DESCRIPTION, elfArmy.getDescription()); final Army orcArmy = app.getArmy(orcFactory); assertTrue(orcArmy instanceof OrcArmy); assertEquals(OrcArmy.DESCRIPTION, orcArmy.getDescription()); } @Test public void createElfKingdom() { app.createKingdom(elfFactory); final King king = app.getKing(); final Castle castle = app.getCastle(); final Army army = app.getArmy(); assertTrue(king instanceof ElfKing); assertEquals(ElfKing.DESCRIPTION, king.getDescription()); assertTrue(castle instanceof ElfCastle); assertEquals(ElfCastle.DESCRIPTION, castle.getDescription()); assertTrue(army instanceof ElfArmy); assertEquals(ElfArmy.DESCRIPTION, army.getDescription()); } @Test public void createOrcKingdom() { app.createKingdom(orcFactory); final King king = app.getKing(); final Castle castle = app.getCastle(); final Army army = app.getArmy(); assertTrue(king instanceof OrcKing); assertEquals(OrcKing.DESCRIPTION, king.getDescription()); assertTrue(castle instanceof OrcCastle); assertEquals(OrcCastle.DESCRIPTION, castle.getDescription()); assertTrue(army instanceof OrcArmy); assertEquals(OrcArmy.DESCRIPTION, army.getDescription()); } } java-design-patterns-1.16.0/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java000066400000000000000000000026241312550536300336170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.abstractfactory; import org.junit.Test; import java.io.IOException; /** * Tests that Abstract Factory example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/adapter/000077500000000000000000000000001312550536300172505ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/README.md000066400000000000000000000060311312550536300205270ustar00rootroot00000000000000--- layout: pattern title: Adapter folder: adapter permalink: /patterns/adapter/ pumlid: DSR14S8m30J0Lg20M7-wEMnDOiPMFDA9j0yyUEtUkzMHJTF7xI1NF4GSLzaxZtncgDVJgCPIpobzv0N2vOKtjgRHTziMI7KBcOXl10thfxB-Nz9dMJd71m00 categories: Structural tags: - Java - Gang Of Four - Difficulty-Beginner --- ## Also known as Wrapper ## Intent Convert the interface of a class into another interface the clients expect. Adapter lets classes work together that couldn't otherwise because of incompatible interfaces. ![alt text](./etc/adapter.png "Adapter") ## General usage of Adapter Pattern: + Wrappers used to adopt 3rd parties libraries and frameworks - 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. ## Applicability Use the Adapter pattern when * you want to use an existing class, and its interface does not match the one you need * you want to create a reusable class that cooperates with unrelated or unforeseen classes, that is, classes that don't necessarily have compatible interfaces * you need to use several existing subclasses, but it's impractical to adapt their interface by subclassing every one. An object adapter can adapt the interface of its parent class. ## Consequences: Class and object adapters have different trade-offs. A class adapter * adapts Adaptee to Target by committing to a concrete Adaptee class. As a consequence, a class adapter won’t work when we want to adapt a class and all its subclasses. * let’s Adapter override some of Adaptee’s behavior, since Adapter is a subclass of Adaptee. * introduces only one object, and no additional pointer indirection is needed to get to the adaptee. An object adapter * let’s a single Adapter work with many Adaptees—that is, the Adaptee itself and all of its subclasses (if any). The Adapter can also add functionality to all Adaptees at once. * makes it harder to override Adaptee behavior. It will require subclassing Adaptee and making Adapter refer to the subclass rather than the Adaptee itself. ## Real world examples * [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29) * [java.util.Collections#list()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#list-java.util.Enumeration-) * [java.util.Collections#enumeration()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#enumeration-java.util.Collection-) * [javax.xml.bind.annotation.adapters.XMLAdapter](http://docs.oracle.com/javase/8/docs/api/javax/xml/bind/annotation/adapters/XmlAdapter.html#marshal-BoundType-) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/adapter/etc/000077500000000000000000000000001312550536300200235ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/etc/adapter.png000066400000000000000000000274661312550536300221700ustar00rootroot00000000000000PNG  IHDR59]F).IDATxmՙ[ZEBivR.Kh%37 \|00`$Bİi;1 !D1,ܐ8Z<8iXI7 e>=]Nz9OzS]<@'(">50qst;$bV6fYO}2'(8蓡>@A 5 N9iH~d5--mv/OPp ק89ԙmvV'BPL}eC"Ijk;_[ -{Y[PVWgW%} ϴ܏'j[aІn1Q-#f?@e>CQ,o -Ti)OPp OJpnQI,y[ky/Û o4+}@$E'!0U!|E'sJcZ=G̟`XOd]rl>!*߬;:d-{\;sIL(O&@~!#m]"tghJvSfՑpKY>gJ gtM d2RÙp@ 5BFj8Sp6蓡FH g }2Iyd7+r;ͤw  ҁ>jTo&q6HG);K>uϵ7>=ˢ%*2Rq 7id7=Dং[2vhTt|6EzPC~8|tB&Йöˏ_'s߷!#52䤑>M]ٽ=8;I (> >vycғ{KlrYBe-JngJI#!I;KdO—[ _ILl2Ӆwgޫʿ/^G,Jg]\QQ4JH>tIx}#'Z}PfO'w~zs(:7gv9r$]:diO궪0(2Rm(}W?B{}O)=`XI.?~ݎ\5Fw.\_!L,\~O>g?ct¿n,O=>0FHMϔ(>џM=tfZG̅3/,o}d'GB,- *M'K)z-$p6HG3}bl7Sk? |tںsl9#~uKR3Y }2)E3 Q&}G}܁/9o>>G_ɃZ$̈́ߟ >BLgJ gtI{o8_z'~{Ż=x\ol6]ܿ>>%&r-4Jqp6HGcI'j7| 'bYĩaԔL)lSǺww>2o,8I}̝8WS_Ųhp6(,'lp#d&ݙw~&d遻^yMIJh;}2Iq{'|mˢE$<֡Ǵ^I33oe 蓡FHMg߁9~E7hwEP'z協!' r}2L;q|MSG{#oj;Wf.8&RNiw9I˃I&in}gW 6P#d3K~}썼{/L@6dM/[ S(A% d2Rr[9u랧o)aFIKtᲇa%SOj 6S{{SS?(rO$#d&[}0{#gX=O0h3@&'j'U} %`s)>p*}miiO$#d35sck}fx,EN?3§N1gkqW?AOo~ 4JwWxd'Έ/xQB?*eɆNXv2:ּϒ>HYl+A/NMZ"sqkx)5BFj=S~O߽>/E=ݨj&ͮ5WH\y kc:xE )'{oxBFjR){=~7dxWr6'Ot )"ert)?w(r{0\r'EoMw\f?i(=z9jͶZK:û/+ov@o'ݝXyX7v'of!#5!B}ރ/{k/8KA: 3jNCLk°ٽ02QۣKOj{H9)wE?R񜌐gwߺk4>'>C 'b^ܩO@? ɂv.73r\1A՝ߖ2T j{32BFj:Sk8#}-<  OU3g>jpl0'C d2RÙp@ 5BFj6Lt&I ֭JMmFr$YC ̟ 5BFj"2Il1蓡FHL!$Y>jh2Il9蓡FHM$q60HM-b$G&I FH)gJvp6Hd2Rcʙ>AޠO!#5)8 tž?+^r~,2&''666{O8 44le)c) 9R[l333/^+l$m$ 855} }`8O!CA'Uq1 ^J[efuuvNfnͺx^Jܜhrr9 s? e  f''l G󣿹 ']{Bnƾh%!~'zY)`ˏ/8V!kCW3+ntF-W[c=qbѣw-8y|Esӧ7X\3;տ;*j-`)$dI(-D>΃荇k?$^@JEi$OBԍtM}2 $Ӹ>Y±;Nt7heHs,eA{9]5:RܚHLNNw,t֧KOs>KѨPgnIoK:O''~քx,,,D^ӈDz} MϪ5vIܬ(} {z+:T6*mM6{<9i`gHBo}:x++N|쑗+1mɒ^~~Ju}OYO{n!h4:l۶mzzcxXn%қlk"z铧C2JuLOK—O)mpItğs8Głx̺/X78j$:k#2,-ѵ=OktAs-F&}*AHzgn_.{jɵ@!#|7j6ݙέjǛI$_?)b˳' >l0a2' d2RÙp@ 5BFj>S)V݃^Vp6(.蓡FȈhh[$oTﯰ >A9HO-2.^XXiKQߪ.S{ c?Aa?ta=&}O~#i )@toKe*n}'X/ ھ}>3%QN(z`j>u+ۤ6JT*? &%!'b 533BOS1Z^^:SeɻMOl^˻ (%tDH[Zq)Wp6Hd2eiǎb455e$\__ũ3`N/}R,'6iKU!{yS)Bߨ=#-„ 9Ol)ũ3hX} 'LmR8D'>~n` WDb<ɖ6, ٶm,K68uTOp䉗wsJ*Gvֹ?@*$6}rPPTaArXQrݾ]d :vY[ n8uRg4 5%WS'UM·KHx;\ZY2lYۺukш%3)L¾QJY:}x&>pLy0UOMutJ778 ^YmH9|۷;vG͉wrԜ~m\HQw@R8ۀ̤s6|JoK ,dI}e^sF̐ pQuLW 2ׅh 1Tw%68222GI9d%EO%p60kj2'Kbb O3 ҁ>jC Y%#ffM/KU%ѧJ9T P7d$A˓%1331EK<*SOP+Ze_L,K]| eOfke[4g>jĜ)J%[Ik5Ion[.֎mXD)2Uƥ ^vs|@)[8#]Tn)"\}ʘ3whQZ-iu] ґ~&n R%T"y-C5o"d&~$}x gtd^?7T6x;|}/ƛXuq6HGFsWCegc5G[yg ce۲S gtdT? v4nk &碷v,BFjЧ~ gtdS?W_v6T:Mɷmfs;!#5SA:2ojʿ߭P x_ íio^5/!#5X[/A?o,0}\Oh$P'C }v[w 3'C }b466V@ 5Jllll۶m}}]][[{w}2Ч*qq055533ddOUblllaaA,,--ڵ+PC*}Yϻso/^w2}2Ч077799u?AX }2婩 K򫟛X>@3ĠbT1HkFT1F{%蓡>UŨ{J dOPp'C }+y@OT1(}2Ч1o^d dOPp'C }/^\[[{/DuM5b4 AȮ~nFuM6bLOOSP*FFsjzkU*Eoq>(dT?׫!//vGuO~Q\.*-Ku] ߟzdT?})n-Z> ?AȨ~n>/ja\O2OᢷLTE`0 ,ɯ~nQ]w }v;Ȓ>T1&''*Ȓ>@A 5b,--mllY>jS>!T PC*8#bOR[^Rc;Gr @ 1T| >@AJR{1@YYY{/2}(=kkky@ƠOPD'OPI'OPI'#ߟzOPD'ҳN\@i7> c'("@Y[[xb{1@陟o4y@ƠOgqqqzz: PzV, AJQ c'3o^d E}(=/^\[[{/2}(=F{P='3==^d E}(=}(=}(=G' ,//>v^d Pz&''* Pz666 HʎXė}Q@>aQyӚ_T P0&04jDii \P jLOKQ#0dxZB0Ey!VGV9 `r s]@}+ F+N,ufU x U;ML#ɲkjk{gB}^VD쪤O|Os?"Ҟ)nIB9pa4)2FYd l/ԓ,O:Ν=Us}'j s'ƿSxZQYcו7f amI}ͺT萵Sp3~b{Bߟ6|OO=ӺU>]Q^O4nc}]T~W-:.>9f}IV5C4 )jT}" 1uF^a4𴄎a(5 C%t s]@W2 <-c" Dii \P jL]xg֧Ƨ6bY~ȆW2xO;~q!K}aǯ!;.5L' F> >vycғ{H #~ȤI)"Fv s]@A5 nOal_>s^UVy#QҢէ܎XyfYOO G>*z~S2:psKߵow_˿Z_~ag9y(?uԶX 4z6'CnggXy7tY"C{>>hPFQZNO/OajfOZy74m_|ns)즓D$2+?+ B UwعH4dmK׈>z6 @5F*cǏMy,?x} U3ot]\쁿BX5|h{/?v| _"6J)U4+EU"Ӂg$?AD fǏS|(x}Οlz3ӢϯG̅3/,o}D'EB1>Yˑ'װ>R>5H7~ST"HSt|;?OGz᭭;6zX"}r͞{;W-O?1T&?FSH5^Fvᝥ޷_>s|׾=~x7PFEH2V]=8'T(QlAe{{5^Fv.yc顇_~T7<ɯ&i=/}MhFϧ5}}l6sg@{} f&?Ze)F>Ufoo8yPˢ% NC B!5F*{R2cbsw>2o,)eIPڨQl1uQle Q#0dxZB0Ey!:.@+ 1uF^a4𴄎a(5 C'")կ. rjkg| }OYZJ}mA2}S' 9S }r{پ}vk8o9dr:b;N*'!`yj郔v;>m'VoK{wMc" ͟*4E4 z$n^7C$B DUf7%3p7\ړ vݴsVȓFyݽզE4'ҧVZ{vdOSݔR-=Iz9jͶ]֒OkLN;/渲F ' i/Z# 'vf7ILؙ !P:(.^ww!GzBVQͺuxmՠU+_%(6b w!'83C*hYRZo)?%b«ם,m)[ }H@''GKJ%!Kْu?U @Cw0T |5rEՠNGZ'Pb%}JtuWQ%OKEq!jt<} XV,i.DP?BG9DݙՒ,1 "y@+ 1uF^a4n/u> <-c" jQ#0TU|OKw5 CUeeeEHȈRxZBǨ$W6aJr >ORxZB0Eb`T;L?byy=G`jjj4vڲeK }B10$ cǎt"a3>̤PCm۶^i្9BA+ UF:XGrūVGmȎaă>*L6=mG74Sb!6d0E60TUFGGeWU?pt@BL}JQ#0dVԥDźD](Yp{TOҧ[ٲNdsEOôWݳ_.!=>r˾ 4&*Į;۬lXn:^O2F735f\q1 ^JbQn[kqٕ W~}^OZ;n蓻,t#kS>XMY[m ٍjǛ^BOՉј _=rxK(S{~77zakOQaBB` ݞZl}_zmÔŗ7lmOɒ ' ٍj5 `C]$Tp\8$?YKјH~Ԙm Sw*@d7.]z#‘MtW>qۉWx#/ W5Dc}j tԂ.1cx#yu"r@ 21TgE&G#:߿筻قKP4vtŅq >0dQjXTu{:'mv'n#!~&;.06^z-vSÐi\I]i,\,\#mJ.S$vֹ?` 2a>mTa4ɾXw 1uGqOQFLcO $CNa(0+ O't s]@Qm^a4Чa(5 C%t s]@W2 <-c" Dii \P jLOKQ#0dxZB0Ey!:.@+ ֫XDRC4O4)24PzcS)F!ӈ4uc7>htTdI2(OKYiL[QGs,M1 @@ZiZoͶSjVE–XybSzcFވU^P_(B;̩>-e1 ' j!C̚!uѧ4W SyꍡOO1UukT.+i*+j4' j)<Ձquѧ(˾Ҙ!e7>hhTOAe@' j$LiIBhQLi eF^a4𴄎a(5 C%t s]@W2 <-c" DilzI "_E" 5 }"80&0@ E}">@y˟VIENDB`java-design-patterns-1.16.0/adapter/etc/adapter.ucls000066400000000000000000000103131312550536300223310ustar00rootroot00000000000000 java-design-patterns-1.16.0/adapter/etc/adapter.urm.puml000066400000000000000000000013641312550536300231500ustar00rootroot00000000000000@startuml package com.iluwatar.adapter { class App { + App() + main(args : String[]) {static} } class BattleFishingBoat { - LOGGER : Logger {static} - boat : FishingBoat + BattleFishingBoat() + fire() + move() } interface BattleShip { + fire() {abstract} + move() {abstract} } class Captain { - battleship : BattleShip + Captain() + Captain(battleship : BattleShip) + fire() + move() + setBattleship(battleship : BattleShip) } class FishingBoat { - LOGGER : Logger {static} + FishingBoat() + fish() + sail() } } BattleFishingBoat --> "-boat" FishingBoat Captain --> "-battleship" BattleShip BattleFishingBoat ..|> BattleShip Captain ..|> BattleShip @endumljava-design-patterns-1.16.0/adapter/pom.xml000066400000000000000000000035761312550536300206000ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 adapter junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/adapter/src/000077500000000000000000000000001312550536300200375ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/main/000077500000000000000000000000001312550536300207635ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/main/java/000077500000000000000000000000001312550536300217045ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/main/java/com/000077500000000000000000000000001312550536300224625ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243125ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/adapter/000077500000000000000000000000001312550536300257325ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/adapter/App.java000066400000000000000000000051531312550536300273210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; /** * An adapter helps two incompatible interfaces to work together. This is the real world definition * for an adapter. Interfaces may be incompatible but the inner functionality should suit the need. * The Adapter design pattern allows otherwise incompatible classes to work together by converting * the interface of one class into an interface expected by the clients. * *

* There are two variations of the Adapter pattern: The class adapter implements the adaptee's * interface whereas the object adapter uses composition to contain the adaptee in the adapter * object. This example uses the object adapter approach. * *

* The Adapter ({@link BattleFishingBoat}) converts the interface of the adaptee class ( * {@link FishingBoat}) into a suitable one expected by the client ( {@link BattleShip} ). * *

* The story of this implementation is this.
* Pirates are coming! we need a {@link BattleShip} to fight! We have a {@link FishingBoat} and our * captain. We have no time to make up a new ship! we need to reuse this {@link FishingBoat}. The * captain needs a battleship which can fire and move. The spec is in {@link BattleShip}. We will * use the Adapter pattern to reuse {@link FishingBoat}. * */ public class App { /** * Program entry point. * * @param args command line args */ public static void main(String[] args) { Captain captain = new Captain(new BattleFishingBoat()); captain.move(); captain.fire(); } } java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/adapter/BattleFishingBoat.java000066400000000000000000000037321312550536300321330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Adapter class. Adapts the interface of the device ({@link FishingBoat}) into {@link BattleShip} * interface expected by the client ({@link Captain}).
* In this case we added a new function fire to suit the interface. We are reusing the * {@link FishingBoat} without changing itself. The Adapter class can just map the functions of the * Adaptee or add, delete features of the Adaptee. * */ public class BattleFishingBoat implements BattleShip { private static final Logger LOGGER = LoggerFactory.getLogger(BattleFishingBoat.class); private FishingBoat boat; public BattleFishingBoat() { boat = new FishingBoat(); } @Override public void fire() { LOGGER.info("fire!"); } @Override public void move() { boat.sail(); } } java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/adapter/BattleShip.java000066400000000000000000000024641312550536300306420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; /** * The interface expected by the client.
* A Battleship can fire and move. * */ public interface BattleShip { void fire(); void move(); } java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/adapter/Captain.java000066400000000000000000000032241312550536300301550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; /** * The Captain uses {@link BattleShip} to fight.
* This is the client in the pattern. */ public class Captain implements BattleShip { private BattleShip battleship; public Captain() { } public Captain(BattleShip battleship) { this.battleship = battleship; } public void setBattleship(BattleShip battleship) { this.battleship = battleship; } @Override public void fire() { battleship.fire(); } @Override public void move() { battleship.move(); } } java-design-patterns-1.16.0/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java000066400000000000000000000030451312550536300307740ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Device class (adaptee in the pattern). We want to reuse this class * */ public class FishingBoat { private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoat.class); public void sail() { LOGGER.info("The Boat is moving to that place"); } public void fish() { LOGGER.info("fishing ..."); } } java-design-patterns-1.16.0/adapter/src/test/000077500000000000000000000000001312550536300210165ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/test/java/000077500000000000000000000000001312550536300217375ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/test/java/com/000077500000000000000000000000001312550536300225155ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243455ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/test/java/com/iluwatar/adapter/000077500000000000000000000000001312550536300257655ustar00rootroot00000000000000java-design-patterns-1.16.0/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java000066400000000000000000000053261312550536300324140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; import org.junit.Before; import org.junit.Test; import java.util.HashMap; import java.util.Map; import static org.mockito.Mockito.spy; import static org.mockito.Mockito.verify; /** * Test class * */ public class AdapterPatternTest { private Map beans; private static final String BATTLESHIP_BEAN = "engineer"; private static final String CAPTAIN_BEAN = "captain"; /** * This method runs before the test execution and sets the bean objects in the beans Map. */ @Before public void setup() { beans = new HashMap<>(); BattleFishingBoat battleFishingBoat = spy(new BattleFishingBoat()); beans.put(BATTLESHIP_BEAN, battleFishingBoat); Captain captain = new Captain(); captain.setBattleship((BattleFishingBoat) beans.get(BATTLESHIP_BEAN)); beans.put(CAPTAIN_BEAN, captain); } /** * This test asserts that when we use the move() method on a captain bean(client), it is * internally calling move method on the battleship object. The Adapter ({@link BattleFishingBoat} * ) converts the interface of the target class ( {@link FishingBoat}) into a suitable one * expected by the client ({@link Captain} ). */ @Test public void testAdapter() { BattleShip captain = (BattleShip) beans.get(CAPTAIN_BEAN); // when captain moves captain.move(); // the captain internally calls the battleship object to move BattleShip battleship = (BattleShip) beans.get(BATTLESHIP_BEAN); verify(battleship).move(); // same with above with firing captain.fire(); verify(battleship).fire(); } } java-design-patterns-1.16.0/adapter/src/test/java/com/iluwatar/adapter/AppTest.java000066400000000000000000000026031312550536300302110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.adapter; import org.junit.Test; import java.io.IOException; /** * Tests that Adapter example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/aggregator-microservices/000077500000000000000000000000001312550536300226255ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/README.md000066400000000000000000000021531312550536300241050ustar00rootroot00000000000000--- layout: pattern title: Aggregator Microservices folder: aggregator-microservices permalink: /patterns/aggregator-microservices/ pumlid: JOov3SCm301NIGQGs7iRXYPa1g8ayB7NjuiKwGvtmBrbKC-Tq_hhY5Y-0HXUjKaS-Kbdepc2HrIQ2jBpma23BvvOTdPfeooCO1iEYlu0O6l63MDQKI6Rp-CKOWSE-ey_NzEqhjH-0m00 categories: Architectural tags: - Java - Spring --- ## Intent The user makes a single call to the Aggregator, and the aggregator then calls each relevant microservice and collects the data, apply business logic to it, and further publish is as a REST Endpoint. More variations of the aggregator are: - Proxy Microservice Design Pattern: A different microservice is called upon the business need. - Chained Microservice Design Pattern: In this case each microservice is dependent/ chained to a series of other microservices. ![alt text](./etc/aggregator-microservice.png "Aggregator Microservice") ## Applicability Use the Aggregator Microservices pattern when you need a unified API for various microservices, regardless the client device. ## Credits * [Microservice Design Patterns](http://blog.arungupta.me/microservice-design-patterns/) java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/000077500000000000000000000000001312550536300264055ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/pom.xml000066400000000000000000000064061312550536300277300ustar00rootroot00000000000000 aggregator-microservices com.iluwatar 1.16.0 4.0.0 aggregator-service jar org.springframework.boot spring-boot-dependencies org.springframework spring-webmvc org.springframework.boot spring-boot-starter-web junit junit test org.mockito mockito-core test org.apache.httpcomponents httpclient org.springframework.boot spring-boot-maven-plugin ${spring-boot.version} repackage java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/000077500000000000000000000000001312550536300271745ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/000077500000000000000000000000001312550536300301205ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/000077500000000000000000000000001312550536300310415ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/000077500000000000000000000000001312550536300316175ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300334475ustar00rootroot00000000000000aggregator/000077500000000000000000000000001312550536300355125ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatarmicroservices/000077500000000000000000000000001312550536300403675ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregatorAggregator.java000066400000000000000000000037351312550536300433240ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.annotation.Resource; /** * The aggregator aggregates calls on various micro-services, collects * data and further publishes them under a REST endpoint. */ @RestController public class Aggregator { @Resource private ProductInformationClient informationClient; @Resource private ProductInventoryClient inventoryClient; /** * Retrieves product data. * * @return a Product. */ @RequestMapping("/product") public Product getProduct() { Product product = new Product(); product.setTitle(informationClient.getProductTitle()); product.setProductInventories(inventoryClient.getProductInventories()); return product; } } App.java000066400000000000000000000030561312550536300417560ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * Spring Boot EntryPoint Class */ @SpringBootApplication public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { SpringApplication.run(App.class, args); } } Product.java000066400000000000000000000033611312550536300426550ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; /** * Encapsulates all the data for a Product that clients will request. */ public class Product { /** * The title of the product. */ private String title; /** * The inventories of the product. */ private int productInventories; public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public int getProductInventories() { return productInventories; } public void setProductInventories(int productInventories) { this.productInventories = productInventories; } } ProductInformationClient.java000066400000000000000000000024741312550536300462260ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; /** * Interface for the Information micro-service. */ public interface ProductInformationClient { String getProductTitle(); } ProductInformationClientImpl.java000066400000000000000000000044501312550536300470440ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Component; import java.io.IOException; /** * An adapter to communicate with information micro-service. */ @Component public class ProductInformationClientImpl implements ProductInformationClient { private static final Logger LOGGER = LoggerFactory.getLogger(ProductInformationClientImpl.class); @Override public String getProductTitle() { String response = null; try (CloseableHttpClient httpClient = HttpClients.createDefault()) { HttpGet httpGet = new HttpGet("http://localhost:51515/information"); try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) { response = EntityUtils.toString(httpResponse.getEntity()); } } catch (IOException e) { LOGGER.error("Exception caught.", e); } return response; } } ProductInventoryClient.java000066400000000000000000000024651312550536300457360ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; /** * Interface to Inventory micro-service. */ public interface ProductInventoryClient { int getProductInventories(); } ProductInventoryClientImpl.java000066400000000000000000000044641312550536300465610ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Component; import java.io.IOException; /** * An adapter to communicate with inventory micro-service. */ @Component public class ProductInventoryClientImpl implements ProductInventoryClient { private static final Logger LOGGER = LoggerFactory.getLogger(ProductInventoryClientImpl.class); @Override public int getProductInventories() { String response = "0"; try (CloseableHttpClient httpClient = HttpClients.createDefault()) { HttpGet httpGet = new HttpGet("http://localhost:51516/inventories"); try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) { response = EntityUtils.toString(httpResponse.getEntity()); } } catch (IOException e) { LOGGER.error("Exception caught.", e); } return Integer.parseInt(response); } } java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/resources/000077500000000000000000000000001312550536300321325ustar00rootroot00000000000000application.properties000066400000000000000000000021631312550536300364760ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/main/resources# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # server.port=50004java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/000077500000000000000000000000001312550536300301535ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/java/000077500000000000000000000000001312550536300310745ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/java/com/000077500000000000000000000000001312550536300316525ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300335025ustar00rootroot00000000000000aggregator/000077500000000000000000000000001312550536300355455ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/java/com/iluwatarmicroservices/000077500000000000000000000000001312550536300404225ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregatorAggregatorTest.java000066400000000000000000000043141312550536300442110ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.aggregator.microservices; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.when; import org.junit.Before; import org.junit.Test; import org.mockito.InjectMocks; import org.mockito.Mock; import org.mockito.MockitoAnnotations; /** * Test Aggregation of domain objects */ public class AggregatorTest { @InjectMocks private Aggregator aggregator; @Mock private ProductInformationClient informationClient; @Mock private ProductInventoryClient inventoryClient; @Before public void setup() { MockitoAnnotations.initMocks(this); } /** * Tests getting the data for a desktop client */ @Test public void testGetProduct() { String title = "The Product Title."; int inventories = 5; when(informationClient.getProductTitle()).thenReturn(title); when(inventoryClient.getProductInventories()).thenReturn(inventories); Product testProduct = aggregator.getProduct(); assertEquals(title, testProduct.getTitle()); assertEquals(inventories, testProduct.getProductInventories()); } } java-design-patterns-1.16.0/aggregator-microservices/etc/000077500000000000000000000000001312550536300234005ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/etc/aggregator-microservice.png000066400000000000000000001205301312550536300307210ustar00rootroot00000000000000PNG  IHDRifIDATx] \(R!lcYK%!1&Y0ul)l!KY"4d"f?oنƈqs߷mݷ|={9j @ tm@ ¿@@ @@ HH![Ot9@G"Q=~B ?ȱH5!@E $@ꄨ Ir, R'Yŋ :!h XA]<{v033whճǎOI kԨWW$uBȱdN>|8{ӧg:4ѱeZZbD/v &SV$uBȱdNvX`hXtʉߟT)V'/_&^U58x:ZťByӫd1_~bll2<_&T'5|pjƌAeLƌ 9"A1]`CkB2Sn$uBȱNOuvnmnnv:̰7AݻqŊfdDDnР&ByIÆ5V&] pU(o,]JɒFɡ<'&f~*I\Hրii0fʡ9Na2$@E $ Oux|$Lh~}lÆuZ"ٲq={W(mw` TjUbWOQ҅ QL:X[X;܉d 3tiIdv8fx$3eHR'-@ H@D ❝[,idffžypf7jР#K*ɯyz:ݑ6:u.\H֐YS 兤NZ9@@!U'ϟQySӧ;Db'9?<,)$uBȱ :!Ir, R'DMHꄠ%c :!jBR'-@ H Q:!h XAN AK " uBԄNZ9@ؓ'zhgffҶmÇW4jTgʔԯzңF}faQ&<|GSٲֵ\l+OOYZVr];qmmkǯ`%Fl7 ,SlR'%`D,D𤗐U@p +fl?"r?l07 ]%KUZ Z5?o`ll4DUO#]QѢEJȑMCժUGݻ jݻ#D򡜐߷ogCâX_:l̙X,^ں.OmHHBݟ=:! {4|㹓7~j<ۡѬ [5.ܤn]KH/~}w"Y3g6a*V,mByuU)իĸHwB_R%޿?ϏM߶mOB>d 3Rr\yҐ5n bN6/$ Zb^II/!v۴؅0{z/F^ c{ ϝ$%a'6CAHݲŏ+0*ʗ/YŔ [|ĉAvݻqjj_LD$K_@]\ڰU"Off 2!u@$\6 k3;ϟ)Y1Ὂ7dƦCTP6== ]ON\@YŔ>nńMUyZ/T'22RvE^b`( 㭬aGJ2SΤ𤗐a@{u<†i ȞfܹxLwoon_)SSf6@>f XVয়6" ϊuzz:(Y"11s =Y3_ӧ r֮j&uB wu)0vG e*]Q V;iGǖX>յ-+ٷouK~DM!OkMW䨆?}:%%A8bmkbUvv'N{`d׮AA{:thCg::|pG=5iR6TfyϏڽ{WȑEq ;89Db :hXsKUjr%E'23SU,v# rlHJ R'ļ“^Bgի1Ӗ,3zX|`fW*cxS(_&s]y +; ǰarr( *G+0رkmgg&īns[,]:vԁ̶U-$sx=5>xrąX(>Db :hXs > )!!-BU۹sdCUO(:!€0yBazCKyߍvXLL\]| Q^|IuMS'!Cfn_€~//gLٿU5`By[(ew5jT/lzBC`Vc-꠱crGtW-۾ƦrlmkgdH6$\~.~>J z,B:#€p`quI@Cql0в 씉ucv<{6q} Zـ^%b^bB]j%˗OxWaLt?WN~sx=qqǎP(O|pJ\XC$0Ǝ1盋kf:sfSffyñJl9s0c 4$\~+!JF~?nZtF@JI{% cm€! nݾHM݀qkWvvVbY`ƍzl̮M(gG>~HNmӦwC{`/_&"0BEq$fOvCA1{Gǖ6̐,B![^sWc:vl֯_WĖ {7cҐxs N Aw ;;v FwT{R?04,ZvY\ըãKk.:?#'8 <߁E1s/-+SrU=m%sT)_(YXy?DcOhHyVuPOR[/]촣׎[{f4!ՓCC͛7Js,-εyW'ժY )<% i@PôΝe6$sr9QAݟ5zu2`#6c{q8dHCvh4^%Gbq`Ϗ4jTgԨ/}|,,ʄڠ-[6433o¦Msum֭mCB&qum2*qphɊ߿P?H7lGfm:? 'D! 0ۜm?AK(1ثS =>q#"G //T'/_&kgE_ߡO#QQѢEJ,!!dLo/nhm] lxt89Uy"E :IOOBҲ+e-f[{,VXs/$z}v64,:RxKҀ@,`R'h ^4dcяNNlFH4snbܯ;/IժʙOLLJ?LG|*}HݺZ,vL(HWP?cDu&4a[ ػw{"]R9C i@ 0BN.tpA#q~1݂=NJ4*]ڸFJ;7?~|Ba䛙bXtqiX)Udff*lUX$&f>}t QHIݟ%zu24r}`/ ^ {ɣg,Kx*ş/0o*p2u^ZP>ŁWϊ2"b6Vyy9U*Js*<|&W'Hw A`, U BN~j5վ]{|$x Z3;Yz, o؋Lة&M*/9@Q:ȑNAS,X5k?uH; ֳukKG=7mfh@DQHIݟ%zu-o֧O'0ʕ3e e<{6v*/_tݺBur2eJ!֬b xf_} M:wnεH@vu~$sA OzBF-AOԉByO討A 󝝌w$_x^ɷ1"}YU/Uq maܑ“^b?AKuB)<%X&b Zb^i@DA R'ļ“^QR'h Ny%'&OHJ Oz.f=#i'uĂ$u@ꄘWRxKh:tIH!ȷo=;~unIݟ%:!9U'MᔥeW׶:w9s Oو?<32 % ZIL)S9;וxrDCm[ȎUX QxK]9/;լYݸ醒|$}<[^u`W޺?8x-/ON0eIOOʣ:t=jBv m“^"WviӽF]YUj4KYe^5hs~},)iMVff&<95LLJ4mZp@ -lzPCٲ?x_ܐKYU#UcQ]?AKF`1r;z>s6}m<6koذ&ǎFϠ/̘1Cr ;Ԡ: [v׍x2K:u 3-^rF3qa5¬;V*ǜo.yo01xJH%b)lv\ ِxs)<}RPNzDM3yߥ#EvRein!!0!a7dB2:e9[y2~} [dz+;˖kӦ ѣ†[pOtZ ZB6d|qذ?ҟwceSU q|d^|IuM 1cĐ٭0b)W_uU(r С=ݻ5*Iz6 4œ ŇHlaV+c7ל?r{zt7oƊ-"@Bm파ɆěOBVdwXDJ1Pr`R%==>n;sڴYt&)$3!iXY! *U*ynVgǢLvvy@׏;F;aC))a*wbUc|%u:9x0][~4i4;G˖-q-@NQ';v,hP~G MA0=_JDDXbB]jt0bwWaQ (*eaBpC뉋[̾*p)qa5¬;V*ǜo.̙M *¦ҿ 7W'ԉ\'DX),sN9Ȩ8.&! b "4By>)UD jYjnԊmr"E l33Ꭰ˄M^Iݟ%dN0a2@n>d+Q;;+ G Bui|V={rf&3_~ nnO?$'iۻС=0׉/!^`ޢLzzZwqi;!{2bD/w-7l!YXC$P:Q9|sqWtج_Pu/F-۷/n?E!*Sx:\1$f=S_,"SX&0p˜˗@155Ct@L@"Ձjٲq& k"E ]Xv{,}{{pO2SO>}*F t.29pXzV&fE-P'9PfE4ʊ¸=Hh*o$Uf1wѵjUf7Kf殪333޾{n]GP?AK QKR@x`sBB&Gd殪Ũ'Oj Zb^II/A R'ļ“^QR'h s"E \C&h NЀ A;s'ļ“^QR'h Ny%'&OHJ OzO0 }asc R'ļ“^œ9CDZZthyj[W(?>zP%68x͓-|S'LsvII kԨNJHVrM7p!JX9HI/ǀkB;;U-Fw҂e&%iݽÓ'ӧO'4^|lpƙ8;_P2psk~ޖm5*MɆg#3g6?MF-|>oƸ9x0üJsf CU7Oݜ??k| srNPvb*z˗U"ioCRxKS.goGBv^ݢ5K6E>qbd>~ a !0/nMRS7w7cMM7muNcKqc1?t>lh&M*U3>wum< ۄSfKbwD'鼛S'0GpD(/ٷo)♓⟩ Ȩ8a) !;OVNg͡{y9Q)fl/}ErG_RxK =& SˑJI-YzƙLNkD5+;0 W(!lbRUl8 F (Tko߄ebDW3o B@?[wo/4ptZ;[tǩ N?sfs3X?9)kC/V3+&ܺJN~e2h"sC#GwF* L8#za0W Ӧ}Ҙ97k` *{7NE`ڵ~ ?!,=n\?7@ '@s,A<? >C ej ͘1/FJժYêU1~cɓXSb 666,3$dRUZו?;xkR%a^lW(VVӧuH&%a22Rʔ)1-,<:Ѫy: ;y\Nh|#,fNljAG1$P 66}uTVDrGwRxK ]6|gmb~_$R؄޾=?_NͺLhHHq ޥz"~6W-[tb9[tN%dK-!;Q:a9/əm!G0`O D4T',&p%'0n"D1o$͝;,(htZ]s/͖MnރtvvܤBA-!?+ə$ӓ 4Bc@x`sBB& /^JI C؉QPE̊ Z|dw \a$'6Hݟ%:Q \#'^b?AKsuB,RxKP@ jB- 1𤗠@Ԅ Zb^II/A R'ļ“^H![Otb^i@P EtmE!CPP?k+ 1$uB(ܽ{J*4|pqq>| )xMϞ=;t萖k[?ҥ== r(ӳgG …(8;_ǒָw([[&] mmkרQiONΞ@ l3zg׶iӨr|t>`pzOb6xy9QŋQjHX {, XҸ a/˗V؄xޝ>?,<##e`WQ˗DZ 1vخ]fddڐ)SԩSڵk@N0}68xG"33S: E;w JwoP~Ym}v^nK6E1o'gMN½e$+߶m^vʕheU_toP9C5`guEH W~Ⅾ [XX=zT׆ Q1X1Cp߾MmbRXl\6X֣GBC7ajY&$+;LRLRZl\aIX F[y2%5my k wZXf常8&5\:!$5k0TEJ8ލܖ7!ip︶ÇS3f (cff2fL_I"T'j,ѹ!uYK.d?sz>|xʕN̙_ek$233}}}ׯ_OcǢ*䧤4jտvڵkuԙ2eʇ41)绒߿: ^RRcEwMOOݰaMV`޼NNX}ExrD~Ɩ-~L`+><ܹU&mۘe޾'66PRp T'&] pb\b{ffJn˛4^w\[HVCҚ5+NSNXs!B$!2hl+KH`Ƙ:[\իʐN4GM@"mk7o .ݺuS(xyyA+Wŋp^H++G&%%-[ Z k/\ ?bo7n`jժ-[5ammmbbҴiӧO#މ' I^|ihh#(|Aƪmܸ)$ݻw%& kk+WM޽{7a„gU]vR'loTXqjoޣ2~AA,-+3 T)C~]Ń*UFJӧ{ F!99z49H+fѠ^{w䋫VMFUPuj4oBl:<##ggL$YX9x0Xsu-ѹ!uF}vVrϞ=>>>333Rlv Q?p~ׯg@|׹rdc2y{{CZq)"(EΝ; KJ`ll|U 6ms玧'֦0ݻCݺuI& ϟykנKΝ;)msΜ9lyIà$H|ǥKB 8۷RJddZnRffWܹ3Kf8FV%nj3j(R'loq4--^M1LX] |"A1l|arg'ŖH7!i/Uw3GjN4/<<Օ۷uT'f-H0MW?pn۶m۶ ˗/ئI9>3{{{A0 2eʰL1xeڴir_S2ֲLlғ&MѣKrʁS( fGj6H"iSE=Zz޽{7$7Wٯ߼yMԔ'uBN IhsW^cmZZx j[>d;pb&*Tw^ǶlMRLc۪UKH> 6H ~͙3gׯL72˟?VVV,={)S-A!WT]v* يa P"믿*Yfa/* p]bŊ \`W&o=!uBN<9sDԉzhsss޵k"Dr[>d;pk֬9r䈽"?6&?>|lKLL477/?ĭ[?bbu2o<'''-UH/^ 7lؐe 7 +Vbu"يa޽+Ydrr2ߩ*U@8^7SNӦM̽Epݺu(f-QN@.o'^:Q ~& Td=I'{nGGѣG^ZOc6A YXX8p@ck|9ge˖STuekPq+YF.\@ԩS"?ܹsHGEEa-)V7oQfUV,}E;Y A:!敤N4GׯV ef olN۷+V\ѣG,'_ƶLRL05o޼VZd:4T'HZ_~]u5kָq ̟?TR^bŊm߾aiw}Ǟ|&|ժU,ٝ}ͱehylEUSbĈƂԩ2/L0$Ny%mC@"H0?&iRVh۶-mBRRR 6lؠay 1$uRpѣG׫WOcٳgj &C\vjپ@wo\)RĀ@9:`BNq 9|Z/**f͚?ֵ!,رcG777M:wB+ !HNNr劮 !dw 2I&wյ-ONy%BNqu !hEU\ֵ!ONy%B3+++Ba={cccum@ԉZ3ZԞ:%x=pܹsUVe/'ܨ3]{:߾M~0չ1I4{ ͛ wܫA%?MK6Lj֬xrɡM&s 28ٳyյmFFON/ϙ?~fuh!`/gsաU=C~/XWcʖ-} r9U'ߟ4H_u`WupxٟI$qĉ?_ؾ}th!9mڴڵk_+T seGE-[6ܸq Q8;_ǒָwpqsk~Vr׮kԨ4a'S'gFٞ=sfS^,}6mU\ozC ֫g!6bIU !jNXhرcY477xnM"/6m_x8;;oܸQ&)sn X:8(^ラ ݻw͛ƛ6ͺs'ѱ% ߸|y~tƍ:II kԨk799IH@͘|4յmpϏQgf.mN0v |DH wwh$VT8~8 {#GllltmAO:5iP}6Z5|, ć t 8opC`e-צM#~}?zt 4t} Fl`k[eBߜ?ɯܻGhNa!$Hnݺŋ Zӽzׯ>|X٫ zDq>b2L@U\uZ S~,=n\M'0&O0a'9ujX?!C\ru5Ќt>l"$uB$##k׮Ε+W|||~k׮urrҡUApрy,wuҰaM7oS+_"˯\9[/X-~L`z,YΝ :Yjr۶Y{bc:s'Dnaau>l"$uB#::Z{R9rVŊ܉~ ?ܺu+({}F#{ubcH {*9XD&p/oᔟLsbի1nn:qcWɒFwef O42\Fz̘C02*ǻk˖-An?A'BR'10hAڮ^666@>!##ĉ-ݻw%%G񧛘_ =W'bwx/z#SXFu666ir2|yӪU-ʟ(<صT5jT>݋+jNN>GŊBt4)i +RLׯ|DH %F)LF큾-O/ke÷.}&E ݻWU2u+U4S![ rnib@7A-(}4b>@f\'YĞ(FBQT{&oA];;wtnҧC4n&krrb~QnAQ|bTJJؓ'bbk-riĂlXrN|\ e\|f:b^)7 ;?0-[ɟ=; իWQX\´n)[2tN޽pOf2eJ]KΜل.g)+ʭ#:!ri4Be@N.˗ֵtwpfLſ>"bu Mc]cHX={IK{y9QŋQX%dlRҚƍL`Vv1$S-rb7F%q>P2SV[G uB+:ti Ӆ(Lց5Li*^&SX:wn3po𙮮mYɾ};[7]E;wnm O>ztti(_>"Z-?7'2#zaqLPnA۷p U/ӓtn^Rn>͡0]´lX$nرrO=< e#QMM_JD.STZZd1IGylcSK!8e:U+T^}MZK6'dh |T2S[GЁ:a{Xb~ G_ań_̊gF%32RT&$`^͛[cv(_X#xD)7I0]´lXD/mήV!!޼IRgAT 3GGGڵ声Ϊy?sf -wYëQݻq¯rlN1Z .cDZ-+,)ʭ#:_V͂r/ſ?^ nl)\ ˖-J޿|xx։9|CWt Ӳu`M uxDskss'IfM߼y2Ŋb>1AEv?~2`cdBy5S>.n5޻͉?F+YS뱳PJ2SV[G7uiggUEP.]ZLuheoVFN 5'y}ru" D>x01RŜMFpQq V=!!!c pkֺ(7m0]X´lXM0?F gر6lQGlٸ=+e*_)AEHgϴgULWXmFNT/IlN1Z Y$3eEuMɔٛ7PZY 7rPk+9S'Y]FHNX[t,Bb޼-Wp_hK^G }C´ôlXsĴxS8lb k֬>f,U$?лwGVSLOBXñ1d3IϪ9hRʭ#hNzDM3yߥ#E!!iƙl䖼+;a~VВ֯Nż~8v@/.T' HTϧ9d)L˄u`M s'ϊe"pS9eP89PPn!{ub8??h<Ed DG;6ʓl䖼ku"Y۝;qw -!,l:_ܵkaXDUBu'Bu"tJ#Q!?MԄu`M@NN/ʭ#dN,x ?aT%IK755NL\бc36rK^Vsٛo+Nx1NlҏA|$]!L찕(XTI6ckN$(CMԄu`M@NN/ʭ#dN:(0/_!?$:FJ5jTq C:4R'Xd/fG32Rʔ)Z[Xa!hllj*XȞ.o⧡:jri DM([:Fwvz}J7cBXz(J:4쭞b /tb[yZI!䜚>~┛OsP&jB:& ''4}xܞEb$k߼IVbaAAkժw;Mnރtvvwi!)7MԄu`M@NN/ʭ#<ؿy󜐐IMŨ'Oi}:G9Sn>A e +'ݵ&z{ H#G燚(gʭ#W|CKS&rց5o^3{&3"䫔|.Q P`ffj>-԰k1*)Hjnj|*/ Ƕ8HJ4GV.inS'Y!cb'پl-ac\fD9Wqb aڵ%GFU]r]ƍǾ ڊ7vF(\T|_ )bv\С NןǶT,g[G uB+YM+?؝ky#B T_vqlۆ b^|ųa-W:m޼Uc1.nqr=Z5 d%7os|LMU(?1f͔Tu?*6c K~]جY}0-Ny|CҟlGJƵPY!c*N6oΛ8ʜLr@噇!ϟiԨΨQ_YX AA[lhffbo߄Vյ-[ =dTߢOb_CSW7oތE$[+͡\mgcS ^ٙ^ىz,F%Uٯ%K`mm]`+U*_+֞}^T4nlվ?, 2eJA߸ԤI|U-H/Tlu-,}NMCbHJ4إ?NX?|k m6bjk/8*DG<"ف5O;}GDI2];;,}4%-Rg !3gz3g6<}:U9?/#:+eǎM汈!/lsd΀C(=tf{w,U$IV֪WdXv zLM62*Φ" "w!ɩT_5{qJ4YEZMaCZ*#0!^ ={v/x.VBͧ9.i+& =eWf;;+/qMa HpGd9;&Pq!:G|p"[DnCUZ+gjI'}#+_Jf#7; ;ujP ʲs]mM<M0f[A;wo/ҕ*3:;\য়6bqѢo0UūWcJ嚕*uvJ"V 'O!.*O5ً}"9Lf5تKH`ߟTT,gG(hu2gLe 1Bb5j8qbg#Wryg͛[_%J:.\rr(k|CҟfFHE5*!ې@=i> ܹ2#iH!,gs'n[y&r i]"3"0}:q?)c,֓- ՉkUvbnݿ㳽},#a NPL| 1 Q?f/N\4RBPhl9 B]{7N"uJ`ğ̊/o<ؕm[liz+˗gVܢqVkH.nwXLM0w0$y4@ ϲs9U "ف5omCzmv깙}izGG߭*.9Ol6Mܐϊ!FD*//g*:_ëT1ggrE-naQ۽{QVD* -v [ u ^NUCâݺ}jd8!Y5 Q q׍JQL`98~?\:HJ@$^"pѸ2q|[m Ka}üqm ";I adTĉPnOBB~yUǎ4ٹu1e ]=:z fvvV/}e׮X@Fd31탼9}vϞENXb58mCҟlbq66 0TG\|;8HESA:rv`Moy8ӏL {V|wVO޸@y =Ti&uʉ( `3 BTcС)΋-bt": {d_`ggglB+R\ASu2r&{$kqDڷJ4fׯx QQNy{wFQ`fΪsz@d" GOstl9;,ԩC]"x&Q-:Um/-ZX EܩS3tE$.bp_W׶lU߾7oƚo4 ΄2\APZN KC2l5{\|P( aÚ0X*Fd9;&;gv~}fہ;ކ=ںa#7rFnAe_ awr@gCa FV*L ̔ܩ5֪&H` |@pFPhfe#& CMm^*/LB̮ѳ`)_sӮT,gGH4(fKCO-G*vZQ<.n1z>Z XaޠWv$kK?Kږ-'*5u?+T'eʔb0I1g !}E0$@VQv5hSC޾ [<ԉ!ҟfǏg'4_⚆c u +'aqSqQqyļک|ٳkWA>v{8vFt}߿0ܹ9SFp'ɵ:\L K KUEhfe@ܹP77ջ0 ~#JoHryvɄK=8CLa3arQ9fL_LTTݸ\ڰ;6㏣Z$D.xP 64uv 1wVdMᎻ8cǍ#ys'7:ԉKp! 9+I3qMaqΏ7/[caDkSwW/DӧSO9p`R ɉEuɰB :D̩g5jTpvn͆U&clggu:VӦb م=EJ֡CS9M-l9Kż-[4T' bM>)SM,,{w"(heHvmR_!!ʗ7ׯ+m|xʊYYU[x΍QlXre÷.}&EYh`J1 ĊkO32's"͛ !,}{`V"tx9߽K~Yx)7MԄu`M@NN/ʭ#hD=H rff7aE/yTܹÂFתUy%,];;#Qri DM([:BŋQ*߼yNH$~ɓC9IriBlXr^uN44Qց5991(@ꄘWͧ9ȥP 11L**wL\WEʕuGkBv Z-5$@ꄘWͧ9ץ)LXҐlXh;n׉͑.Ma:Ǫ͗d@rH.]Z?=wn۷cuqiӧO'.8bmkbUvvs޽KF0ߵkaPhL0Cgޕt>KZĖ6UEHKHPGQ" XKbk-FڪZ**i;9d3O9sfof9wr.RFK׷ի=zxwԼ~oÆJ\W|n>t^sY4x={kd̘^^^ Tcx>v}2eʠ6'Ep MR2ks~{rlO=;6C;23Ym۶_D̷߮O f[]G uB-EiK0iX؉tD̙qf 6Mt*;crv {||8E{ߑ eȥ9ܞQ0aB_x@ ][md:ŦV'yrɫhݺ6m^۬L3{c{3\Ucx>:IoNa1*HiFcmeveӧ;~|ʔyDi9> ܴ#Ղou#9+# ̂0raZ51 ";hې A:o¯V?dGׯǎҥ>Ђ{CYm82r(ԕ+}|뭶N;S8eGҪV-ƍkCpN2&RZhX[9]Xq^ڵe@FFjA򷺑u2y h8XXTj*G$1dWYT= ]L& YD曕ѵPa٥h>!wii4L z=no=rd ?u^pN&OcO%рx,Oiq E3J-x-[siҤ6xn*\OFN$Se,zgK2U$%dGib ~8]XBe)-hڜ߮ȑ#"#1zÎU-HyYV7:1ucуcǜl]u"?Iq*хj?Ce4ܥia0- Jb>|xdx@xvO>gU7nWL7[#DbXnڴ.*0 ҝ;L#dy4C~~MG bZ~.-XBe)-v{6+sƬ 0 '┖…bVvn$3uyt4:ae/oBxsRdnZ ,bΞ(W'`F//_>}ڷF*EC<^VNpxS'$V> C|RٿBNRDOXV3gφ SY3uQW^xy*YG B%CUX5 yeay4ܥia0-끞ql0.=OϝT\-["Ooذ&;ڵ%K:a4ǂ{|nƍ\}!80 .CCbsgg+&]䃱ϟ\֭Q1C0uO3Ln/Iְ*6v",CxN  ,0e  QҡCSɴG-Xdj]TEN/bT3Ǩݢ',GSv [7@e%~<׉Jai%u`=7^mܸ6P՘lNThA:7o˜N.I.̛7ǧ /_>qX`)bre/;]Tq0"bd/ʲXر0r@z,ڐm˖Y$:ٰaj:/HH`"wq)۷vmw40 )LU꽼UbB5s54cṘmefݻҥK:0}nu`=='Da:5[퓢uɨgxl%"J3*hܸY5LL3qe8/_N2S'P'Nĝ=wkbЬQ ^$0bn3c1KdEL$=rd/߿E||8$_SKuQjv\Lfe߄ }]]]ކ:-ȟ}na6:p0ցV#dN O g?;D_Ņ2uu?"-5ܮ] p`?dZ6M>bd1͚c/&nN\ԨG^|E^^q1Diɳў11.]JRUϞ>rua4 D=ցW#dN*1 !dTX_\"R󨳳Sj|̠^^ :ȣGWI&R .Rիz fŋ:`5͉qϜID߂7+V$ݻﾋG=4t /]J`}Zb9j],ˊP5^Uf;ۻ! >-]ky[5lXm#@E_ߡNum栁:uɠ-Z#,jGCY2̦UT58؟Ƙ? fh\B.m۵kR#.T'`T0'"+?ٝ L\ʖuz l%J aD2mLP;y  ʺX4^Ufֹs ֤ۿDRVd \\J.۷GgNa4pPXփ<|hw~ vz/Eɡ, [RR So{3bdӰ2GҔ1nrj]TɋP5^s\6wv,n]8s N7AD<`#(8G1OsS ^%1ϙye/&"ܼKI$4pPXrrb^QgvJU_Nз_רQ޽Br6o^ U5*8s#GVtҒ_Դi]xػ y0'~Ĉe8{zz8 aTCb`պ+/Biv_}OZVfڞ~~MoL2ݛ +c팦`vf"T\p氫[7ׄ,,+Ur'O:+=Im Q?~>gN{U33hA:yK(?]>E 7v>7^P<~:`B[v7n._ŽeCCn6…-N+VLt))(׷d:bv(L̘љ}~_Kk˕+;Vaԃ33# ,0e iC8Cguƒ%Uz//v*׎+!?OT[7@ 0{s6)kμܧ9m7yBkPXփ\:9^,l\y{7d"/,Y:K)fAYIғL%)R9%e]\g-#R'FM1sűRLJ1114}N*ɵfͪbǤ.#"Kx,Ϗ? _aa9mٲ>@N6l"1;Z9ñ\\Jp']]20Tx->uQjv|W\ٞ *^mX|.?)eTMlp}n~#(_A zU%+XmUPÆ51HK,,Yb:OaU$[1-|T#,Q?,uZQh!ku2=C6[/cpHyǏ'LꂡgP'Mꏙ|2/'&FgY8892;φ3oQ8ntN{cLhx:qZ{yk}Z5se{LHO X<@Vv0ܧ9m7<ׄ63(g YUΛ7ǧ CF3'|aɨNEc4[1~ra 5篺T]+#dN O g?;X (9y6|~TC`O嗫0]&,!@'}/֮ c.$iGӬY=yb"Uu\`ûW/իCqZ{yk}Z5se{b8P X|Ϟ>7YTME6>aoUl&1u`=ͪ qfa(c/,uպWzfK8{%_X2T'u͖p#6 pD9ƪ-,,EYA[3,rGXԎ0Z-Hy;wnQjy8MiN OrС%,%P!G\f`T0'"+?)LZ _ɲ%JaD2-CaG%zN^:fbmuxKe],ˋPӪgV:6 8!GYoV;rT\d氷۪2zMc zU%F 0'|aɨNx2N,Յ͖pJG/f~uRkW- ^.UIѲ*',uc2G؄-'}q9sA@@Ml߾nݺ?4ibرND֭m|}} @/; `8rHʕ322xK*E 9u떐`IR' {f?!b{f%͚51c!&Hj޽{fAAAV2$AL4h믿ܹsg͚5۷/SQV$R'wߝ8q2>::zСo ,ϟ?/D;vܩSm] `kprr*]tƍu2k֬ 6:t(55W_5:A @Xs/D )H̋/C@2I&nnnE5:A GpQw^ooo-"R'-h++\\\hCO@@eDDD;wh+!{ uB iV `̌"t"%%YfF[AxR'ŋnnnF[A X >|X^=_b@@Y?^~@ X H~1h+NҌ@&A@@Y̞=h+k_աC5{f{Q l @ ӧ;w:!l˖-?@2@@M߅ _ ! =2dm] `}vDDVBN@@ nV5H~!11h+m=1NٳCBB  p D\+6L?K$}A$ Kv@ H'bŊ˗/mA :! NR'ŋF[ANoN1 {C ߎgpour.UCC֨Qz= ׭F::! ;@FQ>,*ls=~3*V;2I߾~~}'k:rdȑ0U2H .lu% NR';wRC^zr׮.\آ)=NVfͪŋ}L uÆ,eb`d ^\}{:Q搑ֿRW|dP =<*"(eic$uB7N#FxPg&hDrru ]0To#|;cf,eo,Y2^5= UjW'9_Ѣ;O/Y7*cX>w:i3$uB4Eڣ:.ncsCڑ\ܹz:SCukݻsq);UqBRԫjW'9l<&)iÇ@NTAiGIą- ڤ=zBԉ19yv4"yCO#˗AڵY ~~M%SRMk AK&uuu)U!G1HQT7RH["Y#IX)irJ:D5rVMFI 9fd\aZ /$_4ûW/իC%Ӗd+V0brzǩ0Z 111Ka< _5H .z=zKR'VcV3jpe&"GvB2ۀHi\0MHƹ`U?'zҥHClDo}m6QloVj A\XJ{}[lbŊ@p3~jr5UڴiCJ(ƿ badƽnN}~TsdTA )c o4H .t=z־Gԉm[Ho=KIƾNV7{㨌C:! @i 7$uB$NR'qa(ѳR:! 'YI A\J{$"p:! ;@ih$uB$NR'qA(:! 'hY|y۱:G]A1? A\:!BU'B Y3rܖ f)=JcT03p-ԙέ|~Sݻg$CTò67eVN ڧ:i0mض?=Kl1@)T_8:|ᅊs={ =sï~6rd`FƓR.];w~TK(H`e:2;ԪU?޽sYVY:! R'DCh_[9,eʙ'IS' 1brLJ6Ͻ:T9}בrժ|T  ׭ G&L苺e5qff{[>vmwL}ѥKKzSW֬^f %@XX0Y͚UoF(|2ƽAA>?_r[JSSGYT Шťc7ď ‘˞|◗ofҥKR>zFA|bb H3hPg!6A3Z:!Xhڡ:Ol*|t~ ygPHɝ;͛{24t;(VHOJʼ9 391^{&'N2ab֮ =%y\boܸ6mڼ&N5`^O.Yҩ\R^%J%MJubZz^=]B"|.R0{QZZpB1+#]&JS'fKhxĒ?~+q#ݽi4sl?rF&MfO!H`M{VD[ݎg0\A'Fy/}SwRW72հ<=S'nne8ŋx6wυKgl駭 t\naL?\itu"4awa5_!5lr9.g/£F̛5Kdz`Zz9Mlo]{ŋǯ_w "*7UMhf#u,y:IN~rwCFP!#ܴR#su L0X2`Ii~$X>7!Ͷ m{;Atq[㣋~irzp[6lx FX WZ7^ݿ,^Tql˖H\+Ct0?g#(ȇ}ܒ:Yf W' ֭9j'lƏp9hPgv)W'֚ՋM-㒵e;dz UBY&攦=PZ:aA=QQpWƵ{'6\\DA:Al &1 R'kmkm=m~;¬s \=ed>ˆypp`XSJˆ,a<پN6G]޽BXs>Gf};,0W>Gmu’} KDZzS;jKv14/Amx1p3, 4j߸ڵŋu9 Fvsiݎ)Rw!uB&8=鋷n{ql6=qy?ΜdK {؎gPJ--d޹:+e^AT)-YC1L_߰Cٻ_B٩O!]yaJf p9iRN{u):ɓkf: Y k::N>/Ym$d:PB6Hn5 ЮEVy.˂ \dIoZ ȑ(E KA7;KoB=;$@/>df@~S{ .!; *_%ͩ7~+ߝ4uڎYpA"<:;6Q!w-  ={#xpn ˔qF^ݴ]FΖ:P,NHqϴiV-߯G<{Mm^T6+v<[R0o= x"3i-urnZ3hX7߬D<ڟiSK …;Ȥ?z[3xU6SÞ2XX6*<([_Uj恖 Юx*HS1oQ  D($ D dz-R=;$@L]˦LeԦ 1.%؎gPU'+n1Cޘ {/˛H#fԘQۈd?[v+Ɠys36oij @׸vm{n%DJFfݐ};E;=p{'c]b ʹԦ iC S>c,{؎gNgD:CR'q@LS1gSojӿB/WZm~; 1UA A\(PܸfbSFŕMx1llN A\vq<~<1*Rm.7iT\Uld#cAckVA(8Ią6eMm:X1PV*H'T֭uѢ 'v<[u.$uB4 ݻ>|J3ge= f;:Qp:! @I~2!a:qbgrvܹ^gm!k|{(ƶg%I'rNN\ӹs -dmo#uB D"CCtnU>_nZ۷ fOyaѢysσcx۶͚:N6o5L2q~Vǧ͛PJUؿb6z5GNׯG3PUomѧ΀1իW޽{.+QqϞ>53WϮ]L2( +0͡CKT+*HiFcmef9>{:vlwdf6۶m^o]۷jAv;$@hIgl:"pLBL̸Y&.]~pvR||/?9`w9ȿoPN?O78uQJ׮0ndrv3hݺpv '2#ƎlsssU f'u};(kXl"Yە9O} RR^QHHM,g mC Nԉ~Ӌ,~y(~Z?)&)_'t;KUu:wv1em82r(&+Wi%[oeS_қmP8Ӷm$271<mܸv@ ZXBe)-hڜ߮wҵzʐt.lQZCk#N22T Rn놶! C n[Cɷ!u۷GO?m=4{{J.y-D^h?l'~ &ږ-clҤ6xn*fnv% GSA 0čfep/^~(cx>II3.>x?<&Ŭ f?nh`]0DU=|kR')08m> ր1zzz`,O9{ W'7nW٧O{~RVoọOMaNw"0u;ʏKTwt?FWϣGiӥkV؁*Hi:1ks~23g;q"Ni\\XP Rn놶! օ GO51h[oqOk0L?,?Ű3ey7߬e Ī1fĘ?Z5o"ek4Y{-AA< A\`=zi^E[mwƫ]lܸTcu;1$uB9@i=R'IO:*[Y A\`=zG/{H A\`=zi^E[$uB9@i I A\J{=j`]pWuH{􌢃;\D@N‚P!$uB$NR'qA(:! 'hI A\=!odzUP"K#AzwB$MzwB4 !"p:! @ h8I DCHiJ['4|ak?d! Im#{[x}ޓW"`n)>hWW4o}.=NUIBUXΨHEv m#I}NC@Rt.:Qk^ 84tm.\bŤK06Bb̔e:o9S/S'_L3wrbc'޸cfXߺ">30 ,0eʠ_lȐ:4L"ɩș3 :&*jO?mESR;ÇΞM.9zt͛(j5U ժUPmm7;h̒%BC~{lUE^ǎ퍇8xp 71[7C1~$Xl{㞱}ysu)nt߄1\>\{XC%܏JiӺ,q-[gdÆu"1crU~ťKoڵY6\jB£Gԩ9 C#SֱS.#TKQ5l2W4T&alk֬ Vf, rd[3z7_A>mݻҥHD o y9 C{V'>#>d2a ĉg7bkȑlψ9 c̘^FJu"Nà (/Tuz ^4S'-X[, Ud)D˗iL nZa~zIM@ќ/'f,§IϜI 'N7;~$Xlx^)/"}yzhqJ{ýSqHyFL~/\#"kׄQ nS'i֬x1q˖HiK :Q5@nv,r凵jU@Lb vRjأGiŊK0brJu4ǧO/ eTnUu섻ϟ::pRrgڳ*wHuV7 uÆ, |R6ioW{.xv//âR<ǀQcM|qHy= T`5 : u.˗0w[]<"OGx(R0dO_WYU^G?1P-Œa N*^լYP:CC= ḸP| =a)[fQU'xvP f_{Ɠk׶gڰa/XO~$XlunAz%K`~}_}B͙Br0,*,uA[3,rGXԎ0Z-Hy=89\9̋?EΛ750 1ٿ%a? Gv횠!B!UРA jU6m}.e) Ǎ{sw߫Ο?%С%j4:y2(\h32\\J`O~$Xlusvn*d>9? !#psϕm//âBsy/Eɡ2- 9=JS+r7n7@ٝ)U OqY҆¾Z͒Y:,\Xa08^.N†7߼yߓ9?0(gwh~192q{1@~ϙ^A )GmI!$u%7o5ۻ!TO<{vrru>l6W'ʺHϧDPN(Hki))wB^ٯei튤N :yMOϝT\-["Ooذ&;ZRH~B;=% OaUd|ٳGM$O*?dO?mexKye+OTma{# ubԳOкhD̛ͧ7r|D6wi͎r27;uy>_.15/\(OTma{#{ҿ?*e'e: gڳ:sQAƽ'Oas걑fS9uպdy>%=2)if"ϜI^Y:QFR'qao:QݔrF gڳ:sf||8?)3..͝FZ\v*'NuZ,ϧܼyzÆ5 pWVNC A\=NTw uÆ,uQW^xyN=32 D;##d, 3|(4,*ryĦSj|L^^ ܩzl ɨNx2N,aw#G%JcA7:! {۸ǏS-HrpdxպˋJ#jGh Ѥ;OP{rӢ guM!5=!ƞXR',աϪ.LCԮ펬 G`bڵa:Չ+:! {۸Չr&rvn*d>uQjN=!ЌII3>,\7۴(I A\=muxKe],ˋPNT3Hܹk_g"I{`lӢ $uB$NR'qAj]TɋP5^sԹOPa h8ImO0?IH4N6Ym` h8I DCh@AdE~$XH@ H !A(P$R'DCH@ ! b :!uHX{C ߎG  uH@ b @ @@ XW@OIIENDB`java-design-patterns-1.16.0/aggregator-microservices/etc/aggregator-service.urm.puml000066400000000000000000000023301312550536300306570ustar00rootroot00000000000000@startuml package com.iluwatar.aggregator.microservices { class Aggregator { - informationClient : ProductInformationClient - inventoryClient : ProductInventoryClient + Aggregator() + getProduct() : Product } class App { + App() + main(args : String[]) {static} } class Product { - productInventories : int - title : String + Product() + getProductInventories() : int + getTitle() : String + setProductInventories(productInventories : int) + setTitle(title : String) } interface ProductInformationClient { + getProductTitle() : String {abstract} } class ProductInformationClientImpl { - LOGGER : Logger {static} + ProductInformationClientImpl() + getProductTitle() : String } interface ProductInventoryClient { + getProductInventories() : int {abstract} } class ProductInventoryClientImpl { - LOGGER : Logger {static} + ProductInventoryClientImpl() + getProductInventories() : int } } Aggregator --> "-informationClient" ProductInformationClient Aggregator --> "-inventoryClient" ProductInventoryClient ProductInformationClientImpl ..|> ProductInformationClient ProductInventoryClientImpl ..|> ProductInventoryClient @endumljava-design-patterns-1.16.0/aggregator-microservices/etc/information-microservice.urm.puml000066400000000000000000000004171312550536300321200ustar00rootroot00000000000000@startuml package com.iluwatar.information.microservice { class InformationApplication { + InformationApplication() + main(args : String[]) {static} } class InformationController { + InformationController() + getProductTitle() : String } } @endumljava-design-patterns-1.16.0/aggregator-microservices/etc/inventory-microservice.urm.puml000066400000000000000000000004101312550536300316210ustar00rootroot00000000000000@startuml package com.iluwatar.inventory.microservice { class InventoryApplication { + InventoryApplication() + main(args : String[]) {static} } class InventoryController { + InventoryController() + getProductInventories() : int } } @endumljava-design-patterns-1.16.0/aggregator-microservices/information-microservice/000077500000000000000000000000001312550536300276425ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/pom.xml000066400000000000000000000057211312550536300311640ustar00rootroot00000000000000 aggregator-microservices com.iluwatar 1.16.0 4.0.0 information-microservice jar org.springframework.boot spring-boot-dependencies org.springframework spring-webmvc org.springframework.boot spring-boot-starter-web junit junit test org.springframework.boot spring-boot-maven-plugin ${spring-boot.version} repackage java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/000077500000000000000000000000001312550536300304315ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/000077500000000000000000000000001312550536300313555ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/000077500000000000000000000000001312550536300322765ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/com/000077500000000000000000000000001312550536300330545ustar00rootroot00000000000000iluwatar/000077500000000000000000000000001312550536300346255ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/cominformation/000077500000000000000000000000001312550536300371525ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/com/iluwatarmicroservice/000077500000000000000000000000001312550536300416445ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/informationInformationApplication.java000066400000000000000000000031101312550536300471530ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.information.microservice; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * Inventory Application starts container (Spring Boot) and exposes the Inventory micro-service. */ @SpringBootApplication public class InformationApplication { public static void main(String[] args) { SpringApplication.run(InformationApplication.class, args); } } InformationController.java000066400000000000000000000033621312550536300470440ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.information.microservice; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; /** * Controller providing endpoints to retrieve information about products */ @RestController public class InformationController { /** * Endpoint to retrieve a product's informations. * * @return product inventory. */ @RequestMapping(value = "/information", method = RequestMethod.GET) public String getProductTitle() { return "The Product Title."; } } java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/resources/000077500000000000000000000000001312550536300333675ustar00rootroot00000000000000application.properties000066400000000000000000000021631312550536300377330ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/main/resources# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # server.port=51515java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/000077500000000000000000000000001312550536300314105ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/java/000077500000000000000000000000001312550536300323315ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/java/com/000077500000000000000000000000001312550536300331075ustar00rootroot00000000000000iluwatar/000077500000000000000000000000001312550536300346605ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/java/cominformation/000077500000000000000000000000001312550536300372055ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/java/com/iluwatarmicroservice/000077500000000000000000000000001312550536300416775ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/informationInformationControllerTest.java000066400000000000000000000030571312550536300477400ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.information.microservice; import org.junit.Assert; import org.junit.Test; /** * Test for Information Rest Controller */ public class InformationControllerTest { @Test public void shouldGetProductTitle() { InformationController infoController = new InformationController(); String title = infoController.getProductTitle(); Assert.assertEquals("The Product Title.", title); } } java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/000077500000000000000000000000001312550536300273525ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/pom.xml000066400000000000000000000057161312550536300307000ustar00rootroot00000000000000 aggregator-microservices com.iluwatar 1.16.0 4.0.0 inventory-microservice jar org.springframework.boot spring-boot-dependencies org.springframework spring-webmvc org.springframework.boot spring-boot-starter-web junit junit test org.springframework.boot spring-boot-maven-plugin ${spring-boot.version} repackage java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/000077500000000000000000000000001312550536300301415ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/000077500000000000000000000000001312550536300310655ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/000077500000000000000000000000001312550536300320065ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/com/000077500000000000000000000000001312550536300325645ustar00rootroot00000000000000iluwatar/000077500000000000000000000000001312550536300343355ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/cominventory/000077500000000000000000000000001312550536300363725ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatarmicroservice/000077500000000000000000000000001312550536300410645ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventoryInventoryApplication.java000066400000000000000000000031031312550536300461050ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.inventory.microservice; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * Inventory Application starts container (Spring Boot) and exposes the Inventory micro-service. */ @SpringBootApplication public class InventoryApplication { public static void main(String[] args) { SpringApplication.run(InventoryApplication.class, args); } } InventoryController.java000066400000000000000000000033271312550536300457750ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.inventory.microservice; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; /** * Controller providing endpoints to retrieve product inventories */ @RestController public class InventoryController { /** * Endpoint to retrieve a product's inventories. * * @return product inventory. */ @RequestMapping(value = "/inventories", method = RequestMethod.GET) public int getProductInventories() { return 5; } } java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/resources/000077500000000000000000000000001312550536300330775ustar00rootroot00000000000000application.properties000066400000000000000000000021631312550536300374430ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/main/resources# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # server.port=51516java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/000077500000000000000000000000001312550536300311205ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/java/000077500000000000000000000000001312550536300320415ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/java/com/000077500000000000000000000000001312550536300326175ustar00rootroot00000000000000iluwatar/000077500000000000000000000000001312550536300343705ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/java/cominventory/000077500000000000000000000000001312550536300364255ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatarmicroservice/000077500000000000000000000000001312550536300411175ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventoryInventoryControllerTest.java000066400000000000000000000031121312550536300466600ustar00rootroot00000000000000java-design-patterns-1.16.0/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.inventory.microservice; import org.junit.Assert; import org.junit.Test; /** * Test Inventory Rest Controller */ public class InventoryControllerTest { @Test public void testGetProductInventories() throws Exception { InventoryController inventoryController = new InventoryController(); int numberOfInventories = inventoryController.getProductInventories(); Assert.assertEquals(5, numberOfInventories); } } java-design-patterns-1.16.0/aggregator-microservices/pom.xml000066400000000000000000000051011312550536300241370ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 aggregator-microservices pom com.github.markusmo3.urm urm-maven-plugin ${urm.version} ${project.basedir}/../etc com.iluwatar aggregator-microservices information-microservice aggregator-service inventory-microservice java-design-patterns-1.16.0/api-gateway/000077500000000000000000000000001312550536300200405ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/README.md000066400000000000000000000016641312550536300213260ustar00rootroot00000000000000--- layout: pattern title: API Gateway folder: api-gateway permalink: /patterns/api-gateway/ pumlid: JSox3SCm303HLP819FRUXg49cO542_nOyFPncUvUSszHwhbpMdyT4TCt0CDLcyIHdtGsEZLOez8vG7ek33JuueLbPvUcPM84cpeCz2S0fvI6mGjluA1_b-Tt2N5D6tNcw3y0 categories: Architectural tags: - Java - Difficulty-Intermediate - Spring --- ## Intent Aggregate calls to microservices in a single location: the API Gateway. The user makes a single call to the API Gateway, and the API Gateway then calls each relevant microservice. ![alt text](./etc/api-gateway.png "API Gateway") ## Applicability Use the API Gateway pattern when * you're also using the Microservices pattern and need a single point of aggregation for your microservice calls ## Credits * [microservices.io - API Gateway](http://microservices.io/patterns/apigateway.html) * [NGINX - Building Microservices: Using an API Gateway](https://www.nginx.com/blog/building-microservices-using-an-api-gateway/) java-design-patterns-1.16.0/api-gateway/api-gateway-service/000077500000000000000000000000001312550536300237065ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/pom.xml000066400000000000000000000057151312550536300252330ustar00rootroot00000000000000 api-gateway com.iluwatar 1.16.0 4.0.0 api-gateway-service jar org.springframework.boot spring-boot-dependencies org.springframework spring-webmvc org.springframework.boot spring-boot-starter-web junit junit test org.mockito mockito-core test org.apache.httpcomponents httpclient org.springframework.boot spring-boot-maven-plugin ${spring-boot.version} repackage java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/000077500000000000000000000000001312550536300244755ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/000077500000000000000000000000001312550536300254215ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/000077500000000000000000000000001312550536300263425ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/000077500000000000000000000000001312550536300271205ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300307505ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/000077500000000000000000000000001312550536300315215ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/000077500000000000000000000000001312550536300331625ustar00rootroot00000000000000ApiGateway.java000066400000000000000000000044521312550536300360060ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.annotation.Resource; /** * The ApiGateway aggregates calls to microservices based on the needs of the individual clients. */ @RestController public class ApiGateway { @Resource private ImageClient imageClient; @Resource private PriceClient priceClient; /** * Retrieves product information that desktop clients need * @return Product information for clients on a desktop */ @RequestMapping("/desktop") public DesktopProduct getProductDesktop() { DesktopProduct desktopProduct = new DesktopProduct(); desktopProduct.setImagePath(imageClient.getImagePath()); desktopProduct.setPrice(priceClient.getPrice()); return desktopProduct; } /** * Retrieves product information that mobile clients need * @return Product information for clients on a mobile device */ @RequestMapping("/mobile") public MobileProduct getProductMobile() { MobileProduct mobileProduct = new MobileProduct(); mobileProduct.setPrice(priceClient.getPrice()); return mobileProduct; } } App.java000066400000000000000000000064741312550536300345010ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * With the Microservices pattern, a client may need data from multiple different microservices. * If the client called each microservice directly, that could contribute to longer load times, * since the client would have to make a network request for each microservice called. Moreover, * having the client call each microservice directly ties the client to that microservice - if the * internal implementations of the microservices change (for example, if two microservices are * combined sometime in the future) or if the location (host and port) of a microservice changes, * then every client that makes use of those microservices must be updated. * *

* The intent of the API Gateway pattern is to alleviate some of these issues. In the API Gateway * pattern, an additional entity (the API Gateway) is placed between the client and the * microservices. The job of the API Gateway is to aggregate the calls to the microservices. * Rather than the client calling each microservice individually, the client calls the API Gateway * a single time. The API Gateway then calls each of the microservices that the client needs. * *

* This implementation shows what the API Gateway pattern could look like for an e-commerce site. * The {@link ApiGateway} makes calls to the Image and Price microservices using the * {@link ImageClientImpl} and {@link PriceClientImpl} respectively. Customers viewing the site on a * desktop device can see both price information and an image of a product, so the {@link ApiGateway} * calls both of the microservices and aggregates the data in the {@link DesktopProduct} model. * However, mobile users only see price information; they do not see a product image. For mobile * users, the {@link ApiGateway} only retrieves price information, which it uses to populate the * {@link MobileProduct}. */ @SpringBootApplication public class App { /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { SpringApplication.run(App.class, args); } } DesktopProduct.java000066400000000000000000000032721312550536300367240ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; /** * Encapsulates all of the information that a desktop client needs to display a product. */ public class DesktopProduct { /** * The price of the product */ private String price; /** * The path to the image of the product */ private String imagePath; public String getPrice() { return price; } public void setPrice(String price) { this.price = price; } public String getImagePath() { return imagePath; } public void setImagePath(String imagePath) { this.imagePath = imagePath; } } ImageClient.java000066400000000000000000000024361312550536300361340ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; /** * An interface used to communicate with the Image microservice */ public interface ImageClient { String getImagePath(); } ImageClientImpl.java000066400000000000000000000042501312550536300367520ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import org.springframework.stereotype.Component; import java.io.IOException; /** * An adapter to communicate with the Image microservice */ @Component public class ImageClientImpl implements ImageClient { /** * Makes a simple HTTP Get request to the Image microservice * @return The path to the image */ @Override public String getImagePath() { String response = null; try (CloseableHttpClient httpClient = HttpClients.createDefault()) { HttpGet httpGet = new HttpGet("http://localhost:50005/image-path"); try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) { response = EntityUtils.toString(httpResponse.getEntity()); } } catch (IOException e) { e.printStackTrace(); } return response; } } MobileProduct.java000066400000000000000000000027231312550536300365220ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; /** * Encapsulates all of the information that mobile client needs to display a product. */ public class MobileProduct { /** * The price of the product */ private String price; public String getPrice() { return price; } public void setPrice(String price) { this.price = price; } } PriceClient.java000066400000000000000000000024321312550536300361500ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; /** * An interface used to communicate with the Price microservice */ public interface PriceClient { String getPrice(); } PriceClientImpl.java000066400000000000000000000042421312550536300367730ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpGet; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.util.EntityUtils; import org.springframework.stereotype.Component; import java.io.IOException; /** * An adapter to communicate with the Price microservice */ @Component public class PriceClientImpl implements PriceClient { /** * Makes a simple HTTP Get request to the Price microservice * @return The price of the product */ @Override public String getPrice() { String response = null; try (CloseableHttpClient httpClient = HttpClients.createDefault()) { HttpGet httpGet = new HttpGet("http://localhost:50006/price"); try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) { response = EntityUtils.toString(httpResponse.getEntity()); } } catch (IOException e) { e.printStackTrace(); } return response; } } java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/resources/000077500000000000000000000000001312550536300274335ustar00rootroot00000000000000application.properties000066400000000000000000000021631312550536300337770ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/main/resources# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # server.port=50004java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/000077500000000000000000000000001312550536300254545ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/java/000077500000000000000000000000001312550536300263755ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/java/com/000077500000000000000000000000001312550536300271535ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300310035ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/000077500000000000000000000000001312550536300315545ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/000077500000000000000000000000001312550536300332155ustar00rootroot00000000000000ApiGatewayTest.java000066400000000000000000000046601312550536300367020ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.api.gateway; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.when; import org.junit.Before; import org.junit.Test; import org.mockito.InjectMocks; import org.mockito.Mock; import org.mockito.MockitoAnnotations; /** * Test API Gateway Pattern */ public class ApiGatewayTest { @InjectMocks private ApiGateway apiGateway; @Mock private ImageClient imageClient; @Mock private PriceClient priceClient; @Before public void setup() { MockitoAnnotations.initMocks(this); } /** * Tests getting the data for a desktop client */ @Test public void testGetProductDesktop() { String imagePath = "/product-image.png"; String price = "20"; when(imageClient.getImagePath()).thenReturn(imagePath); when(priceClient.getPrice()).thenReturn(price); DesktopProduct desktopProduct = apiGateway.getProductDesktop(); assertEquals(price, desktopProduct.getPrice()); assertEquals(imagePath, desktopProduct.getImagePath()); } /** * Tests getting the data for a mobile client */ @Test public void testGetProductMobile() { String price = "20"; when(priceClient.getPrice()).thenReturn(price); MobileProduct mobileProduct = apiGateway.getProductMobile(); assertEquals(price, mobileProduct.getPrice()); } } java-design-patterns-1.16.0/api-gateway/etc/000077500000000000000000000000001312550536300206135ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/etc/api-gateway-service.urm.puml000066400000000000000000000021411312550536300261600ustar00rootroot00000000000000@startuml package com.iluwatar.api.gateway { class ApiGateway { - imageClient : ImageClient - priceClient : PriceClient + ApiGateway() + getProductDesktop() : DesktopProduct + getProductMobile() : MobileProduct } class App { + App() + main(args : String[]) {static} } class DesktopProduct { - imagePath : String - price : String + DesktopProduct() + getImagePath() : String + getPrice() : String + setImagePath(imagePath : String) + setPrice(price : String) } interface ImageClient { + getImagePath() : String {abstract} } class ImageClientImpl { + ImageClientImpl() + getImagePath() : String } class MobileProduct { - price : String + MobileProduct() + getPrice() : String + setPrice(price : String) } interface PriceClient { + getPrice() : String {abstract} } class PriceClientImpl { + PriceClientImpl() + getPrice() : String } } ApiGateway --> "-imageClient" ImageClient ApiGateway --> "-priceClient" PriceClient ImageClientImpl ..|> ImageClient PriceClientImpl ..|> PriceClient @endumljava-design-patterns-1.16.0/api-gateway/etc/api-gateway.png000066400000000000000000000436231312550536300235410ustar00rootroot00000000000000PNG  IHDRTHGZIDATx]Օ[<"҈+f.B G+1u 1qB@&v<8c;rl6·s!n]`M$3h$`ntGǾjW]ݵvUZTU׫Z3 JU jVBGZL1?H^5"%~ H\X!S5<\X!S5<`vw imߍЃAl+yV5jbЙVܫ3-7$"}/?:dCVEjdK&vmd`eoU\&m*CM[Xa*Xyjjи^ "։ Y|5jŽFW}}݁saw/\CMnƏ]f߆oW/cp`?Uv¢p¿ff;y* CrcAz*FVG,>uJ5yɅ ;N.~w߮lӚĎ_8[p`Kf*^KpM:WjP).VV'LAqa V!@z+ kTv߱fƭ?_z+'v=J޴8{OM`%Бe0' x0Z:v*"Vl\X&h^_5o]_-GZ 0*b6Iɛ1j0kX`kd?g9ݱՐ+ 6-Pf]|MaNT hTXToQ$` 3?<,Fsm*G74JUsG#c<JHmQt "K#BJLf|VE^Ja2-SPi1hT^t1Ԑ3mZ,ُ~%m|MУF4khBqA<ᙹm.с 9V `&`COVo"1#" `ۥQIf\sGʶ$hcߞRu4yh+-嶌QnWBx~;|/ 1fa۩V#h'#Sф~+D9H&1mK AXKݵ^o"F<7j;Z]t;F1Th5Th5Th5Th5T+V|5Sw̏ Vd:kui"ؐXѦVd-r_GVY|fy` `Edq}RN|h"Ob5dq}RNh "O}Y|\,;,ͳdqa+Î]ۍjlSe½4֚-Y|\JiG o5InwaFXaJBEO)_0I"0TPK8 6^z}u%¼3*c7Yk0 -0OB LJ M{.c4oxe7 6T`ekZ"].pI4Spo{6y&LR#Xʬc KFgVMd+UzGQA@ K/⒚Ih$d1q1b%~g䭰_&a7ےh?tգ'DWm5ی.i)Tz^S5*gĚVAV>D|F*̥\,khm*FP&Xؿg?`d[P^g Kȧ~k `?K$FMb]"n`VLcdOA@MoX[Ln?󏝝'/?4K_D=Ey}}5w&ANa]>x2XaCI|SUBVɫvR"A`%=¡W7 V^4CZIb Df7GPKz昼V:54_]2Xw[v+xw'nUTՂY==:yVjx@XjXa%7`Xњk+;Xњk+;Xњk+;Xњk+;XP+ 0/FBGku|3 ¼3 'X|ԢjbܻbٝtC'=*eXt4C\A`20[mL%߂mS*eX}j QB͠I5q%:r3Fə?B .%`eX@=BC [z$P-GU7o?)YE*lZ?Yk E*@KAH˵{q*K"W5!\RCY j9yI9Xke5W lcJA_\DKMr\=$#R THWԠ^5HG_򛷟Ӭ`fhHe5WB һbm(Ai6#!Cy.`~r֌rS24k22@ ]1Tj]jI㹨;ʳ  j9yI9Jkv96|`eW]ka͠woOR2B$v# W2Ppɫꏪo~RNl-dT [;d TBEfj)tV*[G51 Ch~< i)̂V/eh&3ah`Jeh!vh+;XR:Zdt O 6T%Mf83Fj V*;`}~b+;Xњk+;Xњk+;Xњk+;Xњk~ 칺hyt# m%iv]wXTks|6@b˓StmťPvu &6 `m fWV:>1oVoNʹnו'*f͵2 SҽaPͼ#iW3vYixC%,V&X_A`'L"KJc(1'-X?Qbj;,fkɌ͸c_8E2 S_A''Bv}RNd1!tj W_,:4x2v]wXI9Jk+dk.A>OÐwbȻ0|.L^A i<ږ>'\;,f:Z ]!i`=\O%&[ީ3/Gsqʕn%u 6KD R:ZՓڼ(; &fځ g"'R5LSٺ.]TQ@c `myz꺏=ڸ `mys΅3g> h557|(9(A*SG10 P55vYQ/ 4Qks `ͥիW///} M{: X(T`u#B+W} S:X} X@9СCwuWGQ0 ,5G$3g\ P kSm8|4@ ֨͒ *d(TpT,XX٪w5`hʕ/_@$XV0GB뾂@BNqF!%8ZL.8qb˖-uEjMz׺*0+X*At$1,U [>2<"1Ԫ XA8l*Ε>+Vh8ɫ< `mV54k!a@g5ժ+ޫ(  `mf5:kQa@O5լoDn?,vrC@<_#рOTjVZ)aQ.\''{LY/k(Uks `5޻+&d_tJ%Q Fڄ8CpE&A 2ueUw7։6V*J3[Ș JF`7XL6׮ϼC7 bX*T( y\@ VZv`0pMKVAR8}"e V}3NuRUY ħc'YU(Xl+Vp8G{+c쨀պakJk xVgIy:JBScAs>CW |k"ÍE# 58U _[I#!9ٿ`xd P(9u"s/) S iv ]*x V'*a;7n\ZZbx;K jc|8c;YX-]JP1Xy+AreafE~4!,q0mgk*]%(m@@aUH N*XsU0/ 0l@&`mpmk-[H:J*J>Xk V6Mrʺk8qk!<?a>=XRAEq:Pw)XlϣK.իW?裟gpkZJUpT,dVY_&2A+ciR(GC+*&v3?)%5E*ŋ>Ҵjlou& j4bjUcVcY<X'l2j#UGpcb}y+P![Ubz8LfBoc lhL=`S4nm%UG*PK@ւ J,`J}d`-3gά[nʕᰕTnv  DHBfVpV, 6R,W]u__#ՍQ Bf#aShL7 U Mٮԉ.&D|#W_}u[:Xݘ` Ԫ ]V%0yNY`->Gk;֎)B}ƩJs_Vq*Al#X=TXY]1`߾[kNuUnV9XG%Δ{6o 7{CuZ5` #kؔ8goũmĞy$'ք7!.q V߈U{dZ_Gl'Iʍ+xicU6+zOye)`ͼ6}ψuS*SKCq1d=gl ~u6QD U&`r-]wl?޹n5cw|tKbz7d_mwX+cAd4+ke\үɅUtLEc暽+O?CDs?۾VfU+@YA&}f- ZlrY-P1+'4Bm29s;uM?z`l?dLթ3*ZlrYXi*$*y.jfs.~¯ ?!2nXBr\B2$G`Z.®}kvu#̅w)Q`-6iUs..Vkb`)`s..*UWw Ep~trkc|8z8ڐf]D?J9'\WmOMw0zށ|uTxkdii`Lf+A/p {/eμS`y`|+102jk[ `m+'rCA<_'‰ka&v;[2Rl_ŽI;iG F:{B`a)K?,~= ;ؔ0<(;Տx"X$dICg#D|MVo/Q!%v+[|WWr[ @Dx؍#w?HyY ;N1ؗcDEjœ9XA !t+B~q.rya`rG TىI?p86ݘL3-8L~b Nh'氨A` #D9ӗ$ij21i& V}+Vot [T?\)fnGDZp.;h̰na/>3ڶ H)bs9SNn$_S[Twuu(3 ]1q:Y~!Q[Q{KlS%M1;up5vc#!$ zHQ&bjS +%Mlb9j&bv`Յ 0Ǟ+bdSNֶ`sISNֶ`my9+V|-LuZ =:y9c}rX}6Vg^x}O&{ [ /pU?W}~so4?wv 2]%z;S_3*A|tcXQzGEꋕ`g۞vKGO7|3=ϑ׿4\8׏ xJ^/U\EJӋ`5dƫG˻3<#)c@yB9Q~y>׭>k `<[7-n}dw~S_vOtnbF։׏Ѷ(&WprBzנZ){)"/<5׸^88~;%\ˆ^yq߻~; J|ԛlqZ%1PnPܸ_q =b5G0}N#'68@ݥMk6;~Oo{Á-ZĺD3{ `e`-*I|fIm':*~Ņk+Xy-}3W W>[?~56n"֫_9W?{~:/I#Vn6!bUke9~;%W=C۾vr߿ZcvW8t/#X[n={nol-Y(SO>7G1Vs ۴5S<]x?Lz3` `m7/yKJ5M< U+ +ZVa6i|PĴkn?󏝝'/?4K_> 8] І Xu(@e_ͳRV l^M.P@L^}'p}{~ 5Lv3M<h2&F=|dV;d>KsC>{Qʔ9M]Zn8t`%vߩoH"Tic~.VX]&q S)KN<'k+qImxrmTSl:Mg|ogy06X&1 &7U?1Xafk[`U@OW:'`W&ob8h.=[vU./7 ,XVPR"ax'Nu¼KWuul래X}*A*Dc?Rܝ ` y qr+F{l۩6yq_C=[Ng+wb,#a PZ.XSە&^=AO4,{QW XöSd-D3 W/ Vؤ˗> ԪnzD=W[X})`0 ѣuGjU7Ri̥}-[n V_lz+W^t}8ݰ`Ŧ 'N *y177wF1\*wD7n\ZZ"/W^]26]_n5\o{HMrд_n:t]w߈Tx"VDMڵko!{{]yGXV_fɈիW///r<^ `X}旛;w*  "/7KƩ*rAXL?rtUVvϜ9S&`B_nvܹ`ҙfrD.)Rn*$u`r Q. M./yZYڏ `-]_nU:X ,KzC䄕*Jr-BC"^@j&kV Lˎd5zM| U?xIbHVG4V_e}+[b%K #ebi'N/r UQΈ}k|#cGV#/@cU4> O [Z65;)>Mh̓W XǚpA4,DVɫ+AUjbZ `b& ^S^&5YVѺ& ^S55C}(xM BTV/!i5E+0ZDkV/!i5E(]Pگ"VD^ O)XV ^S~ O)*ǖɮӯK PX!ֵ/Jzȋ PX3اijh])XVاM4%ZeN jZM(7w<> o8}ʦ ODŽ`hSj k$%ْhHZe bqR F(xM '枽x$-YG|~/DR-MUcUP+ l*'Ab|fSF% `U)`Z!i5E6n?󏝝'/?4KC)eu b:,Cg] aL^}'p}{~ UIwKUI&L1>_2M j~WzژG}(xMQV݊pA [AT݊B}(xMZh])XVا+A% `Xb& ^S~ uM`mXW'T҅JtP:k p1znmkr}zQ[ke/Jy5Yp>`V RŊLyTȤ3* bV;XMذgt*B"8*Y S U*!4t/wa\~`Vϭ^  l2Ԯ$,_v8nyRA9!\޻nyE JѼܨ]9^*DckX1싔'*alN JO X ҞcJ6kH5@fjX g d`^V^"|e,W.ZYpq(CۊGI.%p:xbWkn4rU0j1ɿ`f0e+  .1lKFWT_~H ~J+ۗ,^A.On\S?X˘#0`5}.<-j]rUmo瓭[zz#/ri/^Ac.wIXU]|&5 >zAoH[h*3A qߕVd;\Mkl:=u$^A fū >@m8mH} X5wr;nﮀdF{tx3xu_6*K`bցp1znk+ `mJX[n֖4znk+/^x}O'lՀAnJb<&7XI7̟~ן}{lݧw_F].4W#`Y)  ;]& 6|'ܷ/ݽ?Gkjk zj+ZJ5Kz5IdykOJI;νߝEb~]YX#I"OOtYZb?~_4Y5W=ݗ4%b)ǯ XZDMiAE )Xo{rn۱/]>䥷|o^кuvؗz~#gon +c EJD0[n}Uqh]|W,iVX[iuϏ=n❛}_,{fv33WV;VG`Eו{c[>ȿ;xځ*]`:V `V ` `V `B~:mT}E^N+e^s IGǩkǍ!e8;tc tgt S {8ݰSr4hmɧ6=ʮ W;:R3qZ ":)j .Jgv;X8GL^nH]&đmhcjz+VV( UrR(%bE &m.,7\ZVPRb_w*VčctQ^;DaEK]Lrok]T_e>ʶ$h)& ZY^X*6yD:sM_ݮIk8IOe9r|/ 8ðTu1,AYW`J WcMVbRw*5w`my5ʯH8.s^VϽBv6V ` `V ` `V ` `V `+Ȱ[JL WP+ bJtzP~P~P~aasa /DXV `V ` `V `k<>Ovş~/__~Ʒj+\Yk}VyQpe-Z*4RIpeZ/X=7ʯBuesMXG(/oBԕM^UX ~o3N* Z h'M!+בQ2d" \}+TDzz3 VhA8{A5q$tgyge:r_C-7 z_"T$M?Baw2i0k^W iV(z |bًG;Lޒ!lI`"F(ȅI *CqGeI_~B yRP-;j&++/GZ%O&q`+ʞ6Kޒਗ 3z ot0yGGYFF5+1Vs +_OV(zw>3w#{Kޒv!9PՔiǞY;X Ҷ$mw W6X|w{q~Γ% vl@ PI7WS;pZ2h&X 2P6\ZP~嚼tO~+y1HvM2yU!#I3i NU^Wf5UBvN}ޣC^ օj5u+Snrʖ`VZ,ml-JBP~P~P~P~P~P~P~P~U q1='Sȸ\7o+ue^AP5^NMAMlӖ>ҟ}TZ2Pm=@Z+heTȝ ~rklZ呸`c$÷|ĕ׮\[jVDTA OE[aIoGA'2 NiYՕ+}r|+TJ v9'w`BǶdcLCį"uƬՉ+=H,v@m? R+(і>eHig" mX]f`JTIT1 ^N X3SsL?Qz`(+@? *Tȗ ~r ^5y"Nu#9uOQ-X]2eL^VD^AiE+`ՀWzg WY8PQǕ2>Ee`4/ java-design-patterns-1.16.0/api-gateway/etc/image-microservice.urm.puml000066400000000000000000000003561312550536300260720ustar00rootroot00000000000000@startuml package com.iluwatar.image.microservice { class ImageApplication { + ImageApplication() + main(args : String[]) {static} } class ImageController { + ImageController() + getImagePath() : String } } @endumljava-design-patterns-1.16.0/api-gateway/etc/price-microservice.urm.puml000066400000000000000000000003521312550536300261060ustar00rootroot00000000000000@startuml package com.iluwatar.price.microservice { class PriceApplication { + PriceApplication() + main(args : String[]) {static} } class PriceController { + PriceController() + getPrice() : String } } @endumljava-design-patterns-1.16.0/api-gateway/image-microservice/000077500000000000000000000000001312550536300236125ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/etc/000077500000000000000000000000001312550536300243655ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/etc/image-microservice.png000066400000000000000000000052071312550536300306510ustar00rootroot00000000000000PNG  IHDRi NIDATxُE'1>1 D1Y2@XpEpg]dQdW #"1"'$`!1/<>WG3;=SSo&=5u}WSLllFgl5 K}6rg3fk )XF%a K}dX#R5 Rw6]Ml#Ŭg5j5Ha`eڊ%òU A]**x_ő2aⱕJb),$!عp!ѩ>B0*gs!PтcpE ti YaBg !"KTSmtL4K,UV5mYډm7r#|;P#_B`YfgW'Yz6T=́2C+â%}ʒ?i$y&e%rj_{BmvO}+}~/Y6;#Ggi[>2,a K}dXdY^qu3tɜKaB^f] =nO /J%{gZ~t.ݱ~>]=3vP.gDqohRDXBC yxvdmX#Vؙ)oX.>n\v/.y=(8~}&eV.K:l2G(UImYLq(**T> qbmc#!)c8RTa1tna+BTw<5?[yxhr8F2] p[E2TƹpW^Ȏ 6DfmƝxJ aKGR1)4&tⶎ]^{mןv&O?{R~.x=EfHSHT8qӺt̒H$ʌUt._1{N9}kǮ.,60.XSn,}ʒ+]Z’f)f,,^?giqG9;.w{L}pIqB󕲌44~0dJ1KxF?.<}.:¡.U%j/Qϱ_g$~2b[::v/<}O_05\ȵpwDv[ŶEU^ XҿU9VtpN1bC] Npݔ ˲۷j΅|>(&ˬ!U,KzʰG>2,a K}R²*Qgѫ֯u*AY˒; =(SŜe9,gtbv|όi$~ufIT2aMkx!YH$ ""U՘,6~e*J sZ( \~Q3ZQ\|fi_7w~USfN.*Vl6[*Xyrr M7F"1K1B4WQ,j)c5*! gʩAY˒]K5KbR\n6ikFǃ, -I(U2E fdqeH/`5"U"OfZe`5Y)RȰGj=1[m@إ&ʘ6VȰGj٧7죏2F>;OuK+˩yUe5H-+R%& vS,(hcbųO",Uk791ff*b_WϹ5g9~+_Kr-qwh"^E\ EU ȉ统@_$ :;yXߗO}>ȺcׇW/[} ZI@E_֐P;{ 1p! QkiҺR)gXOBo>_v|@5Kadrh|8~"–t"[@O]XJZ*%le,5uOlt>+VR^j)*dɱ I]]ۧ[6&LvX 4X#O'(n ,BYFB?Mt>W8 ?;U<&U-D},Kz9u jVU}bس;WgOkO|'HO滤SS>2,a K}dX#RQ,K D(/EX~Vw,2 ұyit^jRW ' '@xuf~qh4]lZ:!uf˯ `uBRGo@ ;0bJQ O Ay 'd W*RrW"VƲFϘX_e,8~YVᄠd)2s]% g6ǯODG7`#>qU ,U?r~ $y<jYjXF)Q?:9!$9H)`iȰG>2,yWS3nw57RͰg-/KIENDB`java-design-patterns-1.16.0/api-gateway/image-microservice/etc/image-microservice.ucls000066400000000000000000000026641312550536300310370ustar00rootroot00000000000000 java-design-patterns-1.16.0/api-gateway/image-microservice/pom.xml000066400000000000000000000052771312550536300251420ustar00rootroot00000000000000 api-gateway com.iluwatar 1.16.0 4.0.0 image-microservice jar org.springframework.boot spring-boot-dependencies org.springframework spring-webmvc org.springframework.boot spring-boot-starter-web junit junit test org.springframework.boot spring-boot-maven-plugin ${spring-boot.version} repackage java-design-patterns-1.16.0/api-gateway/image-microservice/src/000077500000000000000000000000001312550536300244015ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/000077500000000000000000000000001312550536300253255ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/000077500000000000000000000000001312550536300262465ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/com/000077500000000000000000000000001312550536300270245ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300306545ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/com/iluwatar/image/000077500000000000000000000000001312550536300317365ustar00rootroot00000000000000microservice/000077500000000000000000000000001312550536300343515ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/com/iluwatar/imageImageApplication.java000066400000000000000000000032421312550536300404230ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.image.microservice; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * ImageApplication starts up Spring Boot, exposing endpoints for the Image microservice through * the {@link ImageController}. */ @SpringBootApplication public class ImageApplication { /** * Microservice entry point * @param args * command line args */ public static void main(String[] args) { SpringApplication.run(ImageApplication.class, args); } } ImageController.java000066400000000000000000000032601312550536300403030ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.image.microservice; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; /** * Exposes the Image microservice's endpoints */ @RestController public class ImageController { /** * An endpoint for a user to retrieve an image path * @return An image path */ @RequestMapping(value = "/image-path", method = RequestMethod.GET) public String getImagePath() { return "/product-image.png"; } } java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/resources/000077500000000000000000000000001312550536300273375ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/main/resources/application.properties000066400000000000000000000021631312550536300337620ustar00rootroot00000000000000# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # server.port=50005java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/000077500000000000000000000000001312550536300253605ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/java/000077500000000000000000000000001312550536300263015ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/java/com/000077500000000000000000000000001312550536300270575ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300307075ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/java/com/iluwatar/image/000077500000000000000000000000001312550536300317715ustar00rootroot00000000000000microservice/000077500000000000000000000000001312550536300344045ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/java/com/iluwatar/imageImageControllerTest.java000066400000000000000000000030021312550536300411700ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.image.microservice; import org.junit.Assert; import org.junit.Test; /** * Test for Image Rest Controller */ public class ImageControllerTest { @Test public void testGetImagePath() { ImageController imageController = new ImageController(); String imagePath = imageController.getImagePath(); Assert.assertEquals("/product-image.png", imagePath); } } java-design-patterns-1.16.0/api-gateway/pom.xml000066400000000000000000000047701312550536300213650ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 api-gateway pom com.github.markusmo3.urm urm-maven-plugin ${urm.version} ${project.basedir}/../etc com.iluwatar api-gateway image-microservice price-microservice api-gateway-service java-design-patterns-1.16.0/api-gateway/price-microservice/000077500000000000000000000000001312550536300236325ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/etc/000077500000000000000000000000001312550536300244055ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/etc/price-microservice.png000066400000000000000000000050141312550536300307050ustar00rootroot00000000000000PNG  IHDRiSRD IDATxoE/14N 4ƤQB )RV %.T*`[ҊhĊF $-P!@7WH&Cbronyn6\3;7eX3 O›?٘>"& ɸ@r-kIbCQ.4ƹ_ of)U^xZe4<), Oaix ̄;oTڋTQO(n#)C*jy?eD) <2Ä& c!P ӛі#̤ nDZN8('$a!^\|;XD^i$4lP# 6ݡBҫy*AY 4gA ^ː4033 ðD栽%tގ,"Z@f ,HH\Oe2|Z(¼KSEa0a9_St4+ -Ǘ'rKB\d"+<۝O 看65Q 篈6 cL쮃T`e/H2w"g%a͊ jXx=Oo4L} X"3 [iT ] ٍصE S!t|k-̬/ )ʌ#& Oa 4<),99s#`-OUt4<),9<=`QݦVySOkSW*k\l#&+E~)2txͱ>}D=dB)ܣ 9<_Zmlvfҹ_wdw 0$7E摋-njo~3veN+gr;Yx0 I`q䴲C=L4 5IWÓN҇3ؗU_>~}|G"Z =sOFmH=,v.]1 ' Oc*ﱾxO|G~{- J{2^tl!n*]FҀt_6u1,({ru';yxnUvxYR x{::{6 'tc-S~96ԙR&H!xW7zš_> /Āgƌ2иC؀҇͒o,4l- X\m9WN^ 6*ԭjOVD), Oaix KSXf\/?`p1}NL#[:JOfI/Ji_] {ܱ` 6Q@P.SsOʈW*{c7!w {`R ^XK@CTf java-design-patterns-1.16.0/api-gateway/price-microservice/pom.xml000066400000000000000000000052771312550536300251620ustar00rootroot00000000000000 api-gateway com.iluwatar 1.16.0 4.0.0 price-microservice jar org.springframework.boot spring-boot-dependencies org.springframework spring-webmvc org.springframework.boot spring-boot-starter-web junit junit test org.springframework.boot spring-boot-maven-plugin ${spring-boot.version} repackage java-design-patterns-1.16.0/api-gateway/price-microservice/src/000077500000000000000000000000001312550536300244215ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/000077500000000000000000000000001312550536300253455ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/000077500000000000000000000000001312550536300262665ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/com/000077500000000000000000000000001312550536300270445ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300306745ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/com/iluwatar/price/000077500000000000000000000000001312550536300317765ustar00rootroot00000000000000microservice/000077500000000000000000000000001312550536300344115ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/com/iluwatar/pricePriceApplication.java000066400000000000000000000032421312550536300405030ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.price.microservice; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * PriceApplication starts up Spring Boot, exposing endpoints for the Price microservice through * the {@link PriceController}. */ @SpringBootApplication public class PriceApplication { /** * Microservice entry point * @param args * command line args */ public static void main(String[] args) { SpringApplication.run(PriceApplication.class, args); } } PriceController.java000066400000000000000000000032371312550536300403670ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.price.microservice; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; /** * Exposes the Price microservice's endpoints */ @RestController public class PriceController { /** * An endpoint for a user to retrieve a product's price * @return A product's price */ @RequestMapping(value = "/price", method = RequestMethod.GET) public String getPrice() { return "20"; } } java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/resources/000077500000000000000000000000001312550536300273575ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/main/resources/application.properties000066400000000000000000000021631312550536300340020ustar00rootroot00000000000000# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # server.port=50006java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/000077500000000000000000000000001312550536300254005ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/java/000077500000000000000000000000001312550536300263215ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/java/com/000077500000000000000000000000001312550536300270775ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300307275ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/java/com/iluwatar/price/000077500000000000000000000000001312550536300320315ustar00rootroot00000000000000microservice/000077500000000000000000000000001312550536300344445ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/java/com/iluwatar/pricePriceControllerTest.java000066400000000000000000000027431312550536300412630ustar00rootroot00000000000000java-design-patterns-1.16.0/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.price.microservice; import org.junit.Assert; import org.junit.Test; /** * Test for Price Rest Controller */ public class PriceControllerTest { @Test public void testgetPrice() { PriceController priceController = new PriceController(); String price = priceController.getPrice(); Assert.assertEquals("20", price); } } java-design-patterns-1.16.0/async-method-invocation/000077500000000000000000000000001312550536300223725ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/README.md000066400000000000000000000027031312550536300236530ustar00rootroot00000000000000--- layout: pattern title: Async Method Invocation folder: async-method-invocation permalink: /patterns/async-method-invocation/ pumlid: TSdB3SCW303GLTe1mFTkunWhk0A3_4dKxTi5UdlIUuhIoCPfuz4Zjhy03EzwIlGyqjbeQR16fJL1HjuOQF362qjZbrFBnWWsTPZeFm3wHwbCZhvQ4RqMOSXIuA1_LzDctJd75m00 categories: Concurrency tags: - Java - Difficulty-Intermediate - Functional - Reactive --- ## Intent Asynchronous method invocation is pattern where the calling thread is not blocked while waiting results of tasks. The pattern provides parallel processing of multiple independent tasks and retrieving the results via callbacks or waiting until everything is done. ![alt text](./etc/async-method-invocation.png "Async Method Invocation") ## Applicability Use async method invocation pattern when * you have multiple independent tasks that can run in parallel * you need to improve the performance of a group of sequential tasks * you have limited amount of processing capacity or long running tasks and the caller should not wait the tasks to be ready ## Real world examples * [FutureTask](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/FutureTask.html), [CompletableFuture](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html) and [ExecutorService](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html) (Java) * [Task-based Asynchronous Pattern](https://msdn.microsoft.com/en-us/library/hh873175.aspx) (.NET) java-design-patterns-1.16.0/async-method-invocation/etc/000077500000000000000000000000001312550536300231455ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/etc/async-method-invocation.png000066400000000000000000001100731312550536300304170ustar00rootroot00000000000000PNG  IHDRB/YIDATxm%W}KVF2l9@kf1#[6 8L#53xpV{5 ml_-4!u?ލvհoeϭs۟d5`V!z|a٘9d2@nbcsGwy/,rNPyQE98MEQ ApO?kՙNV6bc>;~juo<|.bw_gUċ|TO&D٫%# kaUOTp(jǻs>,lȕѲ fc0acJ!6ڥn\7l?g_3ēw4J5 j-kw`ZGA-\?痴*~+ddW} IDc2c/6F]_T_(Ƽyh>G $⣿'>#*VT}X_"Ue/jժUR-<26 z %dXTBl̵K[yͣ7~pqF虷}C=DcڰRߏHt݂\w7XC$D\I|b1m r@6њicmð10Eؘ93?'?|/ b?}ܽϟP1=CKA܅_W)9r)N)ҕqmks2}iMx> mhl (h?r_;YzrF*37*dke9P{u LؙIKl$vh豣7?BlЉo=]{x~[>cX'7OM$Q:6c}sL)W? i49Wi^12FA6w2{oaW,51z|˙eYɃSJ7qLϘr@ΐIu'RcVܮ,=:zacJ6fk]3>?OےJj PU16Tl 6Tl 1Uj+l @UƠ PU1Tl 1Uj+l @U)+-РWil:E\!}= PUJjcT(ls^1U%?O")J*޼ݞ6{i]A+T +\ Vxɺ齃?4g[Mu*L=:-y' [vKp_Nǻ -dNۭG"?z1&'#9E}P|_m-UxY}7\j!jnRԉjX-hzYRxO3lwەWI+]QṄ3~ʆ$wYؾbt #6cc m⺾d,t{1R} et+nȹ>Mid@QN칵?Nx8W I3Q5L(moCh*٘ěr1ATJ'l0 {d{r+fm12j-?5Ԯ@v߸+i:{n1Qh_o/48L RݿS,dN[Vشl(mLϱޢ1A:Qq^j1 )&z<2Z TN<̀LQtIx1пѨ)}c 3LN6R#9* _ -fn^#+yPy\/C3Lun^D#W8<%vWۺd>]_;0mEge6`crpЇ/C6`cPm*T[ac 6VA6LLPKď?1UA4U 1j+l @UƠ PU466~wĂ$h囎?'$ԏ1UE1 G[_EoacƄI6:(B PUhT(l-4cvof{ZnIRRgCۘg2of:@4L%|HC4GiiO[]Kd䌯1U%KߘY? mL8ū>j"G)iMʹ C1+l @Um̿|ߨL,x#{^2o06ӵZ 􏲥2Ef4FZI4&T1ߺE2W,'Fg68G4bߤ'{݈]eFTy]g޲@oju)FiG4=dTA68lQL_C@ѷ>c{3ZZn`czn+l @Uqؘ[ں4*~!Vd4Jԭ:Fm i]1"l @Uq7*KceuY8`cBJrl"z&}K*U*a}%&qtG[yǁ+LW/m/1~(CGE21/ڨ,㱰1H6SmxQ1S&6A.KZE]=7GHu meK@=6TAac&niRdt#z\t]1(MlLeV u Z]ӋL6Ƹ5ڞmmף* .ӝiA/QncI.l 64ڒvSn׮Qy'~k҉64?"3Ƥ+{[/T$Sڣu [2HedoTVgac 1c 78X$VJ5ieBJF[c$He6--R+H4;{o[c mk܉mXTV'acoac xH`/Aےe ϓƶsd F[R x !T*acoac x"Jژ_++$$GSw.t9!~P| Ja`…#a`ԭ[l BTƄI6/| JژFe^2iynʖ#yV%M*yʼĎlHw5]ysntđ2Ej^ZR5󌽨8ac 1JxGN~{?n|~Pu2%1aȲQ龟(R]mo]y"+ ,70z63[{Y}c:cIpP d;9 QopŹo仉x?_Xx-tQԪlac6F]wRzjAmL7WǮ1=-ؘ Qg?7?\7{G?l-y]5m1Q"~yVؠ"Y&k$]V'ooaPH~OGFwpq|t,5A-i6@ѿj,;Z41~(CG/mO5dzmTΒݟעl/[տFe);Ɣ^lLvo{ͧŅl?g_3ēw4mm6F%U'>nRmûU{? ?Y$=#8!,Bfw羥QN?@l/Q{3qK[FI {'֗ƤvTS l QzO^?.эzBb'>cm6Fu#J]? *}v zm Ƣ.ުC$IlOOؘ Asrk<6R2ΓP}hGAac( 1\N1H(l 6&G]tۿ_Eqai^\zs߸}dPc=[r#JC-oHNnCd4FEuS|Ƈ^4g>$/',lLVɿ\-.hoRlBb@0蘎hI^H)e<"J6r!G) u3G?xzĵ}w—^g~[۟qyO1 lɄSMZ9ng?;܉Ϣ/__=yX|HeN6"'SJ!#X#Eݹ>j3Ni?5ÆQl94CJ9PlT11cX'7O-fcХ*TqDiE$ qD2[/|dc` 껬Q~"N2u6V4w qΛOŲXc01{ڶKixDFeeedCf7:@_8by+S!0Hio:>GCg!}elL 4@>(|ࣇ>)ҾҖl (l B-2 ^{aOJQ|$7uMǟ MP)AWMBWP \5){1[5!Է1&@J5)1A (l Bɳp@(1BRM>y-ʼ5I*6ͧ2I|8z?1&@J5)ƌx#v*X9 4 < !T*դR^}Ϛ٘Cn8i:&l [ؘޕݒނPɳp@(1BRMԲ7=5*6 ?+!q/۴HJ{Hcadc%2=՚UM4D 9Du6wv,q3{PTgPb J[W3H&d5 9V)C4H1Zv덮$PV rǔ%1u6&-/+cBǾɳp@jVb!=Ǭ0Ur?ĜjRtwu6J-gՅoE}iG2ؘv(i-+g[\ ChY/-x q)7BJgٛЖL0IHӜmI#5^[c ش~UgԦ(1YN'/3TQ]_C@&)  굚̿rm;mLwswzۘ1>a *ݐ]!4=eoAQ<誷53 =UM2%F?^D@܆mux'R<^AOkj)$R!j$S]m^x:-<[چ$t:i'{•ɚ1zr^Vst|ɗެ%UQN֥;ӹ){]5hL(1HR6Ow WJf2ne7 I\ sN60O?q 2|8WlmLru-+Vy M'0) ]5)*{{P\^ƘeI :6fohL"K-Ƹ7cK:ha} ɳp@ƿU7 q]_mV!?帍ze1R} e47rҁ>Myc@QNlkWF>v:+}cLch2^āKhjRtdc*Aʤw _o>RYzNP12T֭O_C- ,ibfcUe8}cY8 )12KiqI% `bT:q`$ܟْ@fmL0IwM>+$_]o:GΞ[lS5)Ǯ-1#A8G]EH)kֽiaysF*SUgԬȠ1~EЌ0ALRXG25v$l¦eC_$d,zu5DcrRM+{kd (lLfiW]Ӳ@SӄJ@qRc'QVɃⰦ}"M5y%&kKlj~m Vb*1C^+)J2#)o1W8jN70:ACjRtSM}gz6tY8 &eQYwaQZzxO !4O243 TVUJ:R ~I?\"i'nۡ6?O-6&jRtS Pj,J dЖ߶lZ&E7e/1&@ yZTwo囎?'$[UgPb J=a`ԭ[UgPb Jژ 6tY8 R&Ewʼe=^OXNҀMa`[eTMjX|w^"l Bɳp@(1BRMEc 1S}0˺OZ)")cQz:Z26o7|mXk j,w^(.GA#Cm{ּ(,lHOGpS͞>=԰$MM't)gc~½hpٖ*i;~"l&ӭy0W_CuZ2rp"{|l*w~'/ڏ}eF79hʳOk9ZlL1jY8 U,1Bc[W3H&e-:?_J3Fm,5Ǵ(a 8K7hney*%r"4:~JCDf:.;r/X*;cYXݭRI*1+|ދ^z?￶:篴ޒ7 gg*7'Gd^Ġ=Xw⮇)R $6ۘx+H#ɻ5FՏo8z#35yH/%S!ݎ|H&ke\L5%(Am]$z_nQrC8/ž-`j]PkVu AƔ5t7*+K$Ӈ>sDž?7/,^9{f)$W+^4oZ5˴~i SlX]Y&IM̅1fowF=` 6PTQN֥1bW"?lʥmx߹doLKX1_Xj%C;;~=e{cz'\S/1Ι[>zGs+#wk@~~|c'K"bW`ۿY ƄEQve["Ycǚ[{5NJ< _SKդVXAn~e[QS+EM z@5,^Jјmia LB%SMֆ'?)Z< X٘/w۹G}W>s x2-$W@Yl=a1[spTLeFe]Ya렋?ƸkcGBAfI]TmedX/ݭ=wOϽ![yŧQJCݯp_2W l1OY&4v7FA+[Z *H{l)[ t͒fzLIw땙 M-?тHRdVazU]C1z#cfc<'sǞ{8|!Է$FO%U@j(C4HԁQSˮlySY?lJ< ]b}H$='&0bKol:KPςy{=&:wfS˔O\iĉ''CSF0/*jRtWC#7;n{ bMnjUVMjc.c8e4cNL/tG4ݘmؠnT5xژaJ̠&>ƨlMS%ڭ3e1Y܎ -lfP6դ覶j+lLڒ4JY8 6F&Hx˝c걑FcRmv9"LIMm VUg Tb 9*c1lqt6O\ K.www:499933S`#PmA(]n:777S- U9I azLmjc_eNQǤ #Ͷn43!슊N3===??&V;vljjŋPUe1۷Ox+W U(1S~"bE*lnnJ%U cSXfcHnz6t6C1Vgq;7PԔ\PΎTJR^}Z*"l B J%MVK($cǎi%Uʑ#GF[XLj|śyU5'g-fym`RA(]}qC*D433T1/_ma3[W3H&e-i`Xч}7kQ#*ۘ!3fwѠWIvIx[}`2Qa t1y $a`愙Y]]M9VK*Sb !Q(Ҳ2oenMEMH4ʉekWfY2jvKݏK˲i a@i{ڋc3*{iiСC8fUdв71RYw<]o8p9eNberh6&<9plLP+҉ڄ=[=Tt36]kȨtSmL㮤s^PǏ^__+wvv.^x10{ƪA4ƯQ&\R0|pi %m9[4&X'2*1K]h ${uf~/wsBhO-777gff&''>3fm"1*oLXݴtHi0a =d̝جtKܘL!/>U)J2#)o1W8 %7ENpņr%><+rBh6E76V1zQYwaaZzxO&f==:*ehfέԿիt< ~D>NܶdL#wn1W#mWB5)1mEg< w$Z'ŗjhj̧9ݟ9(и&E75T[acF'/HTMҫ14*Kӆ^Kc+274 -ZgɁ=jRtS[C6tY8 かGĜXسu/rۘh6BTMnjk < Qb\gn}̛񯴝hc9 a!Tas,SxFcVfe@KMzlǽ֥̇N6 c:;cWQNGٴ3_!T1դ覶j+l Bɳp@l%/}o\~2XiHl1sP<ţu@<̷pܳPT26fx;DuLL`ꇸFT$ ˣݏ| __XiHc(R4:ٮeƢ]Z=ILTg9;]iLggȐG2& @ lLYJbcPY Pj,[q9sWN~ģ/ ׬̉Y\ƘgB:JKIbO?/W9c=6jRt֚x#ɏ eJq!1&qn{W^y _s^m:Yh}c]MS, Ʀ_r5ꞈȗ-39yvZk7ko դvοu=ϋdXV?U nc[bcƠA(]5yĸł5Y60MŚe +e0T&%H42Xaj+g.:δDg-LG7,JF*C㠚]wRzʧmD21&K1`A㧚ݎ|訸_C@&$*]2ؘd/fLKQ4zl ]|⟅F=lLrqsРjL֕Hiya嵾=Dc rRh Bɳp@ƿ^:7lI=jRtZz eɯyq71('acJWMB*jRt\ƑXsBu]2c24acJWMB*jRtS Pj,J PTVUgPb Jݔ < !T*դEUil<03ͣ?Yw֬i;mte^WgI]k1gŇ1dG&3qBv'O%FO?FSNiY}[=5;vvNJe>&`Ҩ&E76Vۘ.>}sbaLÐRf_IMkCe;@:R8 x8ǜ9O7Km?BIH%lĶ݃NFP=a Y5)1\gn}̛!Ya^ގOεi'o-i~"v{ViĐ~Ɔ;7Ud͍B+aMyN=~/+X-V0vΘK.2݃4w}0xdlT&,ߝҡ&EwlLZcer}QƼOzT)X$3?Q (LLu\3Vz}zc۞鼀٪>k+|ҿa% b*8zq >zS,?ۯ``͞nʳq\dmb^6wA%>{srjg*_uS>оq5tncthI] 3J֥dƼ|a ++dʓC~&~Ɲhc("rYj6sU#=ۣyyqފ@=k5sd\ U qH=5lL Tb_nak);P˴FF/?uS+;ݷ| k *q1uK}|/H8jOlјSMn[+{ :1hjac5gn?ʉ/xbᚕ9RICC+dqFcLMMH̒` cJl{ϚoLC8ǽ`ȳMp6hL Tb24;q9DRJ<9oy-!wzm.2߃͵Kn`nR?ez19]:4TդN1͇_W_Kdrv5G}7x9~lЇ^W^?};łWK,L-d1Yڈ[m{e['n (-IRdƿԦejNp,oб1CcC(ߑgwni9 k O={XK<9oyy?Q8]o%r&G+Cse;vs;|`+ _vRҀ˙dQpy]:4\դvۘo]y"+s%"J1Q6F _O 4oӖXv1i&axPCqskʛ| ^qf{9x;˃:߂w"I{>1}3ha+-1/Hejb.)tAKydcf\6 2V*2w[Ӆ岛3ҡ&E}]g޲ YJhv5f@WEF6ycZhe*ItRP0qcd|RPAh|(ѣ3ۜÔ2RC1=u^ѯ_ǫgT|+9̛zUEz S7~[ȇ=Œbm4oL4"gW޸7:mLۆ`AlLW9Ϩ[u<ܛAh|p?JO|Ỏ%T6VR(Fa έlĶ9_ؘ~㣑]ay4ӯ:dMl =]kqhm~ZWϼXmҴbѪplKmt?Q%7jQA z订YԺa8zA@ɌS$|sָ`k}t_KyXOp%B/W!ճMI-\ڕN1Ǭ-d6A4U 1 G/}o\~2X&+m{dIv1T̍b֙LS/'xNWgz"ȶsLTMɬN;UM krS=f~%խ_JWt̗H4YB=#FemrG8l~[ۣm5O~uNJ5@h]q* dM}+fCeʳq7:K>GG(3J7nlTJ!š8Sulc%Yɪ/ZWtьۚmV[wUs kvGd1CAbcoac lw?v/᳞ſb2jbiӢTx50T`_-ƕMhi#78o/ 6kGÕ4]4Ӷ NrAƌ k?9J;hi`c޷~ݿY[!TR51 Gs_9q|B,\2'VZ &\Jyؘ>1<፵~ƷhLΚQ2CW&ZRVnR!d |%M\3+8v.ѓtOfϊ[!TZac +w~wo2\S*@?fesNI0 wt|+skz2y?ыsc}zq( TYT> |%|y~U5~*Ҁ˙i9 1|#mi+J+l Qz߅/.s_Q딸9M,uVj6R6Fn}2dQƱ瘨|'0RYsR_ 22e[oZ{%ʌטkMǫjlWؐ[Wf;b+me1{åƨ0#vLުqDY#i+m"`l EGi |Zڠ1Uzvac27*ia[,1sIB83gvlrN6T 7>jq+?yJ}xsI46&7?o1wUxP׉=ac 1ns@?e]SmI]Yw]߬#Md`DD-7D;l^|+uT5c.ؘ'oFDr8C*1Bn|՛y7|͐ eY4V$CnDA58qj`1Q&o540c"aNlkq J%lo~߸YCG%.#[h˩sXitUjWa&B"L`cB6]wWUw?}gĿ4&I {1N(iWoj* 's1AJؘ_]ιU-{١FcB%yLw"䭮f>LDƾ1 PTs}'^JHL$N#kjcc17kz_cߘM*=Ccm=I*f*4åiW<89C512$6O#kXc*޴ا4a2 G0e!:铭y4\ sso~&SIA(RmLApj!{I(}o?>1'+(-l*4s< k36 8qu( 6(B?7 _S2eyk6ƈhC [>hMbcr-q5B}Sjkc {][cc l_k߸d3_RMf5Wܯܨ,-1e-}:3ۆY}*4cM=;B}x `{OzT)X$3ih]-ɤ ii8sieSib[ga366(}c7>W+V*ɒoe_@fs3eOpDG3㠓 MfŻg!l B-l Qz9sWN~ģ/ ׬̉J2c}7}mL''MSv>^C-p8Cacoac +w~w&m2_1i}c-qeAS\¤o1y >Ah|p?Je`I㜿47YO6RGTVThK1IߜagF*C 3841߻j[t;̙k'SUOb*ļ1hD?C>K3uS9-6@>`cT1ZʻFPWؘ1iR ӈƌ#+++E碎?~,T۾/%$V*MٔUuHqL}~0¡k?7sac lnnNNN^xԑF=L6*2e2eV߆aeyM3ˉF\{yuRexscdEQO(mooݢRSdѨJ9s6@FT677@&Ƥ ̜hsew{{ LΘg@9s'l [fff10%1WP1Pkn0N@ lll`cPmrʕPcA6j6”%a`1@ؘXo ɨ),6V+++Pt.#;;;{^X?S甔q9P0Yr.6i-z1ŋ333EO'''}'#3"#W9OT-yO+W1Z:MGfJ _cr4%^/xx?x+Co*Yq}v fckVݣvP-@Y[[va"6]wWUw?}gĿdQ(9 ӫ Z1)uzЎ>Up㡕ڹܶʙZ9ۘ06sP=l @Y| @4ue}}_Ivؘ_]ιUW Kg1^]HiDCH6|9O|}c*ĮǞ73Ly?Gw>mB r}Օ~ĸXjWK^yvOK9Jw4Ԙ|43p%HezɏtVWW ·:t}ѨS1'z& 'Vu8ܑccb3L1P Ec$sַ3o>.Ŀ4r]x 76g r&Y[#g lhcv+7V#7^n[1i#멜i?yDԯ1P<~e@BuYYYY]]m6x7.?WTuq9V01{`-b: 6jrGl}W}n~Ҫ-@IwdxIK`J&I0tZ %3<+͗B16 f}}}cc\@ fcw0zz@J2s(=I1Fnc(~@hc %*x^ƕl'׻-S(U/:][9|ל+'N|їOkVJ%2mlL(\3h)6FK%p-1P G%H@4*?*Jٰ+w~wo2R7{t5v&II1=:3fLK/r2xߘxt հ16FbO}(9􍁒j5y-31B]?X0$pT\NcX6 fnئz'HeaĚS\G*KfrZrsԧ10::NdNpC4ʌ(&&&ߢ31%`S Ơ CgwwWTLwvv\|02[RQT:!!%duuu߾}~[R)l-4 Ō10,vvvhLy*A(!ǎ+U&R6< $ա@yxbQdj+l ̶^9Q۷O83j+l xONN0DcpDQV1T[ac ˤ0 bY]],gOl 1E@4xx;`zUyqƌEZFHgt&i#)ic }{رC7@!t:y4~}bN, TeT܈fZ ƸaVhLL@looѐ r1021333Eg6g?s og|\, ɺ6ã M5*҄%фL.vjފ2)"#NB4F1sssU Dl/}o\~2X&*[KYLw IUKd3$M-ؘ ǒ $ T>zѹyC͓<Ʃ@S_RI -M2T@0764㱴&jq!I|ѹZ@400fs]h)]b ǒvHe,l {?2O}(9Dc GDQ(:#"/K7e6NNN^|@Mo xHfc #7sLaY[R4Z!17f<B4Gbfsii 1QCFiB1Qƺa 1şz߾}t1ˢL+: FeULXZZ"eh Α#Gjթj+l @9jP*}3??_1EP~+;;;E1ԑCժ1훟/:ŀA69rdqq 1=Ly)m4eBhc\w^)nP񼧂凾1˗/ONNRoc"%-~Ơ1uaggg߾}Eg *Ə$/^,:/1\|'>'Ы B1Fӿ`cPW~ Z@ؘD8l~ZWϼX mn- #L/q؏4bi5f $VN5A{g}}}bbG>T1`mm٘_k߸d3_RM&5&lDTЊ!}4dˑl`&#}HHbkJ3Cl 1@du U1l6 )lj|7NJahQSqumLCBAiMM+hT'󓓓"Dc@GxFl6ݏ| __XL)5 CIE~Yߐfc0 RLDnfg`c*l [NSt^bsssmm\9|ל+'N|їOkVJ%Y$D~@jK1 FKQDߟA= 0>l6gff@a&'' {+>bAL#56!{Qzń1u,-Ơބvwwƀ00~u3N#4L-HezG* ?mƠ=l ahwcј#JNStFAT5yc Py.^HdxȑngNA&l @yO9[ ?t1duuu߾}^)FR& l @yfffF5~l6 c }cfѹe1 U",o`%lll^`!S+DvȑsQa1˗/8po0=557-cQ'DvA0A6t2==}ʕh-G|'Cg{ԁ/nllq`b Z"~э(333뉕{xB0bwVWW1<6giii~~^_/7-oƌ1u(:/0>`c bXor2 [gYlLhu^[+ܜ#Ʋ8333,lLs k.toP65`G|*([m-j6[#˪oc 3ؘ?pkTa677G+Q)VNn&_e}-?עLW:ZįnomzyȎ((6?tJ ݁d9P8D;Z[okg"lL /6M0==}e%")>sDž?7/zOH#mJ|%UcCT^4g$L-T9"KGyv[url;-xʨ6Nugd{{[Ɓſa&`cʮ;gn[{yJ=b'?z _7_Y CP!银'"xv(>KbcV4Wq$r \Jy=>m Dv9r< ŧ 4͋/Fͭ S` Sv} s7|֏=檐eڏIJocnP)F"QE0NJo%5/>Rf"G]-qc77ҐhN/ ֱ"N2uƔZ l̸#dh 6x{Z_:Wc=p[[ba'ddALcdI ܅q2eごq0omelL9##@)TF?xXmg!ϰ]Tԁ( sqB1F\rEQf X1>%Be6&u1aǷ.sssDc6ƭ#9* V@|׌FjziH.GSAq ̂3UWF_tgډAr5%He/[lLfUNV3Ce1!H%Ml=NhLb}1U۶ TKUNV=RY`2kH/SKK"MtpMZjd2*AVyʴ@ ƪԦ]Ӳ,d4SPԺj#7j5TjBaQn J (?QT[`p1Bu2OTU}HK ~ŭu8>.nZHKk7dرj.E=C"' 3!K7TzggjS]3]| "UB1'A ]2`cB*Š.p&ر'FѠClgbAhePJ(&D1(K l B(R%~%6!ɢj?7|wm ?tjY9R(K l B(R%~{ʽ|7[!֨SnG+X1s+Cvc:{yEOL!) Uʫ_ළԲZKN WWNƌd6f:{acbPJ(&zu}eoGO6^*VWxǢSh>nJ19qژB~?gXW ]2`cB*,?W?(/~_Qw̓y>iޣt.U;"BӨ 6Q{cʷYC(Ci/e!1Q$tAEb/ŷ~r;/r'Jjm<ϣX CbD(b9wRX,WzcA|3GlRr5;rl B(R%~ƭwRQ;| ?{c-KQwyeM7յDZY\FژY gm?7 #PJ(&s3`ۻ[(ԓ3qʌ!1+q3?tsn$dcմv cA;cQd‰ T^BJt=<N짴=yN.=[{j{ H(@5U毄bs;Wk.63ʤ/{ /c}fK0ʬYr2-}je+MEQ*F ]䘧) 7w\L0.^~'lcfTչ^Jgڷv4b1J㯞?koXRxe] i9|KHrӹ$ 12@:1W>3OXS }m/PZWL{f$+cA6ROX?}>ksӰ? 1L7x}>;bCUB1YT6fȣ%Nyͭ/JMKJzu+K}LfȆJ*Rb'.% ^:,؝-™"֛V~և ̮~]3\ա*ll̾ݳ"SB @86N}KZim>)g 2#emtVo=R[7SdT9RgGȏSB12d1grbP 'nΖHJ=7[09}ޘ  t`cݭިb27mav3٘U dd5oy{ӗՂzFqR?#ژQ8^X&A23+G@fqilr<ݖ065d^Y+yƒl1t$)ӎF8Tա* bPB @8}'\wpY-|9?MdGn 9g*LT?SR20X9 3KjhdTQףpԹY~eڻ&PuhJ(&Ơ%<y=7i T d(%t驝 гL0G#4h?Q JWGCf_xPL6l=Ph-Y >߄.p1HPLt1/yd "UB1~RkyMO&SsZښOOQZkDoU:^1{Y T69'ckG%}jU2ʽ1v~zy>yZ탖1K l B(R%(*6}JèL|$>rmH|~Wq:.cctvX}Lۘ⡴9:i1-u:R3%O1wԩ4>EUxPMbjX(@3þ dzc@|R|%3dO5YxYkd:s<^;Xoo/9l1eQjzcfa6f(@/2~|m%. 05(3{zƳJl~>TbklLu⎁16Hu#d}Aru߫fCG:<^E ׷:; |'辠dkc|~gfufX¬~*^Z^s1Z:ƃ: *&`cZ-a GL(&3yuo'LCa؎n4kSrsde>fVԤZϮt߮UήwdAK0ec}Oz{u^ 5sn?H%<-53儞b]Dͻh%[~`Zev~G] :Iٛw_7;C}U-Ql=Os/Q-Y';;i,! O>֤Tir s,*6^p wؘ~W'HІB҉F$FJ4%tmc.}[?JZin${[hVǑ`'5ML,fo7k 6V;Owul-Y.הeׁԃM.ϱL}JPχ2@MJ&W[JYV]]= a1L}b/dB16FWpP ]2tۘǮlbtKT+ͬGL]7}[IcPIeW}i!ff[HHk16RHjR4q_'fZplY| [בuocL(&Ơ%NySgn_R+zVZ[63`9-FPw8;Fʀ謐z$egңPst4CSO]4@:?;$}2@MJ&+̙6V%rH~W1acPJƜʉ6nzwC-V:[R#L 5}dOso;ODckXmw,T`(_uULf>ΐtV7fZYp NϝEdcB&acP J'OuO_V e{=3 ad|>hczX.G$`NlLֆgQ87xY9CIIY70-_ c3%&J[ᬟת06f5l}U {_ڑ}eO>QR16Š.pN|aZ1Z'StΤ5ek6Fύ?SR2!8[wkf*7pv{=Zq_RZ[5iT&VXczj͌*TJ!"}/s3T]Q:1ٱcO=VywVw7'O#+7&Fsab V9>!AyKșzvjRB @86gu/߬^,p/n翻eȞŏM.7[R5Ԏ#Gqmz;W3cުthIylex$g`{C=CGR diŵ6܂nc\G)6fH%tmcys닭R-RtbVh2^3ܯcxn \rR՚H%tGp3u4o^l} !6Hq'G/S"b܎Q-6{)&i1#HLi&5 c?Ӄ1G lSq?F!4gGRzskgYLNl30Sd }f*k;?N;QPB @8PJ(&K\܄=TB @8PJ(&K\伂Mv. PB @8PJ(&K\e QB @8Mw#hP!631JƠ#6 <P1(ac`b6 <P1(ac`b6 <Pnc;̕=Zyl"6 <Pdct72]I{y&1T1W>3OXS AqF,"qǾ*b腍& y˧o?Ղz)lٌl̨ަr/2t7ݩ_3)j+Ǔj%QX*hBq٘K~ŏ|ҮzV5*K3ʢ'թbt6Cr^6(Zac`ecys닭R-R463*K*1H)ZI_֎JQkz{PRA<ک3/^{)WT+mL3RrDطEؘ& 9{mlxZ8qsM46d,ִI=1/l ,4yx?=9s7oo~ZP/m:Ƙ~5>lex3_Khwޫ=6m1Tp޵be oT:6R,lMKae}MbepJƐὴ2SYRAp-ܘ䄍& yaykid/l ,4yԉ^hbe2h1T2\RB6 <P1(ac`b6 <P1(ac`b6 <Phlml3#z *& ÷1ږc~~D'l ,4ym̕ϯ?S7cYƔ]1hǿ`c6 <P<6.=䫷w\W ꥰ25YǓ$%rCW%߸\;xLǣ2Ӭ<՛67zMX*hBq٘K~ŏ|ҮzViIȖ'K2]]Y){Tai薣`#{8HkjoVBlLdRAR R3@up#-脍& ySgn_R+zVԒ.$(C1L/l1`T~J?3v̲cf1T1grbP 'nfI1|e7E'l ,4yDkcl˃(l ,4yDlc9RAJ6-1TA1KM@(1Tr#F}RXH l $6 IENDB`java-design-patterns-1.16.0/async-method-invocation/etc/async-method-invocation.ucls000066400000000000000000000117631312550536300306070ustar00rootroot00000000000000 java-design-patterns-1.16.0/async-method-invocation/etc/async-method-invocation.urm.puml000066400000000000000000000030741312550536300314140ustar00rootroot00000000000000@startuml package com.iluwatar.async.method.invocation { class App { - LOGGER : Logger {static} + App() - callback(name : String) : AsyncCallback {static} - lazyval(value : T, delayMillis : long) : Callable {static} - log(msg : String) {static} + main(args : String[]) {static} } interface AsyncCallback { + onComplete(T, Optional) {abstract} } interface AsyncExecutor { + endProcess(AsyncResult) : T {abstract} + startProcess(Callable) : AsyncResult {abstract} + startProcess(Callable, AsyncCallback) : AsyncResult {abstract} } interface AsyncResult { + await() {abstract} + getValue() : T {abstract} + isCompleted() : boolean {abstract} } class ThreadAsyncExecutor { - idx : AtomicInteger + ThreadAsyncExecutor() + endProcess(asyncResult : AsyncResult) : T + startProcess(task : Callable) : AsyncResult + startProcess(task : Callable, callback : AsyncCallback) : AsyncResult } -class CompletableResult { ~ COMPLETED : int {static} ~ FAILED : int {static} ~ RUNNING : int {static} ~ callback : Optional> ~ exception : Exception ~ lock : Object ~ state : int ~ value : T ~ CompletableResult(callback : AsyncCallback) + await() + getValue() : T + isCompleted() : boolean ~ setException(exception : Exception) ~ setValue(value : T) } } CompletableResult ..+ ThreadAsyncExecutor ThreadAsyncExecutor ..|> AsyncExecutor CompletableResult ..|> AsyncResult @endumljava-design-patterns-1.16.0/async-method-invocation/pom.xml000066400000000000000000000036231312550536300237130ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 async-method-invocation junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/async-method-invocation/src/000077500000000000000000000000001312550536300231615ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/000077500000000000000000000000001312550536300241055ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/000077500000000000000000000000001312550536300250265ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/000077500000000000000000000000001312550536300256045ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300274345ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/000077500000000000000000000000001312550536300305515ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/method/000077500000000000000000000000001312550536300320315ustar00rootroot00000000000000invocation/000077500000000000000000000000001312550536300341235ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/methodApp.java000066400000000000000000000124241312550536300355110ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.Callable; /** * This application demonstrates the async method invocation pattern. 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. *

* The main method shows example flow of async invocations. The main thread starts multiple tasks with variable * durations and then continues its own work. When the main thread has done it's job it collects the results of the * async tasks. Two of the tasks are handled with callbacks, meaning the callbacks are executed immediately when the * tasks complete. *

* Noteworthy difference of thread usage between the async results and callbacks is that the async results are collected * in the main thread but the callbacks are executed within the worker threads. This should be noted when working with * thread pools. *

* Java provides its own implementations of async method invocation pattern. FutureTask, CompletableFuture and * ExecutorService are the real world implementations of this pattern. But due to the nature of parallel programming, * the implementations are not trivial. This example does not take all possible scenarios into account but rather * provides a simple version that helps to understand the pattern. * * @see AsyncResult * @see AsyncCallback * @see AsyncExecutor * * @see java.util.concurrent.FutureTask * @see java.util.concurrent.CompletableFuture * @see java.util.concurrent.ExecutorService */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) throws Exception { // construct a new executor that will run async tasks AsyncExecutor executor = new ThreadAsyncExecutor(); // start few async tasks with varying processing times, two last with callback handlers AsyncResult asyncResult1 = executor.startProcess(lazyval(10, 500)); AsyncResult asyncResult2 = executor.startProcess(lazyval("test", 300)); AsyncResult asyncResult3 = executor.startProcess(lazyval(50L, 700)); AsyncResult asyncResult4 = executor.startProcess(lazyval(20, 400), callback("Callback result 4")); AsyncResult asyncResult5 = executor.startProcess(lazyval("callback", 600), callback("Callback result 5")); // emulate processing in the current thread while async tasks are running in their own threads Thread.sleep(350); // Oh boy I'm working hard here log("Some hard work done"); // wait for completion of the tasks Integer result1 = executor.endProcess(asyncResult1); String result2 = executor.endProcess(asyncResult2); Long result3 = executor.endProcess(asyncResult3); asyncResult4.await(); asyncResult5.await(); // log the results of the tasks, callbacks log immediately when complete log("Result 1: " + result1); log("Result 2: " + result2); log("Result 3: " + result3); } /** * Creates a callable that lazily evaluates to given value with artificial delay. * * @param value * value to evaluate * @param delayMillis * artificial delay in milliseconds * @return new callable for lazy evaluation */ private static Callable lazyval(T value, long delayMillis) { return () -> { Thread.sleep(delayMillis); log("Task completed with: " + value); return value; }; } /** * Creates a simple callback that logs the complete status of the async result. * * @param name * callback name * @return new async callback */ private static AsyncCallback callback(String name) { return (value, ex) -> { if (ex.isPresent()) { log(name + " failed: " + ex.map(Exception::getMessage).orElse("")); } else { log(name + ": " + value); } }; } private static void log(String msg) { LOGGER.info(msg); } } AsyncCallback.java000066400000000000000000000031601312550536300374600ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import java.util.Optional; /** * * AsyncCallback interface * * @param * */ public interface AsyncCallback { /** * Complete handler which is executed when async task is completed or fails execution. * * @param value the evaluated value from async task, undefined when execution fails * @param ex empty value if execution succeeds, some exception if executions fails */ void onComplete(T value, Optional ex); } AsyncExecutor.java000066400000000000000000000046611312550536300375710ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; /** * * AsyncExecutor interface * */ public interface AsyncExecutor { /** * Starts processing of an async task. Returns immediately with async result. * * @param task task to be executed asynchronously * @return async result for the task */ AsyncResult startProcess(Callable task); /** * Starts processing of an async task. Returns immediately with async result. Executes callback * when the task is completed. * * @param task task to be executed asynchronously * @param callback callback to be executed on task completion * @return async result for the task */ AsyncResult startProcess(Callable task, AsyncCallback callback); /** * Ends processing of an async task. Blocks the current thread if necessary and returns the * evaluated value of the completed task. * * @param asyncResult async result of a task * @return evaluated value of the completed task * @throws ExecutionException if execution has failed, containing the root cause * @throws InterruptedException if the execution is interrupted */ T endProcess(AsyncResult asyncResult) throws ExecutionException, InterruptedException; } AsyncResult.java000066400000000000000000000040001312550536300372340ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import java.util.concurrent.ExecutionException; /** * AsyncResult interface * @param parameter returned when getValue is invoked */ public interface AsyncResult { /** * Status of the async task execution. * * @return true if execution is completed or failed */ boolean isCompleted(); /** * Gets the value of completed async task. * * @return evaluated value or throws ExecutionException if execution has failed * @throws ExecutionException if execution has failed, containing the root cause * @throws IllegalStateException if execution is not completed */ T getValue() throws ExecutionException; /** * Blocks the current thread until the async task is completed. * * @throws InterruptedException if the execution is interrupted */ void await() throws InterruptedException; } ThreadAsyncExecutor.java000066400000000000000000000110561312550536300407150ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import java.util.Optional; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; import java.util.concurrent.atomic.AtomicInteger; /** * * Implementation of async executor that creates a new thread for every task. * */ public class ThreadAsyncExecutor implements AsyncExecutor { /** Index for thread naming */ private final AtomicInteger idx = new AtomicInteger(0); @Override public AsyncResult startProcess(Callable task) { return startProcess(task, null); } @Override public AsyncResult startProcess(Callable task, AsyncCallback callback) { CompletableResult result = new CompletableResult<>(callback); new Thread(() -> { try { result.setValue(task.call()); } catch (Exception ex) { result.setException(ex); } } , "executor-" + idx.incrementAndGet()).start(); return result; } @Override public T endProcess(AsyncResult asyncResult) throws ExecutionException, InterruptedException { if (!asyncResult.isCompleted()) { asyncResult.await(); } return asyncResult.getValue(); } /** * Simple implementation of async result that allows completing it successfully with a value or exceptionally with an * exception. A really simplified version from its real life cousins FutureTask and CompletableFuture. * * @see java.util.concurrent.FutureTask * @see java.util.concurrent.CompletableFuture */ private static class CompletableResult implements AsyncResult { static final int RUNNING = 1; static final int FAILED = 2; static final int COMPLETED = 3; final Object lock; final Optional> callback; volatile int state = RUNNING; T value; Exception exception; CompletableResult(AsyncCallback callback) { this.lock = new Object(); this.callback = Optional.ofNullable(callback); } /** * Sets the value from successful execution and executes callback if available. Notifies any thread waiting for * completion. * * @param value * value of the evaluated task */ void setValue(T value) { this.value = value; this.state = COMPLETED; this.callback.ifPresent(ac -> ac.onComplete(value, Optional.empty())); synchronized (lock) { lock.notifyAll(); } } /** * Sets the exception from failed execution and executes callback if available. Notifies any thread waiting for * completion. * * @param exception * exception of the failed task */ void setException(Exception exception) { this.exception = exception; this.state = FAILED; this.callback.ifPresent(ac -> ac.onComplete(null, Optional.of(exception))); synchronized (lock) { lock.notifyAll(); } } @Override public boolean isCompleted() { return state > RUNNING; } @Override public T getValue() throws ExecutionException { if (state == COMPLETED) { return value; } else if (state == FAILED) { throw new ExecutionException(exception); } else { throw new IllegalStateException("Execution not completed yet"); } } @Override public void await() throws InterruptedException { synchronized (lock) { if (!isCompleted()) { lock.wait(); } } } } } java-design-patterns-1.16.0/async-method-invocation/src/test/000077500000000000000000000000001312550536300241405ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/000077500000000000000000000000001312550536300250615ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/000077500000000000000000000000001312550536300256375ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300274675ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/iluwatar/async/000077500000000000000000000000001312550536300306045ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/iluwatar/async/method/000077500000000000000000000000001312550536300320645ustar00rootroot00000000000000invocation/000077500000000000000000000000001312550536300341565ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/iluwatar/async/methodAppTest.java000066400000000000000000000025351312550536300364060ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } ThreadAsyncExecutorTest.java000066400000000000000000000275751312550536300416250ustar00rootroot00000000000000java-design-patterns-1.16.0/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.async.method.invocation; import org.junit.Test; import org.mockito.ArgumentCaptor; import org.mockito.Matchers; import java.util.Optional; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; import static org.junit.Assert.*; import static org.mockito.Mockito.*; import static org.mockito.internal.verification.VerificationModeFactory.times; /** * Date: 12/6/15 - 10:49 AM * * @author Jeroen Meulemeester */ public class ThreadAsyncExecutorTest { /** * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable)} */ @Test(timeout = 3000) public void testSuccessfulTaskWithoutCallback() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final Object result = new Object(); final Callable task = mock(Callable.class); when(task.call()).thenReturn(result); final AsyncResult asyncResult = executor.startProcess(task); assertNotNull(asyncResult); asyncResult.await(); // Prevent timing issues, and wait until the result is available assertTrue(asyncResult.isCompleted()); // Our task should only execute once ... verify(task, times(1)).call(); // ... and the result should be exactly the same object assertSame(result, asyncResult.getValue()); } /** * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable, AsyncCallback)} */ @Test(timeout = 3000) public void testSuccessfulTaskWithCallback() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final Object result = new Object(); final Callable task = mock(Callable.class); when(task.call()).thenReturn(result); final AsyncCallback callback = mock(AsyncCallback.class); final AsyncResult asyncResult = executor.startProcess(task, callback); assertNotNull(asyncResult); asyncResult.await(); // Prevent timing issues, and wait until the result is available assertTrue(asyncResult.isCompleted()); // Our task should only execute once ... verify(task, times(1)).call(); // ... same for the callback, we expect our object final ArgumentCaptor> optionalCaptor = ArgumentCaptor.forClass((Class) Optional.class); verify(callback, times(1)).onComplete(eq(result), optionalCaptor.capture()); final Optional optionalException = optionalCaptor.getValue(); assertNotNull(optionalException); assertFalse(optionalException.isPresent()); // ... and the result should be exactly the same object assertSame(result, asyncResult.getValue()); } /** * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable)} when a task takes a while * to execute */ @Test(timeout = 5000) public void testLongRunningTaskWithoutCallback() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final Object result = new Object(); final Callable task = mock(Callable.class); when(task.call()).thenAnswer(i -> { Thread.sleep(1500); return result; }); final AsyncResult asyncResult = executor.startProcess(task); assertNotNull(asyncResult); assertFalse(asyncResult.isCompleted()); try { asyncResult.getValue(); fail("Expected IllegalStateException when calling AsyncResult#getValue on a non-completed task"); } catch (IllegalStateException e) { assertNotNull(e.getMessage()); } // Our task should only execute once, but it can take a while ... verify(task, timeout(3000).times(1)).call(); // Prevent timing issues, and wait until the result is available asyncResult.await(); assertTrue(asyncResult.isCompleted()); verifyNoMoreInteractions(task); // ... and the result should be exactly the same object assertSame(result, asyncResult.getValue()); } /** * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable, AsyncCallback)} when a task * takes a while to execute */ @Test(timeout = 5000) public void testLongRunningTaskWithCallback() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final Object result = new Object(); final Callable task = mock(Callable.class); when(task.call()).thenAnswer(i -> { Thread.sleep(1500); return result; }); final AsyncCallback callback = mock(AsyncCallback.class); final AsyncResult asyncResult = executor.startProcess(task, callback); assertNotNull(asyncResult); assertFalse(asyncResult.isCompleted()); verifyZeroInteractions(callback); try { asyncResult.getValue(); fail("Expected IllegalStateException when calling AsyncResult#getValue on a non-completed task"); } catch (IllegalStateException e) { assertNotNull(e.getMessage()); } // Our task should only execute once, but it can take a while ... verify(task, timeout(3000).times(1)).call(); final ArgumentCaptor> optionalCaptor = ArgumentCaptor.forClass((Class) Optional.class); verify(callback, timeout(3000).times(1)).onComplete(eq(result), optionalCaptor.capture()); final Optional optionalException = optionalCaptor.getValue(); assertNotNull(optionalException); assertFalse(optionalException.isPresent()); // Prevent timing issues, and wait until the result is available asyncResult.await(); assertTrue(asyncResult.isCompleted()); verifyNoMoreInteractions(task, callback); // ... and the result should be exactly the same object assertSame(result, asyncResult.getValue()); } /** * Test used to verify the happy path of {@link ThreadAsyncExecutor#startProcess(Callable)} when a task takes a while * to execute, while waiting on the result using {@link ThreadAsyncExecutor#endProcess(AsyncResult)} */ @Test(timeout = 5000) public void testEndProcess() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final Object result = new Object(); final Callable task = mock(Callable.class); when(task.call()).thenAnswer(i -> { Thread.sleep(1500); return result; }); final AsyncResult asyncResult = executor.startProcess(task); assertNotNull(asyncResult); assertFalse(asyncResult.isCompleted()); try { asyncResult.getValue(); fail("Expected IllegalStateException when calling AsyncResult#getValue on a non-completed task"); } catch (IllegalStateException e) { assertNotNull(e.getMessage()); } assertSame(result, executor.endProcess(asyncResult)); verify(task, times(1)).call(); assertTrue(asyncResult.isCompleted()); // Calling end process a second time while already finished should give the same result assertSame(result, executor.endProcess(asyncResult)); verifyNoMoreInteractions(task); } /** * Test used to verify the behaviour of {@link ThreadAsyncExecutor#startProcess(Callable)} when the callable is 'null' */ @Test(timeout = 3000) public void testNullTask() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final AsyncResult asyncResult = executor.startProcess(null); assertNotNull("The AsyncResult should not be 'null', even though the task was 'null'.", asyncResult); asyncResult.await(); // Prevent timing issues, and wait until the result is available assertTrue(asyncResult.isCompleted()); try { asyncResult.getValue(); fail("Expected ExecutionException with NPE as cause"); } catch (final ExecutionException e) { assertNotNull(e.getMessage()); assertNotNull(e.getCause()); assertEquals(NullPointerException.class, e.getCause().getClass()); } } /** * Test used to verify the behaviour of {@link ThreadAsyncExecutor#startProcess(Callable, AsyncCallback)} when the * callable is 'null', but the asynchronous callback is provided */ @Test(timeout = 3000) public void testNullTaskWithCallback() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final AsyncCallback callback = mock(AsyncCallback.class); final AsyncResult asyncResult = executor.startProcess(null, callback); assertNotNull("The AsyncResult should not be 'null', even though the task was 'null'.", asyncResult); asyncResult.await(); // Prevent timing issues, and wait until the result is available assertTrue(asyncResult.isCompleted()); final ArgumentCaptor> optionalCaptor = ArgumentCaptor.forClass((Class) Optional.class); verify(callback, times(1)).onComplete(Matchers.isNull(), optionalCaptor.capture()); final Optional optionalException = optionalCaptor.getValue(); assertNotNull(optionalException); assertTrue(optionalException.isPresent()); final Exception exception = optionalException.get(); assertNotNull(exception); assertEquals(NullPointerException.class, exception.getClass()); try { asyncResult.getValue(); fail("Expected ExecutionException with NPE as cause"); } catch (final ExecutionException e) { assertNotNull(e.getMessage()); assertNotNull(e.getCause()); assertEquals(NullPointerException.class, e.getCause().getClass()); } } /** * Test used to verify the behaviour of {@link ThreadAsyncExecutor#startProcess(Callable, AsyncCallback)} when both * the callable and the asynchronous callback are 'null' */ @Test(timeout = 3000) public void testNullTaskWithNullCallback() throws Exception { // Instantiate a new executor and start a new 'null' task ... final ThreadAsyncExecutor executor = new ThreadAsyncExecutor(); final AsyncResult asyncResult = executor.startProcess(null, null); assertNotNull("The AsyncResult should not be 'null', even though the task and callback were 'null'.", asyncResult); asyncResult.await(); // Prevent timing issues, and wait until the result is available assertTrue(asyncResult.isCompleted()); try { asyncResult.getValue(); fail("Expected ExecutionException with NPE as cause"); } catch (final ExecutionException e) { assertNotNull(e.getMessage()); assertNotNull(e.getCause()); assertEquals(NullPointerException.class, e.getCause().getClass()); } } }java-design-patterns-1.16.0/balking/000077500000000000000000000000001312550536300172375ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/README.md000066400000000000000000000011771312550536300205240ustar00rootroot00000000000000--- layout: pattern title: Balking folder: balking permalink: /patterns/balking/ categories: Concurrency tags: - Java - Difficulty-Beginner --- ## Intent Balking Pattern is used to prevent an object from executing certain code if it is an incomplete or inappropriate state ![alt text](./etc/balking.png "Balking") ## Applicability Use the Balking pattern when *you want to invoke an action on an object only when it is in a particular state *objects are generally only in a state that is prone to balking temporarily but for an unknown amount of time ## Related patterns * Guarded Suspendion Pattern * Double Checked Locking Patternjava-design-patterns-1.16.0/balking/etc/000077500000000000000000000000001312550536300200125ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/etc/balking.png000066400000000000000000000516631312550536300221420ustar00rootroot00000000000000PNG  IHDR4SzIDATxXIǕ*E){(RE'zX`=l ＳﬨXO)!M(&qó-3;3cf7y$XD] H ^ +֋a0=^"O [EPB&AT 0@P-dAk<,\2JQAaBܗ8 PsZQO70 '(QB@[N+! $ܸ^M0.sOԬ硶щ/G‡kK+,ŗw??J!rHtkH-9SZ]{UDr)VN+XtZw΢zS 9Sgk_; P !wמ|ܡKcm$zI4 p{~T2oc!H_;Zk9ݝ6-Ԟ1CLlHxu+DhcكSJ}hM}*9SOu|HMNGJTN z#̑R{lʪcgՠ])bTmTrjk"mV2nzγ4g?nKQyfc쒨i8{SGk SѫoOԶ%L~E YA~ Vb _AE YК`0EPB&AT 0@P-dAk< AE YК`0 H['fτ2"jي$XEa=Hw,rřhetTV%ip/ >j=.g#3ӈr҃)1zҽzI9Bu=v, B[ZF{oכ5%)Sʪ(eՕW)vƓyruL^RC^jCFy rMaE Y"}dGX+˫?R 1ohſqWNHkwY.w2 +h켱 GW-B"ҟed]7mX]j*>~q,oYz1 ( __o"g [yWi}E`aT{v v~'Rnf흙F8qp\X~d>}mZwԕ9?!#d[fsMd{ˌpN"IJ`D!Ϡ֋]E<>aO_݋d]Rr[`L5dԃV(5`7*rywc7"wmR;ʦ36/$[1,:hFRߩd%_[i9dw8qQc-m(r> &E=a߇ A /3@{Qv! RzG^cERnc ꩭV22zPȥGHiO3u(VPϨ=\h#'5"":ڑ 1]쀮Mzl!{@`v){)뎱 藶)d:͙An!ҽEKJ.q#+Lyp +8e_f7xAf\hirv >=ӡ kF8b~2z_xz9/&g0Ĝ֋G; FP[Cg9d#UT.UQ]|4i #@#suV_Ei9 ":=#3Kی'e?<{E'/dA[yOv#JqHI-y*@yv?D#c }^AԈr2{噸5[JRʼnS"k[ЖuH8vn sFlrC-Wfr$RoنE"#iHIKI96SQs! yR2#B3x q́Oҝ~4ڵԣ}q/NbCYցG.ĭpA7;_xݻĺ&^V"҃EN;q^(O݅6 R#|^LJ 35s E * ]H0ZK@pV]_, mE6oYqu溛-_ ܊ӒeΈYoͷ_:k+ZȒv1]u޽疱> B>~7#N>}083Y;!ֽ=f>XNZF~Y m'tEP66Ŝ9&5C,+~oC }(/ɧ VaVe^̑Y=xB2ҾvlVsH& ߋbb}72qlw` 9:y1ۃvWb]y0^$] 5qdarס=h`7 ԷۚvG~n:/D$A0X< AE YК`0EPB&AT !Hxa o:,}5`o[ VيzTALX:X#Aލ[fo/H+ ViKJw +'9Lu[s\E{kD`ws/*ߥ9L [9o蹶nQI7d$?1T;CfTr}>eLI/޹lg ǹ'_-"w 2}i?q qlzGij/+YolƬ wu=@}n eA&Rrbb"oqsw Htj& [[QSy{ɤ#%.d8Z?,RESA$џ2rv<,'zO p핼po=\OgTIg_k^!Ao6Nw>SulF][ᓰk$T4VeSg8Gޗsm!r FYe<7h"osw ϟ5#3 | n^hsC-6&0WzTǴC;|J𛔪Ƈc|R&tBNZ{ 1v{E YК`0 Aaj^h]\0m/:џZ  6/џZ29}4\0r_֔/}TPK̹Ni]E/#3xA5 Ҧ)myA͋6c0cō*FA8KIQއ )ⵎv6 gF߬j>oAlj-dAkxkdA'\-WC6C26k9:%NcD' 3U߻#Q4VU9dnA #|V `br3AJԵNyjz)\O-Z"6k(;U*s+|Æy@DWz#t#}_ fsnta )C՚_MaVC$Wl|]0h/3}\HLڛJ- dΒ e&Hm(sHv3A?N:q?` /L@Fy9B>ʺ|_ Hվ9g]FLF0Au/XɥHbJ.lq*uEXwBP=:1!:sgΔ<6Զn^|L !jM-+}o)AZI(>+3j3NiBqE Y_Hrj~h(+G+=YlKW)GK=Mr`y:z2+鷨==`蔛BrPE9jxGJJnFF6ޙ# Grd )#hD`i=#p~_F?헤Gg 8;V8%nY AMSڦלfٺJ!yhh+k1z3Vܨk@+Ko/o"K݆0imw[6w2* Y}=Qbc}d%w"FsZvU Gsy"5 HMj?*||V&l[z;gbNU% : ?d17E_y_K#Lo~d>B{]˯3^,1>mۊh<ӚUWƳr޲ $TrT2;'1rZ15_kZ87rGjҒQE]y.fB'#a~ٍlt^=ê%d1WrF=[jD [JBbE$=h3VgUZmØ|#A>Zf̳rxtGJv%A~bbU U<DA|6zǡWvὛllѸ,уYƲ$W9h3|.k!3ob$GkVh_u80˕0<(o>o *=YorDָ#-f߳\\9 yVa MM=鎖}Z6EF^y# LWH?tƚIYmLhM L-g J&BE׷ Y_9zxBh@m1hJn㞏"y^<*Z՝/K[g/X->1\lwZB&AT 0@P-dAk< AE YК`0EPB&BZS [ Ay }`b_ Masv(o0O/yMAp ľx@ k K=t .V ; ܣ`> ľ:  F\ay_T}lv?! 1^c^`L\ng6Mt>&T(o0O/_JQd0e %^`0AK @ a y }`b_A0@ a y }`b_B`k|S#ttUt-چ{W 3A?N:qA 4VOd`߭T]:_eKU/ۦO!+L6.`4zFG.Q\An%TrzFC#DwFb\ ľYp+Nk)bs5:dU A/=i<"lw7xl_::Aq >bTYe \ A>,ay,4 5ĸ }u#4z]i8^乾pɜֽj}T#2ϓq:?'ynC`'o5f][ QBG8Zr ľYpy kӒsgg-?ڮL|®yJAP:BzoY`t C@0qޫ^ѫwb\[ ľY_d̨Es Lٿg9:+u@62(+ueZYEvhD :,rụeV׳"ĸ7 }Sdiј&-+;E깤*?U@kpbQ,%gbs]9k 1L/ A 0@< ľ`0/ A֋E*jݺu.RQc@]Ӯ]E] P uM@Ꚑ02#u)@=& 5?Xa@М POE' S uAT{@]< POE'hQ_SL +x*IA ~OE0) į&<QA OE* ėV<6"5-tAO|K{,iҕUe6~Z<gjieenh` )P)[:y@TڈD öTVB}| MupA!ȿo*Ox̘Va>IScUjz*B{?#k)Eܔ x: a 9 A.OYW`\ܭ-mpfN2h//vY;:Z$Y"g{ikE7U9\S3&:9ƿY\<&->,quo3R{1  Y3hy+7^ZIzQPdUdh%(9of&]DԆO9 2';_9&˙ I'@%הg4]NJ_(m6&Fa0> -.<8 }֔0 O%}伧u]|;qkH,³zt_uMy^H-WfiT37֚ACάa eeŸ́ G,woYg:H‰)s=r(U;i#EUGͤnwE:.'ۜ"(} )׆v~+bQƸ rc/o^ӑ B?*2i16B*]\|qi sGn ٙznS,sdXر3Vp5,Z접,:>Z9 x+[ToZL;Ӛ+B{ga4 s eD#G@@ROAyT>\n#t}QrQvif8{'Gk ?{E@wUjG>Қ!Ȩ8Gz=dFάs_EXM._ox[Z8qvrՔmnolblhd_TMe|)Yjl0nk?ZEl8+B{ ww8|A>ߊ E{s5+$ie yHI8#CsNO虎,5/PN6WA~K|m )A68{ϻoK[l u":D¶uA ^Z@uֱ ٙu`^A1`{*ru!&2d4?AE\,W@."-w A@.d$,Q !@www`P}-A Bb[Al Uu#f?0@ ‚` aAA I*&}hϖ:?\]I#L&6 ^E.jk{ C\prz5ÔуzU.7 t"&9qnL ,H$>?$pS+;gZژ:ഝxz <=wRH^imp4qF;bc~, BN8Vn6es-ܜ[,p_ⵎv6 gF߬j>oAlj2p[T||EXYsFgy_6V> 8|=)A!IVr$??~ll SZAڋĤJ- .3%U+ܵ9ej#.|@Fmg~t2RT\[ŨS]w䷡Axl<%%{j,NrՌZ 5=_O /AطMJyID! `+(ȥ0< Xsf]A @*W{sANK @Plo]8l$KJE#!ޠFFpgC_;Zk9ݝ6]`#~hPx//R8Q<t~Zk, yVa΋,<3]#}yr_o} aA:̨7)ζ=vvQ :$< 0Rvw_fSu˩9q[mʤ2wM LU<#rc|"[Zq0pu 8iMF.tu2t [sڶr)AHVr$ X`AX@, , A l  |z"_h,#)"b=n  qZT+Ʊ,EE~т{AԳDH0Sd@VRVhKh 3u޽䜖>EmVY,#J>371xY"oSВKjKM1ZH'KF- UҼJ??~3/T^.ݕw't  9/2M1NgȐ6ϋrf ǥ"2Ka?H-ٺ*=/UVGnA_Vq⻗| AiYiEqQ(y?oL)O ꩭVr#%wod!x4vXf1xfs;ҳ6LenL|}zא!*zy=3 è|ON/+߳ݵ)U;=8tHiYL?%ԞޤԕfM.1T6и ($l%G=} lҖ_=1 %X#C6ʘgR>{KJ.|K,H, =PjoUUnE$#.w :RMgl^OIcYr3tьSJ8@KӞsZ39p[hQ&|LP׉@{iG1,¾n=^6f32 Kq9YC<#I rm2>}=V߬QAfT-F Iyə_N(OrR )#[zXdy1 wĭ*ӻwE%.IVrԃD&X#fAʱxڼ=NC99}Й~F8Y9hKeT_)7 e H#E\ݶWQZpCþvc.L):,m3YUx62n!5'#͙vq26\skD8Do݀YG0}:#P5}+bOߚ&iHIK6 /V&^B;~tQۖ& $%=4_}p~%dp+us ($l%G==ƒ1LH.?ݧ홭m}i{[4݌W;<8dLZxZ`9i!Z g5J ioV ;@4rst A\3fVr/߳3(7܋wi6VEyu۸=$z[Tgd=1y_6\U.eJzem]Ƈ8=Ke8=j9=怽cKdd4u^g ωg_Vߦ9NYzx,gK>˂Lƥ?1 ,H!Htj&B.VT^o22"~8bhM U49eјD2 w=5h‘W!4py>Q_^'rbmz Nw>SulF][ᓰk$T4kSg8Gޗsm!r FYe77uJ |nņ1S'3)lFAM:AglC2r+}i}s1l*{E=VA# :pbR|)AdH!M#C;'>@^B@ v{C6#V7ƍ.f ^M8^ﳵ0v)`8je xW셁1':[ɑ8CPLyq%tVqRSAX@P|L{f:O ~}y:5@ ‚` aAA^ P7$+TIJzH, , A l  S1(eY`nҺJ'd蘆# mW%A AU [!X lV*6 A$t9 ,-9FShϖ:?\]I#L&6 8l|p}{b.OQm΢aHmQkDG]nl-U1V]g"ko9xG=ݡ2WQE]j'kzDN5Rs}%銿s ;Y3, խ#  Sҹmc@ UuzOpewWaBnG+V5Dn6P2Ti4O V^ A$k=󳮲{C*Zyuaa L/<:IM] q_1IoB4Fh;,TJB߮UvxA` /s)uͥQ3d¶h$A&~_gZژ:ഝCؾU0 HDm;i7pϚ4Mg4<k}T f¨vWgY3hy+qAI_5=xhG7/\|ZZoGg 8;n}l(d*Drf<1Ay}9\ol(;U*sXS~ԍ4TGd ts2wNR4ƶmGاɕA&_L0K= E#/&VЉ&+*:Ke&HmqdHE/ʜ<&!#. sLF陠'߯nJQhUw;BTxg /L@Fy9B>ʺ|_ Hվ9g]Wg=8B%^\ZGEʄK*p5:̽eCX46Cl+ǴKx?]3pW ~4[\"gj 2ҹSFm=I~OKFm7+;8+KG'(N?[WS*kS#,yq}VfX/oggҐxT]CwgxVFD[H$tf!n6Y}z3sf yw^`:Ttzl&9.ۼ{:f U]''Sjѩd(+lZd8/=t' A­aP< r:," =dˍP VilXuĀGЩ"H@#<s|;|_C-mߥ%[*O{8wXŦ7/nn8l$j~-GBoJͅ٫B,1%;:z]i2?y+U]xf8O9bU6OyWvAdxVƯ~tpרO؎@/*Y ȃYa"Pt{η57u0 @Ąt  WS9G!#;K=~_T& .д7r# 9M]sG)x@ZYOSQp99F>T1jScz?‰j!4 )W%OKV!}L{Hƕ͕ޙgevyx_Utݡ V՝jyFh=>5 +iݽ6!lѶ%S?JOKs{bZ)S^w FPSW yx";}[12[|`jlÅͦSKjM&lLyG8G魮gm;#tp#EjwQ6rA xάss ͍I܅`_d̨v*ZƆv /K ET͑$*b#ǡA (ioҲ3> lKsYQ@p_=h'H = bU`$A l  6@ ‚8  ‚8!| ‚x@Y 4A$t"KY NElnJk? &m [hw, 5GjkW1 N8kQ/KAXP;,O:n;G:&ArB|i  ;JKc 1 5Zuc59)ԗ5E_?4@`yGls %/rV] aA< 8Y:JH@lK,[KXR"uSGxjyg  /?}NE>"m6Xv%7Bm"5#lܠ&דd#JXyƒM.݈|Dl/K,kOPR{q'A aAApSbz9$ ^b;/llxJVrC;r)n ȂSJ0n3xe7_bIjnqm:laqdǃ <\޲>o-|IJ/$Dz5(~݅`DL%Yg+9X_AD{a%WdlWFGXec|EFL%Yg+9fK 24ř\l;wߦ3|r |O—Vuo`3@ ‚` aAA X`AXy#HR$+TIق@ P;A D $Zox`xIENDB`java-design-patterns-1.16.0/balking/etc/balking.ucls000066400000000000000000000060431312550536300223140ustar00rootroot00000000000000 java-design-patterns-1.16.0/balking/etc/balking.urm.puml000066400000000000000000000011501312550536300231170ustar00rootroot00000000000000@startuml package com.iluwatar.balking { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class WashingMachine { - LOGGER : Logger {static} - washingMachineState : WashingMachineState + WashingMachine() + endOfWashing() + getWashingMachineState() : WashingMachineState + wash() } enum WashingMachineState { + ENABLED {static} + WASHING {static} + valueOf(name : String) : WashingMachineState {static} + values() : WashingMachineState[] {static} } } WashingMachine --> "-washingMachineState" WashingMachineState @endumljava-design-patterns-1.16.0/balking/pom.xml000066400000000000000000000034141312550536300205560ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 balking junit junit test java-design-patterns-1.16.0/balking/src/000077500000000000000000000000001312550536300200265ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/main/000077500000000000000000000000001312550536300207525ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/main/java/000077500000000000000000000000001312550536300216735ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/main/java/com/000077500000000000000000000000001312550536300224515ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243015ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/main/java/com/iluwatar/balking/000077500000000000000000000000001312550536300257105ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/main/java/com/iluwatar/balking/App.java000066400000000000000000000052631312550536300273010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.balking; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * In Balking Design Pattern if an object’s method is invoked when it is in an inappropriate state, * then the method will return without doing anything. Objects that use this pattern are generally only in a * state that is prone to balking temporarily but for an unknown amount of time * * In 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 is changed into WASHING that any other thread can't invoke this action on this and then do the job. * On the other hand if it have been already washing and any other thread execute wash() * it can't do that once again and returns doing nothing. */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * @param args the command line arguments - not used */ public static void main(String... args) { final WashingMachine washingMachine = new WashingMachine(); ExecutorService executorService = Executors.newFixedThreadPool(3); for (int i = 0; i < 3; i++) { executorService.execute(washingMachine::wash); } executorService.shutdown(); try { executorService.awaitTermination(10, TimeUnit.SECONDS); } catch (InterruptedException ie) { LOGGER.error("ERROR: Waiting on executor service shutdown!"); } } } java-design-patterns-1.16.0/balking/src/main/java/com/iluwatar/balking/WashingMachine.java000066400000000000000000000050371312550536300314450ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.balking; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Washing machine class */ public class WashingMachine { private static final Logger LOGGER = LoggerFactory.getLogger(WashingMachine.class); private WashingMachineState washingMachineState; public WashingMachine() { washingMachineState = WashingMachineState.ENABLED; } public WashingMachineState getWashingMachineState() { return washingMachineState; } /** * Method responsible for washing * if the object is in appropriate state */ public void wash() { synchronized (this) { LOGGER.info("{}: Actual machine state: {}", Thread.currentThread().getName(), getWashingMachineState()); if (washingMachineState == WashingMachineState.WASHING) { LOGGER.error("ERROR: Cannot wash if the machine has been already washing!"); return; } washingMachineState = WashingMachineState.WASHING; } LOGGER.info("{}: Doing the washing", Thread.currentThread().getName()); try { Thread.sleep(50); } catch (InterruptedException ie) { ie.printStackTrace(); } endOfWashing(); } /** * Method responsible of ending the washing * by changing machine state */ public synchronized void endOfWashing() { washingMachineState = WashingMachineState.ENABLED; LOGGER.info("{}: Washing completed.", Thread.currentThread().getId()); } } java-design-patterns-1.16.0/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java000066400000000000000000000025411312550536300324430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.balking; /** * WashingMachineState enum describes in which state machine is, * it can be enabled and ready to work as well as during washing */ public enum WashingMachineState { ENABLED, WASHING } java-design-patterns-1.16.0/balking/src/test/000077500000000000000000000000001312550536300210055ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/test/java/000077500000000000000000000000001312550536300217265ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/test/java/com/000077500000000000000000000000001312550536300225045ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243345ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/test/java/com/iluwatar/balking/000077500000000000000000000000001312550536300257435ustar00rootroot00000000000000java-design-patterns-1.16.0/balking/src/test/java/com/iluwatar/balking/AppTest.java000066400000000000000000000025161312550536300301720ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.balking; import org.junit.Test; /** * Application test */ public class AppTest { @Test public void main() throws Exception { String[] args = {}; App.main(args); } }java-design-patterns-1.16.0/balking/src/test/java/com/iluwatar/balking/WashingMachineTest.java000066400000000000000000000044661312550536300323450ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.balking; import org.junit.Test; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import static org.junit.Assert.*; /** * Tests for {@link WashingMachine} */ public class WashingMachineTest { private volatile WashingMachineState machineStateGlobal; @Test public void wash() throws Exception { WashingMachine washingMachine = new WashingMachine(); ExecutorService executorService = Executors.newFixedThreadPool(2); executorService.execute(washingMachine::wash); executorService.execute(() -> { washingMachine.wash(); machineStateGlobal = washingMachine.getWashingMachineState(); }); executorService.shutdown(); try { executorService.awaitTermination(10, TimeUnit.SECONDS); } catch (InterruptedException ie) { ie.printStackTrace(); } assertEquals(WashingMachineState.WASHING, machineStateGlobal); } @Test public void endOfWashing() throws Exception { WashingMachine washingMachine = new WashingMachine(); washingMachine.wash(); assertEquals(WashingMachineState.ENABLED, washingMachine.getWashingMachineState()); } }java-design-patterns-1.16.0/bridge/000077500000000000000000000000001312550536300170645ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/README.md000066400000000000000000000032151312550536300203440ustar00rootroot00000000000000--- layout: pattern title: Bridge folder: bridge permalink: /patterns/bridge/ pumlid: BSR14SCm20J0Lf82BFxf1akCJ4R26ZZYzkE7zxLljJgoIVfu7S2A3v7pLRhYo3r3l9u6CPHwJjAH5uETllpZhKbejsqn86v1a-CExQwj2mdgqv8-oyev_W00 categories: Structural tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Also known as Handle/Body ## Intent Decouple an abstraction from its implementation so that the two can vary independently. ![alt text](./etc/bridge.png "Bridge") ## Applicability Use the Bridge pattern when * you want to avoid a permanent binding between an abstraction and its implementation. This might be the case, for example, when the implementation must be selected or switched at run-time. * both the abstractions and their implementations should be extensible by subclassing. In this case, the Bridge pattern lets you combine the different abstractions and implementations and extend them independently * changes in the implementation of an abstraction should have no impact on clients; that is, their code should not have to be recompiled. * you have a proliferation of classes. Such a class hierarchy indicates the need for splitting an object into two parts. Rumbaugh uses the term "nested generalizations" to refer to such class hierarchies * you want to share an implementation among multiple objects (perhaps using reference counting), and this fact should be hidden from the client. A simple example is Coplien's String class, in which multiple objects can share the same string representation. ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/bridge/etc/000077500000000000000000000000001312550536300176375ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/etc/bridge.png000066400000000000000000001503571312550536300216140ustar00rootroot00000000000000PNG  IHDRDFMжIDATx]y?hˠHP؛:ۦnQ;00RE6QZu2͋ɮU]d%ǓM qb)HԒj[UP]CΐÇ/$.Crfv}91@}ӀF\P_𫇙`Bsu z5~@*@e 4/031HDjTF& @$ B]f B f. 3D 3Em{0خBTaf␈ af=hpg fF03qHDͮ(03-"Knz/ ʻ2KQn eI #]4af NP|v֝~{JBiQ>f/!B(&Bu+ͮ| NĐSy]ڛQ1PZsV{j+qaf/*H`P@$ѩ1+*sy1Oj'Q#Q:n=1be&zQxOӷN7Q_4YAt:Zi^EmԾ=W7_Fۏտ/\}W03΢|o{Z=̡0l rI`P펁36j?ӥ A-ԲƛWUǯW{yCA$}_8,irgk]՞>afB$0]ٛW?Ƃ -]Բx/_~KW{.?7cf e0v <\7}00̌>>יcK-=NM9{iFU7\2 ~6K=lzP L1pU/w4Z wFQn3--Բr}nQk O)}1vG_yKm'ơu#bׇhQӭ%-S1%zG:/{^6|eZHݰ|jzP 8U$Sz3ٺ"I`tjY y{x'to?x]8y?23cZ_8Wa5؉EWHiԈxv͛ĽбD5`k>gf=Fc`F"H= B( XB0ۊLnOE)Փz!*,ѩ<~ziq??uVŗv_94mJsfLah*i =:bf{3ǻGe-RPޑDonHX]TusH= B( XBO03SfBZdSnIZC>8r_?~DOw{ [ i1z[{D 4d7jlf`514_čdf-PQ3rI`PmS5c9mOE6h$ѩe1DB=g/n?_?zztjfs)s\,X36ja}_J|zv[zc5ѣq \/siW"Ȑt:j^M#CTYSiEvJ N!9s+[{>O^~F?GԣLiLzep%D U|>,{Jƙ2xRS1-6pc 7myaf<)W(u*̨mL'"C=yBu5Nռ:uLTZdiRS+cr,n?xk>wX\+bfo2wX R5lM& fi2ΜqҸhʞq,r >]!M̌ +*NoKNͥ"Ȑt:Z7Y8OZslgE-zS1DB=Ё}BÙG㻩fUug.6gT33.\Z, NHS9-t: 6&܆F)l?-CӴ1%ר̳_̌ +u)} j'1Ll:efL(rjy7(rt:zm7%Zd2B>eLlY;L".W)[,[ eff bR"H`P]M-(!щ̌ +dsLY[439L.TGb`D,2%0:Czqr -UIúUj)ENsK`P]5Z1 3` n 4Jr53;'Nfֹ"i.TGb BD Ahn*Rڴ $ڝ,)rJӒՓ.TG{1J`t" 4703r+, =R(4&%Q"9-Y=yBu:jF'bBsS3=JENQ P%0:C!'gF̥r'tZr[t[9E%0]b B D 03 3yQt:"D+'щD!ؤ\G껳4FGڶ~dпMtULeu3uW^lWj~">xg]P. L(K͌]I`t"ؤ})/\j~gTX_Y.efjuQE`i87H<(X;0׫ͅvFs1E03\.T1pZJk !YBpMsn_JPN3~[=FMތ~WGm!z{ma +/(% B( A J4ZF'bE0X͌ww@j+ُD7efg4.#^(f!KӅ N#]ivI1ĢBn V h$-D_Ba!03\.T1pJkM!6:_iCvU|ݞdn>75jrH9Vdf!KӅ N#]ivI1$Ee|n VdsfX.MKkM6Ol -h LL'Buͮ4#щQ[gi03%0]bഢٕf$0:CPnAh003JT2m A Dfj$0:C03JT2m A Df%0:C03JT2m A DA!MZE%S*6GӅ " N&L)L#BujFn{W_=E%S*6F=yBujF'bBsSE%S*6CӅUABG!4/03Hd*F.b B D Ahn D LP$0:C03\.T1I`tb*ܠB(z҅ " N=3<.T uY= B(z]23@$щd73J@ m#A95̌߷solo~~?ZPԣg!GӅ " NcȁW?٘Amf"8afB$0]ZUjFfF{j'Bf!KӅUI`t8E&"=bXv9USFꌃhhU]?I=`..9]f\<|Hm B( A*B 4SHZ7cRh?RNʽ ^JU-vVֳH EݮTe﵌,  ת43rO!қ]8.+3ܼqr\աM~=J.syi/|ռU<3zȧ3#Bu53ZUlhj?}zcfEЮλ]ݭ|\gONPܛY"0f!KӅȎ[UghΟ5{dCfW>6 !-}/\sG3MbY\Yhݵw5-ΩS]gҚn)nZ.4Tڥ6Ļbx+~D ݆ YAJ`P1pVj_ǴVmlϼivY!Rb;x+'}NNkO|/R}_S{uGF{&N#G7wwNڷ'^(ii`:3CYR:!Bu)[UY]VdLC ͮ|nBZ y3|qˏzT~T;1$;>GK'dOֽץɻ]=/43CYR:"BuܪjS%KC ͮ|s8.+r/o>uySm?vN!^Vj넜'OptZgnuL&X_Nf׼|PH`Pe&hճf41ߏcBȣ>8|?}'w\m-:pUg]|4d.0EoadϮoSO V=]{J-nn D5sfŘS0E H-HbotOqU՜ՑmUMπsMΞige*|u}z姽""jr@%v?ɩ_c}Ta#7T}#/a} / VjגȻ]]4.d 5aff/E:oI'N'7wtŎOy`YfQO##NѪ̞'OҠ!pfW>>y !5p*xB&מYWww ̄zRN4| 33 *~Z3HO&O8j8.+9C^WT6J<=dnWns<䲤 Ec_v I(YL ҅n?^Xٕʏ 5Gby^W#rSUUB"23ʒ: XN\WҨVA2l]ɔOٟ`VG qkv(B ۼPcU*Kj(ȉ3Zgi7.}D73c}l'Xt Gօ3Ŷ:|5vq|Bhb A*ffr%M*̽䘝 *P:xRK 64iu Nbf&WYRK- ]_oL'3">f̔B D Ahn*ffyʒCSr F'BP:| viu Nff<,Q4H5QFv^&Sa QN?Ѩ OFvrJg&W>}E{fZQ:z$"5GS 1${Pw>3RVOAO:Í=k}zc՛̴QUɴ޷`ijN^ DCZԶvD%JϡA=7V63x!Jg:io{K>r.ԠљV!dU:WSv 1ᵗjf6Mk\ _U 3mY3|_hIO++Mܴ_]kyz{%0:eŵEls `K'kg_ӿQIIf&:/0XԬ=i3/ButUuޕY ͮsz{%0:Ő|jX`N;^Xm%cΡey!afB$0] Zr6԰%2Y*fW]kCr->>ak*OW?1R03[OcuwAt:b`ZUIv6Ԥٕf$0:ŐDL"1f`BYRGbST4T$x,L+|:$0]δ\m ͮٵ| Ny#v~;j,&vhi?`fl/V] _)5,i<w d;{E%ӹ?i.TGGZU-w034U]˔T^UE=[|S1Eekj13M-K͞.3C%ӹ?i.TG{[US:$FA+ͮJ`tnuɍy֘}mfeIb)+bwJ3b< LcDP[U+ͮ/ N3ƐqN튆O@ 5@BfeIƲjqL=Ld LcD᭪%fWjFDBT4,XM̛%O<Ld LՈfWjF' BsS13첤I5dlc*nfdZ A"P$0:Cf% Kѳ= yt홡錿hj LDI`t" 4733F%5^fܕfZs*T*t:HDjF'bBsSa33nnYұc/,v(9FA?J%S*!Bu NUŐCӧѺ?X^|{ B/IYR9o LL.TfI`t'L<̠T,錢 uTӅUI`tʎ!->Ӥow;T*陡,錢 uTӅUI`tʈ!MI5HWװOZ^8ymL*[U3CDӅUI`tJ!y֧x?tM'+\ۯR/03\.T5HSZ ɵ7)nED];aC A2At:hUEA2'uekYt{Ѣphf5VӅUI`tΣr.>ۜնEUywy&}-I=3%EH A*B $sKKG]4fuPӅUI`tifڳ8B ʒ"M LCf"B*BV N2cȸEˋ#,)Bt:&""d$5 B33%E.TDVUڧbfuVӅ AA!M eI A"P$0:C ,)Bݔt:HDjF'bBs4)KP%0]$i1${Et9j$-9I%EF LCf DY%0:5!9jdf(KP.T$"AY|XF23%E6 LCl D*BFw.i"1tڐFp"GQ B. LVU N,>n|ow]GhuX#s?_,D, B( A*jFkq6ʻ"y_}  3%BuЪJ"$)-[|V5j\\ך\"< ,DZ$ B( A*jFsHڗ؊1QAt:hU%A 蔑GM^|\o[.&Hn53SWg!r$] eIj A*15HSv5y;WW$}* IR%Eh.T@ NR(a!rMcf(KP%0]ZUA"GmQa3CYR)BuJD ѪEdVNW"GP13CYR:+BuJDhUEhF'A1,)Bt:D%""-IT A*ff(KPg%0]$щTPJ`P$"5H1pʒ"M LDI`t" 47MSuPӅ AA!+X4QS4O%E6 LCj DY$0:I!mKH,)B2$0]c C_||ҷQ$P!.ThifZ|:޲x5fm-49j`fB$0]ZUӅA$0:ʹx/,kErD Qd@bir(afB$0]ZUs\!)bHScrR .MQ rI`P&^_HB Ni1$ "yW$1}p&Gf!KӅUVU Ni1$Lɓ~Y5JP. LVUZUQ$0:eQf7qE,M%f t:hUU5HSv5qh~Fò"p]EY5IRL(K%0]ZU'__HB NIbir Mcf(KrA LVWAHF&G Ra3CYRnJ`PMODhUE2fir33%e DVU! N͏!5F eIf:+Bu UuGS bBMQ13CYR  A"P$0:CʒbfPg%0]$щTeI3)Bu NiJ3S3:(Bu N3ƐQSLD8BӘ,)BK`PMuJl1$uؼHG]W; eI*]Ӆ-چfH&hE(MSv xpkf(KP.TGfdWR%0:MVթ~QgZ+FK#䨵f!T 1SjfW2$0:&"_luK 3%BuLߪM AB1ʥh^%2J+BYbHdz+D8B03\.TLnAKGLWnWi Ni1w?nK,/ B( 1Si6v33PFrնO rI`P3fƷك[FiE(SLT3s F,+Qf2EQM%SJt:fjUM]%f2J+B fvmfWX"!GDf`\cSԄX:d3S%0]ZU93nf>g&af3WU NQv GhZ !'_^@to9,y.]T@%`x#=9rƍ:f\zU٘cǎ1Ξ=,:3ALh=x[nmmm-,,?~PqXP'(3o>el Uׯ_;~Y__,Mm3N:DA)ܸqó4̴W*DnBY\~}mmM&;;;u LQEy&tB<HD&+++Ѩ{fi+.]ڷoߩSB<eww 3>~@('ʊ6u 4Lefx,..*Ksf5ܸqﯭ2I(Ko>0riNR}*/@ B<4o:&i:o2 !Jk9~8cN Ls*//,,\z{\Gj $M20ꓢ2dsMlmmai:ZvK.yLWy0 h 7nX___XXfk ygpС .~(m-`fU\~}mmm߾};;;u ԃw߼y=yw2*/&3-D+++Xrٳg92ہ\?~aaP ]ei80۷2uU^f)L oEWަ{9au*i^XXv SN-..0`j03 .]r#uϯv;v:rPFyK@QJs&C;Pm˒0\RT^R@8}Im[Ll Է.2( t-T;viǭ$ ́[ne¤2 fʽN:,DZ4#\pe*+++J;0t03uTnay9]r1RT^8k}}}߾}*^gAeyUoJ uz>Y 3#GԧX^RoY\\+?{UP58*-;tvvv Uʯ *eee%MݭZ:fҖkWoD~9cʱ'fՁի\6B5匈տ dTҶ[03Ht3sƍEcbJ3sK3J73#ϟW P)bx9r13HB3 c30 gϞUJJ4$VYYY~]a`F03Sr֭ǏXffo[΀vԻʯگٟ3 L(̌J锱)e}@Li' L+ym'?I H3PҬ{&eu&8.b0ʱd=%Ͽ4+B,7objP7n,瓏*rl?"3؉=ө 3GbĮntP|v֝0ą7\Q d_u29f6? vc nu<<[FHօ;Xw*h+ HP o⢷PiI5qpE X1v23֓$Ƨv! 3 *T[x[&gofƳ̘U‰.9'ϖs$^;l>ѺSyCT'O2!i~ fW?+p=, GI=&vu{&](;3P+D%j g$O" $FS1fihrNwK3GF}$ @E-$gZgf&)f nk^H9ǤܺhfIW303 @dt˄L j03 @dw˄~3 3 *TC?h4zHg߯ ffATׯ+sef8M8r1п˿⋗.]13H03 @=\N:ʊ26sV4Jh{c}5 *SQ @23oy8gK+wOm+*3u_P7fATẺWU?=c8薡s}4JhQN+_/g>?N33R1VLw'$(opRN=1() H F7޼_ZǯƘyGA4 Nٌ$7%iL*nfq[$3 *Ȣfϯ?_5KW8doxB6lU`f]7* H F;wo}/<^Q~m)oY:F"-Pc;WcH SӽmQ$ӵqkNByVAmBin,Qiһ{ΩR4Jhy{xg?/|O7ɻ8o~87Fnb9 0hv"oxHTIwnp'20J;C'Ll3L@!*ȢfέGxJO{ǩoqW C[1S;`%<7?' ;Ls23{;FZoLtKAo93X`K^yC87BK. H FO};N7|藷O򣿾לOw{ u7WI^0,VlϽDjct>=~&8if#IXw~l2af@D%Y4̼z쎏}77_g~;UDŽG1Ht=!<7'Zl%<33D&t$o,C"o8f{bӚTH 3 *ȢfFi;gnw~ck/sϨǞ;zT;Xף"^u;L 'Cgз}~h].A/J7.7fлb6I(9YL03 ,bf<.g#>=484K0jȶ~nr`f]" ӓh hm4b3 *ȢYffN7ˇ" H L\Yǹ4J$S˜ af@D%Y`fXaf@D%Y`fXaf@D%Y`fXaf@D%Y`fXaf@D%Y`fXaf@D%Yt8KjrO[Afe bԌidi3J 30oJh[ї AeKáelgK><':gcn򨻧:8ffzᎂ>}g;0af@D%Y4h"%tloi}.3㬡][Lӻ`2 yvG[Wa]78_1ܶ4MQ @M23[m9gз5k;aq;Ie8؎VÝ梽s}2Fmcf@D%Y4G`LinB6{Z>jΰos+A.7,3㽖 H l33ܼq =ΖNț=x po^IUwM(̸/i03 ,2=/Ͻ~Fmi7D:,gciO  Ψ-ۿΰF*2xY}p5BcxooXwMr[p=m;BqofqbQ @if_>xaS?u3sY/OՒT'|͏C02whp=N(#7o2nf&zfFI[nOP03 ,{9G_~գ_i53'}Ne!`Nd߉Ms7_Oy#Ƶbb;ͮ"~cq37aZ3_3  43s/o>uySm?v͌ׄ? n30[7kOMIvXXDFϛP3ͅ 43w?鳯>jCh(ЦsXkñ.rݾQ4L=}0XhI{Op6]$원/Ĝh D%YdG^~+ͬ6, v%U3LV)mA+=/%a!H=`(e\:ZRξ E{fb4,LaD=̅e&v!֙@TE fF7kXP΅Rl03 ,j _jT?cL;ބ.d7j3 *Ȣaf 3 *3 3 *Ȣ{c}^.j03 ,<̌}j.j03 , [4af@D%YTgf-%`#, 6J]%U% H fcifEZu{gJidmft杛wյq!3>nQkF^s,OU/ H 3sϷ>ssQG.>>Z,cu({u>Dl٢^& E Rlaf@D%Y~v tNvc/'8·-vu쐷XiSnNT{ ՞laf@D%YwuySm?vnaj1rv%;p֍^[<]6/Zc. H >|>;6ԏcF~?6x͌]N/MOxԝmUc].~hQ݆v!$]Q @٥yi4ڰ? -DrKߢ:sƌmdI _IfATEE3&Ko # H yf&QAu 3 *B&cP'id! 3 *3 3 *Ȣ{c}^.j03 ,<̌}j.j03 , [4af@D%YLYmyoUfIWlXaf@D%Y633Oi=譎3쳚Paf@D%YdG/y]umuȌi6j{垿sridafgqݷ~3ŧWg\3ຂב7$8`YLYwdtk^6>ag6J-|t0Ϗd 3 *"}/\sG3~7%V ~ɵ~G8;ų1ᶷ l8.(:2'cv]+84T]5.?\W5T03 ,;x+'}Nđ0:7`u8t̞͢wsFLxd̽M*[ڣѸ2A!q4JH33}/}1WՏj=tBhi;L=D](jC9{xb 橂.ԣXaf@D%Y<}y˛jc58,a "2\uG ӕ,J4.`LgYY9>&~!JfATEFO}W1nL`K~4mv"46/sNeX6K}re څ(e&XQ @٥yi4ڰ㸅l6 &Z}xdlۯ06X*[41=ItW_Rfid{I3-Je03 ,seL1Ln03 ,;kפXid! fATffATEA33~Ʋ3]zaf@D%Y13]yV]naf@D%Y23^ 3h>4J`f2.kKh2ꛍV{QfA!idcD;,8`-:X/J`rp Yt)e_! H 43s/sΩap۳1ᶳj: #|c!|kƣ EdC´)7A'v*w=CjO) H 43''^;qI_G3v>i^N! VC(kh~룁Si-^ ?03 ,{9G_~գ_iO) @Ԇ>+ܩ63euyS7kjq>;?6SV\0\u|h?DCHh8t/{-wz ŧ/fATEFO}W1Q?;D`ߏ=`3c|K$ug{fXRB.fATEviG^~+ͬ6l8TeCm$XZڗ>E*Qaf${lLORBaf@D%Y^4S,%T03 ,lfT03 ,mf99Jaf@D%Y4̠V 3 *3 3 *3 3 *3 3 *3 3 *Ȣ3Wb~3u*o!N%51m,;gh%POrzi2>id1'3g%dʖg0\b7RNTnjC8fœy(p?lf)cΌou,㵱jS̙9noTNSO V=~:gfV33dafyi4ڰZ x*٤YE/w/aoQiMa ,V{bރ%V3/Ȅ l3SDUbuɳΌЗ3KnfATLfFm(2Veͭ*ͮ_,/^Q @36YUp3Ʋ%3Kn셦fATEy*YQ @$VQ @$VQ @H/g o3m(B6h1xh3C6h1xh3C6h1xh3C6h1xh3C6h1xh3C6h1xh3C6h1xh3C6h1xh3C6h1xa?3 F%3bP/yqܒK˕,03P/ MM$͌wpc΁ ԅgLAܭ֏Sq 08n$̌hrx3uDE33p쎶ډh&(f@qºm d3uo;xz @@f3@}X243ᘱ@@q B13B@sl2lfgg`fLgf%`f: ! f`fZ ! f`fZ !Ző#Gnݺ_=ZM@%`fUomm?fFWqSP h7nطo_9GWwkP2hzLhfhhzgfh%h!agfh%h!a23t sFe fډ9 2m3e}}]e f,.vU @w99t@w̴C,?i03Y3af f@g!tYffo[΀vU,?r33ZE'?h ?23㸈(=,i3zH<;s rd>,_c_f: '_<kޣ?ɥ+o}{uȌfE7rk?Wm$L3٪$njSw@g!ts{/~~\|zE5߲:tD[^P՘t-GweD֢~0H.do,QÇhһ{掸Kٻh{H`fK̼=_s3㟿qw>'Jjw}w7?O#WK} 1Ҝa|!+#ye[ 񧝡ȍl~&y6YsxJ=$yz*?Kѩ<~z?nԊ7߸+C) Lh0܄2_^Etw$0{;FZoLtK![U{6 ǹy^ܳG?JY#=of:̧W>[O~6Q~Cn=ϛQVf* ƛmY~RX㤙`Z&K@-q3C/AO3O1߃f: ~;>z^/~_g~;UDŽGY $H'}'ZZ֑ xff0MIX-D"q*r*i?ƽVxSi`+цB.:39s+[{>O^~F?Gԣ|=QLj`6JOm]ZvbiSz3L1MICIhgŜ? oB.I3}{<;Ujd̬:OOdo:CFZ8R,ꦈM\r3&Ƥ\g{JT=ŪF:vOIyi[B.=ƛ}C: Ʃɷ1#6{CK^'eˬzf&>crccՓѺM7Fs8Oɼے5,?ff tyK+Y+L=`fKf&}Y28703YݥN3cJ)<Y˿ t@w̠B.v3]03f: `f! t@w̴C,?"8orO[Afqd /댙B. ܳM03vaf dfuQb=PYp/m?ҶEok\WqLy_]33XM=pGu ̌3Laf4_x e| N oi}.3,][yӻ`2 yvG[Wa]78_1ܶ`ff]J03[mН3".`fN8>1Omg]lwcf?R^&63pw` J1эeę#E73:I녙(4gƳ Í~'!>pAf& [J)s f]J3)sf531 T3g}n525L|bO*:gF{g03C.faf2;d\MnN!׼Ӷ.d<]aӻ2 t@wI33G_ />Q0Od]GmGd5 1}63aW9̾ñރsdO{*Α9=323څmw^§{x];x+'}NN|?> +0)iCF$hbIpd'>-4loOl5 cμP 3@wI33}/}1WՏjCy,)cƼ^s6NlYlq-0'׊ 4@<_dbf ;7 @Q%s˛O]TϮv3c3Fv3 fs{=B{(3S_(qØKFO}WGKo62?^F0ŜhiGs!>}VڜYLB̙(@w.O{ՆxղsMUZMU3K\"jf{pm`ըQf\:Zf虉]kT3@w63kKČƣ K fF<(5/I13cAT03Yݥ` I :gG 3]ff: `f! t@w)hfXvWtafK33ܕgQO?G03Yݥe( t@wd-u̢EWF)ļc}@g!tfcif**eXyS7kj WW0Z7qbֲȺ5f)ۃB5m}K8t/{-eej|jMʭf: dở{9^#/ ! b sL%E"N'+T8 4[=PP&& j1-K` 8"DA/߰#&@cC濻Vu۵ ꪚZk?yWf4f8LĽƻx}]'U#i5K˜~{>j;yN{ 1B̏_z.,,Gfcwj}0e,k=3J?cjEo!ԓf2T*kP6 x _\3rIJej冘o!bF#[0Fv!f[ⲘRC1 CeF1kkɆo!,bfs׾*Č|<b/3[Ιb/5"d6NޕP6 1BLcZfeHs%shn fo!Ky_{au'٩7l/b9$T}9}l䈙^|}r7T \HN$Y^҉/]Q>ְKS6S.e zQbLh)K-yw0ߤyG=uh4~zsw@M f%K~.|\lgKR2,f}"F+@D}IX(cpa,"0VAR_J$OIJ#96WEK]8kJ>v l^=yգbAԷ :dRhf8Lr)TD;IXۗ'}oR @;21M3t@g@t۷oF#!]VWWዋKKK_̏_z.,,"*% h0&-G+R%t֧ݮ5(wdoRZexw%@2=Z/J,rD;h 궘 wPHh0C9ڗ\X{Ίb,2&Y/$a @e|j,"a0ǕwrHZBлn •q2֔0I/D&jLϡڪK@ѣG1%ftcǯlt\+,/"Q8Hu+a f04@XHXq/D?Ih/U􉒐_S/-y#u&jL4KKKBT#iY3p…*Jf<_z2'_RT7$=bANJV3 L[I6@#Qܿ_H.z&/']7Q%2ڀTǠLR:ۡvŌܼy34/_n3&K\żYbg}'l<{eC,\+ɲ2d_{Õ*-OZYʨ#<eY}|K(RUZq]3!B0"ԋ0B=SW_xdc ⥾M  Fjg4f8LĽƻx}zT֚=I, cۗO,3;KKKoC]ǦoH#i`N35YXXjX<⮻j*J3-u3u?|r;|$50N:w f%cdyyo@`;քc@TExȝ;wv޽-LrB/_t fG4 iM2 G> _[^^^\\䀘(˗//,,Qmq~ErѨÁܼysii IY fJ@4bc1G9qD󫫫 C(iP`px˗>Hٽ{\>n{{{׮]Tud i 1PǴ!,ruuY 4KKK  @1fBXa#Z\\Db`6D1m&^| g:F(iv -i g'Ǵdz&$.\2uuuI!loo8qbaaA4>@2 tϋбr< lmm sǴmzjauM!i֐4͛a$W\A^Ƅ g:vXf> )[,,,&{*'L ѣHP`xLC2FP0e*@'!0<{ f 4NBt B<ׯ3< f kkkiX4;|=0< f@&4ϟoX/aɅ > ;H@O g gXpA@Y\\jX xׯs=L͛KKKHG!G$ciX&30 as -I x>  ̊P2B7o6},0B<t(Y\\dx f/_cii IfMy ٿ? Arȁ_49{X)s(1NE1gkz2*13~s(1N9b>:CBcKw5z1ϡrƀ:/=shX_83;U _5ϡrƀ:qmn#es̡=>D/Ӭ#SE JPUJ_Һ2 1(k}+P9pc@$#es̡=7GMy\ʛ0 o3bY=mԽt}2ډueb3ʶϡrƀ:i/TFs̡=4gЉվA"n OBeFY9mZ)׷|7IK&9n=sh ̨C8=)C}'PG+虁Nu_,#az7@C{h}""XNz:-LԬH^ىU>rȁhf'am7gПIqFIQ|FTDV8֕]$v=/.VڴǴh0asp=sh~j=DĜMέ+3v2}&q'PG0ݭ:udrA2]3lers\wpܑAp|vIڃkq!sݪLB[g̡=tgЏbr9œ}$`uwk|vIÌ >|Zer@k Qp溻U5b>g!+O~G{_ZA,6ܵ 1#m>|`1Cyw@5%k kR㨬/z}sݪ|vIڃ5{Bx7GOoyhsKT{ 㡼A1fW3K%N|YZd g;Nu%WEA_tr{r ֵ܄y̡=􌞙SOο{{O, _?tjYllo"` acdWiJWKt9q+3^]F=[@6Rx}A4e!ZbgdYJſCESr=m6jW&,Ǡ.IfTHZHEڹǔL_WsݪWA(e&JwF? ʁ 9-7KZO?y#^ ϭ,NCb&'ҳe-Vun`-MO0Fs!5N؈4Y<Ѡq0Sk('mGG`ɥv=3溻UGo\k_}ϐr<&>9aOO}O~d>_>wH+W;z㖽rz?i:YԅU{Ny{9B1.|eRfq`GهWf_C]k%{Te9[롼1ݭ:zd$N=&d C{0p9wW>_~;ǟ+?~]iI](~fY^ vQvXm{:((@/}%e⁩r7 eRS/jcP~\#`Xkuw|f#UY̊eq`&gچ/|Ёs_,֨J&b-c&sgE^푘#YyV'By1c[u5#x4f &tCVNgo?!#)b4߉c1i0SjX|{-C,EA-U)|6BQ4^C#[KVlwCy#`X uwӑg5?rg6\蟽d,`yN:\3:cMVVG6 %rM,egrM9^bFjf⹭=qcp=g9›o]7䫫O;t{D{VnՑh&4#c; 恑9_Ap\ͦY&6l ^0O]<Xމe2ݭ:EMp|vICB?ֈMGJw+_[/ৣ7_3ʓ<>Ap4r7/ 6A&@| jJ~$]ݭ::Fn K{:&P9›o]/-}S~=m0,49*6=2jYB<"?ʒNӨ:)OqlI2dwTz,n_4r >g\#|ⅵO-|{?wמo2;;J$O٭Y,rJ:au ̖ஈOCVa.C{ c\sN|o⭟g?9d9)6R()sG*#REb?֝w. eja<1_z\weӍd0詝WfUR,>]Edﲯ4س|<縻UG_4 %=sh~s=kpxߩk㞙~~(L,ܽޓ{#GҎ7VSZ'gbPmKtli Z㌵a:#^$!FҰOOV^/M.80TB,jruGr9n k|vICCM<-/vfV^R}fP 롼g̼GxBow}߳{bI7߼WSb" ?WK9[+#lVcW9 ԣUgĭD$#uɥObua+W5O?y#VԴ 7-݉uBrG:ٜ6 ~a{ߊʹr[sHv1b&_>wH+Mgh1僭jcL#d->"Q?z.s" Ҵ ]1 ﲯbUgDVVb |vIC Bb-!c]=m ~эyKJ̌ r/ygȃɂnpHZhNRcl&rRQZnCզr6sﾯ||ſw?syW,ܡGŻ=j~?զEز2v$Sjcyj-k^18sֱiVrQ:Q"Z&ZZ@&ﲯ}nM\wh/Zr1c7Lw̡=4-3 7$̤AțN$p :|'f{Q0fW~-[DsⵕIK>uθʭ ]_3ڡbYQ3Z n-uw4.\~+g|͜N-Y'MFSk);4%G;rǢ^@7Zc+(2ŌhK >B7Cy#go?!]VZڑJn@Ȯ<&K;Yp/MD ȑ\jiGj \,98>-=,vzr.WVb-`=۔5=ݭ:ze9]A2]3|og& ~'τ4sUB+_RLKSʛwvuP{N6yNX\ົUG{N d.C{hAa+yU/m4(U8lPߕl\e˪YWIWz(o#2Z,B[uw:29A2]3Ў?u&qNύR";aK+IjoZKLb+%ӾNMD6wCy;)6nsex}uw:29A2]3Џ%VnjP#`V-vdre>gšsk:vq!sݪݎL9YK{1gP#`V8BB9B?Vq!sݪGvA2]3@J1C99d[uX#K{X)z(Ɩ[NmSP`usݪG1]3k׻{s#nbnfg̡=RP#L]iY9.x:M5sVaVVP#2 g6,Il)(>_k}ʜ+㪹n#cn.C{ cMGtE%2f'0&Hlin sV+0, IQ\cfv4i溻U&dko]9M)>$ S2[`y+')/0|nwθn#c.C{ cIGEҎ/[Db Th<ȕwm3ƞ-"n#c.C{SJNmzfB0\'}2QLO#LQA9&-%̸#[S>N:29B?Vtm,1f Fz b1$GLi+ٸFؓ-f3#]Wuw7s|vI+\:rLnLU>0N(R5l/ Ewm_*U33 tIa>T3s;l}wr \M4O6.9޺iNsݪG1]30K߹kmOBs__ Uz( 9d[uX#K{f3GX{PNs\w k|vI\b&M\E/jZ,*ivRhR&Uۜǣ9ouK>TC9bs\w k|vI\?]۠tR?-Uظrh\jITJ\|YTnet yzP2ݭ:51]3|W6>X ;f|bfev,+i*x4z'fnWy6\Ttl>s 3dlG2œ4A㿀C{ |34_?i ^Jˍ;}r{0bKxx)oMMƐ`%_+ݞ2=E:y9 `a=x~S,m0=093ҩeqY\ӷ0qsݪcV13! CH#{0K2B 6A3]3^y.XiIʕw剺ǣ,}D.69svuC-ƄIW )iяo v%}ci\ UH_/sھ(i4s<<19d[u;s+fHFU'#hK{Bz㑍bTqGO+H-o2(z.>ˉL?fOV*A^ 땴/~:G!!sݪ\ ˖YVt!D2BpCV~i'{B/Je)$ckw$Wi?:aߕֽɯFR _h61}QrCh f0uw,G.k`6g,0 IF%=shYg}'l<{eC,\+?@+f&ts?v3H~$ff)MX'Ѡ8蕛kDgIFH2B~3}p/-"WATitG,>>Hklsc/zL5ѿ13S6sݪ#ˑdəV1C2BGpC~Kυ%łeLV bF5rwlK3ޕ% )D^ c`%^o$I[eȮ}72y3C溻UG#5$SeL3$#F2.C{ y&[mګDVy_<3 f0uwrs ތ)13$#t$L̡=ІNar5^gwU"f.z(Vn1wFvk{RfA>Uό$#K&{3QME܊k5uv+qWE=bF2k[u8J2Bi_<3C{pv{r [uF2BE_Ti2f>gaпkk$Jb5CifjC<66jLb<޹vkVvt]J UpݴRysjsݪE1u|vI,s׾*Č|\ac)`!iJ̬ {NP妩XZ>K.OԜ㾻Ubk|vILb&얡s3P|34_?i ^J 튙O~#{$iԝ KM2uh A+ 2,u =r LJ+^pjhHW5狔2U溻UX#K{J3~UL'<߮ ԇLz(rï}ox)V[&oM>uLOTS[jOLC e;ۗ6ERk=HSJ1U7VVBZ$ѢV3ke>ga/M+'VT_xچ-v\YǮ;~xdX})bU?1Ӧ?Mܛ;Ax⡑Է|sǏ!ҧ lsWƍQU5waK{C2T`';;JW'UUSMUʳ=x× W+'\42ұf3JhG+y3~i_16c1%m"鶝(f/Vn_d JY7$Q:oI J Oi[M_(ף$'ipH?ɻw\Yp3>tW6!mf)l{f)&/w;ŏ$ 6C/ ϾqZlR6CL2)^hAcfW/grJ=,ރ,JEJ)BK"^j.u2[N fFg"N? j~.|\lgKRl^錱 J^.f49%$̃a90KaCޝ!-|5Fp=7aF|7} P! 1Ǯ;~xdXlwJܺ_Iӷ2G&}2MEf)p%GTO4bߢoW&Ut|C@ ;w޽[={;MTEy~i'{B/Jetr.b =F?$&^N`kIMCFbߒnc3bJ(lnn>bh@ӇU%f]|fهNqƳW6¾UR٢aBWwˋ%gʲ<%I33'o %S]CM;N3Y)!A0h;s;ＳgϞ"K_xdc ⥾L5;%.P(Am|v'F Ij$=6K˜~{>*V:=Jd(r0#Vhaa!yh@a_z.,,ۤfJGHOҦWST-Õff@߿.~F$ơj_eQʬull9I k!fDAy  .h+G^:Obs3P" <ZJR|b/19d( r`NF-%)bBN2 90'#v1K'ٵ=Gk] @JP`J. 90?6v1 4\||NAAiwn0Ih! @) fܠp[IIh! @)<p $$rhb`Vt|_:(7 fBK'KpB5^j/ߩѫAZVF3fp/Bt >E!#w|WpŘVzX f`\} dx(+c1Mdqf3wx/b~k;p/hl΀> u,'z~f1Ɲ*Rz"?bm}-3+،/Z:WYF 0FMy\ʛݰ/NXBeGl60Q=Eh'֕(pAV;+YI\D*pos"-6ʩČu'F~Nʬ=LWm/\} 'EP}Q,2'[~qsyoSw.>J>h])ELw_8 |W(S4u],'#`pJmoQUGfem%cf: Wb5^^;2oM}jHZ $9 r̲lt}!Bg;Nu%t݅~Q*y=5^]ߩwp(L}I 7MέI;[+3\YxjLXO|f}0 Wm\}B<5^]O|f}0 Wm>EOBN;@a35,\}B!/|n}0 Wm>!/xwj pf_TB4N;@a35,\} B x+\} B %zo]7䫫ObM6U~Awpp+_zGBw{@WL Uð[˸p/hP Oh/|C/<ӿ佪AMAFb;[KKԵ|O?wicHfȉoAW!> {'^Xԋq~ǗmwnxϾT}Fʣq`F1mvό.v`{oU]~Af#w|W[;u3??[Ɵg/iarSbx4z0S `B$B gt|13#b~[_T !LZtw{`6|w>~=ѻ7>o?ADW}I6DE67$6 fF/ΟbF\=ՉHϢ@ }S&Ykz1!3q×ԘfIWSO]@K'|7cōgɞ~! 2=,6BC٦pYqbkp/33V}p 뒘>z1'U#0s!w,ߙ7[cU{K04p#eb#t(ȵO/\bK}}/s+ϋbo>*5$_[81 ]F^?[ bkp/J X% AoL8 bwN3-'/ܫ*B6Y3R"f&ҭrͿ5|aRNBT}~b =x_;t!W,51t),R]8h)K3+Ikif݄~QVmƪ/ >ܢa%fX84OS'Ηoΐ;35l/ݺM-O'v{J=H%E"@1J{;.~B!U qBX%p>3Jaeny4fx$wf%S*i'reo̲Tyv8Ci#'Lp=Q/>E!~ƪ/R𸭳w87ƭLN  Fxl*f2* C,f TbfU~QE>r0XQaM3>b%wfUa܄bG9w~11f6ff Aljp/* T}L:h̰/bJ#wf^"6챓bEŌ^`9t_@ix+V.O]E3j]l1S4T!f`23/{df#/\0,4bTžf)b*1S4ėY%/A%#wCգ깸1Sp"ħ'n!38; R-F*Z@5,\} 'B|"';ӌiU{@1֚ Wm>!wppu-T)/)z;+!,\} d5!3;Br1c7Lw_ }5TSghq ,왑uH,i{>ڃifu\n2526SQ|W\\p/hl΀> *XKID]rB0 ]VSqI+6+`gM*' ƻd#MScl&rt'U~Af#w|W{%}+ 7$D$-抙$NAXȻ5F>*][f-[Ds"ɔOU~Af#w|W3Z=E$L$JEHZJ6cіeŌ ۶>5^!"B}b}`>3pD3>d0EkuK虙!\Fk ,43>Pcfbw3STH#db #g |6S类ɖU Rx #W>~rLZ%)E"ߵ}f93.UCN1U~B@v}]>zho0,\} { 5^`#⾚:ap3xѲkFx<1>&35,\}vPܡu=3@ Wm>13q/JjxTcfpZbfU~B#y>"35,\} B|AƋ;®]A k=d35^ }֚ Wm>!wppW >!wppW >!wppW >!wpp @ ~AB|gwbxs_ P |W[qU_ P |W[qU_ P |W[wں5\Y4P |W['9/yG Wm>k̝ߩћQHm^h=Lp/!d\a.1skoQ+o$ ;[~o0*[ýxW3p/h0QRQY\X̜Ļ !\3p/hO\>+~? b& _Vz[p/fiQ)|34_?i ^J 3BBz{z2Re"4FB f6ʠ&OŇ13W>\!c\![^y.Xlf3K e$&!`9C*~Č[B+>W\} jz׎G6:.^f⾔$krW,l&RՑrU}~QF-ʏ&)b㹛֪-xߘ[`eۤg=q(Fvғ=!bl>%^6=g*13UW 19\}kkMqT;UhJ1i*B9̒aїcM%T➸#[]|fهNqƳW6¾URlK,5^r256i[Bo;y}5#f*rO>v l^=yգbAԷsɱ! <]?ȘfL:*&aPr`ǎp/J2TDZևLi\E ʱ:riwBo;rWlf$(>>snIˉő={|ufJY'Gb}̱/e',g"WYa5SM46 W"+O]EmV$JOTv1of-B|g熤TUY3+#d>p[4}':jmKUU~g(93z,]*}[1(sL$]e`]*du4c*Ue@1:/f6Wm>EVKivRJP8#)B|ǴD dGi#I)2@&tOၘ6-6W"+X%.&N̴x !7,#*syH{fhP{>P L Wm>ENKP_dL11Ø|G26u\5q;?SZf:aL@135,\}kH%f}jf)m_Bo; =-_l֞VVʚtOpf_T+0i[Bo筲$&\} d5!3;Bǎ_;x)V*E,FQ8^0A3ɔ03l٢2 F2ҚDkU݄~AON;@a=x× W+mP#1#cWcL:A2eX|DcU݄~AL1N;@ag}'l<{eC,\+ƾ0g+Q♽g*zfo7IO{=3~AN;@arͫ'zT,ʹ2]X13Ō!/ืgjp/xwppZZxn4nYG^t,\} d!3;B۽1S]*b=m3B|gwpp|o}\Xhޞ[T9 1\} d5!3;B>ye7:X'ͮC`1\} d5!3;B~.|\lgKRLꚈ;=yfw dH$0/YČ<T/6Q r6"NU_}V;C,\} d5!3;Bǎ_;x)VI (sw DZ䀙N7CT|0JRdPҖCJ?HČcp/2aߩwp(Lvғ=!be2}m"${XH q{!jHuHuf30ɘb&V_qB0ԃ=mLh+N;@ag}'l<{eC,\+3oBdCf%劙Jzf g)[gp/2ߩwp(L~p/P&袴TُZpf_dxj(4dS>Pi-#nE Wm>EVƋ0 N;@aZ$fS=imZ33ep_dxjćA wj *1 xa ;1SK/0N;@a35,\}xj@wppzkg Wm>EB<5^)\EhU 8+4FE)5ha/Gu `\Y͇xό\Z1Fm3B|gwpp|o}\XhޮXT9 1F4j6B|gwppo}[yw7NRZB0X靁T5B<0*&u*҅g2aX00ك2FeBn+ > \![^y.Xl)fqՍhc(E0g>m:&PCEl *7lcT6sFAV;+dy뻞z㑍bYM`p;:D2%L3nΨhe, TQҖ5Am~|/&N;@a=x× W+3 ׆Pe8>yvH(ؽu61c)fb') q6hA6O[/N;@ag}'l<{eC,\+3]i |a( W3{όUh3Iof; zfZW/xb;5G6EVƋ%5^ߩwp(bnvU~#5^S>PŌLn\qY!/Jj|f}0ވ,\}O{x|f}0 Wm>5^wj pf_x%;om&SJߩwp(7U~M S>P7f(nEn,:W›Y[\B13(fEt> \![|:,!lNT9b 14j6B|gwppo}[yw7NVL3 iBIl Vqhx9 Z\ " jk  WYF 孇_ k/<YRT7˝jIY5L2<{3̆"@ڕUn:ԉ,a'\!4j6B|gwpp,o}cWv66#ur !C櫏5 'lb3@1=<~уXm0C53$ h_RlԃeY!~/HpB;M+%K֚y&{~q1q(FMI国ץNr Wm>EVK#vr !C̛p‴XՄ&@1:&fV Sxu͗m&*=dnߑ?ԕMc>PΉAep_djس'FR>[R+ֻbtuK==3M8&pV̸jjp/rB/eƽCq[2X2%[TvEُv%f1SKVנ6kP]݃(/z4Ȓe_֘T;m8&0%E (KVn5!§Y+XgwpBAFk >-@ ~A}Z/5C΀0 8 b1N<.5IENDB`java-design-patterns-1.16.0/bridge/etc/bridge.ucls000066400000000000000000000231161312550536300217660ustar00rootroot00000000000000 java-design-patterns-1.16.0/bridge/etc/bridge.urm.puml000066400000000000000000000042511312550536300225760ustar00rootroot00000000000000@startuml package com.iluwatar.bridge { class App { + App() + main(args : String[]) {static} } class BlindingMagicWeapon { + BlindingMagicWeapon(imp : BlindingMagicWeaponImpl) + blind() + getImp() : BlindingMagicWeaponImpl + swing() + unwield() + wield() } abstract class BlindingMagicWeaponImpl { + BlindingMagicWeaponImpl() + blindImp() {abstract} } class Excalibur { - LOGGER : Logger {static} + Excalibur() + blindImp() + swingImp() + unwieldImp() + wieldImp() } class FlyingMagicWeapon { + FlyingMagicWeapon(imp : FlyingMagicWeaponImpl) + fly() + getImp() : FlyingMagicWeaponImpl + swing() + unwield() + wield() } abstract class FlyingMagicWeaponImpl { + FlyingMagicWeaponImpl() + flyImp() {abstract} } abstract class MagicWeapon { # imp : MagicWeaponImpl + MagicWeapon(imp : MagicWeaponImpl) + getImp() : MagicWeaponImpl + swing() {abstract} + unwield() {abstract} + wield() {abstract} } abstract class MagicWeaponImpl { + MagicWeaponImpl() + swingImp() {abstract} + unwieldImp() {abstract} + wieldImp() {abstract} } class Mjollnir { - LOGGER : Logger {static} + Mjollnir() + flyImp() + swingImp() + unwieldImp() + wieldImp() } class SoulEatingMagicWeapon { + SoulEatingMagicWeapon(imp : SoulEatingMagicWeaponImpl) + eatSoul() + getImp() : SoulEatingMagicWeaponImpl + swing() + unwield() + wield() } abstract class SoulEatingMagicWeaponImpl { + SoulEatingMagicWeaponImpl() + eatSoulImp() {abstract} } class Stormbringer { - LOGGER : Logger {static} + Stormbringer() + eatSoulImp() + swingImp() + unwieldImp() + wieldImp() } } MagicWeapon --> "-imp" MagicWeaponImpl BlindingMagicWeapon --|> MagicWeapon BlindingMagicWeaponImpl --|> MagicWeaponImpl Excalibur --|> BlindingMagicWeaponImpl FlyingMagicWeapon --|> MagicWeapon FlyingMagicWeaponImpl --|> MagicWeaponImpl Mjollnir --|> FlyingMagicWeaponImpl SoulEatingMagicWeapon --|> MagicWeapon SoulEatingMagicWeaponImpl --|> MagicWeaponImpl Stormbringer --|> SoulEatingMagicWeaponImpl @endumljava-design-patterns-1.16.0/bridge/pom.xml000066400000000000000000000035751312550536300204130ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 bridge junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/bridge/src/000077500000000000000000000000001312550536300176535ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/main/000077500000000000000000000000001312550536300205775ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/main/java/000077500000000000000000000000001312550536300215205ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/main/java/com/000077500000000000000000000000001312550536300222765ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300241265ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/000077500000000000000000000000001312550536300253625ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/App.java000066400000000000000000000045771312550536300267620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * The Bridge pattern can also be thought of as two layers of abstraction. With Bridge, you can * decouple an abstraction from its implementation so that the two can vary independently. *

* In Bridge pattern both abstraction ({@link MagicWeapon}) and implementation ( * {@link MagicWeaponImpl}) have their own class hierarchies. The interface of the implementations * can be changed without affecting the clients. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { BlindingMagicWeapon blindingMagicWeapon = new BlindingMagicWeapon(new Excalibur()); blindingMagicWeapon.wield(); blindingMagicWeapon.blind(); blindingMagicWeapon.swing(); blindingMagicWeapon.unwield(); FlyingMagicWeapon flyingMagicWeapon = new FlyingMagicWeapon(new Mjollnir()); flyingMagicWeapon.wield(); flyingMagicWeapon.fly(); flyingMagicWeapon.swing(); flyingMagicWeapon.unwield(); SoulEatingMagicWeapon soulEatingMagicWeapon = new SoulEatingMagicWeapon(new Stormbringer()); soulEatingMagicWeapon.wield(); soulEatingMagicWeapon.swing(); soulEatingMagicWeapon.eatSoul(); soulEatingMagicWeapon.unwield(); } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java000066400000000000000000000032561312550536300320740ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * BlindingMagicWeapon * */ public class BlindingMagicWeapon extends MagicWeapon { public BlindingMagicWeapon(BlindingMagicWeaponImpl imp) { super(imp); } @Override public BlindingMagicWeaponImpl getImp() { return (BlindingMagicWeaponImpl) imp; } @Override public void wield() { getImp().wieldImp(); } @Override public void swing() { getImp().swingImp(); } @Override public void unwield() { getImp().unwieldImp(); } public void blind() { getImp().blindImp(); } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java000066400000000000000000000024601312550536300327120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * BlindingMagicWeaponImpl * */ public abstract class BlindingMagicWeaponImpl extends MagicWeaponImpl { public abstract void blindImp(); } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java000066400000000000000000000033561312550536300301520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Excalibur * */ public class Excalibur extends BlindingMagicWeaponImpl { private static final Logger LOGGER = LoggerFactory.getLogger(Excalibur.class); @Override public void wieldImp() { LOGGER.info("wielding Excalibur"); } @Override public void swingImp() { LOGGER.info("swinging Excalibur"); } @Override public void unwieldImp() { LOGGER.info("unwielding Excalibur"); } @Override public void blindImp() { LOGGER.info("bright light streams from Excalibur blinding the enemy"); } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java000066400000000000000000000032231312550536300315700ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * FlyingMagicWeapon * */ public class FlyingMagicWeapon extends MagicWeapon { public FlyingMagicWeapon(FlyingMagicWeaponImpl imp) { super(imp); } public FlyingMagicWeaponImpl getImp() { return (FlyingMagicWeaponImpl) imp; } @Override public void wield() { getImp().wieldImp(); } @Override public void swing() { getImp().swingImp(); } @Override public void unwield() { getImp().unwieldImp(); } public void fly() { getImp().flyImp(); } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java000066400000000000000000000024521312550536300324150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * FlyingMagicWeaponImpl * */ public abstract class FlyingMagicWeaponImpl extends MagicWeaponImpl { public abstract void flyImp(); } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java000066400000000000000000000027411312550536300304230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * MagicWeapon * */ public abstract class MagicWeapon { protected MagicWeaponImpl imp; public MagicWeapon(MagicWeaponImpl imp) { this.imp = imp; } public abstract void wield(); public abstract void swing(); public abstract void unwield(); public MagicWeaponImpl getImp() { return imp; } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java000066400000000000000000000025231312550536300312430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * MagicWeaponImpl * */ public abstract class MagicWeaponImpl { public abstract void wieldImp(); public abstract void swingImp(); public abstract void unwieldImp(); } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java000066400000000000000000000033651312550536300300220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Mjollnir * */ public class Mjollnir extends FlyingMagicWeaponImpl { private static final Logger LOGGER = LoggerFactory.getLogger(Mjollnir.class); @Override public void wieldImp() { LOGGER.info("wielding Mjollnir"); } @Override public void swingImp() { LOGGER.info("swinging Mjollnir"); } @Override public void unwieldImp() { LOGGER.info("unwielding Mjollnir"); } @Override public void flyImp() { LOGGER.info("Mjollnir hits the enemy in the air and returns back to the owner's hand"); } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java000066400000000000000000000032771312550536300324230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * SoulEatingMagicWeapon * */ public class SoulEatingMagicWeapon extends MagicWeapon { public SoulEatingMagicWeapon(SoulEatingMagicWeaponImpl imp) { super(imp); } @Override public SoulEatingMagicWeaponImpl getImp() { return (SoulEatingMagicWeaponImpl) imp; } @Override public void wield() { getImp().wieldImp(); } @Override public void swing() { getImp().swingImp(); } @Override public void unwield() { getImp().unwieldImp(); } public void eatSoul() { getImp().eatSoulImp(); } } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java000066400000000000000000000024661312550536300332440ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; /** * * SoulEatingMagicWeaponImpl * */ public abstract class SoulEatingMagicWeaponImpl extends MagicWeaponImpl { public abstract void eatSoulImp(); } java-design-patterns-1.16.0/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java000066400000000000000000000033631312550536300307070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Stormbringer * */ public class Stormbringer extends SoulEatingMagicWeaponImpl { private static final Logger LOGGER = LoggerFactory.getLogger(Stormbringer.class); @Override public void wieldImp() { LOGGER.info("wielding Stormbringer"); } @Override public void swingImp() { LOGGER.info("swinging Stormbringer"); } @Override public void unwieldImp() { LOGGER.info("unwielding Stormbringer"); } @Override public void eatSoulImp() { LOGGER.info("Stormbringer devours the enemy's soul"); } } java-design-patterns-1.16.0/bridge/src/test/000077500000000000000000000000001312550536300206325ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/test/java/000077500000000000000000000000001312550536300215535ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/test/java/com/000077500000000000000000000000001312550536300223315ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300241615ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/bridge/000077500000000000000000000000001312550536300254155ustar00rootroot00000000000000java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/bridge/AppTest.java000066400000000000000000000024731312550536300276460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/bridge/BlindingMagicWeaponTest.java000066400000000000000000000040521312550536300327620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.junit.Test; import static org.mockito.Mockito.spy; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.internal.verification.VerificationModeFactory.times; /** * Date: 12/6/15 - 11:15 PM * * @author Jeroen Meulemeester */ public class BlindingMagicWeaponTest extends MagicWeaponTest { /** * Invoke all possible actions on the weapon and check if the actions are executed on the actual * underlying weapon implementation. */ @Test public void testExcalibur() throws Exception { final Excalibur excalibur = spy(new Excalibur()); final BlindingMagicWeapon blindingMagicWeapon = new BlindingMagicWeapon(excalibur); testBasicWeaponActions(blindingMagicWeapon, excalibur); blindingMagicWeapon.blind(); verify(excalibur, times(1)).blindImp(); verifyNoMoreInteractions(excalibur); } } java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/bridge/FlyingMagicWeaponTest.java000066400000000000000000000040211312550536300324600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.junit.Test; import static org.mockito.Mockito.spy; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.internal.verification.VerificationModeFactory.times; /** * Date: 12/6/15 - 11:26 PM * * @author Jeroen Meulemeester */ public class FlyingMagicWeaponTest extends MagicWeaponTest { /** * Invoke all possible actions on the weapon and check if the actions are executed on the actual * underlying weapon implementation. */ @Test public void testMjollnir() throws Exception { final Mjollnir mjollnir = spy(new Mjollnir()); final FlyingMagicWeapon flyingMagicWeapon = new FlyingMagicWeapon(mjollnir); testBasicWeaponActions(flyingMagicWeapon, mjollnir); flyingMagicWeapon.fly(); verify(mjollnir, times(1)).flyImp(); verifyNoMoreInteractions(mjollnir); } }java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/bridge/MagicWeaponTest.java000066400000000000000000000045131312550536300313150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import static org.junit.Assert.assertNotNull; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.internal.verification.VerificationModeFactory.times; /** * Date: 12/6/15 - 11:28 PM * * @author Jeroen Meulemeester */ public abstract class MagicWeaponTest { /** * Invoke the basic actions of the given weapon, and test if the underlying weapon implementation * is invoked * * @param weaponImpl The spied weapon implementation where actions are bridged to * @param weapon The weapon, handled by the app */ protected final void testBasicWeaponActions(final MagicWeapon weapon, final MagicWeaponImpl weaponImpl) { assertNotNull(weapon); assertNotNull(weaponImpl); assertNotNull(weapon.getImp()); weapon.swing(); verify(weaponImpl, times(1)).swingImp(); verifyNoMoreInteractions(weaponImpl); weapon.wield(); verify(weaponImpl, times(1)).wieldImp(); verifyNoMoreInteractions(weaponImpl); weapon.unwield(); verify(weaponImpl, times(1)).unwieldImp(); verifyNoMoreInteractions(weaponImpl); } } java-design-patterns-1.16.0/bridge/src/test/java/com/iluwatar/bridge/SoulEatingMagicWeaponTest.java000066400000000000000000000041211312550536300333030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.bridge; import org.junit.Test; import static org.mockito.Mockito.spy; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.internal.verification.VerificationModeFactory.times; /** * Date: 12/6/15 - 11:43 PM * * @author Jeroen Meulemeester */ public class SoulEatingMagicWeaponTest extends MagicWeaponTest { /** * Invoke all possible actions on the weapon and check if the actions are executed on the actual * underlying weapon implementation. */ @Test public void testStormBringer() throws Exception { final Stormbringer stormbringer = spy(new Stormbringer()); final SoulEatingMagicWeapon soulEatingMagicWeapon = new SoulEatingMagicWeapon(stormbringer); testBasicWeaponActions(soulEatingMagicWeapon, stormbringer); soulEatingMagicWeapon.eatSoul(); verify(stormbringer, times(1)).eatSoulImp(); verifyNoMoreInteractions(stormbringer); } }java-design-patterns-1.16.0/builder/000077500000000000000000000000001312550536300172565ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/.gitignore000066400000000000000000000000111312550536300212360ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/builder/README.md000066400000000000000000000032671312550536300205450ustar00rootroot00000000000000--- layout: pattern title: Builder folder: builder permalink: /patterns/builder/ pumlid: DSR94O0m2030LhG0mzzkC64KXs26GzlNZw_TcRLADagJwOWOlW8OFcNdE79B9wkN1ccKUdLWoGS33KwySMdalEioC89C7Jhw5zYIfNrIrFybhPUHNLu0 categories: Creational tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Intent Separate the construction of a complex object from its representation so that the same construction process can create different representations. ![alt text](./etc/builder_1.png "Builder") ## Applicability Use the Builder pattern when * the algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled * the construction process must allow different representations for the object that's constructed ## Real world examples * [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html) * [java.nio.ByteBuffer](http://docs.oracle.com/javase/8/docs/api/java/nio/ByteBuffer.html#put-byte-) as well as similar buffers such as FloatBuffer, IntBuffer and so on. * [java.lang.StringBuffer](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuffer.html#append-boolean-) * All implementations of [java.lang.Appendable](http://docs.oracle.com/javase/8/docs/api/java/lang/Appendable.html) * [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) * [Effective Java (2nd Edition)](http://www.amazon.com/Effective-Java-Edition-Joshua-Bloch/dp/0321356683) java-design-patterns-1.16.0/builder/etc/000077500000000000000000000000001312550536300200315ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/etc/builder.png000066400000000000000000001507631312550536300222010ustar00rootroot00000000000000PNG  IHDR&zѺIDATxal$W~I.|@ 8`g;g]ACX` 7K+K1!#8;2GdNl=Zv6&#CJQkDąpcxC:A?^UuUzU]]^?MM@Ldd 5'$ğD0$@kT~D^;tTAP F@G$ `tTAP F@G$ `tT1RSK$Zd[]Oi7\F@WZd[v؟n7?>7/4l#hmiik%2v:&jq&DR#;('ۏd@"tT)XhvWX{b[J{ì𘸓+9IE $Zcd $Zd@ 5H6 $Zd@ 5H6 $Zd@ 5H6 $ZSzKo<*Ş[eb F@GКrHop?~ٷ֜۟z^Z]͋ $ZS&Ʒ{;?ޫ}빟xg#ك0:*֘.^owzx?Ҿw?uT7d$Zcd_o}y9_}ҷ>SWLJwϺǧ)fcMINod@kLn=߈o3'~߮_k|Qdw#Gzu|vɘd@kLO]=_g>2~+EOmg=js$j7;ݼx62l#h٭G}kS|_Ͻȃ "^[o}k;dǗtTysvۦ F@G%^ Ó/οY{Vb7_zd{?d;i$4 5Kwgx?Z|qq$4y\$xr0:*֘."6'Ͽgמ)ŽgQeh+G( :*֔@Om|.| <.~m'h/AD5S@!Q}j׍/Ϳo/IU"d@kJ#DVd@kl"H6Q&Bd@kl"H6Q&Bd@kl"H6Q&Bd@kl"H6QHɶhh6=m6i7ҝg"d@k쨼t=)l:*LJSgۇ=t 8gc}ud{=fCn-ͥaew>+ّEH6Qf"-BOYmWO_g;˺?V6"M ū<%{{fof魘d0:*LB5Fkg=/sm䖳ʧ6FnU^U\.N+sy!+Mz^$Z3!窕o֒Tgg@neƔJgu6dG˕lH6hM3َ^l:` ʒelO# 5v1&{Tɖ+]+˝挓 Jvp\Ւk4lCGfIжR7wYV= F&ƈ;h:g]$:.:*LJ c0:* D(l#h M0:* D(l#h M0:* D(l#hSOJ 5Sd`L0:* D(l#h M0:* #٧Ƕ?!6GoDd@klGoDd@kF])l#h"vH.i7i皃tޘZl0:*6e۹LH6Qf$.\Sgۇϭ0:*$K^"jnuJ6Nw)Ra%PnS:RZή}l' Z~{֭v]$h@/>'?mVHmS-vXJ3[;m[뇞L;=?2!<#ڶɶd+,= CGК#ٮO4E 5ٕ% $Zd@ 5H6 $Zd@ 5H6 $ZSd+$O܎9JNro>d@k&$يeCa6e۹Y $Z,ٗwo8˪-w[^=1M@cdJ%H6 @k$O_|n~xCli驩ze:xct=z6.ްͶDғzI3% ݦW"/kpcٰOO!H6Q&N/7^q㦸)vHgG{ɥG2]ǧõRjٲmgV~ږiIx8&ّc 1,l#hMd\꽫>֏5qS p2`4+%K6k3l}a$ltTI;/:S 1dK@Z[Ex}ԫҞrV8t%U.ټKCH6Q&YȜEGys ސd@kƒlBQ\x ^1 IH6QfL˔Y~2ZMfBilߐ4d@k+!JH6Q&Bd@kl"H6Q&Bd@kl"H6QɎ\}Q2ßmV3 $Z3!Ɏ[1GgN'dGqvV{[Vթ`Glk!A- AuEUˑlJBGК8ɾ{W}pk8,PS w@]\$Xk#8FP+ZfhNh-G* @k$.$9L[(=pE l9 PEZ,D^4 >~Whݻ~+bC܌3&[ *%w4p=hqWK@*@;vwwgff$[Sw^tcE np .?Lho !jU9UKV=":$QtI]6V,Ä41xR `tTJ͕$;qRcЊ$!|ZXia³Ş[nj5qrrr:N)v2 Of[+T+}dR7ͣ#϶{|dv"DI0:*R׻G϶AP F@GȝđigP71H6 $9"ׁȃ&Bd {u:>>xӀd@ %^IT{kgPltPclkֿ$ z)1F `tT pjkܭ[S{PB 4LH +6wH9dcF F@G /uj ֖3ydɾ{YV]lnqg2Ү8ƘH6QFHvj^]]M31 }/nk7?!6=i[ள_vV)?lbc)߃_ vv[z{3 'Pcg$LQÙ1i'u jC jLCd_z ;oMqS fɴҏvdzmk<'} $mOuE:{m/.!2 *o9d GGGԘ8ɾ{W}pk8,PZf@m] g 9j;$cC 6Ɯ@ 0/u-|+dPc$.>>jLCd?n^/Zbgl7Aj)yD ɞXc $aR eYD|HPɇ_}uw q3r̀l2‰ns*:S^_28VdO1 `tT>^zqqqww jg$S=uEg ?>Ɵdc>.i-\e(#ym̄3|]d1&l#@q4z~~>;AiHa"FX dR F@G겿htz"ڍ2d'NG\0:*TVZ-OA^HጙvJ!zE?m C;U F@G 祮 5!r$dqժjz]N]>1 H6 $PfʊjӀd@ %K]GSԝNԸU4 D(l#@p@A jLM0:*ϡ%q0y/hX\ cOBzj=ۜS F@GqRщAAz]AidKkZIYW7$CPu"1`:m-ۜW F@G#qcTA{{{E0+% gYu1 wwBV0~m/l#ac xw21 }/nk7?!6Ma}4 /,P)5b:톴rx%o/wv嶻+ҳѭH6@ա8뙙E ;zW K|agͽWܸ)n|t~;mUL/^ Yސ44r9glmJ$T{K NyAt^mF*DN] yƬk\wѽ&n"\KÕSD/h S{ +/7 qWeR;bi3 Py)3ћN8~ ^t;.)ZT=_q*k:+ޯ־.EJ#Ej֪H6@塣^xK @w888p{yyYIo=m\ q,vɖ 5\qu5fOyhYሰFH-Z֏5qS쌕pGWYw7Z mm63P jn魐ȭ%E1 PS.~v'j't۫r:A'Ns7/^oݍnse3VHёV?\THdZR#Ձ Pu+;K'X j?O]!n(5pC)'5v쉴h?F:iiX8S=uEg ?:K"VtS %P[yN%;dE&Ӓ2 `tT᥮FBZZM*Lodk1×dO%%$BxBrZ(7L$[.O8`I@ P~O{tG677ԨI[-J'd&Ǝkd4o5&W@Q'Dށdﯮ:݄Ԩ?H6 $֭[hŭ050}3?])l#/'0Z+N> "dϿk^o7F.HH6Q FN]Z#A٠'Ju#l#trN8pJlЙ$;brR \Əsc7 a0:*Ix3$,/7%6X"H;u.|xǔMݝQ F@G0'uf&$Aįikkkqqq~~~aaassSkc8N)cKvPH6QY=MAvΎt:(~܋ _~0҉c3GhZ)fpv w;+3N!|WJDJ~4$]G )BS j4SF$?bOEB5ʈN>-Ĵme7Qd͓$?ܣ8F@ N:P㭭-5IV[ZZ %~'"I/_d? ɎI6ζZ;yeH:O+AUӪcG d@:N(̩^]]eP)k92ieej Sl'HGOg!~mgɎM;3?&;rWdO'6WKfŮ j,7.N߬>-68)N׾v|EbPF#.a3#<Ɏ}gl:*@an4ijG2L++L/|A>IJ?}G/ؓV*25ٹ)3*&;2l:*R׋ qXJݮwS|v?OZ?܈C=HDX:b-PDݪaEf2av:*=<ѩ(!_'6 v+.$y̓ YCGȝ3X3:oVb-6a]¿>O?$_D9tTRBZ_ j[[[Tϟ'>q:܊%iIc"@GȞ^>uJUF\MOdq2blwwW\n  %(6l#d#gaHSק@7ovC)qfBK/l"H6Q2@(SHޚg-: M0:*y4Ԟ\Jc#kFI dzԵ71Cr6C[lLU 0GGG^G j(C_kmmm + !{r̙[1!4| [lTx딕 j%{{{I8趆eѭW077'n NS jIzQݮxnt: EP#KE"gP8Axnnn`3}.#_t+&3cѭ\@xU}T3^3⚭+6EB\|n$qe/u&'t\3JHFzZVL1".nd Ug[=e%GſGheQZ5&ZVLR41AxsWoi@?5.,,0RU il&5F? $*ޞN9w5a4tɧs[ xuZz3dCU8>>v@RlwUdnFק=Q+[̬_t+ Kl(?N:^5MgJ-D_ K]NϢ3BzѭHR=* $JzԵ71qk3aغ%rJ4/@6333DV{GGl bDM* 3Bӏ z^6c 't[tFƔ4i{">ǝT$F]YY* -3y3dk8 ʄfzVݺukyyV=*Htlg.Bv|FH9Yc~,yyySO2xh;S =*apAA %̠F(mKcU@$ [pqeee% j|9اl1bNPdC18ko2 AiShYW]L= 0iݮjlS=;;ˠF(W*V -t~dÄpſRקWQ jmCL:Vp ِ;^P ]r3pz_MLc  H6䇗n4 耸>bhS(Ɇq!u jg΋Ș[triCłdCfV=ڔ jm999r\r)1W PMl'u-ysss5h茌hg)rYYYERdﯮ.bJ9N{LeɆB;jְkoMѭHiS{0$~<oPLq%)΋nE*LcCqrr">H H6 FrSs5)[zXqXlH9K>Ԝ"B0!֔)Z!. PelPvv Ffu0bا,8FuH6Rףv0F]K>eQY]]* >B/FK];7^?M}P5l%s\rzAn^zAFvdU@Y)4dS& ${ ZV F А 5d)Ж|@ØYNMyp=nP0@ `jVVV?O~l@S"^ ؑ25;_$덩ntinD $;%,>'''KH6Xәo6y }KS ;HvFdHxffƔ65d^ YVC6LNmmbݜl0'X?LtdwN^+++VV̭[nA!39UJSצ/<Zyгة(Sjrg%DqHvzX*||@lxbNKЕPhv{:V*,=R[-aV8zLl 'DӋ!/'Iv)guM* >Ņ +h]u2/ieIv\1" }=lu2b( L%ʓDLNvƝ!~#?.em@)&L~e{0Hv|⧜(d R[i7܇Gϖ\D}'mt*wwΌRJ,1@3B!r,d#z}F(owg]Gc =KІ=;·׍&)ZE|QA+Mf8!Ly%ۉE| B,۔4zد;F ~{ ?_*O"wr'&e]H|.1ݘzyFA+MN̳Aڦޖ]cN\&$gv #St+!FdWz 9.لdse]]r8g<MIvN3hB_UN*dW߯jٞ& ${4vvvnE(,4FdW\COOOg;A C j ɮ.."jo$04Tfѭ(ǵZ+ dWz ,$04ҏic. *VT $=/AH6ah >FćIѭ( y %GGG333d~>?{ xTl=#*̿A5CNNNJ7Hvc()eu2Iop?~ٷ֜۟z^Zq=ȝ' _62c U+lTZbb ɀdWz la?/o|+7ӟܷg zvγdd>jѭHv̤~C~~?/ynd’|"gAd:A>Wr*Rj~@+G~ =ȶ믮~}uEKO_n}^[?JgsQͦso$R:^ޓeCu aaFG~ߙu{"j-yShoϜ9!ٟzG/gNο]׿$^8=>ónWCtgI}مƌ)${l&3R&g4xLr G,MB?u|dɯ??!6>+?Ϲl'WtD}WJWSnn"?QKv霼6?L`.):Php|2/dvg߲ < ޷ۿ[Lv|H\C8G(I':DنEJl#'Zrwb_U^Wa,@Q b“f8-@9$^ Ó/οY{Vb7_zd{?d1$ۭΖd4@V݊Rҿɮkkk{zɩ!^'yW[_ݷ6ེҷhŽC.4HrEw" l ˃W2Hv|*̙3dRg7>~?ݗOW>/z$bfcBM$;+XSHB^$BjBH?>؅?~O- S5<0lSʼnxwSX4P6:rj7\~y29dWBlb$Ԯ՛_ah_DR!O$BWVsLDNh48Lf  9HvU8>>Yը لdߺukyy93ksQ^?n@y@B{e237MHvyPٯGrɮ .RmH6ah ٙ\~jn@I@$z ,ܒLاu%;򶨞׸I3t(Λ2Hv)j4Xɖ|u\}uv,_g;˺?V6"M ū<%{{fof0=ϝdp\87?HV@K>ez}ooo䇛*ي Og?d򶤼T۾ rYF#*rC.ol&=qd ּ)vXAK>[[[#?`窥=*<$΀Fwʌ)&7l8Ɏ<+2ɑxaR4Ș.9.b14Kv!lG^ /g;TQ<^?L7i$;ك"q77t ,2SB!ed$; EÓCtiad֑l@'Lѭ(?}j>K_u:d=Xg23-,1]Z4^olMy0(FVT}f$hcGk!لdkX 7V3` Hv9E Cɞȕ$h @ğnhoo^g~Z999Rd?fffF#?dfTlq0ha+!d H6ah ٓd̕ea(Ļ] $hmpMHa.IjVVVn %DGi>=Oa?x"*yHAe~r0|0FcwwV]6tP-:Ml ٓGDC8::g $l<}mbQ%x"*Ha. ÷J첡BQΜ93XEZnHӹ55p1-Dfd-],ڮUbX ]*Fc ;񓡙nSk[te"ɾbiJ*B\Hv0K?I sk$2dL^7??Hvv#,{qjr>l4ڝRJ67 o硴?PgߒM~Hk9s;Ra0h6Y-^"C5S+\ AC_}N&~ڞ<ӾZbȱfv:۶7=?2!<#ڶɶd+,=m@!Կx0B5 @YA˃YSLOOu=0P#c$iu')=<ɪN8EK =\rE"'Nk-,r~*:%Y60b!_, pdvJ%[Z&V8t7ѯ]Oß]$d˳, SNHv0_Q5L `?ݡ[ƒrP."66pd .UĬBdSz 1׸Hr1ab~dCromm<v]fM.+9ƞB5Aˀ#{zMy0MyH3gX[[,Ÿ!CYdA =-N H6ah!y0_8j`|6Gpd \ d8Im0*mo7 n=R 3\#Tf)ب2ZgFbIro'Ll#<6Y;/Vqo}ۿ64XQ"jrc%G%A2}h4@AMC'ٗ}{qS;M±C?{(wK~n{5!*Iz޾j37/_VR?کz9fߖrO;>y]ބ9~$M , %6 %A$W]~tbgDc2ᔶU&'ܕ فiUU5ac+9h#pm[@<ʝwopL#եdrrrRJ3A|eiS$./spdLѭȘc$[C'~ֽW߹"6$ ʘP܏`A\J~+W&5Hv?&CGHyr -;/:SAҩHMt_S!F=r=N=T5#߈g76`:HI~ؐl\EadJj{{{sss6&C C#sp\~ZVt+Fkc(B!V9Kd3yMrQ2X$?߈-ln~1f'T4>֖l$wvvn`.0> OOO+==p pLT`,B4չHvTÿXM%̙3Wt+ @LPVl3(B!⾱Mo<}v_ !nn&ծ(o;Ti`Rl?`;pRzwvXkX7E϶Kk}- 8[KyBe/_+ 7޻\${Pc첀 <`(HTgr8ɾvV{ō)zPF?c{ؔ8vzجw=`mH'wԿZ^6[sOڸWzFb)$Okcdӓz̕`HTgfn;??'=׸z{M;>gQyu+ّhWg UEB8kS.;ֳM?6[-V #w%HvEyZUc&+qB\K[aA͠:Oč늓^Kw)n*^(l&,M)ف4jTaKաԯ_"JzpDɎ'TMk#wKv0.tbcrQy emmmssV m_1rQd?n^/Zbg0knGuǑ@^S'NN0;/UWi~-QӿL2GKDEF#S lRdژ8Pɇ_}uw qSqX#!J506p )+|^l#dˆ쁯4&;pB)3*&{eD${gggqq1Bꌁ1z^9 PC('HL'6#ռJS]#Hj8'4R`kJ8է7H!~|@`K*âd2)f\~78@Clݩ`<&YR1!IkB<ٕ $D09aH0$[wZJѭ4gΜ }!Xn'0 Ե+J674j5Auh݊IMTV !KJsNfCdWmF0t:[0$[k*M{+de$PkZѭXoݺUt+@dm.3'''*"+H ZS+H6ahd+ٕL(ʦ9L Xl9::*zH6ah FSv v@gl}5zZ$04la:999R`HT}sssmmͻd_4;͊-)M ̋7ITџfD#٩~!%r~fc"[ɮtCr||<33S2-HT|ɱƹg'P 1&pO^PצgEV8ƒ2geej HE@OlMdɾ{YV]ld d9J@w/ī0Oϖ}Sk@N@S2 5hA7 4֔j.V; }/nk7?!6Ҳ)v@lqm3;;My#$ =X]]:4Sw^tcqiހM%Q@w\vRyi!UiS(ĜS!B>v;,:HL&Hv`.?`B>Kpod&NyKj1S(,u||\tC ~V;ES;SPX@bѭT $2==}||d 3هŷd"d 3 Xl`(κ>j\AQ zBQ"u$042n;??`4,5P HFУgi$04!>RѭxTL$[#XQ MJ6ՎY1L$[#X1Y$042lfK2}+b0HFc9 DZ6ExTdy"IH|]Tn3R uZ]]-P-l]`ހćceVl.M)4x='U]dGLqB$Ӊ:1 d =& >% gYu%xsט9(i.^;;;#$[CP( d0 L̙{r<~Whݻ~+bCTN:63t(ߍTV4Q!rf:Tl=bMˀ$ۣ./.!XCĵ4Yyn$xNAvꉢ3PNh^O 3bbsq88l{ ?H9OFI3r}P=wXtvLl֐PW'g(, yd4vDj4ϓ=PΓMɳ5$/l=H7Xt+`X r./S, Lyaa\48PH)z333W\!"ηzh4vwwn;$`677nS4tfgpgLL:rX /_ 5Ok!BpG}zvvyEtz> QaئM>F[֭[s6r 3Q3FQt+ EBq${a\BDcC5$H0ѬZ[e.>H+(\"}WC"NEM8WALUa(Wb. H#ٻ7µ -9nB4XF\,$0Xq(>>~zµ G}jO'dnvvvmm"``.?aH$0Xq(Q́R/^|Z&ruƼÙD7PtB|Oxd MG|PCLh:!Cš${qvv6BZ kVdڊ_A?mSϺd>茶7NZ\SCdOLGtZFWL@ “l{bc.pUc1Yrsi6/DԐ̬1I9&xF\Tt+ BIvמiYbοͷ?~7Ć+Ϫmْ{vŔwe`y,gv,֑6ƹgϸ6l)@'nu9iٵk[@X)@Tv#m^Ry n _yդ,^~sIAd훛BT]уvvvn] ,8,d|gz~ӹyݗ/쬾7MSRJrd}'U,z)dyCӾJUR:mR:T.{Om敏նеM@8QM( OlJ/?1HPWZ\~%@\70&Hv1x-^}5޻zk^7ΰٞmmw1yEJ*WfIc7I f΀UXpe{BZ-AɎdwr #w%Hv8=1KȃpA G@ŭUg.ovC?Пd}PuwXtvL̔lA5;;@ I0_ig${ҰTh${~gI/urÄ?O~mSϓ]JsPCT@' =FHR4^-azMc%CsvjHOjHHE2@*Ņ( ٓG#$ٝ b|/=^U#$A|4ZFA I&,,,t:[0HDa͑ I;33p"dTq -8<"h_Dð G&$"fg d,?88f/Tq`. .8oA' =LTu:/POWEeѨ!(| CdOBnD%{sKkkPO@qJ/ jH5RCifn) |# A'薢s SJv=?+A$W.r-q=r2XI3 ˥ʄ^0${rh?P}|D'\ۖ+qgG6U3vXxJ5GGG#j5x9̞1,ZvdO?uzzVLTE{= ?!`V dvD>J=īXXXd W@̕[dOlD J^^ܭ[_wo8˪ d/ف "لEFHi vZjH" [xvѭ,a(0 ɞ;;;E`j=7xǯ7#Gڒ\˱*nS%W YMCԆRv0/*d;x5$|E7C!.YtC@_I ]8(%{o ;oMqһ/$M6[vkeJ{+oXUrߒeG[tfR[dOihnwqqQ4xss=+|A ٓ5G)ٖWwzk^z}5$k vZ l/2ᔶ'nZy@ѲHiI>sY%̌# ~0IM'?y LigrN\BPC"XYYiZEDu.#Aa'?O~{npwClk-?™{#g#=F&[u<Pr6T=! !+1^O\CD1S!5${gkg~Whݻ~+bäl9TlGMvGjKʱ2]9@aE7Mѭ@s3!N:?ԝ)Ć0"}iv7fq;üEdgve6'F@RMggg3REԐՐ0T?fHvȄ81=}6d#y)Iř͊L&.0į"/RN*.)$;_J%o$H¹N煉Ӡ Ž1k׿W \[[Y,+:!|eEd_S?m-"C, g>SSC"~⊂g)YXXt:Etz̊t^XX8WK22lWCrʕU𡧈 $ 9B OO_K2Cbd;o<s$;Gi "fgࠓDd˅gi,ٔl]=!U(@&@Hv2dz)fJzxe!Y\\, , HvcN0q1S8 ~(!UKi[6Ȓ<=X,0X1hX c͝V!]J۬+$ǥA# |=-́;BPq6w|1@ÿgTʏ723y㙉:Y>SY=7 =dEfe- gm%>È:ecIzؤ[<a>em; s5 2:,ZH`={­kuv*7mavl,  F lCa5Dv]Umoo///ZfcX"{&iGe#1$VwTbȮŰc嶵j#CO}O>dS۩˺*ei_QI;6 u]ajmssih9s,WZo_<-'yB>QcH1 AdbGUŋYx6c;tuyygk%Rx ,{>rokk+]pyȮ0*cy8Sv0coSVཝ&Y mvl,VVVW?ZQe0.],Ub.}lʴQoGZZan3I;k9+0cc "zC,oΝcubgB؅ ge^ Ѥ ?ǐ0Rv*` Y+ȮްcI kHQӆ1֙*K+K&m1$yϏ fϟ߷o'5`[?VhL b;ԥq/5Y֦Mڒ1f666ZoLl=_o]3ѣG(K?{S Mڒw%L! -&֌ᓛ"{w<&%ϜJ|3rpKUnQUBZ,UA؛~Z̜PGlBC6i,tӀ |g{ag08}[җQ-w]k1Ŭ\:s[!eIz@gF߲8HQ~9a ]qAvd\Vri.[\)]pt3KhFF,!_neOMy=H_ds}j/lg2͗UtZQUf]Qa> I؝LvV%q0{!(nͳ!ːsߺy^uȊ>7-ܑ\0\2s1\jkӹ;9,u%ә1{Oɲ݄P5} w ~n#OLQ㏣zE#=CФ=2ˊ|V._8t@"e`j;N"ؾBE`kl[6Sd}gMȣ&fȂV[y)v٘awW1Ywvg_P9߲joنt>!9d:s\|'adٜJT`?^a/'V"[y|z8)kcHߛcAid< 1 q>,`{jF:n$нa Pw3w";Q^*|TcR!!4ŏ"!7quR^J =t^{˵/l:rөo$llRiO{@_9#Y, H֘ȞI[xKl;_tյC攭~}(/;TH cdKDw"[0} sDdO~Ʋ9Sd13&%oA갓\w"_%oTiْMe@eqf ?e&Xp4Qpn,ߖkf)8?5pfG&EvlmҞl̵gGƒsoc .{% ,?Hl:8h "8t̑-9$`l_\Uv,@- m2|˧P#dk*~•{XӽdǛ]w]9ܦDv΍٧{.rKJlld$̒ɮ&&seL3/q32K+g,% 8B9s`Hߚ&R"YXںU!mkX*Jug6u 4cdKN0|Qa^I ~2* >PYvvvJ`Z{&S3B_0v7nOuԩCi'5jMEmg/{U<ny@ADv-1ڂIjMNQlh46p O|sƐc嚹؍,ZuPt +TZ";nyub9ub$Tᚸ#6K@_j'6O" L2#$+݋G~1^` ?nȮClL*ٵjl#XֽȎ Mlgggsssaa~ 3X'9}߾}e2G1晡Z[:<3N҂I`^N+ʊeϕI="2DE7 "=홭onn*BuIf4idb9D?ƈn |Xu^X wzNֽ0{D6ϋl>Df7677fNO5/j/m|-sه,Zc}טddYy+++i';jbO$[X"Vh Sf YZZy4sFi4i4y{cHn|j+cE>mUXュ}f>?x'd;Q6/iLx&[Nc;{ul9Y&G}4Cwz6i:K+2C#XŃ}`v؃6H&mf/}Կ RM\e9ho2tXd5[9sg>󙗼%?7XM~jO,SەDX%Ui_6HFL|mIθoiieS 㛴c2(7F@'2Bvycqlcc#w߽}+iWF,|1Fxe «u|0V]s5'~+O<w_|{۪4,םm'7i?SL(QoaSIooۯ82yDvM܀EVSw}7polA:{׽u=u9&^>Moz+^[;{-XIf$|m'I:u ox hR@XWe1޷/sٷ,cj._ma[[t" tb xd"{0k9 Amr'OI bzyU堫/ãG?C;sfzzO |i?zŋ<ܷJ]/]mp=5ɓ_bo5K@dKz:8x=ZA&m=Ž,_|񇭧'hx% Gc<*Py-µItu?d29zzX";x4SPڻ T@pj] ԩ{VV޹tƐXN{x8XTTUT/`48qc/\-eO~Esi<@?`٤6ɷn5>uxrM!,f>1\*J6 ~P؉ss*:4/I<%/ƏõѲsax䯉%C&5;Sy@~ ,ٓQdgfo|lٰT(ʊڄ gJL9|&90b:A]"+04iKW9yo/]mpRQ}r+='үRޱ|IΙeޫfy^s-Ήxwcm ";ּ%>Ѯ3=!LF 0~FMSyWh3lpWNzJp(7ٺwûy.(sl.wUij[$t{+Q_NdGz* xѣGS-ȎmJ.s΀93GGI pH?3&&'CKWlm}/?NzD0ի(g!_tx{a?xE'E-ajoɎ̉0&;پpګP%"'y5|B̙k?xr̩9$|<*Whߤ]#翷~lqCkNzD`XlfhzU'IK9mxQVJ:^ RijƅnS;;+,쟷U-mGao"[~.6o90b:%\ivt ~1$l\_NGP($ՇWg#]A3薨3Ʌh:F8bJ,$Aw-H>.;r[7 "{*gOg>d0TLVVG~N8sf̞$(]Ura/\xo5N̨F";םio\ޱ=waF+#[/>_%G|UMjT"'O^5l2]'3"[qG 4ɜTΓ usssyy\6'C3{QnPE~p xP+z̙%g󍂮…om}~qqp|􃭧 N%KѣG֊UNI<]Y(۷oܠk[` l1$?n==qDv(S777Qځ< FLS =g//׿~kk#9?tNe!W'K@dbŋBixB:;/|d^j nX't%}Κӽj[f$ښ;Vx Z NJ YFi$Z|ʰa3m\Bk2ho}< qܺn LJVӧgͶٞs$8ؗSPfdFc':Ѥx _ /^d7Z-¹fN"CT$q+"5 W,K{~ՉBb܇0ZM^펓ɉC b Ic GVDcuW< ?x9oQEE#Vd4:Cݖ*?5rf<]6?1߅ ɓ'-«STm'6&o:߉?l^&bS+8Yyğ)Sk>qGtN[(roPtQIOoL($2E?|S?\ ytu(mfxx5l׮*FD7?}w>~2#G?ck;G2ȩbos'W-&ϙ!ӤT_|qaa!ud2 b%}V[t C򨍓`BF 6IImQ%krF4(,jÔ6ь)ꊿo I4Hs:e5đGxg+O͋쯯? RG'ܾ[(|QEe5dwiAJꊯ ^].+xܹsLaW2v2g1Olȑ8踤X!CO!cʣ9N`:F\3?u^ܭBk&m?HTIhok![Xxѣ|U@>=oKϫ:[ՠN?yjIwDw$)V>EȔS~}C$TKWs6|ㅟtu$XKCk?\-93>I7)Qd{Qy4>?>SxoeG(,;[鱒<&Dv:X5pCٳg8?~\7.>l~=j.kmr,3O4D?lG3^C@沭&mK.]%P~ K/byyi뵵SN#Fa nN&Bŭlw8l6i- '͞f~ƜTj)մ5ѕlfۋw/՚wiCr[d ?!Y^mM<xv4=[PdQ";¯酇?_sk}?/9V/欗e}k766:lvJ; PykNFuij6ڗtm-̙^}]=q2F4 ml`E6 PytL1 ڤdw<5*jDk|cl&kC8 X";x@dGH{Qřb!ߤgtC|u $` X>|DvoѕoҎr]@:ds ǐ N} ?kܤOA׀ѣdRС*C8 X";xsL7GA$ٽ* (tl666lAq=Wwɓ_xg8 X";xtD WىUck ;(s][cH'K@dvBN@@ZJ[kQf $` T ]+]i t1$KKW؏!A,Ȟ.R_4@wc_h@^ y0'S)~͢Ȧ"]I;?tmɽ` |%ڻz1' SS5Dvi7w 8yCLNNC,Ɓj*'9+U=S90fk%Lm2/W65={ ?5?9|#/V^nxQwa90t_)vGdsԩ{VVޙ!I7Jsч6<7ˁjQD6I&FAn[8G'lm'E$;Yf%~ͮe; h$fyumJȣB$wNweEAتi9]6ѵʕڣ+8'1$<0xLGMYov[܄7pFɨD,,^vS/U鶃1,S۪S%B菘oz~  0=tN_+I WjLǐ%͋o%^-yE6s:H'/pke+mFWpNݹ-9y"[`k#*adǹ3>rrYJ1~{~qO?#c`TJdZ>_5xv LJGĒ}=:;8Dj3"%V,: 0tN_]I/9,'T"ooo}ຍ .h[E`TT'vjh@W;"g> BN@@]V#ޅ Oj@W)lf;C P!@' @+$NcH@bYjyOg, ]aXlll,,,?p&;M ^XS-Ab:N@@]VPx/^ZZZ2!9s ;   f :tZA3!aDv@5T + *'^:dmmMC7; K=OΜyFtJvh78Mj< @WD/JcVRA*NRdVO?Ea4W=PYENXQ9S-9:S^+tU9Fu~! Gs$[sD;w$"طo+^Rěe!Z䏽!+4[- y##}"ŬtOD,`q+^RdW28ωYQ3 O˖~Щȝ^pDv#]%t%ūдG]Dcˋ]Bݤv4$nT9(WVV1IY,?kR3ZdKAp&/؊_?p6؟?{֧Q֋g`~J\SBd!D5Opu4z4mB5G;W† D5Kl{ Y$wK|:Ѣ I;|e,"3u1ȦPDyÖBά1P4!*&UIiutpvG :mf)5.Ě'^TT'FyU3`4/V#MMIT*xh>Pقcɳf=4(T:e\۴BN]:rKMSACӦ]y*H39-َnZ'ifEkxv']א.В-?_jz4WvlZ@d#c?io^* Gd !Fx /͂癏V† H_eOq"]u,ez{|+go҇MN{%Ds?Js3ZZ"HV bMQdSW5EJ.qU8fYLDvlZ@dǎih&!ODfE)C [,k AC.>PY%a' JdɠZ)U" yXp^zЕ9Ɵ)Qj>ij?'R=Քlij1𑈱Cۨ^%Umц3jV͹6_3U3nX1ٕ8wSчldBMiǺDvIk' Q*7KoܢDr`If3u~$H$"^y6QdMah5x ;zt cD<)Z@f :q:˳ɑZvZ!^f~1"f :yy?@=jDv@i*h ` T + @<"{91ҭ'nq!O< @Wx%lE6_|(1hzJ;x:@' @+K8lUҞXv< @Wx%*.uFD{-!Ol* VVI.l؊󄞔>Z7w"Z!Z`>ih-ңtð %ʹ)s~g]uCM8ԡz-I@Ӯq$(roOjXԌ/.V>Ȼ[ ['Z>O̱Ye}\,EGtkzTK}N1.7m÷bN UZM6[QyDMLΪas#WVDOi]dOQ,wBk@d׉ӕƶ RliHR*XmWC"<G aiɪIɴ,]:e]YQܤhCRA5*G;vaV'Gjٶ|H./;,-W;sd{h. N%/[s dUH US ?;ҕoęqȭ at2ڒM$阦\GT`ljWHd_dkI3|0mVNb5O6O6"GY&<ȌhTJ@3$$7MtdOA2V򩴻D)N9}![ jF/ffUE:vZЃ]$Ln eI =mq)sԟ~:e`<7SAݤ ߘ\﬒d fx^O+5UAxPk,]v$ 13XFB~T|m-zL+KR|`{z-D)X$eEMDŽ2%sQdjGKYyBm-_oA!8ڹUS4촧N\>|TlEvC\:}oA:Zf'ɞgVIg=D`ljW%[ȨRYK1'I<Ǩz*V"KϟiE0nEc s'8[/ ӂ_V†OH -nev#Rf-U\촧GE-d:? >$'9ԭQ-Ō ]Y(= # S@$]"s8`e"f퓤k cf.OH)J:$=t"2Y75M1_3ϔ1Uoѱ ]C:ߎ&DDu ԛI 8n-UdQHå"{JY$9z*";J*Mg _/R"U~={f󪴻d<> 5JTik2o%3G>P"E|P2 ]-U`ʹ"}<.am{4<%^8[J]-: u5ElyG~h}G^JdsQ@Y>1COpu4޺R޼=y4s.l*IT3\5dϥTdK>E+-"W;sxo}MPP+Y'WcR.zs`<^n8CF 4^NlD݄~B5DN@|^,r[6dOllWD7Q{eU"ہHJNr?O'CAV_׉!:/ +ӊ(Vq2vܨA]1d{Uw&֒ %l;]50+* lMϖhɮTd>L Sqj&K`rL1'U1<{HӸf+D -CԚElZN ;K }ABP +kR Pt сX)JWSpfvϡ0+&Ѫ944 V ^h>XU|b#ȶ.qy"]5!=e?Du4 'n}\A2p"т,:@3E4r1N$BD, 7u+U(Md2TBt5\bwOjIBSDZWdԆc]Z@Q"J+%nӳ"Y @t rXֽ[]DO9F,s6$O kɢ`*  nh]Y7 Sj%šs(X Ph9Lv1#LB=JUnկ9E˫vN׋5ӌeT].ޭ)DvjO K+Qq1_jTVfu[<@G+& P+S+z abkcWqMTKZh֗ ݡS5:䄋(7a{%3bNanX+V ^mf?pޤ0I+/\=n\2iJyѐщ[gX3+fɪW$r{2"OՓq+QĆpDL*pAU9nud^eL!DvHthVL(}jPbi;n{\rʢ Wfxeʣk뜞Dx8`=pCӨ?"NjU:.LyʩXsVG2f$elkqv8Sפ5MzY2VGè%Lh&!wvtaV1O*n= ;H`gشC[+Pw$Pުu:DbEBcU^(2aQPO3USM]-k4&)CybDrrwBs"sMX* l0yQ%G5- YQV$9m;yOc#ՌM׉\1,͑佇ߐA[6&]YR.:J :,Siw2)6O)SvٿYK*)ʰӂ'e~sAw-If…D:ɵ$N)9ұQ9g,>ef?97Ps5 vvYdc$ PR0P$R&#Q6wS!+IF$~k!"{}74t$X&'ӊp֛0.&w!%ʈ,ǍIQ0?KO$~Wܒ'RH.a;ҨUatLOvDGgi/ 8T) كrDKӐ5yJ ;yu]NppTuKz2 lH*m͆cckOth6LPc;j Sݚ{K2ۍ uQIqhh x>ʠ'zIQeTHH®4lG6pٱ#/FS D6(O1OI-H)%zph^d<#D^"yDvU(kT.']Ed9.ȹ "ەu6$NnLa"!6kS8[t?[a% n94Mqm y\P֒'6F=ZXd3Jږ-Չl'jS)ғCCTvhUM6-*Z35v ?}LvD3_d`O;'vL6-PKȝv<.H)"SFͨ Y'99\u>>UiSXv҈ BJ$tO5-D#K*r;e$!Is`h x"D"f]Ժ4lGVȖר^n+9%=E/΅5@YY#ڏҞDR2pTh.zv͡6N$B DΧb egt{y4)tٵFMF&.cHt2PizNh&%7<Ԟƪ_7EHBSDZB5TkR=l"zJٔQvtD~T)WdɶA"hvKN@TJ(1 ` T h,ug! T)tˬ#= D6P7 [Bc&Dv@i*h ` T + @<"{91ҭ'nq!J;P!|h>"PbC@O+Xy91 1EGZt|"5";>> a x [E{/IY-0g6K$X%z\ذw>5, / ,X 䄰n o, tdBmG<\ՐV^.Z'@ Wd4(X_y[#LwV '1IG{1>Xj(/V9:dua|SfENeU-,ɽlvs`5DJ%T\X3CW ^L]jIS1-\mѸRMO†ͥO߱}_/J': ;gəq3]2XΖ FNY V⭜ME)۲]Z,xi몰倏sA]"[a9 "<w ai]d5&]LXq^hBۈe5 DBOϒh5z4[ў<޹ 6l}噏f Ot*vL;y4RUdg-Fk@OPQnp!7Tݡ^n&Mn4TӔv5U!{^{¢QeS٩瀆W.}i`A Wj*VdqwƧ(h5yi.5/BW% ǐ S%@j; I1BFw,{-~.PDiMJbzoL\`E!4IDFƁ"ٯx# K]Yb~(3tԒfr*g77rkCIQg uOM#?v_SMAKk`I'Fv##y|`1Q^mtpcMM2JɛGvy[y"fbvўy.GB~ҩHؙZ1O#'# ٔ=Q[U3FJQw0q`9"h5薬A"h1v  A8t30A  ~mmk D~>|w<wٟlpeoYC&-'G)!! l-\O<<,=ksGE׳kN4KВM,/u,{ꃅt D̠B>Dv? ՂkУ+Dv𳴿ou]l)c]l3rgZݵ:O: h ` miO6'O`E&r$Up*@Wx% J{<٠ @Wx%hgˉa0/91+>Nh%l-V ^XS-AbU8ٻK + @<  (@׿p\&6B Dv@i*DtElLXG;bJW px%ʋ;_?<=J;P!BS]"[=~v~BWԒ]X^y棱av xK~r dKu;痤>f*YtmhPTdI鵣dyxKW%D5"#@7QځP-_ ;/ALE?]MI֩Em<-{/i]ҕj,QV{Q9}ouECߜY/_yKHXϭȖJԶ:&_O\y4)Lέ3 t֒@:Y|G|B#RX7%^j_F[S W0\Ud됵vNsDi/沦9C~NiK,-ysiRmu|EJ[PkI evFR/ՊNUu#P%"@: 0 Ow~0^.mLՑՈloR[.̂=[:dO]E˄W2.$ђ]-K-kL8vTUu[|}Rc1 K:-O~o? '}1 ń.>ӏM wՑ[gas A~$Բ7gZ>p_7?|q~\ ypɮ~5߯kZqHy#ZƗWŝںRH]Io+?u*S" 1D[I8NpZj'}3|ߟf؟l.8K+.HC7.%w"fvsD6_=zX%j8 ~'Տtjt,DֆrD\C7~j4h), f*Py&+ûޟ;^')f;\$4dreބkK|ṡ! ]‚t~($RR*0f"; #s[[bf|}Ft݅֔*Py&/ڇo}r㎧?N?N3l[ EU\n>*W a';pXb|#%m[:u V` j(i(88[ՆS #qX˭ zsЫaG.Koe*爳|nvZj@=䭛Ⱦ^-Ǟ;r#?{m\v*٧«Rn#<=[FSOR؅ [ehAU8p!>&['jG,†4OB7gV|o~ HIa&xMh>%Q ;W-x:S\:l7X#oE6gxr"A`.uU 'WBjFHKOHE3-w|-@t͋~A*O#U3+0Lo$D.QnUvZT>6 @e˅,Qdwli+v[h9k"ys1ƙ:+(TX7v[)4Rd'XG'I,47o~&`4jź٠l=]J;P!@' @+K@dvBN@@]V(@Nwl_W/?o=Ӏ],'۩T4Gt {Y+(4B,\3G/Ko{I\ڹUmRyhǡFnJODaxtm"E@&o{>t˱{anZ/ڶ$\($LJt! D|a;%k's ZYh&[MWjcK6u DvtE-a- xad3ou]l)#WiꠟhD##aTsFRҠ apMv^u?t lv4Z ֳEv4PlIFZ䩁%­6PKTKx ^cc|鿎a 06| 9yh5Z$|4B,\Ӆ=N3ilEb!I`Ŗjr4mME.&]ctmH@TƲꙷ,&bl(%" 7XP3d]-Y9@:!y&mJr! yvo8ȢP3+>4]KVBNd1[Sf\k>yPSc6mu>Z}%+W=!^GDv !ZX";x@dúa;+uVٰn hx%hg@9UlT#iԒ}]/,㩂Q ֚ G Џ1D+ ֚/Uif&GA]Wڟh(%D6  `0XkVJd[adng6צR}@d`P ff}qB"bV053-O~o? p|ɘhDړYplelDԾd!LC׎'Ӱ_t'fR @d`P f:}3|ߟf؟lP{)/K 母*Si(ٯ ͕[-!a07D+ ֚Do}exw{d;"[ UGB϶%3i$2W3p $jKI"xC`Nd_O>'۩قԵ%sU'ɡXevȮ-%m_l  f:}S_[=wسG۸vkԊl%[ich!iK+_."-!a07D+ ֚>||ûS>GAɎ>7䚙`r F->&-!a07D+ ֚O6˻ga}o8X*9Gsz&#%UM.LJzl !Z`֬b4-#d7>"bV05 LdC;sV|l*%D6  `0XkN@Rٳdj֥Ȇ` k͂@Ȇ` k W@d`P fـ+ a0X(hZ={^>\qm`0Ad`0 `D6 `0 VAd`0 `EA8.IENDB`java-design-patterns-1.16.0/builder/etc/builder.ucls000066400000000000000000000215211312550536300223500ustar00rootroot00000000000000 java-design-patterns-1.16.0/builder/etc/builder.urm.puml000066400000000000000000000047361312550536300231720ustar00rootroot00000000000000@startuml package com.iluwatar.builder { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } enum Armor { + CHAIN_MAIL {static} + CLOTHES {static} + LEATHER {static} + PLATE_MAIL {static} - title : String + toString() : String + valueOf(name : String) : Armor {static} + values() : Armor[] {static} } enum HairColor { + BLACK {static} + BLOND {static} + BROWN {static} + RED {static} + WHITE {static} + toString() : String + valueOf(name : String) : HairColor {static} + values() : HairColor[] {static} } enum HairType { + BALD {static} + CURLY {static} + LONG_CURLY {static} + LONG_STRAIGHT {static} + SHORT {static} - title : String + toString() : String + valueOf(name : String) : HairType {static} + values() : HairType[] {static} } class Hero { - armor : Armor - hairColor : HairColor - hairType : HairType - name : String - profession : Profession - weapon : Weapon - Hero(builder : Builder) + getArmor() : Armor + getHairColor() : HairColor + getHairType() : HairType + getName() : String + getProfession() : Profession + getWeapon() : Weapon + toString() : String } class Builder { - armor : Armor - hairColor : HairColor - hairType : HairType - name : String - profession : Profession - weapon : Weapon + Builder(profession : Profession, name : String) + build() : Hero + withArmor(armor : Armor) : Builder + withHairColor(hairColor : HairColor) : Builder + withHairType(hairType : HairType) : Builder + withWeapon(weapon : Weapon) : Builder } enum Profession { + MAGE {static} + PRIEST {static} + THIEF {static} + WARRIOR {static} + toString() : String + valueOf(name : String) : Profession {static} + values() : Profession[] {static} } enum Weapon { + AXE {static} + BOW {static} + DAGGER {static} + SWORD {static} + WARHAMMER {static} + toString() : String + valueOf(name : String) : Weapon {static} + values() : Weapon[] {static} } } Builder ..+ Hero Hero --> "-profession" Profession Hero --> "-armor" Armor Builder --> "-hairColor" HairColor Builder --> "-weapon" Weapon Builder --> "-hairType" HairType Hero --> "-hairColor" HairColor Builder --> "-profession" Profession Hero --> "-hairType" HairType Hero --> "-weapon" Weapon Builder --> "-armor" Armor @endumljava-design-patterns-1.16.0/builder/etc/builder_1.png000066400000000000000000003200411312550536300224050ustar00rootroot00000000000000PNG  IHDR IDATx} \M>bE(ʥB{!\hq-q)2d!*Muό;5huX=Nvy>kgok@ @ 4T@ P(@ w@(իWCW>Bっ@ 8)BJp!B@.Z|G G@ %w?p!B@|,C1((Q@ eChᳲ:Ԃ_5o޸YF)S|޼9Znj|G G@ u߿̙x.Gۥ0/_f{zv:u8S-7TwzP޻ l߿3i9lX~ٌ2+kglTskע] ү^MSG?֐~`IɩD@h(p!BP|߳'JK߽;)RV?yNFӈ~nQQ˗us6`#_stZ_9k(Dtऒ#W|G 48lp̡C˺tq6Q\-RJpj޼͚5255-[Z^^]AL{zvb$Or6#І@w;g͝;Ĥ@@3NNv"D@h.p!BP'N8+7lu|{7fM܄yV2-^}|GmFl۷::99q&99aC/|CBdk6Bp 9+Q# EP6T. /\FTl%nھxq|Ӧ~ve$wǽH%ژ/*ʔӌrڙ/&mmggq ;gޝ>}ڃX!xqV|G 48l|};h7<|xm6VA:tof!!6570Ѕo'k|졤$4=~  .dkT|G EP6_>}zL銼C]fի^([D@"@("ߑN(B ]D@"@((EK(B ]D@"@((EK(B !~QVtPԟ(Q@ eC{ՠڃO ICv^۷@5"w?p!Bh>a'['3ƅvR}VNhV yRI$D@"@(+O_<1jз!Y7ITsۅ`A.E(B }ico99cZz~(#m!|OCtWm >|OkݺĉCLLLJBeL$zNICEP64W^?x|V8&sm#66=gV^wm4_[[A!22v)(Hvk,##644jjҲB͚Zgī@@ 8lh|o>i~Yﾟ?0Wz.KkW~R] Zwwgh:Ɔޝ$pꢢeTڽ{[(UA@ 4/VՃ4TX{^!,zz-fAmS\8irwwZt5>N? cb&A}ӧZX׻wӈ|74#=FWON+QJc5owi'qC =篊D2LJ?0> 5Rڝ)őOom_Y;p/]O6ԃ_~ SE>yT (YY~pj7oܬY#)>oޜ [7Uj4qC /7[oG§ߦ`r:2޽ORb*C CHVV|=ڳwot(|iLeg@p eV 8!ag`b*C CH+VLmvVJ=!a^6m{wiy@/fCkixy+wJJrnjoh׸q艜56occ'"]qV 8!f`dT@xG&S|y=7n$˩6>~+A[CLZp6Zkee=ڵkWǂW=5}Ap:pRpjr*GB20RAb*C CHxǞ=QZZ5V~0g%%ϟg^=f`[Tevݺ(As;8pF;g))A}uNNNJ< T(qв.]bcgg˩$ÇSm֬4nҚ4Ꚕb֌_wjbX򝳇mbRPoaek';ICpV 8!Af`"T@xG''hllx6ٺu>T޽VVIInB<{{+ߌd{Vd/>>#G޶m#Yٌ\휜8Zٰ˗Ts ! VVfqq!5yy!x8vB%y!A)(q6e+Awŋ6͵h|ԁ2nl$xQQfkδ4x1hk;;ˍeXw9{uww~$Tĺl KR9!$>&'GΚebЀ wYU~.ELewddaaz߾ut ța><Զms{{ }}׷HYN3ʐQM5TsPR t  5*TNBH27'^)/_Nz(!OzczAA"PWy{zxg?ֈ8!ޝ vww|ׯs&OiAZ#GZ5Y~6lĉ|OIY3d676PￏQ7oLC>>tqr%֭!iKmڿ ӬYcVT@( E1y 8!cqq!KN4i|}p۶@3DŽȓ<Ǐ3?큽xރngg sGÎ99q ߡs8gOlys>wM;w(Le!QIsBHЈ q!/ ߧO_33c$ JwD?c{i=/X0,. C*0!JxGFLH$%y!A#2+N۷͘1D~իSR Ԁ|'7={ܹ"eӻw';th ,*ʄUhwN' ;P%CH#&$<z`iԦW~;?sGGd |'KKS f}FrȐP{NN\N}oޜx< e7|G "ꀎQpiM0D^ΞGHRF6mA/쭭͠CYGGFk5jiYBfM3gC@py@QI;)>kig"5lh QP|Wth W?{wbc2ʺڷoQQkmKU&d*$|y=p]h+y!AHY.b*C CHHG{.=Ns}V}ߵkсKkԨN{L$(or@ znĆzhى|%j3YBi>NZ5/%߷o_X|'׷߰a F+ ✇"2?;4y|-5z_e\˙4wyǛ^=iu }[FzP޼bbH᫟ZTYtKsߥ#2"64&ey߿/OJ ]hABBy20c7vݐہP01!!Q$$~)ٮC׏65|z?\alU3d }0dٳ[޿#YF>??,h!z܌wr }5-`+Owcʔ99qЦu릤>(țF` y!\VxDV(|tw&|yd)|Byq.`+@[~f} OY]ukKjƏ Hv;/썍 ?z}[@ =ewBmFǪUKJvţqC ϞeTuLLew L38uc}~a|Bj;S֋#OL24ѣyTVxq|D^~T5kjթ۷os֣GWխ4inݬ2;j~}W6̔A٬$4Fqw 9'Z&y!A@WNfFVFy$y#q "AwsBH|}L122ptt{ ,jiӌP& }Oqskcaa|TKv:CC=oo'ONZÁ@֮uĿ5%%9thwF۷cp 9A,&11KoFLew|GjqC 3^ddDQ…1(Ȼ_oq#[h`W.e@(߾Ĥ.( ~:u&&.~M>lٔ7Y5U#qwxP^F- |uRx3H055$gg;++A S4w|GjqC e;! |J2[W׵li 3\H0]byW&-g9`@R B:th ;ceNzCÇS捅zSS.]\66%l5KRnժ hS޽& tiikk׺~=-I l!!HQ#A;RsBHP蕜e[(8E +8H| ?%e¾lNWNV|G xGwfqC U Ks(ޝ$$;]yr9NܺKʻwGQybQ>1!!Q& owwgPo}:ga힝0-#{V_?6uH_~ <>`@''[b 1XXl:cR_4kر*TNB83pqq6 A6OLews`3>>tP~=9..dɓ& n۶9vZD\E ?v̘z;yܹaǜ89Kس'c증;{B?< [ 75DHLewv9sm qC_|aA5p¶A\.8y̙woT>'߿oyﲛ=]9!$`-1!!Q+N۷͘1D~իSR Ԁ|'7={ܹ~NޝС%(V f$[\  @W&9!$`-1!!Q@ԩM^fU`G;w.)eoӡT@xGQy&n!  ٻ qC ʑޝ&z]\^#GV*Iݺо1?w+WvkΝ+VLcoոaSE w3Y1✇gYW 6 RR;:ژLrww&l ݞ<95Cv5kƍ=l tqiysŋG{۱y/^`_^^]<8T^"+kl%% q9k@ӞF(NcddgtR"ievÆ$NZIw?LeDB]5qƀTqC r2gxys\J(W7o566LMz5 *?>\nb 7}FʲջEAת:IKƂ_<֭T-[s'׷W.L]]ד;(]vu,(HH`쑭M8?s&F nD}gzݻe˦F2r!QT33n66ff7hoie&"Փ8!2pO|+T˅7o%=..C O2,3 7 @-ӫMZ|jNIzeh!A7Ҿ:YCs2gw'ZhkHSظ[UNSQ(Ҡ ի\9ڌ=3I509!$zgGdE*m}CBFۉ|1 LMM(Mﹹ.]Jq#ۼycR:u8 M…m'?$sG=y05Trzp9{v $zvnW:LeDCB:ap.KH9rb6 і& }Oqskcaa|TCFz8{k8oMIInFF,|eǏdabiArE?qC eFK}&O >0[Y _&)).NL\@{Z<#é]ۢ)/ZGRmO.g/_fCϐZaŅP?dlq޽s' &v#FڰaY twɗzxQ23ʹƍdHo^t! $5ʷosr51 …m _\|ZȎe͚ZU:64rɹf9!$ǥFōN>s$ nnfݺ%y &TBf$u릠ݡ] Ԫ"zr&+WvتURO.gP Wnek9Ynzu`qBMPZ;LeDBL~'d!4OV}ϟgB"c$X1 !iMZΘ1r. 6q>,Oo2&*=^έArEjqC r2o<7ό? U JKKS @/Zc͚ ᫣ɓ?J5kj2.0&fdF>1 9TII]I$}v,*ʔa?$izͭ mR>!xq&&u^|WT@T.;ʔ%|]éyBQ.D.CK Κ%)C<˹P6E}]d|Y-e\3✇gGBAv[{w(] bAAT{"|$VIL5 OcG)N奚(R蕜]CB<{{_[ 얲sl0))5ewzDž-e\3✇6g[X,\8.&fKU><+0:(wxǝ %2?;_|_|]IvвŚdu#=ܳg,<< 55Z__ :kFABOm:?6vY(H^Ȫ>2 ">2ݶms{{ P;SbM}D-[Z׬zҔDsǎ0;SʚQ}秸0Y|jizzv/_f7lhY;uj][։qAIInFF,| _7zg߾7o alɔ)> Kr~`5owɟ*>=zУG?AĔ7A?ￏzHllMLԾpahhX@dD޽-v(,[6b\?ԬX*z&hyyj,XK|5jT_p+(Ȼ_NBLew|GjqC e$Msa'Wdѫ )oJk\\H-?ZkjjJwhOޢYƊZnHD69Č# B a;X;N??:ӧ7O1('iNm Ҍ-'Z.b*C C;RsBH(-k- Ȋ#+T"˗wc@4{7MV3UЏN͛72ҥ# ml,H{:k֗ܪUٜ@t<#MB0E}]d|o޼1ʖֳgSE>OMqsR9!$-<-l g'|Jvp.WP4#S?zSzu N{B<{{_haHD3UҲXw1]7)) +tŖ;w_@S "{F(*m t33׀b֭-/_fC[mݺ)b(kkz[3˧yVPck+-e{iǂ8= _~HV55Z__ |4(*|gWo/ >=VT³"Jq*8!9}7gFZ*&>>$0Ћ-Yf^mhsãC͚Z99q#׾}K"A7m*22$uqq|^ڱdg#咒ܺu_8e4[x@C%4;ALewɋh+g*?֩ 422pwwvmwiiZ@bf6m)~hb2RXN04Գ2 ׃ϞWsNR6(y8!x%őPzV* |R޽;D3Ir?MM_!){,~~sg8-Kfr/T@xG3U$\\Z֘ydwb9rR[WW(E{EU9q(((sttсO(C & C*>ruuPΝ*:SE1 ~tU|x1qxq&Н^^]I'lLO_d sȢLFߦ2MZbŭZ54 HɈ|͡eF֦zj66YYkeWR PӸq艜5tHRfYB yt钉IDDٳgϟ(CMII _n;Q}23$@veSE4 ؀ZT,vNmfnnݝ;iEQQ@цjԜj@ɉ#^vL~~Jŀ0M{0,|![Pfϟgj_|AڵkWǂW`쑭?e JA+8! Ŧ'nݺdR%T@xG"Ǎ8upBWW'"9g>40"wpP4[beF6!Գw bE"24x2tpZ_9kpiY"ŪA^9QF-\~Сɓ'I9""h ">!rpy8@Sm  I-s' t~~ [̙#}ID dwt)ƍdg3;޿ϛ;wI]*=zpuuԩ_|ѦM֭[W^iӦVVV 4-g}j֬]T@xG9΃-"A;޽reyaaZ5a>}0H[цSpnHaz8:0\ҥDׯ'`J{0,E;g'yPwwg(@ AְUl5ʱA+8o߾}eQQQaaGݻw7o^v_pٳgrrr=zСڵk 7n\~}ll˗,Y6o޼ov֬YӦMoѣG>>>8p`߾}{ս{.]tɩe˖͛75ܸq ~`֩Ctp5 ׯojj =mۺvssswwݿA!>j( 'N8e!!! #""AЯZjڵ Ao۶ D?H}^ލɠϟGa]"euGv-فawנXgs6gx ;-[6NSEjT@E(ߑEB޽{A׬EDH@F~;P$N=T@E(ߑEBs(Ls~at$ᱽ*`SEU$ߩk]sY)]"j!g2I;?b\xK2O;8dLT M4_!594i3l>T@xGd-`fGG"#Ck 9ztU& fhzuڵ#q֌zmu6D*BhՕt–UNNP8w.,6=e W{JVXZR^f$8!7PdMTEPpJk`tx;O&qî01!!Q4$({ɒ1CBFii Rt R jrf(DD2HU֌zmLyM8;aGxV-ݹ\|=MK@]D yQh ">! 4Ak<55D^RRx@@?%>yV F]8"!i g'A߅mRgIUK+??-y}i}̑Y^F"ˌ<]T@xG ~~Om:vlݻ#R;hw5QIYqgN.ZGRի={!%߁H*M^=zF{P(cHTmHP`FF}'w5Q8pvŽWʕ&"w(,Lutt(ܽqփ|t)_O7/D yQh "!$F$+}-߉]HRҢrw5QlىT11tu5{O:Mt;06vF&Ço)3⁦w%S9]Uį 1!!Q4Dq*bIuQ+lR\(nJޛ7'lm.y\!y!AiU#/ |[S^rH,*ŜN%+HLewiX"2MԊ8!d` ReЍٻ }zzv:uxiKR<2T@xGP{eygJv6Q+✇1g4GGssH&ΤRACXKc$Q]-eJQy7o566LMz5ʌ)CKpTrnrmyөIeB;RsBHc;uP"I9Ѥ۵k g؜pTrne̶#TܜNT@(E(ߑEB`ߐQ|v"9YݯզdŔbG/VvlU]HȨMR>֟A"UgjǔӜNMT@(EU$f.AynfdĒ |&Ng4E^kX^:Y9,8[ٖy0SySEU$ߩY]sY)]"*2I;MOpqiQ/( |2pqq…bb&Y[ŅIe0!!Q4ãYaцȠPjAB]դIoZ^v]["jy-Nd]:="[W99BܹxA\ٿ,RRj48ؗ2#9!Ts3;Ab'xs:Lew1 ^r̐QJ6pڅ> >Çӧ}F; "HpC(EKLew1 )*u iShtIItcw([ml,`{y[pz;<;wjOa^_|9sdp/i2#9!`|-1!!Q4=ɓ#&c߽;)ESA|WJ C#Jw)t;k{JWO.3;v^f$8! %2?;0U40"y8.]M<8ʔۅ!|0͂??? w/0lXGGK_Cׯ'圗WW"ˌ<]T@xGObrj#ysgZO; IJZT.&CDC- "ա|'Fc+9sK ޓyHpCBHN!SeypNNi191!!Q${?ES'8!d` z!C[Yݽ[%1\vrʉA "ex<  %y!q#Ast177L*e}Ш}:jǎasGD'~e >??ͭSi 1eRvrcPyT@(E(ߑEB㼛7F_lG,8}Ш}އ@^EEw4iHc6J;s&zjp=p>''[.l%uNrʪA "H"y!q^l ͛C|Ac/ٺu^͛7Y( 6)Ϙ1>ެY#T.;B);9%ĠT@xGwf<8/87$d)_wN4|www622b. 8oY$V@rJ)! 2?;P#58!>yII-1q>hT߹}\•+;髴kKy>P,+vG(e'4(B,✇50\[Ds1'zyuewҶm+).vG(e'ԟ(|W{ڔT5qC I{Xt2 Jg>3yڅ=I|3^:ٱ+CD )/e=V:="[W99Bܹ]TzA\ [{JVXZR^f$*pC ᜇDR(cӳ:th9lXիl413:dǬ]=Dc"eSBqNNDzXawyD"}|܇٧O @3 w8(@X12#Q✇P(cRT ^Ӧ橩 %1,ȖaRK%{(.DʦDNvGZ!9WNŏ(g2޼9Qfos2ʉsBHP|'yz;O0j(YFC=N;u ҉ "1a{(hSR9!$('g&ыT_?ۭ];;u% d*Ԫ 2?; ߙO"J8ڔT5qC |IL$wwgR)F^aiiJ֜ ='wl?݁ ,ji̙x|yoѣ=MLؕtpAKS@IKݩS'TLezBH$)✇ݼ055$gg;++35j }}{䚙Ĉm[m\\ZƍdPo^<1 20gN9hYF AAAu" ;P}BT@';P#58!>y3^7o%.r߾:y=?0߿Ags+Wv2jVF[y~Zjix:fZ֭O*׵li12nw*2Bm!QY9!$1  Eʗ/o'-ߗ,v?ldd#]ݢUf76éy6kvHD-(]n+:ut_O洙c{=KPqSP1!j "H"y!q^RR8_KL\@;[BuuuLބ lܸAhh@xx`i'$̳Ps2Y@~-/_fs̱K51PPN}BT@-;P#58!>yJ33׀֭-k'!@WW~~O0;L)J7|Wc)5PD| N<|ZZBW#ػ74ztcGeFsB8wyDDA.Zb*C Ci#yPA#".A*_IBJcQ7930h<4pZn6 Æ +/]J+ד"˫+eFsBlسg}ؕ(EKLew4 1=\HdفSNBqwFm9"7&%eM;u65543?9w`l f3eFsB< kܸŋ ߟ=ˀQEk9sUSE|LCgH|n&UЄ0ysfo'tIsBK:<|Pv+ONLJۚkccafV۵x17\Ebui04(VDUn&H{kל d`dV\VfmmV^Ԏ\Vw hb*C CH0=D'v3D✇={aÆr1Σx(d@kk:q"4.)ȈO먍ڙ3RRWssIΤZ1\sJ@ "wHsB#T~4QSY;6F򦩚5Uo+/o#QkW8nkll}jZJ)!&2?;P#58!>|7oկZfc>yt z)S|@&f6jl,;vP@Ӊ "H"YdɻwT=zi2sΏ?V=<9`?dʴﵵk]Vz  E*/_NԳ#c0Wh:Q#!QYO>իٳgU=;w899yF]Qiǖَfg"Wz}mRR8fKL\@Գ#c0Wh:Q#!QYs4h0mڴ/^v!_~lҥڋq5œco`P̩:Ed/saa:t${nmzf[12sJ@"5 EKWPP0zF:tHIcc ;iGL@ڱ1-eKKSG׎a g`||(`aaEd F;E|ӛ2ɉV\H1PvlҤ-Q÷~kmmoU`wy;i>>^xIҠA*4P*JLdJ(BHH2y"29Q"Jy_wp:g{|}_Ngxs^qQcCO997Z)^ QQA >sf=j n]+ /7\1Lp("7.f}o}\k^EEP?0UZZ:rH33\@?r׮uC*<|kכ.u'Z @ w >Y4weeSmude7=/a Ϟ7O)oi} ۨ p: {vҵبQ o~}qYһl7myo߾IIId>0gmmm77jwB6:(h1z2oHX`p}0HECP}G?x񄌌ɓ>hZQU3))alv߼9:wc}o}>c=j ^C}=ck}F Ө=yrqY ͮl7zmܹb R0u=ھ}K}&8} h}N]?XYffm {4w7;5lh' X6>|80!qeAZYo4xy]^Pc9\.ƍ wp}0HECP}oh *IIgCZKLXp\÷=~H+'ϬZ5 d5nW. &xkk޹s礤f͚UTT$G&R<== !"aG ..޽ϟ>]@**s^ohܹq'|{뀴R߯\Ҹȯt^fW6[{vΜ90=0Q\\<|A:mz4PZV#G"p}0HEC}Gի]LLt~sR{ǎӯ/::ZhCM=)lE#M}o}V;.]z2?>jZߛ]ox{𡺺#Ӆ DAjjYjjj-} =0#oncDQ$Ȣ!rll٣\Ӧ ԩ[h Zfw:9Y5i}]ѾX&xk^UU޵kW]]#ᢣ%$$Н=7Qa=Ęd-cDQ$!?姯FUU=haq_qG.\Ҹ 򚗘hbbbddOcrܨ(a\.u0#|ii;w m,VKKϴZ鯕(aG."mt5~߾}l6{ŊD=0F]pjrr!3¨ }>ƍ 5ZfWksu?lcDQDu@FǍ׼c*++߹sGaTTTdmmmeeUPP r0k\87hysGfQj'" w᭕׼WM:5//}b̐6gΜZgءf?mM~o2v aMܗ-,0Nd64q?JmcDQ;WRR2|qq'N[޽rK±Z&;5W~5]87c-5`Jm&i~Z"&8}7zmx{Y޽'w jh8<9kGlժnֿ7]ӅO'|z&Jm&i~Z"&8}7zmBzͫٴiںuϗ ΝG3pAҵEvv+Me.GhSPDd64l?-G w >+ ᐒbii 6V{/u2N͜: m1ty|/c׸p;ohyy7ٱcAVk3Iָ; ?~~~dqݺud? ͛?|rh=z.\: F={.X^ZrZA[n+<.c׸p;o P_GU…M ,Jm&i6\1LpQ=ɠA<۷o}#Ξ=;((#6گ_??|5xꯚ9˖-p8΂]CC#550<lT^w ~nݺՑy͛7/Z#6U__{9Ѩ߻w* ͓`Ϸ)..MB7r6\1LpQ$=:fzѣG|Цn߾u,;j. ob֯_xa{%KH7 wp}0G4iҞ={H>gH>Olmm!y!`}b?΂ƍv ncHIJJ|Мݻ|П$$$6SPP֭[( ٳgݝ91رCJJѣGAncH}G 믿Ͼ9sŋa3ܼy5+,,>}̥K`m1cϟp t&"HvCkii~Ѝl6HDDj$O#hUUU{{ ,XrssJJJN񯚚'mQ*?C&Bp}igϞ94/^9tS֭srrNY\.Aڡj͚5,+88:w)))-_.J BBB+22:ѡEPPt !Ν;}ܹW6(//ʕ+|:H$&&0E,ؿ_p;֮];tPcٲeh ?ѣ)~VWWקO\a芎FOPG߶mۼyÇQNK.~NQ{ٳbyyyUVVB~HJJ肊F߾}? 6u/_/_DA0L._.\0b7UWWo(7o[ff2-b*t+tvٳ3gN:QmiggyGw?&p}]Ʒo߆:W(;):}9߾} 222%e?СCEEt?^CC"o`..^8d ݺuͅ۷\. *ɓ'QOLL§X--aÆQmqFr áx =PwutfSRrmmmjk`ccqFp(www7tuu)5===SرcRRRIIIATSS^Y,V@@@mm-t׺=<>>TСC222Cȑ#G]nŴH&4Zr`ʔ)Z@)49r$thjjB awQtqAsNwwwK patNN7ׯ׮] >盵իS=>|y )#\ZTTØ wQ;j):-cjj g{tAEFF***N0YŋR'?@i^RRzAh:t@%ҦO>gLz6MU]{guuuڨ!AݻҠӓ>|: ȼx:RRRX,gUBSBh&gϗxt c \EΫWz o%%%;vNьH 5 @C}}R0aB߾}333 BFM]GGǓ'OBhѣGOlIuuuܔ]ØwѲ|roooڽ{3Sh͚5'NN"???55l D>=I-𡼼|رEGGKJJBi*ĝ:u*,,Ҷ^zy:mF\EK>}(t]~}Ȑ!)ZTZZ*%%s -E C 2lvHHq ggg͋bEEūWBi۽{ Sg6kĉK.Na ԩCLLL777NњիWkii@!ػw: ={&--Mٓ2}ttN>*Ε+W[KKKQQQ)x*={[OFӧo߾:$%%)>XDD>ղetuu۷oGVUU>t!BRhtBs.!!# <))))ɍhwABBt?|:E K,/(("/_quue?l̘1 `e #G\|9t ^]z::t@0~a]T|QJJ :E3ƏOũ?%… h1o?g ӧOCg!ׯ_NJyyt޽{>~~~)A]]{zz:;;C0z]TL<:E3VXn:m6m-i7o!uV"\LL eoA-[@!ϟl6%lkѣG9s:Eݹs:b̘1GNь}@h[FFŢz <<>|zzzCgۛRR> t>};SO\\t >Irr2t %\E߂ S4?g{4ht jffʿ>aEEH,mKKKݻ7n^? СmŶm,--S`-.Hkeee? 'h'O:i4nܸ0qD*/@cII@ ²rJ;;;' ٳ'F)8q:WVV&&&F(LLLݻWh N &Olii) ՗,YpBCC4B0: wڵ+OԾsOUzzz3f37ܹsɟAAA$dyyywޅ§@4N'O>hȐ![{Äw;~QSӧOrrr)ˋvg yt1b#g-lI~~ SܹCH0KJJBZ׊rH ?>jriwM wƪܹ3z*“G O/_&M\tIFFf酅|8MSSSA-}ݽ{7tAEFF@ PA ̡CLd03ÇS*::)꯷7t >4hԩ"zYTT`@5!C :OS>>>_ ˖-z-pt "aL0@3zYZt)t ^}UJJ :|b222 5x333!B ?аEM^?99YUUu9oϟ?r7e`` yST!t'Usb}X N?GgiӦA_YYEWWWzÎ;Z,"**J\\e={9s:;w̌BCC{aKV\( wf*..CAAEE)ns⠃𯴴f㟷 ZmKHHܿ`͛7~x NAϟ@ zRTTy&t "\ߙVVV)qt V7x`)))166vwwgҥ_A7Fjj*`6oߖχB {ܺu+t b̻vuw>wf;wMSCBBSu;55 )..644Dw! 𲳳Ǐt֭naiiiccn"hd+,,xmBU&NأGdsrrZr%t \ߙI]]ŋ)oٲe)ueMMM VTTd``Oipu#F(**.^\8;;{xx@ LFFbIb.]NAL"|d ;\(==L'O;v,t t٦ 龞z(tϟWQQiz݅:::B SŮ]LMMS`@c~!t <\JJK9"4~THv)))/^2%%:y\nll,t"M@ ӧOiN_{z :eq # pҠSCeee)n}yyyZ :PW8pKJJ~O> 2 l={4{g@);v9[`0b4qqq***)[Xl+t bhjj2%$$())_b+}ĉ3CJJ # fdTPP#t aA2fain:{l|6lիWSC!{  ׯ_p8ǎk;PcQ]]]~oxG>~8t Y[[_r:]pA]] bp}gԀ S 0(+WNOC *sNA %%m۶A! ݊#hf}||G2OOO2d#W'!4A3g@0H3J߾}ݻ999ݻwNA04&fƄQݱct\r$p$d B99TBt/-**a`p}g111__C }||S˗/R͛7Ƞ!0v&%%5c ECS͢ݻFFF)hС 5V)0 qykkkz5t }b1o4yyݻwCGee)SӅwٳg; Q\\\OBVZrJBh"d(((èw9s&NG>|8#Ldd1铜޽{OvvvI8ܣG~Jsʕ=z0u }6t !:pB uuukkk`\ߙCYY͛7)5w@+,,rYST*..N^^~͚5d^W]]bvIrrr$$$hw~wԩ:=y:y,,,zam!>}$..χN!;v`M#jҶK.gς=))Аj##G._:p[ZZB"111O>(99 zQ o߾'B FB(z Қ 6aƋ/`c߿ᠺLw>ܻwoNsɻ ;t Cϟ?C ڵkGȆ;C8::9r:^|t a ѡHJJ:vtfTVV񭁁oߠ-++III T촴46MOA[[;66: 2ڵk)ȃ***A0T3,+##: :w B pa’())I444Du"v7B5KNNnʔ)Pכm޼d{׮]E2 0oQݹs=w&xy^SK.)%66VZZ O@{5ӧOC/_uAi^ii)[Ǐ'&&&L8SN9:7m4dsvvNa 6n8o<EBD6Ioߊ;w:ߋ!p80 mxY޽L撙hb>}Dܹ:=zdhhl߿GtQ8 L:ޞk U46D(jWNNիWxW[[yfԧI8ǣi4ݧz聆+)PPPЩS'gll,:`"wګ믿… ŋgΜ B^~rA*//wrr222 #.CPǧO$$$SGZZ:-- :Pqׯ햐0N{7o411NA;vxxx@D^|+W `YYŋ-7ke޼y)`,]Tjtuu=zHo޼ЀN!tTO>p8$x4T|Dt@w'''={ɓ-ߗ/_Sg޽...)`ѩSWðF߻t°ɌKJJ:v ΝC/Q*&&U7o i6\z|\\b#27n +x捊 t R=x:k׮)++9 vԩ#F@  ?F֭[﹬h4K)uо}&%%񽓼0v؅ lmm$%%~  zZ`قu1p}7 @e;:I{III1~ѦP'իǏ'OD?UQQ!`TSSӥK\ d޹j}AA0aPqG:Pxzz2`X,QG=^8q9m(ܹsf,tt[xBѣGzzz)̝;w۶m) ֢_cǠ`PNcv6mt fFM-\p)s>|ߏׯ\RQQ۷Bjsi[tsYYY_`dBBBܠS{완D~~>t #4foo Bq!C@ zp8A|{AJKK=Tψ92== 222bT<277߿߿̙3}tF<\ wڕӳ$$$:S*225v]ߵTUUvZtKڵMJJB VyyV.]@WTT$--ͰQ0ccSKEE! 7B%G6_DDy)/ߌ󒒒"~FoKMLLw ͛)gdd@wYMM͚ F$\w)HBBB^{Μ9/R[Pm7n '{ξ}lʕ+f~tҵkB3p@a,@GÆ NaDLMM]eDppT_|ա,R-++\{r6nO>~brrr8< _>x@BBbΝС222 ]?{wCEc!\rwwߺu+t H߿޽;t AO)%%%A0Ӓ&uWddt hxƙ3gPk_n񡰰PVV=|RSSi&4&DuVtfWSS\,Qp233SP zvNa~}ֽ{_'xfd%%%0lvRRtmkkYhiҤI~=%%RWWŋ"YFF$N277NA!評t<B說~wƏRZe˖#GB [QQ޽{޿fTTTZGhѢVГ#t xgƧȑ#}W1p}I&ٳ:dddҠSTTT>t򤤤ãT4QBylllߖC#"" F>D#@f͚r-;HHHB ɽ{S9uꔁ~!!!Mxaii?Booo֭[=z7n\vvPSwwug[f};NjGNwCCCQo߾}_8p@VV6%%TnC==vͰY^^l2sA#*g )(!++ TTj*|zFkL``f]ZZҥK6m7ot 277NA]DD&˜w:166}6t R)((YGQFAyxxKOnݪ'}C<==G-GGGgdd0x˗/CHr)Аa/aw(,,ԩ'!i?YI^^Aoiiimm-Yh0ߌ굤P/Zf ڽ{7-ޞDѓdWBnݺ@ׯ_0z6.\0tPd:uSP‰' iѢ~{ŋV Բ픔(**pSwAwXh \i}˖-)Pq7008utv?|0]n߉--v8t۳gBF*jժ+WB3fCRYYY}}  ]wޔX Ú; |RMM :++7n@ԙƌIII=~۷oQQх 4$ + ]v%qss NA111 ~#c\ifϙ3:³gRQQ!''# vuuIKK)FFF E5h\4`*#Gp8ŋ'Oۓ\@sBYf͞=:weeeARJII"@ֹsgOD,KKm۶ANu˖-[z5t H߾}Ó. 7oG̨O6m b%&&իWWh߾}B= icB[6  \ߩ?:%&&r8T2e^zz:ɇj'O a=9պuSǕ 螹dac-[,X:]}Qi|KS̙3b„ }$*UVV2KQtCV\\<`޿G^^‹Deeeennn77ˡC\g$ϟ?occÇ = ]SӧOSPK~~~.]Szu k;Q%;vRZZZ<3g$߹sGZZݷI;"M}}„ _={v@@l*:JMMN/^+bPp}Ԣu~-[? ##O>x"_~sBTn޼Iƍ 'Nٳ~X$4:khe޼y)0;?~|)HGGGD';ZgϞIKKoڴHW\\ldd4g5i$www$eeeK,aXbbb *0~{/.S(~;L:u)ޞy+ ۷o\naau)6}SQ\QQQ߾}=QXX ^r?>>>ݺu#tACA`sijjK1N9222>|NAE ,غu+t >}gӯ{{{+**C84ӧ&АqƚDtn%K@`kkk&F>\ߩ%11QAA:Eر:dff-++3f̀ ~/"))t6l6>wW\A:s|f7!14SKPP%/_NA?>>>ǏGԩSC@~~ˉ}a̷_8y򤄄ܹs#~X۶mN\ߩeȑNNAQo޼ЀNA?eee҇gK^^Q;LIIa DPڵ/Lxx8H*رcii)t樭EC}4\)=tВ~k׮A\MMիW +T(D٨QN8_ݻwOYY!33T!VLLT`0N!O\ߩaꂃgΜ BCCQMqƯl2#1FFFr@@?IIɜ:ucy y%uС:f :pSŢE9VD\vmС) *{zz*))%&&6 Eb3ޣG>h ꋊx6CBܹsؘmYRVV]o3ϡS0t p}޽{E۔гgOU\\<|AʷYfĉb_RG䮮nnn$D^dSUU3f ~stGNLhM N ݺuBu:t*55USSs֬Ym^WZZ*%%xPZZBppp+Z>>a(wp'l6{ݢL~z|DDD());tp}'OC n]v777f"g99={4999< 9SՇ Я_oCڹpႝt &spp d7 k{qFFF=NA!rQQQH]]˗JDʢЯM]rʊף򪨨 pϴ{eeeLf`̄;%ˣ'S0nܸǏCڅ &''g#""|؂KIIA_.33QEEEr={xھ}t p},t X|9)***((onmG>|n\>--b---~U99)S F/_Ndh{ UiӦA{B6gA.wFR\\`"+)) 5GכC'b] u1҅ JHH;vLxGqƉ?Jlldaa!tip}7j(<:͛7---S@{.Ewƍ+V|?؏N&F'N0`^5X]s]]]+++4B&p|}}ßfrwwN1 |nݲFrrt 0O222X,֗/_vʕK5((cnݺ=.6mCΟ??rHWPP; MֆNA'UUUZܹs>~Hn'MDEzk׮8{,tFQPPhi!a!aГ3z&dB7 t pq=== F \߁-\:ȤA UAAQ(**"v%%% 6Z͛7?:CHIIԩSW9gF^":tK cРA;vN1Cڵk)hf߇NA={.X@Hoݻg#..x\\\˽x"l*f@OMFFMMMׯ_C ߿p8xA(C*//+--B3΍1^TT*!Ш@CC#<<\x`2ee .4W/%cǂ?ޣFX':Cy󦩩)t YjڵkS!88XBBUaڵkL7/8իWɏ6+tYf k.\{HS %%7n@wHK,NA?2e t ᪩APCC#55#ZZZs,&Ap99u~*|ׯ_'9c~gϞ)hjjjdd,8w93rb PwG x IWW))(??Ɔ ^z%))KܹƢrO@@ٳSˡݻwGGGooo&''K.t>C+++/YL?Io'' mO=bznܸ١.޽;^ʼnGNRWWsG۷o ;t9//:H_.//?iҤ,|ЈN!Zv؁';777:#Pmz-t t)))3[nر-/^#<@ sEÇSl⡡Y)DKmmǡ`4;EEńtemmͤg̘g$岲6YYYN{ ݰt 2xzzB˗/HÇYgTl=}TRR:FW񣴴4t ={vPPt b暛ٕ@gѣGSPڮ] p%&&fyaffFK~a۶mqxu̙ѣGCEf͂N03yd4yEA w/_^__P}}ӧOCdTyh=֕nj4[[[---|BJJJBh wcƌ9vt ;{,1~:á= 8X@FFFÇ>㤈zt >9sFZZݽ:K]?v'Na|@]]]333سgS$ @RR2&&:HSPΆ $::5{ +FZpt ̘10,m@ϥO>N!u)0)-'' S𩪪EGG KÇ, Û7o8kt 믿DMLLFUVV ^*{MoFCT-1iU;tEmΝƋM6-^:Zzt fp}`iiɤIhii~:E+**Z:"//5D %unݺng\Hgw&Ttzi#u{*$ThJ&-hyړM&}VE"i'ْ1>~̙{yk3|ܙ93gg(jdڻw=z0p .ڢV!ihh\t  ;ݔ1$D@3lذgϢVΟ?.MfH 2djLVVE_r~}~Ni&*gpϟϨ:o߾URRBB+:S8c0ؾϵkzZ0-@ |PPVQQ!!Mҥ˩S(ҥK`BOj!"ͨQ,YZF`n,XZ0Zů)++sww755ЗΜ9chh10{lWWW*p~! u1?BOF 5+W;v,yZLKB0t6_%I!""$ճg?QʛQ@͛7}FOuϟHOuFBrJJJ͛;44'޽ Qg֭}E#`N+999IIIUp***˗/>+..F-nԢ422,M"nnn{A&@wL[jj*B`k111aD~;_8狋V(gϞz4mCn<=='MDgΜ߿D^^>== Ӷyf\VTT pVxl^^j!;HNrrrPhUV)**>z񣤤OP ˗/[:~SRRԎ/^V> 6LWWΝ;מ7gƌSNEt} lؘi3G?Fd,YZMAƍ5?~\NNٳg5ώ;&LZ2N>-//80:u³,38ad1>޾}+++ZPĨ)`\]]2|oQQIaz777& >z(s9kĈF%ӦMG*661'p:lcϞ= P*fϞ~z*|ʕ+Q   ʉdHpprhk*III{r ޽۵kסC~mFO]_bcc#@`wpqq CBغuQӧOl}P +==HB(ׯ ^zZ@XWW PQQrJ)))q4L}v<9׍0Mw':qc9QPVVNJJB-\*> 899-\***~jYn̙3Q``׭[70VVVVi#GDP} |W >}v~"++ ۲e j_^^ZH۷7oP [[۳gϢVD8f믒ԩEcAYYYΝ/^Z`NAAALxN(**j׮322wYT3iiiL'pHL~{neeoߢB " pQUUtEUGČի y(};w !|$;} S +/^BiΝ;ޗ~ѽ{BbժUT!SSS!3f?~مEEE Cl)+88 c֭)z .^X]]ٳgT/8;;D9VX+dG$r=}}7/ܹs׮]K* );vP dawQJ(ENNŎ999.LKII ǏKKK Me˖iF-99s ᡲrpVnܸVnnn π AL5T;* pҤI /̝;WeY$ŋÏ677&3c b ~ѣGocccTa$--b} b}}3 !g$x]99M6XpfSRRP E9::VA> ,%p)tttQN*##3gΜb^/))i۶ b/_>b*0Z\]]CCCQr8/_LV"֭[mmmQ{ܑ믿LMM ?B'RRR8X!u主Fjj*ժ0ͦLSSGSq}hlm4CLUUUܹ;*++;|PٳwZO LpqsqqeQ3gУ Z m`#H2dȩSP%==gϞ[f4/ƍQ0} 6V!B}VYY ?~~5mDׯkhh}_A ...ȟ VVVJHH䠕i8:񇌌-@&%%GB04;%tǨU`JZjأA843tP7 q:2rH84hݻw p 66v„ QQQ`~M@@j|>|fLI55﬿zJKKJ?/_dXWGiidf>хfa&00pܹjѣG:t}!MMMggLԢ0(++… `w uuuEB۷oLLLLȑٷoI`ƌ>>>;`UV_컣#j /3|b|ҥK?k.|g\~]EE/ `N>cƌ~~&Lw9;v쐕h !;;b<7Ν;TTT :tȑ;R111222޽CB༤vd]v} ZU`ݺuÇt))Tj\չvZ^T^~Z'ϟvbK.eH"LX,Q P $MMM*DC3fM0%Eay558ꪪ_yfں-ZG[ufN]v >!tvve&;v찶FC-ؾƍMZ(r-KK˗/_vyܹ`P+lj'LLLh5~>}MW/mg=9 ?t޽{}t D޽{XXj! dOU#|QJJfk38x U<{LZZ۷"،7'Ə=Yf>|6U^HLL=+!w2f)//QdͿ~X PYYijjZe ׯܹs )[nٿ\FFFpLiPɓ'V l͛=z@B^ԩSUUU_|ZQFb p|޽'NH#pk׮| Y\xǎ֏?֯_bȢ ECaaݻwQ Pdh"*D}:h/_F(o߾3%?zfiejʔ)9xi߿1$'8t e'N000*w2ٳQ!?`jصkjQn̟?ҤIYVVwrY---p_|ر#~\PС÷oߚѣGeeeq/&`kk~z*0;iPqEiipNΪU#%p$''X&t FIb" ӧ^2x;GGGҋPDϞ=oݺԭC/]II)22 U!j!4Xt,//P; *Iٱcǀ*ݻd!(,,433&ɓ'oݺ211eʔ;w6oۛ7ojkk1"##\U&b g>}'3g[ ᧼|ҤIFFFo'ÁDw*++utt/sEt}֬Y$3 P͛g̘ʖ-[bӎgc@4ZZZQQQ`wGZmmmX\\\ϟ?lUaʅ tuu ;)0 ojj:w\RJ{,)Ea!&&O>| +++ssO! dnܸRRRZ4}'O>X,|wRүd.M6 %4< %%%dI4H^^/j߾}cƌ m|YZZrࢽg(jѢEi*cǎ ؾCXXuM)ϟKѣGB$ ?$''4osPYYի4ȷo ;z" C,+++QFuh/_CׄlmϞ=U-֭STT%݅ hI&5 ՃBnnҥK):l޽#KCb***999$%;wlAVV۷U!eeeǏ711/O6m۶mTϟqDEE7:yJJ0t0}-[[&sa$d BCCQ $%勥y$((04bŊQF5i\99x$aW]]]8j,)SH;wRtMMMmll^~ME$%%A `wؼy'jFrr~.\,--k ;~:U[(kRO< ܹZ/}JGQ$zjEEG5clIII%aϟ&&&'N嚟?y 0\~=JP|iH.Pь3 #'OǏ;l%>>[nU eeecǎ޽;fҾ}BUa&..NMM >Ն l2z$a~IFFFpp0/+YחjI0`Kh(//oʔ)4T'ylO@ ?6335jC#?~L* = >{[jll\QQA$/x K4HPYx?:::pM1KIIPCؾK^]ZQC zbegg7便 pܣ˾}ƏOg  ?*:>jf;_A_ӧO9;s )y{{oڴ0t3cƌ?߿^ tTTTv tJKBBB755wfff.@I[[ܹs`|eccZ`b ee夤$ ܸq#e+X/_߶md޾} gݻvҥ/YD ۷odNt߾}l6{OZÙ[RRZ``׬YZQFgeeXlDDbh^CիW$ax͛7eiiC$ "\˗/GVWWz** ŠQ4lk׮>DB ޽رco$&&[&544_N|>ށ3%;a( <(˗/l%L3tJJ j!!x=//!a3333fh)zp'PӧjڵG<^zpAN΅  "!7c])))믿lPkveeewOOOyyf?ya.]s!gg&mǏ? 8q.ȑuc(W^O>~=j9 Wp9sV\VK6f*%))[n}HQ 4:uٛ3PCBBbccm9::rUUU`Ey<\#-[Buccc :k׮wAE5kĉQ ~?~nn''$!!e˖QQQo޼8pǏ4V(((h߾}jjjFF4 ᙙśo?nmm }ϟ÷iiis8g,T˗/b _2.] eBWO<9}tѴ>}211Yyy9 AW91)tl3LIIIˬ)j!r|j p)hQk`Q 2ުU+ Tp+[ZZ˰x}=baaQP|_9sjh0c,TuԉȌ/lݺuɻw;v,SRRp"޽{t-[48g4/^LDqvv'kF6 Z(V0`]^׮]+++Q ;?j0FFF:t萚 ][[%X,bZ¾/]jӧ*hlvǎU[y[קvݷo_0Ǐp>8xnVcǎ55TTT@b6oތ:77oHII_ӧOÕ= w5c9 VN?XA__';rpmp ikk f~Ǿ7X>&&&pE "399/ۉ}/..vtt$=v_/7Qɫ|L8pQeC.O>%2W^AϿ{s{LXr%E3$̾ʂVRRL <3.?~8jχ$&&oSRRlv^^ͪ0KнK藄#GVd^>zh{$+0$`BLBDV-޽{gll R&%%/++k06#׎cg#}Fwׯjj;wfH`y˄=ЧܹsiӃ;v4v+_N$ ,^ yݿϟ?Q!"8D~~M k7' 7p6lܥK _~ӧ\jDZƾ 4g^jj̢. }>N=L: ̯^ТHIIӦ '#F8|pc޺ub) ?gΜFzHNNѣG>}RSSQki>pCW1_M0555eXxmffkX ڜ{Zx-\+3‹/1L&;;Z^&<>3a!xw iSpUEUU֭[VX!@֦v0]]]suq|}`mp"۷1%8v6B}oYYY:ud92ϟs aȑ#ϟ˚JJJ} rXj7nm$aH>hBӧO+_pp0<w`ڛ?~f7FMÿ|Ct okݺ0q>9}dm333ǔ[n̙ݻTKP 3g(((xzz YYYYj8tx ѮśKH;!ؾ+Wrxxxܹ&=sjjj2ylFFj̄ߣGx{ݏ=J* )EDDիW0رcP 'N@3({"%%ƹ٨טq~#~Z=ȁ락}~B 1Z|yS\ZZJ$ )TTT@sޤåK믿Bd {Zș3gv<8v6}5>>>֭HƙD;c O}%!{555m޻#G\z50d߭[n ÇTHHTTeGaUX,Vpp0[7}_B̙3kk+W4oH$%%+ C"p B!dp)..FA^zСU`wީSAM>"Z㇯6Zz^^aP5W^a7oիW(--())oO`p$ЇpqwwWUUx"j-LBGGٳ`w1bD@@H T,TL_///߼Çi +AaDHMMeX_濨-[\A˽{泐ӧO>[;!&LسgjtȨQPkaqqq'֭[gaaѷo_}}}Liii}}}9=N:,\$ux-?!ss;vRZEEVi`(b޼ys YYYlܸ (--]h޽{;'+V݂ly">>m۶>|@ \Y,kr<}ycÇ_|IVRP۷u rrPWݞ={b,,,Ef3W]}'K5ɀQnժ1\52bbb3f̐155%V='mA 𭎎Nujjjϟ/}S>ԩ [OO?qss sTGqà%"":O4:veN!&## Z7oB7ػw/,;;; 􄵂 x'OXlddC`555mllMFS'`XD47¾/]jӧŋl{{{_ñﾾU[C6ȁHyCzJJJВlAAAk׮%KNN=;;{6l@-M]jxe Toٲߏ?~ܹ`97233[hAD!)9##PBnn.jjj!!!s8ADzb?~x> S6@QRRa9fCd7NEf0u۷V™3g;v ˳OHH`yݸqYPKE}3ӧvի`8+SOII++K|9700@hh ,@`p{noܸ;L)--})Jksss /N8\@Agpo߾|Lضmj￡_'gdd)Z(B}*I)&.ޮCzu^lbyyÇa](l.++ 8:`vY'((}ʰ1aSwXؾ};,9322"\tppPUU2^XXX?vn߼yg!f3{lWWWk)..a#GRZŮ]tӶ37nX[[V[v-ڰa ?m40śG"MUUw##ݿ= %~v*- >3B}1o̤ξ˗/SN`&.'uӮc [jE͛7N}a3;wR].M_ׯU0}跈"4\ߴiS7o"dֱaa~::bbmMLĉĚέ2exҾ?yrEJJH3992= spbGޜ5MkښDIKPcG1G/C舘R\[_s?Pեr||)J0|э}ij*ރ}Hl`&=77O>Æ !(55hz$""0QVVgB7ٲe:~9l69pYf 88c('6ܧ$WNrɬo+alAfmh蒡C{kg={6Zj֭str-/yd b o60LlxV&AA3޽; 9lvmIIR݂A!s挆Ml ˻`?@'<[BK?~<:XADbNu}{en߳7oެ`o߾111U&MFbzscx'--MQQ6mӧOՈO~^Z Pki&\ NhSmǓ}?uj5Y0?~I^Pp=%(l40`|^=S'+ I}>ܚH3g:W8c؜X'.nzu}6Dܹc "vW!! ,,@S::5,;Z8g8c߃}-- Me~A>=y*N޹t>t:Á+}P-._B*@'C R {qY :w"nq MM?P\RtF++#uum斔q$Ǿ7ܭ1`[q̚jDjl 8c;V_~.}T"2y`ӗ.NOC>Q`cw_Qĝ{"XII 7{P I.Nkݻw9יM@@ N'yyyz_/sssZqqq~ ---AGAHHORhz;LT;cSs;C{JKwsgOw/D&$XGQ ]XxjD"{j+T^ߠ3NO?Ӯ]?@QHW8 !'<3X1ymͱPX۔UUw@Ս1`_lNvv@UTnݺeiiZwTG.%%ʼnsd---T|%??_LL ;w+++C-iqpKWmosǎb.mpچjVy1 qu8bD_bjWÇ7!M0JPU[Н ۷O<[mgggѪU'Vr_PЌ(+@iiN.<}TMMmł>| C)`dee }TD`3A DQQ̑#GBG766_Иq9 Up ;sp_ ϟWVV0a_ѩqp ܾDg}8KJJ֬Yk֭SPPi8IΝH-ʄ3tqSSSQ{Є?~tЁ LvEǜ9sP0|}}eee9ZKv8n8c.T 2e #xǛx\| a~`ҏ?F-?E!.*r޽ 7ot0ThxѠA޼yZK]jA7Qqñ}9eeeС9˗/#d'O ABF(00lSʕ+̙Znݺ"ܿ ArݺuRRRAAAZq8n8sc.Ts8CCCde˖U,XZ]ݻ0S!|/::׷G?ڵy۷FFFB_t8nx5c.Ts8] 'O@O 92j(*7oްX/^.JJJQZZ*&&VTTZH]fΜinnN"WPxa h#>iom x[2w,իfEEŇ6xZKMMёѪ*ggg(R޽kffZ<+++&O>o޼ɓ'V!0vRiӦٓ fH6lXDDj'NTRR:wZ%s8n8 qkk?jD-_g͊Dj:L0JwT}HH[n2339lyy䊊ٳgO0?2IIICdddPB?ydѢE~~~U4'> !j$ץK#Gfddq)G}eςa8 8xpX-[@ jRre tɺN-ZbIPw8?.--ݣGw;vrV\9ė.]߿?͛;6vz{{p ѿx"j!FAAC"7 &۷lHJJ"mbzHIIjlKI$µLRFO"D+g}¾sZ'Lw#Lfw ]R]3̬kǎb{߻ѱ7qK+BΗ/G')AKKyi?&k8kW5X[7sp4ohimmđ`P8ts;~Oɹ ڵm۶ٶdGKUX lw&&]c ^D45|}G\wLcWU݅:8bD_( > 'wJ,5d߽oߎZciii ۮ]P*|}}PUU6`:=蠭Mb!++ťs7nܠFl[gJҫ!lf~X˥7OΩS!ٹ['o,}bcqݺ<{k3v]S'w.^haaA,'''kiiq__{PPܹsQQ iI~̉TK=zРAG b#N8Z#&&fbbB_??~|nZj5x`ӦMMOOӧ'W\\?zY<;c&p/s#w۵kӡC{UUݼ_QX-"b-|$fOJ m߃fޜ9!))Oy==)Dkw.3.<فh… dߡu9r$jEQh'Nijwŗ/_:v(XcԨQc'e˖19+0߾}2e 1@1!!e˖N.(ۻwl64IIIW |յQQQ<`}qLtۧεDëtvduƾsa剏ǏG77;#8lذuVD}鰬;gN,+))<־7)86wZccw TNC۾Coqf [ǂj'8['WnutT99}9S:爵<}?-%%Ѧ͛7, ?>>츮Zxƍ>P,}unEv \LJxT@)))QTTwj!Fb3|pGGGI'XIZpx޽{N]vBu}xqooo8 vvvķ-Zϯ9 M3Ní=z *$pBP(2MűB>]sm!~--تnQD~p:KH9:K~mXؾ3==d*X0BȞ={V!؀i6lĈg4IIIU<` Dh̾͛7rrrRRR111𭘘XJJJUUU@@_{SC9L&D~P6xŋLQP'yҦ+Wk[`7ƾWj˫=t8)"TV<';B਩W; ÅCFFFV!\|vɓ03f j~xBquuhT $++PWWwժU%%%;,IJJgo^YY{ZZZ %`9~ZZF|P2Ē(!۴#{wHؾ̙37oތZ@2i$΄_B@ll~yـwZ onԨQʕ+qX'iFL[nwtt|nq!ii)Ϗy>E^j<5῿|ufVo% x҈=l>a#7nEB+d 888_ AEFFFh 4:$ٳgZ˗X۷&[͌n@yNׯO{G"(}ay|7.'ly̙3-߾}y&j!$ D *ȤtnnnƞQA' ?|ɓ'+ljq77 uB\Hy,.!;uJc]|cP p9}0aXZSSӿ |UCCڵkM=՞҇H֐~wX׏|a. w.!++KFFPȆ 8bxǏ:u[Z%X[["x߿ L].]:nܸl7Ay3nbFDyj6yvfcNy~Ҽyc,hv!1[A}##GV!888,Y j)//WWWqj!t`Jqqq^N|S ='9@tܹ222aaa7HQq=a߿iߟ<9`1a;OFB(Iy)cccxpY^޵:_EF1](_81ܙ5kֆ P`:?~j---8Z`0psΡVA9&{*0ܨڴiZjU3`8qj01׾.8q(, Ya#ׯLMa@0p؊]`!6vDŽ C9%<ùxx֭P8ðSVW L_=bwTcÝ-[̘1 ccczj*%%%0r11B=zr}L5d==w9Ǐ'>2 `b}1s>Nplܣ` _19:lҠ}/)#{bA77 O^mkkvt?GkX[MMZW>|G5v819w\P`4;w433)l/d̘1R/ƚSۭ[7zy_{qBRaul21SRe_}|G5v81yI׮],ϟnׯY,Vjj*uH߿˚>ҥK2pC!]j)//o۷opRRRH.i{-ZԤMd3117oj!ɓwڅZWO:\3g#Xy//jfAL̵`ЧL>bD_[[}7'N H{u/UU׾\14tpvw'T9, >[nXZxx 4ix배r_a.k׮~~lll^Grvv^f e@`a!ݼ%̬?~AVD|ϟ5}||Bu߿dXuVCp͂5+**fϞ=a„h: pk***r/ h顴nݺqNǏaۃW;۲ea߿t\6%J8p  $T8Ǐԝ,̓>=FQ<]ַo_> 6́˞N+V@===&%QtS׺u`a`8/ 2)) Z h3áM1իW`o߾M2DmUͬ  o޼8pX p5˗CPu`L 2 fɓӧOݑ0߯?{LZZ֭[AG+W8n8GGwHHHu 55KnppkrJ_~\dSaaPz4>;BJm={˱pԀ]=p "? ~Ŵ6 Y{9Cd۴i1JE!n8BnϞ=;xꚷϭ[mUPPHHdԐmmuMhekՄVjժaMeeeD- TXSND&4Kzzzu~=ݻǎK,@9P8Ii~}=z)28Qb& AL nǏ]?1$TKlPz4>;BrjYؽe|D-RRRt=..?)/O8E $A>|{'6nAMR6mA7~wO 'OXbt9""bԨQǎ#Fh,]Z| )~~~G!###Ndn/cLs>" AI, jŒF)RoľJKZMDP*4"H%R{ UjW_^-o|i1yYgɹ̙3w枹 ,I#ş~ըQ5iiihI~aH >4~"""ȯw1r/QQP<,^犷sNܝ;w]#կ_-/51Ȣg P]J.\@gϞtHZsgEcwZZh/[msssZh#QQQ$A+@SN#M!)VjqLY_-ZK/k/_ޣGRF3\dIgh_n$_ćE^w1|ЬAo.UP s[z,X/8*rv<}Ď5k$7/^Wu/]}zʕqAH5@u,46h6ΝKҥKڵGM7oFɓiݻwQI0cJ5"'O_d7DCízx\+"**Xaaaa9`W<,^J z RLDW1۷wpĜ&[#7dg.4,\{Ngi!F~N P3`C=GK|yw]N2wN~WSN-\-Z4G,6lX^=h oܸV @c駟3gV*Ϝ9#hW$RJ{E!99f۷oyzC4Կ/1ct٥)"@c֪U PM ?,+-ԨQvH ~s1 EKt7nYS};-48p~\A A{.4{=^wmr劤5wޥ"Yv C+yH TRJ˖-J4;v9iq/k-}Iw&?&b{,7+#iRCyऎ%%%UVW$]FݺuctZ#yŰ!s%b =GRGyõwӞ%M} aG!u4@3hnJ&bӦM{ggcu+{rlIwSRVBȄϛ7.ݦWÆb Ƒ0h#iа҈o{?c Eϊ컸ĵ r~yfgmq|N9'6dM3daTD,33{z[ĉ@@.?F^51BL1lH,>>~׮]Jm.:O?͜9~5.sUtR7L{mÇ71Hr|7lB?K?D/r)Gy: V7nܴi ڵk={#F7{F֯_l}{ahcyiaڂwi/XޜW`HR>{v 6ErewW VICtZ> XjTJP-.]U^p/_&,,ݻWݍ˔ʖ-2{PGs!!v2~N'7-lٲ_|Q^xᅁa^f| {v*U\R qӈĉYN̽A={&%ctk(Ln:wpϹb||ywЌŘ%$&>qX&ʷoNOQ…~|t6vBcy֭C/ݝ{xB۾}{5ܬZ׮]k-b MlgΜ {Gtk׮.]u&A.˾w[e? $&v?xpihh_~#G>GLnq㒧M{H w{P?CS32FWo1$%w(6+S?}fwDg^ٳg nvwJ+_I^A3wMb,/XVgaP R֭C={&owgX`5C{7oN˛s[nkNN:{P;v$^jj w*b|[v[]|osys{Hh:줟˔ʚx))о6Lm<ʕ_}sϜ$/(nOV/^lҤ~]ڵk>6s_[n @)ٔO?URNv}ȑ:ڈ#į=x`/_ŋz'7|n:wDOKJJ{/i +~_@FPt&69U1|$ {%oܸ w:] 2zTT8bl)Y<;e3*EvG}o ە9s+(kn„ V]Q±"o߾};""d4wܹ`srr_裏Ν;W0/@ċnJKKYMfWS΍7PϢI#4Y4rb鿱?`0m  WUݡ:^T :rd`lS63o+ƙLNNd.%2ϼ5CIһwbֱXWU|I{`>Z|O?5YY{ȪU1(۴i XP|W>w۠AoL4 n +W6h 8,))?}b8J8V8b8n|P{nQgΜ)S˗[n=x`#ɓAAAZc{NJJ ?(Y_e)͎ghq['\@Æu'o4Vl#a]>Ey+Kd#G }YȒD$1޽ ""TP!Q?WB%OqnكZ6) \2ǎ< xI|s(Uѷ/VP1K;4TŊe!x((%Tnη,-͜9>;sf w.25::tZwYjqw9;~_gϞoW~EUX7n{ׯ_{w m7{s1t}q0˔)c_}U``ui6I#..~r &OKN: .ġCK)eݻN~Ν^XݻO?*~)>P1cƍg)͑4~(<\ٶ"3I9yĈDg1O>pWKS(Q»uX Ν{nYC\PIq.!'9sS~r 84A ՝{IYꕛs ZG|c)ģ1)^mL!/_r۷o11g}֬Y˫+Տ?k׮>IJJJcccMҼH#az";#78|D-Z{b:5'zF>xaѵ(^}R.bsqqໟ/)iᇫabpw.F|Nbbӑ eܫ)rΝ׿H/[ڒCq5C~O<)ȟEݹsڣ;>Xԩwm} izӦ40C(J6'׮'^!1\B g_q1*AЀauz֭!cK>D]ț0w6'i@;)@p q$+H2Ws5Ӛ!]DH0fпH\j'ysZ^;I'$"WqrRvnSŜ՝w>LUs|\#\^1H2Ɣ{[:?9g<(z8Nasm{TT8nAqgIٹMsWwW/\Niaܫ)s;$:.VӈL||L``@DDU߿T N|y,Pnl1WqrRvnSŜ՝=^E ]V oǖm2jt+iaj!f{)dL|F&|?>رSޅvw/ :W%Wmg$ _W+$dRqWp|xY|[x({&zboݻs~ ʨrWenZbKZUF.-\tol;f{)eL|'Cª%MOܩSs I]} LNN"Dj;s|\Pwϼ:=+S,ћ=lK}?wI`{e 27-1u^K*=A;Dk'*ݵk^TT8[+_>mrt^jU<| l|ہKԒk7Do9#؈3=v VDj;;&#T u&eDfРm\T%XٲɵPd)s\6y`/ϝ;|ъ}w V}V쳭0ٰaqe R+|{5%Q z(sm0;M^hg9}'m<2{Vjw'v#"#r@tG%jqұ $BO]0>B'&+qÆ3fkc8E^m ] z"7,2ܩNAA-[?pݻ#G>w* w$?jU*wH Rt uL<&Lbbq|i/ar97k-˒7L Ep( QQ5k>h={2kCE^% ={|1E 9$˜1;W r:U&FƯ"`desJʣ~~dL $~Q(wY/{YMCfG2ȫmRB?r9 w/KmlIU.XLsD!A >5Z,yKWٳbr)숨ZpհEVZ]0 r\vhtq]>-T)_v?s.VPl#+WJd.?\eWط^h+V9u6mo/&'' =00 ::,7"rU/{ɂ~D]샕,~BB5{Rt'֪UE!ru_}'Tj&IWڵ=:$*M t ܉ΐYm6%JBAiSe P"K ѷmETx1J?N(7(RORdm2wH[ R>9+992Yn l䧟1"jU#;\Z]0߁%v|P'NQ3ؕs+w&l T8-C??ӧ/\؎ M#'tI}4͛GW1} y }yFq| !`"6MvMp:UcahZ Ү_;LR7~jqx.!X[(o߾K(k׮KOK-\8 MBj{%Jx}oU0WDp{B_G#n]wsWꥌjN(>t7|XLs!m5K7|D9r|GsPZpUlL7sYi:L.wp . \wƥuACʓJ}FҠ31ؕ;=;4uqnGE \cұ詃!̍ ,tC/ +O*mR/3 K+~)7жd߾EjKw *hi>6A@u61H * )Ξey۞4f—gȋwcV/e໚ 25L&p oCd2oJetLT:nF/KdU`FDUHӈE6ar mVLݵk^>m# ʊCV\]m@wÇ<&T8Po TwY'(&C>ړP|W>pmA'8649{~}nC8~XӟB]̕,%J. s XE1F~ޫ0gOpζm{ʁXiiƟz!&|~~(ggO8\6y)՜Py@fLL$yW6`@g ~CdƹI"Zu-I ߳2"jU1_葋75n\.~H*_q$[ssgJ+F=ǕOF ۱cNxxҥc5/NFkʒ8QF݅њ7RD&E |JQv_jD8z%K>ӊBu,_v̂w9~}Oa ,C9\ڽA?jN(0:~|5|< w*CE]m1=|DhaAh}|5%ZpU̐1bB ֆɥ~~\`?<@1..P߿Ժu]ǵiSxגՆdjwőlB|% jЗxZu{tQѦMc9Ah<2ǴYR%ߵotr|8@"@IgExBgSjvʝPp[V{Euds;7|DP׮OX 3Qઑe(|מF\<8E0 6;7ưDūW  .[6/Y2K8gw6ssdX_GeEwWhw(C gmEN!9Rqq7nHɒa !6 V J# .Xrϣ ?ȑ傥رyXX0nIIMjkynn27-1{1en7|$v'(#U#PNjqO8k tH*+{pp =qVݾlvvwu~WY#ْ\ ?F]'wͣi427-1{1en =|(W]KDT1jL ߵ O%~EMZwyzqA|:u}*ۑ\j'.?zterrҠA]ڴi|언dΝ;,,O;.{Fw.)27-1{1en^g>t˒%1dQC4`pS@}#F R|WL/.<7o #_kw[ ]\m;|X13;^ݻĉ5y;iū39·bN2Wߋ܋79;Pƽژ2Cr[yy+W:{Pq":?9߰ajz|ׯhQbzqA|,݃Whw[ <qrໟ/)~f) )27-1{1en^Ŗ1j/\Z_o<^\;ԫWbJJ;-.ؘ\#N\F'CA=yR~њXL1xuWp|xq|rMK ^mL!qeL|FåJ_ΞZwFzq9˗/ӭ[K-nk6s]m;̇v\yE+8{8;._pQeeMLMM{#Un^mz5CzqMwZqhѢQaarAȰ+^O.X^|Ǥ|54q;>ז$.Wێv|WL;8ar=C׭[pgqbmǎ^]w^mz5CzqMw-;wZUגcl3ҋ+;`qZ]1vA\m;]PJ;|z80p`o<8t3m6}K"7wsϵ\\cVfчݏmi/ڲe.'$痐{ .BK*Kvt[OP؇UVyY[_'*$t~BBǏ+qܸ͛ڴi>dHNNjoC+͉|!3ܴ0];mwHcK#wF܉&6ߩY&2 ]|]|o5F9 ⻜AFt {E2.]rP.irI>a/^|ߔI ;"c2;ȑρWH ~a; ڴ) *ˤ#xZ'Bׯ22FN"|H 2#tjE!y/"8rtuNK+k&WPl#+WJ]|KSܳ=ۻwHlvI2|ڸŊyEDTžanze˖26<m4&?*>n:IÆu 8y2ˉh^8w_.^4$9Q$_~ ,,Xx9re7N:& gݺD@C4RRڽblvM{I>Kw2#tjE!y/"8r8sɥߵ+f?ؿe o9w\yyw|+#c@6''%Ο*w%Jxnϝ{OoH]2.GU ˔q"#ܘ7FcW1̙M?dU&Mإ]NAA+:𺼆O?}Gmh\Ns.27-1{1ent#WPӈD6ar/I}_x4&g-3bb"5ӿMR+W+;~+!!xvܞp"o1'<K%ɸ\?5Wב#ƒ*wWhw4;tŋ+(X!<#_֭QOXX0I"I%w`Z]PV(w.2X<::ȑ嵿cgIIM_ϗ׈˷kY 'md(^mL3Czq|bHN4 ˛߭[K>[2Kyjoj( jVD_EFy]ww+.w.p8y=v;.w^u.ǥckq62;FĽ{'[7yܸi^r߽eѤf;]w.IPqGW&'' 500Mgnkb7W w.8s9E%q6<Ím:F\F\ +~=Zfh9+&; b;*we$Av ?dN̙CΝ{~AA]p͛ӋWg|\GL>.a9/:;Pƽژ2CrbKGg8iՀx t(:umsd\"o[_r/HDDUW!/(nGK#G>סC3R~j^\:+wG%q6퐼b˘nwq5 [CzHuʕvӧD]wmw`}x>Z) /}񝧃5MK ^mL!yŖ14@||cN ޝ--[ftl۶͢]]m; ^\aE+8{ vs7:KMK ѫ)-cptẋ-c`oqĀoΝɨT ֙7:)wyqŝ6P!vjy;w.[A\m;]18"<6 ^q4Ԓ.\8*65C{dg\1 ;TJP-HPb,Ign)dʕݸ/\GS﹎d(sīɅ QIAIS`? ęmB6qhi06Z>jqẋ-;[l|ہKO|s(GPw}Ja?l+r#]1KV%(Wێv|ҋیCx5w~tݻ 88pYtjxd`Eٲϝ{1K-& ۷E6g^[dL.qEI3-I^%9V֤ۊrzՈէO֭cIl۶Ϫm㻃&"HG9'k=n&"g49v>}O֣R|pZD۷y|.cF|,/͸$+aa &ìЊ䓗#3`IZ^ Xn63s|ddX%4xn|=Fw؜&g{ŒIÆu 8y2ˬd(sī+]쟐;SiXx00ۻs&ݦ!ɽN{̇<$+cf#]^T|j8T,DxL_e.EWy7$ڶm^/ۗp%e'N+׌Yja oޜ7?1N֒sE߿ԅ Q p֡=֬(Xؽ;ڞvo'?;`&.HG` xT*f{Œŋ49p`v횚Ց exU?!܃>bD]1ɱW?م!m[#11ltyypXΊKM<MU܋㻙'ߗtb|(MH]1yjnl<7jٰacZvXQQᐏwLL$dӦ#Gj8&/ݸұOƘ噓'sƁ5e4-&E&Xd>Hx~¸|\Rs."aYhhϢQ1+O?}G- PW[}}WtH1Su~~!Q ((*w[s$&w1iiۻV*5'0F|C]QsiuÕNs;\S$֏(qH5tFʕqogܸd0:cw/ CDhEZV|.X`+55eʔKpa;ZQQ !l6|<(3^şs|w9VD_|WtH1ZoD5;{zhhE5_nkb=g[iwBp<Ԉp9Q79ؽJFTv[߹rε;yZupGzu)qDwA[:~A쌌@<;Zn2Mpd,|G+D&%\K@+J#G P~jы@Na]ծ}#6oNCJyWﺘ#^Ow$_eC*;hѨ`0`B"o5(*w[s$HGx=EPcjwq8T"DxN.^<:/o>7ÕN%] {ٲCfqkt @Ry!V=?I]Oq-$Ю>s,v׍a%.^FȒ%c!Yjag}xb AϕԄN\ ޲p((p?46.]ځGzQQӧĿy~F+uhmduyWﺘmOw}yREOWřgl[#19jaLNár9%£%jֱCtCRP W*F;t0KGi kDyyFr#@_|2vӲr"(j­ISz[`yy;(``YyVܽ[@')ǂ&Ҟ r#tjHV%wT“lc|CBxR|jaL!$Pe" ߼yr@WJh/}|&'[ tUޏ}dTWqq Йrb٨^2yO^CplIݶmS Њ'ɯjJL27-1{1entCB$ZSqIF8TpeGPJҎ$n,7Lp9׿IJB-$*|=-[M:@xs(ct+G7 <<$7w͛!iPBx{Jg=NUmbƽژ2Cr#:qb͐!Ј]p!ӈU)S}8훆IT!~'6G\1=Pߕ7}ʡW0t35ߵ'~JNaElV4Ua27-1{1entx˽ɢ^mjf۶MVm#0#)2 kI#^=kקHNe ȑW,$Mn(nRhzq4G0ʾ>E& ,‚I%x}ЊdL\c(& 1Bx8cL>'2κ},<ɨPf0V4x2o r;6'l(8`ז1<ԩnՓ.wW:j86 ..A{߭FCsE$}a^J>ŊyHYAɥ[EGw-iġ4jO߿D4`)'G~}&SL.^d /}L䠀əD1K &DzA'%Jxn ^9w=R 4 hn:Գgš51+6Ўsj ש){'g洼 l?\=XHMs t}@+"oABǏzuO@]?v` x!#jiio;wZU*;Ó ,x L@ 7bDU<=ME'QdZ!"h;bTzA.g|Vё]Kq\}NzB냛$!eq9+&nv{wAnp=Pbrذ+N%)ɦMiG,oާ˗KNN}7gfoܸd;B4)Ew;Mo0^߭FCRsE$0$H튘̈ ORľ}e7Q]Kq8 !5lXK)^e|/3Y LJhNNFy֬q0cB\ `Њ= ɓY,Y@=Eߐp`Yh߸DGG2e?j8`F=EL]ǙҎ Ofz_wP ߭FCRsE${/I%wW| =IV3+7.⻠!8͵k'k|s(r.(%໙r=^!I[@Y\IB۸[ \PѴL_yrUS$ύ/ '"Kxb㣢:ٶm`;~phжi8c:ޢ O/|~֭3<*):b?Kgvtt<<ը7wHjd2b/0<`Gn./RT,(X"0(z2w-Qo\d}bTv=[˛Obt3 Fr$ }?W\K-UGut]7g-) \2ey?U@Ŋeɸ]6}xb=O} *G3ih ԫ>}@ʍѺTA#&!#j@8q=0摫-򼿂gt-&V̊wqI1149yWANjI/nL!*"d(^սL^E25#QމYYITzt8'+ek&L?k??ӳ<+#+n+Wz8v8_\vܴ0Ɣ{8fȐnho}OSm6ԩwIϳh@]\ /}[-!wH9T : #R[1 #%ܫ7-IlE"ĈpՐTb^~~Ye@|iĭ;K_|8'49(`r%=Qҁɱty4+~=Pf(Z :맟p}!?Uk'Y4 FtaRvRXϞ kLĬGv@ +k"8&%|m6W߿ *ŏXt A@hGܴ0G iyy#99 ;VDwQѷ T5 `i5-M]qx!6#j)Rwl<880-m:uE1מbDDZDEYwF+8{tz&`a2WO &!\#`QRgB?;ujNOzRRMҎYު\|\rrz lyұOۊܙo "FD&w<{eXbT12 **dmf+f -bPz\yWKhi xB~qWV,+:h#tR|ŏKVTms[i1j̇N"cSF"Ĉ~~p9|VRyܺUOpNn 39W5̮#X:54lXM n.Y2TΙ3 o܅ D{T !Q0ps!pVtrr,﨡 s'On]ծO' 'G#D*A@1GZBKpPQrrPr&9(`nF5\lA |Wt`E|-/XP|CIPms9;^g54?{v 5}@B0H!-řrJJ;~⼼n,*Wf- *i9soO|s(_-[6M03-(X?ԄN\;; G6~.@^ppp5m\9Fn<4Wv=vŀjL.6n"6X ߡc{תUX}djrgs$:tnh#Ew1"* o:u!C *HnpQGP$ӈs|fyU(Q%|wQH7o\9}NbT1~5{-N3U-~^dnZbCent)`Ys%}|k#R3"Ev]#G#)-Z1@*z8s񝛝U=iR?f2_κ/)^mL^N"$p` 6g#[cD5RJGwsr9]^߹g6MK ^mL!iщk n>o6VD3~|˄W^{xV}oQl8KK%NZ:$ٸ%Bcԩаao:!c>\l9n?`&ɹW6gR&ѨQ$ܺu-֭exxHHFAm/hP(^pu0ٔ{([ #^-mgU8Kbǎe|U/\n7{lpp /xBmw@ŋiۺu,Immtg6]4c_Tݸ_¿37l0OZe79,Go28#G>7fL/2wu&L)Aȷ@.~Zx4ٽ;Ns5xM#k?/W/lXn63s<:KlO>Y/XۣG*(\ǎFX|2:5'K&'' =00 ::,ZPsīN~l__BV}ԩpfbb|xꐻөSi?ςS%%5S:W鈛rO|x`/|QEu06 B3**fGgOݻ͐ *KsJ6A+Kgnf%Q{ᇋ;plݐ߱[vq79d&L5Y:P49YΝ.\؎nn3a͚4Gw=œ'/, QFVÒ wݐY)-e7l0F͈mb(XXGLRRMҎYު\|\rr $AbWOԩwDEC>>11޵p\8!""=hq>H*_"uV%8wETh\R D8_=*;aju:{fdg|>y֬Y^߻=v, ~Hj2ٯ_7^x֮ܩS8/\^\=gd8`+Ue1ŋӢc/J6r c4M(ZpQ53R= zWu3%=cpY?VMb+F6C= S/Qv(IjrgED4S_Qiܾ+lqR9FAVGW> QX\aѥx'~Np̫iIRvľ VOI_ 맰c9RuOAF'`Y3X3f0͘1|Μ6oZ -(XӖ5 cb֓ŀsr`߾?fVt?{m8X=:%j{KslM{Owͮ]#FhZ¥j8%O~&ŧ[6ZQH[_K >nР8;8th|JJ]('} ˭> Q((*wŽҞJs RGfYA d)?F,*U򎋋$}WKK*fGmO``⤫0lIL)]D27N1Gb A hL/ļs9tl{6(1 &3sn}``nΟTƔ';z0C̔ Zoܠ5-1ݻѾ+-*Rϋ/_ޏdgOo2^ 5,ߗEqDtNXOO۷%MdeУjG#R@H>xPԴim2 } a| ]QNRjhV5qWSinA #H@Oo֮] p޼Wq^^Iw9wbvľ &N:C31Zw—Ctԩ[1Gb A h ^q5nߚS3O߰aɓoyUed !sB 6AQt̳j?lO?}h2yXp޻wB0B2eQo ̙(#~=b$;mw10ۓkwʌ@bTn $=fF Jzl:.)Dnn& F-⢘ڐw*6})MP}- $a5J]q/wr0 : 3;ܽ{>W=f@űEYcFlʘy3iI} ̩׾>1Zx#^'dbR'郠bS%!3ܸq*3T/A9.oD} (O '!z46e^feFrPPSGi60#``g ˏf-[Ι3 u?־n/;<++'8*ţdУjf`YkĒ/Ov`bbO/6dθcpneJ|;fA\*wʔdn&^ : 搜tiW0j}׮yXJk)5kߥ9(MU9վ>1Z{,j<5u ֽ6bR'郠;tF5pl|rDv<\LF `T:VVZDad;8is"߶n!?ptǎX)#0#Q*~.AeGm62w'%_8X8_*HS?A?H n(Jϩeژ4 +k.Ŭ8i쨨VU۫I>t7TǧrHH=vINgxJ-;j}VĔk))}؝lYZ1Gb A h3s+O>  f_#l xCgPʅZS2&%~9R+OAreژ4 [m4Mƽ{|`ٳ[RS6o\RrՔ9GjnAZ6ZIs R(c>P:x1/--HƤI#inAc{$Q7eWe $jc܂$N'郠FzRe,ίvHвтTmL[d߉b[ }4@`t]S JF gZ+FI9?A?H (CȱǛ5^ի={vӟcJJO>f!!7ؓݑ766jŊŋpԩ)lƍ|oo[ɦ2Bxpaqpp}H+jMO}7ǎMwc?+5av47ÖZF(RU&P·(OAC0<7ըVl;޿_4f]W em֬y= xY2Bxp>ZazE;CÈ6Hϑ#+Zi0W|X6E}/3)[Νcw3榹OAz͓ew~ 9?7em<_ǧvp˖?ujCHH=V#~ j'QO7BtsjԨ#BUҶmO>y5_|p3L/ԍuǁ5kVׯ6Z&''ܹO-JgZ`ߓnxٳ^҇@W!xkI(Sؾ;^:9yBB-ЫDQRW3! R 9Gu1SW׭{d6ʕl2gnQ-?U@ SqFA`ÆA/jߑn"P&^q0t0Kyzz2iZ[4 A hcȹ(u0vrs_?IM6dEkU|y? .Cnْ6J(,Z4|!15é0av}M͙3o:4rd(q0͛F oiӴK^^3g@G'ڵ>E Mp \l5X[Ȟ"=ztUhh}sҪU}Ua23?1&-1>l(*wŽҞI2WGJ4&ZJ;>=TLq5}.jw :D} :hbfj8J:1biUh [ }4@p{_gP{_5`tbbA^իcݺ.6yeWԳg:1ɷ_x?o&''yŇ];Sp…aa!,?k, LyJpZ(%HIŋӢc/Jk>Dˀ?V?<˧~3Tf6o1`@V#9rd ۷ϊh8OZc lРnjcmyrԾ:DQܾ+Ls>4&0ucܾ?xP!>2QXna2E &신Myʕrs9U I'w,ׯǎJJcӹinA b lȦi/lY7Lf,x mGl*`eLL[6r~GNM>n]F2>2+S_1W=-yBO7.e3TfJ( o֬Wn(>ҋQ6wt 6TQԾs F|nJ{&Aʠ?#S {Iqxټ96}YEy}߹s\f%q>ѱQo5W:#{w,et`eUL ͭ~> 0: 61\6e 鐐z"L*5mp۶LCw32f[q㺈I#F">x_%;{z˖.ٻw>ߗ \P1k֨NXמoAKnSȾjESss`~2ʰ T# caM IӟC{Sq(oa56j#QT>{= eПKdf7XrrαڵkΛwC0,]DF6\NR~n!|9ČթSB1-[ }4@rlv8k4 իV~FLv&&(xn09l:4a >$YR|{3g69/NcR`՞}ε9#X%&}DQٺ33BW/0'6 蹸x=LKaˎewEy+wH^c·Qf SRpᇣ6yݻ3f9sFlvc x/_x+\NkF>OXtn5oAM 8W/_>!v`bbOL|W߾]:͍b<((\9 .&qxHED4k2!ϯݻ 81cl}\Qn gZZke}w 9]kK2%}"~|Q}WwqK]0m1ڵk֬>prrҥ]wA~e Fx pbiyI'N}߳gA\\Tj@im*Xtn5oA=F4y3,̩|F5W禜qpweUb+/]_ s r>1K'TH rfa͖$^aj U;e:xZ\4- wAj"y?SkIƤx~e Is럠85]KF R1inA\unڴijw=2%Ϟݒ:y㬦?A?H 0x!eژ4 r>FFy^=L~>AFǼl U$(OA(䘘jc܂$4 A hK>\W5 Uwd B>@!Ĵl U$(OA(䘘jc܂A sgA hnIR1inAb[ }4@KȱE߻[oCNeژ4 ɾ4 A h@CN0o(|*$>jc܂$N'郠ZPφ2uR֗n*us r>D1ͭ~>FX1xq:5m޸Ub„!}O"O.eUc!6K{Ůj=d7oXѩ߷h{c;IQѺkZOMnnAR·(OA􄜹s_2$]cڷc{,󹯼җss3,lУjʕ uf>w贴Ajh+us P9rz Hs럠C-*Cԩ !!XKx6hPڵ9qxc( #"ըQ _?ggO VJ۶?|ŻR7 ;֬Y_nQerrرΝa-a>h +-a$θhhhGb(]^:9pBB-{{{qQRW;Ws>^a#z Hs럠B΋9MkMq`*z~ׯuމ!CblIǮV9?rrfRR `79֭C#GB%FfQ/own4ҥ}0̙#f !?|;,'\>_Sp )p11mR.7RX²~G 8EUsWڳ[K܂4B·Q ,#sTinA3E8 bf w{/8 w˹{pɝ: ;Be'}̵W0+%%/N~*1k>Dˀ?V,!jl맸|hQ53R#F6{6H)JWj!{"")AQܾ+R7 ]K;֟\ǎJJ:31 ͭ~>rggd>:gMTʚ-XÌml*`eLL[lN BNzѣSӧf׮#&EFbwW<8'vž-hɳƟ~ Af?y8𭷆|hQH)JWjߙ/j; ]qg9}JKVbS1SjsTinA0qx޸{߰u&*e woH(j7;ujJfHCllo|~-[ߠf񉨿m٬Y;cT<==n>p~Ҿ5I6dHuo|hQ+JWjX x~Qժ>R7Aj]qgԾ߽[ -avS&&aTbԭS=OABΈsb1`F b֤R !~^@& <`ϜٌrNN:/^쳏;!s\TfdDbL]ugX}k֬.VaOop|M%Уj}W}WRx==]qgcW~|^uLu*fJ:c@[ }4@G)y l*6۷KBBgqTWH<իڵkѬe9sFU{n@8XJ  v{LL[~JPҲBFJQj<9iӆX),jgzv_[.p= RSbIiSIu*fJ:c@[ }4@s ϭP(8qF5Mn}Aq<ܑ[f ʹleZ6Z8U2>=M+us 9F}/)9^n ֐WNL͝S=OA<ۉS/i]#/]7rZ6ZDNJ܂4HǦtȔ>`6dt̔9c@[ }4 F;wɹs9EEU^}kҲ vTr>2&%䤳 )uTinA+ӲтTmL[Tٳ[RS6o\RrhJuoǀ4 A h1C\hhA6&-Hc;++/k:4c@[ }4!X.l U$(OA(䘘jc܂$4 A hӲтTmL[:?A?H s,tR%%o:dFeژ4 ɾ4 A hΐ3c{N=rdEfׯUaGk C>,>۷ kEȴl U N'郠zBο}d(YzAJ>,^t\&ՎB+W>:s_y/+f.Y2`pZ6Z Y6P·(OA!G}7o|X׍=;NǧkYYcV;!s?^:_0vlb`dds~>k ̙#\`}DYvݻn!,4>zu_o¢EcqH l US$| 4 A hZmv]kJi>w/^pa*]mǎM3{@3QNmV k&~puxxVyڸq*/U_:Cׯ"{#ihA6-H3c[ }4@-xό,Ȝ}t<6!-mЄ Cx=ٳ[}yR-<駛XO*(*Z"[äsOF R1UmnARǘ9'郠j!'xaqaMTJpǀ=>Lq]av&܆gjvIg|n>ض-srٌVF5iCĮ[&tOF R1UmnARΧͭ~>rFv3f&f>>^=isgdl#Q,{|?7nJ3nGW+anzhg5ǜ>GW]~`pZ6Zjs r>eEhnAA·z`~t&>SJް8YY>ur.\99< ` ~ďں5>|睩Q#Ӷp5+?xPw1uihA6-HyOA?Jۻ 6[V _?vTiY7TgL^j= A 3+'郠nw 5 9sDVVj&_=:ս{ۋr׮<ӲтTg$Ȳr>z`[ }4-ؼyƊޤ~`^lV ȴl U X?A?H pC,--HƤ`84 A h[bhhA6&-HwQr>ơOA%@F R1inAb[ }4BihA6&-HRQLs럠xzz |֗k@6&-HD!=Ⱦ }P N;A @  0w@ m@@ @p}'@ ;.+fgSIENDB`java-design-patterns-1.16.0/builder/pom.xml000066400000000000000000000033601312550536300205750ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 builder junit junit test java-design-patterns-1.16.0/builder/src/000077500000000000000000000000001312550536300200455ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/main/000077500000000000000000000000001312550536300207715ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/main/java/000077500000000000000000000000001312550536300217125ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/main/java/com/000077500000000000000000000000001312550536300224705ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243205ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/000077500000000000000000000000001312550536300257465ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/App.java000066400000000000000000000070321312550536300273330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; import com.iluwatar.builder.Hero.Builder; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The intention of the Builder pattern is to find a solution to the telescoping constructor * anti-pattern. The telescoping constructor anti-pattern occurs when the increase of object * constructor parameter combination leads to an exponential list of constructors. Instead of using * numerous constructors, the builder pattern uses another object, a builder, that receives each * initialization parameter step by step and then returns the resulting constructed object at once. *

* The Builder pattern has another benefit. It can be used for objects that contain flat data (html * code, SQL query, X.509 certificate...), that is to say, data that can't be easily edited. This * type of data cannot be edited step by step and must be edited at once. The best way to construct * such an object is to use a builder class. *

* In this example we have the Builder pattern variation as described by Joshua Bloch in Effective * Java 2nd Edition. *

* We want to build {@link Hero} objects, but its construction is complex because of the many * parameters needed. To aid the user we introduce {@link Builder} class. {@link Hero.Builder} * takes the minimum parameters to build {@link Hero} object in its constructor. After that * additional configuration for the {@link Hero} object can be done using the fluent * {@link Builder} interface. When configuration is ready the build method is called to receive * the final {@link Hero} object. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Hero mage = new Hero.Builder(Profession.MAGE, "Riobard").withHairColor(HairColor.BLACK) .withWeapon(Weapon.DAGGER).build(); LOGGER.info(mage.toString()); Hero warrior = new Hero.Builder(Profession.WARRIOR, "Amberjill").withHairColor(HairColor.BLOND) .withHairType(HairType.LONG_CURLY).withArmor(Armor.CHAIN_MAIL).withWeapon(Weapon.SWORD) .build(); LOGGER.info(warrior.toString()); Hero thief = new Hero.Builder(Profession.THIEF, "Desmond").withHairType(HairType.BALD) .withWeapon(Weapon.BOW).build(); LOGGER.info(thief.toString()); } } java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/Armor.java000066400000000000000000000026771312550536300277050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; /** * * Armor enumeration * */ public enum Armor { CLOTHES("clothes"), LEATHER("leather"), CHAIN_MAIL("chain mail"), PLATE_MAIL("plate mail"); private String title; Armor(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/HairColor.java000066400000000000000000000025161312550536300304770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; /** * * HairColor enumeration * */ public enum HairColor { WHITE, BLOND, RED, BROWN, BLACK; @Override public String toString() { return name().toLowerCase(); } } java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/HairType.java000066400000000000000000000027331312550536300303430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; /** * * HairType enumeration * */ public enum HairType { BALD("bald"), SHORT("short"), CURLY("curly"), LONG_STRAIGHT("long straight"), LONG_CURLY( "long curly"); private String title; HairType(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/Hero.java000066400000000000000000000073751312550536300275220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; /** * * Hero, the class with many parameters. * */ public final class Hero { private final Profession profession; private final String name; private final HairType hairType; private final HairColor hairColor; private final Armor armor; private final Weapon weapon; private Hero(Builder builder) { this.profession = builder.profession; this.name = builder.name; this.hairColor = builder.hairColor; this.hairType = builder.hairType; this.weapon = builder.weapon; this.armor = builder.armor; } public Profession getProfession() { return profession; } public String getName() { return name; } public HairType getHairType() { return hairType; } public HairColor getHairColor() { return hairColor; } public Armor getArmor() { return armor; } public Weapon getWeapon() { return weapon; } @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("This is a ") .append(profession) .append(" named ") .append(name); if (hairColor != null || hairType != null) { sb.append(" with "); if (hairColor != null) { sb.append(hairColor).append(' '); } if (hairType != null) { sb.append(hairType).append(' '); } sb.append(hairType != HairType.BALD ? "hair" : "head"); } if (armor != null) { sb.append(" wearing ").append(armor); } if (weapon != null) { sb.append(" and wielding a ").append(weapon); } sb.append('.'); return sb.toString(); } /** * * The builder class. * */ public static class Builder { private final Profession profession; private final String name; private HairType hairType; private HairColor hairColor; private Armor armor; private Weapon weapon; /** * Constructor */ public Builder(Profession profession, String name) { if (profession == null || name == null) { throw new IllegalArgumentException("profession and name can not be null"); } this.profession = profession; this.name = name; } public Builder withHairType(HairType hairType) { this.hairType = hairType; return this; } public Builder withHairColor(HairColor hairColor) { this.hairColor = hairColor; return this; } public Builder withArmor(Armor armor) { this.armor = armor; return this; } public Builder withWeapon(Weapon weapon) { this.weapon = weapon; return this; } public Hero build() { return new Hero(this); } } } java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/Profession.java000066400000000000000000000025141312550536300307420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; /** * * Profession enumeration * */ public enum Profession { WARRIOR, THIEF, MAGE, PRIEST; @Override public String toString() { return name().toLowerCase(); } } java-design-patterns-1.16.0/builder/src/main/java/com/iluwatar/builder/Weapon.java000066400000000000000000000025121312550536300300420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; /** * * Weapon enumeration * */ public enum Weapon { DAGGER, SWORD, AXE, WARHAMMER, BOW; @Override public String toString() { return name().toLowerCase(); } } java-design-patterns-1.16.0/builder/src/test/000077500000000000000000000000001312550536300210245ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/test/java/000077500000000000000000000000001312550536300217455ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/test/java/com/000077500000000000000000000000001312550536300225235ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243535ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/test/java/com/iluwatar/builder/000077500000000000000000000000001312550536300260015ustar00rootroot00000000000000java-design-patterns-1.16.0/builder/src/test/java/com/iluwatar/builder/AppTest.java000066400000000000000000000024741312550536300302330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/builder/src/test/java/com/iluwatar/builder/HeroTest.java000066400000000000000000000052601312550536300304040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.builder; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/6/15 - 11:01 PM * * @author Jeroen Meulemeester */ public class HeroTest { /** * Test if we get the expected exception when trying to create a hero without a profession */ @Test(expected = IllegalArgumentException.class) public void testMissingProfession() throws Exception { new Hero.Builder(null, "Sir without a job"); } /** * Test if we get the expected exception when trying to create a hero without a name */ @Test(expected = IllegalArgumentException.class) public void testMissingName() throws Exception { new Hero.Builder(Profession.THIEF, null); } /** * Test if the hero build by the builder has the correct attributes, as requested */ @Test public void testBuildHero() throws Exception { final String heroName = "Sir Lancelot"; final Hero hero = new Hero.Builder(Profession.WARRIOR, heroName) .withArmor(Armor.CHAIN_MAIL) .withWeapon(Weapon.SWORD) .withHairType(HairType.LONG_CURLY) .withHairColor(HairColor.BLOND) .build(); assertNotNull(hero); assertNotNull(hero.toString()); assertEquals(Profession.WARRIOR, hero.getProfession()); assertEquals(heroName, hero.getName()); assertEquals(Armor.CHAIN_MAIL, hero.getArmor()); assertEquals(Weapon.SWORD, hero.getWeapon()); assertEquals(HairType.LONG_CURLY, hero.getHairType()); assertEquals(HairColor.BLOND, hero.getHairColor()); } }java-design-patterns-1.16.0/business-delegate/000077500000000000000000000000001312550536300212335ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/README.md000066400000000000000000000020311312550536300225060ustar00rootroot00000000000000--- layout: pattern title: Business Delegate folder: business-delegate permalink: /patterns/business-delegate/ pumlid: POl13SCm3CHMQGU8zUysgYCuBcJ5a4x9-l6_Fu84tzsgvYxf-Zg06HyYvxkqZYE_6UBrD8YXr7DGrxmPxFJZYxTTeZVR9WFY5ZGu5j2wkad4wYgD8IIe_xQaZp9pw0C0 categories: Business Tier tags: - Java - Difficulty-Intermediate --- ## Intent The Business Delegate pattern adds an abstraction layer between 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. ![alt text](./etc/business-delegate.png "Business Delegate") ## Applicability Use the Business Delegate pattern when * you want loose coupling between presentation and business tiers * you want to orchestrate calls to multiple business services * you want to encapsulate service lookups and service calls ## Credits * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/business-delegate/etc/000077500000000000000000000000001312550536300220065ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/etc/business-delegate.png000066400000000000000000000573331312550536300261320ustar00rootroot00000000000000PNG  IHDRl^IDATxm\ř.Xj7qxcP K@Zt JK- -um`$ڱt+fba7BĎufڬoTe9OTʓ'O73W `  Bm536@MtY;.e` ;B>TH -BNlRwB` }TTS~1ZsC PV!4f,DB> *:%VCMM{1ӜZ6Al`Wt@#lMyqscp=)nG:q#9$(7҅CP, &uK$qdJcq¢< jEY7RDT5j w&Uf$ !Qr@] T"mIsTv3\#:ЇҤʃ OY0(rtiiwB-#E qHލr q!ܟ#j^K0ftL0>4K0 f &L&I2sd@B=lq"I8U4ϑqP!jP!j* PP!u'T ;B>TH -BNlRwB` }_U7o~b6m8P!jKG]OLdW2RN,>bB` }T{gv_}_|l {?rUI?Z rwuP!j3rO~kN>Wy^+mf:-DC cұG̿z[9s?;v={q|!|?',hѦIřBp}T5nkOwƟbȯ`KOx[Y(~(VNNW[FѤsP!ŀL\oo\3{ ;/?v}b\&}YbQ+lLc#\[vby'y_^Ζ~(=2ܙ *}T/kq}~gOv|,%HRѩqN "{@l ]smݾvɎY"A"tT*z5f Vl ]3=r[۟coc> -|U!`Y PP!u'T ;B>TH -BNlRwB` }*[@@ԝP!j6*5LGLy B` }ڨP!"B>*$و.% ]nG4'\zǤ\ "qoh^H|_fLn^C/}6inm5V*[@8B8AN+,u@k.  q @.IeɁr6R P#i&?,'…{皪{*4|jf\)g}证 PۡApB"|F}B JgduP!jab(V{xA"H&?jDJ$ Pyh-׌ WpqQ \ƷC\4Y -U!KdLH(21R5DHRo3_i2V,T}U8 B` }*[@@ԝP!j* PP!u'T ;B>@wŊ6m  ;` }*[@@ԝP!j* PZw`t*Rw6 PP!u'T ;B>@!ҽ?'ϭ7`) PTn 쯎'X B>@a]j'T(C,O5y9.pk?5IFִ VF~2˶H7JP!j`Fڎl7c!2H*_; y)Ki5Z"*[@䨐]uwtѩVVhza(ODe(^NSJ8TR!w-ϴ^|#f+w]^KTK8$8nI/N@ߜl7cA?P3&ZI2S:~|xZSf,'$QlP!j@Bv慉g_?M^5*dҎ.?0hA#h ƅ47Iz̵IV)&3Ix$Agߗ '2)!*Ъm;o;Wؿ Rp s(ͰBvWKJ';qUh__!eGE R PZCo{fb{b+ Uy7 IZbCin 'I2i|֓!D&FBp } ~uGn93Lu,0Ȃ)*D+/ `W!@LݻN=eg"{ղ #[dj!F zS-92Q2IM\(>>ytxGO:}msdI1#[@xn^H9(X/ǀ@k֍dOک>*sx2AS -P!-BNlRwB` }*[@@ԝP!jD_Ђ Ȥzn2wVz/B>HTHNK I-1g B>@ up;;(.UhP!Cj KlݷX IJs,1>,U'TЪ/=ya׏<¾@1krmɵ\`ވ5DMuq^RTƴB } 澳}eB4$:AH^( Fm~zb_…DbIKg-B0PZCo{fb{b+ ysE!aL''7:PBbHwCf,,%Tj@Bݑ[<}3`8  7%[ۑHGR!5N|!P!>@ԫwnxd;`_8 NuZ/^JH%lt4&c%rfup.;Ľ*T92A?Kt4 F;G&/#eLNQ>YNl \/F PaZ#B` }U7~ -V! PP!u'T ;B>@wŊ6m ,P!I*_ T`|*PT;@ P!vB/@*_ T`|*PVfձsAek* PVnY봲HYR0J$87R8Y}fQ!I6+]Q@P!@ZB ǝ7 ڱX$pMNv]%e!>uCN r@c*AQ!\& MxfpP!@FfNqM"'_;JO+d'.6U=Rbu_.0Vp I U,Ft:R(@T #Ad. 1Y iҞG_aslE 5EI';.' Jʙ=\BdR* B*ԪnOZٲfE2F)gߗ$B* B*n@Gp(HP.tGgRߗɠD:I ptjW` #uD4NW ɜM\3o:GŏuiB PP!0(1Bɽ$cP!ӧ P*:P>)҅ T`|*PT;@ ;vtRW!,)*#&&&fgg a쬍LP!@\2q$*pv^j! #` j 8BF H! #`Ā T!TPkB=BZ#t0GL0z@xի?`FT0a@xFo~ZdF< I=P@Dca$B*6:؀$a IJ N46 IH*R@a H Uؖӌњ⍪:660E À P!&x݌ %|DcSh0 Fa@xJ^ju K.xsry7b5Hsj5Co'H~x@RM qaC3E #0BG & ^.lq2D+wZkڝkHwbwd5b\SĸÀ rg+BWGc"W.^ix0 .kDbD 1G3)0`#5 Q t\8o>@=U:ȍK\HBMa0 F=F]@Paa IJ N46 IH*R@a H P@Dca$B*6:؀$a IJ N46 IH*R@a H o,O?2ompx;f!- 460aQ.B*ѫ}/<Š⎧}b2$;rF.L7,Ta\z %G[;16i-mN2QQ</ 﨤==FBXNpso<ӷ;gc{_{LRP!psꩼ1GD"&娐bde7Ur9eAJ ( _f9w$UHPAdKUd}G&+`ƦIkdw\,*Flo7 8ڛk}Ga" NpTHÀ 6C23>1ú7\5'}-^;Ey3 2T=N :E xkd0KB/YڍR!Yy66M'#<424 e ۡ9vo]Eꨦ!XїyϦm4 QJa3}ՁMw٭_}_YzlEᷗ޿} swpZ,uz/B(ɹM9PU0Y B,эix1iiDp !}&B+*|,wwm( dEFqPnUH4 QJa37?rUk'w<) BcaL5r:B* XOI0@P! hhl@0 $THZ'$ $ R)։$ IBT (luI0@P! hhl@0 $THf޲ɾ Tnj~M1a}u2 ea˪M)0+6 waa/ Bcd#4E|ሎ{)pei򻄤 /gVQ핛ka0T [\:&E.,cfXJxoqq _2^l/XÀa 0BGeUEL_RH%Jxf&KU3J9/txcSa0fP!ޣ*DNE(-I+G32muMUe" 1À UV!V3RjO57m#L>[eV)0`1 QY"Mk%E1;*5BpVol`0  *{TW,Q3_/穖Z>Ҟ$~#U A!BTa0 P *{TZ~ a IJ N46 IH*R@a H P@Dca$B*6:؀$a IJ N46 IH*RX f@  Th@+/HlR%։$ IBT (luI0@P! hhl@0 $THAXu`"@Jf EH_HZ'$ $ R)։$ IBT E [`ƟO?n`eIc5a IJ馰8;n`eEc=a IJha.o`5Qc%a IJa¶<ՔPi/4^"[;CW%IkQ^ikn4wt76%6o}C9q}5 bd *{ xT 1VFUqy_)$|=R58[G\d  Xi7~M|)Vd}2E_ I4,a@x]a~uGn93Lu,0:b&;_d"Gʽ/ ]8揯:[G@|b"aäǎ6NkM@ܩ7`LK?Bz9,a@x]ac}n?{`OUX~bBdCv:#3uu)K *[UHS?:t_4Ti}: *㱤M=3E? !w T(lwz  Ԉ.S92'0JI9I-:'O=&M71l+]xuRANsd` *{d6PA/SG@gYSa`p$BT vM?)EGMᮃeKR).ĤsԢ9usUll *{d߻gZ/FoPlwPt<ͭն^ bQ H6nOFPVфZ `S7MD3%FnS|Ѳ l@*,EP`tvI)n0` *{ Ηܼ0Gca_YN|!$mlg|V ;\Oo/.5bd!wf&H}xE.nF~46>Z7iz(_[H MPwLpð`P!CW>Gg_Y$;_q6k#CPa| D7taNK&PG F/4ݵY%q!8ލ|4!mP1w+\s À Co{fb{b+ Tb\k ^I]}N^ÂA&i9/{\{ؘ?hB8GrmAPʣ*_?b0  =tmL<3͏@2rTNt>FDetf_35NRAp<#aPG)篼F_7< ʫp0B1^ݾscϟ='{Ju{K'~urV \JEGe7o#g2I<7{z4)rfU/Qola0,T(lwz 89sdD9;NikZ^9Ź")cA ԊBDxW*zl=+k)d Y&NRp0BGva =EaʞOa. T@a Yh Q;AiqtOo0:IÀ (lO3,G!>2?dDc媤t% t0B hhl@0 $THZ'$ $ R)։$ IBT (luZllV`p߁a*xÀ  6̼ P2N>EeqIY Q [Z&2A휎t`0U.^899966en.@i`ʕ+/Vjok;=FBq@SB7I*dlp=2 fխpTNv .bb;=UȮӇÅA^[2j2BFʆ2.avvҥKsT P!#Clݷ Y۹.\\TЩ|3;Opd_Y ̫-М. ^|K-ura/fߕMݐD?&4T! XcF|ӎ+W\XX" :rgfYm_=#ގD̵=2 iw qEUHF<ŋg ={gBTSn߹=}U 0.;ižzhqt*!)yѬa\O$]# }㲊0T>}3x]v\8=SS3u'Ui Α YkY092U~Iv(sdp^_jڵk;1, W+Twa㬅kq` 08B*dk#e*$\#^/PLaÍ*{B)pakdbbŋû I+V@X ^ ޶gggW\l6ѡ 3&' P!u@$8}-[&'' .ٳv.=B@ 5U ưP!cŊ6*ڲF ]veϛ*( V~&&&lرF"avvjcǎ/!T@ p5jDP!Ck˴\%FC9\psz6Խ00h@Dri 1 9GɗPWAH<}Nݢ ˝β|P26mTFås1 jBl;'irR#NFQ0闌u._*d۹JFarJ5lW@'ljB>3DH^}hZz*meqCFY,, 2dRU0q?99966 @VZUm6??t "qN, BOC_GJ/ G`Q!caal5$BxE9CuHMr@QHB$$4=DHHR*T(h]\2 R5bV*9x=yBsd辑oʙ##Jf>(VKX`S:/kBCj52;;[3r~Jf'\ګ 7 K^^IMT ћ2R7\xqbbbll` tlٲLQ%BWSB#EAGwH=cǎjժyF0f~ִ{QgEVXdӱ)IrBt:%ر 2 ~zVL$T*ޙ.,?"*BEAwJVFX=rJ2Ӕ7pCD+sP!n Da-{~P!^챨*`Uj*,x>7\ςo?_),翙 im]1yX\#IG( $ `CInƯNLL>?*Wḟ;eW~_ 0$!FX{v_ {J}+Vʐ ݠcmC ʩ|P!Bj(Hwcp} ;{X ,`^IlVwl'ԆPԮSdĆvxkgffX^c׈roV).əNXS9Zca£QwI;~v .BDâ !΀ԚV!FLɡBt.M„XmF͆7n_(qSnvV+xF>Gp #RprrrBv//"H@uTp8G&j*Dq*vpit@9BE?ڸ߮\ڿӧF)sy J{Z9R48չI\@2BVEΎ TiQfX b izd8τN />Į%mDp3g4$~ !9jUVZ.t?vV/OqP!!. {ﱒn7x5D(?VtxЪ\>q,&SN74:f"˸tMkYx7k< qEuC@Tg׿{{7tڵk`rdaaFBlєHcwHR6.P\ U4>#'%Plc)_>l{ffej4.D)X aZ7h;;X/2ZgT^ k!.6td믨C5G}veZ|q#=0Gܢ+Z=l _jg4CwEk.0I: 5Rm @'vľwqVJ1GOGT7[2>_q~r¸/^nϞUHTK5uqcuJNYO{gNQ!Gw_cB=9~edױ8%J-+A7V9)F S8cJ)iƐꊻo=~|'Bq^~ׯl1#hdU 5UR֥]_ч>FGw|**w#ThhNL:"HֽxUARdޢ&wNT@=mR]qۦ_w OtaOmc^8v\%)įڎ}y2&u)tyBl"d(>_ L.B" er/Ss&.o ].) BƯ͟~sca*+  IQyTFKY{G5!\lI9*Gn_W3*zk“ޮM7,{=7IEW2YaĦ0Ւ*d!VlSaȔ=\"2#C+ڳoo?9_1 a~Ss4 \頡e5.D<DtnIisdݴخ?g$Ȱ-ћ$W~MKs^i=T韔u/\ȵ)KQ}LU[)TrX8IbP!C+vm'5 gBvbgs]ʹ Tq-:$4w=?r+kp3o}R C:QL^dEȳ:S<,`^8Y~RKq#V6 KC+=7oxz/>p9w~o!;E֏ ^UtΌ"J[qkxBz`&d,D KcCre)c^KzT|5uJY*vFMDHx )twb|#9${h &5}]۟ߵTY(A*?NV'cnƸ݌}MяΊ{x~ǟϧｾtVRAxz6I1Ѡ;B∩e8$npj`‚z ,Nnwg~~<~ R!Bw ޓ؁2 '2+ ԥ`DT&B`XC}qP_42?SL+)b#C'Q. )B@B  fY$yA C[ZDG(␼$ q!*4%THE=G& =\:b/- Ixpn9D$@bUB& M RS3'bdɍK\LB@B AМP! B@SB hNЄP!)B@4'ThB(/oh@ hN~Xf 쪹@ hNXf[?k.ď6vc%kt,l.2-lIN φkCmm5-,u9kBЬg'TIa_tZƍ%]:\4Yz!bP6nRuulŒ 8(BЬxi'T7Hn jXY\╭%>WY{5gyśG?Moc,z*͊vbOH &ۑ\:v=& "lmŎx}/<ǎ}b2$;rF.Ƥ,Wv+đd4;º4+I|!_jO5I%a+ "쳵;Npso<ӷ;gc{_{B"P!uQ!hV<ƅ?_suw)%}bT7?M_;/^~W察rFkڻ."Ӧ*P!ް*͊v sԪ51R쮼 h Q3GCP!`=6q/[|4^ysW-ϜSz½Bq)~7||^1KMHќR!^Ư;)BЬh'[/ qnan=~_ L|;o:z+x+7/7< ТХltG]8@U! uQ!@b'P!^VS}Ws=_9}{?7\u+?׎ 4Wm 6T() R6H<%p}} TWMttP! B@SBkfO̰uojfSO< [_vv Q;@s_yfз"&K"ޥSFƩ8&/,2 %*4%TkS:i[/3^}_Yzl5Kܾㆹ;8ǧTHbH,hsU?\ I/kRP! B@SBo,~䞫>;NL7$կC~glдa\WJ7.e;]x uK0|dE5#cDЄP!)B/kq}~gOv|,Y?.$rěM93B]9wT SE50:Ռ ЀV$E?k j Ըknm7>1 %ȒVͧUL݌q!)oJ}G!ސf:_3uذBЬ+- |!^_dTđT!%5TH , B@:B~GL3~Ȏn#\G­LDHpjnm5^"6wwaAF}j3`!Wv;^Qޗ\I7[ћ HtP! ]S!)yjWBDCDCָ=0墅m@up 0=H崮%m%RIK‘+iCVLLP!!ThBwUȊomTbM\5;5NESSRF./M2EkٝBbt\NyA a Xn]uw=BA"@V!?g'%)))T ^Vzir*]XFK$8J9-_H_Qw55;{7TUڪ1tuΗܼ0Gca_YM|̘GNWjW umi \QJ}Tv*wL;GP}9L\;fX  wf\H*TX»::DQ-`쳠 B>Gg_YMg$oi|mi E*P( J^e_BiA>礝@&bBC YNS-UCtZ2Lu,TUB>thmL2}u1GQSn̞ e*AsB@i` 1s*DS?者Y/B hN=SM T AМP!N1D&vSpm8B;F| qeq&,h>.Xt ,} 쪐+>H Vf pM$CNܔF+3r2ۋK>.)n,{`VfAh@]S!ҸO=b|xD7U!c(3k㒲 }#ThBTȯ<Ȱ`Ǐ=2EcH3-~[lOf7l燲dQCP 3RQs9 c+zSAiڪ1{”Sh "sIs+Iw*;ݧ w.6J1RyH#ENu9OЫ:%T@tvk Ȁ YL5wedt4шEA%ڵl=} leu o/ 0R!= P*ۃd݂ͳc'esi z>Y%5B(FQ!HCa* :H5dtw<h BvRHq )n@z[ɧBu%mg N A8RwQ}'@)6~~ VF]k2Ga9U>AP!(i7t;jf,PuSpB3G&b!o2ʈH3zv@pD܅uJS^qrL}W#sA 8 ;0 wd./_g,%Bg2(1BR*5$T,B WTHJB; &^GAXQB*KBz`ESW!7+FY@xIUȮӇg˿;T/a2i[,/3A Bg%U!w-ϴ^|#f+w] s4M3rPFӾ$i;)S!p-gh EjX#]Q!;_zpijy}eB4b\]MZtyڳCC@n]Fd`|wuii!Sʳ B:Eg*wvs#v,P2 QaAΠN\oT(ٴYC(s@АP! n|3;Opd_Y,ï{9ky\A!QJ:ىgp50^J I1BgQQRuBL&u&ӹAcqM.۰2mHQ{'gw2'5д I5d*KڭStb:;ptjN4Od$ I{9O 0m>ʕ IЄ TtSt&u qk <(v'+= ՙ6/e[ Pc@R\ ?˦ 8;q /8 uHtwބ!`>!"jkStNWh~ L" L(Fin3xr)7E7U;B @*]{uvLwpw L(}!|F@u hi\G L(zd@Bg *"T,`@a@_ L( L`wn?d*; B|cI&IENDB`java-design-patterns-1.16.0/business-delegate/etc/business-delegate.ucls000066400000000000000000000175321312550536300263110ustar00rootroot00000000000000 java-design-patterns-1.16.0/business-delegate/etc/business-delegate.urm.puml000066400000000000000000000030651312550536300271160ustar00rootroot00000000000000@startuml package com.iluwatar.business.delegate { class App { + App() + main(args : String[]) {static} } class BusinessDelegate { - businessService : BusinessService - lookupService : BusinessLookup - serviceType : ServiceType + BusinessDelegate() + doTask() + setLookupService(businessLookup : BusinessLookup) + setServiceType(serviceType : ServiceType) } class BusinessLookup { - ejbService : EjbService - jmsService : JmsService + BusinessLookup() + getBusinessService(serviceType : ServiceType) : BusinessService + setEjbService(ejbService : EjbService) + setJmsService(jmsService : JmsService) } interface BusinessService { + doProcessing() {abstract} } class Client { - businessDelegate : BusinessDelegate + Client(businessDelegate : BusinessDelegate) + doTask() } class EjbService { - LOGGER : Logger {static} + EjbService() + doProcessing() } class JmsService { - LOGGER : Logger {static} + JmsService() + doProcessing() } enum ServiceType { + EJB {static} + JMS {static} + valueOf(name : String) : ServiceType {static} + values() : ServiceType[] {static} } } BusinessLookup --> "-ejbService" EjbService BusinessDelegate --> "-serviceType" ServiceType Client --> "-businessDelegate" BusinessDelegate BusinessDelegate --> "-businessService" BusinessService BusinessDelegate --> "-lookupService" BusinessLookup BusinessLookup --> "-jmsService" JmsService EjbService ..|> BusinessService JmsService ..|> BusinessService @endumljava-design-patterns-1.16.0/business-delegate/pom.xml000066400000000000000000000035401312550536300225520ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 business-delegate junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/business-delegate/src/000077500000000000000000000000001312550536300220225ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/000077500000000000000000000000001312550536300227465ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/000077500000000000000000000000001312550536300236675ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/000077500000000000000000000000001312550536300244455ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300262755ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/000077500000000000000000000000001312550536300301305ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/000077500000000000000000000000001312550536300317025ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java000066400000000000000000000051431312550536300332700ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; /** * The Business Delegate pattern adds an abstraction layer between the presentation and business * tiers. By using the pattern we gain loose coupling between the tiers. The Business Delegate * encapsulates knowledge about how to locate, connect to, and interact with the business objects * that make up the application. * *

Some of the services the Business Delegate uses are instantiated directly, and some can be * retrieved through service lookups. The Business Delegate itself may contain business logic too * potentially tying together multiple service calls, exception handling, retrying etc. * *

In this example the client ({@link Client}) utilizes a business delegate ( * {@link BusinessDelegate}) to execute a task. The Business Delegate then selects the appropriate * service and makes the service call. */ public class App { /** * Program entry point. * * @param args command line args */ public static void main(String[] args) { BusinessDelegate businessDelegate = new BusinessDelegate(); BusinessLookup businessLookup = new BusinessLookup(); businessLookup.setEjbService(new EjbService()); businessLookup.setJmsService(new JmsService()); businessDelegate.setLookupService(businessLookup); businessDelegate.setServiceType(ServiceType.EJB); Client client = new Client(businessDelegate); client.doTask(); businessDelegate.setServiceType(ServiceType.JMS); client.doTask(); } } BusinessDelegate.java000066400000000000000000000033331312550536300357160ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; /** * BusinessDelegate separates the presentation and business tiers */ public class BusinessDelegate { private BusinessLookup lookupService; private BusinessService businessService; private ServiceType serviceType; public void setLookupService(BusinessLookup businessLookup) { this.lookupService = businessLookup; } public void setServiceType(ServiceType serviceType) { this.serviceType = serviceType; } public void doTask() { businessService = lookupService.getBusinessService(serviceType); businessService.doProcessing(); } } BusinessLookup.java000066400000000000000000000034331312550536300354560ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; /** * Class for performing service lookups. */ public class BusinessLookup { private EjbService ejbService; private JmsService jmsService; /** * @param serviceType Type of service instance to be returned. * @return Service instance. */ public BusinessService getBusinessService(ServiceType serviceType) { if (serviceType.equals(ServiceType.EJB)) { return ejbService; } else { return jmsService; } } public void setJmsService(JmsService jmsService) { this.jmsService = jmsService; } public void setEjbService(EjbService ejbService) { this.ejbService = ejbService; } } BusinessService.java000066400000000000000000000024271312550536300356070ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; /** * * Interface for service implementations * */ public interface BusinessService { void doProcessing(); } Client.java000066400000000000000000000027321312550536300337100ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; /** * * Client utilizes BusinessDelegate to call the business tier * */ public class Client { private BusinessDelegate businessDelegate; public Client(BusinessDelegate businessDelegate) { this.businessDelegate = businessDelegate; } public void doTask() { businessDelegate.doTask(); } } EjbService.java000066400000000000000000000027641312550536300345200ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Service EJB implementation * */ public class EjbService implements BusinessService { private static final Logger LOGGER = LoggerFactory.getLogger(EjbService.class); @Override public void doProcessing() { LOGGER.info("EjbService is now processing"); } } JmsService.java000066400000000000000000000027641312550536300345510ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Service JMS implementation * */ public class JmsService implements BusinessService { private static final Logger LOGGER = LoggerFactory.getLogger(JmsService.class); @Override public void doProcessing() { LOGGER.info("JmsService is now processing"); } } ServiceType.java000066400000000000000000000023731312550536300347350ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/main/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; /** * * Enumeration for service types * */ public enum ServiceType { EJB, JMS; } java-design-patterns-1.16.0/business-delegate/src/test/000077500000000000000000000000001312550536300230015ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/000077500000000000000000000000001312550536300237225ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/com/000077500000000000000000000000001312550536300245005ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300263305ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/com/iluwatar/business/000077500000000000000000000000001312550536300301635ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/com/iluwatar/business/delegate/000077500000000000000000000000001312550536300317355ustar00rootroot00000000000000AppTest.java000066400000000000000000000026271312550536300341100ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; import org.junit.Test; import java.io.IOException; /** * Tests that Business Delegate example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } BusinessDelegateTest.java000066400000000000000000000070421312550536300366120ustar00rootroot00000000000000java-design-patterns-1.16.0/business-delegate/src/test/java/com/iluwatar/business/delegate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.business.delegate; import static org.mockito.Mockito.spy; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import org.junit.Before; import org.junit.Test; /** * The Business Delegate pattern adds an abstraction layer between the presentation and business * tiers. By using the pattern we gain loose coupling between the tiers. The Business Delegate * encapsulates knowledge about how to locate, connect to, and interact with the business objects * that make up the application. * *

Some of the services the Business Delegate uses are instantiated directly, and some can be * retrieved through service lookups. The Business Delegate itself may contain business logic too * potentially tying together multiple service calls, exception handling, retrying etc. */ public class BusinessDelegateTest { private EjbService ejbService; private JmsService jmsService; private BusinessLookup businessLookup; private BusinessDelegate businessDelegate; /** * This method sets up the instance variables of this test class. It is executed before the * execution of every test. */ @Before public void setup() { ejbService = spy(new EjbService()); jmsService = spy(new JmsService()); businessLookup = spy(new BusinessLookup()); businessLookup.setEjbService(ejbService); businessLookup.setJmsService(jmsService); businessDelegate = spy(new BusinessDelegate()); businessDelegate.setLookupService(businessLookup); } /** * In this example the client ({@link Client}) utilizes a business delegate ( * {@link BusinessDelegate}) to execute a task. The Business Delegate then selects the appropriate * service and makes the service call. */ @Test public void testBusinessDelegate() { // setup a client object Client client = new Client(businessDelegate); // set the service type businessDelegate.setServiceType(ServiceType.EJB); // action client.doTask(); // verifying that the businessDelegate was used by client during doTask() method. verify(businessDelegate).doTask(); verify(ejbService).doProcessing(); // set the service type businessDelegate.setServiceType(ServiceType.JMS); // action client.doTask(); // verifying that the businessDelegate was used by client during doTask() method. verify(businessDelegate, times(2)).doTask(); verify(jmsService).doProcessing(); } } java-design-patterns-1.16.0/caching/000077500000000000000000000000001312550536300172245ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/.gitignore000066400000000000000000000000111312550536300212040ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/caching/README.md000066400000000000000000000021641312550536300205060ustar00rootroot00000000000000--- layout: pattern title: Caching folder: caching permalink: /patterns/caching/ pumlid: DSRB4OKm2030LhG0m_rrWyWaE0bc-6ZxpujxsbMKUXwSrfSMCVq7OFYKAj5oJsUZIuCr2bq3fEU3WGOdthWTx59rcnZ1fWu3_GqGKXEjm47VIzeeCqV_0m00 categories: Other tags: - Java - Difficulty-Intermediate - Performance --- ## Intent To avoid expensive re-acquisition of resources by not releasing the resources immediately after their use. The resources retain their identity, are kept in some fast-access storage, and are re-used to avoid having to acquire them again. ![alt text](./etc/caching.png "Caching") ## Applicability Use the Caching pattern(s) when * Repetitious acquisition, initialization, and release of the same resource causes unnecessary performance overhead. ## Credits * [Write-through, write-around, write-back: Cache explained](http://www.computerweekly.com/feature/Write-through-write-around-write-back-Cache-explained) * [Read-Through, Write-Through, Write-Behind, and Refresh-Ahead Caching](https://docs.oracle.com/cd/E15357_01/coh.360/e15723/cache_rtwtwbra.htm#COHDG5177) * [Cache-Aside](https://msdn.microsoft.com/en-us/library/dn589799.aspx) java-design-patterns-1.16.0/caching/etc/000077500000000000000000000000001312550536300177775ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/etc/caching.png000066400000000000000000003402371312550536300221120ustar00rootroot00000000000000PNG  IHDRWm| [fIDATx |Ch*ĕgSJ]J\![!A,)![WUCuUyzwIw߼|~3;;;;}wgF@ (P@k 6. (P@ (4Q@ (P@Q (P@39l(Pjƫ U> LĶG  B |C"e4mG"LbۣNDR鍅 aL <" "Q "@DA$yDD") -Pe<8`2X[BDA(X[ֽ{_Y;|DxxrJ-[:˿EzJʲʕ?0SDAfU}@dV Z(P`֫WǷo[P͛׼{7Oꆆv25(Ie(P`ÇIQQʔ){JBn73˫Ue]UHHX;0l6mms>rƞ{w!RSSiPDA)(6 Y ']&Z2GTI((sE6EDڥ@>.^WHV_8yr-n7Woݺٹsf:xpGaٲnHv6MmΝ㜜/]"Ma©)$Z2*Z.`A -XVet[ۜ  r">L:wnV5uwv(dWWǻweq-dm _;wz$…#-EDAU} fQPfl0 Q ,ڳgN>J^pē' LzĄ }˖-^2WXeh׮A\t uSlL?yx ?IuC{xq]]\ ~Gl(˫ ?dzx?/_CbHSPl^p'LU}" " f?Q`m!vXw&lY'O;6͛{U+YGDDcBPPB61cz~AQgg{~Y/B8d Wb(`^/đbR QDve%" ʠRGDA ٬U!*) Y:&a,էAV/R 唌++i " R+.*ȼv%۫WY X*)sEڐZN BGSmRɻ&l?ȯ_9ߘ+&9V7=~-ѷ2p!qqէ` j׮AΜi֭ٯXŊTj(H-2ԮT[I(8RyXb:X QPV(H![X_nkJ.˗Pgc~}A~\1\t3EVHAW Y9wٻnG֍)hi*xU5bDw n}ձcyʔ)>}'_uj\A:uHqcO\}|<{/~2EJ('\IPNf\f |J͚d{bd Q0{ߴijŊsƞqi{s '[RfqV` sPtW'OQ)o=ӳXf*Edn)J,ܲeA3V-+ￏ jV1WFе +6-իQ>b)-ZDA Ҫ<|5 u80З;d»3˫>FJ!!p+Y; fEAgϮիС]`h7ΜE?ĴmۀeWoߐ+-ZԺ|yoUs熲K=a8>ۻwZrJJUlGOƎmBZ!Z-\=\ClmSV^Z}|- 2 8un ϯ@Ayp_BC֩S S4=P>|RA;c3gH ةCUA Z*"Ҵc1wn[THDo i21l6L"*CtrϟߥCF8,Ns&A{~ҭDA攡v%YGD]"u•WL, dvKa>z&HEJvv+H; ]@(WG, - Ն *K(rbB" 9<qNiTÚZr [|l6.f0 3_? p`>&~}7ѪU]$,m R ˉmwwWXܩS@&hWp'8ݰɉ+Ѱ۵klߏR:qgg5k>zu'̟e-$vq q%2JTmê>MͣwU)H-kN hٮV<m2ɓd6=sWg@1ֶ#߿ѣ$6 L8<8`ʟ~c='3\]ۥ+֭.5ӧƍ zP·߮_|xXXYGKڕfa9o0īU+db'[ '%-֭9YlMS},anX' ]6 )-ZDA lUZ*)äs6"5 jDl\kk׀O; ,OrK )#K1{6Y VEG]"]˫ &[wXCEUˍVaٯ(8R8a#ELAF9[hHMе c7p:0FA. ՆjUnٲN.ǎ-M\lڵ1L(_7!@*x@p+wo^aՕI8Tppغu: SJA;wcʡkv A:/l4u@>X+䱃>=6Vc#zM:Ξ]+mH/P /{˺Vqh="^ۛlDoPDAjAv\wXҷ]/HB Ad=E|άvѝ?BZر1oW{4~.AҶqeFڀyS͚l4Ӿa'Et?~|]t.Ke^t%KFIAӦ}Ɋ(H]ӮGI6l#G?}Ԃc-*ERo)"0BkAM5n\mqH;A2(Hĭ>zڮgp̦<8gSlCT+%55Ey?Ry1SF3+äӺSvZ;%#]&%]o|E[Wsc)eDeDF} gQ 7m:zti~2KDAU}QyE6hA" RmȺV3WcN 4WPm=o?9lsyek6KY.<ݭx2QDAp vCgϮo۶AP 2e#$ lЂDڐE?,Wy¡XglX;W6nLgqz];kצXVܳgo(h%KFe-^<2:zԩɏŝ;g)o%&!e屐@?N\!C:ԩqrdm޽9VTzXUѣ|v͞6c m6cHDHf5G)WĹsҼy͛7tצM*U`HDsG֪ۿ@aʖ-2K7ʀnq52zGyUMԭ[3#GvoԨ(H_QU" ʈTUfcxG&?}"a}@yj wuuy6#3M5+XЭx5~}7A:„K('\I et/aaAo۳AD^>QDiŊ(ƍ=0mzz>r򧸌L Y:5osۂs߶m hViQ bm߰a{ph)cdnҤK􀀺,Hy` R8?X ",T٢E-03Xoe||<u@&uCw$z{{m۠WikcǴޤ]܎ׯ :=ȴiKWnQM2 =}@ `V" 2FT˯fQPFD6(X 6dQyjТUV%`\_2(%=vXEmms¬- (^2[.gGؾ 7]ϰփH .5{g8|\lBmY R8իcUDDp(ge٦tXZ3`qz@yPUӥ-&FL1l$?o) EUBEq 2e{$ RmȺ9fwX3$;G֊|ٛ{Faի;/8{zn"⌂$NJgϮ J(ȆUEԩ>t6C= T)u\q\КP#wn[6f밲P4޾}Z*9/ RFeU" "e 6d]qs{xF}$nX-Skřn{BajN@8}~'" ...cd @BŊ[p UP'AU*/ܞͩu\2:CFlQNMDCf/A" "e,]DAU6A Ն,mU@g#r"-b:yr-(g?,?u@6o'{HGɥK[ͳӚ5+Q@MTOIY[)ڵ]-Zruulܸʕ㰪wJ`:5vpxܜZՊ:hִJ9zym:, DD"GDA$" RmVSbFXq!w/I}{4ѣ$]/޿e_w&FE KHdť}U3N^=5k>M E" "YH$(DSDA ԪȪzu/\k؞ML&3uqjn(d" "# IO6P"SֵjUãpBnuT]5_PgYd6. 4ךQ@dAl{ d,4X(l[6,dɲgA$Yuu*l& =*V. E(D2H$=E@(d" "# IO6Pb" "YH$(DSDA ԪXdOe> ER)FQSՁfG@A@#6X1jGG*  Ϣn4u2&SP\,N9r$jղ8ӳXs^X>qb__ￏ)[OeCςH$(:w*$2P3X\O Rٳ۶mE%R+/T޼NIIyJ*˗p:Ϟ|n(D2H$=E`VdHH_ @ɓk??2dH瀀:5NN^ ;w޽9VTzXUѣ|v͞6cFA۶͘9s0VEY}+WܹHi޼͛{tkӦ~*eO$ Ŋ];Zo)[ d,D+(q52zGyUݭ[3#GvoԨZ6͌T~wkڷoHjjJ>]\6ZTooO$>>ۻw@˖uP?>)dBaaA֭ (EExBJtP+ZwnѢ^Z7̙7pD,-Z*aED"GDA$" Rm0qz}[#rB|tٳ oVyŸ)*x rb|7!8^^%776_ ';Q}̖-ӱ_/O,Hj)M~Pf&Z)pyڵ]l9sF8G63RRRUnYhΝ㜜/]ڂj뻃[  NXik3<Sx,m9LzP GN+-`u0Aܸ|8PΜ9&Mb[˪G. (m^r2NAϗ(=w|H$K)욤"6Fn]8_߿-S.eEԩuQ,=y(ɵ=zk-ZԊګW֭}Q Ob_k Vhe) K,$('Oܯ_橿xrf'TZ4i'ZY ڶmΝ??!YvŇ @ !gÆUXJT0qAз߮: ;7T'޹\]YbrK!pfjUe2JA?bĒ޻55e"2]jk(HwoThhWAdĈ`0딚Հ#  ڲezHHyym =z??L0qF` "U @Bhe Ң )(.n V,su$dï2>QЫWǍ0dHgLR_+WQ4,,?Bڠ*E] w. >Mw߭ap1czDP7QP)s(HToߤ/^5 -&TMٯR?e]wA'n}eAME`b ЮCF-ZԂC ۷5  Т 42b`tNg۶ zj^64Of:vl`]>GD׭[98U~m-{$DMXS?VheП>MYԅ+e'LxN)2r*3 {7W{Ϟ9c@)yy۲w)-X06lmQ88шSՕ((U#mp}(ֹshSJH+K56ə3GѢ7na)荼J6eքiXj<8nW?zEt,C7߬D7q2t: s9;55! sŌܤI֪UYʠqAP>A %KB((55RsG@tѢJ@#srAIJAfN|bvm)}AT+ʕ؃cY!HD' lcEGI_"CA=`DQ-wA Qt' n3v;ztBD^|A˗tE>jgDFܩ+WX7Oc32]SPG>*uklX_,). jXϙ(a]q5mfiS;v|)(&fB?ޜ}[Z6t:CM(H\U+Qɢeݥo5_,"Q'2r\Zr cCnGdSP޼No{QËMB"eRIxԦ~G8CSГ'9)SٳÜ eÇ苵 );>PSc" RmȑÆ5T,Z6DAA?!7wd}g`$X~8e!*CSbܱ;#M|}&'/aWWG#2]6UNz#8FpoWgȸ]s T]64$c7=˗qtX ٜtҝ鍅\U+W&U- dA~+? X1`iR=`Q#qDDAQ=Y|)qb_~} K2BDA$yDD")  z[%99C9r۱l>o77oX6i/{0 _;T{ o|#&͛שdB%Jŏm4iѢ5kV(_ޣt"*fI]Ő+<_r%BCvV%ݻ(6..g+sJ2x@A ]PsP!qTRf=} aׯ6\HQTx#N:;HçjT-wkۚ-_HY Ϋ2]5W~KC)wk`m@@ЮpY 2eğG]z߾y9eēV'*EA˂f>}ZQ=ZTQ+x~V'꼄93gIc!!Z}͟%!!\IW6!H:n "&HDA jv$4? ҾR 8=o&_ߪb ںu pê={"v;~|0v { [!Hփ/e}e8MWuzQQo>?=mX2gF8b )r綅}J5bH߈ P7;daҤXZke)WWiY)cj׮:pض-.T 7S6a3jBN۱mG+ ./VNvƭgq+#K5UX G4kV% =23*M6uqI̒)4v%U c" RmR91D8S!8FWJA ԰a1/a[LUn/WCsvzP^ժfDR=eWʛ7OT4,YutRpF8<;\"hԁH]ne7V{$@|x l3] :fW^(իvww23Z?pN0;Sԣpp+NA_0/_߇)Ob,?֎b.?䋨vv/\S/]#1czijgI6\}F ލSg`oh5`<:4㠨p[KMMɬ:r$jղf$R(eke(.WoW3s HeDdQjB 1eCDB9x#̙X77g8,ڍ"Ekv^hR;[|yOaG9r0 4A~qxb:yW2e$vaO\{劎I~a t@b 7ԱccFAoSD(@˔)~bPY`A7x€ =O;#@e؉hHٟz]XY b:umGC)I kq⑦M=݈' @/_ft'IjB".(7]C\ EAfP͝&`ސ:&GA4O*qk D2.8:s'm ;7oџP+WlԨQT@Aq9<$ -ڥWO<& iͻ`Eɷn}eJȸ Oָ)ZFA H-Q?\>;\j֬yڥKGX)HBc*5/8/+#=*jAvN$9(WfooWx\"6- ~6mm3㓚:Hڄ^W &)~  Dáj=s_ߪOSPG>*vMٶmF@@ƲCyFñUǏ O$kek҇`%K4ƪ298lYS+;!}'D6j.Ek6xpGfljiT7];q? ISL;8M"y_)՝|F:Culٲb.]won]c!/6lLIPc֤ .(~K@f.AĔNȓ>ZD6dUE'kCnlӆ(17~X؎/(ΣLA#}5o^' ;EA`oID>~|hQ"EvCyΜwBM6{-H6NA$Iޱ#&Y +WV_lYs]\'Mpqq5k)))+W6@)i}pY 檓ql #G4yx`ĉ}8%#[-Qu8}FXY \ӱsfֹdHQ7ׯ_7h?yRbbbV ڑ͆ҥK駀ի/sܹ-Z r^z :̙3l'۶mbѢEgΜ'H(f͚VB$99900o׮ݍ7I b СC={:Fu6ٿAǎכ1xZ%n6R簰 NAs6u:=Ϳ]Ϟ]߫WK 3 m}}a AuVF!"?th n˖uPPv. ŢEgW#s+DD"GDA$R.Ͽz;wn:**ŋ'O޻wo͛7 ¹L6 @۷D/amΜ9'MtVZ!_NΟ?_F ] z)0)wܷo߾r劳5k^Ċ!}#NZM6իW?o<=/xP|#Mz߰aرMHyx{d͟.M:~$[%KAL!yC%˺݇/N '"t"~ Nm^Y{b׬Yaժ񂜏=o~ i+V|V:7춙x܈' hpEs˙ޞ xdC}\lfW jۚ3gI2AZU)nfoo[ŧ+-2~K T~vBzh6~jb" "#uS$6 ڼysJXqԩ;w @i6p#K9x [+ WWW699bŊ,\Yf,qժUb 𸸸քS"}ܹue/]|8?\|@8R  !((hɒ%oذEJAİ?PLͷkD74ډʕ`cw[ $VxKA^ ŝ;gp!^LA|&=4Ƙ1=Yٳ뉂L*1FHkt{@3ƈ%^ ?>-޹hkS H'9Z61G{{;OL'}o8%^`#Ne!v;bdǀʎ4,XPV+[m1Vu&3R5P&- 111˗cǎ * "&AZNAqqq|0Oll8q:u?_~=G# iپ}{xb/B 1eCDBy@/nnz APP37ΜExu,?L NƎ@#"BW9AH n@A8Vɒd7?IN2gͫɓkqւQ^)+6x:R _d }dF 9ZB~!c*jY`8!pÆɬMT Цm Gh'[Y n+ Iƶm3jzjx&)@I7_p JyLS0t֌%oǙ(ȗf.J,#?Νاϛ;q㔨(}^[ވSV+[jZՉH@AO?ɓ2$<<|ܹm۶4˔)# 8;;'%%]zQF=888;wիW'OfI)HZ0D?^`>֭[_ Vuz&l`Q+ի;8.7ꭖ' ĆxP$({Q7h@z=SiIdceMѵ"R ӘAw% U.S졐]:WlaļZi(!** s͛7U]|GG'OHAAW.Ydb r 3g/^t%A 6mjuPhU&$a Zп U+7o0-ONd^l a];{ 9p`:u*{矃օ1bSb D ϟArj;TT+`(d]ޟ~ΟC|Ȑ YT:R LмZRa)m3#.FD Ai(H:zRs.;Rv!^v3-pLl+~Ըq5֍Q0NBcM/+{5U Qлv=.Hy£ aļZi )!55UC^J7Aʕ+`͛7S06ٴ ֳgXܪ|J @ܲ'SfWO7߬DG7,lP.~Qρ"2TR ص(PVE1.sxN *>1A Ay@;pFaJFP Ai}U`,]vӦ*PSf_Jy^k%x?PD.xZ)E3 J] Bs͆ cU3Xx` j;wgWE2Ⱥ19#vh WIAqLzN");QZecǖf{^-QД $[~.- \yˎ?^v3-t8&H|ez? '}Z+:nz٫[Z qV+V5X\oMf ӄ'O+VlҤI3g,UԮ](NS]h Yh!5GҮ])ꀀn ǮJ+U #[:qTF XMyYlUb+I&_6DAN7nYv…#v[6Q$)ISFaS]h m'ѭ[eƊS.]wo^G뺕jPuv*ص; oUÈ֪N\0X(2³7=Q'֘#! "el ⳻cFE$\ N{PӹsCVW၂8;ۣ46:`U)_i@t”u)d h<<`OBn|f=u?vltȖ ({eGUߠ Fd/uD:3o^' |Ɯ|LJpVxenu>v'j X0bq7X(Ur,ZQPޑ#5 4Zi ~ر;l@φlYuD׈yH(]0u FHjݺWdϠH :He : ^vAnTC&uٕT׬#Z1}}K G5Cd뺕fz(H֟x5iZՉH"## v trU\DA$a4`ŀIS#Elz |0˅ ΁_(=p : =_ԺFˮLJ5žs'hfDq#FVLz(HۮVazkU'n#% 2{@Ab"WEDhLAP/،H R\% zUZTEABk3#[:q)QJ͛7,D(d2H$!- \F8m̙ؔe/>^e$Qh3l 51 h*Bd=IdoW%Cd:̑ kfHEQdFhn6k_IAgxfipY nd2j = "YlYde]A )BA!ܸqcذayů QPZlNN__~ٌ9tGw)hԁ ? \neǎ>L)1L*~ժeA;,I>óg^tO?h^݋=:wn#Fٳ{j9th77g3gbNmŢEgWC`U#de$-XXXt=itXϗ(=w}.$+Qd%L- =.ڑo(MfFAӧ9}ba ʂÙ ~F /qIs4\Ipv_Ww5cŐ'-ئMS9 IuڦV1#WY'Tl:Z*aZXDA$Ud6 f' ֒R9l5MT8f*j(/_4t+)]@A35b"hވl&3.]vmڢE݀C[ ݮ]O?$ۆvejذ, )T f@AOe i*x{{ƇLQ*U*2KNZqtRPVLAlmrK 7kV%Z5^LA4u@ϝZneҥ-sWR ɓd''{˗ _TmJAM6??64N^/^H28/6|x~Y}sBOb ˗Ϲzu/dif z0n\jjt(U"E+-޾}Û7#Gٗ;thacoo≉fd_ f2œD[/_ކ+6~|0[s'6؝Wiex2x_C.SY}Qt%kR(vGeb]ౌUtk: QqСCh߾{rzSN3f0 'l(  A8pѩe8ңpp+ ڹsVɒd * "&сa3eʀ}[ɓk R_wkX[4fLOxz1oΜx19@42p@A8R  jdɨ#Ukj \>c4o9v+QuJJZ$h6ZR2sedXv:ƍSd{xŅ7Z+5`%uWoff!aN\O[f,}<īlex2x_ ?x"趖t%kJAZo);,+Re-VxJẉwbZg" 2"߅ >s̋/+_~yf.No3sd ,jeТ L2, u+/tQЀ"%O;H"E 11ʗ&!qǎ/*T@dѢ5?ܑ)nd)7才 'ԩk8Z9H)HZ0A*<#Uky#NRSS88°gq'QUVOǢ[iٲnLJҳ ǎ5m|ZcdS÷~!m%eu'[R_cbvv}S9TZ fP4t X.WjGOAwWj'ܡC#]q *U*4,,HWIjN S\NXBL֢G!>^]Ķ${%eKe\ (v{^";6/Z†̆9UmR*L C!A|-Wlˊź SzlGRIuC:)_7q5MPۤIr劋C 4hPRЄ5 aQ+ p 7,Y2 Z(…xs AG!o `pXNl+nC Lp 4 e'2e`㧟ⰷ2sxx?#(svOJZtF)S ɓޤ$-y`A>([?ڦrj}_EQDE0qČ)dCda?45A,0YrJMP4Dwʹc否7=KWl6}އgu^w%9dž\It 3:tvmƤJ3g6fp 1ٍ† kGU- ~$TRhoߒLbn׽Q# \J',g[MβTQNP^w3Vxuu3-[߻w { a~&ųg==?$Urp܅M'"ͭҥKqbC߾׮Lٳg \1)GRU[_"*/¶©{~& G:xX% ;J3C b(>fV :U*eO7n2'qG8X])% tew5=3F~ $%&@cĀ:B Laݺ (k&WA ;v9{ACxmۇ RRR&m F]ɴ׬#,\)SoI_8){—_9ȂZ卷`+LEY X 2Nc :;;a bEWnRDN~+Ur|p܅M'TKXX͛?t#Ű<0 2-; 7&Hʲ(R_rkKx]{Cl`@0!, G*}^K-~Gif6[,E %Cxjk UʞjVg+$dC` B [m9eXPS;"dr>z jF;YMM)_E6ћ/}|D<\+cSW`%0~ａUV17)̨U:ŋ۰ߒX;$nTRhoߒLr8֐x>^&..ΧONlEcY^À WAzOxuu\0(a~&q(rsi EX7_ WN˩֗YAi1%ӿ6m9MpcZ, }) /vPQ-6n5Hm4hkrř~Gif6[,E %kuJSms73d+$d>裈v|֭'xB;?ݻXL>$1q7>t1i4=4.+.~_#G$ekg߾E!K;!k! w%AJD,<KK#`v|I!= =PA!=W--A#ٷ#z!_8[UԷoK'ip*H N3 M C~}Χ#Uk+wajIx9XoA1,^''OĢͬ Ep$ZehKL_x6lAQ}fvp4hkrř~Gif6[,E %[O*oPi ;X])% gmۖ5jH;U;v1f9gpLDlCڮ]sx۷VVň+'"vab9 (# -Z(μ֩$˶bU.j]l_D;q8:[%쩆9 b+d)w^͚5333q0`I&_zU~@-UА)&%H4ˆ`/U櫰v̵.\89HQp9{~{)[AݱA3&MPNŊNp+`fHGA!A<:5$ڊ&B޽ REnqj\ i|ʫڰ&P<5jaX=KQAW8զTKc$+&WD sI9jl4v56$Pو|p4䣭aʹgg^WArH6[,B-PP \oZO̩P ՕR iiinnnuԩ۷YO>sN  CuYԒ18GGKbiS+%{)‘G{X\rmm3{!Ϭj[fzU^f*ڰ!l$z:N^⛝0p0U|1_ 6588Y/M_xq]l9:/qTTf{5WO]\(3Uscu,FAAC RAQAਭCMqP`>xpcVv֢V߳nK.\ *HrHx܉%Ku b]JI4BI'cu RAΒRAɼԜ-ʕkLKNkKWw߶h "w.XBCYN_4fui4M\Q}a9RAFE9s"=|h!80e+{Ŭq "rv4 2{+蟿]uy33??V88IK5I%CRADN 2,4TcLu>>5w^Wg%;![t[+ںuMY۷+7J[ӧӄvᘘ7>ȑ}tnpe[+ZNʻSj ?pZf> **]s$D$ I:I*Ȱ8pw^:a BTV=/))iU V~pC#SAǂ)9p`.]ڰgw4jR˗wɼݻ 57)`@RADbɐT м#S]>vҤ`)~/ b9s{ j![YNN&re'BSW3< XB=~54 ~!Z}ބ<'On`//>qb݀a#G^= //Yc:^CB% ۴ibddg/3凇w`o*WlXtt{a"piv "dhl]"$dX/5G2T__F~T(3VԥK_MAxyyHUDтc[)(G^y9. ر57n|fH&\9ڵ=ݻ??ohe7|"Bӧ|yǰa=u B"B22N N~~6dܹsVMpa[DDg qʆ} A?)itie~!zAn[%O#s=Ⱥ4 nq׽llmtyv# B.Y|L490ed#t_׬_ ܸq=z7/W:ZbQ,QMADA5AD16<;.4*H-_ݺŞ)* *ش)y,dks*}+WAn͚Jw܆%X1Y xV B" j29y~3 R6*U\P͚.]^Ӧ EG{hoqV)_f=fLߣGWhWSj[Xk9 CX*Ya5zՎ?ϲ˗suua{$Y!JjDTg_CIYٳɓ#k89UC9y8OCBُyF9P8f^OҢСJ f#\ns^A7ɢ)lZKI^'zx &!d,^ 1l3{ BkIE>I%`p>jUo> K@(ر5wĿU,hFGGL؟%8N oR.OQހaB(Ua Fr{.رU)YPUdAچ qj[xk2aX)UBa魟5(Uv}y+ݷogdɄ=d?t?fC8y8 BnӦii ?6N G qnXXp#l箼PALZ_H*Ȱ*H˲2\ :=v ? GI]EE3_GNJ.Bii3k׮z&M@&!qYM6…mfoHB rqc̓#N3e?̣TAʆI@.mhѸR:7UL?ʵlWje,XDxN#y\Z((AY07v kk}~ВBCصk߄1`Զ߿K+V4"U<+t`ǘNY6\ 3\_R(9F3hfʽJ";Ϩaf}9|x9a`g8v&wO>y0tʑ ѨUFjnPiZ(vEmT ֓?VmZUհ@ܳ8؏B #̯X1Z>vp+, o),)( StaR 2,4ԬUL1 f00 )[7uwwnn]{$7 >6~4 X!_q_WpāBb?G.C|aaQlJ>xpQb_ڈZNڈ#zļe BcеP/Z[;DsccmoJld7'?T6(sS;`ߕrQ$ _AW Iٍ{Q\1_-L|`( %9YXfNN0۷zl'$¥#ԩ5|pko-̕eV4Ѐ mST23-u[l޽ fµZcC_QTrk܎&;(3a~P uB¥Kq{߾׮LwO>y#Tￍ4qbNf[B.y.ڝ^Qmrd~S/~$aж@ܳ2an`mqr .|ͮ , r2EKv6G B۫@K|M(MG0Ξ=5pqqPaKWA |;va 2˃;J}_?z I3gCw>Ĉ)0!GX j*LLS$/Ȭa,륗M :v`ڸ'V&2_Ll۶JضChKP( \~:U7%2r*`+*PFt6Ĭ~tvv(-B4SAʭrޛ(΄K*A֗v7Ga]>`@Vfh9pz#I y㍗^~'/.lPs vEmP'b$"0h[p絤<XXp#lknvބSXGYߥLw?k=+9q~YbAAPs z jF;YMM_E6ћ/}|D_M2nV/nNXv= F(L7o@U+BX„|SAƽưe,&9fL_T?mJ^[шESAzOX"N/VRWwgK*+(9N3(- LXThj}5O6T2&ִi̥ <‘4#+6-*HZkwJmm-6nÊk 5#m¹gg^K"BG>]QބSXGYߥL*`4.Rʻw>}Hbp__o۲ 2|x/8*izh\V\GHB8LúBT5?`ȐWLj::s9(*%e(  _b"X8yI8yuYY4pmx޲}uڐٿlTR://(9N#U-Dav&,_m?|XC1,mH̺TA‘4SA`Sق)<^kNM~m#v} y.Caж@ܳ3% y#l箼V ojSXGYߥL*`4GA (^#X87˩>FGo`xG$_#2Zxyٳ}]8}ժUawV\99$$ t&E UP^^*iz˟8x۽5VQh =wlzJ.쇚޽_ oCf*ap 1I & ;(3ajAV֩uG OH29 ')l vH\x;6Fd]{[0h[přג>TǷsW^A+7)ܣ,Nӥm*ۡhB 5Bt_ ɘ20aOl8^DlWyz7K`hhۊ@gg'__oJ,J kǖʢ*H2ݼ%ocbp3|-=iuڐ},e*T(L_m $Dav&,_m?{1TqeHMI ʏ=B8m vD^SK˘Wg&O6lc^r "j "KD$dXYA\rpzjUs)MJ 7q.! b& "dH*HIRAEqʉ"":W:eg/3r%<{m:WA'OnJ>p`IPP ooϷ~ &::bٲwW/? ƈl.._|( '33_:>/F{5n\﫯VFS{@_^ޣ?:u4)cs$D$ WhtvɏaI*Ȱ(j2O=Cދ}\US.\ԥKItGQUW|ڞݟ7ox䨨83goW:cЊP? K׽h ]T!&gWVBӇ\cذݺ!Ţ Nm ١H*2޻wƍGmT3qU6J)Kj &3}FU;GgYW TaUbfB]@w9sgQAA-X$L6mg*_{nv**yfj.mWk՗_9t dw>r'X6 pcً5Lܹ K\b2 ;ݺ䯰ѣ֫})_>fLߣGWK6ި άeSAyqz}J/\s}|jJ4Xf -[NoM0FfiQAa`Vj#׶ 4NRAE*ȆB?BÜ>6j < GnV`DDŋݻcV@ܾܶCgT*WA| !WA|V~*!::b,ĉulZV!vVA'On4aچ q捶 ^02 8k.m_b]^Tw٫W'U_h)ɲ9O>$UVj g^[Kκ$dXxN rwwS3e0ʗ/wfR-\8v֌|,h8a{? #\5mڀ}%WA|]Uƍq|Rjj ;6 r_V 5OeK?$"v\ZY7ߤew*&׼ykA6s7]$lTÜ]m6Mۭ[gEEKx=x^ Z_=+ūvoFX  zT+?kk`f#ްawygMju1~}IЬB-ٔݑ+ląAhWAG!Vڰu)[ ,Hy-)|0E9MuI*Ȱ[Е$ [(R0E"M*:#FyK2݌՟zVr߂) (h'7J׮=+BO?ԯ_߃^Z iߕrQ$~pea!U9_vz:2=!Er2oAgϦ{zI"Bw8:uj͞¶ɭ\9(ѻ}4IW֋AKTqo%٪U#fQs%}xؚ7>]$HUWX %. &oYXEA; m jk[ӂoe M\T>hFSAB8%֥6Aj p^+}2E{[$sh /],( ̯uvΟD"f Y ?m^zx^^pY͚":Cԯ_ݲ$_SI&wx8@}PcqbEJn,CzX#m!1m6CaT%}w,JLzߜ senҥzZ~)T! Dgyf<^eEVApѠӌA֋l'OnLe`U(G8* VXfʹ^{ïef& m jK-VXĕA&1i(d68r^mXi]Bc[Ïp^+}2E{[w BfwҼ"I|F]쫂.l4lfR?4551 >e0"Kp3%>MJWAџqK3(s~{ Z>L0QVu΋qgggy 3g_|GXfttK]8b _(gژ1}wظ1kׇn {QfX4䋆EN3.?8L:9۷`Hq;ϯ.u!=$$zuw"": m jSK۲ T3q F4 ,mXRXИ€uÏp^+}2E{[$sh dhY g^>?&ݻuzM>$1q7!i4=4.+.~_#G$@BZC$9X#K!ɝvF>  RJUЂc27~6D4hj}v^td'7]#]Rn {QfX4p`˖٢AGNJ.wͬ]N_zj& $],#U."ѣO3BT6Ujoe~PhQA K R}r+bQJ_LNC!3DΊ$dXG]sZFY Av3+WvY3-9y,U1i3['8<+WN OF#E@4qwwŲP2Zx=Сk}pժUakQE UP^^*"i GKF5?Y.ɶݹN/sꅛxuj(, c|gϦC\ ӻ9-KkJ.*;wۣz ƲI a] 唷uIIM6aZ;[aj&'M#8*Ȳff֥6Vj6B=A *Ѽ+哅Fx i4$cfp= cw xI$y rخv.\8.nСXN ~ 7m ɴ7^n<8~7v|\DDg~$ڌ'߃'E`T E?.ƤIآAE'ǚk}l̈́V3-[5i`a(݇o#5)TAº`XM7{ʦj Žh[vvawl?|0,, *jSRi]Bc[ÏڼD{)ʉ ZuI*Ȱ ,#,벨%Y q;cpll<I~3~0dE 9,xqB۰9mQmÆ8ԨOً"?Aݼ|gH]DsWlMVTN)mo؋iT>hQAR1ІTNeE1WS lҼ.I%Q[g|pǎCBj\`:ZRm|BO0Tdym0`Ҽ.I|k񙗗Ժe*7];-v-k*vT~P6hFSAڄ.G(Q:d!D9Z-86m77ɴv`9RADb ;RJRAE%iE=ˑ "KHhB *NM2-H*H, "uTaA^I*XI*H, "uTaA^I*XI*H,[I73ā1ÒTaQ$IWNQBRA%{޸9o1)VAߑ@5lAEag=>X)JH egV@9J@3?`mK͢bqڴneF F޲2eJ[tOYdBϞVo1}]w d?ޞ>7.s_P,'TA2Rn11o5n\#|!)W_Ĺ:3.[v ETaQT$;a-3=H*`ժ4jsrhe1o xy57*b涺 UKY-Tɓ Ύ7l7o[RjU\t[e̗/ÀGATPQr;p`.]`ف]FzC* *f]J E)TaQLd o`La*ut&I\" 0F4 JO N!!,1;{q˖~$Lz'Ty\ ąY=O eaaa`? J1chxx_V_r'yi0RNX7`@oV/?wlzp3uz͝;J:e׮yӧv̆Z<Crqq_d>h 0//Uc<I" ^2dzlT((NPg kg߇r]]]xQ8X-6E ݬ%cְ! uꄭ4Z.BR" BK_0WN3X0S „K4|P e΋߻wAǎ$/HgyR77Lizh\V\GHٸ1߬Æd-f&ߋը40d+0B , g9(*%e(\M rVJ^ Zzj& `8޺u;EMAoC{ݷogS? gG%73`p3g QP S'  }(wS>k@iذp8~c[32u0Hh5cж,?F*O(e- 2,TP (S0>TAl ,)}ABGTAʆOguf^Lqo`omJT3-}:HEZalX`WHEd :vhԵkc ]q\99$$1PA¢TdL͝;RҐ%Z"9\2.zn*΂D,*]wY dzlT((NPao>wll~*4Xԯ_=67w}vۆ06_N:uj#Gpݣ$B!+?qsv7v˅UYRVTCACixw[=֣)fyl ,)j*H(*H0Ҟ'Suسd>{R:7LkH {bv&AH$etiխC^ǀC>b+:*;9vڱ;ÕEi s5c*׷u-[AϜ9 lmgFzxݹ^^9͚w+=wyX\8eGAq <#":b? [" ipҤ2ս3EM }Af c^zʽ'۔ҹaZ!,jIVBYs223My _ N@!_W aQ:!t: ۹$Ώu'ꃲ˅Rc\%רּKRA-UJqsl[RH*@pIA*˪.& â.UDӞn6Zt.v4m[PMII{hoY -]:,Y2g`7~̘GAff_]ooOOOgTy_~{ r,hSyi;\\=$D 8 ,SAa}s~OMW[P7dl$5 2,즂_5V VZA?vJN-R|m26l,],*?\e[Z_BAi3f USWW_Dʉ {תWwΞM~n]sGUvk<[_C/yP#=Rc:^CBYb~~v5ؼ j1lXMٷ[Ί gD 1;+WvJĪc%7oް~Z :GATQH \3*=8ؿ& Z*ԇj dAlsgK=2HG~GaWjGZU@E0K.wm M+VLҥ a$˗'Z5E?BՁHbE'6~4 awxBӧA ݺ!ԨQ5## oHNa83g$\9ѻ}4ܹ wwU\-"3O10tH RF7WzF5EooY ~0hBà 5a;JCLFJL 'Xe5 TC8KUK{znO !p▯?ߒ~ AR9$,:K KDH;0m܎+Rrpf`m>2mf =8E!R s }jժUN&L`~>a.ܱcw+r𕰺KÇ˻+TN6Azx͚ 9ylmXٯ_(v8BLCsTԂ}vW^t؊}' "A˗;ʉ̗fw@͕Q5k qzxC ֍mj޴)y,*SBM)6e5 TC8KUK{WZ A-_91͆2A5kVP/ͦWAџqK3(s~{ 򀝌~ʔA($/n gy 3gu_.:"; f<\=xpx0 վ}3؆_]ߎby0Eo[|t yw}*!::b,ĉur3/A>6nC$5 HW7nܛ(}8AT(RA!̕)AE͕QX;\?V)"m'!oeihh[;ʗ-n1ctH-1)UP "JϨ]]]]}pϞXF|e->`ئ jΟߚLFF[U28*PpɥZ5{:*H91q駳ti3|xEƱi.w fEgiU>FGo`xG$\99$$Wƃ{www=vl j1|O?=E6t5ՇątaA,JMIMATܹ^P'0rI1  VVڵ=w  Eee-8BkAȏY.ncWܹNڵk[+r'ύb?R1NN `C*@ph#N~Gz_#E;3 =xB?s[n4ZY-4 SZEdg 8ҨH(9`+eͮi&;ް!ά.5bh Pk "Z*ȧD22E Z}`o8( G7-ų2H*Ȱ(RUm%XZ`lfQ@4%Q[gD[?Պe޽ A>}ιɨ`.x$ Q*Yb"<e8 TaQڒ˞<~|὞~ڇ=(Q@l:݌0Ť1ߚ KYj2\ٹfʹ >{Q$ QP8]Pv[Hg" 劷TU.LH(~0KgK;J|IbH *RJRAy' b& Q@AXJI*Ȱ $D,$D 8 (K)IUGb)% ÂTTT((JPnf>\%רּKRA-U_ݫ {޸9}H*@pIA^Kf>FN\;rmGRAE6}x!ȴKM6\ݻ?/y`}W%xz?7ߤ*Z]+q#D 8TRAȽ Xnj̳ډ #ǭ[YXFѾ8~YXقQ2ˑ " QAy{.իS/ ^~}I!/y׊HHªFP\ى' 6rdԼG[zʕ@_}R ϔ/_ϯ.2(v ڵk;Ϯ]͛8 j8 6 9˻kܸƺ GATQ+&C]^^)"j(cܳ+# RvP؅oI孺sgZ$>p` j|טVQ(#ѣ_y+WjG. ERAA;`ߕrQ$~5fd$:10пA]U\#2ۘ1}%mިp8߲6d8{6O6Y0& xp,ܹ wwU\-"s.mTBӇ=Æ-}sؚ7> g9*Hx.i:ݗSa83g$F 3f X ϏOX6ޝeNNbbھ}6אּ%7&Icܽ9\ c(.}:M@yElpIRA@K_0WNQ r~.\GժG #arn'NgϦ3A) ;(삼Ujc5xpwPE>>XUˤqeDyթ1́#"mIArpw6WWGW<ܳg>{,ËZ>#a 1chhh[˗y3~{~WڤIo][g5m@RQAsaZX:H$};/]:LO 0_1h#=*["cT(RA|NPu 2ˣTAJ' j%?? rv/2.,G>N,r3d+SL:(삼Ujcpo?5##A"|( -[*HeRA8P X> Nu(Z3c0]cXwҺu㤤yy1O7" FDsGY( ~~nll_vr"4"] U/ȑ8@WFE#Vڵ=;pIRA@Cixw[=֣)fy alP.+WN 䐫 a9j1{v8q!!ޮ]s}{ڵ1h8젰 VտR%S6"eĈ11o)Stdxqл~j]TaI;PGZ138e`ž؄ݱcq$f~ׯUWTT8' GxC>bm+Vtjذκu%̞=y䱞uxKe\27m)]]]||j3g6ax`-4i0s0wIeg/f9ny<^^ CM͚=UޝcuP7 I-3f\9&QA).¯ҁ9ʰv%"#arnk'.6덖fvAJ2‰~~u&)7hPwR4cҤ*ۛk( " +d;]E-J|4p\Q)6U"Fr2?Q1\Q&"j!bMeunm~lFD4B "o4 "Z*ȧDnE;6ܺ%,,G]׈hf ð"tk( GC-(ٍGCMGmŞwf׭5}ιw8n>[? Q*YI'ZTs6D5 " |k+;׬<ր?n Rsr^;-B벴? QP=P.#\TH *RJRA$D 8 (K)I XD;T(B,$D 8(`@RA ThEI *RJRA׽w7ofg[ fGAv|`=tKz]Tдiٽœw+feSÜ-Z<Ŏ{r߾Ej9}s„~jƌ{jdf&EfOOgTh0ZЋ?1,(ȱ#o-#D @0젂j}ܻwA^4xQR8mpy<ԯ<j#O*@ PJr k(o?xF׮9ujc*gl]8HM|yGdd1cJ]4߹F7 F 2='PPl-.Lr2zK9w.uժ).lܥK$B]TP~!hBnAH4cܸ9t˩TAsoruu9}: TVw3V脯ϏOX"oyn2' 11om>KXoed$`4无S?83g$\9jػ}4I8,: "@ qhcqbEJn,CzXo{ALl۶Q__=`kL{Lfgu؊%Λ7Ņ|)s jj|ϟATxxI)j̗)'7Hd&~*Hy.O;]B>D_~b>%h"oQ&WAJvHeX1Y ]] "3??\GN^pI@ 8TPgslLG$ܿ{1rԷoK'kA>}B|ڵ1j«2 @ B gpLDy+'bY4Ttckzj!!%n8)it^^*iD#Yr}qu~nllT Dܹ^ya3=5@ U/$v(`22*]\ PDQYY ^x\AY9h0{ĝ;]{: "@ q!3S&M;K"(SP9Q~uڱe…"; СXж+:5lXgݺfc==ݱ|㍗Z\(WAMyJbpWW(̙j eK&M̜9 좪 au!rً1`fh$dF=5|X* N6QQἿ7{yygӁ+a;(yRA@  #,벨%Y q;cpl~֭,yʟb?z M(@Yv~n1m g_i4r;#BAh Nl "@ Ou{R6lJ.3|pǎΟj2ͮ[k!}}o۷pAYT@ @([SB,nW\fZrXoii3[H*@ ` "ځ@  H*@ ` "ځ@  H*@ ` "ځ@ T͛6*޽7n|HzH*@ ` SM6Bd?ޞ>7jg},h1}]w ! @ P矇p:[Ȍjժde-II}}B˗w'On4;;ް!n޼vnQ'I@  ⨠_ӟ~ً{ pN| ),sAANff2_"Qˉ3e/(_͛#\4m@)B2"d8iLMa"…mUV߷oK'nQ?I@  53['8f\\i'CO<بJE###ͭҵk{YE{PTVB(^hEHjU~eo DΑ#qoߢWwۡD$D @0TА)&M%H4ڶbE'ᮮ.>>5!Μ̾=vlMfQ~-j~:ErdPWTT8c-8츠 Ν8`ώu:I*@ ` h<!d;]E-J|fcC2K^ݭv;̎7maǐ1 @IRA@ AI٣bOA ͮ[k!}}o<8ܱc} ٹD$D @0T{ʕkLKN{yz^^jgJkwTI,QTB""؅.ڗXJ!.j!%DRm-UjBi-=u;^77}̙3gΙ{;{ϜoRVܼ?.Nii "########EDP5H"#D "########EF* DFFFFFFFFT!@*, BTX<6ddd5 K]22}#>' ͆;$2i݈Tl3@*xLF*@0ȈTlr?;h6@*xLF*(p縘̮ _H W[*?ǐJrA*xLF*xL6UЋiSPtQR%wV 0all84I@@=I@Xo7ۡ A7K2$Iz8;; Gbh<@tBIT Tq;ݲeݢE_)\bڵSMOOU2F-z睲(H.]vn][#,iJvGF󜸸%>zU};̀)[-::T G 3 @*xLF*> e&M>}xI˗Fh۶iޗe(S+̃IFq,]:Lgάtӳ̪U%\5k&7mZٳlѢ642FN'$ 2222A222,Ė-(`b^UzxyX?;ԼC,mGhhrJ:9sĞl=WAS JrEà9hVRAddddăddd*6RAقwi֭DS޽cJ1ʠLhBV@*xLF*@0ȈTl3@*xLF*@0ȈTl3@*xLF*@0ȈTl3@*xLF*(S8q&ǚQ;]H#"M,~ ȈTlLϴ<é?gLڪi <7Bn7'ݿWY ̫ 5-lh5 DFFFF>?>bFmy0O222ERfC*t_5OOVv} K8:{[RAwRܐ!CB]]]Vf޽{c32rOuqq{v1cGG޾ͯ j曅K.ڵ=FJ֛wxCm:ӳ N=jTPzg;6)T`gtz5lTK!ͦ[M۲!@P3lTܘgDY/ge=פxR5m9pۊ>(RAn%"@y { n8ÇwAXD=OxyߡCc'vAavJH4k.aCS+VS&ܰayWwrwwC""b/xzLqc2$!9=Y' t߇-~ yr %PҦ 9l:6EQ\;I-a =܈G]\oNOU!lh3^!O.ſlzG6TpXt˖uu>~|0sŊ kNEΗ6==%&fWYp{w} Kݻ[&cx4@GyN\\DE=J'nND3Ye˺EG*sRSW肼~a&BkLE  yr Y4RA(3Adի'/GmP1Ӿ/PdIW{P1Kǖ)S̙<=ˬZ5Q#a͚M|82[ Sh鄙 Q0Q`K:%wdiHFܾزe윝X?SjU/ :4fi#8BC{+W'ds֐W*劆^9hQ0Q`KY4RAw V)M)?>IC8FDYP/QhvȓK wdiHVQ0Q`K4 Y4RAUAkL7&Omv%\hkj3ƏVNuP/QА'fwdiHVQ0QV6=zEtu@X-~T yBnzG6T`Ueq<{v|РMք9uj'G PS&P`wʕ^|Oּq|F*ӳ &GFCr}{߯ٺu^+N>ܵiSxfi BW&fǒ%]-6(hr3;i((cU ݱcKoT=6Jҽ]F z0SOs۶Y-ZԎUsޞ=[n][xxd*H Yy^t9,]LqIX^H+[ ~$$̓td% r(hr3;ir'ΤX3բug XiXUk((c߾#Jy1cCɐ:TP*MQA[4=2Oa*HҩF={vNJI t=C~; 2 . (#mVW@.HO|bcQ^ P/QXِ'ʠޑM#sOXaDhkACd\?DzrާOS3|?l1Bn((:'$$C-ZNK[}[Cx{{@$Hz*??+ nJZգmۆ={dI 11shtzUznկ_IH̜9P ~F6++` z(7jTV"ȡ^!oWFCy, PҦ !|0e癭G/N>cVMK1_UFgy7wjPsxqo|lYU+ϗP_gĈ`qh0 fvWSxf wC̈wd_F7CAY{mP/QX͐ϔW799Ά[r`4ΟeSe9:5E>wdiHNI;C?л/$N5Fx$M"<^SA˖[bBd l5rTA F̺u+RAY4RA9FiJvoy gw"_g~BY'O8.]r@dcte}uLPP7,\t׮a!Ra|LBm: ,2jT:vlRPKϚ5_:ۻw>ljwcD+3ghZ8;;4jT ܽ{JrhOHH NfdQ0QoCz:| ޼`A{*V|k`1*L ;lYWݚQU*HTxp3*Ur/R 7t|!?m4?P~?_x@t,dY4RA9\WK `iuCn+ +||,ViWY;:4w LMRڕi_AŊ偛a4Iq } A1Ggn`;Ǹo_r&Om!F5 cH,2t.BBkLE u LyB5jx"Сn' n͛=mZLឋ{ݓ'G#3bDW 9XhEѱ6J1ԩ~@^3" $7\[";ir5Tu(_cNTҼʇ$jLoYkf@[{ǷPneaUwXb[|~FpH],@%w=]$=hhY褽{3N^q ;\ԱcF̆ )^0"??CL;9k`l6i#6σIwd\((@0%  $ jժrbbmJ ];ih$I%Gb۶Y\r*'>&aԨ #|էܒt~6vm&7\+ ;ir~Q= +|U9n;tBa->Ǐķ^'Iׇ_܊$ a1_6WFCz tO!]vѣl"dk1±UW) +lݠ9;;]<!5 &"̀z:|Iׯ;粻#j TPZj$BC{+WL_~F0 v֭©Fٸq:= MC>`PҦ [(]C?~|Cc'}'н{aY6Og/?d\jZ^ ZzCe.I/ʕߖd*&M|X+&U!;;y0tPD8G\\+zG6TPaU?k>+/ vỨY=`@;H{{{@rd<̦&l"ϠA緭Tɝ C*{ v?~|qۼ\i Fv@O6gΜY+M=ܸqzz8[ !)bw:!ۡ5 &"̀zj|իxxbzfϞ˻-*?h__t|\q* C,8SɒUzm*Ȑ`$̷JޑM#syO밬oOGv Nʛ7wf"Tx7|$VIrZaj0"VA/!r p &yZ>QG͞9s ceI@`R%/ϊ)й Q0Q`K4M oM ~[mjΎbef*E 7 2TQAF[ؤ+ HYH(NI=>գSJ<||>eI~_v9@C·jF/^܆6(߹<'==w C"dFDYP/QXِϬW`߻wЌ8rvbTHr866'z@#KF*@*h3^!bWkv,Ñ#-ުzG6T`UrwԾ%UB(r8N^תUe݊/\nevMA#KF*@*hs9eA\gώu%D"P/Q!O8;i(8uz<11S<=88Qz/\g75+եmۆ;VYRYsZ|4B҃_j"+|=!GFVp=[ޥpa'oooY/T y) ,m 5 6* _hQ5k&ߺغu?Us;w> %4~|ۉBBlݻP Ψ_*k\`$DS͛gڴ׮|jժ*SB(K!fwdiHVQ+)FBYSk˖݂+O^w~ҹsyAh*UI:)/-O[mm>yrTXRY!31 ANb!*őe&'/T]'y) ,m 5 6NY;ORyf'z{Cm-y"mʔP ŋnHoo^…8aIeJtPPe8QjfUWVD*P/QBPҦ 툋7g \hkj3ƏVN,~1.K]+>>2&fWo݈]NYI'E=y=JTV(TA;w5thǥK -WALH ƽr r9;ir;\,Rٳb%6[iZ`#&@1|*.@3V 9,`#ŋ}˗W,۶B!lGXRY<浝]?؋ē'G|pr%yCCWA^иB.A.zG6Tųg jߴiM0ΩSk7 שSe({Gݻaoo/_>4>vE%$̛9s gϙ3Dg{V)Ղ{ԥK6mTVu"m(Uuکw۵s\4.ׁmVW46khɒ uk_gX۱JhPKj%DEtpxã~n%bTZ˫lD G&C@TR]8PXRY\!'_>[6N{nլٻ.EW yUP/QK!],m׋5k&u.EGΛ7lЎؼqc\(I pPKo(ӳ &GFP9Ҿ/\[gaŋI?~6m {c6++; f>^?8},YߎUBkuJOOw<Tɥۉz4T!f=1l^`KR%%PҦ z;ua|;vawѣa3)iIޭ$ݫ۵kRÇɌNZ?aBmfhQ;2r(={lݺ(%(O krXL⒌X^H+[ ~$$CVe'd p=*~-BDj/\],m׋}F*3;_ *Ÿ{P֭ j̓'cI:lԨڳgԩ;uj+T(}2Ӳe]8T΢Ӣ=[ޥpa'ooowh؄`3ghӦ5׍3HUAH`/{r˔)>jTWA+^ Q B,>% RY4RAUAkl eU+̇^5oJlݺ>8uj;C~yg]=z7C,h~}صk{zn5zt7v_ (+ko_SAӍ|v X[+AxP& GyԀCRSWaa'P޼yM돖V!mF#ϟYӓ吃'OBEH2d^uҥE81 CW @lޡ\G% RY4RAUAkJqTڲefo4\ӧݿt&I]jJrb XΡCK:u*য়BTӧ)U) ' 6a)D8nĢE=;w'>xn쉸PY\8e*#xkO>,TAŋf*gW +ֲ~4jTe_Lbh3z>2E^(K!fwdiHVQqy#7>ҷoky΋iS6gߠ7b 8G$xP/+ejAۃP ?{Gww7(3"A9!^r\MrĻWF`gn0`޽[q4bDWN"NЍcvG,'5uSA_h1eP/QdKLK[@Bw<ޑMddVeZ[ic%rKٻd˻#cbxyۍٵk;GG*OW&@(U۴i0`@; ap:''{6o;q< c-[-Z񕨳fMO鰉US *(66֯3B v؄3a]ۃ{-k۸q:SA+GTlj}5CQ/ީY4 " Z`#&@1|*.@3V 9,`nç/_PA@`SɆ*U1rR)Aq) N 6 ڶm2OᏖq:h' hCxx8;c[Q.5]ݾ\qc *H- &SAs6=ֲfÅ ql``CW @_,>% TKưi`XaÇwa1SRVG^͋Y}c>fwdiHVQr ^^p!cNXWوAI3bB$fP 7{ooWLWW} vm&|ӽfa8JBT\T=_>[Ȟ2eZ̍5k&4$${0 Z|hadiWA?Oo1Hͱr8|plx#@FZPA7o߶mVΟڵS/Âw % C9PDN۱ctoӦKA.aw ߼yFժ¦*0vƟ3:ޑM˪ ih_.vs+RSg;tGw;y2cu`*thlz*J4çNg/| oʔƽҕ+Z8ÿv#t|6iLR!c J$o}PҦe 2BDs *>`Hwwl6mwl5⃊@0Z`RAP/QRB} y7=OS ۉ(Q($BƎ6$o}PҦeqFV11S<=88QzY#իVd#K|A'(5<a +\Kvvwԥ<t5|gάNkٲ.VV @6c c$S{5 &D sA#dV G^x8t2eURSWZj$'Ǝ7‘ž2_}T;i ΝCBي:(E׬|VbFb̜9zo׮d`-O"_>[Tp_2rK+aa4TQ0  (L_Y$g*0F<ڣ\I9qbO&1t 5ž T,~E #K tE#=Ȏ(`dIw|A6*lHVa::`9Tlp-ݿM:] "])T>V{jB"N4U@kL*@0%=A`(MtozLžZ-,mZfTP},rCbʔŋn ۷ 9.BZ: :ܽ#;.q$\cVB$]IzY|\&BkL*@0%0 ő&hYڴ̨F|~!C jTO^ )^^e!k\%K֯_|yW||µt۷ϮYS~vl$WA5|PAj\ [+VL"L(8+.Q6Wz7rY||Y@ KYmTe,>X42iPA_Tpm '+chh۶| ﾋj:>a: Z:Hd M((Gl-ᓫ aH*T^ _"L(e9/|j!D8KYzG6-3*ȫ3}w/) WATZ˫lD (3^u5Zj߿4PIt@JB@zْl9r \׷zr2NOOqqqTc-CkEdbPJ@g^?FqR^8SA3f  lr*HPVADA*ޑMˌ *]@r9ϟeBiZG-\v,iS8O(XaA)Q./]^ӎsΞ}/^TГ'G!"$ xe(KabZADA*ޑMˌ r{G /^5jT]H7h M"L(.>ǧrA)Q.Q\G')/ U0Z#2 3^ DPҦe}AVoY[AE'~}ARV% e)PL!P/QdJqO)C+WwV..͚W酼GmA/[6$&. *H ={>KN|6`jΜMEr1k^S&(_B7+ꦲ$Oofd0MO*AkL*@0%W+P :!0ժe޸p!NY3SAH~ )a{y,BDBC{̳g70$<\Lʔ).|'e~{|児WiSxTȬ4IRA,BkL*@0%W ^Ra!+2%߿/XU۴i0`@]r$z/UPll8oaL Wn12v?L{3S;͋HC#K%čM AB-\|?"_fw^[IbbC8mېGeQY^^7"w)(>hPU&‡/ 0}A_(Q[Ly8K hK-|䧐D5 5 &D sA#(U0 =[0ԩ}y,l\=|\S٬ M^ 0쓒\qc3łڼpP{N{{\frӦ5 /*",mZTи} OoYuio$$ź pE WBbcCWX-ꌑ|VbF*;Z d,hfxWićEa)q^ܹ{+WN.|$̃(T`K R Iw֩S 2! pqx&6)/#WY`y4@;["J(QpurgON[ۼJ.Y2?vH ڹs_C;.]:V9;;=ԭ[+&/$P.Mw[.L2B^@0Zw0qc#gǷoj lz"+CÆ,; W Վ,m*.}F5^q&2eLTA|H@~)S̙<=˰G˄+غmf!s6#,wW"=lX簰~³?yr7 +WZ(T ,6y%@͚_|Z-%KBѱiwG~ zMz!l2Z=TmA/[6IL\U2؄3ghӦ5 ArZRZy T\޽[86k._d( ܯ̔ a)oT^/FޑMˊ uB(!̀z"+>=S7h֭c 駭hLAopү_} ݿxq[Ѣ8]͚e˺I"+UN"TAf lc/]zPr̘W&@Չ 3^9uj;CvޑM˒ κ'ObMңGɯ, "̀z@6?Wd@m>Rdp foFg*hHR(T00cxO>Tp :sf}|/^1ԥKӮ]hQ7 Y,=@o_QH O'WLxMf/G#F^kYڴQA/-{2Cl_<6v, ɌS.)RĩF OP+0uj9&?cx]֭[`|) lӦAVzyjpw1P^%BCkL*@0%W+P :!rtrpC4ða!l Bo^ HZ5*(4<{vSAÕ*RL≸+WvC\]yAruBtL~ńݟ2/ Z;PҦ' (U59yKg[S0Tsi;ujn=|xo jcL%2ck t]"q zΜ9W{rͭVQxy]WIBCkL*@0% 炮G.PK(`&1:w~'dY3`( d $VUÇE8/_Ez'%-rew>L g* .ƣ qcvea)g fԩSH߆Z*HxM>xsP9|\C;iSA-?eեV#%$3}!X cpߍ 4;:xpOj|m${X%v+^"ȔE Ǝ>jT;*5uq59ujG)_'VC ' LKH0@~p!Nxc* ¤I&*[1JI2yMU@Ӧ5 vB>qxxH߾W^cvTP@k' Yf cLQ&ñ69C3nj7SU4f3Lyxlmt+7nnbt '.Onh }5=&z*WA1rdHnݚX1A~K:obR2yMU莽ɓ1mBȡ%KƲw/T~y]&3%",EVjHC dSpqTxxc6; -{MWA0@Y}jIqvuVFɿ:n]Sު!+Sq}t|,r Oc5X0J')(e#P/QА'fwdiLUA#|{E&N?}H.Ly-N-)RĩdI׮]eEI)WCJ剆TouW/-z΢fuqtU\Gɍqz̟ 6eM!a47o3QQ#q z0i12J|u&u@kL.`K4 YڴLDGhU!˓"!WL_Hi s>ՐF'*mp@(=3b" 5`Ӧps/ruMk:P+/d*̀(83.#}Rͷ{q0`P/Q "fwdi2){Į,R6eZEZF._ޕ hʕ{)5 6%jY7~A"[ OsQY(Hr3;iYyk>h!+MS$-QM&UPMċiaa*V|B]L e?2j Fvd Nf<~|u))r3KyΈ{- ,mZv `qh-z uvƣ%1gJ;OP8׮1TLqӦ𨨑)r3KRAzveUw Ͱ2wdiHVQpfU8 :sf=DN˖u!TRRV.Gv$݋mmW^=&fg7W2Y^^7"wPAoN Qb˪Vpvvhޗ*bϞгgû.7٩SB8MEsi=J^0O42X̪ד:D`A{ǧ-3YF8loӦ5F ѽ<=ڵ={o(F&ᑇ̛7ϴiQrРZCݻP'*|" Mx%}"N8jT"==zx;wf,>g\;ڠ0Ktňf9ӳLVT@ *""POAPA,ر (+d |է^rwdiHVQj~L{~ lʎ(`HAɰPmcMFG֩S 5?{q"N\8e*K &8ժ5r-KRAؤРA̮]sCB|]FlfF9,|*!"b{$&.dԫWE\|[ۼhexa eΞ]puuAb :*_t?ؿcR |>eRr#SВm؄`3ghӦ5߈ i[oFFa{/&9s Vo]Q-_``C-OQ~gA¨ã^l^+Yڴ ZwH :h Q֨w􊗈&2e hGp[e.˷ncS. Hf2/nŋn}[Oǂ?d_M}@xBhCU?KOmҤ^5r-KYYfd0U\9+$0YTP"5틂2^άY(W$v/n0uE~mP a h./VϘ1 _>[p_2ySSWKa| m.Z9>>ؚ5=&ɍ͛g4l}V",X '_{NAo`$lW@99WV_)3UŵuV0iYRAZwhg_(eNO yh8<Ȕ1[zc۶Y6iJv?n"J(QrL/IfVϒ%c?˻1_м{G͛u^;.,TPnW`_#!BDaK@6?W6 WA|&,5Cr`83ҥi׮Z曅4 +͚ a@ 8 {"DG[g!hhe '>G{-Ƨ/YO&o =4 L[];C, c/]TN+szT.!ʙvk 򷚑ML:PȂ3"8. rtvx$`:w~.[Lq85un3k_(߾obQH9,P-Mׯ9. dK6;5kz~j %W+P :!_ 0all8*% )_#*>BR=~[L!-._ЫWwa@ $z 2&2nP,&!y@(,WAR5*(4<{v Bz gҤ^.`E!d%@Ӧ5 vaKveΈ]JKH'H#ʙv\C\I\O\U\[kY4 <ۙT)W(r{62 C`ַOB\]IRA(e8=r9#Ỽ72eS"7 *N̄ =N{'d DOŪU=~ہth)߿-Ӈ!C@4۝<Bd2gƌG%O/HiOM]k+i$zG6-K*wq6 Y3Yč/veSAzL\'V`˃Zj?lr t|])+ N5*T5 6BYMW*dyRd0$i%04e^e!)A8\r`F)6~AP/Q8t=rPaএ[{xL3`ᔯ x$.\[pjX3*_lv)ܯ*"Ep 6 7C5렝@DK!Hp  0a6]# .$J>\!UVneC~[ gGkE@ '-[Cpw7ీqqr/L;,mZT^YuAp3BC{`_3~XȗAaT C2 eYy妯/ɂZj?WT.!`0sHYZ`5b\FYHX1ph._e! xcZ 낄*-//1̪r6X8嫧aWZsSg(ruu$ tuLQSAF曅Q'\&xYJ {tE޸q*HԀI96(mSy@zz ف-[eT9.Rذa czFo]3gP{{ҥgʙv+YڴL b!`m::/Z42DlZS؎O2 Wq{_^𤲉DH!*DU[5xcD*^Zb)%RvJR]~hTJ[KTRT'<{^'Yg"f ZI֘IaWB 5%6ٚR`+ߒY.|A-w7Sks(&}(>gk$IALoZ2\#/ۅ)­/\wd3heAZdg4-;]~ľ};GFvSP͂Xf,H0}pW|^!w)"]]-ؿrO(;{dA`# "~ Bi!n΂6}ٳ_.Uoz; -@v_+zuw^"\fq8viIgAp{btRau_xX֙6IT0 .D!_Caː^F.0#˘A+ ";^TE4|}//:FȂ,I Ă곤jGqhm!V99) OV$ *E[2YV_C!=C#˘A+ ";b@ K,m8J Ă{Ѯ>K,*ۏh[HJ􃷷S߾% *EKHBЯC^žߑePu5pV]qjhgiWjZG]WWX_&'Q0 .D!_C!=C#˘`J ;`iW#h&T\;wZ_  "~ dA ,c[NM5w( -%23eJ%6-b;ѣɈ߿$ O~U:3_>q{weתUVbPDAĆD!ߑeP,HBBa4\2&T_;8"6裡 Ȝn`>8Xо}_|Cݺ~%٥%eK=d,!"CdA2| 6,m4Y[ QgWCC[PbVֲM*Urի=^ꀊ.v !x>${Ke>p`]tiհa/XCj'N4˨Q}ޫ[K-!tМlVXh6ڵ(3cgAnqcK-! r ںunܾ;wov4&߰amRܴi&I+Ý_NÆ4V] R?\WЯ& {~G1-,HȑrMDLwOB(r|ݵk׾۶m:t*UYڵkݻw_`w}sرׯGGGw3gGٳ'/)))cǎc6_ID?DL8'N'1e__/3^>q ߺJpvptς\< b2 .aKc{WtV0FNJ\G "$|U@hh //[ňNH:errjij3~dɂJ }=O Wڡߑe` FJWTpTZG}. "7 +VXZ5 nڴ' .\8~͛7O<7n4io(%33>MJJ i gΜ /BT.'t;~G1CѰAӍb#RKLСz] w o"7`/~zJJʞ=J|||TTSN}}}}۴iӸqca6 c2e/.^yLV}l{݄ K$y{xdd,x=%xZDH4qЃ\ٝNLӏш [E:V2kgA–>l"`>d ٪ՓyVuhmZfrhh T ,H,|_ oI a&bESR2rdؗ)xW`iٳ[hCXzdK%J ʂ[nwww04mߴi&eՍ5+do&O:,(L,cRXcXb7ϔpRV[~ ^ti֭)~F}HٶmOSͰnFoC& ogլߏ#AԮ]RKڴ ,/A-j:㩘X>7K;@ch 0FQ^~yB,j\1M)XSR#+܄.a2f( 2Eyɴ"\-573xXի~\b,[%sU,HE(ՊzP"yҚi#e^?Nov4w޽qs޽Gf 6^ rɒqZW8uK`y̗IH Y3YW_//,B'R}-A6ĉaЕkGjbƧ9s=Vc,̩]w$bfDB#˘A+ "; 7C~}vLM즘ưZ1B9Wł+_R͛):(.,P;?Nov`yxD!_Ca[<R j}u*wA40>F,ϿATY8xpWP&bALi}6ADxS0v~ޑ]zB(Ewd3heAZdgv%&pꞚ5}ӆVsͅr$\lj]x,aCy⠢j]P>}Bn]e8aI O>LTՄI$!QpWƂڅܞ2ςڅ,(::~ Z2%C:ݼX֭Ͱa=mXPrF~Ŵz,̩]̑]E4K"; -UIj^4 1hz7ϔpUkj^ J c8K&a0 ,HBЯ2?ko>?/H3 ASآE1C1Q*>iQXY ¬XI)zǧ)XSR?H(tQnBwd3heAeg(r߇^hXbAL)U-jI(պd86};2oWu :[|b 0G7DBx RL1)&&C,w5oްiӀF&$ G K)XSѬo. ?K; H^[\mjaJ$JkE{WKZ7 {LdA~ 5TK恔p̒e"gAxE.Q22f(RuYAq(cQMpbb1c._lkt!Z3%  k, 5J-pJ?]9;l95ŲQZח qP|- OOѣG\YرM嗏_իJ$?vÅhVcu:~  ԯ<bv,cdA6?sLL υk /O,ҥQQ Ŵ`f1hޟ~I5F~G1dAӫʕPc=VR%///__ߚ5k֩S^z 4 lܸqPPP͟y֭[oԩSXXXn_x޽{GDD?4hPTTTtt_}QF;v„ &M-[lڴiƍ)))ɫVZbŲe˖,Yp¹sΞ=ޚ1cה)Sx_}ܸqcƌ9r# /GFF8_~}y{wҥsΡ>l۶mCBBZlO7k֬I&O CR-@I޼QEBa-lE: CR$Y IH8`/_ UrebO78m"K `AQ<)ibpp733g6`A..Δaܸ?z|4萐&[ʘsmgeyz^aɗ.{)|}_ a(] !Z"0`@ʕoKu 0$NBЯ^=C#˘H&"K'!ap8 }A1IH%<`Ad)S0\T' &e:5j„P.=/u\[gubÇW0Xbb, V1~|J^IDX A o9p ka,HXޡ_C! {~G1M,z).`&{ pTLq<`d9Mψ9%vqq޽ GR=8KQicbn%<< p9vl-))nY>uu}ɍE#>ԨSz:VXX2`;t>#ςӦ \ VytmfZh"V)w7k6I50X۴ 2:-ܹYJQBɗ17oȄO>|uFu+e Y "N=jZFq!(Bu8-SN~8q' Rr2 &DΚ5eg8j{+!*Zƍ(?#cb"`#~2[@]nݺnݺ={~{饗f͚U*, 'K7{O"G"ó ` AA~OfA̞380RΜ̊ Z)h)2nf,c_j4U,Y2Loߎf kڃ'ҩ[$t 2 "Լr $|34d$Ŭ% )#}%^(,Ϳ/wd3ĂX[); $'O %Za5cAU:6{ufzG&@/ٳuL-,_ [P2yU\٭vK'K{>xQ!-1+O{.j֬~>xpyHH??#^e^?jI4یUWOVDBfUʶe8a ' >$2_,S KPE$ljLڵ%&B+<׆ q& 9Xh nا z_NN_3dK9M6+W.Bzb#Fӵk{ 4ku V*0ɱ^ [j^~a?/EQ-֧f2+:>F#O1F'UԵ Y!!axM _Fdd7OOaбW2rdPPOY4c^1FW38I6TbxoRRzzS-Z֭g|xnn/]ځ~ү_'ZLo֧.|IݟĂzk\u3 #Y3N,Cܺ Ӥ>ºUeUW3"h + ;Eb~JdOR'7+Wv nB,C f2VXZ۶mB3g6 J1-.Bp1f uWS]zm7G=s?w\J,9rdZZ+R,m,DJ}v4q5;~[ҦM`1 x)j;\8Ԭ޵ES|(l+eE}I k‚x*&ƍcР.l?*RF_,Ç 3YdΝLQL,Ⱥ,'OnTLa}h[a5cA | ^n%Nի'3.ҥo};>K,fq(u$ԧOh߾UEo0iL3ҀÍoOJ' W+ȎeUWZ21/L5p0J>AzzQ"[d >ܸ}w,}VkNc+6aWS]l+VXo6sJ`AvNj||" 3؏(hKQ-֧fF؂z UJYQB/ ꫔?3[Hw}7""7o|Ǭ,HB`?/Em X)0< b k‚8U+S?#͛K2E,c,HdgM`&zjO?Xa- 꽞=bEgEw+&ہed,QxYZ4% Q7w'_~<˖M^K|OOJE|ޱ/ZJ¿7ZbAŽU uhjռׯAR 'P q0!UYJPֳU'֭LzFY394Z~e v;ߪWy Qw:EUȬ޽;88999 4_ [.ߢX) .1BĊaf,$8QŠ}AȉMj&b/Aˑe,9|ĦM50.geZa- R,uթ;i ,E ʏW<{woݥK+vzdww"3tWHXqW_}k8-C (lo&ݻEl Ă0L_XKf(x)~5X2fTs-# 2`3 .S",hڴ?$//dd ǎwh/|Z-˗ޫWBh?8ؽ{k/@hNž_Caː^Jqd42f(J$!!Q0 .DѮŴz]>**,X0M Y$5Kgwd3H$!P0 dݽ{ģR%ڵщÊ\ڦMA^zjyZo‚7*&:-|Jܺu֓O֫S7&&]Chw231A+Wvǧ%^ m i3|xMfҧ۶͡Cյ1I\au~ R$Y IH8f -M?}m]ԩTww3g6 32oܾ}az'o }s?9\gz{{|'փ0'bAw}JKWb,ܹtޛrNV СCs7ooYfr޽{IZ؊8Kk("a2f,HB¡`4ld=2np'V'e/DfnUorGR7of EtκيC{ݗЮ]3bA'7/X0mwQH,ҥH,H1XCBP6ԂlW(la+`xc6_ID"޽7YȑALŋ۵ xS@p٦MPD=;{%ÇW0Xbb, 8?NX=%~oNصkZ V';PH/Ežߑe` eFJW$pT=YG}. F3L3L\"V{=k׼u&nvN-YKvhaA6jT7(-7tNc E\Lytʕ_|3G;˖?XX=ׯ/@ڿub-X: A2f(0hW\%Ya~qwwիW0 `~ E x)!C ,cRXW/lĂhYFl2,H(*P8Xо}_|Cݺ~luJ g0 d'O7.qO=q_D>:u|kҥqKǃ w)gXXpN"Y cA5_q;gN1q@'rĈ`,_w*ƾc\"ӟreZԕX[o@`i3!3J J*§ʕ>}(nA#uHZ+,H.ԊɋR\#p6Z#Duz1p+HrJ1DQF0 nFoC& RXgvΟViq]+QЯK8 gRapW ߑePd&;̹]3"8$^ =cTPԕXP>}vUufyrsHgfczzѧYYHzVXF]k5' ޿ "6ͤ*`p%~RR'ױa4H99)W>@$!_CaqzΤ ԯ¼A3A#˘A+ ";q [P~Dn};j$u5[SRٳ[aؚcTɂا_~zjd0h m偶l՝FuPgA.g,Hf,H:6fIHk(lR4N™T(յY1rFv0wd3heAZdgv%&pꞚ5}`h+*"$u5cA@:)̫#YG |]c(E.('7{.rvB.ߺuSs6GuP3e[ԌI\džLdA~ -^U8 S6 Y ZYYZ5/ ^^$/dA ?u%/* ϲe*Vt|Y,za=[zf֭L#|Dw5 O rZj޼…c&uT*RF:E(\{Vd{~.((ғ~ulK$!QPh^ ԯEfaPp2fʂ*hދb,ZԕXDK,Hy^b2p=zE]*8!?k}5wH2g h3zD)By!CUD3&Md~:`ɂ$$  -ӫvXWfaǐ3A#˘eg ?+e-zAVucYa?K\LdA~ ^U;SyCȎ,c)eHv(҂ux< s-%*`ց {)!gdǃ~G1-ced0^C2%‚Mb/]ǎwh2"/ Ӂ_}LV$ {kժʎ%)1PAT}B CBB–!o/Eȥ2Y Eɂ$$$JF3%`xœ'7 oreT)*IF2,\[x~{f aOJTPH/Ežߑe YCh&uaPJ\k׮F2+6 @b^{Rpٵk`7\OXQ/_ewҥUÆb ٞ8~Р.F yhYQgWCC[‚4RXKhga6M4hb\{ĈSP8 o{rѣ=z/#1cXN;\(?D9;{SؗwU+Wv(~n"~*U*'-Z֭7 #GV(-ڨ3իB"5k&[/X0Fr\{Mpa{DD' 'YPA_C! {~G1dA`+&q<:){!"4˰u,P߾sA< :-ti*Zx"\%%%֌ |]c([Gpqq>z4ɍ޽@Pҥ!oKOOT̘1,,,Rrsw-[F-[b,Hf,_N+VLЧOh׭UL ձ\x, $ *(k(K)-v4B#˘hX`p2&Q|Q}4J'c- \)*_[2YJu&/.Yfrhh x3p"=xx;V1/|8?ί\ٝPш H[E:֐2kgA !(*#c)(ʳ6g,)Ta=[z޺ 6Ў[Jxx[7opoIXԩTVWƻ>t^v\\4;{v+]mKwb"} f=֩[O.^t³ BBpZ T~nn;>BIj"72f( [*cABK9vlT*/ꚙza4ld6L"Eҽi׮ۊ_vvܠӇ#=k`ժ7KTLh&fԛadPvD8 5kmc =$e˖H5k r:xwR 0QL,ҥpٖ7Uߘ#˘,Lvs%ӻfDpVVe_A~+'OnTL#KL9yQW"XacJOQkJ!W =h&essrR`يL̾kN[d5|E:k(lRxC["͉ԩ%^_COL4l|fA  6p*Tp"]J dC"G72fʂΪUWPߊ=uj".۴ "/`/xj8-ޫn/zڀka4,(k(lRxC["ͅ+|CT4a(YXD:ސO@ON+y~3Qu9 -jeU&'OmԨ.biCwubEgzJHKK^J^^^uM ka4,YD!_Ca;lnhaAVL?l7ofv/rHc,c,HZY ~iFB^1̌;%앁um^YêH!W h&X B@/w0%,H!haA 9EbSW OMզMX/rHc,c,H쬢RV_G[WiӀF&$ Lj};ˌ'_ b,{  ac^W JF3IH5x)fFDdAC‚(-ع> ܌m ,I~_x:Y PG(;VVe"_,:2H˽V`1r)f% (k(lRxhwK 7[ 392f(Rvx \)*S; sKLph cB^%/"-2fTs`̔r@px1 .Sz,hڴ(K?1+cc~G&#~~O?H#5?8ؽ{wN~._Caː^ VB8iet;IHH:fKdYWYO8dHwrewZ^…c,Xʖ ) 5Kgwd3H$!P0 d<<$/Z֫W{/K8~Р.F 3KP׺zuOr:=_|F1Q{aJ\k׮ kmf8;W' KxvҪaڨJEI?5j̞jhh J˪^ -:T~nn;>su/&,6mC?AE,Q2Я^=C#˘A Lu5ᣅITfkvz1Υ{xޔ GDt9t xʕ>}hn{uhoC(48ǎ~p`R3ڶ BN"=όʗwBQj^T.6;ZQQmIv޼QF:ti ! a"cA$%%s NEKk("a2f,HB¡`4ld=2np'V'e/Df6mI2͟?:$ +Wv_tĬet<[vf޸<ONn: d9(=@*#GVTP6-Y2Szd Fg*TpAP&24181t (1PH/Ežߑe` RO-@tw$$ `K&+f>c6_ID"'>>:*;2zt_z}A35g߿d(dj&yw/7xV:rdo!" T2Ȓsӧxθ^QLLĉ)ĉ< c ,V'eFao 2eEW0Б.6XĠ_C! {~G1M,zO}E~Bl JY ]h&ؒr?3sK$y.ߺuS?-==qƌa Yl){$'OmԨ_o@ms@e޻w5$)i (֭ZۉKp!i<055v )yԯ_+&KU+SQ͛&2vO(,](Q2ЯK q"wd3 z>6w O<0}ƾ0Fxb-dj2!T=t(([2YJu&/.ԊOJE|ް60<޽츸hZ/g_wvϻݣG[dzjߠANN֬!rew:v%>>7ssHGRYX yfg|=/dM6-M *SDƂ@PckB"AE.k(lRʭ³.@ٲe\\).<<#ͦ  ͛7ܴi&}dE|73p/…c-} Z)ouc{YY E"鴂Z+wܹ%̇b\v = djFUkj|J8]H҅~ E cSuA|/6x DZHuĂOR,h߾/ءn]?Y;Ӂ,,cX s feXx,͈G&Oiٳ"RtX^^{reMi;9G˻HIV**[a!W&Sdd~ٶm E$qӲ?bb"g|J86@AB7 8ߑeP0OY..ΧOK,r}VAcp(|_C+rU)SddQ,{wܻs;I(~={v̆-=)0 nFoC& RXGڵkv",,gӧ=U;Rz6A0\ [s2q@'rĈ?ȑUjz&On@Y7P 0OĂ" XaAjoJ~I`GUQDƃnFG; dg9w^2kFtw?bB8<*0nn)-47[ZVXPU-Sk&#ы&eOB`GI,2s];mɒqlܩ4F~ -^ ]=rp/ PzBzK90,HYHNW(R$VXڛ4xÆuڃx%dtJwT/K#˘A+ ";XeA.V%S[PL}uWբbBL-LFoC6T(cb"3>%F3Ă$$J 5x)p1Y!ԯ_#==oߎ##)&gs`,HYK:z3|Фg< iEڛ4 4<"ͭbDD'EAiw^.V1esl q3>%F3IH56z)5KL|,=`/pi;Pz9Bρ],HYPtt8HOҠAwС=NRDޔdGOݻٹ Q{PyOtG; -=LNnjX!]yg|:_}\?0? Eo \N`&#֨FNBX6>srR`NNÀok?Sa4,YD!_Ca0Z5/ <! R[< Ă@rchQ  3z>ɰa=[z֭L0|D?)a;GOwH .4$ t.@qG; f,2[EIPZbAi c507**[KŪ\Ԫed)="[Mbyӹd8oo };pxK$!QP`F ދĂHs iĩ}bA౴lΝY}pxMB'dwAB}u;GCd|IC}lgt<{YY PG(;ƍՇZdZV+/SkEFV]ؿ:LVIB`4,YD!_CQ^u0yzD]x$ڛNuh9H@YL; #ق2Ló;wъE_Ca/8ewd3rj9OZF SS(c0\/(4`ai<|ڴ(뿡dD_PiäB<޽ݻ4w 5k(lKq`'^Vݎ,cdA`[LCnN; aiɀh'On2;^{FR$p?K%6n_`LQudAv H3;$ p(b1Hkĉu5GPP@NNk{bR䏎G$9yj``WcA4tO֫S7&&/ZWZִi@Jzg'$vBs+|Ƀ=e%8l]jذ6 \<\֨3{-(1//z* $ hN,<˻<BBz) ,cɂ$$ F3Mք&Dԟ\ ʕ>}hnNݺٷf[S޽{I}s?%9\gz{{|l"{m.qnwwX4 2;+=όʗwJ^T.6;ZRJSR[[׏uHIw޼QȦs=<\{oʅ #":SXp ~ R$Y IH8fS N셈,<=(1+kY`,|{o 7/X0ȏ%%Ml׮lDl%81glc/]R7Wf| G\Kc*^=gAљluҐ&)ډ߬?}BBz) ,c[Xjp&"K'!ap[2Y1IH%<<[`-ۦo:k(:5 9}}ڴ "RfAW8̔)CaŋQ2!yV&ko;;W8}:gA֟ m8q %8gAc{|}{*$u\>_C! {~G1M,z)o)Zo-&X h&ؒr?3sK$yx <O;[64jT7(}2t-^<ٰ!Ȁ^aj…*R xH|qx>Q\x(ּXiŊI|-f=0cư`(7wgٲe`?}B~⃣*;s2f(0Qicbn%[Hf;`('7޻MG[p ~ Ez)Bآww͛7d#Q»y32`1?Ɩ;FnZU~u;JtEuV^*")f- 'K7{O"G"HDDtzg)'i. Cnd8oo};$-aa;-]:%|TNOee-88R S/@V† qYb~@ 5kDG65t}|}BW٢wO,IOtĂS,h߾/ءn]KR^_#˘&rz̗w ڣG+Wv#W_hoEc>"o-X h&؊ ]Zו3w""k޻luޟ<^"W; 6)WdV;IMfhQމY]ckG>A/dz%~ٳb ԮRDz< "$$ oݺbbA׈ֱ30 SBEkWKL|>U;`d% U4i̙e<Ε/WQ%-uu; Ƃ);k az8rdFV&z^VQ*%"+!G[7Y!Hk v횝?˼};fMXٳ_6m.\(%J5x)ͭbzЬY]һW 0-ĂѸq/]v1 zm] 9_>R;`8<vT^u$H\f2J޽c)B|KiݻS]_#˘,Lvs%ӻfD 3_1&19]3UÚ[4VBB0 vxܜxE[&ܑkx7O+--hkgPXrծKQݫYSi? cm: obҩWBF=[ڰamz'iLu?N"ȷԙV;JwlE~,c,H,AA4l3֒#fIHk(lRxqW.EwfAXULR&=IHNVˆSYȑA# &V1"㣣NJ[L+;"~G1VEv~z6ʁkW.bׇ%鷖ha4,YD!_Ca߀[wRTzjN,jʔvfӠAwС=@@|]oIJ(Pѣ'On]\,]:)oKOOT%-u[_#˘A+ ";Kk10镥vB<|U8}X~kɈJHF3IH5x)gnXRz~^ ]һ'J[( <t 6mZT6AT ֳU'ܺ hG͚5CC[| J$_ѼyÅ |M*tT*RF:E(o3{w+wd3heAZdgŭV cfM|kiGoXa-+!SK$!QPCtwsIҤAqW.J -[>sEz`ApTPMznޅ2+TpB64!\.]ZyP;`_?sGX` n )j|KiݻsxE~,c#X h&X B@vq7Zq]DW("}|io0Y '=K): ^_#˘`Jegl[Dc%$t `eAw~c[ꍑ0~ ER$(}|+wd3rj9&LPFGDQ`& &_baV݅`He&+&)&G`=bx0HBЯec~/UBb v嶕2f(J$!!Q0 d'; Y$ɡCI`A׈ֱ3/>XW+|yD"|ڴiZp*bnF֮ K=Ӥ{2hЫlt7o*rqj$] k Byԃ۶W//FXY=SZ t AX=hdII,*8з];g5 k(jK1WtEڵkX=!#T|Y@zzvҾb8MR&jgE0<,)jM;Q0z( Y4,Ky#T%4dɍMP+&qW G!S,b d߿;w uEʆnӧУ|}TXZ}mw\O\w^[ZZ_9}zL($9xp%r\V|8] MPqW =-n}.zH]/) "T#8朜Ocܦ=~&X <, _ʮby}?Qg!nuE4d# +;y3|x@FF j_mf9Ґye,Ni[b-Ri&X[a ;myCWXaXOkQ|^sF!6gSQQ\Fbx)~RCC;nooW~6@mW7q?gOOFFPI׸q󱼼y sqq %D.TN=vV{3[lpd'9\oލ-Rvܱfu[8矷L^xYm+V'Z!kXi\ٱ: 0:hΝBXk"Gڵ3P[PPυ 'IsU 1d,Ni[b-Ri&XɊțL5)6 7u1Dk(IE}4͂cb^qc RkT4JZ__}- zrt渧wl͖-P\P}ՅJ (\ =kFSk`C6+T* ) 1qbM!ƽme +& iXٞ0jcqse" \no:ݳ'؂~cKsղ8!ӊ8"Lp [R%;;iE$Vk(I577NPk~|!!o " M@Fh^Hu*[TA|9`e{¨$=sDZ+๲c{yhaZ[7 GfllxXX8W!qBd^! "2*YD$e'ش%#=*ZG|-G^$Z;++.0GWsӋ *.^E*P]0Tv_h3==iXCf+!.U~\I VZ];{1cޜ5+L--I׮-YMX< EG'͑ +WW'>D%Si&ThMPTK:#?lѯ0SA9H:xq$ŏ{AZQՏ֯>}mطnݒEm{z%%L*T` 2$,KY`i,W x1,nNܐټpFF*HWO!k曽ƍZse"Z$6l#Nͼp$\0i'͑+̫k|Jk kJ3D#h^O϶o=~|YP#_ajh[o{a(#T|Y ,6'yp<5RAB%#<1s;;l,WvK!e {f YJ֪ʎuH+7$2DT &D$A5Uʝ7|p 7P}I^.˟1Wiw2QH޽rr3g #D!ezB!kJ3UAu+;C49⣌pzLTeTmBu4 *Ժ .(7)4{v/lEFhڵ1Psz L<ȑ?"~ٹy G5UK7NTAD"֩4\3&; bKMXIvphuU?1ciǐ]pxiݻN_WWG}MN{ /Xiw2A*HWT ˽M~~,SZެLKn_4Ծc*#ѡCۢlyE~\1ǏqifyxXY=ӥKoY+6֥g@qyu떬rQA`OZ۶&$|k22bO^Ѣʹ4͛|a#GҤStĆ#OҢ >ty;t y)ĺLӽ RADbL~5u"ҳglnٲYnnɓY,k;6LO.+>jۻ"UA63k޶meV h{{[$~1 un}ܯ_7SdΪ5;OHb.X0ңbn^7n`ȨMGּ⌉sZ?xp2׮ڂz.\8Is\ϼp!?4ԟ_53g 1n|y`-k(K!eL "f7ҧ̎~bMj"$pU 9y sp͚LN޽t׿"Z TAfp ZޜKو6,`ժ)ٽ{@]G[7С-qc lxziNRROgѫWԥlmYJS'75{4]CA^ .t,e**HpFA$4WHT8fu/dMtl# 6m8K83GC88x1*ǘ]RA!..jMlYڷwFCzyiyg*'䓑7nlvlω"VTmfV& 8"ϻE ww'ںIh?2cc‚nHs""KoFS7ѵ<iT.t,eJ*](a7F++rUM*(Ri&X2[7o!22YY?,T @~޽ͩTevQ lmY$7{{[; h 49y /|6{إGĆ sI?30; e;Ks[ZZ8;%Oo5ETr4CA RTIqB`x-,u*m}xV^u,U:2P 2̓'| "7~Idd( ӥҜ=&o—&FZΝe/5CZSu9"nq3VjOUQQ9YZO"F!>2dqJJka6ŕ~r>EO;p*PSA~/bS1ܹcxq?oapq* *Ɛ A^]rls|&Ϟͱٲ% TRi΍~7,$gU99JLh >}^:>^pSzE @*H+, -Hc+1XR.ikĉ!NRRXX* ipU跜5V\h$hhry@9>)*v TRiMe_a4LnUII:LYv2?"T ) UA50+wx*H ƧNe*U4l[CV+T.;++.0GWs|&bةULJsnDeRi@ 0Tv}Yk!.U[WTAjeߊ1dr1!!~C[>ZYp(m%edĐ 2]*͹!D$A @PdHYc<+%%PNeCVaDLJsnHFPi@ 0Tvj!bS'7ùG%,j6/c R~ {u}!+* ,6'yp<5RAK97D#4CA RT":2bWFH1tX@~;oއ?ثzCVO\i?#.ܐ " @ HQHA1kuQWի?D KTsSUн{nT )k6!< i46PsӠZUhN<ȑ?"#jr8JKUE @:UHu*͹k*4scgf.\8ɈJ߯ʶke "V#f(A RADbҜ*tvt{&f\T<=ݛ58З6oYG ߿Gm}_`OR^jݺ%{@ƌ7p8v6/o^xx0kM4o48>BJ99s..E @TX4Fɚs{ YH-];ƍ N*ڵMZGm5jq]wW0=LСffc *طoWglF[h4Օ+;kcc3/\ guqglْxH2RA @ HA*HWTsd>edvkR!C7Ʊjǎ*(5uZ~<}z 2.-Tk8B2PAFKAM jd;++6'@FD f! Ƹ N"D.*PURA?GڷOVgOyiB$2Yfsb c}q8DX&%%gOO>>/77.mJKձwe5oݓm/\oJlb+9@!!~C[>s NmoذWAKL/edĐ "Vf(AQA ]+K+v0 HٓhgggǏqQ\bmQi΍.f + ;˽'Ɗ^}xׯr˃BXX4TgeϞd5۷GEzźC)fY&% 1Y~? \0!vG48-ݧRAH#LTTj4##fذ̌iD qg{pD$Vf(Aʩj ШQ9sƔm?`×!beJWƊ?ի_Jܪb;wXss3\xq?oaUS\bPi "*P``RYNX2ᡖr+e,/W8 s{$ƍqZ,MArB97D#4CA RT.Rv͇^Alw煮8q۶,kJsnjQeX-w[_ޙG @*jJi3\뿝: snԔ =;ZgJt{:m81Hqa~޼Y5mj XvځoNʲmg]*{_-$:WW[,uO]EN<ȑ?j_-Dm⢀E&Ftٹ ƨ Ri@ ND$kJsnjdHد_7HfIm`OD`ë bO Ivphub'eYYlXWfҙ Nފ*L|OC޽w:^Xs+0s MRs @TX4禊&+'S//6m*2OOfͬeEC;;cfH/_cpzKpY}|:;:ڽPs?͛F]*1>~\Ϟ=a*ĉ #F81E $]CW@``$jHH@lʕ*@0ޘ"?ٿÇנM=ɞ^ B[Ylݺ%FM,ddUvszT*OJ{tGWM͑ۑ#i, Z筷5{I?D>; ;a @ "^Qi΍~5u"*#ҳglnٲYnnɓY,k;6LO.+>jۻ1̆8ztݭ[_p2\&֮qFAPPOx$ 1NWfNlRa`oo-SdΪ tQsA[ 0ט}޽0Ly&t~ʕaH ?yB~h?C! ۶m>аa(ϟK0={[޽(VG7}vAbԌ- ЪUs s.ԣU~RԚ:):}7A#;oQ]m1b~~*nmɪ 4ae 4@EEqLL8[e By 뻌֗رL+V/ko{ׯFL?Hġ%$|[lkM~dy;{6.^G z] Ġ04]T@ 0$& ]*hLnoȄ]1b]> ZB89هD!g 9yG‡nL>B ?LRA @0aRAW//L ;\Wk^^OA0T$s9ٖAZU}ZL tQQ=mwRlU.+51f ~ze/>SUe?)qN 9QP8LFRA@v@ 0 0"oݻ*''9s$&wssdau…{T!$D d  C z"/_ޱn),""$KJҋV\KXu "QED$* @0a " @ ;H LD#H*@  " "A*H4 @0aԖ 2d{ni&c "Q3*h0gСmĉ!eYYi_uYN<ȑ4!UKvҾ>bT@ $&PAu@? =rd`~n,@\1i4 RV]u)KK3G?q NJD 2Q "Qt~$DfVm>Tyz#s@w!wϝ13k2/_ޱsBNKbe T7߬EΉBC!m|ի_* ߿ǧ y#>nU>f[:|xa<1ĉ!-Zxyo[d+"d j޸1՜7/<<fy1L 0'_|!22T)T@ $& *hEc{._ƍ'6<}zӵk;HO.+>jԀɓۻ @aalC? Us[ׯ2ppG y`ط tD-[6[v:sI|o=+knϞ9\h9-{ˣFΙ3C0GC8۷+ L…|9Iٳ9vv6[$BqA1 2E "G>edvkR!C99Bv9Ӻw믅 DZXN_-/-Tk&@tZ#H)D5B+%7n{XUǎ璃~ 9Z5ti5®U5Tu䦖,6,?VRk44Y^µlII>>Y^%oԧK,@*I*@ .傐IxT"S,SQQ'#m50a$̙qphyb>}aii0"_ĬYa W//= Hj9u*[dllxXX7 B:4ٲw/a"hiUawV-QA'悃{geB>|v1=cYTPvx S$ @ ;H LTٜظqs_))/WݼYp~ю \]SSߍtiD YԤ[KƘߺuKԓ6cGW$՚^pUk%.G_5U2%%v;>/77AVm:_nǿtiZ]% |ԺUА!+VL($o~Gpܱ٩ 6&,_Ȉ!d$D d  C r=)2# /)Yv7z 薣Glzzt3 caʕ ?\\rx [Z^AUk A6o'2cbْ}ud& ~O K[w϶x6a32b 0edfx #?,bh$D d  C숼y,R65hec֏N,y=e2zy]_[7T@ $&y͛Y]A$&\w);;F @0aeD$Y "A*H4 @0a " @ ;H LD#H*@  " "ѰaPYƩ{@ jd @ @*@ @ ( @ xϑIENDB`java-design-patterns-1.16.0/caching/etc/caching.ucls000066400000000000000000000132141312550536300222640ustar00rootroot00000000000000 java-design-patterns-1.16.0/caching/etc/caching.urm.puml000066400000000000000000000067361312550536300231100ustar00rootroot00000000000000@startuml package com.iluwatar.caching { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} + useCacheAsideStategy() + useReadAndWriteThroughStrategy() + useReadThroughAndWriteAroundStrategy() + useReadThroughAndWriteBehindStrategy() } class AppManager { - cachingPolicy : CachingPolicy {static} - AppManager() + find(userId : String) : UserAccount {static} - findAside(userId : String) : UserAccount {static} + initCacheCapacity(capacity : int) {static} + initCachingPolicy(policy : CachingPolicy) {static} + initDb(useMongoDb : boolean) {static} + printCacheContent() : String {static} + save(userAccount : UserAccount) {static} - saveAside(userAccount : UserAccount) {static} } class CacheStore { - LOGGER : Logger {static} ~ cache : LruCache {static} - CacheStore() + clearCache() {static} + flushCache() {static} + get(userId : String) : UserAccount {static} + initCapacity(capacity : int) {static} + invalidate(userId : String) {static} + print() : String {static} + readThrough(userId : String) : UserAccount {static} + readThroughWithWriteBackPolicy(userId : String) : UserAccount {static} + set(userId : String, userAccount : UserAccount) {static} + writeAround(userAccount : UserAccount) {static} + writeBehind(userAccount : UserAccount) {static} + writeThrough(userAccount : UserAccount) {static} } enum CachingPolicy { + AROUND {static} + ASIDE {static} + BEHIND {static} + THROUGH {static} - policy : String + getPolicy() : String + valueOf(name : String) : CachingPolicy {static} + values() : CachingPolicy[] {static} } class DbManager { - db : MongoDatabase {static} - mongoClient : MongoClient {static} - useMongoDB : boolean {static} - virtualDB : Map {static} - DbManager() + connect() {static} + createVirtualDb() {static} + readFromDb(userId : String) : UserAccount {static} + updateDb(userAccount : UserAccount) {static} + upsertDb(userAccount : UserAccount) {static} + writeToDb(userAccount : UserAccount) {static} } class LruCache { - LOGGER : Logger {static} ~ cache : Map ~ capacity : int ~ end : Node ~ head : Node + LruCache(capacity : int) + clear() + contains(userId : String) : boolean + get(userId : String) : UserAccount + getCacheDataInListForm() : List + getLruData() : UserAccount + invalidate(userId : String) + isFull() : boolean + remove(node : Node) + set(userId : String, userAccount : UserAccount) + setCapacity(newCapacity : int) + setHead(node : Node) } ~class Node { ~ next : Node ~ previous : Node ~ userAccount : UserAccount ~ userId : String + Node(this$0 : String, userId : UserAccount) } class UserAccount { - additionalInfo : String - userId : String - userName : String + UserAccount(userId : String, userName : String, additionalInfo : String) + getAdditionalInfo() : String + getUserId() : String + getUserName() : String + setAdditionalInfo(additionalInfo : String) + setUserId(userId : String) + setUserName(userName : String) + toString() : String } } LruCache --> "-head" Node Node --+ LruCache Node --> "-previous" Node AppManager --> "-cachingPolicy" CachingPolicy Node --> "-userAccount" UserAccount CacheStore --> "-cache" LruCache @endumljava-design-patterns-1.16.0/caching/pom.xml000066400000000000000000000055551312550536300205530ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 caching junit junit test org.mongodb mongodb-driver 3.0.4 org.mongodb mongodb-driver-core 3.0.4 org.mongodb bson 3.0.4 org.apache.maven.plugins maven-surefire-plugin 2.19 false java-design-patterns-1.16.0/caching/src/000077500000000000000000000000001312550536300200135ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/main/000077500000000000000000000000001312550536300207375ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/main/java/000077500000000000000000000000001312550536300216605ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/main/java/com/000077500000000000000000000000001312550536300224365ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300242665ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/000077500000000000000000000000001312550536300256625ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/App.java000066400000000000000000000163231312550536300272520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Caching pattern describes how to avoid expensive re-acquisition of resources by not releasing * the resources immediately after their use. The resources retain their identity, are kept in some * fast-access storage, and are re-used to avoid having to acquire them again. There are four main * caching strategies/techniques in this pattern; each with their own pros and cons. They are; * write-through which writes data to the cache and DB in a single transaction, * write-around which writes data immediately into the DB instead of the cache, * write-behind which writes data into the cache initially whilst the data is only * written into the DB when the cache is full, and cache-aside which pushes the * responsibility of keeping the data synchronized in both data sources to the application itself. * The read-through strategy is also included in the mentioned four strategies -- * returns data from the cache to the caller if it exists else queries from DB and * stores it into the cache for future use. These strategies determine when the data in the cache * should be written back to the backing store (i.e. Database) and help keep both data sources * synchronized/up-to-date. This pattern can improve performance and also helps to maintain * consistency between data held in the cache and the data in the underlying data store. *

* In this example, the user account ({@link UserAccount}) entity is used as the underlying * application data. The cache itself is implemented as an internal (Java) data structure. It adopts * a Least-Recently-Used (LRU) strategy for evicting data from itself when its full. The four * strategies are individually tested. The testing of the cache is restricted towards saving and * querying of user accounts from the underlying data store ( {@link DbManager}). The main class ( * {@link App} is not aware of the underlying mechanics of the application (i.e. save and query) and * whether the data is coming from the cache or the DB (i.e. separation of concern). The AppManager * ({@link AppManager}) handles the transaction of data to-and-from the underlying data store * (depending on the preferred caching policy/strategy). * * App --> AppManager --> CacheStore/LRUCache/CachingPolicy --> DBManager *

* * @see CacheStore * @See LRUCache * @see CachingPolicy * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { AppManager.initDb(false); // VirtualDB (instead of MongoDB) was used in running the JUnit tests // and the App class to avoid Maven compilation errors. Set flag to // true to run the tests with MongoDB (provided that MongoDB is // installed and socket connection is open). AppManager.initCacheCapacity(3); App app = new App(); app.useReadAndWriteThroughStrategy(); app.useReadThroughAndWriteAroundStrategy(); app.useReadThroughAndWriteBehindStrategy(); app.useCacheAsideStategy(); } /** * Read-through and write-through */ public void useReadAndWriteThroughStrategy() { LOGGER.info("# CachingPolicy.THROUGH"); AppManager.initCachingPolicy(CachingPolicy.THROUGH); UserAccount userAccount1 = new UserAccount("001", "John", "He is a boy."); AppManager.save(userAccount1); LOGGER.info(AppManager.printCacheContent()); AppManager.find("001"); AppManager.find("001"); } /** * Read-through and write-around */ public void useReadThroughAndWriteAroundStrategy() { LOGGER.info("# CachingPolicy.AROUND"); AppManager.initCachingPolicy(CachingPolicy.AROUND); UserAccount userAccount2 = new UserAccount("002", "Jane", "She is a girl."); AppManager.save(userAccount2); LOGGER.info(AppManager.printCacheContent()); AppManager.find("002"); LOGGER.info(AppManager.printCacheContent()); userAccount2 = AppManager.find("002"); userAccount2.setUserName("Jane G."); AppManager.save(userAccount2); LOGGER.info(AppManager.printCacheContent()); AppManager.find("002"); LOGGER.info(AppManager.printCacheContent()); AppManager.find("002"); } /** * Read-through and write-behind */ public void useReadThroughAndWriteBehindStrategy() { LOGGER.info("# CachingPolicy.BEHIND"); AppManager.initCachingPolicy(CachingPolicy.BEHIND); UserAccount userAccount3 = new UserAccount("003", "Adam", "He likes food."); UserAccount userAccount4 = new UserAccount("004", "Rita", "She hates cats."); UserAccount userAccount5 = new UserAccount("005", "Isaac", "He is allergic to mustard."); AppManager.save(userAccount3); AppManager.save(userAccount4); AppManager.save(userAccount5); LOGGER.info(AppManager.printCacheContent()); AppManager.find("003"); LOGGER.info(AppManager.printCacheContent()); UserAccount userAccount6 = new UserAccount("006", "Yasha", "She is an only child."); AppManager.save(userAccount6); LOGGER.info(AppManager.printCacheContent()); AppManager.find("004"); LOGGER.info(AppManager.printCacheContent()); } /** * Cache-Aside */ public void useCacheAsideStategy() { LOGGER.info("# CachingPolicy.ASIDE"); AppManager.initCachingPolicy(CachingPolicy.ASIDE); LOGGER.info(AppManager.printCacheContent()); UserAccount userAccount3 = new UserAccount("003", "Adam", "He likes food."); UserAccount userAccount4 = new UserAccount("004", "Rita", "She hates cats."); UserAccount userAccount5 = new UserAccount("005", "Isaac", "He is allergic to mustard."); AppManager.save(userAccount3); AppManager.save(userAccount4); AppManager.save(userAccount5); LOGGER.info(AppManager.printCacheContent()); AppManager.find("003"); LOGGER.info(AppManager.printCacheContent()); AppManager.find("004"); LOGGER.info(AppManager.printCacheContent()); } } java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/AppManager.java000066400000000000000000000102021312550536300305330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import java.text.ParseException; /** * * 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. * */ public final class AppManager { private static CachingPolicy cachingPolicy; private AppManager() { } /** * * Developer/Tester is able to choose whether the application should use MongoDB as its underlying * data storage or a simple Java data structure to (temporarily) store the data/objects during * runtime. */ public static void initDb(boolean useMongoDb) { if (useMongoDb) { try { DbManager.connect(); } catch (ParseException e) { e.printStackTrace(); } } else { DbManager.createVirtualDb(); } } /** * Initialize caching policy */ public static void initCachingPolicy(CachingPolicy policy) { cachingPolicy = policy; if (cachingPolicy == CachingPolicy.BEHIND) { Runtime.getRuntime().addShutdownHook(new Thread(CacheStore::flushCache)); } CacheStore.clearCache(); } public static void initCacheCapacity(int capacity) { CacheStore.initCapacity(capacity); } /** * Find user account */ public static UserAccount find(String userId) { if (cachingPolicy == CachingPolicy.THROUGH || cachingPolicy == CachingPolicy.AROUND) { return CacheStore.readThrough(userId); } else if (cachingPolicy == CachingPolicy.BEHIND) { return CacheStore.readThroughWithWriteBackPolicy(userId); } else if (cachingPolicy == CachingPolicy.ASIDE) { return findAside(userId); } return null; } /** * Save user account */ public static void save(UserAccount userAccount) { if (cachingPolicy == CachingPolicy.THROUGH) { CacheStore.writeThrough(userAccount); } else if (cachingPolicy == CachingPolicy.AROUND) { CacheStore.writeAround(userAccount); } else if (cachingPolicy == CachingPolicy.BEHIND) { CacheStore.writeBehind(userAccount); } else if (cachingPolicy == CachingPolicy.ASIDE) { saveAside(userAccount); } } public static String printCacheContent() { return CacheStore.print(); } /** * Cache-Aside save user account helper */ private static void saveAside(UserAccount userAccount) { DbManager.updateDb(userAccount); CacheStore.invalidate(userAccount.getUserId()); } /** * Cache-Aside find user account helper */ private static UserAccount findAside(String userId) { UserAccount userAccount = CacheStore.get(userId); if (userAccount != null) { return userAccount; } userAccount = DbManager.readFromDb(userId); if (userAccount != null) { CacheStore.set(userId, userAccount); } return userAccount; } } java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/CacheStore.java000066400000000000000000000120711312550536300305460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.List; /** * * The caching strategies are implemented in this class. * */ public class CacheStore { private static final Logger LOGGER = LoggerFactory.getLogger(CacheStore.class); static LruCache cache; private CacheStore() { } /** * Init cache capacity */ public static void initCapacity(int capacity) { if (cache == null) { cache = new LruCache(capacity); } else { cache.setCapacity(capacity); } } /** * Get user account using read-through cache */ public static UserAccount readThrough(String userId) { if (cache.contains(userId)) { LOGGER.info("# Cache Hit!"); return cache.get(userId); } LOGGER.info("# Cache Miss!"); UserAccount userAccount = DbManager.readFromDb(userId); cache.set(userId, userAccount); return userAccount; } /** * Get user account using write-through cache */ public static void writeThrough(UserAccount userAccount) { if (cache.contains(userAccount.getUserId())) { DbManager.updateDb(userAccount); } else { DbManager.writeToDb(userAccount); } cache.set(userAccount.getUserId(), userAccount); } /** * Get user account using write-around cache */ public static void writeAround(UserAccount userAccount) { if (cache.contains(userAccount.getUserId())) { DbManager.updateDb(userAccount); cache.invalidate(userAccount.getUserId()); // Cache data has been updated -- remove older // version from cache. } else { DbManager.writeToDb(userAccount); } } /** * Get user account using read-through cache with write-back policy */ public static UserAccount readThroughWithWriteBackPolicy(String userId) { if (cache.contains(userId)) { LOGGER.info("# Cache Hit!"); return cache.get(userId); } LOGGER.info("# Cache Miss!"); UserAccount userAccount = DbManager.readFromDb(userId); if (cache.isFull()) { LOGGER.info("# Cache is FULL! Writing LRU data to DB..."); UserAccount toBeWrittenToDb = cache.getLruData(); DbManager.upsertDb(toBeWrittenToDb); } cache.set(userId, userAccount); return userAccount; } /** * Set user account */ public static void writeBehind(UserAccount userAccount) { if (cache.isFull() && !cache.contains(userAccount.getUserId())) { LOGGER.info("# Cache is FULL! Writing LRU data to DB..."); UserAccount toBeWrittenToDb = cache.getLruData(); DbManager.upsertDb(toBeWrittenToDb); } cache.set(userAccount.getUserId(), userAccount); } /** * Clears cache */ public static void clearCache() { if (cache != null) { cache.clear(); } } /** * Writes remaining content in the cache into the DB. */ public static void flushCache() { LOGGER.info("# flushCache..."); if (null == cache) { return; } List listOfUserAccounts = cache.getCacheDataInListForm(); for (UserAccount userAccount : listOfUserAccounts) { DbManager.upsertDb(userAccount); } } /** * Print user accounts */ public static String print() { List listOfUserAccounts = cache.getCacheDataInListForm(); StringBuilder sb = new StringBuilder(); sb.append("\n--CACHE CONTENT--\n"); for (UserAccount userAccount : listOfUserAccounts) { sb.append(userAccount.toString() + "\n"); } sb.append("----\n"); return sb.toString(); } /** * Delegate to backing cache store */ public static UserAccount get(String userId) { return cache.get(userId); } /** * Delegate to backing cache store */ public static void set(String userId, UserAccount userAccount) { cache.set(userId, userAccount); } /** * Delegate to backing cache store */ public static void invalidate(String userId) { cache.invalidate(userId); } } java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java000066400000000000000000000027671312550536300312550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; /** * * Enum class containing the four caching strategies implemented in the pattern. * */ public enum CachingPolicy { THROUGH("through"), AROUND("around"), BEHIND("behind"), ASIDE("aside"); private String policy; private CachingPolicy(String policy) { this.policy = policy; } public String getPolicy() { return policy; } } java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/DbManager.java000066400000000000000000000116541312550536300303540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import java.text.ParseException; import java.util.HashMap; import java.util.Map; import org.bson.Document; import com.mongodb.MongoClient; import com.mongodb.client.FindIterable; import com.mongodb.client.MongoDatabase; import com.mongodb.client.model.UpdateOptions; /** * *

DBManager handles the communication with the underlying data store i.e. Database. It contains the * implemented methods for querying, inserting, and updating data. MongoDB was used as the database * for the application.

* *

Developer/Tester is able to choose whether the application should use MongoDB as its underlying * data storage (connect()) or a simple Java data structure to (temporarily) store the data/objects * during runtime (createVirtualDB()).

* */ public final class DbManager { private static MongoClient mongoClient; private static MongoDatabase db; private static boolean useMongoDB; private static Map virtualDB; private DbManager() { } /** * Create DB */ public static void createVirtualDb() { useMongoDB = false; virtualDB = new HashMap<>(); } /** * Connect to DB */ public static void connect() throws ParseException { useMongoDB = true; mongoClient = new MongoClient(); db = mongoClient.getDatabase("test"); } /** * Read user account from DB */ public static UserAccount readFromDb(String userId) { if (!useMongoDB) { if (virtualDB.containsKey(userId)) { return virtualDB.get(userId); } return null; } if (db == null) { try { connect(); } catch (ParseException e) { e.printStackTrace(); } } FindIterable iterable = db.getCollection("user_accounts").find(new Document("userID", userId)); if (iterable == null) { return null; } Document doc = iterable.first(); return new UserAccount(userId, doc.getString("userName"), doc.getString("additionalInfo")); } /** * Write user account to DB */ public static void writeToDb(UserAccount userAccount) { if (!useMongoDB) { virtualDB.put(userAccount.getUserId(), userAccount); return; } if (db == null) { try { connect(); } catch (ParseException e) { e.printStackTrace(); } } db.getCollection("user_accounts").insertOne( new Document("userID", userAccount.getUserId()).append("userName", userAccount.getUserName()).append("additionalInfo", userAccount.getAdditionalInfo())); } /** * Update DB */ public static void updateDb(UserAccount userAccount) { if (!useMongoDB) { virtualDB.put(userAccount.getUserId(), userAccount); return; } if (db == null) { try { connect(); } catch (ParseException e) { e.printStackTrace(); } } db.getCollection("user_accounts").updateOne( new Document("userID", userAccount.getUserId()), new Document("$set", new Document("userName", userAccount.getUserName()).append( "additionalInfo", userAccount.getAdditionalInfo()))); } /** * * Insert data into DB if it does not exist. Else, update it. */ public static void upsertDb(UserAccount userAccount) { if (!useMongoDB) { virtualDB.put(userAccount.getUserId(), userAccount); return; } if (db == null) { try { connect(); } catch (ParseException e) { e.printStackTrace(); } } db.getCollection("user_accounts").updateOne( new Document("userID", userAccount.getUserId()), new Document("$set", new Document("userID", userAccount.getUserId()).append("userName", userAccount.getUserName()).append("additionalInfo", userAccount.getAdditionalInfo())), new UpdateOptions().upsert(true)); } } java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/LruCache.java000066400000000000000000000116211312550536300302140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; /** * * Data structure/implementation of the application's cache. The data structure consists of a hash * table attached with a doubly linked-list. The linked-list helps in capturing and maintaining the * LRU data in the cache. When a 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. * */ public class LruCache { private static final Logger LOGGER = LoggerFactory.getLogger(LruCache.class); class Node { String userId; UserAccount userAccount; Node previous; Node next; public Node(String userId, UserAccount userAccount) { this.userId = userId; this.userAccount = userAccount; } } int capacity; Map cache = new HashMap<>(); Node head; Node end; public LruCache(int capacity) { this.capacity = capacity; } /** * Get user account */ public UserAccount get(String userId) { if (cache.containsKey(userId)) { Node node = cache.get(userId); remove(node); setHead(node); return node.userAccount; } return null; } /** * Remove node from linked list. */ public void remove(Node node) { if (node.previous != null) { node.previous.next = node.next; } else { head = node.next; } if (node.next != null) { node.next.previous = node.previous; } else { end = node.previous; } } /** * Move node to the front of the list. */ public void setHead(Node node) { node.next = head; node.previous = null; if (head != null) { head.previous = node; } head = node; if (end == null) { end = head; } } /** * Set user account */ public void set(String userId, UserAccount userAccount) { if (cache.containsKey(userId)) { Node old = cache.get(userId); old.userAccount = userAccount; remove(old); setHead(old); } else { Node newNode = new Node(userId, userAccount); if (cache.size() >= capacity) { LOGGER.info("# Cache is FULL! Removing {} from cache...", end.userId); cache.remove(end.userId); // remove LRU data from cache. remove(end); setHead(newNode); } else { setHead(newNode); } cache.put(userId, newNode); } } public boolean contains(String userId) { return cache.containsKey(userId); } /** * Invalidate cache for user */ public void invalidate(String userId) { Node toBeRemoved = cache.remove(userId); if (toBeRemoved != null) { LOGGER.info("# {} has been updated! Removing older version from cache...", userId); remove(toBeRemoved); } } public boolean isFull() { return cache.size() >= capacity; } public UserAccount getLruData() { return end.userAccount; } /** * Clear cache */ public void clear() { head = null; end = null; cache.clear(); } /** * Returns cache data in list form. */ public List getCacheDataInListForm() { List listOfCacheData = new ArrayList<>(); Node temp = head; while (temp != null) { listOfCacheData.add(temp.userAccount); temp = temp.next; } return listOfCacheData; } /** * Set cache capacity */ public void setCapacity(int newCapacity) { if (capacity > newCapacity) { clear(); // Behavior can be modified to accommodate for decrease in cache size. For now, we'll // just clear the cache. } else { this.capacity = newCapacity; } } } java-design-patterns-1.16.0/caching/src/main/java/com/iluwatar/caching/UserAccount.java000066400000000000000000000041071312550536300307620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; /** * Entity class (stored in cache and DB) used in the application. */ public class UserAccount { private String userId; private String userName; private String additionalInfo; /** * Constructor */ public UserAccount(String userId, String userName, String additionalInfo) { this.userId = userId; this.userName = userName; this.additionalInfo = additionalInfo; } public String getUserId() { return userId; } public void setUserId(String userId) { this.userId = userId; } public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public String getAdditionalInfo() { return additionalInfo; } public void setAdditionalInfo(String additionalInfo) { this.additionalInfo = additionalInfo; } @Override public String toString() { return userId + ", " + userName + ", " + additionalInfo; } } java-design-patterns-1.16.0/caching/src/test/000077500000000000000000000000001312550536300207725ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/test/java/000077500000000000000000000000001312550536300217135ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/test/java/com/000077500000000000000000000000001312550536300224715ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243215ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/test/java/com/iluwatar/caching/000077500000000000000000000000001312550536300257155ustar00rootroot00000000000000java-design-patterns-1.16.0/caching/src/test/java/com/iluwatar/caching/AppTest.java000066400000000000000000000026031312550536300301410ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import org.junit.Test; import java.io.IOException; /** * Tests that Caching example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/caching/src/test/java/com/iluwatar/caching/CachingTest.java000066400000000000000000000043431312550536300307600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.caching; import org.junit.Before; import org.junit.Test; /** * * Application test * */ public class CachingTest { App app; /** * Setup of application test includes: initializing DB connection and cache size/capacity. */ @Before public void setUp() { AppManager.initDb(false); // VirtualDB (instead of MongoDB) was used in running the JUnit tests // to avoid Maven compilation errors. Set flag to true to run the // tests with MongoDB (provided that MongoDB is installed and socket // connection is open). AppManager.initCacheCapacity(3); app = new App(); } @Test public void testReadAndWriteThroughStrategy() { app.useReadAndWriteThroughStrategy(); } @Test public void testReadThroughAndWriteAroundStrategy() { app.useReadThroughAndWriteAroundStrategy(); } @Test public void testReadThroughAndWriteBehindStrategy() { app.useReadThroughAndWriteBehindStrategy(); } @Test public void testCacheAsideStrategy() { app.useCacheAsideStategy(); } } java-design-patterns-1.16.0/callback/000077500000000000000000000000001312550536300173645ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/README.md000066400000000000000000000016541312550536300206510ustar00rootroot00000000000000--- layout: pattern title: Callback folder: callback permalink: /patterns/callback/ pumlid: FSVB4S8m30N0Lg20M7UwUL4qYOciUFGXxSE9s-wp6sjjKgwF8tF6YyXnjxtdKMk5E5-MOjdu6jIrRYIStlXWsIJwRij4fhW53SGFn51TmIT9yZ-jVBHPGxy0 categories: Other tags: - Java - Difficulty-Beginner - Functional - Idiom --- ## Intent Callback is a piece of executable code that is passed as an argument to other code, which is expected to call back (execute) the argument at some convenient time. ![alt text](./etc/callback.png "Callback") ## Applicability Use the Callback pattern when * when some arbitrary synchronous or asynchronous action must be performed after execution of some defined activity. ## Real world examples * [CyclicBarrier](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CyclicBarrier.html#CyclicBarrier%28int,%20java.lang.Runnable%29) constructor can accept callback that will be triggered every time when barrier is tripped. java-design-patterns-1.16.0/callback/etc/000077500000000000000000000000001312550536300201375ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/etc/callback.png000066400000000000000000000206011312550536300224000ustar00rootroot00000000000000PNG  IHDRQr!HIDATxmUŹw /MڦiR!&H[Bx@R r(T(]@H+4kԞ6//|w33Z^?ON֙=kk7okY.AuR/APT/%ϟTĝe." hKtaśg%n 60_- W<,o20 a~zT2N˟lOz~Ԏ$H/48]kXО.?p#IXagʼw[ e__L-` ϖ0_R9*t=}^i3c~-!b%}-G@5 1ڑ2;JqíEf/$ȥJ)|!5|I6O^|KbsWŤ/AqL*{FQ;q PiQ5UVrE(5IL.l 3_rbil}"M=Ԟ!9~*B8|jqWM $Mzr(),la45ϏAe"$l"ڠk [iY(m{j%m3 VoǶ3ޘzc"5Qdwyѥ-Sν3}`I^SAMYoߪGwwk_WdsG|*Cu*K;l`5xrݪ>t৽uݤyv}IE+]p"kOuF6ga[r{%Nw%L ز-vv'g>Pi]-}k_{5M_&mKXzډAi6WqUK'VD)Ha>ӔʦtwlAr /v ojC"TXf,Ejպ +yц.}vO<$,d7qKK( I Кh5(uz̥yپudFk>/μw?vky壕5'G>75dad'GV/{ft鑑{*ĉ"DG& Ҙ'/ v>}x׏χOE,5d\5J}?Fg!GOOKSR'羽1)oOPg xq5/~GNmƮR~2'Uf|$CQ^ەKxϯt;59_YxPRierY]Uѭ݌ >#7?}؋EeL$j[:ɳ:CR3< S_0Ϛߺ͢C_z>2f8r2܊c믷|kstG/`%?<,+yXOayyXe`jm`ZayyXe`jYg_@d֌Wkee0<6q)(yX<ؚf^3oBwF-hwuc~w+'dKR1!ᖺ}v"[ZR4\qy 22<.(c;#k-9L[\n>@Jrŭ.ӉLyPl%ayHn`yqqy<3)Z> =]f.~=iJi@EbɛvBYS # `^H?vdZ» '1o] ءeC=W*x e<< Ki[oƵiZbO|"=lLܫ-*2yuL{#>Į/%j]ze$˞:z#sA`bs`Uco e#?SKu8̧|'9$O_ܙf#a6yX ayyXe`jm`Zay͞9sj@Y0̣ܔ%3S5j  W<,o20|lc. sx`y[|=,g20|X-?З^vX1eE2w8(Ê10_-+yrj?VjY{~{tewF:\kn2oه"»>q5iK~l&f78̭ԝ[~o_?Gy\Ĺ+y%)yiOXq;YXaMz>C T(/3_/E Ya^_p GNAla[og)7,zaO-"aSho?zmlߵ'v7Ld<T5^vҭ73gNzߞ/"+";gc^k8+|(v-k{j&dzHUX}̚bj0|QNbk3ɉ/ utV30Oym/erf'1`5YWtRP%EN3;zR Q d/]/i>^0,E| ]d$̻&$e5ܥ-0[׊gz`1B"l7ٜD_m)WO!.C$̻&bZ ӸʼWT([tcZH]hoNu1>.;|&?9{iLsM5>aa8w S|ߝĀydb>'Nhk'[na՝?6i>~]SfÎ}`w36zC-̻&;󱟜nҼw%4ȑJ!7[m`5Y~rD.ϸ(C*tũ Y.VҞyxKe28&u.'IѝQJPV'!~&u=Zm! mLJu O~,⋒O-={3wS&3ɑd$Mf\M!{N =)/ၲ_q#_lS|&?9t{ٖ]'-s2V篨 ws6Ῥ{,3wM&31= $h,TӲOErj Q O.IM ̻&^<ʣq6L:gKW)Mq.kAqbSG.ONN|-hx~-R!%dF@o/:4)e`AٙcJwMN0ɗ}\20`>r\ ̻&Gf`5yk0y4gU6"%$.-`rPͻrJߢk:uh:T<䚆FFF-ZT<>ùs犎>?e* CNi߾}{8xW_S/\ D#/N!w[o]}bHt:ƍo{СO5!w4wܿoW\3g+#:uTTE;<䈆=<+ A"0.9rSw?xo=}u>FV8ڷ7J̛8D7ɱ5NWlOõ+.WE}Cw޻to|~ׅk'nnے;^;q|2VWPqUmN造!I$S'9'㑨 FӃN/q_z?|f&)H.30orzַg>_^\~y>[zpjދGuCħҼ73c>[>B`/LٜBP(WP+&^sͦŋmw6ӻ_q|ہ~T|ʡ%KSlr¼,2Ù/~00`?o哫W<1+E|`;S>ó: {~9bUNO@qzP9]5v}'ww Xou{ь/|/9k ̃y^(20#0z ̃y^`<%0z)_7C[S~N7OĎո`*G`C|EYXN=NW{t(1y*xi;}#Z?CízG],a){.sy kk=ތ[ҴD{.ݙxJ8 aJ%ȝ&6m`*Gf>zDq_5c9Oو:BgӁ+N09Y1}&K1j|wPegS{>>q5.3gvt;hK`rNoz7q %% Rv!q!y,.| java-design-patterns-1.16.0/callback/etc/callback.urm.puml000066400000000000000000000010241312550536300233710ustar00rootroot00000000000000@startuml package com.iluwatar.callback { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } interface Callback { + call() {abstract} } class LambdasApp { - LOGGER : Logger {static} + LambdasApp() + main(args : String[]) {static} } class SimpleTask { - LOGGER : Logger {static} + SimpleTask() + execute() } abstract class Task { + Task() + execute() {abstract} + executeWith(callback : Callback) } } SimpleTask --|> Task @endumljava-design-patterns-1.16.0/callback/pom.xml000066400000000000000000000033611312550536300207040ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 callback junit junit test java-design-patterns-1.16.0/callback/src/000077500000000000000000000000001312550536300201535ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/main/000077500000000000000000000000001312550536300210775ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/main/java/000077500000000000000000000000001312550536300220205ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/main/java/com/000077500000000000000000000000001312550536300225765ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300244265ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/callback/000077500000000000000000000000001312550536300261625ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/callback/App.java000066400000000000000000000034571312550536300275560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Callback pattern is more native for functional languages where functions are treated as * first-class citizens. Prior to Java 8 callbacks can be simulated using simple (alike command) * interfaces. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) { Task task = new SimpleTask(); Callback callback = new Callback() { @Override public void call() { LOGGER.info("I'm done now."); } }; task.executeWith(callback); } } java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/callback/Callback.java000066400000000000000000000023551312550536300305260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; /** * * Callback interface * */ public interface Callback { void call(); } java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/callback/LambdasApp.java000066400000000000000000000032261312550536300310340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * This example generates the exact same output as {@link App} however the callback has been * defined as a Lambdas expression. * */ public class LambdasApp { private static final Logger LOGGER = LoggerFactory.getLogger(LambdasApp.class); /** * Program entry point */ public static void main(String[] args) { Task task = new SimpleTask(); Callback c = () -> LOGGER.info("I'm done now."); task.executeWith(c); } } java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/callback/SimpleTask.java000066400000000000000000000030251312550536300311010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Implementation of task that need to be executed * */ public class SimpleTask extends Task { private static final Logger LOGGER = LoggerFactory.getLogger(SimpleTask.class); @Override public void execute() { LOGGER.info("Perform some important activity and after call the callback method."); } } java-design-patterns-1.16.0/callback/src/main/java/com/iluwatar/callback/Task.java000066400000000000000000000027111312550536300277300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; /** * * Template-method class for callback hook execution * */ public abstract class Task { /** * Execute with callback */ public final void executeWith(Callback callback) { execute(); if (callback != null) { callback.call(); } } public abstract void execute(); } java-design-patterns-1.16.0/callback/src/test/000077500000000000000000000000001312550536300211325ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/test/java/000077500000000000000000000000001312550536300220535ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/test/java/com/000077500000000000000000000000001312550536300226315ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300244615ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/test/java/com/iluwatar/callback/000077500000000000000000000000001312550536300262155ustar00rootroot00000000000000java-design-patterns-1.16.0/callback/src/test/java/com/iluwatar/callback/AppTest.java000066400000000000000000000026051312550536300304430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; import org.junit.Test; import java.io.IOException; /** * Tests that Callback example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/callback/src/test/java/com/iluwatar/callback/CallbackTest.java000066400000000000000000000046501312550536300314210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.callback; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Add a field as a counter. Every time the callback method is called increment this field. Unit * test checks that the field is being incremented. * * Could be done with mock objects as well where the call method call is verified. */ public class CallbackTest { private Integer callingCount = 0; @Test public void test() { Callback callback = new Callback() { @Override public void call() { callingCount++; } }; Task task = new SimpleTask(); assertEquals("Initial calling count of 0", new Integer(0), callingCount); task.executeWith(callback); assertEquals("Callback called once", new Integer(1), callingCount); task.executeWith(callback); assertEquals("Callback called twice", new Integer(2), callingCount); } @Test public void testWithLambdasExample() { Callback callback = () -> callingCount++; Task task = new SimpleTask(); assertEquals("Initial calling count of 0", new Integer(0), callingCount); task.executeWith(callback); assertEquals("Callback called once", new Integer(1), callingCount); task.executeWith(callback); assertEquals("Callback called twice", new Integer(2), callingCount); } } java-design-patterns-1.16.0/chain/000077500000000000000000000000001312550536300167125ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/README.md000066400000000000000000000030461312550536300201740ustar00rootroot00000000000000--- layout: pattern title: Chain of responsibility folder: chain permalink: /patterns/chain/ pumlid: 9SR13SCm20NGLTe1OkxTXX0KKzd4Wa-pVYlrdTxJN4OTMZ4U7LZv8Wg-ssdejLTgoELGHvDhaesw6HpqvWzlXwQTlYq6D3nfSlv2qjcS5F9VgvXjrHnV categories: Behavioral tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Intent Avoid coupling the sender of a request to its receiver by giving more than one object a chance to handle the request. Chain the receiving objects and pass the request along the chain until an object handles it. ![alt text](./etc/chain_1.png "Chain of Responsibility") ## Applicability Use Chain of Responsibility when * more than one object may handle a request, and the handler isn't known a priori. The handler should be ascertained automatically * you want to issue a request to one of several objects without specifying the receiver explicitly * the set of objects that can handle a request should be specified dynamically ## Real world examples * [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) * [Apache Commons Chain](https://commons.apache.org/proper/commons-chain/index.html) * [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-) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/chain/etc/000077500000000000000000000000001312550536300174655ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/etc/chain.png000066400000000000000000000745341312550536300212720ustar00rootroot00000000000000PNG  IHDR-ey#IDATxmy.xJ A*J2qeGD|,0c-d*(jJdj#)S&- #l9_ P+ga' X, qd %9[?s=}] @e@P (=0P0v/`Chauhm p(0m1l2--&- Pe%¡DŰ:P86P@ܚi6;飵D[h N#m1l2zl7 M?"F[h N#m1l2EV'cb濧މXml_@KPp2 +^jq'~>6lO!lSJ#]x7}"y'WHr0H%ҡu [  @92,QEI?M/m]%|i ();Lȝ{iK-C)"O[ * t͕͒t/l/l^#;cA2ŵ۩!~[iK-C)/6PTNt=Oޓ4|n1NL1Hh@Pp**AGv0*KmwZ{7jHg'D!HﴶKu@KPp:- V.ðPkue:-.:ÝVS] Zau%3#ci0AhK-C)H[ * o?vl/r1E4I]4]K@-v(8EŰ:P86P@і (2@P`"b@eZF[( LD[  @hKChauhm p(0m1l2--&- Ug}anglO#iKѡꀚ*`o=xv%۾an/ 'f硬G[u)<:Ą͝?E[  X{#}ow~y>#/f V7)`/F=*݋oW {IZPUDӰ{aʠTȡ:N0X 18.E3Xib@P;ex3+_q&[[ e~k驵EfUz'^} H!?2|JV%ZP)8EW /MJM|ǁ"8J| Ӿ[ j n9ym?W%'?x]WS݌?}K㧏n3( ~G  :ʠȡ9k٫ h@nuPfm1l2anrb?|]}m0zӱ0a?v*/GI.I~20d栍M(,rdN= -mu~ZTK&3n~) yx_{_kcJPh'9RO 6q{("J 6&F!. o0ktq7GM޾WƮΟ|Bm_So[~z!/" z)T%Ub, jI3 |U9)ظ>tg~'? .?~r!RԼ)DC'C"ݷ+7~%ZP "η z  :#ZCo)o[n&5/CGد\bh@I!ќ,<#K*S\1qdtx@'.m1l2:qrrC/f{hj1lrnU#5_@ɐ N Ba%ZP£qD!ET&@2:-]{'YOo_*'m 6:TNcʕ6PWN(thKCJuF2I[  r#A:%¡4Ƕ176P@і (2@P`"b@eZF[( LD[  @hKChauhm p(0m1l2--&- P{F!ݒЪ9"cb@e`A%V֡(`ti>v~rvsO=N#>x۽Iő<)V.ȿ:{㭦4x]Ω[-@]nAɛ3mkiK-C)lr [  xǠNmATrÐ;a5m#V(]Z&XR_lgI Ru9ifb1m E;2Ű:ʀhN #ף /RRoA}p |jaR)b1nDUr>2@ v(8!R:- UQ=LiA/8BS&œ늙[) % V9- UQ9՞i/FK'ջFOïb}n ЖZ2Sr+Sb@P e {K ȥq:PP R;Vt U 8m E;2Ű:Ra؆ h|pcfZj1 1A3KCJ'ðՈ7AhK-C)lr [ * Ж (2@P`"b@eZF[( LD[  @hKChauhm p(0m1l2--&- -P tC`au @ذ &- Pe%¡DŰ:P86P@і (2@1H@(26,Qp(0m1l2-&[m6[-|xvrіjCi):I[i-> - UUy'M2v/ʠHPwk37sMw,6PU*9xU݁4ϰVPSjzN5uYj bpJiu҅cs/e_"E6N8\hauhm fcWlCR@W?lO[`t$bm1l2--~ 3ȁ6PsPz0C-aa2ЎNeh3--RҍN M@A6Ű:P86P@і  D[(6P EcA0@ DŰ:eeRS-LD[ RRRe?M]LoFR{tvHdі:2= 9sQHqV"'b o s!U- )&P3= 41KPx]]iqS:KQ@sRUFv@@~ r'se]ub5*2ެm+[ePh;e,n"<[hɔB\df9U"X`sd~z|rB"\"I=䲧 nOb{Z62Yeo`#]Cg*,oG <3u_S .hW}ýH5weĔM-1SW=dwrŖ 20 .mGL @|dq{4By"> ~ `@  }tc;?{,ػ4vjKk~T"/H6fz /Y*oP7Sf`ꀸ_-w1EA$ j)EKCn yqLKxP.V Zl4 UHx<:]sFAlH8cوmko"`R;UiOHt$c\r΀o}:J]Hiau@ZSdeKsl+}곋iK-Ρ cT6PTVȯ&*`bjg:Ev`2r +T rQ^f`1Er?"o@k `6PA`@P`"b@eZF[( LD[  @hKChauhm p(0m1l2--&- *yu|~dH)2.1F&dA[h ,es=2Ke*ɏg,a6P [k}\Pyd7:ԗxcge{&N!Yt3!cP$գ mʠ6 '"1x3u*R7RAG{]dWu5~۹׎BP!xs[k± &bADs4~|!1/w(ʧV*]BЕj1v8ûܗ,G0 7x}(30CE)qElyAt[V+[ٴ~D 8}s?btNy4 oFNg<_9.: 3'>%#@131Y85~t)gnR")|* zej5< yTT bpٺ{{ ki5L'Ĺզ~,jf)eYБd PUB\__/V_~O\fwWf=~~m]`;u[߲U4wABF Pf j30$7-J$j3pviwhfPXXX.5=>u҅cs/e_9 VHbg:K*]N-T_-Pg`xGwH;u߿?a=M]Y$g}(qK_-w1EA6A0o +tS ʹSpRy] ڊ֩P[~L'X+t'ؐ5g16 PM|/!xPuXѥ@#gH헐"qH~ N3::Zt)ePKS${2666FFF. *x 57B@ZCT W\*W5%Ak׮K(2BT xP6@IŰcǎW] B@ʠbrJѥ h *͢K@B2f5 0OBȵ )ʠbt:E+:yօbMDB2 &I(l] BUGO#*2THAZ rބt eP1LLL] BR֋o>).3>Z |j뺿38VjPK ^߹.o9DweᶟU@=q@Y_70arrriiR"Z~S_>svU9U ^CKw85տb&}#  tub4:70⨃K@hep#͹ s=vٿlLh'_^ PbA]-5v=C<#@PW&@F,,,LOO] BD+kOs8<N>WW)kQ:E_^^7A#+l͘.R*Iﵞk!tlY 3rVb/ ChWMO[XʠXXX.xV_~O\f׻1&W͸;#{:\fΐ<*&+6o!wtTKUx@BR@KFB+++EGs/{̳NE+**.>ymх4TtM ޭ3KHTb}í"_ބ`uuullR!Z\{g{v*)evA*[FWBM,ʌ<#_Ub5o*;V_.ʠ.t:EG.<ϲKl'ث<4 R;F',1]ˋ)=펿 ###EF ܾ֧Zpll+"WaZ-r׻3Be)V?TZm~D=3DQ W\*x}sZdtowІ77.O=o}1\;($WMeU\OfXmK~.mB;W j]v] <;;4 gSsտش3 ePI@ye`\^__+}iρHUH%cǎW] z20kٖdNG'dH(Jbhhʕ+EU`M ePI onn] z2-#A%1::t.=@ʠh6E @ePILLL] z2-#A%199Tt)!OeMA4b䤿+hOSI,ePIuPt)!%e)׻* *K@qSlH]*_( )r*  *K@?xO/vmܚjtlov &ۚg ?YʠX]]+ թ/e;dҺbz~k_YMZ6_u\\I7_%)0 *N3::Zt)!Z\Hsyy/)$.74{;ZY>VY)u DzWSYI>+L(JbcccddRC2ā;L>#/uPSgjY ۹ze`A2Ȭ$EW&A%qʕK@G.<ϲKl,@y+ѾcM]BH(|JRtYaBTۻv*k{n}ꮥ ^:6ؿrg^WmU? ]}VPU,qZcWlJ6N8!U{D}0fmB>%"ꏪbǎW^-TdvPĘ ʠrJѥ^eFF́WILePU onn] U~gW$`2*FGG;Nѥfe֓PUE\__/@ʠXYY)@ʠ\ZZ*p`η5`ZᨃK@_9[m0`aaazzRe6211Qt)2 P`Xѥ /lll] (/:hѥ /`0Ig&.PyW\*@flooڵRe  Lc%0'LOO/,,] (5v؁i?p@ǽP@,Pw@ǽP@(>2VI,lo=w,꥓=iuRMOx 2PcVx_=#S\ZZ"7e2 g~XlD0A|쐁M gI@lK-yPEs 0S6m5{_Yz"Fu !< wm?eeWG}7Q2e *ޖM'y8bMsx !e 똈1 []`H{vɉd[I¹l@] 䎲)d=MVt4BQDo%;իWwء?utR3.9@a(uؘr 䊂:^F 2 ?1:+efI47Xi! XLۺ& 9@] 䎲Fm,+[f@C!6x!Lu&;ʪ 8@,AF)=iYJX2'|U@(mx6d`]}DiAkkn'78ht>_/åo.'Eϝ~QWI9BP>Bwܰ w%n9L rt}T}zdddccCG|7y@!nʠ3yj; "OPZ0<5VHn {}j1͢KA~2H A~^XX(Pj A~ בp@i9yɥ_ (l155[o:rkkk/\P"n7M@d'Onʀ;+Mkp(PիCCCl{}}lv5S@mI &P 2G"0 !pձ.Aؽ{˗fٛz@M 7e\M0AU@u/ AN`aL`P72 'lnn^ AUs_% (055h40 @ݿjYuQJ2`^*ѱ\ z`) * 2L(22 @H (ʄ2A( )j fNH/r^2ȏYn OTiBIePhneJ ?n~qNs8'$*^hub2I3[@(Yu[ 5=NTE' e$ʠ2n#qR1~tQ?{C59}휫z%^U4[Mq-.C5L\n e0 u4 \!ɝ3xP@RX TW 0-úN])#g* 2`<''>>$ZPOeP//~UnWKCs͕NHTp̝u=˼ H *_?w/<[\lTӹiR~= >~fe+n^/xovænWh6 +?O@]ٝ؛,*`pݠ 2x?t mq o>1?=߾*G~.jHD( ),DI!7_2-k_eEO~8d~l?wۊE*`M0Hacn$1O^ n>/@:Eɝ"Vɝ_?m@/,E{7U:4WK㧏n3PWCG+mrMޒzn;5=c}uU`1$uܾݟ^w#۸aCca!TSo$\{;';E7G@4шҊ=h'VH$\2mɃ"Ga28}L[Ÿ"QbE>(^ KQAe_??_73׾xH#b<^:@A!#X 6WmP`L,Cuѥ;>{v?aPN|ɱӇد,M9 j+LFW}tć t[:^6+w=CWG'>>roدo|q ϓK;Xn᧨hzO՛PP:uCM<'}k'_Ӈ_P_yDɶz%7x [>8s !>ˡ 2`3_u:<<:~#$nOO 7xu?X~>b_B>R9--y+>mG9E ȕ/65KVʷ yAcT=QbiO`ʠ늃O38 6_ER8/"O ݫJ#Z_,0&͡^cw/~d0߉+OfѩЕ(s(SnpI Q-Q17BW'`ͅ($%Oy*U][>yﰿ_#PD'<)˝PF( ) rgI*`u TI V TP@R@+`L+PE*L( ) * 2L(22 @H (ʄ2A( ) * 2L(b؛+70b-~閼PBIevʠ`,"Pɉ`g bxK/<'V;Te4ovonQ,Oa`$qAWgOsՔ9u%-(ysb 2@lI(xַN[_m_0i,gM垂_LɌwX3P~u$r]Nt*D( )* b f,/qhOdۜIUc:z|jaR)|C7)ERvBIQ]e`g`PGjWYg2.& b3p]5(LK5ή8) \nn/ +ܩEf@IQaep .& @Hj+2A( ) * 2L(22 @H (ʄ2A( ) *sP0S, KM2z(0&6 r6 !fVD8XBIeVP e$XeB eoolObdN;نD J@¤ &p7Ÿ&)A g^XXG { 7Jp-vL XO$0~ G_{+%k1讎(EyOCdh8匓>S.VQųe֞z`)L 7#[&ث ~8Du2(,8i%iɔb!b4g 1jK%ʠ[mw|w^)# |-/_: X!J7}e0n$4'*~=k2^| !@fʠZ eHH+w5=6 i`e$Ig=~~ɮӛ'&j@tzo~2PkqV{ιiX@<aOO(] L#yxp\B(LĦ۵ TLL C3!` e$E 8|m8@LCTuk\m@7orN@^ϩ 9ePQ!2\dowHx+jo0:^ é7 OwL?!X82(հGc9Pr q2hb/;~~M6ؿю!( .y/[)W߁/W& Sz} uᏻ۔ 3E@M(۰2|Q7 wP@RR_XqŁ+ ؿ&'o)_#gқ ~}`~'G'eqJy ý_z'V _ 8s鳴162 (_IqgGfjWF F {h?wSN}mpK)q_Pmٲ`sxcΐ^wiIa%Oxmy'PP@*28f̥z ܾ֧ZpllK2 +1|r/ݏNW j~e$E XcS0w1EA$(۰Skyo1ߗNy cɎ6Ҁ2k&e؛Еf3~v,&%bXUKN*EYQ wC QXGTIiaR%BI`bP&Zqoc02H0oI%\EўEjYs7|j_ zsP(2¤ ~no`0߸;&c8RJqvcy{Z1dͭ;~ b,j((`ɤ< yc\`ԩ'qGoS^*g,KLHوB*DQBqP|z_"l@]6}i;BfPhp}L7^~`ҏ!~謰G&lg';q=@~vGހO>#1M( )R]7OE9AlL2tsW!ǿ^@I jEiZݼN1QP_~O\fc +-C1gV(ڊe]ݳ.וFbS׀.28tѽ2{6.MB2m5W]Zè:cP !&i9h3lB]DsV(~.2`}ϭOݵtKG T}tz 8CYqs:_1``+ zʀs_- "~Ѿ1׾@÷ b>8F6!M?32K LeDJV3ȖP@R s7E# e 3f߿T@̖P@R$Xk[+%"A.jJmiBIKAv:B &8] ! ;U} -#})Y"V8$2_ (2¤ {’8ޠL2GrqylYtG6-ʋuſ'6 H0_m1~n |IU M g<6,u?89z,Rj2B &eǟu{]ɮӛ'&+&UG2OLY'R|W2zCKv&ym-eAX@ 3`j#n21^'-qbt cV]'{ ^) 5e"g,/+ o[An q/0lǑ2"2}ϺWN2зd ͅwJ诪W4j@3nА@269+󉜘;tPe W4I{, dr+w ,eXP˰RG^@?upY֞,2fmPa`pB!L hY=E@ yxהUyv˲RoO<2V4Ͼɨ W0UXg 4rpH 5M)7[Z("hR X .m;Mg:Vwr*LDKZ).8γA%Sݟ|WO78F(BLAfh^\XsE.^QqC,Xf/,E+*!mDKagGh{'6 6RI.!x3%T矼?OL`HjΤ |<Ơ "u,@՗7s;V?/,Z,9`k},2~/xw{8X ZYwm;20__qr Dbwn^ܕb (3Y0e0kпb j~ TDfylToB9֞vqCA$ E+Qچ\gH1`02:ԙk]YpfWt]L5 8c3(x  lo?tFruL@ި2*/_A a%ބf{1b/a.'Q桬QMs#IQ:Lcy_;B;p2ˬ B Űfܨ3()%>-yG (ʄ2(d}1f +F=bL[A;]P_}yr* |_놆VVV" )[75֢5Xڠ |t'GuJ<6 U^l6}ى  )&f>ϋqW,xݱUGO쇮nT _+ i2Qj׭ SIz[ou dl@̼V RS+r*}L7^~Mq^f|%tOX [0w8;0,ΊnJraC?qy엁0)4 }Km4r ٚXʅ<\ZAw疒⋿ⰳz*L_=LP%T_~O\frJz}A Y_j/\ސS`r^lqr35d]o^l6׃ V #{< I_5N9w:_}wpTHFjK y9wan>rx/M_]r#w 7$gT1,28tѽ2{lc)&,SV7<{KsnO YZ\|JO >bhe+ A@!ImnYd.+(;XBexs[k± Um'-emaX1k+r) ?U/,z51:Z6 >n3u8;S_VMqAP[ 3T{؇mP &1ȉ} O5?ug>u ٗ1ň@Fg;A`,p;-~ğ7La%pۄ5]/}Bҋ>I5|` K LNp lir) ? (Z9 l$ALj 㤺}Hz)줧 .ALDѕɕ?EUܷPڇDmnWdM@%2oDgePA`V_lnn.-- , *?gٌ6/4[-T P`2XXXؿΝ;oC%a2e N%hlG23RW^]__?z(;[ol߾}L(cU})PB7Ȁ!fLթݻwرl2et4oOSLHd.HI{{333ZW\ɳ (>Shڵkllɓ/_%cB)T^V\Y~Y//j`ssiЍ܊e2hb: қXUWtYJ &%WP%&IWWW)F (r,򓰽{7J=/'ONMMۮfzBeh"Ae@.lPOE ݋c3!&xeɶ'&&v5==}{p`>(j₽~ɥSrbcwkkkv2%LSX`Aԧ@w] eƷwx≌e)@40{{<@m?꠸فHs7=yOg2+W4M&p)׻|bjjɓ(o( Lh*aaaxxX,|3}dWv.--MNNRݻɟ܏YfY|e)N4$=44d>SǙp5i?? Ì3 0XeQ]c8ِP ow)%[쮦!X(`L0sy?PD71ܹ3EFv~@Ie=lnnLLL`z }(}p t(`wzzzxx8kVi5URZUu^LMM|c md\eg^jUZ+++ccc;wܽ{ٟ9s&4V'n+T,) E\>G?k׮;v|M pK naUp'*P իWMbwm)X&0TP@NTLV2PjrrrQ L`i u@0JX%!O[>teTfsll # s牓'Obi E@իWݻ1;OBΔ?TeTL 0MbeX]]+u8~YB$D*0_ ܱ2*aZtA]vaHG 2*7 NNNⅩ@`2`ssˈL LOO {EK@20D* ثj)@X^Pn6GvIp՝;wc XH (J,,, }T`5. k/} x7-&''1t9111qɢKX([,`u9144J),f`VVVXŃF҂i.`SX^(p?f 'OĊccc̀2 ܉ !\1`uu=,(X__w'*@+?]`522F8@(tf4flOѥa.P.,,, ].LMM8뀵 `ccũi4rZݻwc~P@`Rt%lWۣp=P0VWWm/VVVK(0lnn6ͱ1  2yWt)P@`ahaaaxMv܉!ʉ  eN4DbW H$RepAѥ{2r0*+|QRIQt&Tt:};9Iw~Ln_"6lRo`;yiHg-uu;M3my[`qnۨ \ :-4!$^K. ^~磗(cLxk ;+75g`y[OR^epȨ骃f{Kfiteh2?~",fKw B٨2 %"Xs@{ efBE ̄` % .K(0",5'\P`&DXkNh/ L֜p^Z ^cS[OζٞKDX [!#JN[ O0}vɶoyB(ko$cTnLcHŀeU&c_:VҬ FdR0z#}ow~y>#/ex3+_qֿ| o~m譭_?'[z{Z=ZUZӐp-_f%go@SVZF",Vx3 _ܩ3mN[)9ir;Z|Q, @<"Hm'AEVk2-k_eO~8>?~F!BO}*8?ƩMXZ)YLM^jQ"3cՐyaBu \.*=oVE.P*PLHjպCDn.[5[}?wɋ=~>6n{oGnؖ0B0*3+7sog=AlX9<[J[$迲x,^H''@O >+TO\\!CM٧[5[ʀ)]ȃgX9{3~_~a}O:VHNJ[\e= 6FDX,fH S4$*lR)?pEzO54<^RijOmlv(O}OΟ|BO՟~}m|cV|rzbV2Rz-UuKj8DFeM ʠ~(G(PU ol\M]ggeOķ;}ptĚ7M&gѶZcU]٪+0^]AZ"~(G(ܱwi^~[5[ʀq[[go?z˶?v{?>XQƝ ZBn٭X [))ЁU62H8~р X~VY@,e׻;|ЁӇ_(8F_" Jb9lUP&KVZ7;;=1բEa2: S]{'ۘyDDX [!#JNXf",5'\P`&DXkNh/ L֜p^Ba923!"Xs@{ efBE ̄` % .˚)dm-=xnsHa¼D@Ś)Oe $̻ dHXx,2PW'n]wmM-síZ+FΛ})Fo59nu%oδCAEw;p{-Qne=cvZO}XE˰zjր vr+܇DzS$+QK[rHY0o[;p{-ʀh !̋SqIx9Lj%3S>[0|_ Mܢ)a匲Xo$aކmqr+^HJJN۰v -I늙=3by[kqr+^"9j4 O7O(Hïڷ>7{ +gz# ּ. ˭ ${װ4Nx!0jg8'5\M,kX94 y!\n\\J0`XFڍcF3-AzF> }ʍn!~'1U۰rF]MCa pK,` % .K(0",5'\P`&DXkNh/ L֜p^Ba9Νok`&TDHe\L 0&\ &Ya923!"Xs@{ efBE V  j`/0̄ 0&\ &Ya923!"Xs@{92{_Wo $$,z`叻&uGϲ¯, ^0;@{2lK@"̂p^f f㝤%i93jiē@G,'[=$>ewXLz{ӷx 2hq]`[A8ʐ$eӛCo0d<'|# f p.*_\ <j<2܅;_3a)71e@(kp7}~X#(k<\my7ۢ<~ފx,aX,z&$* %K 5u(UXk$>j<2ā;L>#/_龫+x(vnE;2h{R='P\ꗧ=5K^L<:;η 9Y:XN/V+\9>0y)z:H܏͢lXo* ([<28~ʝ\mĸi:aZ~^YmߜH_ڰ,7Y-K{gZ/k iqYrpn59ek8;vLT,kf4)` [g7h.?:>ٿlbX Iq$XIɭp0h׻_Tzre-ᑇעAk%(x Ǜ*+hz^X֛ p{] 2܅;_S1,bB2*BMO*,ᑇ7]j^YlqKs1wn܍l3V΀zT ɔ'yfaٿl2U93,d>ܝLýy {ʦ1,_ihŠްr;B\^h$R>wWf=~~m]`; WGrRgr]Ǘuvʦ3=펿F3gzah3 qdʀ=>u҅cs/e_9\~a2b*=$|:Mi0&(b`pgƴT }s?zaD.E1b1m5h7'7NDIla y󟁸ӻ@h!]"qE}g7h.}(j1ոX&<9,҆j[^r!\ Bd$V=M\-/. 22TTgedL\-/. L֜p^Ba923!"Xs@{ efBE ̄` eQ 7gDKhOSIJEX/M@Hm@ĸBG-m>6 oRu߀UְS"\`` c?)wrMA$~$HBTzިJRC6,z|pX{gZ/kWH;BZmMЛwkr =J/r|JRG3,za.DˏXzi_Sy*ŠO~-:OZ_Ɋ\9JY÷!1g_qᆕ3`2.ɔ54._ؙgZÒL]j ,&S^myHiGI~ƅa ͓pL =q3S=e;d#n~!錒={N=/eX;g@ F^@荺p\7ea g\u!Q[2?-R0~N{c^Iȗaij?v׬vXl;{gA3\èdVzp,^+  2_n/\wSmF>hZvM%{X½WDf`{[b.B_8Ds#3'0IG[eVR#:"Žb"/cn"^ZI@FATPD3pWk}?%`,Ƃ{ BQD38yٟݖ}+ b java-design-patterns-1.16.0/chain/etc/chain.urm.puml000066400000000000000000000031341312550536300222510ustar00rootroot00000000000000@startuml package com.iluwatar.chain { class App { + App() + main(args : String[]) {static} } class OrcCommander { + OrcCommander(handler : RequestHandler) + handleRequest(req : Request) + toString() : String } class OrcKing { ~ chain : RequestHandler + OrcKing() - buildChain() + makeRequest(req : Request) } class OrcOfficer { + OrcOfficer(handler : RequestHandler) + handleRequest(req : Request) + toString() : String } class OrcSoldier { + OrcSoldier(handler : RequestHandler) + handleRequest(req : Request) + toString() : String } class Request { - handled : boolean - requestDescription : String - requestType : RequestType + Request(requestType : RequestType, requestDescription : String) + getRequestDescription() : String + getRequestType() : RequestType + isHandled() : boolean + markHandled() + toString() : String } abstract class RequestHandler { - LOGGER : Logger {static} - next : RequestHandler + RequestHandler(next : RequestHandler) + handleRequest(req : Request) # printHandling(req : Request) + toString() : String {abstract} } enum RequestType { + COLLECT_TAX {static} + DEFEND_CASTLE {static} + TORTURE_PRISONER {static} + valueOf(name : String) : RequestType {static} + values() : RequestType[] {static} } } RequestHandler --> "-next" RequestHandler Request --> "-requestType" RequestType OrcKing --> "-chain" RequestHandler OrcCommander --|> RequestHandler OrcOfficer --|> RequestHandler OrcSoldier --|> RequestHandler @endumljava-design-patterns-1.16.0/chain/etc/chain_1.png000066400000000000000000001702601312550536300215030ustar00rootroot00000000000000PNG  IHDR3 7dwIDATx \K,]T.{!*$)%e\f12fE mQF.oY;['z~{|>{3PB!B1u!B!΄B!R 3!B[(ؘ!"f 7VAv`c"Bt&Lac"Bt&Lac"Bt&j:љ-D!9J3 OmVmFj@#Q` "lLB8؀}*W.G㏱2`Nވ4[KV߿ڵft*[۪j&9%l>];{.^VO?`1czppP84`1 "lLB8;ZbҋIVV҅ [;#"&! Ӈ32f;d'LԖkXO>MF$@p880`q "lLB8h߾%εkW]r2<$77=(hD5T̍mP6o155F)?lWu&jKx2mƌaVfA6T8( #:Eؘ!"Gr&BǎEvަR%ת Y3m޸_QNNjtt-ByKIÆb+.n6+&yqJJ VRvvLԖ  mȩ#iiPyjjJt&D1B!DbLΜ$ @ Fǎ=:~zj"ti`^sDBխ.>L&iժll=#lͺu*LԖ5K/^Gݽ|Hٝ` "lLB:ed$tL<;Ν}͚5prsp 0778k>EZ&S֭[ӧ[$gTX5Q1iNt&D1B!DL<8M %hnMW<9ɿ#%Nt&D1B!DL :Eؘ!" %#:Eؘ!" %#:Eؘ!" %#:Eؘ!" %#:Eؘ!"Gs&'Φc6{{,CJ_EgB!B(Y$d ́S !<'m˗cDC= Frr^Ev΄h6&B!Q G9s>3ʑkn9voN?qv32*c,UʰYɫNbŨ(ꭷJƆaРbE 3E':Eؘ!"GIq&'Φ{z?sfDzāH%KƋ uJw^$9p/:D!9J39q6>7߯JugqʁkFaltqȰa#Ϟׯ"ݺƢp&_fE86m?Ygs=}bk˸q:ʕw&pGdTLT΄1B!DL˜f-0}:LL/\*9{{ѱ."0$ذQ*D\edT̙M:HؤխDL!B(AD >Gf>F$-:{6m['ztN.]!Vq&?loٲ!߹s5"Ǚ7k@x5t&7ouwoeee:_?CLac"B%˙(uqΟs/X̯S8qMCYYIڭpFFBDĄpDsfoRљ-D!9J3)j^M7K~W#C|'nX۸q>\]JػwqhLvZp>yrCHtK.\؊[;wtӵIz(AԡF g?xp(Ϫݻ2^ë2s&Wm*Lac"B%ԙ|MQrH/34i>>B޽Ku&' gr!CM[Ӹ}{_wO϶P8*Lac"B%ԙ8rd_??8\|T83JdΝLY|B[j׮ą [Fȿ F_T!EgB!B(ch>}:JO_#Lyi^Lac"B;_$h$t>i^Lac"BԙlwMӔOIt&D1B!DB:˗R>>]nEnŋ^)J k IN~䨧gۜTOFt&D1B!DB^ݭ[k?O kgWͽE:ĕV.Gٳcn}Og.l[C""&|B73!ZB!r;)ip$⌍9I|ijgc ޽M=:rg..UV|>O l Ǐ<{+$Ο}x ,ΝvZխ.K"Hgg'WV)33Qsz "lLBCƙ<, ,l*þ}Kԩg3-=}Q{.uT2*j{ m#"&gr2+'KJWs}mTRs挺u뫀=\r ~-mmʕ3ۑ ԩYJJ!:Eؘ!"GAdK|Myf͟"yZjgU>ҥYYٱ#q:"}z33XbؾժUn[Wu&VV"QHtR?|p&7oE92ۺuu>љ-D!9 r&Fs$bAc0Ct&D1B!DI>#b'LRSEU<jfVVҩԺuogҰ~Gm: WҥeY3LP  xKK3Z u͚i:Lac"B9Qqa"' ?0wၹHtl8ymRN5lC?Qu&LL/^܆qGyjph*U*dd$;d0MJncf}&˗RZ:Lac"B2wwYǺџ% FjX1q:*YB>>]OTu&PD3vv5uk}^Bgyc]__7ygEEʹR^^:4MN^-0EVV^?DgB!BjpEʫdeLxB>ڵĕ"cG( Ho2wȐn"uk /:Eؘ!"oZԹ?NQzΜQ ~Pvս{xnnzM~uҮׯ뼪z#:Eؘ!"G r&6nr ϝIM]sؼwP "lLBd95΄h6&B!AgBɈ΄h6&B!AgBɈ΄h6&B!AgBɈ΄h6&B!AgBɈ΄h6&B!QlI!_~"OS?(>u~Yt&D1B!D8'>wp$r5uMIlڴHlРC<{vL׷k/M4ԩ'OzzIǮv/3!ZB!rgwqW ɰann-32Np 'DWApaHo1_ڽЙ"!B(3[=}7^|ԩ^ډ 'Onݻ0u&v-hܸM }VVQwH}{ 3Sڇ+_\.mʢQSݹs1bQBi~U$sqqޱ#Tݳg^H$']{yCT@Ft&D1B!Dgr½}~q&|dߛ7t:DIz uWs]bE/\d'&2pWhC ㏱$Oo ,[K}aR uW=zʕ3}TrNPO$,QQ3==ۊUw^vڵkq6̺~=~y@Ft&D1B!D9g5{RU!Ǚ)cxqBZCg9}&"[D1߾}&9ssiܸBy… (DL&ɫ5LjCt[n!yFFҥ..bO?a^ވ΄h6&B!!Lڻ<5K3iǙ!dfVXUgrg9>8qȖNL~qnnT&?] ӧ7kF ^JWWg=Tɓm*QL4hƌa/v۶ڵ@i-͙3= "lLBCƙ|Ӥd|"HgRryPTVVRzz|Ɋ4l+&ϟkbcêUzLlg{B6LM$grzQ u͚i.n6cq޼ąjЭ[_df&J{Q{ z#:Eؘ!"3qh1ooơIga6rsgPwwqF}:JUZSS5+ÖN_gRЁLac"BrΤjRSPffxC?O%KDݻe-[Mn Łhљ-D!9 >]]_yLac"Bo3Q(oIM]s0W8΄h6&B!f:JCљ-D!9L(љ-D!9L(љ-D!9L(љ-D!9L(љ-D!9L4ӧ)y5^}Lac"Bٙ:]FYYIXjj԰Wݻ;^gUg!,rҤANEZ=yrӳmNN))j^OgB!B(b={qT {Zm1_csWyt&5D!9ɔj8מ?ϯPݽի:thZҥ"CttYYz6JLצM#ۻPx>}:tP\\xFk׮|޽#rTt^ړ'7srR=Um~:*2xxQj\ZD]\a-wٳhh/Q, ,_W۷ ?ȶkׂƍT8q )jؘ!"33yXG_<2mX̓f`~&MY[[%&wābUZ::R԰1B!DI>#b'LRSE8 jLl~ByCƙԨa1LW|uy&]ʼys/,M;:V nP߾%] :Hw|nrlmFFN<0nk% u͚i.n6cq޼uk-VݺAffLV$pe\:R԰1B!Dɨ\$:|6A͝ҥVoL;ԫWSrCJJ$fcmaazFcbb-#6?&+Z\KxWw߸,j7 rbe˗/; ޿f=zHժUz0I^˴sG'8w.˗cQO/vt&ac"B2wwYǺџ% Fy2;L5kd``nnqSvuCO?qLӏ_@*eNm~)yy׮-t~mlL'o l5jXwFLuk]:4MN^]jVV"Z[[Av-\q͚G駝>yNހҙB!r?58p"`$d޽q?^86ӧ)0mB 7(6Wy-s Vjukn?OGLac"BMAy<@ᕛ޾}_Sj|z|Qt&D1B!Ds&w۽_)HŤ)>{@llJ "lLBC Eљ-D!9L(љ-D!9L(љ-D!9L(љ-D!9 )4]P?1B!hʜ9st]B:B!xY2et] B:B!x𡹹kABgB!wޭXkABgB!7oެZkABgB!׮]u-[L!B4ҥKu-[L!B4ܹs!z !BFqDw߹2t&@gB!CNNƍGgϞ/^dggܾ}RJQQQ􌈈뀋 ŪC$Oѣ*WsaRJ͙3֭[=zȿ}*Sy:BOQ*V2x`mggPހx*U\]]Pu&&'OT{J8{OQ8jBgB< !3LZ>ӶmۊzL{ӰaC_dڵ鬬eד΄y8BCgBCљŋ;::KK<]^=E_ݺuk>w(P:BOQ֕:tљ033֭۽{:;w4k!,,Džq&O>\rbb"~~~ӦM#Gܽ{W5!3!Dʋj Ԫ_&4~ϳgOM]XW[DgBdl-/_wcccpWީS?C~}&t&!s&/_޽oZw&ÆyH@:;;%0pB <oz#:[Զ@8" !!}r&YYIիڵ8$::̬lӦ{ ޱ#Tܳg^jȨݻPՙ/!''ҬVǪڨ] v$RљHHFQ~8؀}*W.G㏱2AI3*Xӧ7" kfzz9v4$>ֶںIDm ۷k޽+gO;GD9|̘8M&⼐@Bv0BzÙ9ȨԊ^8.$9 *wGDL.C&eg'[Ygd$& vNm$g]i 6" AƆK8/$-"p&о}K\]k׮rǏeB3M Q~*U* sFE/v۶'xx(7&[LMG *Dm /_͘1lܸ"#Ȇp %v6⼐@Bv0Bzƙ;ٽ{J,_6fʹg#xF|F99A -% ڊ`K||mP"6&&))R$66ZJɒ3Q[2dd$U##揤Cq 8/$-"=s&Bgl ~cfY~Fz5_4Wv 9 o"!Op&djG66UΞQ(mͺu*LԖ5K/^Gݽ|HٝڠވB[ )R!Kg"ۘ[ZggݹYNNvaa&u_vӧHd4uкu[Xst?qLԖ KS5*?/B ^T"@D]O8B9yȽ{ Dl&'Oyo%:8qb``HK-pUC>]oٲabJGǺ'"i ][bvmԸys{#[FIu-RqrSSSYDJ!I[_~QiqW~:<=q['4y™>*=}}rꠠXlڴ>V9 wq]*aabnZc,,LׯH׬YYd۲e.Ǐ)-++ήF`6m#>o{Ȩ4ο"'7A;QffPK44d[WL]=qֻvo>ܫR<琚F<.]Z QJ,_8~ML32jOMIA9_l/?N |9Vl^J^EԪ *077=8x$5!Vq%'GǺ:?/v^ l%$-¯q p>aa zCN6ciҫS(Ogϕg]؃OS>ڵ+W GoN38j*UQQ3%gRPiXuF.0AlNgB4wꬬ h׮u&A6ffe6/K@"=FRMuFF= En'.Tu&KI4Umq#Y`G(-v^ l%Itz*;W\3 k?K8Lw~1c1AAܾ}ɓ^L;w.qq8/LgIAc,=gl9xpy2F'#66IMa(6rp2AI3*Xz@^=v"*jg[kNSMëlmLԖۮ{ /n+Wv揈r1q88(Lh[ !D=%w/stgŇXOr֪fl;BolC e>xȔ)֭B^.]ZKܧ. `E`0IA;ihhbb,_QZo4l^X۩wbŤ/%I$++… xÇI0 jIprS[7ə-a׮4<}"w?" AƆKy&BSr'1HAn}VY;g(|"H[P`O϶ҭ'N|^^M,"[o+9I<_|rT8H:V"9Җ. lԨ6TI$4t +-RqrSJt޷o3zʕũ‚B3M Q~*U* 3zn۶j }SSc"?lW8%|6c0kk+KKqÊ *C`C؅`;/BzJ$~c;._|Y?Q"{=:?~F<#GRu& ֭iiwK 2kfb+Nn tc"woSk׬qlӕ.m` kPRҰ ǧۦM -"j ǙDJذj*eg'KDm ȐjZV?!6XK4=7w&?'7Ao:3ر,3իPiիByNۻBS5܅x]A$ZMgcJ`oont9%DEҥŋtwo?jyv6XK4aѮsPפ䊓&tꌌۘ[ZggݹYNNvaa&u_vӧHd4uкu[Xst?qLԖ KS5*?/hZ!%[ P%N7S?xp(ϛ@K d4G%cruu>vAۻwqhLvZp Cx:thD׮-1(a/ Ժpa+"nn-ӥgO&MLQ57nq6}h+cҨ+L𩬲+IiKDJ3JP^Mo׮u&A6ffe6/ ~w9Y4zl r&o>~O vνzөS;1ݻ {Wwaҥ"'=NNvf8w rl̰aݻ$ѣ# j9 &F(S*%/_˫ $+doOzp`1G ZWT#<|962r>/5k[ʷG<9S*Aj. :/3f Æ))({A;c+_88*S:g֭!ο(]0Nw IqӄVy$iS%aQ/H99y"'ʑ\b%P2 fؘXW\ce$gU͟>i87 ӳٿk&I8+& m<q8R uWF. .A4iRO444Xkkĕgl[x4rL1A9Ç4i6IO_odT*8x޽VCq5 _8ȦB(v̘M SP؊#]QDŽ"Gn,-/;8n8=>EWU(_( ֙<~, !ݦMiuLj4x] 3ɿ Qο(]0N [lܽALr$1|FSL3&+c2DbqЅ [ׯ!ґSQCYi-&U+ڵ%Jgq1@:$dοMK4d8;c?AI3JWMdf&FDLsz>LN2HPMp&ݺj'I?6y0L4jT[Q3155ɓ}{ti8 @ֺu#駝bg7"t5tҥ..bJJB!MbF%,HWt1D`$~KS?P˗I38qDƙ` V(ϣNP:훠C`u/Pڵ*L`ltEP򅡘tg==n婡KHQzGܶ-gct~8˖M044qbqȞ~֥ < 3 /B8R 1(aoWNWM(ڷo3~WqLPHr&AA#0qR2Kr nv-xulB]ͅItɓ439z3əyBؑ_ƍ̚]Kq#qQ`AL0X&T(  7),HWt1(_ѣ kOgg;̇ʫ:~Ʀ޽''^u)e0@B {`Bٱ$$BC_Eg._I]7?z̆V._~x;UP */C'΅Bi +W._ےCP(ž=]ϟߌB<]RG^|'X  *m˖c;#Tޖf zh\\8"`o4 SDP,&&DwXElͭ_..C?o{~q9[Y((iRfe,b)wCg)ի[Oq&BǎEvަR%ת Y3mbf_AED\P^&M\QP6!g"MI? ||əH9; ]7bB\w&˺uk-6u+CCDLK[o >~8%bL( eg'Y,EsD0yR |a(&-¯jҕ߯zOM5RZQ)3}{X0G<{6B L]d~ `Bstә3ɾX]Smi# OCmo>Q=WWsb=:4"Ç1L<~rLQ+ OV(olCJWV )U306Xշo˙Jׁt:dK>0-켤Sœ1Gر 'q6/o"!Oį~Aل3ؑ ٳcj'Wkl;gӧ1LXC3)z06I{sGpE <ߡ`1G ԛ#vPL:uMfE~uNA]g !|ný!OM]c qVH~~ݑïJ\ 3Ϸ:wnoY/SZpHy*~v1ǧBt U/_UЮB9=ر#T\bkb4XDf,G  U>R= Gzwe:iGLt&2a޽ cGf lMڧOGɦәa9j''J2m&O?!UgRPuk]F:, FaA5kVF?SQ3q+:cLL򅡘tj -@~}p>6yf#"@ԼuF޵kWEz?ztJ~3/5jXc2 =BH(Nz@˗32*,S8*U  lBy+pAbqqƩSBVq׭UF>p8cw5rs˖}sJ]rr.%e->Vtv^!LП޽M^ӡa6MٱɋբzDrrR'q+:iLF򅡘tꑛ~l֓U⥔XJ擬Y=suEcb XX !hӦ3߽{q[bjb۶N^Iu6?(4՞=\]?>#-[WymBvpEcf*X -λﾃѣ)!-[~=iq$ /f)Sma^ݥ?:;/t&ԛ#tE]0N}l}?=n_w+ĕ׌Z׭[@X+lmU?6;;dT n[}d`eenhh (8q V M+Wؼykk+dC.H>Jl"܎X|2̬~xc4'Uh!=nKAGQEbU˖ V6FF=:RPţt~{ ;/GЙP%[rR@u(˜f-0Gf>FDՖ@,3PdlҤ6R(WC*eزeC 'Gj5Ӵ e˾^^õċ eJqp?۷SZ:_lqG=Ń  (_&fdT cWz~B}}D,~w!O͚׊R(_md-nz1ߚh Uő@C֩OM9?U/Gztn܈xÆ8vxVV *޽'O fg'_jK*|y&ЙP%[ T1|ax3;.U+&oy&3-_9q8Wy"GCoJ._N[ڶu b%o`Hbo]ϓTIzRpQŋUTR81&Pz&vNMPDʙ~,kvѪ9Y<69yҪ{13+۹ssIխ[_yuGmB?NFbԨ^S1Y㤭 L Gd /^G<9*Iff"99UTؽ{v?pW[ l ]5)Sm˖M]^4ވ]0NMy&3Ya]yC™8W,B$vG)p&>9yuPЫ7mZ0Y>װUn /xB SP>4Pw:ݫW; "Z/%_?y۶N=cժ |m{+9~]BUqX&vcxy}{ϯ; ,Ν4%%R9vml\EEa)ȑj+]`zu ?ҥ;/매п6ƆM28&&xB+VLMg|CKAy_6vOG7Y6^ʟ>1YOM]PR%/_qc#<5q&s|/~8#˱b*U*HWsILnT)Cx]3O™ 5k S8c¥^ʳ88x$ZOF G>ǤI]7{7iRBPz1&"vk|^ŋ۰v>xpƼ޽y yQ("*j&m#"&tvC0 ^oᩤjYl6̺~=NYl;g($ GyɒW|MΛ^F 矿Ai/iiV,(7lֶ;/매п6={v ?t&oB)yf3Ya!Ͽ^= W3  ^jcSES|+"Z5w}ܸg"$:uj&ڵ gyəT&0B4jT{[4t&<.lŬ |*t&ffee]TF-tE:S >:ȩ[7J0ﷷApi"ڭgvs>̭?y4Rp5ٳ1kXԎN9IpT !`sRKwB#bVV"#W}LPI zU,+WN.7t&o&%^Cpx;֢XH:9 64tp&"өP;CH+ݿ{iР~;wtDuƍ<8g݋PtCVzmb%?dǼn5 $I0(OFIU3.쁘bz51Hr勸p$JȒǙTVI)9J*Uaۻ\sg"v!q[LD Oe03L GoS3oHϚֈV- fxƌa(3τ3Q˗i( sUKߙ`bcSEBBFYQmrL/_L3B+Z`[n'7HJS*N:TϟLgfR5~EFgx>P5l>O\;m[HÆH9^j. zwF l΅±|9_4-%jEIglS|gr?l/3!DjOӧ3$%e!1q5mC ` yyF6%ã.@K};)11{:\`jjD!oa`PU33}\]ȱYYJo82 %$!a=78 .3|0w/34E'z0a(`۷7b! \ 6f 0ӧ7 :ep SP4O>Gm;D~ʣ~_( )/!?ؿaąs?%#`/Ll[gaŋq+W6?i0'|F::a&@F؄ 4{qyLvhlQoeԪUTK|}^x 0`@GC/Hr(3BekΜtFwF:ߙP:,xMܴi=ְ-,Ln`w ڵ  M ܙdvT!( t{qc?xBɍH\xq ꄁ.?!du1c}!&80$Ļ} b}(F1Ct84 Ĥ“'h+™ vNrǎ-34E&z!سg!YbʓH'Gsyy`&$A^(a&2ӱD0@塕NNM/j0$l ]`& 6ZPS^&BDk't._#CK$|Q1~[ӠAMlXέ!HH+n̄@NݺA(3QR[D&uaN'HYʐ bf1I;L@H||_ݝ.Ӧ3: 6ҩOT3tX簛A6[ͬQê[- Vڵaڦö۷>Kh6> GPU֍I("Upaկo:Anl: 322Y ]D132FHM!$i+7d& 9Moo7]*GM>`@ݿ}{xԨ zp=-/34J-2􍄒^OJHB:n4W3Ϟີ|3:6ҩOJvL?Fs{7؝w!w`%$Xn6F͛t'Kqzbjj$I5QOSyUDo&z!*w) `H64>A0e"Dh D8xp)Z/_Ѝݻ#h>=H>ؘ LtWGNNUpp? o_uLU63hLyL3g6k|QKV\?ylShlLx h?޻mwC8OٰaFdxTGT^a=āAF: DSj-)/!˜ nt6&0LU ZS^&B1'lL`!ʫ"KbD[OD1F)fMؘ B0WER3hLyLJ Ů%Ki\tlSǫLD(챫*RM C)6_3 0޽;MM}H>acT^aJ͠E0e"D3 GƌܳAӗ@rC`C+&aW۶͏59֬o 3IH'.F5֭uv~bgWtqiA{>}ڶhu"}ڰaƳgdv1iذK~6ҩOؘ B0WER3hLyLkK⣢&ϟ?o 6=Ӳ[oA"..qc[tő#{\ }m$~iw:4͘1ݻw (ҥKG;Q]-ml5@Q>&Lܳ\Hf˼=^@Xt$i͚կTɸLbbz[/^H:uj=]ĉu.2=SVU4A:I/xMyϞb9L=VҖyz?ãۈ=Çtа e>F6]_۽iԍ{^iϝ%!a.6k԰ #a %ի[ y,gBD\4;7J S^&B1FFǏܹѣG+V7n \vr{tR 3##iӦ#GL÷lҮ]'O\x{\3t.3A6mڐE~w4iӧO}||#mK}dL3~D]De.B.@8msXVܼ"|4wŊF11AYYz`w׮%&FK[h 3##iz#GH&[l׮'.^+W~yGyW ^۴iFn9HoaOGo[\̜SKk͛I&m:3sAovOP2GN_z9K--+ִNZuHMpcr3|(K>m]-n>k(v Dpe8|2e"D3amtTT B#sʕm۶%/^ܼysf{xBBmrrrT$@*Uܻw̤lٲ/_^T zxR(w/p L?&2eTݨ-P3g6]QQc[rJ۶I͛ח('$̅ݜsn@q^wozE/䤃rX*98 ՂQ޶dokƎuGܦ_ml\2334iRݺ&kL2a\Py&DES Dn"2>2"%l&&(Wn=zt9 fbggGMR#w駟ƎK $3Çf{xAAjTҘ1c@*>8о}{nD[.]Vѵ^R` uh&2eSs1+@'M ˸Zw&XҤdyp x/(D VVf*3;Q +zd3|o߂(x˥KmqmWMa9e&vv^.3Ÿ8 <ٓd?LƍSSQbƍ H tERC#0qcK:+:8ԭ]nuy[KgPOׯD&*+)/!ޙ06tn:%7o4nܘ'''w֍w^aaaJJJ.]HΖ-[IQ 6$۶m#̄7o<}4//FEE}رoٲe)3155Q-_ Q4&Ԝ>*> 0iMdrLհ12}ܻxJÖ-39۶!pLOÄz`@GEM;ɘA+ZR1ťe&HG!}2- ў_`pIƶdPBI\\(  2!CEGO3%h!v3AxXާOom(pVD,,Lou;[tzBJO &*+#QɔāAQL`>}阘MBXXX\x177\vB w>D4mLF3&x̅hss߁pL*޽L2y_v*(( c{ WoX $ zE LPժիA>v'ߙA !!E o["K0V?OPo$Ĥi™ hB`w;2\_]-~@@6D(Rjr$>KGAopBD"% %'8Dpex>3a"D3amL K.566nذ!ƱcǸ5j֭u9rIڵLB3۷/~у|.Zl .{yyuڕL@T=PJ&Q2&tYCU+!M 0d˔) K'`M)رɬQê[ԅi0k׮6ep)x^^F߾P ~_3\]ʖ5dܡgUQQzu!H+(P$EmI%H@+"hDMo" WnM ibPyI+j~h*~QWQ bj:+N040Ѓdby 'c&Lf"yzx"|`&b`(JjLfnn/D?;!}ss^~111$ fBy!ʟV'#.HTJs)s<}^HyČù9z->lz11A$M ӧʷ5onF (Ѧepzbjj$Io: ccC^Ou< (cB={wޱcn޼իW/^׮]{IQ`2eʾ}%)))G޾}DPڿXP\ƍ۷ozj4&Gƍ##I.\XjpgϞ]lYpTb_?Q#?،tR,Z'Nܽ{Dj9vDjvDj;;;GGGK?v?%RtHϛ7E<.]4:_ y޽{oٲi ///;~HϜ9s 'N\8K.!3MOO'oV݇+V4@qo:zvA^’ߥA>@7ǃBcݹ^5kVݻ m1 jeߑ H-]!I>!R(:/g&޳#χD6ҩOطg "yg`ff/*?.޸h*T.g^Q薛&"O6_3"ʘ \z@^A+ÎV2yHry0[vp3&u޻0ަaĈ..7={:E8dNt WPEԱVg1ų`ىlS0f BPA`` 'EqtMTPk&Bߙt0Xk_f0̞ۦM3I23}>CLdL2ܷ類Œ<=]7o2eYߒ醆CTa&M1ų`{v4`Z2\7yxtٳ2C$ԩ,1BF蓋nOLe$kzͅ6å9FJ\҃>aJ1,GiSf2ww+WN! f{޾604/Zƍ/ׯ,-+|y٘u@ʖ5pqi 2G d&,X0mxl=;mѢ¤IG#-5U0f B7 Zc&LLF&bHH X0aͭ? L`w֚ΝdE 3HyEj+a&ismݬY}Ega ή ۚcjʔ)=J 3?/yg&޳I@*U fMQQAۖG:ц߿yŋO>9uݛ7o^r寿:ӧcǎݻwΝ۷oݰaÚ5k.]hѢyܹ3f'N~oF1tPwwӧG]vرc6m⋖-[6k֬q 4SMj,,,*UdlleʔaF U)5L B!Mn$%EÆzyRLhӼFF\ނ4]KʕM׷LL*xxt#]EǸ~L`&˗O=44tΜ9?… .]f͚ 6o߾}Ν{MMM=|c~ӧOիWo޼y޽fgg|۷yyyZSbƌN<H++G)¸qC0A{n"7 mH q0f E0e"D1 KK$Ѓ7t)~@X'N]. J|a.3H?2&60k׮FUWaa/ `,Z$4 t;11Ĥ7^<3Aia(:/?xl=;qlժիA>v'ߙo"-t,D3F % LWEt?+kG"\;r䇋paLӼI|3nTLLPfd"'uƻv- Q.#6+a&e &/he&M+ɞa=qc[a:c"#I:ej!:<3+[Yq#g&|`/^]~N`& *(kE'vU# !Z|LgY  s o䃶ppׯ'G`˗)8⟐$RGJg}7ٳ1#FՂt8z4#9 7v%*>ر+:;GϞtHy&zuKr"$ HѴm/V7q0f {H|Lya&: p`Wk\!ÂM11A$MWWb*)Ȍt,h 1Ov_ lzue%0I@<ޠm4RLR " ׮޽,\pj2AA9zI񆶣"Ů_O455Znڝ;`2..ɱeʔ˙tԩ%q^ay# F33WS-޿X`ƍ*D]/\E_Y\$i')^)^_M Lye&1 X 4`ә3b8#$%:W#]-,,W]EcBqQD&Ldxњ5SMƛK DX֭Vt'fbl\p-~vXDsSr,aÇq LO_ޤI. S1l+]B> mTQ?L.21xxJ8~ꕼǦ@j2fD R2$8x&TpaKKKkӦm~,((4hܹs[/ CgiLn@ɓ=IMl v)'PoK?|h;yfwQ pPKy8Tӗ ҍ7( S-޿X(3EJMEAݺayV$0jQFGIja')^{l;y{IAA”Eoߙ0|">=~ܹs߿ 9r'Ol۶9c&׼|QI_l"[&..N{11Al ڦ x-SO`UKNߥܾkؖp-~vdLWW'rlV֮ҥ6e w$ÂCtB7E2~ʷJȋ.p֬oĘ|9 &J\ ]K޾=Ʒ 3ORTyl];w6;\9j7”1݆nϞ=;w&ׯWTIQ1c^щ;D&$D^䖁 ;vlIVEAH88SO`UC73fpP7,Rrh7`][PbO-0q u0J" F3޿XT*D^)M[H$\  w8J0^?Ixxr$+r&x ˃/@OyAv/LyhQ3am颣kJ3fdLW M Be`on=o6t)qC(O`UQ~} _ڎtcY֬Y`[H3>1&$ ( itD_,g"/hrpޖH L> ժUMH߄ C=H&ZIÓ')^e<67vqq4={j7”E 30hw10hG9staa!T c&ʟV'#.|%_OLM$iX0.ޠm)9PÁT%LJBw vj1l+IƆҴ x# 9w!ZUDM.AdfBky%Rf')OxzExlJ]uٸ1H2)/-2fNBvw8Ą #ʕ+=<+yvDΝkР򌙨y~ʆ 3"#U;L%Fƀaa۶9%^-L |<>~vW΅&b fܨ"h2^˖v͚ovl_ pFW]csIja')^zlh0 ;(w=)/-J\RWs+KOҏ=2}(sPZw!o<,T[յkdEi*:4TBpR<o^IJmmyԡCːHM0mmmnA]= Ȫ]՝ij{C#]nnn*URSS>|)SH~ZZǏ "oDfܨ"h*' 2|>ּ(IWJ<6eTRR`D(c&Tzs綃L?|}ٟ:aa|woU?a&U_,'LtbEʻJ F&btFԱV~3V2Ҥ 3vVwRPFIH#]||I5:uDWZjJJ 7A1LDfܨ"R'OR{CH1$$n% Vk tپ/%UÛ 8*|9~{hfaK\L$\zɛKERX+KAI3|gi޶H1aF.ڗn* XhLU ZS^&BD3~p!'`SQI}JyyՈ UPoU@5 `ӧ(]HLw0ܣ & pÇ+ةHߙ^4!c<~~- 2SS#[; ʠN޶H1ьCb'7Lɖ-nUpu*G)¸qCH EIE<ڽ{ʗ8)0\)SyU1-)/!"HVD"g}Ɔ֭[L<<=]ab2SP||}Ý;07n )O,~%Uҥx2f`z#:11Ĥ ϧ pD 6D{BXhV F>v'ߙo"-6iL4`P+hrܡDVr ~ ]n(/.Ďٛ0PG. (+f1-)/!"|d%K98Եw!/T[Ծ}/WSldx*bˈ2L`=7iRlYkW#+ L`:|E.3pXh5{˫W׮4 rȌ]e#fD0q"{õI"nׯ'G4˗ fT%z?:;7gƌagW :;ƣ8z4#90 7v'>ر+B5Ν>gOg2( HOK[%jbCx}1zuKrHl@_RR܍cLHfz&MHb i$_mdxך5Sd0W0DJ{CpF0=Q$oisocD։^ΐq.hmR`D 3 -ĄI 46iLJ) ]C:4fa2x#~ghr=]BCeJ4@><3OCOXG*ڊr o <ٓd?L1;LŅ鬨 r+3sc&EJMqh=P[ $};bf~tP4PQm>W@:P"9(RgHQ-U-Iu)/!ɽ3a3N}hL9}T|@`$)&䖑iMZ&'L0 ^ҥw)0`cے. G'Lfquu"fe*]q1R qN2(` vIZ0 jqɐ!ݢp[Aaw.Cl%Kњ7oaD|^CEnԓ0'' +C3|9 wJ|y]役H!ŶTV&Lc& 6ҩO gw/$LI+-#MQ5M<3q# 0JP'tUgAPl̘0рRrh7`][PbOBȗxJ3\TuR=;2GZ‰ uZVի[/5ΝEƿ֎1 @x@L^Cn2\G7?]:M}paykue&ΐq.%kmR`D0f `#Dɘe=Wy86e k㍴Fb-%hr(@QU֍wUaGmP'"tcYOxa͚UP fD133OQ@R!D3 z{^a(؀ݨ oF9?񫯺2fQ{#K$ק=P[LҧOcU [ x]y@E3xKZqT2"JyeHH~A$A`#D y$jx#)@ G+RU0壐s$|7PuÆrsx 9MSS#I| 䇤ccCeR>9`*(Ru /<ÿ2為2woB5fx]y@E3xKI1MLye'.p֣t]yhr@)[/%t~uX9mƜSyUDR'ε-"qnm;VP83IDDWD4PX+@fA:Cǹt@+nz3fxeRlLwq읧1!4|Υ(<ɠ`fDW \]cx#īdaÌtTt>>~vɶ"LUJRВPX$fB< QL3.li׬YFlg51b6yW@DA:CjbmMK>pLT\2A9CcݩCEnGWժUݽ nځFɫa L,:4bE#K╴ %J.u%iU,(Ȅ S ݶ$d ijTK`fDW 'G:n Kp$|DEu$P( t.Ֆۤ:P<=ǎ[r͛;w䧧7k֬RJ1r[XXW_}rAI/7$(c&Tzs}1Kk2`y޳WdoS ~}{vJ%+*|  f4ÐsSݛ DTSQ/)LD*JC@b8Cs&Ձ)^Lବ,__^z!ѣG+VA׸q lذaݺuM4yݳgϤ/D'ߙt0Xk_f0p2W類w7n$㾷H_S.^:3Q.*u)ŜL ^w?~7CHܾg& QҖLyWRU)LD*J&C@A@ugȒu.բۤ:PlfbffFHDEE999ʕ+WICU^J*8J¼tS17 ]+zsIPСe \,[Lԩ^0Lf]dMۥ(63y:Ҳ˗Ϟ)p};ܼ4,D7ŶT <] mѢUx>āA`*0f"+ѣI p 'N!1m4ccj{.)ӪU6mڐ4c&(3 LH!!%')3YǮ_?/d.[6KǢ2WW'7v?0Hyf&6̠8jQT]0J*J|:ŶT @97P 'rNUx>aF T^aJ͠EW[n͛7LpIrrrnh{-׫WN:HH3ML B!MȐV"#Un)S~ʔ QݛKIf&N+֯oTFw ˹[_]Qmb[IqF˗OݸqC0@%{nUs/A0WE˟ig 3,]ظaÆ͛7?v wРAd6puu-[ T&AD"%'XkW;{6UֱuV'0{z LH<2 3t)fs%}֎eKE^Q2&?"~®k2!MWn8GG{C7 "\!k*uԒ~,Sy͈d8/_\^ Q#V`cDa) lq+j S^&B䙉hݺi2HJ*%_IglذaMKhN}hLܽ=.3 䖉OPZf*a&d2 [Xrϰa\S=>wW.;AOo^^eCMb޽ rnff"N`Pʕ+'C$88XD$R2$8x[ kn2#G1 5`C> m6-1y'I?x3ѳpv蕌>nN7ܙʋJ)5uєDBWnU_Y gƦsSrO"qG[AZo+= 84{Ȑn9A&M&䠠oZ[;PՄ Ck԰ԩ~ w݉$O7q]/.GhgW*obbbnn斑-E`"fޙ0%>Q4&Ԝ>*> 0iMdrŅvIfMΝdL(:z sg*/*Q2s]4Qż~#~i00a~U߾pߞ=ciYz^SrnKEQDFϸo'>XےndϯkN 7N\oGG{zxΜ4A7""qWSBBBAA؄13S'Ƅщ;D&$D^䖁 0;vlIPo$~37ȍSՒb3(Rj!.[>ƒJ|7QH Lٺud9vl%I#n0kk_~#ƃ ѣQ碾0߿-9[e޼y]`"āA1z^q0,4% lʗKy{gH9X7]Ѫд NAbP~L5#hgΝٻw]6m OC۷ȈG!mwM`ф ["u!Ϟaԩ% |޶msnL`:"绸|dرc>}zNN(13S'y%ݟ/뉩$u,to7A+6o6̕ccCiZ tKLUU\4{>c YP v :4FSQ7n$H]G1 OoSv-8bE#H"hr}j */_tpp9/_P߻ti|0̈́ZG O+rraFds|Nxg˦}B۶)O%R ZѣQ$ùs1a#=wwNp'KeII \Oھ=OM{r&Ě5S>=,-+[&i: ݻH/:]DLuwAE(۷nQ&w& 6OTOٰaFdx >acT^Q]43޼I'wzu;(!طo_m!iЃY(-mI`PB)8LtlS1A`*RGG֝;Vmsi *1&BxD|{:?9֝Lc 6OtˆaT^޿1ARjԨ5k2f"3={tܙ\~RJʏ3&>>gDodd0ԧOQzkv?9 bGp. h](>ьC)|"O74Uyps kd9g 3W.|7-Z(_<~>|x2e3a"3诿 73'L&YD "!^aaߓBf+U2߿-֤I:u/܌L}#{OXG2yZ!  F2@jP"6z&n#F2Ct&ޮgB~&VZpfO4`g >b?S%ɘ@"A>---cbbؒL(BVF.%U9sBd*Ԅ1}A̤Ov_ lrjN۶9p` x sўbb0xy"K]P)J^ߢEqFFtӦD2y߲efv͟ǙAkYf}@,l"[ ܹL d״i#WV~1v;)O>Ld++Jnj RQL˗O5о} nnzE( a1˛A9>Qi^/ͥO74 d܀7oL@o""8yp7e& …M6ݲe =z1Bxyy >ի6ڵk%g~j֬nݺ<W^m۶ZF<77J*H/2e ٛcnc&$g&5经L$Db22. '5=&nZӒ ,ől2LǏAn6Lc z0b2(3ٱcKk?˖MH K[;0ݢN޶I!ݢbL3 >Qi^?$ܸ G_q߱Qf2a@+3sc&9&5['dÆ vvv999'Nvw,Ӯ]&MܹS!!!!իW?v:F<>>ĤF:uzɬZjJJ 7A1}3щ;D7$|oVx![Fwt>Dy pcb0bjļ 8̔w 3ߵk *bw&]; 054, q#3ݢU+׫WIM`޶67 YS%k^3LQB/W>$i7%]uٸ13g:]YYJ.y*e&Kl˜p۷/bĉ޼y.JO "ݵkkGZ'OP ZrҶmLٳ*22RM*8w&z)W M B2?^LUH/]:ظ<&Lǎ$HfV3#{T]ڔ)ihmbS{x`+[…Xյ1݂{C۷t M~Z1hLQB"O)|"O74%7-#|dFc1PdB w&ŀ]wskǘt钋]*U?N2,X`ooϬ:"9995Zn/>>>QQQZHd޽ad2sssϟoii9zh^Eǂ 6Yf׮]+^1gRK2D8sf@|P Aa[)mw$kB1b՟V?>} %<Fg DkԨ"G&MRy c$iڴ={?fҫKf۽{w v)83Rv({q#<~w۶9k8w.&##G.R ' zǧ7L/^عsgؔ2.\kZy 0FȦM:v(Qzu%LdffdHHHaaat)83UF1 :tCOScn>eaj/Y$??_|^B%::[=լYݻ#Gtpp}J{L.} ΄c& 6Oؘ B|*yfkkkX=v_tCd>/?h Gh"z5^| .gll|"UPn݇؟OVPāAF1 DOPv}g4ʺud>/r.]hKׯ_[XX\zӦMk֬ӧOZU\\Q)դt8M&:$06>A3EcR/^[ZZX⣫t3ኙ\dd[dv4Iaa VmwGݻw ^^^uC 9|0aw׮]S;("ɩ\r\\7˗OV>! &LDO={ёi2 ȡCʕ+פI#FlٲHo۵kDŽDx&LO4L?O}&]MO~u@ɳgVZURaX$%%KnݺtݻjS: Gٹsoj/L>!! &dƌQKRF֯ocmmaaaڪٳ1.^$7ԩoݻM^^;+3fp.;;[+o,X^ :ݻw OEsg„ 3? x77xR 2- SZQ(p!v$pa;&%39yd֭Μ9ԪUŋJ~~A{m'!z83a¤DD93gQ͖y!!wРN8aÚMO_޿07v`/LCrGFyyG-1g_ݻbo>ر+6o^ܹo9bF p.]IfϞ{,$7oҫW|<igGDi j1OTZuݺu}K֮][۽m38p [ߓDx&L(a&}bƏEH`Sgp8xȵk FMs'ãKkR`Le xq͛e\e`P&(蛝;Sg*02eJۿW/gd^ҲRbbŋq֤>:uj BĂcq:& 3)((;v, Ϫ>?{;WWסCL-z23a¤E3 ܽ=.3 䖡nQMI+ d֌S>q:~|qyRK LHfz&M 9[lg͚ܻ”۟a\WQDA?ɯڪU6mڜ?^}sҥKRR{[\L///rZEx&LC1`ЃYD& 57na8sf#zuf&'lhXҥx.1Erĉu@`ɞ$MddD} ꃮ3ǏUbbbׯ_Wi߾;DEx&LO1G&Mb"~LnjϜD2v.]Ԅ=ƍm..1lPD;ɕ*s2[t0L.]jaa1n8f fRR+''cj#LVtug„E38CԈ}!a{C a2e{ ּq b 2CBJz#2fbRɓ}(}`#;ܼG{hg@<~u5-{x:&(39vX;vj/Ο?_۽7yEV&N0O! &%_wYCU+!M2Ne֬Yʕ_ӧ74iRj׮Fң6oH k+oo7mաgI://4H.uw;QBHWB撙܊!E.Y.cMwʐ1X HRیaf311H[=sy=G|?s>>o$Ln޼doocbvzݻw)Ӟ7o&-SA[ (srri;4r%!%e-+ܹVb0V TN2̤`ն3fO \ˋ/{ 0%``ѣGiv Z(ӳիܩǵkTN2رc-Z޽/"X\/yf&M>cL X(2ҍI[|vϞȈ9 *dgg:qrŬ 6lfLޗx\KfxL VXacc3gΜG= 6񇳳sTT&K<@^@ȑ#>>>.]{, 6(W\qppؼyK<@v@ڵk rrrڻwc_~qqqr=-N@fq(2'O,[f?{8 O?T^= GK<+*Voдܸq>}\rEٳg֭(@񇿿Æ  ,#NSΡC0Vӧ[-ϗ{8@3^dee٥=` 3Jȑ#M6 Çpfy9~c0> trr;wݻ= HOOy d&f={As=P2cǎ]rܣArD'Zlٽ{/=PZgG (+Lp֭#FܹS2s%'666G{ 8@fCaaaddԩSo'ǎErJ29}۶m;v?= \/[Rs޽^ڲec"￭>|(@fҀRTTSnS~"pxp`ArJ 3ܹs;vl۶S \/(@rtɓ'EEE= ^ bǎ5jTNNcҀHN60.^ح[VZeee= %^сh ѣGg϶Yzg\/ArAfٻwСCoܸ!X<| 6F0Y\һwowwwl}L}uMQ 9 3`燄؄=}Tr 6vd&LF 0իr;NNN.\{@/2õkz-WW׃=`p` P 3`,_f…r\/ؔ@r0zҚ5k{e lbPrbccC{ @0bn޼o;::&$$=`hp`[[[$' 2Fɳg֮]K;Yf=zHM$'f 2GVVV֭t?= ƍ[bܣ cۣG{,@fp`ɉqPTTqF;;= 3^9@f8}tvڷoY 6LpMnn|Pn袢"x 6LKllK/4vػw=^L@fG~'OO6mڜU ËO !3H BQM} }8`=JfdBݻ_cRuXT`M:5iH81ɓTղe#s_%n \O0 )d&)?fݻuWJΝd*!8xBPtf<=+*qo݂AQ|:/`s(d&)9ݿ1qcG+WtT*bb滻;[Z+MX7Ŭ}nj駱]W\)'PsF" 2FY饰kh4x77z tG+܊}8xn +>ij0۹2hݟ81nB~5^G !! Oo2ovt4:z_GrР7?lfYR_؄P;uqv kԨ~.>vlz8P|t  %Ovg;2vZZr5k<{vBw !ݿz|XظwﰵuRjղs'Yc3A?Zr86!iaϞe?O'iD=%+y*qi݂A87HA|zَ %|"RRN<\]];ѣ4G5iX 5nܕ5ׯz(EfL?zu j#Pw(B 3ngWfM?DG!AXɧW[  "Kt^l%(dqZ nC㑾ԩyg+fmUgb* 2bb7kBDQ_vagQ 6t֭  ،ӌj,#%u҄PjpN2 bKș5iXɭWs  bA{O!3H 硈_L.m>d^lMLRbHIm_E͚b)7o&iӴU+f\,geUM?0ǀ]XYG3A3gӨQkw f!i졠 0;=ٟ4Jn݂A2v/`"d&)1PtaK߾\}zxʥkZ|a-7 f % }8`A$BLRP*qŧH!>U ËO !3H B$B| @ Bf"HW />/@" %F=NkF_ڿ *S2gol7 ޼MWBfCQ5~}<3a_ CNyŋyy/ekD* z}QQճhf\s_%, l'=xJF)/c $GtItʪ%*7Mc!d&)9}{&fʰS.&7>⇄`7a[[|4nT{iAAKժY\9q߾˖Oq_tXdժ)>UvR\\(0gpgt6^9)H'^&N_ݡtjO\uRX9uș5NWQЦ޾ɟhѰ^=3)ex%GǺufF#/йÆرysWr ^t'^#%ӿ'IŋǪTwxF4oK(:s [GDaܤ[ǓD6[ЦGT;nNBj3 zs*t;ON-gvBos玠U+6 UThvH93k5z+M;’%^}CÉd.lgh oY ݁ʴNe t31Ҵy4Y39`@ڄQ5jTS&F76t'^#%Sbf4ޅ'3`\^ ##!;~V{םDWC|-ՐެϿNZ>)i%[ÇP7w!lB=X3xiL'P72eGw2N>JX@~gTO9!,hؑlM7@MPyƌaiCScc.}wA;ſ]ѣ*tˈ<ŧ86Q:3vF4o5 @JxEn?hPS~I}Ϊo>Φ֏`Gk|u~iqgغ{kʳwdI[.cSo4a[MjhD-'Mc"* JX@.|*BY |>ebtiC7q*g&5jPr=_iGǺ3;Zܽ{ t'^#%(uf.hj2=6sB~uYs+RF•X7wUPO8kV&My[ܦMSv6=۷8wG_FԞ2Մa!n,a(nX%GR}˖Xq3v'On 8*qpbYf;^CgNzZ 18>NQRfϞAUΏʙ 5;W93/# \y~L݅'3`\pBWj%.^rhʍ337V},77O۫U`!ʻ;ƴ_Rl ؼ+U>}A{/M=)*T(3wWر㗨5n,JizfBeccmaQgӧ/q)>Ut@/PmNY A{g'jRe&_2nW+:22"O ~Gt(uf.hޖ8y(B|G|6: j42ը!&(*(B]NvH}"?7_Ȉb/m϶hA><:p`WJZŒ f)_ԩ հw5oh4G#>UQZRRElѢjRe&EEY=^|k*7/]ڥ#3QxOqm#:Q:3q2o5 @J"}{&k`.o~<4Yiӌ/}^;|~zhkQ!?u {M(O'Ls_%, l'TuCA]J)S|:7/h\)S?"yQLRb,J| @ Bf"HW />/@" %E,^|:^D @J s_%X2t2 A"Jdx x!d&)A(D}8`A$BLRPD_2}۱ !ܔ5kX #>UJ#xDZ xA^v!3H Bɓyyizs۷0s_%X4Ge2@(zĸqݺHp?ԫWMG[ha :ԩBXx, E{, (O^^PGvw~MҴnL ֧O֭Mcpp۲{ڻw9 IÇtI">U0 (x7  %&G##gX o[iӔ ;v,@EC_~م G9OA{2 ET3g8I:{]~ݬ>7ŅvOs_%@Gx2/`^LRbhڴ[.n/Yך^ ES ћ ?Oѣ4N2lϬYAw/ZnH =JHe$*qJ<›t xSBfEF9uP 3f }vX "ޘPkqԩ!ӳg'x9Tm|2YQ\]S8 ?TP?D"Os_%@Gx2/`^LRb͘1 ҳYY?>6jE7 B5ٹ⿡V>W[]@_GvrĈۇ͓'Ocv(2vL% M|:nx!3H "4EEY{M)Maa*5Ofh/@" %E,^|:^D @J s_%X2t2 A"Jdx x!d&)Xe3W2``xtD/@" %E,^|:^D @J s_%X2t2'@|~W0<|:^"/RRoAeW.,^|:^D>3HB$B| @ Bf"HW />/@" %e E /{i9!j(>U ËO !3HICQ G d_ !Jdx x!d&))k(R:?GsreuEMK3~ײ/\IsJZ@Q,9A{A~ UPN/J @J E͟?v^ vFRizKIYP9eFFT˖T*#_y >IүS 9u*TzuH yfF.>hԓ')1(?iWOӧngFQXPQ{s_%,@; mԉ&0iH.AryAljןČX!(ȷL >&4Bf=?7 ZiFXx7_߯+Z)~JLZ]]kk;3!?7rXX9"Q~AY )..4"bR}8di^I2M^:6 ,D*,m,>$tXŋBL 0Q!@YLR;M?jou#P`aQU]1 0|2̙XxoãǎmСe?bxx$; #%e-{&-m-uf=+/{,kѢsɓKgQ:U+5-rTA#b]CJHkܕ2(zt{R Ѿ};'OnfOFj^;4qzu3Ez}M5};qbٳڞg}}8dʕ+)@MN.`;K;M˗xy`jUpGHpVy8O'4Xe)$|~0Q Mf5N?#3WSn*ARʆ UΚ;w;demׂ߿:ujFGϽ};ϯ#{cfѢTݎV{Ju͛]؃*/߲pZiU6׭[kԨ ;LBàԀ0v^z T4R5jyb|֍I*~zz$x:wv:zҮ{hQ*^ 'LYXx HOo{1cgSJ.M߻wmό0<3]УY,p:͟jt3 @ffgW~J2??]Q='UAxAlj4WAYo6_LTCmi 0._ >iQ*nRr\uu֖V=ZRYΝ[hʴ٢ +'Y.С%;Jk7șQC* }oHt3[|a\nVfaY3Rժ۶uF>թk@1M[Xx=a&&~LDBѣfp|x}QXUJ`͛j{f7 Ӱa>7Y,@;@h_.םvfrԡ[4zN$8<ŧd@'Z4BfmBG&U*9u*޾ʉfM2VMXMhҢG^[XTx1evE:mɓ١̍*ɼy#iWFП&*a+=kccMc`43gpJX aر ,,i<0zUT/e͟?uBAE w'OnfN3# gyPdbFe;9ӧʴ9;}Tωgt,^qB{f&jyL @J"'M7X/ݤJ6OfzoAAFF oU]X姟Nر+_/!!lϞemۺ+wE7)0,Z&;@ŊrsSu͚)7m QL= ^ua\HQA=,֯N$%do)?ga:"KYXx:Ş;wɡ~\\GF,MX߬ maor@(, DKy+a2GT,ؑtbj'/.P~5f&:9p NThLD-Z!3HP4:aW䐰C!BaU4 mО]SwnGOivv* ޥu1TU۷iͥs|\aafHa=KqxZ묒N}>ʱ Ye]ƭ[-Ӕj֚B~~ K/矉tAoJGGϥFjIJVGXZ*΢;mQ[X[iEqr7D"cG (\]/;3s3*F蓙9p NThLD5d6yBOm1RBPnjlfթSЍV|EIʫ^D$+nn>>oPB5J6oZJeZiƮ L Pc]ҥ]~bvT   ]|4IĉԇJZzDRA؏PIwݣG;H#GQNE5+HT?B,j`۞0z*% Zm4mʭY3%K=z1,i|faZV,@9FЦΞDm.'3s"Y,>$4Оh`!@dqZ ݗ ޷]& צ;w 3u4OyyiʱAh)+u=}Nǹ۶ SVc?τ_:2уRyOg׊U)M~t?<3qq|fWC^ 56z *#Y|:/E&je!3HI (ӳիD%,:uv-Wì,PNIt{U %&TtllFF>=ܼwo orrǫ~e\W,PNԥY|:.!@YLRb\| @ Bf"HW />/@" %E,^|:^D @J s_%X2t2 A"Jdx x!d&)A(Gw~-0 ?>UZ@O xA6d ϟ9ҏQŅFDL E^, z$x @JtWW mnԏR(j֮]We'li"bԆjΝ"(wkgcY={hٹɁ(-m}Vn5kZ{^e'0]]]=ԩ};'OnfO/(Ƞ`C5NN/Q]iM8R^:<ۨP}-)sb۾}njǺׯI,EG(2v`X@=`\E}bv瑙@7CxXZyLJOA-w~Mw;ֲR >@+c=_~NV[Pt5.SF=ea߽{k( :N)-]P/ƷnݘhfO߱cQo'_^޽4zEEYTޗjTԠk6Voud=gͺr%ں]K ^#{Q ",t/xB[(ʀv"&U"+j|Ⱥ-u8*DDLb+UJ>͛R!2rgkVI-UB}V[wwgao̅Tjma+Ac{Zv;u` (Bxxi[5g2秓J_k ?bqle@EԼ4zI^*C(uKWB(žJ, zO i 0. }BSCY.Tɝ>́ EEY珢zlheQGɓבM:yr ܨii"u"??(?{6ƚVdփs 81@k<0zUu_X^QӧLB _~:oJ1WoOf1QL)"Q ",t/xB[(r\0*~}35MT EOP3Y3ܦ(/Bњ5Sonh5ѣp_ׯ ӺϾ}Rnڲ;E?+kw^}ݹ\PAԏ),׮%R$PE52GT,WP@@Cn]@7-z v(;@ŊrsSPuXa=ŧxApB%^ÒC ׆TYb(Z*tMƍgci5x1~:"ZpST]@,tmۺjkO=Z_=??˗Tf矉tAoJGGϥAjI3-t¢*d5n:o6)SF / z5n>q̆԰ФT* 4"Z۴iڪ[f.KQPDZv*-ʴJ]b,~:VLZi]>q3EDknJ337jl/T]ю螺#h`f *O/(ȠJ|}۳u*U*:JZzFEGkղCvvbH=Ð'TnXХKb*q )>/ z5}}e"P{vraafiZ>}SzuU>??;B?d>ctr [m 6̇QŅrTt<_>UDO6sAB BfݡȔ믢,OWjT:y\XO&*qeS|:^-s2O(y3i޲WΞȈgT99H՛,zO l % Jdx x!d&)A(D}8`A$BLRP*qŧH!>U ËO !3H B$B| @ Bfܔrh͡~}[[[W_u?s&VYqL2eȩS1XPaWs xADP :€ƣ׮]#5S*f^=յqv#X9..4"b`s_%X@@ħ}`BfݡhUC|[Avӛ4q9ߋ~:߸DGizx$k\P g=~^6u=_f};qbٳg2٠]xnڲ^:<yyiursSܡCH lJ,`x x^s28ƅP'vi} tS{t ++k勬r$UˊUoܕ kNsY$~}x ٸq)W />/9 @J }BSCY.T12ePOѿ>"T&&~laQxHдz$~zxf`3a}"AFFxh s W^J@ŧ0g!3HP"`Tfk:TFX-z V}b ){,k]=ݤx ^~E=A۷obcHpZb͚#*jp`s_%X@ AD[(+rxXrHءC!T0*UYXTy3oKϟ+, ӢECEe㭭 aVVnN*}$s'JMO.mHPv[*GoD#G2V|  @Jtۦzm!5,4iz7TLA(<|Bu)]=}zKԀ~gz슍Y۶2Rvc>^z%-m=+dԪeQ*bi)W />/32Ld2Tֆ,TsHYѕ+ ))kYyXbɰa>* 6*q '>/32O G.>յ+X}QQgWQS'k <*q '>/32E("ݸeGkN=>N،C_z6S| 9HtSLRb,J| @ Bf"HW />/@" %E,^|:^D @J s_%X2t2TXBF+0<|:^"P 4.0.0 com.iluwatar java-design-patterns 1.16.0 chain junit junit test java-design-patterns-1.16.0/chain/src/000077500000000000000000000000001312550536300175015ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/main/000077500000000000000000000000001312550536300204255ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/main/java/000077500000000000000000000000001312550536300213465ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/main/java/com/000077500000000000000000000000001312550536300221245ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300237545ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/000077500000000000000000000000001312550536300250365ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/App.java000066400000000000000000000044231312550536300264240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; /** * * The Chain of Responsibility pattern is a design pattern consisting 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. A mechanism also exists for adding new processing objects to the end of this chain. *

* In this example we organize the request handlers ({@link RequestHandler}) into a chain where each * handler has a chance to act on the request on its turn. Here the king ({@link OrcKing}) makes * requests and the military orcs ({@link OrcCommander}, {@link OrcOfficer}, {@link OrcSoldier}) * form the handler chain. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { OrcKing king = new OrcKing(); king.makeRequest(new Request(RequestType.DEFEND_CASTLE, "defend castle")); king.makeRequest(new Request(RequestType.TORTURE_PRISONER, "torture prisoner")); king.makeRequest(new Request(RequestType.COLLECT_TAX, "collect tax")); } } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/OrcCommander.java000066400000000000000000000031411312550536300302510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; /** * * OrcCommander * */ public class OrcCommander extends RequestHandler { public OrcCommander(RequestHandler handler) { super(handler); } @Override public void handleRequest(Request req) { if (req.getRequestType().equals(RequestType.DEFEND_CASTLE)) { printHandling(req); req.markHandled(); } else { super.handleRequest(req); } } @Override public String toString() { return "Orc commander"; } } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/OrcKing.java000066400000000000000000000027611312550536300272430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; /** * * OrcKing makes requests that are handled by the chain. * */ public class OrcKing { RequestHandler chain; public OrcKing() { buildChain(); } private void buildChain() { chain = new OrcCommander(new OrcOfficer(new OrcSoldier(null))); } public void makeRequest(Request req) { chain.handleRequest(req); } } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java000066400000000000000000000031351312550536300277240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; /** * * OrcOfficer * */ public class OrcOfficer extends RequestHandler { public OrcOfficer(RequestHandler handler) { super(handler); } @Override public void handleRequest(Request req) { if (req.getRequestType().equals(RequestType.TORTURE_PRISONER)) { printHandling(req); req.markHandled(); } else { super.handleRequest(req); } } @Override public String toString() { return "Orc officer"; } } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java000066400000000000000000000031271312550536300277510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; /** * * OrcSoldier * */ public class OrcSoldier extends RequestHandler { public OrcSoldier(RequestHandler handler) { super(handler); } @Override public void handleRequest(Request req) { if (req.getRequestType().equals(RequestType.COLLECT_TAX)) { printHandling(req); req.markHandled(); } else { super.handleRequest(req); } } @Override public String toString() { return "Orc soldier"; } } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/Request.java000066400000000000000000000056401312550536300273360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; import java.util.Objects; /** * Request */ public class Request { /** * The type of this request, used by each item in the chain to see if they should or can handle * this particular request */ private final RequestType requestType; /** * A description of the request */ private final String requestDescription; /** * Indicates if the request is handled or not. A request can only switch state from unhandled to * handled, there's no way to 'unhandle' a request */ private boolean handled; /** * Create a new request of the given type and accompanied description. * * @param requestType The type of request * @param requestDescription The description of the request */ public Request(final RequestType requestType, final String requestDescription) { this.requestType = Objects.requireNonNull(requestType); this.requestDescription = Objects.requireNonNull(requestDescription); } /** * Get a description of the request * * @return A human readable description of the request */ public String getRequestDescription() { return requestDescription; } /** * Get the type of this request, used by each person in the chain of command to see if they should * or can handle this particular request * * @return The request type */ public RequestType getRequestType() { return requestType; } /** * Mark the request as handled */ public void markHandled() { this.handled = true; } /** * Indicates if this request is handled or not * * @return true when the request is handled, false if not */ public boolean isHandled() { return this.handled; } @Override public String toString() { return getRequestDescription(); } } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/RequestHandler.java000066400000000000000000000034101312550536300306250ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * RequestHandler * */ public abstract class RequestHandler { private static final Logger LOGGER = LoggerFactory.getLogger(RequestHandler.class); private RequestHandler next; public RequestHandler(RequestHandler next) { this.next = next; } /** * Request handler */ public void handleRequest(Request req) { if (next != null) { next.handleRequest(req); } } protected void printHandling(Request req) { LOGGER.info("{} handling request \"{}\"", this, req); } @Override public abstract String toString(); } java-design-patterns-1.16.0/chain/src/main/java/com/iluwatar/chain/RequestType.java000066400000000000000000000024151312550536300301750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; /** * * RequestType enumeration * */ public enum RequestType { DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX } java-design-patterns-1.16.0/chain/src/test/000077500000000000000000000000001312550536300204605ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/test/java/000077500000000000000000000000001312550536300214015ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/test/java/com/000077500000000000000000000000001312550536300221575ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300240075ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/test/java/com/iluwatar/chain/000077500000000000000000000000001312550536300250715ustar00rootroot00000000000000java-design-patterns-1.16.0/chain/src/test/java/com/iluwatar/chain/AppTest.java000066400000000000000000000024721312550536300273210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java000066400000000000000000000040051312550536300301270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.chain; import org.junit.Test; import static org.junit.Assert.assertTrue; /** * Date: 12/6/15 - 9:29 PM * * @author Jeroen Meulemeester */ public class OrcKingTest { /** * All possible requests */ private static final Request[] REQUESTS = new Request[]{ new Request(RequestType.DEFEND_CASTLE, "Don't let the barbarians enter my castle!!"), new Request(RequestType.TORTURE_PRISONER, "Don't just stand there, tickle him!"), new Request(RequestType.COLLECT_TAX, "Don't steal, the King hates competition ..."), }; @Test public void testMakeRequest() throws Exception { final OrcKing king = new OrcKing(); for (final Request request : REQUESTS) { king.makeRequest(request); assertTrue( "Expected all requests from King to be handled, but [" + request + "] was not!", request.isHandled() ); } } }java-design-patterns-1.16.0/checkstyle-suppressions.xml000066400000000000000000000032301312550536300232610ustar00rootroot00000000000000 java-design-patterns-1.16.0/checkstyle.xml000066400000000000000000000217501312550536300205150ustar00rootroot00000000000000 java-design-patterns-1.16.0/command/000077500000000000000000000000001312550536300172465ustar00rootroot00000000000000java-design-patterns-1.16.0/command/README.md000066400000000000000000000055511312550536300205330ustar00rootroot00000000000000--- layout: pattern title: Command folder: command permalink: /patterns/command/ pumlid: DSgn4OCm30NGLM00h3xR25i7vYpXaxx2-g59zugtTgiZcwIFvGHcV8YSdt9qdBbdYDVR88PIRwK-yc6mqyLVtff4FsoR38XRa7Aye3SgMoD1_RkaQvcfumS0 categories: Behavioral tags: - Java - Gang Of Four - Difficulty-Intermediate - Functional --- ## Also known as Action, Transaction ## Intent Encapsulate a request as an object, thereby letting you parameterize clients with different requests, queue or log requests, and support undoable operations. ![alt text](./etc/command.png "Command") ## Applicability Use the Command pattern when you want to * parameterize objects by an action to perform. You can express such parameterization in a procedural language with a callback function, that is, a function that's registered somewhere to be called at a later point. Commands are an object-oriented replacement for callbacks. * specify, queue, and execute requests at different times. A Command object can have a lifetime independent of the original request. If the receiver of a request can be represented in an address space-independent way, then you can transfer a command object for the request to a different process and fulfill the request there * support undo. The Command's execute operation can store state for reversing its effects in the command itself. The Command interface must have an added Unexecute operation that reverses the effects of a previous call to execute. Executed commands are stored in a history list. Unlimited-level undo and redo is achieved by traversing this list backwards and forwards calling unexecute and execute, respectively * support logging changes so that they can be reapplied in case of a system crash. By augmenting the Command interface with load and store operations, you can keep a persistent log of changes. Recovering from a crash involves reloading logged commands from disk and re-executing them with the execute operation * structure a system around high-level operations build on primitive operations. Such a structure is common in information systems that support transactions. A transaction encapsulates a set of changes to data. The Command pattern offers a way to model transactions. Commands have a common interface, letting you invoke all transactions the same way. The pattern also makes it easy to extend the system with new transactions ## Typical Use Case * to keep a history of requests * implement callback functionality * implement the undo functionality ## Real world examples * [java.lang.Runnable](http://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html) * [Netflix Hystrix](https://github.com/Netflix/Hystrix/wiki) * [javax.swing.Action](http://docs.oracle.com/javase/8/docs/api/javax/swing/Action.html) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/command/etc/000077500000000000000000000000001312550536300200215ustar00rootroot00000000000000java-design-patterns-1.16.0/command/etc/command.png000066400000000000000000000657351312550536300221650ustar00rootroot00000000000000PNG  IHDRH3kIDATxo]$ DU :XTQLTR7PZqzNjuܜ&!1j$NGjEl!OLx7gΟ9ggvv[Wٳ;;;ٙ%A ylJP{w (Xk/΀Ͳx:Á3p+~V `í`[16LfцhW{AOVώ%ۯ:ayümw7p 6ݗwۯ: AΒrYe+4%+wvޑPH$hk;2-_uX蒨os:3gzgC}ykjӶ#mar!`U65tk Qy> guN`SBnW{|-f.#nͱ)No$i\(~; u&۽ey/Wry21xQ"X.Qe .=v|L; vn{x߬C+3 h<`<{U]ߒi+ +:莃]窷Y~i8 *PiF{œ6c5+ bWnۯ6܊_llp+~V ?`_~G_>-i=U5}Cg>|v\X-RR ^xՕIGjn<l،_{}{W;3|vN0MҞ 2`U`6?{ЅﾨK=m&F#3G8;^u&Ƀ''x_|_]xk_gu oCU\FG̖0 479>TnKc4!,sWvL{}wn{ꕿe?ij2}N~UvSό.0gGG1]MR$V\XQ_%6kiof5w޼|C3p{䶝yj&欢.% `F:{jߛ`qxvդWBD~Wuj?>%3΄X["-=Ӫ~9£2 $'`O6wף{0X6 ?`Q`[1+ bWnۯ6܊_llp+~V *)W67r٭o+J`UR`slL4qJ, xócz-2Y|bj-I<'D6[2\ FGB1YjbL[2\Ib~N$O+R'g" Ul!+%oo7 W h@NLho6693b(ϑr;2زg4y֛Ber>pSzk%4ŗQg2՜g ^(b`Mkr:p[z '{1u&}=^򺺨mwF6~\+ԥ5vLc.^tQup—K 5nW&p-Tל7]:" tY  r0_?Bu͢Z72J[Z! `2+E.[b! +{2hP9!Wm-9R%["T_h!lEd)ۉhtPnCDPZjjBL-TBXj vv3 Y&p(S*" Rf+3P3iC*GtPQl8\^DeP!8`e<͒~?YEq P߸yJϚ0^7 V(s9N+nTHI"( I* 7xC5 m*b&~Q!U{V0)xE`{3Ԙo jcR9W&"ԷxӚDy+E%<%40~ϵ+PY!tskYqu9&@W0^v` l*D,qA&Qv>۩Ql ;`[tZ< I2$sl~e) YQ_d:ʽ{\H`Yƞ; 5ѝ^LFB`ؑ)r#hXRW GU[h^ 0ܔyƞo h7;nYDP!T(eŚ M޳5 okR\F{@^e ~\S;I<#wMkWpF`8T<3iY缹6j& `U`L9^Y| y0h_WKx3Ph_ul8Alp+~V `í`[16>Smxʱ,⍤gW<*Kx#`l?T *Kx#`*"3*x#` l*F#g5*.x#` l*F"EST⍤gW&]"XB:5 8nq+gӸ8;{/?ɐcXu8iXSIp:ؑM{|␊l[~*!.J1m#9ui|C-f|e:<>Ih?AW|)뫉~tŕtmk3 (\!Oθp7ρM:: r+WMCI˄LV6X\~V|NOθiI;8 q+Z Gʷ-D]Y[& &tp(.ip#2dg``B`%q^Ǐ`e /ݾfW^?CЎ=,MVo۶Wl-J}]xq׮]9b{޽O^xbFu($CЖm(V9ب#x]AcOĒv6`G|Z#xFu+츔3/5;X0Q]J;.zu׮]{O|^JWի_OO5U lT׽V}PbnrG]Uv!wTN`ۅQ;amrGU`o +YjqG BJ ʠ,5 gm#{v.õM;;{#{DƒrYe+4%+N^ˎԅB"ɅES_ۑi9/䎪.5.#\g,TlY}m6m;!.z >Q ئnm^ js#Qه,`SBl/BƖ{ TVu?Qvio`&_ƎBU-cey/Wry21xQ"X.QA\{QFx߬C+U p:ggB[r#"|r!zţrGU;ϱfsxC.@:T qo.䎪v4 `w.* l;v' B؝0 *8ӟ^%st.*`_~G_>sg`+v!wTyӇ<}5*mݬ;|ͨ߿~ܷ7y?>sɩliw싨 hW/!wT56kg]ʾvxn5> t5F` `ۅQ8y=|_ɷc^S7rIGV1m3;{}wn{ꕿe\}sqO?~R-'[ ]MPƢ)6W&u_ݕj.W]U}۷~ ;o^}y=rcwܼA~Q9[FW=ﾦDp З[7d/mrGU`7qQ_>zΣ{|+?{:|vr;]~|V [5 t&>[_S]+ b²qdބQ8졝εco/<;{'i]ϤEna+ҍS'/rRrGU`_~|w&^뽧o:|}PVt ޯOFuM9_5J!䎪f^Ɖܽ^}OƑG^xe?|j{HeTgH[kJ9*G̳BvMsw}e]3[R]QsN<#I.wMLɕHW W;;<=z]}ߗ>>XWOW.%R2U7֟OЋ!lB6ܠ]Uv!wTN`ۅQ;amrG]Uv!wTN`ۅQ;amrGU7]67$٭oӛ v;f; ` c$‹Әv+Hω$BV_:gP WFCev#ptz#y,{1!wTQ`^.3 ,\:="d 7Woإ͒[jjW0GۗdOmrG6_RKmVqU:Pv^eeqzbTiZ/C\.);hI(7 vQʳB ]aFm1&ńQQڐEoSW6b6|]M ,{Egw<&ɌmUBmzkrGղ."Nh] u&EǛ-]u7q\W4[z$}/.*p\v!wTN`ۅQ;amrG]Uv!wTN`ۅQeu(zvIZ[5v<@mrG]Uv!wTN`ۅQγNgvlU]5UUv!wTN`ۅQ5ӛ kkeWv!wTwH3CeWv!wT { Bjl!8~{06Ka؊XyrGղMq)2I?.`WA-~c3 gΟ7Ô<Fd)`"`ۅQe}mϯ}WN_w%UMt1g97N+\/ʪfA?Uӳꚣ*%"Rrv!wTy]9U /[(fʼ?k?VWPm9soȂm12 <<<#a`Ѽ+nKϵ+(<)mZ]U&>=ϰ_PrlY-M-_vB2#>cZ?/\e մ3S-uΙ^c4Qe<'o{N||}`T%~2yB!{X;쏻>]q5b_lYoنPS*Lo2\Bx2B.W*j¾_5$ ;Ɠ*!ytBb+Nyq]m_nfdcv!wTvǢΊxlaUe qS꽮y|bٴI)!`*¦h;lg!wTv.YJ$sM̷Lo_%{ j_If=XKkӫ{rGJC`sy!ݳ%X{]UGKRYx%y"6߬r_[w`ۅQe)aOt+Kf,ߴ{$R,d4^ޗ\E:66%wD7d]U&.T6dOVM\M\3n5^1V!)kϙvVuk8 nwkWekǐھ\UyQe{AjVpz5B<^HmJ`(klW2Zf|4} Į~mSJ7awK` vG`)}!nmrGU`/ E"Zv:]Uim!V#pnv!wT%vv!wTN`ۅQ5'ؘݎ]U*`ۅQ5؈Җ]Um]߫á Q]U`7A6pB<9T B-JMyH%`ۅQe) P&N#"HBDnmrG l*di$W.A!J"7 SC1T-HW DIv!wTvBs} BlX3 `w.*DP]U l;Av!wTS!wT)ۋ;FPAEUDP3+&\+N^Q|@LxU=`BZ> viYg"p "䎪#08 Bj, Sv!wT-A6 lBZ&:ރ);;݅)6l;Slv!wT6X BllmrG]U l;Av!wT!J' BjQ >PDiOJ +䎪#NT 8^%LnV}P)ءQtxC &c9D_ ^UEPo43)Z8mb$F޲,Nɴc<{أJ nCU&#DLddߊX67.y-fbVkD_ ݊;L`;FPfnP"q0ABy/NW`#*nTO3ѷ,Cņt~>h ՠ(|.w} )Sn1Jd)(JΛK0)yVAE$"x_ U"U|#JP*i} )A+LtMU]Wo'J}WWB`#**Y+Fl;+VQ-;[iHLWL)mc`.* l;v' BڲijD-ݦ^wT4~v*z-ݚջvؤ__bvBKU'S /xii^x[ol%݂r\rm۶Ŏn2dv+ءũf/]t 7敃>J~oIէ~: ['i?6I~@[I/d!DR=SVۻLTO $'O8p@_ `i`[Z"`;G٩fbB&)Ο??M߂Ŋ/CRddv|G[o۶xX* -V'o߾]_ήqփe  `{+Gݺuwk_ZA oeA `ӎ;~gfVY+v-۲eKŋ{eHfv@bXfmoVQ35[jt0={-riW8l?~ˊ8dZ#h0ْR/b5kʰX& n`Yv*!v54Y]h ȓw1m"m'$qlb嘵NE\•._:kB `H:6lBII0ԫ/. V*K6 #L `jk?l/B琋0XşQaIy]Iyq.uCyl.fv4.ݰа\@6.ݤm0Xq&nͪ{wQ[#~ţ}1^cvvG6l16l16l16lq|`o +YjqGSQ<'+jg%t #~{e3tc4зc܎Xm/p ţ[س\Th#Iy]re=LDz#uHraіvdZ ,n.M\*Nm,gV]u3g.v-,6B.\6w ţ[ţQM-Be%}ϒȍhii 8sѭ[-wW;ٙ`:ʙsik/Y:[B+(qL>nbdc<ϟqe/rKvTsŅmDGGUZSYf2}?Q4LmZ=Ϩz[r#+ # ,nVcW݉CLpi]Ǵqra#ݞm8-Q<<8n]5-]5-]5-]5-]5-]5-W/~>oŞNcْ;6N} sz?}ΖO@[>xh|t;ǕkV3d1X\\`S|lV[0-"`SkC_oo|}{]sA΋`S8:f9Y\-"_`F`̡ }Q)/>x 3i2@6w Lsm`IISh8 zՊ3,EȓyO_J8W;_<#?|nωSv˩㯦)?Wץ,?iksGG |EX"g8gj/IqYY 5zD\}|ߝzo־7Wܟǃx^O"6]t\<V+Rx+>sz3Pxb}(lA8Mnz/5ok D@n)x5~ w޼|C3p{䶝y\fG(bկ)&iYoMϷƺa:|gDI@~/R{MqgLgR lvIͣw:sm?׭޹g/yʹO^.,]tЏP"gj8T sDr.|a~lor꩓GA)xD{?̟<#>[*ݲ] mhZRB~Et{{nR{S?S醼Qj+~/-֖K wn|~}fK4s]TQuեB:+] ɂ=ϩl}* YyܥBn,E`Oهwף{0ư\ޑܩzy;-lݎcѸvt((yƁll [ j [ j [ j [ j [ j [;JovkJGv-m8s6lO'6OTL%xn eCso%E,r2ptz#y,#aZ2^DB#WJ37֣)+ƨ}%IΈvcz} 0T ll !^'+2m Me\~r3ͲCܬ1Uڷq9)=Dԙ8G 2%M:f֦\qbtn nĹq9-="KFxWcI Ÿ0oؿmjWKjlo܇fc3'2fJ]~k揫nȅ(z]baH?HW݃yl[q9Y[z${Q<<#ذذذذذ4[\7;Gm@ 5v<@ =@Sذذذnlt/tuذك@561'<_O~02Åf/\` س{祗70{  `H6Ooa™ y{?zNjMX̤GcF+LtCѓ|}eBr{;ػyw?>i`C_ l!jAʢF)dJUhQWkf[SBg.[i/6_[,#G"$ï ix[ taR`uc_ gXoC? -"o1Ck췏 -s<63Cb1VU_nϑRMq/xnGU7j &X5=5N:Ugrr`[>LγnD?!$c#x4+=vvE3n-$Or`w> +Nø=zV9=#XbT"QD)7UҋuUlE%o|]+^~ő%߄7cZ?/\e óWgNʷU(qRm_${`K?k}m>R*%G6o?yۓtc W]FWxn7-[+)^'?Yy={lx 6b} V7+^?-jg%U$ې<@-؝O1f[~Ãg^38Pc7C{1Y=9`w`wxy"leF a[8RO a=hߚLv ъ:o&?CG)K9*DR4ō'L``SQn?Y6%M a>Xт-ȡӹtYjQ~A”Q>y^ܲ`9NAE)xb2E:})S*wbYS2Z"4H)ޓAE+!bx/S (i93F !.ۭxб0\SP;@t|jBy˪Keޑ^1 ^l(U,S`9B狠gM٣>ZM+^NMeSb\̡clyvSa'!Uw#bl*Z$Ν֤_T@WjS_Ҧ:f"1`g'^i&u;b"T kۜ'b(K ۸#,C.!2\֞c|!Ń Zuik*=v7g?jT{kJKYC]"ʋR]Ӓ`˝vۭx/P)8Tg@kPĴn܈^qv| )Dꚦw4WNÛ,F--,|,l٪cQç˕\Vzȝ,lX/SiCN`w`w`w`w8}"#(w3OG.mue4Ϣ-S>DF`E A!2jReZxN~ns=EBd֒Ń8 t8_GE{"#", IxD&!2+sNT avW avW avW avW a!2?sxT4P<"!2$l !2bp`7Zsxiڸ@=dS*ZaRx4A!28Bv;Ӫ3qZ;HJ" DF v}(|{ŋ[Ind$EG!E+@J"Dт+.Z~c!2LخCE˘#N"6v74-SJHIlbUlbUlbU- Qs `GA{`ն=!2:p8l;SC`;} h޽On;SCT@ =^uk׮*F>ɓh;TT"#>[nxb۩BNM^ 7v**T"`7?~TtU# D^D׮]۶movB# Dٳgv*:" DՌSa1!2kv8_/΂ l;Vg}}+Wn`}!n;N}z޽m"%^k7Lϟo;)`/է~T$~NE"K {ѣGxSR\u 7m"e3h2ڵT#P"z+n@5[olٲn@<ѣGNEjYK˰;Sv3Bbw1^T&݌TtR:ںu+4.ݘ~a'Ƅ> {<7`ofK}naf^xJ;o6keKܬMމNydΧĘ-W? o̖El({fUB&Sn:" mSS.mg)VCeI0CeKSd9+2bI[,|rYٔSz'}+H* x}lQeaJRL2m 9KvC -ę-W`WMBV 4ZY sWQ)d.K,ɖĔ2ؒĢ Pf2NTEU.ř-Wo ">ʵX.:τd;P5QfK&o;O&%(FR=&482BN.[D=QfKs9XH:xK¥=;H)[bdh+͑KgK.U MK]^JunÒْ o KF o#KFݡS/!)7 #QJ ~-D;<G)Ѽݚ׀sSZ0zMl{#zT0lEeNN ̔KիWIʟvbS./cuF5ɯ\fʒnXyEny]:vb$&a iTk׮{˼ լAΚmR&Qb<瓙~0ʇo۶@u0lb޽{o__爫zg~g*__ɟ~ݕ_C*qo2vy Fq^aA&~`;l`# st=7׆I,5𸣸 NVf Q4`";,o,v.õM`^s\mV Mh 򊠬eײ#uHravdZ+CmX蒨+1uf8BVՇ:ئjӶ#mar!0Sjk` `zFe:MnDkOM M[p\;uƖ{ TVu?7Q+O\(~; %~ݸV>^bdc<6E&\R)C^ Yc;V '{ͬx<(u6X-wUFD BG5\6Ϝ3 u]j1mb؈{xG Qg`# stan6 v:JOok=%3NG?}||7bm'p>wq6\v:(؇=x>>t󴬮Qi/f6~s'4mEu5zg:6kg]ʱUk\!*0q \ QȓyO_J8W;קUE=RlL@R=Cs`>΍}O,᛫Oqn/a>u,0!7!U՚5݇keUY=/:3 `JP;͇o/jyƇ~Wfm;q民5d,s;|!٘Wn7ԻT;ulVc;9WGyt:΍OӺWyD.ϪbaUͪq 2v>[]s`_~|w&?~{Og߲u_=g\ WUANOu;uloݻgoy_ç`?Qz$$&tQ-ĕQtE7=΍wl ISYHiB]zc^Tk`=z]}ߗ>>^Lk]4Yx5VW.Z!7a v l ўv:صj,Mtan6 v:07NG(R7]6x٭oӛ 4NG m؋+Cml1ƈDUoiUɪ,kZlr7md2I ÁYbŔ6Y9jqv8,WN`φǐhKԷYdN:%'9d;56tRU\+:Pv^eeaD&7˅˲|צKh/1(7 vQʳB ]aZ%Fm1&ŔvKxmη)ށ+qծPM+Cm,{Egwo6\u+ԦG{y%~-􊻔o@!zHǠ(լ8/:o骻rң&wW|q%~́ w;l`# stan6 v:ڲebN=@ NF`;l`# stanခkS Kv:ƞ^F-D=`6`=`#;o:룵 ڛːz!*ds^`v:zR` 5[eIhQWf1CP7" `Z<r38Zj!ȗB7^`#c'覸PQ Sx߅Ԁw!`{v:Z Ns~?mh^q2BԭWD@_.3*j&h]^qy`zŋ*w`e2NG`;l`# stan6 v:jl[aX-LO,fŕX Q56E ytv:JlcHv:Z|vT3ʌ+r yX"nj 0`rlNHi~:9,\Rc6NG`#3k*✭RܸWJUv:0$Z,URftM;SXsIR7NG56A%g%Xjb"R\\iѮ&unG ؙ'I^""ՠT?Lb3&ZW7FLjh^U2GVo\'W ج5lw:i\I.+dZu5s;l⍱% ~I;urHiG:Tv' w.S:v1 u`Z` 4NG`;mr2vy ƆKPc'# stan{z~a=_m`#ww}}h`y~~A5NG-qq;eh{D-}MrAzgΟ7yl) n;Yc_k_}W@!nAwme4kkB!xL^RDB`#}/:}+J?e b!P8<\q+,#nDv:2#|ȅ#'Gؿl!)^BZZnWb"i5 ӑ {쮏}ߟ3/-$V&ʝ U"PfzO+&Co T1Ytd{ַ*M`^<JFpf ђ5P54bkÝ7NG`;l`# st~"4e[<} NGA-7T`Gv"4)ql;"%~"TG0&GPiFtd90ڍl}mVX-ǫNYر(C5AEg [:Jc[6]V-5~#?TNTDP0T)X\k;d%Z:#c"䞭6cYțլp*}@k,Lrǎ-{ %~]T^q1hv}K|t/{Wwl [JP`#IcG`Ov:Z lSρFE`Ov:ZoVw.kP5V<ڜ QsMq`;l`# stano(W|#mA]LtQ ձYJQ!I;5h`^FP1yM=)J6yS_(iT|ɻD _'gkW[&4Kv2AE @ؒ~֖}S7NG&" *%܎2L `yu =m3*%OXȗџ{:%~]Tjz;A%]"zūJ+^~;NP`'kSF& NGAu `ށ]4G m Q`; n~~)7NG=܅o "ܬv: 켺Fv:jQ]|!Ow9=RMt v-ƍ/Y''pj;CRUtdGPVt*Uh! KZ @)v:-FPakn g>y§2 ufȿwe[:[X6pI@C[Y)/y֣ )H(^]a˳&՚lկt;vRTe rF/zzW "ٚ jo)v:2A* H<ņt~>h l^n#%6NG&"ȱȞj+%R~W{$qNyVAE)5@fEH6^(eaD߲̕$%6NG]uTH)"DTU.}UV/)W Y-TUSmt<@%: a WiMvJ؆^.: ct;u l1h1@a)%]6NGi6 v:07NG/NY_s! h}2NGm)e%=o-W~cWjGPa/Ik_o-=nX;v%~*W['9^ϳA+a6[s\.-"@ %/T{i$_g2Zؑ+C5A%+^̉ޏ-66U|z f¯_39}u[ ">8|{}$ l,4eD*TPj̣)?TnTZ./$Z ukv/́ʕoEEMFM糽ȱvJPM`AE[?ur$Ex> Z|h"W@?TKC cb2.Z"BNx!b&=v"JP폻"d0VnzEZHcWR^!v(QY+.WW65Z:w>cw;l#:i `2NG`;mr2vy rtM׮]k;P8uyV_=m' 'ݻo߾]v(vz֭[Y;|۶moVɁ `''O8p}BN\rŋV]J@S믿~ 7md2i/9P8=zO(vںuovږ-[@PYjl<vڻwӧ k+<v⏯uv|  ׺@;y<օ `'(V]FغukɄ< `B>E'}w/&^`M8߽p{!7|Bov߄  }w/&^`M8߽p{!7|Bov߄  }w/&^`M8߽p{!7|Bo}kCsCKGi fU%8BpE#Z;Zl!hh ]<5vVk`o +YjqG;!hdePmxX V`ψM7hox pm}9"5YrY.6l&byEP2kّPH$hk;2-<E&%QWxcpbꝭ6u4MզmGb#E/aۧGЭm+Dmw5*0%יlr#Z~jZhڂrE#Zro61ʪ: .Mqz#yM5+ɅWV{l3*V.>OF;Ɠo:^d%u;: qGW99piȺvi V˳]E!-vQ yD+s쪷Y~i8 *PiF{`yD+4ذGv.B`yD `Gk"-Gv.B`yDE/zOW/vb̖S<.Bj g<O:@n÷O'`|@+9SʲZ#Z߿~ܷ7y?>sɇ=wjlW#d ؉ yD+<جϞ9t/*y߿X-ɳA*qaAc4vVx?{'7ՅνuW7=$W?? ~Vʄnvl!h{}wn{ꕿe{\}s~{>u[X?z'Os fO yD+<ج_y>;xv5mŕrgY jYf J:W0c;vV+5oЙlyn}ΝG0?{sWkl =~;32iWg% T#Zf;7kk_~yVw>:΍OzX x yD+<ؗ_w~==S౗zۚ^b.Vx׿qwWqc?}+oz]uU1v< 97=΍wlFu麑g?]V[`O6wף{0Xq=GZ`yD `Gk"-Gv.B`yD `Gk"-Gv.B o5M`yD+P m؋ yDKϚP&$YA1T'g@.> Zy1urfR5'6[2\ ލÁYbń<%}VzktFd$)^dhӧr\}+R'g7]9 Ycym$vcz} 'l7!hI`M\fצPm*+v^eeqzbTiZ/C\_J#Z*tH ^(b0ݚ@mtzObBъKxmη)ށ+ƮKj즅g؇}.Bњl ]<#!TyT#nW#Z63ȭl[wܓ ٛG`[>Lγx3dfI`yDg_`ؿ܀^d%F+ QMUzr-W:ݘkٕK9QcCG,g=mOɗ/_b5fD}61>W+AK7\ J2z!mPfw96yD[`cyDk` cœM#Z?.B`yD `Gk"-Gv.By 9.Hv(%;GۡDƦvBњ'`k> oniR yDk* ev,F^巳&+٢IMᷣ5a*(YE&%;GNr]bCiDEfF49lZ]M(` l*KyW%W-/DjfhY[Jvp!h; /E3tQܜՍ^#%;GL`;EPb`!z%JBѲtGPۨ1Ig*:}[AR yD.J1+^ԟ+Af Nb_ G+&%;GҲ+ێ%HvVCU)A<1Z>)%;G:v ]<5vE#Z[\7;5m`CP6%n.*IENDB`java-design-patterns-1.16.0/command/etc/command.ucls000066400000000000000000000152271312550536300223360ustar00rootroot00000000000000 java-design-patterns-1.16.0/command/etc/command.urm.puml000066400000000000000000000037071312550536300231470ustar00rootroot00000000000000@startuml package com.iluwatar.command { class App { + App() + main(args : String[]) {static} } abstract class Command { + Command() + execute(Target) {abstract} + redo() {abstract} + toString() : String {abstract} + undo() {abstract} } class Goblin { + Goblin() + toString() : String } class InvisibilitySpell { - target : Target + InvisibilitySpell() + execute(target : Target) + redo() + toString() : String + undo() } class ShrinkSpell { - oldSize : Size - target : Target + ShrinkSpell() + execute(target : Target) + redo() + toString() : String + undo() } enum Size { + LARGE {static} + NORMAL {static} + SMALL {static} + UNDEFINED {static} - title : String + toString() : String + valueOf(name : String) : Size {static} + values() : Size[] {static} } abstract class Target { - LOGGER : Logger {static} - size : Size - visibility : Visibility + Target() + getSize() : Size + getVisibility() : Visibility + printStatus() + setSize(size : Size) + setVisibility(visibility : Visibility) + toString() : String {abstract} } enum Visibility { + INVISIBLE {static} + UNDEFINED {static} + VISIBLE {static} - title : String + toString() : String + valueOf(name : String) : Visibility {static} + values() : Visibility[] {static} } class Wizard { - LOGGER : Logger {static} - redoStack : Deque - undoStack : Deque + Wizard() + castSpell(command : Command, target : Target) + redoLastSpell() + toString() : String + undoLastSpell() } } Target --> "-size" Size Wizard --> "-undoStack" Command ShrinkSpell --> "-oldSize" Size InvisibilitySpell --> "-target" Target ShrinkSpell --> "-target" Target Target --> "-visibility" Visibility Goblin --|> Target InvisibilitySpell --|> Command ShrinkSpell --|> Command @endumljava-design-patterns-1.16.0/command/pom.xml000066400000000000000000000035761312550536300205760ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 command junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/command/src/000077500000000000000000000000001312550536300200355ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/main/000077500000000000000000000000001312550536300207615ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/main/java/000077500000000000000000000000001312550536300217025ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/main/java/com/000077500000000000000000000000001312550536300224605ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243105ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/000077500000000000000000000000001312550536300257265ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/App.java000066400000000000000000000060741312550536300273200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * The Command pattern is a behavioral design pattern in which an object is used to encapsulate all * information needed to perform an action or trigger an event at a later time. This information * includes the method name, the object that owns the method and values for the method parameters. *

* Four terms always associated with the command pattern are command, receiver, invoker and client. * A command object (spell) knows about the receiver (target) and invokes a method of the receiver. * Values for parameters of the receiver method are stored in the command. The receiver then does * the work. An invoker object (wizard) knows how to execute a command, and optionally does * bookkeeping about the command execution. The invoker does not know anything about a concrete * command, it knows only about command interface. Both an invoker object and several command * objects are held by a client object (app). The client decides which commands to execute at which * points. To execute a command, it passes the command object to the invoker object. *

* In other words, in this example the wizard casts spells on the goblin. The wizard keeps track of * the previous spells cast, so it is easy to undo them. In addition, the wizard keeps track of the * spells undone, so they can be redone. * * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Wizard wizard = new Wizard(); Goblin goblin = new Goblin(); goblin.printStatus(); wizard.castSpell(new ShrinkSpell(), goblin); goblin.printStatus(); wizard.castSpell(new InvisibilitySpell(), goblin); goblin.printStatus(); wizard.undoLastSpell(); goblin.printStatus(); wizard.undoLastSpell(); goblin.printStatus(); wizard.redoLastSpell(); goblin.printStatus(); wizard.redoLastSpell(); goblin.printStatus(); } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/Command.java000066400000000000000000000026611312550536300301540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * Interface for Commands. * */ public abstract class Command { public abstract void execute(Target target); public abstract void undo(); public abstract void redo(); @Override public abstract String toString(); } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/Goblin.java000066400000000000000000000026221312550536300300050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * Goblin is the target of the spells * */ public class Goblin extends Target { public Goblin() { setSize(Size.NORMAL); setVisibility(Visibility.VISIBLE); } @Override public String toString() { return "Goblin"; } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java000066400000000000000000000033421312550536300322510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * InvisibilitySpell is a concrete command * */ public class InvisibilitySpell extends Command { private Target target; @Override public void execute(Target target) { target.setVisibility(Visibility.INVISIBLE); this.target = target; } @Override public void undo() { if (target != null) { target.setVisibility(Visibility.VISIBLE); } } @Override public void redo() { if (target != null) { target.setVisibility(Visibility.INVISIBLE); } } @Override public String toString() { return "Invisibility spell"; } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/ShrinkSpell.java000066400000000000000000000033561312550536300310360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * ShrinkSpell is a concrete command * */ public class ShrinkSpell extends Command { private Size oldSize; private Target target; @Override public void execute(Target target) { oldSize = target.getSize(); target.setSize(Size.SMALL); this.target = target; } @Override public void undo() { if (oldSize != null && target != null) { Size temp = target.getSize(); target.setSize(oldSize); oldSize = temp; } } @Override public void redo() { undo(); } @Override public String toString() { return "Shrink spell"; } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/Size.java000066400000000000000000000027301312550536300275050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * Enumeration for target size. * */ public enum Size { SMALL("small"), NORMAL("normal"), LARGE("large"), UNDEFINED(""); private String title; Size(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/Target.java000066400000000000000000000036771312550536300300340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Base class for spell targets. * */ public abstract class Target { private static final Logger LOGGER = LoggerFactory.getLogger(Target.class); private Size size; private Visibility visibility; public Size getSize() { return size; } public void setSize(Size size) { this.size = size; } public Visibility getVisibility() { return visibility; } public void setVisibility(Visibility visibility) { this.visibility = visibility; } @Override public abstract String toString(); /** * Print status */ public void printStatus() { LOGGER.info("{}, [size={}] [visibility={}]", this, getSize(), getVisibility()); } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/Visibility.java000066400000000000000000000027451312550536300307300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; /** * * Enumeration for target visibility. * */ public enum Visibility { VISIBLE("visible"), INVISIBLE("invisible"), UNDEFINED(""); private String title; Visibility(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/command/src/main/java/com/iluwatar/command/Wizard.java000066400000000000000000000046061312550536300300370ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Deque; import java.util.LinkedList; /** * * Wizard is the invoker of the commands * */ public class Wizard { private static final Logger LOGGER = LoggerFactory.getLogger(Wizard.class); private Deque undoStack = new LinkedList<>(); private Deque redoStack = new LinkedList<>(); public Wizard() {} /** * Cast spell */ public void castSpell(Command command, Target target) { LOGGER.info("{} casts {} at {}", this, command, target); command.execute(target); undoStack.offerLast(command); } /** * Undo last spell */ public void undoLastSpell() { if (!undoStack.isEmpty()) { Command previousSpell = undoStack.pollLast(); redoStack.offerLast(previousSpell); LOGGER.info("{} undoes {}", this, previousSpell); previousSpell.undo(); } } /** * Redo last spell */ public void redoLastSpell() { if (!redoStack.isEmpty()) { Command previousSpell = redoStack.pollLast(); undoStack.offerLast(previousSpell); LOGGER.info("{} redoes {}", this, previousSpell); previousSpell.redo(); } } @Override public String toString() { return "Wizard"; } } java-design-patterns-1.16.0/command/src/test/000077500000000000000000000000001312550536300210145ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/test/java/000077500000000000000000000000001312550536300217355ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/test/java/com/000077500000000000000000000000001312550536300225135ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243435ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/test/java/com/iluwatar/command/000077500000000000000000000000001312550536300257615ustar00rootroot00000000000000java-design-patterns-1.16.0/command/src/test/java/com/iluwatar/command/AppTest.java000066400000000000000000000026031312550536300302050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; import org.junit.Test; import java.io.IOException; /** * Tests that Command example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/command/src/test/java/com/iluwatar/command/CommandTest.java000066400000000000000000000103011312550536300310350ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.command; import static org.junit.Assert.assertEquals; import org.junit.Test; /** * The Command pattern is a behavioral design pattern in which an object is used to encapsulate all * information needed to perform an action or trigger an event at a later time. This information * includes the method name, the object that owns the method and values for the method parameters. * *

Four terms always associated with the command pattern are command, receiver, invoker and * client. A command object (spell) knows about the receiver (target) and invokes a method of * the receiver.Values for parameters of the receiver method are stored in the command. The receiver * then does the work. An invoker object (wizard) knows how to execute a command, and optionally * does bookkeeping about the command execution. The invoker does not know anything about a * concrete command, it knows only about command interface. Both an invoker object and several * command objects are held by a client object (app). The client decides which commands to execute * at which points. To execute a command, it passes the command object to the invoker object. */ public class CommandTest { private static final String GOBLIN = "Goblin"; /** * This test verifies that when the wizard casts spells on the goblin. The wizard keeps track of * the previous spells cast, so it is easy to undo them. In addition, it also verifies that the * wizard keeps track of the spells undone, so they can be redone. */ @Test public void testCommand() { Wizard wizard = new Wizard(); Goblin goblin = new Goblin(); wizard.castSpell(new ShrinkSpell(), goblin); verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.VISIBLE); wizard.castSpell(new InvisibilitySpell(), goblin); verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.INVISIBLE); wizard.undoLastSpell(); verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.VISIBLE); wizard.undoLastSpell(); verifyGoblin(goblin, GOBLIN, Size.NORMAL, Visibility.VISIBLE); wizard.redoLastSpell(); verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.VISIBLE); wizard.redoLastSpell(); verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.INVISIBLE); } /** * This method asserts that the passed goblin object has the name as expectedName, size as * expectedSize and visibility as expectedVisibility. * * @param goblin a goblin object whose state is to be verified against other parameters * @param expectedName expectedName of the goblin * @param expectedSize expected size of the goblin * @param expectedVisibilty exepcted visibility of the goblin */ private void verifyGoblin(Goblin goblin, String expectedName, Size expectedSize, Visibility expectedVisibilty) { assertEquals("Goblin's name must be same as expectedName", expectedName, goblin.toString()); assertEquals("Goblin's size must be same as expectedSize", expectedSize, goblin.getSize()); assertEquals("Goblin's visibility must be same as expectedVisibility", expectedVisibilty, goblin.getVisibility()); } } java-design-patterns-1.16.0/composite/000077500000000000000000000000001312550536300176325ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/README.md000066400000000000000000000030451312550536300211130ustar00rootroot00000000000000--- layout: pattern title: Composite folder: composite permalink: /patterns/composite/ pumlid: HSf13eCm30NHgy01YFUzZGaM62LEP7-NwvTTT_EaMTLgoqFIst81Cpv4payv5LVk6U9r6CHGwkYaBHy6EztyvUsGqDEsoO2u1NMED-WTvmY5aA3-LT9xcTdR3m00 categories: Structural tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Intent Compose objects into tree structures to represent part-whole hierarchies. Composite lets clients treat individual objects and compositions of objects uniformly. ![alt text](./etc/composite_1.png "Composite") ## Applicability Use the Composite pattern when * you want to represent part-whole hierarchies of objects * you want clients to be able to ignore the difference between compositions of objects and individual objects. Clients will treat all objects in the composite structure uniformly ## Real world examples * [java.awt.Container](http://docs.oracle.com/javase/8/docs/api/java/awt/Container.html) and [java.awt.Component](http://docs.oracle.com/javase/8/docs/api/java/awt/Component.html) * [Apache Wicket](https://github.com/apache/wicket) component tree, see [Component](https://github.com/apache/wicket/blob/91e154702ab1ff3481ef6cbb04c6044814b7e130/wicket-core/src/main/java/org/apache/wicket/Component.java) and [MarkupContainer](https://github.com/apache/wicket/blob/b60ec64d0b50a611a9549809c9ab216f0ffa3ae3/wicket-core/src/main/java/org/apache/wicket/MarkupContainer.java) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/composite/etc/000077500000000000000000000000001312550536300204055ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/etc/composite.png000066400000000000000000000375031312550536300231250ustar00rootroot00000000000000PNG  IHDRw? IDATx}}]Ua\p>:f1Ы314\WJ2vcZ^(v-Nm+GN i*$cB_f!0q_k>c'OwX{^b *G"+W^4Xx[ hkB" UR1C3h5*PBE@0TBE@P } TC%TP^ri~8Tfb3BEP^rC Y_jPk#TKLy4_/rK]~*Pn0Ab6YCTL+YQUʬ/$dnR3=.[E`5Ct!igr'4{"=Ú'ѵ RS^JMdc8>lvsYe<ڱRANaSlݫISqBOTd^$"S|aM虊ۙh6LN'UIRWM?Stb ITER}yHh}~OJ cS&㱾i;a`?\e"l1(w3_I[E'TOc NjL$ů]/4W%BE P PBE@0TBE@P } TC%TP PBE@0TvZE<:T4**O]حW=c\w dɇՠPP.dOwȎcïo=-!ٞf 4G T TKw|?b|<&43t!~zO;y鵟ztQsZb*\?e&庁O]Qؽ+nFErP`*BʤsǑ'xҝ*ُmW)iL5%|/$T$l ;'-k+5h Dp47ƠU n:$u{iN-,"DN1ieIDP)"aPҮ_h;{"u#Hjֿ_q5ZGG:slk޻efw|!4_ge~RRq1UZ̒,|zƶHi!դ$~&݃h5_*XE'y4:soHJ2$iU^0>[,/?6o~?_Ozx㛯Yx?-\ըUVzg~hT_2ww={_.ɯvV;d+}RRScKVdo.&ufMT4 sdΠOք~ԭ(6Mxm3Ez~IYYgǯb(AH#ŬE^kڃ_Mv^}!36 ڃ!],q-8' TV6 QJ僇i5w*P+X;jk2i^1AH#Ŭu>w5?|XxULGUB["kf6nv IlN/G ]ykBUdjYe =`7T Qٺ۠  sB TBfQ*?P PBE@0TBE@P } TC%TP PBE@0TBE8FB w6߆P%6"aj "]'JTg*B׹+d?8:9ӯb*+ v}!doYNQ-O$(v0SNJWsCÚDuD5Ko1&#f])v1Av|8+aբpH4ݐ~]b+T\YԤHHG<7?,p; JTGJT [EWdL`SNJzӢ2~&"(Q])QM2xᬅr6fw7vªͿV\f{؎eݎlkDJjH+5~CZgJOʊfV\kN hk-AE JTWJT [Ea(;4em9&r<9r2B#>)KkWt˜JhkB*Օ$W,[f6&&@H)7?0JcPU*2~2翴 ICc*bw_X9"a` HESo`D!2TQDVх2$ۢ#/WEY޶"5>XmTlte@*5]*{pH>X'$RׄDBbU U*``[-|l$Syб *|%pOV#3=*bcc6;_3EЕ~g;>Ae΋zҤ5eù05D$)S]+UHeNX5ωcf3y%H.ľW; V*bk]RW [ʀt; doAϏv(@[]顊ԙN0M*@iGSibwy%+O3)8qT&Ŕ5z歞}9GC;".bbi %7;ީ-xpFnmt*Gwcɝ)';ɿd'wREY\dt*=X.hrD͕qހMJLjTDyԊl죊8:Ju JW \yȒ)E"JU=~->s{_/U*b<У(HH:L?T+| I/}T7CO;j$ P֪ a,զf+=TMG '7am‘vk`UER1+nh߃%*hqLu[DEemH2S)*r"JUS[|/{WSGq5ɈVMlUɘi\Į-SE̷ dCqؒd?c&2,51l9hO}dy1=U;CgX*[@9ZĕLyo"JoUlHtlt%TA6ٚ{a4μ220[] i kP;ācTX*@J" *"`>**@rF;39LKP&.N}P0)};PYUՔ҂p챊H9m7lĪCEZ}n=|i߽}w~*‡+g-&ɿmlXP.FQ|]ů+\觊BI)W;ٕ~;?Wtgzbr$PRa5AE.E_=4f W) kl˙vlyuBE:b0A;PpXIyxU;z"Ya/++W0__5pU`e 3:)Ha 99#gWvEzUB:Z6A;PC 'yvk_9$DzE u); *r|l7@u@)zMA25ԴEۙxKam/DMU*TEKfʝ\>j͆E_&Zt@y,quxc5JE?wϽso Jب2b$밆JT3_5eam/-^]ǖǶHaVN +kNU=KF[DW G)C1弭*׵PX&lp?KEdz"SpLшC8.¿䞅Mo@.8EX-<'bQ BE*Rč3}ug4۽ ܁~ȴ0\/vd&;G\ ;ʧP l OɒgP}vXUdJjv{X%1qኃ2}Au X6A;Pҫ+\͐85:Hx>H Tێ^l[ҁ9i&<T'*=:N^Ɛ#MRC"~tXCP`>**@J" *"`KT*&oU[Ȥ})쓆*,Ƹ*&rC\AK|Ucf*BH VEWOu\;x5M<ξ"dDE+N kb됽zPWRE"Gw0kCyIʲϬ|h1ۤE; u :Rpï{U,>^]ᲊuX5u^ST"WE9nJUM=-J>ݗҫ+\6բhWVXĞbh\di*PZMV(e밂N3̞by.'}Mp*N;ND6AA=TMCe|3m k2""QEpv#n:YEwATiqCeŬr3h"*ej`"uSuQ|zXeKpyŽFE-aM"uHN)">Q5vxCEcyJ_pC;W"` P } TCe8*2y4rBE@0T";O>LTOmղ*lUsV# Z1sQ!HW9谊PP)|+]Bj@Of C̙-ȍѸ*3U$JXa9‡ɲ\qpbM~=*rraiNR9G#2N9JU|u}>ѡ:>4ne0Hx:t[3NsQ|8h1]Vnu;器ub:WB3Iqbz&tie~!a)no~<ˇ^-I)LIp-*gpqh?^ <?x| f^gV {t[SՌP5do2#xBLs9 3)meˆ.V&+Q *₮=xxd׶|GT8*[wNb { 3Y钓")|*{u!Z&Qr lWXuV+/~CE:y ͞wܒ7{=p!q*cnh=2[ Ah}nz!yX&{kSO=Cr Gb*@ 0hٵ)@:Fr=KQg ժ0{spMH}7{xЄ{Ht0q0V7TD=x %s1~?8aPٕC4ٸ vmeQŸdseۦ1V=S{᪡9)[3BEpFLwK)\gӈR7~ 經! ?͈.|]⅝Lbs?9^1‹Zt]f&hAE(B1CqefbU۷TP1&'WmO9BEp *Rfa2T*3f;F΀P".eBEp a N*X&Tg4":LZkva ̈́ k ,aKՅ]w ̈́B 3aqw f 6i&"Q]]}IBE 8!78ئ sumCfbT$Xq̉fب,/IS4~KTٳg:tuT$XtMufWރ$k>zp"BEc$ʱq1|`cJM24Kw!!T7A6ȿd';\vyt=X)GzaîD3QEg4p;s F_ѐ1/7g)T/W\oUd^Ce>k ~җA:Ͱ6or:/gd*"(= QP"5k蔃wǏ"֡-;*]J<w$oZ*ػw-[쏙AE tRk4a]:Ԝ6sY`e<*aʕgΜ+yTg;"*oE*ԩSWVDăHg-cn\D"TPɸ˖-{e@E@Jb +V?~==zmC7Gkoke +"-XT*Ǿ}?zyp( )1lذCUW]nݺdϚ5k6oL*Ʉv87 RA"wfdjppqdAEH3td'U  m:Uh3a ZQG0-W>zw=d+ @`(}s6E*$T: 晾_[L_: 9&ԠS#sXِh1~2BE"? B1WC)hEtm۶}!ToA+BE# M+W:uk"^4DڠР"<6U ;&Hc/H"4H!PhtkA>@E~&TtT&`>`pc*gϞm B)TSFQԈP8tPMe>8llfPFET8htۀo_]4O|kJ|˖-uTim .mH8p{yuՑ2TZ Yf׮]+Vh^E]tw_kVA6:4A$r̙oDS۾FA|2F!rF%f)IhL !ۼysw(!>\%Ξ=rʚ,mO#F!lV\P;H2+!hI$Ajm47@2 ($Ӭ*m HȔqI$(tB5 @E9$MyId 2;"/:zjj@E "@)!˗/&-N@Ps@D%M t94KT/H;UOLWv*u! !^[j+o @H uG y:j>\'b2עnMVte˖Uho&@E0&ymܸqQ" Hˌ7xWPw bDK.|_O~ "잷~Yv9ۤFM{l߾#.YnѣG[[oN!عs{kbiEV7h 6i}\}m|4;瀊>"i6hC$ZB\ 3*) 4Dl@ҲePGP}$mI=Ż4D}+Pe @CcP5$MDh8c*4A"{MMj+0^-"@Hۢ R)Wht[4A*"1 @Atj,{U6A*"cU*4A"3cU*R8hWP=h4D*+Tn  cP2$MDhTPihT0+ihT0x $cP$ht۶oG@C&`}@E2 MDmhd@C>`}@E "c/ `gϢ "c/ PC .ic/`4D*hA nic/ &1" h4 TAZׯG!<0 "n{oȁH+rY-<1<-)8XZKZr!?L.1$MʣœXKpd*eBMS0Lh%T'T/T$5kjs PОPP E9GhpTdi~8TfblN'MƢzaN]E`-.챊LyG,k;2iN7˜`?.ZٺD/t4_^ WI&H#ZXKga y6 ;6r"32p!q'sʝiVn9=llNs*kiZR9iuώ&fH{c|IB4β\N7 SZ`-嬥ѵ [v4^7*qWe"Rt۩Kr904'O#kP"lڽ&djT'zR mO0kEWoӁt{2Z5$=F ٞ ӳq6|B};kpVVdg̋ˈGQx]nD̦(w7G P9~`-El"c %H QZ</U= `)Z@{BEBООP~''T/_ k  @{Z@{BEBООP~'_*O]حW=c\w diu ac6葊80ɡ?#Kw|W?KЏHA=6,|҄33A城WbT>Z/*B±Ovk?#?]q岐R4V .6V VQZ(&qJ u#nhHچD8䯟Lɝۏj5ٖI[~ʕU6[K9IQZ5c4ksUPمhGWnru{iv'JR% 2e@sC 69&M[FZ;90| 6VPVU)X٨VFdi=fö6HShO g SZBnZɒPp^>o|uck+OLx1)l]/IV{"E?dvoth؜1SYfXU>2y*"]IC.dⅅ謥5!•w{2%kBqg.y廯t*,b#Z| &][P3Y"~PL hc<2妱Gި<`ϭP~@U] ^rYH y-_腊1]Wo=\+]xSg{ m3.,jF_K%6Q3Sjt/8ژ^ELiTj=fCD(A(;8G8eKF_~bm; WW?_y,n)r. pUDUёGsU$7KkTP_٤<CIKPZO# ~Uz=/<&+7G+yb{Ǿ%ŸJq90| 6Vԣe2Gb-e&p]1JCET\xv%w]7>ww={_.ɯ!nUSЃK%"(ڻm%'~TO)= *⑵2ӹ 8u /]Ms^kڃ_MHzS2I;+,~&vram̤"ͨ"~Y0Y,uX }晾%` Isn^sO/XMe_H!E @T =a-="}!hOX hOH_*/ =a-="}!hOX hOH_*/IEcT}YmjOuo2ka:ki[Ejʉ@_){i?/Rkm\>Zfx<3at;ZRY$ EI֜9-.&Iұﮒ"̍r T9)łK<=ޜ`?RZ\Uyk ld%26T,zVbƄIo I]oүKL$ne[Y?~`-r"O~KUt2Vo+5]4CeSlf}(_Et* RP&z`?RZUDX{#IN!ŷ9g\7cuRlWYa9/~|X Ix~Hi4'Țb\;`utv ZjEkkz+sL/=U<:$WJv+TI1Uy/~<X 9GJ6Ϗ\rCIx.3q":F񫺚Psլ O~~Z`-śE:BU=z@۴XKhZ"*sXKZ"]&hOX hOH_*/ =a-=*l@@ s -eP k9@VO*/ =a-=*Bh"p>}KКОh Z@wBE;k-;gWG^'qK_qg gU5]d=N6ZPGo¯>y5K1y,*DEul lOw1=2(4xk-,|&I.=4^gin(,%LfV,ECn[~!V q0 ZFzd-hY+56Gȕ^uh䝌FskQs.4)ayc>YEh`6m >(w魵O^ᐬΪgu8Yv|>sw6bKt5٘)RI/3A[bv[P0.RM[D*o\m@ESkkiXt3ZT? O~xi 2}#깎1DZhY~q$Vqzt^vg> KWa}GesQ6[by F\rX]T E:^@u$q*X8Z ]NCkcSyK]ȭ=p-O9? 'mRe{gGbu<ʧ"fGD0Ff{ū=~5k]b|j,t 8 :y0|pb{;^ܱΔ_SLNLJuԾ#YlAHoֲ99Id=O=WzX-=[S_kiګz_bd-*rޞk[=m/, ׷B:b۶0R>mjgU=?"r*JWpdܦ9m]Ȧ#]q?Y}b dN0V~qmYmg; wN)h"M8+=+B׀ӰO֪-Iu8YƷ\M_ܽ *7gw3 >K=k \)b3h٣*5bi6EE駵X8uFѸNu8YL߯?d3ɇMӆJ~Oiց,Ht]s*[(nOO]4?1M$;`8Dѱ9Z` ZlOm~L6I\chߋ֢dgFƾo.8 2f: 9豊tf*rv Z֢cFB(dUW_ k  @{Z@{BE@y@P0u0k=!T/ / z' Z@O؆X~#}#^rSRű"0ec]2a/L*bԬ4ͽ)wd} ZgUEmߔ:ib_/˅ҳ G> /+cY Sru*rra€3ҜU3m/B2uֹ옃9zk-S8"6|ʨHxP c),,BmkE9ddLbeyeu oM4́W.]_(^-TFK6Bqs}~ZK3pU\<}/Ve$4T+M22Y(c"26+V?FgC0,2jw_^Wi4 *`iL&K.:=)S"'Y1}9_?p?3wri^P ߩUYPD)Ow`۰ w_^Tuj:DyyTmPrZqSgy-922 e.ܩHYEQk 7<]D WBEC V*5f^>\farP["Gv-E#.UHƆ*%꼺ָɈ˶U:75 ׃ e*+zsTe-S8_>p^O8_uU]4"6'쩐ެu˜hE$팋BӷqM:uRߤ.Sy0uOWTi-S8/O!<|_qH)GsI`_ta EŜI* p!uR/把N P[ZD<e S#CU:l~u4/`Χ}>ZBz%n@Eb>Ώh~0Mo8 ;:TZ@{BEBООP~''T/_ k  @{Z@{"ꯑ(n,Y̷h90fNcmlܘ}ʽw6&z30'NGd-)|JH`u9&a4C3} .Gd-u>eT$pc٫On&_OFn-Ϗh90fNʶHwZ|}KwcNNm!}N7w8z޷t7֡"S 7FNjC4Cn]3'u^kZ/kMEB 7,ʹ7OY-h90fNr^kZz|TdڙpcrQ[0^אG3}st:XK9"ÍEYHw]x\4Cn3'w;zek)"i5yD#}N7n0v:X SREF34g`d/vZ|o*RE34~!dr>P- AuCE@_[ 'T/_ k  @{Z@{UdٲSA Bh"p>- m "qОAvԂzUDb0^mEVFrc_=`7@-(TD9zv zTY::A =`7@-ЩMV B:-DSU:uD7B:3}u` P U^D9zv^*bCo=`7@-MEvHpjT$8BErC1*T(=d>bFWIENDB`java-design-patterns-1.16.0/composite/etc/composite.ucls000066400000000000000000000113061312550536300233000ustar00rootroot00000000000000 java-design-patterns-1.16.0/composite/etc/composite.urm.puml000066400000000000000000000017061312550536300241140ustar00rootroot00000000000000@startuml package com.iluwatar.composite { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Letter { - c : char + Letter(c : char) # printThisAfter() # printThisBefore() } abstract class LetterComposite { - children : List + LetterComposite() + add(letter : LetterComposite) + count() : int + print() # printThisAfter() {abstract} # printThisBefore() {abstract} } class Messenger { + Messenger() ~ messageFromElves() : LetterComposite ~ messageFromOrcs() : LetterComposite } class Sentence { + Sentence(words : List) # printThisAfter() # printThisBefore() } class Word { + Word(letters : List) # printThisAfter() # printThisBefore() } } LetterComposite --> "-children" LetterComposite Letter --|> LetterComposite Sentence --|> LetterComposite Word --|> LetterComposite @endumljava-design-patterns-1.16.0/composite/etc/composite_1.png000066400000000000000000001022151312550536300233360ustar00rootroot00000000000000PNG  IHDRhz!TIDATx]Xh"H`{W4*]7^aA%"b#c%+XQa_. ,={͛;;3wfvn6@ Mj@H8 @HH8 ={6G_PIS:A4M#ӔII i )@  Nի I8 !͐pxP&' \8hPO>>~ir%, '@  _&l:ԩݕ.]y{W}|/i֬T_ VJKN@H3ׯΙ3D '??[buTW8WbnBL\۸q kmیfMͳg{Gv=G)nZXZ;; 'Za#vb]Vpf*{AH%PA]R(X%;sf HDX1EZe6/[6ZC)b/j'=:u<^/뛄5޻/v;]QI™IPI pn4 C|MwP8]A~/[Xys#VVy?+ڌ#Upyt(?pĎ`wSSuWpf{AHxvYk{-j`w&t/YҩP!k4.S(kS'**2֬YMf,p5(_ _8E{5a.VR k c#X;6!ZI™yPI Aǎ7mZߖV.]:z͚{Μ9>_zBRE|*ҥm6{ h3Ƥ +!U|cKpBكJyJml!~oьE]\ ;Te1*^)CDĸ **7l9JLw@ H#ND0( ѡ9{+yx":O޼yZ:q5Sf33 h,P\GG[Hp2(|$0~d|r? H}rjDXc$$4C.I pBAi$$4ӔiBI 3H8MLG8iK;fluv{D!$D%P*;j>9yx֘lngC!ToJGԠ*Qe'!;C/<*v4#ʪ75II?K8;ր NװT?pf)M6#|fS*;d|>jV8xDŽ68p>W_"֭i+/nXbzM>Z<.\X'S9eJo7uj>T?p2ˎwT!sku~uZF>}Ѱoe!ٳg灢_Ë-7|x BƎ3cs{ wŋGܾ%;'%^TO:,muUǗ{ޡ;.lUhTtV膍BƄ!kgA!'ZKKsR}llWmkA==]mrp5kз8ܘ1vm~o܈S5i׮Ç6oD?:x# tt-U,߽{Ne լMVF[ _SJ)T-?W^z|sgT2+wT!έwHn<5#Kqeto.|sO=0(7k<>R㫶v획32=]݋kע-,РZ2t ]6.._a0mܸʐaX^!Wo_:pv|h4>޹Uwϰ_![L)(.cmgAI!#|fS*;dp>ҲD9R"c7OzLhTn|CJMNiV7ԧRps+EԘU"ʿ ɓ!)ܙWmkۄffK _b{!CڱyQFop|.'l"vgFǞxj:Epg(O=))1]4ƊnjΒ?j2CF̦UvxYkϨ^aNמtv [֭F?of¯cSL(wTsUZLu]HN>)f V7lQoߠb@׷.sZܱc/Z41W{>{v-Sml,njE8gA©F>xG28X;no^x?j);jqs,Y2RW٣:5j8n\WN$͝;ձ| n:=5A^^N,rq)q[jXʮ]FubRtT"(:]۟~j۶ݳJ} frNӧW뿳`HL;j]GqI1מ} Rڻ9cZp? O^,j[R_b,=ɞ́5~t,w03ӧ7o~pf|])e. @֕JP-67b֭fs"1Ć3l[%NFH*Qe'zݮOg&>Qng>Xʵ|r?{vjejܳeXԫ#-)zSBIך9WѵDL@GG[TBׯeB''_ߺZAmq̅NE\ny Eh$LpqnɁIzV*z>xp!~ WWGLbSB;a B[>;K&':HK;`9ml'>QF _5gl)B xUfRR+*̙)ߍK lρp96o^r;JfG{ٚM.[."Fdwm|3޽}u 447ݺu}gguS^TON;cxzaWO޿?rV,WmkgrDwBS>}[x.gL&(tMGNxGh> YydA# 'Q T4d*4hP4x$$*wTفS*QeOLGNxGh>1e*MK8بxGLa>!jфS4|h|j y:1TO8FGO1Ƞի|_ ElvLrYH?ԗ/GʉL[~ybP*;({>ӧcɠp^;LT?p&q"2̑l@רQՐp'免\/_~ǯAЭ3g|7p`fjӏY۷ܡ7-[lɒXT':upǎSf¹y*[J*}b2 y{W}xg۶ Z]| bzhfė/k,ںu)Yi~kcFKIlw^ޞg*X;5fRڢi* 5펜p>yu+Qiڴ߭6nRt3\*ցޫ^|+Wc&2L Xך{֣G;Wjy7-GIGomC@UD8ɏxG2wOyիfؿke=+/ԩXÇ/rq'c`Ÿp':VN^i4:/fR)}rpц ! V"$S[6^lۏ gѢ'@ccCQò1 1RK34uj:f޼y\]Aj^[?̆|ll,[uS^S QoĽ(ɓo݁ $?"Uv|2|x㈱gl ceѝ;[!CWߟ޵kJgײܙ&bqrdG-9j0@Sp1]?V3Tn;A(1KYTŋ *uOEN?#&!i& +P`YM\\ L@L8gS0(Y^Xt)S488%0Vfynf] ~}0*u\ޘpZZK~ 2wTA. 1 Uz8޽tR_'OvT|ᄯyx"vDȮAm)'% Y=ZbQ2p $3M9LJ73eo__;vl~((ԨQU7nĨm60c2ź֊u N8ucڵ ޘpWR*;k>یyI,VLiDɎG4e+2[t4_8YBV9￯Š׮E^='p}YYVfh/ϟ͞=em ޘp,^[IT ORh©JK6ypr߼|9/hcmm+׷#Gv1'7iRǎCJ*4k֠9s8;Q ,<Nm1(wTA Q7"*egL 1e*I8JUvĔx$$*wTفS*QeOLGNxG S=DL3)#|3 SYO;@)SH©I/G*QeOLGNMRFx9R*;e>QyniVtlbd&H# &)#xGOj$sΝ(H>S^TiNުY7lIi$1ŋ}SrcRS^T;wbuYĉBLN>͹dI'pРzhX>˒87#OcS^^TTp ZBN>[ҥwԮݬYMv) |W^hky) 7ϙ3DB_ӇGNxGt'#v6Ǣ(i#G{xZZy={5?X-lYP/lv\$IJi2U9r|=ڹ{nX+|>>uPR?mйsӾ}[Y[[4n\^^mg̖7B綶V?Pɓ]AUCCr{!j<i,.lc$D%P*;OZF= +梀R ӧ3 uڜ=~2x ]fǏXرcC5֭X U߻rT`={oo)_gϮ~ۏk^>~~er:{/_ׯo.r{!j2r*J~-lƯ_ܱcVް!+-$D%P*;|G3-ڵ=."(p!ig{bbeΟ_EGOmeLG8MdI;@)SHIT免'L# 'Q T42NN4.*QeNS1=IۉFI&}w̳g.QĒ%KPhذaTTʛ7oѣǮ]P>p@pppBBʧO^zKP~Ç߿gnݺ?,72ѣG$LNJ=3(DQ2G ^z'OPsξ}]/_￣7a'۶mܹ3dkzyyAnQ7o^"EMI}L6 e|:88,^e|֬Ys(}+;w=z4opʐg,}6tЬYΞ=3gbbbn޼2Yfdg>}ʌǁ|Tጋ PJ'N1~!U&' \8hP[=W4,/!a|Ff9&t (j!|lUߚb)DQ*Q%byFa-[\' H09p@ikSx},ҥwUڠ4kVsvY? m-=qH@B+3C8sOŋG{ S\]X#"KȎ3;kk OO#Y͛+;,a٥V'Rjp]F %졌8| ҥKYqA#Qر#+שSEӧOwvv^lٹs眜24Xzμsc^>u*U˖-R(0ПE+9&™%-kuO {7`]?>:,`sW߾0w5n\^^mg̖7B綶V?P 9J(C^YfrP>7NaKmy[t&&z gۙpB,9ѣ%N|En'MJkƍP[;.:?JՉT&M,X08884v-y̚/aGHJL[A`lTZT8Eg/%De]'CF[b-,Vv!]ٳgÙ[ʗ/ta^=_ް?jT'V &悗cju(Ɖw!DٴiSvCFL&tgkd'Çw |-ZkQ™!o+0xp;~!Gd P #^z5ZT)NQY'YǧNTTYڌ6!?.dl?=Nzݶm'iͅЅ5+p‰] b™j.x9V'Rj>}z@@˗22^=T"%sr>~}0E+~-*3P8S@ſ=paLe'jҤ:|ٳ!zN5'"?f*ƌT)NQYY8al۶AkFM揩 >9|NOJp‘S40FtEQ0B˃gիȄS\KNUv|2{`vS:=ADHlT 'ʘ"73ʹr}NhpBΥ< . i ŋ@UzĆ11ӰX]G8U+xրZz-$](( mI^N:o׮!S´|E &n@7R/DQ*Qe'+VtpE9ujy\~1ph%L88ztJlff̙R@Q:/19} ofs&Y5jXM~S%_8uY֊{߿QVn ܤQ߿;c;Gќ|}ߺ{V޸q FeZ(J;nG2))R6 y3WgQ/z +Rɪ+~Sp/?6^@pT?*$; NHq5iRO(-jjeZ(J; |kffS?*D8UY3qaAv)DQ*QeגL)(&fZfo"kf9rhT42$D%P*;|bT?p@;@)SHIT免'L# 'Q T42$g{LYN,VAdRS<)G% '{mc޼y3c䲞e ϟťsmpA^43;%ןwTtјj?DmT?*_8!?O&MTgsuu|`G:ԫ2SzxGj>-NǍT!0©;J,ߺ0F=mXX.nBT8 ߾=,+׷!&tt޼@]Rf9{ &w\zXfvJ^ޔUv==r#:pR׷.7P jYHјj?UQtU"ݙE kD߸cccf+D(`9}zeF3C ӑ}YŊqvԄ3FFDhQ g½S3jdf&먲e.2c)>~)q q0,@&ǯy|\q1~$'cQ_,{]iZOWzRݙEs kD/X03r86HiuҎZ2hp7nr!0½gNMQemIYml:X&VVyY%TZ:_8u4q*N瞑5Fo1js@p梹ȅI̅5GpaN)5.#K.\FcG~=tނFw<)y0y:m>1I)S6BK|Q3N"QwTفS*QeOLGNxGh>1e*I8JUvH|[]cq*I8JUvH|wh>UN RHi\4免CJ :f|o {SxTp7͛'_>3F.yg?4d/4o:#ԑ^*^z'' \8hP[I2_$wT!s ~}Ӛ5}n11 ^?Oիʋu V {6ߺH֭ -o|׃7TgA2QS{$N. "s/w.]y{WeyHf5nG Jɼ=M+Qe2mK= ;KŊnQQ!`Bq q#}]dd:6kfK#}g\??/޼jWYst?N-oVWh;{`ȑ|c"H[րWOpww17]BS"X==]lsApy\$i޾=,L+{_R>}6n*mN}Pwnzm)S߲el^،S@r*_3&7B綶V?Pɓ]8{`o5UvHu>9Thx|͛tq)s/_bݺI#GvdAA=PFqa8! d+B{h162th{Dvi͛={dEl9>/Si{Vߵk6b Õʔ)lccC \￯R/av-l {GbZy#v IfJjΜ!m6I<{g+1BU@0 #8CŔ^hp"*ue5…uL8E7-:rѴE{pڨHBf5&TsӋ  h3O!|(cH߯,#{~J NQMQemɞ[ JmBDx8BgF#k,s'3W]\ !T:D!2-*1zhz(SRRJ6Yr7mZ1+9.lÑ%`g\T#Ne]ж:&:,\cÉB gc:;p=/ysܕT?%=V;\1`cϵ@wF z.FTC+LXf;gAUkpXT*m KYpn"|iu> 1|;t^6HmM57pqp6q;vepfؙ_ KTS[?A(ƛ%_|v>sǬb6/n`cAHk@Q )bgά)Z4e6xb4i#Wlp@W*\ׯo:y2%0d_mz޽ȑccC+(az9i gPw.;>SLf W q1|gaNNvT?%]"Ѯ*QLF1Uj`xEDkР2 q15gfPUD|y<JS^E&HU8E#`GPvRW 'pۅKvgfy-tv&/P_㌉*X;MQeI"ɷsbiܤI=[–-aU͛d6J}ㆵ$+D©K+pjT(CjMԝ 'G.\S4~ pԨNŋ;@9fLgN+aiAwaXD|a9OtS4C۷ GvmOvvAA=Xa:ߍUr=!B.rȔ$0_cCZ/1WZ58ľ*ܼy:k0Ng!5z{WeA("7˗/O@#eOAkaɒ%#~]gD l*SN+D֟WA05X֭Xvܸq F&RhZySOwnzιG {1#'®Dt^6^*;~DGPtQݺ8E}g#Dlm@ ["Ejiu,+=/jذTYxw#Sx t":I—EueP1hP*;{>XX%2"BIĐ:nxp_f؟UDe䦇11ӲrwT!ɇG$15w֭ށ S*e)D免'L# 'Q T42$D%P*;|bT?p@;DQ8v/{v yWB/"--8Yf1sLG8 PHp#01qYc7($fdp~/y.9s\i͚vv˙7oVV5{w?8{l=.Rľulszh~۷ֲ7N&%4,{A-^ej-ږ>zlNݢBX?1>ot^ Bvff)Y\={y%'ysUOCD=}zsA # '@  ) 4UrJ@kB|VټyzHH@ʗ/nݤ#;ʠ(#q#߿[ez5}ݶmFÆUme\o'';,:u*3ۻ֭3U6+V8GoJptros%K:yyUصkl|@;s_bD77G~-W81c:/^<q$LլY.66-E'Fu*\ئEZ3g$K$|5*U5N}rtr#̱BJ]],vRT)Yc^Wt#GC!*^t ։+ Yl1kC?xp;t?%|h{͚5+ݹ ^&|^䓱reCAi}UThmc iu^>x\%{.gmhh?W ̕)SzK$ny TVKFP^\~/ZK-Г>*?3Y* "dR4Aq+UrGR'/c^U/9ĵ e3&| uk1{`lرע%\ "ܰ!b){5KOM™yPIM8,pU= Wݚ^P߆f Jn3 VVyo܈QEJ]eOBuqP!kw Vw=ZŲaGEM_֪㴖mԩU G3[N6 3Ě}:=Yh!9g\m`ݺIgϮeqJ3:_II 6>Xg3w*osٳgm^:Xձ2*!K̙5Ebi#׵kX* NLI6 euuuD~+ 3gTrm.66frwgfLU`E~D0<|mo=k :w"dsB5ʖ.X0Nr$$tBǥEXk. X=..I=YJ-[Z j޼&nC\9?ϝ; *WnW:<}z5TivǎMf0PD|&BL!Cȋ#fi ͛ɓ]xD*u8ZT'47ynzMTON>Yz{oD*UJ֕\2 +NrssӨ<}tɒ%Q/WҸ *d:@I  E;1Ռ:dH}[AJt]ۓ]8{PP`ذwcCg*v+?> rqA'p2pooڻw=|PEI T5]Tny( at0))SG:=a]Fȸ|^԰a=GH?-Bs  -GY}߾}?|,V؀_R m.^ظqc ͛˖-Ȅܹs]tiڴ)۷G𰴴{\ps΃ <|wv@ t -oB,,*D(xR㝒ۓILp>z&"""11Eśp)S`QN|}S$T{ lٲZudy9rرӧ勌DڵkסC7|3i$Tӧyi=@Ѝt G$Q=۳nݤp2}¹qFD|޽gBj:Ė 3<{Ӻ('N%:hy JJ.QIǏ[ZZv9!!AgTTЪUN2EQp#Sږ~znZ Bb͑p 8x;vA,~Ɨ/_$ '@0:5P_.E˖-R(0ПSp"贲zуꩁ0 $l9K_/ Oj4.b#;>W/_89r|cǎܵS&DDd9C^܏աy3c'cYҕYݸ1leFߺkaaj{CSvqyss[A=<\I8u Nn"D}vIa@I  mkVۨ!.+*53g,뛠?A8s|k"R,Sw9~;6aXgB&!:={`.&6~r ť3g gkBBˀ>~(4H8 M8sLjr0dʡ)|Epzzr_5^ tss '￯b 8ጏ_O̩R?(4vl~O͛7k܎SBwϞ]mn\J$ '0D Wڶm[\9D $6tٶ{m#O|Ep"d4ي!t"BT(m4ܾ}KGkm6{ |??JPS9B N :jb@K B_5@ .W-miND9syyU8rd19*/e[[+i[FZ,6}&sa X@k۵kHII  6RN?ߛ ;6a56pe݄&&jtRR< OHI iFF^#3ug1kڞm\TL$fdD8=3PKgtTCI/_<~8 $ĹsZjelӦ۷WIN` شiS:u .lmmMi_8={foonݺ6޻w/dfPN!$&&N6 ? )Sܽ{jnݺeii)ӧO^^^cǎ 8t NN;w{,{*u2Fav#4e/K.駟XͻwPm|W\k 7~N6pWee"D-ڿӇgF0Y:W^&99nsH8 x=Fbů_~ժUYf v^:9|%2c[ @w.P#GPMhg[>tڵsr֭[ĉkժd/G;;=z4[za,W0*liիW׮][ҁ5kָQ%m0g%d6yupp_>D`;w 24Ar@5ډpZ?.]ǧJ/~c_|BfbVlم [/gY<Af@ H̤˗Gi̙3}}}JO \+UT8U9 6z-;;ÇO|t@dPZCk^rԦvk*oƾd*N(:/χM'YǏ+Wnذa+٧O={JkFikDϙ -[ ACƦݻwK(¯?)Uko f'뛜d!c BڵksΕڐtB[p&[hpVLJJ] 2ޕ~y>dl:@ _rԆnn58+ov>}P6m`?! p)[[h I?hjd7}~m63 AC #z?5jDFF~Zc;nݺMb7%1!AC  v}G?`aaQVs *_.bZlԖ`plAttɓ'6ĐظԬY3_|Ll(Iw}T\Y^ٝ҄ &poUbbb4h N~nݺzqdɒN ÇVVV= '`񣯯oӦM1JmK&ٳEڊB׮]̙#&NtFIIIRےVdWJ0!p&W^ժU[n_~ږLG"EΝ;'/_ݸqCjCL$)ӧ˗4h2ɓnnnR[  S '`rx YeCN8Qj+2'NPɁ񀄓@0-ܺue̙RE@Hx% t-Z̙3R[a $L/_.\ҥK6$_lY ?^T5Bp?nR8pɓ"+ΊLᦵ $Llllm&!Y_,XRE(_ÇB $}(PR8tPŊ"0cƌP>H8 c˖-56D;,,Lj+˟?_g!9H8 %#22ٳR"|8R[]zpŋ/ {VVd5,Y/  'L-Zн{ٳgKmEV#11۷Rdp رc>|(!!)))ߗ мyuImAI ( X""m;vSVH7kLj+ NA9K׮]kժkm;v\pVHoZXXS@P>}?6jݻwR"1>~xԆH/^Xj+ NA x}ӦM}}}!R"=bcc{;v]V($͛uv˗/Rbh۶eˤBJ$%%Y[[߽{WjC NAxy*UKofxSߚ* ' c}*!T}QjC~~~R[pƈ_ٳZj/_`;w ūW,,,J '`t߾}+-@Zv)FVZ\Rj+Nǖ-[hт.<{Y[['%%ImQ#&&AR[pF}vtJml0s̞={JmÇVVV=%@0|z=zԶ UTٿV]v3gV($Qɓ'ʕ ֭[J9=o>dHm@I H{(Q"88XjCӧWj+^ћ42NAb`"svvkhC9"A, $ğYP+VHm,qU{{{%?N8& ' ~w;;7Jm\iR[!3-Z̙3R[!opѣ _6D(UǥBf?~aäB $$ݻmll>,!2Ɵ$˗ .,!2 'شi'6D@4|p%<==鉪@RZR"{>}Zj+d^zImAI dϟtU =ŋKm\q]zoF@I dL Ν;R9rرR[!cԩSgR[!WpYQF-[^m(8;;_pAj+d%KKm\AI d.WrϟKmBp www7-,,(k@I d"|ҩSڵkyFj[!CL4Ij+d͛[Nj+d N!'??ƍAj[D rԆׯo֬V$BݻwޭZg 8P޾}kaa(! '`x~v]t:uV(۷_xV$ٳ0jfpD͛RرgxR[!?păƏ/!+U$ARRݻw6Df $ [n)R" ~^âwޡR[!3p˗å6DsKѣGa@0Μ9SP!W\b5jԐ !99'|.]9@(޽kkke Q8v:w\P >n8H8ٳg#8Raaaz(>}zԆ(gΜ)ZV $F * S}m۶yyyImb~q $r! g֠CWCHHB6 7Rpʅ$Y>XZZ>yDjC7n}EjCy#ի`@pfbbb6l( GժU+Br|bl:LN>͹dI'pР>C}|rK& gM6˗/ cܹ]t y|Hyk֭3N]ipҥwqJ{#͚)8(ѪahKhMɩ0z1A`]sj;OlG~ }axq^^n+Rj37zn[`TUJF"MG01{:[\\tHHI 'Q=MWA)0.uiC9>slF5hPQF.8Ax=]ը\43f la fjv^`H.?~h% 'Q=qZ DAbǺS.Yq8{گh.<}Drtgs׮yoݺd{PD GRŕfj1ٳƍLM5O 'Q=qZ D ɦo-fwX}d릣;cVxzA3+ٳ!'j `d?.Z8=~}kTOpDza}W~Tg,@ݺgЮKߐ wDC_jpgltQ-F+kp@)0;}ښݕr.\4wיj?$=zf6LU쵺2eJ`UK#!a8ywEPC$ 8NgB:m;g!'x.~|`hUfxfa2.\xl]c_~9j̪TVw9xpݦZ8WNޤzNFJ?"J\ P=7Y0ԩwI "N v ܶ=V | ~FkJN9fժCz?dUbKԬEi&QVuܺd@||$+u?q̙-Zc.auD f⼺89c m9;W{7ve.h޼OݦZӥCtEg&پVofk9~| va]UPpay^ڱcάYC"3q^D ?֓/&N"`[GGD"HGFwҤY,i++ ~ QWLuh Z:thbO>YkɒDƩ߳y ٵkަM3A(B_Q6Lǔ(88*I.Zlr Α?ٔ&T}x1qܹtG!=u Kprm"]P+" 'Vh +rʔ)ѨQ u"Nt،=$\t||o|GH=t"~%Ju2 06Y$/' >j͒%?DM$ڴiMɩc= bt5FJ9MݾݪU}wb?lCb}ᕌٿL"NCՇ돕f- X"a9rM3g8ңGǰ֜ fW_gɴ%,N43Mɩc= bt5F>QEh2 MU^E֭H#KWH mblD'q>_{m{ٲeP$f7ḿ;Mg贰q woe=h*fSzj+rl[6u ٿtlHF*XYbIC`rh۷\>8}aú8z||,:jTOGH텄eo8sS;)h*fSzjo ?۷/۷}} !rΞklZnUZ9Evv 6wq>( 8GH%q:D~Y.d>d'։b89~gq㌗_~n͚ڵËSr1Ճ}hѢ#NȖ-'$Z ;eAi)q DӲ 87Gׇ.kҤvCtuC`3;;E J2Çw/VHOzKK\zE{ esؚ~ڷk$}Ny"B] үT7'KVnŋJJMtjFM,y^:sfN"4b>[}oqqmۆ# :;z<ZqZS=WPЊy q? &wIU K;~ju 2 ΀,'+uLjڵ ڵl 6} 8- "NKSy q%ęQ@]cYKL޽Ó'@~Rś5 Yd#N7Ts8z? 8'W5mZi֭e/ę6FJ_~;p N HD@)W_/\#=bijS ٞSF8ɢ0c٥KUsDS<"Az9HqoZ`(A~QQ^@NHHݻ$Kvկ_NP;gP?qJn`rzү'sG:S޽{7. ,8-"NF( ,8-"NF((qJaWذʔF{~j08IS!$Ζb&uiHxRX F'+q Dĩj޾xs~]k5MN M"NSpEKe{Ϟ݂&M6^(P KF-;;^1cz}yڏ?nG<949zS 4[{`;: >n}ءC;wzJn޽KBC˕.ؠAcָmwaMb]A)qQ̙Czd{-ҥl+ܾ}vJs 5ia.\xWDywB>$ylP~ GQn]" ջ_\bŊdfƮ…*W.RzA7AwB^ҢHuGװ{avu^zy+b%a_`#ʔ)q{;w||,/./TٲeVZU12qo߄kDX̧~B98tWP29y(rwoXjׯg*UZ}S'(ӱc3Au1幠W Gqs?.3X18 j-t?9-ԗĉmK= =~|:"i}mI]׸Ġ-t{q/rg=sk8oZ6r $HaS+".KD22m"*NOl@Rt fb\Ό x 1YEWvk,rKs+<WTqϧSݧ{p Gqqt9/߳Mpooݨy);U_=*/)i5&1v @\!N$L#s{ 8jx^/6iW kSBII}QQY s^eaLQڵ `2m嗌;w aUR(Q" &2Vf1D(8[^˗O/j VW`AR(O*/)i5&1v @'N,L#΁[gH關~h?2` RUllV8yrf q?XܼX"WDap &Njݺ!K SL.]eO rfk0~_|Y3vG a bsA_ql|+=zw >)-ɂ _y)4YPiVQIɑ I ]=8WSQ [7g|9߈[k*,֡CṢ7ߜTlqf[#/OoT߉[dlpp RϞmdd}?\&DS+*W.}q#eE ,fkmS6BqT#'Ŝt:Yh͛C;qZ D;^҆:+ݜ՞ ΀,'+uM֮娞'>N8-"N/iCʕnjh5$?'@>Zk,#sT'ݳPx@)%mSY|9H&δ5jTbX;vaM'ݳPx@)%mSpsV{Fk#;uj.ٖ]Z5gI&NFo{sIôxDB,ځS1 >Oܜ՞њ@o+t'T&-`tڲH? _>??_XviMX[n('i;.>;<W=WꨛSyZjs^F…wU(W.D~BA5kHx:}+Z4o7Ԕq9rOCt"NoWGD )嵛s3keu@s׉oD>$hN/_~OX03(ٷo^ꁵBXX(*)b :k+ص J&'T/ed,[*KlhQrYYc/qv2e\e<&Mj2w;EnH>)ZTXj3ˉ~uMɩpN&gIд,E||/dbgN2ք %7m@Latyqa֠aUGܰazaWf|"EN ̙C`gǏeӌqz/V$@`ߪU;PЬ.)r04{̙ͩ:thv=S+VLɧsmf`M#N/?Q7'B) $=)դ+E{W+W`LXJZh˄dε|n!7{J_G={4dld@'/]5H!XY].8fW8G@(u FC_n"NNSF/ .HO/.^RUY/,,T$|e aߒPXnΰ[ ޽{h~!!EGxQ& L_3Ȇt߰S^d0GVfue\u<'ڷY~iH>qzv: IM:&T8Eię>ʽs_s^e>̻-]ÊpҰ#jÊ1]ai:GŊd !7ӧ՘p||]۫<ʸ xXv<|: [6$_uqr*DG[gUR[gU+ڼy&lMBB{a17Zn3C$Ɇ@K\ŋA6GAuXC)8.`ide^0ys_ٲ!eʔ`:5$k``)cΣZ/WQ7'beK䗃6&gVucwOa,J,[K\\2r aZSXsJvOB@0֭ɬf,fX={oN$BphVWP )*ٵkK~~K -ٳi/~ѯ89 O)hmoe~ݩI~ (Ngfue\i rG!r_uqr*%;o5c(rO_3k"NE8q6oiA,.i4'NүB^ҢxIsE3a=q @KZ/i"N˂R @KZ/i"N˂R @KZ/i"N˂R @KZ/i"N˂R @KZ/i"!a.Lm@q k"N%A"N3c_0`)I23Λ8Iy_uqr*%;o3c_0ٳ[V*f/10+~uMɩt!;%C>Qk&L7)iˑ\DDԓga+~uMɩX/)P D72a%aYr+WvÁ,ݖ< Փ~Eѯ89"NQ`&qx){XXXݻ+`4Y(+~uMɩqӈSlݺa( (ceVpn{$A'_uqr*D4.Źs~~v: #co!a gGB[zү(Q7'B) |T+VX%(W~ sޖu4Yع Փ~Eѯ89xIr@/pзߞܹ# |8u8 ;j~h TOE:&TKx6;b_ +~uMɩ&8*Ǿ0?a~үA)(^\wǾ09a>q~="NE8 fÐ{@)(^D@)(^D@)(^D@)(^yN`w!"ZG&T|KZ/i&N΅ 4.0.0 com.iluwatar java-design-patterns 1.16.0 composite junit junit test java-design-patterns-1.16.0/composite/src/000077500000000000000000000000001312550536300204215ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/main/000077500000000000000000000000001312550536300213455ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/main/java/000077500000000000000000000000001312550536300222665ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/main/java/com/000077500000000000000000000000001312550536300230445ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300246745ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/000077500000000000000000000000001312550536300266765ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/App.java000066400000000000000000000044561312550536300302720ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * The Composite pattern is a partitioning design pattern. The Composite pattern describes that a * group of objects is to be treated in the same way as a single instance of an object. The intent * of a composite is to "compose" objects into tree structures to represent part-whole hierarchies. * Implementing the Composite pattern lets clients treat individual objects and compositions * uniformly. *

* In this example we have sentences composed of words composed of letters. All of the objects can * be treated through the same interface ({@link LetterComposite}). * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { LOGGER.info("Message from the orcs: "); LetterComposite orcMessage = new Messenger().messageFromOrcs(); orcMessage.print(); LOGGER.info("\n"); LOGGER.info("Message from the elves: "); LetterComposite elfMessage = new Messenger().messageFromElves(); elfMessage.print(); } } java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/Letter.java000066400000000000000000000026631312550536300310070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; /** * * Letter * */ public class Letter extends LetterComposite { private char c; public Letter(char c) { this.c = c; } @Override protected void printThisBefore() { System.out.print(c); } @Override protected void printThisAfter() { // nop } } java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/LetterComposite.java000066400000000000000000000034431312550536300326670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import java.util.ArrayList; import java.util.List; /** * * Composite interface. * */ public abstract class LetterComposite { private List children = new ArrayList<>(); public void add(LetterComposite letter) { children.add(letter); } public int count() { return children.size(); } protected abstract void printThisBefore(); protected abstract void printThisAfter(); /** * Print */ public void print() { printThisBefore(); for (LetterComposite letter : children) { letter.print(); } printThisAfter(); } } java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/Messenger.java000066400000000000000000000061321312550536300314730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import java.util.ArrayList; import java.util.Arrays; import java.util.List; /** * * Messenger * */ public class Messenger { LetterComposite messageFromOrcs() { List words = new ArrayList<>(); words.add(new Word(Arrays.asList(new Letter('W'), new Letter('h'), new Letter('e'), new Letter( 'r'), new Letter('e')))); words.add(new Word(Arrays.asList(new Letter('t'), new Letter('h'), new Letter('e'), new Letter( 'r'), new Letter('e')))); words.add(new Word(Arrays.asList(new Letter('i'), new Letter('s')))); words.add(new Word(Arrays.asList(new Letter('a')))); words.add(new Word(Arrays.asList(new Letter('w'), new Letter('h'), new Letter('i'), new Letter( 'p')))); words.add(new Word(Arrays.asList(new Letter('t'), new Letter('h'), new Letter('e'), new Letter( 'r'), new Letter('e')))); words.add(new Word(Arrays.asList(new Letter('i'), new Letter('s')))); words.add(new Word(Arrays.asList(new Letter('a')))); words.add(new Word(Arrays.asList(new Letter('w'), new Letter('a'), new Letter('y')))); return new Sentence(words); } LetterComposite messageFromElves() { List words = new ArrayList<>(); words.add(new Word(Arrays.asList(new Letter('M'), new Letter('u'), new Letter('c'), new Letter( 'h')))); words.add(new Word(Arrays.asList(new Letter('w'), new Letter('i'), new Letter('n'), new Letter( 'd')))); words.add(new Word(Arrays.asList(new Letter('p'), new Letter('o'), new Letter('u'), new Letter( 'r'), new Letter('s')))); words.add(new Word(Arrays.asList(new Letter('f'), new Letter('r'), new Letter('o'), new Letter( 'm')))); words.add(new Word(Arrays.asList(new Letter('y'), new Letter('o'), new Letter('u'), new Letter( 'r')))); words.add(new Word(Arrays.asList(new Letter('m'), new Letter('o'), new Letter('u'), new Letter( 't'), new Letter('h')))); return new Sentence(words); } } java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/Sentence.java000066400000000000000000000030131312550536300313020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import java.util.List; /** * * Sentence * */ public class Sentence extends LetterComposite { /** * Constructor */ public Sentence(List words) { for (Word w : words) { this.add(w); } } @Override protected void printThisBefore() { // nop } @Override protected void printThisAfter() { System.out.print("."); } } java-design-patterns-1.16.0/composite/src/main/java/com/iluwatar/composite/Word.java000066400000000000000000000030071312550536300304540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import java.util.List; /** * * Word * */ public class Word extends LetterComposite { /** * Constructor */ public Word(List letters) { for (Letter l : letters) { this.add(l); } } @Override protected void printThisBefore() { System.out.print(" "); } @Override protected void printThisAfter() { // nop } } java-design-patterns-1.16.0/composite/src/test/000077500000000000000000000000001312550536300214005ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/test/java/000077500000000000000000000000001312550536300223215ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/test/java/com/000077500000000000000000000000001312550536300230775ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247275ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/test/java/com/iluwatar/composite/000077500000000000000000000000001312550536300267315ustar00rootroot00000000000000java-design-patterns-1.16.0/composite/src/test/java/com/iluwatar/composite/AppTest.java000066400000000000000000000024761312550536300311650ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/composite/src/test/java/com/iluwatar/composite/MessengerTest.java000066400000000000000000000066301312550536300323710ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.composite; import org.junit.After; import org.junit.Before; import org.junit.Test; import java.io.ByteArrayOutputStream; import java.io.PrintStream; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/11/15 - 8:12 PM * * @author Jeroen Meulemeester */ public class MessengerTest { /** * The buffer used to capture every write to {@link System#out} */ private ByteArrayOutputStream stdOutBuffer = new ByteArrayOutputStream(); /** * Keep the original std-out so it can be restored after the test */ private final PrintStream realStdOut = System.out; /** * Inject the mocked std-out {@link PrintStream} into the {@link System} class before each test */ @Before public void setUp() { this.stdOutBuffer = new ByteArrayOutputStream(); System.setOut(new PrintStream(stdOutBuffer)); } /** * Removed the mocked std-out {@link PrintStream} again from the {@link System} class */ @After public void tearDown() { System.setOut(realStdOut); } /** * Test the message from the orcs */ @Test public void testMessageFromOrcs() { final Messenger messenger = new Messenger(); testMessage( messenger.messageFromOrcs(), "Where there is a whip there is a way." ); } /** * Test the message from the elves */ @Test public void testMessageFromElves() { final Messenger messenger = new Messenger(); testMessage( messenger.messageFromElves(), "Much wind pours from your mouth." ); } /** * Test if the given composed message matches the expected message * * @param composedMessage The composed message, received from the messenger * @param message The expected message */ private void testMessage(final LetterComposite composedMessage, final String message) { // Test is the composed message has the correct number of words final String[] words = message.split(" "); assertNotNull(composedMessage); assertEquals(words.length, composedMessage.count()); // Print the message to the mocked stdOut ... composedMessage.print(); // ... and verify if the message matches with the expected one assertEquals(message, new String(this.stdOutBuffer.toByteArray()).trim()); } } java-design-patterns-1.16.0/converter/000077500000000000000000000000001312550536300176375ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/README.md000066400000000000000000000017631312550536300211250ustar00rootroot00000000000000--- layout: pattern title: Converter folder: converter permalink: /patterns/converter/ categories: tags: - Java - Difficulty-Beginner --- ## Intent The purpose of the Converter Pattern is to provide a generic, common way of bidirectional conversion between corresponding types, allowing a clean implementation in which the types do not need to be aware of each other. Moreover, the Converter Pattern introduces bidirectional collection mapping, reducing a boilerplate code to minimum. ![alt text](./etc/converter.png "Converter Pattern") ## Applicability Use the Converter Pattern in the following situations: * When you have types that logically correspond which other and you need to convert entities between them * When you want to provide different ways of types conversions depending on a context * Whenever you introduce a DTO (Data transfer object), you will probably need to convert it into the domain equivalence ## Credits * [Converter](http://www.xsolve.pl/blog/converter-pattern-in-java-8/) java-design-patterns-1.16.0/converter/etc/000077500000000000000000000000001312550536300204125ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/etc/Converter.png000066400000000000000000000456751312550536300231100ustar00rootroot00000000000000PNG  IHDRrKIDATxoW}$/&PU-XM˦[M.FVaKlS4(k:-`n6] ITW=q(oB4Vm**oΝgΟsܝ3GVsgϜ93` Pؽz4Bu]'\*p!1acKpuRDU@֐ B ]%eU*1$(öBW$AhJ DᨊFhj-x[LrEDs'Z3pm@d"]zޢ9&劈N:ge1)PĺK((#47؈MHT%8F.&" ԚP.5\~و.pAgXXBbx]^Byw|k$(g7hu:k+L/4~I!Ah.сRFD,Dɇ,a\#1כ;KYD剆 s\ax@ML-f*Q[5nUJY㼱%A99D 7]4m0 |k[oǛ˄*NZ%AyD 7]6vFaRUB[r<|VFuUΏ^i V_y _ (o[[mG.jVDZ;4B=w+/}?~?^]{K'> @LTDo0۾ OOd)IG7HP_>]Y%D`B敊!'%xׄ'Ǯʵ}/. qMf;Oҟ؁'3)XQύϧf`ReN³׾rﮞz_7zI?XPO|bJ3,}#z{2&^$SK vY$Q^*=}i-#Ay,urҫ'_XVzFO%17蚁lQ~_/<~N Ƿ|If-{-KflN&-R^% ZUC6Ay,sXeK]%Z UiZUo"隁m_Չ3Ww'bᶕ}dm럸m~aH)g WDm:mJWjs[|-$Ay,sdeE WV+gB-` 7[t@G s~߼z Y~畟X$T!ïǪ遈?2]f)U,sWV+gB-` 7[t@|X_?q ?7Lg޳q^ [WFf 兾v#UgkD䌁K2b^hՑREfqmѻ䉼9YPc @^vo㓛򅕟ׯ#⿹° *hf_)l:  O,3N.sV+gBU q,c ot\ޙ}宻Wv)W,쑏|<qo3 ;:[i1cec4AyN,we&]SٝN&ZkuT`7Dܣbk_랍|ȁG_,h1:ǐMg^Ds"Bnɭ>q3ݟ#]d'_IP+;x̏hu~DY&AhJ l% ʰ-DUb `+IPm!Z[I2l *tJa[V@V B ]%Bo>ڮyΐ#$(FDsD!j#A " Z'pt@D+>NA=TOukGb(#b絊["v@HO w}sЮ5dR԰M/pqMlKSWTI*o\^::sGȳ 4]*nmt@{򺌒hO\p"G}Vl62z$)ǾUn&cpʈ<@ykF' D7wouH2GwfaŁ_~F-N6OdX#S\\YRJY~՚R y[DVp5\D: ʰ-DUb `+IPm!Z[I2l *tJa[V@V B ]%eU*b׮h0D\4*p遀a:U*{€m$AhJ l% ʰ-DUn Ʒ޷gǿ#(?*< ʰ-DUV` uHΓ B ]e!Ah^a/?a[VC$jכ>'$ϩ 5h H-UC/p㝊 =($5fAY:JV,%Jm* ,liP.-" ~硖TG;&ZEr?Ḏ o|`a0Xb1wb !>qzjJpؑ'eQ͡_N\p_پ(6U3>& Ćh6ÿ@WG -ZR(v_E߈7^ScIq^U4 igr,tMV]eo:_Uv/{  9W+Jk*?Wj-LeB ⿓f,mZ$8u7`qsAI$1F5ʕ/خxC_6i!^iNSh:) D\ˢ|˔ ^‚=v2QDTI&@YlrP.uu2 `!,D4ԙ7x; [q,'DhU , q-, #UOiaSa1QMʥ̱/1/{ѕܠ\Xx9d"DhUNi o Q{ == CzC îœ1RmqakT\0/MG';('b^i-LvrBPFhqNc i5c}T#U b ANeiʻ.ncrg7GRWh&Udj ʒtuF 4No@3\Ouh 03[;C 6huzb v2b&R5=j1jV eU*1$(öBW$AhJ l% ʰ-DUn tQFq@2l *t)w :O2l *tveU*+{῿x`GHPm!Zr=(mR6V52i,E֟$(G SmjViSM4(.YS a2<1TMAZ)jX."_eDXԓe nKt>(3I|GPNe0BuUVH(Nc Ʃ_DQN`!z0-'kp^,)ѿڢg(mwT[db~J<*eg Hiաg88P$W/U]|X2RZjeiKMdN4 DD2݁] ZE7ȋI`t޽ߓn+ uWq'M/Zb6dߚHT2N2p=J drՑ/ц72K˗^j }Y4$U_6ɑ*Z4q"YAW[:o–XVJ0CE{ {4dl!T0+NA9uVpa, QRr" r9q0ޘٞdV™z ]?3U@貰ܼ}8YH)U?P=䠜qu(AMn(6e/F2rw^Գr1ZENsJf 0` eg׌Khw5jM0Jްu*H2"dr{،Nn۔xpCv5%I#R tNAt U=Nc i5;.jeIn5*5@iހgh/Vj7XscC/[;@˾6huV:f Nu6 ͢4Y{D"Za[V@V B ]%eU*1$(öBW$AhJص= !:a0Q聀m$AhJ l% ʰ-DUb `+Ҡ=+o%>YN7[+SOGV]b}?K;–LN2 9V ;I: j9pωڏv 2JJYAzo1.)ܢ ,AC)o>7#d`1J le['Kr7+;ʤt$ZE!)C]`oGA9z~$Kc}З^ܨ'Yo-lNvvVjwX@#^~뙭ψQ;m{{R:RCWF  Ψbz-{+jiLMtG:fHtndFTIaEFgFYJ.=Nu=(u`ZHEeV^)qէ[zو[X),!b3J助bw{2&opPN+=͛vPS@KrEØ%(BWY@tzeuZHoM|+27ac.R: 1b|XO7,^) #ՁѴt\rwT0ʰ*t -w~G}GR.˜< {)2f Ŧ1]ךpr8Ez sPg4p\*t đ 'lZmeWžbeqm_,|-08E~Mڬ24>thrBC+łh(&`/who([m:Ŕ!,isL(n Ʒ޷gǿ#(?*<;7)RΰZEγ!CZt ʙ &H?^5Iy-d,R)Ӓ:E-YZa gvjՠI'0cf 'I[:$y(uVk ?69(c'D1񷈁Hh ~욙. ǩyBmnjX',W&XdisNtl+/Yr^aLGX+ E;&dN)SCN "}bگs(ZNt(Q֢LxčJfHγo%/4owV&3^a Ojw&ڔD`4XԪA6BbBbNc ]:Le-ƉvVI>n23+y%:39\WY ?*(-ժC؈RNDR@LwX@#^~뙭ψ (.fi;A1X:\O2f(Q#wm#+3K#rz/lllPΡl#D(rҏ 'NK{VQ{ ^9{%t W:png#nb\&VcbJZJ(Ѣ\Lu8҄r[+MJve{r;\,<2d9qӉյk!5QN?F.5 㼡d0lǂf0Z=ه[9lia.jD`9q˩_:zQ_QsTpڳMg Z.0'@̓eU*#N:'.=JL #n }ypMP Q a$(öBWY@9|ho^Y_}X2QJnVơdBӮ3 xP>R~3?a[V,m d3NPGgi3 B ]4a$(öBWdAy׮( ! m l {<BW٣eU*1$(öBW9yGǵ[˿_Ͽ~`-DUV` t?*<[ sbk!ZZQEAYڴwh^a/?a[Vlkh`JM;ZO0ˤ /WlQ?͔2T4s6)hgb-l4g RuBw%\0!t}fpr!2l͵rU@a\y.Yve;}h7:pyLJL071hdsHɩ2fkG[񩓠60(:bbDL[ x1yŕٌ G5W{ NiU;~jbm#N:'.=JEvRLf_M`/[F4Ws0euHFN!X E|^oց@+/=s\no<ٹW{^aԡդde֭mLۅQ9|ho^Y_}X2Qǟkj+~M'TuС4Riq< Zt˽R]ODž] -i.isW[Ցxkq>ͱjEgz\wVҿ,{4 Cmvџq>|?b!X;%?Fqf]ꚺYg8U^=mOM6Ωr0T fdc_/뢧f9k3ʸ)-.ݘ!AhJ l% ʰ-DUb `+IPm!Z[I2l *t0w{\!. B ]eBJΓ B ]e!Ah^a/?a[Vlb-X7d VM4ZIEL;5ν{uJ$a7o`H`;Gx<t8(߻a%6.jN~yfiit6wj"5ZhsBNc ]:L*ƉM_XUeNB\(֛=DYQp2TZI;;h WL_t7Xɗ6h& Sjn /9fF 4_P3$NMi;*ZuRO8GR.l]2y2y(&_MU% ~.͡_[ц7J72NϪ.K%m8}h:! 5I$uF柷GSl06rj0f: r3]WY_4EhM3zWڣ4 `{UWY@tzeuZHoM|+2qL3Y|7 gWEmɻ3 ߚnpJvhYMWy{t#T% {{1\05Cnu |ٮ|jI+zP3N| J7rn5*Zu -w~G}GR*o {L@dߐߴ\@4C=r,4)8-8aEΛMvNQ@h"B9L{ \Y}C*6yEW.#ь,E$vU*#N:'.=JLn^8'U Ռ0 텽V|tWhA0҇qML'V;3@s*'mWZIc-lyl:tc@Q/75IޣEc .v U*;{+뫯 VFD:q݆5UeT-8/.eG,~QPiS̠<.qu49?z_;?f:Vw0l zHLϏh[ɶe=U*1$(öBW$AhJ l% ʰ-DUn tQFq@2l *t)w :O2l *tveU*+{῿x`GHPm!Z=#{nue~޴:͈ئhO6&Ϛx$cs5d)$Z59_4Kס ex!Khg#.F[o8 \fxB>6y6(VI|>_~Rx8\m]#ZEԁ/c(VJe ~[񛖗K]1v;er*=]N-(m l*We@6pՑ%Qw}dgi;`/RRCFPΑ_FPg"rm;*Zu đ 'lZmeWžb\&fOwˇn>')p cNBo| ٌ(s_awqnML'_;jg2~¯0rΆuV(ru-"Θb8Ϻc󇶨5خOC,h=kv[UWY@9|ho^Y_}X2 ɍ{ԧͨ*ldֶJieJes*a>;9ɨ%!ٕc#>cIΤrn%C)I4iXHI׮$, Ҽk)4E`Rr`:nى7>bҥK~a G_}%>r5h'vIG9r'3aUy$N4Z^xkxRQ;VI 6@UZ 1YXZZ_[۷zkM-(tzeuZHoM|+2rjTd%gR 5dSB^dr93XD8$~tɋ3h (aׂr ZEawq[Pԁ/c(VCjڞ('(VzP^WSO5;8 ʶ,ZE.a~5y7]-(pr֡V/ʽ{zWGs@` ʂwWW_9.Gq[ӛa`y7ӢcV.FpEOdzW`Pn@hb xwo{OYg}!#( >|qb;bO\L1Fpfb >v5a e`CγD!By{5ܹsAG t8~p[k׮0a)b @xwػwگ?o|u7 2,E t,p~bjA"J D5 ta)b @da ʰ1Ub k.}6qa)b @XA,`A"J >ÇnhG%@^EXmz(Ar?GM38N]\!4a!k5 9_FȲ5@Xlnn 8dcI=Q DΜ m`6@O3T,D w~zݭCFPG3[ ^&zV[jOoahl rR"%Ext 8D ec?ՠj[ rM?bZ 5\`!I})Rz e0c`-(}^~6(V.I4E$ rqh oթ4LlGzy@?N-.GhNT`wYB. r䞭C믭_^yXسyXL3v kaI7$g0+7h}bkAU6Eԩd2b ` )`C;{+뫯 ^F̨ :ew#yל5R3Arh6u{H~/Gƃ~d DZU@y=!aSH de/>4N,d^{ZoN3rUރ4jYB d ;(0fN޼7`cc DC>db ` )2j # (R@@WPR eX*1*.]nh.ʰ1Ub T0A"J ~ҥ[ 2,E tL!APw]w+@APSH\4!(gͱ3ZǓ IsIHEh2`~)z,N:L D =Qw+@]:L,w4$"'s/ӅNmi F6@ꎥ@R A9t~[l~F,$#,tѿ\q0&Olb[ vIRb_WKo8I~v7R5uh)@;ƳjuRlAO8G2U,I6("kɅAYVfmx#%I0&GNR~6)1% R-ל>:=- cwQG*iV+v SH"NW]] 魉bbLBܕ:>ՙڒ((蛂rz7r\,z}`Z#01=[k24,~J LKJqE-Q^i`h *Z\۝6L! "#( >|qb8ˏ"J?+L}ma~lU831!B DvPUeCom&6L;tr6@B L! b~A:I' c D[o߮ (R@@W)@qa)b @L[2,E t B A"J {o`ǶhS-xl-QL1Aذ0mx#VQa 9L@MVNO娪Cd=yAUuR,lA+kWBzkX8eYy SKQJŜAB}wQr?3eI\ 4hV®ea ʷ:pyLJ%`)"g AjIǯXoK6@ h *]7L!\8gk+W"l+2I2Ly80`pƏ^natl@v@0(iwWW_9.Gv la)b 쮁` )0ʰ1Uv@}qFݭA"ʎS K]eG SH1KP LD˗Bg'1eUNĖ sQR`jdc-{Ж=4sNa5hȎS##(#^~뙭ψ1U J)$ 3`rT~B%q0~KO_0Q T(!rny46@UZ h B [PDյޚ(Vex'g0Q΃lb,f]ٖԚV+a SHY` ʷ:pyLJLFKLPlJER`؂ 'lZmeWžb\-#V(NkjMc ZEsƍvb )0529|ho^Y_}Xm`'J׌ǩx RIӺZ@Vj%윁` )0#2 ~'껰ᜟg0f1ZE3s)u2U<륯qPbc DDNsΝhnP$3 K]e Ļ{7 na)b 얁` )0;ʰ1Uv@,-->}Vv K]e SHٱk{ ZNBֶ)yqR<ก` )`p@008n B \6L! . SHsovZݭ)YqڵoVnYRଁؿvݭ܄)M!0upn 7 SHs)AR᠁` )`p@00o8h B 74L!vs1L!1L!1L!1L!1L!$1L!$1L!$1L!${ogoa$B7t` 0@i` 0@i` 0@i` 0@i@l QUOm^h{E/s!0@]@l z]\Yz-ˣ 6m2U0FжBEjMhAFGY@ ʝ^_#D Iτ/݄nX od^S0) DQG0 ArV%'^7k$OD"遈G> (0ѼBɀAa*pVz 11K!5"{~?\&ueVQ'1Lۯ0q V@,me qj[c*!ꉁ)0( ( ( ( ( (|揯}G?7W,5߰F N!@MÏ]R@|b}FS2%މ{~$>w/wŸ)IW|PV`}a t V揯Ǯ6?mw27lI`ɲ -@3O/}/<{[KwKo}W,O~ Dҋ e$PV&|*(< GT߆ -;9N nj :}=~/~ω2"r--9gww?m+5D{)߲@(ջwW'=?WDP,ܶ򱏬c|PdsLw9 Db4g W;+Md@x_y;/^?z`nD8A~Z-(l a;گ݄@|X_?unW&{W>xyEg Lfsܘ-@ }F~-=D֯0>ܗ/?ׯ#ɌRMwq?@} -n̖_a@"nkbc 0y VwC_o|sﭝ|J˟:{#_oA} 9!}cP9*Ņo/PCL%|wݳq߁o9p+=tB\zpo?#\]81@i` 0@i` 0@i` 0@i` 0@i` 0@i@l^[U @1vl Nn 9S' L8-z#ߏ7呷/9᎒$z`/*]Dԣ~0u ͊/ 0I ]_ <Od7mn >nFN\ab mbSrՔMjij@:,BzLW>zqn_5,z7\ܒD\)a__~} U=(qI\똺y? 6/+>reЃ1xG߰a zr-M[CPpG0ȅ{~y+baa2U,ySLqnBʾ+":y(4C+ł_D/(3N +P`GAS-(.Dr ٿ@O? "? g&Nܩ#0: D5@04040404ޮ]i!^"@i` Pv5CH"IENDB`java-design-patterns-1.16.0/converter/etc/Converter.ucls000066400000000000000000000067331312550536300232620ustar00rootroot00000000000000 java-design-patterns-1.16.0/converter/etc/converter.urm.puml000066400000000000000000000025231312550536300241240ustar00rootroot00000000000000@startuml package com.iluwatar.converter { class App { + App() + main(args : String[]) {static} } class Converter { - fromDto : Function - fromEntity : Function + Converter(fromDto : Function, fromEntity : Function) + convertFromDto(userDto : T) : U + convertFromEntity(user : U) : T + createFromDtos(dtoUsers : Collection) : List + createFromEntities(users : Collection) : List } class User { - firstName : String - isActive : boolean - lastName : String - userId : String + User(firstName : String, lastName : String, isActive : boolean, userId : String) + equals(o : Object) : boolean + getFirstName() : String + getLastName() : String + getUserId() : String + hashCode() : int + isActive() : boolean + toString() : String } class UserConverter { + UserConverter() } class UserDto { - email : String - firstName : String - isActive : boolean - lastName : String + UserDto(firstName : String, lastName : String, isActive : boolean, email : String) + equals(o : Object) : boolean + getEmail() : String + getFirstName() : String + getLastName() : String + hashCode() : int + isActive() : boolean + toString() : String } } UserConverter --|> Converter @endumljava-design-patterns-1.16.0/converter/pom.xml000066400000000000000000000037061312550536300211620ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 junit junit test com.google.guava guava converter java-design-patterns-1.16.0/converter/src/000077500000000000000000000000001312550536300204265ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/main/000077500000000000000000000000001312550536300213525ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/main/java/000077500000000000000000000000001312550536300222735ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/main/java/com/000077500000000000000000000000001312550536300230515ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300247015ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/converter/000077500000000000000000000000001312550536300267105ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/converter/App.java000066400000000000000000000052271312550536300303010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; import com.google.common.collect.Lists; import java.util.ArrayList; import java.util.List; /** * The Converter pattern is a behavioral design pattern which allows a common way of bidirectional * conversion between corresponding types (e.g. DTO and domain representations of the logically * isomorphic types). Moreover, the pattern introduces a common way of converting a collection of * objects between types. */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Converter userConverter = new Converter<>( userDto -> new User(userDto.getFirstName(), userDto.getLastName(), userDto.isActive(), userDto.getEmail()), user -> new UserDto(user.getFirstName(), user.getLastName(), user.isActive(), user.getUserId())); UserDto dtoUser = new UserDto("John", "Doe", true, "whatever[at]wherever.com"); User user = userConverter.convertFromDto(dtoUser); System.out.println("Entity converted from DTO:" + user); ArrayList users = Lists.newArrayList(new User("Camile", "Tough", false, "124sad"), new User("Marti", "Luther", true, "42309fd"), new User("Kate", "Smith", true, "if0243")); System.out.println("Domain entities:"); users.forEach(System.out::println); System.out.println("DTO entities converted from domain:"); List dtoEntities = userConverter.createFromEntities(users); dtoEntities.forEach(System.out::println); } } java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/converter/Converter.java000066400000000000000000000064001312550536300315220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; import java.util.Collection; import java.util.List; import java.util.function.Function; import java.util.stream.Collectors; /** * Generic converter, thanks to Java8 features not only provides a way of generic bidirectional * conversion between coresponding types, but also a common way of converting a collection of objects * of the same type, reducing boilerplate code to the absolute minimum. * @param DTO representation's type * @param Domain representation's type */ public class Converter { private final Function fromDto; private final Function fromEntity; /** * @param fromDto Function that converts given dto entity into the domain entity. * @param fromEntity Function that converts given domain entity into the dto entity. */ public Converter(final Function fromDto, final Function fromEntity) { this.fromDto = fromDto; this.fromEntity = fromEntity; } /** * @param userDto DTO entity * @return The domain representation - the result of the converting function application on dto entity. */ public final U convertFromDto(final T userDto) { return fromDto.apply(userDto); } /** * @param user domain entity * @return The DTO representation - the result of the converting function application on domain entity. */ public final T convertFromEntity(final U user) { return fromEntity.apply(user); } /** * @param dtoUsers collection of DTO entities * @return List of domain representation of provided entities retrieved by * mapping each of them with the convertion function */ public final List createFromDtos(final Collection dtoUsers) { return dtoUsers.stream().map(this::convertFromDto).collect(Collectors.toList()); } /** * @param users collection of domain entities * @return List of domain representation of provided entities retrieved by * mapping each of them with the convertion function */ public final List createFromEntities(final Collection users) { return users.stream().map(this::convertFromEntity).collect(Collectors.toList()); } } java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/converter/User.java000066400000000000000000000051721312550536300304760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; import java.util.Objects; /** * User class */ public class User { private String firstName; private String lastName; private boolean isActive; private String userId; /** * @param firstName user's first name * @param lastName user's last name * @param isActive flag indicating whether the user is active * @param userId user's identificator */ public User(String firstName, String lastName, boolean isActive, String userId) { this.firstName = firstName; this.lastName = lastName; this.isActive = isActive; this.userId = userId; } public String getFirstName() { return firstName; } public String getLastName() { return lastName; } public boolean isActive() { return isActive; } public String getUserId() { return userId; } @Override public boolean equals(Object o) { if (this == o) { return true; } if (o == null || getClass() != o.getClass()) { return false; } User user = (User) o; return isActive == user.isActive && Objects.equals(firstName, user.firstName) && Objects .equals(lastName, user.lastName) && Objects.equals(userId, user.userId); } @Override public int hashCode() { return Objects.hash(firstName, lastName, isActive, userId); } @Override public String toString() { return "User{" + "firstName='" + firstName + '\'' + ", lastName='" + lastName + '\'' + ", isActive=" + isActive + ", userId='" + userId + '\'' + '}'; } } java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/converter/UserConverter.java000066400000000000000000000031251312550536300323620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; /** * Example implementation of the simple User converter. */ public class UserConverter extends Converter { /** * Constructor. */ public UserConverter() { super(userDto -> new User(userDto.getFirstName(), userDto.getLastName(), userDto.isActive(), userDto.getEmail()), user -> new UserDto(user.getFirstName(), user.getLastName(), user.isActive(), user.getUserId())); } } java-design-patterns-1.16.0/converter/src/main/java/com/iluwatar/converter/UserDto.java000066400000000000000000000052261312550536300311450ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

With the DAO pattern, we can use various method calls to retrieve/add/delete/update data * without directly interacting with the data source. The below example demonstrates basic CRUD * operations: select, add, update, and delete. * * */ public class App { private static final String DB_URL = "jdbc:h2:~/dao"; private static Logger log = Logger.getLogger(App.class); /** * Program entry point. * * @param args command line args. * @throws Exception if any error occurs. */ public static void main(final String[] args) throws Exception { final CustomerDao inMemoryDao = new InMemoryCustomerDao(); performOperationsUsing(inMemoryDao); final DataSource dataSource = createDataSource(); createSchema(dataSource); final CustomerDao dbDao = new DbCustomerDao(dataSource); performOperationsUsing(dbDao); deleteSchema(dataSource); } private static void deleteSchema(DataSource dataSource) throws SQLException { try (Connection connection = dataSource.getConnection(); Statement statement = connection.createStatement()) { statement.execute(CustomerSchemaSql.DELETE_SCHEMA_SQL); } } private static void createSchema(DataSource dataSource) throws SQLException { try (Connection connection = dataSource.getConnection(); Statement statement = connection.createStatement()) { statement.execute(CustomerSchemaSql.CREATE_SCHEMA_SQL); } } private static DataSource createDataSource() { JdbcDataSource dataSource = new JdbcDataSource(); dataSource.setURL(DB_URL); return dataSource; } private static void performOperationsUsing(final CustomerDao customerDao) throws Exception { addCustomers(customerDao); log.info("customerDao.getAllCustomers(): "); try (Stream customerStream = customerDao.getAll()) { customerStream.forEach((customer) -> log.info(customer)); } log.info("customerDao.getCustomerById(2): " + customerDao.getById(2)); final Customer customer = new Customer(4, "Dan", "Danson"); customerDao.add(customer); log.info("customerDao.getAllCustomers(): " + customerDao.getAll()); customer.setFirstName("Daniel"); customer.setLastName("Danielson"); customerDao.update(customer); log.info("customerDao.getAllCustomers(): "); try (Stream customerStream = customerDao.getAll()) { customerStream.forEach((cust) -> log.info(cust)); } customerDao.delete(customer); log.info("customerDao.getAllCustomers(): " + customerDao.getAll()); } private static void addCustomers(CustomerDao customerDao) throws Exception { for (Customer customer : generateSampleCustomers()) { customerDao.add(customer); } } /** * Generate customers. * * @return list of customers. */ public static List generateSampleCustomers() { final Customer customer1 = new Customer(1, "Adam", "Adamson"); final Customer customer2 = new Customer(2, "Bob", "Bobson"); final Customer customer3 = new Customer(3, "Carl", "Carlson"); final List customers = new ArrayList<>(); customers.add(customer1); customers.add(customer2); customers.add(customer3); return customers; } } java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/Customer.java000066400000000000000000000050201312550536300266410ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; /** * A customer POJO that represents the data that will be read from the data source. * */ public class Customer { private int id; private String firstName; private String lastName; /** * Creates an instance of customer. */ public Customer(final int id, final String firstName, final String lastName) { this.id = id; this.firstName = firstName; this.lastName = lastName; } public int getId() { return id; } public void setId(final int id) { this.id = id; } public String getFirstName() { return firstName; } public void setFirstName(final String firstName) { this.firstName = firstName; } public String getLastName() { return lastName; } public void setLastName(final String lastName) { this.lastName = lastName; } @Override public String toString() { return "Customer{" + "id=" + getId() + ", firstName='" + getFirstName() + '\'' + ", lastName='" + getLastName() + '\'' + '}'; } @Override public boolean equals(final Object that) { boolean isEqual = false; if (this == that) { isEqual = true; } else if (that != null && getClass() == that.getClass()) { final Customer customer = (Customer) that; if (getId() == customer.getId()) { isEqual = true; } } return isEqual; } @Override public int hashCode() { return getId(); } } java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/CustomerDao.java000066400000000000000000000065161312550536300273000ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import java.util.Optional; import java.util.stream.Stream; /** * In an application the Data Access Object (DAO) is a part of Data access layer. It is an object * that provides an interface to some type of persistence mechanism. By mapping application calls * to the persistence layer, DAO provides some specific data operations without exposing details * of the database. This isolation supports the Single responsibility principle. It separates what * data accesses the application needs, in terms of domain-specific objects and data types * (the public interface of the DAO), from how these needs can be satisfied with a specific DBMS, * database schema, etc. * *

Any change in the way data is stored and retrieved will not change the client code as the * client will be using interface and need not worry about exact source. * * @see InMemoryCustomerDao * @see DbCustomerDao */ public interface CustomerDao { /** * @return all the customers as a stream. The stream may be lazily or eagerly evaluated based * on the implementation. The stream must be closed after use. * @throws Exception if any error occurs. */ Stream getAll() throws Exception; /** * @param id unique identifier of the customer. * @return an optional with customer if a customer with unique identifier id * exists, empty optional otherwise. * @throws Exception if any error occurs. */ Optional getById(int id) throws Exception; /** * @param customer the customer to be added. * @return true if customer is successfully added, false if customer already exists. * @throws Exception if any error occurs. */ boolean add(Customer customer) throws Exception; /** * @param customer the customer to be updated. * @return true if customer exists and is successfully updated, false otherwise. * @throws Exception if any error occurs. */ boolean update(Customer customer) throws Exception; /** * @param customer the customer to be deleted. * @return true if customer exists and is successfully deleted, false otherwise. * @throws Exception if any error occurs. */ boolean delete(Customer customer) throws Exception; } java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/CustomerSchemaSql.java000066400000000000000000000027321312550536300304510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; /** * Customer Schema SQL Class */ public final class CustomerSchemaSql { private CustomerSchemaSql() {} public static final String CREATE_SCHEMA_SQL = "CREATE TABLE CUSTOMERS (ID NUMBER, FNAME VARCHAR(100), " + "LNAME VARCHAR(100))"; public static final String DELETE_SCHEMA_SQL = "DROP TABLE CUSTOMERS"; } java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java000066400000000000000000000134421312550536300275420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; import java.util.Optional; import java.util.Spliterator; import java.util.Spliterators; import java.util.function.Consumer; import java.util.stream.Stream; import java.util.stream.StreamSupport; import javax.sql.DataSource; /** * An implementation of {@link CustomerDao} that persists customers in RDBMS. * */ public class DbCustomerDao implements CustomerDao { private final DataSource dataSource; /** * Creates an instance of {@link DbCustomerDao} which uses provided dataSource * to store and retrieve customer information. * * @param dataSource a non-null dataSource. */ public DbCustomerDao(DataSource dataSource) { this.dataSource = dataSource; } /** * @return a lazily populated stream of customers. Note the stream returned must be closed to * free all the acquired resources. The stream keeps an open connection to the database till * it is complete or is closed manually. */ @Override public Stream getAll() throws Exception { Connection connection; try { connection = getConnection(); PreparedStatement statement = connection.prepareStatement("SELECT * FROM CUSTOMERS"); ResultSet resultSet = statement.executeQuery(); return StreamSupport.stream(new Spliterators.AbstractSpliterator(Long.MAX_VALUE, Spliterator.ORDERED) { @Override public boolean tryAdvance(Consumer action) { try { if (!resultSet.next()) { return false; } action.accept(createCustomer(resultSet)); return true; } catch (SQLException e) { throw new RuntimeException(e); } } }, false).onClose(() -> mutedClose(connection)); } catch (SQLException e) { throw new Exception(e.getMessage(), e); } } private Connection getConnection() throws SQLException { return dataSource.getConnection(); } private void mutedClose(Connection connection) { try { connection.close(); } catch (SQLException e) { e.printStackTrace(); } } private Customer createCustomer(ResultSet resultSet) throws SQLException { return new Customer(resultSet.getInt("ID"), resultSet.getString("FNAME"), resultSet.getString("LNAME")); } /** * {@inheritDoc} */ @Override public Optional getById(int id) throws Exception { try (Connection connection = getConnection(); PreparedStatement statement = connection.prepareStatement("SELECT * FROM CUSTOMERS WHERE ID = ?")) { statement.setInt(1, id); ResultSet resultSet = statement.executeQuery(); if (resultSet.next()) { return Optional.of(createCustomer(resultSet)); } else { return Optional.empty(); } } catch (SQLException ex) { throw new Exception(ex.getMessage(), ex); } } /** * {@inheritDoc} */ @Override public boolean add(Customer customer) throws Exception { if (getById(customer.getId()).isPresent()) { return false; } try (Connection connection = getConnection(); PreparedStatement statement = connection.prepareStatement("INSERT INTO CUSTOMERS VALUES (?,?,?)")) { statement.setInt(1, customer.getId()); statement.setString(2, customer.getFirstName()); statement.setString(3, customer.getLastName()); statement.execute(); return true; } catch (SQLException ex) { throw new Exception(ex.getMessage(), ex); } } /** * {@inheritDoc} */ @Override public boolean update(Customer customer) throws Exception { try (Connection connection = getConnection(); PreparedStatement statement = connection.prepareStatement("UPDATE CUSTOMERS SET FNAME = ?, LNAME = ? WHERE ID = ?")) { statement.setString(1, customer.getFirstName()); statement.setString(2, customer.getLastName()); statement.setInt(3, customer.getId()); return statement.executeUpdate() > 0; } catch (SQLException ex) { throw new Exception(ex.getMessage(), ex); } } /** * {@inheritDoc} */ @Override public boolean delete(Customer customer) throws Exception { try (Connection connection = getConnection(); PreparedStatement statement = connection.prepareStatement("DELETE FROM CUSTOMERS WHERE ID = ?")) { statement.setInt(1, customer.getId()); return statement.executeUpdate() > 0; } catch (SQLException ex) { throw new Exception(ex.getMessage(), ex); } } } java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/InMemoryCustomerDao.java000066400000000000000000000045521312550536300307560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import java.util.HashMap; import java.util.Map; import java.util.Optional; import java.util.stream.Stream; /** * An in memory implementation of {@link CustomerDao}, which stores the customers in JVM memory * and data is lost when the application exits. *
* This implementation is useful as temporary database or for testing. */ public class InMemoryCustomerDao implements CustomerDao { private Map idToCustomer = new HashMap<>(); /** * An eagerly evaluated stream of customers stored in memory. */ @Override public Stream getAll() { return idToCustomer.values().stream(); } @Override public Optional getById(final int id) { return Optional.ofNullable(idToCustomer.get(id)); } @Override public boolean add(final Customer customer) { if (getById(customer.getId()).isPresent()) { return false; } idToCustomer.put(customer.getId(), customer); return true; } @Override public boolean update(final Customer customer) { return idToCustomer.replace(customer.getId(), customer) != null; } @Override public boolean delete(final Customer customer) { return idToCustomer.remove(customer.getId()) != null; } } java-design-patterns-1.16.0/dao/src/main/resources/000077500000000000000000000000001312550536300221205ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/resources/log4j.xml000066400000000000000000000032221312550536300236600ustar00rootroot00000000000000 java-design-patterns-1.16.0/dao/src/test/000077500000000000000000000000001312550536300201415ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/test/java/000077500000000000000000000000001312550536300210625ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/test/java/com/000077500000000000000000000000001312550536300216405ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300234705ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/test/java/com/iluwatar/dao/000077500000000000000000000000001312550536300242335ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/test/java/com/iluwatar/dao/AppTest.java000066400000000000000000000025351312550536300264630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import org.junit.Test; /** * Tests that DAO example runs without errors. */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/dao/src/test/java/com/iluwatar/dao/CustomerTest.java000066400000000000000000000062271312550536300275460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotEquals; import org.junit.Before; import org.junit.Test; /** * Tests {@link Customer}. */ public class CustomerTest { private Customer customer; private static final int ID = 1; private static final String FIRSTNAME = "Winston"; private static final String LASTNAME = "Churchill"; @Before public void setUp() { customer = new Customer(ID, FIRSTNAME, LASTNAME); } @Test public void getAndSetId() { final int newId = 2; customer.setId(newId); assertEquals(newId, customer.getId()); } @Test public void getAndSetFirstname() { final String newFirstname = "Bill"; customer.setFirstName(newFirstname); assertEquals(newFirstname, customer.getFirstName()); } @Test public void getAndSetLastname() { final String newLastname = "Clinton"; customer.setLastName(newLastname); assertEquals(newLastname, customer.getLastName()); } @Test public void notEqualWithDifferentId() { final int newId = 2; final Customer otherCustomer = new Customer(newId, FIRSTNAME, LASTNAME); assertNotEquals(customer, otherCustomer); assertNotEquals(customer.hashCode(), otherCustomer.hashCode()); } @Test public void equalsWithSameObjectValues() { final Customer otherCustomer = new Customer(ID, FIRSTNAME, LASTNAME); assertEquals(customer, otherCustomer); assertEquals(customer.hashCode(), otherCustomer.hashCode()); } @Test public void equalsWithSameObjects() { assertEquals(customer, customer); assertEquals(customer.hashCode(), customer.hashCode()); } @Test public void testToString() { final StringBuffer buffer = new StringBuffer(); buffer.append("Customer{id=") .append("" + customer.getId()) .append(", firstName='") .append(customer.getFirstName()) .append("\', lastName='") .append(customer.getLastName() + "\'}"); assertEquals(buffer.toString(), customer.toString()); } } java-design-patterns-1.16.0/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java000066400000000000000000000215371312550536300304410ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; import static org.junit.Assume.assumeTrue; import static org.mockito.Mockito.doReturn; import static org.mockito.Mockito.doThrow; import static org.mockito.Mockito.mock; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; import java.sql.Statement; import java.util.stream.Stream; import javax.sql.DataSource; import org.h2.jdbcx.JdbcDataSource; import org.junit.After; import org.junit.Before; import org.junit.Rule; import org.junit.Test; import org.junit.rules.ExpectedException; import org.junit.runner.RunWith; import org.mockito.Mockito; import de.bechte.junit.runners.context.HierarchicalContextRunner; /** * Tests {@link DbCustomerDao}. */ @RunWith(HierarchicalContextRunner.class) public class DbCustomerDaoTest { private static final String DB_URL = "jdbc:h2:~/dao"; private DbCustomerDao dao; private Customer existingCustomer = new Customer(1, "Freddy", "Krueger"); /** * Creates customers schema. * @throws SQLException if there is any error while creating schema. */ @Before public void createSchema() throws SQLException { try (Connection connection = DriverManager.getConnection(DB_URL); Statement statement = connection.createStatement()) { statement.execute(CustomerSchemaSql.CREATE_SCHEMA_SQL); } } /** * Represents the scenario where DB connectivity is present. */ public class ConnectionSuccess { /** * Setup for connection success scenario. * @throws Exception if any error occurs. */ @Before public void setUp() throws Exception { JdbcDataSource dataSource = new JdbcDataSource(); dataSource.setURL(DB_URL); dao = new DbCustomerDao(dataSource); boolean result = dao.add(existingCustomer); assertTrue(result); } /** * Represents the scenario when DAO operations are being performed on a non existing customer. */ public class NonExistingCustomer { @Test public void addingShouldResultInSuccess() throws Exception { try (Stream allCustomers = dao.getAll()) { assumeTrue(allCustomers.count() == 1); } final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund"); boolean result = dao.add(nonExistingCustomer); assertTrue(result); assertCustomerCountIs(2); assertEquals(nonExistingCustomer, dao.getById(nonExistingCustomer.getId()).get()); } @Test public void deletionShouldBeFailureAndNotAffectExistingCustomers() throws Exception { final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund"); boolean result = dao.delete(nonExistingCustomer); assertFalse(result); assertCustomerCountIs(1); } @Test public void updationShouldBeFailureAndNotAffectExistingCustomers() throws Exception { final int nonExistingId = getNonExistingCustomerId(); final String newFirstname = "Douglas"; final String newLastname = "MacArthur"; final Customer customer = new Customer(nonExistingId, newFirstname, newLastname); boolean result = dao.update(customer); assertFalse(result); assertFalse(dao.getById(nonExistingId).isPresent()); } @Test public void retrieveShouldReturnNoCustomer() throws Exception { assertFalse(dao.getById(getNonExistingCustomerId()).isPresent()); } } /** * Represents a scenario where DAO operations are being performed on an already existing * customer. * */ public class ExistingCustomer { @Test public void addingShouldResultInFailureAndNotAffectExistingCustomers() throws Exception { Customer existingCustomer = new Customer(1, "Freddy", "Krueger"); boolean result = dao.add(existingCustomer); assertFalse(result); assertCustomerCountIs(1); assertEquals(existingCustomer, dao.getById(existingCustomer.getId()).get()); } @Test public void deletionShouldBeSuccessAndCustomerShouldBeNonAccessible() throws Exception { boolean result = dao.delete(existingCustomer); assertTrue(result); assertCustomerCountIs(0); assertFalse(dao.getById(existingCustomer.getId()).isPresent()); } @Test public void updationShouldBeSuccessAndAccessingTheSameCustomerShouldReturnUpdatedInformation() throws Exception { final String newFirstname = "Bernard"; final String newLastname = "Montgomery"; final Customer customer = new Customer(existingCustomer.getId(), newFirstname, newLastname); boolean result = dao.update(customer); assertTrue(result); final Customer cust = dao.getById(existingCustomer.getId()).get(); assertEquals(newFirstname, cust.getFirstName()); assertEquals(newLastname, cust.getLastName()); } } } /** * Represents a scenario where DB connectivity is not present due to network issue, or * DB service unavailable. * */ public class ConnectivityIssue { private static final String EXCEPTION_CAUSE = "Connection not available"; @Rule public ExpectedException exception = ExpectedException.none(); /** * setup a connection failure scenario. * @throws SQLException if any error occurs. */ @Before public void setUp() throws SQLException { dao = new DbCustomerDao(mockedDatasource()); exception.expect(Exception.class); exception.expectMessage(EXCEPTION_CAUSE); } private DataSource mockedDatasource() throws SQLException { DataSource mockedDataSource = mock(DataSource.class); Connection mockedConnection = mock(Connection.class); SQLException exception = new SQLException(EXCEPTION_CAUSE); doThrow(exception).when(mockedConnection).prepareStatement(Mockito.anyString()); doReturn(mockedConnection).when(mockedDataSource).getConnection(); return mockedDataSource; } @Test public void addingACustomerFailsWithExceptionAsFeedbackToClient() throws Exception { dao.add(new Customer(2, "Bernard", "Montgomery")); } @Test public void deletingACustomerFailsWithExceptionAsFeedbackToTheClient() throws Exception { dao.delete(existingCustomer); } @Test public void updatingACustomerFailsWithFeedbackToTheClient() throws Exception { final String newFirstname = "Bernard"; final String newLastname = "Montgomery"; dao.update(new Customer(existingCustomer.getId(), newFirstname, newLastname)); } @Test public void retrievingACustomerByIdFailsWithExceptionAsFeedbackToClient() throws Exception { dao.getById(existingCustomer.getId()); } @Test public void retrievingAllCustomersFailsWithExceptionAsFeedbackToClient() throws Exception { dao.getAll(); } } /** * Delete customer schema for fresh setup per test. * @throws SQLException if any error occurs. */ @After public void deleteSchema() throws SQLException { try (Connection connection = DriverManager.getConnection(DB_URL); Statement statement = connection.createStatement()) { statement.execute(CustomerSchemaSql.DELETE_SCHEMA_SQL); } } private void assertCustomerCountIs(int count) throws Exception { try (Stream allCustomers = dao.getAll()) { assertTrue(allCustomers.count() == count); } } /** * An arbitrary number which does not correspond to an active Customer id. * * @return an int of a customer id which doesn't exist */ private int getNonExistingCustomerId() { return 999; } } java-design-patterns-1.16.0/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java000066400000000000000000000125471312550536300316540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; import static org.junit.Assume.assumeTrue; import java.util.Optional; import java.util.stream.Stream; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import de.bechte.junit.runners.context.HierarchicalContextRunner; /** * Tests {@link InMemoryCustomerDao}. */ @RunWith(HierarchicalContextRunner.class) public class InMemoryCustomerDaoTest { private InMemoryCustomerDao dao; private static final Customer CUSTOMER = new Customer(1, "Freddy", "Krueger"); @Before public void setUp() { dao = new InMemoryCustomerDao(); assertTrue(dao.add(CUSTOMER)); } /** * Represents the scenario when the DAO operations are being performed on a non existent * customer. */ public class NonExistingCustomer { @Test public void addingShouldResultInSuccess() throws Exception { try (Stream allCustomers = dao.getAll()) { assumeTrue(allCustomers.count() == 1); } final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund"); boolean result = dao.add(nonExistingCustomer); assertTrue(result); assertCustomerCountIs(2); assertEquals(nonExistingCustomer, dao.getById(nonExistingCustomer.getId()).get()); } @Test public void deletionShouldBeFailureAndNotAffectExistingCustomers() throws Exception { final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund"); boolean result = dao.delete(nonExistingCustomer); assertFalse(result); assertCustomerCountIs(1); } @Test public void updationShouldBeFailureAndNotAffectExistingCustomers() throws Exception { final int nonExistingId = getNonExistingCustomerId(); final String newFirstname = "Douglas"; final String newLastname = "MacArthur"; final Customer customer = new Customer(nonExistingId, newFirstname, newLastname); boolean result = dao.update(customer); assertFalse(result); assertFalse(dao.getById(nonExistingId).isPresent()); } @Test public void retrieveShouldReturnNoCustomer() throws Exception { assertFalse(dao.getById(getNonExistingCustomerId()).isPresent()); } } /** * Represents the scenario when the DAO operations are being performed on an already existing * customer. */ public class ExistingCustomer { @Test public void addingShouldResultInFailureAndNotAffectExistingCustomers() throws Exception { boolean result = dao.add(CUSTOMER); assertFalse(result); assertCustomerCountIs(1); assertEquals(CUSTOMER, dao.getById(CUSTOMER.getId()).get()); } @Test public void deletionShouldBeSuccessAndCustomerShouldBeNonAccessible() throws Exception { boolean result = dao.delete(CUSTOMER); assertTrue(result); assertCustomerCountIs(0); assertFalse(dao.getById(CUSTOMER.getId()).isPresent()); } @Test public void updationShouldBeSuccessAndAccessingTheSameCustomerShouldReturnUpdatedInformation() throws Exception { final String newFirstname = "Bernard"; final String newLastname = "Montgomery"; final Customer customer = new Customer(CUSTOMER.getId(), newFirstname, newLastname); boolean result = dao.update(customer); assertTrue(result); final Customer cust = dao.getById(CUSTOMER.getId()).get(); assertEquals(newFirstname, cust.getFirstName()); assertEquals(newLastname, cust.getLastName()); } @Test public void retriveShouldReturnTheCustomer() { Optional optionalCustomer = dao.getById(CUSTOMER.getId()); assertTrue(optionalCustomer.isPresent()); assertEquals(CUSTOMER, optionalCustomer.get()); } } /** * An arbitrary number which does not correspond to an active Customer id. * * @return an int of a customer id which doesn't exist */ private int getNonExistingCustomerId() { return 999; } private void assertCustomerCountIs(int count) throws Exception { try (Stream allCustomers = dao.getAll()) { assertTrue(allCustomers.count() == count); } } } java-design-patterns-1.16.0/data-bus/000077500000000000000000000000001312550536300173305ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/.gitignore000066400000000000000000000000101312550536300213070ustar00rootroot00000000000000/target java-design-patterns-1.16.0/data-bus/README.md000066400000000000000000000017161312550536300206140ustar00rootroot00000000000000--- layout: pattern title: Data Bus folder: data-bus permalink: /patterns/data-bus/ categories: Architectural tags: - Java - Difficulty-Intermediate --- ## Intent Allows send of messages/events between components of an application without them needing to know about each other. They only need to know about the type of the message/event being sent. ![data bus pattern uml diagram](./etc/data-bus.urm.png "Data Bus pattern") ## Applicability Use Data Bus pattern when * you want your components to decide themselves which messages/events they want to receive * you want to have many-to-many communication * you want your components to know nothing about each other ## Related Patterns Data Bus is similar to * Mediator pattern with Data Bus Members deciding for themselves if they want to accept any given message * Observer pattern but supporting many-to-many communication * Publish/Subscribe pattern with the Data Bus decoupling the publisher and the subscriber java-design-patterns-1.16.0/data-bus/etc/000077500000000000000000000000001312550536300201035ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/etc/data-bus.urm.png000066400000000000000000001673011312550536300231230ustar00rootroot00000000000000PNG  IHDR_qp)tEXtcopyleftGenerated by http://plantuml.com09zTXtplantumlxUN@}d JB ȪPM58j:߲$)U̜ؖ;ggcɄLE\' ,OE9=gI  Y,9rHKy |J`WmFqQXh*ڪXBW))~t. xEJY:nZz"ݯߌZRV<דٹ`#)^,P~c0CqT_ْKN5=i݅(Q'eK7wU(Nf#AFI{HvLq9͎oj5,@5r9FR_-n]YAs兒֛j \ c;ҵM瓰uO3;̧NKjX@LRymw/uOɏGmIj׺S8 kĭnsQPb*5ڦI)N;[+8Cu)Y\;f)gT(fj~Ci e:Rhbket M3-wƢZ]#g7v3.#X2aÞs={o.Sw{_܎ AzN[DH")Ю؂DGΆs!X'y\ =~@YA`5,HPǓD%5M;9YKRsʵns½^wi8s9vD].B].B ].B .B @B (D$$$4gΜ! yh"͸qF@@^ ]???@5jx`͚5 F@@^ ]KW@AQBq”{`Ȑ!℁NBlX*Oif.ɵGTPdٳGV[ZѺNq ]@Zb4s+ݽG.]ZYphԌ `B%BЯ_?Y$ `ƍv:uw/BRJaQ\S*U>3Õx{{46G*|'4h 2쉬\6!^5kﷄ^z+Wѱrʃ _ X zԗ(Qbʕܽ ]K PPKcƌe@Bٳg+e@B .C:99p2 t @z''M.AAA-[e@B쁔IWWuEEE%&&-s8p ??iV֨=:(((HHH@ "q. P`#R èQ'9 (pQ.-3Y&KƍKKKqFzzzv{@X]4xϋ{]K㓒Dfw].%K={!tV,$&&"t6/t׬Yy.B ]. tF t }xd i{KG) f7+E0_%[:H!X0p.@agλl.BHG+>a6gݘBHG t1 V%&&HNa) f@b $7cbb$SIJJdƍV B`6]IQ?YquXeij;M\87p_yrnШ(IVRRR @"&]bVcx7çL]y(\JYj>?}ej7Ѳeѣ_;~?]\!ֺsSSIի;Ť0mڛY֫?UR͛7TꃂJkvo<…//7\~wuQ]sSHIZO踥. ]+t~Yŋ>[󯿒sͪ#͛7moׯ6m+bҥTrBSnoj]=;]a?y{ό_"~>Owu-ӧ+'|ԩw5j'7S~)N)gbɒN$s OE%(^X㏃>>Yފf،ݞ[n]kίL׮DnٲCfTv3g6aRjE\œ._a*JSNhMmѾ е=/PQ:ҰYc95dވC.̽vg~Z5Ѽ;;;޻ە f٭便z_,3`URNJZߦs.ʍgŊ9h.b= ] TFòBڜ_ݻ5jTq;v,5t%mJ==]kժmJSNhMmѾ е}wӀ谕Зۜ_c0sK.-])SǛ9`GwoeWpf£GL5#}'k=!cߌh)kίz3TS~Q+~ڏ?n54]\N)'4h@Ck^? b_Ə >| 1xx&'*_IyClϞmET3w{2"@^V.\8Q.TǾ6W+/QR)Rr:Дۛڢ}Bk3,& r+?߄$-Z4rrr˼\/]ڮNVVKZ?zkʬRPoKVgWvww1" l̙xYa=d)Yv%J7նX1z~oen駫I*U*,^%{=y/bb0wR{kH_!^WhwJvRvOn <4[G t$}oFI%KO>g-ߋkһg ;n\~KMֶoݗkO!{#@q{.B;?Eyٱ}Q^2?|K/7wqs)^Onϴ"_FxemQ.\8ǻ|yC{g";BמB&F t ]?Z)YBQzRP2DJ8?@ژ7zv2kټ&& }/B!R p.B6}w&A=< B!R p.B>o]萘#;"ጸ~cߪM}vt,!kaf2}Wݰ_g$7"t"k0ƍk{2uUZ֭.q#!*j|')tsu!tM;O:OJYoj^՟د]ۥg*{˖EO̜!S)SGe:$!K)]3nNŋ Nl֬A߾u*5SSIG]/+2~@]ŋ-X0QOu3t.ؒmɵ<}ҥeP`Lސٽ{Iܽ{p@)!a4a*}}P\r)v4rq)-2}Y'ɍ ]"HA<Æ8w.CBt*5cGߩSI{ νGuB6!ZZtYc}fȖk@Z6}p''Ǜ7,|t[󊻻KO13}יbheҥKMӺs%JW2˭bE bͥM{S2}Y'ɍ ]"HA<+VըXn͛Tj:&Mp3&LRfzp]ܢE# <)sd5wC ts3=&!tH`86w۾VV{] aD F`Q榪_Vrr(E t1 aD !ta] CbB0.!tfe$Γٜ]0/?.) f(,BlMbB`v]B3hfsvn|%R0"`lE0ƓD F,"t0"`0.!t1 ] CbB]n^βtm _%#t BÜ@M`x;Bk…=ڔ+آEy)`UEٱ~Z˖.:u5$y umy]EKoM ݼ6-tCBCgl%;H؊[N)oG t-7jT;8xMHXձ5 ([OO?{5|/MFҿ縸awYbW,شͫHe!4l]֩ǕaO)[ر˟L#tH mPY^\5Dʦ.mx9 )\[ H|յk+JCo>6GuB]D3=ΎFG%$]+QY<#d+r1oj](O i^``~Z: ;„ gq徻4.l^ΝK6􃔟~:JnF2"MݺLh/tO/a"wӄJs{iH:O>|ݳgE= ao$]}`Jͳ&SonԿ2}v.B7I9c ź~qSW7|g>y/onne%-oswwQ(WW{JѣɷnP2=ݵzj::gn0#[ӑf֬19V2{Ojf˜e}+Ѱ縻4.l^=vò~uZH1)aBO;}>ԩСY^^yai 7n\{Ĉݻ+Ѭg<,y~\޺e]Bаr[fFg``GMϷ߆(Q³c.جY};Tj5096vrvke5w[y tq*)7Z6P֩SUrѬYc}RRZ}ȶKAAC;e [J[3W\;v:u,{Z޾}(.n!X2rj6߿=+ʕ/^lR?׭{jɅ<[O4#K+ݥyt5)oQm蟦 BC34S>jha=Ν~ С9/:gM3LtSon-[{ FF\ǬnL9MJ9ē[hڡC'7)Ӧ)W8ɨJ.ɨ2_ޤ3Ș1eʔ2C=!!ӽ*V pW5,6Je7o&HYJHݓ6}Raasufќ˨o\Ѻs%JWףy\FPAwi].yuFӬ<Ӕ=Ahhu /OpE nFz3j4{`Ŋ ΎuؼyNY Si٩Ϸ7'-=Sގ@f##>.ui|\y: #ܹo6ċ?>ݼM_y݈κlHɥ04veѺuuC*X,&;=Sގ@f/#)^L*lԯ_+99ķmGl= C t'}0.!t1 %#H1"!t]9g>I᯿m@0.!tmݬ'p.BlժϜ٬_xYpl>덍]}^ϫ& 6 NR>}ko+4ղfiikjժb~^yg2^ٮ NNFiVѢEWbΥb۷ڠS2}Wc fK:,wO uIN)D傥@`fͫHQ:4ի+47Vs ^oܸw/SWY~dnMƍ~8gO+h6B P̮wNS3)K黇kt~:ee"JI/^ŜZdyX>>[,"=` K:,wY';B) 23:˴=zϫHQ~^D 7T^pfQR]/,=@xanG6^cGߩSI{ bra|yG``ťr˥تUS%`erRFB͖w޳gRB.ҥeP9)S7dvzҤw1PJHX%Ǝc*}}P\r)v42%ͣeNw"H!R,,u>g8zDݜEJf_vذE?xtP8N NZȦEc.5k̳=\s]%tla*uΎuؼyN 4iܢE#<)pF"t 1%>z4w۾ 񀀗M`RB;)K5?>K뉔\M-B,(tucbJN%x.!t>Rl4BkF,B0.!tv}| 0 P<_%XaN)] E V| '8t(D7ra֐ &uv6*6PD֭d,}D]"HH\ Rl.\ѣMrNN-Z4Y7շNܾw~pe/>J-|Dv#t"Ş"rHkԨvp?cG_| KS\fvL]`g)SJ}ѯ5kVV*˖-KAJ9_)WٳQRӧpu-,mtiYlzj=VXfni4s}k{-*{sR]?m)SKi>-7ޞ$=rwwTܶmKtzڵ]jUYGe4;h{|j;6$-w.]^s8&t"H13X"N.MW 2z!#%'ZZ֭[C\jՊ+WSy.\iڴ9?:^$*3 |?8쉑gqݳWF tĞ խwNJJ 4eʠ?8('֙ΎǤ mz,6`+`۷I;,C&,lz= 2]ԯ_K]y99Ys0aw!&$]NxYe˱߹s8>[,|"=`-^K:,w~\lf#kq㜘=z1 S.K)DRfFg`Chc.جY};Tj)M% ̴eYƯk6BUC6jjbKAAC6e g rŋ[`ϟ uf\%k;;yݻ4iݻG VI3۷-7Cs)GG]s9$G@Yz5[l6PυzӚNY%R"`yv#VDܹ sSy:v:uT` c:M2u7k֘ga皻g@f;#z.6aIYҥKRcx=Yj*w7?>𲽾&L_J,#XE32B)˖1[\Dsmhl{]nN2 kZs W,{t1̞"rjׯvo#tH;(t9kPH"`wo.Bq*ތ] cD]2#RB P"avnКuS)ZEJ`EbM[ ] #R< `Bw~ݗƒ篛2sjayfco|FaCZ:}'R<Y>R,,Z'1)p6x8B!111,I3y%n5ZbƩ2"BХ| /\ڸe[{}"gr]%tSRR}TT\$X/C W]2W,N++,nf(#R,]:gU(Fk))IĄX/քѭuiyJqZq]q`q7nX4ʈ !BN4)y,_m {e[ 7K覥?x 5uzI!k7NOOh)B.`i3Rr,BϿp.@rIq\RSS G|Y}\%f=2"BХ,M~FJ΃CE=<3NXKov(mc:"BN3q/7ԟ h@Gv^OH7PGy?&zZj_{B  B`<໠Q^;`0 ]@Ba΅:^/{ .+ BPy瑭5{$ v.^pzƗnm寔.@c Ѕ‹dÇ{MZ;]]~T JoB/^miI!BNofBϟ;o}Wga*. "q G Pcw<$U]1SHz.U$U]1  tJ]]&B肙0 摓; d*.d/{buK]v~k"ڞIQ~ *zB2ԟڍtsBTҶBB@=ʛTF7vo&.}.-7~vý&߽z@1M77P$$$p̙ ^[8]r5botW@ ¦ƍqgOBn`  +tɄQF3ԬYBg筏jnF)}][\.XЕt*THII&\ox܋Ϥ]\. tf2dC``E[bC?/E ^ tkRvr!Y#kVZLLhSNݸqB=slV9"k]@ڀ͇͙lvѣGK/\PnbbbjjjFFGvRrDZ9  tkO~d7nܵkשS,t ;"tr`Bɓj J(QNP+Q>J*Yd壑Zreիm۶3fTTIRORԬYS6.R'N0=x…R 5t۷okSo {饗aOYvm5[f9+ٞeղu`Úk׮ 0G ~ꫯ,+t-jѣ`)'''+_ĕϗ4P>}ȑ#Mi,7iD)o\\i޼&pOqe+{5Zj%娨~iÆ -Z0l|'''ihѢ[enAlnMn@.BGmVj37VÇj̙3RwGrtt̮-V۷orΝJ_DD=VZnmN)cPF5֭0`@ݽlHC "t [+][T)37.Y|u۷T)Ѵ>|˙-""UVn bO>J|% TPAYLU##s=1ڊ9|ݰañcǦA:uevȟ?%ū`B֭[9*BWvƒVҡC%JcBBTWj-ZH͒%K222D?y'F[MoW\y7*W>ɫ,+Yti>߽lCGyy@] 6mH͖-[276uYces_j:0{1/^<+CBBV^-EWj3f]e=|J-j$/uk ]J XS.힘u9~SHOOW e>׊r C|ԟ g  )t=\jxKΝ0`22Ӓ2RɨPlRs̹sη~ۨQ#ϟ?ԈJ__EARRaÆ__6\IJߛ+3Uቐ{1ڶm%|sv2;ƍˆ0е4  t΅ ( |ŋ|Ph֬Ν;Q9?c.]<<<\]]e[6m,5kԨ̄||T(;99UR>3\IHHaNcs'|RA 9+eիYF~KHHիWr+W~Yâo:VN~/X|64z6ޑ*'WNZ#^o \_P`-`+4HUG F߾Q"5k);H=ͯ^.UNQ8@"ފKU({m2](H`-F%!~b+;u^5rQk5z7{*UNQG]_:V!B  肝o_J9vv-3ΐS)'Դ?rXAS7n\ZZڍ7ӭ\]@$L˦8;o4Dt6/rƼ:mtf`??^ ]Cs#[ddzJKYjt9.aIIIu\]@ fjeG)KkBrBT{%Z7%% _. -=sy{?n/׵铓hf|YJ t =2niS'$`f8j˞$)_)'=, .!!!NBw͚5ϟ'H67<ҭoݎ-m!s6*OJ^O29qr ]@ؕq6gi|SV]Y9Yr ݲq@BZD﷓ejDCWRVc󽯞ގ,WvGW@B\h[ٯސ;c+]. tmX[&,f{Xyuz#S>+wkS,r+Æ9s7ig[ȑ32w9nyFVrFO.Z|<{6g϶ݻ׽J~UT:wۦVeݺ)ef^yyߊ.W_Ǐ[ժUrwwy㍮wF tM ̝Y7qľ-tGM:wyCQ!Izz^CL QUڽpN1)LR_צMs٥K75 +rڵ]kǯ{ȭ[FzuȐJkzBq&EhS27ogw\کS ~7o|۶_+;߯_!t]c;|qxͬIB;[H&wOm_pмWuƍs^~E,B.,lOP'OnQG)Wx˗woMssq[)׬Y͹uY5ѫŋ_Ȇ27*U*…Qɡ5ZfsmتU={V 4a‰ڽ W_m@ tN/_͜M+=pOkzx 53݂9qFuyAYκ,ޥkݻfDKXՠS.NR:駫9;;6jT;>~*ʚ*yOd%WRaI$߃}|e\rqŊ^{7aYh QQ d?>n4Q?HYċcz5e).B)Ss6Xɣ&ew=3jCwD<61UOw= /m` s'{fd'3G1>ߓ& "tе1Au͟VWysWsnZ)BWVcT=B7m_ts᎘- \enxꩪ]@B7WhflL̺~Y޴pl\Ťltsv1ck2۟/Q<_Fx.3rؔ'?t].B7#LkΈzӲw̘GZIݝMXlأоci!t-xk]s˿ڊWg6osw t܎{wZnrK^}G#]. t L̺崺ٚu91ckq(6VS*7ݠ͞mE"t-`]3{t3~^w_mOw3CbDlfTVx.@Bض恛&;EO oעd?jIID_)K oB"tе"rǸp_?4fg!t[0.B ]ې.g/o?=&,4&B!tݜ[«#75a4J/u@B6˹lhmm~Hօ|f]Γ0]@ڪUYSDSF<.0bs{Zef]o@BV̺GFQM7wYGt0ڹs]@ڼxFxF ] y?B]@"] @ ]-Z-c]@ ]NBkB7K\T)&Mٵ3K(.eΎZ\Jg.B ]-ڇU wٸqN7=jY<@B.yF7rM@.^}K|݁PE^;|mdO=U5T֭Xjŕ+7_oiOY>]. tY(֥Kˠ!qpʔAF j׮fJyfn"Сo$]}` ;~ggGg .BBյEE4n׮իXBjsȬܽ{d޼Z5&޸q#v^ 53@B-`eˢ{4W]*w.YI);88]. tQ袟UjNF2˭bEjH>эGî%K:5o0%;eˢ'(ZGWXn͛gk2*Bְ8wwu[M3k5+==]#]/:] ]@ژpvm> ]. t[6FcGߩSI{ f_oߎbׯ_#0B7rn< ]0 n ]eҥKNu\t&H1eʔ;]T~ʛ7yݥz' ts-o@B7n^0&#ܹoZ}3F 0fQ;p.B ݼyFbׯoFyFxF `B}Eb].X"JUAQ h4 XA=jrXĨF"R JEDI5XcPA9svgg.z.w73<.. @t] DDcja]J]QVvyܸ0 х.ZXmE7)ɗvS* Wbg4z,*/a  +V]P0V[Aѝ2eTnf \bM}}WW|ѕxu|K.D.n  >8`s?4,냼zi`{Z^._>UGGOw2#wt^SSM~~k$2/w\bjj\Nv>4ܮ]Kr CH́]{UJ/KBtSS:uj[VvyY\EѼ6??eԨtnuifѣDf: E2f[]LJ,Zqؼf[]dѣmi`H\3_u$'Oѣ3ۋ0 Hvx.]].U>0)pކ L? YpV8~|СX9$dlS_13|qei*3OLCW.3[EwVƼ w 9]~=\և52c׭[  EEWӊS^0nQ"i!><-(܉ݵkuI58:z7Yطċ.eYq6]+{$11>PС5n]U=ѭTIt]?UٶmOwf_ΚJcػyIw~͛Q%%FFzH]]V 6ii4 ٷ\\.[6 l39f$%rQΊ;!o޵fݻ `ĽO[ÒSܻ6MF|$ѭ4EvyŠJ-|Fp3S^cѣ̙XM򩥥ѵk'v2#fpJXפ~M֮þu~}4ώ)Y^wV yz,@>}>@]!![11>Pvt`ѭMlׅ*WPYnvQS.׶x"W*PH~63vx.]]Ql xޑ.nzuUQ]] V{ <HI`ޑ9,DѭVuIlY?, ,B Bt.]P^ Cr?ƪ0U-wdm.U@p.]@Di70Z \@+W0%Y04lee}ՙ-\> DP+DYa ;6PKtoA܂ !3͚Vgpe,]D@Uᑵn͠~379YN(/tVL]tt/)F hX{w# %sٳ#wSNv-JJ7ÎRk]hӦe9}. [ɢP%muy+Ny9ke,9ҖMnng<)@1xK$-++onV֞&݀;##@`zg,)ɾ{7~ƌOl " <{4  75z,xqSӧunрX+XvXlgg%%K&[Zϝ;.1q?nUnM}. [)mk[J䢫i)/Vtiƈ]CC=&_3ҷGG~&^EE絵5arˌ4rܹkRk랓&9T<[}. [6󦴭u+uPӦ11>rY%deUr7:γl3Z5$])% gFp3Œ$_n'##4…ܸ6^%볰0g J5m7oFdgd*-\> Dѭ঴ UXvIWqqyYUMswa`ۮ]K36 7iԔ,I͛WnC ۤ5EGnٲ^籍XM:ѵk'v.J> DwPtE'OK4n\ꎛW2)meMsJ+7,;)Z)]8'KteY-}or7C 2\饢w#[8D.[>g=|mpwr u\fVQmd4\XAÝ:K& 7ӏgtOHpYo4 rW@,ѕH2z萓C@tVl>]o(fTk͕27Y4PZz;fN˝M]Y?.ߨ" f鱲Ėe#ū6xŽȻ\kԚfծ:CtBt!(9i,e ><-2n[է6(*: c^fMNԊWtace U.yn%B#e~3]sqE9E~~ʽ{ nnes*,HJO>ŝP<9I9mHV5/u[i[kjċlLޒZ] UҊn͠f[]E4,]޲OO00m׮%o='BSS"o)S1hkk+7'ݲe3=Fc0o2Z1ɨjcԂUw/>)oе;tdF_"1(s~3 6;9k7xKjAtV111AAArC}S})"P:D.Z*$(+wD}_=" ] 2n_vv6bbbBB}GM.  +GQ/777333(+wD}_]D DDW&dMOy~T!@t@ta~^7||]J7Z>y?;D..*ϻsΏ]QZoSǢ[K@tśi6qnWS @t@tPU) l _6Ct Nl2 ,2҆xb;@tzSǗncSpA>*.]]Te37&R, A>6D..*Ciћ!g#2@ygJ˰5D.. bL> @tBt <5dģ l  }2.Py~c"&6>D6J.r,l.]]Ң7R ryj_l.]]] aTY]TUtP[q~D٥_cLM " vlN-Z @xe2aT:6EE %v¢koo{VI{~D5bL]u\@tPmEBLLLhŦ |(-o>!+} Dcڴi󻹹`PQJޜu\6 +ǧ.\Ygj U'RT#+99׶mۘrׯ?y)@t*R^37"2хVD.\kѭJKK6lHKܵknfff^^۷oD/ݎ2)D` \ĉiƍ >}q2]Z<>u,Ax*6ѕӃvڄ LLL4hХK - jkkߟ^JX_v444w~ 6hтT\cfffC@ʕ+ uwEc֭Kj֬YXCBB>3YJvȑ3~\5"hS=*1>2e)MhllvYEzܹ!C4nXWWښZ*0%f)ߎE-;t֢>S'~· @t`O۪Uׯ_tHܽ{޽{4@/YeLۧOo0/]]]={vq:uj9|'GBNN).ܹs' Svu֑Mּyd9VVVdee%%%Q4 J\拸>T1Ύ###߾};vV{󅦥կ_o~ɓ_-|?H|;r?lQQ&ٽ{wDDDzz:^ U >'||ѭ*DiLTTtcF<Ο?ϼȠ666\Ӹq yKCC[^=Y-iё7mļyfzI#iH/jݺ^ 7|6KVQ5af)ݘgϞe~ wD~$իWcǎ坏oĠ9r$2e ^ Ū;'xĉT|97T9^{] z0LzϟK7֦Frs.ܗ޽+r.).I )4ޢL˼qƙԭ[ Z+Oċ&bQk"###1ƆyI_t^.\#E3 ~>ŸKR$1600tw/х*,gvɒ%?OM8[$Xr.#/^PLtyJaeՎ())Ù[[4h0?hhhHzmfkkKc[!ǀո[k"ZviӦjՊuEY_(*RXZeb{@t:#|jllm6g͛cƌ񺺺...G6/_rJlaaզMF^l[_6·Ymu\0* ʋAhLtttc[;K%n]3r"kaŋ%&a-s*3~;:uHHPY.WȺWvW((`) KJ]Y\Ka0ٳq2]kȐ!>|?=zHMM9̙3y5Un?~x*,͛7{f̘!rJΎ|70_euru/Dݬ,?t͛SLabQ1\Aɨ*Qtg2nZTT?[XXHLH CAW~~>'_~4رcСC3iѢ b]ɨ*wM_LNNI|3uz*(dڵôV>W"r,--q2]}lk׮ԔWSq100~jﾣz+w8.d,W?:.vK7Yf-/O:|?5j-+,,LZfe^~Frې=䚚[޷ow&1ň.3O>OϞ=bfi r?6햖6vئM4R?cWEtd>C؎!sk)r?,д 4@tժkii34_AJ?^j5ݜC#%7||<|Ma;@tPd{&]cSٳgeeeX$l}FǏ%Z~!..D`ˊK2'JU)Dt DPgepPc֬Y3lذaȐ!vj2%ܹ3fv|ӦMjקORǼ߿u^z899-'NH]RRBۢE Y+ R\]]|}5QAtܺuMM̀ܽ N ͙3Yfܬ'OԩS Znw߱wܩ/]CCC۷o3o]v<Ì?~8͊[XXmxH N] $]tcaٲe{&@u{O2iUɈ;}D.z0(_M€p28M"o1# @tуBұwGaR? ˆC1H @t+ԩS`CT7nܔ)Sϟz2iii]\Y3_2J.N6$X]@EE_Ԕ *DT\ձcDMslT]\ӓ:() +##} ?||e, xFE=zɓ*f4OٓRĘ:}2SZ{ @t|_jƌԋ"UbN;ԑ(#lσԗn㺮r?] j/FlH)V1 Ps9˹l i\z|WH(. D@ ƌI\*f4+چBvӸ>٥_ˊKD.KdffUi݋B Diِߞ~qƆ['Xپ{YJyz~ l.]*ߗ*i|C~Tz398𫔂yqf] jkG~Z0Q=n݋Bl.]Qt=>|@TO ѭJ.-z @T̬`=- @t@t!eе;cbb*XO .TtN<@t!޿w>;r#Dɵ܏q%*-=}=%g_Y-=CiD.@t1y*^Zww5h`ljzo{s2ZR7z7tXe.3PPpnyVV!>KICiYQ҇/|[ ,oz̈CF.4]Ԃ*vE/kKڷԌp}^mԀ4.#Dn3ykk>IDAT;Y .:th}:sYq@83WD"qb1NT {"OEtI-b˕nbD7*/ro2no>M+-LٖuN"wEE絵5a--W2?LXsbc}LLpRW}iDn%W @zǤ>#akkXLŌc'T\S!j #/8mщ.w0uay߿DW8?{)3u + k׋|FݻKnŐ|ǘ5'N,.κ};v̘uӦZAqڵœyٿk޹d68_"nMqR(~40Yli;th%K&?~D]4޽^fr-k=15h?eQ!JjAtuZd)wO1Y7o2~П~ aߊS ogscb}KY5Inss?~ WםɮwJ}Pf'%NI9T9oDnGI:z.,- ݬ\5]r#G60/cc}NRVvol۶iNEE٩hs `˖͚yƿ}{Q w\bjj,qD~P{Zn}[˟K*|PD7 F.پlM O+("J{O j AtV~Dt`zVr0r-|]TdMrxw܉z٧O_=Rgxx8,^N_< Y: 3leՙm0dHNQЀl3tv4l8/Z!=\bG/D@$ tR׬M UW]5݋B-[Rzrc>~4gؖ-5rwbbD󮓓9ptíqm4gz4HÚlÙkڷ7;üufr"׽=`.DWdFw|6ny'!jΥ9[($FDn]SGJ^CV5!Uy71qyB^$ښ I"ax&-- 3d.)Ctkf8PZp}:j:DH1xg=^Ƙ:>+w$j AtV3"cyFttUAYj |hߦ=sys]%y^7#$7$Ds!<%*Mi/jr! &Ê?-[uq]"cF-[b7 i|\Kb_F+t7)3-;DhLY3kȐ'P ؇/ G8ĵkߋ:UC{\=aJBZ+^-[n5(wz̈CFH> Vc%2MExZn|IKqWCǹD??S^ejkkY!DWi)+.mL;j AtVa -ghx }%jhVFh+\M- bƋ]޽,ѭul"ڏ 3<٘Ji8rfv\.DWDS.-:w53kwLe`<\JYUZt]!>[M1/*bL]KBzL.GI[FHs+Ӂ@TOܵ]E];Me07@t"rGGꚵ+UIPC gt8@j^tqP@@t'?ɠ%[Zcw E"a ]3&&vlkÁcWGtp ibWv+7EFFҾ#.*)D-Il]{" JZwLˍ] \E?^uE"u[bh|Ӧ11>̻0퓒|iԩYΙ"0pc׮54oozZlE~BKKGF4lee}84 87-Wv0zcz_14>w U|;b#~111yyy]T.i"jGM%6UGRG\'ٸ)%* BxB7$y̏8*6ۺɅ G$[X];'??8+-FXLխ I[2&,*:O:=uSL1KLO뻺 ~}!8xkf84 ri<$c_G ˞؋mԢ{xFf,}{Kè}^E7s/~Xkgg%1^OQ^IUka4 U}ϞoթS]̥f+ Ec6Kawt^Sz~~kjl2ؐG/ݹ{rؒ1;/ X.ԆZ[_Z.].@@t]c$Drnf>K l/HJvΣG78:ȑ?^x4g3t-- iimeٲt파ѥrwg]+Y_u_|zrH!6'Ni_Jj^KxYaSoצ#'?] # DEtnFչ'O"#ׯ׹s+ aoǷ Ox[۰%D}h®Wtc__رci%-- q9?FPͬ&.NaTzYqIm'4"q-Wn`<~?@@tCt;Zk)zzdGdlnݺEt*]˦ƴ7o I^1 kkk2JK/3msN]K{NPoN?o5_SITqf݊%cqΞrhuOu1f> oӦ_>y&wKKs6/I۸9D }: PŒZ$?nm¾96-͟$͛tf&넲mۢӝٗf9'$^{bW2o݊6rQf$%rQG ]Н@]2XVZl%Ͷ!y3$;##憓ɋ;SĘ:V'bɥ,q{/3l>zg~9Bx{WΙ3Vؿ3\J]P'83DDPŒZ$ؗ>ԫ04>ڵ0Yg=:./Ϝ9HcLqȆΝ5hP1 `gtQhM7od9촤K hkk+7Fݲe3=Fc8ZKKk'NIˋܛǮl2Z_uݟwJaэBLu)SF<ž|2O1Û6gNڦiӜؽԞ[ξ5o;O4k맟vzV %倵uƍuzH>Wt!ʿzZ,Y9)zpiΖWy{Q6*,3s<]J^44O''CWv_L]s'Ռmk߾uٻu3+)ɦѣCNNЋgg=nЏO4xhQo3.AV}t^|jyA[7WOq\wӨJPgt%<)?~= 5ݨ7+.OY^˗UVvDW&uOs6cszxv-aZWq;5޿iޔ=F t DI5j3jݺLk*, ڡCk\E>/P _mU\F~][=\^xIIcX=a0fA/KKƍu1Γ ԇ; o3ۘIǏ~9tpkfM6bD80S  DDWOLE͛,(-L?j]t!󸢋_V\R(SUTmBEܖ{"6n\l ٳ3ff23ᐐ66H_ʤ_}5i|n0Y͘˗O.q'NtqL+f[CǏdT@tDtG"ЧQ IDZnJ<)M $II] 5vrAAn]-π@_E2}^EWrߺ:iSMM [[?5 ̾ ~p\?="oU|ϛuw _2;eܹ>NRt]ͺܢESa#rNL^Եk{--PY3NǷTs_~O ^-K 6o^`llD#'Mr [^+fܹs;?5L}i.JIF%=[N?DU+JxXX];'??8+-R>f.0y/ CtPZ&fVe%ϯDh"-æJ?ݮMfѭXj_1ä$*AtPIED];<ۭ;iggըQC{wƳzR!~#w>jԀƍuw7:.e%uѭF;vmѦMsa<K^"sʼn<*iYlWnH/T AԣG۷"˴$f._KKs~؈>.ɓ{tߧOW(1VVV=?vE]\O|{fT{erҗMe D2Ps +WN2Gx9Ҷ?ޑnngQɞ9ӅV?쀡ޙ3KJލ1c! k/f?]^J:8,^SB?rdðahiil3U.{w&'{ҧn#Wg [{;9ى,Jbz?)u\Rݢ?" (I]H>dM<_+޽7-S,[6e] ]:J$lϞ10e/xq"Y?ޑFFzi̙y" 5(KL4;w\b~C@+_~λ8A=Hu܎M$+kT'68x+spc05T׫'a/-?-#GҴjRxEɈRuR\}^BrE@t"]]CCOI`.a׮='Mr~W[\zq:D.ÁQ?6hPr}Y EWOG6NNNj׆èضΥEoTHt)2'-+KpT< Du#]o]f3;8|4rժuYyGRz%  U כ7JJ32rr缋#Gڦ Cn޼[73J(*:G9s˙3e?,e([lZ%Z1Z=ZIZp2ũxnW-e00{Y{2%" µ\.]]tqRQ~eEhsEQʪ3\QJF%FyG>}>@]!![qdAtGtXݾF׮OX`c_y'樌 >ڵ0ʪmz\EJ'YhhŤ/ֆ»1o2yvpN,udSGnO9bߙ_jTBt].N**uYL}{qTUrWB*=j<);7+]&_'sYbqiVQt[7V*-oz!''_ E@t!PZ&Bp㧪(.j' Vj/R/AtѧGũ#ѕ#(]@IɹTUmEi;A@t!ę*PS9(nAP{D(VOܺ:iSMM [[4vnEN#4Ҝ-}O(v*Aw@t [aaav⬴4*=M l ˆCWW*xEwv: /n@EF BEWOغus}_NvZ:_7666 Ajj`ۢEӓ'$ Zz^II'Vݔ^ .%6 p O .KtQjQDW- ޵fͬŒ:UVv9-ܼ-eQmT4ܩS[db{IIb,T+ptE TO6 .]T[A@t߼ɢlӧunр'tK0ۀ7x$-2{y;[brsEWz"{Rxgl[g. DJ$3`jjW)M^O!M^JBtq@“A " @t.(饥.\.^ty#miq䥛7/͌sNptDPݓ1]D]ԍ@ԒJU'4o޼ڵsċ.o2p1ɨbc}lm-455 v-5\MF%^t&HG@tf㗕]7n(3L`µ~;> D]T4Uѭ eBѣ6aC-+ΧO+|0 ps#j>O=?vb$]T.F jG% oV YtoAۛ2__ڬay\4@/CZѽ;"o> D]xF*p ɩLّt|\ر=;vmѦMs?5H3V%2(U'ĩgt"]1t`S\/h} rt-- 'f%OK?R+рEGG;##@83KJލ1c43Vۋ냨='eQ&#n=@@tF!u'X%^teUf 7xŽDwɒɖsKLϾ Il2QT DWeKxʝpej]Dbq%FWbE+yіo][}ZnښpݺuKK/3msN]K{N;ƭ8){V렦M 455lm-bb|ʛP^}II'I,ܘZfE T1Ӹn=Wt'/[XMF[}[ Z<5 -9mHVR_/l/py3$;##&JN> QΓBYqIO^(߿dvo_O "'Հ}@w„atXwx^3lii^ϥl D:kO).΢ TUvIYe* הrvV]2Ghu_EL fWB=~5@gt/xFԔ,/[}[ ZVyjmm{~\-[6&ڵ;11>vq>ZxR_B5"ӧ; OksNC&rB`t#̬UyJPnm%*gѕ UdΔh >[&Kj\ԥl{Q4nӽYV~؈fH%-}dj%A$v@shPͥJ bJl+"ЏWѬc?;8KVee '4QN 7" { *N%t `eA_NNva3f0v^ *\giD:*-r6ڵ0f%Ϯ- .Ą 1܊Μ9Hn̘I6pz665jH(6gg{_H*)ɖ+gPD}ދ{:5mX?KfbN13y gˤwi)]|%|m6< `сmfͬși0;uj^=s+WNSfta~7%ҙ@zM[ -wVj:@?^"JuRPZomUq*lEΉYrXY;p`͛.Xָѣ͛,kmݓQ_G]kkzJyCaԭ[H]]˗$*?zeӝi$uH_dfiZӦ"be,]jn>]o(4kU֏'iܹ݊ʛ9\2w;vȈ퍌8c/ ^sWt&( ϊi) MaeWh.Dх"pT߿KSEח%n}p=''WNpDN^ 5th?1r]ٙnc:B6o۶mx'm@s4e sK?w)4fݻKuR7֭݌^"H;G+gPD]?KxB@L2w9A'+UwWtJ"og劮Hܺ E@t! <5Bp*:H"~vo*}={ 3L\$8p`#%:l^|TV-%gggѱ}.Kt{^cckkah7|5W@nLn2D49vZ6]dTrg%rQIn+rvK :F"Rb \)m-Ǝ>bjIoLu+w.wjTiyu*/}zF>0]Qû_Yexsrɚ CY A\ַ/{()۱c_B}PV\=K*L{q2s] *zBEMv>~&[F={vFz*z 7M9γƻ {۴iի[bMsbo]fK.Β[DJL+%/%qY]S\`CU3ؑ,mdyn@;Rx-k;+˖ME]7~^oYVaaFR/7{Ÿ֙ \׆wCIܛ7p\+)6(`0gkDG}"'ՀN0L|} 6\]ёfii2++kn%ͬ  -٧ ѥ8rdC4O=ˀudT::dTSJKmqy ]E9|<+Rwʪ3m 5jέ"Ct`35+O{6Οw~[NnY;Yݿ0p`:=~.HFE>)Rd} mm{ n(U<)$%$Ϧwp(sUu_Nӧ; Ok.ӯC&rB`.qtF+ZZ?{E&]OB,CyYsBJ'R-q͓RVZXVLyuԖT\ejjVFJ.[NoҌW5o/no^*Зd]X 7;M/Uz?W2oJ}R} țs l2,s{%U੤LΟ ?ШQC]VsgiDEL ]۳=WC%ϻ{'ٖzLzm 0cQ̙bRufL´ayWٞ`[ D둦[G_?o!XGW"'tKi-yr ST"bI,?mt3;;c610O[8]BNn99A5ϫtJ߀#-׏^twcP?~w8o#u\ <:jEF[>&޼266:0i9̿Nޥ=%[cޥa=F?YhB2Cl߿ϡs.wBY ֭ AKayW<%ӵSucnh.g᫥}7'tni-y]cmKbYi3w :o}׮_/W"\.D2-A흂gXgEWy'ts#=?vmd5W8(:};;a-oݻKu8ϊn݊aFsC1S3AJ{mL}Mmۂ6 ԇո dn.f pFF{iȑ] inL̛N7'ѕrSXty/yEW$՟6/doquTDu*]~f+%A-^R3HF2Q>P5<[}oS731qy霞p+rOVm+U 頬DUH_)ۺ}ab)C_M0߾{b޾Ӛ5.\8M--`_"^Y3C/ߴ$&m̍nWSdgjeL} i*1 _r-lFǗ!w'pQiq[U[.x5+hFjZjV^Ӣ0ť RbITB\Q\ h;w03>x9|pޜ9oҖXd'gw[N-oc-/g >I]W%gH-rܠ;Ǹ26yFr^[Ӻӯz_Ξի~~zWW)? 2Ԉ7/J dư ܭ{}Wp*_u-y$!Czݸ(.P&nߗͲAYTBO²7hbH- ӧ.w]<ʬ~/~;9}3K&$ڵ*??ܹwtڴ78k݁_и^;N̙FhfD."7;ݥu)9 A hvtdV3@YsOU܂xf҃] L7c&9WW ql0?"Ǣt?AF`A׊-n.-]ٯ !2GuoRr*T:jƍ :7w{]6X3fPFFd~~޽kWw6E ֫ ]BCx)OХt Aa Ok\fͪ*ܹ?E" Z^n~E]⼜}[wyºurvH,q>qskfRhNv+ޭ:gKFؘ ŐZv]uY^)/-qW ~PkJUZʐ~?|>{,a5 #?{7SAxSEYT"0U bYqRp?I"z>&Nҿ\e%؛/bL[Ю8 ŐZ?.`AW_bbF \ G$Ϭ<,kZ.P /Z\GC*`!"J­M6iu{]cRhKti4iiios*Ϭ<,geett -ʪ6t CDb[vNyt 7nB;|}Be*sjtKonUztee4M<+rvv6A 蚬jYD<蚵( }v%(J3-[qG_|/֦Ly`Ikڵ..AlV}+6J8Ad`/A/"na}YYYciii;X9gV_y_N&.i*'"+9Vέ*T(_s^ p_|gdDiT~>ZG] tfqHf*LN-]k`GA׺/"na}%iSp,3+ϯ}ԩuG,_8^Pŷ޴A tie /<Xa APiZe#;v4k;)56v~Oq+VW6ҫWݱ~`Ӻ￾}wT%kvx1w|׫*V6^L92tuGK3O^ep8֟Wݦntu/iZMu-w)T-A] hvt4nJ‡+#! &uo13SuTnVL#V |S}smIFRJ*ܼd>tMoM]yIWu_Pŷ|t]pP+s.ƋPixa0f̠{ȃKetZwܢWt=&^U}7~&8}>>|X9uU]}~:\B%Axϻkh˭h;Sk z]t.AL rfРk֬ZBΝ[i4mjT/Bq3媿S%vؼyMT%2f:Xk;F.yuc|kͯޣm޼nݧ+Ϝ9|(/\ֵkr/tDqm>BC/팙Skooy:u?=RRxnS\Fwp~7=|? fO81hРjժ/_-44TAVZr˗w޾?>~e>lbr bwAJt [x*%#>thŋ?S!x?/+TfNU_ ޽ .^giL;t%K]HZϟka t-,BP+jEJj|+ tҦrsww;w.?M4\R]eeK0.!_tw6i =}O+UBobtZn-m۶ݺu~iҤɉ'a|}} e'ZrV5Ԋ$}t8Kedgd$zxt53fAugѥ4Z>ͭY~~O{JBjkKn>}V^-k֬iv[VgtA]ZP+Ҳ#"%7m{]\(tꮪU4SLυqMgK#tie$J8+]A[!׾JM1`"/@6MY4(O%=ٳK+'3AwҤITbAoӦMBBWtAV RV,+J29gG-Z46޸.|t`S3+%0 AF%vKЕ}+pԈ_رM*U-şcr W_~EwW??~iӦ=g&肠 ttjCșSέ*T(_s^ 5޸RJvQ+%0JݓiRlrtvt5{V),_e '_f*?mAA__#??Yfݿ{K'gSAw͚538P{- E >\rڵ3338@ett`Z{^t:J]Fݨv+FU3êQ&2uψq͛7P|OX1AxU]…mݻ}"#Me3>pqRVuفVd:5n]b~kY3#j\ԕ[:AV~lJy%V%6v]e+oذHZ nnnFi۶q^~Ϟ=g8ť| 肠 K+A_){ZR2d^=KF3Ղ}TwpAi卯YoA7s=<6y+lRyUj\Z5]V';W7.,GO>yƍD5Pb%T-_PErs|#qZdI0;cXVcG@f޹"_%d:A1mW(AFs/11Q ~tvaV߶r(ϡ]]^07Wi}ah˃qwI[۷WTW^`u-٦jEu @u-wױߣzu<{-젘 .@%V&!1c`tύZ kmS?9P2++˾ne~1>7\$(nL2_)@)`^|>W7NV]S7oS~}~SX-{pHr9R{[.@Х-4M`?z/ZۓOB9ζ+B'^mssg>3(##2??y5ի;_ݸv- T-_hEۙ"]9%^ t)BK /++K"---11q'PJPE9 _n_Awur%z 87TݼyaݺO9;W9s|FUXyF6_ݸ.lڵmr*k~-h;cIc˃n m]*>< ْ.Z)'r@WUn%oJm]SUORApؠKZZ_YWGzJZs<.Y.@еEh~eP7vvw%\y9{MKtAXl.RE|ƞtOIVlʩ5z DХ -m]Т $+ mLK=&޾tKtA`+A" Ԁڽ3,R.A" ͺt4y, 4×]2~M|nPOz%(.@%eEjh;oI3>w .@laq{}QǙMtvm'o 8b] آ_s28-aLLtnpn@un$%Zץ8.@,q zek sA3S|]!k]Gy5%~@]{ͱFG0A73/GA? ]N8D?#w fhF%B? ] ;vL}&k\ɺ.@֎$yp/N^vΞ~cZz];z@"jy~@#3b;sQx3U5kՔhWOA e}WǴzvcWt->w .@ʖ89AXK1I.@C9ivnpn3 A өz:25 >~@+; [ P/ׅ`9ҩ/>w tI86}%#fӳ뫹_I:JoDz^MIt. ѷv>9'YS_Q t0bJ7Ze6cpD73/sl ]Ņ{&aAtGzr` ](^Z{:ހ _#kvjMƶjժbŊ_r#e{͜9AUV9r7tdEY}G-tyz=#mFu's` ]n̰Q$KDzd%t!ޥ$S Ĺo,_V8>aaayyyϟw ~֭/kĉQJꫯ:vX 2f~3,t.+~wu] r|^:4TL_8>3/pߠzIe~_nK.)7oެTR˟;wNYՇV%Y=ܥt. 朝}]7'jJne*ԢS-SA755UWsEGG]Ig~GU}kfW}hUb] ڮ S>wUAXfX$csdSKCsoDJ65Ϩڵk+*4iDժ-4t-\^U/ ] Vͽ7uhWOI#I^>߀f7KC.F`@^vq2d%m֩SGYf .޽̑Ŏ9o. tؐ_Ϯ̥]X=0݇ ^AlҤIŊ[jsqqѯxbWW *4t-\^Xu%G! t Sek9- 㾫mwN8ڵQ t 9]$L嫨~hYKW48XÞ\ɺ ^.@`޺thҢ^I˛в>Ir\I_?؎=nf^)c.@`gT?|nWz |hqձFQޜ uՔhWOpc=J t8b*wc+KUer^f˿AS]k1r7.@!&-{n6ݼpnZ *[7R{k_BoУ t88+IG2t^O=6}^U+eAz5%=F[ZsߔZ1s8*t.$/3ხw $f, J,QvKF̐ J$OG7pn^ϭA{:r]=zM_ivA׀[IrH+W2$a%7&2vmK qsͽ! t(^Ƹ,e-g|vI1-}( Fm?t.X݂Ǧ̊kI#fЕr|-kKŸn6-aYV/e_H6ڎ;r9\.@ #w}|X.Q%yX8"+l'Jҕnd}W*+@`Ӯ=sv㾫 { '̿D+v>A ] i aq3 ?H+[\A ]oM>9þޚz]wχ e= k;W!]]3/]~B %۰jJ\-Š:m9njT3oڴͧO[}dca֭KZv=p}_~9gϗtk933f߾CxuS5{KM #I_Q`=)(+AAGNZqՉClwVKD;ڿs1rwUhN',-sv9n{CMmڵgʒ-_~m6n-TfT6jTOݪ,|F⫲VJ2}J| uի;+1U ze˗/'Q.] }Jv¡kGH,|(G򖃞qTA7=zMFn+w5;vm+6{Ҏ{erx$]]v| %]-9Vb,)F01X$^YZЋ _NFofXXWS5%?mi5.@O-6G$yvO5UuYx,0H?B[%JsJlAnײ*;) t.{w19voY^ZA75^޳f;uU@K7Y˩3@ׁ3k, kG*ʈDV ʝ?SyK o^L\.@nOrS݂WSO- >^Vh@D$ې?$Xr-Wa}TR.A ] ?q%QbZzV$_eZK?]u݈/&;Këu%`%] @4{:SwNVѹca*s=ƹ{mm2` _|"NG@O4WY/ t. FJ][NnT5PAW7ЙKRpw*2GوKA?1(bT%ti] t("kT]&tt.]] (A7c|I_i't.@x.A ]1f,w9>V2-c<.@o]@. tt]A ]]] t AP.2..@8TХ1..@8Te]@ ܣ=A@Хt..K#] A׸]m„an67A ]歷3HA/?MoΕ锑iF ڷ~d^{=oڕ t.];VR_}#_?=vZX3mĈWWn=_j߹BAQ/]}GUeLk޼9In!CR2łeZVZ7ΕJЕjj7bj]?m<2r2pQ"ʕx|t ]l"6[qqJtoUU#6hP~2'--_Fuݰʊqq+Zl,7p`W]޵k[e޽k:ujLܹMozhj7d_b?S&N IUCE};t.@&ne~1>;o7z/ݺܹwwG̀e,_>lmΜt>lQeL+3_V?t2]Ps.m%.YF%Q۷.Əc*.@D}~P+AT5p„a7o&m޼'*yu3_x˗w3#^ZǏ_)۴iz;ڗ.PC}eI]CC8r$7z޽TSt@V6Xf>:u.ooѢ< A ]l"$/s_w|}끪ӷO=UvJ}Nھ};/_Nv…msI;vpj,{b}j>_|+b4gʊ2\NMRElAWIu7nJ6[3UPw *͸A P:A^߾yrV#WJx'ə旑H9dHڵ/>gl|vFoS0t.@&nɷp?62roX|Ɇ ?n=$] @Y et.@K@.A te6/V2Mz t.ti%A P,Aεw*-et>{0Z5 A `ON4NN$t.@xnbbF \"-}.=j9z.@A7--M"""$}C~ޖ>A+]9{KNN8F',-}.= t.VYYYrOYz[\zA `+Y+;;[BV=',-}.= t.V.@t A @.@t] A@.@ ] edMN A`A`E] (M C}<;00P$&&jZ]@ٹsgDD<y#SySMKK @d9-h4! ov*oN @9!KKKKLL xF*o򦚕uu]@Ζs2V{ TNMURn^^_. A.]?-|IENDB`java-design-patterns-1.16.0/data-bus/etc/data-bus.urm.puml000066400000000000000000000036671312550536300233200ustar00rootroot00000000000000@startuml package com.iluwatar.databus { class AbstractDataType { - dataBus : DataBus + AbstractDataType() + getDataBus() : DataBus + setDataBus(dataBus : DataBus) } ~class App { - log : Logger {static} ~ App() + main(args : String[]) {static} } class DataBus { - INSTANCE : DataBus {static} - listeners : Set + DataBus() + getInstance() : DataBus {static} + publish(event : DataType) + subscribe(member : Member) + unsubscribe(member : Member) } interface DataType { + getDataBus() : DataBus {abstract} + setDataBus(DataBus) {abstract} } interface Member { + accept(DataType) {abstract} } } package com.iluwatar.databus.data { class MessageData { - message : String + MessageData(message : String) + getMessage() : String + of(message : String) : DataType {static} } class StartingData { - when : LocalDateTime + StartingData(when : LocalDateTime) + getWhen() : LocalDateTime + of(when : LocalDateTime) : DataType {static} } class StoppingData { - when : LocalDateTime + StoppingData(when : LocalDateTime) + getWhen() : LocalDateTime + of(when : LocalDateTime) : DataType {static} } } package com.iluwatar.databus.members { class CounterMember { - log : Logger {static} - name : String + CounterMember(name : String) + accept(data : DataType) - handleEvent(data : MessageData) } class StatusMember { - id : int - log : Logger {static} + StatusMember(id : int) + accept(data : DataType) - handleEvent(data : StartingData) - handleEvent(data : StoppingData) } } AbstractDataType --> "-dataBus" DataBus DataBus --> "-INSTANCE" DataBus DataBus --> "-listeners" Member AbstractDataType ..|> DataType MessageData --|> AbstractDataType StartingData --|> AbstractDataType StoppingData --|> AbstractDataType CounterMember ..|> Member StatusMember ..|> Member @endumljava-design-patterns-1.16.0/data-bus/pom.xml000066400000000000000000000040551312550536300206510ustar00rootroot00000000000000 4.0.0 1.16.14 com.iluwatar java-design-patterns 1.16.0 data-bus junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/data-bus/src/000077500000000000000000000000001312550536300201175ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/000077500000000000000000000000001312550536300210435ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/000077500000000000000000000000001312550536300217645ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/com/000077500000000000000000000000001312550536300225425ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243725ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/000077500000000000000000000000001312550536300260155ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java000066400000000000000000000050511312550536300320600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /* The MIT License (MIT) Copyright (c) 2016 Paul Campbell Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.databus; /** * Base for data to send via the Data-Bus. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class AbstractDataType implements DataType { private DataBus dataBus; @Override public DataBus getDataBus() { return dataBus; } @Override public void setDataBus(DataBus dataBus) { this.dataBus = dataBus; } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/App.java000066400000000000000000000074301312550536300274040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus; import com.iluwatar.databus.data.MessageData; import com.iluwatar.databus.data.StartingData; import com.iluwatar.databus.data.StoppingData; import com.iluwatar.databus.members.MessageCollectorMember; import com.iluwatar.databus.members.StatusMember; import java.time.LocalDateTime; /** * The Data Bus pattern *

*

{@see http://wiki.c2.com/?DataBusPattern}

*

*

The Data-Bus pattern provides a method where different parts of an application may * pass messages between each other without needing to be aware of the other's existence.

*

Similar to the {@code ObserverPattern}, members register themselves with the {@link DataBus} * and may then receive each piece of data that is published to the Data-Bus. The member * may react to any given message or not.

*

It allows for Many-to-Many distribution of data, as there may be any number of * publishers to a Data-Bus, and any number of members receiving the data. All members * will receive the same data, the order each receives a given piece of data, is an * implementation detail.

*

Members may unsubscribe from the Data-Bus to stop receiving data.

*

This example of the pattern implements a Synchronous Data-Bus, meaning that * when data is published to the Data-Bus, the publish method will not return until * all members have received the data and returned.

*

The {@link DataBus} class is a Singleton.

*

Members of the Data-Bus must implement the {@link Member} interface.

*

Data to be published via the Data-Bus must implement the {@link DataType} interface.

*

The {@code data} package contains example {@link DataType} implementations.

*

The {@code members} package contains example {@link Member} implementations.

*

The {@link StatusMember} demonstrates using the DataBus to publish a message * to the Data-Bus when it receives a message.

* * @author Paul Campbell (pcampbell@kemitix.net) */ class App { public static void main(String[] args) { final DataBus bus = DataBus.getInstance(); bus.subscribe(new StatusMember(1)); bus.subscribe(new StatusMember(2)); final MessageCollectorMember foo = new MessageCollectorMember("Foo"); final MessageCollectorMember bar = new MessageCollectorMember("Bar"); bus.subscribe(foo); bus.publish(StartingData.of(LocalDateTime.now())); bus.publish(MessageData.of("Only Foo should see this")); bus.subscribe(bar); bus.publish(MessageData.of("Foo and Bar should see this")); bus.unsubscribe(foo); bus.publish(MessageData.of("Only Bar should see this")); bus.publish(StoppingData.of(LocalDateTime.now())); } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/DataBus.java000066400000000000000000000042561312550536300302120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus; import java.util.HashSet; import java.util.Set; /** * The Data-Bus implementation. * *

This implementation uses a Singleton.

* * @author Paul Campbell (pcampbell@kemitix.net) */ public class DataBus { private static final DataBus INSTANCE = new DataBus(); private final Set listeners = new HashSet<>(); public static DataBus getInstance() { return INSTANCE; } /** * Register a member with the data-bus to start receiving events. * * @param member The member to register */ public void subscribe(final Member member) { this.listeners.add(member); } /** * Deregister a member to stop receiving events. * * @param member The member to deregister */ public void unsubscribe(final Member member) { this.listeners.remove(member); } /** * Publish and event to all members. * * @param event The event */ public void publish(final DataType event) { event.setDataBus(this); listeners.forEach(listener -> listener.accept(event)); } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/DataType.java000066400000000000000000000051241312550536300303750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /* The MIT License (MIT) Copyright (c) 2016 Paul Campbell Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.databus; /** * Events are sent via the Data-Bus. * * @author Paul Campbell (pcampbell@kemitix.net) */ public interface DataType { /** * Returns the data-bus the event is being sent on. * * @return The data-bus */ DataBus getDataBus(); /** * Set the data-bus the event will be sent on. * * @param dataBus The data-bus */ void setDataBus(DataBus dataBus); } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/Member.java000066400000000000000000000046671312550536300301040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /* The MIT License (MIT) Copyright (c) 2016 Paul Campbell Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.databus; import java.util.function.Consumer; /** * Members receive events from the Data-Bus. * * @author Paul Campbell (pcampbell@kemitix.net) */ public interface Member extends Consumer { void accept(DataType event); } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/data/000077500000000000000000000000001312550536300267265ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java000066400000000000000000000032421312550536300317500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.data; import com.iluwatar.databus.AbstractDataType; import com.iluwatar.databus.DataType; /** * An event raised when a string message is sent. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class MessageData extends AbstractDataType { private final String message; public MessageData(String message) { this.message = message; } public String getMessage() { return message; } public static DataType of(final String message) { return new MessageData(message); } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java000066400000000000000000000033631312550536300321630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.data; import com.iluwatar.databus.AbstractDataType; import com.iluwatar.databus.DataType; import java.time.LocalDateTime; /** * An event raised when applications starts, containing the start time of the application. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class StartingData extends AbstractDataType { private final LocalDateTime when; public StartingData(LocalDateTime when) { this.when = when; } public LocalDateTime getWhen() { return when; } public static DataType of(final LocalDateTime when) { return new StartingData(when); } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java000066400000000000000000000033611312550536300321710ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.data; import com.iluwatar.databus.AbstractDataType; import com.iluwatar.databus.DataType; import java.time.LocalDateTime; /** * An event raised when applications stops, containing the stop time of the application. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class StoppingData extends AbstractDataType { private final LocalDateTime when; public StoppingData(LocalDateTime when) { this.when = when; } public LocalDateTime getWhen() { return when; } public static DataType of(final LocalDateTime when) { return new StoppingData(when); } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/members/000077500000000000000000000000001312550536300274475ustar00rootroot00000000000000MessageCollectorMember.java000066400000000000000000000043771312550536300346310ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/members/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.members; import com.iluwatar.databus.DataType; import com.iluwatar.databus.Member; import com.iluwatar.databus.data.MessageData; import java.util.ArrayList; import java.util.Collections; import java.util.List; import java.util.logging.Logger; /** * Receiver of Data-Bus events that collects the messages from each {@link MessageData}. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class MessageCollectorMember implements Member { private static final Logger LOGGER = Logger.getLogger(MessageCollectorMember.class.getName()); private final String name; private List messages = new ArrayList<>(); public MessageCollectorMember(String name) { this.name = name; } @Override public void accept(final DataType data) { if (data instanceof MessageData) { handleEvent((MessageData) data); } } private void handleEvent(MessageData data) { LOGGER.info(String.format("%s sees message %s", name, data.getMessage())); messages.add(data.getMessage()); } public List getMessages() { return Collections.unmodifiableList(messages); } } java-design-patterns-1.16.0/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java000066400000000000000000000052641312550536300327340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.members; import com.iluwatar.databus.DataType; import com.iluwatar.databus.Member; import com.iluwatar.databus.data.MessageData; import com.iluwatar.databus.data.StartingData; import com.iluwatar.databus.data.StoppingData; import java.time.LocalDateTime; import java.util.logging.Logger; /** * Receiver of Data-Bus events. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class StatusMember implements Member { private static final Logger LOGGER = Logger.getLogger(StatusMember.class.getName()); private final int id; private LocalDateTime started; private LocalDateTime stopped; public StatusMember(int id) { this.id = id; } @Override public void accept(final DataType data) { if (data instanceof StartingData) { handleEvent((StartingData) data); } else if (data instanceof StoppingData) { handleEvent((StoppingData) data); } } private void handleEvent(StartingData data) { started = data.getWhen(); LOGGER.info(String.format("Receiver #%d sees application started at %s", id, started)); } private void handleEvent(StoppingData data) { stopped = data.getWhen(); LOGGER.info(String.format("Receiver #%d sees application stopping at %s", id, stopped)); LOGGER.info(String.format("Receiver #%d sending goodbye message", id)); data.getDataBus().publish(MessageData.of(String.format("Goodbye cruel world from #%d!", id))); } public LocalDateTime getStarted() { return started; } public LocalDateTime getStopped() { return stopped; } } java-design-patterns-1.16.0/data-bus/src/test/000077500000000000000000000000001312550536300210765ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/000077500000000000000000000000001312550536300220175ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/com/000077500000000000000000000000001312550536300225755ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300244255ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/com/iluwatar/databus/000077500000000000000000000000001312550536300260505ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java000066400000000000000000000042361312550536300311030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus; import org.junit.Before; import org.junit.Test; import org.mockito.Mock; import org.mockito.MockitoAnnotations; import static org.mockito.BDDMockito.then; import static org.mockito.Mockito.never; /** * Tests for {@link DataBus}. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class DataBusTest { @Mock private Member member; @Mock private DataType event; @Before public void setUp() { MockitoAnnotations.initMocks(this); } @Test public void publishedEventIsReceivedBySubscribedMember() { //given final DataBus dataBus = DataBus.getInstance(); dataBus.subscribe(member); //when dataBus.publish(event); //then then(member).should().accept(event); } @Test public void publishedEventIsNotReceivedByMemberAfterUnsubscribing() { //given final DataBus dataBus = DataBus.getInstance(); dataBus.subscribe(member); dataBus.unsubscribe(member); //when dataBus.publish(event); //then then(member).should(never()).accept(event); } } java-design-patterns-1.16.0/data-bus/src/test/java/com/iluwatar/databus/members/000077500000000000000000000000001312550536300275025ustar00rootroot00000000000000MessageCollectorMemberTest.java000066400000000000000000000043121312550536300355110ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/com/iluwatar/databus/members/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.members; import com.iluwatar.databus.data.MessageData; import com.iluwatar.databus.data.StartingData; import org.junit.Assert; import org.junit.Test; import java.time.LocalDateTime; /** * Tests for {@link MessageCollectorMember}. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class MessageCollectorMemberTest { @Test public void collectMessageFromMessageData() { //given final String message = "message"; final MessageData messageData = new MessageData(message); final MessageCollectorMember collector = new MessageCollectorMember("collector"); //when collector.accept(messageData); //then Assert.assertTrue(collector.getMessages().contains(message)); } @Test public void collectIgnoresMessageFromOtherDataTypes() { //given final StartingData startingData = new StartingData(LocalDateTime.now()); final MessageCollectorMember collector = new MessageCollectorMember("collector"); //when collector.accept(startingData); //then Assert.assertEquals(0, collector.getMessages().size()); } } StatusMemberTest.java000066400000000000000000000053401312550536300335430ustar00rootroot00000000000000java-design-patterns-1.16.0/data-bus/src/test/java/com/iluwatar/databus/members/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.databus.members; import com.iluwatar.databus.DataBus; import com.iluwatar.databus.data.MessageData; import com.iluwatar.databus.data.StartingData; import com.iluwatar.databus.data.StoppingData; import org.junit.Assert; import org.junit.Test; import java.time.LocalDateTime; import java.time.Month; /** * Tests for {@link StatusMember}. * * @author Paul Campbell (pcampbell@kemitix.net) */ public class StatusMemberTest { @Test public void statusRecordsTheStartTime() { //given final LocalDateTime startTime = LocalDateTime.of(2017, Month.APRIL, 1, 19, 9); final StartingData startingData = new StartingData(startTime); final StatusMember statusMember = new StatusMember(1); //when statusMember.accept(startingData); //then Assert.assertEquals(startTime, statusMember.getStarted()); } @Test public void statusRecordsTheStopTime() { //given final LocalDateTime stop = LocalDateTime.of(2017, Month.APRIL, 1, 19, 12); final StoppingData stoppingData = new StoppingData(stop); stoppingData.setDataBus(DataBus.getInstance()); final StatusMember statusMember = new StatusMember(1); //when statusMember.accept(stoppingData); //then Assert.assertEquals(stop, statusMember.getStopped()); } @Test public void statusIgnoresMessageData() { //given final MessageData messageData = new MessageData("message"); final StatusMember statusMember = new StatusMember(1); //when statusMember.accept(messageData); //then Assert.assertNull(statusMember.getStarted()); Assert.assertNull(statusMember.getStopped()); } } java-design-patterns-1.16.0/data-mapper/000077500000000000000000000000001312550536300200235ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/README.md000066400000000000000000000015161312550536300213050ustar00rootroot00000000000000--- layout: pattern title: Data Mapper folder: data-mapper permalink: /patterns/data-mapper/ pumlid: JShB3OGm303HLg20nFVjnYGM1CN6ycTfVtFSsnjfzY5jPgUqkLqHwXy0mxUU8wuyqidQ8q4IjJqCO-QBWGOtVh5qyd5AKOmW4mT6Nu2-ZiAekapH_hkcSTNa-GC0 categories: Persistence Tier tags: - Java - Difficulty-Beginner --- ## Intent A layer of mappers that moves data between objects and a database while keeping them independent of each other and the mapper itself ![alt text](./etc/data-mapper.png "Data Mapper") ## Applicability Use the Data Mapper in any of the following situations * when you want to decouple data objects from DB access layer * when you want to write multiple data retrieval/persistence implementations ## Credits * [Data Mapper](http://richard.jp.leguen.ca/tutoring/soen343-f2010/tutorials/implementing-data-mapper/) java-design-patterns-1.16.0/data-mapper/etc/000077500000000000000000000000001312550536300205765ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/etc/data-mapper.png000066400000000000000000001163361312550536300235110ustar00rootroot00000000000000PNG  IHDR~sRGBgAMA a pHYs+sIDATx^xa{`SRR- 1K[ʔoUQ2S> V@6f^$,]7۫[y^"n81]ݲ/@FNj;D )(Ԏ$X# 9gfvgb<#Ξ]b79u ,@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb XP`uΟV"X@zaX~uuLB@u#X@!XcZPKV@ 5`u>4?\vny 6=LvMEiيNjTJ/P_E+}^hʹtS kšܨ3'u]2eMn ?.~Q먺r5ѯ~%s<Iyq ubeBHT9&>?/j_&DFB5Qz{\-=9>hu4:y[#׏4,[^56*=8lw^^U9j. ǑafbCt~jaDwfQakzc|']:~J@xg!O85 war ՝(]^TIMfdhϔMy_Ny{zNQ+fUCcus~-w2bEqZ=8l3ǵ0~6 Q-ܬWڦ#e&Iϵ-O,]'k l3ШlSrN}ɷ_l5%s&6N/Ygp2MZrQ5VF9jƺx%j;ju.iȵ)QnE]d*` /sb{ȜAjOtE*uN'Κ>j EdoRq$)5+h<BQ)kXeTb0[ܶW-$8iNR I'Ԗ:`Ʌ_ed~܄=9皢b#ޣQ=3H/w~lsV>5,Ev*Ѥv#SC|$Ƹv\moIܶ[DT9uu ?X%R셂Z9uX'6[N lkb½63SLo1! )~Vh=qy";M"y#A3UUk"k45P95Ph @ kb XyT7[sKJz=iOަߕ7j7/*ˀG*'ֳߟwܦ>#~t衟>_ZE^?^Օ]5ӛܡ[;p3GSp ^ֶ>?U?+3Ƕ.e5'5[v<ۮsٱl*% ·ӛ*G%k /E[Sm|Wr!X@{O/Ď;;޿2_Wn9ll9Ɓ絰 SW_Sn~5߿w=u寥i =~lhO>O<<})~\B!kq_틪? / G՗ԫ{փj6ArWöxWuMi?aokl>՘_M]G3˽ٿao*nHuN)jow2"WkeV{e/زԜW{cxPn}f>}S~Sߎ>cl~_s簟uv 5Ըٗ^Bo57}^H3Λ??K}mJzKig;0s ns6[dߜP˯i＠dnvA`YVe1ݤۊ\7lguѥKnܮO^ypq2+M%g-,Ww)Xo>~VGHr+;W~Ss>-7\ Yo`]}]{r^{M7{ogʮ] ]}㺮\ i`ҽ.p枳hJ<ڥ6b=ˤZfz)Wa3w|e{9 U9M)- uU[d/-+RnPM+:9uJߜgG~?^3qe eJP>ц[o꼻 )#_? qѫ9!e'"ۓo+ %5Ɔ{~}iܝ{UukҲGXHr_z]~U|z߹˟Wo^ӟ].2X%kqúet-tixomKnmv_Jt¸=IkicH\dLd, @6} $HX&L dmdq/zʾWXڼiz}`-n~gt߇?M7 eJP~3ӛWwlҎ?Yk+[o@lz~A_[3k]CNgߟsNc^s =mOK- <7ޚ8foWmd\!)Sƺ5Ot{6F'M)ͫ峊-[ k߽wDﯫwk?{= jd~{?[6oŎ/FwZRu;:K/L/Ͽv} ͞|&-^S<ojo6d&Ty51=+ä,oUl٤9y/[y 3۱S^3rȿ ]k!*r.nHI:aQk~mvhLͩ}] ՠmW~}__ѣk3[?ͽO eZ жg)zw_֏a߹Ga;.Zl誕S8ߧp^q}螻R]UnMogzԟZw>_;ʲwn β˼ R =<Ѕ*텝b˂psܓ76}^ݶցZ` U$nsl٨{7>u~|W`kl1~^6ϻVV'{z;?R4TceG*to]>{#ѮO +` T?5T5V~ܼ @ 51k⨚.yKas2|N]JX:5lz SWwTys9dٞw)X<}NH~=N2nfa5hv>;xBSJv3 7=]X6u;Fnk/9vbecy .N#X7qRϻ}ƥ.gggej-7czKML+̤ ԗ&۶4OW]湅˭S젚 K]Ksz$= Ǹ7}U\jDm֤fLLϘ%ZotהH^WTsjӜ9i?${0ѐ x3K~׾s^e n[rJSz1_D\Dމ5jzΤQzg y6H:ͻ=kB9A>"3҈w<0=rn? $^42;P`'Lpq*O8`!Xg@>4yF#OGo?aCt#ɹvր `”˞7%ԓNǴ53-<,{M w/E1)/.NjQ`uΝ,b}@ @O(nn z?{úчǞv}c3^@#X@O(V}R =|ܣ|n/N X*5Ph DA.jB5T35@lo[Sm',Z&GSmkgWۦ^e2Ӭ[~T]Mip/̚|Zu_Ŏ!JtvzZhˌ` P[S]elxRO*?,nd^؜ [(b&j_k?z3Mң,м59ڮs^jL κ53:NֳU4ruǐl//8JyJc.Y3,+>pT]$x1g?ow6m?ݭczRAlR='hߑJ5&gBԬFlAL;Fsl^Wks,"'KMJc cIhE7_߄p u_ikfҤ=_=g]MUߜ:f3lܧլy5pWh>[׬)ݫ&M9{}Հ_f9Sfs\݉򞟽Cr{wv>//,_|㛮 [_RZM"vŮv7%gmK碚jQ^<րNF5d>E$)5={RJ_2#{ՖSU!]),jg'&i =LM|•eviX5뼦-L?Ǒ횞rk5΢ SdgtֿQmYpr4oy LŶo>v\ j]=,cmJ_^1EW+bqAiLg?/ItZTs~"5PjcWjmuf}x77ݲ{̰<~?㜊V-Wћ976ͽQSNR}42r7v5%+xB7|;[=Lz*ęi LIT>WKEr|ڰv4;o٨wn7ܲ-l?n]ͼs Xtpp_K۴yz'vj1A;ӼjLhƄڜ7r>su&n] ] O_)o92=!~}&ᦹXLks[0y:WWWWaWo?U7hdۦb7,ZQ5]_ydO[Kh\6b@:}SKV `С 9u5]ҁc#X#XՏ` U F*G}` @ kb X*{op}ٛ췌m}^X?5jiv-Ǿ3_k^z `{h;5 {eW֠_ksm:3q4ͺs^NQu[)sGUPycjFiO<}}izRn~zNZ^56*]9u$4n;]S#ەvт)+ikμ<#\glUꓺ}Gq[Tr{]-ZCfO{'T_+s^i1AwiܮW MGmejz^~v>E7iqŴ5g3Oi -jt,vPߜ:JGݿEg9إ/Lq A-7"X@yK_kuj>=ЃnޖԪ RZ^ +3SيdbN;uLmBqu'pVdz}R}6ᵲ}Psjڍq)N#_|z6{/%gxgv9ljNioNu䚎[46fZg~i-Q` 5ڴO&wuMf>첒 RE64FUÈ-?ɜ>A }f^ VOjZg5枓d&[qp&;Qljuc_S1\diՈ]NlS*xc?bS1xNh:T>9POҖsǡR"pTb*GԇKW_No첒3ZKöv.\Cm4ywaaܶ?_>VAMGNNj4 m4#=b~͔Xc/dg֙m ;cJF};zfmݸY޸Ϳ|MR}F5Zt6Ԏ"!&IMDGnuN^|n~yw!T-OV?5Ԑ{Ն yyFs=7-nY]NϜtuAWC3U:ռ) FqJ٦Nqun\]]kڼճzApo%X6MDעjf49jԡZ` Um^ޡCk4SW%2G*BJ#X#XՏ>@ 51jM1!ػG-8kZ`r4pݔm!ݫ閧5h%M{kck^z l:Ƹ뜿f.Sb~W4xNyop tf{>*Sָ]INk_SSJښ5%?{G5h^K&j ;O`mc_s4,~u¯ {/f0.̏NzAvy5^?A5 ݗ2[^56*LNAeVi[[3=\)5v imyWVDz24֯ ̩i7IfqG'֜7ңmz^K*Թkr=qֶ.OrOk_U|kuzR; ۔:8iՃ` HA/ڴO&wuMf>첊d`>io = 6ydU]yAҼ~6P/jOTVOX|FAbWks}\{իynp&;Qlj5c_SEwU<غ{Qi<.S^ tn/猶?=DžЅ{85` D8@/ԇKW_No첊dT@9{4߫y88 i 6'ZD1Z_i>B_7;S_PK憩tqb߃ЅI{Ͳgz蠛nhy}nЪ#{a'_xv}3e`sF8<|F8a5P{ ӕV[lCsk._^RkMCZqQ/ ,Oc_rҚ9vNj 5i!.Hyj֨Bsz쾝zUmmnܬo_[VԜ\Ej2}*4]l?㜾!/ꚨ`UOȱGcUHDm;}Vc{T#e+έKz/5%T㾌`=!Xab5ajGa:{i^w޲Qxoe[V a dv)[ tx5TfL֏Ci/jI_O4أ1r b&8q5!uJé鷑sxYu`ͩ3'f($~dRg|嬞 [H}/)W4md4qTMW}mQ+rObj{*5V'.' Kںiߧ ;TzN]Mt&` TI8qY8a([+~}J#Xw~ȞXqrP]lWPK DePT?5jSf⍇kW)3.M7VA[X%KFV=ص7YXZ g-U`*uv8f\ip[1;Qj$3<.H?VQvrkQ>qTuj ͽ^z Ho}ToMr5G+}ɔ7Ԍ_d^ YgNǂߘb 9nUkTIai伆)gݣ_9|֝$$ZH~0Qs4ږ3m"L+j;'Փ7e^ydZ:r, ia!}ch&j m~LܘUZX8[ޓи-ٮ)LwvW~Ja8gj r8{>njU]I0W\ʋJnakTwRa*/ʞ'h;m ;cJ'%ϰ!xRa8ݛ $;ܲ'> GjӟyMcOْl Sg~~[^no9kԱwzɜ-XGݿ3hMw~)5`΅C&If򉮈^MY _nuN^ۺEH4]s2ᶠƸv\mm95Q'S;jU_^>S{陇t, 3e )X>~f-ı3j?_IJ+z}%o{957{1`u}WEyGgLuByXK{/)"M)̌]p]?绖L'{rð߃w'bwP֨B, m{5bN^J5E6<M9.h&hR[ꔆSUrݧ?5 ۱2-.VU6HBsNLjӆz<7ݛ6+ ؚt.7߇^56*m?۰!T5|Lrhs~bWks}YKޗ!8TV4Qlj5c_Sqs2PO~?Eˆ '4.6e݇ ^e#Gn}3!Ce@m3'܁ʫMQJֆžO tWZ'{:zl je.;S,h/NɶSr{ok[/ϲAk 6]aq^kN?uc4i;;ӗ5sIo}gtq\$\]}_ߧg+2ѢZ; T?jԬp ug|E_t5WfUd>_b|$KEW5SN K-z_]ki@ͰA:kv+Wںq>qnY%,g:2-M]?psVۼR;y-["3aߗ/jt7UĻ0r` f ]M}T6ܮu-΍[e*ZBmaB4ͩ{:Oyu):%|}y]Eːsx^k}Vnw,?s~zrV~zAOt7y8k֑>@c T?5V'.Z:a>OgOQ7[ΩZu#X#XՏ`U^N\^Օ]5ӛܡ[;k&Xa045P9~'Gƪ['.w^ą~Tw&Tzo}S~Sߎ>cl~_s=}Ƅ8uFcXk@ xNgv|z$Ǖy ߹qCӖmh\Y7ncSjocrÍ_Vln-7{lY|T]?_EG~稿Tۺݞgco?V'޸6<&/Ӭ;JJV5KZn.'X}5mP~jJNX[J|^wqs ?S+?߼4?zE]v\3pU É=j)M }Mߵ\.ξoLMoO(푉|]??D]=@"X%}y&}M/0][ cT6nroeyո]I0M)X9/y{lZVm5{jT϶|EP@ \yU~p]{K'o|n mx닝1;)TtmY+3г4mil{lZVMj >{ ;"X%t~M}/֯O++zcֿ{޿so&KyW3)A3pݛS7 @~-QjzfC 5ݙ+S4 ߜ22_y 6_}>$q8ΥECmW@-#X%|rg~SWs3~?~w:uXxzzvk}Ss0' dԲ(6HT}na|n]??7n^ؠ"[ҽnyZ6-n}yJIMN>QTq.-UKC}wGP>5_;dU];9}>Kj[/{Ҟ\w{1/0{efr'5a3A[`&V@җyڻO<Ko+ ׿:}7,p\݉y vkv595fYv5M'5yµ][)ۗ)8vFߥ`e>7Gٯln&JϗymG5h^Zzv~4cn_̼ce>z2 C`CxX{mzƵ;]y~ͽTNLjӆz<7ݛ6+b}ٗ U?btmsp6vMF~yӑJb՛ R+WGil8vsC*ymSjͻ\?뜺Zf55c[3$Ϩݭc]ͪ%˙}i=ޗQpljm-2f_Y}'sW;(Z]j:a4ak-(ה]z7\]VLlH+mh`ltRzΫk`[L@2S|gu164-- nKz{n~-[ܲ~}m^C6p5>1N2#t|r<͞T(}Ջ7y9uaf׭. e^Y:=uޝT_+ 8;SgN"bªNrٓ`(Ŗvz[/n# xbd7?;M+4uTʻ ي{j?vz~'G5@ 6H-[pBMI5~M?BMY]9ƪ)5'ʳ3;D}tSE148\/o&c(6ZkX7 5IQc|pzN]JXˆ&Jyw4}7& 7?]f sw$ ?'Įnzlk&2nl3];=:;xBF,]̃nMO9lQh/y]XYs뢯X_lQTk='ݝDmqńÙtuxjzFlno8ի]i%4d5}xۖsh)u6*nRܚJ=erobƽuR%nk/c旅qo.^y=XfM͌|P &\gLm83F|MَueK!>ڭ6)qk˓=AX^xhHzɆnk_9v0(uxϭk9`/VQ; "XcͱAqWK47=gҨ ^3<$JЌ5W:rDnʉ.;W;?3kavAq~ 9AHh࿇e6w5vZ+@-!Xci>}^iGTs!ze=e}!ޑiXfgwS.[ܖPOҫ^?kq&k~4Npeu-R旅N/ܬ p[Xu֌b5Vl lO +o_ ˅IQc ibky5M]uhU7Fﮕm*J_#\kV{󹯞׭?~/Kg]lƃ_{5^oU/s3O54m"GIMN>L` Fkė׮}zݼ-u>5s`^W2m p\݉rj~m [stR3^`߆NQu-vLmO;`6WIy/Qo>8 k` >;1MndRoxWwod.+ddˬҶyfm<]i6z\&p׫{WJۚ\R&XQ'o=GGO«ٮlyeR+WYψ}EmۼޱvTZg5KC C/!k@M5 /~Mݥ|Õels=jupڂs^m_Kbe kCXA. U9 6L jhňtԶ ղZBƚ{1 j=[+|?׮2"~h5ՑC"Lq P kBiMzFk,cWjmuf}x77ݲmJMiWkIR)]'ж_t;v~yԎ"!xjNio_=ROosE^D2j8nXf> nKz{n~-[ܲB44POҶ9+M2ԓאmW킩î惮%ZhF۟/\5>1TۃH'4*/(}Evr^}n^b5ΜPй ʞR빾ٓ<6>|嬞 [H}/)F읽jdovl&;OU5ܜIRo}Kް|}7' _5N50P\:d^j5xgo~'GƪϿzGy ;aZ`Z$PclXlo[Sm',$Smkv7JYλ.m2i@zAƺfk6p_Nj~{KZd豟Ww"7 S_jLˏjЬѬ`z2s;Ԁ3a:$=֨>+ӉɻV04[&aů!!$Svu@)A{ԛx)Pɶ>;1MndRoxWwod.+0q]<ۛ^X֫{WJg] _[/-`vMOe#o9,~uZڶkЎbUֶ>1w9 )'Dᐽ۩\6k-noe\^6`wP&Q$OUԆnOM]m7,7LFmݴ?%JD>jR䦢e@5k):p|ڰv4;o٨wn7ܲ-ga0-Z{5-M,]0o|P{7mp=^ǜRnnnthEn5.;Gu1o0j:T9ME} ՙ.cUy'4Ȯg$?%Xς`a[z[/n# xbhǶi21g%&u4}1NՏ`UG^8azGF1>-C* tIdt ~'Gƪ j @!XcGƪe@5 ˅Iq2@ͣ ` @ 4Ǫ[zS[_??N֝>l~=CG+V[5 )8 @#Xc =|ܣնNA_%}NMMievi5 {&]5K2S WQJREm^f9B级5m6/"37(5֍}na|n޲5&&'TX9yJIA4p[Hj?əiO~-Lyg#Pߜ:Gc}Ӳ(-c+;.zRj6~\N~~2^tR3ҒMY1 VDsrw")zVɖEuy%v^ DZߵҿE8kVkg'&i =LM|BO:ve=|㸛>ُ;OͪaĻrR0?:~;F(sl 0,,?vC_ʜ0?mԫ{W(\g᠚:tj mwk+-^sإ!?=k$նw$~z瞨l_^j~POϛPPdBm<]:qYh=G֥~=,ܯ}RSwfm!Xc‹_SCw饫g7pevYQ{-{5}Dp'|VO3WUC6i _7?VpR R[]ǧ/fkwsFv'5zJv9MuOl>.h&8gٓ%t_y5ą5PQYj­15yaaňkjҁSjo;ޠ<{ X xT9ִۿɶfY<`&Z]+{"wbǵ~ `5ݳ]ׯ[|+*fO`s ثՑZܖp}&+jwQ ֐îl(*Q3Wub-TlHmH2IMWF7B&. DcM['{ y&osqͮ:T#w.nJ#Xc{쾝zUmmnܬo_[$AmYWOR~ע{+;~ `6l]g/[6 lq*ffp;fE :m:)o>ʷm;y}4]M;!o]]O'iy`u1n*c;uJéaNF2+煙'4/צDPlsTyQ%j抶(&φKQ p7`QnejX[0kVO%SϵvX췤lK]o;~ `ԙ[nlͥYLWo?U7hȞۦɡդ ئ&͉n-Nɋ9oNT?%A5a?4ӗ;[nkmgmC64jzYsG. e^mQ&.~VΆ Xv>3O90a6]4|ݳ&<%5ӷPb*Wy{9[wz$PXu}b2?- OS%2Xc(7`vп(qu*+,5PXu+y@.#yۚŴLu!\q@iۇ>|mv\&%튍AR]P9[h9r/G5jhN{S6۬M]ܐMBz hKfRl3ons>iS#_׿~P?{%%/=I\xO@> T?j2K#``6 mSWsa>q've6TiSR'glu>єC?ϻ8N)9sj}l+=NqzS(Z?i[+Mqk^M+y J&c^2=9X^huC:[̏}䲜w}S~Sߎ>cl~_+lnOH[Nqy>>Fi%7ٯrA2;V)+-Hӗy]P>/e3{)sA=*$=@w-3{5c I<'[K> ‹?"Cj;W~98֯TۓjmXڞ 4UW=\Uܘ8vFvq؀]kzlՎ|T$3/}U_x7;~=N~cڲq> ј++^ݓ]mON$^ 6+ʯ5_^MQ~2;j򦮣0۷{**nHuNy7ҫګv #r{UYfEW-kz_n]YEk_D>xK_kuj>=ЃnޖՔu;55կdoՀNE5 ?w߽0g ՝;Ɯ{엛ϓ'4!S;k?:[q=ȬCxyIxK`>hm+^i[}Nc{l~[hRUÈ_5ݛ!/ZnЎk^~3j~ _E'Ns`\կkCz;n6?S=rNd/7pg 2'=&=MK~Mx$skkį1'e?]^Xͱc0I{5nNёۊ\7lg1m ;2ὮJh4~F7ZW9!^-د}R }渓~~cw^ 13e֌;ݥ!{7-ּP^zGO¯U #5zmT)5և|ڕfOhz`˞ H{މU?i\<N-`_~U|z߹˟Wo^ӟ].ɬ9͞>)=m]&52[M愽^;lʯDpa`Uwհڱ`u5sA3:=Զܿel{]fU2|Ŗ^swnɓٮ:ۼdm^UHT/5>t^zvz Wf{lP 3dk}]p>/M˯=߶[Q-fml޼R}3:?Sr7}%򿟾(|^Pd_µjankBt' ֨yrk֓o6oڤ^r>y~_|jMz9\@k8MkYsy!.ּzպSdYB^3׬'jkh#}8gMBp+c^@ι^BU {ܡWt5zK]sevYdki `[LeӣfWkͩs~kF*دۿ :ӒinK^PsuXEknݷoqλ !g5wv˿mMم dr{RK =^ZwD7;W^յ\׽gz}E?ɽ߭[tC7bGc/Zߝ\dL'Ӡw nS׆b F&/{VI8P)};zfmݸY޸Ϳ|M,k^pqﳫj~%W'ܜ9 Qs5yK4#wy:jlגmb>6BUIۄ<ݡp_R?+I?&{z4>^}n1[w ~&e@]C?*z6+W|[>ѯя}Zzε?׿-^|gz'fjߟٓ{5%6Z3~ekc^}>=YdS~?&Ve+^SA~^{Ն yyFs=7-nY>{cv-2ݫ{aqZ#~\ ݼ,MñA3hb>f"|Pmm~c\. exHw6{29) B]kc97WY9Oh: E1Yگ LÓ=Os~dhvH#7<*c4jj{UJ,{p^q}螻R]UnMogzԟZw>_;ʲw{ Ȃ}v^/B;;IWnO|mL.sa~fswnwͺ>ev)2+WgBg^s 2}-u1jdm%{&hoXfOKOm4e2evEYQ ^k)n><u y {(vr~ճzApo%XފߙGVM; |͗o9VU'.f)ڰ':d~_UW%X C ZS{dq}#ڰ}&QB/}=yݟh)Bp,K87~?RX;~֘J} BgΔW,~kZ?qvP|-=z :v鍷}{{=h'wVGu`}c ˅` T?5V'._-0i |\@e=Q N.]oHR I~%k[M2%59l44_+y 6=lޛ`zZx+yg/4y ϩ:CU~k'G坓ʂh[e`=89!5ա^ͱݾ|{k'/hT]缓nMO9MݎQh/y]XYs뢯g}5N_٬.N7! yih9M $osyyʿKC}sX%P%Ŭ >q2{r?.p9;x8Sn?9鞚ޮ[60r3?VqWkt$JL@}Ijo2>m5Nt?^v.RO97Y޺} ~_~}_佇AYBY/"u CQzFRڱF*җyڻO_@w WxĤ6mǓI}]ݽiO2 -H #5Av-&@wMԫ{WRt^zvz WfMՅ]j ߛf^,1S˰߱]3ej36OjrDpj6ɬӷ1cޮb- 1w~>3ѯe8F'Z` XA.[p|P}3wyR݇>%G6Wt.&H6Dx;2 bgwSNl?S/ ioN.<,{`_(9'\Y]翇ecӲE}{g|E_t5WfU߼' &7F'3ߗ!oȋ9YwrN}n{*"ǰrF15A( {󌷻tqn)Vـu:a?zmm{]sjrMmw> e?yȬkjc;ˆYĺchU[^l[c>fNvyyņY']ï X:AB ք?(lpްv4;o٨wn7ܲHvi۶68Lm)ߧTX۔ n^zuO϶qoޭ^o1 ^7=#5Y5vuqzchoa[Y Q5kӉq^x^|嬞 [H}/)%Ts֫emd_zXKՉ` k\TCj!PMyMGfkC񾪮K:PEʹo5PP? ˅` T?X5Pm.jhXՏ` UDSp45Ph @ kb X} p26Xc T?5TV7/[)tI&T=`>LHWp P_aviu&<ϩCk_k E׺@)8@ yi6ϻzG5ᯱbLPy*:T/]S8ē\ X,_^>S{陇t8vvj ȉsѯ~%IW#p|P㝳8km-mQu{a2nӓ)o:)8ı3j?d}X/\^xռ_'SWu߫3m,<2#X@MI=8y?S}̕~9|vbR6ɤ޾޴'\]VT_ܯT"m<]i&z讉zuW'esc{SA-lP)ԬF6lct~u쫣'q[>]A`pB;2;67iv[/=0 ,gbaԫ}Vcn]{IӣR{k}kqa z+y^+5԰G&u ~u K, /~Mݥ|Õe8*jזaib&]޺vѸGA͡GNM,5۳Hu:`7nW_{OLjhk# oHkǙ:yM=]LܹyA3iIGVXkըmz~ ܳ]ׯ[|+ ؐikOӽ ŝAM7gNHh*Skkkƣ¢m֝S^ʔÒ,8hnK9MW-,5fff_#_{ M7zGkbjm>hԭgsuEb&8kwGꔆSAo#"o豨 +q ;ޮ hܪ{PzpU׾6i{@{z\M{loXdN\e+%kXL~Q)&ݶ֨yFdmrm2{tqdCS-cz[/# xbJV }>ׂjȢjDa~Aj;W~ Ձ lmւ 23<=Ԃ@E&\z먺r孙eJ%׹W :]Q ;+_ڿ?L/r8#dk 惮N4|@)o9BCT6Oᆌ`;}# =a`i5J=1{ϒge X𹯞׭?~ͯi&lv<ڻ1Ӹzsu1F|K@h7_ߜ:J`җyڻO?l&nh) n;&Wܮ`.emݸ]IRqm~oFG~bOtB0[9(_~cGy.4@5ܳ]ׯ[|+ˊ j1_̔?k5'Ԩ60eLΩi>}oj j/fɯ&+vP5 nKz{n~-[ܲ6'ԓ~C65Ը*5a[ݮyJ-cNFy:cvܦݽϙݠ67kWjݗ]fۍ{#vYxQNѨ+7S4nUy_|eek7bkc5=n[U|KPFu5o\ hܪ{PKACxXiwjsl&Kߧ Mi^,wU.ʰضr4j<J+= 6TD߫ճz}o%Kc?cmK[c E~O~GdQc 5aΩ+ck쉴eF Cf2+wxR1ax&l?.Xņ)8TqE[5k=KyqNMxp<%|6Hءz݆Ň*ؿ w>ٞ` 5a\SNh8pahL w3]Ms>a۩/8{E UÈ~0\Oc7ǒ3TOk-5ԑeC %s A3־LsxǕ/=*:䑱{| yM˱ܚVgҽZb85ގ>ǭ5` 5aJ)2 3~/-5Og~ VjbhkK uneɺ@&Jvk `G %dB5lkKh-w;LRCGek͸sJH b8Cej׽~FP@Jz}3E)gp?E [lb'S |$l.q\EX|K %{Lm~ @5#X@ xXJ 愦a\ͼs=O9%4cBmp=7rP=*Xjo?qٻk]d؆CE+1T,RXpS{陇t,ڜ5]28eΖ>{5ā"ۙԨz5.H?VQxmeʛNj/sqy0&Q}4;\A)o˼~Mߥ)5|vbR6ɤ޾޴'\]VԬF`t[q >2ŶTj[N q"Lf'̶{5횞rOB1׸ ^q;zB;r>1|fǓ KmWH{&` ה]z7\]VTy1m '13KvJs|;73~܍Vַ~-s .iqjanys<^XgKpϖ;4w._Ook.+mrS_Pmҽ]b6O_Zf՝Am7U<<5Oċ!CYEvc49˛we~M@P( MP3yW~zrV~zAOTZ@u,jFT4,=q"p珅ʏ+#jȞ?;OIyu^Ա +dSAC Դ$N#k ?C3CekN]?}t~kK(Jf50cBaԐ= ce9TppS2)qo5DP\L?=*>GLݫ6[@"X@ XҰ@Q2@R=V0Ba <߅+إU[*WhX涄zı~BM@U!X@ XҰ@:ZX׼b'r0B9Pg_ȱWaR%XP*5A> 1T0՘Lm6Ǭ_tȞar1-kX惮ۇhsWأ1r *5Ԑy SNM {:Nf1T6,WEZdg-b!ᶀTw@M 7;XvZ.@` F` F}n !_QcMٛxmMRζ#ؖ!M*k>/Hw/Ɔi|-ݫ閧֗z R$}v-N7` X,g'&i =LM|•eGzث5!'+sث5a/e2>hjV #ùYRИ]-HݚJmpB;r>1] ӏ 5|ů)׳ӛo2:F ^+!{Z}uV^54cۦڙ쿆+BL_,l~S 5ܳ]ׯ[|+⳵Ցb}WZ>6K};zfmݸY޸Ϳ|Mv5B ?[kuzR;bئ5n/_Y)ϛ}l _<~ SԼϯDx_mj9Qmp^םl;7snpҿWI ̪}{q{0NAW iF۟אm3~`%vih9GMPe>N+&7]Ib`CV5NY= <_Va|gg}1yV%; k Nm͓8^ Wk7TP9Xm/~iXs*!}1{E̞># džfc+# A.7^h)pJV:8C 8io73AMr>y5Yfʩ]cjnK9MW-Ԥ5ԀX۾~kr]M ɳ{;]A9O<[ likffvlyAd5VYelD KF'XwP*h?laLz7;A;3l>]s!}\SzsJ5zOǐ脦Ce[`!R4 ~9N)u`a-~X {cp?kѪA <j"X@`w tInݒ5P~k&5P~ 51` @ kb XEkauM}NMMiX蜺J.Ϛ|ZMރn`C"U~K(9NZPC>/fْLyJ^lkN^M?2넎;8@ىImpC'zƻ{&3pevY[sܓjGkz*[td~-zs-]^^56*mkh#qNc pMK@^=yK ,5 Km_g>^s٥j6s=d&[qzgu` X@ ‹_SCw饫g7pevYg.0銥W{׾ :}1,zV:uhn%UC.p.iW=SIsw&u^L=pQ 5Ԁ{ܡWt5zK]sevYE:M?tb˭rak+=0#%7rj|+y9vNj 5iU` 5v+Wںq>qnY>׬'ۏxlHj>7e.rŖ[Q$)55Leͫ/(Hؒ_C3Ѽ[g56Wm^?۬ܲBɨjjÆuҼe޹p@I ̪5>lxB=I[O=~ ҊZBswmfҡ] w ޺^_)o9BǺא//W0yǼ) FqJl2+8Q`u5i^LWo?U7h5X6MfGtq5G5NSYkS:F9u5]ƟAJ#XՏ` UDJ#XՏ>@ 51` @ kb X Ω94qԍL]~yz`S(_Oip̕xsj*,;1MndRoxWwod.+deˬҶufz.x6ٮ_:^ =ҫ^mͭ })\h Ҽf= vd Km_g>5qR=\mY'Փ c 9zj̭KC QtE^}9,אZ|ϚmI~^Zrjj^RK/]}=;+ &{.uR)=hań鋅ͦ gCXAX,mi`fm,gߙ{8լjuϫR6,))JGU0yڽ7F_`r5q,5Ԁ{ܡWt5zK]sevYE:ZYo&G5ՑUT {3wk`Gx8ی;yϬLk5Ԁ۩\6k-noe۔:.Үԯ=¼>ק7\:ӣQ$M)m 4+ѺGifwWSlwӯu?L񖐎GL-!װ3wLu:(` 5Ga:{i^w޲Qxoe[VhIʳRд؆L>ק#ljwӫ惮ů덶?_V_)o9>F2?Py}G K]bxVtFu7jsλyYYɨ}_^ݓ~`]P_7Ȩ[0y:UWWjz[/n# xb[io'jǶirȿ3Q5]O ؋x:Q XL~Gd ,5NU4mS2Uu5]jj+BJ#XՏ` UDJ#XՏ>@ 51@7YV7/q2@u#X}` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kb X@ 51` @ kL9PGyIENDB`java-design-patterns-1.16.0/data-mapper/etc/data-mapper.ucls000066400000000000000000000103471312550536300236660ustar00rootroot00000000000000 java-design-patterns-1.16.0/data-mapper/etc/data-mapper.urm.puml000066400000000000000000000022341312550536300244730ustar00rootroot00000000000000@startuml package com.iluwatar.datamapper { class App { - log : Logger {static} - App() + main(args : String[]) {static} } class Student { - grade : char - name : String - serialVersionUID : long {static} - studentId : int + Student(studentId : int, name : String, grade : char) + equals(inputObject : Object) : boolean + getGrade() : char + getName() : String + getStudentId() : int + hashCode() : int + setGrade(grade : char) + setName(name : String) + setStudentId(studentId : int) + toString() : String } interface StudentDataMapper { + delete(Student) {abstract} + find(int) : Optional {abstract} + insert(Student) {abstract} + update(Student) {abstract} } class StudentDataMapperImpl { - students : List + StudentDataMapperImpl() + delete(studentToBeDeleted : Student) + find(studentId : int) : Optional + getStudents() : List + insert(studentToBeInserted : Student) + update(studentToBeUpdated : Student) } } StudentDataMapperImpl --> "-students" Student StudentDataMapperImpl ..|> StudentDataMapper @endumljava-design-patterns-1.16.0/data-mapper/pom.xml000066400000000000000000000035271312550536300213470ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 data-mapper junit junit test log4j log4j java-design-patterns-1.16.0/data-mapper/src/000077500000000000000000000000001312550536300206125ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/000077500000000000000000000000001312550536300215365ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/000077500000000000000000000000001312550536300224575ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/com/000077500000000000000000000000001312550536300232355ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300250655ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/datamapper/000077500000000000000000000000001312550536300272035ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/datamapper/App.java000066400000000000000000000060531312550536300305720ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import java.util.Optional; import org.apache.log4j.Logger; /** * The Data Mapper (DM) is a layer of software that separates the in-memory objects from the * database. Its responsibility is to transfer data between the two and also to isolate them from * each other. With Data Mapper the in-memory objects needn't know even that there's a database * present; they need no SQL interface code, and certainly no knowledge of the database schema. (The * database schema is always ignorant of the objects that use it.) Since it's a form of Mapper , * Data Mapper itself is even unknown to the domain layer. *

* The below example demonstrates basic CRUD operations: Create, Read, Update, and Delete. * */ public final class App { private static Logger log = Logger.getLogger(App.class); /** * Program entry point. * * @param args command line args. */ public static void main(final String... args) { /* Create new data mapper for type 'first' */ final StudentDataMapper mapper = new StudentDataMapperImpl(); /* Create new student */ Student student = new Student(1, "Adam", 'A'); /* Add student in respectibe store */ mapper.insert(student); log.debug("App.main(), student : " + student + ", is inserted"); /* Find this student */ final Optional studentToBeFound = mapper.find(student.getStudentId()); log.debug("App.main(), student : " + studentToBeFound + ", is searched"); /* Update existing student object */ student = new Student(student.getStudentId(), "AdamUpdated", 'A'); /* Update student in respectibe db */ mapper.update(student); log.debug("App.main(), student : " + student + ", is updated"); log.debug("App.main(), student : " + student + ", is going to be deleted"); /* Delete student in db */ mapper.delete(student); } private App() {} } DataMapperException.java000066400000000000000000000034531312550536300336710ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/datamapper/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; /** * Using Runtime Exception for avoiding dependancy on implementation exceptions. This helps in * decoupling. * * @author amit.dixit * */ public final class DataMapperException extends RuntimeException { private static final long serialVersionUID = 1L; /** * Constructs a new runtime exception with the specified detail message. The cause is not * initialized, and may subsequently be initialized by a call to {@link #initCause}. * * @param message the detail message. The detail message is saved for later retrieval by the * {@link #getMessage()} method. */ public DataMapperException(final String message) { super(message); } } java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java000066400000000000000000000065171312550536300315050ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import java.io.Serializable; /** * Class defining Student */ public final class Student implements Serializable { private static final long serialVersionUID = 1L; private int studentId; private String name; private char grade; /** * Use this constructor to create a Student with all details * * @param studentId as unique student id * @param name as student name * @param grade as respective grade of student */ public Student(final int studentId, final String name, final char grade) { super(); this.studentId = studentId; this.name = name; this.grade = grade; } /** * * @return the student id */ public int getStudentId() { return studentId; } /** * * @param studentId as unique student id */ public void setStudentId(final int studentId) { this.studentId = studentId; } /** * * @return name of student */ public String getName() { return name; } /** * * @param name as 'name' of student */ public void setName(final String name) { this.name = name; } /** * * @return grade of student */ public char getGrade() { return grade; } /** * * @param grade as 'grade of student' */ public void setGrade(final char grade) { this.grade = grade; } /** * */ @Override public boolean equals(final Object inputObject) { boolean isEqual = false; /* Check if both objects are same */ if (this == inputObject) { isEqual = true; } else if (inputObject != null && getClass() == inputObject.getClass()) { final Student inputStudent = (Student) inputObject; /* If student id matched */ if (this.getStudentId() == inputStudent.getStudentId()) { isEqual = true; } } return isEqual; } /** * */ @Override public int hashCode() { /* Student id is assumed to be unique */ return this.getStudentId(); } /** * */ @Override public String toString() { return "Student [studentId=" + studentId + ", name=" + name + ", grade=" + grade + "]"; } } java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapper.java000066400000000000000000000030401312550536300334300ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import java.util.Optional; /** * Interface lists out the possible behaviour for all possible student mappers */ public interface StudentDataMapper { Optional find(int studentId); void insert(Student student) throws DataMapperException; void update(Student student) throws DataMapperException; void delete(Student student) throws DataMapperException; } StudentDataMapperImpl.java000066400000000000000000000066151312550536300342060ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/java/com/iluwatar/datamapper/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import java.util.ArrayList; import java.util.List; import java.util.Optional; /** * Implementation of Actions on Students Data */ public final class StudentDataMapperImpl implements StudentDataMapper { /* Note: Normally this would be in the form of an actual database */ private List students = new ArrayList<>(); @Override public Optional find(int studentId) { /* Compare with existing students */ for (final Student student : this.getStudents()) { /* Check if student is found */ if (student.getStudentId() == studentId) { return Optional.of(student); } } /* Return empty value */ return Optional.empty(); } @Override public void update(Student studentToBeUpdated) throws DataMapperException { /* Check with existing students */ if (this.getStudents().contains(studentToBeUpdated)) { /* Get the index of student in list */ final int index = this.getStudents().indexOf(studentToBeUpdated); /* Update the student in list */ this.getStudents().set(index, studentToBeUpdated); } else { /* Throw user error after wrapping in a runtime exception */ throw new DataMapperException("Student [" + studentToBeUpdated.getName() + "] is not found"); } } @Override public void insert(Student studentToBeInserted) throws DataMapperException { /* Check with existing students */ if (!this.getStudents().contains(studentToBeInserted)) { /* Add student in list */ this.getStudents().add(studentToBeInserted); } else { /* Throw user error after wrapping in a runtime exception */ throw new DataMapperException("Student already [" + studentToBeInserted.getName() + "] exists"); } } @Override public void delete(Student studentToBeDeleted) throws DataMapperException { /* Check with existing students */ if (this.getStudents().contains(studentToBeDeleted)) { /* Delete the student from list */ this.getStudents().remove(studentToBeDeleted); } else { /* Throw user error after wrapping in a runtime exception */ throw new DataMapperException("Student [" + studentToBeDeleted.getName() + "] is not found"); } } public List getStudents() { return this.students; } } java-design-patterns-1.16.0/data-mapper/src/main/resources/000077500000000000000000000000001312550536300235505ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/main/resources/log4j.xml000066400000000000000000000032221312550536300253100ustar00rootroot00000000000000 java-design-patterns-1.16.0/data-mapper/src/test/000077500000000000000000000000001312550536300215715ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/test/java/000077500000000000000000000000001312550536300225125ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/test/java/com/000077500000000000000000000000001312550536300232705ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251205ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/test/java/com/iluwatar/datamapper/000077500000000000000000000000001312550536300272365ustar00rootroot00000000000000java-design-patterns-1.16.0/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java000066400000000000000000000026271312550536300314700ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import com.iluwatar.datamapper.App; import org.junit.Test; /** * Tests that Data-Mapper example runs without errors. */ public final class AppTest { @Test public void test() { final String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java000066400000000000000000000057021312550536300327630ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import static org.junit.Assert.assertEquals; import org.junit.Test; import com.iluwatar.datamapper.Student; import com.iluwatar.datamapper.StudentDataMapper; import com.iluwatar.datamapper.StudentDataMapperImpl; /** * The Data Mapper (DM) is a layer of software that separates the in-memory objects from the * database. Its responsibility is to transfer data between the two and also to isolate them from * each other. With Data Mapper the in-memory objects needn't know even that there's a database * present; they need no SQL interface code, and certainly no knowledge of the database schema. (The * database schema is always ignorant of the objects that use it.) Since it's a form of Mapper , * Data Mapper itself is even unknown to the domain layer. *

*/ public class DataMapperTest { /** * This test verify that first data mapper is able to perform all CRUD operations on Student */ @Test public void testFirstDataMapper() { /* Create new data mapper of first type */ final StudentDataMapper mapper = new StudentDataMapperImpl(); /* Create new student */ Student student = new Student(1, "Adam", 'A'); /* Add student in respectibe db */ mapper.insert(student); /* Check if student is added in db */ assertEquals(student.getStudentId(), mapper.find(student.getStudentId()).get().getStudentId()); /* Update existing student object */ student = new Student(student.getStudentId(), "AdamUpdated", 'A'); /* Update student in respectibe db */ mapper.update(student); /* Check if student is updated in db */ assertEquals(mapper.find(student.getStudentId()).get().getName(), "AdamUpdated"); /* Delete student in db */ mapper.delete(student); /* Result should be false */ assertEquals(false, mapper.find(student.getStudentId()).isPresent()); } } java-design-patterns-1.16.0/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java000066400000000000000000000042671312550536300324000ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2016 Amit Dixit * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.datamapper; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import org.junit.Test; /** * Tests {@link Student}. */ public final class StudentTest { @Test /** * This API tests the equality behaviour of Student object * Object Equality should work as per logic defined in equals method * * @throws Exception if any execution error during test */ public void testEquality() throws Exception { /* Create some students */ final Student firstStudent = new Student(1, "Adam", 'A'); final Student secondStudent = new Student(2, "Donald", 'B'); final Student secondSameStudent = new Student(2, "Donald", 'B'); final Student firstSameStudent = firstStudent; /* Check equals functionality: should return 'true' */ assertTrue(firstStudent.equals(firstSameStudent)); /* Check equals functionality: should return 'false' */ assertFalse(firstStudent.equals(secondStudent)); /* Check equals functionality: should return 'true' */ assertTrue(secondStudent.equals(secondSameStudent)); } } java-design-patterns-1.16.0/decorator/000077500000000000000000000000001312550536300176125ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/README.md000066400000000000000000000044031312550536300210720ustar00rootroot00000000000000--- layout: pattern title: Decorator folder: decorator permalink: /patterns/decorator/ pumlid: HSV14SCm20J0Lk82BFxf1YF6LaP26ZZizfDVVhjRC-bPDRs_Bc35cyZvAMV3bKU6kao36ehCGQtdms2d3z-yLursshuOKBUWmV43LPNfZEcaaFzA-YWhH_y2 categories: Structural tags: - Java - Gang Of Four - Difficulty-Beginner --- ## Also known as Wrapper ## Intent Attach additional responsibilities to an object dynamically. Decorators provide a flexible alternative to subclassing for extending functionality. ![alt text](./etc/decorator.png "Decorator") ## Applicability Use Decorator * To add responsibilities to individual objects dynamically and transparently, that is, without affecting other objects * For responsibilities that can be withdrawn * When extension by subclassing is impractical. Sometimes a large number of independent extensions are possible and would produce an explosion of subclasses to support every combination. Or a class definition may be hidden or otherwise unavailable for subclassing ## Real world examples * [java.io.InputStream](http://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html), [java.io.OutputStream](http://docs.oracle.com/javase/8/docs/api/java/io/OutputStream.html), [java.io.Reader](http://docs.oracle.com/javase/8/docs/api/java/io/Reader.html) and [java.io.Writer](http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html) * [java.util.Collections#synchronizedXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#synchronizedCollection-java.util.Collection-) * [java.util.Collections#unmodifiableXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#unmodifiableCollection-java.util.Collection-) * [java.util.Collections#checkedXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#checkedCollection-java.util.Collection-java.lang.Class-) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) * [Functional Programming in Java: Harnessing the Power of Java 8 Lambda Expressions](http://www.amazon.com/Functional-Programming-Java-Harnessing-Expressions/dp/1937785467/ref=sr_1_1) * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/decorator/etc/000077500000000000000000000000001312550536300203655ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/etc/decorator.png000066400000000000000000000524431312550536300230650ustar00rootroot00000000000000PNG  IHDRXOk7TIDATx] XY[Lܞ * "D@"*( QyA%1n נ LL|&yIFc\L |5UuꞮv @ ,@k7@ l$` rx%XDhM&U_Yj3[UF2j&M&$ 6n2&h%ItIF2ң^WDÇ5lXEnn;vE=>FZbHW&(L<|X;Fr6n)ָ'>{vm~jKܹ.ϱ|%~ED-ѫWed$«#wޡsg0tغd%+gO g=:\Sl܅'^woooW\%7wޜ3g ppNa-1+&M]vmс]:^v~ Ʊp jcLez  -l wKN;vޢ=0.&[vKZbXW/MtIweե_n1#w kZp@nZ/ H8dIrRR2\=kL8qƴl÷ysƃO0{>3g4k2İܯ_6,*ү_]wEbt6^uc=\ؘ>巡2>x]x!̱q{" 11A 栝SF7kVv1zsW/MtI_1ᆐַoWaNDof(Hdd$$'G!jժ{|6!NNte8CܾNԤI} =w۶e߫4["nh8K[+ߺuÇ%Ktf-t>=a9|GqOq 2vzܹcڴiv7WV [oڻw_֭cv?`Y׮θu޼D:9z[.@K CD!hJ+2$ 6n2&h%ItIF7ɨD-1ML2IF%hAld- =SC.2;H#$@K2T2MRm}}h!JX4p 3 BGJāeS,ݥ5 2 b\g>zb1^ NQ4$/lMMKnq,@KRi> v?~3͜9K5u:rd8Pw[;|xqn`jU۷Ow`tft[SFMMG{PgZrԝ)l%>d-٫WGG&Y*RKLJ@={! =/aHFQܹcFXK+Vܳ'G2jq]-d׃UO\I^w֑[g벵҉5ťۚ2ʱ1#WZpwd}o|/GG?eʔzX.ZXs#߿ӛ)qm¯ɓh4on59OwkР6ǧ (sUn׮{[Xdlwb!{0V<;q`0 mذ.YIJw&2nkʨ_ХCOտMt~ܾ LP^כ)qm¯J˂$fӏomhCaAj1'g,,ҥ\wd9XeÇ\k||VOGQmͩDIt;>0Å$p= ^^.gm㞋fmըgfBtXÍ{ =]lѠDAuFOФDZbX^7Sڄ_3b=Qz(~;4mN\S0r-=׮ׯ[Uͳ2jN%J[ɠ1e'w7*tiM\<=a%۾}Nʕؾ M||FӻL;h~UZNbn^=Y6n:[..&eJ*O*/¼񫯶1{eYXnؑ7-m eԜJDa߾Æ~+S4c֬ʨ^YzgX3P\7-&y ̍y0WZrه ZׂlNՙԮ2VG"/w&T,XլY k 8ysoK;jU>5@1}Cb]ݺGyӍ_'1c&ʼn|յUqrs*Q"Naკ\OŐVFz.;Ěz7v~~# H}Vƾl")/6ݾPMB;7mXc o6CW7T^~E_~:&@CCG :<'..8,iCg~ba1UjׯގE.,v}iF ڴivB|܅v{.ahk'v_^ ]Py[f~n 2 6n2&h%ItIF7ɨD-1ML2IF%hAldM2*@K b&gd :SĦ@t ? ¬-OdDd -1ML2IF%hAldmDF5:u3 m9_0$=D%ItݒmLF;WCY+$r, 7 G&O &mA]mSX?5YItD1`t_$租vjM˾~ m6s]?bDF984n۶9!+Vl„בYRVPյ5+4-r%)ݪF{'SPZhgO;횜N'';?:Nթ +b&ˉnc2z/@o/ f 3qbG&rvƫeF{87嗫_uƙ6mg;pAG'qԩmPPAz s4ژ=zĸYХgO7r@K bSt6KWD6w g^dEGsM*FDaa oΟ1m0gpi ({BVݺVN?ۧOgVCBBo/U_i҈n] JDn!C9W\z̥K'5iRaú^ lwXf-a꽂_l2Qضp9r̙#qc9}1œ8 74ϩ1`[6Wfi,_ݪԫџDIJ>nɫqf}!7Mfyyob[5NeXDlurpք Wfi4iDj.d?azu;vЃH?Cءnqq죓?6e2g_;YرNڲ2p`͛34q8ѱ k޼ygبeT~EtnqShg;;w],;tpغu6W޽p[7=tlҤ!7o6~H/3ڦ)3fسCBz [n0GPxxQQ}Pe,+[UtSh_Nص s<M[f]őQ7U 0FZbT 6-Rm[nZUM"#JE7ɨD-1ML2IF%hAldM2*@K b&nQZbD7dt?#a "6[U{LX]fhy&#Ue$VhAldM2*@K b&ɨR:6~z#["6n2.zd|_#[ "6n2 .H~i6W&MVfIF%hAlDdt|yWJ33G5y2([Iq"R>:46_ޮq+Wb]lJ\^!ǏuH 2ٿFf,Qa￟ݥsNNN۷;[*"-p\%,2wsD#1)5n)Uk/8q`$D۶/]*@K <~s&쩎rxo<~|j2paHF-p\%2n°-w}jH-lСE }o%&_xO~QmQ[hש݇K ݻw)11 TС}3,靑Yjt_j*::a-C):: }B_GȲ.O(vƱ[.˖-2u?۬YRRcc3&^yƝ;G5굜œ/ԡWɅ ۷oi*{h5"PFxBeî!]Լ`8VٳkH6a3,靑Yjtge~PCw% jF ҉CPիz7NlV"J'fy[zjGg-2uaEW_mQ*v[n7:Bbq`Qf5Py İMy=Vx[2 ,(xۙ3G_RX3𴴴{{{խ[ d:̒6Moھ}!dsX ?h7n"dDNFe2vIZK+"_Kz Znʞ:ڵ1 X)a*̑>6 =/mݻ{7 o;kV.ab–-R?5wFfҍq M?]Zbhe=ލS,[8ಕhlaFeògK/Yl2V ұG(`F[h0G+vZbX&3#^x[C2 6,=eWx[n7lwafd$$'G!%ܽ{_ni۶&O4gSofR{׮۵kgoqoc Ype+'oLߕq= )fϞX\ҽ{l1^ws(E'GN\xL>?}%%l2325 uQzcƄ1vm5ZDvX譙o‽dRRܹcڴivRIeDifIRۥ{ PR^##^g e \Q<%~3BO"0.l'ekZbΦ7,4#TUtyS9q'+(“2*֊>B7,~/I) g&M&$ 6n2&h%ItIF7ɨD-1ML2&:UlJF~*#Ue"(W_ʈnU2+VѦ -1ȯn2.r(æH`mo5Bԩ:u^0;*O\T_ /:rիӌ ݯ73ڼmaKoDj6WFuhg\ku A X1ml7Ed.C"UEY2@/]6H୑(ˆ\`m3&,2ە-60z#rs ɘ~:pРB<L#;vleǝ\2$ WFs a =WO#}ÑE|ѭ*M˨9DF,ԭ[mْK .m;Ag~%zewo<. ^B E.*%y~qf lBFaHy.!,# eF髯cH3ߺ~Etn2jNm#Q9¾&%E,[6Y[W'"7_Fنj9s$nk,QC2*ӼK$*Ãۄæ \BXFX>hر\c2o]"UEi5'ˆq17"7_Fs Ֆ7}z,͔Qn ؘxysgSj9l 2%e5h5'Xo]"UEi5'F,7$|-ވ\ssdt挀.x 9~M=4!NN,Pt,ǎQz6!i$<>,f'ə8+[UtFdT|ӦYzOlkaDnB# [n^f{kV Aѹ>,A=`=4;<'??U~eFs\_'=W8۹s5#>+[Ut'i⥋)g?yMkW?r -OM*9Mt[B8pz` Ĩ ׿3(Ftn '@K b&nQZbD7dtJ4$$dT&M&$ 6n2~FF >M3ѭ*WF JuV*W+[F2|HW/Tbf(QK§nT۪UX #"|YtDÍ>RPd+DwyM2L+Ѕ@9{pl|~1ҲeC5lX3+|:߯`ｗ Ho,bXOtt sHH&hLf7`+[Ut*ʜp?ۧӨ. +VEhf P>%%:6|g쟑 -*F\`ݷƏ6a =Xw(- $ʄ!2'qM}Djj nFH%jԨ)(Vtaj`6n\$6JN:wn=V+>?}nɠ†`C2JtKC7ɨ2aȯ .|p@V ^͛VҺuS6^vXuvȳү]ߵ3?6cn ggw ͏Kk_鄲!%dT0WC>8ĉM0S9o^3\\tܮ{vbfc&Vt~% D.q)h_'d wwy:~uJ2JtKC7ɨ2a;ЅhxyDEA..{\\f׫ nࢄOWAtL2Fdgi6I4b+SQ[IF 㿀1]#Uٴ]2JtK@7ɨ2a1Ǫsg'ϳffM7ɨ2AlTF,dT _݊7Qʺ~Et+HF+ѭx#U>ȯWDdT _݊7Qʺ~Et+HF+ѭx#U>,n&[$nر؟&]3,-g>rի$+[Ut*Cj*\37ݻ/I7r*7nQ&U&, >|xPʕ;s_]Batatί0c,:ǝ *!hÀXMFnQBaI8t.# .nv-IK]%L5^ApatVyQQvϞnm(fJFnQBaI8t}0! BAvqX$9))B &UGFnQBaI8tDܶ-' C+a& ~t˙3}aYWdHWD&U&, W _a ȯWDdT _݊7Q UZl[ly ]L6ƍe;w/_=6 FZZ[ac %ÇWVFn.Ѷ,n{l#GZ6QYNթS'//iӦn.X\,v-n{l| -K Qi0 =ydII{np=k7&A2J0NC5r,BKN]v?]U Z$ck(xby~phOǽwc=&@2J0 fϞ=yd+6 2NY% %PCh(ZM2< WR/^d=kkVA2J 6lժUViq@,xTr˖-jHF zPvm???DΟ!֬Y¯GԹqWZ5ãĊ 3H  A2J0&/#b_X]1{줤$+Qۯ񱗗6Q1@=>|8[>}'|la%Xzyy[v7nv+l$cHLLdd+SȨ[dݫS*Jl6QA@,FJ zT{ ( .]j[kYpM5KyOSu8A\ ٶKQQ>ٜ?~^^Mn@2JЏݻw[ĸ|?O+ %臟V+nEaaP|-rOeQիgnȑW.z~,QƍuQаЂX %Abb?e/?]]]K#rrrVm׮ U-4ZW^x%"HF "=z4dȐΝ;0 ((؜9szw}L:miӦw||9гgUV=|pĈݻwGq^СCmp>۸ ٿ~ag2J Q.SQQ (Zf͠bǏӧ;bŊ@[n;w P@+..U֯~i:={۷[apmkԨѷ~{ʔ)\ T4QT^̎ٳgd sb͚5+%% KOOoҤI-LMM9s&^geffrj(6Ьnݺ+4wu=x 'ʅ 2l0ǣɋ-b۷_FY=}Ҁd vݪU+/_" ʚ0a<_P/XW5 `{֪K +6NN2ZXXnhMh?%0TFY$g9;>(/تc ;q℣ݻw9o޼3gp[x<==_~رN:a2,((kVFFҧ~>/l۶-r  ;za朜I&4:8~xC]ӑQ_R۶Oa+ % Sj֬id<| M ʎ{v覗WTTr ~:c ٳQ|o]\\ IIIsmӦͥKZnݽ{waz"Ņ n߾̳g2M}2'ʏX (o$&&(Z *@Xŋm֬YժUGZKoc.ۨ6 QߨW2¦ADQի&_ާ()VZɓ'E 6lX*U81S83bv@ ()<<<{ըQ , www?G[C"XQ`[!&pK3 Ptl)/}gQ`7i҄/iii#\܀ 0"N:'qA2JPrٳgmۖ6}ʈ^%MJJ]' ih9d$\2~ɾe{4z|%* LZ~ %<( h?-4QUVa_/b#h!Ҥ Q\^^^H@ _Imbи 7HFQJ,O`WWRRmժUZZ%.nSEzJQUCys˗M4,Ye˖}㔝ݨQ#Y@g/^\vmɨ1rHI,E7l%_~*U6mjImPykgP |@O?ɮ%Xn@ro2)͊~Etn@'R_ݪ[&P~ɯTWD +Uѭ*e_J Q+^vÃ6ۢEC77;"EVUy-.*U}C6SCPP7WV7o:V[&P~KHƍ37__q"gϮ_Տ>Zm;ҥ"9We[JZ 8sdTKF^ݗWC9|ѿ{;;%&!c%%+Y1={re8b6onI.]p&\ۻ+;IoΙ3nxOqrV0G!V_2z?NcƄEF#DE^C̜9{pl|~1 tmժؠT\߿36+«L‽SXNU1HFeEGvzu& Ʊ% jC"ez  -l QKN;vޢ=0.&|or VQhVݺEt˖7ooӧ3+bś(\V_={>Yޖ8'o:ͽs稰$2 ?/)-m8փx acCK$'%E-ճfʹ{ g2*<iٲh^{,*q"KNbu*9@2ﱥ7[Q2[[&P~ɯTWD +Uѭ*eJU~Etn@'R_ݪ[&P~E95$\.C.4r>}ek$3'/fs@9Vo ꭢPτI 0C [}HF,9L/g̐F6%-(uzQڎl'/E3ZLQһwO4I?^"n:73g{ GbYӧ G9-WrQheg߰lc4rWR$*vXY8T{Sw`Mzr:?Yc K7/:={! =eb7I9)??w9Ҏ(ʰ֥I,#U~-W) V {9]] v2+kp-__wu7nѣKX2EÓfN6ԪU`_ϾH@ԩ<paq*1#oO|Qz$V \z0֪ "d4oը4e$%~5bdyn޻]`Ɣ,NwsHިХc6=FE䏴ᎎM.^,{IJ$OÇe4!!T]q@7כק6fwDz۷AI,T(ryy)xul6hB2j圎{m k_Zs!XlƵKٓhHF o1k`n̛ W?gZ4hy,:/.׹SJJtX6ޮTcqr_Fy{71hvfÑ}2\Wh.P\Lvm͚հY!8ysɨzNZ8{3(9|9w(MuiHF *RGD}xE:by`.1{{qa)>gW^dbzz$&MҩS^xuLgO=ڵªNl6>JBOةSy{]E&hO" ~JG6&j[l&)o-2QrVO ]:<|ElX" %_AF5Z%>9؝jdTůslA潎ר~#U*W+[Ut?V2O~*"UEL_ʯnU-(Ν`+WzJ`Pn${V2/~K;j W_ݪ[&P~ =bDǏOkDW]j1AAÄlѢ W! OvHewrS]ۏ ׯݻǣ9}:_'?//%*zH>qqaa>H>ۀSt޽=RScEVMQ77D&۽{FT%oo76m_|Mf,f6woޣ kډc`_g6CW7TVV2O?$lBF@L_ʯnU-(W+[Ut?V2O~*"UELW XD`-e-OԴ>GNbܩS۠nOh|{pqq9$ KϞn,ɨF2+&@1jBWtt ?{|l!yy)~zb92ZX>Soq?6J9B4jȞwVnիӄ9ǏәՐbśkժm˯HF7Qߤr%͑ICs^Wr%H(,̇e.]:I  h>fcPf2۷o W;|&03sCk9`̑X=aNzzZ( hnmίHF7QOY ̑ђ:sst?xM٧>hC&W6r@0+k4_FD\g&Lx_dжJtBh\詓9 gܸHlВcr簇Љ_ۢ[&P~M(tո^:;bϟСE$..}ǦL:`Cl3Mnl:eB?p`͛34 8ѱ k޼yg(RF.x.=ݒh$rumOczetŸmҥ" KC2*(,Otvl;Q^]p[߻tذc U4i͛n:i}$lXv>zt␐X2c-[n0G4ã NʓѠumUN.@ou <|X2bD;t씘 E/ ڗKNvqqpss\|'O#}Hc;¾$-Z410B;vlt ð~|UȪ`WmfQ9@~eېb۵ sWc]-[d`8 ٵmoRv́ Xߺu.eᶇ}%b܅.\xZENXl5&c~UȪ-*U[]f HFŲN06W ]iF5Ȭvt"_6wo`ukA2*,3s~=jEǎ岜ʑ+I͚tys;$,Ifϵ~Udt֬h>&:C~EH2Dw[Ǝ9Ikx[d@ vlأ^3djMl94)0__ӧ\Μ)(_ٯ,LLʯ [cٰYKGGn42e22 jU߽{_ni۶9r 8zz~(V >^''{/U[Xh?oԨɨʯ7ʸYo힎8@;wL6.]*jݺi ,!,sSnnX6jx_1έhbΝ]h:_1!qjժ@|UȪ}$" ZedTU~esxL l'O21QdTU~%[-ldT+mV겢6"2O~*"UEL_ʯnU-(W+[UtiJ~{f)Os?xvdTUF2W{"|_gɨdT/NQ#U*$+QU-(n_?0|xPÆu[h7.|C%  vׯ\{e.]UʖQ~˗wUT13s%ad1""|P,Cf0z.e߸_=]WLjgϮ_Տ>Z]2onҤ~\kª]2ZB uv0Z>?n7$/>>ϦVP:E2+}9<)l܎EEcǧؼ߻w{,lĈ@~.ֳc~~~0G#xx:ڧc9Z*~v3M2j29ϝSZlt"lVXz쁵8E2lY{p f1a~"u.eߐ_ $<׈b]W 3V#|x:ⱡU',%Uif2j?k}\Ҝbr"-L2j!2'`yaLF{r009Gg.>sB/fV5ns;I͛VҺuStH];]hz+dڵ]:caC:昁w7le;2;dC~eN8tX߾]cbg@l<=NҦM3&:@TYx0G(cC̍hoͬJM9ti. >n-F2ŊWFL!waMuBeבQS[&P~|`2: s˄_ömGBCUǴbyt_X1zkB+[vyʨI1qC*[ j Q)cعǗ 3qC*Q뚍(-(W+[Ut?V2O~*"UEL_ʯnU-(W+[Ut?V2O~*"UELW7׈har~gutWV\|Oƅwt|~A?&x671HFqá\Sƍd<(Z Ü~q͙6F.asdT$0tX5"wؚ+;7LV4yʨI\gn5C^×k]Xhδᦄ671HFK¡ Cd+{4 0P|Ed+!/+k+ٴfNCʼnA2[]\&C7Cbɒ䤤0[d(Э#M}xdΜic81HFK¡ Cܤh%=}:̙0[d(Э#۶eDsK U~- . ].Vxs{7VCY0[d(Э#3m ]'ɨoI8taKD o1\}OjU\{72GFݺuĜic671HFF7L2j]<1HFE2ʨMM Q_~esF2*#U~ɯTWD +Uѭ*eJU~Etn@'R_ݪ[&P~ɯTWր $jQAz( Ow d]*U%?$/>>HqPHF 5ѣ11:ujڠAYpp\сLYH!f9$ KϞnVM՘ڃS:+"_$uBݐ}yǏO]~nZW Õs$a8ڬYOIŗ0Z>_F!ăgd$ÞC//}#..^^Vuɀl=8([dN2JP-? ɨ9gKp|) ֨Q#V|aƍĊR|ӦYQέ4<vboaݺg (,'))bٲ$F2jN8t, WI͛VҺuStH];]h:zf°׮ ұ7_nݻDž͆&VFS HF eԜp7gtAƍ Ԇ Õs̱:o1a.V|2* {D.q֤h_'d D7:2udf(d8tlCBz@""|aXiʹxmn=xP\+X-_jaϑ3eP3-pJvXIf5Qc*!:E2JP3?ݍx8_~~ IfTe&nuQn)cعǗ 3q#TOw3F2JP?IFIF r;((PPt'%%ʟ$$BBӝdd@(W( OwQQ\nusum4i\zG'aǎ.4P͜Yxa#^F2J XOwK?xP\j.62 DB7QA,([~ʕ+wV:19|vmŋˆ¨ /a<4}ǎY}; U!CІ%%D%țL19\|vZ`%6\/0Kb3}reo¨=4U͚5 %D%udTC^ #Qa&c*͛!dIrRRFO'*>E&%,%udTC^t۶L(xoHFQ^^.ghEgVžB2J XOwKȨ00/qO8X^%Ln5LJ89ٳ|aT|VyaawmԨ( ?-~#A yalsphwaKtcUZUaID/64;<܇=/d@ʟD^#% ʟ IF q9#% ʟ$$BBӝdd@(W( OwQQ\^` XvA:t'@2J d@ ,liuIENDB`java-design-patterns-1.16.0/decorator/etc/decorator.ucls000066400000000000000000000113211312550536300232350ustar00rootroot00000000000000 java-design-patterns-1.16.0/decorator/etc/decorator.urm.puml000066400000000000000000000014761312550536300240600ustar00rootroot00000000000000@startuml package com.iluwatar.decorator { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class ClubbedTroll { - LOGGER : Logger {static} + ClubbedTroll(decorated : Troll) + attack() + getAttackPower() : int } class SimpleTroll { - LOGGER : Logger {static} + SimpleTroll() + attack() + fleeBattle() + getAttackPower() : int } interface Troll { + attack() {abstract} + fleeBattle() {abstract} + getAttackPower() : int {abstract} } class TrollDecorator { - decorated : Troll + TrollDecorator(decorated : Troll) + attack() + fleeBattle() + getAttackPower() : int } } TrollDecorator --> "-decorated" Troll ClubbedTroll --|> TrollDecorator SimpleTroll ..|> Troll TrollDecorator ..|> Troll @endumljava-design-patterns-1.16.0/decorator/pom.xml000066400000000000000000000036001312550536300211260ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 decorator junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/decorator/src/000077500000000000000000000000001312550536300204015ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/main/000077500000000000000000000000001312550536300213255ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/main/java/000077500000000000000000000000001312550536300222465ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/main/java/com/000077500000000000000000000000001312550536300230245ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300246545ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/decorator/000077500000000000000000000000001312550536300266365ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/decorator/App.java000066400000000000000000000050041312550536300302200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Decorator pattern is a more flexible alternative to subclassing. The Decorator class * implements the same interface as the target and uses aggregation to "decorate" calls to the * target. Using the Decorator pattern it is possible to change the behavior of the class during * runtime. *

* In this example we show how the simple {@link SimpleTroll} first attacks and then flees the battle. * Then we decorate the {@link SimpleTroll} with a {@link ClubbedTroll} and perform the attack again. You * can see how the behavior changes after the decoration. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // simple troll LOGGER.info("A simple looking troll approaches."); Troll troll = new SimpleTroll(); troll.attack(); troll.fleeBattle(); LOGGER.info("Simple troll power {}.\n", troll.getAttackPower()); // change the behavior of the simple troll by adding a decorator LOGGER.info("A troll with huge club surprises you."); Troll clubbed = new ClubbedTroll(troll); clubbed.attack(); clubbed.fleeBattle(); LOGGER.info("Clubbed troll power {}.\n", clubbed.getAttackPower()); } } java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java000066400000000000000000000032461312550536300320630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Decorator that adds a club for the troll */ public class ClubbedTroll extends TrollDecorator { private static final Logger LOGGER = LoggerFactory.getLogger(ClubbedTroll.class); public ClubbedTroll(Troll decorated) { super(decorated); } @Override public void attack() { super.attack(); LOGGER.info("The troll swings at you with a club!"); } @Override public int getAttackPower() { return super.getAttackPower() + 10; } } java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java000066400000000000000000000032511312550536300317500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * SimpleTroll implements {@link Troll} interface directly. * */ public class SimpleTroll implements Troll { private static final Logger LOGGER = LoggerFactory.getLogger(SimpleTroll.class); @Override public void attack() { LOGGER.info("The troll tries to grab you!"); } @Override public int getAttackPower() { return 10; } @Override public void fleeBattle() { LOGGER.info("The troll shrieks in horror and runs away!"); } } java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/decorator/Troll.java000066400000000000000000000025041312550536300305760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; /** * * Interface for trolls * */ public interface Troll { void attack(); int getAttackPower(); void fleeBattle(); } java-design-patterns-1.16.0/decorator/src/main/java/com/iluwatar/decorator/TrollDecorator.java000066400000000000000000000033671312550536300324510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; /** * TrollDecorator is a decorator for {@link Troll} objects. The calls to the {@link Troll} interface * are intercepted and decorated. Finally the calls are delegated to the decorated {@link Troll} * object. * */ public class TrollDecorator implements Troll { private Troll decorated; public TrollDecorator(Troll decorated) { this.decorated = decorated; } @Override public void attack() { decorated.attack(); } @Override public int getAttackPower() { return decorated.getAttackPower(); } @Override public void fleeBattle() { decorated.fleeBattle(); } } java-design-patterns-1.16.0/decorator/src/test/000077500000000000000000000000001312550536300213605ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/test/java/000077500000000000000000000000001312550536300223015ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/test/java/com/000077500000000000000000000000001312550536300230575ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247075ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/test/java/com/iluwatar/decorator/000077500000000000000000000000001312550536300266715ustar00rootroot00000000000000java-design-patterns-1.16.0/decorator/src/test/java/com/iluwatar/decorator/AppTest.java000066400000000000000000000024761312550536300311250ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java000066400000000000000000000041131312550536300327500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.*; import static org.mockito.internal.verification.VerificationModeFactory.times; /** * Tests for {@link ClubbedTroll} */ public class ClubbedTrollTest { @Test public void testSmartHostile() throws Exception { // Create a normal troll first, but make sure we can spy on it later on. final Troll simpleTroll = spy(new SimpleTroll()); // Now we want to decorate the troll to make it stronger ... final Troll clubbed = new ClubbedTroll(simpleTroll); assertEquals(20, clubbed.getAttackPower()); verify(simpleTroll, times(1)).getAttackPower(); // Check if the clubbed troll actions are delegated to the decorated troll clubbed.attack(); verify(simpleTroll, times(1)).attack(); clubbed.fleeBattle(); verify(simpleTroll, times(1)).fleeBattle(); verifyNoMoreInteractions(simpleTroll); } } java-design-patterns-1.16.0/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java000066400000000000000000000052461312550536300326510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.decorator; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertEquals; /** * Tests for {@link SimpleTroll} */ public class SimpleTrollTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(SimpleTroll.class); } @After public void tearDown() { appender.stop(); } @Test public void testTrollActions() throws Exception { final SimpleTroll troll = new SimpleTroll(); assertEquals(10, troll.getAttackPower()); troll.attack(); assertEquals("The troll tries to grab you!", appender.getLastMessage()); troll.fleeBattle(); assertEquals("The troll shrieks in horror and runs away!", appender.getLastMessage()); assertEquals(2, appender.getLogSize()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getMessage(); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/delegation/000077500000000000000000000000001312550536300177435ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/README.md000066400000000000000000000016541312550536300212300ustar00rootroot00000000000000--- layout: pattern title: Delegation folder: delegation permalink: /patterns/delegation/ pumlid: JSV14GCX20NGLf82LkxfXbN69OFeu2VRVdBCxRsdUhLiac6F2rZxHHHybwwuyimjKQT37ANEGMfvCpZepHy-ccpjVYm697pJuFq3DJ7f39rEWlhNaZ7Aoc5V categories: Behavioral tags: - Java - Difficulty-Beginner --- ## Also known as Proxy Pattern ## Intent It is a technique where an object expresses certain behavior to the outside but in reality delegates responsibility for implementing that behaviour to an associated object. ![alt text](./etc/delegation.png "Delegate") ## Applicability Use the Delegate pattern in order to achieve the following * Reduce the coupling of methods to their class * Components that behave identically, but realize that this situation can change in the future. ## Credits * [Delegate Pattern: Wikipedia ](https://en.wikipedia.org/wiki/Delegation_pattern) * [Proxy Pattern: Wikipedia ](https://en.wikipedia.org/wiki/Proxy_pattern) java-design-patterns-1.16.0/delegation/etc/000077500000000000000000000000001312550536300205165ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/etc/delegation.png000066400000000000000000000612541312550536300233470ustar00rootroot00000000000000PNG  IHDR@$pbsIDATxXm 5]cA%*Ƃ`C4&;5*vQED`EE[XT:+w㸣}xfgg{̼7;E``̙(Jx k߸N<ǝ. QP0pF!8@I!P 8@I{(G”Й3WZʪi^)?$d]I~Y.8@IHl۷O͙Ynhk82cb;vl6jTo.+ ŋ(x:t3)8@IHfࢢFWR޾Ǿ2͛WV!Y17l]ߢ!C-&26rŋdlmVOϩ;JfIj:~|uŊ859E 눈#o(XV>th7::):5 0p,ui`=KH`v;w+&%ќ)6pQQA7onR>psLbb *yDm1^Աlְw|r~ŝ"E'BC'3Ws& z@o]MB?iB=xpI֕*^ϟ5d2.%%tAVVJ*Bk֬ tbǎd:vlƥ>?l3552| NҿxBGIMC(x::ڑNBm&:> B|i/V̙j3׭52_ϓ'wbbӫWHKݭFl/rozv˖\kj1%$gr;3Lb11S[IIƦO'<SXi(B? EF|LD_>X~:u,W8w_:8݆55q}W̔N CՑ(NQ'ΑMCZ$| K?:3f bKZ+gnK0体B?Y8&ZDmTӦ[ NbcO,"Α]TkXj0p)Eݑ6*T=u׼D?0pP慎$\Òjna^EY[[^n=Zӱʅ^Sy~yyw;tj͛[̙҂R{'6kVt颿֝9Bq_B`B|'WGN+Wf9vѱ(7o,h=i>54#w\3g޿1Y+SS{|n!>P9q#+mB&}y~ !0pF!t|d| KN`< ^9BuwشiMj*p__>pv֪U{-j+䥷5/я (,]Ò8*r.^TjyN`MHj?8V8={ȠAU[!5/я (,ZÒ8ލ _ח/Q#'8[j?aŞ=]By~ !0pF!t|dy' e11ffWxQڵ#o=ܭ[;3}{G9s`KcwZ诞c:n9RrC:>5ְlɓV#feUڒM5pim4 #"$ҒY7{ mö; fD*%B+.}}޽wGE/I3ֳFd5,ҧO'XzZ2vĐ9WMB?L8rigw?}ߵݧ84aYZx8\+s\ C9s-j՛z]>|x}#͛CV2L^VZ> ,NzVQ*D.a7Neoiԩ7V%(f2G">0pZ Ռ큁3t@H \?՝av GLoW{ڏ$J4pصc]t3Wl"Eguk%ıc+Ψ8rѢ?(=fT".t۶ ԟ'ENr+/J}-g!jjjr޼euDaaҪKiy.> !0p.c NO>{-w#m9~3p,hZB6m$vSڋ*9^V6&CRMRRBD0pZ :>tЅ~ !7pLlh=wLYeBClԯûN=p/T4b/[mZ`8T)׮]c^Qcckf2۷5g~;wΡٱ|*C1m3GrD uri8-:!Cw싵 Ύ7qߘ(M9G%[@HBвځ}]}zqJuNUjZ]?NdJ(Ul{5./\t^m&M/nŕjUr&O7z+W=<[NQC\NsAyDmfb4PJI-)Џ $S/3vi:bKJ[5j*9ZUaCBQ"ELL0P]S<ٰa52st,ٹjcS: }|iɥa?t|h !=v-urۺn2Qr(_gMi~ !%rimkSuNҔ޸l0pCY;~c*%6m|_m+WȽʕԨQ9scDK{Zv>ӪK{0\.]dee3p1pD c;= #s 5m2*hJ.cɚB>fC~-T4UIFJ}v}0}Ÿ=gHN-%]2YXXXZ[躍ͪ]pvs<_d |rHp;ϗ":-i|?gϨ_}XxGg/e專N O@C. &DFF:;;ܹsϜ9sWT2W\f 6lXN(W,Xۛ0`ر*h|Av׎^}{Xx[߷]專N O@C,O<_z82^gPB,388f͚+TwwMFBTVK5p|=Z".ρ~nW_M$f_8iєЏ (''oR2kkk~SݻGƫjժ,Gh.^ nڴiJ xⅰ-Ov~;u6.^,<7)M9$;߃rXDSB?8:>>}z9'O-333#sCƫFnLl۵k˗)))zD>]ܳz4wޤc=1h)Tє\gBnϞ=\\\Zlɥ~#LLL^~M+W(ۻv 6kǭ,v\?q꾓 dMɅ~ !0pF!t|@-+Y$- Zj={ɓ͛Vʟ??>sJ=Z".\c;}?娸7NNh@>̥v3NJ>|\b{ƞL3 ;̿9ڗXmYddd+IJJL3p))f9unӻgά:!q>ۧO;;ϥHV0Ծ'щ.7g۷wP;@z)[c-\!lt|@nٳG( B7pS L{|'.^<oԯO<ܱcv_҉ @"2?x;8boҥͻwϣaoھ}6Ya˖;%XPHÇ Ç@VE"_d .eW{D>vjjxrMH610p%UjH=ƍk]#YdiЏ $}7n\-[f/BnԨӧd0jNzuKn-]ϟrū_?;4{k߾ɂɐzuѱC?K{KK Němdv懨@&5w!U""i J=X? )EF6ʪǏ}y=|zg؎uVy?8C1oFM'OϾdǏ .B&`o ȾP˛lY7)LӦ5IAf/å;͛BQB r,9q⯔8sf=k^\C,q49 `ةixOŋ(g*8!kט^{RDa+X`ѣ_zgB? ّ!CvnӾ}Pr u&oammIKPx#uXvѱK֔ ֵ뗙Sܛ5=`@":**Cśx1&&Sf$kǥN ޾mc)ׯP/wl6ߦ!vjݻccSwɪ^#۶mzi?+TШQ6Ѕ~ !>$$kvW~\:FA*9_ěKR;Y%̿|yssg'yt{;}5T_Nt1cm B"#iӠ[M 6]\UΘDh㲶9ڗ2lcS//h;k֬7Yئeoa0pF!t|8yѣ .L]4-я (B&[gBк1]4-я !gNInJ^dmց򖆸e8`(($]vqXD?8:> sN8?TX[n޽P299G.[gBLxxxҥ_0f̘UҥK͛7/\03p島pڵk)_ϝ;dž]a倁@fBMNN:@svvf锔\58j*ݻ,X] !0pF!Ξ=bŊ[nRo߹sx$a,7o^yGZCX*lff6x`tq.8 Ç_.=zl۶'N[Ç)L A%rСM׫TX||<=ydFFIiMLL~JMʕ+goo]w>!3p+MiXyFcjirtңG(?ݻңGpCBBΝ;džOr`%J I(&L8~8gffG%K4hЀϟWp5klѢEhh(KQ18C}us{g-Dqq޽;*#f{- ?ҥK6l@?[nݣ4 wMIIɺ ߿+m (TPWZEϛ7/K-Ztǎ.W[CDyé8A%_ 4%X_PҥVV4T;cƠ:sUS#{ic-z'ر}._ެw&6d?$&7eaѣ={rHN֮]˥5G&&&:uիоZ%ܹC-,,,6oެ8C Ba.\e½ȂHΤ3TYm߿mc:(Pxǎj/1wv1z~go6Z/_R*^۷Tc7zhv_݃bcc; 9_fVڵkts+W޴i:Oc?vNNNŊ[xG` ]0pɚPUl q7Nv͛VWZO.7nlut0rd"E̬-_=ZS VVS<}+zI[ɝ;gz`@KӾ][P~;qb _O'Ļ5p#zSqΖ)SLͲ$9v o߼yå~;k֬J~Z,9ϟϟ?}zʕw^YNRRRǏ%uV'zAhSC;or}Afk/($+WYȊ fߩS3|@͛C z{Ϥt;msj;b=~kffiӴ6NpgnkVyi^R6gw [?u]N-)))l ߱cǴi>Lʕ+Ӑܘ1c/_ H*uVrHHH%K3gΐ:q?}$E5wq%~ 9>~v%襠/M!cn ig.^ϟڔB 55kV_OlڴfTTժUPg9uXsQ͚fiڗ*$ӣpš.6pFE0gadɱ!-[VHLL$WW _yf̘nc's&v;{޽{ 4ܹ3(P3tɿ@oZkW};LafS\}=ًU˳Ц_mʴiɑ*U׋zgIJJ(tJ߹FfRL䢮^ݢpš.6pFH%;D0eJet|d dΥ9VZqbҥǎc% Pyə3g7޾{yfff͚ϟ?a ]ڏMorϲ4+La^Ld/jԨB{M]| /_'&'!!$_>᷄>>s˔)f \>on_ S>֭/&&==rȡCRݻ%J`?yedjqqqFׯ_xaaa}ݻٚХ~ L+ c&j<),yB21L\oؔիUPڵ/=Z KC97onON>2VNXN .mRÆΝ0Ύ|۵k(+GGGfΞ=kee5~xJ?}ח?t?K5m~-թϟ?/Yȑ#R(1p*K6R@;I?o|r˂. P),%6ήi{ܪ [Jml[*j$[ N9E")ҢtE5hP}(-nbiX2cs{zV+cC m=aڠΤ̦;2dG-ϖSuX+<\v!~l>[q񉉏?{S(}Ŗ-['o[[[ooJǏ_|Y>k]~}֭޽}% ,?~<{ٳg|Tri#H$RpUNN>lJJsi,~ څ!3v:0p m巈-#B (%%e˺Ϟ͛[?/Gǧ=QQQb+b9rzܸq\'zM\ﱉrlFpҤI 4u{ɥNzTr2cnЮŋҥś7tj"dLL9}o祏+U*5Oڻw>,[…mېe l֬69awre[ ҕS|&Lv8VsZ+T(5f !c?f/XCB46U _yoo۶|...rvvf? 6=%d U7l`ooO?Sf?>)));NʨeKխh EFqvF*ZHE"mkx1O2ծR+f V/ dH*9sئ=۬_?I=[/$X% (/;`T>x`͚5ع6n8a{bo߾MLLRgF~@gϞ;w޽Ǐq DN+::K]$|U\ܩ (\$#G"ElQ\Tj?G7n*4p* C;$F'LU%8w-[e[F `B 9˗/ϛ7c7qoחҞK,a~ր~Rd~xd`5G"qNLLjծR1c&Ne޸Uh Cvbǎ{/Íח*gΞ|3  3K]m233eO?}/w\11XQH$Y B/Ʃ]Rsd[ּg xaH*ܫW۾}mlɥ%+5o|3  3K]{왗2}9"Ξ=d|}(=c.^RsGUdml 0s-[Lba_~ݛ{>d(vm|3  3K])YHYX'0j"+Wj֬D*T(ŖԭRnS oȐw…!/Ğ~%98݆?;uVhQ3|{|2Y.t|dfK6]{RK1#%^$767&.? \һvGdK !lAO˔K+t|dfKW&D~laQ|, TY~Z CЏ DO˔K+t|d ?gϼjٱHWf\'u|i- iB?1pX\˔@KʘЏ D[eL9:>4gB? )g[eL9:>4gB? )7e8C1oL,S Џ $}e ert|h>}R_DȈ )7ea$o^xqÆ ͥE+LLL>| u R@FK V1`rX\`HO> 6B ˗ӧ륎K+̙SH}IP>nݺPBC 9ydJJA`h)7hlk۶m/oݺE͛7_N+ʖ-2tPck͚5[lً/-ZTN '?R5 br "!!A8F z'WժU?,aڳ{-Zs:xaѢEd,--^ڵVZwu۷ob"<K.Jtt4eV\ѣR(oߒQ)CG6[!*<?0}ҥK?{e>ydʔ)\꼩 _`͛7k~9[nC-J% ,WQyf0311Ç(dt-[HKV"\=DC\L$]>ܲeK@ӧOwΥI!u,YL޼y5<<\Xȁ޿/u2eذa&M: 8+V1.Ϟ=: ;|pq(8`dɒ%T3NNNRG!w\]]'ud=0pjժ^zIP/^(_|lllJJԱdAtt4ԩׯ G#uAddO1  @z֮]i&0$ܹSjU0$nݺUdID @JFadՉJqs΅T`e˖W^={,))IXQ؀͛7׮];11Q@ G:uJ( {yyIoN8A FYb!u̿˥>,u d8^7n\nݤf~6l: 2 @OϔxԱ??~=K 0v`:ӿٳgKr0R"M4yԱ-޽c?HqӧHQk.'''F @[ʖ--u۽{wppQ;lnɒ% R8@:DGGN>-u, ݻK0F`(_ ?yD(m6{  @=111񁁁:6mzYa̙Ǐ: `DcKK˸DcyF(]RR}:`slƍ: Tn$u,@۷?~:&Voɖ/_*UR  쇺kԨq1c o?~ ݻw###(8G#Ν;ԁGX@:~֬YRGٳgʕ:L`0v^zUhQ,@k.< 8۷=z$u,@[^x{n^zK P0p).]*ZhTTԁ֭Qpvv^pQENW^}mc:sv"0,._L'u @!`\:tUV:v-_\(X3ڵ;wdsI ΝK $0p[`%d~mRG2#~ed8NRR۷o---={&u, ضmիWd4lؐ d]'c_, 2 X(Dalݺ㽒8ydɒ%qo8ŋ#G>| u, Q>kEFF޹s$1Xn]:ud...b$Ⱥwc f͢OR pǏ?sLllԱJ^ܤd#>\rԁϟ?yVPA(@PnCI50p6/>z(a307c Q?X [˖-cbb-)S&44T( Yn{.0*ܹ+u@ܾ}{ԩ~puumڴQ X~QG嗗/_J 0ph>}nڵV(`իט1c $cS;c n}j޼˗/qgq1cȎ+V^(\ ryc~(͛RHB0) T/VأG8dͬYBr#5+#?~Gcz IHH āE2hHsR/?޾}+u,@ 1u\A:I@'Jh(922ƍR"=9` ]C=YM>>s5gJh20,O 6`)tIy64on]R+9XC&>}]J5kVbvmclS;6RsŘg s(}NN֐|vʔŋkĈ9TS!fPh21l(Jh PB1nsC8}ڽC3?sfu&yy͠/M7o^zEr`\C^zj۷-3YŘB39uʝ[L1j|CP[Ca}8 <~2 /{L<ij#̄)tyJ6^Wna>IIƦO'<i~}~uXV^qa <vݻ۰b&Nʚɓ@[Ց(NYHeRhr1,C 6`LaCUt| O^^bvj=2,1\)!ij'/ـ1.@$ J /{L<_0pB S22-1rn  qK$+)!ಇt 0)tKnI0pB S2-1 h>I0p IĠ!@:I =`01nIC8-W1V ~^)M9G 2 4`H')c#0{ mö; fD*%BOU4ooJ A=d@hNRƸ%F@..ﻶgC7?rBK'O",π1Νr2lrQY5wbaX=e4/{i'/ CKiC4&Mx17쟄c3OW۰a2/j;*>ws8)S^%.t5kƧ[EqP u~ZsZ6Ԁ!9HiB n)t= ݀￱O?x.me"_'7SwNN]TYZZ+Wb]\kԨhjjҠA?+.q[{LI ۹sN͚5>jc;w8h/*9dH yzNSDzE kk*U#)͛C?ܺpU77(2:Om:9s碜"#TF0pB& s"e[bmn8zH}4әiC 'Y7HC>^hТMiiڴ& 3 GJ~}-ʟ3Ǚ6uz7U@ O.XmŊwnCK3 U޼59spDJg+Wμy \ɏv*ٳ eV-Fv^=+z٨QJJS "pJhA&f:?IgN^ȡk?7+::=~2@2ve[bmtםav GLoW{ڏ$J4pصc]t˫.23pā_~Nw键_*wG=Z?}\LjA\D囚}S$޿l{H[cD{7 _G.Eև82Rl!CW 436EH2.ر)K*I [lwOC|& VPM'ON …SIc!/ŕ!d-[N 1h2p9TWB0tm΍o>ONSѻl>3lciWƸ%Fچ0xĖ 9z `}ǔA_>F1tQ]K4bQIog+Wzjkffl}+ܹs\BC`R68/^mڷoc` Q|hVB`pJWR]Ƽ># !3u~81ˡn3Ie]/{%4CGx\ܩB gGj<ٗ\K6;8+YHr%vmvKFlog+ ?XNhcɾ.> z8p:'*~ 5-G=^a߇WprrjJ|jDeJ(F6!WnDX:8+r|hV5sJ_Iil7ʥ2A8]秙koS\9N5gʺ^Jh X۷w7UQ#^7ݻېѡvvMnۙiJBYiK{4׹_J^xNW*,̮￯Eٳ>ƌ $3r;]Fg.Y2j(_$Ʀ>&0th7SSJ2g6>GKG?6>$d,RČ D,\*)!H~k#]5y' 47~6hcMO]?7 Sܸ}; XIa$#f=ݶA;ZD)M9*K!~Dٹ]{_~i?|t騚5+Q33ӟn>>}:ѣGki]kN`z6pCىhG/iި211.36!"JK/b)!OW:OkcSԜO*k#8y!min0cO1۷5g~RCm߾ɪU㨁+W8ō۷3ـd%4pPJ .{5piMQ66`][GOsrn2Wϟ_?d(?2K8 og+ 4->)!eiN)ꬕM*k#8y!yin tհa52sl,E]NikkKa;6mpvf!@%e4c1EI 94`ƹԵȽʕQFqf:8˛[ʧD&5<ح94`%!u&'/dҀu'm8?::HxK4PI0p IĠ!@:I =`01nACt2.{H' 4`H')c gx{Ϝ:u@+!pŊ{23 ;̿9ڗLi+cPh!'/Ѐ!qKL6114p7nlҥ{ea7G ;ceJ ?`01n63Æٷmې+WNѳcf=z^Cז֪Uy ysӧ_:9{/\;jZGv{wRj7Smׯ׭[= M1XX1M-`;C6mP>3p))f9unӻgά:!q>ۧO;;Sr#SSgG'Bl8Uxܾ*~Ր{H?ha} a¿?s8cƟZ~_)°0e0xf0pNRƸ%F<=ԙO\xL/߾ _*2;fרe8qb#V2?x;8boҥͻwϣaC?K$޴}l+˲eǎåd0+C! %lYa8ɒ&c ;5 K|_e(?I& Y i߸q Ud"K,|6ywX*#W%lE6LGUtի[uk} ܕ+^ّ9سg^M,Nի:w_[ZZpVʫ|¦ }}0?D4ٽ 8_L$$TPJU TŊY(52ȰaVVȧ>~˛*!;v[ʋi/ޅTƟZ~_0 O<+:B2L3)c#ln7ٞ6tȆgxVB0t0e0BgRƸ%FȎ ҕ>o$4ԃ.-[X[[RȥvjǛ7 p$8R%펎XʥNѧgJP_ٵ l͚0?g`TT%蓴xo2#ҿSf$kǥN ڍHN+JOR>}3Ɓͷi7I|l4TgzOVut 4իgHC|]5p鈫U [ &3:`` SFx'L/3[l6}VʡE&vj}*/o>w΃w중5`2hlQQh[]4.i[ &3:`` ݻ-ƘoFP!m0v ٱK楌gLYGFWXFtiU9 ̘1(>G;˛ccOvCbb{t1 8H')cym@v}^G,\˄eȜH3T2mw;FK~Ghʞxq N^A:I㖘̌di7:8߿cⅺti!LL !Wdn|  g%۷"7ֵkW};٫H3kk׽9#5n\cƩ׮yQ:tj.xo$zhM5XY ?LSǒ"CK*ӧ;6 pc .SF.e4|nKvg+ӲeyZ5`XBt2-1e߸tz%8QC`na+Veںu哗 ܍<e9E 눈#oݏn4s2|پr5),a:5khܻw7&;w3߿16蒛{{Ϥt 롗T@8W׺uS%e"e48`EVM+9fRƸ%FCC>~v%`/kڵk ?Z֭$()!df8'.3lY7pg+@0p"3Sxek&lZo<z5ri̊s۠qKLZ ^|F񛐪^R 3p.Q^YC3ިԶmPDtPDŨTV\+db钦/Yw5I+mذڹs_22Bf&5|v  +V,vGjhxx!]5ܗ; KĤ|r˂. P), [΢d",,-{̏K} K*Lf).Ԥ\T\v8;y&j8jT3g֫Cjժ}ai PF+P&RFCijf'{'/23s:u,D#phø4fqaI 7 Y`ZW 1.B9""TexF-BAms˞oͧ!N) !3Ϛ x  ?l355&PΝ,1} jJiܚ'⸃۰qKQ~T4%!Z1 lZ$)!dfY=cXBOHɗDŢ2eQ޼yzQ"֮ԶImXRƸ%FAWx={I/ˌ}-y02BvLmtV !"!8y! 1nLCqcC;/^Kok׼)CV-gMXIG#G*R/j=z[Y ?ܱc7.uӧĐ/|-';^-[|۶m2i,S[Y ߵ˕m[4dHW.[ڵ[v\&;V*3s&Oǘ?(:0pNRƸ%FsC=M Vˏ&7+_5柔Q@Y}"FHM.RcS44Qc{Mc%[ZtuVT%a~ Gv8ݕ{+<+ןcgt&87B.+++]\U,ӃA!u{K``ˎQG>{{8jvvSa"C ]O9̹`vٛ z+0NJMw:}Bfda%dݢwb3/mq_sƆiU1 hu/WjpЇӚRw!>2L.nMNvQg϶8У|83N)nU_X? AǽD޽`ʏ|7Yi.,Ʃ.adrQ;ٮ]wvS%%ʊ_%н7obp!a*,`6 ڵn6^ ј1!%*)j^}93l! q`,Fٛ :#t6 P8TQ||rы_"!Yf~;٫aqkZތO*,|+qƍsq= KKGcxXVuQVVk0Q;vɷ'5jC~Z+-Bp< 2xQ&`bnW&a !lW}=8U2F ũ^GMl:8Bb5rJ8>s Q>[pի !P4C <.{t0BdnC&a("Ɓ?$z!/_ggnlhiٓ6l׷ly-P! m p: 2B!`͗A>\aﱤYGf)f>%h java-design-patterns-1.16.0/delegation/etc/delegation.urm.puml000066400000000000000000000015571312550536300243420ustar00rootroot00000000000000@startuml package com.iluwatar.delegation.simple.printers { class CanonPrinter { - LOGGER : Logger {static} + CanonPrinter() + print(message : String) } class EpsonPrinter { - LOGGER : Logger {static} + EpsonPrinter() + print(message : String) } class HpPrinter { - LOGGER : Logger {static} + HpPrinter() + print(message : String) } } package com.iluwatar.delegation.simple { class App { + MESSAGE_TO_PRINT : String {static} + App() + main(args : String[]) {static} } interface Printer { + print(String) {abstract} } class PrinterController { - printer : Printer + PrinterController(printer : Printer) + print(message : String) } } PrinterController --> "-printer" Printer PrinterController ..|> Printer CanonPrinter ..|> Printer EpsonPrinter ..|> Printer HpPrinter ..|> Printer @endumljava-design-patterns-1.16.0/delegation/pom.xml000066400000000000000000000037731312550536300212720ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 delegation junit junit test com.github.stefanbirkner system-rules test java-design-patterns-1.16.0/delegation/src/000077500000000000000000000000001312550536300205325ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/000077500000000000000000000000001312550536300214565ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/000077500000000000000000000000001312550536300223775ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/000077500000000000000000000000001312550536300231555ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300250055ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/000077500000000000000000000000001312550536300271205ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/000077500000000000000000000000001312550536300304115ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/App.java000066400000000000000000000056051312550536300320020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple; import com.iluwatar.delegation.simple.printers.CanonPrinter; import com.iluwatar.delegation.simple.printers.EpsonPrinter; import com.iluwatar.delegation.simple.printers.HpPrinter; /** * The delegate pattern provides a mechanism to abstract away the implementation and control of the desired action. * The class being called in this case {@link PrinterController} is not responsible for the actual desired action, * but is actually delegated to a helper class either {@link CanonPrinter}, {@link EpsonPrinter} or {@link HpPrinter}. * The consumer does not have or require knowledge of the actual class carrying out the action, only the * container on which they are calling. * * In this example the delegates are {@link EpsonPrinter}, {@link HpPrinter} and {@link CanonPrinter} they all implement * {@link Printer}. The {@link PrinterController} class also implements {@link Printer}. However neither provide the * functionality of {@link Printer} by printing to the screen, they actually call upon the instance of {@link Printer} * that they were instantiated with. Therefore delegating the behaviour to another class. */ public class App { public static final String MESSAGE_TO_PRINT = "hello world"; /** * Program entry point * * @param args command line args */ public static void main(String[] args) { PrinterController hpPrinterController = new PrinterController(new HpPrinter()); PrinterController canonPrinterController = new PrinterController(new CanonPrinter()); PrinterController epsonPrinterController = new PrinterController(new EpsonPrinter()); hpPrinterController.print(MESSAGE_TO_PRINT); canonPrinterController.print(MESSAGE_TO_PRINT); epsonPrinterController.print(MESSAGE_TO_PRINT); } } java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/Printer.java000066400000000000000000000034551312550536300327060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple; import com.iluwatar.delegation.simple.printers.CanonPrinter; import com.iluwatar.delegation.simple.printers.EpsonPrinter; import com.iluwatar.delegation.simple.printers.HpPrinter; /** * Interface that both the Controller and the Delegate will implement. * * @see CanonPrinter * @see EpsonPrinter * @see HpPrinter */ public interface Printer { /** * Method that takes a String to print to the screen. This will be implemented on both the * controller and the delegate allowing the controller to call the same method on the delegate class. * * @param message to be printed to the screen */ void print(final String message); } PrinterController.java000066400000000000000000000041441312550536300346670ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple; /** * Delegator Class to delegate the implementation of the Printer. * This ensures two things: * - when the actual implementation of the Printer class changes the delegation will still be operational * - the actual benefit is observed when there are more than one implementors and they share a delegation control */ public class PrinterController implements Printer { private final Printer printer; public PrinterController(Printer printer) { this.printer = printer; } /** * This method is implemented from {@link Printer} however instead on providing an * implementation, it instead calls upon the class passed through the constructor. This is the delegate, * hence the pattern. Therefore meaning that the caller does not care of the implementing class only the owning * controller. * * @param message to be printed to the screen */ @Override public void print(String message) { printer.print(message); } } java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/printers/000077500000000000000000000000001312550536300322575ustar00rootroot00000000000000CanonPrinter.java000066400000000000000000000033161312550536300354500ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/printers/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple.printers; import com.iluwatar.delegation.simple.Printer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Specialised Implementation of {@link Printer} for a Canon Printer, in * this case the message to be printed is appended to "Canon Printer : " * * @see Printer */ public class CanonPrinter implements Printer { private static final Logger LOGGER = LoggerFactory.getLogger(CanonPrinter.class); /** * {@inheritDoc} */ @Override public void print(String message) { LOGGER.info("Canon Printer : {}", message); } } EpsonPrinter.java000066400000000000000000000033161312550536300354760ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/printers/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple.printers; import com.iluwatar.delegation.simple.Printer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Specialised Implementation of {@link Printer} for a Epson Printer, in * this case the message to be printed is appended to "Epson Printer : " * * @see Printer */ public class EpsonPrinter implements Printer { private static final Logger LOGGER = LoggerFactory.getLogger(EpsonPrinter.class); /** * {@inheritDoc} */ @Override public void print(String message) { LOGGER.info("Epson Printer : {}", message); } } HpPrinter.java000066400000000000000000000032771312550536300347670ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/main/java/com/iluwatar/delegation/simple/printers/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple.printers; import com.iluwatar.delegation.simple.Printer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Specialised Implementation of {@link Printer} for a HP Printer, in * this case the message to be printed is appended to "HP Printer : " * * @see Printer */ public class HpPrinter implements Printer { private static final Logger LOGGER = LoggerFactory.getLogger(HpPrinter.class); /** * {@inheritDoc} */ @Override public void print(String message) { LOGGER.info("HP Printer : {}", message); } } java-design-patterns-1.16.0/delegation/src/test/000077500000000000000000000000001312550536300215115ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/000077500000000000000000000000001312550536300224325ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/com/000077500000000000000000000000001312550536300232105ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300250405ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/com/iluwatar/delegation/000077500000000000000000000000001312550536300271535ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/com/iluwatar/delegation/simple/000077500000000000000000000000001312550536300304445ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java000066400000000000000000000025051312550536300326710ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple; import org.junit.Test; /** * Application Test Entry */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } DelegateTest.java000066400000000000000000000064701312550536300336110ustar00rootroot00000000000000java-design-patterns-1.16.0/delegation/src/test/java/com/iluwatar/delegation/simple/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.delegation.simple; import static org.junit.Assert.assertEquals; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import com.iluwatar.delegation.simple.printers.CanonPrinter; import com.iluwatar.delegation.simple.printers.EpsonPrinter; import com.iluwatar.delegation.simple.printers.HpPrinter; import java.util.LinkedList; import java.util.List; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; /** * Test for Delegation Pattern */ public class DelegateTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } private static final String MESSAGE = "Test Message Printed"; @Test public void testCanonPrinter() throws Exception { PrinterController printerController = new PrinterController(new CanonPrinter()); printerController.print(MESSAGE); assertEquals("Canon Printer : Test Message Printed", appender.getLastMessage()); } @Test public void testHpPrinter() throws Exception { PrinterController printerController = new PrinterController(new HpPrinter()); printerController.print(MESSAGE); assertEquals("HP Printer : Test Message Printed", appender.getLastMessage()); } @Test public void testEpsonPrinter() throws Exception { PrinterController printerController = new PrinterController(new EpsonPrinter()); printerController.print(MESSAGE); assertEquals("Epson Printer : Test Message Printed", appender.getLastMessage()); } /** * Logging Appender */ private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/dependency-injection/000077500000000000000000000000001312550536300217265ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/README.md000066400000000000000000000020231312550536300232020ustar00rootroot00000000000000--- layout: pattern title: Dependency Injection folder: dependency-injection permalink: /patterns/dependency-injection/ pumlid: RSdB3SCW303GLPe1mFTkunWhSGG6-PEesxS3zFQajubIpyPf_NL6B7y363xra3XpJsUZgS4QbUO0wVbWeC65DvR6BeUMXH5iwZ3GVu36YxMnqgU8NamXKu63_aPD6tNbw5y0 categories: Behavioral tags: - Java - Difficulty-Beginner --- ## Intent Dependency Injection is a software design pattern in which one or more dependencies (or services) are injected, or passed by reference, into a dependent object (or client) and are made part of the client's state. The pattern separates the creation of a client's dependencies from its own behavior, which allows program designs to be loosely coupled and to follow the inversion of control and single responsibility principles. ![alt text](./etc/dependency-injection.png "Dependency Injection") ## Applicability Use the Dependency Injection pattern when * when you need to remove knowledge of concrete implementation from object * to enable unit testing of classes in isolation using mock objects or stubs java-design-patterns-1.16.0/dependency-injection/etc/000077500000000000000000000000001312550536300225015ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/etc/dependency-injection.png000066400000000000000000000537351312550536300273220ustar00rootroot00000000000000PNG  IHDRnZWIDATx}l%}JO&/@ЪLozFGK]$*  P 5 R/ъKM$_P+BNRQ"Nbf $*E05QM,azD)f6_@BNRSD| 9J'vkW>]tK<)W* 䔎[ɄP)Z׻mWvjR 7;PEz+1=`wz rXwsuM&I f7 9%zSM0=0ˬg0L`@%XCD/V́+tj/#V4)%g >F{7)Bqǹ\UqUfiZf\9m6m"ݸEV:;L$ UPEf+'MI,H 2=:=NcvwMzqwV ^'HIz㛍PE>UdrJ$&jkzvӻ:9nmB]6V3J# BA|ȡ4VNЛzSY"ѧ'~kl,:cݞ<6I:PpٕӃz}⛍PTI }zP[2:j\Nբh7}Zw%B nF"6CNЛ*zSY"4N)=8vw, 4qιcC v"y1)E*j%))B݃ID)f6_@BNRSD| 9JLMbf $*E05QM,azD)f6_@BNRSD| 9JLMbf $*E-M˯l^zb}Lkj͡$av|s *2CO4wub&-_r Zp)Q69go)gL{訴\JtZRLZ lZpeveڗsV~IUoNG`$7]0+4CNiUd܊ Z.Z *S3C {=]x<^#=yYP_UܕjEcӓF'{*6=Ι0Ng30=ٙRBCf\aRV i2Jl-LʬQ"M˯l䉻Nwyr|Q`z:1Laz D`?i bgY*;:;O“bYN|s2<=Ǜ}y-ʊ!?uSGPlY%LLϵGV7b6p_}zn{}K\m̄f> ʬݭK΅L`ع?!tb> <::XzI8O*vsݎzRC}Dkdܘ,fo^f(c,)DdJyf̛(I!?uSi]π]_m9ڥ׃(S=_SOl(8e(HgҾ=ncߜȣ9~mKmpDlmrc5Z;,v ߤ=p+[^M+$_#G' <>JfW(Ҏc$:Q&]⛓~(ID7Q{_q1hc SBƟ 7l2dE~I e42=bS{N^{;w .Yxߥ^vKޟ\T9޵n$툊2sOUI1lGNNczE5$"ON,Gc#Rr4pC85[q Q.9NIHtk%]N pՈ>v0a)JD[%9ʬQ"wX?_~U-N}[OOv?ޥI F+ίĩ-4ݗVzC[Jj)ŲK"!1Rl58b/Pჽ C:giSrt'J 2lJp1&F3e(HÏuّ}[8?G>7r-~gGP5Wa[O*LO@58IX ]E=m 5=)!^RfŐ)ڰW۫5KɑbşYʬQ"Ľu᝗}`OXy_<&O7qr0ډ[ .a= Onb_o'c^5&$b3->m"Ol-3`&g4Srɴ༽w~-Đ)"=ڎmmyhwşYʬQ"čӳы޳~滟:|ߩ/-Kｒ>NCy1>\!;˭̞ kH̲}9;.T*RJ"_Fӓ SLuBe8#I:2xpt/ 9(9ɫSWZ$]m{XI #(e2=.>刺LkĎ'$_YC_wk~e]F ҿ]}=xoD("$R5oIs=VX^w8IBoN.1Gd^bO3$"n]^)*s2/LRfAjekR*X!R2 T09F#' jizziL)0=f,azD)fr"L(& H T0=`j3/X !'P)􀩉Rl"`@&J1r"L(& H T0=`j3/X !'P)hެŽ\t0(oa4H 9UGM0=h͡3;o_ 9-0=b[yLoICE^6+gy03i`{\g`u{Α“?ִ:3C͎/TDj7X E0wCJD`G_YJsBC+I Jo!uJԧ8I f2BNЛlyelmO%N +9@n'ÞUM(z Ux!'Ma68VBOEkΑYPUϭlT٢) 2BNЛlh[tڞv춽O5O5=:ބB5^F zS6=.] Tjj@uaD6F4j}W M)}zz Ux!'M]6|b-)KasboY]m8 /TQ_9AoMeA`8=FD| 9JLMbf $*E05QM,azD)f6_@BNRSD| 9JLMbf $*EM[Zz%H @P E@Mlh"`@X EQ(& H T0=`j3/X !'P)􀩉Rl"`@A745f (tdSG7rbGu3/X !'P)􀩉Rl"`@h_7Os/Ԥ$_~BNR45X~-~Yͦ$*rQIW`jTA/X/!'P)jzڜWƺwۭNkT/~Y)"m kw[v5MRlnuzI~aDMёmRIw{O9`sΔ@]/Ks\O%)B[ɑC"Ǥם 65*Bd.> ܶwBSJ_тTU'ΧM.]@cS%B"*(HdMG߼:1Τk?sQ\g=lIZ*[%I"rzOS`K2 Mm|y{ESUcDVN5RH)럸η_2ӁkC)A#'w{ `I=C1gҙ[K߆~&+\w$U;ճuT 2d rDfы?XhvjUTMuRw]+o=w FV:*obu*'zj cunGp8dU EH6=sWe,Ť%t`Oz`.w8eb.>SbzF99dx $IE:7+ȊGSM.] Sy5;Cb' $TA#HMϛizӇӿR 8p]-E*w%@JON&zP^}f~pICK`nX,)\ٍ&R Dr]##M7t' pWQ3h RAlz7>>s;-A_Z٘:}B`S: _ 0ӓBay.i:\ `{TH+I+|d7oI5Yh*TեBoz2Hb9Դ G"$'G]8rjS p4lxl"kz5=sO5=SA bR>D-i5=1A G&E lu/E&FV1 obu*'ՎquB{l3hOTAj"H:2{އnZyȡgiokd4aUsVxt0m ?غOƦ鑓ۜ^p')n{;`gFjR o-\da]ȊGSM.Mky(oM`gў&AN~~ס9ڙܯlws9{}J+szvw}QV~~~vIYIJ5=!$\H5!L8~!֤@ތT] ǟLk7T|KO9 Cl(:/JaCM{BzR̲^ 0NO%p*M^'Yeް(Sل LOI\nԈ̥Q3ӓ!͎\BN,0=eџ)G5O饘v'uܛ_թ賵X]ل Gu3/X !'P)􀩉Rl"`@&J1r"L(& H T0=`j3/X !'P)ɌbW+y;5q?e&?FR,;\z5;r"Le룰Qs*?sb/,45kv|+&9)EMK#k8>r5=wlǕ~vF|͎oń '؝(=if͐ҙKe0,Tb' 6YSaf̚<}nS4=W|?_=QZ9yW)4L׋2enY4Lߧ[NkVL rR5 R)ܱw_s&4x&svfncMo|5Ȓ3 g5L4"I]6q_Z35QnkVL rRZS_cc_f܊lؖ|򼎷ء$9nq̚@GS̹8{ڇ^8ta/ nƔ>U^y/4 F|͎oń 'ys|?n\uUtڪt¤(0=@ XZZ QYqo6 '&&>\T$a\I 4P`zA];HAIRSrilM싋u.`zAϔL\Y4re1Iwsss||HG`~~b}}]Bl Yvc@OÆj@n}azzOA/߽{IW݃hhT SBN,--ҴѼ}Ȉj=#i 貓Am+:',ʅHz4jHI(0=@ugTÝzܬ,='Nn)jL>]c|ǁLP8`zА>#D#L.o[UWLPjTƆw_;w_+$!Se%TS,ʊ yبG3gU51jrxLP:0WcdgQ:iy9pА{:xJG3eR 9\Zu{e6nݴ `zrah2P4rn镲z4S۪̬_5SGu*LP.\<!,(OW]nOӣyp&Ù6۹}M |MVVV^T3gΌ6Vb@.V|^ނVl(rHq#tMv;HzMf(MPCy^״FN'ɞW?xP[=8c9VWW)F#{N'9QxE\ֺ~M( MtBT:>>6>;j8p΂C\VfMu2uI+L<ϛ[knu۽v[P$6s?gak40=@Yh(iLLL,..p`6E% jmWvvg3~<Ը&ɕ=W&&pRC0=0=@)hȤiM|r $Vc"+JѼ־UX=&x5䯛]\I'Ih&`zAmttㆅ@w+k5"ɼZݷ.Ғe *B2D<YCY|Mf(0 |kqqIé:8XڐEn%5v=??/,벙UI,zZ?e_5`4p Z4ɤ|Sݮgo*y}wΜ9f$ze=eHj]H6W[קk40=@hh2$4Јc :^z)=s6ۨi17lv޽ P `z"I'AEy~m{Ś~vy8w"]~u;«4#7l2:䄴.766 ZI Ĵr͍C/> @½77tk,RFKNL;;Ｓ޳gϞ@@ &ق^=|jj_MOvWt|0=@1h*xX޽[)E)ke$YM2Hy+FBjKLP *{ʁ?Bpl ESdȒ1y1Pr,臷m}}?`z{@?B]<@~ddD)ay{E;h&4#z#sK3&}*k*MOy&ԣY&NyD՜Fŵ*?89!#;?NNNb6@%3uN@5asssdd$:0O|;jzp7 .ܐ&%e$g3L t"3JPqc2jllEQ n|$= ێhִ/-=j= /*LTT#yR]HY._rBIzhh(oX۷ף!][J^s?P `zhHsv:D&=/)þekxW^/搿'G=PTI'ۻyxxXʉUk&u C"';R^u&[Cz衇`I{Ɔ=#]vdF#,vo~z:33s62ɻfʇj:V<|mZ϶ h P _ ^x_\/ }"yAͮf\}]ۿo~+>t گ La1:[-dE.5gw_Q6d$=PJ"? AU%i0 l'DIQĶ{wF|'L hz,2j~ )*ȻtڢGA|'L hpy@RT!@OLLĸ{ yW_ Z2-\kOlMGio+$V@ b\5+*^zI=dboh>U[+&4=ŪߧrR@dZlgzkn+BoUx=4Z׻mdZl&A^$+kz:1Jܺ"zu<6w5lIݿhՈr6V@ AR\u$l<3 6}ެnwް]g[7gR˯mSݘ{Py$W&r<}׋RfVUy^ɜ$we(g#L hpI)ܹ BYiN$Zf*vĘ9//m7ǭoGKK>3'~^bq<6B={o6(3+pW2LP6 %EQ3Ab' M lߛ~^Tuw<ݧhrĖx=E7Q$.l~5=k<2HWpz6ܽqXḮ(rP^E`dG(G"T!ټ߉^m["Z-\(Q  i^g۳pN2=r'\M;^GFg~~d9:::22RZ|VUpf5IuNJZbb{:~La v mH0JkH̷ W-񬯯|_&g3;;ۂ]0>>N333ɒ ٳgKo6֤ {3QfYy\I%8zvwɎ qP|=O[&ULChddMY\\YP7J"sȿU9azy@+@hx W Iy1!p!)_ Z @[NlŠnoll}IĆ*N@ P VWW>zhvbC|'L h(Νnf ىMܸu.BAV.ly_OO=_tꏅj-\e'ſ{g+G^3'iԞi*3="y߸6iVGAmZ Cc[JM_{=ߵI˴31pzBg[΍7=xu{>+O|ǽ=C}' !fP[ISG@ P$U^R$gs:u&-Z`>2bp:0= ˯l'>y?z.ttm˦Cagl azy@+@hf WIIg W?{ {3/{)mcolͩdeNgN}Z"az2ڇfnx#_6p_}W4-I@ P$URR\9[7LuoK} W~3\#b%A5`C6Ncz'ɹ_tr'LOjYWubOlq'zz.M6<ԁnnab'lh_OX;z-\%%Opro^]^%:WҲmz>1?%N3=zz0v9~VCVF~ѻ.;2{ѵϿ0o\׽[[Ѿw"bw{>Q+,>|zepK/q⯦|tߟ}>ɵeZCڣ̋Vt^vnhNO؄-+yVn䉅w蟿)mV*tl? VgDG8zWp'x}'>=x/>}>N=z܊N`B̗c[ы޳~滟:|ߩ/-Kｒ>~%RE焛I检5 yzz%L h(Mk*/)~o?g>}kUѧn~3"l pY!hBGBI{Z~K˴x=­T!7 sЄd֨ @;@+@)hT WI;Oݱ˧hM0Y45coe/z=S[́W֋˯l~-^K?Խ=ڪ %CֳVhE2`. ^2azy@+@)hT WI^ك߿uꯧ&=M̽eR|ܹsCCCuEE@R4;!ݻwzϢ )_ Zʁ>*hvbC|'L h( ;;;uE@R4;!p!)_ ZJDCZNl%!-\Hf'6WqVrф.$El ]-[eZEZM=U h(Mh )azDIJMwc?CY憉}qiT$ŸZkSvY @;@+@0Ф\b0p/~ }iD`,$kJҞ[|jR3+ @;@+@0bbpϼ^j88\-j+r- {VOV hh(ƷpLlՙ+E;:+`oi5U"MҞz+\36}viuU.kztH{曞p54nf>Քm⌨PKO+$L hfpҧiOĦ[1яuvpXus۾euNgz;ŸjZ*-\հ f!L hp!)_ Z*-\Hf'6WqV0>>YY$E8azy@+@uX\\,ى U0=<:={v׮]uE@R4;!T #[NlCCoi T6T #[+@S6[.$E8azy@+@0 IĆ*N@ P5kBR4;!T ZNl賥8БLP kBR BM hp!)_ Zja-\Hf'6WqVz`R ى-M|wSܿ~Vz`R LىM>smw~-~B@ PLj1;5=WnM L h ƴpز6EvvӫbnwukcZ1=goԧz~^5мſPc dzVy.=MOyY玍o^xENB_ԑY%]T=]AK%L h###gΜ,"MR,O8| 2=W|?_=QZ1[L](+v){m 4 9wJ@ltJ VńubBg)bd3?S`XNJl6+|Ni ll6zDv3Wtbzn^ybc/lp0a.k= G2^f6iwpS}J"L hgΜ,"_R &6'S}a0K+9>s;-A_Z8T%_+/]_;Pc[ Zr'E)SW q2Ym|N=˃I)g.?vgZ-\2M+9qw% thpj-'$Nvp|Xg[ Ț{}覕zf_X>m߰[>=`Z-\"4/oz݃]\%3_74DyoтpooYNYcX-YV{ Wޤ(z{Ϭ|4rygə/X?bNsͩёh2~¥cR.G 4 n3)j`z FfW0=<@ h¥iR+"V%u ى U0=<@…hvbC|'L hPp!)_ ZT-\CCoi%.r]mL hPpCӓndzx:pGHf(E@ m  4`xc,zX(}[cONN^r%玍۴ OE@eLCq/azVk׮g}!gNfvvv8-G7|//ǘ+|կ{(-пDӌti=%wV4#i,xVdgg.XSϔsŞ`oS{\oT':9|`x< t?݌g @-PZ\\,cAr09 r6ЖַwommLk3Olwy̜ext" pߒͧU aeǟT4lv*8e Z&0333KKK?$WD/{ڇ^8ta/hT҄6);{CLn$IXa/M eo 4Buu>џ< d(paggvmΝ;9큫o||wZҿME' W=gPOBEܹ'hzBݟ# 'c d(p"'xbӳ}ȳ GN-j._܍m7yjzz};Ҳ=vȚp>JheLʚk%stZZRSu=ppcvwә:2Gc^QӓO@GlpxxIv3+ %Z{n{lC.Xgo k2f}̫Oݝ{{7IhPhJ[#r<}'LAzY8=|V. ={bO_OJE'L hPh :ٝiOT^Ϟx(Pٳv.0=<@Q (^otttbb":=rkkzC@ (IȞ_BiʞxӇQ0=<@] 1dKdL-\@ZK]__/jCCoi TT p9p]VWW>"믿,j͝;w L4$2 Ieees).__DjW~- ?`z.  ,--!#wI^xaR(o@퍍O 0=@ =#>у/Stzff^&CW⾺j*L:wvv> @!P£~{`ϥ%=zuQ s3::DT2Κ$J|jٰNv.4BZϨ~P'&&B+B-..!=lnnrbvTGףPY5cccXެ91(>Z6PEHVYhj2lnNYhM!C,neM x-\̈́=rChS!խĉchp5 '''XYe$XpAׇ$n'@!VnNMW_))~Hh2* SB?c=V)zh2fR7^kkkUE:m3_ȏn~pVN=-hOJiP!@V˘HLdKShөXYy[a`k5tY%miH2'q܎N*5V΀qJl.`Wp;B0E1 ^Չg 5Q uE%.c[x6}AMO>:::99gBcb!D&40=@C- ŵ u2uI+ŸyVyP":\m})'5S<  - -nɵ"ܕ•MX9Xbuu.)|L߲D~/}0?L]3X"ܕ lQgϞ3::jf2@GUHB)ӣȘS7t> 3AV|:`z$Klkq6!O`+]Gf ;xyXϟkÙ3g0IHL-v,eCԻ3+0=EXydd+g]+jT6Ξ=!0=~"xo35Ch3"`k׮ *vg8XYYVI TT azA0RlV>p*2.(.] L%-\@yln2`z- 7Ux'P`hX@v`f.V0r@5" L+B-\Hk<# z 4"…^>XyddXP,QtBh0yqqqvv2 ʻve`bbfC670=N1*;kkk CXv GY` a[(:y$fggѯ/]AОG {Hl60=|…VlVRoTTF l0`z]a_> I^7>>+Ku l*`zakvϞ=VEû*<C6 @oP"袋E"Μ9cy$*y4l60=tE*>###:Daz!H+K"G+C$0F?e+ p@GX"10=لHV+C$40=PBx`ef#]hҵ @lR<ڞkzEgUK5we`e40=eT0=L3=n-2//B3ER R(<ܨoN+vq=-[@3kI)fPty4c[-*7Lnw 6ћVT((9IJ9r niETfRȠȹ[% T RZfh#HtHy!zR;PdJ)KBoi]ETA, HHTXQcC -mҗܝD=H/R$L1Y?](az)(S|ak~=M~j25=Ќ1\?΂,-@EGwQֵzr3٥pQ7&@ }z &4>=JD\SſՃ_,`n^)q^xNh뭷=.w'l!m]"4S.M 'L z#pe%qιz v"t#D@?*T-@fG&I C40=PB$-0lR@y <~@ H.D&L GI C40=PB$-0lR@y <~@ HATu/N'G˴vY7 &-D#B?ل-=E*|㶻NڤK]AjW;9?V1cjjR-H"JݬzB?12Y= QxG~4@ܢ4D0= wޅ>qş|>=Os᝗E$MgS-H) 0=O|!pJ)(Yr}fY/::^$8Th {b݃g<*O5.D *Ħ'7錱6_N/X1{Ձ˰EX0=`ygiU~kя_m?o|[ . 9[Ir;Xpvha/Ge 8_9_>%t"Ia~>|W 8%0~Oׅndq3\lB5oymi %~6ף+H0=`ytɡ+F?g!{|?H ,{/;r% ^hz≹s@R: }˽#ƐYwK9GC&)s\J'qfPT-<:bu#1=OY ).,* zr"N{Ij")Re9 hEpʻN,Gt/'|≭'{d@t: }?0@t$ 9J4~AM>%t"{z JՎT&I.yiLS~ ZeR\.WKI,Dq%mzR8L D njJ:2')%4*c˿4~NQS$܋(^C]"d%'C9\ *}zooɈY, aRpΩ[\b;2תp@oT*t.>刺Lk"4#2Wz[29w+Č}8HbuUr >a?a*~ Ap I`z/!&@ƦPUPQɯDaz!Ziq>pOg9-No{{ȖbIoHA40=D飧LZF~@ Hȫ5#M@ (t!h6az)<҅HZ`B?لH"iyf#]!M@ (t!h6az)<҅HZ`B?لqy4כƅ;D*F$" Ͱ~TdY8az)P5@* KGi6OB7I7ƙaZ,solӒ<t=.ӞƟ,8fSkM{n&c6Z$ 2!HE Hu۵qKX{IvTy1>;םJ+K+ȧ)2E#4(ER]R<Ըzw&{sZI^>NEgN./lɰgz&&-hQ„Pq"7|-./[ =n+?6V$ 2!H Htdm,$:oicE@?*T0=uV/hx|+,}zK+hQPmy$CLyldV0׉N-u݇6Oaz&4(ERQR0<2HZ`B?لH"iyf#]!M@ (t!h6az)<҅HZ`B?لH"iyf[ZHA$@f@?`C&lIA4-2@y <~@ H.D&L GI C40=P#*`6БB a'u0lP.D&L GI C40=ҔGܻ{__ěFMD(lR/v$Z#PěF-D,lRH[1__卢FI "Qh6az)Pmϵz̿;nvvK:wXc::W|d%-NăDz CGW&YQ&Ezk;l< <w u݊i/-Zs~s2T0ݙ 3W]p[g6B GsW^"?.x=f/ZaOT*"u1+Esaz!DћizӇӿ2 l&n ߮e0MrXڒ+ӱ|N"$ "ͫ=FWOI,f2J^$TlQuF c,YzW8L |;2G_a}I'ļfSo;mRZot3{nYYm.[C~+`ON^ java-design-patterns-1.16.0/dependency-injection/etc/dependency-injection.urm.puml000066400000000000000000000020431312550536300302770ustar00rootroot00000000000000@startuml package com.iluwatar.dependency.injection { class AdvancedWizard { - tobacco : Tobacco + AdvancedWizard(tobacco : Tobacco) + smoke() } class App { + App() + main(args : String[]) {static} } class GuiceWizard { - tobacco : Tobacco + GuiceWizard(tobacco : Tobacco) + smoke() } class OldTobyTobacco { + OldTobyTobacco() } class RivendellTobacco { + RivendellTobacco() } class SecondBreakfastTobacco { + SecondBreakfastTobacco() } class SimpleWizard { - tobacco : OldTobyTobacco + SimpleWizard() + smoke() } abstract class Tobacco { - LOGGER : Logger {static} + Tobacco() + smoke(wizard : Wizard) } interface Wizard { + smoke() {abstract} } } SimpleWizard --> "-tobacco" OldTobyTobacco AdvancedWizard --> "-tobacco" Tobacco GuiceWizard --> "-tobacco" Tobacco AdvancedWizard ..|> Wizard GuiceWizard ..|> Wizard OldTobyTobacco --|> Tobacco RivendellTobacco --|> Tobacco SecondBreakfastTobacco --|> Tobacco SimpleWizard ..|> Wizard @endumljava-design-patterns-1.16.0/dependency-injection/pom.xml000066400000000000000000000037761312550536300232600ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 dependency-injection junit junit test org.mockito mockito-core test com.google.inject guice java-design-patterns-1.16.0/dependency-injection/src/000077500000000000000000000000001312550536300225155ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/000077500000000000000000000000001312550536300234415ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/000077500000000000000000000000001312550536300243625ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/000077500000000000000000000000001312550536300251405ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300267705ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/000077500000000000000000000000001312550536300311065ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/000077500000000000000000000000001312550536300330705ustar00rootroot00000000000000AdvancedSorceress.java000066400000000000000000000053141312550536300372550ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * The MIT License * Copyright (c) 2014-2017 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /** * AdvancedSorceress implements inversion of control. It depends on abstraction that can be injected * through its setter. */ public class AdvancedSorceress implements Wizard { private Tobacco tobacco; public void setTobacco(Tobacco tobacco) { this.tobacco = tobacco; } @Override public void smoke() { tobacco.smoke(this); } } AdvancedWizard.java000066400000000000000000000030161312550536300365420ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * * AdvancedWizard implements inversion of control. It depends on abstraction that can be injected * through its constructor. * */ public class AdvancedWizard implements Wizard { private Tobacco tobacco; public AdvancedWizard(Tobacco tobacco) { this.tobacco = tobacco; } @Override public void smoke() { tobacco.smoke(this); } } App.java000066400000000000000000000064201312550536300343760ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import com.google.inject.Guice; import com.google.inject.Injector; /** * Dependency Injection pattern deals with how objects handle their dependencies. The pattern * implements so called inversion of control principle. Inversion of control has two specific rules: * - High-level modules should not depend on low-level modules. Both should depend on abstractions. * - Abstractions should not depend on details. Details should depend on abstractions. *

* In this example we show you three different wizards. The first one ({@link SimpleWizard}) is a * naive implementation violating the inversion of control principle. It depends directly on a * concrete implementation which cannot be changed. *

* The second and third wizards({@link AdvancedWizard} and {@link AdvancedSorceress}) are more flexible. * They do not depend on any concrete implementation but abstraction. They utilizes Dependency Injection * pattern allowing their {@link Tobacco} dependency to be injected through constructor ({@link AdvancedWizard}) * or setter ({@link AdvancedSorceress}). This way, handling the dependency is no longer the wizard's * responsibility. It is resolved outside the wizard class. *

* The fourth example takes the pattern a step further. It uses Guice framework for Dependency * Injection. {@link TobaccoModule} binds a concrete implementation to abstraction. Injector is then * used to create {@link GuiceWizard} object with correct dependencies. */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { SimpleWizard simpleWizard = new SimpleWizard(); simpleWizard.smoke(); AdvancedWizard advancedWizard = new AdvancedWizard(new SecondBreakfastTobacco()); advancedWizard.smoke(); AdvancedSorceress advancedSorceress = new AdvancedSorceress(); advancedSorceress.setTobacco(new SecondBreakfastTobacco()); advancedSorceress.smoke(); Injector injector = Guice.createInjector(new TobaccoModule()); GuiceWizard guiceWizard = injector.getInstance(GuiceWizard.class); guiceWizard.smoke(); } } GuiceWizard.java000066400000000000000000000030561312550536300360750ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import javax.inject.Inject; /** * * GuiceWizard implements inversion of control. Its dependencies are injected through its * constructor by Guice framework. * */ public class GuiceWizard implements Wizard { private Tobacco tobacco; @Inject public GuiceWizard(Tobacco tobacco) { this.tobacco = tobacco; } @Override public void smoke() { tobacco.smoke(this); } } OldTobyTobacco.java000066400000000000000000000024361312550536300365300ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * * OldTobyTobacco concrete {@link Tobacco} implementation * */ public class OldTobyTobacco extends Tobacco { } RivendellTobacco.java000066400000000000000000000024421312550536300370750ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * * RivendellTobacco concrete {@link Tobacco} implementation * */ public class RivendellTobacco extends Tobacco { } SecondBreakfastTobacco.java000066400000000000000000000024561312550536300402140ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * * SecondBreakfastTobacco concrete {@link Tobacco} implementation * */ public class SecondBreakfastTobacco extends Tobacco { } SimpleWizard.java000066400000000000000000000027151312550536300362730ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * * Naive Wizard implementation violating the inversion of control principle. It should depend on * abstraction instead. * */ public class SimpleWizard implements Wizard { private OldTobyTobacco tobacco = new OldTobyTobacco(); public void smoke() { tobacco.smoke(this); } } Tobacco.java000066400000000000000000000030171312550536300352270ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Tobacco abstraction * */ public abstract class Tobacco { private static final Logger LOGGER = LoggerFactory.getLogger(Tobacco.class); public void smoke(Wizard wizard) { LOGGER.info("{} smoking {}", wizard.getClass().getSimpleName(), this.getClass().getSimpleName()); } } TobaccoModule.java000066400000000000000000000027051312550536300364000ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import com.google.inject.AbstractModule; /** * * Guice module for binding certain concrete {@link Tobacco} implementation. * */ public class TobaccoModule extends AbstractModule { @Override protected void configure() { bind(Tobacco.class).to(RivendellTobacco.class); } } Wizard.java000066400000000000000000000023661312550536300351230ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/main/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; /** * * Wizard interface * */ public interface Wizard { void smoke(); } java-design-patterns-1.16.0/dependency-injection/src/test/000077500000000000000000000000001312550536300234745ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/000077500000000000000000000000001312550536300244155ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/000077500000000000000000000000001312550536300251735ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300270235ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/000077500000000000000000000000001312550536300311415ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/000077500000000000000000000000001312550536300331235ustar00rootroot00000000000000AdvancedSorceressTest.java000066400000000000000000000050421312550536300401460ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import com.iluwatar.dependency.injection.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 28/04/17 - 7:40 AM * * @author Stanislav Kapinus */ public class AdvancedSorceressTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Tobacco.class); } @After public void tearDown() { appender.stop(); } /** * Test if the {@link AdvancedSorceress} smokes whatever instance of {@link Tobacco} is passed to her * through the setter's parameter */ @Test public void testSmokeEveryThing() throws Exception { final Tobacco[] tobaccos = { new OldTobyTobacco(), new RivendellTobacco(), new SecondBreakfastTobacco() }; for (final Tobacco tobacco : tobaccos) { final AdvancedSorceress advancedSorceress = new AdvancedSorceress(); advancedSorceress.setTobacco(tobacco); advancedSorceress.smoke(); // Verify if the sorceress is smoking the correct tobacco ... assertEquals("AdvancedSorceress smoking " + tobacco.getClass().getSimpleName(), appender.getLastMessage()); } // ... and nothing else is happening. assertEquals(tobaccos.length, appender.getLogSize()); } } AdvancedWizardTest.java000066400000000000000000000046221312550536300374410ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import com.iluwatar.dependency.injection.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/10/15 - 8:40 PM * * @author Jeroen Meulemeester */ public class AdvancedWizardTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Tobacco.class); } @After public void tearDown() { appender.stop(); } /** * Test if the {@link AdvancedWizard} smokes whatever instance of {@link Tobacco} is passed to him * through the constructor parameter */ @Test public void testSmokeEveryThing() throws Exception { final Tobacco[] tobaccos = { new OldTobyTobacco(), new RivendellTobacco(), new SecondBreakfastTobacco() }; for (final Tobacco tobacco : tobaccos) { final AdvancedWizard advancedWizard = new AdvancedWizard(tobacco); advancedWizard.smoke(); // Verify if the wizard is smoking the correct tobacco ... assertEquals("AdvancedWizard smoking " + tobacco.getClass().getSimpleName(), appender.getLastMessage()); } // ... and nothing else is happening. assertEquals(tobaccos.length, appender.getLogSize()); } } AppTest.java000066400000000000000000000025111312550536300352660ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } GuiceWizardTest.java000066400000000000000000000072421312550536300367710ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import com.google.inject.AbstractModule; import com.google.inject.Guice; import com.google.inject.Injector; import com.iluwatar.dependency.injection.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/10/15 - 8:57 PM * * @author Jeroen Meulemeester */ public class GuiceWizardTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Tobacco.class); } @After public void tearDown() { appender.stop(); } /** * Test if the {@link GuiceWizard} smokes whatever instance of {@link Tobacco} is passed to him * through the constructor parameter */ @Test public void testSmokeEveryThingThroughConstructor() throws Exception { final Tobacco[] tobaccos = { new OldTobyTobacco(), new RivendellTobacco(), new SecondBreakfastTobacco() }; for (final Tobacco tobacco : tobaccos) { final GuiceWizard guiceWizard = new GuiceWizard(tobacco); guiceWizard.smoke(); // Verify if the wizard is smoking the correct tobacco ... assertEquals("GuiceWizard smoking " + tobacco.getClass().getSimpleName(), appender.getLastMessage()); } // ... and nothing else is happening. assertEquals(tobaccos.length, appender.getLogSize()); } /** * Test if the {@link GuiceWizard} smokes whatever instance of {@link Tobacco} is passed to him * through the Guice google inject framework */ @Test public void testSmokeEveryThingThroughInjectionFramework() throws Exception { @SuppressWarnings("unchecked") final Class[] tobaccos = new Class[]{ OldTobyTobacco.class, RivendellTobacco.class, SecondBreakfastTobacco.class }; for (final Class tobaccoClass : tobaccos) { // Configure the tobacco in the injection framework ... final Injector injector = Guice.createInjector(new AbstractModule() { @Override protected void configure() { bind(Tobacco.class).to(tobaccoClass); } }); // ... and create a new wizard with it final GuiceWizard guiceWizard = injector.getInstance(GuiceWizard.class); guiceWizard.smoke(); // Verify if the wizard is smoking the correct tobacco ... assertEquals("GuiceWizard smoking " + tobaccoClass.getSimpleName(), appender.getLastMessage()); } // ... and nothing else is happening. assertEquals(tobaccos.length, appender.getLogSize()); } } SimpleWizardTest.java000066400000000000000000000037721312550536300371720ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection; import com.iluwatar.dependency.injection.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/10/15 - 8:26 PM * * @author Jeroen Meulemeester */ public class SimpleWizardTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Tobacco.class); } @After public void tearDown() { appender.stop(); } /** * Test if the {@link SimpleWizard} does the only thing it can do: Smoke it's {@link * OldTobyTobacco} */ @Test public void testSmoke() { final SimpleWizard simpleWizard = new SimpleWizard(); simpleWizard.smoke(); assertEquals("SimpleWizard smoking OldTobyTobacco", appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } utils/000077500000000000000000000000001312550536300342045ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injectionInMemoryAppender.java000066400000000000000000000036361312550536300402750ustar00rootroot00000000000000java-design-patterns-1.16.0/dependency-injection/src/test/java/com/iluwatar/dependency/injection/utils/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dependency.injection.utils; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; /** * InMemory Log Appender Util. */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } public int getLogSize() { return log.size(); } } java-design-patterns-1.16.0/double-checked-locking/000077500000000000000000000000001312550536300221125ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/README.md000066400000000000000000000021711312550536300233720ustar00rootroot00000000000000--- layout: pattern title: Double Checked Locking folder: double-checked-locking permalink: /patterns/double-checked-locking/ pumlid: TSdH4SCW203GLTe1bFzkGv1J6qGFeLc_MI1_x-wzkv94uJ1vDVUrFm26LwxTMnonsMYgitgcEQ1BNEXeyCKVfiAxLqqBtTbqmy1z0ygCGpXHOpgv99bqTgt0JW-LmqPUCUGF categories: Concurrency tags: - Java - Difficulty-Beginner - Idiom --- ## Intent Reduce the overhead of acquiring a lock by first testing the locking criterion (the "lock hint") without actually acquiring the lock. Only if the locking criterion check indicates that locking is required does the actual locking logic proceed. ![alt text](./etc/double_checked_locking_1.png "Double Checked Locking") ## Applicability Use the Double Checked Locking pattern when * there is a concurrent access in object creation, e.g. singleton, where you want to create single instance of the same class and checking if it's null or not maybe not be enough when there are two or more threads that checks if instance is null or not. * there is a concurrent access on a method where method's behaviour changes according to the some constraints and these constraint change within this method. java-design-patterns-1.16.0/double-checked-locking/etc/000077500000000000000000000000001312550536300226655ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/etc/double-checked-locking.png000066400000000000000000000155431312550536300276650ustar00rootroot00000000000000PNG  IHDR8NQ{*IDATx]ŵGDc V FȖ/2'b vklN!q5H A8wUBŏsOUޚꩮ8U`.`#j .Ui1<߿ Ag A.ȃAn4z-L[cYg5H zcSvKUc.yg>` f;-݅Hݞ\O@w[ŶI@x+JeóޑHM [smG:ee1^\*fǻb8H(zǓ#-1,MlU[LmYfg/BwyB{#%Z5}S!Umy3i|s$_fo{l"]7,*r(f{^1(%kGX|i"X϶ ^{PE.mCæ֔+0Iߪ$۲P l"mQ~[;Kf1ξI6blD yА An 7y<ȍ@F rƒwKz׋x~ŲHq~TPf{Ec{jer [->] $O]wL<ɷ?];KGwi >:a)MVMvmṾlo4 wщM_80ig k9=Oɋ8zE Ax'3)7O !aMlX)]5U3nWWv|[H,,=WLY6uW!GūV0* CiY '(aZy>u}Y t<ːLv;ši֛Цg>j\_ǁ~flN^N%x%ɷ$۵7<.ٱj ={@|skZ9y}7pta /Μ'(u7-;W}xK,e"cw9y)].@-:?fM^f[nۿ/>mw۞P%j'W3ōr^A 7y<ȍ@F r#I{ OLCQ g{ e9?Q5sWWk灼WZőxt0#|#f_,YLFE`c)6b&W1 3EPk#Rӑrۄa\ͼǩ^d7 Njm;% V$a BXTLcD246" EI2U3f&hg?*Lmѐ0!WM8K/ĦT܊<3ӱ L2]g#/>VR<>ǎmTGh9p>Fhd] 5+ک;-LQ yD-\^y6YlcE&qYچ)47s_v^4yN|^pۅ4.6SHZ%}^/1lr“L&PHǙ}-So 7E#yIO|sʽSt\kmX>ϴ/ Q>/kR[5ȳÞ4-p٬U'PZj@m*t& <*!<qW r#ȃAnēw _h`U` >rZ[ȉ@F r#ȃܨ _C5" &uHǑZբ)1uECTn_Ce0mpQ˺J]"E S{F=ioYyC&ޕ J{q>2AC09HҪW8gyjv4KLjfMQV\8XmSpҗִ;I>ȋU}2}0鉤0mӴ!$ucFlP7RR{Y}/A}zn?&{%2)}Xh)/Z=[.\@|gbEQkL-]Wԙw2nKi O퐬u7dG4lϚ*Um^Ҹ϶aU@MaSC b8UCɃ^ r#ȃAnT3)@ٷtE& .ȃܨX>uUJFKFY2bوvhΆT 納ϋ褠X> ]̐ LU$sÆ~ a\?K^E*b$^jlUJmmI,ʧf_PeJM+l+EAn 7y<ȍ@F r#<0 F-<ȍʓ׿/M~~?>P]T^/`nby}h0s_%;9U"'Y*PmE XeH}yc_yOqSw.X`0ѺS ^_xP,M ?d3d͗+y[_'N{$aS$J٤:L3Μ/|}nW{{. #~D)[T$.gb $;<:V:6_OHej&UY+@s{W~hͩSNE-K9žXWr?a|=t~z,O5O&+fbG}}USg~U L+/d&kRl;x5:VEc}"ϫ@M&,|èB %/lr:g405U L}Xkl@5y9T>&^`@^:y\L2wab83' C-0Uw0^<$߰(y_1.Y?*ծybJwjIQ&fM^vrb jj/gLC8+-m.֎0CYzVGML2i}^j+VGϕKٳ:R3c^ikV>AdGkAĴ` 1 #X劽϶Qguȫ !g Qʥp!g Qx*p{RO4y<ȍx0 jgbqׇPcyŭ+n8w 1]qye 箸2sW@^ù+n 7Wp+c8w 1]qyeYn%X{yenQ[z]d^a3Wt-zth^ɎgVP!5$WQ]tood`C#@$h`Ȭ B6.IY'԰Mb~/l ”#^n0ˑ7V{5l1YYק- +c'Olgmp 5"[4h }mk(yQ϶yު55MFjw1]qye 箸2sW@^ù+n {OJHk]T] 尉'%O.r'|r7n/&Otݡ@^>n/&|F^@^1y-v{ypx +b6W'ȃ+l W'ȃ+l yKM c y->U=An 7yy XoeF֙pG +X+)?l%;jC)<1 0 ۓ 5Qț&+JJD*yKzGj"9H61l͵:w-xmpQze E6ϣyROڎİ61VVm3em! O )6hE[LM,ӇT%_Ϥ͙Gp~zZek2KF7d*aP!G0s,yȈD)Y;JKq7JMӀ*riX+ljMytJB-[1&ٶJwo\ifSdC!϶MȐ @F r#ȃAn 7ywc[zqϯ]}pX)ΏyvϿ({wOma l"]|7 %;w~.wݴm J?=*K ϓhR{fne{o̤|٥䝊&Us_z yĦKA}/X}gK>e~ |mOv;8 <ٸnv㱋uӫǾOQ~׭طVĕo>y]VOXF{q # <{k7v\o⃷y kv╩(^H6J^*ym+9陹?_ǁ~flI-ȓBMvpɎU^wwgX[[#֒ y1U y@^"-;W}xK,e"cwYeE6@,'I4r ~.V%ȃAn 7y<ȍ@F r#I{ }LCQ { e9?Q5sWWk灼WZY]wGL/G:pYX=gƒ`c4b&W1 3%)_?Eڙw:Zn@K0fE]U)C y!ߢ$;2yZ+򒑊 ~"yS[[څꢤZDkS3kΤTڙ6!9`~Cq*2c_M?ygcƗ:djG^4d?|pyd}>tOkj)>/B9\fǃO9dmn&ې&ji_Nia)Ր7L"H̵I_GiZKőGmCŶ>FdGmRMS}3e5J;َ].Kb3ekQv)W!Ob#ttڟP d9,[S'mO(sr<:B)*B+lXf4S%ZGѤa!h1QCTf^1Qթy8,g!|3G; ih]m=cIWW4&/px]˸=S`>iZ9ȣs({"_@)M tuIyVeI"d,ǚ java-design-patterns-1.16.0/double-checked-locking/etc/double-checked-locking.urm.puml000066400000000000000000000007031312550536300306500ustar00rootroot00000000000000@startuml package com.iluwatar.doublechecked.locking { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Inventory { - LOGGER : Logger {static} - inventorySize : int - items : List - lock : Lock + Inventory(inventorySize : int) + addItem(item : Item) : boolean + getItems() : List } class Item { + Item() } } Inventory --> "-items" Item @endumljava-design-patterns-1.16.0/double-checked-locking/etc/double_checked_locking_1.png000066400000000000000000000272621312550536300302520ustar00rootroot00000000000000PNG  IHDRhr.yIDATx \M$"D"bHdRYRHb%YK([I"D% I4oƒ".Μsvz;{<}ssSA$]RoQDiVXA2*`B;D_-*f'Hi%1m( -D=;c ~͜?QB'Mr32~Wވ~rgDT:#ml:=}wi]A-0Ph&mD_L ܬYCGG[bdJۢ~U۵kN{z:HJ-p`-&yjJOfr>LLJ "*[C^^ȑ}kԨިQݠ90Bp"Rk&=D|ԩ ׯɔ%]h" r3썌ݷo7Rr7d-hjƍea׮ݻ&_vR;v.KI={E֬IDreHCYsŅrpQ11gyff&֮mL)̝; s]]mnʀppň(O|X|y*09H.I5` nk0%Bp .5DOڵk<53<|֭y^|*0lHD!f۶"ZOժ19k5:$pͰ0_ٜS6x\d%4l&8a?LrwEb\dBQAPA+O׽pa;iǹ6m%Q0`[Yu@ωL['aX3%*G>E=J455(ZS]?X;9 i9i9k5_==ol-VډGNsKE)FnITH݁𮥚ߠQT J DiS(mZZcO5?,` i:eQKр5oLH|>e@yoҬ6 s\ؓ~['iAPqêTQᲁ<8=$/|x&9+7Qصq~T全NZ:n<2j̍GHZ<<"WׯM۵kaVji?ėv1Nfdlsr hYFf /Gȩզreu&ɫI:uFm5d>~@n`33˖ya3::~6!nNn7gGDkCDY_BZCCvNN=իa`[ӇLL +VpV,ȵk:vli`PEMrsYjJVn8'lNJl6ܽG?QtmلmZENADrfl.]:i<92H.wn"?EʪH{,'Tfz]8jjo& Qѣk^J854Sߵ17Mʿv['Emcd%Dxنի]{,1ɦ6-X0?DsVS ޽xUI BqAD1b],9m+;HPxdb͛{W%I-q."zﾫ G'Dљ3~t@ ?\<(6q6c[>{YC:5Y1a/2]\I&F$΢pa;rի%bz]䣫ٳ= W8Vʛ7 Ġ|?6lAݻ7HlSET$~s+>Gh})Ry L$c Yu˖9LOiJ:2nLђQܕ֭e˼8>@6ҦQT JRNӧ۾}\ɋ֬(Ļwi$z0eBK5ϟOzz:ZYu@?Çt/]q\]mu&6.33'XB}K'ď֝=;5"QU~fm6#? ==[=~TjׁKaL q{sGĵk1aa˗{M0'ĿoǏ9/Sdx*F0E8ŹsQ{,ޛ7l_'㣲v ի# UfNJJt̘tǎ-9S qw0msD߾M#DÇ͜wb[AAAD7}v6̖!1 >~_v>MM-[W5y9@ffJG'$,ߵkanmYG"pO+>o־|r~ȑ@rj4a͛{^<_ P jiL|ɂ  ҥz]z,Ӄ\,kCsD޿}hYRNMէOo5n\MJD2gG4O5a5LV_ouD:{v 2zW9#ABWW{YeZ{1Pt(s xaG17oK}: k1D1$d0D\ډ}J>Q%J+km[YOXeZ'L8bŊpO8p`): _?M$~G-$&N-IΝ[1RVcsi'8JT]~?i ZM  z({==Zn"D?|H[Wi@x ccի&3<^(a"k$9^/T^ [7 p}! ,'6lX8B1 m8MKdkw7Aa Aut^J۔, HInZ[R"H(n"6sr%p_(Ct['*J'QT J DiS(m*MO/W$Ν0J&Ҧ%KT6/v5WָqN´G?ȑW6H DX!zVlڽvss2ש۷ kdX~U1 /Ė4ؽ;V8GOޓaRg*hZdo֔>܎q2E#. % 05o=MdDP,V5p"?s*) ;7CMdDP,Bה::<|&JEa#Gb;2DFa.kJu_#xTRDV7ylH H6e'*i* vŠ)Q \FQwRr`;1Qr܏*~H)Q:P$ɕ U33 _NNPuvLzɓ11Sүt-*M@6Ҧ4UbBghzzXvd2̕ YNܲeohQ~*D e!QQs[Я^* 9I2[Һu}}]k& 0nm}t{yD ʪP2,M6pwޫWGm0ffJ-%:/fd (.Q~=F? 0@ժ0lk&%9Pb oo۶ֱckR/LĂ*I3@Nz~}ǏXPJ$-ffu^_e v0|"qyff~'?"X3e @2bA)T<֩S3ñX+X36GHT0w'ΊqYp41hPL l0N'Ʒ D###;MFͷ D=<<;hhh'Vp']n;5k&Nȷ DCBB;+|||;ҥKMƷ Df̘ D-Z4k,N'pٳgmwB?QsmwB?y S%s  ~arķ D}}},Y· DMtRN':eʔ˗mwB?QooN'zjN':a„kmwB?QOOPN'O?mwB?ѣGoڴo+9r|[O-**o+>|۶m|[O ~C ~޽{7Vp'urrڻw/Vp'0`@ll,Vp'ׯ_\\Vp'ӧOBBVp';tVp'9|0Vp'իב#G;eJJ Vp'8~8Vp'|=wfy}$bff ~ѣGJO@*T8K׮]322$sݺukܸ={zÇao߾˗0OW\EbРA }IZZZ6mjԨMt钛۸q㴵Q>;;ʕ+7//oȑ(ߨQ ٳt933DջxO|||p,m]v'3ʊ^ ؾ};}ʔ)"*V wi۶αcDzÇv޽{nnիWq7ұcӧO3III={$[nj|o-[V"_bR*2nXXX.]^lۚATMM2uTfy]CA,gi߾ٳgpf)Ϸo⼬GA~wtׯ_Ws!\3fL !KtΜ9իWו{!9|ܹӧO'֭[; Oۼdϟ?l.^~"_ eT&zΝĂ.T(\Mm;Gɑ%ݻO™ᬲ/\lnܸŅTZ.).DUU I\ 1`'ieeb`y,VZ]|nL$ìMEn='W:>z >|/Y&ɡ[$*pSuuW^QLqjժeggQLT􏛪N88nMUTT1<DEm &Mķ!܉2VXA&Rb2OE_&*Y D%r/^݆Hٳ#㡏(~͜?QB'Mr32 D_:p`33Nt{NO&#]}Wo!J!zK(46/_Ln֬ŭ[r2FEmBz5'==w$%zx8rucd.4[9FF۷)9xpύgc45u}X!Zî] w7Mz5ZCCƍ=9>v\. &'{,Y33e ~NxF;iϏjjzSKK})k1FMCDYkطo >|H0 bb,D+L ];49RD1;w2(ܪ)=::Q$#z55Uar]DYk@7BGG ݬ` A1K@\9k&=D8ֻk8yr#kfx̭[!޽ʕU0halkٲ1C7&GͶmE!O2USMOcr1׆3DYk@t0Haa9NmY3)$J4+ki8Lp͛~.!J\dBQAPA+O׽pa;iǹ6m%飬5`ꀞO6fxӱfRKT5 }>zhjjQhz5vqvrAr1cӦ 0s,72~3DYk/3 zz:0 ٜorD(&>Rwr[ʿS%-R "u"#T J DiS(m*M ?FYܐFxߨ kgoؙDnR%?}ʀM ZN s\ؓ~['iAP߾MUz{+];QtY׏Jصq~T"坨#nH?G  }%amD]]m*WVfMW#''5kj4kpqݻqMF{ԯ_E Qھ? DL&)-VT~q{ODvNmqDr֝NB!=zb<Ǎ--.nQm9+W{ck]`oAs]t*oArL$Vd׮] Ϟ)V$H *GWccr{Ը9/'CtZ耽LI)a1##51Ӈ!ή蟙@J7#`3k:y1D98e% ӧ7wUٳ Q*us+>G(nnnT>r޼9^BF Dˣ DiS(m*M@6*11O}ٳݿ/Y3E *QD?~<]Z1^3@'==:AϟC`{Y@|2WWmݺɆ 3ĉ<0p,!oߒ "3 vHX[wzbdԈ$dcѣDgg~ڶm:E⿑l:RX c7oxtp@E##gkb|/0a 6?N255['O7_?rd_^TmB ?80== DQ9hq\Ԟ=E[l,飲v ի࣊i/Dnj0IwΝ :ePlswĝmsD߾M#DÇ͜wb[AAAD7}v6PO.GQE5))brS]'ׯSkQ5{DoEano.^+zm`b:dԃ.B S8PffzKtfbb"qJ4'琾6m m3in`@K$! wj =ane ew DE1Yڔ\E:c_{/rH؃.h"ZT J DiS(mZƈ *ªiQhS(m*M%/^Q *QW"zZCCzjժپ} 't޼Q;ռ ҥ`VFJ:GU&f?UT DٵhK~vs=iŋ{HqPֶsv> vzz:+WzCB۴1Q恮]%23U*L\K^^\Y*Ǐa߻FFp^H-f:HEy!j0a#݅VTc }[fXm6mh?NP۾}>qwC"+VLys.reԹz"ϟU<|x&JNHXFڵk]ݡC^w@!l=yiYZZꌓ%Y jjԩbWXo.p ƍ=L >D\u33#e"$vTk_cyrD(8-M}=}7$b/Ӻu`3g$H<r_2 _#I ETHft(qPK_tn"|ʺ)iAX YR(0?5#zHlXI̫ $@FY(zBTkxJRSS C/i_tdmgB7bHFAujY=JTӧɨ ô-TY"n4t`'JLk ut.uA { 0}ZQ_A p;p*|ZwnbMһw(~hVtNve^qu<Ɛ{-h9R(m*M@6Ҧ刨KBdC8hb$a!xz:H-p`-&YT!0  D]kBdlz=7d-&IT*hA~P ;cAhqMMWR޽KR4"(kPW1b!88tطo}ׂ)HT6A Z@]ňa``V6db })-b000 Bxx:& ^$*PSk o]J{a BX;9`6eIV"P(QP07A*(U@6ҦQT J1 UBmZl@T Zb"~xIZ Z@] qh(ar' Z Z@]E$*q2[ÇgώOkMM]/*v)C-_햗;rDT%DNpN]M;wL"D'߻zw$Dl3#BT2R6~2߽K_" PWDm:"fKNB*I 9$)y*!mii*˻RB {0l"ST)yjҔspMf6* RSD|Zd 7wmyTdbOl"S>QMKW<]:;Hڈ]d6"(?a$,6#@KB3YS$ZkV\W3#<6$GeLlfD1%XR ¯<z-%w/Hz oI~I(7ܼݻqH`d$hq>yr8&Fz]@6ҦQڴ; 2)Hi(m"M[aIENDB`java-design-patterns-1.16.0/double-checked-locking/pom.xml000066400000000000000000000035631312550536300234360ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 double-checked-locking junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/double-checked-locking/src/000077500000000000000000000000001312550536300227015ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/000077500000000000000000000000001312550536300236255ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/000077500000000000000000000000001312550536300245465ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/000077500000000000000000000000001312550536300253245ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300271545ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/iluwatar/doublechecked/000077500000000000000000000000001312550536300317355ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/000077500000000000000000000000001312550536300333635ustar00rootroot00000000000000App.java000066400000000000000000000052201312550536300346660ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doublechecked.locking; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * * Double Checked Locking is a concurrency design pattern used to reduce the overhead of acquiring a * lock by first testing the locking criterion (the "lock hint") without actually acquiring the * lock. Only if the locking criterion check indicates that locking is required does the actual * locking logic proceed. *

* In {@link Inventory} we store the items with a given size. However, we do not store more items * than the inventory size. To address concurrent access problems we use double checked locking to * add item to inventory. In this method, the thread which gets the lock first adds the item. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { final Inventory inventory = new Inventory(1000); ExecutorService executorService = Executors.newFixedThreadPool(3); for (int i = 0; i < 3; i++) { executorService.execute(() -> { while (inventory.addItem(new Item())) {}; }); } executorService.shutdown(); try { executorService.awaitTermination(5, TimeUnit.SECONDS); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown"); } } } Inventory.java000066400000000000000000000047121312550536300361500ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doublechecked.locking; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.Collections; import java.util.List; import java.util.concurrent.locks.Lock; import java.util.concurrent.locks.ReentrantLock; /** * * Inventory * */ public class Inventory { private static final Logger LOGGER = LoggerFactory.getLogger(Inventory.class); private final int inventorySize; private final List items; private final Lock lock; /** * Constructor */ public Inventory(int inventorySize) { this.inventorySize = inventorySize; this.items = new ArrayList<>(inventorySize); this.lock = new ReentrantLock(); } /** * Add item */ public boolean addItem(Item item) { if (items.size() < inventorySize) { lock.lock(); try { if (items.size() < inventorySize) { items.add(item); LOGGER.info("{}: items.size()={}, inventorySize={}", Thread.currentThread(), items.size(), inventorySize); return true; } } finally { lock.unlock(); } } return false; } /** * Get all the items in the inventory * * @return All the items of the inventory, as an unmodifiable list */ public final List getItems() { return Collections.unmodifiableList(items); } } Item.java000066400000000000000000000023231312550536300350450ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doublechecked.locking; /** * * Item * */ public class Item { } java-design-patterns-1.16.0/double-checked-locking/src/main/resources/000077500000000000000000000000001312550536300256375ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/main/resources/logback.xml000066400000000000000000000040151312550536300277630ustar00rootroot00000000000000 double-checked-locking.log double-checked-locking-%d.log 5 %-5p [%d{ISO8601,UTC}] %c: %m%n %-5p [%d{ISO8601,UTC}] %c: %m%n java-design-patterns-1.16.0/double-checked-locking/src/test/000077500000000000000000000000001312550536300236605ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/000077500000000000000000000000001312550536300246015ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/com/000077500000000000000000000000001312550536300253575ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300272075ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/com/iluwatar/doublechecked/000077500000000000000000000000001312550536300317705ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/000077500000000000000000000000001312550536300334165ustar00rootroot00000000000000AppTest.java000066400000000000000000000025121312550536300355620ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doublechecked.locking; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } InventoryTest.java000066400000000000000000000101661312550536300370430ustar00rootroot00000000000000java-design-patterns-1.16.0/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doublechecked.locking; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import static junit.framework.TestCase.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertTrue; /** * Date: 12/10/15 - 9:34 PM * * @author Jeroen Meulemeester */ public class InventoryTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Inventory.class); } @After public void tearDown() { appender.stop(); } /** * The number of threads used to stress test the locking of the {@link Inventory#addItem(Item)} * method */ private static final int THREAD_COUNT = 8; /** * The maximum number of {@link Item}s allowed in the {@link Inventory} */ private static final int INVENTORY_SIZE = 1000; /** * Concurrently add multiple items to the inventory, and check if the items were added in order by * checking the stdOut for continuous growth of the inventory. When 'items.size()=xx' shows up out * of order, it means that the locking is not ok, increasing the risk of going over the inventory * item limit. */ @Test(timeout = 10000) public void testAddItem() throws Exception { // Create a new inventory with a limit of 1000 items and put some load on the add method final Inventory inventory = new Inventory(INVENTORY_SIZE); final ExecutorService executorService = Executors.newFixedThreadPool(THREAD_COUNT); for (int i = 0; i < THREAD_COUNT; i++) { executorService.execute(() -> { while (inventory.addItem(new Item())) {}; }); } // Wait until all threads have finished executorService.shutdown(); executorService.awaitTermination(5, TimeUnit.SECONDS); // Check the number of items in the inventory. It should not have exceeded the allowed maximum final List items = inventory.getItems(); assertNotNull(items); assertEquals(INVENTORY_SIZE, items.size()); assertEquals(INVENTORY_SIZE, appender.getLogSize()); // ... and check if the inventory size is increasing continuously for (int i = 0; i < items.size(); i++) { assertTrue(appender.log.get(i).getFormattedMessage().contains("items.size()=" + (i + 1))); } } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/double-dispatch/000077500000000000000000000000001312550536300206775ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/README.md000066400000000000000000000014411312550536300221560ustar00rootroot00000000000000--- layout: pattern title: Double Dispatch folder: double-dispatch permalink: /patterns/double-dispatch/ pumlid: NSbB3iCW303HgpG70Ezx6yTOWSeOv4zp_MRTtUZDCPGa6wV9gqTiVmCOtlKQqVDCPwEbmHgLreGXUMEWmGU_M1hxkBHiZ61JXud-1BILft1fmvz37JZetshQh3kd_000 categories: Other tags: - Java - Difficulty-Intermediate - Idiom --- ## Intent Double Dispatch pattern is a way to create maintainable dynamic behavior based on receiver and parameter types. ![alt text](./etc/double-dispatch.png "Double Dispatch") ## Applicability Use the Double Dispatch pattern when * the dynamic behavior is not defined only based on receiving object's type but also on the receiving method's parameter type. ## Real world examples * [ObjectOutputStream](https://docs.oracle.com/javase/8/docs/api/java/io/ObjectOutputStream.html) java-design-patterns-1.16.0/double-dispatch/etc/000077500000000000000000000000001312550536300214525ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/etc/double-dispatch.png000066400000000000000000000771541312550536300252450ustar00rootroot00000000000000PNG  IHDRt~3IDATxoW}ժRd]=>Ry"m5-jP\ L )Gi`8qBv4lBZ*o4AH}gߵf5f5k|>h3fYg& V}04h\wLB%}7(Z. SqP0,%(( pkA! k \ZPZW0Zds>3&4a-AAa+XKk;oNmd %(( pep"ay=tl"q_>a-AAa+ѹOet!K1̓JRW, Ji\^p-_a-AAa+Cc5lo8lѡG!N{:T%-Lwb\0P>}g'UD6fg( ŸJ¶жk)%(( peeE}+A""d{s fI2ڈ/ o( pe֒ʡ-~{ry>3'c]ْ I^Ƚ \$~B0q+ O%soWlH;,ok܉7 ƅ_E?Ƚ;Ul-|Z;orZO( pe`]gJΟ=]+c-&+ʕ悵"%(( pe`G';=s|\9}ѷHidml&ase;L/K](Lf_>|?BNb?k \;u|}"}[uG-sYvLu׬E Вv|-.MT߳Z6a-AAa+;|ﵗ?}{ykOpe[ы'1gW7I/d'K&/95l\YKű HXKPP%9^7Fz3Ogsj6j1b)ײriBFkE>'ZrA~lBZWf-ȵ'o<0K?yr/A^z#n>84E! Wk 2ڲqZWf-/zw\ӷu~Z3͟=_PmbէW$NJXU/e4 6+`%a-AAa+HGw|Sw}>>Co-tm|t?& .u5c3$ GXKPPe˕ic7F%\|xJ[8#9m{pfk;8.|ل ZX;F!%(( pk QxQXKPP ւB`-(da-AAa+X YXKPP ւB`-HzOˌmZWt,%(( pe4֒U "ϡrvg6̧_],GoG-+ cY>W ԙ1K66k \H|ֳϧRGy2dJg/>$Y)󅑱efSl-?hƇ4p,ZWFa- My'~AQK:?K}i3C¨#(/a-AAa+c4\J7wm[K tbҔv$ZWb-Zb{ζ6J:vI)߉) k \﨧LZiJ͊mF~;&a-AAa+㰖 J>2n f oן}IZo( pe4ւRXKPP ւB`-(da-AAa+X YXKPP ւBk['Ͼ`-ʄQ XF-!Aa+X YXKPP ւB`-(da-AAa+X YXKPPJR7o̪k]q k \ZJ VXKPPJbxDeZWAVyW#k$]fEXh4ZWj7Z-[i-E`1hԢ,qXxZWj%_Z{w-^RC)%(( pqEfEkc-νc׏Xq5]YnhZW{8BLSO'+{@D/(da-AAa+X YXKPP ւB`-(da-AAa+X YXKPP ւBd-4a-AAa+0nS(`-(da-AAa+|,SIm6m 4eB2=e!i%b{#$ʄerL2p&Obg44a-AAa+D\ËQkQD40 k \i'Q ւ0ﵤ#i4a-AAa+24?!6N7g 4t6zZW0,%(( p%)҄`-(da-AAa+X YXKPP ւBf-,=M [XKPPQ!V gZW0Ug>؜&%!!W&oEH-p$'.%(( pe(ܔE4dN$37 Iq k \Y9ʤRҁ# =9na-AAa+E>nr^0LZG-X j,%(( pe(z.۽GzrZW: i;$$҅t^QZAXKPPJ"_ʟFh)a-AAa+]Zv' YjZW,%(( pkA! k \ZPZW0,%(( pe5kɦJż/ZlƳZW0f>NeYD~L IJp3-4di|miR$ BRDXKPPJQ&!) уiemy I98a-AAa++ET/ͧCvuICޭI0L}:,%XeX qÆ %(( p{-G(eZWVBLR}EB2kZÿ́qbٚYjhHbτ0&zA! k \ZPZW0,%(( pkA! k \ZPZWvz Tw\0jAk¨%$( pkA! k \ZPZWXʳo;4a-AAa+ֲJLO>1k \ij-Ҧ;hZWV)|FQ"hAe[EkN{󎅵tALD "jd=ڞط}0jkܹ{ч~_(=ZK:dzJ=(a-AAa+G1C/=}tU28.9uxٞd!t+ Vن\?$UyhZWlr'?ÙLXzݿsj)\9dE ?=i(EbW;qZ)ukTcm綑D[Յv^[a-AAa+6k{7pS͏GF OARhanc"m%ǴWVvL]TZ<yجmo;b}.-4wgĹ:s/vkQ6̭l Ζ/RWG7 kPZﺇ>z;GO>{gF;}0ZX %,[Y;jЕQַ6 $ kPZ"?/DZ?z|Z^vKf%vUa-ZkPͺ^ W*%gRq;~.+?%uD~ol.[n7ԝF9$i@V20z'19bK/*+b^ Za-AAa++Y˒WjoePC!ˠwA `-(da-AAa+X YXKPP ւBTM.#xx_19"a-AAa+II7brTZW*(ņR_#O;g6̶.br4ZWlaD_Y__LL"|+d@ k \YKQ&YC6KEBLLXKPPZ:282wuDCɑ k \YKQ&%BLLXKPPJmL.ԯﵤe-BL\XKPPJǝD,6}Bl2nw brZW{e( !&G&%(( pe%k6ʤZ19*a-AAa++Z2iBLHXKPP 3`-(da-AAa+X YXKPP ւB`-@_?L ! k \!ʤi07f'#堄er鈓B ʁ k \!dHs|Sݕ5CbL/%EL{NdMcHbPNXKPPZ:2/.aY\5bLj6ϴoseh/bPNXKPPZ:2YZA 5CkZ]XKPPJmLV<|\2j$1('%(( pNLFmb6zHbPMXKPPJ{Ler=r`ZWVL.gbPJXKPPʊL.gbPIXKPP9ZJXKPP ւB`-(da-AAa+X YXKPPJb2x"Q0OR ͕m(FXKPPJx2Y}B$5Ra-LF{~aX97,vE,,O#K}NW k \YKQ&dÈbq$M+'K\\ eZWlqIk6uWVHk%%(( pf-LlI .B$bQ&m}ZDVZW*n{2)~lZmc{-MHA k \~(%З[O+>rT[Kueerd-EVD\a-AAa++Z2٩D.ZWڻ PZW0,%(( pkA! k \ZPZWV~x=8O'9xTZ%]vUœf/Wubk'&h+et8jiΤ~2@)W0N/] .Rm-u7u_h@,Qy+[`cYJq!UzگB6zʿOe.0*BFs nau:"%`( pZ?++xW>_9DoT*w0U}b yKj_+bQoO~r?AMZґ1gu0P[nk  \G>8?k&}~ʯ\f))%R >Kx7(rdVȿa-Ca+6k?~haCk1E誽d Y\Qab_t{.5:7N7 ׯlj܌Szx UUGzvd-m"%\( pf-hfTk)GcBONmL+K+rɉ*B<U_iou^[:N?!<m }/6>;O\X9T/ZBW*.j)*s`-+H~"'ٯUhbkb-AAa+X* a8:ZW0,%(( pkA! k \ZPZW0xWnREh}njIx:Ԣ0šU#ǝ{ivTbb{iב6T[=KG{>V[ЕK̯{:Ԯ0 kyߘ>D*+`&H&)Q:AVGZbۿ7?yWPoPMG)JnqhT1-{GwG<z;GO>{gF;}0ZV;j1ūŻg H'%(( p6>}#8cCoyrTZ^0Vqdǥx9; k \~O)y8`ZAh GP/"6BT%' jYXKPPJLBkt$]a-AAa+kf-֠o:Ԧ05{Pb1_CQsa-AAa+kg-hTZW0,%(( pe׮NB%}7(Zz+tRG>X @?;w.:~>Zaػwo>X @\xqݗ.]^e8}}BL߇2X @\s5ϟ>DCh _~y޽{y>X o'N>cxZkݻxK.ڵ\`H`-^9wFia4jX WOs^p!#E\`H`-_gX ?Ytx,:kDu^px"Ƴڽ{w߇ X @oL  X j6@o`-0TPfC X j6@o`-0TPfC X j6@o`-0TPfC X j6@o`-0TPfC X j6@o`-0TPfC X j6@o`-0T wLF@TnmkD>_@h0R DXe`-h$Z@.kA#rX ? Zj1ٜόv !IXe`-5jǟoNmdt,2j-OoO'vK(rѹOet!K1̓JRW, Ji\^p-? ٕ V _u9^3$mƅWZRa-~ A0"kI{s~=]9<SJElI]B$/^IXeZU?!V؆wϧ97ӫau$㇏ [5D|Bk ZK'wPb6fے3E>TmW&-;qB \ւF"24a-~ Ak DXe`-h$Z@.`ֲo[΅\HW?x ?{+D QZ@.` r왯Dr}ș;EِH\%ߺ=G盯>_E?ȢZw=^ze̊rö_=W:s=WհDkb\,:^w^zx0_9JY`hZ@.`G';>s|bX.)$+zheH='v`I~cOZ@.`ֲԁ<ע_㟿v?N{՗n~[&i?^Tx_N?wWq+]X"X|ؚe2޴KjeriIBXe Z>>ԋb^?ͻ R}=yGWlBW"}\J=C_3kHEO]w9ە- r@.Xe ZQș/=qc'^>+}=G'9AC鶇m&<v(2m-ȵ'o<0K?yr/A^z#n>8y>WNIX>Ww%`.m[E)\πI+[.õ5rö_=;[:sG?-x?|(6Z'_2n{d媗2IW;ZҘdNJʈiQ&-IJXe Z"փWܽoߗ?xO=@7oUO/j= Vl% vIe^R(o[g#T[z:E3/SXe Z\yϾ?vWo9ZR!Y) -ԣ|IR-_O.C*vφ% ˇ{M k 1X"2n{wŇ4]VR_.]˿ݘm.J*T/ѯI]^H"*ώ~E˒E"?  ]#a$25|kȏ.25W1Cja-~ Ak DXe`-h$Z@.kA#rX ? Z:xC>W'h\CXKZ@.kQ&RhrF3I QcG)R0&{|/؜neYXe`-^>SiZby2Gyڛ;Y+I"+$UMm0}OZ@.k)dДw~<cїvXi-8#x0_vɎH\.k P+KJB< Q-ʅ\RQKlF>^I.>;1Ta-~ AH*QO՛,k-:@, fEy|bQ"UXe`-tkk"_s_Cb#o? ZH\ւF"24a-~ Ak DXe`-h$Z@.`׮NF@TnmkQ &Z@.kA#rX ? ZH\ւF"24a-~ AОhS#&_BL-Z@.ki,e=\XXz k jkoeX'(nN`Vi ޸7mm w Vն$?s(>i~BLBZ*$!&"~Hsa-~ APk-Ƚj_pI续zLO~s]ѸUiEbOHl*LghZXXHSAOZ@.Z5 R` /A>k[赭|V/4~k!r|b$2G-o|PTҷ&wkѶRf\m#kQ)[Pl'XKOZ@.Z ŸUH|\ՒrGha-~ A &Z@.kA#rX ? ZH\ւF"24a-~ Ak['# }Q`¨CF-^ Ak DXe4ŕgխsϽ5rֲJLO>S HXe4i; ܅\A֒O,0VKoX Rvf{/65r^Sb_HlwSH\$-0-ľ|F^? ϝ{𗎾9}Xn>l$01U$Z!KíKVJ  k kyߘ>DJ۹t Vz&Yvi+Z#}N7̯UF* ~p\^|I͵paYdiyBLzp[e= k Ope:o8ÒOĝ`1.1'$.3_~:R0ccKk̺eUKur6k{7pS͏GF ^Os5rDx+kJqb|y(u̼|lAoe =pa-~ A`=pǾqooܣ)+3]"oUb-bhRS=q k A`Cgѓ٣чNn=|EI6~oVvRGam@w YKߟ}G>q ч_jEONY_+sya U=i{-6]p^ t k٧<|}IҶ|cm譟Jݨnv_ 1iGyX#o% B݊'ĠSeT[:kssZJٚ@ ~n6܊Se ZvwW>7_rv6F9dY`- A0HkAHrX ? ZH\ւF"24a-~ Aн^6I$< SXed-o6qoܹ'qu$(Pa-~ APm-jImNY{ovťbǑ`\ALJ+spKԉ#KOm{|Ӎxf0W&nIɶQ4ů#A k 8E,GʺW9<ܳ'R4LRI^7Mo=#DZ@.f-NQ&mNwe=~Q[\:wɄtv$}BXeجqI:GiwK\q uő{ a-~ A`(mN\[n;v;.X\ADW' Ff>2Fa-~ APa-5Q&ڤ]:}9tזʣ@^V'M%e4}| %$!N%(2l0ʤ4V>Pƨoh{-h]rHiNch|cͦE(eEzJUXeجaISzk1sXG1`߈#3zS`|^XeجqI)|9"SZ9 VN'kZQ2 !T+Y"Z@.f-LRYoc-{9G-+Zãa-k nQ&T%W!{RܼY^XzQK8Z@.(OږB;J]j "PI=LLX? YSɴ;.v-,g}2(He`%Wy =*JXeج)ʤ,õt#d@Q&MA0{flnMF-- k ,\L%m^D<Of9kiGXeTXˢ6 rE5cD4 ?ۍ a-~ APm-C}2ӣ?  >\% A0 k QY ? ZH\ւF"24a-~ Ak :r6]q@OgsA> 2:ސ]dk)wh AXeT[JQ&.Uپ_֢b~=k? (X$Ja2Pq>.1T[IWަ[T,2'/X& '*%Z^Xeج)ʤ2n`-)QOqԿg[GmA(DD k 8E4Mn6ޖ 5[h3 [ԣO --2le|G aw S(FkѶR,Ae5~#Tk-FDK k 8E4z&Pbܪ~"[˨Ǩhia-~ A`kI*"=|l Xk-jdlz稔hya-~ APa-(O)H])c1Vb*HkJK^ R兵\Ak^ ? X{k1^kڷ\[Kv|a; Y+2`-k DXe`-h$Z@.kA#rX ? Z.d ZA0>e^Z_a-~ AZ^/?dk7X  jkY)ʤK Ib>=YC.ZL.LS}VBy2y˴āG 'ʤ6řs= ?vZ@.f-NQ&%k[ 2$eج)d}pI$G (ʤN& M&OWSq wGXeج)dkX5xɀL" ^1lߝ>2$eج)ʤ:k =d@Q&MA0{flnMF-a-~ A`kI}B{S,Eu>NI˳jrbrֲ2n2>!Vh*~pL`^CǎBXeT[Pr@D\`蓁 k ZK'!?  $ k DXe4ۺ&ޮFZ@.,ůD7@]Xe4d? h-4|O.6ˊωINHydRn{̺ƥ#NS뉸\W-uM,ME*o[_mRɃȫE< ^XeT[KerQ V.;!Mb?UJ'-.flXeTXe2Z/oqAI/Cp+޲"Mm͉"(m2ΖG ٽ!HJvlf*RߞnlͲM_'隆Tcڼj*|TUҷqϰfhWXeج-ʤz'[EVY/ dAiMyRw\!$3$̔keʬگ+iU)TsZ@.f--E,lCK{)s}ordy;gt&?rgƸ}\]nݛ-muYK)2le>Vo~A^O'{WٛVzRlKL$y`Hl}s0Hɜ{ @Xeج)ʤoR-b2K],Vm?6GZ7E҅ntRoע*]raIIŐ˘{-C k ,\L]1q~>Z-ߍPma-ٽ/Z?kl<옕yqW}xoiՒKRlșߔ|oiZ@.Z͢LՅUw~֮,Aq>5`߿Ǫ;,C2(@> Q.ݼqȽ:[`- APm-k%MZ%J,%2d-qU \? >#ﰧTXe Z k DXe4urM(h\A#k!$Z_a-~ AZ|D,&jo"i:HQrۓfY\V2}oL2e-LK}h+i-q&6 4fM.MNz7sVJI{\A[I}>"'6?f5ޥBz>[; i,O/V&rֲQ&%`t.2/tT$ ?9䥚(g6*&,veӲ3B kL2lֲQ&ɆV|uG5L2dZVHq ݺ1+ltg5V&r6kY({]-ݦzv8%B^GR^Sb"0{X2XXeجe L*}˸n]r0=]/+Tv0/me yrB;t*Fb6G'a-~ APa-Dl1|G5ݒ#;w|Z etF>7(弒.cEKGe Y Q&-ʤrb-C\Z2iLn(R,12Յw͓u r6kYe(8,NLʘ7 8XP!APa- Lj-eRI.Fo X^]/#2TeT[ ZJEt\҅ <^BXe`-( 4_ k DXe`-h$Z@.? hb-DDk,2Y Q& k 2(1{r+xz m\er(Ҕ3Av.ڄiz m\AerPꣵ2dW2Y@dKk k!d;Q&Kde&_U͌geIR2b"ZB[b-~ A`L~(Jǧ<)BַUoE> ϘJieOS.Iq_hK2lBIw2i0TOrGq,ޘeMN^ǔJy4i.)%r6k!ʤ1Q&u# W,]ʮMG+A9_OX@ЖXeج(G4VMb-~ APa- LjeҚWjt@ 2&|ܾ2,&? ZQ&˨ք\҉2 ρ&? ZH\ւF"24a-~ Ak['# }Q@?_Z~~}(X t+˿@˼mo.]@`-!gϞݻw>}},2x;} "X tũSnƋ/9r}Lt0ϧ'>:[o=XXK!<}- SNW^ 3K.E%~k6yׯd6-oy 7{<}7rJZ5h@^{uH_%wDX CtkYΞ={7rH)%k8wFOa@ y4^ Ar[oԩS<  V$WG4d.> S }y7C0NX{ꧮ2_~y _[AJ1Ƨ1[>щ/^s5RZ :EF'_J[Ο?u1}t+rUWz7>l]b ^ve7|3*޽;51@;D>ԩS}tŋwڕ|)Ǐ_}1 ,h'ND'޽{;`&kI X!6+Q.,Es}uo6U i ӝj-sѾjY#pvl^!s;=YOacvָЩw=8.nEr]>LZUOpEUNu9;IΆA<иP*!sѾjY㶖T\ t|g6OuR*j͖%T~\ քkk֒ !yR5J'їmH;,G&ָ=+IX_Ѿ%Yœ!31mDv΍tYv ҄%װ kA;a-hZNX ւF* kA;a-hZNX ӠW?x -PZ: Z=󕨾w=rD竏?Zn\]C2m*SJ/ɓYLbBAk,XREH{iXKT;}ow<_}#>sVwO]!njZKzi*XO5iF-%a-e Z1ut6tי#/R~_gOoEgF[//bP1a8d{=RKǹ1lqya-԰^[okY[k#oyjr_3f'wN<{_ǟ8"mNmd0:2tJ,zDcw5+__\夥TՊYՙgIOg[RJ 2ʿ=pa-԰:C!S2XRuY-ǐ̼ewM}kё|}"}[uMQ_'Dyn;uy%/1h ÜnIg?0o;b|qC|j-`-԰:C[2XKEKtn)n׭l֬i%M_}^D{+߼"E>wړ7\}}V/j^oU5$CR;3,v y2Zi5iPK9k?0M" sr{[K_A K [[=j_jӨXӽ8lڧF!XKt'n8rDt?oӵ'ngzϼҨ%2 ʢV.eQTU,?*h-t%IZ{&Lz_G oX:]˅xSVڗ4*lR\V6>.|#מ7/Wt֗_Hy͏niuYZ,Z֢r s.-լE;[K8_kij_a uUZo4qNrי?k7CѷbIٗȲ.%./ ]Zu i-UWsb-&rkij_a uKikַn;6+u?ֲU}o>|~C~ŭlW!40R} askƯւdjBaU*_鴦(u Zqݽ}7mCsDD'>+V4H.ǷC95]ethrVY[c=kAUk=|\<|`e?m{pfKP4z0Ba-F EAYKZ"EX B kA#ւPwZH ԝ4Ra-u'TX B kA#ւPwZH ԝSVs{D[XːE[XK )xBs鳼7Jg14iSHw)O!n6^9UPEXK} SXKZռT (g+>ͩ)𤸭YdyZ|N HXK} VXK ἒ]Y|VUϿԙSݪ~|4dM4$yG}p$Ѿ+RYT]TӅJf7ToQ"Ѿ+R}Uw:ϧsdNEEjLׂ:߬7*+ZS- ` _y2ǭۘmMHAQw8ws)C,-T}0D4Ra-u'TX B kA#ւPwZH ԝ4Ra-u'TX Bl-vu0hJއо`Q &ZL.q kA;a-hZNX Zm|4RM ԙ&\CւPwZH ԝVŕgխsϽ&BBkUe?TS?y sh M:2W%d=U}|*qeIX++koѳ37'{v=uI7ve**%+YҾu^BUϝ{𗎾9}Xn3*,˗YrR-unVuǭDZv`}-WzhZ?7}ѿRI֩D_6Wլba:=$yoIN߼Ji_ediZME%tolN7Î3Aܸ|+VR߾jkL%UjGj_[kZt3TjZn_^y8CѿBmͼ:HR:q-gmZE' ҴLɕJNܨhT( UJMK)`ٿVnUP ZWm36Ze72Pn5b+J;ދY/޻qc_x39Q%~d,Gh0jqH\ETZ*֌Wg60Zr[Q{ Zڗ{3oc㨅>b5H?| 'ѿ: 3 1bmS=9NG5ה͵-ާz{߲ff:]Z.RRvTWۼT~UE%gRpd|* KfE0[VS;JH.ܘB>6:k|{ΒBj ZWm37vT]EҾ炁U1T^ ^avoVk-CU}Zz+ʪvfK%j^QZ>Ra-hɳ#ķZ>NyBւPwZH ԝ4Ra-u'TX B kA#ւPwZj^-P3*="NEc|LngvV{g6|k},lN$=YWһ8v2qVr/Vڏ{h_kkQQx]V}JԹrE$iC.MzoqU}оVk ZLQRqDY', isg!e\MgYZrlb3&TLogH-`>Y)ʚNdz(C*Lk}ѾI#kq2i Y9mA!ˑTc1eyfmNeS>sB160G'kil]AT}оh_j_-EtYSkW)\&K6Fc>ġ?M8AkCM LZT1F;h-/`Z\DVǰiuLj.@8w2V9q2儌QvhYS)@k}Ѿfe*u5-1d6lɳ\ n3fr˞U M6*оh_j_mE4lx-XW-Af85`uUH隲Z9 Il}ѾFվڋ2):=?"}|6|+(Dl/wǴNO#* =RF(p ZgZj$\ 5|kY.]Y a kiI/d%5UΉv{XXK[}!]ta-u'TX B kA#ւPwZH ԝ4Ra-u^q" }fIhA#aW>ESHyK+oB} ߾ZL2s9{߶awPj*9BZzm5(J~gCI.w_} Zh_KeWkQ&k)ޜn+{'w۝yE~t46k) ej 9ݘ%h/_B} } ="P2ͳ/_qz9n͍VܶOC-ʳ&ݳNmKI ,bh-/ LjL=vR" ؛G0CZKUǸ6܋Xbh-/ Lj3 OOHs8ZA-%vEf=mW5/q[,Ed|I)@[Hג=ҜZWV}dɳ*--ٓ~$JҕgtVUÃоh_l_#2<i7gL69%ҜmUx|5iKŕ7]q-Xk}ѾپePqhZTʠFOSwkjmfOH발qɐzܽh k=׉u!E\R a(-D{[Z kо{[(x({kOy})>80C~xǪkT(t~(xɆRBib=Xܜ'CA{EU"d]_: ^>O+gXgh_Q/LZ( ^qJg K< >,]U3/רQ&ҵ$lxW õ+γ+[8EIK-/r;0sࣺlZZgh_Q/LZҭM+B߭% ,ϼ)?MG^s.4~X=C}}1K ) ^y KYZ ZBЄxvQϰt KXx KYXD JX ւF* kA;a-hZNX S8~$Jb󃑞`I^{[6ҜHn7RW=冗{÷+tD)_Heߚ\OX\3zo]RѾh_ LJITZItQ[x о+Q(t+^ٛ[ӨxY3n[;$i1I7/RZa߱?􉕌\=R]0E^"ʤ%v)T)ozHL΍Ȟ\R)W2O 7`&Y 5EɺtM8 Rjq!Y]_TWmY!:j3?͢x拴:^B} }eҒnQtM(͙lEJU_KŜKdNE?oסk(uZkpxYr~V =ri4;Xs&ޟKo;^B} }eҒnmr%|+_eJu7g)ړ3X)y2ZL>Bh-/ Q&-&'=Som,ōIy9M@kcVn-2lsc* +f|ZL,|?Ci-/t(`K`-!Wyo_XKvGzkh_߾npbEՏ^Ba-I}/HX B kA#ւPwZH ԝ4Ra-u'TX BݩWkq~$J4C{3(x7o1k}ѾMh_XKwId" (x7o1Nk. h_Q&sF^B-}EIK(x7q>1'8 Zh_/LZ% ުoU}+[i-/ Q&5l@n_AĕW^yҥ`оzksE>c} /XKo߿{@_~xݻe]}8;XK?>}[o>|!Zk9|!:N>AA~\~{}wy'{챃x<CXK޽7tҮ]xh_!ܹsY+߿',-<:@Z?n+B +:<"pZ?n+B ux`ih_A, +(DTtva%Zd_<]COAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAOAꑮ1h.uTKBw+k  /Ԋk\X ]X "WX "WX "WX "olmL63caBk.EOWzoNmd kѡ}Ո&#:7;,oFnO'vK(jZ[;֢CUXKo6r'D@[Y)?[HP:H􂀖myZth_VJ52j:ESh5q΢Ԧ*!ma\ yxZth_V$pvl^!s;=YOacvָЩw=8.HXӾUϪ'O *GW:$gC ~.`}պU-/W+ZZC(s~?0]9<͓`]ZG%u 2y //W+Z:R,ECZKuk>O|/֑$vX,,Mq'r{W0., ˰$ڗT<>#1ۖZNNjױJe'O EXՊ4^a-:/Ԋ4^a-:/Ԋ4^a-:/Ԋ4^a-:/Ԋ4^a-:/Ԋ4^a-:/Ԋ4^a-:/ԊۺiVKa-#F֒<)cl`-RQyt>uי#/s|\9}ѷVfƑJVyXDTg'n j"WڿZ"IKds&7E߳fnk }9[5% 7fӢ54@r3H\RiVimYtG>5dNŲ_/Uߩ7mxE)|}"}[uMQ_-IJlNZcDmk7Z4&!/SSꞥS+jU}܉kƍ%ߛZ쭻tHbu֓L~Th<~zQU}ﵗ?}{ykOp[JTK":$6O=~b;|n 8y,ۆm:%f-Z-W bj+ $oyljsjhjJ\Ƶ19Ӌv7]{HO|W?{N/Z"XUZNWur(a'ZVYKtHү(Eg2][(UX%^V垽NϦ\nJ婔dMk W[Uշ^Ƶ'\{޼_Q֗_'Yy͏niuɂZ,Cb HKw5k.%f-dk^3 :ԕ5ZWѮ qNrי?kyx?|(VyB<敫|>^+:i15gLW]႘;+Zi!5Uח ۗXkuRqA|9˩+TnZcl\m-~+޷<} }Ç7Dߚ^E #hZR0ܻ+{bÍ5]epR&_ 7ebj`- ֊d>bpUnZ~=-+wnꡛ>>GK4_Id~~D2icJ ڎ՚ZÇ :<Z|mkdrbmZNn I+U]yN,W rq>ml9{ eZtְ} AXKZtְ}yI6k"%Pa-:kؾt㤏BX jEX jEX jEX jEX jEX jEX:Kn2R$~]vw3W*fzvO~ek[{uO.bsw6Ry\.zIn;ŵI:`KŲ㩎J  B_O޼xmF#H )XfsYJKU{-BjiqmrݐK  ꕡϟVO7zy_Umdw6Oo+iz R@).KZxbw#'n"[0DU h"-.ԇI&L{x4t&-x4ĉ\~/_^|B}hFcQK@sv9 9a1g$~ GZGb4~駍\!^6㻛O㧯/B}P_}n$İ'|KkqУ;rsl+Pg~!qc8aYp%&RjpZE,m9u%+̃\Y|oőꃴ϶ ]k`[4K;wfm3d9]m`wJ/j2ʒLۻ%RX!n+-2'H !E"N𛀑YD7Y4 @B'vs3:y G^w!-_{>&!rRihiq :A! -&ߔh';CZ\|x/H t:5 !-uHk java-design-patterns-1.16.0/double-dispatch/etc/double-dispatch.urm.puml000066400000000000000000000041721312550536300262260ustar00rootroot00000000000000@startuml package com.iluwatar.doubledispatch { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class FlamingAsteroid { + FlamingAsteroid(left : int, top : int, right : int, bottom : int) + collision(gameObject : GameObject) } abstract class GameObject { - damaged : boolean - onFire : boolean + GameObject(left : int, top : int, right : int, bottom : int) + collision(GameObject) {abstract} + collisionResolve(FlamingAsteroid) {abstract} + collisionResolve(Meteoroid) {abstract} + collisionResolve(SpaceStationIss) {abstract} + collisionResolve(SpaceStationMir) {abstract} + isDamaged() : boolean + isOnFire() : boolean + setDamaged(damaged : boolean) + setOnFire(onFire : boolean) + toString() : String } class Meteoroid { - LOGGER : Logger {static} + Meteoroid(left : int, top : int, right : int, bottom : int) + collision(gameObject : GameObject) + collisionResolve(asteroid : FlamingAsteroid) + collisionResolve(iss : SpaceStationIss) + collisionResolve(meteoroid : Meteoroid) + collisionResolve(mir : SpaceStationMir) } class Rectangle { - bottom : int - left : int - right : int - top : int + Rectangle(left : int, top : int, right : int, bottom : int) + getBottom() : int + getLeft() : int + getRight() : int + getTop() : int ~ intersectsWith(r : Rectangle) : boolean + toString() : String } class SpaceStationIss { + SpaceStationIss(left : int, top : int, right : int, bottom : int) + collision(gameObject : GameObject) } class SpaceStationMir { - LOGGER : Logger {static} + SpaceStationMir(left : int, top : int, right : int, bottom : int) + collision(gameObject : GameObject) + collisionResolve(asteroid : FlamingAsteroid) + collisionResolve(iss : SpaceStationIss) + collisionResolve(meteoroid : Meteoroid) + collisionResolve(mir : SpaceStationMir) } } FlamingAsteroid --|> Meteoroid GameObject --|> Rectangle Meteoroid --|> GameObject SpaceStationIss --|> SpaceStationMir SpaceStationMir --|> GameObject @endumljava-design-patterns-1.16.0/double-dispatch/pom.xml000066400000000000000000000036061312550536300222210ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 double-dispatch junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/double-dispatch/src/000077500000000000000000000000001312550536300214665ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/000077500000000000000000000000001312550536300224125ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/000077500000000000000000000000001312550536300233335ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/000077500000000000000000000000001312550536300241115ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300257415ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/000077500000000000000000000000001312550536300307335ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java000066400000000000000000000065041312550536300323230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.List; /** * * When a message with a parameter is sent to an object, the resultant behaviour is defined by the implementation of * that method in the receiver. Sometimes the behaviour must also be determined by the type of the parameter. *

* One way to implement this would be to create multiple instanceof-checks for the methods parameter. However, this * creates a maintenance issue. When new types are added we would also need to change the method's implementation and * add a new instanceof-check. This violates the single responsibility principle - a class should have only one reason * to change. *

* Instead of the instanceof-checks a better way is to make another virtual call on the parameter object. This way new * functionality can be easily added without the need to modify existing implementation (open-closed principle). *

* In this example we have hierarchy of objects ({@link GameObject}) that can collide to each other. Each object has its * own coordinates which are checked against the other objects' coordinates. If there is an overlap, then the objects * collide utilizing the Double Dispatch pattern. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { // initialize game objects and print their status List objects = new ArrayList<>(); objects.add(new FlamingAsteroid(0, 0, 5, 5)); objects.add(new SpaceStationMir(1, 1, 2, 2)); objects.add(new Meteoroid(10, 10, 15, 15)); objects.add(new SpaceStationIss(12, 12, 14, 14)); objects.stream().forEach(o -> LOGGER.info(o.toString())); LOGGER.info(""); // collision check objects.stream().forEach(o1 -> objects.stream().forEach(o2 -> { if (o1 != o2 && o1.intersectsWith(o2)) { o1.collision(o2); } })); LOGGER.info(""); // output eventual object statuses objects.stream().forEach(o -> LOGGER.info(o.toString())); LOGGER.info(""); } } FlamingAsteroid.java000066400000000000000000000027561312550536300346010ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; /** * * Flaming asteroid game object * */ public class FlamingAsteroid extends Meteoroid { public FlamingAsteroid(int left, int top, int right, int bottom) { super(left, top, right, bottom); setOnFire(true); } @Override public void collision(GameObject gameObject) { gameObject.collisionResolve(this); } } GameObject.java000066400000000000000000000043051312550536300335210ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; /** * * Game objects have coordinates and some other status information. * */ public abstract class GameObject extends Rectangle { private boolean damaged; private boolean onFire; public GameObject(int left, int top, int right, int bottom) { super(left, top, right, bottom); } @Override public String toString() { return String.format("%s at %s damaged=%b onFire=%b", this.getClass().getSimpleName(), super.toString(), isDamaged(), isOnFire()); } public boolean isOnFire() { return onFire; } public void setOnFire(boolean onFire) { this.onFire = onFire; } public boolean isDamaged() { return damaged; } public void setDamaged(boolean damaged) { this.damaged = damaged; } public abstract void collision(GameObject gameObject); public abstract void collisionResolve(FlamingAsteroid asteroid); public abstract void collisionResolve(Meteoroid meteoroid); public abstract void collisionResolve(SpaceStationMir mir); public abstract void collisionResolve(SpaceStationIss iss); } java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java000066400000000000000000000044031312550536300335260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Meteoroid game object * */ public class Meteoroid extends GameObject { private static final Logger LOGGER = LoggerFactory.getLogger(Meteoroid.class); public Meteoroid(int left, int top, int right, int bottom) { super(left, top, right, bottom); } @Override public void collision(GameObject gameObject) { gameObject.collisionResolve(this); } @Override public void collisionResolve(FlamingAsteroid asteroid) { LOGGER.info("{} hits {}.", asteroid.getClass().getSimpleName(), this.getClass().getSimpleName()); } @Override public void collisionResolve(Meteoroid meteoroid) { LOGGER.info("{} hits {}.", meteoroid.getClass().getSimpleName(), this.getClass().getSimpleName()); } @Override public void collisionResolve(SpaceStationMir mir) { LOGGER.info("{} hits {}.", mir.getClass().getSimpleName(), this.getClass().getSimpleName()); } @Override public void collisionResolve(SpaceStationIss iss) { LOGGER.info("{} hits {}.", iss.getClass().getSimpleName(), this.getClass().getSimpleName()); } } java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java000066400000000000000000000040501312550536300335010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; /** * * Rectangle has coordinates and can be checked for overlap against other Rectangles. * */ public class Rectangle { private int left; private int top; private int right; private int bottom; /** * Constructor */ public Rectangle(int left, int top, int right, int bottom) { this.left = left; this.top = top; this.right = right; this.bottom = bottom; } public int getLeft() { return left; } public int getTop() { return top; } public int getRight() { return right; } public int getBottom() { return bottom; } boolean intersectsWith(Rectangle r) { return !(r.getLeft() > getRight() || r.getRight() < getLeft() || r.getTop() > getBottom() || r .getBottom() < getTop()); } @Override public String toString() { return String.format("[%d,%d,%d,%d]", getLeft(), getTop(), getRight(), getBottom()); } } SpaceStationIss.java000066400000000000000000000027401312550536300345760ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; /** * * Space station ISS game object * */ public class SpaceStationIss extends SpaceStationMir { public SpaceStationIss(int left, int top, int right, int bottom) { super(left, top, right, bottom); } @Override public void collision(GameObject gameObject) { gameObject.collisionResolve(this); } } SpaceStationMir.java000066400000000000000000000052361312550536300345720ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/main/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Space station Mir game object * */ public class SpaceStationMir extends GameObject { private static final Logger LOGGER = LoggerFactory.getLogger(SpaceStationMir.class); public SpaceStationMir(int left, int top, int right, int bottom) { super(left, top, right, bottom); } @Override public void collision(GameObject gameObject) { gameObject.collisionResolve(this); } @Override public void collisionResolve(FlamingAsteroid asteroid) { LOGGER.info("{} hits {}. {} is damaged! {} is set on fire!", asteroid.getClass().getSimpleName(), this.getClass().getSimpleName(), this.getClass().getSimpleName(), this.getClass().getSimpleName()); setDamaged(true); setOnFire(true); } @Override public void collisionResolve(Meteoroid meteoroid) { LOGGER.info("{} hits {}. {} is damaged!", meteoroid.getClass().getSimpleName(), this.getClass().getSimpleName(), this.getClass().getSimpleName()); setDamaged(true); } @Override public void collisionResolve(SpaceStationMir mir) { LOGGER.info("{} hits {}. {} is damaged!", mir.getClass().getSimpleName(), this.getClass().getSimpleName(), this.getClass().getSimpleName()); setDamaged(true); } @Override public void collisionResolve(SpaceStationIss iss) { LOGGER.info("{} hits {}. {} is damaged!", iss.getClass().getSimpleName(), this.getClass().getSimpleName(), this.getClass().getSimpleName()); setDamaged(true); } } java-design-patterns-1.16.0/double-dispatch/src/test/000077500000000000000000000000001312550536300224455ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/000077500000000000000000000000001312550536300233665ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/000077500000000000000000000000001312550536300241445ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300257745ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/000077500000000000000000000000001312550536300307665ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java000066400000000000000000000025031312550536300332110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } CollisionTest.java000066400000000000000000000106711312550536300343520ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import static org.junit.Assert.assertEquals; import java.util.Objects; /** * Date: 12/10/15 - 8:37 PM * Test for Collision * @param Type of GameObject * @author Jeroen Meulemeester */ public abstract class CollisionTest { /** * Get the tested object * * @return The tested object, should never return 'null' */ abstract O getTestedObject(); /** * Collide the tested item with the other given item and verify if the damage and fire state is as * expected * * @param other The other object we have to collide with * @param otherDamaged Indicates if the other object should be damaged after the collision * @param otherOnFire Indicates if the other object should be burning after the collision * @param thisDamaged Indicates if the test object should be damaged after the collision * @param thisOnFire Indicates if the other object should be burning after the collision * @param description The expected description of the collision */ void testCollision(final GameObject other, final boolean otherDamaged, final boolean otherOnFire, final boolean thisDamaged, final boolean thisOnFire, final String description) { Objects.requireNonNull(other); Objects.requireNonNull(getTestedObject()); final O tested = getTestedObject(); tested.collision(other); testOnFire(other, tested, otherOnFire); testDamaged(other, tested, otherDamaged); testOnFire(tested, other, thisOnFire); testDamaged(tested, other, thisDamaged); } /** * Test if the fire state of the target matches the expected state after colliding with the given * object * * @param target The target object * @param other The other object * @param expectTargetOnFire The expected state of fire on the target object */ private void testOnFire(final GameObject target, final GameObject other, final boolean expectTargetOnFire) { final String targetName = target.getClass().getSimpleName(); final String otherName = other.getClass().getSimpleName(); final String errorMessage = expectTargetOnFire ? "Expected [" + targetName + "] to be on fire after colliding with [" + otherName + "] but it was not!" : "Expected [" + targetName + "] not to be on fire after colliding with [" + otherName + "] but it was!"; assertEquals(errorMessage, expectTargetOnFire, target.isOnFire()); } /** * Test if the damage state of the target matches the expected state after colliding with the * given object * * @param target The target object * @param other The other object * @param expectedDamage The expected state of damage on the target object */ private void testDamaged(final GameObject target, final GameObject other, final boolean expectedDamage) { final String targetName = target.getClass().getSimpleName(); final String otherName = other.getClass().getSimpleName(); final String errorMessage = expectedDamage ? "Expected [" + targetName + "] to be damaged after colliding with [" + otherName + "] but it was not!" : "Expected [" + targetName + "] not to be damaged after colliding with [" + otherName + "] but it was!"; assertEquals(errorMessage, expectedDamage, target.isDamaged()); } } FlamingAsteroidTest.java000066400000000000000000000063371312550536300354730ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; /** * Date: 12/10/15 - 11:31 PM * * @author Jeroen Meulemeester */ public class FlamingAsteroidTest extends CollisionTest { @Override final FlamingAsteroid getTestedObject() { return new FlamingAsteroid(1, 2, 3, 4); } /** * Test the constructor parameters */ @Test public void testConstructor() { final FlamingAsteroid asteroid = new FlamingAsteroid(1, 2, 3, 4); assertEquals(1, asteroid.getLeft()); assertEquals(2, asteroid.getTop()); assertEquals(3, asteroid.getRight()); assertEquals(4, asteroid.getBottom()); assertTrue(asteroid.isOnFire()); assertFalse(asteroid.isDamaged()); assertEquals("FlamingAsteroid at [1,2,3,4] damaged=false onFire=true", asteroid.toString()); } /** * Test what happens we collide with an asteroid */ @Test public void testCollideFlamingAsteroid() { testCollision( new FlamingAsteroid(1, 2, 3, 4), false, true, false, true, "FlamingAsteroid hits FlamingAsteroid." ); } /** * Test what happens we collide with an meteoroid */ @Test public void testCollideMeteoroid() { testCollision( new Meteoroid(1, 1, 3, 4), false, false, false, true, "FlamingAsteroid hits Meteoroid." ); } /** * Test what happens we collide with ISS */ @Test public void testCollideSpaceStationIss() { testCollision( new SpaceStationIss(1, 1, 3, 4), true, true, false, true, "FlamingAsteroid hits SpaceStationIss. SpaceStationIss is damaged! SpaceStationIss is set on fire!" ); } /** * Test what happens we collide with MIR */ @Test public void testCollideSpaceStationMir() { testCollision( new SpaceStationMir(1, 1, 3, 4), true, true, false, true, "FlamingAsteroid hits SpaceStationMir. SpaceStationMir is damaged! SpaceStationMir is set on fire!" ); } }MeteoroidTest.java000066400000000000000000000061021312550536300343400ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; /** * Date: 12/10/15 - 11:31 PM * * @author Jeroen Meulemeester */ public class MeteoroidTest extends CollisionTest { @Override final Meteoroid getTestedObject() { return new Meteoroid(1, 2, 3, 4); } /** * Test the constructor parameters */ @Test public void testConstructor() { final Meteoroid meteoroid = new Meteoroid(1, 2, 3, 4); assertEquals(1, meteoroid.getLeft()); assertEquals(2, meteoroid.getTop()); assertEquals(3, meteoroid.getRight()); assertEquals(4, meteoroid.getBottom()); assertFalse(meteoroid.isOnFire()); assertFalse(meteoroid.isDamaged()); assertEquals("Meteoroid at [1,2,3,4] damaged=false onFire=false", meteoroid.toString()); } /** * Test what happens we collide with an asteroid */ @Test public void testCollideFlamingAsteroid() { testCollision( new FlamingAsteroid(1, 1, 3, 4), false, true, false, false, "Meteoroid hits FlamingAsteroid." ); } /** * Test what happens we collide with an meteoroid */ @Test public void testCollideMeteoroid() { testCollision( new Meteoroid(1, 1, 3, 4), false, false, false, false, "Meteoroid hits Meteoroid." ); } /** * Test what happens we collide with ISS */ @Test public void testCollideSpaceStationIss() { testCollision( new SpaceStationIss(1, 1, 3, 4), true, false, false, false, "Meteoroid hits SpaceStationIss. SpaceStationIss is damaged!" ); } /** * Test what happens we collide with MIR */ @Test public void testCollideSpaceStationMir() { testCollision( new SpaceStationMir(1, 1, 3, 4), true, false, false, false, "Meteoroid hits SpaceStationMir. SpaceStationMir is damaged!" ); } }RectangleTest.java000066400000000000000000000050421312550536300343170ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.junit.Test; import static junit.framework.TestCase.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; /** * Unit test for Rectangle */ public class RectangleTest { /** * Test if the values passed through the constructor matches the values fetched from the getters */ @Test public void testConstructor() { final Rectangle rectangle = new Rectangle(1, 2, 3, 4); assertEquals(1, rectangle.getLeft()); assertEquals(2, rectangle.getTop()); assertEquals(3, rectangle.getRight()); assertEquals(4, rectangle.getBottom()); } /** * Test if the values passed through the constructor matches the values in the {@link * #toString()} */ @Test public void testToString() throws Exception { final Rectangle rectangle = new Rectangle(1, 2, 3, 4); assertEquals("[1,2,3,4]", rectangle.toString()); } /** * Test if the {@link Rectangle} class can detect if it intersects with another rectangle. */ @Test public void testIntersection() { assertTrue(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(0, 0, 1, 1))); assertTrue(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(-1, -5, 7, 8))); assertFalse(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(2, 2, 3, 3))); assertFalse(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(-2, -2, -1, -1))); } } SpaceStationIssTest.java000066400000000000000000000061241312550536300354710ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; /** * Date: 12/10/15 - 11:31 PM * * @author Jeroen Meulemeester */ public class SpaceStationIssTest extends CollisionTest { @Override final SpaceStationIss getTestedObject() { return new SpaceStationIss(1, 2, 3, 4); } /** * Test the constructor parameters */ @Test public void testConstructor() { final SpaceStationIss iss = new SpaceStationIss(1, 2, 3, 4); assertEquals(1, iss.getLeft()); assertEquals(2, iss.getTop()); assertEquals(3, iss.getRight()); assertEquals(4, iss.getBottom()); assertFalse(iss.isOnFire()); assertFalse(iss.isDamaged()); assertEquals("SpaceStationIss at [1,2,3,4] damaged=false onFire=false", iss.toString()); } /** * Test what happens we collide with an asteroid */ @Test public void testCollideFlamingAsteroid() { testCollision( new FlamingAsteroid(1, 1, 3, 4), false, true, false, false, "SpaceStationIss hits FlamingAsteroid." ); } /** * Test what happens we collide with an meteoroid */ @Test public void testCollideMeteoroid() { testCollision( new Meteoroid(1, 1, 3, 4), false, false, false, false, "SpaceStationIss hits Meteoroid." ); } /** * Test what happens we collide with ISS */ @Test public void testCollideSpaceStationIss() { testCollision( new SpaceStationIss(1, 1, 3, 4), true, false, false, false, "SpaceStationIss hits SpaceStationIss. SpaceStationIss is damaged!" ); } /** * Test what happens we collide with MIR */ @Test public void testCollideSpaceStationMir() { testCollision( new SpaceStationMir(1, 1, 3, 4), true, false, false, false, "SpaceStationIss hits SpaceStationMir. SpaceStationMir is damaged!" ); } }SpaceStationMirTest.java000066400000000000000000000061241312550536300354620ustar00rootroot00000000000000java-design-patterns-1.16.0/double-dispatch/src/test/java/com/iluwatar/doubledispatch/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.doubledispatch; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; /** * Date: 12/10/15 - 11:31 PM * * @author Jeroen Meulemeester */ public class SpaceStationMirTest extends CollisionTest { @Override final SpaceStationMir getTestedObject() { return new SpaceStationMir(1, 2, 3, 4); } /** * Test the constructor parameters */ @Test public void testConstructor() { final SpaceStationMir mir = new SpaceStationMir(1, 2, 3, 4); assertEquals(1, mir.getLeft()); assertEquals(2, mir.getTop()); assertEquals(3, mir.getRight()); assertEquals(4, mir.getBottom()); assertFalse(mir.isOnFire()); assertFalse(mir.isDamaged()); assertEquals("SpaceStationMir at [1,2,3,4] damaged=false onFire=false", mir.toString()); } /** * Test what happens we collide with an asteroid */ @Test public void testCollideFlamingAsteroid() { testCollision( new FlamingAsteroid(1, 1, 3, 4), false, true, false, false, "SpaceStationMir hits FlamingAsteroid." ); } /** * Test what happens we collide with an meteoroid */ @Test public void testCollideMeteoroid() { testCollision( new Meteoroid(1, 1, 3, 4), false, false, false, false, "SpaceStationMir hits Meteoroid." ); } /** * Test what happens we collide with ISS */ @Test public void testCollideSpaceStationIss() { testCollision( new SpaceStationIss(1, 1, 3, 4), true, false, false, false, "SpaceStationMir hits SpaceStationIss. SpaceStationIss is damaged!" ); } /** * Test what happens we collide with MIR */ @Test public void testCollideSpaceStationMir() { testCollision( new SpaceStationMir(1, 1, 3, 4), true, false, false, false, "SpaceStationMir hits SpaceStationMir. SpaceStationMir is damaged!" ); } }java-design-patterns-1.16.0/event-aggregator/000077500000000000000000000000001312550536300210715ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/README.md000066400000000000000000000024671312550536300223610ustar00rootroot00000000000000--- layout: pattern title: Event Aggregator folder: event-aggregator permalink: /patterns/event-aggregator/ pumlid: PSf13iCW30NHgxG70Ezx6uTOX0eCih-JwvTzTwEdUJSjFKu9wwyBMFuXCdvoRRZY21ShKo6ANEQWrkDXiD6NRqwdUAkQ5WDYwZJOTv3SUqzSgqbbp0qeVvZ3Hbun-Wy0 categories: Structural tags: - Java - Difficulty-Beginner - Reactive --- ## Intent A system with lots of objects can lead to complexities when a client wants to subscribe to events. The client has to find and register for each object individually, if each object has multiple events then each event requires a separate subscription. An Event Aggregator acts as a single source of events for many objects. It registers for all the events of the many objects allowing clients to register with just the aggregator. ![alt text](./etc/classes.png "Event Aggregator") ## Applicability Use the Event Aggregator pattern when * Event Aggregator is a good choice when you have lots of objects that are potential event sources. Rather than have the observer deal with registering with them all, you can centralize the registration logic to the Event Aggregator. As well as simplifying registration, a Event Aggregator also simplifies the memory management issues in using observers. ## Credits * [Martin Fowler - Event Aggregator](http://martinfowler.com/eaaDev/EventAggregator.html) java-design-patterns-1.16.0/event-aggregator/etc/000077500000000000000000000000001312550536300216445ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/etc/classes.png000066400000000000000000001311071312550536300240120ustar00rootroot00000000000000PNG  IHDR&6IDATx}-Wu'!HH7G0pF#Hnrpdc`7=y Ǹlچ} '=cۘ S>.ѼLmf4HQHNթ]uN}]?Ԫ޵jשVU{avh2rP"+A`[+hR[,Pwxr2 AoG Wj Npsf !`Bg+})5B<zYJaga_ a=o6^-t;RXYؗBXs) Wj Npjk~ڙZy6ŝͻ./)6Pg'fbϪ|w yLp!f16}NGԶ:;1 WAa׉ZJaga_ CSg({&f//ЩVNU@Զ>:;1-)`;%tﰸ 5H+})m͇6k*4RYYC6r6.2Bl]NoWlEˣW o0:n'*QK__nQ65)ݠ0@S+NLuqdX4RYCpprk>J!#)f CEx$‘V{}q }a>5썿کUkԄc` p}N5B*WjNL`Th\J^),,K\)47V]adGFarsT3|D`ϯlZޑM0j@S+uWg'#ʞ)PD ugXz/z9祝0䗰_Gw tXR]"_3*KqG(N/ЩFTJmى邲gLR$Nd e!J^),,Kankh=xӽ~h7uf1bEVw~}UGf @S+NLʮ藈J.PMQo| ~sϳodǘ nw!B!G3r"R{>>G  %tbs]ҿ+})tʚoӵw cҧ_}wGl?Є%a!겝ł1b]їh(%Z<Ǟѵ\2BtƐc}o$EBu'L~mtmܴy8;!'}bPpWҁV~XeB͢7TxfYyK$g X*Z氐Nn!W 8 R&?z7=z??~6H~wp/P%cX ͜8J,oX'* (kg˕-Sl}3N Dd$F_F\&8[UW[YXBtƐCHf#t]+SQ Jmo۸?Kt;]_\|~sc$)ӕ+U|wYdžz^<7Kpj_+U+})tʚ?z?skCN}⟮3,g>vЄ164]QVOLBYLȭJB#?)wc*]Xfе(QDRtun}'?;z;zn񓓟6g)c>.t!wԫ3z++$f+})tʚ?;_ț>qoOޞn/;Z7ipaWl GG eȡI$v|7LSTqce FJm+>zݻ?0?gR~G}}in G\ON+z#oJ^),,KSG{z^ny`cL֨w1TK4jXlo)wc*]U_r[bl&Jmgk>}/}? ~_w^8@\~u,L_&k1I +gOis¾fO޿ګ2ٍ&J1xT_KV͢3\KaE)tM]8J[ ĉF̦kQe$ڥWjn7?z;m* qɁ)QqyM댙J}]w4o%Jaga_ C}ݷ w/mSo0FV?/'W]4Ti!|4In|NoWjgC}3 ̬tB}v&]fd9[Wj$uC0T5Y ^(OFk_ʆ%*d(O+})tӚog?_O|\>ULoMw T+΂uW 8 Rk^  ) Wj NpּlN7S@: ֝^),,K!B+΂uW 8 Rk9}3xJm`¾š{NL!lR[,Xwz/7S@: ֝^),,K!B+΂uW 8 Rk9}3xJmpw_QiA=RXYؗB_9B_B+L(lJaga_ 氶<}3 |NUNc솋:M %:{d>͞MFh{jhaIt]:ggpT8BPmʭfoPYvHpakk SX< jR[_uѝH_H c U9, %u$׮ /.b6 *$spr,ޠI^),,K*:zꬢ/VˌvF_mF}6C|z?{Z1l ¾:jama ˁ_S WjFÕe(HׂBN%QJ%{W 8 R5), |N5^:kAtj':0R͓Nb5RXYؗBG9-La9pT+ tAJm}YaP5*,S'{4+%CJ U~Jaga_ ]氶0UЩ+Xg3`PX㧁P\67ѸT03ðb/6W 8 R5), |N5^: 6^),,K!B+΂uW 8 Rk9}3xJm`¾š{NL!lR[,Xwz/7S@: ֝^),,K!B+΂uW 8 Rk9}3xJmOz$ö9`=o4^>5Oga_ a=o6^-t;RXYؗBXs) Wj Npsf !`Bg+})'D$Zms "m7S@㯀ëWژ<0]F|/h^0'|]xJm%+})4x`]f_B) Wj;RXYؗBK3 Lΰpϝa+;WT05uwkPj}U+s؆nP7f s |,i1B 5@9A5׋XFR5IqP1%R_q< T_E0)HVYRXYؗBa3 Jg981+T`/9bB[ݗ.0QXwZ B.Rmxt#B hq+UQmxP]eF$Tb(.@c̟~Y9Wj;N1x ׾e1`HpP<%>r ;-tt{+_'|6cuR}5Xh; r Sq|Q,SFߤCN Eߠkf9$?r4 C٧?z6?& ¾؏z,3 3go4Lʱ;t^0h/CRV@ε-\pTP%aNE[d| 94`;xYr6\& La%rB9U jOM2EڪPw6<,II׫+RqCPO ),,Ku橻j8a|$f`j:h"I5',̪ˑ%P-J0 ĸ!XUv^!u$8ym+})4X{:;~D/ݯr/4yR>føRa4kVɉ3!wQc\!6Ԃja츩IR JҷV66QY2Frܵξ5]<|!0g¾9y]^I~qy;Q970U!>3oώEJQK1!ҧY' C&Q hx`h^ͮ $>bfCx5JB|]U0_ȭOv/\ôA2B&a v=M: NX",\x/dmv3e\9G\4$m*Hiajnw)Q;&j,[]~xiq"fA#tˡvSu$R]~bUIrrTJ 9xy:=C7,ʣ/ҿT( B D9XHl&AXJaga_ 9LwIJv\1p8=iy#q' GU97^|!HTu7wΔ&)+,P T[6YDejb=^Ng_xos{ѿT( XR{96IE4@{Jaga_ {``<'7S@V/{۞\>GE_*䪕=X$iB7¾s-7S@V_q"r,T]/I!p^),,K!<0Weº :#@R[ξw c羹FXB Uɺp^),,Ka]=0 f !`ښuO}"$6,d:搃}$D26I10cJaga_ yNL!lR[謁XJaga_ %k>ɳ/x56*ɮm\{H.B+Ea$VRXYؗB#+m$⏶`Nf !`"03]+})4x`]f_B) Wj;RXYؗ L$:}bCp;v2IB1QUHg!N.ȉФBgR.Қ3T*wZ"8&M1nP19RXYؗBɚ'00*hfȻkݢ+{]` ׻w: {نss")'XяϙYt>4_qӵgN'Wg{a("Pd ,<ŇlD@iE ApP~ca mп]pqiTLȡ8sW/Yq_F̃q2C5]:~lI -ąQrS侙|]N4b|gUB?gȡ]_9M\B*m(* ňB$Ԓ?^x̡D,^),,Ku橻j8al(K]qV cJ4FԞ̇Xc!%8Úrϴ.())D/L*'3Psf-?8V$`hZbX` cMָ HTbcK ?j+({M3XU*Wfg^jRi䊢W 8 Rh3gjAmPc9F.3[C 8u*3<ͣ3'%b^Q%6Un0yWȉA,%@3B MX(%?Ai1WԵ$%)SiB~WǢk4#9tV"섷BΟQng}aWB:,H¾=mNX~ѿR!G|&3wE/73|>Y_nh֬>PgB BM),y>R-o'\ گ8g]]ʠ$VE{)d+9xZ32FWjk9{Eg.@>#yAr] 9_v+})4[s򺮽p)eŻ96p  A]MI*˗PUrp fЅe ?3X*0Va8~+jWQ>HRf\25Jc=ާ!< :{?ro| 0mпqvcczq_w*2q4M,t;a r>FŇ'΄փԛR 46RXYؗB%fdL[:9rѮZp] ⴧ}iIA Gb7GnPo|3>UNLbiR*0n/̚~E28IYQ=Ns++FP{NڐC}QVg~\y4E (+hNsrN>rhH-NSr śq3e8Xc@pc%@ `G*k>l㊾6OI!8C1 fv+&rHMa OX*%ȱ֫@*R2_wXKSpi aK'g276bQ0cRV_xos{ѿTQ,co0IƗ]w!^+]75vk Z RXYؗ<0$E31}3xJmu:o3O}4]B9?Ʀ$lrUܩjnkf jm@ RYGLL!lR[~/z[gS>[TU3~)`Mu&Up W機ZKJaga_ ၹH!Lf ! pz&+5{w;;kAucSXP;Y|RLîT 9`iW"RXYؗBx`7S@֬~$P3ܠaI;^杊N){*]6NkGV¾󜾙B<zY^ĺP惟@ؗB#+m$⏶`Nf !`"0WOpEHv1} o6^-BJaga_ '3 L%,Lx ºn Ԭew )82KaR';l7S8wRz`(9R+kLJcܬmqtņ5S>BJaga_ %kg2,arO]`\꡻,S1D^j'Ȼߚk1[,02BQ0ZhU3B"UILQ_q,-K WGcrg"XZ+E֝^),,K oyK|AEWr8ycA=6K5S!8,LNh3 c*#+V+eQO+ Z~!2'Ov]rk-q9-Br9sLa>W RZ"PÏrdaX :QUժ;zIѢId8^-BJaga_ ֜3OV įx vÔ̭NvX& V6pHf"C^{Q`tNǔR5\2rfXsTη_P;L|39^!H4'NUre>z蹧\1TINMԩ*EUu'W_+m@R4vX. {Jm-?zݸ,f^O rG&7R'Rx/k~/7uA$Oȑox(`!p 7y6_`t8G5.BE2FN Y\EtDwJᢃ MFƾt pY1NLy~4J_pePK;d|hGj-e#Ou4$R›ANiIda(Z|T9$Ww 'eF)41Gȑ{\niC\GVg~\y4E %H9^N0֣~/ Rr"T`$.T~`2_h1KN/ $I[`qnP9_}),? ޒҜiҵDGA~)59RHqLԅ5 n*uz U\_SXA1z]#ʚI#5 S̤J___6iNehi*CDG)CH0c]tv=wK`(c+G[I$+^4ͽZvQՅd|,f(?BtEd>OP>/}),o6^Ng_ͷ=|橏ҿTU3}8eng ⨚მPyѴ 5f0 PC8TB]¾kɳ/x56*ɮm\{H."@Զ\MYjz/rAF+HvQm^9)D6^m:{a';:+VKprDHv1!mKDL!BJm`¾NXdUK#3E˘Amlt3c$4m,. bN\{),})1獙ffTWEWǦWj;RXYؗB9aLb"뮡+[/,-MTb~a'wFaNfg/z9+})LǻG._$!N׼og8JVPmgt5hr7߉&r߈A@7"NpP9~cabmп]pqi$VTz|v5_zH>r}%H5FC(f~Z)%L.dB6M+<-]<.02:Ǥ|IT@FXNOz ɣTM /LߋŦIF+\Y`5-'Wj;RXYؗB50Swh#:T5!l(E"`69ߝ˞ ҫ:*%/OnDIb A&KkTwH 9R5 9ILJ(&iEppEPmeCԞ lBs((+r0u^y.[sKx/k~/c+kr}tԯԀ'oA JmSC{-b_U))oe/#L^Eꍐ¾9^oȆfUR6r|eu367HkI%c.KPRS!i,Gz/Lj{9RBz92+sȁ^ ښuvlDuԑ:HpH5AD5LtwAr<,=5 hx敡3 ]յ_UƼFʓkߊ;W?z/9FM}W|+b}3xTrBrq> ֥w SwJ+Te'_0'N ϺW̲|2Cq֓|t:]J7#{/YT~9Xt_5GF 7JulόS*-ViRKzy 3P_s)@D4JkhjNW 8 RXq1G)9)RI5-6S6,q G$Rxk])|5dU 6L<9La^W<&ͣ>cC>:3Vrnp~hm&ۤJmu:g^1ߓ>jʰ9{ߠQ#W0U=dڴڱdD}-:ed>Ɩ+}), gqšsYގJmu:^ϯܙ?^UK32Atj;ꃛP%};S@WaZɍB;ıJaga_ k⁁/7SXsȡN*WjkK?͘Y%9F@5Atc W߆RaˌP?*ƏV]ktrr@/5oNqš|ChTG֬O}Yokk]T#*C_oB+uHgDg,唕Qoz/5HAdWw=A ~XWf r_@pRzl,Q(E>^oz/rAF+HvQm_:UB $ƶ5:Lr=+8,f٨pʳ,&Kd͓#B 90X}3N/ ^-t;RXYؗB9HM h^t$d/(.@My7o zYJaga_ #1*(эS=%íZ>@/$R;L-6<]9j/`ڎ:g1`HpАXn.˗IUr(" jXXA1jq%8&r/+oxW֟Jm?|rPO ),,Kr*ڠ/ r7WDy6%W.$a3m:-36}3c%i9XTz+5_ȭOv/\TvkF%d2ɡk;癜+IX|_STG=^v`B~~~wܫ-|Q6q3,ejAppLb9*/I\;uDVfX&692o0U_u+w'7FvgRBRI/D#'E *rqM5Wj3O?tW<"KbM OqH8ߗ—«d\Muf j$oa+1&ʓ+ }nXF2dl]T0~d6XD(,P#ؗjB`Hi)8=h\RC\ȚN!%VܰNo3V>qKx ih[\٧ϐCXy!16$+ {}7b> Śg8`iQ~ Q?%)!7"W9% 5S.hkԉ@(ObrfE`@ul`0쳈~s>9uiC]¾ 9 񐾙B_{߸7kXNa(?3H7bȡUSS˩>ɍya NWMs/S}ˣ%} $O.dx uW 8 Rb:GLLA{폿/_z_!\~I uh!![ $t#sF<jfWj/[`ڸ~k jΎ哷S#$/y4DY(_NYSrpau'W cT.TogGј 7$?΄lm5Np!GuT~MLAխ_Ow׋۪'}|b1KÍp[f}rIl^rewwwmm3{w;;kAJuUnJ/rF&ډWY\I)(ōK:,ʓ%ɸ-M'~IN&5jRsf u/n»>- j8vAz@9hFU͏ Q`,Gs0=::`,..ݵ_KO}"$6T¤ġ #~ *WYY(L({Zĵ$^Vfa<*Js%rh0D$Hm @Ma_ rxNLNO$WM9||JNۈeHN)z\rʱzNkR<;;{ԩk6(g?{׻޵C&X׷_JbhKd?yv&FP%պmkOi֕Bݗֈ-,փU[ -wiiiccbc??_xqqq:[1_S`2Wa&!h#E}Ms7Se߉(J''뫶f,//VP霜 jҔerU}@뫰@`_ !Gdraf w_{O3 pYkp,Zm+W ^Juuͬ}) *Ȫ 1dAj2>.]F0ϏbrSrbz.;j:qu̪2 L[ubo Zmgfft{)Ҡq t;k@c`_ #1jT̴zLI+u 3)WTC*:b"l2ྀ `vqqq{{[.?99t:~-΂ughKaX<%>r 9ʒ% ߁)02P^#O'P\CU5!e}_ry֖PxKP W[Ɣr*ڠ/ H +㕶ŵJ 9x]wgЬƬ&,/=P@9M*7g9ktx>rvRfRF_̧j IA~LOO|8#˝³>W"yNNN(x^C^Mۭ`a(8]a5fw]8s&V%ˑjg6_=LR G-'er aofus w9j{pp0;;;??tt4ǑYmx[_׾HOO~vCWUhHl\׆;9V b8:xCa9 Wь\љ1J!haO*7?\qQ|Q~ȑ6I(3\jKY;=>>&j4qxF8%n-N7Ƨ0.VVV7$f_=ű Om<{0ޠ߅z9C ɹګ0p:ĸ(9h֬>RgB ¸kTkD#h'T(ءOOFU--^jMƆkqqwq^Zy&9t/S\sMHɑ.//q@Q\x(<534_fŒk/ܤ7CFQL cOoIe0x._ (ϦDMb;I+vN )wߵξ5] EtOP+j huQ۰ '|*'װ`IEk<Nq]wnN^m$ `2m3W?+HhvIrS:;uDVxlvd^V#W#$`v;NN8*.NTsqee6~Rd9yA|a.xP16CSoc A#KI<ǕWWV3cU| # I %r]_s:MS\ɾK yg+WxB8>|+$RǦÖB8BM$P~K@p:[[[l&[ ;]6j]oNa=a?f1.C'/ss=߈_*X*JB,RB)`.%uW:䳶8sr& Bs^k&w{{{qqb{ .H>)h c!qtw) :ك7>.KR!Wu9\?aqL m~jfe>.-(%u[:䳒{733S3w"∿ŎKV:uʑMԻ*[`N_9AߥTK_:{>6ZB7rdP![ȒXMKktMmC}{{vCAxfoor/+ۡbKo5իWaٰ@9]]ʆAܻ߱s\ W#N#&NO>ؖ^o:333. Hr.T=;ypnY[M* H L` ߥO}"$6TFc3V P?v G'jA"i h.yCA7Ғ(qTOtryE!??QT٤8Ra!y` xQv#L.d"[N0A@iZ~:aM'~ 6O:eUCV ޞ!89V FGRͼm9.;<~#P']4:sR"_&.[O*7lSrP$yo7668yb(KrvuC)26y9!qh֬>RgB ɲnn9 jm -5*ߖ"N^,}),..SZ@`_ !Gu\{&mX,f/}ڏ?ca:a.1FAлg4JgS_Bu^:̐TrZƆLIÈv5\g7 =&/g92ܲh>j _p9s*4@Sar97lll[YҼLCySTWn XPr㈉>ypB7EU_r XDrX&;r8::"wff^_KEג:==]q2`u}o!DzٱPU!B) +6Bω~O 2X=Eՠ]١{fP2FK7/ '9( MC&>e BrdReDea@892IpRC"H&ಏHԇn=;C}!ʫϙQ!PSY(J9;;;lnH=P`tq qvv+\GefP{{{9?,L'߳>!.c+kr}t(h]$V0G&UFT9޷]`=݈VzФX{{rrgi{9RBz92̫r8>>^^^nRT6EUf##(ȤsRu}o/ߌU)c9GAi= Xa:]J7#{/{u Zc9ȁVՀ*QU!trrv+03,FiTުj*fr3Vz9 LP2X%FiQ+cdƪF>94KKKȤ7# ف:V 9*sC &e嫗pcPA2&@ø:ZV#(2WW r[f UNQa]i Q Xp=0Zpʱ.Bp ~n///#;|2TҼ.B:a۫IEggg1Ĩx(ΩjU6Ib˰!9:ٱݐ)BUyj8`erxN`{{{l *'|`nۍ/rL ,8 ީS/< mA9`ɏ .AW , !z9z9ZMOOë+(mjaqqq{{v+jY,8BωDIE!ܑB`˷kp!Ghu}o!Dի. KXY][Q{lll,//n`'v_Y}?kǿ+!V 4 فJ"( VF!=F}e"R;==Lbak3=GzVV*.8޸!s}wOPfggh{j[lҍ loo/..nEC@1*ف} |}o/ONMu7::[ҹLu ݩӽñaK$Hmjgj?&r@8>>3A5E.BAnc`=vk`z 94`;ȃZHb0ʏ򸆝0&,Ft~x/ N0>&9$7U&^0 !vU! !GI@`=so?M;/y$sL.pN.{ k7#z*Sql HB$`Cж8Hq9 '1fٰ;=eO>QZ-ۭh&<}or\{߸7kN!aHz'!) OG.D=.QL!UC*zr0#'B333KKKH.  W^v+ d p=Co>Kow|w<ۿD*!&m)@rHaSgԙ;è0ZIoUārH۪Bm\Bh0)@&U8EU89}or[ލUՂ0Д(Gfk^;7%l: BUU!666ZxzYR:a_u!ǿ :@*k}iֽ>vUSjaͫr0p8m5LQ/!ѿʼԐc9'@9Ȥv [G*}օSRQw%E%3Ve 9 dAIupp`-U!< /-ʪX=ZRJb(d0RL1??c Sh V0== \P{{ 9y`eXX|W-9Ie +++[0_ѡW :V͇}oQ!(I]q-8I!h@1E Y1.l߷ _Ev+þר9@v"?vC|Ez.t+yAt:{{{[<4=!SΒ-ܙ./U / }o!D!]YY!/TN>]%UN̓}o!D`}Vpg:pۭ[17P{{9<'Bs}vvv~~Tvvm}=@a ., 4Cd;`͔Ҫ9^ԋ9oqrrfR!:)sduG˲Eۭ:0$rR߉s/,(^C[Ԍ9?7==3\.B Eq/P {{㮽_t"m(*;̂!:ܲꕿ+jI툐 v r(pGG~?;;k^QP,{{/'.~aڠ uP;Lgy N ">J'.MWaÉ$wiIݮZ-,8\]!r }oOrywrш_*`)\1|=6ݙ%v#>9arpQuSj[b;~@:PA$WVVl"8b\zuzzv+,ޞ.xὝsϝFGR6>>K\TsΐL熒vdt0SpͿXj @H,IM1 }oOro{rS xPrp.qurE=O" H 9Jk!X__'5333NɳloG@j2;;|? '._Ξg[T 9RCOߊ؎r@~jVVVIȅjN'PhXHY(pJe>w c羹FX8Rm3]I2[)џ|,G%-? AI5??OohdR z4.\s b0w:'S'ɥ Uz'd$E̐D-D#FC9cU5-r V˩I3 P~|Vw w:tk)@LB rTԒ!mh!Ylmm---ntq(133C:eyۭj ^B6 J7eZR3"1ȑujE9@}%iZ`0poji.,N[Z~uqZR/"ꎭik! W^AD/G*@%X<`\jr!P_\rXz"qE!ūu8,B2:Ƃ}o!Dc,//m~/G+++[l8 Bω[<źstqv+-H)b@FNz1Hl d⢃C%vwwlB tqD:Y d};ueeja e]ަv+9 r`ww img>^\XIY@NCoSdR.p lu㣇h@& HBNNN/Du$(ݵ ׁ^p\@ ŒVE!눭%ۭtF\zuzzv+1X0!@Ngf?nYF:uv+1@zGڇՊ%r A/idR(̸<]ca 7 OX`IEɕfb9N6;^C%k7Ȝ995`9GGGn O;D4Sp`jS,Gb)hێw¸RO| ):V!>brRԢt ./《ptt833=GzRwnrZŠ.㠋c2,..B[Y!^`fffii@v%]vkkv+\899t:ST 7@Uða^\\݊Zb-VyAFB Z>6uzrr2==.!Gc2@@@3N \󰿿?;;[Y766m@Q@6!MVVV62}.EGN hj(9hvvvZel*Yx.Cő~vvv+"0[ !888 d~~M.@H`@@A]Iyuzж[ȏWRf@+!9%"?٨jzGGG$ɜ@Tj:ciyܑN43335.k)8*l]eM~899Y[[kZH5ianHV@ h0H)ꨑjyMf0P 9yrJ5J]kA7f:Bj<:v;8 l}P!:9T%ۭ l>>uV6A9NgnnT@WW$Q ZO/HԸ~$ؒHT<99Y[[OljK:?x`3 9_.rHJ|Rj((#s qY`7@fA] f핕 |,~noo/..~Zo0 !.!GX>;Nyj!,~ZbO+ f!<e:rvş3Bw U*F D򹾾N~3+!pIqu5rV-„V¦䄻NkaP&$DήTi"Sb^)@9B50!!csw ~){]zV14(- tIժl127CWVV׋:[* !zG(Se{V>W"3iJ0HO].$N,9|*+UhA>!όrJ.TxW)QhY\ȡ9JQRW܇a HޮO]ySl+ԝ!cyV10(DB>!(xBNo=a!^~7|qFuoK}0@ ',dw|B-'3 $" @>-@Um{kWOTva 1!ZgjB>!ytt4==]Җ aK,RuYvAG> رt9jFeB>A9|+c f!,02rԌ0(˄|.s2<99i mv@,]&BtOeN&kt9jFeB>A9|t9jFeB>A9|v<@,]f!w/O/=ך0(:B\ %d5+[[[KKK%IXpD!Ҏ8?!Đ?Ml}i%$m܍TTKZ]q9c`V1\6(c [Q$V%]åʸ|t\hq-p,<::jZ mv Θhqod;$,pNfݢ ryݽy|{_>{~+>zhŸNJ¿.sdP-<BЦ6CP ('''Vի븰+Y}^բ+6q&ieuW›'9`HI/KTǩ2Bmr-_t.~wBޟ.K"SGG֝:zer~C*.66&N lwFd/lSUç8gB}=ȇ;iz dP+<큅asyyyccdv=3Z5$hBǶY(ʅ\%ޯEW+~#?wcox~,{ꏽH?_οg+?<wd#FX t8C!!,ՍURt+Ө3mz !lG`+r &JD` TD2Y OZȑQhU6+Wv;슷{fV/Z9g^7n;M}F vcX9B A0h9丌ĪR qu:8__9◾{+W>ܘ~(dН*مa*i\o"Byħk8kA)BTo0hV'usO}SriT#~i߃,T&4Z8#Uh''u/xgf JkzSgO1\tkS!-gtg翻熱ON~އn\󿞍ꏌ4DW 9Fܪn `PCQnw!E(0u: dy }R|˩2Bٯ=mǾvYF|Z6;蓮8?!ܐR*ZtP6u6P'KKK[[[KX]l]fBsF[܉VkƳXOt:E|%v,@,]fBL'2e<99iV6; `.!GL'2e\ `C`BX`e"aP@ ] vͅ8@,]&BtOe 9;;- xxY L5# 2!dskkkiiɖ 7DQ3 . X>Z-qo0 aA٠c8-}UQi !Zǐs~~~ggǖN7; a-" 9b6àdEB>mP>:-A ow$D4vChͪӽC$w{ӽB8ZV>e9.e |ڔ卍 [R:1 ,@Ymȡ3_'XPؐ4a(aA:!rcVI{+AhLg:!HBnmh@!Y N=Z 9FR'QS=塚{wmJ\{+~`NetB>Z["ow"jrO[!( & '1*F D!|Z,gN@!Y N=1#4t>uN<=` T'IIpV6XŨAh#3!xn9'&a3"|:!8k#"Q};ow{3of?|Aggfg~{;ｙWW?si|N l#g" E|"鼻x)]d`d9 ,٦j4[d`d9 ,Yv{gyG,*fa9r& Y'Gݥrb l#g" E|"{:ˁ-20YzqGJ`%dL  6a|N q ͨI+GTX'D sBoGd`dJtʗH(frb l#g" E|urr{qln_XTlrL$dOVW?_XTl[Y fOC!0|Q&v lX{vEF6kR˱elD濧EB!*fV'D[[Oml<:tY, lV2CRBT̠OgݻCˡ|5R٬)X˕҅XoN+}]sUL{P*foP KbdJF/w>Y6*N|&+ ob5+qõR)Z7,9#ۿ.xAWDk)]vf 5U48zJ kHtK__1<^#d:a)dTy^3۾P jVJLY֪ TR5]1ặgb.<;cZ7*MBc\lv}򚁃 Q0,5غ+7{7BÀ|'xr0P!־E2d',eJyXBgrYK4-̆"^PQ-GzWѯ,F{5h:Or|;=F?7ĄwCUC1h44/FeqU36j˕ʅZ8xW"[q?GB',e RQO\N3z=s'>C]mUVӟq[= U3hˡ ]4Wk %j[9ܼ~@ _-B%3?*g7-B4YCyY ~X,dzo9MQ-?%,쏝`9:p sbt5K_Kt>Y„2JTk:1 ;5t}z xv6|K6y|&LA]>tmN[ pmw?[ү.~XхX7\2ލ!mGYv#|[ȯ5f=PcOr|;WZ_k⣘[]y7NA2F!bB7zWhS;v„;*BeT߉;}ۨnm3b}X>G; hM95mkL6k*rD~s嘽p|B(G9!_ͪ7a*|7͗0+ў(Daƍ^ x2h7zc߹r+/}ELWLbJ^̦ưajMs%]t -i[DZPƈ L]flP{jgY} qUƶ{Z#>'ZAo?csr8/x#&M@ɜDf`3`F"V'kf9>xW߹~z˩"ۧ ]nh{{JZo u;oUW? XQ!5;i,T*#_t^bxha`dA+]ft,|ؒ~Cfmk _D%cŏ ,Sb-U>/NtPh{N6I6oo;Wb.=΄/*|o-DJ+s;wUVs|&AձjX6\sbK J)uaaKN(' QGVjˆuQOD/XEd# {66?ڄ{dyXَ דۋg;wzQ-Liv} v.'[d9MSrOVRVyrrBBIkeuX+Z:J~foű(f%eEd),(4 [4U>Vz[#LJkkkLi\͗VVO,G14 >f0*'Ce9Pr\Nxh(Д]X$+rb l#g 'fuޞ *PQ)i}}u{{}•`9PEF6 ˑ3JY[[+v$_m>˗{4rR9KKMٰ l#gPvwwhZY%巾(S~KLd~PjEG|Kr~:&_,X{EF6 ˑ3L(o 7V&7rTyS&ٱW?(5rh^*4b{:T%ѫ}58&3gMMF MB6HZQBcl#Njʳ{=X!*@$?ŦW'_(j5vwRpQˑXՖڣ?^b!5G%C5G:34xRP)k1xxԖĶ~s2qŔ2۽ ^ ҋ97Dzs'*1< QSWGS *;lsZ`C'ؒ~u60xen iD{R9xp T_VuO *d9>Bꝫ~r5Q-njkl\\rZ3:Պ鴷Ȼ>MFժT*Q&ѣ"vr/vʑ#17h󰭏^xfbKլ*p:|'.X=2_2Z]hgoў =a;NIA,o~ǮsW^z8_@}Ԯk塌qf)gѼr+Z9T:NVEEP8 ryq0iJNUCM%rFd 0c7?Ώ搎t#[No͑" nm=5p-H;-GNjmhk<fpxl x"'f9>xW߹~Cˌ.,giK4m",r[rDsppPT㭒 ;ڕ9ӧz͔fs_k .Ir$9쎩[uo#B, S1ҍT Qp}rދ8ųcw0~CjQ0>qKr"9}cqlFWͺNIA#[gn,v&&8GkӉ:= 1rۛ)&X3m}ކ;Hʇ=-yJZ=::(*B_yjhD<8;VLOJ3r/4/ 9Cz2g8#2SF{bհ" R1p0>'d1~n0OKv%FD!ꨭh_ˆr}Af^'Y#GwٟV lmmMZ7rE(ȱV^*,&\Kkka|Nm )ʪV!7EBlJR^\<9H8h9֪oORUp=9-Kx_3"D3K)cex4yBպQ>4R㦛Y2VHgmJs7++͗zprCdIU-GdIBtޭ/ 飣z_'ʝc[rb l#g0T,g-h:0>v.,#[P*,*fa9r&;G,;Y6@,8s#ASE2qcXBC32oJxhD7DHg[(f H ޙfGxh$uw88x=a9PEF6 q5@SVVތa >Y "\`t?6>yzUbҿ@*.2mzjc4N#,wr~O !qb9 .c'f^WL({p9x3RGx]d^v|SH(?{-Gҏu7JvJ'*L::j..MZkq=o&DGXsCqN([7>|峟FUL;ݻKKml<:Q%C^{odQ_64? Gsf9g|MBk*J'*LTʭ OLj*刓~ $ү4a9Q,%"|;=F?7ĄJ}knJ\?:}p+1ʴ$ i,VTK-ӽɎ_e[ff3 VZm^  6Ꝭ&Ŵ`H(`~xc!6@{0 [ru8_QgJ)*}Z}(Β *;pҽ$,f(!:R !P}Gx́nbf(2«/,\Wr VZ'ͦrΎJ3u."yƆ:1+kҖkO[#ʜ~*T{Tj/V|ͽAz8|0Mѫ]ҊNNn/-ݗ‹8 I6'[mH5bHSB w^ɵG13NBy^noon[9 `{&_bS.C3.饰jt7[[to뚍zϕ6x#ǧn;>TCkJ+*ªV}~bxckm~~pB\ `J(~X%G_Q̌Pћ>:j =b/5fj7]2ѻ`i--o!hŬ4aN(v^ u>J36"sh,'VZQPe sB~OMӤ߼l#%Dě_=\޾"&׫b eg~0tK{̌NUQK:d[^9#wg6Dv'5$Le?1r|j0űQ3B_VZQ]ΝŦ sBRHWJ_2LF8!Jb9 1L EӍ|Woo 1RP֗Vq|J荑 _ump4~=Ton_]Ph[3u- ^ë\^sk9Nuo+PS LUų{L *M̐~3IF8!J2#"=se<1[i >PX[{xmS&K]̰ =1yʘn+pupz|/'>'d9*a>7 -'D ёjyŐ eCT|0ZN)vK#k )J%*\e~gRND_ q6Z7dｽN{vIy^_I[T/ $^hR=Xa9 .6$nn2웡^6lqDR y=_Xˆaa9 .%/|oCZo6_|7"#倸XPZb~jEfCXwˁ.20YX E_#sQࡀݻ XrGˁ-20YX˙3)D"$,QYKT) q005>TZj'''YD aRn-@ C8<<[__zG C^=%^:> *ٞ %v qpz6> =_;\P4:hۻYL,DŽ6#zUΦS{_W~{z1za'9Ƶ[[Oml<sI?`/b(,rT*z[7>|峟FUL cKu=޷?҇W#r\^đoB.\.WN@DX}ި|C&O&ѝucڎJ A%>r8Jx3Zvfxs%W[I[ff Oʟlw¿7ЏKy g2u`u1>`9\ 30]]9r<+̐{^5wP#wjrzoczz[gz mN5xC+0ޒ~H{F"87K}r>`9,\ rRzG LC/T޹z'j_̘CW!V︇z(>VǕjm!8S9풞|0xu?xs%E&3h-99Oo~HQ w2br1"^WU9rGc[]G13!B|_5x=N 3.5uKxƟB^++;4f ]A(r1.U:uZ?xͯw\Ko_U13!rXmՉCǸtmY}7᷸BӧY^Oi^iu'ћ'\ УZ|aBn:N^/ [)7;v^_p?  7ɗ@%$l9MV{rrK-h֣R4A+X!ƙ3g*"XZ-0ש)s&E|ҫ˙>+++fsU-,,o&X +RMp8cs`9 UMz>zԑ۲ 50x|Uzw :CؼzC d_̈́vƤ@Ps׺CA00q;D8pgc7qӸ 50)r1|O=$0xir@lnn-M qTfY.ǵFTkǘoHj$X a-VVV:88XZZՙ[;R}0_ًZKm_x2&L4䂕Fә3^[%`+bʅZbܨfuzK i>FB7\. `9hКP:2bZi陁ǚe",4Kz>$aN?8D688hܱ-[f <Pv–looˏq-I^iU}Zl97}5J-Fݢ4!|, ,b!Β݋O'n gboijjjƗz+y>>!f`x 淌07ColU͗ŜQrM@ 7Xk ,r Za9@Bya <|VXP@rX+,H( `9$ori9/W݉dWk <|K1%+<|ة$ǁ9n-٨k4.ȹFLk?-V9uV.gq-lL_gNB0ҀM*CjH@Vk;Nk,Ǎsrbu L]1ӝ٥r@P@Irh:,{~r.EmqGN7NI W 7)Y~;ք6 iw Lhvt"XH 7EnplCqo::ՑDBy&a,ǸCY1Eqk40b9 ]( XĪٸ!c0.†o?<._rCN[ZNpXMغ+7broHe[ c,<⣡..TyqNb|󛍊l=Upo:SWw};0mLB.Z]_,D@yd9}Gx́nbfޫ@N?3HoD[w5xsE_6& 4s,9\ަ`r|;WZ_k⣘in7 7wvUS֩Ҹ1ʝYt(( ߘ,ǽ_{7֟uEW|3}joP?b|VU5ɴeGQà<|cO7Εo_y+b|*fkrmY_7,9tild9VN+䛈n java-design-patterns-1.16.0/event-aggregator/etc/event-aggregator.urm.puml000066400000000000000000000034021312550536300266050ustar00rootroot00000000000000@startuml package com.iluwatar.event.aggregator { class App { + App() + main(args : String[]) {static} } enum Event { + STARK_SIGHTED {static} + TRAITOR_DETECTED {static} + WARSHIPS_APPROACHING {static} - description : String + toString() : String + valueOf(name : String) : Event {static} + values() : Event[] {static} } abstract class EventEmitter { - observers : List + EventEmitter() + EventEmitter(obs : EventObserver) # notifyObservers(e : Event) + registerObserver(obs : EventObserver) + timePasses(Weekday) {abstract} } interface EventObserver { + onEvent(Event) {abstract} } class KingJoffrey { - LOGGER : Logger {static} + KingJoffrey() + onEvent(e : Event) } class KingsHand { + KingsHand() + KingsHand(obs : EventObserver) + onEvent(e : Event) + timePasses(day : Weekday) } class LordBaelish { + LordBaelish() + LordBaelish(obs : EventObserver) + timePasses(day : Weekday) } class LordVarys { + LordVarys() + LordVarys(obs : EventObserver) + timePasses(day : Weekday) } class Scout { + Scout() + Scout(obs : EventObserver) + timePasses(day : Weekday) } enum Weekday { + FRIDAY {static} + MONDAY {static} + SATURDAY {static} + SUNDAY {static} + THURSDAY {static} + TUESDAY {static} + WEDNESDAY {static} - description : String + toString() : String + valueOf(name : String) : Weekday {static} + values() : Weekday[] {static} } } EventEmitter --> "-observers" EventObserver KingJoffrey ..|> EventObserver KingsHand ..|> EventObserver KingsHand --|> EventEmitter LordBaelish --|> EventEmitter LordVarys --|> EventEmitter Scout --|> EventEmitter @endumljava-design-patterns-1.16.0/event-aggregator/pom.xml000066400000000000000000000035101312550536300224050ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 event-aggregator junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/event-aggregator/src/000077500000000000000000000000001312550536300216605ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/000077500000000000000000000000001312550536300226045ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/000077500000000000000000000000001312550536300235255ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/000077500000000000000000000000001312550536300243035ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300261335ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/000077500000000000000000000000001312550536300272545ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/000077500000000000000000000000001312550536300313765ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java000066400000000000000000000047271312550536300327730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import java.util.ArrayList; import java.util.List; /** * * A system with lots of objects can lead to complexities when a client wants to subscribe to * events. The client has to find and register for each object individually, if each object has * multiple events then each event requires a separate subscription. *

* An Event Aggregator acts as a single source of events for many objects. It registers for all the * events of the many objects allowing clients to register with just the aggregator. *

* In the example {@link LordBaelish}, {@link LordVarys} and {@link Scout} deliver events to * {@link KingsHand}. {@link KingsHand}, the event aggregator, then delivers the events to * {@link KingJoffrey}. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { KingJoffrey kingJoffrey = new KingJoffrey(); KingsHand kingsHand = new KingsHand(kingJoffrey); List emitters = new ArrayList<>(); emitters.add(kingsHand); emitters.add(new LordBaelish(kingsHand)); emitters.add(new LordVarys(kingsHand)); emitters.add(new Scout(kingsHand)); for (Weekday day : Weekday.values()) { for (EventEmitter emitter : emitters) { emitter.timePasses(day); } } } } java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java000066400000000000000000000027721312550536300333320ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * Event enumeration. * */ public enum Event { STARK_SIGHTED("Stark sighted"), WARSHIPS_APPROACHING("Warships approaching"), TRAITOR_DETECTED( "Traitor detected"); private String description; Event(String description) { this.description = description; } public String toString() { return description; } } EventEmitter.java000066400000000000000000000034331312550536300346000ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import java.util.LinkedList; import java.util.List; /** * * EventEmitter is the base class for event producers that can be observed. * */ public abstract class EventEmitter { private List observers; public EventEmitter() { observers = new LinkedList<>(); } public EventEmitter(EventObserver obs) { this(); registerObserver(obs); } public final void registerObserver(EventObserver obs) { observers.add(obs); } protected void notifyObservers(Event e) { for (EventObserver obs : observers) { obs.onEvent(e); } } public abstract void timePasses(Weekday day); } EventObserver.java000066400000000000000000000024371312550536300347610ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * Observers of events implement this interface. * */ public interface EventObserver { void onEvent(Event e); } KingJoffrey.java000066400000000000000000000030471312550536300344030ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * KingJoffrey observes events from {@link KingsHand}. * */ public class KingJoffrey implements EventObserver { private static final Logger LOGGER = LoggerFactory.getLogger(KingJoffrey.class); @Override public void onEvent(Event e) { LOGGER.info("Received event from the King's Hand: {}", e.toString()); } } KingsHand.java000066400000000000000000000031001312550536300340220ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * KingsHand observes events from multiple sources and delivers them to listeners. * */ public class KingsHand extends EventEmitter implements EventObserver { public KingsHand() { super(); } public KingsHand(EventObserver obs) { super(obs); } @Override public void onEvent(Event e) { notifyObservers(e); } @Override public void timePasses(Weekday day) { // NOP } } LordBaelish.java000066400000000000000000000027751312550536300343650ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * LordBaelish produces events. * */ public class LordBaelish extends EventEmitter { public LordBaelish() { super(); } public LordBaelish(EventObserver obs) { super(obs); } @Override public void timePasses(Weekday day) { if (day.equals(Weekday.FRIDAY)) { notifyObservers(Event.STARK_SIGHTED); } } } LordVarys.java000066400000000000000000000027721312550536300341170ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * LordVarys produces events. * */ public class LordVarys extends EventEmitter { public LordVarys() { super(); } public LordVarys(EventObserver obs) { super(obs); } @Override public void timePasses(Weekday day) { if (day.equals(Weekday.SATURDAY)) { notifyObservers(Event.TRAITOR_DETECTED); } } } java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java000066400000000000000000000027551312550536300333470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * Scout produces events. * */ public class Scout extends EventEmitter { public Scout() { super(); } public Scout(EventObserver obs) { super(obs); } @Override public void timePasses(Weekday day) { if (day.equals(Weekday.TUESDAY)) { notifyObservers(Event.WARSHIPS_APPROACHING); } } } Weekday.java000066400000000000000000000030311312550536300335500ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/main/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * * Weekday enumeration * */ public enum Weekday { MONDAY("Monday"), TUESDAY("Tuesday"), WEDNESDAY("Wednesday"), THURSDAY("Thursday"), FRIDAY( "Friday"), SATURDAY("Saturday"), SUNDAY("Sunday"); private String description; Weekday(String description) { this.description = description; } public String toString() { return description; } } java-design-patterns-1.16.0/event-aggregator/src/test/000077500000000000000000000000001312550536300226375ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/000077500000000000000000000000001312550536300235605ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/000077500000000000000000000000001312550536300243365ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300261665ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/000077500000000000000000000000001312550536300273075ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/000077500000000000000000000000001312550536300314315ustar00rootroot00000000000000AppTest.java000066400000000000000000000025051312550536300335770ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } EventEmitterTest.java000066400000000000000000000135301312550536300354720ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; import java.util.Objects; import java.util.function.Function; import java.util.function.Supplier; import org.junit.Test; /** * Date: 12/12/15 - 10:58 PM * Tests for Event Emitter * @param Type of Event Emitter * @author Jeroen Meulemeester */ public abstract class EventEmitterTest { /** * Factory used to create a new instance of the test object with a default observer */ private final Function factoryWithDefaultObserver; /** * Factory used to create a new instance of the test object without passing a default observer */ private final Supplier factoryWithoutDefaultObserver; /** * The day of the week an event is expected */ private final Weekday specialDay; /** * The expected event, emitted on the special day */ private final Event event; /** * Create a new event emitter test, using the given test object factories, special day and event */ EventEmitterTest(final Weekday specialDay, final Event event, final Function factoryWithDefaultObserver, final Supplier factoryWithoutDefaultObserver) { this.specialDay = specialDay; this.event = event; this.factoryWithDefaultObserver = Objects.requireNonNull(factoryWithDefaultObserver); this.factoryWithoutDefaultObserver = Objects.requireNonNull(factoryWithoutDefaultObserver); } /** * Go over every day of the month, and check if the event is emitted on the given day. This test * is executed twice, once without a default emitter and once with */ @Test public void testAllDays() { testAllDaysWithoutDefaultObserver(specialDay, event); testAllDaysWithDefaultObserver(specialDay, event); } /** * Pass each week of the day, day by day to the event emitter and verify of the given observers * received the correct event on the special day. * * @param specialDay The special day on which an event is emitted * @param event The expected event emitted by the test object * @param emitter The event emitter * @param observers The registered observer mocks */ private void testAllDays(final Weekday specialDay, final Event event, final E emitter, final EventObserver... observers) { for (final Weekday weekday : Weekday.values()) { // Pass each week of the day, day by day to the event emitter emitter.timePasses(weekday); if (weekday == specialDay) { // On a special day, every observer should have received the event for (final EventObserver observer : observers) { verify(observer, times(1)).onEvent(eq(event)); } } else { // On any other normal day, the observers should have received nothing at all verifyZeroInteractions(observers); } } // The observers should not have received any additional events after the week verifyNoMoreInteractions(observers); } /** * Go over every day of the month, and check if the event is emitted on the given day. Use an * event emitter without a default observer * * @param specialDay The special day on which an event is emitted * @param event The expected event emitted by the test object */ private void testAllDaysWithoutDefaultObserver(final Weekday specialDay, final Event event) { final EventObserver observer1 = mock(EventObserver.class); final EventObserver observer2 = mock(EventObserver.class); final E emitter = this.factoryWithoutDefaultObserver.get(); emitter.registerObserver(observer1); emitter.registerObserver(observer2); testAllDays(specialDay, event, emitter, observer1, observer2); } /** * Go over every day of the month, and check if the event is emitted on the given day. * * @param specialDay The special day on which an event is emitted * @param event The expected event emitted by the test object */ private void testAllDaysWithDefaultObserver(final Weekday specialDay, final Event event) { final EventObserver defaultObserver = mock(EventObserver.class); final EventObserver observer1 = mock(EventObserver.class); final EventObserver observer2 = mock(EventObserver.class); final E emitter = this.factoryWithDefaultObserver.apply(defaultObserver); emitter.registerObserver(observer1); emitter.registerObserver(observer2); testAllDays(specialDay, event, emitter, defaultObserver, observer1, observer2); } } EventTest.java000066400000000000000000000032401312550536300341350ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; /** * Date: 12/12/15 - 2:52 PM * * @author Jeroen Meulemeester */ public class EventTest { /** * Verify if every event has a non-null, non-empty description */ @Test public void testToString() { for (final Event event : Event.values()) { final String toString = event.toString(); assertNotNull(toString); assertFalse(toString.trim().isEmpty()); } } }KingJoffreyTest.java000066400000000000000000000055501312550536300352770ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertEquals; /** * Date: 12/12/15 - 3:04 PM * * @author Jeroen Meulemeester */ public class KingJoffreyTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(KingJoffrey.class); } @After public void tearDown() { appender.stop(); } /** * Test if {@link KingJoffrey} tells us what event he received */ @Test public void testOnEvent() { final KingJoffrey kingJoffrey = new KingJoffrey(); for (int i = 0; i < Event.values().length; ++i) { assertEquals(i, appender.getLogSize()); Event event = Event.values()[i]; kingJoffrey.onEvent(event); final String expectedMessage = "Received event from the King's Hand: " + event.toString(); assertEquals(expectedMessage, appender.getLastMessage()); assertEquals(i + 1, appender.getLogSize()); } } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } public int getLogSize() { return log.size(); } } } KingsHandTest.java000066400000000000000000000050431312550536300347250ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import org.junit.Test; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyZeroInteractions; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/12/15 - 10:57 AM * * @author Jeroen Meulemeester */ public class KingsHandTest extends EventEmitterTest { /** * Create a new test instance, using the correct object factory */ public KingsHandTest() { super(null, null, KingsHand::new, KingsHand::new); } /** * The {@link KingsHand} is both an {@link EventEmitter} as an {@link EventObserver} so verify if every * event received is passed up to it's superior, in most cases {@link KingJoffrey} but now just a * mocked observer. */ @Test public void testPassThrough() throws Exception { final EventObserver observer = mock(EventObserver.class); final KingsHand kingsHand = new KingsHand(observer); // The kings hand should not pass any events before he received one verifyZeroInteractions(observer); // Verify if each event is passed on to the observer, nothing less, nothing more. for (final Event event : Event.values()) { kingsHand.onEvent(event); verify(observer, times(1)).onEvent(eq(event)); verifyNoMoreInteractions(observer); } } }LordBaelishTest.java000066400000000000000000000027631312550536300352550ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * Date: 12/12/15 - 10:57 AM * * @author Jeroen Meulemeester */ public class LordBaelishTest extends EventEmitterTest { /** * Create a new test instance, using the correct object factory */ public LordBaelishTest() { super(Weekday.FRIDAY, Event.STARK_SIGHTED, LordBaelish::new, LordBaelish::new); } }LordVarysTest.java000066400000000000000000000027561312550536300350140ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * Date: 12/12/15 - 10:57 AM * * @author Jeroen Meulemeester */ public class LordVarysTest extends EventEmitterTest { /** * Create a new test instance, using the correct object factory */ public LordVarysTest() { super(Weekday.SATURDAY, Event.TRAITOR_DETECTED, LordVarys::new, LordVarys::new); } }ScoutTest.java000066400000000000000000000027351312550536300341610ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; /** * Date: 12/12/15 - 10:57 AM * * @author Jeroen Meulemeester */ public class ScoutTest extends EventEmitterTest { /** * Create a new test instance, using the correct object factory */ public ScoutTest() { super(Weekday.TUESDAY, Event.WARSHIPS_APPROACHING, Scout::new, Scout::new); } }WeekdayTest.java000066400000000000000000000031751312550536300344540ustar00rootroot00000000000000java-design-patterns-1.16.0/event-aggregator/src/test/java/com/iluwatar/event/aggregator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.aggregator; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/12/15 - 2:12 PM * * @author Jeroen Meulemeester */ public class WeekdayTest { @Test public void testToString() throws Exception { for (final Weekday weekday : Weekday.values()) { final String toString = weekday.toString(); assertNotNull(toString); assertEquals(weekday.name(), toString.toUpperCase()); } } }java-design-patterns-1.16.0/event-asynchronous/000077500000000000000000000000001312550536300215025ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/README.md000066400000000000000000000023551312550536300227660ustar00rootroot00000000000000--- layout: pattern title: Event-based Asynchronous folder: event-asynchronous permalink: /patterns/event-asynchronous/ categories: Concurrency tags: - difficulty-intermediate - performance - Java --- ## Intent The Event-based Asynchronous Pattern makes available the advantages of multithreaded applications while hiding many of the complex issues inherent in multithreaded design. Using a class that supports this pattern can allow you to: 1. Perform time-consuming tasks, such as downloads and database operations, "in the background," without interrupting your application. 2. Execute multiple operations simultaneously, receiving notifications when each completes. 3. Wait for resources to become available without stopping ("hanging") your application. 4. Communicate with pending asynchronous operations using the familiar events-and-delegates model. ![alt text](./etc/event-asynchronous.png "Event-based Asynchronous") ## Applicability Use the Event-based Asynchronous pattern(s) when * Time-consuming tasks are needed to run in the background without disrupting the current application. ## Credits * [Event-based Asynchronous Pattern Overview](https://msdn.microsoft.com/en-us/library/wewwczdw%28v=vs.110%29.aspx?f=255&MSPPError=-2147217396) java-design-patterns-1.16.0/event-asynchronous/etc/000077500000000000000000000000001312550536300222555ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/etc/event-asynchronous.png000066400000000000000000000752651312550536300266540ustar00rootroot00000000000000PNG  IHDRv}z|IDATx{\};nj)@qx4N [yLA cIG (ѦĜJHS&& T4eAWJyL)XҠ,J*BmN4lsڏٳ{ڿc01 ``Zöm?=6#.DPM7.mB=5ګzG|jBm!4Χvi]*vI|jBm!4Χvi]*vI|jB7GÕѤ&xp)7V&B0}yވkjjh%9*Z]U̡ @uTJN{n 74#T ~o_m\]":vB7Ђ' A@0Y'aa؁A$1Q;O,t s!SDj1Ն'qn\`e4ŕy 5r֡vC.-{P8x#m02[Dp4pl'=|G"$TnǵHjv Q] ~hmſ0$~#Y>K,C1u%$mqJcDF =K{$68!q0ܨv_[͊iNQ,RREIﺮu]*Y-鳾m"E0M `K#7K߈zT壴=pw 7jzn}9E.%㷓ĚΩxn,vm~<~'@¦Vp{H&2#^>my! w"GHB2 ,i}:BXdsfIcdUQh"$A}b^v]B"Y;<$cФvAM)m 88+ a;QT!"$A=uLnN.BHlsЏbϼ@ @.B3/PDŽFDP!Ķ8+ a;QT!"$>JnN.Ɛλx~-Ϭ}vSl=_U]"$A=BS w[}[vnߝ_ŶSU5G.+}ߗxPb÷_[-"$A=B0ܕ=ǿJl=bQTHC&zѯw~0~G"p_ySN?&$A=B0H{?_>ʳ~CmG=w08wϧ3^E.49$jz݋9)^s7U[蘶sТb, w<>]{~ѱxW ʺ Z`AM}}w/QxӯuW'G/~w>e~?-giqx _ܫD7~ G=B0';Ά ?|,$҄s[ #Xp L:&pƆDS7u|MO~·?ȿ7/yn8t -4Z#$[!B43C tϮ3 w'>PxggK=}m_ gLm.a%d)j ilH4u;>{T\_]7=yGw ٗ/g[='mᖟIn63O n|B՞{b;4ܟBv V |vX)1nؐhW_|c}Q\<7;F}c +8L>U~ 3[Y 4:ν{v}e_ ܙ?bϼNOtҬ&}TNfRn:/K&7+z+m'u۹65nb?d;˞!{&EOzNԚp% =S}-g&Ý")ۄI we[|`7=b{.j ixHw/~ԧw<~F3Li~v#ꆖc@?6"6Kkv {Jڲc1ܳ{ou(~U @4?$|,w^| @ZcV̳Sf|$o~{c1ܳAvQT!"$A~v:/BL>Yߠw009JJp"p?-ܦc1ܳAvQT!"$A~v:/BL>z :vҜڵ~\{f[S;Öi͚Dn٠vi]*vb_v΋0\ 3t(M4If)R'{5ezU6Kͻ,% UÍ܉Bm!qj/ NSڶ&T'FDP!Ķ8M(L\qs\FDP!ՅpuVvxy?"$NT4.oS|1Y$YÍZ~P..-F Q7M0ϗ6$2lxx5cLf1IFt"exjoE^ /g5Y&p(DIɜhQo) 2K'U.XnRpSP)$@'߉A(xO2YFRIo8 Db\fx2DegL?e}iJ؟ȉ/3#AַW`QKRMBwҐ(^=qi?!Q:ӯѪ _-ReOjG Jڕ)gԚ0`|j 3Ծ4_eX5.8nRpSPY f"q|S~$묡C۟A\RF#BVHhzʄߒ2!뫶^!qa0ܨjvv=YzYCb\ _ms^H,O#X -='ERzEbu.҇)=rk?:W=%[kQNpSPN85:!q:T+JO۳rp#^|]*+8!qR왹374~oߔ۬vĶ8(ʙs7om @.B43sC;gnWnN.BHlsЌb ^a;9]m@,(:`@HliJgМw~Sn34.TF0:[D?>>`݅} UgnWnjvQ :a)mW7ʡc(MU fnWnnAB!Ae CioQCG-5D0:1{Ra;aQC 3KiΟ\ڿ1yRa;am2W+G RӑFeK7NҾOV_ 6jQnCǴ0#MAmA6-p4|xW5)_C-Zv:'-E@MRHѠ-mj{lCiǫh51ړVS+/Wkbcj4Rys0FՍrfyfSo ޴H0MږlK#eu)$ vH6b7ZSo҃w}/z/daъNgաOcҨ_S-R7ʡcInN2ܱ{ߤJOn 4 Bw 0ܖHsw d~n}/_z6)RԒŽAG(uS06=߄1  IN>lic?6@ dOe5!&-ܶlEd<><#o4>"^J2iTnNIƞ <:MA!IZ3aQC U?{^ڷC)Q{'cm!V`)uBG-U w~J曓K&pF'=M:ڡc=yظ)QRB9l8yRupC?yI+%[| BPn;1!^ZƼƦIa*Qkg ozm*ONAe>Ad˾L>gM?P-.3$?ml\jDjYD>Uc]du,3iy{-Vqh8YĺjCG}V w!ǠYҶ11N\D'D–/F 5A$'(֓7uV1 fD-sOp ̐P6۳D3eJ"c|}ﭿ>y^;ίb[B5AK̵Ԥ-5ٱ=ՖZXKI̹&6邴RAŪ!$]pga.1$_),a5e˔Х$9.$9~OGpb_7$ 7j)Iu!,u%íY5bNʿCe A)JGu)&KBbp~|g/ʟb؟zn/r-I˒T7~V,粅FM0cOjy ~Av6yҼ ʤ < Ilw%4h_fM0Q.5zZC̯K_,g"&PG t!mio;kwL{~ѱxWQˀ#]Im@^9* )A%T?~3Bb#8/%Za,9}jYg;m4"+Mb_h\ӠevM &}Nٞkyi,ۼZSؾ^$O5P9 _LM3'?.iw_{kH )mθےHjNQӯㆥ؇zJӈq} t停YZOZ>Q3SJvSf2jGTm94;tLV/3}YwF.V8gь21T,{$kFi6LmZ5;ɞĀ Íܩi';Ά sx_ 4!V-_j= Օ[A [ fIIsxxyRyS67nDQ7KtaTɆ0/6'e31ឃb_fKc1ہ9fUK7¢,_ *ODS =|c/ܱBaggK=}m_njmҲcNo r$,ív S:PKqaThyھ؜3KIՍr蘬b_f~.VFbUš~14ۉ:тfIC}vc <.%p#wj~sk}[i0_yOlS;_(­t $ԑkD 1J R%s\@DQCۼ<-_lqfEdfR׃.K#?ǰ#{$Ys7Oڐn()E'}%Փ2uƢTvߴHѢlUMiki;{I-c^mޠɼ(f@ 7r&Ldt{km/p̟mGhg^ܐ'p[siǪ^v whkTeyھ”*/hKÝ#WlseԦT6Z!& >}zmmQ1j~'̯3L؅F4W?Kg~[oHٿvN[zLlyxGއ;s>ņ;j}V^(=جM*)h"|Kؘ{WƒOAj>61ngSҠ{Z<$߲]2~ZnФ;J7FRWq:> (h!u:&<}BZmfN4:bɷ]Oؾ[F}/Ӟ-I JKWcedX_kJReZm9tDIKMzƷ}d*Ԓ wUJ(p4d5b? `p3[1(x3o1ϓ^B{`QN ww !iH~nT@ Íܩ[j$^CabW$np.^G~VnJ>8krUjXm)@[1@Yyi0Ҵ/qI( $]%ʡ첳wж-7rW1i+Cy?kuhziF2 ;뫶^Rm׌Qp7}Bڋ#~tivǃ9p#wj.=Z wڌWj4q70q?I 42>FriZv[{ik߼Y.Ȅla 1}T4N w8aN0ȝZ`Exd&p3?ZUY bN40ȝ0-&ٜZup3?Z+T&&'nbN40ȝ0ܨ!f~\9ԧL15YnNnup3?Z[ԍrpn[KBnJ{ՍrEL3"h6cp%#9^ ~!.K:,zgJے`$&Q+4pN~ϟ>a&&'xޜtSUa< :`s OǣWHc鱂FAѱ g`\}!A(Q7F9tLN/>A,A'wfWHӜNq_6ׂ\oxĊ筄OMASKSj^|vb{eCpFvu:&6}BjU3"$ұXC(쨍/<4;mȳ=4ҔAaYx0(YK2D;  ÍnJ{Սr蘬b_f4}74+!PHH}cq_ú,yi6JL`q,}v搘~oOvaQC CioQUL`&3+s` ;J͑ᶾk;K6#k`~Qgga;aQC CioQUL` wd̈t#JՕ6M`GiFY.mif!0cL2Dw>KۅF Q7΄_U19žhiF},` áy-FKmФF/Z2S>jNW?{զ*sHߛ~. 7jatK{h W7ʡc}}'D1D0ȝ:`y""dO73( QhY`.3&B(p 8}tnm+XM@ NWǔdf/l.X!cE3GZO'ˍ8w2k񈜷$Ý׌6n>hY`.3&B(p >ú/,Wf6<&UpX7!aX3|aچ|<8]yXr —چ UgM*/iu:ÍZ* w#vu]wUʕ+u_N/).p.y Yp&>;k(K3n ?p]2PatrGhW` g}Lu:ÍZ* w#8s̞={ƾ}?^崘 fR2lԖI ՗!HXek ZMںdJsMYKKkCwUϏƄ_ի1nRa]67^xqu_N>sPF٤c,ZXw'LZ-hʧRRfd޺HG_^j7k_U1nRa'IOr׿^R{q槫KT6nGՍr=j0s/yX@}n]^^"V- Fvu:fb_2Wft1uƧҪP$0fΪJӅ̖NYgᮟ;v˗nZ,*nJ{ՍrbL~ޫM^ravh+9:h:0ܰDz/^zQ7F9tLN/Xݬhex8He깲V:ӗNKӡ)5K/fG_,-ZG,ڬɤ̦K^3pѣG<:@y at(mW7ʡc}͌1\Vj? <<4YSf˱.\%}g]GN&+u:# wXH^re֭,>XTF0:1YžfN!:uTSI+YB|eű2N܌<4.YuĬ ex )0urҥm۶Yϟw|= ʨFvu:&ϴY@%ވI^ sJ wbY.%e>Xj )0urGZJز'ErRwQ`g'϶2W&񝒹]`:XP[̾@ICY:mj39KҤD؛F6su)͟.%n\9뮫a\vgɟɺ/d~[#6YMY+1E4_AgpAN/\,{e (Rb]m-aEh TdMQ6Ն`g1Ԝ~Ma/u +W??p j!pϏL,=k{gpA~_fY9-0 n:ϥKք>z[˺/j~tgٶmMqJZFo *l 'X<}浞,ឃe?).tVV]٢ fsssǎ˜>}Z<p8ܷo뾴Ifo~A]<̏1֩ʹޜFTeYSiw,F̟fnfAU޵kWhhO^*KjE絤1YΣhI^ }ۘ| f7of1 `QKpJ/_|ڵYݗ(Z#=M.reG[pgWϓGi0sF-A;꾜E~ ݐ<̏ft)IH&+X/-tdz8{0ܨp7oۃ+=x`׳8׮]۲eٞMSrGhtaϋ)*,,xfnRY?nRa-$vܬz"w}ho,U͏Vf}Y =nRa\pEa=m۶]zKpr@s3goQM*QtY =nRa-]z^r Y +,={񋢱<. PQKnNrڵ;vt{<9zK8?dqk_d4j¾9CY~vHX~ε 9ۜ߉mX wٳ̙3u_rIH; va 8" 6wg։/M5W8Ig͟G5J+峔$ntc*BZ7, wۅឃb%}['Ćx$Q&ۑ_&FHVTJ) t,(n9g,TEh&x?QpnMHSKcy~u~j%a*PIZ'E4WA1 \v;ysǎ:$0m{W?̾/=x)vi-tDIe5cm`q5tm:g٩(m4?yRtFtO|=MjYWzfgϥ?jA7hsSUt wE̟bLJ8|#GKSN#.63E{lge4]"Jt溭\\uO +"D48G\nVZ54nsS^fx[3+-An;Gܢh+rOgx5ܰl0m{}K{(W;4ŕc'-qڥdg0.6sl[9u`%G[p[ߵ쁓*L,]fpgdvvA۶m7gΜٷo_WM0m{޳Otc:vГNrKc`bl]Nz +9posպĽ=e#eWwM}̋7Й.miOQ[WC٥0YW[ԥ$7Z~ d8Wnݺ5juiSd6be(0 # v3 JS?2s|o=&6K &7Ҿq˽Ll[r{Rb=fZuFna-o ۠I5VγZ-S=М k벢|3h|;3g:.pO!u_B7qӢfUc YMbCu>Dx ̬$sO^lTR,fNtJKp7Zێ~r]JaA;7K*'y̏sxeTO;Ϛ:M9=f6*=(jm#(g'-70$pކOŷsVaʕ+۶m+~{2hr81`ܞ603YΣhens^ЬSqÌ'DcRٸ,ӥ% TF2Idi^3T;Uaf %p -e<&߬F&0RZ:1֚?EX ZLensʳSqe̛@>cl_aJuFviHaf %p |W]vHpylwUd9G+DL3Y# Rm(63XvꀍܜNfVP 7j0 -Jk$+9bE7 wMŻ-RD10/5 =oX<ǏrIVUt,1h)) wT\ҹ2&6J? ;ԥ${tK ̬$nRaa1Rn[G zn9-td<={*Z~{%\vޫ"yΏIҔY;{5%F rONOj=#|A&3+`( TIRgƍɱ&585t2KRߚfq~;Qft)<mv ,{l@ E7)53hEMk`i-]5fN=eG_ 2r ,T;b>T w~ʹ:4sdN"E秙ۡ[eA0mp뾊hmG& fhn8kkk,ڲ o뮻^:053bRa ~t 7˗/o۶ۗ0]w`k.n%m05CtRݗ,p{5C w`Zؾ};`RX.._|`)`kpҥ۷33t@p }729t^X!0#t 7;ydW]3p78ҙ:f]/xǎu_9@g -5퍅n)|QV}Zb׮]u_!:@p }k¥KE -avql7 7 oo[ne% woo)'Op@{p }qڵp8f,۫Zի[l37 7oO' wx<( p/okkkϟ*fW3p/k׮ ]ŋ۷o*f ]v05C `sǏ}p }] XW\%Znfh^X1ӧO} `kja^!ŏ+:s@p }˗/^XU۫Z+DXma +We :}v05C w%~{?>~n@3p }'9ǔ0 Cݗ۫Z!D40n *)ٳ__405Y\op 뷃Q$ϰ+W}!{>^m6o+Ǐ߳gOWPsD@sp -sPϳ;4 wЇ{VXJuVvp{5C L~; `5\|y>zp -%av˖-tp }K07gΜp@j2=zu_FO@]`~;TO>]U@p -۶mcZm~zP('uU>Ї;oEnA@Z`vX 7*# 78@ e߾}Ǐ*`Qa `Qa!֛~;TA@Z5XC{s4\Mj>g6Ş7Ƶ:hA~;T[xu0XyÍhjn={9sý 4׫I ? ͓p}fHMHҽdsBsEhjoiឩyX1rln aS13%;l-gEjuF  @۷ozjن[Yi;0MڟĖ֑^m=*tQZ@ZYD wH؀Nl[i"e;*nD7Ї,!رapg+tYb;טP8*C 4tDapfz<`h6X @޶p_xqǎÍ  L?c=뷃0ܨ1iٶ]G7pÍJh*'Qb*#b8Í%*дλx~-Ϭ}vSl=_"&0ܨ_ri_yFg7Uz.b8Í%*М&\=C+C7ʞ;^F"^}npIȀd5x-n-d3 7ꗨ\CCb;^gwه+|ϭp֤oI`C\ ?Yb  VE5bR,,*А¯GU}/O_^xW_|8Ll1AC&y9~ˏ(j#2r!+áPҲx{ܬn3#^yf^I֟]=*2~]<%Q!a-*Аv;o߸(.õ-o}u߯iO<{H&p5!"ci42vn8v}cqdN(lG̽Fp2$;i jQ$OfE5i$z9$8*iO,t sr i7u|MO~·?ȿ7/yn8tK-BMo+c"i~{7FCKIth)O[ܪo\ m0ܩ. ="Ý8x#m62L&;|1+*Аv;>{T\_]7=yGw ٗ/g[=';j3Ʊ:$#kܼv')~T[<)eo,FpyX1Q+s5uOZhiLd[9B{$6WT!1W_|c}Q\<7;F}c g -nS5t%9bTᶧ,l^g#DL`S4=F iTi$4.%W-֣̾Z EyO=tO;g}~\>yvxpF]pǿ9y椔FjnPD"&0ܦN aғ[9h2器CRr͉iqC|exG+ٽĻIJ<{FZ98yW>0-$nH={?5ڟ$邔! j.1Fk 2"&0ܨ_r4TFpKTʈp~ʵ?Pn/Qb*#b8]y噵vwNM>-Qb*#b8ý} %o8|_!ST֘9c5Ad=Ѽ߭ BW/~' {emY@n!ƞe h/*Ѐ6tS}" 7@{~v}[Z_s75[*qDTaј/͗ev3-܉jzsI+ȎO^JWKj> 'ZmuDIK >0[>rrzLIK"&@KpϯO>~? oW˫-8X-;Ő'^3yUA&Қ@Di▔}rz .<Ý]!uo1'Jo5)Db`&sN^zpC'Zڗȉ/3#AַGL_7;p_ [_/~Z-҄m ҁ[-j[=ӸE''ZkX(Iˠ+WM,-rXhU U%hXm)@[ZydljڗpKӾL#˻%` o7oG< > Gvx&6p"%Nt*{T|{u7%;g_ʞo})**9*tI73{AQEcZQb_GfYF#ґl _q iꏓ6f|"_5?t!OϸNC8D_0K[orIh>/>|]w>k(;yfo pw>}_;&ǡ^=Fda+k -Axd&λ?~9{ϧ_=R?% W>jDiU+%t'>7W^Gq ObW MÝ>\[3g)'v[\1 1^TU7߾q?ڻٽ{d#*@LCeDL`+;^Oxr/'O'=IPDi 7ꗨ\1 1Fkز']T`Q4pb*#b8Í%*@LCeDL`QDi 7ꗨ\,1m;rowk/ȥ p9y%lN\rO5k(vjF1j>̧.Dn_TaV-ZAEDLpW)ҷ]Mwnxx5X_2=9Djcy8[+'YMևɆ@[]:Qzel252\ tRj/$%D0ܨ nae':~kegӿ+8d6&[IMc2e㛞H\L# A;Qzjj_b"'ֿ̌LY^cQEu#|:Ar&/[O}-1R#2bc8\Iwpep}*b8%{vWxe}- ]AT/_Vujz3 ~F~oK7mY_/*n҃w}/z/  ?8ܡIچ7NV;A 泭ɽ 71jÍ%*}Sw{б pHltrMXMw7cbCHV{z;+53 \I <1H'46vUstCpKT!?=ppZ@Q{\@Yɘ.b8Í%*嘖_~ GM&b8 4[ sr^.tp4pKTʈp~ʵ?Pn/Qb*#b8`>=͝?wͷKʋʵ?`Q~"Q{D\102?b"TRTÍʈp~ʵ?`Qt)1AN4MJ"d}L8PaʱWfI6eQz $mI\(({|n 2bcj j2)y!eM㾋ʵ?Ӫ/i9JXtyHnug7b +\ _z𮗼oSo⥔-*$zS1&nx^@H/V;^M*0j@OVFTaƘI\[Ih[OY ;7VO'8~~U5$&"G솈(6_3^lS)kWaZ-E6f(bQ$;+|)JPTa&c(b+$tآrBΧPfzcQG솈(6x|xG<i|D;UWAkGRUE_%,M)0@]2[}^JOTaPr1TrCoVHoi\ӘiJi5"jņO}=+^A?Rm8LHl y)1kX n3%>4ZbUɹQCY):fˆņ{'n:uױp M'΂ty'a\fE`KIEii GL6ͺ%cW:H1h#]pU$؛ݥ PjGF|ޓo;ĆxiF8f`|fIr̓2X'+ی?rĴZ4mMԁŽXív2Q[PfcLqQ"&N )Ć X<5Q[%%\Ta1XEOhہJL̳#1^/rۈʵ?4.)lB*U:v# 6-ATʈp~ʵ?Pn/Qb*#b8Í%*@LCeDL`QDi 7ꗨ\1 1Fk 2"&0ܨ_r4TFp dRfA%d}0VJ.d\2 E5܅1_^3X}t2=&EL5ΟA%#~0*%l` 7Di(󖲴dUq/#>&!7!D _z𮗼oSo⥞fq6~D Ome{+2FRpd4{ d}Dpi!'<6~QQDiZI$|:%8==4N1Џrrj+Qrc{|3KlrG~n}/_z6)RӤ}1({rķRW~i=iZDTu[~ 7RDiiʁK P"DfE<34w;*3\ZXjELRl?y$x)v` GX-@[ۡOGdS5x7mDG(kX I &Qċۼ@gI,7KUKMryUF8KELRl?{^ڷCi =&~1yFr Ĵbít tfb&iV8/2f~kD2ELRl}Sw{б pHltrM&zIݑm iVC%]JЌr4i 5  tzbn8ߺߕ .u$ΈRG,7o-9K IAݿ{Oq⥚`3j&2 i$q(ui23\M,[NFCoohlIà Ĵ G"j#@75ٴ,yOKP["neϛ9h2~ e|SZbc9Qo)"5q̪u!;U#AAJjYpd܈҄r!K.XIOa&]:/'6-p{&i*l^\3Ϫp 78Ik5Vw`0$-{4s c}{&i0 7\'I'ٸ9vܩ6=E6>ܲPan/\Xf I@f1gp$Bi0 7RoHo8JH36;ХdAi0 7ꗪ4R۴-&[aoIpMV1 Fk 2"&0ܨ_r4TFpKTʈXឌVf[`>VYM9B_@D591Xz}ΥmS![xTEL5ΟAeB،fw)ckkk;pA;'T|^cE1R/=xK7©N RO3^'Sx2nPIfZ؜M&Cou(飍@IR쟬AZ^X6^ 4UX[ }e7,Go4L2J=oe0ifB\z'EZR 3KlrGuUnp@vgc/N9MZL6uQ]"*$!^ۣW?R|i%mCr6y#<#o4>"^z4<&66iԾHr{Ol3x٦-4cJVX>goEa# (%ԃOykfh2C(K3X䭌ā[ꨎ (6|z=/@_R4SMf3O-)i=VEÍ %-[~?o?)Wl=Rb-NS*oh6YE2B\Qe wFbtFGuT 7,bý7k]8Cb㦓kb5#YA0hKiRf(/_^[[ۺuӧ`g>semBbMNv)$DN뇝(N1CSf|l]J0ˠԠɏܽ'8v[ RMH[MMZ(mo L:;Ѳ0bc=o^ʪBP0YBV,YUd|o- (eo҃w}/z/4ș!>~ OnI 'CARUWuh}qbc*0Ukpӂd[ VF4SUj=y`fhIL&Qlg|XKSNV-Dٓa19`\ODONӔ"MTz7zK*eʵ?iw)z`(o0EHkyb"Z6 ~7D/N9d]l-(mFAQueZ-z%*<) c,ߵ4c(0y+#q %1Cӻyis: b2̶N*4F>ņ;ڣ>!5ہV,Q1MO#XX95|er/hIL7g]^;t¡'/7\;è$fpco)R2JxHEǴi V ]J ը'ƫfrx0#6өqhUuZPTaG5dԘ"?pyC[tTӒlP)Tay hņ{}f˗uJ;4~t"pGV^I@IH4M)DlxRwn@ ʵ?,81.EԚIaYcZQ~uNcfb*AMp7yHRWN[mIC$%P*Cf}#Mye dkX$z0=k(WсIt2bZtZ|8AMpoKSNSh]l=OuZPTa*l|s䡍YیiMs wFbt@P%&3 ޳Otc:vГN9Dүq`7܅]J”+á QEbZڥČE1MXKIV̏JP%&@(5h#w>w7cbC4ڲY2 V$ &4߃kX m}()?hRC5,&[ayz2JLQvZ=N%6qKBQg1O (: lG5GTYLsbD"$b8QDi 7ꗨ\1 1Fk 2"&0ܨ_r4TFp|{z=ؗFptA2rnTFp[Xm5&BeD0ܨ wrnTFpB]J$Kʋʵ?`Q.ZU̥RV\a>6U$t*^88rd[[{+I5…<\ò tl;|[i, Y%nft 1Pp8"\YlLSýP(/+ r1QnOW z̹֗p*Jk~~ Tao(eo҃w}/zؘ]J4^HT cOo6d$maT3I_zޒfVwu=[&%X#2\dS**:8jOPJ9ֿOKR[HJ܀NU'T|L/4I;M[I[!z;% YiS|'mo(6_3^lSةL=~eOxbdU")6ij&ɩ8w֜>x*"c7D]/)c|Kj5PS?V\aiy[xkذ[Rm;Qw5\p@o>H#ة%j/ޮo1oRzBkZ7Kyf%>fX'M:.߀:ܺ&}IJXC 3HL3_*Y(a1-ְykhMpņO}=+^ZT$nZbvE LW˾lpkP1%W_uaѶpÂ,f.S%Q֥D%;/4k bý7k]8Cb㦓kbYO!:i.%ˤ< Lҟ8iAM\&m]J w_c~ξ(O;r o.%P) Ĵv7G%L/.ٷdIݼ"&J {c/ձd.mO5$66q fjXV6p9`yO^2&R׿UMB,r#yI4b8|׌z0喜-wlMpe|SZbjQe3U(*PQLpBVooᛖȵjnfP*PL=MCV3oF=k 2"&0ܨ_r4TFpKTʈp~ʵ?Plc_Mʈʵ?`Qsna|kp2"&7Kʋʵ?`Q u) .*/*FeDL\!kh5 &CoC^#5ӏ/\s|K|coUJ^-kXᖊ(Wݳn)+G;E(qy?uƥװBe 'e45K )KH_]Yμ w|Aϝu9_W]3KL[)>ؿs+ S1֠cY”wI| ,FPp@)}%}['4R[Iv6FqcL*kV2?0er>xUMPqNWEF#S&j/?ds<Կ֯ա2PoW-5E`d|@*P>VQ\ #Tn ~OHԻIY,a|Oq)5Hg[?qٗz#W(b8ps{ҳNb^3%2H*d2"0[Ijaܲ\cc\"qgM#U 9O9R5JzibgߡcmR٨Zсoʵ,,)nscb+-{\aVR2\[/3,FPp@o>H#i2z7g0srQJ)|LJ9~"KեlL2sf7ۖ3JWې+c9 `_ӥTʖiܯZΙp7bAbkRR2j~jDe(6|z=/@_R̪e h]̭IRfYp9'nyPѪv٦.c6㫶f(*0=VNp!g.%7v^G@F5Y{xkGb]\ bý7k]8Cb㦓kbgfœ< eBabp[ byjiD&ʬjTUoI[,]L ]J Eb[7Gw~^\aĠI\﹑igE-No EL4;1!^1摴dnI՞q[}F#Jc3nZK:N#5cKSOu=y]J ,j˳ &"1Z馐{z`-`e[fʵ?T*PwU107hc^MMb*I_O n/Qb*#b8Í%*@LCeDL`QDi 7ꗨ\1 10^/?e!]D\10V[ͧPQ 7*#b8`q]D\1P?IrnTFphEY+8Zؾ|hB2 IH\UjÜk˕rT\C wN ׮cOF*GѲ+"&435_ I.e]b wDosCb^T" R(kt) Gm7:"ˉc,RӦ쫊Ӭx`WIkP TY]ҕW=*&ʵ?iqdS$Hz:P  yl;<*B婧CpI9,Gfs4qG1~e#;Q!pkoM w1)S,g2HR 2*'~Le?5\Di[c tƁvD4ZjG 71ꢜEy$_9Z|ܳws w\aD54p& mty_i~:ܤ=NdhNcj#*`Ln#L@<0p͋Ec`DD"{(5 d &8!/f!#$7`o{y~~,=5յo杷vmJE@XFHI~~ngڿ;O,ք.-lN#pa9h)"(9di7O;p\C1s _;5#]H@N&KYKJ敇Gg}ՊPT, *zS>㱶%%&%KJ:E8ak 40X7 WNLXcwcT}3L̬a-^-wVՏ V9ś;TfSir#:Ĵ_cu#oc"po 8˶ yR J áf^D>EL97Nj߽*)'Fk p5HՓ u0p  n4,1b1Fp  n4,1b1Fp  uں0w7HÍ"4p!@`Q0  @,po7o?SLëaRM#gE,9ZKO|G7sh{Ι>3; @ _￸_MB/FSĐy-vܾFNzަp @ ^4/K3h ˄0pŦ[K7)Q>},U>x{:IﮚT{Si'fKNNWW&eʈoZ|B= ٮâÛlwDjygK @ _~#u$^>WZ#Lma=u?'\iq.ܿ5m[ ml:-9x=^oLhfo|0\|Oϕ6 7 ppwlJR4\#;kl ni+-pT)o6ra zeuFc9M6 tx#ޱ_Pk@<_}эOn/tK/ʰ q67u4g{ ]RRLh@X܆;NpWk<= g+G;|=pDlqg))Wf-I UMƕ-j'Λ&]%%>R!KHmmǮޠ I7<;# ^Zfz &3) +}deF¼eP{^a\$IMs+3m_q#Y^;i7i  Ip }b!۹UOX@M=) 7$@y6TQg WSh OVg& @`Q0  @`Q0  @lm]!NV X"n%X"z&kpAIENDB`java-design-patterns-1.16.0/event-asynchronous/etc/event-asynchronous.ucls000066400000000000000000000153641312550536300270300ustar00rootroot00000000000000 java-design-patterns-1.16.0/event-asynchronous/etc/event-asynchronous.urm.puml000066400000000000000000000034051312550536300276320ustar00rootroot00000000000000@startuml package com.iluwatar.event.asynchronous { class App { - LOGGER : Logger {static} + PROP_FILE_NAME : String {static} ~ interactiveMode : boolean + App() + main(args : String[]) {static} + quickRun() + run() + runInteractiveMode() + setUp() } class Event { - LOGGER : Logger {static} - eventId : int - eventListener : ThreadCompleteListener - eventTime : int - isComplete : boolean - isSynchronous : boolean - thread : Thread + Event(eventId : int, eventTime : int, isSynchronous : boolean) + addListener(listener : ThreadCompleteListener) - completed() + isSynchronous() : boolean + removeListener(listener : ThreadCompleteListener) + run() + start() + status() + stop() } class EventManager { + MAX_EVENT_TIME : int {static} + MAX_ID : int {static} + MAX_RUNNING_EVENTS : int {static} + MIN_ID : int {static} - currentlyRunningSyncEvent : int - eventPool : Map - rand : Random + EventManager() + cancel(eventId : int) + completedEventHandler(eventId : int) + create(eventTime : int) : int + createAsync(eventTime : int) : int - createEvent(eventTime : int, isSynchronous : boolean) : int - generateId() : int + getEventPool() : Map + numOfCurrentlyRunningSyncEvent() : int + shutdown() + start(eventId : int) + status(eventId : int) + statusOfAllEvents() } interface IEvent { + start() {abstract} + status() {abstract} + stop() {abstract} } interface ThreadCompleteListener { + completedEventHandler(int) {abstract} } } Event --> "-eventListener" ThreadCompleteListener Event ..|> IEvent EventManager ..|> ThreadCompleteListener @endumljava-design-patterns-1.16.0/event-asynchronous/pom.xml000066400000000000000000000033731312550536300230250ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 event-asynchronous junit junit test java-design-patterns-1.16.0/event-asynchronous/src/000077500000000000000000000000001312550536300222715ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/000077500000000000000000000000001312550536300232155ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/000077500000000000000000000000001312550536300241365ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/000077500000000000000000000000001312550536300247145ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300265445ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/000077500000000000000000000000001312550536300276655ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/000077500000000000000000000000001312550536300324205ustar00rootroot00000000000000App.java000066400000000000000000000200341312550536300337230ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.IOException; import java.io.InputStream; import java.util.Properties; import java.util.Scanner; /** * * This application demonstrates the Event-based Asynchronous pattern. Essentially, users (of the pattern) may * choose to run events in an Asynchronous or Synchronous mode. There can be multiple Asynchronous events running at * once but only one Synchronous event can run at a time. Asynchronous events are synonymous to multi-threads. The key * point here is that the threads run in the background and the user is free to carry on with other processes. Once an * event is complete, the appropriate listener/callback method will be called. The listener then proceeds to carry out * further processing depending on the needs of the user. * * The {@link EventManager} manages the events/threads that the user creates. Currently, the supported event operations * are: start, stop, getStatus. For Synchronous events, the user is unable to * start another (Synchronous) event if one is already running at the time. The running event would have to either be * stopped or completed before a new event can be started. * * The Event-based Asynchronous Pattern makes available the advantages of multithreaded applications while hiding many * of the complex issues inherent in multithreaded design. Using a class that supports this pattern can allow you to:- * (1) Perform time-consuming tasks, such as downloads and database operations, "in the background," without * interrupting your application. (2) Execute multiple operations simultaneously, receiving notifications when each * completes. (3) Wait for resources to become available without stopping ("hanging") your application. (4) Communicate * with pending asynchronous operations using the familiar events-and-delegates model. * * @see EventManager * @see Event * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); public static final String PROP_FILE_NAME = "config.properties"; boolean interactiveMode = false; /** * Program entry point. * * @param args command line args */ public static void main(String[] args) { App app = new App(); app.setUp(); app.run(); } /** * App can run in interactive mode or not. Interactive mode == Allow user interaction with command line. * Non-interactive is a quick sequential run through the available {@link EventManager} operations. */ public void setUp() { Properties prop = new Properties(); InputStream inputStream = App.class.getClassLoader().getResourceAsStream(PROP_FILE_NAME); if (inputStream != null) { try { prop.load(inputStream); } catch (IOException e) { LOGGER.error("{} was not found. Defaulting to non-interactive mode.", PROP_FILE_NAME, e); } String property = prop.getProperty("INTERACTIVE_MODE"); if (property.equalsIgnoreCase("YES")) { interactiveMode = true; } } } /** * Run program in either interactive mode or not. */ public void run() { if (interactiveMode) { runInteractiveMode(); } else { quickRun(); } } /** * Run program in non-interactive mode. */ public void quickRun() { EventManager eventManager = new EventManager(); try { // Create an Asynchronous event. int aEventId = eventManager.createAsync(60); LOGGER.info("Async Event [{}] has been created.", aEventId); eventManager.start(aEventId); LOGGER.info("Async Event [{}] has been started.", aEventId); // Create a Synchronous event. int sEventId = eventManager.create(60); LOGGER.info("Sync Event [{}] has been created.", sEventId); eventManager.start(sEventId); LOGGER.info("Sync Event [{}] has been started.", sEventId); eventManager.status(aEventId); eventManager.status(sEventId); eventManager.cancel(aEventId); LOGGER.info("Async Event [{}] has been stopped.", aEventId); eventManager.cancel(sEventId); LOGGER.info("Sync Event [{}] has been stopped.", sEventId); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException | InvalidOperationException e) { LOGGER.error(e.getMessage()); } } /** * Run program in interactive mode. */ public void runInteractiveMode() { EventManager eventManager = new EventManager(); Scanner s = new Scanner(System.in); int option = -1; while (option != 4) { LOGGER.info("Hello. Would you like to boil some eggs?"); LOGGER.info("(1) BOIL AN EGG \n(2) STOP BOILING THIS EGG \n(3) HOW ARE MY EGGS? \n(4) EXIT"); LOGGER.info("Choose [1,2,3,4]: "); option = s.nextInt(); if (option == 1) { s.nextLine(); LOGGER.info("Boil multiple eggs at once (A) or boil them one-by-one (S)?: "); String eventType = s.nextLine(); LOGGER.info("How long should this egg be boiled for (in seconds)?: "); int eventTime = s.nextInt(); if (eventType.equalsIgnoreCase("A")) { try { int eventId = eventManager.createAsync(eventTime); eventManager.start(eventId); LOGGER.info("Egg [{}] is being boiled.", eventId); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } else if (eventType.equalsIgnoreCase("S")) { try { int eventId = eventManager.create(eventTime); eventManager.start(eventId); LOGGER.info("Egg [{}] is being boiled.", eventId); } catch (MaxNumOfEventsAllowedException | InvalidOperationException | LongRunningEventException | EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } else { LOGGER.info("Unknown event type."); } } else if (option == 2) { LOGGER.info("Which egg?: "); int eventId = s.nextInt(); try { eventManager.cancel(eventId); LOGGER.info("Egg [{}] is removed from boiler.", eventId); } catch (EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } else if (option == 3) { s.nextLine(); LOGGER.info("Just one egg (O) OR all of them (A) ?: "); String eggChoice = s.nextLine(); if (eggChoice.equalsIgnoreCase("O")) { LOGGER.info("Which egg?: "); int eventId = s.nextInt(); try { eventManager.status(eventId); } catch (EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } else if (eggChoice.equalsIgnoreCase("A")) { eventManager.statusOfAllEvents(); } } else if (option == 4) { eventManager.shutdown(); } } s.close(); } } Event.java000066400000000000000000000060411312550536300342660ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Each Event runs as a separate/individual thread. * */ public class Event implements IEvent, Runnable { private static final Logger LOGGER = LoggerFactory.getLogger(Event.class); private int eventId; private int eventTime; private boolean isSynchronous; private Thread thread; private boolean isComplete = false; private ThreadCompleteListener eventListener; /** * * @param eventId event ID * @param eventTime event time * @param isSynchronous is of synchronous type */ public Event(final int eventId, final int eventTime, final boolean isSynchronous) { this.eventId = eventId; this.eventTime = eventTime; this.isSynchronous = isSynchronous; } public boolean isSynchronous() { return isSynchronous; } @Override public void start() { thread = new Thread(this); thread.start(); } @Override public void stop() { if (null == thread) { return; } thread.interrupt(); } @Override public void status() { if (!isComplete) { LOGGER.info("[{}] is not done.", eventId); } else { LOGGER.info("[{}] is done.", eventId); } } @Override public void run() { long currentTime = System.currentTimeMillis(); long endTime = currentTime + (eventTime * 1000); while (System.currentTimeMillis() < endTime) { try { Thread.sleep(1000); // Sleep for 1 second. } catch (InterruptedException e) { return; } } isComplete = true; completed(); } public final void addListener(final ThreadCompleteListener listener) { this.eventListener = listener; } public final void removeListener(final ThreadCompleteListener listener) { this.eventListener = null; } private final void completed() { if (eventListener != null) { eventListener.completedEventHandler(eventId); } } } EventDoesNotExistException.java000066400000000000000000000026361312550536300404640ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; /** * Custom Exception Class for Non Existent Event */ public class EventDoesNotExistException extends Exception { private static final long serialVersionUID = -3398463738273811509L; public EventDoesNotExistException(String message) { super(message); } } EventManager.java000066400000000000000000000165411312550536300355670ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; import java.util.Iterator; import java.util.Map; import java.util.Random; import java.util.concurrent.ConcurrentHashMap; /** * * EventManager handles and maintains a pool of event threads. {@link Event} threads are created upon user request. Thre * are two types of events; Asynchronous and Synchronous. There can be multiple Asynchronous events running at once but * only one Synchronous event running at a time. Currently supported event operations are: start, stop, and getStatus. * Once an event is complete, it then notifies EventManager through a listener. The EventManager then takes the event * out of the pool. * */ public class EventManager implements ThreadCompleteListener { public static final int MAX_RUNNING_EVENTS = 1000; // Just don't wanna have too many running events. :) public static final int MIN_ID = 1; public static final int MAX_ID = MAX_RUNNING_EVENTS; public static final int MAX_EVENT_TIME = 1800; // in seconds / 30 minutes. private int currentlyRunningSyncEvent = -1; private Random rand; private Map eventPool; /** * EventManager constructor. * */ public EventManager() { rand = new Random(1); eventPool = new ConcurrentHashMap(MAX_RUNNING_EVENTS); } /** * Create a Synchronous event. * * @param eventTime Time an event should run for. * @return eventId * @throws MaxNumOfEventsAllowedException When too many events are running at a time. * @throws InvalidOperationException No new synchronous events can be created when one is already running. * @throws LongRunningEventException Long running events are not allowed in the app. */ public int create(int eventTime) throws MaxNumOfEventsAllowedException, InvalidOperationException, LongRunningEventException { if (currentlyRunningSyncEvent != -1) { throw new InvalidOperationException( "Event [" + currentlyRunningSyncEvent + "] is still running. Please wait until it finishes and try again."); } int eventId = createEvent(eventTime, true); currentlyRunningSyncEvent = eventId; return eventId; } /** * Create an Asynchronous event. * * @param eventTime Time an event should run for. * @return eventId * @throws MaxNumOfEventsAllowedException When too many events are running at a time. * @throws LongRunningEventException Long running events are not allowed in the app. */ public int createAsync(int eventTime) throws MaxNumOfEventsAllowedException, LongRunningEventException { return createEvent(eventTime, false); } private int createEvent(int eventTime, boolean isSynchronous) throws MaxNumOfEventsAllowedException, LongRunningEventException { if (eventPool.size() == MAX_RUNNING_EVENTS) { throw new MaxNumOfEventsAllowedException("Too many events are running at the moment. Please try again later."); } if (eventTime >= MAX_EVENT_TIME) { throw new LongRunningEventException( "Maximum event time allowed is " + MAX_EVENT_TIME + " seconds. Please try again."); } int newEventId = generateId(); Event newEvent = new Event(newEventId, eventTime, isSynchronous); newEvent.addListener(this); eventPool.put(newEventId, newEvent); return newEventId; } /** * Starts event. * * @param eventId The event that needs to be started. * @throws EventDoesNotExistException If event does not exist in our eventPool. */ public void start(int eventId) throws EventDoesNotExistException { if (!eventPool.containsKey(eventId)) { throw new EventDoesNotExistException(eventId + " does not exist."); } eventPool.get(eventId).start(); } /** * Stops event. * * @param eventId The event that needs to be stopped. * @throws EventDoesNotExistException If event does not exist in our eventPool. */ public void cancel(int eventId) throws EventDoesNotExistException { if (!eventPool.containsKey(eventId)) { throw new EventDoesNotExistException(eventId + " does not exist."); } if (eventId == currentlyRunningSyncEvent) { currentlyRunningSyncEvent = -1; } eventPool.get(eventId).stop(); eventPool.remove(eventId); } /** * Get status of a running event. * * @param eventId The event to inquire status of. * @throws EventDoesNotExistException If event does not exist in our eventPool. */ public void status(int eventId) throws EventDoesNotExistException { if (!eventPool.containsKey(eventId)) { throw new EventDoesNotExistException(eventId + " does not exist."); } eventPool.get(eventId).status(); } /** * Gets status of all running events. */ @SuppressWarnings("rawtypes") public void statusOfAllEvents() { Iterator it = eventPool.entrySet().iterator(); while (it.hasNext()) { Map.Entry pair = (Map.Entry) it.next(); ((Event) pair.getValue()).status(); } } /** * Stop all running events. */ @SuppressWarnings("rawtypes") public void shutdown() { Iterator it = eventPool.entrySet().iterator(); while (it.hasNext()) { Map.Entry pair = (Map.Entry) it.next(); ((Event) pair.getValue()).stop(); } } /** * Returns a pseudo-random number between min and max, inclusive. The difference between min and max can be at most * Integer.MAX_VALUE - 1. */ private int generateId() { // nextInt is normally exclusive of the top value, // so add 1 to make it inclusive int randomNum = rand.nextInt((MAX_ID - MIN_ID) + 1) + MIN_ID; while (eventPool.containsKey(randomNum)) { randomNum = rand.nextInt((MAX_ID - MIN_ID) + 1) + MIN_ID; } return randomNum; } /** * Callback from an {@link Event} (once it is complete). The Event is then removed from the pool. */ @Override public void completedEventHandler(int eventId) { eventPool.get(eventId).status(); if (eventPool.get(eventId).isSynchronous()) { currentlyRunningSyncEvent = -1; } eventPool.remove(eventId); } /** * Getter method for event pool. */ public Map getEventPool() { return eventPool; } /** * Get number of currently running Synchronous events. */ public int numOfCurrentlyRunningSyncEvent() { return currentlyRunningSyncEvent; } } IEvent.java000066400000000000000000000025161312550536300344020ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; /** * Events that fulfill the start stop and list out current status behaviour * follow this interface */ public interface IEvent { void start(); void stop(); void status(); } InvalidOperationException.java000066400000000000000000000026641312550536300403420ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; /** * Type of Exception raised when the Operation being invoked is Invalid */ public class InvalidOperationException extends Exception { private static final long serialVersionUID = -6191545255213410803L; public InvalidOperationException(String message) { super(message); } } LongRunningEventException.java000066400000000000000000000026671312550536300403400ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; /** * Type of Exception raised when the Operation being invoked is Long Running */ public class LongRunningEventException extends Exception { private static final long serialVersionUID = -483423544320148809L; public LongRunningEventException(String message) { super(message); } } MaxNumOfEventsAllowedException.java000066400000000000000000000027031312550536300412540ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; /** * Type of Exception raised when the max number of allowed events is exceeded */ public class MaxNumOfEventsAllowedException extends Exception { private static final long serialVersionUID = -8430876973516292695L; public MaxNumOfEventsAllowedException(String message) { super(message); } } ThreadCompleteListener.java000066400000000000000000000024711312550536300376160ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; /** * Interface with listener behaviour related to Thread Completion. */ public interface ThreadCompleteListener { void completedEventHandler(final int eventId); } java-design-patterns-1.16.0/event-asynchronous/src/main/resources/000077500000000000000000000000001312550536300252275ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/main/resources/config.properties000066400000000000000000000021651312550536300306160ustar00rootroot00000000000000# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # INTERACTIVE_MODE=NOjava-design-patterns-1.16.0/event-asynchronous/src/test/000077500000000000000000000000001312550536300232505ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/000077500000000000000000000000001312550536300241715ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/com/000077500000000000000000000000001312550536300247475ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300265775ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/com/iluwatar/event/000077500000000000000000000000001312550536300277205ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/000077500000000000000000000000001312550536300324535ustar00rootroot00000000000000AppTest.java000066400000000000000000000026061312550536300346230ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; import java.io.IOException; import org.junit.Test; /** * Tests that EventAsynchronous example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } EventAsynchronousTest.java000066400000000000000000000122401312550536300375730ustar00rootroot00000000000000java-design-patterns-1.16.0/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/** * The MIT License Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.event.asynchronous; import org.junit.Before; import org.junit.Test; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import static org.junit.Assert.assertTrue; /** * * Application test * */ public class EventAsynchronousTest { App app; private static final Logger LOGGER = LoggerFactory.getLogger(EventAsynchronousTest.class); @Before public void setUp() { app = new App(); } @Test public void testAsynchronousEvent() { EventManager eventManager = new EventManager(); try { int aEventId = eventManager.createAsync(60); eventManager.start(aEventId); assertTrue(eventManager.getEventPool().size() == 1); assertTrue(eventManager.getEventPool().size() < EventManager.MAX_RUNNING_EVENTS); assertTrue(eventManager.numOfCurrentlyRunningSyncEvent() == -1); eventManager.cancel(aEventId); assertTrue(eventManager.getEventPool().size() == 0); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } @Test public void testSynchronousEvent() { EventManager eventManager = new EventManager(); try { int sEventId = eventManager.create(60); eventManager.start(sEventId); assertTrue(eventManager.getEventPool().size() == 1); assertTrue(eventManager.getEventPool().size() < EventManager.MAX_RUNNING_EVENTS); assertTrue(eventManager.numOfCurrentlyRunningSyncEvent() != -1); eventManager.cancel(sEventId); assertTrue(eventManager.getEventPool().size() == 0); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException | InvalidOperationException e) { LOGGER.error(e.getMessage()); } } @Test(expected = InvalidOperationException.class) public void testUnsuccessfulSynchronousEvent() throws InvalidOperationException { EventManager eventManager = new EventManager(); try { int sEventId = eventManager.create(60); eventManager.start(sEventId); sEventId = eventManager.create(60); eventManager.start(sEventId); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } @Test public void testFullSynchronousEvent() { EventManager eventManager = new EventManager(); try { int eventTime = 1; int sEventId = eventManager.create(eventTime); assertTrue(eventManager.getEventPool().size() == 1); eventManager.start(sEventId); long currentTime = System.currentTimeMillis(); long endTime = currentTime + (eventTime + 2 * 1000); // +2 to give a bit of buffer time for event to // complete // properly. while (System.currentTimeMillis() < endTime) { } assertTrue(eventManager.getEventPool().size() == 0); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException | InvalidOperationException e) { LOGGER.error(e.getMessage()); } } @Test public void testFullAsynchronousEvent() { EventManager eventManager = new EventManager(); try { int eventTime = 1; int aEventId1 = eventManager.createAsync(eventTime); int aEventId2 = eventManager.createAsync(eventTime); int aEventId3 = eventManager.createAsync(eventTime); assertTrue(eventManager.getEventPool().size() == 3); eventManager.start(aEventId1); eventManager.start(aEventId2); eventManager.start(aEventId3); long currentTime = System.currentTimeMillis(); long endTime = currentTime + (eventTime + 2 * 1000); // +2 to give a bit of buffer time for event to complete // properly. while (System.currentTimeMillis() < endTime) { } assertTrue(eventManager.getEventPool().size() == 0); } catch (MaxNumOfEventsAllowedException | LongRunningEventException | EventDoesNotExistException e) { LOGGER.error(e.getMessage()); } } } java-design-patterns-1.16.0/event-driven-architecture/000077500000000000000000000000001312550536300227165ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/README.md000066400000000000000000000034661312550536300242060ustar00rootroot00000000000000--- layout: pattern title: Event Driven Architecture folder: event-driven-architecture permalink: /patterns/event-driven-architecture/ pumlid: TOhH3SCW30LNQGS0_tSRnrZ15H1adfFromBzkfFktZQaHT7mzgh0N1yYvoUVXXf7B7Mv1dGWozN9MZmCTlhopQdeidEaoO3wMDHvRI6zzvwAssPYbsfGGRYIGlxN7DxpZDv- categories: Architectural tags: - Java - Difficulty-Intermediate - Reactive --- ## Intent Send and notify state changes of your objects to other applications using an Event-driven Architecture. ![alt text](./etc/eda.png "Event Driven Architecture") ## Applicability Use an Event-driven architecture when * you want to create a loosely coupled system * you want to build a more responsive system * you want a system that is easier to extend ## Real world examples * SendGrid, an email API, sends events whenever an email is processed, delivered, opened etc... (https://sendgrid.com/docs/API_Reference/Webhooks/event.html) * Chargify, a billing API, exposes payment activity through various events (https://docs.chargify.com/api-events) * Amazon's AWS Lambda, lets you execute code in response to events such as changes to Amazon S3 buckets, updates to an Amazon DynamoDB table, or custom events generated by your applications or devices. (https://aws.amazon.com/lambda) * MySQL runs triggers based on events such as inserts and update events happening on database tables. ## Credits * [Event-driven architecture - Wikipedia](https://en.wikipedia.org/wiki/Event-driven_architecture) * [Fundamental Components of an Event-Driven Architecture](http://giocc.com/fundamental-components-of-an-event-driven-architecture.html) * [Real World Applications/Event Driven Applications](https://wiki.haskell.org/Real_World_Applications/Event_Driven_Applications) * [Event-driven architecture definition](http://searchsoa.techtarget.com/definition/event-driven-architecture) java-design-patterns-1.16.0/event-driven-architecture/etc/000077500000000000000000000000001312550536300234715ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/etc/eda.png000066400000000000000000001621541312550536300247410ustar00rootroot00000000000000PNG  IHDRAD_%3IDATx \Mf,cɠ_߱ RR%B5ERID2"1P!I1K3͌14+1Ksns{?}||>~笯UAAb5   i8  A  Dkp U0AAuE4AA54i8  i8pAAp *p&ڽRL>-|׫Zoje220ຍ4AAuC-5ܣGNڪ fZ_ih.X,|\%ݱc! GADQ Y6l bd4tXPf-Z4$ӧ ,^@Z uǜܹ#0=;v,GѣĜ<="‡+޽|??'&! GAD=Q $==mDܼyѣSDF,Zŋsbm@׫ׇqTn7΂pgs.,lNJ'4PYV|`;~ysrcHAQH([??'~el88 tss76oޔ۰aތcGp.65[{HÑ# B|# GA G  A4AAn5ܗ[[#$=u˜瞉0bWKi 9uvnmCN3C1\0# ԕP/&TJo!K˸/؁B\]tq}XVy8+ YYѤ P/D]K &\K#fEpϟK><}7 k}9~=-%%4>~у P Dm,sdՂ㰤_ `1s֟WF%&.olO)*JFHKK# B|\wi١CY| ѧOf͚ {'8xz9MZnѤI㄄%|ߘ}r$@2_ {IA!0u|597 [|4ظW@ Vf뮮#O >x ̈́ZegCC5jhȐ~g~<|hkM[[ >l!ֻ_}P~;6s?f0L6\9cvH`n/l' GA`ԉ66uO\GtIw_bw1~i{/_N)+Cg:^*B֭,!R_P'֯@nFvj us@zhOr;u{Ļw"rRpAAF]je9=k2prWу!4i "޿_38w.p@&M6nM?< d2m~%[7GGHf8?KKQJaMHA!u֟wd7,烩 cjrܗpcݻ 4"ss7h8vn`0{$k\}՛od)U7{&ND^=PF  S'璻wK_'ya~ byZeK֭ [zMׯpp2C͚53fF f񙪞Z-/?'ˍ{-[6Us$$ȨWRҲGNp# vluE39Sx:Z. ӥy󦮮#~掎r5‘>HЩKxH<|x=JOk^fyr ˽WbU]I7pAAuᘌsy(v14AAu@jnYS8grn:GK% GADS4AAi8pAAp HA!>HÑ# B|# Gh ߕ A l* hkkWEḸ8===(dff_SSSpFF;~U>r䈿?~U.((@Eů$::5 %&&WEⴴ4(\RR_KKK#UQ WEr𫢰ԡ^wo؎׮IbUk>e4F..6P90Ν[졜7&G᳸R̙`mmn 'Al+Wñ;@"p(LLzpD" 4i ]A\k:-[XXmT4\r x۶ h8''KȠO njU L޻7 鑑>aS\y' ˿yЪUމKodXnU"w2ݑEXL# ΐpw7bK{{ ĤIý̯]KJ\zHFݺȠ Yw!C3sF B ++H տӧ쩓!P.W x:uȑϞ̬ic`J2۞9϶k8N8;RՁipq9t(4QҵT ͆'#T]ZZ^53B7 i8p摑EF2i82]_ h #ڥ՚8r{=A!k4vi~&7[6A&^k  t &ꍂJ=g&ڽR|Nm;whee)oU8J}p76ڥ՚ ::ujk}k iaE:th{^~4ŋJK44# GK5QTT!i#ĭ[Yܵ+5ܓ'g'O426x$+*Jfitx~;ЧO+=k-, LLzgfF,~yС]]Grci166 LLLygljb.iP#?| dng$rc8cB*>~!ڷtTԜe˦"櫯vO吐dt;L7ܸq>c;w,m ,fci+//wrrֶFdjjeሺ5TRSSY$b/_._XiP#dٰa7nd*^ iaPf-Z4$fg/v]O吘tڴ1oX\kNvQ29ښ*i 1Nnɒ%kҤI}OH!TjMJ$ex!i%mP'ɍyУGY->~͋ӞIu~_^Q }YbϞ:(9yr+2gN姳aqE ?ڼ91 eB 333H7]]]kkwyAP2pDSRRҮ]R0< עE vr K!.\Hs89Y.@ݡ^Kz`17wcM ͘1vĈMA@ǧҥݻǙoojvghkk,쫨:LLC3k8ۖ/_ֲeK2//}o-T4Y"== : GԎ \ַ̡zc,481FNy}깥C%%%ATI8t'i5thX.$CoaRlȐ~,qU f|c/(9piiH_-[ENhCVFNy޾Vfmt?(}3 VAྑTKJJRRRݡڵkgggZRm""Ӭ\9c,ys5={c-k?)A9Ν;Bر\lVӭ2%=g.$s͚,T4CVFNyDݾ ClBg^Z ~?9=$+B3i;7MfeEއc6Ѫ&'Nlain"WZ$ Ö^ZZ֭[7NU5FȈ+N °H4PB\e?ڋ}R{9_թ2ʅ\Sz-?4NDL?`@p"@c :v6<}Znks@]RoFNy۾_<70|WdvK.1X9ڵ]V{7 z."*jbZ|_?|x}EZ4]elLy{{6iD}t4UPhiΝwpaN݃ŋsϞI{}'k8a6ɓCEݼyϥKMM*- iNOӧKfMe`dHKK# vvC><٥KGvĤL|q7VBՐ3ٳp3 ~X?cUӦYΈOL\PСܔ.qY~9e Z}ȁ粪jwwQjet[xx6ij髇ns 8y4[=)lBW ff+NrAJZh/|<(ڵZ3 r3 .r4KiǏ88l(lWUgPcnBG^x׮b*pLl >::گ Ε+epi8aCCcE{ȈE=j y጑QC|yWב54pʣK^$ىu|N s4,1X3g:bPa@xV-rCƍL%hh.$ߝ0(.ދf/>> ''K'L۷q `%1I1VK]n?«W}:愐ql.C رMp &˪S1"HPү)Y3S3$&j0gv+sV EfPZ ֻw;wNjJt V6çPB83ΘCOEC~.N)xHCC;c3}I 6'ɜxȈd [0&i 4iܴiƍDϓ2-Xatqm[| ȜŰ^lrф[zn .]:V DX~ ʕ3T;D6&ett[~~@mno ԭ?.IOh8$17oz>/rqa@N1& ̤5\U)~hpR0l-2SQΆmcH)/mzrYXƎO꒘sM1go(K\pbʆb31w ajNA˕Zʶ}L>KDC$![;c؊L[hA!͈ݻ3_m0z hv:a۠4LI#*v# W7m s89Y.@ݡJKz`17wcM8! h89  q_ʱc(4%?]BaVV4S~0~i8QJ;\ׅfN]z-IXTv)Xն;LoUT5k2f`$ps\yҨQ#G"0iӦ%Zn~~lCA{DSGCqgk!;; [j6r~=M_~FVA+}`ϥqa//{HCKegѤE9riƽ{wfgZ4I4=O`Y^~>et/ˆpjn!Bkdյго_<7~lIֺwJȾJZPij0Yu!u/4\!t=D!؟.T5cȪi=ALF-NXxdiii&MTQ՚CLF-@]Y[[Cf"G\ѨjMc YuzvE&^^${\\*?~*2`4Zk|s2g"QϮ<ݾ4ۨט֭[ ܪUUUQZǘ[t[>F MF=hp"x^ ׬n733SEA\ΫW TEFUkMc Լ 9!=f#2NIkñcrrb?unԳ+/nް;][mXڇOھ}I}$ԡ+^]RSS۵kx{{K/!\['GF1׾k}j䒂 wK#fEXg_O=ٷ5̨gWl_NWs5ܷߦ:;[+[ Ek8JkkkDRRRTQFQZ#ǘsZp o ϳU}oӧ!MT#¾sKWT>Fon&]tdDjQϮ\b9(va=dd|# 'Mpp:L=UMEGsW1/Z˖@,nwsU- %޶-B2Bgg1ccՂ C 8xzdDX`~1ip//{kҪR9W|9Ik[:kX;dH?vfnԨA^deE# ~=u#dJWOS9rٳCW6m RIf3gV| ''wG:P3 ..6E ޳R] 'C8Y7p|ONN^ tYuzv婍nj7|Gݙ5}V 7~w0}>Ϟ|l(??,cyy1aV>sf0CLlΝgJ+9Y133  ӋNFUkpd5ٕ6R!tt*+37חߏX[(xNrji8.2\^޾}LzNF-)Ԅ ֤ȪkԳ+xdCБz[<= W,*Jf.]:"ͲeS-- EGn2m[[S)(ڴi;A&~;ܺuGl@[,, LLzgfFeg9rͨQNɓ'۠,c^~7:t(fI ?rt4g*MO:vPSSHdީ0Ǡ礟4"ʨS|BdhT& GV]]y1?]u6(r5\Tj'[t6'Ǐ_>oS/\H: {7{۸q>c;w#C,c6A/"\Aq9CA2" w/1}vCrرmPCa d CjJmc ШjM{jQUwxSmXDtp?yFf>]vbP];wuݱc9ُh}i]v̌zLΓd_?  Í598xzDR\?G(5ؖ.HtuuBYvAdhT& GV]k={ }y="74hhPn@tT6_~n,$Ioh) vdooƽ[Y}aYp/  )ߔPDZZM2sիnee3€˹;rp}P'2j~AdBYmGˇZl)"C5i8Zke0gv+sV EYi.֏APo<~|*Ν<tNm]hT& GV]]y/Q"X=k8~~N}9hT @j+^9hVZt?\uѨjMc Yu쵁xt1>ڤI1- Ui!5P"5j**\IU 4ƐUT^K}NK366 ШjMc Yu쵇xJ$$$ 텘ШjMc Yu쵇x!t5"+4ƐUB^WP"5nmm+"88U 0..6=zo޼){<{{{u{ܹYOPV7u>h۹sG++Nӗ]-YѥKGd>{g$585%T6e^i g+HÑ4'$$QhTVEen-Bdf]iK1׫ׇoI0dHϧO ʊС{p:ujkFFZjIP(oprY] Rj|^ԧϏ+#ejH Ը*ܸX^՝r4jsUSYƯ*r;n"} OJJfJbccJs-[ԧW Шjx V⩗6`"ѨUMekL2 033pG.^t 4iȑ#LRA1f̮OdM,$ؿ?:uy͚5Ae0ipS8}zۅ 'ޤ5\bYti7 z:t܏A ʱcAUr lzFfϞ:t\ [l̈́#`hѕ+COڔ~oMMKpp0_loU7̢_}>(S?!:!G4Ω vءz<ϟAq\ZKOdrο*Ÿ(3Tczm# *4j3*˟NA?mKXWNK ڋ!&&FgV^sέɓnjztJ4ZW5;)u 6,"R: hF.}SSر\CN 2bGc-r[~.?עrלnݴ].D*w8DoY~P+<{{-cs];yzڡY\rM&ПJGE)ڽÎw()ٳxY3ŠDZMzO bc(S?w/ kN^fcvLU8*WztY]\lؕ ؼr򚝽k1YD>xWl.p[񽅝89s&H ~JJE>,f>{qUxКz}G)Q?͛/И m|ΟAJ.QxuT$f:e?Qf~SRBee ll^JAR/.ދiLJH9d{UA_~nr}S|y1={S9W2Z_əCU?Qfw}o־}rԩǏߦ988`jٲ% YΐOƶ;v|b6nȄ۷wY; TTTT2plp޽۹sgg/VTduCZ. ױL3j9+L>t57;w\c? n ,XXggEFB{|N^u %gj3GeT8Z֗D)UGז(3SKffى7UiX,lkk{٧OZ[[GoѢůOfcjji8H4@رێ=,..ڵgffgggڵc'᠏x 逺!j-b! qrRZtl[)jjJV{o^fj?ܸ>TT:WKЩpggΜjڴ4LɤYb2a1 4\XXVI%sJvv6R*xBuH*rŋ+ȓUճ KmH3(u0wGCLSYt> bnnnoܸOo>vf뭷8 w }}'O`͛7VRݻwg\"j-pd5/2x[>H$Zj-,, rvv&3 n&&&/_&قT:W-ZBc YuM={CL-=))o߾UxC51d5j_d5h%%%>᪋&TkcȪkѳԾkboeeeETDGG 텘w{xM-ݵP9ЩB{!&]ex V4FL&^^^G|D\ %)--mѢ#Wáڅ8''Gh/ĄX5<Bܐ#TÕ۷ȚDwwwD022ZtЎ⦮4̀sckþ}r?ĽzesNڳgeuK{HpBDኊ|}}K(5<DKK 93Dm[ Wr5\X̵k1~6^^޾}L="C- #jMT o``"F <}k 'ONhefz ](M[,, LLzgfFeg9rͨQNNlciidl+:Ya6mZN@xE/WUTYRYGEEq.a`ơCOk=\)0i"CCCoJKK>xY&K֭-%%%ӓ DQ ptA׉$Ls+e˷8 qe˦"c;w#CA ݱc UT߃Һp!r 1|A;!p|޽|o@ ҏ9Pa0R~wZQQsK_} &LBh"=G2&: w\\^7fffB{!&DVj 5AST^:wm)&$s͚,lji]v̌zLȱcd_?  ÍZh9  4, mwuvf1~)Ȱ[7miWoӧ .Xr3٪͛=\)0iy!* jMT 6ChCԘ4!#V ;_+""ӬXp"fv:Ǎ@1Y ]7lŋsi/BCePfAÝ9/䞇k8W(4ܪU,~|g:9)d LD.555&&Fh/q jMTR4pvۆ:* 4ӹ.@bi[Nji8ij={$D}Otnl޼.65C̱c?Bu5\u"s 8c#TTfeeϞI{}'2{$L!S`bpeee襋vDB{!&Q-zUi8CGF <ЭNAt--$L ]HH1"kLeuZg]vb)(ĤGk8l]= s-u|g%Q/d7nfr p+<43N1{$L!S`bp 쥾2hkk 텘M& Z2j!DPLeœQ۽GYk6rXgEFT:ww 0Tmp YUTW"BIDPcdd$wq~~~=Ch-0[uw]甚JpyAV.##CGG^@T uDpwwrBom_Õ4उ1՚M4yjVh AL0Zl)bB}5QsEpd5u}}}]]]B]1՚CBBBv=kbbb68fo&B G&^SO GҍOlllFEPjM9t=kjT{nQ/ZlIVyԮZ@ /Bt(xJ ,EEE^^^B{vy8QjM:GAi8 ?JJJtuul\Zky8 57&&Fh/Ԕnݺ h P{A &tN Ղ#:G! B唕nZ"ZVRR"4\A]%|%fffX!  $%%N/)C\\=Ӡ<47<APkii+3:4AA"лt4\A)j(4\#̄BL$%%U2!NAh,t:4j?##SH c 5CR^HÑUH cccB| hШ4Yu4AuNQQBDh/DF `Ȫk Qi8kkv pe>eeyS;w2D9aD+QX# GDRVVK1Ԙ"֖h&F ѩS*YַnȐ~!!O"ݡC{k.^UZ8FDF :$00Wh/DLtt^ĥnZ]!UT<9;yqh?#YQQ2KӥK+W$ܹ>}]y8~Xkaa`eedb;33Jfϓ:+#"# GDBD*A0h~\5ϞIp4T|",Bro^y騨9˖MEW_4H!!av|7oq|v YW:9YB;Qi8 Bzg4j,6ƍL1ҫ>- r>ެE N63p v.33 Rf޽|??'[[S1o=:::999B;"z0*F `bpϟK# ΟOsGN!h[|"/!FG=h~^>㏣r0Ğ=uPsVd4 Oggq,;~ysrcbJJJvAHKK ѠQX4g.${x9c,cc |PK=y݆ f;b& 3gfFuL7ܷo5 idw AYYL1"2pAԒpuEQQQRR^D1i%s~ݺieܩx81s,#ODg}YOUT喝ǏtwQ/. ]5j5mw>mff"srb{@ ~+g Os"ƍ@b(̯N<[o5z7:ڏX%LF!/һvzD~bhbһ]w/re?(} 엡fk’ϧ￐5)f$GE͑QK'NluL=tHL\;-u*T믿>s#_UVy._N4jms^""_}SmL"132"9cnښ~'HiSbd?rdåKXf6F͞=Nu0pAb]h@k׮Th/āF `'EuK}o8v>Kb_[~5acǜ,m۾6*++q|֭ +,6v¿RM4g$Sq~؁<;v˖@wE8''olܫ}\(9ggkDBE!O?e"|Ce2ٻ7 E=z~NG8C'^ m_h5Fv:$(,܎mAE#B999Az&<<UGÝxB[.Nu{E<)k% c[Bx ݼ͎>'Nl>RQΛ Y鳊ʋ]t+WhԨќ9LbRY`򧟮nѢQd2YaH=Ro>d;n&MC"W qdѣ:vlm)$)v"H"mmm: G-5ڠ:f' [}4O4^e,ݻ۴i9f`n/5kfc}6yem72~9"ϣ}tE#R5m# XPϩ]wZn`Gd24<@2H7,B>>yrdI r2n̞="H hp$%%ѵT%ѨL4q}[;Ms)#pdi8 RTT$ ]]]:JQiʋ64l ~$.#Ojj1=)111tNI4jSC GFPO^#{_Vőm&#qᏈTP\P""↸ JQK PD8jxCL4^IQ4.9멤l>|>穮;_]!+hBXCR$&(R+;;6zĚRA uP4#\×ONNVHzĚRA uP4#\WJJ }@(kJAAьzĚ 4!h1oKױ3GZΝ;,d%M.>ER#l=x0nި-[lFBA!h/gΜ٥#n>11l?u[G bu/<+…^yM+֌ 虗Æ ɵ.̑rss VHzUU%c8,{In||~YvfZ,^=1ei^^NϞ)͡޶o_4ܞ=f A_7Fiʕ3<(AH P5}>}&q.R>=eٳN[y6)8-goAl+VCݶ-->ӑ#){8D?A!f!\\{oӧ 9C$IM]EH_>y5kf"磏 l+,Րj,L 7ܱc EٶЅPP~'N-I +00 >~{.LIYE??\.\TM ͛^<|˗3zkCpzNAelvV͑8sf7l;w.mm+DF:Z8wxfeS9L fڈ(0G}ד',Dkٲ70][2qFX!=}uPf"Nv 3/o3%oѣRDc\E1e5|)2d&͛~5s$rl6nŵkss7!燸:4ܑ#}ȟ4\AA&T\+ L9:6<m[xjFG,4`8L$igG .]ИsrMX1{]q+L d{=^wXcƋӻwR_q.T4 "a E%K{W?X1)VHz $ߺ5#X^~b4\fZVxHh8(6__7($\wyx{?WN˖M=x0YSӄ\h"-`!;jׯŕ.a-4o[m[! 4gIQA uH4˗3gbx9V,r@lll3k_f#vIIgKA5lmÓL 70(~ʣ,mu㫏rXT5czy9zBɍ;^aO4$Où:`9~UN#g)h8mGR᫢Nl+Yy@}КÇ;k9s߹nA^ܸq<+VLG<fi*j޼ HJucX=.g|啿2 qG4VxNr)|4BV@XSR$&tD3u}=z>wKvQm׸H8Ďt0!֋֡=X5~Kqqҏ?۷/B;#(oG2 xNmk{ʕfLnVHd/5nǎmAfYYJ-ñ]#HC!mg LA"Ν|.U7F#wLij4pFm&Ҁ<4k$H6<a;o f^:zr0Sq'BUs{ꫭXz@s(M YX43kM_B3 f[c:<)g ^I}ѣ_lҸՆ sp!MSp mm]\왊JL\{ؾ3BC 5{wDcJrU277 i@VP ;U:G/_. EAԡ#ʌtN;=mޣPճWm+}>,Q@ڼ)3FB;[|TӡEPo وT4?=}gMTo`sԽՍGy%5 AP 5ƭRR#* Dp y3O[upwDcJrU i@V`sJ( Rhv ];O5s/}mrѷ'wNI Z7Q=ݵznݬ>|xiwA̜9̬Ç'o~CΞ=}7z3p`UfL /~+ILڵWںW_@J{nΥj܊ _ d H{ M_Um=KNhP\I9/j8MDQHA`bO[m]~܆D"=95qU/@k-ӕ{BaΜP9/ܴgG&>ޫu/u))y>$OƆ@@f=*XRX_f9#?m>~ CBƠaj ܴi> wwVGqzk`qph\pwD[BKrUi@VPw K7\~FXT4yP s_zE\sXS;-™wq/Z4WصPA ifj<Ƨ_pDSKƻf\0^ҥ`j{E"䶂%]faA'D4Lӄ!&iʛ[;-Km\q @V;E%5i $ixcGw :ths^Rw3{@gw仺:0g^f(֭&رÜrs7=~|~TO7=P~￟mQáRKYf&j< d'Aey{y9M U ;ujOels9ш*$ElEz^VinEXT2㊳gݱcRڴۣGIC>q-3!u}/_dOoc :/5usۿZ]}`+rA~q[ip7/`M|>6()SUϞݍ ~r}Y6W!С}.^Lg{D HHRk۶mUUUb[!El^tr܍EdM{ jN mTi8i۷/<إK`O*5CX'O##^˖Ϳ0:zVB|!u {֭7zV^\ON^=׹sGP3 ?Wc[<дƔ) H4HRƍb[!EcF+]w*wae?Ѽ=z޻ YwgW<O]q_`JM]j!~OS88hի`̽{qqs֮gۂ;w.4\) H4HR <@[ԳL :h*FT/sRubt6h_e3C$:Cjl'UPlWP]xfމo'Cq[ipIIg;b@Ѩ}Ǐ# 1wB UHRkJAAmQ/a&n*EbخT/]G;uj{o!SzByC]5x-~bKNc8kӧ{CϟȀzK]iӗ23ײ !ݰ-T*|LeN1HA -#ꥌWJJݻwŶBzni F Up-XWOig~\Ϟ<($S AҐ+(z`޽QF L\܆OֶvZ\в:#qrvv.-- @V;̾-#߅ }׋nSA iHQ1Z|UƙO~zSS@p|(𕑑A4YytQ,8$ QYUUɘ1ǻ><9i[h8}Wpuuغ5<"bӳg nsh1ųg*. vM\ɚ1ԌwO>Oɼ|;nK@H?2ec'N|֭w <<M m 7v0qrS(`Ɏ9kyu=˳AHkJ ӄ(,!a>R5}k%&.LIYE??Ƞ k|H7uh8ʃȟ:̷ZzІ/F.3s-+{w$4ϓ'~~Ͽlԃ㐈i|i|h"-`Go~}hzj,Z-޶V< W'7n^e rss+**ĶB#֔2ICh \'Mr3~Ԕ)CBƌrz6 w{nnpw#322`ICa#sF HR7D& @Eݻ[=GmhkVAΜ9zAϿ97(\Зsl+JW'#^Yyi8bMIA`hFK"B!<q$H͈z)(<q$H͈z)EpBVQС3t{vfoe6GֹsES}w@UU̙_{MiRFٝUfX[wDMxTQm١)==^mp1ϔ^8$ pDEwԃrqۆ [ 氷!zxC ~\zC6]˙3gvnrs47ΥFjw( ^ geވg߽[$Ai4Q/eT @V;E%0f>Q؃5kfB lRVaa&n ۋYjlΥ#G5j̙٧y!Sӳ UW}ſ ӫL=~|~TOT#1q![yyy\ +W:8t߿?W_md/8;udqqР o// \L Ű_mSjp";38G#O$HM ###ŶB4Ѯ/ <݊$$+pH9uաC_=('U _.V4dPj ,B!o*ߎKľ}Ѽ/8 b{yMo ZMp{/pBXd')w{n}0n y [m5 X> iw"D'dKIL:(P(ĶBhz?꛽?T/= Z ^s玐]{th~*XjFfZȬcU+VL߾}cǶyp}MIЅAAaɓȀnjqnٲ96ҥSpO^fH.-aЈ0^z|azZd^ea7vC!, EX=^^NϿ}Hǖg׮y[`3\209y!-ΔRY΅ }AAmQŘJŝeqXDzh8nb]ۋ:42&''޾?b"/HJZ,Mx1{w+)O/gKM]o͕[vW"9z42.G-]yGLh-x,~(%XJQB?>p`/<TFm d ٣Ң\į_7v\e i8^8|UTTm +,}/Z|l"28^he HǏ+U%}O>9dmpFoOȬ_27֦^*7Zmz$p!W@;`069th{ e,-ofbsW)ҧOWv;’BEK8wh Vm4DcGh`y`D&vU$Hz)𕞞(<@[ >a űck2@5" _ګTIzB ,YOe]tn K<Jù6mTZH6ƫ /4; Jլ2AAm۶FP'99]{ݽOWd lb߬X"p4B~e^C+)TThk8âPf^*{ 6})3sFۄ-rgJ(OO$H lD(Jb_JBB)xAc󬸻0g^O,Y3ͭH(UE;v]n&H6O1Gl+#Sz"ѱGbB@nm6IcauvLm;2z||y{y9M !5M V"4p:۳gNڪ=>~.i8B=PQQ! Pِ!Cȴ4m ieV$!E.p;v,aECL2\8ٳKJv$ií<_>M^,,0n y mn>٤l&6)}>զv +4mEp5ҋi!** ݻmHc;v|׳Ķ`~NNNrr2qvvvppPtĉY> 0='hp?꛽?T/#pP'J\2]t ¨s:]{EF¶JO_Qqe5Eh_s\y,j nMý3b]麸Sq,T/wEL1^ѳgg>[PBd׸9k7ŋݻ[O/gkHM] fRpXLH<ܠAW{ufL;'SX~MoBzjH\ h=4/$$wn遁pvvӀ++F2iʀf4** I1h5Hm޶m[bb"+CmcٷE]ypovkH.>>B`@W7p'F5HNNd0Ѳeˆ7QbL4 #BH50tk8"Q)w G0 +++Q0uXZZ6'h Cڵ3dFp^L{憇;m4333vWgZRqm&p GKyk8ZL mڴqttj5H0P5k3A1qfgg'&&rSk0#ꥼ5\cڨ#Ֆ-[0FEE, Uꫯfffk Z\* }6>> D[#*<@p"PrSr͚5 bJ.44422RlD#}$i 9}jpYTTYbbR5|辧ApC@ ܘ\npzk׮<vߓ=ᑑT ^ 4D+Ce5Z#ꥼ5b#K 9{i 66&gff8j6mf_  aZTTT }m?!=%7HRٹqnrDDD\ a/ɉ3qzáGwV4Q/hLyS4"**jȐ!`!L8qR5gpY22ԮC~+Y{pn~cGZ\UU2s^kӹsGw~UG us ոeѢ)l49$d<^1yk8! hP8;;s~t#$$4`g?G 4._ bqqsl S&f :OLL05??C6B4q tm߿6B MU/xVHGUې?i!C{n QBBsiÆ$AA^^N&Bh++*2Yں#ʬY3ͭHhgd֭&={ԩ-]s'ݽ=ƫ(iaNNv YzV7kxԩqt쑘9 cs_??djpu9,JDu_ y 5* .9{IUV̞0VVVd{ >M߭HB$.^L/) ޾gek+7/`䣏A4)Ss@gsr&!J kp;v,a߿b߾h$iifza y+>kU&Ba᜜q\[hpu9, oS_X!|1 '4Qi\G/&zZ֭[TTXgddO~>M-`o#Sn,"S̺u7lKܹ"cgt;nʻy3 }\ :s"]{pbر-~~4$t쓗SG¶JO_Qqe5tPPƹ??7 jiV;_L kTL0uLUz0((,,4777CiUW L:ipK[0jOȮ҄uk 6 "tXϞ<(<~b"U\ڵ8{4<<ƦƄo̾-2#_-1.\蛝*S(lBD\^e0.RRR2jEE>B0a\[DKLLeV:1##Cl+d~HCOGGG+Uo=S4Q/hEJJVŞuC1iz5 !#ꥼ5 ޽۪U+$llҤIq:L6̌^2%Hz)o WQQ+9{  27t/L.HR.++=L9{XW qtc-###>>f'Hz)o -9{X%k0@o_kNU>Є@0b)Ad*C?bE Os0(Dv pPf***,,,hrzAtxxx#4 ጉɓ'@uu5m%onnP(:?H_&wޥBi8ʊ^e0:7nٲ!5L\tА g4t֍ WAjxǐQB#j۶mb[a gЫ Fn ݓ8={Q,}և`,RRl+L- #p'NX BDAp4C2)))666 <3d&.`,һBÃ4\]^e!+++鶜5m4L ԁb "؆d]i:/zp0m6l&.@ocpLl+Lh***lllx` ]KnN7POVbE6@f Q.㞩^v4rpvv^F*x{b#dmNtˈ5)kʪ*6[q?8=`,PL4dBp'N k :A/rM &&A2}}}ۗu\Q4)$7Db( $i8\jkt\+J"7͆bD)yx ҥudѯ֦s? &Ov}E449^e^55M4\K5.~̙3tlV{>11O#ءCGJk}w tH x" ܾ-[.XFH 77OA*qΝ+-GGS=;:HL\|de;~^.ekZfuuupw?`@ϼͼ?6o@HuaT(#'0o d c BpUUUZR(b"7`/tqｍO*4pd7XDo۾g7o^fL|ѾmV͚#4L;v,a5߿b߾h" oi1} DnRa.J,QaI8$AtĶB0} nӑ .22`p1c[l7(VV LN^&,Ր:([X3 ++v)8'/o3o!wB_//'9&N159A=@NNف!8ѨT :hNkgG&Ft)CcMX1=5uo]@U{;d{=^wXcƋӻwB\ӻP9 7>[Pk'Lp.B9,Yׯ;w.29NT ‰r26}$qi'k8/gΘp0'9yrƍs9p 666dX<~|G/ųg1b  pU+CH~$ ._QҲoh1??0G*y8r:Z-==]pN`H&DeeVpW|66v>}_>tQ 6})3s- pSm۶FC@~= \U4[hǰv4 GN`Y;pl&sE65$-$bф4.cҮ]ҺTRhxWQaSpH)#>>'R.h IɄ2!-Po3\F! B $i8PeBi5ҭ؛:%Jpri^ 4L2,,,޼{F&W(It a@qh IɄ'R(RRRAu M(Qp+kP#Hp2!w"9[%Jp3F!q2{5cPQIӑF|b<N$pOF:44Fͤ$JpB7 GW0" ɺj8$!N\Vj{4HIdz;{͏e {bc,wV|PՖ-a\CVZ]:?]6X['*,VMO{aMDFp[[wu͜,~}hדȗ/43k?pX>dȉ|W͡|}}˥4$,QҜŶAGCLC|[y4ԗ%N~q|U뼹g3Ej8T5U_WWr8cLAé^p{~P=Ǝ /xz4p6OC^€wBAm۶ 2b2&&M%Jprb 5$t==f3twXɒE;N%7`HVXwϻyhf̐y;,ф^9h-heEE&*չsG u~ 嗛 OIYw&>~.Wz- ֗uPEl}FK4V%XѶmkgw Wn4ͭ?af[ wDcWpzH[3 ''}>,T2Ǎs*Fo5.SCBuFBy i8;Bsΐ#7LÉI xNmWRcmFe⊢ 7› ! M|*YBG>iȣQiƱ`楣G.OI >=9q-Tm޳gW_m+W@&v 1 ffMӴKHabbJƆ|޽m6l ҔC^yh C]FK4V$Dn&Ƃ[[k{֥&&.Խ0BC 5{wDcJrFÉIEcq'Oʕj+6iP2 tE@ĂQ焱=%O^=;?{նW2coOX0[|T7A 3ܽ:Yٳ*US6CPE&2-",F` FK4V@pc&uڪӸ#+h>>b[ѨQ.tHi G4ʵ˔p jruƀwmEuDIN&k)!apiԛ)`$ 'ʵ˔+#H999b[A|#6IɄr2%J:A2( $i8P]&D)W$4L(.\QCE_ӁD^AփRXR3<|ǰ)jjQX{dMZÙCe+kJ:\/!W.r4~W%$̯Iz5^&M!B݆Վr2MS)WTVVm?+UU<~ ~Ó&gٙkz WW[#"yy9={6Gg}"eٳ ij:K{銊vM\ɚ1ԌwO>Oɼ|;nK@H?2ec'N|֭w <<M Aۖ na(dP6>r .*Sp2vV޻W]o.<VO'RN0 G5\R~qV^B|tJw]{/1qaJr, Z@Φce?r$'zOAɝ;!!c w&\GsV,1 0 h8fe6$o[n+연 :Y%W!x[}]ш`!µ< g8hTFe\UUV4\bB6T#v˟uو3ݑ];<)~Q.[68$gm4}.0:HK{>6Q_A-[˫Sov/Id QQAkyVO'RN0b,QC 4l'Lp,O?)\u9ںlS^E&2[m,ڡC9j`sd־}={wGx r*D3G*w:; y۞;ʶd{kQh8;o+deŶk_~9#\̰z:rc 7بRNΦwQM d)RP]]FlTX)'XXX( huDIN&kiDWQ7n Moo.h IɄ&EC2fnn_P(b[A {DIN&$ G4)rI윒SUUU]]~weoȩ0~!i(--eg\=]YY>)ƆLY=_cbbʐƯz:22i ӹ女}||Kgddᗗ1cGܶmUO[XXqhO. &*&JdBpD"NP>oaaPPyK>F}_>0D+f`͚5;tШE챵6i;զ`y 䥵6}ߴ'~53~JV}ޥ `06@!HrhBNĉ3Wq?6mM]BiIHkUz6 WS}_Н^Mjl>@6q8y4Ѥq-[]TV@ e;<頪ёfe0}4.hWÉ~l`MҘ`( $i84Ѥ!p"";;=G0}3rN&6@ф44)W(޽۪U+Aqh 8<(.\QCJ4'!P#Hp2\Lq4 ƀؾC4Є`alBNkI(Q!nݺmIS~/Ol`]Ñe(ꐒCEEŴiĶP3\>c[DB?>YW Gd"kINC vj'6$ȁD\L(BDD*Eԥ r%wowhQo*xBUm0p;^͊cFƚE!(*je~!YژyEEI'-w7Eo@`UU̙_{MiV]΢!讣~"rXtx\L(Byy E%ս p]\ ܜ'jMp8zeKRzxu#4T8~MU'EԩѱGbBl[M6*\cGн"; $AA^^N&զv +i8GS?TZ P #իz؜WF7먟H .S!a9SPpB B-#y_xxYIH`Qm;]!kǎ%Oľ}蹦LgwDI9m8VNN¸q.X-ЩP:_>{ra}רps }F2}Y6ר6 'SX~vȐިղQ q-Z4C YzrѼ7o}\!Gبpsm1cGaG5M V"4i8Ԇt WWKYWں#6T/#\w"rX[))Q]]mkkKkI^ v&M(Tİ]3+vzȑX@`/>{feŲ.f6KA 6m1Ϟ)Gu"`Bڵ+Cϟ|*,.n.{( iӗ232t:bQmNhy; : aAoNۍΚit~8ݶmkMԩ Jj05Hm .S!a9Sa#--Gl+uni F Up-X~?wӦJzj4@#w"B .esOuT@s6瀑hLI`r_X7;{}5To@#w"Roki C²@Fbb" 8y$ȺyO4 ʵ4!a^\QXXح[7puDIN&kiCp40,WTVVVTTm8.h IɄr2%J:id{DIN&kI(Q!M;v$''P#Hp2\LrERiWAl+=$ 'ʵ$W(B@ e+JruHBUUUDDE( $i8P]&D)W4)@MOԱBpܾd+ռG2V+Lv$J:ƍb@/{EI컘Hh.1 =a}ga8ghPӄ 4l=ں#ʬY3ͭHhgd֭&={ԩ-F[{N{z='c99nVIA֑#{5xh0ٹAԩѱGbBl)lTR%Q*U_4V;kBtDZC5nBCAÇ;*{G7luxJw5%NY|||HH"; Kb[A/{^VinEX ]ŋ%%;E9ge XG )SUϞ-LhbvXľ}GIBrm Ox+''a8,~qsP9SSW(U}W8; 77Q+rz ygi8y:"AN95T6kf&{QN6o&o2J+&N278 Ba^@C[1}Wm--`o#Sn,"S̺u7lKܹYCw|ݺwf^^(re`r2t;wDO uٻ7JXו;C[A`.}6?}XCtWVXӷo_MdIyddᎰe|S)lTll,OBYcNhH_@ѳ 0YrM VV(8Y]]m6+++=F KnH^t]ܩYEdX>,>@G6a+ˁ8w.U#_^z#|]VXF wEet)g,HXPQ_[%޿w˗$%-F% =p`/Hrᄍ 77Qj% gi8y:"~ gAñqNܾdpFi2lmmmll.4$,!aI0***BBBĶP,}/Z|l"2ˠ bӧ G_4\A͞=vĈH:}Ǐ+UBJX'0ە=IvxJS+ OZZ]JwۿϧCF% oѢ|ll3s_y3Sبps^_{ pBtDZ:p Ç&{ou?::N`ťLL(B(d)FC’ᐄ'%%El+ mq/a&n*Ebخ[<ٹ/Ѩx ,گ.h̵0ADNtXTX* 2=S.2q:r VʕO7x- oVVUeڴCBƠ_=7n D*bϵkh':pv nnT[=a4<V3ā G6kzkpo'=Q\ʔĵov"""޽[/Q~@CV$ApD4a]Z$(1>~MlD: q4u{ܹocyO,S!]feee@@^_!a Tl+ ̞FB:GzmEnBTym-ہ|}{))qS˔ix)WiHXrC5uHWXXV]LdšvRy}%JpF.H+.h IɄ2RRRlT0WiHX$ G  $i8.])J(Q3"pEwQ nܸHqh IɄF2MUrE4K,[[J !/sii):=$ 'Do%ײeKSx}\Q$ G \ n@ eBEEE*DI((///,, B}ɩ?nC$iG&zrƆ޽EUoGV[%A.2\f`"/XJEQ#tUE@@"aEJLACv"L ,SK ' }DH$JMM#Ю4|4L Mp%z\GGD@腟:zÅh"d8lH$T|D/La.//#ѐ;zzzAqrr?\<=^i؁aj[[[QM$͟?_pᠧ` 522UdlV]]> *zJWUDII.(ɤT2L_U)SLGy* Y47Bރ*y BwDsQz;v,TVrr/8d8U픤qv[@xzDhD2eP2M_ WRRBw>~ұ=zN񧡡cd8 H"^o'<=퉪Ɵ #d8P Wiٔ /t/y6e()d8P!UL_t;655Ur}};%prdRÙVUUsI=NOOh<={vC+ @uajH$q'( ~~~BBCЗ ÁLpB#A e88D"Qrr雒p7sJ&}2L_Qk/d=F999ե{Bwg!Á՞Cɘ^eݫ } MHdd$;މ0hd8PW0}熺D?} ]Ai%<<\s42ڍjkk'~\\i+~'&&n޼nhN w[tPw _2q(ixVnݢg8p-LaawLLLTT᨝yw#õ:N,663| ÁJzzzzi/ӧOoi=M.77ϨVhjj s,õάÅ-44T"d8:vʕ+Bo Áfwrr5kVHH/Z[[_vX,Yzuss32##_mjjHq6li*d4BB}Ho-4BMO.MLL8q;Я_?ʥK_~emmm߿zNsji9o: 4%Xz"JJjر|@Qnjo^3(BMJA@yyнP3,SAxLc>>...999BB?f8N@<}UNNNBBE!(0{0@*bƍjʼnxexKKKup$髊eXOOO E: EFF WQQadd4|;w <*:z.D~n;=%ED)V쓦-? co @)l>2kL!!!IIID"V:@/' <zՖֻ^[Zzzz ݣ^E>ɔeq~P;t~ tFII RGӫq_r%I&siiiBK%]@= 4s*,7BwDDDs(ĻD"Нȟ^^ U6}!CXKNNQܴiS^^T*ק/tÞ ᚜bz2@cW]$EMfnn>!(Θ1fڸqСC5 BN6}?&7xQF ݝޣ㣙`_HMg N_ݷo=*@g=zؚ|@ExuM_MNNV6s*g8DJc;^2}N4jD J" ^T- hj}^mm-:{r?/*ꊊ |-po>*ùut׬/ZK/tr?ر??'Ùe+Whiii7) jW{.?}ZCN5۴)r9?pvI2\eŽ[Xf P2髩=1}Yz"Y.r޽k3\Sy\DII+Vb=ɭs2&L-w-=gJ,6.(H[ y@k+ FTEW͛vvv.\qpp^X\PP@6lptt -;vl̙6662 dooGqJlp"E#74%$,߰a{MW%K<2;vf{yĞ=r|.{ĉwkQ GO3z)BP-M_Up;v`Y͛{)**g+9޽{J^uf8eӦMǂZ2܃"//!C_vVfG֭ LM}Kq~~~e8  ,(H@)o~vɊ6ccۤRiZZ'sTU G 0((Ç ZfffRPJ7=z$=|8BE%mTW|Fmۖ] =}ܹE_h'\;~+ׯ+qt|;i,õaCCYavAqs&M{ﭹ{T-(D"cc㞾"ip+&&fذa>yDDlll(õy{{QQQSv寮4\p-oQ~BZ<~|U_z+r͚g^P0z,)n}ӕ[ܻw]#I,QQlQ 'H7ST:nܸ{.;;~֦ [QQA+镖ZXX455Q jph%w,-͝t?23deKȲe)j?\ؿYYQTosܹSx_|py-=ŋ&7;;Znܝ nʕ&&& }2zK/4dȐ1cƜ:uŋE7Xlcczfp(nܸջq ?}5<<{ N]%66?W!%髊_D9pnpÇ7ypj__Et%Qgܲ+*CP{ZYYuz?pNg8m ` G&&&FFF{-G>wM68Qek7x/h'f8t7]4k}QQݻإFǏzZ~oͥ ,mذ_dJpM_:tK/ 6q^o?lmmL*Yp?#8܉Rcc7766>|([0p`v42r -ПZ_|!anӦ o;p z6m*@Ph/"B[a?sA w'/-krr 2J[@4[S⯿pfi9->|(mj:zxLծ];*{DRncO '' ' 5g*55u~ɓ'>՞U!ÝAA^n z nd8DUU}< }wMn;t75SS:r$k_ 5T쳝˖޺ d-J]r[y(7B8O.>q]~R;ZZƔbP\RZ F??oU&:Ki\WJxVqM͑`/V"ڄprtoײ|80Н`Hg;)um+mۛu!@OxpII+ر+J9{o_X^{pYYQl]"(Qbu$A9.3fLzkށ1T\m2Med<>XxvIu'[|zZRN6MaSe>>^^s98/_k/}GVr5FDիХS#snnrH5 ǔ7Nxv]/-+Jyg?hekkx *+Vm{L:۪F]24 ^@y/ 'xAa28pd8P ^@y/ 60^ 0^N xd8 2(p/p<A 0^N x>je5^,6655xHJ[V+)I B8Besp-w1ߊ~77ӧw[~g0^+.?ۼyngg~BVMK''+ظ 7lXhemmBZ1%(ȓvO2R74=^о~HBC}d;CujW%?j:lggT8gKӼd3܎YyĞ= *.~oH{NQ Gz -,~MEHanĈhW^Ç_~yt ^W9E˗:| wpr]\p ,ybTp gccJ٨favC11oDEnB!?*[tLzzڹs]٧G ǯC pt];W,#OqqK/p '%pp"0^GpS3\iӧJwOikkQ6ZQ8Qrӥ,,65[՟tᢣׯ_HǏ23#o8 xd E7__Gh<{*@y/ 'xAa28pd8P ^@y/ 'xAa28π Yjpq8 2(p/p<A 0^i2\|W: Ҫfѧd8P (?;U>} 0^i3̦§Q@y/ӕ wbĉF ՟Ӊsi&}m.je5^,6655xHJ[6))I RfaaoGcbHL ʝ;#F "ܬOYWWlooqWnvB.ZFu3%*TU04YPHaTLM 337R¶9s\dw{b݇zD6[˖ۜ=Ad䒄E,6fڵFFzg5d8:i/4}sEj]_ -ccVoh(+,N1!&捨 ){QbW__-.n>ߊp| e3g)ñ!@8e8$V}vk Hra>)͚eOquiEEU(閖oa1,PD6{ɞK=|8j%,͟?=%eW_1U2M-Rs`N{.V]ǣ㋢ESnBj[^u<:X[[hbcbWin>'=Rcr|„ffcLLF\Gɏ.24eLnnKxٙefK뜆g5d8:`Ncr;K7 -P}s۶eݲ׋|4q8U n*}z'op<8ÅKaEK)9Mj6gH*M6,rt6 - ?^9`d%$(ر3llLxzN]x%">1%(ȓvO2^?z$5{Ny.6M44T^о~H7JoTvy/!@`Nn5*燻)TEBW p\%gvee.\Ȳ3oi8܎YyĞ={(.~d1Pb7PLO_KFNًy?=|(OC]:ah+*(]MĎ] #]; (پ C{ : pp>vB.ZFu"#$$,guؘ 1offn Q֡JUCQAA @c ۊ^^nsGD8;}Ȑ׮ufδchkkUe^ŝq9.|hs##={ƍ>ylg8*Kpi/^i11\9C('tFTT:|c,BI؀ SvP"Llҙ3kueG2E.>QOw G$tr _zx/!@aN{N/wUZ/-R:ESjag H餴} MMgRu'_}Ɣon>M6k=% YT3\tt iԇ, )s+>oe5ϟQd8{ : ppA ?_(*v;R:~rO;;/dH,6zJB24N/^kǎէn]-XM-ovv:p''-[B-M )#)G9 qqK[d4PIHX>ah+WQo2{ :p:mwΒGBr+\^tTx`ە*7m[n[ݻ'Kp<EV~[*R(uSIK{[4ֹ99[}O@y/ 0^N xd8 2(p/p<A 0^N xg@,@ d8j^IENDB`java-design-patterns-1.16.0/event-driven-architecture/etc/eda.ucls000066400000000000000000000237521312550536300251230ustar00rootroot00000000000000 java-design-patterns-1.16.0/event-driven-architecture/etc/event-driven-architecture.urm.puml000066400000000000000000000031311312550536300322560ustar00rootroot00000000000000@startuml package com.iluwatar.eda.handler { class UserCreatedEventHandler { - LOGGER : Logger {static} + UserCreatedEventHandler() + onEvent(event : UserCreatedEvent) } class UserUpdatedEventHandler { - LOGGER : Logger {static} + UserUpdatedEventHandler() + onEvent(event : UserUpdatedEvent) } } package com.iluwatar.eda.event { abstract class AbstractEvent { + AbstractEvent() + getType() : Class } class UserCreatedEvent { - user : User + UserCreatedEvent(user : User) + getUser() : User } class UserUpdatedEvent { - user : User + UserUpdatedEvent(user : User) + getUser() : User } } package com.iluwatar.eda.framework { interface Event { + getType() : Class {abstract} } class EventDispatcher { - handlers : Map, Handler> + EventDispatcher() + dispatch(event : E extends Event) + registerHandler(eventType : Class, handler : Handler) } interface Handler { + onEvent(E extends Event) {abstract} } } package com.iluwatar.eda.model { class User { - username : String + User(username : String) + getUsername() : String } } package com.iluwatar.eda { class App { + App() + main(args : String[]) {static} } } UserUpdatedEvent --> "-user" User UserCreatedEvent --> "-user" User AbstractEvent ..|> Event UserCreatedEvent --|> AbstractEvent UserUpdatedEvent --|> AbstractEvent UserCreatedEventHandler ..|> Handler UserUpdatedEventHandler ..|> Handler @endumljava-design-patterns-1.16.0/event-driven-architecture/pom.xml000066400000000000000000000037761312550536300242500ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 event-driven-architecture junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/event-driven-architecture/src/000077500000000000000000000000001312550536300235055ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/000077500000000000000000000000001312550536300244315ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/000077500000000000000000000000001312550536300253525ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/000077500000000000000000000000001312550536300261305ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300277605ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/000077500000000000000000000000001312550536300305115ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/App.java000066400000000000000000000060031312550536300320730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda; import com.iluwatar.eda.event.UserCreatedEvent; import com.iluwatar.eda.event.UserUpdatedEvent; import com.iluwatar.eda.framework.Event; import com.iluwatar.eda.framework.EventDispatcher; import com.iluwatar.eda.handler.UserCreatedEventHandler; import com.iluwatar.eda.handler.UserUpdatedEventHandler; import com.iluwatar.eda.model.User; /** * An event-driven architecture (EDA) is a framework that orchestrates behavior around the * production, detection and consumption of events as well as the responses they evoke. An event is * any identifiable occurrence that has significance for system hardware or software.

The * example below uses an {@link EventDispatcher} to link/register {@link Event} objects to their * respective handlers once an {@link Event} is dispatched, it's respective handler is invoked and * the {@link Event} is handled accordingly. * */ public class App { /** * Once the {@link EventDispatcher} is initialised, handlers related to specific events have to be * made known to the dispatcher by registering them. In this case the {@link UserCreatedEvent} is * bound to the UserCreatedEventHandler, whilst the {@link UserUpdatedEvent} is bound to the * {@link UserUpdatedEventHandler}. The dispatcher can now be called to dispatch specific events. * When a user is saved, the {@link UserCreatedEvent} can be dispatched. * On the other hand, when a user is updated, {@link UserUpdatedEvent} can be dispatched. * */ public static void main(String[] args) { EventDispatcher dispatcher = new EventDispatcher(); dispatcher.registerHandler(UserCreatedEvent.class, new UserCreatedEventHandler()); dispatcher.registerHandler(UserUpdatedEvent.class, new UserUpdatedEventHandler()); User user = new User("iluwatar"); dispatcher.dispatch(new UserCreatedEvent(user)); dispatcher.dispatch(new UserUpdatedEvent(user)); } } java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/event/000077500000000000000000000000001312550536300316325ustar00rootroot00000000000000AbstractEvent.java000066400000000000000000000040101312550536300351560ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/event/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.event; import com.iluwatar.eda.framework.EventDispatcher; import com.iluwatar.eda.framework.Event; /** * The {@link AbstractEvent} class serves as a base class for defining custom events happening with your * system. In this example we have two types of events defined. *

* Events can be distinguished using the {@link #getType() getType} method. */ public abstract class AbstractEvent implements Event { /** * Returns the event type as a {@link Class} object * In this example, this method is used by the {@link EventDispatcher} to * dispatch events depending on their type. * * @return the AbstractEvent type as a {@link Class}. */ public Class getType() { return getClass(); } }UserCreatedEvent.java000066400000000000000000000032171312550536300356310ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/event/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.event; import com.iluwatar.eda.model.User; /** * The {@link UserCreatedEvent} should should be dispatched whenever a user has been created. * This class can be extended to contain details about the user has been created. In this example, * the entire {@link User} object is passed on as data with the event. */ public class UserCreatedEvent extends AbstractEvent { private User user; public UserCreatedEvent(User user) { this.user = user; } public User getUser() { return user; } } UserUpdatedEvent.java000066400000000000000000000032171312550536300356500ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/event/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.event; import com.iluwatar.eda.model.User; /** * The {@link UserUpdatedEvent} should should be dispatched whenever a user has been updated. * This class can be extended to contain details about the user has been updated. In this example, * the entire {@link User} object is passed on as data with the event. */ public class UserUpdatedEvent extends AbstractEvent { private User user; public UserUpdatedEvent(User user) { this.user = user; } public User getUser() { return user; } } java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/000077500000000000000000000000001312550536300325065ustar00rootroot00000000000000Event.java000066400000000000000000000030251312550536300343530ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.framework; /** * A {@link Event} is an object with a specific type that is associated * to a specific {@link Handler}. */ public interface Event { /** * Returns the message type as a {@link Class} object. In this example the message type is * used to handle events by their type. * @return the message type as a {@link Class}. */ Class getType(); } EventDispatcher.java000066400000000000000000000044341312550536300363670ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.framework; import java.util.HashMap; import java.util.Map; /** * Handles the routing of {@link Event} messages to associated handlers. * A {@link HashMap} is used to store the association between events and their respective handlers. */ public class EventDispatcher { private Map, Handler> handlers; public EventDispatcher() { handlers = new HashMap<>(); } /** * Links an {@link Event} to a specific {@link Handler}. * * @param eventType The {@link Event} to be registered * @param handler The {@link Handler} that will be handling the {@link Event} */ public void registerHandler(Class eventType, Handler handler) { handlers.put(eventType, handler); } /** * Dispatches an {@link Event} depending on it's type. * * @param event The {@link Event} to be dispatched */ @SuppressWarnings("unchecked") public void dispatch(E event) { Handler handler = (Handler) handlers.get(event.getClass()); if (handler != null) { handler.onEvent(event); } } }Handler.java000066400000000000000000000033311312550536300346470ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.framework; /** * This interface can be implemented to handle different types of messages. * Every handler is responsible for a single of type message * @param Handler can handle events of type E */ public interface Handler { /** * The onEvent method should implement and handle behavior related to the event. * This can be as simple as calling another service to handle the event on publishing the event on * a queue to be consumed by other sub systems. * @param event the {@link Event} object to be handled. */ void onEvent(E event); } java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/000077500000000000000000000000001312550536300321265ustar00rootroot00000000000000UserCreatedEventHandler.java000066400000000000000000000032511312550536300374210ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.handler; import com.iluwatar.eda.event.UserCreatedEvent; import com.iluwatar.eda.framework.Handler; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Handles the {@link UserCreatedEvent} message. */ public class UserCreatedEventHandler implements Handler { private static final Logger LOGGER = LoggerFactory.getLogger(UserCreatedEventHandler.class); @Override public void onEvent(UserCreatedEvent event) { LOGGER.info("User '{}' has been Created!", event.getUser().getUsername()); } } UserUpdatedEventHandler.java000066400000000000000000000032501312550536300374370ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.handler; import com.iluwatar.eda.event.UserUpdatedEvent; import com.iluwatar.eda.framework.Handler; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Handles the {@link UserUpdatedEvent} message. */ public class UserUpdatedEventHandler implements Handler { private static final Logger LOGGER = LoggerFactory.getLogger(UserUpdatedEventHandler.class); @Override public void onEvent(UserUpdatedEvent event) { LOGGER.info("User '{}' has been Updated!", event.getUser().getUsername()); } } java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/model/000077500000000000000000000000001312550536300316115ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java000066400000000000000000000031211312550536300333670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.model; import com.iluwatar.eda.event.UserCreatedEvent; import com.iluwatar.eda.event.UserUpdatedEvent; /** * This {@link User} class is a basic pojo used to demonstrate user data sent along with * the {@link UserCreatedEvent} and {@link UserUpdatedEvent} events. */ public class User { private String username; public User(String username) { this.username = username; } public String getUsername() { return username; } } java-design-patterns-1.16.0/event-driven-architecture/src/test/000077500000000000000000000000001312550536300244645ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/000077500000000000000000000000001312550536300254055ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/000077500000000000000000000000001312550536300261635ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300300135ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/eda/000077500000000000000000000000001312550536300305445ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java000066400000000000000000000026211312550536300327700ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda; import org.junit.Test; import java.io.IOException; /** * Tests that Event Driven Architecture example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/eda/event/000077500000000000000000000000001312550536300316655ustar00rootroot00000000000000UserCreatedEventTest.java000066400000000000000000000034121312550536300365210ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/eda/event/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.event; import com.iluwatar.eda.model.User; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * {@link UserCreatedEventTest} tests and verifies {@link AbstractEvent} behaviour. */ public class UserCreatedEventTest { /** * This unit test should correctly return the {@link AbstractEvent} class type when calling the * {@link AbstractEvent#getType() getType} method. */ @Test public void testGetEventType() { User user = new User("iluwatar"); UserCreatedEvent userCreatedEvent = new UserCreatedEvent(user); assertEquals(UserCreatedEvent.class, userCreatedEvent.getType()); } } java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/000077500000000000000000000000001312550536300325415ustar00rootroot00000000000000EventDispatcherTest.java000066400000000000000000000056121312550536300372610ustar00rootroot00000000000000java-design-patterns-1.16.0/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.eda.framework; import com.iluwatar.eda.event.UserCreatedEvent; import com.iluwatar.eda.event.UserUpdatedEvent; import com.iluwatar.eda.handler.UserCreatedEventHandler; import com.iluwatar.eda.handler.UserUpdatedEventHandler; import com.iluwatar.eda.model.User; import org.junit.Test; import static org.mockito.Mockito.spy; import static org.mockito.Mockito.verify; /** * Event Dispatcher unit tests to assert and verify correct event dispatcher behaviour */ public class EventDispatcherTest { /** * This unit test should register events and event handlers correctly with the event dispatcher * and events should be dispatched accordingly. */ @Test public void testEventDriverPattern() { EventDispatcher dispatcher = spy(new EventDispatcher()); UserCreatedEventHandler userCreatedEventHandler = spy(new UserCreatedEventHandler()); UserUpdatedEventHandler userUpdatedEventHandler = spy(new UserUpdatedEventHandler()); dispatcher.registerHandler(UserCreatedEvent.class, userCreatedEventHandler); dispatcher.registerHandler(UserUpdatedEvent.class, userUpdatedEventHandler); User user = new User("iluwatar"); UserCreatedEvent userCreatedEvent = new UserCreatedEvent(user); UserUpdatedEvent userUpdatedEvent = new UserUpdatedEvent(user); //fire a userCreatedEvent and verify that userCreatedEventHandler has been invoked. dispatcher.dispatch(userCreatedEvent); verify(userCreatedEventHandler).onEvent(userCreatedEvent); verify(dispatcher).dispatch(userCreatedEvent); //fire a userCreatedEvent and verify that userUpdatedEventHandler has been invoked. dispatcher.dispatch(userUpdatedEvent); verify(userUpdatedEventHandler).onEvent(userUpdatedEvent); verify(dispatcher).dispatch(userUpdatedEvent); } } java-design-patterns-1.16.0/event-queue/000077500000000000000000000000001312550536300200735ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/README.md000066400000000000000000000014771312550536300213630ustar00rootroot00000000000000--- layout: pattern title: Event Queue folder: event-queue permalink: /patterns/event-queue/ categories: Concurrency tags: - Java - Difficulty Intermediate - Queue --- ## Intent Event Queue is a good pattern if You have a limited accesibility resource (for example: Audio or Database), but You need to handle all the requests that want to use that. It puts all the requests in a queue and process them asynchronously. Gives the resource for the event when it is the next in the queue and in same time removes it from the queue. ![alt text](./etc/model.png "Event Queue") ## Applicability Use the Event Queue pattern when * You have a limited accesibility resource and the asynchronous process is acceptable to reach that ## Credits * [Mihaly Kuprivecz - Event Queue] (http://gameprogrammingpatterns.com/event-queue.html) java-design-patterns-1.16.0/event-queue/etc/000077500000000000000000000000001312550536300206465ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/etc/Bass-Drum-1.aif000066400000000000000000006574121312550536300233010ustar00rootroot00000000000000FORM_AIFFNAME Bass Drum 1COMMװ@DSSND^ V'9dN < )0g_S  8   K S U R  7    h  G U M 0  C . e  LSH X3=gH_GtHH{ ?i  < A jl'Pu ! w"u!Y#3"-#C"""O#"b%#&%g'~&O(7'(')^(Q)$(z('('*8(+*&,G+]**)('''&f'K&D'&)'+)++/*[*+)))(%&j%a#+K'=08-1///,,.,p1/2z13111./O,;+.,2E0#160,e.!&^  p( |/q+4d1X4|4 323K221/0S)+ $@64t=#&%l yZtw,!N(%&%([ &z -?Qc[m|Uh;5ܬN3ڳۏXݥC ۜ8pzД&ګqhߚof{(0νhJΫЉoƴ/*ȈǦ*Q)\8hJx`ɔqɢȃɷȑȤȴȿ5 5P'S5kIxNʃcʓrʢ|ʫɒʾɛɪɶ.5K+Q8hCmXˆ]ˊq˝{ˤʊ˴ʔ˽ʦʱʾ#)>F,V;bCpTzc̎l̩̐ˈ̬˛ˠ˷˻ " 5;$L7VBeMoYh͉u͙̍͠Ͱ̘ͺ̴̨!-7&E1R>^QiYxf΁rΒΘ͐ά͖βͦͮͽ  "-;/F5RCXPk]rlτuό΄ϛΌϣΖϱΣϼβν"(JUep}ЌϾЩЈ:іԾ5l!!l ~ZCY[e UHo"J3ogA-t 7 Q-d J _:"!I#"##;$#R%=#(&.*519x6;:;:::$8r8|6666586g9b89M8 98<9P8497878787l87Z8|7G8o748_7$8M78>78-68 686868"68;68F78D78 68676767676767676z76t76b76U76O76J7w6A7m677X6!7H67467-67'5757 565656565656565757957=67565656565c65`65a65q65n65h6x5J6Y536P56E56V56W56]5,6R56R56O5"6L56=56<5 64645454545454~5454z54t54u54n54o54h54]5|4L54J54Q54P5|4S54K5o4F5l4>5Z405M45C45N45K45?45343434343434343434343r4m3Y4B3)4T343Q43|43|4s3]4Z304t3:4}3Q4{3P4n3J4K3542424%24*34232222]1z2G121z326323232323232j3I2@212^1r10102W1 21h2t110000e/04/#0W/00/S0/1i010201000+0p////.|/.g/./c..>--D,-,Y,,()&&>& %>&%'F%)&'M)(&'|!#TT/16!)"!\!~!~ >V""He:j$ t X A e 7  Y P b   6#r:+uG7= lDDP6tQY5JVPVAuVkQ=.g;fowEQ,,_@3XhI; a]TZvbdiK0A$ ?+)C"o:7lV#&;%X%HJTROe?IRo@L5]_B[#U\޵R۩1ۉ߽ܠ[iݿݝݸފ`T':ڣ{ٌZ%+RNA'#ٟџџџП ğÞ󠳞꠫㠣᠜ܠΠΠ}sjf]XQG=A4w2s-m'a$`TV M GC<=32$&؞ڞОҞĝퟪ韪柡⟢؟џӟʟӟȟß~vsooklolmijs~vEW~n|ȝ`B'@CMx*ФҜȢ꜔aTk FFGǜç#9^&)ɩtTݫ~ǝ BZLǭ1LӯWQQ/r wFTFⷪoRӰ`C޻%yâyrŽĢ_;布ߺ~QĚ`mÇȬÈȑocZidŨ|MʻNW-ӯ5SƋjƾS_SRz*͡M:ΚҩԷԧ:Շu־}٬+52ۯYwp)EݤޔGz߂=7ݡ?khH۵ݒ$sW#_':GyImunwXcF$sF Wk / . R{K  P ;   Q-Q<d! h# !"$"9%G$1%-%$'o#'#'4#?%#9##r"a$*!%V"-&$I('+*,-g-.-.-d.4,-%,G,[,{,3-,/5. 1h/31'5P26q3725Q76O7E666J6g5656{6987J:l8<:|>;><>5<=CS9.?9A;C?TECSFFjG[HG1GFEF)CEB?DArD}A{DBDCDCEGCECmFCHPEJGK+IKmJK JgJ}IJHKuHL|IM5IM3JTMJMAKTMKN LNMONXPNQONROT;PURYWRTXVYXZ8Y~ZY~ZYZWXmXW]W*V,V U>UU%VUX^VZVX \&Yc]/Z`][3][]\^^\^_\w][j\[Y[XZXYY7ZZ[\]^_a_`k````?`{_Q_^^_^`(_"`_`l`J_T`_]_\W_[^}[^\%_\_]d`^pa_ayabbwcbcc!d_bdbddack`0bQ_a`maaccee!gcehei&dhRcZfae `Fc_a_ac`b`cavdAbbe\cGf;cfcpfcfdg.d0gYcg|cfae`c_b_b,`Bba5b7bbcce1dfegofgegWfg ffKeAedcd{cdzcddeeggYfhgiEghggegdxgMdh5didkelflgTlglhElMhkhjxhpiIghfiNfkfplfngphpioip7i0qisitiuvivjnvkkultm\sms msm tlvlwm:wlwzlvl=upkuk|ulwYm2xmynbzn{o} p~r~r~Dr~+r~r_}qz}ypC}o|o[|Jo|$p|q|1r}br$rsjsr~t}rt{tzr_ypzozo{oZ} pe}q}r}4s{t{5uB{9u| vZ|vx}v3}vM}{v~w~nxz~y}yb|exzw}yusyKsy3sysyu yv.yvtxuxuxv.xvpxvxvwRwvwCv@w{uwxuRvtut tsststtuDuuVv`u6v%tuGst s!s;rrrs3rttuuiw$uwuYvsu4rs=pcqooepJopoq7q@qcrqAsq?sqrrr#sQqsDrqr:rprnqpl2nijggPfeLfregf?hh]jjl@lmn9nnnnmmdlRknjti7hgTg f"eeeRdeQceb~ea+f/`qf`Ce`eadabaib`a_a]a\an[a-[9`[`&Z_Z>][Y'[WSXU VRUxPTNT1NTbMTNfTNT0N{RMQ[L P9JOIIO$HOHPNGN1GLmG+IEGLCEAD8?C;=B7:CO7N>0aR{?0C"89*V.2e,cU7=D\?;+ -IwS(ZTIy޲݇Q~93ݨ|Z ۧؽ)9q׫ ՞jաAԠҨ3Ҁ "UϒѣjʄΙȅ[#ŏ%ķQ/aT 4+Ö;-ɐœǷ1+Ě<ÞxĿ:οƣƄ7ŻPQCK;Ӷ#j >1#.̻hʺtUӲh^ϳTRyD-*/عomx{鴅Ʋm-a $Kŷ/2d&$ իҥh1䢚A[GVfWʨ-fѣvá˦ܞĜٜsꟾrO㝕DΝ=kpA'ʜzuNaQ#TX3/&3n,:o lv ˚?ܑ֘Lؓ.oœ(,d)ž5+⟑0@])xG`.`ĖۖWڙU@̙/%͜͜Κٜ^Λ P(ixԠrp С{Z?^㢸 ja񥍣t6oԧG Īi[1985B?maثέv5yT**ngɴ|*q ʼQMͺuCt8*d |;~-K|%'I\;9|ȣɏʹ˝ɔɡYL-d̑ʖοE_)Ѕ"ҋ"Ѥн6Y~ֽр8Mפ@؂lّ:gםؐ~پّ&CauK/5ersO;XT{s>_nr; wao' ,dom H,      ^ U .^ K  E -S %    Vca{(L[ O !"#$2%&D&%% & !&"'|$(&i*%'Z+( ,Z).)/*:1*02*3, 4[-4/581>5J2O5243b435363H73\839?39w4969099M<):m=J>^A?B?B@AAs@jBQ@CSA\D#CDuEDG9DGgEFOFDHCCICEJPCJDJFJHkKDJL5KILKLKLJLJM&LM`MM\OCMP1MQP>NOwNMOLOL$OMP@O4PQQSQTR(URURTrR>RQQQnQPROROT,P UFPUsR TS&TS4TRfUQKV~PVPWPVQ!VQgVQV%QURUgRUSVTRWT[X TWTVTUS~TR[TQUPVP"WPYBR0ZSGY6SMW(R$TPxRO\QO(ROU PVPFWxPMVP UOUXOUOUP?UxPUQfUQV*RzW SWwRW-PV9NTMSMMRMRNSNS=N_RMQM[PLOLNKN,KMtKqLOKJLuILHLH/J[GHvHRG9HFHFHBGGUGFF\G2E1G CGCGGBG;BGBFSBDBDHBDG@C?BS=@;?: @8@7\A6AB7F@7[?6=K5<4$JinP[r"PA&YjX .=\'v) ++43r(Er{eXVe=?Nl_)8y 7p+~jqC& UhTMO9-y<:%p"EE[qXa#FF^ipG|\X!n|t t}#5Q:}x|EN%-Niv]?"y!(Mew]`9CrYP6A.Gs $~'-dpYc'+5d%F?6Q+o~wl;F)M!5zj 8;d4,D\Qd<&L3 s/L|,],"-1]fQ'QqAzeU6 94>j]&Da lb\$]f,f `<7@J' D=+If w>`dTe Yi)6A>p~^poan@OmQ1>p4`O'1Qv{ vLP`xODJ#.x#Xt>0w}AnCTObID,*[5   m g  C  I  kh O   s    \ .E 4 K   s b "9 = 2 [ 0DgTEc0,sWM"m9`  h]y&V  !S a Yn  L-T$> =  L  i `   D e  Z ,@ z  R^| @+"  ?`   .q7R/{SB#Om&I!On2 :[+l^ 7A?55+H5_\KJ bk f   h T JJh%u  _ ]n : 7 _g j }   _ `6Z~ j Hh /$+S , Q :   Z   cS d+ ! d ? H G @{f     t N  h [ / 3   [IV1 B .8 u6 x.|]:i  ^ M^  k   &4 9  J   V p/ E 3  >   88n8L=4>XH0Ty+ toz.PoV>ty6Uhl(k)>^Jz|;i:0#P7! L"!Y!!.  |q H !z 90jg_ f     Obb.!mPWa9M>Afz?(]{TM`w+!#`#{"r KdYo 90 j!b"#$$$" lJ$=7 x  z; F 3  S5 { `XG* L  G .0 UD  L @ U 1 "  hc K  . le OBC'8R2N,9   < Y 2c$uVi%~r"7zC( 8  gu  o $  Q b.5l-9 q c M  4 C z  n V . ?m E<CFmf l yXs=nB:dXm Jssq+l O5KD@WbeBfmS})@e~ K]4iYl^JuK[  ~ G ,  ' s # 4 u + c "'ZIq6D:E!<Ng&Ygz1+' 2[<*RLiIDZGCr;z(`%hQkv9m (r, ?b,):*'\c*0d~#3+l=w~4#h>Jj#5S1_q}5-W.MG7CL #? ;C:',C}7/i%-bkZ\{]+a*Ke6H=DyBjvP4N'V]*PC.#_\'!B 12M.cglD@D]ed:+]~ Dlk7A$OL%q~GP ]6TBK\  \<V\4&*k3CCmS%\Oq) }I_;DoMc\kjs?#'M0~<B |  uqUdHjR + jb <(y 4 Tl 3 ^  M !+ 2 s p  \ q X U so:z Y / < t   *d+B;!folP!<RF^$D W/&+ZHbq7L,A=xv U!erQ%m[$v+}p"iox^&/2#jb;QQ$mgmTH1ZH4)"EUg< )|f9w}-Z[ 5lPYh $It s  k  kqm7   J c by 9   k 7  A . - Zy}b > q H 2 / } V, i  u ?I v _K 4 Wa g ! A8f-}8+W?_u7n; xJnkW_z=k4 d+ g (!{&e&~ I:8Yc=f>l* k    h H > bEj~ y  {9p u  [  E+UU\z     .{h3?Xas9 L  ) <U L}4wk- 5 p! y  y s w  pxbg{4 fE5=k d[_'1EJ 6YPs-,v\ /g51e>Tm,H2t'%USb;-I|9+ A< S < < Tnn=w8 8      G 6<.m0/z6X~C"J`Gj4Ea~  , , } 7.V 3 m !T'7 D3   ! $ d #W,"}Ie6[0Q\026#w2M$< ^7:3-G-}pTM~8;{@nc"%'ZAgtl _u3=wS<Py*Cc?bY**%);fzEnjli6M3cd"-u=V"z2)S;WJo5}\ &nW*R'"':7i XkDC&&ybaL_OP%c;P](K^oA:(Rt< 1xVfnFY%Q t+&CH*b OKaL'oN 6rEBn_r}/b}RXba;w-mUc ^nVBn}S0+ pK9Z#Fh'0*:}pwg-$c6|_>Ktt$4K}rs1$1! 4`gI<l@ &=3xm.5GWT1dw9X\[RW8fH+ic9Z2mQR A 2"g*x* x  B {VJ-T " :\+gs \R 2 C js}Z:GK tjb;(l7{R3< 6C vf)P+G[.k65B>t%,.A;4w)KVm,z0!S<vOoouWdMq]EIlZHlUH61Du]sH$Ff3gn^.E[\Q$#<V{ H8)\djS]P_#vU6!9DkK 2Yr}rqm9h1a3X \ a,Jr \DvSosIV+9o9Eu`OQ@F& L0Qi<9tB %4y-h=I]Pu8ydZZ0-17C DDrR:,d w9D";P_6 T?NzVo&01K  -kTa{3,0EU KPQO:5,g  W C y  4   } , r   4 N  @:    5 ~ l ( J G  m       z   eXCE     vw  e   \ |  BC F@ l E  d     QB 01 z 3 2 y } q >  lH *Ox :  N L G Y_ sjNg'Q*c"XlRg+W"Lol_s1;oPjS]^(ZHp9i0Us|X< OoT|Q+nQ1r6ke|qP.S1b%Jsw"QO_ B(49*z1}UuO*ERTfc Z&l>4cj$2-YO4%hu3v #>8K&}WWfBHLEXEmQ z0U# dNwiM,12;QZ e>oV0hT}S+_UzqZL`7v-)vLLFmQ[8ze.#]LS6tLV_/@84}(PU@>NV-*/%lmwV)jhvd%kW/<'_AK"a]2'~m!1a,"y4N&I2,| I[`ggu7r8YR63)S-B_gPs{h\H84Ij$ 1;z$'/:`zE*~Sr  gp@1FU.<+I.wWC gp ca P N jaF+t< ? 9 7 {  ? n #e      E Q fe ? - Ft }  - \z G fV + iN 1o2yWc'%^ y x !:^_N3 iN+v.Q_m&F|V r:se$OP#.myb %FO|cGNu"LX:_o}yTE#y5L\ m F e*;V fI2G4rC ))|,CaUw;z?Zv S6 Ij  ( q %( de m  < o   \ ~ O227!X   W  CE    E  - Ue8w : z P,/;6R|?t)O#xJI5m{$ 0o~n0 4:2 x ' nf|{X+D   Jo )   } @< ( 8"   Z  6w  ( w Y qp   P Z | 3oW3  ` ? vC RMhK j <  r 0 Jsg   @  a }F+RxUfU^p-#saeSD^"ReYU qG?(_:YE{O+h)QT Y{Q,o/p-d%_>#7f@K^0c\x$zuy `q5Boj-vYPFmIKN*+o*8RVxyEZ0b0,y\%mC,} |/$* d2/Azs`6 U{}fv7)e2R"!B{>|!PYP$N=e]x;_TvKlId7s~91ij UqL& :5ug|h86 zk+(4e:1-P9 w: xHw$!r;>y t^19 b:I+aQ#i]C[[933<Bm2q Zk;l8$N C .jy\mv3_W;F sn Z O  >  VZ B = ^! kyc WB P K w $  N >   ? c ^ M M G ; 5 f } nk =i   * ]  <~  An   ~ [2 R   Z EE     z    o z  f i\ Lh34R7. 0*4wxQ_B|zm/^-C#B=<VDW\ 8R-u{!r#B;UrKqg%L;dgVmt"q"PQSp<= bY NV!"\O ccf,+L qXP$zsdz+Zl;5* )[JZ=Jq>STm8nE=kq[  ]"gd_O2OldIf<& JD^ m|kr*OiJ=_%DkX@d!$op4o6!k8{C|)Rc%YNFR3s?GHdTqO7J~*$Y'~R:|XT s<MZT#!am}3"FXT UhqBWWhFBL\lz% X.8sb"JX5 V}aU(~b|@HX6BzR3xs]n{^uI;RMIWeE~@n?\+^_6  kr*TCJz.pUo/]3O4&5 E@EmZ(N]\.b %BZ;Uz3V 8o G[-f+8ghT,nA U rBtFqxcU<3QuHxUC[<8* 4[^0K<~RvX@Q2J2fs5U|E`/f?,r"8ekYaYU w" . K  WOsh \ | or #'1D2hGJ    |!i\    njx` ` q =v ' A3K11[T0D7}y8 K=,v"kGZ=nY )'cWgG7#LIi(YU g]&2RdjNix6!+j%SJl+'!*!<3UNcQ29`H5"zlTxc^@Ur EjQy{'QW?)Q _/[WZ,6+Bu^ 6*{<E,_&cFX|xjKOky}7CuQ!v)YL\30:1&TBo%8&wy "BtCB?Ao.8{s Gfp7-D& VDb/{{];eq Z00+L.8B 4Bu)R$vVy;2 _J@2LP]V}"7W}PSg5z9FBtBqKnh%)P ACnoh*gn91f'->nB; 6b5(h1c_%R9:Oz[C? c!w)gZ'(:UJl|*<;I[^Z{7 2cc/oq90vPP/78=FtNJ|K+4%PJV0dW   ) D   G J g SE  g } lK 9 OT u  C  _ x  l t ' 8 .W v c ( Y` +Re$> .CYV5T* E S a x 3 wq pbp( {  W> x    @ ,   \ C     @f/ G  t   *7Ys q { " 3P Ob{A    f 6   E Y | } n r E  p 5 3 { u  ? B  6 C C = > " + x [  p  N 9 @ c  y t     & c k " G C f J r : + ? 5  y f > j M  h   h  3 o  @ C  Q I v  4  c 5A h   A ' @ iv q&  /  Ay   oA      < T* [ N  i @ ]   bo H - Z   h  a   @ WY?H)9#K#|J /5unTPfGrY&3l 1`MVfeN;\Yz#N Q}c"<`Ue)0+GSyJeAd glRo6N`/* y[Bkeb,GrF.x8|SI, Dq~Ix:l7lo+TuCi1Ns0Yx&yS,[ *q-b66G?6%^Ll-&N k#SD!}(xa<76G E>li|V(`Q'1 4}IQgMb'(2q,cn- I8y4S`Pmi2"eM-|zD2jw~"6P1UY _iJNc1<KEWDG@ 2i<n>},HNB0/Tw#Hg[F(b ,@r'#=b,e.2LKe!_Eb3 Ac T+ Ex.\=hy-\YgaV0B/#A_5fbdM<fO>3\'Ly'?5Cf}\:vOod"}3(OX3sTgiUbA#~t7!gGapOJ+V)NuAU/ L .E>sZX0j+^>;!_k FAxS)T'417~ #{js @'LZ<'GI,H\&^lHN@_DG,$?H,y|Ms(Fndc`^d^D26;d(q42.'XM&OZwXh7On/}\~lC<3<=ayD #9SS2%.GP:{ZwLahUj@}P1%mQ{gniQ_mZZ8(G =Oj0ph1Sy>xy}Fp?~`G P^Mm KJ(l2~C&>z#m1DFH& E8n2H(||NRGwn~>Fy  "z@t]W | C/HOUrA>O ,WTA:?YnAEHHH !5v  f!;@y6Q0Fyo+^-]V^x+Js/o&}AA+X}?p_/?^,s&"|tY?K.{h9k6Q%[k^XTU>7 M]#6 ?>[NVZg&,~uKD+jY`h/]SKYf|Fw 8XFMqEP`mTevz#_'XJPPU)r bpRO?pGN)X&",%B#8Uk`Y}8\Oe(qQ]1+9sO,>*x[M! +@`D_?0`WuPP6l(^Ax<kP[3Hp]*O%s a t$l.jw`5pffemtS]_3GEN?g:i f Qcixi;&Ae/RX--&#y\\@!|&>Mqw< #PM5Et74< NZf\biSh&d_hqTJ zML+CbD!t~/ \T)o zzK.$4F5ETyM#wdE252(C!%s(Y'2mEa4&xp5+4%e2hq'(:2 ^]jkMP##1: Ul>W]Gg9V0ab|l\G5643B&l 'v,  j2@Uh oM g[|v Q3.SS(0tf;2l9U ^i(}e}Q!RxT\8>@?hO>{.;S<{~ Zx~_,XKLoTn>pMg &i) <|t:d9ny1$>-b~}"I\v7u. )`5ck#Lg]& k=d<o<Y 3S~ (JSH?M@}$ YC%"%qE1A^W9%)$/, t7 Hmk>mxn?3AyVn+WYly> ,+ "&Bay}}1ey[Qz:4Sb K-Lr ~\>,6hv;Mk/6P.tskpU5GNF='\X?EWxVH.%UpI.`u{|*o@W}Y!1 Pd3A/?uI YwK=jw!&OKT!O@R?G{f a]2NeP9|%] iMnhrY[bHyLn;";M[w tK ^%T}M^FH1QDt=Qt)hMlb9<w!lk.sn$2Y!! Y,UN\ *^0: 7tP<OS*]v7J*Z0YL8QZk Ya~qgS$N;P_-XE;I {  v G<AO/_SquV g ? \H" xx   6=]MBaUw  RqM+31y RI @ E@c AMUI4bj7'+ B9-y\ {q.6HR/HC2i ~&"j5U3 x^$)_m1{+?1RJFQ~6`iw?:/MDua6hU!UU !Kh) rIgqm/i.D 4$pk@Inv*/J:&ycm`oZQir88p|8E&F:#\%Df)wz[x5J+kkC!Kj7H%_89t'*Hk.C]oE[VfgY+QXl(Y* ^w#\Hc>iJ6LozB7"W|d"^ BD5IjA=(@q]w/]70]PXhA/;j<_/*}$- +'rG;B^%H^,4 JCd&OJx.[Lx|F~R.". C$, 7#l.Rp\kt LgUD[tG[W* b'ryUf?1/!,*IHBlMC%).~@\a `yt9a7hwYq^&DMB&uH]B`t3,x!6V@!yXb8u?DqU=g E^C-O&.HL';9[X =OzW&KIt[s}! 4 Ej4s 54b0vJsFbwTOEQx8^/NO$U. }>s|(tEhZLb&Q7i8` k0Ext OptUj*Z,$`|_ ffFb1m3bku5} #Ld7s 8u x!t[bqwD"xgY{r]4PhD&ZOi;|Qnyum[OS8wLmzw|LV4A9L_UIa13Wb5@hHLddYNj,8ET@xz:3*43PpasDB?s\6I}G`YOE[uO 1OOI@=Dgm"wB$YOv{gTYi}vw5QoY!)\ERXnm y]6^(:- :~_!Db4= n5t+gp^:)zM~Zy+-&Ou/F!"#_DN]lnrlr$,9G=%0TZ+z[Bz6:A& d-)#o` L74 R 4bXc% Mn%9jJ /n3  CLh5{NjL=1+^(,ICOle3p4c#}_tRJvEv%b+}ui6y1^|]n%_}L[qdVi!}  p  3OaN? 4! \d 8 o {  PM O x>|,PT[yu V9 lp(8 6%&CQ(DYdni9 zri /A|Sg0Mu8BsMcTs:>m)I>7~r[B-)6^Hg\;`wMs><Uvkf \r  LIZ-OU  G? 'cK )' o O*q  l    o r   0"o  i l N    .y )    D Z [ E   xe;)Q Wv _ -N : 8 ; 7 KQ =  Q.B2oF,c JAaHiRCk#AgtA_) 2_zg+`jX}ULV6|Zf`^@'/72Z~.DZ/Z^zmX/t'K^  4!4*k:|Jlki[6k n#Q;l=lG:>a.iE~u, !;vY'^)vho}D)DRv5ekY{lr5lpi:m"V;-]R5{Ggj,sl6 E(lN@1SYQ P);:3Rs2-gSQYfKSpo?|#d X$| "@Mru]vg;qStO*Pza2+%$K8{-ns(hfNPb1XG*{x_ai$VoC-Tn>6KW^T`\&B72|sw]EYkjkSw2Qy=+m,9L]B;9rz# Et(0?,5bNQE t"G1kj9HR,Zy-O.VbbJS~9q"lgAw@M+~hSE*Ko(r-J? I7X,M>`S}7m(DLmgZVAQL@'w.;#x%qCd(9]+!QcCdF Qx=$I @\A[y?@i;"H3hl`H)xxdU^F\8v-/t C#YjK/oj;K5LwHchO9.VqJhj%vD~nmW+XKmctA^c3@t(;C^-uI%gruxg =57%aK2q*)`-wey,?$,M:W +(b,$ {>eF51JsYfHC[pQb4~^0;:f0F ,'Nv~uBcjre#~_gw H*wmpG\wPx'[HtE_8m39 5\~nu9| Pc}d~iNgXD3I y/dzkH}/?%4J} ={}Mnj_OOUVtgg&7.6fs5baSH"tRuIIYj(y@\K f 5 -@C@3ac[ %\}O jes QavfIX~X\wv x1[lEc1B+#na ?:qq?PIC_E //#<]eA-{}_qr-Z3nB8|#rFMd |nEb)Y|kj$lOvY;$5OLXfekrHq| %PL?h>@b{;+%#IqzX}5*$hnInL;4&SEweN/l4 KI52*GD!#n }+e39 #P2 90Dx&<5ES'c]CAVjN$_7!ikj CG=Is`K3=mT!jbeU?5D"e =gs6A]  QG![ s-q]$qYqro>z 5!E V<b,;| $SD3pRC Fd, f]wx3 (w`f2poq9}Ag<W $0s!b!Zcx }3?GOxm). Pj:,J[m.jN> [2u&[LMA >dRwf,{g/| h|'hEi>}B=V&^aWo4op1mm a/TVe+Cup`^Vi.$;(&7C>/R 0+]="[xl-><7ckPi|N DC~#j[K13V#JQNkA75L#>yhcO F'L(@@nmiM1Mg+I9 )0(>YTWJ$E7 XQ,v8kF4$/O$ZL L, bN 3bqzyq [${wqnV__TCWiR^'V0Rk0ke9uv{}zydB2ZEEJ TE58e <,`sbM*5X@kjNy(9dRjrutHyheO<'`$e )~G/_])8RBkDo2yv'Yu?@#`MO0lo/D2$=s2NTH+dHvu/*b_#iX:p.y, <|rznijJS":6b Kz0ADhokHm/Gxo1aK3h L;de\t_BziYz6+"! iT)bju>\8|21xGIj^%[gr7q%yvB. eNbv d!8 :!~z7{ u]^6{>TEy<[fP(X-? c X xO< e'eD VW#=u7^q9Ocnp_[wC\@^oOwFA0qo\` V*)O9r t^j E~jd7bsl;c"{wY 5(.JYm8n`2 xkGd4 O=SN(3'P}=mCk'}:{Y8 xj+&l]?l#N*i$a`%S+]#[d5}km$]I`em+FXcP/%]B9bF*" p" O#=]dJ^6'@E.MaO"1M V;p>n#\FyAa7RDbY2OUD~FL -be|viBeB3A-E;PJ'A@:Zf/Q(`J:(c-Lh,,5A97h.fHn?$'30RL;7`IO rA;g&$rxr-uluT3y=JgIi,t9VI^ w ir|c~%|.lo0}@7rd\^#g Q1*FYt{G-;xOrtPL87G^suT[JsiK\cz'/3.m3-l5QZdj7jN BH*>4]/]:'oW-b,Z/`+E 720K6v,nI &B!B[4)^q^+4HGFxc]`fX?'iHvv+LS \wkL@Ad e*\Gn(@9uqU7Y,t8{cc(TZKk[$c_\(`v"`K8@fxN~LzcV]cb?UMn%6xnrs `7ccY?$(Y,}3>K0'"7zT| \ ,(onNSYq#[uU\Y9 F/,]@ mWj y!|z_CL() Jt 6M~T6z@qHzX|QaM:Y%7LN1E0P0SG 2s1NA:$Ej(X1!!1J dUkZ)9t781]U:O!!N 8JDnk98EuVR1/@5k>Widv 8dYED* C7&mX[JnZisFe &K08+jhzJ%31AYptlY7z_wZy%,0$-42iUg"B/T"3 k NM"9:m/~JS6$ $L{" 2.N_J/3ZfbmzlW6 miOGV 8({>s]8AY )-hj0 IUNw<Cw?DF +'I!9v/4L 3XdJ< 8#lOd}u"i-S(02fDPUHv5' j FMC_`>9D] e `J7@e YE 9A]OdO-%I;v~G`:%Um)ijQ(3Wj!T<1V@^S75fmQIM9V(3&@jw!83'&*.KelLt34y(H-8 OOrvyoYN3j$M y+JKX~|u )K_J[Nr;q,k>((hWcTwa/FK{ F-*43 J :=JL1O>m6f $S?#6|N-!#&Fyc#!Isg23wZxrmEGc#a"`.sR8 #d4jo6V8JU2nQ_]A@utzn: 0OWr3n`]D0VtpiDG;)m2,ARc_M)A}l^s [@Z[NAGf\R^v<!\ x\.a ?JW?$6{rIW{fI3z!Tw MO<?lxDh>!iw5HZ"P9~9N&%`3Yp;JIdvY<ff4aim`6%/k~e=j<"%*A p&H] =I&+<:PJ^HP23 rOJ 12Ivb>k7yyslif_jPo+tnbU6GQr*%'i[;TWhW*!Q~mR?Iw/h h );K.z"_ :.adM- @zxX?!dB@U|~s  /s7$w?0!}&0CUyg7plZ.>nCdAX+bngXJMj@+ @!&|jQ&Fv -@kH~sK{4xhC]%p2Z#,% ]N ?&><;6G/.$F|  >y ,%h5+NuUaLlOX?s}tbF! v%4>_s)Juo_3#0$;\}?G78bvmL# *Jr#}1I202Mcx0rwxm~+N5% %5 RIq\nC|^!B/R5bk?kl4t^(Sh5$na}:WMK=ZwUWXWY ia_wJmA+d&!J:4w^>-96sThc1E _EjB'=!u?Z|uI<,>P)i9V0# ot-K5@/4r N5OTGdx>y-Ux-h&(4>`~c?)+yMV76sIjYNdhd9b%O1SLmovN.5c  q^jC;B%Y|8gPd b>6s6Cr_9{(O4\Nh!Jclr[^Qe .*}@B8*z,B^d\E0v +7U\Vg%pzk 5tsn15+8b{R!J~kBvX: bN@Fx_pzsv{|lxCU'#4Kw}dQuM@^19l*Bg=@mnlA#nIR7VsfE(GOOT[]a/+yv\?A0."7Pd|M1~JKChye{C{8o)f UE=@XynBzrfs IRe3~NMlCOT*exv0K<nE.*f*4>5zvq } lko*zHdysdlQBQgZlNQjGMXf &0N@x#\E{|X1Pr$:I=%=bPyN[4 8 CFU;N_:c`R`C^m p|.o^^rclblai^gN`J_NoqVNoo4 (D>VnO'w;6bk25y)GW5o/^7t&9SE {$Q])Ej H EM|QyqK%F$?Xx b  nMCfr&td_a\f^aq"*M4$Xfz!M,0SzoK*$ PCO=5_eFi!HJNAmkP8Kh /0{u){SH)yrU~-v3`Ut b<hN9E15Lg4dTe, |{/PllkSB,tf,6:1R\^X&X7W/gG mxRcYTeya$-|G3t,\XQD/1j)I~S"{>X9:X\D2-Eo`~lbccrh){w=mU}wbD- 2}nvl)/)%i:E]xr]=2>e >E2 f*w*tA CK+{hYn 7'u H`lVm-(I'2%Tuij,WoTLWk]KtIRciT3 /sy\1`sBf)u!)F^tsuuP8 o|)9bVKi3  ; `!=WXmq C/FE?U(1P<+[Ng1EOWKNYq/F - Kh%_qC:Mi9~X6:Tk eV4 '1Ejn(`[CvpX. <{;njWZ}_Yw'-]m"<wbbpjD@4) #Gu` yqm]QOH_asmG6:/0,G+Je|Gf{xdS;5Ij"FfwnL'1kLnD <qb[b{ZJKv5nB 2/q`J_vOg2`oxhsEWQC@W,:")"<_P8xBVi<z:bTsIwQ8-2n>HCRPCd9'v}9V!^XPA///Fd2:*nF7Cc5Q:7Lz|z2% 55*?PQ}qYr*  ;<5+-Ac,` b(@fvu k"^#R>(" 35XIw2n[~<%)H^vswowgify! .+) jZIFGsJ}-z.M>ENY_epzE[qu z}' ):RmM\+<:6?~Sj)_#6N bU2, cdG2<> 'eWdms}{fa7.,^P",R|kw\|7sI,gluAX*_nT5(OxiehhkUjnX@( h@ ?2F\`oo6VX8!36Nd g7_AN;=N5u) f/:|rtsKO8R#c6^1J_Vs.{bTO]\V.\ i!Qoqy`6aeqd$y@x\K?)#:IOWWM.~v_F"{;&;Jctd3}p|(To_%h8gI#m5bD05##  FYik^E)9x+nT|ipfX]SNLF 4;]mt\<= @RaQyO=Pqy_*jc.g~n=(Tvq?"H+ 2f804!*<ge <#7J!pbA=?8!DM3jTQmbHZ @T\hu$W[=^Wk.MD4GIk ~m0iDo\nY]]<Vboqosh<>yAP7Pf)$)4VPkE_0Csa?*ZuS' rtW[xk6}i}twY|Peo"Z[M? y_EYakuwtn]t=~"*|;k9O(LGZ[\zPH97=>GMkwxXl>WOKm=45&OPkY:"S-3=''5'ML\~XY`q7N^G:C-mep&VG=\|v>x W<)0Q !C]Zb{WvQOesE#'H+JA,Xels[G?AxOb[TpYz]q|wnY~IZ|tI!#; OUJAq9 =8$  lJ>76- 5be9!6swa^%v4k-SMS`Ay=sNul;dYoX}O(+? _;vpqVg1< >KcVB%`39w.5.-U}*f^yS(+\ 1/% qt'MGoJv/p YG8<WMkdOa{|H dF7H7X~ 1QT+a$p5kPkbkuvaUAD[~|wz|po{ }j}7*`7}TJ_C];[RcXkYk9h)c`]&a*k5~535c{N" ;];x+Lgtw73!3\>kufOIe7Kc+p-H;Wv||?R'B:xz9OD$8\l!gH_zKOWrsr[B'(?4dBQ_mbpJd2a0F2a,(@j|C_yyn\m\GV:>'GcjY'  [,se%6<:4'e =2Uyn[PeyiXqv\QRzQLI7#"<X]uvzY1hC&'6JkZ)%(4=?6([?",81T8x<%i[LF8!k^d !k*`*sj\OIFKDt/A5Z|rJ h[Xdgk=`0C.h 6Y@QjhP, -:Pg{s\Bd1vx M%P >?i`Wj;k,S 1,BWtaTdMez$dq}TRG6**1wNylijXPFWu3Vd\5H'5EGHITewMxxcP0 "Q713f<.'q= >jdK66f//.1U&#)IlnS8/ &;OTR 4!2F>-+YbGGoPFwlf_`oiO|daETMM\PbcZ4=}m_]kj`:yy}n)O!37V{!%6>"P`u'5?99E]u@}XP;&D3@RSVXO_djjmt}{~ | 5K\TA 'rM  *<[{uy:CjA39/o>FKNO~i9 #8|@y5!=P_Zab>a^ yz &-!O 7p`TIS3[o\= 5kS `A3)1?jRjR:t{sD ./NXw*iK1/XkihcQe?#~ u }*_7572=FL0c6xv5p]DBCtVxzstydbs2hjPAAEelz|+o-g>aHcTictiore{T8 7`eJd|bik:\3'Dj|_cKU7hN]|if_o~4Rj~m]Z[[La??2&6K,mS<yR?NNG@?9@^z)+-08QbpxzxS:r7_HJ[<v<{LcuBq UR/Z8|JTZN{G`A\R`ulxwmYFJ=+@.O>dQhKQ(* 7fq\$$1,ZNY}qH ')j6!9R\R :!w+X728H]LNQO?U)u cD-b0BF.a| {rX&MEK\P]XIb'ZC!l(\@7Km|D16#X4H G//oV++k(d"Ze f q!h>fhYxOwAW'1 *^7KE2 :kFYLq. 2BLOaeRXf\1n~dMFGNMOEA>zNTk>&$+)8/L U`jxj]D7-2? cwdL{Br>iHkPjJ8pw%n6G=_ibnbQ6c ko}>fT/\GX?7@;N]a|sT9/0;C>3*TqGg{r^aDH7*;C(QGOz9' ,BQ[gilm}$c:?7""[ -fXWl 8<<2y$5 8[iq,B^UK!kcquivx _BGS4R/I1?/:>;LTaV!H2)Jatzk/RJ)`y !El"/6.$xk| ,,q f t u&}:{]of`dKF0! P'{Adno]UhGe<b3s.!lWKLa|2F\~jvx~ntpNZ#@+"+9>5  )1IMMA&   8*A"=109E! B\ry nN=(0U)y0987y-^H2% #>>4AsFu~lR/  1AHcUSJ:1%l%Y1IAEWIjRkbph^hj\mRHHP_wsU-)81>xSiZ|ZbHJ9J&c,@n(5&j3&:N c5tf|a?*!. 9 HP59y4JKiF$A?D<8#*a/0FIP}ZjUWW;L'C2*,%UzqdZMKM"N$[h{dUWl i: %"BF , *@;)i\Y_nunO#~kjqrcxey_[]3I5!.?PT>2 `9jK&2B'g+'7>7~"[H4{@t?k?Y:h1n,#46D?1  ^U\x"Y2-7H Nb3jMvowvfPxAk:V:K<>5;53*'J!Hc~kHN&:-7!C7jAA/" &Np|c(6. 6;>DD Va(S`Y6$-&$hk!h"u w_L50*/4ERarte}S5,'.86 e kUT[klbEw n/sBqMd6T@-5@IUM:dc|azkhP* u@@RI* 7?=% |"xtdK=/;Nl}mZB+y[ LIRq~y_oOhIeTmWphuu|}wnXsKuHsXujqgfZbfb?n+}->^m}z{mvpc,-d`Q:; 6 FFT`p !6;876C\} ;p(/uCKJBR8XMf\}k}  %7ENYxcsz_E=E2b-y3 :<91 7nT6eV!iH=8Kd>]mji^d``P=*|_+fGbx]Y<B7 Ir yYvP@<>ROw`~oduNv3{/2OkzV3wVB=T0;6&]amsL5s;hQlt|wYVWuzvdYOQ`uubRG9, | $.97}8^53)/% :N`d_J6%.<A6' l:Rh9x&{]$^1L3P6H6?.3 ?ryxW4$)Ikwffahswx}jiViDLBj3/$-7;}2t''7Vgy~n_Q,H=BOIW[U{ZOOPUWVZYjs0@VVWUPaq /Pt2C\g|} %%)  #;FULTKQUV]_s%M]~ia`GT'@)*9Sh{tjZ)c>&}|-yA[]`D{'pX9fM=<H^sf7cAq<kG. vdSH=(mC8(%D/P#F')" !"#%49GB|;weipy}qbI,xpa>$ rZN?68BHvQUbFm=CQk~}\2saKMP`^b]v[nTebkbry~{nO7teV QU$`B}_s}gO$sD + ;bEkcTS`vGZaH#9NVZVXi y&?a{M#.W~}~  ,2G\kuzkNou#Je|1/GGMZGq9t,s fR@@<A=2 9Py,CIRMT^_-tzU:.82MHmBsHh(? nloxz~yrqy j1/9 60 3Xo~syojljoj_QA.! #16?8,~wUD9=;93(#().3%srhrlgQn8ZOP\m  lI1 `P9=>EKSF8#~!""{tilm$($ &*# 3b )@W^,^UNkIwFeNP] m;o}hVTm+Lhg]>6,;CYi{}|hS?DHmv~ ]; # %79IIEe'$** B`oralRRCC:+C(Ts%.Ehk`ht $7R[YF5",A[/dNvpBmxU7#4Tnwsx 3Tq|mW%H4/&/;#X(k+x+r=gUfihm^P* 0MdoncS)?C$TA%}joHm.f d$]=XXUn^hk`y;"ukt !/?:5&!%=Qk t"o*c4\1V'UOID>FIJ3E<7D-H)F2>F@KFDS.a hf\J:$9;?SD_UkS_TLP/\*l8Y|_q@l p{8Qwp]`\hsz~j;xxnv$Kx xR+6X{N,S-$ Dk/6?CENL^^v`7N7<MO9  {e?z ~ 'QyRE:A>pAd:R)8&  3@OF[Hh.ba^ZP:&$"L -B{JME#@!00!N qqhgv |  (Pvfgh^\TFZ-[gp"3>U`lipjXc6fl{uhkxsp{e`aCQ3>1*5BEIA2. '8AX[Z@,vz| +#'jP/#5LempcWT KI[eu}vdQ90.?Ggnrcbds}0Hap{w}osgicK]jx~kQm?W48)+$)#0*:0H8BCFPI_TdXiSg:fYPE3 3a\DzZ:/1Dsb^{lnwtS:0NVcQ}@r  +;?7))jJd_Zy[vZldPh1u~&zNfrG)  -H_bfhp 5@D;.#<p ~w%!+1,515= W8h>{; ~omsI{lpR+&Juunt $:@?<57B\rsgjtvh&b.i3k0o(j1g;hRZhP5('(:FRqXhRjLLQ_g#e0T6H092A5M=kFIHC:-'      ";Lfl,ybogR6$)99! e3 4=<6&- 0 82#7026:'# wZ[u !{:wVgmj]rRTF=G8OOZmefU@!j^ WQ7aVgf{i}P|$h_U^$MdJQen VA8E]lun_<! ze]Yabb]NF@@;_9WNRNYTa7nkYUSUaesioeja|a[ahsnq]qKn,m{(- %7FE4$+ 3\c&Y*S?\Cl[`zrWIC>CD~NWwWtXdQUXQSQ^_]u\OD559JWU[LHIXp}s[JFH`}oR;//6Ibs{G+(Jt $(-4)S` f^]OG@5- 0Ok| ~" zhm,666-~tlUI 4-*)6BOhsxliXQII KS)^7gKlWu_r^}Z|\bmvqcfkxztdYR`r'01"} qto-v>lIk\bdVnBk.i!a[!P7VOWdQoNq?d,ZGB9 E8LT_s``OJy8g9S4CE3DRNVU Z'h//%zqv v_e _o +6j3V.H(Q%L0XAI]Eo2%rfngts { ~eTRPXZgjmyuwosfd~WqKd;j-v.7F[hvtsgPQH`oxkhqglkmf_WU\cr~gJ!2Yuyn[D&)8Ol_]{WZen|vfe.ZJKM a*xBQVag{mY}@f=L6/:DV_%w&+$";NkmaE )$,Ecuwtnroz r saZD802>O`Z_H<-&'"*;::8<<HRVR]Vbf:w#.7LON3  21+ vq)h,t/+!|_<(@JH 3" l}wcdmmbZb\VA#&Jex~u\QJ~V`z8 *&?3=;1<GMi~jfgy BRaYP:94?KQPOB:-$!"&(  %+.C4`+t#rl W@$$&4DbvqK)(]|p}.wBIwLo@f*UGB":B6e;=HNJE;6;V4j<|Y[v$=Pgzs^WWesxpU<& w r)WKM|90:ESvi`kDx;h2^1Y7W7p6}7;BKW`defge _\NB7.(#+>B@]RfUf`Nn;mqs|=c~'3BMPSYZ|_u]g]mXu^av)*0*%# '() 2/1H2c1w8CTl~{]I78Bawznp}~zpa^|bo{psnupjh^a_Zgh}"(*xo_V9LgTygyk_WNJLKYMG .!|5nG|KC/ }jPB13&,yjc _^fnv{ ~vljadjq{zyq|~wna^~Ws\`c\eNcRSL?R%TWV^TX.[>NMAG#F=9652" #695)|zmaRL31 wk(j,j.m4y0x.z/y2y9}@DB9x*p]ZBG:45<3A5QARFd[Xfc}\eezlqx}"BWX]STMF8)!".C^ },8GRNXawnvte*_9ODXTci}p]BLt[nnlqs~ 6FH6(w">Uhmj`MHAHSRP8%z(x=Y[]? j_kybOK%87:><:-  n-[B6FF, " 2&>'R)\+Y O<+ & '5J QTC) zoe`aXSLA/'ybUOR^Z\tLfG^=XoMybm~~ufaX Zc m {~)CUhsibIBCTes{ ,cyvqi|zhv\T[n)@GxAo5j"qs phOH+0:7C;MJP[Zefe{aPJEM\mxiQE<*%DWz|lP:!'.ByQhNiMn>2(!$.{DsRsVqYsJsBs7g9];OGNGSCb7p%~yj ]2UKGLBP0V'T`knuj-XCGV-e#ij c*f6hMmU}eqovzti\K;/$& *47-("%#rW??:?>:4(//*;*,3": IB9 xpjrqzx~tpYH*uiSQqAi:h1n$jxvtyx |u+q1k1_/P&H%<.#  .,)seghz=LemmfaXYXYaSO?u3e2`5cIubuwp[WTQ\bkz6Olvzxuuwx| rO(&,:)E'B6& xnxzm|snkkohnlsq}sqwyqhTM=BEJRNRKD74"$#, <=2 %$+#/5IP\SM>1))5>RZnt}{ukmnr/|9~8/}.2D>71/"+#++t:}<.(w=[L@s$  -AnNhhqo}pjaXKA5/)*3;CLX\edmhmYK@6<8700*-.230**#$&3ALNPHC;3/(+516(?#& $.0'%+& .0*# %/3;2.,)06HWzeoumoj\R?2 yd^U^frwjTI=FL Z6gCvOxT|PyEv2n"_[C7 %$!*.,22 <!:4*)|tghcjgo`xVG=;DObWX@/ /FVgdfTG?@GS\\[NH8;B[hxtfc\_XY`n'z3m2_6O"J$IN+Y=hF}bi{ueVR`q|yfYFA<L^r|unYU>PS`ltprmq~ {~|~v'z3vBeARE73"/ $ !+,2'%)'4~=vX}e}xZ}M{6},+%2q1[;C1+= /-@44WBdIxTvVrMgER2NKZedg^XVO[[eow z~zy| }ztnty {ufcTaZfknrog`]ZXVL>5/./214321'+%'%*5BM^eigca_gittx|!=IUTH6- &7F_aeTK?EGVSK8 ~nYSPRXVYNMECCEE=0! "" |la]OJ5#   g^NPYhx }vv t!2;HIKC=5-/21/! 24 =66-, 3;LRakqkn^cal|uy{qjbacagm#q#ja\MG@FO]m} xsd-bG]V\cY`^T^Ib7g2g/h8i5)%#:JW]_a][YSRIA<65/..+5@Kgso[Udvmqv z}x v}$7CJKMJV]dkmjZI9///:;KQ_fy{nhmym%\&A(7"-">!T/t<OY~^a_HR(K'A%8>3=!@" ",,*79&  Db|kRD0/)*0/59NdvwcWYVuwpgguv#%*27?r?gC`>m=;:;EHSXhr30." &-,)  -FaxvgPB>AFNKOXX_fouzuxjs^da`ePmPuKuHtLg=]>R.E5A9-A0F&]#eecP@(  #!  !07GPxTHV9W.X;TTQhOJPUuf`lNxE|>wCnCeG^BaB\9eAeFlQe[df\mUuGfE]:D?3I)P0X>RL\`JlRr?n@]7\;]:h7y-   {zz~{wwtx{xj^XccqrwxstufqYs_tZ|ex\o`[TA_;c+q(|"+*,,u%g`QH<4#,3GZt{}rgXUUWv]fOP;MIT`ecTI%4( $  yaSTWht{reVF>'"!"!*.2'0(- &'4EYcv|wmXC,!  *54.)/8@tAyKpOyLt\dy~tkPNAGQ_qtkj   u[VJ%E.P;\;s6&   28>7/ !+:FR ^X [V$\i%}'%}pbc*i>sMhvz rib[[T`iu '(.265?>JCMHKLDIDGF GB*5512/8:08+F+E!F*?70H!Y` moy.58. z^XSduiXKGIA@+!    !%5CNLME;*'0CLbfqld\PH<872/%!/1?&:,65%86CKT[ef i$g/d?kGsOKJ@EFQYdliid[XO]}anlo~m|tgXUJIGF896=CYhnsgV;  %+)$%( 16880   }kdlo'**/8DNTI}Fy,u%mgVO-DCIUUhetwx~~xxuqt\tKtECHLHB:1+/.?IfjvcR;*!%(6>HK =; -1DYs}xqR='%&<FSX_USJB=975/ !## viUC0'"")/,$wok~ko^^`QQNQHONRLXVP[RgOpPxF|;{/sdS = '  & .AJT\Y!^!T(X#PVMMA3 (2,4#&*!<Rd{%/7L\blm]^Z=9/&wnnsjP*  wwv{}t~{leaY`fqp`I/)''64;D<\@qCV_}thSIEH@E4 0" -&-(,?.I5cAgGoVjZkWlVmUt^tcziyoq~xo&142-'! -#D.[*j9wGVx\XvWG|@2.&%)) .3AGPDNCG<ELN\bbf_b]X^Z[]dks|~xlVLvGkBjKmJsQuP{RsVyVj_kcdsmgojkd_UH;{745;DP]bijuv~v{ptccVPOIOF-B77H*T*Z#g(c)e.e<g3k6j*_&`X`\g m,l3q:u?|9?;9/3-2/;BJLLXV[YYVRNIKRWX\_go{i`abpnx~ui^Y`]mty|unaUVWkq{iv\rJjQeNdcejZz`|d{holeuZwVNID90"68<//% $'(#!%(,( %BOQOECCGQ[c]TJ:2/"60=1E9O<QEVMRVSiL|A5 $7>A83##"$!#:.P8eHeKcMNN?D8B20:/E0P,W5Q4GB;M9_7jBuM~TUFA6y25|COd|ossksVnSwKyWWm{ryw{vsoer[^KGF:?.<7>>8^>h:w2v/w(p)m+i&j(f bYI=.($#'$2.*=6L*V'Z#YPL=3'$ vkxazYsU_]c_duVZWIS4O+J)PIC. % 54 -$ {{ilbkgo``I@,'%%%/7FKQPQI?60*'0)-33>w9n9]3W$ROPOZ$c+f=dA_N]H[DY7[3Z+S(T"Y![&W"T"JL?;:; 92975D-P-\&g'f*f1[0T*U J<1$&&5:#D"C$PZjtoZNJ E"I-R)Z)fnvz"/78:30&r0k7`DVQXhix}vtr'*.7>ELZhoupfbURWR^at %z | #*8CR]xfocp_pTqGr:a5]1K.O/A2F787=8/:)EKZ ^\I@*($"' "|t&rkld\UOMQSRKH>@:742+#wm`_f!n4o@lMWZL\2^*WT"PP#Q$VZZXVQQMRQXZ]icdYQJD@?><=??FCA6/# !(-'#  ",'%yti[RFILYeejmcb TNJBBB8A0=>HU`cgVC,#/21,|%} {'z({:CPOL<6(%$1BNafl|hgkn|}  )2@D(Q)U,o%t! }| y(4DU[b`cdhv )2:36-*/2>@RWfhpmwqzzyzry   #/z1v5v)j+l.g7b<bJ`Oc\g^adZeQZAX4O0T/X,T/U*U0Y4n9v:31! vqdh%e*c/m5o89470,$*-4z8v8t6q4l0r9t?MOQQ~MmEUMMM;R9T0[4^6j:n>tGvLxZr`zgqgqdh^`_[QIPFJ@J?L;N8R;Z6X/`(b,g%h-k/k<`GiV\XdQ[<U6X$TNQ MMA<!?,:7H5G6\/b+f"l]aT!Q"L#KII DCH?; - %,.162 ,$%)(    -=I@>+$&/<>BHIPTQRTWSUV[bgrru}|}umhlsvwuok^b\^b`b f`\ \QNOLNV$U/[-V2W(T%QIFDE"J/R3Q9Q6O6J-F0@#8)5,'  %#*"7),",%$ "&54<=BD@MA D3:/3/:6>7508898 43- &&&-15$27/7,B,7&5-/!!$   &1EMSJ ;*$  +J*a.m4u0e/`-B.4-+/(*.#4(F"E.N,P6N>LHMRJYKTPPQBS@^@]?]=a>YDXFTSUQN[LXFYK^E^DkCsC<8.%rrcfY^!cq"v+&& "       !(%  /E\bZ~Q@3&!"$()(|'z#r%q+l1m@gLha_lV|J~K}IsNhPV[H`=`&c#]XSLC-=D5b+u% q^ G; ,.'0/040>:U^jjeS<*   zvkqholdgejpx{e\MGD::7978@82-%(%"+nZJA<43#& |xvzvtnpzx~~ ,9BFOMZ[mu{z}r|x|zxttojpnpsrtpsvy &6yBqDoXwP~aU`|fxghuWUQYchig]\Z^l}zs rjkb!c!e"ejs} "# !#&)0,6-B-Q%T_^k`n#_(X9I;INGIPU\Xsccc[YPINNYgw}xrcWTNVPPMMRTURKUK NMVba i S P696HJVSV NIE"D&P+_)s#s$qh^S X Ymvi[POW[fllnkmlks~}wx|y~ywz{wlhbgdc^XPPEONSWZsXnW`NaGYCZ@XH`J_S]SWZK\@^8`=eEdHgGh:l4mhc_S]X]_`chqqvkreeYULHIN QQ UVYY^[]\ VPA 1       ').*-&#! $&!" !(#      #' 85@;=EAMEMGNELEK NQW[falnqcZJF;4-/8 8EG'R+W+Z"^c\aS [O#V,L'U!W]^c#a+\4R6H4C/@(AO[ghjm(g(g!`%` ^%ZU#O I"H M Nbjt {"!}z{qdOGC BO Ucfkac \+b)b,f)b#f[I@ *)(+5:@@<696-*$$*=@?:" %-03+.,%,1%&!5 7>9;-% #&.)*#" !  xyrsfcXcaqz}oe\TSOPKB71.0>Lcm~uq[G4$%%.07=BJUar}ogb[]`hp{|yqc^[^fg}nnfg]ZSYOYL^PdNtPUO=7$"&+5=|?kB^I[ATGX=[AbE^H[LRFEBD=97=/>3D/F7C276$2,%$+98>:<2&"*#%wsx~$++-) xtg^XTQRPXVZcfmrzuolifeiqv~|ztqzttykyk}ed[[lVh]OaHl=w:{;A>LQMPDE7}=u>rAe@lCiCnBv?z>34//024:CDG><22-0#3&+205269=<95587849DP#O)X3W0].a+b)s u$(-6425*5;;D@MOSGF<>DKM[bsy{zyt !)03/,  )*69@8B>A<$C E(W,])l9v4|B<AI}FQQ^_inr|{     yun`lhojpr{{z}w}zzvlhea_[T]`bblmtroe\IEDGHGGQ\cqz}{}zuyw{zvqea\]jrrfP LBCMVf%g-p8m2s,g(k$Y ZS!R%J,J:K=FEMBHDL>L>T<UF_CXPbL^UdIjPlMoNqYwXt^|am\vYpZ|SQF97& $! wslpliYWDA17448,+   |{y{rkab \[SVU SG<(   %),)"&%" )'( {xzood_c`h`h]dZ\X\TTOJqEt@i=sA>@HF{OpV\\Q[AY7O6I47B46*@(66)$1+,/11;:?>867-/#"+346::<8?=?:8++ % %+02z-}%zx      #*1 8>MR_*g8t>KM]eehc`WVNTThp|#/**%  '+1/&$ !(/8<>6(($'44DCJHRTV^NJ63'  -+3)-$!      '/%.03;@CC@8764:7>??<:5:={B~KyKUSOA3$"%$')+},z)m&]PJJOP RUWPNHINPa^ndg\UHDFHIFC:2+$+*s4n5_o9o>u3{:s8}EBVWheg_yasbkjdndsaocplanYtJwGyEUV__d]]WTUO]Zmdndhbbgfgmc`WXUUTX]e]c\ZVSZ[Y^TRINDNM UY[([0T7L4H5@$B>> HEMI*O-I.R2N0T8T6S>T9N7M9J8I;K<MDMFKVLZDe:d5i.`$^!_U#]"V#b dc ` VTOP[][bc]W USU&W#^$]#^_ejpnqv y wrjc`[YVRRLKINO^[b[]VWK@=86*& #+11;7EFEE86.'+$"($4-3*-)()$*&%)/27?BEGJFIIPSYWXRSPSQRPROPLOJOD@BALOWaejhf_`RRJEH":#=-4,:+5%;?@B>@B;%E'K3M1K9HECH=M.T6S,\9[@ZNQNPRFRGLFNKQMVNSSQSDV8R/V!Y[i i(x4x8}KuFxPqRjTcEgH`6h4`$qnrnno r oomkmo rqqgcVYQPVTTRSKLAA<1/.&" ~|{z}|z~vz|zxphff`bb__b^dZ`\b^^_b`cbdaZZZ]eivpsfeaZf[gist{xxxrsqxyuxtu{~||rqZb\Y[S[TVWY[\Z[UNLxEr@t9tCvAwDvKN}R[UYP\Yy`n`jdZd^[U\`ZVdRdIdAY@S7E6A6AB+:,?0C-H/G1B6F=DCHLQYZY_\iZgRhVcW[WQbGdCk?u?;1:08448082( tle`aZ\YONHJEIJMIH=7%" !"      ! )$(& &#&  * ,; 7;9<8;;:3 1 / 2( - (24300,,)// //(%   #)10'%#250<:?;<?@=95*!'*,,&! }wz}  '$.2.2.(# #,07:>>61"  #.102.- + *#  !&)&)1,*,..()$-&')*-4 4CEHKMU[[b\TJA9*/0.=;'?&-)+.& )$,)'('"%#(%!('# %)!+#1..$)99H&C'H)I%GC@9 ;5 93 10* * 0 / ; FNV!UYWZU] ` ]_b^ WPED> ? D J O \Z^a^\W PKLLGKNOQ%U)]5\9d?b6Z5Y,O2N4JHFTH_@eEY>XFKFGJ?K;J>KM@X<a6g-k'v!u ")33;65-*-*675+)}w |wrje YZ]a ou }w~lkOPA*N-D5K0A6E+F(B&I$G!J&H)I,@)6+0,"'(%$$ ((!!"""#(* /&#            }~   $#().,1,.0.4.,438,B1L1V1[@`D[T^XMfUpRyU\gls{}~~zujf_\[_h|mvnyu{wokfd_bZPF3(  *)*$#   w q q gkodcUP$P+P0M1E<></E*?;; ADJK SZ\Y\[^ d hrts i^PPI JH@A:=2>> J)P6S5V6M.K+>)4+.+#2/0 /('$ "&299=;>;566+/& } }{~sjkhjoq~~~}~~~{yuuyy{wrnkegfihjmliiplprw|}zpopvzx|xzwzyzxqtz|x|rpkpx  !%*&+)$  '/78?8 : 862.-("'##'! % % $-0 0/3/*)+, +,$.&.$2!8DB KMSUWV[Va[`^Z][]a_hmsy|tjbZ\\\gbnknlkhe^SJH<<;;@=C:<?BL@H67"!#'8;D>J?E@;825&&$&)+1162<38443/,)$,*2/2.)!     !&)(("' % - --,,21 5 >A N OWXXUUUPLAQP Y _j jsutvlnhiichcknriikrsxuyy~}zyx|}zzrytzvxv|t|leqivjvsvyrlqrv o pjon imm_aWPD:7<?EP&S)Y%TOI G>>7 >970-&&%& + /'7#<&56./ *)(*,4 4)#,#%%.$,/12;;7>@@:G6J5L0M-H-J.@6B3;4>.=1G0E3I%C%T,M"TXY]\Z[W\"U!Z Z_^TVSQTIMJH?? 9 4 474//($        " & #&$+(+.+)2%2%@"F%Z!h"n$z"t%n(i*d3b)]3a4f4o7n9s>zAyC><9/(#""}sqt#.262,$ {&"}+-}/y,t*m%l"m!qs{|~!w"t)u:w<xNM~TWyVuYjOeXaQ\QaZ_Zehcg`n\rPxPvG}H}CDBGIEKE|HCMHNFOKONPWQYOQA=3519>KOOVRSP\Yxfl\fb`b^dfffefgeeejdrWwSG{I|CyIzKxLxJn=n?t-w%vvwx|~qoheW\]gah^]RTMH>=5:52*&zujjedc][XY\\dhdmec[XVSRTRX[fnqwxwsnhe^glv{z  !&+1507./'--/,355<< 7B<AABC@@=!>/779C.Q,X*a+],b.a2c2c:cCgAhDpFoIuGwK~@C7;594828<9>>CGID==;=>AGPLUPNL<B;>B@BJHSKQTP_UZPLNHNKMU[][[\_aeglhkopkqt|zyurpkoptx{y}}|vvuuvwy~}wyuzz|rmonrrsmpgbcXUMFFAz:p7j5\-X+R&W$W)]&^!a`]VQ GG?=7.-)&"#((-('&       }}z}~zsvlrqxs}|}}vtsqtuz~{|~}usiheaaempurtsxy~   $,./0@@KORSNMGFEH H H CIJYYfesvzwt ppp"r%q%p'q!i"ndd_mo#}.2x8v6t?j;tCr6u7u.v/m)j)`![#^$b*j-q7y5yA;EFC95<5;00*-33=EGXXUQID>:6632041,44A@A=<880~1/43@8C5577A<Ex<~D}<832|-82{;2z30}43u.u3o.l:m9d3q.e"ss x{vur n!l!h#i$k"f"g"m'f%s&grjkca^``aede]_T R"P+P*U/W6`7X7W3R6N;GDGIEJBJCQ<W:T:U-S4X,^@h5f7i/g0d0i0n2t+}2z!|x|}}xzenac`YZ_^eba[ \ VVV UU NJD >483$7389867"5 5!5.-%()-(,(&&$&&+"*$3-1-0,*', !#%##         $#     !#"'$!+&0,')$%%)178>951(%"!',-1221.-03/1/+)%!               " ,(' " %0)1 ,/1-538=: =: < :3 =:E AI KQSTXNNNOPJOD?40'$ $! &% ' * (.-.')%(##"&&'"0/!11,'(# /#5$9":&>!C FEIIJQMOLPKO!O"X-[5e5j<r3x4z2~,2&})&~''z!~}w | }%~u)|'w)*,~.}5u3p5d3Z+T(M"N$KE!HE> @'7)=35673*;.1%:'44"32320)*".$'!-$#&& $ ' !',)0'"   "& +'!'",-%3"<.G.H5J0P6F+A/;'8+;*7*@4H8L@V>UB[?]@cJeHfGhLjJpKlMpJkOoUu[t[~h~frnupqinfdeedcaalsz~|zx|x~yvxqunsmvv|{xond__]}]Y}ay^~e{b{jwhqrrrlxqsnrpmkkoofehbc\aW_R^QfIiGmJnElLlKfPkOhOdMeDe@f<k5k-i*n'c#h(g'p(|+'-&&% !w|}} { xuruknmhieeokmj^[RSIH @C C=42 %!(&$ y}w|lnbjhgmedZcb_^[WWW^Yicnkpgrpqrrvortrxuy        )%+&-/+(+'*-8<=@GM UU `]ef&hf)`"]']-_*W,]2^/]8c2b;l5i:l;qEmJoTpTr]jTn\pJlTgQcY^]_k]o^u^vc~cxdxjxozommkos|zz~uj~p~lwqxtw|u{{~}~}vzosproqppprotlrlwqpljoklinlnjkklhf_a`fiomwtyvwtwr{r{~|qihgnius}z~vwpqiljiihn_i]hW`L]HL;G7@0>1A,C0H5F.J1D,C,C*A&H&F"JKE!I!>?88>8D>D AC>:9<7911/))$2+0,).!(           !            %%+%&(&"! $'( 1--%)&#   !  #!   }|~{z~   & )158? 9 :8 8:9=B E MG LCLJNEIKVT[Wb` l jror nkn j ndnemllkkhkloqvqwoslmlbd\\Y[`cfgjfe_\Z_ZZS UTME=< ;:@AJBE = 89 6<8A7:7 0 4 - 85 <=<:?53/218::<;:87598=8:7448 6;<BIGFFDKHJMS J$K+I4B.F0<*A';!>';#:(4%4'/+1*.+2)'.,1#46#97!4;#8$:4:C?EGJHDG"G%IIEIKKKH F@AB@?:;<F @IJMYN%X%P$V%R$WKOILQPH!L I"F$MIPMSTRRNKKJNQOWR[_^_dbb d b b __ Y _ Z [ ^^d c j d b ] ] Y[XX[]_^Z][]dbd\_VTP PP [^a^a\_ ^ ^ ^ c g f a a ^ Z]_ccf]h`dfcf e cg b af gghc k b b ^YXRR^Y]_`bc_ aX^[]a[e["a\%W#[ S$Y__^b[a!_]\VONGH!C F(C'G2G*N+I(N%J)U$V#S'T#N+J'<.>+4454.737080947/73;*7/?-A)?(>6#@9;<A>><E8?1 < 3 7/6 22 6:6:9 822,,")      !     &%" " # $                                             "  ! %#0(+%!' &$$ &%-*!(%&#$"&#*(..-0.2)-02),)+%.*&).)*-2)5,7!5):8!=>$B!AG!HPMOJRLKHLKT VY \d b mci ngpmqkmfkmkiibnmmmllqvtqhjaaWUKMWPT VX] `d_`VUZXW PTSSKK@?&A ?,C,=-<'9%7$9&9#4&0)-,'/,6.2+;,9%=&J/J(U,['Z*[)X)S(U&T,S.]2\1\)[%]U%V"Q[Z[]W]U [V X]Z`_\cX_[[a T\NSOQOPY \%_(\/Y-a/\%a&`$[)_(U&T"HD;F$>$J'K,Q&R/X+V0Z(U,\)Z0X0Z2V4Z3Q7Q9I8H3C/D.G1O4K0S.L0Q(Q-N%O&J#M)L-H/D-<0;*4-7#;,;(A0B/E5H1D2I4F-F1G&E0A.D*>,C)A!I#LLNPPPRNLIHJGJJMFHEB C GFMJKLCH@ AAADHNHD?C?=<9530 23 /-+0//418 +. !( $!"((#&!$ $&+-0 ,/'/++06>>;><;=9B>HBJELFHDBEHDIPKNLLJHIGA<76;@>9877>;7?47020-*/)-/)0-7(3&1-+(' %$"!'""$!%"&+2/1/')($'"&''"&$!)!        %#'#' "!%''$,+406CAMLPRUTSQRTOPPUWVXVVNRNQOURVWRU U V V XZ\ZZW]W^^^b^`^^^_]ZPQE NFB @ CEGJKTISFMHDEAA>@9;27/-1/-)'+*-&%""                 }y}~z{|z}~~{}w|s{yzuqqontrs}u~|~~{|uvsu{~~||           ! # ! $!# *&#$%"'             $'-+***+&'-),+(/,1; 7 D <I IH@IAEFG#BD> >!>&D%?'C*A&A1D3F5F=L7GEKDGLGJGOGO=WFWD[EaJ`AbJdJiIcKgKaMmLiMvQwSTzSyK|NxKzLsGtFtM|SN~UPYUZZ[X]]`edaZ_```[WZTYY\Y`b^XURTSNOMNLMMLJMNK{RL|OINE~Dz>z<u<u:p;r>n=s;q?w=pByDmHvFkKmFcH`D`BVAXBQGU>Q;T7W>U@WASCXLS@VIUIVMRLYJQCPKKBIIHGHFAJCI;N=L;O?J@PITLOPQNKSMLNFJEK;LCI8I8D6K:FAP>RDWC\GdCdIi=bHi;gGp:cHh8fAe=k@eCd>_BY=XKZFWP_FWL]A`IiDfAf@c@b@dDfGhG`RkUfZk]b^d`Z`[iT`]dS[[]XWYVYTXT_VY^\[QfUeQgS_HbE\@Z<[AWA`HXH^KVO^O]L[FZGZC^E\D^B`C^@_?_>X>W8R6P:H8F:C7B:D5D-C)@,C$=09(500(4.+,%+.')-+.,($ $ !                "& !'*,(&!'#$!$$**. 176<7793 54#7$:'6%=);,>,@&<D"?C=9<58!/ 4%56!5;5;!4!5#,!.*)!&',%'&&#$!#   #%&" ' #$!###                                 "''''( %(& '*'+%'  #'0.5531/&-)219802 ).-3-67= 852 60<79;9 :==:< ; FDA:;?9999@B>:576:>ACH!@'G"B%>">'; <#8$:$:(9#;#>D9C<B@C C'@#<#7;9=@BCHJOOORNQKNJGIGIEKNNONGMEIDGFF>C@@;7>D>BHCEED=:2 8#7+6(925(8.8&:)6(4,6.3*50,//2,.,,/)))-.'.')%',2-21224;154<757A:=9A?<9DF>FGGAKBCBD;?@>GIFAOGIBMLKANLP>MAP@U>SBV?P?V?SDVITGUL\NUQ[K]M^K^I]IbNbRcRfTgVhZgXk`fb`c\^YZZ`]]]e[`]eWb\dWc]bSfVdTaSaVeQfOjMlFlLvGxMwJrGrFuH|G|G~BBC~:|?8|8z9v7u:w<v9y<x3}4{.~0}/z+|-{,~4,|,/{41w1v0u*o,u/u0.}.'z/"v.{"w+}(z$z'{#*~#y$wl&t!j%s%o&g%m'i nnijgqgh`hbn)l(k*l*b)a*Z-b'Y([&V.]'\.Z)_/W'Y.Q-W1R,V)M&U+O3N1H7G2<6>;B::<?<69:686?484<356<785:<09+:'9!=$= F$?!D&?!@D@B:7,-%*' & )' . 0 -4 /6 12,('&#                                                                           %!#"$# %(),),*"/%13301.6300:6;78:772-*,155962/763555437428/0+///-."/+%.$#"$$! &-$$$30#35$0!4$0"4"1"3 2%3!. 4:6<<@<>A<@;:5@BADDAH @D AC#FC'EA%>7 <#>"<"=&;":%9 3#1$0",'6 0-6&.,2"2'2!4101(/-,,,.-./,1(.,, '$ $!$# $)'%&$"##!%##&"!"' ( 1 .52 , 2' 1 340*/--&-(0/93:3848-4*11.2./01247:= 9< 78 1 93 ;340 6 39 =;9:76#3"3+7#1&5,1+205,159116:147>5BBF:FHGAAP=G:Q8I:L=G2J:I6K?E?OAIBXKQI]EZD]=bB_>a?^;cB_>]@XAYBX?N?Q8NCWFWJ\IVDZFY@_FVA\CS?[@N?VJNEVIN9U:O<R:U=Q9Q=MALAI@I>J<M;F>RBKIK<G7E1K4D<F;@?C:<;<8<6<47=9::@:79@;<:;<C6:<>4<5:15-5,5/<*:(1'<%<$@ 7"8%0#7-&3%2&)&3")&-$.-/0/,/ 02-)!$!"' !"$!$$"%"#""%'"/&-&++(/(-((/0. 5, 3. 6- 5-4- 2-1)1%*( ,& - * &()+ $, ) )&&"! &!*%%"!                       "!                   !  !   !&--+&& -+-',,'-.-2) 7 1586=6><B; A:H:CFE J H L EH EJFJKKPRLF IBIIKLX][XS V PUSQNUM TNLKLKJNLMPFLCD;B9=8<9>4B::5 /**03-.%4(,*3*/(,))(!)$* +%&%,)"(0%.'0#1%-3"0 3&7(1(.).&,!/%33#5354,#3!'!+%"/#.*,%-*'%&)",'+*&#&!! $!%                                                                     '( "# "()$# $!#""$#" %&(#'&(#& $$'% "'' )( ,')*&/(,+000,0*2/0,,-0,4(.&+(00/1-3&+$"$  %  !  !              "!'"*#$ &'+(.+)&+!'+"*&"!($%(#)'+%*+,$.)0+4%7)9#9)6&4'4.1./-+.,(--'0(-%-&1,-/03)5,1,.-)2+2.4,/&/(.)*%,$+ -#+!, -".(,*,*-1+0-,03*(/..%*#*!&)&'"+%)&)$)!*$((&("%!$"!!#       $           ') #$'#)'2(2/52/(,&1 , 50239 6 9=< A: F@ D?>8 = 8 @:?8>=B@$C>!@;D$:<$82#4 1".'-(/-+5261614/8171@1=.?->,<*?)?)B*B(>,G*<*B#?&@!B(>"C#C$E+J)B*G'@*C%E?'<!<"5'<$8(7$9%;%<&@*A)A+@#=(:&:);(;/@/;3A9;3<=:94=3</?5?2=47693;;44:<6886;8A;>>I>=:J;H<R?O=P:N6R:M7O@M<G9I>C=CAC?C?I>G>M5O:M2Q6H.I4G2K6F5L6F/I/F0J3J5M6N5M6M2J/M-G*H+G(E+I-I&H&I(F&J%I.G'?*C B>>:::56388:5886>55.'*'*+*+#.++*(*%% $                          !   !$! ( &( &&)')( ,+,+**,,-&,$ +%,, /,,)'$%")%('$ !$#"!#!$'&           - (''" (/3549 7 66/64 47?BD=@ >F < =7 B ??B@@A@C @@ ;>CB>94600 ' ! $ '' *" (#' %!$$                                  % &)%)$#"'#-!$) +*)-/25?9;;<8>3835,4/6+/ 00 70 76<7 < 0 :/1 5, 1(+.//++ ,, /1/*+-)+%*.3--+&)&*,()0!' &&*'"$,(!$+$$&(%'#()!('$$%,"'"+#)'' "!$   #!$!#"'&!"""%#""!"###"                                " "!" !'"( " %&##%&&##$"&!#&+"%+,'+).&/%/&4.0)424+/36009653:74675295<6?8>7E?B8C<@:C8AD@8?C==9D8F<J>ICHEJJ@EJKBEGHEIGJIKHGHCGDFAK?N?O9O=S>P>NBO;P?K=K;OEO?L=N?J7O;M8O9N6U6O0U1O5R0L4J0I:H8M9Q:K7M4O8M2O4J+M&I#N)K2G-H3B+C)=+@)=)=&8$8";'3(8'1)4)6'3)."0$+"0.$2"-+.%.)1(,)/&+%+%)%-&,$()+'%)$) '!'#$ ! "!' ( %                              #                                                       ! $'')(&'+050 1(*+/+2*.1,0)/*3,++,2''), ,. +).,,0++.(2*/%) ' 0 0 ,-/&'(&)&',/,-(-(,''&&+*'*&!)&+!&&. )($$ #+ "$!!!+('-/!516266.418/53::;68:6<;9 273= 63&1/"14 12//403/02-1-,#(#$                            #$ $("&(2#+%/#)"+'**,*)))&%)%'+,-'2&+*3(.-6+9-6-9120:4658;526762647,435,826.:1<+81;+746+4.9+6+3&2*0*6.8)4.8)8+3#4/.)-2++#1(0&.)))/(&%,&"&#* $#" %%" ##  # $                                                                                                           !* (  !#(!(&) #&!&$'&!!!%'''!## # !! #"'!%"$"% %$!      !"""('%+%+&(%&$*&,#))'&)$+%&&(&'& $&$$*"#)!% )$ (#" )%"$)((&%!%!&#!&$"!'"$'%!$!$'!!&!('/(****&&%!#"!"""   !      # " % % *)(!"               " &$&$(%-&/$)'++--(-$-$*#+%-*/0 / 0* *) +0 (/') &'.)0*-%&'#%%'%'#"!                                                                      " " #" #$%#"&#$$*&)$"(%"($)#'$!%!&# #!#%"*$!$,& %"" #$%%!$' # ""&!& &&%"' %!#"%&)&&)('$%&%&!((#$(%&$"'#!$! "&!") (#"&!#%%$*( ,+$,$.$'&($*&+*++('"$'"&$%#$ # (##$ " "                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         ! &"%"#!"$""!# ##""##$!$!!"#$" !"##$ "$##%$"!#! $"""$#!# #   $ !#"!"!!!"%" "! ##                                                                          ! !!" "#  """!                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              java-design-patterns-1.16.0/event-queue/etc/Bass-Drum-1.wav000066400000000000000000006576301312550536300233410ustar00rootroot00000000000000RIFF_WAVEfmt Ddata^ V'9dN< ) 0g_S  8   K S U R  7    h  G U M 0  C . e  LSH X3=gH_GtHH{? i  < A  jl'Pu !w u"Y!3#-"C#""O"#b"%#&g%~'O&7('('^)Q($)z(('('8*(+&*G,]+**)('''f&K'D&'&)'+)+/+[*+*)))(%j&a%#K+='80-1///,,.p,1/z213111.O/;,+.,E2#0610e,.!^&  p(| q/+d4X1|4 432K3221/S0)+ @$64t=#&%l y Ztw,N!(%%&[( & z -?Qc[m|Uh;5N3ڳڏXޥCߥ Ԝ8pzʔ&ͫqhof{(0ȽhJѫΉoʹ/*LjȦ*Q)\8hJx`ȔqȢɃȷɑɤɴɿ5 5P'S5kIxNɃcɓrɢ|ɫʒɾʛʪʶ.5K+Q8hCmXʆ]ʊqʝ{ʤˊʴ˔ʽ˦˱˾#)>F,V;bCpTzcˎlː˩̈ˬ̷̛̠̻ " 5;$L7VBeMoYh̉u̙̠͍̰̺ͨ͘ʹ!-7&E1R>^QiYxf́r͒͘ΐͬΖͲΦήν  "-;/F5RCXPk]rl΄uΌτΛόΣϖαϣμϲϽ"(JUep}όоϩЈ:і־5l!!l ~Z޺CY[e UHo"J3ogA-t 7 Q-d J_ :"I!#"#;#$R#=%#(&.*51x96;:;::$:r8|8666658g6b98M9 89<8P9489787878l78Z7|8G7o847_8$7M87>87-86 868686"86;86F87D87 86867676767676767z67t67b67U67O67J6w7A6m776X7!6H76476-76'7575 756565656565656575975=76756565656c56`56a56q56n56h5x6J5Y635P65E65V65W65]6,5R65R65O6"5L65=65<6 56464545454545~4545z45t45u45n45o45h45]4|5L45J45Q45P4|5S45K4o5F4l5>4Z504M54C54N54K54?54534343434343434343434r3m4Y3B4)3T434Q34|34|3s4]3Z403t4:3}4Q3{4P3n4J3K4534242%42*43423222]2z1G212z136232323232323j2I3@221^2r11010W2 12h1t211000e0/40#/W00/0S/0/i101020100+0p0////|./g./.c/.>.-D-,-Y,,,()&>& &>%&%F'%&)M')(&|'!T#T/16)!"\!~!~! >V""He:j$ t  X A e 7  Y P b   6#r:+uG7= lDDP6tQY5JVPVAuVkQ=.g;fowEQ,,_@3XhI; a]TZvbdiK0A$ ?+)C"o:7lV#&;%X%HJTROe?IRo@L5]_B[#U\޽R1۽ߠ[i޿ݝݸ܊`T':{ߌZ%+RNA'#٠ѠѠѠР Ġà󞳠Ɜ㞣វܞΞΞ}sjf]XQG=A4w2s-m'a$`TV M GC<=32$&؟ڟПҟğ흪靪条❢؝ѝӝʝӝȝÝ~vsooklolmijs~vEW~n|Ƞ`B'@CMx*МңȜꢔaTk FFGǦÜ#9^&)ɟtTݟ~ǩ BZLǣ1LӣWQQ/r wFTF⬪oRӵ`Cޱ%y织àyrڽ_;彃߽~мQ£`mƇìȈÑocZiÿdŨ|MʻNW-ѯ5S͋jľS_SRz*СM:͚ϩҷԧ:ևuվ}׬+52ܯYwp)EܤޔGzނ=7ޡ?khHݵےܐ$sW#_':GyImunwXcF$sFW k/ . R {K  P ;    Q-Q<d!h #"!$9"G%1$-%%$o'#'#4'?#%9##r#a"*$!V%-"&I$('+*,g--.-.d-4.,%-G,[,{,3,-,5/ .h1/3'1P52q6327Q57O6E766J6g6565{6968J7l:8<|:>;><5>.9?9A;CT?ESCFjF[GH1GGFE)FCE?BDrA}D{ADBDCDCGECEmCFCPHEJG+KImKJ KgJ}JIJHuKH|LI5MI3MTJMJAMTKMK NLNMOXNPNQNORO;TPUYRRWTXVYX8Z~YZ~YZYWZmXX]W*W,V V>UU%UVU^XVVZ X&\cY/]`Z]3[][]\^^\_^w\]j[[\Y[XZXY7YZZ[\]^a__k````?`{`Q__^^_^(`"_`_l`J`T__`]_W\_[}^[^%\_\_d]`p^a_yaabwbcbc!c_dbdbddakc0`Qb_am`aacce!ecgehe&idRhZcfa eF`c_a_ca`b`cvaAdbb\eGc;fcfpcfcfd.g0dYgc|gcfae`c_b_,bB`b5a7bbbcc1edfeogfegWgf gfKfAeedc{dczdcddegeYgfhgEighggegxdMgd5hdidkelflTglglEhMlhkhxjphIighfNifkpflfngphpioi7p0iqisitivuivnjkvkult\msm sms mtlvlw:mwlzwlv=lpuku|kulYw2mxmybnzn{o }p~r~rD~r+~r~_r}zqy}Cp}o|[oJ|o$|p|q1|rb}r$rsjrs~tr}t{tz_rypzozo{Zo }ep}q}r4}s{t5{Bu9{u |Zv|xv}3v}Mv{}v~wn~zx~y}bye|xz}wysuKys3ysysy uy.vytvxuxux.vxpvxvxvRwwvCw@v{wuxwRuvtu ttsststtDuuVu`v6u%vtGus t!s;srrr3srttuiu$wuwYuvs4ur=scpqoeoJpopo7q@qcqrAqs?qsqrr#rQsqDsqr:rrprnpq2lnijgPgfLerfeg?fh]hjj@llm9nnnnnmdmRlnktj7ihTg g"feeRedQece~be+a/fq`fC`e`eadabiab`a_a]a\na[-a9[`[&`Z_>Z[]'Y[SWX UVRxUPTN1TNbTMTfNTN0T{NRM[Q L9PJIOI$OHOPHNG1NGmL+GIELGCEA8D?;C=B7:CO7N>0aR{?0C"89*V.2e,cU7=D\?;+ -IwS(ZTIyޭQ~93ۨ|Z ۧ۽)9qث ؞jաAҠԨ3Ԁ "UҒϣjτʙ΅[#ɏ%ŷQ/aT 4+Ɩ;-Đɜ1+<ʽx:őƝ7PQľ£CK;Ӿ#j >1#.̲hʰtUӹh^ϸTRyD-*/خomx{鮅ƭm-a $KŬ/2d&$ եҫh1䫚A[GVfWʦ-fѦvæˡܤęٞsꢾrO㟕DΜ=kpA'ʟzuNaQ#TX3/&3n,:o lv ˔?ܘ֑Lؙ.o•(,d)š5+⚑0@])xG`.`ĚۚWڗU@̞/%͜͝Μٚ^Λ P(ixԠrp С{Z?^㢸 ja񢍥t6oԨG Īi[1985B?maجέv5yT**ngɴ|*q ʹQMͼuCt8*d |þ;~-K|%'I\;9|ãďŹǝ˔̡YL-dɑ̖ʿE_)҅"ҋ"ӤԽ6Y~нր8MӤ@Ղl֑:g؝ؐ~ؾّ&CauޚK/5ersO;XT{s>_nr; wao' ,domH ,     ^U . ^ K E - S%     Vca{(L[O  !"#$2%&D&%% &!&"|'$(i&%*Z'+ (Z,).)/:*10*2*3 ,[4-4/85>1J5O2524b343536H37\383?93w9496099M9)^>A?B?B@AsAj@QB@SC\A#DCuDED9GDgGEOFFDCHCIECPJCJDJFJkHDKJ5LIKLKLKLJLJ&ML`MM\MCOM1PQM>PNwONMOLO$LOM@P4OPQQSQT(RURURrT>RRQQnQQPRORO,T PFUPsU RT&ST4STfRUKQ~VPVPWPV!QVgQVQ%VQURgURUSVRTW[T XTWTVTU~ST[RTQUPV"PWPBY0RZGS6YMS(W$RTxPR\OQ(ORO UPVFPxWMPV PUOXUOUOU?PxUPUfQUQ*VzR WSwWR-WP9VNTMMSMRMRNSN=S_NRMQ[MPLOLNK,NKtMqKOLKJuLILHL/H[JGvHRH9GHFHFBHGUGFG\F2G1E GCGCGGB;GBGBSFBDBHDBGD@C?SB=@;? :@8@\7A6BAF7@[7?6K=5<4H$JinP[r"PA&YjX .=\'v) ++43r(Er{eXVe=?Nl_)8y 7p+~jqC& UhTMO9-y<:%p"EE[qXa#FF^ipG|\X!n|t t}#5Q:}x|EN%-Niv]?"y!(Mew]`9CrYP6A.Gs $~'-dpYc'+5d%F?6Q+o~wl;F)M!5zj 8;d4,D\Qd<&L3 s/L|,],"-1]fQ'QqAzeU6 94>j]&Da lb\$]f,f `<7@J' D=+If w>`dTe Yi)6A>p~^poan@OmQ1>p4`O'1Qv{ vLP`xODJ#.x#Xt>0w}AnCTObID,*[5   mg  C   I  khO   s     \. E 4K    s b" 9 =2  [ 0DgTEc0,sWM"m9`  h]y&V  ! Sa Y n  L-T$> =  L  i `  D  e  Z, @ z R ^| @+" ? `   .q7R/{SB#Om&I!On2 :[+l^ 7A?55+H5_\KJb kf   h T  JJh%u  _] n: 7 _ g j}   _  `6Z~j H h/ $+S ,Q  :   Z  c Sd + ! d?  H G @{f     t N  h [ /3    [IV1B . 8u 6 x.|]:i ^ M ^ k   & 4 9 J    Vp /E 3 >    88n8L=4>XH0Ty+ toz.PoV>ty6Uhl(k)>^Jz|;i:0#P7!L "Y!!.!  |qH  !z9 0jg_f     O bb.!mPWa9M>Afz?(]{TM`w+!`#{#r" KdYo 90j b!"#$$$"l J$=7x   z; F 3  S5 { `XG* L  G. 0U D L  @U 1 "  h c K  .l eO BC'8R2N,9   <Y  2c$uVi%~r"7zC( 8 g u o $  Q  b.5l-9 q c  M  4 Cz  n V  .? mE <CFmf ly Xs=nB:dXm Jssq+l O5KD@WbeBfmS})@e~ K]4iYl^JuK[ ~G ,  's # 4u + c  "'ZIq6D:E!<Ng&Ygz1+' 2[<*RLiIDZGCr;z(`%hQkv9m (r, ?b,):*'\c*0d~#3+l=w~4#h>Jj#5S1_q}5-W.MG7CL #? ;C:',C}7/i%-bkZ\{]+a*Ke6H=DyBjvP4N'V]*PC.#_\'!B 12M.cglD@D]ed:+]~ Dlk7A$OL%q~GP ]6TBK\  \<V\4&*k3CCmS%\Oq) }I_;DoMc\kjs?#'M0~<B | uqUdHjR+ j b< (y4 T l 3  ^  M ! + 2 s p \ q  XU s o:zY  / q H 2 / } V , i  u ? I  v_ K 4 W ag !  A8f-}8+W?_u7n; xJnkW_z=k4 d+ g (!{&e&~ I:8Yc=f>l* k   h  H> b Ej~y   {9p u  [  E+UU\z    . {h3?Xas9L  ) < UL }4wk- 5p ! y y  sw   pxbg{4 fE5=k d[_'1EJ 6YPs-,v\ /g51e>Tm,H2t'%USb;-I|9+A < S < < Tnn=w8 8     G 6 <.m0/z6X~C"J`Gj4Ea~ , ,  } 7.V 3 m !T'7D 3   ! $ d  # W,"}Ie6[0Q\026#w2M$< ^7:3-G-}pTM~8;{@nc"%'ZAgtl _u3=wS<Py*Cc?bY**%);fzEnjli6M3cd"-u=V"z2)S;WJo5}\ &nW*R'"':7i XkDC&&ybaL_OP%c;P](K^oA:(Rt< 1xVfnFY%Q t+&CH*b OKaL'oN 6rEBn_r}/b}RXba;w-mUc ^nVBn}S0+ pK9Z#Fh'0*:}pwg-$c6|_>Ktt$4K}rs1$1! 4`gI<l@ &=3xm.5GWT1dw9X\[RW8fH+ic9Z2mQR A2 "g*x* x B{ VJ-T " :\+gs\ R2 C js}Z:GK tjb;(l7{R3<6 Cv f)P+G[.k65B>t%,.A;4w)KVm,z0!S<vOoouWdMq]EIlZHlUH61Du]sH$Ff3gn^.E[\Q$#<V{ H8)\djS]P_#vU6!9DkK 2Yr}rqm9h1a3X \ a,Jr \DvSosIV+9o9Eu`OQ@F& L0Qi<9tB %4y-h=I]Pu8ydZ<pDJj_9`=F*0_'dT:L{Eo(BZjfA,'Rn0HkeQ|P8KA i3N;@[ ^79ZC#QFRs h2*UKtnf}V'lxrvK#(4_ L  # ^ 9  J - *3 y !1C  q " )  C *Hi{ @Q  06 N : Qn  @ R  | XJE H V x : o 4 h [o T Q   [ \ & 2 @u  g :  S  rN   o  a hEJE#"m2 t  \|)k[r0"-Qtj9tZ 4ryJ?0~a^aO!s '#X.5F^7$Wc7/EM-%=P"t62Fi7`av7Wc9\q#ye-5crZUVShd/U-<XBw M2QDl|*<&i(Flh!81DrSLfv.DGhN>Z0-17C DDrR:,d w9D";P_6 T?NzVo&01K  -kTa{3,0EU KPQO:5,g  W C y  4   } , r   4 N @ :   5 ~ l ( J G  m      z    eXCE     vw  e   \ |  BCF @l E   d    Q B0 1z 3 2 y } q >  l H *Ox:  N L  GY _ sjNg'Q*c"XlRg+W"Lol_s1;oPjS]^(ZHp9i0Us|X< OoT|Q+nQ1r6ke|qP.S1b%Jsw"QO_ B(49*z1}UuO*ERTfc Z&l>4cj$2-YO4%hu3v #>8K&}WWfBHLEXEmQ z0U# dNwiM,12;QZ e>oV0hT}S+_UzqZL`7v-)vLLFmQ[8ze.#]LS6tLV_/@84}(PU@>NV-*/%lmwV)jhvd%kW/<'_AK"a]2'~m!1a,"y4N&I2,| I[`ggu7r8YR63)S-B_gPs{h\H84Ij$ 1;z$'/:`zE*~Sr  gp@1FU.<+I.wWCg pc a P N jaF+t<? 9 7 { ? n # e      EQ f e ? -F t}   -\ z G f V+ i N1 o2yWc'%^ y x ! :^_N3 iN+v.Q_m&F|V r:se$OP#.myb %FO|cGNu"LX:_o}yTE#y5L\m F e*;V fI2G4rC ))|,CaUw;z?ZvS 6I j ( q % ( dem   < o  \ ~ O 227!X   W C E   E  - Ue8w :z  P,/;6R|?t)O#xJI5m{$ 0o~n0 4:2 x' n f|{X+D  J o)    }@ < (8 "  Z  6 w  ( wY q p  P Z  |3 oW3 ` ? v CR MhKj <  r 0 J sg  @   a  }F+RxUfU^p-#saeSD^"ReYU qG?(_:YE{O+h)QT Y{Q,o/p-d%_>#7f@K^0c\x$zuy `q5Boj-vYPFmIKN*+o*8RVxyEZ0b0,y\%mC,} |/$* d2/Azs`6 U{}fv7)e2R"!B{>|!PYP$N=e]x;_TvKlId7s~91ij UqL& :5ug|h86 zk+(4e:1-P9 w: xHw$!r;>y t^19 b:I+aQ#i]C[[933<Bm2q Zk;l8$N C .jy\mv3_W;F sn ZO  >   VZ B =^ !k ycW BP K  w $  N >  ?  c ^ M M G ; 5 f }n k= i  *  ] < ~ A n   ~[ 2R   Z E E     z   o  z  fi \L h34R7. 0*4wxQ_B|zm/^-C#B=<VDW\ 8R-u{!r#B;UrKqg%L;dgVmt"q"PQSp<= bY NV!"\O ccf,+L qXP$zsdz+Zl;5* )[JZ=Jq>STm8nE=kq[  ]"gd_O2OldIf<& JD^ m|kr*OiJ=_%DkX@d!$op4o6!k8{C|)Rc%YNFR3s?GHdTqO7J~*$Y'~R:|XT s<MZT#!am}3"FXT UhqBWWhFBL\lz% X.8sb"JX5 V}aU(~b|@HX6BzR3xs]n{^uI;RMIWeE~@n?\+^_6  kr*TCJz.pUo/]3O4&5 E@EmZ(N]\.b %BZ;Uz3V 8o G[-f+8ghT,nA U rBtFqxcU<3QuHxUC[<8* 4[^0K<~RvX@Q2J2fs5U|E`/f?,r"8ekYaYUw ". K   WOsh\ | o r# '1D2hGJ   | !i\    njx``  q= v'  A3K11[T0D7}y8 K=,v"kGZ=nY )'cWgG7#LIi(YU g]&2RdjNix6!+j%SJl+'!*!<3UNcQ29`H5"zlTxc^@Ur EjQy{'QW?)Q _/[WZ,6+Bu^ 6*{<E,_&cFX|xjKOky}7CuQ!v)YL\30:1&TBo%8&wy "BtCB?Ao.8{s Gfp7-D& VDb/{{];eq Z00+L.8B 4Bu)R$vVy;2 _J@2LP]V}"7W}PSg5z9FBtBqKnh%)P ACnoh*gn91f'->nB; 6b5(h1c_%R9:Oz[C? c!w)gZ'(:UJl|*<;I[^Z{7 2cc/oq90vPP/78=FtNJ|K+4%PJV0dW  ) D   G  J gS E g  }l K 9O Tu   C  _ x  l t'  8. Wv c  (Y ` +Re$> .CYV5T* E S a x 3 w qp bp( {  W > x    @ ,   \ C      @f/ G  t   *7Ysq {  "3 P Ob{A   f 6   E Y | } n r E  p 5 3 { u  ? B  6 C C = > " + x [  p  N 9 @ c  y t    & c k " G  Cf  J r : + ? 5  y f > j M  h   h  3 o  @ C  Q I v  4  c5 A h  A  ' @i vq &  / A y  o A     < T * [N   i @ ]  b o H -Z   h  a   @  WY?H)9#K#|J /5unTPfGrY&3l 1`MVfeN;\Yz#N Q}c"<`Ue)0+GSyJeAd glRo6N`/* y[Bkeb,GrF.x8|SI, Dq~Ix:l7lo+TuCi1Ns0Yx&yS,[ *q-b66G?6%^Ll-&N k#SD!}(xa<76G E>li|V(`Q'1 4}IQgMb'(2q,cn- I8y4S`Pmi2"eM-|zD2jw~"6P1UY _iJNc1},HNB0/Tw#Hg[F(b ,@r'#=b,e.2LKe!_Eb3 Ac T+ Ex.\=hy-\YgaV0B/#A_5fbdM<fO>3\'Ly'?5Cf}\:vOod"}3(OX3sTgiUbA#~t7!gGapOJ+V)NuAU/ L .E>sZX0j+^>;!_k FAxS)T'417~ #{js @'LZ<'GI,H\&^lHN@_DG,$?H,y|Ms(Fndc`^d^D26;d(q42.'XM&OZwXh7On/}\~lC<3<=ayD #9SS2%.GP:{ZwLahUj@}P1%mQ{gniQ_mZZ8(G =Oj0ph1Sy>xy}Fp?~`G P^Mm KJ(l2~C&>z#m1DFH& E8n2H(||NRGwn~>Fy  "z@t]W | C/HOUrA>O ,WTA:?YnAEHHH !5v  f!;@y6Q0Fyo+^-]V^x+Js/o&}AA+X}?p_/?^,s&"|tY?K.{h9k6Q%[k^XTU>7 M]#6 ?>[NVZg&,~uKD+jY`h/]SKYf|Fw 8XFMqEP`mTevz#_'XJPPU)r bpRO?pGN)X&",%B#8Uk`Y}8\Oe(qQ]1+9sO,>*x[M! +@`D_?0`WuPP6l(^Ax<kP[3Hp]*O%s a t$l.jw`5pffemtS]_3GEN?g:i f Qcixi;&Ae/RX--&#y\\@!|&>Mqw< #PM5Et74< NZf\biSh&d_hqTJ zML+CbD!t~/ \T)o zzK.$4F5ETyM#wdE252(C!%s(Y'2mEa4&xp5+4%e2hq'(:2 ^]jkMP##1: Ul>W]Gg9V0ab|l\G5643B&l 'v,  j2@Uh oM g[|v Q3.SS(0tf;2l9U ^i(}e}Q!RxT\8>@?hO>{.;S<{~ Zx~_,XKLoTn>pMg &i) <|t:d9ny1$>-b~}"I\v7u. )`5ck#Lg]& k=d<o<Y 3S~ (JSH?M@}$ YC%"%qE1A^W9%)$/, t7 Hmk>mxn?3AyVn+WYly> ,+ "&Bay}}1ey[Qz:4Sb K-Lr ~\>,6hv;Mk/6P.tskpU5GNF='\X?EWxVH.%UpI.`u{|*o@W}Y!1 Pd3A/?uI YwK=jw!&OKT!O@R?G{f a]2NeP9|%] iMnhrY[bHyLn;";M[w tK ^%T}M^FH1QDt=Qt)hMlb9<w!lk.sn$2Y!! Y,UN\ *^0: 7tP<OS*]v7J*Z0YL8QZk Ya~qgS$N;P_-XE;I{   vG <AO/_SquV g?  \H"x x  6 =]MBaUw  RqM+31y RI@ E @c AMUI4bj7'+ B9-y\ {q.6HR/HC2i ~&"j5U3 x^$)_m1{+?1RJFQ~6`iw?:/MDua6hU!UU !Kh) rIgqm/i.D 4$pk@Inv*/J:&ycm`oZQir88p|8E&F:#\%Df)wz[x5J+kkC!Kj7H%_89t'*Hk.C]oE[VfgY+QXl(Y* ^w#\Hc>iJ6LozB7"W|d"^ BD5IjA=(@q]w/]70]PXhA/;j<_/*}$- +'rG;B^%H^,4 JCd&OJx.[Lx|F~R.". C$, 7#l.Rp\kt LgUD[tG[W* b'ryUf?1/!,*IHBlMC%).~@\a `yt9a7hwYq^&DMB&uH]B`t3,x!6V@!yXb8u?DqU=g E^C-O&.HL';9[X =OzW&KIt[s}! 4 Ej4s 54b0vJsFbwTOEQx8^/NO$U. }>s|(tEhZLb&Q7i8` k0Ext OptUj*Z,$`|_ ffFb1m3bku5} #Ld7s 8u x!t[bqwD"xgY{r]4PhD&ZOi;|Qnyum[OS8wLmzw|LV4A9L_UIa13Wb5@hHLddYNj,8ET@xz:3*43PpasDB?s\6I}G`YOE[uO 1OOI@=Dgm"wB$YOv{gTYi}vw5QoY!)\ERXnm y]6^(:- :~_!Db4= n5t+gp^:)zM~Zy+-&Ou/F!"#_DN]lnrlr$,9G=%0TZ+z[Bz6:A& d-)#o` L74 R 4bXc% Mn%9jJ /n3  CLh5{NjL=1+^(,ICOle3p4c#}_tRJvEv%b+}ui6y1^|]n%_}L[qdVi!} p  3 OaN?4 !\ d 8 o { P M O x>|,PT[yu V9 lp(8 6%&CQ(DYdni9 zri /A|Sg0Mu8BsMcTs:>m)I>7~r[B-)6^Hg\;`wMs><Uvkf\ r L IZ-OU  G? 'cK) 'o O *q l     o r  0 "o  il  N   . y )   D  Z[ E   x e;)QW v _- N: 8 ; 7 K Q=   Q.B2oF,c JAaHiRCk#AgtA_) 2_zg+`jX}ULV6|Zf`^@'/72Z~.DZ/Z^zmX/t'K^  4!4*k:|Jlki[6k n#Q;l=lG:>a.iE~u, !;vY'^)vho}D)DRv5ekY{lr5lpi:m"V;-]R5{Ggj,sl6 E(lN@1SYQ P);:3Rs2-gSQYfKSpo?|#d X$| "@Mru]vg;qStO*Pza2+%$K8{-ns(hfNPb1XG*{x_ai$VoC-Tn>6KW^T`\&B72|sw]EYkjkSw2Qy=+m,9L]B;9rz# Et(0?,5bNQE t"G1kj9HR,Zy-O.VbbJS~9q"lgAw@M+~hSE*Ko(r-J? I7X,M>`S}7m(DLmgZVAQ<XT@~U]`~ R\b5,1XRpwr .(]k5\K1T`0^0EV#&>L@'w.;#x%qCd(9]+!QcCdF Qx=$I @\A[y?@i;"H3hl`H)xxdU^F\8v-/t C#YjK/oj;K5LwHchO9.VqJhj%vD~nmW+XKmctA^c3@t(;C^-uI%gruxg =57%aK2q*)`-wey,?$,M:W +(b,$ {>eF51JsYfHC[pQb4~^0;:f0F ,'Nv~uBcjre#~_gw H*wmpG\wPx'[HtE_8m39 5\~nu9| Pc}d~iNgXD3I y/dzkH}/?%4J} ={}Mnj_OOUVtgg&7.6fs5baSH"tRuIIYj(y@\K f 5 -@C@3ac[ %\}O jes QavfIX~X\wv x1[lEc1B+#na ?:qq?PIC_E //#<]eA-{}_qr-Z3nB8|#rFMd |nEb)Y|kj$lOvY;$5OLXfekrHq| %PL?h>@b{;+%#IqzX}5*$hnInL;4&SEweN/l4 KI52*GD!#n }+e39 #P2 90Dx&<5ES'c]CAVjN$_7!ikj CG=Is`K3=mT!jbeU?5D"e =gs6A]  QG![ s-q]$qYqro>z 5!E V<b,;| $SD3pRC Fd, f]wx3 (w`f2poq9}Ag<W $0s!b!Zcx }3?GOxm). Pj:,J[m.jN> [2u&[LMA >dRwf,{g/| h|'hEi>}B=V&^aWo4op1mm a/TVe+Cup`^Vi.$;(&7C>/R 0+]="[xl-><7ckPi|N DC~#j[K13V#JQNkA75L#>yhcO F'L(@@nmiM1Mg+I9 )0(>YTWJ$E7 XQ,v8kF4$/O$ZL L, bN 3bqzyq [${wqnV__TCWiR^'V0Rk0ke9uv{}zydB2ZEEJ TE58e <,`sbM*5X@kjNy(9dRjrutHyheO<'`$e )~G/_])8RBkDo2yv'Yu?@#`MO0lo/D2$=s2NTH+dHvu/*b_#iX:p.y, <|rznijJS":6b Kz0ADhokHm/Gxo1aK3h L;de\t_BziYz6+"! iT)bju>\8|21xGIj^%[gr7q%yvB. eNbv d!8 :!~z7{ u]^6{>TEy<[fP(X-? c X xO< e'eD VW#=u7^q9Ocnp_[wC\@^oOwFA0qo\` V*)O9r t^j E~jd7bsl;c"{wY 5(.JYm8n`2 xkGd4 O=SN(3'P}=mCk'}:{Y8  xj+&l]?l#N*i$a`%S+]#[d5}km$]I`em+FXcP/%]B9bF*" p" O#=]dJ^6'@E.MaO"1M V;p>n#\FyAa7RDbY2OUD~FL -be|viBeB3A-E;PJ'A@:Zf/Q(`J:(c-Lh,,5A97h.fHn?$'30RL;7`IO rA;g&$rxr-uluT3y=JgIi,t9VI^ w ir|c~%|.lo0}@7rd\^#g Q1*FYt{G-;xOrtPL87G^suT[JsiK\cz'/3.m3-l5QZdj7jN BH*>4]/]:'oW-b,Z/`+E 720K6v,nI &B!B[4)^q^+4HGFxc]`fX?'iHvv+LS \wkL@Ad e*\Gn(@9uqU7Y,t8{cc(TZKk[$c_\(`v"`K8@fxN~LzcV]cb?UMn%6xnrs `7ccY?$(Y,}3>K0'"7zT| \ ,(onNSYq#[uU\Y9 F/,]@ mWj y!|z_CL() Jt 6M~T6z@qHzX|QaM:Y%7LN1E0P0SG 2s1NA:$Ej(X1!!1J dUkZ)9t781]U:O!!N 8JDnk98EuVR1/@5k>Widv 8dYED* C7&mX[JnZisFe &K08+jhzJ%31AYptlY7z_wZy%,0$-42iUg"B/T"3 k NM"9:m/~JS6$ $L{" 2.N_J/3ZfbmzlW6 miOGV 8({>s]8AY )-hj0 IUNw<Cw?DF +'I!9v/4L 3XdJ< 8#lOd}u"i-S(02fDPUHv5' j FMC_`>9D] e `J7@e YE 9A]OdO-%I;v~G`:%Um)ijQ(3Wj!T<1V@^S75fmQIM9V(3&@jw!83'&*.KelLt34y(H-8 OOrvyoYN3j$M y+JKX~|u )K_J[Nr;q,k>((hWcTwa/FK{ F-*43 J :=JL1O>m6f $S?#6|N-!#&Fyc#!Isg23wZxrmEGc#a"`.sR8 #d4jo6V8JU2nQ_]A@utzn: 0OWr3n`]D0VtpiDG;)m2,ARc_M)A}l^s [@Z[NAGf\R^v<!\ x\.a ?JW?$6{rIW{fI3z!Tw MO<?lxDh>!iw5HZ"P9~9N&%`3Yp;JIdvY<ff4aim`6%/k~e=j<"%*A p&H] =I&+<:PJ^HP23 rOJ 12Ivb>k7yyslif_jPo+tnbU6GQr*%'i[;TWhW*!Q~mR?Iw/h h );K.z"_ :.adM- @zxX?!dB@U|~s  /s7$w?0!}&0CUyg7plZ.>nCdAX+bngXJMj@+ @!&|jQ&Fv -@kH~sK{4xhC]%p2Z#,% ]N ?&><;6G/.$F|  >y ,%h5+NuUaLlOX?s}tbF! v%4>_s)Juo_3#0$;\}?G78bvmL# *Jr#}1I202Mcx0rwxm~+N5% %5 RIq\nC|^!B/R5bk?kl4t^(Sh5$na}:WMK=ZwUWXWY ia_wJmA+d&!J:4w^>-96sThc1E _EjB'=!u?Z|uI<,>P)i9V0# ot-K5@/4r N5OTGdx>y-Ux-h&(4>`~c?)+yMV76sIjYNdhd9b%O1SLmovN.5c q^jC;B%Y|8gPd b>6s6Cr_9{(O4\Nh!Jclr[^Qe .*}@B8*z,B^d\E0v +7U\Vg%pzk 5tsn15+8b{R!J~kBvX: bN@Fx_pzsv{|lxCU'#4Kw}dQuM@^19l*Bg=@mnlA#nIR7VsfE(GOOT[]a/+yv\?A0."7Pd|M1~JKChye{C{8o)f UE=@XynBzrfs IRe3~NMlCOT*exv0K<nE.*f*4>5zvq } lko*zHdysdlQBQgZlNQjGMXf &0N@x#\E{|X1Pr$:I=%=bPyN[4 8 CFU;N_:c`R`C^m p|.o^^rclblai^gN`J_NoqVNoo4 (D>VnO'w;6bk25y)GW5o/^7t&9SE {$Q])Ej H EM|QyqK%F$?Xx b  nMCfr&td_a\f^aq"*M4$Xfz!M,0SzoK*$ PCO=5_eFi!HJNAmkP8Kh /0{u){SH)yrU~-v3`Ut b<hN9E15Lg4dTe, |{/PllkSB,tf,6:1R\^X&X7W/gG mxRcYTeya$-|G3t,\XQD/1j)I~S"{>X9:X\D2-Eo`~lbccrh){w=mU}wbD- 2}nvl)/)%i:E]xr]=2>e >E2 f*w*tA CK+{hYn 7'u H`lVm-(I'2%Tuij,WoTLWk]KtIRciT3 /sy\1`sBf)u!)F^tsuuP8 o|)9bVKi3  ; `!=WXmq C/FE?U(1P<+[Ng1EOWKNYq/F - Kh%_qC:Mi9~X6:Tk eV4 '1Ejn(`[CvpX. <{;njWZ}_Yw'-]m"<wbbpjD@4) #Gu` yqm]QOH_asmG6:/0,G+Je|Gf{xdS;5Ij"FfwnL'1kLnD <qb[b{ZJKv5nB 2/q`J_vOg2`oxhsEWQC@W,:")"<_P8xBVi<z:bTsIwQ8-2n>HCRPCd9'v}9V!^XPA///Fd2:*nF7Cc5Q:7Lz|z2% 55*?PQ}qYr*  ;<5+-Ac,` b(@fvu k"^#R>(" 35XIw2n[~<%)H^vswowgify! .+) jZIFGsJ}-z.M>ENY_epzE[qu z}' ):RmM\+<:6?~Sj)_#6N bU2, cdG2<> 'eWdms}{fa7.,^P",R|kw\|7sI,gluAX*_nT5(OxiehhkUjnX@( h@ ?2F\`oo6VX8!36Nd g7_AN;=N5u) f/:|rtsKO8R#c6^1J_Vs.{bTO]\V.\  i!Qoqy`6aeqd$y@x\K?)#:IOWWM.~v_F"{;&;Jctd3}p|(To_%h8gI#m5bD05##  FYik^E)9x+nT|ipfX]SNLF 4;]mt\<= @RaQyO=Pqy_*jc.g~n=(Tvq?"H+ 2f804!*<ge <#7J!pbA=?8!DM3jTQmbHZ @T\hu$W[=^Wk.MD4GIk ~m0iDo\nY]]yAP7Pf)$)4VPkE_0Csa?*ZuS' rtW[xk6}i}twY|Peo"Z[M? y_EYakuwtn]t=~"*|;k9O(LGZ[\zPH97=>GMkwxXl>WOKm=45&OPkY:"S-3=''5'ML\~XY`q7N^G:C-mep&VG=\|v>x W<)0Q !C]Zb{WvQOesE#'H+JA,Xels[G?AxOb[TpYz]q|wnY~IZ|tI!#; OUJAq9 =8$  lJ>76- 5be9!6swa^%v4k-SMS`Ay=sNul;dYoX}O(+? _;vpqVg1< >KcVB%`39w.5.-U}*f^yS(+\ 1/% qt'MGoJv/p YG8kufOIe7Kc+p-H;Wv||?R'B:xz9OD$8\l!gH_zKOWrsr[B'(?4dBQ_mbpJd2a0F2a,(@j|C_yyn\m\GV:>'GcjY'  [,se%6<:4'e =2Uyn[PeyiXqv\QRzQLI7#"<X]uvzY1hC&'6JkZ)%(4=?6([?",81T8x<%i[LF8!k^d !k*`*sj\OIFKDt/A5Z|rJ h[Xdgk=`0C.h 6Y@QjhP, -:Pg{s\Bd1vx M%P >?i`Wj;k,S 1,BWtaTdMez$dq}TRG6**1wNylijXPFWu3Vd\5H'5EGHITewMxxcP0 "Q713f<.'q= >jdK66f//.1U&#)IlnS8/ &;OTR 4!2F>-+YbGGoPFwlf_`oiO|daETMM\PbcZ4=}m_]kj`:yy}n)O!37V{!%6>"P`u'5?99E]u@}XP;&D3@RSVXO_djjmt}{~ | 5K\TA '<E`Mn@jVA1&-m $4B|<f+["X!j;[>rM  *<[{uy:CjA39/o>FKNO~i9 #8|@y5!=P_Zab>a^ yz &-!O 7p`TIS3[o\= 5kS `A3)1?jRjR:t{sD ./NXw*iK1/XkihcQe?#~ u }*_7572=FL0c6xv5p]DBCtVxzstydbs2hjPAAEelz|+o-g>aHcTictiore{T8 7`eJd|bik:\3'Dj|_cKU7hN]|if_o~4Rj~m]Z[[La??2&6K,mS<yR?NNG@?9@^z)+-08QbpxzxS:r7_HJ[<v<{LcuBq UR/Z8|JTZN{G`A\R`ulxwmYFJ=+@.O>dQhKQ(* 7fq\$$1,ZNY}qH ')j6!9R\R :!w+X728H]LNQO?U)u cD-b0BF.a| {rX&MEK\P]XIb'ZC!l(\@7Km|D16#X4H G//oV++k(d"Ze f q!h>fhYxOwAW'1 *^7KE2 :kFYLq. 2BLOaeRXf\1n~dMFGNMOEA>zNTk>&$+)8/L U`jxj]D7-2? cwdL{Br>iHkPjJ8pw%n6G=_ibnbQ6c ko}>fT/\GX?7@;N]a|sT9/0;C>3*TqGg{r^aDH7*;C(QGOz9' ,BQ[gilm}$c:?7""[ -fXWl 8<<2y$5 8[iq,B^UK!kcquivx _BGS4R/I1?/:>;LTaV!H2)Jatzk/RJ)`y !El"/6.$xk| ,,q f t u&}:{]of`dKF0! P'{Adno]UhGe<b3s.!lWKLa|2F\~jvx~ntpNZ#@+"+9>5  )1IMMA&  8*A"=109E! B\ry nN=(0U)y0987y-^H2% #>>4AsFu~lR/ 1AHcUSJ:1%l%Y1IAEWIjRkbph^hj\mRHHP_wsU-)81>xSiZ|ZbHJ9J&c,@n(5&j3&:N c5tf|a?*!. 9 HP59y4JKiF$A?D<8#*a/0FIP}ZjUWW;L'C2*,%UzqdZMKM"N$[h{dUWl i: %"BF , *@;)i\Y_nunO#~kjqrcxey_[]3I5!.?PT>2 `9jK&2B'g+'7>7~"[H4{@t?k?Y:h1n,#46D?1  ^U\x"Y2-7H Nb3jMvowvfPxAk:V:K<>5;53*'J!Hc~kHN&:-7!C7jAA/" &Np|c(6. 6;>DD Va(S`Y6$-&$hk!h"u w_L50*/4ERarte}S5,'.86 e kUT[klbEw n/sBqMd6T@-5@IUM:dc|azkhP* u@@RI* 7?=% |"xtdK=/;Nl}mZB+y[ LIRq~y_oOhIeTmWphuu|}wnXsKuHsXujqgfZbfb?n+}->^m}z{mvpc,-d`Q:; 6 FFT`p !6;876C\} ;p(/uCKJBR8XMf\}k}  %7ENYxcsz_E=E2b-y3 :<91 7nT6eV!iH=8Kd>]mji^d``P=*|_+fGbx]Y<B7 Ir yYvP@<>ROw`~oduNv3{/2OkzV3wVB=T0;6&]amsL5s;hQlt|wYVWuzvdYOQ`uubRG9, | $.97}8^53)/% :N`d_J6%.<A6' l:Rh9x&{]$^1L3P6H6?.3 ?ryxW4$)Ikwffahswx}jiViDLBj3/$-7;}2t''7Vgy~n_Q,H=BOIW[U{ZOOPUWVZYjs0@VVWUPaq /Pt2C\g|} %%)  #;FULTKQUV]_s%M]~ia`GT'@)*9Sh{tjZ)c>&}|-yA[]`D{'pX9fM=<H^sf7cAq<kG. vdSH=(mC8(%D/P#F')" !"#%49GB|;weipy}qbI,xpa>$ rZN?68BHvQUbFm=CQk~}\2saKMP`^b]v[nTebkbry~{nO7teV QU$`B}_s}gO$sD + ;bEkcTS`vGZaH#9NVZVXi y&?a{M#.W~}~  ,2G\kuzkNou#Je|1/GGMZGq9t,s fR@@<A=2 9Py,CIRMT^_-tzU:.82MHmBsHh(? nloxz~yrqy j1/9 60 3Xo~syojljoj_QA.! #16?8,~wUD9=;93(#().3%srhrlgQn8ZOP\m  lI1 `P9=>EKSF8#~!""{tilm$($ &*# 3b )@W^,^UNkIwFeNP] m;o}hVTm+Lhg]>6,;CYi{}|hS?DHmv~ ]; # %79IIEe'$** B`oralRRCC:+C(Ts%.Ehk`ht $7R[YF5",A[/dNvpBmxU7#4Tnwsx 3Tq|mW%H4/&/;#X(k+x+r=gUfihm^P* 0MdoncS)?C$TA%}joHm.f d$]=XXUn^hk`y;"ukt !/?:5&!%=Qk t"o*c4\1V'UOID>FIJ3E<7D-H)F2>F@KFDS.a hf\J:$9;?SD_UkS_TLP/\*l8Y|_q@l p{8Qwp]`\hsz~j;xxnv$Kx xR+6X{N,S-$ Dk/6?CENL^^v`7N7<MO9  {e?z ~ 'QyRE:A>pAd:R)8&  3@OF[Hh.ba^ZP:&$"L -B{JME#@!00!N qqhgv |  (Pvfgh^\TFZ-[gp"3>U`lipjXc6fl{uhkxsp{e`aCQ3>1*5BEIA2. '8AX[Z@,vz| +#'jP/#5LempcWT KI[eu}vdQ90.?Ggnrcbds}0Hap{w}osgicK]jx~kQm?W48)+$)#0*:0H8BCFPI_TdXiSg:fYPE3 3a\DzZ:/1Dsb^{lnwtS:0NVcQ}@r  +;?7))jJd_Zy[vZldPh1u~&zNfrG)  -H_bfhp 5@D;.#<p ~w%!+1,515= W8h>{; ~omsI{lpR+&Juunt $:@?<57B\rsgjtvh&b.i3k0o(j1g;hRZhP5('(:FRqXhRjLLQ_g#e0T6H092A5M=kFIHC:-'      ";Lfl,ybogR6$)99! e3 4=<6&- 0 82#7026:'# wZ[u !{:wVgmj]rRTF=G8OOZmefU@!j^ WQ7aVgf{i}P|$h_U^$MdJQen VA8E]lun_<! ze]Yabb]NF@@;<w./*@Oce_L8-%o`_dm|jR3~\Ax>_9WNRNYTa7nkYUSUaesioeja|a[ahsnq]qKn,m{(- %7FE4$+ 3\c&Y*S?\Cl[`zrWIC>CD~NWwWtXdQUXQSQ^_]u\OD559JWU[LHIXp}s[JFH`}oR;//6Ibs{G+(Jt $(-4)S` f^]OG@5- 0Ok| ~" zhm,666-~tlUI 4-*)6BOhsxliXQII KS)^7gKlWu_r^}Z|\bmvqcfkxztdYR`r'01"} qto-v>lIk\bdVnBk.i!a[!P7VOWdQoNq?d,ZGB9 E8LT_s``OJy8g9S4CE3DRNVU Z'h//%zqv v_e _o +6j3V.H(Q%L0XAI]Eo2%rfngts { ~eTRPXZgjmyuwosfd~WqKd;j-v.7F[hvtsgPQH`oxkhqglkmf_WU\cr~gJ!2Yuyn[D&)8Ol_]{WZen|vfe.ZJKM a*xBQVag{mY}@f=L6/:DV_%w&+$";NkmaE )$,Ecuwtnroz r saZD802>O`Z_H<-&'"*;::8<<HRVR]Vbf:w#.7LON3  21+ vq)h,t/+!|_<(@JH 3" l}wcdmmbZb\VA#&Jex~u\QJ~V`z8 *&?3=;1<GMi~jfgy BRaYP:94?KQPOB:-$!"&(  %+.C4`+t#rl W@$$&4DbvqK)(]|p}.wBIwLo@f*UGB":B6e;=HNJE;6;V4j<|<r2l(O1  %-=EKI_W`MfMfDfAeJVW@s,+#60E5Y7s5..).1|2h9S14:BTcwlZOMavolVfC_/[%WPH< 4%+3W pi:,AfmzopdkkwyveJ- &94.&zvmwc]ZGM4A2534:=:M1\"lyoS0xh\NI<6- %+CayzoXV>Y[v$=Pgzs^WWesxpU<& w r)WKM|90:ESvi`kDx;h2^1Y7W7p6}7;BKW`defge _\NB7.(#+>B@]RfUf`Nn;mqs|=c~'3BMPSYZ|_u]g]mXu^av)*0*%# '() 2/1H2c1w8CTl~{]I78Bawznp}~zpa^|bo{psnupjh^a_Zgh}"(*xo_V9LgTygyk_WNJLKYMG .!|5nG|KC/ }jPB13&,yjc _^fnv{ ~vljadjq{zyq|~wna^~Ws\`c\eNcRSL?R%TWV^TX.[>NMAG#F=9652" #695)|zmaRL31 wk(j,j.m4y0x.z/y2y9}@DB9x*p]ZBG:45<3A5QARFd[Xfc}\eezlqx}"BWX]STMF8)!".C^ },8GRNXawnvte*_9ODXTci}p]BLt[nnlqs~ 6FH6(w">Uhmj`MHAHSRP8%z(x=Y[]? j_kybOK%87:><:-  n-[B6FF, " 2&>'R)\+Y O<+ & '5J QTC) zoe`aXSLA/'ybUOR^Z\tLfG^=XoMybm~~ufaX Zc m {~)CUhsibIBCTes{ ,cyvqi|zhv\T[n)@GxAo5j"qs phOH+0:7C;MJP[Zefe{aPJEM\mxiQE<*%DWz|lP:!'.ByQhNiMn>2(!$.{DsRsVqYsJsBs7g9];OGNGSCb7p%~yj ]2UKGLBP0V'T`knuj-XCGV-e#ij c*f6hMmU}eqovzti\K;/$& *47-("%#rW??:?>:4(//*;*,3": IB9 xpjrqzx~tpYH*uiSQqAi:h1n$jxvtyx |u+q1k1_/P&H%<.#  .,)seghz=LemmfaXYXYaSO?u3e2`5cIubuwp[WTQ\bkz6Olvzxuuwx| rO(&,:)E'B6& xnxzm|snkkohnlsq}sqwyqhTM=BEJRNRKD74"$#, <=2 %$+#/5IP\SM>1))5>RZnt}{ukmnr/|9~8/}.2D>71/"+#++t:}<.(w=[L@s$  -AnNhhqo}pjaXKA5/)*3;CLX\edmhmYK@6<8700*-.230**#$&3ALNPHC;3/(+516(?#& $.0'%+& .0*# %/3;2.,)06HWzeoumoj\R?2 yd^U^frwjTI=FL Z6gCvOxT|PyEv2n"_[C7 %$!*.,22 <!:4*)|tghcjgo`xVG=;DObWX@/ /FVgdfTG?@GS\\[NH8;B[hxtfc\_XY`n'z3m2_6O"J$IN+Y=hF}bi{ueVR`q|yfYFA<L^r|unYU>PS`ltprmq~ {~|~v'z3vBeARE73"/ $ !+,2'%)'4~=vX}e}xZ}M{6},+%2q1[;C1+= /-@44WBdIxTvVrMgER2NKZedg^XVO[[eow z~zy| }ztnty {ufcTaZfknrog`]ZXVL>5/./214321'+%'%*5BM^eigca_gittx|!=IUTH6- &7F_aeTK?EGVSK8 ~nYSPRXVYNMECCEE=0! "" |la]OJ5#   g^NPYhx }vv t!2;HIKC=5-/21/! 24 =66-, 3;LRakqkn^cal|uy{qjbacagm#q#ja\MG@FO]m} xsd-bG]V\cY`^T^Ib7g2g/h8i5)%#:JW]_a][YSRIA<65/..+5@Kgso[Udvmqv z}x v}$7CJKMJV]dkmjZI9///:;KQ_fy{nhmym%\&A(7"-">!T/t<OY~^a_HR(K'A%8>3=!@" ",,*79&  Db|kRD0/)*0/59NdvwcWYVuwpgguv#%*27?r?gC`>m=;:;EHSXhr30." &-,)  -FaxvgPB>AFNKOXX_fouzuxjs^da`ePmPuKuHtLg=]>R.E5A9-A0F&]#eecP@(  #!  !07GPxTHV9W.X;TTQhOJPUuf`lNxE|>wCnCeG^BaB\9eAeFlQe[df\mUuGfE]:D?3I)P0X>RL\`JlRr?n@]7\;]:h7y-   {zz~{wwtx{xj^XccqrwxstufqYs_tZ|ex\o`[TA_;c+q(|"+*,,u%g`QH<4#,3GZt{}rgXUUWv]fOP;MIT`ecTI%4( $  yaSTWht{reVF>'"!"!*.2'0(- &'4EYcv|wmXC,!  *54.)/8@tAyKpOyLt\dy~tkPNAGQ_qtkj   u[VJ%E.P;\;s6&   28>7/ !+:FR ^X [V$\i%}'%}pbc*i>sMhvz rib[[T`iu '(.265?>JCMHKLDIDGF GB*5512/8:08+F+E!F*?70H!Y` moy.58. z^XSduiXKGIA@+!    !%5CNLME;*'0CLbfqld\PH<872/%!/1?&:,65%86CKT[ef i$g/d?kGsOKJ@EFQYdliid[XO]}anlo~m|tgXUJIGF896=CYhnsgV;  %+)$%( 16880   }kdlo'**/8DNTI}Fy,u%mgVO-DCIUUhetwx~~xxuqt\tKtECHLHB:1+/.?IfjvcR;*!%(6>HK =; -1DYs}xqR='%&<FSX_USJB=975/ !## viUC0'"")/,$wok~ko^^`QQNQHONRLXVP[RgOpPxF|;{/sdS = '  & .AJT\Y!^!T(X#PVMMA3 (2,4#&*!<Rd{%/7L\blm]^Z=9/&wnnsjP*  wwv{}t~{leaY`fqp`I/)''64;D<\@qCV_}thSIEH@E4 0" -&-(,?.I5cAgGoVjZkWlVmUt^tcziyoq~xo&142-'! -#D.[*j9wGVx\XvWG|@2.&%)) .3AGPDNCG<ELN\bbf_b]X^Z[]dks|~xlVLvGkBjKmJsQuP{RsVyVj_kcdsmgojkd_UH;{745;DP]bijuv~v{ptccVPOIOF-B77H*T*Z#g(c)e.e<g3k6j*_&`X`\g m,l3q:u?|9?;9/3-2/;BJLLXV[YYVRNIKRWX\_go{i`abpnx~ui^Y`]mty|unaUVWkq{iv\rJjQeNdcejZz`|d{holeuZwVNID90"68<//% $'(#!%(,( %BOQOECCGQ[c]TJ:2/"60=1E9O<QEVMRVSiL|A5 $7>A83##"$!#:.P8eHeKcMNN?D8B20:/E0P,W5Q4GB;M9_7jBuM~TUFA6y25|COd|ossksVnSwKyWWm{ryw{vsoer[^KGF:?.<7>>8^>h:w2v/w(p)m+i&j(f bYI=.($#'$2.*=6L*V'Z#YPL=3'$ vkxazYsU_]c_duVZWIS4O+J)PIC. % 54 -$ {{ilbkgo``I@,'%%%/7FKQPQI?60*'0)-33>w9n9]3W$ROPOZ$c+f=dA_N]H[DY7[3Z+S(T"Y![&W"T"JL?;:; 92975D-P-\&g'f*f1[0T*U J<1$&&5:#D"C$PZjtoZNJ E"I-R)Z)fnvz"/78:30&r0k7`DVQXhix}vtr'*.7>ELZhoupfbURWR^at %z | #*8CR]xfocp_pTqGr:a5]1K.O/A2F787=8/:)EKZ ^\I@*($"' "|t&rkld\UOMQSRKH>@:742+#wm`_f!n4o@lMWZL\2^*WT"PP#Q$VZZXVQQMRQXZ]icdYQJD@?><=??FCA6/# !(-'#  ",'%yti[RFILYeejmcb TNJBBB8A0=>HU`cgVC,#/21,|%} {'z({:CPOL<6(%$1BNafl|hgkn|}  )2@D(Q)U,o%t! }| y(4DU[b`cdhv )2:36-*/2>@RWfhpmwqzzyzry   #/z1v5v)j+l.g7b<bJ`Oc\g^adZeQZAX4O0T/X,T/U*U0Y4n9v:31! vqdh%e*c/m5o89470,$*-4z8v8t6q4l0r9t?MOQQ~MmEUMMM;R9T0[4^6j:n>tGvLxZr`zgqgqdh^`_[QIPFJ@J?L;N8R;Z6X/`(b,g%h-k/k<`GiV\XdQ[<U6X$TNQ MMA<!?,:7H5G6\/b+f"l]aT!Q"L#KII DCH?; - %,.162 ,$%)(    -=I@>+$&/<>BHIPTQRTWSUV[bgrru}|}umhlsvwuok^b\^b`b f`\ \QNOLNV$U/[-V2W(T%QIFDE"J/R3Q9Q6O6J-F0@#8)5,'  %#*"7),",%$ "&54<=BD@MA D3:/3/:6>7508898 43- &&&-15$27/7,B,7&5-/!!$   &1EMSJ ;*$  +J*a.m4u0e/`-B.4-+/(*.#4(F"E.N,P6N>LHMRJYKTPPQBS@^@]?]=a>YDXFTSUQN[LXFYK^E^DkCsC<8.%rrcfY^!cq"v+&& "       !(%  /E\bZ~Q@3&!"$()(|'z#r%q+l1m@gLha_lV|J~K}IsNhPV[H`=`&c#]XSLC-=D5b+u% q^ G; ,.'0/040>:U^jjeS<*   zvkqholdgejpx{e\MGD::7978@82-%(%"+nZJA<43#& |xvzvtnpzx~~ ,9BFOMZ[mu{z}r|x|zxttojpnpsrtpsvy &6yBqDoXwP~aU`|fxghuWUQYchig]\Z^l}zs rjkb!c!e"ejs} "# !#&)0,6-B-Q%T_^k`n#_(X9I;INGIPU\Xsccc[YPINNYgw}xrcWTNVPPMMRTURKUK NMVba i S P696HJVSV NIE"D&P+_)s#s$qh^S X Ymvi[POW[fllnkmlks~}wx|y~ywz{wlhbgdc^XPPEONSWZsXnW`NaGYCZ@XH`J_S]SWZK\@^8`=eEdHgGh:l4mhc_S]X]_`chqqvkreeYULHIN QQ UVYY^[]\ VPA 1       ').*-&#! $&!" !(#      #' 85@;=EAMEMGNELEK NQW[falnqcZJF;4-/8 8EG'R+W+Z"^c\aS [O#V,L'U!W]^c#a+\4R6H4C/@(AO[ghjm(g(g!`%` ^%ZU#O I"H M Nbjt {"!}z{qdOGC BO Ucfkac \+b)b,f)b#f[I@ *)(+5:@@<696-*$$*=@?:" %-03+.,%,1%&!5 7>9;-% #&.)*#" !  xyrsfcXcaqz}oe\TSOPKB71.0>Lcm~uq[G4$%%.07=BJUar}ogb[]`hp{|yqc^[^fg}nnfg]ZSYOYL^PdNtPUO=7$"&+5=|?kB^I[ATGX=[AbE^H[LRFEBD=97=/>3D/F7C276$2,%$+98>:<2&"*#%wsx~$++-) xtg^XTQRPXVZcfmrzuolifeiqv~|ztqzttykyk}ed[[lVh]OaHl=w:{;A>LQMPDE7}=u>rAe@lCiCnBv?z>34//024:CDG><22-0#3&+205269=<95587849DP#O)X3W0].a+b)s u$(-6425*5;;D@MOSGF<>DKM[bsy{zyt !)03/,  )*69@8B>A<$C E(W,])l9v4|B<AI}FQQ^_inr|{     yun`lhojpr{{z}w}zzvlhea_[T]`bblmtroe\IEDGHGGQ\cqz}{}zuyw{zvqea\]jrrfP LBCMVf%g-p8m2s,g(k$Y ZS!R%J,J:K=FEMBHDL>L>T<UF_CXPbL^UdIjPlMoNqYwXt^|am\vYpZ|SQF97& $! wslpliYWDA17448,+   |{y{rkab \[SVU SG<(   %),)"&%" )'( {xzood_c`h`h]dZ\X\TTOJqEt@i=sA>@HF{OpV\\Q[AY7O6I47B46*@(66)$1+,/11;:?>867-/#"+346::<8?=?:8++ % %+02z-}%zx      #*1 8>MR_*g8t>KM]eehc`WVNTThp|#/**%  '+1/&$ !(/8<>6(($'44DCJHRTV^NJ63'  -+3)-$!      '/%.03;@CC@8764:7>??<:5:={B~KyKUSOA3$"%$')+},z)m&]PJJOP RUWPNHINPa^ndg\UHDFHIFC:2+$+*s4n5_o9o>u3{:s8}EBVWheg_yasbkjdndsaocplanYtJwGyEUV__d]]WTUO]Zmdndhbbgfgmc`WXUUTX]e]c\ZVSZ[Y^TRINDNM UY[([0T7L4H5@$B>> HEMI*O-I.R2N0T8T6S>T9N7M9J8I;K<MDMFKVLZDe:d5i.`$^!_U#]"V#b dc ` VTOP[][bc]W USU&W#^$]#^_ejpnqv y wrjc`[YVRRLKINO^[b[]VWK@=86*& #+11;7EFEE86.'+$"($4-3*-)()$*&%)/27?BEGJFIIPSYWXRSPSQRPROPLOJOD@BALOWaejhf_`RRJEH":#=-4,:+5%;?@B>@B;%E'K3M1K9HECH=M.T6S,\9[@ZNQNPRFRGLFNKQMVNSSQSDV8R/V!Y[i i(x4x8}KuFxPqRjTcEgH`6h4`$qnrnno r oomkmo rqqgcVYQPVTTRSKLAA<1/.&" ~|{z}|z~vz|zxphff`bb__b^dZ`\b^^_b`cbdaZZZ]eivpsfeaZf[gist{xxxrsqxyuxtu{~||rqZb\Y[S[TVWY[\Z[UNLxEr@t9tCvAwDvKN}R[UYP\Yy`n`jdZd^[U\`ZVdRdIdAY@S7E6A6AB+:,?0C-H/G1B6F=DCHLQYZY_\iZgRhVcW[WQbGdCk?u?;1:08448082( tle`aZ\YONHJEIJMIH=7%" !"      ! )$(& &#&  * ,; 7;9<8;;:3 1 / 2( - (24300,,)// //(%   #)10'%#250<:?;<?@=95*!'*,,&! }wz}  '$.2.2.(# #,07:>>61"  #.102.- + *#  !&)&)1,*,..()$-&')*-4 4CEHKMU[[b\TJA9*/0.=;'?&-)+.& )$,)'('"%#(%!('# %)!+#1..$)99H&C'H)I%GC@9 ;5 93 10* * 0 / ; FNV!UYWZU] ` ]_b^ WPED> ? D J O \Z^a^\W PKLLGKNOQ%U)]5\9d?b6Z5Y,O2N4JHFTH_@eEY>XFKFGJ?K;J>KM@X<a6g-k'v!u ")33;65-*-*675+)}w |wrje YZ]a ou }w~lkOPA*N-D5K0A6E+F(B&I$G!J&H)I,@)6+0,"'(%$$ ((!!"""#(* /&#            }~   $#().,1,.0.4.,438,B1L1V1[@`D[T^XMfUpRyU\gls{}~~zujf_\[_h|mvnyu{wokfd_bZPF3(  *)*$#   w q q gkodcUP$P+P0M1E<></E*?;; ADJK SZ\Y\[^ d hrts i^PPI JH@A:=2>> J)P6S5V6M.K+>)4+.+#2/0 /('$ "&299=;>;566+/& } }{~sjkhjoq~~~}~~~{yuuyy{wrnkegfihjmliiplprw|}zpopvzx|xzwzyzxqtz|x|rpkpx  !%*&+)$  '/78?8 : 862.-("'##'! % % $-0 0/3/*)+, +,$.&.$2!8DB KMSUWV[Va[`^Z][]a_hmsy|tjbZ\\\gbnknlkhe^SJH<<;;@=C:<?BL@H67"!#'8;D>J?E@;825&&$&)+1162<38443/,)$,*2/2.)!     !&)(("' % - --,,21 5 >A N OWXXUUUPLAQP Y _j jsutvlnhiichcknriikrsxuyy~}zyx|}zzrytzvxv|t|leqivjvsvyrlqrv o pjon imm_aWPD:7<?EP&S)Y%TOI G>>7 >970-&&%& + /'7#<&56./ *)(*,4 4)#,#%%.$,/12;;7>@@:G6J5L0M-H-J.@6B3;4>.=1G0E3I%C%T,M"TXY]\Z[W\"U!Z Z_^TVSQTIMJH?? 9 4 474//($        " & #&$+(+.+)2%2%@"F%Z!h"n$z"t%n(i*d3b)]3a4f4o7n9s>zAyC><9/(#""}sqt#.262,$ {&"}+-}/y,t*m%l"m!qs{|~!w"t)u:w<xNM~TWyVuYjOeXaQ\QaZ_Zehcg`n\rPxPvG}H}CDBGIEKE|HCMHNFOKONPWQYOQA=3519>KOOVRSP\Yxfl\fb`b^dfffefgeeejdrWwSG{I|CyIzKxLxJn=n?t-w%vvwx|~qoheW\]gah^]RTMH>=5:52*&zujjedc][XY\\dhdmec[XVSRTRX[fnqwxwsnhe^glv{z  !&+1507./'--/,355<< 7B<AABC@@=!>/779C.Q,X*a+],b.a2c2c:cCgAhDpFoIuGwK~@C7;594828<9>>CGID==;=>AGPLUPNL<B;>B@BJHSKQTP_UZPLNHNKMU[][[\_aeglhkopkqt|zyurpkoptx{y}}|vvuuvwy~}wyuzz|rmonrrsmpgbcXUMFFAz:p7j5\-X+R&W$W)]&^!a`]VQ GG?=7.-)&"#((-('&       }}z}~zsvlrqxs}|}}vtsqtuz~{|~}usiheaaempurtsxy~   $,./0@@KORSNMGFEH H H CIJYYfesvzwt ppp"r%q%p'q!i"ndd_mo#}.2x8v6t?j;tCr6u7u.v/m)j)`![#^$b*j-q7y5yA;EFC95<5;00*-33=EGXXUQID>:6632041,44A@A=<880~1/43@8C5577A<Ex<~D}<832|-82{;2z30}43u.u3o.l:m9d3q.e"ss x{vur n!l!h#i$k"f"g"m'f%s&grjkca^``aede]_T R"P+P*U/W6`7X7W3R6N;GDGIEJBJCQ<W:T:U-S4X,^@h5f7i/g0d0i0n2t+}2z!|x|}}xzenac`YZ_^eba[ \ VVV UU NJD >483$7389867"5 5!5.-%()-(,(&&$&&+"*$3-1-0,*', !#%##         $#     !#"'$!+&0,')$%%)178>951(%"!',-1221.-03/1/+)%!               " ,(' " %0)1 ,/1-538=: =: < :3 =:E AI KQSTXNNNOPJOD?40'$ $! &% ' * (.-.')%(##"&&'"0/!11,'(# /#5$9":&>!C FEIIJQMOLPKO!O"X-[5e5j<r3x4z2~,2&})&~''z!~}w | }%~u)|'w)*,~.}5u3p5d3Z+T(M"N$KE!HE> @'7)=35673*;.1%:'44"32320)*".$'!-$#&& $ ' !',)0'"   "& +'!'",-%3"<.G.H5J0P6F+A/;'8+;*7*@4H8L@V>UB[?]@cJeHfGhLjJpKlMpJkOoUu[t[~h~frnupqinfdeedcaalsz~|zx|x~yvxqunsmvv|{xond__]}]Y}ay^~e{b{jwhqrrrlxqsnrpmkkoofehbc\aW_R^QfIiGmJnElLlKfPkOhOdMeDe@f<k5k-i*n'c#h(g'p(|+'-&&% !w|}} { xuruknmhieeokmj^[RSIH @C C=42 %!(&$ y}w|lnbjhgmedZcb_^[WWW^Yicnkpgrpqrrvortrxuy        )%+&-/+(+'*-8<=@GM UU `]ef&hf)`"]']-_*W,]2^/]8c2b;l5i:l;qEmJoTpTr]jTn\pJlTgQcY^]_k]o^u^vc~cxdxjxozommkos|zz~uj~p~lwqxtw|u{{~}~}vzosproqppprotlrlwqpljoklinlnjkklhf_a`fiomwtyvwtwr{r{~|qihgnius}z~vwpqiljiihn_i]hW`L]HL;G7@0>1A,C0H5F.J1D,C,C*A&H&F"JKE!I!>?88>8D>D AC>:9<7911/))$2+0,).!(           !            %%+%&(&"! $'( 1--%)&#   !  #!   }|~{z~   & )158? 9 :8 8:9=B E MG LCLJNEIKVT[Wb` l jror nkn j ndnemllkkhkloqvqwoslmlbd\\Y[`cfgjfe_\Z_ZZS UTME=< ;:@AJBE = 89 6<8A7:7 0 4 - 85 <=<:?53/218::<;:87598=8:7448 6;<BIGFFDKHJMS J$K+I4B.F0<*A';!>';#:(4%4'/+1*.+2)'.,1#46#97!4;#8$:4:C?EGJHDG"G%IIEIKKKH F@AB@?:;<F @IJMYN%X%P$V%R$WKOILQPH!L I"F$MIPMSTRRNKKJNQOWR[_^_dbb d b b __ Y _ Z [ ^^d c j d b ] ] Y[XX[]_^Z][]dbd\_VTP PP [^a^a\_ ^ ^ ^ c g f a a ^ Z]_ccf]h`dfcf e cg b af gghc k b b ^YXRR^Y]_`bc_ aX^[]a[e["a\%W#[ S$Y__^b[a!_]\VONGH!C F(C'G2G*N+I(N%J)U$V#S'T#N+J'<.>+4454.737080947/73;*7/?-A)?(>6#@9;<A>><E8?1 < 3 7/6 22 6:6:9 822,,")      !     &%" " # $                                             "  ! %#0(+%!' &$$ &%-*!(%&#$"&#*(..-0.2)-02),)+%.*&).)*-2)5,7!5):8!=>$B!AG!HPMOJRLKHLKT VY \d b mci ngpmqkmfkmkiibnmmmllqvtqhjaaWUKMWPT VX] `d_`VUZXW PTSSKK@?&A ?,C,=-<'9%7$9&9#4&0)-,'/,6.2+;,9%=&J/J(U,['Z*[)X)S(U&T,S.]2\1\)[%]U%V"Q[Z[]W]U [V X]Z`_\cX_[[a T\NSOQOPY \%_(\/Y-a/\%a&`$[)_(U&T"HD;F$>$J'K,Q&R/X+V0Z(U,\)Z0X0Z2V4Z3Q7Q9I8H3C/D.G1O4K0S.L0Q(Q-N%O&J#M)L-H/D-<0;*4-7#;,;(A0B/E5H1D2I4F-F1G&E0A.D*>,C)A!I#LLNPPPRNLIHJGJJMFHEB C GFMJKLCH@ AAADHNHD?C?=<9530 23 /-+0//418 +. !( $!"((#&!$ $&+-0 ,/'/++06>>;><;=9B>HBJELFHDBEHDIPKNLLJHIGA<76;@>9877>;7?47020-*/)-/)0-7(3&1-+(' %$"!'""$!%"&+2/1/')($'"&''"&$!)!        %#'#' "!%''$,+406CAMLPRUTSQRTOPPUWVXVVNRNQOURVWRU U V V XZ\ZZW]W^^^b^`^^^_]ZPQE NFB @ CEGJKTISFMHDEAA>@9;27/-1/-)'+*-&%""                 }y}~z{|z}~~{}w|s{yzuqqontrs}u~|~~{|uvsu{~~||           ! # ! $!# *&#$%"'             $'-+***+&'-),+(/,1; 7 D <I IH@IAEFG#BD> >!>&D%?'C*A&A1D3F5F=L7GEKDGLGJGOGO=WFWD[EaJ`AbJdJiIcKgKaMmLiMvQwSTzSyK|NxKzLsGtFtM|SN~UPYUZZ[X]]`edaZ_```[WZTYY\Y`b^XURTSNOMNLMMLJMNK{RL|OINE~Dz>z<u<u:p;r>n=s;q?w=pByDmHvFkKmFcH`D`BVAXBQGU>Q;T7W>U@WASCXLS@VIUIVMRLYJQCPKKBIIHGHFAJCI;N=L;O?J@PITLOPQNKSMLNFJEK;LCI8I8D6K:FAP>RDWC\GdCdIi=bHi;gGp:cHh8fAe=k@eCd>_BY=XKZFWP_FWL]A`IiDfAf@c@b@dDfGhG`RkUfZk]b^d`Z`[iT`]dS[[]XWYVYTXT_VY^\[QfUeQgS_HbE\@Z<[AWA`HXH^KVO^O]L[FZGZC^E\D^B`C^@_?_>X>W8R6P:H8F:C7B:D5D-C)@,C$=09(500(4.+,%+.')-+.,($ $ !                "& !'*,(&!'#$!$$**. 176<7793 54#7$:'6%=);,>,@&<D"?C=9<58!/ 4%56!5;5;!4!5#,!.*)!&',%'&&#$!#   #%&" ' #$!###                                 "''''( %(& '*'+%'  #'0.5531/&-)219802 ).-3-67= 852 60<79;9 :==:< ; FDA:;?9999@B>:576:>ACH!@'G"B%>">'; <#8$:$:(9#;#>D9C<B@C C'@#<#7;9=@BCHJOOORNQKNJGIGIEKNNONGMEIDGFF>C@@;7>D>BHCEED=:2 8#7+6(925(8.8&:)6(4,6.3*50,//2,.,,/)))-.'.')%',2-21224;154<757A:=9A?<9DF>FGGAKBCBD;?@>GIFAOGIBMLKANLP>MAP@U>SBV?P?V?SDVITGUL\NUQ[K]M^K^I]IbNbRcRfTgVhZgXk`fb`c\^YZZ`]]]e[`]eWb\dWc]bSfVdTaSaVeQfOjMlFlLvGxMwJrGrFuH|G|G~BBC~:|?8|8z9v7u:w<v9y<x3}4{.~0}/z+|-{,~4,|,/{41w1v0u*o,u/u0.}.'z/"v.{"w+}(z$z'{#*~#y$wl&t!j%s%o&g%m'i nnijgqgh`hbn)l(k*l*b)a*Z-b'Y([&V.]'\.Z)_/W'Y.Q-W1R,V)M&U+O3N1H7G2<6>;B::<?<69:686?484<356<785:<09+:'9!=$= F$?!D&?!@D@B:7,-%*' & )' . 0 -4 /6 12,('&#                                                                           %!#"$# %(),),*"/%13301.6300:6;78:772-*,155962/763555437428/0+///-."/+%.$#"$$! &-$$$30#35$0!4$0"4"1"3 2%3!. 4:6<<@<>A<@;:5@BADDAH @D AC#FC'EA%>7 <#>"<"=&;":%9 3#1$0",'6 0-6&.,2"2'2!4101(/-,,,.-./,1(.,, '$ $!$# $)'%&$"##!%##&"!"' ( 1 .52 , 2' 1 340*/--&-(0/93:3848-4*11.2./01247:= 9< 78 1 93 ;340 6 39 =;9:76#3"3+7#1&5,1+205,159116:147>5BBF:FHGAAP=G:Q8I:L=G2J:I6K?E?OAIBXKQI]EZD]=bB_>a?^;cB_>]@XAYBX?N?Q8NCWFWJ\IVDZFY@_FVA\CS?[@N?VJNEVIN9U:O<R:U=Q9Q=MALAI@I>J<M;F>RBKIK<G7E1K4D<F;@?C:<;<8<6<47=9::@:79@;<:;<C6:<>4<5:15-5,5/<*:(1'<%<$@ 7"8%0#7-&3%2&)&3")&-$.-/0/,/ 02-)!$!"' !"$!$$"%"#""%'"/&-&++(/(-((/0. 5, 3. 6- 5-4- 2-1)1%*( ,& - * &()+ $, ) )&&"! &!*%%"!                       "!                   !  !   !&--+&& -+-',,'-.-2) 7 1586=6><B; A:H:CFE J H L EH EJFJKKPRLF IBIIKLX][XS V PUSQNUM TNLKLKJNLMPFLCD;B9=8<9>4B::5 /**03-.%4(,*3*/(,))(!)$* +%&%,)"(0%.'0#1%-3"0 3&7(1(.).&,!/%33#5354,#3!'!+%"/#.*,%-*'%&)",'+*&#&!! $!%                                                                     '( "# "()$# $!#""$#" %&(#'&(#& $$'% "'' )( ,')*&/(,+000,0*2/0,,-0,4(.&+(00/1-3&+$"$  %  !  !              "!'"*#$ &'+(.+)&+!'+"*&"!($%(#)'+%*+,$.)0+4%7)9#9)6&4'4.1./-+.,(--'0(-%-&1,-/03)5,1,.-)2+2.4,/&/(.)*%,$+ -#+!, -".(,*,*-1+0-,03*(/..%*#*!&)&'"+%)&)$)!*$((&("%!$"!!#       $           ') #$'#)'2(2/52/(,&1 , 50239 6 9=< A: F@ D?>8 = 8 @:?8>=B@$C>!@;D$:<$82#4 1".'-(/-+5261614/8171@1=.?->,<*?)?)B*B(>,G*<*B#?&@!B(>"C#C$E+J)B*G'@*C%E?'<!<"5'<$8(7$9%;%<&@*A)A+@#=(:&:);(;/@/;3A9;3<=:94=3</?5?2=47693;;44:<6886;8A;>>I>=:J;H<R?O=P:N6R:M7O@M<G9I>C=CAC?C?I>G>M5O:M2Q6H.I4G2K6F5L6F/I/F0J3J5M6N5M6M2J/M-G*H+G(E+I-I&H&I(F&J%I.G'?*C B>>:::56388:5886>55.'*'*+*+#.++*(*%% $                          !   !$! ( &( &&)')( ,+,+**,,-&,$ +%,, /,,)'$%")%('$ !$#"!#!$'&           - (''" (/3549 7 66/64 47?BD=@ >F < =7 B ??B@@A@C @@ ;>CB>94600 ' ! $ '' *" (#' %!$$                                  % &)%)$#"'#-!$) +*)-/25?9;;<8>3835,4/6+/ 00 70 76<7 < 0 :/1 5, 1(+.//++ ,, /1/*+-)+%*.3--+&)&*,()0!' &&*'"$,(!$+$$&(%'#()!('$$%,"'"+#)'' "!$   #!$!#"'&!"""%#""!"###"                                " "!" !'"( " %&##%&&##$"&!#&+"%+,'+).&/%/&4.0)424+/36009653:74675295<6?8>7E?B8C<@:C8AD@8?C==9D8F<J>ICHEJJ@EJKBEGHEIGJIKHGHCGDFAK?N?O9O=S>P>NBO;P?K=K;OEO?L=N?J7O;M8O9N6U6O0U1O5R0L4J0I:H8M9Q:K7M4O8M2O4J+M&I#N)K2G-H3B+C)=+@)=)=&8$8";'3(8'1)4)6'3)."0$+"0.$2"-+.%.)1(,)/&+%+%)%-&,$()+'%)$) '!'#$ ! "!' ( %                              #                                                       ! $'')(&'+050 1(*+/+2*.1,0)/*3,++,2''), ,. +).,,0++.(2*/%) ' 0 0 ,-/&'(&)&',/,-(-(,''&&+*'*&!)&+!&&. )($$ #+ "$!!!+('-/!516266.418/53::;68:6<;9 273= 63&1/"14 12//403/02-1-,#(#$                            #$ $("&(2#+%/#)"+'**,*)))&%)%'+,-'2&+*3(.-6+9-6-9120:4658;526762647,435,826.:1<+81;+746+4.9+6+3&2*0*6.8)4.8)8+3#4/.)-2++#1(0&.)))/(&%,&"&#* $#" %%" ##  # $                                                                                                           !* (  !#(!(&) #&!&$'&!!!%'''!## # !! #"'!%"$"% %$!      !"""('%+%+&(%&$*&,#))'&)$+%&&(&'& $&$$*"#)!% )$ (#" )%"$)((&%!%!&#!&$"!'"$'%!$!$'!!&!('/(****&&%!#"!"""   !      # " % % *)(!"               " &$&$(%-&/$)'++--(-$-$*#+%-*/0 / 0* *) +0 (/') &'.)0*-%&'#%%'%'#"!                                                                      " " #" #$%#"&#$$*&)$"(%"($)#'$!%!&# #!#%"*$!$,& %"" #$%%!$' # ""&!& &&%"' %!#"%&)&&)('$%&%&!((#$(%&$"'#!$! "&!") (#"&!#%%$*( ,+$,$.$'&($*&+*++('"$'"&$%#$ # (##$ " "                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         ! &"%"#!"$""!# ##""##$!$!!"#$" !"##$ "$##%$"!#! $"""$#!# #   $ !#"!"!!!"%" "! ##                                                                          ! !!" "#  """!                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              LISTBINFOINAM Bass Drum 1IARTfreewavesamples.comICRD2015id3 ZID3@O  zg@TPE1freewavesamples.comTDRC2015TIT2 Bass Drum 1java-design-patterns-1.16.0/event-queue/etc/Closed-Hi-Hat-1.aif000066400000000000000000000313621312550536300237530ustar00rootroot00000000000000FORM2AIFFCOMM @DSSND2|uepX +?< X / 5[Y~uWN "b^ϯ!dQgl{޴×X'( A&'KL;lg_^λ!~}=:.4U_eP}/q<9UE8a֫RA*Tk|L 7G+bq H uQkkPj絅 "w^Wi=" 0tws08IH-XFYؠv,,%+44'B=Y㬞,RBj Rc:r:zGȶ4*C]jL8aS   \/F>DL34% z LTER7 N0 BHM))m3uұ&:! do F^L%Dab49-~֠'r><h dv<,*8kȷT.: x 3Yy5%ѝ>`DDtӕZ FfͣI%CG .>* 6Y o^wfxD c瞷cMirא{_E'Ѡ!2A- G3/ޱoL$0pzQڃHl ;%n !HYWi;Ѳ)(#:q46'RI5`T'Na*vO{Y -%ENA&8vJ!}1hEC4(5x)#!mv$n(aџ66Lx3- 8Y\=":֌ h  (uܰ*5:2ſ@,0W]ܳ<id@~6e%kr()V S& 4 Yj&JlX#-JAǒۦ5#3#?iZĬ,"YV  !T Qԥ 5[g1:'Ry46R-2w"\*6L )Dj[![> )|ʂ:& +'18%1 +Q 1& - 6 Tܗ] U3eY| ~ #-f +J#j៼?%5ű-C>2'%dn2CQ PJJl,ZQ $< C(ÖGwJخ8#G9i 51H-VD-*Ѵ37'M49*Q A _;gAjf E ֦(L/pR*oB``I]6;Y |HTW -| 34+S1;kӆF"f5 %HNy@:BXت˖]BcYYHI[ 'HGhDb.  &ou9V'n:<(&/#@-c,XtI <43DEP E/3y`"uEhl;BN̪L&VRUw gwUa#|ئٳ<748"p)b'ا&)32 >=.m OH7 T"_1s7*{>B6׾4 y SX48ow.Js97+_ m l . v`v (,4%&65ۭ R<Ԃ.37VŨ)4 1 :]*u!܊6)9%0p j&_@4} d3/͛>EÉ6J+KA"G5('U2 !,5ϭΏa"3)/!Aے &!Tk㬠H[VP0#3CU3!Zx Ah |8޹һ %+jƽ -%. !)ԩ1h=-#X v-+&bD,@CΏ'V*$ހߘ(A$d 2 y uol=6b PI ߔ=GЕ1C4̝,R5;։$ "?8j`l݀/ all 4^h:fRS ! ݜ"$h#I m >4 ZC = s#?Dd "nuRk Y X Z 5E ()9ͯø68c̢)B uuG+RB3tXVR,-^ A"'٫b  t !.<L* $Q g  =+^7م*++nL E{| :\ s V&a$܎!%V uxF4O "E q =J,8ƚ6k/x< #~m:->҆C;{T sxR 0@  Q rJ1!]#"*J+;Ňj0,zϑ\,"v/"%%  ip N10H۪0%<;5ʹnZ 0,0$ <%a` s\8e ^ 6(7ѿ:5oО`# eH̉%I4 %tDqa = se^jd@3 1"jp<  w o Gna<  )'NG3UQ  n[ _k r_!8)v[2 JHsT c A(:2s?|ԋ - P{W -u L6=IWao ]? od7f I!xm(+Z9;A $_d mz L  ZQ~W\<5 \qd=c(Cц%#CX K~MqL5 0u;2H 'lO P#\] ;b_@o Rx tSVbKS,%(PԚ 8C 4@ Z) T9@ejpbqbv, [cQ  (G 5 tU Z LA^_Q$b_ \ O M4. do P M5v^ O5  Cg$N~ 9Rz_0I'7 *92 z q?_F7 bR wGa &$a]Qi{jSDrn"vD/pD2A&'02G:>U6F 1K 2r a4x < wbn\|7;{ ! Q rk`y{EuPvCm  ^  U= ,  \ L GV R j ]6B QQybbA?@l 3< dexk7 d%OY<* 6Uv Ak[ x3i`pL|*zW}  R5HF ]>SlN *? w  ~ w1i  QgkVW; i# G4`|>  9fO`X1c Y|5c$daV jd bk706[.}cH - )95 i?G bc;0 _ET5  [sWz;&|qm@ Xw;h% '2X nR 4 9d C 1UdK3k P,++ P7:v (NT6 u G?{T^ K Hi d &[<>UUR 1 u5fV sb {Q\6BL %o#  :8CuKmfE=H9S!x#  x+N3pbJ V i a d,(P   BX:z   &#}'ZJUL4hel`7$vvsp][MN=(I]F .\.B rX qD9aau q XviIpsP=IqL-?L0[ gM n}>l (#&&w[!CAV0aEh!9rxmH-qJpm0wak@ sq^8&< K08ApdLVdk9pU\m3 Ub:fK3?c /G@ c5\}nYwo8Lr\uvn-RV;qi B46-ccVKUb&zSCR88q'W9\%9V*ztN\YoKD} +ZzA` *m_ vSLBW  ?gH XcaWgCGR21^N$_XYA',|=xg>)i( QA.aZ bDtptxb`RmK7|,OO0N Mr[(h#x{4-r-bfSUn>@0B?{$ZqRSRu5%nbc5UJo2UnEhN^fUs?L|5u-D&fTs5)@=r) ;JfM;f>G*j$0q=]T=|M9>Scc2 GEo$` LsKO8]\! _y3Z2:[Y320G25Y>@C|-/Vm C@Ahi9+^{D!!?<'iXe}Q XPz^CE0bgpsQ$ # Sk \e"]) !9<-941$.~L[fse\Ff}Cb]`mj%%q-Ku[.ngc> }9'}avpUBpmFsPD\fgkwm6F,,S`zr8qeyoJ@RA 4;#q|w|_E6g63)JL{adI}: sylqTSimezgw]pov}i{y}yppznyvz}{java-design-patterns-1.16.0/event-queue/etc/Closed-Hi-Hat-1.wav000066400000000000000000000313501312550536300240060ustar00rootroot00000000000000RIFF2WAVEfmt Ddata2|uepX +?< X /  5[Y~uWN  "b^ίϕ!dQlg{޷ôX' (A&'KL;lg_^ػ~!}=:.4U_Pe}/́q9_E'!A2- G¤3/ޗoL0$pzQڑHl ¤;%n !HWY;i()#q:64'IR`5TӠ'aN*v{OY -%EN&Av8J!}h1CE4(5x)ϟ#m!vn$a(ӟ66xL3- 8Y\=:" h  (u*:52@,0]Wڳid~@6e̵%kr(V) S & 4 Ϩ YjJ&lX#-JAǦ5#3#i?Z,Y"V !T QߥԻ 5[g1:'Ry64RŔ-w2\"6*L) Dj[![>  )|Ȃʫ:& +'18%1 +Q 1&- 6 T ]U e3Y| ~ #-f J+#ԓjᙼ?5%Ũ->C寙2%'dnC2Q PJJΦl,ZܟQ$ < C(ԖwGJ8#G٣9i5 1-HVD-*̴73M'49*Q A_ ;gAjfE L(p/R*oB``I]6;Y |HTW- | 34+ߧS1;kF"f5 %HNy@B:X˪B]cYYHʣI[' HhGDbޫ. o&u9Vn':<Ƕ(&/ޑ@#c-,XtI <4Ձ3EDP /E3yܒ`u"EhlB;NL&VRюUw gwUa#|س7<84p")b'&)3 2>=.m OH7 T_"1s*7{>6BѾ4 y SX48o.wJs79+_ ml . v `v׉( ,4%6&5 R<.3V7Ź)֑4 1 : ]*u!69)%ۚ0p j&_@4}޵ d3/͂>EEɁJ6+KA"GޜR 5Ӕ('U2 !ҕ,5Ϗ·a3")/A!ۍ &!̪TkH[VP#03CU3!Zx Ah |8޻Ҋ %j+ Ʒ-% .!)h1=̎-#Xv -ܢ+b&D,@C׏V'$*ޘA($d 2y  uol=6b P I =C14ܝR,5;ى $?"8j`lݬ/ all 4^h:fRS ! "$h#I m >4 ZC=  sՆ#?Dd "nuRk Y XZ 5E )(9͸68cƢB) uuG+RB3tXVR,-^ A"'b  t .!<L*$ Q g =^+7݅٪*++nL E{| :\ sV &a$!%Vݟ uxF4O "E q =J8,͚k6/x< ށ~#m-:>C;{T sxR0 @ Q r J1]!#"*J+;j0z,\܃,"v/"%% ip N1H0%0<;5nZ0 ,0$< %a`s \8e ^ 6(7Ū:o5` # eHI% 4t%Dqa=  se^jd@3 1"jp< w oG na< ) 'NG3UQ  n[ _k r_8!)v[2 JHsT cA (:s2|?Ӌ -P {W -uL 6=IWao ]? od7fI !xm+(ZÎ9;A $_dm z L  ZQ~W\<5  \qd=cC(ֆ%#C۾X K~MqL50 u;2H 'lOP #\]; b_@oR x tSVbKS,%(PϚ 8C 4@ Z) T9@ejpbqbv,[ cQ  (G 5 tU<Xy7 K#|{7 tEpZ<^Ye! oC p e qh% )x{XTx9 o!x\(F ~%G "k8n 1 nPRYmOBaqi f5W } spj '1' 'f $cs6&_>Z LA^_Q$b_\ O M4.d o PM 5v^ O5  Cg$N~ 9 Rz_0I'7 *92 z q?_F7b R wGa& $a]Qi{jSDrn"vD/pD2A&'02G:>U6F 1K 2 ra 4x < wbn\|7;{ ! Qr k`y{EuPvCm ^  U= , \  L GV Rj ] 6B QQybbA?@l3 < dexk7 d%OY<*6 Uv Ak[ x3i`pL|*zW} R5HF ]>SlN *?w   ~ w1i QgkVW; i# G4`|>  9 fO`X1c Y|5c$daVj d bk706[.}cH - )95i ?Gb c;0_ ET5 [sWz;&|qm@X w;h%' 2X nR 49 dC  1UdK3k P,++ P 7:v (NT6u G?{T^K  Hid & [<>UUR 1  u5fVs b {Q\6BL %o# : 8CuKmfE=H9S!x#  x+N3pbJV ia d,(P  B X:z   &#}'ZJUL4hel`7$vvsp][MN=(I]F. \.B rX qD9aau qX viIpsP=IqL-?L0[ gM n}>l (#&&w[!CAV0aEh!9rxmH-qJpm0wak@ sq^8&< K08ApdLVdk9pU\m3 Ub:fK3?c /G@ c5\}nYwo8Lr\uvn-RV;qi B46-ccVKUb&zSCR88q'W9\%9V*ztN\YoKD} +ZzA` *m_ vSLBW ?gH XcaWgCGR21^N$_XYA',|=xg>)i( QA.aZ bDtptxb`RmK7|,OO0N Mr[(h#x{4-r-bfSUn>@0B?{$ZqRSRu5%nbc5UJo2UnEhN^fUs?L|5u-D&fTs5)@=r) ;JfM;f>G*j$0q=]T=|M9>Scc2 GEo$` LsKO8]\! _y3Z2:[Y320G25Y>@C|-/Vm C@Ahi9+^{D!!?<'iXe}Q XPz^CE0bgpsQ$ # Sk \e"]) !9<-941$.~L[fse\Ff}Cb]`mj%%q-Ku[.ngc> }9'}avpUBpmFsPD\fgkwm6F,,S`zr8qeyoJ@RA 4;#q|w|_E6g63)JL{adI}: sylqTSimezgw]pov}i{y}yppznyvz}{java-design-patterns-1.16.0/event-queue/etc/event-queue.urm.puml000066400000000000000000000012011312550536300246040ustar00rootroot00000000000000@startuml package com.iluwatar.event.queue { class App { + App() + getAudioStream(filePath : String) : AudioInputStream {static} + main(args : String[]) {static} } class Audio { - MAX_PENDING : int {static} - headIndex : int {static} - pendingAudio : PlayMessage[] {static} - tailIndex : int {static} - updateThread : Thread {static} + Audio() + init() {static} + playSound(stream : AudioInputStream, volume : float) {static} + stopService() {static} + update() {static} } class PlayMessage { ~ stream : AudioInputStream ~ volume : float + PlayMessage() } } @endumljava-design-patterns-1.16.0/event-queue/etc/model.png000066400000000000000000000415021312550536300224560ustar00rootroot00000000000000PNG  IHDRb6MiC IDATx}mGѠG$vF;YY (Q f'p'!ƙ܀M<%xG9hc+Q~1L.g4 lGUUVu>ϣGW}TwW~SoU3Y @/L^wN@< >t-",?Ae0:@&A0I' E$I"d $F2 dgl}JLϫj\2!0N@&`2y~{Jw5J 쐐I' ^ Mͣ7+;ۻ'r6DSB&`L2`26s$¶Yf ) e|0MjV;[B&`L,+T&IC0ћTh-]9uнtJ&NNؕXHB&`L*X&]uO ٲ\ (h{{܊]uD` B&`LٚLȒ5Bukcq1twIJ+S5YI' R_JSTQ?B{2B!߉_??٧EIdY#2 xT&ǤUfbwVI' \śx%iM+{OП7>c7ټfҽ#m1be2/&( I]2 d1?vsϿ߾rמcszҚ$Vf/&$ʷAbyZL8l~ܾF\ϗ|fΧ}k}Yo5dg2%!0N@&/==umo {=8s@|Fro6YEҵCB&`L6ɍ|C7Տ?}أbcg|KOeIy'!<]2 da -|7ݾuϾow+R].okZ/>Gx!mB&`L6+_{ox~'1q2 QL8(B&`L`!0N@&A0I' E$I"d $F2 dq2s>36nO @$B&I'#s5TQڰ{%zڛ՚/O弬ɱqG>RZLlnx]Śl͜ފT.Cv;|Z9S&eJI'"I\&Sq&# TУd2s۳ݹz%ӗ;_s+wԞ=< ɔ2VںenIQ"KI'"Ii]Ѡvܲ!0N C&;kMf=ۑigMyn5L9;)-&eL81$=yMVI]&mJ%Hk:M/SVyFKO5u?3F ,NW=o?S(%@$Ʌg5޲P&^74¬CLNˁܧQ'ˁ<\Bmft ]+O$ÑI.[!d $( 2~wM(N 7A>I"d8HB&A4!,7A2 dLuI`U .d@&!r$I,eP`y ҄L@`ٴLdz {n ҄LUpoV&d9唐 ɤnP^x)_|WP,EG垭włI#, FhiWR93Og\8{i!9aB˭7wŷ~I!GrA$|X?+lIɲ?UDs>&Zrz'vwoNؕXE|@p LLX&]mڅݲ\ (x$dWFqD9ƒi5Y9B8/0wo2pi}wbb~d߈?Fsw>}E d1hLX5P#"aUWS[Dҕ PfYɜ2Lni[ѕoQ[ ^;ϐ@[Rn/[zN얐IɌqb)HJN|׃6s>sqtm ^$\k1V&#&5ip/f3;m$tP d2N2eҸH~s?lc2[B&YD&3tU@ ؍&f/ɼb:;!D&n%6ceꉳYU,[3.ҤkQ^8=$ԪWR͹^&}gnE'$n6O=T+c&2bT2YLt3"$-c`z~'dbA 3R& uboƧTQu![3>p-ɑH$ne22gI1 5[B&Y@&AL^YUO=N?`̈~+#53edܔɼ? $-Td dZɷ7OeRӌgՑw[D"J e+Lʸce͜@&{K$ $8HVIJSCӞ<+; *-i,juY!<` d*2\NjbcS ȤJ& ;0\} H$ $8H*rdП۶]afK \Y~,珼=T)YTJلLڢ \&! XICW^,ڑ_8w:͗񥿾.ڔ* aS֐āRoN!Kb} xl0 d1$ē>o]Fvj?XůvO 3BH[Ii65K%eZEճ5i^rm65eeβ0*\&{H'dkl@&! 8LB&Y I&oz۷|տ_??٧Ep|kI.I՜n \#;y$YWɷS=Y7I@UB&Y I&?zu_W߼X~8v[HVbߤũՂr TV-en TNj>6 VҵR$-W|4MM^쉀C"dŐdR[{L?_>~n|ʹ^{};֤ dͦ斓zC)D6Ժ[Wl.c ȤB֬L(`? d1$Ӈlv7^^J;ھFV8z//Tx=8s@|JI>DLsMt6IM\ɿl5@zod4AWO͒ba˅Ltp3IgNkۦL;nX[v74rLL n|馯~lٿx{x\;s_U|JF$xJeA*ܮ|xBu?*M2&ߤi_2d4/)S&;כGt4<59fB&Y L&Rnߺg7;s@b Ev23B}i@I b~}zq/ O#eRe8s0f'ۛ9!X<ːɢ"ddrf_?z_tͤ#-6sgۛ'Y)2v9F΀$2b2<-^q3C(fiP7J_d7ɘh,!I4Hz*2&0{ Uչ(|rp}ۛpG~18E9t$#dd$%PՐ,pDn+sv}DYU<98.B&Y@&Ay2q$! XI ҄L@I$&d8HB&A4!,7} ۓ-֗IHS d1TL Ȥ)`ۄLL)LētE t/XoQkoVkymlg}JgwoJjuN`&$bVXv+'[H?pɞI@UB&YV&-ٜI0{: TУdR.ߞjTtںkܧru^Tsd]+m2 ɤ(%{|;IdʄLL&wD߲eLp T3k_׬(dX&4J&/aV)<(RB&YY&Zɷ7O$I˗u]04$ ddrȄLf7yN&29M&N.LZef]I2!, YE&$c/Z)27I";iI2!, ټLYLd>d9_SN&HWi6.K -f6 ddN$ pL`iB&Yuqc2 Q@&9 nI,K$ pL`iB&Y nd},mN$ $8H6 CHm22 MʤDg22 =JV0jϥ%P^UlIÕ=GnC+`v؀L*L}Xw^ԫʀ2ɢqޞMfk nJ&S-][:6Do2^ef d1,L&M݆L:AF{"Ja4AWO͒bA"urӱʕsSNkݾ2+_PeTNYgɮ xtYveFE$: -dGh*#M|Oq1> N?lis"kj{g.aIWrToRuo/v^ZBRmi}?V[aL;ֻ"+]n\UWW%dEf8P%+_%5[p9X;;W ٣{{GMKf4f[^??SSѦq\]6#I@m}(#;2MN,Y%݌Gd7):FZ*]2)+*fĘܶvi&Lkd*츓{*>ŔN)[3ᰣU}Vqd$E օ;JcoRǣ5Iy8(290tMncV;L>T;B7|4c#lMyeޚC9`t\N&>b؀LHE2AL>baR(mr 0g3٪ XȤ1 TL6lM05f59T[}o~XD$qMne.]&wpN"d\"G+|b r2yܣ{Oߵō/n3NzkLɰL5 # XB&AϜyQM#o;H=6'7){17 vKȤK$8HVy! _^ Gb_8 tWV2 t{`5I ڑ5)ڔ X+*쒐 J z-]t׎ nluϯL9]єe +7@,'ښ8fd28HB&A4G+7p+7AL.~˿^AnY`LQ*np G6 B BgrdR͙5a|Vm^5I@UL*kJ,:ӥLMNAǾ'] '3Ř6LӶphL\-1_bd&68˄HfqÙu$ޤ79/Jź\;j㬛 PMPS4wBAT$]IB5=ۙj$F*,i/{:IW',+ˤ|ey䡓Va0ҔLc#+U|W^^VgYasWҨ~UD|RJ&pb3{iXiɄ'qgk}Sktө{KWvNHeo[}OMp^($:qMZ?4IhV /sIlf)5s<ͮQg-=#\-HRE#$Ďl5:.{%*K=tļy:s=PT9|בKGr,W4*z.k!IkTQ7nc`^(g}-Kjd! [!(7pd^+jc։12IS:6"cU3XiJ&ILDbQemMd\kio5ewBk5.7nw9ui _{)}*[ņٲq:¶{j -VQS3; +'A!D'o%8夭9:<J_M}܁aGmVc7&!@&y!Fs)g'G3be$.s1rV G:GaO͹QsH%dEtUx.CtǸn3gcW 5@l.zo0r#]֤{C8^ @dLAؖI"x41Z tm &%dEq#b/}<=kͽ79Yx%dEg2ily4pOIaϚȁ ,<MI2ɢ 2}i?})ew:{# :L@I$&d8H֗v@LLd2C"dd$I [%dd$OQ3aUx v ɮPa2s Z&dE'2T<#,_>ڰEhݒ/l؀L*$]K{^/TnS,z/2OB&Y,G&tx9#_NU$,~]>LZ.&Γ{?u'!,č?tlueө8Yېɮ/lXZ&-rQꉳYU,,̤Nr_"x[ϕuچq1c~ۿһIBwLj9cS2]4lo !dE|2֚Ob:hgAYJȧϖ˲1>W׭z}BjM1+}gw ʐIwLv_md2҅ jCN:lԓ˝gM` B{Ve5Z^|/o"$L7gom fdp2aO ",R+'d<d [ kmu *xЛ޴&>d2IuFakz xbGgt"[𓺰5Y(qɎ/lOr2s!\5k݈=J jٳ7oQ2̹L67zR9rk( L2ɢN(ԷO9g0?œ 5l̡& &c^ ;υS BjB*C&GaʪUμ{tO3!IUIv8 _$_V/gLvqjj(ڗd2b}_[}%dEH&ۗo[P,Yw֚0hߚ,ɸdЭ6a}9\DWL.Cf\IqBoc&dEH&oo+b -nkgڲ!ZM!tpQ!v]Gt[Q|$o2iM\H/-"H4 G$7hc+LB&Yd?Wf2&huV1&kK*(Fy}jE te[k3GsW$W & ( d9&;JJFL 8JB&YO&YxɪDdMAP2b2iWN&~G2 B$ pL`iB&Y nd}:?%lIIpl@&922 MʤDg22 NΕEwZO$#oW_\&!,-dzm/n ;d2H52d8!N$d䔤.ۊ2t`g"x2N,,&WM&۝2ɢLܨ~nvFTfv`W,-|w=;sӚtͻJks%I$Zq8Og ȻpjĮxvkК从L^:zc9ĿbQȅ֌Iŷ6*V_\&!, "_ky öY!aNb-%L^{|=#r2T4F ,'=]/ml^xX{jX;:`}8xUI$:q50?ke_ɿ &=55Z1 dRn~3.m#bAk`k[+]fe6|j}I$:qo2]lKaH$xƘ0UJd[>@A&2)x/gWs!3cPϵ!rv^T隳G2 dQ/nψAvDF;֌(V& w+*29$Lh0nN+ bLz,<2ɢV0f# bLzӈC$q%]-A6! XI ҄L@2٢IIpl@&cB@pHLLd2)Y`LL䒒՜ތI[{֚H CYa[|9W,wvE]F^ȃLXLۦ=Z7}ۏ ȤB Zя<tfi;lǹUv~6%C-!VʟQq 2#t3m$þG*2iGMVoMBu(o :OH&Z,Âk\&Wl®iM LhtPhG&1~,- (|,* pwUۡ۰,&_`389.c<;370<I0_f]1X 1S*yUҩzv$a}~,wB]$!uۆi!`%!w1~(S ۖRC7m, &_σ !W)q;Hmh15 ^Czhɝbz|쎋zɐ%BvnM~ྜྷ@npSӼ`d/oѲLƸ[=e!n'1cd9ם`K#،ܡ[NɤkX`G\1[&)wc7 _@RfV쳑t7dEag&36j!"К,|yۏd2ƅe*B.ke\yf`*!͍Tۡ&rװ@&+C֐v*v{hP71i7_,'NeJe9q!`%4UG+5?99_A& e25b!t;j5(.^d7k]j ͠Ƕ=md_jIm?ZE ӯ&]j+;H04YI7{ į9{vf1R/Iv^ᯘ6cdevwTBZճN P'n?%wm?ZE yEͦFJ +ݕt??!Gro?ۧz;eq[z-'f)jHv;xHVܠ,`Of`{KxLeþGI,yQD Կ:2ɢVXU7zzۏzS45Z_~pLϬd@m1I#LL67z{ۏ},ҋ|f醫(};LL67z|ۏ-$I ҄L@2eC"dd$!,vfM^W&%b *'I%:N֟N)o ouB&`( 5)R) q"V&M&$ `L8% (|,*Ŀ3xxbkﰇ`sL8Q,1.䑖2]l!oUB&`(rL_N7*!0Nd yϰMw8V qX&c\cdmM* [{xlI'DfdMk[{GxlI'b_)r!9ͦF*5;4;C`{L8ѦCH7 I'VZ&۝)!0NL9]є[&d 2`!0N@&A0I':6U!dƉ5B@pUqLJt@UB&`C54|1=]l#o]y֤l-,R4S|_"dƉ2P6L)Var9W L']Ҕ%Ԥ6/uS2LyGq"V&xd6YXXt[f gjm$12y9kg$OJ4Yo mmuo;G1]zG3Z=}7'4~G욜amAYm_j*LmjaF]5A&X从L^:zc9Ŀb-k=3cl2+?1M_6:衃I?s%mq蚰~p]wLڐIw&vpVCwA&XCL++mtڈECwVBV5Ҋ66SVmkdtMS+6f|LxtgLvA&Xs=}K7!/V2lM `< llVD(:զc,+&WILF&ۿKd\kEkLs}7?S6 uʄ&ub; Drg(|ye%x\#E)ϥRߤ+*Vk>lHot|GN7W؛2 @B"–g䶷mLNt%t]D'e4 O%(vbJ_Mn$G+!u_.X&_Id2iIOrnd-wsB&?kMҡ @찶 7%h_sq2 QL8(B&`O]L@< >t@/ d u IENDB`java-design-patterns-1.16.0/event-queue/etc/model.ucls000066400000000000000000000046031312550536300226410ustar00rootroot00000000000000 java-design-patterns-1.16.0/event-queue/pom.xml000066400000000000000000000034241312550536300214130ustar00rootroot00000000000000 4.0.0 java-design-patterns com.iluwatar 1.16.0 event-queue junit junit test java-design-patterns-1.16.0/event-queue/src/000077500000000000000000000000001312550536300206625ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/000077500000000000000000000000001312550536300216065ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/java/000077500000000000000000000000001312550536300225275ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/java/com/000077500000000000000000000000001312550536300233055ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251355ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/java/com/iluwatar/event/000077500000000000000000000000001312550536300262565ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/java/com/iluwatar/event/queue/000077500000000000000000000000001312550536300274025ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/main/java/com/iluwatar/event/queue/App.java000066400000000000000000000053041312550536300307670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.queue; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import javax.sound.sampled.UnsupportedAudioFileException; /** * Event or message queues provide an asynchronous communications protocol, meaning that the sender * and receiver of the message do not need to interact with the message queue at the same time. * Events or messages placed onto the queue are stored until the recipient retrieves them. Event * or message queues have implicit or explicit limits on the size of data that may be transmitted * in a single message and the number of messages that may remain outstanding on the queue. * A queue stores a series of notifications or requests in first-in, first-out order. * Sending a notification enqueues the request and returns. The request processor then processes * items from the queue at a later time. */ public class App { /** * Program entry point. * * @param args command line args * @throws IOException when there is a problem with the audio file loading * @throws UnsupportedAudioFileException when the loaded audio file is unsupported */ public static void main(String[] args) throws UnsupportedAudioFileException, IOException { Audio.playSound(Audio.getAudioStream("./etc/Bass-Drum-1.wav"), -10.0f); Audio.playSound(Audio.getAudioStream("./etc/Closed-Hi-Hat-1.wav"), -8.0f); System.out.println("Press Enter key to stop the program..."); BufferedReader br = new BufferedReader(new InputStreamReader(System.in)); br.read(); Audio.stopService(); } } java-design-patterns-1.16.0/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java000066400000000000000000000121751312550536300313140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.queue; import java.io.File; import java.io.IOException; import javax.sound.sampled.AudioInputStream; import javax.sound.sampled.AudioSystem; import javax.sound.sampled.Clip; import javax.sound.sampled.LineUnavailableException; import javax.sound.sampled.UnsupportedAudioFileException; /** * This class implements the Event Queue pattern. * @author mkuprivecz * */ public class Audio { private static final int MAX_PENDING = 16; private static int headIndex; private static int tailIndex; private static Thread updateThread = null; private static PlayMessage[] pendingAudio = new PlayMessage[MAX_PENDING]; /** * This method stops the Update Method's thread. */ public static synchronized void stopService() { if (updateThread != null) { updateThread.interrupt(); } } /** * This method stops the Update Method's thread. * @return boolean */ public static synchronized boolean isServiceRunning() { if (updateThread != null && updateThread.isAlive() ) { return true; } else { return false; } } /** * Starts the thread for the Update Method pattern if it was not started previously. * Also when the thread is is ready initializes the indexes of the queue */ public static void init() { if (updateThread == null) { updateThread = new Thread(new Runnable() { public void run() { while (!Thread.currentThread().isInterrupted()) { Audio.update(); } } }); } startThread(); } /** * This is a synchronized thread starter */ public static synchronized void startThread() { if (!updateThread.isAlive()) { updateThread.start(); headIndex = 0; tailIndex = 0; } } /** * This method adds a new audio into the queue. * @param stream is the AudioInputStream for the method * @param volume is the level of the audio's volume */ public static void playSound(AudioInputStream stream, float volume) { init(); // Walk the pending requests. for (int i = headIndex; i != tailIndex; i = (i + 1) % MAX_PENDING) { if (getPendingAudio()[i].getStream() == stream) { // Use the larger of the two volumes. getPendingAudio()[i].setVolume(Math.max(volume, getPendingAudio()[i].getVolume())); // Don't need to enqueue. return; } } getPendingAudio()[tailIndex] = new PlayMessage(stream, volume); tailIndex = (tailIndex + 1) % MAX_PENDING; } /** * This method uses the Update Method pattern. * It takes the audio from the queue and plays it */ public static void update() { // If there are no pending requests, do nothing. if (headIndex == tailIndex) { return; } Clip clip = null; try { AudioInputStream audioStream = getPendingAudio()[headIndex].getStream(); headIndex++; clip = AudioSystem.getClip(); clip.open(audioStream); clip.start(); } catch (LineUnavailableException e) { System.err.println("Error occoured while loading the audio: The line is unavailable"); e.printStackTrace(); } catch (IOException e) { System.err.println("Input/Output error while loading the audio"); e.printStackTrace(); } catch (IllegalArgumentException e) { System.err.println("The system doesn't support the sound: " + e.getMessage()); } } /** * Returns the AudioInputStream of a file * @param filePath is the path of the audio file * @return AudioInputStream * @throws UnsupportedAudioFileException when the audio file is not supported * @throws IOException when the file is not readable */ public static AudioInputStream getAudioStream(String filePath) throws UnsupportedAudioFileException, IOException { return AudioSystem.getAudioInputStream(new File(filePath).getAbsoluteFile()); } /** * Returns with the message array of the queue * @return PlayMessage[] */ public static PlayMessage[] getPendingAudio() { return pendingAudio; } } java-design-patterns-1.16.0/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java000066400000000000000000000034171312550536300324640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.queue; import javax.sound.sampled.AudioInputStream; /** * The Event Queue's queue will store the instances of this class. * @author mkuprivecz * */ public class PlayMessage { private AudioInputStream stream; private float volume; public PlayMessage(AudioInputStream stream, float volume) { setStream(stream); setVolume(volume); } public AudioInputStream getStream() { return stream; } private void setStream(AudioInputStream stream) { this.stream = stream; } public float getVolume() { return volume; } public void setVolume(float volume) { this.volume = volume; } } java-design-patterns-1.16.0/event-queue/src/test/000077500000000000000000000000001312550536300216415ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/test/java/000077500000000000000000000000001312550536300225625ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/test/java/com/000077500000000000000000000000001312550536300233405ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251705ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/test/java/com/iluwatar/event/000077500000000000000000000000001312550536300263115ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/test/java/com/iluwatar/event/queue/000077500000000000000000000000001312550536300274355ustar00rootroot00000000000000java-design-patterns-1.16.0/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java000066400000000000000000000057421312550536300322110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.event.queue; import static org.junit.Assert.*; import java.io.IOException; import javax.sound.sampled.UnsupportedAudioFileException; import org.junit.Test; /** * Testing the Audio service of the Queue * @author mkuprivecz * */ public class AudioTest { /** * Test here that the playSound method works correctly * @throws UnsupportedAudioFileException when the audio file is not supported * @throws IOException when the file is not readable * @throws InterruptedException when the test is interrupted externally */ @Test public void testPlaySound() throws UnsupportedAudioFileException, IOException, InterruptedException { Audio.playSound(Audio.getAudioStream("./etc/Bass-Drum-1.wav"), -10.0f); // test that service is started assertTrue(Audio.isServiceRunning()); // adding a small pause to be sure that the sound is ended Thread.sleep(5000); // test that service is finished assertFalse(!Audio.isServiceRunning()); } /** * Test here that the Queue * @throws UnsupportedAudioFileException when the audio file is not supported * @throws IOException when the file is not readable * @throws InterruptedException when the test is interrupted externally */ @Test public void testQueue() throws UnsupportedAudioFileException, IOException, InterruptedException { Audio.playSound(Audio.getAudioStream("./etc/Bass-Drum-1.aif"), -10.0f); Audio.playSound(Audio.getAudioStream("./etc/Bass-Drum-1.aif"), -10.0f); Audio.playSound(Audio.getAudioStream("./etc/Bass-Drum-1.aif"), -10.0f); assertTrue(Audio.getPendingAudio().length > 0); // test that service is started assertTrue(Audio.isServiceRunning()); // adding a small pause to be sure that the sound is ended Thread.sleep(10000); // test that service is finished assertFalse(!Audio.isServiceRunning()); } } java-design-patterns-1.16.0/exclude-pmd.properties000066400000000000000000000025071312550536300221610ustar00rootroot00000000000000# # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # com.iluwatar.servicelayer.common.BaseEntity=UnusedPrivateField com.iluwatar.doublechecked.locking.App=EmptyStatementNotInLoop,EmptyWhileStmt com.iluwatar.doublechecked.locking.InventoryTest=EmptyStatementNotInLoop,EmptyWhileStmt java-design-patterns-1.16.0/execute-around/000077500000000000000000000000001312550536300205605ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/README.md000066400000000000000000000017201312550536300220370ustar00rootroot00000000000000--- layout: pattern title: Execute Around folder: execute-around permalink: /patterns/execute-around/ pumlid: NSZ14G8n20NGLhI0XBlT865suoGa0n_NylNixSsxTvEHJTF7xGHsF8YShtfqdFdCK9TbK4ELDQcFl1ZizE8tbwRH3okR0NKBcXm_a7vK4bhOLreZXVnLJPzrvnnV categories: Other tags: - Java - Difficulty-Beginner - Idiom --- ## Intent Execute Around idiom frees the user from certain actions that should always be executed before and after the business method. A good example of this is resource allocation and deallocation leaving the user to specify only what to do with the resource. ![alt text](./etc/execute-around.png "Execute Around") ## Applicability Use the Execute Around idiom when * you use an API that requires methods to be called in pairs such as open/close or allocate/deallocate. ## Credits * [Functional Programming in Java: Harnessing the Power of Java 8 Lambda Expressions](http://www.amazon.com/Functional-Programming-Java-Harnessing-Expressions/dp/1937785467/ref=sr_1_1) java-design-patterns-1.16.0/execute-around/etc/000077500000000000000000000000001312550536300213335ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/etc/execute-around.png000066400000000000000000000107541312550536300250000ustar00rootroot00000000000000PNG  IHDR^.2IDATx'i@_1}W5u4Ac[.KEº1^D`h:̞{̙Ι33mQ u # BQհOXv T>j . \ \pa7patAy΂Xͨ7 73V]5v / ssl֍ cf3bpׁ wՅ;T0[EOj,k4cglL[rڲsye!, $ ]*.dʾё/!T V3$pB-5coH$;t{< +UtBb/怓fpe%"HVou^bFl\BW Q)\W<[$Kl,,KMsmHt3QFtX!Jp/țsa|ۤ塴3kGZ#Rg@1.G2m_ق9) ˅H]Ȱbq7ޯ|خr-FHgXqX߻p;}c׍vbH3ﶔ`jF[XCu\n6-mT 3Hpdjl MGivDm(@i4 }'\Xx; pa ȁWW]bsJ xM@L6)%.yG0|cWzBʳNAX5s "2MXʯ6B2Gu]8uWޑPGVw$z:ѿ. \pa7patAy@\ \pa7patAT߅/_lyό;2)|@Y( u;^dfg,2wቓ0r`˳&naM[ 5LbFS!Nn L2|Mk]'ε4;rlqgxFݠj5 s#ƚG+47yrct$)-tove]xk{#zW>_zzǁdҭR q}ml7_x9U|/_P|y/7qnl{j4LI4ҹέ6zƞt:0&?mN^Ҽ_7<܇ߜHPunTՅL/sa?;>xd]^sŻ4t#!,ɹpXDSq} |pZ7"rwu+CG47?H]݈V6,gKM;8Y>, *)-^Q1Iv+᭳QU5qu̙t?RW^Q99Rn87"< .ڹ?2~z ;Ͼ 2qo\d7wr΢$ z=yշoG6Q;Oݣ9q*y1¬;2txټKj{NVӇeˎ /'4ځoB&'܅MUjX\go?l#:{4믖+L::wԺ! ˏ N S9{xEz)CjhN^GW?42t`fǖY ctSkS`po2v=5V)|ξu?cտݣW jPp_'6 ] )&n!E<\8mHV ?_ݴwqo? Y;2~D &v_|)^H(V!q͆9smd=Nl~v-߶{Gد3a;qሬ}d̄Q~o5J~&Q;NWýϼlCwĆsUK_]p"+M2\Оy4ێcڍsLXݣ/[f1 rdG"ƛji++Q7)p;NTCf=nt-bJ?ޓrT7'iějؙ*mk]+oܶ'K.#ꔀ.ܶǑxvU? fw=qH&w" W0( p< W00: o . . 00: o zv/e[Ȟ Ǟ./=\8acD/5Ӭ72MnP%d)o,Oncc%qDW;Vo |Z \q l!ݡF^ku,9ZC1N{+k m .i .-/so7 h)˸#}'[FU(_r޸\1dwdyU׍GSN+컥1p jؒ&nɓv - ni .ቁuRC:Ȓʑfͨ(MbD커1pLb?,Qc YLmGGyCW؃= nh . \ \pa7patAy@\ \pa7joBjGj maD A@\ \pa7patAި]sy<@0=h . & =6~yօo|e㿓c y Hd\MN.;w3W~7͉vukV?lWexUBU)%oYQ˙_RS]8~YS+0\I VOXf=|).`edAkXT_u(NwkC*9TJn&Wֱ4wጄx/T\xݫ;9~5ώ\|)Ӆ_(Ԓpi3<gL$ѳ.Wâ#A 0DIȅox?캰-l4ߠ6ݘ-&0:w.\U<}Lm=D?O֔ʻl_KVUVBF1ik6Ƃ#Us[pIGyc˥v2bԐ.!M L\-;'(I20P+Bn߼rX=^Yۻ=vY?6bx.2vbܽ fv,=;֯NѦ $7oY4&4L$!<3ʅPJ|$|%3IJ;WH rHS sѬjJqv+G}i}ʪpZa2SV.MmvinfHebb,=62wnɆ^*U4&NDZod+{lT s+4z4ǢITf4TCRUC A M)m%;;)Ce_"T=(. Wf̃6_/T& W8pp'E3$$Pz \uiRU̍Z U,$:BOq+ ŅUC³OX³ӹr(CTA2嚅 N?vî۷zj|۩qp%S a[8([v6F:&!F{Dܲdy - Fv6]9]8V5tZ&i۬ND߃" W{!wt-j;w:߲ ZOT}C\vx S$Pxm:F?RZ[^ȲR8G_x3BAa8W dNd.\lU WrwV<"4:k 7g\Z)"#`wpbro}ϫh],@6B^6⟰Gٌ,slńא.>vH ꧽ*BQ|vđcc|!J@b+F7Xfp3% f"-GG; r}ndp1.hy#t java-design-patterns-1.16.0/execute-around/etc/execute-around.urm.puml000066400000000000000000000004521312550536300257650ustar00rootroot00000000000000@startuml package com.iluwatar.execute.around { class App { + App() + main(args : String[]) {static} } interface FileWriterAction { + writeFile(FileWriter) {abstract} } class SimpleFileWriter { + SimpleFileWriter(filename : String, action : FileWriterAction) } } @endumljava-design-patterns-1.16.0/execute-around/pom.xml000066400000000000000000000033671312550536300221060ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 execute-around junit junit test java-design-patterns-1.16.0/execute-around/src/000077500000000000000000000000001312550536300213475ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/000077500000000000000000000000001312550536300222735ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/000077500000000000000000000000001312550536300232145ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/000077500000000000000000000000001312550536300237725ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300256225ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/iluwatar/execute/000077500000000000000000000000001312550536300272645ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/iluwatar/execute/around/000077500000000000000000000000001312550536300305545ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/iluwatar/execute/around/App.java000066400000000000000000000040671312550536300321460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.execute.around; import java.io.FileWriter; import java.io.IOException; /** * The Execute Around idiom specifies some code to be executed before and after a method. Typically * the idiom is used when the API has methods to be executed in pairs, such as resource * allocation/deallocation or lock acquisition/release. *

* In this example, we have {@link SimpleFileWriter} class that opens and closes the file for the * user. The user specifies only what to do with the file by providing the {@link FileWriterAction} * implementation. * */ public class App { /** * Program entry point */ public static void main(String[] args) throws IOException { new SimpleFileWriter("testfile.txt", new FileWriterAction() { @Override public void writeFile(FileWriter writer) throws IOException { writer.write("Hello"); writer.append(" "); writer.append("there!"); } }); } } FileWriterAction.java000066400000000000000000000026051312550536300345550ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/iluwatar/execute/around/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.execute.around; import java.io.FileWriter; import java.io.IOException; /** * * Interface for specifying what to do with the file resource. * */ public interface FileWriterAction { void writeFile(FileWriter writer) throws IOException; } SimpleFileWriter.java000066400000000000000000000032741312550536300345740ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/main/java/com/iluwatar/execute/around/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.execute.around; import java.io.FileWriter; import java.io.IOException; /** * * SimpleFileWriter handles opening and closing file for the user. The user only has to specify what * to do with the file resource through {@link FileWriterAction} parameter. * */ public class SimpleFileWriter { /** * Constructor */ public SimpleFileWriter(String filename, FileWriterAction action) throws IOException { FileWriter writer = new FileWriter(filename); try { action.writeFile(writer); } finally { writer.close(); } } } java-design-patterns-1.16.0/execute-around/src/test/000077500000000000000000000000001312550536300223265ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/000077500000000000000000000000001312550536300232475ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/com/000077500000000000000000000000001312550536300240255ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300256555ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/com/iluwatar/execute/000077500000000000000000000000001312550536300273175ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/com/iluwatar/execute/around/000077500000000000000000000000001312550536300306075ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java000066400000000000000000000030651312550536300330360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.execute.around; import org.junit.After; import org.junit.Before; import org.junit.Test; import java.io.File; import java.io.IOException; /** * * Tests execute-around example. * */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } @Before @After public void cleanup() { File file = new File("testfile.txt"); file.delete(); } } SimpleFileWriterTest.java000066400000000000000000000062061312550536300354650ustar00rootroot00000000000000java-design-patterns-1.16.0/execute-around/src/test/java/com/iluwatar/execute/around/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.execute.around; import org.junit.Assert; import org.junit.Rule; import org.junit.Test; import org.junit.rules.TemporaryFolder; import java.io.File; import java.io.IOException; import java.nio.file.Files; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; /** * Date: 12/12/15 - 3:21 PM * * @author Jeroen Meulemeester */ public class SimpleFileWriterTest { /** * Create a temporary folder, used to generate files in during this test */ @Rule public final TemporaryFolder testFolder = new TemporaryFolder(); /** * Verify if the given writer is not 'null' */ @Test public void testWriterNotNull() throws Exception { final File temporaryFile = this.testFolder.newFile(); new SimpleFileWriter(temporaryFile.getPath(), Assert::assertNotNull); } /** * Test if the {@link SimpleFileWriter} creates a file if it doesn't exist */ @Test public void testNonExistentFile() throws Exception { final File nonExistingFile = new File(this.testFolder.getRoot(), "non-existing-file"); assertFalse(nonExistingFile.exists()); new SimpleFileWriter(nonExistingFile.getPath(), Assert::assertNotNull); assertTrue(nonExistingFile.exists()); } /** * Test if the data written to the file writer actually gets in the file */ @Test public void testActualWrite() throws Exception { final String testMessage = "Test message"; final File temporaryFile = this.testFolder.newFile(); assertTrue(temporaryFile.exists()); new SimpleFileWriter(temporaryFile.getPath(), writer -> writer.write(testMessage)); assertTrue(Files.lines(temporaryFile.toPath()).allMatch(testMessage::equals)); } /** * Verify if an {@link IOException} during the write ripples through */ @Test(expected = IOException.class) public void testIoException() throws Exception { final File temporaryFile = this.testFolder.newFile(); new SimpleFileWriter(temporaryFile.getPath(), writer -> { throw new IOException(""); }); } } java-design-patterns-1.16.0/extension-objects/000077500000000000000000000000001312550536300212735ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/README.md000066400000000000000000000023571312550536300225610ustar00rootroot00000000000000--- layout: pattern title: Extension objects folder: extension-objects permalink: /patterns/extension-objects/ categories: Behavioral tags: - Java - Difficulty-Intermediate --- ## Intent Anticipate that an object’s interface needs to be extended in the future. Additional interfaces are defined by extension objects. ![Extension_objects](./etc/extension_obj.png "Extension objects") ## Applicability Use the Extension Objects pattern when: * you need to support the addition of new or unforeseen interfaces to existing classes and you don't want to impact clients that don't need this new interface. Extension Objects lets you keep related operations together by defining them in a separate class * a class representing a key abstraction plays different roles for different clients. The number of roles the class can play should be open-ended. There is a need to preserve the key abstraction itself. For example, a customer object is still a customer object even if different subsystems view it differently. * a class should be extensible with new behavior without subclassing from it. ## Real world examples * [OpenDoc](https://en.wikipedia.org/wiki/OpenDoc) * [Object Linking and Embedding](https://en.wikipedia.org/wiki/Object_Linking_and_Embedding) java-design-patterns-1.16.0/extension-objects/etc/000077500000000000000000000000001312550536300220465ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/etc/extension-objects.urm.puml000066400000000000000000000000211312550536300272030ustar00rootroot00000000000000@startuml @endumljava-design-patterns-1.16.0/extension-objects/etc/extension_obj.png000066400000000000000000001122021312550536300254200ustar00rootroot00000000000000PNG  IHDR\ `@IIDATx}l}@ 7NX<LkmQj"Iy#W& mڑQ`^[ cG"##R6m兹v*ZmʰuBP55p s[0?>3gf˙3~ gϜ93_ O)(YHz|(J|KGA@7B-0 h D!L}(QS @&m@ǩk:mH!ZT290B-I[LP[*st!DaH(QإJ.e akD20Ͳc8_cQk0Q9 ESVrc@[ #Z>RoLQTa zvyI hA7f8{(Q:jfs?~D )0}-\q'W3> C8kؙ{(Q4ٽvK!b >#w,cxR[Z GJ?B0 4f6k4:F2*v8iM#!S5ѥKŽwе$(6M+ @7B-0 h D!L}(QS @7B-0 h Dav-Ou8)$T)f@[ s]ΌF[vRxiS @ff>vs?w.Ǐ;rx]/Om>v}t\ZF+Am(._Yo9tW\ϫNl;BF+Am(n~|춧:7yͥ]<~h7/>dDF`tsgF0[ 9xNE4B-}g=yiA;'b7~2wt6cDӽf\1Z Am(ƶNŸs?6N~ڣ;۵uF#r(4R2р(D!ll̾OL:tf~n6=LvgW΍ԿqHBcN DaAm(ƾ|жcwk__xBRslO' h Da6vnm<3a?Wq~kbݘXC0 @ffϟbS.&! b_6[(Qw޾OiB܊֝Am(._Y;wo_qQAm(o@[ aD!BQAm(o@[ b$b# @,i @cLZtu:}vgWw0QPBC𱏴'4 @c^Qhw7FSaM<D!ByM%Ql) @Jdf_e_C [g!S @7‚Ųi(o%bY 0 5_A@قB lAtD!L}CWP k+([5ݐAsU@ѡG.O)(dރF}@H)|cBwlsD!-0 5_ASjPnGD!L}CW|ʖJNY ˼o!=drPu- XkF5s۸fl}ZKh.^8sV k(o l) Ya zv (,R(ӡ,-EJ{Vʍ^f=u5 aj-59bg 5[uy0cХ!CcU޳q{6"k@7|Bwn)4d-8v(wrX{EvB!~s(j\+)l(!i&BN T*pqڊV!C.`Q(}ܴ>+-czݨ ֘M%!>M-hB%/#\f,20 5_Alѐ5<s uhJްB[G_#}Ahh+ƈeV@:Qv^^ЫհW|NS Ì6[f^Tr]eo='XV[.vDCcWu]QEwEBQc=e<&X? Ѹ+=$P5_a ڭ3'|yFD#ׄȽq]cXuEtBd @7( YL(jUbe q͓sߌÝuŦ*!(Dt͘B/%,湺ltL4 %},X3 / CCn^38.m+[~y]ٱ}9ڦKPYDa/+ CL4%iJDZ 尢|Y&/gM\ؾ{TLAt( /I ̑ m ̟̭hYLDaL -GcVZ(4"rHxFCƱMDhL[He );>=|j̏emSP3 ZfIvTƧY%qM +{ۮ&֯VPwh/1"w$ BQLd @@7|Ut^%{{lū #l^\6"B)n+CV)"gxH[f(ދWLN9vE :@ D!L}CW\eݷM?3q^~-EtM3)־XܪWcoǴU.qa.* U<? aj*[n^ge7$̏H70ۮEPl EsH wos^j u RbGk[Rxd 0 5bTyo'͕y2#ΙAۆ(Ҏµ:,(Vw_ IGC9";:5WCCz΃S5҅.i*[3>>¯hB^8=kM@n $D`ȠOKmb:C>B’AsU G.$W>5׾3 ճ>6}_4Qhrj(9AL1 1S^z˖? w_?ܼ`Obeuzv1/:f.XZߒwǂ@7z䆆4{?=O!nEXH+A8 aj>V~e//q`?Uw|x5^$͏."SCͧ*L5‰EK7rp7OF(,O=\rY 9ܡٗ<j>rABd @7@7|Y 9|V]E5%"h1QW 3 O˟$L:ȍLCW 5 (g{'?{L4 ) "i |lY &pzӳC"kA.QwL78ymGV(l֬UgeYH+_֭4;VlV(ɛg(lkIb$2)7'/ wE5;{ ӆI* $_zdس+,;I)' -6fGvż؅,!e'q%"9)&^ Bta֢S2~RY=L]:ziQH|?QjtB*Ec OSeQsDxrwzlAP/ۨD!_Z%CEaڀkyok[cTZt_4;Gbd @H$ ?x|ό<{n_H| BX i mCZj>9\.6rJCrF&=;ٚ|ݡZƮb\ k:F"Qן˓O>t~6R#u:m' ]3NFH8wOu$}\cOV/aV4 jLzsGsEAb+ >Y1BOx Ǧ^ip/IğK&}l«Y=ܘBh+ZxugOJ^\jcGs+>E@~(oeK\YەWWW{{{I>jQp9`Z]Bp`Q1B:9/+Y ӂH@6`܈[Ya]DaADNqM4f1H\VIV*ґ @H|= cϮ$}@2SKۙ*tjl?`H7^-=OomDĸ)gәBԺ`֊J+A~XZZ-333 @.HHeыGMӎG n)9Q|{񑅻6폾>N Da.- -BOx Ǧ^яm۶{J2iHtY+JVsd2*D!M :![l!%`L[ C& a dHZ%F",넴{G2&>$l>ĴeA U.766344Bi27b2QS AV,,,4&:[Y'@X)ppp0ӖHBQbxx m,//ˣ(I0uRLN`2 QS A&Ƭ5OYKJa^Z0mx(o HRy_E9itD!L}(Xkkk%Ǎwp;>dXe"QS A%ࠫq.['&&(j4a2(llq]֘Z~,lv/s"0^"i }H]2VUcm$(,>0mH' Y:ah w"\*-QhsFk)֝ AꌏOOO wsi&O a2 D{T.Lx4(}@>NKJl2C}^gl_W3 wmxl3^VFoldTQR鏬MIL[@"Q{nf{uG 4TչףZc4IöyfQ mCZQh8(3B- < SgӖAaH?'o=(l+6g #ٯR]5XnUlr>AQ $̂5aeP4$dsMx63?.f8Sx֚RrP4фSl\b%ih G:픶seL4(ނ5aePdw}X62VeLKxSJyD'Pk€i@m{7J?XX rO քӖz@7%d#T}`M0m(D!L}SJyA' քӖAށ(ojW@~ `M0mB| $ O` -|QS R%i)Xk€i @ԷT@N y`2BV*HH@,XL[QS X%(kƒi@q83# 9uHucb.u=Uk5<w㬘U2"?X#0mdt;R:7GūN:7۱#uuJV*@@,X-r >mKݷ>S{'N^:AQ(,t=mT8V`/!>{.lq]}uٌ, )sss9 2r|فZmhA4b &܆^.7B xX&*N[a_$(<#{ƞ]9eIHh$ZTٻJ!3?qcԌWp"ø(>4fw㻘bX+N#y&o n!~O-Cr s2uaţiG#qxƴqJn'kWۛWxU~^u~3'\W4BDi##g4ud 9[}H< ,X 2L[(̵@~۟;x^8BQ+~ zXc1e>v^E=mhJ"D!L}C O`G`4|sBTEVj[Φ- fsswpppff&co߾.TT]t. UQ}]˵AJ )񩩩ju =O~2rAߗ5tJUvPa"Daq P^H$8|24/m<kkktt~c +++Xu'_0NTw\D:i˖-i5ap W\^^&!ȇϧpuVEpg!=`wK6w?Tώ{6d`.(Lh|$f*X4QHܱӏPVbq&UB!]{$-x3G^3)J$,(E15ef?$LI Ix5MOy]/B8Q։j^D!WS(kz3?aM!хL{aL"E{^bzACʊk|sM\E: *]$GGGI&kB 8QtYad{O߭۫] Mh?_ᣭޯ^c7Wrr$֡( %L eLD> .%_XX]#$_:pg!=uկRt^%{{lū #l^\f_/U&5KkGS\;Z%Mc?Vq4 kzl3GYƱ`7$@xf߄ybjR7߶'zd?Q5uh^/5!'LhxWcwLyh:\ @ZinK\cARudd$^JԴ_|E w-):։uRX[n|<̏ߠmC~iSZ ᱉BSm rj(lXѶܛmEh WsDvtk<5Da6 >|X4WisM^'?KrTZ&-H2^^^c D QXLFg.?}]}i#م_6߽pz֜30B]NmaD!?Эm ' C}Z g9RQHr-..($|OOI!X%dc266FZkd\_\I)FL' @@`ŴnDo/|j}g ճc1]@G{u8(71BWM.l19duu//FIt!]ZfYd|||zz:4H i݈B? w_?:!wFۚc sx VS\Zӓl~-G篽%;U=_>(k߄"(,u) .w=Zf(U/j:OǘWe0Q()5aSa*j㜊P}[=O4P=~ k_ smڪ!Y]]:6 x\UQ'W[ƼN!x 5{o/օr_xcAkWe0Q()r- x\UQ'W WG- t*ܫ_ti,B?Xhb{r@oRDa PReHJNW@jz94P/j:4Fif 'ܪ# >!O2(4l,v64dNO&YD,,,d 7$r֩pUuqiLh)8WK.T=A"/>sY1J ' ;a!.D1ZTN9Aʸ<:/1 EM!È-qjPtDQ:ä$6jӳu*WլS**߸nq w8Xܾt.sOcaĺ-_t ;-dU*2͉ bM12/@;դgGsN]`Cɵԧ3]: 1KmI eD^Z& V k1"x\MH!ۋ9U=_.]@*q沎;լN? ֊腷e5/[, ]QOp!Rq,4mhh(T"xGLF.8~U&# TEVjDaq P:B~񺶶644$ss&"8QRa}OaDaq P:fffƲNE(Ǡ 'QXt'BH{OU%[3cLt{]LOOg6,..g 8NTVѥ=K5DafT*S B.Zj dT`w\Dt̒s]h!CCCeHNT0nOC bsss˖-Yj֩h_NHUQauO}(̵AJ֩耍r냃*Q"8Qz ?&M".r3 SBDVʩ(O#'5Da6qJD+ <20pO6D\TSrycc#넄%UQQX(zXs.X!Zp;lm ̷aVW[qks)jڀqN?Q:{iZ vrZ 4s΢1KCǯk iKc}}\.g(`2@@`ŴXDٳ0)NG |0%˕H`Yck_8/\hlԎX!2} (0⺴B9fm;rk زeK'=4-TDƟ&JqL]:ziQH\[0 g63N ÛV4gu\vn"$|d;iк垑ktJ~+(L#Y[FGGNED09@@`ЗX&|۟;x^8E!:|߮2 J@JmWä됶6^!ξc7(1KKKJ%TtF\ίdWb4 Tmݵg^DZ\>6B@wȢ\58  133366u*be@&@@`ŴXD!٧v<~܅cS/ jIG-V/BL4ou⽴B@ drDjO+aI!EH0TH֩ LF#)Da1-.QHvه%ih#%yY&ABRYZZ:1Y.y" TmQœf ֘f5AB__j֩j:??u*s + S 8Q([l:iP֩LF20pO6Dqpry}}=Tt &#爤"?_ QXL(,AJz#~=Fv0_Om9%SMǻcQ()S W5#f%<*{JJv/0?ge}C `tttnn.TČ2Sg09UEaNvɀ?iBImmQVÿTihr8= ]+i(Zz\:ɢx:zT+(J@%]NP' M^ANE(<_IyB=q{*\ W"So` IA,onnV*)~~QQ(- J{{{.G4QX-=0>ڈ}IHe@*VVVxT*KKK)'+ SBeP{?&#/Tm8 @ZkJ,$k~@RG9 ϧ0Z^p ׀B?PP'ʀ(LRaja?&#MM t*o^AhEd u*ңs14.;vd|0NMMUլtUi@p֩H"LddORuvE/7/"wQEm,~LF.20JĖ-[/ UařY0 X9\X\*PUy-8P4 Ng?&#zE2\+d1 Yvemx@qucځx7MW) BUȖ-[NEj}G87/2^>0@B -8 կϑ#Dfk0q3K1"u^R"sM :((LcӬS ETdd!733C$98FBk$En(LS ~}m SN"CG>aq\YAÇVpaPv.AbS2֣kvӓu@"-^\\$Q844tUWٟbQ8TU?߼ʳ}v{tN)IFTkedddmm oʃ1 ) 8K1;1YmVVVpsP)IWdd)QT20YF1%0#g}Bqw ;H0Y #GY" PjPj-:,Q+a5@3a(JC(J/<<\.Ea>Ro^2Ugm-]~a}F#ZY!+@ S*-[d 8u*gcccpp/]ŽH L g0WIPxuaSq7vB Sgee?THɠS!kkk(?9ٖBwn)dCLgıEq<ϴ֤5Px\!h)Tz[^^:$ X\\:2BJs֩M*kz'SoKF#,~۬`~1 Qi2r: )a]yK9}j#\}6.l2m*Ӻ:QeʨAx00: -l+}0LFN`|eyŷ^q]}[g'Nu$z՝8  >+ers J-(ʗ'SoLTXqOFmk̭ZBQ} GHJR%1fQc2r ͏W`\7w7l4?@{|mKe#;;rΕ5AK9\n\+MV^@xVWW ;\5Qh'ixK2Ugm-]~a'͍FZCWȽWחa&#Plٷ{vߓ˽wO~Űod쫧$mϡ.g2#; : }1\Dnzd=9ȲRu(ZDaGlT7$l&Ey:^K:!Ggm;soFM߿]OFN`:g.Z kG[2:kvl]Y(f>JF~ok-NE091hLOOvJema3}Ǣ8y'*zQB RԳxvY zHS:-uLko7vo&;}̳+F߸afo)V E!7Ռ;!D"+Y[j2f6k4:Fr*v8Wy'e5FzC 7@d />n']7_ģZ |g~:):VW{-RhD(\XX: U0PRJ5ѥKe7/h](9aɹ$(<7Xj!MӲ9!S(X._Ymg&;ҿ{_ǑSi/7WxKfL!D!c B4j2S@N'#SL>oէvG8O;h#>+x;}@}`LQKXMQ.s'w'9G߾{=?ؿ~KV*DaBPǠP@23&^\\" MFN`|e'zhS߽~Ǡ+VWWj֩iDZ:Qlaaadd$,?5KY %EQlss\.#5KY Hg® Q\5Y'|uJ&#`I?+P4T,^h bLӴԳ@^dd  -}QA)?*1ZeԹH Cg S;)< +yjrΚb2bJ B}KLNcGnC,.\[f7[ض塮C5Z~ЈV7/mF06&,2V$,MM-bJŸ0Av[d3v{;'b7~2wt6k5k&sЈf{ee'TO/(̓#,+e=/]׵8zVu>r(NUB.V2nB}KLujg\lduݱخ7rX~vSv8H2{[\`79B_1ZQH7 NFTPƱ[YڠaG-\ᮏz~ T\9Cb98ٝ;(+w[c7vm;lVbC0Pߒ"`g}bzס3 ڽmz3Ϯ㆙0^9^u( …;aG-L % qzQԺ:Mΐs2r2}ΏD+PsEf2Α\+,Al#EA@= Id%nk(lpn}҅(( |жcw^}/Lr6q;r(0u5 HV3vux) 6D.o0-0ޘNBRQ kkkY"dϟbS.w qov` w8QpEEJJj/ Y@lĢЂlFX¦EzppP1*,ҚBf6\wkr7^ά|qYNu )5EaSׅ`S/mS[²bkaahX鐃M}BI 5 9M!Qز6lvRfψcX>n@Y-£ ֗@K!ʊ¦ޏw=4LTc,1{VkKtkCCC2 Q`5_ϴnG@1aH4߉&AGY)=So솥kVZv^Bښ*(X2J Vk썣K\៛"9!;|9[}Av[(aZpTT;J^ F"B|I`<+ c -drXֶ*˅͙qdd,2d%֢D!D!,3k[lI^Hb2ښ1??ZqHba(J]129,]k[lQ$ApPdU^nddvr ^R3`!+nQ So!ҵ0V__ɗ$@YYY /Άn>''v G"IVV ,%.F]gY^̯Z^^fn BN YRۖ-[xa]\\Od2KY QQٞ`[lmlldkkkeHhN;r F_;>>ğa.LFFIVR^|˓o|z݃;Nm>+4n6$dDa[sy,uk\.J*y(N\B__ܜ%ٴh6 k/b2#-6JKعdK$c_-OF鹪D h2u1҂?Йqh{N ϼ4J]P_yEƽXRya,㭭U*H&666xE҇Wfcccn-[{)1Vgd,if%o+)a]yK9}j#\}6.eXSZLPdY=T d̀(lk^Qhw[+(lkl*ᅽ(4"[a~f(9^ؕe^؍ꫯ޻w/0+92izFFNVJVfx[o~|춧:꯼Ͻmf1}ӇX|c5[[n*{k(8*퍳ͦ]rl)(dDa{3*P/ ZY11~^.$n|U"_|o^_d|Ȕg䥧o_1?;n:uaݎ6BCiMS%zM/%~@lz]E"že$S#677{zz |B39|2MS#S^n3[-?5#-mlGwl;k!\3^zZۆ÷W}ρpp1D!,][ :UVE#ȝBѼp̾OL:tۍۦN_>ʹ7n[ l6k:O Mg:frK A\QeTT #f%nk,ӇWk__xBRslO'EDz?^aKeR4 ! ՂJ\/1%̬b\.Pr$=cnajjb~#.6{ZXs! kDh#),_}3o߽ȩ}k;[) g]rMJ Q:)XGgv+FPT\ܳt⽓Uhz&84SmF7O{I%}ʋBO\s~{_~gu|w1w>f F(ڢ%&͕q #CoEQ[DiTOEk%7DaPݷ>S{'N^:A;Ol斲hVxkg okAҗV`Zjb!F|jeVJ&g>zݳ=_ڦ"8U'n΋Ah Q KI;4X$IBF#%pG,=rʲN-G rJΩ4 Z Hq qb+٢obrDO+I+˟?yC#K};أ}2`LBXزEcQ ILF+Xs2uaţiG#qrfKg!v7_ WsZ|ER JV$Q)aZQz;DaB$1ٯ`=?3v콺C#?0Sc*5(LrvqK@:2`LLK"Bҟ߿mKbW?'o=1R Nsf.qGy҃cXQQ[D1ؘ_Lw2r@1wԋi>z~)&g~/t/N4:$rV Dad0M@ʄh䖤z\fϥ! c!ȥ@pه%ih#^FbÒ4,GB0B&kJSb⚌%gVk"D!eBk E.jLYdd,2g%okc15֣jr(р(ef͞GF)\s8rkh;Wlw6Kyj4XH5(ef][sssݜN! Jrֶ->{͖BW۞a~;ݵ̄uf A€Cz$c % +1Ph~D:b?U Qغ, ,qBʟ"mm3Щ{Mw2с%6|}dnf (SpR2`LY:a1KMDDzO' ͦK.|NJQ(AFfyyc -Lן˓O>t~6R _urFp}@=P;3NH8^Z__/ݟtJtA\J=߀l,hC:vId( A4BM4tplôA=qfkbCG~)N N$]ۉ~eq[CCCr*02][W_[{+p|E(4C}!]BY)<==W JPլSaxp\Ltb 6zUuljj˩@GW肰j?8>]O.^āF ߃cXL# P,^3{ {5U:r9/膶 v]\~M[ZwbQ \W/᮶@gîht%£l}AFfiiizz:TdFD!LV؊lBddE wNdIRHP_Hn ,bER@LF.FbT R( 02Shm!ҵr A5֢`WV &H&Dc -ݰtkM6:::77 AGMFFV-GB0B&k[_^Q.+Ur(р(ef[ˣNFFǬV 02k:Y"3 aYx%5KR[:͏."ߪ Q:Y"3 aYj___'#cFB ?z&C)ȼ) 2u*2#=Qب9s92yr@k!S"GΖhLTlV,U<Ÿ_9dYVJ#զSQ7B#n :/rK*9,b+`<&!=#Q(AFc -LwL78ymGo慩i2}wZBq YNt=ćx6_}uLRis,dE@sc*8kpBzݒ/rNEXл9zE{{RNOԎ BFc -L~G,=rʲѼmh<7ZEqQ}fՅ׋Y.I{ I9n /.{6{f~t!MӒ83蔶AN Ξ%DaJ:"+EhA! #1֖O&ϑԅگ2~ tyōWUWH1]7x<ֻ(mTF8Γlv~7ut6gnR5777::ęAP%(BQ÷4h )nnOg W$'Dj(h/ ?x|ό<{n_H^y#ڊ=ٞ_JQ2sW(ln)[rS򀁞2){}}}FFF˯ճ$]wSHQm{{2MO؎ g:(]Z[>|?y뱗'|$m\?W@G4a1Bs/vdEk\B4ï>_:F.Dac~Ԋa:9&# z466C*Mϒm\J@環 ormuhiۓnz"viNkvABk˿;;c±}am5vaGiq[]+W>_ ^g+6Tܒ4@_y[rUl A0Y~---nٲ̌O~E%nOgK{{{MOĎ $)Էuac0mD l*=H9a,brA0YN4M;|0IvJezz:v/B,{W)BtFqgwf.)#< >bZ-SR*ޖ5˯'lWS-j%d?I(t~@}gIл jJTW]oOPY@Ffuu`NEf,3KآJjYA|ff-[H/--E>[L=K,Ψz{Ò4SBXftU.'-$I6"Ψnz{ S( Pݼ/BXftEʃwd !877G0\\\}|- D%]l'z  LFjKBptt4w/$7`LLKR(W]b81 a JD}!AFc Mzz*"%|c`2rlll^s4 O Pn+AFc P/{{{NbxcE /sCJn xn uHRic/":;Sߧ xn,,,d ІURH/, 9\2`Qx md8W;uC cPܨOYbz=*JE /sI8Ʉ(ûo}Ot6; &zg鶁ZmT2[ڬ{>K*Z kw!O='>Qah{yɚ'i΢5~إYJ_SDa*|n" (a$ )s\ E2T9#{ƞ]9eIH|[5f5wՖGZ2%cbk Jk+jlN>7ͺCL8Un{7Em8JvS_sSej>SG4iк~6vוWk&Aas> ) /s̹H^2ǯT=?3v콺C#zczѵ, ]Z{1u휦ۋB3w,L*Da&`L!PBX}7Yz\2'sL+Uy{yɇOsU Fu'H}ϤX+BGs suuk vFJ 8c0(D!,eB lHt`E /s:ɄR;c±}tFGM4qqͷpŷ:F;;M!TZH[>&d)(tDV"XElkRo4}C CjVk>qie9)r=%Tƒ4_<Ή,IJ@F1mFgs`qV3IooMF6m .//>|9\Z%lJQLZ%``sJ P݃F}ޱ5H `u sED(kSVrc1BoLF`2ǜ(,pU(h-Ό1/xnG) =˃.-f vow5Jl|[ Q]bQH!d/& y"\;5J 02###j' Q3C]Nq'ͻ-;>ͳg֡nm;so*$]ihEN6iW kE!s.bxSɹH&TQ A4ܨwf6wn)ta+Z̻->nRQZ G CRRלxҟs0 3p.bxcE cAREa( QkfcFCh1`8N4 :ʻ11322ǜ(e.s*U4`L!PGs1`8Kx&^8\$;a^\@OU% 1t~F )D¤Rdd\2Wd"QKsg8Ł(lBs.BB^zF.B8M( ׽491̹xFtI ҇n7S(k%(\YY! >w.Brs0@Q(KlBAl.QHDG91u\D8%5 e"[΋U_0q(,޶mO}u~Ʒxͥ]<~h7/>ml l7r[q5;啮Vaj;lYnPp k)t!{ѩQI.,,VCCC㋋dd"WFL}_0q(,޶mٷ{vߓީ>þ񓱯SQ_Fh2.5Q~=g%.ô d{K!4mzzzxx\.@LQddbAZU<:+BҮTqDT8_cQk0Q9p7D(,2elooj);3ohcg=c۱]['o̬k-cp%olmt]F/ * Sjًb7oH,݂]Pтoj qH'_AP}dl̾OL:tfo7vo&;}̳+F߸afo)dy؁BQh?K4;[9h-(tX5>zӯ=x^Bf,LjULZC(l Ը|u׺^ssgwjpz903HpNS2LD(4<r6fNY6:#POx G߱phsؙ9K}gxw;mApbzyKZI7>;wT{R) BxSzړyR?|(@gd"IvlƉM]3W}ޯmׁo#=5,2K'&}?*lCf%:XvrnK`<^ުn6;nt` %M!7{;36Ee +ַvYSח˟ -,?UV2Laq`l"fy/=0alˈT9w%S(וd:̢\BnMG6>qHٓWNT^|t^Ma0ii5U}j)hBBʿbZyHBS{VvmlH> yެ8l8ѷoe;Q-OMwB=°SSTS)VL!:#S{vzbٗg_~wH??St?}Z%zL&}(RBHQpW֮}ɾcy /-?97Ч8~pݥ)d( ^ dKp;}\;On0b @ԟ߷vĖw/-S &P/RoH7 C.>1m͡4Us/` " i5i ބuUnЧ%g9o>:3cM4H.L,Mȷ Cՙeϛjٟ8& P/` !jSh32В%g"iȘUsܕmOЧ\C+vC҂|j-9/B)L@?R{j jD*hB=gy0[ҫlv n e\o#VL]0z$=_ٹ?OJr3:#pMS0TgK#V e&,1ˆMun{7kQڻSiV 2䎽Rës?0}l~mJΛ滽[BS,3/\xRºFȀ)2&¤ HL^{7gN^v5EvoQ9ͲN{0y]>\ֶ΀\P-)*P_,ǔr .8Io1/HZ&&A` B޷(0:L(n< l_Lݡ7Ob)w3{#KBXW`4 ׻Ŀ !hS;og$wo91nK/R8-BgҲǢuL!sѦn S(Qʒ/H Jj,gPՓ}a 2CN@~f"B}SYz")Dq÷d*IB1mQE0))ԋ~}ݑ'Ϗ}h㽍W`:N^mPl%/~N*gY/(<)<)d$SF[f!T_E0))ԋqu{HZhּ:0՜h;H'SSo!#A'Q5r[U}V2SZG0Ii P/T)ib.wRЯ햧Xdv猦 ׉jMr/¤V^Z H7rimK6W_D| W xPPSoHZS5їQڻSiV ) 륊]3[u̲t~:G>VCuD˔QA) ֬ZBtvvҩ{bq)G;ϼ=3pʴ)ZD&xJFf%'9.F.Αy109){vx-mQ4鈦5)ԋ%w܋5nxfzpJ|3OhW.uOٶtU8}ݫ8_Ȍ -iHY{,B!Y:E,ASY{ŊGwrb`ݖv_ZЅ5bsI䮪t›l/ sOCUL!hVx׽XRz5:TB˅B`1BQb G)" oQdtCu<—Bʡ~;kѶ濍TPUMS,ѣGMWOm=[](Z(>J d&qWtiN}簃3!92h>;Еʻ C[!E_5Na递l>n-38˦#{;b-s6p>}܅@լ1g[Xu`GedX VU9bm6/dP2f^j-֭[~wygF, OD>RپG>O *M^0~J*7~HKD Ia+ ۵SK +{5pVu7D|4\Eb>!i -Nwޒ<#.ԵvlƉM]3W}ޯmׁo#=5,/nZyu!kn?nfQf5ֲ<~q |#$j ܼySh;99IݺuK!%":HwzR.M̐4/ I,MeG•C_];v)O^V{pxݪ +ˏ[e0b806gu3\w4eLhb+;#Mah/` _>00{mƨ4r~m9w|ϪѮMm?'_|ۙ7ϛ3m'lgS<5s~1{a+| fɭo oݺu֞82ϛܻw/9;Ｓ, Oj`  )V~M嫋^/ϖk~nc;K)*C)LN!c g$-` _I&Oxqo2###ѷ~۬;srBML^ !ʯ)$?k|o^paKON? i0?)c~o Tcww 2;܎zW3by`'0nϘa]|1G߿ߊ+<R) 7X6 ߷vĖw/-S |.9~= HG)doܸꮜuPSoHn mk<*8ǢK>qEBL^Q@!tE\~Å8/twdm"d絬SP LľUCu{ˉv[EihSh۵Dmە9D mRw׎B'%v,<#B@+S(gCYs2>pFSY\=ylyt|hL '(7͠$pXfiTu|lur%dߵ=ןp\P8|l(lh>hLD)tFΪb~P-4G*y~iVEWrIBU]$w1:kݘM] w @o_H퉿%t4>0_!bjIS[SHqu{HZHq2$2 0y]I*:Б;@.3!)kF}ez)729)FN;V)7b&A`  X0IAj%B@jy)LaRZ x@SV)7b&w{z @)BH 0P *!b؊@0PSU5P L!X0P L!X0P L!X0P :Š 1)(BH ) R` !ł) &R` !ł) &RBuw>WvSPNS@L*7kZ0&Bd6=S*L'`` D`M7`  BS6(}tݩ@ve檵9;;4*vboթY4kdUr p R[ܽvJvBS˦W1W*Fa]ck  TJg8yeR"ぜ {v̖,ʘ<9e]c8T)RS*sU~U ap_`[ @)2Sxہ ÎôJL:S)Z͟We. .'dؽ/2kePXY|k^"gBSf-0Pu{ˉv[EieuK~c.kBN ExxOCULm 09Rdͣgˣ C eZX=GlŽ&$pµbfa/?I=Sq:`J"ScBP(%#qZU+*\NFBsc&,?Ħ[Y=t.{f5/H QNTk휂D^YN @"3;ϼ=3pʴ)Zİ r%:<5s3MSfJbdޅ[>iZc6cۺj vߞ!j7BPv8t~h°0R̯x1Nį'077ڋ *ѱgWua{ 4MRiڵo04B)p;O*%57X~7r橮|&ۅI}STIpŦ0L! P(Ef gPՓ}&l>S~f?Ƭ*Mx]z~tQ3F(La` h @)2SHz}ݑ'Ϗ}h㾻[fc&fJkk1y,;w?o| IS4mxoS@C TJ0^l^id?$M=4'BbP(%֑7LIPRw ZO0PʒL!%L!1AS)L!1AS)L!1AS)L!1AS)L!1Av?]ri_BS` ["4IENDB`java-design-patterns-1.16.0/extension-objects/etc/extension_obj.ucls000066400000000000000000000246651312550536300256210ustar00rootroot00000000000000 java-design-patterns-1.16.0/extension-objects/pom.xml000066400000000000000000000034261312550536300226150ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 extension-objects junit junit test java-design-patterns-1.16.0/extension-objects/src/000077500000000000000000000000001312550536300220625ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/000077500000000000000000000000001312550536300230065ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/java/000077500000000000000000000000001312550536300237275ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/java/App.java000066400000000000000000000060221312550536300253120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import abstractextensions.CommanderExtension; import abstractextensions.SergeantExtension; import abstractextensions.SoldierExtension; import units.CommanderUnit; import units.SergeantUnit; import units.SoldierUnit; import units.Unit; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Anticipate that an object’s interface needs to be extended in the future. * Additional interfaces are defined by extension objects. */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { //Create 3 different units Unit soldierUnit = new SoldierUnit("SoldierUnit1"); Unit sergeantUnit = new SergeantUnit("SergeantUnit1"); Unit commanderUnit = new CommanderUnit("CommanderUnit1"); //check for each unit to have an extension checkExtensionsForUnit(soldierUnit); checkExtensionsForUnit(sergeantUnit); checkExtensionsForUnit(commanderUnit); } private static void checkExtensionsForUnit(Unit unit) { final Logger logger = LoggerFactory.getLogger(App.class); SoldierExtension soldierExtension = (SoldierExtension) unit.getUnitExtension("SoldierExtension"); SergeantExtension sergeantExtension = (SergeantExtension) unit.getUnitExtension("SergeantExtension"); CommanderExtension commanderExtension = (CommanderExtension) unit.getUnitExtension("CommanderExtension"); //if unit have extension call the method if (soldierExtension != null) { soldierExtension.soldierReady(); } else { logger.info(unit.getName() + " without SoldierExtension"); } if (sergeantExtension != null) { sergeantExtension.sergeantReady(); } else { logger.info(unit.getName() + " without SergeantExtension"); } if (commanderExtension != null) { commanderExtension.commanderReady(); } else { logger.info(unit.getName() + " without CommanderExtension"); } } } java-design-patterns-1.16.0/extension-objects/src/main/java/abstractextensions/000077500000000000000000000000001312550536300276525ustar00rootroot00000000000000CommanderExtension.java000066400000000000000000000024201312550536300342360ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/java/abstractextensions/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package abstractextensions; /** * Interface with their method */ public interface CommanderExtension extends UnitExtension { void commanderReady(); } SergeantExtension.java000066400000000000000000000024161312550536300341060ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/java/abstractextensions/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package abstractextensions; /** * Interface with their method */ public interface SergeantExtension extends UnitExtension { void sergeantReady(); } java-design-patterns-1.16.0/extension-objects/src/main/java/abstractextensions/SoldierExtension.java000066400000000000000000000024131312550536300340130ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package abstractextensions; /** * Interface with their method */ public interface SoldierExtension extends UnitExtension { void soldierReady(); } java-design-patterns-1.16.0/extension-objects/src/main/java/abstractextensions/UnitExtension.java000066400000000000000000000023531312550536300333340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package abstractextensions; /** * Other Extensions will extend this interface */ public interface UnitExtension { } java-design-patterns-1.16.0/extension-objects/src/main/java/concreteextensions/000077500000000000000000000000001312550536300276515ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/java/concreteextensions/Commander.java000066400000000000000000000032351312550536300324240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package concreteextensions; import abstractextensions.CommanderExtension; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import units.CommanderUnit; /** * Class defining Commander */ public class Commander implements CommanderExtension { private CommanderUnit unit; public Commander(CommanderUnit commanderUnit) { this.unit = commanderUnit; } final Logger logger = LoggerFactory.getLogger(Commander.class); @Override public void commanderReady() { logger.info("[Commander] " + unit.getName() + " is ready!"); } } java-design-patterns-1.16.0/extension-objects/src/main/java/concreteextensions/Sergeant.java000066400000000000000000000032211312550536300322620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package concreteextensions; import abstractextensions.SergeantExtension; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import units.SergeantUnit; /** * Class defining Sergeant */ public class Sergeant implements SergeantExtension { private SergeantUnit unit; public Sergeant(SergeantUnit sergeantUnit) { this.unit = sergeantUnit; } final Logger logger = LoggerFactory.getLogger(Sergeant.class); @Override public void sergeantReady() { logger.info("[Sergeant] " + unit.getName() + " is ready! "); } } java-design-patterns-1.16.0/extension-objects/src/main/java/concreteextensions/Soldier.java000066400000000000000000000032041312550536300321140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package concreteextensions; import abstractextensions.SoldierExtension; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import units.SoldierUnit; /** * Class defining Soldier */ public class Soldier implements SoldierExtension { private SoldierUnit unit; public Soldier(SoldierUnit soldierUnit) { this.unit = soldierUnit; } final Logger logger = LoggerFactory.getLogger(Soldier.class); @Override public void soldierReady() { logger.info("[Solider] " + unit.getName() + " is ready!"); } } java-design-patterns-1.16.0/extension-objects/src/main/java/units/000077500000000000000000000000001312550536300250715ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/main/java/units/CommanderUnit.java000066400000000000000000000032301312550536300304770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.UnitExtension; import concreteextensions.Commander; /** * Class defining CommanderUnit */ public class CommanderUnit extends Unit { public CommanderUnit(String name) { super(name); } @Override public UnitExtension getUnitExtension(String extensionName) { if (extensionName.equals("CommanderExtension")) { if (unitExtension == null) { unitExtension = new Commander(this); } return unitExtension; } return super.getUnitExtension(extensionName); } } java-design-patterns-1.16.0/extension-objects/src/main/java/units/SergeantUnit.java000066400000000000000000000032221312550536300303430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.UnitExtension; import concreteextensions.Sergeant; /** * Class defining SergeantUnit */ public class SergeantUnit extends Unit { public SergeantUnit(String name) { super(name); } @Override public UnitExtension getUnitExtension(String extensionName) { if (extensionName.equals("SergeantExtension")) { if (unitExtension == null) { unitExtension = new Sergeant(this); } return unitExtension; } return super.getUnitExtension(extensionName); } } java-design-patterns-1.16.0/extension-objects/src/main/java/units/SoldierUnit.java000066400000000000000000000032141312550536300301750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.UnitExtension; import concreteextensions.Soldier; /** * Class defining SoldierUnit */ public class SoldierUnit extends Unit { public SoldierUnit(String name) { super(name); } @Override public UnitExtension getUnitExtension(String extensionName) { if (extensionName.equals("SoldierExtension")) { if (unitExtension == null) { unitExtension = new Soldier(this); } return unitExtension; } return super.getUnitExtension(extensionName); } } java-design-patterns-1.16.0/extension-objects/src/main/java/units/Unit.java000066400000000000000000000031171312550536300266550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.UnitExtension; /** * Class defining Unit, other units will extend this class */ public class Unit { private String name; protected UnitExtension unitExtension = null; public Unit(String name) { this.name = name; } public String getName() { return name; } public void setName(String name) { this.name = name; } public UnitExtension getUnitExtension(String extensionName) { return null; } } java-design-patterns-1.16.0/extension-objects/src/test/000077500000000000000000000000001312550536300230415ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/test/java/000077500000000000000000000000001312550536300237625ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/test/java/AppTest.java000066400000000000000000000024611312550536300262100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.junit.Test; /** * Created by Srdjan on 03-May-17. */ public class AppTest { @Test public void main() throws Exception { String[] args = {}; App.main(args); } }java-design-patterns-1.16.0/extension-objects/src/test/java/concreteextensions/000077500000000000000000000000001312550536300277045ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/test/java/concreteextensions/CommanderTest.java000066400000000000000000000027051312550536300333200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package concreteextensions; import org.junit.Test; import units.CommanderUnit; /** * Created by Srdjan on 03-May-17. */ public class CommanderTest { @Test public void commanderReady() throws Exception { final Commander commander = new Commander(new CommanderUnit("CommanderUnitTest")); commander.commanderReady(); } }java-design-patterns-1.16.0/extension-objects/src/test/java/concreteextensions/SergeantTest.java000066400000000000000000000026731312550536300331670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package concreteextensions; import org.junit.Test; import units.SergeantUnit; /** * Created by Srdjan on 03-May-17. */ public class SergeantTest { @Test public void sergeantReady() throws Exception { final Sergeant sergeant = new Sergeant(new SergeantUnit("SergeantUnitTest")); sergeant.sergeantReady(); } }java-design-patterns-1.16.0/extension-objects/src/test/java/concreteextensions/SoldierTest.java000066400000000000000000000026611312550536300330150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package concreteextensions; import org.junit.Test; import units.SoldierUnit; /** * Created by Srdjan on 03-May-17. */ public class SoldierTest { @Test public void soldierReady() throws Exception { final Soldier soldier = new Soldier(new SoldierUnit("SoldierUnitTest")); soldier.soldierReady(); } }java-design-patterns-1.16.0/extension-objects/src/test/java/units/000077500000000000000000000000001312550536300251245ustar00rootroot00000000000000java-design-patterns-1.16.0/extension-objects/src/test/java/units/CommanderUnitTest.java000066400000000000000000000032761312550536300314040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.CommanderExtension; import org.junit.Test; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; /** * Created by Srdjan on 03-May-17. */ public class CommanderUnitTest { @Test public void getUnitExtension() throws Exception { final Unit unit = new CommanderUnit("CommanderUnitName"); assertNull(unit.getUnitExtension("SoldierExtension")); assertNull(unit.getUnitExtension("SergeantExtension")); assertNotNull((CommanderExtension) unit.getUnitExtension("CommanderExtension")); } }java-design-patterns-1.16.0/extension-objects/src/test/java/units/SergeantUnitTest.java000066400000000000000000000032711312550536300312420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.SergeantExtension; import org.junit.Test; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; /** * Created by Srdjan on 03-May-17. */ public class SergeantUnitTest { @Test public void getUnitExtension() throws Exception { final Unit unit = new SergeantUnit("SergeantUnitName"); assertNull(unit.getUnitExtension("SoldierExtension")); assertNotNull((SergeantExtension) unit.getUnitExtension("SergeantExtension")); assertNull(unit.getUnitExtension("CommanderExtension")); } }java-design-patterns-1.16.0/extension-objects/src/test/java/units/SoldierUnitTest.java000066400000000000000000000032661312550536300310770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import abstractextensions.SoldierExtension; import org.junit.Test; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; /** * Created by Srdjan on 03-May-17. */ public class SoldierUnitTest { @Test public void getUnitExtension() throws Exception { final Unit unit = new SoldierUnit("SoldierUnitName"); assertNotNull((SoldierExtension) unit.getUnitExtension("SoldierExtension")); assertNull(unit.getUnitExtension("SergeantExtension")); assertNull(unit.getUnitExtension("CommanderExtension")); } }java-design-patterns-1.16.0/extension-objects/src/test/java/units/UnitTest.java000066400000000000000000000034721312550536300275540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package units; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNull; /** * Created by Srdjan on 03-May-17. */ public class UnitTest { @Test public void testConstGetSet() throws Exception { final String name = "testName"; final Unit unit = new Unit(name); assertEquals(name, unit.getName()); final String newName = "newName"; unit.setName(newName); assertEquals(newName, unit.getName()); assertNull(unit.getUnitExtension("")); assertNull(unit.getUnitExtension("SoldierExtension")); assertNull(unit.getUnitExtension("SergeantExtension")); assertNull(unit.getUnitExtension("CommanderExtension")); } }java-design-patterns-1.16.0/facade/000077500000000000000000000000001312550536300170335ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/README.md000066400000000000000000000032301312550536300203100ustar00rootroot00000000000000--- layout: pattern title: Facade folder: facade permalink: /patterns/facade/ pumlid: BSP15eCm20N0gxG7CEoz3ILKqvTW7dpq-hhehERTJ7fMJU-l7PYn4ZbVPMlOyvEXBeT13KMEGQtdnM2d7v-yL8sssJ8PKBUWmV64lYnSbHJoRqaVPUReDm00 categories: Structural tags: - Java - Gang Of Four - Difficulty-Beginner --- ## Intent Provide a unified interface to a set of interfaces in a subsystem. Facade defines a higher-level interface that makes the subsystem easier to use. ![alt text](./etc/facade_1.png "Facade") ## Applicability Use the Facade pattern when * you want to provide a simple interface to a complex subsystem. Subsystems often get more complex as they evolve. Most patterns, when applied, result in more and smaller classes. This makes the subsystem more reusable and easier to customize, but it also becomes harder to use for clients that don't need to customize it. A facade can provide a simple default view of the subsystem that is good enough for most clients. Only clients needing more customizability will need to look beyond the facade. * there are many dependencies between clients and the implementation classes of an abstraction. Introduce a facade to decouple the subsystem from clients and other subsystems, thereby promoting subsystem independence and portability. * you want to layer your subsystems. Use a facade to define an entry point to each subsystem level. If subsystems are dependent, the you can simplify the dependencies between them by making them communicate with each other solely through their facades ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/facade/etc/000077500000000000000000000000001312550536300176065ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/etc/facade.png000066400000000000000000001020271312550536300215210ustar00rootroot00000000000000PNG  IHDR8.VIDATx{}X%:!XN{mFGN7嶼y<8XQ0jJX89) -'3zr\ 1؉.Z%ÎFFr_zOϫg^?|1>]uΫZҪ:`PS0jy/ C8;`T2Ŗ]|puӤ:mAD V>8;`B V>8;`B V>8;`B V>8;`B V>8;`B V>8;`B V>8;`B V>8;`ԬzG>Il= & V>8;`L=g}{ $&)*7<ݺS[j# Z}#xHI_g|GSv;ZjvМyU?F W&WW??~ϙ~W+/rnj.Yxm_SyШm\p V>8;`d}雟쓫_ ?83}b'z@o7ZuOx`˟LK7CY;K ({"ץE"?;0zX\>rSIs"vÐ3>h| Lj/j@Ѻijz2èΤR2.B!'{)6rY|Ox6)556421~Υh̳(~$;9.Sz+iLoƬ!O&ś~9~@]-^B|3Gw揨 D] lC. ٨YZ3٣V*ۨG6[<I2Kgb(S͙mFz -]od53<0jCC &3߼7uo⿊y3lr_4uǟFFM1 '4NϷDҏ՗4/q/=o{*¨6w۶CLrN5jiFjZҡܡQʫO,?R7K_ydx7sԧEL_qe%GeOt-NmSal>VMFKMvFmLZb6(2Q=S-oOt^qLyp˳ɒw=N[[3"3Ǐ%ZPQ$^'_s R.{`hmլ2j޲)5ȣ)^%%ܥ|8;`j"jδXZW )`y][FԈ]V'i= GmFMJH\fx@feC`\=ـ>jRz V>8;`jܣ>3Zf -a-oZ?ÁΞ2rS6fxigQ݄Q+J0jBQ+J0jBQ+J0jBQ+J0jBQ+J0jBQ+J0jBQ+J.-scF ZDBEEDt(qw! F|(qw! F|(qw! F|(qw`0 -"j""V:8;`B V>8;`B V>8; c[3/w/+#!ZPߨm}-)Q!aʇpaBF|(qwؐQ[iݕN,y0ٳa\N7W2"3/0jCÆ>u9o$3(K4jnh ̿HMDHF|(qw6j{OُFL`zdpn۰eh,ZNZe_r_!èm{]:Ͻ R90N#bOo)L֞섍1ĭ[ }sJ##$Ug22:~ѧDVפmSsnϤY,JЗ5% x%۸"])B*!ͨyG9w$aRTYcă%)RUQ Maʇp4vsn_{_RT6}@Ezҁ]*" %Vvz12Xi%'*2jd\Q,j򧔍aP¨%iFm޵©O͊-Sb,s07+պR.žq8{Sqd6 ;4ʈZ>fԬb N3vbP¨%iFM=v酹⥞&{zwZ9{Jnj_賖^Q[QsYbm֔f>jXaʇp &t片9Ć%/^{&A<|+;PR;iRj5RW}-i r53+Z3RJe@wfD V>8;d5䤘G )ZPQK2*O6J>! F|(qw! F|(qw! F|(qw! F|(qw! F|(qw! F|(qwQȹ~ydֽDR2:R8w̤@Zy#T0jCPʲ0 PqaиV>8;d'KH ɮf~9?F 0jCCQ]u{/%zz0e ZvӛduMJftًfZ;N'IȒԲ-jTr>lM"g|$F 0jCCQ;N?sHة&SOpݕl3'y,Ö3lEvKnKn#ejO,zܤPړwcxV>8;KN͟՛/N5KbWFK`6)LOV-Lt{Ag4ufC/ iҞ, |S>ѸV>8;w+b2nL#|- bdx4n4dZSi"9K#kcz~rZ!ͨ>û^]85YeyJL}[Za$Nܕ7ʲk% qfj͞p;!gE3f_"jhQ+J2\ӽn]>0bCȦꄤCþݨ#e[dmgMaR2}XOB0jCCwx(Clh>ZBm,:IfQ{7f~JkRJ/Q~kSoZ?3DИV>8;d)6B"ZPQ aʇp'sHɼZ0jCF !T0jCF !T0jCF !T0jCF !T0jCF !T0jC茚m4)Jl?Wq. NN}zqSaFm`JmyElKK dz0ja*pl` )1qӔXVf͘XrJe1AF0ja*p v<_>$6KKxΤ3n/ͮv'5~\?TRfn='{)cAO&F,0jCCQ;N?sHة&𘿀fwm{*Jiၲ"^}}<;̀'\`TKP¨%iFsgCKSI&c0Z/S`ߍtLi5^4s0YDBaʇp4vsn_{_RӨ}tˢi1j5jWL~F{n h(5,UR"T0jCCQ}-w-8pjSbcة$[GD-{0@fL`$_p~uى!40jCC`kw\ح˧枿_lF>5%/YEQK>j !ZP==ǝ' 4vw&sԧ6QV h.:`V`dW.4s;3cg_m 4¨%6[m,r5F(qw(ШM: B ܡЈZ܎YZɼ0jCCYM1F|(qw! F|(qw! F|(qw! F|(qw! F|(qw¨.)k7T2lSv(e"ZOBF|(qwڨ[`]^0jmT!ۨ=y(XBJl -riBF|(qw0j۞kױs=~CbC%WW&KvJJ[(8}g,ͦ\鶵UD:D+{f/if:+ZPfϜ;x)vɒ=|$B$eQ963lh{µ$9Lcj?u5W!ͨ]=wzn|޼x)v*$7ha*E2b劏$ I{؛4VSPsQ+JҌwrlzω}KSI4W8;4;\GjԟV ڈQ+Z2Dm>xO=/"MT[wE*꟤zAZ]ܡF-][Ui"#"52jQUgӕrΕrɖB(bQQ 8;dW>r)/Y7jM,%-kqoxR ?c]&RvҊYvg7lj)+Pi)Fٞ&cP:Yĵ(-iJ_ ~ћ^x֮%>q|f% 2.2txdKe-rWTSY33*b5sm\]ߧmnt&1j5pVQ7ǣ{L^vg~!8_頓(MW0P-%vᇴh^f?f)Y7n!(h?igH,C2&>q4TވaH-(*JȖ SE54̺-wèJտ.ٿ{o Ϩ]QO" /?7Ꙭg#M_X0jgIslR"%,ݨ p:^<{d-!ה*U' 930+jV xJKk;xߦSZ-!è{>>-mGMèI 7rDM<{J25FL!uղK~83>Ϣ,ZF׸ 4%u2G\r vI&ڦ~ܬ6Th`a毨v[Q+bgo3DoI!˨t~jBb6gԔHQ멏uO3>V&ej)ڳZQg؋?u'hq8850بYo2zr7c\wE \biԲM"j̀p,v>{Lׂpާ]E+ZW| Vem\5Eo>jZ,:SCmۿGPJw{erA?n/Ϩ:ImBVa殨ʧr,bG6<(qw2jo{)v.;rn+s-84fRbo]~;G}-V-wl#OjIt 88z]eSřכɼ5G5+Vrfԧ|nQ 8;d5hM ujmSME*m50jCF-XBZwrբFV& V>8;`j,>ǨU%5P¨%5P¨%5P¨%^@aLϹP;@XYYپ}{չZQ7o>w\չZQW]uUչQ۷o_YY:P0ju_+@]^\\:P#0j6mxbQطo_չzQ/nڴUgF zosP=Lr V0jÚQF dnuz%n@e3| ?=3"8UC`QS]RbWIW?L*m?5Rŋ/?Ms1"0jI{f '}ǢYݛ$i$b&{sc[\\̇- WvKklL1e!KX#veƨ@5pwZG4j}(AhAF6Spf5(bgfTF lVWW1J(8Q(۷T h5Ryׯ⊪sP*ӋUF <Ο?iӦ/Vh58p}4@LMM/^ܴi+4 @Zcvyyn0380j"x[` $6jњQCQ(ب'O.\.S0jsm޼9 9H`vy~oQq!` Dx[նnz…3P ¨kF vɚ05F.=P ¨/rFQp͛0z0jEV9pcFmQpnlw0jN qF I6¨8 76;4ƨʹ[3T*pcd+9Jy54nlwڨy˱i2?]݉lϬ_0jN 5*og쟼`dXiiL2N2i6'JۏQQ ЦXպiI8(gĶ~ɼx0jia;ÃXwҒb`cpcCF-aq`=AֺAKl+45A6~δ#_0jN  5eZ鶣i4~ 7&̺S~76;Ժ8u&΢:hϠ p{N@pcCG}&vk Lzvϴ4&9zٽ ;  UAJFSsKn`['M9HQF IܡF )pcFmQpnlw0jN qF I6¨8 76; ia*s՛ qaҌ+Ğ=:/oMb[$™GQV3Qpnlwgoy}v? TsF5'pӨ ?2}~~_}j~Qר~q\J3,ss/K0pƳ&ŕ1#ɣ W 58f^yu_wAg ihŴ1rtݮ-0C7NQpnlwЌڧ>W|o@ZLE `϶r1gFMQ3Bn=F 0jko~'^xG?Hv#7ےcP:&ESq~ɣ$K-ERq'jRڋW=>(^:ٕWgwf5ڍm23p#$G'h^Tq'e8F aA3jWmkx!!qG?0 rc'K l8<!(&9*$8V#'Bs3mOrWr+hiZp"}R& Ԏѓ 9)ㆶLI 5pQ]-^B|3Gw4iM{FD-t'#=Gig0[e>:a8{B%9M^,GK̀dl^t,L)0ڲa0|Խ͋*}3lr_4uǟ룹7l~ɞR g>"7(N&Pnr]g-Q=yfsbZ*'3mGK@Vd'#K04,'F Iܡe|WbO'7K_ydxW:0  ڶ~>[0o뙱1˜ +rݝ R?~ Fm8D#H5QhAQpcC˘Gm;{>ɩ~?p+?ydqn:k~"5%{qbl2z[^#)=rg2;Bin b{?ʁ.[Ur a S0Sd-m2';kU\@3pʑrPh<f8$Qga0j,pcFmQpnlw0jN qF I6¨8 76;`Y5'p&5ofx-š;l^sKѯ_ͅ8KF IܡIF-VFmgQQ x1x(cvϦLtI=iꐬp[2=ޞbKOw=NzEfzUg'.eY` 9p""Hhˊn&۪YeԼ3SKgv ${ƻ~pAhU[E"e޶:'F  5KaldGbo'ޔs5?B?Pff\fŜ4v%[sQpcCF-Y-NlFmB w*5.l*]ӨYkW螺Q1%F Í FӝiDZ0:!vwʗޚ,5VF4pcCI}"GmFMJH\fx@feC`\=ـ>jR``8ܡ.>3Zf -a-oZ?ÁΞ2rS6fxig1j0,PQCF I6¨8 76;`Y5'p8 $Qga0j,pcå0z0j"6jQpnlw0jN qF I6¨8 76;0`a0`ܡEDm""Qga0j,pc0F1_}r6.pcC~F&m\5'pa}ڠ0jN 2jk3muvwJg_;ڻ,%{ze Rm:\Zw;|anlwPӧ{o@ S"Y{nj4_JoELir *v3nNI;Udd4G&%&~j4S 1j 76;=/<3D:,^J2Q b8dƄ6;BtƔOǍG /S"Vf\r\) p4[Zxqv샧fƖ)sQ"@a/8֝L%Q%9*%MPl<`fs[ƞؓ3y/ pt[O/=/4shӢmYH}64!2qb{V+t&Q>jQd/<F Rp9uQnlw6jr1 76;`j/V&pZLS2pZ(Qga0j,pcFmQpnlw0jN qF Iܡ f̋kQ6Q2?,u}(G=eg-pcCf[)1O 4jLQpl` )1g0lFgCȹ1jP=aԶ=}׮c^{ˇĆxiI7kvfm훚ٲ$4Odi]T^(s۝T[Qk—A{f:5nlwH3j{^xxgtX;d7 Zw"Z<;͙)f˖,[cK>S4agU=b& Í iFsgCKSIF~EwcqH96)&sQPwiҞ0< z!`b!ͨ]~p-Ǧ^W;uCx)EWiͅidyQ>4~R68)4jQ -j$f5ʏZ5nlwH3j?gN>xjVllY;d#.G؇"jFJQvNt{"DQpcC`kw\ح˧枿_lFQ{I$^e룖ggt4\"|@dMCbÞ&) x\OOԆ6Ome iɌ\̌Q̬3Dr!ۨ ٣eEΣ0a6d}kʕ6F &pc#jA4K+g-:4wci}pc>QQpnlw0jN qF I6¨8 76;`Y5'prZ%D)Jr븯Cp$Q+nv44 nlw6j{O p"@p v<_>$6K5ly`zɒa[csy4&2NGTWTe#{82n $fϜ;x)vie ԛlÀVْP #Qܛw 0jBw}VrǓ$/`1pcCQd{PyRTEK0:^Ѕڸ6ݮBɢZ|,+4LdWi<76;w+b́ $MЗ?/5,䈚0@8'R6j2:F-Q#1;Kè@p4[Zxqv샧fƖ)SK捯Jqd䰙Q'EԌXZQwpt[O/=/-ɴiѶ>jiK2Oާ0,#aQR#VuÍ sy`zaOTKm lG}*~IDΤ_sfƨdG}Fﶻ3DApcCGˊGYa1jEL0jN 5i iQpnlwhQC#F I6¨8 76;`Y5'p8 $QgaJ2jYkwXx9э֓ Ia3jͦQf FmCRbcC,V5haԶ=}׮c^{ˇĆxiI/ٙQVO_Co1v/I'4B#O^XSF4qnvn{ᢢ$F 76;=/<3D:,^j2*l; Obd3dK,|Cl{ R>w]k(nTZnQ iFsgCKSI-FFqKQL+#fMx,۶S Ҥ=crɘQ iF;n96ݾةDJ17V_5k\FM&2jj4ӨE43bpcCQ}-w-8pjSbcة$KD8fQvNt{D9!c05;{ s/6K#P}Q2jZo3Y>jYbG5p nlwȞs {d04(rT>YiԧSg->RfsQF -EΣ0jN 2jd F IakXy7 F Iܡ>Q-Qpnlw0jN qF I6¨8 76;`Y5'p2.g(06G0m  Wd_UqF IܡԈ@O}歝X?TAavpcCQ{P3e&3 0jP;!èm{]:Ͻ 2Zk}Ψ75Ȧ2W 3],]+\S^3 >J-gXTUZh F I!ͨyG9w$aRTy(0gvS_WJDdaZ:K}QYrdQv/?x#fͼj nlwH3joϝ?37/^J21/|5Y3n ٍX4 I{<2H͸j nlwH3jq˱='W/N$%K)>F _if2r-K0>ftQ$/3oUcvpcCQ}-w-8pjSbcة$+,EՆ0jƘcŨy;m捈nlwLpMu HSPN%r5ݽ}<>j`!{z;O<L!6iQ LSz/vj͙>Q 𶾍EΣla6d䡗: -pc#jkє5歹̻A8MF IܡԵ>Q̈́Qpnlw0jN qF I6¨8 76;`Y5'p uRC3wj]i&è8 76;dkTcՙl tQ>^è@pcCSN #^ F핏\mbbbVPԖFFlV̍7Ѯ:u"N}ֲ"KQHǘ,zV8` u)eowB씣bypWXiOAk9`@!˨]œ۽տ'kC-)+~h@[H4͜qj_zN %S_0F 2{dRb(LNqpJ3)F- EmT3Qbp,_S7 lxs0gS5oDND j76;d}EأZ$I飖ѪݯSrDFS{2 }.pcCQ{ۻMiVvwI_/Rzi*#=Y˨d|f@pcCQyԈQ0jN M1ji+H5'pjkpQpnlwhQC#F IoOp qn2*QuрQh$9s7-oķ?q6Qh 9/\{qVԊ Pk_͛ϟ?QgFŋ2"'5uց?nO<ٯd0T>>In9v=V h%3 $l,,-&X]]5G86kMUW]ULQ/ӔdkT#_3i.'5SI]jUiطo_vɓ*Pk6o|ܹw_u d'GSbcC`FMsŒڨW,بplK9ϟߴiSZ F ֬O2ڶuk~/-ɣ57a#cJ?fN7j֥ܳ 3YQV+pႵl߾}eee Pwq|Ӌ4煇w~ܑHK35:uIkK)UC씣byV2j+:pI;UlŠ Cf֜GP(@yk'OiFsgCK3W?24A[FF)M欈Sg5#'¶Eץ\HFosOG]O0jŋꪫ/*8|0>ͨ]~p-Ǧ^W;RbJNppJC(fHp]>~N+m!5*~bjRUǡfv`] /.}Ԭز<%v(#e4(5oD-Z_CCU0'5:"~>G< cΎt[O/=/4RdJ飖ݪSrDSG-><I}ġ!BY 5z!̙0d ~y>9[|ɓW\qu TF F8p@UAUFlV󨕧Q@F-\pA@h `j b)FX2A6jy PC0j#~d<9iQ*giQ>5Qs(~Oc C FBkPϡuQgШڨuQiC VdkF- h0,5)]i™GQV3UQ돺uP/^.PF-TsFBkUQ(`ŞNQQ*L5! MV;j*P8Eۨ힁FhʴB8ةh@h d0j, UFmCR$&:i+b >1j(ə '5 :w\90j۞kױs=~C"懶8lmV-GpRrjKZy=qxqfd]ҌZ@rg0*0j^f!ͨyG9w$aRTŦ7nOȋ{(2L޶o_m._<47SZ?K/3jUrq0z|J iFsgCKSMznw" FoH͙Q4#.z79ElP%F-@`FI<2CQ[M9qx)vɂR֛TVK2llufĆ4S@fO8,E7ݬ㧪Z@`FFҌl9kمSQNݝIZH™i'Nufkd)Lް.ʻyQF-@`F vYS qc.^{~!^izv;FχE0#ԡZL?Vf.hU 106FֶnZg1KB=z s kWb//eY2 t)5iZ3ҦYO/q@176@CV/hIarQeYu\VMZ@5SY?EEnjfԌUmʨ z z7΋B݌ZЕ8Q݌Z5 RvF z>5QV8F-@#ZuhCjxUQ 8pK2769@Mݍ*RcbΝwc#Ɠq[6wqn4ƆqcuuKB Fm5VF- 0mI -Kߪ/ c[ndO__:C؈ŝ;w '}vQ-R^o0>`)EhT!܃azzCЋ/o>,q F 9 B +;Ϊ$ @a#Dy=z̹(vBk5pef-/;wvi axe+JUK Ν;ie7A fإCB:Glڴ)mtM+G nQó8d&ߧ5۷{* ۿ~ޘ0&둀`ԠкQ(K뫽` ]vֲK/]zb0j[~w O h.ӥ Ğ^WQ\\?M6?`o!T1h0j$svzzaui} d߾}XYYyUWc<~~bpoq`44`&Ū3,i.O;ݐSs?s۶mÐx/ #|_h,\4.aF,HѣژP(ZQ̒P~,S|%g~aVVVzQ_~V9S0jPk߷KN{UF۷_ve^{o{aYQ#N5%Xi$oLMMmڴ:֜֍0AWPg0jPGdG-Fȹs3:  ,ԋ .0xw}~9>lOn3QdrEaΟ?/7qhJ'vmLu XGd,..ʣ v饗!LwRgXF ''cᴪ3>"ǵV`ԠJ[+p3ԟ ,P!5 a_+.2B EKz\pAi6A`Ԡl Շ۷W1IOB0[MP5(E' ,oڴ/i*0jP*SXng%0A]`"nC%JA`i;(0t-vŘ"~4--P5(`F۷H-jp4Bi`Ԡ@Хr\_ F !ɖNV 7 |P5=dX3-4VXBVSX^^۪:! ##][uF /t tBkP5 Wo7u`hQF f?3֘ٮ>0K1 FF 67lA a}`~" 5X'_Ɲ;w$TCѣG(z[V %```=)KP^[$)YZ`}``8į; 6FxJЗ&X5` \4a/2~- ߺ za`  ,XTs܆ Kb6o Q7ē˯lT:uFQog2׍jZrhQP%O,hdQPѢ: O4TrhQPQCÉ'*YT9Tc¨ ,*Z1TgefڭY*D OZW~rUI_=Yu5{ǝUL&gJ՛14<J8j9^FoZ+j7XӱY}[^#.:-ݵѝHTZ5и>ѨU S߳ Ȋ:VxK57j <3RTڦ1q"}I0k(m'Jش*Wi=v'+zd?W7j s1z4N;cUZ0 q\Q;F%G%lLCӶodlbKmAQ+@u~O4*!}ԚSa3j"p5Q+6'wި|Io [ujw-4>(i$yLK6̓5Iualq}Q rM0Fv?2-:is,OC7mk@eO4۪a~W'_oy>7ŶSy1k(FmGE[ws|_ }6_MP9'\y[RuWݞhcU- pi+[o ,QŸ{`|4Ի~k'O5խc-֠i 2j~>{߷_}{?Z}lyj]jEk}Aur+5KCVO4eo)!Uy;tӯ{SO^ l^-H;VFZCZ͞FWW{Z%{o^‰k}AX2WKQ,LvJI%gime]_ʨծSꦟ_|3ykP]ҟ|㞏~u]z_m:|#xb4BccXT {O=6}S}rɯ9k?v|է@.}p2sQ`ktQҳ&b5欙vZțwQ#%#e̲I;%/11S2TK g~R)S?H5ru_N` } /?-z헶#?ҞY_YjrMU:6N5YZx99z9\f*xko~'^xG?s:o.tÑEfd1\M%([%#CV)u(uTOCF@޼E:>xꑓn }9r53i1j18fhTKMM}I I-xkj\*W7Ou͟߄vK!aѾqGEL}wQ?^}>ulk5jn1Tvܶ_vW{߇sƕuW/|ُ:~k3o2$W)S|\67'KʓR,' -deRRxFݱ6R{ idYQq5d5O:OSHkΡ?ѭ"H}@!WRjԱ1zYN=Q09l30+>~⭿[ۅg=,kxI[zձ3 /1ұ(F-Ol(WD-)9ddP_iǬmͨ 6dq5\5Q~_?/< #jڐk [z!cOǚao acF3߼7uo⿊w_#=/߼{KSwlf1cA(U.l@0vd8 S<8țZ &_IUK?`eRC*ׯMK;OuP`o=ɬ:>ulky09l30k;78?_#ŻP^~^sQovg=>_nw% `~:=s)sE>6=j oUosPL~p(쟯װM?8xæ'~X:S4@^dߦ>R+@j}T:>ulk)ܐQ˛<QΡ{|r߿;:(O/}\kD>}FWe~6;(R2Jl֘\yK2wX=^?ػ٫Z98oY62W&r2=Gɤ%KsWs F1=GFK6{kj\*W7y^·e {d|Z|Fm:6^5~Mڨa۷>)]VxeA2Y\a~Wm&~ޏPa0 lP¨eA,}3'oh^o*Z14*zb*F- eʡECQ@,hdQPѢ: O4TrhQPQCÉ'*YT9Tc¨ ,*Z1Tgap≆JU-0jh8DC%*u Y5oxEs1ɠՅ6"U'`Q G**AMۘc59gbU[oF{vOu7<цpʕ]_MmT"U/{RW'v<ܓ_w+J2v6Y=i#W?~,jjLY-nU9jZk[uؼ~VbԤ0z6_dɋ3$j7Z)ˣ[˸*ƻ~|_-yPGҗkfFΕnF͙~I&_5W՘)ZR ] ݩrԴ4w550Ȩik`)e7aÝwЋb-7Yo,m+ [U)"%Э*GMcMsQWOQChhʡECuF 'hdQPѢ: O4TrhQPQCÉ'*YT9Tc¨ ,*Z1Tgap≆JU-FK!FO3BA'54X-D*u Y->P≆JU-0jh8DC%*u Y54xU*VW ?I,CHݨѽҠ-LUe5aт-aOW|G9ժΨX0 zrU*-ɨU_hh(թ!E'J\gI:qdý6[ɼ)F1tap≆JV\Bfg7+^3mWnNbH,0mTbz+zt&.GB6n[3/w/+TDZ:U9ڇĨʼn=a w$=J׺Zve~Q5L1 5j?DŽQ6ڨQ AYSbAEO4KSOMbC|Ԭ>ED%s>H!Qu ˳~RCw\[rdWz:ձTX[ƨIKBAO4glωA2{55Mo2+eksqscG-i*xl̎I>庤˱m)e|:??KC=&kcqZ)[r~y7(oW"o|j2&{"m˸6*ճ]m ROZ^MWFͨQ,L3gk5%?D ׳ic-{esOVkMzg+_TzߔL\Ga5t%?Whu=V ר ,ճw.M; jsYgԁ}w5E-[꘦fdǨ=ygg??}{z"ޅ2OG$wX YCw󣪶OU+FXZūm?>xݥ}ʼnn0b<̀r#5ը5~#p'khv<_>$6Kʥ}I #=PXB|~JGK֞f)n6RnBh6;vE&IPLǏ3uJ!+GϻuI5de)}{ZLGh~hPu˫xr$*IKU~6UgC~i}245Ҩ5fU>mǴ]rhs/~6j{^xxgtX;ݟmiOnRjUd1Y>Ә$x' ?5??S2cS-3w;KQ3$GsP-հ e/0d+5:qzJȨ*Z{/mo>Ksԧn3Z#k\5c=ͨ9K%ṡ͋bgΪ}.xt]ҏ6nμA=OsBdjxaڸ"jL8\--8zFYۺNU9ֱF>֬J5jSw? }F;n96ݾ9=ʊA_ϙͲ:-d7}<Rz``&f``X>Qkd̮N߻)èo+BJx5r1հ568xg}Fm޵?IllY;T*y$NJ8' g_ [S"o%Y;e2rCj|$5tYf_HUXoF%հ56:Z}\ qc.^{~!^i+їSˣmzكO~PZgY}PPyRBgwڕCL̀| 7v5Z)=7GM1B xr%ճ5򱖒+ 3Q>Ͻwz;O< ƿq/jt|ݥR6*}Č5:_U?ie~ahpks-IL=qj<{mwg&M.dhUW*QmX#kFi-9ڨe^Z\ߢ(PIu3`O'I޺▥߹[BSC1=YQ2VD<,U]iQMӔ*^\_Xh#yKX4U(TШ,ڨTQQy5Zqܩܺ3JxurQHޒZ_4JuchjsOF 'hdթ n==TJ9-udљ':;T҅QCÉ'*Yur MmM3d }SF͜`e8:1tap≆JVGC}~bԢIe{:¥BA֗O"%H@ nlC/+MA!1hT͛_V?؞ٙ{gΙ|"3gN~=1~(=**5|?:>1LP;Q_Vt}q/Fzx2TַWz_ŪM{3] AY/5ӺAͷZGEpSN>#BjPNJr"u(&fBL5_=P: M-EW2zc>)F6 -[ٳ(=P؂]γ;hG FѰerl>_QlU5;PX~jٜf)>L{`RK6{;`Q%T\uډMBqZ;WV4q(4)Զ1uey5,3,'?:"MZ2Z'bS qAu) [UZNCG)-S>(md]qG(rD:rdТFPDk#>߽k@=M&q, \(Z܊+Ubj瘎Tk MR!Ͷ+jjջL \41+VC7F&Elӟ^y>RT\TA*Cwi^]U[t|5utL`q*B˵&Ywgok:3Y5}elIYO5QJ}^sWWZ\VlF!Eɹ>Úc*GA͑XgMt "".=S?xr^0 1wم:w&w,c,SAWc:[SZ Lzj UjNxc??9$}iq(M+IW@*UOjwJK?(t "\rwE15T]Pzlo| Q/ciݓ<=51-ǩ8-8=F jBz0,e(?-)NWy(ňڳdVF[b*Zˡ(ZQe| ޺u+vF^زd_~S)"򥇏W jsm[{ jŻc"vFC+&-rt;_e,N'W~^0iUwmRYqZ<[pS< !dډ u8-'[gb jzWCmFF?E1j5*ʦvt-jg־cBR jrZ6WkZ$8–8-qE1q N2zxZ9jEQPKd]h֢/9jw qz,QDZB/Y(R-E*j4(N˽tjՊ&N2Թ֪4AMìyvs] jQj|Z8,lw{E[aˡ*Zˉpvh;erM&z2vm~Ka5ZԎfׯqjgMy2/GLm*De-)|˭4-g;ާvFÖek$uUeuhWwsFu-(b~[cZCn5Wkk>S?oXAw2/oΤ!kΑkܫ' #"Ѱm(<|G]w f9+3)d;T>0h2cgxw._8f߯^:EGkQ~;݃!ޢᘎeCCRZp?.W Q#j3(+<թDoJ|͝m:Ѱm`ǨֆZdmˁ*(mֻ)&-bOq/=||s ~Z J25Y+y6v]F [bRD@$"ubXlZ_5erQF [b j%%%KCǢZJ5D:VL=շhws`Ax*hF9CyI,4~n~mVc"vFC+&I]8}q9!dډ u,gQ{L72U]SmnA56wċGs+%Ԋw5y/A RqU`26ÖGMkEק8bwO-Mep/ZרfqTiI[V*[9Y0%YJGJ~A{c֠ͩ2vpv֙8ȳ^& i̭K5f/jomLPhNƥ#۷ā8 G1eEP.5Djم@PR^>}O]} j0Dp*$^sjEJ5/6jkG=YB* Tr|=η9]ou{  ">NieL97^a`pPM8h(|-j5 8@j҉ՊV%uP7..iuDFS 1jM5 kP7^]Yu6z5ՒoW)ʚ'w #j( p*6 p*ֳ@5H Em$"A*T Am$"A*TԖ?|Mק8ȋȗ>M?Q"A*TDD+^*K"?"A*TI ȗ@DPT5>~승 V@io_5/\YH6 p*j슱fQlKnN=;ckNį|oPIFj"8@R;F3Xʠ :;ouf3嵡xWFP W]@n>/tx2Tςdʎ(4& j*eD-,`8msm:1wSA RH먉pv֙8ȳY C"*i*x|~Ly[+)ڙnsB}Ku7v8Nƥ#۷ā8u[lUW2Ⱦj*ouf)/9Ԝ4;L j 8@j/ݹZd"SGU14MN6jezh&AfHcC(i]n{KI5H o!%١ޔ2EWO&ONHnE8@>ajM_R$lKܗ9U=1F-СFP هMeXR< '/)"g[N9sy*m8든8@A NF"NF"NF"NF"NF"NlloD|}{ 5ɄqhB$NF"NF"N j_|gg?_=yV"A*TIO_D8=yV"A*TI۠S$[^pth87g;DPT9NfImrZ7)ڙwX&E( p*d&IsP[5콾P*"A*TImP3/Zx*LQ"Țeh/sq7Sugֶu"A*TI8œxԿ java-design-patterns-1.16.0/facade/etc/facade.urm.puml000066400000000000000000000026701312550536300225170ustar00rootroot00000000000000@startuml package com.iluwatar.facade { class App { + App() + main(args : String[]) {static} } class DwarvenCartOperator { - LOGGER : Logger {static} + DwarvenCartOperator() + name() : String + work() } class DwarvenGoldDigger { - LOGGER : Logger {static} + DwarvenGoldDigger() + name() : String + work() } class DwarvenGoldmineFacade { - workers : List + DwarvenGoldmineFacade() + digOutGold() + endDay() - makeActions(workers : Collection, actions : Action[]) {static} + startNewDay() } abstract class DwarvenMineWorker { - LOGGER : Logger {static} + DwarvenMineWorker() - action(action : Action) + action(actions : Action[]) + goHome() + goToMine() + goToSleep() + name() : String {abstract} + wakeUp() + work() {abstract} } ~enum Action { + GO_HOME {static} + GO_TO_MINE {static} + GO_TO_SLEEP {static} + WAKE_UP {static} + WORK {static} + valueOf(name : String) : Action {static} + values() : Action[] {static} } class DwarvenTunnelDigger { - LOGGER : Logger {static} + DwarvenTunnelDigger() + name() : String + work() } } DwarvenGoldmineFacade --> "-workers" DwarvenMineWorker Action ..+ DwarvenMineWorker DwarvenCartOperator --|> DwarvenMineWorker DwarvenGoldDigger --|> DwarvenMineWorker DwarvenTunnelDigger --|> DwarvenMineWorker @endumljava-design-patterns-1.16.0/facade/etc/facade_1.png000066400000000000000000001266011312550536300217450ustar00rootroot00000000000000PNG  IHDR^PIHIDATx \KlN"GrD},Db%--Krc)Ea]9 B$ˮsˮu*2ٙIcf~>ޏ|L<=|?zAARiA[ ? E__ z;5QyTK[xʨQWqЈ#TD jih~"dhR1pC),Pn2k|\)*ŭnINyg*_=^nU6O ҈#THji8 TIyVא;NmP#zV,Id숏MOHMM4lgl=5Ʀ>ة^ #؏w'۠hW*Fٲ~J +GHHqʑGO!_.y e

}ΩYej\bbL̔P#Nަ3˕36uߣի[AT15q h,Ư^C>݋Fj$>EB(ʨ>zkVggv|sc we؟n꫎0%}}|./q>>]*WDnEV9O@'zK˖𐿧(P}{w>-,Lֵ3K+ Ou芐v.CpǏOm qJ&2rKv^ZhGk桯믝8:yHH@ժlYQ'df۶NlޫQtKIn=s@7 FVш# z.áiH>hPbsaw.g1zG" :Ԉh53ƏEV@e QfסnchXwHtskIn2z]Rppį(izX) @N e{._2޹eAI6)cğ}V#܉8:$3oc]jP'KSS#L0%eVոxXz줃| C(//:w\Vш# :AՋLlڣ\:8K(4 .³YHw%jd>%-ܤI84([Z_?p#;{:%NnoKEoJXoQ-|B=ܕR]лlѣ?r`[2LU|`'ȇ̐bDxر!KWd8!F !Åׯ*Z_T*qDiRG 599y.zB?dϚ]([vD͎󐑠àc8|n߳g7URqF|LSKW#1O|BM^ޚYkOq#O4, 91V4[-!!TF|b>ozbc)R`k=ANFE/)RKh `驩 tժw}>uG>m+UNeؗ~!?il2 '{l˷9ҥ$-k?K"4}zZ@/jdo+Q`k=AN99PFV[l/WFQ(H ʑ!). ~1\f{bL\]u]֭4v[9I'9{vrwo`+}cD*e { r5"z~m’Tv](ew NMXԿΤ] X^R]e##F_k>=T,> oLūW0o+fj|J^҇ UJVш#TԨ͠ qKڌ 4P }BLA#PR3*Q)4P>I!GP3*HM]8thև OBA#PPcagT`ٶT)}v և OBA#PPcagT$.mJ?{ٸqazFGOncSi\DU7!5R7h*j, ;B`wM%A=\Zh~&PnBj9mGѣKs|Ј#TD'Xure$߸ "E4PuR|xq$??j A U>wٽNÆ5b8W_~ۺu'Q\g6m e3 2h*j,Ԍ [!bĈ^,wav1inj}~ N UE4Puq_Æܾ=?+;qaF2w'N\߫W;~A5>{ԈLLmۜ] ݼ6hP7_ή:'FEX F":F03*,_>An,0Q9h+[bLJ@Mħ={Ys7:ɫWP#YDHش!Ǐw"/(CbڧOG`8OwaVVtVڃoq aa# )5rQ}}pGTYDU7х>)B儷*=͛\+PN/qЈ#TDXh&4m['3\DU7GНGXrOR7h*BjPPoЈ#THUwa%uNMHF݅$zF"L"vrE(FA#PbFM;@U9ŢORGFH@-F 8BE4FvjpB*Q5ҴB>IQF"U#M;@P)4ѨiHޠGPihHa$ݽ浿|mC)t} 5I jڥ={iu0?z`A#PR64n dQx~:6711B9;o8bٲ .. ׯYvFj۷Dњ1בʊnڴ/qa_+_{Tj U=n\ {x~*S4!5j3Ϛ5ſ@ʡʕ@yQQQ(\y?#ׯ֭͛Q޶m_jj*{0aQʊ'`ϞyӦE~f ϫ5͛7Ϟ={9tu};vի(CliiiP>s w ͛w80qtSRRd7l؀ի?UVdhx(ϙ3lٲzJ8q2!]#Fၭ[;ĉuBh'';(-B\ [cx+?v,5Nw޾С=sy(dfpt似߽vvРncx[ZOsC+gxVglnaa45&%Eikk7q]t)}ի[-\LJE-l"5ʿ ÇWjոJ hÇ'O2٘Q'c?}BR kq[׮]UfR=$alv߾W#Ѯ]hdd*Ǐѣ +ÈX$Fm[.]\Xӂ/flX>\Mق~= zw4mAjf@e+TP' ff '!*בW#nouTKNׯsBB(1!8cHڲM'&޾O϶X?)i.!Nǵk)?e_yӧ9ɗ84w#G O48aop[W#!mopijo`P|ABC͐&lC7bWcT?q 5j3h2 FC$^G^>>]XLDH&w^ o b\܌kFNr*aw'__WvC`  <!6兄\2>~t;L5Ξ=ͭqc jD^N"6n V["fA5 ˖M`gm\MقF)Us]bbЈ#]Mt2BO%H7+Q)?HF%K˕3@X}Ҕn vy_{y[F^}Z5U+(gd(RcZ˗'"}ܺuw>rg7yxt<́gQPp9k(fA5  x1ϝK@y3g\MقFΝ=q7w5FB[P֨͠%}ӚoẄMʬȀ\\H=0ЋρnJsvwtC}bg2eԈ@ٻw!( *rrY) hLٲUʕ؍##GTUWFEPJׯs(fA5 !6d޽tE7[Ј훲I[9ɷF-H Q'vc?@A#{+& R}}C P|fy 6[Ȥ pcMBzF"Fm TP,9Թ]&6mo=485,4P5D1wML DGǨf9H q|v[T@UBA#Pu͛\Jm>"4p} !5R7h*/T_ڧOǚ5\15s} !5R7h*rb@CL6՜9ǧyϞmoޭԭu*h*HޠGJj,!+=yqT|Uٯn'Mp~2+9Mz_rHQǫ7h*a52bݺ8p Xtiߋحu*h*Gj!/^Q};w 7\rW84;>!LMy E?(G:T!8BE>FUf9@tή:|r>ΰΟOحu*h*Gjd7Bfk25Z[[D5sP>;b;v>>j9߸KH|Xrpj!>b"ӗ{,W@)X[T@UNa.~`t5*GDDW_u0ݽW~JSܻukio_Wvl~ی==_Zջ`7XN [kr8[j zΝy@iTfTpJz~b|[[[B]gfX9-]:{@nOjDZ ٳLEc*U~=atɓ $>8…AH(R4 y5)Lq\R#A㍏借Ty%[T@UNQy;u233ѣŽ IlQnjR#A|ڙ7S^i:4PSȜ`W~@ ғ2 I>gG}8"b$ Ӫ۶QnSAU9E9;S@44,sV25IN4!S+Wd--M#, .Wb`{8O+$m1?xp9UfUjE(| Ej{&!!5bh > $5HUw)o5RnZ2U *] 3s2jdkfeEK⋆C<ܹNrU) S#Gtqik?'G`E;w^[YW"aeddhcS ^xq+5FEP6ׯ3 xH4PufHv NI/C=!%~xHTI#_fJBЈ#THUw)}FAz.eQǫ7h*qj+dkw4PSEFdv>^A#PT#ȶz_~/AU9%Y"h*RT5c=:i h*HޠG־PLIP8p ήz**T0mԩxD V&2e 7ӻwJ,pPMk@U9F 8BE>R<dkZXdd,$W/^[f cw̴4PCjPoЈ#TDU5wsgl474KڷoZ…AlsmnjƶNNvO @~egZc6):3;WۤxXUdNs Ԩi h*HޠGJj+!}BHz͟noҤ9uzh,/mRp-{Vғ ̞=tildI0*rsWs&(oX,99ܹj|gDA5rրrƻw6;᭱%$h*a52 ,}{̡:8;̘C&>FD;%$h*a52ˁdjX@aä'7w>Bj~|"0>~r5j`Z)oʜ 9%&_dI0dκS^Pvcr JHM]V#BZZ'휦N{Gȇը,(8rqR M(44099|r자lzx~:v Y\րrT?2+;g~]~M8MZfS&u9'N.>iw qtg9PF>FIӰaҥ B|e?OLE5rl Tf5Ӭ:(V޲% Q@UNQ m!xU+kʔAj<|x\١Έ? E#ȑ}OH{lv8]BF";$ d?d{ajNF Ѐewb43 T^g9ظ,Ѯ%$h*Bj|>yfںuGEg_Z>sO}4kB}\Pk ՠB.F P(BjPo B.F P(BjPo B."PYc R#"QEjg?G711B9;S$*ƍx\Aa֯^eoj#NBP(u5@iDY[[QigΞ4x+oh؏hҋGnإ R#"QE'Yn +̌ڳr9aРncx[Z:9ٝ>LJۨQm[[`y5lڑf88ǎrY)Z>p [gVZUp[`9/ 0l{ï(T B.J#~_]g~]ʬpHƠRgJ{w^T'TH9 .$B'N{`|nJ͛gDD4MYŢcGg6?m<%׮@%-?޾ &ՊԘ2֚{ƌ!٦+'%jŊ/eΎa>ԩ~5mB溻_zz^(T B.h{H$1d]AiP#!'ƥK'6n QƀOȏh_毿n$4Vرc˨Q}/WK7.11SkEoNٳ`kFvR*HPG!tEj>/"=$boHگG:F'NC9>~fu^TpI?Q%K˕3&XpaPϞm9Iվnϳ*WSۻYɝ;{&5oOkP8xp9,UfUjE6"LMo䆄4jT:(NBP(2Nku_2#"4m& x(βe`x.'gsQQ+T0,FF\\Ϲ[Ҝ;bglΝ?о}Uyy6ﱕ9*2޽;DF222/^IQ 5*B]x#h< LQe6KT LnP7 ʛ6e*isaI!FBEK1QɓG,ۼvN۴qz5E,Aj$T: #5#Y옻w&& R#"QݥXP(BjPo B.F P(BjPo B.zFУݩu(̚5KM Aj$bLAA[AbHŘi!6HQqㆵ[AbHŘ˗/׬YSۭ Aj$b̹s F(Ɯ8qI&nA R#AcrrrZlV 5D1&##cǎnA R#AcҺuV 5D1&))Kۭ Aj$b̆ |}} F(ƬYfȐ!nA R#Ac-[6rHm  1 ,7n[AbHŘٳgO6Mۭ Aj$b ;j!6HQ?~ F(ƌ5***Jۭ Aj$b̐!C֬YV 5D1wÆ nA R#Aczm6m  1vv+Bl ӱcnj m  1-[v+Bl ӴiǏk!6HQ_i!6HQY˗ F(X[[߸qCۭ Aj$b F(Ɣ-[6??_ۭ Aj$b@"H==~h\D1HWQ!5ħAcH)qER#A| h\D1HW!~zwׯ_ߺuK!@j$ 5:tu5kիܼyƍ}?߼y& 5D!pss;q NNNȽPE!33AͩSufooFk-[ܷo ޽{WfG <KkԨ!5bUT9}˗/HOO8+V߲! yպusN(0???+++00p޼yX:ydI8ɓ/_655]vիW}||\]](//͜9355eO>m֬Ydd$޹s$>>9qd6ټys۶mݻw9yEFʨqϞ=_~%+=pS{EN:|5j! H! r]"+W\ʕŋo߾K[hѷoߥKBoUV}… [jŶ ۷osƬjU9bV4Cj$O+(Ɛ S@ 1Fи"b >4`W#jg"# 5D1#888((y5F 5D1֭[ldF-,,X AEH>qdj |5RHjH8B2!5D%P#vHQ\AȲFm7 zDIhm5D@z.BGw!43B KH @FB3P?#@IVG 1j|`۷y3gQ b/>;;q:Z(Hf~F-͛;;Rjswuu?LwVAA8uעx | @ZQ[˫J*1.nq٦M1}zmܹs^@j҇60(u^ʹ={ɨQ~^eaff\F刈5h6ogWOb$5b!4FxhJ, Tʫ'֡ "iٚ}~j8xpy͚UƫQp7n޽sLL.^*_G腧'Hgаnmq_(W#Rg7qg1=|ɓLs |h\{HJ < !XTbbJR#!2b@_ЦSZU?{RFo͘1^=kkKܰa-gۄPݽ'Fp55(fi5 ͛ܩŠG `54OOICV QBں ȑnZVhJ2&fʺuߣڵҥ ^ʎQ~MVlР& ^~LNrPp5/_f+g Z"N^{ HI btdh<+IX~Fx@^}h͚uڠ~ =r˫=D`jլ'O2lmOgrp];N*kClN~ʮ]kl4^pFBP?#Ā 2-dxff [Ҝ҅/_ǧKXYj|LeI߾{2 t6K߲eիw{);ĶR#Ib@^!3vښG7.o5@ѓޣW~ FMSZߝgZ[[Jv皰(~l ö}~^bhX5e5))G6sdoHC2jH81 FcǍX-=K.H=7Y&NΜ[ԋGZj]YI22q{vr(++sx?yխ[iXozOժY5hPa<ܼy6gnի]J5jT?4[<eHYkժloaaҭ[K}ʈ˗/׺#'Y3-b?w%xt<#_;?tӦPCPg"ty7oj+[bpҥ =ܻw1IlFBP?#Ā] bPl:,%,<$\|D ^Mqpe߽lP?۴q;w.?ML@խqXa(jxfxPR;͛;:+4@fsR#Ib@FB{4uwYKGgti<3f!\Ex6 ί=힯a7r/$[(2<<}r'֡t)i˖06 ;dI0T#&r:#[砌 e>2!.!!eXzöm60rG2֫g~ӦPN2)ʰ])::䍲[?^:dۯXBOX˫=/c殖IIs}K& 9$1 599y.zB?dϚ]`~}vI}e}{Ν=H N2M1 ogP>Q.l;%(#4i܉ !N- G>܏rHHH6;1&fJ]Pxq+ USJWV@'^ (ݻ5/:*N2yf?y@BFjJ% ٜHhgQEf'XzY.xD>*xMǢΝ?/ZQfhC+Ul((8\Fe4R_~S+%G믝XdgW)#KY&͞T~=UU_T1ðwav{C˳qkNCyLP|99K)4?HFڒ;L(o57/NʧO!;8}:>'gU~+pkMW{DhcSbv-ON4VcW(ڕ߻'y PI_}{$j^8K\<5e>)5g+iGj$4 3B 1$etWׅ㾙w/flO,d֭%2I!3*2]LBzl. jذ wVҭBJ4G6>׊ҕ+;P uCCPf8rOvp]6dǯ/+EGGgYIg ƍwEիK"njf_&><~۬ 6*jGj$43B ȫikCW (Fڋ+!HkVط'NW`o+t}9;_a@7RFFf}_2Q'@7nbDbҀ]΃ 5l4}2R}8`"3ͳTɮy57U_]MBB(_{V}VD˗ONOݺozst݊  Aj$߬~=Cϗ}w`QHtTeg_Kj%xϳ]K@Hf~FEjY @FB3P?# 1@j,!Aj$43B KH @FB3P?#Ā՘>q3o?.=:t8?" 1 n5xq$??j=M!jYB ݁!tY_@g)(8}:yzK [jtߋG?@!,l"R#A@FlB+:o"}y2[pQq R#b@H 5!H%$Hf~FRc R#bXBHhg#JGk%gУdeF~FRc R#bXBHhg 5 5!2]ChgУdeF~FRc R#bXBHhg(96hPAj$43B 3).) FB3P?#@a(ϟg=x-Hf~Ftlnbb055rv߲%L:v-MjIrذ}{/իgSv5/]J~MgK70(Ao}AY񸂂_&5g(L@DY[[1Oj,UJZ57X `ő7vjs|ӿV^rWfCܹs^@' +̌!w̙ u38}:\`׊ӗ`LM׮_(V(yyklmRTfeEWZ}'M" O϶LOȑh[ZloIo߇[ٳ7??~IBJ#~_]g~]Jmnnee4o޷(L<bN\B"AZ.@Xm̡ Ol}~jՔ;wD}ܸX"A5k*q[j;ujѢU2_ n+x$˗~=*U* D~L,rqi]ljjvWS||?vЧO"Ō@қ!V((8̿;:ʤFB~FEj wح'cG4Rzy5")]ۼ#Eҥ>Xq7,†mܸ|v~ɓ dKq6D\'^Æx5|]ٽ{]ϳ(Qnsw_#C8ءϞe.\ԪUc&b~:8hZUыHzBSzի#53B (R,Ќаaġ0@?kL(|uwb??wQ^ H}~Hxx "mРfFƲaPP?Ff,tpPQo*:&1YS ݇!fı;'Ib"!*1 矋Vڵk1ݻ{W2ăAQ~_IN%B3L^ʾqtq"7%jV{h3|x/BP lQM @ynn-X߽ O∓U@қ\bff,R%&f }b@%H7+Q)?HF%K˕3iRX+[7t[Z9,\Գg[N>zy[F^}Z5U+"$ס37ur5>{;/(82…_Ph^N*+gnBFPʊnL<+`aara?H>12Nku_2#"4m& x(S#|r.. vd$"ܹNrUr\lhĆИ>{?\l  ❤D[~:3Fhݭ[K?N311M9ƦxVEj$_"<+$53s+@qH>1A;oPew/xS=Za+6C]G mܔ7m FB3P?#ͼL]&6m^M)If~FR1wML /Hf~FRc R#bXBHhg 5 5!H%$Hf~FRc R#b@gсOϳFCJ#~_]g~]ʬ*V4KN8w.ys5ߥw Qњg/], W;{LLg"iJDEiL QɚG8f7vX>VVct->~Vl_JeZYׯdbի>|"VH(CՈCkׄ-]h,(P?#Ā"5r  ;O CTG>'deLL Qpׯs>=W74,s|"ڵJɎE&N>ІSk<=&$&%uwo'L&5%gPFC$^Ϸdj^PkBH͛;H!H^(*Y۷yP#?6+;5"z5Xzwa-K?/oNTN^K_CHD !qXrxh!{CPhܿdd,o:tpfj^Pk:ghh ZrrDKa'1 Vs۶́&kO ߍ@?wPjVUVd_ Wp-тH7ID !\iͷVfDD׉fkk x^Pք6UaC e&U8]N*EPZʖ ܇mx*ܼ<\9媏O޽;(iW` יHpb@7vc?@A~D-aPHYDa| )JjI[6n 07m N/_fSgHhg(O=DB6k0$UjUIM]uHFx6]&,l7UAj$43B n87o[}Tg7i_&tn6Gp1X!11\G 5!t R#bXBHhg 5 5!H%$Hf~FRc R#b@4j|<}Aj$43B hRwQgUҿ_xlmo5n\ {x~*[]ى FB3P?#Ā8x=XyӦE~D^8r.JR#A gPƉ{š ͭwF2'';6Exx`l4f88ZxVZ˖[rf GG;33c/LJx.~~VV={wtwo4??jՊlVm^[;w d-,L<=޼ϡ4Qڶ>FPgP':ctbPf(g޼wVN w #c~}Tњ-U\ljjvWSZpRR ۷G6 T!1x cyxJu 6o KAu޾̓ح㐽-Z4MԪUو'c[xq+dXK6`7Yׯd 0mJs…AH(RCʫgBI:1HB3B@6pLVN~:'$"$1cLcmm٦SÆqFj;;ۿy#:|\uN2H1Fd|=cS@9utg[-)i.syPP?@˫q`(7w5 T!fı;'Ib"!*eVCv1BWՐ!^\܌kFNrzALXŋ#[TԻgSRw Bݺ6. 25"c'5\فի)ffҭ߿KLxۻw%1\"!H h(JRqE#ZQgR$+A8G]!! pUn꾅$vwvIvgvgϛ7of}ovf5X:uPvMت۷w-Z[1~t\.@3yL L J CsI?d*xBkC?kk Zܹ#:??OXLǼc`fw$`uGкu14gՁ=ffeUv~kܲe:vD{vqQ5lz $mlX3gc` ީSׯ`IH hA ׊o;,\U˰{gnɟi֬˿{7ݽfz.;>K.ez CRPel-,ΊŋUbφpP>glE,aiY^%䪿.]ZrGE 33+\xqr,ݻNH hA ę $ ?x~SLQ7_q,(S_.)ȥ5&[/۷l) 5 ׇ8kTwGZn7n$ Hg)-[:u*>#c) lڤ(QFH 3`\H,0 €tFMda@:#Hd&BF0 F!Y#ARY Hg)@b֘uѣ €tFWQ1ى Qz[||egg`-K`BcF0 )Y3a *N޼9tNLFAKRfkk>Pnh5˫!LO_ieU׷9C֨Z}.m6|y'NNs6WϥlYslءCSɓH7mZ6dD& $0Зj+7N*5ڀtF4Xc}7<2&s>XT*p gnhеre{d^`aaj7x{7qРFXF?[hիׯnkkwokYYUY||(wuf^DZrgu̙3NiVuzٲxn˕ض- > &k$ t3T,=mq 1(e^5|1rdw-3k-k43+2Gɍ/aZX3IO؄c|8bx{[{n=0geSyp^͛DH hA PgŦ O G``qfi 5ahO U?'3iҀ1czt:UY1qbsvvoLX<#v;~|__6o:C1$'\NH hA Pgγ 8V1Ed*p?LJ2k:uPvMX;-^ [^q UkLJōVewGnH*[\1=ڰ9ͫgO5kBUY?nݺ0FAR:k H725,2%,*% %XT -ݙ50;sf}nnfXX L1{CǏf\nH[YQ߱aCףGW o"΋mlDUsxTO#Ft@Ns;WϥlYs}RС) Wl<ًtӦumk61q& u:U+U 'k$A:#HS辛Bv^9 ,*tiMلȳg74lf޸r%lժ7n$n5d;vN06?):v|?{ʔ1Ef~.VH̙3;ǧ[յke˾ Yl{ 5 uӜn6X`eGs&\9Yܹ#1c/nfk%5}} 5;;)+렪5ZZfbkWA"&f\&>MC6[;danǏ=KÀ|070jҢE}v޼ FA3Mi/"2c}B1k9;7\aK'NFޒثW[mJ};{wDb~ej%9boKGrDUmaC֭3:th.0ꐐ8p*3s9Y#A Pgγ 8V1Ed*p?LJ2k:uPvMX;-~SFޒ5¨:u4sbL^k&t1)i7Njƍeѣҥ)Hn^={zY.0~uad"Hg)@5$L~T,aYZBO˖aZ9>773,,N(Z#oI_Lpzuׯhi^#W3[ZNa((ҰѣC޷o{Tŋ6ljFOמ? aIH (tF4<E'"E2*Urw8pv.Sxq:k-YL~{eFpʸ>ezz~UaiY^%䪿.]ZjLѰm)#k$A:#H_8+Wf#@*8Ѓ4ڗԒ)*pݺ޽۱\0}BF0 ¼e:FS`UE7^b٢Epq#I'Y#AR@!sNՓG9^_OXz~ʦM]a Hg)D>/N$k$A k45 5 €tFi2MۉEF0 Xl¾`+T枨= €tFel(ͤgҌA'Y#ARh{EB"#&%bS'eʘ)PAAݿӧi'OؔEB&):zlGr%Z5G$߿а}dO5gwnH*_ѣݼ 9*jC;uxd%J,E5 A Pg?!hg T 90z8u))Rn*( ֯GeKSL_s玬ZYƝv1C1aEb/jI޽ ;;k٧S15rl  €tFYc)#EXDR16Sz.NcdXv-Zuv$,-K_e:9VXMѽ,,0^TnԨg9:>åJ_8ݽ&[uV⬍FF0 u<ۀMAcXDR16}?EZ{׬ m۶1+ kW,ebWGg&edf=A*yJČ>a_Ι3B]-ղc6mѣˋOdɃtFYc@4Ϙa)aQ)aHx.LbAAl/ժU2L%=ڍߴkCmۢ:u`&'iM&̬{.] ,^<@^(FYY޷orqqP ;6E={Ÿ~ZsY#A  x%iɡH`QLdPrrL<[5eJ@ ֟}Vۻs/ ֆU+%K";|xˬ_#+8ztER%3"`VX]-G8?[ҳre{7??O7N$Y#AR7F&d/o Qi_>v?vE&mk^b$k$A 070 awnHda@:#He溺];?Q$k$A 0(k$da@:#Hd&BF0 F!Y#AR@>Q Y#AR@kdRdF*$k$A w*c-yfҳgiOe!#Y#AR[E!Cfݽ{Aj`Z4p=}z-˟7/͊%ss3˔1}{.%  €tF2 vO5%ewG._jiY͛Ck3llʲ9e+WGΝUq5޺Ctda@:#Hq̮Cq2ѭ[g;w ־͙ƍF u͞=j˖Æ}9|xW٨Q=Noеb ;w3dXX 6䧟r%/\$f͊**[JVƹk׼7b}أG8CBz::ڶj}̡C A `Gʘ(YfgG˿hWNO_Ywd lMΠYƮ^Vhxҵk&Ę3gD szgc/qJͤӿa+V/^X`/X&Jm/^Gx..Nѣc^޽ϞN03+1aB?͌` uӜn6X`JZtf͛qJ“'{1!U|PL>qD`$nkdsϟԯ_GĈN{F#ѿ gRc+Fɒq#Tn\$5x1K.aL>`bb>paӡC1Xx:y׮ұcSu1Ïml7dd# hx kŷ.I OEJ&O0jT0ͥQ c69qbѣ{_Cĉ5] 02rE͚ ^wqqb?^K6$qqM+++ iq7op~ȑ͛+L dC|QsrrO<)VTba̙H 4cGJΞX1*@H0-,,q1XWށ_Gxnnn\\sΝϝ;'V`)`3g>kkk;F%<~ww!H#G전ʚ={M@@)Jlɀ`XreŊo޼Y5w6q}w"1rQHϞ=Sܹs`X k$4ՔP~ǏtpuzFASM3gĎBR9J k$4Քru" M5%p^*vA@Hh)a|m&uY#A7ĎB)z{{ӛFpQz@.]n:AFH(<Ν;]TGeeequ{{D!FBp ''k׊ hѢb }?~Ɔ^0Y5 ҭ'!͛ŋI`Ν;_bBd˗77n؁?nnn.v ! FBAݶm#u+++0!9۷bBd|ݻwzԩ%<ܹSB0! 8P@o{xxzJ@L׮]svv; ‹/ݧO.v @H"##ԩc1Q\xZjbGar}vŊG!FB>j*42ԪUK(LO=|؁Y#A[ر|4烸8qℛQ(RRR*Tpe!dacc/رc~Q..]ZzGA k$vϞ=bB:tYfbGa |؁FBzƍiiiZ; ƻwk!dM… RRRŎիFM2E@Y#A-?ޠAI&_$%%AWT>/U5//?زeK.]ĎgϞ9x؁tF޽{׵kW4bB֯_/vw^zI k$`ذa-[r qqq}; ¿ZK51uT77O˖- ; 0~MRWRJ k$hyTr]!c…C; ݻnݺ c!d`ggG2d̝;7((H(>0a؁tF?HOO9q؁4!22rرbGAVj*!d#߿_@y <<|ĉbGAo>!d˗n*v _;A-8w<{؁ FSݻwTl2!hcFFFA+W k4i<}mԩbBAAAs; B mܸWP@5.<==[!CzW_F FEnnnΝSpƅmxMqb#Y"00M64ѡO>qqqbGA =rqq11iҤ <\@F=֭['vmqҥ *! k49,\z;BA_n޼Y(Çmll~w!d7:88\zU@DNŎ?lذbŊw; k4!ݻzƎmڵK(FDDD ^|)v @h*_˕+!v BUViiibGA(۹sgz&(@hpB PX4kСCbGA(޾}Mpp؁YqJ*ƊAO;&vǮ-;B k8Xv(!nnn4qQ㯿KNN;&5J_nڴQ3ԪU?; BpQ'OA-%޽{Wjժ]xQ(Ŗ-[oݺ%v ~5J}m߾}vv؁t ggk׮A9s}0A(M7qPBzs\2 رcNN؁A(A̛7f͚>;aeeEWV2nӦ M g k֮]t !t NJxi:uН;@()ڵ|gϞ;PxqJLbv횃}נ?k,Zd'ڃtH?ac(4) GH:$ꉊ"k$jKj@!QO$k$$ CHX(>yWD!5IBU #P`L=ڍhWW;|Hh5+֨ ͛CXZn5яWR/D!/Ioq[cnn39Vs΅ҷooF"UzMG.ӅP~e!).Ib$KS!M05>}6o^P~~W$hȔW(qq\]+LLCmJ&& -Xubܹܿk<%!;;e+V97a#x'*b$ MCқ2kUp|y+\ 6iT V?i ӌڵeoߢʕyc»ڼۃgn(Sͪ9l?|8MCX4&h 4DћYхQ995g 3g?&?.{,,̞=K{*ҲÇ8֫Y({غu4++ țAm4Ms(4&h 4DћY#<íJ/_kTʻwG&MP5 ׮]maC8.[Meߜy1:3( }܏BCnn}mm-˖5>+b8(Vo4&h 4)ĕX#C1fcSeK~zdd޼Ų3&ժUWZ&ǕVPIn^={zY*4-mFR%rУqpA P4+SL8՜Lqi"M)`h:$%-#F'ְ롚߲W_3e>'Qٳ4 8.ZRɓ*VZ{BwFf۶! &$ P&Cқ2Jk@tO@w<ݻ5sAgڴ!KnDҥ%Kk(qܸUs0sBJPd JOZt#0 _x@!&ekd|x1jƌ6؋>GV1|R=I#P7PHI"ID=XRD4z"Y# &h$DFbAHMH:$dĂ$!tHuoN:6>޹>H#G$$LCck 1dq 1" J}!Y=K;~LW|DKCk*\TjdjsK @ҡͼxqݻڋP*s5Xiqݧ 1i/ϼr,cJ(V"Y7l>LI_Ve3ݻ=ܾs>)i ;|PݽfzbE5|Ѡ$ S'"|ػ7Z0-R6'P$ ӧ׶iӨL3sIՏ"[te*5;yݥGǣxcŋ,]]dP,iWOs,0~'NN؊bÆ}}go_9[L(ER ^j˿?}ll֭BjNܹ#JH1>>Tvv_BhC mȗ5 e=2vϟ웽v=:#e\3NIܿ:#WnV8)KE3g~[n5)|t~86*Xd@С_Z~Y,ribl1VVVeWw>1_X֮]b7NZZF̗/oe{=gL8ymiܸ1֩SMޫW&b;ošB8BD-dy\ICPXϞފFE ke[ CU GoFrǎ\4ЋgsȦհCu'Fz\7wcIƨj֬ P1\IF g w!"bK6DI?ǧ Ѫh*5zeqXu~f(ciQ AWA5MFMfM(ԪUD]Q!]&2gFSG8Z,rWʕO>U~ZJ{$Mi\ sҥٳؐQ9jOY]_Iiolx :SHCFw[r=Ck-[[#5R,/kNb_~YL k؜|={zc{5RؤCuҍfbشi]؉6DQ0K/o DZ56;.aV]|3K56bxy;M"gh-,0pl鎿gά/+iZ||(8h)Cin~~9rdŔ)HX1^&+>} kyp؆s~]0uEkW06 և>+Y&T=mx2@F2E?֮]CfȡȬ^ݹMF/]”akkɶgQF~z([>?f -"FVM!V(QJ!(ը.0HDwvl}ч\J ImyX [d;԰J]x2֨tV) 6P`"<jdBQC vOs GZ}Bel>!½\O4kU3E2v*WŒ%?BN\ӰllI&$H(F%Ķ+vUؠCL(Byz~߷k׼"-nH>4da}0X۷{CK/ XLO_\D렆CPQ]`J0ƁU~uC0&I“FlO_ywadQr%q~FEpDȄ) 6Pxbs,~Es.f5!8x0lGp? h8*{aIM۽_7"_/ h4k nU8S~T'd}"_JKƷ .E?fZIly:X[[`5vl1czqVY8hӰ+l7hP|ccT&/3ХKKv+yz5V`8ӿpJ5 L5v[~fdRj$/<k[Ӧ 17/YHkT՝@Œ燎z.Lܝ.u6Pxb  boV/>EU0nê=ڠJhpp&ywY<۲nKi(ɂ; 66e52i^0Ӓ[ ;/n=ȓ'io_}!^/ N .g~z2޽]>z[)یJP6 Fv=O-! L5kICkd& <^9c: y0Q|{„~W7ҡ(Νdڥ*lC`K^QHf0,*Z$AكV勤CӤ"k4,z޼wHM1O8cǦ+YYkh*_$&Y#Q[RD4z"Y# &h$DFbAHMH:$dĂ$!tHMƌp~%$ FAQysիB _|\cI$? $$9)XcN!C:?:+];thW@RҬ=NK*Cb=1;"b0֭3Ӛxz~D6=ڍZj֬>nݼ:u_:*bpr]z{Vm>ԨgF`H~CJN;a$Ο3nÆ})O>ǩl ?S/߇ۃ'o <`_6o.maSYq}(UׇF`d$?!Ih%'}k fM(ŶmQ,駵]ii {?k:wnY(/_3_ֻwemGFŅs'O>>zj(U(m,&IKJ!INiIwfozu=q9ǎ-ʪLvvr u tط-"-עEM=K,f2b_z;sf=:*:DX7X'#IrF+9[#ۥKKtpY|77HD&+R%;%z>I2"Itxt}עsVcXÇؼL3ݽƍY8Yh5+֨ ͛CZn;yVfҤVVe*UXBn^w$! sC8681mgg}LqeѷooFM&C#GvfÜ8\ k׮ ofDFuqqukT.O9^>|޼ `DM 6=}d'۷wj=PF:)10hҝ@feͯ^ݦYNTF֘q̮[ ʯЊ'qڴ!͚Crj$ HMrudn^csd<,}087ILz\p)Du;6E}*W=<}xٹsNժJOۡR;7}Рά OqϼUs]lժ/|W50,bVѳ+d{$3&Q\ۜ7v ȝfץK[ll&$D=aCW'BҡuxxʕvZr,m½YiLӜn6X`eTO~Xݻ#84iRWFἠ Uء!?&208A <ٳ4,-Kq6!B)k&hj׮ď?Nu=Ss?jS/U+n*E׏DM)j##~CLFQ~QnĄQ58Fy3yk`I`ZZX ś'BҡuxE<O&.]Z%o;)$'Vef.WgF1[n6's b苡:K9~ ڋ| tjժ qe `,u{͚Pv=>L޹ rxv1MsY/U .N 2HQRt/P!F3ox{歚nA5a%o e*n~FM=,]]a!1qTFklY漙kF$pA(>>PyjX"$V*X*Ɖn=q-uYiL03odjXdJXTJK!SUO Öpiӆ"[[[T0g?yV/;:حK ݯljƵSƢE!`/w aCrm-Qݻ^>jU*~_ۻ ֈf; d xS3o\u'̙g:UU*&@ÆG(bTu#0'hng޾`Tiӗ5ShQ R=<[J6ID#S`{>7SI2ҡ15F(Oٲe(U:l4MW&Is'yѣ2>D(#9 YcdĂ$!tH!5IDC 鐨'5 Bj@!QO$k$$ CHH,I"ID=Q:֨iĉ&# OD9uKFuD~g=ssiM I:H:-%b:wiUfRHCFҡΩ/k$k5dyCb2M:w/@ZMť2ďwkZVN7G$άo05Ҋ:N4pvn9sF\EukZDu$<"t(tcLra&n1)iVϟߤ 99e?n,RR$L]z+"v xcް!;>>TJ^7g#nQIy2_|\&=yV|=TUم[,9<ً@ҥKy{{7Y{e<|]-[t2׍ ᙲHCᥥp,㒸׬W]iӆj|YH,\bn^elms^CLkWbBJv9f]&\.LKe''@_y$ tH:@Z|y\󒛛MQZ9w4%\Iػ77n"E0$ H:Ci/؜֡4eJ@T԰*Uw- Cm% O`yI:, 4.0.0 com.iluwatar java-design-patterns 1.16.0 facade junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/facade/src/000077500000000000000000000000001312550536300176225ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/main/000077500000000000000000000000001312550536300205465ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/main/java/000077500000000000000000000000001312550536300214675ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/main/java/com/000077500000000000000000000000001312550536300222455ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300240755ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/000077500000000000000000000000001312550536300253005ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/App.java000066400000000000000000000041201312550536300266600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; /** * * The Facade design pattern is often used when a system is very complex or difficult to understand * because the system has a large number of interdependent classes or its source code is * unavailable. This pattern hides the complexities of the larger system and provides a simpler * interface to the client. It typically involves a single wrapper class which contains a set of * members required by client. These members access the system on behalf of the facade client and * hide the implementation details. *

* In this example the Facade is ({@link DwarvenGoldmineFacade}) and it provides a simpler interface * to the goldmine subsystem. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { DwarvenGoldmineFacade facade = new DwarvenGoldmineFacade(); facade.startNewDay(); facade.digOutGold(); facade.endDay(); } } java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java000066400000000000000000000032311312550536300320760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * DwarvenCartOperator is one of the goldmine subsystems. * */ public class DwarvenCartOperator extends DwarvenMineWorker { private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenCartOperator.class); @Override public void work() { LOGGER.info("{} moves gold chunks out of the mine.", name()); } @Override public String name() { return "Dwarf cart operator"; } } java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java000066400000000000000000000031751312550536300315070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * DwarvenGoldDigger is one of the goldmine subsystems. * */ public class DwarvenGoldDigger extends DwarvenMineWorker { private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenGoldDigger.class); @Override public void work() { LOGGER.info("{} digs for gold.", name()); } @Override public String name() { return "Dwarf gold digger"; } } java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java000066400000000000000000000046071312550536300323230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import java.util.ArrayList; import java.util.Collection; import java.util.List; /** * * DwarvenGoldmineFacade provides a single interface through which users can operate the subsystems. * * This makes the goldmine easier to operate and cuts the dependencies from the goldmine user to the * subsystems. * */ public class DwarvenGoldmineFacade { private final List workers; /** * Constructor */ public DwarvenGoldmineFacade() { workers = new ArrayList<>(); workers.add(new DwarvenGoldDigger()); workers.add(new DwarvenCartOperator()); workers.add(new DwarvenTunnelDigger()); } public void startNewDay() { makeActions(workers, DwarvenMineWorker.Action.WAKE_UP, DwarvenMineWorker.Action.GO_TO_MINE); } public void digOutGold() { makeActions(workers, DwarvenMineWorker.Action.WORK); } public void endDay() { makeActions(workers, DwarvenMineWorker.Action.GO_HOME, DwarvenMineWorker.Action.GO_TO_SLEEP); } private static void makeActions(Collection workers, DwarvenMineWorker.Action... actions) { for (DwarvenMineWorker worker : workers) { worker.action(actions); } } } java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java000066400000000000000000000047521312550536300315640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * DwarvenMineWorker is one of the goldmine subsystems. * */ public abstract class DwarvenMineWorker { private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenMineWorker.class); public void goToSleep() { LOGGER.info("{} goes to sleep.", name()); } public void wakeUp() { LOGGER.info("{} wakes up.", name()); } public void goHome() { LOGGER.info("{} goes home.", name()); } public void goToMine() { LOGGER.info("{} goes to the mine.", name()); } private void action(Action action) { switch (action) { case GO_TO_SLEEP: goToSleep(); break; case WAKE_UP: wakeUp(); break; case GO_HOME: goHome(); break; case GO_TO_MINE: goToMine(); break; case WORK: work(); break; default: LOGGER.info("Undefined action"); break; } } /** * Perform actions */ public void action(Action... actions) { for (Action action : actions) { action(action); } } public abstract void work(); public abstract String name(); static enum Action { GO_TO_SLEEP, WAKE_UP, GO_HOME, GO_TO_MINE, WORK } } java-design-patterns-1.16.0/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java000066400000000000000000000032321312550536300320610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * DwarvenTunnelDigger is one of the goldmine subsystems. * */ public class DwarvenTunnelDigger extends DwarvenMineWorker { private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenTunnelDigger.class); @Override public void work() { LOGGER.info("{} creates another promising tunnel.", name()); } @Override public String name() { return "Dwarven tunnel digger"; } } java-design-patterns-1.16.0/facade/src/test/000077500000000000000000000000001312550536300206015ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/test/java/000077500000000000000000000000001312550536300215225ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/test/java/com/000077500000000000000000000000001312550536300223005ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300241305ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/test/java/com/iluwatar/facade/000077500000000000000000000000001312550536300253335ustar00rootroot00000000000000java-design-patterns-1.16.0/facade/src/test/java/com/iluwatar/facade/AppTest.java000066400000000000000000000024731312550536300275640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java000066400000000000000000000113321312550536300332070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.facade; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; /** * Date: 12/9/15 - 9:40 PM * * @author Jeroen Meulemeester */ public class DwarvenGoldmineFacadeTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * Test a complete day cycle in the gold mine by executing all three different steps: {@link * DwarvenGoldmineFacade#startNewDay()}, {@link DwarvenGoldmineFacade#digOutGold()} and {@link * DwarvenGoldmineFacade#endDay()}. * * See if the workers are doing what's expected from them on each step. */ @Test public void testFullWorkDay() { final DwarvenGoldmineFacade goldMine = new DwarvenGoldmineFacade(); goldMine.startNewDay(); // On the start of a day, all workers should wake up ... assertTrue(appender.logContains("Dwarf gold digger wakes up.")); assertTrue(appender.logContains("Dwarf cart operator wakes up.")); assertTrue(appender.logContains("Dwarven tunnel digger wakes up.")); // ... and go to the mine assertTrue(appender.logContains("Dwarf gold digger goes to the mine.")); assertTrue(appender.logContains("Dwarf cart operator goes to the mine.")); assertTrue(appender.logContains("Dwarven tunnel digger goes to the mine.")); // No other actions were invoked, so the workers shouldn't have done (printed) anything else assertEquals(6, appender.getLogSize()); // Now do some actual work, start digging gold! goldMine.digOutGold(); // Since we gave the dig command, every worker should be doing it's job ... assertTrue(appender.logContains("Dwarf gold digger digs for gold.")); assertTrue(appender.logContains("Dwarf cart operator moves gold chunks out of the mine.")); assertTrue(appender.logContains("Dwarven tunnel digger creates another promising tunnel.")); // Again, they shouldn't be doing anything else. assertEquals(9, appender.getLogSize()); // Enough gold, lets end the day. goldMine.endDay(); // Check if the workers go home ... assertTrue(appender.logContains("Dwarf gold digger goes home.")); assertTrue(appender.logContains("Dwarf cart operator goes home.")); assertTrue(appender.logContains("Dwarven tunnel digger goes home.")); // ... and go to sleep. We need well rested workers the next day :) assertTrue(appender.logContains("Dwarf gold digger goes to sleep.")); assertTrue(appender.logContains("Dwarf cart operator goes to sleep.")); assertTrue(appender.logContains("Dwarven tunnel digger goes to sleep.")); // Every worker should be sleeping now, no other actions allowed assertEquals(15, appender.getLogSize()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getFormattedMessage().equals(message)); } } } java-design-patterns-1.16.0/factory-kit/000077500000000000000000000000001312550536300200645ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/README.md000066400000000000000000000015461312550536300213510ustar00rootroot00000000000000--- layout: pattern title: Factory Kit folder: factory-kit permalink: /patterns/factory-kit/ pumlid: JST15i8m20N0g-W14lRU1YcsQ4BooCS-RwzBTpDNSscvQKQx7C1SDwBWi-w68--vD6Gur55bTBAM9uE3dlpcikcotSjaGCCNTLu_q8C58pxbPI25_Bzcz3gpjoy0 categories: Creational tags: - Java - Difficulty-Beginner - Functional --- ## Intent Define a factory of immutable content with separated builder and factory interfaces. ![alt text](./etc/factory-kit.png "Factory Kit") ## Applicability Use the Factory Kit pattern when * a class can't anticipate the class of objects it must create * you just want a new instance of a custom builder instead of the global one * you explicitly want to define types of objects, that factory can build * you want a separated builder and creator interface ## Credits * [Design Pattern Reloaded by Remi Forax: ](https://www.youtube.com/watch?v=-k2X7guaArU) java-design-patterns-1.16.0/factory-kit/etc/000077500000000000000000000000001312550536300206375ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/etc/factory-kit.png000066400000000000000000001113021312550536300235770ustar00rootroot00000000000000PNG  IHDR:&IDATx] \M6D[=1!d͖} %4%D(D0,˒Dߝ7～w}?{ysI@z@ _@ @=ZN"Q] E"Q%Q&Y&H$b2YI~5 "H$#d$W_ H$ɈD1*9>~5 "H$DrQ_ue7a[YƏ~ Oo[:ժ~5 "H$D-rSKWuw:4NL G8--s&UK?Σ_mjD"H$b%1wrM--ܻ"R~\kԨ\x F9޽ȑQ ES)FB$D"(\s*W{xBW:R~;%{zVVII))*UsR8Cԫg~Ą,!43A=TG D"H$ \\ eKU+^=ݻ(rWסVV#qUY{V(m%[J1zu>p1_K~SY˖-qQ1HQD!F D"H$ \?jqꔏ]3J#7lu\D>~Rp~~5kVAIUkժӧ}msH*MŊGGp1M0WiH@a3C1&68"4R荄H$D"Q$~qqX1#Qkm6LM=i,KKs/[6[V\;8a0T,sX8[vj/]gQ&(wv?bȎ6c6;Hq4"H$DPH7Q ճV{x*Q7utѣ- HٌWdhh~sbyUdb1p D"H$ zM8))BWs}Nwr'垞Tɏ0D"H$Jb>~BgM4DH"0+կA$dDJsaD"(&#\jD"HF$H4WH$b2+կA$dDL[ܥ3|'uY̳{N#Qoj$QDq'zu>Ey+UQ' A|v4Uj#11֘~LM$}}nկhDmm\yE"?rm8PD9{~1/tJ>4[O'jϼׯsEw .]r/^&$1WݹM bկoyTƻD-8P>D SW ~ qVn>0 魽}+tvp_?[04@bncr3uكuO?;MFb8Ŋ,Z4h'8?|#E@8rf#;nč+{^ُx`m3dY :5@-lلuI"? =a,oii9ZHNo7vcY:\ŋ6n\ȨxϞ"{j*WΖ,,o0O"܅HWWz} }O?H..0037/=;Jv?GG[SScHBVc>ܾlR/-KiT ڵE^=EraSuN[q;/:`6nđm40pd*d&MjOf`hbj$yՎw„pKKœlcm6o| ʀM"Q1CYfmc@"ŋH0MvM[ "+U*+'5FW[V)360F$"afi̛)8cf-5$3hӘ5K?p`'=pusv"Q},]<Ĝ ZV)Xc6E(W.޺!Ͽ.7 V;np^baJf#Ft{ȑlR-S +[q -9YFah\'Q+U!&,wOlXW%Kel-]͚UbM$7q'Ndb%Kb1ްpb`l/?d6nwcb-\^'>ZV)Wt6ZQD(W!+aY_gsBz/}74^`\J [V\tMwٵW -#>)M֮fLL$IUfu0jԨ,[̍]Q2"z?&$hPOzy"1 =Euޚ]0%NLMѸ?Oђѣ+@׹ss>1$9hYٵJ9gII_.BJv'LrŪƵCuClt#Fc,ܻדȑYz޿Dxq=pjQp!ۛzJOzw!> 5k.)&"Qa X_&T4+Ԉ0#)mw;:b4i@{H4O$-+Vrjٕ-6\I^>c.viiܤ_~Q.I~ӗqDIqߟsg/{+v#))"9⿔H/}9J JVȕXMD׌HdJˍH\i~5 "HoKKjF|DHraD"(&#\jD"HF$H4WH$b2+կA$dDLr󙄄0ޟFB$D",@i͙͞$'[jrgdSZ˖6_}*WGn3|DHD"H$SiiQy+Ww*><иq-g~YG4H$D"Q{HT.W1F9o#Ǎݹs^EECw^(ӱ :|Ch…#Y-ZxDu6 mQС1&}嗖[~3[MJ۵8ceeqΦ8bbp*g1h[;G; H$DHT.W͛>>3ǍS".[m׮lZH2~_Y>_d88p-2{ޚ5⮝;l fk)&+blY1`@G\]ťxtZ>#D"Hjl5kfz߾,ܨQ~'O5YKXmTwXB4s޽;6={d׵k L~w!tR~V\\>IL [:N Ĩ^=s6 D"H$Drur8LZ>}DҥKfdF/_3R_q_EyZyeӦa)) lI0e V܅=JW1\ql%ǨA:߇$]uaY|D"H$Dr# nߣG[h3ll,PUi>~rrU8 fDT{Z 屷ULf7Űa^Oy…#wq_rU,lbXQH!ԩDc1`\>HD"H$D'f^WЀa(bۊr\qlU+!!@\>HD"H$D^V޽ĉ_j$lDHD+喙͋S##E`DL]$\ߨD(#\jD"HF$H4WH$b2rUA-@M@DuHD@D]p@ D2"QLG5VH$b2+կA$dDJsaD"(&S.WtoP]"("=jဆA$dDL.j~5 "H$#d$W_ H$ɈD1YJbsY?V("1h DȍHUjv?ևѯ_eבWDѰ)t}7E/(*#W2?ӧXsrJ0ΉMﯿ޿?22 Ȓ~dIa?޸+Al Dرc-,*T(S?Ըt??GJ-:ڧA+P_rgvUTx8$>d>KK&/_>jRKjy̬]htƵD@ILO?Ut5qŊUVP{_"QʕS_ c3.b6l٭[+r߾?o8uYwphs/ga+V4ij$$,<|e, @}gөSӋ"Fecc1w8(#9uʇ%`t^ve˖B|ǬbcsQrEѩ/b0Y[zB(DՍNʱNj+4ɑ+[jE[대DٽATQJJ$ZLP[ݲeNU1jxpɒnOtvy(;";\v 1ས^F^Hdr9ǩW{ G!:thQ,,T kEhBqq@I-X0pBiIcPd;}#C1޺_>ܞ}&6,4[@DNi#eݠ2e [ (\i?_ zf`S&і!kʕf4M~&v I(Rvxׯ\Clل4 i06yqbf?Z5}0El Dfm?O* ,$RB$#؇J#;%˗O[DAXWd$htJ,ku, Z\ դC 'n&"咵oDbPxn?hѢ ϙ35X1g>50Л5k050B@ ӊ)Aل }I0 7Fs@׆IXp. #t$%}{ Y_@\<ԈT2f˖6kWH cP_+2U4:TSO±0B:G/ADڤjժ8poG //wPh"6"##oܸ#:+e7߾Æ [p!^K.urr #664oE@r'7n|U$޼yᷰETf|{!HwӦM=8}A@  M4HZ.g| ,`6Bqĉ}0aum_mƷ +ի;tCϜ9÷BvDHw߾4Ho\\ߎČR0y#FJ˰`'`a7222vD0xiff&^<5kf6J֥K z(4iBk9GPP/Hضm[tt4߾/^6lXzz:ߎǏ ͥ4iBOkHh'ʕ{ߎ7"·/J{wo߾׬Y÷ڎo/WUXĉ|;BP+ϟo޼immM=հ9r^h/_qƍ԰0!(ɕe˖P ԩS|{tɹ `\8dȐg$WF/_\\]]BӀBܹsoG4%KL8o/4Gn߾"$WiիWFe>}԰ak׮FӧD+݂֭[@PRRR^z'O !Ar[x%ECػwfyey۷VVVJGѬY3qܹ*Uq+W.==oG4Cԕ^ɕ">>}w?~\.޽{|{ ̜9&''A ]wܹ|B {i߾. r uرQF|{l۶or={חo/.]ott4= "H"##+ ·뇇E>g 'HNJ+ ķoARR?ǾR%\t 4vOK|x~WHLLׯ>| "]v/_^|y~Abdwƍ|{A \K333Q>ͷjƒ%K Ʒ%Uv- "(֭[׮]Co_ N0o/+Bx!Y^ubժUk۷oݻǷ{ pҤIlK#Hw^1uk֬ٳ'^ vvvbZȑ#s `2x`qzyq,V ^ϟ?WP䊐# 0`ڵ|{A'޼ysСO>=}o_ +BNq9;voG ͚5 ĕ+W3閖{bv\r ڵo/^z }gggǷyܹCKr+BիKpEqGE0}tLs䊐k˷ݻo߾ NgϢyN\Onժ^|;mfkk˷OOOF\pÇ7nܠ5ہN111B9rǏHdhh(`F^LwAx "7oBT5>~(Nj1 ArEP֭[_1EDׯw͛7M6|-@rEP6m$/ 2ӓo/rE1g/// $WӔ6m<}T@#~oGr~MXw ! "QQQL֭^D+2eʰ|{#_gϞۋٳg 䊐/uɓ'?}{} >\zuEDmrݼyoGP/A@ "233_xѠA\ZpڵݻwEвeׯAl "/V\sf`x =mdÆ f䊐x ~.\ȷ#0~~o/_-ڻw/^D +о}{̴"[$$$h##Gtwwۋlqmn߾oGbAC̀ FndffrL:חo/AhӦMXX^({֬Y÷B&O>СqLH >PNG͚5pmGFF~ZD+`/c͜9SN>ͷٳgvʷxq2evC "Cծ]o/Czz:T*&&F/,+`ߒ8y|dvժU>=Y6jɓ'Aw@rE7oz왱|c޼yGۋe˖ŋAGArE>}|ؼysZj׮ȨVڝ;w{wVZj֬C}Ux^LWۭ[wީArE RSS-Z˗/eoxu6&Ru~ up1á˕+7o<5JH.]&L`mm-s|||]7A5Hƒcll, ?|bŊ-ZPW[ti'''N,~g_CV18cGgggEbN- $Wʕ+-[HQNe˖Ab TlY޽{޽[-G b<! Kfff L[7n{}n \ϟgffOcƌa1۷Ւ#F`dl"?~ j9Ĕ)SmbXX]v@@rE*FթS'م0K]]0&m֯_1cF Cd+֨QWKۼyM,AArE$%uIIIT%A`ڴiM6e1xyyM>]]3 Cp&M(f͚mܸQqM,AArEWB*R%A`РA]t`6l>|2g@Ȗq ;;; wy rtnb&O "͛7NOOWܫKr{^z%g000P"]QN/_-[d-T*[nz@o\>lڴ]vj159y8չCo^]93 È+^{#SLA堺Pi:T Q/#+%KԫWlƌW^ej$=Joށ ϟ?C=ّ@P- 3sLsssT*'$W1 >>=<<>|l2T6J*AʓJ*٪QB>~ z葧'#@rEؕ#F.]UV ,Pcׯ_/Q[ 2,VҷͫV*Az) D\oV NS59KFS|@iJHH :M A7A)A`\%%ED\JA)A`ȣ\~}9W]}ߛ?6sMO?|F^B\JA)A`N>}ݿɟԤ\efXߟI>Jy30/?EIrE"4% rM--ܻ"RN\kԨ\x {B%Ç+M(WWlwr?իW;#QQճ02*.ή-[(gaa͛kL3D1F&(84 DiJdٳ0(Dr!3nT+$\aRwv׮-X޽ڸqdr])Xy.Oqti.ދ±J4w^g.'3g6*TmXh7@P<r011o^=ϋ3dGG$WaNS +W{x_jrffHEBDLr1@ݺՙDE*U"11\i2r,ڵJd.hڴ6ݾ'&WP&.”:udmS!g8.J PIrE4% r~oҦj WOy.JE\}|uyHfo* =(hQY3)H.^V5B=~bdJ݇UJ3D< "/*%VIrE4% J8uήQLF6ܺu."ѭ.\(#㴟k͚U^!ަU OwضM"q4\qڣ(W!!KmmI(d r%+[fjX{)06Ev)$"tmcb$Dmۆ'6mei5 ZlBn !MJe+V4a@e,'r/JK244xq+b֭%S*WJŊ_q܆)DaSIrE"4% Ubb8f􍌊>1І ճlcTŸˆ=zear"W:5d.>~'fH$++s 6T*WnH`aa _ gS. H!/ '%EȽ_;IJ0]cL|22N''y$WNS 0e$WANS@rErEMiJHH :M A7A)A` ""&4% $W$WAru!z&:4x?ˆ]-- 5}"$LŰkNaw\Uٲخ\tt{ɽ2)sfl13rO®_ߥ'NĖѐ犘?EO/@]MW"]"aYbc-xn[}&[[J\ d7H:M Z޻ڲg8dqYu^W.=&4[ڴi޽`&$ƆH0}ipT=a N62*.+WH.zzfm5jT9>$WA]_&9u>%dˁ/E|y;U+.fܡp1m̺j&8]N-mKőTAӔ 0]OEQ\ޭ[&~@ƵԞRbSAӔ 0Uff̨Qŭ>D׻szZ!!KЬ_?09uʇ!4{‘Lu߿?٦Mlm~}G>>>k'$_Z֯oɾn:7))BnKyD*v;㠊eX..[O-+ۺwo}jV:.+pA)A`+_l 7}|fx{;'6_8V;ܵk[51 V*8vȐr&W rUFef?FG@9={<Ν5kV)ڹ|^0[nQ1\qle{Ȋ:":8..PdsAӔ 0ԩ5a[|`?j~،\myw\a3p`3رijgaNNv]NXXʕ.:'+WeX..Ob!ÉuVʢ8&&FYIAN^Vߔ)!*ӧH?WtɌӐ+b*rΨQ/?&WLZӴimXJJ$oILwwBuP])+rU,l 4~|Vhի;ԩzˇ \iJ =z̙M^ jdccb*W./'W^c^&=ȃ}%:ڧy󺘫  d&=ԛ7,\8Rq+9RL,W.[rfiEDIdXx,dlˇ \iJ>ȭm&y٧Ork d+WVE˜>AӔ 05a5 -,NX9\:M ɕefM.IJFrE4% $W$W䊠Ӕ 0(GP/P|J |t=]슠Ӕ 0\\tt++nNS@rErEMiJQ  t=]슠Ӕ 0\\tt++nNS@rErEMiJQ  tA "@rE @ @ +@ $W@H \A "@rE @ @ +@ $W@HZ4@P -\M"4=ZLiZ\6+A+@rEFHɕ-))"%%w7Dl$WV*'QT~Օߛ?6sMO?|F^B^E"6+A+rSKWu&*33zdN)U͛y-(,H5+A+rM--ܻ"R_sQrE4b6j Y n41re} ml,._Ǯ^XVV/_ZWQqMtvvͬoҦ@= 3dp'Oo޼._G`!02AQ|G:k$WV@ٳ0(Dr!3n䌓+$\aRwv׮-X޽ڸqd R`y\>=v\"c,i]&Ogl*T۰Po>fWx8`bb^ {/+f G%*"uH՞=W:3N;| PnuT` RR"ҢJ*4qr,ڵJd.hڴ6ݾ'TL\>'$)=&|uTc= ۦ4Cp\:R׌@ \~oҦj WOy.JE$3N>>:ʼ|yc$fosRv8 iX[՜9CFȁǏC W,3&WJ>|ЮU!QXQ ,H4+A+r);f&&F11Fn0sֹD^p~~5kVzuDzV*_Ъ>}a67ƕdqri\,*'%ȕlnLn͚-Zc><4?PX9:ڇۥ4Rg@ \1:zHP۶ SSOl42klلnZI'6,4*Xф]2TL_D(--ŭw[:L\)=+Zvs4CsOi Raa72*~r@6WQ%J.::іU$cZ:uj\|N̐ HVV66l T; z.N2$\ZZRRHsNR)5LX 4vdcr!3+A+@rEFHj#"$Wdd@ \6+A+@rEFHj#" Wb|`I#޽"\ZֵRY>/ˆAlOøObo ˆ %bʚdj7+A+ n& {ټ;6g0b/XuTCU:O98~LР@=mxh |[VO0/j#  0s@Oru!gصl_~'iXѣ{*/+~Ȩ85|abLV1۱ceefVYN+MJ JG, IzX_/z <+o̱,>9|s,Ν {lDֶ1~gvjt!i?~gvK4]pܼE"]n..||fXXa8Y'!ׂ:n]M,y_vڵk4L1czb{\)]W'MQ Pr .0 _Ÿ/[Ty.]:3OFrqW#Fr¦ 90 6 CѣTErvspD*Cfud nԨfժ%OY~=ڢF|NMqK4(T`Ӧ  Z"E ըQ[ӧX/#dXD1lfbrb f2cKfD6!cMFI +lZ[>?^cX1 l&:eJ9z瓑\iDU鈑\ 꼵_G_+ol;nbK_JܾNÇvNI< DOBH(1@60B˗Gb&"WY+"ܰD:KC@}D 8\m%"s ;=իbʕ \FL|NT4?# GW-XkG)YҀ7y??nr^JmZ~nx]Cpm++xsmݿn8uusub佼 liinkۘ;wbj=ud͚$srb难~hA5p`'vtZ clRlKJUv>lÇ+V\1.B0bs5ɕV W] "2?ŋü-OfΟ߂[Hif?m93B13rO®_]^;qb-b>|??WTGO/cR7aB_tQGe CE2wIt|ԯo)r1HX=9®@Ofu\َpŊ&؅bɕ,9jV*EjӦ\竑\irUa,_>#J6왢"%+5*ch٠Qv^R8q\99ٍeD[\"[s)GuMu]lK^= #(˗Gs욡[IM=^^X=uyr ҥK۷b:B2 3(LC\:?#.s\~ץ.K V0-LoI!H0}i}yѕe;7.qrejj⡧hy۶ kzHU'/Rhڵp# *arxіmݺiFrjWn- N[UDrvxq+KvmRƃJqZǨU&3۾}D:-Xy..].ɡY?FG!R(>رqq`P !,Y 8;w=g8a1fw}p˭C,#!ECA. J+*,-mV]Hf\twu޼|yc$:kHN@{P" Rvɘew1J]I 'srŞ@Ӧ `:uAe¡9CCE<0;j„lfƬLCL:):zC!CԤH 4$]+MVDck0 cCO~ɕV ]թS>vvLLbb6*ܰa֭spB֬YmZAi߿dvɘ+2޽\q)*$d< >!sC{r`n0Vdl1{WH4$|VlG3aLM1 \t\~KJ+ۮ 3q+FBڶmzbӦY>|88aJVh.Yd79KO?T *VL]' ŋ[HVsO_HBB'W8 fi;?}?82d+Ԙ\*LC""#Sm$WZ5vUPLFF]Л7lh]f'J(]6ttѣ- H&yJ۷S!C"ʕϜB`͚Pҳ\eRD޽-^<@ܼrfsRj# JJ{yիNd9c@shEܺx=#㴆 "#o# PW%t#"#o# PW%t#5LBB6,j;FrJFrţzL6ߍm|lժ9LqNj-[(^Kő|g$WZꪄn$W<иq-gLNX!ɕV*7[ff̨Qŭ>D׻szZ!!KЬ_?09uBC.*(hc%E'_mm~}G}C a}嗖[O3[MJ۵8ceeqΦ8bbp*g1h [;ˇwx4+vU1o6_lM7}|fx{;'6_8>^k c@;{ĉCtrͱ WS^f } WGqphsߞ={ޚ5/vtgrv^0[/Q1\qle{Ȋ:J/xťxt4\i U=zz\?&^=q-F 栗m"-fFj>xr>ٹDF- u)SCTO(^tI+b*rΨQ*6ܗ![ǹԴimXJJ$- 1c(P]ɕbbp*K6[Qu?+4uTKM=JFrPWWMZdq#~WEVpP[[^ehhP_U_~i5 رռ76$+tÇS3g6 :+B%^ T*Wϟ\r3LD0BD߳g֒{9JtOu1W6Lz7o"Xp.NW#rrX8\咕+Ҋ)ľ=jxX&|h$WZtUƼ0ϲvL0 e7142*d=b._GXXx? VV4n\om|\ѸͼL"g-1(ݕ|e\ aLTHɕV@-]_vdTƙgW>^cd&[ֶ1~u# IHG.]s4.\st55567/|Eխ[CBfoEC 7ulݺٳX$ĿQ'4L1cz}C,BC i/Aҥڇ{Cqe۽{!N'ɕV@-]Ն_Nil iXGB,6 ለUE~׬Y89!]?z nԨfժ Kj֬_Gl=olnɒ lڴvY363POj(\[Þي!%awlj򉈙2?ۄpPCvцDr#7$Sj$WZtU+k.dlLb`Ȋ1^35Ud׷oA!]Hɓа`BEAJJذa&/ qn?x0kaC??W-Lk60п61& `B-Y+“&9ʖNQ0+X{޽`e!hCC""#Sm$WZuͮV0c*uC&vd 6hP'wIm% ]z%MԞ<̬,6?HWw߿C eYRY(^(U8&7l`/b+KbMf}i,Rԩ3 ޷oqPVԝ= CPpV1: teыVO?ΜÆ ?E ?p*' ي~ (l,?,9$ƍVQ9Z쳘͛g`?լYQA]o}F>=@AՅժ%ݽ{~^m0a |1:GwJ! U$f ^]]sOg`Aw_ٯ߫F!} :7mdYn6P!2z @| p$VrR%7W$ ԑ. f^]̝;Q'9^}$ YFClEIs$ i:! !z՘1=Eyz˖HJ7jTXƴRRaQ!q< l* l8 2pMAW"%k]|fH} %je]hn/ZN7 ˗C07 L1FI,sGPlhD(Yp3ժUI~t<1=sV4;I<1`2EWvͣT?e zLq^Oς1]Q芌* tʼn{:d?#V2ezXVS(XG2-^,J]X1Qz\jO ><,4:Q9ќؑO,{hl"S^&<qpdIF[(4c]n&1QQRαc `,Y2699 \+h}ܸ6^'ӕ!D/%>PX;b`#,dzHIWGr|9 v E37dt C@c%557xh޽Dbڴ]WDԅժ%+Xiy󺂢$٫C`ѦP p>mo6)/h…m 8]W2aٺucQhL̄5+Yڶmty6jF2@Y-)_ 3Cw CN$Hʕ J .]m:MCtYxV4;I=Z/[&huB0]B}+LvYI3VDAŞWP=j-ҥD? z ́rlmȔ|ܾ:aúM􆜮pa":u@WΝ;vbժŻ <iزq@_n|WLCgQ/32L RȤGwSK(RJzAs6'iiބ`2%朁y{ݷo۵] Lbt߈)DċK!SQl޼w;naJ2_[Z9أ^Ia=ݺ >D2Sv^+W/X]hs+R@oa0ʕ+,eXshC(\}XXazhuB0]Bniƥ}`W-|W m~ҔIH`SSg4Dn{m!OIˑnB)_,AA~0tmE 34L7ǃt#ّ͢aϑ- @mpCtsnj&Zi6:tτS֦-ӱ?7CNP##;VPr&VIteqU0+#te.Yt`X ӕU# aLWVU+`2rtؗ9? teQ* H1`II$6ؙ01'W&[@$Pܵ P+M}D@TO.L!矻:|#J́A:*UBZt[L_bMFU+ jS"E<|}~Fs?,Φ-#rF?\L!əd\Jdq 0]B,oܳgwYhE=4qZ+:&LYB˗ p׮|^eʔ)ֱcKr%Ipo82z=D ) .p&+kH7je’)f6AڷoJNGo:OW]@ΜPS2];91ML&ӕ!$MO]EEI7!!""+ҡCs QAtEO~p3,Y*Ԝ^Yo:Hw!em͋/>Ƶۻw:|5b+Dps+7ݹ~\I#Z TAW i"L"W2t BLWOGV>+ꫯbkձE`(}u[y$buX^ISXb)[Mhჾ}u,jr>! !?9@'N||nf0_@0XL=wk] wT)C\@E=lĴ J'T-0xpGkа!`}._FlHte8IW֌| GW:uP<`,f[zbʕK+&f$'GaZABB&]ti]Yot+E4auN Hdt)Q3|:ְx>VXWS'jZևDž۾=3GWdĽ}JBK3| 7πZ%l)AW ,%yg%]Q !<]A'Æ0 ֭00t_e:dQӕBEG4LM=u!]4,{hjx\ӤI-E=mHtUfE o^׆ k`Q5]J0A֛!u\Hʚh _5,4f[y$bIWS/׃Bo >ztxܸ:lX7p9[8TЕwY)&kU g8'*Zp4EKQ< zl5]:;|}+kzADaCk> d}.5(*tX*h7nKusK[Ǐǔ.-,aSk@.O 7}C븐k KOJ3|:ְ Alay1O˗M&U0&o(noW&+q4*B8x0P^^p +3Uiv@MW,Z*ݞ: ?oÆ0֤+;L6WbA,U`WQ1$(?֏<.:t t|@eTR&66\:*88J\  B27&,=+XғAlDWz:0T< E ËgYwժ0qghtn\u{n ,ӕf0_M" c fyKwg+W.MoQXAWXH}չs H`.XىiM%20z7D 20ѕXÒ,j:ZJN~cex\L \np. lzۿ?:LЕ]H0qeZh~wphϯx30=X3]e:dV(|dgM"@֪U w1X`R5s]2=*қ7qӗ;w.>]`6nΝ=|/3+!]H怕ф4cc VƵf(%}XF- iXفD2 al&ӕ!D04߱9g78ht9l"{vEVlS!5'LWvq. "]~&]XXr`Vtuªʡ ɅoY *] !;*Gak0]BXU9: [ªt`LWVU+`2TGv0d}!e׷EXXNFtuG4aF6x},,,g\KMX2.W3s!dTb7<ǚUfbaaɄ8Wӕф Q]!ɝO6Lb wS63|cDWzt’ qe+!F&_?%,(Jdjٲ^n/ݳQ]9m,`+L3.tM}^^_O9yrmʥ-.\2(Z!>=$*jaݺɴic3]dBq٫*Cф׬عK^= Ů[YAC:9-$XXX2!θUtҍ& 6,Rۻ,{H,qȐ.0PZnܫW[9]YfbaaɄ8㲷@WFxq1inny)x?2*Ct$XXX2!θ-Uф#" h!ϩ_#_OPҥoS9á]K!J06A芿fa Vg qB4a/] à|U’nԨAB58m,`Еi`8tYV6z*: teDzీ+Cw0]Q8pFE ʅ1qj2}>,+g a=`5cT/_bN8?Ju,U(9ya +# )GU[g. ;wXSO4=D[cVcze:(Ωr2kRYjN^N43J2$ƍӨm4At飲kVhZr[pɵ}o7o+wYT܁K67;+0F%8Ojf:(Φr2~KC/ M2]i:\jӭ˗iJGիh 'Y{Ҥ7v "qwwuWPW!$tc%:2WL]nnyAB'5J͗c6ۤIohVabif:(jn4a9]II իĹs Xrg^ Z&# ]9-]Y+I0qȡSJ*+.Y(FLWX)0Nޠv8IW暛7o$ 60;x1`2ߕhDW~`60;(Nrddag^qxTm#l id{ʈ=ф"zEvaYXj&F%O5t:-*D^2tYV6zten;e'֟& +#QrYWָ̕˥hQuZ{}steDa=`3~rq>\qR~9;rޛ{QF'~'&fʕヂ mhK4ӕteDa=`3F0t1{U <'G%wT'qc/m~FlBm D:UysIau[𡴜~uB򣒅 G?ҥ U͘&={z5վVb Z5>ϡteDa=`3FfA :I[!剮Ə7eJ0~kԨ{k<*W8\~ 6Ms7~JjԨ&]{6_R)$ I.OMr3۳gaCʈSMteg ۻ]LP5=ڮ&;Evu +ڵ+)StE/yl]8C-4v`/*7AΝs?UƧKW11POv.*"-V- qDW*S@`2da&|AOς))$̟?ѕBBݻ]SQ] WDW CkA g}f%ᡔ {o BeILUw"}t2G2tE k~8رhJD`X+#MΝnnyi0+ʕ-UPSL6rt%EV:bVG j.lYch︁?^ya^ Q^^Ȣ"/5kVfpp!Ç`?n7(0!$fرOt `2ߕhԩqmӦ?2tuXT`)+,˨Qu&!7o2~=ɵ+M0v횇&@‹.q]1]e>;p؁۞`;r\%= ov/P.\0,k͛8Q9˗pJ"34 Lʈ+ Vb)(sGHO & IOС]5k& z-n?TҰa'>0Ü30Uv?/yhh~=H|*QBG084(Tфy o[3g6]-;uj-:T@_߆Exx{`$ыO򇁨 ЄA teDҍ&?<`Wstuvwwc`II @{Dt=4҄sfb0tӕłJ705. ݄F/'Y+2`{EDB^~T7PAu\WLW LWFzr4aVJyP$nnd4 7?dEܹ~_ú++C+#.z 65\9/0;(pLW `2dEOq4a;HA]sҥ $fd,+g a=`l4}^kN)35ծ]ystP(63QOӕ*[p۷gbj .\ָWKP.0]QXO9:2tmukM6[MvmE/sn^ϞmҥocرcigFFL^4֭hz6MƗ.%vм^S29-[ؚ5^MVںu:SZ(jo%JAŠjp9w.{DW:vlgB'ۯteDq6=t Z5\9):ٳ E2l_dHqcc}_4@acoָq}q`jj4 N^ "q5k>S/]6og&jU_b8ZDwի-& @1_Ð/F֕8y`ƌI [DRQo]ϭE*!Ѥ[]/,O\܌mDD>}7Ox{dtޅsԅժ%}0hʕ:ue1/Buz=Rbb2eǷXl Y.NFWv1u$~i=A*bƍ te@q6=˺riйK0}Yb7J2= Ԥª$%0D`37dt KMnڴl7wk)HL6XKhQЕb8Zt+-o^Wr)^6E=~+#驜Lͬ|Ҥ:ƣG)d<4]G1Qq]Hg!QSʈz*'銑 l8ۻ}'ӕ%#zJҾҸ'6Jpt><0.r0]QS/}ԃj$}>w1+Cw0]Q2JWC phJ|rkniΝ_*XȕݍҚa3Qz?sf" t`+#JVjƌ7{hM{.}S4A[i{Bb*8}z,tÆyFf;(Yyx zWF.ErGI<.T(? X11jԨ?3=WOWIwoݷob Z ǁZP{ӧExx:VI9]v},dME۷chּ?ca.3T?[Ek~).z$J*zA[u}&%-] ];_w* M ?__iXz  wJҠA[g< LEYv8q!rzي))/o,YD矷ϑ TV͛߀H||E3g6ulj$cV+*Md䨖-kEii˄7z2n\l_E6ZWLW LWFszu_xJžiDLr:rd/_b~) C֍Ea,ઘ 5kV$/۶"wרfosS=OHʕ| kNS ϝ;4+tbժM%W).n2L ӧ7YF_`a jaDq1CW7"iJ) ~To֮ bs Zh (Zr>>a.%֯_n]oXӧ(֭  |Zpa9ݭ\+_WE s; dUa8 H7ҕi`8'tYV6bAO)ቓf.<˗ȁ$6 ], Pn=`3ۊOH Eh`b0tӕŲmȎM'f 'N|0dHLwf9Ҳe=7xq{/!M0]1ʈb=矻f['&2rȹs nԩiipԦMOA +Cw0]QXO9:r]܏-{'zFayteDv="OW=Wr&yN {,.[TѢE=4qڬיab&`K<3Sb20]9:r] o9i2޽SRIX珬TT֫tugFGOp?tq.cѢ,BMk+G+GJYv JvA3SxN wɘ h,~$&S&+pJߊKAMWJ]f4™VpqlT(rbK8\7}j2 B=`GVgF=XXCѕ55}34;8|} o9i\޸Wln[^% Rׯ+nLL3VR Gv %t C8Jo: Ellx|[f39XXCѕ55}vXO~ o9i؄Jmذ lW츸kfJhΏFâ*D r @$:37 ٳ =lEytbtԩ !M߹sw43 `0P._N^~$Q@>c||ndt2%FTӕf74 A4*MݻyszX={lEs銅]YXg1.]믿"4fܛs&UR java-design-patterns-1.16.0/factory-kit/etc/factory-kit.urm.puml000066400000000000000000000016011312550536300245720ustar00rootroot00000000000000@startuml package com.iluwatar.factorykit { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Axe { + Axe() + toString() : String } class Bow { + Bow() + toString() : String } interface Builder { + add(WeaponType, Supplier) {abstract} } class Spear { + Spear() + toString() : String } class Sword { + Sword() + toString() : String } interface Weapon { } interface WeaponFactory { + create(WeaponType) : Weapon {abstract} + factory(consumer : Consumer) : WeaponFactory {static} } enum WeaponType { + AXE {static} + BOW {static} + SPEAR {static} + SWORD {static} + valueOf(name : String) : WeaponType {static} + values() : WeaponType[] {static} } } Axe ..|> Weapon Bow ..|> Weapon Spear ..|> Weapon Sword ..|> Weapon @endumljava-design-patterns-1.16.0/factory-kit/pom.xml000066400000000000000000000037331312550536300214070ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 factory-kit junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/factory-kit/src/000077500000000000000000000000001312550536300206535ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/main/000077500000000000000000000000001312550536300215775ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/main/java/000077500000000000000000000000001312550536300225205ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/main/java/com/000077500000000000000000000000001312550536300232765ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251265ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/000077500000000000000000000000001312550536300273055ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/App.java000066400000000000000000000047111312550536300306730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Factory-kit is a creational pattern which defines a factory of immutable content * with separated builder and factory interfaces to deal with the problem of * creating one of the objects specified directly in the factory-kit instance. * *

* In the given example {@link WeaponFactory} represents the factory-kit, that contains * four {@link Builder}s for creating new objects of * the classes implementing {@link Weapon} interface. *
Each of them can be called with {@link WeaponFactory#create(WeaponType)} method, with * an input representing an instance of {@link WeaponType} that needs to * be mapped explicitly with desired class type in the factory instance. */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point. * * @param args @param args command line args */ public static void main(String[] args) { WeaponFactory factory = WeaponFactory.factory(builder -> { builder.add(WeaponType.SWORD, Sword::new); builder.add(WeaponType.AXE, Axe::new); builder.add(WeaponType.SPEAR, Spear::new); builder.add(WeaponType.BOW, Bow::new); }); Weapon axe = factory.create(WeaponType.AXE); LOGGER.info(axe.toString()); } } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/Axe.java000066400000000000000000000024431312550536300306700ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; /** * Class representing Axe */ public class Axe implements Weapon { @Override public String toString() { return "Axe"; } } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/Bow.java000066400000000000000000000024441312550536300307030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; /** * Class representing Bows */ public class Bow implements Weapon { @Override public String toString() { return "Bow"; } } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/Builder.java000066400000000000000000000025521312550536300315420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; import java.util.function.Supplier; /** * Functional interface that allows adding builder with name to the factory. */ public interface Builder { void add(WeaponType name, Supplier supplier); } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/Spear.java000066400000000000000000000024501312550536300312230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; /** * Class representing Spear */ public class Spear implements Weapon { @Override public String toString() { return "Spear"; } } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/Sword.java000066400000000000000000000024511312550536300312500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; /** * Class representing Swords */ public class Sword implements Weapon { @Override public String toString() { return "Sword"; } } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/Weapon.java000066400000000000000000000023411312550536300314010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; /** * Interface representing weapon. */ public interface Weapon { } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponFactory.java000066400000000000000000000044271312550536300327400ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; import java.util.HashMap; import java.util.Map; import java.util.function.Consumer; import java.util.function.Supplier; /** * Functional interface, an example of the factory-kit design pattern. *
Instance created locally gives an opportunity to strictly define * which objects types the instance of a factory will be able to create. *
Factory is a placeholder for {@link Builder}s * with {@link WeaponFactory#create(WeaponType)} method to initialize new objects. */ public interface WeaponFactory { /** * Creates an instance of the given type. * @param name representing enum of an object type to be created. * @return new instance of a requested class implementing {@link Weapon} interface. */ Weapon create(WeaponType name); /** * Creates factory - placeholder for specified {@link Builder}s. * @param consumer for the new builder to the factory. * @return factory with specified {@link Builder}s */ static WeaponFactory factory(Consumer consumer) { Map> map = new HashMap<>(); consumer.accept(map::put); return name -> map.get(name).get(); } } java-design-patterns-1.16.0/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java000066400000000000000000000023721312550536300322470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit; /** * Enumerates {@link Weapon} types */ public enum WeaponType { SWORD, AXE, BOW, SPEAR } java-design-patterns-1.16.0/factory-kit/src/test/000077500000000000000000000000001312550536300216325ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/000077500000000000000000000000001312550536300225535ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/com/000077500000000000000000000000001312550536300233315ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251615ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/com/iluwatar/factorykit/000077500000000000000000000000001312550536300273405ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/com/iluwatar/factorykit/app/000077500000000000000000000000001312550536300301205ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java000066400000000000000000000025541312550536300323510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit.app; import com.iluwatar.factorykit.App; import org.junit.Test; /** * Application Test Entrypoint */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/000077500000000000000000000000001312550536300315175ustar00rootroot00000000000000FactoryKitTest.java000066400000000000000000000057041312550536300352300ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit /** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factorykit.factorykit; import static org.junit.Assert.assertTrue; import com.iluwatar.factorykit.Axe; import com.iluwatar.factorykit.Spear; import com.iluwatar.factorykit.Sword; import com.iluwatar.factorykit.Weapon; import com.iluwatar.factorykit.WeaponFactory; import com.iluwatar.factorykit.WeaponType; import org.junit.Before; import org.junit.Test; /** * Test Factory Kit Pattern */ public class FactoryKitTest { private WeaponFactory factory; @Before public void init() { factory = WeaponFactory.factory(builder -> { builder.add(WeaponType.SPEAR, Spear::new); builder.add(WeaponType.AXE, Axe::new); builder.add(WeaponType.SWORD, Sword::new); }); } /** * Testing {@link WeaponFactory} to produce a SPEAR asserting that the Weapon is an instance of {@link Spear} */ @Test public void testSpearWeapon() { Weapon weapon = factory.create(WeaponType.SPEAR); verifyWeapon(weapon, Spear.class); } /** * Testing {@link WeaponFactory} to produce a AXE asserting that the Weapon is an instance of {@link Axe} */ @Test public void testAxeWeapon() { Weapon weapon = factory.create(WeaponType.AXE); verifyWeapon(weapon, Axe.class); } /** * Testing {@link WeaponFactory} to produce a SWORD asserting that the Weapon is an instance of {@link Sword} */ @Test public void testWeapon() { Weapon weapon = factory.create(WeaponType.SWORD); verifyWeapon(weapon, Sword.class); } /** * This method asserts that the weapon object that is passed is an instance of the clazz * * @param weapon weapon object which is to be verified * @param clazz expected class of the weapon */ private void verifyWeapon(Weapon weapon, Class clazz) { assertTrue("Weapon must be an object of: " + clazz.getName(), clazz.isInstance(weapon)); } } java-design-patterns-1.16.0/factory-method/000077500000000000000000000000001312550536300205555ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/.gitignore000066400000000000000000000000111312550536300225350ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/factory-method/README.md000066400000000000000000000036371312550536300220450ustar00rootroot00000000000000--- layout: pattern title: Factory Method folder: factory-method permalink: /patterns/factory-method/ pumlid: NSZB3G8n30N0Lg20n7UwCOxPP9MVx6TMT0zdRgEvjoazYeRrMmMsFuYChtmqr7Y6gycQq8aiQr3hSJ7OwEGtfwBUZfas0shJQR3_G2yMBFkaeQYha4B-AeUDl6FqBm00 categories: Creational tags: - Java - Difficulty-Beginner - Gang Of Four --- ## Also known as Virtual Constructor ## Intent Define an interface for creating an object, but let subclasses decide which class to instantiate. Factory Method lets a class defer instantiation to subclasses. ![alt text](./etc/factory-method_1.png "Factory Method") ## Applicability Use the Factory Method pattern when * a class can't anticipate the class of objects it must create * a class wants its subclasses to specify the objects it creates * classes delegate responsibility to one of several helper subclasses, and you want to localize the knowledge of which helper subclass is the delegate ## Known uses * [java.util.Calendar](http://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html#getInstance--) * [java.util.ResourceBundle](http://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-) * [java.text.NumberFormat](http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html#getInstance--) * [java.nio.charset.Charset](http://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html#forName-java.lang.String-) * [java.net.URLStreamHandlerFactory](http://docs.oracle.com/javase/8/docs/api/java/net/URLStreamHandlerFactory.html#createURLStreamHandler-java.lang.String-) * [java.util.EnumSet](https://docs.oracle.com/javase/8/docs/api/java/util/EnumSet.html#of-E-) * [javax.xml.bind.JAXBContext](https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/JAXBContext.html#createMarshaller--) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/factory-method/etc/000077500000000000000000000000001312550536300213305ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/etc/factory-method.png000066400000000000000000000534541312550536300247760ustar00rootroot00000000000000PNG  IHDR\VIDATx}G}{*fk/uU[uYB!*BT ];ְ^c#AEǶYYmIF6,pl`17,QI*妒E[}n{t̜3o=3O}KgΜ9~Nwό6`v'.w}O"ɿ%!B[{Dc.77#ځPIQ[";$qU&j+/jKrG 5B%b#Bn!D PwEEmCw6VǣYx !z" E-$rG "AXp-OQ25DODȿDA|"yy17X_qDMFHdF$jEEYv%wa^, .| ڊ#RwQIm: (RJqe-ȶipU_o玡APV|ߩ?xXocB2ȹ>`^_ 쳎uRC!\Pl}Q 98xY,ٶr;$o$o)z46h#$.Do?/_^ }ܧ?qN^֨6.xs!b:+l sfҦ6wA;QJ$ ? a^[ 2F*Ao~0}/Sk0r]TVJvp@ Z}K|0Lfr)) pAs5P'S̿shzs2Y6:H 0Zl]ջ?g~Ĺ/?oI,ơOM 8;7Kɒ dL Zws9IQBُtzkT4 pD -ɶ0oCyGt pWF+/3N('oۄN×5 t6IXL.Yν ]!8%hoښ)o Khl}iP,ԓ|wli;~ hT֌QFMM+?kF4v?mG_o_~G*$~o|7J2A< Ē*Zn4Xp |#wN!l 1H!$O.e͗-#tɶ=0oSy'n ~<{CkDPjW ZcmD9x7ڣqB_ZP;X&|b۹]UI?w3r%chμDٶsfm*Q:/ihIhXSvsb7AIgoj[Js y5ϻ v_ͿI'5fzٷތwk;{5ڣqbӏm7qo=_,h*UY'ȶіCqP Pwg|i?b[EU'CͿ ٶr?$k!+J#LjoPA{Obϵ3`Dcшo{<~L*ogNcgŕ;P5Mў#PU@"vS=wD4FqE!T!ȿ-{.rKuW_Ԗ=p%j+/jKrG 5B%b#Bn!D PwEEmCwQmQoTIY۽J/s!Df%w4q.oUABhmeouo_:f ȿEGf%w9BM ]{LKӍԚWzi:]znu&-g.K&:xu#\od˧d'X=#}6ӗ?2J/$ؔ<9cD+: 'ɿrr;;;܎=pAXm4]HQEllq,d- VyYBt)8Xh̐|WO$)|Qߛ~M//_xƇ]mO:/[R_rGsñG% CQRq#-ȕw^@Ȼ#J4#|&q ]iG1^O ddE5ɿߒr7;ԇn j_"m˪C?!ÕJpϢ^)X?´oXfb/V.;#Z'd/[N_rGsG&~VuMWDZu+ҐN?k6DwB_ʅpȿ_oIE"˹#FcEzwq- }i`#Z4d;QChfVéy4(PBW&krq @%KKyp8¡a'wq^W6駃}ubTkxd~oçŎ> u ZbW|YB3A%KKsp;Aa3wFv2/"V*oԩAS X TJMW{*Q9QCD\ިs:p%j+/jKrG 5B%b#Bn!D PwEEmCbwe˫FP  mA;T] TFB"D!wTI4.LuW_Ԗ=p%j+/jKrG 5B%b3{JJW!z3-n(=tz[F弡 Rf1!5ܑEP5Lr+FIa۴ 3t+ژd`RfW|J[ry}q2G1&򼭴jlEcC/?jS3Œt5c-_|g~+kZWi GoɑQV "n&ɨ(o&kBJ_/JJ;oXt5J\ʼn1]裷OST6nUH.GzRB qs33~+ڲsh P%Q ^hw3D+OmJg,M{ft*m?-Ql쎻h/N4Vbϩ;~<|uVJu̙=&E݅>A8q7tv#e{Z]{E;+5D[ kד?2{,k4fFf>\вEQWEm?~qh,4-ӻn^: OfO%K_>+<RnHn':CH{t:YAHbH-.ȭD5)KrBdYZcta QhbVߑY.7*fjqG1Z9o+m{~DcuX>dbY2: eS06~e*zԽi-iNgWp{%:*#!b372Pȿڈ ]ɃZsd9Z*fӐQ <߭gF^LGʼnʢq!x>r@)[.B*dFfVϮk"]FEZ5DwDnEiR6 ^{D#!D PwEEmCw[@"D!w@-QC ]Q[";] 䖨!ȿ-{.rKuW_Ԗ=䎆.f@|wD9_+K' 7hD J]N^O&iJ['&o C'7yGExwGYPJ%b/NUA_[:,K!e)0+;)'VqV4>ȿu w⑺ pmX_#TJ:&bԨB go_>\=+feSi%av/m\sYƷHy⑜!ȿ. i6J?kJIDWs7~#=?귟:bAm㿿c ;!-ǿwCEӥ` {ϏT:m  oࣵI pqQt*טNeuh+#ݹVNrc"@-:'^i\0'?kBu;SxmڌyJmx[RDFo#ͤ{"=wTI4滋_x얓xHşb_+ޥ~c5z50LY2 r}-M11JJr2ki˸J2G1_|+']z?Ju )5mXW*I }toϩXWm 460&8s*m?;ҀHQlxyrL%1縵4wF͝Tm^m)>"=wTI4滋=mvكG [+Z'Sn&:1g{9M8oT59m.| ="KމW'_/wzjRKohƻU5@3)1]IE{!w!]7|c/~M^D]'glOkOzܶT0bt$d,1}לv[!¹f30M5#.fs'^i\0'ɿa_Kf||[5_x{#)\IE{9w! J&L䎬yk~q#:IȇeIHGD_ #tWc;zq(m? |񓁛xyrL%G#=7)yLhFtfec?RFԟ#Q%ؕCeG)Otv,mf`q'l KՕ stN^_ثPΩ|E(Ot-mI(m|K%$I?{4DXS1{qb2.: *nV: { SQ6ޮ(!z-/*Fxs`MIDʼn@-QC ]Q[";] 䖨!ȿ-{.rKuW_Ԗڊ3g{(Ŗ-@ D&*' P/E+wҥm۶w>{pJ[50( </^mf߾}N`ǎUY'On۶mۘG:FeG]T#$sر#*ȭ[a0@Ν/zLYwՠZ·Y ;6>bm p+W(h_Yڎ;~@0'{Nh]&6Ê˹sx8i/ CD !s…=&Nx]v5fڤ7?\mphRЪVdx:նMF=E#N')-F(DJh"9"&8dBF4@OG AȈ2a֭ƉX9@E:E9)̰Vʜ' ٱcW.} (E~ܹ;wXtI-vGe/jEDlrBb\TOAQyl̝' 6KwQ\G ߿}vyL P1A_{~6l.B4ϝ;|z.'$#w_.ݻ_Jm _Aus5\ufj0D]@CDY ]a!L.q2w c+*= hk.Z_h;w%s"pt\wA+++ (q2w5H1DX,<]|&Osvm z$J]@ȸIM}+_`d֭w ~Ȧ ŹDXvE?j,L}!7"+wEn?Ӣ &seb~k_vBC8Qȝ/_fK3Ei)֜9s2&)dbw/HE%.ȣw~~Gi;E-//3 #ьk.Do|޻}ܹs˖-H K~+0JE_ gaIE%.?5Lv>~BW(4#vǎ fT0r.{y(0(f K. *_zu˖-O JrSY J w5AWit \2)n 5,ApP}UИMB[/mh4߿?MP"4jR a @D1Ll[^tرcva'._|Сݻw'P]  J w5AW)($aac6HիW׃G#n߾]!P]  E:-Ϝ[_>n~#D3]m*.L… ɟTՇNuwbtqJMVkm2Zn}}&Ā ݅+AU\[=.Hg &;[Vٲm|^A7`wdis] Gw7,@dɚZLDejMt)p<];sb7Hԥ+/ON_A ;43R+l,D3+ݨĬ 7OeX(”ùH>n@tqIm/v*ˡ^A¼g,׌`i]z LY0lcٛаLjYq Q%o%G&,Xoig9Ajz|sK?S•,An@QIpG ]c:ǒXIxh vݔ R+S2K,$m{KJ}Ѯ2OjܧmEK jg :>m{(BcN Spү1 d 7Hʹ:).BלN)s. B w5AW.p"4j]w1D(h*)s_@bP TR w#ApP} G!BAPI.&(*pC]@MP>U 4.Mr+rz߭_/eT!wp|$Pl}s>7}s,ִ*pCMzS":{? $^2~Bd}S 쳎Y wb%aR]uXL^L w?Qa*x$Xi^ڬ[DOw;-qiQ=yS ,ֈjjvp]Y}ը#rp|.^-<껇'kQ]$,}3x]S¯qiQyonߒ?bo?m탢M-&fҭ܅],&Ԅ \%t)7&lQ>pF}{W? m%O_ܳ]OC:laqC傦];wɋBO?ƋkӣߌމZn]w8w;4P|:$냢d!{*?J.&\(+ ^A4ykFz9)`>f$̙ wagݍ?@s_=wB_z6BWwh(FrAӮ>rw?S/E-&62*.%)zR靧S[(ťF/.BpP.ϋ~q7k0EMX$δRZ7V咾7sY Aeӓw鏼s+]O!+zMǃM(˾[/Nvјr(\д;v|ϼgu? h{뼋QRGX)_jwD⁤+I.oqwBr镛>_yB:oN} h}j7R ElHm^Tbrqw.u^dj…yΒ0(DYY戹U.?ţAayAU?J̮f MS'/<گ };REG->xds.M>rgn$=7ZPZ#܅(ZF CL-6߸P>YdϲkћҽtX\ibBP;߹鏼E(psZ=hp$YQ]8=b .4K'>|G]bxŚWNOseПte82+9$݅~Ϊņ9K°#m4Ŧ;Gcg5]@=S>. =6z$5Si$I#KX!?XhT6y?_,h֢fXPo0X`;75]  'O]˿rſ?vNi=U.&*. ]1w=s??wl/Mʀx.nT-DA]@MP>Km{rO [*'^. B%|A垚 xF;PApP} G!BAPI.&(*pC]@MP>U 4. B%|ph8]  J w5AW.p"4j]w1D(h^n?.^vE>[}J]o*yg'=ۻ]@M[>S5qe+y~g] 4ͫ:KƄh|+r8E[">w1DWwF4H3BKrښWL.K[Ws 7 o~X>׌'8ۧQD>ؾȕIP:A&Ǧ]O  |IYbU">{UTC΂IKT&Qn N֢2H^V~{fpEA"Fe\]2^>po:}yS!;N64>juwZ>S룻 > w1D:. IޖF\wV9Jfȥ/˻#J4`-@)ۯM2%Ҏb8@^(|򙲮Ge]٣V!wqSYgѪK0+2kuFLePY +rX&V;#@6iwAYחK|V+郻h~I'NIx$,dg/:U'OPݹ)Tg쇾 |軠맻 > w1D:.ғ{ w1D.K݅rn.$A_CdQDx m ;xY'7~2+R~[<3 ZLYדO|VbY Wt"w5A\Vu=uhN w1D(h& w5A\F.u r|V+ApP} G!BAPI.&(*pC]@MP>U 4. B%|ph8] -[^5Lv>~BWZ,4*h9qCam iDs_bAP5bP TR w#ApP} G!BAPI.&(*_ .>P~SuN# |w@WXhd#]PG"^jr]䎌E+קcf}:-=xK jNl"%Rh,>O5&sKRݚ:v*ˡ@PI.&(*ELȨpo@OfGޟQUwq?v1]&6LS[-hmg0HR*vbP{!TR )wwg'BO?xctVjM,w5V]#[0ab3⢉?lIf&Y.B*)S3( Mw5.+dT[كfbAYEy wG /{3f?I(*z5 qorp: nG8tpDixfR$]@WȨD`0k!,V/0vUbRhImPg;,̑QY+$;eiH`Tm`Hwĝ*i",B?tjE,@ )[MJ{i2@r#.+dWQVkaljy&LOj*^d$,\^΂}ƚIʞ }s]rQU+M?J~Ie92 ?۞|Oq 4ed90δPH"=%CEaS}V0Xc}Lt+9otTT0|8'OTt̨Ԁt裟j"=a>%L&Ji '40~zPğbYѸ,gwaO>w#6;ӭR-Zf(* f.}籗?Ă33MGZ2kiLy8}ҬOopdi+i3Yv*rME't] w1D XDZ` wdi|r?1O1ޠVxH!@ptw92*\6}i~HlMgނ即UIv~υ" J w]!w[=qf.⍓g?20YMvӥ _Ww? JXMW: k|kgF͌<]N(DvR R] Iꌈ.z b[Q.QpHef|[pw.P]]l~s~uBb$hk8XP?BpEwWE GWn:'@opGh:*@oY`d?,Jm2joK^+| =zYN<9~]]]d[(F -]z (ַtקO]yo}v"S05l90%-(W65mt.Jw[twǞ FF瑳p|?2X_5-\DӨ"Qך7i}t9[Z#Beu<)ڹک8;%m҉fEWrc"&@ox߅pw'L,CL=Pq+\[0[ț5p$i0p2j{m}W?Sx.T'xc"'@op[كfbAiL=QZ؀r71WRJiBHO_Q*fG!/| w[2/ F`-ğ6z[_6Mb1wJMlz.BxhkEϸ %T1Ŗȁ w[2Ŧo0^sf0~a҂9 3iƸge\b}Ev !Gp%]dpDn{}Kj^L5Id /dbF-ۼBn>q -%܅e?z"l~]<3*٧r,aPqLJBħ5yҌԓ,όmjXbH-e.)uFDUJz .z Iƭ(.*RD w[.P]jX ޢxNH,$mc GBh!H 7UQ焻-""Hr7RQG- Ekk'))oS?1Nu 1c7EJ-+Ԝ~U"&sdT!w12:-a\ߡu9[)1^{'wb'gZq w[r]ىOm&ޢU/ai{厘81xM] h]|gQbAyA7߻鏌doѦqAV[?jv&^#|S׏!9 aN oQGI z\*^1'Ư{+~ w\bG]bd_:Z?rܐwdT#f@#;nNHwȮ R3QQFXWHP6(px͑jc׻?mbVw#f6wVwR_aYc<`E!wiBHQd\yIgʏ''>/[d,1 OwyČ[yE(1T X"j%O1Қrdq(sJ}SZc}fTmF 㘔Z󭽗f>c9! XVy (79]܅/=ƣ, @o]8pw.P]jX ނ@ w[pa.zKe_u"GGN w[J\Gh{w(|pIw6-M7L]t_ ޒ.n|4ƕWgHl2O׵JG/OU1.%;;Yur事|b3o]lZ)}ɋ7Dj3;|rT̖#'-9wѦp%][rN uS"ϻ(V iV-..~)._M<[Ȩv-ϻ\"OɈX%X]wp3M{ ?[t>w;y w[ʽM/|ګ`\y^ <3*(Ady<ϬTpwuwFs)G w[.TIQ.z E4bU-q.z 5,@o]-[j "]}Y+ ԰pw.6v_FTQ.zKqwww 7RQG- SQ-el2M֒mfboz&AX4(RtRS%iy6Y4vZ%ݣFɲhH 鳴6%iVzD2Κb w[JVZA+串R׆o<"w.9 w[k|M;?kfNHf D]ɚ*|RiXuoҏav-J%vZŒ+8Igp%]==Ͼϼg_3Ofဨt uFiNr;;RmVx"g܅zS(DfO=-1ƉѲ:'^I:I?n{o=?X9a̟0 ,KkLÓƺ7ZwLewQ]c)ŔHmܕN0 v̻] Q9T8>)|Қ<{iJٍxc9%̒iݣԸQĘ݅剡']Yݍi1QJ}.2w!=w+pp%>bA~:3<͒ԣh"=iOjZfwQͤ w[JMe%..J t]ȣϽyWwS)A9]h>*^PDž-%([ 9w.@o]- ԰pe˖WD\~ TQm'M&IENDB`java-design-patterns-1.16.0/factory-method/etc/factory-method.ucls000066400000000000000000000157421312550536300251560ustar00rootroot00000000000000 java-design-patterns-1.16.0/factory-method/etc/factory-method.urm.puml000066400000000000000000000025621312550536300257630ustar00rootroot00000000000000@startuml package com.iluwatar.factory.method { class App { - LOGGER : Logger {static} - blacksmith : Blacksmith + App(blacksmith : Blacksmith) + main(args : String[]) {static} - manufactureWeapons() } interface Blacksmith { + manufactureWeapon(WeaponType) : Weapon {abstract} } class ElfBlacksmith { + ElfBlacksmith() + manufactureWeapon(weaponType : WeaponType) : Weapon } class ElfWeapon { - weaponType : WeaponType + ElfWeapon(weaponType : WeaponType) + getWeaponType() : WeaponType + toString() : String } class OrcBlacksmith { + OrcBlacksmith() + manufactureWeapon(weaponType : WeaponType) : Weapon } class OrcWeapon { - weaponType : WeaponType + OrcWeapon(weaponType : WeaponType) + getWeaponType() : WeaponType + toString() : String } interface Weapon { + getWeaponType() : WeaponType {abstract} } enum WeaponType { + AXE {static} + SHORT_SWORD {static} + SPEAR {static} + UNDEFINED {static} - title : String + toString() : String + valueOf(name : String) : WeaponType {static} + values() : WeaponType[] {static} } } ElfWeapon --> "-weaponType" WeaponType OrcWeapon --> "-weaponType" WeaponType App --> "-blacksmith" Blacksmith ElfBlacksmith ..|> Blacksmith ElfWeapon ..|> Weapon OrcBlacksmith ..|> Blacksmith OrcWeapon ..|> Weapon @endumljava-design-patterns-1.16.0/factory-method/etc/factory-method_1.png000066400000000000000000001350061312550536300252100ustar00rootroot00000000000000PNG  IHDR26*IDATx \M%7"K. ,KFƐLnNI "4ɒ("̐/طJ mZg9y>^ys>{>}ν{KI(w#e S :M>S48CP'G"A& @= AJ!!2R)23X&%%NM  @= RoߞcE?յuk9Uѣ?4!++05kV;w4HB,@98CPe烂\䥼8cYNN +#\aSݻSҔUvjPԃ6Dz7jd`aNcb lҌE7ggGqr wX,vmرvӦ RCCt}ǟfiij`PEzUqu07kmmSԴmJΝޱc5N<异iR6BvjPԃvƲ/S^2ũ{trb=DjSի-=޾9th;&-(?.d/~(ɿWE~}B=??Wzѱ̙#]]]=zt-&=wܼ_pwj P*֛7!7DO4OVTҩB,@98CP\AfӦ991;9qЍ'99N %AbEJCh<뉈ִi}ԛڷoJ"ݿD(qۡWe͚5`Þ> AN_>;Me(gA;cuVܼyVZZN&..^<Ȩ fA4`@gÇW/E8qưmn^W"-Oٳ`elerw4aNni4e8K ۩B,@98CPZ˘<:TfSn}|~N/efgG{{/nܸ{%5iRElذFuX&w'.q`, gQ_ˤbm2S'K6ɓ#n_h4HO!Z+23屌).Ηvm]4je-;K_spa$SaZG)II,#-\??RbMr޺OS~+w4MLyr;Ve(gLC:P10(z(jeniiڸq˝qowsРdXfk۾L7m2){IOn,SS:PIKh2T @= FIIe>"Na>ӫUv&S BLe(g T @= AJ!!2R)23XA*Xrp HPb\qUg:>6hƸ jSUA| @= ?(-%LԦC4XZ1;*٦z>Tmbz@,e/!<ۻ#.p &jS$2tiʕ+|M7oBأ::VXNMMwjxqe8hwժ~+23X&n'zJGi 72Oyދu1ؽWQ2mv: 22B,@98CPeھB#ymG>3tx޽;9@:4cұ?GYFct~Tnɓ=|(o,rʴM5iROOW_Y̚5'O4opqnnNjU0 YYFFUeiiڹ5FU.0ɿa3F--23X&YLyeL ;DAoh 7Ų )O4)ܰGXFqze~1hPWOm{6"-R\k׮)5D*yBqROI /G..)јK:Dr6hPoߎԦVit=Cv:ܼ.OjSOꕇ f`PYC8B,@98CPeҚ0>>#{{! '[Qw/}oYϟer1b֎Y?IׯI7Y&8'rbMKjX1m-Rrz8(--T,{-R5k~6mA;#*2obiLjϚ5_pXrpˤ5keQkfltvJ2OjƠpJQj֬JԮmHY̒)2ѣ˱ΦM뻹9Kea]sS{׮Ԟ;wDU, ]54ZtrC8B,@98CPeڵu;;DGoPzHn?c[FcIb'6[wv[̦~c*7q„~6\6GŊzlX֮]S6kVx^j{y-,d,n ZC'!!!2i=yJ1gzbrIJ;Spj'&RŲnʜNICf׮a֥F ^Kqԩ*nZZXv7[ŲZQff$;˔ @= h3ckMbe)kk6mSEJ<))[bE(귲2 \է[ SnyggXM֧NļxW%GEy67nݴ2et֭!QjXfn^i;$eXrp ؾ{L 3ȿ L&-*Tгp7{Ayy#Fj =tm[w$-8 -RE4ZXQon.yI˖-fdX\e(gL8lʘ98`\߉/(aB*>WRBB۷x?%Be(g T @= AJ!!2R)23XA*Xrp HPbbz@,QuB"o$99lӦEB,@98CPe<*++*==3cٵk{\-23XVd8;;њRѕ+>Sӧ!""рGE6k`UT'G.[6ŲÇW^=:32شFϞm߾=E{17>W^6G~-Z4mR'POIIe ZCŘ>UXrpˊ,/&SOykN2e0-y¾}|ڨޤI=j=ux{n obrQ,0ƂhHOeqڋxb(2Ju( @= Y Եwv22M`Oʔ$ML&&FƲPKK;k 7xp7jP0Kb;6wt({eeEScٲIB,SPbg*==Bf1//[KNS9&7|jjLχr"23XA*Xrp HPbbz@, B,@98CP::ʡӄ3A3P A*«e(g T @= AJ!!2R)23[P n@98CPjR)ZRp HPbbz@, B,@98CPeRe(gA,)tjj8e23#߾={ bzr,5kV;wt!ӄg϶7baYБ-&$. 1s˗SՠA]+T#+oބy;egG @=9Un@!\}b#{slʂ-ţ7o/1ئM~tXrpDz9!pH^gXɓURwviI=<\o&ٲ٥K^*Ӧ ULӏ:/_߿3[w؅)RuΜZp;swؼfͪT!C\̌6ի~`n^,,-M 4 6v[:##=kժ Z5k{ŮZ8bDOڝa%mN+V\a/_Wt4H}t Y/ Ʋ3Fˏ}1cl`40jӯf'"PpIJ~~>vWA2%ի|X݋> hhGe?AUU0߿S'K֦m0]^ԭ[+QcݺiuHE,0 @=(e3N?`܎I)(9Yfm33czrՍh199bJ_>EӦ2}8Yl,Ƚ)wkhks^MiZX~;mhqcڽVLK9)SFRұcs#R_>!hP(Z"wRXFPH4CzTܽ(:ѣmۄ9_2 ԃX=}ٙe2ZNXfjZ/0g7MbP^^,uRD32bmm*#Fs2ܹ2Lvݝ&L.Fn,F}-O[qz,׬aƌ?4argIk0M bcRZheeFүQ(hHT%7Fmۜӧ7uB^pI6,X0NzB/bgAQ,3^;lBGkEꔉe߰{q_K=G?2pi0wС2Lvlͽ}ɑU\,5d+ٳ-7ϏuVe OCuXБ"ͱbE=ڏNOX;[l/JN{4> 60(/}PXWS ޺u(:ऑ#{1_I%"PpŲm<ǭ u[umI7jlw2vCtpiXQ,{preCv^`LvnUnԩC]]Fٲ_x[e`_Cm???QSF]0&f͑*%Btss^Fܸ/7Ư3g6_2 ԃ[{/NWw- P(!jeniiڸq˝˥E(8~= 011?L,zt4ԴmPF2%d&$/Ѻff({doή +TA͑ %J0t(<9V_z^YcyA%ƦtHUrcѱ/+w/r8MR%RаS €32\aA %ÔSnŒLNSarC+pbUnM s$kOLIf{m+i[??W{)X}4MXrpq%TүMyy]^HU;e`33"`XrpԮ̍_tU%# WO"F,/Ny/bz@, B,@98CPeRe(g T @= AJ!!Ri (:YYYʕ㻖J-,,֮]{-k b;wSJufhhxb*lٲrt0֭;iҤw]ϟOr͚5Ϟ=۰aCǎ)]Z fl>Ըuֺuk}}=z]͛|W(>y)0b͛G:ujժ緼NZZZƍwȑ#&&&KhYYY( ܵkWnݪTt9W>|`mma+ nݢ,1Z֭ 0@qXPHʕ(u d177OKKʕ+$@1XPH@@@͚5*4imNN׃/5Mft윛oab Doo^zM~~ϊ[PA,B988X~7nO *߿_j{oذC4e ^8B?ϟ?@d Ǚ3g^xw!@5{챱Y@I 7oެQG!bŊ&&&]@= $޽KKK;qӧO|/_8q"^6@ ǛeddF ƍw! mgʕ2J"<&߅bZJ^^;5pҥ˪UPDR܆w@>|/^'Xq-y|X=zEi ]:tޞ*IKKc.k2C yߵc|W(eh?^d 5222+III[~M XVP^0@,11ҥKN23yyy111Ԉ3)))jպp߅XhLfoow!@(}hzk qiӦS0@A #"" b"ǎKOO Pܹ`jZ ѣzꥤ]43G] IIIw޽~zBBߵ Zn-ɿZeSS'O](az)ߵ  233}}}.T q?"X@5>>۷|J6/^|ŝ;w 2J6ƍA@-ƍM4INN2J*ߧNߵQCq?77B:(ܼyVZ|WD˻wﲳ68A,Dp‹/]9g- DffԩS%w-@+}6b%iӦ͟?*1}o*?e ._L?O8w!@KawU @ PLfmm}e|qqq|@  Ȉb xiNNNXX؋/b{m|7ׯ_QFBB߅P2@,.^hjjۢ6'<*A,XIHHHKK R|@1oiiI?AX@իz5I(NT ih"*! :(4"!BJ \TJ4.$ih"h Q HDB"!BJ \HJNI4.$ih`CDc.zC ź~kn^̘4mڰ(ꏎѼyC竝 d!jDc.H烂\䥼S.4n\^&&R;==O..%pMTvB2 dH0Dh Q *%%|;8<|S_^laaR-[1rvv8p`y'rIZWt|I!!%u[Ύ?|ݺ5V^nMś֡ЎئvB2 dXP0DHF1DaӦ ^2ǽ{J:9q.D-\CmrGwb#s|89^rk\H_ڹUBB[*ݿ`>i@M$44 QZ0D\ \HZkMf(Ĺ]YݸOg*]h1HJ:]^jjxzzDJrq"밴4[BrpJ33#Ir{8Dh:4;!&ѸH9`҂!J4(LB2:~|U57osŋ'UMg NЧOGI r1]WO,z}~ Bn V20(?uP=4)DhEۅNHZq!LCseCW @ \H<:TfSn}|~gς˔Ύ^ܸq=I]Mck cԨ^ c!\\]ժU-9@WT]zz+s/TD_l֖y^"͢UN+fgq]%TT*ƅD2 ͡mXx䔑q݀tO+"h Qh 1Z⠫#:{ae%s8R2 n4zHGTժٰЍzze!}r991eKT\ozyKIJJ:M45"]ϋ\\sFV̀_ dC |nifjZGDlԝE 0*bx5 wiv7tt(*>e[9 >g:0?(|<=y{/ׅcb_B3mv: :P͇h\H$cnnNtpLL6PfU9th'(QL=iwNvN xfkA~h跾,F ؅Tfffl$ɿ6ΝءC3I=bD5W03]~`ukL<@vmӦ1{eMԣ2b֬Q=<9Ҽy Ƒ֪U$$d}hfU7o ۗiVΨ^l4I5Wкf7 /ѸH9?#J-}n˗pUEDFC4lk\E!0kAz恣wLSM=i4NFXJS.t~ҙKF0&"YDʖbРm{6ɔڵkJn#27oBȔh;/p}rOјK:Dr6hPoߎԦ:+Vԣ6g= sM=իW2AyZܳg bh\H$ctX"{ h(}m_8($C&Br^|Jzprq拾&Q+7tY5+xgɒI;(iϟer+1H|IV~Mj߼Ϝ'#$R܉VgcbbdcӒ+VLf$[EǏ(2J8y-5?P =VyEMfR.8y%DB"C$w#ӫW[iӘ_bqk/ Q! q!Ntiy+iO۬e@qGG{ѵөS9sSe,ۻ.hpjW9 vFچL|8bbvG~kBٴi}%ok>a]sS{׮Ԟ;wD|.S -:9 X dC{ |04t#E%tɋ2_Ih Qh qw^U>%#@؝) @{opEʫaGHOόe W)z;wΧNb69[2gޡCk0uѣGRq^8_2S6VOrT\qcDԪU33#Pk͇h\H$cyyFq۳ V[X,33'E%3B1Da=.$- z=yQ'Oj1`ܧ 0NNB2V6E:SR¥W$~++U}t=s-8;;4mZ:_ IlܸuӨukH\*7sO;!n$44V' 14+{\MX,0a( Vsm°H?M=2^$QpѶBO[PAήQnE 1_P]O>}{۶MJнW d>g.H6"2"ZXQon.yId>˖Mbef$44b}t gdpݺs{H&I( .^}#<~wP ܆]FR'?Ac߾=/H8 dC S} ]_23 S1Da.A*ѸH9`R1Da  dA*%C&p!R)ѸH9`R1Da  dA*%C&p!R)ѸH9`R1Da  dA*%C&p!|Μo\.t,F6m\-ѸH9`< XR$C&p!.tڞ;>qK4.$ih"! \ɉqvvѣ5+>Sӧ!""рGE6k`UT'G.[6+WBllZRg϶oߞe>ݫWW֣_?-6jS秤2b̌O* dXdG1Da*N`Ow<=];uʔM"GQ߽Iz8{v_.ɅW,X0V$^li6Âmx?P"h\H$0" =! P5{(__Wnq۴iq̙#i1<|c_j؅[E E0 ѣm{Њ޽ۭZ=˗ǎ7q.T!O@@q!LCs,H4(LBEVHzxYFW/}LɅX&TBt]@/{s_Kn֥K훒RS6n!kRƍ}<(J dXdG1Da*g ԕbcwed0LʔG\z.jiiJyt^_܍d&|ر9]j~m?pj,[6Cp!uI4.$ihbC \3![%'{ez>|ƅD2 CLA1Da  dA*%C&p!R)ѸH9`R1Da  dA*%C&p!R)ѸH9`R1DaS :M>SՃH9`D4(LJTX.E2 C ! h\H$0DR)0 AJƅD2 C ! h\H$0DR)0D4wdJDc¤.!HJP$0DR)0 AJƅD2 C ! h\H$0DR)0X֧ ~js:1'DB"!BJI]뉑?O *6ƅD2 C ! Ou!U LJ:̌|{1 dC]2//'FZлwghu}r*q{7 :zG Z}7fͪ4 Rb9@J,sN[ YYQ.yו;x̑/{gd%ѸH9>3QFYxBLL֭1lX/AGI4(L>5{޼ )m&*SPc rmH/2$EsƾY{>~.@|I4.$ih|.@mmSXѫV}ojZ7JDcD VGjH 2ش)EￔRh-Ik;ދ-,LʗeK3y׬YuAdzuCfNm42tiJH]gX;O{{0Q$LCthk j+ vJӧcHzNOUZrrċDB"CeyyRƍ3^7]8ߟ5X&?Bh Q(q~~>vWAR}bΛ6dڳgDLRR޽_hӰamvFs# ùrSNNzjKoժxy-LHDcvhWO1/يܺ_ɲ( ңFfhX),ls\/Pff$g\II$ŋRcٲI3v.lv52:ht*2ғEq!LCs|!?Z :-ѣk eGH4(LЌO?_y"uJa DT^㑙Еaz 5]ըQ]I8N]q5kրm`2k&M^Y^RHCCY=:k֨~Y܆lGEz}rl̙3[??ZjEɎm/?~:@H4.$ih1Do5Yq=zXFVz *Y! E.=}ٙe2ZN1L:q/ғ|yyO C02bmmմi}tww0^zdrVssS\`]:u(9وi69g7Mk7ʵ~ eRa&һ9s$Eq!LCs|!^]V5KAݡUPɒh Q(r!&LqdnOZN1Ee$#Fuf_K#G4iR[ɒH`*2:u L7o%ɿ!114;;utY9OB72F1Isǎ/ ds Çh;Ș6NLM"Pɒh Q(rm<ǭ u[umI7jlwN1,ݽ@'>'E m+WH;K/ l5 7oӰ[MWzrAG@[ZأGkZwvRٲ_P1rmTrٺŅ x? ^$44$43%%|^R*e} ,;\{/NWw- `L={(e rz.$RјV--Mprg}riiԿ~tYmPiޣF"#kKJ됚^xۡm)TشڴJ߿?"ѸH9>6mI^SiذΨS:I *Y! rd pj!-:UuF9~*%NwѶM\BƅD2 ͡.CLLe* D1Da)̫]ˋҥœ'Gmmmi0%A|I4.$ihb!f \H/:zG|ɀ{H h\H$0 ! h\H$0DR)0 AJƅD2 C ! h\H$0DR)0 AJƅD2 C ! h\H$0DR)0 %%NM-tefF}{20A&ѸH9`T OP4(LB}7fͪs.~U}ٖ}tX.td 9s©jР*ttJe_Zxed-'ѸH9`<aB-p! !PJwr0պE׊G۷up+ kn7~ЪbSǐΕԾ}OoAZq!LCsx*3_&0QBsB6FG]3vɃTػw;J66-Yx{/0)_˖-.]V6mbee~IWA{xI{.\S:gl-ҹs;vlNWTϐ!h.ffaa nUqu07Y:,-M <>$;LLZYVׯOYjqĈ;CJT [V\€_ZO.+Uҗӛ6ȅHz8Yl=n\:==oߔ6K ]T~tOR\"%ֶmsNԥK E{Qt%7.X0NzB\H$0D" Q{ Q(r!&LqdnOZN~e]{q_K=G*osOCVȸl2{ɓ#85d+ٳ-7 1N%z`Pݺ5.t$S9VGP ,IOX;[l])EW2r]>BJ ի)nh/8iȞ;v̗yR j"s!LCsa0D1Daȅ&.*mI'ݨaݑ: B.kz884jdȅ<8\\YezBrs?r?N-5ʖݚ ѳWPϕ$s~.0R=ڶvmØR4G:d]5tnؗ{:+WZ8Uu54lXB*w/8uk >͙3[B\H$0D" Q{ Q(õǮ=|qWjТ.DЪ)˝˥E(oOLL+BrC_?֡J=(SF3֤]HmI5$=ʞL:pB=t(9҉I't(ڕz=թJti$} *.Drtn{`݋NSTI64Jh dC!j! rd pj(D 3299Lg=3sbOi[_0$]K6Y(; .Nu+"UHcuʽ,r>O& d(S(?=Jbhˋҥw=# *.wʔtYX[[=},߂DB"!]0BC С?!dD>z,^hd@"씗ƅD2 CT`p!R)ѸH9`R1Da  dA*%C&p!R)ѸH9`R1Da  dA*%C&::ʡӄ3U=dJDcիW'$$](V`x99UٹsUVV߅ |Qpp0߅V͛o](>}y$3 ooﰰ0 """͛7|2C>|ZǕ+WpU% P @ \|3##B@{yAժU]w!@ e=zÇ|.\w!@ }bOrr͛߿w!!--m111|4b۷o̶nw!Õ+Wڴi+e@YYY}(fˀ,G ۵kWtt4߅Xܹs;uꔙw!ɓU^|BA,#;;;==*˗gyXÇ;vHIIv>|W b^jUw! MMM. 2w_/đH,--Bz@,v233}||O P:77*z@,j(Y[[ϙ3Beݻwwww˴]%99y̙< i/111K@@,Rmfffw!ԃUL۷o:,[[۠ ELx捗2622 !66vx?XE%&&[/@-X*@Q@,)((.f!eVV߅OL+:téw-4NbbbTTUāX&$$]c̙|W> 2s֭L P|8q⯿ G=|B%dX&f>|Kw!a۶m[Mf%2ݻ}=yBڵk7L$&&6jh|‚X&N^~wAttq222.L;w*9s]Pbؘ>}z׮]@LT| Ϟ=[BL<o=eڅX&V<<<:ve 8J6iii[^d ߅A,.2o߾X+ټ~;!X)*~ekޝ뗫PAݻO&deE񇷙1ŨEe38J0.\ a/,7|PКKwj"y{jVNN Uqً>iMGbb ޽{ff&߅Sr-Z] RRׯިÇJ:%eދ-,LʗeK3ݜXF9iaŲkk7mڰ*U*ZYu^ݿg. ؅9y ٻwشSÅfiij`P&z^7]sߟ-Xސ!ݨ*33(O&B qEEұau1dD,m|WNO)& IwוembiI;3n֬ůES]sz,W0 g1UZ1.Wn$:btH*D,jDžÇ]NDNNǏ߽{w!@-QQvvU3)sǎ>>?Q'Ś2et7n\Ț4֢L6lXQzJo,;Le,Rx(Nq1С\,Fe?M??J92W0-]m{ʋttJ%'-_q+ h,_)Wb>~͛7.> #.Ηvm]4jz| :6Dcj6UZjjaұ݀PNYYQrσ˕+K65thw++S,==bE+W|ϵycʖի\,/rsϻ9% #+:b2Pn'bGMOOm\ɀ2YϞ='Ow!@s(-uTd`P>$d=PjiҴqz˗;1A]Y[0.ɰg4~=mheزe6%*JW4(gk۾Lqϭ^=EOqu2 LXbEnKSdk%PcSRiJH-qrXaIPZgezoGB,6"##U~Spڵ'O"6A%WeF^^^ZZ^0rB˫A_ t L ?:YYYl";ZSN@dgg/[~r=t>X() Ajbv}~[SǏyG)' ڴi-&%%>|8>>ǒ@  RѾ}p 5kL6h i0_zej~Kӧ7}uЌzƎ8ZZ4v6ׯI˝%5n\l/ JmmK tuKoTG+plh/t-,LQK^LZժѢBl3k(Hyv%5(pX IsRxDJ ,mtl~hS̛4YpK?HمYffdn(*֡??z:jњgdD)''&)_J'i ԗ;SU+sIT+obdZ=rxWZ\jϘ1By,{X:T*> G;vlEwX/B;!MKD+-CXį'$sWHc6n[k׏hɒԳ{"ٰamI{n׮̙#IugPJJQj֬JkJDނLHZv`*zOlhQ^^,el8qbe$ Xy>3)xD"kQ)KbBF&%(e-(BR)-ƾfT8ܭ[{]u_ysz=#H[`ik(q mu ^սyAĖ%5.sbbwIIiSSCts9!mbbhccMѣޝ~n[chؘbDEE))u*XlK^P~^yyedUtZ!m޽KX"խ[< ~_v "mm%n-C5׍3ڷILX^{їԓ 8 KBzdV/E,̏!nˀ vQ}^۶-!1%l!9y֩ "&э-K۵3__$S@ ;Eڲ$,e_YG K68H '^WsC<͓'Q0jB ,g7Aհa FY&Mt~/;D\-L(see04m`ϝZ MmVƫ"D"#},tkwy\ƿ #n-y0ț_sӀ;G%ö+8#CMXb*)I+*J-u9Sn-+dޖ!ekwWtZhqq̙ k̘))۠@L_:}BXէeZڏ5O\zĖ;& `D&= Gi۶%yzoO;_tdB1臆.B0 sC-0e`-C5{֭9chX|>ʪ-z 6y '99h/bĒ%``es8C+WB񃵏57Olp_~J|n- mu ϟ?ox0O :Stt4e$[v䈟d^BlŲwu*/ѣ= |ަM˴ɬ!ܫc%>aזQ C:ׄx;::{f_ϻeii b]i޽;ӪUS꿶Çx #ؑk!)^:_{'Ab?W-Cm̉{=ov7jFHCUQ% W֑?[FTT±>!GuXe t[-0mf=^]|~|"ET@%<,,L' ~}94p2-|~$G-f2nj0ZW#/&7qfd섴5|Go_i!ݙѣhM/^]dӤacק(ֳ;2edp"ccXnLx`nc}~{7Ʉ}Vζ>}tII a[VzPTRneG{z5"VO W޽K|IEq-[6'Q)"-C\-0#myH6B!GJ43| eĖ5{hϖ|ƍu`NHܠO={v;ȉasgSHwf޺u3HzP͍TT;:qmm{PG! Gpt~XY+H@ؗ.XWVi"öZڵPC9v ;C<$6T- S!A^5j"!JtVDisΒ=heq/ HtYigzX?.+y[Ff/dٻ'S Qԁ`WI*;!Aya|,/)aǎ)윜8(CSC_ԩiwg ٳ7  \׮ҞNSRe˪U*ACXsl?2%͂[X46~=/ǚQe@dF0J#0Җ^c(j Sv~kF_:rCϖu&Zq:lD[XܴSY+@ξ}Mwo?w89U O ќܿԢ>}USk@.4`QQjذ^_Rb=|PYI_R t,N22A|&K3SY.%LKKGF15Cp@de( F`-Q?Q.-IdCҷ&y_'C+[Fqٲ;A>mJI&[iCkZ} 0j}pCKLaQQ ĦRFCV*gg[r$XO3૯MVEGE[Vz1rΉ&%D*GnYbȹ+ްn}\"-C\-0#mLlQ+L:-N;Z'1k;D_LNT(INH\c&z>+Mfipa}4o۶%64n-IN&KUv& mYrؤIkJJƌ.bZv~uٳí[fTY-Y Syu; *c۶@*ꇰ[`~bhlȐ s ,fo:vL^ek [j>||) R*PI˃aQWW ,\`z?{3KKcC E_&Mt<7|+X43k4 Tٲp< ˆ U©ﶌ|7a;f,mU?V! } F`7^C9e) i)>BmyWh߾tnJW_9/11v꧟ ԅ^YdӠOH4!/l>u(X0a(/_nj}B/=/%mZtF9Vse묘u;%#MO߁5Cj"lw~beyy5<#''N|b,$ n)U18 k<|:fl.Da,(H OxNVVURg˨׃OgL ?|; GGG uQUU%ߋ5ɺofbccfgn.fb" }4]l9ڇStt4Zjڲec`PF{*G76 I˳N z˖y=q4Ue庹gk!ģje01HVPSP$0;˜_429 ۖ-$ L 袢x/R2[WP_JEeg$''''ih+MW m~(s͎KVi#U$Pjjp޽;_йf2"__޽-HWp zU1P~,,Ԡ}Đ/3Vjj :w6%/u뀓ͤIGKvB6 %J͚5VWW0~OOO]&Np k-(r3 8+ЖxH>lڵk!h"eee26@O}khh~uܹ0@\ww!C@& XpǏN 5d>yDSSs߾}/_~.Yn+V>Çg}<8tP޽IqFGp۲CELHb@JP`uяVMWOyk/eSĖ>矛sԢK]s_B@!؋(œ83u'!Ѭ^IIڸq6d: kvj-k֯QzU1)Ws玃UD!v-47=y36ygLI}^;E[ΊS`Ç}H=5gϞ?$lKr._ܶm[8nj۶mKHHׯ Rȿ&k@JR Qϟы11Կ?RE̫WC7oıŋ]~0]]M!G*m(eN˗ij},diiL|G4>BI/#DtrٶmABf3w ENJ&e(][,={;;;@vaȏ0߾}rN8Ѯ];Skjjb`hժUd[]Ne%1 ::zȐ!3f wA wЄgF<,r8vlM׮f9D-+-MA6mZDDp ^U2~!Q,n Pfne&KWY,0n[n_xc8ml~ޛ}ð 0xGE7!^>?ܜ<gD[8 \\؏X-:iS]9ζ-Zgdq`Ė=}#7mlP)y\cZ(ر ߰a6 ۩/rѣ~r;}r eVVxEg)-+.NmD(Qx)nAaHPḤ$ j`-[6%Rt[Ɩ]rݻw)֭֭[O755ȀzXD]]zj踡//^TUU !ÇT5_~!i~GRHjلaxn߾5ȵUm~ihH 4v`@{wݺuȼdD[3$#zY"FluScc9֭ZZZi+Fp0L~< `ac|UM[ruN{#< w{x8 Ah3`߆ 5f@Rcb?~}BXէ%`5uWAc@X_llssQ;2 htdB^1@ ]SǪ 턄͌l2 r G&oz?~Q{s8q"(<4aa<_ XiiD$t# =$lA%qo.&N^ʣ 9n"A{ݿhݺ3fXyZ4$""|ɓ}bɒ%``s8C+WB񃵏6U>l2 b2a`-*_>c ]\\,J ڷoNW90Q+/CZˣ0-h3 ߖOC4eH[7ϣa &$%muuNQMxą)d v-vbG?7oN؍{„@̽ Cՠɞ- &-9zhŋO(i+VLQB-h3 JR?Ξ?H<{v|޼0\(|NGG,b19-"` >rÁb=FM~:gTP#Mk&s~de U08JH)ɴ- &1""AV0J#H[qС33wzm0SV<wΐΰ>[XŎ\X`FHnco$Hjjp^]]0ږ'Ab?W@,۶ k"ϙ3L;Î4a guj CwEDVrQQ "/ #SEVdtdHmˈ6\hdϟ?à={lvs&[M%!сOeE<2ȅLx'9jT^b&~2s6{rL-23hXф Chdvsmb?V!()ҷ֡!48+Жx >(ua:[lA^^"(ET 0]kL7y(IJ m[JxLa?Մɺofbccf4t1q#>%*HKKȨ_ͤX>+ކOVy)ݖɣD͛720h?jToO66[#Ǐ>++=+F8|5UUUHX[Ĥle?}%Z %%.[F#"淜4 2琷pL m$AIH2JΥgPR³e2y^n[qo/A~ز z^E>=GYYYzbe kv{,l&N=xp.WAr'8{ꘚcz]6 dyFdyƓ߀I0RnCBZ5ҥNN6& 9/ 6ioߗ %]\fiii|f7beNvI''p eK9'1NJ&e(B[&+2r5؃b]dmUSS2z&gώLv[VTrؚ[y\VM|InH ƍnN\Clѣ~ cc`&z( Au'!Ѭ^IIڸq6dn0 հ0ׯO'z5 X,:z!3f (|Ȅ "m_rǽ86,̻ʣ R$| J T-SLJ^>XQm92sN'''oР 2990Q3f655,.NQDw myqd | + f-z B[&>Μ9ӣGy󦉉e+VLɃ#x3_ J (Us8fTO .##yդ *Ė99qQ5-ō7NLLŋI~rrrNN{gPR"Tr61jwNլ^VMdYs]"S~z~Ĉ l^^n::nٲر1pi6y޸l۶/oիcfzӦ9~z^X-$ " SydNLHXem(-ApkؼIO|a#$`moWK۲$UU#a,g@` (w@+0Pzpnαҥ(+u?5ڻw#F #Ui1mU?V!; F7{Y?6bΑ;+! j/bPR2,zzWhvJ\gg[ φV-xuޞcàw[JsjBm5I XJX-uزXf˘QR+p'g*y5,B&{a-mL> PR-N G_dV-\Ҽy# /vÃ-bRjS+?6`hxĈtŋ{S#fQQ@Ev o86\7-r牅,-OXL2ղeR2˗1ZZj$*Zw8; hhU2aAii:ٯi""D"xq:w`We4/bxz-Z!+.NիY>[ F7O\Ą,~Yu X1Y(UZnAAҍaPi>yEuO{֯Qz[F#~1kɋ !: gEO57<܇׬ 2߅[~;4ZHAD& VR ,gY&4tꔘ^?05nC%~O{|?@#nd~׉> %QqSc ? k:YV !7Z &k@JR ]f஺ uNN6*oÇ0a(2Joa27=W˝ܼCڢ8OF(P220"eX-Gj"W>̈'EUUU^ oRQONT}mW܄ p@XYݸqNAARVMo_H2ׯ&??^Pܹ ;v ñ mujӄ۵3'Zn&X)SFhE/ҭԩ=e$fh^-0NJ&e(W֑&,Ƚ[`n˨mu K4r/A2ChPd\  -z @@@de( FЖ 7)r[{/l,r)6cłVZ2,nq.\إ\'׎xN2FލȨٕ*Ɏ`fwj2rYT DSG w# T*"g8<~lĜ#w|W0,B&{*bŋ{f qP}jj H1ѐ{-[S_ٳ'4qvݵ8Q)U˖a=z Z &BX-0'g*y5,B&{z\9],J#GC1!$NM$n az3V@ KLbOȨg˰k=P-YmJneuc"xXEd/Ck<=vlM׮faDѐLAKw46#"‡Cf$#˗1ZZj7fǎQUϖa=z Z 2ȅ#kS|O_2 n%$owLb**߾=sX55U}|!#`TzC2wJxURV GCc``r%,z 끼Ec(Z/n bmT̈́#h˃w9l$ސE2=S{Xеk۷0jՔB{ Kw-+KV%b-WȢg˰k=P-YDx[68b@񺇒Zakɋ )J=y^ 0IxlK>tZbȢm(X8S][ƶ)Of[`!0@Ŋ)3Znv:_Yٯ_/N@O˗/c$,&LJ@|W֩-޲<~| vt+YXu%fhhQRUU!i[j& Fude߼#''.2~' sa[&߀W֩EL?iِ۷/tpߥY^K%)CߙPK %@-0 (QImJLW܄;Q-[jJJ'KM n޼yy.tXoﳰ0R!!^fftlz^''Ikٗ~s!& beN&Np R-0NJ&e( `2&:"h¼&V,]]avIH4kWR6nްں]|c54T¼_>:H0d׮uw'z9H}?u(LL?xNAݖ:wo m8QxI%LT}Vdp8V4-CTϟ?{xx@} R j3Qή#~;e͝;} ƫ0%8xQ@!/p48c6lի\PDPV[\sibeX+0[}yA 9 Ж1NJ&e(EQQ|nP:@k|:֮QRVe5mKիL//7SSCXǒ*0LnNݿsi⸷f۶ (}t,`Cj£G6mzA~ %,''Q?U@Oj|"gB[&Voa:DZ&Ԑ+W@b/_d:DZlJLL.ZБv!e۶mM402ȅLLY  69D>ӗ-[V\\t8 2ȅLܽ{wΜ9W!& 0d'OtII (hP"2QANFGG3 "`CDLNN|:;;o۶X e( mHؿll,$>~t,M =:thAAA^^^EE(eyyEE)byqqjnYH(n-=]vŗ_ BM#O<С͛7E-[ܭ$-͚ivbvF\ ' wjׯGMO- PB[Vc/_Nd:Df&'OPXز ,ϵ{tt4BƍsZno+(>y #P<ˋ("9,X0x`|TSLe b7ɗ v̘aNN\J6`ysւQQL '&nOzm& ٶmKݺun֬7o{~ر5آ~@aztQQJ!ݫW` B[&._AP`C$GEEΝ;>}wÑ7ز_M֞ !>}J=~|LSSu߾e/_89 bM Z5^=eXܴٳ[]KY'O!=[ΊS^>0|x/|hFZQQwFtjfdԌJCCV ~,DЖ֚6mz]Adlr,**ߴiӱlc#㻂a2W7lݫWG| YxqϬYcǀׁb[efVSk@"mmu}֐زeͿVoϞegdv׮" Oh˄ H?L6f(((8|0$?Ñ2>I>ϭWɫa2f͝;t~X9:3&/G"zpvWDz>RiѢ$֭03kİd$Ж ß9`@lrÜ},_p(B[F(--X1"`CAәE [zth-[ee߼#''.272 իW3`CyjkkK}wi?dŖdH n˞?URRricAnr@>|xnn.H)hP""۲ .>{@Bq"s9ۼysxx8t8R2ȥ,55>A$"69D)++Ϟ={Ι3X e(Km٤Ikz!A~~$޽Ñ QBz-!] AAQ"dee褥1 ʫWZlt  }>}z)H:tnBDx=zqqq)m"?,[y敕L m۶֭[S71 2D|rEEō7"""A)%++ >WZoCD eRPP`mmn:AD(**0`ۙAx [ܹK,9<ӱ 0qˠ jH-h9'55uֹ%%%Lǂ 35mڴ_~H9h~%?|ѯ_f:A$ySe._t,R5hErڵ3f̀4N r4yhfb:hłl޼y3g,//g:AD,O^XXt8R Ж!ȗ/_̙sΝRh7 yX˗mll Q#2ĝ;w ҘAo1 eR߇ĬYD.Hʀ۷S%"נ-Caٴi}A$Fzz#%"-Cj@F9CqkGGʜcAI A ӧܹ~ <_immj*cAɁ AjHAA|ج[XD[r%:[t,"QЖ!Hxq ]RRt8"۔{M6we:ae"n߾mhhH& @TTTYѣG>}g-mݻwC"--pD_ʘAm[XX2H;`(֫Am'Nx"11XD!g7n~cAimA"999%%?f:"Ж!x)//'SjnݺƍL ̓вe˷o2HhDB$''7iŋ4O={@ŋEEEL 20|O ȑ#]\\Ae˗/ gcA@bcc!qYcAim0* D^y⅞A*A[ Lӧ'''Sߍ׮]Ade<_~O##}1 M6-R]Ж! @"++ g=Gd 6oAj2:bcc =zt R DNAde"dffCLǂ UpcAmH5cƌ0`Q _'DF޾}w!HA[ N\\|TA b:Ж!lmbbt ӧW"#"BЖ!P^^~-H,Zg=Gٳg7o^aa! Ad&MI^x !''[nL r 2I]~ǏL9yyyt,"Ϡ-CbK,OO?nee A 2y->nnnt8;0a>k m >}>}zvvv> Ad?3((@D@[ r5a:D&(..f:Q,Ж!? psDx={ֻwo38802gvihht C^2yd3Lǂ 2s233ݻWQQq!cACO!-CEՕ(颸Ç]ty)ӱ  A ujg=GJJJΝ{ΝB| H hDw hV^^t m("0?b)\ śċ/ANЖ!BgϞ={B@+cFFFǏg:Ax AÇ0"{iHX 2AQZZ|}As&gYXX|@e9۷ҥK-_~ĝ;w~ Ж!INN'$?~I3onԨ|\kkkJ8$Aj2A~zz:g9-[\n]۶m ]\teDLL &M6m>:3 SZZڧO///Hϟ]x!h˗9ׯ_oڴiAAAXXz%)Ftaa̙3!qׯ_3 5m ’YTTD_#4hPpp0YaÆm2u:O+~ ܺu=h_|^f9} ,ѣ6cS7n9Ж!Rm:u#ĉÇgЉpc\~ 2AMppAM4I)?n߾}PP&ݻwK2*AD2A&M\~ڢݻ/\PQ=SN^U\\|m۶455% "m cɒ%χ暙_^R)^^^})--Xgh֩S '!"-Cz 4hʔ)~~~tǏ˼zEaaaL)gY]]Օ#Sf!"-CzTTT Ae+WDFFO:uРA***!(o""`FD-C[ `FD-C[ `FDȱ-) m "7 b,7,>EiZlr\˗ SG5kp32AD6oA?[VQq!:zK{gJҖg~=/~ߏM$// _Le8`FDp۲9&&<aBBZ5ٔX7ÇW'NuwYۖݺun֬7o1c±LM srRRYXkiA<ko4i]϶m[cYΟޫWfMs$>{5! ;/_l3m(ؼ#͛7;ALn[\ i_CXڽ{ћA;w.Yۖ[ΊS^>>źW {wFCC5,ֺ;wܭ\'ׁaRUU?Ν5҂>|`˽C"?Fׇ?l( m(ؼ#?p67-/m eeCN^^"#ZPTTc"#}g-C7 b"lݺٖ- SdrزL//7SSæMu01R {>ǎ6/~ŸmնmKv[ldp]Z^ŀ-#m`?(B>|Ya[#<3і!A1`;ied䙹c ^=岲/ss۷Rڵ3"[';vCX7,mhmbbq3;$/e{#n߻)ʼn(;pa|Yʩ*hDq CÝ fk/_w^bbֆ GK·98' (Ӣ~+ƖTT**JTv-r¼;vl-y;w"6T{73g;ׄ/Le8`FDe?s9ZXz7/w:98: ińe=S ߺu>/SSCKKcrJ-w9PvC<9Ʊ m1ؼ#yO o#^*S_$DyyqT5;\YYz^^"{;D[ 6oAĈOĔЖ!A1 m ƒA1 m ƒA1 m ƒA1 m ƒA1"B[v«溞9)ҐøIB[  - nϸDg/VZ+*.bYُHCNee& m `FDĖrsxÊw\:Eiȁ|vg֡pĴg.rp**~=O\j:J"y2AD6oAHm٣{&G,I>|9y%Z(C OG A^ߪ")i+ܼieKhD -UA{7]&H|Fr@>sw^$} ik\ۮ/4X7H{wf::&&~~˚W894ikh),,Lر͔)#uf Fں~:n mZ^POOs%%ih6oAHmټ';:{bm|8cQ!_#6nio!Az9..vsgSHwf޺u3HzP[͍TT;:G= sPUVۣG:uۿߛ<,֯lf )_b]3%[5j;TWo{.E[ ?y#"FjoFE8ۅL:n^mԁd7>.odf=|xԁ*$쓧O]ׯ0s*/)aǎŇ8(eSa1$ VVmY7H<{v"eŋ{`q?!鄶 A~`FDl}mnނ4eBem᠛6y*+0=Zb ۷ >۴iA9B{sW1*??),{!͚Af-SSk@.A~{Hgqe͢غkdmimenf[:gfuA褶ff-RZ+-eΓeBF7I,͇γw#>_nJ?//Aԯ߼_6%xQbMZvvlFFF˶o<5{RfDAiajٽҗi3Ҷ}3m*NUd`*=3""@FKwUTTU&yse>1eFMڶPWf2:FzMML98/Uѱ_O,f7=YY=eΨBK*edq^5݉)ҥLWHmmD(5򓌜>CST_huNIQ*EEM{K<'5<7ҿr%W]&9tõILu %(oYe;|;v?aDN̔&;:v2\4*WUVԥDzCLLhtt#G6IEҕ;v`˺v"߫Ň  ={:ϝܾ}[ge!hFzʿdq# #j2<5zid8e9u7Wח5ڌi1}ovvPL>gNLI 3 jG'OޡC;G^RR'x[7߉emtL^_ļ{&55EGT,Swe>xPX]}RϞ~?x a7c3eFy6bhv7"@, @#ۈeFyЈXF,`9F2bQ4"XQ+eYYkCvZbEx>X(oXVWwh4c,xqw`7 uQ4z,/7oȑ_I*:>dѢ)^'7̘1Zf<))F q?~<ٴ¾}Xvݺ21t722z۷L:r!!7t昚&Sé0XP4z,۱cEDDt._JNaÆE L;w q mXݻg).2sfi󓘦cfztKJ%+&=/9z\tTzQd2Q4z,[lFZ*fdd=T^׮K,[,*>N:.}s,{ؠb󩡡cbcrr<K̺u@X؀CB\\DzSO,75M:WYtІ#uѳg'$e bYvvydܹT:ԣt>jj$mڴX6 tbi>%LR @ P4z,5{vĉ<ʶ?yr,""@RƓeUU?m=ܯK`wXXuܤIå#*(!d//͚5^W]7 @Q4t'hhEYW><~ӧ'^;FyШ> ވe hD,# @#b (oˈe,Gy%.78Z2hD,# @#b (oˈe,GyЈKKFyȎe-`1F2bQ4"XXr7a7@@,he_=79 8IENDB`java-design-patterns-1.16.0/factory-method/pom.xml000066400000000000000000000036051312550536300220760ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 factory-method junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/factory-method/src/000077500000000000000000000000001312550536300213445ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/000077500000000000000000000000001312550536300222705ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/000077500000000000000000000000001312550536300232115ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/000077500000000000000000000000001312550536300237675ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300256175ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/000077500000000000000000000000001312550536300272665ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/000077500000000000000000000000001312550536300305465ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/App.java000066400000000000000000000062671312550536300321440ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Factory Method is a creational design pattern which uses factory methods to deal with the * problem of creating objects without specifying the exact class of object that will be created. * This is done by creating objects via calling a factory method either specified in an interface * and implemented by child classes, or implemented in a base class and optionally overridden by * derived classes—rather than by calling a constructor. *

* In this Factory Method example we have an interface ({@link Blacksmith}) with a method for * creating objects ({@link Blacksmith#manufactureWeapon}). The concrete subclasses ( * {@link OrcBlacksmith}, {@link ElfBlacksmith}) then override the method to produce objects of * their liking. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); private final Blacksmith blacksmith; /** * Creates an instance of App which will use blacksmith to manufacture * the weapons for war. * App is unaware which concrete implementation of {@link Blacksmith} it is using. * The decision of which blacksmith implementation to use may depend on configuration, or * the type of rival in war. * @param blacksmith a non-null implementation of blacksmith */ public App(Blacksmith blacksmith) { this.blacksmith = blacksmith; } /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // Lets go to war with Orc weapons App app = new App(new OrcBlacksmith()); app.manufactureWeapons(); // Lets go to war with Elf weapons app = new App(new ElfBlacksmith()); app.manufactureWeapons(); } private void manufactureWeapons() { Weapon weapon; weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); LOGGER.info(weapon.toString()); weapon = blacksmith.manufactureWeapon(WeaponType.AXE); LOGGER.info(weapon.toString()); } } java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java000066400000000000000000000024761312550536300335030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * * The interface containing method for producing objects. * */ public interface Blacksmith { Weapon manufactureWeapon(WeaponType weaponType); } ElfBlacksmith.java000066400000000000000000000025721312550536300340500ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * * Concrete subclass for creating new objects. * */ public class ElfBlacksmith implements Blacksmith { public Weapon manufactureWeapon(WeaponType weaponType) { return new ElfWeapon(weaponType); } } java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java000066400000000000000000000027651312550536300333030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * ElfWeapon. */ public class ElfWeapon implements Weapon { private WeaponType weaponType; public ElfWeapon(WeaponType weaponType) { this.weaponType = weaponType; } @Override public String toString() { return "Elven " + weaponType; } @Override public WeaponType getWeaponType() { return weaponType; } } OrcBlacksmith.java000066400000000000000000000025711312550536300340640ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * * Concrete subclass for creating new objects. * */ public class OrcBlacksmith implements Blacksmith { public Weapon manufactureWeapon(WeaponType weaponType) { return new OrcWeapon(weaponType); } } java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java000066400000000000000000000027661312550536300333210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * OrcWeapon. */ public class OrcWeapon implements Weapon { private WeaponType weaponType; public OrcWeapon(WeaponType weaponType) { this.weaponType = weaponType; } @Override public String toString() { return "Orcish " + weaponType; } @Override public WeaponType getWeaponType() { return weaponType; } } java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java000066400000000000000000000023701312550536300326440ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * Weapon interface. */ public interface Weapon { WeaponType getWeaponType(); } java-design-patterns-1.16.0/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java000066400000000000000000000027001312550536300335030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; /** * * WeaponType enumeration * */ public enum WeaponType { SHORT_SWORD("short sword"), SPEAR("spear"), AXE("axe"), UNDEFINED(""); private String title; WeaponType(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/factory-method/src/test/000077500000000000000000000000001312550536300223235ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/000077500000000000000000000000001312550536300232445ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/com/000077500000000000000000000000001312550536300240225ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300256525ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/com/iluwatar/factory/000077500000000000000000000000001312550536300273215ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/com/iluwatar/factory/method/000077500000000000000000000000001312550536300306015ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java000066400000000000000000000026211312550536300330250ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; import org.junit.Test; import java.io.IOException; /** * Tests that Factory Method example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } FactoryMethodTest.java000066400000000000000000000100251312550536300347730ustar00rootroot00000000000000java-design-patterns-1.16.0/factory-method/src/test/java/com/iluwatar/factory/method/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.factory.method; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import org.junit.Test; /** * The Factory Method is a creational design pattern which uses factory methods to deal with the * problem of creating objects without specifying the exact class of object that will be created. * This is done by creating objects via calling a factory method either specified in an interface * and implemented by child classes, or implemented in a base class and optionally overridden by * derived classes—rather than by calling a constructor. * *

Factory produces the object of its liking. * The weapon {@link Weapon} manufactured by the * blacksmith depends on the kind of factory implementation it is referring to. *

*/ public class FactoryMethodTest { /** * Testing {@link OrcBlacksmith} to produce a SPEAR asserting that the Weapon is an instance * of {@link OrcWeapon}. */ @Test public void testOrcBlacksmithWithSpear() { Blacksmith blacksmith = new OrcBlacksmith(); Weapon weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); verifyWeapon(weapon, WeaponType.SPEAR, OrcWeapon.class); } /** * Testing {@link OrcBlacksmith} to produce a AXE asserting that the Weapon is an instance * of {@link OrcWeapon}. */ @Test public void testOrcBlacksmithWithAxe() { Blacksmith blacksmith = new OrcBlacksmith(); Weapon weapon = blacksmith.manufactureWeapon(WeaponType.AXE); verifyWeapon(weapon, WeaponType.AXE, OrcWeapon.class); } /** * Testing {@link ElfBlacksmith} to produce a SHORT_SWORD asserting that the Weapon is an * instance of {@link ElfWeapon}. */ @Test public void testElfBlacksmithWithShortSword() { Blacksmith blacksmith = new ElfBlacksmith(); Weapon weapon = blacksmith.manufactureWeapon(WeaponType.SHORT_SWORD); verifyWeapon(weapon, WeaponType.SHORT_SWORD, ElfWeapon.class); } /** * Testing {@link ElfBlacksmith} to produce a SPEAR asserting that the Weapon is an instance * of {@link ElfWeapon}. */ @Test public void testElfBlacksmithWithSpear() { Blacksmith blacksmith = new ElfBlacksmith(); Weapon weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); verifyWeapon(weapon, WeaponType.SPEAR, ElfWeapon.class); } /** * This method asserts that the weapon object that is passed is an instance of the clazz and the * weapon is of type expectedWeaponType. * * @param weapon weapon object which is to be verified * @param expectedWeaponType expected WeaponType of the weapon * @param clazz expected class of the weapon */ private void verifyWeapon(Weapon weapon, WeaponType expectedWeaponType, Class clazz) { assertTrue("Weapon must be an object of: " + clazz.getName(), clazz.isInstance(weapon)); assertEquals("Weapon must be of weaponType: " + clazz.getName(), expectedWeaponType, weapon.getWeaponType()); } } java-design-patterns-1.16.0/faq.md000066400000000000000000000075131312550536300167270ustar00rootroot00000000000000--- layout: page title: FAQ permalink: /faq/ icon: fa-question page-index: 5 --- ### Q1: What is the difference between State and Strategy patterns? {#Q1} While the implementation is similar they solve different problems. The State pattern deals with what state an object is in - it encapsulates state-dependent behavior. The Strategy pattern deals with how an object performs a certain task - it encapsulates an algorithm. ### Q2: What is the difference between Strategy and Template Method patterns? {#Q2} In Template Method the algorithm is chosen at compile time via inheritance. With Strategy pattern the algorithm is chosen at runtime via composition. ### Q3: What is the difference between Proxy and Decorator patterns? {#Q3} The difference is the intent of the patterns. While Proxy controls access to the object Decorator is used to add responsibilities to the object. ### Q4: What is the difference between Chain of Responsibility and Intercepting Filter patterns? {#Q4} While the implementations look similar there are differences. The Chain of Responsibility forms a chain of request processors and the processors are then executed one by one until the correct processor is found. In Intercepting Filter the chain is constructed from filters and the whole chain is always executed. ### Q5: What is the difference between Visitor and Double Dispatch patterns? {#Q5} The Visitor pattern is a means of adding a new operation to existing classes. Double dispatch is a means of dispatching function calls with respect to two polymorphic types, rather than a single polymorphic type, which is what languages like C++ and Java _do not_ support directly. ### Q6: What are the differences between Flyweight and Object Pool patterns? {#Q6} They differ in the way they are used. Pooled objects can simultaneously be used by a single "client" only. For that, a pooled object must be checked out from the pool, then it can be used by a client, and then the client must return the object back to the pool. Multiple instances of identical objects may exist, up to the maximal capacity of the pool. In contrast, a Flyweight object is singleton, and it can be used simultaneously by multiple clients. As for concurrent access, pooled objects can be mutable and they usually don't need to be thread safe, as typically, only one thread is going to use a specific instance at the same time. Flyweight must either be immutable (the best option), or implement thread safety. As for performance and scalability, pools can become bottlenecks, if all the pooled objects are in use and more clients need them, threads will become blocked waiting for available object from the pool. This is not the case with Flyweight. ### Q7: What are the differences between FluentInterface and Builder patterns? {#Q7} Fluent interfaces are sometimes confused with the Builder pattern, because they share method chaining and a fluent usage. However, fluent interfaces are not primarily used to create shared (mutable) objects, but to configure complex objects without having to respecify the target object on every property change. ### Q8: What is the difference between java.io.Serialization and Memento pattern? {#Q8} Memento is typically used to implement rollback/save-point support. Example we might want to mark the state of an object at a point in time, do some work and then decide to rollback to the previous state. On the other hand serialization may be used as a tool to save the state of an object into byte[] and preserving the contents in memory or disk. When someone invokes the memento to revert object's previous state then we can deserialize the information stored and recreate previous state. So Memento is a pattern and serialization is a tool that can be used to implement this pattern. Other ways to implement the pattern can be to clone the contents of the object and keep track of those clones. java-design-patterns-1.16.0/feature-toggle/000077500000000000000000000000001312550536300205425ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/README.md000066400000000000000000000022161312550536300220220ustar00rootroot00000000000000--- layout: pattern title: Feature Toggle folder: feature-toggle permalink: /patterns/feature-toggle/ pumlid: NSZ14G8X30NGLhG0oDrk8XjPd12OvCTjNy_UthpxiAPvIBhUJc37WyZvgdtWp6U6U5i6CTIs9WtDYy5ER_vmEIH6jx8P4BUWoV43lOIHBWMhTnKIjB-gwRFkdFe5 categories: Behavioral tags: - Java - Difficulty-Beginner --- ## Also known as Feature Flag ## Intent Used to switch code execution paths based on properties or groupings. Allowing new features to be released, tested and rolled out. Allowing switching back to the older feature quickly if needed. It should be noted that this pattern, can easily introduce code complexity. There is also cause for concern that the old feature that the toggle is eventually going to phase out is never removed, causing redundant code smells and increased maintainability. ![alt text](./etc/feature-toggle.png "Feature Toggle") ## Applicability Use the Feature Toogle pattern when * Giving different features to different users. * Rolling out a new feature incrementally. * Switching between development and production environments. ## Credits * [Martin Fowler 29 October 2010 (2010-10-29).](http://martinfowler.com/bliki/FeatureToggle.html)java-design-patterns-1.16.0/feature-toggle/etc/000077500000000000000000000000001312550536300213155ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/etc/feature-toggle.png000066400000000000000000001542011312550536300247400ustar00rootroot00000000000000PNG  IHDRV躊HIDATx] x F!Nh$jIѐbW&־b5V4QUkUk}ޙ;Y;{s̙39sg2w&@ @ @&k@ @ h$ @ @ҙ@ h3g" WkϘ*@z{KjB΁&-3@߼I޴i.UڭOFwlC:v2"< ƣ )f$ՄvM| 3@A|HȠ2eny|B>|9sf䓲,&|eOmg֭<ڵظTZëWI=z4ϓ'glR XU$Ig5E@_s$L 4-FGe"\ ">#(v!>iDFܱw1͛Jk`ѢQ8wٹm<ְvĺunv3gIsX=8Z9h3tVr45:I:A[[7.ܹC^ާ#'N Ģݽ{;r0G\wl-Ɖ"k5l07&f牠l'Q3DjB[΁&F'>Ig1h+:YnJ7o' <}؞e/T( WTfM♏Oc b>s 5yBg@tcŊ(vhŊ@l1Ɨ/rȖs"#')RAek@;w @g¡#9ɋa< _6S$&4hk$ Ơh>Y4q˫ǻF)Sglٲ`9Ժ'QhQ'Dqð% =![%/V|a1 xz27Rad3uIjB΁&VHҙ@ h ;ۚ6#Gab۷Ts7ggJޒзso#$L 4}GGHYMs @AcHI: rDHҙ@ h "Ig5A΁-.3gD X{#EGv @T,-iEXzyHHMs @Dݒ"^A^!#R*3QWUv=ϜH#ÒЮ !tۡ sJ湈@}V5A-/./|]b ղUƟ4 T g-{vUdk-#Rf+فjM3_d:I:wnG7*,Q]?;n\/SOޭ ?bDw"^WA6c7]xvw]FG-$dP2[<>J!Stj|9sf䓲L^ޜ+[LL&ڵrXvm[*[[[~tuuɓ''&=ѭOӦ˕+R UɞnϞuT)\8߾~LK+D3F%h8l&HKP*ղX}k㛐ޅ['co#jnsݾ{k/R%β\2h͛qVzC;eZjDm]4YvbJ`-jNԄ&$Gzt65͜Сp~:I~-oj(8'O4  ]6sf_}P}HLN. Hc$!`/$+ٮ]EFIgh,Y2(6kVG0T `;8cEݻ72fg%0B.f˩SFz:P@v6#U+42m e(ߏ]&/Gɳ7u_ڛA_vZeS\!`!5kV(U0'A>&9rdޱcl1E.9.Ȧ"V-[V??/!7iR98lb-i+;˪U*:g̘̚ u$hBVJ)V * Sܕbo^^հG+3/Pt\r `k8M269N L@#ظHRΐٱ~lB2ըΝLi&kΊV.׭7wS\:c89E  b7wn1tsݹM\:F9E:y@^Sf#^H,EΝaCϕw ]}AH f^k=ѶmIBDD ȍ]iL:, =xpGrDW Evx9;FOO5'4*S3%E l2K0OjYBtf g޼m \:c%7vlϲe#\0o5k6lΧ*ɥ3ʰrJ"w=Q1ά#β ٳ h8E'²OXzWi#{W<՛ \q jݑ7ڻ)[!C:bLKʛ*" +SZMFS K GfѢN*rx#霢 (DHavM]`7-[V8E>1*'L$gWhS*-l_r_e,npWax9;NĦsa+ä3&{ uboj$ǽ{C6ؾ}d3/10L_JjB_%kXљWa'\KsL xfNHgqmL:˞na>`x^#^h,nz1fj ekz{! +5gǿsك/ƿSL5gϮg5UYڵ)wR,}Tm7nE4n)6!J*)v-]:H:hB];9]4a~\ mg>VeNob~~^;zt7hh{vk >=;^ кƤ#۵itζH4+(WΝmlAax9;P9 7*W(μLQp>\:s70<#+f"yyU{xwXh A- 2A)Z -LT 1&f`USYt&Gl'OAvd+D3X#d35AXzW9ptˈzm6jQW\s^Dž+րtfO\pI !b bXv"?էOks-zwzD݁?sQa h2)9mdx=G4qժeI7삓o>VeNoMv.vF̼@OGb}P McXm$mڒB{E#i[2%`jx9; ^$μL1|ɋ㩙 ?ϰHI:K8MkCbYjaWMH?~|e˖u,|b{EKԜΣ83$qi ?]U~泓#R6+9HIY{8C 8y7q~5y , -,+Ѯ̙}s׮XNlu린ܸs6u(S)}XQ urr]26YVҥcvuu[׍cCsRIsS Wyz_>6~oSm ?@ĽΝaoʥ,]nl~~Z iO$0O}.]YCf5nipp?kbvmڼg_|ť !](o,i3܄WYjYZ?J!zؼy`m1s&v.i U KWZyBZ!oLHtVD ͏ f ^Jrү^%)vζ>}Z-["]aI-'G>,$9XH1 ע$.w͖wn dMZui&:3"̟?۝b/ $00bŜbL:ɓႜƏG",l4m7:SX-GXzثŅ  6xhW޼Fi,!RiM_FCS HP^UHZ*Xb}`JzNX8t\9W<0`XyP6^~C֬ BG {?jyЫ`H7>(/TM@K}| ܑpސV˛6'eᔔ- i ҙήB%]hZfu@*U>fYj;u*˫ZC;ή0H:,$9XH1 W5uA9ռx~v2j#gphoJ `r:uFJ|<~bҹl(NN};z|.[]|6]+M}h9R+^Lϯ`14E̝rػե# 5+&%C± }A(TȄ?' Sm+T"ݕ1jT 0rDj¢l=31IKI'I:g[Ko[$Wժe!9sf YUϗ/wlY0E~&&8hPG\\UU1B1WT NcR+tU,;w5hP.O+&"i vArDj0C͒skcGu3s6+A-S8Q݁K?ʕ͂ …߰%{EQURBSXү$bHHMs)ϐt|bCw:}?rL~lٳ<"rF {v'-t 'E,=*D} @T$%E, QC$G&9U IgnIK B rDHҙ[R+27[g{r $b&:yHHMs LtיWR+ȫ5DrDjQt& *D  @T$۷_Mgi E, QC$G&9U{'ߑOs%;w_J\9oSNU<3adC:@R+@ ~&&9T{3/>}Nxʖ-Yhw9Gqft6Ә d&:y"Q9 ̤ί_ӧuÆ5 ^yb||m[?!Gѹs#\#mP^3'M N`'Hx{߽g)WĉӨ7l£j2X1ݻhצMaLٲwحOpҷoա- 3U6^Ïv :y7iRkذ^^dsXoHDiSk֭;KrVțХK-_d 'Pt$j9 Ԙt^tLϞ͑8u*24t̙ 6oތVkNFb͚ؽ=l𻭐˗Dbn8011,[{[uS*XZ:SlQWcw2 5Km5KGI;d֬#FtaG-$%^Rˀ7o, i wfv7AOH rD1ltteyBZ J/^DEEi&{K Qt/`̙s˖-!SD00vʕdϒqzbf f޼%%-RcS{=7ʁ4ݥL n ]mÏw/!kސQ)]T 5`fpcd+T ۷{ ț7o(i鉎Ŋ9 ^%CFtMiN{L'5kVj9 'J8qb5Y 2(CZ~o t5|΁8O.lf#_Ԥt&;w5hPUz~Zi0ٜOBe#>jԨŋN>ˢJ2bM×tuuAkړѣG#uiڴvr%?--n0r%K_ܰرVǧN\\KE0綈!x:=AA:zd4Jؘgάt晗.H ?t(\:1;vƁNN{6>uL_c1,Zxp_t Bryȑr ({qsNhCw$ӿkJ͛qWn޽1+VvvY{!8wnC7n؆P*S]h#OGB4>!{vpѽ{C`ML Z9&6ܹ-1 䉊 >yrMT\::#0!ǎ퉶ӥkN[m8JBj!k0Yd?ӺY:8V|~j.{!%qtzt#+ee*0oĈ.wlݻ6;uLDcaaaϗ/_@@={޾}kz"bha[/ M6Et YV%DPёBqҖ-z!!۝Qp[䡭q8 I͜={`:UX%Q?ϛ7\d SɲSg ,]{{]aT3DP|9d pt2ѴJJ \b"nx.M/^H lytzt6 cǻW/_Z9iq1AnJ:{N%!a-|3Q˞={%-ZٳO?ԢEUVa3&&G7nDzǎÆ ۶m NJJBСC/>|0' :u '11ŋH߼yɓw a&צD|8 HGFFi^|y VX… ?8s̙y`#`9P͂!!,!8!@A/d='`uewn>+Vd:G};`y_ 2ٝqa!/da6 VK Γ'Ae_OhҤر7O!dBFuJgS&I N}?B,@(A)'7X+wWIX9s5mZxlJ:{z~[:sȏɷX b̐NAш5]R1MRs|`x?{?˂ ,!9-;+#`|%fGIҙ[*D,^g|yyy{0 ⃃bfFTR[$3_.{8ro@!ʟGIfNWqvæ2|Fs ?{32WK oi|%:0\e$f,_';ȍf=_4޹6;uLDҜŋ7i&[lK@٫ ?5K2ԋs?ڴK*yLS6ηo׫W݊pt)Ƣ3$Մ-:&IgnIK v-vq eSȴq;֭OXԄS44uLKg ZL'dot$ꏙH:rD:JXzyHHMs @Dݒ"^A^!#R*3QWW!j9 $L-)bU"9"5 l_* ?Z Ig/ϟ'޽]:iEK bԫWITIgfvԿ ǻٷ,D]DR?yܸ/^v9wn>fLwy6;,*Jxr pgD?E8dHC<1nms j#mu>{y^J2߹sK…ϟzGF/bi#E, #yF5JHHMM:IL e `fΜ>K~}4W h9ra+Tp.]HʥoBMaet#AMҷS'o`֭=IMyڈ,Y2-tZ,-_Ճ̯^0|($d8a,o^HyK*,|F^ݒQ+ȫ0WT*i 9"5a6ԔΜŊ9l˒ ٔ!50W5>Mɓ…;)tfR9hU:o0aڴB 1x۶q"BJ,Ċa/]HE2g4UA)`Jk;z4[7Mk+WO&Gѥlٲj@;w_~v׀oyoF;FS'W!b-#R S#rpwBJᣝ3R!+!GlgάWyKbqPx˖u!.kժh;z@''GKz5]޽ِ!yro\9\ٌNG2S'+Qݽ"<ȡq1ook3]Οʝ~ٲ0t05r ̜9|+bU>rd牲`ApwܫW dYvbݺn^fiӑ/{w;3~bWFYg{ׯĬY`';B_>,py ',Y2sa4kVT)b' B^Z^% $G&RuXϟ{iPmLHfZb βIS.Z4_d3pJeN\pbl#ܹwV\["{xٮvdA*Ljs"m9$4y4*0oPoow^d sd#kժѕX Mٷo&kצX`J0={ .,YLh2~.S e\3bK1DDV!X113P Ay\Ld jCTֆN_.],^e=p`ɀQ!B/qst2A*U*eW!b-#R;:+=6eG>ezUY dBJ6]tulCeb2ψ=l&,,]; zժʚaJ:cYa<+ "P O&`CϝUԪJ?jfк# e(62;%KC3Gw=M Dӿ<6X9>~'<((gboވ| Q,g؞Ç`Ae1֭suyv?fy>se.^Ơ8w&Xի[0)9S Uޭ '{VHXaB۱愇PW xSoX;SL]~-:$畭 mgpvp(רQ^\Jx {96* n@^JHHM9ȎsQj&d3-1څJgYaJ:d%D0UՕIg^(O9wn{X4,BW"n߾a΍؃vs`⚚ԪJ348zA磣1GD˙wCpbW%[ׯyD5,G J)Zi߾EA?ȑ5Hc 'Vc4aBǫr=rO$`΃!Kiذ( q#͙={ {x9[{[޼}7kWQXtba{`Hz^ڤ#1_I L[bt( 6ۡ!rq6~rmT= yky4HsǎE@:[ )LKvYu(eejBbA2>xV[7|mWqf;N ml׮̞uF&J!t"E GGd55UQ=Cou´\Fw%K•  ĵa ؃Jִ͛im^ɒ%cy̓.GCH uq) 6k{lŋeLW36= yky4Hs051h4BJ63cG β#Eljf gW̞CbқR3=Qr\`>xB%/^;vR_^gًkjR3a,X6 ?s<~-c+,_"ew={8G|Na!X`񧜃xJ[!ed߻.=rW2SE^>6rR+ȫ*4ǫDzg|2I33pb\s)e2 "_޹c}n4uqrٛbrXm"׵~j^|-pt)ƊmWWQULrDj"=΁{GLN[$ʵk˗7o()vXDRŒ5֭(W *V!yHs) ¤EL$(bU"9"5A΁I:uKXzyHHMs @Dݒ"^A^!#R*3QWW!j9 $L-)bU"9"5 ^* ?Z Ig5yݻ_"^A^E #R-Ǐw/X]C⏻ѣ]9WNE6fA111T!C::ٞ?cFM ȳtмgX Œ@C|2;!7NXݍ,.2֯_ Y=A ʕ͈=M®r_;W ;fl&r&F]"^A^HHM9?,;el zɵ]^KgGȾYPlsm‘#+JeNl 7kV-#'G#{nŵ5`4#7 vk`ѢQ+¤V[:-rؖKB M% ΅cbf< BHoڲ蘋VR)+WkXL >.XC@t4VhZ*:BfzUY1TȺ @ܨ.],^-D(Gs@={ VKG&j|ʚd~uIXzy*"9"5as@᫳H`SvlAL(6 *bltL:C Bb'65Um,,]|xwU+NWl+?xV{0Kt?wo:6`]7_g&yϳگMdyw/ y@rbLrbM96QSv`)F 2DVL>XeM2$E, y Hs۲sP6}mN2N6 *P:wYv2i{Xӑ/^UhwMM3gbWA??~ڈmSi4.\xIkDC׷5A>>uLٯ3 ZUl7IP|Ф]ݓLq08p!ccga5B(r<*8*KŊΦ?g̋1 v' ct!AU&t):y/\8o"}Q^(4 ),XW`(c(IQWW!!#Rqc[vfeߵ^KWAN.@vR1YvJuVhwP`@q=Fueҙ&k StΝX0r;, #fAvhŊ@S3&ҹ=# ap&2exK.Ӱa > MA,'[ٳnPg֞xkrv +рA0۰hIϞww޼`\F_~  uk+{* fKCfV'Nƪk„]LdM2$E, y Hs۲sݻUڕ! L0OCRo#;Rβ֔tmw+WHFъuo*M֌s6Lk׀lf:CI#%bf'E:)R=:"k=cjR*&{v 6!xi[' Ṡ;2exK(Y.aӦx䌰rxժsuul>+O$ !!8+۷ Fȁy-b?n\> hc.Y''Ǹ9\Z**U#=N}?E?wfE"5)Um)bUȫhDz65e3U0efC>IJQ:NXSY96A0ݽbeA+,!+LzhFuҹ`|'hJ^-H"^A^E #RqK"00&5Ig"NA^!#R*3QWW!j9 $L-)bU"9"5A΁I:uKXzyHHMs @Dݒ"^A^!#Rq»Oe"a8 Z\:gά `YbHL$a&*"5AhfGPoT<xvۯ(L΄s_k6mڂ mA LI:IgȾ`ɓٹM,[ObbtCt:t(xT>8gΠ-<6Ҟ=Ӽg^%3XR ͧۢDN6%J௵ `ܾ}zׯ_ꕵm!h$"Ig5*lƋ{^"[cקNEu²{hDJg-AΖ IgFիgmC2w=x͛m Ac LI:TIgvqO'!mYD~D:,DxK̙_ e7lZr% ܑKg:qq!t&$֭=QGFtӴirJ<~ӄ"E 0;ԩEwok^ëB%Xֽv-TX:K.Wvtvss9v,sТmy}^tX>tvvNLL!-3QC$&9CHgkN[m'Oqp?sfX:CBgjwfӑP/{w{@oF聍s6ϟ{iP\:gYjNDDDի[ be yLVCՠ5kٳ!qC;_IZu|T˖}wRLǎlL.e.|,Y2}n֬E'5MoݻiӬmk.$>lm[IgHYM(8CEr|Ih$PpH:C;;y"({2Oĉ=qb5P!!W*;;2 =2VV%BI/_R0HgWq3tix|>z T8Nԩ *d޸l&βgm>c.VOB*褦m[puuݳ S!!!ikcq8;;[V4D 0MV~*)6vsБgV𢡄^sWK1Pü2eo 1*kCL oow^ʕP줜:y/\8oB:Q^({'7Wdi\:˞]\.t&#G5o"+ڣ&wrJk[A]t&j$Մ)P|fG0p8b2\.]:a_:Uγglٲ`ܺ'tc"O|lo]s޼7oƱtޭj׮ =Ѯ+=,b:wnÇcoDD -Js% ([gQϸq==<͙3߼I0!rҦ2t=lI:m'N+V݄=.^X־ϭm Aҙ!tVdn&o0m$<tG ^%A,YX1Mk?|oJ:_[Z9WW 'O+W'Ou7ohus.==?IH!Iq.h֬YJ*,_j2e߾EYgtQ?ލc\\3 ԪU CڲGiӾVGgά3)~Æ'L#}?>˗bŊ۷[́3QC$&Cðo|, Dٳ=ěsoM/_&1˹j@3}heP3uիj-J6S%I:"On_ʕ+Ŋߓ3Aҙ!tVa`tr:$8$޾_^Ջ3fKb>uO6/^˗O"gg쵊U½{N>}cǎY3QC$&ƏDбV4mQQQח݅|U[GϟlmC6L$a&*Qt9i&,,LvWe{l.\Xl`xm!X"Ig5A΁I:gϮ쵶VF͚5wim+EGHYMs @ζYf=|VΝ;#3kB(:5DjQt&h췒~>"Ig5A΁I::̙s}k[a? .KzuD Ȝ9_A Ì9޶gg[ ŭ[^xmm[!Igv3AuyfҤI0a 4ms̹{i?w !D 3A}9rRJ){~=:MoVq={<{իֶ`qt&j$ cɒ%_~eŞ>}JJ'hz"͛wk[ |`G!˂3QC$LP_uHHH=z3gN1hz"ʕ+Z _~  ikBH:5DQvms@1hz"ϟMk[%W׵mۖn?$"Igx捽9_{ &4 Abb"݂XB3QC$LP'Otqq1۷gi{ ޶ ܸqVhnE9sڶ2$"IgXre) udi{ ޶WWWz =_ $"Ig2dHpp9%]V`AKۣoEbp[ m?rɓ'q}3QC$LP^^^۷o7˗)bi{ =… x !$"Igxm&Ǝ;:t֭ϟ[ 1nܸZy@b zjxk*WL$мy(n8~#9` #ݽX3(ZZZO>Z.]0a?P: #ϟOKK; F; AD󧬬lyyymWpႹ9?BP: #3f8}4Q S AuFQ$.._~uX1$$dҤI|HwHϋ/VVV ">8pn9rښH(E>|(}:w6pAD]yuooe˖0 0rK@4AW\\Lw, 7k֬:x$ˆ=3߼yjժ cAQg--[Y=<<P0rڵD@'=z@_p3111u^}׮]NNN|~$ݻW\Iw0RYY :111 XqGD$?~ TOP: # ׮]; Dx)**Ӌ;D"?3|__dD޽{ "3?_~mѢO\YYYĕĂYIt900(A~q#Fٳq_=A,x{{/[( 77<ݻwtǂ8 WZW3g}3gxJbFAĄ_=tǂ 8 Zzz:O\M:5(('$Ç/_LwQYY Ν;A˓L4)$$'$ȑ#GU555߾}[QQAw,"DGG;o޼QSS+XANXYY=zHPPԩS[~ ʕ+ߧ;fpA}}ܹCJga$---88(1'33SII)##@:"HKKЧa||<J h"䒕uׯ_ B8 BKRRR=x )itF^xAŋ UVt g߾}q^=A,\x̌( ٳgvD^^ݱ GDh9po})itF^|y@$ SSS'Q\gZ=zx1o}Jh"?I>|8$x*DQgN)**[}}4P: #8ϟ? G&An׮]yVWWӧAD TTTUSSázY622; u]tIrb:# hocǎ? RwpAEEo߾óׯ_Yr@,|ח($%%ACKw H"lyFUUO[lw>9D^zNKKW"8 FHH7oǏ|r.!tF>}t1@n} RO֭[e>9o֬Y~~>K(Ջ(v{{{3hD$Qg6LLL"""\NN<( 3(,@ZSTTcǎ#ݱ \sDPRR|r.!`  D=3?~l۶-7iҤ%ׯ_>LwRw۪ۇOABឰ0SSSoԨtF>}KwR_BCC۵kWYYIw H3...ׯ TTTϿ$Y>x Q +++{8A &??;ˣ;:8 BE߾}' 6s07o ] –͛iiK( uuu@SRRRPP0pcA:#pڵÇ_6m?JgaǏ;  | 8A777'''/,, MAϟs͚58vpAɓ'9s _B@,ػw/Q 222; Aas/_\EEEP: #߿WUU; ;݃˗/ۭGDH]+//hт%H~~Q 8sL׮]WsDHu֠AZEvvv֭Z$& > :#g{{{V˗6m I0OuF$Ǐ6 ; bii*>}*$ ͍7#Qg~*$HQQѮ]A聼0ʪX y2ox]Z$& ˆ]tG!3۷:uw-bJgaׯ_;w; LJo ܂z:),,F ooo[[[~ի.]0-G-[S:#ի:::;wӻq++Gt ~"tFJJJA@LMM;1:#NAyuaÆeee ޽Qtҽ{ϟkkkMAD [piڠAuuGΝ;TKK0&&F__DoHaLhOddd^z3""Ǐ)))Z-Z0333{ф *z'N'OL>VTRR_~f+JJJKKKygֵؒkW~"tFd޾};Q pQYYW? BA~~lzzz\\\FᛝݬY'OfeeYYYXQ"=䚦G&&&R߾}p ԠU7u֍ѣ$իWPښ3wΓ™T*fΠtFJw"zj;qGQGNN˗/t!Ar|||_4dΝ; {ݫ wwwf$ 8kMҹqE( ⻤䏛pȑyptHyy+Q RYY .t"\gDXpT`0Ig---R`Æ َL߿oР#, %K0;tpp ԄVZewܡ36m֬7-Z~<|:HFA$##>=<<***EQgD r3%YF l3!Ѷmۓ'O2_v-ΔCWWѣGtVV<(I2ϟ?OIgrgFyS߾}޽[Q >}"0-[ADKK˥K *A~}1Aw ,LHGFF˟>}:??ϟ!!!۷_nCPPKZZt꬧o޼̄K)S`3 J\LJ ɭy4lT~PxYSEE.tSIpuX3Q͐ e ;w@ZZQFjjjp5;wUUUL=c޼y ;vvZJ:mt9o(Ç?ƟÓ]G`  Ę B&DEȦMa/#bJyy߹$qpXVVƺ.P9dtNNq8qb̙\' L]bͪ[C!q͚5ԫ nQg!t;;;>Sn A錆ƕt–.]"=:%8sh###%ƠtFCB,"{̙ 38 4|yyyExHTTԈ#SY-/&11P:YYY?~pww'ϟBjl/^tE`]v (yc?~܀rXY@K*8ȏ?ҭ[ڷW QQQ1tPh@رc2sjr D9})SVݕ+WT#u"ҥ]II~3y.clls1c:8LcB:?xpMc&tE*++$Hc"e.xDbYr;vWP:h^^54T͇}!Fmrr={jymkk~6R2,lbU7j۷kTϑWz1tfPV?o8EEرm +h̆Y{v+1c Uw-FӲM /LҙgJJ즀Vf́b= s/^13[ s+*M̚CqX6:Y3E$Ν;|RܹsժUW̨t8m529~}}sgn|𠓏WWn _w $־KSzz::nt+c눝>'QӮ_GڵS?vΝK! ~Tιs ^_VW_B`~hZݣl3YKЊBN'оip@7O:ҘJT622Mcc},Pҙ(s۩29 xfl3cx"BE^^sڵk_QwlylmۖବIKcJJb!Q31F|újS-dHOXr:{)WU^^ô Նl{.?rd-1rKM@tjTb\ {z*.4hkR[૽T͉f[~#vҹ {rڷWdB?.>k?ρ Po׸v+0 6"9[+WtꋰEҙ\75tIKd^Zi8! 8+'i([fv.* n2ǚl=Ń 25'/"xxxR-[6nHKDݥs{l2sܛGu0 l3dY-cD:(l@I?{v$ YY! ݻbjdԋ_ \$9Q54 #@ׯ;ăH@5Ӯ]KCHOl%l<钞;Y:?"kr:(A5BsT愇f[YׯWjڽt۶-TEKKc:mH΋ه 3gBzXCm5 T6Hgu׮evtW_&G:֣#v8[ƚ#<'/"T̜9ĉTR-Uun&iN!$GL3:,#ӴY3َ ΝÌAEE9R,4t|%0*+tMjA6Wg맻b 02u833s &UadU۲ŚS!}rbP+F6>ʭHG5jԩդ39*o"9^)A qR_9,f2.MJAIоff!٭p~vF39TU1 N/R&cx"BNjj*-Uoذa֭T-N]:/\3d9K7_.= tޯپK,Y- ms:SFD5 _gMB4i\^~ΔĄE @رihe@9g,k?:u,nCɺ5uׯWtQiԨIjJJnM&31Va9iY?}ab,uv ?tȑWӯ@aӈtVRjN] 3dx"CQQLYY-;;;o۶ʼnz=aC}ɇ ݒeӏ,OبI:kj7o.6mZ?hC4a#!|9W`H'%Aq* 9#O>J HwnC բ૵rrդ395UDkڽ`{/:Ѹ>t @_vM~k4HmA,N'/"<߿ѢEtվjժ;wUP߷ >GN=>! 9t36ҹFD2:|x5'DL`3g54T@&Ma|۶ED3 /UOhU|IQpx8[WӧRH1J^Z[-*2 _;wrjb&V:״{`u~PQ/rcܹc}H :U8^F.~k4HmA,N'/"<̛7ȑ#tվbŊ={UP_̨1gɰӇﶄY4lee*&ҙ͍˻ɺH.O=C?npX÷oj >ZTS\QmwoNu/塡;f=s0֯⼈Wp 7+Qt'ÓdKK)!o'Oc#6RM=7R*-IVExB~~~rrrhhDzeƌ#--d``0mڴk9rƍ^7СCtG!tFC+QD{x?%qukneDUfaνgAׯ_/^r&MԫW-Zum„ { iaa!yP:qex(D=<|GIQ/'%H}~m;,]*Y:;kNM{^ҒIZh涘܀խ[%K&Y[))5[O-޽}ƍgΜihhܤI ccEرܹsIII߾};^`cǎȃ +ëD!Cs olٝY(p ،# UtϏQWo0m=wuaT=RgOMڷ2$oe22M6l - ZN/_9CgJLL֭ DEyD3?]'۷ةS'mϟ?geeM2ݻw=^PPPrEOOe˖;k׮ҭ[۷ԩS׬YsR4I; }ժ4sx0-/醴 . u4;7OzEY=F Q:K"! t7[ku?~bD!}L3:R _7nw.,&jXWWmk;BN~+V#p 'ҙz[mOo߾)++q޼yla $x/B|իZjɓ{ݲeKYYY==ݻ7,,ɓ'5̚5+00(**7zBt.-bɓS& a]ṞkQLP`gT`_EY p͐.U1|gyg.8d,h U.lWNu+Y3Y〩SG((mn>2wXi Q ({<΢ڞ ȆNo߾UTTd[tСλwцLEEcbbN8qFP~ￛ4i>j(wwggg3cƌӧOÇ555eٓzΝ;CƍDZ:ߵ51h hjKJb즌c8yQL!(u>|x5,4{\!"b϶mXp}Υ{?n@-ZZ0&K$C]bh^) `SnnTE.`45U`sǴm*LܼyŰiF޽ {SYc<߸j-2nƌQGwr67Xã IF#G<{dȩCjn5k4[Xւ?w*7n %?? ;A߾]?Çi9xuf^g{pִ<""HH)꫇L>!=BW3X\Z2o_C{6n;8ȇ"(:th pFlд4YpNAy3{ ij{t!JXHgjjK<==ƍ+##ӪU>}L2eՇvZzzNG+'O'OO>w\%% &@CF[[[NNqRR䤥.\ر#ÄիW#"">~MMM cbb[haffg(#'rL0Z:;9YP_.pNKNV_XY{JrrĉCUJ碢 ?~0khA LLA9sLǍ8sz{c]s3ka1 =(0Yc!!Hg84h@[(++ bɒ% Hy+VPյj*99Y:CάwpMQ>LfPUT$%1E .ϜccCżC=w/^AmĈOO`:`l箩pM2VSIab=NP:K(p˫Qs ڶmɜW`M&gɓ'+N):zhgw?άpFɹ>|x맛6vܶjPgKk(% lv򖕕݁ׯ_YfԩSۺukP3ƍxbJJ si@^rdJ1-[pHŐinnNf4Q955UQQ1==ׯ_ffft&tGALC,$$}֭cP\ZZZEET6Fi8 333)Sf 2i;qP2 D8 D>~x9s <TΝGp۷9st Z\5j/ m۶ݺuUo5ի6 VZL6Ν300nԨÇA2Kg`ΝPDyA-;v\v-%Y(и2JI7PQvرh"ccc M*++8p֬Y7n}6?\nRTTX"srr-;5M:;//CeeeZ&B hh\D]}l-,,|IXX޽{&LЭ[799-ZkҤINNNrʋ/~EwP0lذ[nq_RtFCԄ_DYQ7>yի7n9rdڵӦM300PRRڵرc-[OwP3dȐe6oa f2sto71pDh/Jg'rI^Mo\.+@޲ eqqqtG!3W&W_W=,-+.X^ɍ}f`Еe,;wښhjj6iDYYp̙6l8~[-  {.Q<(и2a"|=,/kkk>bDPM3pdC\ZZR=·Eu|K_>Ojuљ3[G|RPH,7ڼ ϬQYPk{NXKEEm-e/^v7C'oYYَ;vY\~:**ѣ֭>}z~ڴi#--3f̘Kٳ… ?l+}IJJ; 3WY`n,] Nxq'I%+V̀B"99p!*lsQQ Q̚5Dn&&vX9sLǍ8sz{Te]?JIgOb{PzO!Jqңn`ѠsdT k55eH E ԓ2nnH563j-rVQ 1f7XR NTV&@֓7//VYYܹs?~<|0$$d׮]/=zVӦM۵k7`KKFGG}##BݓBt~_SS"hLLf-䧥Az(6֧gOM?N֭ͬ Y`nA Z[YX 31闘 BmqwW̨V:z2K߯O0xS2Q5=i$@; Ma7+ [Z m.$#U#%_hPcc__gΞYc6lc~ЄP:K(ooc,05|ry„ i|"hhhít~9܌٪- :).)cwt`b˖MfT11tuH ɼu렞^gFՌ:Ӽes*`b}| @Ǔ{M sȐ80aCJϨz(l== 2~6lc~ЄP:K(ɘO^PDC7kl.))HCAҹsׯ_S qͿOҹ"yRsEE9;)k2d3snčC~v- Nlշn&_lÆyrrҰ"eNNIcsW0 kJ:LJ:BC,Qt'c{:u 40N:}(DZHg$\\s,>2ңS'e53% 3IIg::>= 鰰]lW?pi@}CXhݣFP~{u[8H6mZ?VGڐ`YY4+/&LJ:BC,Qt'ÓA߿; ֣Οw ֏ѧ.CtNOIMYiiӁ>>}߰a!}Ǔ̘1ŋ իWWX[nܹswNLLtRRTcH:u<ŋիW~Mttw GXį_><''QjbX"Ź.B@MёY@c{(NV: ;vpChժշoBA錆ƕ/HɊ HI^ 'y/QPِ iɭ msA삒NMMG@ ?x A߽{ A:߾} W\yuH_|vxx8CCC---ϟ?gς4?s ǎ)QH$ z#䍲O>˗/!aCO-wA~߿C^A/>|8Y5LDs-DBÞ 3W&B߿U# 7 2Ő B_d+ g(A>{Q5R799Q5 hɨy}H_t d7|B:888|BԩS ǏU@ g}܇ k.@/Ү=XzqD=˻YmhĨY4NpGGAA 3W&Y`U޼_]rVzNI9I7m_Z\[ ~Mȃ +C,ư*jAh,:T{.WSSfTݚ [םj. 4|JII*((lٲM6Nnzٷo 4hذa#G=zq&N8yӧϜ9sܹ ,XhҥKV\fggM6mݺm׮]އ:rN>}ܹ .EFF^v͛111AaJJJZZڋ/^z?|o߾AꃌLQQQ<(и2b y`d}'ON͙cjo?eKSS3Q[tϞII~Tŋ-I7o. ڳ}{%OOJL!}}uEE9sS PՁ8nT*.?9ee7oɓ`+45Uo>4wSZZ^Bp(ܹtĈ>w:yǵWTT\dIzz߿|7o@γgRSS=ztw޺uƍW\  >sɓ'O8qرÇ߿k۶mۼy ֮]Ӳelmm͛7{3fL2|񦦦Ç2dA^vեK;m۶UV4ҍ7 iذa&M2kO>gL4iڴi+V^o߾v.]te@rrӧOY;?~(((4mׯ_tG!tFCP:%x3ӆ l޼0+벭ر ?nX[ "ݻ=zh()5՛r$6;jf'O++V =<_>\Mƍ}dFUIȄc5tqY6Hpۺbhݩ2oO^G%%%yyyOX;III gϲvknŬ &3н{w]]]syyy@f͠ѣk`رfffA׈sN@PPY;<`deeeggA/yrJ\3k\? 孈4EZ" E׮#D4i($]QD Z++U/Eρ]ll,Nة=FxȠ Fb߸͛^!o®rrЇЙD"Ī:<سWyL"kRb*ӵgOWww詠~ի:8DүaC W_mےS*V}L>UU?=z088 YuZ]UM*6t&&*,dx/:WvvY|ZTg Y|;wr77Hղj0jT+ n4OWvZ ٗd 2Ytncvvv1bĭ[$˔\reȑ.]H$K.:\4bH&  kڵǷU.^L󏊋C|1-T?0eƣkh wW%|r7ΜIƫer凛7/dF%J.ŏ ЫWjZYΒErM/LΚ}FDtX$9gX|`eš=p`BNJ̾$sCr]:=z:qDbYYYVZM>Uj}8d=pz[B:$) =@"x)*X]Ճ((FMݽ2>kh w<'Y|LO_}¼"hiWAiu%^3oe,yZ$-t8wg;cA՞aZQ2muTk?[\$5O{u̘6-Tp%yWX1e~ vvgd";|.d*p:$фW+ܒkzB_O߿T\ үGqq8٤Dܐ\Λbeeվ}޻wei&##C H&,_?W+>%2ƅ 6պ?!8\JJK&Ϲ'y+**(:D"1dc1IIx(^]>\^7|l,h:/DRPd,kR): >]P b6_]>~gHdgǻ:9:ۼ۩S_tZ0W<8]QQFD"dYפdPE 뜜u[2B+WXIIqqݨH$3,4rÆt(Zv&&ռ ={"30З:u*1(h!uܡC23TUW͛=*bo;q_쐛Wlӧw?dQ-[xx=P;N,+k׮9Fm$IA:ɲLIIx8/s{*Qt>>7nd9lmmqk2HL r ojf8< W/Ҥٛo'.}2[$p (\ƨqF˖M!N |-/dWZ٦Š%nl%'Q%H)Bgcr}hg=E#i5)i% J{uH`SPi-蜚FNB‚} vs뤪BgKfm m3g~k׆7l+ Ίem9|imۖy8-[Q%H)=3 g\/Y2m޸efX焋Փ=C9ypdAN,TH;)5k41f_0Qɳ D @iS3 k<':z*[gp ;[[3F?h"`mۖ@qO=߻wnn!:Bt=/:zYӻq{K" SFg>įX1Yƍ}gl\j :7nܨ}{ ԥwtB!tdtפi<4[u8sLb]t8|3aaTUw߼!%#c h5!a_UU]c~pUtp6Kt؃yE!:s蜜Å茑yӦzqyI$aJ1t8p̸Nڲbx5??]VM;8Bt>rdWGG?|ʣ$/ /A-m0O\Ɂ)yYS7lde}Y\E# cGҲY/b2yyAH R/tdtפiBtV8$0%dĉd gy(˗Ȁ3f0ynU ︸Y/a&0=7_esFF/.]W.v@'ەK3!Y:KVsΝK4cu8k )Y3R$ɸLIIx89-7!(&+"PD$|7N@Z1>M80!Sow s(Noǎmf=T/,1{wM2~"s謪xH ߨH$Ô,t KɈ/9]7>iY4O:G={^z3;"X4vmWt1gXX9s0O%C0t~Df;"<[=l>{ϛ0TH $fF2.kR2:}91H`SSIvXAj%cI٭@s\#޽x1-;;1Y:))RX yI$HFHyժ騸tyrdq8{@үJM-TH $f D#i5)i.d*+:a߿oSpyNN˖MT\H$U=: 8 3H @tfɒ bM9:_?ۻ'{ 3JZZS+W4j_*,yΩ+ 7eʈ}Vqt"OQ ;d??oP!AHjAF2.kR2u%bSv%%;w.~_?~I0u^Gg9a1'/,K`m['׾O:G_~In̙dgҲˆ`v;vt<G<{{@*Hdq8gڐ}TU}ۚ7*R:I% cM4qf_3.K"T,3,F2Dz®s{ɶmK-8I 7 :abcYXwd|^Uu,yp@ϻﾡ] qq8٧Oמ=]ݝD5:oP!eAv9dtפDܐLD")(YaՆh8Qi΢=z&R_E#Aڝ7qRAHZ/LIй!:/DRPrN=,FS Ykt#T^gf_sC2u^[EqBVGgf_sC2u^t7lפ첲zyyy[߰ziA:/DRPd,kRxt餇jz5;;NJTԳg׺lA:/DRPd,kRx(|z`-#k*+ ׭⨩ _r 礉7K 04S%H ЙLe}MJuyg bm <}=ܼѣ pEEAvv\Ǟ8?.X|GG~gz._>I3l~IK_*,bf84qF˖Mrԩo_U+۴3g==zC‹aK&Y3UtC3u^b95d4;&%-9A)sޖP lw>]Ճe?/3G5(&uVKf\Xf^ކ]3x3߶m #˗3nߖ-Y 0@S%H JtJraʪٳ) {7`qww 44׌JN&2e8!hObT͛bH+XTgh gOb䊡ͭ=hAk yI$R0t\NlBg7;&%M2ȜȨQϜMd p]|__QnNM]&,M\ernDZ ?fMn:/DRPʠ3 O ;J3:K`tܹhanVxǎ07Ǹ(:|F/~6//oCϞhR`/_SK/uԩmhhck[ ޲zW~{0 L!:K6I{$44>5)eVUDZ1sWf#Gcx,ƘzEdd0մ+7ndZ,*'g=py>\1\wmE0f$IAEga1|x>>ϜI8~/C詟~:y׮e* A'Dᨨ7oĈhi =}ܱY- :ՅobgϦHIfrtlH֗i5)i.d*+zL999,[696v|'}Hc<).Nq yI$pt.+˻y3 #ccB-,Oyǎ0ww~ڍ}/ׯݓebHKIO_͟IOgЖݻ#:W[tnݺK?ixSwHIfrtlH֗i5):KJ2v\?l]T1C))7e$IAUrb8:o߾d ǏϞMRs?|xT>:]2|RJ`o.oϜIFzƌml,+UU8mäJF<8u[ulf,]:_? qd&Gg&d}f_3YH$U=: \QQdQ#CvnCg5ڵL>:_ѧOמ=]ݝZY5/-ӄqqח_~\yǎmf۴oopt[t͹o..@[~E2 H)|†I5zdf_sC2u^d ~ȝ;9ʎ}B9%Ar܏ java-design-patterns-1.16.0/feature-toggle/etc/feature-toggle.urm.puml000066400000000000000000000024421312550536300257320ustar00rootroot00000000000000@startuml package com.iluwatar.featuretoggle.pattern { interface Service { + getWelcomeMessage(User) : String {abstract} + isEnhanced() : boolean {abstract} } } package com.iluwatar.featuretoggle.user { class User { - name : String + User(name : String) + toString() : String } class UserGroup { - freeGroup : List {static} - paidGroup : List {static} + UserGroup() + addUserToFreeGroup(user : User) {static} + addUserToPaidGroup(user : User) {static} + isPaid(user : User) : boolean {static} } } package com.iluwatar.featuretoggle.pattern.tieredversion { class TieredFeatureToggleVersion { + TieredFeatureToggleVersion() + getWelcomeMessage(user : User) : String + isEnhanced() : boolean } } package com.iluwatar.featuretoggle.pattern.propertiesversion { class PropertiesFeatureToggleVersion { - isEnhanced : boolean + PropertiesFeatureToggleVersion(properties : Properties) + getWelcomeMessage(user : User) : String + isEnhanced() : boolean } } package com.iluwatar.featuretoggle { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } } UserGroup --> "-freeGroup" User PropertiesFeatureToggleVersion ..|> Service TieredFeatureToggleVersion ..|> Service @endumljava-design-patterns-1.16.0/feature-toggle/pom.xml000066400000000000000000000035141312550536300220620ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 feature-toggle junit junit test java-design-patterns-1.16.0/feature-toggle/src/000077500000000000000000000000001312550536300213315ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/000077500000000000000000000000001312550536300222555ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/000077500000000000000000000000001312550536300231765ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/000077500000000000000000000000001312550536300237545ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300256045ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/000077500000000000000000000000001312550536300304415ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java000066400000000000000000000115241312550536300320270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle; import com.iluwatar.featuretoggle.pattern.Service; import com.iluwatar.featuretoggle.pattern.propertiesversion.PropertiesFeatureToggleVersion; import com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion; import com.iluwatar.featuretoggle.user.User; import com.iluwatar.featuretoggle.user.UserGroup; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Properties; /** * The Feature Toggle pattern allows for complete code executions to be turned on or off with ease. This allows features * to be controlled by either dynamic methods just as {@link User} information or by {@link Properties}. In the App * below there are two examples. Firstly the {@link Properties} version of the feature toggle, where the enhanced * version of the welcome message which is personalised is turned either on or off at instance creation. This method * is not as dynamic as the {@link User} driven version where the feature of the personalised welcome message is * dependant on the {@link UserGroup} the {@link User} is in. So if the user is a memeber of the * {@link UserGroup#isPaid(User)} then they get an ehanced version of the welcome message. * * Note that this pattern can easily introduce code complexity, and if not kept in check can result in redundant * unmaintained code within the codebase. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Block 1 shows the {@link PropertiesFeatureToggleVersion} being run with {@link Properties} setting the feature * toggle to enabled. * * Block 2 shows the {@link PropertiesFeatureToggleVersion} being run with {@link Properties} setting the feature * toggle to disabled. Notice the difference with the printed welcome message the username is not included. * * Block 3 shows the {@link com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion} being * set up with two users on who is on the free level, while the other is on the paid level. When the * {@link Service#getWelcomeMessage(User)} is called with the paid {@link User} note that the welcome message * contains their username, while the same service call with the free tier user is more generic. No username is * printed. * * @see User * @see UserGroup * @see Service * @see PropertiesFeatureToggleVersion * @see com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion; */ public static void main(String[] args) { final Properties properties = new Properties(); properties.put("enhancedWelcome", true); Service service = new PropertiesFeatureToggleVersion(properties); final String welcomeMessage = service.getWelcomeMessage(new User("Jamie No Code")); LOGGER.info(welcomeMessage); // --------------------------------------------- final Properties turnedOff = new Properties(); turnedOff.put("enhancedWelcome", false); Service turnedOffService = new PropertiesFeatureToggleVersion(turnedOff); final String welcomeMessageturnedOff = turnedOffService.getWelcomeMessage(new User("Jamie No Code")); LOGGER.info(welcomeMessageturnedOff); // -------------------------------------------- Service service2 = new TieredFeatureToggleVersion(); final User paidUser = new User("Jamie Coder"); final User freeUser = new User("Alan Defect"); UserGroup.addUserToPaidGroup(paidUser); UserGroup.addUserToFreeGroup(freeUser); final String welcomeMessagePaidUser = service2.getWelcomeMessage(paidUser); final String welcomeMessageFreeUser = service2.getWelcomeMessage(freeUser); LOGGER.info(welcomeMessageFreeUser); LOGGER.info(welcomeMessagePaidUser); } } java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/000077500000000000000000000000001312550536300321165ustar00rootroot00000000000000Service.java000066400000000000000000000044021312550536300343020ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.pattern; import com.iluwatar.featuretoggle.user.User; /** * Simple interfaces to allow the calling of the method to generate the welcome message for a given user. While there is * a helper method to gather the the status of the feature toggle. In some cases there is no need for the * {@link Service#isEnhanced()} in {@link com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion} * where the toggle is determined by the actual {@link User}. * * @see com.iluwatar.featuretoggle.pattern.propertiesversion.PropertiesFeatureToggleVersion * @see com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion * @see User */ public interface Service { /** * Generates a welcome message for the passed user. * * @param user the {@link User} to be used if the message is to be personalised. * @return Generated {@link String} welcome message */ String getWelcomeMessage(User user); /** * Returns if the welcome message to be displayed will be the enhanced version. * * @return Boolean {@value true} if enhanced. */ boolean isEnhanced(); } propertiesversion/000077500000000000000000000000001312550536300356415ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/patternPropertiesFeatureToggleVersion.java000066400000000000000000000106461312550536300446730ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.pattern.propertiesversion; import com.iluwatar.featuretoggle.pattern.Service; import com.iluwatar.featuretoggle.user.User; import java.util.Properties; /** * This example of the Feature Toogle pattern is less dynamic version than * {@link com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion} where the feature is turned on * or off at the time of creation of the service. This example uses simple Java {@link Properties} however it could as * easily be done with an external configuration file loaded by Spring and so on. A good example of when to use this * version of the feature toggle is when new features are being developed. So you could have a configuration property * boolean named development or some sort of system environment variable. * * @see Service * @see com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion * @see User */ public class PropertiesFeatureToggleVersion implements Service { private boolean isEnhanced; /** * Creates an instance of {@link PropertiesFeatureToggleVersion} using the passed {@link Properties} to determine, * the status of the feature toggle {@link PropertiesFeatureToggleVersion#isEnhanced()}. There is also some defensive * code to ensure the {@link Properties} passed are as expected. * * @param properties {@link Properties} used to configure the service and toggle features. * @throws IllegalArgumentException when the passed {@link Properties} is not as expected * @see Properties */ public PropertiesFeatureToggleVersion(final Properties properties) { if (properties == null) { throw new IllegalArgumentException("No Properties Provided."); } else { try { isEnhanced = (boolean) properties.get("enhancedWelcome"); } catch (Exception e) { throw new IllegalArgumentException("Invalid Enhancement Settings Provided."); } } } /** * Generate a welcome message based on the user being passed and the status of the feature toggle. If the enhanced * version is enabled, then the message will be personalised with the name of the passed {@link User}. However if * disabled then a generic version fo the message is returned. * * @param user the {@link User} to be displayed in the message if the enhanced version is enabled see * {@link PropertiesFeatureToggleVersion#isEnhanced()}. If the enhanced version is enabled, then the * message will be personalised with the name of the passed {@link User}. However if disabled then a * generic version fo the message is returned. * @return Resulting welcome message. * @see User */ @Override public String getWelcomeMessage(final User user) { if (isEnhanced()) { return "Welcome " + user + ". You're using the enhanced welcome message."; } return "Welcome to the application."; } /** * Method that checks if the welcome message to be returned is the enhanced venison or not. For this service it will * see the value of the boolean that was set in the constructor * {@link PropertiesFeatureToggleVersion#PropertiesFeatureToggleVersion(Properties)} * * @return Boolean value {@value true} if enhanced. */ @Override public boolean isEnhanced() { return isEnhanced; } } tieredversion/000077500000000000000000000000001312550536300347215ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/patternTieredFeatureToggleVersion.java000066400000000000000000000064211312550536300430270ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/tieredversion/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.pattern.tieredversion; import com.iluwatar.featuretoggle.pattern.Service; import com.iluwatar.featuretoggle.user.User; import com.iluwatar.featuretoggle.user.UserGroup; /** * This example of the Feature Toogle pattern shows how it could be implemented based on a {@link User}. Therefore * showing its use within a tiered application where the paying users get access to different content or * better versions of features. So in this instance a {@link User} is passed in and if they are found to be * on the {@link UserGroup#isPaid(User)} they are welcomed with a personalised message. While the other is more * generic. However this pattern is limited to simple examples such as the one below. * * @see Service * @see User * @see com.iluwatar.featuretoggle.pattern.propertiesversion.PropertiesFeatureToggleVersion * @see UserGroup */ public class TieredFeatureToggleVersion implements Service { /** * Generates a welcome message from the passed {@link User}. The resulting message depends on the group of the * {@link User}. So if the {@link User} is in the {@link UserGroup#paidGroup} then the enhanced version of the * welcome message will be returned where the username is displayed. * * @param user the {@link User} to generate the welcome message for, different messages are displayed if the user is * in the {@link UserGroup#isPaid(User)} or {@link UserGroup#freeGroup} * @return Resulting welcome message. * @see User * @see UserGroup */ @Override public String getWelcomeMessage(User user) { if (UserGroup.isPaid(user)) { return "You're amazing " + user + ". Thanks for paying for this awesome software."; } return "I suppose you can use this software."; } /** * Method that checks if the welcome message to be returned is the enhanced version. For this instance as the logic * is driven by the user group. This method is a little redundant. However can be used to show that there is an * enhanced version available. * * @return Boolean value {@value true} if enhanced. */ @Override public boolean isEnhanced() { return true; } } java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/000077500000000000000000000000001312550536300314175ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java000066400000000000000000000033331312550536300332020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.user; /** * Used to demonstrate the purpose of the feature toggle. This class actually has nothing to do with the pattern. */ public class User { private String name; /** * Default Constructor setting the username. * * @param name {@link String} to represent the name of the user. */ public User(String name) { this.name = name; } /** * {@inheritDoc} * @return The {@link String} representation of the User, in this case just return the name of the user. */ @Override public String toString() { return name; } } UserGroup.java000066400000000000000000000060151312550536300341400ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.user; import java.util.ArrayList; import java.util.List; /** * Contains the lists of users of different groups paid and free. Used to demonstrate the tiered example of feature * toggle. Allowing certain features to be available to only certain groups of users. * * @see User */ public class UserGroup { private static List freeGroup = new ArrayList<>(); private static List paidGroup = new ArrayList<>(); /** * Add the passed {@link User} to the free user group list. * * @param user {@link User} to be added to the free group * @throws IllegalArgumentException when user is already added to the paid group * @see User */ public static void addUserToFreeGroup(final User user) throws IllegalArgumentException { if (paidGroup.contains(user)) { throw new IllegalArgumentException("User all ready member of paid group."); } else { if (!freeGroup.contains(user)) { freeGroup.add(user); } } } /** * Add the passed {@link User} to the paid user group list. * * @param user {@link User} to be added to the paid group * @throws IllegalArgumentException when the user is already added to the free group * @see User */ public static void addUserToPaidGroup(final User user) throws IllegalArgumentException { if (freeGroup.contains(user)) { throw new IllegalArgumentException("User all ready member of free group."); } else { if (!paidGroup.contains(user)) { paidGroup.add(user); } } } /** * Method to take a {@link User} to determine if the user is in the {@link UserGroup#paidGroup}. * * @param user {@link User} to check if they are in the {@link UserGroup#paidGroup} * * @return true if the {@link User} is in {@link UserGroup#paidGroup} */ public static boolean isPaid(User user) { return paidGroup.contains(user); } } java-design-patterns-1.16.0/feature-toggle/src/test/000077500000000000000000000000001312550536300223105ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/000077500000000000000000000000001312550536300232315ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/000077500000000000000000000000001312550536300240075ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300256375ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/000077500000000000000000000000001312550536300304745ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/000077500000000000000000000000001312550536300321515ustar00rootroot00000000000000propertiesversion/000077500000000000000000000000001312550536300356745ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/patternPropertiesFeatureToggleVersionTest.java000066400000000000000000000055521312550536300455660ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.pattern.propertiesversion; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import com.iluwatar.featuretoggle.pattern.Service; import com.iluwatar.featuretoggle.user.User; import java.util.Properties; import org.junit.Test; /** * Test Properties Toggle */ public class PropertiesFeatureToggleVersionTest { @Test(expected = IllegalArgumentException.class) public void testNullPropertiesPassed() throws Exception { new PropertiesFeatureToggleVersion(null); } @Test(expected = IllegalArgumentException.class) public void testNonBooleanProperty() throws Exception { final Properties properties = new Properties(); properties.setProperty("enhancedWelcome", "Something"); new PropertiesFeatureToggleVersion(properties); } @Test public void testFeatureTurnedOn() throws Exception { final Properties properties = new Properties(); properties.put("enhancedWelcome", true); Service service = new PropertiesFeatureToggleVersion(properties); assertTrue(service.isEnhanced()); final String welcomeMessage = service.getWelcomeMessage(new User("Jamie No Code")); assertEquals("Welcome Jamie No Code. You're using the enhanced welcome message.", welcomeMessage); } @Test public void testFeatureTurnedOff() throws Exception { final Properties properties = new Properties(); properties.put("enhancedWelcome", false); Service service = new PropertiesFeatureToggleVersion(properties); assertFalse(service.isEnhanced()); final String welcomeMessage = service.getWelcomeMessage(new User("Jamie No Code")); assertEquals("Welcome to the application.", welcomeMessage); } } tieredversion/000077500000000000000000000000001312550536300347545ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/patternTieredFeatureToggleVersionTest.java000066400000000000000000000050141312550536300437170ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.pattern.tieredversion; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import com.iluwatar.featuretoggle.pattern.Service; import com.iluwatar.featuretoggle.user.User; import com.iluwatar.featuretoggle.user.UserGroup; import org.junit.Before; import org.junit.Test; /** * Test Tiered Feature Toggle */ public class TieredFeatureToggleVersionTest { final User paidUser = new User("Jamie Coder"); final User freeUser = new User("Alan Defect"); final Service service = new TieredFeatureToggleVersion(); @Before public void setUp() throws Exception { UserGroup.addUserToPaidGroup(paidUser); UserGroup.addUserToFreeGroup(freeUser); } @Test public void testGetWelcomeMessageForPaidUser() throws Exception { final String welcomeMessage = service.getWelcomeMessage(paidUser); final String expected = "You're amazing Jamie Coder. Thanks for paying for this awesome software."; assertEquals(expected, welcomeMessage); } @Test public void testGetWelcomeMessageForFreeUser() throws Exception { final String welcomeMessage = service.getWelcomeMessage(freeUser); final String expected = "I suppose you can use this software."; assertEquals(expected, welcomeMessage); } @Test public void testIsEnhancedAlwaysTrueAsTiered() throws Exception { assertTrue(service.isEnhanced()); } } java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/000077500000000000000000000000001312550536300314525ustar00rootroot00000000000000UserGroupTest.java000066400000000000000000000043131312550536300350320ustar00rootroot00000000000000java-design-patterns-1.16.0/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.featuretoggle.user; import static junit.framework.TestCase.assertFalse; import static org.junit.Assert.assertTrue; import org.junit.Test; /** * Test User Group specific feature */ public class UserGroupTest { @Test public void testAddUserToFreeGroup() throws Exception { User user = new User("Free User"); UserGroup.addUserToFreeGroup(user); assertFalse(UserGroup.isPaid(user)); } @Test public void testAddUserToPaidGroup() throws Exception { User user = new User("Paid User"); UserGroup.addUserToPaidGroup(user); assertTrue(UserGroup.isPaid(user)); } @Test(expected = IllegalArgumentException.class) public void testAddUserToPaidWhenOnFree() throws Exception { User user = new User("Paid User"); UserGroup.addUserToFreeGroup(user); UserGroup.addUserToPaidGroup(user); } @Test(expected = IllegalArgumentException.class) public void testAddUserToFreeWhenOnPaid() throws Exception { User user = new User("Free User"); UserGroup.addUserToPaidGroup(user); UserGroup.addUserToFreeGroup(user); } } java-design-patterns-1.16.0/fluentinterface/000077500000000000000000000000001312550536300210065ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/README.md000066400000000000000000000033721312550536300222720ustar00rootroot00000000000000--- layout: pattern title: Fluent Interface folder: fluentinterface permalink: /patterns/fluentinterface/ pumlid: NOj93eCm302_KXv0VEzlN6F0bMCYB_3zvjpRQ3IpY97MnkNwEZD7l04SdtP8dlMfOAVBaYqRNHr4wy54Xo_Uk6uSSjWwC9FT0Zh61DYrPY_pyXs9WPF-NIllRLJN7m00 categories: Other tags: - Java - Difficulty-Intermediate - Functional --- ## Intent A fluent interface provides an easy-readable, flowing interface, that often mimics a domain specific language. Using this pattern results in code that can be read nearly as human language. ## Implementation A fluent interface can be implemented using any of * Method Chaining - calling a method returns some object on which further methods can be called. * Static Factory Methods and Imports * Named parameters - can be simulated in Java using static factory methods. ![Fluent Interface](./etc/fluentinterface.png "Fluent Interface") ## Applicability Use the Fluent Interface pattern when * you provide an API that would benefit from a DSL-like usage * you have objects that are difficult to configure or use ## Real world examples * [Java 8 Stream API](http://www.oracle.com/technetwork/articles/java/ma14-java-se-8-streams-2177646.html) * [Google Guava FluentInterable](https://github.com/google/guava/wiki/FunctionalExplained) * [JOOQ](http://www.jooq.org/doc/3.0/manual/getting-started/use-cases/jooq-as-a-standalone-sql-builder/) * [Mockito](http://mockito.org/) * [Java Hamcrest](http://code.google.com/p/hamcrest/wiki/Tutorial) ## Credits * [Fluent Interface - Martin Fowler](http://www.martinfowler.com/bliki/FluentInterface.html) * [Evolutionary architecture and emergent design: Fluent interfaces - Neal Ford](http://www.ibm.com/developerworks/library/j-eaed14/) * [Internal DSL](http://www.infoq.com/articles/internal-dsls-java) java-design-patterns-1.16.0/fluentinterface/etc/000077500000000000000000000000001312550536300215615ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/etc/fluentinterface.png000066400000000000000000002427401312550536300254560ustar00rootroot00000000000000PNG  IHDRd?(EIDATx \T+{[,.Y.ih .(K(*n"ŭ낂K i VnY22rW:ifYgNK>HUmUxFZ4Yڹs^ǎMԸkWnaBdĉ}dF< ;vԩy[$FD.]]Fݐ*q߶m~NLi޼nxx[5.d 0C? q[[ѢdI<*9y,=yY*yUb& =hgJ#R'벳S[ ս{+>0KqŊO]rАT*n\39Jf\Q/YYBBDv^WM`GR˒OΝjxȒرZnev4S4?Eh{0%Y*p&K]UVãzJ$iܾ}X%KH|?ڪKEE(ʫ Y# Pe͛Ŏu 8qbŚv!)$&7Wr򸰰;wFEPÆ/~w~3Y,9Ҵi&O4qcM̏ƌVĄ֫…#/_>`Y# PeIJDDPTTyMHHEsgիI&L])SJ}5oވ:iP%K~qcYܿu/7n؎EY2? D~aț~⤇sbIk\"aH%#"/xۻV=N|@ԩ y[}MfSS'KbýdʕիWR-*cQ,epٰ^gG%; .'K%,T}@#,T}@#,T}@#,T}@#,T}@#,T}puYz c"ң{m{F^d 0KҪG4tgRa)K޷"d 0ʒQ3Кk"ezc_zycdžKy۷Ӗ?eoSgTV3XY# ࢲt?? ^ځ72~9R3{Y+mTccY5d9YmW.]Zje^={dCo)KxcLr+W~m `GREeiqICwLWb{NHZtB5dI0׷oޜXNҥK6l3RemllU+*Y|sUJ7o^/Q^$UT6m^|Xw"mB{%K)M-\+kͰa!~,T}pQY'}pUkٵ 8F1'VH!$$@E4DAAS}EzRD/Db_gz-_,=M i4YwY.iPB}BLdI"kLPSR/>vR}Y# ࢲԷӺmW[B^E LDH._> 5h)5_o1KQӫW;K>xmN^Cj֬bC $7)S[%<9G:c&/\T= }t?d 0胋>kÃVIײyGRVԳJOe)6K,QT%K,-K:ѿ};Nqz--eDvY{&Bb,K㤼jUxիM0~|oYܻwk׮j,Kuo)]dV -VZ9iȰ'xxb!!}Ƥoj^ۭ[X =}z,T}pQYJ6R3""]֚? ƍ>W#GzxNM^ҫW-Y6,Dc}?ȗ_nRmzƍ3ỏ6[ׯ^2~}M-EX1ڵCd[,T}pQY,x7q2gMo=7FvySj-%K4o^WoTN2eJyxT߳g A5omۜL.~~Z׷vR%_y(5f\AC*>,r}WёFGmRclJD Kv!@\Z$?cC{l^+ʒ{E%; .K`Y# ,GY# ,GY# ,GY# ,GY# ,GY# Pe)3soNmSR&͞=LP,T}(dK|Y# PeI'))t4""Ug4l?5Vddmj䐐 m.lW_:dQQ!^],T}(oݻHhѨcb˖>}ZmEL֦ Ew7jT\+3f >W Kv!@,?ѿpTTHVm4HʢZ3_1d"NRŷNBvRҨQ=cbc%&BM&MnT)ն;2Yk"K'G^/ YaHЇ"+Ks6<(Mݺ5k/ĵkǗlcCL.Z4XΝ-k]׫K%; EP/0~|﯒ªU CtY# Pd/qZC|aa7QO+AC*>5Y" `GRY"`GRY"`GRǠ?mC*><'KAC*> KAC*> KAC*> KAC*>(O q@%; qD%; qD%; qD%; qD%; qD%; Ҿ}oߎhQ?Y})&kogN5p螢+L6};R\9*4c`)\~X9&KgQNL| KT}"KF0*Kϓ,ZT ;w޽Z%{,X)9 [޹%^[wo(ѴvPYۢE=CG=gl2%G7eJm8֭ZLdI%+kYHH( tWd aHЇdisCEGȢTZTZQ))4ڷoҌުUf?\okN2`Aȑa 40=}vhhkaa.KΝjr,ʒҥ}QQ!AAuWd aHЇdX\)L?&RiEM4yrq1]U99y\XXO*n&2u@,&&tѢQއ,9'ogmޜ($ĉeIJ6Wѭ˗.`GR!/Y<'cr3ZʢTQᇫ7_yQ)|6cӈ?aݟ5LRچ[ׯ{+75XyCeC-x_”퓥 zyϘ181Cj׮O{tb=aH>K=:\ :ykFE[7Uw `GRIi 1`GRY"`GRY"`GRY"`GRY"`GRY"`GRY"`GRY"`GRFY iР6gn)^X͚UX1{޳ga׮&RۧO\ժ}FwC^VtW޺u G 3neʔR'ȑdf׮Wwoߢkde-3i,T}E~e 嬷s'KdJs4mڠٳrӦqq7orF\ɥK"V^kZeKb˖>R~vK%"H͛OJpaq1Ow.^m㡑%GÐ eiy%z!AKl׮ݖ{yyll?Yܱc^N7[(K7n#PD~}9sT޵||ܷm#$wݻW.]DnΪT+WJK;SϟΝ:vlڷob_i[{YCVNMڷo, &O.MGݨL^֓{ IK7rOH"vga̜۶mð@9}%K'Obxx>H*E>g,+Zj*{gv om֬nhhk PR,uH{è̏/9>O h 'g ֭}ȭ;,թX)%6eIT!9y&7'f]@|Fjt?E/T^+7Mz͗-{_}Q_="kj~ɺci\{ժXsKM{­[ǿm9?vߴOT^bJ?|Jbƙ&߸;wnkZUĝ{vCBrTw/~t벤"V %{E9?-Z3~0uݗ9kPի_%d~>,mڔй4]<7d 0C^4!N#KdQ*-Ҕ)O*G [pķoD՘f髯o<6vlxV=po/!asكReG>;4Y|B߾̻m'&c^Rdd֭Di,RNUMٲƩSi"UVf))_=ċLzgɓ)ƕHՌ+))#KϨrkԨl"u#{/Z4|*Y9UU߸1,8T}Kŵoʴ~ρi(yԩUeLLd'K/mdܵW_ dIۃ˭,Zo<ڵC{cYf\U*}%m'|L%Y5mڠɓ#_qc͉K'VhmD36mJ0?ֻ!Zҡ"4fLy#$"$^y._>`Q$ (v4?J6hPYp( ,UwC1-eQ*-ʒ@ܺu~}[yOY50׽v_L)߽{v O-&QZşk'j?OW?ˑ+߿6mʢCٲX%iUƍR#,ꊴtOܳZܞz&M^,Iuߎ4PR!/Y< v'BRiQG:͚U8ȒbbBO܈O:pȐ|رι{!=}ܾ%R>_^4P??^ۨkL#ҍ.],0+YR"lC^X])0X{vCDڳgQh?,ۚ!t$|YDϧ%[~Ǘ"K!@<岡_/aRżZ:-3f NLԿΉ_v?;GC*>XtYR] ѲnTY# `ˤd 0Dd 0Dd 0Dd 0Dd 0Dd 0Dd 0Dd 0CeIMoߢeq|nMY}) 6l[ãرogg֬Ygʔ)%ɑ#Ɏ{d 0dIsryYo{Ӧ ={!ךݟxqq_~?T ڵktbڵCjNJpa&GY# `]FW"R0_{|w@o[gefm۶aXXxH>oRJaBdÉlӨtԼqc-[o8ڣG_}Μ(Yk=EBD$bcl(T+W8͘1X ׯ.V!)|Mfre~Kзi?w8td,T-Yp> `E:aTG˗'Y4i0~2wZ+PB_="5bPw/0T%;w޽C``Çٳbŧ9$'ۓ:n{N(;,7PDiSOoEzpΜ٤*?ģR>bҷϟA,KTjƙn:o"K*YYBBDɤLR!/Yܐuoe'%(m>+EFo:Kg&jոq-Uժ,𨞒2I}&jÛ7ުUf?\okN2`Aȑa 40=}vhhkoa_׏?zi{=c'Nзϳg;wnI'-ʒҥ}QQ!AAuw!d 0C^T,͔}S{LE4iv̹]`t>o1mڠɓ#w" rr򸰰@{*ULcԁYLLE7,^mqW}E>߾ysK͊,P u]Yp& ,UwC1-eQ*۬_?]F$r"nnO^zPIX<>puX꽼j޸qTb _Op}v/SH' Gv.S{4G7%>>.SԳgF:YUDDPTTEYJKkӦaF\(AC*>%K7_;aW|ĝRh8B*|F<5SD Z i?a W^Rpp3E'bbBE鍞ϋ`L:pȐ73&\׬Y݄!?#a3~̙ 5kh:d/Xmn"?$S沤ջP%; VrvK/ޗ0ed)Ȣcn3'&UvQv՟~sMtsa `GRÇR=umRڨug\X,T}p褴Y# ,GY# ,GY# ,GY# ,GY# ,GY# c6@! :999W@YNJJȒջ#P@'-%(dgg?RRֻ;P@@'+eEd 4e˖={䯔!%(tI[2y,@ĎL KP@;[yY':h{p4P,>+\{8A rfzY@QYHDDD^zY@QYB@ᇋ 8= K| ,.·k8= K| ,.·k8= K| ,.·k8= K| ,.·k8= K| ,.·k8= K| ,.·k8= K| ,.·k8= K| ,.·k8= K| ,מ|$K;i3 K YB\Lp>0fMZ}ꩲ#Gٸ}?UZ1 磏Hu ]%{ ǁtڡC[={Դg\\͛Ǥ1Br.?Y:u*…k%]`Y:>c޵dƍ=zlS9QR/> UVMhZVN5Cd|ϲ; ׷֭LOLi޼nxx[5.0f,}??g޺ub,$'Eq7'_?`Y 8b%\gvԈ󚐐EFIM~W0wv_L)Լy# ԦMC)[l{Ȱ_="[gUV*Y2pGҦr&iiqrČʯ$5 vY"8:\gvp0&5_|w5*޸q鍞L:pȐE~7d(Q<5u-6/ӏW^)(3 | |Ï?^ۨ]fɢ28dpaRZq`!8:\gv%q`)|T7o+V졼֮_?=?; iР'`;80b0ոYe};w~e N8:\gv%q`q8mqMvױcӾ};5_,[dذ 8lި+oǎy:5oc˖ĈҥKkȼ#B3>>۶1ߏ&'YdA@p\%Nj\={VzʎWO>Y*b[ ^"+V|ʕTq3Q23t11Ӧ&'YdA@p\%NjXd9z_,wUZQ))qMTcM̏/!av,h359qtDY:q*+|ň gtj7F^1ؑ3qTƲ 7ґ#ɚ,M6hHN7d(gmes&'Y'KS2# Z=|q*RAu8( 3ոYՍ{{yռq㨔vD,ʒQv^%;Eɉul`ɒW\`|Ƥ:|;"Wf-ˈ>E_Q|ҤwA G=ոYr`wm|}k;ĄX%G;6\6Wq: Sdĩ3:\gv ,-r`JֿT|c9mW9f.k5dܸ^=͉>Z*?p,ޭ~}RJvՃ+BRulR^]*̙ￌX1@e聩JBHMUاO~;R#7ZʗwS.Yd BHY$KS:xƶN#_ʼn)xǷ?]` ﯒>ZۺtӾhW|Jq}!p)@:Wc7ϔ7]$I=ˆ&u7di&Y ^zJq}!p)@/ulNz/ҟA//{CߌWZqc-[/hN,YU+BRul҉SY4{yqKc.}7gɑV{޻H5PS^T\ٍgĄJyΜ( zSDG:V)K"ġ: SdIm֭-bۦM9GJ[rdVk9f}:&..R}Oyѐ!/.U+~Jq(NɪG4tgRa)K7B`;K Ҥ]ȐH+e16%Q^4u{V2EpBĈq$go^o)Kޘ{hpj*>`F>]U{1xb/ϡ1WE3\gv ,rW&{.a2 K3Ϗ}%ve>̞t@JX{Ϟ=LeɒvTYwո~}r^s5eʀU+>'OCɗ_nZfJr+Wt߯,NA%,| ̀S8;+Y1]u=j$Sbv-K:;m

\gv%q`qNvZ׳vBWH߼C(a)}ת濷i޼uYJJ~c|AQVA*ϟϐrTT}ʎ4+Wv.99{ 1y12eJiK-VzOM,"dr,~4u,uB6mJ0nHsg?Yܱc9|챇w%G\:^*'L?B`;808'#G Z&EN5IYRv+M>YO}LrHuY'%K*UDR>y2+pJ|OYHվ}i&SZEՉȥw|'&M7g,U\(gek03?…rܞ,  8ɲٷӚ^WRIduo@Zc$rWh,E7ݺcbBOި`;808'_i2cOjFDZ%Kߎbz*m4TDN:thr^ڵhQ_X7>^^5Id\y]I QxG?嗛T0lhqګ~ʕOI0!K,> Obk,؎Cd)3soNKI$ W+ҥr >48,9-) oz܀Yghύ]ޔZK$ġO<3ϸ 4TvR:ʔ)Q}Ϟ&h$K,Ѽy]iܕ7mmWOD64߭yVN/ʒ 34%pq'K0_~ Νߧu@qhf?%gFWёFGmRclJp۱,K99{u'/_>{_y;vl*:Y'L=wѣ{56.P%))Z9ҥIY*w7rdXz/r(_ FDٳZ|F^<=߷oIsg(wQrZZ]z{Vtz_}.ۆH۶mxRy5߉vh74%'_ylhMkYYR{qhX!;fot9sxc,HI űc/+qsj[O?}S{N]`ӿ-]ihѨz9zܐ'K&zСC yYQkGBu5;QmCf98DqtXW_{mQn$}v 3g*'Gnْ(nN)"Ko5C*,,PK_yO?9>`V&qgź, J־{I;k}>p y9dqNTC伙l ,B`;eiΜEFIA\ԩshY}ڷm_aQyD;I?|y3ޜA@Y"8:\gvgA@p!YdA@p!YdA@p /=79ߣ"`;80 +vy>U^o dpAt篆:W{~ϮP7Kfrs|,Οd o<<,0WC cUV}_յ9I>ulOt篆:W{~ϮPRQ#s|,  85й{vդҡ'S>Y29g K :W\᎘+=gWMzFE{n9I>ulYbBul<艎o<<,B`;| Ϧ?pΞ=?g€Cqt%dIAl.\YPDA K`;RŎrrre˖N:2IYlJ$JjTD€Cqt%%K[=Z>{.}4t $*%%E$JR/XA(=s?vҤVJAwpwGC!d leh' HL%B,S>x>q̿4ۑ-?룣];E ʔ$q'%K>H8p,Bd lǞ_92Wv;6Kcٴiffȵ&w.^ܭZq$ CDTY^kp KG`^gȯ,1D|[#`􀇛7Uԅ +T(;&3sn۶ ۵kԧO۷k$*=}A3>2D}qoP.OdCFe~|yRE=&#cn0`@cc<_="ݻ|AjӦNygIQHđ(? 8b,˽eisCEGȢT4ɒRػwWMC,u\7WRRyMzNv{u^mG&*''':::"";sdU$wSPA!Ns,k3eߔidQ*\LRϽR %K׊uD53&|޼5RBI St.Ϧʖ-RD%BS`w-K="}LnF_YJ6 4vqzSɫW޹դKn^DI%Bul޲yz%v'O/#Ҹwk+UzzlӳgѡoY2T\3g ^@@ 1!: <\6%L>Y AJԨ[53'&᯿]O?}xe/DɠD"""ė DˢjdpÇRB>|ʒ6)mTTȺuSu[]r?}_2>gUeG 6R@Ou[Կ6_?=?jcٳ[J(^vUI͚U };+} lL!?=^Vbժ_}[ǝ0"Ix2eJIArHrB M\\],7,^PeŊG8?"QgcŊ=t_K>/d:Rb%\gvgRZ Z Q[_~_B9mQݼ;w]H[nFTqSn8ں&DR>I];t-[[w[d(w͛崸?w );UN͸R˩Si.l78mm%lkF~:GRb%\gv% #?ςm6""t5R6g&N#Ѩ LcиHD&73f 0qc]ɍYRdIu1"ۻmsYasDZ+S9>c޲O?}/7!qq||}ko:K:)R<;;|o'ܚK[$ؼΛ;'Sdom? U&~2+d_Ν:vlڷoIv5Y?7NֶjU?85Bԏo;~i`;8"v#-[DIu R/gS&X6ZݒʭsT/ٳgaŊO)A2~ͨƍwiSB~㏻yo,ȝr.w rX}Aڸq7ΝZVq'fuk~Ub]|o'$w\>{x,٫Y z*{;sf/ʒŗ#^WO>YmMn+Wҥ}!jvuXG'RW K _4SwROR\`,eI\jՊRxxTOI$w>Ûn"/TC"7I3ƍw=qRll!Z}pV7{0"Sgɓ)ƕ"NիW ޺uܑ[%XL9QSΛl*]ۃFTTILN%/Gγj#8z_Vd0ےѣ{եcpJI^: ,1 Q-`[iMi^vWeY2?ƍw%5hPGe*ՇrcY2Y7'}GEeȰMO33Jc("oJL~BLb^c_|ycz^XpڃEY%hpLK{yռq!mzp^_b|WOWb;Қ,޽KnagÆ/;Mprv/SZvh2HԏU~yoeom4Ei.[%K&s[?!&}ZZt/#c>"K/QmMΧ!-5X>G'RWܧ,&(?&\ċ,#D,=*KzD!ƖY-ҕ+WLFn^}}kqLLS O}OY2ߕK~ynǎ 꽐>鍞L:pȐtϤ 6{bV.b&׬oG(] Y{+~BLb˝wXg0|:ᔒulVYD 8IT\\H*˿(Hg el)j}ulGYQ,R6LqQ}pGgG$WPN-_wM8=}/M B)Qv;1g _ ,lj: sa߯iE~7'a!Φ]F.6U/}i[d"KG K .-Q}Z5rd…#d){3~H:Dqt[3GWElTAdIJoLj,KnEK}XmڛȒ/ʒa?lsSdiԁ>&&TI|nJq(dW˖-+{P!: soYVdkx7'_ϐ+N={7o6`~dixHgq5<5=D5`@'5? GJ7wWӘȞd"Evv&K)))YtHפ_R͐%Bul޲9"ȒydթSM}jÇwq6`~dՃ5ױyFy=dzDC%J(:Y-լY]Q:ܔ \#dI \=dBgddtY"8:\gvGŎE~ XMժq,;="8)4ڲeKٲe%Bul'wZ8YPHH@7cȝgɾ};>"KN EgFGG?쳞k{ӠAId /yF}޽r*kԩ4kXj֬3neʔD!AZ=DkWHaBnΒŋ UVG: sҚfW(ڌ׋AQ#$$%m"lp~ey,3Yks^[Zq1c͛ _-kmG1>b.K׮:th* ٨ܸqT:| C:Tq>IAkкƕZ.\nc qp۱,qEDD?4YMFD.]]FJ9g>>; ׷֭6XZH61>Jllûefm۶aXXOٱ[m>Gv^ssIǏ]+--N՘Ȓ!S,Jvre!5^$/g„>e[xx[mmBH Kz'( XpLfE99{hwf??FM*}UbL6z޼?G&BrjkqݻhTG7| "Q"Z7μuvhsYH{0؋K}F\,$$@M^! ,9={3;;[׀YeIO߬^Rdd֭D?41| GjW㚷Nj֬JՌ+))D6#;g&ΦMZŢ,tբK/ՐGf髯ҵ=\/**DGs, Kb̂m.Kڃ. ̜߬+RY:xpXqMllP9Dؘ10%yg2kn۷6oN_IEY<×/Pe"ɒ^=R, Kb~gJp3 YZ~e?\6i4iR\\:SJO_pjܞzSŔɼ沔ZD""~6mfd5!;Οd ;*8_yYmKY3EdkQ_OBrҲY"T-[F\`ُOMxL66ygNdkx11n )jyY)H\\\Rٲeozw%K͂yfkB$BHStǑ{a~E+dp,ڤi6jd StǑ\5DV!d lqrY??]AA!SǑ|1 !Av8حw/' d K`;E}9{]ڗ Dqt%WHLlٲ.A KGY)㈚H^|d K`;#???WOOO>bY"8:㈫rh{p(K> ٷoQ[_?]IilGGw_vɪg/^f*Z~aS֪ݼyXLzbލw,,,P^3ϸ)SJ#GDDim""gDkWHaBn2?-+VL.!YaKvv rɄ$.-/+T(g^NIMN^??/U6mìVk,Zŋ׊Tf-N%hصkZ"H͛VݸqT+|Vy73 Z]:i9u*…b K`;#wHIIѻz<@a]FW"R0_Ttv)%:5oc˖3||}ko:K>#3Jrعs^ǎMԸkW!׬f,+"Kr=U(Gvv&NӲOFRE+dɸ&F9_}Μ(Uͼkɒ~T,[ũY۷HΡSzre3aBٛRu]&E9]8P~#?Y6Q-_r|dѤAN^u`Ϟ+>Dhe/^*VE9ܵ7m6׶}#RUOi%ＳEzOrΜd$jԽ{+U%VɒVcqs5$'3~t\.6i 4!4oym8֭ 1%CySggd̵xZTIti&E3HAlٲ|%\disCEGȢT1훨U~f"#n%2Gz֪Upp3UҷnQAM~Qݐ,UZQi2ekcdž~tU!TkG:fٳ;[o,QLY|ġEWߢB K`;#]4#'KMEdX\)L?&Ri\v^~83sKuYҶy{R^,iԸgڴA'Gr8sYyr򸰰@itIRǎMZcTsv͉KV$IŢ,I{˗X9y}$>Z @,0޽gϞRXd򜐾Gh+RiƊ,_?]NV\Wh Ɗ,z6 eQlGy˫GRt믷Y9&KZOpv/StOիw'#k3ُsdDDPT'־''$#cQ K`;#dK ( %K7_;aW|ĝRh8B*X?^ۨ]fʕ+W,q'<ۋ̙ؐ~;ӥ{o!WN|}kĄ3X9&K==#N:pȐ则s;thңGa߾_`,| O},0r:uT^+xhlhK}d.M3f V?g^v?G[=B-AvG]3ٞz>K=:\ m&g˨u~G1ȟY*PpeRZBO%Ƒ?q9eKP@@!8RUdhTEh(h!v!!!JGQt*@DQEDq#h4 qWC&Yڹ3oߨܸqHHH[>ݶ {}:uAud:_c4 ~ѠZH@Gdϝ;JtI#F65kh޼!b)) 7o!FbC+)[(EDq#,(*,SD:#c)fkj1X#뒿Vl>] tvu1W:Ta:uzFZuQ|JO B EHH[]f) ܹY)J,B\Cz!(hSH%,ߙU3{$l 0`@L.Z5[ gGFGEEn<7wbԥ~\9(6q/Bڵիi#lb_z啾 wosm z:%3~O7veaО ,!ɓ7щY2[FBVMGpNb,8a@mv5\)EDq#Fd28x'fgθ^-tŲcYH`QV@ ،IfJPp>6m2nkOA%m+:wni (}V$vMZn_~9x={ސ1EGF=Q3 Ll`/7Dhm2ƍcҮm0` 2,"??]$TT(pR"FEE`-6lժه5KqĦ~5K99n/nh!v0K*J(灸Gf)i۬Nݝ6wWZ4$:- Ӻ0NmQW9sبQ/DFmC0[~Fuys4[=lRn*.]"^|Vrr τ Gl2w(Y2dݧ̮ۜ%4cKRT!u؎GT),,ʼn[p.G?Nsw@f!nyh޼?-VeC'P4Ka;Bʁ` $G-}&OiSS6lYƭh(ʧEDq#`2`‹Fxq )-EQTYDDq#R8LFaa!,N\f(Of:lGH)tWY(ӢY"ۑ2%GT*&R^h(h!vLa45Qf(Of:lG^W: oCp,Qi,B\q0K!!!|J) 4KEyZ4Ka;RV Nd22,Qi,B\HY1*J(|HoIY*n8K$?ݿIrrZmeL&c՛4 \Z_}z;eѺx6Xbb Gj:r${QMTFK17@͚57oXJJ͛EeiRY"ۑrg(..qB%}juHgd ??,a5{…=k *If:ZGvC4 RNH_?3pJOŁ#63ѭ׮M{ZN9wnG\rh!vxX>X,ߙU3{$l 3.1]DjlT=Ѻuy(s1r場]Yzu:gll>}"aBf={׮NƉY23ȁ(.^ĴiCX۶H`$dls(>SvؗQcm׮:78;V2Kzp&O99:#3KKp']j:ur!?^x_Y"ۑgdȧ[9ozˎe!EYaΞd t=chX .\سztkAe޽a~ršܹ2[4KFu911>$$ݼ^ٳ=jQNKm-yC2zrBUöls1@l͒bpp@$_h-OHUC<*+%B)*T L>XH82Kc[A8ae͘8qT];nFrs H#/o~~`+ѷjܸe7焆62;6K0l CBI5'5Kv7ѣkǏQ׊l??&\9kfbL,hm{Zo͓jKMMb!u؎>zZt[pd뺥O8 3L2 dgOJLA fĹXۧOs"yR͒%3,kz22Ϙd]l͒maAYZh̶7m˄_ZqK]w_˗ G#KccoŋI5PTf:lGHeSXXHI nҎɛ`xbeHKK:֤ݻB}Y>5h'{1;'s/Raq'f7ukE{yȄ]9sfIfIqQ#~$=xl.&GAj4UNH~B!u؎V˛p\ArJ^ǑYJ6Ӳswݕ+ NK5ȴ.#S[T'"f6j }mP: ֥_rQqqo,w~{ -c;s4лzذÇ2[Ia~ƎdwYG]Pg#m6 }^yE(%B!a4CBBG7O<: ?-djj† 3Qh!vp[_0UM\SZf:lG*BaaJR: SVV)h(h!vsm܈^jJGA*%<-%B!ޅ` ,Qi,B\H=N T: qh(h!vT*Ѩt~Y*t,S,Qi,B\HŁSc=^ S%<-%B! (%<-%Bq xFcFV}DՀ1Z5[ 9 wosm qfTCWt iA%"]qWCmN1Û}tFޔc:~b_1=?y`ԓwfG7TKBBrn<mMSѶm(ߩ]Pl k a_ѮZ5\͞=b!5kxo][!d\\ǿ}q+b'NP?x kMvp2N̒[cF^ #%)h{c-N#.*隔c{e-%B!NSTJGA܀3gM|bٱ,$(+w{Ʊ=# SO=z~ٓz)֭[GRgWu蠒ze1K#$, :0'b_CeDPtLяn~ rCeٌӧs6 wr-+:.Yzm*<{2Pރ%څutq>W K5KFӁw;W=!l<w^dɫGxv= Q8X׹sKe$믷:ߑYF.̒}{שx~D۾} tM걽!u؎dRJGQ(..O,yoaZEdZAg1>H+*<ĉ/k?C /L4]GKy!BC%T(r}{9H][1MOY6oVZxm 秠 _$;_|n!F'%C֮Y&UÆBkGe¢\f 16"[h 9B~' :fԬ;FlRXȑ}~{VC/ޔru]f#55Aa\E7e,}#d}{͖M\ "0zl@xEDq#n $$}wZt:v%őY떾?=@*"2ˠ(&A#`AM1y,W,"QgQfaN5]mEБBO1(tĬ,ut kЏTP?jO>Y+zcרqXV>pm PF1^1AZ7we\Am#=L(,GQ 3gWYR:zmOIN\\Glk<yN'6?q'fqFA~$$8o mas)0Y=W_֢Y"[+`}Gf)i۬Nݝ6wWZ4$:- Ӻt 3Bdd8zXХKNxpj[=lՙ8q`[|2/o>jkԨ>:& 1[ωY RL̳~mCQ!^׭K0E:vl&=dd/kv4 [-cxCE뵵ju!umcfΜ9#e{[tHfIq_PgJ:'Kפ+?/k,B\{@z }'x|s$/?7} $?\v<{q#?qqW<^#* %Bqz JGQ1L|%oxt8.Oi̹Kfm?9=&Y>JMMذaӷ%!u؎A/)))-EQUA4Ka;6L&K0brh(h!vm x jZ/f(Of:lG J@~G<OZh(h!v3:NRqJBDQEDq#rΕ@,Qi,B\툛 x!F1>>{Y(ӢY"7SXXdNh(h!vT98Ĥ85K&188:g%q%7n%j֯OwBc4 ~ѠZH@Gdϝ;JtI#Fƾj֬ѼyCRRn,BfņB+WNS'JQ^.%Bq?h4*lVC͒]SD:#c)fkj XW:Ta:uzFZuQH>]}@ttkpdιs;R׊f:lG܏`_R: 1?VfiάiC ab.]"Zj`A*rΞ͏ hݺyn<[ksgV߾Qbȹ{M]rPq={׮^N=BQk'O4'G'rdfl¶VԧOUmHNb,8a@mv5J) EDq#ĂQҁ*3gM|bٱ,$(+=lqMAA,Z4vڴ!ȹpayY5ºlt蠒 Ν["[͎͒ rZe˜7I[ٚ% `w}!?? Q{xߔJ4Ka;)|1aoV,yoaZEdZ'Nصkk?mԨ~RR\n<GFVL6yy ƍXo^ O:}:WvtvwԬYJb&E장o͓jtijjBll;UY".ZV: RVt:,^82Kug]XDuI1bl2WPOHGFVu›7m˄_B%IȮY˅(li-[>x8h!vST*v}%AVe,5X0tvLȴ.(V̒G~eYAB,Y>cFum0K\'%&ƈT^:0K{͢m2a9Vc{tֺڗ/qG3483-[> ')j(Yrt Y"ۑ`0aU`q%82K $ ݤ7x"2Zkڴy,޸qUf~ 9AA9lɐ^%c#QY֗5h'm.`1]~i3g[%ؿSoR۽{Q@@-C@&bHh4 Gg]nmZ?z*IS0x*f:lG*i%Ѩt ^#mVeN+-sWj)+6q֭ld^|ecge0R"Vy=#Fs=JT_%!͒bppHTx<ڄ-Z*R\\\Z5$A!,Eh-EW$4c U* pVqnqyz ! %% ta8Y* $ߊt\ NrJJ \X&c!K,) :F)Fpa{t#$|2t![ZB@$sB]ău3$A`` =>M-..yLWB!efEt8]oMh4v{@e!+,)Laa!9*h@ܕdw-b>sXj`` @B) 4K ßIY38wL&J>9C׫j!C,) 9tM">uֵK:hH'/UGdG_!8f+ʤ\ID>d V9ףH ]g Bq͒W?W!;#[7wBJfFw-y?0E|Zjcb4aViM !%oUE*7R8 JGA!gYБߵ G3%B!ef<B]hgZ`t0KJGAp*!2BEF q$%vZV/`0B)#4K‰)..pJ!t|2!!CD",NTT*+B!͒-q/QJNɛ)..D!,,y*+O |x`08h4z^(!4K^o'@Y"RhZj!BHYYFz`P: &8S\\ tp3!@Fv'5">>?p*& ! ͒ۖ)))AO#UVKD!Th5qTb rB!,y)!!!JGA&IVsJ^h4JGA*.].!RY^T*'JC<"V߀BJ_-#u8J!Th!P*b"B{h>(c!,y5Ff(loa#7! !ż9G}k9`2zQBjhBCB~3 !*͒R[TY^\\I`J! 4K>o["@III}QtB%BH9wT9iUH&| !,|d*pAj47b0cJBHf7@.B0yX*,| !8f7-;䇮V9B#h| D|\7h8M+!G, ⵠ7c wdB!Th|шQbɤV`JgU5uK!C,B܆]a09TըV_Bo_}8/7x3ߵ0KUA !؅fɗ@7.$$D(){dbwB!2h| V.-.. 9G܅`ǓBq/4KO+fIBB{DktJGaH̖ˀKK!.4KG||<':jf:!*J.B!͒QXX‰Uw"j\"b !9`q5: JGA!YI  "FN~bɂQB:h|`W`ZLFOI!BH,*:+$JkB %?tZvd0!vQռB %_>t79>><pB-4K>ZfϏGD! @DL&Zv!B* !īh4Zb?s){B!͒S\\̉FďMYBSHyVJGA!ċYyē,,PYJ;B!,?Z.=H%*!$!"AD=F|?%C"RYT* %U\v,^XXqN'(BY4 @_keȽeK!*͒>"T*Fsa> 6B$h!>LIIٳCBBxqժUdNB!%AgA(QĿ%">>ޛBf;NT)JJJLJk)_k`@ʎeBno4V- ,Qay5#e̒MEQ-Ot/Y2\bkFQED,QhpҤI!!!lͪ[?`q.SRoȐ套zن!Z3 -+jpaeb[(X={pChQ%%q 坢Y"4P;<}:I*fh&Nصkk?xɃ,yնTÊSi[hl7w5;M(m055!6wED,Q'P,%,yh۶L#4&ǏsW!9zҤAٓc~9A i_ljeh4r\Ekfwk,>}"mƎ߲哋|nY"DYhrW(U.hbSSls2,Y*r^vmZZZԩݻcPYYc^~9[6H- )22M/A:7w׻xqhl7ܸqe4xX P~ %Bf*8q~,Q0޴q1ׯ=ujJDTT̙Fzžfk@nI?t Cݏv _o5nl7mۆax].]h7Z!v,,4KTʼn+f(!BDU\Byh(,,4K EDQfeY(EDQfeY(EDQfeY(EDQfeY(EC:~h1oh̎.kQ<*,,4KEh|Eo# _mO|c(o!BDQf'GI-_*zGk4_ 8't׮Eԫ?3^=o,r)²a~zl2^w^$۷& >W5jTɐkC2/ %Bf7i*U.,yЈAmN/wO͛Sj+}O©S[|00"(ܪU:u/^g}_nذwqB|uݺIWT,,4K> NSfvȪaE%욅/( ;2K+VL}챺swNϠnʹ@ZTTĽsQ=th)2_J-$+3޶-ڴyZ]D ^:H6[7vd餪_D009juXZwuBkd[th Wj)9:o99Fc&o-v"NGoʪUӱ+%%UJu,,4KޮOS_Ҿ}?OkDD4۵+\r9p*wfA+ƙo4+_JYf$?{ʈv_|;8;,E>U}`-wqǿ'*>d:~sQfvkyΝ[b-6h0\ȑ}~ǏD"!! J[g:녰桇߰aر.m>X ԭ['--~O:g_o$v jܸpb '=~'`//{GwED,y5Mj4_KN|ѠwӁ͛g۴b1,q*K5Ne2,y|GY:׺>=- B"<{:΍ O횥K}fK^j(§V&Lmv0Qf{?RtskAzk>b- 2ϞG:55B$dmu zщ2/4 |4RvE^g57w8![ε.&Lϫ;j{ﻯuUڵiȜ:uכfeYjkʱcX?hƍࠤQ1c֬[7瞻'M7?(:r$|j ߣo!8,vO(.%W~P9qWw2{w9msq~)1~G=z'?~ǃ{1O?y͚5.|EwoBh]"}@=H8an76R͒sttLZZ(Sn-K1حVk iG#+fpk簠CIW .@bY"DYhZ嚦_tO۷/tiȗG|TO |ԂgJ;_Og|9+EziĎs-yO88>ܷo ͛7Rnm_F6o-ZϗzoOVݻX]ٓXz: ~N*Y**GGg=vm%mhZD6n\_5uNΪ2888HZ6Eyy;B+==ujOfeYjk t!&Z?.WڥQ@&J!-~A%~D.p1R'xp*SYR4Kޯ'M!}7Y=w -YV4%%AxK'y -[6v_}*l~a@CתU3 vV~gU`Duv=> -L-]VFXX#GYgZdD ܲegTiCJGjtiӆ89 ffɶ)صNliWR2,,4K^rMSoD|atefI|/^<i|!3Wh9+EJ۞:-:U#mϘk^jfJ%m?>x~妧z<  |tXXDo޺BGf ˟}4HJ჏Ӌ=6ڻwlB:99mHNXH,*щҨu8k4Vk+$idVZK˟DD,y5Me׮,\W2%у#R/u9+E+#jZtﷆ&Wc"|ӧs?d*hQ%VqMϙ3r԰&X)YS<8̩,^)%Tg wf%7]9EHyϕ7fDD,Q凢YRJ%%:˅/_ |^_fNp+ǿ뵢;SFΝY%l$M>lF{Q3]:{6РT'_"~^=p`w#z7n 'GgwG?|_/ 6&$D!; ]"7qc䥆*[[ٱ3|B(NVVêUj8sf{۶@˧,X뵢Y"DYh|RⵑWWnfI)͝;J|r{OtzkY?,N8p҉H>+m,%%}0 xo۸qW_m޷o ʠ%/%|zi/0Z|s$Ҩ-5l "־i"TGkm+HE(;o=y"VCG'R(NVVt'F ~OKkED,8Ső|e+Yr.%4rd={ސс޽{ k9#8cFјD߾QFyl.]~qٳq0`]&cgrփǢ̰aK1ñ5KvV"v-Pvd{"RCEDj6T(NVVwBaQ槟n?ݻZ֛ED,)#TL 2_~9"+S;M4Ǐt^3E,HcB'O~X|[r%|De&Ⓥ>G^}u> ͗+$!o \̙2!®Y:Dڵ,BymK U!v idnboq!Z?ح[*~zhQ%eę*͚5|ѢV[a{seZ':RFkhŋp㺽rO?ON{y5sGf .]"lΞG&>ǎ폵:gڊ'(3<&im2elb^dMlG0>ݻ9zmG^®Y:Dڵ,/$;o֛{"RCE BNA(NVVZ$n[B f~_?u͢Y"DYhgp2 eҤA:=+ٻeY(&Lp8ϙY"DYhgp t˗ ͷrf 5S4KZhlKJ)feYRF™*vǎב#Y%QYm?\ef/lEQ!%Bf|C|]DDQfeY(RDDQfeY(UifB}:788!!nvmu'sΝQiWEUhJfr|,)(yY=G MII@δiCth6 Q >SvFc&€1X۪U Rڮ][u o:p`7$"ڵ8d*aBgO<srt"Gf̖֭Ûjt|#Nb,8a@m(~Q{ET*~o[?`q.SRoȐ®A]Yhж[ٚ% ݶmKX+~k}rHm,ۿe'/'@Q~ RQd;h(|,َϛ7Zt?h5/KlhE.YzlQlk;7#^m8qW(uyY#Kf92K|]P,8fXX4Ho9ڮ%Oz[jE` 9ڠYBz2v֬.-F krrtݺA[gwT|Z4KfvPYGa1^4y%K^- հbTtmk톟nFrs/*[6~o7K‰+墼,ן?+W.Zn2vltʩS[T'"f6j  {l?`@L*|4R-8y%]vԿrD$\1K ;(RYx9sfի@wnҤAHi_ljeh4r\EmwC|}Zu [~o7KRIN\,QE.RX6ndɫyyڵiHgeynژMQddqץy?^}/jƍm(ӠòE|?vĉ+>?BQeEQ!Rv9_}9Տm'7}Q ?l}۶ju^׭K-ڍVsFyYG'PTEDQfTSnW%(EDQfTSnEQ~.%C4K¦rh(s,QY*6ŔEDQf(R).%\4KEhJ3MΔg-+ P/%\f!TBkTscydcbд\ Qo,ղԨJV5%[ӽ`kFQET*4o# _m6VREQ~.%C4KRN)LZ͇.<#x]UٞYڵ+K ըQazSh];\W¦M}ᇫƂeV?ohzLtƱv5,iݺuV۰a&2'M$|/wY)֜8apl+o!TNkVߔEUAUNkT)>~&jB1OH7~ v4j /GF# v[sv23͛g=_jE%rUrfQA´~: q&~HgeYr棰d:D#GA_H]Q\v EQ~(3KҲWP+Y*u,Y5Pd;XiJf=?{wo5f+_}9:wcu׬! _yqq˔)yž^A>}"y<jۼO?]׾} >Zj;֭sjպ_߇ax@k:[A's""asKII^ΫWೲZc7S#B3gdH#w%s>Pѣ= R۶8.Q\Q'C?Ip,_58;%Pf6I*$??EhJbho Zyl5jo4+_¢jzC4ʫTO.mw/APQ1c׬Y{83z_Qr,d7ٸqSW*ӟ~)X m3pΝ[ ùs;:tPo+W< a۶e>=S ի RSj5m,~ݶa7zDp2 ڵ]hܸY lTrrj۽{D8i*, v*Qd$F"Nkqqrrt|h(CyYTSDQOfT*ֱ O署?pkd7C_(287.<-VAwA|ŊKW5ҲhXd~#1?kݺoٺyldQO?#u_? n{˂mAQڅ"5]$:uzFlՠ;>K]+bHiTݰLYhŰ=:]ҥKeo, V:VS>O<(ЩS[-xwUfؑ#MKgb;/7KBQTEf ~ppPŎN5_Ոoʾ}*\ƍ̖o&|)ZWa8 ߾?6V~eJL9|ѠZ|[vQMT#FƙGWy$ܼYdv\9v/Zm]yߩ&RR9qA *Sfs5Ƿm.<%FeDaу啾ÇFG :D⣏V[d*}:dΜ9Ld~.]"?5{ ?|䓵,j9sF"?gMO8HՒn ,G{;991[ĉEI=XCc$$ D~ϞLI[]rꩧG8+W>w^m8q;͒ukd[+fdZf2KRٽ\%#c)_IW:thH YyQ_ӹ8̣@ttk'On23D.q孧hJbf5;΍|k?}_ao 4]viҌ~7M~ e)b஻j4,b*.^ᇫ ;/LqN^ 1j [99z sǎEͭZ5 z>_-v2o9iQ-H,Dￃ4ARR6dffFz˖9"+Zc7S#2[Z > :Dۣs}|A^' %'g1{ѪdmEQ>!/1K7,i8g]2G7*/  p@PQ)7D4DPӼ! ^K;UVJ1MtkϞf᳞3Ϟm>kű5#GybѮX1 O_c}p>E ѵ`a֬IUF~|##=ZLE CmKl9%6v;5\(֭q$Kq®W_CbѮKj+ڵⱛ7o̙ bĉ5( -u<Y~ KCk:N~E«۳>׾_$E8j?N&:9=y x FyɀSGnx| E_aoRXc=\w O,tA}!v_rrDv{bb ȭ ʤ륀%)2hV_y`^]ϡ"0=4fD.!Bw/w;F$c: +9b ׮Uw^Y5L,*o,ƒ~f"[Xt dY= ~׮|BQQ= + !d0M,nBBcg̙[X~8kNCe`a9F@CL |~PJJ"}a0#$'6ʘtm4үA9Ç3 rk!>X09w15/eGO#a $ KٱQd ➞.NF G[,1 HAn-B ƌ\˳Gg|iXƍXDĒ@b0;6*$#Wusu4E ֍KXHN@An-B6" LĒ@0;+q\1CI rk!9$H, d cbI2(KA$ 3waשׁczA//z͔XS\ukF~m],A% KMq_|mX}k iWaaƖKA&Ab Ē 7W쏈><?t/4f̰!Cbnl93!0#?Rz0;wcxq*jkXtJS~YΜP2paK/ ٪ex;lX@l@Vر;ujSRZ͛GC_]QQh}{WoXkZB~Sdnj-7TE  ߿XUvmF\\h޼;}|W|mѢAv%A_V?A4H, rS;ٳܹ/_> 1X(w+c@}H q컈92ԩuKLٴigmٿ eSwg%xԋ=B}F",p=th#/$ [;uH^kb!jE M>Zn"WB`?@}dk%3x}=% [K{LZZ,X}P d0MqK_ -FþnwΞcG^|1XXڲeULL(t_x!]+99/d@zkі&4c m>p`96GKkBXxՊ*"{}`S-D.Vk'[(H\^{оH,aئXe."A@b`ER%x#XҺuY⢢PFQQ!~X5uHyyG^Br(*BV;sZ;W*Z}-T7Eh*Z\L8,Uۂ=o:ē%$ ڶ-Wq$uI\9{=.A%o Cd.UMJ"6Ca흩#6lȶC6%An^ A7n~zĈÆ|6}bܹAAwb…]>=viiX۷o62hϜ9ckW>"c==v.]mߞAPT6Ca?p`GTH>ªPK|BxՊ~f~gl”@s kv!cK(AI'|ߎj_w. f 6Œ ,bIGV+їH2c4Y $\\_\i3 l K,ui@Œ)A K+ݲ#Gyzy7X1 t:$ĻO_CTK;v䱛_N¬Y ( u{Ȑaaf%&&;mV͚5e=M4oތ}ŅWB ků[7[!:JҬY NXHfP; =zM }`?}-G3P&[>jT0/$"oNm~@b` DK4F<?ҽa?РA>eF:ȝ=ÔyΜ O,,*~K|33I,0#8۵t8*/8OLL(OB`6WC{^1UUPDddڵĉ5(-6vXnc#~Dq.%a]TtH?XN4Q..Iwbb7_kmr;߼yPp\>fNyȖqtKŖ6Z40K %avlW,L<_`Aҹ2Kp~68%#EA"~׮|yb( P "~ۢ#\,A|S莢ѼO?݌M@֭w_}UڥK;h'_\@{S 4Ue@K:)ÆAM9u쥨` ~`>|TKd~Dv)능[ǩ rnѮ|gy(ge%C*caf͚j]>3zOuߟ~:вe \5rNQ,}z(+Ivb \GPtEv0E9GڐX2FB=?O0Ӫ`[Nߧ)O-E/ك"ݻw&HF\,ed[(h4o‰?Hpy$Sǎ"JK`D*bfxiT@udQlVG~2^FJJӓ=c#w-K }nx?Ǘ9S$P9sƜ;Gg=<~!!޸d@ NuIS,3|x1Pɓk%8vJKVT .~bp C%&#=UsNM6O_  Af :hb6*]Ss9Hym(K CX, (ݻKYYw7((ah7}  u)Ud~Dv)%9 SJۚkΞ}J׼rYIa;X2H,fFREQS'Mӑ_E_Q\ެ܊,,[HyUdàXz6,-::$(رWH٫Wײ;F )47Ċgl@f}lAFM^C2W.QI2c^ЀG RB6" LĒPS|4?K#Y%r WTf5sg7`CXKA$ Z%7iX!&lK`Rp,}˹ՏA}`blKBb ĒPWdK,6- LA%nx:{{wnRV:&&svm۶j֬){^ȑa]r:\#% KA$ cLq..LJ=CUؑ'>%1Z}~`ooٳRSG/{GW,/c-&NFY<}|ܰ C0^^.(2*g/XjV݅ ^}5ãKII&_dUU  ;g IxռycgLPK'NAi˟m#DBb Ē`C)r^/Y޷oɐF!!? k۷w}Au_| ɺuA]Gd1?+?4E!9gHiVge?t3T֭xT ޷o6%%E( v$Y EWYF;KA!$H, ڦx_Qg(%$Ίr4x~yW)1KNڡC-[ O.ˬY NXnn׬y]^8OۿWD;n7ϨZ/(b.b_Ȕ*I'3Kݻw[gpZUJJTX\w6.uAԅ!SUU˒#,|֖SYڻf%k1k(kw{ܸH2ذ![)tėm3b3o?mX24L|?NM)+Y@.ÖҢ-*_㏲%HQ2{vyج V(zE,V5nG|ORuf z j` :`bIT1-zą 'Jr0ddit;02ao,nc}?s /_Gj|bnpM,5ǸmK)>}~;ZU $8WǼ\N\kXnX~ݽ3Iwʳge%Ϝyi{ 5k+gԮULJDK%%ٵ+ب%+5  +`_ÂVT1ȇtܩiIJ\EQGQDB,]<=]v\(L߳gen 7w|ffÍfGGa1nۇĒ@!̎M:h /¯+U$5 1"oF &(2_ïPub\Xz s@vUvNu=/"iŒC $^bQEQݸXJf摡(XLٶ-WEHvbs-{Rxiw d0b+* 雘|Xꛍ! \ݸqvXH,aX"> d0Kg"~URD?[ =zYv[5k^tߧy≖ }2KPK~[ޤɃgw Kgg`%Kt}X ݻ[Uղde?L홚:bÆl1˕qqaO?зoӧK4v}{e(=Lf/̼r"ޠX)UŒ 99̞HV]FN& U,I}3fl$ 3b<А#…%jrqii2o_ Ο)becҭ[Z3Tŋ~^!d3|;Y"KBbIDd3K $4 rZZ4L~ &#wupގ[GD1bI1^,AX$^)+XbUܽtOֲ~}~{g6b3ovRxɔSXWʕd,:l''*,Lc`|3tB߾=x Ǐed;)# ~0KxvHoKC,> 9T\xbU՞ībqUaLU{+&ɏژT}4X<؏:{ݎ['%E.¦latt/vwF^ҥSƍٳ߿'b13fxqB,eg d0Kw jZ/ }߷%lKA9$H, ƛ=L&-z-~p Av% KCmŒ,/a4 $uI\9{=AIK{wZrӦ{_ذ![J<ڥK&~Uǿ'oma|bbB-m۶j֬)ۮ#GssLJ4IchAWWgd'FݹS#իgl$S d0"6ݽ3P2hgnW;KV2\siHb 2鯹vaؾX~A?!}w…5󹸴|RVu ^_Շ0an:th[V|bߎb|j,U)6m$ ^>Ku>]r:_0$ Sl&2UgmT`]5>#\,Y)ǒ\sibɤ F- W { aCu۱#…]ޮ Z;g[?yA龐(2obbxXodd Xu~?fXB#GtTN¬Y AA>>nX_x*o"|ѽ:rY(+"ãKl@l,KrK%%,FJ;؇h'ZvmfLP-'NAihɇL4fH, 1<(.a3%53yr4lΝ> "#cdqۨzc}{DG;vUQb]jK;G#;[K Ow\PkE߼e\\O;8::.S}'0/VK%S6O-תcX_E+W3¾}K`}Uaa`~;Q,;υ_ ݽo`$=?&R,/1? }pFu16,.!n j8&hCkתZ?KBQΧnFSo:_0#vpȔvFMʨ`DĒPKSտA<67e9H Âa&F}{˖y(51ݮ3jV޹XR+Zr9yٺXR,)TVTݰ==]/qr/"T;ˬ3bɇ 능{6n9U|"E<(cΞ}cII ЅlattKsEDG)K}S6J7V:JRYFubo#O˦7ol "nF.^&~VQUo-oA6Q&>{N n_]K~KIm# Cb`0#m[I<ssd/ϝ [2%f)&NK s,b -TRm*ϨZybJhQ9-/eg8g׊攂Æ,d4Ą䓐0(O%anQQU3b|HXz s@vUvNu=/"iD˜B<"bP,Yb `Ξ$OQؿjg/.IL,κ oߞ^k$j }O?GOKի+x^AXK)Xq`M$QXW,Y9ur4_DhM{Wo橏>Z"qStLĒ`)_ofl|/Zҥ>}1r9yrQ^>OGE.lWjV +Xޒ7`7_Q\ެ܊,,[Hy t7}7¾ܹS$Ēv$^GЫ 0f̰@j_vEF:޿ܹ=z<1.?yX^7rd(pSrg$ӺX EEX.$ SL1~FF<!W^i042}A|r!0eµ߹4tmT,3[Ć8g׊"ԠX߿'((sԨZ(G1*i-2$Sm~CBfAX2fFŒT?|bVN)|Ҟ Cb Ē@0;+z-rJ!D KA$ 2ńٱiDa:$H, d Cb ;A%L1avH,aX"> d0K]G^mCL $sH,aX2j% AH,aX"> d0U,Y6KK4[JD]}d+77m9n6d)/_ {iGG}{>]]fUղ?&&svm۶j֬)ۑ#Źx̤cI]]MuNոիgYt"+Bb`R7#HLmr+WRH{^w2ӛHCK4[JDn8 -伲pDI˺4OOyntN2[:-+>oG>X対*m׮ 6x_mw["@b`0efnbS6]#RmĒĒib; - W eDȑAA^^. …]ޮ ZY֭q ˎ ?|.|dW1zҤ:hOB`=kz(t7ȂCML  02LlWF_}5ãKII&Q%I7(vmpu6gUt;Y" Cb`){ka9CC{ѿWÇ;Y 9w+_ҬY JKˑx{ۿWD?*LKcYV4C"[<5XR̖⸢p΄>!.UYu>$䭭b3oRxɔSXW]胋gHάUSʷ8ujS }ُ_&&>| &TT,utt`w@WV.e6 F91@=#gY;F,履nFzoUb =f4ur]AwWKQQ V?bX27Œn`t/v ݻw740SnׯWw\,Btb!.UbɅ-sXhb艆Z&] qD#ohHbI1dĪ3=)bWŒ1.1nb\eƀu=QS*O"R]ӧDz;͛7gϾ۱c뤤hyZV0::gGN \tʸq={DECc13fxqB,eg)SbPQń=N}<̅b%*4yF F'u^I_0tHIB~ d0b1w үZ536v KTN0}ͭ5#̙ O>,%6W,dF%SlSe.ѣobt+1H2;ax{xGsn%%Z5fYlE$juِXo.3r${O[GIX>5ŒjVuQꛁ%Wa]}nܽYYyYX"4j=wn+Rtxs?ytglq p;d߸q W;5ϟ?NMKK){fy5}srrer3mZ,jDAl/1$&%--KK)s0r0/x8vZ.LF<ݺuti d0K]G^mCL $sH,aX2j% AH,aX"> d0U,Y6KK4[JD]}db7m9nϪeSSGlؐX%~ҥ ?Y˪_Ľa|bbB-m۶j֬)ۮ#GssLJ4IchAWWgd'FݹS#իg<$!d0a`UfY $h :`7bʕl9'畅 'K˗+k5>]Mq$o>d6ØݺuСlY~;=WpM ${,rtŋ|p ŒX2,̔Xڱ#`1N¬Y hW:. PdGECuC]Vcm^]bcbcXR^z8$.)d1 ahڵ93Au8%~'3!d0彵e9T5˒v@CKf-'LU=RV&p1^iܸ۷Y|TKĈYLhhÇ4g/QU[f88v ^Y BE9~M pߺuTbI҉7Hڕ[55+1fB{pIY d0o%R^Ѳf W}E,K2K I,}fOjt  F*菱1ǰa1/:w:ҥ3@kʔ ٲKU3UQ^7ʑ능{6n9U|"ExtpܧOe*͛7gϾ۱c뤤y\V0::D}11$$ sF>a:S*Nĝ;X>0EO.gdJu#/x C33x>9b ͔4`l^Į;&,\TFl}FŖb x4G&8^r+]Ss9H).l&ZvZmĬ㱇 %}g/l ?{qLQN~XyJD]j4[05L,'yKXĶgʠҢ{t^AXK)Xlot4a Ɓ%cfK۷w}A9L`t_SQYD>ajXg1aw ;fHH71<~|X>7I=wډ(|r>|WX _qr[  [}ep8Mqd%Ǻbͩ͢˦H/"Rdi'GU,)6SFA=s͊ ˅rq"1EÇ`@>,uxxɱXJ>_Q\ެ܊,,[HyvtΝۊ>88sΜ1?̙ >>n}lFX;wj/xxX̟?N2n^_ 8c CN\+F ޮ81Ң4gŭ./3yQE9[N088P/ %S,Z6I0;-(,dݺutih%%K-}G[~}Yibq+Ēk(U,ۉ(U-*ύ?a/G#PLmf]kGCj !͛tiWT4;D+%ºX2,lpLVΰQTRX`^Iot}Q-Ƒ(ҥ>}㳱l``O}ɓkUoZ0n$ۙ fj;(078zMG{ջw7~t""BrUdKT=d_i0%ƍsR)AօĒ`aS,evΖ*Ēׁ"V5C>a:}QTޮzu-+[NȴiPS=Xbp?ZOBq3%M]_DGsb.@q@,^ڴCn8-uxxɱDa:$ 2ńٱQ${T4Lȏm0 4ޠ!D}@b` SLKYgKUU~, [K۷+Nn @~fKA$ 2ńٱiDa:$H, d Cb ;A%L1avH,aX"> d0K%lKA9$H, 1%Ke%lKA9$H, KlZ&mH,a4)~ҥiOUU-KNs^{-C'ggq"o>f]n۶UfM8r87w|||O4vp&MtuuH6qbԝ;5\zψ8۶岿W2rsx2%%/;::X6d+"UO_8S[f0;8^ H, 6.~+TWnC5A~Ҡږ7e{}N7(AvNcK99,\8Q1:ae@{ߺuС;vyb#a ʊQ|_}U] +$ ^>K{bmNmti>,|La#.ݻwb˫V͌ Wy[~tŋ1(JvĶKƜQqTm1 cg/$ M=<<,f몫fLx~ٸhQJ8oϝۊe5H,a؂XJ}5 ڊ"]gNJMnh5rd($ 8:hOB;wj@OoX ZP[ԩuqȐaa R'OaΝ0}'Fiz( v=#c4kXpa׫ơ̳gm,ffoz{bKK-7fJqÂ4 J)2ԅvkfj޼K=+}E24. .U+¼-?qb Jx$5`3%!C#dK\6``cq+c_1i'W(vK\^ݡӷߖk1<&l2ŋS-x{X55+1n_>tn& j%TdKda(+ (--{'vddΟs$ܳ϶eg/N4qvUB)A/a壚R=ˎgb.a<6-Wz_(-U$rW8GYK=A4r+]Ss9Hyt{G[3bbBi\l;ib &+Ēh%`x==KF `0,`!9sưU,[6U,&t< 7aGOˁi-/Gb#PLٳ$=MmH-ܕE2QA@}N)'FuREQS'Mӑ_E}7Pop'”yy$r6m\M ;#FXR,Y>GhzƏND?WTdbǢ;A޻y $N~pcknj yg}/9$ SLi̽q6I[Nm~a/t,{J n$#d8BLf;v=]8eSUYeJ+>UHTĉ5ըMupzR\بX2fTWu6d\J{.PSg c]}nܽYYyYX"4bܹ=z< 2gΘ *ҡ{f/xxïA Ç3 %:ޮzu1Di0kaz #CdݿXbp?3g6@NBq3%ݘ-&I,),BwÎ| esb4]^8iӇ08]rQJ1/x`'?X1p#Cq&$&#=?'g}/9$ SL Q4jxAK:.y2&Hv7C5^^.۷}㫞{ԩ#QssrzbBްI0d#UfJ:%ObL_I7i_P0rkX /f_iNبX2fTסO(.)³ȱ VNVݳl{s[*v1;[ fqWWg.Ab`);8dtŹs[]%݌1ƢZtlT,3[*N+:iE2ᆧQA@)³ȱX'0`横&Omsakb*6 @~f=ƍs?V<^ H, 3rTOa}3--%06*-'~9n$c" HzjUbg c b tH, d cbIR + 9*@b Ē@0;+z-ՀA $H, d cb tH,aX2fAv% KbX"!D}@b` SLKA9$H, @Ÿ'Ui 웿X".5@` bI,K B/v UU-KNSnt{tݞ#6l6@11;k۶UfMgߎ)df&;u5i򠫫3@ܩz,*aX@&d[uUIm}EcbI+W圜W.(TK˗+M,s֡CVe'(XRTu!AHY 8}V?af!DumU2d}EDCR{qXBBhQ b.\ZZ@Wdylu'o8C8͛7 ?|.%Y}8.%%,F!$ GMddڵb]h̙ bĉ5(-6viC6% lB,t݋D޻w7STBv jh2-qy/]0媰v) X /yjV+*@ϐtU!i fJ@˕oO(:I}{Ǐ4o%}~fȹ[߾}@9hS]5jjVFEC:VV.C6% lB,w7jGGyv1 Gn' T+ޒ-{"l hXW,Mޓ1u˩/"ipLۿWD;nٳv:))tĉ>mHƵMYvFNBnQlX&MD^^v w˛ ݦ2^µkU))QaaV?y¦ DuM%3K2.%{ A?th?__;> Cs񷢢``?ޮg'@{d֬ O7vU^6l%6v #{E9 8#6a3,Eb[{ 雘a Hv)aXW,=9 *;:r43bbB-x6"-/ sUQ$3],+WyKgb |H^6CkתP_%l!cEcq$bIu@pĸw|6]J>KmE%nN\6MG:~4YYɐXػY 6emŚlY16qcD%y[ɒRf zb& -s>eKEQED,Yb,A F5`^#T#{e q//WIIሏCTU:5,::Lct-b61` '8iY<-0K%/=%(Y"D[tdJ\3UZCN,QeY"D[eI\3U4CN,QeY"D[tg,+?#hGj ᤬#4KEلZjFi,QEY#%lC4Kh EQ6(%lC4Kh EQ6(%lC4Kh EQ6(%lC4Kh̒t@] `hˮ~oLN]EQJffUll( [6o+;LLys^Z`&F۷O:?*҂QQrI_ήfau_nݒxkQT fmхYM~_(ҿo\9nW07cNe%krqu>e,Ldݼyբl-w$?`gϖ"^6ej3g.^@Z¢Y"D[e.YEQ"==[P0ݻgO@:C͒%3=wCA48m׮B8SeUvLIˑ6Өc}}]]o8$ 㔗­[GG҃ /<}~ee,I{n^^W'mؐ#_SXxY1ZdS6j&E4Kh.or*<sʁ3?D'nP.>=CueȁgΔMRNQ"B+5e]&jgnVb[ÒR͖f),yU-9^67U.2e4ȑWv's1JKS%}ΰ:ʎ^x_c8V&؋+d;$уo˂ھ=L͒d0`!%E Ef͒P]ݚ8}^HQ*ED,XLûWsz-lٴZDP_\ xZM3_8K^^ a\)')'ui^dߒ.f|Ucl KJ5[ښmI|t}`6FfiɒNNQܜׯ+.)Ǐn_(rhQncV֋E䈕++*E>}05Kh&§h̚okŦÀ} w$s9wBW`oߊR4Kh.̒g+Yjhc7nQvQGuu1BĄzy$&N~?VN…JQ0haA8܌ kEcee_9:$ 0s]W(hZ>4ǂYiE ѹड़0adttLS,)dpkfmхYXAᡀM9qE2:54r0ѫWw8W_6G5k^9st2ݺu}dH۷ﵵkMGm\\<_eȁ$ 0s]0x.]$G`t ]L|d̮ x~y[ɒR͓fqyX JOlRFp1fmx͉2)Fff,<6 {~@qp› LOO'7(;ZH7yߣ=Y NHhX,e3 bH:(}fmуYj5+J$gw8Gt^}9SÃ@覃&5W_MD#p啨fΜAQɓTOW} #L|De:.6J%kmpcf,R͓f)fgO􂽙ՙՙ(BxCL\a<+_l8)XYs>7XqH8y\| JT__s$sxx31,ae3Y"D[tdI\Q%o܏Ν;'SewhQh *_~y:eYiH`6I&&//nf#?\0S~j;CtA֭#|-%&Q`(yF0adttHp7& Jҿhі,Dllܤ;-f?ԧg4#s3(ie.mix(`%Njo[  _r@O v B(V'N^ݽ{jyG(F/J"PS{9R<Tp/3.]:^V1`߾Ddo:o+۾=4 NV^A=ʙ07'm͒m+DYK\@~r flGm1@uw栌Cef.^|:{14ӏ?޻zk:| CTTpBBy}YYƘ1pRcW^} f 3;vlZ^al%KJ_4Kh̒5+FfIrG.rGk%sTaLAQ͓f)fgO􂽙ՙՙ(BY-\>jԠF{R}}FxsZ@~RR8cP_|}`̲g͝પSEG4qNV|GR]p yXrrfϑ{ÿu'8iY<-0K%/%BEGfɚ#ԤE f j5Kyތ]]S;l>ˋi Bt~gBQ-)%BEGfɚa!wb! OQaLd17$RR Li|[@nْ4(ED,Y"R"-([$s3AQVJfɲpUyHM}AS=BD,I-b&~Pè /,\(~,-2KR$X#90f(!ڢ;DQ^4KEنh%lP4KEنh%lP4KEنh%lP-f!AW3BHc,QebxA!,QeY"Bzh(A,B!D=4KE٠h!,x rնm}{Znoɓ*oEʕ3f.NN1?~[Ь^y%w9=G"?b--(,ȈήfauV^S6ojjjVƆ*kխeh!,]^ۭ[m~^ݳCS7krrf/[/#GDOG3vFpgܼyëw*@|Y_k\rtgy1^|gm*_4 ڴ)uLŋ50ҥ}*gNDD!,)z {{ 2e;󴴙ܳxDoo77BS`$<=]/O,!2e!OO 3P__ףG7%{+paοIuu #C0Z r-/_b&/z>]Ə1S);%Kf`Ç`tL^~y:N,`.ܝr–QUU4v찈 q]Y wup,eÆ4pO-^<1ZdS6ʕ­[Gڴ 8kA1Qq.4K6/%B!G_f),yU-9^6\r@Dp^ ?qb-Nl PZ*\CgD3Oߛ9Pt_教3'L`n>}?tˊIi\ﭷL] }>Gx3Ƈ)QoP۷eܝ=[ޯ_Ox'7_ѭ[1sx}^|t#%(D)_ " wj0lbyyfdViyނ 2}9Yڱg}۾,ټh!mI|t}`6Yz17wLNX2A#Dg`Ν駿/Z9zghvvwẐD&رUT, 5k.Fo:m31ٹGLLhyRXfiDQӱc{QC8s Nɩ;AnnUy˖<gzeoNC55/jɬY*;\~i / IkG}MHZ>q/O_j!RFFL~Q;K/%B!GGfMƘڜ&*mf);{LJ Gđ;A"̌9]B#W'Sd :Ög"Ƒ icUUEڱ ^Ev)܅YtA`+'gvzzD1; 0t|Žly!! Fhn$f С?4vg FK:d3cy&bO><|og_G1I|gz0WFfI2L g`)(h(lߜ|:mXPq1Kٓ xt~7}9Yh>9?<@ED!,Ak{3vuMAtyȕ'>W$|hL0g#ED'E:z`nTT&##&.n_ﲳkY||Nm۶֭[^_R4KBQm%Qr倯?lƽX1'ge5tiZ47nC57>0$A;wt>`gϖPzmڔuLŋܫLQ)%B!Gwf)eO]XףP0{B//UUEc1c|}}0'ԩS0t\dn(H2qۮ]N ^OOW1%eLDZL8\]o8$㔗­[Gڴ |SեKZy Y^Ɨ_>xp QcdUXdɓ6lHC/.^<ìY-2rS5)%B!G_f),yU-9^6X$åKz+ 6[.oE Ծ}).2e!(h#%O9J%au``iNX'0r@yn3C$ /!*33c_C[LϷeJmߞqyfI2%E Ef͒P]ݚ8:3DD!,(lK⻧KTw{Ą/E/]/jYey??Bt駿/Z9zghvv1+٢Yrrʕʎ幡c>}睜Ӄ;w봝eptgϖMҬY*;Yl, rw[X8OT}fܹ ykj‚5&%B!GGfMƘڜ&*ݺubd?padq|#'gvzzrtԈ qgO#㑝=K4KJ _jo%عWțss۹~ I2kAQ6{;Kc8!Oí#PTfB!ёYr\-q~BRTٺ5W| &q ?xaĈ+GmvCcԻsp ϿKۻw' xz(a!Bԣw$ 9xMnϯeg zumꃰUכ k۶M߾=e[}YX S]r`ƌO<ɩ{@E)7gYJ͓!%B!Gfw$'A/)Y4z1ĄYWT#GȈ駿\YYԭ[kj%'ge5tiyRT3DD!,)z /fa/o8 Dp>Ǐ%Kf{ 6ѠSaFܹ'l4R]]<~P//)؜<96uj{z,_ w52a`oMl,Y?7.ƅ ~~<0NyҺ5VN ^i->>fbs׮B؅ӧ7Z8J}}]]o8$8šp֑6m`a4)!Bԣ/R<}ۂז/FA2:54x<ْc?)SFAAC)A4^2?/ ¨+{v{/`!JKS%krp茠_WpQrw[7Ԥmltty5VHҥ}of+3gN0} 0f` llՉkM͒:P ݟyf /wȧia]DD!,(lK⻧KTIKtao(Gm}9J8M_%ÇWlł!̌]^޽+pijg˛jLl,5in˫ukSQz( NNppD{w.L# 㞞.'OnQƌ6?pcf͒| ixX:q$@Qh!>% fTgVg: 6?xhܸgΜ3?sd ^^߸qٹGh(#Or}8޼yشC| !;{ܹM5Ks6M4?iY,`,NL9,yMنh!%ͼqoƮ)ڝ6۶ݳOour.>s=sVy|]]._ޯV(%B!G_f zbxt8 {xz@oP=sV#Ki¶l|>T!Bԣ;DQ^4KBQEQ6(%B!f(!BCDQ fB!Y(ED!,IW aE_4KBQlu}FQED!<4f>aE_4KBQ͒i֭f=555bcCM[#_OoF{u۷O:?thiAܨ`MFFL\$][WW'PٶmQhݺ%GILysd ,B!D=z7K2ӕ+|}66 J9BNeQ͒esaxÇW2< yם;\\z}:Ϟ-ya| A`צMf̙w+k` 1KT&ffB!ѝYJSl9($,=|@NL azZL\gO1_P78 ˵|{yc?U#\V2&٧rfB!ёYj1&&+6AsJe'Ξ%*WZX/ϪPjԠINWv,?~;KNᑼ\+=_l8)"e[Y$tQQP720[yXrrfϑ~&fB!ёYfꚂ(`Syyq36/8WW˗k>j,B!D=2KKKţQxvZ a[dk> j1,B!D=3K?ҚHM}Az!BT%(kDD!,QeY"Bzh(A,B!D=4KE٠h!%lP4KBQ6fB4-q#BxB!B@D!B!fY"B!3*.+wfIENDB`java-design-patterns-1.16.0/fluentinterface/etc/fluentinterface.ucls000066400000000000000000000135311312550536300256320ustar00rootroot00000000000000 java-design-patterns-1.16.0/fluentinterface/etc/fluentinterface.urm.puml000066400000000000000000000052421312550536300264430ustar00rootroot00000000000000@startuml package com.iluwatar.fluentinterface.fluentiterable.simple { class SimpleFluentIterable { - iterable : Iterable # SimpleFluentIterable(iterable : Iterable) + asList() : List + filter(predicate : Predicate) : FluentIterable + first() : Optional + first(count : int) : FluentIterable + forEach(action : Consumer) + from(iterable : Iterable) : FluentIterable {static} + fromCopyOf(iterable : Iterable) : FluentIterable {static} + getRemainingElementsCount() : int + iterator() : Iterator + last() : Optional + last(count : int) : FluentIterable + map(function : Function) : FluentIterable + spliterator() : Spliterator + toList(iterator : Iterator) : List {static} } } package com.iluwatar.fluentinterface.app { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} - negatives() : Predicate {static} - positives() : Predicate {static} - prettyPrint(delimiter : String, prefix : String, iterable : Iterable) {static} - prettyPrint(prefix : String, iterable : Iterable) {static} - transformToString() : Function {static} } } package com.iluwatar.fluentinterface.fluentiterable.lazy { abstract class DecoratingIterator { # fromIterator : Iterator - next : E + DecoratingIterator(fromIterator : Iterator) + computeNext() : E {abstract} + hasNext() : boolean + next() : E } class LazyFluentIterable { - iterable : Iterable # LazyFluentIterable() # LazyFluentIterable(iterable : Iterable) + asList() : List + filter(predicate : Predicate) : FluentIterable + first() : Optional + first(count : int) : FluentIterable + from(iterable : Iterable) : FluentIterable {static} + iterator() : Iterator + last() : Optional + last(count : int) : FluentIterable + map(function : Function) : FluentIterable } } package com.iluwatar.fluentinterface.fluentiterable { interface FluentIterable { + asList() : List {abstract} + copyToList(iterable : Iterable) : List {static} + filter(Predicate) : FluentIterable {abstract} + first() : Optional {abstract} + first(int) : FluentIterable {abstract} + last() : Optional {abstract} + last(int) : FluentIterable {abstract} + map(Function) : FluentIterable {abstract} } } LazyFluentIterable ..|> FluentIterable SimpleFluentIterable ..|> FluentIterable @endumljava-design-patterns-1.16.0/fluentinterface/pom.xml000066400000000000000000000037611312550536300223320ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 fluentinterface junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/fluentinterface/src/000077500000000000000000000000001312550536300215755ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/000077500000000000000000000000001312550536300225215ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/000077500000000000000000000000001312550536300234425ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/000077500000000000000000000000001312550536300242205ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300260505ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/000077500000000000000000000000001312550536300312265ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/000077500000000000000000000000001312550536300320065ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java000066400000000000000000000116661312550536300334030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.app; import static java.lang.String.valueOf; import java.util.ArrayList; import java.util.Arrays; import java.util.Iterator; import java.util.List; import java.util.StringJoiner; import java.util.function.Function; import java.util.function.Predicate; import com.iluwatar.fluentinterface.fluentiterable.FluentIterable; import com.iluwatar.fluentinterface.fluentiterable.lazy.LazyFluentIterable; import com.iluwatar.fluentinterface.fluentiterable.simple.SimpleFluentIterable; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * The Fluent Interface pattern is useful when you want to provide an easy readable, flowing API. * Those interfaces tend to mimic domain specific languages, so they can nearly be read as human * languages. *

* In this example two implementations of a {@link FluentIterable} interface are given. The * {@link SimpleFluentIterable} evaluates eagerly and would be too costly for real world * applications. The {@link LazyFluentIterable} is evaluated on termination. Their usage is * demonstrated with a simple number list that is filtered, transformed and collected. The result is * printed afterwards. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) { List integerList = new ArrayList<>(); integerList.addAll(Arrays.asList(1, -61, 14, -22, 18, -87, 6, 64, -82, 26, -98, 97, 45, 23, 2, -68, 45)); prettyPrint("The initial list contains: ", integerList); List firstFiveNegatives = SimpleFluentIterable.fromCopyOf(integerList).filter(negatives()).first(3).asList(); prettyPrint("The first three negative values are: ", firstFiveNegatives); List lastTwoPositives = SimpleFluentIterable.fromCopyOf(integerList).filter(positives()).last(2).asList(); prettyPrint("The last two positive values are: ", lastTwoPositives); SimpleFluentIterable .fromCopyOf(integerList) .filter(number -> number % 2 == 0) .first() .ifPresent(evenNumber -> LOGGER.info("The first even number is: {}", evenNumber)); List transformedList = SimpleFluentIterable.fromCopyOf(integerList).filter(negatives()).map(transformToString()) .asList(); prettyPrint("A string-mapped list of negative numbers contains: ", transformedList); List lastTwoOfFirstFourStringMapped = LazyFluentIterable.from(integerList).filter(positives()).first(4).last(2) .map(number -> "String[" + valueOf(number) + "]").asList(); prettyPrint( "The lazy list contains the last two of the first four positive numbers mapped to Strings: ", lastTwoOfFirstFourStringMapped); LazyFluentIterable .from(integerList) .filter(negatives()) .first(2) .last() .ifPresent(lastOfFirstTwo -> LOGGER.info("The last of the first two negatives is: {}", lastOfFirstTwo)); } private static Function transformToString() { return integer -> "String[" + valueOf(integer) + "]"; } private static Predicate negatives() { return integer -> integer < 0; } private static Predicate positives() { return integer -> integer > 0; } private static void prettyPrint(String prefix, Iterable iterable) { prettyPrint(", ", prefix, iterable); } private static void prettyPrint(String delimiter, String prefix, Iterable iterable) { StringJoiner joiner = new StringJoiner(delimiter, prefix, "."); Iterator iterator = iterable.iterator(); while (iterator.hasNext()) { joiner.add(iterator.next().toString()); } LOGGER.info(joiner.toString()); } } fluentiterable/000077500000000000000000000000001312550536300341545ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterfaceFluentIterable.java000066400000000000000000000075661312550536300377420ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import java.util.Optional; import java.util.function.Function; import java.util.function.Predicate; /** * The FluentIterable is a more convenient implementation of the common iterable interface based on * the fluent interface design pattern. This interface defines common operations, but doesn't aim to * be complete. It was inspired by Guava's com.google.common.collect.FluentIterable. * * @param is the class of objects the iterable contains */ public interface FluentIterable extends Iterable { /** * Filters the contents of Iterable using the given predicate, leaving only the ones which satisfy * the predicate. * * @param predicate the condition to test with for the filtering. If the test is negative, the * tested object is removed by the iterator. * @return a filtered FluentIterable */ FluentIterable filter(Predicate predicate); /** * Returns an Optional containing the first element of this iterable if present, else returns * Optional.empty(). * * @return the first element after the iteration is evaluated */ Optional first(); /** * Evaluates the iteration and leaves only the count first elements. * * @return the first count elements as an Iterable */ FluentIterable first(int count); /** * Evaluates the iteration and returns the last element. This is a terminating operation. * * @return the last element after the iteration is evaluated */ Optional last(); /** * Evaluates the iteration and leaves only the count last elements. * * @return the last counts elements as an Iterable */ FluentIterable last(int count); /** * Transforms this FluentIterable into a new one containing objects of the type T. * * @param function a function that transforms an instance of E into an instance of T * @param the target type of the transformation * @return a new FluentIterable of the new type */ FluentIterable map(Function function); /** * Returns the contents of this Iterable as a List. * * @return a List representation of this Iterable */ List asList(); /** * Utility method that iterates over iterable and adds the contents to a list. * * @param iterable the iterable to collect * @param the type of the objects to iterate * @return a list with all objects of the given iterator */ static List copyToList(Iterable iterable) { List copy = new ArrayList<>(); Iterator iterator = iterable.iterator(); while (iterator.hasNext()) { copy.add(iterator.next()); } return copy; } } lazy/000077500000000000000000000000001312550536300351335ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterableDecoratingIterator.java000066400000000000000000000050311312550536300415660ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable.lazy; import java.util.Iterator; /** * This class is used to realize LazyFluentIterables. It decorates a given iterator. Does not * support consecutive hasNext() calls. * @param Iterable Collection of Elements of Type E */ public abstract class DecoratingIterator implements Iterator { protected final Iterator fromIterator; private E next; /** * Creates an iterator that decorates the given iterator. */ public DecoratingIterator(Iterator fromIterator) { this.fromIterator = fromIterator; } /** * Precomputes and saves the next element of the Iterable. null is considered as end of data. * * @return true if a next element is available */ @Override public final boolean hasNext() { next = computeNext(); return next != null; } /** * Returns the next element of the Iterable. * * @return the next element of the Iterable, or null if not present. */ @Override public final E next() { if (next == null) { return fromIterator.next(); } else { final E result = next; next = null; return result; } } /** * Computes the next object of the Iterable. Can be implemented to realize custom behaviour for an * iteration process. null is considered as end of data. * * @return the next element of the Iterable. */ public abstract E computeNext(); } LazyFluentIterable.java000066400000000000000000000174041312550536300415510ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable.lazy; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import java.util.Optional; import java.util.function.Function; import java.util.function.Predicate; import com.iluwatar.fluentinterface.fluentiterable.FluentIterable; /** * This is a lazy implementation of the FluentIterable interface. It evaluates all chained * operations when a terminating operation is applied. * * @param the type of the objects the iteration is about */ public class LazyFluentIterable implements FluentIterable { private final Iterable iterable; /** * This constructor creates a new LazyFluentIterable. It wraps the given iterable. * * @param iterable the iterable this FluentIterable works on. */ protected LazyFluentIterable(Iterable iterable) { this.iterable = iterable; } /** * This constructor can be used to implement anonymous subclasses of the LazyFluentIterable. */ protected LazyFluentIterable() { iterable = this; } /** * Filters the contents of Iterable using the given predicate, leaving only the ones which satisfy * the predicate. * * @param predicate the condition to test with for the filtering. If the test is negative, the * tested object is removed by the iterator. * @return a new FluentIterable object that decorates the source iterable */ @Override public FluentIterable filter(Predicate predicate) { return new LazyFluentIterable() { @Override public Iterator iterator() { return new DecoratingIterator(iterable.iterator()) { @Override public E computeNext() { while (fromIterator.hasNext()) { E candidate = fromIterator.next(); if (predicate.test(candidate)) { return candidate; } } return null; } }; } }; } /** * Can be used to collect objects from the iteration. Is a terminating operation. * * @return an Optional containing the first object of this Iterable */ @Override public Optional first() { Iterator resultIterator = first(1).iterator(); return resultIterator.hasNext() ? Optional.of(resultIterator.next()) : Optional.empty(); } /** * Can be used to collect objects from the iteration. * * @param count defines the number of objects to return * @return the same FluentIterable with a collection decimated to a maximum of 'count' first * objects. */ @Override public FluentIterable first(int count) { return new LazyFluentIterable() { @Override public Iterator iterator() { return new DecoratingIterator(iterable.iterator()) { int currentIndex; @Override public E computeNext() { if (currentIndex < count && fromIterator.hasNext()) { E candidate = fromIterator.next(); currentIndex++; return candidate; } return null; } }; } }; } /** * Can be used to collect objects from the iteration. Is a terminating operation. * * @return an Optional containing the last object of this Iterable */ @Override public Optional last() { Iterator resultIterator = last(1).iterator(); return resultIterator.hasNext() ? Optional.of(resultIterator.next()) : Optional.empty(); } /** * Can be used to collect objects from the Iterable. Is a terminating operation. This operation is * memory intensive, because the contents of this Iterable are collected into a List, when the * next object is requested. * * @param count defines the number of objects to return * @return the same FluentIterable with a collection decimated to a maximum of 'count' last * objects */ @Override public FluentIterable last(int count) { return new LazyFluentIterable() { @Override public Iterator iterator() { return new DecoratingIterator(iterable.iterator()) { private int stopIndex; private int totalElementsCount; private List list; private int currentIndex; @Override public E computeNext() { initialize(); E candidate = null; while (currentIndex < stopIndex && fromIterator.hasNext()) { currentIndex++; fromIterator.next(); } if (currentIndex >= stopIndex && fromIterator.hasNext()) { candidate = fromIterator.next(); } return candidate; } private void initialize() { if (list == null) { list = new ArrayList<>(); Iterator newIterator = iterable.iterator(); while (newIterator.hasNext()) { list.add(newIterator.next()); } totalElementsCount = list.size(); stopIndex = totalElementsCount - count; } } }; } }; } /** * Transforms this FluentIterable into a new one containing objects of the type T. * * @param function a function that transforms an instance of E into an instance of T * @param the target type of the transformation * @return a new FluentIterable of the new type */ @Override public FluentIterable map(Function function) { return new LazyFluentIterable() { @Override public Iterator iterator() { return new DecoratingIterator(null) { Iterator oldTypeIterator = iterable.iterator(); @Override public T computeNext() { if (oldTypeIterator.hasNext()) { E candidate = oldTypeIterator.next(); return function.apply(candidate); } else { return null; } } }; } }; } /** * Collects all remaining objects of this iteration into a list. * * @return a list with all remaining objects of this iteration */ @Override public List asList() { return FluentIterable.copyToList(iterable); } @Override public Iterator iterator() { return new DecoratingIterator(iterable.iterator()) { @Override public E computeNext() { return fromIterator.hasNext() ? fromIterator.next() : null; } }; } /** * @return a FluentIterable from a given iterable. Calls the LazyFluentIterable constructor. */ public static final FluentIterable from(Iterable iterable) { return new LazyFluentIterable<>(iterable); } } simple/000077500000000000000000000000001312550536300354455ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterableSimpleFluentIterable.java000066400000000000000000000153711312550536300423760ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable.simple; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import java.util.Optional; import java.util.Spliterator; import java.util.function.Consumer; import java.util.function.Function; import java.util.function.Predicate; import com.iluwatar.fluentinterface.fluentiterable.FluentIterable; /** * This is a simple implementation of the FluentIterable interface. It evaluates all chained * operations eagerly. This implementation would be costly to be utilized in real applications. * * @param the type of the objects the iteration is about */ public class SimpleFluentIterable implements FluentIterable { private final Iterable iterable; /** * This constructor creates a copy of a given iterable's contents. * * @param iterable the iterable this interface copies to work on. */ protected SimpleFluentIterable(Iterable iterable) { this.iterable = iterable; } /** * Filters the contents of Iterable using the given predicate, leaving only the ones which satisfy * the predicate. * * @param predicate the condition to test with for the filtering. If the test is negative, the * tested object is removed by the iterator. * @return the same FluentIterable with a filtered collection */ @Override public final FluentIterable filter(Predicate predicate) { Iterator iterator = iterator(); while (iterator.hasNext()) { E nextElement = iterator.next(); if (!predicate.test(nextElement)) { iterator.remove(); } } return this; } /** * Can be used to collect objects from the Iterable. Is a terminating operation. * * @return an option of the first object of the Iterable */ @Override public final Optional first() { Iterator resultIterator = first(1).iterator(); return resultIterator.hasNext() ? Optional.of(resultIterator.next()) : Optional.empty(); } /** * Can be used to collect objects from the Iterable. Is a terminating operation. * * @param count defines the number of objects to return * @return the same FluentIterable with a collection decimated to a maximum of 'count' first * objects. */ @Override public final FluentIterable first(int count) { Iterator iterator = iterator(); int currentCount = 0; while (iterator.hasNext()) { iterator.next(); if (currentCount >= count) { iterator.remove(); } currentCount++; } return this; } /** * Can be used to collect objects from the Iterable. Is a terminating operation. * * @return an option of the last object of the Iterable */ @Override public final Optional last() { List list = last(1).asList(); if (list.isEmpty()) { return Optional.empty(); } return Optional.of(list.get(0)); } /** * Can be used to collect objects from the Iterable. Is a terminating operation. * * @param count defines the number of objects to return * @return the same FluentIterable with a collection decimated to a maximum of 'count' last * objects */ @Override public final FluentIterable last(int count) { int remainingElementsCount = getRemainingElementsCount(); Iterator iterator = iterator(); int currentIndex = 0; while (iterator.hasNext()) { iterator.next(); if (currentIndex < remainingElementsCount - count) { iterator.remove(); } currentIndex++; } return this; } /** * Transforms this FluentIterable into a new one containing objects of the type T. * * @param function a function that transforms an instance of E into an instance of T * @param the target type of the transformation * @return a new FluentIterable of the new type */ @Override public final FluentIterable map(Function function) { List temporaryList = new ArrayList<>(); Iterator iterator = iterator(); while (iterator.hasNext()) { temporaryList.add(function.apply(iterator.next())); } return from(temporaryList); } /** * Collects all remaining objects of this Iterable into a list. * * @return a list with all remaining objects of this Iterable */ @Override public List asList() { return toList(iterable.iterator()); } /** * @return a FluentIterable from a given iterable. Calls the SimpleFluentIterable constructor. */ public static final FluentIterable from(Iterable iterable) { return new SimpleFluentIterable<>(iterable); } public static final FluentIterable fromCopyOf(Iterable iterable) { List copy = FluentIterable.copyToList(iterable); return new SimpleFluentIterable<>(copy); } @Override public Iterator iterator() { return iterable.iterator(); } @Override public void forEach(Consumer action) { iterable.forEach(action); } @Override public Spliterator spliterator() { return iterable.spliterator(); } /** * @return the count of remaining objects of the current Iterable */ public final int getRemainingElementsCount() { int counter = 0; Iterator iterator = iterator(); while (iterator.hasNext()) { iterator.next(); counter++; } return counter; } /** * Collects the remaining objects of the given iterator into a List. * * @return a new List with the remaining objects. */ public static List toList(Iterator iterator) { List copy = new ArrayList<>(); while (iterator.hasNext()) { copy.add(iterator.next()); } return copy; } } java-design-patterns-1.16.0/fluentinterface/src/test/000077500000000000000000000000001312550536300225545ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/000077500000000000000000000000001312550536300234755ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/000077500000000000000000000000001312550536300242535ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300261035ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/000077500000000000000000000000001312550536300312615ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/000077500000000000000000000000001312550536300320415ustar00rootroot00000000000000AppTest.java000066400000000000000000000025061312550536300342100ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.app; import org.junit.Test; /** * Application Test Entry */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } fluentiterable/000077500000000000000000000000001312550536300342075ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterfaceFluentIterableTest.java000066400000000000000000000145311312550536300406230ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable; import org.junit.Test; import java.util.*; import java.util.function.Consumer; import static org.junit.Assert.*; import static org.mockito.Mockito.*; /** * Date: 12/12/15 - 7:00 PM * * @author Jeroen Meulemeester */ public abstract class FluentIterableTest { /** * Create a new {@link FluentIterable} from the given integers * * @param integers The integers * @return The new iterable, use for testing */ protected abstract FluentIterable createFluentIterable(final Iterable integers); @Test public void testFirst() throws Exception { final List integers = Arrays.asList(1, 2, 3, 10, 9, 8); final Optional first = createFluentIterable(integers).first(); assertNotNull(first); assertTrue(first.isPresent()); assertEquals(integers.get(0), first.get()); } @Test public void testFirstEmptyCollection() throws Exception { final List integers = Collections.emptyList(); final Optional first = createFluentIterable(integers).first(); assertNotNull(first); assertFalse(first.isPresent()); } @Test public void testFirstCount() throws Exception { final List integers = Arrays.asList(1, 2, 3, 10, 9, 8); final List first4 = createFluentIterable(integers) .first(4) .asList(); assertNotNull(first4); assertEquals(4, first4.size()); assertEquals(integers.get(0), first4.get(0)); assertEquals(integers.get(1), first4.get(1)); assertEquals(integers.get(2), first4.get(2)); assertEquals(integers.get(3), first4.get(3)); } @Test public void testFirstCountLessItems() throws Exception { final List integers = Arrays.asList(1, 2, 3); final List first4 = createFluentIterable(integers) .first(4) .asList(); assertNotNull(first4); assertEquals(3, first4.size()); assertEquals(integers.get(0), first4.get(0)); assertEquals(integers.get(1), first4.get(1)); assertEquals(integers.get(2), first4.get(2)); } @Test public void testLast() throws Exception { final List integers = Arrays.asList(1, 2, 3, 10, 9, 8); final Optional last = createFluentIterable(integers).last(); assertNotNull(last); assertTrue(last.isPresent()); assertEquals(integers.get(integers.size() - 1), last.get()); } @Test public void testLastEmptyCollection() throws Exception { final List integers = Collections.emptyList(); final Optional last = createFluentIterable(integers).last(); assertNotNull(last); assertFalse(last.isPresent()); } @Test public void testLastCount() throws Exception { final List integers = Arrays.asList(1, 2, 3, 10, 9, 8); final List last4 = createFluentIterable(integers) .last(4) .asList(); assertNotNull(last4); assertEquals(4, last4.size()); assertEquals(Integer.valueOf(3), last4.get(0)); assertEquals(Integer.valueOf(10), last4.get(1)); assertEquals(Integer.valueOf(9), last4.get(2)); assertEquals(Integer.valueOf(8), last4.get(3)); } @Test public void testLastCountLessItems() throws Exception { final List integers = Arrays.asList(1, 2, 3); final List last4 = createFluentIterable(integers) .last(4) .asList(); assertNotNull(last4); assertEquals(3, last4.size()); assertEquals(Integer.valueOf(1), last4.get(0)); assertEquals(Integer.valueOf(2), last4.get(1)); assertEquals(Integer.valueOf(3), last4.get(2)); } @Test public void testFilter() throws Exception { final List integers = Arrays.asList(1, 2, 3, 10, 9, 8); final List evenItems = createFluentIterable(integers) .filter(i -> i % 2 == 0) .asList(); assertNotNull(evenItems); assertEquals(3, evenItems.size()); assertEquals(Integer.valueOf(2), evenItems.get(0)); assertEquals(Integer.valueOf(10), evenItems.get(1)); assertEquals(Integer.valueOf(8), evenItems.get(2)); } @Test public void testMap() throws Exception { final List integers = Arrays.asList(1, 2, 3); final List longs = createFluentIterable(integers) .map(Integer::longValue) .asList(); assertNotNull(longs); assertEquals(integers.size(), longs.size()); assertEquals(Long.valueOf(1), longs.get(0)); assertEquals(Long.valueOf(2), longs.get(1)); assertEquals(Long.valueOf(3), longs.get(2)); } @Test public void testForEach() throws Exception { final List integers = Arrays.asList(1, 2, 3); final Consumer consumer = mock(Consumer.class); createFluentIterable(integers).forEach(consumer); verify(consumer, times(1)).accept(Integer.valueOf(1)); verify(consumer, times(1)).accept(Integer.valueOf(2)); verify(consumer, times(1)).accept(Integer.valueOf(3)); verifyNoMoreInteractions(consumer); } @Test public void testSpliterator() throws Exception { final List integers = Arrays.asList(1, 2, 3); final Spliterator split = createFluentIterable(integers).spliterator(); assertNotNull(split); } }lazy/000077500000000000000000000000001312550536300351665ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterableLazyFluentIterableTest.java000066400000000000000000000031371312550536300424420ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable.lazy; import com.iluwatar.fluentinterface.fluentiterable.FluentIterable; import com.iluwatar.fluentinterface.fluentiterable.FluentIterableTest; /** * Date: 12/12/15 - 7:56 PM * * @author Jeroen Meulemeester */ public class LazyFluentIterableTest extends FluentIterableTest { @Override protected FluentIterable createFluentIterable(Iterable integers) { return LazyFluentIterable.from(integers); } } simple/000077500000000000000000000000001312550536300355005ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterableSimpleFluentIterableTest.java000066400000000000000000000031531312550536300432640ustar00rootroot00000000000000java-design-patterns-1.16.0/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.fluentinterface.fluentiterable.simple; import com.iluwatar.fluentinterface.fluentiterable.FluentIterable; import com.iluwatar.fluentinterface.fluentiterable.FluentIterableTest; /** * Date: 12/12/15 - 7:56 PM * * @author Jeroen Meulemeester */ public class SimpleFluentIterableTest extends FluentIterableTest { @Override protected FluentIterable createFluentIterable(Iterable integers) { return SimpleFluentIterable.fromCopyOf(integers); } } java-design-patterns-1.16.0/flux/000077500000000000000000000000001312550536300166065ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/README.md000066400000000000000000000016721312550536300200730ustar00rootroot00000000000000--- layout: pattern title: Flux folder: flux permalink: /patterns/flux/ pumlid: 7SP14eCm20NGg-W13FlU1YFLE0GpyAazVZk-rPkRLSrDqdKwW14l8kUxx0r7hXdYzJA8eTIhKzEy6UnqyeUNJQBjjWm6n2seS_n3Ryql2UgJajxBoAu_ categories: Presentation Tier tags: - Java - Difficulty-Intermediate --- ## Intent Flux eschews MVC in favor of a unidirectional data flow. When a user interacts with a view, the view propagates an action through a central dispatcher, to the various stores that hold the application's data and business logic, which updates all of the views that are affected. ![alt text](./etc/flux.png "Flux") ## Applicability Use the Flux pattern when * you want to focus on creating explicit and understandable update paths for your application's data, which makes tracing changes during development simpler and makes bugs easier to track down and fix. ## Credits * [Flux - Application architecture for building user interfaces](http://facebook.github.io/flux/) java-design-patterns-1.16.0/flux/etc/000077500000000000000000000000001312550536300173615ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/etc/flux.png000066400000000000000000001716141312550536300210570ustar00rootroot00000000000000PNG  IHDRkSIDATxl+}{b\B?Es-rjop7يm6u&AUj3fSFhGQ:Nualf'FǸ(?6V 5ZW/g83$)3<|gC͗>3SV*EoCڨVϢ?"#:!ߙhlNrBo ZDo ZDo ZDo ZDo tζʆ=ezZ{3\4@:S[Q Z^C3A#Ama\ORZӧ*vϦ"{bm>݈F<hà@T ej\*`$(2Od9#(:QĉCb+J#AmaB33#ĈM@Z<En+yd`maB3h#lŹ퟽x0Zn:Od-ś2lEAKLԉC%zm-*WA? kn)sZVi(`s r5gHUІqΰ\=*t+Sy\*ѯr5@y:4Do ZDo ZDo ZDo ZDo ZDo ZDo ׾[_|6~!-S *Do /=_?&rsUϢ3lżb^F<hä@K'~㥏_?"~O'$:}3uD*vҲ!4@:}`/|?N5~ｸ(^Hu-'ir;k! O60&7?#u}Oէ^_^Iyoxsl bpbo(xś'xT`BOqWeF#ԉAHЦuW(EZht'zm~{}{E^ԟ_n;_x27R3V܉J3zYLxO/*脧P)~cVw, O60&y_?koŏ{ir-7Kr;E tܱ6S& )éu $5KVgso$l @yІ1}~u]yaW^_>{vפ}zzw^'+:P38r*=%ҥ(uM8o: 6 t~Cu}O?lou? o#>ŋT3@'3 tQE:5hØ@{~ޏp SsȣWM3WR3Φ( \IMSGR@'p#&Bo ci7̛>v}ƗǾ~/?%__ĻQe椳ҐA106U"KNi|Rı?"OL\ 6L tL{{yG_-SiH)3$^<$]܏]nwr3g_Lpf,QgѲ V^PtSdnw5V ۘȻ笢ROyK@yF%[4~ ngUwgNn7q)siw#I18WQ:Ҝ p_O{Ζ޽`c%msIDo: ag8#t Hˣ f,3> ?C]l|cԭ=:UϡD?amc2򬫴elsYDor:(H"5 r Pdc{G(UGc?@2xJ߽ЋUg4@yFBF踉Iw IXH"*WQk_c[/࠷FC9t(8g 8~&X&ϒҲΡ&x 9cuw/=:@e t* UF9zlp騊n+$ġ T -58r!3r={-V*Wxx&zm,С-Lt'zm蔲 Do ZDo ZDo ZDo ZDoe%mTC+q0B9̍@y̍@y̍@y'EFqRd@6*СUh@VF<h@VF<hc@ͽ[wU6@yN[F9(>mDoqۧt'zmLm[L[`Cv'XYw^- O6ژ萫hR3yVe^@yD'E)Fesf mm^@yFF4y< a^= ?Oy\Cz#9!]4S6l@p!2Ѳ)6i: 6|3j)y^rR!%+ g3jCΜʋxH(m3gRg#]t~A4@Y=~>1{~%4ϨN<+ (%zZ┑>3x1P(Qc Qj`r5Цt'zmd:woǟ#mgC'<"OjB͊.'k a;鋊gC:l: 6WO7Jw'ȉ*N:$oNb[{^#)g#Am?iɔ<-e+s ,0(QS$8'F)Ѥ O6 t[hMJ&2*WVk0)ٝ%,Cr_ipW ;[Ut'zmd:lŏ9X%E+A#Am13*'8«荡%7@sxtζ-电 O6((СFj: 6then: 6 tGG ᧙t'zm_t( ?F<hz/4Do:۶녗jlvH_QYߺ5@c:Rky{-ov+mLg*m$f@فcϼ;ܸ:tsܻF> 2t@'t'zmd:|?p{ {ȕpZ>(+gS F=VgfI{W?7yZκw햷0śM}(» &Oٰ'f"hY)GN:0 6Gͯ?;rW&gnp)힟'C]G8 . FaJ0R&gPBE6/2Spȗ@yFZ|G_|iɿrW&A*;I<Q||wÛ\d@')o|dOhQHNYo΍@yFZ ÷}7|ܸӐنDd)8{9hs'M)Iܼ#t !hMwk Ғ̽sDoҍ3[jd.F{-o!3],|5'@فcϼ;;xH,>E3]kljo#p6tʇ~|r7:ٶem"^kp<pCQ{; +2C+UFD6,`t xYtEnU)R(')o]l7A\ 6Gͯ?;rW& /yBg`7ޤ^+@GHQI 2eV#%`3Yѡ73[QxU|J?9D[M@i랰nr֫;%web,I*'5#!)HG4Լ%~jIc"``~.bpWѷ@ 67N{L213|QA(!-C95~z9){3W}^)(%xG~e.yoo< qo!3X2dNx9猞5&2CZ>]:]ۍu-:mH{[WnܐyRw~bp tB".3RuM 8r>S"Xf@)r#a+iBp+\IUOCovpJ䠤Jŧl|4dي&\*tɰą{ZmF@o@gMg#a]F<hcNAU:5t@ƬG踧ΉaMcΙwcZ O6+mF<h@VF<h@VF<h@VF<h@VF<hԁNSjxkUWo{-_kiWZ]]O,EecoF Do =i$vK qp'#{_meZVe+sku:A̴vNtPxrcz_ byA2s ts%tN&)j$MgoU  O6tʇ~|r76O7x1)/./Ab we3̊?$$[=$'y#G3([5F:!` / A3x'{cy?Cݪxzg/3 !Aam<vthak@$.s薄6KvX'u#هhFC72,ebYAXdoLq``&s]UN&! tΜ-g#@ O=盏L?QI7-s@_=2%#~VRʣt0%>:ޖ{BM4K~C\#@>yoo< qo!tb'ߝB?-Q¤ x#tzL'{c y?Ĥ-O|3s :s@6io~Ͽܑr76Яᓪd өS$\&cK&rL\]:C=+:pp'[[^9ttƹ!Yݳ J%gYW9WtdoRڢ =H:HЋr/[.7f嫾*⤋)ς4mG5r㘄2%7kDI 4&s#V:RI]WFr^cFۘU-LXGސY:^bxd7oFgPBEyO d?(5th94ȚΦݦxJ()L)Q^(%IYT(# )A iѤ 5㵌G>!Wv0:ʁT袒:< eF@:eh 9N{<6:Oa:E mmVׄH@'zxwA@:2Љ\{;örxUҢ\㭴A@:2:mAC+s7~zq؎?=0 mܤ~ӟjя~ t$:1@gUY9?"+7*Lk-z|V-OiMnreY֓O>l6/..X:1@gZ_fY3gmmTFS䅫KovҲ89??_YYh˝N D@f:C$&*99?>^@G7 qqqYVm.FFLap捄CG׵V]Y{ )DuYw]ݪe! w-y+K\BV` DX!;uGC@9н}||\ @:㳟QL ϳ~ tX~P fp VLws 7?K9ތIJa9%;)(WF6(SY H[`tuC@?ʟrppsyyYħ!@_g?='YI^B?%%[ԟ!eIbX͒퉭.jE)oXz?Xt\)^.//wvvj@62շOLfY T !H:e"@a^1BB1z9[uJ \`C@*|UFVso?F^irUC S \#t(?6F_H 9l*U:]ۍu-P:W΁WZ-FV_8&SdCGi"xOW\[5QAs^z-$~4SygW W.ws=CgX7&E7@|Eg#_jmĮUy!`␫\b1& RSTŏT_uh:2]+4|E8:( 62ٴA%ڶ Y{\f5n@:p2Lh:6t&o 9N{lt?9k#~Μ.yC@:4m@959 7:AC+s3q }a܍;jm tB!80thcq*@YIW Csh yzzt0:0*\?qrrR|VG s@wzzZՎsXWZ'E ЁO/)E^?<<*׿l9|z`ND\\\zEyI#hԃ"ЁO/)˵٭SA79Ehh ) [Y,SA79EmwwhL} ).//LvL(zŴێ"Ya^Vێ"Ybed9EO/)@_|z`N s@^S:"ŧ/>0t}9EO/)@_|z`N s@^(Ui3^IR_c3Ht| t o9VUgD)thd#(?T xLa7%,6&C`C%g@(P o”`’ t+y#3Cg0:PÛl%1gQ fQS:Dy RĎP=M|Tܱņ"Q5tN #ER :6I3qa@qth FuP/BV3Uƹl9B:?W@,$t`N%:/>0t}9EO/)@_|z`N bssҿ:2]-b\̋fnj#"6 u8??_^^Lhq`<:0GA:~@;:0GA:n@G:0_A:n@G:0_A:J9t`t* sMūV;tax)xwizJ@ofSJ P<ba (^@GV!Pf67 AFALmo0 (ESQڨ`:4PR gVeÞ2=FAJQfШ`:4PR SYJ^2Pnh3ho0 (,~ҲG>eU/{6kl`4% tO=q~a@fS4#2]s(NK"D3L8(Ab+JNAF0/ Cśr03#Ĉsyy _ꃴa2Y+M,$qƌ(@|Sר`:4Pi i;;IYwFnX^<3WP[\ML[ˆ)@S= C+5FyQ"$/-bT6*(@:ΥZ~@fS4f+mmxlV[YK8y [QΈBDΡf`GN A7ˢ!`/ܝ-%rꃴy_`09^9M\3$N,l LU:~@f^4dh5VwOɃd;t'^3e!]h Tyf:D@ thm*ڌo5ѡ(0Uj3SS)@U4FkFСQ4(0 CţhбQ`*j3S CW'kΖ%%j획 C+O~닏/<$e~gb&:Q`f67 $E͗?X [nWD*ImvFٖڨ`:4P2 7_z_?/}kKG/u9N[SwUlq CWx Հ}#w"nK z]kTQ׸תlWg)lk47 7?|~gΟO]URep]'9 'q3asǙ<<߀)C+h/ku?˿>+}Go7ԧDR#(eNw6]%0*6n[r\b3M_E%.-~ÜC+hxGo|_/a~껟]yTIGv!9 {2gx\S^ekFG]'~f IӨ`:4P2 7̛>v}ƗǾ~/?%__Ļ@^+eJ$ITBXUWv"PDNW#)0UIj6ocJI0mult:Np`6:4P ;?>{m•AJ$|:'X~x6Kk㌭ vZhNMfN)ը`:4P x TZfN;X>tNGQM;-:s PSaСiQ4"SR2zмGBGPd [>͡~y@t)hj Tf67 AFALmo0 (ESQڨ`:4P<63Q0thx :6 LEmfj~a@(tlFС╫h8۶*zcbkGh\mz C+iѠW{ T%h77 oaUqv"S׵V w]mui1/jh2-Kl^Y}68֟YYke4[* %;_v_#)~rno0 (dExyb?aq#֞Uow#:wϺ*xZ~&QU0[o&c,UOQ0thxS;wLŁ2ێu=wEO0B8bCɬSGUGf%:o9m& Cśhx &p'n%,n+!كG3W,$bQ#tf>Zi 2BgΡ~@fs6mS:&V48z7  (Sͬ63sTuB N~[߀С(0 CţhбQ`*j3S CGѠc Tf67 AFALmo0 (UVt3Q!1Ut`:4P<63Q0thx :6 LiS1 P BLmo0 (ESQڨ`:4P C1mw^};rCFf8k&PH(+{Չwvȸ]g: nӱ"dAʱűt0@O?xOnM9p:ڼ)`LǶmg Lj@ - C]4Zכ}o* _TVky]:-U#?ǯѡe |?p{ 0xQk?㌜8C9)*a#սnxg/ߜ9d]Y„޺5:veɎbO??yt&0Vnਫ/+[0:U"=0thxiEãzW+c{I4?}f =?K4+r,[]b@ɍ8z*su5 z);ˆh(ߪ"pjme0thxiE랰nr֫;%web" 9JIC{ąGbpBCԗc'.d8ZAtϗ///OOO677vN ^(lqY{ʻθaq9: ( TM3Pe QW \NW\^ZPU2#klu>@CK+ԃ{苏;1WDuoO(Np0r4r7vI\x,I tR q@'"T*S|#LlmNlY̻ qԦ멁N]kFO;WG|[~D<#SsBF__>1(e?a\:0 (^Z ÷}7|ܸӐنI6?g:z%u N$A)Й5Sy|C˲VVVe/Zn6wOOf#T^F}12I)"%cuH%U~72ez?EN8J#Ёa@Ҋio~Ͽܑr76ϐs脣H?x5<F$sCΡUܪ8*:#:1 7."ONNVb&!ڕ?,kssr אߕ"RqIi凒x cu]utVN̄5^$:0 (^F#C/~=H'Ն/RQrﰝ#?/|2<1~օOl{ʊ(_Pcbca"9P-o!.T(Ԝ=*ȓ5$l:0 (^v3N^*E)&x95,9>>~;){G///,Rh:ĸ37O"#IKpe,$P3x%U髖2y캗@Cś(Љ;EO7^T ҥkƜ u.s5WՍ ٱg;99jLttpYۉLcb gVy*LVs [`@u o:! /v vejxy\ʮZs}}}wsqqȜLotzFkrh4vtZ4r˜n-,,Ⱦrww7񻺚\\\?N\YQc3v[ϞJ tGԢ].s`ssS˞Qz*vDfSBh-윜L{!gl`t+l.s[GGG;;;Zmqqq}}~HmQ77YqH#فFt-.Xk.se鬭-..j5}7?NT!1U2;99F"UK,z+o~39G*^)߫:@ǧ&;vkStb%j :<<~b8.s0@# kkkN!:f)%$;(!,do!az!̊ސe9??ߗaqqQ3ˎ̶7@6n;>>Vc 'Z&7d....//eG.s(?C㕕|pM@l۪lSXTkU◲[\jo&˗'^[+kUVgS t|n#^KEbsiyme'y\(y2Rov[MZۥ=lF{Şp3d!bg|5F6i&϶m)tIvP,H;;;RД')jnPuzz\).s(z=QZm6Zt;|75LxoK,^I`n_}67m恎Ov7G9Ő^ByDR*^2'Lu(D]ܴ8sڭծ힥[Ni/?2k~+;O-,Ɏ]I1ࣁ!#EeY[[[Eo̹L~d\p=GGG;;;Zt ۏ:ox=|ǝ+webfG PȑDc?ɎRP[ MyS +'BfO t ;+ѷ.Ɩ"q]^^'dSG=JNWE&ڶ] d2QRZvvv >)[Z ÷}7|ܸӐQW3>%qDwJdz/5Ut7Izi?'3 FDNzn @nu~Jsqq :2wM;N\ny8V7o~Ͽܑr7:OnOtԃBO$-3!@fYjbxICgn|DSJJ|%&T Lf9?ߐ;|8˜www‚|=ި\e_C/~ʽlH!}O)Bp0U#*W' E!$)IR4MU0=a{npN|SPJc\Ѐa KN}zz9̛sb.֖̖ٗL%T¦\j6-vY:>7ٱ,=<0vhNV/ZzWVV2f4elfZ!gxլă4h2n3 t|/R0`eЀ.//$?sokkkww7c}ysrL9m"7\f=B=uNpҷh>P@ǧ&;f)iӡ]HTV+++adTf:9=K!gȐ!W\FneDס2Riʦ9hĶ-*U 1i] B |ܔRR"q"9r:99t:kkk z}ww/~"1QɎa;;;ې㞂s\e|zdGɟFASth 3zL;N\9PrZ*-n:yg2N*ksE3=~,ov[4hR#L;NL˜(,kaaAm~1[) uԝw:zNS:4'eYZ/zC ĎSeFw [[[k~ڨKg'pQ|С+faVÎS_ns:<>v# _0/dUӐ?f|ҷpQȇHH9@츗9??/zJ/Z0edu!tP^0_YYϵh;99^۶]QR7%$;iù&"Apz@kv۲WnszvwwR-7Hc۶ݫz=M^84r~~~Քj^vf:rqq(37ّ&+lkkK>| G2:@iʮZF!;iϗeY\H R@u899U+g-0 ׋a۶Ѕlp=~v9b-FpR Ё.8P ¥"O(@nC)!{@H#-kUZv+s _{m7C@/u%C9::ڪjnH R0onn&>ws$;EoE גccI#|zC\ۭ@j^z0|\[[RVrVr Kɇtyy9NMv_0>ČDr/Zn[c'eYhq'''K>Y#tʃ@Zm[|Ju+Bg.0EJzsss!7.'"eJ zswH02EVB9ǍVIeYfB>ZMvNm,,@8==oKKK[[[\g|3\XXJpDP#˾r|ｹm5ّΘԒ/Z'D!\QSfµ tʄ@Ɛ?5RWP:@1Vј0JeH9wU_0@h4||(j9& tja,@:lʇ;hR IvUj9Z<~2t5V:y15O%)`m˲_Ͱ5@SjsnSդk6zZb':]%q MN<8+[Ij[֯:eBqz̏F!%ʊT(uMZj \*zV+vlQN=lﾴ.@,08 vttSe/Pj^~bJ3?zY\Ϧpd2J\:0ԲNg}}}qqVhzrCQido]a >X2L69B9u#髽^lJ*wssSvH00|)aç}OJ#ԔJ:{z㵵v]:@(ՀNZ=f Ee]J:(!ٽK)%aj5HQl6Mvlۖ*pqzNv[[[݄Q$cPPNO/Jn MP%*:] '''R_J[XX.#(Հݫ{msKvt...~mrh*;==m4;;;$ט:ٓz=)+ K 0]mE1^~||\8$T @WFih1]ٍ...IY0#~#;Y\O/ncp6l_YY,b\eŹR ^h4ܟ[E:#(CвN4M-Y`PQwO^E"skw:7 C فZ%W_͘VTѵ$^-2<Ƕ핕Ƈ*NŅy dwl69.tQEƲ$ӋsJ^g٨k:shkkZtkJ5p~h4FF^^|gg-Q%:qaaVQG|MbOQ>ȕ;VsI/LJkn0k?Ɵ/\]<<+?٩V$ߥLmU|hn~:vrM˪-,o>>r[5V.jY<ݪDuüKƕ !66Nlv9<20p66vh۳7/1Ì41 6yn c1P ٪ $=lKmI?wZjIGґttΑ>Խ=j8R=_}Qv`0h60t)?:0kz4FCИ/j]Zv{ew% KF/Pr,QTX( I**k%f%`UՆ! ,\N&Sc:jlf7J 4froq^?oa압 FVO/Pr,QRQ e423#9:=tM ՁY3\c7X۷\pv~񽽞VK/PryCΌDh0t)?:0khVkqqqssKTj+vv<<|Ax2"(9a< g"s:'U-͵kʼn4Y>Y:[nHJBuR"TבWcc5e= FDpˋ0t@ЉGD kyO DL]<*etz +FP] !Wcd{{;u?xL[u+ks?J7E]_ a<`0u9Tc: Nq:,qn*4ѷ:ېr- Xc2Wm]\|euixLiUN7XRC1 C "H.FKTS5%jC==QnIueurXluh,+Kwv<< %"!YF&i⧶ $N)SKK]eCd1h_P6Jʸq#[ino0ID#IXTi2S=4[]rM^SV4 "uM׷47?}%B L"?"r: 谆&iYoDyӎV 4z[#kBc:p^&uPs ~&o7DnȌNʙ X r؊1:2h;[K_2H+6rgL(D`(!{XC^KKKlu)3M ՁY3g^o}Xv++- F/Pr1$kef*"ln. , 䬱h}Ky~^?os1ǿD%g (Ba̜_ZN&3$Dn O̚d`pjmjBI& ?e`2t " )a!rS0Bu`,Ɔ67[^~Ygtyt{hѶ RZ`C! P8axyC,fa46?߶r+ks׏iV0J: a9st:`y̟P5U}Jv+[KwvƒPui' 0t@G9: )TPsguizk፡٨r&*a<,0%p2,,,5t^'O޽z֋MϟkLg;b/[+yYP *7 >n|~9)uu*5q v =`yT %t\c{{y g\ޘ[?3CP('P@g }:LO:.G̉YP왕K:U$G9QٔT۷\pv~^J9'ۥ"JrJK,t P[5N-rʂ9Kt~YnB2BlD8Lx}şkv:|@ ɒ$9 | f|'~eTaHsTfj#kCG3++AuHugvKj9%%&Sks֮ٹcrx|4' $Ғj:5r|)? M8`ɷ{Vk~KEUGr:=o PNt=g YP]$gO7Ty"X mn^gol%YUz=3D C~!+Q5ʉV'QB\ٶdm\|68*YDe!&?=U`(CX+n|dK BC7xo-B柄Oܹr֋<"_ڈY~*"!G=+Òkm"φpVvRZ亨{슭c_iݿWڿuzj2K%+F+'DoWRYP]$Z'R0nEMW.61^VE6]~lwMgh%(1X\++ tT68+ /17j6eJgM,M8U`(CX+pzdK BZo~~ Gqu_?vUK"/QwZјq/JgE,#ifYq?p{qTE]ٟӭxOr=\J y\$-~Q;S{rۅ}O^kw]{.K`|%"Z-a nյ\gTW9[aa(*ҘiZmqqjT4O?&ݜ](}5h<-89K4,[7CJ_29*F"Uyw>p&M~٭'ƕtB)-g: NȜf3Si'|]j!ي Az'Ecڼ֧6v}l>6Jﮰ"ڞhÔ"軈ҜYP]%IR+!›Yg9XyE֣ous~y97(n1LgTWpQs2QW\iظ:FQ_YYYXX{{{k,~~G*'K 1-M(7DZJ:j;Qr'|}kK>){_7׎t/Lca2^.1.K.b>|'d/D ct;6J3 +<[g@_ ѓ 4nj9<<1nH |H"?g%GGJ )J+]*܃p#8jåLshbYnBWFnap)%e#5tt٫GoymkJ};OZEɪ t!'I>u˧V}MtRBNw݆a3g2E*A?TዟY:JPF#w ID8SP8@귴~?ciE =uC\j>s;bn|EiM$j$,K&|Mrgl̕wZ-H)t.Ρ:U7tfkAҲWb@-AWJFbI R<3q[J P `) D0"XvMA]t q)Pp}YamQTUj[6"](" BSMu%-MCc$fh™~p)x#:+ЭJ$o-1y)x\V'I |x@f7晒g]zլUa5[=deS:#KkB ^ZBu`քi3gBR`(fHC3Nw?w)1t^hJl̈́,+ m?[O IHÛ_S4䆎* =<> [;^𿾗As&TfMh ̈(9a{ǔ5 5$m;%}C' m"_o>eL{Ϳiq*-|c26聓<{%tSqqvdB)hQ́P510#BZADTС dl6tI ?s'wzji$OUhZNc$1t7e8V1F-{~j,T\:q<+an`YJ,:S(+.*`2_T6{6t\I!#vdC_W93yc.Յ#'XN!1=j&SKн4G QUZY/FVp>a>jE jQǪTБDCƒp QUEô !P#p*<—-BA ySKĶ\0VSwt*rl^tˈZsފrӛw_>dA'}CFf msӁ=ǡgklC9~%. $T:VLsX͠cHN!pI2M6'"Jt爪!|.(n 45\VZYA4NEc218)A): S:%M_/qwQI&2woaCr܆{w-rǝUg ͡:#ow#+UXHz$(8GTV1rƜZx,jEy u*,X+XV~%M ۻG~; ȟyH0b7k@@߄bL{$]s/ !>s막Qtٌ?BTUcaNJ'vR"G`yrZq$!E #G|m E@%1tpis =1 =. M'OX9}5F]c-WU7 {DyϏ_3U՘.;xRCxvjG,%4JqUK;0~VҫQ+-, YTaQX=%~~2sra^v>!`|t֕@PRJ (DkPmdDhL-H+O*jEI ] 2*a蔙~A9XCge_YxܽÉTnys{Rb. d?BTt0eVZѕ([y, YTKbXp yTx:ְ1 ՉLcI8)G`9iD(겖ZБ~!9\[QCdu]c+1 `h[1;ϺXUg)gCwYje^R7/C:Σ+M ՁY3"JΜ% YrPR Slvv{%۬Ef}ʚg(۳I1*>OqWĠ6tR*2QSN͝ACK-FV֟$U"7'TfMh ̈(9aHH K-`Ys2yZ=g<~&hg ~Sc3owbkGWeY;i8Aމ21b ޮ6q?aP@/-:0kBc`F@ C! 0kb ̣#W6w<\ Y3 o]A&NU1kGS.QzK_HС zG yﵬ?#^s^~l:Ud#5>3 Z~rS0Bu`քiC:`,х:MOlF>{_Y0e~9WvVHN$UᣅW4H a+ -ㅱWB7NYgG2̟P510#BZ䄡)#stI ?s'w ^dS UhmH*<#QNPb\!M5ęYs+?7˕o~tJ~y9ƓjcDauZrt8o.W">FD-eV$9_]O:b 0t">-a5) ^웞?}Pށ>÷*&>rYP5UG&wcW0 cy1e8ϣyNNPd޺$:q94<6 I'@s>9˨"(;sQKΛN0tBl x,MR:&/ȃtqYʍ-yXXCaM+ϑ O5`9{=%zPd^Ϫ#!+/nkPdN!KBбNKL )mnz}?u|E>̵.d`o+UpIUvfUG@7dcN&- Vp%MS!IfA'PjEt{7b` ԽޜkiN GJ9r:^W\щxm$|xUݑ`C32bYJЉxmyXO˜}Lǿq:ԑF鮽a~2# {rRsh,3 ^툒ša{< 05C~O 7t`VD*:w̓$UAFoB[B<&q^P߆mgwܗLĬϥ,|pC$s(|fhHcZ{;j[L5 BS8q ;;t{{ߞӹN-NZ2:!MSK*-_XOgAC 3s"5/p ˆT|#D/P| e4֊~?2|'e-T  !O%%M_/qwQI&fc^zCXpv?= v.BGw@tЬϾ>SR)gDYkNyԒp~qz ?7 .ad}qA k)%ISVI|#Il\`{%sHG @c<^mڥj$7t k?WvX\E:g^}y}ӷK$Ǎ=5@Cb8 u:$Q`w 8;o6"8t0ԇyRU<r-䦏3g=Ӭg3 3tߝb.Fǥf1z馃9$s01RƮ[>/MMCZ:sI##}A]}n\`%MP(ׄPT5_:k*>ռ\yDXVC,%!|oKv{xf| x gУoH50-!~Ď\1:!c訰;S]x%={ m{Scih,Fd {C,KD-IuK_3p4ult[!WB`wx[%1tPpّu͗䆎`X{Ck0t@0yCxӟ6#L٭ҏ۵@wqt^C@{<|V: H{ZWkw p]e=/u*}t8gө+Oc]qDqG/dij2m` auYmE\ }4-$k\1)eׄuW: Z`T kXa-kB=+g4d )@0 :}GRИzQffV)j`s!(%1ttԽ&y|)aE kF}73tή@qAvęeE^_%IRmg#S>6jٌp8)nb1s!(s~Dݫu{Ik1W"iX΍E ,TzDv;Cto~:)HGVq1#[QMNiea8|19GTOR:u0ta<:!: ս%TfMh ̈e:z]4H ̇0tRb^ai1YyC".{ ՁY3bi-ց@IŮ{d9%;/ ? C\&4f4mN[yC! 0&.4tit( t8^Z:7+l@63|cT@V`Y'A~Tg]fCZC $nnE@P"2öu!R_ a<~KKMjd1Dzvs~?RxGƊΖp݀SHruA1 Jf/1!< z kD,5'&bf;MjZuD_9)d%$ 6nxqy #WTYHT LI: :0 T7̝ A 7DE随4oT=NGcrhY )I/)Z?k9?S3x :7S'/~[4(d:ާI|㮃yRH]ru1LD7$} sY8ãtNt7scRh`[':"eO$:_[[!!3 rqplT%%6CYKb\O\d[?ƒ߿| RkpK`{j1[+Ƕlso}H%^H,f=]HoKI$N͎̐Ɲ=n<=<$xf',GAKiv_"y`wz+w졼pQڳ[0-""l[Y[1Wū}N Y, uf z_Z\\5ZS,2MzL\m$]dCFD k hCg?׆Y|I&L7gޢt>SsALHJ[뱿5|X05U(I@$ [2 N4>0;FO;Kdr˲;2ZnJ<~6hHfbpsQCm!jJ=\8+eŽ)0PSf~qP MߟXYY1vRDYݫ[Q .Q!KSyt"kamDmS;^5vLdk}:x3o.anc@)I@D'[& x옶NAa\*Nf z(~Cs}Fd~=\+0o =m#rqbW;OCf32ˋTgHY[[#&IZ#Ua'{ xBrt'x=ϟ繓;I>n:sļy7б] )% 0 `]cѓxg`Yeƫ j9u 3t̥4k0F`P:@ya:D3 W)}O11tQB sC*Ο.v+WͰ5%h4R 0eu&Ĵ+'-Js;c?ɮQ>9)I@IEb^ јfC^N}zoxwD-`Js&-W Ӯ=ԁ [ѻC(#&I5"L^"4։_e[f=kx'5CEz ^# W_U!GSI++CX˝"V4!(Tt@ +~/s!^ PzssZmq;|:E~L㕕Cz^= 'xޱZM@'iA m5=N,"[c4^n"zwt)I@TA/=st:= u2,lGdبV=h[']IbL%M&~o>j=24\zWZuˆ28K6dhjV:J]h=[,Rx: zNd)I@TI&];91gHRi=*dGdTxۘ_>3+ϱ|RI1߅$cb4놿9l`͑0tbootJߋ+$@:Znllb1t.'z}G>?yKscWōal9OWe8ڨePtmˎ5f6_-#/(1w\o dN!#]75긹-SsA{7hTĆ E[6:Jgl6HeZZLb1й|pC$Vhл~szGgö0?e8!e&P#hHo0ψn'9\`QfiFV$G@fӑ 2 PZjQ 2t^/qwQI&ά֥+[/Rڅ7t3,᭩GDb?5mXkM#h0yt0:S_(ᡆyf6H[ח'GAC 0fp5y݊j]K[ll 87z'x_Ĭ6:p{uq {˕B'-WRC9ښL, V ɵZZ-Qp 7t2aӴO{d2tz,R_[[k4ߚ\(ȉb0tzP G` nkZ9bob-/P[]Ңgox+Ej3sn@ݭvs$)FyC E *jn%@CgGh[:Xg̢|rq2ѢL%l6sl#V,h4o݊2B\h#Ij7669,1)Y?s3m`J9|:v[p +N@> ׊VZVk I 3>&1 2|reJ2L Q7G6^AzF[~(a8VNߗ31i[ڹQ:T1dz=w/`JI(gRU k6ZMή@NDKU 4_ jD"Wȣ0t2 4eI[QH)9 A M-4lll͑Bg}}=Dg/@ ~VEQЍn.C03p@,Lv0}%:a@t+ATR ,@Arex:B\DMm8  =`g4kv݊ Gb<\ZޣZm jy76:L7GAz7'0ws @Q^0OGCg8xl^5 {X96l F#R|mm — rr)ݫ~.I4L`a'bFayOMr/4hctVY-}dounƜzdi>C}8 #io.ñrDe&m`\HVLO+d'L,q.V~{p~HmHoN)hf .jZZU C1'q jp9ͳO=n|{xKGAG=S{@);2OÛz}xi@oZ}{{ :@7tK\`%"N9p{4$ IZh񁙂Flʫ4ːȶ9W-`0m3M1n9x* m(#ioeԑq/ULCd7ͥ^gCǼi4s@{>G- ʫ((`PF8װ 2thxn%$6t|oxC}t. <2oFQGƽ @UhF.j@ F# N*V'*Cˁ1OvvR\\USJCǕ:<@!˱KfhqE\PiR(2bU.Bǵҏn"<;dWPƨa.CP^?*$P )"r#*|^G]*tϹ TĬܦѻusså8ozTNØXg8$V0t cagc(uZH2{#C7޽Gے3j)# o>sPdj7D\jf'-ڀ4v몓uK7r)7R#c9deeEWb1 J#CR) j@Ȩ7z9  p$j@SUX݃cgYpw`{5 /c4U6&obv}d<2RƁi0C8Ri,--=B8hU:wvvt$Ukv|>}K^9yȥJM"}p6{+\Msj5=Y&`H > o2aNYj)@9vM+G@z7MǤ,XŪc0в\ȴuoooqqqccgRH57c Ɔ6dQ1~&`ȋpHx:<`:+ȩJjnŇ4:J9Z318k)YN&v83 B*P+0h҅]S* t8C ]h@΀̉J\̷ˍe=ib B h^Ѣ/%d2C{n!HxB:e9ewzJ-@D~o777x<&*aG@Ӊ  ggC87IlQ= ΓV@|TazVvS P$!V :@n .%,yo Ύy)>2 16̉Vist: \=Z-ѭQ 07lt$YXX9)`4UU9WɇK[P tlѷb|L'ߊhPX Zkc@9ض.M cFnCqr/d9iius`y@9: TZ6x];N($Sl6HuAjd 0!c|%iY 7'EoCL9: OGݐv2L'ߊkPVIFYh[Pĕ4^> pshmoo"0[%/a( OVxQ rVPTT,q5d+ܜ,@zRF6(#0tT$ş-cv(I `ņm@%%;;;f3ST/ܜ`e~&yqq1[̬oww0t)mFk" 9l+GHhDJ\S7'S cFT666Q Wf.^Mk9`f$]@?VPZ`0%.jdps=N*뤳> 6. C@mx{Evjee.[񂛓'HH!2Nkdmoy[vW&`Siu7f1O s4/..d,4SMFvn -:l+ ) (vi 7M}#!6:ePNv] 4 OOIZ>,0+FVkqqVl£$%r_rQ96 Z* ve]H O:<0r-EmYEV( 2b{{{mm||Yg]}?xV#V:j#cCѣG4ep8¶u68TivFcww׬ `.JtG<@0tG^ $ ' fY`@ uХ*͊Kz+HgDf8<<|_>?dSN2VZUc @#iuinx,v-i|1s[nݶ. %Z\N<ܢӰg8酯mmu\55q%.3$65%Ȇ:|]eb)Gk2hCMZH}qqLjRC-C.1|,ag\9箞gSICPgӮ԰cP=;{G.K'ͬϮX͠l's[ ܣc?.^6CÕX9 L[gii)lA~DurE(q]Fxo;h4Fцznl6>fVl\L$ʚ1i9Vxk^yגp~J! so O6J卬\U\b@̌3t766`@yOuk_*,Of]CZd2AnVfbICYCǶrȿ+áN:]*J\f].--. ޠQ0Gy?r2H :+a .Uif]F#۵! e &hC$ ҆mt]X90mzNEtJSB*3a1'ChfZ9Dts{{{fiCs`<w퉖B4.!2H Oy2TNد+ކ@84Mu`|L:@ i( :(ztJ:?k?g?}S_o&g2L=$8k;:*!$i )&I7 _hŷ|֋?z#͑NյO{Fg3`ĔaޠWf jo~ͫ*p[*e ki *wNоsz!S6|KoPYQ|]v5b@H?+W4}S~3cNk:qtJ/53+- OuK{[ͥƉ쉰9AR:hډsC :f4`d\P5o5L51vQfBR*ܾݰ{gۄ_ܟoS{X[ Ͳ,o+2Wa1 $ixw~mEh:9};WNz1U9FWmtۖAcuΨ:B- BCg0j5~r#-Wp\g5TVqmU̢W;>TX]AR'~>'7~)<6~O< C߫sgn3M%]yDbv:E@4s?7zowWwՒ5mym>6t~kx\X\l^qÒzS/yH5CT [5R_.5f+k$D$5Nk̕(] !BJ4w>rEBswz/?_qVTft_Y+U|L^Ă4>g~tV[> ?dzKc6!_ mY\9{CJdT]1西4yWVk6u SS:EQKWCXAqXD2eR*O.G/=Fܝ#4t>rɣtؔ!)2VJ4_']@ҡ,R|m$f;{.1;l[6tL ӵ 1:OPCT`\,y_au#WǩPH݊nXu4Tg,wc_JePup_HfX ǼJURС_lLpnR%64yoCz `L[noRFV8M1 )wc_e"T߿SG{ȔZOo\<9 ʸ7}UfUt:@,JSg?swɷKܽ~Ԡ#3_h ܖN /qлҾ]|+~rގx:̥`!&I۝ҥ,zC' LXWhw5tG/y|wO~ W||_dSjj"E)t(!0iz:/vw֋O d9yituboߟθ$ ~IOY酽":t{@z@Ʌm}V^W*p@Ƙҥ,zz+ 3c_BeP Oإ|773ݽYS@wm&r0t4[}گt ¹2\7?p{[jk<[B|@:!sgե)z=9̋zWRw*T7tݰ. O)[a1P gؘZ9ߴC\[=E`]:p>r柜u1Wzw L:@ i(< m߻Py͌xFcwwSl9 C0t@Pxv +!!qiiɞ.Uie  4gv'I*P AT C0t@PxΓF#r+i,--Q~ ]҄@:@ i(<Y[[ m}X94IJm$ [٭#3GzUsj753 g}S)v:'f+-ZsƘS`lޝV<|?]^ǿl3eMò,E!ʁ1Yt"dBp9k%rn-7Kl.m3ZHV՘P})"H;[VIvq\s[Imuβd$\gRd쾱~1630@>Vm.2wf״R1 I%\[֫fY Bmcft^68:E@H?i`$dvLwT_Lq2n1 M{hzЭ}V]23 f[JkHK-\-K\Kj4m=WVF7>Vc  21t<&^ fl׬ÿCf Yv鸵:u{l6áh BJ&_ky Bm][΢sј< CT{waWcuGMȷ^p^ J(E+ eV{6%5tYC8>`zC7a1A)ޞ7f똝ݞb@4a2H O:]҄@:@ i(<3y:R' Pb`a Ph8$|/@PuʬHc 7+3mE@ ,:+3^ P$KUˬ!P})IC)O PlBidWf%f$ gv@]ҔL:@  c童kx|pKy2TbJSB*3a17t^vʍKHʓWtxv@ T  W#>9Y&C(6]*^<ݥOH`e7"dFiL98Ѩj)?mշ:Dׂ59YE(O Pl#AѫSfb}>)ᆎZjށ=ۑ bGåB6$6)H(Q6]Ju%j^Gl\+QR|uוdЍ$>V ~ )3ٝ92;{ձwx,4NM-RߔDaCk;AgȆ5(}'~|~}f}TVoM{Yx;&D>4pҫěZ[PZ9m0AFNXk^2 w3dC.D@psS؁3(k GDE~ɻoD=ITMf(QLR"]mHRUF5Z uO:(2ӥ̓go ?8ʝ]I>|a,@ԉeOho5-|WWu]" t㧮NXQxVjra%(4\t^C)% BYtAG{gDZS+[ȘBIY,V>3g%/NzrU A tann&āx񄃕(LĔ6jMY>S -O%vLIU*#v%{]{RCA+Uf+]Ew]AZ%RtEF+*Jhl:PO+9e*Qd82k/,}}휂' Y8j6MQTVާi.T |tp.t\\UrtS 'K!@ Aówccg6iDЩg9N!pҫsQ"+rrYsik]UwNw͇x8 4 gV-H9꿦$-~t =*_R|DMt}zJI8XD-etrlA`4j}+w WR1[\YxBl'̖^UwHx;%q ^:^{P ͬEmItb;?ei| )R27KuJTf|ZBkfp-îoh% :;ʎB}\yTc{W:+ t++6ʃ0.vҫ-ͽ(P()F.v2Gp™kS-!蜺q['vKqn!,3Yf+\*Ij fOђcZK4[Ol^Zoat`1t>Xw"Ti-:QRj[7Z澅p:.]γsΝ|j863Ųy%kUҳW[f'53h&ǷH+#52AtDaӚX-q԰I:WIsuƺ.tl:P3גSnn ;~}etEXORrԭ( x>|KeWiVnI5Ҿ))K{|nK}Z>Qw"TY(Ue*l&zis2Y7ZM٨x"{⑌)UlG5ꎻD!@ V^]=w wHx;%q ^Zfx}2IӊdKJ)/Ly5Qg7 c@5hMIcZZX_Q-gJ32V?FƂ8]joFV*Pw"#,6V 8!tK-IzVl@j=#b*1@̵LΩu_lG'鏚orQ+QK3a`!Au'B]/մZf=ԡkO'ĊY|s]-O5<;>wΧ6;/^J3kYm;S׳]n_U=*u 7GC o݉P¦I5ezH[fo.MJW]&ҽ/ySן+^JsYg^n,cibNV孳cf:P;*@R{mqtsvn/$]>&N*+O+ЩԿUԛMl ޺ .wHNxom{8/6u[%Tܸlq~V&aW74g֝ lpKDz ɶ[hxs+~a nRǶ=0qu׺ N;G)]8yi,a:PSGϼ^zZw"Tp̴^M"&~tA'xKtV֝ lz;ӭ;_؏& Aj0GU\o%]"j9qe)ֶNH4:jygVOeo$;޵T2{9wW-ނfAw8Yw%iȆ50oUv2ߡ X:5xS"V`"EX !*>hC51*@' :Ʒd3NJn'%$Wq>NJ8Vjr7sV4uA_(֌NL@Ak(e/ztz @糷wFuƙEtVS*5K>} 㺂N5 cC Nr!AǞY2e Ğdjtp6oY?}:&^y%ۖAl"%r :ʎr4eAA1mD0/_{n†  >lDK.!lB.׆a~gF ^†  Evޓ,K5e=ݱ؈PamϷDdS*̫&;K6Bh\*j]B0D8#AN w ao|K6H[I2z2d{S(2h<5+8^UgZt_;G:p$B ^†  o9+HƱg2hWWꏪgҌrLǙgQ[q4OAgv_W+>B  Nr!AGOQ+|);:q֏r#l] qg F v"7{ lw :n]ZXБ.ė] ڥ A]AGt]B0d5t)T*LK!Cgճ `4 ?̵ڲlxUCcq>) @ZѓSᣴNbcthɕ<ñ? RJ8l"ARNt/.!lؖ;5wzqQo* "sԂ)K%z|B0"TvXlQd#T~QњtcͻoKMI],7@ oZK2`Dq_L.nc)7(RTq(Q*ʄQ{t{IGvx9^㻨r#Ɇ]'\3†  t䇜9D#Bh'?MQT܋H*('ܸ\^e)-cU9+;_†  tq oDt?}Uit|G2vViUcS}A=l%@#0d ΐ<.{;w;8g6REnh]7YZFzMqWFI$.WկҵD(jL *)vZvb+OaDKݛlIq eK7@}b#BhP\ĵ<&jI &]B0$s*@;R,Wu =gw :wƁ}˿VxatiK7@T>~ۉ߼&VxatzmK7@tKW{aUtzmK7@,$褛jK'&6i&- jKJmňPA׆a~B%Wv㱺9Ef\FiF)Md'wJHl0(tzmK7@,(r,Lս0"cڐ,Ҩ#lO5p"mk;w姗ӗjHpMx믾V2Gϔ G,%nK*"LJΦ"|&]q8sGE{q q=ܔn}8:$}򵓍XBNɣR-՚jHp#}JZl=Sxn7W7tXHL1egMDZS+b撐Ye$ފ!t+"Tv]k^:&.K[{i[K`~?_}噟w O<{` OE:J~#8J[;"ףǥ~㩣W'|·āxiS58rz*Y٣芻h 7@xk?xi ݲ,R4$m5EHS1"x&T(A`@\u_lG'.52ـ@bz+մDW%@c0#gvscW6E?eSt\2AGʒckV}dۥyv|ֹOmv^'˝caؖ^j2GDW%@S0}?O74']l"N)Sgs}tw;jkYi0D\.Lʈ 2JwًTQRlvGjAL%yv|ֹOmv^'.Mb\g8SeE&%Xmi#Yv&t}cWOtl_Rt :ʑd]&;ra̻ :Kɪ0!ssvnusMqp1q)X3tܙBKF[vFjALij('~[[=#K\d_C'^XJ)[uL2k2Uk7:`B8 m˟Bm85U.W͊GZE)Q佥ֳz4ǺU;#! A :ݶBٛ,cI6GAC83AG.7GOgV#! A陠-XcvI:{s\#! A靠5C8 :! A`#OYAg :zIENDB`java-design-patterns-1.16.0/flux/etc/flux.ucls000066400000000000000000000321721312550536300212340ustar00rootroot00000000000000 java-design-patterns-1.16.0/flux/etc/flux.urm.puml000066400000000000000000000053741312550536300220510ustar00rootroot00000000000000@startuml package com.iluwatar.flux.view { class ContentView { - LOGGER : Logger {static} - content : Content + ContentView() + render() + storeChanged(store : Store) } class MenuView { - LOGGER : Logger {static} - selected : MenuItem + MenuView() + itemClicked(item : MenuItem) + render() + storeChanged(store : Store) } interface View { + render() {abstract} + storeChanged(Store) {abstract} } } package com.iluwatar.flux.action { abstract class Action { - type : ActionType + Action(type : ActionType) + getType() : ActionType } enum ActionType { + CONTENT_CHANGED {static} + MENU_ITEM_SELECTED {static} + valueOf(name : String) : ActionType {static} + values() : ActionType[] {static} } enum Content { + COMPANY {static} + PRODUCTS {static} - title : String + toString() : String + valueOf(name : String) : Content {static} + values() : Content[] {static} } class ContentAction { - content : Content + ContentAction(content : Content) + getContent() : Content } class MenuAction { - menuItem : MenuItem + MenuAction(menuItem : MenuItem) + getMenuItem() : MenuItem } enum MenuItem { + COMPANY {static} + HOME {static} + PRODUCTS {static} - title : String + toString() : String + valueOf(name : String) : MenuItem {static} + values() : MenuItem[] {static} } } package com.iluwatar.flux.app { class App { + App() + main(args : String[]) {static} } } package com.iluwatar.flux.store { class ContentStore { - content : Content + ContentStore() + getContent() : Content + onAction(action : Action) } class MenuStore { - selected : MenuItem + MenuStore() + getSelected() : MenuItem + onAction(action : Action) } abstract class Store { - views : List + Store() # notifyChange() + onAction(Action) {abstract} + registerView(view : View) } } package com.iluwatar.flux.dispatcher { class Dispatcher { - instance : Dispatcher {static} - stores : List - Dispatcher() - dispatchAction(action : Action) + getInstance() : Dispatcher {static} + menuItemSelected(menuItem : MenuItem) + registerStore(store : Store) } } MenuAction --> "-menuItem" MenuItem Action --> "-type" ActionType Dispatcher --> "-instance" Dispatcher MenuStore --> "-selected" MenuItem ContentView --> "-content" Content Dispatcher --> "-stores" Store MenuView --> "-selected" MenuItem Store --> "-views" View ContentAction --> "-content" Content ContentStore --> "-content" Content ContentAction --|> Action MenuAction --|> Action ContentStore --|> Store MenuStore --|> Store ContentView ..|> View MenuView ..|> View @endumljava-design-patterns-1.16.0/flux/pom.xml000066400000000000000000000035731312550536300201330ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 flux junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/flux/src/000077500000000000000000000000001312550536300173755ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/000077500000000000000000000000001312550536300203215ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/000077500000000000000000000000001312550536300212425ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/000077500000000000000000000000001312550536300220205ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300236505ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/000077500000000000000000000000001312550536300246265ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/000077500000000000000000000000001312550536300261035ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/Action.java000066400000000000000000000026531312550536300301710ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; /** * * Action is the data payload dispatched to the stores when something happens. * */ public abstract class Action { private ActionType type; public Action(ActionType type) { this.type = type; } public ActionType getType() { return type; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/ActionType.java000066400000000000000000000024041312550536300310250ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; /** * * Types of actions. * */ public enum ActionType { MENU_ITEM_SELECTED, CONTENT_CHANGED; } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/Content.java000066400000000000000000000027771312550536300303750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; /** * * Content items. * */ public enum Content { PRODUCTS("Products - This page lists the company's products."), COMPANY( "Company - This page displays information about the company."); private String title; private Content(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java000066400000000000000000000027071312550536300315240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; /** * * ContentAction is a concrete action. * */ public class ContentAction extends Action { private Content content; public ContentAction(Content content) { super(ActionType.CONTENT_CHANGED); this.content = content; } public Content getContent() { return content; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java000066400000000000000000000027131312550536300310130ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; /** * * MenuAction is a concrete action. * */ public class MenuAction extends Action { private MenuItem menuItem; public MenuAction(MenuItem menuItem) { super(ActionType.MENU_ITEM_SELECTED); this.menuItem = menuItem; } public MenuItem getMenuItem() { return menuItem; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java000066400000000000000000000026371312550536300305010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; /** * * Menu items. * */ public enum MenuItem { HOME("Home"), PRODUCTS("Products"), COMPANY("Company"); private String title; MenuItem(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/app/000077500000000000000000000000001312550536300254065ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/app/App.java000066400000000000000000000060101312550536300267660ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.app; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.dispatcher.Dispatcher; import com.iluwatar.flux.store.ContentStore; import com.iluwatar.flux.store.MenuStore; import com.iluwatar.flux.view.ContentView; import com.iluwatar.flux.view.MenuView; /** * * Flux is the application architecture that Facebook uses for building client-side web * applications. Flux eschews MVC in favor of a unidirectional data flow. When a user interacts with * a React view, the view propagates an action through a central dispatcher, to the various stores * that hold the application's data and business logic, which updates all of the views that are * affected. *

* This example has two views: menu and content. They represent typical main menu and content area * of a web page. When menu item is clicked it triggers events through the dispatcher. The events * are received and handled by the stores updating their data as needed. The stores then notify the * views that they should rerender themselves. *

* http://facebook.github.io/flux/docs/overview.html * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // initialize and wire the system MenuStore menuStore = new MenuStore(); Dispatcher.getInstance().registerStore(menuStore); ContentStore contentStore = new ContentStore(); Dispatcher.getInstance().registerStore(contentStore); MenuView menuView = new MenuView(); menuStore.registerView(menuView); ContentView contentView = new ContentView(); contentStore.registerView(contentView); // render initial view menuView.render(); contentView.render(); // user clicks another menu item // this triggers action dispatching and eventually causes views to render with new content menuView.itemClicked(MenuItem.COMPANY); } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/dispatcher/000077500000000000000000000000001312550536300267545ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java000066400000000000000000000045151312550536300317120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.dispatcher; import java.util.LinkedList; import java.util.List; import com.iluwatar.flux.action.Action; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.action.ContentAction; import com.iluwatar.flux.action.MenuAction; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.store.Store; /** * * Dispatcher sends Actions to registered Stores. * */ public final class Dispatcher { private static Dispatcher instance = new Dispatcher(); private List stores = new LinkedList<>(); private Dispatcher() {} public static Dispatcher getInstance() { return instance; } public void registerStore(Store store) { stores.add(store); } /** * Menu item selected handler */ public void menuItemSelected(MenuItem menuItem) { dispatchAction(new MenuAction(menuItem)); switch (menuItem) { case HOME: case PRODUCTS: default: dispatchAction(new ContentAction(Content.PRODUCTS)); break; case COMPANY: dispatchAction(new ContentAction(Content.COMPANY)); break; } } private void dispatchAction(Action action) { stores.stream().forEach(store -> store.onAction(action)); } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/store/000077500000000000000000000000001312550536300257625ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java000066400000000000000000000034141312550536300312560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.store; import com.iluwatar.flux.action.Action; import com.iluwatar.flux.action.ActionType; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.action.ContentAction; /** * * ContentStore is a concrete store. * */ public class ContentStore extends Store { private Content content = Content.PRODUCTS; @Override public void onAction(Action action) { if (action.getType().equals(ActionType.CONTENT_CHANGED)) { ContentAction contentAction = (ContentAction) action; content = contentAction.getContent(); notifyChange(); } } public Content getContent() { return content; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java000066400000000000000000000033771312550536300305600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.store; import com.iluwatar.flux.action.Action; import com.iluwatar.flux.action.ActionType; import com.iluwatar.flux.action.MenuAction; import com.iluwatar.flux.action.MenuItem; /** * * MenuStore is a concrete store. * */ public class MenuStore extends Store { private MenuItem selected = MenuItem.HOME; @Override public void onAction(Action action) { if (action.getType().equals(ActionType.MENU_ITEM_SELECTED)) { MenuAction menuAction = (MenuAction) action; selected = menuAction.getMenuItem(); notifyChange(); } } public MenuItem getSelected() { return selected; } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/store/Store.java000066400000000000000000000031571312550536300277270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.store; import java.util.LinkedList; import java.util.List; import com.iluwatar.flux.action.Action; import com.iluwatar.flux.view.View; /** * * Store is a data model. * */ public abstract class Store { private List views = new LinkedList<>(); public abstract void onAction(Action action); public void registerView(View view) { views.add(view); } protected void notifyChange() { views.stream().forEach(view -> view.storeChanged(this)); } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/view/000077500000000000000000000000001312550536300256005ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/view/ContentView.java000066400000000000000000000034511312550536300307130ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.view; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.store.ContentStore; import com.iluwatar.flux.store.Store; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * ContentView is a concrete view. * */ public class ContentView implements View { private static final Logger LOGGER = LoggerFactory.getLogger(ContentView.class); private Content content = Content.PRODUCTS; @Override public void storeChanged(Store store) { ContentStore contentStore = (ContentStore) store; content = contentStore.getContent(); render(); } @Override public void render() { LOGGER.info(content.toString()); } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/view/MenuView.java000066400000000000000000000040721312550536300302050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.view; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.dispatcher.Dispatcher; import com.iluwatar.flux.store.MenuStore; import com.iluwatar.flux.store.Store; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * MenuView is a concrete view. * */ public class MenuView implements View { private static final Logger LOGGER = LoggerFactory.getLogger(MenuView.class); private MenuItem selected = MenuItem.HOME; @Override public void storeChanged(Store store) { MenuStore menuStore = (MenuStore) store; selected = menuStore.getSelected(); render(); } @Override public void render() { for (MenuItem item : MenuItem.values()) { if (selected.equals(item)) { LOGGER.info("* {}", item); } else { LOGGER.info(item.toString()); } } } public void itemClicked(MenuItem item) { Dispatcher.getInstance().menuItemSelected(item); } } java-design-patterns-1.16.0/flux/src/main/java/com/iluwatar/flux/view/View.java000066400000000000000000000025131312550536300273560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.view; import com.iluwatar.flux.store.Store; /** * * Views define the representation of data. * */ public interface View { void storeChanged(Store store); void render(); } java-design-patterns-1.16.0/flux/src/test/000077500000000000000000000000001312550536300203545ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/000077500000000000000000000000001312550536300212755ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/000077500000000000000000000000001312550536300220535ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300237035ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/000077500000000000000000000000001312550536300246615ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/action/000077500000000000000000000000001312550536300261365ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java000066400000000000000000000031531312550536300312550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; /** * Date: 12/12/15 - 10:11 PM * * @author Jeroen Meulemeester */ public class ContentTest { @Test public void testToString() throws Exception { for (final Content content : Content.values()) { final String toString = content.toString(); assertNotNull(toString); assertFalse(toString.trim().isEmpty()); } } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java000066400000000000000000000031601312550536300313640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.action; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; /** * Date: 12/12/15 - 10:15 PM * * @author Jeroen Meulemeester */ public class MenuItemTest { @Test public void testToString() throws Exception { for (final MenuItem menuItem : MenuItem.values()) { final String toString = menuItem.toString(); assertNotNull(toString); assertFalse(toString.trim().isEmpty()); } } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/app/000077500000000000000000000000001312550536300254415ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/app/AppTest.java000066400000000000000000000024751312550536300276740ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.app; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/dispatcher/000077500000000000000000000000001312550536300270075ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java000066400000000000000000000106351312550536300326050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.dispatcher; import com.iluwatar.flux.action.Action; import com.iluwatar.flux.action.ActionType; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.action.ContentAction; import com.iluwatar.flux.action.MenuAction; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.store.Store; import org.junit.Before; import org.junit.Test; import org.mockito.ArgumentCaptor; import java.lang.reflect.Constructor; import java.lang.reflect.Field; import java.util.List; import java.util.stream.Collectors; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertSame; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/12/15 - 8:22 PM * * @author Jeroen Meulemeester */ public class DispatcherTest { /** * Dispatcher is a singleton with no way to reset it's internal state back to the beginning. * Replace the instance with a fresh one before each test to make sure test cases have no * influence on each other. */ @Before public void setUp() throws Exception { final Constructor constructor; constructor = Dispatcher.class.getDeclaredConstructor(); constructor.setAccessible(true); final Field field = Dispatcher.class.getDeclaredField("instance"); field.setAccessible(true); field.set(Dispatcher.getInstance(), constructor.newInstance()); } @Test public void testGetInstance() throws Exception { assertNotNull(Dispatcher.getInstance()); assertSame(Dispatcher.getInstance(), Dispatcher.getInstance()); } @Test public void testMenuItemSelected() throws Exception { final Dispatcher dispatcher = Dispatcher.getInstance(); final Store store = mock(Store.class); dispatcher.registerStore(store); dispatcher.menuItemSelected(MenuItem.HOME); dispatcher.menuItemSelected(MenuItem.COMPANY); // We expect 4 events, 2 menu selections and 2 content change actions final ArgumentCaptor actionCaptor = ArgumentCaptor.forClass(Action.class); verify(store, times(4)).onAction(actionCaptor.capture()); verifyNoMoreInteractions(store); final List actions = actionCaptor.getAllValues(); final List menuActions = actions.stream() .filter(a -> a.getType().equals(ActionType.MENU_ITEM_SELECTED)) .map(a -> (MenuAction) a) .collect(Collectors.toList()); final List contentActions = actions.stream() .filter(a -> a.getType().equals(ActionType.CONTENT_CHANGED)) .map(a -> (ContentAction) a) .collect(Collectors.toList()); assertEquals(2, menuActions.size()); assertEquals(1, menuActions.stream().map(MenuAction::getMenuItem).filter(MenuItem.HOME::equals).count()); assertEquals(1, menuActions.stream().map(MenuAction::getMenuItem).filter(MenuItem.COMPANY::equals).count()); assertEquals(2, contentActions.size()); assertEquals(1, contentActions.stream().map(ContentAction::getContent).filter(Content.PRODUCTS::equals).count()); assertEquals(1, contentActions.stream().map(ContentAction::getContent).filter(Content.COMPANY::equals).count()); } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/store/000077500000000000000000000000001312550536300260155ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java000066400000000000000000000047021312550536300321520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.store; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.action.ContentAction; import com.iluwatar.flux.action.MenuAction; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.view.View; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyZeroInteractions; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/12/15 - 10:18 PM * * @author Jeroen Meulemeester */ public class ContentStoreTest { @Test public void testOnAction() throws Exception { final ContentStore contentStore = new ContentStore(); final View view = mock(View.class); contentStore.registerView(view); verifyZeroInteractions(view); // Content should not react on menu action ... contentStore.onAction(new MenuAction(MenuItem.PRODUCTS)); verifyZeroInteractions(view); // ... but it should react on a content action contentStore.onAction(new ContentAction(Content.COMPANY)); verify(view, times(1)).storeChanged(eq(contentStore)); verifyNoMoreInteractions(view); assertEquals(Content.COMPANY, contentStore.getContent()); } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java000066400000000000000000000046471312550536300314540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.store; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.action.ContentAction; import com.iluwatar.flux.action.MenuAction; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.view.View; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyZeroInteractions; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/12/15 - 10:18 PM * * @author Jeroen Meulemeester */ public class MenuStoreTest { @Test public void testOnAction() throws Exception { final MenuStore menuStore = new MenuStore(); final View view = mock(View.class); menuStore.registerView(view); verifyZeroInteractions(view); // Menu should not react on content action ... menuStore.onAction(new ContentAction(Content.COMPANY)); verifyZeroInteractions(view); // ... but it should react on a menu action menuStore.onAction(new MenuAction(MenuItem.PRODUCTS)); verify(view, times(1)).storeChanged(eq(menuStore)); verifyNoMoreInteractions(view); assertEquals(MenuItem.PRODUCTS, menuStore.getSelected()); } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/view/000077500000000000000000000000001312550536300256335ustar00rootroot00000000000000java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java000066400000000000000000000036451312550536300316130ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.view; import com.iluwatar.flux.action.Content; import com.iluwatar.flux.store.ContentStore; import org.junit.Test; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.when; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/12/15 - 10:31 PM * * @author Jeroen Meulemeester */ public class ContentViewTest { @Test public void testStoreChanged() throws Exception { final ContentStore store = mock(ContentStore.class); when(store.getContent()).thenReturn(Content.PRODUCTS); final ContentView view = new ContentView(); view.storeChanged(store); verify(store, times(1)).getContent(); verifyNoMoreInteractions(store); } } java-design-patterns-1.16.0/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java000066400000000000000000000046601312550536300311030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flux.view; import com.iluwatar.flux.action.Action; import com.iluwatar.flux.action.MenuItem; import com.iluwatar.flux.dispatcher.Dispatcher; import com.iluwatar.flux.store.MenuStore; import com.iluwatar.flux.store.Store; import org.junit.Test; import static org.mockito.Matchers.any; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.when; /** * Date: 12/12/15 - 10:31 PM * * @author Jeroen Meulemeester */ public class MenuViewTest { @Test public void testStoreChanged() throws Exception { final MenuStore store = mock(MenuStore.class); when(store.getSelected()).thenReturn(MenuItem.HOME); final MenuView view = new MenuView(); view.storeChanged(store); verify(store, times(1)).getSelected(); verifyNoMoreInteractions(store); } @Test public void testItemClicked() throws Exception { final Store store = mock(Store.class); Dispatcher.getInstance().registerStore(store); final MenuView view = new MenuView(); view.itemClicked(MenuItem.PRODUCTS); // We should receive a menu click action and a content changed action verify(store, times(2)).onAction(any(Action.class)); } } java-design-patterns-1.16.0/flyweight/000077500000000000000000000000001312550536300176325ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/README.md000066400000000000000000000025751312550536300211220ustar00rootroot00000000000000--- layout: pattern title: Flyweight folder: flyweight permalink: /patterns/flyweight/ pumlid: HSV94S8m3030Lg20M7-w4OvYAoCh7Xtnq3ty-Eq-MQlaJcdow17JNm26gpIEdkzqidffa4Qfrm2MN1XeSEADsqxEJRU94MJgCD1_W4C-YxZr08hwNqaRPUQGBm00 categories: Structural tags: - Java - Gang Of Four - Difficulty-Intermediate - Performance --- ## Intent Use sharing to support large numbers of fine-grained objects efficiently. ![alt text](./etc/flyweight_1.png "Flyweight") ## Applicability The Flyweight pattern's effectiveness depends heavily on how and where it's used. Apply the Flyweight pattern when all of the following are true * an application uses a large number of objects * storage costs are high because of the sheer quantity of objects * most object state can be made extrinsic * many groups of objects may be replaced by relatively few shared objects once extrinsic state is removed * the application doesn't depend on object identity. Since flyweight objects may be shared, identity tests will return true for conceptually distinct objects. ## Real world examples * [java.lang.Integer#valueOf(int)](http://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html#valueOf%28int%29) and similarly for Byte, Character and other wrapped types. ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/flyweight/etc/000077500000000000000000000000001312550536300204055ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/etc/flyweight.png000066400000000000000000000762341312550536300231310ustar00rootroot00000000000000PNG  IHDR8c'\|cIDATx+Wu"FQ'dp|I@_2MCl ~!G\c&62&\]@qd8`dz0tz#<^CJ2U3[{wKZuJk_vf&uDEbeܠ8*Xק> m @ EzcMh@0`b&0 11< 34.5>קzX 1 " lwCZSkp}j 0!<` v74.5>קzX 1 " lwCZSkp}j 0!<`dYT2?fǿT4.A8q>\p}]!$<Л(<EV'\67KE⻃&oԯI"z>xYJcqR a{ YdYW\ka;DFqY9s}%P\oe??D\p}|\!jɊy!!sH?!5,̰*Xk}0T-{?>Z鏬믕sLXȾN&cxUQp~^Z9ܢ{ھ`'dHC$z>u܍\p}\!d}˛%%a!OH9ǃ <Y6zQK}ֵF Z8sه{.3H$U,v쵦iû>+'\UT*[Q]>GO2@4ȶQC0Bz^jGk</B}#XBאe h"YﰩH$Batİ`$ kYb-'\rF/[!*I(zjJ[9m #$zu}]vw#nOMx $!x#Y,PTaQbx Wc;ňMCq.s'pF!=:|p7p=\R>ZCxZcqd2<D,c񐐑,[}+GXדyq\HʹHȲ fDdzq49 Dq#Cz>x>`Iya q@Hqă WkYibIJV{>FdYKQdYn9q+KAVWDO&D?F\p}|\!jɊy!!Յƃ fy0L`Y`\ZSkp=,m C qI5>fy0L`Y`\ZSkp=,m C qI5>fy0L`Y`\ZSkp=,m C qI5>fy0L`Y~'7|}#LiK䥂߸|o[`uTD^o 0 ]_>rC%$y#;d2{QGW_&ab; 51>zmfw^C}CE|d9Ok?ڲ.Gb-U>:S٫U{-$iMLL27DNm[Hy"7XB < ku#oLwSNEo}\oSw[ynXD&[b4jP^ɷ7_|>Omo077;GN-E4okfjx,nQ)>)qK-Yd4JI2b~`H\AqM8</}rǿ'c"se}SGny.ۉuTçgHhFV/:xD_qۺ_{/}w}Od ~c~{C2~K__Ԓ >g :zsn$Nw%xR]QGBFqsqL?>"Bp+;AdH-M>&(y.A8$e=9̹X@zyq;Hѣ WP Su|6O[iNw=3+vy}DZu_ y=SMS$ D_}=?Of.|^7xo%b RD@5ѧ2eirvkϢ(o]Ű?hQ[FbZW?2zڳW_u;pﯿ;;++s2~K__I삺2J+ʸR5Y<@sQD-~^^h2.P$ڗ[X7=,8ch.m\&Oln %E|ӽUdQY+([]+w`g<)!oB}*)55ژ6GNdyïMfƴ_O;ױ,fm"9O [ SVgqmvK#Y,eɞqۺ!o: +^bI0k"=.v!M".+ q-umA$˶Ey.:<eN楫ߒDAp[&e<c;Ml7,tRs~WySTQ"X OB*^~L44]K\׾BYNMQr+eqH.*w 6k\I١xK,&\~NpdkTO&᷍ er;&D81ӳZ͸Q4|pO1g%QdY1w~K˦,²q5(mמݟD5mq9:|CޛI_鶑)m#YbDWr-jbpb=X8Ѱja }{^r>r FgE%qM"Q/l(g{d84-w]p6+?66YB1alݾ7w]`\W{Lz{Zb{qH.0Slr ᱏ䮇d_QYElZ zR v7.i6>קzX 1 " lwCZSkp}j 0!<` v74.5>קzX 1 " lwCZSkp}j 0!<` v74.5>קzX 1 " lwCZSkp}j 0!<`"`W^{XY-:p>BC^0,E1PܾIă$9;SxYd[-ܪxYЎ&q8p=\'"$1PȂx\TBb2G(oeG-ZG~mGᵸҍUyVZmz^:ffeZ𮲥rЪh6|쓖ugQ5`r8gw[-2l25.P z>:Gh?x7cq(JA@HDNbpͩ6B&j-_5$Ox?NA/4fUg蟥 ۻJ6©K aXkhWVMv8p=\G QG&q#EM<h" Qd;TbH Lk<0zT7z AY;㑸/e?$G1" )pz..MޘG(J!x(DNbfcG:^#2_V6}KpkbQ>HӸ '\!$yb(Sx bM!.$ 9YϴXW^M=;4+8t3 qw[gS2DSp=\#4D]]1P8% C Y $ YdI1KPp=\'䈺h 1/hLx@ Ha2 k,gpCNp=\p}RM̡@< "7BhY`\ZSkp=,m C qI5>fy0L`Y`\ZSkp=,m C qI5>fy0L`|%}A7(NhXק> m @ HvVSkp}j 0!<`2.и\Zai3קzX 1 ̫2}-u~[±$|J-p}jA@<&E-}e\Zai3קzX 1 ̫fӅ{dW^hBʇԝYI+M++Ng:FE࣌m1Y`DcAKRy:2ԓi;h"hbѸ[Yazr%\Zai3],!1] 4]ú^8l+,Laݿ|/{"MMҤڨ}O޿ڴ#=׌Ǝo6, 6_ANev}qu<'Τ4V1؈Yv' O%'}-Mb8죅}C\cW2b]l^\8ZdY):K]WXĞ|[lCE܎IwuŇ,DթGD`6.ɳWsuz'|ԛ/{Șzs sb]A}S}FRqu"K.>КCd O%(E4G($,Wzk.}I',[W;hvEJd: /L+I@޳OQaTjN, l\7 }^п9Օsnc51>bMry Ôvͩl.;,W=wU[VӾz04N~_Syϙ{l. wl33ם~31r\h 6vAKIdO>!jOn﯎F99I*<-앬3M1L_;Kl!1 ~"r9bNjبMXn7̴8[dBY8&fStk8< 21 ,*hnopJoakT@F{m9߹:qujvC7UݼXq8Yv^%ed//69́aKg;B9,qksl^;6&{^^77'b5I6Ͻܒx?9,+Hh -LxwnܧC\c@D$plPkC?/D7AZQ;N2,0_,I6.?ʝyswmlrKmukcncÕ0<;β*ׯ<$ttKzp2Hء}.q>!;y8ŋ%ض!&=,p2݄sfj/sNFL]/zppD9YtׇZq#ʱ1> ϫД)??Uw(Yxk$ۭdKNK(5 т9M~m0.\.nMǶ6fcrڨAPZyUٯE)" lwC'-]F/8;ӃmրG5[|NCh( $oB b`XtdBG{!m Hp-f{"Ad.`n0Fd]?WF1ziqnދa6Þ9=TbsҐ Mb8,/`32 }x&C}ķB\!;s[)^I۲V[SᮾnqkU'9նs/s4 n05'JR>y>fy #<$}b`2d>߼,BbP8C8^1H3"MR1/n3~1_&I0#5/\%mcSkp=,m ,fJ!mrX,_"11 yY,9YH3_"YspObYEɖ0IlK^"e CqN!\ "ޠq<~>񘽀nSkp=,m ,t:|^#<$11* [#MĀUdB=Y+/4Vt!CVucԯp^2RQ׶,0w [.}Dz9GS _Ѳ^5F+Ne }uA>}m}}5<ֶup8_t>^4VCA+&⼾Qmd5,ICD!0f3ZatiOYX9>2=\9́2zBKs\لcjSkp=,m ,.:=/q> <$1{ 3a^j5{߶Y\sl7zAZʐ#'-ޡK-EZq N4=seiS6[g#zBƿƅW .S<,ײf/W}\Ozt`/vز'p+{r{G?nmFz}%[YU#0S J5KḌ  kHl C=Ӟ:u9ccxxYxvtпc=|}m_= (,Ђ݌\<ғv| D[e.diTj4!C'/)]EƈU/D~?s#ȂF`Hjy4wAY\.k/!#yVV+eK@ k"qx;ܵ|enϓ  D6/7eŇ,D5ACRvd3zBFɳWsuz-|k\9M&]v^7N9.f= 1[h{3pLZׇg;,g#0Sv͸WP$K5ic͝ cxFr!|g8TY#GNc1 "Sd3xSrVN s8y-1ӊ}-nd,ps'=!#k~w/g@׳*-Ãi+u4i,naf16EǞpCU1a"Յ,H!NjL%[fxq{!.пѼg)1?Y'e-4-[aWyυ`jB,-PW\.礳Zǃ6m]ڊu(UV#ڝ-.+_\>W b@~ @dEeIظ'+w>{]ݵ]/m4f&1*oxkyDqּ9^![c,,׳٬RX~,oxx`Yz5"hfO G?zr6cR)# W=zy\%7}u?q ѐ[x;X{@=m2F`ȧT 9cE$y4wnA7,rL& Fs>ƀ/ 7,1-vUKr}[M[/Ko\Ofƅ01V9ˠQ_Ȩc,dן n2NW>׼]Kiۉ,ڧAb5:ЙW<'{-;k8]܀qD|;5;,/c͝١m6.[ePx.b$gY;;NNc)K.[~F[LxYvn䘜1Wd%p㪗/:MF'ךw *l]/|- G%6 d {I+4wҘhfEx٣+eJ-1; " lwq!Ȗ.}pF^4DciMlY'Tuͅ㒸~<~V{+Y?5\|+fȲw@UwWN Qq{\sr}ƞW|qޜUsw@{^.S;t+(%q3Cs'cXTz6<12W@A oo"Lϻ^(on<]12za~ pqĂ\^:٣ wF^!A%%19}קL(y1k]AybN1W^gGܔ+ZoeĀUd>rBcfG`z$''aw^6^RLƈr>dr> %fKQsŸQT3lhqdnqKc "Ad44.$K|+Z׻mOYĩ_$q=|w̮d̲mQ|<,R^AybZxmq>#< z2d`pGs_ڊ=1 6]H+m'3+Sc (Ishm*o,X\#2 Ӏ<[tDOٸ$w}RH-Rb( \ aEnyvry:"<$17~Pb |[ƣȢ!.ٸ2!SEA2(<,|oǶJpиwht;dMP[px<. N'9;Ebyk nQ>JDUddy#-\||,ζŊ@pYQѳ;8;Bd4.pǠFr5XbNS(™=^ׇ \0-OpGLBxZsSt[t- ̫fӅ{dW^hBʇmCW,2YKe.=bI=#=,+_/ n+lsT6yO&%}g \2Q(htίOelW==TVN>Z"z y @1<"nW^hĭl7z, PjB4.[ʧ&-v8et!e7jҸӞvRS4}eGWZ2щ, Z'WNd+e.[U?ahwqT@Q]^/R#؀l @b`.hfȒsOe WD-.9YLf49H-Y&ct! (gS\}qOT)mfx ,Av}Dzr]0NPlfm6Ap՟COXd! `0 _ :|>Rc6Q$L\.GhhuAO"ۓ7Ò֓rqp.dHE5ʣ\)ByazDc|Y4[._16Oӧ zZի&0y8V4yP#YJY.HzL&ZiP#d6EJ.Dܵ e=a\ǣz}a0EFxY~:Vռ,~D>?yW}N/<|^ﶕ"=Op|{,0K_(m7:~]Oԍ,h<#I*"\\.qqǫfJZCķ%sL#b : Ti.yXWku<Fm܉E>D>/_m}_tyfͅjۭWe:^_Q0-3"yǯdI5/ >{jz(lrs':$uȲR vP(HE.;CXfQ ]PXb<yLъ ~h`&H ~,GC󏮮cFsj[K9-LX1tf*. Y޵ٔBޝIaҿjmObk6 m/Z[yͯRKͻ@[SM4/*b,F9Z2ڸg r"0y\j.ԅNQq6O{ 4KJj6zT*5 O4, |Zdg빻66׋(?QV ?R%v=\g;`ڕ_k&TDӄ@ Y=$h4VQbU‡ kQ$4SNA"KLY$}W#0H<Ybe44Stw{}g⍽:m]5Y~Iμ)sd"zq7mw$5ECk9D$HlV*B}9Jw~[ &Р L'[" l;G:w|޳d^п}xI%kzcyeWnjѠ6&(܎`hJ&U|%' z* >raL!eY/L.EZ2x+Z m@dmgY@[>l gzᰏ- @#uJL˖kOf;ǖ|6rWLivBv$o}El6KfE= turԥC5lB5zn^!BTէNI"Lϻ^(on<]12za~ pG x|[ݾ~4:6lٿ-!_Fï D<~W#Q.zԥCNrL7 "(,4D4D"y[u3',GES[O֙qK0gGLZ]^^/_@VhSB y%cdZQxYT "KX"fWN_ZfnvS\~h40{(/,0qlr9(,!@7If d(1 +b0]^ӅBL-ۭm j0['4glJ鴃1[ev-$o8 vt["j[٣fr~0 oIiW==]Q-lV|h1b1R]V GtS\,BȢXwa:󯸖w׃[Ue4+@୫+~4c x !ȢtگV8ܱRUn?SrP7 AIƋlh4.Earj(<͢ `+GZdJYԝE" gQ]jO ty"lgOn,rgX=ЋAd "."T*ҵj|J߱'LpR ˡ1L:NԥХ 2F@5v4j3PlHdB=Y+/4Vt!Cפ-@cµȗ`\@RkqGb^7zXǣD˒>x˯ZEg2aJɴd5O648TvPT*t:-=ܜz 3&߯5Tpf36ie4t;h4n{*,]yq腢u;J/򨪌8ʤhQaY>/ 2*8BG">TǠiŠxOU[1q1 JR2iOg[@jhTըK<)BCwL6n7h)lU&7xYxvtп[,|'(SbK*Kr6p78ek41tU,X°[ , =/GzAA,91L BkRWOvQ*D]\.& $SuAH,Dܵ|E,v[0a ^Keף6œȢNl5#Y_8<%tpzĤ%m:Lb1R Hź?L1 n7vw4yX,lYkj"&$" l;@$,h4b4#%4艳C>ru)R uDu)E.C 3t*j56}R(e@r"Lϻ^(on<]12za~ p@*e!x"%4!HtzԥH5Tj94dM fr#D"y[u3'?,$Pb1M&%49nӹbQ-CIXFH>Tf]mwZٙn[(<`<,*[%n?,L4M#*PYAJ%(\[A-ElP Pl6_ !EN<"W"P*"h/t;T>xr?BZ̲;D@(,K#=əh0%4تZ @( eX,h~xx6;tV\nH""G?̦ SgɮX)Ӆy-z"!\]o"9R*X #ԩSZ<,Lgyɹk X2As6ieZ=DFxYT2n:E @b?Ira.9q||l6CwGB4h, 1@< Ej1E|>j7 4IF"bb-JFô S o@)ӊt޳Oуaԯ;" !o?QJR^G#u(b1R$6WrA`fRsyBYT@Qzvat:Bw-ssXJZ yYSZ/\!,$NsԩhuҠ'|>w1vY pX.t#`V981Yj5dXId`Vم3+JB@Ra}fzj,Q=2}}tJ%BөT*Q"TU[$@f1 nt(ˑ$Y"3-jYR0LXrSzAHҘNL p?D>G- .U/Fgء^[s ^f!% 'x_M&%4akz< l^ԥH, QBFzAX`ѵ1P@dmgYHP!GH`k]J%-*'a؅  K4)١\.w: "Ʉ9n, " /D=afx A 6E]AUYFX)j1^k5ȃ, " P(lKiP2z# B]YVV} xs6 nPDI`Y7h4V@"\rHc\CHA¥\.Cڟl6u)CU Jћz6R#Br|+HvH =m0ОLKiгxPn6,RĞhTV.E`4&h4M -h+xR8  3,.v;O&CTBGG!RĞny+ehOl6c'jn(Y`D锍'fD}ZV.+hDuu)b ^p2eJơl|SP*!jd7e;~̕/_?Ȼ0 " ^GOL ]|! C>@`g,big;^JQ)Rr-CZ J%jd! bV^Urj 㡶ԊS0,m:ۜbeCT4].LDǶJp|K=ڤiM34,)7LvaQ" " G衙{G%4X(:SYcr@JHȢUmY?,zڑO d`:j|r['X%4xrKzfza2PD] rʣ~ &;6 znLw;IY6,SKrdDTv! *[Jft\Fm6QB"ٔ|a\v dRtHDRDXX !lH uݩT%4!p8jdSVBSi F ǘg Dv -hKJsjRBӎldWJJ,4W9wN_|Y.R)1' NݦfR/x" A}q:~ߖ|! 4DVVѰTdeLLX,&oDi://9f5$hT^f\.]L*B_*0*R uA @dv.K.(x QX&,Gef0o| :>>NeA@Y,ۿ}UW?ERWK*b11 u.P[MmKLk+/n71s@ k+^.RD]OLS'fPyԳf*5 jZ2>u: ;ٌ\.Skw@d6%}ѕ̲^?րWE2+Ʉ"-RDܓR#PVo \j [ " srr–Z.n^?RQi{H.{ Kn|aJlM4 [CMF DeɡFf%0& 䱞=4b]~TUF]0Nq]ŋ @tB_$ %HD`0T*ZORX)-ԳJ!ɇO6M4r#%٬l&`~,vMv?uc Q6{RH>F@Z /P*RK^ ^>:v j F@da>T*!ԇD%ӋIkh/=*5LF)d8V*K Ntt]'-tRz^,pP?z<9*X) |Wa_e6I.FŲfKn%z7zˊNǜ>)CY;r9k4\.!]ԩSv;,pP6U$ NPF¤ #KK.n,}f[h,$g41 b^+ ZRK^K^Z\ h4bQ_!*m,zqTzLJY@q DY,\n- [fK[ 6ꍊYl,'.uxHMNNSfjȰfLD>:G2LWdR>?eՊ|Xm * ,G 6K-F6ں% ~.P|& .dH^0 +4EXA-dqlEz.cveQ9JȮ5*aZ" ,NK%U%?uI6*"9zBaT2*NV[,umJt:rvlVAtɟ:uJZ /@d€;eZ]GLղ.Q#X ߯XWñ,aLkS̲ο: L =lXUjqu!ûko ezXY(PLLR/%ZT* m$,@n5 ~h0_Mm؅cZζ s#r yc2A}T*"f %iUCRM"Tx f3*lcCXFR^N| A~֥>_|`prJWJg҂|x{Jݱ^{8hE Eh(X6. 4DlV,.ŎK5H+o[H Cuq+: Q’\r|IGKPo}oͯ<̼^ᮆȢSyvD PүfJ%r,nwĽ3 QMJ%a,+HF,@=̼%RDǧkb??7j.dd՜_xE\ש$"%\1X~NSTKFE PV%\4u(NtuF]TElVZ9Y$OMwH+WӶba[ ǔZE(2 yvm%De2p oz֣ r<,y 8Pjrl^U\0\h46{|+@ddΛ>r B銗^Se~YKjXgec^]h"~m|g^ Ţvgl IJ^qx>VKh4V NllA Bk0zvVpȋ%hyf}rzTnω+rNe: b)cxGPu:bD^VETb(r z`zLpa. GۤVN gfSex/aUZ]g`SXN,@l la *кt.*qDhD")K[KFb( k{\.ɳ,It|> YaزRdY3"j/F#CŢR,uB+ATTrQ6PZ0lr9dMZ.丨ff3r dM" W,[ pWޥs0ŝ[P~Gz+pY.ڒVI qbZ&ZFBFP,HYxcBR^)!t_iJ>CŒK5F#,` U]٤}-(-BU~BE\9D !h[/SԩSn+?f=feM3k@x<. ٢nr~-,Mk \LZa .-Eeɛ2_Zp=l6}Yeh7 m` -oK:iYhAdQ^e!Se6 '| 6L*J+٩z`]&SW%e4i@-$+6y ut-Q8RW+/| _Ev6/zыĠRЉ^/˅`" 'Xa\t-&c˥/~~.7u= R.8(ꑅ32@rY=d4T,,߯ǧN mbɎvB$aJ—@ܘ"RDl?TH'cqY6%L! & !VLݮl6=INX"a*,@"6Ų@LWKٟpYz/ubQ?u< l6V3,Gg*G 9Z[,vq7+A$R29 8H ۈ,Թ7f~76s\V{W2v[͎1iw4FK/Jx,۝|+s"Y2gg>hlbAхiADOQTm|D[>]VLuy0Yd)]ZůMcao#%3ΰD'''lV$, 0Ef[1u k$D˜V 2t֚]Ų"s'day ru!;vu||<͊Ţnz\f1" `hYmKWijfz=LJA9rǛȢ~ܶ/S֓.i϶&Ye\><<ԶEcޖdh4ԡhmXAd_ ꇳtlu㎫ߣ#.Md*LSr6c >8P y>˛}p L<%LtSԤB.nXksتT]Z0U \A(EK`h;3;ǽ]>0;;3w[‚Y" 0|I+,_Mرk5zhKadYXX|=rʵ^},[^^NK\:tM7]wu"˦,}ݻ_g-lY" Q_FD,',//" PޟuҝW(eDӧOر#JY" PՕJٮFGVot%zdrjdoWCd:Lݧ ޝ,"Kr7nX(D g(dKCy L9\xh\aK7P -4#˙[%lsQo̶b T.9qoS~,a=l ۇ;KQdYugY`29Պ,:|?G-?{ GLiw4lh)ySYEd2ykzM'<~鑃FX{ɡ~l ˱_o.;6I93\2=ErVSsDؤ@5< Ndyދ߽OЯ_g{/%36 di&j,Y|Fd@~$Ch:=;yaI}a]wÑeLt(~ҝ22%Y>;\onKk6xDzYh6en{n;sWtXC?AXO";d)uFtJ7,eJv_"4,0YFV D»voI}܇a=l ˾=Piب?W1#+t"˿?wv_G͏ÖsûeO. ݮe՗ %/E#+t"KXN=;{x+OrBx7 c-l3oƷ" Tfj%,{o{Ⱦ컘./-ÅeUcØM>G8,p3L3OO탳|[ymY`@4S,6FdYJ@4"UbdYD#+"@YhD D#,P%FV Ed*1lldikdvR~Z1;(?w|Dd2Li&KȲAGd D,ZboKL9l7>oeF5;L;ƞni)cn6D[ѝN *&黝~n1E0FV Ȓibh5t2dX8Ó5VYi7gC~+I7.6cٰ{{Jbif?TX)=on'%K럳 D3Y .iɦ~digfGvX[dN'INwL'dd62"ݸv]~*왤)E #+hde(Xä#K/@tmJқZQF)wLdINZJO`qryh,0FV M1%IJsޟBқNk'[Y:4Ȕ@]lW=Ed0ь'Kܓe%O(iw:7c\M$)y4  +ߓEd8@4PId)$nјo&Ncn;nG~T'P;)|Pc,sY`Yhre,⠉~a\Ed2lҝz:d~1lȲy& D#,P%FV Ed*1ш," Tf۶k~ @,@453Yd 1ш," TFdYJ@4"Ubdq۸&Kdb& TFdYJ@4"UbdYD#+"@YhD D3Ȳب4lkGZUV9So.u>X\$E#+Fq%|Uf') DSY䗏޺\XZdMcI^fk$|wb~{ғa%,ح5[K4f{=_6alNwٜIMJ&t=lvAi5jk٘H?-ۊ D3./8wO˩2lM Uv'%PdIJ'y$#M$-Eqd$t|;s/|OIn+" l#+͸G<[ce8е<,bR1%[C &dtZI>=“VD FV q+?r$^8crэF\),¢d/ $c6f\dw7Gv׎O΅Cɲҽ'>r^.,3VZ13є̓;s7Jxg=YY2)d{n,@\|"ysX)'}O9fֻ TӅ3-BVD FV e6yEK& D #KvJQtP& D)#K̕"Yh6gd:edYD#+"@YhmF<T0" ,&cIENDB`java-design-patterns-1.16.0/flyweight/etc/flyweight.ucls000066400000000000000000000204731312550536300233050ustar00rootroot00000000000000 java-design-patterns-1.16.0/flyweight/etc/flyweight.urm.puml000066400000000000000000000026731312550536300241200ustar00rootroot00000000000000@startuml package com.iluwatar.flyweight { class AlchemistShop { - LOGGER : Logger {static} - bottomShelf : List - topShelf : List + AlchemistShop() + enumerate() - fillShelves() + getBottomShelf() : List + getTopShelf() : List } class App { + App() + main(args : String[]) {static} } class HealingPotion { - LOGGER : Logger {static} + HealingPotion() + drink() } class HolyWaterPotion { - LOGGER : Logger {static} + HolyWaterPotion() + drink() } class InvisibilityPotion { - LOGGER : Logger {static} + InvisibilityPotion() + drink() } class PoisonPotion { - LOGGER : Logger {static} + PoisonPotion() + drink() } interface Potion { + drink() {abstract} } class PotionFactory { - potions : Map + PotionFactory() ~ createPotion(type : PotionType) : Potion } enum PotionType { + HEALING {static} + HOLY_WATER {static} + INVISIBILITY {static} + POISON {static} + STRENGTH {static} + valueOf(name : String) : PotionType {static} + values() : PotionType[] {static} } class StrengthPotion { - LOGGER : Logger {static} + StrengthPotion() + drink() } } AlchemistShop --> "-topShelf" Potion HealingPotion ..|> Potion HolyWaterPotion ..|> Potion InvisibilityPotion ..|> Potion PoisonPotion ..|> Potion StrengthPotion ..|> Potion @endumljava-design-patterns-1.16.0/flyweight/etc/flyweight_1.png000066400000000000000000001747131312550536300233520ustar00rootroot00000000000000PNG  IHDRs\ݶIDATx] \NG JEdO16$T(Y YkKvEhlEȄh01cRzy7o}<9sy}Y~KE,X\BDA!4 pxAA64qu|nH >TOBgO y#\dfWSˣ\ӧGI4rsehW^%KȌPܼ.ndF*vRB,^!R 9<ݪWWtfHi$K! ׅ2R-9`@͛gɓjԍsi2Kؽ{AN6^]K__֭(V.5n7[SYb~I YTq ن@$EE-B7wyygGJ4tR])oDoge%T\88j\KY¾} cb$Bdp"#*,U,Xh ȸUlC h bcWvhS~u림 R¥}2o0 5ں>i׮8'"(H٘;tu#4%矝=ظ޸qäc p#7ŪY~x?ߐѸUlC h 𒒂Wfxf!!3mGbʖMר|H[Yl˖͚pJ*r ݻk q2cƐc`Yl$d4|aݺP S:Fm 딐KƸUlC hTӏKU2+F(-tQOKL QC%idAUjmM.anD!R rxFj.DJdA@OHͅH:lC h᩿")QgmM9<[d#5"% I]N6Z8D1+ %d#5"% I3 *7%rw2Dq¿(Kҥ* 巊F$ +;<BC1.A iүy.G%>un)[Oy_}U%}{),ҥKUj .-S_@ ju˓'L0sEW~(6z>+Sh͕y\WPiK<7.A  wr ߳gy\"qsF_@udժ 7N+`~kÆ3,Yv5,W|UݺuFVQlTtR(&%Zkq ن@$H8[& 5e3K=5'Wz]gpץJ M-ݻרadbRťҎY3NlD P6aa̘~>$lOPo;9Mﷸ5.ӡC{ӥKǶi6n=Iqqkj(JE[E(s$q{U4,lس'qc3]ZYM2\FJ,-\9 ^xbdZ{{))=y| H*kX줤@6zY3 aؘލ?xpPKP56&A |}O;twZ; t]ʿ)HIlJuk-oPz^ޙ!!3D˗G峤8w'.[#A_5rrYW~'%u*# s~d[vҒ]U ?h RR IzcjZ?؍xWQQ߿؈7"e 99۶GU++%I ߡCS-3.A ^]fD/F҃ǝ]\tT!q=ܥߔa< ,]:m'Oa=a][4pZ2YRkqFx> AҤbvM^x',<N%y~KU 4T))I<=]];4%%O'6 %+Wb{850-)ڵ]Zf\A!4 oKx~&5{UNyFv1}7z_Sd64޽ 'oE [mׯ `bRظ2?p`/ׯ Kھ])p xv ϊ6TRp UAJ d#iR"OOJN:ΞzoKu`#D!ʗx[-ś7e%dA ijeź#Gasy, uUwP+<ÇW |HB|rrHӦ_ ؕ4A@OljReχ),vRdo8S6…PȢH I W2BDEu$33>(hbÆ&ލV)/) geeWE F\Fvݳ'nMA$KM$IEfsI6)qfT"2kN;8dfƳe32NMd"=7YY +Wz:Nf6N$53GJdob991Fp;ȅ# m"%&^-UHlʎmׯnݔD2HǏ) 0Y ..v Epr cCW<7[#%2K?;{qeCCqHLj p#7ŪYDC)!4 JFh0IJ vtl_3eFܶm>"=)[V'779<|^Ff`"-HE[1'& k׮% qP̬Vp 阳g@y|E7A@dHJI KGjٵ|Th Mj[Ǐ)Y$y1` Ɇ SMMk^!3++-[fxoJd6[yyg٣G[P %YtC)!4 4d@]誼~ؾbzlv̳g-[Z6kfި…+U}qw޷ +ɌC.fy,)YBnn2 LݺP H:y!AKPM$%H;@U5ӏKU2k~(-UROKL땎)C)!4 JFh)!g"%&HKv5"%ƣ MfS٭k$$i)Q!RB h&3ܹ#%/^׍E5y Υ)Si۷Vf][[M. ʀ+ލ60ݺuÇ1YEpa+Hf6Cp;~.- CHgm$ȼ/9+Ho7|L!v"o'kׂomƪV,X\ƕ)=9O܈spv8l058xƂ#Ap\VMظqZܬNu{;R\)!4ޤ+vMJ WqH~FJ||abkۜPYgfCϬLEr6:IJgU̶]nJmX$z|R="k:th2vy0Hf6J<<NGJKz;{Ho7'%xoߞD!pO0pT^OU,X\ƕ-ښȚ+]={.D3p/\8gKǶi_ j lLW|VV`&2/1Oc37B lϮjҤA\ C)!4 C@|@T NϣܹC*ԬiɣG127:IJa[Z'Ϙ1E^3+W"nތZ(#n گ.Mf6 ƫ8g{oDko4˂e\ kyvvn6ɸGm2y|N}}toAp 'B*}%*U47G׾}dc,P%ժkq6 UG b`Apj(0A ᙬp9qb#Nϣͽ`$27:IJ898NnADeDhGڥ&cU =$dV1H#%%Ξ{8IIU $%,o3vl j˸lл|ޔ$9l^s ߱MV=ԩclddFr#[޽ȶh8ҥ迤$*jr0 @(r˖0: ENBDJM<sג8%GG&oD( %H20нt O^ EFJx/ήbR2^ &M={˯H:<]G*Z/^U6}Hlg=%ƔpH?:ǢM fO^$^)F Y,.J)vˌHzҾ@J=:G뚚ڵӛuHLpZREHp`m]] 9$Fk||HIP`"%&AÃL8M7E5W$7=WrGu {7ĉu, KxkC2Iˎ\[sgVRTDJn#Ţxy qU`qWš.Oih/pٞd>[qb{RgH;w!z*W߼>/5u;ckʕAi .gl`$)QP+ A@$(vx#heACV?6 ;<|SUGJ4H ǎgaay# ) )Ǭn6~@.<GYT~fy$bgIVVF-pd?8pFf+WGiP|yHb},-th_N  RB h4=}mu린%/WD }(׶*/DJ -E)")y<mq aH0BݩU@##MsI|jk3БwyI}GGlyzSC!qxj.DJXNJD8-u|0&77MW LJ^^t}^S-b RB h<ᕌ)b)RB"C)!4 D \C)!4D \C)!4D \C)!4jD$cGQisI6!R&B@xWܢD$MOi:yóOmn %PlV6*))aC)!4 *ux>$=yKdkvr4ȬH H$2riGDΙ]B22N];Y A@$(n"Y͖0G@f}7iԴI̝\Ҳalk߫Wt?ʕ={۾}c ԁf.Sv51JMFvݳ'iiPV.e{3ҥ%+W}{oX؜^eItݼyݻ[}0ݽ}ϕP}KZ٨d"RwV֭58KrrǍؿ aL it$uh̕C`(FJ@ahTmҎY2֭w͛7dKBum~\"ePF?~|mIH IDN:mĨԐ% akۜ&r^*W"DZ[gBwyԨ>,CjL<<lŝ{{&]:uܪUAgnEv??+SCADl&\pذOn܈#]bرDM[7eA`׮ƍ8ujN7++Sf…` %(v!dQOeroJv v.IC)!4 H?ȩ@"g&ٳ[8mwxn7yvh}CX Ƀc\\:qDO]=N0yT\25DTAJFj"@JoN}|_| % 뽽{#c]"}6ϙ3=]dOc=={{Ht7A 4Y6,r⤃2 G"gܰ;9a:< ^ݺ>$ؘ[Ç1z* 2om`{/X0KzҥKedꕩ RB6RQRrH2e08}d* %, Q@Jȋ9 rck=d " %d#5u %#Fka ltD$|#<~Դ迤իf̝;yz:?"˘~ nK_EM{533QIDJ硠Ӗ"S<=Wj4pwvx5;`X;[r%x8+s3>ݻtXtnyvnEI, d#uu %L$N/TX@4ǰ1AppngW1hPDJ#777&&GQ 5mt޽B+@)^9kIK#y7"!%pzz]ۙD& D1%aasuk cJmAJd/)Y|rϞrU+_J/pUnm믡DJ9""Bh- g4$`k$ JdG K-obR֭(>)MvvdjZn]cGo_ R"Ceu >(Ys Y:W\ݻSDJ… 7oZ ᑗGA뷖$O pp@1s^K>|B($h޹3 )!/cZ/ K<1ֶ"%KADDDjjZϟ/[ݔ0(+W"C^<)! ggg |q R:!RB 4Ν;qZap)//|@H @ VVVB+%H @'N̟?_h-_ rrrƏOH @ NVVVll,B+8;vlʔ)DJlK_VmGÒ?>a˖YizqP7oⳲPqVMС)Ku+ a^)!9""Bh-Tׯ_o۶ >|?zjI{v GJ,-Inȅ [Y&Mli1!VV*&O4{?ťӮ]-vre„åӤnꕩ!@(;6{lP!6n(ڃ7o888 [kn"'N:8],p)"y֮ رß#%IIIݺ>$ؘ[Ç1z* 2Fm`}q`Hv,ɓ_J.qWDJ?~/ZgxͬGJ|vZңtH~+W"!n܈>ҩ&&6FJ/pUnm믡<ˣ{wNڵyJӫp#4i/YDJ`HJJwZCmܸq Q0е[N[Fl_N[7jU+4)|}ܹEBF\r%+srݻktX]&&Hn݊(YZC"%P0DDD8;; EcBk8vؑ#G)ʊO8M F@^Nf/-Evp`;b}y*d4$RB 8^'O4iG`ݻݻU-3cm"ܱÇ1D@ GLL {t.nD$ȅH @ (/ Ek֬)ܐ/8$$$ 5$%Z#DJ 33@MݻWhE4 [&MT-"%fӧO f ??ܹs,]êH @M +4sssБH @P ߿wtt98cZ F^^^hh(o>uTIV]t)g+ s}//w -4ڽ{wu! ۷o>}*n݊kׄVPB RB  55uѢE4D9998FEEBC(Q)!ڵKh- z>}ZhE k֬Ǵ A)! E3P}xzz޺uKhuH N2G/5G^^|0B+8qDj!bpih&4gddE'#===** ݻw߸qChuj"%-DJ ""Yh-͛7g͚ `cZZQppк DJ4["*j}UԾdddL>Ǘ/__BCP;)G22NA+-׿c,h|4iʕ+~BJ80őNJۼ~pVVS  )pa+-|6H Ptdff("#ZZ#G?~<-OP“ v{7ZA) geeWE F\Fvݳ'++rJ_ DfI[ 6<''"3n7Pq$(@|ԩ8fff*TD<ŋ沘}Æ Z?ܹsUVQhE$A|3 &6veǎ6Zn "%HǏ) 0Y ..v Epr cCW)YB~ٳ+7,D:٠ȳFϰwH&vN} dPP_d>NHQèm[k~ttT^.8g?sZ8FB`"G+V,ߠA=; a`pp_5XdJA &Lؾ}dX`H<Ҳ{;׻wGp=^e* 3逯 ֺ..lΚl$L[.񇑑%߿߭[t>-CR&WWOQEU@N~zSt\yݛ@+6NK\Z_Ұ @FƉZX.HOo){ % k'#!"ƍǩYӨԿoDeuaߡƌ^S:0Vt~N.]Z%%/|҆p˖lI (˃3F6@nqҥZFSTgQö^;/kdCzߔ$$ld/3!`$x]9f1Sxobz{m'Oa?=alkOoB84t6ӧ{]aںn@)a*֯ڽ{v TRdttx,NQ #%zzfK`

vI1ozıf$#;sH蘾pnpWl9rƐ8 >>΢ |pFH ή%Nٴ9Ҥr67nL=W,OJ~5t~6LC9H8q%w^0K)[V端H +?++I˗/CbO~\ 2iiiVVV|]"pʕb_^K)vhOQ D7 o&$يC|;bQ09Or:pW9}&lІ<| , …ge(LRrfdx ǎ\4dsj׮l!S6! ^3"zР @;w!\z68i޼-_)YZ֓gKAPDOP۫֫W.-co%?+hjժ|VVV۶mO5jǧFo޼)Y)iOuՒfsW anL£+pDx`O.Hrn08;к|3hkă Z`m]} jddP|9Ӧ}xv*OJn,"weicׂ" ?INe`6eߡ'[FVVdf; pF #>?.2mI y|W@J+@]lg=n`Y{Ksss^>~oߖ2/)a~6DX#X _O )2*'%"1/gw0>n!>8">#1K{~X 36m3Oߵk+~s~j9ꫲ -(),Bn~]v30p lE;w9:gdpD\ @wNT`Q6Mg񌔀[ #+?)!3|KJ^qx7ll̯\m5;/_MHجalѵr¿mg47dVw֪U2#]`2gϞ2?t588L)hOx6aS/%diR[M4@92}iGA! xiXSI,%ڠAmԥBbHIX1vKݻ.GhKO?^Е^`N8WDp~L=k)ѣ>f~Z32N(%n7.=)S-,ٳ.a}}݈_z{ߠnEAn݊2I ϞʬnϞ@}YcRS,W\iee{yy͚5H.YR"sLV,_>vr\\>mUÆNsx#fӦ ok021lYN5ca? tɉ'p#jժZjV._[ZZ*syrrrӦMYxȑ(?R$a|H ҅ [q̝;%pQ | 9#%2 1lX/~2 vx[GOװݻ-ZӵkW==T?ł.HɤIӧ{0a)GJ@[K<$=xp̵x"}}#| j߾ b<='7jdV|}J6DRb OyKzWJ:ĉu|RNۑ^/HUgKTf`E"%Ɠ'OkmѾ}իWPyĉ֭?RSSsʔ)}݄ ~ .dggyyybY*UEe*V^]>g!IIʕoܸd2|H 0IILrtUK?>_#%2[~6cr,{CTTi˖-&M)H0Eٺu._]ěVOx>Qd(#%z1Rߪiͮ][DߎzhЈ}]|xJ :88ԪUSNcǎݼym۶Ç~8<7ykի -[Ve|d…=zpqqXb5@AV^}YjUX[n! l*"uttrrrXs΍?̬L2V$&%xb,ɓM4m׮](J7zzzϞ=S9qP򄛦x+srs%)_ Ub)$% 'Q|9rt:wnAlD;l)V˄ kG#%5<-H _9yDߝ)afDDJpڴ#"|٨ ~UkN^dR+uڵ8Ғԩ\~@@;~WA=&q]v͚5gϞ&&&G޸q3gdNfy! EDD=zTS2ajժ666\$jq.D<2[XXK.6!0w\Ў<7F")}1!1ظr)$sml:d(#%_H%qw"R"W>|H՟Wd5mj^xձcG06\\dܸqWCKr`vZoFWW~...߻w͛7JHɂ X'OJ.a``^ݿ_GGn߾}[Sſj!%aasx7"gX1n~8}ۥolԮ]lHکS`D|ý/)aql/\ RQ oGE-WoSܛ餝;xlx˗S_l٨QoРW_}ejjڵkW6w 22ŋ|K޼ya<ۃ ԫWW^`lp:::W^]t ɭ[DbRRF u"amm]lY<|6=X&)֯_,,,Pљ3gD)!ĿBb|zZ+T >JZFSWq޿) Ma{oOSSc]"HɥK<<fܻwQm,ic^~}6#%Iȏxqbbbxxyܮ];ccct]\\&O zȑ7o*9qǏo߾Z~ *j{…'Od3B9!shVV#o^zUt',S<~|mFplYh$)9r$ ڴd=L:0bJ'))'%$ D#I hLj.}6%%4;a9ll"wHMMkKJ^kٹ##ׯ l'z{>7LJIN>Rv…ݻw/>|p;;;ܼG+VؿիW UAI_ Sl޼ʕ+?.$56.2ǣA~LF %rb)QgHRDbKFt@ _d+!g%!PIڲϿw^||-[fΜ ֪Uʕ+hѢ3f 9qܞ ~ χ7sΆ5j԰:u/_\T8yg!;1A1%ޙDJT5YŖTD$KZٟRIDQ Ҫ%zZk4wTܙ|^׼=ss9{#P _ C C 6%7gϞ \d9\Ro***o͝;'::ƍ<R%Pzͅ z-..ާO{{˗/7qp|7}k~2yGr?Bj~vZXHdP":ơCNNNdd-[ ֥Kz5q˗CC"'Vopww=zBN  ?1>}fq8q%U)`^D9`^+‚nj~cqS"a(_[[Ӥ\J___BB:CC3flذ!<<իo߾m!a?˗/wvvv~~~DYJ8::&2y8{nьӮ㑡$}؟2DyW= DTOdzDt Ƙ1c;ser,Ǐ;vتULMM:vhlllٲ7oѣģ7Dϲ= p0hgkEy9 2a?zVnݺ]_[[ &''ܹo߾۷ֶ>w?e>|HN{TpφNpnhTuuu^^މ'֮]kaaѭ[7Ç;99 2{.k/ e}F@gyEW?~6P"܆[(,Qiiiddɓedd&Mh5{umH#YL= kɅj~vQtS8gCj %m¢]'NЪfj<&_ asȩG$ iY 7jjjMuz,BUs}o뵥qQz'LAA#:~nN OEA6U(>}~=7(W*6CӎTQVVPP0@޽H^bŌ۷#**no%,qF^,iӦ*rJIITf w uҢVPϚ5kٯ>WDTx*b#f(a}|D]](((@|)(#''$]P\ަELKX=0O "ш@ ]vihh0Pҹsg@Ju֡M0Jcǎ7@''߾}ƔΘ+>GH0 t= u||2\z`>phT=.]j0`ǧPVVƟ>]f0 J^^lqTT]L,L3lؽbȱ1/Mx;bi(>9{LK'"͙3^Q#b?^D%ǏzRJCٵk'nq-E%#tcǎ%ޕȰ|=0OEI& kR,ZH^^QZ@qq,j(ѣ9ܮ]Ѷm[ ؋bbb"%Pm֭555Ҹ< D<훀7oސ?O , trN̪ ,̷o:ɖ޻ == H@ t6<|I' r =BfE%)(8M%Bh2 )=mI# Oc]@s۶b0C=gJ^8rd lB\fVQQ v qLLgf;JW=ztΝ)//(nʕ޽,`09rz;;;SSSsT|_\\/7ze߾}$;޽ ަ΀P[1OcjڴiSLBiiȂ+V0HoJKKV@qh9QgggG㔐S_9--n,!^1ژ:uJCC AɩS>pŃBgHݼTH4 /PRBB\r&\͠4"Օ H J@ ?^4hkx<1Y%ҲCJJJv(i׮-C!8tPӧOG7/P&ΤIPZ[[V4tmڴAwP`Z##R~ǔHJJ7*x"xnUUUgΜya(dm1JI}`2yy?AOog7A//'taDtUhAPCa\I]mDk6nGׯPR[Gee%-h _poO>NG!2PD4\e#fFM-PčHA߾}2绺H web(gƍWFiׯö=V@-(Ν; 6?]Hz@ ' %l|Ÿ[ô I.M8'KJ ^({W  ~}.>ޟ<Ȕq j߽;_Ww\g9KLܩEF(B֭|I22P!deX|k r3f ]KXPҹsgZ1ߧFq@[ +Pٳ'dE@V@q㈒޽(|ԐS JOp!\1Mî]nwtFCz2͛S"mc 1@&ч@P$ Th(}LIV9NSsP9d /X?Ú[b И顿ߴi̇)zzz) qqq(AY3xyy!ʉ3%Ca*22X6(A֒'ƉS JƄ-@WfHb{?c2oAg; `0@1 fv /rK%RQQW۶b@ ]] H@z0;HHv]<}J*)w!sq?rcGoқ[b Jzmdd$$$TUU&>}2۶m ek1P`2.ld^޽{< ]+ES B iSt5e`s+hmss5SSs qZZ2%z͘W>RTN5tS~K,Saaaj'o߾KP˹㷦 C @ }L̮]ně!ָq{DZ"^tbbmD9C kLJXf6~= 23Cv턂j\9юب&)پ_?meyB&޽9s[X `%C aÇSITBRCaH/&//c` =*ɫ %dp1tP #Flڴ)--XX|sc_bqVMy @2c~J(cfPr7%LuuTwCBYY*kƌq(CRR'1#w-. x/aBtl<;%v\v /QIT{]6mZoٲvb5aPxD/}n:###cc-[ddd4z"7,_gРA˗/""ơX\ݩMO% LvulȾJ(cfP{З\YX2-,]vE=xpŷo"P4o`!P (mJ,de%GITK)acG)_WW %dZ_^ti͚5(&&&hr (XUuuuVVֶmۦNYYY"lq_؝2f&yLݸW''&Al۶nӦy.ILꩩ{Kuu7nХz  PB\DPFBXJ?Y]Pb[GоxD,11qժU3f \fggs9 z葇ǠAq@_؝%13Pr6SS%K[r@@9ݻ+_`(K>wn0P*`JP.(=0(C(Y#ZϯXRRRƍɁݦ X-S߿ONN^~aÀz畂n/hZOPB3 %JJލ"P(KyY̻uSD]ѴJ@VVZZޢ@<)Är%~P.(+0x!PRRMHD8"9x(ܹsnnn}@133O4mzׯ/{5sၮS& kz;:N7qĉ,,@пO}}^}}]:|#y J($=uʇx@CJx!hP^z6{ydU$F $8x!hPxCoaX%''f3$P e>tRޕ0aŽ; Bp¸ 熡qT{ؒ%p!ZYIsUP@Aq֭[ij>oa} .%e|uR@t?> Ɩ!rq:u;wn%eyrwW_ʳ 3th v5׋BdCĨ۪CMA Y>}]xq޽eee'MxΝ5]D(++ùAPsP8r*Bi?mxO(a6JKS%$c3oomLM _<2>> =|ʔ5^b-CT~ahs[,?'=| ks5vbv\i֚)o?SP9s&D %d}ԩSp)ӱcGKK]vݻw BֶmΝ;W/C CIOEA6>Bɘ9HJ'U8|4uu6mZ2P"%MKۇ SƖ!*)IP(+K-/Q(|\VQBLt헁bXkBC|M/zP@ Y߿vvv֖ڽ{1'&{ l|CDo؀'Z/ׯiDy`qv1.wTel2XZ?~(9s;J.[f \Mz5SF!U3ЪC%d{ĉ ,TPP޻wo^^~aQ驨())M4rЂ[[ۗ/_6h\0Nx*b#Pg߁l)4l,4+K(n~@&hBJ@ el27L6fLS4e򌢢ĝ!!k Sf(4ܽ{1 Oa޾}9o޼=zt z?|nZyrnn?ΝKyRRҔ)S\tO/z[gVߡPC W"oA^}%@_.##"KIu9J(cː۷nv"P_?f@H:0IKۇ֫2 5ss#rcq!JPByGuttTWWܹCBBEG3.]=z4JxBVV*ccc۷7ȇfS`C'JyA6>B=9p3AWWm[1qvjj]P[;qS"Y#`G**Cd ؑx+^ͬQh =+dcO+PB˗/9ࠪ W3f8xӧOKĶp:\ѣGODA6 %c-Jz={N %-/AKVBM/AZ#lLSCה*$Q CISMp% txcǎՑܫ;w8q%KN>gZii B6] TUU}y4?$ӒߴO06mWUšBϛ7MeE@(nھ}PlٲfBA%Y8nEFF***ڲ& k˼$ a(d55_֪g􆵅*--UVEDD4%ܸq# \JJٳ%%%<Dq . `]UVV+޽8qǏ7P ک(Oyh|_د)++ieeQƟ};bh[L2(hT(if68c~***'G-="bd{7á |#mmU(Ϻ9Cްk^zehhvSp׷njjj ѯ_?wwt g ZO ƓBBB ٳ&SQ؟$% JSXxIZZ"2rsAG '3IW lݺU@/@bǔ=wF̤ɓ;w_z@hJJ:|xusB}ӧχDhQʵk|}}ǎ+!!1`+W&0p/ x o 1 ('(2(nii*ӧm3DBBe\9sҤ( = KJPx|Ce Mϊ+<<<k8ǏYYYޣG@4hի/^TAk, )o#89'Nm傣VJZJ Ja\@.] {62 J^=@@ ܸq(rrě V n臀-M+.PE5o!իF "*,,l߾Gkϟ` C 4 Ǎ3$߽;@VA*OPBdqEDlK O@ K(A/V[[`aЧ ݎЩgVVPYA6>A 7Ai3dd$9 }L@ %ϟu mhMƯr2Pֿ#.ÇDAP`*\WW MH^aa5BJJJrrr222-f /ްa-`$ %w+7Ai]}6׮d?6wD)jj]֭sJ(+'C G=5{Ruʿπ|ssm#X7gXЛVMMHHH},,PxxڼyHN Љ=75+! پ|I֬Z4IgPn.PAo%H_OO64^&''dffv,!TQQZh%srvK􅃧5*MSĉzb0_%D\\\ttt P"(A***244|2*|=|PII 3f MKk7oތ1 |P"C(a0oҾxly5#  'N`/!Ї̃@/X# %mB6m=z4)Q?h֭߿Gi[[SNUUU>}*,,,f?aaa8,V Vh8htVŃ. Q<}`_6m믿y[W\I,wwsRnҩSKu!vҥK}Q ك[ÇpVjjj.AOx}-ZXzⅬ,V0 o=={,..n@nD1n/O0SXM\C͙3GQQq?~DVVVrrr( 4pYYYfffA˗/700e0G9̝;آ{'mxx#joo߿,ѣGP'OxvDD]& ^1`(&9rMP]~ǡ7oBf͚"ggg愌 7߼ybjj %%%P֭[ e1M6[l)((pqq0adXՕ+WTUUi %Wծº7ٳ*Ӫ ?;;Oig %\텈HMM G&W^f˗222(_LL.((hݺ/_XT@ANNOLLTWW RffÉEΝ;@aݺu(?=='XX.\`0q0O6m7os9̙3԰( uu(u8_ᗙJ оCbaBcJN>]WW9rH)))W[[ zzz(,F %ύ3bff %Pr䜘))nݺ|e*))֐Xa)w9@rhE04X徾t{U_ 8z4~ .E %^ww]xM|ε2S a36̙֯둔\Rܧ[;9Y**v _Ekk99i--U?Eh_bf<魫 TUe߿O4iaWCի}P툛$Ν]?=&,ka@4ʭ8 %Oyy9^`Z=BMP$,,jv ,ޫ9LsV=+|lYcf΅2Dy(DCCy͚YG@~Ϟ/] 9 :[)ɻӆAz8jks ---H1u()42҅EEJBBvvX:{YX %ÇaqzGHk'( (yf8e7]04^8i3f̠ ,ڵknJXW=(5&ӠwJ8φ`ia3~ Dy kk@ bG.#% Ԅ3f 9 ts\C9ƍðj۶vw[G $_Y^c}tϛwʕ3Pҭ *&)￣?~i`/@1?/K[q.J"j bD[lٴi^`^wJm\@_3:rc7c [fdGSۄ{WgḸP"++Iq“L!9CIvbh>p,PҡZѣ\z!XAXZb,2p؊wPBu-55/^+ `t{{Ճ֎ ֦<\ɗaw\zϰ%K[Elf,m:%hh(baQKK8gN\Q#*v6#Gݿ Zu/J2'!,sXV %-zsp؊wP$8p?^0kϟ?,!ݻ.]JXW+o4׌90x'h~ؑ.t%޾IO߇Ms3Aы-i mmUTpX6m n^u;˱vEEI< Jj<v(1P߾ZPa+CI4z蔔jPt5CCCL :tj3aS6$^%Ȇ=2e$0znr^$ٳ;,Xeg"(QCB-//#.n͚YW*ss_v 28(5?rr)h mL/e䁮P\y^`5U9j?>sLXqFөM;`Z4䐉`a15s+|ji,DCL_]J~ޒq Co=zwّC3;J UsgW۷t,(tbUPn+ %XX\)..аnGIpXYYE % sţFo 8}SQqٳӬ==Hqv[Щs(@XQQRP[|?_oV 8(66ǽ1EDD\t >},0ffft{{t[SSCg) F/a(i\\\OX}n_@#G ,Kc& UWWE~="(%%͛t{,_b$kXuƍA%DP"z Z;v찶,PDȔDXͫj//;wTTTTVVӧ;^`^J0vNXPUUׯ_{葛K/Xovڕn/x/ %JLw޽|2^`OIII+WdwsH*** ,KX$&wj׀j_޽ aa0_,Pyyy(*/h"ܿ| %MO8߿ӗűuIIɗ/_~n=JjjX3Ν˖َ?$#c?HH>s)qX5|AVVQ;||"( fl_=// rLM ?|H6m̤IBVţG7$[u6pF[[59y7S@@&L@invrr/,Ӊ' -\_~ ,?P~޼Ϗ YcDz%KaR=9YP{3͝;_PB{x́ 33CJr؋_EgNNN 모(c G04L%(+4leeÇiu ?I_nRPPÌDOUf;X\`3(=hPWX1SS::ePiS %߿g (sY9>gf61@'7T!C *(c(PUWWɓpTZŋtETTT^~MX<ҥ Wxʕ3֬_IWWgtXA$7#Gfd VV 쎐ECCyyQ"`]PLDpuuee/_~׮]L_X4('ҤOX<rQff_:oD`M %|xQMK=(9I__sy3?odf qg̘GFFX< %B&33=z ZXbbb`撅Ebb"^`XJJZnE·fh^?Ͻ{:SW CA ͰAQKӛ7otuup =8h[L %rPj-[FX<o;8lכJs>sg9'Ob8dF@ Ν055ф`\GY0%.w@v8hӦ- .& >}~GffJ,y (*vLIs1LiiP4abbm6oJJJ+8> Pđ#޼IQ: ]p C8`e4ªZxJ?,X@X<f(PL(+(s 7 НC]VZ^ѱTQQe1YZ@t LF~]] {(G+WΜ4i8JLFFӧhFiT= 1$0u>h~xI 8p$cb|9g4b۷khhVtرYfFJwng38d"#ƍE ]2EtW\9`W 7#Lo:ҳgwhjL(cÆk޾M|T!;Xu:˂LAAcNG*#!n޼ <_+66ښn/xtp 35<4(*[&85++bHN׮ ]w&ȄNm[숈z?xp>һ: dڴ13g;PBY (!x i?JP}ܸ`y'ܠtJ͍&ZnK 99q !KIiK?:uɡ_… Ǐ ,nG^E@9Zזf%uϬF-=,CK'h)tVV( tصkTŐ!(Ϗ)*J"*֛X. de%/] 﩯٫TAݸSG4bAI=?;w"Ԡe:n{>JعgnnԶةS>Ľ%⪪OclP|4i=^`Q+''Ȉn/x&BIJMMeet݋D(o^T'/ wEP-7Օo_˪kŊoGTT\8qXuu6z$ s77,ƍ6Ī4Խo/͹ CI*6VRRB/Xݻw jSS2qvrPf%%ap]jDp,(bG( 7&C 64 %|PJJJ.] vcmmm8wp/ji Яw\IO"Tz~r*@VbnKƌ Er%GKv ) >|x=*USc?=+/ڵyכ`(FmJƍpN/X?+UUU8tp"WΉYuᐜ]EvvnV083(>sSEȊ2ճg;u0z@uuer7nBHϞm{@];1#eԫ&ǂoA dbҿ/U`(PO)**8pnG~ЩS'upwNv? Ed- |4@Qto9Ne +T{$^<|x=)hmZ>& YYI0%WM yן5С?Л`(FmJ%ׯ_F۝_JJJŮb"d@k]\]~~ J(Pۭ];e޿JM9Bg!(͍|$ I)` =<7P0Х;vVUUH Ummm֭b6/OXLrs`Є %ۗ(_"zDFnfbzP:2UScy ++IŌBC78(y &C#sppHC^@PB9ի¢"}ij׮BnAq$O˞=!a|2e疑rB=}|T$>E@V?LM 0jT%D ʨW&& 0>&%ɇ7]k ^?QNå9plŴɦzUWWPҹsg ^`R:1aKr:Z@WWm[1Ժ׃>u'98k +vxzMEEɒxꌎJTQM el/#c?JWWgw(Ң9z ]=s9l%;f8D`416=ztE9[AWD֭[ 4i8k6PJz$O C ޽{v|Gӧt҂{8wp綡W!Xyyzŗl]/Y1p@:iQ Hk,s"ݛ zg~ {E"rSN]k؋Aɾ}BBz{;w s )#߿>'%:02Tl-Z|~.ȑ}_> ޼IOo"(P~RfkdE_p=~7ٝ(QA ]scJ<9mxr5G0 ~>}~HP"P*//wuuě7ojkkvGիWn/x)ݴgʼ(ڝaO.6ХCW9 AIQO8rt!ʓ487o;B];15H@ɛ7!vXٳ; TG~|n4@NSγBIP\9-9Ѽ(_~oߦ ,^J0PBIcځ4=Iصx\ݽN}w!#(MQ^^䐔l?^8 MLt'?!VJ@7nmۖBݎ<+\hӦ5EPE5f̘d0hB %: _9 AIq_Hؙ Ɣv7RoEA (*vDΞ%G`NڴiFP|(/@/UZZi8hӧOg̘ 48qbBB^`RJh4WwP?z7V(y<;wCn֢t*+3"%BP&Cɗ/)@{k'FE<9`N4Ƹ0/Czڴ1$pҭ[G`BqaѫGGGW=u^`RJh4+a4CeF-~\]XK.JFtt."!!ib0tb@Wv[5JNx%%ի3?EhG21k̂UO^UWWZ ftz988/E{jpy\\|}&% %Wes5OHCN="apomlL$%CXCYH2۪)Pr(bbm>~r8;Oۛ-n8 ~wDW0`@^^ݾ.\gl1 O^&ǝح]bW'NFlQL!&P`>ljXcoa.}۷ >>N‥j9 %?8()I 6:/ C*66 4A/լPRUUPp&萗E֊ rk3PRSؘoՋ|2a(^UTTMPz? ,^s.fPSn{"oa1g7o~?`|4yyH J>|H2Dʕ;Ǐe1o2V$x"Es`J#nA`m+kDQCutȻXbrh(t(C{_J0`a(1}>/_N/Çϝ;n/x)vibϭajE$ٽ{1t OJzVGd(!H %**UUY{|6M$y3f ]G"6m̙hr4oog❉ [%/cJ0ݻ4ᠨ(;;;up }C'y_ I. SQqrD# zU99K.ASӧ2[7Ů];%%Exz: Ln-&ڻn*B &&erh\֍.[$2cac F0npXqʮS_~eg^3Ǝw||Ar*U";I+rrr233̙COs$c] '4\ڭӪ"!M͒%_W`ЫWз[|r w4c_oۆ!&&ήTjD|xN%.l֭ΏEv(o@tؑ6{|Kzyy97blJ0l=d7-dM|HLȗ;wMuu5)!!=ڵk Mp܌a>ɽg϶Ĺ&^+aW˖Ǐv;}Ll>1Tݻ nVVB֛7ڵeFի۬_?޽4];wFgd*ӈPBqe7nܟ)̇(QtGzxx9Q.p/_ht.qa~]g I %kN8.^L?wP?lƍ)kA(3}#G)/(a'Mꏂ%m_~I_UNxo*I|8X|y tXN^^-[t/oOt (33W޾WgW~(d̘lZ2AvaO>NUzҠH;{w^DR<~|gxOݡCYBd];88TWDxQDk׮oRRRZZ9uꔭu/… 6u/r](ٿ_aܸSVVyy%, Jm ~oCxx4zDNÇP9R(% Z|VVxD 4DׯC!CK:˗ԩ^D?QۦCfN~]9\] G7֭}5kVQSܹsš[Vf_[$-||^Ȉuww ]<>=A:ӧ)EP␛?#1o޼;wr?Z{A%OPD cNQYWr^xqRe3r=˔UrICPЫW>}lݺaÆyyyN[YY9QB/pK $J>4DFFVVYf={9rܹsO~ĉ wEe9a`P+?E(R$J |]xu QBf)%zqb"A(!JB|XxAoO#KnJ(!K(!SB&xyDE L QB&ݻqt+W/_ ^uځÇ?}z+x!)bd4)Jxqr}Vs좤N^^njE֜:G(9sf:Cxgf"E , J:e "4yqr ER?,QA#?ȮGW$kTSMutijZ2cr׮>f¦ oN9wq yyt)_޴Fʳf Ay84Ī,YAD &v?ѽK%CI%PÇWd1qRLN.J *HC|xy)+?o&Hq>Vo\HְeKTVw&/ozP/ppP84 %1@+Qow DAG<~|[oR?Qm[ţ??9ҳ d޽4 srZZI3N( ɾqQ"Y3fRRf98Jrdf E ,x7g7r(. ڵBf/v(/NU՝ǝ5*c_w <Ŋq=zKqskP}U6}"IATB=3˛"j̙3LM6W]׷ k1K(tA(|()ܻw^˖j.Y5`Hf2rQ婩SOTS-fjHHNyf? *\E wB J$k@@4%ʰaCs`p (bMHf R MCW9%.iiBG F ܸ EIXm46O\@;2Q_H2OM](ItO.ի=\灃Ḃ$Jӊ˟8d&'OC&HFyyqqS1&P(4h`JAkÆ0r:ggdUVDD Pk9K<AXdf"E ,ǜǀN'+ފ%yo1aB_mDIT`{X>%p{Ȗqׯ;BoW%[5k&# Q;=C"D1{م ;ommp|'BQ2jTU&##lޞwˆ[Vn㭸8@Z-; 1ĉs6k8RG^=飏^Ŝ?(D/;~|sƍAׯocfV?聫ai fS<'N dA04B17qB"E ,;%"vefH(u? (4ۈ=< EwsV_}ՓZ~8thB;QPNR݃\́aƐ;M8"d3ge rP~ݝ`s>)44c*O jR5Wdun-]ڈ,ThddAUNȄCx(aİA wژO z9GY(̐Aߴk:q1 E ԙ40(G9ɳ@CM3QA.%o5S*X;A,J$ ,43gAf [TS]|lZb7.l.)LMB{q7bbq E ,JLM_t S$T1((~=ⲲV^ܺϯ-Zu||Ԅ DxUY:;{TlĢD ‚ w;g{y-[6F%& 'MI 7n@!_(!)bd+HZ8>=>kP>Yqz(D 7THrB 6(ٻwYM"NU'J LMB$xq2""a,ͽ\HKf@BթSiesJ!;P!}_JHCl9;בB QB,8"A()H ;;S!(ܽZ$dn*Ϟe2ϴ*Vtwx#*(bd)!JBX8Gq[/GN^9qVw硢KJ6Ȱvk񚙝gĈ^\7P}\T  VJ1D Qbǿԧ'&?|)M.kRȮ8L,[6&6v|TU+b3%eVW;2ǾO(YU&2nQTA$JҤ(>>wq_; X_tx ;z3 =%K3f`s.l3&&ͭAN^^TÆxZCVNR/_rveKS ,WdD۬׻gvv||Z;=: AjԨ^PZ_eC6(bX%X*w (>IdFӼ~uߺLtDIDGk¾< :^;;{6ʱO&%J1Qvm]J(dd! dQ=xak['d&&@g϶_@7 aDyvMh($WM^on^g A l:g0ap'//7^C`Fhㅕ"*09 ԭ1 +؄A KgZu>bce#mUGӦ |82䊆bB%_l1{|4 DRLX];w[թSȰCfKACvvaC샃}ĿoD ¸vd̘hhhR MCיBQEɪU7'lO'$D򲸄[Y/U(…#+5b@\0 FGaQQի!yF/& %ᇃSK)G|)q=W q_yܜ{hIWXvWdżrh#?QERL`+( 1M`ĉoq|i 6MC(l4h`_Q_I /11Ɋ䭽P\1,M埕%vx,3q"} ,J;b?x>ݙ=0f/Ifͫp fzlB 'f/6Cx 8|: 춰Fc#G獲{{ nZX+..mіp B 1#J.S 2%eԹtܢ|WhNm4.Gǚ_~l 鑙RωJL<paNB3NN}Y%6ۆM4y7%E ,$Jű7H`3&5lP>Qzk/%"T\FDԩ]M.f}-| 戎2kթS>ի}n& $)%R۷D^laanݔSpԽ{i+9r$;nAx=O胰W~nբ Kw[p$[Xxܸtl%؅LJ ΣGC(VD%S|fA4rTB(yeaqwM-%JL|y Nh [݂K)5}քIqGR$%bddȇ"Ł1@@5!%6*"]ݻ~}{]*_V(vZϟ?Bh4;hUl u"6((};A1(R('# ?sJ$ ,,-X&QEa?6 5P3"QtV!"`l͝4Ad2 18(Q(&gso})l~# Tgd(&F)b)#ئbBY(̐FE E .~1r䣏Tbwg16.HjS ~u:\ o0vrL`s|K\KxCCs6EZ|:5TbPãBy*do5e 9bP={e7l훯I %S1] 66bQr>++s?\c8104OXg6m(K4G͚U4#JsJ!KvW6bQ"i&\d^^n-P v8p##Ü5<=x7vxH!F@cʕk~O'A~fBF:E% l EO?mrvcoo+ !+4좞<̬ܝ;hͽ˗-WΘ0 %("(N@JxdDDpÆYqtI| ģ:ulNIRR4d*dOK=0^UBD H d[FRܬPk׮,:9*]W5׃ #B3``_X*(iEBh]%H 6 nٺu:@#6˗(:T(` [t uuuv($JIYPp}e 2M!=:;>>ZR1c\z#(>>N?R Ȃ(Jb;!4ԯn];%(] 8H %J%C`(ED gɓ \/c)bd)!JB|\>=s=EɅ 7 ?LR %DiR?諏?~"$GvM Ξ]1l:ٖMOIӷ6lX{Ŋqղ+_ܽ{_2Q}̘Pd>yr-.vAR^xyݼ߿]׮-5}}^fiڹs6:S]Zb\DY@(M 1}k'E\Q+6vܹBCUbx[D76olGY6`@^ _Q¾Dٳ'LLJС٬YC!2so``.]Z+D _?T"Ac`7s%BA_E F뾐`;lee Qr J  d۶萐8zčGO4o>|h(RԪeDVV]%4: 1@+Qow D?HY4|:BA_E dGpo:ɓcvpuuQ(H[լYEOQrnZvdOʛ1~~myu;$##9(_txHLxAK峛י-qpnk[B&M1&A)c$Ujmjln|xl̬dx1}(v 9: gLԯo_vՆ k,oQB-)bdA>攴_?\t:YV6ƕظ .//С%l1^saWGjD>rdY~(ۻgll,ukVc8@-O!F@XxADI8 lƤFMcC7BoJ6r[h.X$%E-޿qfK1Q2cFţ7n W%5g(ܹ k(<;.[Eɼy%ܾ}f2F̕+&MJQ޽4&wΜYH}ZCCA{BBzt쮮[Dh>Oleq1LJ - 11H 1@@5!%f~fp{{[\t!%%ۃ7mav1QǧW_T%H>JwrQ2vGG4qlܸ8s֙(4ۈ=<i~|a݃^ѹ;3˗֭} S"iaaii2+'Z~ǏBm@jJn؍P~Y5*422P߼~U} 1(!)bdV2kLj3C*jBOMc2/&uoΟ=ۥ Kxu՝Xyyɳ@_6CI^9%+K>=!e7$*TI3 > ̙u*)siiʻ,|/pSB.]}Vdj:K"36u`K EmDɭ[򉮕+[LJ 'LQGE n{I3%;wr [l %&hHTcFF8Ξnȍ%z >N$')bd+Hp fYff9 4\A`;*ވ8>=.% lrQw<4iSjF ۶E%[,J^&(N@JxdDDpÆYq7rQ"i/QUN56)IJƏ ~g# q\ 1(!)bdlkTti#\k֬^ӫ N\D 6n W%7k$N֭-/##ZlZw %66/ԉ0&&ήۻ9~t?KAA( 3Tx.t4p7b QB,N,oTn G.,ׁ¹'_'+P[s>++a.,`HC E ,$J84>yYnϞeΚ5%E b_*CfTzj~I7Y>, nđm9>/+UC8d,vKh%c/,eY DW nn ֬N?sV,ǏvЌً.\Ckk WWEI\TGǚe?w߭eǎpww0d/ o7wSjDVɑ#0BS'wb!ENY9%׏NV%%ll\FK\#fѢQܱ#L~ڄ UN^ NZ]fFȈEak}uq.DM"&L>K J@*_6,v"ݒ0jToP{{"Xv֊8MіbDI'saMɅH`SPNĆo>N gr%dݺ)ׯLz`{i, 94044EK7d!|3^9rz }Xq_bk'߹sK vqsFFaa_=w˖-\ءB+$MwYڶm,tmfR M${^{|6cR#! eL E֭?fdykWU9}'OR({j6iR nifVƍH`>}<7lS(h>L8 =Q"%3f,^ "*Y!*X9 K|;I N Ȩ]cJ]&J 6bD/FFLMmI~ٲ15 J0vs:vt۶'aKb\Bq9Ow5իqaq(nӊz*ވAMb!C-ʖ.mM*H177#6v|N8.5)|PFޑO#ӱL񉝙Kcمu8'NN>-cS¸J-] DFDA sxq2""?OݼؒfڋG'8Q{hG6+gϛ6/xͩ܌ʕD+++s7maBQ1@CԈT$w}YvU .y iD Z0yـjlNFJh߸q=6Q,J.^L>="J;Ç 'Y<(Բ9%II6*dOR9{v=auҐBA[UU+gE C*Nl0&&ήN˗Lhҥnoʹ%xC3fcg, qp9ۅS%`PPgؗcJ'fyg"*(b^^w/r,"Bove+W-,L֭rz G3gֱfC9;#BMQ6*[Dh0*ch ܝ-, 3mۘEyKRE $Jű7H`3Fy񍲐ą_{Ϋ]ʹ;yr ȋҥpCpf,%A E wD]BA(F~klݺu:_ph;ys˗1%b1uE k ưU񇭒f8KK3 trč+T"hT2D<~|G͕*Yc(xa:Nb #E ;%"vefH(u? ԹA\f͜T-Ӯ]S@~fp{{[\2QMRw>)GW,Jj tO,qs>22x.Ҕ) P婩Sٲ+sbEff<>ҥD>vĈ^B=U$VI3xFˊQP|ش1ߋrb IU"^QE JXFwI`fH`S@C\ժU'Ld'=%0ߛ2ظ PCY.JQBPPwqtE 1 >nE\Ao T1Xt wڮY% stP$WԯoO5s,"~ʈws70xe#VI3ᚔ[_O(E"Qu!b^^n~tAB՝XOO?(Hb =ĵV8#//Nj7G*ވg6m(,MxBQr>++s?ZNt-qGW6׶R:gsr?jɰa}!%8qV=0g:8Nd{~kQ͛{%Vx AVV‹'#"$VVI3uފ^+F%CDnnFnl{› ϥx0O^P9};"AFhy1DW+oծ]AAz~޸B(A)8[dd0s瀆BQPN(&%3ٷqtE 1u>ng>"SlP(Q(o`/ĉo?jܸC3f?~!"/]>%.!ĄU^en\yk3?-F%CԹ}OxhB@*vm_XYZ=ztiP y־ţqrWXoy\j1 j֬^PVE@.4kE LmV#I!F-VKRlK:7W(Ͱᄐȁd"Ƽ*fbn]č#F\4/]1r(p(bdA-&!sr{e bqtH 1×/Oyx4]ܹ ~flu?cAJp=#I!F@>33WPE11s06KJ֦,,7)bd<$<|P)OJ! /J(!)bd)!JB|XxA$JҤ ')bd4)ljGY@(M 1"E`K'8A4EB @ t(Rt@ E %Di(!BD Q$JP((QTkR>I[ $JP((i# !'0H@ EA%'ss3=3ń$JPĐG777˗73gMￏ[._WJ_6R&&,_^(5UYȑeylޞw֭խ[x+..˛۷SYfN/`霜UVK%@(bh%J?q̞ kbO.DN\׷oY_r%dݺ)ׯ@%xy޽4Cy9=4ჲ](ٲ%E Yp$ʢqбC`cnn :݇A'xm6Ȉչ&9InQ2j<#[DІM!Gȟ?3|yln9%ff,ɩ:QQ H \ՍQtiYFF7wz DcMq š}$JPx(1 L~xkMdEIf/]J|81!(4`ϜYW^ usii=<)wY\]^HL`jZJk?HA:DO&MsMs(!BݢnđvSr,bbQ"5ۻ9Kgg10xe#%f\S9-4oٲ1LXX!^idds4%e/r/O]R>}>ٹS-VV—6u<}z5I@ E &[UU+gE C*D jbblgW Rm,ۻyF[Nhf%`PP_^eQ ;` ].F]]Nen1*//ѣ#::'@ 1}%xĮ`${yÕΝ* ;>>ZR1{J+6ExtBB$O$QB ">|܆Purs3X.;)FnJ˖ׯIz"&&ߒy۩IIp||fJJL$JPQB, (!BD Q$JP QB&@ 1HI@ ER@A@ $J@  (!P,7XmʦIENDB`java-design-patterns-1.16.0/flyweight/pom.xml000066400000000000000000000033621312550536300211530ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 flyweight junit junit test java-design-patterns-1.16.0/flyweight/src/000077500000000000000000000000001312550536300204215ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/main/000077500000000000000000000000001312550536300213455ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/main/java/000077500000000000000000000000001312550536300222665ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/main/java/com/000077500000000000000000000000001312550536300230445ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300246745ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/000077500000000000000000000000001312550536300266765ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java000066400000000000000000000065161312550536300323140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.Collections; import java.util.List; /** * * AlchemistShop holds potions on its shelves. It uses PotionFactory to provide the potions. * */ public class AlchemistShop { private static final Logger LOGGER = LoggerFactory.getLogger(AlchemistShop.class); private List topShelf; private List bottomShelf; /** * Constructor */ public AlchemistShop() { topShelf = new ArrayList<>(); bottomShelf = new ArrayList<>(); fillShelves(); } private void fillShelves() { PotionFactory factory = new PotionFactory(); topShelf.add(factory.createPotion(PotionType.INVISIBILITY)); topShelf.add(factory.createPotion(PotionType.INVISIBILITY)); topShelf.add(factory.createPotion(PotionType.STRENGTH)); topShelf.add(factory.createPotion(PotionType.HEALING)); topShelf.add(factory.createPotion(PotionType.INVISIBILITY)); topShelf.add(factory.createPotion(PotionType.STRENGTH)); topShelf.add(factory.createPotion(PotionType.HEALING)); topShelf.add(factory.createPotion(PotionType.HEALING)); bottomShelf.add(factory.createPotion(PotionType.POISON)); bottomShelf.add(factory.createPotion(PotionType.POISON)); bottomShelf.add(factory.createPotion(PotionType.POISON)); bottomShelf.add(factory.createPotion(PotionType.HOLY_WATER)); bottomShelf.add(factory.createPotion(PotionType.HOLY_WATER)); } /** * Get a read-only list of all the items on the top shelf * * @return The top shelf potions */ public final List getTopShelf() { return Collections.unmodifiableList(this.topShelf); } /** * Get a read-only list of all the items on the bottom shelf * * @return The bottom shelf potions */ public final List getBottomShelf() { return Collections.unmodifiableList(this.bottomShelf); } /** * Enumerate potions */ public void enumerate() { LOGGER.info("Enumerating top shelf potions\n"); for (Potion p : topShelf) { p.drink(); } LOGGER.info("Enumerating bottom shelf potions\n"); for (Potion p : bottomShelf) { p.drink(); } } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/App.java000066400000000000000000000040161312550536300302620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; /** * * Flyweight pattern is useful when the program needs a huge amount of objects. It provides means to * decrease resource usage by sharing object instances. *

* In this example {@link AlchemistShop} has great amount of potions on its shelves. To fill the * shelves {@link AlchemistShop} uses {@link PotionFactory} (which represents the Flyweight in this * example). Internally {@link PotionFactory} holds a map of the potions and lazily creates new ones * when requested. *

* To enable safe sharing, between clients and threads, Flyweight objects must be immutable. * Flyweight objects are by definition value objects. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { AlchemistShop alchemistShop = new AlchemistShop(); alchemistShop.enumerate(); } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java000066400000000000000000000027641312550536300323120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * HealingPotion * */ public class HealingPotion implements Potion { private static final Logger LOGGER = LoggerFactory.getLogger(HealingPotion.class); @Override public void drink() { LOGGER.info("You feel healed. (Potion={})", System.identityHashCode(this)); } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java000066400000000000000000000027731312550536300326610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * HolyWaterPotion * */ public class HolyWaterPotion implements Potion { private static final Logger LOGGER = LoggerFactory.getLogger(HolyWaterPotion.class); @Override public void drink() { LOGGER.info("You feel blessed. (Potion={})", System.identityHashCode(this)); } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java000066400000000000000000000030101312550536300334020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * InvisibilityPotion * */ public class InvisibilityPotion implements Potion { private static final Logger LOGGER = LoggerFactory.getLogger(InvisibilityPotion.class); @Override public void drink() { LOGGER.info("You become invisible. (Potion={})", System.identityHashCode(this)); } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java000066400000000000000000000027711312550536300322100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * PoisonPotion * */ public class PoisonPotion implements Potion { private static final Logger LOGGER = LoggerFactory.getLogger(PoisonPotion.class); @Override public void drink() { LOGGER.info("Urgh! This is poisonous. (Potion={})", System.identityHashCode(this)); } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java000066400000000000000000000024221312550536300310110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; /** * * Interface for Potions. * */ public interface Potion { void drink(); } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java000066400000000000000000000046671312550536300323560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import java.util.EnumMap; import java.util.Map; /** * * PotionFactory is the Flyweight in this example. It minimizes memory use by sharing object * instances. It holds a map of potion instances and new potions are created only when none of the * type already exists. * */ public class PotionFactory { private final Map potions; public PotionFactory() { potions = new EnumMap<>(PotionType.class); } Potion createPotion(PotionType type) { Potion potion = potions.get(type); if (potion == null) { switch (type) { case HEALING: potion = new HealingPotion(); potions.put(type, potion); break; case HOLY_WATER: potion = new HolyWaterPotion(); potions.put(type, potion); break; case INVISIBILITY: potion = new InvisibilityPotion(); potions.put(type, potion); break; case POISON: potion = new PoisonPotion(); potions.put(type, potion); break; case STRENGTH: potion = new StrengthPotion(); potions.put(type, potion); break; default: break; } } return potion; } } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java000066400000000000000000000024751312550536300316630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; /** * * Enumeration for potion types. * */ public enum PotionType { HEALING, INVISIBILITY, STRENGTH, HOLY_WATER, POISON } java-design-patterns-1.16.0/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java000066400000000000000000000027671312550536300325440ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * StrengthPotion * */ public class StrengthPotion implements Potion { private static final Logger LOGGER = LoggerFactory.getLogger(StrengthPotion.class); @Override public void drink() { LOGGER.info("You feel strong. (Potion={})", System.identityHashCode(this)); } } java-design-patterns-1.16.0/flyweight/src/test/000077500000000000000000000000001312550536300214005ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/test/java/000077500000000000000000000000001312550536300223215ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/test/java/com/000077500000000000000000000000001312550536300230775ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247275ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/test/java/com/iluwatar/flyweight/000077500000000000000000000000001312550536300267315ustar00rootroot00000000000000java-design-patterns-1.16.0/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java000066400000000000000000000041441312550536300332020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.junit.Test; import java.util.ArrayList; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/12/15 - 10:54 PM * * @author Jeroen Meulemeester */ public class AlchemistShopTest { @Test public void testShop() throws Exception { final AlchemistShop shop = new AlchemistShop(); final List bottomShelf = shop.getBottomShelf(); assertNotNull(bottomShelf); assertEquals(5, bottomShelf.size()); final List topShelf = shop.getTopShelf(); assertNotNull(topShelf); assertEquals(8, topShelf.size()); final List allPotions = new ArrayList<>(); allPotions.addAll(topShelf); allPotions.addAll(bottomShelf); // There are 13 potion instances, but only 5 unique instance types assertEquals(13, allPotions.size()); assertEquals(5, allPotions.stream().map(System::identityHashCode).distinct().count()); } } java-design-patterns-1.16.0/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java000066400000000000000000000024761312550536300311650ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.flyweight; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/front-controller/000077500000000000000000000000001312550536300211415ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/README.md000066400000000000000000000025171312550536300224250ustar00rootroot00000000000000--- layout: pattern title: Front Controller folder: front-controller permalink: /patterns/front-controller/ pumlid: PSlB3OGm303HLfO24j-t6nCC13bEvC_IFk6yjz6JPgbIE3OAvS_fFkmBe7Zde_ePQnXfwU8adajlK3bkT5Iuy8Tf8wk7f87kf6BGq6R0hlD8xwQTUG9v-SCSslA8nWy0 categories: Presentation Tier tags: - Java - Difficulty-Intermediate --- ## Intent Introduce a common handler for all requests for a web site. This way we can encapsulate common functionality such as security, internationalization, routing and logging in a single place. ![alt text](./etc/front-controller.png "Front Controller") ## Applicability Use the Front Controller pattern when * you want to encapsulate common request handling functionality in single place * you want to implements dynamic request handling i.e. change routing without modifying code * make web server configuration portable, you only need to register the handler web server specific way ## Real world examples * [Apache Struts](https://struts.apache.org/) ## Credits * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) * [Presentation Tier Patterns](http://www.javagyan.com/tutorials/corej2eepatterns/presentation-tier-patterns) * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) java-design-patterns-1.16.0/front-controller/etc/000077500000000000000000000000001312550536300217145ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/etc/front-controller.png000066400000000000000000000660301312550536300257400ustar00rootroot00000000000000PNG  IHDRCkIDATxml$y0A 'l͋rur82t"t>6BqG҆\ٲ80Ƣ,O-mJٱb`l&\\prD>jgS]U]:bGP~ Ђ^&s-hGFQA@ZQᨠQE-pT("qT{K\, Rzq GsT}juWQiE-d:nXo*kzsZ8*0G괕%kwREjV,V&9 1`דwI(Ӟ[2ؠjaɄ?K[#AZ;*(=cw0bY{=E G)dh0^nuSwsNm5qT`h@ GF6L]31}_ %ʤ;*hUOR~Nʹ-[s@Z(*Ҏ ,N߸lt۲щIuT Y)-WCUUP)ۤ l-h!T+uu{J-3Rvlʷc먒N~T0ޠE-8*7 ;!=Ao'o (RGT*xKVƻGTmg"2ՠtwiwW%C&2ij~Sw?t~es@Z(h@ 8*4  Z G-hGFQA@ZQᨠQE-vߛxǗbYਠ E-T>?F{^\yneF {q_͜٤Q9E-T쨄mz'__xr ,ֈlL\;D{gG0*h@ U:߻nRK}#|xUʻ5RҬyI!pT`h@ U:s=|;/x݁oq^\˻3ʩ VʭЊN+7fP]~=rpw/wD(wm琜&%Rӊq][o=QA@ZQ=sw>s};Xwu÷H''9x`%]:9w}ĨᨠaE-T\G5og^/|G,먤X;dq\ou{=לUګGP\y3_;gtIJX#-]ȻT/ɵJ7s\ZM~8*0 *{ŏ~b}ī~UJ9ԱN[% V3׮GFPxToGzU{n|I|ש5/LsT^oo^Q -h!Q\מ _E1ae\:sVРltǺ]qG{FNhzB${MKJ(?:.8*4Gu?~緟WLxm}wTRMOX77@Dߢ%{#Z_\# ?=[g#.8*4GGg^9sճ^ΊxU֖.9U8 FnUMIk,{* -h!Q[~nK8q++%QykI*\#%l (nԎʯ#ou -h!QE+u{JZ=ꨠE-dL{z+|X&dQQ-!]57R8d?sE?*GOGĂH.~֯x=oʊYij~zxe?.8*gILf>Q8*0qqTAt)􍙎kAZG5)UE0 GFPjb<33w{}}}wwsGU5jmmkt +pT8*qO9a]A-01hFdhOOOz=㮠bpT峵|`ffmu(\zujj*04@illl#G;?wyg{4VK8wdDv'O\^^lQ qUBfgg暙ko SRbګrQAQZݞpBM\= 9"Xw6Pzզvvv%h8*!eqmcaaass3Y&L;_PznnLIsNwy'}@^=z2x J5,ֽ;vJ*OO݃0^v3jʊ+DHcDž fggʵX `G+ܝr=7"aۉ?>}LpT133\?555U Gw`bbb.c*|@Y#m0ɴ gssnV#ױ;e K{ P8*鈋\ϡ%c1fuX `Nrg#wql J4SG|}q*k00@.C^&/0TI}`ԡ 8*lnn9r$!=1S8TVh#BpbP%``aY__ @*۶^_c5%c`aqPYCHԩS(Vr 9Rnփ[|tpT PPuA\z}qn6pX<7   !0AN*Yg Cspp8 uT,,,Ć%pQx?%*LP&tPG*  #GyC;3\Q Upf&&&bŭj4}ZPG5nc64qk۶,MG ԩSs7 "-ʪFV.* .Խ#P)x~fff6d :zuT lmakǏ3'`CQ,//OMMսuT㎮^^@Z <OE ? sq:WY Ow@>JpT` WQU[YX@9CUUe=h ~<Z 8h#]3[P&fff?^n*R䄣B*ZW?OJ0G-f]H.9YH UԖO< J0G-&sԩǏro꒓U06.22|KN)HjZ쬸yPBj/vvv=6KNv*vHjۇW\uePZƔ"V!d"꥜nmtV5~6v麼5L#F"%' P &\+FqHjUrGe6Ulnn[acI>u~EBfRgN/sj^y$f{i/|IMܦНC^Fh z+H># G`.)IVZnɳ^5;<QXEu4O=_W[uu{njK-h Q^Y+իW ohڠHLMMKI@hɧi"4y~&L=u7aIYבҢ=ӫuO+#Ez0!:UnDtA۬(/KnG6 X^^N'|+@C^G)#:|C*DI۸rܦ@Xy,0{t]'%' +(ɓA[9KN(@ $iR H.9H-JjPKeUH.9H-JjPK "@R+J@-If(T KN(@ $iR1H.9H-LjW^ߺ}d'bMei)SZ4BGuOԶ{x |홛hp(ڑ/TSUs8Ғi({7k!Eݶ:XR(QrY *dP$:*~w~/7{zyE\JIc㨆&aNey iur>2>JXR(,9Iu#MTֹ;9H-d;+o߿F/?$ y>&]I&*=FƔ0w~K5%HbU*j) c37+)eP${Zo}-W;_suoGū{|ɫtMB5rˑtۗ,^#Iy}W&z)o)ȘF:KX,( 绍Nb6ع TxTK)\pLL1%t֯G4:5R"tT7qOYQˍQa 飯j)B?XڒRG9M>WJ1*FOvzi~Lu Eha褦҇AĽ 79%5Mg?EʛMWWU[y,QƨH>u Eha*\hNj^>rz+#iWTi+Ue9k!j)O]rBZD'1uKѻYt)wtm$Uc\Ge6R %' B]ԐҕaԤ&q:.^АH{SSdU>%j6R %' d$̻C7g9)lLI^ RPo4aZJɍ@)rQhmbMPK "@R+J@-If(T KN(@ $iR1H.9H-9tk4aZJɍ=̥mbMPK "@R+J@-If(T KN(@ $÷n~??}2I4Pj$WP$'鯿Mg+X={R3 Z*%' aX'5@ b\]rBZ(ڊ{z狍bg5qV?nu$_KR3.o 伡PY*R-P͵ZǺ{530L \ U#6WYWpb#fE,5+E`"'N} DiTK)WZ37M~f G`.I'~;ypQ%" ]`^Yy,Yk#@2IEVIN:iD!*d$>;|;9bA+oPb/:mP^>ۆ+nWoJe%SjdtnU{^^Ww! p,KKU5Pj OS9eݹJY1#ئ9*R-PHrqrx~D7W$Ӄ G`.iI o?yX)G^TyD .Ñ˳b´&~Ju*n{}a^q#BJȺ`%~Jp 2}cj*vQj)BK*'P`Z‰H ``jQKZR{#39Y/zgſbeXvU$$S-DRZ'JedssxIԠDh+ L>JWȥŻ& 娌Qj)B.TN+5;eԄ0o.=WL$ GVIOTKneΞ~DVQ%)VR9dͺ{sTJB!yiڦID0vןKϽxOĔ'gߒ^cp~ Q+vo6YH 5|W(YR(9BJNJ='*%5osS_{ܙ xUj?vvXhUgXtSGBJpMOhJ&U_;&S- |\Qz"+R E$$LtNRJ&d$5^XPPLo%RxpI<|F^O_BJNY?."r@!ow)wR'~͓iTK)\wyzdԄ0fM0@ SBzDsTdZJ0ɍpTҘƘ0L &:*L/$7QKsZ8L i3(*R-`CT8*s!V^#Qj$WP$Hju%5@ b\]rBZ ՕL%Aru EhVWR3 Z*%' Z]I4Pj$WP$Kj'MDLbb=`=+(a% +R H"P~R+-҆>J(XR@r#|d'7p' %rA>J(XR@r#|d$>;|;9bA(L֙STX9S{JL.6%jfviH5[?\dҤk$JA yJ+H-%[/,>ſbeX83m,I7[m;mP oQSI.BΨzwi5%U\]Eh!-WΜ}_2R,Rݝ*% MOn +JkJid~*K(a% +R H"w?xߥ_񬑕ԼUfIK%[ºz<9HC>4FPBR-J>(@ iIG?繗N{c/ ׯ͋bn% ș}F꾐ER<vh(:ArQXEFзwrNoLfW9CE>}BD+>+CA3+iQU Ud$5^XPݥ܏۴:on·]GݗVU,x&\/mߥIH0j)$WWAZNj"~n`$ju 3 FR1H.9H-KR Jo*iR1H.9H-ARO&W[-a5%Aru EhfCXyD b\]rBZ ՕL%Aru EhVWR3 Z*%' 7`HAJЄj)$7 G,ߺwmV Y\s5o;Ɓ6@+ G d-S@& G S_ah Q4q_,)° JCh =Xw0,h|rF^NmV#0@#C{a(h9Q؏|(c"mV%0m⡥wZipTsq%`%֋W)0ZipTCMA( q}E@hrWZ[`67Pbm"mV (8*am"mV qݕ6@+v JM" ЊQG8M" ЊQ42@hn@ݷPZ[`8*ݷPZ[`8*awW(-0(66@+v GP@66@+v G8E@fw%v&Bhnhv&Bhn]hblnD(-0@QpTD(-0@㰻+mV }E@( q}E@hvwe" ЊohbpTEQ4ohbpT PZ[`67Pbm"mV (8*am"mV qݕ6@+v JM" ЊQ%tTSS? D(-Q hYݾnjHmV0%ݷPZ[`8*”Q"L Ue}E@"L Uep! Z[`tT{K\mtV5~a/(M" ЊQVn7U8aGMoe:K6:VrǺ{}pl3pTam"mViZɳ^6:%.|++HUvRkUL|P1 Uep! Z[`c+vˍ{un(˾u91E,=h{R*SFd1QUkVIQXHx'IMDaʴ-\oaT.9*4YcF;V,vorg\|~ce6QG$j#*G f^g`U)2'\}jԐ>.+ M>&?8VfΊwF»Dqle7]WD0FyfQөɎ}>xݹ;z;>J~t{T 3Vu>4G%Wkᨪz<5r~{cݞR>%}5>( efW]t]i  RUƚ׏[o~wOgeO<8D3UmӯZw5DԎ*#Bޑn#؈ʕy?|xU*<۹;oO*)#|6"_Ge]U)'S9Lƕl$6EY2B$=TC Cce:tL[ջo[2swe8x ՙ8*0Qy"[-|/tC,_{&>ZR5WI2T'1L,G(VG[$f3l C5|ƥd[Q8*”0Q􋏼 k?Sț.qT2&x7**uTÈu4ŀ):<8K9~EᨆȜ]x9[/>+w_KKv01;VGT稆ȇ76 `U'u:sV(ը*;qT}jg>io X{/>*^}߳:*G譔 'gr/ioj>"7=y*;[ ؓX΍Oɝ@ԕ2fP223Wv_ɣ>፯;k5Gikbʬɯ#(`*=v:RQ|rPTUR,vٓ%d3-K{Ǧږ%iuڭCG.&Ve_xˍc[ dM~HYyWrb3(9by/ZR.7Id=݊Q)ZrY/NwEu9S7/hyɝ*j3ktč.e^^ }uT-}hxW"ܚўW?*ݛovdʹRyx9Wwo9qQ]p"qݕ*EGT1BfP,5kI' M9Gy8)<3VF޲:ϗNKQmv%S\G =ԛ =tzR=I0TK~pTUSyjw:I?yOz/zփWqTQ_䦷>|-w>yBbMJU@Gwi'˃a<{e?\N^tDݮgQDyxS׽¬C=!"!R/^P/T+=A4" daGEGԘwcuJsFlqz UJPuT)Qc3CR~sJ㧪 ˸iŝ)r4JjIݏgW3G޻ :L&oBB&R+GQ8*”КN[e)8M,3sc&P"&wFޫīUˏBF*R+IQ8*”КvwwT*#'ȚX}#篷2z~K_5!lpT<=TCu [7nK?㟾]F.WjMtSnEwrGF_5%lpT<=TuTVh{\/7ψ5*tI_e짆 &5q>NdDtޛ"czQQI'/@Xg:W.MFR˼;ts–:ɔt&0+[C472WpZE0C5T:4VJrTn(evU jQ' ̪O!SܿBU,{T㨈 GE8*(QEZE|Yx/:{汋3S-GEȁ"ʍQOwSb03]:&̿܅yW0F?Vgb2^jwwew9pTD1sW=!Ŀwʤa]dlnؼ!7TaUa7oz/hQl'6F#t1/Eڲ>pT8*Qza'8/+#ŒaU&)INɪiv)9~o8i|S DН^e}9pTD1z#39Y/zgſbeXFb G2+2h̵Ki(?(Q>wJnzzZH[GE97=~-w'ſbeXRz#G9W]i~m0.EdC_$lj11MŔ57"gdTg>;^:}ӏxZ,\6/VFqTBq3=X3RvG5B>S2%"#j3#̏PuT"޽Ƨ޿ʹ3_;%Ŀ2yUvØ {v;yɣ 6TXy"w"QЎJĽ>ꎞ r9%WM9{ȃQ~ObgF #pT8*QxTGE!(7pT:1ӋFCtg:p=ӉGHѢe 5@uG:*Q:GEȁ" ab"Q01Q% '̎:"17uTQ&X8鯿MX+XzGHL[+pT1FJzkǍȎ"13vT[? *mQB5c4*7<*iYPef&WG<fC˿e7" -9ZB&:C"GJq5JR* azlٳ&|M*7Q0H)9*'.{&6i2&" #V%+P)].nU!dĦQEVfi VEYzBsB8h{׈W,jZC9[/,>ſbH_&<NDmUxZHe|b坕f8*ۣ%XL7NvDn :ÈĨ1JMɝ`eŚvۻ $7uץ҆{?ʾ%=tuᧉ]ɀ<\ ^S3<dT>QR]R5=ZksTox}3g_=EWk{=+KFNCO\o1Z^Yy"rLTf&2ڛcʛġu|=vZq>Kʦ FL%*3UwuIG;U s眲^Xv-tg_)?kU!mMAy_})vUrNq0erZHٛ]W97=~-w'ſbeJT$2,U]NqT2Hw`*v_;%iv NpցJHV}|"JR~WfFv,G~1:şlw])yI+ʸ}*iIWoW䇟)r$ok2_ Į(Ro\iQR]{%x] N\|w{O?ipڼXv$R QGdJvuT)Ⱥ^*Ui>RaP{hJM!'ۀv7'h~WPS՝F^hk,hG[$gaJ(XG`Uᨆ.Ǵ4: űQx{z+|X 9wrʪۏ*J'+Q?7ʄc5mr}M=>5RGB!G;h,yA/虍KPl(Jgr]IYH=\#PGUBS6Wv8<TI])jhG%Ku jJR~QNO@J٠qg/8v2:>'/R4E0b*1tTş8.}ʬ!vAyRnq&PX=|~4IYPDnQ2"%ry1ό@ե"ׂCxU}Z7LW]QWa-4Fʳ:**-I`<*BG0u)EkJ&R*cuL$RFQ]t%#}TAe~բ C!E8Ga㨬RT"bQPW8*Q:RGE8*Q&8*BQnGE!(7pT"tGE8*Q:GEȁ" 4XrW3"2@_t֤;[26;n.;pTDȒP IFU2,U]ajuT VÔKc>NNV8RGC7 pT%pMÕR8*թlHpT53Q%fUhU|TS9·/N'/Y-AFRJcop \מ DGݹ λJdG~D,Iρݎ\lSiT+DbHj3#W]khG> 9Ěhج9+]O;"F5ujy"kiS2'JyWqAFfTM=CJC7.+&M}^X|~I?΋h1;]H|Ißz&GGKoٳ8FnGHK$v8*TgwTpQCnu)_50%@橖Cޥ#@j͐oUS>nH]VLH+gξz֋YX-9DWç]R ]7PQ}&K4G:4*t;*D2^"Q:sT7;#jKcXPdʚ%9U"-UMaQ<ߎ^0US)MtǏWYgQ%"QNwALy࠻)[f8*”h"abeW.,,LOOGEȁ" abtG$m9GEȁ" abt^okki-%mML"N."P |dES5#G2U`1ooo׽ԩSu `gggmm8*y yJ":–r?LHj:>#xKf uTW^=z()2?Ctg&;82xL4U6;\Ɉ!M>:H_6"-//:X~`T@VuTmFg3&G *1r/+G)7nņNT;#:*kee\rT~_xG7/7&eF.VAE~L,h7+E. SG٫.o:\_#dK1ٓr+{2)T;*_*G+sڀ&vwwgff Jq!/TRQ)7[U绪,*+?bS VpQ WGUQϟ ۆ˅_2qpQƎ|\2‡:֟YP>,&o0_G% qK.Ej_;Qw |/bnzaVͮ2NSY*l͎JpP8.ҳDXz7 <7JCi<*1ỊޛㅅwF`$GM%GiJ30accѣo;SSSuUp9;5֔VG&֦C u05US)NS+qT.\8tz3h2 S: ŦC{E1`dpT211A3݅,ꨪG9r{ QЩq/\D`|.pT)a z}6R@UeL233S6^&& q1zVEh}cc[[[V[? ָ8#uCU2깭G0:.svvj{Mc Iy[QTW𸓓TuTaQ;0U42׭>~<%#L; 4!n67ZvЈ>MOOommս# E\hzߧ3@CQE\wvv&.]=s=uT岽M?怣kSU tEiכ?p+KvC5lnn9r;;bee榁aweAeMMM!kF{GP.\.\0555OOOzFS6,2*Czq7 ƀ F@G9uꔲo{{ۜcS> @|s/4T;;;2Ӌ;xUiˮh``*ÇxX}A-]N<9U0`:~MH$. sQ J!]HB[a_sRi`qX__?zL0Z=cXTDx@uH, X#Y[L1F\b5}*͜l~N;<ϬUإ~av~kkki@^'ɟt:uNka.]S?S*aVifA,6ܦ@w25 `hlm$ GFrvvvܮ'OZpT("4wPǏD Z&&&tQA@DvwwI45ڭ^Yԭ:v= ѣGAKdpipT`hV'O,U[^:v7J[SAn*aɝVdNzٸYzߊʤ g=lw75z. OesvK&CTm3,giqT`$h BIbJje;,UhҞLrW2YqvxyO/yW;9DI6G8*0 ի(VZe86mgNH,x(Q&QF+z7|Cmvmm!zZBx)awvvecʮ7.ݶlteRU<~qJ˕PUT6[@yirrRu}cccffF^wT}C V:Ǻ=WQ);6۱uTIE?*o"Bjeeeqq17Q_ ) z;yA]=bepT[2ޥX?*wj<fyyOb9X/Cg:A>=*JLxe9*gT}g G qԩ`ЙCf$pT`h(;Nߕ+WpT8*hh4=~wjj GF s8尸8==?8*4 0 6]\G, Z G-hGFPQk{k7i/wŲXS1-pT`h@ Eg?H=|ϋ+| ,ֈ33=a?3gQE-쨄mz'__xr ,ֈ SY.Q E-樾cK/u_G=(u&ŠF-ha4GvpeOџ{g~ʕ5󉕑5r7?u`{+yWŕ̡< 3O '*ZsgQ0]~=rp7җ;s"BʻfAKn\Mؠ6fDqj]UT`AZQ=sw>s};nW;zTGrw?%-9>[vyee"!יyʫ7+%-h@ 9ui/Ͼ./|G,5+nTew98$ .Oj+"lW E-樺+W߾to~YwS.XkD³~Q G0{ߐW~(7I:ij~V?ߒQk˪J0o8*o"FsT"?gՏ>''nx5Z^\zo@UO60rM'rK~|EI)m=zBV?r\ `h@ Eա3ߧ}n1 L-h"pT0^E-pT("pT8*hh@ 8*4  Z G-hGFQA@Z0QG?eQA#AZ0Qi@8*h6h@ :`:`ξ`Κ\=}8*0dn|C>)8H^\?J|W :} ZBiJњxپ8uT{R}^pʩUrݛSgf;#UU=m8*02W X)Qyf뭌xRyWqT`h@ c_G帢NwNy5U6^Vd;AZҏ%)FuTRהo}T 7՟E_QE-_ʬr 㟖:I?乫[|~^8*1jGQA@ZQᨠQE-pT("pT8*hh@ 8*4 7@3 }5/6L«r͵K{8*h@ }:_gοX<Ǻ9ohpmoݞNQE2%J2Iݭo\~b'{{nVv>7orS:s8*4Gu?~緟WL8]_- JX[:8M~ T9V;V?[S{>.վ _ l-h!QWΜ}_2wUǔ|'lSMO]«x'w`O~b2=E-97=~-w'ſbe\H,%^a *d4*J6ʯU8N"Չ^s/>^<-_+Qj:*U$j"+oW8cݞR:*osS_{ܙ DUؽ)Rs(8*(I(pIENDB`java-design-patterns-1.16.0/front-controller/etc/front-controller.ucls000066400000000000000000000203721312550536300261210ustar00rootroot00000000000000 java-design-patterns-1.16.0/front-controller/etc/front-controller.urm.puml000066400000000000000000000020431312550536300267250ustar00rootroot00000000000000@startuml package com.iluwatar.front.controller { class App { + App() + main(args : String[]) {static} } class ArcherCommand { + ArcherCommand() + process() } class ArcherView { - LOGGER : Logger {static} + ArcherView() + display() } class CatapultCommand { + CatapultCommand() + process() } class CatapultView { - LOGGER : Logger {static} + CatapultView() + display() } interface Command { + process() {abstract} } class ErrorView { - LOGGER : Logger {static} + ErrorView() + display() } class FrontController { + FrontController() - getCommand(request : String) : Command - getCommandClass(request : String) : Class {static} + handleRequest(request : String) } class UnknownCommand { + UnknownCommand() + process() } interface View { + display() {abstract} } } ArcherCommand ..|> Command ArcherView ..|> View CatapultCommand ..|> Command CatapultView ..|> View ErrorView ..|> View UnknownCommand ..|> Command @endumljava-design-patterns-1.16.0/front-controller/pom.xml000066400000000000000000000035371312550536300224660ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 front-controller junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/front-controller/src/000077500000000000000000000000001312550536300217305ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/000077500000000000000000000000001312550536300226545ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/000077500000000000000000000000001312550536300235755ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/000077500000000000000000000000001312550536300243535ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300262035ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/000077500000000000000000000000001312550536300273335ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/000077500000000000000000000000001312550536300315165ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/App.java000066400000000000000000000046351312550536300331110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * The Front Controller is a presentation tier pattern. Essentially it defines a controller that * handles all requests for a web site. *

* The Front Controller pattern consolidates request handling through a single handler object ( * {@link FrontController}). This object can carry out the common the behavior such as * authorization, request logging and routing requests to corresponding views. *

* Typically the requests are mapped to command objects ({@link Command}) which then display the * correct view ({@link View}). *

* In this example we have implemented two views: {@link ArcherView} and {@link CatapultView}. These * are displayed by sending correct request to the {@link FrontController} object. For example, the * {@link ArcherView} gets displayed when {@link FrontController} receives request "Archer". When * the request is unknown, we display the error view ({@link ErrorView}). * */ public class App { /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { FrontController controller = new FrontController(); controller.handleRequest("Archer"); controller.handleRequest("Catapult"); controller.handleRequest("foobar"); } } ApplicationException.java000066400000000000000000000026041312550536300364260ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * Custom exception type * */ public class ApplicationException extends RuntimeException { private static final long serialVersionUID = 1L; public ApplicationException(Throwable cause) { super(cause); } } ArcherCommand.java000066400000000000000000000025051312550536300350070ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * Command for archers. * */ public class ArcherCommand implements Command { @Override public void process() { new ArcherView().display(); } } ArcherView.java000066400000000000000000000027221312550536300343440ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * View for archers. * */ public class ArcherView implements View { private static final Logger LOGGER = LoggerFactory.getLogger(ArcherView.class); @Override public void display() { LOGGER.info("Displaying archers"); } } CatapultCommand.java000066400000000000000000000025131312550536300353570ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * Command for catapults. * */ public class CatapultCommand implements Command { @Override public void process() { new CatapultView().display(); } } CatapultView.java000066400000000000000000000027301312550536300347140ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * View for catapults. * */ public class CatapultView implements View { private static final Logger LOGGER = LoggerFactory.getLogger(CatapultView.class); @Override public void display() { LOGGER.info("Displaying catapults"); } } Command.java000066400000000000000000000024351312550536300336640ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * Commands are the intermediary between requests and views. * */ public interface Command { void process(); } ErrorView.java000066400000000000000000000027051312550536300342320ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * View for errors. * */ public class ErrorView implements View { private static final Logger LOGGER = LoggerFactory.getLogger(ErrorView.class); @Override public void display() { LOGGER.error("Error 500"); } } FrontController.java000066400000000000000000000036701312550536300354440ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * FrontController is the handler class that takes in all the requests and renders the correct * response. * */ public class FrontController { public void handleRequest(String request) { Command command = getCommand(request); command.process(); } private Command getCommand(String request) { Class commandClass = getCommandClass(request); try { return (Command) commandClass.newInstance(); } catch (Exception e) { throw new ApplicationException(e); } } private static Class getCommandClass(String request) { Class result; try { result = Class.forName("com.iluwatar.front.controller." + request + "Command"); } catch (ClassNotFoundException e) { result = UnknownCommand.class; } return result; } } UnknownCommand.java000066400000000000000000000025471312550536300352500ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * Default command in case the mapping is not successful. * */ public class UnknownCommand implements Command { @Override public void process() { new ErrorView().display(); } } java-design-patterns-1.16.0/front-controller/src/main/java/com/iluwatar/front/controller/View.java000066400000000000000000000024251312550536300332760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; /** * * Views are the representations rendered for the user. * */ public interface View { void display(); } java-design-patterns-1.16.0/front-controller/src/test/000077500000000000000000000000001312550536300227075ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/000077500000000000000000000000001312550536300236305ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/000077500000000000000000000000001312550536300244065ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300262365ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/000077500000000000000000000000001312550536300273665ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/000077500000000000000000000000001312550536300315515ustar00rootroot00000000000000AppTest.java000066400000000000000000000025051312550536300337170ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } ApplicationExceptionTest.java000066400000000000000000000027771312550536300373340ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import static org.junit.Assert.assertSame; import org.junit.Test; /** * Date: 12/13/15 - 1:35 PM * * @author Jeroen Meulemeester */ public class ApplicationExceptionTest { @Test public void testCause() throws Exception { final Exception cause = new Exception(); assertSame(cause, new ApplicationException(cause).getCause()); } }CommandTest.java000066400000000000000000000057331312550536300345630ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import com.iluwatar.front.controller.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.ArrayList; import java.util.List; import static org.junit.Assert.assertEquals; /** * Date: 12/13/15 - 1:39 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class CommandTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } @Parameters public static List data() { final List parameters = new ArrayList<>(); parameters.add(new Object[]{"Archer", "Displaying archers"}); parameters.add(new Object[]{"Catapult", "Displaying catapults"}); parameters.add(new Object[]{"NonExistentCommand", "Error 500"}); return parameters; } /** * The view that's been tested */ private final String request; /** * The expected display message */ private final String displayMessage; /** * Create a new instance of the {@link CommandTest} with the given view and expected message * * @param request The request that's been tested * @param displayMessage The expected display message */ public CommandTest(final String request, final String displayMessage) { this.displayMessage = displayMessage; this.request = request; } @Test public void testDisplay() { final FrontController frontController = new FrontController(); assertEquals(0, appender.getLogSize()); frontController.handleRequest(request); assertEquals(displayMessage, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } FrontControllerTest.java000066400000000000000000000056701312550536300363410ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import com.iluwatar.front.controller.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.ArrayList; import java.util.List; import static org.junit.Assert.assertEquals; /** * Date: 12/13/15 - 1:39 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class FrontControllerTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } @Parameters public static List data() { final List parameters = new ArrayList<>(); parameters.add(new Object[]{new ArcherCommand(), "Displaying archers"}); parameters.add(new Object[]{new CatapultCommand(), "Displaying catapults"}); parameters.add(new Object[]{new UnknownCommand(), "Error 500"}); return parameters; } /** * The view that's been tested */ private final Command command; /** * The expected display message */ private final String displayMessage; /** * Create a new instance of the {@link FrontControllerTest} with the given view and expected message * * @param command The command that's been tested * @param displayMessage The expected display message */ public FrontControllerTest(final Command command, final String displayMessage) { this.displayMessage = displayMessage; this.command = command; } @Test public void testDisplay() { assertEquals(0, appender.getLogSize()); this.command.process(); assertEquals(displayMessage, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } ViewTest.java000066400000000000000000000055641312550536300341210ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller; import com.iluwatar.front.controller.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.ArrayList; import java.util.List; import static org.junit.Assert.assertEquals; /** * Date: 12/13/15 - 1:39 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class ViewTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } @Parameters public static List data() { final List parameters = new ArrayList<>(); parameters.add(new Object[]{new ArcherView(), "Displaying archers"}); parameters.add(new Object[]{new CatapultView(), "Displaying catapults"}); parameters.add(new Object[]{new ErrorView(), "Error 500"}); return parameters; } /** * The view that's been tested */ private final View view; /** * The expected display message */ private final String displayMessage; /** * Create a new instance of the {@link ViewTest} with the given view and expected message * * @param view The view that's been tested * @param displayMessage The expected display message */ public ViewTest(final View view, final String displayMessage) { this.displayMessage = displayMessage; this.view = view; } @Test public void testDisplay() { assertEquals(0, appender.getLogSize()); this.view.display(); assertEquals(displayMessage, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/utils/000077500000000000000000000000001312550536300327115ustar00rootroot00000000000000InMemoryAppender.java000066400000000000000000000036171312550536300367220ustar00rootroot00000000000000java-design-patterns-1.16.0/front-controller/src/test/java/com/iluwatar/front/controller/utils/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.front.controller.utils; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; /** * InMemory Log Appender Util. */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } public int getLogSize() { return log.size(); } } java-design-patterns-1.16.0/guarded-suspension/000077500000000000000000000000001312550536300214475ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/README.md000066400000000000000000000013111312550536300227220ustar00rootroot00000000000000--- layout: pattern title: Guarded Suspension folder: guarded-suspension permalink: /patterns/guarded-suspension/ pumlid: ROux3W8n30LxJW47IDnJxLLCOcMD4YVoXxq-eQTwev56UeSvgiVejmTBwL4fjDzFzsLF0CKhD_OpNc6aPOgJU2vp0FUuSAVmnW-cIiPDqa9tKZ4OQ1kW1MgbcYniaHXF0VBoH-VGaTVlnK5Iztu1 categories: Concurrency tags: - Java - Difficulty-Beginner --- ## Intent Use Guarded suspension pattern to handle a situation when you want to execute a method on object which is not in a proper state. ![Guarded Suspension diagram](./etc/guarded-suspension.png) ## Applicability Use Guarded Suspension pattern when the developer knows that the method execution will be blocked for a finite period of time ## Related patterns * Balking java-design-patterns-1.16.0/guarded-suspension/etc/000077500000000000000000000000001312550536300222225ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/etc/guarded-suspension.png000066400000000000000000000241161312550536300265530ustar00rootroot00000000000000PNG  IHDRB(IDATxXSWe9jZ lD-(*  S $ת:@ ߽ #ɽ@ ''s~{r{@1c+1}!~bo2hH5 "*0 `, "*0ilbLxlI$r@i!ZʳT-#ϟ5vU,Qp/;:BEW0M~Sɕ#0J}E}E^a#n x?n>kb z`)(srN}MAOai }ڼ]Oh g[,\Z˞̴9NmbsE|rz;MSk}SCmԼv2/[BjZzA/g9A5q]AF csDOUoQ^I&#O 47bQՁ<3Ma4{Do"By:N%E!R%4{O06d^ 5oC^1;Ƹ VSMAi0ZGA~B'g/oci*pD܋#&<} v;i6:**zDr^KExb)􊡵&1mGu4vI(l"SpmMEMmx(sy_zlឧc=^ґpc@&GMiv*Q7iyz6JlUQ'VῩWXzA{׶] ADJˬ8;KC[ԣQcc+}z|K R$-fc>ZSVA3{Scn h3 .)M5&m!f]q<{ 2qતh0o<>hc U1=tu+g%AJk ݢvaGۂdU6`XoES{+M;WS&O`;L jbt$ 5GNEYNaoe1gšoՌ-Mu$f6vcO!d֚#S11a 4z ܚcX0QIcX0QI]^RGDDv9a0+NRp " AchlO(t|ݓZS,7xr5n%찷T6pͽ[MRMVKIn?ERNr.էN l p|oa7,;TT|g{wAҽ7o͕1]}cW ]5Kĥ/2a{Əlk؞Bb(O6JqaxDA>`( \.'Xg"V筁{4Cό{n8^34l˛ׯ!]mE%:J+nk\= ).PwWI!b[aſXmViRbt8,>y[I&~f 2ɦ&Mtι; 69J%V5'{"eGkHZٙLq5#IδIÝ0F\B+>q800z[%F7uB^&8':Zu3Lpg/Q]Jnω S^qVZWͻ%isL$%5oXL_84L+W+Jp>I/J M =G˙`xO:f*dPKơa =CrHK}wŋ9^_W3:bQ*$7y%eˠɻ-E{ =oy5o%nSs{dC# t8SKz"J$$ƫw5:Ξ$5~XRim_wJIȭ9$? 7?sI1qI&O4y̺:'ԁ/f^ix*\߅RyyumDM]\ЎӍ_q$X/JagXPEmbm|P%jӸOckekl,]~|ZW!')>YoerZRcC"1m]ueD>&X4dQ[/3_v/n}8hb"v7MRWnxpQRP^wo5F1b,[rۧ^E7F*g?ةv*6v n O]˭+4W@i^t6Z`Zȃ>P!.moA 暒{}&ݍuokCi5kp.ͫE6~{FNYOz4g.+oM¸t'd*د(\m|uϡK@ey{ T)<"6[Kc| ؾBD9H߁oEv6ֳreJsHÞ * $ueco6|ZO*$h]pm0]}yG4B$ `,L¤cLXNjkC^?o4$.` T +A_Ap=v/Ca@j8 1TEI\7e=Y@}bP2Cx1*O#t/:Ύ1S^Px n27a 44;- j֫ % (wH7б#=|n ~sBF,ԴZn{#l1fRH/yʩjY6k 3Z6Q=<6,=VG ycls՗p9 401~e; K']$'tW2R9~e{"H:e+ K=4|4(}yc^jH.9jRDʏ mMp5UmS/nx)J#bژ˜oabܛ<;3m6a odd˰VVV9U=:[k`H*a_**Mi%OP׍%oMM/>RW0%.{ʵ{ _*j̛pQTf / x7<`<9)`Y.:n&tNS0wSߡ1w SDp ޮCjxՔ7/$e`hW.]iKLJc0X%ژi{ͧG'v7LW<"|>uI:ᷨˢxOՔnr `8T)٬ Eg^~wF95>y՜I9SAlpJ6Vwm.KJpI^ЧpђV~h=:hd _u11:V=l#^@5; ilUPޓ1u  jZڞ >~}P_,pnY`u䒫fyڶ[94MMVyɺUP*ZbXiƀsJK^@2}'1'FKvUfҭ\gs q[Y\L2if`{i.ue, ((( .-TF=2Wx8h2DlJ+n))J]Kdd_}nT3wBbhpswp2hq={֌=c*޴7r$]пP"sdUtu!)Μ2-CM9j"xŽ.1ИbRk^fk {'@/eBLyp/2Md\_<iYȧז+evVt 144j.Y{wn^@d \&/-%tl7y+hgU]Uu-xx͚Oqi{ŘĿ:f=L!#'Vukˀ)sat 9qfƸa3nŕL\Sϊ@B a`, "*0ib/X#23rŹoAr[a7rXU `,L89LJK~C},$KOSFVg7uU>}{Q7@11pzHxN/475N̓@ 5\fz${KNհf@cMtrl $ƌl[\<ŗA1 T&$)W]`d u$Xbs].=ݩ{0&.S󝣟梾 {B/[BjZz1X81ODĸܳC`SiQP5:|3ܔEMi[ߎ cuƦSE`֪ì~_ٞGCY@i{+ralαj+Ϟt}o3սUEt#{{11'ZXc?3abܛy6&>蠪hx yG#ƁV4{|3=> A)>~[g˜$Db ے 1B֡m<͗>3a( !oYJ*=l{-56< Q?`޻mj]%LFrkk/WwcܽR?6-[3X^>ddVV!I∵.>TV2;ƈr{eVNa`bؗU{c~g=i=N hqXc2P[w5Tv|UdTy.09}յkAl[&SNkcs6z%Ybz5qQO?otN0Ƃ14vmMe.t<لoGlq- 31 2of8}~b;z"erIDYNO`i1*=k:bn|^3c6ѹ6s&?/%LJyisd\!5cGl ,FΒ ;njy[n%˙RRibhmjs8_Z#g|6~zkFi-p|+$ejJڊjkO˨:puPުv!اJ01fs!yE{10v;qU1ӷ2V):m* *NLi}3}Bb7°i>zؽF-9X.e21$U28{;I1)bNB5#8b̉t :u$ΐ-F^ud*'LM; w̎ll1HbvV6=]5:%W-i>y浿>!f0f&hn8^գm2\:Gjc11-u5f_^.q*O[XXn#mY1J1"x|\tx0p;Vu~%JGA~B'g/oci*M%,AYKaåӑ.b¸wְҮ 1FPoq/hFdP'oSӎ @@9q1vclna\,# )9Pc֋ɵ?b{o/wS4=&{S) ?~#XQyS}aJz4dح:= @@9p{;5F ;ݸxWebLs(e}Ϙ|`v5rq AˠlkLBL r21~o+TfDA5Pcڠa|qצW+a|.cLevؿb\]U]me &\(zPKGjf&eLvwG"&:Nz(ػ{mV5"$Ę6, dB>`<~#cb<}84qa Bw.ńLX40&ETcaXD0&cGW ¤b߃\ףo2h{c6D1Q  `,A5P#mYj*z)YFjڊZa  k 1G *4 mx&9±i6jztuEl}.v/s@#Op]3CˢxOEV=@860- L<ѷ%G3v7cMq 1u  jZڞ >ҧ$c%&[Aamk#Ǝnhmk#Fa0Ni[ەfW3qM= n! !|+X0cXX`,B kEHca  `,0!5x1rŹo7HlAE6̅ Qca }ؾ ~~6`WȈj3"* k 5O,? -c⥾^ ,O+|uPh><cb2e{=9Xh.+p6# ` [زC.9.)Xa"eAIh>ʹ^g9]9k/=SM)AL6#"(W?`<"Tˎ6L,lbz<4}6#(W?`;m']ua~1Fh0c^Ձٟ@0iYFUs-; 31  @TcS'u󱫁G{g%MS!q^nyhuh S{ BA|j F/ADAa򥴅 ?ܨ?  kpS~zƚvwѰjDOca p3 `,0!5"$X0cXX`,B kEHca jxaAF@Z-ߝRa2.9(^`,o}z Gcq=5.ofQp;|WKCf,9yGFs?Z(u[,\ZKF,ԴZ.TH׭-YZ&g/p'i1A @]FfEئF9}:0>UCFuc4@s1hMy^գyy*/-HIE3OE8I*:`GcY3c} un[Jhs3 java-design-patterns-1.16.0/guarded-suspension/etc/guarded-suspension.urm.puml000066400000000000000000000004361312550536300275450ustar00rootroot00000000000000@startuml package com.iluwatar.guarded.suspension { class App { + App() + main(args : String[]) {static} } class GuardedQueue { - LOGGER : Logger {static} - sourceList : Queue + GuardedQueue() + get() : Integer + put(e : Integer) } } @endumljava-design-patterns-1.16.0/guarded-suspension/pom.xml000066400000000000000000000034511312550536300227670ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 jar guarded-suspension junit junit test java-design-patterns-1.16.0/guarded-suspension/src/000077500000000000000000000000001312550536300222365ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/000077500000000000000000000000001312550536300231625ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/000077500000000000000000000000001312550536300241035ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/com/000077500000000000000000000000001312550536300246615ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300265115ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/com/iluwatar/guarded/000077500000000000000000000000001312550536300301245ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/000077500000000000000000000000001312550536300323325ustar00rootroot00000000000000App.java000066400000000000000000000054741312550536300336500ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /** * Guarded-suspension is a concurrent design pattern for handling situation when to execute some action we need * condition to be satisfied. *

* Implementation is based on GuardedQueue, which has two methods: get and put, * the condition is that we cannot get from empty queue so when thread attempt * to break the condition we invoke Object's wait method on him and when other thread put an element * to the queue he notify the waiting one that now he can get from queue. */ package com.iluwatar.guarded.suspension; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * Created by robertt240 on 1/26/17. */ public class App { /** * Example pattern execution * * @param args - command line args */ public static void main(String[] args) { GuardedQueue guardedQueue = new GuardedQueue(); ExecutorService executorService = Executors.newFixedThreadPool(3); //here we create first thread which is supposed to get from guardedQueue executorService.execute(() -> { guardedQueue.get(); } ); //here we wait two seconds to show that the thread which is trying to get from guardedQueue will be waiting try { Thread.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } //now we execute second thread which will put number to guardedQueue and notify first thread that it could get executorService.execute(() -> { guardedQueue.put(20); } ); executorService.shutdown(); try { executorService.awaitTermination(30, TimeUnit.SECONDS); } catch (InterruptedException e) { e.printStackTrace(); } } } GuardedQueue.java000066400000000000000000000045221312550536300355010ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.guarded.suspension; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.Queue; /** * Guarded Queue is an implementation for Guarded Suspension Pattern * Guarded suspension pattern is used to handle a situation when you want to execute a method * on an object which is not in a proper state. * @see http://java-design-patterns.com/patterns/guarded-suspension/ */ public class GuardedQueue { private static final Logger LOGGER = LoggerFactory.getLogger(GuardedQueue.class); private final Queue sourceList; public GuardedQueue() { this.sourceList = new LinkedList<>(); } /** * @return last element of a queue if queue is not empty */ public synchronized Integer get() { while (sourceList.isEmpty()) { try { LOGGER.info("waiting"); wait(); } catch (InterruptedException e) { e.printStackTrace(); } } LOGGER.info("getting"); return sourceList.peek(); } /** * @param e number which we want to put to our queue */ public synchronized void put(Integer e) { LOGGER.info("putting"); sourceList.add(e); LOGGER.info("notifying"); notify(); } } java-design-patterns-1.16.0/guarded-suspension/src/test/000077500000000000000000000000001312550536300232155ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/test/java/000077500000000000000000000000001312550536300241365ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/test/java/com/000077500000000000000000000000001312550536300247145ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300265445ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/test/java/com/iluwatar/guarded/000077500000000000000000000000001312550536300301575ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/000077500000000000000000000000001312550536300323655ustar00rootroot00000000000000GuardedQueueTest.java000066400000000000000000000041011312550536300363650ustar00rootroot00000000000000java-design-patterns-1.16.0/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.guarded.suspension; import org.junit.Assert; import org.junit.Test; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * Test for Guarded Queue */ public class GuardedQueueTest { private volatile Integer value; @Test public void testGet() { GuardedQueue g = new GuardedQueue(); ExecutorService executorService = Executors.newFixedThreadPool(2); executorService.submit(() -> value = g.get()); executorService.submit(() -> g.put(Integer.valueOf(10))); executorService.shutdown(); try { executorService.awaitTermination(30, TimeUnit.SECONDS); } catch (InterruptedException e) { e.printStackTrace(); } Assert.assertEquals(Integer.valueOf(10), value); } @Test public void testPut() { GuardedQueue g = new GuardedQueue(); g.put(12); Assert.assertEquals(Integer.valueOf(12), g.get()); } } java-design-patterns-1.16.0/half-sync-half-async/000077500000000000000000000000001312550536300215375ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/README.md000066400000000000000000000033511312550536300230200ustar00rootroot00000000000000--- layout: pattern title: Half-Sync/Half-Async folder: half-sync-half-async permalink: /patterns/half-sync-half-async/ pumlid: RScv3SCm3030LU819FRPXg5fIm552tnYPFiyjRi3RkbAaYkdoQr5JBy369vrxz7oaSv6XmPhL3e6TCaJ0msU-CAoilTToyG8DdKOw5z0GzcAlvNAN_WZSD1brBHHPmxv0000 categories: Concurrency tags: - Java - Difficulty-Intermediate --- ## Intent The Half-Sync/Half-Async pattern decouples synchronous I/O from asynchronous I/O in a system to simplify concurrent programming effort without degrading execution efficiency. ![Half-Sync/Half-Async class diagram](./etc/half-sync-half-async.png) ## Applicability Use Half-Sync/Half-Async pattern when * a system possesses following characteristics: * the system must perform tasks in response to external events that occur asynchronously, like hardware interrupts in OS * it is inefficient to dedicate separate thread of control to perform synchronous I/O for each external source of event * the higher level tasks in the system can be simplified significantly if I/O is performed synchronously. * one or more tasks in a system must run in a single thread of control, while other tasks may benefit from multi-threading. ## Real world examples * [BSD Unix networking subsystem](http://www.cs.wustl.edu/~schmidt/PDF/PLoP-95.pdf) * [Real Time CORBA](http://www.omg.org/news/meetings/workshops/presentations/realtime2001/4-3_Pyarali_thread-pool.pdf) * [Android AsyncTask framework](http://developer.android.com/reference/android/os/AsyncTask.html) ## Credits * [Douglas C. Schmidt and Charles D. Cranor - Half Sync/Half Async](http://www.cs.wustl.edu/~schmidt/PDF/PLoP-95.pdf) * [Pattern Oriented Software Architecture Vol I-V](http://www.amazon.com/Pattern-Oriented-Software-Architecture-Volume-Patterns/dp/0471958697) java-design-patterns-1.16.0/half-sync-half-async/etc/000077500000000000000000000000001312550536300223125ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/etc/half-sync-half-async.png000066400000000000000000001001421312550536300267250ustar00rootroot00000000000000PNG  IHDR-q)IDATx \Mǐma6b,YCV)bDeMR([;*5Pc[Bd-fa&[ޙ3wι uO~=yws:R o=Z < @a@--*Tˏ:@ͧ-N!*0T%0x8a0KKÖ-9<{vnݷ+ڻs4ba߯_ox|@ߗ/ { 1K޽Af?>JH NNV/_R ),#>.tVey㉜O !dÄx.Y2;J)^ϕ+<ȗY@u!>} WWkooaE|llB`AU5`+gqq&M2Ĉ2þzm>JGӧ'L"E(Ä䬐Ht~-P4Œfox9ϭ`7lj._ޭۣkNNV5Wfa6yOt)L5zAT.]ڱMH|}ɐdz^@=˄< x<ǵ@U@a0< q 0xġ2e5>fQjD"xM$Z|E#xFOnM,J *S Ts:wЦ~}59s+jowRaa}ݻ6=:Ұa}$xA];֝>ۯei/pԚa/1[[:uXYȷ֮z\:d%~߾h\j֭@5Υذ 2^{%&jBŋ^Hdg'))ɥ :uj۸qCSӾ"(m1N 1z _޽56odսҮ{MW[n[mkw$[7R͘pxsKgs vmNrX [C\vvzr,vHIkժaTB⥦Vڸ(on!N%m"$ēd an׮KJ ޒ!+(X "a|QjJ2=LNZH'kmܕ;$0p"(AjjILZ~"73ܹC9Txu,nO?'{k:p ?x[{swۭ6Fnbۿ2PxoO^ןL^23}ՐRsz\I2Şyap$&PjXdT35J è5]G6S˗3f80[Zwi޼z-ٳr>2#;@ǹ?,iöLʌZxX:A{yXxjhׯGmȫnW5pvo_;4=Lf_oΆ4OzGv%IJ:RY ~ɪm0EaTLO KKÖ-9a;%%nn?Eon3Bsm0Ea=ztef Ӷm{^ΞO < `}:U6nȘ7EW`aMq 4KpL2Pre/u{k.{=L253ӵ74앖$SӾCޅ590Ea}G"ٳg){R a$Cj'OEEyG}զ \ ͟8qpÄ._Zs'gӦ@&;-'gEE50EaV]&Fzyسg'61iҤ?d5oK|la G[f&<]IK")mr߻`mm,! x@?gf^6t)5a:wxQIEt5ׯcoE de!tІiQKvijvu+KfSсjYC3y'7e&$ur{vQQ*¦mVYRPɁ)~:B%Z{{;k,gSd˖ .fg/oԨ[95i!FT{OVZZݻÄܹE9۷mnL=fdpTxQҢX?4r@6q#Ȩϭ[YwO?v|:bh& yXII><ȧkhɓ ''$KsСFkyɼ(&bg\ѣ#cOָ5^9_#\[WG׮흜>=qZX臅M>*Jy3SMPYfvwѪU.]Y[_ϟֿDC[6eVPPa*a4i g/_nS67ܱ<=gN2=,"b:嗖/hի&ySڳfKuDɤ\@{Wѣkh L@ x@ݸi0xӯ2;^WiFIRvr*k9-]:6W.^Ö,ZZa5z8ɓx0 S={[?0pbdFhaTet'!(33fΜxXt7[KKM<{vsLUɓe yKu%snݺ{_kX< 0 SȈ8P{T{Ҭ}[C[~uooAZssu2*;.__˗w!%%Rî\Ò5lhsܿx6vvW̉HaԚCN70x!/aFԿ~}Ew< !aFn}}u;\C@0 _@u~w4iJgWM0oWZ~? ׈g K?|r^>_7t3tݺ}ԣGjK$;~PF ?lޚ5}ԦaA޿x%t ;QN4(9q893v.\~8:\Wrmib;1_ $%%Nܹ\}TWev j𔅅~Ӧ>=QZ>әL"#7n8rG?DG;4g6oСFT2၁;wVgv:~}m[,[6ŠfR y.k6ܹUAFF};xN[jGyX-Sx2UƀT%Ui:Pz`z†Mt Wo}a|&'OpLtC44܆f͚r&?<) 124UZ$(-Rp:u~1Tپ}kiFQsrVaҮ]+*'&[~4d֭,R?z`hڵiS.df0BE go_{yɐY[%m = ri^NKk8y2UƀT%Ui:Pz h{l= Ђ !C ‡DXsd`_go/.M"ʊ{ U޽۠Asz\rM* /_MZZ] 4K}4f,]_TOɓ킃={ $*)ɜf;9]2+.)\X=qзr%o_/KH{Aŋ;V~}L֕-&Q/԰aCd(3ɲ/&|oKVV5;R밉o/R,=:" -)uZ e6+okD55%Ui:Pz;}\OָK |{t~Ktʱ{/( إ͛lm 7ݽ[Zn<·`J+73~z0͛Vn~&5;{Ik2}*ss 1b&\ԩC'thoyx"9%1ر  Džv6iѢL{y25PatW@="d_BKOǸnp_hD0eΝ[vQ…\ vV)S34߫WgWXSβe3ئLIrVV\>7$!(S85z-WӅ0"26ln"΅MOgӦ^K˦M޽55j@k(0EaTj3Ƃ}?r o3v۶P^{$Gm?x!/aF> f;wr׮<\m7ѧL0B^*8Z\ 3a,G]E?}zb8+ss}Moi{]V Ir%K?nݷp^^Vٓ&_,Yʕ=O aT9S~.fg[PG%dfX[SGxFFbbmi 9<ȿ{7~'ۍ9#996lf3sΜKjeM;礧דԺt\]L nȘ0avx^=kg'X`-/>u=e~yusN#k[7?:ڛZvp3:Ԉ+u&kP0M)M\"C"B"B`ƕ*yiΆh~LO_v-,&O ͳ۷o-}>\ݧς!W*%bIưz\$Wpt$v`:kSAxŋ;<(y ;_;77r(3>~vFF [S&rĉ#d;yŋ,_d|Hbb[#xJITa*|װk"BQ6%KFF5Bo߫Wg ӁyشirrVppZRAAeo&I۝\۽{ )ՏmNC7ndxzڐ l@pƫ~/s_M#%LMΘil{{)RGoү*< ȟgGVP9Ja^CUhT :{vsLUɓk'LJĒȺ,HY=;h9b5{;Kl4?33fΜz<% JnnýF!lwo+A< ¨ԯӁyݻFmncc;Nrފ<ʕ=72yT{__G;p6[!6Xd*ddP%%ۭ`mRR"y(/ ObxqqhO5biٕ;eV͟>=!lwo-ݯU0 SROa!K;¿T~ x@/tSXw%%_Pa0>y0EaTLO0B^*[U~ȧ:P%%%o/}=E0B^@ҿIIIbDyZQ0B^@4k֬cǎEEEbځ!$??=j@ x(rX*7kLT;0B^@H_UxOO88^ݻwbÆU2;W&m׮;xQG(2a0øM0R1ǣa/_ TKJr%<ioe6#ksE< Fll,0vϾHQUa7ndZXJK עm<gkkjl̙dvƍcXPy,Gڥo_'Oխt2=lٲT_mbҗ#ϸqVԴoQQ2 y3f8P͜9ɨ>0p",nlѢ٭[YT# x( mm|Ҳ`*aHoLٴ)0++nlUcZ#TŒj Hff1Ucȑ-Q]WSyI:vx = IZZR/^_:^,(BB<ѣXu"RA++xu2!O]Kv6iiQdBd;PhiuIJZD:2||ZZT7%>~6ӑӹ-$?K緵lٌGf;xXhŋ]~~N+WI۷wwqNޠG(2a\]]E2U<zXiuQçyH%znȨϥK45;ݺt$$sɒ\aTtë44ԽFl#aZ< v:9Iݻ\;KNsE< mjj"?S ^y=8ܹDjҾ}k2!Ot$.n֤ICAE:B"y߲HV-ЮkҤ;aW;~}uIʤ )-TڻGy:$[ɓHH><ҥK;ʜ;יNĤ/t;(/ꂴO3pT'.P"HTZ4?? C eC eC eC eC eC eC eSK= D>vRK=L< < @< < @< mjjأPa4_s;'E) x(r"xpdT}D /axayT#OD5< s&ihy_\-xQخ]î\COOp;^\ Ҩ6_yhISP677Z>E}| "+Ây\h7<K62[_XC_E=hFG{ u )_91Qa$}@lڻs'gӦLjO_ԇ4D?SN gf,K?N.%|a{㏻~6!cB!4ݒB | mƨAvc #b-|&;a ddE]s[IFII)ZfiHI_h¯b%ljذ~a::q/?biH27|.!5ܳg<ݤXt}2=L8~a hM<9FNM0u qN ;䍍Kpp ?Lڤ@taĬ1}v% IQO3%.^ѥK;(Zht| YmlLر$'N|81"b:נ0jjBC'-^ol;vX{Oo Y)'Iڵ4'*̛?sђ0[yy)Z4(.Mwn;IAbc}OD'֓_pYli }9\nR4oO\ gN;0ןOgZZH'Ⱦ ظ!y{;]&' ?W&UJ=4j@SM4կ7e7}?yr,33Bv޽di&CB%9h~Fa0UCQM͚5)7HR}}Mv1?~H\,:TI3xF9&ٲ;a 뒜PeKkGx Yׯ7dEF ;/2f0j92E?OW$|er/Z{{;H&/ѲV#k$[MJ:#*:6m> /-_Wfٷ!cFFY$aGb쐈Ȭ*qJ]WHyvzKZ$ u_ڵ0*;뙞LdL1w35nbҗ] /{{vff5o 2*ʫwo mn}h̜9i`Z4yFrfZRѓ>a /^pst#??'G )Z._ݩSdzɰaIQ"v#P'! _o-篦_Ǐ []~Ft`X?ICtƍ"uw!3ExK&WsM^D *fE4ޱKL喣;nڵLIA:wVg7f lٲI_A_ I⁇cfz{n^o nBJ=U}g88XhR^=Kv w"Vx{;l&s< < @< < @< < @< < @< < @< OjjأP0B^@K$Ga⁇!⁇ՈعsqExA=~[:uYZ%:9Yuᣏ4jԀ -Ir{3v۶Wp^^tUuU axaGIIDS)˖6&L6r*yiJ&ǏZ <{vO?Nf/s' ⁇c8^#*LX\-*&IciML|YK5QW}ѩYz2dҚ͛Θ lŋvZdS<{vR]% M۶-nʢ72t-, {E9uj=K&ٸ1}Qf҃a @3:[aT&}doy\͛mR|ym:;=s=b.Y2 O[רs ũs挧^[ >vt V%Wkv qTM^BVVرYʪ߱c ϟ N|y0!33461HaLYǒ 3h&M]ܗ ɌΝMׯ_0u=m~CV1U~v`XDFPZ.dm|@낙 D$v*ٳ n2H,HrrV&)#;īWR!*ʋW[/ҐR>};;=uvvӦaU0P<bց>ڤJΝ0($%-*-gef2'FDLZacӗ9:ZrǎeOx**\Kv6iiQAС Aa66&Xү'> 3={vy`:IF?I_һKv/K]&Mw/ہ 5޵k{NT7%>~vhŋ]~~N+W1 Xt76zX< <쟨<$4/4p_NT)>%(ȃwë44ԽFL dWXpF!ac=ΝFhjvdi}Ͷz1d'diiwoYڣGGXeiBڙLR:R%^dB~bđlŋ”HR1{m uI:A~,02CGyVyXXdVOǒ1o~zê$axaDh]>M!"y_GݍDE!LY![I% bD{E5kJ[Hd6.}]Ezm, `œ9w\n{7}T ٳ#y %L$j ]^NG낙$@$gxD\]mRlLg uInE-.n֤I+,,i/ug`Y4$7n⁇)M\"C"B"B`ƕ*yidHȜ|}Iԡa%.g뙞?[K&O#u#xH.X}ԇݧȑ50~!]VpkZ֭=k'N|V*x)8ӕ+{H+iaaOFx6./_ݩS_~9 {JKGxvyOL5zAls\gĤ/[cSkvv~AZ%F0_5l皼ATMg%KFF0HIDT^#A⁇cfz{nDKq!!݊ߤGńa< < @< < @< < @< < @< OQQأP0B^@j?0B^ԒQK'Zj?$` &= bRK~*X"=PKZqH-_())Ba[{  < ä))))- a@Lj_!֮%WWE)??8i&$Ɩp*OÀr*HaJ0%abS)oJokk !x=1nft7Sڙ3,GCCʕ=eeō9}Qf$XcX4ot ڻp޿h8[[SccHWW _8 Yi0E $SӾC kaca PۨB]d3Ξ=K?/Y0R$j'OEEy1M$=:]Vq::/\^TLJm,ʪ߱c #f:a%33j~1$O+sp ?YQQ %s&%0pbDt/a;ܮ{UTRp1@- =ŋ”H1c,N }BdW@''/ iQKvijvu+KfF2LxC"JzoolcYfWY(R!g$Sݺ}ԣGju/[6c1ԝ.)~@xأGG֮?~J۷ۜ9GH?,)ݺ5411#ZD PFD,:6;b/X'sPu {MRR"srQQ^:iذn'> M:=?t&ӸH/ssƍQB~jHO';_$Q3\~ANm@SӾ=l8+ƅ 9EvS__ToQDIA5Oٸ1r(s wj?L\RSS}>qLls=#}?<ެYS矗RxuCbD$XT XNL'[M6ʟ}6_ 7$:~<;\þnW5pvo_;4Z)* ϝOFd.]ڱyxܺ€qI{q~~Nzz=|Lr!osuC26q#c„ayԯy(G6ZkyɬSvmOD{܆xZ%͏,茆5xJI0eaXjjأ>B.8{2ի&%نCi+_:$f.^AY%Xs˗wSeȈaazw$[eGRaO}}yɬw<*/|˗W}Hbb[#xJI0j$66VQTM6*'g9}'˩@`l/䑚ZJ1c,vge?رs+/< )))RZa˗>$W)XSyT Ô7aJ%q7DSLRH$bÔ(a8WP*Kډ-{7%T<SaRp.xUaJ0%a",*|K#7YԴ/VE/pw!ҳg'6.4i=,=}%L{vm/}kilm}73%'{v3Uݶ-UO'//FʪA S"666??_Q^ x~ɧOOXZnG{I$:LI*gdĐKݻ>eٲ\d*kС$dׯ#QD' _Sba eA9kD sƓ0 HYYq#Gtwamm}Ϭ1>i*sHJ,,I?/00ˍ0;w.f7fݽ۾}믿blŒtصδ( u deg/oԨki]0`iYv~i鿯KR ,9.n֤IC'kF˖~` aj ;vēTa)M\"C"B"B`ƕ*yis:K$:&&}P%=Lxעܺ5#]csawZ5jumn$IaaO\w>O޽Ihin_PIQQ[eJjr7_5l皼ATMFĒ%SٽhT^C|ÔLqqqfbcc/?bfz{nDW ooD+< %%%= _FJ0%a@Yc K 벴4$!/14u \Ma4f%6!)$n$-4% %ɒPZPID4+-ɖfFf7aFc`߹;Yz=9s>tΗɄH<9Akz.FiQ6ȭ%!aoG:vT߿?ݸ]Q:R1#PkjąHbԡSI~F-C/(X̉$f@j|`U$ŋroJ%ھ}NN"J֭[$dR9/,@T)6M#Q̝;aڹ=CYIqF~-Ҙ0yRfeEZ0e7m[URNh;w =;&Zjq$jcDvխ:BG{rr%P~r%o_-*N'ZHȴa À&T .5yXaÖ-oYFTp/Vw%Cą<0.M,xo~͠ŋ'=7رAą&ذ[ʨF2<,.ΟӲe-]:Izqsjkw};O'5j*2қSOaJ  LV4VL7'kAu̧H9d+ϟjoauI&833iiI`$ $9B~~\\IvXTz=}ZLdQW뒴-sOw>XjOXk{,gynl`> 455 T}&8ŬY.H76jx*_ۓT)<{ ZNN77)S_IQ'ݧOqZNӦMRRJ kɓNNu\]-, JJ6=~bb 7A}I>#6y& ; XSbŊQQ ӧݻqx0PdNx d?bvJ *(\qĞ.vQ0%Ƒ#Gؔ&x ^#% x0P?)++$'StGP2aJ0pHNNVt/P2aJ0%a8::bb ZS)? ]]]EDS0Grr2^L laJ02Z x-vs004^ʗa]ڹG[VpQ)8 XE ͝w^w7-rrbLYFg'&.E><.agΤr~fs 7 x%~~~R%?asƸK-K'6"UO=;nee0U7nhWWk.衡pQ)l9::J>"EP5v8lYѲƑeH9N`E)tSVV&.^g=pQ) 0% [1;k%{n\#pQToSb>)QÔ|UQ&Medd3C .Tt[aJ0%I $ a aa~sp\`(Qfa~V^8I_m!5piUTOigΤ-- x z()SLF6#7[ϚUKL֡-vtfba׼y#KvbWꌁ$9}:yذ\o%ka 3# ^H/--5<#EKL\HdB:|PYy|J&:|G2AZ۹GO^UVBJmx+oc3 ގ#Ky{ɉ!"ɓlKK\\, T@` ̇ɛx+W2e<\* ahV-n8@}jQB`y R=ֲJ⍜uNe AF( '&&.0ŋR!%belܹ]oΓ aGqvD"a˖}t4N's&P+fp[ICA:p'k}xL`> O}Av.5..I}{(/Bǵh9[zÇSYj¿zطn71ѡŢuzz>-2YTKAH?#/lg۶avv 7 xL'o-^{И0…4]ݞ^c)ڵM,Ԅvޙ]$m22CZJ$ä% 68𓬬hvvo룃 70 @D>C&a 3 'a 30P? 'a 3# Ä8  0 À7nxMEEԩS;U#{9w & 0xaTcddlٲgϞbAAAǎ+xp0(Dn=zDSS˗S!33sT?H$6lXpppUIFFaL9h`` lPPej K,>>|('0+KV /33ʴ4;;jӲ| k7VѶ999֞>}ZCC_-**>|8}J$[W^MNm~ %D+9YxP'ŞwHA<:uj4kִSIGYw[Ъ⍼MlZn㏻3gRcaaвeQLWSSkݱ7RBPД˗36lhd篿!1&S**qc/NOWyf.^ǺWLN"}}]ڴiEfR"'_S͚Oa 3QQQɦP̚5kСTyfF>,X hUdd$-JzΟ?ߵkW֭[ZZZb"svv"#V+###yY3\f`9٢[{7gGD̤EHΟn#߿Gnjʤʭ[o}VW-,'}l'$Ov)a<.Ol*--*D˖mlP%3_MΎ{֘\Ia2$磲KbB*~7?Baa;ȜUlr$vJϤ{W'ӦM+PTxdxLXOa2 ({vEpnud ;*3t0&jjiTf}44*KKw6!5kjmm$UPˉ)kܹ̖89c 4jWSNH|tr3o6(hʵk9⟌(##ENߤjCh5k'f#Qtw+<K=9z)Gme9Y~2PLsޕkQcN5nrڔ͛75ް*GQO?^vի&>>cgQ0r n> mj,)3MT-&նn ]xh3)}sNh&M~ݎᇝYQ i? 9a&841!<{c͓gOL_xÿR,Z+%)TZxG]ݳg'9m6mZ#??ntGܳgk9$d-(X3dHo]QQmBѾOnϟ0Vih#qwEJn7uډTƍQg 7f{!9qsO}&Q":dd/I[L30޲ex@>` 555L{{xxdddH*ItKS#ױwm]mTӠ+لY߾Z$::ZI}~X@; < "LQQQM@i'ٚh}eF\޹SPUt ]֯_?>TT* Y䀊 3nt 2001r22%"NpI?7,%o<ؤIc"*=A3?/Qx1fP8*2aӁ8G!b"ۨQ#e{,͛e張C[lޡϕf` Td)>˗/iedd0rtt$eExxxC ׯƲpc9" nGEE֊e3bIe/fZ$dYVV&իUa, )0f*2̄s춶6jNm oNEE#;v[7uKK7_ǍTcz̉w`V!ybPli+OR;VY䀊 3y?>vXYoa!!$1:}xg]~@v vz Y[y5NNʕL5Þ=;nee0U7nd68)>~d͋Lly?{Ӧ9df$)-r߿DF B//w/-^@$""Br~wccI&R˂ti^(j1Y fu}(/ҠSHzu?{G[T…N`Î]t`elܹ]oΓ/7݅v=@3aeqNkG6\$w8k7Hu^KŻ/~UsΞ=ɓٳ&355 W-ݽ{h(S;R^MÐ MHټܶ6-m7G<|80`0ggu^ر^^N?JIYbxd[[㒒Mdގ(In=::~cƘ[5c(#*2,׾.5tdG5tܾ=44ԓע;ll9t0>ܘR03ӧ#2{kofJ--u:3pϞN/h[ܶ-}C!Z xa^@\rYL1))Ijڃw?ZXRSL4.Ο]ٷ0y o--Ohi'MU/|p!m*_F#$WWkq3f8s%vDt`h5/߃yX^k\0fPFTdZ#^ {1aӧtx/^t$kr6mB_g,5?,2޽ŋ.)}|jjjTعsg-[~cT$WҀ TdÄuzL]@T, Td-xc: xr@EYMSgKݷ̱[aqTgλto+gx[בC-/]:5iO4o}MqdgԑQ9p0R+~J:[j10=!^f/s(EGϚ={5bfOeD&70ǰݺ7l0,.]WG{Lm2?%|xȩa6M+t#[{\n\Ѫ2[ŕvjJ&Le׃0 dkk-F2}3)T<)ZzzT߾Z͛736^=TUȢ];l|ذ _@MuNX1Cø=cS[YOF)Y0w*g~&5uȑzz藥od59{QaTT0؉'n)J.޾e:Y;RfR&NΝ?Za(n*o6*o4mΤ,eis6jرRѣͨlaÆ7VVR=dwv^-g,Un,a}|r~ˢ6>-M~R}A20aAm{T#񢂋%HS5"F[;qNU%T5\6bh~ݿz#LZCe__V9qGm/ !ﬨ(dzBr8ʊ&8cD$EAudfJiӊu̙&M-Qg?/$[\5=;;CR=#T`%ea@MȩQr>$! kâF8RJO-4&v|m¦S rbfMyYӦM|t9ޥzR--u\3Z˞}^ӧ;RO咒Ml/ӒZ0ggQFFIȐvڹ2=y_=LFO Ԅy65%`hĤ+{Zc*'t^8QۛxfA ݒէO7a/J#*lj{~ɚMJz95ʕǛ7ofkk,_\I~w *v]MT3*Z+a{d"/}1 C߾ĥ]sUh-ad*dC0qsO5˅YNBB{/]DzR?۴iտJ>ݑrY.RKR+Í=e&krrРk Oݮ(u+qFSJju :q"QvalT@aW,|3_׵xQ+Բcu0Ȗbc=4jayyq۷hmBBݴimKsN8qnÇY<(tp,wpX //'jw,uq\xqI&^2oG$rw ?jt1c-1x OTXv|jaKMr|8ąhaapAښ<,;;M;IHoʯ~ iV_ɓ\]m 1Ù55o/#J&E@k׬ycZ:䉊˳==|}] In>ڵ#Poy̙KY-QT4e׮p*KeΆ G991ZZ22Ξ3{ݺxF9%%,, ɨN]ϟOݻKzz]ƒ+=lX Ϣ<=D//#I\]'Oikk\\1x OTXwy8+xȩ java-design-patterns-1.16.0/half-sync-half-async/etc/half-sync-half-async.urm.puml000066400000000000000000000013711312550536300277240ustar00rootroot00000000000000@startuml package com.iluwatar.halfsynchalfasync { class App { - LOGGER : Logger {static} + App() - ap(i : long) : long {static} + main(args : String[]) {static} } ~class ArithmeticSumTask { - n : long + ArithmeticSumTask(n : long) + call() : Long + onError(throwable : Throwable) + onPostCall(result : Long) + onPreCall() } interface AsyncTask { + call() : O {abstract} + onError(Throwable) {abstract} + onPostCall(O) {abstract} + onPreCall() {abstract} } class AsynchronousService { - service : ExecutorService + AsynchronousService(workQueue : BlockingQueue) + execute(task : AsyncTask) } } ArithmeticSumTask ..+ App ArithmeticSumTask ..|> AsyncTask @endumljava-design-patterns-1.16.0/half-sync-half-async/pom.xml000066400000000000000000000036131312550536300230570ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 half-sync-half-async junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/half-sync-half-async/src/000077500000000000000000000000001312550536300223265ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/000077500000000000000000000000001312550536300232525ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/000077500000000000000000000000001312550536300241735ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/com/000077500000000000000000000000001312550536300247515ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300266015ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/000077500000000000000000000000001312550536300323015ustar00rootroot00000000000000App.java000066400000000000000000000135711312550536300336140ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.halfsynchalfasync; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.LinkedBlockingQueue; /** * * This application demonstrates Half-Sync/Half-Async pattern. Key parts of the pattern are * {@link AsyncTask} and {@link AsynchronousService}. * *

* PROBLEM
* A concurrent system have a mixture of short duration, mid duration and long duration tasks. Mid * or long duration tasks should be performed asynchronously to meet quality of service * requirements. * *

* INTENT
* The intent of this pattern is to separate the the synchronous and asynchronous processing in the * concurrent application by introducing two intercommunicating layers - one for sync and one for * async. This simplifies the programming without unduly affecting the performance. * *

* APPLICABILITY
* UNIX network subsystems - In operating systems network operations are carried out * asynchronously with help of hardware level interrupts.
* CORBA - At the asynchronous layer one thread is associated with each socket that is connected * to the client. Thread blocks waiting for CORBA requests from the client. On receiving request it * is inserted in the queuing layer which is then picked up by synchronous layer which processes the * request and sends response back to the client.
* Android AsyncTask framework - Framework provides a way to execute long running blocking * calls, such as downloading a file, in background threads so that the UI thread remains free to * respond to user inputs.
* *

* IMPLEMENTATION
* The main method creates an asynchronous service which does not block the main thread while the * task is being performed. The main thread continues its work which is similar to Async Method * Invocation pattern. The difference between them is that there is a queuing layer between * Asynchronous layer and synchronous layer, which allows for different communication patterns * between both layers. Such as Priority Queue can be used as queuing layer to prioritize the way * tasks are executed. Our implementation is just one simple way of implementing this pattern, there * are many variants possible as described in its applications. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { AsynchronousService service = new AsynchronousService(new LinkedBlockingQueue<>()); /* * A new task to calculate sum is received but as this is main thread, it should not block. So * it passes it to the asynchronous task layer to compute and proceeds with handling other * incoming requests. This is particularly useful when main thread is waiting on Socket to * receive new incoming requests and does not wait for particular request to be completed before * responding to new request. */ service.execute(new ArithmeticSumTask(1000)); /* * New task received, lets pass that to async layer for computation. So both requests will be * executed in parallel. */ service.execute(new ArithmeticSumTask(500)); service.execute(new ArithmeticSumTask(2000)); service.execute(new ArithmeticSumTask(1)); } /** * * ArithmeticSumTask * */ static class ArithmeticSumTask implements AsyncTask { private long n; public ArithmeticSumTask(long n) { this.n = n; } /* * This is the long running task that is performed in background. In our example the long * running task is calculating arithmetic sum with artificial delay. */ @Override public Long call() throws Exception { return ap(n); } /* * This will be called in context of the main thread where some validations can be done * regarding the inputs. Such as it must be greater than 0. It's a small computation which can * be performed in main thread. If we did validated the input in background thread then we pay * the cost of context switching which is much more than validating it in main thread. */ @Override public void onPreCall() { if (n < 0) { throw new IllegalArgumentException("n is less than 0"); } } @Override public void onPostCall(Long result) { // Handle the result of computation LOGGER.info(result.toString()); } @Override public void onError(Throwable throwable) { throw new IllegalStateException("Should not occur"); } } private static long ap(long i) { try { Thread.sleep(i); } catch (InterruptedException e) { LOGGER.error("Exception caught.", e); } return i * (i + 1) / 2; } } AsyncTask.java000066400000000000000000000053351312550536300347730ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.Callable; /** * Represents some computation that is performed asynchronously and its result. The computation is * typically done is background threads and the result is posted back in form of callback. The * callback does not implement {@code isComplete}, {@code cancel} as it is out of scope of this * pattern. * * @param type of result */ public interface AsyncTask extends Callable { /** * Is called in context of caller thread before call to {@link #call()}. Large tasks should not be * performed in this method as it will block the caller thread. Small tasks such as validations * can be performed here so that the performance penalty of context switching is not incurred in * case of invalid requests. */ void onPreCall(); /** * A callback called after the result is successfully computed by {@link #call()}. In our * implementation this method is called in context of background thread but in some variants, such * as Android where only UI thread can change the state of UI widgets, this method is called in * context of UI thread. */ void onPostCall(O result); /** * A callback called if computing the task resulted in some exception. This method is called when * either of {@link #call()} or {@link #onPreCall()} throw any exception. * * @param throwable error cause */ void onError(Throwable throwable); /** * This is where the computation of task should reside. This method is called in context of * background thread. */ @Override O call() throws Exception; } AsynchronousService.java000066400000000000000000000101751312550536300371050ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.BlockingQueue; import java.util.concurrent.ExecutionException; import java.util.concurrent.ExecutorService; import java.util.concurrent.FutureTask; import java.util.concurrent.ThreadPoolExecutor; import java.util.concurrent.TimeUnit; /** * This is the asynchronous layer which does not block when a new request arrives. It just passes * the request to the synchronous layer which consists of a queue i.e. a {@link BlockingQueue} and a * pool of threads i.e. {@link ThreadPoolExecutor}. Out of this pool of worker threads one of the * thread picks up the task and executes it synchronously in background and the result is posted * back to the caller via callback. */ public class AsynchronousService { /* * This represents the queuing layer as well as synchronous layer of the pattern. The thread pool * contains worker threads which execute the tasks in blocking/synchronous manner. Long running * tasks should be performed in the background which does not affect the performance of main * thread. */ private ExecutorService service; /** * Creates an asynchronous service using {@code workQueue} as communication channel between * asynchronous layer and synchronous layer. Different types of queues such as Priority queue, can * be used to control the pattern of communication between the layers. */ public AsynchronousService(BlockingQueue workQueue) { service = new ThreadPoolExecutor(10, 10, 10, TimeUnit.SECONDS, workQueue); } /** * A non-blocking method which performs the task provided in background and returns immediately. *

* On successful completion of task the result is posted back using callback method * {@link AsyncTask#onPostCall(Object)}, if task execution is unable to complete normally due to * some exception then the reason for error is posted back using callback method * {@link AsyncTask#onError(Throwable)}. *

* NOTE: The results are posted back in the context of background thread in this implementation. */ public void execute(final AsyncTask task) { try { // some small tasks such as validation can be performed here. task.onPreCall(); } catch (Exception e) { task.onError(e); return; } service.submit(new FutureTask(task) { @Override protected void done() { super.done(); try { /* * called in context of background thread. There is other variant possible where result is * posted back and sits in the queue of caller thread which then picks it up for * processing. An example of such a system is Android OS, where the UI elements can only * be updated using UI thread. So result must be posted back in UI thread. */ task.onPostCall(get()); } catch (InterruptedException e) { // should not occur } catch (ExecutionException e) { task.onError(e.getCause()); } } }); } } java-design-patterns-1.16.0/half-sync-half-async/src/test/000077500000000000000000000000001312550536300233055ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/test/java/000077500000000000000000000000001312550536300242265ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/test/java/com/000077500000000000000000000000001312550536300250045ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300266345ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/000077500000000000000000000000001312550536300323345ustar00rootroot00000000000000AppTest.java000066400000000000000000000026171312550536300345060ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.ExecutionException; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws InterruptedException, ExecutionException { App.main(null); } } AsynchronousServiceTest.java000066400000000000000000000064361312550536300400050ustar00rootroot00000000000000java-design-patterns-1.16.0/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.halfsynchalfasync; import org.junit.Test; import org.mockito.InOrder; import java.io.IOException; import java.util.concurrent.LinkedBlockingQueue; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.*; /** * Date: 12/12/15 - 11:15 PM * * @author Jeroen Meulemeester */ public class AsynchronousServiceTest { @Test public void testPerfectExecution() throws Exception { final AsynchronousService service = new AsynchronousService(new LinkedBlockingQueue<>()); final AsyncTask task = mock(AsyncTask.class); final Object result = new Object(); when(task.call()).thenReturn(result); service.execute(task); verify(task, timeout(2000)).onPostCall(eq(result)); final InOrder inOrder = inOrder(task); inOrder.verify(task, times(1)).onPreCall(); inOrder.verify(task, times(1)).call(); inOrder.verify(task, times(1)).onPostCall(eq(result)); verifyNoMoreInteractions(task); } @Test public void testCallException() throws Exception { final AsynchronousService service = new AsynchronousService(new LinkedBlockingQueue<>()); final AsyncTask task = mock(AsyncTask.class); final IOException exception = new IOException(); when(task.call()).thenThrow(exception); service.execute(task); verify(task, timeout(2000)).onError(eq(exception)); final InOrder inOrder = inOrder(task); inOrder.verify(task, times(1)).onPreCall(); inOrder.verify(task, times(1)).call(); inOrder.verify(task, times(1)).onError(exception); verifyNoMoreInteractions(task); } @Test public void testPreCallException() throws Exception { final AsynchronousService service = new AsynchronousService(new LinkedBlockingQueue<>()); final AsyncTask task = mock(AsyncTask.class); final IllegalStateException exception = new IllegalStateException(); doThrow(exception).when(task).onPreCall(); service.execute(task); verify(task, timeout(2000)).onError(eq(exception)); final InOrder inOrder = inOrder(task); inOrder.verify(task, times(1)).onPreCall(); inOrder.verify(task, times(1)).onError(exception); verifyNoMoreInteractions(task); } }java-design-patterns-1.16.0/hexagonal/000077500000000000000000000000001312550536300175765ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/README.md000066400000000000000000000026141312550536300210600ustar00rootroot00000000000000--- layout: pattern title: Hexagonal Architecture folder: hexagonal permalink: /patterns/hexagonal/ pumlid: HSTB4W8X30N0g-W1XkozpPD90LO8L3wEnzUTk-xxq2fvSfhSUiJs1v7XAcr4psSwMrqQh57gcZGaBmICNdZZEDb7qsCZWasT9lm7wln1MmeXZlfVIPjbvvGl pumlformat: svg categories: Architectural tags: - Java - Difficulty-Expert --- ## Also known as * Ports and Adapters * Clean Architecture * Onion Architecture ## Intent Allow an application to equally be driven by users, programs, automated test or batch scripts, and to be developed and tested in isolation from its eventual run-time devices and databases. ![Hexagonal Architecture class diagram](./etc/hexagonal.png) ## Applicability Use Hexagonal Architecture pattern when * When the application needs to be independent of any frameworks * When it is important that the application highly maintainable and fully testable ## Tutorials * [Build Maintainable Systems With Hexagonal Architecture](http://java-design-patterns.com/blog/build-maintainable-systems-with-hexagonal-architecture/) ## Presentations * [Hexagonal Architecture](https://github.com/iluwatar/java-design-patterns/tree/master/hexagonal/etc/presentation.html) ## Real world examples * [Apache Isis](https://isis.apache.org/) builds generic UI and REST API directly from the underlying domain objects ## Credits * [Alistair Cockburn - Hexagonal Architecture](http://alistair.cockburn.us/Hexagonal+architecture) java-design-patterns-1.16.0/hexagonal/etc/000077500000000000000000000000001312550536300203515ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/etc/hexagonal.png000066400000000000000000004421721312550536300230370ustar00rootroot00000000000000PNG  IHDR hbCDAIDATx xE]@wQ@p $#@M g@"rM A9>u?TUq=AP]՝t{~Ozz߮c AAAAAAAt        ȓ9AAAAAAA9IY0 2Upd)$!L,AS~ 6 AeMoo`G<p `)``*pg9]a)/HꀏSR$Tf΂s`$bS`_&7 I dw!H"Ħ >LLnKS8 ! CDM5t^xkخtb*k\ڙmۆR/I].0`q4݁)p> LX8`wf 8! CD>޻y"=7pWtؼy݄_=Eϧ(;It^=:0q4w7kY||$8p>̀9]aȧb+WҒj׮J(萢A7jߍԩBf*vXfuX á@bRv}aѡx[QjIN'sz{f+XIu p p> Lx8 f`.0I#'l0mM v… lg``S,dm%KO<~=[aѡxFI/=-q6DQX:Uo/-: Lx8 ;Z 8p 0,C |$6.44ŭ{8<:o-ZԣŊBK[˖9^Ά Svm*ϢCDjLe(۲%݇s9szԹX} |YK`#nֻ7fs`$Ħ޻w~ddhTTË{z?_OdQݺu۵ c_("=qsx J=hŗ,:HScbc׮]Z(C8q@``3\IԹX} |YK`#nֻ7fs`$Ŧ/n֦MqOgF{ 2uj,m$%ōۇ6>`SM  Nábcb~鸒;ʕE۷z5JG5+Lg{6oAmܻɪH vg^ܬ5Y`nG7n dw!H"ߌM5|U\LddwUks玨^իnLLnKS8 ! CDMϾwڄұ~M{<*)9 ,ˀ 1p"$yZx$`#pAvl$Ql:}b ^9~K ގ{m# s X9>l< L Y+! CDvM)@=Uɻv?OAןY5mJkǣGzO=nii Ç>B0uj,m߻9sf\e<_bl Z |uTH/_>ҥ_)Ge 1c(mϟgyp;GZq 6Ǐ+-K;9>5/7'O%&$D;U&\]>Azι΢7;NnXm8rkMUhN".]euol` zp[-WOpu֧Ok 2vlv_0^ 6jTOV \km{d= 82$u9Nƒ/_^.GFZ5!%e/_DJ>}z:{ [$QVbJڿ|B ,YW6ONK{_NVMPTq@,,0ʟ_QwٵuSu?xpF}.>)PmWA׮]@TȩS+YkLPO%<xp aهEH*t-ÇSV?|㏷ɓoHr)V4ONţii _|1W|xx̙qgά e,:3,?ؕ.Kw7I)k۶!mV!ۡY9;nM#6=} ]J6lUx2kڵC_OKU|;k0z:ڈ􊸱,^<ݽ{Lk>A]BSz3۸ބ.=X:9 qG2gRijtʫ|,wX8;po%4 f/pi m,uW;WR)~6䰗L3MrrwKO,za#q˛Ƚ[Kv>i,H ?Rk~;sK:['q5ό6 dw!H"[ĦNi]f|zYofƳ;'SԪUȟ8]O͠Ȍڦ>WT\ TJyS?l޽)C>1jU iٻÆu|;GPGEy;:qʂc8an8P JI_pAS5uq]|CNbQ=|QEFY11QU7n_|H"\(];wN[R^I)~. p'KvjSoxcWt&tYf8(K48@-~;]@&Mpnwf9Kh^Al1YP+ 3%k\2ޏ_ 9%+n)6{p#ydR/I]6ԨQ^JvO ˀ,H?)=ݺ5.}`nE<ơw5ό6ǃ~ 6 A"6m_YxEtn<#zvǶ{{o'%ΝA6mZ籬#WGBIIq}j%?SYܖ<6֭Kv07)t^(Ld )ce)S< sv:k*CQQaO?]c RYE2kdg I{)?:qʂ45=[DFvݒ^S \@DzA]Β%{ m6|gag%&WAP %>M޽ _ (:6""=ljٲoSk%d; u0 8lq~&=Mq<7 r`$-bAow~6^;37zXF-߿_b/#9Z6)v.^Gwi{֬ay[:V~ym^QrZ +##C_8OIO;vV`/Cqc>XZFEPOZ^o~{ őo{A vz"% ܴ)?f%>d;͈gў_fz^׮Mi6bqm޼x8p`k%d;bM҃,T3ܲp>dHG嗌'xEzX8;po%4 f/pi m,*<8SfzJ]2.簗Lۅ i$4iLFLvf=}=Yb k;عsymn\875Ϥ>Anl$Elz35_7?Xza/ӟDY[UeF h^6_#-"6;6CT.Mh˗͛'8K;^]z֭ŋ,z3~XInnֳ#8D޶ طKk<PxaqpAvl$KlgaI-[cN33)m>+b@hN( YDl( 9s(tbwk(T>+T+Vpll+Wعt|"O-[ 'ysbѢ9qjRPs%_|/,=/n˟}F3.s2ڥEqq-DVFEsq vF ilp饧/ь7iF(P"D;͋W7LEz6G׮D۔Ay~9L>A-&6Ͷghl\џŃf1Ǜᖅû֯_Э[;wNbͪXB`8׋f+Bu˗J3dK^v9%+fԣ{2SOfUln7oeo06>]a$*UN ƮO ˀ86H= 6󶱯:ggZ86x?3z|x,C lRXkrv_}E,mڣ )(˓'.A@ΰOpƭFjp=p89)Ig 7k aGqI9]aˑ gȑ H\w '' &r./nS_"w:"fm|l;ľOMs,C <^vSΝ# jz٥Kڦ/\fbޭ&Mi.l^~tH1(xvRD ֤{燆(Yڵ^=DE6**i]ngj^={f Ѽ":[f?yQj'7͜q_~~=]SyÆu0-M^ZM2(22/viD5Eag ܡz # ~A#OZ١Cc:wNpb8M#kDDKkb^FRsm0` 7#oHZejH7p89q8^qx 5`ArDN7A7cٿ5or8 l唏c'cl=]! CDM)ڼymlْf ۰a +))⳩Sce͏_NUWn)D]k̘-)(~񖌌tȑ=YsA~:NTWD{FETʕ/ϛOq裗eiӀNT,mڴح[%Ec6Y)W2K;@Nz|t>X8 6 Ay062ӫK23XS¹l) 8ؗ3] /!iubE?ߪUȃgU>F6N .VҥcEIKZ^,p.7p]4G#2v_~κ#):&p|S>J&v.i:vjz@Nz|t>X8 6 Ay060b,Xv73g8wΞ=ܩHqʗSR Љ}wgÆuw݊b%s{g=o׮,BM D|㍙׮-[֟;wk1^rkT9x\S¹lȷ^sIzٶmCo&u0 ǏKT;\<ԋxNiL ?1aҢ%-Qܬ 8x9&\\GHNI#r; u##CْQ79n6wrGiN.,k~pNz|t>X8 6 Ay;w`? ~H޽ukFzϿNQ7R-Zԛ4)5k&һ׈ڿ5ڠ-"6ElS ?|z /HvЖnK?ݬYKviJ6C/ %kT9]q3xQr 皮 vq#)dl:n oa8V7:1[ur^Iҿ(M4m [A\KZ&YɉqrM4G#2vFl[o7;G94jb'5Nw?8'OM=>r,C |*6}jl;wx{ $uފ Rm mnH0I8pD fpAvl$Blj*|i:޽ݻo[Xm08M5)p8& ,pQ! CDM}AR| ,& 7 p,C 800Y,LLn,X8 6 A!6Iq``*pX $ ,YpAvl$z , @*Y`A n g)A[ Ç:m`pV&7 I dw!H"Ħ >LLnKS8 ! CDM}AR| ,& 7 p,C bNq̙<mdށML ,& 7 p,C  ;˃pzx5 _,YJ0I S7 A߀ - CDCx08spX8$wlb`Wf0I0Y`.0I$uv`61+pX $ ,YpAvl$Bl M?䑯jߴ)#v?]ׂ'iOzk߳g~hh@H_^~鸴ITQ͝-}Z,d~m._>آE=Y xv``j?d-?W\kצK6:q㠘ݛEEݼyrJZRR\Uի ȯYxMFF6ifDmۆb4UQ~vzlv$uQl9sQ _2jQ7ܹ͚եkXo#P`_f0I0Y`.0Ill:s3q,}ܴ×a7k &*ϧ>QO&MرeUtVW .gd(V['hOtt˭[>hKZFIkQ7NIϖ_=qTWzʹHagذ. m `ݺT ;x  .]E{x tf bwGOv0E%{-\[o%nrb11{ocLLTHjT{[7 I dw!H"ĦX6ch$.ɓhQCŊNO_2cIbLj{f6~|_|C;I#"j=#GHIϗ/^Zr-[͐6-CzɒEj;c bp  4޸qd9Çw-Rijz<,;/kO0e gz zW8\ADpp5R@u8w3gxŊ<>maj0w ,& 7 p,C rmH{  իM5ډx}}ZLLTʗ> OvklGYpJ5׍b`2.Bf\grr.ܬoQ(2k0-,T=k{t_.d5pAvl$2M\xbdehM uXd fѢ(FPDt[NԮ]US5 ?ﯿ 6SD{iռ*V,UBIz5U߽Q@~7Qg.@0fLoڠ+Q7lRsq<))n> .kkɦ6I)k]_?Uc(YիW._F ܾ}oa+VYic9԰Ӈ(6B ޸qDZ^d4/*֦M}^Y593OּI,oْJ/_̍FpΫ8ujejn~͋?wnXx͛g4o^w۶W 얥3#'\cN;-4:HGi3{:9!;l1n\_ɭ/i/vta0qg9 lfÅsEwsFnľ&IdBB4˂ϟO-QwYn3c!x&=0fG&f ZV r9]a 6mqtc}&BڠpkŽ>}Z,d~m~t߾!!:EkFѣKU+~{j!~4/"6 1lXv 9th ݛEEݼy5|ȝaۚ,\=]T5/T 4)boW*t;lAׯ_C__cIzbU]S"^#-=C^H/`̦nV4K#30 u?d=y\ El)A^FljＳbRs ,)v]k&XHGJS %)X?oO%o<y9l1}6=c*Yk{WOৰΝ<yb#USXEFƊb ߺuP|ukF.oPi?ŚIרrl^ʠ񏵴MY:%ył&!oV2e+WLpy7lB).q3xÍk,Y(GTZDo ґ$1d5E<>e2lXj#k`s%'۩S;v+E!^xwXcxui: ϝN]¹{7pƑ3gVw҄pLLU۩S=#`SKpg\lfIӱldgU_=qCrN9=׬bS\~rϞ-s]sYlJ P:,!!6._>HO٩XG\`끛efi'L0 6"{j!Z*}.depAvl$ҋMNk=fvG޸qd9Çw-RiGo ''7R}+i3ۅsڠtA:=z5k'dyƌ&Ũk@j-Zԣ)d4%UPy))/^Zr-[}Sڵ fcM} y|[;<Ãj!bg-S8M -]f}q͛mwP%|JY[WOɎ5Y#7;G%Ε?$ĿR'N$=bu)ŋ4joHO{CRhVt;lE ]R Gߺu>|4=~bHi!{!41YGt,?J.:ps| /p/65 tT<5w-F7B.m,[6۩X `끛efkCiO?tg" 5b ܗqhBv\ƃ~ 6 AŦewuTqYvtr95uj˖?l3C)7U?Ny87,􎡙?Xeёs3:!]JOM)V'7ޘٸqD7+fxֻdE/*.C5mZŭQ_ «P(tO/^M 玸YELȤal+(~)A^^ljﾻTԟR=4t]sYkƼ4օ6o^ٵdJέWT,'`끛u޼y@/P}B3Dos_ơ |8p,C bI)gJ8'-6“N1ZfkNŭ5jTT)}矏)S}1NӦuF?$XJ#GӫXDS6nQ?ztiWϗ.]짟8\~ ."x;piZp7N'1zaö+U*Mwm{F:ԧkl[{!41YŁw3Z?M¹N)Y /p+5۷ߊVij~~j!p]k&#zci,d<ݼy'%űzv*.\`끛f8+hpnྌCk> ! CD#w}<1FP4>믧(fxk&u5gn9 c >kxs,]x||7>bjxcp.cAQűHb^xcpaMQűB vDLCjf/FFfYMQ:0p<00"u|kw;һLbbJ.Vu_&9r7ƾ&= TL#^c0^SWq ݬS+4 D)6,C cӱ>Yspa&n:QvU݌?xpF>R\ludU߹shB6UMҥc\Uh.Sg,WPR}/bbʗ>P}*UfdpDۍH ri4kְU˱9scssKw/СE&[kXux]7bS7m/; 4vdpzMFwi…͕*>p`Ax9ᥳ`65IihI5v 5{}^xE`"4Anl$2Mm}I96cǖlYĈn-#"j@aʔA ֤Ct{7O >ٯ_6+._Z?ӺuIx>O8 (Jpp+^R?{v-r%D_C L.С14ƍӨL:K&u@uwoi !6NIguѮ] ʖ-pM曳yNA$52y:@6h v:jsddh&kLNQoŊ JT?\|EztsDZb,=~|_-0w33W=͚e4(DZfR'3ߏahAtP,N\L׮MY"k)vz`I=T^J}q0 Z"ޚ܎}L ç~d={Xv)dG,)]-jdA3I=1olRD?thQAtkwoƿZG93zA{$Py~ f_si楛矀16uW q /hk֬D)AlhvGOڵ4h;pz*?a€Mz]32.EyZE{ B]D 0-t]T"V }~3H>^p{m OM ȋ6<-4]=#ҋo{ڑ#oOk$GҘMWziЃ$ܽyw)ilR"DiYרX5< - CDzii>9>^N14gGDf*Q4k0iDpNe؂&Ibx9~ƌc~+U*}D2ۓ8N "9ƍ#;w>+m}\Y%wS}w@łzQ،3(gP0MEڅ=d$$DS{-ZԣvRO;N6 (_~A_V\B-[`e{ +V,E˖d} f`ΑF=,9b8j\cA, 8-aＳ%!{7>W q i{f҈Alh-ȥO2mق ؁׆ ~['45+yxm\&zlH=JݩP5ӊooɼ>T_ W:gp65ӷhH@:tHݎ |lsJZ|y<8#VMr$4K/>J/+z087P1x]xMlC,D&n z?Ly?/F^3"0I}Q e1Kک>f~(3s?.9;%5uj˖?l?~ ;񐎪=b|޽)PKK#߿-z6P;xpV~}6EEb3 @#0 D \ҳ[ibuꛢ)/rf+>Rڵ4JWF)8>{vmAέg 1zc#zX0sp¹ƂXB/;wXllϟRwI;\]84CeY(6XD,&65JɦNe,4pJ7o-P /g.mjd5L<5Kz{o zٜe0G25}z*T=26u¹fM@ (gDW63sUe(YFWZ5ɑq^|^؃$awob2ڽnEޏSfklxA[ bI)gJ8'-6“N9e'N$ׯ_e]6]~ŋ[kԨ/\J9 ްaku\\/~FNVoyέUj͚,V&M}>}zKX X[p7(Y?]tLQ/oرc6?/Sx_eɯ:))n>6Q/h:MNoᜎS+U۷z5ӊ+~^&%k~Ȑ~l80XbHGL1Ł;PO>DyH;\akzo̘`.k,_՞lIT6_Au2|2j~MM<<+ЌL~"s)Ro_]Իw%K@j%m4,yߠߌ=y}W5^:[fSgp*/kݫ6 Y$H0-I0pAvl$ҋMfGY58 f1mZlAwօ/PQ@qᜨ[:M,֤i>8^=Tb]:j_2xWQ(9"6=)SZDӿ[KuM㨗WK ,(޽ڵ蘲eKP.STT۹sGPhN+v:9pP(n15+}㍙<A K+IINl5ͣO=fN`J;q,9b8 wf7GI^O5f BTRla׮z jK[3<۱ 1<446q4E)@=p`?Lx"VMP{OkzOn٤=lj*8ZH槶<\:S'3/F,6u١Z|kRcLYgkoyG6uH0L7# &! CD>x6Mp00Y,LLn,X8 6 A!6Iq``*pX $ ,YpAvl$Bl :Tf0I0Y`.0I$uǁ `)``*pg9]a)/HꀏSR$Tf΂s`$bS`_&7 I dw!H"Ħ >LLnKS8 ! CDM}AR| ,& 7 p,C r!6ݴ)8ܣGsh.v7o1VM{ʕ+Okժ|2hы~ʕ̟7VUTW޼yV-GTT%m6 b?3]zMJH^zB-+VgNM6{ w'ullpʓ'_)ɓ)epQ=CCBBzjŬO(SXҮ&Fopg}&h J:sOkBC<BeK˗=))=qi11QK+_yۍIj\@v^\cFH5&Y9?Sri>)8`>"z0H6._vxv4k\}6*URZtro/_ڍ^f Sk, ! CDƱ؃ Olm6}޺uQ݌?xpFOC7ҽ{01':Raݼy]r4 hKߖFߧIHoRKVInP!;ЛL~CȲ.]һ7n1nԽ͊&)IVc~0Ñ*ª:q†*VxIlJXqqjʩ=WdS&/_s"|V58))<6eKbHvz`ԍ+|$ޠ;ۻwuS\U4@GnITo1 brTQFE0`v>z+SAywwUXn1/F/M.t * DSe嫻 ,L`.0I&xQίxD c( (V['h;:֭IԫW% =z4_z%jUVEw|晧 S(~R*T(yi H!3UyeRGPuj(DXԩ"m~F``rupy^&e2IIqDzk|ԷJיpӗbJSųx爕Η/7jTOzH~~.;)+[`TBBdɢcbױO(+ȾL1 G/e^Qg LK.R+fG=jxazK=NcH ]+R>N۔{Ӎ6v|0ڦqBP45!C:x`ƭAC:w7J^==\h I)Y$PSdE3 fx0vtUō1?x&}DO>NdqA@0>-ohbҝwݎxcؽ41Ĥ)D""j9G /s>֑khSAywy={,]?;v+%}0%v¹zE#X,C bӼZO?:}汙s|&cgȑ=RRϚ5C;-F2)ҢhҤ%+`GRРA,T~h׮3gў[NTTv>|QImYl(MɓhQb NmADpp5IՅk"ר0Jijx爕/^Zr-[`eoOe%ӆu@7]wтI##P=3g'/e^Q0n8sûRIŪ33N2ٳt\s:]ǐ2yN qm^,QM8l-V|#ViAIt.4Co2 cZlt MR 5IV4sM !]ՠ0C} OYlA@rr}#{\I˗//yNq$5)IE  eK!gΜlIKwϳlM1JsHLbIۦwPz瓭uZ ټaÔ]]6ŋ4joH$v,#U  dw!H"شJ=.^N1_l4 9y!Z\\gsvJjԖ-SB1s'/IJM=^Wh }-m.\,;GTpdEY֮]}VZ:{vmAέgtj8:G GcC:VOòeMjwz:bs^Q3uj,ۣywlbSƗ(iT0nOSP Fvd0[ V)s 37J^=2~6Clf$8j8x6Ã15'ߍ7 Rdn93sUe.ky(JOI,ыF "#C6yGAiHhr Bo)WGkבb= ^zD3Z:r"z*H6.RS(wYxc&MGFΑ`w`ks`$^l#)FLNH_ hvmJŋ[kԨ/\σ*u(v.J.FX&m?o֬Yz ScÃ^zDgoĤc>TpAB:ZroEş;^CcNҳx爕ηokb _IZ2/v+pǎC?|L]e`R7`lHӫS]*@p.e^Q*ԵkKJi͛-I%q{:Sx>et *~լwVK6v|5 f+a*E\&=37Js =ׯҥc!lfEƷIV4s ƐjIaÚE/^tơCo{R~U_FxvNx@2נI2RIaU0{*A:I}ڼ$Al@woMDϿkݻ'eשּׁ!ll*\%ݯpׅ \x9.1`f)SpvPAmJZӿY3ui#5_RҥQ˩ɦ}(?Ң~>c"٩EW! STU6^}6m.BM*-~+ahfiPKR NU,X{rlTUWAHƏbH+ȾOh$+\*5Qk)8P;( 6JJĉ<+ Y;Ui-[6bѐ]ԩH QQj֬23ӹq3,TZbc\Cj TԲk(%̆Qal'M ^UULV(1> k Jl >t0! s0"`RTکp E ( E E ( 2 hB:uP E ( E E ( 2 hB:uP E ( E E ( 2 hB:uP E ( E E ( 2 hB:uP E ( E E ( 2 hB:uP E ( EI" fVZ$aD@RЩ\(A,)J XX2rD| HB 2 hB8APD3 AFfBs8r"x<̙:þݩuiiZR7?6.`tJ~hoeڴ14~z}# 6$q,efVT *!/Xpϋ/G(?Q=n+뮻.5ޠ$n(WRh8j>33==='={'o/y͜ . HϞIA@JJZZg̲6mV|[ܼZ-b_YkJ[B2Mr{{h O j\;ֶm+UAp1d)Ԏk02 @]]VzrG$.hnn; ^ )DhvPAmj?7k~~6mV};wl4ŋ;wGԂ?Gr]^hats9S7wn^v`Aą|҉A}վ_ZZۊc  Jލ7vknOTB/SVZʓp ťAo90iR;nߺu?4BclYrep_)64q∷$G,n(*JYhm+s8͂CI=gNȑ(oD8yt#ۦgŒ!+)N aI=y2 )~v 2hFmW T a?K A,Y5l$?t)Ｓ{18d}CZ~waСgal0'dq+Q}Çg,OT.yÆݖ1`GO)c_ᇻ֣x/0JKKFܱ/Vnm7T$4P;(m?kF_i'Ƿܹc=sWKih0 v)(ȮX駯 ]zKJB__zaLn+W˗g͚\RNѽ{"[?bm~ݭd.wǎ{{ѣlt,<;Rԩ|scc~%ŖUD 81pmϜ99w?E_IIIG)Z6''*`U`B*gaD6Ĕ'\{d/:N1?~8^`۶-rFJ٣Ԡ|9k H>:EV qNZ5mYcj{71B;t,h܃Nd>ثWw)0p~Mꜜ]AxRgӥ̙+%/ }9K^N~x_"~vB.Igֶ͚)8O=˶o%Da8-M˩i/co0wK nx=R|ǹ_IQx]y2 )~vf~aF. ~FX6 "+)fi!(R3+tH#m|]v>w%$otӍd碭_F1iQTgu*SÆ ۟޿ǎme{$j(5ǹ叁kNaC*" aZfxކhii;. ׬BR<@  BiF.]V链N181/jmݺb- 8gٽqidS^_SpꧦLOI//?ǹ0X5(0&n+b% %ϟWqd_\:O &~n޼Ӹk>\qN.q؇bWwgSRpv0T?>mD8X1ǹ_~_R(O͝b߾Fs(AFmW iTmkbBPY{j{L:*''_,t0!30"j&V,kuk'ݏ};@8 GO<1h6aBƢEc0~رCs҈bA:I} H$6aݺE@:oaZľ}{SeAQ{tذۨIz!X swt5x HῸtrԘ=ZOEfA)N~''2)/{,9Sץ %% +G,˗ !~.c8HpFSyB"Èf`kS;5o^uv~\17T4wq%sO69DF0s`r2TZ2hF( wMyL°3UoY*5m:΅[omBxFcUU-!8R5ǹh뗬E^vYYx_2m^=t.C~}>Rx:~L\گuH8tFcZxyl&YCR<@  D۔ͧfgFk/&K'"QmSMmQTB6-n)-szzW_=Q2}m;XU6^}znK4 s]q',KXp%J0|rK!M H#@ZZZv(wD?^\0O&B 2 mȩdO\iͪߩX^+ efVT=єbEY&gd L{dZI 0OFY*- hEj+FK(\9M H#@vj; ֮]F-p L(jebm ż0 ŹP "*YR02 IJJݠl#B-R<@  ڦzl(΅"AQBY}FcYYܱAox<̙:þݩuiiZR7?6.6EA]wu}8-_~r\_S4oeڴ1O%~z}#I*K6$,efVT *!/Xpϋ/w<}D@w0*P| K{mk$n%WFZ|Ggfg|hࢅ".Sso*qb}X߶me{䉸ïzL ]K ;wɹ^TIGۯ~V{NgSD+D(B3(IdiܼupqFR-IH]D4-w,@DsAwphZTUU%wtfL=DtAzT~`oLlmtܹcÇq_/^<޹ W/yzkS0 }rCϪ=y}\b̶qfZn^ÅI4&!u sJKKM&ܱK.XN@!466愄Պ`PYv]tAbT.wr˫m ip&ŋg̜i?~8 v83Οŋ $&bj>{&OLOO=z™2%.%YO)N5aB /f!{ 4hP}ްqNu EAq|KRIc|s`$]wܾu ~R ٲeʕEJd{&N\)~IB熢{o6  $\:s.tӍlNg3 ohH0YԩC;7.2¤͙3r }MrtBA4&PjPO#,hbs07 ӖR#;{ }={2$f~P.W=lmo-ۃVF` TC(GE yg(|8tYq ybNN]x b,><>c y\hE?pաǏoT HfV%]UFӥΖoŚ~sHTҘ%8AinnNNN/iiikh`U].co+ևK A -{ꥯ}W?zu?wmϜizՒ#G7s)(ȮX駯 ]VzKJB__zaL󵺸n+W/Ϛ5d!{Df;x?~xm~ݭSd ޻cEAq.d_^MK-kuztӍb¤c!۷q„ vjrSpt~wSx+P]>1W[)8_Pn99Y@)(7|F9O~, =1T"Xs Eb"jQHqdy.]:AI?:,4twXe3Qoύ; ?[OG?Ҝe F` *8"w-Yzoi:]Gg{Jg_.Ze@ř;z&s@2y o3gNNffݏ%H!655Y,Yaf@Db;)@2V͞7/|#SIcR8p  Ng׮]:(x,Xh6kjjJG@DA uzbʓuO=]K_i'Ƿ?m/YRmuq3K qN))go:iٲ.Sde aU5VqH(4™z[g,-CnZLq&O7՝v /PON]TxRgӥ̙+%l+'Yw#ܝD1ׯm<M:ڵ 3krSp\. )w]~%i[):} =ߣGWh 8sٞ$fa\X(جh} Eb"e(\h9?m)5XPoZo޼,x9Yf33رu _g%j@nC +]h޺uEQTo=xc"\WTWV~8PiQ1@2ǹDHٰ!VBU,WWWg:bfO]UFv>]6>];;wIJ9(bx<vqӣ@UUl"F H^frFR6|u7WNv9~|ĉ /YRu~-\xo 9ݏL#L埂sWW?5eJ&7WN|[gn.V/XL2 Ɠ"ϟWqd_\ OZŋ~n޼Ӹ~OڡB.q؇M:Aԣcg)8|.w wSxM]LꪴX1ǹEo_DYm}GҋL0׬>H."d6Ck\u6#?vlȑؘ{~vk~A|b'339GHO>SٲL'N0@{3?.ǹ0_bURn/ٛS.P@M:bv=E%__?ku"՝oC_9 }bkZ{ߝ(X{ghJ&.@x77HxO|а(ou o0KKd- 0۹v))(W^):u}miynd,.N7*/DX(- &F"anms~6rkS3f0eIӍ=\4q!K5 !]T}#r"i;X>vn~#fM޲e_.] Gm]wes~ZR`fioȾ#fV5Pe$Qm[_j̈́ Zݧ$.q"4rC]];1͉qb BQ9Ċwn[qڠ~:uxb8l„E~Foc #VW?ŶtRSu#Ilֺu t)..Lm2 8׾}{SbbÆݖ=xS.PO?&yР~\))ŋg %/E8}@B.dS^72 9Sץ %% % #{xyX썝up̿»O =(%̺tNEh޼;w~\%R4_qe$2!m<ϙ3MTES&Ptw=n(=Őg\X(zhLO BoY0y 60 s0mt/7=#cӹv~}>Roh j@~E'#z-vRI3zkr'=]ۼt_.|a Tma=ese/qԢHYͦkfE[b~5Pe$Q&,/hzܹg$}*iLB B$%%ZcWUAx^5bj8t \YV#b ĨiɛOfϦ||Er ه`U^!h`uuurB5P!MBBjŪD7A@A T:*A>x APDF3[\\ܳgǶ`f!H(8A$0NSXevu:|ҰEtt\.8&---f9;;[TXQ9Hs@ET7Vh f:"8Aة6 r(\m,Xb6kjj _477A 0*WBq.f"))vBPX9/---nQ AccN+--;"JnD r sb F ^C(΅"AQff{KKK˖BPpb P:MMMksjϔiZNWUUUPT$(@ 0*WBq.*3l0:l), 9#MMMXMMM-..;".]X,bٸqcvv6V trz%% c@EZY˥jٌpYp1L&)~뭬bBÁGLPTrNgCC tT+'xB(AAP<͖eCeqȂNKK;@2c)...jzJBz(3fs@0p~@Oՠ ($]U544h4: 9 rx^V[WW'wDZx<&)-oll4 V5j:jN ="DQU>ZPMYÇ9SwONMӷoDmVroo6mL&Ggf҉Ξ=rL\)}uױh3-_~)vJR}N SҴo3튧?<(J˖ͬXB܄}{^|0x^U fǏo8qD{% @WAa?7k~~6m6yܱӸ/WtaU^{7حy?mө,EOw=,`\i?nF93useggҥ}-(r1E ȋmhf۴ҊDJ85Ys7q48(c.SbٲtuG{F9?}"9R(E[6 ʑ9)) q@Xd4׮]+wDB*bFc6*; \Zܱ(WAgG¶ʹA_8ryi3f4? 7;snjL_ϿㅅSwq̽N'grӃLtDpիgv[FƀۃaC [/\ԧNQ6OndsI&qt]OC=fA_gϞF[,23ӿ w 1nԩ&Lxma*ڷoo f=zرC)>Cuh0I҄"/]:ѯ_JOE}~́I tQ[`nٲ|"n2 Z_8q[om& ҹg|nn1fB~v*fM1b V +#\Ԁ`رiР~dkT/F6!]VJI5ǹ5YO{ŋgsa@1rF_"(sRzptat _hm[tZlR-ܱ23 x[ u5ت6 ϑ477ϖP B Dz`^Gۯi}cޫWs̙W_-9rya *-(ȮX駯 =ח^rX,hԩCz7OHtƎJ 2~(zۗ_AG)S2ٿ.wǎs&_Pn99Y6-eNj&&oОY&ӑt7tK'CϿYSq߻wOdSTL%t\\O*)YNM?m޼Dna ӄ"a)|DJ Ow;+.~p8w]ګWߧ]l&}t& p߾tYtEp}#uФiѣ?z^~ySD t15hnFz!P4hsAkd8ѹF: Mnl 8n dEkW}Mڇptٻw}jjf09Y/ult fG۝DD:V ;Ty#ϲ2*: u.qEii)F#P@@ΏNOLyɵGk+?~8^`۶-fM9+,'6RR4gݱ=6 Sta33رlϚ5VqHx1ӧߩC=ztݳ@3ٞ7/.[gCW޼yqνnСgYYCⶅ9(X:Ӳe3/\u6vq&*zN;I*L99YvK|gӥ̙+%/garw[6NF4AXk.\jS3UMGI'ę_V Q0Aoj+mE 8~̝0~閨y 52sKX\#sZ=Zsƀ_A:W/ϿShUK1vPe( ]s l]~~7.hiih4uuurGZcbQlfx<%11>6 n6 "r~l4?eoh>+UdI֭+֯?pὁ/w?n2lj+=^d| tw߷oQ9X;＃ٶm:.pLnM9K0J;H4yb:M>7n&0M' w5'OVK|ǹ?7o^il6k}a~K4A7 sde:RwMhmg"WZcicfYꧦLf !]/HԼ܆tu >"ks k{kW-ELܓl]TJ:?}^~y-5'^}_4Jm9TTbdG^^jl6ceNh; fC~~BFQjԤ_[t::8+1ooɸm֬?f51nlh@ ;uAl 8?]?A'OVgfs 1ca0}'v =]~ۇNOd 445Jkux+9=*/M9wv9΅UzI^.MJJO(e~I*L@N:bv=SRxRO/$ի;{wpZ_~S% plO?MIqc`ƹz555f9111//#uФ k! "\="jys2z}*[L;閮$j^nC:f8 9:w7܋"&lH7Z|]aH?)חU҇~}هE$LpEG2K֑t:ln"(EEx2 ҐIJJxrp8WjMMM ^z=Z/?jjjk#w,D MX|NֺO *`a&d,Z;6y;T8'16p00#cӹԩCJ_Bt pʅ ǹSO=|CsLӷM:{ϛݏ:,]2>)g8N!\dq.L%_M iÆݖ=Rx+%0IϩCq4]BJfu))U^7I2C?sKJJJ#Gd6OtK 8U n*pf9))IS9ёChEk?CdEzDK >lqiUOίMQT_JTQ\OOk;}o`y dEwwm{읕5Whz|Є .\~t "̠hdizZ#eVn; }\BBohh;9="H8?5ӿY3uiC~˥K'U^ح$~վϫs%x,Yju:]iipM?TBRHa`okS+J姀bn5Vt"LZ^`0D>v@XbF# `oPk(jt.K׊Dl2 rG  #r*)Y8xp'v>`@]ҐU_SIlL s‹a t:ڐ W ^Rʩ>^{4B!+R) :]1- GcccJJJiiirP__}@D1NSX-9i4ٌUq @< "Wp8WlN,臺 qwK^{ЧđA4lZ'5iEcȐ!x" TWW c[XXVelx:ɻtQp~@Ov<OYY^OJJluA*6CKx^VUdW- 766) &IXbF%fO=N'[' k,{L  ="W8 ;ɔ`XB[uA*ӹ/2PGZl&:Fx<J"nZr_l:.wGv7nk]CK._@8? sR~Tra]?vɄ |FcYYܱ2=D:_r?WGGR-//O:@ MWt2iiir)NDmH?¬V+*M,rY0@6S @ P:"Dccbh4: y^ÁFQj ;dT1%`0J&̲ܱ2jlAlר= tPy(bL= Vm>Q Dx<+Wjlr_먓h4V (fܱq @65^qƔZq "w,1˓;l6jP֥ P:N],@}6S @ P:‚)..f3pZd2e5 vYbN9 pfVna#eȖ&''TՌlUw}W@@zurN8cv{cc1R&RݹhBɮh/ C9l6v]DTQQ^4yyyxPl9[3Z5k>}j4@ɒ;"z@Z---eeez>!!b`vMMMf9&^9) At?"@uz; 0S#P8Db% ( d9K%w\as@Z@ǡnbY,wu۬V+P,h4(pV[^^.wDINNϗ;"!BVnD4XB]<"x_.]@477t:&wD+@Z&^-'w[099jq+555FQXX^2wlɤ.ϐf+**; LaZV45x؜N/9UF. P5pJ1555fK.yyyUUUX6.K՚L&n; f!سgOf`Վ=J۵AѠ.D椤} (ʓԳKLLX,!zؕ|ݮ. D̩ (~Pv][ A}}#(52&N2;lw}@Huuh)-djkk ƱZv]X e[VGGzvFJbJm0&gɒ%ZVӕb4̗FɅw+2$ S0_''''%%Ei]M4Lr`e BueH0l40@R'NXWh9\mbZJKK1Y9z6'C1//JQ+*!kI5f^666&''+͗= Cuuܱzfz+ԒD箮IaFcMM81PGgەzeeeVEQ__h p,&ra)II*c]c0zrj@t:Fܱ uU(tPgEEqEdsjDSZZZfkll;FtRY,LW ,-w,ѷ%v#YN*l9D4eeepe" IIIhZY:)f93,nNL&wDm9 Z\.0$$$X,X.z`Jk׮X[In@QJJJt&455%'''@x>UUUfYPkiis26Whosj._^qGXyt:$4Lr2$}FNNMV ҐKJJ‚% jZB)d @hq(\zlA.]}dXNqm`4].ܱj xvvjjj(Y DCDj(jtcXLXwsjT:X7l6'''L*L| JFÑhZʧYѠ 1SUmw܃N7)) Dj~2DX-$u:uUۆx4ZYrGBVK48DS hlld/cK)v$Ex^өjV+:QjtrF[=2 !GXowD(QͨUۄ"%JnժE;>8'^T]:rJrRx:4 .RRRpˀ4UUU,`pD]09>*g&kQ"(((; 6aF'$$^vqqܱPfaARPz ԸgJ}puJ@DwTD]]^;@TVVR\@Uk]anY뵴h4t@!딜@xa`Zq\}뼼<5q˗P=@zN-EE񔖖1μ#455fVUʂ P"T|X(jjjym6jndƹܱkԸMNNJ,=P^^.w,@ 2S9 /pMMMeeez>))bXzD#11nwRZZZ0 ^cX?Zc㯯XWWG" Ґ+!@2ݳl7Eƍ7HaaaFFܱ mT4(z].W^^^BBb;F1[PѨe^"w, FmkZ-wOZZ Tm7pQw/. X}ư5@q(@ t6 !!>c{%PzjZy `00|Әr ( Ul9￿wޱ-@R{RXC%&&Z,@o=ZZZ/wD :+}5@;QH剉yyy𗇝HZcj4x{@466Rfؽ{wuuueLf; P#$99j`^C {P P@m6zn`0TUUa!455Q kZ,wK%K  T[ZZPT\.kmmdbU#EEECXA5ezJј/@n_@Ԁ m2"WxTלbْg-\@hhhF&&+{uLPqPBX@@L9N q((xV\j|GINNZ{G6 qF#Um.L.zl6OHHX,g<O^^Vkc*\fYXdZ)޶$쑔qh4v=,$6&c-++co㪬ĪAV؊ONNFH9¸u].d`X---V5)) kw NXȒo0d29E8{VnƆ v특C.]P+ۍʄRI83DKuE蓶ɏlnGrr273<FX1OmmmZZZ\ v3eȊ Tшg4|'aPӡP,T Pg#p q@z555f9111//GIłf{ҧ傇 {p煳M+mT'#F;@PpP7DWVVX=F5/eRWW,a+@sBƱlNJJtN Gۭj эC4 %^/A>l6[NGyh4`\ xRcVG2j+,@477z8pJ!<ʕ+Z-uKKKὋ>t L&?Fc€u:l ^QWWGq3RMII)..`fܱA˥kZ/x|*P P2nTXz8D8 mÖtdXvxd2! s BRveJlՓ*TؓT|º-X]vvPtlz@q6x9z楥lnnpǎ+((>OMM۷_ʶmrÇ9s&, p8*.}UdQ/T~,[V#:+ځj~{ڴiA2T)u$0Z ֹ&XK%+!?FLOOFٳgc#2LjCW%P٪V98NG@|RSS+B+@sW:<OYY^OJJZ]CO?ja ŋ;wzjdlڴs+W tLssV;btt#0b.Ν;7|IbK(j͢#,@jjjN.]蘿r{!c 0J:WC.nj.XxO<̙3~g.4_5`:#Ŋ¿O:zGL2Eze^_YYZv2Bى*7chsիW6,##c>>~O`[@BPt:믿vUsss/]Bu:Uap+~UЯԧFw}'}~o~'%΅4"ХKTӀoӧTWWSF&8D8@uO>-GQ[Kpܹz?0:~xN2k…;v`~s_͛7C裏^z;w̜9W_u:lޅ IIIg.4}QM]da?#m566L&1tNأG~,ZhӦMG1 ?3)(()2 /bSNzW\ ՆFBvr mw3pEÇ;J. &`?s}Km B3f U>I @5eu6*z~0=WsېnU6֯_߭[jx03"3N7gΜW^yŋ>\xF~?JCe][[;cƌ@GYFMAgw\HM*9rNvv6bܹ֭t: ,?ǹ/RKII9{;- ]I CqKyy9efO=_ɥ?v#-\ P|.]@vݻ԰w666R,:h[O2CcϞ=ÄC\{~?k]-Cy25oUꈇkgB-v8tjIb((Cfjd# m0ߵkٜd2uJGYYYj+}ԩѣGo޼e˖={ssng˗/&tsysssDq19%Kډ/^<|y~q.<ߨ?w^J|3gԩ}`lχ9rŎ;1؅ q._v {n*ғE(s677|Ž+ /|ժA 7~k׮Z0ٳfj._;+o{e@466R,Xk٠7xV_3'K7j(a>>ɓ65JW޴iЩꈷ s!(Z-}:|9eBf ϔ pQbh4NWVVwɵèQ&O?ak 'N0`ig~ yIInO>{n[8?ZzuYq.<#?J_MVX)~a;RRRrssG#(7vӴg֬Y[l9vȑ#s+??׮]g}6h / ɓ'333SQXi3;^4Gt؆+~ 3fϽaw=O̶pB"߷o -*KHHH:ZnXIV\6[>A3`&c¾]PxzHں::T]/[ ?]+G8Yc *]t%Cu"p f\Rt:!:U裏vmq՞={nܸ'8.vm0Fcaa N _|1lذ%K<|7'OxǑ+b( A Hh! -P@@ jDH$!RB r-X>c"*)8nvv3;;3̙ٝcǎtRNviƒKwT>Nڵk7n d={,GOg~b{e=zcΝGMDDD?;KFteʔ)nݒև;5mڔv"m۶V'Ξޯܝ34>>>/m~|Μ97HK.5h?$?B1F999*=Y΋sԨQŁxB Vz gnYRN9 ]#Mf7 ph3XZZZHH[جÀEh˽[Jr"]`t`0#%pS00}a+W.c X6#kPV?0a<99e˖NR؆Dfb0ۼylELךdffnyr )Sd`0 4@f.1`*UjԨ6z׻?,((Nf:t'ObQd&׭0VXXs+s[`0""7!!Oe1=CF?XQJMMyah_F ȟBLm/WuؓbQ4ih s.[0],''B3WPk'W@`.7|֌ƞ=F Lh$v???DR f1yaDϣe<fRTr׮]>z{{S*e u ڶm[||<[ {yy\ ={64̝"|H-''!zjPJcΦU2JTwcbb}_JJ˟ u(oժp✮TLLLʕEs~cJ#Ɯc5^]f˖-W0'y4숱V*U$$$nC}P &44M/O=$&&Rt`nm۶Rȸk.`B=n is >G'QLa/M( ...NIIli^jՅ |||(i:wըQ)Wi!^F< qތF)k8Ctf?SH!!!tM+D|>ot7?IBTvrn`0=XB0+I( 3M`8`3yx53ܓB4_fB~`\ɟR36k^XXH"sZ$)>s͛7<ɟEg9 4R759^{54!!r-}?}9gst7ѳ- 1133 4FꦤW>;;::t7) 0}ƞG]TT'Q h}||DrA1e؜ *((лR0+~{ԨQԵ7~֜%;i$'\4>"##TB}reff֬Y󩧞_`sf̘Ѹqc5Q7tPdH y*FxD-%FC~{\\{#Zٽ{w*``0L`0ZDDDǎ$jq833$:GQ1^K0[hЪUCE7Ѭ9WCsooo|#f4 iҤɳ>TbN s|||_L,**_`$+WRSS*lڴhZiӌSE}ԵkWD M`8`n]v)SOnlA8_͝;jժUTA\nΝPR\֮]"#ըQ5<]VVҕ+ h$`T5gŏ!IF`V=ܣ<9;;/oՆ sGEG [ׇ]X ,)pG90p8#DFvyϯnjsv^%)tqС*Udddlذ!%%%>>~ҤI!!!~~~$ A@0MM8 &΁9@ FQѶQꦤa|c#m5UC޼fjׯ5cvHZ7Lի=x=OW㏹\h*on.~Pl±pKde%rzݺ5֔Paa HzRr MA7fY6HKn?{CqɅC ''52uf3/\8:H\@J֓$ FL@(h )7 4nnZ8484)<#6vh>k pZ3e/0'ō>ʪV;''+'lѢ!]v:رHW\z6tǝ;'5kVk瓪_=Vt%As9nւC6oހޞ:I_}.%i)Ǐ jFm:ujyQ  hur~~uSRmڴk׮N:ۉ'޸qcȑޣG۷qʗ/߳g]v[~Μ9TڵQn,?>sAA{l٭|rDpp뜜Ծ};6;ujfā7n?:<ݴiCik'PAcMgް, v`( I 7 7 pL;̙NʜwŘ)--Z{݀^81qƖOf͚ dz5iii&MR8?ܹsp GFvy*7jHϞk֬O '.?U8-m֤I׆akOfM;vlۓo׺ݠ&ˀءy IÂ1PZ<x8p@kf7k()Ĺx`Ey=$u\>n:~ށy W3!a7;pPh=uޛYk?-Z/ <ＳΈT99e`EWT5?ޥa:j*i'eOUrj+#{LF8 K/֭[?}E ''O֤7;p Kcd/}b[šfi a;uL:Dl{6b/矏z {i֍D+#{L/E'Ol׮۷i͐!C6m7oޜLoذ{;w.ݩS˗&'OI裬jռ)rpN<ޮ]s6>dHM;w.| ֭š5]vBsHMFӼt- qf%}ߕ+XFKc|˔<垖{Ågks@찋Y"@r!5dȊXd644@Fҷ$ CcOp@ ,yȏ?RߤuGj{ŋ: ,rB<PܬA0Gb؝S?q+Gȣ>jyb&m<5Qg^9G{iW/}$csLc5PvKc9]exE-Z4,S%smР΢ESwo{#RS[nDos8W\?3?8֦MJ*ANZǎaÜkw߽_}\IxLϞ{F))O#\d jdXJ?qN ҥ˔)SnݺU\\ܴiΝ;g{~~~uiР?gΜ *:-/ſzO@@#56׹sk6qN̛7!$$K)SuP:q';uW@Q4[#NoI jU=}L$YI*KڥwTvn,bvHf9u qi~:bDOoȓV@XC9mی6f}mp64WRJշ$ CcOp_0KRX8ｷy̵寤n5XV\*VdzώmjzkH+4nhݬRjԨ\oy䄕D 7kXAS{\RVSR,S2qn7=]\R!(.`ĹJ—6:p3Ͽ.~5&s"#L!֎mP7}nR+)Ki99yJOP )}OF>j7U/۩#v X6\xVzyڴ͉Oi!2OB}v"ںu#6YT6y`긏?̼#G^>{)PY118Ĺ z%_woPܹsGWP xʿr϶-[vԨޔ7 !=l(>OGuww_`{w0USTT_r嘘 jb%ʕ]YrH#l "+"BE{viU5*6]oõ}^"[(b3t}.֐1y௿CI F,MdDVS|%uPJjZ@ġ1'8ݯrv%\*_vj+]vcو>~|u۶wK~nJJ~0Us fEUK7kXYS{_}!rԺ=Ĺ,NtXtnFq)>t$j |#3-zNB`R}B Lo{˔7:H_r%ݥKJOP )0n`ޛF3`޽C?seΝ &W۳gkNJd36b}x~?t{bcv&۷Ξ8|r_~8[7|}kuRr/;esSM!ʕ\Vƍ}E'.[:tʔi i"w`]˅S\\uV GtիFDt~5t_|zӦnߞLoOLH "$ %ۥ꨼vԨt]%V@9 OiA#%~ k(s2 pm")uPJjZ@ġ1'8 a<̤#hc/ o,X6⫬e9eHHCUJMav7_|:ðyAA8{Y=`If FlݚdkciWY ʕ};=`ݯYfw*HUԩ{ieOqD{2y$[S{ɓygǹ,NtXtWR9TssQ*%>dSLMt쳷fNͻ㌟ʘ28m̴mI ԡ}2bϞ˗ct`=rāoԭ{]) D82y|۸YclU{_2!& ޒ.X6dd믧p%I*Œ޽;؊:U~Np?Ν i͜9c &iy)e˖m۶v+ &Urӏ >I_\o W[vlSچm̄| ~#X^*iyeOɮ "9Юޝ\yh1}zm:g.K2^tJ[#?q@`drsO6 )$ڿ[o=O׮[4J:&mɞ}>>[V@y=HoUr%76HOUr%ZWd)[lxyTkH2vl?/ ?tLrڵ+22J*!!!YYYW\pJ&R:Ӳe&&|ٞ8P&]ڡkGMeA찋Y"93(Ju}hA# k(*b%eJS(mYMnTRn%#I'8v_0KҤ…S(-ҍe#CĹ7 nV?8x{%*ܓn #)L_wO kډs9ťнL;@[ O6fӓs/H>^iy AЧf}'dk>(ȩSP,?* ڭ-ٕ@SfwFăK2m ѧo.GO ZB:ujg  Z~-Z4X-[>J-'c؄EsW'V@y+v;X%GJ*feɓW^y+FF*T[hҤI>>>~~~)))ΝpdQ&utDoo,.W5qɉDv\K;QyV@Tz,j0EV@:gE᧙siPm/_Pyi 'mYM +)l%娤JF4&8tbL!3Qt\{`o8O>ɞ?- LÂKo^-:Νǻ2C61ܹc^dZl矏:.CGiS|iefνt*:o~ȑڶmvLh}Fn3gFCv0!{^ͣzQz &~ r%Wtg_mLy|̘T79>D{w5{ڡ^-Xt(t^115MԶXN0 4i)K/=sl9--m鲛8p-SyƢC}/^숨po|Î[gb zڝvDky ZR֭{~X9W]n,ӧ#B@zy&ؑLoSݤCDbiQjƢCz睍,lcJ{B '..nʕlyϞ=CY&!C,}|HZmXPm%nƗFfTWUDqDtjI4U\{O(  8,P ܬnVaTW{ٲnMbEuIhg7Q2C[%"7нwLO8p=nAݷNe}ttO?N 5̬-[^9kxˤ:aBu2:g |e 'ݻjȐ;iM =6-&f\nsY/&Ν6^Pm,:Ĺm5XWR4 nc 'wikKLC8 655C=Գg;wNstMnƗFfTW5;ԪUҡTDqDzjt9lid)*W)P.P <<pYYܬ򨊯75ＳqڴVy&p>!%Tj.܏9=9kw޻܏u&Ω[S̹.\x*ɉESRuϯYO+gC;~Ç2g߈=oq%ؿ;}K]zhcs۶]|_N[dhsٽ{}t:sY/&Ν6^PVCx(td'EMm)ʕ| o۾};$5Y|YrjjO?mkKLC8 GN5Um>HMHDu3423R丂Ʊ/ft(;Q=4@.-`U61=> Tnn!7<Vw3gF)+ٛVy&p>!%T:1q.rz|fC~3qNz0 ;wNcnddCve[]㏳h lҰaTZ !$&m͚?zth=߱D}s̘ԡ]CssW޾]ح[Ft]HsY/&Ν6}nV(td'EMm)ʕӫW{(nQ}YF]vƍ'Oʳg޾}[gqH8;;m~~[bT+J"?UtMT7K@#3c*9Qy:ʺѩCJ$r Vesӣ#@@%HH9fJfrʣ*ävk޼[Ihg7QOE"7qi;t]:,ZHJٳgq'pVœ{P)UV*$_v_8w\ׯ_R%ZHNNp1T;,$ (x$p->sĹp`׮EGvFq'pVœ{pcA@CRN <YxfW9`D8$$0#P.h ,h ,Q0q"NP@(4n4n(8'p `( I 7 7 p0L9Lo  e$ fFra0LS`0M n9j Y(iݧR_ q @ H3 p  $ r@Sf@Sfs`px8@)p)pG90p8<HCI`F\YY؜8fzD7fzp`n f($a03 `, ijp0QKBI>2jP@(4n4n(8'p `( I 7 7 pLs@8Á0$fMM8J'ιV{ԟXĶ t?`Upx8$aYM8Ji'ވb7{-~> p  )$ "L\0/p)pGqĹJ p  )$ "L\0/p)pG90p8<HCa IbtS( ,h ,QzT ˕+pjsvagΌȘ{`D'O֝Hm4z5OOlذ#*_-k{]ٷo'E/}-Z4];1|"&Mqc'_9ƍ}G}㏹D>t?VgjJN{3G= e˖e`Gж|WlD1lҡ-:M};y1X .g/ {&M3Sוݞ6yxYUV!.EӠf4mIk֫3Em'u:hyeL!I2i,7\*z9 _ZIo^݇ƦP&v4p͞\F S3Fk\.Bes.n4^mňэ˩Xrfm4dfURƙC/WHrZ[Sc sƾ5ĪU>ZS͛7N&$p3v6mooȯT;mm}}k=O]\VU)2M~1m!:M[.B/LAnāޅwx_7~|DfjBofs Gevm(+iۑ̋I%`7H/PfF篕^!upԽBpԹsQ)-I>4ӹyȑW~UMVG<1u,VɖER4S~ekt8}hlX| &!hǐ|B2>vlzrV5![F>G8li"Ý (Fn4m^ζ?4vfm5dfEUr>كmXS2-[+k3?ǎ|Wz]BBEFv/<Gj1+W>C1ØNNMֆ:'q#^݇i{ܸ˗ٳ} OHcի}NN*[y #̙3& Q``k?s&_x/@ tHJEС aG<:&]{)O?޽mlPz;fL_:~tt[aV~AZ[ GM{ ֿ0s7y]!BU/Ձ>_hν{w%pÆ9SlРB[I f!G DaތuF[l#쀲cy6+"W*FiʖwEY+vdK׮]s*nsEB"ɼT| `OM jÆuΝ-Ye ^ ] p5ӔJ)/oU&o*۷2XQԖz ,:ɔӫ[w7/ cJL޶"VP)%KM8[&e X?+Wn2~\T6R '!.i1aN.RZnDB~-\(j!CRR 9<ĝNLsCJ݅k"Y5FͅI,Yd~|Af?G_ٟ8K3^?O[Z)7ׯMz1&DJ?@_~9AS<| 隢mA|VJ50`S#^͚2;v$/ jFN =#c6)uu_UOo7oN8ĕLzGWm~89R[;IVJI5yu&-Z7{#^6vgCkFI[ ֮]OG9#FY"i5XFuLi_7zaUT.vpghgHMZչZ5o!EQh+i,$-m֌ٹ _!HM7sfW2Ԥ֓v v@ixpͨ|ELK(m[i$ _ abNZ" VD/W.Bؑ̋I%[CzAl(q6};^BRpB]9:MY)-[ K#@:U@eVӡri`@Z>xƐ4ڲK8-Bhp_U(T ~ؚ8WNEr5&ǀULy!|Ky 42Yn&nݚ4}0 VKFCHs))ϟ$܆'?'O5J144 lBۋĹhHuHŤNGGFv]6׮FޅpsPug[˗4_EmiHAרC<|hyŋ2epIgB:"ܹ!X,rEa7Ph;OP8WHEr5T&ĀULy!iǰf?֮]v!EFvQVjhXBe#>pYpW4`tipn٬p=Yy? #_W'.c}JWzK+\WRŦM1e Ti>ik0q0`S#R~nxR/)y]hЃL<9ۅܹ1e=ЋyeEE?mw-\8,vv[CrL:=>b'{lVCX<ϚѤ /|VBEYףGWOkӦ1b7{LfHHnbu i MZX8fT"=D{bm[Q®(+9|~ST"E^ֈ [(֑̋I% 8{EBعs!H8r_GBRpšV&)&''4ʕ|嫢-m8D${w/<5Z=Hi@֍PX$vǮϚwȟWZ5 ~],Va6%ԫ4C!%v2tT`*ͻ|o4p\!퍼RH&W5kV+ +qQ`d4TCF39*G|&u]+r:7F#F76?4&ufr~|߿?q>awrEGNZ|8BJ6("۬.]Uzt#\t 0`S#i~ydzvY:dHMȵy'do߂N YO? vԩGV/)Nk_ߤKc}w_/l(ŎIb^YbMbgjv>V=k7vE j޽}Q_NԭcY''OIo?(*Bhlm(E4(L ;h5kVcj/} Wrxā-Z4dP8 i3*\"R1JVZ+ʄۓ)֮]]>x |};y1NK/P7hl#88r_GBRpmAM49RٗJ=rJVQ*Җ^/[?k:&e}t4{ggϧ7 "Iߘ13巛n`bM\{{kR5d X?+Wn2~ \5Tw)tE[71hvC9l?ܒٳN'rjո(GL4w:1naR7+ufbn4m^[n\"E6k@yL69-cZ1y^yhmr-i֯ݹskBDDgyGjQI70`TA_¼yBB(zM8vӦH҉sDP$c1e=WY6IK%\ґ |V N#&>[?nTTŋn0!ݖ-/9 Ntt_z;"eAB9V*+2[f\N Rl hD>vɒid&*NtKyiӆmRh+i۶-r;+cv(7n^w)u v@Ʊpd!+me&Lj8jJ))KP>ʕ$"lE(;y1NK/(͈F."r_WA{p5Ӕ%t^uԠЀRg>|U-#^)ٿyNomKf.*7sQ\$ӐM3lYvIcL yh&F.i10+ڍYd.٬ lMF8$$0#P.h ,h ,Q0q"NP@(4n4n(8'p `( I 7 7 pLs@8Á0$fMM8J'ι>]֟?+`=px8$aYM8 &Og{Y@8Á0&$F7 ( ,h ,Q\9qVz p  I$ $7 7 p<D8$0$1oD`Vf@Sf₉sޜxɓÆu :to߾E xk'heVV8}:F٫v깹+gΌȘD J 4iƍ _Za:3ߗi:n\nS lwuJQG(;q"K,Y'k 3q^Ի1i/V=#hի^p9Ma>~$y~tFϞ2栗7oJ_sLka#̩:*UnkO?N~a8nhY9wL[Ey*t'NH]x?8Gt.HḤk)mMCey&Jd->VΦE%Ν[ǏOiOi<˕UuyȑW޼;_~%AaI~t|-ȖeMVҠAku!,D_DQ]vyc3qNch{ 9}-3:\4qnxdՄ 3gFٳ[jzw6p\>W2Z,YN'Lg~aM˴@_xi{!-WWn̘O۾}~8|f;gߢ]hiӆFEaGjKE9}G}{ХK sl֭±ck׼{dfΕNʕǏۅv|챦Wv+61q|N-Ȕ-?bRF4(JĹ1fɁފ6ۢ.wf֗ƍ_|9-Z4j׫WT,Jx=gΘFM֮}N̙LZaZ&=P11~eUveRΣc?ޅAO*!.K[I)Dݵkʊ:M*jaAS,JВ{C=zIQbT8R]K{eCd/Hڝ/=^TҮ(-B$ζd؊GΦ$e*MĒI_p߾t|Z8r䕐R\dd~^E[KEg˥ɓiFh^vK}wu0j"IN26(-5(\t1aGT pɒiS<ֳ;9B*Jn2O0rT[і #; q0$ER=۶mFBfwilM(}L:_y:Ѽylckl <-Y/!|睍4^Kz/]tiT":eoY B["c3x)2{gzK+ې]￟"JN+CS3f[7:{v sjK͚ծ_?I룢wH.*F\h*Nr˗8~/WZcU;bh-IDv8&{h{*n(6uf,fЎY,"h%~ژ8w9p* .wf֗ߪR~zys"yad:;d;m~8u_~c/wj|3kEsr*BH$ZCmwV٘'ԯpYJOAx؛7 VɓYR#mRi ֙OQhI[^͚1c8W(4<&i+s'@Z#`kw`JL*iWĖd(#~AI9NIŲlS4h[ʕ+Kx2B+iD%F$:[.LҸTn Xyٝ/[a^: ly%)m^ᕒ6(\te5t8T ~[8w:UQr\ |+ -̏”G"ʷ;pE٩^8&Hx tmHE&B1p~ѡe3 ,͞=eaљmhxdpӦ{H.jݻ5lXGvP#mp[f͚{cyy^{qpbm+9c+PJHףGu5Q(`L>l͚x O(:u ¹Vl?RbxΝ;?l2D\ [߾}G}t&))v |B2[8gk֮}n„K'a̅.K[I?R3(9iJDX4NLBKrw;7ncjyL*Vhsi:wnl#H`$l펉s'0]Q[B*94x/(;I7)Xg[˗c_@lΖKPtr-мΗBX,^<:OyWJڰҞp-ոSNWrcG|U*WC}.gv`JfQy$НsE٩^8&HY:-"=PvtϖS>͛ *RP\>>tܺhl nsd|f1qlq;f78zR u~Nz?}gP$UPNA7=}P?+X֡pѨEq\ɟy9 U:y`i(C 1`S)Qov![l-[^oG<LdH)DE?m7F*;|8ݗe!]>Pb3@A*qηpYJO|HIm",Ht_}2O>VhI[^JQPxLqM웡z G\H{T'@Z#`kwL;I%IC: LB<$8ɉ`= 9oR&;8? N"jIQU4Lt\:HweF;_=HuFT LyEIa=G[,u"Z(A iSBzQ7UQrkjr9 !&U4(0BwruwV0UN;`"QP -lz]Gg wq\N r҅mۂ/lңI\&Α"ı CD/:pI>V QIɓFۏ>ʪV;'' Բ壗/eow4oހS7W}{r+kWWvĉ[h֟<ޮ]s֧ Jb޽}_Nԭ냉scR(B|gNIv-ʐM':$;+KʩS47iyw-l۬Y}rugժgNE84q.m%ʏDpM*m[$چAa-i˱ם;֤5kVc1pN[eJ(m=:v[eTҮ(DB*eoe'ɹ1Nq6% QfTnF;ZkĈ+W>#ʁΖKOI#>}:Zyٝ/cΞOk^=yWJڰҞp-|=8~oz=pMl[j,,\i Pna~ ըuw nV9AbTj"C'k)},7dOeX~tfk!!PBHCݱc*ڇ>}啧e$mp[»"Lfzıs[ƴ>c-[ =~@@# U,F=o۶#O[|2FE_xAӦ:wnf ?lXw9l+^w''8oބ.]Ly8+: xnsuÀS'iu!3K'ΉmegS6JTFII``Y.iР·nJlBP#G"]Esr*݁ lyȑWt+4bw/BDv&Υ$ Bڤ6 }h0mP߷ -i˱*Q?44^)vCiyL*Vhs> R1J[Oid;݅*1]Q֡IH&߽ 'ۊGΦ$nS_NPԩA%SBi/Pm#":fh+=}ltzZyٝ/cd%)m^ѕ5|[VVCE1(Bx+y`, 9|U*WCe.g`Jr Ga BV{0;իGXYN1AI35&ZW9qN4lX=`OiCBh_ߌZփԽ[J"q{}|˝ңI\z}Ewfzsb%z\=iġPoJ;wNS?3~E~{@Kd1f4_!OS7N5֞Ǥ‘:mGkL*,ۜb4ܤ-fHRd5DlPhw-0rrFh*@NI,pˌΔAB)lcR7lVj3̛75b1jӎ-[>z:߀ܾ]ؿpAz7̙Q;ICÏ=oBHǹΦp!.RTFYǤQ&ɖ1r-8n$-0&u ,3:S Q"1E6u5P'F8$$0#P.h ,h ,Q0q"NP@(4n4n(8'p79pQtLNWMN/|nݺuFu\Ba%LHBA,BU 9 1!0TDž V$Da!T1"PP08w{]/Dޡ?+}bC(a8 @(I"rB(bEa!TU@^$BV( PpP&PX D("PPa.a6 B(ի/P:.L&P$ E*,VEj pΣQ-5 qa0I"QX.BUVEj pn8b]~MDary}[7m޼ 7\/ ͋m;*٫]+5N.o(2ϓ{թSrj Z#]ԉ̟?!?qǿ(W?2Z5WPn?ƊH?ATUEZ˫]WquF{k L TGD Za5[`5B*?hl\Q풐_~֐! t6-]zkщjӓw^v@&)߾}3HO'oNf))#zt~ucҤa111e=Ɲ%Kvڦ{v[ݷo_ҧO#yaz|o>X"=qblРoWkx4+?gθ Ο?b>YhoSz^-{u(\VZ~Ps@ȫdž"pn6z :w>O^b=3*y2nӦ@*C]ntt/3@toOS;qoYj+ҥ4oi.w${쮷O%&v>p 9DYhee͒J^kgX [~~SfCǎmf"$xZ5 VP~P5w- y~ڵR0F{k뫃 BuDVLjE8s̒yy {@bK6wN8tyǎm?\|\B>:p)HEBY'pv(^/;EFRaI?8?Q'gڰafpW0ZMj.ի昑#Jl 6j b7nxQə0!i,s?|O?&_RV4:cϼ?6[4o7EQmr{M v鄲Ɩ l^L3Rȷ߾{?P jڴǽ_rB4+kQ>R"?h^UN[/ն0O滢dž"pm<އ`TUQ*S?!}:2|uR7|sP>(\7:}׍Η̟>&`[_u4SSS=2CKM17/R[>wxc#-N3{ree5uq2yprgY%pn1#D9ݲHTV^;m *BMRW,gD(B-ܵ. ?Z)}W}D+fU,8U=p燧s. NkM6/|\lhjjX >?74bWc̕^:~{G7dG9{vQ^5˪UoP5s}Nδo;^.׻qqq\o}W<[n4u!ݒx晌s[^GJtS9R͋n7ZoUʕ'O84:/D+YGV[4o7ECE5$q}|z}յsQɼ?q믓)ɬ&񝯥K2$Aq㆒WNaM#Gݹsy5Ս7=6LcFz{ *Ɵ*5pqDXO% fyL^[W2 dfNW9<0D5^ntt/3/?} :L@W$1e=hӗ~e7~b)F^J;/;Tl,ıwxkmeŌht͚TEI#EF ʟ"O\sһ7F{28VX͚jE8˝.;7jw&ɫ%cՃNMM֭k%{HIw^7/JK-V7t_`0ի~ۘKu\2YcE?AWv=Գewŭg{WZ=> 1h 4+۴iu\?&]*ZƗ9=xh-P[uTZt=h̘;w.mV2)"0F~]rvmcq;\>L}L&CQUNQ?{ɓ{,S?#=7=6LcFz{ 'K?׮b13*y2e*c½={|~Q`zҎw\7}*%i"U +a:th¯u6b#Io.i#Gլp2`, UbFsyC]s݃5I}ijhH_A3VD G"r]˫#7d+>we#"p3Y)z}oV8=uD~}/+7n#%%zW9:T cNrOnJNرqwg;YuWo9h1=:Ƿkgw$n]Q^sG=gώرwܹ(H_NӫW'xϝ;.5WoW5iҰJ cƌ{;ujmz9sOwo͛]~hMT/Z4FG={n½>c׍Η̟>&Pi\x7/9WpxT}5ҼO<1K|?_ىnqIGJOw=}jgeAR=+^|1ʕ^k+BMR,Z5WPUzT{$`t(SZk]HU`Z28VXͪ4Yqz<̒b0}U^Ţ;|x1c&OW1J.׻۷ ׻jݻ[hZ5ߟsW<BIL:iҰ%55oDF ɓKeRgϾ_ݵTEkq8EԣG={Vo~ΝoaE^'LHR.ܹ ~5˺5r7m_'uz\91~`8 NOe,aP{m*^D㒐x 6zܣ{£L72~Ͳzp}k62{^kСؗޓ-:&e3g^ +^7=6Lc\wszO0u;>yVwğV noӁזU;^j(ڽ{Y ׍Nue%D X'#o7JtXl-۶-6^/1Ⱦb_ܿνUd%'Svn\Z[8,t8:#(SsTKTWF ұ"OUUjCG7,vF{ks=_:" Ycc5"KUAWO#x W?b>._>LOgY-$5ԩ_zfLDt;|{BcDupPU,?JudY0~XeDgk_a2Ԕ)9Cj^(58V *B-7[GZB(RD Za5J"8T˖D:Iuzj-SPeeǷA]+5¿֚?B~W#䪃ebvT'޽]^A^itYF? U<|2p>`(BMpŗNJ n$Da!TpaP=~5dI5p _tS= Tup8b9P$ E  lQ(|8@`@H9"QX.BUaKs*=p>]t׵mkiӼ[Gʜ9;VioCm1zͅǷ'|au&E]+5ϟ8NЬ_H5$䲊-;W5՛σ'j髒Z?K` BEMF!XT^ ˫V6cfՂrNV>rm~5GTT,*~<)we/Ok(-J˘9<֭6ohE?dSS ޹ZN9ڴ͚5nVq,ɢcPem[j?/\8ڭ[[樼^~F7XUf`sr3]`b  ϝ+>=yMKU] u;vlG k2;?3U5G]tY7qMFbQWK Lr? TQycU[mk3cfՂrNV>Z5m6ۍ )TzR,>(z9| ҫk@撽zj\|-'hdT'Ofoޟ }ʉu*Վp M4K6.NvI۫WKMٳgQ>d5k߿]wuNK}Iǔ)7ǔ!nM)=}>LRR9sM4`@7 @' oKݓ̜.G f̸ҥc=wR˙3=ojƱ~>}⍟֫(G?)9}!lժX4~P/|kȐ9;liBUlMTzG4>QpaHXèݏ]7l@z/5H5CթSk*a?I[I'Q{\s6(٫H9'NlS9Pl<*ՙ;6cq_XuqoYj[/-{D]Uջ֭ڵsfϾ_BoaD#ݻY)bGROmV=%_kT\ }>\'O]]Q&89h1.Y2k6ݻ۲QsAWݖ3/OMM5碏?ŹuR$x*1 Ǡ#;W,맯{Iu,pV,5 Wuׇ4c[B>J8s̒ ^7lܸ,yg8 Yl'_^ݺukJ$Æ*K6}KRڅ G%G<{^I9ϡe@$$tA2ǏX?\|\2ŵ7L>G66Z<㤼>)r,~Rr c)tLʗX7AΛ:Ylf\^촴6 0?;{-hL6z{D)\wo/kj.;xFu1*j͍Zϟஸ&Å\18>ՙ;F3ոd1L)Pŋ&=p^"LT ?&YUFGܾC~ؑ䈡+Nbz˭jz JkT\ kph TME=kܣwYwE̞G4"&we#*O_Wެ(ٗ S ޹?O>Na>3g_ur)[~'Gٳ+,{r'r>}j/FAu{ڴzuڵ!R-t΅S)pǼ333 %i!UԽ{f$ }IbcoADw;.}hȐl A\by+g-^ݧO?g*姨_ly455zBXZ ,jx]Ckj*B-W ~qn]] zufGnR9ÈV sq{6mZ8ypsW_e_,YzN_?wxqyUb%Ya~Ca+vů]pٹQ5I^%-9 dY*W?#_U=K_Q}W84gJ!>%2;9f˹l9sS]t׮Ǔz,o2У~x'6'X4~PwڵnE r$\.Wvvv\\ܸqJJJj0|CܓΛ eȫL_K}a4=+ e4~]oDhW1mn}F4xp>(w3F} 5xa%On1X{j0r7$9n6~{:7|E&Nq#β{>ޟ/w85)3=}=Us}ݵg y+WN*vſy\י%9 .^Z,U2p`ٳ#~> Acc#Ό-sSeA~q/[\>}*,7o"RiqoF) NRGBv{|||aaa ÷9 ʟs϶Mū(z\cݍ{Dz8nT=M]q]' o87Jj)_a6h۬Yy\#U1'̅*3wxmN=Z5b)%Tz,[ZUGr%$$𹼭1è9TGYY:wA*ڵQ8-j(Xk C^TA"TsG5eL upDJ1˗O8{vzu3pVsxQ SSiU pHn;@R3s!丸ܳgրa`(b*;E HBAn;@BH8NQ9"Wx!]Da!T-Q*0GBcbb4 EBsB!rB(m[Uu ә#1"P$ E  l!pWw$˳5j4ydYP  T0w B(,!*vFr˕7nܸ 5(bUSU%s&@B P E*,XB .+//f%%%۷zcנ8Bs pjPPs_XXk3נ8Bs pjPq\=z^pp=i5onmϝ+믿m[ۛ!F JZnjG ׮HO浆m1귒;lݤTUZ%T%ϟ?!?qg8T͛pʓڼy/RVhﾻz7YmwJZR$rGi휣Em6[U;^(^g՚tqiӼ[G| 6#n;@B 4EEEIIIv=??rk2;?3UyP.x{ұo?oil]+1 &vP?d?@k k0pn~\Ƀ{=TWU2J|xǎs`S\ e2YEHv5ieGcVeI$<:b5NSl&nah5!}uVJ0Z]C꟣U-[f|!$sD\ej {,VX }5#n;@B ]ZZp8ⲳϞ=붼_3j#){%$!o=68|s挛0!inC̜~]^tlҤa111e=ʕzQ7pС:ujm|yذ^EE9۾}e{9}U֭E7owfw̴/$2:{|*G)/C-U U\91}zr~]zꔞ>N>'zQǭZ5}/Iʨ/|kȐ9;liBݭ/Qlq#M6]T9qb_7MJzdR0jT_A:˹cǶ<>q=:zCf|}/*t5Q,w%=V ^ ğ B(<Zhɒ]޽ݖ-Yۛeyeگ /W AۭZ Q›%ݿ-ܮ9G9Jnm׮3{*_zkщ*G&ݻI99ESGQRRFHϜ/.G2ȧ~u54W׬ZS7((Mop}Ma 5q:~ώ=^h/,o%Ӽl7pᨤ'LHڻ7Kʄʻ?~p~b!nj.׻7@>lʒ-[vZsr儸YY ƨ/%-+k$;kUfٺO^dsQ^gN]>5T6l>?h~z=,Ke&j-7H|]c3'_>d?k^}yOpW=?HMJ~'-N Ts9w-?ߔC_T{ܹuW :A_`^%,fGa8r|_.b|a1?[nY^ʔ>%?(k Пݭ_njCQm#a_ZKsȎߥܾRT &?xJ>1^䈏p봮W?W&"*Uk=Wn] }}Ma 5CŇIOWVosaO?ʟudLmn*=w͛Z5W3g+p.Xq{i_dK6V?8fr}0*-.^4dH87Lz;#GoYhRS{iFB֥K%=.5KVM%3צS%\9˸:'%pT|\üBg3ǎ[Z jǼ,g1? ?bLbҭR,}/1^:~{G7y}4qB}=:5ޜ%ݿ-ܮ9G8wW|O|"pnlKLݰaŹh˖GSSFU5֔+6~8{j^&-mtF7˫9|㡽濶B*o%g3^K|M^5ke׮ǓzqȞ=+ e|[#Z;Ez͟Za1jcRL}{]_> 1t=B XT{6m]=ɑ卾Z jb!s,1UyX gw ū3eՠhYFڛsk_ZKs41cܹE[bXMIC;fi3g~zJ%Sׯ'~w6o^6j~?Ⱥʾf՚ts|k/DMS%ӗ|G7Qc-S{;vl8?yrO^ "\Z=*M~I[;8l~FfedLR cԿy^O_wd?o׽&jҪaz ՟o孯{FnosWg̸S־N˫ H\\,s+rN_` }/IsOiF%Xl&jA_'nAa5:-]wu曃9薥eGN|_Ik П-Δ/V[g koέykI/snj́?E[5k,+)ֻwbСesk_OrOnjxsyT{]ejMYGȧO=GU\CNa 5/׈[3nKJ)Р9lKT%!o-YL-KML:p`ٳWZ-E=ztسgEnZn&꫟\Ufg(ǝ4iŋ uy&RZs޵k{H;];Gǯ>qz== Iϔ抋3gN}/I>J#p..}>D*qou(YrrsǗNs4mV,_MJr{8fcPAc\#pX w챨w5i{Y{|xoUjjرwE))#UA9D\ejMYq{˧7~}=^`v5s%8K#;?3ukk} X}U/kVÅ]E 㭞j-sNWZxnHVq[O,R%(BswZn8+`Oڜ&³\a 5/_rn.q)+kVη?5^\vdԨ'Nl|l6?\׶R@t:[XEʲE6pj\u~*|??=>G4-m[Xx~s-ѣCUGxP7q\ 233 !#PPPkrq \wCz!GYYYfffKJJ*,,T XB(m[XxJkJKw9bٳB:.?iҰ ~6;c 9s̸8ño>- !#PPPB=H&P:n)==^G @dDY@p\qqq'O.-- uu"YPl6^XX^G@ED&EIII%%%@dt:GLLLJJ;ss.+//f['@]FVMIIIp,//p:qĈ~tZɨQ}O&3gO6Y-Zߺpݏ4~`?ʙ?B~b+(s.+???>>^=k4#ʖ.]hXu< Y>3S%E97wU_.M|Os|s…ݺ۱c/xϊv:(D&***ѣGU *)--u8OKK ^Ho|}sI[}5k߿]wuNK}ⱫWK&Mֳg{m[[FNTO{+WNH_.zuJO%o 0`@;liBKMߐDqqnv|8k޽] z~FڣzdԮ]Ȏ[<*o111e=޸E&%Gӥ@^tLut~F3g܄ I1`T%8 0@())INNgϞ uujUPP` //fM+p>?;{-hL6Ｓiذ^*=k֘[k &o]w[mǎz 櫜.]|.i[8oy1l|=uϜ]V"Ǘ_%']~*POEvv#|w6ǯ>{K>|WH9c[7nxQə0!iެGQD&!t:، POffd8~ٰ'Xyx:RJyl&wuǦ\9kӉz _ZtCC$H~ ڨ"ͧNM Y<5jT_M 'On>W_Ux[*2ly455YWoŊj.8w޽OWm*=/o̙9c[ Ds߼yQ#J"pua@ׯ^^^}kW]d6md5ҥ͋/f4GJyrΟ?bݣzdTɑvm߾E~]$4,-[*]*~>Z-P7S\.Wvvv\\ܸqJJJB]* +{.99fefft,碹᝟*gμoǎ L.PҮr˗w/^y,E@ 1kT?g%>>0TհWG58vdԨ'Nl6m,P7TJKKrssϞ=@B!SB]/8G(`8 0@dL4666##9˕^PPO!pP"puah@cbbW_b#%%Aطo_S9ڂB0@t:bbbq{l\<ͦB`)]4Ե8NS-##U2ۦȜo߾PWP @uq:'OIKK㙱5*,,LNNl̰ȡCF#ӧO׫Wo۶mFTf)))5[&@@jF9PW Rq\999SC]_ .t͜*OnժU˖-0 /[lѢEwٜAyy j&U9$.+;;;..nɥ@$%&&&%%oEFd:330`3.]4i$SL1͚5k/]xÇ8psUaÊN>ݭ[kΞ=[[o5zh3}ݻwK9NOOOJJ:uEzW^Μ9#Փ#wy|ZW/2dli&,]vR+WHCBsyOv{RRRIIIȼYPP` 33<5A>pU?~|~~'|rw[#; 6L5k֬[;vaÆ>z_ݲek׮>}Zv|rǎW}ΥnM Ĩ3v!Փ/Rr&N~zj͛7O/^ܰaSNLL,..V?Ϗ>J˾sw}'G!p!9 ˕geee2W&%%TCWZe<\F3g˗/nпݻ?cǎ۷KTqqqϟߺu|xT}-V9?OI,YdÆ -[ZWԩSv}ڴi/¥KSzJgddlܸQ_yqj(8rVRQ~4#Q@NNN *pzjs|֬Yz\yGxĒΝk׮$[0f̘;wh7)))*p>tPcΜ9_^ww6o,]j\tݺuv~ՓJ/tx_FP\>7)XS 8?zhϞ=Uyر;wCXɓ'{é?E͚5;|III޽%ի:t4pްaCSL͵K/7n,8_)x+XpJP  pJIIIrrn={lPK8Ι3g9XlYbbgϞ}Uվ}~ fժU ٤I.^ǒ{g6΅+VԫWRnj:v]vY8 HIIW [Tɓ}߿[N?bxM6RKw~Q裏w9 8NABntgoˡ۷oOII1QU  ;loDVVVW@AB ׯ_?==<I\.WNNfoJdeeu㡮H%,[7w9ә#0RRR${P @@XPVVѨQ4b \¤$͖TX\\Zs#\.Wvvv\\ܸqJJJB](++̴l񅅅@h%Oȅ9.+//f%%%:>)--u8)P79{J׫WOVq@80Ev;pC&{2[,:͕sDyyҥKC]/*C˕o @q: (!!AʼnPHPe@rmY>}P۷O====?rPȪ,66t)))xx;@A"丸\@-:f-dfffdd,[lѢE { u9DNpfdd> !MJJJLL:aXJ\\̙8HEcbbxd. .099feff2TJBBBv6lX\\slNgZZZLLpٜ_XXD 1bD+8 (//nԨɓNgVKBmbSLׯ<zP:G<T{\.WNNN\\ܸqJJJB]Nŝ +QPP` 33<5զG{6\.W^^fKJJڷo_@a(uәp8x*{TtjS#Q=D'*|npH CSOe/++ uu X0ݠ@{ь*,,LHH"( E.`|J(((TbpNPTTd ɸX#}լYooֽ{W_]+m1⮐iĉGtt:SRRbbbQw; K8y :z}wXz19E6W]]ϛ?"pmzD(gΥ<0Dm;-7y+Q9JiFi׮}DxD ؞"PWBIO7L.%(4eeeiii5WCG2t_?wSZ2bW,]А! qㆇm<}U3d̝;6F9>9vz*(M Y.ns \Y󰪌(Hr$&&L&ȟn\"K#Q=<;;QF'O.-- uuHdvן>ȑ}|kD=\$vX:jT_8=> 1_lӦ1 9}H6(KeRSuk+5#\dj.mVWDxD.eee6-!!Hn\"K#Q=ϨĵIII%%%N :7=}=sƏjlə=ODV֬I† cr3ԩ6iF?]6[Yw|U￿]Cƍ^zΞ=+WPsU<"RQ~4:Q30DG{r/۷/ՉB&K;r%$t}!Wvm3xpsǯ];C_}ܹ ~5Ku~x'=}\&oݺi߾w=t}ws>wue˓'xxy۳vD#PyAe Ky W[DY$ExDN3###66p&Tbp|r  D2PG##z*{zzzYYY M \TfD#*n(( :hrUhnh*75\HPn?//IDžSifYtf8σǙ;8vGP.W\m+$"L|ReBLY{(3gΨj[[߸qөH2( ,Knmm-~sJvC#(P6999'OkT>$ #00PRqWvT2eGP.2{h=tX#fU"0ܸ8J蘚j@ ,AV{(sEGGשS'222''ө,<(}~Q[c~K*v7ܨɷD˒ DyE@h4Ϸ xɒ?/?g?7ev)]s3x-[6ں5^v12g;1ýocVii %=+ MBę3%%žXBB|bMY;ԩCK[퓹{iJ:U˗J#x7iR;Tv)\h}}}O>mX.M2J_~1ߴS;C>}owܕoo%K~{T}>Ky8Ǝhmb*U>(&-Ě%={>/f̃Ôrrrlllj5weǓc4%7K#Ƌ>pyFIJJw׮]枎%$L5dFo^'.;>?޸qbX3!!F,޽u&/PS'sv3g6ggѸq ?SSMԗ '/R&ԩufxxFVVtWsΙ{:P8l7 r}iJv-U{^KDfkuNl;t6moӾ"$1kV_Ϸ%&V&M }W4V^3&&EW/㥙^Q%i:{x4Mrr֭[=bIF7qXPҰ+? O%U?Əum4޽x6'gXƦ֪U:U?e]\v~"U~pgm2wnTvvrR0Sً㉒G8% n*Ar吵.7nXO˥i;t褤)X}Kwت[e~F M\5֭s|3D#^ei:{xR4MZZI,3(S&7oS3}Dnst]5O; :~ONζÃ9[G:ƍ6o 7oyjуAwb!1qm$%Myg/_>(gi,o F~aA鎾gge AA^->/"xBrrríj57ဉYf)G ׭&w\ |zt>k/q8ҡN\瞫zNZ Οw,}z׮m_QWkiWY}@{{+W޸q13L2T:-;urs㿞.'j?b螉u>/M t/lU> AA^vv~|7RlR߬B5,v.'>>Rp)KnjzyȐudp.u+&J~~^}yMvv/*Eӡ\jɓ'?e&ev]oX[OO8ojn M4|ܶ"#(kϞE{.4.g Ӧ#GVArps1>cp?#k׾%n?{vTw*RJZtc[k+gb08z'l,/]J3Jqh4 ]=<,ݔ/Pwo4"CGcTҾ}+/>G~׏]Y<**b=zrzGP.Zjѹ枎XfQS\=b_A~i~~Ȋk#ijbc"@::o]z/[լi eK/PͭO?:atNc08v]$7CުVrʒ6Գ><3s[?1¿Zo=}٨Q ۷>k/q8;'lljRp~AY\][QN;w.w_iWY} '''22^?[fQ֊߷ioBMoCb9xmۜYyGu&իmceU=(KZgΒ%V}(4#c~'yj'K\Tddj՞lkp&{QQAkߞwph{BqT EQ&gΜr)g* o7O8#(`4MRRʹ4sO $B*55Z[>Oi(ҐNS]SRRCs0vSʢ<\s)GGǭ[{:OIeEa\NNѣmmmj]=Th7)>pyG$'';::+/>'ɠ,aB| A#"ΟsQ1Op޷o;7j˖ezzq#Cgo^c >OM53.nd?ζ:نqv1+.9&<Ǚ3gjujęCyLnh.Ossy: =TVϯSСC+Qe ܹQ?G,l> Ƽ^xey6n5+B< 9~<ݧOGm;扇GsR!JNN!7C >uk OghRRR%%%D\T{4MBBO>m<%FZ/?=ӿ=pq||:Ims˗^v_vXx4͘1|$^k޳ζ:Fl҇jweepm<8-Hwet in.#< s{{{GGG8%׮ K0 {ddAެTNq=fsÆYW[Ƌ&Mꧥ%ݻzyAqq#BNζV^3./H' 9|_]у22Vdu…u&V֭x(6Yfk޳ζKqO϶Ҷ7S_}ZBTqNx;i.OmsQj=(FIMMuss 枎.KΟxqW_?O#YdXx)/ 饗ϴ4sO0͓(KI>S{P4___{{d)Ii*7@ng}>^ <7Rbcc+;f'Q4J1}pgΜQնϿqㆹCAYb) T*%S`Jʔ>BNNZVɓsss8 RHlvC*u.rtRժUkڴipp૯ɓ'}jժEGGO6-((H~jǎUTieĉڇh֬ǥ'rwwoݺ!C9a 2&%%žXllyC `h7)2{ܴ3򂂂QFM4|7SXgӦMbjժSNߛC5j_zŋe3|,Ǚ3g仲;w,2eU>*7TÇ3}4ݻ4iRPP .\XF  .f$&))I+{JJxh2eYx=Tn;a„ 36,>>^,={_sXyf͚5oߞRڴiSJZӵaccӥKyb{;vlZl dPXxk/Z޵kT&ʔe}P$$$4)7Wu떕U˖-[,o޼Yzy_uQZ}ݪUۧ۶mۺvZXX(oܸ!~GN,IFQ7*J,omw)EߠZz%P,#ܸʭjժևھ}>H^666ϟ/ 4hK/ϯU?(={X^|rʕGNI\<222*Zmeeىo۷KDN8\)2e\9sZ?˭-q\f 5MJJt/R0n9r ܹ$(2e\@3{g,#'>x`~~UVY`ʣG߸1c}ptwoݺu!Cz_3e <ӻv:bZ-)~ȑ#t-رǥzꕖ&-ZҰa͛;;;{{{oذA<=rd`.mCBIvaoo{Ȋ >^<:X7ꏈ#a \|G7//vZ^=E?"]\neU]'i ema}(M^;nܠ_g+1#;tp}О7ꏈ#v\|~۷ϻByȞ=ƎX[#4f9sFōFAp^*'kԨq͢[XBJ͛7yd1W_լY3---55W^>lÆ /88uT-޽+,Y矗uopA׭[7//L*nOs驵kߊ4ؿs{;nޑ8QY{s98yuV;/_\NjmܸGPQ&))IR9::ڵKkѽp~p؉hdf]-~吔[$&߸16 s~~lߺuʪz˖E͛g͙3z8bK3^Ҽ NI޸Q;8(HLLS#g͊FBr]t6lXW)>|۶m}||ƍ7n855ߗ7_`[׮]ݻWZe˖b?w1w'ӐxVZm۶Mο曎;zzzK,)?pH?:gp'%5 q֭Ԛ5S##_!)w+NŞg\[P<MfsF]rgx9 =h4ɎxZZJ>k[T/O2NZעݓbyɒ?d$7/j0RkִNKK׬Ysjj q[[cGܹO6'u;?RwurjzaܹQaa~C۷CK1*WU$͍@^ ̋vXR"8@tUC]ZHc)K)I?_F LFIII/(7 e"8@<g~fwtJ'8sLBBꜜ8Z] GLY(cNZ:?3{R$|陞ɓG$F,\=qJ%Zn޼f͚]+Wy SEppy(Qbb)S億7|,ǭڋok)k /T^]vjz6l8zhNNN0rܪvCP.%5kw}WW'N/@{L*~~^vI[ZʂcL~zjjyRxOU?SڷGw֭[724iu`~^Eќ;wѣ6l:ujxxx׮]mmmcs[6"kň8e;ibA{W_}El)qU-Z6m0~,1XJ&M5qyMQ͚5tqi~`T`ʕ+K#^1cXյڵo47S''QݿyҾ}JOl2[aa_6ϥKi../7fi);1] hp?/Al%Vbb}a |,t+/˓V鿢#;tpy+VH{4hPIkH1?`ѡ߿D,:+H3ի}~2F)]p%i08'|#G׹UZ]?dיKLEҥMN6Ne*s{I.5wNZ^fjddߍc:Kl+ݻ_z|W5[ZYUoٲ(͛g͝5}p,\8V;8 :t;&&xqZ}⒂W7mm߾G%ʻ?ƦՌZHJ"=?2{vD׮m]nj%wo mnٲQ.m[߆xwRRpK(*XXX{2us(ڿ':95%7$ʕC$KC#j˖fO,Lx|w͚5˻'_|QPPPDpXt-īڧt#{_բJx# GnXTf cj㇢ӝ=S)tOѕP.&U$CEşwR> V)+W:> Νspp {ELY("P@=xp*4k w:__IPٳ#A10)R3*?.& 9eyE(2eGP.&EAY`xCLY{IdPXn(S}`R$<ʔE@TYo$ UX(S,@yM#UEU|vCU#(*Sp>`ֿnmw)E&=7nĉCO5%o.|WF!h\բJzYbJ*MԗKLC^STf ]\?n,m) =c 7ogW i,Fq5rsѣ\9Ν.. (<yw7IԲOvDG>ߨrp`G&͛fώ5_Qqcjݺ8jJ5F!Hwl֬8AԩQPU3$m4E@n}**wnF?k׶#F;ߺu43sKhh[yz:9Qݿy*_ :"#޻yRKŋǍ3@:f^y[{884MO5%#yIЎEhҤsKQZZ:="!-#(zdpb58;˳+jz_1c$&\+F~#1үms[*?$'Oԭ[Νb$$wǎy'O]gTTкu.]JsvCc)()8{WXSeQm+'F._>(FBC{Hl^Yfkƅ ֨aYl~‡boQV7_޽K]>];,2{P)P#ݚ {'K/+HMa͚уí[cbEOsqn'δӧիmڴ[R14 Y'VVcc(2޽I'uzPIEnC\L''O9203sg[i$&&x͚ :u44eҧҵ׉T^rum1s)+>cGl#<Ϙ1| 'Υ֮}+""P@bΝ~={;Vsy[9yis挎) ܃༔E(vSc~CjbAlXqz g|e+)c[lԵk["^c084tnծVwOLuR/#vQ66tiJ,) =JK  w׭11WOYpvpdphY3Dymۨyy38=J/**NjuNzj͚}dKnȐvp.o+:/->>r֬i$4'y)P#&F);RsPg)jV슊b"νn޲e#)˛7ϒ6iڴ{`KN0xܒzŋ~]޹s4t>GsmK,) =J5 bDOXݡtځmΩSZPݽ{R,Y直Ì >l ZXTijefߧ7lX+'H'8׹M:95vpܨ^qQ!޸' KYo7G76\d05/JY$No=z͚5SS㽽]B>E Wjgwm_{x(zͪUł_Ӧyv.HddIBKsv;-{SZ.V:EnC\Lxa22Vtfذ>ݻ  gGtu̘YY`[+ZXX{2 Qs;.6#(+""pn72/ ?:IY΁ts(گqNNM rFq˖ /Mp.ѯcp-[f=KE(OEڍ|W~aWu>(Q^S`cS뭷Qܺ5sggpܭTr?-TׯgtvƢ5k(oA'8ń\_Y6ds%}`R :qK_~9_TĎ?,SE(OE E#("8О-[O>,E(OEjKg#T~\L>HY^xCLY{IdPXn(S}`R$<ʔE@IeE(2eGP.&EAY`xʣnnή(J,S-H0k(ק(TE@3E2 3zyvG?|jA,U>py0)$_ SZHTe, =) ,@yGު>?#Q#("8,<eFoȥKibTbA{XYZ?1q<~j1Bw.ZJ-TM6?~pAARJ&8qf4?~%o;[n2dHO19#<ƛn E@TY"=}즷k>i'N)<yw7IԲOvKi׷wz4l[\1¿QK Sbiݓ͚5\=}P:ujdi4׮]#7,,=ʕJsĞ梏\LG!Rd&`)py0)sP#EĂxUÇwXXm$珤_ϨW=ze:jW'&:sӗ(Z]&#{,;v`Z/o2[rp"Y3\. =*rv0i>ׯgHW-o;:6y͐۷rjj'VKaFIS*( |zo;[n2dHO馸{Y֗Sv>aBHr!<1nbns)5uVmQAA^66j8]ʪQl瞫z y}U[ˏ +sϑܹ@tG~|۶]uF,ݻ)11WO!8>py0be=}즷s F7iRc ߺut@_~ FvedJ+WNs.*NDj׮{@,f_<=*Υ[ɮɊP&Ɔ EͶ/\Q4+'!U&iƒ߳gQ͚o=tywݹ 92h1UhR˖)xɩksz|vwNU{II2>U3] :I?|xz.]ڸcGǓ5{rOKK l۩Sdd{2[ջ 3tvƍiVaa_6AH?/_>أKv-W"aפt+:QgI{#ƍ+wh}`RƂ.O.16?|x:4yQһ⩥K'HOi/6^\x_QqkgW սzKDE[7-3sm͚r2=[w?vp4e{2rr/\8F kΉ/\P{֞Wԭ[Νb$$wǎy{.v-,̾vxjXW9K(OEs*kGP.&e,8;3gJ[p޵ ҧ蜝0!޽L)ϊ}G}֭[S j4_n̙#*kmEk;wvww޴)V+9$?vp;mG߾}be7oٳgرkzy˖<19~rFbb׬:g踸=tJs+/xx\*Ϟ JMuz>@=)9M;Sf &~e1mٍc:gO϶qcb7oܹEş8qwݻ'mlj}[!A><""ťyAAvp.q#Cxx8jJAn||Yg=ʸssvCQ#(2l{mΜKÇ_>BX_6Hp>o^aW_֬i-}7߼޺go~Ժ-TwKDsNx_^Cj;w. EIsݺ5kߪw^vXz8wnTXX/yϥo׻xxFFz/UƝsv9eʢ\LXpnҊ%%FW0?mf>>cb/תի[y ƸڵmXX{2uU884nٲ͸qJXӥKn6Wο==ۊKDKj5q iyNNMϐ+W{.M,fүcp-[fKyHeʕNJq!8LY{I _o_y=-[6zOkI҇+^r(55^,fwg)b9:ztʵsgԺuυPsʔE@ɒy󢜜:okWAAV@@ӧW|W ݽå>XiO<݌.S, =H2( ,@yL@Eqy0g)+@yh7)>py0) P eʢ\L$"vC#(*KQtHvvGQbxk3N)<)Sqnzq36E@T*V,qJE(OۍG!Rd&`3U>py00;"PZDU\L[SXS, =SSKz + }xx8nݺɐ!=ĉ>eC !u/]JZJ*QM6~=##c_iѱɛoܾ} ,<ȭYW_yHg1~\Jt.}= }`RƓ>ipPΝ..KzvI&ڵk˅٣GO߶Uv)/N F'~u18w~ё#}| #_9*rnz;)>/*]p.}Giܸ]3sr3x§JS{II2L 1Wd- bw7Ij [2cmX-رU{{x{n0C<\hgN"#޻#ti::zX!,Æ_Y4l9_neU]'9>X_ r;5b2SOeN*gb5Ti׮bo>;:?$٫{ZZ_{n:;T?4E+T=zخ]իxO#Ӟ]uJkV0ō'q&5t3Pťƌ KK*3ۖ-~||ڋ8c''NwrH 7͛GOPn:'|E@TIIƄU?/QkC1˻tiSPu1oo_=fMkz'O]Z3**hݺi.-]:AiӦ_lW&֑p5;'&pC1"o}P)#uּs ݱc޽K ];,ڸ1VT{uvОEI^\x_QqogWO Y''OJ~iΓ?XsfsQOzŚb//Ow'@U\iSTM2LBbp_dYE '|Π(DqI4B\q`&cƙTJU[Ĩ1:! hNb.uO/&穾}%ZV9pᐲTo0I.D<p{*҂#,C^Jvҥh{**||+8[~~.nn}edmmUjÆ 3fui:\Rnh*\Ѿ}gΜܶ-M[~Vw]9srsȡ.^~pn~eӯJy{;ן0S8Wb~˚5I[yym0I/Ds<p{*WMzswbwcҩ:^-!+kܹoh-(H QsʕRVyy9jN3gNXN%Kb8ys+s/2֭K曽^푘L~W_}ST[8Λ7+^;յO]]?qpm~B# ҖK?yBx}ʦ_ ¹]V]]V\k<**D)q!r[.7-^(ܐ!>7wA\ܘzHy`QMU2bfFeg//N_NtjǨߔ[Ssl ˗kǏo^rɓ E?nmmUTΙ37:X]SW^fd$DF6kWfprC?MqW̩>}zZ_ 2&**d8FROMSm|Ϟe|/XWWQ \἟KGG'K\yyk7'),LU3Ťbmj ~A׮ud# TU&//Geɲv¹,zʟ6:udvvЯ|U# =T2).㬷HC^,\=p[ 7螢[l;xKddЍgsq>gN؊캝;w_ӥK狔֮Գ^3<|ŋ55ǔmS~ ǎr ض-MjiM>j)ef %򮻻ݎK2)wY^W ~+;ݹ3C->E~\9$0W8p~JmHv cĔ)ҙ+O@ی_Ra~eSBj w^Ǝ8q֭KKJޕ]DEOY_ 2s]y`Qf*sx&=i}4,wvvrҥӥQ_OH{ו&u븃CsdڳgU?h`< KM] H'3#2_87iiO-&!Q "23z?ՏDuuU>SZx `,U2`D’AX xH7%<p{(*D nKy`QT26<! =dm0(x 馡Rt_^zW$q =(m0(xtaR2_?hx<p{( D ڵ{!ja4- {Ed;`xO]+wu}CIdg'''GH֭ϝ;VSs_Ү??NƫCσVC}# P K{ݺuR jk49wmܾ]YRnCӅG6fKy`Qf*FN>ܪ5Ґ&jkbbFyx؇L0}ׇmB<=.]*}rڴѾR&ѥK{ n WWCs#{`d^n7/T&9Y^*34zve`}L%׬IR9;>ujp;S端E}rHʚ VF^Hz0_kk+BeBSv\zÇޝ? +mHv>9~@; OQWxOIGE4-Nw֡J"*J[.I^S…C1Bذa~bdiܸQd=efR_v# 1J\\wY(nu뒆#!p{*҂#,C^JvҥOSړ'+(HMOm"wѢm]U݊@we?…k$V9l1cXe_*55Ǟz}Ϝ9m[p_]9srsϮ>`< 烽}ڢEJ)Η->ͼaq¹>%iI;Z]]q-e/ʆv?apTR8WSlhq^:Čڵ+;nנefRՉ^^2vspn\wY!Wuݻwlh:5G@3q{*WMzswbwcҩdIҎQP5s7cjҥbzut轚Z8W{ ə? )7wA\ܘ͛ڧJefRl.cF9w¹I3sM>(WٹwFFŋw.sB,JFLܨˉN]2qJi/?o_׏JʕO,#!O9k3Hyy}]ݝ_8qHaa« }J2>AMC~еk:TWUUmrl[ƶv¹,OO:2;;aٳO6+X \f&ժ!=g>r*P wX}R=2S?k䦸*Z" yi2ƍc%mKk $jjYUÇ{==ťw`9a+V̲sgZ8a]9mG匪ˤv\'/^,V9FώLP\ἳu+!=&dʔ`LK\6cƄ*uW dR8pw۱cmwx%^Ǝ8q֭K$weQQ!S;\ʕNm2SֆgΛ*P տ mj&=T2|3N룥ҥӥQ_OX3d[;88wu  +f ,5gׯ$V_LBMp-πQjn~G0nep~ߏ#"FtHIguuU>S{vOxP%淈'Ǐol#чZZ `,U2`D’AX xH7%<p{(*D nKy`QT26<! =dm0(x G'N<(![D<^AXs xp~iGe_.WG0nEhA0+% =(m0(xW =,P8߾=]~?_Ԯ}k۳guuUټt]H }w -aߕSc ܔ׿rtpp#˴Q^h#L`<T8W=¯j/JIw.}6< Rt+iEo5uC":6w[Jj~4[+#2_ɘwh3N룥p\_V׏ݥ"%/[6ѱG>)Hdg'''GH֭ϝ;YSs_Ү??Nk7'<ytƹؤ8}D+_ͧS{t#{޽cn~Tpnemn䃟oέZ# yi2*&f}hölY$˗s4).n̍AVVN:R?o޾]9mh__gOOٳ_Y?|ǬYw.S?߶xXW}S'MJ…2ͭo^ޟYx<}؛7+Z3f`-9mҥRXnSesޤn.3{m޼P9)O`PFvUҸz]QG\+`}qdoNE{ʔ`0nJ$V2l"{ M.]*oZipn2zjfQ{Gꃂ<ޑYb֌~phl\$'L0{G…CÆ 99#@{E5UHI;?KKԎٿe@[}˗X=䩼0~?{5]vrsOM}S\&Iԩy2յk>|L{d~ uAv;Zz^\WWOG~LsjkW'*Gn.3[[[))'ߗe<iIѯUzE]-NݛգGGWs2ԁxd'٪Co:.VVϖ+oM>V7 S3s{Br?¹s&=.Ɔ '+N=dK z2d܋ y)1K/^wZLz->̷aqVL@=wCC}jj=Տ[>s_L-Wƨs}/#%<A0\S>K~{]_l*P ))JODYF tWzda׬IoZ s^.KίVWmg*󆻿X_LἩsQ8WSlhq^:Čڵ+ `QMU2:Ĥ<)/S;&==nɒXm +kܹoh4Z8سgYH $4GyrE)K ꮖ%rrKl8{ju?~߯_W![hJ{ſVB4p.'rJU^^¹:Z87ٗ>Zc<iIѯSzE]iΌ]oiNVv'jĈ{^ڶW}իp__8ןȕ9|7m%Ə/,LFSdS"gȐ[ 0nެ8|xmlhW>G#j7/7*$=8}yq4rS;f׮`/i\RڡǏoҹr' Ϝmoqqc#23͋?nmmUTNso3xڹ'FZiؾ== Mښc9]|XS^a|:?qԪM^^ wkvv-p=xm'_*=A)/-$<.A0z]?G\ԥX?ؤ8-_i4'Cݛј)6?WWO9TOptZN6eH3sJʟ6:udvvسg'lV&ݑG nT%Cbhr>zh4ɀ7*Ǝr ض-h7xKdd 9֯_W__gpK%<|O?9{vK@9sVegV4U8ᇒ;_nᇫøyW_.]ݰa'--V- mƌ U^Ǝ8q֭KuKr"ʻcr׮SSr/7p%}`<-I7ܤlzܹJn2ؤ8?䔯Ӝ uvG&Me"}1SloZQRg>JL_2ler&KB2Kpp7"<=/ h0N"?WMz,L%Na`g҃GKCK۷7}OXZ'۲et._>e 17nTDFYY=;uH TQ1NR>g_xl.ӧyȑÇ{̚zxpTƘE&wubŬ3&h??th͘1iFoۖ&Ϟ"DExz:\T\ZN0!`~իw${m޼PҥR_XnSe?Ps7)cD;R0ПiWI 4?.T]wdhnn}$/MVcJY}}ey_kFm3MyIC¹~I7s ɧS>ypPIJUR-$Yvގee2۷~ =Ng­UɶpP%ᵾuuU?tDVş..&5kYOڪ&~6ھzOttJ ¹~I7s ɧSV3a%!}\dգ2sx]⨨dЭ[GiaҐˮ[G0nT%]Z[q$^eKԎY4~iJ{aq\$.Z-kHJ q"OF*3̙`ٲs6̏<ߋR\v?aS{_/c…k$))o)6v~GOeLIɻ>ը9_ɫW?ڷo̙_|r¹:Z879S~ c<iaXۣ]BkummUjÆ `cc-k,uLj[:̙~),f9T{Գ|;6s}Zҹr7YGi,׼W11vʼy<!q{*WMzswbwcҩdIҎQP5s7c}\[P9a99eg cS{ Sv}OBOGT?tX~uC P]7F#ܷp^[[uʯ8Q[8WR &gc/(xӒtj_eYyE[8.据fR[]] 5ʻjdI7s ɧ %{ŹxN.kN\dZNg%Ç{|ކVJ7oV5G!#j7/7*$=8}yq4rS;f׮`/i\RڡǏoҹr' Ϝmo߽я+xx+O80U?F~A׮udS]]VUQuVU:udvv~GڃWd2<p{*Cgq[EK!/MܸQ1vcXXĶmi wv@]"#d@Mͱ~:7p.X< mƌ U1ًS_+U]]&{;z![.1}Iɻ2HdG&Ń.]ˮvvvwi];ɩ ~bzAS8o ? A0eͭ tgsq.k캝;w@Y{MsD]MR¹v+ OO]4>}l2%Adգ2sx&W[nǎJUR;\ʕ#2SɸYϤ;KoOF} ooO?W GvvP[z;w^a $֡.-_4h=_Vb =W21}D7&} PMII)|' S%&--)i_y`QOAQPtCX2#A醰dG0nE%hA0 a `,J`<’AX xH7%<p{(*D nKy`QT26<! =dm0(xC!, {EQQ7t#oکMϞ~? ѷBC}*+7%%秘[^۷gD,P8Wd_6ڶ.{JKׅ jOF*//GOOo14ڵ{!z<p{(y<>Zwa<0=))֭>ujk/1S8NNNLhoܹ9k]]gDZn~|Qu㏥[U87jj }wP'$x3祍۷+KJmhp3ڿLm*#2S67jw7V4PQ1ϥiF:{z:̞pаae؀rr7^н{*u;X_BO4IO> 3eJL>nhR8_|#ܸQ!=]WJ]`1N)9~pY^.KddճSl $3^VɓmٲAkE}V5cesp~К1c+=mKD.JAttL")ҥb2 ݫW?Q6 pۼy>5/Cs^_n꼔w/^,L g4 s1vdС& ف<{E5UHI;?KKԎ{?~;oΌ֬IRuv} '&N7nT(o*,L$55Ǟi¹0(OKҥOSړ'kt7)Kގ'F…k$)O+o)6v~Oe>7)qG-9s/Qy^(;_WySM?as.Դ|;z `QMU2:Ĥ<)/S;F ə_P<#RZN7oV>66vk*V}^ǎ(%yBK-~/c}C{T/<iIIO[$Vi+5_s Sv}yTTR81ޓֶ/]*n[8_:Q2Ő!rsōQGtHr+>}*//G3%sʘ`Q|dGʻjἩ9rY{gd$\X9<{E5UɈݛUU8]~9' E?nmmUTΞ=>dR!n}i3Jޕɓ?;eݛ<e;ZPzƾ}m_?*+WΖmU&qn{Y?@0]2qJi/7kptZN6_6yy96Gvv[8,iSGfg'#dwdtNN=/_>tfd$DF9/5g%o64]8WO؜pǎy/oWzv D`QMU2$).㬷HC^ R>ށrŊYvvݎvs+Wnt+i\~t۷G>>sii͘1ʰ@'Meˢ>p Rk.ϟ/RfNV[.kp^Ss_έq?A0Yǎr m[ZnWpm׼+$`/I'Nu3w%GDEOIuQGNav\'r3<|0wS祿& Mε[L؜P{WG0neq+IvZ-V<~qhC"((xӒtsRҨ?[Z}jNd^ =W2Ө ܔC׾Jy)n;zᇫ[Xvյ4dZ{h= ¹q|K/=\P8fp{(3msv'|sniKg 7ƍڪ c&Lش)С5c VO6z۶۷+0{.6lrr+tJ㏳?znn}dwW~VLOz.vq-I^ZY=;uHi[7w)eŋɄrӧyB'~zv֬ÇZ1pPLۈ3JKhölY_c]Qc6o^_dC¹ /XIzj.?eJ 7__$*0]fmCdQQ!ɥKŲkW>+V̚1ckpOf&i483rSF*_#1tmF/yq{*I=iG~\y)1Gy*턄7yXn R?_fMԩ'6OL,7nT(b PFZC{t]ds+g/\8$#VNT&k}}e~:e_~^ʘ}Y?p]m흧 S=M]y66׮KOxݻ3<1W8s};ڐI.h˲|aY6%Xkk+mfFpm|ެ=:J6i~*9MɌ![u[ǥSNIɻceBJyt$tf eL3))\^^0ʏ B`QMU2ڥ[G2EYN8[~~.nn}-HHIVލhἶ*5aJui:3gv9&fԮ]ʓ%%ޫ̟2%X)m93/O tiN-{?hϼl  Ǐ4wWT)g 1gNXnߢx8x{__εES8 Ӕ$Xf8w%^}E__/$gF}␭ݕp+R֬IR ގΛD_|4֯''.G@XTSΫ&;1i1O~KԎʚ9w& }>eJpAAjqGElۖ&>#h~~.j\^޼YqѮ}ꪴWVnի߿˱ny{ȐJgn1ʄ~X} &3˜2@Bx}OS{ןxEEСj}E:\`Zp-(uԑʄS6ؠAN/>sf}weFd{~?qT}OS{ן8s \἟KGG'v ƕ+:,EWTck|U,D{f)KfU9x}hfo?5I"|$8pOCo*?/y4{Ed ͟5rS\Yo-ԏYlvDFݸQqveXX[ߐAGV{;z![.9{vK@9sVegm ooG??rle.]ڟ?_lƌ ;bkٹE/)ywP)TWRB9 TkjN&;;Y}6N.̣YJK ` Mzڻ?`s \ἳu+!=()Fb۶4"_ϝ;f M ?_9 =<%N4t˖EyovQ2>tf7#34gf&Gh~lG2SɸϤ;ƃ~f?发eg'+=P~m3֭=Ν;[||OJ|2 sFt^fPZnSԪ쮴t]HȠ#G1ke~鏌 zvԑ^]6pP8`4MΓ>|{ҎOR:c**^|ǎ۹35kw{:uÆ[ S'O?#GhSX֭[ԣGs< 7n_]|ծ{)gןP r66׮Kxݻ3בo0nMSviAo}VƑ{Q!/S;"Eiϙ*5a3ƺtݙ3{3j׮̛7+O8D ˖P߰a~|h'"bDAAjzzm{PͭE1%%{?hU àpnpp{h*w^5݉IߍyS^Jvϙ3 54GyFϥt4nެ8|xmlhW>uuU>콎_QJHEYY3K/ZLށrŊYvvݎvs+Wnt+i\~t۷G>>sii͘1ʰ@'Meˢ>p qc]?H!;;Y}l]NyMͱ~:zuAј)ߩ(_Lzhiz͵<~qhC"pp{hӨ ܔCApN٠pp{h( 9aɠpp{h( 9aɠpp{h( 9aɠpp{h( -KKׅ jPMҾt8&fTN6]c6// lޕyS`w:s {Fcp>Кg҃GK+4gg'''G(m__ ܺu\ڧOٳӇ6}ڵrW>Ґi;wpCP8`4f FN>ܪ5Ґ1˗s4).n̍UAcMiSʡCkƌ 6mmioWJaJ :`@&]}mO޿[_es9ٝl8|իkÓ ]\zˆyyrVVN:R]`Z߭.,o-^}͛?#G˴f>\6=za9/nMSߞ#SyDN혣Gssfw^cbFڕ<]RnhmN)S{xRޖP:;ZPxKO$yMͱ]˖PJ߰a~|8}OS{ןxEE{s.h6sp_0 WMzswbwcҩ5s7=K/\xp>eJpAAjq󨨐mҤ34GyDE-˛7+^;յO]]p^YWҩk^^Jy{ȐJgn1ʄY87YԖ{ڻ+*uop~A9=ip7/7*$=8}yq4rS;}^~T+W>yp߾J:u)(Hڤkkmۖ0o^|vkkwJ=>d2ƺLU2sbda/ջw>ZeO:2;;YPxת4g춷W\^a'NRXijpG0 Cgq[EK!/c-1p.A7nTܾ]7$dѾU^Ǝ8q֭KΞ;0}Μ+fu۹3CƟ>E~\9[K).1cBǎڶwvQKJ:=**D~>>55U}y+++-kh(uYXprd{gk4R5e֬9ped̉(9$9G@97x[^{բEigXpkMuV\WL:hQ}:-:|s웉g>h2'z){OTݻ_5W.YrױzN@s4$?8:uPZW\zb ږv[&5ebE7lkJ(:=4f_? γO )Sd?/2}^8h39KpIhNmWOiѢyrߞ͡#QhQZjjׯWŅUyoExw]9N fzlUa9}ygʕˎs ќy^}ـ=:4?_ƻ6shҢEYsѯ޽o*,۽{l>Տ_rI(8>' ~)bŊY{}ƍ?ĽfF(9$9G@QeQ7Q|2%[BoRl0iR/~G?:}ܸĖ hWK_TN-[fWg '#G_ {/9$9G@ U~KpIh*%8$hH4s@s4$/n{[>Эֽ7\7= &ݫu }8b/ jwqw\sHrDT,}u=Ÿ6o{+#]}ޘc~:^|v,A;MwY3ڝ;uWϯ7=ϙgkolPE~ט{Fʔ)Y\pM75|eYYs7 78wk{Gl Y>;Wvwj;ۣAj'4eUà? ΃Anz 08o׮Q[ra:v[i>ܳb]ժ -u_g Ӕկ ?u«=G^zN+,.<ׯOW^Y{RRVݻ%Ϝ9쳋\xyXp …O '8rd{4{OС/P%JȘOeS_7 /͛7h\<vk6o~͞=Cv啥;][o-=/RFu/U n aشItӏd{sx YBO2"sX yөymn {G5Y/T9Øo߶o"ڵ~ӫU+^zO>.]Z<38; K(nݴ_chϝ{Ǜo>uI'խ[yֹMԈ">XW* k.t>he]iӃի ))Uc9sx۫W]0YXG'ر}N=-kʒʕ6jT=.?,1ch|A>tc.ӳ<( Ø$c\8qjwVt/?qӚ\5qШޢMh]-e|p磌JA짟n~k/Xݯߍ{ӡ󟷟3痡jX}]=ν#4|r|⋌38YkaJ>wzU~by{Fq)x܃. _fAjS }VNzݯLsMeϑ>}2=˓ˍr|{lcjIp4$|#Ol[o WV<@7gy۶)+VLLOs}g.|I'?}7ohl>?zi34mVW]U:~CB;l [}g|9[ky. F[qUTfx晧vZhV=4:\.YrWtvP'|rxLdrs|p˓-"8rhH4 {,Qo Ͻ폎o@dߧ]k;[7Ώ^O9 w5 JϜ9<4V:ׯ?Ozѭ33煗o`ho8#_y߾mkm4iR##ƓQ}KpYNF=|\wzF9>ORph?^YX<79=ëaL<ʕb19Yg-Z71>e^UߟR5?hYgR2wB㏏Wpw .8'\FY-TjediѢV?'G?=>e_vZ:/0[k3Gѝ:5 =U^>rd}v'zI'[7{')8rhH4 CjZQMס⟍q름aNFf CU^S /ҧ.]ZWS5WIRsHrDW~~)on8ohWIUsHrD\ Fp[sHrD#8W-9$9G@ U~KpIhN|ժɡ[ѢEiӧZ5kо  9 .G﹧O^F&Rp] |l6)mۦȑv| ٩SQ֙4k\9Ӈ,Z:gkW իԪuѯ G}T׮-?߹s˿,l߾c7 ۵kԳgoӍaK禱c>3ׯjܸz~7v2-{fGhѢ֟2,yTZR9>r_9mp4$o#8;?>0~|.~x̸q}-J뮞Cƛ7 518wY9th󟛺ukk^{<#cN3p`瞛bY01FgȐ[B#e;&Opᨣ$]wmz쫍sٲqO6aocoen?%n%f٭[˖-kOO nÆokԨ;̲Zа2L={Dr[mWԯ_%LWk  |y2Ԯ]_}uihZbb,9$9G@ڽ ڵe"] U~KpIh*%8$hH4s@s4$@?[ 9|\ Fp[sHrD#8W-9$9G@ U~KpIh*%8$hH4s@s4$ ihQZ~g*t=Ccw߯=u~}.'W]U:~:U^c{ |{Tz׸מn#Ft9p`kh%yfjhEƙg~q7x &+˫6=آE -Xp=z[5\9`@զMk߮cǦ))U|ж.]Zmڤ։ѣ{Ԯ]1 /7Vsuk9q] S>p],ܹy"gzu' _JXWg侥eƍ3ʕ$JǣZjrjBRO9Pf>q7JpIhuĘ0,gd)Z?!}wʹiʕ˾ʒjbEz:vllٸի4hP-\ߟqe.ZiӃ5j?th[С#ì /^Rp7&i߾mν#-&xPo">&2ݺ~.lmpY?:e&F  9q:u*EC֤I֭+VtÆՔѫv={ر}GtlѢ%9sx>m¬ƍG=\R ;EY^aLUBUVnԨo)61&fYw"֝rJ#Ggys 8M?qi9+^(-5NDyՁ;̚5{=&aʄ } 5&G~ݦN=8Ӈ %[+3s^2%YjrZWFy7.8 'qwذΡK-f}'D&%K^hQږ-j֬7pⴼ篿BRrֹ]χ^ziq[MyjհՃse^s%8$hH4W|B+T)۸q;LԿ|V%?>x0C5kVh6}F  /ӳ^* TC%8߷+nG5ʇ:wnF[ڵkulb᱄ſ>F^taW+}{N@s4$$8WYsHrD#8W-9$9G@ U~KpIh*%8$hH4s@s4$o  9 -P >qYsHrD#8W-9$9G@ '8?ZiuY*@s4$)t"^ߪ*9$9G@op7\U %8$hH4s@s4$}wMB'_~%ʖj7o5>},Z)a捌\rI={6k lY;_S>h}J J͚5[.M˰Ç̜eˬe<#s 8$hH4N;5EF\iu:ϣsϊ ޾}}_/8/U.|7yJJa:85UW^YzI}y{Tzy^FΘ1tNR=VPj׮ 9M.yC. fo2n޿iR~n׮ֺu'Ȇ ׯr '<f3lW-j5hPm;o_L'fy˹/uܼH3nLlbx⋋oT}CF"8p4$c烟z92tƏ/_>tMuV\Wdd)V޽[BOǎM-z 3.E6mzF}KwxaօwY^08ܢR2ѧ_~yI.y.l0=өSS=ͯv;EDk[ q81[}m{A'cca||ֱ繏|Q9xw4_yl YBNTL .8n;v<ږv[&5ZWX gdII8#Ǝ;rdSf/3&jܸzLhygiGy|#GkKsgV˜ZrFuԩ l׮QladŢ81[}-adbׯ?5N8<˭s so g#9 +8/9m ^5yO?z9= SSD_J7jT=Κ5{=&aʄ } 5&y(:uP,8նmi^={6[y׮-X5lxu#zj0d-1~C_\<~EѫOrc?X㓉M18r\\F 9ͱ՟u 'KcZ}q94^}uiѢE֬/{@|}d -J۲eV͚_馆18睕^%ٳy۶yj]}|ˎE?m~͘1tֹ]r^ziqCիu4`-mڤvחUP*dbs,-w{8ٳ9jѢVXgV7pɒrYdîvmlY;L?רQ>lsgd {aȐ[J(VLr.>˧n^ebsڵ+.[rO&~W_\<<\R 'eCct1DKpejҩ-*>-4r f}Z=/5`@ s^ye]VgIpIhrޖZ'3s^^?Ľy6xpG U~KpIh*%8$hH4s@s4$o  9\ Fp[sHrD#8W-9$9G@ Hptiz(T={6>mu23 qYm2Cƹ@s4$܃akޢB㛊]RQXy3)4ZB]V.-9$9G@%8O}xHeC~umB#\fiӃM߿]ǎMSRFĉׯ_v튽z޿?k`ϞB-{?sEqwp}1_\|;N>dĈ.6ܰaz˖s_A}%8$hH4 ?_+s]e1X{n .[6g5o~Mj߾mνmuV޺unJJ-[f;TL4& γcc+oo8rd{粂KpIhw4_yl c22椤Tv={DzzK.)^~Pժ5{x7€hdyubc֯?5NpY?C,8? /9$9G@9Vp^rJۖ jW5, 3~LFƜFYOp!dY-{q6)eyuFp~7^sHrDsqgw>}ºCn3~Lzֹ]χɓ}^R/С#ЮPT4XylL޿X+o XyF_7׬^sWh,ա1~|5׫Wsg {{t{+.[cc.ﮉ^1c]bm{<~͖ Btjzv ig:lX8p`W޵ku'I^sHrD{p~"RSdf<# |?JpIhN\h%8$hH4s@s4$o  9\ Fp[sHrDȿg $G$59IMp@Ra2ΎIENDB`java-design-patterns-1.16.0/hexagonal/etc/hexagonal.ucls000066400000000000000000000405431312550536300232150ustar00rootroot00000000000000 java-design-patterns-1.16.0/hexagonal/etc/hexagonal.urm.puml000066400000000000000000000243551312550536300240310ustar00rootroot00000000000000@startuml package com.iluwatar.hexagonal.sampledata { class SampleData { - PLAYERS : List {static} + SampleData() - getRandomPlayerDetails() : PlayerDetails {static} + submitTickets(lotteryService : LotteryService, numTickets : int) {static} } } package com.iluwatar.hexagonal.service { class ConsoleLottery { - LOGGER : Logger {static} + ConsoleLottery() - addFundsToLotteryAccount(bank : WireTransfers, scanner : Scanner) {static} - checkTicket(service : LotteryService, scanner : Scanner) {static} + main(args : String[]) {static} - printMainMenu() {static} - queryLotteryAccountFunds(bank : WireTransfers, scanner : Scanner) {static} - readString(scanner : Scanner) : String {static} - submitTicket(service : LotteryService, scanner : Scanner) {static} } } package com.iluwatar.hexagonal.mongo { class MongoConnectionPropertiesLoader { - DEFAULT_HOST : String {static} - DEFAULT_PORT : int {static} + MongoConnectionPropertiesLoader() + load() {static} } } package com.iluwatar.hexagonal.domain { class LotteryAdministration { - notifications : LotteryEventLog - repository : LotteryTicketRepository - wireTransfers : WireTransfers + LotteryAdministration(repository : LotteryTicketRepository, notifications : LotteryEventLog, wireTransfers : WireTransfers) + getAllSubmittedTickets() : Map + performLottery() : LotteryNumbers + resetLottery() } class LotteryConstants { + PLAYER_MAX_SALDO : int {static} + PRIZE_AMOUNT : int {static} + SERVICE_BANK_ACCOUNT : String {static} + SERVICE_BANK_ACCOUNT_SALDO : int {static} + TICKET_PRIZE : int {static} - LotteryConstants() } class LotteryNumbers { + MAX_NUMBER : int {static} + MIN_NUMBER : int {static} + NUM_NUMBERS : int {static} - numbers : Set - LotteryNumbers() - LotteryNumbers(givenNumbers : Set) + create(givenNumbers : Set) : LotteryNumbers {static} + createRandom() : LotteryNumbers {static} + equals(obj : Object) : boolean - generateRandomNumbers() + getNumbers() : Set + getNumbersAsString() : String + hashCode() : int + toString() : String } -class RandomNumberGenerator { - randomIterator : OfInt + RandomNumberGenerator(min : int, max : int) + nextInt() : int } class LotteryService { - notifications : LotteryEventLog - repository : LotteryTicketRepository - wireTransfers : WireTransfers + LotteryService(repository : LotteryTicketRepository, notifications : LotteryEventLog, wireTransfers : WireTransfers) + checkTicketForPrize(id : LotteryTicketId, winningNumbers : LotteryNumbers) : LotteryTicketCheckResult + submitTicket(ticket : LotteryTicket) : Optional } class LotteryTicket { - id : LotteryTicketId - lotteryNumbers : LotteryNumbers - playerDetails : PlayerDetails + LotteryTicket(id : LotteryTicketId, details : PlayerDetails, numbers : LotteryNumbers) + equals(obj : Object) : boolean + getId() : LotteryTicketId + getNumbers() : LotteryNumbers + getPlayerDetails() : PlayerDetails + hashCode() : int + setId(id : LotteryTicketId) + toString() : String } class LotteryTicketCheckResult { - checkResult : CheckResult - prizeAmount : int + LotteryTicketCheckResult(result : CheckResult) + LotteryTicketCheckResult(result : CheckResult, amount : int) + equals(obj : Object) : boolean + getPrizeAmount() : int + getResult() : CheckResult + hashCode() : int } enum CheckResult { + NO_PRIZE {static} + TICKET_NOT_SUBMITTED {static} + WIN_PRIZE {static} + valueOf(name : String) : CheckResult {static} + values() : CheckResult[] {static} } class LotteryTicketId { - id : int - numAllocated : int {static} + LotteryTicketId() + LotteryTicketId(id : int) + equals(o : Object) : boolean + getId() : int + hashCode() : int + toString() : String } class LotteryUtils { - LotteryUtils() + checkTicketForPrize(repository : LotteryTicketRepository, id : LotteryTicketId, winningNumbers : LotteryNumbers) : LotteryTicketCheckResult {static} } class PlayerDetails { - bankAccountNumber : String - emailAddress : String - phoneNumber : String + PlayerDetails(email : String, bankAccount : String, phone : String) + equals(obj : Object) : boolean + getBankAccount() : String + getEmail() : String + getPhoneNumber() : String + hashCode() : int + toString() : String } } package com.iluwatar.hexagonal.banking { class InMemoryBank { - accounts : Map {static} + InMemoryBank() + getFunds(bankAccount : String) : int + setFunds(bankAccount : String, amount : int) + transferFunds(amount : int, sourceBackAccount : String, destinationBankAccount : String) : boolean } class MongoBank { - DEFAULT_ACCOUNTS_COLLECTION : String {static} - DEFAULT_DB : String {static} - accountsCollection : MongoCollection - database : MongoDatabase - mongoClient : MongoClient + MongoBank() + MongoBank(dbName : String, accountsCollectionName : String) + connect() + connect(dbName : String, accountsCollectionName : String) + getAccountsCollection() : MongoCollection + getFunds(bankAccount : String) : int + getMongoClient() : MongoClient + getMongoDatabase() : MongoDatabase + setFunds(bankAccount : String, amount : int) + transferFunds(amount : int, sourceBackAccount : String, destinationBankAccount : String) : boolean } interface WireTransfers { + getFunds(String) : int {abstract} + setFunds(String, int) {abstract} + transferFunds(int, String, String) : boolean {abstract} } } package com.iluwatar.hexagonal.database { class InMemoryTicketRepository { - tickets : Map {static} + InMemoryTicketRepository() + deleteAll() + findAll() : Map + findById(id : LotteryTicketId) : Optional + save(ticket : LotteryTicket) : Optional } interface LotteryTicketRepository { + deleteAll() {abstract} + findAll() : Map {abstract} + findById(LotteryTicketId) : Optional {abstract} + save(LotteryTicket) : Optional {abstract} } class MongoTicketRepository { - DEFAULT_COUNTERS_COLLECTION : String {static} - DEFAULT_DB : String {static} - DEFAULT_TICKETS_COLLECTION : String {static} - countersCollection : MongoCollection - database : MongoDatabase - mongoClient : MongoClient - ticketsCollection : MongoCollection + MongoTicketRepository() + MongoTicketRepository(dbName : String, ticketsCollectionName : String, countersCollectionName : String) + connect() + connect(dbName : String, ticketsCollectionName : String, countersCollectionName : String) + deleteAll() - docToTicket(doc : Document) : LotteryTicket + findAll() : Map + findById(id : LotteryTicketId) : Optional + getCountersCollection() : MongoCollection + getMongoClient() : MongoClient + getMongoDatabase() : MongoDatabase + getNextId() : int + getTicketsCollection() : MongoCollection - initCounters() + save(ticket : LotteryTicket) : Optional } } package com.iluwatar.hexagonal { class App { + App() + main(args : String[]) {static} } } package com.iluwatar.hexagonal.administration { class ConsoleAdministration { - LOGGER : Logger {static} + ConsoleAdministration() + main(args : String[]) {static} - printMainMenu() {static} - readString(scanner : Scanner) : String {static} } } package com.iluwatar.hexagonal.eventlog { interface LotteryEventLog { + prizeError(PlayerDetails, int) {abstract} + ticketDidNotWin(PlayerDetails) {abstract} + ticketSubmitError(PlayerDetails) {abstract} + ticketSubmitted(PlayerDetails) {abstract} + ticketWon(PlayerDetails, int) {abstract} } class MongoEventLog { - DEFAULT_DB : String {static} - DEFAULT_EVENTS_COLLECTION : String {static} - database : MongoDatabase - eventsCollection : MongoCollection - mongoClient : MongoClient - stdOutEventLog : StdOutEventLog + MongoEventLog() + MongoEventLog(dbName : String, eventsCollectionName : String) + connect() + connect(dbName : String, eventsCollectionName : String) + getEventsCollection() : MongoCollection + getMongoClient() : MongoClient + getMongoDatabase() : MongoDatabase + prizeError(details : PlayerDetails, prizeAmount : int) + ticketDidNotWin(details : PlayerDetails) + ticketSubmitError(details : PlayerDetails) + ticketSubmitted(details : PlayerDetails) + ticketWon(details : PlayerDetails, prizeAmount : int) } class StdOutEventLog { - LOGGER : Logger {static} + StdOutEventLog() + prizeError(details : PlayerDetails, prizeAmount : int) + ticketDidNotWin(details : PlayerDetails) + ticketSubmitError(details : PlayerDetails) + ticketSubmitted(details : PlayerDetails) + ticketWon(details : PlayerDetails, prizeAmount : int) } } LotteryTicket --> "-playerDetails" PlayerDetails MongoEventLog --> "-stdOutEventLog" StdOutEventLog LotteryService --> "-wireTransfers" WireTransfers LotteryAdministration --> "-notifications" LotteryEventLog LotteryAdministration --> "-wireTransfers" WireTransfers LotteryService --> "-notifications" LotteryEventLog LotteryTicket --> "-id" LotteryTicketId LotteryAdministration --> "-repository" LotteryTicketRepository LotteryTicket --> "-lotteryNumbers" LotteryNumbers SampleData --> "-PLAYERS" PlayerDetails RandomNumberGenerator ..+ LotteryNumbers LotteryService --> "-repository" LotteryTicketRepository CheckResult ..+ LotteryTicketCheckResult LotteryTicketCheckResult --> "-checkResult" CheckResult InMemoryBank ..|> WireTransfers MongoBank ..|> WireTransfers InMemoryTicketRepository ..|> LotteryTicketRepository MongoTicketRepository ..|> LotteryTicketRepository MongoEventLog ..|> LotteryEventLog StdOutEventLog ..|> LotteryEventLog @endumljava-design-patterns-1.16.0/hexagonal/etc/layers.png000066400000000000000000000370171312550536300223660ustar00rootroot00000000000000PNG  IHDRz*tzTXtmxGraphModel͔]o0? K*K_ЙL]V]@ҒROo"a;WEo(G4O+Ed##op6M;s=sg̳ͅW"nfGʂR#GBF<|]a/%2yq*LQDž=ny\m4.'.#VRb*rTg0b!u eI;T\ RH\0 u-EvE>*KhweNٺ~ȼ`+{l}gp>U!ua" a+#l[˼M➒uPg"KQ\}Ͼ{tBy,?G{W8HLП d3ʄB/ /G`~3)eq%y}&pv ,o MHNx+忋c9` G;Rmq.ȝrU& c9G.0} b}Aac>bbr֪&˘9םhoYB*oIUdQH>i8عrR3e|#>CB^{:^t>*9w1΢CFP)4hS#sF.e8(]<5p#, Ms\a[)DTDV"33߈Xn%F 4 |PFKo\ VI80;N: NW%yF 4b+X܈baf^-ɣ# g_#F _3oAQ@ea)Q(!ˎ{aCauшF<7!k0nl}BՓ_"9$=$=|4zx= *-idO#{o×'YG/&OhAv+&MzMQGдMiW,L)G3Fd{V;p,bWaxqw <n]m՜3!@U{ 3^%py4i=1{{"roaxQ*iTuB s8wahe @ @@NE+Lmv&UJ=K{>lzR慖HO;FL ?ߌN?p?.~5u(jx@Ufn[cN\Upt!5Lcl]9z0lhڮ!ҳaVܺz5<>~(`3b.@a=0| tظl~}]P~Mof£&6 ;@@<}&r1n٣0e<*>2)xhB ~/OՉe0x\܌螟K <[U3EVг; +w/40hѿpnt뷨[Ab+Ŗo~EV  ھߋճ7`ԴwsP:R]ƚ G:&MzFn0c"w23Z^ sv| xV<_}ڰصi^ޟ6~w4jU!u!H"k90r| 3h9:͗|g0񫏸P#ė3s.Dh $O|>, }K_,ؠoGļ16-N~Av|LzgmLzJzZ&=<#S^Z5xJ5Mm\ߩxd5-7ŬpeLSśTt4&~5B7# ,1K7g!un uz }&jBRww!sr+*aoV/>gFD,~)bcphږMGcˆߏ +n oĵK7prq2>%8uVкߏ>cQ'q#X:a5z O~\٫?`& NƥtZh95âb{ 0|N9^ hdA#2ٖOMCśgeAc\/ޮvZoKF7eBmWsbŗ?Y䑍y?= o9Z5 ιP*Uش?-0%n%S`emg=Ev eff|0xDm̼ˡ9Ӥ{)u|]v2oe3{n$뇃kH <\٫8p6N_6.w37b}ss6L"=%=- r{ UvAe4UFVK7ܪ#c&^.7>6vXl89Lʐs2QdO?O.~=>_7 `9u`𥘹vy|\ 2~tI,GĠqp+:czN41®X*?Mv5#浡Q`€~%M6_IOy=XE5'! !Yߙ~>N.̨_^pr9p9Z _ǍwOt:(f'S<+CsXs37=ጙ×a 6͟s*\~##`ʝ$>Uāsu3!uG~_sp} ƭz`и-FԹv\UÌaKgblۦe QyX^DT1I$@pxah^.RGu k ^~#B|Ғm8$šĐ3 |ҏ81t4k~>߲}cXKl@-;?\<-pq-&hܦ>6,ڎ?k [5l: {pxI  /[`hҦRv NS⣹Ԩ31X1e=uOZvo>ƃI9t{%n[~6"6!qP*iٰb'}揈3x:pǯ7țؽq?lz*qЬ^r %&B\9UkK# YkdAo7NʿrLxahR5EPtA F9udrL>,?8 銇[)l%r.?&-&h2FCE\;OO,FX23pdɆ`;y|a ́n$'`'sGΖb_(L!bS B ʆ@K& &@!@"pƕ|8rm^ OoxyZj]!@bnD&/x-XT'rȞgnD@xAWWwxҐҐ ہ7 .%O.i#_Gni-)i1&I<[.pֵ|HS`/CF AaXuF>׬U<Z5jT*:7 fMb~ f~ iXc!eR+AQJq!@Jă ((:zO~ZDD@P({5]!@$&/&<g@vBFB" ԟVi( 쀅R) `BU7664 -tHs{QJäTm*4 -tH1;f63- YP{au-H73NR#Gg#]{$Rh59Φsڳ6>}$t:+}sA#|y~RVVJ̻zJS|.k(sf(aQp.X|\}lVǤ4/OQud\Nx^CshuiOH#U47ziZt|/ÄT#h˅F)R/KR(s_"ojC,e-4bNQNocL%rU>Asa(!57K|NjWXkFDMO++6 0L1RIOrs̳*=Ȉ7<?Z*xX ~.z3Գ!<};EROB]7+-R{s.zSt.8N*k{9)[B'G2Yf'+OcY1'ˤ|iN>3D1>s `?gL&;]!AZ2 5G!_WV̤^|(ٲȊMn\4y GJ+Sul&P`}޶V5sPgX0ᥫ $MC4y2#Bz!`8 z5ZK!@@2@@5Ev<5 "B )Dմل!@ @͆2#΀D{z1PYDCq+ p k<l9hIHހM6ѳQI`ͽ]B`-q4JaT1eiNslŷweD{*3߈? j # Sm4GV5Ͼ 2\R8]q̣!N(KC Xc5n|N8.NIJ,M.qm`'̸M%CqMal qŘj9˔ dl'ⶫ剅VcfW@_WO<9V؞xcdlVޡ&9ZT 1VJe'&*IYBjZC Dݷ; ջ@Pd^DJ{N.G]ںUe.-uޥغ98{2o,g=3ԅ~Ѩ Qf@N/36R"ӳv lf(;G"4oy^GCHF fX׍@\~v~GL0_|ƻ5$nv (\kT(xw2+F.[<lmp-Ѫ v3%ϔ\2*a'ڻAjWM0,c=)m S(7=!LH۩ + jT`Y3e.L) `: HdUf'CԎssܕgg;iKƒl oTk;w kwpJ9B"B(?IwN!9)hG4DC+MCfeu5pAt4Z;M)r B? h`L<^dcܙO.DG_z}ơV=<<%Dtr};`q!F!sn U Bb>)Sx䝒wJCgd*q~+4,#᫐ܭҹ[EC!.z *9sS&Eh g6'm/=yf4K bjHX_>j= WZ4Ģ :td?@>&lF 84 D Kv@}1VLB!P)$cQX0U^$䂑 (@ՃEc=G){$_$_$_OxwP! -Byd,<3h Fx7@ @ Xc3֓[R@}x4$ g<!R KJ7~Wzр()B,ԣ FՃw@}R~R~ 쀅]1@zaܻ NMoT)B *yV2⮝!a$gB䁐 -R P;⮟2EӎBi&_+K yC]/VAYX:6"19=40- |m/6#a&>r B|0q#wdZԫcKhӢ&~n%a 1;7A!N,ߛ=5 |7\оmZ/glf8Jz{DH%68OG1eoHH_¸/#8г3irxaj6$Yo4olxt>X )`o/׳"$ ߬=ȱbM s>VVVqQpR jz#)%uj⛹o[Q*ב&@) ;{'ԪLCX:E[H^g'{5i (nDb/ȻPZōcj~[81߃4 {=qG}wƝ]Y w X¾y8ޡH4kr5w79x6C [_U mvs߾\G?3'SQ3] y/t|.k' hx.^7ځ^ǤgrssևkepK7j_!tn7zo}/UP1#7HVh9 #/xӛ43V$Yvc7{|@ٻ 7*Ny&z:_uDߡSpkD`*u zuiUa˾h\?ipws,m6&bѶ\ W0ݾ =>2N -W!%rR9J oe|=&p&9bit17^Hh։B)Ьv=sک1nN49~\2=^)Yŭo,<|<)wCd6Oc0b؛ag= t{:X[TIDAT)[ͺCdDgJ 7?ylBuk૙yl/Xz?WC1oRotjߠۜ nn78!ccl=bm{^y,֟y \?Xw Y n=ɬtOxG%q7ASS@:m6b 5H PgB] :۰Cؼ]z[4i6.ECqs9m\>q }O~՛b/v+m _?b1y̫='O_P5xb#_ARC1h0O\”;tz_C{*H$~rĉɨWF}hca^աNwՌ7 鎅_Gחp\5MM6eݦcHI͆&@0MOq^BO-T,'v.-$'. stEHH!fo#5j1\Hte_kH^\:p71fnsu: t3S0y+zEq`|l\Z2JL? J  `$JD+aK\0^εD4~q6,z -/DH\76E Rȫ`k+AOe0C<7?\G9z dde|e!ak8ـYcخ<g X[~-&![ؚJ?v/OzKzk&%FrB)pAHXs8Xvlu_g E+`œ?bV? ݏ^ŌϺA`u=կaOGtB6mL[\Þu9  fOw}d>Ob]yaЬa.dx);G/EMtضj(/'3S-?ƠMЮ<[7~ܽA+q-D=ӡU8}6.후@uo|s&c7vlĬ 1e+<f אHmrQ|8y;&~s'1Rdrs[[ߒFr|L8!stAHfeRƄZ^G0뿑/6N7k1Wacm mNf,yJx{:avX}8tCx zz90O-Bpr/ܼK`H;W;y˘8o'9ڷmX2;u6bOL;ϙ,]>l?oOk4Ř:06K"19ڌbZ\&Bn͑<}1AHy )IOGba++%V*Q0|(\f+k+' 3!A$se-)!ɉwi>A $Ș1!;`v@[ 7(B ʆ<@)# >gZL__eĂ'| hԪ̙΂:x|R@HkP/*B!B(#.dNOLf?w8y*mKrP6=8gjPQK!PI`jynw4MT9MTyrEbo򁷯4@+4 HvB<;qcM7}HII-Tiμls斄\!/|D4G (:ځ$$''!䄠@(d IIŨ())&N9 $"[Hlar?)1))!tP%ܢj!PnCVV6[~Q$ѰF \jC.WQj[SmxsrEZn2 B @UP7>@XP#>2[H^bYqw=MOg d,'ER]IX@c"$Ѓ|9yv  7?rPl~9)9ɩ&v;HViFF:].*-5`o''n7ccAΦ (1)ETyaJh K3J=+Ze&&sy&vi:]r5ɅJS@Y;[Xlm%P5B5.(GW|9Z{[ lv#L 86BʃIYan:ss/9q5?^kfK B_ZkEciX%ܒkBC1~4 z#N%W1ޥ͗HK/㾕9p[G%_"G%]<l96+~ ($2}k]r4r2{-XX:Sav~ V&z * N=f6R%5WfKǮ((3:@f{i!akkVڑk0rs#q]nnp+McNXoeNBFBoWj[$wp`V)C.YlL9WӸ~)_1~KÌK^/{;8Bjo'_?.g!!M#R̄IvbBlCQ,n/;E_v'1Kʷ,za\?yR" % ~-?m&#M_b{ja+2]_Oqa|xA^/K$'KKAR##\qt)W{ % 9D._U}lpHOx|;q<<ԙ_50- W8,iMR( GYg| pdp~BAaL~0SRVΣ+)HM>ܴgo' I80;ptʂppg k[rm9+7\7u?>=? MMT &Γc߯'v!oN H dX8Ú|6inrK `ՂyfhvfhvA B;s*=C!PEw|^ԴB7! hD n`4EpfE_4 Hd,yS>\X8gNA K]()W6};|v7޴@p Ov񟷘 ^+*]!@@ZS L? \:~_ȡ!Fph2qP y>dߴe [$E[%oWOO6F@ B2Ѩݯ<^P jEQ27JETd}n]nFsph("%;`v g3 &Si2 L&$amuyF:YԈ~DQ@U& hYF e|Hmpf,8syNHKm;3hY3&OBBE;wc΀7p)O^¦#Pb毿a[o")#_lOʤ*EPv]v^kWOOn 2ȗ:aSw+ qy^ѥYSc'~?sB7!WsfW8j$VB",7^m߉?ΜŹP ItZ {:mɈڶViW"E؟{ӿ1zFfyO[8bܫ`z wgF([bћp4&=-Ÿ`믑T=2R"t8fl=\]#F` C 4yXeDD+0Ӌ?Mн+&3nb]CQp`lm_W8Oo܊u@yfϐrVwTD9]k$@o7U7폈Db/`~~ fw!`m1avL ~w/}΍ry|.Ϟ-cӈ7ߺ zn(ܸ11ޘVezCD=kjDp՘ir+D%eHOCԅ E+6k^B,n 5PCGڗSav@Pp8x( wxD, : BX8uh`bh쳴u\ z#m%;`v U6H,Tj!@' R Օ? uc:"&yztԩppʳVP`W 3HIT /z MA!`>shՊi-tbJ)ٳE@-Ug.)҃'g_(HQNNhX76@4&@#֨OhPv-Iف 7o"+;;bhX^5CQ3d,DݺUO¢psqF`:Q`Q".?A;};Y|@x!}hCc 9$cQ),ͭCy˧_Y N7gQ"7c,2N_T~9xEw[Qy{y+g/iCqϘG 8<ŲOh?,@#4NIENDB`java-design-patterns-1.16.0/hexagonal/etc/ports_and_adapters.png000066400000000000000000001040541312550536300247370ustar00rootroot00000000000000PNG  IHDRykpzTXtmxGraphModelMUٮ8~H3}Y \kHBi%m#q뫲]BWMvyȺBj <̪74o E4#{t yD7U}ndIݟ*B9mvgH=y:P^}l0= "y^nbNH!Ӌo^lQ8RžB NtfgG[Go,hX^G~#Qm=mIXǀtvSZр2R-C&z᯵^NЖ.K[ʳ(V,+>P0XZ7 Tb>$$ 9Oi3Z BӦޫ|foe %Mw㪚qhRO=8kW8jNJ+?$ )y Ảr"OøzaR[jVL2V0f^1*1ߙmB,*́@ L_ O$$ IDATx^} XUU+($,"9(i9filԗ}Z9<+(" g>p@s=ܵGZ>޻*ܿ>x0#0# Ltul #cǎżyF@ƌs*o0#$tx#I8޽{ŋR&m`;wPV-lذZҎ)#cp4FC~[o7lb,Z֭ömۓ7b`O#C.]:MR3!!!xWoYM֍0 1@VV6[f ڵkgN*@`Ϟ=0`T 4bEI=[S&N{a…:R;GFŊ7ߨ]U֏5Lt}l!pt.\Ԯ]7oFULb#Э[7I$cӦMTf&yf}lX|9,Y{,Em#FСC5lh&y=;֜x@nn[l:v0@`Ν6lQN#`N03f[u)SŋF6L9Θ9s6 ` #$OÇǪ3@dd$ڷo/% #*yVn #w>#гgObܸq &~-oߎ0mZ3EIFf+Wb8x -[b̘14hd=!$OOɶGΝv6V{lݺFa35f4< ӦM?2 &>|8U/BUɍ7=9&''UM&޽5DA&yk#piIzyyXޞ( 2uf ," Z&L?'0C2={6#݊m0ۉ=f@>}ЦML4,e#Yo>_^?F)d t^ZgW^y#zLfKuڵk_ѣ:075kɓ'f-aF^| @eݪ[&y<+, ubΜ9E$X,Xa?~nܹ؛qd\ mP ~.*>E %qIlkܸ1n޼).ʊf,޼#`0ΝCFDrx!#\"0N:ztait Wps,-,QPX g %#7/ -BLU *$jF@#M6|YMF|W5ý{ws@aKHE(T ڳ7QCVxpf1 O>5< ym?N.Go76ج؛'yez6`QBb7Icb4l3f@^F@ۆq[ܿ++{mS$یV9Mȇ-Go83Sz1E?Ǚ3gj*Ƅـֵ{d6eK "noyF>$;t g&y? ,Jy0ZGg ă(qf FPW1zz#j}3<>i#`РAhР>Cƃ̂}ubJbng&bh+t( Mpfg'eJA?ԩSX1@ʤ݂vunϞhE7UF>d @o833AePQӧ㥗^{+(}3PõaʤW7L5T| b g&yj}X/F;v ֭3kx @x^.^S̨-~gElȇbA97LtF@n ~,P}7Zhvb{6)\IM>ڶmÇ {'KXf ԩ~-N>~4y]jMm}1lԨ+~7ׯrqT9134^ȁYo>iɡ+dʋgoosMߝ0;W+OGQ lAAw-[-[VV8pg3P<e >\/˲ 1yI$ 6Lxֈ}'سgOQo8Hx 8i$!,qJѿA?#O^ZZ 6l4Ht "uPA׿$,U+%S̜9]޾}[A)W_xD:ԩ#n=tO!5Rf,&yk hٲ(]PTnˢE:y-5(^'4[Hr(}G i[tMKWAcǎtU<;A)k===1tPڵ ?ٴD iK7o»H[(D")8K!a$B IJF@up Do84[7dF$%%vؽ{7(#ww'7a8L}^X:#P"#GEc_GvsĬG.zV@oC Co833)5Peybd #rF@;,?0 .X6coD m5I=74~eOo83+Lci g&y8HP^b,P=#"fZ%i/[UŸ>UCy(JL|zx/G{R><sDٳ 4Y J#ޑh-z#j= $OOKyQ k`=z $$ h= =՝P볯7IctUj=/^DJtgk֬%Ѡkp/݃P1bNBj,'=6GA(!++lY-5jիWl'44!`.BR @3gR6%޽{1at֍cx(oӦM={6 A$ψ2OC`ҥ@1f@AAȦ5kz%;NW?{n$''ˎ^7pssCEh<>lIBZD=vڙT-mkkk -,,I8rBkO6effb }$E̼`bUĉq=PZeG]v ޠ׭[EժU,ĉ:u*2!@.dtt4\$*Լ`Cbҥ(-M$H]g+?"}Tg=<}M6BZM>]|YjI,"<<\`&y|l,_K,o<ʏ$///O1cƈ?p\O DFqG1p@P&UX2!@0lZr7ՠl#F`СReL<+rssEge˖cǎz1KQ;MToB+?^d Fw䱣YQG5/yxhn߾}1|AyHe8JS;wbذa£hcccJUxoFd032e()I7Ȟkl?CxhyyQږbDdPրеkWzd6Q]v avvv̙3ՠ(Ã0)#vZfK  ɍיL| 鸑;Y/%Tk%x9 8o4D4kL߿feC`gj[޽cUK®DgT laeiBdf %- 鸜G{[tf̻"BTJhilܸǏGLLf]`glȜ'z-"9y2{-Q`km!f+((״׿ЫW2cHe`e$Gܹs%[J.ʋX%!TEODX R-V3XN8nwq)ԫWO:3eBI^`I?M6|h A_]ZׇuI)ز,:6_0v؁!CkZ'''ML-;uiVxL`ʈHZ`'O, ȃ djed#,45 %-P<%Д7n,ZKTC3{S<#^ɚ[T 8q&yz?}O234$D1x3WŀH{||S4uc{JVHNh$!1d޽0au& KPTӦM={6ڶm+:0 &y8#B|⊊sםQ1xYL1z7R0_piS5: oo}]MS?[J$5y6J(M/==]W_ Luqtt|@xOM!@Iԟ^R6 @eRvOD ٕ^= 購JHH(m'JWTW:х- /2XHzD6#"":7\5wAr( ѵ]{PD&y:VFmpE|ӞDgCѡuJC'o(mjKAp 5Ѽyscũn};`boD]x(}Z,G tJ֍I6ύVmO؆,n߃}[B1c ^;2TЫj6@FIſ6mÁhΕ=6/nmF+h&INl0+N< $c֛d)Y7'cG Acު=?>ĐHCyYr(J-6ȃk}EڲeK "noyi]$OZ+nPW`7ޢ8&[eO!G7R0|PqB\^2]ӧO.<-}*Z!i]Ԣy/cLҦucI%UT }Z???Q>> pؓg0tPOPggg̜9SOf)f "bW:^K}^DHVq抣xJ+WGRJ&l>)CfC^CGjƮJt=ENӮ{dhƦw#x$,-.(,@xbL@&k,ɣ~ѳ$HQTT y R5t{%'JfzVkԨ!> G@H6].Y!P("[>jYIċڹs|7aee믿5KNN.q<"䑤_] =0eA,iH6Ž }?ݻW%2J7<#Jعs' &-lllTz:}+ YQ^2E.uѲa5Y &]7!^aѽl Ed:+'ԫQn2u>i, 0@xP<>  }+mعJ]C2}W1c z=z>L:"yjڴ#D7-ذa>++Kxė($ /ZXXKď={舟~I|=J~=G^@&乣kj+"yE: Iڵ rd'J5I$d zSR#>/"'Aq\}V@ߐZiLn&.*⺼CJV$Xl=ҭ4l]G ]J" ER@?3 UR<"TG1k4HyZyw3""z4zs„ Fs)ɣcFް3CD<(}J蚖JHcǎtJYI(fl!"Ak===EЮ]!:(}"=H.=͛7Ǐ?(/wH$cC)hGS͹VKUH>SOdtkKA^'u>FWrxa @Ĭxaμ,\ZQ>=|V+?[d4$ף9"y=sEdνkˊ)W23%IurS+C@/}`gifLS)'y^壄bgc_pp'f=tA׳rW\&麕@haۆq[ܿ$= ǙW.L򲓑|a-nEŻ)\5-:)'ݾ~ ㏡R k;r7~>1BGe%tTV)CZ= eNY7m ,TdZY۷~۷#,,LƲDI**/V¼yp.D`ulG0(<}dAO>hӦ &M$|Z2TaÆA"?/WTwsS%W ,$&rB m!2)ww}[neܼr5z[E7L߾Ozg&xf͚}a&؝4Wk׊ԧ裏pԩ6&2rm&FJd"?VVR~.y ʸy c7pp+%`ܛdQF/ZܺYf{DZq)9o(uŜ9s $|S2r` 'O /nD!3#MJJCK"jAzP#&&Ffm*BIU);1O?}ϔ?Ѳ]e7QXXXZI#\ ֕dUy"6y(k00ɓa/9Νy(Wr,ds*WC (\ ]U-3\c9j_rEw(ԡ^zULpJCM6|`022d.\(^~e1אALoܸ! aO˞QߡbŊpf~O޽{\>+GVv4W_}cǎaݺuULpJ~w|'8yQqԩ6l؀͛7F(f0''(Bj.V*+nxJe/"&s0O=䎭TnҸqcL>/F-`<-*1c `Tn߾VZ}IB4._ VQsqʄ>8pGƝ;w`kk cǎ׿'N y߿"gϞy *ѣΝ KKK[\A/_\u&'N2mll66*A bhiZjCQ+d!,*nR]vC4SV\0ɓ Y+9ttPZc]R G$j" ???̜9QQQxg?)Sҷb "5!OEƜEw߅޴fppp!!!;v?K*VTIS6%=ϟ%KcQkIo*&M G^׷D~WqJĮ$l23u2$[iI&׵kW1BȠk_;99wd''/M? %us26p_Aq*"F) ѳ[{Y \|Ӽ[o߾"3KqK먨0ի?DH?"}宓''YW0bؓ;x oq|mr}hWEAaܫ؞R<'鱕K+\</5 jxA׼t5KYzrwJ:&Ùtkcm&LAy(Iʵ8xV87 0A1yri\8wjL}&y;0VԻ֜Ha/gٵoBP3GG`Y{4{>~Sp,,:ب?rMɌ%شHx_5fJdS%#kP&yJ{IQ҄ɣC+K:y/^"b1qMެI|9}4Z6o$30j $J-f~:;k"y4Y?bj`Pϵu򔈭 ۸qӥ<%`ʼ,]Vԙ%Yq'+W DJ6t/G4sOD j*4zҮS͎Oę˷)Yež-L$QyZjȑ#V&F@))4#TJ㏲sIx:N`_V/(DfVRҲ )pEhVϣT("#a=q4 p 2x/-Ľx7y8Ti쵆n:cƌEy0J#ɣO{ń D3tr/Pti&̞=m۶x<@Ϟ=ް<Һ><\[WҎI)ز,:6_O7v0\qrz \M`ST^(RKC)x@१cզЃ,D̨y;ZZ0"m#Qȣf Lqb q44}^i}\ڵ^ŋ^n{Aȑ#쌙3glJ$_dxh$r믿jCa-[;*>$=]+ ыr٣/Mf_|Ig6{w܉aÆ[h*+乻ɓb7n7ojHkeT];܂:!%:f V֨lWjs@xVQF)B:vODPoB&O.y$N/QP,] w?| U KמgM1Ce" H^ p}*›>1;p.oGFvV/\agK K ;7)HHčKpsB Pz=[o~9W&P8JLE܈O'CPq;+gx6|j^X "<<\$`L oبDQ {|~|}^N:Z:!=Ԋ{DJX!3XU!$Oj$%7'cNt գu^꽵.:EQņ ЪU+ &y>Ps$yT&e_+=1&&˫> nʼn\Ǿf͚U xez޲Ǒ՛[%pR#% {&OÞIbJy#gaaXL3<)N/)f|Zj ӗuu?GA%="ƽôsΠo au$O+=z!Ш_ZJ=Ν;ooec͚5ξhS,G)7eZz"V\¥ZSc`0hp;*U [eH-]?3"""4n gtAkժU8qN\y)<󈏏*5 s#y+σ{?EjΙlo޹ώ1{'8{4NPoAwֻ.d_KaȺuPk\MPj \jc-@deee 9ڵSCbMIHެY@)/C|륳gς*'$$?#}YAC 6č7KS/ݺu 1|p\zUönZMMME-m6aڴi{[Zz50g>}ǏG׮]EZkDźyyy[}\Ri|駟=z,-icd077oTCҺxOu^ ǘ%NU74J{]Ss&"=!iaS~쇊K3ݽz^!l|7=`_*0qD-w}qKX}#85jԩ#?|rA~mԯ_Ǐ D(Ġe˖0pΤ䥥q[GDfϞzzd6j{EPPhAC_~=,X>L @dd*ɂհ|MXYYn޼yuOo~n:Q?^EE32y̍.z "3r#Žqœ+}%;z. ;'OhJ]~{:5fZRfwSN!3(2oDa^&*:T]媰sME'XҺ",,(,CA=f"^o#-H=6G3Tv-KG?aް75P.]d%0|P'իcƌׯ߃7Ѽysm+kF6eff>J8k۶-Ѡ^z RW-^Xxuqqd<͛7׊<&j*,[L4X?jHM$Ɲ;wPreQiӦ i_¦]vhJqPS,\mr0ՠLUŕpùNAuNVDH~jtQ9NENd^C~v20. ,UeXWtl}` ;X:˪^4wMȌ=ZyFp$'ykA$(00P;vL$gPup"FkDN>:k'$(~ѵkIO?T *hyox(NJrD`5j׿ݻwGuqA??|0HGpww;ؓg,'Oޟa K6sQ <\y~I)X io7}5_ ?5%VӒ%KF@ HNZ>P2]e`"VѠӧȃFWDړ@-/[bڃ(N~'FTHk&Hɓ:JԠ&=|ܸq?F'Hx zJ˖zծ ?ѫccYLdۈMHǍ,E~~,Q <]+! \'rbq[ej&^klرg}I*6moJf7hq]IW+V?'.5'MW^yEĿQ?n-{B y9"kHDϟ/bJ"y]'s!<k׮ weT"%1X=ғ>GHk>d g_/Dѥu}Iʨ%BEו]١snР(..(^+J“GYD>El]Sy[P%ۧO/E.Bu̘1k5"D WDc<=3{=yީTDחGb4 0*Fb"bp‹D{ x6{r&~EN^!x!*{-Q`km!yȣ'MF}"ق*B`,$O+k]Os#y'e{E7 U@ߐZL|G/2Y"r YMHN^n$>܇v'!$O}gRf̍0ܻ̏ly ,:):nvY?g ?!^ԍ)9HzQa%c=&ym^{y/2jBj,nFuEtm8A \fYZHʩTyL9Hr*o]Ls<Umѥy ңi2f&qqq F@0 2{ʡۑOǚpuG;W8@zv R2q#/2)JyPzi))zJl.*f?NGk ]^O/62JԱF)cfϝ;''̬gs y8y$UfZ9dJoܸaȳ{4.߾븛yQ{KpOP 6_//؃Ç.AuP{[Mi ӧ㥗^2]ԟT8p  1~V_PſĜ''[ :y Y{޽ftssCE$_*bzOi)قkOi9VIx/@Ϟz>_F1ǐ0S̎*liNR8>z5e&y0eD@/wO[FFʄ9dϗ [h09C-[S\$Sk\1:zl?0'(ZOكԺZSKŽ$GShVCx06#<m2R-i:NAu˶eDH~E{SK K LrR[.̙LgU@)6o抣xKeRJ&l>)CMz+E#&&`t<1(k׮G=*xe?F `ulhӦ &MV5dԮ][5DZx79uLnAԪ/PB#L/GΝUg6Wy#\*-,-_P̬e!19Rho\&Mv֭5j.\ S2#$OqyC!sEi7mڄg}VoKby\؄tH\G~a8Tk%x9 {$A4B؛myW#$g={"44ƍS5zO+*TrFoμ#`z X ۋ w=^$8;;aL`r$)vލ`.V-7,_}0SߙFE`ʔ)+ŋsO+L@42G)>̜94 𮌀`g@nn,[ ;v4aj4 ܘI^9S;wbذa»nccR-Y-F@^ɋ/K73/_%K`޽&&eu-#$qE۶m1b :TN"0SfĜ֭zѣG+n68Y!<… ,3LvY~]tDe/k2ܟX슯g'%JIIa[l3Lv8q"wɶǣͽ?T@3ɓ I!zŊ7ߘFޕPLTt~}2׬Yvnޙt;RH#MP2Hh,!_[ԮR&)m,3֦b(Ҋ}.UJ'EZB%%=JTDh}99Us󹟼~6qr>l xܸ͛7뎣y͏y}D >([%<3rs<ƙ,0ljn3iڲ+صHyFP,xm<]c?T,r8(S :7{i7K0z/J4NIIyN&%NO]5D_%=+oA_i&o wT31@qP-,HFJFtwbwŞ8>yE:FojWm6 cЍ_R|8-@2kydDc٥عZȪnݺAΩE$poyR-:դwg+14-nnخ*i]l/^N+E$py!rYʻTQ=()2Gʃn$`~[LL.=//OltRm%1) XEeXL;;7በ^gk5hw۫رZ%&Lh"8I(\߽eiObmh/U~<CZMt ;[+t}!,,LR fHs ',e.ǻS 5Źy[wcܸqqp'yf믿y& ?r}ѣG,oNNNFݺuQzuMLeD>F|B~E1mVvSvE@[x‹S,J"OxW믿stϜ9Z=ԳgOL8-ZĤ^ 5 -H f]:~h3ǚN2G,Xp!Z^$@E'@WtVNwoN:RJaɒ%h֬deؐ!CsNUkٲ%{=<󈏏GF?ZQ&1x TV z4,~1-jwt_%Ag~ڃnE$`~[D,.M233(/ +]XI^zx饗0|pٳR!;~r*lƍR0~x AAAj뿳/C2,w^L&MkO>J}A;z(ѰaCTF0sL5k`x뭷&/5 +V ?K5R$+yuiЭ0xp̀Ogab駟)s6LUDj .\P6>>>8qT%O~j]JTUO|ܻkת̙"O11?z~g.-p"<-{i0+ [+ywVð/׿oWƂ 73͛k׮SXeUDcT]v0`N*[LRP[H'@8[O)d^,T aɊ *SNJɢ Y[pj_|2+.dCPYQ+\=ٶEN9rρ 6Pd(Kmݺ}E ,3-9>y2 ¡Ch,Qc<$`)yJw-]]j^Z !@g\add$˗Jhˎ/K]kxv췎I2JxfH'@k׮P܊E[\r߉|8-,[9vuh[+nR(wr<#/ Piǒ `HHBӀΚT'c#B:y@7ؽf׭[{x hK"O[V_T֧.CO:5GO;Co΀06ݻl@"IvUyJ\q~P;)9(S ~s"sF[Ǹ9ӱw^u7/  Piϔ_w^c_ ETGUeKy£oZ^.r8seF6)< _-[c8?~\-oQn]c ،-Eljժ6Kq̄ dee"c|n&xȣ$ʗgUԬT~[=3=O2EŃΩE$[ptև*uG ¬YT=5R*W^Ө5_f$#%# M:û󌲯Ş 4=͜={VM+yύ7vFU$`Ry&M "0ahѢ/_͛79wsW!Cd61k6]0:Ԏ6m^!Cz hG"O;D"СCÇ7U\F3hQ=(n7oaLim?իmdHJ(-J ={a+I:-q55&f>>۷7̧]tIMGhhBc,$`[yM=ncǎܹs8y0æ왋׻ԑ1c`Μ9ol0 EY3øH&J sd)$@#9y $@$P uA$@s!07g0: cPÙ^H $/ MW$@%@g00 gZgY w @YdH~G nH߄'zNg5h ՚HH(J XwQ£ -T\|B_ #(gH,A@-:wʚǜ},sp%*5O$@$ 4gهѼf{nⲬ1 @q P'pRKJñ Gp>7Wrb:ofKI@tERp7o! 3on xzz̙3(_ % hG"O;D$*Utx{{Ak ;ȳsv R RSSQ'd7 I"HE$`zHIIAM+$ c  Br! Kȳt< ի5k֠nݺZ= 0EH5j> 64{HK"H hҤ bbb㏓ XEI&вeK̜9Z= 0EH|IDXXCe|$@$Z (*;b„ СCQ}$@$`J2- HU~i9]vuUK$@# gy BϞ=ݥIl M P4l6 <ӧE$@V&@g1v  ]tA~4M$@$`$<#i P8pce$@$p?y$@$PFÆ # 4M J"PtF$`v}b HHõ$@$PTWZ> 0%VLE$*jvڵ ~IH@y` w! `Æ $H(lx6H!"'%% XEI&uVunE$@V&@g1v  _Ν;5M$@$`$<#i FÇW_}eX ܏E "ߢ_~ؿ? PY:} H@kB^wimHHPy3 @ǎnP ܗE; "pIĉB$@&@g1x  ={!!!8s֦iH %@g(n:#0;l… f kHH\*U 77> 0%VLE$*yyy?H4!@ F!( ,Yrtعs ___aڵ+ ] Pc B`Ĉؾ};"##ѥKTZ$33F֭pBwl&D$$<'q ;E ""^^^zŢƛI(g\F@hǏ4š[wO4G$@WL`HxÕc! ELVI,I"ϒic$`~~~HMM<S&sd第,4 PY-c,F~WEmpz9c$7< > ؜Ň1L/$`%yVc% 0&il gz!+ȳR+ XŇ1I#gc8 XEXI(>I9Ù^HJ(-J$@aLBV"@gl1V cFp<+e P|4r63PY)[,HØ1D"Jb$`A$L/$`%yVc% J|[.~RW\~Bkҥ8pUB:tիW7wa'Zq6*L8 ڪV3g(_rv#<%JNZq6U={駱g㏘3gZl  ;;͛7Grr2֯_I&ʕ+Ubccׯ+EPPpqHe 1sL=zȑ#q%.]G۶mѫW/ǣ~HLLDznUV^z \2.\*gFjj*nܸ'OOPF : ES0 %cX`/_]v)" "F+v*iZqv*>L$`*yJ!#Sn/^T2֣G% EJ%UJ*^Uoر1cիD<#O<}5kT^"oƍ·n:˫ ~*k׮UI믿Ʋe˜JV  E`Hh%>yO=Kb/,򢢢0ydU+rrrpA 0@,Аݑ#GnԩSG=&6EW.yRdɒ[~===!(=G.=@+Ύs$@#@g0"p+ZGD)hU`ѡC1BqƩJ_pڵkRۻws'+򒒒OUPɓʣT(ܪ1$`ZyM # `a5}t5?O̧۶m'sdt޼y* DVSIPYHհdɒjTdh:(ñs$ssD(bO?T-rJ{sH"όYaL$FyBVЪ 6-U]V͊|R6""B ʪƍŋ݂JBul٢JL:o&dqN:)(]vV7xCUsͦ PI 9Ù^HJ(-J$@aLBV"@gl1V cFp<+e P|4r63PY)[,HØ1D"Jb$`A$L/$`%yVc% 0&il gz!+ȳR+ XRSSQjU FouV// ( @Ǿ@$+ptՏ/Y 3Hy$@1~xƃ4/ `%}H0#F@NNbcc iG… dHX+"(F$z۷oGdd$t9zN9xF֭)`GI Psv60c[nŹsLuEXX!Z䍑(&N$@$@$@$`7S̻IENDB`java-design-patterns-1.16.0/hexagonal/etc/ports_and_adapters.xml000066400000000000000000000054221312550536300247520ustar00rootroot00000000000000 7Zpdk6I4FIZ/jbdbJAHEyx7nY/diqrqqd2tnLiOJSDUSK6ZHe3/9BkmUfFiDDqBM2TcNBwLxOe85nBOYoPl6/4XjzeorI7SYwIDsJ+jjBEKA4kj+qyzvtWUag9qQ8Zyok06Gl/w/qoyBsr7lhG6NEwVjhcg3pjFlZUlTYdgw52xnnrZkhXnXDc6oY3hJceFa/82JWNXWJApO9j9pnq30nUGgjixw+ppx9laq+00gWh7+6sNrrK+lzt+uMGG7hgl9mqA5Z0zUW+v9nBYVW42tHvf5zNHjvDktRZsBqB7wAxdvVM/4MC/xrlnIKW6qzRXd44yVE/RhQ3m+poLyk/X5ZPqwW+WCvmxwWo3aSYFI20qsC7kH5Ka6I+WC7s/OGhxZSI1RJi/N3+UpagBMFD4lL6D3dydnIa2lVcNRMFZGrASSHa99giQ3FCc/MzhKZmgaGcyOKBrMAPQwO2r7V5iFDrM549ThJgfJEKc/B7LMi2LOCsYP46oYg2kq7VvB2SttHCHxIo7ibhCGATARJshBqDNfk2AXoot+Lrpr4RFMk6UXXpwmdLHsCF5s6W/qwkMe+aEO4MW/GzwEPQmvJ3jT0cMDMxNeGA0GLxk7PDQ1H7VDKm82fnh2zoODwdPlz3jphdCUHoyGkx5oUeRdTS+iCQl99BK4QHFHxUoUWfQ89V5v9Fq0FXdOz9ZeMCC9Nk/ckjxVfa7cK1lJTWJ0n4tvje3vcjuotks5k2/Nne/6rJJ8zqsJHQ7Vd6PE6ZEtenJG7I2n1KhQBeYZFU0duJAbECMPRG3jtMAi/2HOwkdW3eGZ5XJ+Z7vECFjOqWevRjWbZOtCCJkXCu2Cvv7NzoUOjj7+7Ha+b1MwXOz7P6IefQwfPr7Qx33WNYNkR5s60nXuANkR9lnXDEIPWc8WNBvu2aJn+8v5JfDkF/V0Ac2nS3e5J/Hkntkj91yWe7S7O/U/OO/9/nzfWC5/+L6d70dfldsrOSEcbiXHs4R9ZeTUGdEXO41E2mX0TD3Rc1+Vue2gq6Mn6S963BX4Z8bF1hGBlLcwPW/GhFJGM4CUCRd5VsrdVDrz8FaoCpY8xcWTOrDOCSnOBWcH8YVmoYHzGDgNWYS+12pdxJe7SP/PVlKQZ1Q0ltVvtVEfXrRSojD3/w4NALvudd9hAN97x7ALQO6ywN90WwUDzqiS903h2CvFiZucZ32xcdvmv6RqMi6zFCtvjuZY4et851lN6g2N221+xAIv8Pb28RQHJhcwG04yOrU1uHxl6au0kLvBYz3dYOTi6S3doPF2irpKNAqe2I96mIIHWJ6Mr20XgF059dcuoD5axWEEoOsRQwDThwAuFECbfvE+Ox5dlxkCSB4CuFAAXbW8vpcRvldRHT4CfAK46WrhKAXQ5quzOxUAdAWAbrpkOEoBuE35E8Eb2Y//XuseVh+CPP1ZR+secvf0dXftkdMn9OjT/w==java-design-patterns-1.16.0/hexagonal/etc/presentation.html000066400000000000000000000064751312550536300237660ustar00rootroot00000000000000 Title java-design-patterns-1.16.0/hexagonal/pom.xml000066400000000000000000000037361312550536300211240ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 hexagonal junit junit test com.google.inject guice org.mongodb mongo-java-driver java-design-patterns-1.16.0/hexagonal/src/000077500000000000000000000000001312550536300203655ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/000077500000000000000000000000001312550536300213115ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/000077500000000000000000000000001312550536300222325ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/000077500000000000000000000000001312550536300230105ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300246405ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/000077500000000000000000000000001312550536300266065ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/App.java000066400000000000000000000066431312550536300302020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal; import com.google.inject.Guice; import com.google.inject.Injector; import com.iluwatar.hexagonal.domain.LotteryAdministration; import com.iluwatar.hexagonal.domain.LotteryService; import com.iluwatar.hexagonal.module.LotteryTestingModule; import com.iluwatar.hexagonal.sampledata.SampleData; /** * * Hexagonal Architecture pattern decouples the application core from the * services it uses. This allows the services to be plugged in and the * application will run with or without the services.

* * The core logic, or business logic, of an application consists of the * algorithms that are essential to its purpose. They implement the use * cases that are the heart of the application. When you change them, you * change the essence of the application.

* * The services are not essential. They can be replaced without changing * the purpose of the application. Examples: database access and other * types of storage, user interface components, e-mail and other * communication components, hardware devices.

* * This example demonstrates Hexagonal Architecture with a lottery system. * The application core is separate from the services that drive it and * from the services it uses.

* * The primary ports for the application are console interfaces * {@link ConsoleAdministration} through which the lottery round is * initiated and run and {@link ConsoleLottery} that allows players to * submit lottery tickets for the draw.

* * The secondary ports that application core uses are {@link WireTransfers} * which is a banking service, {@link LotteryEventLog} that delivers * eventlog as lottery events occur and {@link LotteryTicketRepository} * that is the storage for the lottery tickets. * */ public class App { /** * Program entry point */ public static void main(String[] args) { Injector injector = Guice.createInjector(new LotteryTestingModule()); // start new lottery round LotteryAdministration administartion = injector.getInstance(LotteryAdministration.class); administartion.resetLottery(); // submit some lottery tickets LotteryService service = injector.getInstance(LotteryService.class); SampleData.submitTickets(service, 20); // perform lottery administartion.performLottery(); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/000077500000000000000000000000001312550536300316335ustar00rootroot00000000000000ConsoleAdministration.java000066400000000000000000000067571312550536300367460ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.administration; import com.google.inject.Guice; import com.google.inject.Injector; import com.iluwatar.hexagonal.domain.LotteryAdministration; import com.iluwatar.hexagonal.domain.LotteryNumbers; import com.iluwatar.hexagonal.domain.LotteryService; import com.iluwatar.hexagonal.module.LotteryModule; import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader; import com.iluwatar.hexagonal.sampledata.SampleData; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Scanner; /** * Console interface for lottery administration */ public class ConsoleAdministration { private static final Logger LOGGER = LoggerFactory.getLogger(ConsoleAdministration.class); /** * Program entry point */ public static void main(String[] args) { MongoConnectionPropertiesLoader.load(); Injector injector = Guice.createInjector(new LotteryModule()); LotteryAdministration administartion = injector.getInstance(LotteryAdministration.class); LotteryService service = injector.getInstance(LotteryService.class); SampleData.submitTickets(service, 20); try (Scanner scanner = new Scanner(System.in)) { boolean exit = false; while (!exit) { printMainMenu(); String cmd = readString(scanner); if ("1".equals(cmd)) { administartion.getAllSubmittedTickets().forEach((k, v) -> LOGGER.info("Key: {}, Value: {}", k, v)); } else if ("2".equals(cmd)) { LotteryNumbers numbers = administartion.performLottery(); LOGGER.info("The winning numbers: {}", numbers.getNumbersAsString()); LOGGER.info("Time to reset the database for next round, eh?"); } else if ("3".equals(cmd)) { administartion.resetLottery(); LOGGER.info("The lottery ticket database was cleared."); } else if ("4".equals(cmd)) { exit = true; } else { LOGGER.info("Unknown command: {}", cmd); } } } } private static void printMainMenu() { LOGGER.info(""); LOGGER.info("### Lottery Administration Console ###"); LOGGER.info("(1) Show all submitted tickets"); LOGGER.info("(2) Perform lottery draw"); LOGGER.info("(3) Reset lottery ticket database"); LOGGER.info("(4) Exit"); } private static String readString(Scanner scanner) { System.out.print("> "); return scanner.next(); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/000077500000000000000000000000001312550536300302175ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/InMemoryBank.java000066400000000000000000000042461312550536300334230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.banking; import java.util.HashMap; import java.util.Map; import com.iluwatar.hexagonal.domain.LotteryConstants; /** * * Banking implementation * */ public class InMemoryBank implements WireTransfers { private static Map accounts = new HashMap<>(); static { accounts.put(LotteryConstants.SERVICE_BANK_ACCOUNT, LotteryConstants.SERVICE_BANK_ACCOUNT_SALDO); } @Override public void setFunds(String bankAccount, int amount) { accounts.put(bankAccount, amount); } @Override public int getFunds(String bankAccount) { return accounts.getOrDefault(bankAccount, 0); } @Override public boolean transferFunds(int amount, String sourceBackAccount, String destinationBankAccount) { if (accounts.getOrDefault(sourceBackAccount, 0) >= amount) { accounts.put(sourceBackAccount, accounts.get(sourceBackAccount) - amount); accounts.put(destinationBankAccount, accounts.get(destinationBankAccount) + amount); return true; } else { return false; } } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/MongoBank.java000066400000000000000000000077341312550536300327500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.banking; import com.mongodb.MongoClient; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import com.mongodb.client.model.UpdateOptions; import org.bson.Document; import java.util.ArrayList; import java.util.List; /** * Mongo based banking adapter */ public class MongoBank implements WireTransfers { private static final String DEFAULT_DB = "lotteryDB"; private static final String DEFAULT_ACCOUNTS_COLLECTION = "accounts"; private MongoClient mongoClient; private MongoDatabase database; private MongoCollection accountsCollection; /** * Constructor */ public MongoBank() { connect(); } /** * Constructor accepting parameters */ public MongoBank(String dbName, String accountsCollectionName) { connect(dbName, accountsCollectionName); } /** * Connect to database with default parameters */ public void connect() { connect(DEFAULT_DB, DEFAULT_ACCOUNTS_COLLECTION); } /** * Connect to database with given parameters */ public void connect(String dbName, String accountsCollectionName) { if (mongoClient != null) { mongoClient.close(); } mongoClient = new MongoClient(System.getProperty("mongo-host"), Integer.parseInt(System.getProperty("mongo-port"))); database = mongoClient.getDatabase(dbName); accountsCollection = database.getCollection(accountsCollectionName); } /** * @return mongo client */ public MongoClient getMongoClient() { return mongoClient; } /** * * @return mongo database */ public MongoDatabase getMongoDatabase() { return database; } /** * * @return accounts collection */ public MongoCollection getAccountsCollection() { return accountsCollection; } @Override public void setFunds(String bankAccount, int amount) { Document search = new Document("_id", bankAccount); Document update = new Document("_id", bankAccount).append("funds", amount); accountsCollection.updateOne(search, new Document("$set", update), new UpdateOptions().upsert(true)); } @Override public int getFunds(String bankAccount) { Document search = new Document("_id", bankAccount); List results = accountsCollection.find(search).limit(1).into(new ArrayList()); if (results.size() > 0) { return results.get(0).getInteger("funds"); } else { return 0; } } @Override public boolean transferFunds(int amount, String sourceBackAccount, String destinationBankAccount) { int sourceFunds = getFunds(sourceBackAccount); if (sourceFunds < amount) { return false; } else { int destFunds = getFunds(destinationBankAccount); setFunds(sourceBackAccount, sourceFunds - amount); setFunds(destinationBankAccount, destFunds + amount); return true; } } } WireTransfers.java000066400000000000000000000031311312550536300335770ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.banking; /** * * Interface to bank accounts. * */ public interface WireTransfers { /** * Set amount of funds for bank account */ void setFunds(String bankAccount, int amount); /** * Get amount of funds for bank account */ int getFunds(String bankAccount); /** * Transfer funds from one bank account to another */ boolean transferFunds(int amount, String sourceBackAccount, String destinationBankAccount); } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/database/000077500000000000000000000000001312550536300303525ustar00rootroot00000000000000InMemoryTicketRepository.java000066400000000000000000000041641312550536300361460ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/database/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.database; import java.util.HashMap; import java.util.Map; import java.util.Optional; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; /** * * Mock database for lottery tickets. * */ public class InMemoryTicketRepository implements LotteryTicketRepository { private static Map tickets = new HashMap<>(); @Override public Optional findById(LotteryTicketId id) { LotteryTicket ticket = tickets.get(id); if (ticket == null) { return Optional.empty(); } else { return Optional.of(ticket); } } @Override public Optional save(LotteryTicket ticket) { LotteryTicketId id = new LotteryTicketId(); tickets.put(id, ticket); return Optional.of(id); } @Override public Map findAll() { return tickets; } @Override public void deleteAll() { tickets.clear(); } } LotteryTicketRepository.java000066400000000000000000000034251312550536300360500ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/database/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.database; import java.util.Map; import java.util.Optional; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; /** * * Interface for accessing lottery tickets in database. * */ public interface LotteryTicketRepository { /** * Find lottery ticket by id */ Optional findById(LotteryTicketId id); /** * Save lottery ticket */ Optional save(LotteryTicket ticket); /** * Get all lottery tickets */ Map findAll(); /** * Delete all lottery tickets */ void deleteAll(); } MongoTicketRepository.java000066400000000000000000000144311312550536300354640ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/database/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.database; import com.iluwatar.hexagonal.domain.LotteryNumbers; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; import com.iluwatar.hexagonal.domain.PlayerDetails; import com.mongodb.MongoClient; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import org.bson.Document; import java.util.ArrayList; import java.util.Arrays; import java.util.HashMap; import java.util.HashSet; import java.util.List; import java.util.Map; import java.util.Optional; import java.util.Set; /** * Mongo lottery ticket database */ public class MongoTicketRepository implements LotteryTicketRepository { private static final String DEFAULT_DB = "lotteryDB"; private static final String DEFAULT_TICKETS_COLLECTION = "lotteryTickets"; private static final String DEFAULT_COUNTERS_COLLECTION = "counters"; private MongoClient mongoClient; private MongoDatabase database; private MongoCollection ticketsCollection; private MongoCollection countersCollection; /** * Constructor */ public MongoTicketRepository() { connect(); } /** * Constructor accepting parameters */ public MongoTicketRepository(String dbName, String ticketsCollectionName, String countersCollectionName) { connect(dbName, ticketsCollectionName, countersCollectionName); } /** * Connect to database with default parameters */ public void connect() { connect(DEFAULT_DB, DEFAULT_TICKETS_COLLECTION, DEFAULT_COUNTERS_COLLECTION); } /** * Connect to database with given parameters */ public void connect(String dbName, String ticketsCollectionName, String countersCollectionName) { if (mongoClient != null) { mongoClient.close(); } mongoClient = new MongoClient(System.getProperty("mongo-host"), Integer.parseInt(System.getProperty("mongo-port"))); database = mongoClient.getDatabase(dbName); ticketsCollection = database.getCollection(ticketsCollectionName); countersCollection = database.getCollection(countersCollectionName); if (countersCollection.count() <= 0) { initCounters(); } } private void initCounters() { Document doc = new Document("_id", "ticketId").append("seq", 1); countersCollection.insertOne(doc); } /** * @return next ticket id */ public int getNextId() { Document find = new Document("_id", "ticketId"); Document increase = new Document("seq", 1); Document update = new Document("$inc", increase); Document result = countersCollection.findOneAndUpdate(find, update); return result.getInteger("seq"); } /** * @return mongo client */ public MongoClient getMongoClient() { return mongoClient; } /** * * @return mongo database */ public MongoDatabase getMongoDatabase() { return database; } /** * * @return tickets collection */ public MongoCollection getTicketsCollection() { return ticketsCollection; } /** * * @return counters collection */ public MongoCollection getCountersCollection() { return countersCollection; } @Override public Optional findById(LotteryTicketId id) { Document find = new Document("ticketId", id.getId()); List results = ticketsCollection.find(find).limit(1).into(new ArrayList()); if (results.size() > 0) { LotteryTicket lotteryTicket = docToTicket(results.get(0)); return Optional.of(lotteryTicket); } else { return Optional.empty(); } } @Override public Optional save(LotteryTicket ticket) { int ticketId = getNextId(); Document doc = new Document("ticketId", ticketId); doc.put("email", ticket.getPlayerDetails().getEmail()); doc.put("bank", ticket.getPlayerDetails().getBankAccount()); doc.put("phone", ticket.getPlayerDetails().getPhoneNumber()); doc.put("numbers", ticket.getNumbers().getNumbersAsString()); ticketsCollection.insertOne(doc); return Optional.of(new LotteryTicketId(ticketId)); } @Override public Map findAll() { Map map = new HashMap<>(); List docs = ticketsCollection.find(new Document()).into(new ArrayList()); for (Document doc: docs) { LotteryTicket lotteryTicket = docToTicket(doc); map.put(lotteryTicket.getId(), lotteryTicket); } return map; } @Override public void deleteAll() { ticketsCollection.deleteMany(new Document()); } private LotteryTicket docToTicket(Document doc) { PlayerDetails playerDetails = new PlayerDetails(doc.getString("email"), doc.getString("bank"), doc.getString("phone")); int[] numArray = Arrays.asList(doc.getString("numbers").split(",")).stream().mapToInt(Integer::parseInt).toArray(); Set numbers = new HashSet<>(); for (int num: numArray) { numbers.add(num); } LotteryNumbers lotteryNumbers = LotteryNumbers.create(numbers); return new LotteryTicket(new LotteryTicketId(doc.getInteger("ticketId")), playerDetails, lotteryNumbers); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/000077500000000000000000000000001312550536300300555ustar00rootroot00000000000000LotteryAdministration.java000066400000000000000000000064501312550536300352160ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import com.google.inject.Inject; import com.iluwatar.hexagonal.banking.WireTransfers; import com.iluwatar.hexagonal.database.LotteryTicketRepository; import com.iluwatar.hexagonal.eventlog.LotteryEventLog; import java.util.Map; /** * * Lottery administration implementation * */ public class LotteryAdministration { private final LotteryTicketRepository repository; private final LotteryEventLog notifications; private final WireTransfers wireTransfers; /** * Constructor */ @Inject public LotteryAdministration(LotteryTicketRepository repository, LotteryEventLog notifications, WireTransfers wireTransfers) { this.repository = repository; this.notifications = notifications; this.wireTransfers = wireTransfers; } /** * Get all the lottery tickets submitted for lottery */ public Map getAllSubmittedTickets() { return repository.findAll(); } /** * Draw lottery numbers */ public LotteryNumbers performLottery() { LotteryNumbers numbers = LotteryNumbers.createRandom(); Map tickets = getAllSubmittedTickets(); for (LotteryTicketId id : tickets.keySet()) { LotteryTicketCheckResult result = LotteryUtils.checkTicketForPrize(repository, id, numbers); if (result.getResult().equals(LotteryTicketCheckResult.CheckResult.WIN_PRIZE)) { boolean transferred = wireTransfers.transferFunds(LotteryConstants.PRIZE_AMOUNT, LotteryConstants.SERVICE_BANK_ACCOUNT, tickets.get(id).getPlayerDetails().getBankAccount()); if (transferred) { notifications.ticketWon(tickets.get(id).getPlayerDetails(), LotteryConstants.PRIZE_AMOUNT); } else { notifications.prizeError(tickets.get(id).getPlayerDetails(), LotteryConstants.PRIZE_AMOUNT); } } else if (result.getResult().equals(LotteryTicketCheckResult.CheckResult.NO_PRIZE)) { notifications.ticketDidNotWin(tickets.get(id).getPlayerDetails()); } } return numbers; } /** * Begin new lottery round */ public void resetLottery() { repository.deleteAll(); } } LotteryConstants.java000066400000000000000000000030431312550536300342000ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; /** * * Lottery domain constants * */ public class LotteryConstants { private LotteryConstants() { } public static final int PRIZE_AMOUNT = 100000; public static final String SERVICE_BANK_ACCOUNT = "123-123"; public static final int TICKET_PRIZE = 3; public static final int SERVICE_BANK_ACCOUNT_SALDO = 150000; public static final int PLAYER_MAX_SALDO = 100; } LotteryNumbers.java000066400000000000000000000111311312550536300336340ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import java.util.ArrayList; import java.util.Collections; import java.util.HashSet; import java.util.List; import java.util.PrimitiveIterator; import java.util.Random; import java.util.Set; /** * * Value object representing lottery numbers. This lottery uses sets of 4 numbers. The numbers must be unique and * between 1 and 20. * */ public class LotteryNumbers { private final Set numbers; public static final int MIN_NUMBER = 1; public static final int MAX_NUMBER = 20; public static final int NUM_NUMBERS = 4; /** * Constructor. Creates random lottery numbers. */ private LotteryNumbers() { numbers = new HashSet<>(); generateRandomNumbers(); } /** * Constructor. Uses given numbers. */ private LotteryNumbers(Set givenNumbers) { numbers = new HashSet<>(); numbers.addAll(givenNumbers); } /** * @return random LotteryNumbers */ public static LotteryNumbers createRandom() { return new LotteryNumbers(); } /** * @return given LotteryNumbers */ public static LotteryNumbers create(Set givenNumbers) { return new LotteryNumbers(givenNumbers); } /** * @return lottery numbers */ public Set getNumbers() { return Collections.unmodifiableSet(numbers); } /** * @return numbers as comma separated string */ public String getNumbersAsString() { List list = new ArrayList<>(); list.addAll(numbers); StringBuilder builder = new StringBuilder(); for (int i = 0; i < NUM_NUMBERS; i++) { builder.append(list.get(i)); if (i < NUM_NUMBERS - 1) { builder.append(","); } } return builder.toString(); } /** * Generates 4 unique random numbers between 1-20 into numbers set. */ private void generateRandomNumbers() { numbers.clear(); RandomNumberGenerator generator = new RandomNumberGenerator(MIN_NUMBER, MAX_NUMBER); while (numbers.size() < NUM_NUMBERS) { int num = generator.nextInt(); if (!numbers.contains(num)) { numbers.add(num); } } } @Override public String toString() { return "LotteryNumbers{" + "numbers=" + numbers + '}'; } /** * * Helper class for generating random numbers. * */ private static class RandomNumberGenerator { private PrimitiveIterator.OfInt randomIterator; /** * Initialize a new random number generator that generates random numbers in the range [min, max] * * @param min the min value (inclusive) * @param max the max value (inclusive) */ public RandomNumberGenerator(int min, int max) { randomIterator = new Random().ints(min, max + 1).iterator(); } /** * @return a random number in the range (min, max) */ public int nextInt() { return randomIterator.nextInt(); } } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + ((numbers == null) ? 0 : numbers.hashCode()); return result; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } LotteryNumbers other = (LotteryNumbers) obj; if (numbers == null) { if (other.numbers != null) { return false; } } else if (!numbers.equals(other.numbers)) { return false; } return true; } } LotteryService.java000066400000000000000000000054051312550536300336300ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import com.google.inject.Inject; import com.iluwatar.hexagonal.banking.WireTransfers; import com.iluwatar.hexagonal.database.LotteryTicketRepository; import com.iluwatar.hexagonal.eventlog.LotteryEventLog; import java.util.Optional; /** * * Implementation for lottery service * */ public class LotteryService { private final LotteryTicketRepository repository; private final LotteryEventLog notifications; private final WireTransfers wireTransfers; /** * Constructor */ @Inject public LotteryService(LotteryTicketRepository repository, LotteryEventLog notifications, WireTransfers wireTransfers) { this.repository = repository; this.notifications = notifications; this.wireTransfers = wireTransfers; } /** * Submit lottery ticket to participate in the lottery */ public Optional submitTicket(LotteryTicket ticket) { boolean result = wireTransfers.transferFunds(LotteryConstants.TICKET_PRIZE, ticket.getPlayerDetails().getBankAccount(), LotteryConstants.SERVICE_BANK_ACCOUNT); if (!result) { notifications.ticketSubmitError(ticket.getPlayerDetails()); return Optional.empty(); } Optional optional = repository.save(ticket); if (optional.isPresent()) { notifications.ticketSubmitted(ticket.getPlayerDetails()); } return optional; } /** * Check if lottery ticket has won */ public LotteryTicketCheckResult checkTicketForPrize(LotteryTicketId id, LotteryNumbers winningNumbers) { return LotteryUtils.checkTicketForPrize(repository, id, winningNumbers); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java000066400000000000000000000060151312550536300335300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; /** * * Immutable value object representing lottery ticket. * */ public class LotteryTicket { private LotteryTicketId id; private final PlayerDetails playerDetails; private final LotteryNumbers lotteryNumbers; /** * Constructor. */ public LotteryTicket(LotteryTicketId id, PlayerDetails details, LotteryNumbers numbers) { this.id = id; playerDetails = details; lotteryNumbers = numbers; } /** * @return player details */ public PlayerDetails getPlayerDetails() { return playerDetails; } /** * @return lottery numbers */ public LotteryNumbers getNumbers() { return lotteryNumbers; } /** * @return id */ public LotteryTicketId getId() { return id; } /** * set id */ public void setId(LotteryTicketId id) { this.id = id; } @Override public String toString() { return playerDetails.toString() + " " + lotteryNumbers.toString(); } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + ((lotteryNumbers == null) ? 0 : lotteryNumbers.hashCode()); result = prime * result + ((playerDetails == null) ? 0 : playerDetails.hashCode()); return result; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } LotteryTicket other = (LotteryTicket) obj; if (lotteryNumbers == null) { if (other.lotteryNumbers != null) { return false; } } else if (!lotteryNumbers.equals(other.lotteryNumbers)) { return false; } if (playerDetails == null) { if (other.playerDetails != null) { return false; } } else if (!playerDetails.equals(other.playerDetails)) { return false; } return true; } } LotteryTicketCheckResult.java000066400000000000000000000050371312550536300356110ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; /** * * Represents lottery ticket check result. * */ public class LotteryTicketCheckResult { /** * Enumeration of Type of Outcomes of a Lottery */ public enum CheckResult { WIN_PRIZE, NO_PRIZE, TICKET_NOT_SUBMITTED } private final CheckResult checkResult; private final int prizeAmount; /** * Constructor. */ public LotteryTicketCheckResult(CheckResult result) { checkResult = result; prizeAmount = 0; } /** * Constructor. */ public LotteryTicketCheckResult(CheckResult result, int amount) { checkResult = result; prizeAmount = amount; } /** * @return check result */ public CheckResult getResult() { return checkResult; } /** * @return prize amount */ public int getPrizeAmount() { return prizeAmount; } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + ((checkResult == null) ? 0 : checkResult.hashCode()); result = prime * result + prizeAmount; return result; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } LotteryTicketCheckResult other = (LotteryTicketCheckResult) obj; return checkResult == other.checkResult && prizeAmount == other.prizeAmount; } } LotteryTicketId.java000066400000000000000000000035541312550536300337330ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; /** * Lottery ticked id */ public class LotteryTicketId { private static volatile int numAllocated; private final int id; public LotteryTicketId() { this.id = numAllocated + 1; numAllocated++; } public LotteryTicketId(int id) { this.id = id; } public int getId() { return id; } @Override public String toString() { return String.format("%d", id); } @Override public boolean equals(Object o) { if (this == o) { return true; } if (o == null || getClass() != o.getClass()) { return false; } LotteryTicketId that = (LotteryTicketId) o; return id == that.id; } @Override public int hashCode() { return id; } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java000066400000000000000000000041131312550536300334020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import com.iluwatar.hexagonal.database.LotteryTicketRepository; import java.util.Optional; /** * Lottery utilities */ public class LotteryUtils { private LotteryUtils() { } /** * Checks if lottery ticket has won */ public static LotteryTicketCheckResult checkTicketForPrize(LotteryTicketRepository repository, LotteryTicketId id, LotteryNumbers winningNumbers) { Optional optional = repository.findById(id); if (optional.isPresent()) { if (optional.get().getNumbers().equals(winningNumbers)) { return new LotteryTicketCheckResult(LotteryTicketCheckResult.CheckResult.WIN_PRIZE, 1000); } else { return new LotteryTicketCheckResult(LotteryTicketCheckResult.CheckResult.NO_PRIZE); } } else { return new LotteryTicketCheckResult(LotteryTicketCheckResult.CheckResult.TICKET_NOT_SUBMITTED); } } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java000066400000000000000000000064641312550536300334740ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; /** * * Immutable value object containing lottery player details. * */ public class PlayerDetails { private final String emailAddress; private final String bankAccountNumber; private final String phoneNumber; /** * Constructor. */ public PlayerDetails(String email, String bankAccount, String phone) { emailAddress = email; bankAccountNumber = bankAccount; phoneNumber = phone; } /** * @return email */ public String getEmail() { return emailAddress; } /** * @return bank account number */ public String getBankAccount() { return bankAccountNumber; } /** * @return phone number */ public String getPhoneNumber() { return phoneNumber; } @Override public String toString() { return "PlayerDetails{" + "emailAddress='" + emailAddress + '\'' + ", bankAccountNumber='" + bankAccountNumber + '\'' + ", phoneNumber='" + phoneNumber + '\'' + '}'; } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + ((bankAccountNumber == null) ? 0 : bankAccountNumber.hashCode()); result = prime * result + ((emailAddress == null) ? 0 : emailAddress.hashCode()); result = prime * result + ((phoneNumber == null) ? 0 : phoneNumber.hashCode()); return result; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } PlayerDetails other = (PlayerDetails) obj; if (bankAccountNumber == null) { if (other.bankAccountNumber != null) { return false; } } else if (!bankAccountNumber.equals(other.bankAccountNumber)) { return false; } if (emailAddress == null) { if (other.emailAddress != null) { return false; } } else if (!emailAddress.equals(other.emailAddress)) { return false; } if (phoneNumber == null) { if (other.phoneNumber != null) { return false; } } else if (!phoneNumber.equals(other.phoneNumber)) { return false; } return true; } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/000077500000000000000000000000001312550536300304315ustar00rootroot00000000000000LotteryEventLog.java000066400000000000000000000034111312550536300343220ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.eventlog; import com.iluwatar.hexagonal.domain.PlayerDetails; /** * * Event log for lottery events * */ public interface LotteryEventLog { /** * lottery ticket submitted */ void ticketSubmitted(PlayerDetails details); /** * error submitting lottery ticket */ void ticketSubmitError(PlayerDetails details); /** * lottery ticket did not win */ void ticketDidNotWin(PlayerDetails details); /** * lottery ticket won */ void ticketWon(PlayerDetails details, int prizeAmount); /** * error paying the prize */ void prizeError(PlayerDetails details, int prizeAmount); } MongoEventLog.java000066400000000000000000000122061312550536300337410ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.eventlog; import com.iluwatar.hexagonal.domain.PlayerDetails; import com.mongodb.MongoClient; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import org.bson.Document; /** * Mongo based event log */ public class MongoEventLog implements LotteryEventLog { private static final String DEFAULT_DB = "lotteryDB"; private static final String DEFAULT_EVENTS_COLLECTION = "events"; private MongoClient mongoClient; private MongoDatabase database; private MongoCollection eventsCollection; private StdOutEventLog stdOutEventLog = new StdOutEventLog(); /** * Constructor */ public MongoEventLog() { connect(); } /** * Constructor accepting parameters */ public MongoEventLog(String dbName, String eventsCollectionName) { connect(dbName, eventsCollectionName); } /** * Connect to database with default parameters */ public void connect() { connect(DEFAULT_DB, DEFAULT_EVENTS_COLLECTION); } /** * Connect to database with given parameters */ public void connect(String dbName, String eventsCollectionName) { if (mongoClient != null) { mongoClient.close(); } mongoClient = new MongoClient(System.getProperty("mongo-host"), Integer.parseInt(System.getProperty("mongo-port"))); database = mongoClient.getDatabase(dbName); eventsCollection = database.getCollection(eventsCollectionName); } /** * @return mongo client */ public MongoClient getMongoClient() { return mongoClient; } /** * * @return mongo database */ public MongoDatabase getMongoDatabase() { return database; } /** * * @return accounts collection */ public MongoCollection getEventsCollection() { return eventsCollection; } @Override public void ticketSubmitted(PlayerDetails details) { Document document = new Document("email", details.getEmail()); document.put("phone", details.getPhoneNumber()); document.put("bank", details.getBankAccount()); document.put("message", "Lottery ticket was submitted and bank account was charged for 3 credits."); eventsCollection.insertOne(document); stdOutEventLog.ticketSubmitted(details); } @Override public void ticketSubmitError(PlayerDetails details) { Document document = new Document("email", details.getEmail()); document.put("phone", details.getPhoneNumber()); document.put("bank", details.getBankAccount()); document.put("message", "Lottery ticket could not be submitted because lack of funds."); eventsCollection.insertOne(document); stdOutEventLog.ticketSubmitError(details); } @Override public void ticketDidNotWin(PlayerDetails details) { Document document = new Document("email", details.getEmail()); document.put("phone", details.getPhoneNumber()); document.put("bank", details.getBankAccount()); document.put("message", "Lottery ticket was checked and unfortunately did not win this time."); eventsCollection.insertOne(document); stdOutEventLog.ticketDidNotWin(details); } @Override public void ticketWon(PlayerDetails details, int prizeAmount) { Document document = new Document("email", details.getEmail()); document.put("phone", details.getPhoneNumber()); document.put("bank", details.getBankAccount()); document.put("message", String.format("Lottery ticket won! The bank account was deposited with %d credits.", prizeAmount)); eventsCollection.insertOne(document); stdOutEventLog.ticketWon(details, prizeAmount); } @Override public void prizeError(PlayerDetails details, int prizeAmount) { Document document = new Document("email", details.getEmail()); document.put("phone", details.getPhoneNumber()); document.put("bank", details.getBankAccount()); document.put("message", String.format("Lottery ticket won! Unfortunately the bank credit transfer of %d failed.", prizeAmount)); eventsCollection.insertOne(document); stdOutEventLog.prizeError(details, prizeAmount); } } StdOutEventLog.java000066400000000000000000000050541312550536300341070ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.eventlog; import com.iluwatar.hexagonal.domain.PlayerDetails; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Standard output event log */ public class StdOutEventLog implements LotteryEventLog { private static final Logger LOGGER = LoggerFactory.getLogger(StdOutEventLog.class); @Override public void ticketSubmitted(PlayerDetails details) { LOGGER.info("Lottery ticket for {} was submitted. Bank account {} was charged for 3 credits.", details.getEmail(), details.getBankAccount()); } @Override public void ticketDidNotWin(PlayerDetails details) { LOGGER.info("Lottery ticket for {} was checked and unfortunately did not win this time.", details.getEmail()); } @Override public void ticketWon(PlayerDetails details, int prizeAmount) { LOGGER.info("Lottery ticket for {} has won! The bank account {} was deposited with {} credits.", details.getEmail(), details.getBankAccount(), prizeAmount); } @Override public void prizeError(PlayerDetails details, int prizeAmount) { LOGGER.error("Lottery ticket for {} has won! Unfortunately the bank credit transfer of {} failed.", details.getEmail(), prizeAmount); } @Override public void ticketSubmitError(PlayerDetails details) { LOGGER.error("Lottery ticket for {} could not be submitted because the credit transfer of 3 credits failed.", details.getEmail()); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/module/000077500000000000000000000000001312550536300300735ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryModule.java000066400000000000000000000035631312550536300335550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.module; import com.google.inject.AbstractModule; import com.iluwatar.hexagonal.banking.MongoBank; import com.iluwatar.hexagonal.banking.WireTransfers; import com.iluwatar.hexagonal.database.LotteryTicketRepository; import com.iluwatar.hexagonal.database.MongoTicketRepository; import com.iluwatar.hexagonal.eventlog.LotteryEventLog; import com.iluwatar.hexagonal.eventlog.MongoEventLog; /** * Guice module for binding production dependencies */ public class LotteryModule extends AbstractModule { @Override protected void configure() { bind(LotteryTicketRepository.class).to(MongoTicketRepository.class); bind(LotteryEventLog.class).to(MongoEventLog.class); bind(WireTransfers.class).to(MongoBank.class); } } LotteryTestingModule.java000066400000000000000000000035751312550536300350370ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/module/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.module; import com.google.inject.AbstractModule; import com.iluwatar.hexagonal.banking.InMemoryBank; import com.iluwatar.hexagonal.banking.WireTransfers; import com.iluwatar.hexagonal.database.InMemoryTicketRepository; import com.iluwatar.hexagonal.database.LotteryTicketRepository; import com.iluwatar.hexagonal.eventlog.LotteryEventLog; import com.iluwatar.hexagonal.eventlog.StdOutEventLog; /** * Guice module for testing dependencies */ public class LotteryTestingModule extends AbstractModule { @Override protected void configure() { bind(LotteryTicketRepository.class).to(InMemoryTicketRepository.class); bind(LotteryEventLog.class).to(StdOutEventLog.class); bind(WireTransfers.class).to(InMemoryBank.class); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/mongo/000077500000000000000000000000001312550536300277255ustar00rootroot00000000000000MongoConnectionPropertiesLoader.java000066400000000000000000000043011312550536300370120ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/mongo/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.mongo; import java.io.FileInputStream; import java.util.Properties; /** * Mongo connection properties loader */ public class MongoConnectionPropertiesLoader { private static final String DEFAULT_HOST = "localhost"; private static final int DEFAULT_PORT = 27017; /** * Try to load connection properties from file. * Fall back to default connection properties. */ public static void load() { String host = DEFAULT_HOST; int port = DEFAULT_PORT; String path = System.getProperty("hexagonal.properties.path"); Properties properties = new Properties(); if (path != null) { try (FileInputStream fin = new FileInputStream(path)) { properties.load(fin); host = properties.getProperty("mongo-host"); port = Integer.parseInt(properties.getProperty("mongo-port")); } catch (Exception e) { // error occurred, use default properties e.printStackTrace(); } } System.setProperty("mongo-host", host); System.setProperty("mongo-port", String.format("%d", port)); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/000077500000000000000000000000001312550536300307215ustar00rootroot00000000000000SampleData.java000066400000000000000000000132411312550536300335210ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.sampledata; import com.iluwatar.hexagonal.banking.InMemoryBank; import com.iluwatar.hexagonal.domain.LotteryConstants; import com.iluwatar.hexagonal.domain.LotteryNumbers; import com.iluwatar.hexagonal.domain.LotteryService; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; import com.iluwatar.hexagonal.domain.PlayerDetails; import java.util.ArrayList; import java.util.List; import java.util.Random; /** * Utilities for creating sample lottery tickets */ public class SampleData { private static final List PLAYERS; static { PLAYERS = new ArrayList<>(); PLAYERS.add(new PlayerDetails("john@google.com", "312-342", "+3242434242")); PLAYERS.add(new PlayerDetails("mary@google.com", "234-987", "+23452346")); PLAYERS.add(new PlayerDetails("steve@google.com", "833-836", "+63457543")); PLAYERS.add(new PlayerDetails("wayne@google.com", "319-826", "+24626")); PLAYERS.add(new PlayerDetails("johnie@google.com", "983-322", "+3635635")); PLAYERS.add(new PlayerDetails("andy@google.com", "934-734", "+0898245")); PLAYERS.add(new PlayerDetails("richard@google.com", "536-738", "+09845325")); PLAYERS.add(new PlayerDetails("kevin@google.com", "453-936", "+2423532")); PLAYERS.add(new PlayerDetails("arnold@google.com", "114-988", "+5646346524")); PLAYERS.add(new PlayerDetails("ian@google.com", "663-765", "+928394235")); PLAYERS.add(new PlayerDetails("robin@google.com", "334-763", "+35448")); PLAYERS.add(new PlayerDetails("ted@google.com", "735-964", "+98752345")); PLAYERS.add(new PlayerDetails("larry@google.com", "734-853", "+043842423")); PLAYERS.add(new PlayerDetails("calvin@google.com", "334-746", "+73294135")); PLAYERS.add(new PlayerDetails("jacob@google.com", "444-766", "+358042354")); PLAYERS.add(new PlayerDetails("edwin@google.com", "895-345", "+9752435")); PLAYERS.add(new PlayerDetails("mary@google.com", "760-009", "+34203542")); PLAYERS.add(new PlayerDetails("lolita@google.com", "425-907", "+9872342")); PLAYERS.add(new PlayerDetails("bruno@google.com", "023-638", "+673824122")); PLAYERS.add(new PlayerDetails("peter@google.com", "335-886", "+5432503945")); PLAYERS.add(new PlayerDetails("warren@google.com", "225-946", "+9872341324")); PLAYERS.add(new PlayerDetails("monica@google.com", "265-748", "+134124")); PLAYERS.add(new PlayerDetails("ollie@google.com", "190-045", "+34453452")); PLAYERS.add(new PlayerDetails("yngwie@google.com", "241-465", "+9897641231")); PLAYERS.add(new PlayerDetails("lars@google.com", "746-936", "+42345298345")); PLAYERS.add(new PlayerDetails("bobbie@google.com", "946-384", "+79831742")); PLAYERS.add(new PlayerDetails("tyron@google.com", "310-992", "+0498837412")); PLAYERS.add(new PlayerDetails("tyrell@google.com", "032-045", "+67834134")); PLAYERS.add(new PlayerDetails("nadja@google.com", "000-346", "+498723")); PLAYERS.add(new PlayerDetails("wendy@google.com", "994-989", "+987324454")); PLAYERS.add(new PlayerDetails("luke@google.com", "546-634", "+987642435")); PLAYERS.add(new PlayerDetails("bjorn@google.com", "342-874", "+7834325")); PLAYERS.add(new PlayerDetails("lisa@google.com", "024-653", "+980742154")); PLAYERS.add(new PlayerDetails("anton@google.com", "834-935", "+876423145")); PLAYERS.add(new PlayerDetails("bruce@google.com", "284-936", "+09843212345")); PLAYERS.add(new PlayerDetails("ray@google.com", "843-073", "+678324123")); PLAYERS.add(new PlayerDetails("ron@google.com", "637-738", "+09842354")); PLAYERS.add(new PlayerDetails("xavier@google.com", "143-947", "+375245")); PLAYERS.add(new PlayerDetails("harriet@google.com", "842-404", "+131243252")); InMemoryBank wireTransfers = new InMemoryBank(); Random random = new Random(); for (int i = 0; i < PLAYERS.size(); i++) { wireTransfers.setFunds(PLAYERS.get(i).getBankAccount(), random.nextInt(LotteryConstants.PLAYER_MAX_SALDO)); } } /** * Inserts lottery tickets into the database based on the sample data */ public static void submitTickets(LotteryService lotteryService, int numTickets) { for (int i = 0; i < numTickets; i++) { LotteryTicket ticket = new LotteryTicket(new LotteryTicketId(), getRandomPlayerDetails(), LotteryNumbers.createRandom()); lotteryService.submitTicket(ticket); } } private static PlayerDetails getRandomPlayerDetails() { Random random = new Random(); int idx = random.nextInt(PLAYERS.size()); return PLAYERS.get(idx); } } java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/service/000077500000000000000000000000001312550536300302465ustar00rootroot00000000000000ConsoleLottery.java000066400000000000000000000147621312550536300340310ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/main/java/com/iluwatar/hexagonal/service/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.service; import com.google.inject.Guice; import com.google.inject.Injector; import com.iluwatar.hexagonal.banking.WireTransfers; import com.iluwatar.hexagonal.domain.LotteryNumbers; import com.iluwatar.hexagonal.domain.LotteryService; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketCheckResult; import com.iluwatar.hexagonal.domain.LotteryTicketId; import com.iluwatar.hexagonal.domain.PlayerDetails; import com.iluwatar.hexagonal.module.LotteryModule; import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.HashSet; import java.util.Optional; import java.util.Scanner; import java.util.Set; /** * Console interface for lottery players */ public class ConsoleLottery { private static final Logger LOGGER = LoggerFactory.getLogger(ConsoleLottery.class); /** * Program entry point */ public static void main(String[] args) { MongoConnectionPropertiesLoader.load(); Injector injector = Guice.createInjector(new LotteryModule()); LotteryService service = injector.getInstance(LotteryService.class); WireTransfers bank = injector.getInstance(WireTransfers.class); try (final Scanner scanner = new Scanner(System.in)) { boolean exit = false; while (!exit) { printMainMenu(); String cmd = readString(scanner); if ("1".equals(cmd)) { queryLotteryAccountFunds(bank, scanner); } else if ("2".equals(cmd)) { addFundsToLotteryAccount(bank, scanner); } else if ("3".equals(cmd)) { submitTicket(service, scanner); } else if ("4".equals(cmd)) { checkTicket(service, scanner); } else if ("5".equals(cmd)) { exit = true; } else { LOGGER.info("Unknown command"); } } } } private static void checkTicket(LotteryService service, Scanner scanner) { LOGGER.info("What is the ID of the lottery ticket?"); String id = readString(scanner); LOGGER.info("Give the 4 comma separated winning numbers?"); String numbers = readString(scanner); try { String[] parts = numbers.split(","); Set winningNumbers = new HashSet<>(); for (int i = 0; i < 4; i++) { winningNumbers.add(Integer.parseInt(parts[i])); } LotteryTicketCheckResult result = service.checkTicketForPrize( new LotteryTicketId(Integer.parseInt(id)), LotteryNumbers.create(winningNumbers)); if (result.getResult().equals(LotteryTicketCheckResult.CheckResult.WIN_PRIZE)) { LOGGER.info("Congratulations! The lottery ticket has won!"); } else if (result.getResult().equals(LotteryTicketCheckResult.CheckResult.NO_PRIZE)) { LOGGER.info("Unfortunately the lottery ticket did not win."); } else { LOGGER.info("Such lottery ticket has not been submitted."); } } catch (Exception e) { LOGGER.info("Failed checking the lottery ticket - please try again."); } } private static void submitTicket(LotteryService service, Scanner scanner) { LOGGER.info("What is your email address?"); String email = readString(scanner); LOGGER.info("What is your bank account number?"); String account = readString(scanner); LOGGER.info("What is your phone number?"); String phone = readString(scanner); PlayerDetails details = new PlayerDetails(email, account, phone); LOGGER.info("Give 4 comma separated lottery numbers?"); String numbers = readString(scanner); try { String[] parts = numbers.split(","); Set chosen = new HashSet<>(); for (int i = 0; i < 4; i++) { chosen.add(Integer.parseInt(parts[i])); } LotteryNumbers lotteryNumbers = LotteryNumbers.create(chosen); LotteryTicket lotteryTicket = new LotteryTicket(new LotteryTicketId(), details, lotteryNumbers); Optional id = service.submitTicket(lotteryTicket); if (id.isPresent()) { LOGGER.info("Submitted lottery ticket with id: {}", id.get()); } else { LOGGER.info("Failed submitting lottery ticket - please try again."); } } catch (Exception e) { LOGGER.info("Failed submitting lottery ticket - please try again."); } } private static void addFundsToLotteryAccount(WireTransfers bank, Scanner scanner) { LOGGER.info("What is the account number?"); String account = readString(scanner); LOGGER.info("How many credits do you want to deposit?"); String amount = readString(scanner); bank.setFunds(account, Integer.parseInt(amount)); LOGGER.info("The account {} now has {} credits.", account, bank.getFunds(account)); } private static void queryLotteryAccountFunds(WireTransfers bank, Scanner scanner) { LOGGER.info("What is the account number?"); String account = readString(scanner); LOGGER.info("The account {} has {} credits.", account, bank.getFunds(account)); } private static void printMainMenu() { LOGGER.info(""); LOGGER.info("### Lottery Service Console ###"); LOGGER.info("(1) Query lottery account funds"); LOGGER.info("(2) Add funds to lottery account"); LOGGER.info("(3) Submit ticket"); LOGGER.info("(4) Check ticket"); LOGGER.info("(5) Exit"); } private static String readString(Scanner scanner) { System.out.print("> "); return scanner.next(); } } java-design-patterns-1.16.0/hexagonal/src/test/000077500000000000000000000000001312550536300213445ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/000077500000000000000000000000001312550536300222655ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/000077500000000000000000000000001312550536300230435ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300246735ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/000077500000000000000000000000001312550536300266415ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java000066400000000000000000000025031312550536300310640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal; import org.junit.Test; /** * Unit test for simple App. */ public class AppTest { @Test public void testApp() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/000077500000000000000000000000001312550536300302525ustar00rootroot00000000000000InMemoryBankTest.java000066400000000000000000000034201312550536300342300ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.banking; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import org.junit.Test; /** * * Tests for banking * */ public class InMemoryBankTest { private final WireTransfers bank = new InMemoryBank(); @Test public void testInit() { assertEquals(bank.getFunds("foo"), 0); bank.setFunds("foo", 100); assertEquals(bank.getFunds("foo"), 100); bank.setFunds("bar", 150); assertEquals(bank.getFunds("bar"), 150); assertTrue(bank.transferFunds(50, "bar", "foo")); assertEquals(bank.getFunds("foo"), 150); assertEquals(bank.getFunds("bar"), 100); } } MongoBankTest.java000066400000000000000000000047211312550536300335550ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.banking; import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader; import com.mongodb.MongoClient; import org.junit.Before; import org.junit.Ignore; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Tests for Mongo banking adapter */ @Ignore public class MongoBankTest { private static final String TEST_DB = "lotteryDBTest"; private static final String TEST_ACCOUNTS_COLLECTION = "testAccounts"; private MongoBank mongoBank; @Before public void init() { MongoConnectionPropertiesLoader.load(); MongoClient mongoClient = new MongoClient(System.getProperty("mongo-host"), Integer.parseInt(System.getProperty("mongo-port"))); mongoClient.dropDatabase(TEST_DB); mongoClient.close(); mongoBank = new MongoBank(TEST_DB, TEST_ACCOUNTS_COLLECTION); } @Test public void testSetup() { assertEquals(0, mongoBank.getAccountsCollection().count()); } @Test public void testFundTransfers() { assertEquals(0, mongoBank.getFunds("000-000")); mongoBank.setFunds("000-000", 10); assertEquals(10, mongoBank.getFunds("000-000")); assertEquals(0, mongoBank.getFunds("111-111")); mongoBank.transferFunds(9, "000-000", "111-111"); assertEquals(1, mongoBank.getFunds("000-000")); assertEquals(9, mongoBank.getFunds("111-111")); } } java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/database/000077500000000000000000000000001312550536300304055ustar00rootroot00000000000000InMemoryTicketRepositoryTest.java000066400000000000000000000043461312550536300370430ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/database/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.database; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import java.util.Optional; import org.junit.Before; import org.junit.Test; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; import com.iluwatar.hexagonal.test.LotteryTestUtils; /** * * Tests for {@link LotteryTicketRepository} * */ public class InMemoryTicketRepositoryTest { private final LotteryTicketRepository repository = new InMemoryTicketRepository(); @Before public void clear() { repository.deleteAll(); } @Test public void testCrudOperations() { LotteryTicketRepository repository = new InMemoryTicketRepository(); assertEquals(repository.findAll().size(), 0); LotteryTicket ticket = LotteryTestUtils.createLotteryTicket(); Optional id = repository.save(ticket); assertTrue(id.isPresent()); assertEquals(repository.findAll().size(), 1); Optional optionalTicket = repository.findById(id.get()); assertTrue(optionalTicket.isPresent()); } } MongoTicketRepositoryTest.java000066400000000000000000000074771312550536300363730ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/database/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.database; import com.iluwatar.hexagonal.domain.LotteryNumbers; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; import com.iluwatar.hexagonal.domain.PlayerDetails; import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader; import com.mongodb.MongoClient; import org.junit.Before; import org.junit.Ignore; import org.junit.Test; import java.util.Optional; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; /** * Tests for Mongo based ticket repository */ @Ignore public class MongoTicketRepositoryTest { private static final String TEST_DB = "lotteryTestDB"; private static final String TEST_TICKETS_COLLECTION = "lotteryTestTickets"; private static final String TEST_COUNTERS_COLLECTION = "testCounters"; private MongoTicketRepository repository; @Before public void init() { MongoConnectionPropertiesLoader.load(); MongoClient mongoClient = new MongoClient(System.getProperty("mongo-host"), Integer.parseInt(System.getProperty("mongo-port"))); mongoClient.dropDatabase(TEST_DB); mongoClient.close(); repository = new MongoTicketRepository(TEST_DB, TEST_TICKETS_COLLECTION, TEST_COUNTERS_COLLECTION); } @Test public void testSetup() { assertTrue(repository.getCountersCollection().count() == 1); assertTrue(repository.getTicketsCollection().count() == 0); } @Test public void testNextId() { assertEquals(1, repository.getNextId()); assertEquals(2, repository.getNextId()); assertEquals(3, repository.getNextId()); } @Test public void testCrudOperations() { // create new lottery ticket and save it PlayerDetails details = new PlayerDetails("foo@bar.com", "123-123", "07001234"); LotteryNumbers random = LotteryNumbers.createRandom(); LotteryTicket original = new LotteryTicket(new LotteryTicketId(), details, random); Optional saved = repository.save(original); assertEquals(1, repository.getTicketsCollection().count()); assertTrue(saved.isPresent()); // fetch the saved lottery ticket from database and check its contents Optional found = repository.findById(saved.get()); assertTrue(found.isPresent()); LotteryTicket ticket = found.get(); assertEquals("foo@bar.com", ticket.getPlayerDetails().getEmail()); assertEquals("123-123", ticket.getPlayerDetails().getBankAccount()); assertEquals("07001234", ticket.getPlayerDetails().getPhoneNumber()); assertEquals(original.getNumbers(), ticket.getNumbers()); // clear the collection repository.deleteAll(); assertEquals(0, repository.getTicketsCollection().count()); } } java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/000077500000000000000000000000001312550536300301105ustar00rootroot00000000000000LotteryNumbersTest.java000066400000000000000000000053411312550536300345350ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import java.util.Arrays; import java.util.HashSet; import org.junit.Test; /** * * Unit tests for {@link LotteryNumbers} * */ public class LotteryNumbersTest { @Test public void testGivenNumbers() { LotteryNumbers numbers = LotteryNumbers.create( new HashSet<>(Arrays.asList(1, 2, 3, 4))); assertEquals(numbers.getNumbers().size(), 4); assertTrue(numbers.getNumbers().contains(1)); assertTrue(numbers.getNumbers().contains(2)); assertTrue(numbers.getNumbers().contains(3)); assertTrue(numbers.getNumbers().contains(4)); } @Test(expected = UnsupportedOperationException.class) public void testNumbersCantBeModified() { LotteryNumbers numbers = LotteryNumbers.create( new HashSet<>(Arrays.asList(1, 2, 3, 4))); numbers.getNumbers().add(5); } @Test public void testRandomNumbers() { LotteryNumbers numbers = LotteryNumbers.createRandom(); assertEquals(numbers.getNumbers().size(), LotteryNumbers.NUM_NUMBERS); } @Test public void testEquals() { LotteryNumbers numbers1 = LotteryNumbers.create( new HashSet<>(Arrays.asList(1, 2, 3, 4))); LotteryNumbers numbers2 = LotteryNumbers.create( new HashSet<>(Arrays.asList(1, 2, 3, 4))); assertTrue(numbers1.equals(numbers2)); LotteryNumbers numbers3 = LotteryNumbers.create( new HashSet<>(Arrays.asList(11, 12, 13, 14))); assertFalse(numbers1.equals(numbers3)); } } java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTest.java000066400000000000000000000110431312550536300332540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import java.util.Arrays; import java.util.HashSet; import java.util.Map; import java.util.Optional; import com.google.inject.Guice; import com.google.inject.Inject; import com.google.inject.Injector; import com.iluwatar.hexagonal.module.LotteryTestingModule; import org.junit.Before; import org.junit.Test; import com.iluwatar.hexagonal.banking.WireTransfers; import com.iluwatar.hexagonal.domain.LotteryTicketCheckResult.CheckResult; import com.iluwatar.hexagonal.test.LotteryTestUtils; /** * * Test the lottery system * */ public class LotteryTest { private Injector injector; @Inject private LotteryAdministration administration; @Inject private LotteryService service; @Inject private WireTransfers wireTransfers; public LotteryTest() { this.injector = Guice.createInjector(new LotteryTestingModule()); } @Before public void setup() { injector.injectMembers(this); // add funds to the test player's bank account wireTransfers.setFunds("123-12312", 100); } @Test public void testLottery() { // admin resets the lottery administration.resetLottery(); assertEquals(administration.getAllSubmittedTickets().size(), 0); // players submit the lottery tickets Optional ticket1 = service.submitTicket(LotteryTestUtils.createLotteryTicket("cvt@bbb.com", "123-12312", "+32425255", new HashSet<>(Arrays.asList(1, 2, 3, 4)))); assertTrue(ticket1.isPresent()); Optional ticket2 = service.submitTicket(LotteryTestUtils.createLotteryTicket("ant@bac.com", "123-12312", "+32423455", new HashSet<>(Arrays.asList(11, 12, 13, 14)))); assertTrue(ticket2.isPresent()); Optional ticket3 = service.submitTicket(LotteryTestUtils.createLotteryTicket("arg@boo.com", "123-12312", "+32421255", new HashSet<>(Arrays.asList(6, 8, 13, 19)))); assertTrue(ticket3.isPresent()); assertEquals(administration.getAllSubmittedTickets().size(), 3); // perform lottery LotteryNumbers winningNumbers = administration.performLottery(); // cheat a bit for testing sake, use winning numbers to submit another ticket Optional ticket4 = service.submitTicket(LotteryTestUtils.createLotteryTicket("lucky@orb.com", "123-12312", "+12421255", winningNumbers.getNumbers())); assertTrue(ticket4.isPresent()); assertEquals(administration.getAllSubmittedTickets().size(), 4); // check winners Map tickets = administration.getAllSubmittedTickets(); for (LotteryTicketId id: tickets.keySet()) { LotteryTicketCheckResult checkResult = service.checkTicketForPrize(id, winningNumbers); assertTrue(checkResult.getResult() != CheckResult.TICKET_NOT_SUBMITTED); if (checkResult.getResult().equals(CheckResult.WIN_PRIZE)) { assertTrue(checkResult.getPrizeAmount() > 0); } else if (checkResult.getResult().equals(CheckResult.WIN_PRIZE)) { assertEquals(checkResult.getPrizeAmount(), 0); } } // check another ticket that has not been submitted LotteryTicketCheckResult checkResult = service.checkTicketForPrize(new LotteryTicketId(), winningNumbers); assertTrue(checkResult.getResult() == CheckResult.TICKET_NOT_SUBMITTED); assertEquals(checkResult.getPrizeAmount(), 0); } } LotteryTicketCheckResultTest.java000066400000000000000000000035421312550536300365030ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import org.junit.Test; import com.iluwatar.hexagonal.domain.LotteryTicketCheckResult.CheckResult; /** * * Unit tests for {@link LotteryTicketCheckResult} * */ public class LotteryTicketCheckResultTest { @Test public void testEquals() { LotteryTicketCheckResult result1 = new LotteryTicketCheckResult(CheckResult.NO_PRIZE); LotteryTicketCheckResult result2 = new LotteryTicketCheckResult(CheckResult.NO_PRIZE); assertEquals(result1, result2); LotteryTicketCheckResult result3 = new LotteryTicketCheckResult(CheckResult.WIN_PRIZE, 300000); assertFalse(result1.equals(result3)); } } LotteryTicketIdTest.java000066400000000000000000000033751312550536300346270ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; /** * Tests for lottery ticket id */ public class LotteryTicketIdTest { @Test public void testEquals() { LotteryTicketId ticketId1 = new LotteryTicketId(); LotteryTicketId ticketId2 = new LotteryTicketId(); LotteryTicketId ticketId3 = new LotteryTicketId(); assertFalse(ticketId1.equals(ticketId2)); assertFalse(ticketId2.equals(ticketId3)); LotteryTicketId ticketId4 = new LotteryTicketId(ticketId1.getId()); assertTrue(ticketId1.equals(ticketId4)); } } LotteryTicketTest.java000066400000000000000000000045411312550536300343460ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import java.util.Arrays; import java.util.HashSet; import org.junit.Test; /** * Test Lottery Tickets for equality */ public class LotteryTicketTest { @Test public void testEquals() { PlayerDetails details1 = new PlayerDetails("bob@foo.bar", "1212-121212", "+34332322"); LotteryNumbers numbers1 = LotteryNumbers.create(new HashSet(Arrays.asList(1, 2, 3, 4))); LotteryTicket ticket1 = new LotteryTicket(new LotteryTicketId(), details1, numbers1); PlayerDetails details2 = new PlayerDetails("bob@foo.bar", "1212-121212", "+34332322"); LotteryNumbers numbers2 = LotteryNumbers.create(new HashSet(Arrays.asList(1, 2, 3, 4))); LotteryTicket ticket2 = new LotteryTicket(new LotteryTicketId(), details2, numbers2); assertEquals(ticket1, ticket2); PlayerDetails details3 = new PlayerDetails("elsa@foo.bar", "1223-121212", "+49332322"); LotteryNumbers numbers3 = LotteryNumbers.create(new HashSet(Arrays.asList(1, 2, 3, 8))); LotteryTicket ticket3 = new LotteryTicket(new LotteryTicketId(), details3, numbers3); assertFalse(ticket1.equals(ticket3)); } } PlayerDetailsTest.java000066400000000000000000000034001312550536300342730ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.domain; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import org.junit.Test; /** * * Unit tests for {@link PlayerDetails} * */ public class PlayerDetailsTest { @Test public void testEquals() { PlayerDetails details1 = new PlayerDetails("tom@foo.bar", "11212-123434", "+12323425"); PlayerDetails details2 = new PlayerDetails("tom@foo.bar", "11212-123434", "+12323425"); assertEquals(details1, details2); PlayerDetails details3 = new PlayerDetails("john@foo.bar", "16412-123439", "+34323432"); assertFalse(details1.equals(details3)); } } java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/eventlog/000077500000000000000000000000001312550536300304645ustar00rootroot00000000000000MongoEventLogTest.java000066400000000000000000000066361312550536300346460ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/eventlog/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.eventlog; import com.iluwatar.hexagonal.domain.PlayerDetails; import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader; import com.mongodb.MongoClient; import org.junit.Before; import org.junit.Ignore; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Tests for Mongo event log */ @Ignore public class MongoEventLogTest { private static final String TEST_DB = "lotteryDBTest"; private static final String TEST_EVENTS_COLLECTION = "testEvents"; private MongoEventLog mongoEventLog; @Before public void init() { MongoConnectionPropertiesLoader.load(); MongoClient mongoClient = new MongoClient(System.getProperty("mongo-host"), Integer.parseInt(System.getProperty("mongo-port"))); mongoClient.dropDatabase(TEST_DB); mongoClient.close(); mongoEventLog = new MongoEventLog(TEST_DB, TEST_EVENTS_COLLECTION); } @Test public void testSetup() { assertEquals(0, mongoEventLog.getEventsCollection().count()); } @Test public void testFundTransfers() { PlayerDetails playerDetails = new PlayerDetails("john@wayne.com", "000-000", "03432534543"); mongoEventLog.prizeError(playerDetails, 1000); assertEquals(1, mongoEventLog.getEventsCollection().count()); mongoEventLog.prizeError(playerDetails, 1000); assertEquals(2, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketDidNotWin(playerDetails); assertEquals(3, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketDidNotWin(playerDetails); assertEquals(4, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketSubmitError(playerDetails); assertEquals(5, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketSubmitError(playerDetails); assertEquals(6, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketSubmitted(playerDetails); assertEquals(7, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketSubmitted(playerDetails); assertEquals(8, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketWon(playerDetails, 1000); assertEquals(9, mongoEventLog.getEventsCollection().count()); mongoEventLog.ticketWon(playerDetails, 1000); assertEquals(10, mongoEventLog.getEventsCollection().count()); } } java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/test/000077500000000000000000000000001312550536300276205ustar00rootroot00000000000000LotteryTestUtils.java000066400000000000000000000041451312550536300337330ustar00rootroot00000000000000java-design-patterns-1.16.0/hexagonal/src/test/java/com/iluwatar/hexagonal/test/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.hexagonal.test; import java.util.Arrays; import java.util.HashSet; import java.util.Set; import com.iluwatar.hexagonal.domain.LotteryNumbers; import com.iluwatar.hexagonal.domain.LotteryTicket; import com.iluwatar.hexagonal.domain.LotteryTicketId; import com.iluwatar.hexagonal.domain.PlayerDetails; /** * * Utilities for lottery tests * */ public class LotteryTestUtils { /** * @return lottery ticket */ public static LotteryTicket createLotteryTicket() { return createLotteryTicket("foo@bar.com", "12231-213132", "+99324554", new HashSet<>(Arrays.asList(1, 2, 3, 4))); } /** * @return lottery ticket */ public static LotteryTicket createLotteryTicket(String email, String account, String phone, Set givenNumbers) { PlayerDetails details = new PlayerDetails(email, account, phone); LotteryNumbers numbers = LotteryNumbers.create(givenNumbers); return new LotteryTicket(new LotteryTicketId(), details, numbers); } } java-design-patterns-1.16.0/intercepting-filter/000077500000000000000000000000001312550536300216065ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/README.md000066400000000000000000000026361312550536300230740ustar00rootroot00000000000000--- layout: pattern title: Intercepting Filter folder: intercepting-filter permalink: /patterns/intercepting-filter/ pumlid: RSfB3i8m303Hgy014k-vZN5DQkIuaJ_q-fGzkz7JtCL8Q-DolUsPAnu0ZcSVadizAzZfi6JBJiS4qJenqU6D7smRXmnh2pFPBM1YN05o_KwyKcoqb-ZFEEcVz_BPLqtz0W00 categories: Behavioral tags: - Java - Difficulty-Intermediate --- ## Intent Provide pluggable filters to conduct necessary pre-processing and post-processing to requests from a client to a target ![alt text](./etc/intercepting-filter.png "Intercepting Filter") ## Applicability Use the Intercepting Filter pattern when * a system uses pre-processing or post-processing requests * a system should do the authentication/ authorization/ logging or tracking of request and then pass the requests to corresponding handlers * you want a modular approach to configuring pre-processing and post-processing schemes ## Real world examples * [javax.servlet.FilterChain](https://tomcat.apache.org/tomcat-8.0-doc/servletapi/javax/servlet/FilterChain.html) and [javax.servlet.Filter](https://tomcat.apache.org/tomcat-8.0-doc/servletapi/javax/servlet/Filter.html) * [Struts 2 - Interceptors](https://struts.apache.org/docs/interceptors.html) ## Credits * [TutorialsPoint - Intercepting Filter](http://www.tutorialspoint.com/design_pattern/intercepting_filter_pattern.htm) * [Presentation Tier Patterns](http://www.javagyan.com/tutorials/corej2eepatterns/presentation-tier-patterns) java-design-patterns-1.16.0/intercepting-filter/etc/000077500000000000000000000000001312550536300223615ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/etc/intercepting-filter.png000066400000000000000000002231271312550536300270540ustar00rootroot00000000000000PNG  IHDRbĢ&IDATxmWwaA چAVdn Q2{%CamZzyWbe#CM(ɝ%KY-YZ2k'EPH"]98M o7Xl~STSUQ^N5sz @5_@!М8_z^s=FB_hE'Ӓ fJR`9PE~ fJR`9PE~ fJR`9PE~ fJR`9PE~ f^j8s[sE~ #֢"3Q ?x LE~ #֢"fBAؠ|mV0(y? )3\o^'_HˁXd_3Qnqޤl se RwRاpu I  J: N {# )r`-Z_ȳfu6n IM6'>*TT]TYiB;_HkQS8"g1̈́S.]+;$x96]>Va#_HkQS8"g1D4>fJvN`yVûO*HK.TR@Xŷ,V$8caa`ؔhoCyyYnPc'1GI"k"f'߶T I>s_f<'i>I8@ ,֢"3z% )"3z% )"3z% )"3z% )"3z% )"3z% )"3z% )"31~;W~]mZ"֢+"3\{[/kw.>ʝ$ A]//r5Xge,\D~ fo/Əo/ѝ/_~%; ^1_H(h&"㿝}~ɑ<&O?/_7ֿs)g>'#jvQ򋹈@ ,Zdq<\$''0E~ fks~vo{Wg$0}r,IGi%F2j yWR`9LZ¬EX O,%72a<&__/wO7~P$>dž 6[S g|A/4\mXS3Ec n_ȃh\|o#ɿ<[/PRx]z?LW=31 ׏CJ||]K٣L:9hE~ ԌE&O~Bƃ#._ȃh_?SowxZ~G~g|v a$\ox&GnU*cP_Wn\1, R됵ql];Lr|a+3mcu+n6ft;51n0=[~u㻫z+"_HqkX }д%p0E>g ۞dğ ;Hʘ*m.Ֆy6) ×;8MFEecʷIRZ`-f* yZ_Q}yYQL -o6&v|>C砪 DŽ~z6|D~ @~Z,hZ_|$[0<|*k}p=(5IkJg2o/K łZ yڒ_gaMO4$5miCUK-umU5܅-~&j|I*ߚ`o/k踅hZ_5 M^a2*dl"ep`NLeMmqm&b;]|vaz:0XoeʷERHXbA,@ӦMǢI"OR`9)E" y0iLFeD~ Z$"3z% )"3z% )"3z% )"3z% )"o z^s=FB_h| A}ҀB`9P%k!//rN@/rN@/(Yw_PR._=:Jj+dD~ /(w/n}| z. y/PD~ EE~_ȷH[ xh,il쿿>F"G#S~um(JF" C\!Ya1ξ&/ y:_خp4ըRR#sk2aK𨚧aM)/f~QmD~ š濘g{RZH4& S[ILLE~ Ou~]uZ١H*7jaiv.Dvs^u]PD߽xP? qXv$w7yp.sbmaa?*ﬕyܙX[!/9ntZj!/^P?=E0ގAjm}|WMig2?a:iwᣮ:W?.hE~ T.2iNFd;םY+gNrb&_8DMpD~_Sk&==kC.po[T) 2_8,̝ݣVRLe9<47'đDx_]՛w~Ѽ&8"/i1+#{;y~a<ȮX"mW .@,V^Q2͉h3} bԞ[r`3m~Qg*D~ OKEVUڂbJ|m/rvq09) kP>)(f5E~ O3gj_Y9=*7?`goD~ ԖÜ"n]桹9) }p@{Ku‘ZAqjOW6 + yf_B2#ng=0OGʱ:ͺh:̾:& )T~pw{rZil@6MzzGMpD_3X@M4{(/rtM8"K`&ܽR@ ,G#@DxgW*Z4_HpD>_ȃ@Xi_ȃ@Xi_ȃ@Xi_ȃ@Xi_ȃ@Xi_m3W ǻv4k}펇 a% swZesYnPf{Nж6<~('oY~ffeO|/ @B"xwhW~N?B"L{?0'˅{4ĥ:n(:YvsTA +1Gqzu}c;!XV\8p5&%a`cIdtxh[Opl>.YOkxLb/z& yj_vS̄nΓW!7 3ȬC¬7*m:0.ß_ i=mC|1e&Ax 4 u'f<( TRLg9f>xLd/% yjDL>i 9S< hҟ3=V0]EʹmuMfFJއS*"b*1;,c"@~/_c7Wf" azv 0FUğAwѶi2f_ cLA1txI2Rz! )s/Jc6uYL5uYwC xnYH(y&%2Щz8/5^mxZKsiWhgbw&_L% y3=tk# _H1ZS@4:_H1"J_Lxڋ_Hqhˑ0Jƛ ǻ!@_^@ ,/L^@ ,/L^@ ,/L^@ ,/L^@ ,/䙝f%tCf 4 s&/rTzEsE;%%Gf y_d2`4-/,,#IN!' )fc9mh| Bl9/x~:/]0ڕ_HV=|/W~wj[_/f yϾS}txpĪ4&x~I;[jvά3S Il%#: qzU}c;!HnL)ݎ:p 03RTvIρGzK_D~ tny#DD-˙~h&ͯU_/0`/f yj_vS̄n5h^ pp7 "ok8?`<^wOå[G4W_H1;ˑ֋zZ&d`t,srxۼYr1buC"L j7LhYƨL|}L n~ e2myDI ,TbE~ ,%e- 鏶&Hb}vd]gމ@YGK0>{sg9՚՘ZiCP. y3fL@txݵٹ|AK*[ˣdy "Y ")Izusn"Y7T- y5eѢ@ ,/鵙0;X~X?D~ E-/鹙z`|_Hsˁ. y0W"ˁ:- y0W"ˁ:- y0W"ˁ:- yVq}.E/92 @]ր@d@rN@/Xˡ_/ R| @"gABD~ łX,, %ζJ-@I/>/_?B _ld -/in&V>8?RBՖgxtzzDan l>xcӓ }RMx7DUs# y&/C&_vSz,n~ޱTB& 0ק p}?3}QWW:H_}\Nz臩/@"gX6i*2EQM! )jlO_~uйrځ8EN#O" 94s }jL8ὣJU@iǏD*]&&/Iecd"ao6I0aE[QEѽPBIA%Α&~>o'\>5_mD~ O8wOB~"g&SWl~yk[jHڻUM"/RUN$@S@ i_Sa&o޼y~:vX?3s]"b!a_Sm&^V~/>(NU+53(?"fbqO"j_z31xM) )VqqO@3h{~v_MUHB`_4 +_H@< +_H@<_}/_G[! )"XWcqO6[! )"gR3a*ߐ 4/rN@aTixik?wƕVͱbMS!+C<%bƖ#A ezV<@i;sBwD9"a`FYbwgi@YXQQ7^tN~Bk7SG~߾yjCtV~jf D4aJ\9gL \Wd v10ݚ8[_Sa&^VfLh6v]8C:ƕ 7 (-\Wd1ˑe60fvw4vґf#|4# svVtL 4+_H@< +_H@< +_H@< +_H@< +_H@<fB/x9%sY$5E<;rͽhD~ ENn՚\h~"ٜ̄Gl ԯʍ"2 * ),d "@j3q敇7xݑژ8Qi߼D:p,^YM/TRs=~yEmݒA>f+T;e03㡕h$1Gsn8ЖqѬ}(+! +F Mev1/ǻYL@ _nYrPhk-Gg9qzlT+MrNK_,/񙉳sGKuUTn4įћ|@v8X@[x;J MϙPuk-8&( xI4U_~ E"*xϿTWrp≻.`Zy;Ҙ"g&0x/.% /]ӖHF}_W̩µb)$2]8/򠤐_ DE//7cժN`9Ev*.mH4z_t^#o~D:T?UOCܗQYa& =ޘMK#W܏@[d@_O\~?>kOJJ]&NXW~&!v~})~S-"@xO]=歍7omS#UhV"LS|]uBE#R>gU_ow~o(5 E۠ ab‰@ 3'~Oϫ O5-0T#P+6/WœY#z_HQ_<_O)Ubc˹[v٘˜W-Ӊ235_"L(txT'_nÜ[;ᙕseK-Ep'+ùH3pM~{ -"*/լ?Wfd lV3p?mti,AE~ Ou~1Z7r wigfg9om@mGp>6_+L>^*w3<ڛ}VŅΏ! v>$'UWZ>;( lIZJOZ]Vw\Ti$}~l~B g&/6;m$yAliQf4UnܮdF@x틗(~’( 8´qrwLۿɓ6ɵb@Oj@Ю nCHR㊺eL>3_XRZρxi~ ̿Pg¹ft>HG`/G>7^tN~Ҟy#74є/GBf^Ezh>? k#–Tk|ORk9=6VՍG:&k!/xO]=歍7omS#U}3tsi4p/\Wtp8ET<ñO}7F-uw(Y f{u㑎_3J_|oo^P?]`ע=bF~ k<ҿ+6/Ws1񓮊մX /D~ V~vdWU?~E|jOzuㅚ#L(tx13ާf2p{Ow}E% <5r$եRlӿ1s_HˑG9OܓY~}Z9{qwƀ_Sm&:}{}9#:j/X`1OM0Onh < m&}rbMgᖿq m9f*h9v0 yLCD<,m9f+h|``Əʀ_ȃ@Xi_ȃ@Xi_ȃ@Xi_ȃ@Xi_ȃ@Xi_#f&Y)T9u4펇\+-\U(͟ش"5VmaZZ@ĪaV'cr_sDfжYkzGK'/} rO7aV"ՆB/!Y2\YM4/@j3q敇7xݑژ6o+Mɖ7Q~:.~//-ʝ8SɎdUTR娗7hU+a*+XIE~ Ox×\>ꃫ_^Qcgcn4::V 3 dyƒEca7OU DBۑge{|h`5iøDe741.*;Nkߋ_RLk9nYg×6/Jg6 <ng K =pݚɘGa9:e!/8;}tTWOUh؏5 hlyyaNTa!mޕƩ uHc?Hky+w|%u\*J#b\\zz^@-'kGo3Gƙ+ ['Qj]UmL!&U/_YnE9Ud"a9:d!/x^_;{Hԟ*4a +ΠpQ}EQWha׳LؾG# )~ƗF^ }j\RJ{oe i5ZuL<맮|cƛ6Ʃ*va6~;𶑦3E҄Gs[̲E:UGhb&OmzP1dR_H1p6N ff, oy~rSjH̄|ۛ?=6>5_Z3zk=C0 >!/&G֪8$fbN* )vy#x//j=Cup&z> 9*X.Y L(tx13')pևrq6:a=#WiUr-H$E#NQp9vWLf%ZGmCE-BtĖ͌Qa۞s~A516'茅h$dqdXzq9_pRrAscB_3 @j+\Ñ_HA~@[Q5XIE~ ϔf"39r.{jKHo/ h#ꂁ\,@FR`9PE~ fJR`9PE~ fJR`9PE~ fJR?@gQ _>i@~d4IWh VJ%Uko]2Ͳ^ܘl\dC?p庴;t>ÿ={x>$@1N"_䋽('3m,zw $] /ݼ;RS7Z[%=,//V*BdUi~YN~0_ݻw ZME~ԇ/|W6OpAֻ*_%;'LTNhUPSUcw<sDQ<1NOolg;y=O#>p5%yknzJcu#^0#~bֿEXV/J+++ҵ1/_~qwN_[{ϻ!鸰otbs aT#6NULC c4EZ(o-bq꾧Q[1찃׭h#/]Ez-g&#;;;g/_~Ѕ/}q)QxIT޸% ﱥQΫx /ٶ $3Yޑ7Jd>RۅqECDJƳT;L~0G._&] }kgoSTlG+ފQ C<W;;r3/8Ө"K%*jJ!H]iN必}f r>B @/SWl~yk[jHz #;\FZRw?E>m1^ up$;!NET<߂Gh4ّ} />۷7/~z^m} ʣ3&8"zԆ{ Pϴ.|O"zqI ȞX /ZO?+] /^V~pSR.+9g͋lFFeR#HZ0sPym&?bRZ$sT"{Dsdee% CZMu~@|ssމޞt-@ {=PQ6#tǏ߿_ @C~ͯ F6Mhz +s---I$h/PD~޽{'NH}А_^:G+++ҵI/ +_@FҵI/ +_@|ښt-@ F2+zb88Y8%+-> ǻ[*v|VEES:Z$y?8B6^ б*7eOrN:h4ّH}Tn^yx/qIIg:V&9ED~c8޼yS @S_aD8h60/r/s;vҵI/_~ۧv+Ω?OUhctvw[0T4^&IxdGai‹"&mWIA-!P4!^c=r1!hF|I~أ?'5ѡ͛7át-@ :D` /9Ei:Ïs"n3k`_4SVV> d(<okIhPA%]0ׇGba]D~^{7k`_4?PD~b4Hh/PD~b8޼yS @C~z% 'Ost-@ J-k`_4W"nqرHh$ nh3P9Vͱz% W?UԞv,/C>\Wt_U訛k s7V~:Yȃ:2Jt>0Y_@Fҵy/_~Ѕ/}q)QxITn v&+ʻKzF2RytP%!O(\usYc<(; }wZxbIIƳT?IcN/ #k`_4⑷O?{}W"SoG0)FF`ɝ+:,"K%W,m [}.E"bUQR>3ES_@X[[|t-@ Ɨ_<맮|cƛ6Ʃ*:8R^j?nvY ,ET<' /% hggG @/o޼y~1GLo<(v鹢U8 !Fw { ׈b/Z Pb"t-@ "Pz[jýO#}Sz?X.NYԈo+J </FUxJHiF^P/C8q޽{ҵy/'J˜|t=Z< E$ b\8:"`^ǀBHA ?~t-`_4W"$] h /+a"] h /+>ҵV}А_^h4 JGHZ@#_%E-qڨQ:w@!DM>Q*NmV"veZ@+h(0ߨo[# wF5 uu}UndQ$\FΎt-`_4ŹWxwGjcƪA:8Rq_&!}9 lF/&t0 k/3׃OWԆ- /K ` ;8޺WtXpy<^-OkއnYa|9wԙK;jqv[ƍod;1QWa\ھ9AvÅgw־xX+Z/D~]ĉݓ Ɨ_>^*w/~m=taܡE~dlI~id} [a,?HE+w|i͋׉# A 4"xZs)" KKK{{{ҵV}. /޾xKK*v;o;y(4/o;P5/`®aE28l 0BQ.Ji{):դc#t,?/x^_;{Hԟ*41Hܵ3&n_:+!~^w]CW\ui~a,4E]~ժVދ_M:V82ܿҵ}>~3olxֆ8=Rn/Ww'l:?3,:pM]U@=_>*] h /Pz|?}{ՆYڧf I̹*KsC8pѤr (p{¼V7&/a"] h ME~ҍSՆ{|%U"YI<sI}ciq`D[}t`U8B`\$cpQ!3^:kמyZ@[hI1- <(M1_"N /H@3U~QE $MOqyDj-tҵ}L"j1g/.ã|q$j-t^xa{{[/ٍA"N3\vM/ +_@'XYY P/ +_@'xGkZ@[h/PD~7|#] h  /` 5h ~^}c+-s tERGғ[CjO;嶂N-b7|ߖ շ^a0!_OffeifI]eђ_̘G :8wO7^tN~B)I~a!-_W]{pD>D$L #d|SQdDEu6:W/ni|3_̘^xa{{["/_~ǯzf[oPGfePxo0{/*鯃^c<^ u-q~1Qpy)F]'_̓gyڵkҵ} />۷7/~z^m}C!*8X JiRk9.|^8$_dOl`,2a(] hME~ҍSՆ{G5?,wi=&ZQU$oѵփ_T?NQBO9(pԼИ+U-g:=" Y裏~ҵ}T퐧B(/srG_@9~k-!a,t'X؇Y/ h?VP 4_l 5ǝ//---I@ӅZν{N8!] h /a"] h /F#Z@h/PD~-kkkҵv}А_^ZZ@h gFDlJPW ^*w9BGyWYx;Dd醕cӣGvrFIlxg@Ǐ߿_./_~Ѕ/}q)QxITnVaY|},H{O_:Uhe0]8/ZE(QYrh Mh|#o~D:T?U=iEZXd0( &}~s"UeUdG!@[ZZ Ɨ_<맮|cƛ6Ʃ*v$uG_&/_@wމ'kO͋Wgi/c.*O-&SH itӰWej0 WVVk^?o맪 >A(/3͸>׫_տùH3X*6+q? ._@Fҵց}Th=/+9\Ee?S D~1/_@ksɓ'km/ݼ;RS7Za op}$/JGe5i~#O$yZ͛7át-`_4S|zW\P?E=)"mm 1 jc c+}Qax9Jv1/ǻqln1y&nZCs7͢YZh4 Ɨ_>^*w3 y[$7|#0N\wb>va<<*Lb ,;Uܩ(g~l~¼ΛE37x^ Ɨ_3żD~e4H@/SWl~yk[jHz " 5ӛD8__Qs18,ET<g /DZ͛7kmO͋Wgq {އXS/U_d ievPh9ߩ _Zɓ'ܹ#] h#M/x+^?UmY^Ě,ØV"Q^]8SbW*DDG Kw7f) h-KKK{{{ҵ6}TU2_/\~ZZ;Z@h2(z< kj/4Q_dIA)H$מv(a%յ}QA_@+9Lұvi7 lY@`p% =_jeʊgO А_"{7xFȬX#_8ɲ)׮]{g,>1XD/ZIUdxFi;q>`{FEfqV l_xdS/ z؜(LuvǕ/ s0%,^x  a_H\3AҶvBNt# #Fa]%A+P“+W枢EHYx- :/ A\2E Wgޙ|fvfw~<~n3LD8/D:88H0U/[ZZ2M@_ 6??rrRQ/}vGR#Ѡsx򶶶v~~n?}lǃ#MasmADž"lڏM\ZZrSq/h6j oݺXq/t:u"fɍTE~(̌eq"_ai˕#F~(=gzr/i6Ї>Oq_ t~'~.@Pvf_4~?V Dz̀/ -IQ_ [/ '_$E}@N/(n!HT/84+ft2Q ERg4<NA~Q/Ii~p6c,O9Vk7_螥#sal_^\!H ' ;2\C'><| a!EĎ .\Qr򋊠 'E޻6&XaO 2XCVn/AD(pB$Lj/J_]1 ଻`FPNB'a[j7 څdzQ_;،Gq"A!򋤨/Ie J") rB~Aq ER򋤨/ -IQ_ [/ '_$E}@N/(n!H_[˿_?(eIu_$E}@Nr/__ް<dwͽvCmZ1{Ǔîc]nal(\/ 'YW^ڿycۯ~O~ҟ3[է~{ƘٶIZbUh֥_$E}@N2/_}o} l~ʅ$1V v{AiF{ @ $Sϯ[}}Ͼ㿽ssioygB;B+ g u vZ=pMzB<{HgWaOy[! 7_94wO=ͷoG]~ >-x;꾫Gf`FPq^JH/ܐ{~/ʂ4/>x}?~]_wV<}p{}ۿ2n~3 ͳP}3Q?D \)\c0ma=%ّ_94w|/ȎuOܳ,w^~V? H \R%٠N{/&x}x{(OIveA}@N2/~sm~|e_??F89ot?Gx;B>5E׏x& >%q~veA}@N2/᭟{_|w_zm?՞6sHB B+\~h~׏=r򋲠 'Rs/{sʿן{~ې"Y~h\_ Fġ>%4=7肚Y$9r򋲠 'Yvq×K="cY //+/tAF̰y}qw wF&:t׏>_o#'( rC~ѳ.$)w/+ԵD]3RL!H_PE3:g") rB~kgs ER򋤨/ -IQ_ [/ '_$E}@N/(n!H_PB~9)84+ ͦ~ǖIUv 뾫F8x򋤨/I//Z{ >P$5L@_}]wqfpJI ΃oCR/Dy֢g;G7Ov<`nj 'Bs1°{3e,ƙod=aGm̫-x_(68幱QO~ r_8tO; = \uˣ;:ʛhGo=QN"_knȋ( XN{o//#A,/9/=[Po2x}pk"SwQpc7l/ '~}7޺.Gyx_l\f %/Qua-q5[I~xʞnw^6 k+_ڛ]#Q"`XY ̕Qzlma[iEKݔhWNoV P6ۏ!|D=TkN/*/_~I5.WV/D-33݋))IQ_/ 2(f[wH ERdJ󋌇`93tNW!HLk~A_$E}@N/(n!H_PB~9!") rB~Aq ERdl7J61n\Ow?Seӭ!+#apmX_<}f+JڽQnߡjz.ثiq+b2$,W/tSnȏ0ЗЏa\҃.A]\k[^ܡ/OW6cN=p_]zރ E3Ph-TMI#H9 /q+W߼:(UQ_GCC1!OWzP`珓_Cսv'dMqW G~ r_K~'+?q Uc6 sG{6hƀ]}dx;)B/QETՅGӏ H]{}gnn˃UY8n~B"d#`C-B'r+M/_c@ґ P_BGg:o\-y ?FD`%p(O=W;~c!ISFhGCXw*xC[H9/l %G~U_x g;V2W~APCO/j*EܣL{mBgcۆ$"37<{rw|@ PHLg>E_@G[_ pU׈/CYos(O/԰2uH2/g$F%Z6bnY6_)#{=mJi['L kFȿP9H–BP&8;`lT"Ȼ:hi۠6(MXg~P+_j﯂Za_sE(pB$lBP8;`lT"ȵ6v\ YwLC:[ڍm! -T8;gPdj߰ygw/K8:jߌYRBW|b8;pvبD2w 5~XS V<6 ]nۋ),\u!W8206*LBK vd Tf[iZs ˭; [sQ څ08;pvبD2Qh uTCft4gGqez!?| -T8;pvبD2Q*%B @4,RA% Z,PDP!T"ZB @4,RA% Z,PDP!T"ZB @4,RA%ZhZ= -T/Y8;J YP_/Dz/(ZP|s*h,RA%L[W^/}/oE (B"|˒?6kR8;J ٵPǶ_ҟ?gn=_+ [{O]nef;u 3іiVT~ ?xY]s>i_=?I-!T"ȨoIw_}G좻k8-Cc̿\m,o :n6mS?$ZRVH~|?S?=cB>Mӓ;_L'*LdBo#{/泯'ᰋ^O7jhVX<{(wDųS?$Z2~|࿿W6?xB'uA1^~8#EDF-{wރ|.~E~l~eYsv%84 ;vWKN~QamS؛'0 j[ўy+xBo|Z~/|>pnJ;B D5v{9J%weI*8rv( *LdB_w~3~]_wV<}p{}ۿ{`EP3sڟ5R[vt |8ܠǬ>9$*-T9k_߿Isuu׏ rEiſq'V\+ ;hl?=!T"Ȩ*M|/.uOܳ,w^~V?Rj3mස ݅橷(mSN` 8j$C {"J;i~MrbϹ#·qp(jDF-|\[~_OoFs[}էxPq66%۠6bg D*_$ ^??C~ =᩟aҒ\ gTPd";?sOO?rw[="Ua{;3:S`Wm]'0m˱6aDf68,7l!tG0G @*/LG3E׏D9Dv-\\}<V]Y-F?T;.WWGmxlۂ(!ؠAjMR<4l ZE{!Vk?dg8a5SJ Ps//#{DDz^4"_^Y*Fp5GyC~Y6{9CGy#&B9 NdU*SJ EP)Zxv|S2*RA% zZqvg *LBg gz-zZqvg *LBg gz-zZqvg *LBg gz-zZqvg *LdB=4+ ͦ~ǖIUv jF=xZ_ԳpvH@&rj_乵,|.nnclT"P B̷m Ii]Þgɝ`~@<:$%*rܭ _lHl-~Os{d{#[O @ۤ@&<-T5X-3z[!Y~aլ,jfU1NC[O)VKQ<E(ύ_:xZ &بD2/v.pif`'0onyoGPy[>[rx6b('n~iHttcD)Zv'imA; 鴇v"ОBն,/v~1Aȭd쵝vL*hYFɞf?n_B O) *LDP8<]l-i//͕yVt+sB @p?wfaL~*aZu5`RA%~}7޺.Gyդco75ể2,-59c_d+d}r/8L[g 6% k7Y9oh({6I'eՉ0vm48gTPd"z^:X9ܐe5=/knS((++Wm78h՜<-ҏcW`ZMng%{_`=|{rv_Z TwE73u_x)bqDX =OW޸rͫb^eMOf~3mL 8a*#Yξԃ 4MWh6QQ1Hޣ'.$wH^b-T%A~Q!T"H+h4<f #6~Q/]yյ 0 p.` \nߤ RD%vt޸v{[@~\_h۔/ܱԅ;+YmzV2؅oZ 5q@g=">SHB״SqT"/%g/=W( #dJK_8yjN$?_daMNGܚxB7tOISF|pv(hq|#?S?B?׮|oKȏ-wVo<-Z wȮn WcV7FU` LnFIWh_RM~X/ʏJ`_޻v~~_Hy앯3:#? @sm>z-xۿ^P*ԧ!MLo,6ӛvV=w_Ѕ+ +d2(ݎFaZ"౒E0N7J" QvT"͝Fptt4??/?FU)2+ Zh6i7֬/nlxv$Z((SigM퍛N^ G0q'qsvH@,kƆaovNG~Aa2S+PDC.[ HSMC*DBݾ}{j/<srr[N 5V9sf蜖B @9;p%[?T:C*Dnݺl6gggWWWXfff|kv:Y8)jRZM!!9&4O!T"}P {;;Sj= -Tff@{oi)0|C-666nݺϮ]=S gMvӟ%uP 0Y!D SS,` N2";wLŖbyyyiiŋf3BMQ2=u#wQ 8<<3ZGemm}X8??4hSj YRi?≣ݾﮯʃ:bnso<`x /|Ƶ+ے.V spn΅{#Pl0tkB:1I3cqq@/(P \Ӊ_R|9]?BRI_* -|acϚ IZ;;;ejaZә7 #//Y.cQCINED*=~_&uzh6%TҞ74{_Գ_!ߎi ) M99/crZ̴Z=ΡܜyC/Y&/\.xi.&S0¶*M"$P.i/..GzT5Jg#^d@u1W1g_F;99ݕ&NZ88r[@~ѿjwZy; VHx*Q/lt|5 l6>L0F~;???<t[QY<ԗ:ruZNNNfgg766˯}K9( {vod B{@,ޅ7ud(]x*tT׏Hz~~>({֛4,v`ݾ}{nnn*0t#ڑ"J_*oNSFXX~񞧌+o\A1ʏгz 'N7#KoP^tR^z˯NOOggg;N;PE=&#)q֭f)U9mO7*KKK}^}Ty_gxO11Xqo?۔?#-^E=uy0JJdGFZS#4PQ }PaPŝ}PWa1UB_$)>/g݅#0(a%:6g;!D&@40T" WZ-yu;;;}i;.{m“鸹i%N~sb,--мv`Nq#.//}y9>jAϩj_Le^ߑw 84|/li6Ms}:??a_JkiiI>y><0T"R;>>gffɨ;!42eInݺU#G(U*+lllx/`2AfGf>P:P K^ҷ.}˜,I 6g}pLe$ @kyyZ3aOY<ot-?spp +,=e F"?#y@NNN>1!"I&C-lsssVk/%g;1 PM 0[QY< DNa\payyyZNOOfgg%Q/{/Y&/l;;;f34S>dN䣶YO+ ȉ=B:r>|}W*"yN>mi/7"Ʈ{혷P-B~{U]MT17M'Y)b1zVسFdسc|a۬Ӎj!: =IK^ܜ5j{mwsί?&bͶqr% rV~a+d FϺ?05t<;;[z/Q> 2QۡSyZJO^㒗{{G߻}]__Ec/oY@D.e~q=NZ|{ )nOڪ)`0jJ95v:pj }#}Jɟ/߸uy ?t=ho] 5[~\Gî4Z+cm8ϵFjX^Q҇}R Ps5#W7 8\ 2_җ=|`qqQ!|!I|mllwxf'Rxwvv1TLJzҵa fsiiۭ[ȿ~/.K/?,6pp/kcl/nS # 75$¶!d_U;uՏTܔD= s> c·l0 TQɠ^BTs(xN :BzҠťM!i}8ΎvR`@~#HAZVkfffiiC-\a1=G^~⍇}37Ϊ, a6hB8&=;C4ю}B;_" \Wb(oNo_x4MAs _766ͦǐ{f ّ J CKKK#6WG37]ޖ<(I_h5}_7|>.nʗ/D?yH7юToh;M_a@y_|: !¾EtQ |ȧPGQ"9/`Hj!= 91:vrrb],'Z]*7+r_" ) dw8|,k:}u߽E}u6m%Dj(־ #wyh4bD аkg%]qFnK,pgtjnČ>9/Q鳴d8G_=+:P9.""4Ӳ]~ON*CbþŽ(/t@MIsSP ݹ99se*FtVV_;Gly)Gh*%W/"[ޛi6fOpK emm}ÄUG~^/!řV%}¿,SiHc}}i/|0M"!gF^/Kig?MΝ;Wic]FoyBSZHS\utt$-it:5 cmo2i/(K0f[V͛M$1NOOO&@u2&> y"0jt;(4ڝ;wzB;%_} w"XMF_f3ewGLɟ||FZED~`Zz THRc䔓TzoyIО6E{Lzm~?:yxwQvyw FIz2R )]C+(JY<4 øpႜ:7D^MՒtlE!5&LJN:N63Gߵo!Nlmm...@brT>`pY<@UC-oqB'#]q"!u z/*@F}%¿*aJ_(P &DTtggg766{l-'ygqqNM>:::a=ޡ1zV%ؓbH=b#1` Y9$i3brRuaHMJs:DĭF0ɉ &2K۽1z.D`xCHI[yjH\N|=6ot:r~Z-jdBK㩺2 { Fi'_Aa˄Mc``_ȉ=Ԣlڷ<88(w} g\,kkk\*29n5 @\ՙI9-//)o*Gf=xCo*@C-{riJCZ*d@V#To!_ Nr,e_?왞i}U,B~ }[[[ HaKKK]Ej$-V+xXyrfǒg|5؁T0g_H7bccb-H.IW>h+LӔJ|9ib(Ek4fk`EZų*/urr"IZdJT: "BY[["pX!ք}_<_6z%y1U1q*O} Kwliȝƛųv]*/D6|KgonnN'SUg$ eǾH)@+s{&,M'狩@uKKK&.F<01;K%"Ε8n=עˊ=By.\&t~/;, +v63d*okb~~1lч9m<;Z34E&ܯ~%jY2\ɭ]gKF,Ǝ/سQiەdmeZ/1R]vܧyױ~s#0jA7/Swܑ}6Csu&.VWWs1_D@>ce候Ro}oq'wVS64zUsa)W P6;ZȰ[^V4/;==eEΤ%=;;Nmpqq srC~}ο[l6uQ W!5ns}u/|/6;[5ӡGVj 2wQ5%/F6D)iIy~~~nnz6 Cܽr+;*TSGz\ѐ8p;oY}7TguyBNjپY=PZ u(pez8g‹G<9IjHM^4 !aV㐋ŭFʀpr..9+Uq M g"JhwwIF $Y'D(wLՒ䒐v7CG-ClS0b(M@5Ýwcd'i |?4/1Ԣgwwwnnnyyla/imm;;;gff OL1Tp (`jHƥeƔʀ0'''1C-Iz֟[__\BN{+ ّ3NVU_kB8M u2IOSƥMXG~Lr{XВi(0^_A[n5)ѳtff).XX=zRk^>=/|C-.\`%/jJ\ko9J˾w5+93MS⅟y:bA%v$ņHAPښ(Pe\S4/0ԢBD%mYfV#UA~{Hγe) e~82OvL:pܖxeڴG2JhYZp-sf42GlNEmSБ98Bk,@agd7 .``^WU~uWџ _UW}߷{U|D]W՘ٜ2?fE*$ew߶N3gp:O^dh բͳ⛁{oj[R *fG ff"^()fEL`_[љӼwrއ%>`EKxaa+gccC|Oy íFEY0dd]Q'/..V#ƑqmI= *R">ErhFH\#|E^C*<:::??/e[rP+++!8ʗHHſmn4RK/^E v rtttyy%[QR:bsogccJ HW'N'^B̺^ԼE]C_t(#Ąy [2R+++ Uj3Z^Q/bAw 3nu_/&&UC\̇߱Yc~{,7PˁfhˁfhF_Ժ?\FæZ~?r/nl<4;޽rӹUer άifaAH|4?03s\|4n?!eY,!rHdˑ_ moOLLkt~TӠ-noq,ZiGC33ǏևGo_<,,4 H|Q_}jSVa-kk9_XN|xԿ:_BěTrH, j8+ŷw/=7S.en+W4 ^0PYPr%79AU_QFG߱x"K,,4 j!߈ [!Tt:333cccI&̧N O- ", C|OO_@I^ {K>,,4R6ɾLwTHUuH Z[pccc|||zznr er e-,#-t_j/O{uaS[[7r Vu9K{,bk"ԙ[uC rNW Z`ՏGGG{7 rXN!{|h̎]-ܝvjH|zCg%E}5kOvr15k0^f'/MKV;nSFa뵫JRڨקq#`\nr۳+++I\aTZ.\nr1sӋ'AF1,Qp둑enRud ~U\^X+L/֌TH2d|Aԋsl ^K#J +> rfW >6vFhur%Ɣf,^Xd,\-w痗O c_{FG߱X.Wk9/1ZIsz-[!Ifn{cN,kBZֹ֢P^o?|IսbYUҞb"VZ(W:J<ܠ~,j@V,W*ﯬCEs\/r rXrw&>ĻAY+vv6ƊVrE'0b#%l]kMZ1^1 n*0VlE>X _u o#m V-& +!\PʮXٙ[\\r %]?p]X. ˕rWWW׎jhlG΢XnqUU\A/g2:E)_ܩ2 cŪYV䃵QiUͩ)WݪwQRvR{ifZN|X_`fxXܜ8<gXrh-QX rX{͇U_FH.E\N֊/UWWWwvv oY+GT_ڏZNkI 40U]~H|v]-P$t^:j_faʫ~ 2_x",755%>s;NQ!"@4W@ۋbכ G|!rHY[Xut/1=/޷-gރ|nc9f_ W* 񑹱1;;;22255bir)>fa9YXnezb]&511PCE~\ ZonnP!>fa9YXn9I=AFr˙VVVVWWgŗ777,LQ!"@ZP!G|!rHfh<=}~6333NQ!"@2vvvVVVFFF'F"f4 !rH6&&56vu1|=[N|[W8ñ1a`, Hj111hNEg,,4 !\i6=:[;JrW\_ǧUqa`Ҭ"o~S_羚 37?!Ś0(m[W* |U@U3MR0GUrO￸##Wn?gXn;^;vv:_8OEDmLunRķ[bYʢr2C.8Wu]ƽ^\4%{f޻Z֥ޒnOTﮛ hv̽˥Q H|텅y[W\*ľךK%vKj業<ԗr".LUrJVNSY( Kom5Iلnl<43s 267>q[bX_(Vծ2Q⪲ݪLV 3O _x~o}_?K\N%"U/:MsB+azرc333W\)KW# Y8ng^OYUV)*o9R~!ߜRil,|}zd~hd*wsa&n^oپ4wvdoh6k1eZeK-ק?عٔXkzoQM2Q2,^'x\|sw+{,*=hP_~ y3ˋ7Z7U@)}ٜ,_؍U6f53^>lj9~vF܊}7XPU\r.5>=PZ𻛛A񍍇57c7 #py^,X VupFhLw-.uv+CFu ᐂ\&bIsG2y@'lomly {?%r#xAEl6'/[3H̕QthQZ,{4W7UAw\su7.[{5žR_L+LnU3silL:U1 ZfCW*bL~+b\+=kB+;iZx_|&lidz}j}c,'NjGrXa=POԝ/|@-7{{n~Gkgw5Bg+7U6(CrTUkLC3$o-sYrګU8 'n];7.Go=}ǟCl㽨U1O5s0{}9gRU1J\sbsh]-4W@)}uv"\4AzX_~7*km&b^,ke)㨈f2 ŷي+Q1X.#w Bk¾)\ZZnk­v}+W`m4;“_x;6ĖrQ+|cҧq{?uє^͇!}9_r(}3đ7w2\&U=soX}P߼Xx鏼ם彧o^7*HG恕_Y>}/X+y.;$(<|iqfg/yM x.#',S=;kwc%-uT%LC>uO3qkVmePW1B^lx,lEW,ի/w+{IkNgmaֱ'&޵p4EǴy?cbbvvvyyyuuDk>u'?ԧn?5!\2Tq6UD!bx~W\ceƏVO˕["/GoneF7/>l?:")6#.Iy,`s3V (sNs |*xM# VJZ._ܯ~[JO%rT0[-SThc+^ 2rWwbpY9\*RϗO" yj* yuov677Ԕ S=3<%g4}ꦯ!dl@9dЪj-6CBL[?/zo\#r~8:$0pV^r9*` _/nһNy{盽_=)W`cj9oϝF܏_3oډi&8gɞ,//LOOY~Z}_38'ﯛb[7^snARz HU2Qʪ2TG\&Io~w?;?}g8)_~\y'/cCe5;Pn,W߈kKT&K6wc%-uSmUh*".S# (Koj[. &HXQ1&1XWw9{*"x rQZnwwweeebbbllhTr_7=q {C|ﵿk$Mv29$sUDiSo}.; Zq >nӟG^~L{E<Yr!dH0P#,g!L-"7_yjSniX4l@/ƪZ.뼽W93ߙQ^l\>zyXٰ:8$$&(r)ݥqwF}S405rEk+WNLL.,,t:R[nʟ}o, _䟜!VZ.*~ m~.'j-/knumOŲXA ;g3D̻Yֆ_+TiuϤ–K8Sf6 χ mRQOM|+ba\Zwy:HSP4䳵|.ىqoo5"hŲ:$sUDiʀ}3O,,4 !*PuT$%bgm EHkBYbv?yJ,fP*R*,W%a9YXiCU ˡ*H;/=e [b?bHھ\7l9уP\n!ҳ"ݵ!|Q;u}xm&=c@z/f+G"o\j3脒M~!)"ԳT UIXiCfrJ*޺zL5" n[ԗ+N{O͕Fju{zXH/7醓8Ǖ<*e|VXYC~юz8i=#(d~!f#鈺$I%NnE MRZ5˩>ԯj s&VY-ÌG:*`l֓j9EOrqoi`r|83Ja˲puo9 ױ3]4ױR"x=JY")?ޠGfC!?e4~'NǠdsR]Y現yV V@»r͹*^g~9aƣLﶇR;:#&u.e; D%xTtScuobL@ s_;/.KC92TB=BjXC*Y?V#q[fg[~#<>/s>C_ei O6Wa+W9jf5ռ+s}qYv0g%-Xc\5Ď /O{!Sɕ^ ɰ;̵ָ߮ [/7"7_5c^:'Ud{ O)ƃf4b-/9pk<)Rfԇ+'Ez}ו&QyR rjOUOM~$yqK_m.bu=T35p(f}MIY&JdT9)Z)@.f s91Gm0`\tnO.\wb-X rOOwmٙ*Ϯ{"ջ1b-T1 t!њb َ,_yTZ1s V>Ξ?87;$,/v~3g_?ksV<+Cޘ_sDe_H>ꢪ ࠾xU+D; _o\hJ\.Os`*Z."P+ffU\w7|B2To*|8V3rai3cɽk{n1b-l:/mw>۸Cҳ5ݓ$/d/" SUHKe9R-h(W8Pϲ9j9%4R*>vT6_fee^E^w|?royppZ.WlՖ)kNXV(7T"'Я CȖCRdvܛj9~s>G_>-ϋt\1$=PE>7 ryOF~saJ[.'Yf?Kͪ`9Bf=\Z7gOʱ7@/Ιe\W/-A {fdVӞ=K{$RB胭{n|ΝyqY,mqc?t_tܻg -( r[L+}S $Bq4a1欦BHu!w,6*EߞErՕXܴm!?I}s9 grǫoJ*/V9pj???4n@mu@QBK_4o$>l*C9I|~q9~}-<ʢ|HNakT̰Rsѽ+U-Res333|r]`2𤎒 ͆r~kQ^U3XLEl&kh,WUNI努:e!& DXiBV*+'PU1sʕ_TfrRDX3\&C2CCE~\Q!rH,,4 !*zmɜR$0Zx0K>(/V@rH,,4 !*R I[_K~/W@lrH,,4 !*/& *,,4 !rH kEV`#Yho뻋_^zdϫ;hb9aWa+ TUa9YXiCfro]_=xJl& _H7rw/-rQwn՚Kxp~~@3J&C(يق2O")+lT.ar%DX.\&r5\3<3ޛm_Q6K~{L32 -xƏtFPױD*s~m .=$7~yR'r3oSa+e-,#,\\r1rYϹ1 @0^0* k/<"v2K~q5ϋ<>ۤ^1{J:ij!(-PB U ˩K),#,\\֪\=, Iss!B_]{ ZB󋛟6_W/q^,3t?]+륚DʢMpEQ1Np|&sͺZg\cDoWIՇ4wt{(zN6zqq27ha9,rX ָܹyw@e7&>cmٗܮy3sP1-@y>En ,#j^mvuA<+n^c ku:TE, Btܢᙷ|#Gu@>oJsKyXa9,rX}h]8K8%==,оv|Hghy۱WIDs) hdrι5y>q5o&֚\x0x$o;U?ڙ9+Ĺs>{[*?b?ŠJ4⺘;8 JU3a9,rXUrzɂM3)AuTmfC߻YK]w>v۝6_PlO+(߬K-}v |u  o(?Pfgs$oLm= Xa9,rXa[κRR7K[N83ê'. ƓPgjP;<# UrɔyC=*8yn?s/~bX,tI',Af<9j.ufNϼarXa9,\-<᱗̻A-ՙOXC*/n:ج8r2me:*ҧt[]믝;X(g"4QPo̤T`|E=uDԘ 4k#bj3rXa9,*n9LQ%S^ta-J^Dš46tc[/zRB^y$&d9ޤٞH5gU }ϝy)A64 V澜+#7i`5< \d=pa+ ,rXa9,Wec 9w=扱xX6aA(.nlsPa-ZE'zfIq1*R /,JXaTr ˥S:(,4?:ߑ]6BX.\r)K!,\ a5pi.a9Y/t{t;Zޑ]arY] ,PX.  eu\BaLfzfU?@E4 !rH,,4]y&:fEf dςa,rU UXiCfa9YXΕ_t'u3 #'PށN*- iCfa9YXis7JMڒ#A()U)0G,r,r5&Պ_u-H}Ž{ų:ử_[u^;+\76$p܄0o7kil-_ _Ճfod~!pomk^t-y2'nl!v iDIǏz8J]Xҍ< dfY  Ih@(#(y`UV g˸"83۶O2{AY^jaIzS.!7eގJe9 HBnqYM8CvhŹS0*fŐE/njJksI(Cx/n =#_\ A/`nL޿u?rbK2K6 tP$QC,b GG/[N`wJ"&+Q"1y3 ?7΋0eash<v[.zs;1kۣޝ1kh N蛵*l~'k<[44(& N!!o@{׈Biʓe_@_5&{Km6yPjiBest_Lm[N}p߮-̰R^>8 Hٴ;]rq_iwI>Ay'sQ#Pubr 9"> kLTkgξ~Rx(V[n2;Ҋnkv;&Qt10biU"(O_@_5&mw>۸CR;ܱ?0`X(`.$ĄƯn4tĮ2/"KiU"vEXcG_+Ͻ|їObg‡{toҊ]oZ;!qEJe/1J!(//"lswv̋bA< l37L p<)#P:E;nE^/b9Ta_@_D7&EbA{k!4#tb|^ԛRU^/i9TU_@_dט`kMFa/f_@_՘ZnWkM{ 5: . Y}6&)} CV:/iT%L,M@sfyYpNã4z m`環TN9 pRE&3 ##I-lBod0O_Bta9s-yj[svV#'@~1*l~RlӍ[v!t[m}פ[%wՕhn NCr"-|U=Xs-WyPޝΰ XRˑ_@j/SE/Sb3W_t[fߘ;6η0|q˃S@s{)vBU`}u}UҬ@9r;Cq;pHm9 HME&%w`ΏBE/-Ew7:5-_(mTϦ/Tz;uDD=ĺppv//4\EY)Ȱ"N1_DL!uم<$3j 9 hzkIu81 >ܔaϽuدC?B~ay G$SP&/SP&/SP&/SP&/SP&/SP&FFߥq_@ѩb(U 4{7~~/8GP&/}L.VXȽg_@=[+9T{5Yom//Ld0~du2oc]k;ZPj_@/:yp6|a>K{yGg>{~ o Р.8=fw3Ԫ;=)֚k ڭ<2El<* (a}/}s;Oغ =,t c#\kMJ[!іD~U',x۩Μ}YPTl:~2H;2 xvi$(/L|;mwCXؗ_xKO"](2Q //G_+Ͻ|їObbc@gf1/ŠE"21[]믝;X[ 4U=)p7ZP&z/O y…n`RoICTLsMOg iT?6#}Dt~1`!Zt(/L/|"Q߸D42#}ʄޡ"I_킱TE"2/L_ /L_ /L_ /L_ /L?po;\뱐M[7j]kJD~eBS~NhiӬ5;V agV_/l?$Do~ujrִVE7v wݪOZviPcXaY){Hf7/,?$DW+_%x0#=aTg;#OxJVw}U8[{lr@~~s3/@~:G).4–BZcm)OwƏI/.O/q1F M}@SSSyE)!lGQJ/4lQ Moll}@ӝN'(%rJGQJ/4Q N\266Q t:鼏_`ccc~~>(+:X6( fgg777>B~_`ttt?(+رcyE!8yE!8[[[z=(1g}}}aa!(1gqqqee%(1gvvvss3(1gjjj{{;(1ĻjC8q)#GG* g.?*/SB~) p!@ i~Tu/Ӧ6 /"ujnVݎ0/zT+N kZ^v;K{ח_R z9Vv}x;mۻEWJ\iO (l}E~./ֻ2P&γflM IJYCl[ZD'VZ(W:JԔVR"ltF Vpך4GzƳ2Q~,$0(leX חOR8Vtvn<\Z#B~ƘBJ)_0QRV?J06Ns1Sm|{ R J*)CwMHA)% m$u tOuBP@0S"N}=|SOz/=p7P]&[{}fNRo 3s~翼/-@3p vn$5i;YX_ pX~'w<[`W{?9[yo<}0|Tw3/:sR sx&uRafTl6'/)/b 'n];7.ڏ_MSGzn?q^_X2Y~rZ/:*V[*-XHw__U8/b{<V_yC!y;w{Odo_f ğL.J"`!#I^U-_KVO˕["_zʌo^|noxuv/gocߑ‘D/boo}_'N[ijƪY3=zc.V ԛ!w["SȈ0 y퉓Xk~n/|(UazVW_@թd~qd $腻w?!~u4l@R]B~) p!@_b\/P1E~." TL_ */dR6ב-6=v.|ޜ\J_[/m{ fd[㴓ۭd5gGi9-nfYcWY_ڳVZYB5uחZ҂o_Z#̵Zf^[`w;Ә/@ /(:M;p\y9"ך4wgW6BY㐤8T8o{$K:?K,x9`'|wQ1_._(#c),0_9Mz'"0{"Yѭ |TgNCO%F~!E"`&/1J4x6Z+= EQS5ˣ// p!(/%_b\/P1E~." TL_U5!鸔`ةR5_*/SB~) paN(& .5_BF p @_b\GiK۷"K7՟<%roߢj\Ko \/{^[mkSs_!ʕZך8Z-sDt";ZŊ\38tj"V K{y7Q/%6?|g6CE֬M&&vno%[IXf\nՍ]09D[߸ ׿a(Bvn1"8"](6+KRʳ솔 & 8 Xpr\bZ&#0P1E~.Ð_}.&G! pTEID~.C_҉\/P1E~." TL_ */%bon4K|L4^#kM8vRvvJkVq$\4=ã_" P7#y_bY>v^k6jU֗Ӭ5;:i/%:OB ,^nIZуh'h;_` _tã,;_@|g/8/Cf~6NiC7bP<Sv x՚4Z@L~q#vgm)^kٲogOZ> ٗ|svS\iwdiƠU0pΞ7qގ4 !,/ݶxn [C2sw@GIl5tn.K[v_li7=+G5n~F!cߝ,e,0niN*ؗTlw'0sHO7zK_@aNϼvg-uΊbrcO]9@&헻aoK ,W-+Kކ@ΕzG^$) 7V*O_|qߥ /bKOmJF*#H&Dw(~ѭC!"seupRS yF~a'/>r^9}ӏ|Z,_+-mvYH_mw_Rv%P 7窛;L:f / GX~!=7>ykμ,C6(N2E)ɽ3/2DB/g&pT\YfCS .S8_@vDB^yT7X6}wLxOtmr&.>PK*Z?C8WNݹR ob$N:#ϛvF~!DgYX}rK"ӡ:4UG_ N삱g9`_ */SB~) pJuMt\J~E!POIENDB`java-design-patterns-1.16.0/intercepting-filter/etc/intercepting-filter.ucls000066400000000000000000000323101312550536300272260ustar00rootroot00000000000000 java-design-patterns-1.16.0/intercepting-filter/etc/intercepting-filter.urm.puml000066400000000000000000000043721312550536300300460ustar00rootroot00000000000000@startuml left to right direction package com.iluwatar.intercepting.filter { abstract class AbstractFilter { - next : Filter + AbstractFilter() + AbstractFilter(next : Filter) + execute(order : Order) : String + getLast() : Filter + getNext() : Filter + setNext(filter : Filter) } class AddressFilter { + AddressFilter() + execute(order : Order) : String } class App { + App() + main(args : String[]) {static} } class ContactFilter { + ContactFilter() + execute(order : Order) : String } class DepositFilter { + DepositFilter() + execute(order : Order) : String } interface Filter { + execute(Order) : String {abstract} + getLast() : Filter {abstract} + getNext() : Filter {abstract} + setNext(Filter) {abstract} } class FilterChain { - chain : Filter + FilterChain() + addFilter(filter : Filter) + execute(order : Order) : String } class FilterManager { - filterChain : FilterChain + FilterManager() + addFilter(filter : Filter) + filterRequest(order : Order) : String } class NameFilter { + NameFilter() + execute(order : Order) : String } class Order { - address : String - contactNumber : String - depositNumber : String - name : String - order : String + Order() + Order(name : String, contactNumber : String, address : String, depositNumber : String, order : String) + getAddress() : String + getContactNumber() : String + getDepositNumber() : String + getName() : String + getOrder() : String + setAddress(address : String) + setContactNumber(contactNumber : String) + setDepositNumber(depositNumber : String) + setName(name : String) + setOrder(order : String) } class OrderFilter { + OrderFilter() + execute(order : Order) : String } ~class DListener { ~ DListener() + actionPerformed(e : ActionEvent) } } AbstractFilter --> "-next" Filter DListener --+ Target FilterChain --> "-chain" Filter FilterManager --> "-filterChain" FilterChain AbstractFilter ..|> Filter AddressFilter --|> AbstractFilter ContactFilter --|> AbstractFilter DepositFilter --|> AbstractFilter NameFilter --|> AbstractFilter OrderFilter --|> AbstractFilter @enduml java-design-patterns-1.16.0/intercepting-filter/pom.xml000066400000000000000000000036121312550536300231250ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 intercepting-filter junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/intercepting-filter/src/000077500000000000000000000000001312550536300223755ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/000077500000000000000000000000001312550536300233215ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/000077500000000000000000000000001312550536300242425ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/000077500000000000000000000000001312550536300250205ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300266505ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/000077500000000000000000000000001312550536300313435ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/000077500000000000000000000000001312550536300326305ustar00rootroot00000000000000AbstractFilter.java000066400000000000000000000035641312550536300363350ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Base class for order processing filters. Handles chain management. * */ public abstract class AbstractFilter implements Filter { private Filter next; public AbstractFilter() {} public AbstractFilter(Filter next) { this.next = next; } @Override public void setNext(Filter filter) { this.next = filter; } @Override public Filter getNext() { return next; } @Override public Filter getLast() { Filter last = this; while (last.getNext() != null) { last = last.getNext(); } return last; } @Override public String execute(Order order) { if (getNext() != null) { return getNext().execute(order); } else { return ""; } } } AddressFilter.java000066400000000000000000000031661312550536300361550ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter This filter is responsible for checking/filtering the input in * the address field. * * @author joshzambales * */ public class AddressFilter extends AbstractFilter { @Override public String execute(Order order) { String result = super.execute(order); if (order.getAddress() == null || order.getAddress().isEmpty()) { return result + "Invalid address! "; } else { return result; } } } App.java000066400000000000000000000062111312550536300341340ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * * When a request enters a Web application, it often must pass several entrance tests prior to the * main processing stage. For example, - Has the client been authenticated? - Does the client have a * valid session? - Is the client's IP address from a trusted network? - Does the request path * violate any constraints? - What encoding does the client use to send the data? - Do we support * the browser type of the client? Some of these checks are tests, resulting in a yes or no answer * that determines whether processing will continue. Other checks manipulate the incoming data * stream into a form suitable for processing. *

* The classic solution consists of a series of conditional checks, with any failed check aborting * the request. Nested if/else statements are a standard strategy, but this solution leads to code * fragility and a copy-and-paste style of programming, because the flow of the filtering and the * action of the filters is compiled into the application. *

* The key to solving this problem in a flexible and unobtrusive manner is to have a simple * mechanism for adding and removing processing components, in which each component completes a * specific filtering action. This is the Intercepting Filter pattern in action. *

* In this example we check whether the order request is valid through pre-processing done via * {@link Filter}. Each field has its own corresponding {@link Filter} *

* * @author joshzambales * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { FilterManager filterManager = new FilterManager(); filterManager.addFilter(new NameFilter()); filterManager.addFilter(new ContactFilter()); filterManager.addFilter(new AddressFilter()); filterManager.addFilter(new DepositFilter()); filterManager.addFilter(new OrderFilter()); Client client = new Client(); client.setFilterManager(filterManager); } } Client.java000066400000000000000000000102131312550536300346270ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; import java.awt.BorderLayout; import java.awt.GridLayout; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import javax.swing.JButton; import javax.swing.JFrame; import javax.swing.JLabel; import javax.swing.JPanel; import javax.swing.JRootPane; import javax.swing.JTextArea; import javax.swing.JTextField; import javax.swing.SwingUtilities; /** * The Client class is responsible for handling the input and running them through filters inside * the {@link FilterManager}. * * This is where {@link Filter}s come to play as the client pre-processes the request before being * displayed in the {@link Target}. * * @author joshzambales * */ public class Client extends JFrame { private static final long serialVersionUID = 1L; private FilterManager filterManager; private JLabel jl; private JTextField[] jtFields; private JTextArea[] jtAreas; private JButton clearButton; private JButton processButton; /** * Constructor */ public Client() { super("Client System"); setDefaultCloseOperation(EXIT_ON_CLOSE); setSize(300, 300); jl = new JLabel("RUNNING..."); jtFields = new JTextField[3]; for (int i = 0; i < 3; i++) { jtFields[i] = new JTextField(); } jtAreas = new JTextArea[2]; for (int i = 0; i < 2; i++) { jtAreas[i] = new JTextArea(); } clearButton = new JButton("Clear"); processButton = new JButton("Process"); setup(); } private void setup() { setLayout(new BorderLayout()); JPanel panel = new JPanel(); add(jl, BorderLayout.SOUTH); add(panel, BorderLayout.CENTER); panel.setLayout(new GridLayout(6, 2)); panel.add(new JLabel("Name")); panel.add(jtFields[0]); panel.add(new JLabel("Contact Number")); panel.add(jtFields[1]); panel.add(new JLabel("Address")); panel.add(jtAreas[0]); panel.add(new JLabel("Deposit Number")); panel.add(jtFields[2]); panel.add(new JLabel("Order")); panel.add(jtAreas[1]); panel.add(clearButton); panel.add(processButton); clearButton.addActionListener(new ActionListener() { @Override public void actionPerformed(ActionEvent e) { for (JTextArea i : jtAreas) { i.setText(""); } for (JTextField i : jtFields) { i.setText(""); } } }); processButton.addActionListener(new ActionListener() { @Override public void actionPerformed(ActionEvent e) { Order order = new Order(jtFields[0].getText(), jtFields[1].getText(), jtAreas[0].getText(), jtFields[2].getText(), jtAreas[1].getText()); jl.setText(sendRequest(order)); } }); JRootPane rootPane = SwingUtilities.getRootPane(processButton); rootPane.setDefaultButton(processButton); setVisible(true); } public void setFilterManager(FilterManager filterManager) { this.filterManager = filterManager; } public String sendRequest(Order order) { return filterManager.filterRequest(order); } } ContactFilter.java000066400000000000000000000035161312550536300361620ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter This filter checks for the contact field in which it checks if * the input consist of numbers and it also checks if the input follows the length constraint (11 * digits) * * @author joshzambales * */ public class ContactFilter extends AbstractFilter { @Override public String execute(Order order) { String result = super.execute(order); if (order.getContactNumber() == null || order.getContactNumber().isEmpty() || order.getContactNumber().matches(".*[^\\d]+.*") || order.getContactNumber().length() != 11) { return result + "Invalid contact number! "; } else { return result; } } } DepositFilter.java000066400000000000000000000031251312550536300361720ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter This checks for the deposit code * * @author joshzambales * */ public class DepositFilter extends AbstractFilter { @Override public String execute(Order order) { String result = super.execute(order); if (order.getDepositNumber() == null || order.getDepositNumber().isEmpty()) { return result + "Invalid deposit number! "; } else { return result; } } } Filter.java000066400000000000000000000033371312550536300346470ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Filters perform certain tasks prior or after execution of request by request handler. In this * case, before the request is handled by the target, the request undergoes through each Filter * * @author joshzambales * */ public interface Filter { /** * Execute order processing filter. */ String execute(Order order); /** * Set next filter in chain after this. */ void setNext(Filter filter); /** * Get next filter in chain after this. */ Filter getNext(); /** * Get last filter in the chain. */ Filter getLast(); } FilterChain.java000066400000000000000000000034101312550536300356020ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Filter Chain carries multiple filters and help to execute them in defined order on target. * * @author joshzambales */ public class FilterChain { private Filter chain; /** * Constructor */ public FilterChain() { } /** * Adds filter */ public void addFilter(Filter filter) { if (chain == null) { chain = filter; } else { chain.getLast().setNext(filter); } } /** * Execute filter chain */ public String execute(Order order) { if (chain != null) { return chain.execute(order); } else { return "RUNNING..."; } } } FilterManager.java000066400000000000000000000030741312550536300361400ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Filter Manager manages the filters and {@link FilterChain}. * * @author joshzambales * */ public class FilterManager { private FilterChain filterChain; public FilterManager() { filterChain = new FilterChain(); } public void addFilter(Filter filter) { filterChain.addFilter(filter); } public String filterRequest(Order order) { return filterChain.execute(order); } } NameFilter.java000066400000000000000000000032321312550536300354420ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter. This filter checks if the input in the Name field is valid. * (alphanumeric) * * @author joshzambales * */ public class NameFilter extends AbstractFilter { @Override public String execute(Order order) { String result = super.execute(order); if (order.getName() == null || order.getName().isEmpty() || order.getName().matches(".*[^\\w|\\s]+.*")) { return result + "Invalid name! "; } else { return result; } } } Order.java000066400000000000000000000045561312550536300345010ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Order class carries the order data. * */ public class Order { private String name; private String contactNumber; private String address; private String depositNumber; private String order; public Order() {} /** * Constructor */ public Order(String name, String contactNumber, String address, String depositNumber, String order) { this.name = name; this.contactNumber = contactNumber; this.address = address; this.depositNumber = depositNumber; this.order = order; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getContactNumber() { return contactNumber; } public void setContactNumber(String contactNumber) { this.contactNumber = contactNumber; } public String getAddress() { return address; } public void setAddress(String address) { this.address = address; } public String getDepositNumber() { return depositNumber; } public void setDepositNumber(String depositNumber) { this.depositNumber = depositNumber; } public String getOrder() { return order; } public void setOrder(String order) { this.order = order; } } OrderFilter.java000066400000000000000000000030731312550536300356400ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter. This checks for the order field. * * @author joshzambales * */ public class OrderFilter extends AbstractFilter { @Override public String execute(Order order) { String result = super.execute(order); if (order.getOrder() == null || order.getOrder().isEmpty()) { return result + "Invalid order! "; } else { return result; } } } Target.java000066400000000000000000000062501312550536300346450ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; import java.awt.BorderLayout; import java.awt.Dimension; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import javax.swing.JButton; import javax.swing.JFrame; import javax.swing.JPanel; import javax.swing.JRootPane; import javax.swing.JScrollPane; import javax.swing.JTable; import javax.swing.SwingUtilities; import javax.swing.table.DefaultTableModel; /** * This is where the requests are displayed after being validated by filters. * * @author mjoshzambales * */ public class Target extends JFrame { private static final long serialVersionUID = 1L; private JTable jt; private JScrollPane jsp; private DefaultTableModel dtm; private JButton del; /** * Constructor */ public Target() { super("Order System"); setDefaultCloseOperation(EXIT_ON_CLOSE); setSize(640, 480); dtm = new DefaultTableModel(new Object[] {"Name", "Contact Number", "Address", "Deposit Number", "Order"}, 0); jt = new JTable(dtm); del = new JButton("Delete"); setup(); } private void setup() { setLayout(new BorderLayout()); JPanel bot = new JPanel(); add(jt.getTableHeader(), BorderLayout.NORTH); bot.setLayout(new BorderLayout()); bot.add(del, BorderLayout.EAST); add(bot, BorderLayout.SOUTH); jsp = new JScrollPane(jt); jsp.setPreferredSize(new Dimension(500, 250)); add(jsp, BorderLayout.CENTER); del.addActionListener(new DListener()); JRootPane rootPane = SwingUtilities.getRootPane(del); rootPane.setDefaultButton(del); setVisible(true); } public void execute(String[] request) { dtm.addRow(new Object[] {request[0], request[1], request[2], request[3], request[4]}); } class DListener implements ActionListener { @Override public void actionPerformed(ActionEvent e) { int temp = jt.getSelectedRow(); if (temp == -1) { return; } int temp2 = jt.getSelectedRowCount(); for (int i = 0; i < temp2; i++) { dtm.removeRow(temp); } } } } java-design-patterns-1.16.0/intercepting-filter/src/test/000077500000000000000000000000001312550536300233545ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/000077500000000000000000000000001312550536300242755ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/000077500000000000000000000000001312550536300250535ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300267035ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/intercepting/000077500000000000000000000000001312550536300313765ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/000077500000000000000000000000001312550536300326635ustar00rootroot00000000000000AppTest.java000066400000000000000000000025111312550536300350260ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; import org.junit.Test; /** * * Application test. * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } FilterManagerTest.java000066400000000000000000000046641312550536300370410ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.mockito.Matchers.any; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.times; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyZeroInteractions; import static org.mockito.Mockito.when; /** * Date: 12/13/15 - 3:01 PM * * @author Jeroen Meulemeester */ public class FilterManagerTest { @Test public void testFilterRequest() throws Exception { final Target target = mock(Target.class); final FilterManager filterManager = new FilterManager(); assertEquals("RUNNING...", filterManager.filterRequest(mock(Order.class))); verifyZeroInteractions(target); } @Test public void testAddFilter() throws Exception { final Target target = mock(Target.class); final FilterManager filterManager = new FilterManager(); verifyZeroInteractions(target); final Filter filter = mock(Filter.class); when(filter.execute(any(Order.class))).thenReturn("filter"); filterManager.addFilter(filter); final Order order = mock(Order.class); assertEquals("filter", filterManager.filterRequest(order)); verify(filter, times(1)).execute(any(Order.class)); verifyZeroInteractions(target, filter, order); } }FilterTest.java000066400000000000000000000121661312550536300355420ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.ArrayList; import java.util.List; import static junit.framework.TestCase.assertSame; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; /** * Date: 12/13/15 - 2:17 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class FilterTest { private static final Order PERFECT_ORDER = new Order("name", "12345678901", "addr", "dep", "order"); private static final Order WRONG_ORDER = new Order("name", "12345678901", "addr", "dep", ""); private static final Order WRONG_DEPOSIT = new Order("name", "12345678901", "addr", "", "order"); private static final Order WRONG_ADDRESS = new Order("name", "12345678901", "", "dep", "order"); private static final Order WRONG_CONTACT = new Order("name", "", "addr", "dep", "order"); private static final Order WRONG_NAME = new Order("", "12345678901", "addr", "dep", "order"); @Parameters public static List getTestData() { final List testData = new ArrayList<>(); testData.add(new Object[]{new NameFilter(), PERFECT_ORDER, ""}); testData.add(new Object[]{new NameFilter(), WRONG_NAME, "Invalid name!"}); testData.add(new Object[]{new NameFilter(), WRONG_CONTACT, ""}); testData.add(new Object[]{new NameFilter(), WRONG_ADDRESS, ""}); testData.add(new Object[]{new NameFilter(), WRONG_DEPOSIT, ""}); testData.add(new Object[]{new NameFilter(), WRONG_ORDER, ""}); testData.add(new Object[]{new ContactFilter(), PERFECT_ORDER, ""}); testData.add(new Object[]{new ContactFilter(), WRONG_NAME, ""}); testData.add(new Object[]{new ContactFilter(), WRONG_CONTACT, "Invalid contact number!"}); testData.add(new Object[]{new ContactFilter(), WRONG_ADDRESS, ""}); testData.add(new Object[]{new ContactFilter(), WRONG_DEPOSIT, ""}); testData.add(new Object[]{new ContactFilter(), WRONG_ORDER, ""}); testData.add(new Object[]{new AddressFilter(), PERFECT_ORDER, ""}); testData.add(new Object[]{new AddressFilter(), WRONG_NAME, ""}); testData.add(new Object[]{new AddressFilter(), WRONG_CONTACT, ""}); testData.add(new Object[]{new AddressFilter(), WRONG_ADDRESS, "Invalid address!"}); testData.add(new Object[]{new AddressFilter(), WRONG_DEPOSIT, ""}); testData.add(new Object[]{new AddressFilter(), WRONG_ORDER, ""}); testData.add(new Object[]{new DepositFilter(), PERFECT_ORDER, ""}); testData.add(new Object[]{new DepositFilter(), WRONG_NAME, ""}); testData.add(new Object[]{new DepositFilter(), WRONG_CONTACT, ""}); testData.add(new Object[]{new DepositFilter(), WRONG_ADDRESS, ""}); testData.add(new Object[]{new DepositFilter(), WRONG_DEPOSIT, "Invalid deposit number!"}); testData.add(new Object[]{new DepositFilter(), WRONG_ORDER, ""}); testData.add(new Object[]{new OrderFilter(), PERFECT_ORDER, ""}); testData.add(new Object[]{new OrderFilter(), WRONG_NAME, ""}); testData.add(new Object[]{new OrderFilter(), WRONG_CONTACT, ""}); testData.add(new Object[]{new OrderFilter(), WRONG_ADDRESS, ""}); testData.add(new Object[]{new OrderFilter(), WRONG_DEPOSIT, ""}); testData.add(new Object[]{new OrderFilter(), WRONG_ORDER, "Invalid order!"}); return testData; } private final Filter filter; private final Order order; private final String result; /** * Constructor */ public FilterTest(Filter filter, Order order, String result) { this.filter = filter; this.order = order; this.result = result; } @Test public void testExecute() throws Exception { final String result = this.filter.execute(this.order); assertNotNull(result); assertEquals(this.result, result.trim()); } @Test public void testNext() throws Exception { assertNull(this.filter.getNext()); assertSame(this.filter, this.filter.getLast()); } } OrderTest.java000066400000000000000000000045311312550536300353650ustar00rootroot00000000000000java-design-patterns-1.16.0/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.intercepting.filter; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/13/15 - 2:57 PM * * @author Jeroen Meulemeester */ public class OrderTest { private static final String EXPECTED_VALUE = "test"; @Test public void testSetName() throws Exception { final Order order = new Order(); order.setName(EXPECTED_VALUE); assertEquals(EXPECTED_VALUE, order.getName()); } @Test public void testSetContactNumber() throws Exception { final Order order = new Order(); order.setContactNumber(EXPECTED_VALUE); assertEquals(EXPECTED_VALUE, order.getContactNumber()); } @Test public void testSetAddress() throws Exception { final Order order = new Order(); order.setAddress(EXPECTED_VALUE); assertEquals(EXPECTED_VALUE, order.getAddress()); } @Test public void testSetDepositNumber() throws Exception { final Order order = new Order(); order.setDepositNumber(EXPECTED_VALUE); assertEquals(EXPECTED_VALUE, order.getDepositNumber()); } @Test public void testSetOrder() throws Exception { final Order order = new Order(); order.setOrder(EXPECTED_VALUE); assertEquals(EXPECTED_VALUE, order.getOrder()); } } java-design-patterns-1.16.0/interpreter/000077500000000000000000000000001312550536300201735ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/README.md000066400000000000000000000036551312550536300214630ustar00rootroot00000000000000--- layout: pattern title: Interpreter folder: interpreter permalink: /patterns/interpreter/ pumlid: JSf13eCm30NHgz034E-vZGaM62Kcih_BzQ6xxjv8yr6hBJT9RzC1Z5Y8dE-oAuvSCyJhPH13gLSdRNapsEdaBy-RXEus3mR4BQXpl21zVnykFmlgVvVqNaRszW00 categories: Behavioral tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Intent Given a language, define a representation for its grammar along with an interpreter that uses the representation to interpret sentences in the language. ![alt text](./etc/interpreter_1.png "Interpreter") ## Applicability Use the Interpreter pattern when there is a language to interpret, and you can represent statements in the language as abstract syntax trees. The Interpreter pattern works best when * the grammar is simple. For complex grammars, the class hierarchy for the grammar becomes large and unmanageable. Tools such as parser generators are a better alternative in such cases. They can interpret expressions without building abstract syntax trees, which can save space and possibly time * efficiency is not a critical concern. The most efficient interpreters are usually not implemented by interpreting parse trees directly but by first translating them into another form. For example, regular expressions are often transformed into state machines. But even then, the translator can be implemented by the Interpreter pattern, so the pattern is still applicable ## Real world examples * [java.util.Pattern](http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html) * [java.text.Normalizer](http://docs.oracle.com/javase/8/docs/api/java/text/Normalizer.html) * All subclasses of [java.text.Format](http://docs.oracle.com/javase/8/docs/api/java/text/Format.html) * [javax.el.ELResolver](http://docs.oracle.com/javaee/7/api/javax/el/ELResolver.html) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/interpreter/etc/000077500000000000000000000000001312550536300207465ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/etc/interpreter.png000066400000000000000000000646471312550536300240400ustar00rootroot00000000000000PNG  IHDR{/inIDATxop$W};HrR+W܇QL£'#086 C ^ǔ-6hױ)5I=yVck]f=Uv:&P KQEmț}OtL}>-ӧKjeg'q H&@%`8卭WBZR&BEDD(n!TE('Bu *ED8-[UQD.B% ljPnqB"r*Q8΢9_MOӣl5"TjP8V%5U \kֽh!T׭ADVC ǙQVm2//7jǛHB>}=eU("T]8ζ k)Y֫%غRCۋ62(RɤvQm/[FP%Tۈ-I&iL[P ]lI,yXT;9̺oN-)mGn"ڕrn%Bz6뷗p Jlo[ -qI56BEHa+ieR oGq2Hjͬ뷋p,<85b}K>FM-cs>n"hԮT欽n%Bz6뷗j8vP^&˭xL6˴ݎiM]IeUBܒDlp>.(VJYl5`;mI( ۏu65~ +d_\ E*bs Yk~ԛJI\&)qk>׭ P"r98+[UQD.B% ljPnqB"r*Q8NrBUPq"[\\J⺅PE"Tp-("D(n!TEw~_G?YeMB׭E`-P0ʫw{Ta#Y >eٰ3ai)z1]U0Ok3P qREfRjbv32"rREG]FBbd)E|d|ʿ~O>y{w:ʅ-J[3qF=E˪Ue[pBtsI%*u~FpR$//r748װFc\)V7.l]X%qX}L5\/S mL۽rp,:%k8NB2Xg?gOsD/p_~7)?xAy֧w/lTpANm4 Ze7~j0TgwM&"#nԫ)t[Υ:fsw身Uܪ֛k[4_Quc>0_ǩZ3~PYb()Cj'x+#"{ xt@%́ =GAu-|_{op~LG}N'lm_KK':0mA~$wfu(!T[R6u0lU[5[jMiwJ6 XRFv! ڠ:+0^þ.?p{G"YbW#bc^x@qϽi9.Um"ݠ>ըSoܗU0s H\ɭz.n¼`!U[5[je,ҪΚPRJSV ^#Ev!'A=GAurŏrQ.7^8!z굓Ϝ}n,MR Km8-Ւ5kZ}ͨFg )WYrwLqTWL %5g@""{ a)8B qWy.w~?[i?.;o\ J-(7[Vh"{/KUP `_C ٝ ~ ׭"T%"DMf>ӟ5>%{5T疲9SˍlMNLb+i:}՟$]{M}Qբ;rޚo6Sl(5yw>gtwr__nR*+݉$6Rm{8Nz%/XV:%5XޙBŚم3Uo-P_kg)4^kD9@/5;iRȑVD=ۅMb[mǩ~f\7gH3aiYeHM65WwDVӧfWF7#A׭^P%T{)"sf6ӽ_QDZz*n+Ck>AJ~b$X&K)MuW"T ^\&ٵjqrs|ݿ-so^ %wZ&JYJ m4qUB"r;Ilv80Jlcw7Ji: %Vå3ݴlWj6~İ~6)Kug"T B&٭|Un7.%TR6AjRh񂾥&o_)#m4]k9Yd*/0{&[JJDnw"6ͮT6(vRu $B+g"6 lj^%T*IjW"rQDl⺅PE"Tp-("D(n!TE('Bu *ED[kH,b+\Q:N2FM BPѪP^qB"r*Q8NrBUPq"[\\Jq T"D9Pnը)A"r*Q5Z+[UQD.B% ljPnqB"r*Q;έ];KW~<AnD"Tu{^K?}RJ?J\M""r*Q8N%?$z ]M|85 ~r᯴6ۑE("7:Ʋ^f.lnˆ-"UonvT'Ez8Vu+zRlM͢~WS$B!i5S[ĦSfMk1r?c:;t @%:{׏G/ʴ,l8WӹPw,{fp Xnl~3VObǩk1r?Zӹuܮ4Z0{781YJL)ߗ gߋį[ϩ5֔uٺښin$.!:lz8V>uia Wbw6?Ax:Y6:٣.lLb3-'|Kw֔맗P6\g#7YَqᑽϜ}qy)+uߗR Lhˢu)aͿɂRFC?ībiݫn׉ w WۃDNӤ3}hfU/D3E.=m:}ˇ]KY m_b>:1lbOV톾E{]GvG/43`ΖP[ǦKv.'f r?\: @mw;{ӳֽW^Y_J{o˛=ø6ݎOUcNOKWǥn9#l*s8Uns2l`Fn\\:pew|p}G^\8rjYؽ2-+/Nc:NRS=&2&/!?Z/>\ M SS]Ul΀FnL\:p2֕:]?~#?( 2ז햣m MPkT7pt\;ZNORwæ"5l*t8 VLl&F_ ;N"e5p6rYٖHw?YH '[M{o [ i]MCqζ^Zly:1?᤿\PQnkpB=¦z苘KXv?\hk r&ť'WJz]6GHk zz*C~ "!r?1hd@g)Zntx16p6SۚNg.p [L @9*+ =NelOJVm馂Ȳa5p܁mNxljP1⺅PE"Tp-("D(n!TE('Bu *ED8-[UQD.B%g/wDdL2 WU[ubSDnQ"rQ{g ics?DA1U.b ܂vANԉw3,ec#ȮaT5{"6Jۡ\Tr;~Ͼ~y&s1O奬 m*j^_8xV5sd+j U@vjWOϑa,x"6j+"E%*|C~ay)+Cw'iE' ewvfm~܄ualx"6j+"E%*[}RV6KJXɎ<9Erb.6R3-[&BmEDs|p}G^\8rjYؽ2-+C勍XK n,s Խ nKqiu㷯>r /۴/j}}Y{SVkIƏoIdukD\"܎St9qmnnQulT0-.."~T] #dukD(U܋/D.qQad죈MT=-rϝ;Tw111B"4 Il*{…ՙu"!_q*3r+DUT/"ٳv\YY rpljq"TENuܙ3g\҅D(pUQ]FJ1b1'N?E(p*O)R]v-..={E8-'BUT]__^]]pP7q"[8NXYYرcG^_ZZ:EHXr;+O> qh`܋/:ՙ###333kkkM:Vgj.˂K^g+'hTUIl-?r';ՙ "uNǜdAARLH%2ü} 08Mtw%|NfQnytok=Zvajl9l}y~SNРLIl(gZ\sϞ'=%rQU8g>鸼B1 ?H~(+}څL 0Dz1H0˦]XJh9)7F@Ilׅ /džslss7ZV"r\T97=P?tj2YTlwW*2YoP {30zcT n&:symv]64kO8pD.JT>ǹί<=l+奬 mPYI/gIq-[=ĺ.[&=%RKq5qLژ%rQ8o;pS {eZV6k{7O QG%RFrRo -bV[97wػszcqKm?EDskw]+z,6jŸljݳXU nb[Jd=NcT nmkccme徉;vƮ]-.ySR r\Tr;N> $@j"6QV;,-:ՙ.Y5'k4[D.*F8պ"4Pؘ͢sLŋ][;:3s;FG{vvLJq/^\YY!r qz; K $a\KFFFz/!6 *Wg>4[ڱ7&&vܷns{Y羔-<'rljP?n9::z hyBvvǢ7j&''^tii{C"D([Ν;|/d& 'Skqݦsʝ={VWW\T8ʭօ wQPNHwimJ?[)B1۹?RkpqHԋ˔__N.()4ö OWva_il6FKY!Kt}Nɩ_I]F$W%\:N]cg|@U kg_hSo\)8Mq 1UR{gN=dIN84l8tl:*Uv7uDS֔?9>qͶܖo{;{A p]i6J1oIP]:+64ww׽tMW6wԂ ,^)|e-_ 44wmH1_xҖϒPE8lW''9'Nc"4ʧϦsqKx6kM;,{ڈmج/w6OvcZbGv#ͦerU^ ޺M^vtSMh+h۷^_w V.ҕn"߆iYy7|\mʻVk35ͭ>>C@$zEr9quFu=8`r`;u@٧NEEBSj}ӡ-s;JϺɖ?wgGcYAk]7~EcxSE͐Cy}rۖh-slOr㧣Me&-Cܔq*9ѧ)Ethh(CTm2{666fff5{|զ0'BMVo*;HoxQ69dv}}/kCYֿru,fuTV. ӴoA `kiR͛eGstSEw(w###bgT~`uceeŜtE3:@ 8N0RLgo+;&)y7T3Y20Rǩ:NS %cW8]\B=q`e:άSLLQEɐD LզDb4n UWR*hFH fQ]NTć/}Ўѣ7%Ϧ5F>eq$puuSnOgՕ.w܊K1ڏ~6+86+2[{ۋ]RL՚8g).3-UH̒F LƆay0yz p`eΞTv&Uc pF4tJ"y6tn݆!W[?AOg%ӓ|_Ƚ"tO)►YlW`Nj/b{'^tVsvvftBq.f_}A(ICz.Lq=]ۢ*Ih<ćދӭ\ꪔa'|L.(a)%W:L F}k;sp[e<[;nn-ؽQU9]-IPx;JڷVVV&&&:PÎnyϮ]ts$:TeJ<@pGYo4IvCofy矻r7TW՛X5nT}4pJmzʹhb7z9JGXx*CU[ț|9Cu8:Rto}Ee^2oÑm;qO3:@qB/K5GwtO[ljz5?Je* ңoؕWG*yWρq\B2/vLNDrY{:.ft>%:P;Çùu]ꔩYyMukU,껶&^gzzZ5UI՟f[L&G;UvS`}U1s˒Z`u8u|}e#+ͬm}.rs5wU$]6qJ[\\(T'ߺwCon]85[ 6F/~a]J/)gqY»v ۃj)WS?|7NӛS,K_u_Z5D󙇭_vɻ .^sDyΝ> ʻF8N O)osss 008(BM6 f.zyf\28p@w>Tson9C޹s$u5Ty ~G.qԦw"eFJNquEy$oËz +oftqBh[rt?!K/[n龊E 뮻Dگڻ^L{}='+߇4:]u PL5)$#ҌP.8N(E3%4U96n]k*4]TmtU%cÒnŹu4d C~\󺩾g*2PO9sΉbFݦBM' fNO7X8Ncձ㔒099ٛq;A[)7f98N44[]Th8Ugө6g b+--kkk}XY=8lll VܹsNLL@' &ƚέ8NcqqYYYzunnY8a`1tWvFSܜצZŧXpb}9|̩ڔ) *Xu 08a1tn%Wv.--3ٚ YrL8`HƆmxxXwҊRXJS?O-R9Rzd(`z8u!Kbnwv|[vѣV}n V~Ijߵͣɋ#,;Neii1+Sqj7 Ji ƀf~Y1bOn d_ɾLpΏ(*T,Us:;zd{>4?q u;^پ͎gߔ,@qE;%qjEk/^\]]wmGO̞;w.Cߵ\q;C;7-{gEN6|ʭ}t}d8Nrn^dmN5@(g qV^E_ٙQg2)z߈tgmX/w>uG&nn) ~/<>ݼ黾qzi3T˺IvMꡁN(v+x۷628ŀT*5#P+ci2†K*ϟݽ{5mUi@S&'@ɈG={IJR}7ZՔCini(yhws9Nqlo~/rI8hӲ1NP.8NS)@|ƟbΜ9StL\w-{zn,kv3yؐepht8yRP&LQg@imqʯX̥%qs ʏ٬{ebtsq?'ͧ>K/(ǹe7{N_}JisҘ<(4ܱnq4(ls͂fE ?˥uȶ{|"=S& 8eNU]w5::@;h*Sci/ftCF- (_0664:sii1Upt|32y 2r8:8S(dewgΜz:e@qtB:TqnSeq/^%|&qZ2RlNPqpЫyZpƪ\__]\f{Z:^HtNS{[)* ?uX8 .LOOuϹsooGFM.`8NtOi'"Q}Uj?>S&'@~pVq?^,?kз)S-@„ Ar|<sd پؼ~q'_WyR&lCpo䐋Gz8ϝ;k׮'bʻCCC@qtB#8!I 5mZkǛͩ`ǖ5[NwyκFdR9=} |»TdX{}HN-~ݩ;ץ")J_8><66v̙,l`V`Uv t\3cm8I,]8Y:VES]ػvBߊZpVNRb0ջfwru|;?[ouqqj[OgB8L'85[R]ǹwnF68GUSgFU,Ʒէܡru2WWWGٳg׮]ν3gܜ&?^ʲ@qNq~Zkʐ|k:n{ʆJkϘ%MNmV$Z68'&&hGo !8LLj:Nǽ5~[VLv8c/q&q6|8]Nb?N %q*ؽ6=e=yİK7l ӱ ڤ.}'@'p0ZcSgj;[|#A9kne;(n5AjÏq6!Ns(EJ^ N#'p0qd%8 #.Lipt `:8NcKzk D~K@5qN:NSU .Lipt `:8NcKq+'@F8]#CqN:NSU .Lipt `:8NcK8޷v/]/_!x82t;=/|K?}RJ7d/'@F8]N^ǩ||O6qd%t87뚧LriV~:fs\>X.h8tjUwF*=?8N|p0ty___ȡpn5Uo%'@.8]N{781Y^Mwbj榿Yvukx96;Mn}Q?MJ5?Aݦ1 eYӴqTN8g>鸼ʹ8, 9Kdo˶6p-V7*.0ԭ eL핁TMs҅KIroz~/v:,/eeqS)ŒZ*)O@ǵhw[OO?qTN8w>g?{{导yp S7o Mjj[8* KIr|p}G^\8rjYؽ2-+8NrnT3i6A<3q%餌y߾rȡʂnf-sX7Gݏ3zT-i*]6۬Lqҏzp0#CӑdA c v5٩z>MnO! N4Oq%$9/[_y)+Ûk%lڲ#XIT6ЧqSۏ3s  #.L'qvyqȩdaʴ oDQ[wԫAQ [L}x  '@F8]Nȡkw]+z,Ke6mfNjU[i/0{XHB.SS9;ΰqd%?gr$ wQ8~cl,WmbhzS )wJ`} -'@F8]N9zveQǿ%'@F8]S1]HnNw̎K1q`v,7F8Np03' N4V8Np0s]7d/'@F8]Nǹ/?*S-ߓ pt `:SI5gK)q.74Od͓=>șgH?fs#.L't ҟFdyk<Ι^JNp}%;{׏9\nU[[jN˷6fHw9XƤ'@t `:)߳Ʒx+d˱&O,ՄNu˵}.J-ݐ{vSfkKx5_w c> p0$ǹG>s1O奬nX=~yFZVnOcO%򮲻 ^ 8]N|C~ay)+[tB +C|ԚHuz^-#}yr(N8w>g?{{导qZ9NuJKM) d[ gHͤ~} 8]N䃻;‘S GO-iY7mn^DM[ܤ* .9VðŌԶFcOs(N2r]?~#?( 2b,-ΝᷔϪmY$EI9lW'@ p0#CӑdArM͸`{X`-Ɣ2p'TTF{'@ p0O7NTZ̓ޗ8J%Tq& *σܓr?.LZ=z+ 2)'8Nt*8pt `:8NcKq+'@F8][k`$Ӕ]:  'ٳgkځ ';/ 8N([oUgyp?? 8N(gώ9Neg^2YZZuU $RI5'@2q:q/n,1? pPftY#K'ډӇjN ksttܹs'F !YH/^9|= ^I5' r;q={j=7|hٳg׮]e 022R9::* 8Z6e F S|gٹ#8whٹ#pPٹSرcŋLaddB LaϞ=V\@8&''WWWLavvvii\@8Lĉe C Li' *8N0Hp`L;08 v` qA0@`! C  i' $8N0Hp`L;08Lgl5)eJ|8LG֫@`:8N*-qpP98mEi tp("'TN[SIǹ9_MOӣ/'TN[Ԛ 5qTN[c㴬^a}FpQ?,nGhח*'TN[c<_1yY֫FЪTZCѳm/V(RɤvjQz'@f8mNɎ[ZO#(yTfV b|LhLQlv N[SLjnۖzqR566XsVʤ2pP98mN8cΗ\kֽǷQSتOĩ[]E'@p0㌚?{n.͖;%l 5vHk[ՕL (}z vsM*P<=vmROF`~:RVjQmv%cz -1qS0 %'TN[qzQ13w'n-ݹ݉9~Is1hupP98mN.)|d|ʿ~O>y{w:l:}'#)G&'TN[qN^$yϟ JBF8 dwz|3O~ę:|ϽMYSʻ>uɍ7!zKg^|T7n6] olݒHjvRM;ZHOx>w5ܪ*/kw'TN[q^t7핿O?>?g?ԝO>&\K瘶\3 i[Z<7lЪ:IYɕ^)}Ƭ,%'pDևx2;+0^8.?p{G"YbW#bc1Y-T*:ǣV2K`3qF=[HO5nUYۈ~8ND8mNvy^'Svw S|sdiRW-)gzjh}٩<ɉ+֠.Rˌ8<뫊i t;[#77~/<>ݼ黾s=7:t6弎S8HgWLg.Ǚ -8_{w'V> ?O~?|6y76V=0^JPczļ3U]o;N:E]h׷mUS'l8mNv)Zֱ˿xu_i}[<J;Cv!!5SL&"Ͷh?&7r N[S9[~&eYքx*2CT] OG 訝pxܺӑ"O#JO\&'lt$'l8mN^ǹe7{N_}JisΫ>ύq@`:8N0 N[H8N`:8N*-qpP98mEi tp("'TN[D8rp0' 8ن ċ{Qҷ/6oO_''TN[c29*-)qsGW֬7ST-eYkfM+iӲ{{Wf6kO5ZtG[Frj &N5iн|FwI!W8Nؾp0bҷj,{fN]ۦL渳M9VES]ػvܣd#~8~jZ9QKΧ,ٝ&8`i t s-)ήMZ/pNգnSˊ3*nֿSF7#}'l_8mNӭzP8]euWc498`i t*_鸷|ݯtk:_ U+&xw;p188SRh>/L'8='ЏSǩlc̖=(ޛ3&/܎Sw*L 7hBq}`:9WvcSgj;[|#A9kne;(n5AjÏq6! -)q*qM*-qK8N^i tp("'TN[D8rp0' 8QD8NLgh5)eJ|8LF' F'T N[D8rp0' 8QD8NLlj"q@`:8N*-1q5F6뵩VUI8rp0t 8QD8NL'q?Jkݚqgzs-eP6Mc~[7hLpQҬO5VC8)9[pP98mN[l&gZS5ig>Hg`A禸#bqńi t:Nhqz6QjUo5zP 4I̤ńi t2q?r,U1y:NFSmywg;gpP98mN8\u^˘5qX8NLzs´*8XOMe\~l.i tz8 oLi+XXmwX8rp0cljL*-qpP98mEi tp("'TN[D8rp0'   ER 'ԨDaըi tp("'TN[D8rp0Xj5ɎSl\6){o6ݽVѱw.^ڕc׼۴2MwR?rɧ'lK8mN#{Wg9RVulK,[8)OA\peAw!g9zfQ28^c3^NB+=upVqm`:IM>tîZ奬;N.Kg)!Ő^`R۶{Ash/tM} [s*N N[8w>g?{{导 7]TJڶwn÷ Nݤ)<҆7V>2ns9WLq18mN䃻;‘S GO-iY8q͂8qڕ-u$_67|'qf-I9tM}Cy&~BK ;9ge:Ը:L鑩-`Im!s]ޏKǩ'xRgr$ bVO1β3zqUO;Բ{v"("^Vcc^9v=1V ;U+8#y8NqlsŜC[8Nq՜S q@`:q48rp0' q[[w?x问|/ dw{^5~,nPi t:N{# 8rp0xCQGO&ݩ/A>{r{$$i tjUMkٕԱ,_yTIݧ#Mz'*-Iwsf!5էH8;RR;eJ 8~Ͼ~y|NuBbcA[v^u%TnIaNfs*f&V7Ift?MRSy2o@Ƽs8rp0$ǹG>s1O奬y 4&;N^Ͷtβc}(d9iqzop/YZ{TYP;[1/'inzƼ $'döq@`:IM>tîZ奬;N.K!Ő^`R۶5{A rh/ sM} [J}#xjwI?TVc$%{(Ê q@`:Is{oyzvٺWKY8υ:N m{6|+0\2}Sx =zTR[=oڜ'tTԣNڕjZqi tm'}|ߑZ8zjAvLD}n\w eiW.m|m.  DXǙ5v:Nx8mN]Ӽo_9}eA^"F%8c=5-ԡe}1UJUf%6X̥vez?Tޫ[ޫIRqi tRgr$ bVO1GL78ԱcZvOp!Rı;ҵ+3U¨kCj6Z"5XFc``:s@S?{M=v}H8NLi9 9``:8NsԻjNCq?at<*-ٖ 8QD8NLlj"q@`:8N*-qpP98mNWl};ۙ 6P8NLu}wը;k֚fӛimK! ;``:V#6yz oS8rp0$ǹG>s1O奬LvQ UX8<{gm:KRPkR7P o_8rp0$N:aWRV&8eĸ 9QT ZO6R1QPApP98mN[}RV&TH 3W gjpP98mN䃻;‘S GO-iYم㌙dǩqfN!38rp0C4WN9AYm8]8JJq%MooIpP98mNӑ~!H٠Mu3(>V]mؘ kLd,."Xvަq@`:r̩nljl8rp0Ar9l8rp0rʼTpv*'TN[cD 8QD8NLlj"q@`:8N*-qpP98mNXur;j2>q@`:]9 POWN*/'TN[8]?r) {`G yfSN@8NL'q{=O,Q[5yבZljXZa#lfZW?ۘ/{QݤnF>di tٻ:<2fo=[SzMIuSl<{$eӶM UR&M_mq=`:IM>tîZ奬LtQnV _mys %jSl -Ir;{ӳֽW^Dr`ɓ-ɭjWzVmb|/grRYq$9N>#/.9pԂ,^S[} YG>O_qIf N[2r]?~#?( 2ܬiQ* AmSu[y?ξl -I:><ItTOn ةEZ5SGOyE#S;V?98rp0_gy} Tq-g0s_9pP98mNi2v̫ޯ ΤT]8NLrZ8NLlj"q@`:8N*-zk @AD٥ 8N-8N-8N-?gK java-design-patterns-1.16.0/interpreter/etc/interpreter.urm.puml000066400000000000000000000030761312550536300250200ustar00rootroot00000000000000@startuml left to right direction package com.iluwatar.interpreter { class App { - LOGGER : Logger {static} + App() + getOperatorInstance(s : String, left : Expression, right : Expression) : Expression {static} + isOperator(s : String) : boolean {static} + main(args : String[]) {static} } abstract class Expression { + Expression() + interpret() : int {abstract} + toString() : String {abstract} } class MinusExpression { - leftExpression : Expression - rightExpression : Expression + MinusExpression(leftExpression : Expression, rightExpression : Expression) + interpret() : int + toString() : String } class MultiplyExpression { - leftExpression : Expression - rightExpression : Expression + MultiplyExpression(leftExpression : Expression, rightExpression : Expression) + interpret() : int + toString() : String } class NumberExpression { - number : int + NumberExpression(number : int) + NumberExpression(s : String) + interpret() : int + toString() : String } class PlusExpression { - leftExpression : Expression - rightExpression : Expression + PlusExpression(leftExpression : Expression, rightExpression : Expression) + interpret() : int + toString() : String } } MultiplyExpression --> "-leftExpression" Expression MinusExpression --> "-leftExpression" Expression PlusExpression --> "-leftExpression" Expression MinusExpression --|> Expression MultiplyExpression --|> Expression NumberExpression --|> Expression PlusExpression --|> Expression @enduml java-design-patterns-1.16.0/interpreter/etc/interpreter_1.png000066400000000000000000001323001312550536300242360ustar00rootroot00000000000000PNG  IHDR_ IDATx]TIň䠂(s$1ʚPW1T\sĄ`B1GL`ִ9gׄ ELL'̼{TWWU7ze$"3@ RG@ 21W.#{^G YDgDá' u$.I <: AHZoԑ@ r| .jS&MSl2e!C:@ɓ*W.o:y u߾ޱc(NԸ:ۻWVꇆviBc5S2`IH ۷IsuuusgD;\9B TV)hHߦM,Ν3}ef:O/^R>ݛ8W:J^| (Qdƌ2Sl4ť8Nd&,I <:B lgg Uq#AA"GN ru\7&fOS˗cr%l2Kظq˗\755yst +©)H4@:y0huܼy\ RȑSG8^/oƔ͛Cff&%}x¢WdfIREf8uY֭!vqPf GN'8HH ܻws ᨂDFNO0w2EZ!sŊ,G|hUVEndfc&&å`Ս" uY·oǎikkan^hNCdCq 8bUL4L M)^A/A ]OnٲSe&.[6:.n"=ڕ7o_ON(_$M$bP$; عsnݼ׬$ɂRQf ̀e%r 4 YDѐm5Ly Vʕc]]>gNh۶"oAqp½{ ŋG89paH,]9X1F$;,!&f\&5O!y:B4TDЌl#/-?ܼٳիR]ddHwڷoȶd8jTҥLw̘@6ɩ#B2!ŋۢaPb_4ShFK6HK xQ ys(L/;'T >4+C:B3Z'Ũ xԑhђ #Ũi xԑh R*C 'HKA Ũ2 xԑh R*CQ%4C RGRhFk 6H1 -F 'D^H3zڵmhUDShF6)F9IO:Nٽ.tԶьخ1 3$#pO2h\@})4]T@(4C WGH`wOqa[GN9)+&))!.ߕ+,q,cF,%W.#kkh*[:C~ %}/@ hu$Ũ{ xBxcJq(Ӊ~`α WLɍ eUb):*,er;}RhF6UAO:v[1Wl))8?yK;}ͽ#ϚQ,3SGVVfE|Hcje$&?3NZl8bEgxTt`S?>]͚!޽} nQBI5k7E%SGi+ DbQU޼9޷o[<wt5k0;-.'8ϟС)rMSy3FE ]&OϪgάd nQhF6UNO:z l$0tA1o^23utv.֦;T m vf75513):$?`rY>? ,ꆜ3 Sc٘:BH#$О]acЌ ["[ވ hgܹs(СLk*v4FA#%߬])W h?fhDbnc)mN;}ʄf7Q#eV3|kf9u9s6ac˖i 8{v~ )T͛+Pk']-u߾9؆SK;0#gOn]zYu%4)?B[5FA#Ӈ3s'{G}fhDbnc51uĹ3f OWWfjsukKNƩt'jϟ?/\RWF(4E$ 't[^Hq 츴טm7͝˓f^迬/ff)JFՙ*,[6Z:YtI .ss^:޸;54Q:? $ެ>?]eK~e:; ah(h$wooeϾcdժnQhF6H$fIO:U=KP/wEDoTGn+*#X|I  {ǩ({׮4{(bE!Lիqʔȃ]ѣN9;{_:m/XwjVVfp+Z1 )UNÆY-m16ȑBVeRh:"@Mnw};/닿F4~VCpUSGr!T)%KFJY3'bEgtЈ[@W9-Aݺy#?$oslد_; ޽Ǐ^&uϞ]D8xxKT0G. ڠHU!U DᨄIO:4o[7 X'O~5m#7oY I>G$R fkCV~~L̓'7/<%ڡ(0)4C =QG:B3ZABV$FEG:[nԑQ B34 u.?~<}kC8f:jJI}z$ԑQG8*FO: B3ZABV~ְosҤ>" upTFzJ$HC RGRhF6T* spe'wƲ9|ԑQfh, OȰkoݺycoJ. .'+aY:n:=*jH}@N}һHЌld?03in*13wShFK6HK xԑhђ B34 u$.fdD 'HK-`vTiB34 u$.fdA Pu x6# h{0"u":e B3ZAiR*= 'HK-٠4)@PhDåЌlPJ(4C RGRhFK6(M P}C0\W9B P4uu$$fdD 'HK- Q/)4C RGRhFK6HK xB5umo3*WΉcZډ'Oy}Y?Zv"/o`ut_aÔsJ hIzIOUǑ򅷬8"ry [d$`_ı [ŵ"qH'ni?XB@A\(J(2cyٲ8M ҥQ=[Z`].EJ˖ʖ-GT^/FD@c--M}}=3̳[8WOQwQ{{9B3ZRG^RhԱ_{&siUyO220u"``>m ެ{ \ɓRںu}$w.kN犊kN<>/os**U*%@KKS({ II^<k,wJ2H:CO*AV/M1e$lg :]4Ou{)\Sѣ:]h)m[]3aݺ!!~;6OR:\NfpѢ[*Twr5JHNhbbh*nܬ켼=DCu - WGWE! xН3ٌldKM= /$S"P8"uldG(}t \>< N̙^ݨ߰aЌVYu8TKIAyfh%.4UG Y#sB%KzCHA~ Jz/^߲e֛!ɋעS)sЌV7LL--M:bD$ JJP*Cu$yRhFǫʤ`Vǩ#)0nu%(O: B3Z6e*IuD'u|ԑR u:'HK<#:2xEp~" QT?:~JDåЌV Wx7/e#)pDP* u$.flO*qGFN)(ON_'R#vC3YRhF+īR)(OR Q,'L[z)Y>$sIf l0xUYR ((uT<9$(}N,$5F$ B3Z6xUJȧ@A\{12yIŋғo$g9J;ssD?O_%.f5!HJԕTs$UGz R9MʗĘi vj># fD"O x"ku3JRup#sզpKyb4g;~3sB3ZRG^RhY#VWpTG/TÕ/91D hIzIOd|Zeqgʜ|IUÕ/MIN^~D hIzIO*'˹VYNus7Q;ssD?OHL˿Z9@-#Q/)4C 3:ԟkM9Q;|9O&l'Q)4uxUDI xBXԟ#9I"QhFKrĜ '<)|C$2 h)^}ԑHI h)^ūK xԑhR*W#p)4xUfU/)4C RGRhFKHB34 u$.fQ/)4CUðl*lmQ(4xU"WQ,Ç/VڬFr.wTӡQiQ(4xU"WfQ'a۷ uv.&(ӡ1)V.RhFK2_uT<*l*??/ӧoH ?Nf8 OYͦq*n:?l6iR%*b "fBxUDSh1˹V,۷^=&S͛?vLG>Mx:ԭ[[ll̷mqJ|͚J,ƊR<*@E hq x"ku3׊{E9gN(5xf$XٳAN 9&yl*ӡ.^nժqLb (fBPG"QDg'3]X Fk]~36wz8q/sO6Ԩ,ҥuLb (fD 'VG>s8:_uY'{r2JM=u5IOH8q_)->~ &gnQG)4%u$%fh<:k%1K RP˗7|v:<OʁuB3ZRG^Rh|gtkR>ɜMQitζÇM" lkQ)4xUD 't,GMsݻgb%D]ЌU0)4C SGӽqq.5Sb%DЌU`)4C SG"QSR*W#p)4xUJ/)4C RGRhFKTnQ#p)4xU*7(d x+`P=EۓūRD!HՑ&ҦMQ'Oׯ_|QN@:R*> (uȧO:aÆS@:(^ūe::ڷozjIMM533SꐈÇ+uAW@E*KRGƇLMM_~Qϟ?Uꐔ777! @HʒѠe˖f͚){Ç:$==/ d\xO>:"WET]FGG+{ԭ[J*Qm۶ݸqG< IDR$u4\{^r\r5`e" ^1cM~*ґ7D$u4\޽Sϟ? ˗U8 {jnnt9]D$9{Lm#tj=TΝ;m۶vکv+\Վ%d^|%j6ǝ;wݻWr -[lذ!HSm#t jرcUVU.]vlHHȜ9sTY9J<{l++ &|I^g!C伺Z@2uTѣjn޼u*WMĉ*UyEٳVوQu|}"U.a}UW^ӽ ϟ? }%K۟9sF]@'R|yuJXpU>z'OTp޽{kKTI|mɒ%666#G|;֮]ɓ'i uTƏN g6l: W|:m4~VwVRb~i~Qu8;;_pAɎ=Z8Q@ /Q^~ݿE]V#&''-X@#zRGqyNC?~XP!ߪO?Bx(٠Aԙ(#Gh4A@"Ə?rH5 3fLdd:%xyy%&& B&o޼_2\x~k\e|_J{i@A@"ʗ/}Ç5k:%L:_UKTDexmhh5ڎ;~A#RGUpUA9siu8%*x{{}jMII)V|bMH %HU I %HUܵcǎ_N```ll$$$CKT$dR->|=z 4ت_}nݺ)f͚zKL8|2m4++ .l`XyA uTIIIHQ3///yezzE gϞ|˔)ӦMwX|1 :*?*TH#Ch֬,YG#۷OݟK͛wi@M =B:tf!o…WhBԩʕ+7mƍ9Y/-_L  j2eￗ-[V:}ĉiiiЍгJ@ٞɓSdׯ_bdVjbb+W.e+Us葻hׯWsP߿ ?'{{M6pմ|1 @ݙLuD }*tI4 KuɫTqA#G4hPdv\tʕNNNӧOW`dz÷o:vf9CibAPZ/\гgO+P>_Y֭[4i"cR diiYFk׮!]3 ݻweeڶmҥ/] .Ӓ5nݺѣGQWܹ۪U/^|H")puue3f@!/_fGp!-h*~ hѢt ̗/_ .^ȝ;w܉JTbnnE)zݽW^h"O%$+6J}}}q,!CXYYz*DZc˰aP!QG(bF8פf͚xHClb<:ɓgҤIw^޺uf۶mW\A_'F$VGHQDD=z@{DQ@$"ݻw؈\֭@V^]bE8W^5 /H, ,\^f7nWj߾}؋ &L1bDѢEQիW}={YӦMYހҺuk!(tڵpP#=z4˗2fxxxy&h$RÇ!!q(6$$*_㉉7f)wAG  :62/G(l9_;-_L #}ͩ#dj*NяWTI$f2Ác/|,e n f 9wrE3Ga:RśJq ߿1APs瞔Z๾P# vB _~rhKaw&T(de*5"޽;Kag:^~Z766KϜ9C/uSO l@!D6lبQXK8uفh<kԨѠArܸ]hĒIS#1W\cǎE`gp*Sk?d ̝ǏQ#JѣGЪUv b5,%Spd!ƜPK^?CgMXqtpYQG!ٳg!NZ+2|n#rvxb>@ (/u݃BTPs=2n©#׹+J. 5bQ-:u + dl$y}1 Z+غu0ذaZkԩSW*W /eB,%8k3*2-ZׯBšhKTiÆ q^L|N_:Ϟ=cnп/^<11qO6eOxx' P 3mQ*UZre&MO>rCΝ兢]֨QٳgPDT -8ܹs'N|R{{{Vijp.>zF̀~: 9_>\C8 hKA3$ձG]U7Ց<^xvQ[7mڄf^S9/_4hbAWuE2DyآE hً$煄tؑO,RރD?#~iVA %۶mbŊlٲiӦyqwwW)ʁ:::BhvJP&RIpݘ{}aX3~ 8Lfچ+/_>T*n޼)RF?F(m{p ZTGԛQP=}tN+ .nj#Fh&VΝ;w;m}XB-]4 @J6L9RqΝp׺v&j|1XUAqqq .|dxŖ-[4[F*?~qill,^C_HB"|w&999gj Z@iÇi'|Xr]H\"|8SN>}/_rFy ]Pv۷Ó նmxBq >R vIo͚5! Pj߿ѣGYJvj*[[ gu3g+V,22R rR@0,8 uTLǎ^~x- 2Ѿ}ŋ(PdԾv획͛7o L _^D…zEF6Ulb{"ih,%gfjժ725ԩ(ԨQUomH#juM2d\+V(7'/.S>-_LH$r$u$|5jB?w;]ZYYd2*냸nO4Oٲ%ʔq 霖v'O.\pHHT.(Bh}…nݺYZZr?{ٲeK(y,}֭nnnQQQM4ձTR ±(RH@@_M:.[m۶l$K.˗/t钿?*Ůϟgj!UT177{H<ثW/#1ctʳgφZ`A8 ,ظq#ES}}}rʨ700pȐ!NoL&#oN1c'j\{l]իhVCC4)dH:Kbcc3]͛7{xx@MG'OI&AM7nݲٶmە+Wj֬YdIXQ7nlffƪx !?޽Fdd`3?}zjh6;VNXX HڵkFdڡ/_D͛,.]7o… kܹƇBYs=ydҺu52Ʒou616vBrN V SАM"XΝ;g&Yu<_ϥ<}71qgu.דz*QȌdhKq*bEL$HB0ŋpW9(BK gB6 .l֬K\jS'N˗̙3:TR%XtQ/$YmѢd%$''ADbx!rEYu}+2+WN$eь]v}eGd4k9sׯJC h>L"'2I3H Y%P8ySL^wt߿݃,UPs @Λ7Ĥt ,E)uÇÝ!#h |Ǐ?J68xߑ6bhq^^~+<ݻ WkԩSŲßUu x؝07sBY__)*HL,3_711F.WnIt 2K]ܼ )Ȇp"8'ŪH4tuwIHHHN|*2;p1ckaaLR]8uUϞ=c/޾}&ܽ{76;nٲ险BԎ*vڊ+YU_QZӤI#a)\Q˗/D%0ĉ-ؘ:\fe&"ѣ]y T˗/ yc=@ %QΝtf$f21~r`Aǣxr6xz%  \Q)O@q L$ Yiκ@ TG ,, tILuL2aݺu;E\2Ţ%H6Xhi&ਖ-[{^c۶m%S$UܼySD꨿<~ !Dh^Æ߿?rX})t ȧ[e=#o37/^<{z0j8v! 7k߾!VQ=Jv@cd Y-^ CG$[4\u1==}#Fy ;.l>~;'76eݓ]<%Zr%%N؛t(˺r26cO I]wԩDői YCtK+%ORFoM}֌b::92kٲH:Z2:~|r͚y$[7oa*:p`>RTqZF,*ҷoQ..f5+!(5d6?㧈~/̘UFU]oܬF v !8"&f:thdii8m/\M"*T(ibbbҹeXvsBUϜP8kƍS+VtƉ%l>]A 1Q%gEٻz)<3RgޯV@"6"8pHͷlk5`5JakqȃnKcNǡӏq .<,3SGgbmڸn6)]8u(!0sȐ'm:5fgٲ%hn׿&#֭tEΒ6wPCoX:<)4#$$氢]6С]l,h;w:= ԪUA<"s.\ Fԩ~vǍ ®|+ -%.8fcc޾}CPh6i(oB$G&=$?7 FD{ %Bhȑ#cuw兡fqss;uKD (J_^5␬Qz ]CtKkLiSu U&4<)-kG[#5̩̙($O5MYu|I={2Nve3e{d #+Ptx5j["y__Tbti{kW}{ sL%+VV-iӦӧOo/^+Vŋ_|6lX^wA\ ,hkk wm֬YlV"(XtK9]o?e||c$eXt꧷=Vh$hpSG( |bŬ3 :۰CbbƩl c(Y+<222 ?,]޸#cPPk&W0F8esƌجYm"ܹΝ!ҹ{.#KG ]p[[ kǎbS7hUg߮zq"q7#ѣnj⦄vv,_яǎ-ew7l߿%Iٲ%p Yݻ7G9.\Xk$'+WU~:x(rnk\46 l bˋwoؒ}*K#11qlΝ;yvuu4BVz-F[xBKgǥl m,}6Be}77L*5 sٲђ<0 # T߬>?]\ð JOƝuܿE9ϟS\#S2e[)Ԏj2: ϯAW?¢0K<۷L`CJ.8vHŦԠwkf>⇟p߿KdP/60١C# '1:g'2C~~S9}S z M_l!$ďk?3L(>~ q>܅nҳKcٲeݻwg>| ?ɓ'nnn-JMM0`_ $n#k^s2~WDY.֞ꋽ\NIu9^/ { WL:B~4 'vٳHAziذ:vаT'u4Z+سg+HGl<{fr?q/^ E1bQ&˪UBVAΙ3( jnܗ/xЂ"E`’_gkDh(=hut`<{gll׮]  77o^HBvlNҬY2~|/|8m'#dQQ˗/&0uЈ}S#/}]ݫ˃֭ϟH<< n `ā?1K=P/fxZ:!ncd H_tSGxlpDkԨAb2㯞G4u@ ]/8۶mo߆B={k8u-.J#;W_z,ظo߾HYdIӦMs&*zϞ=/ ҥK:u-?~4qƽ{=rȝ;wV:Il!{I%~ ˖-Yf'OC/S:$ҰaC(Jiiio߾:889sf̘1F*UD{Aa_KzƍCXb=z͗/{:8pڵkh VHDS^^՚4qdΜ9[>}1۷dZQ2ЦTG}k ֭!ԪU+SSSP{;vl͚5pUuuu-P]Z:u4bĈ c./ u$9:y% (Dҥg̘&K;w>|moڴBG޿/j׿*U@Fڹs'E‘})\7B кuk(4e =}fڲe DZd29̄ȑ#];SS/X0\$u$Koll\|yg]0 Çe,w6^V?‹뷱֥KC 6*so߾}޼yÆ ^5rĴi֯_ɇdrii'>~<:^m[ԑ.>xٳg L֭[Rsp-\ҥKlLPܣ!CԬY`uԁy}8_<{]d lzYTR5 4iիo߾M&O5iRt\ԪU=v[7oTҥa"r0=+"?Sǭ[GE bW5ARl xۻg{;wnҦ{ժ,0 Pm\7oeڵcL4LG-%$u$*w(Rkt[ZZB̙3sԩu̙pttCfvÇZjĉ^^^x!Q11zΘ@uzBtYA$FqTb| Jbȑܜ+oV9Ȧ#? uDݼyHOer 4mZKJGIs1g>}1jժNNNp1`kƒf2$#Gv(]Vw@* X5yrT2u?b-[5o^gƌPOiн{s~2һkB(Is; Sw.S5:DoaΝ;xbd(UEVj׮ݷoL8744c {k7hXXXHדPGud.uVX.Tӳjzu+%AnYpJh' w("6wA!ZP:JRG41iu3gtU5:6n8n88 P\UV]r}ȁJ۾}C8v))+a˽{@\jt},:|yJt ؋Y=!cocW'ڧOH ߾M]ԑ/ yA. Iff|ǖ-[Xwޮ,  ~3˙"߾f He4wU&#_w{E,7ÿ{)S`q=,YRGAԑHHȗ<8pCBB>޺uk͚5vss"رÇvvvϟ?=/9&s #ȑԑ/ yWΝ;>>>yEq}}XDEXAEDT HlQcWlij *V "Q 1Qc,hT"&MvgE>{Νμsfv皙8p͚5gϞ}-mGʨ_V-GGGZj()Ȏ\ B L!qȎ\)ܹsɓ˗/ׯ_|0%%E%jN ރ́4ȎJ(޺uk޽#۵kdɒ婾*Q&CAE) ) *ǻwJm2\) )QgDaMlGRTϿFN<9""*)ʐ)(2%؎O2޼yղe˲e˲ 2vX( CQ(;8q͍k|IU\zյ_x1_W'C9?SÆ s6 .PHQO yYXX4o|lj͛7s9dll|kcǎ *rrr2122Br$wIwݼySЎ6mӧcРA˗nff=z.^ggF|RqGFMڵk{"'vuu}jޑ#GN2ҥKEd(((v(Eϟoٲslj'x5GDD@u۷駊+:ubrʙ3gP 7 фP>}iӦNh"TZj͙3g̙uԉ B~޽{mڴ\d tۿYfsOOOϻucEVVVP;_@;qʕ+c h/bM4A3$hڢf͚'O4i҄ ƏW_k3f UÇ 6dx} !ݾ}{ٳ'vowK._|:{{N:aX]ڷo߶m[VZhn6m}g8 hР^]z0TK𽹹9޷5jTVjժUTK쑲D___OORJx˗/]v|bMm=9%ȣL cA6u|JE+''o;,UlraD%vq7nͰƾbw> LRسC2ۃC:vea:RИ#z`_2@ZDرcv %`)h \\\ X !QFa .`oooH*,X }_W\rտ۵k׮_~Æ 7n Aju۷#{޵kWXX؞={ݻo>7߿QQQvϟp2WHv_իoܸC[nݹs{>|I9r'O<}4++ŋ׫WqLdo2a^ ?EdG >%Ӈ-#K#F`ҐT.R{[nD! ؔ{}y@ j;,F(AV|9c nȺ $ιsՕ jGޢJ57^Ny(';R|8h]wDjxh?#wTklU};#DAoG|tX#RF$@#Q2$juEXY&[HUoaɎrv{7$5uSfYy1oޜ Z([)\2\@W#s3Q=x1cƐޡ/As99'z<77U)# *}g5==j```FFmgGH2;Up@*\P1[CNAy˽o#v҆Ռ}fG~ڗҢEvϞC3 NvffΜOʵ߷ϛ 5k]ҥ^k`{,Y;w.޾}%r B1xo11+70 F2jT35vd+Wk+p#PkȈwo^rkq={ڲcY R]4%xv;:R~ȡY*Χ4Աcq"D&3{CT0;}ZvXYYM;rgVN~~K/'!*mQ6֭ ׸)ĉƊ;AB<ر->nݘ5{ƮQڬfѢMWn^ڻw,p73362қ}hMb1ӦQoG{yz=th9gGSd2uhhzo>aݻ8 T[ԯ_}g I\nq#ë@'O'ı Q-\-2^nw32.R~ \h }^)/h9t2  R  {Y8 B&3.jC{߀xx_6B% gWqCΎ7nTImP_ԁo;ehD~{$ ժbˎG!oHE;b[vwKg?ŮΝC2_tXk׶ V >8p0 5#֯#8O,?_ K9;wX@`D]] XYf~5%@ǎK_L";uECϡ/c<^[QR%]]][[[G;P}1bb AJ@2Yۑ!P~'$:=O"D6c\5\`؃bCX~ ˗O};p?Ai:Q4:2  ׯ_gw.:ujΝkԨ˶mzxx_>55O133۔g7oFyϢĥKa4%hX*TiL({!S~>}J^xѽ{w'''mԩS6ll׮dY^~0$^^^۔ݻ~m߾}wqqYÔ)Sn?7]G3/^0C~͛7.\ؾ}i|W4w+W}ի^nTZcǎÇ޹sgjj{ ;RPpAv(اh,xΝhXYYmvܸq#QY駟oocڵ˗/_~ݻ?~ŊQQQ.]*iHQOIJJ֭۷oߧOh;Pٍ|Cnnn>>>yf>  pЀt֭ ,4hP6mLMM[hѿٳg;v?(|]b6"ّ`dff֨Q)۷oO>zhe-ٙyVիȖ ZjO<944i|rrr~嗘5kE56nܸB 5kԩߞ={Μ9f2Qq+Ԉ>N M #* :/'Ej VF6cdd%1a„ǏVZ5r͛ :400ȑ#=nC={6<<ԨQpQ߰aV@r͊aq̓febŊR;ӧOoܸ˫Czzz}5ySv3b[[[$xM4ݻi`~ '}EEMFimQ=;c)8e NԨ9O]ShJVe\u)[ Gp~kp0{lr_(qoÇC<|%dl`_󉈈XpaϞ= :u4iҤP$yp۵kッgΜ 6kLWWJ*۷:tEoߎ4޽{HEyEKa[Gq:SIo?8MD5E#wE)W>{Ϝ9e3/z{EZ5SWN~_]Z Z>uE< ֢E}Oܳm:69 )kXf᧩)o% JչdV-3nތvNK(<}zJ{65**ֶ{իWG"lYYʰ3?YY e,`\(9߽;]qᧄ(HRSLSCQ 4Q(w?}}c+Vu~:pd^܍̍{/"{۱Ev0ϭ||Ʊ {GWb?F8,?;_u,O Qdқ"FiL(3g]h,]C2gbb 0Gcb?"c"Ӧ ?_ Z0b7߿9weE,xm4C|zrfpT=޽~좠,c&hlUeO:Ԏ(hby%pedfP~} r.w" ds+VP.5u 87pZ+*Toޜ"Ϟyeǿlobgg}=cUdbO Q)6LH|?L.)[J㏨uwK EVކg+!,W.P(vT"ӧGqm]5wNhvf_jMqKݼU{_2*0Vqy*̇2[-έSB`4R^%c ᘘ[Ȳ 8Ȉ.P(vT"ɓ!+p*6~x'Lך?$-.RHzc]!d?B%mݺMJ-J~s U08x6rVY~‡\bO Q;򿘽suf뱵nBj!Mx@Q4QEm&&8HVʹcǦݻn|V($\_j1cY˙3.Z4Z;G']fgu۴iqʔRX++S62g΄Vn SB`4ŎԎ25.}IR6rWKG|X:vl-+#IeeNJеk[e(%#׎+&#i[z*/h9ӧ~"O QшMx(~=-trvAEff>))!?e) E1ّ`U 6n(i{2dG#AD)i{@#ّ = ّHQxJ.A +V%@ aȎ"jffqFBACvGGN:= Bcqs]{8Adf(3!  ;7͛7?q III(= Bc"//eE5b X̝;w޼yCQ#x AȎŇbnnnRI B:'N(^h.CAҁX|xxx,_\ +A!Ȏě7oLMM~gEA!ٱrtt| xCAXL?44T)bAc1QbEEYHA?dGqҥ˱cA! Q>,( aȎЫWhGAACv}T $ QNQAaȐ!{{A0dGq1bΝ;A! QƌA3$$DQAaĉ֭{A0dGq:ujPPأ  !;̙3WX!( aȎ0o޼e˖= B8,ZOQAgb (K.?أ  !;C``ٳA! QV^=m4GAACvkN4IQA!88KQAa˖-cǎ{A0dGqؾ}أ  !;CXXذaA! Q7p@GAACv~= B8:twb (b (G֭أ  !;;w,( aȎ␒bgg'( aȎp:= B8;wub (.\{A0dGqHOOoҤأ  !;oְaCGAACvׯ׫WOQAb (ݫQأ  !;ãGA! Q>}jll,( aȎ }}}GAACvGAACv\mmmGAA#EAF=v2} Bv'ȎAH#8Av$BʐE J 2dGӣ-Uyyic5ݰbʔoޜD}jfz!ȎAHnwN<,r;tɓ#(gg'N:HVv /16iR-5evy/ 6cmjJ:))!\ 25 ( 107!!skNނ%$;A(TۑŅ +Ν[|A ԯ^=OŃU"ЦV-3ŋD͸ذaV:/^ cjܸΖ-eQmvOGpb ˭NH @Z| yNÇZ5j ҥ^swׯ3+hܹ#ׯehd;9; ʄV00XF7HD x/?>oi~XrrN*CFAv$Bʐ) #ARH!N 2dG qH!;RdG ّB ;!e4Ɏg/6QuY3eԈ ;!e4Ǝ~1k!ESFcrkިkm*_+_с~[!{P I-%y 2aG(Oߘ^ܟr='wG9rAܔRsse CznܸNa:)WNVM)6ZZe*W6 ;!e4g/!k5zHzd XW7}7le|.oe'n^=58x']ّ )ve_mO̖:[ܷW\>g_g˵gvlbώ_4kV[f[]l;w`G͚U#GmڴD;wΎF>k׮8[Gw411hbٲl N133޶m! $>I֭hڵhq̵2rdbc@ nҤ.t;sPͭ:uƆٮ]##={g΄Jto%rM͛dG J`A#vz'Q>¼^O,XϷ# vp[؊#8{v+BydG J`G䅟:7,r=~E:B=厰 .Xcqn9;rSM۷Cz.@yΜF+wF!KYG۷1ceh12=-)͑#r6fG=%:#׹1@l,֖l*e|;"ųlJg?!BF¹vܸ>dG J`DZ:y ,[Ľ V'O%r/xԤ}vĮ ʡoǚ5۶-#žܹ/˰fML XU@&nq>"5xݑŨQ=ّ/=蔇:W6D-EdG ߧܺti9?ɓtq0199 W 6mZo9xK|x7l䜜-Q֭ӧGFjt؁mעEv{lϞ{LÆǎ";Q ;~8m[8fL/^ rYܷϟͪw_&uQHJ0zt/U.M,pǂ))!#:Z~id}rS~]";Qb ;~8fk7pܸ>m~vAqƌ!x~Ԩ0_o_{nA;z|tpyFFF.ѣ}@ؑ#{|ذVV2B{/Ev$@vpM:H?]̙C9sfbb ;ؑ*숴 ?8,koOu`x"̝6r0" Ooّ yx]ZZhNΉ1czA~66V,̪=:\Nu9;>~|ys+d؉YY~zڿ 9W bJJm3dc߼9y" K|ّ h!;l(LXTޝF)W&P|JH!;RdG ّB ;!eȎّ )Cv'ȎAH1PZZeR "~ TC#8QrG $ ّB ;!eȎّ )Cv'ȎAH#8Av$Bʐ) #AR٭lBO?hBEŋǼysR+ ;!eȎEcG=ߧbsrNzdG #G:O2ҥ0Yl~`Ĺs вG7npphinnzTYׯ5jTOcc]޽ONnH!335/8;wlԨ˗IRRB񤧇se0/%늂Hđ•r㶲e||!cr5@]-Z4`-Nu{Ԙ'$pau a̜9޽Xɩ8ݰ0otqΘ1iieĬU\ɍ;*8gώa-fҫdG 1WЎXy ;JXwo;VX_G͕+{1$CBv`y"ڵavӫl|;*ά ,$mGo;QrvhdA;o߾֎s 䈧g_&o~WڷϿS'Ǐ\^_;5QXcFF4Lܽ{;˖nzeo e!`gώa-3c+dG JRë¦#QoW7}*a޽XnScڰj rH?ODC0S^E,#T\ŤIS2UM9[{r/^$ E(ߕn+!X Im3zbȆFG+J[Ϭ"wڲe>ّ Ҁ"i RЎl|KЎ'Nlhee*zXizȚ^Xh4 P/wFqFvTvݱuƟޜv+)~WzHs&O:T6u qcܗnΝVWΎ-v#A)b1ӦQ̎HLL wdvu}d2Ύ<ܼ!E֭F\yyihܤI֯_}nh ٠|Aׅ6OM]b 7OvBqZZes^FF4hGŖrv2KdG J0R㸨!G|}}Qp8 (˿與̎7nTI_vHclT?0o䣰X\ysf577 YP5o,u%mv,գG{P7d/ .eC`I]::>e6m9Jv$4 E;"Nr11/ 00 FqBz{YrǥK֮bn ,v\}"kkK\l9s?yrӳ/7+uߩG\ًg]ۯXÝ(CC]1##&޽{ejC^^n={ڲry!0ʕFo7U>{v bO rn_R(**ckӦqݺ5c+#ȎAhRë¦#QoqM>=A;JXwo;VOkv=2C1JӫȖevJ4i{ BT :gk^xpt@ׅT ^XHmm E6eP,ʕ o&^>A d;$ߎݮ[7rօ|;e|#A"i RЎl|KЎ'Nlhee*gbXWF,Z4wј뎭[7欌 \׻w,pGkd7yСb gSGKٗYwutcl|;rQϝ;U^oG &;AHю+6МxJevDdbbп##vܾ;2rgG;"c57oFgpP +//Mq~GA;bkYZ uo>1;;ߕɓ# 䗊5= a?hiJ1##r{M!÷#7HՓA] qȐno >R㸨!G|}}Qp8 (˿與̎7nTI_91GRE/cgg#: vNG> g(ś7'aVss(!U__{~,mv,5|c!LOG~Uu)L0( ׯfDavkGWaΝ[9Jv$B]B'lؘ5#о5ѣ{a/_NyFiG8Ckd{ X1gA9P:9ujҘؽmGյbժy%&Vw%.}t«R_HT10pEUڵ*299dkkr崡C~݁@&={|մ#fcpF1)ɎAh #b(h, ]PR_ߒK%xJevT΢EM{7?=gS\@"xj`\/@r`{A)ȎA|hGDL~hN~_R#K$-bQC>==|YzzԩrժyfMcS {299UǏ";ApHԎ_tq_nj{d{lI*z`;| 1RdG tX.[&##ZAv$Bʔv;ffGF.+d'.nBWK U #ARۑB ;!eȎّ )Cv'ȎAH#8Av$Bʐ) #AR1++!;;uuӧG_QAv$Bh/Ie&$2Qrʆ[7x1LRl 3f 99'z<77Av$BhU߿111HL\w׬fiYCRh|@zzѽX9 4.0.0 com.iluwatar java-design-patterns 1.16.0 interpreter junit junit test java-design-patterns-1.16.0/interpreter/src/000077500000000000000000000000001312550536300207625ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/000077500000000000000000000000001312550536300217065ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/java/000077500000000000000000000000001312550536300226275ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/java/com/000077500000000000000000000000001312550536300234055ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300252355ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/000077500000000000000000000000001312550536300276005ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/App.java000066400000000000000000000072631312550536300311730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Stack; /** * * The Interpreter pattern is a design pattern that specifies how to evaluate sentences in a * language. The basic idea is to have a class for each symbol (terminal or nonterminal) in a * specialized computer language. The syntax tree of a sentence in the language is an instance of * the composite pattern and is used to evaluate (interpret) the sentence for a client. *

* In this example we use the Interpreter pattern to break sentences into expressions ( * {@link Expression}) that can be evaluated and as a whole form the result. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * * Program entry point. *

* Expressions can be evaluated using prefix, infix or postfix notations This sample uses postfix, * where operator comes after the operands * * @param args command line args * */ public static void main(String[] args) { String tokenString = "4 3 2 - 1 + *"; Stack stack = new Stack<>(); String[] tokenList = tokenString.split(" "); for (String s : tokenList) { if (isOperator(s)) { Expression rightExpression = stack.pop(); Expression leftExpression = stack.pop(); LOGGER.info("popped from stack left: {} right: {}", leftExpression.interpret(), rightExpression.interpret()); Expression operator = getOperatorInstance(s, leftExpression, rightExpression); LOGGER.info("operator: {}", operator); int result = operator.interpret(); NumberExpression resultExpression = new NumberExpression(result); stack.push(resultExpression); LOGGER.info("push result to stack: {}", resultExpression.interpret()); } else { Expression i = new NumberExpression(s); stack.push(i); LOGGER.info("push to stack: {}", i.interpret()); } } LOGGER.info("result: {}", stack.pop().interpret()); } public static boolean isOperator(String s) { return s.equals("+") || s.equals("-") || s.equals("*"); } /** * Get expression for string */ public static Expression getOperatorInstance(String s, Expression left, Expression right) { switch (s) { case "+": return new PlusExpression(left, right); case "-": return new MinusExpression(left, right); case "*": return new MultiplyExpression(left, right); default: return new MultiplyExpression(left, right); } } } java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java000066400000000000000000000024641312550536300326100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; /** * * Expression * */ public abstract class Expression { public abstract int interpret(); @Override public abstract String toString(); } java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java000066400000000000000000000032331312550536300336170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; /** * * MinusExpression * */ public class MinusExpression extends Expression { private Expression leftExpression; private Expression rightExpression; public MinusExpression(Expression leftExpression, Expression rightExpression) { this.leftExpression = leftExpression; this.rightExpression = rightExpression; } @Override public int interpret() { return leftExpression.interpret() - rightExpression.interpret(); } @Override public String toString() { return "-"; } } MultiplyExpression.java000066400000000000000000000032441312550536300342660ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; /** * * MultiplyExpression * */ public class MultiplyExpression extends Expression { private Expression leftExpression; private Expression rightExpression; public MultiplyExpression(Expression leftExpression, Expression rightExpression) { this.leftExpression = leftExpression; this.rightExpression = rightExpression; } @Override public int interpret() { return leftExpression.interpret() * rightExpression.interpret(); } @Override public String toString() { return "*"; } } java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java000066400000000000000000000030461312550536300337560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; /** * * NumberExpression * */ public class NumberExpression extends Expression { private int number; public NumberExpression(int number) { this.number = number; } public NumberExpression(String s) { this.number = Integer.parseInt(s); } @Override public int interpret() { return number; } @Override public String toString() { return "number"; } } java-design-patterns-1.16.0/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java000066400000000000000000000032271312550536300334520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; /** * * PlusExpression * */ public class PlusExpression extends Expression { private Expression leftExpression; private Expression rightExpression; public PlusExpression(Expression leftExpression, Expression rightExpression) { this.leftExpression = leftExpression; this.rightExpression = rightExpression; } @Override public int interpret() { return leftExpression.interpret() + rightExpression.interpret(); } @Override public String toString() { return "+"; } } java-design-patterns-1.16.0/interpreter/src/test/000077500000000000000000000000001312550536300217415ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/000077500000000000000000000000001312550536300226625ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/000077500000000000000000000000001312550536300234405ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300252705ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/000077500000000000000000000000001312550536300276335ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java000066400000000000000000000025001312550536300320530ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/ExpressionTest.java000066400000000000000000000106321312550536300334770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import java.util.ArrayList; import java.util.List; import java.util.function.BiFunction; import java.util.function.IntBinaryOperator; import org.junit.Test; /** * Date: 12/14/15 - 11:48 AM * * Test Case for Expressions * @param Type of Expression * @author Jeroen Meulemeester */ public abstract class ExpressionTest { /** * Generate inputs ranging from -10 to 10 for both input params and calculate the expected result * * @param resultCalc The function used to calculate the expected result * @return A data set with test entries */ static List prepareParameters(final IntBinaryOperator resultCalc) { final List testData = new ArrayList<>(); for (int i = -10; i < 10; i++) { for (int j = -10; j < 10; j++) { testData.add(new Object[]{ new NumberExpression(i), new NumberExpression(j), resultCalc.applyAsInt(i, j) }); } } return testData; } /** * The input used as first parameter during the test */ private final NumberExpression first; /** * The input used as second parameter during the test */ private final NumberExpression second; /** * The expected result of the calculation, taking the first and second parameter in account */ private final int result; /** * The expected {@link E#toString()} response */ private final String expectedToString; /** * Factory, used to create a new test object instance with the correct first and second parameter */ private final BiFunction factory; /** * Create a new test instance with the given parameters and expected results * * @param first The input used as first parameter during the test * @param second The input used as second parameter during the test * @param result The expected result of the tested expression * @param expectedToString The expected {@link E#toString()} response * @param factory Factory, used to create a new test object instance */ ExpressionTest(final NumberExpression first, final NumberExpression second, final int result, final String expectedToString, final BiFunction factory) { this.first = first; this.second = second; this.result = result; this.expectedToString = expectedToString; this.factory = factory; } /** * Get the first parameter * * @return The first parameter */ final NumberExpression getFirst() { return this.first; } /** * Verify if the expression calculates the correct result when calling {@link E#interpret()} */ @Test public void testInterpret() { final E expression = this.factory.apply(this.first, this.second); assertNotNull(expression); assertEquals(this.result, expression.interpret()); } /** * Verify if the expression has the expected {@link E#toString()} value */ @Test public void testToString() { final E expression = this.factory.apply(this.first, this.second); assertNotNull(expression); assertEquals(expectedToString, expression.toString()); } } MinusExpressionTest.java000066400000000000000000000041701312550536300344340ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.List; /** * Date: 12/14/15 - 12:08 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class MinusExpressionTest extends ExpressionTest { /** * Create a new set of test entries with the expected result * * @return The list of parameters used during this test */ @Parameters public static List data() { return prepareParameters((f, s) -> f - s); } /** * Create a new test instance using the given test parameters and expected result * * @param first The first expression parameter * @param second The second expression parameter * @param result The expected result */ public MinusExpressionTest(final NumberExpression first, final NumberExpression second, final int result) { super(first, second, result, "-", MinusExpression::new); } }MultiplyExpressionTest.java000066400000000000000000000042041312550536300351560ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.List; /** * Date: 12/14/15 - 12:08 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class MultiplyExpressionTest extends ExpressionTest { /** * Create a new set of test entries with the expected result * * @return The list of parameters used during this test */ @Parameters public static List data() { return prepareParameters((f, s) -> f * s); } /** * Create a new test instance using the given test parameters and expected result * * @param first The first expression parameter * @param second The second expression parameter * @param result The expected result */ public MultiplyExpressionTest(final NumberExpression first, final NumberExpression second, final int result) { super(first, second, result, "*", MultiplyExpression::new); } }NumberExpressionTest.java000066400000000000000000000051601312550536300345710ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.List; import static org.junit.Assert.assertEquals; /** * Date: 12/14/15 - 12:08 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class NumberExpressionTest extends ExpressionTest { /** * Create a new set of test entries with the expected result * * @return The list of parameters used during this test */ @Parameters public static List data() { return prepareParameters((f, s) -> f); } /** * Create a new test instance using the given test parameters and expected result * * @param first The first expression parameter * @param second The second expression parameter * @param result The expected result */ public NumberExpressionTest(final NumberExpression first, final NumberExpression second, final int result) { super(first, second, result, "number", (f, s) -> f); } /** * Verify if the {@link NumberExpression#NumberExpression(String)} constructor works as expected */ @Test public void testFromString() throws Exception { final int expectedValue = getFirst().interpret(); final String testStingValue = String.valueOf(expectedValue); final NumberExpression numberExpression = new NumberExpression(testStingValue); assertEquals(expectedValue, numberExpression.interpret()); } }PlusExpressionTest.java000066400000000000000000000041641312550536300342670ustar00rootroot00000000000000java-design-patterns-1.16.0/interpreter/src/test/java/com/iluwatar/interpreter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.interpreter; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.junit.runners.Parameterized.Parameters; import java.util.List; /** * Date: 12/14/15 - 12:08 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class PlusExpressionTest extends ExpressionTest { /** * Create a new set of test entries with the expected result * * @return The list of parameters used during this test */ @Parameters public static List data() { return prepareParameters((f, s) -> f + s); } /** * Create a new test instance using the given test parameters and expected result * * @param first The first expression parameter * @param second The second expression parameter * @param result The expected result */ public PlusExpressionTest(final NumberExpression first, final NumberExpression second, final int result) { super(first, second, result, "+", PlusExpression::new); } }java-design-patterns-1.16.0/iterator/000077500000000000000000000000001312550536300174615ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/README.md000066400000000000000000000021611312550536300207400ustar00rootroot00000000000000--- layout: pattern title: Iterator folder: iterator permalink: /patterns/iterator/ pumlid: FSV13OGm30NHLg00uljsOu85HeaJsTzB-yjfBwCtgrfjUKXwMovWneV8-IcduiezGxmEWnXA7PsqvSDWfvk_l1qIUjes6H2teCxnWlGDOpW9wdzAUYypU_i1 categories: Behavioral tags: - Java - Difficulty-Beginner - Gang Of Four --- ## Also known as Cursor ## Intent Provide a way to access the elements of an aggregate object sequentially without exposing its underlying representation. ![alt text](./etc/iterator_1.png "Iterator") ## Applicability Use the Iterator pattern * to access an aggregate object's contents without exposing its internal representation * to support multiple traversals of aggregate objects * to provide a uniform interface for traversing different aggregate structures ## Real world examples * [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html) * [java.util.Enumeration](http://docs.oracle.com/javase/8/docs/api/java/util/Enumeration.html) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/iterator/etc/000077500000000000000000000000001312550536300202345ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/etc/iterator.png000066400000000000000000000631641312550536300226050ustar00rootroot00000000000000PNG  IHDR4^f;IDATx$W}YqGVD11Yꬬ*_O]$ 9%ξ9%s s{ANaz 'Dr ANaz 'Dr ANr0̀j" 4ڝ1XD]BS1BoPbyXuoշ!!VD3BS1CA3p\L'$6PrTIaԆ r ANĨkVGY7 *A:+/[O~5"UbkˆuЃ=W,RǦ%˩v&^M4Z%J,SHf1[dmz*3 W;Zo䕢>:~#oW{v.8qɅw]z^S#:i#fh&%Q,R,?u$qV+acdb.k( GEҼg4 Xr:zM']te 'ԁߴr)]H8iy{h[*-;rRmXEK)p|B2ä!@z; cM5eg޷>|Á?k.[]GTONaLnt9ɿ˜sJWlV'lZNCc42 r0rzōWxێ]G~<ϖZ/Suϥ+EQd\j;֓,+]vqS9WSS]~Q8?3&Xrq^}G'{Ŀ<^*xaͽ5~OR1i 9eoWg[jK/]~r*.9CN%H @':fikn\ك?xP+%f:UFN;^L:.>QuJ}ĩ7=]ųy3D(nnU[|e|xyzPZ*r*[r׳˨KɑFtӎw|m\3w7|w[p1Xr"b9 '0=Xr"9 '0=Xr"9 '0=Xr"9 '0=Xr()s՗UjiuUwAdr AN:FriZBdΌ.'/DS ri!ܿ瓕f+ʌOSϪtz]҆yR+ Xr $OnT~ H=U)<nTz/9U},r ANUK7rcL9|z*bӕkz6ǑJ0s~r ANG ؒѼ&4G cM(,ɄRjdXS}B@ L_|FJg{^X]FN r ANDڄaWqi\9IxgbgR2k ټjd4RSYrˉ9 ɢz9r0[^Z;^>J] ']87"l֣*i.U_j @N`!ȉ L@N`!ȉ L@N`!ȉ L23s~LF|o4rK0r"ã 9遜BA ,9遜BA ,9遜B&zbT&"8XH# 9 '0=XHKH ;:>''B* {kGeB@N`!r7&Vi7pNEIr2r"@N`!r ̓Hwyk\>7LfDLNDȉ 999 GKj9Sz9D@N`!s9y%Ԃb@N`!5<4<=rʔSW-Bj 7_GNë!bé܋#yB ,@N`!ȉ L@N`!ȉ L@N`!ȉ L23s~LF|o4rK0r"ã 9遜BA ,v^~/,?$R^Ns_?"$RUNKNJƗS0 ym[fC֔JϢVolb_4eo? ,zf VDMU6V{nʆE頧Bt~ț_E`'z(TCG+rp$rsW6/Hc)@N`!9r+}s<x ^vzÃQ\iԁhap#K~kz`CR_ɰ7D/J,T5k%=ީRT'>t #JhrsWe>aMaz^5VPBűrd򵥯n>O0~/ *~I_a?/䖟2dA}V(`TTlG*->(,*UciYz7w|?Ru~HXVXMXN~~swbpS,,''epaN^[~Az}¢E|Q/1V*!=.qsW*O[ ?m19d\,]č^ DI5KroZP5R Rd]_NT#b={j[ޕT}>P|/S2rgd;/zw}]O#ErJucPG*a)K˩bL>rlScS&ܕO`ݪ~y|p %'o_{CW{V@^3GSǐ~On6d[9;,DYCIF}ܦPNE%=c9dT~֌yx9xQAr$'>_J.dףĻn5/M=ot2L,R(3y0SaQ~*1KeP۽])Gjܭr+#}Y4ZìG>'gck7!+`H܎ Vajs5DQANOӋQįrڒT9 '0=Xr"9 '0=Xr"9 '0=XDr*- .?JZ嶒2A4 ,u9u$э;7 '¶@N`!rgMP}6)v׎vzD ,$GNLu:ZvTaITs{ 񌥉ԮDd\SS.̭NMFr ɒSL~ߝFZ=;X"',&VYr2$Ъ f.V> %Rp)$bQ2i0Q'gb=,~Č5]a{Dr ɒSLYhXBvTY:Lr©LI6^ & %Rp3Vώ&a+Hi8ȑbFNR>;-A ,$炈Ln|vTEjܣlQ]D ,$ONя]\zh ak}>lp18zm@NN1`æ+#kkkANNGسgÇa}}}vvZ@NN2 <ڮE lpcǎq '`g+lnnҡC)sٳGO 99;G20YQlu1f#"l3gt]1)`!⇿*70Ubsss׮]ں99;lc0r>}z}}Zd vzҫsssd%)٠1Utر={n`6dlИrvɼ 9fccCɊ '`g6 ]2b.^l`Q o` u-Ui萓SAn9i'4z~/[='9c0h{ rr v6$]~u8{?/{9r*@hi׮]mWlh[o k(F`7Νwd—E#0O%d4)٠#HNtofg~4/*:*"A̙3mW2)٠ sNE eW=usgk%NI HhgϞ[ou6rr v6hCz׬tA<==,--ϝ;'җ'lVANN}طoO,qM9ʇ :"l$$DU^V'lЎ5W]8#:thnnnUrr v6hӧ ',g+?w;!'`ggggYSb̤i'lhSyÇWVV99;ٳg4j1sCrr v64]Iݠ@F|r&1T;vXU rr v64h=HqqqZaiiieeE ̽$99;!<$^&upRr@NNWu&C逞k~hrrhg{;AL~!JSC4ȉ3D+x+^!L{V9EIJ']oK!r" ъ^Gxf}rZYY]%¤R|I@NPȉ3*v4Aڌ?z u:Z$䫤L ԅrZv[mpC&GrRJjM4zo7;孶w ")S,tׇ|?!x K^go=>Qrr uK%Ul}|kkCB~ʟYu CRCQN6<uaVc韊p#}(Nl(PrajCY˵F/1ZmHK^n]>hѯ:݅^tp9XYQE2nx B{9!^C$;,Kv0N_yJ-\8nYT>_J>thH19yNڑ~(msjK8o$ޫ-42nx Bo9e(<^a5~3H[XJNBRwfPr.Q#Ɛ& )&pjnPUʍ*[̺r[N;_e~ɇ_]CRבK+yXO]Hx EytE.wFNu6fGNu4|enKڜ^Feԅr*˞=~ϒNb+qK6pB9ڔ:\C&'eK(WS9'hSGEVB_R?Χ'֑bX`ܻ<ꏼ* ;ةB7֫)v^c XN6t׿qX,i41Er}ẛNCniuњ^xqC>|~D7e1~8g 3Dz0+Oo*1,9{եkw/Q._?b'ng:>niuњUg{'?=O}q[GSzxr &M]e9+6ȩTW^_~/}_kE<KDl MIqxӍ*y#'06{U>q?QX?̧EMv(Sj=ٲjO3̒?_w剏]2gF,~ lzO8gUSS-0yLiSyӑ'{_|Χo>zx6ErRz=>kꛓ2䔽]I2sRVb3- "rKp}_qe_f5'\˩ 9iED 'hgz-_?{c$Lor):pUOԇJzzU<7CLuWO0Еo A<)͔)OX˩lɹ?Kɑsk>OS>s&iǛ[3Gs\K>z6ˉ) QW ' D@NPȉ3ぜ.Qg '9A] '@Nr@NDu:99 9urr<ԅrފNLW UK&9h),SߺJӦh:\SC.S:=yD{oM6+lʟI]y2cw:e$g%݅^W!iVJ0/o54 l 9A]h"'k|u=)k}/X8)w 7!O,-E g*ŲT(^F"MO]ǒn{h`Sj` B9)*D?(;~?^~bӕkz6 Sv:9/ܮc頟rM!' m.>Ww0;H _gHfuR3KV~,ȩԅ6rj凭-Oї\:a;R ))k8rr!' =rr<r i+Ah@NPui9M퐫[֙|_n0UN @]zQԨս$m6rrZ5'B'B>)JCO9pP}jF%m[(٨(*'ި2q/P'8XN-}u rѯ7s3PLJq|fU+9D%s곓J5`u{>Œqce:_3MFZt FR jz򩵌_~ XN?s[go;F1C)*VV)gZzl.L_ kՕ,O[*u.4Sٖ`SШNE㞰VnT1cl\O 9Am\,]č^ r";\d{r-𰞢@U%R rj)OҀF-OYjt,\Fp#{araa =ol7XNOyGzO.:(*V.S)?Ĕ? r,),PG\ T˷O~a HitD#'IwSo_{CW{V@^3GNI>@/],I:P4N&Tgcꯙe}opΩ_+d'S-<j_Di7/[J~Q<*qWє'i?VJTOR5awgRr r2. mT 91 T_٨r'i P F.Qg '9A] '@Nr@NDu:99 9urr<EMr*Ɉ.jɩT7Q2i[ GA[=vq 99Er[WuZD}J[ G夘$۪6.St#rR䏜jlʓd­O ׮ky_NXk1as+61]`Q Ru'%kەHG.}[VPUNVc[ ępU9^Ib[{[&m-.>eKe~~+ 2lF'Ǿl(U)L!:X^ף|X: 743r6ĶM 'rzϿ㯿W\y /[KeEaU r:uYˤPe{SoԎ2%OunkLo*hʵgܕ'j ꢔ^G^vї]ˮ~e&ɤ'I3B:#P|F!_vR.bTДkτ+'Mb[{[&E)9/~i=_<\`V/P>f 0K3 #X tS r#pos$Um9A]ێ|=baMw+F 2x)uSNAHB>Lu`pϭ 7436ĶM 'b9ͼﶜ"f2Kud>a\9%d"U;j: 743*>zV uaE{J2?œdrfVx9w75ATAL' 䅑Ilo),TOC[ ӖIL' 䇉Ilo)lO '9A] '@Nr@NDu:cf rr Dt.hUNr$bSyk4).jMs qRt.(+NWNr; xat.(%D; lexfO))@ԃ'_v@dgOXEm:7W} AArb9J$*]N΀94^>xF%=XXؑ9|k2>9h]NQ,RDcQT@xnf)\u2볬vuDIJt.(SD8TLy9^UI$\*voMfBN(.(SD#'UP>xcɩX9}ks@NQꂈDEԩ?k+R[9b/5u9EK W-H'Eԙ=;ɡU@WIctnzf}v:EN.h&\ػu9EMrR"IJ}@sк)~Jp6'i+AAr f%' hZS 'Πu9r" hZSD;D09&B '`g[v۵lܜO`)SɓΝk"ボ L99;!ׅڮ '`gۮ8 '`g;~CANNv[=ڮ@5S?q '`gJ۵( rr v,..?~Z99;urr vl`Ν;7??ɺj)ٶ0&pe.VH2)ٶ0Jinnncc yv{Cnk̊ '`gp b([/sc_yPLI} 3Z-2t@NN6P 17D aS8Zc~nssSNXA\h$)نYkƺzܙ3gm=!F@NN6МRN2%# Z\UL l)9W-^՝?U<9ANN6B7H҈~ʓ\pu'wxA '`gN=TzjsssO.% lȣDr5|샺@NNΆJ ` '`gC1Om\99;JArwhl( ~vANNΆ Z99;-S2KKK+++>hltrN cK@ '`gØ$={v׮]V 99;'}$)0Osss99;*xѳgnoo ?mzζ[7l̙3g>k׮B?޽lw '`gu]!$1 ᧅcǎ]/lp e]tQ5;ANNΆnY#;W;y껏?:>vS~(h|~Oxx6jIa=iT mGfaDyW|}?;|xgr œ B [qmEfa|?斋/[}=xſX7SJ'1?G >??v-~nv`fi;>Ṋ t]v] qr" Cs9p+,}?v-ftov`ɾ_N܊k%7;0 d_/ٶk5{@Nrwy܊k4;0d_!'nŵr/ӭmĀf #ĭa@QN;j.JrޞiP'4;0P>viȩskaFSINdu^bؒ_^wigceoaHe2)qzK TaiC|xav _2hv` uIDAO}>ꗽnx\JN{Mc׊Գ^Fb'nTz/ XuFNLOmjÌfPX꯽V3y> 'o U!\Գ9TZ-煙U}, 3EN܊kf4;0zfP*Fr޿1Hy1V]蠜t 3̒rloo] c#'Or73O#Hg~6_N)^X]FN1ɓ'ۮԃ1sNAWqi\9IxgbYgR2k ټjd4RSYrݓڄ1`W)wSr/-^>\] ']87"l֣*i.U_簜\۵z0ف$'B0HN܊k4;0d_$'f۵0ف ',9:tرcmjf ĭ`RANYr:sݻۮԀI9fi[qmf33s~BӶU5ۮL r:0r.:=zkbXANqrV\;0ف '89;wnffFvE`" kv9ɾ0NN;܊k5;d_(ka^ANrZ[[;p@۵0ف+'Qh`omD9q+@g 0l$$OT.I(+L@I(Z@[̔SrV\1ف{oT Qr/Am- nI#DvRB*%lveQ}ľfrZYYYZZj0>F6;ЖB9כn3$OT={G+J&J&JO%nϬrj}] #hK53V.)$SGX*}IY=BaH Cĭcdm)9r:{}Y!$S^NqU)uR*xsX-A۵11فL~IjoT0T唖#'MV\1فLt^VG,^]RNbQg }4ˉsNz>??v-`LLmv'I=_U'qxCtL/j|rze$_P北aΞ=k׮kcbj=1>F:rV\1ف a' 崸xk`p AN~lVPP0ZN܊k.7;d_-ٶk`p ANrwy܊k"f7; d_.'n5 OnVqG۵ '#'cȉ[q f 崽=33v-2f7; d_.'={N>v-7;Њ*ry%_o~zLdrV\1فVkiǏwDVX 'a&᧶k0فVT{aBȉ[qMfZ1*%a*[9*6Чى)؇ 3T񭉗kv79loo] az<j/QZjd.aڎJRvȩ&#m::ޢP)BBW? =J9H;4 ڮTf%ז`?T/(Dm^Ȫ^vbSr(?ullbz:ʱ@-9) -^슜8lhvYrۺ?{1OXN?_]NWcyBJ [̊RsN)co-0v.Nnz[$lPKhB^~O _XXNNJ)k,V!Pt+_s# X,V%7tСcǎ] (%4!KNOyGzO.:(S MEJՊUֿ,P:U(rsG>|Z@)iv:i*q 4nJMrV\فh%'INΝ](ƞf: í`UANerZZZZYYiPUZ9immmA '29q+)XuSbfnbJ5i=,@I(Z@5;hTNXU>9q+]τ;+6vz>ie R۵lkv.9rReMtAbIls<$̓7}rطo_۵lkv.Yr wh>Wlى򦓵ON܊k5;h,9U˄UzrŦ*e?j6kmasssZ@6;h,9U˄쬳k"Wl$S|em=ꏅZ$KN2d+VK0))fm=|۵<,lv"9D˄+'KsJR眦RNgϞݵkW۵<,lv"dMdU\7s&lZo:5"jbp[HB%sRMt[崸xk- SF23DL&퇭rV\ͱA[&'e`hni jz*ٶk-QIpyq+X}aWgmv ɾXNz] PcmV@NrV\A+ 'b9moo̴] PcmV5\V MտưXN={>}ZL)))g­=) jO 2NҕO9.ra&᧶k lnv0}rT 7laZ(YhsNy':o_^/|%2SDYZת) '?rjOJeUM;{{v]Jޑz)SjVrIUZlrO$?rv۵$7;2Yr* 8R0)8'$Zsh8R.k"SxKnZ돜*vOCĭZJ%ҙp鋤Le=mzڈ<5ޣIM'fwZN!'kCjv0T*܍*3LgMJ&*9\C@d ;n&\3ު!G>7F|vVVVڮ qȒSLr(@eHLgUipoLYȩ k0ġfS KN;e2Sf WS{8SWjv0rS&nzSτ{[Uri+WvˌsssZrZɗTLs:Yz]j[F9Օ WzN'KkrZ__oVSpu紲&gڵZrZBND᚜vWkv(ɾpPNǏo\FANrV\pA̜f5m677gggۮ 'P mע5; 'ܜ~ m] GAN0gϞ'q+n '`K0X姢:Wevv6{8ܘG-]=ANAT:t1SJ"+V0 'P 4 w?+; O#.]~?]Auow[ 99@r?.wpZuQЁVgoPHu>sݻ 6$*^VUr ԝ{'_??bb?r묾wJ ":0cC7kK:Ѹ&H+uVO9@ɞTt~vĩQȅWKǨsJi =z !ANAѰK?h9[KiZ9`PVjDHGN@NhW⊶p^Xb:WWu>wL:W}KɑS&ٷf%(]2nU\}.SCNANPTך3yy:簴Rc%H- fuOnw0xz TskkkbPMa噷Bc 'hY& !' ޅA 'h'/Su9@>}z߾}M^^k v5*!*/ɘ989|>}7$nM 9~vmע,KKKPO+ohV`(:tH !oM5`;vLH^pVn4@Xv6 ;{]vTrANQדnWi9@kȓ۷occxg?̠0ySKOB4MhnnN @NP@z~#bqѳg5677gggkr#loo/K^]RUY r|#Y^/k3g>|x׮]Lw_jnn r I5`|n+$R't%S)F@NKE9^G8ڿ^2dV 'h"R]tr2+Ĵ䃜 mQ킈ɍ@N/%o[N[ .xXZʯӮr[j)&'TGݐ8A=XJ`]*9dio[.w٢ {ju {뿴_O=jj0B^]u%i >eU5So0k9rIiE*UB 4vb|^G8QFF G< +[*%= UTok*VTU?r)kRx,K¨svZăh_)64ɗSVj+VaQH#'pGNqOM% rg_rPMN2)dbgTS#FN$TD?NrRJճI%'9!t^hH'Ws60uƖN&%?֌uYXRpL"-v=^p}ڪ}C.dG{etJZOyrHY’W)FNr'HN9 '9 '9 '9 '9 '9 '9LSN??GC]g?XzwoV 'p雟Y8+w.{#r?q?%4)PBNu)bO"v㯞Bt|O4WP͵jn|&f rҭow6q~}?联6`^pYdyCkܖVh4z0Ub 'ə_?ܣG?E-XNil~FNfǞlVS[ʬ r)Srū}+E$=y5_og{6#Hk$?3\$G?|'??[/WRrR< d ):=YGqiU95AN39Gz_N w{6- d)}Z[ܹpUV<躃 ")"\X킈y֑@1ӑOW{MbIL)m.Y!A r . O_q)& `r&#73c~S/kn=OB:ި )'#=rh #9r2+8r2+8r2+8r2+8r2+8r2+8ArN]>)Ww Nо. 9Xr gD 3K I{ցXٛ+.Ƀ2c9)Y\zK nڐ4W^}%^—#'%$y"pà'K^7[ }q_.%$4B@WkAYJKFkQH95rXENi*Iq*ꎥ9mI 9|z*bӕkz6ǑJ0se~ `9%C:Pui{#%PX$Yu5v,Y '23r4/w1h4tFJgI셅e0s ڌsNIZ;K<>Y\U#뤑Bʒ ^hj9˽Fzpw-tby[^xqoW}r(d,9r'@Nfr'@Nfr'@Nfr'@Nfr'@Nfr'9 WC-9Ft9FNɬ@Nɬ@N)93ïUg~AxR 'pSBKWY GNS N0a=^N$, I ٻc+Jp$KW@Ni9֓_exꅩdHRgU4L<ԕJNuZr@CsG{">uN$'U_?lLr&䄜vTrO>ğw?}Dk8^.o%~ݑ ѫb%(7bWK>Zo5:Ej姂O6E99 !] jjR(G$Ap/9^us%e 'CNPx)/n2x.HUt㯊[J܇2? /rj 0i9UɄO4t4wꩨͥ$'EN99Ʉa2$)E;ͥ?lb)ftO rT6n06sDKݐK7ʂrI[FNZ&EN9r* 7<8?rt\SJEYIx)Ɩ"'p9f G'DJȥVZ IxId _NebxکW@tB*MDEIxu]N0&̡5UP-n* :w5IxMO jQ&jJ td 95&ENɬ@Nɬ@N)9 W@Ni9 W@N9r "n끜 8fU]8/|/D9IZN!p$'K=+]Q&(!'"'1)rGă-䔾a9g GNYE!PcsA^Ǟ?U<&׉Ir./w1PUx"*E9Um 0_K qSx*;u$K[7ZO oWg%`}NZBCr 9f*` ĕNEsY1lANʉPr'@Nfr'@Nfr'9_J tE쯆Zr@N  nIENDB`java-design-patterns-1.16.0/iterator/etc/iterator.ucls000066400000000000000000000130161312550536300227560ustar00rootroot00000000000000 java-design-patterns-1.16.0/iterator/etc/iterator.urm.puml000066400000000000000000000023301312550536300235640ustar00rootroot00000000000000@startuml package com.iluwatar.iterator { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Item { - name : String - type : ItemType + Item(type : ItemType, name : String) + getType() : ItemType + setType(type : ItemType) + toString() : String } interface ItemIterator { + hasNext() : boolean {abstract} + next() : Item {abstract} } enum ItemType { + ANY {static} + POTION {static} + RING {static} + WEAPON {static} + valueOf(name : String) : ItemType {static} + values() : ItemType[] {static} } class TreasureChest { - items : List + TreasureChest() + getItems() : List ~ iterator(itemType : ItemType) : ItemIterator } class TreasureChestItemIterator { - chest : TreasureChest - idx : int - type : ItemType + TreasureChestItemIterator(chest : TreasureChest, type : ItemType) - findNextIdx() : int + hasNext() : boolean + next() : Item } } Item --> "-type" ItemType TreasureChest --> "-items" Item TreasureChestItemIterator --> "-type" ItemType TreasureChestItemIterator --> "-chest" TreasureChest TreasureChestItemIterator ..|> ItemIterator @endumljava-design-patterns-1.16.0/iterator/etc/iterator_1.png000066400000000000000000001474651312550536300230340ustar00rootroot00000000000000PNG  IHDR3_cIDATx \M%&jBY+L6d)[Ɛ>ʖ&%dMRD1HEr-us=}ޯ뾾9ysy=rK9+@) .PLtt4ޯYF/ni(/ck/_Wv;zto/_FRۻwiӆIw\CC(4Rw5^LpqrYIzZfWǏp&k]/^R> ]rrnjkddP^^xSTyKKs:+7Rw5.:u1ԿQȉ󻴊 hbb kZ}vd9 syrBQSm--xذiUƙ$j&T*gLWDTliԀ 'a'_?Y1>Xsjv\ґ8KIMj֬ѤI<>23>w(-b' K#y{On ##{[Y[ g\D @Cg^D66p@3M90}I~c(V ~7%%R*W+_^RϢ6liM)m4mРVyJ =mڴ^ŁgtGSJeKKiӆ}-X132b)&[2Z:uh n@MMFƎ[Jdy TV!CS9ظq]Tn=Ďa}t,>th1,l]1;Q&+R,pg"M˗ Yp֍Xtg6uGZ,v9{lk9]˹>r[)rf%=~KGBp=kEoɴخ̙IǏ$G#PV JSDŽT?c.Ʀed$ ~w߾r~=^*yy)>|x -zx8(PYU%EJf~ʂmbo߂ϝA)3gd1;Qʚ@#G(ݻ[t  ֍X.vv\{n'eS<ċ۽3F4pwmrw &1ֳg[N璓iԨn^mlbbС= tq"֮]_ wGvs$*|ڴa^ر8n\*~WYaetڊojX K;xp#G:Ut*T c@-.2h݈UFIh]qZ;pdql}WqVM^Od "+W]ܹsפė/#{սdNZ*d&mEʶp9[)ҥ%ޥu'L*+PYU)r$++NwW)+޺u@X Jw0ŦqvE +3E@X^2S]֭3۔]x܄4~ZjP*x7h%- da0 V:>)7 gZ2ۤI=H6zuC=Խ̞ME-?݁::: Za tcEX=ɿTֺ9s8MHح[~ɒoOXONT__`Q 5kQݨsqB@& $І*h߅ ~TX2n}ȈV˗٤]Rbc4H=;}{*tN(]\9?{λ^ikېe矰WȉKO'=".iw+<|CN4e,\eLOXhYu*ٹspÇװe]WiܸD.\8,0,󻼻[cؾ;-PR/B:d:pږN̛Q.iw#NN_լitND?y)|a 996S<~|_w t2C1a%wyq.g^nX:'ON%+]󻼻ۺXG9[ŋ`|UB ~>jĺzu/sbvmݻWl8Β;..]P:uLj׮~@,'~W\lFF~bb -i֬Ya^˻ʕ#)S,Y-ottrMm~4VȠH'5DDP VY6mZ**U*sO>8+UdcRwW{ց['GkmmѼ% wg:e4SR"%7} ,m~4VȠ+55Jn&ZExMFXMxwutJ ,ag6 Y5{7AAK,p/v![n##~ƍ}0H3 43@A!rs/xz%)San)CXغ#hm;ЪN?Ԟ8~ >{2%ffҥ%={}4qlFϞڣ_N-ZXwQMFɭ:vl-U"*j৫ ~0biBg6C/`'޾;w)'#ZjL+ K &aa8{vۘ1rQy./]6iø8_T8ťoierwW8~ʸw#&tFh#=ߏ`92Qoicw+!cb̢3`= }.#s;thu^&}4ͩoߎ|\"wWQ~*_U 43@A!""|MFGgAtΜc99wY ]v[W ]BH|} ېc@ InРn`/W\E~' ~J2bv3ݏOw;6c1)E\[ ]ADyzKH؝ynؾdg7$+)x&'RD捻DY͉=!)~ۏLmv V ~W F6ww|1QL).x/R*Vm~W@ed-'4yw$H:uŠ  z ysbJti],bE]trڴa99%TliVm~4VP)c=tQ^OuZ2SssZ,}R*4J+Jg6 A+]d(ƈ"V|M +BBZ>3r%YژP.-6R4qU++ի'=ztYF^̣vMԋYsG(*vҤA&&[k?naa9)$oi$om~add`o_wDB ~1bs|CFabD-NtȐiqdaɆliMm4mРVyJ &qre kӁb}}=CC}*bXغbɊ-_^RNԴi}*pd[ic{(ew/r|_-Fw!Hc 0w^$VΑ}"gY3ܣ(fgfRr͚F8 "WJk~G)b)9==&%唟.csc;u9|bJ!whPaL&1_۳g[Ndv%6ڵ-޼_R"Bb=n&'ҨQ]zۺ{*laaX+(9ґJOPA*p7KB ~1b=zH=܎%]ԅ28U6?C5i1++˗):[Eʕ=yyy[PwR,ms)7U/3W: "]dՄm$ǭ[zjÇ6Wl Wwߙ=>4l;wΣCfdKqcԩCW7l J<>ŋS_ =,-QQovvff \gB채 ޽{H˗˗Yt\RIOO>}>&55i -.2jBg6RgRF*\{,g:<Ù3j׮ijjLv|i[Z3@e^ H~˩~3\YŋmݺIǎvʗ׮\Ӹq] .T wCBV͞MPВ ܋]ћ7X;#"}IߥK{we [רQ jQ[eW A ~fgȈ-߽qc_?mD-^dddpvySg殮ŘDD8Z< 3~WٳptDinnOO=$7eʐ޽; -6v^ΈֶshUNϟoi[r,)QK.-)ٳWi/4Ա798nujŠ@cg`(UǎwFh#w˖Y5j֩c2lҥJ#[K&)01FXe~ѱ} C&]d4~ر})};wS&ODϟGj՘W 8x_ԧmcJ~K~wѴa\/ uT8ť %/(nC]U,6BuFh#j=޿}a U7B ~>{.Ǎ7۴i13gŘ}(zu&~ݻXwGt7СսzDp77};~M/KKsU\E|:#my ʠwӌX>Ӧ f W:gHZ|挱q՜x,.fw%޾EnmH1dq 7hPKR0A=y\ W%,Tg#G 4RJ A+]d4#9Z.!awf湱cmܒy^KzfYiggٿg77'8A#&n\o|m?2b(Xr*Ν066֭ݻq3h @O9bed-G_G'/C}<*;#7oΛ7nڵ?j&4 ]X F,MrqΝ;\/_3Y .2`3JKK۽{wnݪWqܹ|f4VȀKȨnݺ^^^6Ӓ%K(X|9:::˖-xժU+WO }RaÆ:ulܸQF7ox;vxΝmڴٵk;w8((a߾};;;|cǎ?~'ON81<ygϞ]~=99└իW~ѣG{ŋ_O}6''⼼\r̈́. w]ccc- Y7rlӷ wH7oã855l"d%RDvQLF$#JP|G_v,29Tm۶QQ$Mϯ\ٳ ,8**j̙ ɼN43aaacƌQLՕ6!!! ]S^zݻ@{{{d۶mKb__f͚Q(&3miiIM6S(^n]5+k֬קJ K/_i.PH~1{~|B9]T@XqܺuۛSiw#&tFrwǏ_z]b]|L!i~w_6\&>w~W:#edgg=ztРAzzzG_30>w~W:#R VQ^gSiZeT .2jB!{5r%vZUD?=',Ymu-HS>O/Sb]x,+nϜ&R |P6[Mg^'03\߾srW@XzUw~yss_LGvphe{w6md)7(% tJ1B>j[ӷ̶zϼO}|+ PڎcvĦ˜춹S Q{5ڵ .NN_My,YtyIzZ&CC)99(/Iwf\3`}Q OK-ixD95lXWmݺ_2(Xщ 0I(p>77VnثW{wҒƍNR*4iC:4gtȊdlWZOΘk,>{vۨQTkO:pjtNQVsIů]+w4kt'o{q(LN?!a7y%K=qbU-IJ:gC3%&zu-%XޓmNPϞFޜ|ۙeո|'ޱl4|Μ/_F?} 9Sn茩b0+wˆC+_ZDrΉ}}ooC"ѤI=Iͼ[H ~3٣Çא [G~Y eIud;,y+IJ,&ckPY!Q<o /}}=YF׉hQ >Xޓmq9%ɓ5jV㤖S<Œ%K% *覧ǰF!Oȑb! ~h;zݥc<:)7s\p 3?OXh,YZԩMʙwq&&Ռ LB@9;sN ys?9yAI@KKse(VF-'Ξ ɮ!=iӦ SHսқɔVe8O յ6۷`5o&!c* 6iYbmDYa~ؐ3)lEJ,眾>ٖ 16OR_2gdľ|~Zs:sN >re= ]&/'9X~}"}'|ŊYΤ::^V㤖SꖧÇb`@nI~yZݱcK*DzR6],.DmS eǸ#\ujetN9'i'BqPi߸q{Fz.>#=z|Ik)WvdV;LY2;UVhۨWڵ /^դI=ob^[beh^g>ЊPD=i;Jn˻l$crsfVٚS<5^Q:i]2TjvWᓾɯp! ]3%|ߕ-=],*zcG%ТʜiɊY[[pa'hժ%]ѫVyVRݻX~Kv{:ZK):'™E}Ή8:PA)0q)%(D`yOޓ,,Liw*.]ZMUZ~T"]{T}T_w(mqOV۷gU 1l*(S0bxgN@#wg]GͰa_9OzRr'gСY\/]7N:'YxxnaSL:zuC꘮_R<{@Q{L;ȦZd\ح5iQJ^EDꛖ#B&s-v +hG(TE/qSbXf[mjo>iŜiV<"8uw#g;Ka~7++bHȇtr~wꉬ,ٳƦuMMβaԻwߥfxPGgMnѧڡ3Sҥ(K>TwFh#yR-c[pw˚v__wA܄eNӀ %Qw"N=.̬:E*ur֮]ԘCgP.Gnr+ysb2ܴż&r~SP Uʉ~3@-;~=zB!J o.ŋS.ʶ0R.2dF!^8 w%ݽwU̺Һun^n*N#79 ]S_&*Yxx9[v̕+{xm~4VPx Pĩgnr/U YW(Q: |O,MB~ԘJKᝅ7EjG A+]d(ɌB~SH]Iû.+PM""|NXOU7_t9,gl{{~l+}ⱝ:5gW7Ej~w!Hc %Qq9K];n~YW<=]:;wEԤ0HObbR,2/߾MȏmI&JPĩvwAY~4VPJ3 q*$/JOlrIRxgQ=5Oѧ)zg6 A+]dLj%=]Y4M@G!·CP@ьXlhwRz;#*]d:mo#/TP@]MF6rFA ~w53@ȅz9*]dՄmo#6r*T FFA ~4wKz9*]dq> Rݺ9Mnm.v6rFA ~EHߕDF.!P CIfR6ozw7Qĉ2zw0 c4@n8M~mo#mTw3 )Λ$]n_wA)=-ZXTr^7ݚ&]h%6 .2pF!ys>Dy]Pz,Y#bkk GM.vw%Z6r*TȠ>D*$-Z4voXlk0!a]mD4~']dP׌BU|@˻  ߅ .2kF!}> |dl]߅ .2kF!ys;Dr(~O .iwf*7).4V@ہ߅ .2hˆU6ڎ&26r*TȠ!#V~h;x9iwACn.v6rX &tFh#x9iw~W:#4V FA+]d)μЍ@(C.`ҥBW22C@ dff ] 4.FA ~1%t-((.T] FA ~1i&k@F4*o#B ?4i"t-(hߕɷCP@ <}OZP Aw5 A+]e]X Ýe]X ϐk@~4V(MMJO|^:>  ~1x1k@~wjpss(J8ߖ-)x77SVnؼA,klm֫g6c]bsgGn422/NQ߼;'P#w[T}8xd@ ̚5kݺuB2*k߁< >]ry.K+W4n\1c+KxqߕMw>]p K&a,gM:vcݑ~f9sEՇ }2 """\"t-(Ө𻿶ݜiFIS\ELD n<=KڿMNظAݘ [׳g[nO`OPzFu4EHq 322>{JpwO&]@ M[\⩻S1$mB.OQA/o!YJ ޥEw32b ) ZҬY#ii1&>'Ni^Eڻ_˻# ^Se_-)xŋSGzT@ :tB2*kat:iQ\]Җ-j0Sdذyn^vlnJ27pa'xz ܍%/K8:PA֭ ;ݰKYbNN|jU޾=KI5rƅ_$n HWZPQwk}bkrs/DԏFtd˹R/];w] 4%6*??޾ţG)ԩ? ^%R.ʦߕK. T@[_]芨]v1~>} ]5+VЮh%w] lڴ6==]芨]v@+9vXnffC+R*+Z/h#7oެQƯ*tEJ ]v@$''׭[788X芔"b Vrcǎ ] @Y!33]vK." XAlڴiԩBPV:tÅE+VЮh% gΜ2ҥK۵k)tEJ]vR֭,tE>b V+t-"_Q͛7'~W]JOqFk3>433 "]v@+9uTbbеt[[M6 ]O XA@MMM޽+tE~W]Ə27oxyy R믿j֬'tE~W]OSSӬ,wCIcvUh=))) 6 "B+VЮhNNN?-ZHLL|1} ]/vݹsy ]+hW( vڕ6p|+"0b akk{i psZl,+VЮhW4inJѣGk׮++ZFVV^jU###DW ]M~W]>/_ިQS ]u놆 ] ~W]x)DJwqBWD(+RЮ@<SB.7|ƍ @#VЮ@O~͚5x%7o޼ٶm\+]MKnee#*n@&MTjҚybOO^r?Ù7uu˿xqKy4<"G*?fL_##u?ěBզ[ZӁЎXQrY{9{lǎׯ?`Yfu9f͚RG]x(UKrԡS;DEߥUd@)&_Ж/۷#9dH;ft̶k֍%yn )۝;wtuu|}}۷oV%6iҤ]}7Q9*Jw O{}Y…~~Sa*,jڴ>VI_|QmEfw#F8ݻDR-o6+W֋RBBVծ]3##%P/#dXׯ;W1]Ty:yw(6ƍXﺺn߾=**ޞ6oޜۊ۷.\h```&ǏUnմ#߯Tߕ+r>W2[H.kVoߞݽ{o8Β..]X"ԩcB5==FE6N۶}_ٵkǍ6iRo׮$RwyK_УǗ(WvnSTy&Pl>|{<ǎspp}{n%ē &lnnB#o"Ie==gϞQ7jԈ4={!˖-c7} NLL8((Yf6qʕ+_~Ju~] xA!~)55JnڔȢe[ll ޏ*!3ܜb)"7XB[nQ_tdњ>zoݺںy.\P]ٳgMLLjԨM~m޼y*60w% ăF]xo߾eQXL~q|R.nnnJJJr/  RJ:uundå~W]x0ހ2իW'OlmmM!?SҠ+hW w!7L#oo?\ʋ/:T }i0P v~Wx@YhQN4 v~Wx@ [G]x.{Z(}6z@MnSa\zf͚׮]" vAz6<&[/Gr9߿' ^O)7|,BWDA#VЮ@;uh"ak%+Zw/]Kj=w\oG.8>~܃ r~܄E 9|6mE`$+ZwG>&`žQExf(~`ͩU۽s% ~w tiֶad䏔ˠA݌ZYY^=1?K~xflG54Ci+3s PB֮];uToݺ֖{(! >n_ }~<Ӕ'D7(!Cꖧƍ뒅%w۲5-iӴAZZI=Dqz ӧzUŰu]JKppFXA~~-;pKvz6[5˜ڮmzYEK23==83\*k4ͽ_hUӦiq(^z")I$=x{i0;*%+Zw|:q{K>=~KGBp=+]9=vlfNb>~޾-;ݻS)-~hj׮IYYq_OС=تW\'/"߽u.`ԩ=zСVV  ea:8l0qaU'Ƶ]Lkr~q㺴GֶzuC=_gK.bܼjժ&&&NNNO:bXA-~Yn;t縡~bJ6~w ؾ}6-^-~Y[?yr~::B"(G]x(=~WR``I]]A#wcPWN˥}{VQ0h&u}zQ/8b cqfK3E|+!7 /)VЮ@<`<0h&4S^ ΧXAXxz4 y*JUs};Dŋfgkk \/ΧXA+aL]_yy[{ϟG* TsdyN~ԶW3FD\/ ΧXA+aLVV..]?"Q"w5iRR˖{zJμ8)7nsss:uh͛[^Dпg\ΉR^ݻwK&7Nc9ccYЁxqR] =W}bF8ޗʡ:;w~4\Y%\Q6KKs:{tٶ^JOvAd~7$d-Y؅~yL壄F3ȷ]355&!*9q~VGLL |C[I}vd9 s]}T{3& uu/YyE@=@PϞړe$;a:t&9V륔+hW DwgdĖ޸-xH__ͽ:wb P˘tD)/LOjժ|ɛ󻎎흝;3}`IY66 $K5kD~XL>Vmކ@s'IzKe<ƍ:th6rhmr/D93IxU'z) p> 4>yz%)San4Qu#F8Z[ۆ;v̡U:5?ޗ+ĉ+WN`~5ޓ).]ZRгg[ƍqgCFt*SRobss'V;*CrTfOoG @ ڲeֻw*%~7??aѢgfV2sn `޼_R.g}%/{.<˛MR#g%ɧrС՜r*]:J_)b<9AҹjVOX1ѱ=$)餎Nׯy+y.:ct˛T+hW 4~6l3Qoicwٍ}(zu/% }.#sWv^^ȿ>}Էoo]q~WqxDE)&ڵ۷gwoeIr%%(O:&kLOQ]e$V޽Õ+ᦢ ޼0khOW׬Y#~WY*>{]ڋA[]\̃ (1tɝCD\/ ΧXAQ~7"gڴa8+Udwطo)$%F%ԫgFEl=YUݽʪؾBݟ^QgaaJ%߹*Qwqh8b ăF]r4xՎsc%;Kc'9]I ~79%~7%%F;9!$ F n5vݽϷ#S}>--+'(EI(IdOZ(z:?j2I}{V.zzp> Lr .B,}<*D/HE|+!7 /)VЮ@<`<0h&4S^ ΧXAXxLzQ/8b cqfK3E|+::3Q?%Co_ko҉bJPjOv'ͤ YM\'&toJr9߿gSQXr*Ʉ*^Ov~WxEv[ȝsOH,-wTubRiӆ׉ ["p|Jp> ]qfRzÛ[mvrT$?_Zףuѽ)`577Œq׮H_|Q 2e[|WO ΧXA+aLJ ZALp2fұ Y+\Yfi;bC hkې +$'2hP7cVVWOdO#}:PghO^EZ [UFLYFE::CysҫVէ:oo~/wʣ&^4OvAr0h&w}gƑ$6M(ݤXZS|ZۡC3%N@(nժz|p> [hUF[7v-/^<6;t~ ŸLo4Re\s&fs_$X2ߕ]okg3sp{0w{۷svP{|UFȹR[~q)TblJJ·E5|+Zwi46⼼6MoР`R$:srN ^O&7I]_?pVVENG׍cU]/Iٖ]w}MvmE7oAQ.˶j'u؏8[^e5?{gWcq҆!$Y34[L"k12a,E[ZPƾ%! ͘a15D=ǝJ۽_Ws{s}G AK.w)g8}z=kl&h>(O^A~P<7&JSɒ:sJK;ѧ{ߑtϝQwwgYL,]Ӵi]33))[HҠ{!CCpJͭ+K 2owG*Ki._II1'Oѯs'FP]ݒ>>Ѹ+gIJbEXZHaLTf,b<ՉA9o )T)wI_!5 I~LNN$W+%۷Skx3QV\.&-EAy Gis)wML1wb⚆ kٳx6(>}tƍ반z,Ƀzl$I)(8xZV D˗wT_8aRbaq>Cr6P"5Wn&W؂yn8zUz+y I\͉|Ů$ ^ZR[:~Eoi&(E=)}&ywIݛ"~~*7'h/ʓWP>wŘrMombM={$WRm[[/)&RB3wFIΚ5t*MG*kicb~+}ReyWͤ [w(L ez|Er1(<~|TmӦY2ie3<9FOr'^?er/E)6~}K]˾} 4Wr߶ݾ_:QQ l}Εֻrݼܾݏ% *BUǯ߿c2_P 7<~|D AA˕+ +}nlGG()oތС.P=vlE孬,~i?5vlŏ^+WEJIҝ͚kĪ~}y[\Pz#Pv)(ޗ'Mz5:.n%s .F3LC{Q.(O^A~3g:OVRokh/+WZ:d fEԻ.leKh('^?hx 17ZWv)>v$7ϝۜyboukݿ5aA:ShF׮JAmڞ<,ލZ4<_}tzj@;{7v=6mZ$Oʃs<9&wBʌucVpʓWPw07ZWh̑#{ҥi7޿Yzرß԰Dx-ᗐzĈb ķw^3f O&KU]K~7oPD_N_pʓWPttJzTPBzwʔA[Fڳ'{IzyJ]ܺ#%eKDwϝ fEݹo]LN#G 9kkkEJW"gw;XfÇG4իݰa]t _ %[7vsw=IԾ~}ٳxr|7z3PzˇaLؾ22ess ӧqsx7oʓWP>e~|59B?^^gφ)%};c)e[ieean^Bm#ￇY[W_G6YYIUJvv6׫WZлih/+WEiv)A@\'55B\^) 20cI)Hњǯ,[6-$79-^""oIUJ=<<֯_<zÇ޽{,411I&}yA5W\J+ e}6YF՘<߿cIb6ibellЧ=Je :fL卺tiyJ$F,֭CK`^~̝zP'Jqnff&zw {9H]J[I&$v^g΄RN0rkkkuWQQ Z5ql+}ժ ->߿H@*YRgQG[KU+V4xqx8\y̘16m:rHjj*)~ÇG>P??wrtt`re_mGG()J~ͤ.i_~+>~~ի'Oܹs%K&OBB4"Fcc 8::>|ƌW޳g۷o\?NNNJJMM%[N?/)Z FݸqZԩSARzWo>S.(O^A~P0aֻ!#S'VJ馦FZ5 I=[[SI+S{/Ea]ͭ{NVRDHhtIE~ rnذen͚Udbnm-% I)ݝ YYI&&^LЖÇCCC=<pHJ`ک}ؓcPvl\:0A22mM3׺VA)'^?(f⾅l=2r|tUZv)ֳF2q'%&anQ>z$r-\CBZu43[J۷3QLa&o/@M^ZզEAy &|?ܾ}S *,%e˸q Ivm0CIOO$0wqj߿mk{fL!Ժ˗8~~jժzKhݺiV^+}U7n￢σvޭK|tnSȖ-wSFӧ 0KZٹ.ٞ=AK˔BӺucu4ykUֵ +WwhlNJ Q]$IYoC܉ݼyʕSS#,EFΐ.4^~ɓ[n?Gn5jddddhhذaî]~#?`-WŸJ^8g  =$|_LX?]*z]zrniK6p`[;:^c [:q _ZS{Pz!zVDLƛO^pk֬>}Aڶm˖TVZ֭]\\Njժ?ͰEs7FAơ'};0wz5wAjJѻDJ\_E[@y .77n8ym,X0f̘ݻ7nANNNGزeKbbիWJ8(((000o ڗA}ߝ~ؗqp+_ʂ\..)+v'qs.w%jL׺F{.Pzˇaɏϟ矱k׮ܮ]5k*UZj_W\o߾+3'OtڵQF ML2K2nތ;{6,55ȑzz=:"w;hjjد_Ǣ]ZE@y .SɹqFRRRDDD``رc{ѤIw W\y4winn!.}ƭW%L_1k֬޲eDKջ$me ̵^'^?@aoSSS<%bo7o:ujAAAƍٳMΝG7k֬ZjJ֖IYEAy Cc;3ŭ07PQ6Yndj^^gφzsm?boˋ/C̜9s$ mѻJ"u]<\PzPXL$(MM َ99-Ty~gQ䴴Ԉ#z0wDҥ9co4gϞȨgϞ.J;wT h/Z ʓWPJ(-c #oL}ؓtvnwN,+}-V_񬄄5Çwzj9ڥKK&LPFE-ĵ981nZS32ViVRŐ17j$33S$|YS('^?({O9e";3]ediӬ7c\\;w~̐RtprkȜuz]ݒ>>߿HN@dIsGӽ{k+GG^Ҝ%eh/cflTq+)Ug@s ㍪Ζ`+\Pzxypv`:$O8Ā%K&nݘy^<:Ddq„$IDR4鳒7aѤ妉I9晘aZXrTƍ3ܼ}{ F2ie~2Q$$$iҲwފwb߿?OfڋrAy C~\'x,!S:('N* MIB/^=cb~+}RbwcEt6m(pa+II!2{Rf.=f@ ͧssϿysĈ۶mkjj +y\19(lF糕 h4(O^A~OV_4`d$}StHqD?ɩLK;SӸvv6DlIMQrsv?6V",M͛1黺:LU27ʡCzq~1Ǐ9vX]R,C)WC{Q.(O^A~Og<0᭏c+}$zJ%5s;6]ݒ7n#Oz34ҥH>=F=Q|؀~i< <1{HzF8UV^n6Yv^n&٦xenַoCԥ0c-ڋ+LܷGF;3┻URFF; vjt\J޹3d.s`2ĉ#"Dwe@s ͧn:~Y2eWQ8c\]m޽ qJ??-x؊~:u+0##eLK zxgMR`X++۷3[JyrK$]+sQw7ԬYIb8\jEɃNXDӧ ]-l8J]ܓ]혿e ]KMXY챓-q=fL卺tiyJ=@Rb˧&w==]ĥWVOD\\fffҫW;qAC{)Pzz͛\9955B"#eO40|**U#ǰaæOeDЩG,gzw<+m:eBŊϟGxUٔ\iti]R)5sJw33OdMLZ ]5PCCpnn*.g΄蔠Gk4mZk\ʔ-$-%ջ;viӄݝ-D%Hӏ=7I^0"^'^?hޅ)67 22\rժUر/gʕccc %Fs7FA]:SpݺÆu%-k`P&==]'VCv"=ہիf0kdv.)]26eˆ2^zӻ*U?~|3Okժgd/b Tc'OԳg[涶NAbRz~, YRrJ @1K%A/-IZY^'^?@ao GVVԊe2ga_t7…?xz̙3r<: ,W 3T-_ʂ\..o3r|8%%~OvlXժeR>}w%~.nn?IΚ59 en݊!Jbg=5ALJf.5k[Ѿ}S mmPˡ(O^A~0h& ML2Ky㐪#yGV$(gtswoތ#Avr=$veMD陸YYIuT۾OZ޻w԰_׻11?J=ss@)ݻwa-ƍzV2FFt!r_WWdFFˡ(O^A~0h&iA}aKRU'| qVԩuzҥHe~}20pyf-[6)?+7]*[ٳCH\EDKe ]K#GƖ& Jܹaƍ/*%weOC}[͔ahڋrAy Cl%mzlثW?FϯhڲSQ fuzW3-%e˸q I$.('^?xw%%n1bD授[tLm(F3)J;wT 2D{)PzPBx}hOr#DE-V,(h̻ő~Kyc7O֭80##jՊlL]\Pz`<>yx6^F:?+V4xq$-偔yyJرOڲoLC{Q.(O^A~o<ڲoӾ$O㒓K6&#C5|A0+Wo`S:~]dpwnqQ[͓nތ166ΕcHtim 7ջtY{LJ R=[WC{Q.(O^A~Og<üqBCg֬YTuu)w#q%v͓J21)7Җ=0~G!3<{OWZn'jzn/>4&k{E[֮]ɣGw }T'^?(f⾅l=2r z5:.n%s@S őߒ\+I۶~[iO#Q8ӻvٳȑֻU}{?ֻ>>u,-;<}zk{B2h/*+WE~<==sGU|EK'&oߔLmM lcN-%ZAﾋ,wہhgv_ԻYYIe]K:HYWsXEE90Ho!3'.Qǎ8th垦с,TZMMvzd>6quj>e^TʓWP>(F3QоHzf!HD`z~}KҥulHYzW"|YJǏz7&ڵ/_&4onӬY= L5ڋ@y .F3QоL :ˢe"Hg8>|y#bޕ;u{utJxq\"m$۷رsXEE455ׯZŏ)M>ze^TʓWPw07EFP_bWG6+;̫w%]:nlrnKIxq|׮DqDjuj>e^TʓWPw07IQW~eCɒ:OwsrNlPzݝ;ZhP%k2'AޛS9,S"PzׅڋrAy C~zwTr7Iwlk~i6!C&9DEDa^#e o$' ZD^+p>/zWҥHҩ]ã=ԱmV keeq~156Qw"ӻU)մ nh/+Wj~/&oT|ê9lU#w;mBh.%kѢƍ37ZO4{/+=CzWLvvn.[7Z,\E]pһz7##1*jAҺ$Lcc׮]U9Ӎԡx(W*8]zXi֍>Kc׺F{Q (O^A~Pޅ)0h& i\},9LKJ4nٲLի88؉rޕTVR㣟4AsֺF{Q (O^A~0h& ڗA}Y4rСLwBΟH񳰳gêV(yaү9]'zW"luPzˇaLebe"䝿͛$R{jԩ}#W*8QZ޻w԰_׻5ڋZ@y .F3QܾH+WJ׻aяڵe=:ԉ4"W1B~3wޕwPԻyԴ^ʓWPttJzTPϓ DucŊd8Ȭ Dseˆޕ^7Z&AZzW]N }}=Pٳa^ܣG$W]+Jf9s~ZWӻ٧(EQxfk"SS#F~KNR~U/(O^A4HথI JW:70իW˛3~'U pb}hYi߮MVC"{5wHX[W0i&M Csaúӷ|y.]Z^eo%%K&w==]֯VD8̤Wvdy/G֭[C2wFFbժ>SU#(O^A4RSStB 4iB2O>  6f̘S+WXd fee1רQCv2qHH;==B333f%+WzgS\|z9P_'(;wbIꇇpsJqΜ )4ڵ=M%2%e rm4anwwe&Q"tSOnIr/G+T0!Nbm13+JCԻ|VZ= jcc#>;e={dn:,--cbb2^E;^n sUʔ)>gӻs:$Ozw֬eT)/ڭ[1$U,XٳGz{fFj''ow\\׬>vlEMhCI _)rII!L:cpKX]5+EbԨQȑWΚ5n"QkeeN={7s7j(999''gƌfffǏ+yef׭[W?|w/02r義y_:$Oz7&'GbssI֫WS޽ ;wn1n\ի0kdO"{uuKfd$ʽ͛1ҙtuu v FPzH\~kݘGGG1۷sssI֫Wջ=ʊ LwLRJqqq6lәBB.,:( Q샇 <tؗkS%^wcI*=wn34n\jnfʕשS}=;{+r655^_6kg+Wzdzzzw%jddt9 oܸ1Iaz7442ҥG.Y\jժuŋ̳rʤ߫9lz~>üqDԪT)ԈUnkku:&U wܺwn3J/)ZF'޸bRYYI&&^LPU#(O^A4SRRSSWZe``@Nwݬ^zլY¢k׮ϟ?gj@(^l⾅l=2r|T2;ÇGu .͏ɦr۶~[ L~|~UV>>իWں:ل ^>III!QUa$^!|/?J ֻ99]xLbOûuѣ#H֭ĉ%л2O?ᣞh%0J z^P,,x5gKN[z>WF+WͶi`P/&sgoBwwgѤ/[âϝ;-WM!++iĈ5jT +ׇMBbI@Ck$ZѴے *U2%ߑ 2O?~H?]BZ'ֻV#'zɓ]~]SzL߼yy޺SnVVRX-IJ XH0hP-[|$[јyTމOd伪U+fd$(£GG($X--̓9}z=e~tr=5КE= (M[uЪ@c.-LV$ۡC/6lQnu_db^$CZ>̓TfFxD[zJ͚U#\"Q(}M!4t]v)ҥ%ۼ>mʼzj5z^QŷU]F`]~]T잼{7YzMXկo9oGreř..}v`nD6mh:Ռ?c{^n t&laaF#mGVCk$R$oՋ:G^ɓc2 { (H4oOJիeh5z^)ŷEVhޅ5z^)||Z@ hhMWU"wa4&@AO+\ ߪcV:лZ'bZߪc.лZ'boߪcTԢw#yhgn_m0rOgI(:IxЮ>Jߖ~W:qZtfnדegz&)I=yKl3BOP{ ghMWw1Bk4|[m6{u⟄WO߰sϵ^Zٶ(:IxzWvQ1zd#ґf4)Nl8rd?5hV;-;}{+G1csD͚{gRVoњE= @Ю>JqޖOu_KO-8_}UV-sr̛!&֯oWoVɩD\VV'F?Z",MnR*۶  ~ŋ nHRÕ*؀n+`~Yo(:W[ 'һwhW8o~='dcYܷknv9+?K|<>&'r;8I@H Vh}ɓc!!w'SaGnr~}ozzbxϥKݏ^OT I$'o ^ czNXuWφnw;|eOﲗdcnꎎ-DSn.]ZZ5EG烖=wnFF^^VZ )w rEדN8q$^mޅt8jT/ U .@;AO+w?xќە,CvuuTW1B-kG+bҞ]%dӻ>s&I;mSNu릓?iM[#fl!xrrK릧')_|Q\[YFݏ^_RЏ?{K}R:vtf$_e.S23O5$z߹[S+[[+f46n\iVV$ - uG)7fYY;/6fVLË/jLyOOd ˗7+=uo%FtGGvZpdY>OF,)nyedGHF: ِyXb )W无֫WyxIJ Akh IxE#n!g` fŋthh[Ul8߲Gq mIvvkFX7j@(Kn+v%лdnIZo5zss]\˔nErlِ"\,ذa-:42ׯ3,k׮fw~z7+2;wn3ݒ%u_}UZ~zWAe5 {6ÁГFB|OC^O_Kö\&j! rehWE-$!囟!Nҗ/d1qM a)'H_1Qk`P0*R]}~F "Ck$zS2ĩD\\~&Z)##T)]=ҹ 0Bk,лZ'л]'ʖ#F].jMpz7ՐHgZcޅКE= hޕ|wWO^Y^Ƌrރ珑HݼA5]X PtГ]IKkjtto5y<9Hˎ[G]22. oKZ' һe|D-hɓcO$#Ƣ %L+ PtГfݢ-xFh۲9{px̙nNVRoQ5z^Mfd$kg+3A5>nB'-޽pak^[TmjMgΜW^O3gׯ@qWxӻehWEoS}Hn;93vֺk(BLOuFj];ڶ=y2XLaE3 (hyzptlQJz5RS#$fowC]Ϟm6Ki'l9O ڻw!eںc+^\E4MлٔW^)%'2@0BsVߖ3GAK"-Z4~ܸ~tx!ߎɱ}_HHX=bD1 [^һl3Ӊ'Nޥ*}{خ])vׯ6MnޠNR{A) ݚ~֭[3*ڵk͛7?-11I&}ydee1|jԨH>>fZe^Ao)Sm#kϞ ׯ%Jw)rnzz"ӻm2iawҥe`XүwֵG6wHݼAW{A) ךܹSbЇcҥw) :th޽) ܼsǎڵ/^H/_~ K'* ˼}#gVߖ-8q 9]3y RSNfe%e>wk]zw׮}0w%nn߾ivV=OzrOיqɑ7.eRpiΝ5b7o-W9~8 nժ3ҵ666eii) |˼ezѮ>Vܖ)Zww};t29yëW?ك䬭)]0A޽w`͚U$><ҤU^ ʦCHWu$Vg/qOnݺ[IϞœ# A5jTir9R:5s;wʊf200"ŭ[rrrf̘afffll<~xлh;yE.g]}-̞&tiJK[A֍9yϛ7IrׯvڪUڴioܸ-wcbbn߾ѣXKK`]˼Rzzl@Š ך믲e^xǏwI!7nL644}tBzB޽(^0.J]|zV@+tkZtZ''ջĪU(S$ zYE׮]?NHRRSSq˼Rz+k|ޅЊҚH>}ѲIxzٳg>/_,tN2J?wa4&@AO+Ūw:FOEGnu߭eNQ \zm vCk$eqfhW"&Ms玌?nKX PtГ .FhŋwMLL&N(zq[ hr[Kt_T1-2@j9s]OOOiՋV@iML隚_zR 20. Gs粿T.UԼyȽpBsse˖IGmmmׯ_OM6ui۶m䎌tuuݻw/8@:رcNHH`˔9s&$$? wjj={._L7))KؚPW\3f1߫I+ݼ3d@%w9CCG3(MVV9I2 Jz4%%iSҩGe"˴,ڥK>}Z"3fIo>#""ںu7{ʕu]bHN>G%+ѭBꖞnݺ%@kWtoxsgϞ=xcG=x޽{G --]7 \vUzxG\. P#?.\p^Tsǿo~_O гeɓ'Oω?/@M5#>$pXjfWSv ڵ+R`Ν;v.@M{֭[lٲY ,,l5|jz= ]vիW P@=rz^*dɒ-Iσ,X0_|}} ={Yf P?N-0eʔ^^^N 0~ƍ7V=ѣG 5;#Gpss.0lذC }z,ЫWyv֭[W''.;wvtt$@ǎ;۷h׮][6mPG@VZ h+;;͚5RiӦM7nHaÆ ׯo#P^=kԮ]eM5jT&PjUss*+W$`ffVQB DF###Cr(S_|QZ@WWWMc/P-xZuHm +ѭBC'I%K *U c48/@#_9 htd$݁lQ3Y+ Xk.@/i`mmU?73??#%S4kܹ(kw>@.bNccC""䏦Ž;,#ʹx17~رq^\j`ЌΝĤJv'XZÿuPwޘ BP̡R;uj[wNMIIIK߸q\ٳ>#]hhw_3tE[V[p2wWT&J&+׻;Iq{LMSC~1K{<8?fĈyડCOtȵk33{0Q}ܹ-O.lh'MdZЉzc~lgoJ̦v{jλ^{KJJ2лF"gFX 8ay/G?(ڤLU.YZ>ã輫h:uY:''gϞwS3=[o|VU#+ՈX~l[_Xrpp62 ]ffF$.)P9: q\Fr8=ݻ?p%yQR~ol'9lYеk+WЕ=o w7{7w8|NwuMeeeڵKIIɓ,Y .4t]9&ydXNn>o~~^VV!~X&Y#+ՈDma!AMbzl-mH^rH5ɮwoիg*)I//ϤJ:\9S$-h/eRW׻Ι-^}zW-yySڙ?\C W60K Zѻ&{{Ӥ͍ǍsM*skAzuy(-&fCWcn*Pp:t̘w$58))B~&O[6{^~ͭۍOwOm4ɓx{fXYY_=WGVZީSۇS(=x#jw46F9hwS9QBucC4-{}|~LYCBTPprʔ7}LvNfAA8H{]3cF@Iᙙ}Ųҗl/p{ܽI9kڴIxoߞ$XSR"/_K,;=xpՐ!N,M^thoQQcIҮ{ԫcޟ ӑjj_m&rReG=O^;6D n}לyk͙3 ).N%v05I(R]ѦYj'iddϟѮ,moow2ݒtґ$"svT)lSYH'wZW LjwS'rJ,9MuTDug5"-LW Zr|]_-[6R9u+$˧]}tSܹ|y/hS;)E;;kV^=~sU]o[.<{sv^RW V Y,]W |1Dg3|] se8Hh;vlCs+8\Q㶊- {?];KT,]Ȉ3HtˎXOc^KHl۷O" K,'&fy޶nq|:j OρdAɦM<|6wx~~qj翎Z=~|݈fzk˖J533(}qf2}|GG/zMdyҩ4IܩijfJWTdm4[J8nnՍ.sHrtvKI0]ni}񗜵z Y-M$Hҥ=P"z_Bm8=Jl8=\II08؟tRzʽ/LNݲ[љwYCͦձ]\sj #h zwa&=aJ(՞MT>3g"l[.Ν-_}3SR"/ǝ &n]K;[pӻ13g;t(_?F?Ν&];xCjXl=yׄSU2 ټyC6 .\^EB߿]޶W41iUR?M;e];sTN])S/ J*FWF {eM KV[p2wWT&JP 1yJЦt`6:Y$4 N|R~U3herqYY;mi?tm[c~ဋmG1Ta߽Q]oKn8?5D6f_~Nʛft];Mqz%ioEE%߿?׳&˴I< s˔hQQUƆvZ?WoMЬwNmx`-6)_F:p[0 /L-,LX,fJ;?kΜPIŲ mi wTZVa'yMSKK3 qQQٿ謡w2~wk]$gz2WL+4_Z7&bhֻ+=CRCBυiiI2ҁۂQ|ax}lǹqu%$|fh8&{iދObz 1C9zt׳ł\,xcv@jGӻd99 utxSXxȑ5rqqu~0Yڬ8-n^@"-I2 Fa)w,'Lq/]\&^vKj{Vֻ1tĉ;b ) qյ0v4D Ӊa4Cޝ~l[_Xrpp62e`0UIDS4ca&&#},[-*J&WIO_Zǰ?zֹUNmًǹ(H_G|̘л iMĐcRB(AU H](lz~Ҟ>}5on@kdqԻdwJǰzW0]zøW72r~6f$yoл iMĐ>(l$-aq>+߸8n9vƱH>t($R1IǏ?ync]Lh vߛ8tkk+H8^һ!!7wwnİcֈuKF1jGl4AW 3tuiݲΰ:őgM0Ck޺+%#a\NmY`ŋ15jHyy&͛L2? .`A[h .fh~%n;sϩˋ:uKƆDDԻS Njl0gYǏcY|Z0Z 60JJ8zt]V<<\XfzV'';ssqX T m2Q/o~8uk_GY[[/g*,#V`-:}0҃;fdD ]ͣT={P oxvv|`4]zDdM*~H۶ǎ{LMS,UtNbee6S\ίR/76mB矿۷EJJ{I8e#Ȅ'ڴ1sǎOMikk }y`ck~+rB=q]"`z5Xz.OK M?Mx$eS[vК[$`yvv̳V**.077=mRLbrCed]u'&npuu֭#tAY(U#S-:Wл3k/RBK/s@{Lbz7!3Ru絲2[B `iizQQryy&iD4*jq~~IU~||GG/w}Uȑڶ5pa{EVF>soл 1;j(ᧃ)m eːF433JMLrsذLvK0؃LCw&*yob9奕ݟzxP1Ҕ$I.KK{8|{TWaiw[N :̷˗~Z9 Ctbw@ӻd;?-5,$1^b׮pݼyqKtvcwC<=6on)E.GR$CY#Gbvs뗞&SVVIIL9~wr85? W]fH](ƍc)),}P()NnӧOR Pykd.C ZM΢.10CFZJ[IIʕguĉ:Tcٯ_)ꜟs.10C&zΝ={VDF}ZN"33𴞿ث.10Czx z!^ iл ]L f@d.10Ci&ȁ{+=3x/2лEMkIENDB`java-design-patterns-1.16.0/iterator/pom.xml000066400000000000000000000033611312550536300210010ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 iterator junit junit test java-design-patterns-1.16.0/iterator/src/000077500000000000000000000000001312550536300202505ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/000077500000000000000000000000001312550536300211745ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/java/000077500000000000000000000000001312550536300221155ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/java/com/000077500000000000000000000000001312550536300226735ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300245235ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/000077500000000000000000000000001312550536300263545ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/App.java000066400000000000000000000051471312550536300277460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Iterator pattern is a design pattern in which an iterator is used to traverse a container and * access the container's elements. The Iterator pattern decouples algorithms from containers. *

* In this example the Iterator ({@link ItemIterator}) adds abstraction layer on top of a collection * ({@link TreasureChest}). This way the collection can change its internal implementation without * affecting its clients. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { TreasureChest chest = new TreasureChest(); ItemIterator ringIterator = chest.iterator(ItemType.RING); while (ringIterator.hasNext()) { LOGGER.info(ringIterator.next().toString()); } LOGGER.info("----------"); ItemIterator potionIterator = chest.iterator(ItemType.POTION); while (potionIterator.hasNext()) { LOGGER.info(potionIterator.next().toString()); } LOGGER.info("----------"); ItemIterator weaponIterator = chest.iterator(ItemType.WEAPON); while (weaponIterator.hasNext()) { LOGGER.info(weaponIterator.next().toString()); } LOGGER.info("----------"); ItemIterator it = chest.iterator(ItemType.ANY); while (it.hasNext()) { LOGGER.info(it.next().toString()); } } } java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/Item.java000066400000000000000000000030211312550536300301110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; /** * * Item * */ public class Item { private ItemType type; private String name; public Item(ItemType type, String name) { this.setType(type); this.name = name; } @Override public String toString() { return name; } public ItemType getType() { return type; } public final void setType(ItemType type) { this.type = type; } } java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java000066400000000000000000000024141312550536300316300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; /** * * ItemIterator interface. * */ public interface ItemIterator { boolean hasNext(); Item next(); } java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/ItemType.java000066400000000000000000000023671312550536300307670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; /** * * ItemType enumeration * */ public enum ItemType { ANY, WEAPON, RING, POTION } java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java000066400000000000000000000044031312550536300320010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; import java.util.ArrayList; import java.util.List; /** * * TreasureChest, the collection class. * */ public class TreasureChest { private List items; /** * Constructor */ public TreasureChest() { items = new ArrayList<>(); items.add(new Item(ItemType.POTION, "Potion of courage")); items.add(new Item(ItemType.RING, "Ring of shadows")); items.add(new Item(ItemType.POTION, "Potion of wisdom")); items.add(new Item(ItemType.POTION, "Potion of blood")); items.add(new Item(ItemType.WEAPON, "Sword of silver +1")); items.add(new Item(ItemType.POTION, "Potion of rust")); items.add(new Item(ItemType.POTION, "Potion of healing")); items.add(new Item(ItemType.RING, "Ring of armor")); items.add(new Item(ItemType.WEAPON, "Steel halberd")); items.add(new Item(ItemType.WEAPON, "Dagger of poison")); } ItemIterator iterator(ItemType itemType) { return new TreasureChestItemIterator(this, itemType); } /** * Get all items */ public List getItems() { List list = new ArrayList<>(); list.addAll(items); return list; } } TreasureChestItemIterator.java000066400000000000000000000041671312550536300342620ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/main/java/com/iluwatar/iterator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; import java.util.List; /** * * TreasureChestItemIterator * */ public class TreasureChestItemIterator implements ItemIterator { private TreasureChest chest; private int idx; private ItemType type; /** * Constructor */ public TreasureChestItemIterator(TreasureChest chest, ItemType type) { this.chest = chest; this.type = type; this.idx = -1; } @Override public boolean hasNext() { return findNextIdx() != -1; } @Override public Item next() { idx = findNextIdx(); if (idx != -1) { return chest.getItems().get(idx); } return null; } private int findNextIdx() { List items = chest.getItems(); boolean found = false; int tempIdx = idx; while (!found) { tempIdx++; if (tempIdx >= items.size()) { tempIdx = -1; break; } if (type.equals(ItemType.ANY) || items.get(tempIdx).getType().equals(type)) { break; } } return tempIdx; } } java-design-patterns-1.16.0/iterator/src/test/000077500000000000000000000000001312550536300212275ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/test/java/000077500000000000000000000000001312550536300221505ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/test/java/com/000077500000000000000000000000001312550536300227265ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300245565ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/test/java/com/iluwatar/iterator/000077500000000000000000000000001312550536300264075ustar00rootroot00000000000000java-design-patterns-1.16.0/iterator/src/test/java/com/iluwatar/iterator/AppTest.java000066400000000000000000000024751312550536300306420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/iterator/src/test/java/com/iluwatar/iterator/TreasureChestTest.java000066400000000000000000000107071312550536300327000ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.iterator; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import java.util.ArrayList; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.fail; /** * Date: 12/14/15 - 2:58 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class TreasureChestTest { /** * Create a list of all expected items in the chest. * * @return The set of all expected items in the chest */ @Parameterized.Parameters public static List data() { final List parameters = new ArrayList<>(); parameters.add(new Object[]{new Item(ItemType.POTION, "Potion of courage")}); parameters.add(new Object[]{new Item(ItemType.RING, "Ring of shadows")}); parameters.add(new Object[]{new Item(ItemType.POTION, "Potion of wisdom")}); parameters.add(new Object[]{new Item(ItemType.POTION, "Potion of blood")}); parameters.add(new Object[]{new Item(ItemType.WEAPON, "Sword of silver +1")}); parameters.add(new Object[]{new Item(ItemType.POTION, "Potion of rust")}); parameters.add(new Object[]{new Item(ItemType.POTION, "Potion of healing")}); parameters.add(new Object[]{new Item(ItemType.RING, "Ring of armor")}); parameters.add(new Object[]{new Item(ItemType.WEAPON, "Steel halberd")}); parameters.add(new Object[]{new Item(ItemType.WEAPON, "Dagger of poison")}); return parameters; } /** * One of the expected items in the chest */ private final Item expectedItem; /** * Create a new test instance, test if the given expected item can be retrieved from the chest * * @param expectedItem One of the items that should be in the chest */ public TreasureChestTest(final Item expectedItem) { this.expectedItem = expectedItem; } /** * Test if the expected item can be retrieved from the chest using the {@link ItemIterator} */ @Test public void testIterator() { final TreasureChest chest = new TreasureChest(); final ItemIterator iterator = chest.iterator(expectedItem.getType()); assertNotNull(iterator); while (iterator.hasNext()) { final Item item = iterator.next(); assertNotNull(item); assertEquals(this.expectedItem.getType(), item.getType()); final String name = item.toString(); assertNotNull(name); if (this.expectedItem.toString().equals(name)) { return; } } fail("Expected to find item [" + this.expectedItem + "] using iterator, but we didn't."); } /** * Test if the expected item can be retrieved from the chest using the {@link * TreasureChest#getItems()} method */ @Test public void testGetItems() throws Exception { final TreasureChest chest = new TreasureChest(); final List items = chest.getItems(); assertNotNull(items); for (final Item item : items) { assertNotNull(item); assertNotNull(item.getType()); assertNotNull(item.toString()); final boolean sameType = this.expectedItem.getType() == item.getType(); final boolean sameName = this.expectedItem.toString().equals(item.toString()); if (sameType && sameName) { return; } } fail("Expected to find item [" + this.expectedItem + "] in the item list, but we didn't."); } }java-design-patterns-1.16.0/layers/000077500000000000000000000000001312550536300171275ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/README.md000066400000000000000000000016271312550536300204140ustar00rootroot00000000000000--- layout: pattern title: Layers folder: layers permalink: /patterns/layers/ pumlid: BSR13OCm30NGLSe0n7UsCS62L8w9x6yGszD3t-bDpQhc9kdwEO0H2v7pNVQ68zSCyNeQn53gsQbftWns-lB5yoRHTfi70-8Mr3b-8UL7F4XG_otflOpi-W80 pumlformat: svg categories: Architectural tags: - Java - Difficulty-Intermediate - Spring --- ## Intent Layers is an architectural style where software responsibilities are divided among the different layers of the application. ![alt text](./etc/layers.png "Layers") ## Applicability Use the Layers architecture when * you want clearly divide software responsibilities into differents parts of the program * you want to prevent a change from propagating throughout the application * you want to make your application more maintainable and testable ## Credits * [Pattern Oriented Software Architecture Vol I-V](http://www.amazon.com/Pattern-Oriented-Software-Architecture-Volume-Patterns/dp/0471958697) java-design-patterns-1.16.0/layers/etc/000077500000000000000000000000001312550536300177025ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/etc/layers.png000066400000000000000000002762241312550536300217240ustar00rootroot00000000000000PNG  IHDR|[IDATxl}'?9EQssZ28&3V3\&˴+lR=Y^ʮ)9i;?se;X\6Q n鮸B?3̏%wٙ}]Rg]i> CG Ǒ#@29D}j2Y;d(d(d(r蒡EBK   . \P:KV *t۽5!Cv9U1KOP@ ee5lPu`NS?%m9 P5ȑW$Gp, ٫j/u҂A5h6%`/bi[ YN5m3Z3Ȥ-'C*v9hSmPkgzx, ZK:kFJ+X,˥VmqdVGzmg-l:| (9CyLĽG A|V_&5Ad(|Qfrnឣ/~ϋҷ})%Rء^#e(K~OyJoLm7J4CY;%C|[뢼c/Cq(8oěh6K[U7Lj9/)u>Z2`q GJ{//zpycD6^Z*7"q#Gr34 v\ yPJ@23[إ,P>_Xrrx6/F$IWKOl{ nZ^CTgrZsۋS_zGw}O<|?2r$gNU?˃}d2`q G̷OA&h^9 yJH<.n}AA{#`ޥP@M% ґƤtb+@K%&F>ijQN½wbB$Cv9?D>Ơ3?p*)\ZХ$&3[B隦6 r2`q C&%i-Y4hH6l}w/ɱ YiP@P e>f(:'A0Қ%B: uZ-/s28kP2x,DD!H~ý3tk>.m۠$>P @ e,]F4-v9PrG P?ARBv9PPtP"C!C%C @ @C>@29Ca 2PPtP"C!C%C @ @.-s @P @.22]2PPtP"C!C%C @ @.22]2Lg(vc)~5e6%^kM`AgrT*C+c7la5Y;ʩ ^g?i6 @ o=|| 2Ngɲ% Yb™Vk[$ )GlYr/.+Uz =kA#HPNջ7NlPŗbaT"ݴ:PPJ@je(-2`q   . \d(d(d(r:L|Ȧr=GVPVX__7} j @;vlff2rƍÇMLLmӇ>P‚xpep ZĄPd(cwwwrr2rffqsVPJP'd(ׯ_;t! 25eYVlP7d(jbnnncc#q#fP7>lgbbn~D @-,,h:*p :>n'&&J>Cvww'''3VqPOd(*oqqqee%cҎ@-FÇ>LFDF PCC0pd(PP  b>G7@ 1#CPCC0pd(jP  58G @ 1!C0pt3P  @>258GPCC0pd(PP  b>G7@ 1#CPCC0pd(jP  58G @ 1!C0pt3P  @>258GPCC0pd(PP  b>G7@ 1#CPCC0pd(jP  #G~@hs*׽97^~WG?woſ/l?#$b$>vw4Vk3ZKx2UFkt\b^Òؾ.jG]:ŗS360ZݛWfң쇱7x?_^E=e&E#oԉtȘEJV#SҍX.G^^A['weJJ] KbZmD V;q 7ӯx+OgGP{.)G 菫A_\tF݂ 먣ZMIZjI!Q`{ V#SmJFц0Z X"V:2d(0j9 3-YP&\juon;c_{QWE}:!>TR(bF["S^w9B A"m u#2vM$(MSd((CJVڕ2WWË^ u2Fumrj(E e V3wmC_wc~E7/grΛ? (v b wx(&@hsêս?] K׽_]~o9X?o>ky kJ9)O&3+CHJͺGǛblG9hvH #ZL-*|0iq*ѫFl}'};~[_?xU<Սʕ'ijң^xG,8Me>r _zAR|I5A1R'AiC}2ѽQ eTsꢑ1[?v篽(?_?^wOK_g{FUh*8Bj  J5.z04Jr {@hs*ٽ.f.FGB%%פ$&Eb}-IJbŶ9zuUQo=rgK?_ߗeFCub E-O囸J360SPIIZKV8mS>ŏm$ҭLl)Mǘ薤J]T*ԫ_pӗnk8Ÿ~鵳O\yZ+Ϫw^L%TCekƿe(]m@hsT:eDDq^]42U}2ѽJ#SwDѫF]P&\07T%sꢑz360 Uhd(E e {CU8G.w>@hsP(ѫF]P&\C>FA5 CZW JD FDq^]42U}2ѽ*QWLd5`h360 UhdTd(TE e {CU8G.ԪO4Ė1f˚jRu֒P8,ְpI_Mk/ww}]b5mK:N[~[m3x a3609eQ )[] 2gcHjx)[Ec5S(iMyA,\T%zX>H<.&wow< ]ZB5PDatoJE#3\RCGȏ" %^*!o6y0Q%͈rҶ{m&&5}2ѽ*QW+EZgU ıác$ĻH?I.( ”!360 Uhd_ơxp?ۦ<[Jl#&ߗn}rI6|>@hst?y7>_ˏQcUW*6k/5He;IL&gEId.ꨐgCV~} ܄ eE e +޽ys^zrW/Oڨ*ѫ e8U<J/"q%[h( owƑnGޥycćs55}2H/5FOq^]d(]Fd0(hLaPIy7Ɵ策T/ba^s8Bs"궼Ϸ;AP;2aGhLaG˭>* Cݒ_ 2C2'D,(;f:5{xS+x? _.;PW ۲ZDn&S#qbo9 ⡕SJKc8GC>ԇ?n191`X#%Cw򉓗qW|)3+Yk GWkȷ]JZ[x;x37C_ $'(W*r"o d7XNi?NR3i EQ(g(m.`XZ'nxﹷ]Y~ʲxpڼX,QMc%wSITl8z7viIQZM݄&e(@Ɯز.CяCѤBɁ<.)8%$C2w>@hs27j=x֮;2;r[a|_VW)eVmQ̄<7C'LQ $"h4G-gg(Pq·8`e#̇R7d(U}2ewowoc u5=b em=U/$>܍'n/Ol5YfCgD0C4s*)C-d(}yI"q#}y;婛~2pۢ)_>@hs'q˟3qɅJs+CV_m}2*'CQF[TyU'-z>yѫkF360 EWJMxӠ询2ROq^]ǽ'Ф{ņM)fLtsv#2ZP&\029zu aJ %6<5gPQP&\029zue72_hQ󐛡hIwUJX)3 QD FBU8GF^Ņ',<uۖvn# UulBTnm5~(-{Qࢽ'ϥ9 ^TiN[k-7 %:@>@hsPJՕ|˧7FQ׉R^e<>Pc1-xw6ۋ$vͻ&~M, d1aR|gz55}2P(ѫ+9;&/)]S C ^EId(JTU]̝?L#srE e 3w~ Gt!} ՕC^P&\zޗ7>ke|q*o5muvƆXHп<ھ{+״1([8YAbq^]PVk)<~MJlP>M]&-z_'~x urt0Ew*ߗF2VP&\7zƉWv R,TVsO߃F1% ritzǼڳ?gmhq^]/LJ(cE e K|q3g9sV|)*ޟ{I$^. *g^yٌi^2\Wʰ*ҊD ֽw򉓗qW|)*ޓ"}y"~IpO-e8G.2U'Rt}2uo_z֋{k{QֵyPY-ǡھvǞj9^w{ ơT8GP(d>@hs27j=x֮;2vWyy{IC{ybwr ԧ8G.2w>@hsò7]~ʻxY!kw(z/ 9/&D˥CʿE0Q,ѫ ]P&\ uob/ӣP.ѫС6ԗ?n191`X:<ık2%$Ud(UFD VMtbYq^]jd(hLatoJE#CQ.g(m.`9zut?y7>_ˏQUhLad(T%s*̼9/=9?uE)g(m.`@%p߇jH/59(*d(P"\54??oQ1 dq͖U]mҖcK::s;#SϏ߅ [co<6͔OePCP~3kϖً_d!ubg HA5=\lՑ/;b/hUִ4=}tڛm5{I,H遾 y0ܗ6]㗷E7ȗ/u۴.9/L~K_yP"\5 %jd(''^y6K0ޥLAz-Qz.Au>sŕF"hM *#i͎d(C4ǯ;lhݷ[jA rd(PR5 (/wʚҶ|J`DI}/d(` m.e(z:sw_m .15PzKʽL=&vĕ#COWS8TN]HJJ+M';XePCP cO}'N^~ĭS_XL:D<$AP$z(p3}nG $_{ر-H ߅琛d2mF勉dns0lr  G 8BiKOzso-eֵyP]-9@xd"oJUP $uPӃ|R?̅ RS&npYx}~F!Chs'@(-CփG{`3?8-/sg(SK]qi@od?g^ |(W͇2O@s W-HCP(H\Ϣ|;62?]"3R3,f]|(`m.ed(woc u5 Pj._ˏ )*R2!N(P ey_ RUePCP~3;ELjJ 4 ſ5+fֽN]ʍH  Fv;6 _yP&\5 %:q#n/x'9gڈPԡj'"ydljҥQ a=̷^ߧW$#JCG6wYrr969 6@ qB 2㗞Z>we+kbZrQF!~KcF~?ج+6@ qB 22Q]~ʻx+AeVu+o>D%600vHc7m.PMݬ1~JҘ-"yRH~1.//m.523V4=8xu;K|JC9hKePCPZf(݁e( jVV1F#ORkz9˯<(m.4C(MRʭ] A(]2(m.5C(+~@hs'@ ]2!N( EջePCP!2w+D 8Bd(UW6@ qB JPzG(xڤ}&vo[N{k  UW6@ qB `j}4O =X;vwJ&aW6@ qB 3S[>|M̋!CYjT{*}lːC lXKaGjLjJ }~o^vA<_jVmx Ǟ|IYq|AN{KRqv2\o9\i[+{#fexc7lE$[)o?UW6@ qB 2o~<EX& Pk^?L+9qfa.iM)#2񄔕$v߲G}#ƽQ$ R> Xѿqů<(m.P1V -ke(z:sw_j$"wJkJCږӶ#/JcR5D]͠hISUW62uE3X)nt'aS&e({_>q#n/By(%J6i72nPrgIa~#7^#gQ?Ƽ `DEհPL@U CީCQ$b.HPNNX NZr^[,?yeYsg~pZ<_&։Mnx b|(UzUb ꦧ6/ʇ\=s~9gŗbZ<}s__$u:AD6hkhGbLQ"C2ׯc8%<KrCƍsssb8-Cw򉓗qW|)*郒)E;MI7#(yЎtoEePPA(E/4ؐ/dDZ,K5㗞Z>we+kbZ8(nWrVs${,2(m.x' BA͈7nsssi9e?zs]=we|"|(L hn^rPJ9ӽeJ 6@}CQJN>lnnfsv-/̾Cm,VpʉrmĮф 9Ʌ|7f0J,4ޗ#+2(m.JJyى-PFӚ(e EZ@hsԊ7EP2յݢxgggaaaww [X"_wرK&H(j D V(ℒA(|#]ubJ0H!(Jg*kJڑPH 6@ݜ8qBP2ղ699Me,v*PW@hsBL7fccÛD<.d(Uj@hsBPj ;MO>mY֐Eջư hsBPj:Сc` CUc 2Mo;(O|̔L`d?m W5Pvwwvfggּ6K___;teYsΑ#GLPK]!i+0Xd(5k"E vwwϟ??==}!oll?KNL]1bemmm> :KV۽ZƵꔡlooͭu.#333'Nۛ8}#Gdnnn>ai;Ř,@E*2VJZSgz֘aDoĄϡC#T6zi+P2lY )|d3AԏdI[NIU e{{պZ‚7ammM<6}D}d(aai+P2DW$Gp, ݒ^US |Mٚ՚VZu|HBմ,u HdҖSAU1Cs3?|LiUn13===ʩi+`JT~"MIJ"H2 XK7:uRkFmӚ򇄸z`䚺mFgDU*C~Jw_>"hˆ.CQd( @ ( ů+_rѯ$!Hbzg)fT{%vi[(|-wy F9rDIdsssvv!C'C MOOWk_*p 2:E:beцvkڸ$u_!Kba&)یV`J5ʊAuy|lɈPBӦ>i+0:PU )H 8WE2{xIJ:Qh'()v`Pb˙e?5]rĥ j]o5&P x 2ʾ/O4H4#H);k|f:ag(KV2^il>onܗ5RTk^\KBg2$bN[QFϊtLZRjTΐ@I*Ӝpmjt2у=tPF.`cc6iL"ڲ,QPȨ# Wf3V;tu1n8d(\[d(@!d(52(^XXR.Y[[3} 3nܸ1990#C !CUÇǶZvfsd(9G@22^N|םƒ'%wA6f<'Cy22^ ;Cf9=uf<ׯOLL>PB;999A`đPjÇk9lalr8O"[[[[XX0}"C !C3] n!v0~ȸ%433' DR 'iܵ|ث'}U<K55 eooKLN7wrrƷe2+\sMd(@!5P^|''؃W?#cD,׮iM5"SN.VޚM^g6}vխd(MZo %feeeqqQAR g~gyvw+X,1fDe(bf(N(CY__z5cv=;;k(P94FDR ;7\rz_~??b_?g:AH%Ͽ E4b3}89C]Pvwwdeeekkk`1zfffj| Pvvv0jPBj؃[e-~v["_:^.-x1/\.p|e4%=CWY/W X"o0mI{m)~Fp$Gyio811cbzL%&#C M}sK^yW}g{Cư(ED1iBd+ꎽX)"p,(^N|@Ǚ<HIjPwSzXtnd(i'3? !C i%Cv p?Eyҷ})]B҄#eb%s_?}ʏfԫu+bF06{bo#kVz0JnH־Pʍ7kD?jeeOӧME % BR .{>uQ޻c/Cȹ K%(_\ˣKj.].O(`~/^:Z= tOϭq14n㌘ %ښGR u{~gΗwwycD6^Z o͓7J55%HKbǀVw_POPu.RgRYQbwKqNnd7LmooOH0 0"PBj/?C.}e_%'/gߗG[^t*gJ*d_˓1I0Zf#m(RWPDM666ƪ XM#d(E ˲L=d(@!PD9?~/#׃_'UOS⍀HΓ ɹQiA;[׾e(NY^ =lVfmmmrrv=1 G PLFJ׍Q}ۧv^K_j^§֦s$+^FZ|GVR f(Œ x( "C"Cv=99yu2* e ɉ[P&N[BPtj7H<.&wow< ]ZJJ1DPhaaammQ@!d(\RCGȏ" %^*!o6y0Q%͈rҶ{m&&+2j>d(u V2xEHKb #C _85 ]Jl]$߂HH4Ŷ]DZd(u% @q BB.#2}*2h Pʲ-G3N[BP?2a_d(pƍӧO>d(Cn'''L8m !CJm0% #}Ci+P E Pn/..> `2rLOOooo> @=q BBQ+2Jۛd""Qi @!d(5"Cׯ>j`2Ҝv> @ q rGC2_ngffkqLRc9==c@uC` E CY.)PJ===m(ui+P E P*'d(MV8m !CJ퉉 ϛXĚ>@}p BBQ+2j999I8 N[BP(jxE2DG6N[BP(jxE26OHF̌8Pa,ClY 蚝%ѰZ꒦t7WvziME9qvwg-u9~j7Z~ƵPFЍ7&&&#@0hۓ{{{PUfҐP1d}e(v!%GT]d(igggd:Cs_/ 2>.4@rG+++848($;C9u˷̼x[aHJⱿ Et՝6HP78M}~ e텅.{ڻHAQ7hPT%C)=:rH?a_8|Ci+PHFrǷey@|XǍfw p_[Rp>+ y cKխ/mZ(Cu Kƃ\)Kzc(pO7O28k㷛d((2"O-<@Fʾ- ű>x 7bFGJLOO ~=PF@!i7zƉWv R,TWs[;1 8GK4ӚvŚ^u5x9MdžDb =y0AHFN^rP/2rBMT&z BhR٠on7h/aT,Z-;pSVs /hf$~5L"(6o:CP}L{wm"bt?ޒ~?xtg7)Q8m IP>u꙳9+ Ք^{$ 5[E.&SJb.I[M{xJ!EY?H9^7$ev^)rc*okySd(n̤M}(̺oeg{$^YG($-C9~[/{sW,ܺ6/zʌ GkgEU_(Ed}+q`aˌ?4ٻndɔń9Gk,CkDZhdhpGmʲ$d>8xԀc p `EvWuW٬nVW[U7Jk9 ȼګvLLs1OJJ-ܬ !a#%u\K1&{ޜgeIb N3CXC/*ς8G˜sHדșRl6]?2h(4p+ Cw>@ӯj ì-e:pZaEB ձ(̴JNӇ_Ńɭ <{ eP0)BX%BC(NO`FXhKrݺAtC]P$P-O-'s~GtJʿp @C;h(_zmLDt\kiƳqgnޗǰ+`g3i'Hŭz_Y ZP"DhێXN a0K*!Hz=2Ɠƶz(6FPP_A ZC Y|g?b^嬟?H.mWP@+.d:vt- DxroW19!C+K3S9=T6JvJ?+:頡0ϯ猸2Eg/ґí%h.kSIaj(>G?Y(: P搏ypBC t ~{2GC_ EO+LZ q<g2=q@rn+4ϔes9lBC ^G oICMb(5$Pt:B!\1 P@08BC h0Du 37~1@ "zst[`p<'f0,ȏxLގ 6+@C %4# 4Ru.n+4 PBh4yX %Q+@C %hLt:]բȦw=R s| t[PTH9sp*G7 KTm/ņ;$QaZٜ )o-Obl X %֨j=NGQD !i(3^*R PRv*[qa} eLN $;uH/dJp w,kLSoc6U%Vp{ d{w"9X˘4Ġ W ?j( 'UxghN3l %8d2rѠb( ;fcA4 `/b啷}|ēSI_YLGETA,JJ, aWFYP]Fgx&UYB8,- N"Oݡؼ_8L#4eMCC.3RQV:=.Jf3Vp+ k_?)4xf +9]'T\=mI`#PC#Y/S[eIc>EhcܝrOu)hG P|h4"fx<:#M:aC_Lm JME VuN_=}3 *gWr ƙK ƿAD^8[UCa gd;3h 6IQ%VsgS.)Y"4Q,aC[a^aW%͒f Y V OKWr t\= ؝e,j)ҕ+e9WuЦ0"֥J@w*TI*PASP(D#`5F#Q[Azu|>iYn+rG/w]#GEr J֎5eX5zL8+ز' 9ZF N wRCCz(k_ `:6Q\.W*L&C,\.mu ~?yBM&??)n+Bxk;}yWk|5qXE8D]H"{^[c!08+8dZX}=h<8LSp=˳N]x"y7|޻ro'Qz54mV)HKOѽɁ8/nE0GW&łhDw ʵzYڗM?Ѧ뤘ĝP,` zoF)4t:믏:/л&"dRm!^6z:OށZo:z`D!l## h(L%Z[=+gfR0=FkFbmw>3њ/]EEPZLρ ZohdXA9 q$Z< 3z#hSx4#!40D@C}fR[# Zot 'QY GU!%@H(LjkebR.b*+0BCH>x4evH3Q^I7t:MӵZMTV)P<%9Rb  >79~uqP6n&5 dR0~ڔ #%G$GJ>x@4!ƙ3+9sɱq2p٩" P|dc/3):)wD/gvܖv>c-~$SKDyc$&XdKbҚxXʒ(q*h}i(NԽe)UZ-,ci*rf .@5FV/ OKWrR48{ySEŞ-6 ]f EI"anI8Σo0\ѼQZbAyg`OgjhGk(F^( y69Cg3Fi :.}79/ ϸljWYeq`۩T*QzL&|P(T#w\}&ss4$QEC97?'^~/~қ|>#d}GRN Q0QBCqpf"=n6t@0KA7WyTmEUYI9"Nq%gp޻g P,wKT1.Rae ?}O^ϗN㕊A5:4ծ&o;b6 퉤U3pCkQf8noog2z[xu2=gXV3uMl6K%u]i|>{"d\I03ZΥP,!VPg|+?}㍧_~/&O_?| k詐*s4lռZC{J|~WoYj~i$9)J09}Ǡtq{U<-c}kD 98tMc3 uSh@LѦ36EzֈCWb;W؇#LK.Yt9(KcEQzLSȭQ6RpԤ~e%ՌR(by 4ي$>5޳w.G/3|YMZ`!Zj=gęh+|œa KJoW8Vy4sNH>wg'?wWqd:L($sji"_I75E4En%2i=̱Www6~*>7VQ߯jtJX ;=g%ؿ '{߻oZ͹Xg17ICY8Яܚ}5_1ίQ*Lw~wy@fСCt?^G,W\>RF;(O돻 0Jo$TH\έ5Thg^Ni{zDf yo|⼷?&{n ŗ/Z_DB [Ƒ\k?x5]| gd4Qt!8kbqܢ8߻kދb9{JuRDrPV}Y{_+o[*c*Y+e*DEL֥) i~.)sI9#n%1ivMəNYm-_ e>=^}Oa29 D܈*Ӷ|.,g&Hd ȯt,=p*t;SsT I6??arݍvLʹN Zj.5r @򰲆lփ?or~:E=ŇlO*dKڹ#\[#CZjZvo(j(殛Q#)2S3k_?)4xf +9ӝ݊ϼ,x>c~)Z1 (-!8*g3 39^^0~-.0?eLOOdOϵ#F+Pf-,Rbu)%3g{ s!?X,ҷ8X< zIZMFQla*8JRP3]*ek#%\1$a*X eqVXN4?rnILE񞪤 #6Ik(q*a[5½<WnO>]|?}/'K{!_~j(ɤ\.{.Ht:bUVBcX>q''JNax.3?/ 3uZC1s6Eqf3y7EIˬ.MA\;g"֥ bInf &ӶB1;9ZF}Rzݳ,|z vT>ёY(VL8ؾPs 4T6YgŵQjw#2t ErnIa)3 DIHS\,$^4*|ٿ؟?qIbhHLyG}:uk.6MjŴ6L*H9; ?.ѽ w ` WXj([dV$bx82Vv rG/w]#GEr 쇲T6~(`&?t=(S8ȭ' 9Z\͒yaI)K Ņ+7(H pT;畡3y_N$vkc'a:bNB5ehJHg*\r͠X%.5ik2S?`\:Kbr#h[~-Ity0lmmi::I%l^[[ͫgOZ#YE(s,Q)N,4a0v=Z"r:L: +/"V DO&,ŎCj_7g}FBCf}yf>zD^SW$£m̕`<=(nvtf6Zz^H)W |ocq.+7*CEWA)˹b SlLIHR\,$5pA\5uy5Nf`ө(tMxd< a<|)19p(' 5Ipk=Iwdz( 2{1la;jz2Sc&q\VCfKRu"cRH@ _]k>(#x2r/켟7~c&6q@[PI)]6![h(~а ۭ| 1l ًnJl6+n¿BI En ⓾==n]&<_.J{ngtNxh& GBC> VDMcнfy @hĐ++E_z;9[qzBCHh(x4gDL}ơC'[$Y`f/T*IȧvV7ڕ Ce띯ՎۏjLFz<u= h #P@ɶFĜvbÙL^Kw#`pK^NxcWoFt:(L]ϙlXQA܊Q<?'v̯H$o?(ך2Y Rc P"ibtdEj&aLH^*]fԀٌ9M%^ϝzgTΐ$4EƱ,ޜbŸ uzkKg_|OܖU>?s\HI>8j4b%^O h4j6t\.WVq5L#%T\.Oc/O )YHS1'y yLCY8^$&:xCԆY_aD7UdBC V/ OKWrRjb޷`: ,vPTMw0_y:~De*cf*9jtRT]s1 qTPtp'f G ]Ƭ{D\"zcM~_t:h%)[ë'oS7(Ul{VKྒ?Rbbʶ%Y,y rm5l$ۦ@_Tk 7hS2]Kԙhlcz#1 rG/w]#GErq35ݩ,SaP54EM~-1ocgq0S .ObGE^)@ӯ* #թ@3hnx-n%a2k1ϯp39LQb]8tz(7&p { r(JZ}1Z[{:wH}突-Icخ%iĊĻ$c/r @ %z&(Jjkd<|)19˳tp=glsCef: cQqPMz-Kb=| Q2[S .VVLs2bR?|(f'Bh4+gVzJm4.g QJ%ax!oj'9. s<k4Rbb虸,̤FxA洚lM}y]EYd2IkzCQR풗e7Lf0ΣQw<~jwvSen0`$PτQJ '>3^M n!%f"8t:|>qݶL&;;;TyрJBjG~wR==(ɕs>q 3m ­%rEY.'Fj5 jL&Ct:)t:!b+8p2BujlCT[)">,q$40@f@C}fR[# 72LSxVBTޞN3ud2a*UL2Vvv޿zl>(雑ОP8RWN )R躁``Lڋeu y@r3 =;%7B0NQY%r!PAp=OWao16;m}C}fR[# e7FQ6c0ܒfy7JT:a}H 3SB~/G|>/7nS//4N&Wj?e8|a{=x:}| -!(۠ ̤FxA@08SodRQFQ*,yz|Vz=TV~E7_dn$j҅Ƒ>6ɁDiOվOHMgR[(nn*uuU=h h1i]K" -~H 3Wn{pYH#yN+v$9Hzc401l6{!Y.ͦycؙ FU>O ( uA^uW%i(e2򒹌?1ۿ#. yksPzhjs.V0"_|s;;/"ǽj^r[i((۠+J/Pb4?P*&5ﺝ읿~Uv:ʲi((۠FG5Gר\CstoXYY?o9m:݄@ȦvtߋWΓ@N1~eQ^HZGhQ'e~Q4L\s0υ-\|&m)r{݋8n%&vt)lPOy5VrO}yVa`0f_dgGDˤ UZ7?-'n_k mm)yU*>jl{eR{5C ^)퇅̉ͲLhȪvWOŷqFYw Bx!Moʡȉ PsZGV$^(Db+xuɓB OZc@U1RI!z<_+a 雓rhIGZ- Ýy,P & @Pѹ<|rELx5~3?'lHnJDLjkducX>q''JNat9ưqGLobPx eXNRWqj6 k(h]8:6 'G'ȧ*88p3w]l"u%]i(NJzȉxJ\Ljkd }}sf9KUӄ#-*)f' E䇲\,ڇ9kt r8oĚ~(w Ya'OavHAfR0c E iدM`gnfBg؛ ωН>мz5r@ڼ P2pd.Vʈ4a0v=Mˤ%ő/'=,|zDW_2ZAH^W6Y<1GjrI9)q/~"K'i0rV/ֲ-RG ErDveaٶLcKf+;;;Zj5άC 2Nh-~(EVæu j ,r؝6~\Y;V?͘u񔐨 i_/=E6&qԋ)}>/p"rLiXxAl}y󆴫kyvRch}yH1eL8(xNe[#U=tz +'zjtnbȰv{49 _E5P_δ0hU&zw[#ؕd/oqV3M\n:|V((۾3` ]}d$oٴXD`[I00WMp>Ɯ5e~(Y\1O;')!C7AɅ 걫mjjR#|*cdzHxunl6fNC/}HX]w6+ʶM[ ŁB'y~3:=;b^cF=/"{ C  viյg(Zlt FRɼG`_Y3cn?Vie񓵿|0¦ݬLdn V.k4(L6P%-l|PfDXwFM 2.y|zޗG-$7%D"&5Z9Xߖԑ1~-\Q5A6IȆSod2ZBBbmW(;U\v2K c0jE% clO~hlmmNm僲mʶ, 6%/pxB*';SsS{,ό5H.KyQp7";b?!}yv\6jk P@C0%$^ шfPv!_e% QaB돲 7l' @3?%$^ bqhJa %ಝ^+ 3mm#@0 Wm●"%]k;32 %زB yLF >3a4iuFZs0nƞP@^vuF(t6 5#!40D+LU|A@>BT*e٨3Dx^H}WGoҀ1eJ. et-P@ĄyHdX$&uSʦln^+ hhl6K9:;@ 9GW;35%P8DLF@?BAԹ;"o>[8ei*?ePPA7D>ؽ7O}_ȫ?P*5"p8־fYEQdVףHXRamK_aOƄi((۠ xP}'=G"@jvX0?@hNN'\H.~Br0ێJH93c5mkk(L$׀&j((۠7 0lϮJs^w_.RH#\86H5BrbqWM6LX|X8m'NFs MlZǮILծ12 ޠnL>fQ.KE%ǼwOЖj((۠7 Pޗ{߾yr@21a}C*K4T臢yRkQCd.›g̒ivl vn t jl+hlZY5fl!#62g6֦xw!ǵ2C=VlZsb[~B=Br0S;1M봳`KNd.|u™EH #חuW**[ТRZ멛 h5mk|PZ~Y4lvm{A=[}y'7ErEh?b4Eæ5'K'i0r0s;pцM9ly6zdfvx-̥!% z#zxsy~NՆ3WPfKhWM7Pi1(37ER>gF @9FQ>NQg$ iͷv{49 _a-=,̸MHLuV:h5m[j('{߻oL`PX]WN7Hbz>F JfmjjR#|57%b;L-X6ȫT| 3ؙr0Z eFZW}/V^y:OW&5oy)t2??kF臢9Yf 䔠9o!e< $GZ]=ۆ ' nA@_dN &, m 0pp~,]DOSy-':M=81Ť3w pjFQ&Qg$Q3hhf1͟5#̍jg.`gگ5'l 8k(=;}7,!_I.,SJMP$8z0sC.f,S.AWS0Zor\X;Nĵlbxy_kˣ5da,PVvLONyo1A2ilVm]bO] PPA[5>vQy|$^_75ABA0hFH˘-[&~hjI!b tG PLq5,Mj=<+4@Z2ֵ3AcOpΪ+u"93=:t83G([5G˘~(j E~(!z_(N3L#!40Dp쭭|ճ_[iu 27sM +2 fr>fIP4yT;`|4Dlw>a".[6~S| Z#@2Eft:vu. ؙ`$\/\nw8l!V<_zmL, vɹ&kʙ>2٤]yMJeq|P(r9Fؽ7O}_ȍ0LYآɄ&6Ht{#eQ@iUnl\ڪQDW$ vfP A kj]z=rZTIB8e-8@08jp!bU;4z{/I*PAi @v],q.#)() fnyp*ϬFmR)-6BGZk?8w_/Q*jr,Z]/IM<= o|f&+s:}d3NӒPs/c^?ʭD.V#6qH ?wl:̓qӷ`&Xwsn);BK┷`~wa%EK۩_ϓIYَVCAud]z x* X3z(z*ʏ=2W؂A^ɨk!emg/b啷}|e[6%͌T{U'VhHkJt7Z#e+ )؁j}޸,\$̙VrC4= <~TJe۪<4(N7.ʭ'x,r @Lh@ zU=vⵯ_<Y ժd,qHv~k|έD6BΊct@TkJt3FjY4%zDcs.Er7QlIoJZ|q&'wߥRv_89{;;|a^qٶ,8ZTVqsQnL8Ύp8,P@P*wVuN_=}3 *gWr fggC,is"BO`'H;w#KKeX/-*}5c.VOqr~=k{>az s*S ķUҲ9bcqqQ /!=F|MV;﷌ebҭqٶĹ:"$p/ lRL1& zP*uh(fz8M0ѻzKO_Ɂe0%ז Αk틦ްrhKKZu5S#.Zt+uWV(cה)KUf$W*lmlc' FE[ʩStxL?7M$- Sσ#ƹlRubL-*@R4@wis'f:PbHn= p NR_OrD*>u3i4#ĉ/)Z,Ũbt )z^&Fa&yL}MLk޼~%dMޭļICa]t%Akwg4zgnR_ "T %Ejà6#,$81z8i%5Oy<+m9Ճe@d$IɅwpq>y+ѻ5#ͦ}C (_א_yc9rL>K{%NzBzzQR<dp8rr9b?ޡP%qDZ#N䘟=8%d:^i>qE\ݺt:LԖǒn\9VB6DNh(`V@B v{2 gi5SqNs By 8p#(>i DшVZmwwlK$pB.l>y ƑheT@P.45gkq]?îELH PG&“OC ڣZnmm:[}{o{+7ݠt9Ld27VF%JlV@ xN G P,6d m#-e9"!~$C n;ΌqB!_]c>C-Ϟ#L띧켿XRGjJl.V@`vF ?ˣ+:TaD ¨0ꪮy0u:ob3,)Ng?kנ@&OtTubL㘊cnmmQI˶Isז0˔8SH( oe8c2j5㮡G?ΉYw3 =3ytl6lﰩnm=t4=j0"Lb ҘfC7Df,NڛgXtuRer?wߦ}~ m!sv1Į+!i 8_SEw܆WnHPqváMXk(_Ǿ/}G/V)OM ,W7:[N-MViyȃJe5mULRN!Bw×`=J-v̾h [쥪5S#褃uD^5ɻ)~sv8C 3ܲ3.~27l' !`1ŹbBFZnHPqFld闿?c{W$};N?i()g"X E1eo?LLT*:tȯOzLp,zlbRz힛LП,%7s!E֘%m&@[{& L6$ Ŕ~ǾG+;O^ϗN}줞:[ڞ5zÀ]@-.W (n>4(( }#N@3ẅi=O ;M~1ٵjb.r<l>2 IW-r{0,?*ҳP\]6 1  LT2i쏞-ϷJʏ{x rA=2H0ӲJx5p0VyXk(Zrw5F"' :"B9{TGr4~+g )?ӰMkh*KqVfDzdaa"ؒ0/ ^0?:S5Z8 ;-؅6Beok˶6% ֆne 8FV#v5޳w.ǟ)ʟAË/ ^.Fa?Y5sXt)A(]bژpuZA40]JG`l>,34{T1Nw紸<3nb>6wjeWhi=/2S?H8yVmwƥ@*9&I|5=-g{Bԟ\zC bft[L6a iP\%-;`u eޯɕE=98,3br1k(I:PAףЖuD*cT7t([jsۺe 2 T#Gng|q?g_VX9>X1e\j(syl1Y^H%VP0'T흝uDL1oNw1c0|BCH[*_+'.>g4$ǟ~O|ʇ/SB硰;,a^'kڭuHlSZ4r'bgaŴxW 5e]>5bȔdtZr\C*z/Ҏ˭L\nJb0x^J'o#'nB9'l *|,@>v=Ǟ9N>19cP xN~"<*s<2\lF+CZ.56irƬ#Dnu{llitmZƁu2NK$X!N=Ze~ي#EW_T QybdnFRN@W mMjَ.'D 1*бVLG?`\:N\͚I-Pm\>|҉zd{w"9pИ jсïRSB6f+rdJ⫲kKvH ^@:⮡ u cBC 3utaNVM=vtߋWΓ 8qT5fHZ5[ɥ;_k9O7#k+HOlC 3nya9PRT ?Q^nHPqh(ɡa罜cMh(f^U<ê;׏u/ YJNrQyZZJkתc+/:=E*ɕۿΝ'ܵlT̕"yJёe;耆R1t:VL&D}U=vWOŷ-4ֶ4/4+5̏5xrONkNǙs2CB~Vcc"g(m @:T wlz>I4 Xc7<}'.=$$_I.kqvh9cY٨¥Nn_zG~WTLD8ٙk$m~A FVJʶdP@P*ӻ- !.W0½Kĵ) j(z% e[.BCPqh( (}ݖt:= zV;8N z u{uD'MKHO:#P&ʶqŜ14 (<0*BWmq_2!c~Eeع ]fJ%9](q 4<Y,2wK}O9mG~U*#~lX  YzV5Po -?8@Ggrbig4ivIQa~(I4rèjżq_3Jɰp2>`w|MlsyFϽth4:9NcQ^|d&x:` #8@gK C_O୪շJ1)Pi˓on3%Ώ^nh<s8um= =n'  BPON Br(rA3q$4<@-s^t T? {lZΝ9(սeJњ3c.qbujT*>|8K:bzLQpB>j( hOh(` @:?sK,nN;t 5T~.Nr* @%t[X()DfN!N3Atٻzt]ꇲzG B)x(@B y:RP\2*?(ITN@Yx8R j/QxuJN#trZ6 , ^oԒ>b2t]궳],7܅P@44,:W ,C0aO„JyU{j ~ZXx셬n 4dlTp8:;;;\nXP@4Uz_ Dۋ1:U*s=EA՝qyu:]La6 5_,AD,1VAsކ7@CP@iDQgcchP&c4Nt:Qg :6T=S4lJۥK*;::tZjg t@CAH^fd0 A:f3U7t;h( (˳L&;;;tz.Kv)耆R B:&p h( (h4;;;t7nK׋ck)y%"FӤsр:RCAH?EQJ݊ 6{ VRqs4xh4&9zHM@CAl e<FA~\Tɑ)1(ú|c\8wpq3NruxBKPLxv7 Qה49k:GGs<ã6yKE)CP o/'r :@Ÿ.vwU[AvσbVoD4ԊP ;J]# ,r8< bn4SL&bxxxvE)h( 3c;lXV udxx #_(ovP7Rh]* `1.-ԏSyg5`pvؐ)$45&ae%}yZCYRK rf]B"_E?w~ edT՝0Ү1<  ΜBW) }ѡJ8jpfɷ% bk(?D*ÛhM͙p}]ꋳl_,P﻾e<}t3X v5x_+_/Ys2 ޯxnJ}@*\CW y.'g {XOCt `ua`}RD!HCGg_JChϽ5!\ \tl:HܺC(Vk6Ng6_2׮'#43!zVIueRDɪ視r"RR@j?wrzzU*n` RGb$4rj-MzCO=ٮ ' 3*&CX3vBn!l,_*{ ωt5dR*677HPAH?ѵ^ E pq֏IVL+SBj!Y#C,֕x:A;15\N[x&V^Ș^JN9Tbp<K֐п++]t~1i T*u:vv~h(`9 %ھ<|gAzc><$bp }}y\uS)e!u(u^ K, ^&jzrr25t]DB 8XVC/\ ƥFFl6jXP4 2;; Z Ku% @CIP@Q5dn2+ _ 8Z12 :dR, 8ZGCL&nw4Rtppа@ҀVj(~T*raU 8|Gm$kzM CAȚdb6 @CAXXboch( ZSpEC{]⯼TsIh(VP4[ &P)8_M #4@+`x bP.}YǾtۥBq:9η"<+d߈<U{E VY|ݝ%.| `h Oky3o7{$ EV-Qrx W+P1X BC_Cyw?U){< +i\q@Y5"1> eӍBj.\P)8Pݷq+|2Ե"FP:OyL1aF !K 1`_xBճ_/ɉ2mIsv 5 m>D/?z 0<* }ޓs-dD)0oR:[q>?/" .J48ќn҆KLQ_%̄Kg!xT4Sޚq28+^W32 0<* mzkW4Y-"[+w# J(\wDEIV"bt' yբAKgPoBC@{?l10eR68ZS& *VhRtqiDogi|i s]y\g s"wPI2q9* S蕒할 h( 1ebf|>V#ǣgcDv,Kyw"O2fq9 SV+ACa"4mlC -D2Ӳ3|ti5i;P,;$1e"q Ee1f)ɖyPUT*!d: )Jꕠ =53m EiJtK,`.z=(BCY1e" ~(l/>I#k.3Un"(~? z}z#pox叾kUv@eHHCo]<Pԡ$Q'v -1"bD*49CGX11*"O+%D!x(q#~ @1jw?[[߸ v1<zT cłp f|%+)JɝE3]ɹςmYjF.v <᲼%`2QB gL9#QNEi@Ut% v21`%+BoTF}ޓs-dDm"!q EO\KmDbo]dKoIϾT+Y1UG%!'\Tr'&HLXDG;9Uc4 "yT &n($ ~ R}z#p2jo{t+W_:ql,}&"-/rq;<,_o*sY"FTYH?@ k"XpY. kyVDLNC# 9 Pw=u履=#&fٿ,Q&i(K-/e5Ĕ MsLrS%41YӮی\2Q3c ( E){sY#jQ)09& 9 ЀQ[ZX[>_0"1e"!3͇jT}옥@֍0IO7a%Dh(@ jELHŒ_yl$z|CNv+wt2Jޝ=<T$o>'”GkZz04nha҉7P@P+bDEf;=_|/~kV돿3*P`X$7еҥBoVĔ x?+~?pW}bҮ˜ O @tC+'4 "L@Tk?ڧ_Q?ԋo;OOG|r9B~w|gwMhx=H Ooɻ9j xL"oYbfrwXqޕ8/~)>8ZS& *5w4ogW9?_jXy~.+Dvt0aU=*z{x5<~bU8#iLe#¡HHhqPgB :?rI)z>8HȨ-BӦHcYJt@ئ²b5q#V̒˃w&J2džp+W~AbDEfWfoﱏ#;;o\kL Pv{sch}6Vt>t :}$i(lGyWP$$4и (E(9 ) AndnU.z dͪp/p&WpQ4=5w4=+Dž~Tf|Xi7yRIJ>Ұ<<X[}^ tC+;^cz"A/4ox叾kUv\L~a EpB9I)HC ¾Ch(!ޱ=X?pr+O~=eypB3 pfzNp * @OeÊg,Tw{> v?o`_"ӶREꀭep/ 1r 9n;UU%EYBܖz/Y39ozT]3?,}KKJ}"VN"^lc}x+fa} n1 o}7c,'I egCg|0ky7u˯4x,tXJ ůyg^| h(TF}ޓs-dDOd'}[0L =%fr/An,'hpGT$ڰͩ^AV%\BS7b(C}*٬4`_x+]_^}_vO_'>>1sDtX~>,eSD}"6HVr)@P=^ꕫ]Ӹe^Kd.z\pXJTNQ^:6xhRy6.~,AoUJj$랈2A*rz4RV q  ^HblƝ{?}^/;f)ӊ=v$E1Ri$^%1}j=ky$Oa)5YL|O Ҁʨ{?l10e 69'BioQpϖU: mjP`^! 迖{hRk \WJtj~`ҵo>P^d!#:;5<.D@r)y\K'42j}/_2;ЪD6qFB]"e;"v-m҅<ޗ6I;SwT^]b*ϭKJ5(~( P@Bcӌ3I  u}4 { LPuʥX$|ڇ۟izK vu"\gb{K % =* t^"*]6܉2A`<wצe%ǔWFqR %B<x(ƦLŵiBh`D; i 8L F6ftb_'^},L6" iMk]kXĩ!+E%yuҰJ}ytߋJ67061aMLh@#(6j-",E@$(W]b(Dz! tv4Ҍ Xo@iz+]6wb(Dz! tv4Ҍ Xow䚡+JW Ӿ?C1 *ی0a&K@fPjE ŀ1a`}K ֖ĉK@Q# 5ԊQ3c 5إ 6ysJbi hVP ͸jM(Aݛ@0UKk=1?Ƴ<;-IU|G; ^RhBCz5\{b(DEf8F ig*_L.>3a [+>}NN*I& yNJ Ni#EDh(@CSJ ŀH8SIv{>e6c4?q8?޷/ f6sd<^~$T}R)Asɮ2b`0Hf* c|cco4gy&MQ-Nt#ED]r44[X]+Cdz7"|.t\f c&b@Tme 5;gj jXT(ijIP-g.*ٺ4Ʉ };PQ:P YgT*!dz6v)zz%h(@C׫Sk 1Uʐl4 hzSd$61Z4pQސLtHY$ȀvR%øPl8Z-t:#vO{RgU|Ѫl]vSjȳ>مd准6i5c;'Z<…1($\dƦ9&As 4h%46cpV7#0U,|mL5&R*vvvK\>88< 2瘚M&K@fPT&9}ڳwstHG$nTzi0 oİgwB?櫄3cbnh`D; iF hQDF(K\gJ2d?p8vܛhlllpyt-FT i6`<ommmnnNx:<67Qr |eɼ~󡻾Zq;f)jXS)yn,xbi6{{{Vkjm4L&M]ԼRvQn7 f 09 ^sW?Gr\Hs6„!rՍhXFi$`@P+qxxR=tڒQ Fv+*Oo6|f s0X&pů{7/_xw?rGFqbҋZ %hXFuBC0j F^}RX \Ot:a(]WVY'h+09&faM?G?| |-.1I; h(D; z6 ЀQAPX,rZ6L)6qh01k `.yjm̼>.Ì瘘z6O|o~&z vw㳣d3ZZcZ#j(q]Wsy@g# 5Ԋ z^{ommEib[7vy~|rr25\:瘘z6;s|73v~\30ӟbyyy`"Ddv=Yhc]hXFBCi0dκy_hΜToE|Boljxt |!urXwvk~emp\PK'xooocccj핓'Ic8&IX~+NZt'qd06117 lrh6C>_w?W>py~cvC=iPxOjwnQfb=i hȨNs[$G*S+FE%мN C!2ɫpJw&q5{T*)ZC^jq lllpv9-i)3N7 ?M), szvG_?أ0pۏʌϼs+feM\O)dOiOL/'2K@(4ʿ%̝PluŬ?l&joP;CxlFә+J\[|AP^1 _î];n鮒T`zj(̣_+~'b7?zN.}ՙ[ws\_C XS(ΗDOZCYӨ(h@?QBC>F߼KBn0c؋nܝ,_`ԭb'ȵ:n?u\RπP%t_p>?שqMX,a5IVnt [4 @~>_}7OS?٧a.γD;  H7?կd)5+0?w~NOOx";;;<KY?^؛.3JmS<|7vgl*  MI]r̿Ak42Jh(@OCy{G"Y'  )s̗rfbdP+Uh(d619qUC#BpEZBOUPj(ŎPŪz;9d~Wտ}F7;ZmccOu@gaP {{{#QV RcP|Zd=\$42Jh(@OCyP|~]&Q ɓ~JcZ,lC/9q_dөwϽEXCbD%]j_ BNW6 ZѻuC٬T*-jzdrrrnԌhɏ3l!)י޹!< PTv))=m< G}Kuaqjx m~KF#[C9=;.ϱFb{=RR<*%׍0a LhICA?泍,mv k+bU''OLMmg%fa .NFQBC0j }bZmss{U@Lhtl67,=AjWfƹȎ;vv~j.ވD`G2p1P4HsAh(@F bd2[ `ht:v'J̜>#\C9:z'yѸňY$4 vnY&4Z1P{O-\X|jVI/zg.*>! D; D)H XQ#&xx)O t΋%+Ҏn.mn] qtV5k vh4vwwʑwMzm鳝cGJxnw=۽>OK,17 4qu1Pxi(Q7[fݷX2b&ҝA9ҶE PKWbaWM꤆q|'w*|řR,0OMm%FJbnY»ΞdEβ)9 ZjnY _Toz7l eoj.;]07 ,h(/C9KuѾv9!> wv4^|g5P6vSV~JgBC*^x/%ydGj(r|&0OqTK9[4SIY&v<aK=^bw>BgQ_ۻM/^'F|6/<-c315Xj4Q%S16'35q(e̕fHUdzHYc+~'?n4.tMY70M)6N~j҄Pʨ]| 7^|Bl~(S<fݰBI./an?r4g@KJ,*/GUmDuvM\oɼCvrDvH Eεߕ2.\Czl)`0xx85#NFn|6 LƦ 4 mWT^5v V1t B EOoڳvaS?ⳍ?{?zڕ9sJKd 7ީPl;eX4^Si? mjU:<>n "z<eCu#/S}=3: Y1YZS 0;+=<`0`?&plΜz{A$|ܨrBMzǗ F}S3;j Oo0' B& Lh@?eL9Q{/tuyAwwqNZ+H)/lQis]+Bd*ݣj_ ߍB ND톐A[Ew::.S E@6nX,MMmh,5TRX:i2t4z&atwwÏYzw#2 .N~44jVvY0116ψHworf]sSdVb|pוiߌw::&zk+7i2;f?Ogyb; v#h(SSh(jB֦L~LaZ-꾼o'eggwwct~ifE'pm6Y;jcci6Sk,%" .3qh맠 5ԊFV55n;LҮZ`a3ΝKw8œ'Ro mxT*f ;oxm .q h%4Z1C^W,rzzL^o4.V*a+v0-Nc孭-9Kv9F2`Gǝ(H3Jh(@F bbFcccdFb$dW ݍJ=^gP MLM T*qbǏݮa9kɀ2w@#( 5ԊMLݝR82vs򅩹}|s0 e mX,Mʫ*;nb~Γ9`$\v444j#*[nJ@K^B3u[?wȳpebCNVK:y@f|4zѸlqY{[GxzM)L C[7)˶Ž+ :Y-g`}ǽ?9&.kX5`0Jvj>A-5 MrJL2ter?A4 c޼_/|skRiV)n9Xh 7Q0sԁ]E% R) l5޵3S5_+$Ԋ&>p!b$xPӴ+#Ǧ,KM/LF@|儖w=P,}Ͻ'nМS p%t86LL+<4KoZ|X PZh?ep?+(0S;M9$JɼSPQ?t'_vR lۂ~ ֛H5o6YC38 2EKz'PņC FC&!PP&VZ&I46sc`q_Ջ˻ /8~ ǿ;7[sv))?̽AF\7\[v<~(Oڢ)߲vq=/?ۂ~(rBJp#tSgn{*?YV b(6:99J%EYDؔ]R (EBQoឦ1W޶q5Xt7sd0E#ǣޘy&`?cr[XHC 4WPi?l\vkO-2DכPE9O@<RptfbPsa-Bf{^ ;[iBUܴĠ{;CQnNrd=3ipؗGWIT/tjgؔ:s\!kh4Ʀw*]>R|o apmX,r_vs,peVytᇒ/b)h(Ci(^RuB'̳Qb\"-m>vȲa_rݐ-pN42E{J@);7-0}y:}1/h{Kƒoc;RXj:s u %<6u,dzXhk맫ջxkR! Kqݑ3E~̞|;x(ަx("i O.l)5˰XٔxЅzp-V㴫85 ). VUzqTy7~M_6.x<=AU#>:zenJc]j_ /W4WP`&vSIZ$6w<cflUz}VM8 WON7O ?ٴZ;)t1_-a j۶R|}y/ޯG@( 5Ԋ%Sx0`LYRiogg혵q :4`غI|SأOH,`Έv) 5ԊVtҮH4BZkc64^F0as7]z;Q,*v .C@HABC0j 1Kd4ebCwi?_.NFQ6ࠐ2E= ;|x%F9䞻d|;R4;TQ7/'hnJl6L^7cv<~F9K! rcsrذ;qq4iPĊ15'y{2=Qr\&H@B~ERqv|h(~fx 4`0j\C9<; wSlEC;}{"f ž3|fQ2JaΘL&ryjncF5cӌr8 0qzb\+ Bmob?N,٬xu&i ֶfPQ۟w7n/^ R$L!k0D9#4*_2/٪0ꪃTLQZ\gTO;W d? --QZKʱ%!ΈJ 1":FJǦ6[ Tq2yOtُwpp05ה5L9^1ɞ%8 玎`ǽ KxV&:@fPʨҕW\}U/KIpNq˙6&7iy$F**I*TɐPUMk*jZulNh.kRm|7.5ͽ=yzq';#ӛnko].KSha߶5oC#vz;6{h(@ߨ=—Qcje|NPp&؎^+)B2-¾njS۫pސ!\lZ{sOƥ \;)7> 2v|Y?f9Xk ;3\qSXzYR t܁дyKe.#g@ 1j=,cR.Qs'A |tBnsppftZrs* ʉr@+"Oo&dlWj×jf钆M __I=\O{{~@,03DFLO`hHBCKi(*Zu)f{Nw2Pl`=::bZ)]׀ʌG^͇~Dgxl|7WifVvvvȏ<4mV~=>5㪔J{oeo襩&0ym;6wx#}# h,rfySghD ;({ݜP 1[[F#;,;t:޹+K#P0۫%?{uI]Gf3A 1K$҅M _Z{qݤVJgmqBFP2G2F Јo-1C1`jR.dZ Ʉ}$.QP۫%?Q~(2kO { "3 ]r^Zд dӍˌw]vWLv3Hĸh(@ jE XaeeWKl_ulZT|ߌo6Mf.PxPXM5B%Sn|f  nllpǸ@M _9h6٣xk4zisobViд&#g4 "b?6,7{%_9Ԭo|i`FT*NVK;==㥹mKN&75ó4{ vhH1>Y7PFNa_W팛4V,7=F;z=dRT]˅4n~֊aѸ<65X|3fsNƍ4G2F HӨI۶T-P}W K ]rsJҠ 1kx^1l6mǓr&l"il~(}2Y^ {SZ]#MttZ- @:7L?~kN`})D) ΒBit"fxH3svyE_- ky\R/T\wm ź[f,.2 #t?w?uO;H)ؓϽ ~l6?OeLtj\76=H S%42j}Ԟ&]tW-ŖlHBБ01bDEi{GͿ;Hi x<><<?Ptfskkv +2Jh(@CexʫWvuN*%J٤i5k/Nj("m*J޵3SB;dҼTWTkgRz xJĔ cS??aǝNRlnnJ%6턆˸PY|3oV2 S%42jzO?[{GL>YGx@;HYh.)QHrV+C~#{ً! 5ؐ~( ])U^2Q4ܶe{۟ Q'p%7\ u6p4g#klzl6677*U;?a=l2vqϔRif:NՂ,AOMW s7š2j}/_2;ЪD)[ Ռپ׭C<+\ġL!̹\}!.A'+ Pe HQǦnD>K(m&\pTR>) \> "ӻbSi(.Lv:̓.w//mJhO_oǨ};֫׮`_.C!WiVS|,Y1n{:+ӭ,O@bGx(bU/`&I]i }yVvUIYLy;x1Kb33G!N=ASb& LO+F{RvOMfkX,ﰣ3GPR7ң]CT<)gy)>HRR n% Z IR=Tf\`3Gt6ifܣ%v"K1YYZtgu؝!;sH{r!&zAc`a?y?~ ];mАsڦaZ_}k\7?U)dR,)Sh6TWSbI?31,O?XpBWNbP0۫%gkJ]H?򶇕*g3d4gNP: |D?vh<)[AR@e; ҏ,F{Rv*GIC!ڠI6hL&^ۍڞX!HtHѴ ^Rhc=|A?TF TP TfVZůr ?ICuT`DgKHV ͞rHP@P+j7^mgSRRqe3 ['*Gv(ҠP%M.xk\s&(SO9z>Jxtݴ!cSP͌CZ)I tFSBC c8aFUi69IC%4Yd2A$@%Xgzz(@i$ MLh6HsFh(U0s|ttv-2tQa MsLv/440]FBCLKx~(a4!i`lcbn8IC%) 4 d[[[lvE;3q9=cGB+l CR;v rbƱt&Bλ@RY )YUgQ<>D;HJS*P`=ҕW\}U/KIրO8Z3LrlA*yNV;fpfN.RBX$'fK5 ${lfƤzy|FE;M 6RSz,{ԉf5K<6tnjk(*˼F~Jg hd'HggZ^R=y֙;AWyE׷grluȞ9)n=<ÜQb͝r͟[ue Y~(a@<5uYӅY_Y\5RWZ[[Q.p&Smbh(3jZ\NR]8 c<z+Fal_ϲeh(n=OT*QP<-a )Օ5 O" &&-L7_h2iH[gDk,ܢ@?~  hn0(K~(b4]ƦBXƋAw#͜٢1u͌9y*(x j(nxiV\\C nٖKSH@h4ǒHN۳aY:&r/jFPSpFw@ h(^Vl3Sl؏~jiBC.i@Ctލ_Ve+_%66M K2>6 Cnmmvm;;;> D)4Uj4Q!j\uyڡ,B2;NR,JlذnͶ7=vrB?4zA%PVd>cӻo|;`<؊2h#N}kǦaVQS>os/ ;g4i;t9c[@Y5׎v?~g~~뷶MT/Į#/=Kћ̼{̨Z_y w;Rnzfz"Oԣvde:k!ʛ;uן_~{:uNWSĺg%+ huLo9V-ii*ghQJI(%-;YīqE~Ç_nmm͕NccԩSO=)v*vj an^ % k@7{?{?MmwㆶAϜd#=WrG{&EYU:~Ros[XQQuG׼_e=1'IPXKʺg<~x6]vW^ilLPoJߒwg85(D ABR6.~ѱ )hWyvO3;y&SNѴ<}sαyh-S#G<|uE PyoMxs`u틵Tfk+ۨusEzSe{Cߤo-_/Zg65MrdM+[})zkO= /peօkdM@d'b'*SQjA3%D5 O}S 6ON~Ԓ)'SQfL]Һa'Lرc̱ghA;%@0b(8|RVϼ{;%}e=thn|lģMAi77 .eڥGkޯoZe;wnyyYՁSztXo] ;e%41Znj&7o@tQ|C)yG8"e==+<%;[ 2ueJ˶3 :;ySi<'k׮U:SN!K Ǐ}YV|ӳw:yf+o_aNl,ZoH$=?=ctR4x|:Kg^a]/xޞ:\zWi>KQMF|(A^橳S]XN>TAMCjd=f/,,$C;UHPb(8@0@ Io½w5#zzbKe bYNqkI<|OaUj t+?TsD=uT%=$C\|9 ~Zi#V&**o-L'7"d%(wӉpz&!_>\_DScXΣG3n</,,0d;}>]v!#zvv*vj %`_'W07m`p1f;;;%T `}Dv]yy(888`ORpo*:;*;(z<= N#Gq$hѸz#XKRA[|5bDs2d |g{A; @inZ7smmm05!4PA H<-׵;{wΣ׵s|K7)g}WAOb># TC ̇ @9M,P_ LV4# TCe׵S o>z(R@o7 bLV`F` b( /8m`qFK9 -6Z,;2g;1Q[UB7o_b1uRXXVL̿nMZ]vjTb(s-CǏ#'ߔwҞuNZ,j]xR7>htfNL@o) pș$gT\]̿uC WNN!@``>8888z((}K;7\y鹛KCToYq|ep^žP^}S~fNL@_ V|å h̿8eTb(t7|sȑ]k Fz7}ܙ|_`Wәd_U&iqe9ȳc0[Nwئnq͇# yxZd.:Nv#^.{Վ$?onS>Mz7;lnJ7U}rbflI(%'(/Ї3_Rv:jGdi ecM픕/#PǏ츮>rpp u-?{{gɾn~e}3nc27TNH"'5{\e;+yԊNԝVM3肒ęT'MTKmReLPVoj)uiZ )hڇ3͟u>Ym &d19u B +<<?Yq] 0dtoW}l}e݄W}$}|0q#VR#*Cܰ)gο FtV_F&@e ?;TQo'RNjc UbS}<8SgGf,krnc(s)P; 0\W`>Oy2RQ@w|g=ވ˾r'p|x.+^׉JV" f~k*GT&TtCK*}/H7iUhby'Ȩu2Uu5GTtjc X.$gYB{>LV.1A;db(t6fxΣG\W oz['6Ϭ~+É%Q> Ņc7];T{D{Y/WM1J42^O=L@VAsYBrm7PK@9>CMqwg5bB@C;NN!@#-W^,^<Y^^v] 0@J|S&>Z bL3q\W*fG\Cr 3 |Sq# P& 9O3nJoXj$ճLK̟m/Uxzy(=v*vj MǏ:u Ӡx@9wfKM(MH%*2j;kfnC{&кhj)ȠԅWةSI1qڵ˗/| NĩSl~wwU}h/2# s6#zvA7a1ZY=Ӟ̿NjSz ЈW^yekk+<1,//_~s} ?<ܹs@d655ĂPjM*JgڣةS  8va18888zh~/<mǛVhHHSAĭNHP?S۷1CT1>HLM,ةi ;vأG۷=7߸ڼç$y(HB vM%0:ro:`AĭNHPOlrܹWH [0ɿ>z( jt 0[*PxxHrU$ f;v=z.=M,ةi w}oI\1$")W^Ǘ/_v몁PqF +@-,-;Q0eQɊUb?1[p&M@G&fbV lYr<.c;5vJ_I)P@}g#1"'?AJ(𑔽SNQ?){)7e]Zl|m(Ub51qdN:EIlwSSS#P@mz24? Y^^>vP"\p[P)o.xrn.JrZur{C~kJ2ִZyuUo)Ɠ%܊:3W%M es ک@)P@}CAhQfC-zoEoZߏ7Uй-  W/1il&X@5%ɾ|T|P]Rl,tJ[6譵@Ko2Jפ1Nv*v 1PtzO9TēDž?t7ǫV׾XKeƾnJf&݁̆ }!>GԎ~gN9*np!TAb:ϒ#J42R*N(sm SUWm-Iپ8 T|xN.vjTb(>b 4?s' 3~{ore_Feb܌5bT9by-8K*v(\%_eP1ٽKF  L@VKIX)Z頺<Ì*Ί7n,O_L8vvj 쫉9YXe-xs!A)nzpt:|['6Ϭ~+É%Q{mt_Nh)5Vs|:"ы~kVߋ74z$T} GC#0͇beʟ~o䐲VQÔJR'%88IZީ+46eĺ<ހv*v 1P.nB/e1*k0OH>y@%OP>;;NQ +ڄzj?G[Y1YHR&*fMlaUr1pR%WMM@ &  QkhT6L"tIk#+keE`F))G1P^lsvH afmRZAX k&]U;DTŞdݿ_Y ||ӡ݋' Ubn\ О t$l/Xgڇک⦝B G64"@FIȨJ<{JZO\J]s*->-VVLbOLȫDu#G4K>Dhס'MQN_9?B642&+쪍ti2,S#hb(>zC &WK#߯僑 VeJIcz##OYJ%?iþKwC|yΞ Cmhh&(=ڦyt[i2+S#hj춝!j#}<,GECfNq-aO*DSfP|A' P]Jt~j 7sةi -z9'[&b(䀰]y(Ϟ4?FL] ۽P::T{S[nLV`F` b(>f_>pT:pzTuR1PETVV>uy|A' (*Q{-~tm&q+S#0@1PFf_, $'k3uK0,TW+yyyؓt|\G(@v*ѕJ-~tm&q+S#0@1P}&{v *1mg>WƩj)JX Y:h LFqfk V;52u\.: N: B 1M!s' I%KYJr%ia|M:uV@mp`tFPuZJv pCک@)P@}D{= xrsɕ>4ǽUWԱ',eU1Pǁ 8NՕ|yB*ڵ?1oMRPjv*v 1Ptz6Q^ϡ'<.D_3w&|7-Ou\_+^@^)^^腟Ƌq|,. Oû$Bo셵m{j݆&@(tElb {ByC0zzi 5C'"O˥\y N|.,"RFv6e MC0Q^ϡ'<.A?{{gɾnkTL,(ch8mGJSq{dՊ?,DMi8M@Q* ' /VW>94zy)]D1Pծ[咮 ^A=*M\ZC1: B ]M!s' oW}l}e/3sA6ocV[2KfŰ^.zUh LT* u&WZӲh!ة: pzWԦƣwrtE>bϒ:IPv*v 1PX6ֿ{?3aٖ-[Awz7=8q:~ӯYxX.+ }Esrf{ N-8wG!ڧ{/ EG䛒B %`TF錪jݦ|;UWc*\RɮWf7/p^!%!JM))yc2B Fgg7oDgm'ނmDsd]\hN3o4Qr!a)nzpt:|['6Ϭ~+É%Q<:B[ޏ߫/3CMmJ6܄f3ՊR=CRġ] V?v/Wڛ%. @6ΒH鹄<6@;h; O.nDgmW(q\_4PK1ېM&ݽFр7=8q%ԋ'?xmWU9], GG>.׵}\횚MLT*R;/vr:gtI*)8]Ks*,LP:Tb(> c(w޾2>öǟ>4!6Hwb#!=Aq ?G*of|O4`XR2$},L5I:D~yC!50禇C _[Dwtr)M8G0 О t&- >`i^S#hmF44t/n"I&_⯙}a0 >n}N%rC)]>wQ$4rZ&uxH"'1N*@87ݹ@[ WOm}ɟ%̻?+gtGea{)Y* |HS1a26s[S4<BD;VR&7D e44QH"%i~s3raC禫OBWd^㿄z1D$@m @ 4P!jWOb{[>-L_gX0 kdos\?uIf%~;P!2(Cqinq!ԌN*@87]cWX|΋_&!7uFM+v`;5# TF44_~x?\o|{lť{+bc# IНFu4?#%%z<@ZݭjFR'K (J+LgTt߹ǵ|U0`m| ĭNHb(6_'~_ο??.:տ^L~c˜Ux]9%0PI\rte7\b(T)c(kW6 nvjFCio?to.߰-J%1HAĝ nb>P89V$󰶱9DĿJH&N{z)uP¹z(mCP*3m| ĭNHb(6m~w~.};lsD WKmc lQB.~D[Ybnvja1Pgf?OIC`rQ}s&ۈ:)RCB$"u1}\+򕛌-~Bp"9dڈW%^Lo`hսPPб 8p]bnvjT1P~œGwC{5$M/~ru'k})`mF΍'W^z 3:MQzSjb(P8hw>P0;5v*v 1PPzOkʲP 1/lmēDž?~䓯?Hdޙ<pJ w YoƋ([r*-{^f MY4w idJu$+=YD #ךּQRʌ2cm'qHnzW;>"PG,07iwghz5b(6%fiK4n*RVkTnwy ,17iw B g],/ēz7=8q:~յ/Rl|C+}'bڒ:yO`2#I-:5r:uXzv{I+A b/<.\/{'Y3}1w :I[dA%;JwPk NN P\(Yu̟(Lձq=({~ #WggNrf8#P@m;eA )k xp1/C%qХ@m;Z5۳j HHFڍN!1{5,:],33_$bR\7+ξ*ΥjPGS,֓G;q3Gh<h >?Qo"s-S#igd; e+Ei$!hEV1"Vo$' ͕o\%2*L>\Bz8{}1能xuw<ķ@mҡ:OWRQE V[`F0Ҏ%v 1P>\gD_#7 43k(*V yfKB9KgAYagOG(@vЙ>x-~tm&q+S#0@1P4uN>hs!GR߲j SMCAQG>(@ }V[nLV`F` b(>TeJB$t5o*SJ( !kwt@\CDb #Q Ѝ>x-~tm&q+S#0@1P}!I[u^#(|P}J?龑f&N0 Ii}j@m ^H%^uZJ"qWy HuŽFu Љ>x-~H-^4Gr_T,& M j ҳ:|Pҽ>' (K;7\y鹛K}7 ^MT /8 SMh 0@;5# HCAgu*镤}(OP/;Op*PL˿&Vqh%Xl#eTo'WEWZ,SMh 0@;5# HGڔ= u*nzpt:|No-~&+(&q q/blCMNDAΑ+0,Ǔ5h=&q+S#0@e ̾gu*nzph 0[*{6Q^ϡ'<.:<`ةi R{hmF`xF,:[_#Aޚd%&_uxt1@;h; HoziƓ+/=ws}h7eE=>o;Lrt|ep^:o ` B 7}ܙ|_`Wәd_|Q.!9A^S$y3S.767oXw{?A 0NN!R2pdHާX`q" Iñ + eneb;GQj hmC)MSO>|PT H#ߔ|.?a.r&Hϕ hP0@%{JK:Y b(v*PA iw ` TCo:`A 0N*`7 hP0@XC S b( M,ک@1 gidVq; +PTY+kޚtZb(vQhC7|9c%ߔyYɝe6+1A;U(>S`vn/o+U(9°[Ip5(Y5:Xb,-tzLEFOgjD ؁v*v 1 o`}ӫ*;yxufu:/9Q WHe}D,P.hmC)M\Nf$@cX@t 7bŁbû#OEp;9Wzvn<|SS`I:O^б hb( Mnd6PT B dpiC|l| b(vN!2< b(v*PA 1@; t ` TC9r(/h ک@ P `13;ʣ$D(IENDB`java-design-patterns-1.16.0/layers/etc/layers.ucls000066400000000000000000000340651312550536300221010ustar00rootroot00000000000000 java-design-patterns-1.16.0/layers/etc/layers.urm.puml000066400000000000000000000072261312550536300227110ustar00rootroot00000000000000@startuml package com.iluwatar.layers { class App { - cakeBakingService : CakeBakingService {static} + App() - initializeData(cakeBakingService : CakeBakingService) {static} + main(args : String[]) {static} } class Cake { - id : Long - layers : Set - topping : CakeTopping + Cake() + addLayer(layer : CakeLayer) + getId() : Long + getLayers() : Set + getTopping() : CakeTopping + setId(id : Long) + setLayers(layers : Set) + setTopping(topping : CakeTopping) + toString() : String } interface CakeBakingService { + bakeNewCake(CakeInfo) {abstract} + getAllCakes() : List {abstract} + getAvailableLayers() : List {abstract} + getAvailableToppings() : List {abstract} + saveNewLayer(CakeLayerInfo) {abstract} + saveNewTopping(CakeToppingInfo) {abstract} } class CakeBakingServiceImpl { - context : AbstractApplicationContext + CakeBakingServiceImpl() + bakeNewCake(cakeInfo : CakeInfo) + getAllCakes() : List - getAvailableLayerEntities() : List + getAvailableLayers() : List - getAvailableToppingEntities() : List + getAvailableToppings() : List + saveNewLayer(layerInfo : CakeLayerInfo) + saveNewTopping(toppingInfo : CakeToppingInfo) } interface CakeDao { } class CakeInfo { + cakeLayerInfos : List + cakeToppingInfo : CakeToppingInfo + id : Optional + CakeInfo(cakeToppingInfo : CakeToppingInfo, cakeLayerInfos : List) + CakeInfo(id : Long, cakeToppingInfo : CakeToppingInfo, cakeLayerInfos : List) + calculateTotalCalories() : int + toString() : String } class CakeLayer { - cake : Cake - calories : int - id : Long - name : String + CakeLayer() + CakeLayer(name : String, calories : int) + getCake() : Cake + getCalories() : int + getId() : Long + getName() : String + setCake(cake : Cake) + setCalories(calories : int) + setId(id : Long) + setName(name : String) + toString() : String } interface CakeLayerDao { } class CakeLayerInfo { + calories : int + id : Optional + name : String + CakeLayerInfo(id : Long, name : String, calories : int) + CakeLayerInfo(name : String, calories : int) + toString() : String } class CakeTopping { - cake : Cake - calories : int - id : Long - name : String + CakeTopping() + CakeTopping(name : String, calories : int) + getCake() : Cake + getCalories() : int + getId() : Long + getName() : String + setCake(cake : Cake) + setCalories(calories : int) + setId(id : Long) + setName(name : String) + toString() : String } interface CakeToppingDao { } class CakeToppingInfo { + calories : int + id : Optional + name : String + CakeToppingInfo(id : Long, name : String, calories : int) + CakeToppingInfo(name : String, calories : int) + toString() : String } class CakeViewImpl { - LOGGER : Logger {static} - cakeBakingService : CakeBakingService + CakeViewImpl(cakeBakingService : CakeBakingService) + render() } interface View { + render() {abstract} } } CakeViewImpl --> "-cakeBakingService" CakeBakingService CakeInfo --> "-cakeToppingInfo" CakeToppingInfo CakeInfo --> "-cakeLayerInfos" CakeLayerInfo App --> "-cakeBakingService" CakeBakingService CakeLayer --> "-cake" Cake Cake --> "-topping" CakeTopping CakeBakingServiceImpl ..|> CakeBakingService CakeViewImpl ..|> View @endumljava-design-patterns-1.16.0/layers/pom.xml000066400000000000000000000045051312550536300204500ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 com.iluwatar.layers layers org.springframework.data spring-data-jpa org.hibernate hibernate-entitymanager commons-dbcp commons-dbcp com.h2database h2 junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/layers/src/000077500000000000000000000000001312550536300177165ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/000077500000000000000000000000001312550536300206425ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/java/000077500000000000000000000000001312550536300215635ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/java/com/000077500000000000000000000000001312550536300223415ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300241715ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/000077500000000000000000000000001312550536300254705ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/App.java000066400000000000000000000116311312550536300270550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.Arrays; /** * * Layers is an architectural style where software responsibilities are divided among the different layers of the * application. *

* This example demonstrates a traditional 3-layer architecture consisting of data access layer, business layer and * presentation layer. *

* The data access layer is formed of Spring Data repositories CakeDao, CakeToppingDao and * CakeLayerDao. The repositories can be used for CRUD operations on cakes, cake toppings and cake layers * respectively. *

* The business layer is built on top of the data access layer. CakeBakingService offers methods to * retrieve available cake toppings and cake layers and baked cakes. Also the service is used to create new cakes out of * cake toppings and cake layers. *

* The presentation layer is built on the business layer and in this example it simply lists the cakes that have been * baked. *

* We have applied so called strict layering which means that the layers can only access the classes directly beneath * them. This leads the solution to create an additional set of DTOs ( CakeInfo, * CakeToppingInfo, CakeLayerInfo) to translate data between layers. In other words, * CakeBakingService cannot return entities ( Cake, CakeTopping, * CakeLayer) directly since these reside on data access layer but instead translates these into business * layer DTOs (CakeInfo, CakeToppingInfo, CakeLayerInfo) and returns them * instead. This way the presentation layer does not have any knowledge of other layers than the business layer and thus * is not affected by changes to them. * * @see Cake * @see CakeTopping * @see CakeLayer * @see CakeDao * @see CakeToppingDao * @see CakeLayerDao * @see CakeBakingService * @see CakeInfo * @see CakeToppingInfo * @see CakeLayerInfo * */ public class App { private static CakeBakingService cakeBakingService = new CakeBakingServiceImpl(); /** * Application entry point * * @param args Command line parameters */ public static void main(String[] args) { // initialize example data initializeData(cakeBakingService); // create view and render it CakeViewImpl cakeView = new CakeViewImpl(cakeBakingService); cakeView.render(); } /** * Initializes the example data */ private static void initializeData(CakeBakingService cakeBakingService) { cakeBakingService.saveNewLayer(new CakeLayerInfo("chocolate", 1200)); cakeBakingService.saveNewLayer(new CakeLayerInfo("banana", 900)); cakeBakingService.saveNewLayer(new CakeLayerInfo("strawberry", 950)); cakeBakingService.saveNewLayer(new CakeLayerInfo("lemon", 950)); cakeBakingService.saveNewLayer(new CakeLayerInfo("vanilla", 950)); cakeBakingService.saveNewLayer(new CakeLayerInfo("strawberry", 950)); cakeBakingService.saveNewTopping(new CakeToppingInfo("candies", 350)); cakeBakingService.saveNewTopping(new CakeToppingInfo("cherry", 350)); CakeInfo cake1 = new CakeInfo(new CakeToppingInfo("candies", 0), Arrays.asList(new CakeLayerInfo( "chocolate", 0), new CakeLayerInfo("banana", 0), new CakeLayerInfo("strawberry", 0))); try { cakeBakingService.bakeNewCake(cake1); } catch (CakeBakingException e) { e.printStackTrace(); } CakeInfo cake2 = new CakeInfo(new CakeToppingInfo("cherry", 0), Arrays.asList( new CakeLayerInfo("vanilla", 0), new CakeLayerInfo("lemon", 0), new CakeLayerInfo( "strawberry", 0))); try { cakeBakingService.bakeNewCake(cake2); } catch (CakeBakingException e) { e.printStackTrace(); } } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/Cake.java000066400000000000000000000045451312550536300272060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.HashSet; import java.util.Set; import javax.persistence.CascadeType; import javax.persistence.Entity; import javax.persistence.FetchType; import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.OneToMany; import javax.persistence.OneToOne; /** * * Cake entity * */ @Entity public class Cake { @Id @GeneratedValue private Long id; @OneToOne(cascade = CascadeType.REMOVE) private CakeTopping topping; @OneToMany(cascade = CascadeType.REMOVE, fetch = FetchType.EAGER) private Set layers; public Cake() { setLayers(new HashSet<>()); } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public CakeTopping getTopping() { return topping; } public void setTopping(CakeTopping topping) { this.topping = topping; } public Set getLayers() { return layers; } public final void setLayers(Set layers) { this.layers = layers; } public void addLayer(CakeLayer layer) { this.layers.add(layer); } @Override public String toString() { return String.format("id=%s topping=%s layers=%s", id, topping, layers.toString()); } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java000066400000000000000000000026441312550536300321770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; /** * * Custom exception used in cake baking * */ public class CakeBakingException extends Exception { private static final long serialVersionUID = 1L; public CakeBakingException() {} public CakeBakingException(String message) { super(message); } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java000066400000000000000000000034541312550536300316410ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.List; /** * * Service for cake baking operations * */ public interface CakeBakingService { /** * Bakes new cake according to parameters */ void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException; /** * Get all cakes */ List getAllCakes(); /** * Store new cake topping */ void saveNewTopping(CakeToppingInfo toppingInfo); /** * Get available cake toppings */ List getAvailableToppings(); /** * Add new cake layer */ void saveNewLayer(CakeLayerInfo layerInfo); /** * Get available cake layers */ List getAvailableLayers(); } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java000066400000000000000000000145611312550536300324640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.ArrayList; import java.util.HashSet; import java.util.Iterator; import java.util.List; import java.util.Optional; import java.util.Set; import java.util.stream.Collectors; import org.springframework.context.support.AbstractApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; /** * * Implementation of CakeBakingService * */ @Service @Transactional public class CakeBakingServiceImpl implements CakeBakingService { private AbstractApplicationContext context; public CakeBakingServiceImpl() { this.context = new ClassPathXmlApplicationContext("applicationContext.xml"); } @Override public void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException { List allToppings = getAvailableToppingEntities(); List matchingToppings = allToppings.stream().filter(t -> t.getName().equals(cakeInfo.cakeToppingInfo.name)) .collect(Collectors.toList()); if (matchingToppings.isEmpty()) { throw new CakeBakingException(String.format("Topping %s is not available", cakeInfo.cakeToppingInfo.name)); } List allLayers = getAvailableLayerEntities(); Set foundLayers = new HashSet<>(); for (CakeLayerInfo info : cakeInfo.cakeLayerInfos) { Optional found = allLayers.stream().filter(layer -> layer.getName().equals(info.name)).findFirst(); if (!found.isPresent()) { throw new CakeBakingException(String.format("Layer %s is not available", info.name)); } else { foundLayers.add(found.get()); } } CakeToppingDao toppingBean = context.getBean(CakeToppingDao.class); CakeTopping topping = toppingBean.findOne(matchingToppings.iterator().next().getId()); CakeDao cakeBean = context.getBean(CakeDao.class); Cake cake = new Cake(); cake.setTopping(topping); cake.setLayers(foundLayers); cakeBean.save(cake); topping.setCake(cake); toppingBean.save(topping); CakeLayerDao layerBean = context.getBean(CakeLayerDao.class); for (CakeLayer layer : foundLayers) { layer.setCake(cake); layerBean.save(layer); } } @Override public void saveNewTopping(CakeToppingInfo toppingInfo) { CakeToppingDao bean = context.getBean(CakeToppingDao.class); bean.save(new CakeTopping(toppingInfo.name, toppingInfo.calories)); } @Override public void saveNewLayer(CakeLayerInfo layerInfo) { CakeLayerDao bean = context.getBean(CakeLayerDao.class); bean.save(new CakeLayer(layerInfo.name, layerInfo.calories)); } private List getAvailableToppingEntities() { CakeToppingDao bean = context.getBean(CakeToppingDao.class); List result = new ArrayList<>(); Iterator iterator = bean.findAll().iterator(); while (iterator.hasNext()) { CakeTopping topping = iterator.next(); if (topping.getCake() == null) { result.add(topping); } } return result; } @Override public List getAvailableToppings() { CakeToppingDao bean = context.getBean(CakeToppingDao.class); List result = new ArrayList<>(); Iterator iterator = bean.findAll().iterator(); while (iterator.hasNext()) { CakeTopping next = iterator.next(); if (next.getCake() == null) { result.add(new CakeToppingInfo(next.getId(), next.getName(), next.getCalories())); } } return result; } private List getAvailableLayerEntities() { CakeLayerDao bean = context.getBean(CakeLayerDao.class); List result = new ArrayList<>(); Iterator iterator = bean.findAll().iterator(); while (iterator.hasNext()) { CakeLayer next = iterator.next(); if (next.getCake() == null) { result.add(next); } } return result; } @Override public List getAvailableLayers() { CakeLayerDao bean = context.getBean(CakeLayerDao.class); List result = new ArrayList<>(); Iterator iterator = bean.findAll().iterator(); while (iterator.hasNext()) { CakeLayer next = iterator.next(); if (next.getCake() == null) { result.add(new CakeLayerInfo(next.getId(), next.getName(), next.getCalories())); } } return result; } @Override public List getAllCakes() { CakeDao cakeBean = context.getBean(CakeDao.class); List result = new ArrayList<>(); Iterator iterator = cakeBean.findAll().iterator(); while (iterator.hasNext()) { Cake cake = iterator.next(); CakeToppingInfo cakeToppingInfo = new CakeToppingInfo(cake.getTopping().getId(), cake.getTopping().getName(), cake .getTopping().getCalories()); List cakeLayerInfos = new ArrayList<>(); for (CakeLayer layer : cake.getLayers()) { cakeLayerInfos.add(new CakeLayerInfo(layer.getId(), layer.getName(), layer.getCalories())); } CakeInfo cakeInfo = new CakeInfo(cake.getId(), cakeToppingInfo, cakeLayerInfos); result.add(cakeInfo); } return result; } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeDao.java000066400000000000000000000025761312550536300276340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.springframework.data.repository.CrudRepository; import org.springframework.stereotype.Repository; /** * * CRUD repository for cakes * */ @Repository public interface CakeDao extends CrudRepository { } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeInfo.java000066400000000000000000000044701312550536300300170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.List; import java.util.Optional; /** * * DTO for cakes * */ public class CakeInfo { public final Optional id; public final CakeToppingInfo cakeToppingInfo; public final List cakeLayerInfos; /** * Constructor */ public CakeInfo(Long id, CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { this.id = Optional.of(id); this.cakeToppingInfo = cakeToppingInfo; this.cakeLayerInfos = cakeLayerInfos; } /** * Constructor */ public CakeInfo(CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { this.id = Optional.empty(); this.cakeToppingInfo = cakeToppingInfo; this.cakeLayerInfos = cakeLayerInfos; } /** * Calculate calories */ public int calculateTotalCalories() { int total = cakeToppingInfo != null ? cakeToppingInfo.calories : 0; total += cakeLayerInfos.stream().mapToInt(c -> c.calories).sum(); return total; } @Override public String toString() { return String.format("CakeInfo id=%d topping=%s layers=%s totalCalories=%d", id.orElse(-1L), cakeToppingInfo, cakeLayerInfos, calculateTotalCalories()); } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeLayer.java000066400000000000000000000043731312550536300302020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import javax.persistence.CascadeType; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.ManyToOne; /** * * CakeLayer entity * */ @Entity public class CakeLayer { @Id @GeneratedValue private Long id; private String name; private int calories; @ManyToOne(cascade = CascadeType.ALL) private Cake cake; public CakeLayer() {} public CakeLayer(String name, int calories) { this.setName(name); this.setCalories(calories); } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public final void setName(String name) { this.name = name; } public int getCalories() { return calories; } public final void setCalories(int calories) { this.calories = calories; } @Override public String toString() { return String.format("id=%s name=%s calories=%d", id, name, calories); } public Cake getCake() { return cake; } public void setCake(Cake cake) { this.cake = cake; } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java000066400000000000000000000026161312550536300306240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.springframework.data.repository.CrudRepository; import org.springframework.stereotype.Repository; /** * * CRUD repository for cake layers * */ @Repository public interface CakeLayerDao extends CrudRepository { } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java000066400000000000000000000035031312550536300310100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.Optional; /** * * DTO for cake layers * */ public class CakeLayerInfo { public final Optional id; public final String name; public final int calories; /** * Constructor */ public CakeLayerInfo(Long id, String name, int calories) { this.id = Optional.of(id); this.name = name; this.calories = calories; } /** * Constructor */ public CakeLayerInfo(String name, int calories) { this.id = Optional.empty(); this.name = name; this.calories = calories; } @Override public String toString() { return String.format("CakeLayerInfo id=%d name=%s calories=%d", id.orElse(-1L), name, calories); } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeTopping.java000066400000000000000000000044011312550536300305360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import javax.persistence.CascadeType; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.OneToOne; /** * * CakeTopping entity * */ @Entity public class CakeTopping { @Id @GeneratedValue private Long id; private String name; private int calories; @OneToOne(cascade = CascadeType.ALL) private Cake cake; public CakeTopping() {} public CakeTopping(String name, int calories) { this.setName(name); this.setCalories(calories); } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public final void setName(String name) { this.name = name; } public final int getCalories() { return calories; } public void setCalories(int calories) { this.calories = calories; } @Override public String toString() { return String.format("id=%s name=%s calories=%d", id, name, calories); } public Cake getCake() { return cake; } public void setCake(Cake cake) { this.cake = cake; } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java000066400000000000000000000026201312550536300311630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.springframework.data.repository.CrudRepository; import org.springframework.stereotype.Repository; /** * * CRUD repository cake toppings * */ @Repository public interface CakeToppingDao extends CrudRepository { } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java000066400000000000000000000035151312550536300313570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import java.util.Optional; /** * * DTO for cake toppings * */ public class CakeToppingInfo { public final Optional id; public final String name; public final int calories; /** * Constructor */ public CakeToppingInfo(Long id, String name, int calories) { this.id = Optional.of(id); this.name = name; this.calories = calories; } /** * Constructor */ public CakeToppingInfo(String name, int calories) { this.id = Optional.empty(); this.name = name; this.calories = calories; } @Override public String toString() { return String.format("CakeToppingInfo id=%d name=%s calories=%d", id.orElse(-1L), name, calories); } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java000066400000000000000000000032531312550536300306560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * View implementation for displaying cakes * */ public class CakeViewImpl implements View { private static final Logger LOGGER = LoggerFactory.getLogger(CakeViewImpl.class); private CakeBakingService cakeBakingService; public CakeViewImpl(CakeBakingService cakeBakingService) { this.cakeBakingService = cakeBakingService; } public void render() { cakeBakingService.getAllCakes().stream().forEach(cake -> LOGGER.info(cake.toString())); } } java-design-patterns-1.16.0/layers/src/main/java/com/iluwatar/layers/View.java000066400000000000000000000023451312550536300272510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; /** * * View interface * */ public interface View { void render(); } java-design-patterns-1.16.0/layers/src/main/resources/000077500000000000000000000000001312550536300226545ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/resources/META-INF/000077500000000000000000000000001312550536300240145ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/main/resources/META-INF/persistence.xml000066400000000000000000000027401312550536300270650ustar00rootroot00000000000000 java-design-patterns-1.16.0/layers/src/main/resources/applicationContext.xml000066400000000000000000000062201312550536300272460ustar00rootroot00000000000000 java-design-patterns-1.16.0/layers/src/main/resources/logback.xml000066400000000000000000000041651312550536300250060ustar00rootroot00000000000000 layers.log layers-%d.log 5 %-5p [%d{ISO8601,UTC}] %c: %m%n %-5p [%d{ISO8601,UTC}] %c: %m%n java-design-patterns-1.16.0/layers/src/test/000077500000000000000000000000001312550536300206755ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/test/java/000077500000000000000000000000001312550536300216165ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/test/java/com/000077500000000000000000000000001312550536300223745ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300242245ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/layers/000077500000000000000000000000001312550536300255235ustar00rootroot00000000000000java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/layers/AppTest.java000066400000000000000000000024731312550536300277540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/layers/CakeBakingExceptionTest.java000066400000000000000000000035711312550536300330720ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNull; /** * Date: 12/15/15 - 7:57 PM * * @author Jeroen Meulemeester */ public class CakeBakingExceptionTest { @Test public void testConstructor() throws Exception { final CakeBakingException exception = new CakeBakingException(); assertNull(exception.getMessage()); assertNull(exception.getCause()); } @Test public void testConstructorWithMessage() throws Exception { final String expectedMessage = "message"; final CakeBakingException exception = new CakeBakingException(expectedMessage); assertEquals(expectedMessage, exception.getMessage()); assertNull(exception.getCause()); } } java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/layers/CakeBakingServiceImplTest.java000066400000000000000000000152471312550536300333610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.junit.Test; import java.util.Arrays; import java.util.Collections; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertTrue; /** * Date: 12/15/15 - 9:55 PM * * @author Jeroen Meulemeester */ public class CakeBakingServiceImplTest { @Test public void testLayers() throws CakeBakingException { final CakeBakingServiceImpl service = new CakeBakingServiceImpl(); final List initialLayers = service.getAvailableLayers(); assertNotNull(initialLayers); assertTrue(initialLayers.isEmpty()); service.saveNewLayer(new CakeLayerInfo("Layer1", 1000)); service.saveNewLayer(new CakeLayerInfo("Layer2", 2000)); final List availableLayers = service.getAvailableLayers(); assertNotNull(availableLayers); assertEquals(2, availableLayers.size()); for (final CakeLayerInfo layer : availableLayers) { assertNotNull(layer.id); assertNotNull(layer.name); assertNotNull(layer.toString()); assertTrue(layer.calories > 0); } } @Test public void testToppings() throws CakeBakingException { final CakeBakingServiceImpl service = new CakeBakingServiceImpl(); final List initialToppings = service.getAvailableToppings(); assertNotNull(initialToppings); assertTrue(initialToppings.isEmpty()); service.saveNewTopping(new CakeToppingInfo("Topping1", 1000)); service.saveNewTopping(new CakeToppingInfo("Topping2", 2000)); final List availableToppings = service.getAvailableToppings(); assertNotNull(availableToppings); assertEquals(2, availableToppings.size()); for (final CakeToppingInfo topping : availableToppings) { assertNotNull(topping.id); assertNotNull(topping.name); assertNotNull(topping.toString()); assertTrue(topping.calories > 0); } } @Test public void testBakeCakes() throws CakeBakingException { final CakeBakingServiceImpl service = new CakeBakingServiceImpl(); final List initialCakes = service.getAllCakes(); assertNotNull(initialCakes); assertTrue(initialCakes.isEmpty()); final CakeToppingInfo topping1 = new CakeToppingInfo("Topping1", 1000); final CakeToppingInfo topping2 = new CakeToppingInfo("Topping2", 2000); service.saveNewTopping(topping1); service.saveNewTopping(topping2); final CakeLayerInfo layer1 = new CakeLayerInfo("Layer1", 1000); final CakeLayerInfo layer2 = new CakeLayerInfo("Layer2", 2000); final CakeLayerInfo layer3 = new CakeLayerInfo("Layer3", 2000); service.saveNewLayer(layer1); service.saveNewLayer(layer2); service.saveNewLayer(layer3); service.bakeNewCake(new CakeInfo(topping1, Arrays.asList(layer1, layer2))); service.bakeNewCake(new CakeInfo(topping2, Collections.singletonList(layer3))); final List allCakes = service.getAllCakes(); assertNotNull(allCakes); assertEquals(2, allCakes.size()); for (final CakeInfo cakeInfo : allCakes) { assertNotNull(cakeInfo.id); assertNotNull(cakeInfo.cakeToppingInfo); assertNotNull(cakeInfo.cakeLayerInfos); assertNotNull(cakeInfo.toString()); assertFalse(cakeInfo.cakeLayerInfos.isEmpty()); assertTrue(cakeInfo.calculateTotalCalories() > 0); } } @Test(expected = CakeBakingException.class) public void testBakeCakeMissingTopping() throws CakeBakingException { final CakeBakingServiceImpl service = new CakeBakingServiceImpl(); final CakeLayerInfo layer1 = new CakeLayerInfo("Layer1", 1000); final CakeLayerInfo layer2 = new CakeLayerInfo("Layer2", 2000); service.saveNewLayer(layer1); service.saveNewLayer(layer2); final CakeToppingInfo missingTopping = new CakeToppingInfo("Topping1", 1000); service.bakeNewCake(new CakeInfo(missingTopping, Arrays.asList(layer1, layer2))); } @Test(expected = CakeBakingException.class) public void testBakeCakeMissingLayer() throws CakeBakingException { final CakeBakingServiceImpl service = new CakeBakingServiceImpl(); final List initialCakes = service.getAllCakes(); assertNotNull(initialCakes); assertTrue(initialCakes.isEmpty()); final CakeToppingInfo topping1 = new CakeToppingInfo("Topping1", 1000); service.saveNewTopping(topping1); final CakeLayerInfo layer1 = new CakeLayerInfo("Layer1", 1000); service.saveNewLayer(layer1); final CakeLayerInfo missingLayer = new CakeLayerInfo("Layer2", 2000); service.bakeNewCake(new CakeInfo(topping1, Arrays.asList(layer1, missingLayer))); } @Test(expected = CakeBakingException.class) public void testBakeCakesUsedLayer() throws CakeBakingException { final CakeBakingServiceImpl service = new CakeBakingServiceImpl(); final List initialCakes = service.getAllCakes(); assertNotNull(initialCakes); assertTrue(initialCakes.isEmpty()); final CakeToppingInfo topping1 = new CakeToppingInfo("Topping1", 1000); final CakeToppingInfo topping2 = new CakeToppingInfo("Topping2", 2000); service.saveNewTopping(topping1); service.saveNewTopping(topping2); final CakeLayerInfo layer1 = new CakeLayerInfo("Layer1", 1000); final CakeLayerInfo layer2 = new CakeLayerInfo("Layer2", 2000); service.saveNewLayer(layer1); service.saveNewLayer(layer2); service.bakeNewCake(new CakeInfo(topping1, Arrays.asList(layer1, layer2))); service.bakeNewCake(new CakeInfo(topping2, Collections.singletonList(layer2))); } } java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/layers/CakeTest.java000066400000000000000000000072621312550536300301000ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import org.junit.Test; import java.util.HashSet; import java.util.Set; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; /** * Date: 12/15/15 - 8:02 PM * * @author Jeroen Meulemeester */ public class CakeTest { @Test public void testSetId() { final Cake cake = new Cake(); assertNull(cake.getId()); final Long expectedId = Long.valueOf(1234L); cake.setId(expectedId); assertEquals(expectedId, cake.getId()); } @Test public void testSetTopping() { final Cake cake = new Cake(); assertNull(cake.getTopping()); final CakeTopping expectedTopping = new CakeTopping("DummyTopping", 1000); cake.setTopping(expectedTopping); assertEquals(expectedTopping, cake.getTopping()); } @Test public void testSetLayers() { final Cake cake = new Cake(); assertNotNull(cake.getLayers()); assertTrue(cake.getLayers().isEmpty()); final Set expectedLayers = new HashSet<>(); expectedLayers.add(new CakeLayer("layer1", 1000)); expectedLayers.add(new CakeLayer("layer2", 2000)); expectedLayers.add(new CakeLayer("layer3", 3000)); cake.setLayers(expectedLayers); assertEquals(expectedLayers, cake.getLayers()); } @Test public void testAddLayer() { final Cake cake = new Cake(); assertNotNull(cake.getLayers()); assertTrue(cake.getLayers().isEmpty()); final Set initialLayers = new HashSet<>(); initialLayers.add(new CakeLayer("layer1", 1000)); initialLayers.add(new CakeLayer("layer2", 2000)); cake.setLayers(initialLayers); assertEquals(initialLayers, cake.getLayers()); final CakeLayer newLayer = new CakeLayer("layer3", 3000); cake.addLayer(newLayer); final Set expectedLayers = new HashSet<>(); expectedLayers.addAll(initialLayers); expectedLayers.addAll(initialLayers); expectedLayers.add(newLayer); assertEquals(expectedLayers, cake.getLayers()); } @Test public void testToString() { final CakeTopping topping = new CakeTopping("topping", 20); topping.setId(2345L); final CakeLayer layer = new CakeLayer("layer", 100); layer.setId(3456L); final Cake cake = new Cake(); cake.setId(1234L); cake.setTopping(topping); cake.addLayer(layer); final String expected = "id=1234 topping=id=2345 name=topping calories=20 " + "layers=[id=3456 name=layer calories=100]"; assertEquals(expected, cake.toString()); } } java-design-patterns-1.16.0/layers/src/test/java/com/iluwatar/layers/CakeViewImplTest.java000066400000000000000000000062331312550536300315520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.layers; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.*; /** * Date: 12/15/15 - 10:04 PM * * @author Jeroen Meulemeester */ public class CakeViewImplTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(CakeViewImpl.class); } @After public void tearDown() { appender.stop(); } /** * Verify if the cake view renders the expected result */ @Test public void testRender() { final List layers = new ArrayList<>(); layers.add(new CakeLayerInfo("layer1", 1000)); layers.add(new CakeLayerInfo("layer2", 2000)); layers.add(new CakeLayerInfo("layer3", 3000)); final List cakes = new ArrayList<>(); final CakeInfo cake = new CakeInfo(new CakeToppingInfo("topping", 1000), layers); cakes.add(cake); final CakeBakingService bakingService = mock(CakeBakingService.class); when(bakingService.getAllCakes()).thenReturn(cakes); final CakeViewImpl cakeView = new CakeViewImpl(bakingService); assertEquals(0, appender.getLogSize()); cakeView.render(); assertEquals(cake.toString(), appender.getLastMessage()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/lazy-loading/000077500000000000000000000000001312550536300202225ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/README.md000066400000000000000000000017101312550536300215000ustar00rootroot00000000000000--- layout: pattern title: Lazy Loading folder: lazy-loading permalink: /patterns/lazy-loading/ pumlid: LSXB3W8X303Gg-W1e7jlqu66gIc5zED4JwzRTo_lpjeaEwN9xOpO_W0mlEhWEFD89sjBWpHgMnDOyi90WoU-i7Ho7besHf2fmqJ_0GG_xo8BE-i0YlONDMtMdLE- categories: Other tags: - Java - Difficulty-Beginner - Idiom - Performance --- ## Intent Lazy loading is a design pattern commonly used to defer initialization of an object until the point at which it is needed. It can contribute to efficiency in the program's operation if properly and appropriately used. ![alt text](./etc/lazy-loading.png "Lazy Loading") ## Applicability Use the Lazy Loading idiom when * eager loading is expensive or the object to be loaded might not be needed at all ## Real world examples * JPA annotations @OneToOne, @OneToMany, @ManyToOne, @ManyToMany and fetch = FetchType.LAZY ## Credits * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/lazy-loading/etc/000077500000000000000000000000001312550536300207755ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/etc/lazy-loading.png000066400000000000000000000266271312550536300241120ustar00rootroot00000000000000PNG  IHDR;B`r-^IDATxm$]GBHR>0|  v|ˋC#+˲7;YL,^̞cam-ݧL-qOVwULuWuӣUoOOOMz(5 P |ǚ9^&H;0^ru/HPY6ˠx@*8ABA) *X  D$c$4!Jc/jY2Ό1AlL R&BLr9VX?VAA"/B e"Ĥ±FO_qƬwjw}EXki? 2#g*hyP"Icf_$ٌn0@:Y6G|Px'HN}l34KHBƤ*8y,PPnj;m378t莀?ٍCq;wzJ3#g2,h*b,tL ǒacK=lSF%<&}OUχ3$ܟ"3r&(6H LDR sG9J7/cB->}aռ\d_B Sl IUݏ krtvݾcB*wOńXc ~,ӄl?V@co|գe.qĐ՗Te0oz$lXxwbBl b`1JY8V1-g,Zu&(\b\D$9cJA@ &ĤIip,(Af rLB Ae Up,R"TV  HHPY2H(h %B Ae Up,R"TVMXW mmڣ[T4"@2Dk":}xGlo#E$&~𰈗2Qzԙ3/l]rP"$ߢ͚qqH(qgrי(ôq߱(ԭ+/}Gs.đ` ^0c'v,֮8xJ|)wpS2Nc:Unы'k}__΅n LfFќ4ufNf;V2- QxOc~GS2Bc:g[{;߰yK?6m`'/x2*׹lp~еoI*eg&?دzw?Óqn{EC{$I9/{U#˻q oTҬIHG0X_t-: $C2 u $mS2Bڽw[G'_[_|1 !8Heӽʵ.dl5iOacw1Z~&4_+t.M&p*J$[ #'8VltՌ $C2&MekDQ sS2B*3_9^9cHW>qێƕOs] lrɆaN3/f]9_FI|`bX'&ifL( | +h+ CDG]2' Qx'2#[S2B /Njp\ǒ|rc_ ltɌ820 Ա2#ge *X  D$c$4! eP@J@*8ABA) *X  D$c$4! eP@J@ʪ:9po,u븨=312DJ$TT:E *Ql\U5&U)O - ˙ؙ2l Jxlfbff ;lOuٟKuӪղ 4 iBL 77_,^D02vJw';i7j%)v+%3Z 4!& U^%zך=˾4 ?q|XwvYBxbO'Mju4 iBL+&Bjz:̳:;yZ1ѯf9ٱ$4UecY.>'j:IgFTU@ *Ĥя^GIcYױx }f)X BLr7y-.usB)OkD 3ftU8VVBl LbDXPx@*8ABA) *X  D$c$4! eP@J@*8ABA) *Ď55u] ]v rl @Yacu,nr9^&!VAsR"TV  HHPY2H(h %B Aeر}t%h  R5ԱQ Ɛ ! eP@JT@<׸=*RZ2-8A*jAwR{)1-_ ±7lᥛ~+}Z)h㦫 Ig+_qB)8dn/Yi&uw?m\k?@ڿOU9n w>vvk-[_JYo nSI-xh/%R%^]>Є()nja8ʫdJRXLJŕ rX26ȥ):J-@wGsTFGvp{:+ +%u,@rANc:Wx2JA4@8VڪUM8%'Tu&Ȍ)LT埼u%26,r8WW# qvzsp+TI]gWMD;/"F.>ZW)qi8VHcjv)%٨ MS9S$.?U){cNqel yukgI[C{X+ vӜu W:$p,GSX7ijXY\RԱ}W>qo۴158ֱ.{^\̸C؂Ƭ$sJ3L@Jԏ^IFjŴo Y*ғh:Vt$R~Jӏu<[he5YeO9 \kQ/v|Tqޫ[2֎,hq ;J5-MUdJп# xz1 ]t_`oEcNJ&mqc^Ҍ|}K]=KN.x"ù/z(2"͞p3@J? $j2#gr(NvMRuY3f_'ø20IX)ZY3{m%c|B|R1wPSFI b3T^%cα~TϼyQ K;^Vik9*߼K޷F7:[oĵDș"C!!˒: |G%:@Ҧ7*W:SwŇ_>a1_^\B̝/%/=s xRA\jeb ?4 $q״8U ۡA +yeryŬAkñgT] U%eW$eP@J@*8ABA) *X  D $,f  LW! YCce Q@Ŭ1dc>"T1˿af r\KgBRc)я' mHcEOa(  98Z\|ѢV+9+q+"nceH_)~Ď9QjH;Kel«0-ɽwFGho7&άl-^՟?;H3#gZr<#'

33zm ɱNP^Z@ĴZmݩ fNP@ca1khBlmmNE%zv[w*" Yn1kǒRׯ];%p888Нca1".fmXRuonnNP̱TUp,)t?==ٱjtDXXZqb*8VvNE9[F;!@%2bE\@ݝѝr#NP̱X̺Y(8V X[SQ6p+PV"kŬcŰ9??;ee%ڱY$c0 1]!Yb&r,,f.1U+(#0KLכŬS%cCl^ם.eVA-ݩ(<,le*8V"~ԝbspph4#X(؇XPc%&daaaccCw*(p,(Sn3;;;`"͞ƫ`LJ`0J rhTCzۛ%ϱS+;1Г?hՖX:մtx,[N-'}4ű4c)&DHp9ec2+TKh4SQ0Q uaUR-cه.j='BdNfc2+x(-fNHxOG8֕[n[:iy&\7xỘ$[%o}9Pp<#/H'q[L3V[c7t0zv; T{Xlc}Yў1L%['\2_r毉8%3Xҙ/DAh?N2OV[c^㡢$Uj4Ae(Quwɥl+%'"QВTKO XT%+//JCW[c2??o߳c#kTJ-"M{{g6aVD%ce|c/h|h[\9nR ,jp1\InZS ʱ~~կ^k#_ ß|D \{u,~E`d.Uɿ`4Wke88m(%Bvh4{9P4͌'=cDMse|]#^}\+Wpe+/W}e88` h>\~bcc#F(>L6.j&2"łwIKUYM[xpLlq/(n'_ՖXciedvv%AC+~]m5&X8C"fWicQZm5&TLOOc{ 4 ʎ>U09Ym5> Q&ppp@7 fʇcA 5>T@uݩ0Laݏ^J@M8X177j=PjjjJ.p,(S&7MݩA@^PTׄ `^C㈅صr^;==XPMXqtwlmmZ-p5TpLMMU/NL'U``1jWcQMKw*l;u 5&Th4STl2] @w),pHfNEi!B!pښӝ\z/Y xUGL&^W$Fi,,,P hXQa󛛛SQvww&Hk"3vF+V;Rǚvt"[ȒV˄` cMJ+bhwykrO3XKΚEupngvzŋndڴۏcoooqq@yc)%".%^juZ?+`HÌV#v<U(؞~DZ*oCс v"__M]5 mu G+,[H-A.OW +zڑ(Fs QEOi;91pLs7ʖԻt;!X@UtlooWpU\PnXOIS6BʊvB{4%@(T^7 >c4;;K(w!+;{k5#v(뤔 2fr)uĉT즿^W' p̡_߄̇>|%ZmllLMM SXÙ_EӒYTO羢jY.CT1 ݁-X;Y,FXp,Ck0.l vXp,,^}4#@-p,8AE*6>8"_jՎ. ?  T*IcXc5[ݖkZsvmOy+kd~dS[KgXUkkk*@,p,c(Ip}l:k6%[5p,αZIB  Y{'ha LNq;w͓97 :--N|cv6Z-1Kx9q();CB զYZ0p,u?i@Trr$u#w)Nu,oH5{?Lk~yX`9۾%=&Vcw*Ǣڕe+Pkl7b,a<4 ʎa4:^IXT:VpuuGzb=3e5XS:cxdoN.|Xrc'X=Q`0 C @-p,4cVeXXX] p,8E4;;{ҥ_d 5c]v… Xp,8֘| F^ǂcX P9PXbr;;{O>ܽM{  PPtӗ!ZN^|mxv}}7oW_y^‹'S95;`9oП>8gɚ~99'1 `<(w8ѵ{\N~Ol=_|ҧGK;{gX[l]Mv)vp,QX7}+GձCo>$ڸq7;n\dRDzm)l?¥[ s64<±rGYV8yqNy˓wY#xK޺6ձ䭂vp y?.eWܺgf:[p,@@Ʊ#g>gtޟm.=ƨ?>}2cykeiGfZXrGXOkG/'z'׿>8b| [s#2'onĂcrGX+9w豣G}OΙ'^y=;U 5@(h-k`Ռc9/Ȗnxw?Ni*cM|S-s23%Xp,PWgh>9}~k̼}((w*2w* ʝ;hN+ r;p,8܁c ((wXp,@1@ccfTڳAcce1p,@@3cySysz{<궜iԝw̶Z-g{4i3chr#lc͛Vusn\8 PXy>YaAHX+`guw_濗vzܫVƞ ;KykVkoHXVvG6?|bTqNfʝ+fG\Dc9fcuv+8m#/rt,e?Vk-ñUNcou?9ڠI)jE61d6[ݖ1*_zpw :3/ P~PHݛ/w,K;vmw#qDӌFg8F]p,@5@#u;:3oq?CNα$upe9;Z0$#{ |PS X rGX|',}ҿ3coVLa+8jܑ:OϾr'_Y[6ڴ3cqC0F;ʖ_wwoy/{+lp,@@5/oq?/>&jEL^TƯwC?܉en I z*w4ȟrdyI!XA@@cy,@Accy/a @Acc9 g j`Z@ccAp,@܁c ((wSS EӝoP X @1M+/IENDB`java-design-patterns-1.16.0/lazy-loading/etc/lazy-loading.ucls000066400000000000000000000100651312550536300242610ustar00rootroot00000000000000 java-design-patterns-1.16.0/lazy-loading/etc/lazy-loading.urm.puml000066400000000000000000000015171312550536300250740ustar00rootroot00000000000000@startuml package com.iluwatar.lazy.loading { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Heavy { - LOGGER : Logger {static} + Heavy() } class HolderNaive { - LOGGER : Logger {static} - heavy : Heavy + HolderNaive() + getHeavy() : Heavy } class HolderThreadSafe { - LOGGER : Logger {static} - heavy : Heavy + HolderThreadSafe() + getHeavy() : Heavy } class Java8Holder { - LOGGER : Logger {static} - heavy : Supplier + Java8Holder() - createAndCacheHeavy() : Heavy + getHeavy() : Heavy } ~class HeavyFactory { - heavyInstance : Heavy ~ HeavyFactory() + get() : Heavy } } HolderThreadSafe --> "-heavy" Heavy HolderNaive --> "-heavy" Heavy HeavyFactory --> "-heavyInstance" Heavy @endumljava-design-patterns-1.16.0/lazy-loading/pom.xml000066400000000000000000000033651312550536300215460ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 lazy-loading junit junit test java-design-patterns-1.16.0/lazy-loading/src/000077500000000000000000000000001312550536300210115ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/000077500000000000000000000000001312550536300217355ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/000077500000000000000000000000001312550536300226565ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/com/000077500000000000000000000000001312550536300234345ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300252645ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/000077500000000000000000000000001312550536300262435ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/loading/000077500000000000000000000000001312550536300276605ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java000066400000000000000000000044671312550536300312560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Lazy loading idiom defers object creation until needed. *

* This example shows different implementations of the pattern with increasing sophistication. *

* Additional information and lazy loading flavours are described in * http://martinfowler.com/eaaCatalog/lazyLoad.html * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // Simple lazy loader - not thread safe HolderNaive holderNaive = new HolderNaive(); Heavy heavy = holderNaive.getHeavy(); LOGGER.info("heavy={}", heavy); // Thread safe lazy loader, but with heavy synchronization on each access HolderThreadSafe holderThreadSafe = new HolderThreadSafe(); Heavy another = holderThreadSafe.getHeavy(); LOGGER.info("another={}", another); // The most efficient lazy loader utilizing Java 8 features Java8Holder java8Holder = new Java8Holder(); Heavy next = java8Holder.getHeavy(); LOGGER.info("next={}", next); } } java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java000066400000000000000000000031641312550536300316030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Heavy objects are expensive to create. * */ public class Heavy { private static final Logger LOGGER = LoggerFactory.getLogger(Heavy.class); /** * Constructor */ public Heavy() { LOGGER.info("Creating Heavy ..."); try { Thread.sleep(1000); } catch (InterruptedException e) { LOGGER.error("Exception caught.", e); } LOGGER.info("... Heavy created"); } } java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java000066400000000000000000000032671312550536300327330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Simple implementation of the lazy loading idiom. However, this is not thread safe. * */ public class HolderNaive { private static final Logger LOGGER = LoggerFactory.getLogger(HolderNaive.class); private Heavy heavy; /** * Constructor */ public HolderNaive() { LOGGER.info("HolderNaive created"); } /** * Get heavy object */ public Heavy getHeavy() { if (heavy == null) { heavy = new Heavy(); } return heavy; } } HolderThreadSafe.java000066400000000000000000000034551312550536300336170ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/loading/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Same as HolderNaive but with added synchronization. This implementation is thread safe, but each * {@link #getHeavy()} call costs additional synchronization overhead. * */ public class HolderThreadSafe { private static final Logger LOGGER = LoggerFactory.getLogger(HolderThreadSafe.class); private Heavy heavy; /** * Constructor */ public HolderThreadSafe() { LOGGER.info("HolderThreadSafe created"); } /** * Get heavy object */ public synchronized Heavy getHeavy() { if (heavy == null) { heavy = new Heavy(); } return heavy; } } java-design-patterns-1.16.0/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java000066400000000000000000000041241312550536300326330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.function.Supplier; /** * * This lazy loader is thread safe and more efficient than {@link HolderThreadSafe}. It utilizes * Java 8 functional interface {@link Supplier} as {@link Heavy} factory. * */ public class Java8Holder { private static final Logger LOGGER = LoggerFactory.getLogger(Java8Holder.class); private Supplier heavy = () -> createAndCacheHeavy(); public Java8Holder() { LOGGER.info("Java8Holder created"); } public Heavy getHeavy() { return heavy.get(); } private synchronized Heavy createAndCacheHeavy() { class HeavyFactory implements Supplier { private final Heavy heavyInstance = new Heavy(); @Override public Heavy get() { return heavyInstance; } } if (!HeavyFactory.class.isInstance(heavy)) { heavy = new HeavyFactory(); } return heavy.get(); } } java-design-patterns-1.16.0/lazy-loading/src/test/000077500000000000000000000000001312550536300217705ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/000077500000000000000000000000001312550536300227115ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/000077500000000000000000000000001312550536300234675ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300253175ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/000077500000000000000000000000001312550536300262765ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/loading/000077500000000000000000000000001312550536300277135ustar00rootroot00000000000000AbstractHolderTest.java000066400000000000000000000041671312550536300342500ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/loading/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.junit.Test; import static junit.framework.Assert.assertNotNull; import static junit.framework.Assert.assertSame; import static junit.framework.TestCase.assertNull; /** * Date: 12/19/15 - 11:58 AM * * @author Jeroen Meulemeester */ public abstract class AbstractHolderTest { /** * Get the internal state of the holder value * * @return The internal value */ abstract Heavy getInternalHeavyValue() throws Exception; /** * Request a lazy loaded {@link Heavy} object from the holder. * * @return The lazy loaded {@link Heavy} object */ abstract Heavy getHeavy() throws Exception; /** * This test shows that the heavy field is not instantiated until the method getHeavy is called */ @Test(timeout = 3000) public void testGetHeavy() throws Exception { assertNull(getInternalHeavyValue()); assertNotNull(getHeavy()); assertNotNull(getInternalHeavyValue()); assertSame(getHeavy(), getInternalHeavyValue()); } } java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java000066400000000000000000000025011312550536300321340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } HolderNaiveTest.java000066400000000000000000000032431312550536300335410ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/loading/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import java.lang.reflect.Field; /** * Date: 12/19/15 - 12:05 PM * * @author Jeroen Meulemeester */ public class HolderNaiveTest extends AbstractHolderTest { private final HolderNaive holder = new HolderNaive(); @Override Heavy getInternalHeavyValue() throws Exception { final Field holderField = HolderNaive.class.getDeclaredField("heavy"); holderField.setAccessible(true); return (Heavy) holderField.get(this.holder); } @Override Heavy getHeavy() { return holder.getHeavy(); } }HolderThreadSafeTest.java000066400000000000000000000033151312550536300345050ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/loading/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import java.lang.reflect.Field; /** * Date: 12/19/15 - 12:19 PM * * @author Jeroen Meulemeester */ public class HolderThreadSafeTest extends AbstractHolderTest { private final HolderThreadSafe holder = new HolderThreadSafe(); @Override Heavy getInternalHeavyValue() throws Exception { final Field holderField = HolderThreadSafe.class.getDeclaredField("heavy"); holderField.setAccessible(true); return (Heavy) holderField.get(this.holder); } @Override Heavy getHeavy() throws Exception { return this.holder.getHeavy(); } }Java8HolderTest.java000066400000000000000000000043631312550536300334540ustar00rootroot00000000000000java-design-patterns-1.16.0/lazy-loading/src/test/java/com/iluwatar/lazy/loading/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.lazy.loading; import java.lang.reflect.Field; import java.util.function.Supplier; /** * Date: 12/19/15 - 12:27 PM * * @author Jeroen Meulemeester */ public class Java8HolderTest extends AbstractHolderTest { private final Java8Holder holder = new Java8Holder(); @Override Heavy getInternalHeavyValue() throws Exception { final Field holderField = Java8Holder.class.getDeclaredField("heavy"); holderField.setAccessible(true); final Supplier supplier = (Supplier) holderField.get(this.holder); final Class supplierClass = supplier.getClass(); // This is a little fishy, but I don't know another way to test this: // The lazy holder is at first a lambda, but gets replaced with a new supplier after loading ... if (supplierClass.isLocalClass()) { final Field instanceField = supplierClass.getDeclaredField("heavyInstance"); instanceField.setAccessible(true); return (Heavy) instanceField.get(supplier); } else { return null; } } @Override Heavy getHeavy() throws Exception { return holder.getHeavy(); } }java-design-patterns-1.16.0/marker/000077500000000000000000000000001312550536300171115ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/.gitignore000066400000000000000000000000111312550536300210710ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/marker/README.md000066400000000000000000000015771312550536300204020ustar00rootroot00000000000000--- layout: pattern title: Marker Interface folder: marker permalink: /patterns/marker/ categories: Design tags: - Java - Difficulty-Beginner --- ## Intent Using empty interfaces as markers to distinguish special treated objects. ![alt text](./etc/MarkerDiagram.png "Marker Interface") ## Applicability Use the Marker Interface pattern when * you want to identify the special objects from normal objects (to treat them differently) * you want to mark that some object is available for certain sort of operations ## Real world examples * [javase.8.docs.api.java.io.Serializable](https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html) * [javase.8.docs.api.java.lang.Cloneable](https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneable.html) ## Credits * [Effective Java 2nd Edition by Joshua Bloch](https://www.amazon.com/Effective-Java-2nd-Joshua-Bloch/dp/0321356683) java-design-patterns-1.16.0/marker/etc/000077500000000000000000000000001312550536300176645ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/etc/MarkerDiagram.png000066400000000000000000000144751312550536300231130ustar00rootroot00000000000000PNG  IHDR{nIDATxo}W^EҺ&~r mU%8- FO.%fMMG+| 1>;;lQ6Nc#J )ZhPwl333<33|?zt}g>yZ :@'Nß$P]K'jH^rtIЩ@']tI*t%A N5dml Йmm`NFmVN?4רt(dXA݅5qʴk9nMԍ8>4"z]vޮi4Fjf-}BFsS)H'jߡvub݈Z S͕nT/p蝢bSҎ {Z C:%h^kLT%|w#^]htkI:dTX+Qhc!ByN_NɱeLGP\,̀:#$x?z E3{ ~Y es*B;eSitd|N:钠SN$T. :UKN:钠SB7_}~bbo:N˔}C':=dݧg$ZWġHbș[C#ˋOIL9;T']]M@ʣRw Mmů{m 7XΙ ޫFN@Ntw4Rz;+zPot t~*pF X͆7=f7C|nߦ?ЄHTT'y m[tKq^~kJTN~qe6Z l3]o;8@G *Jn[c6=qUSrV\|Kʿ᪣;6?#

)|P3kcЩ(ꛟv7XG)9+.>6-;:ݸXw'D驒Z-2UO@'.NfR':.y'Ί'~I˔Ci疅'{^RuW o99@CN}۶/p~W_~rn ͉cpɛ~ :NGMOOv-Y8K;'83{B'P?*~Sw|'".SPS7fљWw[}3Kʈ:!AjtIЩ@']tI*t%A tIЩhS_k.zVrFߵּrFRΤj"tԙln-)ܚ&d!N)*z'PkycHl4*kNv3tǍs v;#1˿냷"w>vVg1q;y\wzN^șRs}·@WtT)5:U\Ut ta8,4S,kyyY^t2 [$Щ\_@C*dft2tM bff}T@'ݼNH:GnN@'iZ i@'sYZZڸq#ΡK:M^ǩs@'@w꽨 4ҀNgttwϩS,R%: P˻N@@^Ǎ/StLMMٳG^ bYYYNH:5X]]>jiiIw: eyy>\t XXXPtnJ^舯j 9To ?%n_'jHIS %B@'蔞 6\rgFnld֦@j@l өմFLZ^j5[nmUمNЩd:kM( INsZMrNv~X Ҙce6jwNl^{@+$ќi iuNUNs$9|-UW.HA;ޙkw9I>B4:id)O{@noToLz m~x sf6 $;5Nv)חLlQ>z'ZcZN5#:qF >~Xo7F,..Bz0c'pENCjYW&Zp3Y͑_F.dRNj1(rN2tJVc\4$6 :UfMAQo-m{k6=)GyȪMNtahSݹI|RJRD|iU'Wmﱥw.{'@{C bcMl(Љ**w{L8/ӉIꣂh_>$P\y{p1tR{Xtc;}ҏ:S;x{*b7~S)_ˋ^+6 $K4` 4 @r]ƽrv폿ѻWN3xVJAe"u&g#w*&avrx9FP'ữ=gN?{KJp_g6_6}MCur:%{uтN$ XBpx=čeM`65(N;g~Wܷ1JOɭo_5u)\qn&7DTM%5B7аqi<҉~f.?0y':W0yeO5o2WtJb:@f$`_m|ĚSd҉`:v~=|?>Ng:IYzA炷Pp}w1TJ'J/>x]W^ykc߼{=}׎6$8 !uIDbuoXCO'Ǩ/rxuGv_ZKeJ)]% XxLM{!tzYc'=|}[͒]_٤ X!q'<"2٫pNYj tʫ6 ${){MANyզ@j@lS^i h6rtj75DjZ]B[yI:VIaS!Щ3L"TOrLw鞏TcM'%3k ^Ac#ص?&qkNv36gC7MAA>ͣ2\ʝUk٬Z[_"پtͩ{ȂHagw5[N4":qI{C~ H\'ֹ6o$~ǵv5uC8O \ 5[KN\[oD;Yfp]EH1.rɮڿ@4$ʸ+r?_ $/Px#_ RcxWq씎H1.rS$>)ecf1!yD.2tJp(NON\)@' :EĨ:LIWON2k@l: ]TɡzSьu;TfMAPÇ' :eͦ)44NӁS:^צ@j@TtM-sbkӟNwř{Uѧ6 :ei;"-(<Ԧ@'9:qU#iR:UFvǦpS;&wj7wś^RȜɵi N/}N ݘ^&VH4G,&?',孅֦@:}_{sχ_{襰R:5;xw6Rnٳ9l~P4^Af0'N&_>2}2<Mj]/B>/oN}*gv)t{FyM0'N{=2?x#ČӉK1*AY3zv?Jxo;hxmC0'N=xM~{tZ'+xTj25) ,rqoZ<Üd:\7xiNOuʌD'=ғ!uN!7#y|c+w9񩈿n-/S@/)t*"tf/*5`O3JNSB'KF&t* g#mN1@T2{E'kBAqd 1Γi{,#z*0GoʖS)*&]O# ^o)*́Nyզ@j@l|-VtMNt"J4$S'J45MAP#A'F\$+qJ̸j@Ԥ\sP锨:G: 4:"8Q8 -+E8*o;F !huRHmܠ&9B:9Gw9̵;[ܕ-Ä rBnP3HIBd:~O=g|whatmWܥ=ޛj0䨙r%SP\/E:}Ü\uM2^|O}~\,T9P/ ]`*TYaa%[+I-ά9g$$Gع+Q$!S\/lU {߬&ͩ??}MuCQ O VNE%KP#\&q-2I?C)vYƩ]%8Nl&NEMBA#"~aNx~FcJS?q:UQQitK5+6 NR SNi h6uXi Yt {mqa_)1ɟG"s t 9q N&a,f)1^N_`șN`-҉/6t:ICl=s⃽AwɚCl\ep*{"i8:Vq'y0J(g7ͬOS & :i1W"/5<;wҀN Ho ~ 0 4]=V$IENDB`java-design-patterns-1.16.0/marker/etc/MarkerDiagram.ucls000066400000000000000000000052251312550536300232660ustar00rootroot00000000000000 java-design-patterns-1.16.0/marker/etc/marker.urm.puml000066400000000000000000000000211312550536300226370ustar00rootroot00000000000000@startuml @endumljava-design-patterns-1.16.0/marker/pom.xml000066400000000000000000000034141312550536300204300ustar00rootroot00000000000000 java-design-patterns com.iluwatar 1.16.0 4.0.0 marker junit junit test java-design-patterns-1.16.0/marker/src/000077500000000000000000000000001312550536300177005ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/src/main/000077500000000000000000000000001312550536300206245ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/src/main/java/000077500000000000000000000000001312550536300215455ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/src/main/java/App.java000066400000000000000000000053211312550536300231310ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Created by Alexis on 28-Apr-17. * With Marker interface idea is to make empty interface and extend it. * Basically it is just to identify the special objects from normal objects. * Like in case of serialization , objects that need to be serialized must implement serializable interface * (it is empty interface) and down the line writeObject() method must be checking * if it is a instance of serializable or not. *

* Marker interface vs annotation * Marker interfaces and marker annotations both have their uses, * neither of them is obsolete or always better then the other one. * If you want to define a type that does not have any new methods associated with it, * a marker interface is the way to go. * If you want to mark program elements other than classes and interfaces, * to allow for the possibility of adding more information to the marker in the future, * or to fit the marker into a framework that already makes heavy use of annotation types, * then a marker annotation is the correct choice */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { final Logger logger = LoggerFactory.getLogger(App.class); Guard guard = new Guard(); Thief thief = new Thief(); if (guard instanceof Permission) { guard.enter(); } else { logger.info("You have no permission to enter, please leave this area"); } if (thief instanceof Permission) { thief.steal(); } else { thief.doNothing(); } } } java-design-patterns-1.16.0/marker/src/main/java/Guard.java000066400000000000000000000026231312550536300234550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Class defining Guard */ public class Guard implements Permission { private static final Logger LOGGER = LoggerFactory.getLogger(Guard.class); protected static void enter() { LOGGER.info("You can enter"); } } java-design-patterns-1.16.0/marker/src/main/java/Permission.java000066400000000000000000000023551312550536300245450ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /** * Interface without any methods * Marker interface is based on that assumption */ public interface Permission { } java-design-patterns-1.16.0/marker/src/main/java/Thief.java000066400000000000000000000027521312550536300234550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Class defining Thief */ public class Thief { private static final Logger LOGGER = LoggerFactory.getLogger(Thief.class); protected static void steal() { LOGGER.info("Steal valuable items"); } protected static void doNothing() { LOGGER.info("Pretend nothing happened and just leave"); } } java-design-patterns-1.16.0/marker/src/test/000077500000000000000000000000001312550536300206575ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/src/test/java/000077500000000000000000000000001312550536300216005ustar00rootroot00000000000000java-design-patterns-1.16.0/marker/src/test/java/AppTest.java000066400000000000000000000024211312550536300240220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.junit.Test; /** * Application test */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/marker/src/test/java/GuardTest.java000066400000000000000000000026311312550536300243470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.junit.Test; import static org.hamcrest.CoreMatchers.instanceOf; import static org.junit.Assert.assertThat; /** * Guard test */ public class GuardTest { @Test public void testGuard() { Guard guard = new Guard(); assertThat(guard, instanceOf(Permission.class)); } }java-design-patterns-1.16.0/marker/src/test/java/ThiefTest.java000066400000000000000000000025361312550536300243500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ import org.junit.Test; import static org.junit.Assert.assertFalse; /** * Thief test */ public class ThiefTest { @Test public void testThief() { Thief thief = new Thief(); assertFalse(thief instanceof Permission); } }java-design-patterns-1.16.0/mediator/000077500000000000000000000000001312550536300174345ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/README.md000066400000000000000000000035521312550536300207200ustar00rootroot00000000000000--- layout: pattern title: Mediator folder: mediator permalink: /patterns/mediator/ pumlid: FSV14SCm20J0Lk82BFxf1akCJKOW3JhizfDNVhkRUktP9AE_Bc2kDr7mKqx5bKSkYJeSuYXr66dFXy517xvvRxBqz7qo8E6BZDSFPDAKCO84zP-IOMMczIy0 categories: Behavioral tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Intent Define an object that encapsulates how a set of objects interact. Mediator promotes loose coupling by keeping objects from referring to each other explicitly, and it lets you vary their interaction independently. ![alt text](./etc/mediator_1.png "Mediator") ## Applicability Use the Mediator pattern when * a set of objects communicate in well-defined but complex ways. The resulting interdependencies are unstructured and difficult to understand * reusing an object is difficult because it refers to and communicates with many other objects * a behavior that's distributed between several classes should be customizable without a lot of subclassing ## Real world examples * All scheduleXXX() methods of [java.util.Timer](http://docs.oracle.com/javase/8/docs/api/java/util/Timer.html) * [java.util.concurrent.Executor#execute()](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/Executor.html#execute-java.lang.Runnable-) * submit() and invokeXXX() methods of [java.util.concurrent.ExecutorService](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html) * scheduleXXX() methods of [java.util.concurrent.ScheduledExecutorService](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ScheduledExecutorService.html) * [java.lang.reflect.Method#invoke()](http://docs.oracle.com/javase/8/docs/api/java/lang/reflect/Method.html#invoke-java.lang.Object-java.lang.Object...-) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/mediator/etc/000077500000000000000000000000001312550536300202075ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/etc/mediator.png000066400000000000000000001101241312550536300225200ustar00rootroot00000000000000PNG  IHDRKF<IDATx{$W}Ya a{;o!h E@=!%cXnZbeYzi%Z3T3DpB- A11H-YF= ;߈C7{ico4G_q *;A5  N;Yn[MÔȾϵw˰0/ȍ`zOjwr̴ee( ES80VFT2'ˡ}A*fὼɶZpV±+N,ʶjhtS#J^\'U6)%"J}D5gԍ;"ܙqPA2 paFҀg'(x2 W| Ohmv>hE۞/L^#/D_?j?\OhRc‹:vf\2bb(x5584I%6_ < I >3oR K^)RPo60dQc!_nY $ '“Ҁg'x>1F SnZ:=B(69^H`Fiԉ{F5aԲ$12J1HLAN*&\٠PA2` * xvRO4z R `pPi |Ic6(e0b JTM2IQZ?|ں\ 6b a * xvRO4z&Ni}[z{>;{f:{mӉgIпegTXdm`pPi>_z>7}cmzfdi=ϒi>vho7R |, 婂9<;$l{cW2̿ gK|3*)z&}kw>'Ͻ7ÛC0.OBepƯͭCm‡ R CϷX&a=Yw^wsIUA T줢O$s7l"׍ĉp<<;g^fL|w?KaU7L~0c;>~ Vus{dD+f庇^zCaF? ζ'K0,*8nAذ4 J%+zsai`i|*vֿs礊}ԏ Tpܫo?%F):ﶟ>ǼIu|ŐuAϵz s9:-;1c)1xvR'>p;|"c GN?HrCbl؅;"nOXPE0B֪1*XE^)"a( oq=-vkbcYXǾGo&71m8ˎY[{u=U@1Nn>3o\?בzٛ?{ojgr}(C.JsV>Eiz&һW;ߦe]~ڳd|5:{r_țBYME<v9uZ&_yV*?0=?}qK=a|Bdnol:p,%* ӠyMQފX*AN*ny玼6^8Wm8)ѕN`8x/1G]vz?>tƟtAs5+ʼnߞi A8x۶cWC؝Ky}"Z~ }y7f?Ћhnơpv OdQAT4{ecшʔu+/p:uVK"PA Hh9epPin>jj}dLtlϏS0tGޛl"J|헽o?={)?Oqk 4{L4cbs57G5nxuo0gpzq7ʞ9}tF7ڠLm>YG K-B8|࠼0! G g'|om"ΥFs70o2_T]ZO7q~|__~G~SWӧ7keR-q=8rx׹Q: iA7|QaCTYG ZZHZ K᠗g' }_w;'>{oҧbG̭96x\m?5LP8@%#K+ɘy5+7^#>pm7Z{zs"_Îo=߭" Hߜa ^B;<:MJ1Ȑ~ol:(#* +OQ8"i0AN*zāoWC>v>a1mK+gv~sPA2F[:\͝1L1<;azFd PA2EYXbN*&\]Z]"8 `> g'D lPZ`( 0 <;'dp=fZC)ɀI084I>$12J1HLAN*&\٠PA2` * xvRO4z R `pPi |Ic6zw|AFgYEZVPA20C * xvRQ'egp=fJ K C)?$3T줢O4ƑK\٤.l~ENg')tu!zܶ0' c6W({5w;UtEuğZ{s ~MnuA C)Rm!0Ҁg'D>qq\٤`Bd^NQbY^wۛ'c"zl5={',Ng#$o0:}_ɍN HEA`i`AN*DIIp=f*Y˫})|lQrw3V0(8eST-F&O.H[vU( J}l * xvR'"N 8 l*a!,NϺplʊlF %XrCo-|nP8@5*л 584I%Akc6las@dXN&D:Vɍ,.B C A<; q\OIYH7%;4bdF3I{@c\׌F2!HpJ؆@AN*DIIp=f:=8 DF`Zx+x1O7j_ܹx(ptCpRT*}}l * xvRI'i'&PA2TpPg'> Jk $&Ҁg'D lPZ`( 0 <;'dp=fZC)ɀI084I>$12J1HLAN*&\٠PA2` * xvRO4zfbg*tWV@!m*3Rg'L&l*`J` x HT* b#Ai-d?$Th Jk $&Ҁg'D lPZ`( 0 <;|bGoněh:z{# G0- lϾ ;HF UfN*'m>7܏HxV_` "2J1Hj@P8wTpUM 4b JT gd/5gx2OwR?8 /l-0 lPA2` * xvR *^j֞ ;8Y+\2HU \Oy'e_;_<߿sbJ1Hj@` * xvRj^F#9SXhX$m8+-Guwѳ9#,M*#(ca`S+DVO^MR $JT"|=52( 'M*+O[ C)л$Ew,Ҁg'x kL0yCIp. gݠZLBv %n)MtsW͟~ ?wp(#7]; SP"J^684I%'yk)c! ài{ɠ  hJDi=O\x⹗ɝ90f<s-oUkU i?<-@X5ߚ]y<gD N>.V4Hq1M=;y%L,4h^u@KbETG`Q NJɆIbS<:`i]7'Y8()a_]xbџsDiunyG&0_''tI^khcۖp+AuXW]ʟZ?vT$A}awa&&b׀8Qqә׳}x\`<;pL# Y'8\j!N;[pObΥ Ic6awOpԋ;E@i! FI@S:@dQmO F < W!BT h9#sqD{ 0Y{]t2R26g2IDMɯt26/#sw#x⹰Or;PA2p` * xvR> vmП#}o#8v}B_g݉̄ zF/G޲RXΞ+6e=-UAR`A:rmLGJk^JT"|/1 下dQ8t]ps-okyzCR " Tx|>( 7$ՀxJ/Cd~': #s#u5/AN*p.흁 aG\D߳q8P8@kJѧ￶?i0]8k,u3K)w :ʉBہ==HW"^4JGExtEJ@N:_FV踩r>RV xvRTwnH]uR~С>CQ lJ+|O wD:!؆)7L#ǿZ"ÍB2')|>( 7CQȩUoU>ނXW#3v[.ŧ6>8LJ MXiko||-?i0E=-c_KxGEsCrcnƬnd`aaYOR|PAnMX.5@JWXH mu=a|ZsR*w#U5/pPg'( lJw_~Ϟ8m BNapOg &Y&\:]eІt"] ^`=*x_4lt #.p)S08L Ic6[zN|j61߬®\8UJQ_c C\o;HU"]$ݰN2+p3|ܦ>RU xvR1z&z^6Wmc.^߻s`[h_9[Y﬈Qsl%'8:f&]usxR r#U ^`{nXW&p:X '0&TL}*cMҚv2-UwgePA2׀_{U:ǨkaDͥ&aO}*=o" +]z60IptHPk4ݍ^Yo C)PR_)A=+1u5/AN*ACچ}doc6#]W6e8GTH5b E=2$U:c9UUE k^JT"p1z}J`( JX_q͋cpPiJ^jV5Ǫ']&}D3x7q>lp`( 0 <;Cd/5{;qeo`Aj)#{FmU \Oy@SC)ɀI084Ie8w>"}W8&8Qզb./f8 D0e0b JT ?zyZ#}u}5&| ΰ]s$(s\6>;~g9c6``( 0 <;DDR5G/ KxPT\3rn\bv^o6qڑ0:8?Yέē;o'$Ck3Ҁg'8q3Ϝ`?ƫazk[ S5» p9e6Q2fw묧jYfWB%_xXhڐ[ I%'9LП㕊FR s~B B喡pDG0mekFf*f8߀#s^!YZAy9%V8v=xpo<3chQ?xvRj^}a`S*i xAЋzK׿s/ STZu:s|E]<֪ s-oA#-WG/'q,-axa׏.=!9׀T8"×AIL I>d[ F줒ևb ?0&٢}!:7'Y8(a_]xbџ{+n _Z'1l%g_?q?h3 ;Հ*;!̥ҁx3LjJ@0MXi}]/<⩡Nџ3XNŷ T 4o4Ͽ5Jy\6a@j@DbA.9᜴͹=>ym n'uѥb8ίhN^Q<;dp`\لK^ݲ_vzPS0?/'p#2ør"/MȒt5 9S(ȅ; pLHtU) =^kؐ2V T ITշqP <;@dp=fVZsן~ik^ڸ|uvzx^q񻑝@k1.v6[[&\:=U@ETvXjP-_~$VRa]0Rh`tN*P8&\DwtnV_8}%ڠ?Ljz>plwpЃ~  T1 /ds, !U c6ហ+[3|Ee6BdY8@WD.I $1z{\I!:@8zUhC!9~%yAad8!j@cqN2ƜDu,18;z}k|U0Zg'( lҕky,G_Ge<PA2׀+;!7܏HxV]a^1 gXg_"GC)ɀ,z w U0g'c~)4ASC)ɀ-zmwR*J^jV5pzKN=esTe YzJ "2J1HLAN*AK3bFV1s̡/͠k!~^ψ=hodr1U \Oy@SC)ɀI084Ie8w>"}W*s8虱$t2ǰk(7``( 0 <;R F[5V/5$QZW,OwRk{A㌣ ]|e\Fg0[o2G#``( ?#@P6S T*1ncц%rG԰`= f &}#], _7aac†oSRmFFQZs5]9oHfR @g}}}ooOu*@sJD4q3Ϝ`9FY׻"Xj8a1VN/T8q:mCld6B!lmYO~ZC1\US TM*1ӝ/1 9FS |;L*xJ]X$@pB]F-;$y_ `[sEQ8O?333;;6TժThRI%L^u){BN뚾q8}@zg秧j~z.z8Jw_~Ϟ8m BNa|;I6 ׹ۆ㰷GrAy~kkKu*HB4@dP8b;{ggqv"J;:\M/>mПcf 78>c*8':q8B$$}1 ()ëN]DM*P8&Nܜ }ʇѥ ٢iCtǬY׏j %sD\}lllTfIήNhck85hR1ɠp pXA^DRRZȴ)[WWW0 0E/K B4b7цuQƕ.=FFޏ`ZNkkb٤շSQ}D /V-A)&m&!bV3G]!T p?"m=[}4 @[^j#oʁITiٵ(%.{{{$kc ?Iҽ@0gggQ@&c~)q,hP8EbPDY ?:#gOi,e)TS\EZ DJ^jV5kG8R (^4F'~Иb:F@;;;,p6:9@2)LBShXo`h`ѤT8Ԭ=C5.j\7z^DPuX3>悳8UylrbqqZ ;Q0nIސ ˜ Dms&,eX$ iR8S16777UB4GZdx*`K-t>~,d/qb2Ίs.PA%mC&}fooqN^,):U}ŴlK16դ搼:@GI%p~xìmПgUzٷzY'chp>NV?GXT͠p4u%hgy^G;FEcrrY`aa P ?I%"f5&r?# /:1¬G㍐B,c"qkAV=SDwzIi1 P2Vթi(D!TpL2QIX]]U2>;sU޴O-8h4n?8w)G-C}; EW #))t(l)fԦ@5ZT;RcfVk6Jj.^Mؠ8^sGwppg[՚3ܐwSSJLB䰱aX.P 8cIF1==p=VNp=—MMR&!I@PN3ONW.] E/n<ō`A-62gِn6%*!Sx&=#6RYIސȑ6(!$&''UѹLb&XZɨ낕V\+r[&,%ZΥx}}}jjjaaA ØI{Du܍`1,t vBa(e0K1s6&!YAy2!r@ G2LY_/9\Ӯw52 +rmF`qqVN)2CM`kkkS_Pnb&LKby@4~p`*;;;l B#j 'q@qf ,s\ ' i_قZ_^^^Y3133xlnnӟ 6TKӭSB4T"w~5oO}wtu 3h1h}\n]+:ŝs[5э N"H4Z|%6ގ˿[]_שNE(Wթ"c׫*Ur)ПFa|wG333SM*#=vFN?F܆{Xq㥎V65 w/|JP8X^^luuUuB\vvvHq!& UhH}QڮJ aYiҰ'T 0z%h4 927x;ő:q8mn@F$u\MLpSOzugۭyzӻyߧtHc^WNmzh^zCDiq`P6Vda0S I%f鳩O|3a|"m5ZG/57;;;33 zV[[[}2l⣗^zYiAsggtNc1Pk45W@-fOܑŁ8 DJq8c+3eI"6@/T6E;)%$P5%5NfIs5$b鑪NElmmQjQ)fggUBsT(!TOo9v:n##GaVd'``_ 5V{N۱KlĐt'%L$U >@J_rI%±w^&p̥6Lp KmnQ@3(0&-b3).z):HLOO;/i MU8N?6>6 R77%fuutV @-7!T)"X̠pPP@54h>(0cyr_0)v.9'LJL&ll6K8&%2A&R(o`9U2R AV GtV8FI<ԿȾTe9b|>99YT5 DJ)=&4n2(M oB Əuэ`YйOu[9H- "!TJpJbP8}{EN'Ijhp(LNNWD2pbH&dEZտM5'(cFrM*P8&YAݦgg(Nm}`gHiߧQ` ElC{V58Y[[+/3cYi $l[!8i<(&VK>m4Z-,,h"t-TEEXO E9TC=A)o( g{{u/V?5T-4133C2&=AB)IGB>|}`|+rzzzbb>X}LMx ф멩)&m@% t@kHWZS%f%Q8ly(k\i9t|kEƤpHɐ0 UַUzUW[XXwg0^ׁT6MթQzO gqnMMAUzkkک$;,(P RmsS| VdDcx o719+' H$08=뇁f/гZu\WQw:^+y~dc/YדּZ6g\_PyLgȍs[o 3&z%7333BթH]766UB {{{#(\E'lҲX: C4 p뱻0WpJ뻃)u'i :NNظ"!s80mq?>T5zeBJ&>p#S^G 7zā)ʛ~B&D=gw6 J>It%+fh2R8G U8 NxOUQ80l (׌c ^Spƀ$ h ="1 ŕgXONN7}kĄTd@iIFq J20"&1-DӜm8{DD+ig;EsqӦşK- 5督l.g̹Ԃ 'd.G.>f!wR\jsΩ]h”jj@jcic>vvv(V,!lFZ&1{ŝJlЇ‘LZ#"]5 bhm3 Eorvt]tqa1.4ƴG)jVPpr7q\ "z5Mc,--a c~IX__/&aL;pN*@BB#v5@+y6pIl]n|Au2VGhe2lL#d$qhft)D3(X,+a3 Un:-YBѳIU-@nPgg)0'P !1@dP8bAmvvְPF2o(jʅ/ΚQM.K\Лq!I@d+ru ^xLV05/b6R9,--4n*[677L$i(ƣuf?S@ %Z:-C_&󾗩}KL`bۀ&I`^O~PE_J‘Jm8YE6jn 䍑<6ǀCqxG&!0)6y~թ@#t  $MᰡFJeI)z}5թȋ  TGIA‚1KɁ4ISq zhcpH4Mױ6X$J sB%;e!&!ƋU BUz F$poY׎?;o*aAD,//WUMA†䍩㕍_!FBl>VIb20l`i@i!Zypf6?x6G)W8l&hG-o%l}Lթ듓4f:/! c@>#qw3 "znv%(b~#(3Gc(cBu**%1|y355m*P8RF*Cq\o ~sY;unJNw,;)#/¡8 ۰Aȸ$IP!5;f =+ihB&l+[^@H%^j՚1VZz-^cXڃ]&tV0 -.QNt_$=|PT rboobMLB0.<:‘J3 >NZ p 8$uFR8؛ԏjpehO Е-niP"{\k`s綎ZzG!)!ϻPՒLKq E'S! Iy`pp~/>1ٓ}ѹoNx߳q8Zj>D$"ÁBH.p666b,}YZ^P PlZ2씭"'( j5 K><31Jcyy<#KT;B ;[;ɘ#bϥпzy{|%Bo39_ל":̥]({l LNN0>+GC&I3LG90P8Ri@78{%Jáb9w.gNžT[L`TrNBPZ1I@HX Ryi %kNI|^+a~jFv]ž$oJ۟ls 8y(C-[SmIȑL$o)M G*ES896+rVvC6S(6TiSW)oOMMN2<BiW6E4%lT̀‘J,(VXE (ħ@؋0XTla4 k(VS@‘ I6Y^^.mqʛ)ïh0ǡlJR)# i\XXWT Q c P8R1+64L}Ɓ Ee{Cq|j4S(AyYĆ#(,١^w/i<7ex}PTT3!o`Z$Ze3 (@d ǙԤk2('Wry B+tCK;Gd r G* paM'&$oS:zɛn[]JK>h+9P8RV8m}+yLQ{nKIZcx ! ]Wǹ,ú}j5t;a,//Q -ЊDTz!SаX_beooorrRu*(P8RP8o};_F̋יT+|O w<$ yi{`،HOh tnfK8n|CNpffծnWu҈|x+3D ʼnfii yF&SSSNB@ppsן~gNym\:O;lÉubw mpDp'DQ ' gcl"f.!B@kE8==:MBn\U7ZA&ѹoZ}ɧh 3bΈnWEQjF6gk?"wTiD+j>M3xP8z}ccCuB僡8#AȕVhWn,\hI%z[/f 1^sМ=õ/E| x8s1ZtP\j?]}BpXNhvvgg/קr* ț`8`(θ,..%G$z=If>S2h tZ}N,!yCYѐS @,Сh6avTEt!ZptnSSSD tθMPhL V"qz!ObQM"/}[_Ͻt6π;||{-5D;X4s55 +`s[<.zqL('%YRټ&LP8 7ۛBL C=26:NB@ONN*J!V)Omwቭl;G΀pFҟ3Tx"VN-#{{ZK`([JF)3kK0t7:ǥ̨NE@WzP9l91i|*fhpsן~gNym\:O;C 'к⊁DBr*@p$\{lo^|gg񲿿Oa:h4ݮT I[Y4zN6lL4@LLrՃ7pSKAoXCkH>GJJDql磃‰ɛM )c C#%h4|0|!hۨ, h=[eEӆs zv $]`6gI\jrRⷵ;I۴7mT8;;;~E b2起:E"36B۝"h{45WSbaT?VTl8ٙ=%-%&)7333a VNEQPiݮV\7/ h` Q染zk%Y& f&aCDc"yA  __kT0$D+ S8`_a3`NI 8”7WY[S1C@ޤ҃8#gQ888_6 AFLBQ8mle3A?* (61"4{I&@%fRXPgC;!Sh4P9X>D+P8mg^_U+ַ &%KSQx»̐qvjbh '|~FybW8EITFL<9Ahl),-O?ъT)Я:C%dmmh@ޤ^RBqbby2[y˓4Ͱ sЁSC7!P8@wPh 6EnV`H A'=err2Zؓ@%?C4 bmm iVUdRT C MщTyQ TZ r腜- 3gV sPURVZgy}}N!QF9 5A^Vg< 988ق8@Շd?(,jY[[Z:4޾FcfffkkKuŹނ$oG%[0@`(N쐆wՄ4*(~:3P8@ 1᯳,G!o2^ollNi`(NP7RKFI/..=[I ϜLCq@Բ(M*5@ T0M[pJ:\sMd_WNUU tTE䚠]eB?$=jp#&o>0@j5[ mԔdIf+E P6p@llly =i<\r %+;Z?xwï}?.{n@ြ^@xސEW$8!w]UEr387e.NKQ~{19 .guS# 48f9V9`0GFJ%$7}5*ȧ#@eR:gjcS?'[c!uPAn@ဌvSSS_UZlթ( 7?y+p&Feɉ a 98=pR8ӿ9W94<2Zҙ.w2H'~뷦?tD}-gu(!P8 3HF r NSii< zAnwˉ#c`w.\m1"W=b"#p86*g66jxK2s2/K<%5{zޟTwVWWU@ o6z_&KKKSQ5998jp\KbzYv84FO+ zEBqsrX_wpWS51EȘ GtkB˂SRp@ZPu!zYb}Pg:%*SQ^Ƚj5$ӡ,`?ָ gRh'U 'QZuii꒟cW?Xߤ g}}S+HNף‚/0??=) E UU)a6g Co¢Q9L3̀}C|it5JW+pʠpV@$5}2988^e+Ԁ9@JY]9nWL*q4# ]6?j%* xC qnzd9~Om~qZ_4Hpxێ 0/6%|h&>9z]_aVscNuQ\j!qyAeO4̫wzߩo3?qgUI~΢TP8` SWUxD } 5|(OLL Cqtr>NJHp]Y{:lW7Q1/c_4CCü)JK6RZfff0O 0GN,5zuVUթ2n`7['p/iIҩNQC#h =DM(x'``(&[3Ub٢ht]ilmG߅" tX *&811l6777N(%ࡃ(VWWɣm ))7jT ч [3= #0omx+I6F#8\ G x@ NKIw HKG!hCP hݠ&zP'SP8JC~HP`Gi`~?BI 3P hO`(LΘǵVEAЁvM> ja `vJp:ǧl1n}_k$rS>Q:F8~%@gjBc<(oP!_OapֆC(唡PH]TDțUO-FlsӠgR*ON ; !+ڜp^jb&h}X[[t҇ "5%mBVr4o7xaKGoƃQzynjj0Bj0ֿLyzh EjZ"ӷᬮZҤɆIZukTw<2j4W KKK7ZC!9}x0Ӑ:.L $IxKQ[e Qz"l6b&h}@ Z8ZEoزrev&$ W z G x%Uft !of:8A+r_|ּS<1v&! dP8JC/lb1)ס!!Qn:/\:-BEczz G C^__!ߕH:UH2 d+3̌o ]SH̋0VI-zz[ `3@bt0d2,WCm|xgZdݟt0~Jn%7dX 3۠pguu2O 2@ !6(}-ak5M6_'O 2@ !6(}m,Cf~~Y> PrCj`0M{^eMJ7Dpppnj `ey   9^ײVʞfU wFV[\\v=`d,ddd2g9#jkU9U|R[3XzCS8Jco]׷~nDO,۟odggnA7 2222@>(cd>-#,!ڦ:<Ί8!_bPu-Hv|akč;D w@n?osppx&2@@YҌbmt:؁:ߧю_Yϵܾ› .(T ,jZMi, 30׬6IhS̃$c"eԍ;C'mT&A? 3!cxG+jszX/R~t,#2RH5ee$3Y4epF6*mNށc<;cބ m BI~bkkkzzh :/ s 2222@6IZg o*́kHg,v͸YQa?Zx*o6%H\j1(/ /? xfVe2t ddddL)ދ0 TTrMY ,jhMi,Novuc%]!{Ϩ&|G;YAF'婩xdG@@(s2c> x ]A#dJEMˢ)-,z2 %Iam*0)D1 . uu"|>t| 8B3A>dɿ;2222@F@1:|(Y9k ,jNMi)QNH@UdQp9~DŽ]\[EO# 222222)c _z\QwG]47dтXEH@C(!ܐ`2l}Jn%7d2,WCmP8O  PrCj`0 G_)!ܐJn\  fAk>%7d2@ !6(} ާ PrC(!r5d0ܐJn%7dX 3tQ8/kC}gvUgmڣH@+O P /?_xzy_rbc)?T8 r,@13pdf nzW?}0mC^Ȼ>Q7{}4{tb6v쟞??=+v'so!S5nO m΃Q볒>˰~Vk9D (=~}[Q%P p# ݛِd11N03ufd.g$cuHMv{q{\K/g۸z8<f O)fawdo3)ik|V\zpW,8;;IFwO]u/=o/`k0]_2꽸A ъ2}#_ߑ1ֆ6\RHpכrB G Cx%  IE:2@lq+U|OG^ꯌUK7ǵD NX14Qa2겜IL[8om8߾6_g=KZw/7F?̐ouYΤ iͷZG]vz?>t? *CY/NxW_;LD8‘C)lt竦)y*AGC#([tpXg7~yGG].t m#t]q&,hoix \/7ߺ1 GО<‘L`ښ9|U8/ku_9 ?x}1YX'%8gR&o',i~^jfš^?T{'-8-[{"o H1ȓl1"N߾vuY̛O{_OfltCr.kLA81Nx/5YΤ iͷZCvξ+;G8򻟺>թc4`̾:uU~_=}MmtuـxV,@Oo_{GZ_:"8%`; grK G>7$n1O&ùUG퓸 q@q]`N2%? giI q6NI q6NI q6NI q6NI q6NI qNj6qW󇋻7=tǢ} YG`F5c ճDC4;kIk;f8g5Ɯ8ݮ itķV :Sm7[g|fbZ[sޜa0{ ;&Ƴ`f ؑyW2%0U0v9kJ֏ KXMoc-viGlf=awKznzxq+I&d^,`G>縄d8v8S>ft`A>+̓u Gqp=hE*7fl< `f&`zi\ǻ[Sf"u9MCYvL-޻ol%4mŦubzdk ^*`G>縄ևSIYo'eD{bIR@5L_/# s\;܇Sz˘š4(G(Vh\ы4xh-c?@5L_/# s\xpin}oo-)z{je 킯}NwL(e Y`f ؑ9.߇;Ƴ @ xRd8'q@ xRd8'q@ xRd8'q@ xRd8'q@ xRd8'q@ xRrs +4(Q@( Ф0T +mHOjq{(`M퓸 q@< m2pM퓸 q@< m2pM퓸 q@< m9&] $.@ PIz 7I `8n}7$nH'5M}7$nH'5}|s'߾G0>,x0p~'&f?/8Q@pܞ 9}b>m0ηOޜ^SƳ@=Gۓfafz vJn-N5\|Y]ޞB_h,$UX0T?vT!j \Ze)`!qc]#NDZ8G FY4'G -fFX^D2@@d{#Y+9OY5j ` Wn_L"DWEW2BPɹ|b40\>.x!- ֏?}Ogm/oI)c3nZNݬ3&<{~%/ Ҟtolu!j k рp[(#[H `;yw=|Mdh[ Zt){S. <2Feyf3_f]̭~~b=JOwU^SbTk51_~W_tk[oNf]=* +3`* XFi#Mcw7]Vj.BԴp͖W[8u$0 T#W4-M"6zL -iUmuפuԞ_pnկn|gfb(旬F>rkp`7#a  }:`ˌ@*fIu\R'ٺt)?6yzCl,Z3XW άft1&{A&'/[yVP6BQ¾_W_tw>f33i;T~_ ~`ks$_2Hٖ@P\`iݐsbYr Pb! 8O=Js5)iA/W27k~:'ĕ׳VP1fNb9]Y 5}8I3_xVbߩC~9Ύ8zԦq^0Iч,Ǯ=;"&P;Ra&ӇӹN9.d9{3^u%BSy DhpNt?dg/vv_v@pC݇S`U.N-^tC\7rN'b}N!Cة/d]}a;㏊eB'5]`ϴΛGǺ_7)\Z J,+!P[5W2e(*g%ᆥ}!.cV,5+R/9x0j{fސ~U[,I|b,Bpdhjf*I =aL!g(߄pp qbҌX`ո4nnC3X?҂p5{8~'6 ja4|ׇF=fuEfOe?(Pť;;6 J ͸/l]& ͊>H ʾ"}7$nH'5M}7$nH'5M}7$nH'5M}7$nH'5M}7$nH'5=W#>ػyN&<ɑ,mM]ۜk*o.?ʬx1UHa'p:nH''oH'C`2lP/*jc Վ ݿF\^>Q2v{Hsϟҧ׳AbhQO*riO9@`;xXفqc}ahh*s)YouxH*pck_s߾xl"hJۿ3;\'s|7%zs: @w7+єNZE?{2a>2UoU VŻ欔`쌎5Ė JpZUce;7e8X:5 HP,iV+#ۺ8SjfZBE_Z_ݫ>Սc6S[̊]brO*U 6+lRP O7݂k] EtLb` Ԁ PzP\yGW#Nk? Tcd~΋_}эV7t!_ º&L% Vbm=x5+l՚D춤Mz^\:+wl1N7B-.jQvS5_ pq֪䣋ae8o|tzON+g3֥%<ȉcIxƳ(ZgcN"tt]u{\X,uP W"cf /W?{w/>&̭A^OoO: ЧfL(3([Bǖ+eFPRe͏M;p=^sxE^JNFc` n 1kԊp\R60q2j@22O{2>afJ>lǧX ܠm5nGᨽiIDv w?Hpy~٣X h:m}Ecu: w˛|m{rdl< `28:)]|n_.` cp$NN q@< m2pM퓸 q@< m2pM퓸 q@< m9ùt[Yy @5#+ x5_C \cd8%XG!RW[7\yxO~4z67}>׈5e#tp򙗷"9Bp XB.Ǔ^޾o>xzeGseY6܇3zBtt_#céXg>܇R!Pr?-O&1f'3~}i͒ճԊi,5)ñWz8 `!J]|O>e #XG!R,aѻ4D-vt!P)Ùz@b&AB5W} #XG!RN &ABEpP:uB(u] Ů,s' B!B!B( B!|gIENDB`java-design-patterns-1.16.0/mediator/etc/mediator.ucls000066400000000000000000000177601312550536300227160ustar00rootroot00000000000000 java-design-patterns-1.16.0/mediator/etc/mediator.urm.puml000066400000000000000000000030341312550536300235140ustar00rootroot00000000000000@startuml package com.iluwatar.mediator { enum Action { + ENEMY {static} + GOLD {static} + HUNT {static} + NONE {static} + TALE {static} - description : String - title : String + getDescription() : String + toString() : String + valueOf(name : String) : Action {static} + values() : Action[] {static} } class App { + App() + main(args : String[]) {static} } class Hobbit { + Hobbit() + toString() : String } class Hunter { + Hunter() + toString() : String } interface Party { + act(PartyMember, Action) {abstract} + addMember(PartyMember) {abstract} } class PartyImpl { - members : List + PartyImpl() + act(actor : PartyMember, action : Action) + addMember(member : PartyMember) } interface PartyMember { + act(Action) {abstract} + joinedParty(Party) {abstract} + partyAction(Action) {abstract} } abstract class PartyMemberBase { - LOGGER : Logger {static} # party : Party + PartyMemberBase() + act(action : Action) + joinedParty(party : Party) + partyAction(action : Action) + toString() : String {abstract} } class Rogue { + Rogue() + toString() : String } class Wizard { + Wizard() + toString() : String } } PartyImpl --> "-members" PartyMember PartyMemberBase --> "-party" Party Hobbit --|> PartyMemberBase Hunter --|> PartyMemberBase PartyImpl ..|> Party PartyMemberBase ..|> PartyMember Rogue --|> PartyMemberBase Wizard --|> PartyMemberBase @endumljava-design-patterns-1.16.0/mediator/etc/mediator_1.png000066400000000000000000001645171312550536300227570ustar00rootroot00000000000000PNG  IHDR.S-cIDATx\Q4((AX+ J,k56]1"DQTXQDbl(?l〻ۻz^g系3&2  B$LĮAAt!)FA!$ "EL  2#3? P!)fLFRLOa3&#)&Y'0TH ˗qW#FRLOa(^8 VpԆܶΙ3۳3lwJeN/ʯ,Z&y&qhA.ԥIBYoޜQ'ҥKݼY\ C3RfBRLOhmdR684\qAAkղiu^HXXڵYXhЉɵ#|YR<< K0ߘvG??c{X:^M={AYNNii78Z[[>Wٹ+,̙5_Rّ#3m!ad#axB#ӬQš)zOe n݊T'Ű rҥCr7Й]4g){jytd|cR h"sMM=r;wn&BYӧG--߿ĉ`krri!H277y3"CYnϞŠzUuL9Cf8|QE$5lOhbd584\{.YvbNNH8)s.ļzu~2x2Ȉ̌/]1I1g1֭.= ֤I]d}{odr)'G۳gaz5X/_!!g(!2rHjDa=G"C^LHs^=7>A:rdk֭uHf!yNN+ 1O0/_Vn8Ұ9;WجYg))ѐb,3&??`.B3D<ǾXbHjDR&3ʦ19GA;7/IM"wg=<+gY0rӦ۷A$$Kbىaaqם2?w`{Aݮo_;eb8Xt}!8?7&[~r.,ك fx,9!!$I $48a5- 33==G )&t0DG\/`"F9uFs:$dFZo_^=[2儏O+ C*Ul+W.ǖ-g*̬8\ҥ k@ J1~-dI7"3.~3a`'I $484-SӢlǏ;$S!;;qР.Ɩ.%#t0DGt\Zh A6ƚ(tOF..u8,Z4TܣL_ݻfaɘb:5)V]O 89ٻ:[wR,->{G9Cj؄1)f#l$xߴD>`8)& ZpE }KK۷*ǰ|t?L{&QX[hrdU3iIb*`rEP?C5lɢk)F#l$x/D>wq-Y0@EGJ p`38:so԰%Ƥ! -ĝ>;͐Aw[`h3f -mmm1fL/h/Hgqu0"SӨaK H1aC-Ě>]bɒfY*W. % A5*OSk:L"\dy5lR()F#l 9F"gp(6l\Z+W>: [|oɂ9eڵ2'' ;~ #t0DG ιT5lR()F#l 9F"gLMPf>ΏyגsN>E;1h78:sQÖ,}@I#lz NcÛ7g+IqAKp߁  w7jؒE3i 9 OkquІsm3oM`0bg`f@4h\A\ .H4X4_5lɢ,h 9 $4kquиsAoܳz.G a ^Aẚ{i5*Kh-5q}T .P>lΜ,g6Bb쫯 %Ѕsg+Fʝ;7C9XY#{xV( UС1ꆯ۶R<6QHiq=D˗@\#|طo1'ŎYpv_7J*Y5ӧG _‹D\7!~9Em*5l0$x۴Z 6qӢ3C]RS-+DG4~Wk׀vcED0b=ÔAXZWVm/ΜmJO ׽RL>I1kk .A뻾~Xrrlp0p!b˖FN AKIfRղe|e ԩYJ.`/|2WP& I11M"gM z܎>peogX򖹇:Nmt3x_FHeD `quЬs{N~ݶ"F\G1#vlwX1Ξ>= G'ۗ}b3):=&+ZȣGd<)dfL߉/Ŗ.$W9cR Zߺu#|e3YY+SƒȈC-,JV@a&3ĦuJrEM;u+VpNތypTf*I1fquЬs=WmOOO Uyۼy:%OB/Ŝ]y WNs4VHN!ܦM#vitc޽۱]v^p6((Wy 2$PP& ~I1ˑCʯ2~Pmɛ!Vv?__r|1Kd|)0GCA ::ڡ+WLRиsm[{qӇ^>߾ohO;q{Ļ:FE-l=S^6ٹ*bFa`ݻfh),/Ÿn܈K12ɧK1Cݺ0uSֿ-YH?.3")i܃o =͝c6f;F4iJƗbL SXZ#&M83̄{rJRІsAouq)C~h(0YRÇd\~a!%doUV0 W^l0>Z,h/]0^dnYqY?V-{|Ym`7՗bqтrQ:ysFE$͢/R,_r:D99^5@9A>;{g!< =[.b^g.n J1SØ|YjXl5rfu&)fhɹ~>aIҷ{g [ /^n6b)!9]uԫW'5F [f^^-0|A㩃!J1 KE-A|jYKa;G|7dL _bڞJ,TO cR ۳Pn6WoJ,TO 63343+V ')fsfk+TəӒQÖ,z!;.GiqXl 'T Q=nO{boqJԖ=]Լ[%5ʓ|7 VڞJS=6^ĺJV`)V͔)zd3 Թd )q9$$àL> W18Fr犌\4eJ3 :֮(רaKbٰa M̺uka"_Yf6MM%̌oUY$8`|YBJk~D רaK}b24l脪FE-GQ5NNq Q=nO{޴Ȍ$8oΕ4bOv_B ]=++a̘^zl W뎭ᇩzl0áC+.ΤK-7oΰy:4~JqvFF7~7vukРD$Ss^UtrT.xDa =b2MQ18FHiIqAߜ+4t_zfdp+nj_{5""Oo`oke@cs\f!Ő9Jia{.ԩ1O]o?5l~I›1z8nF"gMLL"\'/8th~Z_}U?@ML> E/n"(^gRҥw>o߾;~t(HǏytҼ_uaSބ_6ؤ1z8nF"gMLLuYq\ǎiҤLSɯ˔Nc1bf )w#|/a/t-[6IjҤ.,##ڎ B]l_ MbPrPװ blR̰L"GMK٤ɦڽ{w-={v }dK&P91E5J1sss~ڵ+ ;99aSppp&M@ծ];] Ŋ/# UEX0H1 _s.)DzBbF6F"gM+_FĵB:СCAёϞ={ʔ),\^=HYfA-U䑒zH pea7o ,g̘akkkmm=f՘9M"=I1#a#3/ibZ!?E8=;tѣ>R|,?@UA?dff><;;ȑ#j9M"=N_oA5>T.])PD9s渹JK9 m׮"Wǎ՗bEFM4kЩ6Q4-Qetպ [XX899&%% V&MW^VׯXvvvnݪUfggᑑfչiet*h4z 2͚'''ٳg믿o>o޼IOOW)\det*h4z 2͚DGȹɨaKJ1a#MǣނL&Qr.c2jؒE4FjGfM"gҥǏB< 7&hؾd1,LѣPoAh X7XҥǍd&t6"3F@(CROcvNMLfd>O<0a_sIa$4]ƌq _sIaKb";ܹs?%K/Xj޼ysw؁pDDD޽8#GpCٳ+WpW\A߽{7!!ѣG+[(+tNmӟ۷y9ܹs 8#211111ڿ?q5k,_|ѢE}ݤIƌ3|١CVZ5m/_~ڵkԨaggW|yW%ȟwia:?6't ݻVJIIWݻw_zC,pllĉ;&NO>mݺkV^~.\هO,XPla|~{xxݻ} :8q4%kߠ>|N#F w2E)͋/%O 2eTP[)M_~efܹ͐رc'OQdŊ~5D=QQQFqp/qt8F)\991 I1Bw$x2Ёw n޼˗!~gϜ9n#>>atohDxΝnvB:!"C?צM1.afܹȠ'OxaO:s8dnPYY /^0U I1BRLL3bNjԩyQ"Ӭa8[ Ü yBBpÆN<JZZì-*X1FLܶN/i#7ot<;;.q5lBbb9^VV֭[իWnP64f'O1=9++!%%:( y3LCNNv*z. ߵk~PFRP I11ͫ͘Plj'ii֌q jrlMy.Pzjg3 "˫Gdrӱ2K{<Ǝmccꈽ]\\-cZqzjTVq_A)k[g"6vj%…P\>pGSg->[|=}zÀ@͏ ^+c6kVZ YȒ<< K&kP&abbL+U.Y$ ƍʛL!d?yVe9_>O'O31+''ɓ'Ksu 40rk[ϭA_p(݋2߶mÇѾx b-2wÐ#;Tou<<<'Nw/[꧟AA)K1M[I.md +499Դh`CV|o""4oꌔk|Y --kӦVsg_hLbX^m7ow5$ذ ubbDO7L~a9ӧ7o 4?NMMի߿~9ׄzG{y' WDpRlq͚goEOKҥK֭@p&MꦧKXd˖ Xʠ|)bmm[`d!q5err ~͇ 'ŢWtИѣC>kNI9/bf_)5TbҁcÆa4,6g76m:wv}&kM&4K ьI RKӣ4"Ÿ9\B̷"+lڴ_~,k<7^ٷnW9ШE.e!DpR b¢ WcŔXffKS^ B＼ZbW֭L~ǧUZK%Y'O>JPf*Oepc嗵 A 6/NWb[r<7_h6Y "h@L"iw(&԰#XZ5I\&8ږ9R%|+2m9ŋ >|@s.V0T8Wo=t@U!]eFۗ}{,/)[~2i\]6u&-kҧO{R Q#gGaѢJ|:^A*uԤX1S6߿sv7p?;;tR^ y: ݻ撩 i؄f)e3FH9ɋc-MbR }L"&8޿Sp=yr;9Lu6̛]a77ߊLf@yf___NOO/QfW}wp9A@y+_B|<{?"''IywM#u NE&` w׿'k|uwׯa@ ,bh86F"WI^ZI1\Ѳ&ՍqQM0\1(w!8)ƟLàѣM4aW֪UKx+z垰hJ8 Cr˖ <8\>u[-5lBhel=88TR 8^a&yiiz'X r2 ׫WYa#W蹛7#9)ƟLỳ'++|'ODo,l$(bII7m < zkٲsP\Tk԰ ͢S=ـv7}…YhH$GH 3KKӣ8)I7A)fee|LMYrR?|+2-a9NdddRTҦMEVPȑ#@dհ s@LĽ\9댌+WkԨCL>Sy`L#o$x䥥QjJ1ob1o^7VŌoEm38h}bdװ MSg@l9ܼto'OUhHifG) lF7KVd68:3&-Yb 聵k o\)mGH 3Kxz: 5A9\Ϸ"+Iqԁ15lɒSg@Çfv.XLffс 8(uLsDo%YI1c2jؒ%o)΀KGyy4jfx62I[6*OKK;V: %|+ɚDG$+tʢ-Y瀞?wǹ+ԫWCp`L#o$x-ȴdquŹTU,2nJ,R%$ .O [EmGHHi$8{RvWz Lr@oP/u)XI1B\]m #ӬIq!?A*nm¼U&$̙5_Rّ#Cنerlpǎ_4}|Z)c#~~cruuz5/BK]"[h)= փx fzjTVq_bJ16*HmDfM"\? x,]DbD|,KAAL.^ƞݻeeem,\C rQâE̝;450OXqE(uSUcه̹Gzݼy`ʻw-kOˠ\\I|+TDfM"YRpBUp={֫WEB\˄S*Wk֬>K`ӧGQҥKf PDf K]BAx̌.rO%)F!)&Itߴt9J oDG | + qL b 5Ƽ_AaJLyK/_, &O;a/tbbbDO7M?ͮb+Y[[88TZbLr[JJ4Dŏ:.@ϟZCv S$8P x,]s[`rܣFE-UF  ԩ KzH,JݔLyK޽cG`nrŭ];4s= Hnv+7|֙y9G ZԴ(7nq!I..8ck6' eݻ[jhgg>O&b;.]}8- K 2rR x,]s[`R&wstþϞp q7M-mnnfo_ܾW0Y.mmKs7}};p#3^nRٲVPo}')F)VtTrgqLϥbz.U|)P). 3GI1ȯvdCtyI1dSSbGpr/RjР'O|yZ4G|5D4'f=HoY]fELilRmE(uSK]ݻDv 6G XSFׅ\Tz 0ƥ!.nʗ/BimeRI^TLϮbR 1la1&p> -IiME0\prՍN R Sq# ,|3djDG ?Ϸݵ_R7.aKJ1?s 7)˔[/O^f|d )8H1!lܡA 3Kp>QUL!["9^9bL!Я_ǭ[g?f@OddǬY-gHrrLJ(RAZ܁`7#אo4LMCa:oYUa~F-Bt%5lɢűbGȄp#H\OYgY|vv"ɍ}9}z#7Vb{$(hme RI^TLϮR+"O5qR n׮nÆy#NEGС1WУGAP/_ŠWC>q(afd3Ȩ/4ݘdQK) AUa%z44Q2ܤXaqRxbPhhHX~M<uL̖Gqq=1dcbd԰%KRLUU\OY&h6vlo',v珡Qu [T-hmeMQI^dOBKfW& 3Gb2>}䒎A~dT m1)iFP&MBرQ!glZ#AIqԁ15lɒSsfa5!ؠff+pqkk: N;myڏ) 3ɋ|ܦG9JsĸΜ,cwgo}< n&Qbd԰%KRLUU\ k&)C|em~q AƗbBHqUйbqoU"BBf8 S$8@R̘d[j )&84GfF@XYϟWTRJn6E})y [NuF)t[hjvst6LM㨃K/$շjۨaKj )&84'O)ƍ]nŊB{UV-l!4eyjJ1XhL`ggR J1Z[YЅ;fM"bSm5lɢb QmyQ0?ߔǾ{2P{5I12͚DGz+3TF [lW]6S~:zkٲѐ_2beXΟ~6m1)Fk+k}kZdnqṳSj؄Ќ1!4τFM"*K/xI԰ -wŤ`q~#Y9.ߪUC;;[Sh5w.]T_qsr%|@OTspSϔߌٸ[!(:0p[3zƗb.ŋ"#gDX=B5kat2ߍz,9bX_~m-Y'NnE'y NdgrqL`&Mِdh\^|EvucalFrb刺q# ,4 ۗ?I1hkk d[`XnGτ{@u<$bʗ/0`XM=6zd?:%8%J0iu :-FܹsŮA 'ˆRH^g] M6}t+ˆ>=H^%K] o]~Ύ$##A_ㆎAR 􂌌UV] /_M$#Aspp!>o߾\H-3Ԋ I1 ={~zkAզMMVׇ I1 BѣGn/D<>mH^yfkASD  b$ CR g6o\ZAKFI1 ݻckAAbABwA{DDص Ą)ȡ&Nzݻ{-v-BbCR W8p@ZAA]1!)Fz9"v-BbCM UVM0AZAwAqqqbׂ 5$ FI1 bccϞ=+v-BbCM '\RZAwAǎpص  t I1 BbCR 􂨨˗/] ;haP'O>:pPFI1 "##] Bא# +F=$B/ {ص ƊF5q ĮAtW0zH^uG] Bא# +F=$B/XvmZZص ƊF5q WN B+F=$B/XfMFFص  t I1 BbCR fee] ;haP'>#)F]1!)Fz… ŮA!$ FI1 fϞ-vBbCM oB+F=t'ƊAHbABwA4V gCM oB+F=t'ƊAHbABwA4V gCM o)RĄ0oݠ@z#pda&t&yA$ŌHB/b3&#)FP NDŽHJzuR:h jX1B}Pxq§2!90psU''{ر߾=Mx5h$jA.X~BHK=?pffgq4!.^܆ԍ#^@cэKO _O{TD*HٵkW(Ѱk#Fٳږb=c._ $ԭ[*"6A]aH.w:K,e^m7o.S688T'sؽ{AϞܸaii~^v>¡$)FhjX1B}-]ljZtډ99I#XzzdAAlz2<##.33tRϟ& Qa%p+`1@p88E#IZZAGrss^Һu^W >|H={}Ŋ6H\nu˫ED|#Of2|d~up1ns3f -mmm1fL/h/$Cq8숃bEF#t h>:lGr嬓6 Fn4}9LI.V4;;1,lv:R2?w`{Aݮo_;ea^ɘ{XYBB0rr ?A5*OS9wn *C/IR B/1>:^L(GB`nN̨UW֭L~ǧ!M*Sq*qaj*^tRնlNƻ+&ChvIBdǎ_Cx)ǠڨBq$@- +F+yGӒ%ͬ- 'O4jXâE#J*=н{kViԬY}ƨqRL0D3h8;;[T O9F333)Q$b^UXٳuR'[Z,_9ysFaA 1b=znB<>oR0FR@O?nZpS6mt\€ )fLFR@[*ħ)S[Ea3&#)FP 6lزe"/_ J}C1I1ZAƙ3g\\\"xQC br3_1#)FP ჽ ċX+BQG< tBM{{C;<R lW!d2bI1ӧO60bDa)Z 6qӢ3CX閘߽Kd=%,2/p 5RbP 1~ | Q-Š8W&9}Y|%o"V_ӮBV))ׯ :ʕcXYLff|Ŋ6,Ϛ5Y39p5EX[[$B- D&8t Q!_Inin*ŞN2? Oۿɏ?ի-S}1biofVxqS.(¢Dɒf!ױׅt{CӦ ؽ{Ν 銯 :# n$>:B2~PmɛYC&X͚U? 'A6ږn֬>wɓ##Gv߸qJ*nnإzJQQK;c{Y ֭3FF˔h*tKqK*ټ K.o˗Z22I߾ζNӧ7;ԴiJ.]:%*QQz-kUZE"l05ā<|wϞ VŐ⫯l JRPZA [Hӧˌ2*{_~#ٝc {ML Ivu+nꈙ7/?,-+T14GFٹj"&;7WSӢdW_YO577z26-8Yl@ك9~|\9UY~#j %QѢEح/('ȦaüQYWN޹=XD|.Q7h&rV@]_lݺIAAN_Kn2G" k׮0{P[$eif"aB}1k9A>;{g!< =[.b^g.kg\ 5ݿgBH $[`~х04ٳ4{E7lŊí6l)^d$ǎ\>9[bNNvG#{6#rfi4tvVaMUVc""#Qm*U8X~2;~!LP{dO#@RB^II +|״%HV˺\ q>jC!c:" ~@AQ}mʼn+uKz a޽σ}=|xB(ua["ߧ/'Le#X5MvQ̝;_==-[66xpRJ"槟5._D[ra:LE$eZgI hQb7j$w)6dǴKBF@ʓK1cuǛdޤ}qtinIm(X:Ժu# +`y}g›x|ݻݒ%#MxwXAϟǸB@޼9Sjd7oF"A2MlLl@Ħ["986IdSXqjYE ž<&Mꋘ/ AfU I1BjQabWà.Kj'nHåBny@! B?xp|ɧd/^@|2\JOf| %͠<*A{do_^!XpxJJ4؋z5B*33rX1S++s6=cكrr?ީ D-,JX[[dd喭ږF e_Qm0?l׸sgߏ?ם20"s+Z5!B#ӬQPY׸rw_?l腋'}6 m [P`ȪlY+L_߅MNNWcX{H.S<.eÆN5GkРVѢo/K2/`y̞= 5kKֵq+Hgb bP[d#22r%J|Vy.lmWTud|LM=ۯ8:څ@qPcl`Ԫ AZf:-F:۽7i(>F _8̫C1Lt25-jnn6gI_|Q[iTN<䋊Gy߾&ߟĞ c{#@ ݻNK;.ze ŨU-oFzz\PZ}|Zݻ"R_)6vj%6tbrm={.gݕIk~;իGن Faٕ+zzx4uvʆ #+ΜYGδr8L v7NoEVVMP t)_ $[(H8)M;.mGM ɦzjytd|cR h"sMM=r;wX<}z<<<[;O &' rJ$ss7#-B8P5Y Q_ǔ3d ǏUDQ"+Q&ZD:{Cͬ];,V'Š~^: q^dee_tcbHb7֭[]{@|H={}Ŋ6H˫EDʹ%㌓bHb.^ƦsRl֬A]1DCqe`qU(98X2WFCaР5Pr D3bDŽ`H1dR||Zs޽ewrDƻ+i׮%EZE 3tNo5yr_߰C2:yR-߿L>ۻ%{:IKit}wҥ ?>ѥK~:::xRLy#(jՄ -ouZ }cǂƍ4/{1*S2;;R@a*޽GA/q˯@ҵl ''I8h￟ +!p.ڟ&H1(9(#hE$R =0 L Y[^ݻ7o J"L&@)(Ş>=ZZEسg1..ݺ`7eo=zA㭯fw2+۷gXp&bBڞ7@d5괴~zVff xGA{̏y.Qpޚajl{h$ANKY3NK{gVݐZapHi>s;0a#z ,)ajj{XՓݐZapƶo lǃ&0C1WH]"3^iiixD̰Z9MeCr`gNNc{}{񉉛_ '!Bsgvn:3x5V)7}ԴhKcǍ득(bii)xt̰Zms,p!Tuƥ?bffg36RmR ww~6+bٌӻCObilE.=b6L`ʕkt K.l`Ͱ:-A E 5qAAkղiu^HXXڵYXhЉɵ#|YR<< K0h\妥b?>ޛ—b9vР.UVXt` ;:@PJ02g3Cjo-|EvI'1!ALq/DZh?ۡB{^^-RS1jTlmKu]Cz5bb!,+kD| I19FY2jժtر˗/ uVH8)MF.mGg|7CSnH-08Ø4oŌú[~`HåK1\?k`wq03+޽{k,٩SF,iVh%>kٲ!.\yCxҤ,u<@}3괴{̰Z궷wb֮+'pJd/}$NnL6r<##.33tRϟ& Qna%p+`1@p88E# w#{ MP;q ]\z&ŪTb&pqo8l4-vlp&@lZ+ژ|z@z޽(7kV_DfX0zϒVγ9 8[7{ Ɍb>$Ϟ=g9$Ƶ%K""b>g3|T`2f܌¿[Ɠb9nƌ-ƌ# 8(V`dwCjaƤAv 輽om0vQ;!̤X0b%KYZWVm/Μm…Zxx`߾*erMIDbvW\}^ FY2jjg=<+gY0۷AdJJ4Nىaaqɇ䯐ݻ΍lSnɘ܈lBB0rr ?A5*OS9wn *C/ݐZap}t>;vuΎ`u=b'Q*ӣ5kV15-ڱO.R޾cwȘ)HЙhhEE cR )t^a:ŷo}7&N񮮎QQK==|z(ɤ긔U3bN+,g(vmq m[~;L=*Omoվ}[nyVZisymar,,#?Kٰ$~v3xyrA=p3۶2[:רQD__7㜜 =W4N~I1iI1BGj٦D;=ZڶmXD ggJ*]v lݺu{)KVvm ^p1W\A2-4bĈ-[]N>=`mx:Y~DXПa)I1iI1BGjbcV`hb+SJIIYfѣ߿߽{ݻw|2 9L:Æ C[nA]tŋLNN655 }]hذg+VXFF·o߆JOO~:b^zT~}\A|_LMMEL=zqQH16EfmmPI})?go*ǧD#O77W~СY!oS!{llڵۣ7q7͙.]ggk $Ťi$ANKYSZbE:u 4sL+++|8qRՕK]u>̞=ɩbŊnnnu֕ɥ3K+qg:804Ŋ{XcGvXP{ް4Eآ&$Xez|=Mo?~I%JF^an.p貯&iE9z T,g%J__\$Ty.f]}(cܥKHժ g/% nWCeFw14!*FhW46l`mmxQF~!*Zjg\l/@yU1xQ1ྤbpvv1bիug45Ȳ<5W{!lWbMs /Oys!\ֿkJJyx81/w>>LH\}]@r =botroowǯYҼSfOʕmƢmwk[;;%KFs *V| /vVV[Ys믻x*PVVk XHT"Kֈ9>ً/$,=}jC֭ܨ``>FO:s;@/CښS|JIMMTaɊ~CS+.@hW4矺u"uӧ3%+wT___di N:1B*>zw)R|Igu?|¡+,C"ž} ?Gn Sp!c`QΎkAQQA/^W;sƍksٲ1jU ¨/P,,lƍC9r{w?ULʋ{wTD ¢sVZ1'B]5mi;[{DӇ@)\ lѢvF?qVmЮUߪ=owSݒaNINB6Vz9ԩ<2MM30CB`A Z'VvݻQ˩db7qboӽ2+I_/Z7nϞ=L *"UF ;;ի3Xk׮Yf*U[%*;wn˫uZ*Dz=kC(qøeii7o ի;XZt K.P}vM`K}P%”{{;0*Fł'7hP Cx+DǿSqܪ Zg/%61Jw=:s;O* [<,Ʈ0ه,uD2Q1UyTrr|ؕ+7Բh>h%%%={ .@0vJO~IMo޼a}e#h\s\Νb%n>aT,!aF7m3g*ZԦI6TTElNN8^1P1zniG1c@Xʸ/',\z9T7n#̡p#'>}:3mZ[[+ #GvM%)BIZ!@V׆1 ݜ|#OE]9/.8ꇳNfw옋[ٽӧ#ܦ#~!]v k׬iߴi$hBa,Y bR)#]*BBC߾}c4 \9A0>*+өU`B.|È5ڵE|D$W/gňS0:$**ha^&y$a\??`taxggGt҄y t F %O2/1bŊ޽J6zVɠnj=8I!C(qT1ٲef*eǛ\Xjڮyྤbhfh#FtYz'bhhCx Sa7? @x %J f?@:IIsD KU 3"EJJË˔)|H@c05ӹssp/?6I|9s@11+Bkի4 b* .AA#1q],kcOۀ¶(0%6ͼ1ƅ'OcBKN0۳go^+WTOaغzɓ{f+00?Jzf}EZ/(qңbKf B &V"6˗`y*m|xX/"(۶,>&_uVǍӪ -Z:s;ԚDڪة;gklScFku|]9mc6Q|Aj`Kh-ZΝ;׫Wv8 /&*W0ij<9 }ٲŸT1<$vŘ{#G&Lulp0fN nU^^iFŭN%T bq2޽Za,}ƽ{etx*z QD^gﵱsFJңb.NԬiN?>4K%*#[EI?O M{h)xUVXi ?~q1L9;J@""k)) DKuumȾ9>Yoٚ7xM*7qٶUkwU _/7 lĞQG]ɯAuݗ/ּymh &,c.mm $%\XA*Q–L}qن#GŎY:zt?~|/I:L1 [ SC?o99t# jl Sl[Q:*&'yAHD3& @ \2Y.d,h c@錚< fyhH<.Ge%ڿY}1Aba/>-ɶTlN6O7ro'G윶$6mI}7]|0ٳq # ~ K*.O\?ŭf @@0F% sy=1e;w%*F+ly{wqq0-̡يwzT oK*Ώ:&Xxҥ`Tlɓj7hPXOa@`c$_,4#`c/&bvT4qHmK05?w[*$99^:өi.yEan UOKH,!y{Л\ɓJi=lK jpv^k˰;sYV&wb1bS1Le٣kCC0=vl9uuYnzBVzֻw'KI)8ʃ2}ݸnm]QJ"踪\yNQ;v]tL&hiNŒT޼yNK b=:-vEqɓ'Ŋ|Ǝ;`bOM46*62#T^ֈt $ݽÇii۶>i~FuppU%5k[Z'O2} W/Wtѱc=EѱM9'e*W.mn1ϝ ҥ\]VTDǧӆ SٵqquA9?rdON/^KQR{|M4ڪMMMmllf̘!\KꥄYuK2j|Ŋqz9Q1@ څҶ}58rH˖-YL/ȑ#ÇnTC]|f8T? ͛gwgggGN $&gs ~Hvi(`aJ/v_sg_R1E``,^}'==IShYb9&DuZK֭ݻ7 }{NM|bc_}=}`B)S%KF7jT)oڃ4?^HŬkU+@p %%Bp sMS-s1B*bii7ob7@X ķoA)\(g]"¯A@pWb1ޣ@p_&Z?ٳtJ={v֭gbm۶+V̙3gԨQh𮮮ׯPMܹ+VN;̛7oӦMʕ+)geNP Z~ȑu"#匳ի[vN5ipT0C# )5k-m8.*b ѣݻСIZ&Ĥmh,Tҩ"3WΚ#DH+S1dC aT\~qP\s\Νb%n>=ز 1c8MѢ6ܻ9aBc=Y3g6XBº˗n ɧ&Μ9)Z*/ryzYf"@Fn]]e2mZa7ݹs.y`W}FF[Khii9`/TF@w޹s߿ziӦyyy9;;WVԴlٲM4޽1c-Z}7o&''geNBBƍpؠ#Ft믵kWB`׮y j VMkqq~A&5T%.fI _B)Sy󆸸4`ȑOHxSEm8Iݿb8~ceL_sWlpUbKtBggGͫWOG/7(}&={Yn0Mݻy_-7\~)ڤSxx8{jyP۷o;w\xq_6mZ|y4Unݺ_~SN]reDDď? ֮UsedpzU#!_"J޾gT…>}\Lw?% `8Çsm߾qm8S=H_Yމtb$ǡA,| *oTlp_ѾG}"l8<27{OzW^r*KN005ʃ\tF8{STlɒlԩY iR%iG¿{wHK<~=;em].}Hݺq#'Nf%yWmW ՗hidUq޽NNN%JSϟ/ћ7o?>z{z/]~ѣ{ p{0M_@]$1 [ SC)/99BCmРn|XNAʖ-)޺`;UOi/;Q1ATD8ݻ… )S>..ɓ'qP1H߹m^0lpAW,0piɒ'n}AV"8Ogʕ+,hңGkT vJ5k#~~>{6^*4ȝ;NxYo"*?¶VmMN(s|45&ZZi՘Q 4뻺v: e۶m}Tк@8JQ*\tQK*i4\_?W|S,u0*cNdQA:o*))󇪞"*F=1ʋ - ϟD-Z?THÇ  FC .d,P= *SNec! ǏU/!-i"ӧ3j"02,߾ݷOݥqWZn* ,ti JNM RAZ=#!*FtJD'{"q&Mg^w(W/n Son3:h߭/Sdg]֭[KgmDWbvr_u>VGBT,{ Q1 -˙3G#V\ZTL oM-!=My6>sSGG射uHɓ~YO9"VMTL.@wZ>91\:U(rfD':z;QT3Æuh۶;5vɒќ/_˫U֭QMG͛877tIժCV|zd-d qQ@9r`|Z*ZĬxq+(˻w'Qpߏao#t?MN/n5h4ȫUSE˩d-ZT8ʇ Y>}`oo8pp33SHMXDQ^>;¢]{?M&zpS.AKwИD^>g-?&@L\k'kQ%(vӦG. i(Q "̧U^V |p]{?M&zpSn"AKwHgQժCzV^E=Y*yСC!C<QD )r…?"NRRh:B'Fn ܔkh84&WzS uZM|zd-9۷ Zr9rDfGQtp&7tl;Eaz˓ٶNU^tݑ婂ĄVuZ&n 77t5=@pI}=2ăS̊s;Nd[W`ogDd(CB?}ݾ}K?=u5̙cΜi׮Oow[ ȪkK$y ZCz=K}sbOoɬ8YJJĬD` N*ŋ[Dx"j9ϔk{>ܑ ySYum Q1@D"AKwHgi?q#<+ Zյϟ;{/;JD]!7<]L[2b9ne-7g%&DzQ1튼-!> 3p@\9#Lyի; MM<{jQ_P%F/HO?wdB򔠹Uo}OF–ɭ Q1@TD"AKwHgiⱏۻ?55כleŹ]@pw[Ԯ]iٲ1׮̗ЌmA|"v<{M0)5.xG򖧊<ֳgvvI:5S2;?ŋG0;nQnBwtBGq Q1*&M~>1tFuGE]IMI@rQ-s) R1q8kҳ<9w/ֹ\iXP-Oi#-lfߏBX0={ao?8:V^ߒb rrw~]z.܄88ɅAOȊOpNlĥMv~|ӦijR}5k&2= ,Oנ[ZcǶ2'L z͚}kggdhNAʗ/*x.OXDFp<+;vaȫUgŧvlӧ׳OفYM~6^i)\;wL;QnJ8GqRrj!+>E@ji&!ȓ'?ɊKqF@ZucT aa<8v a8jUYyVpwN{XEPXDp<+;1ZuV|A.Yp ;_jUr_j f}ו~ 7%wt8Cw9쐕H7mQ1KKs0ȼyCKSC⌊}`ooFŨ&d TC[rcffRС Ú2 h_߉tMGCL b$jYi)"Ӕ*Udts/Z_u}'M莎8Cw9쐕H7mQ1h._ìYq)Ψ{ݴiѣwCv̘1l 0:k,ew, ժU#ƍpt919τ *fL"Vv{/aW9;th1_\$b=!+'9oُ^15ijRb:42)T,2rQ6ߏ)jTpak+{'&Fp<+;1ZuV|1i߾kC33FӦoVV15`ʧ;Qn;:KGq Q1H7mN0Ieť8Oq- OŒ-,.\E5j*cKwHd֬Mh:J9]i9τ0n}N"VvYSu&tG8=׻ZAvItĥMdÇթJLJ4b ԩ|RXzWe_!/=uzȀh˩F9sHl~8czӵd*&tV*:bcWq 7˖)[XzWe_C:=d zS 2iŕ=i(N"i'tV\4ϩS,2HvLJWŭյaJΝ a{sMo(a8UL)NH#4=}yӵ O;ܝ;T}qW1r΅޽_3g6ʕsAQQA=n[eDD;֭\L1CNH 1%A4i? Ϟ4jTwpD^,,F'"" |XvLٳh$ y<=1Q] Wrj@2FŸ'VWq̃DIqT}A.\V,".]ھWC& l<.u@z.@ 1hU92DؒX&^IV޽Wbu DP+W ~-ȺO;\z>ᒓDD~=}S| ]R: E֩ҥcU9vly% US+һӧ3 eGF.v$#M???{{{%K*UjСxLاm9G-[,**t. (*a*F:ɄFaЗO^PmsNѫߏ@uNa\sgU~O!%F-[ sŋn:Z v횤 Ȃ:kWꙇ<=K/zT%Q@ dz<[ {K*7==|0n\O6jT#""]rcii'9ƍU-;׻g6jUO4xlA)bޔ&$5aB%l[}û4ϟ)V)޼)2?.&| c)U*U象#*F hU9Rt˗Î]TWvj۶9,'h ~MnIvVV>~Ι3z[7?"Je]Pp!lٴ]-?~sfY1=ndqwvzȀҊcʍ7VT۷lfȑÄ$R%*F hU9Lԩ`%˗ `0/_b~)) ʕp;th’ڶmNv_ڴiz9 YUB&,Bu5k&vފS,e=ݻzȀɗTL1֭[syA2@T@0^1Hqx<~}uFV\MÆ՝'olm8PxլYgbkƌ@ynYU[kQ8goowzCJLL̏?n̗K04Qǔlmll6o,Ak#d 4*iÇx~'D(yB^DG/], >t vqiaTN*eһ\w04)-bׯ_'CS b 3b"[%[ûf]vر^6iagD5nxԩ-bUXիmq݂`U1/:xp!ɓ۶9y2yy Mۜo*TJ[,XPr-`b!*Fd_~jժ}AV1Ia a b 33&ʊ8=4# ~~~>|:y1I7'J#Q1 `kkcsA1Au=srQ1 lٲ/_J +u7|#u.2 SSӿ[\R *F 믿ɓGd&&&%J0GxR *F ֯_=sA O7lPdb]venk׮I *F 5k'u.q<rʋ/>|8ؘ0@QgJJF *F vK ׯ?i$ /u2 [ׯ_&E+V4hп+u^_Q1@ WWî]ڵKe&F hxM^jԨqMBPbA ""ŋR@PF߾}۵kBk׮}9i |wyyyeMc< *{n3BHDWZ%u./0q $''KKgϞIAH޾}[Jli… ʕ޿/u^" *F bbbΜ9#u.xʕ+?׀ILKjCRRRNԩH2AaaavvvJVΟ?JDBje˖*T(22RQ1 -u.4:t_U޽K.d)Pb\4pْ%KN0GDի &u.4tÇJ L8Q,eTm ~ųg5jDn D˗!0IBvׯnjcee5zh!!^v4TXRRҶm\]]%ɒHMM)\0-!00ŋz___y ģGz'OQF1B֪U+<>|E޽{'m$ɓ'/>sO>Il bdsqqa7o``(R%??cDz2[[[~T cǎ``*N&u ?nٲeKQ1A2ԨQ.k֬!!!aď$Yb!aݕ+W*RHv~` x5~Έ^!"**pK,Q=ET`h۶mŊ}}}M2eĈRBضm[΅ݻua}POT ڻ` IIIΈnի 3J5èQʔ)?JP/c$Q1BvLCO }:={-X5kءǐ&~`jjك*U*UbIȨQ߿?}Bº5KnE-$JAT0\Hk׮I}Qj۷o;88xzz~Zs{ә;^u*ֿg''ǻ5= *vfdʌZHكa Q19bʕRBOgP&6))v1*ԩGQr_R-[fV\rd)%SM!%%aJ .Ay{{;܈%%̨$[I=RRRJ,y93?3 a۶m-xϨQ y3\х r9;;lHݺ\~h4^NX]L1ѼTL4]5mi; 0ukˇ_SB$Yb]R˟?./7n([ˬY߿?O[*V,;BCC[l)u. zFQ{ʕsŊq?VTIIW.hӋ-,^MNYh4^jִODSطo8\dwNBD5OWjh!VdL$;#; lr?=xp(Cfz{Q1y!55r111RgDgW/nġlb+W6^R&Μ9sŢEmZ,{ӝ;5E1ffk]k6mZ[[+KK#{j _Sʯ Q1QA4HS!=*vʶ~\Gncc`r?cǦX%ҥ\]VT͛8u9u*i ktlE]4ATL^WԹ= Aç05H Y>^TnݔYP޻;w*UʀK1c[jvxXzr޺u63ј|/ɓ&<ܯxB<M=F6ʔ){TJ"#i#!=U*6oaeh&3=\pܹ%KH6&u.r-!*F0*1 ߩ؍ᘐ)Qsξ|LTn-VOŒ-,.\&,lvAT,왚y0OpsWsLo *&xxx\R\H$ zF iK 3 :کm#r G K2&T U&EQ!>[R w\wG,Y)3e2놆`vZ"EΈĠgӠӝ ˗1kǏf͛8%MJJteh}K A(5Q1]XHكLa Q1ݻw \+˄%1!{ I {i0L1!*f1bĔ)S΅2GrE휽7dl^ =ܖCKOC {6L/Um!s2&ԣ jvF6zr&יz>$@kd$&D2܆)jQҶ*i_U{N[ߨ.9y;%qÜ97_>kr MrWCGHI#p#1z*eyzv^Jl15bǕs#ziuv>E ,#5}V V~d0?#DH _VgTTŊ%!Fug/A abT׆1 ݜ|#OE]9/.8ꇳN㫡bޝD^Àᬲe׮yժ-Xb.zrΝ;R^\trh?K*T(? rv ڑ$xH8p4 ,ܯwdW&/}zdes6FӃ媌ә;^u*ֿ#x[ѣ{pڠboF<ш*uWzKu^/Lns+d; :s3*6vI}m%Kf1o!(2k(`VeχCFukX#KA"իRl1|8o 3͙3G޼Ĭ'*F0*H5po-W)z Gl,gQ6Ķ3ŭJ`w0f *#mФb.SBN{Ro2ry12i, E oɓMUS@G0yRE؂FGO*uWzuv5y鉴USw֜٦ƌ:ws pێϨ*4bٳppwϱE(^pVu9ŧ'AޘG+^en$xHB%aVpB=tr*O*ݛb^ F(cXd5gnhZvUF}`-\p5J)p BBlHݺ\~h4^NX]L1Ѽ/®]6u~nڣaC=w(uQ_/p~N < [Fqdۥb(40f&̜Rm(Q1T;g?T,0pW7'{"cWJ$T,lz0a C+ aˆPmwe+ /d4fy׮d<aPGq_8{{1ܽpآEmk#)JhUF׫2S]]bqzQuSBCgAy^$*)) UR\S,@VZ]]oٜbAQ4|LO 5( >ES@T..b9sf2 L_T)UԮ\Vs^[͈w4X7q; #wfG??C4b3(bXJOgл4>oǤW#*F02H*r~~kAvU5&s`L!a&7Î#ܵk ջG""g3xNlF~c>XG2:^Pxq+cVZYf/cgk vff;DŲZ `/mSvj+ 46ַBȄ W.E!0B޽ѱȖ-0ũcR7ovmvX];鉊e*#m^V<5 eRCkm33 J٪#>$ܻ)m8BT˟jG#W[I `BT˟jG#W[I `BT˟jG#W[I `BTpK}Cƶ[mY?3.A^XxĉfOD^Yb#W[I 04@„PQ+|1 uv^) 48))ԟ$q=zHŮ\ƜS fHSl0cT |Q3\svܙOwK9Qs'9)15;jѣ{GYOtjժ.Ѕ ޝ9[][ǯAEz9l֮SM8:ᨨ2*o߂f;EMϏ.*bsvv|p:thRV9`gg:ŋJXTXqeڑ$x3L!*&.0!T d>5bǕs#zi ?8.bKf~j OkHXzNvxܸ<9(h]p?G]恨q/RFŭ0=%6*|ڴ`P1$t짟㏳oR%-M~ULԎs[ſ,Z;rR1nqP񒉅y[sN+Tom@kØ[nN\R>ۑ'@wA['+*8ѱSȔoa_xUREڌS56uHg/ܹs!f墣K[zȄ Ǿ q@Wʟ7'ccWyyp/bo3*vBh>.Sۻ׿mA><ܯk{nkoo )GZˢ#W[I ) -̬Z5aÆO9⣢h0ש~ڀyik E2cnn(ر&a# OUf <;}[77m8̙v3ԟ(uk8H0寷ځώw eCak)) bL*P={}|:A[HP:O7hP U,c9Q+[WB@{\m%C*8d mQY_4毿CхN1Gqǎ-Q<ͣq"Ţ>w^ %i]T 4,' ԝ5g15:ݜS*|U033i@L[}[N#uTVrXѢ6%Ȗ{۶p`Z a(Cu.]kִϕ rwO<ܨQ /vu$'))dSD [2ah-̜8#h̙qf Cj^^YRO6ЃF \damv_՝S|,} `AG6U 'G,@,ֳ{.Fynvj< [BFD 9!ϟeU~޽HZXq)gQڊìL ^jTWazJGBT`Te-04v[TfТؚ7#\ͻw'9#њSK^03`bQ%m@?hd~' )vriKbI}7]J/W =Jh (.Ʒ r)Xb$!;oqȄ*֭!PtQ00vJ #X{AЮңb۶X`ׯa/ݻ)mbh?ɩS#|osŃGA1+= Y ߠsg [3V )8(6?}IŊ/SIr$*ڑ$xHbLyA-*+ 3hWVjf3` u2HNLX@p+T(٦#/o h}#՜켤זa3" /= v玳ߠl޼3С0z1'؛={#UTUT 0%c+vj+ !F^nNJI{n5mZYy,:NFصk a Mx3Tܹwon wf-:33*)ؘLkv_?E%}y57 {?̷}]0=SaBxOcvj+ d S񒕅ݻ(3b-@O۶_m͚/|^YJz{0&X(iILz]hݮÛz\ }6fS)) E7JJMoN6o_=wBցk=ÄA Q1dea}&7ק0?mVV[q4Dߍ:vl9Д+W|͚&M*mٲ Pv_;r2 )DŔD 3ϞE/]:&""=޹s.{Og<8^OFH-mSvj+ d SYԩlؖ4dGbᇵrl2-b,DFڻ`L9\]Fe+ZԦa۶͑`B ńX̵*i˟jG#W[I `BT8sy2fŊq(yՎ|b19k@PDTkAS$:44 6ҶC+O%'g5WW T $HؗWK!UiK۪v>>Z &tBw'G֨kW/g^ڵpIS߾#8ӛ56m??TT8;;>zt{V:4U<نzҩ"3+<~|!jsVvZro#PI[iK۪v?$diq#<8xrP#5ݹsnժe[;DHZ\4ӦDž'O!qܥSf?e}{o*ezjǎ[3V4'#aK܂۞ Q1Q!(O'4K,[6VNz)qZn  [_:wn^$G33SF|Ѯә% oX}5k cXp̛%734H[&ںu68xpY^*yTlܸ8]ՎSp/bo3*:eʔ~{m[? `8LJ~ڽ{TL#}R1z:*_J*e&+ThQ+1<hF.]Z)S޽`Ž0nBT H[G,=w?ӤI}p k)) (cŮ@j-9srڠA5ȫWv˗Dlb%I)?ᔿjG6;02 Gu뢜^;rk:?*Yb qwRFj`T}l +<P^kXÆuڵUbS1fq2n`@Qml,/_3(C#/Ъm@۽s(čS`(^t<¢TK.TOF׬iD2&ͪs*P &6 {z)bZbT`t]skG@J,P">Gfac=4kTݻ a9 ţn+M\B@_V\q=A)(CBcx83^of(=lsBr1gaޮ]#24HtW=]Pό˗1_T}!TDTley|]kBSٶ={aXaSgX0cKKs_faNwsumXR)X7F|/^Hӏ#ԘЯ'h(i<#K&4b8hQϏeeh,YV#&f%wϯ^SiaH槀^%KFcVܺg1}ϔoje *#m0&+zbpʦ3ິj j(Ϣ֪UKgNA 0CYg.+WٳEEg-ZV}:a#W[I Pc;eR54p"WAQk֞5k_'a]l7g!n>籐\lq[(Ű]A u&%og|ӧ33JrebpOp@p͵&I1BR@s_o]xFFE&"i[H(vK1UƥXIɧ/C]\raC+f]v`ʔ`CLu+ .Ű_-=}1WbD/]:Gap۷ ӧg*55 . v1thUP]Ur<[[krM>t ) 9`iiAԤzǬUAIImHa-]^T9%GsplTP0>1 ͢ !U_IMPmdMM5J756VaBd͂X֝T[gwFoX'l*%>1#ΦO˖iblvzTK0q5 zO3T})T}%ApqIWѪhݪh[ga'aV0U2)͍g+æ`$sB7Kԡ O3G#-,H zP[:--G}b ^q[G 8r HbYd^=taVH5#)Fֺs. c޶OO$4 bZwP[:oJਸ#(<abv(H Z1t۾AjhJਸ9D0hDjm1 l=ŭj㷎T}%ApH<%bwE6bdm/~_\/%55#)fFR0+T؟^T\#f„a0KK [[kftmn2g?<igg2;sPSS=Z0ّY[Ka{0m{M$*nݪ{~ޡ7d@mHWGUq^|W{u'ҥ"taUd jaw[{#8iA2O*YE ҪCZcLM{+*ҽ\\\^|r4j4uѢ)Ǐow|P:R{^^[{HH) U)6m,77~ٲĿ'bõvF$F;w|ĤIqLÇ3^{e?>~ܸW؛CN6jPgg??}=H1Zis@):[y.¡W80kڥXjUL{Qo劫h8OO7MZ7M=u*oƌKHM2r4T}%ApTXm%LV6 c\qRIW(Iƪnݺk%fEli9"*Vn"f=߫W/8wn0b@֭+]+7wys?Nb…"۬K&O9%m:X͂G3g1z:nZbT.eI1> fCf|),ս|y>չ%ں,1tmEE:>y Gwox?6M4#ݵcl嚜R_DvxQ087zʞաf 3m!/kb?TSO>} ҫ66 B=ih738p[2jR><~rvm?~vUؙ)7bmQQ>}C g. u+ 58~46y_ l"R{6sK_ ɄܥKgLTg鋃Ȼ-[V0%քgT٦M++֑$aeScLaSSJ>~|9XyZkNׯ)4v%?\X\0̽,--0 򋤘gUFIK2ru2p+exc(s^]vAWŒa.=bf CgRLqS'+bD>HFȻCuc'KLH<Ha^ujYIɧg rB%:#i,L deX<\X6-֑$w:L؉R;--I1.'fMM5LHϔd|kx|̟flL\#혍A57G $}Ve۹A!] y-װ*BƌboTu O2[a#<)f[@KHW ϹJ1t6~=P?L 9xp#bJ쮮|BaHMr{v1thUP[lm=<# \I1]Ve{晾N1޳]jWe^P+224LJ!;&0cX)`Ewwb?P^ROv͘RlVѪ$U6NGR26T;Ds`*;;Y.ݕ8TezѰa\ a^$yfi u+ c)&55(]WjlRM$.2 uu9U]jWe4]IR rI>ѫGgn.Œa.)vg[ZD )R0 605&bFmwFoX'laLپHӧ{ϕmݺG;2roюY>mnhjJ3?3?)˪ҽb6,c@ |s߽sGLA3b= Bf ~A:Cuap4= 4E v1#K1O؝hJëH(C).vB\u4 CKM*cἼ6Z4T}%ApbqqT//Jq=줘.2JR j) ',l\ê ﲱt|?m?HLyau瀦g`4 jy8l`qhV:&bwTB|COxtCx!C\M#U_IIvh':ʨ¨CMru2r 2fAeaL֯_14a0R̤hC1: Nad,,/y<ӷ_>/ײ{}a}>=zKh"/~0[D펲ã{H`bb"?,|$̂X֝T?a|ɣ*8Z/P>9lCnY[k.?s挗? ~IJzR-R=1"GC۟_7q}.]x5 /$LIq#?ݻ7Ln}R=0>NQbJh{ƚ?YiiJ}}?Y[w>[xڵ*ŘZ5gX80pKM/[wyF$vss;wؤIq=e0~|q<=,lԂ~~^uu9mx )&9gUdM{1G„ }.GSVC/Z47tސ0/Oj'BJJx6z@"Ӄ'N|n{ׯRӡtbee,zsv 76Vu_+E^4*DnݺڵrԨ7[(^rX.98fe}8yrȑ ov`7a9nj ǃĤ; Ъ>WX6--MS֭C:7cF % ?a|ɣqC~E/eP|&ް?mۇ/쫔ϖJ1& cao9}80(-(Ey͚Ygw`?stc|}=1*g<Ҳ4]TUW.N;>`}HOjCxQ.>֡5-916{rMN"Gd/+Uճg7غ `}ADH-Y2-%~{"3Q˖aQACS:X1(l&OFdBBdDD0[-' GcDzA bhUFh9 >%6 l*%R]<+^ʎ 6׮f sn;48K֭+>0{{[a5Lm] j'BhqVf15t6U/99-H~ҥ/hꕟax +/_2~~{ŋR \&5CJKᬹ")'*#޻:4?jlj̇MD vm~h$:rd3z=K&TBK鋃Ȼ-[V0%tr)FL*۴}v0>ޠv"$wM:L'&77_}~\Я_OJ6M,-&~ ""Μ)Ĕ}ˁ _6ga1Ң>0Eobr+W25\ssm||$IR̀Ъ2*NPx U%b4\Ө]<^άSt.V}GU'4 ~~MMOayPÅkMloP;G _zi@Amw ^- A&\1!ndRmh*`ݾ=NXLTFAiyyd؋؉Brw<ã;3 *T)Q*l)>Hvx׮ =$蛪?_s'4IJ٭7)S33Ͷ.!y ;w\koŚjJX 55*TVe'')n9@ htD*%cjѭl"O.*J¬#Kw%CUV6̟|''_~)ㅁ:ztẸ `}ADHz itZiu rh#63zSʤ=`S5 [ES]<}m'@Ӄ͍ön]#FFR5(/|юͣx[<`{ډN䑄n&aVe)TzO?ΎIO_ -˩D*z?a|#LÀ$(3^DK¤NQq[G;(P$y'b0Q00UԿt`{ډ>},Rr]+W}n1lu' Ք?jaAaS@"kwA'QbJh{X`/EYYu3g KYLyq_>ɝ:YtB6MlYXbye P`& 8|8?zd3QxQ :;;yi Z!]~BH )ְz@6FȘ#W\TdzLZ5gݺE[wO74%)I1ȯ#g[Vj!x[o:fL`pK^ܹŸXխ[_~zwCW!r׮ NMys?cDz l>/<9x?7[;tаJ )Fa:$${d_KY2jLWdƍ{;LRLx]L7n|$T0)o5LPKMM5^^sB)v>WWG??k11& caoA9rūٻ-(bk, Ҝ=}5ᚙ'I1 Ӂ|%!yH1Ǐ&gZ)% O*>}(~m˖ni9"bɓڈPr0;;dAdBBdDD0[E..Plb~[kHA+ ɣE}Xalrr8qRl׮ǎ2{şBחZ?ԩRLrTsV0J5 jI1 ] _IHv%$d$ t|%!ybqqZJi_MR D _IH Z3I#)F + CR4A.$$I14bA@<$LHAJBXZv;اA _IH Z3IU1  _IHbi$ t|%!yH#y)&b~1+ŊyI1 ] _IHݥذSK6D+m$ t|%!yT Uܻwƍ/٧:A@Dl"R)و^^0;;ɓ"L*.|kѢ)<ر,h;jj2}|˗HAJBhb)Q*l)>Ha[[Ƿ:+/_km KsbqQQ[rL6ihmiiqV_B)oڵ{L \&Z")F!:+ ɣI*ZT/>y_<A#R&)q^{E}}?ؙ@]K1.]:C57G j_=YtDR BtWGm#63zSʤ=`S)}oƤg*55 J]&tZ9bѪ _LNgkkYΞݡEP]jDWK$ D|%!y?ba'a})!ғڢES Tc#G| d_Yڴ(OO7Maԩ3BX8//!55 )F!.+ ɣ]--Kc/>B@uIÑWUWo?>gܸW~iBX[w:|8%njH'UU!<|Q7[_{e$;yr{Xب Bc16{rMN7bD=:,ޭٳ{R`C2PbABIԡe\ܬs3&֭kQQ>}C C`b#$Ţ͏q"e`4Jߚ5 ȳgw ͯ޲`A( s9K,P 9:ڱ /~ lY˥..L*۴}v )F!:+ ɣIY*$>Dl"R[Ex('>۷ȒO;9S(TB޽U}ر, :z{Mc'OngJ&ǧ<(iHAJBhb)Q*l)>HRl2 а֭]>&P WU qyĕP~~ ˔P}}I׮]ǟ2%83sl#$f O*O/ںӕ+{ _t|T^ssm||+`OQQ͵kzu @R B\WGm#63zSʤ=`S5L6cG+yݡΞ~m'@Ӄ=W͍Q n]#FF^MM5vU:VuHA JBhO,Д&ؚݽ[}>Mt **Y  Np^^$ ą|%!y$;w]f%'t+-Ma--G}b /1rHA JBHB~iOvvLzSuu955W+,T8 )F!"+ #)ތA.$$I14bA@<$LHAJB3M#)F + ciiA hO  @  B4HAAI1  >MGc$IENDB`java-design-patterns-1.16.0/mediator/pom.xml000066400000000000000000000035771312550536300207650ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 mediator junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/mediator/src/000077500000000000000000000000001312550536300202235ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/main/000077500000000000000000000000001312550536300211475ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/main/java/000077500000000000000000000000001312550536300220705ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/main/java/com/000077500000000000000000000000001312550536300226465ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300244765ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/000077500000000000000000000000001312550536300263025ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/Action.java000066400000000000000000000033701312550536300303650ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Action enumeration. * */ public enum Action { HUNT("hunted a rabbit", "arrives for dinner"), TALE("tells a tale", "comes to listen"), GOLD( "found gold", "takes his share of the gold"), ENEMY("spotted enemies", "runs for cover"), NONE( "", ""); private String title; private String description; Action(String title, String description) { this.title = title; this.description = description; } public String getDescription() { return description; } public String toString() { return title; } } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/App.java000066400000000000000000000060371312550536300276730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * The Mediator pattern defines an object that encapsulates how a set of objects interact. This * pattern is considered to be a behavioral pattern due to the way it can alter the program's * running behavior. *

* Usually a program is made up of a large number of classes. So the logic and computation is * distributed among these classes. However, as more classes are developed in a program, especially * during maintenance and/or refactoring, the problem of communication between these classes may * become more complex. This makes the program harder to read and maintain. Furthermore, it can * become difficult to change the program, since any change may affect code in several other * classes. *

* With the Mediator pattern, communication between objects is encapsulated with a mediator object. * Objects no longer communicate directly with each other, but instead communicate through the * mediator. This reduces the dependencies between communicating objects, thereby lowering the * coupling. *

* In this example the mediator encapsulates how a set of objects ({@link PartyMember}) interact. * Instead of referring to each other directly they use the mediator ({@link Party}) interface. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // create party and members Party party = new PartyImpl(); Hobbit hobbit = new Hobbit(); Wizard wizard = new Wizard(); Rogue rogue = new Rogue(); Hunter hunter = new Hunter(); // add party members party.addMember(hobbit); party.addMember(wizard); party.addMember(rogue); party.addMember(hunter); // perform actions -> the other party members // are notified by the party hobbit.act(Action.ENEMY); wizard.act(Action.TALE); rogue.act(Action.GOLD); hunter.act(Action.HUNT); } } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java000066400000000000000000000025311312550536300303550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Hobbit party member. * */ public class Hobbit extends PartyMemberBase { @Override public String toString() { return "Hobbit"; } } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/Hunter.java000066400000000000000000000025271312550536300304200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Hunter party member. * */ public class Hunter extends PartyMemberBase { @Override public String toString() { return "Hunter"; } } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/Party.java000066400000000000000000000025231312550536300302460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Party interface. * */ public interface Party { void addMember(PartyMember member); void act(PartyMember actor, Action action); } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java000066400000000000000000000033741312550536300310750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; import java.util.ArrayList; import java.util.List; /** * * Party implementation. * */ public class PartyImpl implements Party { private final List members; public PartyImpl() { members = new ArrayList<>(); } @Override public void act(PartyMember actor, Action action) { for (PartyMember member : members) { if (!member.equals(actor)) { member.partyAction(action); } } } @Override public void addMember(PartyMember member) { members.add(member); member.joinedParty(this); } } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java000066400000000000000000000025531312550536300314010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Interface for party members interacting with {@link Party}. * */ public interface PartyMember { void joinedParty(Party party); void partyAction(Action action); void act(Action action); } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java000066400000000000000000000036771312550536300322040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Abstract base class for party members. * */ public abstract class PartyMemberBase implements PartyMember { private static final Logger LOGGER = LoggerFactory.getLogger(PartyMemberBase.class); protected Party party; @Override public void joinedParty(Party party) { LOGGER.info("{} joins the party", this); this.party = party; } @Override public void partyAction(Action action) { LOGGER.info("{} {}", this, action.getDescription()); } @Override public void act(Action action) { if (party != null) { LOGGER.info("{} {}", this, action); party.act(this, action); } } @Override public abstract String toString(); } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/Rogue.java000066400000000000000000000025261312550536300302330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Rogue party member. * */ public class Rogue extends PartyMemberBase { @Override public String toString() { return "Rogue"; } } java-design-patterns-1.16.0/mediator/src/main/java/com/iluwatar/mediator/Wizard.java000066400000000000000000000025311312550536300304060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; /** * * Wizard party member. * */ public class Wizard extends PartyMemberBase { @Override public String toString() { return "Wizard"; } } java-design-patterns-1.16.0/mediator/src/test/000077500000000000000000000000001312550536300212025ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/test/java/000077500000000000000000000000001312550536300221235ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/test/java/com/000077500000000000000000000000001312550536300227015ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300245315ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/test/java/com/iluwatar/mediator/000077500000000000000000000000001312550536300263355ustar00rootroot00000000000000java-design-patterns-1.16.0/mediator/src/test/java/com/iluwatar/mediator/AppTest.java000066400000000000000000000024751312550536300305700ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java000066400000000000000000000043271312550536300317670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; import org.junit.Test; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; /** * Date: 12/19/15 - 10:00 PM * * @author Jeroen Meulemeester */ public class PartyImplTest { /** * Verify if a member is notified when it's joining a party. Generate an action and see if the * other member gets it. Also check members don't get their own actions. */ @Test public void testPartyAction() { final PartyMember partyMember1 = mock(PartyMember.class); final PartyMember partyMember2 = mock(PartyMember.class); final PartyImpl party = new PartyImpl(); party.addMember(partyMember1); party.addMember(partyMember2); verify(partyMember1).joinedParty(party); verify(partyMember2).joinedParty(party); party.act(partyMember1, Action.GOLD); verifyZeroInteractions(partyMember1); verify(partyMember2).partyAction(Action.GOLD); verifyNoMoreInteractions(partyMember1, partyMember2); } } java-design-patterns-1.16.0/mediator/src/test/java/com/iluwatar/mediator/PartyMemberTest.java000066400000000000000000000113311312550536300322660ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mediator; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.slf4j.LoggerFactory; import java.util.Arrays; import java.util.Collection; import java.util.LinkedList; import java.util.List; import java.util.function.Supplier; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; /** * Date: 12/19/15 - 10:13 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class PartyMemberTest { @Parameterized.Parameters public static Collection[]> data() { return Arrays.asList( new Supplier[]{Hobbit::new}, new Supplier[]{Hunter::new}, new Supplier[]{Rogue::new}, new Supplier[]{Wizard::new} ); } /** * The factory, used to create a new instance of the tested party member */ private final Supplier memberSupplier; /** * Create a new test instance, using the given {@link PartyMember} factory * * @param memberSupplier The party member factory */ public PartyMemberTest(final Supplier memberSupplier) { this.memberSupplier = memberSupplier; } private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(PartyMemberBase.class); } @After public void tearDown() { appender.stop(); } /** * Verify if a party action triggers the correct output to the std-Out */ @Test public void testPartyAction() { final PartyMember member = this.memberSupplier.get(); for (final Action action : Action.values()) { member.partyAction(action); assertEquals(member.toString() + " " + action.getDescription(), appender.getLastMessage()); } assertEquals(Action.values().length, appender.getLogSize()); } /** * Verify if a member action triggers the expected interactions with the party class */ @Test public void testAct() { final PartyMember member = this.memberSupplier.get(); member.act(Action.GOLD); assertEquals(0, appender.getLogSize()); final Party party = mock(Party.class); member.joinedParty(party); assertEquals(member.toString() + " joins the party", appender.getLastMessage()); for (final Action action : Action.values()) { member.act(action); assertEquals(member.toString() + " " + action.toString(), appender.getLastMessage()); verify(party).act(member, action); } assertEquals(Action.values().length + 1, appender.getLogSize()); } /** * Verify if {@link PartyMember#toString()} generate the expected output */ @Test public void testToString() throws Exception { final PartyMember member = this.memberSupplier.get(); final Class memberClass = member.getClass(); assertEquals(memberClass.getSimpleName(), member.toString()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } } } java-design-patterns-1.16.0/memento/000077500000000000000000000000001312550536300172745ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/README.md000066400000000000000000000020311312550536300205470ustar00rootroot00000000000000--- layout: pattern title: Memento folder: memento permalink: /patterns/memento/ pumlid: DSgn4OCm30NGLM00h3xR2AC3SvRiaxx2-g59zugtDgiz3qdlomNC-10vF-Lik7BF4A_388PIXrBh-J3OwUOlRuT4EssR38XRa7Ay81Lz_o11_RkaQvcf_GS0 categories: Behavioral tags: - Java - Gang Of Four - Difficulty-Intermediate --- ## Also known as Token ## Intent Without violating encapsulation, capture and externalize an object's internal state so that the object can be restored to this state later. ![alt text](./etc/memento.png "Memento") ## Applicability Use the Memento pattern when * a snapshot of an object's state must be saved so that it can be restored to that state later, and * a direct interface to obtaining the state would expose implementation details and break the object's encapsulation ## Real world examples * [java.util.Date](http://docs.oracle.com/javase/8/docs/api/java/util/Date.html) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/memento/etc/000077500000000000000000000000001312550536300200475ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/etc/memento.png000066400000000000000000000537341312550536300222350ustar00rootroot00000000000000PNG  IHDRKWIDATx{GaOm*UU*rRr8PD"ٲ$`kaX?~\98Ƭñ6 a֒D8dJjMح2 $h7)T=wOy|_}%;g>ӿ3hAVbAV AUhƳFԠ)W~ T!r`1\qE.nͲHI{~ʅ[hCACUe_oEX!|li:8]G bIՎcb ]%Tf<ʑчAl0.λxu'ӻ (*7b\A (S Uezw)xY:+lZ^ BA3VB B B B B B BݣWpQY yϋ_m]Z^6M#.9dCT4ҳq Tb r` Ezy}~oysK˯_Wgٍˣ  PRo_s]|6/yMHxʬ 38\&UڼPNy}{>S˫   n   n   n   n   n   n   n   n  ĺtV]"fg rek*A(A}$T9W1kt=WN6 u2_^)KcXՊ}w%xN rPlRpDFƈdaĕlnJφTI~Y"!{M0\+uҾޘ]\Y/M "'< U\S݆.ѡW,pJم\ǐy$A9B)WBe reĞ}jB1}2|h qqb# t+KPR PU;6Pơ&eJP}6?GqP1 HIi5ezxn})4Bv\UA(A~wdTʮ籒&GBI_Naeվ.z-o&F/\˫  ?BUZ9  rm396}.Pd rPͽ< BA BA BA BA BAj/yu^4 BAj/JGGA(A T_ yedS|,̌"oS©@^87dpN\N~܌n rP%Zҹk:E)a2@\$ͶTIrMmjf~]D2 S8Nڤ+ r Y41aL\khM"5:hk P3ke0&eЪ \ T ]˫"6Sg1dXCs2&P%.ky3yeDn    n   n   n   n   n  NAP"\yPPFhCz6d/ n   n  B߶v/͟z ':QP 26CEA(Ab>\h r7hzA2ME6~bQ"kzd BA%O.d~t'lTmF /R} {  u~zz2y1WKR2 `۔}Cª|Cg BA2G?yo~+_G^e0 ]YQ߄^Yg4I#ՒlRm՞o%LLLw=]ⶓ8WfW}J Pt_|x_ ,֤O+ఢ 3ϤJ$!)J6h^h2-ӫ>|^N BAziם/ߙ{v',ԟyV*ƌT{lSPyJB5k^)u`q BA\|+7=uKɿG+6\|4W0,M ,놴x)L(g8~ -܃Wy~vNd!{L*BlSrb؆R090R ?p큗 TF7{,P ,26 3`)@`їRN^ TY=eU!(2ɮA99JG(M=zL)/ {W^q)JNh3K'#UℒHdҒ4:t3皅LiMiI!7 |9BA*c3@J)[R&2k*S.gMY1m(wPtdl*PI(e#8M)oS©۝Q7t?Cd Լ:ct 1EӜ/v-ϼ$Z]|w)OWц BA2jh~(879]=pn r%FT= Pp Pp Pp Pp Pp E uMM<aVՅ29;R BAjPm֛„MF)8J)Q! BAD)ӦE\ l3Ps0-/ Uo8|﬏vWX&$-iE `xi2kwOfXWYg'o_M~8=œP.̷>oU+sufy3K GwLQg ԿbJG-4@((̄zӶGߵwmM>XA?2GhIReO*Qpt9b>eFU8[ QBG:cg\>|ƶGȏ |u&[7oS1;uRi)nEP?{Ճ޾VTZ*NJy6wt}&lS R2 [BA#ʇw>#,WRgZ2 ,*2!*Sy0C#AE APZZ Q:Bm|&>NδTqV_R`.Wo+˰͜)2 TliiiPP<zyՓYA(A^tgzame rgj2AfM A(A ܰA(A ܰA(A ܰA(A ܰA(ATI斨adiDm~;P"BAjPT֧JrC $K3_ Hj{$ӀRfA([ؤB(edl*KSW7UP̬&_ҔSᕯvGPޕiUWMЗ"ũ$vA(A:B]/;s$?jvC" m&P*n2䨉#];a rPokX[RL%?jvGLI#>QYEڎ$vA(A:Bm;r׹=ŹBPvʖ4ԭ T3Gw  H{7^ڳOo'/ȏ:ձv C5r$+' BA2mpS6 /T+6ZT:j+hKE6p$pA(A^wlF6%P  \i rPyx=M \a rPU }I:/H`A(A#uP@(aP@(aP6l8mA rBAuԩS{Klٲuݻwg}hi4BJ /!_]X YQyPB BE:wt뮻˾Ez=wyĉQPB B{nҡ#/H^{lCqx<ĦB %֭[ֲ'Oܼy31i^YuclH PP`~l'P .83aT݁ %֖-[ftwd??~3όpd J ;v޽~"MÇ9PB BEHg}v6?6;GF=ƆB %W\:y|W%\rYg:B %բo ox'>lԜgݼysv#@B %բC}ܺu駟0ҹ+B %04XPB BE7@PB BLxB P! O@(0,_(A(0$ J ?)B % O:PB B^A P0d/ 0d/ =e ?B %-,Ix$JZD] @(!gݞ*Qt@ Pfٖ-[bE7B %97o3B %ԩS4$_PB BZYYٻwo@(!+ 1B %U s/ T! ^X PPpsLڻwJ@(!07S PZ'Nظq#n/Z75-ri=fd4EK0-c]֨;v޽;9P`Fmݺ59P`jr?~|ƍ'OxRF @(kE<#$_ LV(OuP,6 M׸5*PRϖFtkq) _"Tby`p쟌o!xu~y$F_-!TˆQ,8;RMXGƄC T.{ҎtA ؄맒AJf +I@^3 .ZBבkȘv$-7\Xڑ TWTBP}+ 9֧6y1)q'r#Rp[ۂV(Ou _+TqyP6 fqXuӭ8 ]m@~V[ ʅ7H<*BU^#]J5gGpVn;65F_"\Q / F +@(5*P`jԨBy Q / F +@(5*P&ԫ=zŃ7}w}f$ɒu èQaWv=}/uݸȎw]@+OY9!>I65M7diżQF_&B mO~앿3CG;r92X<ɐ"VH0~)B-TJ TKP+GZOpd?xA̋>JZR|wt+ 3eQBmL61u)x4L(_ʒP R<%GX:_=I^"~/w&OvdhT%/KꦟLWBL 1PlS LW+&$M&cq\یV(OP , @&L$vR1}CP`&tyOlJ9%|!^Z/O9 fk _{.dXxS<-y.dFe*'y.۞R,Kx]&s*(5CnԨByˁPWE(&l7C&v3)4Wʥ}1Pj_̽EQ4\S T;5m(V Zqu^ t\]u gT#9w PrnCسOM(OQo"!n5&!I/ %e߰ UOEWq( cنBa_O@0B @2=&!ZSdH .ڰP 鯠PB)1-(Vm( ƽP T=By+dP`L)Őb5eD&ՠPjPXl TBySC55*P`jԨBy Q / F +@(5*P`jԨBy aiBy m(5*P`jԨBy Q 57/w+8Q E26CEz2jTX<8įZpF_ E IN ,LQ"O7ިQaW^^D+LJG*0$NsSC\ѨQa^}9-d0&jݾYQ Yg4*&Kʊ6ԡgaɟyޔ!$qUYr;_U2ԢeeyݣְOE+嬫Av/+Bs?r/yMTeӆPՓFG1*̷\F%}i.^U~~J@6 /;Bʯ?}by_ȭxv35}wV HU;XVV"܆qE$mjP#͉/}5Y"3Ώ(?JQiR/?iF P[}m."CuJ(OlyلTJ[5W@Zz󦪮U|v-hH@Z(O!۠cP_ T{;#@ ڀPSF_ LV(OP05jTX<BԨQaSF_%N[n\q|\F_J ?Xշ #5*P%}W5P\5*P"~'&W ?jjiZU͆ShF-ɏiݴH4f#( @q>Q jB/>/|H4VHm(uFe6lTdٸn8F_Մ;ƻ^uwI~$ ոTA+s *EDqJ8O Tpm@^ס&|.ߑR(UU4Ɛ%ϓr&2m\+Sh8ߨQaWwlzzqAYG7jTX<Pb.Ǜ5FPV(OkCO]EHA5jTXڨQaWG5jTX<BԨQaSF_ LV(OP05jTX<BΟoO]F çH{aBu@(Oؔ2閥) >q;B9P]_26єtҔ6j]*%@. 0e8tLSg%[+zք@@ @͏zƦ?b2P_26a)}tTq[.Ʌq p閥J̗+;kyŻ*P_-شw8Q 鯶\'jTXO/Ebc9uYr2H@Jˬ ۜSGp˨QaWMHLU$@uGv*ŤT/=$9T*l3:%UF +dl:Dbbne|%N.JT!ߠ4TEꈻV5*P iAڜc'~] PϹBA<(c>Sݥ/fm$2Sb5eLtxkgV(OشdR(kv2TZ(QoP@R^igTކͨ{>J:uƍ_PB R EDD EP@ _(A*O8pu>>gPThCںuZ@(!Nzh@(!?qF̆YL PThC)0 J Nˇ}(߆ZOUfì㢇"Tw$s^ۼyl$ O8ۀjP]*vy㝞B )*)UםvVKٺ],+կ(Q*vuE=oCuOk̲'F}O쨺*>ՠE;zJ h'FT\ A*JγU5UbjE56<$Y-Jec!ю;vmW@" E5q(V$uqĬmXOڲeq6ې0X P,3iÞ#A(hms#\/^M&Rh/ ~Y=bU V,BmBACx;ԆC-//W\g;6NN{GRʻ\,14\Bm޼yT%L}J:jC_gxKԯ`ezgqSӸMԾ*:uUgb)Bk%X!y饗>|騎=JφQ נK3?y駟g{>6 נKАr'294H4QN ]EQʷ~'Nlܸ.$x#KP_?cN%_X ("*_@C'YJ+++{-$t#OJ%F EmذA茜~B)~6$9mbyk fKVnyV@V-qyl~g}#Y~JM_Rq t)[q<]cIx6lxi7;UlPMt{*(qȖa}:״8#h8%߅9f* Gy~g^tmPo%ii?P ]uzlubK3M}̹ۚO8:ZA(Cg A;djpA(Cg Ax/?r7]$yMD/Z?oO}G˟5Yz{Ƿ3d Yfŭl#68bqӛش }嵪z+0=qߟk< EDm'е/#5YBːb fBX˖\M0_~s&3eH{P6gTs4.}^}m]v%mF%0f rS\OM&fDdiPR IW@<_8iLݫ$<&m?L&jBm7<ɋ~ϳuzx??jO)*!OG2,y1]qs,DP+,v4^Zs\=Y/Hq7_PN~/ʜGyȽO~wKk> Ig'x4L"u gZjB}~?#uُ_cbtr(fxҩ$HMiOC_msgʏT~JqjG ]~AP/?34:5!qm5iQwΘϴ6zӵ!B]}gy/~;2R`P鋴'qy1L{9rB4pHք_Jj+*+PN&WB,{ڍ:P^O&TL#MSimt EG~/8 ':d>Ҷe|OLwr UI(/Ats;L0imt 55[_+:O5YBÏWs"ܨğC&BձHӕOQ4* ŶعAz1~i%qF]ُ>擐H:MjhT 7O=ngv,i).w-eMg_g>ȎP隓MS4xʔj KizyB9sٙnb<.w-p>'զ嵸['Մ">t_qc;~e7\.yWǫ3ZF^rye&*WHyt 7ݬkޫ5yP>rK8IAz^tmr+?۾q ,$|[RW^.U|y /Jq#4[mPH]/vzCK^%j: Y+ƶu4whδ6d¯~(5תjv}}\Nc^آyy A(8W^YDB#k<*уPgjkZA(Cg A;djpA(C ^t w7kU{ܣ3VPQ*U3VPI!Ymm:}G|68MǞ ^&f/&P[R./MƁopFufξjs6ab*d{v0}VSrZ.$g3Rl/w׋ |嵪 =%[~s엗ţ F~firv=*zZ ΨiJȔྛ;}>Bo;c c~7W^A(Q1_BE=q:.mc FkU73*{J(q1O S,z>1dzر+sg'n ZBጊÕdC_N!? A/)ŗ|LT|jqFEp kwXgjpA(Cg A;djp]ڰTH!-,|NhCu#xA(Cg A ӋG_%&/U[g_C?FL^o=t‘D(¦}tZQ%p[Ze T!C mjp*{yi\XsgoUdV5;7H̄sPs'U&IBRP,尣Jw0%Aơ~ SB+ۄéߚ)+WJPvn0Rހ:1R(ǻI^^re-SI)]Q}*@.*YcݱM_v;ؼ>{*BAÔD(jB9[H!%"P)Mzj6;bZ hM1PTr&nefMIÈ wA(( H)[ ?Z)ueV[jGtr"G%(5ŗPt(T'cimxpAb巳nG#a˟P},~j`ya*1 PP| P _ 3ŗD(dl¹A((dB!c BAe T!26e zy4cSZN@&ةn4yDTaUsr>A((dBTMQNj0- Rb~My;22zbZ'W8)c2r*&NX "L#8R=m BA%!c3qKʬRS= BAmD(Me/v|$iD{ؖjB*S=m[42:c0ֆr p pk)}A|PP|U)6˓ m:(S={'ŗPʌMⱗ) TOB /L 7{N\*0\OTO?O h -iȁ_3^S=_9 y |PP|P-q s>A((ZDNYo]'W _ 3ŗD(dl¹A((dB!c BAe T!26e zyeƦxwz!{cBeH*Lԩ~&r+(:G:p U2cSImp|:) 4 tq':A((*ǡ36ٿ咪Yi%gyv*fnuPP|Ʉr23;LkH(CMm tJ:A(($BQWgl25 6b_6m %lxVAM_z\q _BUglin2SOOw$f;bsssP''@j7@yctQV>2P[ BAe Լ2c3?$~IFʽU@Q; BAe&&v<ԁdi162}Ȩ(#cAM; BAPVr W8itxV%re]Ҧ BAPV 8>E-C%yUګ6L Wfl"Gjn۬Fʙk;V+ cE %  b<%M 1i7þedCKeB)jIɟPpd /d /d /  uM87ŗL(dl™A(( *DB BA@/flV敥 +6hr-[b /P36,0X, Ի-1W8)c"XՕ jp˖K&CƦz\UxjuaC lA(( CUglVJ*ҰAS][eK BAe Tubs}傄Pp˖@{yKc/lA(( Wfl.6RnH\`-1ŗP^nS"w0ܲ%&Wi*V0&X68p˖ˋPCpp˖ 2;JeK BABi/ܲ%`A((@(Xg /P؄sPP|ɄB&@B-dl _ M0K-VVɜ.]h,R=A(E U=cS*ndN[ѰYzPPT9喱CaJ#Xl E'G226źJR b-vޣaHH""2fKbhdN-f{4l VHƦCE-Eև>7_fFU7AUL[}h '`\fmշg4PP| mkǓ䛮}?6J\$%veyٰRPSWﳭ ]4ŗP?ч>rƵci|l\`ZAZѳ/FJF sCB= PPXW=kncۆ2'(PM5l+jBAa#ʇw>#,W{lÈ .JOWƒ^K4Rg[a*=А#Ԇ˧JkV?6ar<ݯhh]d|ɒxeM+< 3*9 YHaFj5CPPXP`yan<>u Py7J3mQg[e=1WK  _ 3 BAB:PP|P _|;SeCGPP|yʢ7o)$j*HhHc /3n~vO|[[&/+T-[v7#PP|u7#/ȏ r&]p% h,i?g>ᕯvGPlz-W ̷Lf BA#O1Ү;_3N#Y%.WD|K)*ޤKG7s5O-o&B-@WG4d$W[fo BA#Զ#w{=λI^{`,6/|KUH6{c /H{7^ڳOo'/ȏ:b<H8TcI1ŗnlvyZ T^K\$嵼fWc3),jHd JoisOySGPP|uP|by>/Hzc  n _ 3 BAai#R Q AAP{BA^iDUh1IENDB`java-design-patterns-1.16.0/memento/etc/memento.ucls000066400000000000000000000102011312550536300223750ustar00rootroot00000000000000 java-design-patterns-1.16.0/memento/etc/memento.urm.puml000066400000000000000000000022361312550536300232170ustar00rootroot00000000000000@startuml package com.iluwatar.memento { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Star { - ageYears : int - massTons : int - type : StarType + Star(startType : StarType, startAge : int, startMass : int) ~ getMemento() : StarMemento ~ setMemento(memento : StarMemento) + timePasses() + toString() : String } -class StarMementoInternal { - ageYears : int - massTons : int - type : StarType - StarMementoInternal() + getAgeYears() : int + getMassTons() : int + getType() : StarType + setAgeYears(ageYears : int) + setMassTons(massTons : int) + setType(type : StarType) } interface StarMemento { } enum StarType { + DEAD {static} + RED_GIANT {static} + SUN {static} + SUPERNOVA {static} + UNDEFINED {static} + WHITE_DWARF {static} - title : String + toString() : String + valueOf(name : String) : StarType {static} + values() : StarType[] {static} } } StarMementoInternal --> "-type" StarType Star --> "-type" StarType StarMementoInternal ..+ Star StarMementoInternal ..|> StarMemento @endumljava-design-patterns-1.16.0/memento/pom.xml000066400000000000000000000033601312550536300206130ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 memento junit junit test java-design-patterns-1.16.0/memento/src/000077500000000000000000000000001312550536300200635ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/main/000077500000000000000000000000001312550536300210075ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/main/java/000077500000000000000000000000001312550536300217305ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/main/java/com/000077500000000000000000000000001312550536300225065ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243365ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/main/java/com/iluwatar/memento/000077500000000000000000000000001312550536300260025ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/main/java/com/iluwatar/memento/App.java000066400000000000000000000062201312550536300273650ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.memento; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Stack; /** * * The Memento pattern is a software design pattern that provides the ability to restore an object * to its previous state (undo via rollback). *

* The Memento pattern is implemented with three objects: the originator, a caretaker and a memento. * The originator is some object that has an internal state. The caretaker is going to do something * to the originator, but wants to be able to undo the change. The caretaker first asks the * originator for a memento object. Then it does whatever operation (or sequence of operations) it * was going to do. To roll back to the state before the operations, it returns the memento object * to the originator. The memento object itself is an opaque object (one which the caretaker cannot, * or should not, change). When using this pattern, care should be taken if the originator may * change other objects or resources - the memento pattern operates on a single object. *

* In this example the object ({@link Star}) gives out a "memento" ({@link StarMemento}) that * contains the state of the object. Later on the memento can be set back to the object restoring * the state. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) { Stack states = new Stack<>(); Star star = new Star(StarType.SUN, 10000000, 500000); LOGGER.info(star.toString()); states.add(star.getMemento()); star.timePasses(); LOGGER.info(star.toString()); states.add(star.getMemento()); star.timePasses(); LOGGER.info(star.toString()); states.add(star.getMemento()); star.timePasses(); LOGGER.info(star.toString()); states.add(star.getMemento()); star.timePasses(); LOGGER.info(star.toString()); while (states.size() > 0) { star.setMemento(states.pop()); LOGGER.info(star.toString()); } } } java-design-patterns-1.16.0/memento/src/main/java/com/iluwatar/memento/Star.java000066400000000000000000000062731312550536300275660ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.memento; /** * * Star uses "mementos" to store and restore state. * */ public class Star { private StarType type; private int ageYears; private int massTons; /** * Constructor */ public Star(StarType startType, int startAge, int startMass) { this.type = startType; this.ageYears = startAge; this.massTons = startMass; } /** * Makes time pass for the star */ public void timePasses() { ageYears *= 2; massTons *= 8; switch (type) { case RED_GIANT: type = StarType.WHITE_DWARF; break; case SUN: type = StarType.RED_GIANT; break; case SUPERNOVA: type = StarType.DEAD; break; case WHITE_DWARF: type = StarType.SUPERNOVA; break; case DEAD: ageYears *= 2; massTons = 0; break; default: break; } } StarMemento getMemento() { StarMementoInternal state = new StarMementoInternal(); state.setAgeYears(ageYears); state.setMassTons(massTons); state.setType(type); return state; } void setMemento(StarMemento memento) { StarMementoInternal state = (StarMementoInternal) memento; this.type = state.getType(); this.ageYears = state.getAgeYears(); this.massTons = state.getMassTons(); } @Override public String toString() { return String.format("%s age: %d years mass: %d tons", type.toString(), ageYears, massTons); } /** * * StarMemento implementation * */ private static class StarMementoInternal implements StarMemento { private StarType type; private int ageYears; private int massTons; public StarType getType() { return type; } public void setType(StarType type) { this.type = type; } public int getAgeYears() { return ageYears; } public void setAgeYears(int ageYears) { this.ageYears = ageYears; } public int getMassTons() { return massTons; } public void setMassTons(int massTons) { this.massTons = massTons; } } } java-design-patterns-1.16.0/memento/src/main/java/com/iluwatar/memento/StarMemento.java000066400000000000000000000024141312550536300311040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.memento; /** * * External interface to memento. * */ public interface StarMemento { } java-design-patterns-1.16.0/memento/src/main/java/com/iluwatar/memento/StarType.java000066400000000000000000000027551312550536300304310ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.memento; /** * * StarType enumeration * */ public enum StarType { SUN("sun"), RED_GIANT("red giant"), WHITE_DWARF("white dwarf"), SUPERNOVA("supernova"), DEAD( "dead star"), UNDEFINED(""); private String title; StarType(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/memento/src/test/000077500000000000000000000000001312550536300210425ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/test/java/000077500000000000000000000000001312550536300217635ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/test/java/com/000077500000000000000000000000001312550536300225415ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243715ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/test/java/com/iluwatar/memento/000077500000000000000000000000001312550536300260355ustar00rootroot00000000000000java-design-patterns-1.16.0/memento/src/test/java/com/iluwatar/memento/AppTest.java000066400000000000000000000024741312550536300302670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.memento; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/memento/src/test/java/com/iluwatar/memento/StarTest.java000066400000000000000000000064271312550536300304620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.memento; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/20/15 - 10:08 AM * * @author Jeroen Meulemeester */ public class StarTest { /** * Verify the stages of a dying sun, without going back in time */ @Test public void testTimePasses() { final Star star = new Star(StarType.SUN, 1, 2); assertEquals("sun age: 1 years mass: 2 tons", star.toString()); star.timePasses(); assertEquals("red giant age: 2 years mass: 16 tons", star.toString()); star.timePasses(); assertEquals("white dwarf age: 4 years mass: 128 tons", star.toString()); star.timePasses(); assertEquals("supernova age: 8 years mass: 1024 tons", star.toString()); star.timePasses(); assertEquals("dead star age: 16 years mass: 8192 tons", star.toString()); star.timePasses(); assertEquals("dead star age: 64 years mass: 0 tons", star.toString()); star.timePasses(); assertEquals("dead star age: 256 years mass: 0 tons", star.toString()); } /** * Verify some stage of a dying sun, but go back in time to test the memento */ @Test public void testSetMemento() { final Star star = new Star(StarType.SUN, 1, 2); final StarMemento firstMemento = star.getMemento(); assertEquals("sun age: 1 years mass: 2 tons", star.toString()); star.timePasses(); final StarMemento secondMemento = star.getMemento(); assertEquals("red giant age: 2 years mass: 16 tons", star.toString()); star.timePasses(); final StarMemento thirdMemento = star.getMemento(); assertEquals("white dwarf age: 4 years mass: 128 tons", star.toString()); star.timePasses(); assertEquals("supernova age: 8 years mass: 1024 tons", star.toString()); star.setMemento(thirdMemento); assertEquals("white dwarf age: 4 years mass: 128 tons", star.toString()); star.timePasses(); assertEquals("supernova age: 8 years mass: 1024 tons", star.toString()); star.setMemento(secondMemento); assertEquals("red giant age: 2 years mass: 16 tons", star.toString()); star.setMemento(firstMemento); assertEquals("sun age: 1 years mass: 2 tons", star.toString()); } } java-design-patterns-1.16.0/message-channel/000077500000000000000000000000001312550536300206625ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/.gitignore000066400000000000000000000000111312550536300226420ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/message-channel/README.md000066400000000000000000000011361312550536300221420ustar00rootroot00000000000000--- layout: pattern title: Message Channel folder: message-channel permalink: /patterns/message-channel/ categories: Integration tags: - Java - EIP - Apache Camel™ --- ## Intent When two applications communicate using a messaging system they do it by using logical addresses of the system, so called Message Channels. ![alt text](./etc/message-channel.png "Message Channel") ## Applicability Use the Message Channel pattern when * two or more applications need to communicate using a messaging system ## Real world examples * [akka-camel](http://doc.akka.io/docs/akka/snapshot/scala/camel.html) java-design-patterns-1.16.0/message-channel/etc/000077500000000000000000000000001312550536300214355ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/etc/message-channel.png000066400000000000000000001341601312550536300252020ustar00rootroot00000000000000PNG  IHDR'<87IDATxmkW}7{GWWΛo#:T3V91R ԁBNkpӓ'0V& z"*L4UJEf^{`{O#k-%39SQ./T'] ?HBРAz@uTH뽌ayAI,YA@YCgt#4XF遲SA!Fh$d e˟ICHb "L*?Ē54HE :T^usD !V Hh =Pa* ԡF{a]t1:i54}44HEu>эp=Jt0k\<~=F' 1F/F遲S5;\{:mzٮ0O"'侨exq8\4HI<4}4h(0YP#ذ1vzWU7;&F2]4BIlmmU* ucFTackg4|ϴN(0+oXCW}_sT3y+ŹZcqͺ(Y_Q\ck#(eW?Q?cV*![p'[ΎV LHT37Dq%'_4 <,T:>_?zk̋|wI^ܰáƕ6W%To8uYT>hpݣm̊PW/j׵KBf^i[YM:ೌ1^7ob/g`6>H(۩ݒIfRJ4 wj,~nO3)B7n\Go]_g jSQrv?_i^{7} &/ͯM77,;ug#sE^!|ӜGBR*`4]#GT%[[b]c!Rch_H-Já(F7\F d%y}tgqwAf^砭ͼ6>W8enKXZ|qUzuHIns}MU)js6A Zl hez59x,BFpubcŃdP{Yo]5l[G>TW%xV^i_17<+]wjL^ɛqejPLo{YRi:i̫(@1)MH{>NRe?~͈jUQj/fC D~X4F ĖpPŃ¯CfwYNښy0ӊe֍$M)@̋Kur) AC}P1:`*fܡİܠ:0S G<֡Z82|bBu:Wwΐi 1цT֪q1 EK@!sCgI,YvfJTvw( ܣIbj{X :W :T,ĒfXL+L*?Cu@Hb+L*?Cu@Hb+L*?Cu@HbZ@SkՠXYYQնE~$]9pйTC2ڿoK_9רXWFµ? 8RO}r6!43vKHiIw>7ڪj w*44b$Fn_Wnu +LEBjT:3 \<[VPrus轝UX!G_*Ahy8q<5WuaWgHFTW2-4b$FOo^x;cuuU,--ɋ˗/ommC`nйT[uuS!YahTWl[F!݌~ї[+='k+rS*~B|Q}?SL: Fh$ihlfY.www QZMy+ъ"ժЏ:W7zdZ' ՟:B:"ƙo$\E2=L~w14b$FϧA_YY8991TB!Hl|κr~2ju/Ji4z_ u6h LEUf)R{rCjUsk.Xiw_MnL1F 1H#IGܠy=h`P`*R:"%2 и4?nآO F.z'g9 2R+Iwэb$F/Ak6JE+BSz٢ X.b$$M_-bFsBS5FO7F 1F@@!HeaS/$:GэXp&P0\a*PbFKUPnX/P: :W :T,Ē1U` #jXh0QsCgI,YOu8@|8vwB S@Rtł@# A+M:: p夳y鬯w_wuNNN$u]֩jfS>{19 %ftj?}l@/..nmm{jjI0;aR( D~N @f`&튯_TbV<+|UzUpȓ%on;z%:myyY fDiCP T@!bC|\qtƽKIϵkDKnZz]a9;! ӮJꀨ:2c0j\.ɉĹ;]/rp7,s6ܡiWڄ7uFI\+ü+TDX_VX;N1.]rFӽ«ިpEӮ_`P2cqyGAZ``%9za荼|w$5 sB5nnn"~q%q]aDj5[ ~CgӮP0(d0"b@@lڏQrU>Ӽ wXs 3+ qLͦ:f7!R M'9zg(~Q􁎞+p]ѿd:Bnllz[H^XYYް\wIn+T @Pod;JEDj:CX__oŌ]=d:@ͥZ6 ~daɍ+F`$cCM*B 3NS.ќP'^-9TimllGc*Jă ir 30PLJZ #"oq\\\[oF\+ Tf:@^-zy^˿˕JRr9b@e uqʫGM,:88XZZ;;;"DolmmɕL]Q$p`0sPg~E@5;<ӭ˱o:dCTV[XX6rzዄ4TJ u/-- j#nw<rF0(.+`\4HPd;NHIz!NwUvM84T@JYYY a\.'M q766Axi p\MGk;zC ɿlb9|&LtR ST/_l6 yr Wu.͏˥K > P)X[[Kd7@ܘ܌9g{A4FZ^^H GhO7 P%`sIT|> )T3ܛussSv^7=7666T{ޓ{+Su#9;aw)V/qP[⸬7;3"ucF{s*&7Bk}cw=ι&P:]<*%?p)vu=a=Ŀ7kY^^jƛ;;;0^JGR]WKYuhcp  լzO &:=mw? B^ 3FW6e'Y/jUmhs@23<`*MJGua]a jܛZ&d7D0L닃<2;spbZ6T*^\ܜu[3 8@eH5s/,,dLcq}uʹm\E13gEW6E3!b8Pf\.GuVW@eH;;8r͟x =PjU{Q f[3>(T@n2C[a-:o]}Ҿ^${je!%4ϝ'ZV^1BT@n2d<2=jYϖJIMBsk1$! Tf `1s!ެJoĸ!.Yo@eH7._F U1r9 P VWW/]1"C:f>{rvvv?kF]:r q)H7zjFMj:@eR.3FgxٯFɱȡh\E%T@^2CAd/c35NgyyV%5Aw+#4# Ձfgg\.WBL#," Tf((ThJXHnE%Ԥ^n`@e@u@999 >Fd  D^HpY C3PPP( ~Wr3\M( O3PPQ+sݸXc\x~ppPՖgۛ Tf((SuQ:>LLo: me׺#qozp0 \ 颎 GPNRjt#\O+csH+UJo$>Ci\D8IȐn`Cu*3qe0/;Js]wh\q# '/*`\ճ$R0sJI7QC8 wC[%zJo${b$i 6;D3PPܪcCuQT6km`.[^>qw)fl.[C :F:@tGQ2&je/hq UJo,`bbjT*3f 7P=ᘳTd@߹+pUᛖQx5 eXd__SzcvgJ̇4TYL3PPܪ#o+ vWi0Bh uAd Ւ.8f._rC)˳)Tf((E؃AR W1TusH]D]:ESa5 KfbVVV=t.0Tf((SP݊J&ZĿ 3a=Lk9 .:hi+'''iRE2{PЍ,ZFVdT.0 Tf((Es +6M:c3S4P͍',Xŵ~ȠD[ղ7,z/l3?PP 剹Se Ex X]]]^^ݝge֖QY\\16# Ց7.Vuߙ)(ŵlޖ뛛cnZq||ڳ&CTӉ+6# Ց7.Qo֮VuĕoNambeɉ(`uuUQr9 ی*3TtkcuӹTj\q# m>=vcmjY۲r<7ѐ52QWkJkʊ7(Zޒ SN?(l3?PP~_7zj?sϟ<#J~|„cCu!*f4|yq2y-Wg71y/ᦲa9yqeI67L:#S2:}}0 /A c>>J-*]Dq;//:2K\;)l3?PPBz|£{WO\N1΄Auđ%T$$4ᘳTd@߹+p1fiie'QPO8)U^]63:1@2CA w~b+-K]yW8= 뉫鳄ꘄ UGtWXwalOuZDXX뺩`]G*/EX>'''KKKj h ی*3p.ݽ b}Uop=g_m|FtzlZ?ʠݰ%GwMjWufs_AuL:_+{Q=h`(i0^?\?8eNԵC]49=^߻|?Kc\K.26# %/;}ϭ_~W_}qV[rS݆睡B;,DTDZ{\D0TvV܉a5>$Ƀuz}uuUVlll["6$r-W4 mF J_o~TO}G+oqγ_8@Mz&ϔ~<뱅fuӂ Ȍ쯜PX\\ͦj* dqqQnYXX[""Z41Tf((~l*[b*/|W^+qM:^>ܠ:0 Dh޼yo07K{h23cPYי2p @n2CA ۭkQB rE-O^rUsΰUp!׎] W,ũ:Vw]@ud [\g͔;}*3?q~lk-=g]V#m@|;:qN-6O|fXLю_PaTGu~@en=wƻݷ-O˻Z`>c[* V^a\= e59Kh'ZMPaTGuLsb @n2CA EZ\xsr)9^6yJc/:z._ޤ;g7ՑE+lql1PP~_mg?+W2duPYtpp0. 7nvt`|?=[?=FBu>Zz>. %~aBJmJo(rE;C^qN ?%ЦaNNNƽ 7P/̥]HUiͧ/}{}YLŒͰdFa2JZ*W.Ǻ 7P/̱]HOzGu7?~MOzcb*{WWv֝g8 ﻮ0|`y&0FC+lq3jDPP .t~񎛟%w ߕJu~㞱 +TcU,u1ve+ tΙJ=< @n2CAI_n}/M p#称BzJWu];_}>?k"v'XXTh`F,CCRb-\.E PP#ktG?7nՏm|M᷾#rOYy7d+ VoWS5Q::NZ 7P{-T\Z+~\t=縗-z$p-!Ýk453sZd}nQj TG Qb[7=}/v_px0a5jrh1$i-g]r J_(/\ĝ}RQo.zC=aB*Ahy?6vfD^}+ :H >pّ='We_1*rk&BժQB*3@?.ѵ_]CpZ+dr0oѝ9[rDmEnJFTط_׿n~s[;Eُʕs*tq-_7LE~ \p# 0 U|qo?5mW$ՇM!{4cBa#c$Y=~1D>eL% f\.It8QQ!g*A%g>mj7O:|:bmUǵWvꇮ_<{ߢMR~ 9ƀ׆;DGVzFK7DTR>d`qw>[SϼLJͯ|T}G1Ȁ~(^H4/ gzD@>c!9`% 3\9KOHޭ}_w&wutSco$#'ޤ:1 /EunS(QC(٦:-Μk>ѯ|R?z>+:5ɝxb&wbgT(αV:dREZ3\y>wm^Z8%yZ9m볁=Ϟerݫ͢=ywz;:d(7j޵?q}6 :hPMDՁPP4(ՑECu@ѠdTG EmPY4T J<@AudPP4(ՑECu@ѠdTG EmPY4T J<r5ޣo!OtiHRUGSNb5 %H{hl襼MCu:P⡈1mM]q|+(@f!#OZŸkOi !!>w̨_t}nQڝ^W{US(רW)|ACAuz6=W..;\CfTuR{R$ΏC3+Ϊ?Jد^!#(2-E/("x("6@ݦ%k{k0xWŬ}ap2 +cEsKP语MuJ_~"HEEՑ4;]i& 5&=q 8Ĝ(j#+)|ACIFm={!m:6m^cڰyhºrRs5E@uDI %HU=eϔeT@ވ`w][$h1iԖdfa^)1HBW7ricpf{>cs~" !E-Ƌ\ƹ1m4mZ'uX,FEEdcsm'Og>8gv4z80EWt3`6m~JhhP⡈Ju=5 }h0Mvd#b$a35w/dXFEE$cνY}6c8a&a YPY4/(x("Xa\aish{0T`t%,!یEȺԀȢ|AѠCW syX }FS[8#ѥx=#FEE$-=7lc+0~O $V0maa%%]p 6RJT6P뮓Igb#71VKM:#tPDP1T@^999YZZ:.tPDP1T@^iZz]e aCAuPD tI w:l("25y%j7l{ w:l("k=7?R{Ǫ7}GDuA{E3T@:z#p@Æ"2xGDl?{n(׽@I X1}谡:Drx3|?ow? P!}q78Mp(6˼:`􁎞::tPDR^}Ǫz+5J>}{ "mX Œ6駰: >TGC Ed,qw>[S~{;y=9;*]y54Q\Az8?! $6T戹Z>px |5}tgD@e"2xP|틟zg'?}-Wjw?va>E-~p58qM e復͵5cͺC08GEdO PrX+}n|?"'_G/Ȼ6v0qŮcB~7 1 hcenT@2CKu=ܧ_{ߙ3z{G>O_yG/g]~LRV qrso=]T Q %[Ή^Fc6Uh F7< %:l("%<~ҙ[mG/_y-WC{fbzT!ݫĜJpޜ++~orn|˛ W` =D0;h=/Ns8Hzዄ4T?8:l("UGo0ꭟk7~6{{mbc N_ܸ[W^;nH%,o-rQ%XJ.Zzs}ˣsL P:Z1( Or%b aCLu\{[E|k>B3 WE_u8R H@)`6aCAucoPę' %=3\_fOް,!).3a{t shȿ;= >`:)c 8Fc65TD m 谡:rc Xлzp/< ΀o 谡:rc.,$ugKD*¬:t>0=9v59:l("rXch #Ө7f̉s. :l("Xtձt._\TL xEh5 %= 9w ?7.E[Mu{3 ::rc~ƨj+++\.ؐ+[[[s.r!w(Znİx>;Mu/ D{X@f2CI۝P)͏O6,D4f^_]]]XX]!/JDAu*3TG:~]X__oZ"?~f1Ӏ Tf("qe4?kǭإ/nzbkRI o>9p`Ggh%s ^W{UxShf6~>_NЯp>LGu||O=T_mmm{{{e bPD\c3t_;p-R+뎾RTT[ސIPD^ICGߐAueb=x/ v.ա~ӽjvr,g^ P Eĩ:twv;\m=`zp0oc\9_[R1』YuxP!OW'?) V]|Yͥ$:rCu8\ۑ=fab waGHG!3H̹:<%=};'t1ʯAu(:ZvppzKԈ!eqqqaaA^lllx@:rHcړ{mzoc4<UaI;fC{0^ Q z]͐F\!nԷٵC 7PD[aA:ܞ6h<*$Cq -4+`U3`#/Їh\߃bXj6"WBK>t)y!nnnAu*3R=>(@wp;&Õ=pod ߸KﻦUGP*N 䜻HҾo~/'W,( =Doxz!K Ħ @e"Q-E4#9::닋yDdT*`:0DTI@#PDT)ixv-EcX!pt!"ED,q"% dq*3:Yj=Qjuyy<=P:rcHDllnn!Bd6:P:rcHDX[[+AVVVjZٔ,>٭ EՑ˓G`@8@2C888h6O r«.S5]}cJ@eB 'ߤs06م bccckk" y̐N:UՒ@(-l6lC8 7P!/,,(lT E@ .Tc}̐+766۝B..Cj*Y̐ Ɲ0"T*`gBjAu*3dyL:# .A"DH3Tf$GGG<QjuyyY>Q#R @u*3d q ,5"6677!Le9 Tf.C֕u$> @e#2C<H!+&3 P idooO5 +nmmmllX3ث̐"{,:4zD&̐<ǽx'IgfTnl6岚e푕t :rZ`@1ݵOOh'P9 DVSg,E,..Y6T@n2 /ć EȒcmmM?pssY0'K$0j jFV\Afdby\~M __taT̐} *J|fd-,,,..ZG`FVe +1r #}^ NS;́#: P!6Ժp777Y#=:\.[GFS|@9xX[[[ZZ/H3FYG/,,HfdtT r vnZIBNW3D2I3T r c#ڊjwww{{TԌfYլ::}m]TJ\78G40tCҒIg`HN?uutN*+vڕ@ud1srrm0E::RNŌtF(y?>/!Q5ѯ'gc`ccC=ArGYt5#kV}(u1fF9tHx]?iI .OB~QS@97ҏ*Q-Ռ,'hKSCۨ+:%D}}y HH7Gu 8%8xѲ1`"(`kkԩSk&̳o8@Ȋxtz2oR&s>"E1_u#L]!fscc78ٗ=pf4jF::]Ȫ뛛ƣ3;{ZWvet7KuDaeDQ f]JxQB9..'''۽AG ::]Z`5 p kk0uqU7+<] K(DY0G(EqmP snC-U~a4Gh_k+Ht)b0^d+B96GGGZ-rhZ"6vvvz&nҡ:yƀJ&ZDxJO$ʈ: P3Vpm5iXq0ll|@9*NGAە0jM 7 +:0eLjժ5Ejqqѵ\TS|@9z]l6{T272 S|@9ǫ#5yMo Hؖ :0ev9._S ?:88XYYv7~78pG1 PJv9uKrCZ-״bB1ƌF Y SF ՑRӛ5gXR23}6d+w/J тA>@uԬ&fcc#9JchِE ڃ?"bc{uCugn8r۾|~_ۭ3 68zb'4&ٷj7Ǣ:$B-Lq8Kʃ-TGJM~Us(Ƙ!kc]_<{ߢMRN1F~vJhQc YwZ$WLm18X)5a3Ơ&f2Ү:  A;ӭϩwϼLJͯ|T}{Uj4>h:T=]tZ2ֿ]1&.V.5`_wMʘ<8㩴;x_{j_xk rCTxiMd:&M+u!BAq5hgZor~{}O%vwJR{k/v=sk S S*~9Q>ʙ<-1hhIs#Gu@ΙFuis=V\&x]`411~1Ũ ae~Q |K/ϴ^u|^{Muɋx?r GTǠ]r{ކ HfM6x=k?Դ䆪CW NЇ^a G~sʹF +%c[]whgEs1Vr=ɨZ$FHa%K)Ξa:zL88.̼.bT("%X6{ȏrC*䵫_{~cu NW?0`NN #'j{axE}!b73OCu@Suu]i'hkapR3>]a|b$=lݯQ hGޯZS}~6%8ݭdd')n"X0Q w>y UϷɻ/|ݾ>~v;wrvֵP}XcV/{<53t1lv"~qu㧎:PgQ~s0Bf w_7y4/Fi9Ee˘qN1N^IbQXb1*dWv>x[7Zj nV#7WÏP䇍a(H\#'G&Eu}q2ϰ 15Na$l_rɜ:\0Fp9Gq|Ғ3bDMo}t7ju$ƜTuau!BA6hMh<5Z<܉:XyIRԅA, тA>)F3chT("4h2Z0MdP1Q Рah :Rj41A1ƌF,B)|HL3   #F3chT("4h2Z0MdP1Q Рah :Rj41A1ƌF,B)|:ҿn>ҟ՞?yF^˕k`&f2(ƘѨPE:`L|@Z0!㉿xiJo(rE+FwtfX:_yVfOf<QgIC41SV766"e1痝Ei;rELC]oO_xtI+r·w,RpDfu||~fx_ֿTg^uPfG|zN7JW5*֕QC}7Js5-! )o4KZr:m|u_XGhyvݧۯ7?'.u] iPUau5.Fo׉d2]FZ(wvvϨOꬫ* KuH9iV5t[#@ɥ:{AWQo.zCaB*Ahy$+Ώ?Jد !{@u:6z;n gQ ؃v뚳ar=Q rZc3\!B~zq)9ӍyFEe@kO|W\)u4>i8p}'''[[[Jeii8jfX/KGn%X틍ۿK(*0 ~ѫO+le~X* `QZQ+c}(d Nc-9_[R =:|U~2|_s_0-><6*;g4#hjV-QO|Yr:/D3{ayUU1:E"T(G\*30J57\|>քΜ3KR,p\xvd̼mߜsZ.Bq빜 -ByӂYMtM|q{mokhbt!t\-q(R=ι\9jJTQ;U*06hX AKo}okg(?]x ̽({x>by YՁ)|:D&F`I3   #F3chT(z SF ՑR 1f4*dNj@&@ :Rj%cFBAj999^[[[XXVGGGIgfooOl._l P)5ɠcFBAi%2ԩS"9DxD\6O$dAdP1Q %ZU/_I:Gfȋ4h!:#4chT(H}qR^vI(݅ć8 g:Rj8IA1ƌFDP[QX^^ձt"qtt$9O:6uItI\ ĵA9"QGIg  :R|1NAe~P0kRUD s c`Jq1KzR{Q9רXWFOȐF׊\}zpM o>9l`F9N[2>7(N*Ps'9A]U]ŨP0#2U0666䟩TG1r5\<)PryZ΍晩X!%R$ΏCqWZ{fRTPI.̮.bT(Jʷ dyyl& Өخ~5<"= i9o1fEsKP语M: !A]a]ŨP {{{JՒq9>>VK8Dx$` $F=d󴺣GwGŎȃ=-gsHdTuau!B4t]U\Ցrpp '+ uhr͏c[L!x!cxZTPIͱ̍ tjjH 1u{4iJ\pcvHm `L-4+`O+I)[A].bT(ڊԩSjukk+s[Q Ef: ri'yԮ>.{SH=uӄcf甒wMi{Za$͉Tuavu!BA0⎋/.2caaAmEtSv8hd'#9٨ I [Qgw+`zvmLU`MSIBF#dTd E}!Eh5yvvv* zklEf)Rҹu< Ax@&@u@a+qIYU?H&EPNjE0H)BZmURa+*[^^.@@>&OkkkI 5UZ! &[Q荂ϧb Ā  rppt: "r@#T̟}:d(v4 $ c$6BP07ڊjcc+,,,7c'Ifڊjqq\.Z-MvwwEZ` I`fw+*ǂh6]@^#T[QrrY\Itd& < %:`z؊j1*1|@MH01lE5Do]tF )@>#!Zmkk+\@AuDiլ%@#-HTDdwwW A99˷tH` $vjەu<9QVIi!"!6Ay|h(&x$sD:3D5%68d#;Ġ@xAu]l_yH -kZ*c#7T*ۂ(GGGJlXLJ'#(z=<8>>c`:Ҟ,.."6҆:f3\:I2 <`>:rARbc}}Tqrr" %Fh5910ryii^צDu&Fx$IYuYb#p,@x$ stt&0#PEr* :IX]]Ex,@udQz}iiI IB`oYC;ɩR \.'M0Ć@V ިjz'\A;WPi#P򝝝J2@8nw}}}qqQ<-Fi6,1HpeĈ UV=NG 677Gs@ҹ'cyՑ.Ex,--=/r%n.eDFV[XXV" uRcՑ:0 7w}}}فqkkkJllmmQbcЎTGAx,--ZYYݝs~aRjtM_0 VCe0cՑR01RrVÔDv٭jzԩzJn=݆Kj Cu5x@y) cՑ^vvvwa*xZuqccůH;p[*QTG:ޘ3cՑj0R`uq 1+*t&ȉhTLSښM|;=:\]]]dJףG<|CBԝQv :&}a[/mE1i}_ pVQ:o__v[t]7:#^sbaa":I- qqmx_Mnߚӕ聃֥R^Ć{“(xc # V-'KQ1܂jͤsY>3}{(k2K Ն-K_|\.WZ76cvF*`FVX @A@ud:? d;/vvw(:xGk}ۥ"B: ct%d#ȯ,-C1|@Klg޹r ԝ{{UUVyS/*=Uң[$T 6YJS0qrI.` ]8(\Xe(S^ODȪĹ"B2B-DU2_9̜>twvvw|Ϝ?[yS{A[ ;<~_G9ܬ\(/c(OV뮻d=>Nyg|ߞ߭ޤgXE>N*3?xK$ϰbzU\fffo"tŋt Rp QohTV666 y̠cր(%é1o@ʨq{{1ZMx&D9 ey#  Kpe 8=}H5z'9h4333 XZZ_Qp ,w3 ]b0S/[C{rr#Y1,/$COc`<2Xt[X]]͆r1HDeԁ밊FQqePCTgV_ZMUk1V Tn8sJ:ԁ Gf}+Cp(133vʉ%C%\ \_uX#Ѿ r'*z_8,BZe6677շj!T){zㅈeb%?1f:srruX 2Z lr7Bz91ㅈe%?wS:eqqy'T{ vR,(r8fc~~~vvvuuȻɐI KFĒ \ͮCeh݊7(>'''x]k о˽K庚tGp ͠$gzk[A"UF2֩/7G#-;5lдњ> ZS߿tl1n 1$"%\Gv/|U7sa1Tj_16&#[dn>kmJ( ZovT>1N_;T8_X0>4m-cte zo{PQ~hX:^X "T:tmׅ;. i\uX#=\49Da^Fv׷yk1BmDp284bf-W'yff?~v( ky$yRx!bXRpH-!B=WϸQƣ^3=qᾍl؂vBގ1n6K۝E4 dN}6_tI繹9Vllll A9 %zKKKy$-zKᏢayWOXøԬӠA[<4&%[`,/Fؚ5Vi1hSx5^ =+AU^{7>◖@R"7qW1H%cΰ2odx3%'Z#qB/v hMS3͞uʼSϔhgi =*6ݶ/VN]\899i4y$uRvX"T:L\`IԎ\9.¼3CdJFyף޺JY"х#dDs_LӠ}Tq1 $3X2nCiCتf: Cӱq#D,SihY9.iK ?4 z[*aw ~䷝ M`[s| qx$H!~c̆$zb]@|C pQ7Ci pOY)uċwƷl$3\8Tۼ<!5vNs f jՠ謭j5\awL:"gTKI W MIB:pQC5)A2VhsPz,~6n8K GJp @:ûPGnoƏ{C(A2VhpXYYpG`du#uDo 8kN _u1%h_  Cr8 >#:a :LLx>% _uFYy-}+T ƼJů #0p=ês|8xnVm#1hUb\tjcо*c<9JRF!q#uXDrz+'p4_~g$w(B,S\+]y(bq:&hy{p?xΩj;xa:Կ]_z].O~ Y-Qˍו{ UY4BXߘͻ E(>d[msy|'c/,VVmHo(Béԋ+?ve tp`<%Yסz=ޕ~~[tgyJҤqDs#a\VxVᶠs'&.&iF,..|$:~w܅37]Ԓ_o:O;}PuHFu^)S@fJJ\u M Ց ʰ=:-&ry"eŏ_?g#*'IVƣ_z!$$v(e>Voa \x'Aױyt%~_yYSFk㪻WBKt҄Uzzݫ}. ti \dvwwt#>c ȠKZ0ju:V 4;^?jqmmqdYX pw$S30iлϤ0c9gcނQ J֯ۻ_q~|_sK&3ŌfHkD-uASP01}w<<ۯ8lUx.YxTouC LZ-G|aw}Wa{Az q~81)R4I9ozOR3p0&ݔ3h{o:d Js7_>諏_?i<>'XT;1ct+)ٕꇞ]hi?zPl*ayݯV6OMu>8׾ȸsqw>vGU8ۿо_y؉)kn ..kݽFLTpXYYp<3 k}C{ 'r/ a%o8oy?7^^OB}x}|gno&_Й<9}R?SV].glHL{'_yX35c\: 赎٧o[m<}4vck&  /_8Zo:j݃=>3+:Ġfޥ(ߵqd4ЫWU.oh+?q3h[6w\!)! xpeX"acffƴ5ql>8'g?ve]U?wu*zk{/.憍%NT)gTߪ\\yw{&oNh4=MyW[_fߦӺ 9Ęg\|qs~>%*߼es5hsy̎N:AZUwAʁG| g iu2'=3 XR(C0e<ᛠQPD5ʳkJ%v{s_?uou/}W>x7\t40)+oRȐݕ!(BJm^h2m^*B|틌]Q|j=շgX܏ c+HR{# W2QuQ)ϘKzU\vG +]d=V'\?0pH ag u{"906s4C#~{nټW/~2?|9U븛BiR1j`k~201o;M4 _ %c`DCE~k}Yo{ϨoMm{@] o1,A1#:}V}P/'N'ihyh9 ]=FF3c \Dw) X'TMO~ = ^PK|åDXQ %ݸO W2QuX17OQ|b af6i?.K:=)u$U3:YU&d.C$1CBY\w+y-kAԛoeuqW$a_P*l6E+åyXTv*^_Zi}ZvՒR:ldooonnML G:ޣVey1A{[[տ'V#Vr4qxxHu! ְ!gh6 :1ts|Wi㡃ePPv_ _1~{ IhQ_/cRsrr2??wAlawMA ?%'Hx?p06Fh_ %ex8M G`)B[1`8E&:T8E2W((#GGGssskkky*1@Vt*($@2V(()N'"#0Ru_ԁn<о JQ^̻ v \_uT,..noo]|@2V((8u8\Lɉ2;;;y$ʤ}W)˃(JVWW.I|lѢqbyOxMQtJ<*3b=3w[A&yp:`ZBk_ )EypBYFq||wA,LcEp<9QtJ\2XL_+7< 7RR7ｷfO5͐Bΰ/%=gZO;S i?_xEciDF\M~SagtEùVyWtxMmu4]W_pm$v4uQƣ^zXOJ:2! :&Φ?. B8{[ Ja݇Hur/7:bqqqaa!R"\|Тh:FC#'mjftt|"u+!HZwA2"tFG  1M]nz=?*'aKnܴ\-8/5PqhѸZg;S=JC#'njVq]GI$e<~WbFApxu0ךK KG }{u7VVV.DphZS::'SbhĕMm;#$: YІm<^2i1`?jK5ָ`ihK髫8 chl-JZ$yC`z>j^#q1t KˌoT eI,jwA G _j4u@XfQp`bij2kZ GŲVq` 45 Qe~$<\ <,6!&CxL~x`}6 LSp`+QTռ IuMHnPD0 Bm+닋y u19.8tvޥ9r&ceιq$p) D^<=rL;=.@v b`7r2\qBx$9A\D FNK9N()#gv2~||wY2Rʋiu[]rbvZu^ D FNK9N(5ǵZ.dȑ3=88Ȼp) e11r>vvvyR,1r>VWWqR1r766.@Q@ndk8::ZXX`{|ș(k]VqC19.8&jȑ<@R,9rVj`R9rVjy&D FNK9Ne9癎9+#*x &@؍ r`+{{{Z 9+#y b`7r2\q`<‘#g%BKx@19.8n0!ȑҵh: p) փBS 0؍ r EƏ=ȑ2SzwAJ"v#'å'GP>19.8Ar䬘T\]]][[˻ eRDБ#gdwwhp# b`7r2\q4.E!#gEn] ҃p) Q}Fw)GU0 ؍ r ǩ$9+ T$"v#'å'!GΊzZr$"v#'å'Hfsssee%R9+XdAnd\w)AHݮjyN19.89rNj8؍ rR9˞ݝK`9؍ r9˘jHD FNK9N!Fn]#gqtt2R@G#gٰSV;N"v#'å'9Ce^K D FNK9N?B9K݅Td"v#'å'K.r,UG>U "v#'å'e<~ 9KͼK D FNK9N 7r,qTnJ{2@@ndn!GDiZGe"v#'å'@8Y׭|9K ]19.8"9>>j=U%ʄK}19.8`#gSO(/؍ r1xȑ)\YY999ɻ R >9r6flll`6 "v#'å'X-,,]#gTy8@aAnde9jCǵO `7؍ r`#g999YZZZXXȻ  "v#'å'dX`БR  h<쓳Kap) E3 O5"`DNK9N,)CΔ嘟/3*v@r2\qdLhyrqdb 'å'@xZΔXXXX[[˻ WϻQfz,'@.Z.J-g\mll] Ȏ񚝝zUqRXH9N󋋋u +gw|EW@ NVă%& L'1O{o[XX8888::rGaluu^hHz<ǥdZfv  L'@.//_jÞsgsr6#կi(A@8!Yv`l@qC=2uh~~y2Wnj΄s-(@(5~$bww7J锐r9:ӫÙWR@9_߸[O{] .tVu:ktJH9N\P}he-677eǢƆ߃!.µ\EkCqBV[ZZ Y!3^ <+333VL(T3*R gY \TP9Su*0~kx;k:VLȑ=e-Ӕ#VHoővyx^k:VLU1ҾQ9m4* C/5`1i3@q1UZ>j;"ș\ꄨ <6 _k:bLg(v[9U#E3ԩcuE;D⎓^Sf:'@PƆ'T~Ry.gGonn*233h4/j`17ә!8K~ww4v)QVϟ?7ivvvee >vk5`1KS (a > z5BlQspCħ`Kn`9ZQ">%-u*Z ~))n@ ?bRԁAVƒ1D|J [u VN!in_8,%4I!"dHq"v:@ET,uY9:$4eu1') Ԏ'mh^NqG9Zmf'6Ilh Zf8CD,IC|fס2jnE\@D..jUm%4޳izZ3Ίֶ>218EdNS_nFZ+wjؠi5}<L"bɋH{~?O\!]7?&؄{dK m gMM:[Nj'k]w њmb̮Lz "bimׅ;. i\ Z EDQW跑f'+CcpĻPw)㯌;5;KSH/ퟵ깚 QkȆ-hW,~{֌msྴ[tNM,@2\@I/ߎ:M: Z\"]סUf)5jT;3lcЦX kEzW8!"!>IJ;^sy#Ûw(= :%DhAx8gWQ}=)u_ y)B6 pQ$C $E I4\`IԎ\9.¼q ]GTnr?&GuYkD GȈ`ǿA~ݩ6b\)c@2 !"AxN~٠TkHϺq=wD\G8 OI?uSލϰ;p Պ5hCħ\4!SRHRZ ~))n@ ?bRԁAVƒ1D|J [u P+A">%%= 3VV_HsϩjIH;;F_dj1L⳴t 2(Ar#-$I1P>y}/^|}ǝWc_= png5}<qtfp Zx8 gZoԒ_o:O65}-_8LNҜwwhTUΎ31`ڡNu$Ŕŏ_?g*'IVagrs=x84g.R20TXG6;n/~Y畗%*>o60$飻Y6`ѷ349`Oב_ROBu ?-rt=S{%!c. .W83fgg/glc:1t 4h %Fq/40zPepoG u_< 38CM&2wYOZch񶃦IW2wUCS1?uD*w.nn g+O~Z~ ;>3._)%<oߊ=hMek:pZ_]\NB8*4glc*1oU]{J-:zKT3?*BUr/dULUO_rZw~rS[{>su}}7yɝi}={tNݾW-o1iEg6usT`rgoU8\yvckLӝ1um}i#˵ntk2l.Oi@i:*{GT__tg&UHXb:Ypk ڌs7}'nF)v{(U1MuKek~cWզ~vo׭/xꕯ6:Q-( 3x5 <ޝqW{ERR8:@jm\}_>sSOǝu8͏ꤱnUq]6V)i>dٮ昮UH8r6*Sa=3 S>b8uD\q#UͿב.\]O|ϵ>Q[{օս˓_͗w?sp}#塖ny1PeLO'ixεXy bhXN~*Q]Y|j=շgXExc0޹3b=Zo-ϒ+a1 Gm^0靟3ֲ[j 32!]yV `#Sa'눭~ϰ2ϰ$ruH_@'$IQu\}c[6~ 7_ǥGΫo:&[1 Ǯk,8͌կH{w_I,v3WX_\{߿>pz}۳o~F}kjDm-sLAg_P>oYo<<6ЉL2Ͷr] ӥ"(O۫+\@0FR鹛>zAZY] >`Ma5%"NuA#ƓsuZ">l!a ̫$#7Ds/ O5'xzT$(IRSwP-w=r^>%naN9;ͭ{a'քm+m]>*x4q\!H^_Zi}ZvՒkWT$9~@ĉ8 g}$E"7/w|Vm{U0?*s# ~ܵ[o"VZ.uH⦎S\")J(pYG8jff&՜ȅH RԁALpY ?C@|-u:@p@ B:p Jx8 OI!uKj%1,!>IQ-Cv8w:@V̥G`yh'%1') eҸ#pQdVK[_nևK+tiyAV/Zgz˴ k{Sf3d5P7bޗ3rPZۧsȩuG<1D1')|K]\vm\_õdg,O`T Zb@IC@G2ZBUuѤT'Å5Ag]{ˣP)l| WP>ư\@CD,AC|“dYVNW;`+!D;X}t +0#7ՕBװ'5Bc]\$TzIÍȕb%)bORS,;KVq]d:v:@ٹWbFA3fik kMåP]F̥#:r%Z DE I W꒥gi;ývTp 6rFk1 bZsVӠRőB^pC $E IJ:$f+1Fu 2tAM]Md8&uV0Kp_R}*2 ~8b%(bORTbAfi*Ff_#Nu t1&1Xy] I]]h60t5i_R삆!"b%Kcd9 ae8z 4Z;*C6z& ?Cb!>Y1y꒥\Hc0`o pڠpHB 1'L]XAu9 ?bRԁAVƒ1D|J [u P+A">%-u:@p@ B:p ߨ`T䝃1')HRW\FwRҥKy!#pP\*LURʈ>Ȅkj2\ :v#'å'9}2 :`d(.uFNK9N(#rd uP\p`7\\؍ rPF@&\\P:n?9.8铁L?;&@qup p`7r2\q@'p pv@MZ@:nd2"O2Z@:쀚 võup) eDN dµu5 kRʈ>Ȅkj2\ :v#'å'9}2 :`d(.uFNK9N(#rd uP\p`7\\؍ rPF@&\\P:n?9.8铁L?;&@qup p`7r2\q@'p pv@MPb~~>bL u@Qh4v;dzUqFr:(t:ZVfH1;;{pp`Zd["$(z\YYɶ8 #6qP fgg_-,,f\d(ZxQ(vhxRd('''333{jQ^EHy/1p\k ,~D`: _k`K @,2EdZ_bb("k NNN~EZ:jdT_xQH:kdT_{B2P,T#,(T+'qB姧'z2IXЅ"*S$}]( 2IXЅ"*S$}]( 2IX ux^Yrkf: DU O''I_bt_3üOjĮ(19VX^>YR,ǒg U2< u]ެ jr룺)CݽAgγNPG:Xom ~ыES_n+:;5lдњ^LDT!r(Q]04OLڰqtаNH9y;y3(h|k9qo5uXe3Pb2rA5"gqWw=ȫ` uw l+NG Bi#s!p\@)ϵ׌ʰlzWɽN` ܗ;cͷS@o6].uԮuI$ P,s{FâV3i8 =^G}5(QU O+q%&sD~FSGCù}='=>Wzf; MVe#^!Óp\@uD9_ZN~"׉'Lw߯;xOބ0eOT2<$}EA]w:ʔ"'I_bA0#L)r(tc:ʔ"'I_bA0#L)r(tc:ʔ"'I_bA0#L)r(tc:ʔ"'I_bԅz՟oGϯ{~N}VKrv#L)r(._z].O~ Y-QkEi D#yT8oNٟ+\Ge2S%ӳ.$MN\@wT?齷CٻP݋2TEu7('ՉhYKm*kבƹuQ*3ALS0\DBx8 gZoԒ_o:nZA2B1 *ЄLSw6F:W ,2v/LxPzO7_RK7ZWz*1Et{<گݠfӥ.>J[n*pw蝨 jQaWg39>ޮ= {xHyO*I$Ly9t!])^I]ɏ(;.oℳ7-?B҅rFTtu1ou|wݜ]ح^ט6O:G@HXpTҭ2X# A3u$p ?QNŢBݹu;sã*u<=j78 e 6CǺ WgŰ}^N-Z å@ΠS8JR` +m w㺎)z5\Mz,pҭ25c¸`*X#Ϟc,?VNŢm}VsN (1]p7 g eR2PH]wͰ=\K?QccunpUE) 㻎)a`:ʌ ڸ޿|ŧg8;<Y-Qq'.FxB̞?0 K-c>_u#V-c̰ 99랚?ޮ #tL_͘04׏X3\? +!F*7>}ޗg60dRkw<*u 2|vw}e89Ns5:©[eBjn}E0d&we\]TL/ZVs7=/|xA-qG q?:3;%cow#ߌpס}r\Y)o:o #ԫL_-$aVNb.Tiz$⼮כv\+T<2Ճ@ZT'Å5U'i#g]{ˣP݇Huk.a/ʐ&9:CXlǰBo$0rSknD/'aKnܴ\G]eHPbqǠ b:d Èo[}Dٵk2w1*N̷\G[eHPbyC5bZsa^d,Uo/յ|$}EB¦{Ox3eܸњlugsTQDndY%pAL}_I>a:JL^#3m+4/g<u8ͦ>5潸F3OB5+C|8U$O2q%&?;N\Sމ)D*U$O:'I_bQT{gp4"Dw\GU<Ŝ$}EQ]s:ʔ"'I_bA0#L)r(tc:ʔ"'I_bA0#L)r(33Q#,(T+'q.H\8@;IENDB`java-design-patterns-1.16.0/message-channel/etc/message-channel.ucls000066400000000000000000000436021312550536300253640ustar00rootroot00000000000000 java-design-patterns-1.16.0/message-channel/etc/message-channel.urm.puml000066400000000000000000000002341312550536300261670ustar00rootroot00000000000000@startuml package com.iluwatar.message.channel { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } } @endumljava-design-patterns-1.16.0/message-channel/pom.xml000066400000000000000000000036711312550536300222060ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 message-channel org.apache.camel camel-core org.apache.camel camel-stream junit junit test java-design-patterns-1.16.0/message-channel/src/000077500000000000000000000000001312550536300214515ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/000077500000000000000000000000001312550536300223755ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/java/000077500000000000000000000000001312550536300233165ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/java/com/000077500000000000000000000000001312550536300240745ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300257245ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/java/com/iluwatar/message/000077500000000000000000000000001312550536300273505ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/java/com/iluwatar/message/channel/000077500000000000000000000000001312550536300307605ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/main/java/com/iluwatar/message/channel/App.java000066400000000000000000000064351312550536300323530ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.message.channel; import org.apache.camel.CamelContext; import org.apache.camel.builder.RouteBuilder; import org.apache.camel.impl.DefaultCamelContext; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * When two applications communicate with each other using a messaging system they first need to * establish a communication channel that will carry the data. Message Channel decouples Message * producers and consumers. *

* The sending application doesn't necessarily know what particular application will end up * retrieving it, but it can be assured that the application that retrieves the information is * interested in that information. This is because the messaging system has different Message * Channels for different types of information the applications want to communicate. When an * application sends information, it doesn't randomly add the information to any channel available; * it adds it to a channel whose specific purpose is to communicate that sort of information. * Likewise, an application that wants to receive particular information doesn't pull info off some * random channel; it selects what channel to get information from based on what type of information * it wants. *

* In this example we use Apache Camel to establish two different Message Channels. The first one * reads from standard input and delivers messages to Direct endpoint. The second Message Channel is * established from the Direct component to console output. No actual messages are sent, only the * established routes are printed to standard output. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) throws Exception { CamelContext context = new DefaultCamelContext(); context.addRoutes(new RouteBuilder() { @Override public void configure() throws Exception { from("stream:in").to("direct:greetings"); from("direct:greetings").to("stream:out"); } }); context.start(); context.getRoutes().stream().forEach(r -> LOGGER.info(r.toString())); context.stop(); } } java-design-patterns-1.16.0/message-channel/src/test/000077500000000000000000000000001312550536300224305ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/test/java/000077500000000000000000000000001312550536300233515ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/test/java/com/000077500000000000000000000000001312550536300241275ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300257575ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/test/java/com/iluwatar/message/000077500000000000000000000000001312550536300274035ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/test/java/com/iluwatar/message/channel/000077500000000000000000000000001312550536300310135ustar00rootroot00000000000000java-design-patterns-1.16.0/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java000066400000000000000000000025251312550536300332420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.message.channel; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/model-view-controller/000077500000000000000000000000001312550536300220615ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/README.md000066400000000000000000000022351312550536300233420ustar00rootroot00000000000000--- layout: pattern title: Model-View-Controller folder: model-view-controller permalink: /patterns/model-view-controller/ pumlid: ROl13SCm201NQGUm-NSRQgE42h258Lw_wR-_qvtkoTOaEwNBuuoOwmNWkEl1SUOx5taR5cHHsr1WoOs13X-yi7HQV5YP645k2nJN3Q2ZavIBQPVVwqFajXJjVwdfMcUgV040 categories: Presentation Tier tags: - Java - Difficulty-Intermediate --- ## Intent Separate the user interface into three interconnected components: the model, the view and the controller. Let the model manage the data, the view display the data and the controller mediate updating the data and redrawing the display. ![alt text](./etc/model-view-controller.png "Model-View-Controller") ## Applicability Use the Model-View-Controller pattern when * you want to clearly separate the domain data from its user interface representation ## Credits * [Trygve Reenskaug - Model-view-controller](http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) java-design-patterns-1.16.0/model-view-controller/etc/000077500000000000000000000000001312550536300226345ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/etc/model-view-controller.png000066400000000000000000000433221312550536300275770ustar00rootroot00000000000000PNG  IHDR wdFIDATx]$Wy["ZeZٛ LbE0c3 b4q 68Dmh18(7KV R䐛쭮]N:WVW:էWOz!P ]B #PAu/J]q>TNB$A51oh;+\DK.Ht.:֥NԅB% 1"mC0P4IPM%47ҿ~cv16{-Vuk׆e!ƅnXhm#$#'J-|yָЋBmG($&zyL=Ⱦaw>#9c.:ƅ[KETX_ڃ*vMrjq|*o]Gي jIۆ/BM& {NC(Mqp8uo ls.DYc!^y8E$Yf~<>|yFTdul? #MTO>B$A #MTO>B$A #MTO>B$A #MTO>B$A7~W+>rUܐΖ ^+a}Ij쬿gu#-deIH Gȟ jq{h #MTf}_핧o?}#Om2 #b{o5o-8[7G& oz{֧Ue_G޽8S"${MURaխlcX"MTe>us,vy/o}1{|ٻo}j}KK)(?iG7.|DߢRoB-lZ #MTeo y^|G?/ο>n|o)/QD^7!ejJ/uM%ۊ5^Hu0?xO4IPFKoͱ^yM%_zog^\zU/z^]_t*#a ^Oc\D]QYIR]]{oEYӫXmg˒LK52ExYȝ^rGΫ3?#_x|zO֋Z۹2[[E:VbU&w& z]W߰3ۑ}Ǟt߸3'7Kj4lMc8` <'Pr+^)QIj.ye{wzvomNiW\\خڿEip̃-bog+}/lƱxXMTe}S_%ʏă/'f_/fn]@̈́D;^t1tcjjҶ;7+G݋& ٘Yq\y͙\o:[s5}~!yQ#[1x9R=u/$u>n柽!{K`հ>B$A1n5P4IPz<ES0P4IPz<ES0P4IPz<ES0P4IPz<E˛ 3u¾w[d #MTw #MT^pL ?cU_.P3+Xޯ1]ބc ᎋ4Bh|*||`1YVNװ>B$A+ حPZp`9mj2^X RVlBV/7/w*v: a}I ׉6*;ʇ)Rq7hy랾{г m2(Ϥ5j/ܹ"E-Xhw 'gP &RU3+sXsFϷ礝‹ǽ#9n];ZK& *7=?yU/ĉpov_ߧ'}V;ܻ6:}~"ҿX} ޛᑶG($M_>}d/yj'NՌ 5f_fjRJݯzCnSNFC}|7APZ7^^ -+s)oKP4IPX˗ڇO~+ߗ-Ci,N Z5|X gJO5de}r|+Q.-jжi۵픆^h\΅BEqXו>#MT6m۟(#7[`Wz:cWq-iQVL*UIM pYVZ_ߛ>n$Aec-?yˣoo\ٮ/HacmAbPuhh%H/Di57oC\buC^nڣۮĹSa7wI dS|qX?$Aec|tWNĩ>q*{q'j{wn8R}VFg]&J+m(&j~~뽶7<MT6g;}Cً_jlEg'q7 ksUrs>n+v!o~m+c)m][k6qi6_k#J hr>be¾Zq03q5RٜAzM\6]2oCݲ\Ua|yhc>۷jbmrvJF4IPY[-?4#׏G4IP-LG˃X<7;"$Aw]H|L2P4IPz<ES0P4IPz<ES0P4IPz<E=(g!rʩ2GECT 4P4IPb#qK7SjXhr^K6(*a}& *My,C!2KHLkK?ֱ=ZKV*#(/$B P%ڰ>B$AecW^*5b-@CAj\C!-푱=s! nXh~T.Uk~m yGbv'Q۲^ V6@=뻮nXh+/U{.z]{ڣVjeѯJ8a}IW^z 9Yw#[VXV 7P4IP9XK9p=rZ!r=luYpmXhr~s8uE^+P,Nݰ>B$Ag7btN$ #MTݍ`a}I )G($`=a}I )G($`=a}Ijw,ޯfNMY`bܰ>B$A*ita& *7SK2c~GE^yLJB ;@Цu- #MT6{b$؈R޴\Z_R>ۄ 5U[ & w1P4IPXJTmS^έ ;*k[Q] #MT6䥪# e-`Yuyo:95ʦJDJd9Ѱ>B$AecW^*\|; o_@l7P4IPXKeiq^VnnXhr~퓗eNdyBo9 V\{N|yH~7EiXKؤð>B$A5֫& V$& i~ib1P4IPMx& *X`Xhx & *X`Xhx & Xo 651qXv7qnj$ʰ>B$A>i=Z?إ)QTwfXhr>P^*vgi*;4P4IP9XX AKU[I]WD2 5WwiXh;/x}^rܙJ*Ĵݶg4SE^yz//n*S9ȰG($lK%wB4مa# Av* o0G($lKޯzw]fSero`ĝG($l_jKUؚJqBw,A+;5P4IP9XKL59XH^e8™j-3@r?-:+7d<`]G($ܬCTe#$а>B$Aű mrK`mFQIܙa}Ij~}="xa6pz`ݰ>B$AG($`=a}I )G($`=a}I )G($`})y8VƖ\~a}I*#U̯2]OE祊2]? & *R5ILOK5|eHуE*_V LKEy0etTy|/)mD\֫& *R=TW&WAv~!ۿU^5P4IPX4}e\yL9YʦjI`Xh+/h(R ^o_l3P4IPXKe;TWFY֡0^a}IO^y82͉Bpwzհ>B$Afw^+$1 #MTd}yL_`Xh%;K5xeLkEHYV& *X`Xhx & *X`Xhx & X?#́3.}e;VfL8iXh zoة73H #MTnj)NoOvҴ}I~& *R)6}R]MڣTe|LǫU 8˺BکfE!Ua tsV51UY&ݏװ>B$Aecw^*=ģO**oASFsd9̔'Q!9gΡ֬\`ۋ *Lx#6P4IPX5t{K^ll[xa"M5ъRIHR #MT6䥲dKULV[x2yVzyv?bE^y +l&,wFNܪc gMZXGlXh~퓗mm̡h6xjv Oo#6P4IP9XKUR2mJ'41xulmQi/Ese y8I~& *71)7n_0P4IPz,°>B$Ag~P鹉C>EUwc8kXhx & *X`Xhx & *X`XhGBf53'<}/z8G($^}rnb3£f׏)& *7KmsIf׏)& *RXSU$IKn7.zldn{!SSMT6{!*ݔ[ٰ|fؽJNX?9$AecW^*k"$ %f%d}7~rIzT5_ǻRb& 礪Uw9wSNj($lK%ڝlʬ3Md7=RYYx|ѯGN$Aec'/c_#&/Uʻ\{k%$_j3T)ysʭr~s^/hrok)/U[-Xh][&ѥ܂& *X߹/P4IPz<ES0P4IPz<ES0P4IPz<E-)jQ}cklIpa}I*:ַZ%tf^.VE奒u迵IcK[ #MTַ祲N9\)c&5iGkbF8M<s_cD6!&옒.VE^y\AX9A Jzh_c֤ґ 1?Xg>>xSV Q']­& *RVܝJ cz[|2U9(и.VE^y #MTr #MTv3N}r& Xqt& *X`Xhx & .z ԕCjH.\pM7 ])*ڳ/Z OT'O<}е Sٳgk1Q?ڣSƚcǎet]hе@j5t-&g}6] 4-iC⊋B OHΝHq ,X?=ǎ{熮*5dz>;t-T맢'N<C5:}ɓ'`$Q>cе@.\p3! O_;0}V9 &X2_qΝ" BOG.BGy.ZN}A)U0i\ !ԅy Mˮ,5OLE͋ǓP}~~I-\,ԽYKs>-\:[k1lr1/c!@.%FYkf֯!`=[>Nz="c:ۅݺwB}Vj^Bݯ.bY.2?Wނ߯+QxrsO{ ֯=^o=DZzaLVK kj{keCan8S E,Ol;3"fB7#8O9f;B&l?璖E`}"h)387~C='sU,K> !ı-^"dI~g,ԝ6]v !X?zESAhQyhQ# RpԹ`h$PBPAI@``8??+.9QB@iJIE;q4=wKy ֣=4y}{=ܱcǞa2֣=4]wu?p 릛nʮk*X8TOSqQb*V.'`=S@#Ѕ ~~jm0C#1=kV nqXTg3KP2ʮY{]W?`=S@#PyC覛n:yd1 ֣=4e'__Lӧwa=S@#ooOtvC K`=St/H41͑P!4lX?tc܉gC91.,bXwz7ǽcڪ%mjl<ą Di2Ӥo Cm8@dNOԶM|2Ys5" ƅ M0Cmnn˓|s͗gs ;[ױn|HRT c7:qnX{7xpzܻa=ƃ 1ܰnXwz7ǽc<a3<ꏟxGْk ykxv(W^_zk揈wfuų'͙:Z/dhj3hj`qIỷGk)Ÿ\^r&L`W}Y`Hџu(7zu*1otj9`}s^ ~_g^vť^;^zEg8>ƌ93!Ap})h_ӕ,h'o(?(CJ ;f}>;:炒VTgJ ΐowG;3|Ǯ[󕧯_zL2eUZ*={hOqia}x}^P?fm&Y~kμOx7f퀮|`}dv6sqVb5N:@*ɿ;i#  i.&6r6 }}7_~ސ%q?"2ʜv"1cVsLI^8ch NSB)~A Ҥ'f[="z}kX9MYoW.#&ﰔpH):⼋Q0y?hsJkOWX9M&DY .oP:L8 c4Ĝ(by8*e(ST q;zi21zP Dz ÎRB}8R;^?ldeƛ~f'̦GE&%zM +tYk9WŅDjQ&;!p?c8yAkiX4AL s~ҰY_x=1)/l(ߗ.W'kýM[%>Ǔ6F)_e.Eq̬oW^[0z$v6ڷ_s5pޚ֧{Epfnlrϟ)榖U3)(+6"ƻ;Zַ DX iidևN۱/³W/7[(7>RUE#/b: V՝7cұ.E BOwʙLY(oNg {;m۟(#7[(&~ܢ{ߛa%r߶kǗlU6 d>+1N۱Ew_ϟ~w77[(NsyJ`;[n[S܉j?D`}X#7Sw=qO^\~lެN>yy5&o\ 4wGZۮ MqiZ^3^߷a=ƃ{9zO9 jmfprrO.?#-imhO0Kz.O̯հ lnX_kOkz7ǽ{/i8:X}5Tx q-wCbtmwl2ǽ{Էa=۰hYsS)_:g7& S;T qmyqtP61pFR+CW }ӻ#%Vii&~O*Olb[ 4푄H^35[hpFmyQCT ǡXgw#plYRbI{Pb>מB|o*v0XM^ZVᳮs>Pykxy^Sb>7^J? m]뇄zTqv>owf)/Z}hq`8IbD<8iȬf,>+O%% Q71m YoJ^KBЪ-ᄫcyߕZr%8;5=-6K%uCkqڗg-_m.u*SFvY`}h+{vK%AG9. |HZo;qh|}lH\Xvu$_kj ,7&zBV vKԇ~TZ5%6򏬪}[Y_g5Яoq=*Ha^yE>X"C$`U[,.%wKf Cگ]- KvkwS8!oO^j 9gXTo@5EGu| ߕbc}6?s)Ek@{>Xsw:s`l mwmG( -/25=`)_g ݁휑lT&3G);Եǽpnِ49Zw-?.O̰,~_^*k9;G'/ڒŀT Q UnIU'׿HyR֣f}< <bvƍA'3G)֛&<>n -4Ke(mz2G) c\֣1. Qʂ(ez z`=ƅa=JYDC֣4_qz`=ƅa=JY°mX~٫~e/~a3n Qg_<ĸ[zeON;4G) 7y6fj="KAmy+3ߔsT$ ^w$ }Dv֚ _1Qw ' w B`}>yuܛ ?c933켡_h{bݑ̬ z7}Vngҿ|_[/?!9#zZY?/տۤm,,l}RsB5XwRr%$s,}1][Ғ1Q߳ M[_N9gfuWz4Ys7~+nϽs_5h55SokB2rոr]T%So}H^GXu׌c`[:ng}?zܟnEeR!mN_sDUuw`=JY>?·=·}7>NscMP@0{bMDi?zOe߷' bQ>qoњAvۛ#$[h͚/>!m!mzoo~Ҭ ߮_evzU #Trç_wˊ&(M>j$y_iSev775۸Vn5<Ҍ׫ LكڝҤ{ݬz4 X-6\]3! =IɬBT C<縰BZvͲ;e:SzMJ.ZtLJ9\U:a []lpfY- Q~y8hbrLG,>:\i+_&(XܧG˃lqxdDlES/.26@=뻮Ұ,o|×r'N}Sً=-VkWޥ_/G'=U GiXRk>{P"W[e^Ɵ}(Ý6dO4G)zO9 :<W([r?)pgNgp(eYwJ1(mzq" mb Qڳ_?DHM<:bXRVwc8۰,XqaXRǸ0G) c\֣1. Q+rG4X;o%0G)+U̯鮧 Qr>T/3? {4G)zTMz&%SRyCiz hSU:HApdž(eXJPv`#Kxrk}Io.Tm%(˰,RcKxӹpdWcm+jXߗa=JY6䥪# e-`Yuyo:95ʦJDJd9Ѱ,RνK^|T7U~}(eXKeiq^VnGaXRkT-p"KziBMpwC֣f}R6icXRXv4X#2G)kkD1֣5cjXRǸ0G) c\֣1. Qʂ(e zSI;Ě;fLG%qHz'Gt3<>J⠆(eY(/4hkā Qr+/U=ֱ8|mA}4Be62U+h!k$mXRyR#$PR!>3WF^ Qʲ+/Z]2횣WeJ976Co(eXJi mzG(1UFߎa*94&hXR^y}XN޿lL-X8a=JY6֯}R*lMи]e;Ix Qr~퓗jr:p3/ZZg&&r~R[ uVoj6%}y8*C֣f6.m_A%q`zb8vMnl(*֣g\%*Xa=JYn֧*t.Ѱ,R5ILOK5|eHуE*_V L0G)zTBs:TWF^֗O6[i".Xw1G)zT"j+/o_u{oUŰ,}RUd+/1'K[ 7I4W"hXR^yDdrřj6~rUf_߿a=JY6֯}R*/QunXRkT-pK5|eΛc˅T曃֣fw^+$1n7G)k4/+1ҰQüTWXx+zFz;7G) c\֣1. Qʂ(ez z`}ԏ4fϸ&Z1T?^zDho<vj}wĆ(eY_^8=!I&6G)zTzJrTgsS/U<߄1=jyU<$βvxrHUݜUwMxUIymXRy>HYLAXZ2SGņ`U;ZrQm/*d@0a=JY6{j ޒ#;?^XfHakkMn>sTw(eXʞI3/U1YEn؛62^fZa z'֣ecW^~p *:n5:Y'#7G)O^1iژudcO'r{>a=JY֯}R?L A 9l[Dag {Q\YmN?nzܬƤ޸}~=հXo4۞ű֣g~P鹉C~T(eu7 Qʂ(ez z`=ƅa=JY°X$Kl1_7pR#Kʭ"3`=JYX>r9K71dwG`=B=zRm[~lһ#`W^*=Ky{J<$3 yRP?@lz/`Jdcw^*-yM Kgݻ)RY!aO/1(̭ ;w&?)}Rո~ oJ'WM9GgXJ;ٴYi%fnV{~rU}_P<~퓗J/*TKS=5zkT-p&*SEoigd|jM-&԰XABjN[5o'nfۦ~ a=JYnַjKkKS͏t a=JYַjь08h#SIPDC a=JY6{"kϋ%j1LHjpDc05K5VxzlKʤ-PAsJCdhZ} Qʲ+/eWOB\s5Ňįڊ6@j24>(eX_[R[kML Si1G)qovTníy>HMǰ,˶Tr"Su1 java-design-patterns-1.16.0/model-view-controller/etc/model-view-controller.urm.puml000066400000000000000000000035401312550536300305700ustar00rootroot00000000000000@startuml package com.iluwatar.model.view.controller { class App { + App() + main(args : String[]) {static} } enum Fatigue { + ALERT {static} + SLEEPING {static} + TIRED {static} - title : String + toString() : String + valueOf(name : String) : Fatigue {static} + values() : Fatigue[] {static} } class GiantController { - giant : GiantModel - view : GiantView + GiantController(giant : GiantModel, view : GiantView) + getFatigue() : Fatigue + getHealth() : Health + getNourishment() : Nourishment + setFatigue(fatigue : Fatigue) + setHealth(health : Health) + setNourishment(nourishment : Nourishment) + updateView() } class GiantModel { - fatigue : Fatigue - health : Health - nourishment : Nourishment ~ GiantModel(health : Health, fatigue : Fatigue, nourishment : Nourishment) + getFatigue() : Fatigue + getHealth() : Health + getNourishment() : Nourishment + setFatigue(fatigue : Fatigue) + setHealth(health : Health) + setNourishment(nourishment : Nourishment) + toString() : String } class GiantView { - LOGGER : Logger {static} + GiantView() + displayGiant(giant : GiantModel) } enum Health { + DEAD {static} + HEALTHY {static} + WOUNDED {static} - title : String + toString() : String + valueOf(name : String) : Health {static} + values() : Health[] {static} } enum Nourishment { + HUNGRY {static} + SATURATED {static} + STARVING {static} - title : String + toString() : String + valueOf(name : String) : Nourishment {static} + values() : Nourishment[] {static} } } GiantModel --> "-nourishment" Nourishment GiantController --> "-giant" GiantModel GiantModel --> "-fatigue" Fatigue GiantModel --> "-health" Health GiantController --> "-view" GiantView @endumljava-design-patterns-1.16.0/model-view-controller/pom.xml000066400000000000000000000036141312550536300234020ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 model-view-controller junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/model-view-controller/src/000077500000000000000000000000001312550536300226505ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/000077500000000000000000000000001312550536300235745ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/000077500000000000000000000000001312550536300245155ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/000077500000000000000000000000001312550536300252735ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300271235ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/000077500000000000000000000000001312550536300302235ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/000077500000000000000000000000001312550536300311755ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/000077500000000000000000000000001312550536300333605ustar00rootroot00000000000000App.java000066400000000000000000000053501312550536300346670ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; /** * * Model-View-Controller is a pattern for implementing user interfaces. It divides the application * into three interconnected parts namely the model, the view and the controller. *

* The central component of MVC, the model, captures the behavior of the application in terms of its * problem domain, independent of the user interface. The model directly manages the data, logic and * rules of the application. A view can be any output representation of information, such as a chart * or a diagram The third part, the controller, accepts input and converts it to commands for the * model or view. *

* In this example we have a giant ({@link GiantModel}) with statuses for health, fatigue and * nourishment. {@link GiantView} can display the giant with its current status. * {@link GiantController} receives input affecting the model and delegates redrawing the giant to * the view. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // create model, view and controller GiantModel giant = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED); GiantView view = new GiantView(); GiantController controller = new GiantController(giant, view); // initial display controller.updateView(); // controller receives some interactions that affect the giant controller.setHealth(Health.WOUNDED); controller.setNourishment(Nourishment.HUNGRY); controller.setFatigue(Fatigue.TIRED); // redisplay controller.updateView(); } } Fatigue.java000066400000000000000000000026551312550536300355400ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; /** * * Fatigue enumeration * */ public enum Fatigue { ALERT("alert"), TIRED("tired"), SLEEPING("sleeping"); private String title; Fatigue(String title) { this.title = title; } @Override public String toString() { return title; } } GiantController.java000066400000000000000000000037601312550536300372600ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; /** * * GiantController can update the giant data and redraw it using the view. * */ public class GiantController { private GiantModel giant; private GiantView view; public GiantController(GiantModel giant, GiantView view) { this.giant = giant; this.view = view; } public Health getHealth() { return giant.getHealth(); } public void setHealth(Health health) { this.giant.setHealth(health); } public Fatigue getFatigue() { return giant.getFatigue(); } public void setFatigue(Fatigue fatigue) { this.giant.setFatigue(fatigue); } public Nourishment getNourishment() { return giant.getNourishment(); } public void setNourishment(Nourishment nourishment) { this.giant.setNourishment(nourishment); } public void updateView() { this.view.displayGiant(giant); } } GiantModel.java000066400000000000000000000040501312550536300361660ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; /** * * GiantModel contains the giant data * */ public class GiantModel { private Health health; private Fatigue fatigue; private Nourishment nourishment; GiantModel(Health health, Fatigue fatigue, Nourishment nourishment) { this.health = health; this.fatigue = fatigue; this.nourishment = nourishment; } public Health getHealth() { return health; } public void setHealth(Health health) { this.health = health; } public Fatigue getFatigue() { return fatigue; } public void setFatigue(Fatigue fatigue) { this.fatigue = fatigue; } public Nourishment getNourishment() { return nourishment; } public void setNourishment(Nourishment nourishment) { this.nourishment = nourishment; } @Override public String toString() { return String.format("The giant looks %s, %s and %s.", health, fatigue, nourishment); } } GiantView.java000066400000000000000000000027231312550536300360450ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * GiantView displays the giant * */ public class GiantView { private static final Logger LOGGER = LoggerFactory.getLogger(GiantView.class); public void displayGiant(GiantModel giant) { LOGGER.info(giant.toString()); } } Health.java000066400000000000000000000026521312550536300353560ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; /** * * Health enumeration * */ public enum Health { HEALTHY("healthy"), WOUNDED("wounded"), DEAD("dead"); private String title; Health(String title) { this.title = title; } @Override public String toString() { return title; } } Nourishment.java000066400000000000000000000027031312550536300364610ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/main/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; /** * * Nourishment enumeration * */ public enum Nourishment { SATURATED("saturated"), HUNGRY("hungry"), STARVING("starving"); private String title; Nourishment(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/model-view-controller/src/test/000077500000000000000000000000001312550536300236275ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/000077500000000000000000000000001312550536300245505ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/000077500000000000000000000000001312550536300253265ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300271565ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/000077500000000000000000000000001312550536300302565ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/view/000077500000000000000000000000001312550536300312305ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/view/controller/000077500000000000000000000000001312550536300334135ustar00rootroot00000000000000AppTest.java000066400000000000000000000025121312550536300355570ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } GiantControllerTest.java000066400000000000000000000074431312550536300401550ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; import org.junit.Test; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; /** * Date: 12/20/15 - 2:19 PM * * @author Jeroen Meulemeester */ public class GiantControllerTest { /** * Verify if the controller passes the health level through to the model and vice versa */ @Test public void testSetHealth() { final GiantModel model = mock(GiantModel.class); final GiantView view = mock(GiantView.class); final GiantController controller = new GiantController(model, view); verifyZeroInteractions(model, view); for (final Health health : Health.values()) { controller.setHealth(health); verify(model).setHealth(health); verifyZeroInteractions(view); } controller.getHealth(); verify(model).getHealth(); verifyNoMoreInteractions(model, view); } /** * Verify if the controller passes the fatigue level through to the model and vice versa */ @Test public void testSetFatigue() { final GiantModel model = mock(GiantModel.class); final GiantView view = mock(GiantView.class); final GiantController controller = new GiantController(model, view); verifyZeroInteractions(model, view); for (final Fatigue fatigue : Fatigue.values()) { controller.setFatigue(fatigue); verify(model).setFatigue(fatigue); verifyZeroInteractions(view); } controller.getFatigue(); verify(model).getFatigue(); verifyNoMoreInteractions(model, view); } /** * Verify if the controller passes the nourishment level through to the model and vice versa */ @Test public void testSetNourishment() { final GiantModel model = mock(GiantModel.class); final GiantView view = mock(GiantView.class); final GiantController controller = new GiantController(model, view); verifyZeroInteractions(model, view); for (final Nourishment nourishment : Nourishment.values()) { controller.setNourishment(nourishment); verify(model).setNourishment(nourishment); verifyZeroInteractions(view); } controller.getNourishment(); verify(model).getNourishment(); verifyNoMoreInteractions(model, view); } @Test public void testUpdateView() { final GiantModel model = mock(GiantModel.class); final GiantView view = mock(GiantView.class); final GiantController controller = new GiantController(model, view); verifyZeroInteractions(model, view); controller.updateView(); verify(view).displayGiant(model); verifyNoMoreInteractions(model, view); } }GiantModelTest.java000066400000000000000000000057211312550536300370670ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/20/15 - 2:10 PM * * @author Jeroen Meulemeester */ public class GiantModelTest { /** * Verify if the health value is set properly though the constructor and setter */ @Test public void testSetHealth() { final GiantModel model = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED); assertEquals(Health.HEALTHY, model.getHealth()); for (final Health health : Health.values()) { model.setHealth(health); assertEquals(health, model.getHealth()); assertEquals("The giant looks " + health.toString() + ", alert and saturated.", model.toString()); } } /** * Verify if the fatigue level is set properly though the constructor and setter */ @Test public void testSetFatigue() { final GiantModel model = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED); assertEquals(Fatigue.ALERT, model.getFatigue()); for (final Fatigue fatigue : Fatigue.values()) { model.setFatigue(fatigue); assertEquals(fatigue, model.getFatigue()); assertEquals("The giant looks healthy, " + fatigue.toString() + " and saturated.", model.toString()); } } /** * Verify if the nourishment level is set properly though the constructor and setter */ @Test public void testSetNourishment() { final GiantModel model = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED); assertEquals(Nourishment.SATURATED, model.getNourishment()); for (final Nourishment nourishment : Nourishment.values()) { model.setNourishment(nourishment); assertEquals(nourishment, model.getNourishment()); assertEquals("The giant looks healthy, alert and " + nourishment.toString() + ".", model.toString()); } } } GiantViewTest.java000066400000000000000000000054751312550536300367470ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-controller/src/test/java/com/iluwatar/model/view/controller/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.controller; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.mock; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import java.util.LinkedList; import java.util.List; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; /** * Date: 12/20/15 - 2:04 PM * * @author Jeroen Meulemeester */ public class GiantViewTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(GiantView.class); } @After public void tearDown() { appender.stop(); } /** * Verify if the {@link GiantView} does what it has to do: Print the {@link GiantModel} to the * standard out stream, nothing more, nothing less. */ @Test public void testDisplayGiant() { final GiantView view = new GiantView(); final GiantModel model = mock(GiantModel.class); view.displayGiant(model); assertEquals(model.toString(), appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } /** * Logging Appender Implementation */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public String getLastMessage() { return log.get(log.size() - 1).getMessage(); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/model-view-presenter/000077500000000000000000000000001312550536300217055ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/README.md000066400000000000000000000015051312550536300231650ustar00rootroot00000000000000--- layout: pattern title: Model-View-Presenter folder: model-view-presenter permalink: /patterns/model-view-presenter/ pumlid: ROlR3SGW3C1MkGu0-RzjKeXQJWcWFChwPO3xispvQBrmL0hbp-q-xGkWkFBL_8upZBICxjGzbo7GE1OwAlpmmLJ9sjNJH7VIRY1e6q169KvFevMcakrtI_BoD-HGoJE4Nm00 categories: Presentation Tier tags: - Java - Difficulty-Intermediate --- ## Intent Apply a "Separation of Concerns" principle in a way that allows developers to build and test user interfaces. ![alt text](./etc/model-view-presenter_1.png "Model-View-Presenter") ## Applicability Use the Model-View-Presenter in any of the following situations * when you want to improve the "Separation of Concerns" principle in presentation logic * when a user interface development and testing is necessary. ## Real world examples * [MVP4J](https://github.com/amineoualialami/mvp4j) java-design-patterns-1.16.0/model-view-presenter/etc/000077500000000000000000000000001312550536300224605ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/etc/data/000077500000000000000000000000001312550536300233715ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/etc/data/test.txt000066400000000000000000000022361312550536300251140ustar00rootroot00000000000000==== The MIT License Copyright (c) 2014-2016 Ilkka Seppälä Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ==== Test line 1 Test line 2java-design-patterns-1.16.0/model-view-presenter/etc/model-view-presenter.png000066400000000000000000001214721312550536300272520ustar00rootroot00000000000000PNG  IHDR4hIDATxm-Y+!% 5p+7b̡lKuHl8 cŸ-N,%)B968 `y]%׸g™!¤w\ϵyꩩ=Wzz^>9 rqZ^~ B|ľE A@8GB@& =4!N ' qA8UhmV)&;  "{JSe~Fyqv q=%IE99,ݙNOSC%+C'Iŗr]sq՜wyGBdBّn qD pA ~2Zo㋉Od>w|{U5+2n@t#u&7t*? ȲѸn5.N6ņ4oqzs)t88"³|xu.,Nv(Q}mO<0}//-?;}_5 ]iCɋ8xqJn9˞`88"³½RgS]~==g'dߺM2uN|soeeXMR3_pv* ]ۼ&Ʌ"N4AJY(<-uJ9 3w~?i}O>֏}˭\f:qlMWҋ\8s' #SY"< {K $q" "Gy?}|ཿ{? >%/_vN7'7t/_Q!jJܚG=s*zqS&N"G DxOs SCWvO;U*IUo4Ra96W*5V@Y5n:$N@`3\hN4ԛhLYV~EFp\ '{T7c'ٲXةK0H7YH}P,=5ڣ^Tl2Q& u# XtkҷYl56Z!N`$C'0"B ']"B@& =4!N ' qA8 Mz$-N.j„D ssAaXIB@#!N H(Nz##u;0W aB@#]ʼnRU!ɒY YXR_qx@.B@#k֋*TŜ6]Hʫ,aɘ$ 0!NEh s dxt a*]b^qt'9wE{T'f̩Ɋ&1 j&)q*BX3]/3}wy4mĭY=FW׋]pb 囧u]#?7'k%oNs4r> 19FSd!5לܬ `)4uK(sjA*jȋbjfcqiaَO暈u `7(NY<|RC Ip=UcfqsՃYVO֊eGsq'mcpkf`= Yl\Bit9iFب5+sR6$ sMFC=3,)Nٚ(dWXq^ki{|sܫ״8$~с8+pѬE>]S % GӽyfٓУ yPBz\Z3 -~ZVjCFYz4ׄmSu@8+$^=*5+8%!LVdKe;a4lnCL]jwpcV{2!½&95̐%{N=me՞_gcq ˈBYs>Т*\ץ|V'=Ž \ <ܽ&x,'ϜG>QIYS03ĩl@zrx1Bl哵[pȑg5JuD]BrQIhzKɈSH1r\f9Q6Dwa -N/`+VIU o M-ӄVS ,)Nٚx zNDA10'S/`\~>U)zѳYF|͉讛6[o-8JHX8! p jyhiPnTb=9qnOyp8 Mgxcx8 MwyȄ8 Mz$ iB@#!N H qA'H҄8GvYߐ53, &)5B R.]Т x,tA'B4"xW E;?8B9 s1=l CE;!N8ٲ =ح_ GNdž.X;2N{&'\=7̤EH"&KѿMò䵽I%vd* pnp6Z9*'N&#N>շ`X1~0EBCnr-MϜ` Y ;p\4.ǯ&/L>9uֽ^mb<:L@%)[ sjdա#(X!)sRӢ}[ŘB.DO7'ݞk@.,NJ9V9F eO` j8v-'Neq3QvQ փH=Ea)/NJ9'ӐCNQ~B{ɸeBD=='S8r-.NE&DDF0K>00 pB`qQzh^I 9ia Vbd-l՚cW#Ԏ^l=s ͈v]!>=$ iB&9' q 7!N H qA'H҄8GB@& =4!N m8KrX[r%R98(B. Fz^A's-' _"By2XSEB]!N`'פmL13:'kZ'u|9)4 P8Άwu:]Ӗk1.^M5Zri:4O5>3_7X%fę VZĉt̔>'chEPrxVԊv]'9#=76!Exv ='eC1[ 8 ,)Nٚ6qg2~}rf5dϐk +⤎ At,7V[Sa=*:U8bJ='q4*N"B8qe,NV\3t[W ǻ4qklqO6ٽq=@Tޚl1' MJ'gNTd.G^SqTn͎3dqrn b{NtƟ *CϣZI =NgMJI' ũ3''O[1tns@#5:A{U%.t!ԓ~Ԅ4uyOQm>sÿ3'ˁ@jGq*2[6ڊt̴1HGGdzݢQ1 GW|>[O :W*%Sζ9[h q ',vZs0% iB*8q7C' iB*8%Cj6 !N H qA'H҄8GB@GqtU#6X䒔8='zN 䉀ST qA Oʵ[( qRJ8;"Nw|[^?~@.''KLC[e]lHZ"}c,N/t,KIXR8-9#Q[՚"9mʆdS#_sr0Liv[=51:'A՚Fkޝ3;$N°bf%F`hK\7Me v5L /=l%و3?a9QE9=(_Eޝ3w,~gc0@q~{;dOBa54&ݳVh|>*.yY5=JX*x4эH͂-^9(0(6#N }(Nǿ_~" /[(sq͙G'['=9s%'ϮK&'B@f~~oC8_/[(VLxhF20OG5Nԧ8%S8I P||}Oؓ/>ԋ^g JRia-dωS/)K0 qAۧO/= N 9͂\<ه,%}5N2GSbXXxB@f+TrXl=aLo6焮yU1=Jd*ePiKb4B$ i+N`E=N4!N%2Dt' q1z6 N dp~ANpϩI+H ׊u8u'H qA,#NUvBuqfӥ!Qؒ*(Yx#ݑ1 foq"!N %+3-kWwe623eOIQsL@SqA,)Nٚ6qRߪ5&N zta=sl:Ic1 :Rωt¥o8%x⤙I)6V1 @u'ͽ 6i&-d QH̬#N=3Xqp[:MfU@ NQHwwǐ26:}B9 &9ua儫f#'"-HO1QTo>kX GTX]Fl=V]L9b6Wnf\z#Bu.盜ԣcgEӍ q n0@q*uql -?L n2y1V i(NNNv"vRb5ZK$F2S:hŌ!J P;a$a$w=''ᙓ<< N[p*ZxV" i)Ns\7[0z=Q/!$!N H3Xq*Ūp[& iBD=l' qXMv\ y^lp1>hK@c8-WȂٗ q;dKBzdqd%)8Dkխ7V|+QB@#K ;{r)AִVW`E!YR5SNc6I~r+n;W7p`8½ܲ2K|bD48W~+h'\,$@ݪV7.VmP985[n7 RQ"FohvKSMc\RlNٞAne=-f.0Xq rI`˘窨*NJo_B ڱB.#Nzso='2$H2>K)NNNɾ6Frr>8lvj+yTzXODW^_yJC# f֙N;Vȣ#c㢜2QUN:e(Gቓ:GgzkeT 6ڭM!4O%Um-0&=ՑJNZ?+&  o2Sx pk ThJQyLV'{i%o"%G ZW~-X!C@f䄻`!PV< {/٪>V7_}VV~Ġh ܥ b V#'NNNjPqbj|B c qA)x^؊2 iBBx{v!N H,yӖ;"N *Hyʀ]& =$nRWE0qA8ՕE4 B@#ˈ 7zCx%K3VR ¤SEWo\8TDŽ8G'n*jr BkJ3-zYZ eB@#KSNѳ, Gd3 Oh2`Uqr>hbBiߊjӎRI+^RZBFzlCa[K q'&Ji2v XE2>u !75|ݣ?׺{ω>IRցGՅ8Ac bKOɑ"E&  =~MV.ĉ<uì&Qoh;䟦8tv 3>Qxk9,#zDX| Cile-dϩk?M݄8 ik{$6=G95rH?xsc' *SO$)K,FbLm|M SV'97#LѺZ^n-S\5[X'h'IYg2q6p?MqSpJ,tBZ.]z >) Ūr{J,tzN HrٞSBw8 ' qA.Nw|[^?~< X!N U~: x@.B@#'.BzdD) #6w'%N6\H#X`:BɪU K/vx`ũPf6qRL{,hPXFD#NeBDUq ̆RݪK{aԖ~eͷSBm&LbA߀@:Dqf)Jȝ [)É҂Mg;\?F8脛ɷZXrkxUTbDU',:xiJ4Ϝ>Ln0WLٕ 6ũa' a}ˮvy X4 R-KOq''#N[0Y$4ԟ(df3;''Na+ ӑݲcAh@%C;LOXL8Kނ ʆz}tJ-j'ĩ(NpV\G7#-Ăc,N9b1qqx 8L|SEHZN^wkӼ}'\@ AmƂY jY*|=&E;Di?v'(yNalfñ u4 x-;`,#N`{N^8ane|BgȄ8u]'~NBg8ul]; >4+N B@& =4!N ' qA8 Mzd0{вsiژ#!14|FuN=`k' wy>^]WqxhۼDvķ+Ɲh)tjN_\ri~nQN-8 ˈS#Flw:(wjT&xqu}18 B;yEٻ +,,NNFWM/d*-Du&ޗӶe'w|\gr_T\suGY=T(X$:# wd@0ũ`Jj+έ'i[N9 GوS59ҒyEkZ١֓'9ii'Rr&c~M:Aj\Y- SL\ǹ]SOZ2 9d>+D-E2!så[gvWXLpl9?%0,>Ne,;%Khąst속eoR '-hUR(0Uwio }:*UmgvWXLpzEIYvJ ;o-E]4%O]\aѫ/<)ps# 'o{vawibI_i_@qr @wZFҤ)'ovawin7$/~:HK8_af+iٙ;T5wOtGkֹdFD9H+'c,&Ns#N3|dR{ÛlӼ."3d$q ;$NܼLܪ Z['!N ' qA8 Mz$ iB@#!N Hٖ8Y!,q+qB]c `8i`qf`; VXX :2e߲]ށ %' 8ND.E226`S PpXL8ɞBFi7 %' 8'#N1|ƻmv J!(N@p8,&NNFen b"9fyCt:zP1@q#T"NuMҙ]†lae/a `/`;8l' `8l'` 8` 8GB@& =4!N ' qA8 Mzd#͠ӁB~0{!NJ wD٨7![`}wFok?X_׀8 ֠g&}rڅ EB[k72F9Σ EwӠ8 @DXlʱh3U#}`aqqdN-ax(tM+Q9EHi@$6m;8M]̵ 7A8999*ɸ7I;1ݢ!_P!NOūkqkzm;)?GɈS7kw%YfxL9OW]F:G"(s1*Sr2r!:#QCe]jSQ'\ךqۄ ٥Lv[ p7TJI#K%SW#K:QY { XL8)ۄ*7,:N0SLrh6!ZtzbT WD]nj!,ȵqʭi[e|`w'#Np?'ug1)_&mbIF,iiE=1@q*RwF~h|+nUA^((NYL8Vt0KwpKߵ%Vt9ȅlr N8w5Q4Q)y& c!Ä ޸ыũPi{YL.F5_Xct2[S>]陓pd!N1@qt%.x:*3_鿓)zD>C/x#Bdztyxl ͅ3min5$?`S uȩmU|t1lb(I;@y'D%uwW+`!F,?+:1i`m4kWtmBaeĩIV{a 85q- p '+9MRH"Z8dq'h"dت:OkZ08`(8`p8 Mz$ iB@#!N H qA'`Iy}/ת2zLE=~+?iK^'z]x/u oǷEdNКCn-}ºmg=,Iw~vJ/NJj4|:Րbd= P'HW},#N՜p9ZSɘPzg:Yxx+NT|(Ink[0'zS},,NŌ8KGt,6eZyK9S*1\\NYjoK#Oxhd6064N;^ )q-WP>#wBw2d ]`y 'mIٚ(Rk]e-{T$횲G>Ϩ׋e15#GYoO C,9ǫ4@q*+gP5 :&ָ U+AkOj@. Vb1qr2$6VtR}˗֭x]mF.[rСu'؂WiT W0eZ5L ԋXU2]"xd K899h pVItTܣ|պ(ojf{WVQlۡ b ^ĩ:[$NkX,JP/ZcU;*Ak |GqBd-2{[dIjNJ3 J9u'؂WiT >GgC=bP ܫJY:=G.mI=M.c#y=k.[LlHZ=-հLw~iz(NNh{c ЏtɅn"ȱ>s2_`%ek]nHżm+Z4o=0r"ZP8N;^aSf. ~suVdמAU-kNPVJ"G,dUAv88`c֜*8#`A2Ī ;B'8iQ5I_ɈV=S-SLzW5miʾтܝrQu;Y˯19@L4.pU}BԼ'WN6yE!h`W)%˺+_ibE+-t~.)d1 KJ{KjЍĩa#N Aڰʜk ul26ZFH^T:@-¤DnXHt50Z%}5kh R,&Nmq4i%}wL݁Q7oĴգCnC2 @N u+c\D7:ƴf( ˟/iMUݑ׿9(tB rTHZ1TXn 7b}='r!a8 @+Ϥs"|^/imU]zN`4sωgTiފL+6r=^WCn}?M PJ<ҿz?t'ۄvMLtK3S NXX-q" 7Yz˜r4 F˨+9_҈V6Wǯ+?[y^$Wܴ(QTLtldܚ)'TTA[KxeSX -8gl@4c="2AS'D`t!NX\aJ>a=*!N ' qA8 Mz$ izK^5aEA.I'8x ߵ(=UzМpF J{{_m*<=Oy7nlmmEf+WkXv5!N»_m +'_~w-='.愫_YEqMzzw]'W"N rrr" 9ẘJ J棓u_(S*Y@4 b*-uM=.R6x5"Ǘ ,f #sS֨Zu@Ȩ SX>7 N eq:::bݦO@@0g4iyyӍvwq95`2 p@@0gkE&hpubkUQۼC.<~5tzLpuKԎC.4.5`1=9 N%':wC[`lA:j$u4p1{G5\Y6-NݵkQ]N|-9Ͳiq];t59ᒾD=u%QB;!lSw$f3] vtM7 6ĩvM*h59{N);턛HrFٜ8uڮ GMNgN}q½Ǵ 6ˆĩvMVVV|?s:kwm!lMST0eZ@KK?{No3d6!Nk_I4}=CD SNNNzGm='ѵGsm STbLhJ9k5I`GĴq5S# N .q]>M@k8`ZĩvM>=? s"Nkp||@hRj2R_ e5"T~&7rޣY]a q:2-ބT ~ukqYQjĺM}z[ t­MD[)ǫorݦpkRqYQzc$)S?>>'yV}.osg %+o7q!ۯQOlKǾ>*:PF>Uĩ7vM* ˥r5-\dCHWH!b(Z>. ϥ}ӣ#8쇫fF~Q7<볞C>5@ RQ[?\R6z:t|'\>gnc_p ]L<%Cr>5|2&'\ qO55 ;7B%rƾ-VIoDɕ%ĩgvM*z61KZ<<^\zڔ~ 6]Rgn!c_a&B+~o2ǁ:gNYBmׄh/焫'7,t!ט&6}l=3/x7Lћ$ߊ ?+D2s!S'N=kdҥKF'\%˵v!煋I2ն {!vP$ũvM59@MA\v dpmABzoa'\YvⶕvGzN 4H+vTũvMNNN,P$='Ҡ6V &Dz< 0%q]A `&'\3'Ui}>7N%' Plv8ũvM2sUUFɚ0M4_Oڑ'XK\O™W0#$HW(vĩvM*nݺŎw- A)$an;P4&ÙNS2ll)&mI Į `Nôk:88@" (@@0b:T,--&<;{E;: tҫF0lw=F#,Upqq1@G avM:AV @4(N /_#w ʮIAq:\C>]&7Aqqrr.5>'vZ OX,L3빰l4K5Fy/Vn󕨭 $Dm 8@7\[:qC^!GeV-b !n9kLv~JeNԚQQFhRRb´PW+fû[p1,ĮyC>&+q:<<KjrM5ɢ5[q Dd{Fӭ?dlL&.:r :tqqw&AEc%6Zq['<0yeMQiI$n$2'N2y0?%vMœH`tUlHsRu='6=rEoF '!K8}KI8٭$NϜ zBy@"6 &RgMm+Jb"ϜƿۑCpFW riU@PI(j&aKnȲ,&2u q5u.3jS[ruAU,QbTq5=>Y5Re`#tnG<ϳ&OS!bҮ]vxxȎ 0S) @o*NnBϩs`ݦɟ|k_ۿ{yve^|Y!T$pߵTo|˷i*D &H]}}(čk%$N=K_^~ v7V91݅8mFh$4w@pL`p v7 ͉2Fp *'v7@q& (MGq&gÄ7+OoGkL1ipG &iee%ΦF8>>)+ɕklm?qjM.^zbф i 5cg2R˿:=oGL7Oݗx: v_V}:B'q" Q纅!_ L׮]Cy8.{PօJ7WKs֣ {6ꊄSLl\Bwpl[4%!ӭqQ`>;3Z< ^lg$EOw8mcJf]GW8z?sޠ|lܾ}@qڋP o N`Y85ARlW|^Rl\\\,--Uqjl0ev ,+l6C"S78XV7n+j*'pTrСظX^^.y Dß߬g{~8cq A7&mί<܍[.%.gl%YZI{(Ԅ\=>=|s+~MԧiO5ۯ-aׁSك*T+,jr<~~Gg/K⟾?=GUp!kΥ(NIR ڜI=V9(o,-N{r? W?9_~[/~}s>oPS)Qz&]oI{yrT?%%pIs2^3gr๑A)ȕrt-x o}ܿXM/<OlIK$Rd㿕:/6&D; 礮WխJSOێQqq:;;뮻j0Q8-// WqzZ97z#?>鱟xxۓ~c,/Nqi{)D@zCEϤhqLK5 })R! ՋMy[+\ prrRb+j[noXM߶W_UTdXORHjX7t*?ʌ0rx\'cAB9 T y)q*PH}&` YJx1*N?#o{rC߼߬2_W~qo|iёoww[4NiC'P8I6Q<\8 ƺ(NU^xgNj{k~{nW{Y/O>ȾugvӵЖd/jWVcu2 {^%WPH'iccS!~q*z_qb|#?~OO}~[}k7-5oX:!"iM&DT'C΍R=kσB:)N04oq|'dgDT$zqCթwT*dOzIrPB'N[[[H  oBy4OOA)q:::rу8%9 S NP(N+++6CC7n.o!N`"Ngggpfi<[jqJǞ  'L@*NۄLz0y, ,Hи8]\\jqJ8mll +0LsZ^^6.JrOn/%Ү{sIooof;'0l4Ϝ>_>_PiE 2ncVFj"-q79oQV=mm6Qwi+/QϞsĝU[/M..^YZzM6<qdž$NO>폎O|'ؿl!}{.QmJ}6Rʯo.qLEvVc8Q9"V|ݳ@@ݯŚ,! f=x 8[˗{?{? D5ĆYo,M P5Nn-,y,yD¢$Nƭ&?AĬ$V)V&['-Iۿ.on'l4z>{>'_z{؇{nIYx֭mM9_Zd|DO[g?ܼxJޔ?MפgWo|/M N Ͼ}Kғp}`lK&=wMo)Mzx'ma7Qh6wߪ?w30ˮMy+ʏ+A8cӯ|S[mFلq>j*U4{3Q5s~S>W 1!N [$h0 r@2z?Sz 3'0l OA3?2e'l":O<ַNկ N0o\@B@a/azyHu'lX9.]Zz : 8cç) t֞v/3V8cTrk_ԱX/?\+b\e4qdž8f;Vj) +B-lM/ٹ{:{B@@a {}۫ғĩ6X_⪱smc=% tqp?pӔPN8ЦSYׄ9+ldm"&w؄{$ ѻٍ+z'l qUK+~-zXbiaNMތ3 qdžNT'[?m3M"ڭ@ zD|/bWܵo!iZW8cC'N?[Y+O#U.M[_NktR8th5Kڷx$ t:qrr•Zg\r='٧αaiɞYնu8x̃8cC'N<zXExNlhi)'Nb[TTpLc8c Ns E3R( KAq!gGfx[EceMj[~/V3֣w=PB@a'Lf H5CS qFQq2[wreM!N(!NGGnl%*wN)˲P?6J U9uB@QnX`P<;{Do:ϜXɜ[$ t1}@֕7 8cJi<w;K_'l6uaZD54rZAJR<8x7!NЉAO\$n4VY;I?6 4:Z:LtVYY:5nl/bLIͮfQu Lxa[u'lũ;[2hug-FfB@т8)ô aU"H8c5qZ_ ޛWltѳ^C@7C3Ae ,hA'l yqK: t|v76@?Վ;I?6w^ZzѳJph8cû8ͣΓ:<'l N1a>4./.O'l"No?>_nO?6W]{6 qF d! GG޸j@@8}~TU`w qFNjsU'Ɠp!Nh 7s\kE'\*Y)Ne[!Nh 7mx\q¥7m q n'?.]zUݦ9 ; :4_6O<)FJ.lpyA:pGl8ɫ,D?6tT &'VgDYǃgJUqdžaBDI'\nm614FK,R4 6c~!N0O%/儻hYy;ҘX'+L<,{GW' tfq7k6 I?6Z \jk!ՐqFⴻh]Ak$ t!kΖ^ `iqF4W{X''@qF4)Xʕ$!NظtU#$; P𱿿 ߵh kurr@˗/}vGw|||ttTc89-vww}עX.]t~~^ok׮[,< NrʼnHCnVq_W @\qxxx||4oݺO@+WRt#4&NL fkQ3_Ύw-Y ;ǘTZZZjk }6qpppڵg^q* OoNX_899S?q}Je?k Nkg~~ľ~8;;-v,x_F\\\{{]6 NCGĉN3V666zZĩ$X>^^^ N'vn}U^xq gK:LERid s*^8 NAէ` 8muR<e<s@ NPq>ݸq#7WQGri.f2K&!\__OCT3x}zCnh4 4|:LsQrHNo|<DL+pFL#d. N#ӧl,XJ,n⋯}ńxJM ~?o2u`]9y.Sy@kC\+b0q pwկ2wLM2QH2ΰXCTyVKaiyu#6cmJׇ9G|"xÅ( H:)-dseIJީe^У٨8ͩW8! p%\M!OMCppp{퍍  X'-[y ^zUFL%7n`Ki@"!N [=1;YD !u]YF qRoA8ob%9;>RGK~DHyH(NXE "}XY!.k܌m_dw1x kX0-&` G1Ydp,@Bn(?NjZnU]OGsz{g]Uڑע믿O!77 :q`t'j-{yo7H@S|>zcO^${͖W ‹SZ x{/\}5[2^S<2MgzfKrf;_ʷygӖlqU$~PSѴsWQq2p/2Mt#b~kЀTC")?/G~P^%lOӖE}!1W&(&|f~՗.7DTe[|u'f8COzӍqSs8~fK>w{թB[<;L11|(I4ˍY[ɧ)Ng^9L8q }Kٿ:y~ )F>zks^zn\8g i۩kI.u%͊o qrʹJf-p;Si|Bh+ZY\#MM웢8]|rz_xΧ${_̧ٻ{&1/~hb^Ojsy GQQqǯ<˾v%=kCM,T1wJMuZ'u AWIOWUήpNY鋒KN=G>PGCW3.JVo~I{Y5AE/ĩW]z`/;>FyD'^/[~_Ѻ`jHA/+m_)[O2+9<ٍ|м(SOs\{< ӷ|- zm=/8bG2IxԢ *ڿѽ4JJ=7X_/b!$F~%Nn=oq4R97'wY–\${n=cMPle&kU=(_M0_5וzu1D\xm77R[B4yn@F*1 ;{w?|[^抯qj~wCWtܾ:[%I DjUm.V<638i8]o>|n3w{=OaBHd*GMwb!C=PBz)о S78Y["*jBwKvWt߾z+ymH-OodF2z]|K|{5["*B#$NKB>ӭ}8T {_k6qG{>{sw Nfμr\;.}.gX`n80Y N ] NLHd8t80Y N ] NLHd8t8Ej^ffwkN[3~2YqBr=~3"⣘8 #A$Ahqj̒lX Z,6ۉI^!VީV6yjҭv.b|w sz ֹ,dͬ_'n,e>jVys!*ʴ~8*#&qB AdMCPh KV,ro5G2^/dAϽ߄]By%"ξa 9ävojZӠrf؍kvX=vu*cnD#NH$w@h\ Lɽe}I5/.V?6YugR%ºa 'T[)~-Q& EmP  v j8b'$?A N} ll"ܫ~oP.n|":yʧpMkV_j-Q drpN'jƶJp"'$3Ai 27Bi[DD]0TBĺ'7\ɚZa9RAE?4W NDAx&ĩAwR_7:EWrs}j%ʅ][K]>Q1nO.G]^yH} AiQL*E H8Eb݌ @E\͜%7)*Y!%>dfAԁh@~=ՎH¾;pt5[h N7Cq1@KLb 8)RDRJd8t80Y N ] NLHɊg5CAɻ,@$Zi 7=3@ 'd8t80Y N ]&+NEA tc6UqBn0Pz#A NLTũT3Ykrf#H@,5!Nq`@:ׄ8 8=sgo{?[(T[D%[DنXr6 N ]'Ɵ,#Wsǣ9I3-JqC-Zs8tQמly+9{A C8'=)r^0+= @ Kݦ9' N ] Nt!gNwqG  ɒ8mgE%!_m]y?] ɒ8)F8L(ٿ*Μ)nL %UqRvqZf)N/LR q 8f%f]/tӓs=~BJGNj9¸0ѕV9漜ST/ݟ݇dYp&nz?͕c5p#UJy*z`_8Cloz^[Y~dR祴d-n\V)ủZ7I03ĩb~{8 fqrr¥_jYRuu'SܿFrtƩĶZO$JⴎnK\ n)+ U۬_ɆCoYr*Qyu%^ꬥ؜oK#;qrr&Vmkfj/8A,q759wݜ7n6s5L|+~"fԃ89'4^l-mIbMMa{N 899 ԬRyj 6N-'~xStD(N'R'Nvie!h9Qtsd'NK'\!fVrrfK[n}ǜNcN= qq`@@@,'.'& qqu*刟ko+rtEctrS v:8ZvHUƉnB~rIw@a!CwpdXWUf:-rҐk$*}?q y;Mϵ?̤M S7'\l=y Q⤜ËS?A3$&NJlc0 >) N>(Nv'ܥnJ= 4'ZLe;XǷ`5+n-ҲsĪM%E)%_xh͡%ls!'< [OPS~GZ"$wAn#H|4jlq`>񊓓'ik4\3kլfJe:He9Zr]_:RS뭶 :ĒjT!{qZSKZjh+?1)ԣ]5 -2بt1$ p5腫]Trj9|?׺߳rF~]d'ס~?p;$m u^&LMO+LI"e|hn9F'UDwֳ9՘4LۗX'rCwՙz Z`KI>/g_S6"W+gw+$K2(z''#NF"]jku֬էa]m4ðYikkR |b6t-'?'\{Գ$VgcݏQS9F ´\ eێɘ\-;ʼnmWv[Ɯ3a &@S 99'k9w+Ǚ?>)t Kb̩b~{ňsiqKvԶ8mvú- /]=,S.BǼ&ߙxŒg3!ۚh܎{H夛Yk~9mlӆМ.."o˜$Eo9³`8F+N2mF</Ap8B ݭq@21 qv;c9 '& qq`@@@,'.'& ĩ?'bI r#/q-%w𞹺wJՏ ĩ ba?aݠr?8yM N}5oq޻6qJ0˩Dotqm­)s­*ur;4iwъ1hՋ#δ:37r*80AɱD(N[QӒq&fd'N0g>D(N#XQǝ6qj>}Č Fb7TF"Bq:?HN3ىF002u I`59F\hˆs)NVQ'.5$fd*N9#|V|Z/>| g.*N@ }>!N9#LHUnEއ:dIW80Y N ] NLHd8t8ki$1~h apU;FEQWgz TK.4:ƒѢK&lpxɈΊjbeİYrAîj|QV{0bh3 ~DzWO4[8D(N~NK*ɓ/tOr:5ax+NNFR46=Mi9jwNXdIh9}RpIIJcvF5Fn5aV+NKW#N%ͥѦ5OYn%uYH{z w"Trbɛik5FS:1w̩ n8-]p)w]pmH4q4t[vؗϴ ~:7i{8SCtw]2Q(_:BQ6iGo1^#V6a8e7El 007,2DD4 qq`@@@,'.'&ˈtgPP:BCD& 'N((qS?q2NpbfUˍs0 TOiu{г&}rf E*㧄Y|8'csl8He0n3 ya)tѫTz^}B$$o1n#\ 7es|8HeЉa6br^r,iX<#+ƨ¾kmf E*㧄N8->.-e/f޷V[7펃-8eЉ+S^V(ϭFۋ%pfu#R}m3ℂ"SB'NNF^^-r"+׬7,d!X涙qBA)a!nisxX vm ݗKZLڇB7s|8He0 Wu߭x_v[@~Ky;œLi`n''fqM[0 TOTĩ'bH`n)' Sm5lyqBA)\ TO '' N((R?%`ĉ2( Je|qBAAAAA %qBAAAA?2. )IENDB`java-design-patterns-1.16.0/model-view-presenter/etc/model-view-presenter.ucls000066400000000000000000000151521312550536300274310ustar00rootroot00000000000000 java-design-patterns-1.16.0/model-view-presenter/etc/model-view-presenter.urm.puml000066400000000000000000000046721312550536300302470ustar00rootroot00000000000000@startuml package com.iluwatar.model.view.presenter { class App { + App() + main(args : String[]) {static} } class FileLoader { - fileName : String - loaded : boolean + FileLoader() + fileExists() : boolean + getFileName() : String + isLoaded() : boolean + loadData() : String + setFileName(fileName : String) } class FileSelectorJFrame { - area : JTextArea - cancel : JButton - contents : JLabel - fileName : String - info : JLabel - input : JTextField - ok : JButton - panel : JPanel - presenter : FileSelectorPresenter - serialVersionUID : long {static} + FileSelectorJFrame() + actionPerformed(e : ActionEvent) + close() + displayData(data : String) + getFileName() : String + getPresenter() : FileSelectorPresenter + isOpened() : boolean + open() + setFileName(name : String) + setPresenter(presenter : FileSelectorPresenter) + showMessage(message : String) } class FileSelectorPresenter { - loader : FileLoader - view : FileSelectorView + FileSelectorPresenter(view : FileSelectorView) + cancelled() + confirmed() + fileNameChanged() + setLoader(loader : FileLoader) + start() } class FileSelectorStub { - dataDisplayed : boolean - name : String - numOfMessageSent : int - opened : boolean - presenter : FileSelectorPresenter + FileSelectorStub() + close() + dataDisplayed() : boolean + displayData(data : String) + getFileName() : String + getMessagesSent() : int + getPresenter() : FileSelectorPresenter + isOpened() : boolean + open() + setFileName(name : String) + setPresenter(presenter : FileSelectorPresenter) + showMessage(message : String) } interface FileSelectorView { + close() {abstract} + displayData(String) {abstract} + getFileName() : String {abstract} + getPresenter() : FileSelectorPresenter {abstract} + isOpened() : boolean {abstract} + open() {abstract} + setFileName(String) {abstract} + setPresenter(FileSelectorPresenter) {abstract} + showMessage(String) {abstract} } } FileSelectorStub --> "-presenter" FileSelectorPresenter FileSelectorJFrame --> "-presenter" FileSelectorPresenter FileSelectorPresenter --> "-loader" FileLoader FileSelectorPresenter --> "-view" FileSelectorView FileSelectorJFrame ..|> FileSelectorView FileSelectorStub ..|> FileSelectorView @endumljava-design-patterns-1.16.0/model-view-presenter/etc/model-view-presenter_1.png000066400000000000000000003117461312550536300274770ustar00rootroot00000000000000PNG  IHDR2R1l IDATx \NQ~$S"lc-a?c# )[dBi%˨Ԙ6~~cn?3By}^=s}|{{sOD"H$)H$D"D"H$I",#H$UlɀpNXF"H$E k2P ^=D"HbEXF6lH$aٰMXF"H7Fe;wJ o H$ƈL+|>*| ":ujԮ]3&[ՠAR^4aD"XI_u3_: ԥcfnA0Kоo]|LXF"H7Foݽ;յz@ i:2bYBB;fe,Vryħ62*oyիv 2 feeVƻ#%sl4ť.'bUIfm&,#H$@cVl:s&EG&72'94cfػnnZ|Փ%q,wrrl26o٦͛{NJ0={vfqO\. #1aD"=Xu#rKC39ݽ}&A5U?6v,C۷ZZ޻]Xkmm~b`)ɶq,!5u.x.=G9ܸ\.*%e̷Ąe$Dzc`ukOggK'oʕE?㨒`YjvhyInIbGL^gD\кX˞>-Zvu{( IN$u%fKcᇍ&(s6 ",ɓ)SY[Y8L3x\.)$3K?H$JX! /Xڹ]sg_nF4jT^]]=;޽5{I89q>Ղ{ jTs`aNlԩYx bo܃Mawﲲk2͏Bݻ?I^vuBP=ej֬ҵҦ&H06?qJ3a>M2;ujAxIfb H bIT;<[vap:H4k6Kh&]yy U|D*e֢ bZ\ܼƱlB w`^ȑouRlo2c2d d˗3b^a?9sF`}s]:7-cZ 7om<~m7PAeh 6n؜7?=P I֭=~~-iee.׮e6n\? EbiŸ>U*12jj0%͜R$IR`f;\h䯷/{j;'p֣A;i-;wDlXK.I,͛f!ɲe}}1IMbMID>5TeiiH1@!*cҬA4? NJ#:8bWժvs,wڶmW"?I)DŽe؈p^7~ZwSL7%kpDmfMXF")\ mks`ȻY?,<1$޷o9-,L1lW~ȉ v>:a@-YkUT.S\ن=Ka76tCU z֪!>鈈tj5^=n=ۥ[8(f2yRlD H pd"i;.;8aĴYwOl? 20DŊ&&|2'g0ffSF5ر$mS-ٴzXHH*twwfSN #3/o? F θj3266By#rtj5|blzzt72LX&OJ䒛DR^{zXa4rԘLek]]Q׿eMAAuϯeYՌD mSYz 5c6}\}}"r$VL cY (؏BO |Q zV}Le*̈́e@. H$KA>q#Y4>@斎C)s^I`R[uRz/)JCe{c|k2yR~D Ąe$EAl&,Ҋl}n\%[e@_LXF")\ed6ag=X3YzVVfm6xw AA[zm\֭ʷlY(2ܾAZ#G^n$I",# 5G{.?>wuÙGopUC4Y[hU9WI>5jT^]gg$faet`ԩٛlfVI^ڱTR 'baXu5*+W@:'%E ȿp%wd-Y2ԯ5a<${cs-;xGoi`$D5եmȮܲ.I,\2>>M;o+Td&kòw"矿9#پ}cAu yLmwkU/*W) X ˠ{ܻھ@XF")\eΏ,,-!8ymJZ\[jX\ۗczp8mьѝb4͝;"6v,Kl$Čb/G?\6!ڰ-y֥ۼre6SݻwtpE~ժvܸ1 _v[a0,c kV H a6cQ.ȑGbu>ssW@zg[~͕+'aW֞22Ϛ1òԹςj _fRN ]`޽{ ]DyhL1.K&,>6wٳ~<0*yg7+|yyތ+wZjj~S,c{to]Նeϧ'"yҫW? [q2tc4jXT[aPUD")Peq#YDl:!ҥt3n`C\ Ki0apvaaڦfwd[Q]-#粒\ "aDR( ۄeDMXF")\Ɇm2y`&,#. d6a>MAEG$>zt`tӧ}n HO[~͕+'aW֞22Ϛ1òԹ11"ލm_,u8yrr:vlvZf`O6teGUKL~^]_~9]޽KJҧ?H$J# w 5P]nCWF⟻dLeM:bOŅ͟?zԨؼqc[7c晀6$sBb߾l fEjel)Seg [`s}V'[kӦ+J@"(M,] @ϣK?ȐɺMX&OŲo7 1,{uK`jhwt.R˱\eG$y۶ԩytH`իuRMa.GAH$˞w IXkWlhh_$~ ؒcccQTmZ^˶n ڶm_Zp-^ĬYk",#H%&q|1ʕr|YS*1E{gXƖr"~ɓb0Wmӂu`~$޽l?̓ܥ|H -;8AH%:z$]Q(2;4hP?uu벒 nnff4jT_F*>J" Y@]?¬ZNψcqFWf "-X%FǏ' yViiړ됃-X@bl?chh_vw @"o]˗7:>=;d, lbu߆q>d'N|NX&,'26apyj"M,+,ef.7ŅM= QaYBBxݺN?jS'NG=k,58sΝ[bW([T8q$`/~az"YZJ~oCrrAX&,'Q XDҥ2aj{׭` P# &"+e 2؀ov?L mvSlMgs'O##ׯ2%l-[ֿx1?r6lSXOiH>x LP+goŕfg/CڵkLX.CX&K#Mw[F")[% EEy@+GGjZ/[6ta$ڵƍxxԭ4{vyr5_$2j_B]f-ejjRzeٳ[XC=8QFKN c߬Y;2vvֻvMu &`^#saaDRJ>?_nܣϱ(I3[fmzƍ]/=0ӆ Ҳ-b0a< H$2Anjv3f 쐑1ԛ􆚰L(" H$$A&izH]LHaaL(" H$0ٰMX&O%%\Fjk{_%(߄e$EXF6laaD*E ۄe,7wE@W3YfBB;oY2SS֯_~ܸ [8 wJj_*(Vw6KuG3S4۠y 'N|>pߘ1+Zzz?Tz@ ۄe;"~4g ,-MׯvbzPoǎϖ8s&4sH2ϟO ֍,,L"\b I,s6`.a„/gت K+Wvƌa(еWH$ IU5a<el96ԁe zy5`gnEׯ{7Mȹs'+6v,+ֶmCV ٢;8Q[IMʗ7OJƩld&6H^ڜՓXH W ѣCml,kx70Ї= /Q_bŲLZZ0!ɎHXǧ?nqC?>(N܄eT,:,4/lkky,j׮no_ukO/'7._`kڴ!ffK%5 ,kЕoӧS$#/A ,pP H$XйsO@?GT|9CeYYK쬿j԰sh֬P>Ȋ2aeժv}vవlD0YEQdI;;k e9hlbS$#)6H^aDz*߄2/ӔBȑTf*6\aY`boN}"LЂe1%'Yr/фe]TwLȥ9yeOiᇝ b^^b,ۿ6,f%D2ǰMXF")\%;by֪U599JV?Ĥ$OjH\nll԰ vtOO նmsaD79%L ۄe$UeMQ5kVaļ{7;wLf޾[Ϟõk}S ZvPڵ+>PMC}Kta5P'%,{;MX&Oem2I*y^d<ЧR%+80p&h?4տGAc.ϯ%xʌc φ fn^~:wnall ͉eo 䉰̰MXF")\/+J2 z~N;cߧ=L ۄe$EAl&,'m2I L6lE6apQ& zZt}NVaan75DRȆm2y*aD>~e6 jƍ]8ݪUyʕ_DVRjhe&nǎC&~]+aDRȆm2y*aD6?}:psA?,xry XXdg/CɓE:;;W fb0&,#.2aLJ-[ťڵS;uj.rsWxxXYث ͜9߿ +#Ʋp77G3w57sѫbEK|*X…N{y5ebRs򲲖g>јڵ۷bР.~~-ԩ a3&t9~lsY]L(.?H$l&,`lSSӧS:^!&4))ʕwe1,{+%e ²3gRdG$W;6T~ ]ATGn*S 9wnAcc#Թx8T2oދ\Ȩ\DGCL\3f C!!]z!Vd}TrӦnNN.?H$l&,'=cOu?R׮erX֢; >{v+8Lxej{ 0e(v&A51?6v,lc'0Y.Shknj H6 WڜepwwFb XڵS H$Rɥp,=5Yms a}| 3}c2y*xIYX6m{q_α 0]9=}Z>d֞ F..Xyt5Rl!?rfzg&&ONc_De|?_'dܸYH𰌭sh֬48/% ɓwˮF/e~c |9%ƲwXݞaYBBxݺN?ի$s 5M,U*[\\ GT!h< 2a

˫+ 'A&,W:ݗ( V{E(,Ecp!-+k)K#y{7z/f2I*ߨCs՜,y[&h|ySŕ߿Rߩmm-'A&,'6U<ȭVnƌa1122z5apde[`_ݞ]<]N6JNՁeVMNLب(O `GG{T[Pj۶9ڰl;`Ů\Ql;w= )&,'2Yz5ah 1MXF")\%[&W`rT2ңGQt9h+9aWej3wڵk|)D nu֞k2W`ƐU|𾧧 M D'O##3V²7݄eDXf&,#ر@j;ysOtdv 5aWej3w^~~-[VVf,aq`ZZ4+'$Y +܄eDXf&,#. d6aIO${do!`ɒlqc$2!ŋVVf3HT?H$e-Ӂe؋ɓ<ɏ _&ۛeNNj׮㧸>7vݺpahmmoV-CGC1Tw--MID:)) 6ɓ0,mwܠ=ѻ#cvG"r02e2ɞ)%cd8~< utÇ0,<` o6mWzDR^{tc11LMMWzVΚ FkY +gZWƍxx`<{vyre-Z;;; J'e4С-{LX&O:"O ^6 eTϔT _teժv}v<y{7]Akks K@ŗnSl۷b`\l1T%YL߭[}vnbeeA(_ƻ#YK Due nnff?7߬TXVVZ[wޥK[e7a<Z_BBs?hAsׯh?n\&1ϞҪJD]xw sT*gQĤɫݷoŠA]Z֩Suv\`jUQ>>MK$I|_l*Y[7=ݺ…4KK]۱c3AyregAfHH@׮^jK5\4)){AB+mx⤧N%X~cΝۦy ̙#GQ 8؟5X&|9sjMv)߄e#"tO0(ek!M?Hv|_Ār0цe*;;kmp^]W|ӫ}l ǣ̙ÍP~q?+ƫ_cdT."⣌!dBmiiшMM999zH$U,] be[(~ݰpa(Ɵ,A]_,ChwwgA| ..E wa.x:p.=Gn,IO$&+`YF4+BZe7a^g3e+۰?0l'aMX&O"BCSƎ>IOA2Hv%KƳZƍڰ,8?(Wcyh{b:pv7SS6m&.Mtx1bfJN◓AXF"$s LNJFz"">B23{MOGFG ƈڵL0#,!#>dݺ>>MQ `Ȱ,'g9όخ]Oqu}Eݸ 1pahm < ds/ӧŨ[PMl'aMX&O"°qDFA2HvǓLO~ۈ C"$kq4*m{ml,y;A]_/<?`$Ы147p^Xe`A 2$W%&flX_j83Ԥzl26!F˖MD%u..cǒ{Uky^6vYZ],aXDmܸ سg ?x ,CnMVTwIX|ɓ.kWfGGeF M$;ekkY]߾XƄb͚۱Il*a!7w^oF+X Y[c&[Ψ^ݸ1RO,1jd)8_o8#,# QN0D+,6 ra|u}{/։SK嶓ɓ}{A~@g]iJxh 03Koj.,rWV_l,f2I2ԥVdf2y2ȈiA۶ u;ҭ[{^NAnjv3f 쐑1ԯ]̈́e$eAL&,'CǏ'))_鉮^LLt>AQ&,#.C d23a}u+.[ KkUbwᰏOSݗ#BkɊ5a<,ӧ^C}NJ\rR@Ko>..lmm-4q;v,I|-C^ 2>|[VEEy/BiMe$U Xtʎ="2xNjv|='b_~R!,{CMX&O`}˗3XΫ'7 ҍƂ-IEc-"MQc_#,#P$#du'>8o̘-==]ObAAuѣ;a'[JXP#׳g[$if`o hX,C -4i}vXz2?ѵkH&:~)܄e;"|k[| ͽEEyt5ލ25P4+aX6spAu 5bD/)|w# Cŋ- 21)`Ҭɯe߾v~~-ԩ3ꈌ*`jUQ>>MYfaan*Jv,l2ݾ}^p?k'ZFą_)3rH$Kw}-W0fC$ՋeIܺgđaaCWAr%J",s6͖2h Ӥ4`cյzb맹;cHOpܹ#jr$k-G<\q2LtDILqbm\"$V`mx޼ԩdtgJ%=!r0,{cٙ3)#G/2;6Tl2qEpѣLD020 j[x*aZ(#cȈWUZZ4>Mݜؾ}c6*eqpݺݺb>}|>.YZ"]Q/4~:}bapef~2kks TL113B$!f\\Xwf85Yg6lA|}1#ˑ{۶mꏍKXpɓ0n[z8l"S\&5u. #=3tuXҗ.Y 2A+"4p,C1 ]U`jj9aB[4΅]|9#Ç׎kllZ ȸt\)\v fͧ|C -,E=^^ ^~}8rH$X,%ucrԩ2==]xa ;ONc+_M6!ҥ#nĭU+=_dm'7.2aMX&O"ьQQrf}Lq'OLdggmee6z 3ɾg?]Nefʱӂ%[Dj<~ɿY~ *m}?zGDc |Bq#,Cyb,?>@&99 ۥ˳;m}<x~:}bapyj"X#0CBȨ|]B02?}~; #kמ^YΧ۲Ԯ]OquwX@#GYC0G{7evȘ6t;8~< db e n2y'2zwdH$WF̺uS}|{e}IЯ.'Y2l2,[0MeE3n,N{hs 7oע?\QUv2`ˀz_/ b_ժvUTbAP;'Onz$QNDXF")\/eڰw+"=~u;+0dH74GGɓr,Κ}ϯ%HF/h|sٲWhuyTsplر$K_ǯ@"7xڲKXm5{ҥWFr隰L^ODнZ9hʕ~Xfo_ *MCtcMbcǪ5Ƃ-ĄޢEcv] $I*aNHwss43{Q|9+ϯe:5~p2Ckh{y58p Nb)0~ѣӧHa}G%~yɓΚ1䅛MV IwDd"RSzzTj3ǧ)NC^e N 2J͜9߿ +#2zѫbEK|w#D Cŋ/OYX[J;w ebR#WQQ^VRo Y v]%c%O齺@"(AV{L ޑ#``! Ȩ\DG6-,L"0D</X0ܹmmЍe@tu8}i޾\ VuUdu^6Pf*^dLtDILqbm\"$V]+--ԩMݜ7NC`;wÒ͇0,{"cdw-[_4ljgg :ztHFW,pNx8̊ _#x rΘ1 KۧJDRŲa3P ?5lvilX?7@\\X(=SQ:$O,ǰre6N?RՎқMV I[DsA`حGW=w6).t_߿+kNe`!ٝbi/^L2J no_1cdwE,055a͛0Y.S\akk):Yڇs1cq-v_8ڜe"a{D")Pb/eOEAHlړD!BiCҥtɣtX7IjĭU+cOS ]\|_E 1a7Kׯ__h1oʔA|IӧSX#o] H~z?H$JϻeWibYBBxݺN?ի$%X?A5DIOINbsतI.IV"ƲwXݞadw qB2S ^XY֯s6u&cb,-X&@"-[0Ggsm ]]q*,̵4=r$X+ɣՃ>˖Ũv߿/>~ /,2Sܽ2vfdG v-3:z$ܸqEƾp 7a&xevtTf,nTGG{t`N; ;eaٓ'͛3,쮺L[;pSTgmm X 9wwg\ 8 ^/pH=LۧDRJ" ue|^}IB,4ɓ}{A{/\Hcߠl$~y pՀYzӦ(Vsaan \O%DR:Y2$&,DrU1cXL(gg/>-h۶᯿nGukϋ__ϧGXF")\ed6a<0"\8} ǓVnvWH aٰMX&O ۄe$EAl&,'m2I L6lE6apQ& "aDR( ۄeDMXF")\Ɇm2y*yD}{{٥~~zcJ݄e$¥4,[nA2srrѯ 7ńeTˆ0|xOہ4_ӯ?+>|tfI~|IO>>߭[+ںk}mHAXF")\ewd|sݻ6S #9! ʕ~X&^qRy拂K=yrӐ!XzӦر⽄e$Ii*I>q AY,?!!Fj:V1c+Vt9~<]beeV.:/iW͚[vKlM7a<Z_BBswe˸TC'ԩϾӴa٪UP>-@oWO] YFwG"OvWf킻tKVR \ejU<+hC.]JME#1oje:AN*@"(AVۋ8'M<>')2ϜIA:r$߱c3V\3f È7$$kW/AаiRR2Ǐ,s6VIbBnjPKlM7a<ݓ& JڸEH`Sݻ٦&O|uCLɞưl%K3 ?|յzb맹;?~|?ܼyf67o9u*= Hk߾1,ñ&|9Թs A6)N}b:Ɲ,|Hf:Pi@e'2cc#61ȨܣG!ر,j$(*i kaQB1-1F3gg^uo I[DsA`حGW=w6V rZ&(ޗ${2''gy**Wa7x{999X [ y͚O& Q@0z^0˫+"N0TZD")Pb/)e.|} <|(B}֭=YAI>aoשSiӆ K/e8$ Mb2yftʎ3oMdӆe=Mܲ&MZ`i^'S Pl_4w쌐Ǐ2|Xְa}.fѣ$3u_aDR[v5z$YZ"*"/_+,MH[6"sy9IOT+ ${,CZ:;?% !?3sC\\2]/87e+۰O?wgΞfW([Y}u$I*ܲm EFm If vu-!ID:)) VD99Y899]ªՆe/ 7݄e-" K7(zw&p5GL"D!D)X`JeIĘ --%Ave(BT֡ER 4l?D"T>3szo>u_ys9ٞ'(LPؙ y!R (,<HfEIIk$݋ eqlHef(s:z6嗝n*E.lccXܘLkffDE_;ɛ!iTTT2|uhrz h--BqŊijj-;MT[ys:Ɨ.m.==-#*œh `/ j ˪&1-?8ޖ|2L e<#`_6mرR..1dX^14G怼hմ³>OKJ²ZZj۸z02ر TQQn߾5gR3$おJUC,# H`VQY\UJ *XBIsՁbY$EIXM:@Fmi^@g84q# 3a ?H W3RI Տ)QQɸj˨e˪&Y`̲EX'JJ52**WM3Gz;CM-˪&928'':##U\p heTT2.k٦XV5AMJEaj6ŲmeTT2.S˷)UMEoS,qFZMj-|b6meUm˨d\5oϑe/_/)Iz5˪&9Ʋ/~&RLJUFxQmxx8 -gN8t۶suM_\M.̌nN%N-7XV5դEsܿ9tk?Z^*-0| v˗wunT*5A(QQɸjeZZjyyql|(nɛ\޷c6<~dcdE˪bcYnn̤II8&&8<ܗb&7266صkСZƚ/28˧ $iXPU9+Wv#ƍNӧnR߹s%[#ں'Zc/ef/7wA SSzz:;9֭%+B= E[XsUlN/,l!R˪&-KGfCCgDcarBI)ǞY'CC}??w8Δ%%imtI{,ܹ0\h~UTO8R|ǹF<dP-0իd弼_~)guybYYY:(6e7oơɺvm?{{88w;֫W==-Uv>cȄxٷoa شܰYs JJMKJZQpS XƤ-^< ^>Ldd2kɒ)ml,H؀ܹs!a3N`)"kilqPVn2fu61.}oI$.)5S,DJCRBqj&N? ziijΚ5Ȍ||1waSv>ζ `?,3s-&3%&62^0mg8#7|Z7&***w~K<*&6 S[[}̘AˢtnNHXݣiJ8!{6a`˲/1E3mfll0ysX Lj"_69/asID0OIIg3N\$"b>'-_><. N4nmƍ̱w@-&3e~~"]oeZi_ٺ5,,KKKsuuvqqy1211QUU~]rD=zϏ2,nnnL suOOO''nݺ};0UCW Er_JB#1Xu,.1i%ݻo"CBOCJ]S,ķ> I|rӗ^xaζ E8ᔸ8ёcbwT3R|ѺՅkewسgO~~"o޼ vڋ/I;wttt;v pgϞGGGxyy#2++KII)000))6we*)9j֍K\\/[6W˸NJZ#*Q˪&ym*+lm{=xE~>Abٺu묭I[>}Unn.b^|NRFDDڒ$XH++W|aq@uRQɃ#?~|rޥ6arP˸)UMr"DgdD!&*%Dz)S4 |||-."%KtU__HLe/C`Ynjy?jFG-|g}߿{1X|rGGGq/_޽Ȅ=z qơC Xhoo# ,BEEţ0bYD[6Ν;~gI ˮ\[QQdff?9r$`,WW.] WZZBDCCڵkGGG#>P,b6meUmgϞ=tPKKHp]/1TTTڷoeoݺ'O 7ssݻX#~ӦM:::ڵ7n%͛v]vtn2**FoS,h :~xwwwΝsrrjժղeN}REEE|ׯ"?| 8QƍXÙb٧E[{뗕788Nj*~TTT1\[FE% `ɓ'Ga%[FEEUwXF-ߦXFE%ѣG=lْOEE% XF-ߦXFE%իWϞ= [%***`sDž;-s%n%12**A]xO>+z]ZZ**QQQIe_O,~R?RSKbeTT*// /|IEE%]UXY%%iR?yKee/^L~^42*OO>˗/vE]5.aq5*C]cnFFdϞdx&cc6mttt4hQ)?.EӃ.\WF^>|@yyF=#"bD0U`?N*(8K!zrf+*2ׯرU2R1`JՑssc&MN11Pbe20JesOod +:,XSSծ bL.^ 3ΟDn '|6kmL>9;ڵ= =R]\>~|_tvr߭[oSIL`%&&?+ƍN(eK ;G>70[GLO'ᒒmu_+݋> <ܷ*xʞ=QgeTRj]RfeL`؋ܼ vm/{{<g7 ի(3;{(,]@$ޠAR932*)$$O>L**HZ{8;_G`4`K ƲVV^%÷n611dr|ynFFm4iLn,q&աC!ffH`y<{YHȧOOU+e+^E+Iŀe**$9F!al GI:::LcǏR932**}Ү"J)-s NI ǩ!D$; >a,[xF_%7)R?)+7ˋL,>`ɓ W X35m`n:E*+,uD66y|,366 0woHeEPy.:ș)QQUY}҇>|*QQ)DaY5n|=D$;X䲷$x( ds޽M b)9jĨ -_>ъ*(8Ѹq#DG#`ޥ6U*/e"QQKw7'$&2ۄRƏG}1rfeTTѓ'OtuuMLLF 1+**ƎKG:DaٔvgB Bn"i$IJ4 k"H,X\`@ `sUZdXE}@ĉ$̄k˨o3---q IOVTʩkٕYur}XVR_q")QQղ޽{gmmxbiWJU?Xtw.2HϢ*Q~%SjFg޼ujޕj WTdojuq޼IQSkAq^^\YPj.LUXXhdd~iWJTX }A*-K̡~zIR9|l͍4i83ܹc J>|(ؚleQ5kF&BJfffJ"TTr%X6z2 6ʕ$…m=۴љ>}4NcB)]x1b~$MZVWW;0ǏO"ƍNglaaa2ov-"9kj"2|ўNNu`ccѸq#cc-eS.\TΝvv[TU Uff pv&kA x|DeӦ:B ]8ׂ3O>HSRֶ.3JT2¹(QQɃN>=iWJ~$FD 8qcWDz0)8ٵk{_ghĉYWWsEEEg[\| _g[wkhٳ8??ݞ,kҤeS N?lpoL DG"02Y~872**9 d>vEwᓰt4`LHX.?|$a5,38p hDGI*S&'&&Xdm7T}bUiΝҮUC|TϮ̲AkR+nC12*z˥]*)e뜜茌HW.,<KS,WUTT8;;O6MjXF-ߦXFEUz捩 ]*'emeTTR[n}iiWb|btH"TT I˨˨J"TT F˨˨ŋ[[[{NjM,++Kg+P7hS,*++nj!PQ5 &z53yRhZXFE%eXZZZJjA,͍4i8 V#w.XXFE%}k.>>^uDzדLN[[eqcȑ>=Ť477TEz25Rzx8ֲ͞qNN4Il XRֶ.ں'j4CB܄. ڏ$;ztY'CC}??wefeT ƍG˥jŽ-cn믿zzz6e#x+"s=Hpnʞ=b}yy??;u("=;XPpkxI˖MA$`k0k-R^`J44ڵo>{Y_=x`b޹sTGGر0P b2*Efݚ˓޽{ݯ_?##իW:~Nu=#0Hvu|{[ӧ[M*Ԥ,="bW0"ML y|,R#m55GI(v)':#3Y\|KJҰ8 h[^dnx/2E32*2jaY~~… +**x_e!)!85dG{,,Huuŋ'6oDd=ݺu@ ##@cp';e`llѣEU ~~dVfefeT 'eriy²ѣGkkkܼy=K~8_y|/&N|TGG+.(8Ѹq/44T>|+)5))IKL޾/GIYHIP²DMMUv)GF.`ǀ܆Lo_j0Xq?فA˨N h:`ٛ7olңGSSm۶}V8wJ гAg!` 4*U湹1AAffx[vJ"DXڵGGƉegRz6嗝l! }ڮ^۶Q)g5,ɉŕ^pqHLLJDL_y.0;pgv{"9Ac_5k,mmcǦI)ےCO"I4aa3UT۷ou0I[i`H͛Oo-,/]NRrbii[Ip hDG f-P AnQ+)Q) ^Jҥݻb"yŲ%&&qNЍ%d좕8ď$7X&NW& TСuh T766 gaaYQQQhhh~}z̲EnX'J}gnXFpR,֪͞6p81,,pҵk{~~_L8%eQκ1Xƙ(*:矱*n!`J>9EE* o^^^ZZZ&MzjUWGa&99ثU\܊fEXFpR,;|xR'fb"3XUrnn ~x/A(81Ks֍2]KL,a`اCHcaXXXQQQQZaMJ8ɓkml,:vliӜNI`Yee֒%vmILlT<#*jIF*5=R/JF}Fd⸸mꖔ1Xƙ<~W/*T 1ݏ͞=;//D~U---^vR+)Q)YGG8嗖oߦܹK[CFru#K.ȼI&˖-òӦM6l-..F? . heT 'ڬs@_EEg%Ld=B}2 \P]m,kڴׯ]F$ADD+G522JLL,㫢b隚sνx"I̵H>iii+ɓ2ΜE[Nz5 Ç(/ϨFGЎ˨N˨Ғcu=P+))zA'&&3>ziΟ?߂~GdȜa,a,\]t=e1& 'ᘘpjdł˨N˨5yȑ#@ [[[I"F 0p۵k655ݻwoN7oZTT4tЈd={~qbEjesO'/!…m=۴љ>}ti6muuVwqH:"^$377F$3X8;[3_myQs vC#Ɏ]efPϝbBb‰b\Xֺuk كx2hͪ;vlժñcFahhȫi$Y׮]-,,.]D22GGǦM /R,=3.č]@Џ݋> <ܗw54TYn/jgN#XPpkx3"yLAY^Z֮}28cb޹sTGGر7)))Q)(Q˥e?.*MJJ͛7W^S~A/$_Hwj[ID:bf։C}X[$_(SKDD̷2}*F2CD>zb4q# Xx ,C)\#222*`YѫQ=FkEp]C,֛7olңGSSm۶q"Vu*-s NI ǩ!D$;Mp1 cn},@ORUmߒÇȄcd1#dp`Y@??w2+3s222*,`YpFش>#E |>CG^dR8,8!=V^YS΁;EzXVXXxȿk֬YcǎMMM$mmr_<dټ9`s~ !>>˧::ZY'7ny%dQReeV~~"] 1#dp`ƍKfQ,S(S,R8I^ˆ%-9~p̻cY2ydּg6mt,4̣vXo>bgyӦJ$^\A$VqWBJJM:ujKdRqע]***?nooߺuŋ?|6ZwJ гAg!` 4ۢ").I'>Ĺ$fow~ ]s硾}{hj"xq^D.8޽,Ȍb4LN4\8*:ңy_|a2g8NxrSӎX_EεAbRo%o奥5iҤWV7$&d * ^9 &)<ćb  3a,1[:ΘbIX1z̽gwvO%IHä'X~odbOCLH>;vl1†<DyoO,"I..1ٺu~L><~/JJM0٭[r`"/L6kdbbpʕeLJQUy3.*jIv>?oRkL JO u#X^ Q9T̴ӦMsttƌ#kݏU[˨˨NRoփכ/vpX7+jĐgqS.w\vb(eK efM;,KzӺQl/_-jIE|Ϟ1 6v$H׭[#2##_~iI0y0 tXƤU#Pݍ׮:th-~`{-D Rl׭[gjjkooߪU+~ڒKM]XFpfeanۧEN/ˆ`2^ձ |yW.ϚyǿeԿ1" YE$;طoy'|O!޾M;v1md21UZtx 1cO>Eek`١C۵kgee%ݏU[pRSם)Q)dY|=klČ/4w`ҡKK/ܾ}Dz,"Is/^̎)/x0`N״ g7jc>,~lff6vX__5k.]tj2XÇr\pbϩ]J.+KF~SQ׿)Q)d˨kرO<]|feee``> RSS `dd4jԨ/^9^***ɪUT59~ $ddmmuCCZ aSGj. 0˻w7vA! e˨N˨ҍIچi&''@I&Johkk{w ki\D<3 'ug6L4cb}))))Q)(Q˥%DzӧO<޽)*Yf̘Pld%z?Lhjvxef@i6ݸYOOkȁO"sҶ#WW;29Rzx8ֲ͞qNNѣ:3Xl͌YRֶ.'ں' Xֹs;/aZZj_}Շ#gmmu*GJQQKLL UU>LQkD]wƲpz48ET#eFcYdd7|Cw=IPlDϸ7vEdG .8Тƪܺuɵ:Hh׷:Q͛٩SG0ٳX0::8<߅J&-i\ Ν::ǎ{G !%0x K2ڵo>,CM̙Qh||nʞ=}EE2XY7d׮}gooQשqb=oISݛZ.-yrʩSpee%zY2Skb}gGL"GWIL,tJ_?S#ٰLwowq!ݸC] Kކjxxx,XħD ˦į =z&(LvۼN`݋ e<:%_bw/[vJ$ &ծ]ۋ0v{rΔ99 ..w˴՟=;Two_~ى@Jʖ32jtd 1Y'Q qVi:r!sWW.](IIJ/~Pk=ag  t(LHX™]R㓤6 ܁p `EØ3V :2aLط/2eca$ܧOɛ!o([fN,6k`Ǒ#+ NÇ曡8x,,_J mH;Fu,[^䆜E~~+zvaٳZNݼ'&1eݥ2I׃o_qJ#6uc3lcH>XGauRL}5'T˄ rk޽csL<͛7oޤhkBdb8yje\[Y¯_'6lcǏonn 9g@uRPliC>z+.'',cJ;uְ R*b"3X]Jq9 %%iZZjϟL sscκ1Xƙp61"Xጬ?AUX&l.TFr~YY;KK/L<eaa#?8Sb.ip09É<oȍ3t-k^^þnݻ8B ^xŲOZAzR˷k!ɓkml,Іn4D3X] ;66gaQɈ201y,,Aq V+RȚTu*ڬ2.&TU-8ޭA[AzR˷k#j2ߛDFF.ػw)">LlT ݥ/ 0"*1-ٽm[]Z,AС3N$CT ;{:ں' WGƷ6ĉ-b8W#Pm/2*e,|=~6z_9yˆFaYATY}J.+-s NI ǩ!D$;.OyW_% }fb89HX@y_<9a1\SD7)Refyyqg=ypvܜ6&*,vpDɬIJऍi}/ FH}1@"1k /+yN݈bY}wojjY!k&%{.~1Hv\ }%UVfz1039HX@9 ""$,!q ۄ &36o0:5t m'a5 QiGp`}%4git83]UwQy1gC 9"@W`[@vLL[[j!fP:2p[=vgE=xVf#'! ILc6#F6C32OF z)8 s\!&G]]EWWZ`rELBCg &*j ޼I! Lɻ䁱YbiReA_O,~_SSׅ wٮ̲AkOR˾kCxǻe\6_bsW0_9 q u"hI`? y4WY`Yq.G\Oғ |y&Inp.vc)"a/ĉU&~VTubks4[FAeɉȈz5u] ~ X2?~}P.lQ񇳓w.|,+k'۹s;CC+Wvbz8aC6:oN `nʔd2-m+&鞞ɘ {aAij,$UU&XFs?\^ l r' ̧ m2jvcwۆ9Uk| %yշ;g 3TT uMƲOOՔ oQXE_2dHH_g؋tl deeYOPթjېtٰb4,{`>lC(Q˷֍󊚾81dř5Ex\䔾]0I2?ec?o@MU||(o$-[vs®ȑOjݺܹ!rt ˄g?AU{sc:J[x>(țdd21%b^sEVeg#0)`BZ]X㓙['m9#dbٹsl,B3׼g03,5$XFұ%|: ԩ7C8g?AU{K2xW >޽?]uԖ#Oc@.׃7nm˼2!00B!˨e<̱3 sNY11Ob {.11YOPթDޒGUikm\ ҥZp Y:wnkq㾊 )<0!˄Mϭ,g3˸%Z'TvoIԣa&̙cBBX :cD3zCBd)NRo'mr+]9Ahe1N<ZyYOPթDޒGUikd 'd\bZ- {!-57B ӓeeWr9kebiReAbvOGUik3^ Q%"]| ؆TKjGvnN |l{2_Z[LOϙeq1;d5LLV M,H-ɘz<'`:_U+iQ)HR/#޽M>ضLCrJwX_9Y?]S,+H* 'ޢS6&_Ro4yo׮E8?x \&JW>gMLV M,޲o:̟(OAڐ|I>$|~eecYrX+]9YZw2Ms~hW3yƍR_4{SSW ҆K`fp;q~ +22Wr9uz 70,2cp4r@ OaTYPؽjiCj%5N*ɛA3_~iILǰc21nJʖ3r9uw +aŦMs&aW9;[;|D0s'm6ll,OBत5!!,ԇG?lb߈qpM6d^ O'{ujTszkIQ,K+HR/a.?%b|WzzZO̲xe86ȓ漼805faiٍ|L?5u ; 1{f2}BO,MQÇWPe³bbO]oNEZ. mHM{7M$|P'J}—ˢҭ*R jRò 2SܽsΙsb)r$fFW5SII9+H#A}zܸq,o"ZXpXOxbOOe%MeDySdȌ qyON0A]e'I|j/T69gUZ¢dą 2$dI͚˕+9aB^^&/;ɲ6^3߈[V?|x~i۴BODydP!.U,3O޽Pp7oC\իΝ;;˃^ R -jKx,4`={^eO{"ʛ$ˌΝ>qwYON==~)w!Vgk޼kJ&/&/;D11C^?\7oN&%EY[4/M˞$ˈDdP!.U,5l!s\9lờ?yW bc==1/4yɈ'F^?N5vJc҂f%iS!>$aUv,+YcVUYr$\Wgp" Y"H I R[iN==qS;qbmۢK5sAիWvmj/Z4OO"'a Eһw[ދ&/;,{5>}yyi>(ܴ)g#qbk^>z23Y`06k&,ӌ\vmn#GzZ;wBp`̣m s ᅡ 6{O~_N;clFǎ텍zx_q*cY9՘B$ˌ qݧzz&YӝPO0j0PrVsF=OӝGOp2B|7#qdYrr4|eːJ@ݻwNg H._ N7\s' 5k&VKL|3 hAX:}zqŊYWjРjH!y|!,3#AU(VO'9R^?è͍H23YƩė,i 2e($ss3fI}ti nB=߶ n.ˬʨ ,X֭3eHeW & eܿiD7#~Dٲ,7"2Nf;L0r ɑ)Sr͚7!Sffcce./nc &L3mVy.uYF!y@[f$TK5M%C]I@fuYQݻbL0r MLp1F TU_,TeFyYſ 4G]QtdP!.@7QTvF$uvez _,\-˴\C(`Qh_"ٛl_ePu}-[Se"$Yf,TK5M%Ct\9I}.}d`'ddW_`L0rY,f's BըQfCad=OOYƩ+|}="7̾,\WA_˘Ҙhؑ *HeIoERkR@fFnB3:))>ð}{742ҟ["7̮,kyk&Vߎ#]*ĥHeI~ՙ1׉Qs,]:B#Gz ,Sd%md)6B\1HܺDQ!>H_an\?yclIl"B9/> ||dQe+]ڞe]TV-C铟ĉݻ*_|0.Hr9Se2GNH4GTB|2i,} nooьu.Xɩ%>Oe$dfm"1glӦDd_|H''G; ׯzJgVbn3kLc,KLI\H`L0nY7ӳ&իzxفռy!`%8OeKh\-. GG{|e Vr'SOeZ]ivdق; L3pE0r%s'C>m3º!0ZfA#, Cci@.0M...Bw%y0{u$ȩǫLmҰ2uP!>$;Էo(V*4ƍ= T-_}#E̓<~w''7%KFn({֩A$;Љ&8 nN FĚ53k`L|Y=b3E5ݕÌ3B\1No?!B|Hv"'kאnE@4Whng8b6kqj2N,T/',i 2m1&MۥKSVƶHpz3o[ǎbT=+GqJXxddÌ6B\1HNo#?!B|Hv"'L3mVvm3g.law4e`',Tjۻ/!Y{,2+׬YIpuoO_¾73+.{gE9N 2Q!.@7QTN$=堠9LX@78'h2NeٳgGmlvފ2m=Lpu,iРz|EW게U{ނ1IXj ӛ(K*ćd':..uP3-[c")) .Tj2Me2Nb2Y&[iSwXwBB$֚? +R0{EL#8I RtzeIDRs9nX$'nݺܹͬM_KY&IYW5,@,fgaPr5jT@ad=OOY#,/˸QP-^I qeDYR!>$;w}} !hE? s$geY`d0Q`{=+f AfMtL`"L>9r;6Y!ti{ [_cZZ̼yioիA ƹٌdie"&[~rr%jrY,tAẳud*ć,˟?d©p.lBsY~?ӤcWe*s~jz/AY&e ӧWK~Ǘ.mnnVLq[0Fuۻw[e"92Nxi*U* o䚠,tA 4[__GJB|Hv"qB@ܗ-[o=ZY3"1l4?k46lVXKe˚hpBA\VlBsBw IaV=r#y˴e@:15B\1 WOoQdSv@P 3[_f:R2CIwf\pvݸhQs~he`e>0c LAe.CL /kZY#4|40Ru_ȆM'TSLY?up;W  BNoeSY>"Hꐐ%aa''Ghe`Z"cډCJId +UW899`%5AG$j#yY'nB t B„d~ #%SIeDjda@@H,i{$|pm PkXQŻz `X8r=In=Ӝz*P;vte)D4,L!)$8="5Êc\,;-[o ƕ2h;f,,۾}Vժpa+\¨AO0,c\h]=Z=> 4rj^ffϜ `L |7Vg)'~|eoЦMVIyOeA['r:}6 L!)$2 +G {.hW{5R:?հa]85Yvf0ӥK;^:uB /PzxMYQhq+99T  H qP˲ׯOC\U&&FA6A`UͣGG4eٕ+Aש`#Hֿu^bMs.4'on:C]Q(wdAq,MGE2}"Êyw,ƌ į2Y`ݒ%m1ӧ݆ SNX䈦,+WxQ%T=-߾=ޭYAX.W#ef8~ikv2 c,#(JeDRLHjb^@$%EAB _]0 *K?djmxY}jnNCڷo8zt'sBM[\j aԠAUW3uY[.4|9게B$2,pYO$`X1/ gi&=<e܁Q3o/˲+DZͰ[܂JN.Q¶R,DɲE^fBfC:z03+i|5T(P"E 7DY2؆N\ײe=uYFyLeŁdQT, +DjYȠrJ::ڻ5C {_e=U]۩Z$JLgNWoNm~L1MÆ7޴бkQQZ_F h d|wSq*UדIyOeŁdQ$YI;kʼˈ t )!֌IIQ>`HV޷o!+S(wޓdAq YF%I8o,˗wݽr2,37jSLLrt;g*89S(wޓdAq,c(H,,*PKP6Pɓ;fObrݧP'2`䲌sE/R|yNi$YF$ʀ$l2>_GFeD H8d3/llܸȑ^,f:mY4׍PEn-KL%/|v #2"Q$YFPSX1/_FtdժYiE̓栙w'6S,l-Ӝz<)$ˈDdAqNN}9tۗ/['uNs݀i5x~SES 64/) e2plW%M d#CtV['uNsݙ3[XŠ<> Ӕe3ͩc|vʡ2d"99yɒ%b[A!&(d>9֭ܤImV G[sݰ۵kwݤIwիW:zHKKѣǒ%KrLi`„ G 3 ( $0{,~B/^888\z5%%RcVߛ6mjccC x%4۷6`:tŶ,,#?~411y/Ȉ ǎkݺ5+߽{J[cƌ 5j2 |b[A0j`ӱcG ~6,,#(׮]ӧϠA=<<3+WͭJ*޽]6tOnݘNMM>>U@Ņ_ThXh*U3gB'TÇҾ;{{{++1c@ 6C+Wf\x2U7qVZiۋGBձիWu5ɲ ػwo Ķ`JT dATwlB/ԛ&%%AU^5 k׮G&...555<<|94e*1R/Qĕ+W`###Q8pYӧkj|dY׮[6@ 2-3͛׼ysN$eP`m𠠠ZjAWiաC2f 033{*'O"E.]UVo߾ese8~3ͲKPׯ1ȡ H('H"GGǚ5k>eu,,,*Wr9NfGr尖{5M6Yֱc \~]s;w9=,?A7Znyf /_>tP ($J4'S/_P{ 3m&6U/^O?lwppHJJ **+#eC ::lٲ7K&zIw 1dAب^NOOSξ}6DAy󦝝= &p V^-d`\ضm[FĶBq>|)SĶ >ʗ/e ($#K t Q?~lkk ! !ea֬Y|KBo; e666tF,$$$+V쯿8&<qA@0o֬Yb[h|ݺu 8bd`pႃ?AL2ϟP,#۷o u-Zm!"!d >[nt !|JPZGm!O{nwww Hbe˖?8tPZH%+ V_Ŷ@ YF Eu]l+u׮]b[A ex;w6Μ9S\>m!/pŃm $11tPcԩӚ5kĶhԨMH0,#DÕ+WJ( !o߾Bx׮]*!H@@ -[  V 0`Μ9b[A e88tP5(1޽{666ϟ?B.LJ2n$RRǏm!7n̘1b[A-\tB b[A ?H"`ʕ4w$ CgϞm YF 5蹉T0o޼~m@PHyoT x]%\"!Fttt&MĶ@ $<_egg'!,Ml+9cǮ_^l+@@S\Rl+YCJJJ 6@ $+Ux !dwꫯĶcHHHg#2!ի>|XlC ==%44TlC9//[m$<ƍ%?WRf޽{W~}|m$@BBE-[ܲeVقd}TlC9ݻ/]Tl+זA$\ŋŶ3v޽{Ŷ@2!w]lYz%'N6Ml+ A@EשSg߾}bBI<~ÇbB20@;v, F eB.b۶m5 Bcƌb[A2<<<Ķ@ eBnݻw.\B͛7ŋv؆ѣGb[A h2!0k֬~m!fwww eY|&3\싌,ӧ6/Ǐ/.H~%JN0^ݻAbB AAAb[A 肴>2IAV~}p^|I`䐶'YF7I?N>]B !d4 2>2Q) !2Imڵb[A H,WgNu~~ΜU\ 8vlΠMjU}eIek׊/ !h۷ok֬O !22eYZZ̡C.\]l Exܸ\NȲxBJ#2{ƌb[A $i;}ɲׯOZ5ٹLn- Q}.˶oUj9 BuVfmĈn-d-^)L}Ӧ_y$رULԳw([( 㝜#JRi$Y&2ILwͳg6@ H v$ˈ&2Ic„ F o9rVYeoWiw]WD5[E4*,4n޼)!J$Hvҕe󏬅kܴ(ןZԳ4˺=EeNAJ$Y&u,YGb[D$&&meHKTA{՛aޑY쏾}:|n?#s6Ϡ s88رEYj-Z-PS35ҧ[m|qztةg/_F`ŪUˉ~IeRK.믿m␜L/i;})ʲ߮o뷡NI͚5 e` i;})ʲ?}.5vKƷgLpBڵ5saeu[uv.xO"ShNZϚؿ?i[En9UnQC0ANu'Էo{vf͊kX˥KG7lXʢy:UǟUzfg>bv f7WURڎM~ 2 --zy^#G HKQ_5k;ށ8~Qכ ߞɲիo4ɓpNC3eu+c/V `mti ~׮b:Vѧ[OfZW_@m/QٳgkSLԜ3fxkUC…@_ U+ }&%E\Lqty:vl/O3n6SU,~'(3zF 2eY]nԧegV{VZ3ۂ(ԟp{s?:5-E+AYmڴiN)RX1+Sb{VL0zK*v{&C%Iѣ#(,i?p|(fŋGkV%p7oNOmvf3SY= _w옍rUE?Y%2٠E[l Eٳ$ eYU,/Q^͗tw>[tXGnْ%#Wa]-]:ĉ_e,~u&kא %:VɴE(JsO%Th٢ǏWh;-&,2i'S57,.’+|4g$d .*U*))IlC䏠   eНӚueo 绕'?9K{ܿG͛ ~Evo=dt ɲRf322#D?Y%2c^rekѢE9nFzz:RNJ+Ξ=+ӗ,y{lm輛}6`f$…@ի xq[ZZQ_9$ [P3UܹͨW hԨ&{ Qs'mسQvNg_ Urփ;3Cر[n:s`͇z*UG?$YfǏom[[ۗ/_fM4)_|׮]_zeZZZ=,Y!m/EY []{f+{{o93lᢟޛ|.RYe+ffN?eJ?۱+^2_-, u2D+AVѧ[תU _FkԨ$]*eQJW˖LTV  Ed:Z^ݢE#D3gP&~>$Yf<1bľ}Xþׯ_С]Un^x;^t 'OZm۶ս!pՔ & {SݲrskO&=>цB*t_{6`.nY޽;ݣG+&6nʚi1 }?ںVX 5dY }|vDWפ}0Lٙϴ66ªȼ?9Beƃx(7o$%%Y[[, nݪZ**<ΩAƭ]TRӧ mڴ_~zj=2>|X~=>6@0veDb$Y&.||| zzzٳ'$$-^͜9¢>|gggVR޽{c]ooo(-4m/6l+z2AN'YF7IG{+tU^sNNMk׎_ѣGS(4oϯ/^ptt2d{;mӦMcJMl޼UWP!F,ߟ9sFl+lANdQ$YfTx]ҥK*ͧmxYdii U{ѢE%JCz궶bşYp+GuuueW:;;붊d$v$ˈ&2cC>}XY}޲uYXXો˹s87nTM49x`ڵ47\xH8}tViH1<? !'YF7II?~gN27ޱc"E.]UVo߾e%JW/0,#i;}eDyd-255UB 0^~ KXA'Y{ ^4eJ93fxIBBڵEdѭ[76`/---[hѶm[z H,=~p&))*ڵ]DdkggGw u@1}Vh.]{7!mOL?~<7bD6m@]#99z̘{h ¾۷=֬YqƩXԴ˙3|G,_p8e!!K.ͩxmѢ. 5|8RJDM > իM.MqfGG;fǟȰСe0r2'N2Z,=>yd$47oڵQF֢D dv$˴10pƐ!Q |ѣXZ{@gsw{P3,cYnV,CJn-~}ժ}꓿[m?d[[m xu$&&VVm֭yo#'Y'ݹs?Y6qz:oN(\k*,11ɲKvq,+?QYOֹs~:899rjLsڣ(#'2%`  A8p`C Iicƍ½{'M 4uj|}MԳe$!_&$ˈ 2@(og1}hMr<Q$ cHВ%ʛ| yIAƐ%K7 F-;$ cHJFGԭ[YpomV==VJ 1gI0H3_:9aٲ%NZmC>|8O?Æuup:?tIAƐ%YFy,1--Сe.KY9l_ںHllpv,xqvi\IAƐͦЭ[ ͞< G͵ki7hGgώ-kv@/~f-t;իAZ!!Kj֬X\ qZPi1e*նi3RR] ڰ}UYXwk񐜯a,{U㝝Ҿ{7TG%,ӼGoBedѣUr8MsJ[*U6m/#/lotp9ҋ<(8v(X)Wg1}hu;Tg--ͷmAX Q ׀>N1lXW(3T>~hQ94q׬eA%\Ns'pgp.,[bx{ ˰I>zt^cGWmF VLІ7.] .| dF_PBŋR嬣'//;7a-{lytfdLoǟ`-zr&ss?ܣ9Pl{2A` :4F<|xW>~~*X)?g1}h3eE3|jʲ+aLʷnGWp(8 wQQ W0յ J 8.V`F (DeuXKx1 4}7n=( )X2AP~G"ak) D"9_ ?Ybk'~xNw%O^ ^R%%E` *L,CLAYӧႛ۷oa͚Y3 ;/_)!Ol!8xJ Cʕ˰f/nR, -'O;aB2&NguυM )X2AϚ5kӦ.̓ ѨH0O+pV?)11JG%#//ӳٞ=CB㥭O^i ^ 2ud2F;D=vǺXcJYD]?;^ݻӬ[BBz*d iwA"Qt5 $ˈ&yCڇ6ǝ?8XKHd$kHM 2-9_I0g ʛd iZrDya @73>|&9_@(og1}hMrAҞb&z?ЄAPFVd iZI;_"1S5 ;56뛟W͍fD52%lU_Yw@Կۜ"bzyJ2{{%yCڇV7!!2))*B)zN|{[9ݛ.Έ2jPA*ppc3,kZ[)N3g2_OOE] RQfٱG$ cHJFF;99u}ԯ_ʕ V?{Ψ|2`I0H30`=K;w}3|?4 ߞ2I?-آ+m03+Ge˖(\lŊ/[ddX+;2gҥ_ܷo!j\]kde%DZЃcQAFϺu3철==zSǙwZitNueoNY"yCڇ6;ڵ]]m>jr֭|B n-1Vs'E5U6)tւ>޸qefV4jd?>,+9}zàAnnT)A6#CBkpgm4Gs| e٤G~}`܀PF#nцodxOE1NӰʗ_VØEF6]4e/Q?ujVc}l%J~U ڶ={65͏pt,eZ)/ ^| wp-[Ct$1s3iR_tudOMP޹s~dd iZ=ՙa)|\s`4bDN`KvzuC!;mp/TJNЭhQ9CfX1[\`\fbb/Ocb~3g#FbŬBCnӠAD\"9_ EY6nC v$tU};l#^2~((W aXHaq*Խ{+QCX%nsdQ@߾Z>zt%mϞE܌ŋGkVep7oN-[&Mjc?GD}9uj=!: Q>esO,e{.@lћ7' 0pLwpyzyDw ,ZԜ+=2hnÇwgd iZ==[-(x+gUV?v|gh) {WGG2̬ÈgUk29sYi$|8RPe2&9_ EY =[o70tr]L>28ի KIK9}@ā b{J*t{f׫Wx4jTVT1,JNFΝaFͳ:ubfIg Sȁ4wY۶"np7{Sݲrsk$ >ц,C*t_{6D.tiݻPHp5f 3Q͝~e54m1%G 2m.9_6ӟM}Zbd~Imݽ-lѢ>K$k+8UNK}/G|,;91ܾ}[KUiBS;WkRS>|&HyclIl:\I0(3B 2-9_I0g ʛd iZrDya @73>|&9_@(og1}hMr<Q$ cHВ%ʛ| ycp)S͙1N"׮(Hd iZcs/^9N|7o|4EJqk%a06 '~p"ڵ], 0g1}h&'GϚ5Ʀhr%˖-ѫW'O٢aú:8؍S6uQ_ϞH''GXhggY~+WC5DY]NrH<s#FtkӦTѥK;ƌ޸GVQQ ,}ci͚7nEp\g=9|L,Yt4kݮ]Wc+Ueopx.]֩& ;vƨ5âCx'֊s-3>F|b:vtss~~uXk"ϟti{^Z RJKYz| YKY XNrH<20pƐ!Q_ |ѣXZ{@g|w{P3õ̲$} YαnZ`b,}@ji.m~)e$ cHf/ 6vl/[[KW?(o_k|ˑ#вC C+a#Tښ5,_>H}zc95,e֮deeR3Aly5 -, խ[…@V!,*Ya7O q0ǧ`cŸm7_(gE1a Y'ݹs?Y6qw'._} :wnү_CNMi.B{>0Q3>[{3R͝OL:5Fٳjժ@dԩZB]Aܻw5֐/pU+*V,s:~} ſ>Y)ƋC;2S5%'96keč{֭57oCzu"}jYUh5hP|O77.X0@Sc8+VŦ_@=ۺEwpLrd6\&x:?}{Ʀ(Fe3$!_S hw͛k ͛!0J[ᚋ ˠDd iLeكis ں+GEmQ]A]J8.]2dm>뫯jd|LA6=}adYJY&*> !, ?k/IeHh\!*$BcHڊpT|!AHĕh < &h u(mTS͔{Vq{yO^gud'^p[V8܏P <{]XSRw֎ucժ̖ `UcƄOXXxL/Rj˞$ʂl1>X½v=^;xp%ap]^0d:Ph@*ww2Ьuk޽ ;] #1Cr-H$$|2sDdp{hjxI-ݚ͛ۖݻ2:4}0{VM5,]]T GX;DF*DUaa.˔vUyqȃ3&~};__*G[WY-#i[D 4|0 9deK\/NeI>ƍ/ºwo_ <)+e۷'l$Y׮2s¶cR M›)7 o4v%JJݥK[v'ڑ' bRR Aá-*RRm9וq ޫm\gw^שcQPT2i׮mXX׺9`7 L r`tΝIn@׮燰xx&uˍU>_eK}<=6[QVV^>X>OL1nӑe)ȔL)Txc bJJ[80Z^L:/UH1RVEdp{h~ɣG R] =&#5V^РAXKs~Js\Bao)PiO,bfp|~|?'ȔL)TxcJ,ciBSDJs22Ⳳ愄t0 n̼U4jxc~tdQw9I5A_ea ?9.:C&/6)-#Rx3J%%Vldi/ lo Xi̖RP?.tpaEHo۝MtCe[HI5DD lI"* d3@LifPፕrm7p`0Ki[HIAá%[FҶʢɠfP=yrS6c6ߒ*HAá%[FҶʢɠfP eTEdp{hkzBÁ+'*9Z4Ȗi7=_EUDEdp{h $m, $mȠP|IWYHAá}|xNk:_]?P哊D2G_eAm4Z̐%*T$9"*jk>wƗow^4geܸysU>E˫QDUk KRULLC>x74Dž j?׾}C5JD ,66lm8 ]R6trr{UGӌT3~sJ놉fU]e ʢzڲӇ eq *xqA&ٲ&"CC[b2[ϟKq19:/Fhq ~V=n-+ R,LaKH ݻCy1S`I>waa.Gınb[{!ٓȡ6ysh j>7&99s„a+5U.dj u-3aAjK˺])%yaUdGEFzM]){}歷:쥗 k׿?C`gP_ea o̜تԢH`Ӡ&ZWO gfYY3$7"[g|Qĉ [[ӧ7]X0bb)],un yfخ}X|93YNNv[$;)BFȠP>#|yQٲ9sB4FYFԩcP.\O[X:|`WWZXԎ}o֏u!ڴi2?~ [ܞ0AB|12D1/RS'osV>bt64p`⛘ocQ%;qFNڰٲ%"CC[2[enn혀`- f̘pvZ¦A [fm@5H?ڲu-ٍ4(S3HU"0F Ԟl"SZ&>>jذPiGc 3ShʔHgg{{ѣ™M6ť>DJVNPXsQ& `V-Q"2h8=er[&$,^l ʖuO4cUBy&B[wRnX ]Ky U>,s\t·zM_l"SZf ;fsr<5ktmj=Ǿ}Ǐ auf"yBy<9E|-[6YO4`@c5hQ lÆ8e5JD ,5Ӗ 嬟DIaaUBe?o7 ^ oon^xec6J޺o{EU0<{v`jdθqI;\:2OFz'Nd =ztX?^ZZ>^zjP&3|l7--^m\lH =96};XsQiXSa-Q"2h8=eLHX#dG!Mx)z׮6]= K˺/ ,eƺk8s& ?7}uoz3ڌgP_eaӠZ6eayya] %9)ie/`>>IM.nn={[0;p`9{m`+KXrpCف&"ow=7'ݲNNvpru%[VDdp{h_3ma||<ԱٯT ?* aP25  ]' 5oٰY(^b=T"* 3}G ce0}wƗo_AáI*/|EY }0OhҤɋA.U•o_wcb:?.U-Zx(nHפj+"CC[=m b)I5A_eQ2;rd:/'&…}%H?{zK''$[VDdp{h-3ML3%|c [VEU0q${1{xM沽u&/~!--|<pacFDt qvv;_`{ nJ d@{^WqqPV֜VDGGҁ?CW!: JR!Cz98tsy6,,Q][7o?l-COƏpV0 ΞͶZfZII.׽{;cܖ tT& nb/BEdp{h_!VӈzЎlW߾o,_>Y `ˤ"0F/gtd_J&2eÊãanGt^{ǠO> ԩcgaQ/IMԾϭ[2uzt88ذbI㉄$2;ujJ&'cf Lv`+7aֵsg708Hϟ?+CV#kNa&e.!EN]tBEdp{h_!֧_ C0n7!I5G_ea 3v'= D }ESD:;;[(8thk:'O3<;y2sڴϻ:>%}y&HKN0 ::,*Z?lCZG?&lY6&EOƎ֓Lԑ#녙ܖ ӇeBEdp{h_!֧ ȈB<$n7!I5G_ea ?9.:C&/6)-gNX8=~\7ã!Ho&}FV\~?9VtxynGݺㅱlAIn\8:%-73lǦII.lw[l2߄-{Gl 'g ]Vn%Lإkht0Z#"U umY+DRTbB xxxЀׯ5 2,axĝq;v!t2e[zjPhi[iSWML؝Awosؼ(>=Ç! ڄ,.NO2|`/s|;:^wW"{'W`]'3f  饥E^VMer[&c٭OfȖU umYkSeaiD=96`*v12,LuQKbA>``A]ܜ{|MX~yڠ=%̙N?_|>{\+xLpTurq#/ wr1ʧ`+KXtpUvvvؾ=eK}<=6[QVV>X.]׶m֭Z={M{ ȖU umY!l5ML;w˄\&|h͙˾S+"f tN,& JbwaP’rGȴaC,@$yL]BI/"CC[v l5a 9I5D_eQh(]U<9ةSh-)ɭ T"2h8=߲I*G|E۲WwlJk8p̜]m um÷\J$xy~tjEdp{h $m+ +Wv1**j޽O<1VǎD84Z/I"Jϝ;unnn&ME%~H Aá%-4g'Onܸ1,ZRRRIIdTA"2h8=_E𕆱ɓ{1~;w^r%m4Z/I۪---wÇs?| Ç_p/~1۔oi={ _5*//M6/++ ?l\|o߾...D=|ƍ/˥7wݿ_PGT=Uٴ9(ZoA[9ٴ|=zc$.^x-^ s%v}vC-YY1cǎѣG3득ݿ ?nݺ[˗+H'''7n={vz3g"=w\e/^4ifժUHo׮]322߈sssaؐꫯ` .**]Cѣx 'O{+󣢢:uꄞWfo_߉lm {{k}4Z7pLLCtƦ-ZBڕְݫz=fSR|8l?x74Dž 8׾}_'[P| D𭜳]SAIII...jjٲe:ܹsZFO`F [ӧ۷O> ._lذĉH:ujΝ?N[=\ݕ+Wqߝ;w~!aiii O~o|!,)Y eصe ?y2vǎӺ9O:4?6Ӧ3a.--Z`gCc N?B*e50=_y lob)& ?}m} Z>ujZڵkjTg"#Cz|y&w`fCǎ}:xp1c׷*.N24ҁ=MHpGt=ub^XZݿ?%D^tU޽K;txk5Jb\gp8T}~kC#ȑ}6nL`-̍ cM&(+kNVM]# 5-=_/ݲ+ݲ7GfNvlUj$iPf^ĉ [[ӧ7]X!CzG_ `L]U\Ӻu-WZXԎ}o֏5з߮]̙ÑkW KMcbaΜ/̄n?Gv5kD:ݻ[0LaaU د^=~8gdYY3$7"28邭zmK8R&շ8gfNݖ-I(Ddi%| 5'+_ ȲMdJbhÇ 䤦Nj֭|WN9:&W).kYlתuKM_KWat֎ W :f36c6]V/X с#GAX](LLFT4p` :|v>PqV:ujDZ/K!cd;OI&2eJKLtvv7zt_\EӦ л:>׀ iNe{q k0!\f[ _"mS[9 ƎΝUbuO6]U||԰a>;_B`!=j~phK:& DGG]EE+ 5-=_/Bas>k"b2pո?.˛Y /%Г'uʅ eK>5U~ɯUKMcELd։[Bl/бcks\Nvv"?۳]/nU+=j~ldi4`@cuHĢE1>  5-=_/B0<{v`jdθqI;\:2WO ŀAEeggu:MK5Hcrr9ת3^uK UGG+WOa8@db61ml]SXtUOFz'Nd k`":~<뫸(qj6c_DbO؝wiյ:(`0XK%R]A+?Y4?1>/ l;͹gPbz8SOV5ِkK_)(Xb>/f'4AZUr8dzy($%l̗ӧ7) C՞m4` EDt{μ0?20ׯ+K%RweFXx[9V]fJX [7  6Ģ> bLp~8eg;==̳m0=*dȠP|"V&V0M'Ovܹ*IMoIInEBdp{h R|+SD.nh^XffήVtDMk o[̓@Ҷ u-m|m4Z/I"* "I"2h8=_EUDEdp{h $m, $mȠP|IWYzpߍ_Q͛/ì!"2h8=߫Ww}K&/]W m߾T鯽 7߬jCqC H||E2c=y2رcAnNӇ eq q6Xb8X,Ң yz64VYc1V!(_4ڲCG#%=1X^'Ԗ&)ٲ 0M !,5׫Q#礤QAA~,`I^}`n4ݩS ֮]U=ҳ͛7{w0Ǒ cc><1ۡciQFCB:ݿ_ڀC-zxM߬7SbiYwTVGkW [C ڻw)԰ￍ %a"YzT! 2PڲCG>-11x .mhLΈnl{4oZ5uww4Ia^zѐ!lv~x 3ǵk{{[[?|jGD8| 26>2s¶cR M?A'2=<ʕViiXaG毿~0]=*sݺx+-,jƾu>lV@k;>IX vZ3gG&Vzu _"m( PK`2[6g˗Of±)4kֈ:u,woB),l* SqBBC;b!ʏ̙,;;5khU! 2PڲCG>-5mjP~!cr? 1$deK|eI [?…pKpul^L|-׮k>u~Ʉ ?LN ٳ1K̟’ԩ +"eO%)8ܹiJ f#Ǐ߮BXI*T_ea 3v'= DLttĤIX+%f˦MX\2̩4,i=xcn޼ K k(--2%fb辀ְ:y—HFǤJiM?1I`bH--<),laB}8vl?6´IPЖ:iyZWuN<\♶V$’& ;+YTٲMf|բ'Bx 3MɓӧCH*0F^ȔȈg7@ii̖mtU戱[ܲ7 k}0/oIX SO7'DtII.&Xݖ-7ʹe†(),lŋ'tؚ;ȏq֬ŋjlKPЖ:iQ! !R# Emi,,hQ ذ!ٲYq*nKikNo7 ''g.H*0FٳS#w%KD!Ȕ 0cvܖ2Lsd>Nj; u/_3kXzjPt#,flօ/1WlpN_ݻ?zuLQH`^Ʀ޵k;MWdԫgyD2B}#|x:VqqQj˪v f,БOKMob ܽ{;3voFaЁi,,Y\vd&V]aa2$esɌ}uz$04nC}6kXG*DU&: ZAȊyH`S^Lpwwqss /^<^,gXԩcͧza @ &kgbƦkS[_)(Xh}7ad3mzx'(8cO*9y2phvcLJeeeٸ ӛtn˪v f,NKhѢ 369_|>Ȃ{\nl a2ɮQ#~r[fexz6mbArx 3M뿶mnբ#wlY,LG{l\m${Ϟ޵+7nL4`_W~@Xc / [7  fi9yZ5" +~eiCP"2h8=eS%aE|[3£G2IR'jLBx&Kȑ;EUeEC@9s83XTįT<9ةS-)ɭ.""CC[O~bT"ʢdt)oݺ))PqqZaᲫWwdfήH-"CC[ Pۼߕ,Q$mȠP|IWYHAá%- 2-"CCK%i[_eAd i[D KҶʂ@Ҷ u-m|@qKy *RʼnȠP|bd8>VIB|EaƌaDM=[[+ ?OuvVPK?'ܻӟ=d׮// ^}4H_|=x74Dž z(ln߾T$ um2,|F^{{k}4Z70㯐ey\OJ1bQ_eQ d>Wŋt2.le9aˎO:4і=hq "~2۲S2a^wƗ2ݻ2RsO?miӦ#qa2N Զpa4*aXVXXԎ}o֏!ڵk͜9c?AD%??o֥K[yƠSCC;]}sl՚5JJr#"Ck:9mْɈFPBC[ b׮n] e_~Bi2e:#@6]g c弖Ӳ9żq,KD .* 7#9ڷu+• WWnpʧfːؽp`ܖ{vV O++K?K-6qV~*,&,FX'(:ujɖ Edp{h_!VLy nSߘ9˄5 z!x—H׀ey6nLhժ)ZcC@&a 3v'= DLiiє)Feڴb&sM[&VJ-c^۲'ON> /q}zy;q?X ס tOatΝݼuO̔2_-7V ::bҤA,رO @ Ȉ c3vl?؃@-@77aTv [&Aá- |X1_ S2=R k0Bօ/6-NDzwUG *?F!X͇[M>,s\t·zM_l"SZ\fq%NgzV[&Dj˰qt}.̖];E ߠߒղN&e&5r`&^%e!2(YVX-߿pxxЀׯ?wnv]V/Zkް!lPD ,b4 7璲LX⏷.|i)u">ЅMWx[sr1 y-=j>j0<{v`jdθqI;\:2WO àcp\*x^Xk{<3-o,&ei!m~!(u؅gcSڵX̷eM*?1ӹs[-zNYvݻ{5rvumpv>˛ӱXbǰÌ [&Aá- |X1_s<3A/o]O,ƀ.,l'^='29zt1 yj[]A+?Y4?1>/ lwrwwqssu$urVK:u,?5gZ +1e_{͇2\om6oګE ٳGbݻW`ږg`+KXW'KȾ[͏eÆ83mN_Y 198ذ8;;o EDt{HFYYY6nz~&nYJx'';8~-ȠPЖưb|'`&Ᏽ"ARh-3v]^U%'C-1yj[weFX޺/aתT[a%&jelfk`ikʎ]RXz 2&LIѣB6IIB4ڲVt_a f^(޺Hk>?p/l1u5WY?z`NmΝ):+ gXGyz6_C-)ɭCּ umYk +G ,Ȗ8pYyR޺u3RRƳ`cFh42W |2Edp{h $m, $mȠP|IWYHAá%- 2-"CCK%i[_eAd i[D KҶʂ Çn5V]TyWIOAá%EՒʢ0cư~~ƦSPb?/}HZy*&Ck<Bvxy5ldGIPZRsAá%EՒʢr`iP/nәG.le9AӇ eq]ute(--Z`gC T"2h8=_|5&0M !,5׫Q#礤QXẑ%[{[cڲ]n4yr2`2 a֬aa kNv~Wsا|׷Cgd<XcM@!!)/pumѡb[Zݿ?r7gϒȐ=_o޼ d̘p8# u-m| 26>2s¶cR M?A'2= /z^^nI*' }߿GYYsd` ' ³G*w4Z DU0<{v`jdθqI;\:2ׯﴳ_ չs[vm߿_Çױ 3i,l._3 Jdm&#c{VTn4kf8d0O V0zNի;n܅WG!ى66]|2Edp{h :EU&: ZAȊyH`S^f.nnQQaŋ'X[?M__uXj|0%۶m޺mglw430𕂂%,qݻ{vvv`_L||72勪bb:]R6trr{UGX3~KMv|PAۗ+SWU"2h8=cؓllZ1 _.S甗WYTO[VvF/]c9AUnˎO:4 і=hqlV@k;OȰ:}z*LH\ÃV'cvvVkL+)ɍֽ{;db̝w'M,ϑ#-Ąe @[iiX +&'S24tƗt?ADcU&lB&_QuX i ׯI{Q Bl{[~,}fnڵfjqzu0.]H̛7`XCC;]}|dNNv[$W``Aá-_ ő[Ĝ9L0%b +a}_-RU9 MfU ; *!|12D1/ aO9(%'cJI߭[;ַUi+l…UX%[O\ XbRn88ذL,||e:ug=&0_0;|}X.<ӹm[{auGۧ 㟂˛_)(XdzN /gaL,䆱6+JPDḊ@~b?29 2h8= _cbH*.[&eBeIx՞weFXna"O(yms*Po=kW Koܘ2h480X~7fX Rvb=*dĮ"2h8=_! I*1!*k=|E vXG͜9"Oφ[~l';ujs\N%t߷$ϏDdp{hk8| Dx՞ʂpR޺u3RRƳ/zVqqZaᲊHeAá%1|m4Z/I"* "I"2h8=_EUDEdp{h $m, $mȠP|IWYHAá%- 2@c`ys rDdp{h $´DUE}RKI_]}ڶmΞiB3f & ?th-vxy5ldGYSЎ*89'Aá-_[&{:>fޛ?b EVʢmŋ2[vRύ6Ǐzh˞QZZ`8OφjxdJOON |4ij׮ըKy,vr[FV4&n_@V֜VDGGkӧGtydooݤɋDαcFDt qvv;Ms-[v:`m<djWۻg'Km#45nPHHH4hK˺|װgtgA?&jcƄׯoU\ 6QAA~,W: ;rdi_Nܨ0$ 0<*<$"2h8=e@RӦ|.YI9M۳'RISA%K&ܹT nvQ'{2':#7#LS_ea o̜تԢH`Ӡ3YNNv[$<2'g vmVOoAs~8jĈt[vT&,pqƗwo* Xmf+|~+Ǭ9yRBk֬uX`…?eVYm X^Μ9$L^: 67h`ch{ۥK[Ls$b ahhGo7/|l՚5JJrbY?yssN2!"CC[kBUXV'rSsIh̢92X1Q{Mٲ+WXnȐ^11=, aZ"* cdb^xƸMGTl"SZ&5uRNmX:9y-jynGlbvTA>encr6y^#Vt/xV-;z4 >yrPXl[bHoVaMcϟ?VZ+VL:lX&O>>HO۷jT|80+4ԃCX8K99'Aá- |xIVMv!$_ҾLƢE10C Pf=*_z >x H 6oowaO9B ))l0R|12X ϏO؝$`2& `i,Q lYiiє)֣G~LnӇ..}āYdW_-b׹ܖaV^&>+yniuC|7oH;ְ8-XL?i Ȉ*ǎǗpE,oNxI&Ddp{h_!^9^;e&HR~@C--Ccǂَiӆ\(/dNdˢ`݌gpoII. 61J:9|g&--V:ldi+(4`@cuO胃۳]/nU돃 9Ʉ umY++'eB 5nb? zua)n@71-2А]sRRaZ"* cd=;052qg\⎸qH.Li4L,T00eWO d%ʸ6o7rا_ܖ͟?m}6kk_uٲFM/\]%&|9^GG+W5G!ncicSڵ;';w0Wg`޽Q#gW߻ӱYb 9Ʉ umY+īܖ i2կo~۲{ @If5v/| {"WHIa:´:EU&: ZAȊyH`S^&%e<&/.~2,0]u\̸L42>w.G'ePm6o *@s d` ҫk׿4e,P]۶yӅSǢ`po`+Kt1s-l^=fwأ8'6H;;;}&%lӧ7qdBD ,Un˄4a@A'Nd߫L{)Mŋ'F^,Dc BJʛ)09sw0VѣB~k|jZ+ecd M1^9Xek0Ggfڕ7&),oЖ1 l"2h8=e&d&Ϫ? My|QRaZ"*|;k\NqAW_횑 r4eةݤe iAI,7. YՖٱ#bd{Vr%';;ӲxzNbjkzōʛ7X[W~1ڵkjrm=|}͛~@8-۾=YZZiBZF!)ĽkҲ1nآ¨(v-@%Ϳѷŋ(/[Fd[=ߧ*<**}֙򞻻Ç^$hDHb?*gQ655q̙=(?Y{' MqZVYUWg޿+iBZF!)Ľkʿv*ΏDmCCki9t!U_bΙjeena!9%fT;vDSk&(ILL a(d&_hyLԇnYb 33#ܹH$2 I!M_dlb?6&j*Ν~Ç5KK dh=qy𠌉 ER!-#˗Z[OO2ʕ]\jjr;}J BR{ZjBXYYr]]aff̟= BR{ZF<AH qoe2 I!MҽCZF!)Ľ铖QwH $7}2JiAOZ45޺9wgBy>!-#ٯ[##ys64CGyR_'03_9r(.gĢ|s98VV*;!CdqqNQ9xp6ygqK}}99QP*||ޮׯ=h iAE^Q̌ȻW^5,33O?۶Oֻ:]ahw! [*jdaf*}m&b[NO: Zi_=䦺Z,qO֯_ҫNm㏟J::=##:zt3L,g-̓c͚;ܿqvv,dgm=ԩ1lYf))͞=zw~!Ho߾kjralp%eABܛ&- loFs䷑WO2CiYVFHnMM3H{_8, zN)JW}ʆ% L];e+mki ϢCXQ_~wr_ukӧ@X3J2iWxx<־{kY@'O|0ܓF%08vw Cgp%eABܛ&-Y]9䷉iYKKd&˖88r÷39-WYךsqq`~y$%=111,U}P/sw5..XOOrҥKTe%eABܛ~ Mm<(cyþkʜ@4/ji)oW9B LH,d+ _بdϱ{H~!8cvci ={{Nᇴ BR{/_?X`Ν;ڈo92e<{tР[8..fѣYCMMsiA<?ubgML\~-?33َBÐAH qorJiAOZF!-#I(;eABܛ>i{ BR{'-tAH qoesvqc里֭ٿ(I BR{nZv?yj.FtqqZx*ٻNmm- 2333zEOdV={rssʓ BR{>ZƽZֳg!CdׯSp;;e SSC򥖖PAOd.ӣCۍU[ב~(O2 I!M_,H`/_BAAVF[hV\\T*m}|[^}*1…utz.]ꓔ5.*i68 jO$5u N_τ #ΞMyw }]ʼn)Xԛo\ܷ_?# WY/m_66*v1JK吶3֑~:]q2 I!M_Xwa<kw7Ύx17 ڼ f_akjreP1Nz( 2k?dC}}FK|m&b[CODS/K]m㏟ ^ ٳǺuQ 5˙ӸkTG [,$o=O+CZF!)ĽkҲ϶f:qJ~Yy'MsN Rв LР2[[RefemDϹ{3z ڳwݾ]:nܰ'z,_~wr_-mr蔉DL3Ɔk׎[@ZN BR{פe:f keh̀*&zfZ&xmKKd&˖mRAk,&4zoV c]])x9tW_cc\VKx?ZN BR{פe}ejJCTddD/E! E$ v(I]˲6˒%i്ʛ7=W߂!5kF4\G~w99C\+x9t)JHjjra{=ZN BR{פec䁱EQQqQ(ZJ~^I/;2⠲bMƍ@YW?sZР433>i))ﹻ;f,8z֭!s*'zoYtt Ύ50[__$xNqKFƍΜك; kS BR{=o{U@h-,dAAp;vDSJOIz@!ޮsNS67A(3gtnz qQ11KPоOOCT½ƌaE8~,CrM:Ŗ\U6ALb޽(d&e\?8b iA2Br6@A?d' ܩOk\#x_ܹSW?;T=]Se Öjӣr[GQiAlCBn⸸`AGnw鵶2e+9(8v͑NH $7W_߿mb⊮[י^e,033iAO*tAH qoe2 I!MҽCZF!)Ľ铖QwH $7}2JiAOZDij*usoOґAH qoJJK&`E~R͛Ebd8  LYYqÞۭ+ Lqeˍ@bgO9' Je-zq޳$.//炂xVnlTܟy Z6lؐ fL׫W?GϦޮׯk\pJx͙˗g`[Yt!-#h+yPaeffqhӗö́:TTu '_a GuYu-@T1?dC}}ŋz.Up%Fpʄ7 ЛBY[ ״.-Nue; -|VwQؒ$U{9{&ɦ!X\pJٳǺurRY;݁`H $7}MZߌC9Qo#2e<+LJ2}sJ܇gյyE^:9-hm=(7æRI ܽ4Fp% ` &M:Ҵ.4={S}ٻoGuk8_>f.8%~ʤ1cl:݁`H $7}MZ3$z sbQo1/,̏w3}KY.enŁegյ eee=-ki)@Xٲ7``[Vuu&'7!~~II+A.W =3C)qвs w@Ν; X\pJ⫯9 BR{פe}ejJCTlξE1}IM]3j7ߤiG߂L𬺖yßT<-klTYssY~kArjHzٟ~:m89rd_۹3Bq]; \WMM.|wChـ|r6VtNKاHmm^)X\pJTLSH $7}MZ8;M[[Wۮ䷩TT3[ޮL_n a_L qn<˴ *z۶-o_]xe))ﹻ;Ap!i:|DE_hFSS D&؏Bk1SS7 ;9ٝ9waqE..̜TUccǾCZ֑AH qoZmAJb#QzffFCΝ8v(똘}ԫRK,2j&NKl57K-,d3gtn kA ʕh`i-aǎHFqp=u#MB&(Iܻwe̤ Z6zIcllAW`==]KK4US}J!-HH $7}?@ <OVNOS_RI9eABܛx_V;w 8#,r>iZ[OO2=sqq@ÐAH qoղÇ?xK`Tqq/g?d ԝPgH $7}jґAH qoe2 I!MҽCZF!)Ľ铖QwH $7=B/OFA 4.0.0 com.iluwatar java-design-patterns 1.16.0 model-view-presenter model-view-presenter http://maven.apache.org junit junit test net.java.dev.swing-layout swing-layout 1.0.2 java-design-patterns-1.16.0/model-view-presenter/src/000077500000000000000000000000001312550536300224745ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/000077500000000000000000000000001312550536300234205ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/000077500000000000000000000000001312550536300243415ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/000077500000000000000000000000001312550536300251175ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300267475ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/000077500000000000000000000000001312550536300300475ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/000077500000000000000000000000001312550536300310215ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/000077500000000000000000000000001312550536300330305ustar00rootroot00000000000000App.java000066400000000000000000000042721312550536300343410ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; /** * * The Model-View-Presenter(MVP) architectural pattern, helps us achieve what is called * "The separation of concerns" principle. This is accomplished by separating the application's * logic (Model), GUIs (View), and finally the way that the user's actions update the application's * logic (Presenter). *

* In the following example, The {@link FileLoader} class represents the app's logic, the * {@link FileSelectorJFrame} is the GUI and the {@link FileSelectorPresenter} is responsible to * respond to users' actions. *

* Finally, please notice the wiring between the Presenter and the View and between the Presenter * and the Model. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { FileLoader loader = new FileLoader(); FileSelectorJFrame jFrame = new FileSelectorJFrame(); FileSelectorPresenter presenter = new FileSelectorPresenter(jFrame); presenter.setLoader(loader); presenter.start(); } } FileLoader.java000066400000000000000000000053441312550536300356300ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; import java.io.BufferedReader; import java.io.File; import java.io.FileReader; /** * Every instance of this class represents the Model component in the Model-View-Presenter * architectural pattern. *

* It is responsible for reading and loading the contents of a given file. */ public class FileLoader { /** * Indicates if the file is loaded or not. */ private boolean loaded; /** * The name of the file that we want to load. */ private String fileName; /** * Loads the data of the file specified. */ public String loadData() { try (BufferedReader br = new BufferedReader(new FileReader(new File(this.fileName)))) { StringBuilder sb = new StringBuilder(); String line; while ((line = br.readLine()) != null) { sb.append(line).append('\n'); } this.loaded = true; return sb.toString(); } catch (Exception e) { e.printStackTrace(); } return null; } /** * Sets the path of the file to be loaded, to the given value. * * @param fileName The path of the file to be loaded. */ public void setFileName(String fileName) { this.fileName = fileName; } /** * @return fileName The path of the file to be loaded. */ public String getFileName() { return this.fileName; } /** * @return True, if the file given exists, false otherwise. */ public boolean fileExists() { return new File(this.fileName).exists(); } /** * @return True, if the file is loaded, false otherwise. */ public boolean isLoaded() { return this.loaded; } } FileSelectorJFrame.java000066400000000000000000000124151312550536300372640ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; import java.awt.Color; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import javax.swing.JButton; import javax.swing.JFrame; import javax.swing.JLabel; import javax.swing.JOptionPane; import javax.swing.JPanel; import javax.swing.JScrollPane; import javax.swing.JTextArea; import javax.swing.JTextField; /** * This class is the GUI implementation of the View component in the Model-View-Presenter pattern. */ public class FileSelectorJFrame extends JFrame implements FileSelectorView, ActionListener { /** * Default serial version ID. */ private static final long serialVersionUID = 1L; /** * The "OK" button for loading the file. */ private JButton ok; /** * The cancel button. */ private JButton cancel; /** * The information label. */ private JLabel info; /** * The contents label. */ private JLabel contents; /** * The text field for giving the name of the file that we want to open. */ private JTextField input; /** * A text area that will keep the contents of the file opened. */ private JTextArea area; /** * The panel that will hold our widgets. */ private JPanel panel; /** * The Presenter component that the frame will interact with */ private FileSelectorPresenter presenter; /** * The name of the file that we want to read it's contents. */ private String fileName; /** * Constructor. */ public FileSelectorJFrame() { super("File Loader"); this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); this.setLayout(null); this.setBounds(100, 100, 500, 200); /* * Add the panel. */ this.panel = new JPanel(); panel.setLayout(null); this.add(panel); panel.setBounds(0, 0, 500, 200); panel.setBackground(Color.LIGHT_GRAY); /* * Add the info label. */ this.info = new JLabel("File Name :"); this.panel.add(info); info.setBounds(30, 10, 100, 30); /* * Add the contents label. */ this.contents = new JLabel("File contents :"); this.panel.add(contents); this.contents.setBounds(30, 100, 120, 30); /* * Add the text field. */ this.input = new JTextField(100); this.panel.add(input); this.input.setBounds(150, 15, 200, 20); /* * Add the text area. */ this.area = new JTextArea(100, 100); JScrollPane pane = new JScrollPane(area); pane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED); pane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED); this.panel.add(pane); this.area.setEditable(false); pane.setBounds(150, 100, 250, 80); /* * Add the OK button. */ this.ok = new JButton("OK"); this.panel.add(ok); this.ok.setBounds(250, 50, 100, 25); this.ok.addActionListener(this); /* * Add the cancel button. */ this.cancel = new JButton("Cancel"); this.panel.add(this.cancel); this.cancel.setBounds(380, 50, 100, 25); this.cancel.addActionListener(this); this.presenter = null; this.fileName = null; } @Override public void actionPerformed(ActionEvent e) { if (this.ok.equals(e.getSource())) { this.fileName = this.input.getText(); presenter.fileNameChanged(); presenter.confirmed(); } else if (this.cancel.equals(e.getSource())) { presenter.cancelled(); } } @Override public void open() { this.setVisible(true); } @Override public void close() { this.dispose(); } @Override public boolean isOpened() { return this.isVisible(); } @Override public void setPresenter(FileSelectorPresenter presenter) { this.presenter = presenter; } @Override public FileSelectorPresenter getPresenter() { return this.presenter; } @Override public void setFileName(String name) { this.fileName = name; } @Override public String getFileName() { return this.fileName; } @Override public void showMessage(String message) { JOptionPane.showMessageDialog(null, message); } @Override public void displayData(String data) { this.area.setText(data); } } FileSelectorPresenter.java000066400000000000000000000055141312550536300400710ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; /** * Every instance of this class represents the Presenter component in the Model-View-Presenter * architectural pattern. *

* It is responsible for reacting to the user's actions and update the View component. */ public class FileSelectorPresenter { /** * The View component that the presenter interacts with. */ private FileSelectorView view; /** * The Model component that the presenter interacts with. */ private FileLoader loader; /** * Constructor * * @param view The view component that the presenter will interact with. */ public FileSelectorPresenter(FileSelectorView view) { this.view = view; } /** * Sets the {@link FileLoader} object, to the value given as parameter. * * @param loader The new {@link FileLoader} object(the Model component). */ public void setLoader(FileLoader loader) { this.loader = loader; } /** * Starts the presenter. */ public void start() { view.setPresenter(this); view.open(); } /** * An "event" that fires when the name of the file to be loaded changes. */ public void fileNameChanged() { loader.setFileName(view.getFileName()); } /** * Ok button handler */ public void confirmed() { if (loader.getFileName() == null || loader.getFileName().equals("")) { view.showMessage("Please give the name of the file first!"); return; } if (loader.fileExists()) { String data = loader.loadData(); view.displayData(data); } else { view.showMessage("The file specified does not exist."); } } /** * Cancels the file loading process. */ public void cancelled() { view.close(); } } FileSelectorStub.java000066400000000000000000000064531312550536300370420ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; /** * Every instance of this class represents the Stub component in the Model-View-Presenter * architectural pattern. *

* The stub implements the View interface and it is useful when we want the test the reaction to * user events, such as mouse clicks. *

* Since we can not test the GUI directly, the MVP pattern provides this functionality through the * View's dummy implementation, the Stub. */ public class FileSelectorStub implements FileSelectorView { /** * Indicates whether or not the view is opened. */ private boolean opened; /** * The presenter Component. */ private FileSelectorPresenter presenter; /** * The current name of the file. */ private String name; /** * Indicates the number of messages that were "displayed" to the user. */ private int numOfMessageSent; /** * Indicates if the data of the file where displayed or not. */ private boolean dataDisplayed; /** * Constructor */ public FileSelectorStub() { this.opened = false; this.presenter = null; this.name = ""; this.numOfMessageSent = 0; this.dataDisplayed = false; } @Override public void open() { this.opened = true; } @Override public void setPresenter(FileSelectorPresenter presenter) { this.presenter = presenter; } @Override public boolean isOpened() { return this.opened; } @Override public FileSelectorPresenter getPresenter() { return this.presenter; } @Override public String getFileName() { return this.name; } @Override public void setFileName(String name) { this.name = name; } @Override public void showMessage(String message) { this.numOfMessageSent++; } @Override public void close() { this.opened = false; } @Override public void displayData(String data) { this.dataDisplayed = true; } /** * Returns the number of messages that were displayed to the user. */ public int getMessagesSent() { return this.numOfMessageSent; } /** * @return True if the data where displayed, false otherwise. */ public boolean dataDisplayed() { return this.dataDisplayed; } } FileSelectorView.java000066400000000000000000000044741312550536300370400ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; /** * This interface represents the View component in the Model-View-Presenter pattern. It can be * implemented by either the GUI components, or by the Stub. */ public interface FileSelectorView { /** * Opens the view. */ void open(); /** * Closes the view. */ void close(); /** * @return True, if the view is opened, false otherwise. */ boolean isOpened(); /** * Sets the presenter component, to the one given as parameter. * * @param presenter The new presenter component. */ void setPresenter(FileSelectorPresenter presenter); /** * @return The presenter Component. */ FileSelectorPresenter getPresenter(); /** * Sets the file's name, to the value given as parameter. * * @param name The new name of the file. */ void setFileName(String name); /** * @return The name of the file. */ String getFileName(); /** * Displays a message to the users. * * @param message The message to be displayed. */ void showMessage(String message); /** * Displays the data to the view. * * @param data The data to be written. */ void displayData(String data); } java-design-patterns-1.16.0/model-view-presenter/src/test/000077500000000000000000000000001312550536300234535ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/000077500000000000000000000000001312550536300243745ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/000077500000000000000000000000001312550536300251525ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300270025ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/model/000077500000000000000000000000001312550536300301025ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/model/view/000077500000000000000000000000001312550536300310545ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/000077500000000000000000000000001312550536300330635ustar00rootroot00000000000000AppTest.java000066400000000000000000000025121312550536300352270ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } FileLoaderTest.java000066400000000000000000000030311312550536300365120ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; import org.junit.Test; import static org.junit.Assert.assertNull; /** * Date: 12/21/15 - 12:12 PM * * @author Jeroen Meulemeester */ public class FileLoaderTest { @Test public void testLoadData() throws Exception { final FileLoader fileLoader = new FileLoader(); fileLoader.setFileName("non-existing-file"); assertNull(fileLoader.loadData()); } }FileSelectorPresenterTest.java000066400000000000000000000075251312550536300407700ustar00rootroot00000000000000java-design-patterns-1.16.0/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.model.view.presenter; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertTrue; import org.junit.Before; import org.junit.Test; /** * This test case is responsible for testing our application by taking advantage of the * Model-View-Controller architectural pattern. */ public class FileSelectorPresenterTest { /** * The Presenter component. */ private FileSelectorPresenter presenter; /** * The View component, implemented this time as a Stub!!! */ private FileSelectorStub stub; /** * The Model component. */ private FileLoader loader; /** * Initializes the components of the test case. */ @Before public void setUp() { this.stub = new FileSelectorStub(); this.loader = new FileLoader(); presenter = new FileSelectorPresenter(this.stub); presenter.setLoader(loader); } /** * Tests if the Presenter was successfully connected with the View. */ @Test public void wiring() { presenter.start(); assertNotNull(stub.getPresenter()); assertTrue(stub.isOpened()); } /** * Tests if the name of the file changes. */ @Test public void updateFileNameToLoader() { String expectedFile = "Stamatis"; stub.setFileName(expectedFile); presenter.start(); presenter.fileNameChanged(); assertEquals(expectedFile, loader.getFileName()); } /** * Tests if we receive a confirmation when we attempt to open a file that it's name is null or an * empty string. */ @Test public void fileConfirmationWhenNameIsNull() { stub.setFileName(null); presenter.start(); presenter.fileNameChanged(); presenter.confirmed(); assertFalse(loader.isLoaded()); assertEquals(1, stub.getMessagesSent()); } /** * Tests if we receive a confirmation when we attempt to open a file that it doesn't exist. */ @Test public void fileConfirmationWhenFileDoesNotExist() { stub.setFileName("RandomName.txt"); presenter.start(); presenter.fileNameChanged(); presenter.confirmed(); assertFalse(loader.isLoaded()); assertEquals(1, stub.getMessagesSent()); } /** * Tests if we can open the file, when it exists. */ @Test public void fileConfirmationWhenFileExists() { stub.setFileName("etc/data/test.txt"); presenter.start(); presenter.fileNameChanged(); presenter.confirmed(); assertTrue(loader.isLoaded()); assertTrue(stub.dataDisplayed()); } /** * Tests if the view closes after cancellation. */ @Test public void cancellation() { presenter.start(); presenter.cancelled(); assertFalse(stub.isOpened()); } } java-design-patterns-1.16.0/module/000077500000000000000000000000001312550536300171155ustar00rootroot00000000000000java-design-patterns-1.16.0/module/README.md000066400000000000000000000017751312550536300204060ustar00rootroot00000000000000--- layout: pattern title: Module folder: module permalink: /patterns/module/ pumlid: JShB3OGm303HLg20nFVjnYGM1CN6ycTfVtFSsnjfzY5jPgUqkLqHwXy0mxUU8wuyqidQ8q4IjJqCO-QBWGOtVh5qyd5AKOmW4mT6Nu2-ZiAekapH_hkcSTNa-GC0 categories: Creational Pattern tags: - Java - Difficulty-Beginner --- ## Intent Module pattern is used to implement the concept of software modules, defined by modular programming, in a programming language with incomplete direct support for the concept. ![alt text](./etc/module.png "Module") ## Applicability The Module pattern can be considered a creational pattern and a structural pattern. It manages the creation and organization of other elements, and groups them as the structural pattern does. An object that applies this pattern can provide the equivalent of a namespace, providing the initialization and finalization process of a static class or a class with static members with cleaner, more concise syntax and semantics. ## Credits * [Module](https://en.wikipedia.org/wiki/Module_pattern) java-design-patterns-1.16.0/module/error.txt000066400000000000000000000022021312550536300210030ustar00rootroot00000000000000==== The MIT License Copyright (c) 2014 Ilkka Seppälä Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ==== java-design-patterns-1.16.0/module/etc/000077500000000000000000000000001312550536300176705ustar00rootroot00000000000000java-design-patterns-1.16.0/module/etc/module.png000066400000000000000000000431531312550536300216710ustar00rootroot00000000000000PNG  IHDR 52F2IDATxoWyWU_^}&)vienK +EpC )$MHJ) lqH\o K*FH̜9syf?}̝skk`-P1=*0 PHb-!Q3a-0+X *a-P?D9TR %kw8~š?R{F`?oo5Fk(9]0"ՠJtd-^쉭e? p5 Q1،ߛ)";[ZrP8>"gjNGZ7o5HD7=ֲ3ܛ@Sk!HF33]< C0w6G;=(ֶnz-,Dϔ~OGmj[i߾Z?nz X˃OJ9Ͽ3GB<7Dyo`-ȟD7Eu}_Fo>~ڻeb&7› 7V ܝ1J<:ei'{ ւItӫZ{[W>tl:G%8D%~f8Zk.X 'MVkyg7n=?~=?wte3Q{ƒwZ?tE֢ A?wcjL  ;5VdwnzrJtӫZn?2e=Oݥ'nWDŽXKˇh;3u3a~PffBk1^ 5rK+MVkQaχo u{XQZG-<K2GEoOB44qwQ[N3Ǿ~s>ĝUbs-F%;D˃O ,\Kr)CUxm5& sV+= [PIvzo^ϵc?'ޯhz`o?uae/~zcov=я=5,l9nz-Scx F2w[K߽Nk7<]lFuXbDǷoZjP%ZT/ɮ8o:`uuQh<ۋH:O]FjG~LjYǷojY̺%ZG-[t-GQ~?ÓdFE󱛽 QKGchDǷoZjjY$Zs-YK09nNu毒%zAzJ$Rӟbr8[Ŝz1U(jDǷoZjhYd1[%Mւ$Q,0nzX *VC?T"Q,0nzX *VCSD7=Ht|VItZPDǷoh5ȟD7WV^ȡm9=ySB#AFoj?nzX * 覇oj?nzkRIm$/c/H&2iN(S _6|<k5U&MZ"4kiJt|kA$-4!̆5@^%:} lc [Bc9D̵L`- JOZ~'_jC?}sq+x฻kF{ֆýc{ `Fm<#2ȟD7=Z{PzuݏzU7aړ?&^E 8ksV7d(?nz3XK|d蝾V̞1j[[S^Wܥ JỌˏwi%:}C ?nzլ!Hc{f`l$:>u#}C ?nz-O5gts#2|!'MϳD嬓D~5]㨅 %CoߔZ J4D7=Ht| %O^5ֲz]CNQ$Ƿozd(7nzZPDǷo2(GIT"!2J$:} 2J$:}Dv$7=LoZ BItӫD#goLߛ3Q'`卣#sQp#ҳ7LىSʜ`o`-ȟD7jLܛ8Y "pChwg<;1;Rj1Wq̞e:Zn uɚɿwݯ Q4iDǷoO^%U& S;zF-bL|%:d&ͼTFTWIY<ĄX03.痹NLDǷo|[17&yF턮IGTD7*Ld'ƹen-{Y%:}co5̟@Im˟)f,'\VmEұnzT,JkA23B%}ZITr2&:(;{昒0KzH-TRa%&aeXR_AcJV-ʤckd7X 'M*Y넘Bb$kkA$URe:j v:TΐWbdF7:ǙWaIMɶIt[e26O,khmm|YDKZVK{Y|J5%JtӫdY?>2tKN.Uj-Z|jf23nO^dW%UX^=̕YVB5Vw|p%s1d7VTe2WQT܊z-WkTnz,OORJf$:}ci5U&fS3A|e4TԔlT$k1(+_7VSZe>e.lKP5%'ZP#߾*Ty7MyjJEւJ$:}`ɥ o/̥KsX 5%&M*~XVK_Ȑ7nzZPDǷoh5ȟD7=Ht|VItZPDǷoh5ȟD7=Ht|VItZPDǷoh5ȟD7eS-k߾Z?nzֲ3j9U]kʋ=ܲ0AEW>?N2Aǭ=Ы}w?U]bi5-(MZpM-Ds J.Ūw{Z?nzNRkneMĝom;8/Vu%ւIts5\s{ɨ%ªwKZƯ޺鷏;gYQ%鹦]pVf^ɄXՕnֲշrGO*83Sl9_v0meVk_\^LvDǷoOւJ$:}X4^U]hJG~r9岚\q], *BihZ5xuV.[Kp1=gozkJA ˙/&MkA%߾o؟sgk3Pd'〢2Bj{ֆ{3\N\}yqkT"SԥhQdٲߝN&?k<=3\FFg[K%9#T"_{ov@|/{JNTԺQ㻒#!Ko,zxeљc&{tH*'~7kA߾s{np_UWm= Sn=6Ns}mX<L%1l'b-kA%߾Yg=ty}Jj1񋦶2Ɛ cNY{Byo?s+~„XZPDǷolW\u=ℼ!MG3su2; R=#qhaw7<@mI vCւJ$:}ckΨ|BȜ"jZ2_)YDǷojU~,e]B{CW_jJ6 nZ jD7L2n&W)Bo`-ȟD7LZJn?V|_G~BMI=`-ȟD7jLb鞚w#`-ȟD7jL:=?U]j- >᥉K߾ɵϟ~+FpH;6+K$U]eTHay-f-Ԕ\MZ/EKTn,M*2Gd %:}c%ZKtks-qo1!̆5gE覇o%:!˷?n*HYtZPDǷoJs-v썯}lX |ÿsqVnf,a-D7yk' 'Ԇ߿w~a0&Ă7%+3K7sl̙+OrzQLV#ƕK?SuS;S7sѺ]jzX *MQ~xGS?ƈ[sXo|9}[\nfւJ$:}Sj^-w|a_;Տj~r[;^;cnB%bEnzɥCFrzr癏w>ckXם\W;SPL=PݲlB즵5߾{g}< ctWӋ3-̙ c+4Y}S73fjzX *ռ|6d=s:nfJւJ$:}PW%VuT7S7_uow>? ߾ 'MokYBS9'FU7X 'Mo~kN"ֲz] BCւJ$:}jU^5bzѓDEzr+-]VDǷofL$UƟ;ZjYwd$:}3S$I3L(ZkS`ɪ%/xf-/=+s/cXw+eBl7Rer5e-\d Ǧ$3PR&RVq2eQܬ%R{H^`9Ht|ոT/Ʊτ e_!xrd{ܬ~/-_VReR\ ?G?W?G^0:mRO( j╏-V*t9X7o*}FkQ2s^01NfyNZjbkAMQq2i([dJ*o-G$L.MkA%߾*4~.MGS^kr e"ssn}KtZPDǷo^e2?e׬Ǜ`$a-D7&yItӳXmoJj#8$y5\G7|!C$٬EJR#d-KX "覷Єk.DǷoOZbb&큯ڣxbё3J.Yffv%}3DItӛ!ײ裇8܅9f-LIt|f&k!CfgpBLm-kK?Fk}OVәDjʜ־\ nQeXKm١ͼ|/M5\?F=Wv%qG牺Br%7-M9m 媛٥bd(D7rkqY5VKeZ77΍2{,7՚>m:}QKfv*}Q (!MZ\p5v%M{yXp u3;߾[KLJmWn-.kRQ8.jmbEժeB̖kt.ŷo,RVeIA*Q.D7=5Jp5P>M-ԍf\|_c?.;G_xRfv(}Sj2fk$D\jU홛]u3S߾)j5JdrT\fnz|3׼DǷoZCv;XDTXTHt|ոd( _ѫEbIM%NKtZPDǷo,kM߾!CIts5\Y߾7Gr$USeY;,2ȟD7jL>k%:}oR.f~TfE)L'-:D7jL>k%:}SҼ$lJR~OZtnzTd}Kt|_2ޣם0d%Zvif=-EUSeY;,훢Vx23u'v%e*>ui$-M*ao3qF3*.(uZ]WǬaoPu>u{_REۤE鱨>* eY?3u 1/矼JZt9ւJ$:}/CY_Y`g IO[g~I6BG gZP uf(}* S>OZtݜbT"BLK[2OXUueHT96ۉv(c7x; %hwj 7vLIT*_Ȑ?h  0L[Kr ӎ--iæ1W#a %bkA4_ &bk8f=FwG[G}gΜ9qĞ={=f&s`RIIh2T*B7RuՕ']Ξ=BҥKǨ=aST4[KfT*Q b %:tH]SN5TRel-ePD)TX07P~vQrOaS%Ǐ73RIɂ [eW*QVX3Zeks9109^;骩2,ZD)Q=V3nd4d.jP98N8/ٴjLNM~GB%JZ,Lf'G鷧Ґ4'*ڜ㦧ω:umvjLJBX(j55T ,ۙJDʖ)nzBvޝg۷ʕ+G|L%JZ,Lm-ɴHTlJޅ SO a-P.Verk)Z`k"`-D6Hr*\e,NCҜTlZ<TnX$C|)E*.i5ݱUZ k.Zm/dȟZXuymX %ȫZmkA4hϋ0TȱLa-O2k?KXѫR$bkAl-{K0^Wх%[ͭګXPVV^{TtF`/k-%.k W^mzX|._|׶y5ni/R?.\{__xbײlmm}z_ڨ4k~)Pݖ꼚 (+++h$'U&QT`jۉ+ #P3TD% GW^U^R6ͣ'*D˄>k߾}U: 8qFW U&QBkѻ .K^ds `Jg*aZQeRl)zU."F}NܣͮKD9nelLW:L+LV'RҟsOEȚriZ'4_z7lJݞ]o[0-2~{=6S:ks'O.~.YExJ0W3]@Ӻ'>s0'K im-!W\ٵkW.CR:L+Lf'G'K֨7pL:exEB0iG[+Q&g,|\?@z~A 0ɝ9>hj-)Yg[KC FX J+L%Ze]֢#۷oGONb28ƕ(̼˾e{W{g *'ٳ… vr Z`qZQernk1NEZe֢t"SiOsm4.˒3}6,gnGÕvZLgYK,Kⴡ R8/4P&k/Qf&ad *Y2ޕ_ _su+>sM 3b9?*MR3׸]erɵLe|=uSV)ZҸ#-|J㧣^mtM‘8LrJ' ǚ/H4rLV%UNU}ŗu;8tjV>P2'eGJ ShG%ZHTX`qT"wkIeͅD|PU9[- m),g~W>7w4} X *~HCHz79<' ;hgtkϟ?ٹ tD>˨/}i`]cիWWVVHCZLh-~:TT7t5\|l |h']Fj)O޷o_=uzTgn*#tщŋU7OU{O$#t.`* / 6LpӧCSYp惠Nt׮]P ]&_o+NZ@#t \bekk m%"˙fHCˡGX\T0R3$#,E[i_,UMA>}СCM_ e`"Fֲ\0pŋwU,%Pq!Aa0,LJLаLUQ"VtWWr%.bZڀU|,֒/Ҹ&/aR5|r* W(Hl-IMcfԒ21q y{3d)qL~ nڴ;[XD0p?(Jˀ>Ha9%9%?/ODoɝ9>hjFxUl-O?cki$Ai^%&3[Kh<1Jn9 \R~1=KV?V+Z#G?U8Ik2jq6,gnGÕvZLgYL{z_x ki ed)_+>sM 3bO \Rq-.[N:u v;ido2ș+CRn@ ,x#^W|Kk mhMV%[Cā,; \Z | \Z |H7euu_㯋K!馵0pi'wU  Z` ,$A"X La6H\H`*(wi*k.>k \Z | ) 0pig`~qHt0AvX wkǏ9rX0pi e.]j*k3 \>t aR?$`-Pk \>tl=Nv}Ŧ(K=F#-káCN>UT0p kr|[wWPX 8+$c`-+ \,X T #8.,X T h`-P1 \2>}СCM_@`-P= \tVWWGQWP+X T/޽%,'X x8H_U4}!u/N|>,-X xd.$aZ#T' `- k) Ҹ `- k) Ҹ 4d-[N9ڏnԞѠ75oX t"\m-^oms.X 'Tpŏlz='!t'fMY֒{ćэ=Ss>"kHWތ{Cfr/gy>alv{f'`-tJu2WՏ6ν+IfTp Rqa- "\ZR Rqa- "\ZR Rqa- "\i;>7}j?znSjOWC+-rß=gR?x@oڰXfTpm֢p/~o7O?p2}4gXTpUrj3.陱B,Z!RVY?q9ڞٿѧ%+;ǟz]Oݓ%(1SKMwDh gwDX HHWZe-7>Rps}Rzc05^ .ќq8,;fkYJ'Z_y)돽5ߴ7_MD[Kd~~g^dA+5"oqua}^?3_pP2j g*/X TpUۆwpڞ7O~}21Q&~L<T Z{ڻ:s?a|?~'>COܩ^ ʺD.ҋK{鹖X ȂHWZe-JǾثOuɿ+G[5Y:=2y?sbf8@NK0-R RYK.ƛ73wĝj[I|ŪܗugKTp2f];ZZ N59ףlN?(_eZ2B۟6}=яc*]k)b֢zj~ntսrj/$;Po9:n裊/#s`EVh-A R RE“ ,XZF㏪Gõ[D^/ޟedv.p)qTpevkE(zx̨h8ZR?0X , D*;b`LL#55MCڠ`vZҟbr8[Ŝzs-.vTpw- `- k) Ҹ `- k) Ҹ `- k)ʋ{(Ot8+=F-MǨ@+XKZ@ D*4.@+XKZ@ D*BqHpǨiTpki\X HHWƅTpekRImn_ d-TwER R%~Z@ D*„XZ@ D*249! w9hJ`-yTpn-<د{a]m[kFANZ\ Ry|[ u?d8!6ԏ;ýZ?x? 轃^o:P]vHq珟a0Eo09گ4ٌzF?ItӳEX D*Rd-'n9 ODz\vǨ7ʕCL`YGֹW'a<> Ԙ&؍ڏC+E+?TՏjgZ1Dw#IC JN; v|X @)D*Rd-/y;/G3c- E*:>vPn-=ٰ`-A+Er癏w>c85I<#{@+ o>VWS^vzI^n>nVX HHWY kI.&HXBTpER Rqa- "\YZVWuoZJQKZ@ D*2>K d--XZ@ D*2D4/w@X HHWk\X HHWfODTpn-2"a( X0^`8Z~֦{D@g R"kq2ehTZ3J8T4[K:ɲ=m  ج.'sL4kE'{kyU4a- "\Y*;Xצ1T?N/V/޳-/ϵ4Z@ D*bs{np_UWm=Q]٭Z{A+6ky졇._^]Im{$X\rx̄HWlW\u=i{pL^2*X @"\Yo^^.}eu >X HHW||f-e,X HWXTqa- "\ZR Rqa- "\ZR Rqa- "\YYyqE '*keROIENDB`java-design-patterns-1.16.0/module/etc/module.ucls000066400000000000000000000077411312550536300220560ustar00rootroot00000000000000 java-design-patterns-1.16.0/module/etc/module.urm.puml000066400000000000000000000024601312550536300226600ustar00rootroot00000000000000@startuml package com.iluwatar.module { class App { + consoleLoggerModule : ConsoleLoggerModule {static} + fileLoggerModule : FileLoggerModule {static} - App() + execute(args : String[]) {static} + main(args : String[]) {static} + prepare() {static} + unprepare() {static} } class ConsoleLoggerModule { - LOGGER : Logger {static} + error : PrintStream + output : PrintStream - singleton : ConsoleLoggerModule {static} - ConsoleLoggerModule() + getSingleton() : ConsoleLoggerModule {static} + prepare() : ConsoleLoggerModule + printErrorString(value : String) + printString(value : String) + unprepare() } class FileLoggerModule { - ERROR_FILE : String {static} - LOGGER : Logger {static} - OUTPUT_FILE : String {static} + error : PrintStream + output : PrintStream - singleton : FileLoggerModule {static} - FileLoggerModule() + getSingleton() : FileLoggerModule {static} + prepare() : FileLoggerModule + printErrorString(value : String) + printString(value : String) + unprepare() } } FileLoggerModule --> "-singleton" FileLoggerModule App --> "-consoleLoggerModule" ConsoleLoggerModule ConsoleLoggerModule --> "-singleton" ConsoleLoggerModule App --> "-fileLoggerModule" FileLoggerModule @endumljava-design-patterns-1.16.0/module/output.txt000066400000000000000000000022021312550536300212120ustar00rootroot00000000000000==== The MIT License Copyright (c) 2014 Ilkka Seppälä Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ==== java-design-patterns-1.16.0/module/pom.xml000066400000000000000000000034451312550536300204400ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 module junit junit test log4j log4j java-design-patterns-1.16.0/module/src/000077500000000000000000000000001312550536300177045ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/000077500000000000000000000000001312550536300206305ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/java/000077500000000000000000000000001312550536300215515ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/java/com/000077500000000000000000000000001312550536300223275ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300241575ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/java/com/iluwatar/module/000077500000000000000000000000001312550536300254445ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/java/com/iluwatar/module/App.java000066400000000000000000000065541312550536300270410ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.module; import java.io.FileNotFoundException; /** * The Module pattern can be considered a Creational pattern and a Structural pattern. It manages * the creation and organization of other elements, and groups them as the structural pattern does. * An object that applies this pattern can provide the equivalent of a namespace, providing the * initialization and finalization process of a static class or a class with static members with * cleaner, more concise syntax and semantics. *

* The below example demonstrates a use case for testing two different modules: File Logger and * Console Logger * */ public final class App { public static FileLoggerModule fileLoggerModule; public static ConsoleLoggerModule consoleLoggerModule; /** * Following method performs the initialization * * @throws FileNotFoundException if program is not able to find log files (output.txt and * error.txt) */ public static void prepare() throws FileNotFoundException { /* Create new singleton objects and prepare their modules */ fileLoggerModule = FileLoggerModule.getSingleton().prepare(); consoleLoggerModule = ConsoleLoggerModule.getSingleton().prepare(); } /** * Following method performs the finalization */ public static void unprepare() { /* Close all resources */ fileLoggerModule.unprepare(); consoleLoggerModule.unprepare(); } /** * Following method is main executor * * @param args for providing default program arguments */ public static void execute(final String... args) { /* Send logs on file system */ fileLoggerModule.printString("Message"); fileLoggerModule.printErrorString("Error"); /* Send logs on console */ consoleLoggerModule.printString("Message"); consoleLoggerModule.printErrorString("Error"); } /** * Program entry point. * * @param args command line args. * @throws FileNotFoundException if program is not able to find log files (output.txt and * error.txt) */ public static void main(final String... args) throws FileNotFoundException { prepare(); execute(args); unprepare(); } private App() {} } java-design-patterns-1.16.0/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java000066400000000000000000000061321312550536300322210ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.module; import java.io.PrintStream; import org.apache.log4j.Logger; /** * The ConsoleLoggerModule is responsible for showing logs on System Console *

* The below example demonstrates a Console logger module, which can print simple and error messages * in two designated formats */ public final class ConsoleLoggerModule { private static final Logger LOGGER = Logger.getLogger(ConsoleLoggerModule.class); private static ConsoleLoggerModule singleton = null; public PrintStream output = null; public PrintStream error = null; private ConsoleLoggerModule() {} /** * Static method to get single instance of class * * @return singleton instance of ConsoleLoggerModule */ public static ConsoleLoggerModule getSingleton() { if (ConsoleLoggerModule.singleton == null) { ConsoleLoggerModule.singleton = new ConsoleLoggerModule(); } return ConsoleLoggerModule.singleton; } /** * Following method performs the initialization */ public ConsoleLoggerModule prepare() { LOGGER.debug("ConsoleLoggerModule::prepare();"); this.output = new PrintStream(System.out); this.error = new PrintStream(System.err); return this; } /** * Following method performs the finalization */ public void unprepare() { if (this.output != null) { this.output.flush(); this.output.close(); } if (this.error != null) { this.error.flush(); this.error.close(); } LOGGER.debug("ConsoleLoggerModule::unprepare();"); } /** * Used to print a message * * @param value will be printed on console */ public void printString(final String value) { this.output.println(value); } /** * Used to print a error message * * @param value will be printed on error console */ public void printErrorString(final String value) { this.error.println(value); } } java-design-patterns-1.16.0/module/src/main/java/com/iluwatar/module/FileLoggerModule.java000066400000000000000000000066501312550536300315030ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.module; import java.io.FileNotFoundException; import java.io.FileOutputStream; import java.io.PrintStream; import org.apache.log4j.Logger; /** * The FileLoggerModule is responsible for showing logs on File System *

* The below example demonstrates a File logger module, which can print simple and error messages in * two designated files */ public final class FileLoggerModule { private static final Logger LOGGER = Logger.getLogger(FileLoggerModule.class); private static FileLoggerModule singleton = null; private static final String OUTPUT_FILE = "output.txt"; private static final String ERROR_FILE = "error.txt"; public PrintStream output = null; public PrintStream error = null; private FileLoggerModule() {} /** * Static method to get single instance of class * * @return singleton instance of FileLoggerModule */ public static FileLoggerModule getSingleton() { if (FileLoggerModule.singleton == null) { FileLoggerModule.singleton = new FileLoggerModule(); } return FileLoggerModule.singleton; } /** * Following method performs the initialization * * @throws FileNotFoundException if program is not able to find log files (output.txt and * error.txt) */ public FileLoggerModule prepare() throws FileNotFoundException { LOGGER.debug("FileLoggerModule::prepare();"); this.output = new PrintStream(new FileOutputStream(OUTPUT_FILE)); this.error = new PrintStream(new FileOutputStream(ERROR_FILE)); return this; } /** * Following method performs the finalization */ public void unprepare() { if (this.output != null) { this.output.flush(); this.output.close(); } if (this.error != null) { this.error.flush(); this.error.close(); } LOGGER.debug("FileLoggerModule::unprepare();"); } /** * Used to print a message * * @param value will be printed in file */ public void printString(final String value) { this.output.println(value); } /** * Used to print a error message * * @param value will be printed on error file */ public void printErrorString(final String value) { this.error.println(value); } } java-design-patterns-1.16.0/module/src/main/resources/000077500000000000000000000000001312550536300226425ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/main/resources/log4j.xml000066400000000000000000000032151312550536300244040ustar00rootroot00000000000000 java-design-patterns-1.16.0/module/src/test/000077500000000000000000000000001312550536300206635ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/test/java/000077500000000000000000000000001312550536300216045ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/test/java/com/000077500000000000000000000000001312550536300223625ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300242125ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/test/java/com/iluwatar/module/000077500000000000000000000000001312550536300254775ustar00rootroot00000000000000java-design-patterns-1.16.0/module/src/test/java/com/iluwatar/module/AppTest.java000066400000000000000000000026621312550536300277300ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.module; import java.io.FileNotFoundException; import com.iluwatar.module.App; import org.junit.Test; /** * Tests that Module example runs without errors. */ public final class AppTest { @Test public void test() throws FileNotFoundException { final String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java000066400000000000000000000143001312550536300323650ustar00rootroot00000000000000/** * The MIT License Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and * associated documentation files (the "Software"), to deal in the Software without restriction, * including without limitation the rights to use, copy, modify, merge, publish, distribute, * sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all copies or * substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT * NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ package com.iluwatar.module; import static org.junit.Assert.assertEquals; import java.io.BufferedReader; import java.io.FileNotFoundException; import java.io.FileReader; import java.io.IOException; import org.apache.log4j.Logger; import org.junit.Test; /** * The Module pattern can be considered a Creational pattern and a Structural pattern. It manages * the creation and organization of other elements, and groups them as the structural pattern does. * An object that applies this pattern can provide the equivalent of a namespace, providing the * initialization and finalization process of a static class or a class with static members with * cleaner, more concise syntax and semantics. *

* The below example demonstrates a JUnit test for testing two different modules: File Logger and * Console Logger */ public final class FileLoggerModuleTest { private static final Logger LOGGER = Logger.getLogger(FileLoggerModuleTest.class); private static final String OUTPUT_FILE = "output.txt"; private static final String ERROR_FILE = "error.txt"; private static final String MESSAGE = "MESSAGE"; private static final String ERROR = "ERROR"; /** * This test verify that 'MESSAGE' is perfectly printed in output file * * @throws IOException if program is not able to find log files (output.txt and error.txt) */ @Test public void testFileMessage() throws IOException { /* Get singletong instance of File Logger Module */ final FileLoggerModule fileLoggerModule = FileLoggerModule.getSingleton(); /* Prepare the essential sub modules, to perform the sequence of jobs */ fileLoggerModule.prepare(); /* Print 'Message' in file */ fileLoggerModule.printString(MESSAGE); /* Test if 'Message' is printed in file */ assertEquals(readFirstLine(OUTPUT_FILE), MESSAGE); /* Unprepare to cleanup the modules */ fileLoggerModule.unprepare(); } /** * This test verify that nothing is printed in output file * * @throws IOException if program is not able to find log files (output.txt and error.txt) */ @Test public void testNoFileMessage() throws IOException { /* Get singletong instance of File Logger Module */ final FileLoggerModule fileLoggerModule = FileLoggerModule.getSingleton(); /* Prepare the essential sub modules, to perform the sequence of jobs */ fileLoggerModule.prepare(); /* Test if nothing is printed in file */ assertEquals(readFirstLine(OUTPUT_FILE), null); /* Unprepare to cleanup the modules */ fileLoggerModule.unprepare(); } /** * This test verify that 'ERROR' is perfectly printed in error file * * @throws FileNotFoundException if program is not able to find log files (output.txt and * error.txt) */ @Test public void testFileErrorMessage() throws FileNotFoundException { /* Get singletong instance of File Logger Module */ final FileLoggerModule fileLoggerModule = FileLoggerModule.getSingleton(); /* Prepare the essential sub modules, to perform the sequence of jobs */ fileLoggerModule.prepare(); /* Print 'Error' in file */ fileLoggerModule.printErrorString(ERROR); /* Test if 'Message' is printed in file */ assertEquals(readFirstLine(ERROR_FILE), ERROR); /* Unprepare to cleanup the modules */ fileLoggerModule.unprepare(); } /** * This test verify that nothing is printed in error file * * @throws FileNotFoundException if program is not able to find log files (output.txt and * error.txt) */ @Test public void testNoFileErrorMessage() throws FileNotFoundException { /* Get singletong instance of File Logger Module */ final FileLoggerModule fileLoggerModule = FileLoggerModule.getSingleton(); /* Prepare the essential sub modules, to perform the sequence of jobs */ fileLoggerModule.prepare(); /* Test if nothing is printed in file */ assertEquals(readFirstLine(ERROR_FILE), null); /* Unprepare to cleanup the modules */ fileLoggerModule.unprepare(); } /** * Utility method to read first line of a file * * @param file as file name to be read * @return a string value as first line in file */ private static final String readFirstLine(final String file) { String firstLine = null; BufferedReader bufferedReader = null; try { /* Create a buffered reader */ bufferedReader = new BufferedReader(new FileReader(file)); while (bufferedReader.ready()) { /* Read the line */ firstLine = bufferedReader.readLine(); } LOGGER.info("ModuleTest::readFirstLine() : firstLine : " + firstLine); } catch (final IOException e) { LOGGER.error("ModuleTest::readFirstLine()", e); } finally { if (bufferedReader != null) { try { bufferedReader.close(); } catch (final IOException e) { LOGGER.error("ModuleTest::readFirstLine()", e); } } } return firstLine; } } java-design-patterns-1.16.0/monad/000077500000000000000000000000001312550536300167265ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/README.md000066400000000000000000000024241312550536300202070ustar00rootroot00000000000000--- layout: pattern title: Monad folder: monad permalink: /patterns/monad/ pumlid: 9SR13SCm20NGLPe1OkxTXjWeSMMm1Pza_LRgExsjMntP97syBc35cyZvAMV7bKU6U9q6CPGwbVh8Xy5E7xvvRnBzj7qn86v1ol4BwJHk9AZ_bNGjAtLy0G00 categories: Other tags: - Java - Difficulty-Expert - Functional --- ## Intent Monad pattern based on monad from linear algebra represents the way of chaining operations together step by step. Binding functions can be described as passing one's output to another's input basing on the 'same type' contract. Formally, monad consists of a type constructor M and two operations: bind - that takes monadic object and a function from plain object to monadic value and returns monadic value return - that takes plain type object and returns this object wrapped in a monadic value. ![alt text](./etc/monad.png "Monad") ## Applicability Use the Monad in any of the following situations * when you want to chain operations easily * when you want to apply each function regardless of the result of any of them ## Credits * [Design Pattern Reloaded by Remi Forax](https://youtu.be/-k2X7guaArU) * [Brian Beckman: Don't fear the Monad](https://channel9.msdn.com/Shows/Going+Deep/Brian-Beckman-Dont-fear-the-Monads) * [Monad on Wikipedia](https://en.wikipedia.org/wiki/Monad_(functional_programming))java-design-patterns-1.16.0/monad/etc/000077500000000000000000000000001312550536300175015ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/etc/monad.png000066400000000000000000001003021312550536300213010ustar00rootroot00000000000000PNG  IHDRv'ZSIDATx} | G?/{$Qq!$.!TiDnDTB%!*J(*!%zqW_MѺSB9ü۳{NNngO~gvvfvfΞٝJ IK%+@BBBBBB !ABBBBBBb \ j@)3DGmBʦ*w(T / :MUw7qPrMU A An`4 9:q^u (rJA(BΝ_-O۴i&M& ʊk%K0  RDW6]Môi.꫍#K] ۷!aāBi(_oBфB# ʢ»]Ag|_e#m)aw0ܿbŤƍ\'RBo<ͭ [7aJ?vl,޽d/mfV̓<F𷵵_ecPmTյ. d# ʢb)i8i3a€5?'+4NANN@ "7Rk͐MqȚ eZO>YЩ[.^nmmqNi +njQhHR(nؠA+_FRBm!aZع#pU& \@/\H4 @Hݽ{L;;۷&zx֍+l w/HHM]1@6 AsШ# ||)iK 8aeޞ..11S=:?ܹ#4WV $vwwa :m h&cmHcOB˖iYÜlm-Ǐ ,A2TM@Cb$(Jtl-&c{lh{:ȸ oUem}: "S JAdkLmРٳFD$ZgwN 7^JcPmT^reQN@)iKi q SO^[[Kh{y5p]pUu/({~]XXO2y:669s(+l ruP1 i7` ʵ(;Р#e#m)&Qpaצo:dȋԆ$cǏzJC0}TT7P*AWFڢsTl7@0) 96 R6U8@@ʦ*  7@0HTAF)@@ hh eSs N=Ɛ^_PxbrQreS0 :qz ۄF8g/ \ҰȎx ` dAn$jV6 qFXO<+dv++}ßѣL sD.]W\Fȑ5(dnzھJ{$'1wʡf7Pl>H<8x+*[!-m)3GQJ9'sgL?a~콳yq7xg߱#1ڹ비g,_>㏧I9uB_~445k:2>~&мyC;~[մ>[lW պbHY !: ЩJ4W&ΡOy̦؝?+,M;)¿y8,UZƍ,7V7l 5ի ռvmK#:y0wl߾EL1-j4ht z(sV_~E޽{e˗''g G;w~„1rbcУ+(ǀYZHmÆUTuHY(s`."naaަ۔)907G!e[9: \׷_՛7G2FQuu tBOBwP=V Ѝ ?i &>0(n]xw֬) yzush!VY%C&ˢp$]嗛1 8z53*8lڴ>۲h8VͭW_m4!z  kZj̝;Ru$w/=:zl+NY[[~'JN7Pu gXYU8q 87,-h]n..,\8V rפ: DF o<=Ivܙjm)t7q&wy=V)`:1{9 J_Ȁ6axgw:v@8))^:N\܌O>Y0(aXYr45k?~68SoS.1=8Ĭ ]z ύ Udl:aXuf/#9`g̙C euYع#/bzR2_n }Kmp3JpR6( A1*M< Ⱦ}pRWSLs(0َ,mU~Jy&-h7V.  脞ھ=iSljrm&(ٟ Vt%))u`]ۇCAfmm-٩8{{kF??3 :8Ǎ""8Vc(_*:@IPԁ\Zߔ(`O 8b%,,m2f>y -TVNe+df~q; pTz K\͔vOBwPn9w>m<{|x4k0axqX+AᥗꘙUyWW ŪW&K/9:'qCOQb' 2ėY'^;x=f~V9 CS6m<` EȠh)ߋ=5ӧ0ml, ?Zd{W8~qt/Sي0$&X0 " S 韞S9']?툙)a?w/M Z6Oaݺ'D aLiZ|ŏ9jvi7w=ejժcc0㥜mh|wڠN7Pu _[yC2glvvVZCHiV^Ne+ܽ{zus`̘ GVxM VLs(h9=z,8|{sR#\_ƍzeAjb"+|_VYg 3gz%++NxͭJ` IN^(<m/. J!ʈsDGObpƇ:@ Ql嗛foEFSǏ"YHS뿈xЋ5l0I!Ӧ]nZe3\a֬ZI->} [_d<'/Xt琞2&Ρ^s{xuč/ˆ_/2( //t5da6N)*"b `ߕ kv퇬A=kH @n0| cΛ7C (+S KJ/x7^N ZWY T&]>bϷ<@|b0o 1!{88udDd0~/W|l`T`yE@ Qԁ8{^6KEbʕ䖟 r8@( e+!S9B R"77S'Oٝ+2&A  @n`4 96 R6U8@@ʦ*  7@0HTAF)@ 9yio'&Ξ=؅ܻjde͚5T~  C=F"H㹹%TIنPq% C=F"0ωcuk }:}:ɓcǿס#Aj{l֮=%-zEQQrF{WWiڴ In{{j՘}u[)!aݻN}bTIzbWU%+ f i qe7@]yQ6ҖRgKɱӗ.?nܛ8q〗WSA$];?dÆβ#ufÃʋ(!hЙ +/FR*BTp"{L !yyY aYB(h6NB:wn?'ڵs<Ȁ\"hԝ}…$(SPhquUIOBK_l p:zΡ,ʋ(!hЙ +/FR*BT^ׯ ɓ?bH(+AЭ=Y+[<<\AAT3A|+ˀ|Xl-}7꯿߿@D)\fn%{D(/nAg (iKh q:U${sӧZ{#-=UԶ诼lZwʋ(РSvЕ/e#m) (_nPAʦ*  7@0HTAF)@@ hh eSsm  l<\ j@ @GBʦ*w7= DSO@ʦ*TV R6U8@@ʦ*sn#?~3t+&"%@ʦ*w?**P(Ko *!5| s<7o_&ׯZXWz F%!==յM6ng&x MS&R6URic N _USfNJ7@ Ȃ܀!X-hvÊĶH|>l eSJsh=߿+߼yCǎJs L ?uО& QܹgO6o֭|F!oO}|Z.-_>ep )cZ ܼbcmѣ׳gM㺸J޽u8EE֭:@F(.!xsad~}~e&.i.)*U*ϟ?ڵ}c? qt; KYr%xӪUc'';Ѕ3gM+(kMggd݀hϿY0, g\$hVzX1e˗XJ srʔ{{0hNNo˗w5SS6L0,L=&6;,sH+3{WX sAme3|p\ax_9rG2J=qd݀~wi~M#rܑU'HZif-(̙3\9~-UZغ?<SSWt)Y9Xsi%CBOE?8)(s>4^ɓ}fh R;E<%qd݀~w}ONG`Oڎ_9rs3ml,NN4 e˗@#Aw/Ã@H+n@9ۇPTFꜜ.]s뿕wݶ-lƌcX[dtE~~XкڵKѺ89d9oUp 8`0Y7Pz;jڬYÅ ǂ>4waSEIHׯ_wd=z ";̪53)lm-e=.n=b&A  `nPQaVo逑ɓB~44txy5ĖnQ~ɰΝ[ shEڶuѺ8@( BE *ۨ>"E :i޼֭1KoѢŋ/hup{ F>>yyYvvV~)$q t Tn?^?^ۇG۶ II<\A@ h4Bdm]Y o]h1;b==sraRvM"%ɺBCS7! %fe!Ar’\tg|BIPAʦ*.0^_J){CX}dO\9 :-tqԆfjES5 ] 7P3 MU(V4| %kzCϵd{4OF#⻮J_ .  [C$ R6ULszxZOӧ[Wٓ/XۡCKggƭ48wE 18~1L WVvL`ÆٌsW~1oT`o`,@ 0f~M4B/h]8]Α3}>W:YV HhƭcG9ҿЌ[H9ĉtOfϚ5rdi~!-Alz_ KѿtEsaZZWpCE^JR|}p{sDoZ5-S6*&4ZH05o|dGAHHoeCC9Ƅ8Gdx.En!/=fc`:ϞMd ˖.Jt_.5kPcyyYծcb[n9xJOM]gիi#)S9׽eƑr F?kU\ PN d},);؞=;:ڞ8GZC*͛?[)";wn!7oDm;vD5kw޻w1+ /_Cggǣڨ_m`n@|Wbb(̔ĜCjLs LVRoЗ.\H1ŸX-hfѓ:*Ww)9X6))|ŊIծRlq=2Z:Rp7&:8V-E/^܎dǿlF][㘛WbY : ݃d Y3qnڢdK8Ǒ#kīql >Z̙-1sȶHЬ}lA$QÆ=[|"[Z4n\PU$`ǘ 7Fvu(|v8 Ss:>H0Ye7'[V{`~iOky(!"]άI2^RЬjac˗-=1/VZs`PԮ&l1رlN+hH|ppŮoՠAzR40pq_N6GqYTR!-&nͨkkdZ ?ݴ0W&f;ali9k-G&E-4Fa\ ?+jyxUG29P`vP/_V={+N &Q h lhr!ZPa'*۴Pʕ+JVCs@ 0arfK cP-d\2`|rvv<@ke9е{ScwdzufȾ+`gOaqCIX4C.*hXd _P"$xAU0Y7`F$ c(?U*_7-kN2,yb@k6V4sBxʔ{{0/N.gֿ$48lq0i0aX{|[pX5Ժ8ǐ!3y@q00D²/7 NEF|;@ anxx(n]'VLIag1/T0Ae lـv{X"R=9m,ܢE#$ge- KͫߟpX5Ժ8f 73 w/bLʾ+0u`\Ύ/C8`n$~}BRHF{e۶95Բ#//ΊO/ ޯ_p sLqpM8u  TTu[_|ڌMӵ_$ fJw)Ҳe5Ժϡuu]rg"v7qPt U{we0έ?ٹs+IRjp{{իt8gNxˮs T|DA L ܸq"11ڵ}ÇbKs]ė+]ԃrlwwq8G1(=}a۾Bпllv._v(^\se zsQ'dxqLA >eX;+!3Z-=o73!-%b_1//KG *0ș>+s挀Uod/.=wRT6et8G|L/4/,))\6;ҲksٵZ̈☺uWf'0Q|S-6a494/_uA@{{뀀Nׯ4Y ><ׁ=Ask;޻$)szds`X> h7l @IsCY¥PҠaa|ٵZV~i͞=QopeC6/_,6ťY x ZOD8еx]:Z2гXz*l넒%]t.8j qZ, F&0 7jT|ٵZR;sV,/1!?LC,;p])27>~#@P&9 , dQԽ(]8G7U@Vyggg6سJARVK9NIJdg3!s@/Μ"^bH9 5k#@Ps;¥P9:wx4gCA a̡ƽ1ȮՒrU&۶1!s FcY]Wr{ZjP9 7CH (FLatU8Ǘ>pC_#M~2Ѱ3ߖWvs;~pR2D@@'9d j}FK0V> nѢY9`oo}q m[/\$q@Cbhׇ>|Zɦj*Z-s;8ԩ4psۈgaa^^M˗w Zahq,;;" K TT  9T+qz-,1k; CrҠgضmaCbRRz@`4P9K;H홓x= Sq@CR=w.1++N͛*^CD@`4PTpA  nR7"Q D9ƂF  A0sVs  9T+UZhr+$('CfIBqJ19<3ݻW7<9vi"A]>Ɗ_6#PFB"ݻxIQZ+19T+%E>}>pMo7\9 ^yyYޞKǬ\BۦǎŲo¼y#xƕlN >[3]kt޽7,B ==յ.M6ng&R!ky DyULRî(+eߊեK\4bgȓW$N?˫8嗛!88vmYWi.꫍-M8[읲 87V0&xG..΂!ky X1[ vŕDY)&[ t~}S#Gu8p`-ΑY{w,zusFYlm-͛纹5|Ly}9`/w/jѢQBB8߿+ %ma~={oڴ>:*QԸq=r%EEY)x@0&s` Qﳳe87VpՎeQZzz ~8zcƄYs„5jxz;q'ޔJY-ټb몘lf)?/|}ݺmm (b(v ZXO5$9bml,6mԝ[`aQ@;B5Kx Te&.PTXX0;;w~!;w>G ~`gOF!y=a 'O73nZRHY~@u-B1c"=r1C ,Lsh5z8',֭C/n |yHL Ŕ}^'=q(6V Z `ʐ"ΎoRp ^: 6%%5i֭a=П_=mڂ RBC,16Wk)C`Ѭٳ}b5}:fb0-4VĨsNH8l^ QGhܹ#U&#.I[ GzL9E y.y hBv`54q:uj (&BY qFKb0pfݟE۰a!ͫ_id[9vmGL~Rî(+sϖ >i癸!"i&N853[k?CYcg&mHsGBkժ4^9NIJ3!0V`5mZG߿ ]\1="EDzeR  rCojf?,\8i6Lov̙3F ßRc\lPłWt)YyFKk-zK[4};,z84s誘lX6m:vкi԰+l$JloxFxđg8CD,X0׷ _rJ<9rrR1浊rAJ0sqތb6o۬Yۆ޽7o(qU&۶1!0V`Աdb?۳g{GG[E"ECE4a`B>\Ίd'~˫x7 Dkf .AQ9bb88ԩ4psEoU69 @(/0Aa\֦Z53'UA|06{l>NzTte)ƸX8ZblfK4$88(ÇW(^OŤ;6,f_85BņDDY1h i͈ eAGaՅp bм|TiPaC0 dZ#1.5V45 R?Wǰ5,x!%i^˰PĽj';wn3''%RirƧ(Xe֭4q..\`YE*˺B˰PξPJ$zt9Pd8w.1++t˼~}B¼)uio< *B{  9T+9Bs9Fq qP8j8@(q@CR8Ǔ'\jfz*62&rٯr;˾ ڈY 'ͷoB[-[[ˆ ,_ԪVU? j[r% s1ulڴq;{6QՋфǏ%Ժ+Wl eץ~? jL xk? )1$;2&e8FԵkC6tp!iAd.%[<]VU 'ӧٟ~X_ gu}kB؇&:z II+VLj*yfHf.IT9^1QVWة" rCؔACR:c;"XxfW7/0OF#߄pE-Z4jРVHHCҼwE Ao<Gjkk 3?ׁҢ9W^ialL# ٳ}Ӧ><*[2~Zb^{Q(F=3`7+WRxG"g1 BJ/7 Վi-P3_яycQ1քs„5jxz;[:umrs3kvdK@5W7c @c2kX瀀NׯݣՏr? By ,}\, bŜCl`c@iOkhu]KY$An4a2sV D# =ql,[[71hONssP^fϞ(% Zd޽{5Ϭ-CA5y v]D2 ժafsz3*殮-šҎh[Xb5kڃ!m4cEzbjU3\tʐ"ճycś3URyQ*ЫWD.+%%mۺ7ՋϹl$C ({XX0;;wHF.ˮbӦ9994;+RpDɓcCs*$Nʕ1Zjd~p8~"{-AdCdACb8eX}7fG#C' dYc*ɾ ܏Nܹ+ɘ9"KvH\Vg^M?c0΁``l _k"[^;"\ ,N1sG#VMF2}ݙ)_>uj|'L r+6X ww&cÆb5do|L1ok>fW]_Q,7taP#O9Vs*$9Ĕ){fa(6NjI(!l ΡZ)s|lI;=G,, w/+'18dcCꇦNJg~H6/sP)~KEl 9bΝKĬ."[^#M.F=`eHv~_յ|$" R"=rS*y.17vR`Ɗ _7FOE?Ul0c5kuΞMhܸP*}=q@>k`AM+ILsb|dXvI9ÇCV!1p\]8;m,IP$ȍ& aqJloxFxđg8CDj%0=l 4bBw &R?'۶0dIOLZzaVBd+ëzԎ=_ݛYzc{lh0}$2" {pm187Vl [*6Xugu9sqoFDa1e mDz\rn7'A0IaU`'93{{78Bsjd!l ΡZ)s[:`d򤐽j0 8DV֩T /اO, ? f6's121:1?$ da8pBd+ël^Vhū3 YiwdduZÃ@ @VVϯnBQ(VK/4_-H7.F1p!찰`ߖ,($p 0*J9b2!9GIM& 9Ǩ>"E :ሔ ޯ_ƘjI…c1=ʔfCL_g~H6/1Z hpE(ӕk}|Z3c4-H+#յ.jPz-> 8ww\AZ;~m 4Xf 0JՃxc؋!NNv|>VƗi_GE0W&;XI0AaU`رXh_}՝qY9t][$Ah*!l ΡZ1h i͈  T,8fCYHy٠4ٜCt"齴]b3Eg x ?K +)1,cG % '%~]_㞗=$9`ѥg0Po􌦲¦ Cߕw1{] U';wnWT_?t 4ӣGEEsqqNK[⽽=srRo/h0M!f|t)[2M&{8jBr\bVV(w~}B¼)-A/zTm0YQ( l"`d.PT(A 99T+9Bs9Fq qP8j8@(q@CR8Ǔ'\j{ss3KXu*q: ΡZ1*6%DZc۔0oHa,&OنVVխ-,إe] ׅUrJ,?|~/LPt$lm-6t^d|Q{-P1ulڴq;{6QWѐǏ%Ժ+WΥ(kUڥjivz5.Ym)TJ9T+p kioG\4b?O/Vem8`>tW_m1㉿zJD_loo}`t*{--E4hA.g]u(^%%X1I?˫8嗛!l2UuwLjKdC>7 npdE+sVJscG ݻ888@Wf !p!޽EF  X!pQpׁb 90a[7 ۷ogAС='LPs_|CC^?~cyQ\/ &hhLRʕ_T΁({dZͼJ f=8l_Ϟ6Qٻ'qiݐu>y5t;3==G~̛걆 u8EErs3kvd7mK@5W7c @?;eZj՛j(!Ao,yw۶3 /JlpdiD ΡZ1sL;>?ƍ#ʷzmݺ? 3zt;G?fϞ(Ljfe޽{5Ϭ-C1>Ƀu!j0K YfV͆IUT?mի-Zt!4 6_dUbӦ999AAY usS=b.VTrƌ2Q2C b#YٍN\ofV%4ݴ8=^}$! P Z ^2H^xdX]h]JJŋ۶uٵ~ٲ H&hv1 fgɸu٩:HLܛE.=SY7P#ۃzol~I5z Qڈ)RQb#-N\= ΡZ1sN2,ybV !G `:;;+8?^@x)f86vzέX!H l^4YڵsG坘#իi0S'_a9P[ "h6Ib{x~i^'b6Ҡ8 G+[ΝCZ5YP\ڈ2Qʌs#0!ccidl/JoH1:H> NmcMG nK;(&f 4En0[9 񍏟)"͚= Zv.fCOUB? &Mg{^j~VsV !-}3qCDj% }{8~~DAZjx{{&5S b%`n l^>JSV@)-t"_|s΋o Gajsj.%9oK; >yV1@Ϛ5Lm4n\O(UU3qӊ]z(AY%{n֨aZԽHE :9T+sG"h cnز%TKwm4+<7/J 1\m˜!G)   7ߘܳYKG]q77WOуEޔH)X`o;ڵ}+![={wtecY9I*rS\-Hs{(hܳot݇Զm[7q q]1M[iAoyCŜcРqq3. 0sqNeL4õKv%1>=(\XX CVb^j~#ACR8稷tI!{?`~qHdSǩvm V-_> aB!ƌC3T N`~}nn .@`ޚ(90^[yz2vxq;ǿ.؎`kivXX0A?`<9-Α֭Cݷ}k̓áiU /J29dl/JoH:H>h#.  T:V9nBC.^b+bh=TeLs]&9 1>=K ٍ|] .˫it" :^=RACR8'vX䡰ȃaQY;ҔAA_N-\8.ѣLُLqp_8ufe"sU`1-F |bӚYX]ʎᏢ45cP=Cݎ]]̓K5Szj\SOiz9`^%h\P{l!h[H}uCA(^Kpww`ѧY^m f4J@_&eYC ?R.U3=Cv UBvc5u|q KgՖBwT@Cbn?^?XO? YHy٨4Ă@ ѪC x ?D 4c=]קx-em()=r%4eHX8))Pu*nHQ U/u5GW :Pz()Z Cߕw1{] U';wnşxG_?JebR;q..iiKYgNNq>U~aC(RTY ΡZP;x5 ׯOH3?yU A : ΡZP@ ssVs  9T+9Bs9Fq qP8jEaɱ;w>gAP!w/=77xy ]%)b8jE1oHaɓ}ǏH T 5pn|c\]:;;88شivlbQoJ^~qՊ9xs FxaiRR jQ97>{OfGGOrqq.RQmW˯ ΡZ)5α{"OO:u(23?p aߨ߿+.ԤI=uXf֮(+@ s䤚W;~yyY1Y4W\܌>}:|}ݺcuٮZ; ZS+Ƀya\c8+͹kW/=m2r0> ZլGWV =(\QKHiww׌.۵l_ACb8eX}7fG#C11Sw7l͆}lv._@=޼z5F\Ȑ!3 :a,K|Ԇ  }*/+ٞvmǚ5j# ]._ ΡZ)s|lI;=G,4!Aӧoe~Μ/ԪURʊC֬aA0AQF?''R\ȠAT_&`0AQFgEmۺ !bRgpX*ajqJᜣ#'Pi!"in>dccK/6ss3yt-[10(Gƍa :aϽ{8SR"ߺuH6u:8"-m)8tۮ#GܼyWxP9F,y(,`X0|GVg7hP c&88Iz,r꩖/ĉu,׷]ժf.$EeY=|xT@ &9񻻻 V\cߕ Ct.'';>K ˯ ΡZ1h i͈ \;vD`@S Zܶ-l_0A!ad/!K ڮb_ACb軲.f! =Q&&珊✖?ٹs_݋gNN#@P-Lsec|J]%qJ} bb\dxs0HN~^J  xƧ UPоssVs  9T+9Bs9Fq qP8j_r% ,bfq'Oݹ9Օ޽Lū*PPǓ(,FyWnmmqRr1 ˧YYq-['O?߿c^^VW׺6mڸ=(l 9T+$$$ q8q)(µks Fgᤤ+&ief_C4;:zzW0PPǓ(,%w/tS)*j\nmYdf>wŅ4Yq֡C{^5lx՟~Ӻn]'7usk`iBMj#lW[1v]4?]޽t;thyX,XycY=a~={oڴ>gu0aƞ;xE?v }hymؾ׮>Ƀya\d pU&3l: +W{Zjd6p'OC2 w|УG]zj l FWjV X2^x3*殮-nUT?Z4vl`^t\8j:Da9z'N~VO0aL=G;yr= K&vvV,23cww]m/ ΡZ'!!QXtqϖ >i癸!"&$hwXΙ3nVZzuW׺,}ڿE}IH$9HHHH%//oĈ׏d y&b铟׭['-믿nӦ #s\BWooo{{{$Ish'|ҩS[n]x7n@ 11ڵkÇ99'AR8 ޽aÆO4v(Kyȑڵk׬Y󫯾-j۶m bḸ TTepBYEDA@1DL%RDADHq\\#^3QrA)QB)qKY,sޗO&4(>>r1귷F5bP֮j۶SBVooz ÇA)Ĥ^ VVV999YYYԠMC͞=;11>}@V)B`ccCIԙdhhVRRB=!!!!zt֮ԩ\.Ɣ)S"##Y~~>C s@+^MMM.+** >>>fFFQ׮]|ggg+7dhe9ZP߾}B2@ y$ s CCC ?2@K}RR---yT ssՋYH2@K}R k޻w|@LfZbkd2nn݊w^!swNMcbb~??X2(^l۶֭ݻ{P(xO";z 5N}JKK˓'O>/ΐ9׫W/rԨQo[ s/%%399Ҳ [nNNN9d;d' V w=5hykh8Z5 S 8Cf!s03di2S 8Cf!s0g%~޹sfd@ `7ꊾf52MaJgeO|OhlqF\%tV55)v\v03QUqGG :d;wv14lN,޽}H-6qq/]:@=or@mm!cc(:NXȈ'?юNݺuΊ^J6 ۗ]Æ=IVt7M!,4׉-S 8S{՗V͝~|:TV, jMkyݼvX8՜9!l9 o0iw'dm K&[B@ugg9(go稞pmE<dž we=I +ZpJv,߽w@CgΝ;`aťg19Tr.|x믷ѭI8~#!s88XNzE&v^)[,[6=PWfR?;`s9#aenn=I*zuWHNdhQRϐ^Ѵ$Ym֭˩l]]xǎ{] x[( czO0O?̡vc3 9ea߻w9#3C?攗gQȠ~4ԞjXj'{ȵkTV՞+F[aLx^03 +Kwgj'%^{n',utrD'AA^tjѥK۷4 See7o UWWv9}SC77fTIKru<9;=}}7[,mϟOʕ3#zkD怖)=sPӒojjzhI۷G={Ą„kk&d&v\v96mƦsd?9EQ͝ݫwVf[[w#_ԅÔΞ;n:K&**r5 3UY)+zח <ݽߤG(|dL) }.BaJg,dp!BaJg,dp!BaJg,dp&q]˃>jtM= 03fۖQȈďzR񵵅7[ 39S 8f`?Gn#;bǺMbŋ{^a[ڧcQQ12S 8`}qtC?W?BJ?mI=;d{yyuQτ è}F$޽kТ03fƋ,;fߏ_;jJM ܻw:p&O.dp!BaJg,dp!BaJg,dp!BaJg,dp=sdd,Z41--ž M""55{E”θgg p$<<ۃ¹s_1H-4 3 ^b5p[QL8BVֺիd݀^^/Rǧ/|IңGөgذ~oرqc64~Ej[689Y==cs'Mgm2Shϐ!(d2L)3GJ{o1ee2ْuΞx}{44͕ 5>,.M%Aڊneggj,]:XX(Ag {<=ŋ{2/ϡ+==zЗϹSR{Q^Ŏzqzd2L)3…>4J؜1#8~饞/A6[FRo?=U͙޽9JKS'M򍌜w_}2O?eO7jԀ;8X)g]4$s=% 'I[[KǧGΙ%d&L)3GNQҥ;œhΝcff E1-۬x̱gϚ %.ToQHHx%;QtPE"K̡49T~%K&S$saJgϘ9ha93p̘׆Ojj(Zhְ_~ƦsQQۻC@)SEƷRSC`73 e>ݟyo saJgV9@tR24 D)!sH9@tR24 D)!sH9@tRV w=5}IVbÔΐ9Y :L) CÔT2GCImW*j4cRQ](d:L)L5sP`~oƣ*WVEq2S 8Ӑ9~6spfOX[wb7}eu4DQwN#vBe]D+KKssswwgӸGd>L))4^X-shkkujO٬G(vvQGn lkkI9nyb\WWdffM|vOVV :L)L5s4^[-shmٲ&̜9&Oݵkedի|ѿkaLج9WT$R\H?]PwoSSà >B=[F b7nhrr$0`Jg<ԅT 79N)ggtB{7cG۷ΞM޽ [5dM"XܹZ~ŋ{Z5KWWgذ~ \tuR^166HKvPXȈ,8:Z.߾}]]]0`Jg 5h3J*YxC㵕=9~EEEBQ`U[[(dZnjy ѣ\9szb5gN%͛7R[[kÆ#-tʣpa y.]:vdvt $aJgr;ah `'߶#GNI!sx{{t`BAȨ]hg>Affzee˖M34l۹sO;Л{@03 #+0jfsc߾g}Br%@̙ϧS&P8y33=#ÙO?<]ʡ~{vv$9#L)LCx?o;,pfs޽ssGG뚚B戍};0p}{/`V E1eeB'űcBYUVML gRFF**r 4ƤEު<++YYA2)isƨ ʙŸqC!d^>jݺzugC{E{ ǡ`bgcә,URBCöNNnn%%2X8C&9L){?XחTTr?g/dp9@tRٳd+f^2:aax}I2S 8Cf!s03di2S 8Cf!s03{~;X24L)L5s4.{7sePbH8:Z2Glہӷo,sPP7 GBYUVML gRvX#v_ZJcҢ\]ioUUENƬuԠMdhM03}N9[CshbB栢x1nPjlρZnn^YPvG==¢=Ppq׳n*)ia[''k77d  ,!m"s@k)CR]]+LMm!s0H2S 8{̱b kvК`Jgm>$ D)!sH9@tR24 D)!sH9@tR24 D)iiqЈ]xO hm06xCs03di2S 8Cf!s0' nF-7Kz5EBaJg>svxԤI/ D)599~g |&u*/s瘰^YYƲe vAW3wwzvqV!tT D)59tVFE>_MԩA],AWd*?|x[#R(dp\^7\X'mRJAtLjחkdԮ"KKSiLZZ=ʳ٘I{̌oQ,N}}B!s02nj1^+c;^Qga,\\tuull:JJZhh͡$zÃBBh^^/la EqFws_P :L)LgH?3FgGQ6Y]] VK**r5v4ɗӣ6 D)i[?`+KXY<8}R{@+W2/)dp}V\矏dd4pO.dp=s2S 8Cf!s03di2S 8Cf!s03di2S 8jD.6RW@2{60RIENDB`java-design-patterns-1.16.0/monad/etc/monad.ucls000066400000000000000000000070721312550536300214750ustar00rootroot00000000000000 java-design-patterns-1.16.0/monad/etc/monad.urm.puml000066400000000000000000000015661312550536300223100ustar00rootroot00000000000000@startuml package com.iluwatar.monad { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } enum Sex { + FEMALE {static} + MALE {static} + valueOf(name : String) : Sex {static} + values() : Sex[] {static} } class User { - age : int - email : String - name : String - sex : Sex + User(name : String, age : int, sex : Sex, email : String) + getAge() : int + getEmail() : String + getName() : String + getSex() : Sex } class Validator { - exceptions : List - t : T - Validator(t : T) + get() : T + of(t : T) : Validator {static} + validate(projection : Function, validation : Predicate, message : String) : Validator + validate(validation : Predicate, message : String) : Validator } } User --> "-sex" Sex @endumljava-design-patterns-1.16.0/monad/pom.xml000066400000000000000000000034461312550536300202520ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 monad junit junit test java-design-patterns-1.16.0/monad/src/000077500000000000000000000000001312550536300175155ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/main/000077500000000000000000000000001312550536300204415ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/main/java/000077500000000000000000000000001312550536300213625ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/main/java/com/000077500000000000000000000000001312550536300221405ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300237705ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/main/java/com/iluwatar/monad/000077500000000000000000000000001312550536300250665ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/main/java/com/iluwatar/monad/App.java000066400000000000000000000056141312550536300264570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monad; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Objects; import java.util.function.Function; import java.util.function.Predicate; /** * The Monad pattern defines a monad structure, that enables chaining operations * in pipelines and processing data step by step. * Formally, monad consists of a type constructor M and two operations: *
bind - that takes monadic object and a function from plain object to the * monadic value and returns monadic value. *
return - that takes plain type object and returns this object wrapped in a monadic value. *

* In the given example, the Monad pattern is represented as a {@link Validator} that takes an instance * of a plain object with {@link Validator#of(Object)} * and validates it {@link Validator#validate(Function, Predicate, String)} against given predicates. *

As a validation result {@link Validator#get()} it either returns valid object {@link Validator#t} * or throws a list of exceptions {@link Validator#exceptions} collected during validation. */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point. * * @param args @param args command line args */ public static void main(String[] args) { User user = new User("user", 24, Sex.FEMALE, "foobar.com"); LOGGER.info(Validator.of(user).validate(User::getName, Objects::nonNull, "name is null") .validate(User::getName, name -> !name.isEmpty(), "name is empty") .validate(User::getEmail, email -> !email.contains("@"), "email doesn't containt '@'") .validate(User::getAge, age -> age > 20 && age < 30, "age isn't between...").get().toString()); } } java-design-patterns-1.16.0/monad/src/main/java/com/iluwatar/monad/Sex.java000066400000000000000000000023761312550536300265000ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monad; /** * Enumeration of Types of Sex */ public enum Sex { MALE, FEMALE } java-design-patterns-1.16.0/monad/src/main/java/com/iluwatar/monad/User.java000066400000000000000000000034531312550536300266540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monad; /** * User Definition */ public class User { private String name; private int age; private Sex sex; private String email; /** * @param name - name * @param age - age * @param sex - sex * @param email - email address */ public User(String name, int age, Sex sex, String email) { this.name = name; this.age = age; this.sex = sex; this.email = email; } public String getName() { return name; } public int getAge() { return age; } public Sex getSex() { return sex; } public String getEmail() { return email; } } java-design-patterns-1.16.0/monad/src/main/java/com/iluwatar/monad/Validator.java000066400000000000000000000101431312550536300276550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monad; import java.util.ArrayList; import java.util.List; import java.util.Objects; import java.util.function.Function; import java.util.function.Predicate; /** * Class representing Monad design pattern. Monad is a way of chaining operations on the * given object together step by step. In Validator each step results in either success or * failure indicator, giving a way of receiving each of them easily and finally getting * validated object or list of exceptions. * * @param Placeholder for an object. */ public class Validator { /** * Object that is validated */ private final T t; /** * List of exception thrown during validation. */ private final List exceptions = new ArrayList<>(); /** * Creates a monadic value of given object. * @param t object to be validated */ private Validator(T t) { this.t = t; } /** * Creates validator against given object * * @param t object to be validated * @param object's type * @return new instance of a validator */ public static Validator of(T t) { return new Validator<>(Objects.requireNonNull(t)); } /** * @param validation one argument boolean-valued function that * represents one step of validation. Adds exception to main validation exception * list when single step validation ends with failure. * @param message error message when object is invalid * @return this */ public Validator validate(Predicate validation, String message) { if (!validation.test(t)) { exceptions.add(new IllegalStateException(message)); } return this; } /** * Extension for the {@link Validator#validate(Function, Predicate, String)} method, * dedicated for objects, that need to be projected before requested validation. * * @param projection function that gets an objects, and returns projection representing * element to be validated. * @param validation see {@link Validator#validate(Function, Predicate, String)} * @param message see {@link Validator#validate(Function, Predicate, String)} * @param see {@link Validator#validate(Function, Predicate, String)} * @return this */ public Validator validate(Function projection, Predicate validation, String message) { return validate(projection.andThen(validation::test)::apply, message); } /** * Receives validated object or throws exception when invalid. * * @return object that was validated * @throws IllegalStateException when any validation step results with failure */ public T get() throws IllegalStateException { if (exceptions.isEmpty()) { return t; } IllegalStateException e = new IllegalStateException(); exceptions.forEach(e::addSuppressed); throw e; } } java-design-patterns-1.16.0/monad/src/test/000077500000000000000000000000001312550536300204745ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/test/java/000077500000000000000000000000001312550536300214155ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/test/java/com/000077500000000000000000000000001312550536300221735ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300240235ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/test/java/com/iluwatar/monad/000077500000000000000000000000001312550536300251215ustar00rootroot00000000000000java-design-patterns-1.16.0/monad/src/test/java/com/iluwatar/monad/AppTest.java000066400000000000000000000024701312550536300273470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monad; import org.junit.Test; /** * Application Test */ public class AppTest { @Test public void testMain() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/monad/src/test/java/com/iluwatar/monad/MonadTest.java000066400000000000000000000050041312550536300276610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monad; import junit.framework.Assert; import org.junit.Rule; import org.junit.Test; import org.junit.rules.ExpectedException; import java.util.Objects; /** * Test for Monad Pattern */ public class MonadTest { @Rule public ExpectedException thrown = ExpectedException.none(); @Test public void testForInvalidName() { thrown.expect(IllegalStateException.class); User tom = new User(null, 21, Sex.MALE, "tom@foo.bar"); Validator.of(tom).validate(User::getName, Objects::nonNull, "name cannot be null").get(); } @Test public void testForInvalidAge() { thrown.expect(IllegalStateException.class); User john = new User("John", 17, Sex.MALE, "john@qwe.bar"); Validator.of(john).validate(User::getName, Objects::nonNull, "name cannot be null") .validate(User::getAge, age -> age > 21, "user is underaged") .get(); } @Test public void testForValid() { User sarah = new User("Sarah", 42, Sex.FEMALE, "sarah@det.org"); User validated = Validator.of(sarah).validate(User::getName, Objects::nonNull, "name cannot be null") .validate(User::getAge, age -> age > 21, "user is underaged") .validate(User::getSex, sex -> sex == Sex.FEMALE, "user is not female") .validate(User::getEmail, email -> email.contains("@"), "email does not contain @ sign") .get(); Assert.assertSame(validated, sarah); } } java-design-patterns-1.16.0/monostate/000077500000000000000000000000001312550536300176415ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/README.md000066400000000000000000000017641312550536300211300ustar00rootroot00000000000000--- layout: pattern title: MonoState folder: monostate permalink: /patterns/monostate/ pumlid: HSV14OGm20NGLjO23FVj1YEZsGaa0nzjVxrvUszfLdlkaju_9p3ZI-HybwFXp2r3l0w364eTIgtdpM2d7r-yxXBji7Ko86v1ol60TDW8C8G4zLr9rp9J-ny0 categories: Creational tags: - Java - Difficulty-Beginner --- ## Also known as Borg ## Intent Enforces a behaviour like sharing the same state amongst all instances. ![alt text](./etc/monostate.png "MonoState") ## Applicability Use the Monostate pattern when * The same state must be shared across all instances of a class. * Typically this pattern might be used everywhere a Singleton might be used. Singleton usage however is not transparent, Monostate usage is. * Monostate has one major advantage over singleton. The subclasses might decorate the shared state as they wish and hence can provide dynamically different behaviour than the base class. ## Typical Use Case * the logging class * managing a connection to a database * file manager ## Real world examples Yet to see this. java-design-patterns-1.16.0/monostate/etc/000077500000000000000000000000001312550536300204145ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/etc/MonoState.ucls000066400000000000000000000063331312550536300232220ustar00rootroot00000000000000 java-design-patterns-1.16.0/monostate/etc/monostate.png000066400000000000000000000402161312550536300231360ustar00rootroot00000000000000PNG  IHDR":@UIDATx XGǓ$j4k7WAPQ9ROT<≷F xED<(*I7nb>5&f5g335=yV[@",gԾI"H$=CҨTl^$0d3Œf7Œf7Œf7Œf*&-qrU֭WkWJށFaƃ?6`݄%-w2ij6fsOK izԤf<Ȫ%萘2Oo;}^VGgEכ#%/zMP~M5gN$;&5NaT7of.a!،i˕]ow]4h9ڷoz+WNCOT3KLf}WG pc۵xRWHXt!>'{N3ى5{. ];jTX׷?`%/ZJe?)f1QÆuaʃH1S=u*{,Ν-wwopG|X-[]C֭iQ 3d=̂-." g6`̮^ͩ\k]Rƌ6>w. =<͚͝ >l6nhAA^RPʕO/]ʊM6RAD={v ֮] >ϟ0wϞ%W^FV} 3NdUo*˴t@"_ea>]a'ҷdY36$qolݱc^z=I`Gǚ7%[#<^ aW2z"bf|/ҿ󊆞!2Q֐u:f aqOBׁkFݼ} {G֌ [1fK֬y+m/b+1i߾wRd6n\1@Ezh_~٥ "HJ1[rF nҥ.^\+ 8=_!xU4֛c1]A,Iz"afW,^p!>*F123aƃԙc(}.싿МF aƃhƍ0Aƍ0Aƍ0Aƍ0Aƍ0Aƍ0A\ch˖[pcF 1cVj~aPqo/F bVTۥOX[ލ{{ 1[m9؜93cѢS m% %`Q իEZ-v?iRftժ*gl~=GF"(ҥ;5طo,o,.Cyz=*־}ղ;"ΝÆN-ǁ>}ڣG)LK,f wq˗O&ixxƍ/bţ|(}{"#;=.Y2)--ﶱy(l䬬$:d8/ڷxCw c0yr?޸O@Щ|l⚑8xp=3m˲]J'ϟj 7>~6̉dA+{~M)m6HV| aúT۴,?)fz/-.[O>׷ر==lb1=l1aaY3g%C=}z#d?GFD \9 *tF? gҩSk삓ٲ%VER.X0:;{z|13t 3'ֱ72 ZZ摟ysŋ; 3m˲aӽ?\ a;F\j^x0[@&\zn'co6n̿u"J+hM6IOO|W<0t 3O?'lllOS%CiU6𤑬,F LF LF LF LF0#iR*6/y3aƃ3aƃ3aƃJpccs!~{"k*%fzP=5Œ'R=5ŒӸo2BBZ?LYR80ALN! YQQR{F vJ;޽#4<<ݾ}&JtfȐNw2_~ر=Uo3Œٹ]DC}:HO0۱#[G/=wW\}%fKkzΝqwo6UQj3T.NF1Ց^OttܪUF.]|Xڑ#f2Œ3!̉LHrZp6,>0fkv-VVnsX7aƃ=}v7=Ǚ31s͛c!k..i޼1ĉ ARSMYae춈=uf<4j3Di3W4ݰg3DLF LF LF LF LF0#iR*6/y3aƃ3aƃ3aƃJ=w՝{-̈f<4}KC$ToIdF0ALr!#xy0+,̨SzYZ[p qp(׸q]X-lzu%wmoҢ|\!)f<7˙q>xSv#x׸f<0Ӹf<0Ӹf<0Ӹf<0Ӹf<Ӎ,>g ]m^#xP)1`OGD3TvoIdF0Ae4zŗg!zsntj޼q&M_md͖>W颭[6lS>U~Wd of[W꯿0:t>p`&,2W5aI2z f̹|9j*We$ã{g<ѱfaaЖ> _l<,\ }3TiAiUz\he11^y奞=PΉcX?yrZd-z.A8;AQ0fZyMV4֖-OXg<…LggG$flEC[\0P 3C a'zڔhe΃҅ƌi<ֲ˹sihz4ϥ3 37CiL扞6%2Zt>ARR&p]۵kЖ>t߀ʈr!4&DOttPqb#6,f88KM6MIDyYD9L7CiI-mF[fTر5XもTʠ3epqJYD;̨"mТ1ыOd6lm=b4L lf)DOɠ4fXcfH];s"fbبQݥ'dxB)f%cϞR^pe\3+ 3;y)cמ=KDdh֗D̬av"L140s'zzӦ4/P /3e%bzc)ٺktt$ruSc@0׮]HKL섙}<qCoC;_ޔ3D\ B5jTE+G>Z{j"v-}fpIysS(1?;af2O4z_[>~ u0XR?^NM DOl򩪷-˙ͽ0A4C_F LF LF LF LF LF LF LF L gq.,pp(׸q]o[p }o5aƃYbpf1 IkVeB0AE f}l/em۴q'ǧi~j/׷iAA pfi@ |Ǜ&xPi)+ 26cr֭_s75+ 0il Q={XK0A扞E1~YW ֭]6qe-M\fa3W, XՄ2Ot㗕{)6,8"4,Z*kɮf7F 5L0{ 3diY㗕{aԩ5kM(oyUTFU֒]lK< XՄ2O,X0;e{zz:S:lA 1[@VKvb84 Z66[-} %[M ~G%2`@lŒ͂YO]kh 6aƃwaƃ3aƃ3aƃ3aƃ3aƃ3aƃŒIؼHLvwԾiEEEj_xfZU'TL0+P*HK;mDi 3&VPPUIkmXi387|i}Ν;{ ;mڴ>}o߾&,%`UI5/^vچ rrrДٮC֬Y9ɓ'²#+ Gc騨5k~u鯿2ӧ'ٗTٳՋy[N迭_tؑpႳ33f@xaّea6aTg Ν;Wy-ZG=zԬ߁5OGCTU1KHHױy޽{w=66vΜ9 f˖-ϝ;tb K,R`f§sssAR͛֍7j׮~ݻ tE9)))Ço׮ ˎ,; 3)Zcǎ]n>YŪK5Μ9Qn޼YӼyVZM8Ç2._6VY*fsDGҥK8ӧCKЀ(T]}J@=+| f-vIVaf/*ISY[ug>}+fL4NSEv(Xl}]s0HKNNVݵ9;LfM]#o~~~j_.ڜtlB{~A=x3玎fiԻ(.0˫R sh 32$鶛4+.0$aF)##iV`&:4ȕ){Lx2idG1&a+ Nia&fj_ɾTJ̬;e[nDTK q2+51aƻY3"e,#Œw2fZ@ f ye7?LԷ)*oߐ!Nꌢ-]ΝKsrz?Q:8s a"|Zv"_ 'N oK'[m`FQ?)(HPn6m6s& w^\ 磻L>kv-[@4 94r7ne)+űQԮ]Mq#ΘȄ)s4#=Ecƌ~YwmhT~mΟ 0s޼G6(vrC9H- ڭ[o|CwO:ʊgl`Eݼ9Fjp9RnjV/3ލ Ծ aƻ"x70CQ8ɐ3ލ7R|$C"x71k׮4Yĸl X7!tID]; D9`1ڗõlYK@M㧥OgNW{L|E^^-m`\cܣCbb7ި^W{DY+4fwURƖRek>`'=k2B|NM U͛7m "-servers" Server @endumljava-design-patterns-1.16.0/monostate/pom.xml000066400000000000000000000036001312550536300211550ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 monostate junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/monostate/src/000077500000000000000000000000001312550536300204305ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/main/000077500000000000000000000000001312550536300213545ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/main/java/000077500000000000000000000000001312550536300222755ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/main/java/com/000077500000000000000000000000001312550536300230535ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300247035ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/main/java/com/iluwatar/monostate/000077500000000000000000000000001312550536300267145ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/main/java/com/iluwatar/monostate/App.java000066400000000000000000000045401312550536300303020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monostate; /** * * The MonoState pattern ensures that all instances of the class will have the same state. This can * be used a direct replacement of the Singleton pattern. * *

* In the following example, The {@link LoadBalancer} class represents the app's logic. It contains * a series of Servers, which can handle requests of type {@link Request}. Two instances of * LoadBalacer are created. When a request is made to a server via the first LoadBalancer the state * change in the first load balancer affects the second. So if the first LoadBalancer selects the * Server 1, the second LoadBalancer on a new request will select the Second server. If a third * LoadBalancer is created and a new request is made to it, then it will select the third server as * the second load balancer has already selected the second server. *

* . * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { LoadBalancer loadBalancer1 = new LoadBalancer(); LoadBalancer loadBalancer2 = new LoadBalancer(); loadBalancer1.serverRequest(new Request("Hello")); loadBalancer2.serverRequest(new Request("Hello World")); } } java-design-patterns-1.16.0/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java000066400000000000000000000047401312550536300320730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monostate; import java.util.ArrayList; import java.util.List; /** * The LoadBalancer class. This implements the MonoState pattern. It holds a series of servers. Upon * receiving a new Request, it delegates the call to the servers in a Round Robin Fashion. Since all * instances of the class share the same state, all instances will delegate to the same server on * receiving a new Request. * */ public class LoadBalancer { private static List servers = new ArrayList<>(); private static int id; private static int lastServedId; static { servers.add(new Server("localhost", 8081, ++id)); servers.add(new Server("localhost", 8080, ++id)); servers.add(new Server("localhost", 8082, ++id)); servers.add(new Server("localhost", 8083, ++id)); servers.add(new Server("localhost", 8084, ++id)); } /** * Add new server */ public final void addServer(Server server) { synchronized (servers) { servers.add(server); } } public final int getNoOfServers() { return servers.size(); } public static int getLastServedId() { return lastServedId; } /** * Handle request */ public void serverRequest(Request request) { if (lastServedId >= servers.size()) { lastServedId = 0; } Server server = servers.get(lastServedId++); server.serve(request); } } java-design-patterns-1.16.0/monostate/src/main/java/com/iluwatar/monostate/Request.java000066400000000000000000000025531312550536300312140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monostate; /** * * The Request class. A {@link Server} can handle an instance of a Request. * */ public class Request { public final String value; public Request(String value) { this.value = value; } } java-design-patterns-1.16.0/monostate/src/main/java/com/iluwatar/monostate/Server.java000066400000000000000000000037221312550536300310310ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monostate; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Server class. Each Server sits behind a LoadBalancer which delegates the call to the servers * in a simplistic Round Robin fashion. * */ public class Server { private static final Logger LOGGER = LoggerFactory.getLogger(Server.class); public final String host; public final int port; public final int id; /** * Constructor */ public Server(String host, int port, int id) { this.host = host; this.port = port; this.id = id; } public String getHost() { return host; } public int getPort() { return port; } public void serve(Request request) { LOGGER.info("Server ID {} associated to host : {} and port {}. Processed request with value {}", id, host, port, request.value); } } java-design-patterns-1.16.0/monostate/src/test/000077500000000000000000000000001312550536300214075ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/test/java/000077500000000000000000000000001312550536300223305ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/test/java/com/000077500000000000000000000000001312550536300231065ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247365ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/test/java/com/iluwatar/monostate/000077500000000000000000000000001312550536300267475ustar00rootroot00000000000000java-design-patterns-1.16.0/monostate/src/test/java/com/iluwatar/monostate/AppTest.java000066400000000000000000000025021312550536300311710ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monostate; import org.junit.Test; /** * Application Test Entry */ public class AppTest { @Test public void testMain() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java000066400000000000000000000047761312550536300327770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.monostate; import org.junit.Assert; import org.junit.Test; import static org.mockito.Matchers.any; import static org.mockito.Mockito.*; /** * Date: 12/21/15 - 12:26 PM * * @author Jeroen Meulemeester */ public class LoadBalancerTest { @Test public void testSameStateAmongstAllInstances() { final LoadBalancer firstBalancer = new LoadBalancer(); final LoadBalancer secondBalancer = new LoadBalancer(); firstBalancer.addServer(new Server("localhost", 8085, 6)); // Both should have the same number of servers. Assert.assertTrue(firstBalancer.getNoOfServers() == secondBalancer.getNoOfServers()); // Both Should have the same LastServedId Assert.assertTrue(firstBalancer.getLastServedId() == secondBalancer.getLastServedId()); } @Test public void testServe() { final Server server = mock(Server.class); when(server.getHost()).thenReturn("testhost"); when(server.getPort()).thenReturn(1234); doNothing().when(server).serve(any(Request.class)); final LoadBalancer loadBalancer = new LoadBalancer(); loadBalancer.addServer(server); verifyZeroInteractions(server); final Request request = new Request("test"); for (int i = 0; i < loadBalancer.getNoOfServers() * 2; i++) { loadBalancer.serverRequest(request); } verify(server, times(2)).serve(request); verifyNoMoreInteractions(server); } } java-design-patterns-1.16.0/multiton/000077500000000000000000000000001312550536300175035ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/README.md000066400000000000000000000011721312550536300207630ustar00rootroot00000000000000--- layout: pattern title: Multiton folder: multiton permalink: /patterns/multiton/ pumlid: FST14i8m20NGg-W16lRUXgPCYnD81Zxs-hfozzvJlOywf68yBc3bYoZuRgVYghrIea-7E5gVHZhgPd3Gcp-y7P9w-hOOaF0au_o1h0OKqqdG_saLrbRP-080 categories: Creational tags: - Java - Difficulty-Beginner --- ## Also known as Registry ## Intent Ensure a class only has limited number of instances, and provide a global point of access to them. ![alt text](./etc/multiton.png "Multiton") ## Applicability Use the Multiton pattern when * there must be specific number of instances of a class, and they must be accessible to clients from a well-known access point java-design-patterns-1.16.0/multiton/etc/000077500000000000000000000000001312550536300202565ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/etc/multiton.png000066400000000000000000000246151312550536300226470ustar00rootroot00000000000000PNG  IHDR&)TIDATx[eEw4>΃53(zZ4dP`ڃ84#ni lQg A.eOЇd20Ĵ8RU_շn{ZZ/.UU)&M]DUڰA*\Kt|PP[ Q 肠 *kmy8X?g /uy, 1`@$~Dž~e4Ͽ0^sw!Apy-6 tY:~ϪEGx4r+̝M;uFQbayQʴ*:6z $B$NGZ(凒]1>!*kㅰn!6E{I9Mڙt$]O>,hX|-gː?IXʼn<ݩ]eKo`[v?Dd0%W{."sWKtJ3T ~!9Z4>~YivB?WdDz'ё N-GWT_n*xEStr䄓3@U%AU tAPU]T@U%AU tAPU]?>|W\"Ş kw >ru!~ώs~#cyyFw: tXw|'nΏ/&/q& MlU@W[%^sƟ|K/Lk"tpP.ه~^㉟|Glztgn~HkХ/4sHģCcc Rڪ3v_r%x׿/L{gqЅ^&r|i` 6԰6݈Hv5<t]mhm/nHHlgYy]gG|e <&ҲŖucdiѯ9A!Vzo;wGtyBxcG<7suתrm1tigʥ9Vf-CFTvw׏^XYUc_<+i{OR9Zn &қrtU/;}/|gɈPD1Wcz얡]m>%{N3;o}Sl-\l=JJECMdƌ4ګ1\ЀqvK t grm-{(ZlGUTm&j0AuV5(6Z;3t7K4h"~|ݾoIq ;7.h.q23Sg[ WFs肠 *.J 肠 *,`_ tA*vIW|ԗZA]w1ŗuɐU55\sq4Ű)""ew2V=$AW{rhVAWF3I1?v[=j ֊jU9sW/" 25/]ZNE:, ,tK SJfcfNh0 Ժ Uն]P *.J 肠 *uu ~( R*PwA>jб tAtAPU]TFz5z5 * :Vw..J}kz߶|o|sQ=Ӟ0jF=.$PdDS)5+ӓG36u\w-NiKkG>_PugKMy/tM^ѵ?\}]>%+udkYzH'.%[!{(|]n|Twf8zDSpͯsϹHb1_K UV?әtCCwoo嵥ז.۫ڐH<]>nh:1tZr]PEz_vWu=$(z'VE==<μt5syI7뽕q?s[$wT/8u%(jQgtуek%X=nVYWgغv|ޒ=$|նBRŮX=!h]DNJm5=T5kN tAPU]TLw>Fpt%.UxTuIK?K5]nZ.ks6s^%p0eRémvn]Skg%1-=]}7;7zD9¥^#6D Fp4gK= ?xH^*cMiO9oҩcۛfg5wO~ l{Ƚ_N-<U㏨U>u&zevn]7<Ž/4)~;IZ-J~0bƠH؟)֩@Իn]k_75%qnk]#~_N='ҫG:]Øl$L%ocssSﺟtm9x.]lbԽKb'Iˮ>L1]sU?w;)]: _څ$KZ G"y!թrfG]jf uȑI7m۶ӂXZZ*QCk2 |X Vٍ2|HƷ-a߰aCSHݻC~_ꨝ.f1ː[u#G9x7YQnc>oo`%_yeȭQ2zBW\UpLvxIWib&zD't/s9P)IwMd.n%!##?]z.DZt.,2a7_B+]ZF3=#Z}Kk mgB.zAWGtܷ]80 !Eq. 2PB@Qp !Eq. ucǎ_uE )ƶmv-ūM‹]e^[~$]b/^m rz%BŅ]BBPq!U+ b \]a.gV_.T\0@/A*.De*KЅ F6lx':1WT]$ 5B z0 tAtT袩 r'ESANIp8qy6;ܝw݄@M ]Zﭸ@MC|9,kW,ESkk%vao^DA1Z1_kFft'W zÇay/oaVUr]gfiQ^YZE7+?^FDRTRgM+YBxEuck䯵2GnU/5oxCWR9+bC 9y/Rꮈn\% }]]x7<.~[`Iy!9s5w)} 9ao%=wrgXYxKWT{V2-_f)ͭ55 ghߪW]4+ tT袩 r'ESAN.ȝ@M];. w]4K^uGj=:Pl=)ESP=zםJlm]b?͌%yކc-5&ES=K ?{`w\f) ]MRc]4'DOZOwB?Q<-QLk"ʢ}[jLD7tηoX~sg|fZF:O+ʺ̱CE>n}i[ w#UɱI@M{|_8[7|T(Ň D%r " 4/n楑?NFٚ-䬈GOF+ytUmK4v_λ.z2+/\zEW]0eN q2*׸ѥ&)L+1n .]^gɡBZ{!& suת)ڳ+ T*,4sU□Y'뷚LǠKF[m?Q;ơPH׿>rkԡnfXn!-+t%.}z֣WO_D׫? }UPKT6G17[vP7,+-填 }DпC׾mu=zxj֣Ha0U٫1\Jsyo)]\F#~Е;3".G j O-Pl*8Bu3MӿA2ga[ʢ3@]Ӡ3w^m`aZb tT/jF)SBh*e4kzy.ESAN.ȝ@M];. w]4tAh* tTХ_i.ESA+5@Mm=]֢>1*E9O~klz{YXK C(GKij+Y.Dž{2V-26-йR5aj%YNn4eӚ[.~`kMT}em-x`YQ%FvZ.AMm;]P@sj~F; ?i'V tԶH2/e`dc$鯶^.n!yrɲӗEډe~.nV ЕZeq+[|8@ې嫠U+ h* tT袩 r'ESAN.ȝ@u Bꊵ' jF]$tAh* tT?| ' Et+!A_@M\/%=J&zIPo`Om - kz c,~"jT:Pn]4բKFjː+)#5Z$Kg$3B"B%7_]]v.GB_[=8Ut%:3 v9aBE.`t GW׭]ZtaPl_of)Nap fhO*4tDZJ<ՐSesWC9y?W?Y+Z`5'rضB&2s_7*+eoEAW.AՏ_2jȮVtʟP{5*R뮉GZaretxX7IɜBN8kNR*I$?ܜxcs]+uC9&u h_2JAW<7-iiQК=]^=+ʁ.=@Wl$ Ѳ 42HI6B碋8&SӐKGuBuW]48C=siE){Ў ԌZ~Zwwkr2wֽͤstUMC ²evߞis$[rڣU:en7l鴇˙-kstU#_QA?)Oe袩ĺ. w]4tAh*ɐ;. o2N› 袩eɃVb#m{I6z!C!p.!ESzYU޼L S<΃[mDkeESK{Y1xyY6^QI `ϼPBqsy.ZޛJlR2 FdVb:v>dZz%'yˠˊ:ɳ~^+qB 9iG6]J eeEXh$Ѐ+iʤ+؆stiQ78hXO^ LˠFVbb^N|xp#_A 2S]ys_Ck&_`d}e^(C:e%c}S_ˠ?)ƹ h*L=t.. w]4tAh*ɐ;. o2N› 袩̗@[:|K`PbhuNƐِ926 & OqhuɯMMDX}1)n@MunĆ(9s0k$̖fx}袩N5~T F byM ۛ%ZdXQ{6dxg.ě\ðjMmQA.C袩R=Ůh* tT袩&Ch*ɐ;. o2N&K%`MI.ZƛtfޔUtܼ@M-MQSx3o^sQ027!ESx4̛j.Aè˛\.̛,2tUuyey+/$f`d]E.o,3oa@̠ś^@hyz5[9]02Q8C|tNVaIAWr5Wupq_2K!5cc?\IAF#32RAWOJ02.3 ֝#.ESQwAh* tTx!w]4dȝ@M7r'ESxU1YqL{jsj;7Mm tT E&dwʵ`jfhjyor38%"GDJ^4N\S3ʓZڛ걶dn@u'邩tQ79}`XGrăę휳#._N\+[AWZjIorڪ a9Y\/7t M- fЕZʛ1!-sWzq1 ̷cmAWbu4 ^\Ok邩tgXdcB/t hj)U`g:Y_wb\feȷK15. !S3袩!u h* tT袩&Ch*ɐ;. o2N&g~/L:y+P: !g IWᖂS hjoc"{2q6`o!q@S@\f&<]=2.Zƛ촹̹{5 Y c5f[N:)tdN*˾g[A״iorBjdw^qRg7AW׭ǠkZ|~\le"坳7&F"3޿T3礋 eA og tT'%Ǚ]4tVX3h* tT袩&Ch*ɐ;. o2N]7v}5xvCʈ~g.tdvEj8u]]4uF'3qHwg.Z$7j.Zvde:z'{ij9,dF%`PIҺ=Y`tIM7wc;#Mv_NNaf#3@@[G]?ůb'Ifփ]S'tm9x.]|bԽKbg"]ݛ 2hjr+Ͼ{_ص{7 9U\_Wy$t|3'f tTU}WQ.8]^ahjt=g+@M.3]4tAh* tkt!UHIENDB`java-design-patterns-1.16.0/multiton/etc/multiton.ucls000066400000000000000000000052101312550536300230170ustar00rootroot00000000000000 java-design-patterns-1.16.0/multiton/etc/multiton.urm.puml000066400000000000000000000013061312550536300236320ustar00rootroot00000000000000@startuml package com.iluwatar.multiton { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Nazgul { - name : NazgulName - nazguls : Map {static} - Nazgul(name : NazgulName) + getInstance(name : NazgulName) : Nazgul {static} + getName() : NazgulName } enum NazgulName { + ADUNAPHEL {static} + AKHORAHIL {static} + DWAR {static} + HOARMURATH {static} + JI_INDUR {static} + KHAMUL {static} + MURAZOR {static} + REN {static} + UVATHA {static} + valueOf(name : String) : NazgulName {static} + values() : NazgulName[] {static} } } Nazgul --> "-name" NazgulName @endumljava-design-patterns-1.16.0/multiton/pom.xml000066400000000000000000000033611312550536300210230ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 multiton junit junit test java-design-patterns-1.16.0/multiton/src/000077500000000000000000000000001312550536300202725ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/main/000077500000000000000000000000001312550536300212165ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/main/java/000077500000000000000000000000001312550536300221375ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/main/java/com/000077500000000000000000000000001312550536300227155ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300245455ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/main/java/com/iluwatar/multiton/000077500000000000000000000000001312550536300264205ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/main/java/com/iluwatar/multiton/App.java000066400000000000000000000050171312550536300300060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.multiton; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Whereas Singleton design pattern introduces single globally accessible object the Multiton * pattern defines many globally accessible objects. The client asks for the correct instance from * the Multiton by passing an enumeration as parameter. *

* In this example {@link Nazgul} is the Multiton and we can ask single {@link Nazgul} from it using * {@link NazgulName}. The {@link Nazgul}s are statically initialized and stored in concurrent hash * map. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { LOGGER.info("KHAMUL={}", Nazgul.getInstance(NazgulName.KHAMUL)); LOGGER.info("MURAZOR={}", Nazgul.getInstance(NazgulName.MURAZOR)); LOGGER.info("DWAR={}", Nazgul.getInstance(NazgulName.DWAR)); LOGGER.info("JI_INDUR={}", Nazgul.getInstance(NazgulName.JI_INDUR)); LOGGER.info("AKHORAHIL={}", Nazgul.getInstance(NazgulName.AKHORAHIL)); LOGGER.info("HOARMURATH={}", Nazgul.getInstance(NazgulName.HOARMURATH)); LOGGER.info("ADUNAPHEL={}", Nazgul.getInstance(NazgulName.ADUNAPHEL)); LOGGER.info("REN={}", Nazgul.getInstance(NazgulName.REN)); LOGGER.info("UVATHA={}", Nazgul.getInstance(NazgulName.UVATHA)); } } java-design-patterns-1.16.0/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java000066400000000000000000000044571312550536300305350ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.multiton; import java.util.Map; import java.util.concurrent.ConcurrentHashMap; /** * * Nazgul is a Multiton class. Nazgul instances can be queried using {@link #getInstance} method. * */ public final class Nazgul { private static Map nazguls; private NazgulName name; static { nazguls = new ConcurrentHashMap<>(); nazguls.put(NazgulName.KHAMUL, new Nazgul(NazgulName.KHAMUL)); nazguls.put(NazgulName.MURAZOR, new Nazgul(NazgulName.MURAZOR)); nazguls.put(NazgulName.DWAR, new Nazgul(NazgulName.DWAR)); nazguls.put(NazgulName.JI_INDUR, new Nazgul(NazgulName.JI_INDUR)); nazguls.put(NazgulName.AKHORAHIL, new Nazgul(NazgulName.AKHORAHIL)); nazguls.put(NazgulName.HOARMURATH, new Nazgul(NazgulName.HOARMURATH)); nazguls.put(NazgulName.ADUNAPHEL, new Nazgul(NazgulName.ADUNAPHEL)); nazguls.put(NazgulName.REN, new Nazgul(NazgulName.REN)); nazguls.put(NazgulName.UVATHA, new Nazgul(NazgulName.UVATHA)); } private Nazgul(NazgulName name) { this.name = name; } public static Nazgul getInstance(NazgulName name) { return nazguls.get(name); } public NazgulName getName() { return name; } } java-design-patterns-1.16.0/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java000066400000000000000000000025101312550536300313220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.multiton; /** * * Each Nazgul has different {@link NazgulName}. * */ public enum NazgulName { KHAMUL, MURAZOR, DWAR, JI_INDUR, AKHORAHIL, HOARMURATH, ADUNAPHEL, REN, UVATHA; } java-design-patterns-1.16.0/multiton/src/test/000077500000000000000000000000001312550536300212515ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/test/java/000077500000000000000000000000001312550536300221725ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/test/java/com/000077500000000000000000000000001312550536300227505ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300246005ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/test/java/com/iluwatar/multiton/000077500000000000000000000000001312550536300264535ustar00rootroot00000000000000java-design-patterns-1.16.0/multiton/src/test/java/com/iluwatar/multiton/AppTest.java000066400000000000000000000024751312550536300307060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.multiton; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java000066400000000000000000000034531312550536300314230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.multiton; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertSame; /** * Date: 12/22/15 - 22:28 AM * * @author Jeroen Meulemeester */ public class NazgulTest { /** * Verify if {@link Nazgul#getInstance(NazgulName)} returns the correct Nazgul multiton instance */ @Test public void testGetInstance() { for (final NazgulName name : NazgulName.values()) { final Nazgul nazgul = Nazgul.getInstance(name); assertNotNull(nazgul); assertSame(nazgul, Nazgul.getInstance(name)); assertEquals(name, nazgul.getName()); } } } java-design-patterns-1.16.0/mute-idiom/000077500000000000000000000000001312550536300177015ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/README.md000066400000000000000000000016161312550536300211640ustar00rootroot00000000000000--- layout: pattern title: Mute Idiom folder: mute-idiom permalink: /patterns/mute-idiom/ pumlid: JSf13iCm20NHgxG7iDdtDjH62PKX5luarq-MtSsJvgtUHdR96AyTcEj357pLJR7dDvT4EnpYgEqmqf4NWuD-V7BfidJpCXcGy4N6wmcoX1Jj-lo2ziUQONMcZHi0 categories: Other tags: - Java - Difficulty-Beginner - Idiom --- ## Intent Provide a template to suppress any exceptions that either are declared but cannot occur or should only be logged; while executing some business logic. The template removes the need to write repeated `try-catch` blocks. ![alt text](./etc/mute-idiom.png "Mute Idiom") ## Applicability Use this idiom when * an API declares some exception but can never throw that exception eg. ByteArrayOutputStream bulk write method. * you need to suppress some exception just by logging it, such as closing a resource. ## Credits * [JOOQ: Mute Design Pattern](http://blog.jooq.org/2016/02/18/the-mute-design-pattern/) java-design-patterns-1.16.0/mute-idiom/etc/000077500000000000000000000000001312550536300204545ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/etc/mute-idiom.png000066400000000000000000000441111312550536300232340ustar00rootroot00000000000000PNG  IHDRŤHIDATx \mُ/ff!\BDmB1"ZHB̰f73Œ3ߝ}ϩu9=9y[S1 !b>By^(2Bɋb27EFB(2BTEFz(2S0uԼR{/_-[g'..-Z4)&?" FOdYYvyoiGUX_CtE{Lho_oz$=~|5Yp4G%u^.[AWdii1ݻ4SϞ`>}\*T(7j76-lildsg{%ZbX uƷm׷t=!@[d_|:@)}?#;PIժ?ztb as` tEvВ+I޾t)D8E8oߎb}W'NVV<8& 5 ʎ-oR`Ivff wz(2B~|@mh,L(aaC!m;nOӦ,Y2_Qzo#Jt{0B=7l/NH8LRv;tgΎh]_Ev''[,9 M цQ"= Cm?gP=QBuǟ_V+W׫[* x0{#{kgnL-Qęh]_E:u&Ӽy}x Wdz&6Dy@w?z]n"#Db! "Q=EF(2BTEFz(2S0}튈q)~܅6z."JDCkzPZt hfw EFHQPVCzmy??6z/sÇ'MYjɒ%s̘>Aoqgf y"#D$k H| ;Y0(:N3O϶/k /L*0Hd+"2=!vY_ĬqψϝK]\<뫋HYYZ9sfmӦdVBWtI{zN''G6h`NGdž׮kLUZٲ۶m;$gsv+UdΎrTzCb >&{8X;눕׮o8+r6jTwLHƣ><33BA] ^QK(ΟOl훢/oWe;b+WHJ=nؕtDQ7lgҀ.||\"7\I1;OO_V'!#=32V9--FK'::,B{I~{&xi~C=59,)S];{zCn =6'{H1BdIj+\{v?8-Yhh 0QJÆMʈJ al(ƃ3f "FAI6 ;wtW_F?dmm%<,l'F#EF1Hdqg;vl&Q~(2BԍA"櫻ǏK;NN =cSo-ܰ-P4%^Ańܲe8gӦYgtEtn٭['Vb7Fy +XBr_~CR{d w?!п#_|m䡩ю6Q1dU{kqvvocgeUiɒ QOUX?YɑboE7h`]L)[:-oe/\ عU{@QiQw?![o{b`ʳ؍,/(2BJkl;=6q_&sU/(2BTEFz(2CQd"#DPd!ǔ"KMڼ9RdX8(2BT)E?=::u߽cf~ѱixtŊ#{Tݻ{w6ֹt)"#dcz]MWҥ-;:8|>٣m.|$,fdDB1Pg 1z7j FΝoLڵ֑=*v^bND(ɖ"#dczM_ܶ1cpddݺ>}PRlu6*j̲exj??7EgOT֍G4y֭7ΪR嵇c٣Bb)m{};d٠BbɘRdkL]hCbLdWlsp̌3(2B, EF(2BTEFzC0d "cEFڡ(2BTEFz(2cl/L*(Ɗ!j"Q=EF(2BTEFz(2S"ۿ?Om'۷o[n4^:dvkB"#D(Ddſllj<"D"?DXeh]aX{z6w/D6qggm̘1Xڵwqqh޼]3mZ@-[ڢ'O2W1Ijs@ѣŋGQkkw!)lӦO'"#Ⱥ?pԏ׬̈ARSݝ曔[ tL 5B0+QNX InX-60 DΝKt!cGDXΝʕ)*&}+NuP EDMf:gp3~|%K:uz (vm+S[:SRh[֭[C@_Ak4LtCCΛwrbEFH!7<#p,S{!b (Dϸq>⿅c #Ǚ3"C8:6|yM۷t!JbmѢEFHQ!7X=hkؔI91?Nu\l!ޏ?A4&N_͚|-[;\wרQȑevvo?~| =PύZ11cQSvqhã Ve˖)*&9mW8F蔭ۼyMAU%4kӦ>dS˖ύg a+PO[]~1Bn#nL-QębQvq~;٣3C!E.fEVt+C)EWѳ`Y֍CC4{DUV޽م no= __J#o3e@{zׇ#SvЬ…я>(Qcmmuv Rdf5h`-;YEg<ڮ= 5_Ʒm׷tt腯 \/v۷ =2&TG'6-=%li{Bd.Z4N&$̐-Jrv\[EFdQ0M7]yDQaHoǎ<<ڼJ[beQg[t ֬:hPDgmSz`/XU(mNyPdD2r9 &'O2#a.x̙z{nq4"#&OCԯӧYc˗Ժ};M ">`Mz5qرع QFў=.¡4mΒ%WR.s?>Uniӣ aaaCN8LRv;tgΎh]AvQIQXY[[ݽ.D-s.SF8=Q}腯 \B Yϕ+խ[ǧ^޸[..g9ĄnL-Qęh]A`tYr 1vmRwO>Բ~n8Kl"PdE2r9Ltˆ \"# \"# \"# \"# \"# \3̅Lߵc;tC=f7E m9_)3[bf٬=Ƅ$On7(2cTcPd٘%c`+Pװ=w]vьNա{BLjeuN>y䬲(2R#j)!GLL6D[oQ^M獒bԒrJIwgLg'pEGxz^<:81D{ɓW#qbnXŋ8fLflJ*ٽ{_=d@%唒ϘN~^f$nvQ% :ڛX[[t˗F'_kgGEA{Μz;NVY KBW?N/bnn2'?;qqqhѢAQH9EcdWd'8ݻSd٘^dCDxŽ{}@#{pvv=߸wm֯] gOYKR8kPOM<<%KرNLuhUDvВ+)޾t)D8E8oߎb}W'NVV<Ⱦ!­fͪBF&ݏh4;EY~kYgR^+$]t&~axTٳ8`isd] gUXFL>'m!~'6l<*9iRROhh] g٫yJݻ>vRdC;-Msf뮽$2ݣ ;w~4NecsVwZ>{Uwl ~mYgNSEV(MK̫.^d#Ga#04WdG#b V`v,3ƏVٷ~9 ΰZRdLiiyكԩ.ƛ~x Wdz&6Dy@w?"FyHY0MˢrJIwf%eTK)%ݙ1UR-)tgXRVY LKRҝcIYe10-ՒrJIwf%eTK)%M1Q7O_`ٓ²b(XZ~튈q)~܅6z̞rJIws}Xd_~#$7GsMuYe1 -}MJ=!m,nȲ)@de{xr_~9znz ѽ{KgbqԀv죢L8ɓEG ^1kM|UM>d?žرٷskÇq=}}v#J{c}v:ԳW_Jb04-a!z|c䍟@=vDŊ6zȲ)""FBh} G/_> }|:_*DJgŊ^;DCd}?x-[\-=})KNس'JP~WLz!"ӐQ:q84_1rd/f`PZ^NGR{G7]@ςG(h oHE Jcy!EMD=Eh|>''[d޼w59߽ع3>}\>|~"۶m.ӯ+~T(Pm +&zd8qs;DԻSá.UUAi""czk{8Aw .FKdlJ.)ɑ Xcѱk;D'|WfUt;uj^y `%^rwwhIڷoə뇇̌ٱy};\3Fr^G;{(u( ^{czSJ@dwkx?ҷoGG=z8% v *tqq|(^cQ1`(Љ xQիW`~ǕiȎеKGs"3 Ϥ]%E=$o(5>cȴiZ9â^,_>^worNKYj :o￟,[k " | (ſ*9oUK)%;ADGGfee =6'{H1Bd*2 oaaC@iEK* mcQabe1)'6Q lȰXSlNs;*RN)NnPdAdoLge\!=7=A!%SуJJ\/.=}ik[Pld1H}D%5] n퍋.mG=:QtIOgnQQc49SiLrʕ!Xm:,܎SJSdYՙAiWw{J瘴>XcQlPdESJ1cEy'o;,VbPcFzR;59"l+<%nOJNn[n 'd@%唒eLγ ?W ":駃eʔըQ][:%KMЖ?47&fnEF"SK)%s˘ m 2)'&'ѩΒ%}jkVժ뱧O3[jt2-IPdjI9{n<ʁ""h;vlWիW޻ U I&D&AԨQEf/UYPxs JC\!+G; , mwb;CfwEHKRN)wƌI/|^|Lѣf=,#,L-)tgXRVY LKRҝcIYe10-ՒrJIwf%e`*ǜM1"SLKRҝcIYe10-ՒrJIwC2Fs7=3ņ4r6 L-)t7HdPY҂"+(2Rҽ`"{_EEV(n1+eckSTCÇ!c޺uMmm넄e˜M'OVV+vR嵳g 6']][dfQd(t7Hd;fHժc[cVde;;ioпۂzl'NYaIKt[dbebvmj@T:XxT:84kfphͳ/*a[ NPl7oVX^4+PܨQb^3''۝;#s$֭tرYFj]i}D/jrGb5kkwN8m۶Ɍ6m`-[RdtCdbwQ ,:Vj/܁4vOlda4Y6lvvo_$',lkڻwl.Ja4U%m\pKhL8v-6-s`((S³4Gܱ#Ggv΁rRdtMd!~-_h pa EMWܺWRz$:J6ɢpΜY-2T|b J=Pn"ӝwAhL2p f 3gxh~KG fBmH"R=7gXxDr# A=կUfUmikwӥCAAE&m 2qP!^Ʀƶ9q|6qD#"F-PdtMd!6a8ujHEeʔBzɑ6R0sL؋7ɧ6lSahgh)jkPΝ]\(NY3?\'eQeKSdtMd!6]q5#Gj>7fCԩ}Gdzͭ%7xpwqVn7QٯUC/%&&:;۵iD`∿vG-mQEfdHQF)[f}pl8k[ݹs@WdF"#E {~Qb Iy{`0X|&ȪV}}РnV\"3Ꜵ)R(% Xy`tfa(ɓ(2RQJs 5(2RPJSd!F)NQd;EFR`EFHQJ}_RBL`BCC} @ BߓÊABTEf0Q!JIaEFҠ!"3Vd( `x"#DiPdCL||} ѣ> BPdÊABTEf0Q!J"3Vd( z(2aEFҠ Q"#DiPdC +2BEf0GFҠ !J"#`X4(2=2BEf0Q!DPdÊA 4(2aEFҠ!"39,!CLh> BPdÊABTEf0Q!J"3Vd( z(2aEFҠ Q"#DiPdC +2BEf0GFҠ !J"#`X4(2=2BEf0Q!DPdÊA 4(2~z||ς7!DPdÊAѣG} !J"#`X4(2=2BEf0Q!DPdÊA 4(2aEFҠ!"3Vd( `xA +2BEFQ="#DiPd{d( `X4(2B !J"+Ŋ ,( z(%RE!Pd%4іiwBE_P|曢(!d1BEfR #D9Pd!bŊ#D9Pd! `c(`Pb,Q!ČYN,L0FPdĨPd SEF E0EPdĨPd SEFJYN+U*?~|OVVz@@k[8|Ftӧٟ"#FEWѳ`Y֍CC4{DUV޽م no=jٷ2e}Cs<ǧwY3 G}QX̌kZvhͳLwx];{n͛ߵklo۶o=j _l;oz{"Mbc'cީZGN̟4mZzΝKhVwiqq ]4t7\hO?LH![B.sQoPdĨX~}5 O9:6|yM۷ ԫWz[ uYjjٳ":nOӦ,Y2_QuPdĨXȤ8>Uniӣ aaaCN8LRv;tgΎh]AvQIQXY[[ݽ.D-s.SF8=Q}EFLʕm֭rSWno-ٳ bj7o(RbL G0\]Clh'lj?7n%[{f1*)2҂"#F"c"(2bT(2)"#F"c"(2bT(2)"#F"c",RdƝQ䃿_ Wn8s!wXs=bF¢(EwڳaLHdh~%E0jRiVva{ﺰĵ_uC֙FegƋRV#DNP}OS A1TEWd?r!Yq`j{ˤ1Y/='xy޾ȑLèIUtEoupa?ty# | e}=/m"V"{n~ڍ";zt9W?߂̙Vdk޼>#4.]cC}"YPf3ŋۣ[N\\Zh`,#:Ey-[~k)xX#V" ꍟWli179 oo\ݝr&ooOA fȲҝTV`G7Yv`xF#/Np  .Dx؇֯-_\ttʕ!*b"嗣h%6AEh/_>^}f L&XYZZL Ԟ=P} Gʞ*fڴl޲sO϶NN;wFc$R4cdlv^~Le-y!ܿɺ6ҫ12ghw{k0$ ^}ee7ΒDvj4ƈt^~f@s"~ٯ)"ijk NԩUڵF։vm%VD{|BGD!c~LeǙ u&"`Jrؕ_J{/L_76~k sAI"iԨnzΝ!$>Nqc7nZ3 Yky3&X[db:bMȐÇ#cOR{eIdG 2wi+h91EW펱֩}׍;|NBDOl`xTZS&!АDI^{7n6ӧB!N\ٷ/eʔ'Aif3Cd/nprQ$>qы6LQ00Ĉj4Uw?F";`F;y-*;6?FYnaٌكԩ.ƛN5JP^= UJucc:Gm~w- ?(2Q"c"(2Q"c"(2Q"c"(2Q"c"(2Q"c"(2Q"c">vED8`]cB=f ,/(Djj,e(:"KX!5=(-:у~ (ȾrGHonyMQDD[ c'oTAe4ɷfͪ%K1cܿDlށٳRlsii2dAŊ{p=B gϧ`i"Jh匟r޽; ֣{֗.%%&ԩGE8qӓ' "[=59Ә߯iw*U^&|ahto5nKe8.2׷8Jn!;_=ַoǡC={j"?g]NGR{G7]^?gxH#ļЙg^xյF"C0~ݱ(fgb }^ݾp'a1#cOCPX=+| =>l3w=>q[̹re[zRM,cKNس'JP~iȎ( 8ǏVDdL?{B:bb_ĬqψϝK..g*޷çxO2KǗ_.OG1WI]ng6VÇS4\8msSʗ/WZŹsGhL{X`ıt<A:8-[ZNlfZfCQggRJvZD)1w{jj99 潫Νh=k~"۶m.ӯ+~T(Pm +&zd8Fn" ݩSݑ.~3>7YX+bqd#V^v6߸qo+ §ڱN2 Zn^{I!<HC%XÀHZm uNW"2|ңQFDW/"(lw9~*W4{8ÇKO!突-Md(Tą 1p[l"O^A"Premy{@%q]n34MpMtIM8Q_:NCvDio8쌹w~3y& -u-BXD?Mbe #(e!]цJƧIt U}U2>bsTsPTX\L'6ҽG6㍚\D&&\Nd'lBɩəkJcǏO)S ZIdyOli"{7vG/|"ݿoߎ(PPԽ xG&gQ1.X§zjGQr; 1>{ó:H1dPuЯsa(Z@$èщ=ܒ%Q̓z}5QcU=O3mm+WVAzgBοȦL(~d%1ȕ6{jea( "櫻ǏK;)3?j {hѢ{c<"ELRz'y3[jTB9wѣ5jT2J*ѱ!,Cٿk|I4zgBοFVZ"u/w5+U*}w柿v,eᴴ ˖--&Um.~ ~KwȠ_.SzU`M(Uo-_z;rE[ vٽ{!ŋ7#joQDDq'B| E(2rIU@I`h = =>\ ihhZPDVfU5( 5ȿ`vZ?t9H:y "?DXehhtt*0Уy5, (kNڶmr|"ޮ*5*ipy˖h`ɓ+ m4>_S=ϫMr1v}=ݻJصk>o'e?~| +i U><[ Oۃc+Y3 "49ڂ'.sŭGN/&7|Qx gbO AurbNHxʌ4wQ ,B.jUό߇X G7<|$NX7'0уuO`S̥٨QO?ݤ!,~M "9K؛RBY y0|XEtjg[._hpa}"[vm+u0OIYAfT5cm co*)mw5ztSVGQ"P?."2`t+JW^)s^P-TttPa_n ׻D:eK'̚5tΜ-Y2^My)!,̼aȊvuxVh8ѩ}_h@dxc4'^FLjG[d(+իWǎx'cu6DxWC}7bbQ_ d|A38=A9֯cBd(:٢EztMOdGdžM۷ 2v>/%@7 YރM^'9sgGM @7@CyaQɍvQ_1 bmmun&t4?7xWc73Fo2GP?l2Ǐ,{::ujHEeʔB=SSo+h'{n-?;t8lG1|uboK 9g1ĈZh*zS00yNە#EEv?:)2X1//az@Lx=xpN j5OU~G0\և!]MGiTy}+WժUև+{pn N;#cѣQ}:ի7~ n96Ouks9H'\Ptqf*3Ip7FТ{}^Y![aqAn81kL4hÐ02҈W]@FCf? aԤ_I/ 2G{'%6i java-design-patterns-1.16.0/mute-idiom/etc/mute-idiom.urm.puml000066400000000000000000000010711312550536300242250ustar00rootroot00000000000000@startuml package com.iluwatar.mute { class App { - LOGGER : Logger {static} + App() - acquireResource() : Resource {static} - closeResource(resource : Resource) {static} + main(args : String[]) {static} - useOfLoggedMute() {static} - useOfMute() {static} - utilizeResource(resource : Resource) {static} } interface CheckedRunnable { + run() {abstract} } class Mute { - Mute() + loggedMute(runnable : CheckedRunnable) {static} + mute(runnable : CheckedRunnable) {static} } interface Resource { } } @endumljava-design-patterns-1.16.0/mute-idiom/pom.xml000066400000000000000000000032531312550536300212210ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 mute-idiom junit junit test java-design-patterns-1.16.0/mute-idiom/src/000077500000000000000000000000001312550536300204705ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/main/000077500000000000000000000000001312550536300214145ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/main/java/000077500000000000000000000000001312550536300223355ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/main/java/com/000077500000000000000000000000001312550536300231135ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300247435ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/main/java/com/iluwatar/mute/000077500000000000000000000000001312550536300257155ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/main/java/com/iluwatar/mute/App.java000066400000000000000000000070461312550536300273070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mute; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.ByteArrayOutputStream; import java.io.IOException; import java.sql.SQLException; /** * Mute pattern is utilized when we need to suppress an exception due to an API flaw or in * situation when all we can do to handle the exception is to log it. * This pattern should not be used everywhere. It is very important to logically handle the * exceptions in a system, but some situations like the ones described above require this pattern, * so that we don't need to repeat * 

 * 
 *   try {
 *     // code that may throwing exception we need to ignore or may never be thrown
 *   } catch (Exception ex) {
 *     // ignore by logging or throw error if unexpected exception occurs
 *   }
 * 
 *
every time we need to ignore an exception. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point. * * @param args command line args. * @throws Exception if any exception occurs */ public static void main(String[] args) throws Exception { useOfLoggedMute(); useOfMute(); } /* * Typically used when the API declares some exception but cannot do so. Usually a * signature mistake.In this example out is not supposed to throw exception as it is a * ByteArrayOutputStream. So we utilize mute, which will throw AssertionError if unexpected * exception occurs. */ private static void useOfMute() { ByteArrayOutputStream out = new ByteArrayOutputStream(); Mute.mute(() -> out.write("Hello".getBytes())); } private static void useOfLoggedMute() throws SQLException { Resource resource = null; try { resource = acquireResource(); utilizeResource(resource); } finally { closeResource(resource); } } /* * All we can do while failed close of a resource is to log it. */ private static void closeResource(Resource resource) { Mute.loggedMute(() -> resource.close()); } private static void utilizeResource(Resource resource) throws SQLException { LOGGER.info("Utilizing acquired resource: {}", resource); } private static Resource acquireResource() throws SQLException { return new Resource() { @Override public void close() throws IOException { throw new IOException("Error in closing resource: " + this); } }; } } java-design-patterns-1.16.0/mute-idiom/src/main/java/com/iluwatar/mute/CheckedRunnable.java000066400000000000000000000026761312550536300316100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mute; /** * A runnable which may throw exception on execution. * */ @FunctionalInterface public interface CheckedRunnable { /** * Same as {@link Runnable#run()} with a possibility of exception in execution. * @throws Exception if any exception occurs. */ void run() throws Exception; } java-design-patterns-1.16.0/mute-idiom/src/main/java/com/iluwatar/mute/Mute.java000066400000000000000000000052331312550536300274750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mute; import java.io.ByteArrayOutputStream; import java.io.IOException; /** * A utility class that allows you to utilize mute idiom. */ public final class Mute { // The constructor is never meant to be called. private Mute() {} /** * Executes the runnable and throws the exception occurred within a {@link AssertionError}. * This method should be utilized to mute the operations that are guaranteed not to throw an exception. * For instance {@link ByteArrayOutputStream#write(byte[])} declares in it's signature that it can throw * an {@link IOException}, but in reality it cannot. This is because the bulk write method is not overridden * in {@link ByteArrayOutputStream}. * * @param runnable a runnable that should never throw an exception on execution. */ public static void mute(CheckedRunnable runnable) { try { runnable.run(); } catch (Exception e) { throw new AssertionError(e); } } /** * Executes the runnable and logs the exception occurred on {@link System#err}. * This method should be utilized to mute the operations about which most you can do is log. * For instance while closing a connection to database, or cleaning up a resource, * all you can do is log the exception occurred. * * @param runnable a runnable that may throw an exception on execution. */ public static void loggedMute(CheckedRunnable runnable) { try { runnable.run(); } catch (Exception e) { e.printStackTrace(); } } } java-design-patterns-1.16.0/mute-idiom/src/main/java/com/iluwatar/mute/Resource.java000066400000000000000000000026521312550536300303540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mute; import java.io.Closeable; /** * Represents any resource that the application might acquire and that must be closed * after it is utilized. Example of such resources can be a database connection, open * files, sockets. */ public interface Resource extends Closeable { } java-design-patterns-1.16.0/mute-idiom/src/test/000077500000000000000000000000001312550536300214475ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/test/java/000077500000000000000000000000001312550536300223705ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/test/java/com/000077500000000000000000000000001312550536300231465ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247765ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/test/java/com/iluwatar/mute/000077500000000000000000000000001312550536300257505ustar00rootroot00000000000000java-design-patterns-1.16.0/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java000066400000000000000000000025211312550536300301730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mute; import org.junit.Test; /** * Tests that Mute idiom example runs without errors. * */ public class AppTest { @Test public void test() throws Exception { App.main(null); } } java-design-patterns-1.16.0/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java000066400000000000000000000054761312550536300304010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mute; import static org.junit.Assert.assertTrue; import java.io.ByteArrayOutputStream; import java.io.IOException; import java.io.PrintStream; import org.junit.Rule; import org.junit.Test; import org.junit.rules.ExpectedException; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Test for the mute-idiom pattern */ public class MuteTest { private static final Logger LOGGER = LoggerFactory.getLogger(MuteTest.class); private static final String MESSAGE = "should not occur"; @Rule public ExpectedException exception = ExpectedException.none(); @Test public void muteShouldRunTheCheckedRunnableAndNotThrowAnyExceptionIfCheckedRunnableDoesNotThrowAnyException() { Mute.mute(() -> methodNotThrowingAnyException()); } @Test public void muteShouldRethrowUnexpectedExceptionAsAssertionError() throws Exception { exception.expect(AssertionError.class); exception.expectMessage(MESSAGE); Mute.mute(() -> methodThrowingException()); } @Test public void loggedMuteShouldRunTheCheckedRunnableAndNotThrowAnyExceptionIfCheckedRunnableDoesNotThrowAnyException() { Mute.loggedMute(() -> methodNotThrowingAnyException()); } @Test public void loggedMuteShouldLogExceptionTraceBeforeSwallowingIt() throws IOException { ByteArrayOutputStream stream = new ByteArrayOutputStream(); System.setErr(new PrintStream(stream)); Mute.loggedMute(() -> methodThrowingException()); assertTrue(new String(stream.toByteArray()).contains(MESSAGE)); } private void methodNotThrowingAnyException() { LOGGER.info("Executed successfully"); } private void methodThrowingException() throws Exception { throw new Exception(MESSAGE); } } java-design-patterns-1.16.0/mutex/000077500000000000000000000000001312550536300167725ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/README.md000066400000000000000000000014711312550536300202540ustar00rootroot00000000000000--- layout: pattern title: Mutex folder: mutex permalink: /patterns/mutex/ pumlid: 9SR13OCm30NGLSe0n7UsCS62LB69x6zWV2hrdTxKhFRS9Br_3c34GkHybxtXo3L3l9u6CPHwAhMUDuETldpnl4cqtUR1WBW5ASSlf0bvI53_A-bQHcf_0G00 categories: Concurrency tags: - Java - Difficulty-Intermediate --- ## Also known as Mutual Exclusion Lock Binary Semaphore ## Intent Create a lock which only allows a single thread to access a resource at any one instant. ![alt text](./etc/mutex.png "Mutex") ## Applicability Use a Mutex when * you need to prevent two threads accessing a critical section at the same time * concurrent access to a resource could lead to a race condition ## Credits * [Lock (computer science)] (http://en.wikipedia.org/wiki/Lock_(computer_science)) * [Semaphores] (http://tutorials.jenkov.com/java-concurrency/semaphores.html) java-design-patterns-1.16.0/mutex/etc/000077500000000000000000000000001312550536300175455ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/etc/mutex.png000066400000000000000000000307011312550536300214160ustar00rootroot00000000000000PNG  IHDR0@-Yd1IDATxo}RDTr+T& mJ抶`BmI. ڝjqUvXy .x*0AB;AX>,= )_H$ qOiœiP1Z{EC&R! ,$(t#9 ocqDr$ݬヅ@ȿ_ H:ՠbK͕P"!bX kDZLd Yǭw# l${i2*hPQ[qqb.}9y7D* 6Ȇ3^ HY`|UT Pd/L=$[3K]AȪ$VU Ѯ t%!*1:6"鵋GKV\ѱz{ YdU ^e)C:57B$El =$ Yd{H-wUʨ]G RD2I-|gHVAȪ$jW]e)\1*v#A [F5ۋ]t{gۛ6JɞJ!H`|gZ%|sۋEvgx'wFow1VsUBh[*-QuW}~{lٽ^:&+iAt_eAh+*wI'w,'cw$X٫l5bEٙmǾ_?uW/>AO%{ uP2Al5bE]p慭]xh/g|AbwFʤ> (c|"_ H:ՠbۋ}w[]q_|?'F6n7;SN'HZ W/$Wj4T_.mKbA3R} :-O׽}n!_$.?$9/¼4,_}z{E&}z wNm'FN)T8 ?3n%H-7S`~'0RbpmqgWjj!Mo|۟H,?zltcRɝbA28sd"HGq(&,A*F/Kl[NM۾(ЮXIU|<;Iz{ YdR0/\!6no-o=]):.R8V*XO[*$A*/DHxUZ+3t߆v}y|ċoFكX!4)䢿@t\eAs!HR[%;צ/;ƤdlANx#Y0`oK~ti1ѪDWWPl5zn= h Ǹ@\$JKx{a*{D0ϒޔ1,jB?'E< A "Iڦ@t_eAs# VD;A6;VX$ )Lͺ]_>;HT@8xj[)AC,QzMdLJ V֋2(Rץ=%d]2|J)?$K?t.^ ?HN#ɔx]p>lC@t\ebֳ@qRABI Z3qArR\eb[אC "k\BsR\eQ1[ѭ#"B Vu "+/Hh]eQU D:}d$4CՔ!1 ֙[o/$LC͐*[͈(Xwo\w';b7gH-l\mU X_\\| *E֩ V*[ *F[OhD\=lIUT2RIUTn=APi-2l5cUV}Xvd=S'DMuRHZd$WjP1ƸoV%s:t" 4+ ʤji$WjA[Je'/яFa5:RABS-|pt%lYj2V,Sm}ƭl5P&''b eYP9i$WjP1Z{E]i߿e#ow}AiTX*g t<>Y*=rRBI6vu V[o/#v%_ Q,BD:4ioP>r L e~A}R!{T± (Ab%=$ڏ blU-ѝ"r}Jx g!Hhw*A N"a%)\ue=r 8Ԗ!^BR۝7Q~ Hn!UTn=Bي&A3Rϐ: 8l5IZ( *[ *FmA*DJ'$* m/!-$l5zR]Zdi ?G?~n1 H H@ /3 Z#aD*JB JkU#Ho_2 H">̈́'@BZd$WjLAGtz}_4F3^LVאi͙VI]1=swndkFy\x\T H6Ad# jc-B~iܜi㎿?~plBtʯ09 A;cjz~\BeR  q|T?Բ|Q-=TXrǙ`S HA ab B*_юnδJY㑟}3/_:JyIveĔ_q7:c:*KĒ^L(ȕL|nV Hց3'-Hyڝa<L]R/ՎjWZ;{طKSQ ~vĪLԢ$VUb‘.Q*H͚[o/Yfu r;Z EV(hG,5gZ{Og9X`%ɗR~U)HI)ړl "+&HyڝDT " NV~򉛏൹g<;G6n>O$U0]!t. Pf+v>A~Ve]zL.E4WY{^*f!gP1˘(:dִ5[MyEEmiDЖ +Ƃ:u¾sT~ ϐ搕˹YδJ#hSWFƫɔ]FaYOcAZǙ+ak[hX~XR;ّ w^yj OdQj̣%WN!{U|یz{Ҷ$Va8?ukcmi3^Pi-2S-sUBh2V_}aCx8L5k1A ь4bk=I9*bۋҪ])<VSf#$FAA\UFPT0YfQBDk(9N'4]DC1=MMuR\➬\ZT9*bKV͙*+sU:W*AnX5tw;@£ 9ih__S .sUO"rŚimSQ+[ClXPHb#L^5dˤ]iALOogx NU}s׮]k,tw52LV6,2<ɱ$)HM$ϱ|-}R>`(YT$ߕbXrDbV9d'//R! kk$[lvM0,A;Qb)!'NzZY܂$TZrk$ ׮][jիWߕOBfRXkL\,ĉ{D6fff<Q 5VZæSje X̦Mڵk>`"R; l%cu7p˗=%` $ l;v`/4w:P H dg/\zN " +ڵk9`,$ d~~~׮]A<;c|Ri 6!pRïz9 K֬Y#}9sF΄ Hv5??/}MIHhD ;ЫVj 1!$$`+++ ZB="uOL!H>> tvQ,)!H>Μ9< `ݣ!$;I$0=RA:I YP;k׮e~1A"{\sAt:7=> A`$Ll`AD1d G6U6 H@rOnoPyU  !EE"%HD#lI"_D>A. *HAh k L$Xz4ΐ]crr7}!.zHL R8;5cIj,@$|7 ϟ P$hgGEA{,//b&h ,@0իWc>`-cU `"6mB6 H & E!pk׮MNN6} H!-//7}q\reM `+++[li,  @0W"7h!$#AG333M 0Ʊr@0@03g7} HǕ@0=M `M 0ƁgH@0|ϐ@ 0q啕@0i فA8s̙@ tիW> tA8&''~gn Hǎ;H'@7$FA8]YƱzj$W-Κ52ȕivс ;0:hCs?e A!ʹ2@ HPA H$`mr $06T9CP*iם lu{KdOx}hmr  Rә5 *Ơp*3ZNJR{ ]!ݝ쀉>,= )_H$-)=vu8PpAo"an='-q,HS}|jC`1 ᢅ z)AIDlbH@#/^;= Hc cR<"X$B$6axNV0d7Ly$TRR{C<1 Qd ;@'IL6D>./YfPS&3$4A>J(#H Q᥅l2;ɰoS,Ɓ0{C`U ju8Pߌzd؄ZNT@!0ju8PArOxT@IQ1^GS$=~Lju8PA*zZNTT+H]GnfOiádi\ZLC`v'<p*BAwC;^xx]A7.!04p**%󙽷Νʻ/a/"-?[i?z˦?^E3C`NTT]&}oyS?ͩYOcwLX*-H Ը#J\ggc{_^̟};¡ {we(HAPy JJ^bIi=c? @w8PQ?u.~K}ř/G2AH<煲WT"_!HG\P#J\ w;ik9٧;L}7/L?\P=r Rě`,?&AP#lݝ}Svd/9 .ٝ|ϐNUx$[N~tavi.pUAF9 E^=t?c_yO}%۟?Hޥ%q qӒ$`5*h$TŽ#ANA! H H) Hz@ЊRƄp ?&Pw]$x$S$ yJt_$$X"97ϐavA C`uvw&<p* _]P# ?&0c 4  t8 C`ڎ ZNT@!0r=LxT@u}d+) I*HMx -jj{*zj{*zj{*zj{*zj{*zj{*z&9AT@E:A'ӹBɞ,#%;$簯`: E}5{L|#ZߓgR e }][6&mͣ уT%>AgӦߛJunBU =o"̻%ʌ(7egIT$pOjr~m~L4A>F ҿKA,xD]Q}.kKggxdFKe2ɏ# D#G$?NOj F浡 }$VR$)'B(~7-©KPf,haȉ ;2G8D H )J~ymh H@9{H+P`u0dA9qR$d qyUh H@!8qC# R|Qhe5tO20Ɛ]0^׼*4h$yA x/qd I29>A mR\39 #~Um$WU&!0ISM9` H@. RK3Y?&z ޕMZXhh|,,Is==$!’ISލ; pQLC`e&9ax=l d'ajdP3AL 䐚0~OjCޠ{a׊D.>[e:3ZNT@!0j'90I` A*DsNS =: C`e&9=描I~ |{J_&r@!02]:;zGDܲidP )MrXPE$#  X@k\a?&xmaNIx9 pEC`; C`; (O/m?ov~b 5p*"NPhOC`NT$ͻE~LԸ# ?&IcP8P)1d㧝iiaޤ˺l0^t _a59 Pgm7`l ?WSpX ̬M ѭC`NT(\?~pl̐-ӝXV._fܲ.T q:~Wwe 5p*"E:1Ԏd'_ {3@&H|I\&S[!0"ԮINTd{c#'/N K1ul$0N6F' ybZ }d=u?yc=Jd'_&@bY%Hb` EQA>ڼ04e$,~򉛏൹g<;G6n> HYAr2Rj!f!Rs8A@ 2%#O [!Y- HYAr3&9=l Pr¾@  p3vihv%+ H@yArNTyg^FV"m? Pۭ3Gd*:F- H4A> &SI"ijno8E*I*N)k(B\O:0 @0Gd*℉Do~AX|8B!H\"!ʨ9..#T Hc d2dD2 1CAH2z>Etetay7wi }I"$#RWr,#IIBZ i }H"IFٱ%!~z mIs&]A0d Hc L214ch/ZOV"H2,nnA;Q& }L"fA.b I'*Xp*Bor{Y{MKX?M}*0 @eC.H\OTT@I(3A'H`# ?&PrZD+NT@!0$ݗ0u/* Hz@I ɘ(}* HzI'*Xp* z'*Xp* 7p*>W!V a$T-HX14A>*J5|:T!@5:dΕSX14A>*Jkگp(ƾ+Ƃ@0GET5^wC+Ƃ:Ov@AEN5T$ ;A߰b,.*h25^%  ,AM;AXg8j PҰd*e +`=p*B-HfVrT@M HT A A A A @2,͘B @(LVIENDB`java-design-patterns-1.16.0/mutex/etc/mutex.urm.puml000066400000000000000000000007151312550536300224130ustar00rootroot00000000000000@startuml package com.iluwatar.mutex { class App { + App() + main(args : String[]) {static} } class Jar { - beans : int - lock : Lock + Jar(beans : int, lock : Lock) + takeBean() : boolean } interface Lock { + acquire() {abstract} + release() {abstract} } class Mutex { - owner : Object + Mutex() + acquire() + getOwner() : Object + release() } } Jar --> "-lock" Lock Mutex ..|> Lock @endumljava-design-patterns-1.16.0/mutex/pom.xml000066400000000000000000000033541312550536300203140ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 mutex junit junit test java-design-patterns-1.16.0/mutex/src/000077500000000000000000000000001312550536300175615ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/main/000077500000000000000000000000001312550536300205055ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/main/java/000077500000000000000000000000001312550536300214265ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/main/java/com/000077500000000000000000000000001312550536300222045ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300240345ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/mutex/000077500000000000000000000000001312550536300251765ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/mutex/App.java000066400000000000000000000037761312550536300265760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; /** * A Mutex prevents multiple threads from accessing a resource simultaneously. *

* In this example we have two thieves who are taking beans from a jar. * Only one thief can take a bean at a time. This is ensured by a Mutex lock * which must be acquired in order to access the jar. Each thief attempts to * acquire the lock, take a bean and then release the lock. If the lock has * already been acquired, the thief will be prevented from continuing (blocked) * until the lock has been released. The thieves stop taking beans once there * are no beans left to take. */ public class App { /** * main method */ public static void main(String[] args) { Mutex mutex = new Mutex(); Jar jar = new Jar(1000, mutex); Thief peter = new Thief("Peter", jar); Thief john = new Thief("John", jar); peter.start(); john.start(); } } java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/mutex/Jar.java000066400000000000000000000037331312550536300265630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; /** * A Jar has a resource of beans which can only be accessed by a single Thief * (thread) at any one time. A Mutex lock is used to prevent more than one Thief * taking a bean simultaneously. */ public class Jar { /** * The lock which must be acquired to access the beans resource. */ private final Lock lock; /** * The resource within the jar. */ private int beans; public Jar(int beans, Lock lock) { this.beans = beans; this.lock = lock; } /** * Method for a thief to take a bean. */ public boolean takeBean() { boolean success = false; try { lock.acquire(); success = beans > 0; if (success) { beans = beans - 1; } } catch (Exception e) { e.printStackTrace(); } finally { lock.release(); } return success; } } java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/mutex/Lock.java000066400000000000000000000025021312550536300267300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; /** * Lock is an interface for a lock which can be acquired and released. */ public interface Lock { void acquire() throws InterruptedException; void release(); } java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/mutex/Mutex.java000066400000000000000000000037771312550536300271610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; /** * Mutex is an implementation of a mutual exclusion lock. */ public class Mutex implements Lock { /** * The current owner of the lock. */ private Object owner; /** * Returns the current owner of the Mutex, or null if available */ public Object getOwner() { return owner; } /** * Method called by a thread to acquire the lock. If the lock has already * been acquired this will wait until the lock has been released to * re-attempt the acquire. */ @Override public synchronized void acquire() throws InterruptedException { while (owner != null) { wait(); } owner = Thread.currentThread(); } /** * Method called by a thread to release the lock. */ @Override public synchronized void release() { if (Thread.currentThread() == owner) { owner = null; notify(); } } } java-design-patterns-1.16.0/mutex/src/main/java/com/iluwatar/mutex/Thief.java000066400000000000000000000037351312550536300271100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Thief is a class which continually tries to acquire a jar and take a bean * from it. When the jar is empty the thief stops. */ public class Thief extends Thread { private static final Logger LOGGER = LoggerFactory.getLogger(Thief.class); /** * The name of the thief. */ private final String name; /** * The jar */ private final Jar jar; public Thief(String name, Jar jar) { this.name = name; this.jar = jar; } /** * In the run method the thief repeatedly tries to take a bean until none * are left. */ @Override public void run() { int beans = 0; while (jar.takeBean()) { beans = beans + 1; LOGGER.info("{} took a bean.", name); } LOGGER.info("{} took {} beans.", name, beans); } } java-design-patterns-1.16.0/mutex/src/test/000077500000000000000000000000001312550536300205405ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/test/java/000077500000000000000000000000001312550536300214615ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/test/java/com/000077500000000000000000000000001312550536300222375ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300240675ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/test/java/com/iluwatar/mutex/000077500000000000000000000000001312550536300252315ustar00rootroot00000000000000java-design-patterns-1.16.0/mutex/src/test/java/com/iluwatar/mutex/AppTest.java000066400000000000000000000025531312550536300274610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; import org.junit.Test; import java.io.IOException; /** * Application Test Entrypoint */ public class AppTest{ @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/mutex/src/test/java/com/iluwatar/mutex/JarTest.java000066400000000000000000000027641312550536300274610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; import org.junit.Test; import static org.junit.Assert.*; /** * Test case for taking beans from a Jar */ public class JarTest { @Test public void testTakeBeans() { Mutex mutex = new Mutex(); Jar jar = new Jar(10, mutex); for (int i = 0; i < 10; i++) { assertTrue(jar.takeBean()); } assertFalse(jar.takeBean()); } }java-design-patterns-1.16.0/mutex/src/test/java/com/iluwatar/mutex/MutexTest.java000066400000000000000000000031641312550536300300420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.mutex; import org.junit.Test; import static org.junit.Assert.*; /** * Test case for acquiring and releasing a Mutex */ public class MutexTest { @Test public void acquireReleaseTest() { Mutex mutex = new Mutex(); assertNull(mutex.getOwner()); try { mutex.acquire(); assertEquals(mutex.getOwner(), Thread.currentThread()); } catch (InterruptedException e) { fail(e.toString()); } mutex.release(); assertNull(mutex.getOwner()); } }java-design-patterns-1.16.0/naked-objects/000077500000000000000000000000001312550536300203415ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/.gitattributes000066400000000000000000000013741312550536300232410ustar00rootroot00000000000000# # # text files are normalized (convert crlf => lf) # binary files are not normalized (binary is a macro for -text -diff) # # # Unless otherwise stated, assume text * text=auto *.java text diff=java *.html text diff=html *.xhtml text diff=html *.xml text *.txt text *.jar binary *.so binary *.dll binary # images *.jpg binary *.jpeg binary *.png binary *.pdn binary *.pdn binary *.cs text diff=csharp *.sln merge=union *.csproj merge=union *.vbproj merge=union *.fsproj merge=union *.dbproj merge=union *.doc diff=astextplain *.DOC diff=astextplain *.docx diff=astextplain *.DOCX diff=astextplain *.dot diff=astextplain *.DOT diff=astextplain *.pdf diff=astextplain *.PDF diff=astextplain *.rtf diff=astextplain *.RTF diff=astextplain java-design-patterns-1.16.0/naked-objects/.gitignore000066400000000000000000000006101312550536300223260ustar00rootroot00000000000000*~ *.swp *.class bin/ target/ target-ide/ logs/ .settings/ .project .classpath .idea *.iml JArchitectOut/ *.jdproj neo4j_DB/ # log files datanucleus.log isis.log i18n-po.log hs_err_pid*.log # Package Files # *.jar *.war *.ear dependency-reduced-pom.xml pom.xml.tag pom.xml.next pom.xml.releaseBackup pom.xml.versionsBackup .clover/ *.jdproj JArchitectOut/ rebel.xml /translations.pot java-design-patterns-1.16.0/naked-objects/README000066400000000000000000000002751312550536300212250ustar00rootroot00000000000000This is an Apache Isis application created with the SimpleApp archetype. The usage instructions can be found at http://isis.apache.org/guides/ug.html#_ug_getting-started_simpleapp-archetypejava-design-patterns-1.16.0/naked-objects/README.md000066400000000000000000000014761312550536300216300ustar00rootroot00000000000000--- layout: pattern title: Naked Objects folder: naked-objects permalink: /patterns/naked-objects/ categories: Architectural tags: - Java - Difficulty-Expert --- ## Intent The Naked Objects architectural pattern is well suited for rapid prototyping. Using the pattern, you only need to write the domain objects, everything else is autogenerated by the framework. ![alt text](./etc/naked-objects.png "Naked Objects") ## Applicability Use the Naked Objects pattern when * you are prototyping and need fast development cycle * an autogenerated user interface is good enough * you want to automatically publish the domain as REST services ## Real world examples * [Apache Isis](https://isis.apache.org/) ## Credits * [Richard Pawson - Naked Objects](https://isis.apache.org/resources/thesis/Pawson-Naked-Objects-thesis.pdf) java-design-patterns-1.16.0/naked-objects/dom/000077500000000000000000000000001312550536300211205ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/pom.xml000066400000000000000000000130201312550536300224310ustar00rootroot00000000000000 4.0.0 com.iluwatar naked-objects 1.16.0 naked-objects-dom src/main/resources src/main/java ** **/*.java org.apache.isis.core isis-core-applib org.apache.isis.core isis-core-unittestsupport test org.objenesis objenesis test org.assertj assertj-core test enhance true 4.0.1 org.eclipse.m2e lifecycle-mapping 1.0.0 org.datanucleus datanucleus-maven-plugin [${datanucleus-maven-plugin.version},) enhance org.datanucleus datanucleus-maven-plugin ${datanucleus-maven-plugin.version} false ${basedir}/log4j.properties true ${basedir}/datanucleus.properties process-classes enhance org.datanucleus datanucleus-core org.datanucleus datanucleus-jodatime org.datanucleus datanucleus-api-jdo isis-validate org.apache.isis.tool isis-maven-plugin 1.9.0-SNAPSHOT ../webapp/src/main/webapp/WEB-INF org.apache.isis.example.application simpleapp-dom 1.9.0-SNAPSHOT com.google.guava guava 16.0.1 test validate java-design-patterns-1.16.0/naked-objects/dom/src/000077500000000000000000000000001312550536300217075ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/000077500000000000000000000000001312550536300226335ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/000077500000000000000000000000001312550536300235545ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/META-INF/000077500000000000000000000000001312550536300247145ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/META-INF/persistence.xml000066400000000000000000000022351312550536300277640ustar00rootroot00000000000000 java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/000077500000000000000000000000001312550536300255245ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/000077500000000000000000000000001312550536300263035ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/app/000077500000000000000000000000001312550536300270635ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/000077500000000000000000000000001312550536300306505ustar00rootroot00000000000000HomePageService.java000066400000000000000000000031651312550536300344470ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.dom.app.homepage; import org.apache.isis.applib.DomainObjectContainer; import org.apache.isis.applib.annotation.Action; import org.apache.isis.applib.annotation.DomainService; import org.apache.isis.applib.annotation.HomePage; import org.apache.isis.applib.annotation.NatureOfService; import org.apache.isis.applib.annotation.SemanticsOf; /** * HomePage Domain Service * @see HomePageViewModel linked view to HomePage */ @DomainService(nature = NatureOfService.VIEW_CONTRIBUTIONS_ONLY) public class HomePageService { // endregion // region > injected services @javax.inject.Inject DomainObjectContainer container; // endregion // region > homePage (action) @Action(semantics = SemanticsOf.SAFE) @HomePage public HomePageViewModel homePage() { return container.injectServicesInto(new HomePageViewModel()); } } HomePageViewModel.java000066400000000000000000000030701312550536300347350ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.dom.app.homepage; import java.util.List; import org.apache.isis.applib.annotation.ViewModel; import domainapp.dom.modules.simple.SimpleObject; import domainapp.dom.modules.simple.SimpleObjects; /** * Model linked to the HomePage * The underlying layout is specified by json * @see HomePageService - Service Linked to the HomePage */ @ViewModel public class HomePageViewModel { // endregion // region > injected services @javax.inject.Inject SimpleObjects simpleObjects; // endregion // region > title public String title() { return getObjects().size() + " objects"; } // endregion // region > object (collection) @org.apache.isis.applib.annotation.HomePage public List getObjects() { return simpleObjects.listAll(); } } HomePageViewModel.layout.json000066400000000000000000000024561312550536300363100ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/** * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ { "columns": [ { "span": 0, "memberGroups": {} }, { "span": 0, "memberGroups": {} }, { "span": 0, "memberGroups": {} }, { "span": 12, "collections": { "objects": { "collectionLayout": { "render": "EAGERLY" } } } } ], "actions": {} }HomePageViewModel.png000066400000000000000000000007101312550536300345760ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/app/homepagePNG  IHDR szzIDATXGQ0D_*JH@BYF($m+c+kʚc6B>L#w >@_Pi\$ n1z)M񷠾q*@J\XC  ĵ5RN|]] ZT5lA]+p @thU{A@mq7wA@ablnz]ʵ\ -`*+(Z]OxM΁7,uAyJ <18l+LI۠Jh;=%-؁ ƁP%tX$uԸżv~Ӿ0Xl%DuCN(jHX*Trٰ;_A(IENDB`java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/modules/000077500000000000000000000000001312550536300277535ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/000077500000000000000000000000001312550536300312445ustar00rootroot00000000000000SimpleObject.java000066400000000000000000000106051312550536300344120ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.dom.modules.simple; import javax.jdo.JDOHelper; import javax.jdo.annotations.IdentityType; import javax.jdo.annotations.VersionStrategy; import org.apache.isis.applib.DomainObjectContainer; import org.apache.isis.applib.Identifier; import org.apache.isis.applib.annotation.Action; import org.apache.isis.applib.annotation.BookmarkPolicy; import org.apache.isis.applib.annotation.DomainObject; import org.apache.isis.applib.annotation.DomainObjectLayout; import org.apache.isis.applib.annotation.Editing; import org.apache.isis.applib.annotation.Parameter; import org.apache.isis.applib.annotation.ParameterLayout; import org.apache.isis.applib.annotation.Property; import org.apache.isis.applib.annotation.Title; import org.apache.isis.applib.services.eventbus.ActionDomainEvent; import org.apache.isis.applib.services.i18n.TranslatableString; import org.apache.isis.applib.util.ObjectContracts; /** * Definition of a Simple Object */ @javax.jdo.annotations.PersistenceCapable(identityType = IdentityType.DATASTORE, schema = "simple", table = "SimpleObject") @javax.jdo.annotations.DatastoreIdentity( strategy = javax.jdo.annotations.IdGeneratorStrategy.IDENTITY, column = "id") @javax.jdo.annotations.Version(strategy = VersionStrategy.VERSION_NUMBER, column = "version") @javax.jdo.annotations.Queries({ @javax.jdo.annotations.Query(name = "find", language = "JDOQL", value = "SELECT " + "FROM domainapp.dom.modules.simple.SimpleObject "), @javax.jdo.annotations.Query(name = "findByName", language = "JDOQL", value = "SELECT " + "FROM domainapp.dom.modules.simple.SimpleObject " + "WHERE name.indexOf(:name) >= 0 ")}) @javax.jdo.annotations.Unique(name = "SimpleObject_name_UNQ", members = {"name"}) @DomainObject @DomainObjectLayout(bookmarking = BookmarkPolicy.AS_ROOT, cssClassFa = "fa-flag") public class SimpleObject implements Comparable { // endregion // region > name (property) private String name; // region > identificatiom public TranslatableString title() { return TranslatableString.tr("Object: {name}", "name", getName()); } @javax.jdo.annotations.Column(allowsNull = "false", length = 40) @Title(sequence = "1") @Property(editing = Editing.DISABLED) public String getName() { return name; } public void setName(final String name) { this.name = name; } // endregion // region > updateName (action) /** * Event used to update the Name in the Domain */ public static class UpdateNameDomainEvent extends ActionDomainEvent { public UpdateNameDomainEvent(final SimpleObject source, final Identifier identifier, final Object... arguments) { super(source, identifier, arguments); } } @Action(domainEvent = UpdateNameDomainEvent.class) public SimpleObject updateName( @Parameter(maxLength = 40) @ParameterLayout(named = "New name") final String name) { setName(name); return this; } public String default0UpdateName() { return getName(); } public TranslatableString validateUpdateName(final String name) { return name.contains("!") ? TranslatableString.tr("Exclamation mark is not allowed") : null; } // endregion // region > version (derived property) public Long getVersionSequence() { return (Long) JDOHelper.getVersion(this); } // endregion // region > compareTo @Override public int compareTo(final SimpleObject other) { return ObjectContracts.compare(this, other, "name"); } // endregion // region > injected services @javax.inject.Inject @SuppressWarnings("unused") private DomainObjectContainer container; // endregion } SimpleObject.layout.json000066400000000000000000000034561312550536300357640ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/** * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ { "columns": [ { "span": 6, "memberGroups": { "General": { "members": { "name": { "actions": { "updateName": { "actionLayout": { "position": "BOTTOM" } } } }, "versionSequence": { "propertyLayout": { "name": "version" } } } } } }, { "span": 0, "memberGroups": {} }, { "span": 0, "memberGroups": {} }, { "span": 6, "collections": {} } ], "actions": {} }SimpleObject.png000066400000000000000000000012151312550536300342520ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/modules/simplePNG  IHDR szzTIDATXGŗ1A"@\ D"@ D[ٙٝR~g?37H-]g uS C53$-JGo!,OE4!?QGZ/)𫈄Th%FxJ C ̋HH>D+"ܻ H-z¥zH> rFcћW![>C^L7LDJ|{.s 9"!ɹ1_Ŕ$BR͔))hi RHdN %Ae۴A:wm\B""bR1,")Js!!u;)RC@Gu$,x}LS*LlvT(fkϖ&cǗ>ȍ0;|b)@0uRDWf{, .<64Nu?#8 逾"]G)Nytm)#b&`c!@ڮ *Ba>y߈ "ǃr)9&GExD-LC2c7_5Sw-3|IwpX6~QlbYIENDB`SimpleObjects.java000066400000000000000000000064311312550536300345770ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.dom.modules.simple; import java.util.List; import org.apache.isis.applib.DomainObjectContainer; import org.apache.isis.applib.Identifier; import org.apache.isis.applib.annotation.Action; import org.apache.isis.applib.annotation.ActionLayout; import org.apache.isis.applib.annotation.BookmarkPolicy; import org.apache.isis.applib.annotation.DomainService; import org.apache.isis.applib.annotation.DomainServiceLayout; import org.apache.isis.applib.annotation.MemberOrder; import org.apache.isis.applib.annotation.ParameterLayout; import org.apache.isis.applib.annotation.SemanticsOf; import org.apache.isis.applib.query.QueryDefault; import org.apache.isis.applib.services.eventbus.ActionDomainEvent; import org.apache.isis.applib.services.i18n.TranslatableString; /** * Domain Service for Simple Objects */ @DomainService(repositoryFor = SimpleObject.class) @DomainServiceLayout(menuOrder = "10") public class SimpleObjects { // endregion // region > injected services @javax.inject.Inject DomainObjectContainer container; // endregion // region > title public TranslatableString title() { return TranslatableString.tr("Simple Objects"); } // endregion // region > listAll (action) @Action(semantics = SemanticsOf.SAFE) @ActionLayout(bookmarking = BookmarkPolicy.AS_ROOT) @MemberOrder(sequence = "1") public List listAll() { return container.allInstances(SimpleObject.class); } // endregion // region > findByName (action) @Action(semantics = SemanticsOf.SAFE) @ActionLayout(bookmarking = BookmarkPolicy.AS_ROOT) @MemberOrder(sequence = "2") public List findByName(@ParameterLayout(named = "Name") final String name) { return container.allMatches(new QueryDefault<>(SimpleObject.class, "findByName", "name", name)); } // endregion /** * Create Domain Event on SimpleObjects */ // region > create (action) public static class CreateDomainEvent extends ActionDomainEvent { public CreateDomainEvent(final SimpleObjects source, final Identifier identifier, final Object... arguments) { super(source, identifier, arguments); } } /** * Create simple object */ @Action(domainEvent = CreateDomainEvent.class) @MemberOrder(sequence = "3") public SimpleObject create(@ParameterLayout(named = "Name") final String name) { final SimpleObject obj = container.newTransientInstance(SimpleObject.class); obj.setName(name); container.persistIfNotAlready(obj); return obj; } } java-design-patterns-1.16.0/naked-objects/dom/src/test/000077500000000000000000000000001312550536300226665ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/000077500000000000000000000000001312550536300236075ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/domainapp/000077500000000000000000000000001312550536300255575ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/domainapp/dom/000077500000000000000000000000001312550536300263365ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/domainapp/dom/modules/000077500000000000000000000000001312550536300300065ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/000077500000000000000000000000001312550536300312775ustar00rootroot00000000000000SimpleObjectTest.java000066400000000000000000000027621312550536300353120ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/** * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.dom.modules.simple; import static org.assertj.core.api.Assertions.assertThat; import org.junit.Before; import org.junit.Test; /** * Test for SimpleObject */ public class SimpleObjectTest { SimpleObject simpleObject; @Before public void setUp() throws Exception { simpleObject = new SimpleObject(); } /** * Test for Names for SimpleObjects */ public static class Name extends SimpleObjectTest { @Test public void happyCase() throws Exception { // given String name = "Foobar"; assertThat(simpleObject.getName()).isNull(); // when simpleObject.setName(name); // then assertThat(simpleObject.getName()).isEqualTo(name); } } } SimpleObjectsTest.java000066400000000000000000000060031312550536300354650ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/** * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.dom.modules.simple; import static org.assertj.core.api.Assertions.assertThat; import com.google.common.collect.Lists; import java.util.List; import org.apache.isis.applib.DomainObjectContainer; import org.apache.isis.core.unittestsupport.jmocking.JUnitRuleMockery2; import org.apache.isis.core.unittestsupport.jmocking.JUnitRuleMockery2.Mode; import org.jmock.Expectations; import org.jmock.Sequence; import org.jmock.auto.Mock; import org.junit.Before; import org.junit.Rule; import org.junit.Test; /** * Test for SimpleObjects */ public class SimpleObjectsTest { @Rule public JUnitRuleMockery2 context = JUnitRuleMockery2.createFor(Mode.INTERFACES_AND_CLASSES); @Mock DomainObjectContainer mockContainer; SimpleObjects simpleObjects; @Before public void setUp() throws Exception { simpleObjects = new SimpleObjects(); simpleObjects.container = mockContainer; } /** * Test Creation of Simple Objects */ public static class Create extends SimpleObjectsTest { @Test public void happyCase() throws Exception { // given final SimpleObject simpleObject = new SimpleObject(); final Sequence seq = context.sequence("create"); context.checking(new Expectations() { { oneOf(mockContainer).newTransientInstance(SimpleObject.class); inSequence(seq); will(returnValue(simpleObject)); oneOf(mockContainer).persistIfNotAlready(simpleObject); inSequence(seq); } }); // when final SimpleObject obj = simpleObjects.create("Foobar"); // then assertThat(obj).isEqualTo(simpleObject); assertThat(obj.getName()).isEqualTo("Foobar"); } } /** * Test Listing of Simple Objects */ public static class ListAll extends SimpleObjectsTest { @Test public void happyCase() throws Exception { // given final List all = Lists.newArrayList(); context.checking(new Expectations() { { oneOf(mockContainer).allInstances(SimpleObject.class); will(returnValue(all)); } }); // when final List list = simpleObjects.listAll(); // then assertThat(list).isEqualTo(all); } } } java-design-patterns-1.16.0/naked-objects/etc/000077500000000000000000000000001312550536300211145ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/etc/naked-objects-dom.urm.puml000066400000000000000000000021341312550536300261030ustar00rootroot00000000000000@startuml package domainapp.dom.app.homepage { class HomePageService { ~ container : DomainObjectContainer + HomePageService() + homePage() : HomePageViewModel } class HomePageViewModel { ~ simpleObjects : SimpleObjects + HomePageViewModel() + getObjects() : List + title() : String } } package domainapp.dom.modules.simple { class SimpleObject { - container : DomainObjectContainer - name : String + SimpleObject() + compareTo(other : SimpleObject) : int + default0UpdateName() : String + getName() : String + getVersionSequence() : Long + setName(name : String) + title() : TranslatableString + updateName(name : String) : SimpleObject + validateUpdateName(name : String) : TranslatableString } class SimpleObjects { ~ container : DomainObjectContainer + SimpleObjects() + create(name : String) : SimpleObject + findByName(name : String) : List + listAll() : List + title() : TranslatableString } } HomePageViewModel --> "-simpleObjects" SimpleObjects @endumljava-design-patterns-1.16.0/naked-objects/etc/naked-objects-fixture.urm.puml000066400000000000000000000063331312550536300270170ustar00rootroot00000000000000@startuml package domainapp.dom.app.homepage { class HomePageService { ~ container : DomainObjectContainer + HomePageService() + homePage() : HomePageViewModel } class HomePageViewModel { ~ simpleObjects : SimpleObjects + HomePageViewModel() + getObjects() : List + title() : String } } package domainapp.dom.modules.simple { class SimpleObject { - container : DomainObjectContainer - dnFieldFlags : byte[] {static} - dnFieldNames : String[] {static} - dnFieldTypes : Class[] {static} # dnFlags : byte - dnInheritedFieldCount : int {static} - dnPersistableSuperclass : Class {static} # dnStateManager : StateManager - name : String + SimpleObject() + ___dn$loadClass(className : String) : Class {static} - __dnFieldFlagsInit() : byte[] {static} - __dnFieldNamesInit() : String[] {static} - __dnFieldTypesInit() : Class[] {static} # __dnGetInheritedFieldCount() : int {static} - __dnPersistableSuperclassInit() : Class {static} + compareTo(other : SimpleObject) : int + default0UpdateName() : String # dnCopyField(obj : SimpleObject, index : int) + dnCopyFields(obj : Object, indices : int[]) + dnCopyKeyFieldsFromObjectId(fc : ObjectIdFieldConsumer, oid : Object) # dnCopyKeyFieldsFromObjectId(oid : Object) + dnCopyKeyFieldsToObjectId(fs : ObjectIdFieldSupplier, oid : Object) + dnCopyKeyFieldsToObjectId(oid : Object) + dnGetExecutionContext() : ExecutionContextReference # dnGetManagedFieldCount() : int {static} + dnGetObjectId() : Object + dnGetTransactionalObjectId() : Object + dnGetVersion() : Object + dnGetname() : String + dnIsDeleted() : boolean + dnIsDetached() : boolean + dnIsDirty() : boolean + dnIsNew() : boolean + dnIsPersistent() : boolean + dnIsTransactional() : boolean + dnMakeDirty(fieldName : String) + dnNewInstance(sm : StateManager) : Persistable + dnNewInstance(sm : StateManager, obj : Object) : Persistable + dnNewObjectIdInstance() : Object + dnNewObjectIdInstance(key : Object) : Object # dnPreSerialize() + dnProvideField(index : int) + dnProvideFields(indices : int[]) + dnReplaceField(index : int) + dnReplaceFields(indices : int[]) + dnReplaceFlags() + dnReplaceStateManager(sm : StateManager) + dnSetname(name : String) - dnSuperClone() : Object + getName() : String + getVersionSequence() : Long + setName(val : String) + title() : TranslatableString + updateName(name : String) : SimpleObject + validateUpdateName(name : String) : TranslatableString } class SimpleObjects { ~ container : DomainObjectContainer + SimpleObjects() + create(name : String) : SimpleObject + findByName(name : String) : List + listAll() : List + title() : TranslatableString } } package domainapp.fixture { class DomainAppFixturesProvider { + DomainAppFixturesProvider() + getSpecification() : FixtureScriptsSpecification } } Builder ..+ FixtureScriptsSpecification DropDownPolicy ..+ FixtureScriptsSpecification MultipleExecutionStrategy ..+ FixtureScripts HomePageViewModel --> "-simpleObjects" SimpleObjects @endumljava-design-patterns-1.16.0/naked-objects/etc/naked-objects-integtests.urm.puml000066400000000000000000000063331312550536300275220ustar00rootroot00000000000000@startuml package domainapp.dom.app.homepage { class HomePageService { ~ container : DomainObjectContainer + HomePageService() + homePage() : HomePageViewModel } class HomePageViewModel { ~ simpleObjects : SimpleObjects + HomePageViewModel() + getObjects() : List + title() : String } } package domainapp.dom.modules.simple { class SimpleObject { - container : DomainObjectContainer - dnFieldFlags : byte[] {static} - dnFieldNames : String[] {static} - dnFieldTypes : Class[] {static} # dnFlags : byte - dnInheritedFieldCount : int {static} - dnPersistableSuperclass : Class {static} # dnStateManager : StateManager - name : String + SimpleObject() + ___dn$loadClass(className : String) : Class {static} - __dnFieldFlagsInit() : byte[] {static} - __dnFieldNamesInit() : String[] {static} - __dnFieldTypesInit() : Class[] {static} # __dnGetInheritedFieldCount() : int {static} - __dnPersistableSuperclassInit() : Class {static} + compareTo(other : SimpleObject) : int + default0UpdateName() : String # dnCopyField(obj : SimpleObject, index : int) + dnCopyFields(obj : Object, indices : int[]) + dnCopyKeyFieldsFromObjectId(fc : ObjectIdFieldConsumer, oid : Object) # dnCopyKeyFieldsFromObjectId(oid : Object) + dnCopyKeyFieldsToObjectId(fs : ObjectIdFieldSupplier, oid : Object) + dnCopyKeyFieldsToObjectId(oid : Object) + dnGetExecutionContext() : ExecutionContextReference # dnGetManagedFieldCount() : int {static} + dnGetObjectId() : Object + dnGetTransactionalObjectId() : Object + dnGetVersion() : Object + dnGetname() : String + dnIsDeleted() : boolean + dnIsDetached() : boolean + dnIsDirty() : boolean + dnIsNew() : boolean + dnIsPersistent() : boolean + dnIsTransactional() : boolean + dnMakeDirty(fieldName : String) + dnNewInstance(sm : StateManager) : Persistable + dnNewInstance(sm : StateManager, obj : Object) : Persistable + dnNewObjectIdInstance() : Object + dnNewObjectIdInstance(key : Object) : Object # dnPreSerialize() + dnProvideField(index : int) + dnProvideFields(indices : int[]) + dnReplaceField(index : int) + dnReplaceFields(indices : int[]) + dnReplaceFlags() + dnReplaceStateManager(sm : StateManager) + dnSetname(name : String) - dnSuperClone() : Object + getName() : String + getVersionSequence() : Long + setName(val : String) + title() : TranslatableString + updateName(name : String) : SimpleObject + validateUpdateName(name : String) : TranslatableString } class SimpleObjects { ~ container : DomainObjectContainer + SimpleObjects() + create(name : String) : SimpleObject + findByName(name : String) : List + listAll() : List + title() : TranslatableString } } package domainapp.fixture { class DomainAppFixturesProvider { + DomainAppFixturesProvider() + getSpecification() : FixtureScriptsSpecification } } Builder ..+ FixtureScriptsSpecification DropDownPolicy ..+ FixtureScriptsSpecification MultipleExecutionStrategy ..+ FixtureScripts HomePageViewModel --> "-simpleObjects" SimpleObjects @endumljava-design-patterns-1.16.0/naked-objects/etc/naked-objects.png000066400000000000000000002224161312550536300243420ustar00rootroot00000000000000PNG  IHDRV$IDATxm-Gy4Q>"Hü &\ g8bresIb6F-2 8 lea|6>Nll@>+q8c0/K',>9D14o]/OUW^ݫ_[kuWUWwuۗ_z]o&>O/UUl'V{y>Nrv $/{g[3{GOܚ=:Lͧ O-~-cJ9@l@I{~#{}{L~#(Fu\X.i`,d6MZۮ~J偙O y(} 䨺S-\=3G|#D 3!8a"؀k:K/E_GnHKQ/Qָ%Px XK ٽ|aogWe&ǺU_׶ طS*Is"NS_K{>^|m[3arpw.>}E'ߩ_eL-iͬVD_R[zknBg .țҵDX`GUZ)"SNH 6 $/_[ޕ<?_rUueG^x듿qb9 > ETy6Un飀UVO@1E򣀎B% H_:37k'Mou?5q=cZÞpᅿdy[GRƮ % [p11`\ `["pZW8}h PA H$aD&qZg&X B)HZ~@8.ǪTyMػMHHM$c#H*  BHg߾7?$cy0`Bp" B)J!{Y+>+#qGc  $aD*:vH;˴,=ב{=VV%T%` DP] 8z bu̍H;֑TJS\iSb#uM N T2).?VBp؆HC) @@T@*`#6#V<[HUX=_79iHqBrZvyD1_BV`XeÈ0qT k\,PjMɱժﭞq~"=CIߗAhAQ9rb DhIvH*.z̤-Նh+JZtI>nOL1`59^KX :BwHM8ݩ%ʕ :Qc tɑ#|Oq[#@0q!1 $3^Ǖ<VW׎nyു]UBb`bDBڢjyBiQs!@Gbu46G$ͤWTU:3Mu1RkMҔPMF5K@$fDP0wxa c `] %+R+{\(#)>2gB$͈1O `gwNLtcej99 3=u`yቑ+j[9y Dh o& $ٳG/tp{jNU/q/k  V܈0[NvbV+ms\;" wNC 5T ̟mJf:K#"[ @q/وˠY `58H@8"vCPqp M򕨚d.&VlWu/~E:p BHF$m' n.isc{R[%6 H=I @>'euO*3pD& @$HHM$c#H*  BHF$T @#%6 H0"@FJ$m"T|sM|69NBF @$BY\pk0w$mݶܱ;4 $|RM~>v?̙_t$\?*m|=+O77qo#-MLQ= rZ?*g{ /a~g0nҤ?~ph c)lHGYe~۾3n|^edxlzPzJ'l]wD1 @0RF%7i&# `Dxso̕8{y?zE.WgR'GgV> _p(h(؊.qk"@Fx$M-KJ*EMbDxC7^\=>=O}~|xw&~[Kv2z?V_YiRLBjapOB)?զ/őZ3boryL#$5A+%5{RYN! !]i?)cs1a M.CQGʒ?zK;:)cDpgϝ7oHd?ǧ*ar!;I0V=l W1Ȫ>6Dk:K/E{ǿ;9?7~sA.ME{-ڪʛ,\^e&7ˉaoWx=eo3=ݵm.%P2*J]5f۶JmB%mECI+nƐz5zϧ 1ʃׯBan3h N&XIjz8m!q46B~O%o~7[o7&|ǛW\tz}%2uРQg!c>:zʅ˫v/9VWkfe̱ŞvbrV i=&I% `B7;pg8v2iDcܮ&Mۄ0Sz~ƴrb_/F /_[ޕdϗ}w]>Y}] /~hU%kL?d%3f*utdfRpQ쐶R(vFIJUBgeۼ5>Zg Vk/f>bwO\fxV8/Q$uNgFLS$U"D? U>sw_jUVO4*D; ,#{>MHn=9- l|RjNUoR%o/~1WsAbvh0;D9S]-! ;:4[4}o5 ].\hMCZ9 Ư 6_|ֻܻy۟7M`~8wUUױ)_ sFȘ@JiuRNxR7M{f]$L`UU\Z㇅Gu%`;*<{CK9A`t g&MƉ!,8M ਝ,m$|u.h8%gVPϕDV' ȩ; ˕ ݞH $y'tfckJ*Gls4m@fꙝ}; ;RpJ$*v UC|ZNcWׅka>\/%so'Q& prkޭ=:Wo=Gw$c>ץ s{㷌yassuiLqLiqAQ8Vc6TLSjjN/|~13M[j^/H it)P>(`xN MM$c%18Pϊ#gJ$}KG_pm_+ȁ $\oe/ϯnQCg/9oXh!M$c#1%`z_"@f^BHD06" `7)/ 6 H0"@U*ga"@h ؈c  $aD&q4@mrr[DQ @0RBwc%0!"'V}X⮉$H*B$<{ܿyC ;W>x?>W '!4&ÉE܆>ב8\V3Fk8?G}+{r4UDZ(Y=ZU_MJ:.O;q(~)[z cP""HH)1B]v}]g;ʑye8Hga3Z`E~y/X}\YG[qJd~BKXN.oYު?%uvۡ.B=Fr$$O0 !-F}E-;&Y&,ٙ7J8aPk `X畱XNJuXH0gܢ-$}KJH ,)ou\*h}F9 F'le ~dAkRP4b>ˡj14= v#oRh9`T\8vj~v- uS%`}2nj%;* Mi(˘bԅ,[ȫն(6‡~*b?]7ƻML%c{8ۯ}W2{̡E^@@#`^bEXh;к 3. {+Ԗczougm.u&rS&'[Cu9J1?{ϧ w!TkFg{N/QMqvgN@ډ1Gi6ڔb4oU=qM5 }t$,a;D۠چw~F֣OESbkxڗ*@ pci迧8(or ϛh8SV=qp蹂D4E]D9̺D{E* UWN,qZspvՁGs-$_[7WMh||V 7gr4^^Qz`&Vcv+1;n7Ή(CXG݈^sL!{Su~ҎO T,`#Z*m5D~ԉ }:*غv,Fxmt+a$9&ȉgh HW|FۻkziXRlss|J-Ѷp` 'MJe.z"1,䆜y֯h3xmBzF$A+>/H_~9EC}aMwdoFNqvONcgru"9'.TWwLNko8 #K`%jB/4tnG*E_c&4;Bv3DyLvY `BX&qIWI˙o `k `GX qe;)8;pIriI[NQQ;ú1?!XMڽ 5''Xcvvs4-z6}`H; Ylc9\VLw B$OܞT_-h,h3ʳ_gn`Ul(Ger5n7АY!+:i6&; Qyt GSO0oᩫwKF06NPyRXtr!7DAMV /;a { <jo\~giTq R y`Ҟv8>oJaܭ8xJ8vFu@)~"bOiy_EaPzXw `"@')LTc`%@I D t(qvoQi S `Bed2yO\tߔ|aBkɊv=)W-2ߨb:]4ߊ6pN? x@HYeG; HDNw$!$ ks7I|9 n7ΏcN? [Y֋ywlRB g׾oJ AnZiKX7vQ AI~sik,1lWU["d1ѹ@q9Vmrm[>X B#.5 I/@P! p11p‘ Fib%kz923AX>r0J8H@8 ` DPv"6 cz<61! $-n^PA cz<&G&$aD戃$lc @PAς<x@ǪTyMػMx@#;ZW8}"@` DP!Ho[Vq2D=b67<2$c#H* 2. ` uˁT?VهoiDoDk`G#ћ?}=sËc  %`r/T$6#pulww*Z鯕0G[|qN\DΌ;)[S>-iuE @$I%O??>$ڼ˾9W[9fZ?]uERVO_!4/$a _ING3MW_#H r ˱j}xlRo;9yDX,T (!'NMoӒɱu2\wxJ`evfcajuّW.=i]yvf7WQI |fiyn䠈P,O3*P?Pgީ'vUήGJI(e1y-DM*ΆHzֵ~Zݜ0bɈb [l*lߵ^ &&=\'Vh%>͚zUur)!=l㖙y o&G#! @sBȮջh-wB 6mf`JrÂ(qoByJU_,]ZV'[uKC<, D -1ͯ-H?V9) woILA+LMjuٓLmO/г@|% MHٔ9frو$_Oz<98"om]'GyT0- `HϹnıj'f?r{rZ+NRǓW9mv:]+kti.J*+-:},@7)Dk tsn.xʦvN;/=MSaVt7 ѽI6*@gaXLMS/-v_:׭m}׉N肧\Ϩ W}-)ABBOx6X_ȊZ͕aWly'tu^NVl3iZ.Wvut@ʬ6n(ID; iw;E5_V29mAEn3wh?wNP]L^M)u9{s/%K^ *XJ4y>I rWփ%$&7M-m:qd]{|My(rG;7_ϰ].Ĝ;f6_Wg1_W=6hq@7,PRifՊDYz& S b{>M`r4NO&1Hr.o퓷FA{IEҡ3bzB<0;TgZ^3kW}nv9ZdA_PYY%ўC#Hh pީNw$&֛9v8g1)/ /mV UxgI1jVHWN41Ǫ>^jWOw +vݝ%e4B5z ^]Gecw~­s$=ƫNPx=WozO&&i(pN!kOW`9Ij u$ՙ٨ŠHG'VVl@@Q޲m]W}}մ]G"O|֪#/2|h!ht $S^]Ge-Au"@7]5A w^r~'~drpǓ@4rvt~W'jVOa2ix7{8 ݖo}_(/X9[n#r8vobff`kfQ,|ϧ@P[ uH~r =n3Bb랬#=&I$$;ᮙ&GXcdHC `*łGro )DnCG% Wy'9I$mNVqbt!K$u*ł0kK/YAe"@h `PdzKj(" `:p~gpY0m$oEÏ+Cɱ S#q#X40!AMn3@ aG$QA H0"! BHƱj=q`m@F_/ ˱j=Un#n0RN[8zOg^V0"@` DP!S}?x89`ogg^?9HNKd_yC璾% i0kE9SO1VhWU5|U}X-yS_EaLJ0gܾabɱժzօ uSP e$%09,۰s \SO{̾Q1 +q=&ZK/'U^mgUŲՑXk!5xZW©&1o-We: `kl{IMzyB[9)f$M K@#\䦯{7>KIMW(~{\_r5]<W5*q!@P<:Vݔ5N&Rɔhqx5x@,":w LczšR\0ڪ+_ZW'k?{W₇̙_> =/;$gDKG II34v8B5NGpdl&1lP[?!Q:B^2Jm5vČ7Ws23%_}sx;@4ͳC4_;J3B;T:fMdEyUuj+NҘ*ir̻iJ qu @r:.xH*ZHOG9m5_9/gMj-;U=I<8mNӑ,=Ζ8A 33o< 7j|B|,m}++a;iolU)rqED[e+jʗt ވBʽ?o}?Խk]x'甯v9cj)s&O kٴ%,l]ڋ,c h`I r;/9_?yw?}29IvZXsBT={MFocZFenJ;[$?睞ehsڐ|y%LQE91RNsE..ww^r0$doWyxiBwǟٻyN 3H^p B؅ӑ, ZyS~f/u@N. |/MRH\o?S :a/(dX^b^AEˏzcshPLe%f?Y)nD4Լ.qj@gFgYS?kľ5@",[];lvS.;',Elޝ\T𱓯N{߻, wzi B)#X8 @Ч8 19QYb/')$ؓ/ NsJ g@@1ޟOPsʕ,[HƯ!-d2yՅ5XN5.Zhl"85 3N~= i`Px/(Ws>5&ڻBh HWֽɿU>lJ.xcD>]BzA r}$wֵIR<9﵎lR%usN.1OiAI lצ=X%05NM]<}ݣ, [;} Ƽ}ïYg /jJHA wν3NSvh7c k*ԏ.q^S$$w) z&#Mf PC7qy0VmXm6m'B "ΦiE]0|rnyw< H S$@/N:"@)lkvOqCP1 BL$m"@NeҫT\T @#%6 H%Q8z6<$HHM$ccH*  BHF$T @#%6g%əͬvB$/zS,Ճ?c-,&fA6 @$6~vm4ni^| N9obntZΘ;&  mHqCcjY~* |#Enko>F݃ʑI?hHj&۽Q>NӞa%l3` DP1Q `f#n^|CZ) ]N9 !~{~( `{LlvJs{lت*ұݟ$<9RU꽼ޣY[W49B{BF 6lH0"h-t[sfni;T?%{Ҵ=7&4ۗ*~;@oh(%+re^2.?c˿y qG#wuP3-s]|Ħ]OUL\/~U񸚍r_WZ{˽jbW)&[*c .My_ 8XݣW.I9InzKo|h'4bU< (+7>^ʼ-5 RUxyh)oBY}Ir<gX=9l޺3y*Aa]7:% U&mpﯳGÃukmC+J3EC(7WA!1Nh 7}ޫo=XLo0-]>ZQάҐQTjODeVV г]?ZuX1kϝVb1ciG6&%eS\oyp~gyd UCMvqtr*1ftHmBE@I6Ks^4V_}sx;@4w-߲қT+pFcj!A/[T. ZrլF^^MyN<|Ui( =/[Yª _<6m!oqotC1+= /+:5\0|h!mb[jdoZAnX 4׮*ZoN* orܩ =;#Ժv!~RErg[wPd1K 4&($G.{xTrkc =m{8Ry+]K#EB-? h [7굇q)澴ݜ?*27WU5Pi874G^9sjrk_rrڐJ)fC@tkCn%o΁z=#i,Oi *U]_ggɾ4v}pH`,};Jbf1v$w^bWu5 oEKڕ ңst$sSүGmMHR,udd{'W|`0dv/%OD: F~2Ț%׌>+KnrTJZ*':j !ࣤz^#p8M6ALQH?¤.i{u]i[re>CHoxJԭjP vx"wx@`J?>;Ǔ[Phƕ~a&e~Z)$ z_1hĆ6`Mece$_d>:$X:T fRODπ z<Ï>ogg^?9He.7SI3Ciw *./;"[40oi uQS_RS6KEzrJ~D D-s1FqdU yMĆv@P,v*f4YXw`5tI҂kJ-u\(4}#ɕ7twOKJoթwDt} XM52_O zM_Go|[<m{:c e.WoN*b*y@=iyIY6)<IV@= UWG# {=5}s>  -$>T)jn2-uLӮ=JSȗjvj靴{ƪX&b8(l F3gA=L /ܾwSw<GɿIvZ=g밍[ޫ%Qm̟kJZY7.j(p%0$I[tj u'^o5-ZH`W':SMidߚ ȽRoҁ|ߦCz%*~Ş-A87xRU A Iw8Ʊ ς z\Ïs'oool3m֌-ZA󼻑/`n"R^׍ LT~54{c+IxƈK/:yMĆ@>Xl iCebB 0O[J-&X$;%zر!;_=vHޣV  zgNO'V ֏&fū g@˕=8yd-^J$V۲qdyMĆ@>s+`elyhF-&XT@a"Zn Xbޭz)x@(mς z\Ïeϝ>wJs\d.7^t%OFH#sEy2/yԗy>+)R* {ض֧^YHҍ[%kb7 6]\;;HmcRzHrrJ-uL\G-d_c H{gUulW~|=] "hl԰YAgcOqA@8l$+?&ZTs}UK:P>$ü7F6/8>=7>;< ₳p/Sj>Zw5%ZEQJ1NiMS=#XhQџМЬL drkqBEգW_K*O zTᆬ?|^;ٚz^Ć@|:idiN痦y0ABǤ=l=z^$Fd>M$Ks(P]xbNJzdϚì?xG!y9#<,ݻʋ^[O+AG!! B)0)0p AG!! B)0)\pk#zc~V! $  ĆIJ^.˃:$xBx8D8 3ڃ3 yNYF-) ĆL?ۦ|-fr_R>S|{ƅޱN.~~B8!"Ex~+ obIj&qm7X5;K|̃lڍ_9zo*s΂.XլzP$Ez[,a.$KXW}©h 즜OgB81"Bx ?zoʙ}?kezsr!3p3HbCK [s];r?2lxu\ Ԍń-?#}?H-,6gvkS4RGP߂2?BG$I/}^^orhX TO TfϷԄf!Eeʺ{J1p!m9fW eZ,%3P0lG$ZJOǏu BϛxxKo 6g"]#Uogq/!rdbG$ZJ?ŸLBs4k߮4`R.KJe$b17n4"5Xn#ώlB@lWL͠p?mX^n'?h= Ć%t4 e-!u& QK˜b0R"؀!H 6# .x掤~ ` H@@(D$ Q H@@(D$ Q H@@(D$ Q H@@.Y#c4LHypttB8cf #Tp $nP=z!gO?xI@8{2$L@08d<<_g ɐ @8g!fzQGjTfM?xI^{ ;cZ/Ní ̑8t`qv W2Fv`c'd*1+O?x0GDK![baF( TCeuN:It>G3K ,"+;dH;D`k!۠k8rO(lձ|"9[=!Ib$!0B?xĉ_ CMECj'r51I>5B1P /I L85!e@nZqrX\V|uۗ_z]o&>O/T*o o2$N=*1] b!<@qƃ. 0ə 0'w1ٿ=yS0b+EG3XP 2?˃6X)~B?x0!u[+ 2^]Ts%T[&"] `xs_̋噗y_Nû3CRoy`R\Sgձf{ˠw Ğ>P%y{'VQY'!>h)t],oTaxoNN.–xmHs +"] `/I|G;ѿÏܐ=^S>p}OuX6bSicHy E}mackc"$H0Hll' p7&xFoQ7y])=qwpS8HL~OxoL\to㲋O_qwV@'M5P4z#drXTHY8&0ʡG8+䣸'!_P7P`@;_Nd$wBaYzGG'H_O-r2$I3s2$0}nA*O"t`qd37k'Mou"w `*6H QOsApAv(裔Γ.phDӠU{}:MF׳S>0"j aAvHΓ.phDР/b#yv|R8H]isBfI1Xh`% )i."x4: 9.ph̹A+ `w71M XqHNKs0Ǝ6hڌh+( !Ay4>"]YHp¤ Sh^|t;?-Msw4=Hi!մ2쭞&`C?c9.7q\ݩzr8_ X#Үq[<ʭ|N1ɃӠ^~*ŖkUT~\[]E֬) !o5a_qY*^ig%tCc\ |/7~L>|۟7_lܣHD_5Vrfzo])0_m?;Ǔ#a;.X+:`h[.UNبT_VN > P&eT Ӳ4쉁Ze' tCcD ŗν3W~-#W\_]EsTx7mjz1SeA3ѧv{NLtjT>ogg^?9HUߪ'`ohW eRǠ mI\«| Z'j1p/ch9[F}Xm_QqBnq2dm_yj઩XzrK1" {BcG TtTK|Y6 (uגI84 ڠ|C7^<>=O}~|xw&~[K굔Vl4Npzj ɽU:MY̪I*}GB9ǖcjLTMs1 \{7>KIMSk<_rZh*ҌmŘc7뢸@jW+VLr݂n T[V#JL -zJz}:f /j!Kiܲ2G4ht%ƽVLuhKKx.phAy}^up^$wr~o#7$|σ%稗 6ǒ\PܾʳIE!W ]"'Xָ33FhyhD}٦ GN=w(#7 NkDGEq tZ J5q36p3CԊˬ“y 8.{nȤ߶ 0k5!U D F.jaC-\W< 09 .sZvt fٝs VH846j6E.|~ f࢓x]|NS0YnUPBT`eP\_8$͝{*Z ;Mwf@ITPsPh.zھ?؍7=ysƏ'@4B9QkbU$ZcO6G2]jCGIT@ﲝPį{:yR >Ry)0]GU}Q7Ha2BY!'f!(ڽA.nyfEzXXf4ڲ.$]بAیwu-gJ?K⻮LȋgS׬>1 j#0kR]_?ҬFe=^XTmZ+<]K/શן38>y'K8/D Ԫt(:xtgVcu.B(G/+%е]9V:6lKT< }Q7x3BO0On]ݤ #6hz䖋O_yW$'ϾgK~W߿᪃ 2m @8WJ@ qU"Os᩶eϝ>wJsc_PtZ r*iXultY9Nq݄ﲅ`3/7wEOݑAkuSݰ@. yb/zHll!tCcŗνu8{;?^W^{5^}twWn@} "?@ZU"%SP-{B<ͅ~?? 8Ow?xQVkN SZ8X:Q#xc#6%p ~.˶^Ʀ欲QnFQ=w4}ȅ JEnEhMo"} `4*A"]A;x륗~[rǝOߓMoɯa{vWQO<;/lpup%nO[84b8dz,v-Byfo; -86A 3 ZbK:_O&Ie».\c,M1mzˢ'#aa)׺“6|@B+܎0B4g6؆eVT|4hts&]ИBKu憷}nOϋ~B6{u\(˱`eU +r#x4: 9.phڠ)Ԏ {eɁ*u3*P?PgީB=C Ά4` S3 @*E+Q9 TUՙ˥\HN[f>@bNα{3,<\Ƞgh *GdJbܗкo! #V\*LQȽ~x~[PjdIm{|۞/W_n'¬K|CVΦ`޸, U2ds!vX&T+ ]=Pao/v^^{R ìn@{!m,w4Z= #2dl.d34M+*{p$jl۱66LQkމRUgmc8 6F2݉;𾑉(1id!F|M/=HbF!tIьmr&CP< +SL@jm~?t8d۟NuWݷ]S]U]ΩStkNOT |xZ㾍@w0}'k>npNID4'`4P;,LjrvbG7vYtKuB5 hVy*!.-d?+Ĥl=TJ$: S󋩺yL$~Đ+h;i͎hwvu\'fDö<"|Z7@SU4[6Q_^.whŬ$DʓL"}DoES0R]WMLzFA*Xn}&Btbb%Ԋ'M %nc3x(N`䔖`vW Z7@TICbS64M_&TXgP/ zv;PeeCt lץv2m~0mTZ7@&/v@LzFu*SU"61k^[iҞ5 (т 0xD &nA &=e-/pI-X Dwk8t${C 㤃2@ZKrh{͸@4. x"@.Q܀(ް+#hF[(W{jl3{aNvi-aܠh&T)W++cڃR T 21)h&n1\7@@ebS6РO. B@_ ^C*p؀ <`. t. T 21)@gpx"@. t. BUZ_W>=#&=eMg!hk*7? xYT.Ma?`͉px" \Z  @gpx" `$ }x1='mRgq^&f!&=e*boP6tZDǩ*dWСڛq3z6,Sq1)P0xD |oOm#c0Bf{Wy|ɰ.@LzT3p8 <s.^gŁ8%y h_d$A]@Z? &VP`(SVපM9+;4Z 1\7@KBSiY 5s/,K4췧Nx_^RQ|@ lTѠ* 24UXXcbo5Rw9{mv\Μ8J PKtW,,49Af^I$7"AD?-a08U4'[)yd8v- (1\7@i?Sf8!ĩ23=e~RP@ /R 5˄/bS6RU'E6AJѱ~,㌕HSL1`Ljo`HboR>{?(80SWj8#(NɤYϭ""]nDsIϦTz&RG3ؠrT&OvwzHLNU c%& BT}aV{eK2 N_A z/ulZ^\P2 `ki#@?`Ȩ1dD&Kz P(xD AN]☘# Dx*#I0 %JH *t4Y ǒ E dB. Mw20xD ]fIOl&:QH)-'2H`k7R[Y[BFoP:; 0=~f-̾qBS-u%Jg/W哂f}_[{>DMU0t(6p*NH a8T,VZ)*8܀1ZF.00[(-}f+PtZd@Y|Dek=DKVH` Чqzl/I&"2 "@ !#7@wUNQ%~UreƫUS[?%! %0ۤG:T:?ۃ(d`HH v*#gE3qlF)ڦrme{b*Шq=]' RBFoR{[ʍ@2"sq0UuMŊ2>M%Ri/\E񌙸"ME nNX߲OKsM]BP6A; BT|qs!WĩHNY➊s%RVKuETf5n2[ v.pޭB?v l@20xD ྒྷksvĩHI\LQB}1[+-U }Pgג @Kd;y$Xfds*e, BTWz<""!o9EbhW?,zQh5jPK ֝|T=ìA t BT/ڳr`᭙3Έ=S"Qʖn$Q~zN+ư"UY eZ`&3' QKtK=*e, BT{k oT˓ l~;: }TS}P/] L$&=e*boR>{?(8'[>3OZ4BKo3'NE-=i(@Åz>_*mcT(kNDD9. T 21)38}QGĿT$<{T HP |!BA6*Fm ='|T 1\7@@ebS6L˧Xxkf3`H[4IԾ6 1HU0.H2 RboPĤl$ h{k oT˓ l~;: R`12ޅh *% a0*w*N)%` MYGYFfloO6<={?(8'[>'좽'-G%F75 ƐL. *fNd$tVUwm;ŶsnIO(n@GkYq. BTGf⠧ٌԦrTdƬM^浽y9ܮѓ Z3+M~;qboR{[ʍ@2ٺB`b#NƤH^k79Ӹh޳mGK6u1Jխ5'[MYG6 e]:WR1ݹQ9bS6z F-_@dPq. BT|qs!WĩHex<޳*;Mr{VX'j.T W(`&/Y.ٳWmıvTNѧM X>1\7@;ٜ6;w}.`gND9&JC5.ԧ8C+ht_l6+KՕ佺QK )bS6! aP#g?yqũHrƫd"AzgPǦ6*m`+\vlk6 ,aC.*׈IOـ t. BT/ڳr`᭙3Έ=S"8_al Mת-jd,kceew;]X 11)P0xD @3{?|ma@yxsЍսv*c>j .@9  @gpx"K ϓ@=Y7V xHN3 KQЈo ]#m 1bS6*PPqJ)HxT]I.-{q˥m_43~5d\(1\7@کd\*ٰ ѧ):2T&ЌQЪ:|:_{8M*F m"N3:. TR^{/}bS6#g}&qO±ij^B P=ik)0B>Z @ y#y)UboP |1?LDbS6}>wbw_ZqVS&[ΦH ;\'DPnP\` h'U\%җ5'[MYG/Ym_y\`l2/K_ѻv9 FeLkR/v'K .=5FT+p xD ]&&=e4~ӗ6΅\"QnHٍ((De kҴ UCJȱѿizVHk6I (=`4I]e?2\t5HEXkNj0\<AIO0 hl^>3'NEM3N⹭ȽG 4ʸ"JB:MԢ,a\|8X'׷3HSf{MJR *6 51]px"@.a8ɋӇxD+NE3^&E ]kjLv5IIL!NUhUNKԞMܝljSHR~]a 9Kc]LLzʆi@;xԞ o,\9}uFY+[=]mn=W##rG9d`U{VZ-$0lvbZ0V!a h?}U.q޽ʼn x߽{FT @ebN_6G=7Nq#}2ٜ>.$. 0(G#2kX /3=ońF_]ˆ *]VE pNgΝӫ^[[;vzMC=ڒR'WE&is47!j\V"&s<={?(8DA}Aأ'7x%ntH_N쑯3 KQЈ-rA5kj8#( P"/G"a5>!OO 7# A9_oO{kkkllluuT ,RfyIveX>'1 kB{dj܊>1/U h}by!Nea gԅp8{޹s'Jݻw_*h@ P;8(nfӻ Zh]I&ZS嵡RN5bN_6VPdw@E?yogU ;FS{yyСCm@]P/W;p/8+ĩ'!2V;4֫#sJjhX2fR3ge6f;2s%kZ-Q|f]i8mN`ײmm q˦٭y_1MGGn-}\ٛۤI?Ĝl8(`3$e otOMM  b|||mm(_Í;wQuAT|qs!WĩHUו9nʟeLxx,WwJXK@JfZΉW(!konum܍{" ͋sE [%QԞP UPQ3'NEͬP=At԰Izp>C\UƈС4/L!j/04mۮ@B p>11cNCSxGFF&ڠF*+G=S(eP_'^ %$ @EY@+VK,)T(ܛRoLTɦ IU:.{P @g[[[0 ǎ.MQoJBT^y ( -*Ocp/'Q'.I*6POL1W&wb| ŌJԩ*G#kj(|DE 'n@ dB(? lTGi}vhbsF{C;L;{|ׂ&Ri?\FCn߾]+qĉ;wmmmݻݽ{7SbU,/L9AY!8ӗGFTv$ųZ22QbK+aru訐.\@&};}7M@P+Ɠ݂I [~6*<Y?5~J6עjљ[GQmƠ!e3p!d)!e( ;wN Tby iCY&Q;*\`*0{[ʍ@2:ǹ]-jxЭliG/ MzK%>PU[cƥ鍺0 HF b6*y[6L7_ܿ:}i\q*lXP3'NEEPU Ba;&a; L 1B1 >fb6T 2-38}QGĿT$e4|jʁfΜ:#,OD)[@ĵqnyuohr7{ܝjW1*Ypq޽ .޽{tttyyy0@L|tF€HZ0 q N<)d)T 8GEeЫBg/WIaH3Ihu,M04pqC Q&?,CEMo"!U 91ZaU):P{Ə) :Ç8vgLZ+'lG=9`YGl$h^y (Vd f'D@j9Q#U7L3(V8;;K|VH|tFtE?T{E{E;TK~V2\ QЫLϿ^[Xih*qCP K֢ΥuBKdUt[6nZw9vF8Vj {fAݩU,7_R= V k80F*+G=SH˷dZ k;lv_8fjѴi*DEFb?nf -8e xS*Gw; Cy:L-#DHcBHp=+ޚY:s8س<%7 ^ԿqìޗǮv7,_6`\*XA|tOAXb~H 'd(i{ < #Ɗ%H>%2 'T/NZ!4BBT^y (#sgp;#:0E)xyM=\306XsI*yÔԓzãmUlm^㿟^hsNMF '? DV ]fo*mQspJ|kz2 ޶)34}8g^{R6u];/)s9\fUIlU6]&\NSk I㍧pEbN1˧~p?iL;c@qǭ jg\4H}i r).<g A+kѕ$ɲ0SoK~Hĕ ڕlU%-HyۼPG\Hj70lDG} ؈qk\Op޽eN~f_ͳ_>S?4OFTfBbd+!V\T  B*~)boK+zFEV-2Tqx0>ϯ2}ŲɊ{t?Sfu] ֒m9C|>v&//GωSySq3vwE$XG/J{6 󜯼#}嵲-$ 7_%GLMgT=͛SSS;v8t3 ( c Rw3}{\:7ߗo?}XP? hT>/r&e/MЧ` *VLS%TVU7[e kۣO :+X#d;a> ?IYG?3zs1)6`pTݻˣwp8-ngƊos#_+'`"(klP).%f_gE>Zv*#g3=%r4.iz9r#XX䥭OBY _I(^|ƦOxx(E/}BVpiZ//V*#2 X3租x n~ǿdy_ݜzJ_xiO{B䡗Ȟhi #OĘQY_>ݗhɵ0{ l}' C?4#} k8W/m "NE"#V펏KP-{WNx\)A }@ UKTq@-Oa+m^弋8j FKo؍l$z?U;_o{\\\ىubۇ*(};_ f>ṽ/|⡙W)"q䠫q}%pŕ$Er>ck`PТzEk ƸC /*N6g] ؙ"9ĭVi̜i)9!McRuP;fk1eW}:u-uF]l0-+tl7&z7C'uoɟ77% ttݻ###'N_=ubnBVi={cţ'v0W> Q"jmmm||4~>'ty槿yt=oM;(*EPݩO`gGOT#nLs#8plS HZ0 q Nl޷A폘Y|5&E^`t LUB(]b/ P0_%s/%/ɿv(Eb+wP0и};&&&"kEI`g~SS/ٗ?w8ԹO|eQ9S{r֢W;?s2vp G#i{,3DdYSFEQ[W^C*[%uAnU\Z4+ds_`SI}D LT7J҇MpWGL9k֟۾MP;vPcuulSE8y3rcKOűH-ng ZʴDM #%sɐ؂ uV 2K~'ѥ"ܻwO\}OW ;w;OÓO<=vz⏾gۇ%>y ? #I ̵/^hDܒP(d;BiwNCRݭݻwӡCvtJ5 y󦻓JX 6pH6(P `pVSÕguNJvcĊDGwzIsD@ItFP!#؟2s|t766ĄzAdcwwS TD6nLCu"wX*q,{zxKQrFe@*A@lllt<0==~1P `2O5OMWmV*6ZB+IA@pXGw022X+;wk0P Ы?M[CK b?H+ 8 }:ݻwGGGu'^ B3a3B0N - yZdY=LI(&Gwa֏n̄onzqff,j|L#^L#Ăze i~Ӕs}%/'qCZ!l6K8ϭtNOO30Hͮ*Fb=K>}4KD@ 'cC!æ -„N0gєݺ2p!nmj?+MX n0Gs6Znċw:U0Fr @ ȫ6 qub봸 `@X `;A **JW\>A[RxX`jP@VZ}8>O|KB/EeRvLF,Iw066{@P sU:*Y_W;p/8+)- :.o)!OHX?b}ט kf#lOHmwV4bG)ZhbtM-0m`P;dx%E RUANgΝ1 TUݛ3.}{2@w&h@]p7[_K.EJ?1XT HZ0 q N<)X.%8ۦ2m}׿&.2+-8i~UofB_ڏȉ' !G?좷^w~B/kX]e@.dz͸@ l(v}B?7>Oq>. @dC*'Jyk7rј`>Y6wY_W^>Od(՚6)MOTMBES$8݌vm f\D lDVӭ#`lT'FFFVWWm @HpjK?Q$&3|+#hdwAf[LT[HujPt_;jlr89N~t浯|K?Y?X'_;ZhQ2Xŷ^ @˜ѱ]_C;VÚ|t&&&v}ͪPM/kĚF*DQ#ƿt?R᭿r}dG@*RKPo _2V߽ע̟SS_/=! D9" 2ԿPdm(> ؒg1l3L%˃>~ΝP0FϿ ㏷ս'?߸5 {\ǖ0*}wa@(6d^ig~Kf[B nWUkƀ|tFGG;vݪP<}$"|ß\~Kg~˟G˯5qk:YOV$H]%{0a6ek߻ntտ20ޭ慤v{wc/BT 2Ϗ.//W8HI(pϝzF+?u$szDw*r+~J>Hg^sWJSeAiekoFe(w6k@dLY&?GQn=6KmVuhz I Rwq:t\`lp;9C_y'sſXB&OctQ/ ؖuݢmeq)kP sPG+VDtIP^Τ* q˄ Gp N~@Ђ:)os+OFab Ӎ |oO{*-VbbtrE<)0B~WYhJQt L^;@tFFF AT0sg##YBH:܁}iYq NXXvlh-I^#diXo7IRb!fhMeE  ImW^wa~X;LC_ٟE>###ߪa{5U~ӗ6΅\"Qici$n26ݵf'<є,w$O!Lϕ$&*̷h QkD;wHCt{a^5Uw9{mv\Μ8R6VUeocI.ʴ|XT,rfe\ i*[Ah_&Njz{(.}to߾ n @6Z(雫35^0ciK|kx'/Nr84SBY8]~  ۤ-$W/M$RPZ dVhAՖ}tGGG B@UT-@2Y^ٹY{ 5U|jʁfΜ:#,OD)[VtEZHKm#P j!&wZ"(.TeՏn ޽{U 6j)߂!c _FWg# 5U>~f-̾qBS-RRguC;8ysRQ{}HRSk/d@vX@%n `mm Uhkk` .7h]xJf۬KvPq䜽OHX9| ~P@qplÔ%w4&FKiR QdPn)[P~#t{o44tܹ3>>>66Qu[H|;mD682XBNkr{lu,yJ69r{ANY X9k# B1 ?s-N29$NsCmmmUɓQNX` 2]mb\E&&rn{AN'+%F67Aoq*b"ğl9@YTF|V? >NMѫ>dy8nH&=M_ /d:s_]d/H.,3a#@NG_/ FRUn9ܴ8FcLxɚT}p5(6ew2[޽{18nHٶN)O6+DyRZ f|*C4@WYsxkOV;I?w%@T&\ϕKxnwd3oGmݥLx%[ O'SO,. m-sMP;]%~^aVGLDn޼Yu[mc (AqnNȹR ʹ9i|^dHF+\p틴Mrdh+_NKS~ޟCQo-0Oc:Ed)賈HsS~*]Bt'ImodN+`{f^.Og"C~EW y9D ʝ?V#o }4 Kz}K$;"6Qػ(mkmdrL-eB.sU>VWWGFFN8TL~5۫3F/KH̖s3 챴 E dB= ?{r'l$tmڎHVI02[zV`(evIm2mHf-$_! eV u;^7ĉ###U!E*a^A$b ^#' m]W lX  \?O4@0.{aDzG[ԶX IlY+Œwժ'&&v1>>>??ݪ%ݻwAΝSnxw xA96 IdV `` :a}+){! H^ĘY|ةj!_۸ >}d` ?xn|wU7 @q>cB=1f^; @ݺ^yK H |CQHi$O3_jEm`. ltZjN_]޶toz6mB:5"@g{x9#(Ȯm&>"@aMI*4 ֡5l[q {޹s'Jύ_h\c\F`>B5oߟZj(f׹mDZ?J@c~~رc4EtС6 ֖xwt-١=|!Ìz8' " Tє<-S@Űpdfष\t˂1f&.\X 0* ccci2|߹sgddmq޽Bc_ @PB^ _L&_^=P8v옐h2|NLLQDz ~}"q%s)._ Ma{{;< @d>_{^@A]rzGGGݻ4{7o{OhzbfB*~x[a/N%8NtJv"54M 6hAWi___{'}MYX9l811is3== '>::*W*23 11ٺkzĠ61bFe*_@.G)P8qΝ;ֶs# !޽?0TX\\%K4٧{_GJRh;M,AL*28O6SRfvGiO ^s==#-D8l@;vhxwل?0{訥|Uj!H/Dr=-r#_zoD'Xdf*n#@EO=2Uvoɾ iJ!^ 2T `Oѝ;wFFF.\PX0++'T@:-{ܾ}A>Zƪ4G~qІ%pvۡK&fdբ'߫ ܖlB9flKX z+ \@>,// %%YHc*Pm(>"]֘Ƅouƹ+T$j9]'.@ytc_TK;lNLIƨ"%Zc(Pb#P5eSDn,{=T N 7޽{رѵ5O؃`>1 l^>3'NEB]OcXor *0V&Y"⽶Fԥyk̈́W}?0++'T@:-!/b%c4&`/hOzs߳H2෷HoTpiZM]|ǿ{E~˟O}O}~oӂ>O0T0~?U57Cm$ *Fʤ?ŎʓAo*TA|sߚF3]}0<~f-̾qBS5O;@/$i/IKAV]. ]xi|C `ZMݷ.^Zo??/8xhc'x :7䫬'"#dX1I*zL%Jovl{B[ C-ΗؘoMacB廐-:/Q^cq2A@ {m+/A!_DNq=_f{Iq\w}m >@ҋGP7͑ZS: Ll'M9&`{6/.>xh?={x~\/_xmŏ.NhV2ȯ;yfY`.kH/V-Sy5WT D`ess G5^ƄT?]v 7&,ONf.gUqȼA5!DWk{4 X0NeqK5^h?_=k]ϵ~liꙿ sҥ/ZXgB jHQdLMU/9]Ʒ[vݵ G51Y PTSXTLbc CWk{$I @sTg* 0|=j8'噟Q#Wzߚ8wP5!"@P,븏'"j2*/d.f'l\ {QؙcZ/װZMh\$ ^}ﾴr8/RK--QzsBBgSկ9j6 YNo)%-`RvI9ʽ*֤TQ]sJ1{u}ů\ ]}0 .oz˸`#lCoG>3?}zϾSWψ_~Bd֗MfwttTꖦB{en_bp_sRJi3~c5uk8iƄouƹ+T$J ^-_ٻbuӝt/HȒ-Smw7?䍐]+LGoҝVti5 9C_y'sſXĠj$JJ񤠀i*$JISm-`T8Q_Fp}QrTBja;_7&bp[0 l^>3'NE^`%[Z1* u~T2SkA9 7'ߵZ{ l"eP{m}c* 0|=\yz}3϶DS~1y˃st[c8ɋӇxD+NE ثGEH%Lr MSU]wľ 80X%tG=gP* 0|=wUbÁA~kLc˧Xxkf3`H.G YplՑn,GˠYrOK+^{m ;*U~kƄG=7Nq7VQB p*O8rq ڽ|ג.e( ~ ?]}YX97{GW5c³W^.쨈ItE@qRӓ"pH+"ݎj9d&&^]}QجGgӞSvc̖RV  `@0]T;&Ts f't4=b4>]!T@`{@귦1!]Shح#80<{=,V+8  ` 8t[S>T78vtG\lK+7Ίq*e /+lbpI)O,,'ޜl5eA;|;b]Cq8"hԁPyQt~k0&LWk{Fouƹ+T$J2x/mƱ<%]s8J g֎Py>棫 0ྒྷksvĩH kVaA "39: h֏Py1}s̰fq5W7{f쉮0Wz<""QʖM@?i*Lsϴ6]0* 0|=|?_T9yhߚ@'^4|jʁfΜ:#,OD)[N+r p3%7c0'Z I{[s --%PʈMT &: #㛦yL舿w89\+ľXK<1=FG=7Nq7|^{6tX@v%WjG< ~, ZJ &J`} -OAA%g= i! -M(i>P$!_ɼ*5`/? ۞ߚƄ^su_X_q[]`N[*p%i+ bL>^#yx ~P@qeyMMiGƐRT4"qPy1*X$Mhx!zEŦP"61$WrRU*`YvB{7ߚbTyrk>𱎉tsvtydetu&n{mjg?\OwPM< <q`V FtGճ4__^X7أ}h@I [:fSMY=oh; &]$ ^}ﾴr8j?DД\ }ҔWN`ўpD_W7#%b`0XD7nAQCea\}Q ӯfg* 0|=*`_*v^g$۟KĐơ'l'_)hCK"3^)o@oiL8W/m "NEyNǨ^ԝ)*0]( 2 Dة@ԡN믌/Zc(PÁ4-z%^cgc  `؇Nl"$nuQQiK[-="hit|lgK8Cֶ-.I,$[HC{~kLc}'f̉S(eUiR)(^f KW$ʼ?|e|`%E``#˽$z+b%tõ;9+"T@`{c_Mh"M$.ۓO mߤt ۩)A"=<]}Q٬@zs4}E#H 򖨨 =O P`>L[_IWk{i}&棫 0ྒྷksvĩHI"V,$gTȗF O'*m|1Gbc2 u2~1G;ܞbPy>棫 038}QGĿT$ڎBw_$Y{Ffczv1[ \jN]}7voe6^:ivZGu:,WEPsīO5_`Q^.yH ٍ{WF}Y}}Ӊw8nn0cj-Rni:1=8"]ȷ^i|.`wUHY4!WO/\\ͳ"t7@:!Cp5sՔV+ZɱX;$ &*#}m K_QL@B:4m nyσ5~HkR]N͍JVV}i&aEzmzLJpߒtbe:^fmrQ-/Hne_Ԝͽbw:ZZtuξՇI-$C N#P/\ 7G6o舵\{7cꯇ[oξ~1{h6f]qbzHvٻyUfjaS, Uo9Bs֯7u)"+RΕ%rW$ͺMT'?uӾdy YE%U({V igNgNB 7@:{cv6;lL1.MKZ#ޭe}e5]ڀe[1d^Gߡt&&흷vrwG:LwY4\$hk\kj f.S/9wZ+$E'.Dֹdmx %(u:҅ f ȏ_0a>ĻmqL96q8~s;ƀ^âքڄ;.3k>a }ěۛusF;)K$$KU^Wxu% _UԵ!E5s6הw?vʌVQQp 7@:/ {L nϖZXb. +-܎1 ߚPpGO쾱;mK'N4@j =d'"O! 5"@;7o5 @(yQ՘$]TQ^.bgh:6w*% oc/}}ӹz? | /?`otQ1gt uŤ).Ho5t7a $YRߚHpc =& ;uFY.X<).npnP i\s `5e!ujp䫧.آ.F~5 |w(wf.{QYܛ+&rA斌V8oMMxړ٢fC9 ProΉ(u,FeE!m7ա2&(@x( hG \ӷA=T+#PWpSwfST/~QM `+i3Xw3}E"Y”s @B*4!뙍Yա PJ<"b-萪5s t^3O] -fAE`E၄Th9[shۄrFuQH ˮ&Z ` c_kRHvNcZ0 ˞@lԏtKw2WT5`E၄Th9ub C&uV_kRH>B5 h`E၄Thҡlo mZgXQx !ot#4[CY}}VHH ͦ&uV_kRH>B5&'W.8Ye`gȥi!2,Yo`E၄Th94V;svJP_kK cCiO cEmw] DE&DZjT׬9s @B*4"]k֣E56?uϝϜ4ps*BR>Vm%(dmѼfQ_kRHB56:qe}la".=͞Fn f/j}6Q2[y#KbFrRĹsup`AP_WʹikO^Ψ%)J8qi_Kx7¯1F\}}VHH {))wveYzœp0ɴcYz-R} g^{ _|r}<#_=CT}x^[vkm-^^)}&w eE{%P! ّnN{ùjQ`E၄ThҩuG3u껿ު{ךz 566olＵkc>aQZ=km;~^[q@e)^%QwZ" ۱>w;P-¤]~%j =-R3=A\+ $B ju&&uV_kRH>B5 h`E၄Thҡlo mZgXQx !ot#4[s+G*C ]0i @`A*\ @h&[)B*tlST o @C -H #/sЗͿ`-Wt ? 2t]|sa6n!\[)B*ti.ChST3 ֹ w 3F|ý|s3tf" J9-IakGNR[\ԸE‹6{66aYU*R)'F3~q>ٙ#9 ]*Ϳ~dx4S4LĆ2μNBi@'megN UePzMaN۾ ˖oMCW^^cH4S]Bh. ptIC"P;ZؾNhvZyV窍Ǖl+;Ig Gf-yba;<P&XxL*͊DpTw!NjAB-wkOu5N0X+`"Y~d[v>JtLh>мp(8@1\D!Ԣol^:}lts Q9j ׾ЮH3! @lo1 E MXj@rWЮhL:Bkww8nn0cb [:_$,m=}DWOWQ((Fp.J9W`.Ec)B-^CE}ړ٢fC9@y=H+Ed"n\{q`W w@(g}Eg􁘉7œVVsgEEc).i9V9:@b^w˭ё*_%NGn[ŪP!zQ-+zl5QSpBfo˖2>xޤmuD݁5] <44PSpQEZU:Cs2xBFNQHug>@\ۏ;Т"4hL:VnF([Ny-g6ؓWX1vjW񱌼R Ј^-*BSpbkr;_ۙ>ڙPFvRH܏/z&Np5o=9bҿ4ڐ_T+xh;忈X=kwEEh6јt .PaZr޾|{<<2YqrmbO]FT?\+.z&NBPP̼6x( QcskVj"/PdEv%S5g5;f3ߟa>SpHL֜=ћֵJ\L_V\Ԣ*qi4@ŒZ Xoјt .P oQϾ~[I1W{#Fr%FX\(,NjA"-?t05#ss]ۙY2=i3=`YC bdinl7=br"`P" -"NjAB-מ:߻\h|4;=|5߇jۏ7s>Pbv_ % Kbe׬~f-K4& !Ԃ;ZؾNhvZYR {(qmY>H4Չ$NꤑҊshL:Bkww\8~ߕg=~t[׷_2G/4;r 0N?j9 ߠ-f"1\D!Ң5zس_f|^HP~,slՇ2kP]e]b1\;3'+>vfYzZkw^{2[lT3o+{޲M熍b+_`|$".J1\m?1f}dֿ'^+Kimg,,ZkwoiNTkQ6ݭё-h[W?(.N0coo/oc/??a{ '6^ =.CkwEN + y"V~PL4&.w/}xMjO}l^1"`.'6)zl*2nEWEaޡ։@ u"1uw泧IV o~ue|Z@as7΅y<m:L:xBэ_g=6EshXB|>yZl˶/%\|d?;~mk٢"4hL:e]w?}oO~w3={.98>`[8^o9lbR ,tC1C%OWjVj0N:Tl<0@^Z,Rlpke1uw|lޏ~ߚD߽K_~WǶŝcǶ~8>dZfag)&wrVDVp B#ߞu)^`_)YkFqunUl`*,@%1*ֳEEh~јtʺ~O=r S6W_|ώWl(|^&OVuij.4Y|Uli/ /$5R´vګx!1K2c>+XêvlQ_4&.#G_?|/ $(O~k|m3YogrS\mtzp3u _Z#ue7pLL͠^.e1uww>'~oխOυ|Obw>h|^;j/?~uob({4vxRΤz@@ufrd=2mrjvZ3kwXB:V_|<+bLZپՊ_dHt)XkQΔӭq+Ec)0;x'ǯ_0o\>S7gP<_MJ6)^uYQl|Qr#BUH @Fk,EZ <1\ITe7y`&\0b{ҪYOb{1loxiL:Dȗ}˧_m՛ݙ,MǍK|~Y3@`i.|US/I{\ >kD[Գ_=w>slU `s~;foeX `$‚32-?ĬդIK+<׸z.\~_'ontF>^^CEN\so_4rXNE##ܑhl=Q)0>P<7*U U3M#Kscs1(4c o`1Fqykh7E=kO4w9 ;KZ]ikvƯQ5';e/K-׿4& @TB-מ:߻\h|4;;vezUiUޜa}Si//R0=T 9kꃐKidLrSΎp΅)Β3kƯ$}MM1hUtCmŁ ]@k*z6olＵkc>aŽ*QAo$ Eݶ `Cڽ @ J%LĢNj P֚@00bB]&]<˽9K}~MryүQsT_rgJ" hL:Bkww\8~ߕg= @+,m9}}.((.W_"v,TH1\D!Ң5zس_f|t=ȑbP}l*l.mm\宽%"85/9꾸^w&K/ 44-ƌИ, \D!ޢ>xlQ@S"m^ kZsctnrlE#ׯND7HnϽ]0zG5g+ -D4 _8|?_{Tϓ"@ҜgE !Ԃ;szkt oAyﻴ؇̅Sp ZvnQZwc%̃0^z%,^q4$NP:UV*(I53gKS*zkޢP_Μ<ps|~;:^NPc<*SUfmyP!z&Nݲ>whXPso*J-2 =w]jocu:।1 &$uЮ&(W"0QGά^-Spj2>xuκ֬JԹ)Ӆct5׫@28@;,E*Wj.D S|[6g-]ܨr|1\!tRҏպd)CEoU401:Β`RqZ&ED+S)*E!ޢ}fcw-&Ԝj6GlОNpڔI;2\=ݛE/4(FpDoNKuxs V+5ϊOC{̄i@ؐBQמ41tڊ7^VZw4Ic|S2~l,Z; ɴ66xSx(&K5Vݥp\,ǀZ;Զo~h7.C^p٢2m{Olh<x"6jfp\I zNuhqyqrX9K ­K3?vM9ݺRyH4uge9wZ-{{nUfzub÷^}7*Z{mɿm(I/Tv^6 `ZdmDp" \pS;+?4EVxBqJ&% 桥ݹjɻMN Ls Р ]W+coٮbӭlђ*C[..\ #C͋^CE}s~\o^9NrTdHwt-)Be饑/ػDjGpPsl.0yuS0^1uKx7kQY^e\j BvPzk>TGퟧ݋[ޣf~@[u4ey@Hm_D-"ߩ@Lɿ\$}W͆(Rt =8ѦHk,wfGĩ\`])\ܡ\d~_6Ƶ&5_B4UDF^[w6~ڭw{,EW[Ve'D+_*&G5j`cs_‚%X z6@>ӿ7^~C͕ wA#;j4qL1UeaB*mz"@huE+ E kO].o>'R^E3N{BjX _ȎjNqL-<"$U# P.,c %zT%1K׸7r ٺtoAp +kͱio4:ֿsZUr&&P-t@!Ԣ]}{>O_E#m , z-<Lz"I_ `szC @Իn{lc[;;{,!~vV"ˣm%~!cJi_R{ڭwl2bnF~9[F\ ZBD\=C!0uGf_ۯ'a kckjԤR]M=ΕiW=e)h>Ł:9o"sd1zwkOu5Nd@f{Ca֋na:H#SM0)\l/[NLiJE.UevV@P7qQ~=vZq]F/|(pe4/wcP<?PUayV]9yX`g+TNj\0;.SW?b[oNaޛʞLޜFneTcE N%|M]Rj_)~"v+:U@ZmՂ `^j][rU4USkgtcwG͆ w/FavNWPuq嫒ld5yb/vFSЫ:wM!&[z5wzCk0]剄W))4.Z `^zp_V B1Ed(وttJ[#ur51ܳHg2UCI ֍Wsqc_k8cl(hvj9S[jv?R&KX~WnjXEV +ˠ?.Э"8 %SR]s(0:|j[?w. y3W欖 LݡO.)Nڍ]̭w[9|Z.PT3v\&N,g'ζj/C1U{1!,v\&NY !kw9Y gp ZB8TvV`f8`-X ?9KU*IENDB`java-design-patterns-1.16.0/naked-objects/etc/naked-objects.ucls000066400000000000000000000240411312550536300245160ustar00rootroot00000000000000 java-design-patterns-1.16.0/naked-objects/fixture/000077500000000000000000000000001312550536300220275ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/pom.xml000066400000000000000000000025561312550536300233540ustar00rootroot00000000000000 4.0.0 com.iluwatar naked-objects 1.16.0 naked-objects-fixture ${project.groupId} naked-objects-dom java-design-patterns-1.16.0/naked-objects/fixture/src/000077500000000000000000000000001312550536300226165ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/000077500000000000000000000000001312550536300235425ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/000077500000000000000000000000001312550536300244635ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/000077500000000000000000000000001312550536300264335ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/000077500000000000000000000000001312550536300301215ustar00rootroot00000000000000DomainAppFixturesProvider.java000066400000000000000000000034661312550536300360330ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.fixture; import org.apache.isis.applib.annotation.DomainService; import org.apache.isis.applib.annotation.NatureOfService; import org.apache.isis.applib.fixturescripts.FixtureScripts; import org.apache.isis.applib.services.fixturespec.FixtureScriptsSpecification; import org.apache.isis.applib.services.fixturespec.FixtureScriptsSpecificationProvider; import domainapp.fixture.scenarios.RecreateSimpleObjects; /** * Specifies where to find fixtures, and other settings. */ @DomainService(nature = NatureOfService.DOMAIN) public class DomainAppFixturesProvider implements FixtureScriptsSpecificationProvider { @Override public FixtureScriptsSpecification getSpecification() { return FixtureScriptsSpecification.builder(DomainAppFixturesProvider.class) .with(FixtureScripts.MultipleExecutionStrategy.EXECUTE) .withRunScriptDefault(RecreateSimpleObjects.class) .withRunScriptDropDown(FixtureScriptsSpecification.DropDownPolicy.CHOICES) .withRecreate(RecreateSimpleObjects.class).build(); } } java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/modules/000077500000000000000000000000001312550536300315715ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/000077500000000000000000000000001312550536300330625ustar00rootroot00000000000000SimpleObjectCreate.java000066400000000000000000000035721312550536300373610ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.fixture.modules.simple; import org.apache.isis.applib.fixturescripts.FixtureScript; import domainapp.dom.modules.simple.SimpleObject; import domainapp.dom.modules.simple.SimpleObjects; /** * Fixture to create a simple object */ public class SimpleObjectCreate extends FixtureScript { // endregion // region > simpleObject (output) private SimpleObject simpleObject; @javax.inject.Inject private SimpleObjects simpleObjects; // region > name (input) private String name; /** * Name of the object (required) */ public String getName() { return name; } public SimpleObjectCreate setName(final String name) { this.name = name; return this; } /** * The created simple object (output). */ public SimpleObject getSimpleObject() { return simpleObject; } // endregion @Override protected void execute(final ExecutionContext ec) { String paramName = checkParam("name", ec, String.class); this.simpleObject = wrap(simpleObjects).create(paramName); // also make available to UI ec.addResult(this, simpleObject); } } SimpleObjectsTearDown.java000066400000000000000000000024121312550536300400540ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.fixture.modules.simple; import org.apache.isis.applib.fixturescripts.FixtureScript; import org.apache.isis.applib.services.jdosupport.IsisJdoSupport; /** * TearDown/Cleanup for SimpleObjects */ public class SimpleObjectsTearDown extends FixtureScript { @javax.inject.Inject private IsisJdoSupport isisJdoSupport; @Override protected void execute(ExecutionContext executionContext) { isisJdoSupport.executeUpdate("delete from \"simple\".\"SimpleObject\""); } } java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/000077500000000000000000000000001312550536300321075ustar00rootroot00000000000000RecreateSimpleObjects.java000066400000000000000000000054001312550536300371100ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.fixture.scenarios; import java.util.Arrays; import java.util.Collections; import java.util.List; import com.google.common.collect.Lists; import org.apache.isis.applib.fixturescripts.FixtureScript; import domainapp.dom.modules.simple.SimpleObject; import domainapp.fixture.modules.simple.SimpleObjectCreate; import domainapp.fixture.modules.simple.SimpleObjectsTearDown; /** * Create a bunch of simple Objects */ public class RecreateSimpleObjects extends FixtureScript { public final List names = Collections.unmodifiableList(Arrays.asList("Foo", "Bar", "Baz", "Frodo", "Froyo", "Fizz", "Bip", "Bop", "Bang", "Boo")); // region > number (optional input) private Integer number; // endregion // region > simpleObjects (output) private final List simpleObjects = Lists.newArrayList(); public RecreateSimpleObjects() { withDiscoverability(Discoverability.DISCOVERABLE); } /** * The number of objects to create, up to 10; optional, defaults to 3. */ public Integer getNumber() { return number; } public RecreateSimpleObjects setNumber(final Integer number) { this.number = number; return this; } /** * The simpleobjects created by this fixture (output). */ public List getSimpleObjects() { return simpleObjects; } // endregion @Override protected void execute(final ExecutionContext ec) { // defaults final int paramNumber = defaultParam("number", ec, 3); // validate if (paramNumber < 0 || paramNumber > names.size()) { throw new IllegalArgumentException(String.format("number must be in range [0,%d)", names.size())); } // // execute // ec.executeChild(this, new SimpleObjectsTearDown()); for (int i = 0; i < paramNumber; i++) { final SimpleObjectCreate fs = new SimpleObjectCreate().setName(names.get(i)); ec.executeChild(this, fs.getName(), fs); simpleObjects.add(fs.getSimpleObject()); } } } java-design-patterns-1.16.0/naked-objects/integtests/000077500000000000000000000000001312550536300225325ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/.gitignore000066400000000000000000000000221312550536300245140ustar00rootroot00000000000000/translations.pot java-design-patterns-1.16.0/naked-objects/integtests/pom.xml000066400000000000000000000073021312550536300240510ustar00rootroot00000000000000 4.0.0 com.iluwatar naked-objects 1.16.0 naked-objects-integtests src/test/resources src/test/java ** **/*.java ${project.groupId} naked-objects-fixture org.apache.isis.core isis-core-unittestsupport org.apache.isis.core isis-core-integtestsupport org.apache.isis.core isis-core-specsupport org.hamcrest hamcrest-library org.apache.isis.core isis-core-wrapper org.apache.isis.core isis-core-runtime org.assertj assertj-core test org.hsqldb hsqldb java-design-patterns-1.16.0/naked-objects/integtests/src/000077500000000000000000000000001312550536300233215ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/000077500000000000000000000000001312550536300243005ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/000077500000000000000000000000001312550536300252215ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/000077500000000000000000000000001312550536300271715ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/000077500000000000000000000000001312550536300313625ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/000077500000000000000000000000001312550536300333775ustar00rootroot00000000000000SimpleAppSystemInitializer.java000066400000000000000000000042261312550536300414720ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.integtests.bootstrap; import org.apache.isis.core.commons.config.IsisConfiguration; import org.apache.isis.core.integtestsupport.IsisSystemForTest; import org.apache.isis.objectstore.jdo.datanucleus.DataNucleusPersistenceMechanismInstaller; import org.apache.isis.objectstore.jdo.datanucleus.IsisConfigurationForJdoIntegTests; /** * Initializer for the Simple App */ public final class SimpleAppSystemInitializer { private SimpleAppSystemInitializer() { } /** * Init test system */ public static void initIsft() { IsisSystemForTest isft = IsisSystemForTest.getElseNull(); if (isft == null) { isft = new SimpleAppSystemBuilder().build().setUpSystem(); IsisSystemForTest.set(isft); } } private static class SimpleAppSystemBuilder extends IsisSystemForTest.Builder { public SimpleAppSystemBuilder() { withLoggingAt(org.apache.log4j.Level.INFO); with(testConfiguration()); with(new DataNucleusPersistenceMechanismInstaller()); // services annotated with @DomainService withServicesIn("domainapp"); } private static IsisConfiguration testConfiguration() { final IsisConfigurationForJdoIntegTests testConfiguration = new IsisConfigurationForJdoIntegTests(); testConfiguration.addRegisterEntitiesPackagePrefix("domainapp.dom.modules"); return testConfiguration; } } } java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/000077500000000000000000000000001312550536300331715ustar00rootroot00000000000000BootstrappingGlue.java000066400000000000000000000031201312550536300374210ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/** * O * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.integtests.specglue; import org.apache.isis.core.specsupport.scenarios.ScenarioExecutionScope; import org.apache.isis.core.specsupport.specs.CukeGlueAbstract; import cucumber.api.java.After; import cucumber.api.java.Before; import domainapp.integtests.bootstrap.SimpleAppSystemInitializer; /** * BootStrapping IntegrationTesting Before and After Steps */ public class BootstrappingGlue extends CukeGlueAbstract { @Before(value = {"@integration"}, order = 100) public void beforeScenarioIntegrationScope() { org.apache.log4j.PropertyConfigurator.configure("logging.properties"); SimpleAppSystemInitializer.initIsft(); before(ScenarioExecutionScope.INTEGRATION); } @After public void afterScenario(cucumber.api.Scenario sc) { assertMocksSatisfied(); after(sc); } } CatalogOfFixturesGlue.java000066400000000000000000000024411312550536300401640ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/** * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.integtests.specglue; import org.apache.isis.core.specsupport.specs.CukeGlueAbstract; import cucumber.api.java.Before; import domainapp.fixture.scenarios.RecreateSimpleObjects; /** * Test Execution to append a fixture of SimpleObjects */ public class CatalogOfFixturesGlue extends CukeGlueAbstract { @Before(value = {"@integration", "@SimpleObjectsFixture"}, order = 20000) public void integrationFixtures() throws Throwable { scenarioExecution().install(new RecreateSimpleObjects()); } } modules/000077500000000000000000000000001312550536300345625ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specgluesimple/000077500000000000000000000000001312550536300360535ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modulesSimpleObjectGlue.java000066400000000000000000000034501312550536300421150ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/** * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.integtests.specglue.modules.simple; import static org.hamcrest.CoreMatchers.is; import static org.junit.Assert.assertThat; import cucumber.api.java.en.Given; import cucumber.api.java.en.When; import domainapp.dom.modules.simple.SimpleObject; import domainapp.dom.modules.simple.SimpleObjects; import java.util.List; import java.util.UUID; import org.apache.isis.core.specsupport.specs.CukeGlueAbstract; /** * Test Simple Object Operations */ public class SimpleObjectGlue extends CukeGlueAbstract { @Given("^there are.* (\\d+) simple objects$") public void thereAreNumSimpleObjects(int n) throws Throwable { try { final List findAll = service(SimpleObjects.class).listAll(); assertThat(findAll.size(), is(n)); putVar("list", "all", findAll); } finally { assertMocksSatisfied(); } } @When("^I create a new simple object$") public void createNewSimpleObject() throws Throwable { service(SimpleObjects.class).create(UUID.randomUUID().toString()); } } java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specs/000077500000000000000000000000001312550536300324775ustar00rootroot00000000000000RunSpecs.java000066400000000000000000000024401312550536300350250ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specs/** * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.integtests.specs; import org.junit.runner.RunWith; import cucumber.api.CucumberOptions; import cucumber.api.junit.Cucumber; /** * Runs scenarios in all .feature files (this package and any subpackages). */ @RunWith(Cucumber.class) @CucumberOptions(format = {"html:target/cucumber-html-report", "json:target/cucumber.json"}, glue = {"classpath:domainapp.integtests.specglue"}, strict = true, tags = {"~@backlog", "~@ignore"}) public class RunSpecs { // intentionally empty } modules/000077500000000000000000000000001312550536300340705ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specssimple/000077500000000000000000000000001312550536300353615ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specs/modulesSimpleObjectSpec_listAllAndCreate.feature000066400000000000000000000020661312550536300453700ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/specs/modules/simple# # Licensed to the Apache Software Foundation (ASF) under one or more # contributor license agreements. See the NOTICE file distributed with # this work for additional information regarding copyright ownership. # The ASF licenses this file to You under the Apache License, Version 2.0 # (the "License"); you may not use this file except in compliance with # the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # @SimpleObjectsFixture Feature: List and Create New Simple Objects @integration Scenario: Existing simple objects can be listed and new ones created Given there are initially 3 simple objects When I create a new simple object Then there are 4 simple objects java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/tests/000077500000000000000000000000001312550536300325245ustar00rootroot00000000000000SimpleAppIntegTest.java000066400000000000000000000030041312550536300370260ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/tests/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ package domainapp.integtests.tests; import org.junit.BeforeClass; import org.apache.isis.core.integtestsupport.IntegrationTestAbstract; import org.apache.isis.core.integtestsupport.scenarios.ScenarioExecutionForIntegration; import domainapp.integtests.bootstrap.SimpleAppSystemInitializer; /** * SimpleApp Integration Tests will implement this Abstract Class. */ public abstract class SimpleAppIntegTest extends IntegrationTestAbstract { @BeforeClass public static void initClass() { org.apache.log4j.PropertyConfigurator.configure("logging.properties"); SimpleAppSystemInitializer.initIsft(); // instantiating will install onto ThreadLocal new ScenarioExecutionForIntegration(); } } modules/000077500000000000000000000000001312550536300341155ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/testssimple/000077500000000000000000000000001312550536300354065ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modulesSimpleObjectIntegTest.java000066400000000000000000000070561312550536300424700ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ package domainapp.integtests.tests.modules.simple; import static org.assertj.core.api.Assertions.assertThat; import domainapp.dom.modules.simple.SimpleObject; import domainapp.fixture.scenarios.RecreateSimpleObjects; import domainapp.integtests.tests.SimpleAppIntegTest; import javax.inject.Inject; import org.apache.isis.applib.DomainObjectContainer; import org.apache.isis.applib.fixturescripts.FixtureScripts; import org.apache.isis.applib.services.wrapper.DisabledException; import org.apache.isis.applib.services.wrapper.InvalidException; import org.junit.Before; import org.junit.Test; /** * Test Fixtures with Simple Objects */ public class SimpleObjectIntegTest extends SimpleAppIntegTest { @Inject FixtureScripts fixtureScripts; RecreateSimpleObjects fs; SimpleObject simpleObjectPojo; SimpleObject simpleObjectWrapped; @Before public void setUp() throws Exception { // given fs = new RecreateSimpleObjects().setNumber(1); fixtureScripts.runFixtureScript(fs, null); simpleObjectPojo = fs.getSimpleObjects().get(0); assertThat(simpleObjectPojo).isNotNull(); simpleObjectWrapped = wrap(simpleObjectPojo); } /** * Test Object Name accessibility */ public static class Name extends SimpleObjectIntegTest { @Test public void accessible() throws Exception { // when final String name = simpleObjectWrapped.getName(); // then assertThat(name).isEqualTo(fs.names.get(0)); } @Test public void cannotBeUpdatedDirectly() throws Exception { // expect expectedExceptions.expect(DisabledException.class); // when simpleObjectWrapped.setName("new name"); } } /** * Test Validation of SimpleObject Names */ public static class UpdateName extends SimpleObjectIntegTest { @Test public void happyCase() throws Exception { // when simpleObjectWrapped.updateName("new name"); // then assertThat(simpleObjectWrapped.getName()).isEqualTo("new name"); } @Test public void failsValidation() throws Exception { // expect expectedExceptions.expect(InvalidException.class); expectedExceptions.expectMessage("Exclamation mark is not allowed"); // when simpleObjectWrapped.updateName("new name!"); } } /** * Test ContainerTitle generation based on SimpleObject Name */ public static class Title extends SimpleObjectIntegTest { @Inject DomainObjectContainer container; @Test public void interpolatesName() throws Exception { // given final String name = simpleObjectWrapped.getName(); // when final String title = container.titleOf(simpleObjectWrapped); // then assertThat(title).isEqualTo("Object: " + name); } } } SimpleObjectsIntegTest.java000066400000000000000000000105571312550536300426530ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ package domainapp.integtests.tests.modules.simple; import static org.assertj.core.api.Assertions.assertThat; import com.google.common.base.Throwables; import domainapp.dom.modules.simple.SimpleObject; import domainapp.dom.modules.simple.SimpleObjects; import domainapp.fixture.modules.simple.SimpleObjectsTearDown; import domainapp.fixture.scenarios.RecreateSimpleObjects; import domainapp.integtests.tests.SimpleAppIntegTest; import java.sql.SQLIntegrityConstraintViolationException; import java.util.List; import javax.inject.Inject; import org.apache.isis.applib.fixturescripts.FixtureScript; import org.apache.isis.applib.fixturescripts.FixtureScripts; import org.hamcrest.Description; import org.hamcrest.Matcher; import org.hamcrest.TypeSafeMatcher; import org.junit.Test; /** * Fixture Pattern Integration Test */ public class SimpleObjectsIntegTest extends SimpleAppIntegTest { @Inject FixtureScripts fixtureScripts; @Inject SimpleObjects simpleObjects; /** * Test Listing of All Simple Objects */ public static class ListAll extends SimpleObjectsIntegTest { @Test public void happyCase() throws Exception { // given RecreateSimpleObjects fs = new RecreateSimpleObjects(); fixtureScripts.runFixtureScript(fs, null); nextTransaction(); // when final List all = wrap(simpleObjects).listAll(); // then assertThat(all).hasSize(fs.getSimpleObjects().size()); SimpleObject simpleObject = wrap(all.get(0)); assertThat(simpleObject.getName()).isEqualTo(fs.getSimpleObjects().get(0).getName()); } @Test public void whenNone() throws Exception { // given FixtureScript fs = new SimpleObjectsTearDown(); fixtureScripts.runFixtureScript(fs, null); nextTransaction(); // when final List all = wrap(simpleObjects).listAll(); // then assertThat(all).hasSize(0); } } /** * Test Creation of Simple Objects */ public static class Create extends SimpleObjectsIntegTest { @Test public void happyCase() throws Exception { // given FixtureScript fs = new SimpleObjectsTearDown(); fixtureScripts.runFixtureScript(fs, null); nextTransaction(); // when wrap(simpleObjects).create("Faz"); // then final List all = wrap(simpleObjects).listAll(); assertThat(all).hasSize(1); } @Test public void whenAlreadyExists() throws Exception { // given FixtureScript fs = new SimpleObjectsTearDown(); fixtureScripts.runFixtureScript(fs, null); nextTransaction(); wrap(simpleObjects).create("Faz"); nextTransaction(); // then expectedExceptions.expectCause(causalChainContains(SQLIntegrityConstraintViolationException.class)); // when wrap(simpleObjects).create("Faz"); nextTransaction(); } private static Matcher causalChainContains(final Class cls) { return new TypeSafeMatcher() { @Override protected boolean matchesSafely(Throwable item) { final List causalChain = Throwables.getCausalChain(item); for (Throwable throwable : causalChain) { if (cls.isAssignableFrom(throwable.getClass())) { return true; } } return false; } @Override public void describeTo(Description description) { description.appendText("exception with causal chain containing " + cls.getSimpleName()); } }; } } } java-design-patterns-1.16.0/naked-objects/pom.xml000066400000000000000000000335631312550536300216700ustar00rootroot00000000000000 4.0.0 java-design-patterns com.iluwatar 1.16.0 naked-objects pom 3.0.4 1.9.0 UTF-8 UTF-8 2.0.0 apache.snapshots Apache Snapshots https://repository.apache.org/content/repositories/snapshots/ false Cloudbees snapshots http://repository-estatio.forge.cloudbees.com/snapshot/ false org.apache.maven.plugins maven-enforcer-plugin 1.3.1 [3.2.1,) [1.8.0,) All plugin versions must be defined! true true validate-enforce validate enforce org.apache.maven.plugins maven-compiler-plugin 3.1 1.8 1.8 -parameters source compile test test-compile org.apache.maven.plugins maven-surefire-plugin 2.16 **/*Test.java **/*Test$*.java **/*Test_*.java **/*Spec*.java **/Test*.java **/*ForTesting.java **/*Abstract*.java true true ${project.build.directory}/surefire-reports org.apache.maven.plugins maven-surefire-report-plugin 2.16 false test maven-clean-plugin 2.5 maven-resources-plugin 2.6 maven-jar-plugin 2.4 maven-install-plugin 2.5.1 maven-deploy-plugin 2.8.1 maven-site-plugin 3.3 maven-war-plugin 2.4 org.mortbay.jetty maven-jetty-plugin 6.1.26 org.apache.maven.plugins maven-shade-plugin 2.2 org.apache.maven.plugins maven-antrun-plugin 1.7 run org.simplericity.jettyconsole jetty-console-maven-plugin 1.56 org.apache.rat apache-rat-plugin 0.10 true true **/target/** **/target-ide/** **/*.project **/.classpath **/.settings/** **/*.launch **/ide/eclipse/launch/** **/ide/intellij/launch/** src/site/resources/ide/eclipse/** **/rebel.xml **/*.gitignore **/*.log **/*.pdn **/*.svg **/*.json **/*.min.js **/*.js **/translations.pot **/translations*.po AL2 Apache License 2.0 Licensed to the Apache Software Foundation (ASF) under one JQRY MIT Dual licensed under the MIT or GPL Version 2 licenses. JMOCK JMock Copyright (c) 2000-2007, jMock.org DOCBK DocBook 4.5 Permission to copy in any form is granted for use Permission to use, copy, modify and distribute the DocBook DTD is hereby granted in perpetuity, provided that the above copyright This is the catalog data file for DocBook XML V4.5. It is provided as XML Catalog data for DocBook XML V4.5 DocBook additional general entities V4.5 XML EXCHANGE TABLE MODEL DECLARATION MODULE W3C XHTML Copyright (c) 1998-2002 W3C (MIT, INRIA, Keio), Apache License 2.0 MIT JMock DocBook 4.5 XHTML org.apache.maven.plugins maven-compiler-plugin org.apache.maven.plugins maven-surefire-report-plugin com.github.markusmo3.urm urm-maven-plugin ${urm.version} ${project.basedir}/../etc com.iluwatar domainapp naked-objects naked-objects-webapp org.apache.isis.core isis ${isis.version} pom import org.apache.isis.viewer isis-viewer-wicket ${isis.version} pom import org.assertj assertj-core ${assertj-core.version} ${project.groupId} naked-objects-dom 1.16.0 ${project.groupId} naked-objects-fixture 1.16.0 ${project.groupId} naked-objects-webapp 1.16.0 m2e m2e.version target-ide dom fixture integtests webapp java-design-patterns-1.16.0/naked-objects/webapp/000077500000000000000000000000001312550536300216175ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/ide/000077500000000000000000000000001312550536300223605ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/ide/eclipse/000077500000000000000000000000001312550536300240045ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/ide/eclipse/launch/000077500000000000000000000000001312550536300252565ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/ide/eclipse/launch/.gitignore000066400000000000000000000004641312550536300272520ustar00rootroot00000000000000/SimpleApp-PROTOTYPE-jrebel.launch /SimpleApp-PROTOTYPE-no-fixtures.launch /SimpleApp-PROTOTYPE-with-fixtures.launch /SimpleApp-SERVER-no-fixtures.launch /SimpleApp-PROTOTYPE-jrebel.launch /SimpleApp-PROTOTYPE-no-fixtures.launch /SimpleApp-PROTOTYPE-with-fixtures.launch /SimpleApp-SERVER-no-fixtures.launch java-design-patterns-1.16.0/naked-objects/webapp/ide/intellij/000077500000000000000000000000001312550536300241725ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/ide/intellij/launch/000077500000000000000000000000001312550536300254445ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/ide/intellij/launch/README.txt000066400000000000000000000023461312550536300271470ustar00rootroot00000000000000==== The MIT License Copyright (c) 2014-2016 Ilkka Seppälä Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ==== Copy into workspace\.idea\runConfigurations directory, and adjust file paths for Maven tasks. java-design-patterns-1.16.0/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml000066400000000000000000000050521312550536300315470ustar00rootroot00000000000000 java-design-patterns-1.16.0/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml000066400000000000000000000044131312550536300331020ustar00rootroot00000000000000 s java-design-patterns-1.16.0/naked-objects/webapp/lib/000077500000000000000000000000001312550536300223655ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/lib/.gitignore000066400000000000000000000001361312550536300243550ustar00rootroot00000000000000# # explicitly ignoring Microsoft JDBC4 jar # (cannot redistribute, licensing) # sqljdbc4.jar java-design-patterns-1.16.0/naked-objects/webapp/pom.xml000066400000000000000000000246231312550536300231430ustar00rootroot00000000000000 4.0.0 com.iluwatar naked-objects 1.16.0 naked-objects-webapp This module runs both the Wicket viewer and the Restfulobjects viewer in a single webapp configured to run using the datanucleus object store. war .. org.mortbay.jetty maven-jetty-plugin org.simplericity.jettyconsole jetty-console-maven-plugin createconsole ${basedir}/src/main/jettyconsole/isis-banner.png ${project.build.directory}/${project.build.finalName}-jetty-console.jar package org.codehaus.mojo build-helper-maven-plugin 1.8 validate maven-version maven-war-plugin simpleapp false ${maven.build.timestamp} ${agent.name} ${user.name} Maven ${maven.version} ${java.version} ${os.name} ${project.version} WEB-INF/lib/isis-core-webserver*.jar, WEB-INF/lib/javax.servlet-api-*.jar, WEB-INF/lib/javax.websocket-api-*.jar, WEB-INF/lib/jetty-all-*.jar org.eclipse.m2e lifecycle-mapping 1.0.0 org.codehaus.mojo build-helper-maven-plugin [1.5,) maven-version ${project.groupId} naked-objects-dom org.datanucleus datanucleus-enhancer ${project.groupId} naked-objects-fixture org.datanucleus datanucleus-enhancer org.apache.isis.viewer isis-viewer-wicket-impl org.apache.isis.core isis-core-viewer-restfulobjects-server org.apache.isis.core isis-core-security-shiro org.apache.isis.core isis-core-runtime org.apache.isis.core isis-core-wrapper org.apache.isis.core isis-core-security org.apache.isis.core isis-core-webserver runtime true org.apache.geronimo.specs geronimo-servlet_3.0_spec org.hsqldb hsqldb org.lazyluke log4jdbc-remix org.slf4j slf4j-api self-host org.apache.maven.plugins maven-antrun-plugin intellij idea.version org.apache.geronimo.specs geronimo-servlet_3.0_spec compile jrebel target dom.simple,org.apache.isis.objectstore.jdo.applib warn org.apache.maven.plugins maven-antrun-plugin java-design-patterns-1.16.0/naked-objects/webapp/src/000077500000000000000000000000001312550536300224065ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/000077500000000000000000000000001312550536300233325ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/java/000077500000000000000000000000001312550536300242535ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/java/domainapp/000077500000000000000000000000001312550536300262235ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/java/domainapp/webapp/000077500000000000000000000000001312550536300275015ustar00rootroot00000000000000SimpleApplication.java000066400000000000000000000127341312550536300337110ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/java/domainapp/webapp/* * Licensed to the Apache Software Foundation (ASF) under one or more contributor license * agreements. See the NOTICE file distributed with this work for additional information regarding * copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the License. You may obtain a * copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package domainapp.webapp; import java.io.IOException; import java.io.InputStream; import java.nio.charset.Charset; import java.util.List; import javax.servlet.http.HttpServletRequest; import com.google.common.base.Joiner; import com.google.common.io.Resources; import com.google.inject.AbstractModule; import com.google.inject.Module; import com.google.inject.name.Names; import com.google.inject.util.Modules; import com.google.inject.util.Providers; import org.apache.wicket.Session; import org.apache.wicket.request.IRequestParameters; import org.apache.wicket.request.Request; import org.apache.wicket.request.Response; import org.apache.wicket.request.http.WebRequest; import org.apache.isis.viewer.wicket.viewer.IsisWicketApplication; import org.apache.isis.viewer.wicket.viewer.integration.wicket.AuthenticatedWebSessionForIsis; import de.agilecoders.wicket.core.Bootstrap; import de.agilecoders.wicket.core.settings.IBootstrapSettings; import de.agilecoders.wicket.themes.markup.html.bootswatch.BootswatchTheme; import de.agilecoders.wicket.themes.markup.html.bootswatch.BootswatchThemeProvider; /** * As specified in web.xml. * *

* See: * * 

 * <filter>
 *   <filter-name>wicket</filter-name>
 *    <filter-class>org.apache.wicket.protocol.http.WicketFilter</filter-class>
 *    <init-param>
 *      <param-name>applicationClassName</param-name>
 *      <param-value>webapp.SimpleApplication</param-value>
 *    </init-param>
 * </filter>
 *
* */ public class SimpleApplication extends IsisWicketApplication { private static final long serialVersionUID = 1L; /** * uncomment for a (slightly hacky) way of allowing logins using query args, eg: * * ?user=sven&pass=pass * *

* for demos only, obvious. */ private static final boolean DEMO_MODE_USING_CREDENTIALS_AS_QUERYARGS = false; @Override protected void init() { super.init(); IBootstrapSettings settings = Bootstrap.getSettings(); settings.setThemeProvider(new BootswatchThemeProvider(BootswatchTheme.Flatly)); } @Override public Session newSession(final Request request, final Response response) { if (!DEMO_MODE_USING_CREDENTIALS_AS_QUERYARGS) { return super.newSession(request, response); } // else demo mode final AuthenticatedWebSessionForIsis s = (AuthenticatedWebSessionForIsis) super.newSession(request, response); IRequestParameters requestParameters = request.getRequestParameters(); final org.apache.wicket.util.string.StringValue user = requestParameters.getParameterValue("user"); final org.apache.wicket.util.string.StringValue password = requestParameters.getParameterValue("pass"); s.signIn(user.toString(), password.toString()); return s; } @Override public WebRequest newWebRequest(HttpServletRequest servletRequest, String filterPath) { if (!DEMO_MODE_USING_CREDENTIALS_AS_QUERYARGS) { return super.newWebRequest(servletRequest, filterPath); } // else demo mode try { String uname = servletRequest.getParameter("user"); if (uname != null) { servletRequest.getSession().invalidate(); } } catch (Exception e) { System.out.println(e); } return super.newWebRequest(servletRequest, filterPath); } @Override protected Module newIsisWicketModule() { final Module isisDefaults = super.newIsisWicketModule(); final Module overrides = new AbstractModule() { @Override protected void configure() { bind(String.class).annotatedWith(Names.named("applicationName")).toInstance("Simple App"); bind(String.class).annotatedWith(Names.named("applicationCss")).toInstance( "css/application.css"); bind(String.class).annotatedWith(Names.named("applicationJs")).toInstance( "scripts/application.js"); bind(String.class).annotatedWith(Names.named("welcomeMessage")).toInstance( readLines(getClass(), "welcome.html")); bind(String.class).annotatedWith(Names.named("aboutMessage")).toInstance("Simple App"); bind(InputStream.class).annotatedWith(Names.named("metaInfManifest")).toProvider( Providers.of(getServletContext().getResourceAsStream("/META-INF/MANIFEST.MF"))); } }; return Modules.override(isisDefaults).with(overrides); } private static String readLines(final Class contextClass, final String resourceName) { try { List readLines = Resources.readLines(Resources.getResource(contextClass, resourceName), Charset.defaultCharset()); return Joiner.on("\n").join(readLines); } catch (IOException e) { return "This is a simple app"; } } } java-design-patterns-1.16.0/naked-objects/webapp/src/main/jettyconsole/000077500000000000000000000000001312550536300260545ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/jettyconsole/isis-banner.pdn000066400000000000000000002100321312550536300307670ustar00rootroot00000000000000PDN36 PPaintDotNet.Data, Version=3.510.4297.28969, Culture=neutral, PublicKeyToken=null ISystem, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089PaintDotNet.Document isDisposedlayerswidthheight savedWith userMetaDatauserMetadataItemsPaintDotNet.LayerListSystem.Version2System.Collections.Specialized.NameValueCollectionSystem.Collections.Generic.KeyValuePair`2[[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]][] w   PaintDotNet.LayerListparentArrayList+_itemsArrayList+_sizeArrayList+_versionPaintDotNet.Document  ASystem.Version_Major_Minor_Build _Revision$q2System.Collections.Specialized.NameValueCollectionReadOnly HashProviderComparerCountKeysValuesVersion2System.Collections.CaseInsensitiveHashCodeProvider*System.Collections.CaseInsensitiveComparer  System.Collections.Generic.KeyValuePair`2[[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]System.Collections.Generic.KeyValuePair`2[[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]keyvalue $exif.tag4D $exif.tag5/ $exif.tag67 $exif.tag77        2System.Collections.CaseInsensitiveHashCodeProviderm_textSystem.Globalization.TextInfo  *System.Collections.CaseInsensitiveComparer m_compareInfo System.Globalization.CompareInfo        % & ' ( )PPaintDotNet.Core, Version=3.510.4297.28965, Culture=neutral, PublicKeyToken=nullPaintDotNet.BitmapLayer propertiessurfaceLayer+isDisposed Layer+width Layer+heightLayer+properties-PaintDotNet.BitmapLayer+BitmapLayerPropertiesPaintDotNet.Surface)!PaintDotNet.Layer+LayerProperties * +w , - .w / 0 1w 2 3 4w 5 6 7w 8System.Globalization.TextInfom_listSeparator m_isReadOnlycustomCultureName m_nDataItemm_useUserOverride m_win32LangID   System.Globalization.CompareInfo win32LCIDculturem_name9%System.Collections.ArrayList_items_size_version :&% ;'% <(% =*-PaintDotNet.BitmapLayer+BitmapLayerPropertiesblendOp&PaintDotNet.UserBlendOps+NormalBlendOp >+PaintDotNet.Surfacescan0widthheightstridePaintDotNet.MemoryBlock)) ?w@,!PaintDotNet.Layer+LayerPropertiesname userMetaDatauserMetadataItemsvisible isBackgroundopacity2System.Collections.Specialized.NameValueCollectionSystem.Collections.Generic.KeyValuePair`2[[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]][]@Layer 2 A B-* C.+ Dw@/,ELayer 5 F B0* H1+ Iw@2,JLayer 3 K B3* M4+ Nw@5,OLayer 4 P B6* R7+ Sw@8,TLayer 5 U B: ; < = >&PaintDotNet.UserBlendOps+NormalBlendOp?PaintDotNet.MemoryBlocklength64 hasParentdeferred )' A ] ^BSystem.Collections.Generic.KeyValuePair`2[[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]C>D?' F a bH>I?' K e fM>N?' P i jR>S?' U m n]^abefijmn  x4P1 _`qxI  x4P1 _`qxI lx4P1 5`$xi#'x4P! A`g0X,x ab1Y<,#x'6E3^iy \8SXy}q\e޶=+?.y~>6\(?vGr~=+?C"za&EUq6m r#x4P1 7}V$Trtox4P1 7}$T'3x4PxGg|{䜔39;M093E,9#`L`@cF(>H3=W 0 0 0ybX,bX,Uu_8pL/,\>9 pܡvbiu򉔇nW~!biu)VF=!^=bX6bЋbo˗|,^?F.Giw~b_Xe-0&Cb_cϱCx%7f{; H?{2bXq嫯XM鎈yhy8]6-۷?X,˽?߸ 3<E䂁xAEzT<1b˟%/4<;wD*jݎ\?r/mQ !j`'G+k'dt۴a`X,8٧xs@HbPRYhqhfX5,^7oB#6=w$ 5#%!jŇv]?͵cb`Dˀ_OAT:#'b3\9.V~Iz3%$oHb?=zu67"HX2?X[|2-,Ŝ]pWIxVO'uI@KJ,䏒s</ H(L8F?cXbWqc%F h#+`!'U%᫒p*R~1E:_KFK(/8}ǏA2ޱt.b Y-CM pMݗtn kג$%$s$)yZGqV^(" ^K?8?IfJi;;w8DhUBCy,}k,4KOkply-Fƭ٫-@Q_r庤봇U %"|+e+j!]~p\4O}q_Q"JzCђQTVc%dA" 0Mixk0A6#d:rΈE|UAy$]s]Nw ۮ9,Q5'|<\?pp,d j%;F)䱬X dF/T AڡZn57߀bON}I9ΉN6,I^ќe[憎ͽ09O$/: ?(:c " ;VAc6XB8<D`sQ@n>l/t<.h"}w<>k(yK@s>8Xn%d{aT>o$%%TA3(ɮ?.^0Xz(T[5UWIXA1<2[C`\Iֿ"ڎ?[lPS(4JoW>on6V.)OROXuxJAς4 2c8.cI:3;#rD%Z$6b7@g ( B ]?T^b[.p笎\Z=V>9X򎤭=obG֐P 2qkѥwD=2遰bMxq~EzEg|"C /- Ç}:n?nCW@IsIc%,['ͽ5XOr?IsQmuqq%I1v!hBWZCP"<~9:o?V /Oo6!zUYz?<yLRH/͑ɯ~ y]m)Me9{(KψCLx!?h>sV0iɯII&I$ rOf|Fs@:Xk} &qaVyZI1WL퉨=P@n;ps(2dx8//|>/¬ݰ+qtaJKG7i漵?HK$K~v}{5籭#%տ?Иq!ڬh0Ǎ9W3$gy 0#*P#gUs$ XщCaXDt"mSQHzB]\c({!CQ1HW: .77 w>/[I񂤵0vq6YNS{S}KSaָ\\VF:';]VZh03=V|9|waֈۍMͧc,zL{:4*]}sku{IwNWoܻ5 EUcQkd4 CT]1Q tF/DNbx}b6 ?Ιc ?J>o;׷:^?(S%i]cڴɣv%% ݚO^~s!~V}{j?$%rҳ?RO0߹ӒWnp{i֑ۉxȎ81gM_N‹5Ä(2X4F,yldx^3]3Eͻi8pShLESLyL4)>?BD}P$n X1W\11R;^i 3?rHsSPk澩x]gjgKzf(/F8NmJvxئb-D~Kk/7暮D6KK>|꿬 !6q8XrmmI^l"\ñ%:/9(R>ĭ9^3j Hf"=fHVt0EX2e-E.G7\-RqMy\Μꑱ g^ewyQڦy]!oZwrܔz/ K"-uN w䐄[ӾJ9@9o uIhNt2ň?h#J FČިݦXm(,KG= j gqj?DIu@?}KsPw.uW a'` U-z0vb=mㄙ>&9#hOG6$>L{nagn;BܼyB'&L9<=f?ls^|X;mq䀄['sԟȓ/uGQ{3x|UļuB@$Ο0rU%@7͟|\3c*a Įsc.aԄ[3.1x ObaM9dyOIM;DmG}1˶^SG-a5:f򞊒%W5Y.<Tݯ}>Ⰵ`?%OqPNf'=_=gHղyϳmsϮ"}5tkvh<_枡bcda(Q9)";neG)AcQG Guu@3MԒAVK""jOSPnsť_v\W]Vĥ7Pbדx;Z$MF5wdc)Ù2?h(6{v%VA KKog<kA5潱^TU)j;]CJh~ɚPo6O /uqDuJQ=VGB杫肋j'j8+Z{Yo꼹wWZ8Ar|kŒ^C:7 ;!(~>]F3o<^ ;qmtHjƙޱcAm3<" @Q,EeAQj}#b5ьPJz'|xQ#{mG-(z -F3Z"FT(Yf *oÌ?}5xƮuy?]^ּ7Vx/mcsoSf;y=寞ռsn<ڇ`fϵOIC7fq/WI|Iֶ@}[k~wV?ym;":&kG}Ngҍ{c{n_J^?VX=ٔftmQ\Ӿ{w1uC2K卑u:횃z;cM0֯?ƌEpe({U{zrH1EeQ",㌏6H (b ›/FSP)zE Q,8_HzbT]w; ںq7J4ؼbQ7]jn>]v6ja\s_i#]ZS7M{5Y}ɪ|ާŒMhH<&KC}p>YT+M8k}>eWŒm;6 }Nk{Aye>k"sJBkG>WHޙWǡ&yxQ+m0UuAP>CɑPzCR4=8c'aFQEqZGgmwLTLBHù?cP\J!b!KJAI(D;jn; A$KxFPSbׅҷ6/Skzq,# H^f;yմzY#ENhgz|Oxnj*9[:|0Óy+ ,&24nLc9^]GZ=))̹ivёOfBwq|mК1 05ڱA3ıyuw䑨:o^0]Wx3(!ԘPz#?<(0bo%sIz3E{QVi 2&|%eNva􌥦ReG? 81Ƴi1']NȓFzqgR r}!"b/ftnmکbnԶF\XGFد[B߭qaVmsVc4߱C[lj(I~O^b;ok.)XPa5f.vWc-׆]r 3ٚǽ{ouI?jABIM-Ƽ;Dq_е.ۯiR8>tԆ|˪@u.):8rX¬ծw嶨@HGPuϡk8>C!Zص:WƜ]CulSxFZ'cqb@#Pk yŇސ yXoŇFAJϸ = w;#ZAD+f|CpF{u.vhA:ooC^GQlpJBǕf/Goj*G kQ[>Gvm0wͱ'԰yy goެgHmM"Uk_߳.5gwփcs/9t^imGj{wYE;rX¬'3ۣ, }4rǺ1aZ3[Œ'ՙP.oN5gy'fTTuFq%\@1P&N73SE^D^'QQ7jù9 ʶ=/L؄-xBH8Huc_dsd-Ӽ`^H{N!Wƹ~\o_4G0{1>!TDc'ɴ>R;U{@硐ʳw9;n'̉PվUqy帎h^G'Ŗ$gؼl\\zkơґxiDD]RPr(13F~QQ7zE1 l! CSDX{eH?(R}ko=ky_wwZd[fX8'1.o4q۲6>/!Ӹ匬^U|9; 9e~=W5 p~uym^M2!i}P.wKs|vn<\[םк.FQ0GMGtJ .=*JN"[*[ MZՆ_EOAD^n]C?^zuZJǮ]?/h)%r'a^NhCy_TmWVkSBs>m-0wER{WHk8&k[K^pG?RWXb Ѹ 뿴yyG;]EPG?guw=!1wG}){(ӭ@Pz9]WM1Zx?~kG.?#VފK MA>Pb%{ =rmX G%"$blSS>DƤ#~^ؙg /-[Ǿ}g?gy CN"@Xn|MmChCV'p}fz=#O Y֦ɺ-+ר>"2w/X;P={_SBwo{MW?@ɤaufm?{i ɇkM \Y %̜];BqM]:Ltà<ņ4~Vyw\L=d>|_UtIK9s6D׎0L124TBxO"<jըGM:?1\?nܸ Ö^x!xDZ^?%nDԮ5k-C)\+dLB e["=&Ԧ%y Qr#+&'?ir&ϊ VXd{lƺ&e+,0櫗1/KB yꚣ1n Ku>h߄l];3#PN޺f5ٶR#I:o<+'Vw]g[2EϪ!w=,̱%S[#Wu&c yUu;z\&a>_Su:>=Xlgx"SN!-m+,\Cbv71yUlM"%ј֤26IMkaB:״F7y#aM 1q#i=?hnڢ{оAWy'ZFo û ǛGൺ#rѨ[} jUj1cP9r,#"2|,"!,dB%!$ IAk*G2QRR1p&Z|)x$a}ںŒAhM–ּjC\ǗXۇflpPo1[a)_GRluAqFϠZ-7Gynn Au>cȎ?:T#鹴Q CsK'd)H15I~_oK}yy Q~|0Aεɲ{êM)9:~b\}%.];aA.հ}0v Ɩa#;zgv@jpl ðctvX6Z",nU E%,hVsV43azLiM"$ Wj\߯Ajb@۠>by z|ھ>zx!_ou:-VQî;Isڳ?~MrSy ֚m_5'u䑄wPh2 zN)Od3׮eP[qVʿz"m4a>FWkj%8|0ǴVcqS𲟠p[{fgd5[n҅sؕaŠK ljxDCƾ~1۷2>1]DI)&iot9(=gC'0C>B`FDA ҃5'yM+ If6.钩WF1kXĎUfPc]<ߪvGI{5Ɯ  i\9~[[tz\Wr4fDϼq#l^Ju<5A,%ɣKy0pWM9۩{K:o9}ÚD(w*w,6k6䤼]~:>;~ ;'cy\$ !E%Omx!;cDam#=G"t%/^O6tz:)k;bduPB,emM`$JYQ d|$ $ –ug|ܶ6 α\mT[g*v9_]8?~Rj(I˅\0cG\Q#OwX5+5vy(jwK}5>;zce\7$u%" /Y>[I0s 5Dθ|+7>_]N sA׿I~"#~yMBqvcc?5X#?Z;CyG+*cO'œq|vk)ܾ sO8^ xG_;85JKΝoÑ},lC?Ų28HB1aK.w,dr=L06!H{5j?2J̓,S$yFu4&gsX|򐿩{r49(UTgǑ|‚e$%e\Sol֍}xJΐr@2qlb#l`sqD ,+r?ŏuN%GS=ķ^]#ʠWQΈ.?;bŬј߯ [E`·:\].}jw72]dJ=2Grz ;&~ey?c :X,Eygy%ϝb(6fi>Gyc6XqsWvг1niF?\}6bX./VZ=ԕpD'PWsZJ/ih5Wqp\޴W6QbX.pK+;|k#aD{LoSS`ea9,j^K> 0梛a?nq8o WW]q|ȸ#Us?X,VJn߾/$dZAiLmTMKoXqdB#lf~Akк^M5o0bX9#m'¬no#q(&4()0Ycg9m(v } 7==H?W s~<=Esџy,KNQOJ]ǎbmb< -aܻe1KJcV㲘+c"J&vY?w~~bX+J߇I ߿%ZVwa%1e}K]$Ӷ?X,˭ [4Vrڶb`LBbAXbX'J6*13Jb`X,zUߢx{?X,˽vU,^zX,{bXb{:o/ =,bX,bX,bX,bX,g/ 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0~|#x4P1 7}V$Trtox4P1 7}$T'^x4P=hSP*l J v!E qa BAUf MԬ•NF. ).BE*BJNw}c>YO޼s{fܹwwwW(i5v+l^g 6υ?zei94iӺ_=ѤK7;tc2Q]e}!ZI+]c ݲgyޟmϴ^(g)Y!OG;18o.وpr?vl2}Iŏ78.۴K~ƾO8?Vi/ڗw[<P̺/ڴu?wC:knZXh.qi)U{!=ĥy ?z G_x|7+^N M߽k<ۙ^\6_rs!TL%~퇘|vyRV[tϝqI=~/Oz_/l{z~Moc:ݹB6ut-^ W+זn~2\U<Qsg߷{leӖ+\Dg嵜z7s^$#[^׹,]sUWvIi~_|6t $_>}&XYj:u#7nJ O_|ٜ;'ّ?@W|wy|M#.e4n޸]9\!Gi7׉赏7 뮞;c 5t?ep͌ƸUh W8z%o+c=k#?m۴u.i1o'mmqckfy i}{!~|k1֧Jfi,M~?f,}QG )m'qW7 xjҖ7+ܱ2)s>3PM͗z( gtRy6AATLپ}{ Te 6&M"Hγ[O-l?}/|+36c\F;>~#:D>L!~Ty${ww7}uN !"~?Zqyuz={6t2ѱC}> }3NIl"m;s/nR7p.F}߼qGU7m) ._c|)m^}?;h ?RYG1ShWex ?sצ.lgT3g~hjm$G\G)~CYiVϴx̩wy1cD}f 8dP㿅ziK(qz5ek؇KR{Oc[[RcJɎ 遴-C/u=t}F[f)]?>7e4MP> }cƸgCu_.~֊y`ɠ ݆>_u@W+Iiuq,8|Ԧ>,'#;.MӾeCQs}鐾nds'6JT$mǡ_Q^ǶD9|} qJ\WW?"y$V,˥2;oQ2иOZUr(KoWG8a\B͇h}6߾}ts?\!4f?y5pɠo_5,m_!~R=:Iσu$)Gq=7v84.]_yu)1v//= eK^szf훾t i禕_=J]e.χGo8Ue0.t赮౴u~:3e56VKa=7v޾?nȍZ;З]^흱/[Loo(q-g8j^['ʧx,)ׯr'W܎n 3vmǗ},qx#5c-~q og~|%ɜEsU&(Ant7}GzW?5=eN|jeȔjf{o?}Uu@+SKsv'lݴ/%> cNivul"WҎ^I(WtǙ ,쵷2KK~:ja+g'gH=qe5_et_Hw lb.i6Y ͆L ۫]Dh"{ŏyU/R#x4P1 7}V$Trtox4P1 7}$T'#x4P1 7}V$Trt+x4POhW{6´q<l-D=Cn-V^y&1G&Z64& hf<i" h:44Z0^NSGݪ϶dwAuֽ[sB!B!^> .7 ' >}6 |nlNCοV+<, 3O n6yo=[HL0ZO?'a]:w`K~ʚ(Oew8\!Qkwm<σƎQ%](XEgN}6]ŋ˸>8GXω۽|sAeKµ1w(yq}d쑵}߇ߗ6(<9̧d[S\OSxyܣ E߱. "=t37t;k2zvUL)n$WFXW߁<h^ qu&mq7stswG2C;V͋'m@O9Ho}d~/KнI!īu:f)}˟_ɔ c!<@Nz?jJQ[x?AѪ5n&邗{ex*nz̦>X56:4o:{vX7K(~\Cهݛt\Ϧ99 co{P̚{ҥy}Wqͥ2WHn%rv)١8:h*GlU^9=wڋ9]kw(#Ci{k)W!b]Zj9}~msԪHin:}J}e¾^AV:Xg8sw)}j_ ~KcP;gb(Ixv;˶"{U|v6ԫߋdq;g޵ |nml7V!9'!_+BCsB!B!U}jg(.3/KrBq`/VC\ g^\}]5B潎ѹ>o7>3^ItV?kxD|Fs쳾BXLSuHys]ɯH|C|G('~/Bc׾N$*C󸊸o12{}?l;2}a>hRڏc!u7){ᙕЇu&7?5п~N2FoSz2qSAB-[[xk1us?Le8Prh[_oyH~N^o!^o3{V+1'_} F|u/넰zԐd]N3'i|̗q?c_s 5eu_k_kw睊MkRB۞f\߳j'}5>}.;R'տ_Q~Md 1%䮣|}{+#~<#^w~kg-,k!o)퍵ya\oˣ旘DWny=< v=o<2FB!^m,|󪍑BpZ冸_Qd/Xs ,q=w;9Z[e;ׇ!~SfCCtt칂}c۪V; o(/tPC% /(k>a;<#p]?A qFjc.x<l?[p_RڅU; ;yCh'G ^B<ō;NP b=r~LC-=|B߇ߗ;ޠA*M5T:W=[]Ѕ' "=t37tk2zvUL)n$WF 0߁<h^\/CMjߛ9JxCx\+5G .mygDΒinDe#B=ӳKލ߹뗟#|VGF"{zϬ3em[eJQ0Ft[g6lUs5CkT2N~FvrUyЏ<(H~Eyz;.-;CϹcոf&p4SWP}l`fanwN7}K:~ªq?U#m}!2{Ntkg\˜u߷0vƱʬ묱']Z *]\TujVHn%r: 08::*GlU^:ŻbmsV5mUc^j}˛jkl'k{ ?X!^.Zzmt˾U35O,:Tvxa@:?Z={~E893VٓeulkPSAF{Pe z<ށL?*ku!qpd7O7G{utij#JWulT2dLjFrp¾VBkg>j/7Fg[?}Jk::s>i~usrާ)d?Vs&Fk/RgQCzl+<_g5:;յg=K:|( < 9yǂd3u嵐NnkX>B:B!hI!8$B!B!8,Cns2mtv9d]!^7|!qs}<^73뼇 kBF[=hWՐ=|w3cݛΉKJC:?a'_ɏ\(/O8]:Cn5~[}[m:s|$ߋx>JӹD'3" S=72y"uc<#s?}u{+<؏9jݱF;}{0}%d0VO?./o<ٿHQ>z#vB Û_~t`L&n }~̓>]IH>>9"oYH_~"Ohe5W*7`wdueȧow:¾G?{c՜B.Vͷ:}B<1VC~˖;\' )MkF?o`E9fGe[ms5I/yw V|ܐa/aNJiJ $-mkcj_᡼ ;V}@}*qա6q9|ަϋI^gZBZ;X/U~sgG u7nя/^yX(acgC>'IXg9['}SRt?u7m|h߰9d?0iz{2̈́i͞r sҪi!ٻ&?@ש=ܗ?6}c.ٝY/y{Aw{@|?{C;-x(~3d4n&%}4`*nm<5*BQ.{qo#ߐe=b٩^p(o3?K-[軽} 1{sB!B!B!B!B!B!B!B!B!B!B!B!B!B!B!B!B!~?Z+7X+ ,, G\O/g;9Z[e|W_`4<-+io!?3){!u7*xGڙ+_ߎB@5]/X{& Sx<:luQkwm<σƎQ%](XEg(~(;L,ikM>B{W~!5+Ww$lQO!^ #?~_ۇؠx|*M5T:Wb OE{+{Hf(o˯)w9Oz_UL)n$WF\}$R[]6{q36Io(p=wvf t}/-m֨_{+(]: S{Dz>MuBS[9Ho}d~/KнtnoAzVFm7E8B{AOΒ9Kvl:m Ĺ=IϺHm1>^9I Ԟ^ 8~52m#.c8A8&,Co2-Z'>y+2Ҹa 1(I\']M7jᙤAѪ9SV_;2]3yL\[0'lZ}U~&i._z/X}tViiz ngZ3LaIw]/nI^1U_>$N'!Mc=go*f?3Gt2 WqY5g2fYR} g?`>3l@2yĶZ%P)@xUP6ڜ}{uN8ok^/ǖO,RjrY5MYuϟĹ;JuzD{鷲^|e "nμGZ{KZw3q}\[T?ݿX}~H6-uNf:/KV!īќB/s]B!8$B!B!vHiPaȝ)=#K3_OǕ] i\MsYCnB&F~l}Cw{M1H[,¾J݇\?!`#:Qldg5?=]s\D9? {>;!^_έq5;Ґρcz>K~Ӝ KJ_y^{ٻ3qgڹ9z6=O,-Ϗ~71vH7H>Y5?bVolYw6i"Xz!.iNWMw|*φUgw?ߣ o7W >X}_ȖjwsY! <}ķZA"?! >oDmP/Z/zmɊ5*I“V=M[ H?9`^_G${g^>nFȣ^lw&W ]~q!n r? i3eD_mֽRThϼ~-Cѷs);ؖ4\X/'Kv;WOE?ٺ7K~6]Ot|.cxvQG_1mf<:[nv3~)}7Z~c|G/%=3ѐ_[c?XVr#}r~da_}uku|j޲ ?wfUxVw8mTro۰˨G_?&tkܪkYt<ǐٰ}g}У={ |ß:l}"Y) '=Ze$˾MuM#Ym߀UGzc3jD]b_8z}zmvhxݰZ ~e:q !:颴tWK>gӜM}g>⳾^wW|i /eX'׼Dm7Yq=Osժ}{G'>6I\j]ź؟ªyV}ikzgi=o[͔?6n6>otG˴voOב;Nֱ'&_Eyܛg͞X E|gdf|7zz}YK{}jf~B,i| Rikx&;{3Sq7=Ӧim?~/|Zx^'!6]Bc:!X?B,B!B!B!B!B!B!B!B!B!B!B!B!B!B!B6& v|Tlj9N|i ASBWB,{UfKן33}  k{Ucl?G Bgѯv;R`ໂzbg.7Sz*F/( y<=w c!?3ܦz<&iz.|r}筆ogm|n3(<wna9^,JuZ!D|:tP}辏p=S+S"ݜrt'A6bA>(X.ۃ+xn6a^2ST0ddz!| eN׿9q}.No _nxO $4dq{:^|s'o4ߤpAﳐvA&[埅8֏]z z󤻯E5*m]k萕7ak~SOB#Ɔ&F-Y͆=8Cq~o8;ø}x;;ii2Z%j^ӳ+l>?SkpuCQove/\&'3u>.P.! !y.K}4G zx 5}R<ݹ&_&C^jm{ nuu ^.wA-@0䛧8_huêuٸ?osVE1Kt̪tt˼1侩ue|0\GD:駔fCYóG;圠43lXt!n:J5(sSۖQV76 ەYOtn3>|F]s \_B8e-ZO0]Bц| #9Oi@ P:'ӹu&ښ kB!^=߭3kKBu6wVqi?B!B!uΟ4A<3 ػ9cyL^2 N |9YNezƽFg3=k,qP>O70oyp%k~î=b|}(DYS-i /V̆&;rzn+mp/U5:;C[!W_rV;=_auRgʺޒ&@lJ=o yo mpa\gkYA_Ϫ'~LӪ娝NwvQ[?d}[_~o3}wu='g?%\.@\=U~?50>Z~GU8?zA7ȏu]7S^h(τw;_@;A>q׮` n9xWAU>{/gO6? y5=pY6iu4.ی 1Exo.elSmgt:zU>]r_U|?B*ෲoam{HcSB>g]ʗѦU>7ʱ{pG]n?xU24}64ZIzw\'*BFrzkӈUc^~FmA|6^9iߺ}_&9ԆF6A^#(O9zYwaul:}l!kދ4P~O8kStK=:BWlXd~S5G\\s'}M{&)t~3,3ǴU~{av_bKd?֭_td]hK#'_\3]=~Cx%蹬jy~y< 5}Mޔ ="G{_ɼտzХMnK?3>WN`j^W؂V`W{?PN6 XS}VBimYgW^QZXoaow>eOؤC7y_r9%4w}s6g}n[*6!SHx4P/H]Qp +3 AY0V60 + VfYf& d`4w{Ӳ ?s9=|z#/#C_1/C7Lgm8rfi5n(,dh3VY㙢<^j7~ey/.޷ .g<ڛ<<ڦr6ٮ1Z E}-p_[U[mi=#Ḻyd.r?>.^߄ͺumd{'me }wyYVm1- #T/_u|W}&TsV-j>3Ĺ)s$v,pW}ymqc-I78vp?5$'java-design-patterns-1.16.0/naked-objects/webapp/src/main/jettyconsole/isis-banner.png000066400000000000000000000740701312550536300310040ustar00rootroot00000000000000PNG  IHDRwsRGBgAMA a pHYsodtEXtSoftwarePaint.NET v3.5.100rwIDATx^gUEݗ}ߝs@$uC1qg1*(JF$ 9(H 9# EԙeQ{gwӧ:yٽOUߪUV0 A?2DN0 aY'0 A+c5 #,!1ֿ'c5 8ɳ>S9?s!`d:!u_O>y>ӛ7 ?/ .O5ىVvHae~S{;L9 FX)24҂@ .,\6#mq?]H+-} 5R@ 6t#ƭy|?;%4J-!.OX_eyl;sdzgSV 4"f:}][iT^ߜR4Yq?+=̊6R@: C1]UoY lǔ5w]za IH/i#,jUm8F uޘX뽽O331l}SVJ`L #6֮ClUBX\Y'ۛ,X3"%^FXig&!CX}wM: 6EΒaYnǤv[Wza2D)BxG i=; GcJ=A΂dpN4*&e~YȄ%.r칟ʲ&[(m5pCo:Vu{N- )u_Գ~9ɢu~XFX(e3s?^xw/W{nRSV6\.˩3?~͹o;Ӆ_^R%,[ je\͞꽕_= KY213OM^O@XgS {6mG궘VI}|C)@R'lt}m=y&;" \u𾾣yl͞S^z+pJVώ_NS1("Ր%uO7>zSr~V\0QCG볻 ZoeޅK$$5i$JYb ,Ha-pvޜZ}fgoN .j^e*{z.?msw#V }ܢOV2v}ʛ<;3媮ʐUsvzKXs9mra 4k׮8s&,zՁC{ۤڰU߹#5㢞uqb1Z}w՗{qqm?y_udBߜH I.x+ziX7\7LMqTZ|ZYGؼ>̬ߞ㮶k8 ŊluI<‚zua+&/:2p\7&=AywK9)KߌYXpy}tޫ;m[4{Z]͕;^w[N}O7&T">0 $/LθcφY+ :NOuP5ܪGgjlɭq k޼y  T |u_|c%Dzcb#j2ګoM[?}\yցvWW^&I aax^'_ pI1 }1^\Y@^_|T6HX}WJXբ]5ހ?~1κİ V a.j۲oo{Yޒg+8抃:* 檯߸_ucK aypVT 士_f 1ߗW7_),SNݽ9+WfA9ޡĦ7U|AX ï];}3& h>,/^drYaID|$CK9i?,'jGѨ8|NW:^c>K [, ~祀WDIֱ/ރ=\p۠n gp-f>Na[ ޡ^?m:#>\Yd4+qH߻֕IέJWEGX8~q25sJǔ0p0NZNX<3c7zwukّoJC[%vCWkӚ޸?j׮>꣯] g aŔ%޹pߞY}tn(ebK*nLpJc.O?<[+HKiqD"'Dc'Í;IHě O^V <=Ο_羊0-.9g-uk$u(< -ɠZixBMI2|{o/,^9nym/Z >kW}5_~JXvfWU׊87ɯ4 `q^, S^z{e2GMC8z)`t1!=}Vfǂ'R멞6x{%N>>tس7x-I@| t{͚QNUz&jf*N)&, k6.~s5xgIw;_⬁ o̹:h;v.4?xם9Y_~(Y fhX|cf\>3nY^ǧ9T` zAfr&Fg=},2B x'8/v$,&gDR7oTHuמ6ɛ>ʶv["oBLDǟbO$][LuEC̭/N%HT6J1alkC5Q߁5ѭzϪy\vj玷[7]uOvJY!Y:7[{?_1.Wj1o ,2ݟ;d3ތixV/L9?oEއ޻NԠX6OZybpX;Jm lu%qoq+*/e(%R&#3xBR.ozgiØGlX;~7|/;]}뵧ž։.1%αY!1+fYa̹Zb {sn(GOrۆs^d%|𘣹⻜v"s}`.adYUmx2BU7aiK2 R 3o6rB@OZF{kVZ Kol&[+ح]nǜĻ٘#\eUo x&z  poxIHաAlmI>%c|-!,V SIXgϞ0'o0Z [q'_!!aazcRkupX뺫Z\s'^s}o޸DX,1cYGXg2ѷ>sxCX#$:xEtd2- (}"tf'3V1]^N=Jaww2U4!^z0z.%ְ O}`6#o ?5_wV&R gAOl?r-܊+./ՁY\Z’E'rق  V͈\5C'e*LHlq:yO.%a(4ݹylrkۅJg!ޣ. VX6}BYR0%ص;}pUwX}w貆^9Z]5/_{+t*PƝvqofج7Zq6ro,[R҄0mUW2ZM` Ox\LD/pC/ƔgW1\sQd F:4HKgeo>hˡ3{UzoDq.PVFFBf:gO9Q5BK^-%^u]j s[ɵ'Ǝ'hH>iidT4t$$>y'ɠn4o{vʟnלqݹϷBXJoŬr‚Ԯ>|w߼g81;߽ .<0-€ ʮ;`dlPk`aknށ ؘ<’C2$EAsqx ɁG2bWc5xkGHd=r;2<V2Vdl,#*!ԯȣ<RizytU7=r2 X`ae/ 4:x#݊Wxgհ?i/cwĪĐi`m4c5pP^7ca]R<3 p"S57NysSZ9*0VG /}¢ ^ + lpV;^ݝ{e ,@4xciz8=b L=٘/p OI? V$ ?Mrv8#5Q6͹&fydl%^Q\0 Jṯg{,ɴt ڛLn7+D'Mf2QhA"~a梡6leQn XNet~}:@U o/cbJذ ^}#a16<4oP0 ]^zԢBw{-t͇4-Xkwktg"mM d@1&k%zݯ kn܂#Ϻ6c%5B7:*H-2=1j,| /&S.pci"A>TS! ԮdAa( D1"C[/[dD柆c[{+ӀzZ]z]K'YBX?)YjƂxվWl/ߚf_ޢB9c=5֭1bocUSeZN*O˩[?m'2aA,+܌44my3 g`  ]m|1? \l%?w`85-CݴF`AF;1l#lcYT3\s -&uy0߆}mB7] u26+!/Gv50 WFƨPh"qMːUlkfco;޹x= w}c_!bu|θ_/]Ջ_07Awrn^TgT[U3rNϩgAX]𶭏m猸s0D~Ꙩ9$LHx'j1' j9C׉nw&oݮ6 e1.1pUjwiJ'a1hP1$ 8SƦx{~JJ eAHf؇G.8 .)+n̰Ͼ4ԃR7 U j`2X穴4jxaV$[^ F|#Xq"_~wFs,5bu o5Q]o[ߺ™@O_!wpv+4#<կT,wy#5^ސUiZJs*ɭ:z5sWU +;o#ΉK :7-ޙ$P^B*)dfCa|A݀e< U@IPT(? G٪΢oNe{fyu?_ob`+{1ėѧvr׮|œG=V[rըajE͎קg $^hGSzw5j$OZ0y%To6_AH9IBؕ8CP5dUV7!&Mu0]pIw!ӟE2 !KN^ ZV3AC%Q*O;R^- luE'\7;d DT,ҰA8k 맟~Zz_ moͨ֘pkμyPb~W7|k5_jO+vrsț򏚣\{譵FV4sr,^mQ^/.Y +?m,zZ N'PPjSz)_$xc-<یݱn:D.s%G#9|no}Y,%rBneDv"VbZd<18ocsIz_n~ӧNvP+rGK_߸댸r|PܕjweW>VubL!aBU*=1+㩄uLC @aJo:zQ1@߳CyN̎HĢ]#{ÀrY0<8x Ǐ_!nY 1xq%(2ʘ.{ .[\BZ0ALBפoYb'g(e^F]¤>W{Y! &x3+a8՘yϿwv_v>z^w5~Go%/ןmo_݊WתN͵uj:5Wש a1 a[y=dnUˡ^Rg`0Skw^ ی@([Ev>NBGCx7P2ǍG=^] ۛ,{m}&5w-*~=5;_Y*[יդnXoRjWIN͍ukm([k]g6[TiXsrL:#7nux T*Fc80#K+ht2 n Z& PZtP{G8EEaMC .)Vld&V &(@<΅?ZIYb@WEVIcP +q>*s<펠xiVRQ^ι/5jO3F91y꫰O]r-_Or"/<,/w)ߚ, ~@x3T6FlR9(.ȩ2ps am75ozhg܃pCXGxqS3`tD}b *E]ð<48pJw2ؒTNW1qGz0n4@.sRЎKbo'ptp 0=f#0QE-e]5 #̕E;=oß{Nj,րHVQeo1= {袰;5vOŇܒq0)8u„ -G~Ãy`=w37j4ne-ԯ3nٵj˝U=gVn9UcU4|Ϧ`|+ow*N\طM"tuW oq*LZiݟԢF(2aѮؘ V:F"NAN"̼Dœ5#N(Ghxm&{T q<7z2=/*)Kz+H&AXT-t@zn $+ 0xu!GH5$ݩU*a~XT)<=zxb LW޻<=vu[|zOq {]}4[~U_j׿z ȩ6ZՁժ Zy`V8M*8 *\?Z79DZc μO̼f,1 Ɍm,/'oQ1HWXQcDp.jQ Nq0ŧ5qd.~qppH2f2- ((eQp1a.yP\VEBKݗz.Uq7^cLY$4M)F(ު++|Juѵ 3o}uvny//kVյگ~Mvjfy.{eQ4?ܜf5Q*MdRgW~zLէ߫ȜWo<,Zi<~ }=x[Ǻh{<+Kcj}~Sy{ο=V=z1FAtբ't[7L[<&<V Нɔ/ v&ffdXbFZU\0\<"Ƀ\ JV劃aINuP u;~]݇ۮfe6+j^VҚ1^[rQ z✜泪0ZO+U93+==RѕOazx*=91C)ѰȄ}^-k[%c.ChEY^iR[vFAurXt—~JdeL k j3ٌ6ͯtZT eb&wvZx"Z*eZc%I[I5KJŲSr|2ܹsE*#EXP ; ! [彈:u}2n&v0Wny2[\`Uoja#V(5+/lz 9/Li:52ﱁ;_yg!yJ6]M.Ec`T˔q tFo2^Y:R==bNl$ݪ: X_̐",wRsܹcǎ-p wrS>7]nyPRVuPbU^Y~Qz567DX ZW%š#fVa]TTIwvZۻߙC2%UV,BtAXÊP=J,k`bs68)tյ$,SYHQeB4;\0^sļ';k>!a9/Ϋ `嵕^>HXV1 KtWÉ1 p}`d.ahzLyI?3S@Da ̼R<pVQ:0 pRRLXZN:'N{^M&Vm-?@YVE*|z#->1xK5 h FXɏKY()R#kv0m;'Z[dtNw/͇jhnW`~i>SNm>]өw[%U;zL %@L ^vss>s8(Y߅i(0]]\~EsW1sUZ-f>{l7m焅:V[R R",Uē.]{Ĝۍ܈ʸV==jx-yͽ|}0|[E_ӱSٔЋ@}Krֳ:R%,Ei!2wy˷&JO jMǼ.z3\>WZ.YO台!#\vD! !,>~|ێ].hAU}jMOL]>?h3*Q̝ݵO9a%ӭ-MyE ̈́#Gș\ቡ77.0#ev\Fokv Z(s ei7᙭&8vP!"PVKeO},Y;n=SoztPLJT|jDgƲGv$h75;=g.a Uc.14nY@#,5uĉv}?ܯu8n>FX @հ2UuֽG_}'2mGn1*jadl-I|Xb֭A'}?l{񒭰êU Gzg?s1`M& 9sq 7b+8V*ҢEBEB˫[خ]; ֝ƃԝP/K0Ν;CZ???sYf3Ui "TTɅks I!,X@MUjQ iD\:/je-A9!,צMN % ~:p FBpDMא-=U6m ?~pHH`cR ULW\I^ddht4GGBEb#L5\@D/ʵ)%e4͎;ꫯTrATQ \ @qM߁0'ɐ7nL"w/P)tЊԱc)%>dR +OaI}y/!VZ/ V W ٰh'-;''6*Ʌ`I5=/lv 9#ʕ+EcRӕ UL\K<՗%((t ŅqF0~\\@QJ..h}>Rd(17QFxtɍd*Z\s$U{zpSnY}H/0e '(~jv DbvAоN A vw}+&u 2P(ʝ@.D re"oذL|I`**9:(4S +Hm)ٺ a鋐].3*qJJ\@2ŀԞPKXɤG gbƢg@ai]+ ~ * y`**y<\t}[(0˂)\LJBVKom۶;ڰBYI%_ơ].84V{$/+Tty$ꇕ =t@;-AUIHح\XA4>0h$аB9T6p r K2(Y{\ `A#%zPwd*[PTV/lPt閅)^BXa{Ӑ%BWX1 8>Ck5H$XLVA EIP4JXuw^ (HXR(k[7iĄ*jOjY rWC'fJX\,1uySNJXIТ]UasgfJ=,a#y 2Vttg޽.CAozn/6f:ʕ+*Ev) g 8G]+dՌaT6%Ey$=ٳgyykY =՚dَg̘$jH鴈yyy@Xt +IyL b QN bLa v|X BjXɤg0@ c@ հdj1:ULuJP4{~X$4Cu8V<#vCI8R3#Q$z0uJ& i2aEx4+%-h/.T*O-BKqQl(da JKwPZefE9BXt%&[e,Y:-U6V M -g4 3N5HJ#2!baP*痐HVv/d6R Ca;{0J#R܊3 #`UtړkeQ?qo9ƍ \6l1۩yjA9l T>t%:> #bXw KHȝ'%>MQ%,YwũRh#2s n2ke~ںt+j\z#ösv + c%, B/-ʍ%!eœso%9ViwaEn ^Dc%x$|p Xu % ać^Eޖ`V4 jFX C c0ʘ2A C!`d FXT&!`aY0 A+c5 #,!1aeLS!`e}02#T񳣞L?trG,I-G0+`)#`UʀR#_(h#?;\oB/~Qqša+rXu_9KyorZ WFdVP^a΂M{~D if4)y_:K?TI 57?^8Y(-li"`UhRJJwI*cHgH/܁k_mPhQ a( bϿ=OElT'qK?| zB:u' S %hla%UÙ:a(2V2a+&%"?{o:,#Uos_"70rg/*0ǙvH&M!dR&)DBt=FaFI@xoQ[AOdc0,7TQAm 76oQФRs *I"e H)F/A_xx[Q0ŠV e81`8@93|,M Uwq;0 bu+cR#|ul[L#$T.dשف/M܆H"sSW )Qc'fBGV5;m.I&xd!Y֮N9#ɇ\LTnP:YtgϝOۏI e #hxhj,ؘQ'2t0lnb+z N-K؇//TrQ;,1AfQ >ɿTa_^G 1,+#Hu 5(B)M4H*"zF_ֆ*/b52_EC!^awbRK}4,t(/oLrQJB>GV NC+D »7y ej-2xD X~ž,\_utRPDҩgNm6_ٹ6*+m᭵A2j6d WW]"Az%$ٺIFk!C0R,\``ǐDUDGXAn1xĥ $5e0H7Xܙ&B>RUGX }FXeE`"Ւ /U" Pb6xا&\sGEd֟DZOJ|!9YLDQŵ̡ HJD!6 Ō0¹4NeA LĎNp(z1SA#ЙȆA<eU (&XJ09Jw`w=ɲ a,i/r'ɨc za#>Vj0$+bQ WY檏Mۏm"!,FDr@}(OcPNP!C|VPHJWFYTQ]y$q%!kԑX彖*QjedFXtfқІ@Q0**ri}NJaVi#^ܙ]s B+D5#lVC 0ʠ*\TV\oIy zu]1R],QCFX! ނzhճDK̳ #rnHE7tճ #2h=b΄OqN'_5 [EL26[$xH!Y).:bU]ԸΜY/^M0 A\=vL0ߩ~(+¨BQTGI.'ݴLt,L4>v%lcDbDh }J5dYWt- O^x/uCd/pB QLTP &%Qq3LFX!bb`n$7VЇXٱ12Q4xܓ kz U 9 63lH6DDc=Zon@ImH/'3뇣lP9U ƫwRQk/̓Dg~kZHZFX=Telp˅ S|-'E>+c8M1I &s+WXf1 ?; ڌ9lHs$9R}i2#&W;ymȉAliV@ =M=[NMÐ|P3NҌHg$(*4㚤`*`("6rf5N`CX9iQ4# JOKգ *xdl$ɓ{ HX0JBRD S!;c/kRQ/gd )q(*K(< Y/^"a|Gae#$%JJlzݨ]hRrFAWnBg erI{[X0Z9?MJ9,hH嵡R(h.V1ݝ|Gl1c2TZu  ]')0t'+ZI̶ŴKe,9s_f'O 9Dn=\129k&t: s8?DRItgs fY9v pAEŦHb|(˵[t2ȄѸ#Y Ö/ϯ F؊腛LKyإb sO Z)h)aU>dHAň°%7~Є\k^A#d^&#G_0Zju_:}J.jqgQ2ˀ&RA #nBјMOTVIDAS41TvR 6WDY$O!\_5'א/U 0 BB")Rv\^ɃymaӰeϺkmJ1:a"}PsOƆ8!:ؤ$~g38)%K-$Cqp䋛 (A6Axw&Oqij-3&ՉF$gM%=ENZu4tEPSU ńsgNqk j*Ġyb#"CwكZt @ 'הpu%WBLKXXd d̲iOP>jQ0 E"*}{ f! dVfr+[A$5P-Y8T"V(NykEvɨ@Ӭ"%aƘNZ$Gp q-fыyv\pGEd+&dipDߑɗ ?aqxV㔰0xq-Ø- $V" I(f,Цq*+^TnUNS}bG'8O ) FI:0*D5]-X7j$+)E ńĐ܉O0(RQovpPBIh(h^%R\GDQ$*r" QYns$ !AT>8ARS!Ya$fb7W}tHn2ܼ-‚nD$׫K dgx,V?×z kģ^,e +WRRFѧ*/""X.mH$"`DCc= MHPUIY{jVSrҪʈ-{n D,ش'x3!nhNsH$E@P3)Ы,2FŁ8 Lć |\C1*/FXE-)Бђ| iQr(wR2ٶlz0 x&BP<}qh:<6DZF%rR (S|h nő6$7 -L [[MmpeSNRc,wޯtb1h +Jb/ע *0|;I%H&S\,ő3hq(A6Axw&ORƿZeЀ=Yr װ FtK΢W&, 鴔4Bnj9db Ƞ JFX.P6J Z_3WFЁD)K$U$[02uE2D め*&!QBHJh1q.dG0 u %D ]C Ւ%BL!!WBepUcD Qъ(d,S 8{W-ݹa靪%_G2\Ca\hmbR9LȖ?c_%2" Cs08%, ^\zG i׈8wCl asXiṱhr1bE<1>¨: lTM~ѧPBlj.)&9h1,^wud|L(H^%R!,j 'ITF׼ʝ') AXWSY$`b7f<.~oNy\ÍkuD< ղh$0_%U+($̫^,eרJH]*5jlB:퉏 8l$&FqT_5nvq(:V,Q=W]L%T7]#-E{RYVt+\ `UJl+p2M|C 0ʦֶV6hadxJ"kp{uOŕ;Xd)<тۛ]+NwkN%ZʒC-ٜ5FB0STeEuLnW A\',AbdhU 0dЕ`$%F)r|=M9Ɉ;@_J]I2-%Qt,K2-Ai"7De@7%R57n֔#עaT{H$(̌4ԍT/>Ɵ45\޴ [9.<8J5U "_`q.<>C^e3 ԣxƃ5)y_+m+Ȩ\0vd.9PYp7^Hȝ/0ŠxlOa.;0腌4t%%iak0Ј BhBfFFܡnwC?=3]FtkURt{UcT\8QEL Ba yjރ%}+bȄ)BHe7$[]'V@ŒMSJ(Ɍ"a7JJ6и(n`|O"KF'xaq1Nɿ(SA%aZѩ Zw. tVF_a$^ .Dtÿ "#LɺR$H4ʵ }hyOjPIͪ0,FFĊ3c)2 % PHcuh\WP%Ƈ!%JlPB%@"N0GeO3.DT%Na>gj$^p-QFE,wBȵ,&"D (XuZޓaEk: HFƊ)"Rh'EpF︇и(&^|3nF2&=D6VB՘Erʃĩ8d$zw> ɂjA")?kh>`E@G07K. jz:$W"yix!qI.b ["`U\S<͛pGr;pUT'o e(& W@@P ran$ڳ#sSga4%,)nwZCQyU* GtL >"w2:z_( ~y&+oOx#CZ Q7)wx3-bhNKWxle^0P$gq!R|$z2NDH­5y䬙 y? Qj0k7唟;G a Oc V$[.de: ]1*# 1)S>,AFCbqa KޤV*լPCt~#bHRd?jBN ` dB2IMrܤvA9w&T$&|T҈HMCn6abůGnb惖#C)̛bH#JdE'¨K-%,@2YW8CװXɠؕܜa~6ӌ57I O 3Epú:I߫ w2E^#ty ?Տ Y&`M`(YC$H!7=, "&yчd܄d6j!:v SB{Cj-b;`:(%%+U uגeMRRw]95VSdqXPdβ9L` ъCZr-i -FXA/EGK=HzT;W<+=yR^3͇U.)4#Z-TH#m;:ɭ†@"`Ζc ;I.QXSt*f[O|i C6s׼ Nu/ 1k?eaWSv )i ^)ɶ2x;Js1Xf[7w* wk[.TOKroQ8KQxDxC"\ 9إ^)ɶ2CJIJs[=!57;Jp\}1萩-nva~$^+P G2u m|&ݹIoVJpe{[C/ax/q@0ߚvq[2 FEپXƺ3hZ;iaFG6rBqFw-UMHZĆQ1]NrdBԸuBP(ηPB{ M,lR e5a?܍tm:]S҇$& cl@%u@§2_%H%JX莂dnj=Ad%[vוּ-pX4cUP/C9*`vL*Qkrܨ GzKj@{2Elݚ&a`Wxφ n':u"dPKIJE>8-u5PubȐd.qV*{k]" [^Anj \b0kg|എL :`0zݬR/{ K-z/ܝ"2,14jP0 RThI.2pG'wlTA 4sZ;*.]5M>p*K/7Nu=ِͫyI|\D,KjLcT^z0D;r[,-\\Pι㸋0(r׹p  Z7w5|jjEIaX~*X`${Ш5 UC;^˒$[ )N斍Jn\oY݊WFqW(ix2dYMXI׌( A v@|;+]КX4q`9AkՓN4#zF갑EA=~4XM0j &U5^WBAeUbg/Lhh0RkZx\^B쁒 uLBm{NVE,zIɉn~4͆r(ҔCbѦ%%Ź $OÀLAd(L!ʻZr^qsB/q2ՏTsu:r# 1#XIw8uZ#%,axAc(4tIހ $Td(dKhLRzRZYB֐ee1)Xqt @YB}) K LXE%FJ,ER`)>pܮû78ߔ)RB2ƜcE E=RZjܐ,$JCE0j13) x/Lhher<‚w!%v"(Qr&mG@jU(MYMXhsf2xYCuɮJ,e5aa(@~?0 7j5.OVV7 C FXĆ!N҉m0Š%6 t"`NlCV$,!`#toe@$"e C a}+0"!` .KlD+[ن! #HpYbCH'FXD6 HaE@:0J'V!`DB+\0҉V:ѷ C FXĆ!N҉m0Š%6 t"`NlCV$,!`#toe@$"e C a}+0"!` .KlD+[ن! #HpYbCH'FXD6 HaE@:0J'V!`DB+\0҉V:ѷ C FXĆ!N҉m0Š%6 t"`NlCV$,!`#toe@$"e C a}+0"!` .KlD+[ن! Q@IENDB`java-design-patterns-1.16.0/naked-objects/webapp/src/main/resources/000077500000000000000000000000001312550536300253445ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/resources/domainapp/000077500000000000000000000000001312550536300273145ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/resources/domainapp/webapp/000077500000000000000000000000001312550536300305725ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/resources/domainapp/webapp/welcome.html000066400000000000000000000036751312550536300331260ustar00rootroot00000000000000

Apache Isis™ is a platform to let you rapidly develop domain-driven apps in Java.

This app has been generated using Apache Isis' SimpleApp archetype, to create a purposefully minimal application that nevertheless includes fixture data, integration tests and BDD specs.

The app itself consists of a single domain class, SimpleObject, along with an equally simple (factory/repository) domain service, SimpleObjects.

For more details, see the Apache Isis website.

java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/000077500000000000000000000000001312550536300246105ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/000077500000000000000000000000001312550536300256375ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties000066400000000000000000000227311312550536300307310ustar00rootroot00000000000000# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. ################################################################################# # # specify system components. # # The values correspond to the named components in the installer-registry.properties file # in the org.apache.isis.core:isis-core-runtime JAR (in the org.apache.isis.core.runtime package) # # Although all configuration could reside in isis.properties, the recommendation is # to split out into component specific files: # # xxx_yyy.properties files # # where # * xxx is the component type, and # * yyy is the component name. # # For example, viewer_wicket.properties holds configuration information specific to the Wicket viewer. # ################################################################################# # # configure the persistor (object store) to use # # JDO/DataNucleus objectstore isis.persistor=datanucleus # # configure authentication mechanism to use (to logon to the system) # #isis.authentication=bypass isis.authentication=shiro # # configure authorization mechanism to use # #isis.authorization=bypass isis.authorization=shiro ################################################################################# # # MetaModel # # The metamodel typically does not require additional configuration, although # the system components (defined above) may refine the metamodel for their needs. # ################################################################################# # # Additional programming model facet factories, or remove standard facet factories. # Comma separated list of fully qualified class names. # #isis.reflector.facets.include= #isis.reflector.facets.exclude= # # Metamodel validation (in addition to that automatically performed by the programming model facet factories) # Default implementation does nothing. # # Use a custom implementation to enforce additional constraints specific to your app/project/company. # #isis.reflector.validator=org.apache.isis.core.metamodel.metamodelvalidator.dflt.MetaModelValidatorDefault # # Whether to allow deprecated annotations/method prefixes (otherwise raise metamodel validation errors). # If not specified, default is to allow. # isis.reflector.validator.allowDeprecated=false # # Implementation to use for reading dynamic layout. Default implementation reads Xxx.layout.json files from classpath. # #isis.reflector.layoutMetadataReaders=org.apache.isis.core.metamodel.layoutmetadata.json.LayoutMetadataReaderFromJson # # patterns for applying CssClassFa facet (font-awesome icons), matching on action names # isis.reflector.facet.cssClassFa.patterns=\ new.*:fa-plus,\ add.*:fa-plus-square,\ create.*:fa-plus,\ update.*:fa-edit,\ change.*:fa-edit,\ remove.*:fa-minus-square,\ move.*:fa-exchange,\ first.*:fa-star,\ find.*:fa-search,\ lookup.*:fa-search,\ clear.*:fa-remove,\ previous.*:fa-step-backward,\ next.*:fa-step-forward,\ list.*:fa-list, \ all.*:fa-list, \ download.*:fa-download, \ upload.*:fa-upload, \ execute.*:fa-bolt, \ run.*:fa-bolt, \ calculate.*:fa-calculator, \ verify.*:fa-check-circle, \ refresh.*:fa-refresh, \ install.*:fa-wrench # # patterns for applying CssClass facet (CSS styles), matching on member names # isis.reflector.facet.cssClass.patterns=\ delete.*:btn-warning ################################################################################# # # Value facet defaults # # (see also viewer-specific config files, eg viewer_wicket.properties) # ################################################################################# # as used by @Title of a date isis.value.format.date=dd-MM-yyyy ################################################################################# # # Application Services and fixtures # ################################################################################# # # Specify the domain services. # # These are the most important configuration properties in the system, as they define # the set of the classes for Isis to instantiate as domain service singletons. # From these domain service instances the rest of the metamodel is discovered, while the # end-user gains access to other domain objects by invoking the actions of the domain services. # isis.services-installer=configuration-and-annotation isis.services.ServicesInstallerFromAnnotation.packagePrefix=domainapp # additional services/overriding default (@DomainService) implementations isis.services = # Specify the (optional) test fixtures # # Fixtures are used to seed the object store with an initial set of data. For the # in-memory object store, the fixtures are installed on every run. For other # object stores, they are used only when the object store is first initialized. # isis.fixtures=domainapp.fixture.scenarios.RecreateSimpleObjects # # required by EmailServiceDefault # #isis.service.email.sender.address=some.valid@email.address #isis.service.email.sender.password=the.password.for-isis.notification.email.sender.address # # whether ExceptionRecognizers should also log any recognized exceptions # (default false; enable for diagnostics/debugging) # #isis.services.exceprecog.logRecognizedExceptions=true # # disable to (automatically registered) ExceptionRecognizerCompositeForJdoObjectStore service # almost all of this service should be registered. Since all exception recognizer implementations # are consulted in the event of an exception, it's not sufficient to override the implementation # (in isis.services); instead this configuration property disables this particular implementation. # #isis.services.ExceptionRecognizerCompositeForJdoObjectStore.disable=true ################################################################################ # # Auditing, Publishing, Command # ################################################################################ # # Whether changes to objects should be audited; if not set, defaults to "none" # - if not set or set to "none", can explicitly enable using @DomainObject(auditing=Auditing.ENABLED) # - if set to "all", can explicitly disable using @Object(auditing=Auditing.DISABLED) # #isis.services.audit.objects=all|none # # Whether changes to objects should be published; if not set, defaults to "none" # - if not set or set to "none", can explicitly enable using @DomainObject(publishing=Publishing.ENABLED) # - if set to "all", can explicitly disable using @Object(publishing=Publishing.DISABLED) # #isis.services.publish.objects=all|none # # Whether all (or all non-query only) actions should be published; if not set, defaults to "none" # - if not set or set to "none", can explicitly enable using @Action(publishing=Publishing.ENABLED) # - if set to "all", can explicitly disable using @Action(publishing=Publishing.DISABLED) # #isis.services.publish.actions=all|none|ignoreQueryOnly # # Whether all (or all non-query only) actions should be reified as commands; if not set, defaults to "none" # - if not set or set to "none", can explicitly enable using @Action(command=CommandReification.ENABLED) # - if set to "all", can explicitly disable using @Action(command=CommandReification.DISABLED) # #isis.services.command.actions=all|none|ignoreQueryOnly ################################################################################ # # Policies # ################################################################################# # # Whether editing of object properties is allowed; if not set, defaults to "true" # - if not set or set to "true", can explicitly disable using @DomainObject(editing=Editing.DISABLED) # - if set to "false", can explicitly enable using @DomainObject(editing=Editing.ENABLED) # #isis.objects.editing=true|false ################################################################################ # # i18n # ################################################################################# # # force read translations, even if running in prototype mode # #isis.services.translation.po.mode=read ################################################################################ # # Viewer defaults # ################################################################################# # # Specify viewer defaults # #isis.viewers.paged.standalone=30 #isis.viewers.paged.parented=10 #isis.viewers.propertyLayout.labelPosition=LEFT #isis.viewers.parameterLayout.labelPosition=LEFT java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties000066400000000000000000000114441312550536300320130ustar00rootroot00000000000000# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. ################################################################################# # # Persistor # ################################################################################# # generally speaking this should not be enabled isis.persistor.disableConcurrencyChecking=false ################################################################################# # # JDBC configuration # ################################################################################# # # configuration file holding the JDO objectstore's JDBC configuration # (this is a bit of a hack... just exploiting fact that Isis also loads this file) # # # JDBC connection details # (also update the pom.xml to reference the appropriate JDBC driver) # # # HSQLDB in-memory # isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=org.hsqldb.jdbcDriver isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:hsqldb:mem:test isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=sa isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword= # # HSQLDB in-memory (using log4jdbc-remix) # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=net.sf.log4jdbc.DriverSpy #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:log4jdbc:hsqldb:mem:test #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=sa #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword= # # HSQLDB to file # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=org.hsqldb.jdbcDriver #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:hsqldb:file:/tmp/isis-simple-app/hsql-db;hsqldb.write_delay=false;shutdown=true #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=sa #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword= # # HSQLDB to file (using log4jdbc-remix) # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=net.sf.log4jdbc.DriverSpy #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:log4jdbc:hsqldb:file:/tmp/isis-simple-app/hsql-db;hsqldb.write_delay=false;shutdown=true #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=sa #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword= # # PostgreSQL Server # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=org.postgresql.Driver #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:postgresql://localhost:5432/isis #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=isis #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=isis # # PostgreSQL Server (using log4jdbc-remix) # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=net.sf.log4jdbc.DriverSpy #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:log4jdbc:postgresql://localhost:5432/isis #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=isis #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=isis # # MS SQL Server # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=com.microsoft.sqlserver.jdbc.SQLServerDriver #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:sqlserver://127.0.0.1:1433;instance=.;databaseName=simple #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=sa #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=p4ssword # # MS SQL Server (using log4jdbc-remix) # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionDriverName=net.sf.log4jdbc.DriverSpy #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=jdbc:log4jdbc:sqlserver://127.0.0.1:1433;instance=SQLEXPRESS;databaseName=jdo #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionUserName=jdo #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=jdopass # # neo4j # (experimental; run with -P neo4j profile in webapp project) # #isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionURL=neo4j:neo4j_DB persistor_datanucleus.properties000066400000000000000000000062641312550536300343300ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. # # configuration file for the JDO/DataNucleus objectstore # # identifies @PersistenceCapable entities to be eagerly registered # if move class to other package (eg com.mycompany.myapp.dom) then update isis.persistor.datanucleus.RegisterEntities.packagePrefix=domainapp.dom.modules # # hook to perform additional initialization when JDO class metadata is loaded # default implementation will attempt to run 'create schema' for the specified schema. # #isis.persistor.datanucleus.classMetadataLoadedListener=org.apache.isis.objectstore.jdo.datanucleus.CreateSchemaFromClassMetadata # whether to persist the event data as a "clob" or as a "zipped" byte[] # default is "zipped" #isis.persistor.datanucleus.PublishingService.serializedForm=zipped ##################################################################### # # DataNucleus' configuration # # The 'isis.persistor.datanucleus.impl' prefix is stripped off, # remainder is passed through to DataNucleus # ##################################################################### isis.persistor.datanucleus.impl.datanucleus.schema.autoCreateAll=true isis.persistor.datanucleus.impl.datanucleus.schema.validateTables=true isis.persistor.datanucleus.impl.datanucleus.schema.validateConstraints=true # # Require explicit persistence (since entities are Comparable and using ObjectContracts#compareTo). # see http://www.datanucleus.org/products/accessplatform_3_0/jdo/transaction_types.html # isis.persistor.datanucleus.impl.datanucleus.persistenceByReachabilityAtCommit=false # # How column names are identified # (http://www.datanucleus.org/products/datanucleus/jdo/orm/datastore_identifiers.html) # isis.persistor.datanucleus.impl.datanucleus.identifier.case=MixedCase # # L2 cache # off except if explicitly marked as cacheable # http://www.datanucleus.org/products/datanucleus/jdo/cache.html # isis.persistor.datanucleus.impl.datanucleus.cache.level2.type=none isis.persistor.datanucleus.impl.datanucleus.cache.level2.mode=ENABLE_SELECTIVE # # uncomment to use JNDI rather than direct JDBC # #isis.persistor.datanucleus.impl.datanucleus.ConnectionFactoryName=java:comp/env/jdbc/quickstart # # uncomment to use JTA resource # #isis.persistor.datanucleus.impl.datanucleus.ConnectionFactory2Name=java:comp/env/jdbc/quickstart-nontx #isis.persistor.datanucleus.impl.javax.jdo.option.TransactionType=JTA # # # JDBC connection details # ... are in persistor.properties # # java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/shiro.ini000066400000000000000000000061051312550536300274660ustar00rootroot00000000000000# # Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. # [main] contextFactory = org.apache.isis.security.shiro.IsisLdapContextFactory contextFactory.url = ldap://localhost:10389 contextFactory.authenticationMechanism = CRAM-MD5 contextFactory.systemAuthenticationMechanism = simple contextFactory.systemUsername = uid=admin,ou=system contextFactory.systemPassword = secret ldapRealm = org.apache.isis.security.shiro.IsisLdapRealm ldapRealm.contextFactory = $contextFactory ldapRealm.searchBase = ou=groups,o=mojo ldapRealm.groupObjectClass = groupOfUniqueNames ldapRealm.uniqueMemberAttribute = uniqueMember ldapRealm.uniqueMemberAttributeValueTemplate = uid={0} # optional mapping from physical groups to logical application roles #ldapRealm.rolesByGroup = \ # LDN_USERS: user_role,\ # NYK_USERS: user_role,\ # HKG_USERS: user_role,\ # GLOBAL_ADMIN: admin_role,\ # DEMOS: self-install_role ldapRealm.permissionsByRole=\ user_role = *:ToDoItemsJdo:*:*,\ *:ToDoItem:*:*; \ self-install_role = *:ToDoItemsFixturesService:install:* ; \ admin_role = * # to use ldap... # (see docs for details of how to setup users/groups in Apache Directory Studio). #securityManager.realms = $ldapRealm # to use .ini file securityManager.realms = $iniRealm # ----------------------------------------------------------------------------- # Users and their assigned roles # # Each line conforms to the format defined in the # org.apache.shiro.realm.text.TextConfigurationRealm#setUserDefinitions JavaDoc # ----------------------------------------------------------------------------- [users] # user = password, role1, role2, role3, ... sven = pass, admin_role dick = pass, user_role, self-install_role bob = pass, user_role, self-install_role joe = pass, user_role, self-install_role guest = guest, user_role # ----------------------------------------------------------------------------- # Roles with assigned permissions # # Each line conforms to the format defined in the # org.apache.shiro.realm.text.TextConfigurationRealm#setRoleDefinitions JavaDoc # ----------------------------------------------------------------------------- [roles] # role = perm1, perm2, perm3, ... # perm in format: packageName:className:memberName:r,w user_role = *:SimpleObjects:*:*,\ *:SimpleObject:*:* self-install_role = *:DomainAppFixtureService:*:* admin_role = * java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/translations-en.po000066400000000000000000000135351312550536300313270ustar00rootroot00000000000000############################################################################## # # .pot file # # Translate this file to each required language and place in WEB-INF, eg: # # /WEB-INF/translations-en_US.po # /WEB-INF/translations-en.po # /WEB-INF/translations-fr_FR.po # /WEB-INF/translations-fr.po # /WEB-INF/translations.po # # If the app uses TranslatableString (eg for internationalized validation # messages), or if the app calls the TranslationService directly, then ensure # that all text to be translated has been captured by running a full # integration test suite that exercises all relevant behaviour # ############################################################################## #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations(java.lang.String) msgid ".pot file name" msgstr ".pot file name" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#resetTranslationCache() msgid "Clear translation cache" msgstr "Clear translation cache" #: domainapp.dom.modules.simple.SimpleObjects#create() msgid "Create" msgstr "Create" #: org.apache.isis.applib.fixturescripts.FixtureScript#discoverable msgid "Discoverable" msgstr "Discoverable" #: org.apache.isis.applib.fixtures.FixtureType#DOMAIN_OBJECTS msgid "Domain Objects" msgstr "Domain Objects" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations() msgid "Download Translations" msgstr "Download Translations" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Exclamation mark is not allowed" msgstr "Exclamation mark is not allowed" #: domainapp.dom.modules.simple.SimpleObjects#findByName() msgid "Find By Name" msgstr "Find By Name" #: org.apache.isis.applib.fixturescripts.FixtureResult#fixtureScriptClassName msgid "Fixture script" msgstr "Fixture script" #: org.apache.isis.applib.fixturescripts.FixtureScript#friendlyName msgid "Friendly Name" msgstr "Friendly Name" #: domainapp.dom.modules.simple.SimpleObject msgid "General" msgstr "General" #: domainapp.dom.app.homepage.HomePageService#homePage() msgid "Home Page" msgstr "Home Page" #: domainapp.dom.modules.simple.SimpleObjects#listAll() msgid "List All" msgstr "List All" #: org.apache.isis.applib.fixturescripts.FixtureScript#localName msgid "Local Name" msgstr "Local Name" #: org.apache.isis.applib.fixturescripts.FixtureScript#lookup() #: org.apache.isis.applib.services.bookmark.BookmarkHolderActionContributions#lookup() msgid "Lookup" msgstr "Lookup" #: domainapp.dom.modules.simple.SimpleObject#name #: domainapp.dom.modules.simple.SimpleObjects#create(java.lang.String) #: domainapp.dom.modules.simple.SimpleObjects#findByName(java.lang.String) msgid "Name" msgstr "Name" #: domainapp.dom.modules.simple.SimpleObject#updateName(java.lang.String) msgid "New name" msgstr "New name" #: org.apache.isis.applib.services.bookmark.BookmarkHolderAssociationContributions#object() msgid "Object" msgstr "Object" #: domainapp.dom.modules.simple.SimpleObject#title() msgid "Object: {name}" msgstr "Object: {name}" #: domainapp.dom.app.homepage.HomePageViewModel#objects msgid "Objects" msgstr "Objects" #: org.apache.isis.applib.fixtures.FixtureType#OTHER msgid "Other" msgstr "Other" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Parameters" msgstr "Parameters" #: domainapp.fixture.DomainAppFixturesService #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu msgid "Prototyping" msgstr "Prototyping" #: domainapp.fixture.DomainAppFixturesService#recreateObjectsAndReturnFirst() msgid "Recreate Objects And Return First" msgstr "Recreate Objects And Return First" #: org.apache.isis.applib.fixturescripts.FixtureResult#object msgid "Result" msgstr "Result" #: org.apache.isis.applib.fixturescripts.FixtureResult#className msgid "Result class" msgstr "Result class" #: org.apache.isis.applib.fixturescripts.FixtureResult#key msgid "Result key" msgstr "Result key" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript() #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript() msgid "Run Fixture Script" msgstr "Run Fixture Script" #: org.apache.isis.applib.fixturescripts.FixtureScript msgid "Script" msgstr "Script" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Script-specific parameters (if any). The format depends on the script implementation (eg key=value, CSV, JSON, XML etc)" msgstr "Script-specific parameters (if any). The format depends on the script implementation (eg key=value, CSV, JSON, XML etc)" #: domainapp.dom.modules.simple.SimpleObjects#title() msgid "Simple Objects" msgstr "Simple Objects" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToReadingTranslations() msgid "Switch To Reading Translations" msgstr "Switch To Reading Translations" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToWritingTranslations() msgid "Switch To Writing Translations" msgstr "Switch To Writing Translations" #: org.apache.isis.applib.fixturescripts.FixtureScript#type msgid "Type" msgstr "Type" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Update Name" msgstr "Update Name" #: domainapp.dom.modules.simple.SimpleObject msgid "name" msgstr "" ############################################################################## # end of .pot file ############################################################################## java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/translations-es.po000066400000000000000000000136311312550536300313310ustar00rootroot00000000000000############################################################################## # # .pot file # # Translate this file to each required language and place in WEB-INF, eg: # # /WEB-INF/translations-en_US.po # /WEB-INF/translations-en.po # /WEB-INF/translations-fr_FR.po # /WEB-INF/translations-fr.po # /WEB-INF/translations.po # # If the app uses TranslatableString (eg for internationalized validation # messages), or if the app calls the TranslationService directly, then ensure # that all text to be translated has been captured by running a full # integration test suite that exercises all relevant behaviour # ############################################################################## #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations(java.lang.String) msgid ".pot file name" msgstr "fichero .pot" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#resetTranslationCache() msgid "Clear translation cache" msgstr "Limpiar la caché de traducciones" #: domainapp.dom.modules.simple.SimpleObjects#create() msgid "Create" msgstr "Crear" #: org.apache.isis.applib.fixturescripts.FixtureScript#discoverable msgid "Discoverable" msgstr "Descubrible" #: org.apache.isis.applib.fixtures.FixtureType#DOMAIN_OBJECTS msgid "Domain Objects" msgstr "Domain Objects" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations() msgid "Download Translations" msgstr "Descargar traducciones" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Exclamation mark is not allowed" msgstr "No se admite el signo de exclamación" #: domainapp.dom.modules.simple.SimpleObjects#findByName() msgid "Find By Name" msgstr "Buscar por Nombre" #: org.apache.isis.applib.fixturescripts.FixtureResult#fixtureScriptClassName msgid "Fixture script" msgstr "Script de Instalación" #: org.apache.isis.applib.fixturescripts.FixtureScript#friendlyName msgid "Friendly Name" msgstr "Nombre común" #: domainapp.dom.app.homepage.HomePageService#homePage() msgid "Home Page" msgstr "Página de Inicio" #: domainapp.dom.modules.simple.SimpleObjects#listAll() msgid "List All" msgstr "Listar Todos" #: org.apache.isis.applib.fixturescripts.FixtureScript#localName msgid "Local Name" msgstr "Nombre Local" #: org.apache.isis.applib.fixturescripts.FixtureScript#lookup() #: org.apache.isis.applib.services.bookmark.BookmarkHolderActionContributions#lookup() msgid "Lookup" msgstr "Buscar" #: domainapp.dom.modules.simple.SimpleObject#name #: domainapp.dom.modules.simple.SimpleObjects#create(java.lang.String) #: domainapp.dom.modules.simple.SimpleObjects#findByName(java.lang.String) msgid "Name" msgstr "Nombre" #: domainapp.dom.modules.simple.SimpleObject#updateName(java.lang.String) msgid "New name" msgstr "Nuevo nombre" #: org.apache.isis.applib.services.bookmark.BookmarkHolderAssociationContributions#object() msgid "Object" msgstr "Objeto" #: domainapp.dom.modules.simple.SimpleObject#title() msgid "Object: {name}" msgstr "Objeto: {name}" #: domainapp.dom.app.homepage.HomePageViewModel#objects msgid "Objects" msgstr "Objetos" #: org.apache.isis.applib.fixtures.FixtureType#OTHER msgid "Other" msgstr "Other" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Parameters" msgstr "Parámetros" #: domainapp.fixture.DomainAppFixturesService #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu msgid "Prototyping" msgstr "Prototipo" #: domainapp.fixture.DomainAppFixturesService#recreateObjectsAndReturnFirst() msgid "Recreate Objects And Return First" msgstr "Recrear Objetos y Devolver el Primero" #: org.apache.isis.applib.fixturescripts.FixtureResult#object msgid "Result" msgstr "Resultado" #: org.apache.isis.applib.fixturescripts.FixtureResult#className msgid "Result class" msgstr "Clase del resultado" #: org.apache.isis.applib.fixturescripts.FixtureResult#key msgid "Result key" msgstr "Clave del Resultado" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript() #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript() msgid "Run Fixture Script" msgstr "Ejecutar Script de Instalación" #: org.apache.isis.applib.fixturescripts.FixtureScript msgid "Script" msgstr "Script" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Script-specific parameters (if any). The format depends on the script implementation (eg key=value, CSV, JSON, XML etc)" msgstr "Parámetros específicos del Script (si hay alguno). El formato depende de la implementación del script (por ejemplo, clave=valor, CSV, JSON, XML, etc.)" #: domainapp.dom.modules.simple.SimpleObjects#title() msgid "Simple Objects" msgstr "Objetos básicos" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToReadingTranslations() msgid "Switch To Reading Translations" msgstr "Cambiar a Lectura de Traducciones" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToWritingTranslations() msgid "Switch To Writing Translations" msgstr "Cambiar a Escritura de Traducciones" #: org.apache.isis.applib.fixturescripts.FixtureScript#type msgid "Type" msgstr "Tipo" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Update Name" msgstr "Nombre de la Actualización" #: domainapp.dom.modules.simple.SimpleObject msgid "name" msgstr "" ############################################################################## # end of .pot file ############################################################################## java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/translations-nl.po000066400000000000000000000125271312550536300313360ustar00rootroot00000000000000############################################################################## # # .pot file # # Translate this file to each required language and place in WEB-INF, eg: # # /WEB-INF/translations-en_US.po # /WEB-INF/translations-en.po # /WEB-INF/translations-fr_FR.po # /WEB-INF/translations-fr.po # /WEB-INF/translations.po # # If the app uses TranslatableString (eg for internationalized validation # messages), or if the app calls the TranslationService directly, then ensure # that all text to be translated has been captured by running a full # integration test suite that exercises all relevant behaviour # ############################################################################## #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations(java.lang.String) msgid ".pot file name" msgstr "" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#resetTranslationCache() msgid "Clear translation cache" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#create() msgid "Create" msgstr "Creëren" #: org.apache.isis.applib.fixturescripts.FixtureScript#discoverable msgid "Discoverable" msgstr "Discoverable" #: org.apache.isis.applib.fixtures.FixtureType#DOMAIN_OBJECTS msgid "Domain Objects" msgstr "Domain Objects" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations() msgid "Download Translations" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Exclamation mark is not allowed" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#findByName() msgid "Find By Name" msgstr "Zoek op Naam" #: org.apache.isis.applib.fixturescripts.FixtureResult#fixtureScriptClassName msgid "Fixture script" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#friendlyName msgid "Friendly Name" msgstr "" #: domainapp.dom.app.homepage.HomePageService#homePage() msgid "Home Page" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#listAll() msgid "List All" msgstr "Lijst Alle" #: org.apache.isis.applib.fixturescripts.FixtureScript#localName msgid "Local Name" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#lookup() #: org.apache.isis.applib.services.bookmark.BookmarkHolderActionContributions#lookup() msgid "Lookup" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#name #: domainapp.dom.modules.simple.SimpleObjects#create(java.lang.String) #: domainapp.dom.modules.simple.SimpleObjects#findByName(java.lang.String) msgid "Name" msgstr "Naam" #: domainapp.dom.modules.simple.SimpleObject#updateName(java.lang.String) msgid "New name" msgstr "Nieuwe naam" #: org.apache.isis.applib.services.bookmark.BookmarkHolderAssociationContributions#object() msgid "Object" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#title() msgid "Object: {name}" msgstr "" #: domainapp.dom.app.homepage.HomePageViewModel#objects msgid "Objects" msgstr "Objects" #: org.apache.isis.applib.fixtures.FixtureType#OTHER msgid "Other" msgstr "Other" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Parameters" msgstr "" #: domainapp.fixture.DomainAppFixturesService #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu msgid "Prototyping" msgstr "" #: domainapp.fixture.DomainAppFixturesService#recreateObjectsAndReturnFirst() msgid "Recreate Objects And Return First" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#object msgid "Result" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#className msgid "Result class" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#key msgid "Result key" msgstr "" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript() #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript() msgid "Run Fixture Script" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript msgid "Script" msgstr "" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Script-specific parameters (if any). The format depends on the script implementation (eg key=value, CSV, JSON, XML etc)" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#title() msgid "Simple Objects" msgstr "Eenvoudige Objecten" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToReadingTranslations() msgid "Switch To Reading Translations" msgstr "" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToWritingTranslations() msgid "Switch To Writing Translations" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#type msgid "Type" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Update Name" msgstr "Updaten Naam" #: domainapp.dom.modules.simple.SimpleObject msgid "name" msgstr "" ############################################################################## # end of .pot file ############################################################################## java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/translations.po000066400000000000000000000124641312550536300307270ustar00rootroot00000000000000############################################################################## # # .pot file # # Translate this file to each required language and place in WEB-INF, eg: # # /WEB-INF/translations-en_US.po # /WEB-INF/translations-en.po # /WEB-INF/translations-fr_FR.po # /WEB-INF/translations-fr.po # /WEB-INF/translations.po # # If the app uses TranslatableString (eg for internationalized validation # messages), or if the app calls the TranslationService directly, then ensure # that all text to be translated has been captured by running a full # integration test suite that exercises all relevant behaviour # ############################################################################## #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations(java.lang.String) msgid ".pot file name" msgstr "" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#resetTranslationCache() msgid "Clear translation cache" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#create() msgid "Create" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#discoverable msgid "Discoverable" msgstr "" #: org.apache.isis.applib.fixtures.FixtureType#DOMAIN_OBJECTS msgid "Domain Objects" msgstr "" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#downloadTranslations() msgid "Download Translations" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Exclamation mark is not allowed" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#findByName() msgid "Find By Name" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#fixtureScriptClassName msgid "Fixture script" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#friendlyName msgid "Friendly Name" msgstr "" #: domainapp.dom.modules.simple.SimpleObject msgid "General" msgstr "Common" #: domainapp.dom.app.homepage.HomePageService#homePage() msgid "Home Page" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#listAll() msgid "List All" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#localName msgid "Local Name" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#lookup() #: org.apache.isis.applib.services.bookmark.BookmarkHolderActionContributions#lookup() msgid "Lookup" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#name #: domainapp.dom.modules.simple.SimpleObjects#create(java.lang.String) #: domainapp.dom.modules.simple.SimpleObjects#findByName(java.lang.String) msgid "Name" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#updateName(java.lang.String) msgid "New name" msgstr "" #: org.apache.isis.applib.services.bookmark.BookmarkHolderAssociationContributions#object() msgid "Object" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#title() msgid "Object: {name}" msgstr "" #: domainapp.dom.app.homepage.HomePageViewModel#objects msgid "Objects" msgstr "" #: org.apache.isis.applib.fixtures.FixtureType#OTHER msgid "Other" msgstr "" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Parameters" msgstr "" #: domainapp.fixture.DomainAppFixturesService #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu msgid "Prototyping" msgstr "" #: domainapp.fixture.DomainAppFixturesService#recreateObjectsAndReturnFirst() msgid "Recreate Objects And Return First" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#object msgid "Result" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#className msgid "Result class" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureResult#key msgid "Result key" msgstr "" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript() #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript() msgid "Run Fixture Script" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript msgid "Script" msgstr "" #: domainapp.fixture.DomainAppFixturesService#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) #: org.apache.isis.applib.fixturescripts.FixtureScripts#runFixtureScript(org.apache.isis.applib.fixturescripts.FixtureScript,java.lang.String) msgid "Script-specific parameters (if any). The format depends on the script implementation (eg key=value, CSV, JSON, XML etc)" msgstr "" #: domainapp.dom.modules.simple.SimpleObjects#title() msgid "Simple Objects" msgstr "" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToReadingTranslations() msgid "Switch To Reading Translations" msgstr "" #: org.apache.isis.core.runtime.services.i18n.po.TranslationServicePoMenu#switchToWritingTranslations() msgid "Switch To Writing Translations" msgstr "" #: org.apache.isis.applib.fixturescripts.FixtureScript#type msgid "Type" msgstr "" #: domainapp.dom.modules.simple.SimpleObject#updateName() msgid "Update Name" msgstr "" #: domainapp.dom.modules.simple.SimpleObject msgid "name" msgstr "" ############################################################################## # end of .pot file ############################################################################## viewer_restfulobjects.properties000066400000000000000000000054701312550536300343230ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. # # configuration file for the Restful Objects viewer # # the baseUrl for hrefs in the events generated by the RO EventSerializer isis.viewer.restfulobjects.RestfulObjectsSpecEventSerializer.baseUrl=http://localhost:8080/restful/ # renders param details in the (incorrect) form that they were for GSOC2013 viewers # isis.viewer.restfulobjects.gsoc2013.legacyParamDetails=true # whether to honor UI hints, in particular Render(EAGERLY). Defaults to false. #isis.viewer.restfulobjects.honorUiHints=false ############################################################################### # Non-standard configuration settings. # # If enabled of the following are enabled then the viewer is deviating from the # RO spec standard; compatibility may be compromised with RO clients. ############################################################################### # whether to show only object properties for object members # (on the object representation only) # Takes precedence over the other 'suppress' below. #isis.viewer.restfulobjects.objectPropertyValuesOnly=true # whether to suppress "describedby" links. Defaults to false. #isis.viewer.restfulobjects.suppressDescribedByLinks=true # whether to suppress "update" links. Defaults to false. #isis.viewer.restfulobjects.suppressUpdateLink=true # whether to suppress "id" json-prop for object members. Defaults to false. #isis.viewer.restfulobjects.suppressMemberId=true # whether to suppress "links" json-prop for object members # (on the object representation only). Defaults to false. #isis.viewer.restfulobjects.suppressMemberLinks=true # whether to suppress "extensions" json-prop for object members # (on the object representation only). Defaults to false. #isis.viewer.restfulobjects.suppressMemberExtensions=true # whether to suppress "disabledReason" json-prop for object members # (on the object representation only). Defaults to false. #isis.viewer.restfulobjects.suppressMemberDisabledReason=true ############################################################################### java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties000066400000000000000000000056151312550536300326330ustar00rootroot00000000000000# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. # # configuration file for the Wicket viewer # # # The maximum length of titles to display in standalone or parented tables. # Titles longer than this length will be truncated with trailing ellipses (...) # # For example, if set to 12, the title # "Buy milk on 15-Feb-13" will be truncated to "Buy milk ..." # # If set to 0, then only the icon will be shown. # isis.viewer.wicket.maxTitleLengthInStandaloneTables=0 isis.viewer.wicket.maxTitleLengthInParentedTables=0 #isis.viewer.wicket.datePattern=dd-MM-yyyy #isis.viewer.wicket.dateTimePattern=dd-MM-yyyy HH:mm #isis.viewer.wicket.datePickerPattern=DD-MM-YYYY #isis.viewer.wicket.datePattern=dd/MM/yy #isis.viewer.wicket.dateTimePattern=dd/MM/yy HH:mm #isis.viewer.wicket.datePickerPattern=DD/MM/YY # # whether to strip wicket tags from markup (default is true, as they may break some CSS rules) # #isis.viewer.wicket.stripWicketTags=false # # whether to suppress the 'rememberMe' checkbox on the login page (default is false) # #isis.viewer.wicket.suppressRememberMe=false # # if user attempts to access a protected URL before signing in, then as a convenience the viewer will continue # through to that destination after successful login. If you consider this to be a security risk then this flag # disables that behaviour (default is false). # #isis.viewer.wicket.clearOriginalDestination=true # # whether to show action dialogs on their own page rather than as a modal dialog (default is false) # #isis.viewer.wicket.disableModalDialogs=false # # the maximum number of pages to list in bookmark (default is 15) # #isis.viewer.wicket.bookmarkedPages.maxSize=15 # # whether to show the bootstrap theme chooser (defaults false) # #isis.viewer.wicket.themes.showChooser=false isis.viewer.wicket.themes.showChooser=true # # comma-separated list of themes to choose from (default is to show all themes from bootswatch.com). # #isis.viewer.wicket.themes.enabled=bootstrap-theme,Cosmo,Flatly,Darkly,Sandstone,United # # whether to automatically select dependent choice when the choice it depends upon changes. # #isis.viewer.wicket.disableDependentChoiceAutoSelection=falsejava-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml000066400000000000000000000247001312550536300271410ustar00rootroot00000000000000 Simple app about/index.html org.apache.shiro.web.env.EnvironmentLoaderListener ShiroFilter org.apache.shiro.web.servlet.ShiroFilter ShiroFilter /* isis.viewers wicket,restfulobjects IsisLogOnExceptionFilter org.apache.isis.core.webapp.diagnostics.IsisLogOnExceptionFilter IsisLogOnExceptionFilter /wicket/* IsisLogOnExceptionFilter /restful/* ResourceCachingFilter org.apache.isis.core.webapp.content.ResourceCachingFilter CacheTime 86400 ResourceCachingFilter *.js ResourceCachingFilter *.css ResourceCachingFilter *.png ResourceCachingFilter *.jpg ResourceCachingFilter *.gif ResourceCachingFilter *.html ResourceCachingFilter *.swf Resource org.apache.isis.core.webapp.content.ResourceServlet Resource *.css Resource *.png Resource *.jpg Resource *.gif Resource *.js Resource *.html Resource *.swf WicketFilter org.apache.wicket.protocol.http.WicketFilter applicationClassName domainapp.webapp.SimpleApplication WicketFilter /wicket/* configuration development org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap javax.ws.rs.Application org.apache.isis.viewer.restfulobjects.server.RestfulObjectsApplication resteasy.servlet.mapping.prefix /restful/ IsisSessionFilterForRestfulObjects org.apache.isis.core.webapp.IsisSessionFilter authenticationSessionStrategy org.apache.isis.viewer.restfulobjects.server.authentication.AuthenticationSessionStrategyBasicAuth whenNoSession basicAuthChallenge IsisSessionFilterForRestfulObjects RestfulObjectsRestEasyDispatcher IsisTransactionFilterForRestfulObjects org.apache.isis.viewer.restfulobjects.server.webapp.IsisTransactionFilterForRestfulObjects IsisTransactionFilterForRestfulObjects RestfulObjectsRestEasyDispatcher RestfulObjectsRestEasyDispatcher org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher RestfulObjectsRestEasyDispatcher /restful/* java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/about/000077500000000000000000000000001312550536300257225ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/about/images/000077500000000000000000000000001312550536300271675ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/about/images/isis-logo.png000066400000000000000000000335201312550536300316050ustar00rootroot00000000000000PNG  IHDRUgsRGBgAMA a pHYsodtEXtSoftwarePaint.NET v3.5.100r6IDATx^}|Gw}{{1dPql06L9LA"A@lD090&0ȶ#ZꙞa4ɥFS]UꅪB恖-Z +<4j2e@@@2 99999999999999999G9p_:uU]eVḿ{n4=ӟd)9?́<ʁZ~㻻5Yxp GUw[s@s@s 9p[ iʁ?$g?[ȳN yVu54BŁpB.|!PInGs@s r YGȔ% )hɳ";99*+ܾ}[oY*]beƖdC"@B%́<ˁp#JgINN?$J@@8*>/'E[sd%2s~ZH@D[ Nih W^)ۄH;3F̋!h:'۸rL_w 7oޔ9#`(#2@Ve,R ڝ{],kF47!A"-\n@Ƶ˕Fnz7>+vчޠcʅAޟXa}; H"Lgdbݳ7?b&lsJ(C֕œz;"(pta;ApN퉣<Xm?os h7KA [ 5lywQM,x(/We+˞n%ƖC#k2El|!9ٽ|?^>G ?$/N9#h+ 0L۵Z8Ȳu"60#? q׻Hn-h @h pFL{V.7c 2zE%bPݒ8Xadi8,Vt$sxJv\ܝSC.o+׾2?}S[ A!cmŘ]/fKY\[Oh#u΁̭Pȧ]mdPJxY]QF rϕ5X]WfH2VE&N67!9Q9۽\SHRAS_>?/?Hg/A]Q8|\8dȣ G;Ȭ|$Ӫ>ke٧ ˡf1vME [.DY@ w0t{̠UPte9YuŘrHo<7@ "ZS=Ï]i!xlܖ* U7[Wɠk @2]YF2lsH4:Jz $ȉ˹B 91|Pqqrz^'{n@ 1L^&/}V`:*ƕBSz.2tHZ D ,Vꈅ0}߬X隌 Xܻ,hUL{Ht{T>A s Brj˵+Da^jBa`wLWGb\>n߂~&0>;CNǟ\!oבaHPǕXȈepIDI%clm\\\\4Ac|hqc}7|vu9h[@j`B4r X`ʝWV`@_Wn P4 Jͅ U6}9 _#j沾2n(o@=+d8.*KZ=%;<"z|\>\'A B $ӍU@)?ͯtQ#`B W*H7V`sb>ij2x&n`# P!y>ض`G Ⱦpa^n)[(Ƴ@y ߃˜ אCN_z YL)DŽMU@ǕEH,1pd1Np<&+(>n,AL+ŌtZկ>ۍnb*ъ XV1D6.<}B};ribK`eW8] r9G@LtARcX:WK SŝycrwK fS\.ƀ3':GOoۺ=`0ZWA6ɐU //7W@@-   ؑ ǹ/CWEmKΏ %  O@+ƢB2 &|Ir@a LT*ui?oJC!LhP ['5-y> 6'<]stT4B]Hf1s3oϸ}NeV ;Q nVăT*Ӊגț`Oh mkCY.BZYܓ{Ae\ ¨{6sz3e?r 6ꐌZ $TITX"te+A[8hys~V^m[AGW0 B2XD23˓{utܜ|un@ tQLW*>E%jH܏P):qezg2T+O{{'Q.hxUs'>''JqObn #AQ<#0@#C7 fa,&ms1p sDqymܔC}OXSzd>dȷW; SҫDN +BPe+'b겴mQ9ڥ| fKX `x#bucr/gH  .B£_ .f%(nRa<~n^eY;Wtp5auy^<'*j"Eى<xV9||2i!^O=|_8q"6B hՌX#H` ݅v^oƵXV~)o|\xCiu7(d19 .=Eyd \vEfQxԭ $-;-L>pbRU-Q/0(((WoA Ah\"dscqWYro. #JڠpE5P/@q0ʘecP*,yά0]t-8eo~)9(Un#{&TgI6EU>OXNVZ$@ mMCŬZp噜&*onV(k}=!!?1m2PDv=q篌Ĺs>*zcƞ ms@4_u\R=%A>SL3@i'OKl>(O+} HZ,@NN17x1](YEėJ)p!7+T/"fA?ǝZ* \_}Pi=m%Z4t')bX?mvݺo {eJ2m{u [>QfIdDzW=@vUr}ha<aP8Tb '7'~8Qw a 决e>qUw>O57N&E\=^ (4g[v\ka^fS 0,,S0R6qBי8Zu[̨H;4Fy|/ ϟZƚ{ST|;7u=-c8OףƽMAg{@|_}~ fj2ݚ2y=[5eErU};ZHn+,7H&\rŴBX !x;=$<(ljn5.,)Mer}jVy%}|RXxNcp131Ϯ| <Dw*Ok;+WҴ2 P %{8QnpGq=&5NS $T-AN/ʶ%L(|_֢=pN6 \q;-f~C/;2S -GlkFjA+afZu@SܸyC&/ cΚMBW]Vˀ>eg'GgmMH@$}WM{QEf𘲵*f/odY ZC,Fvr{Da;/{" V5B6n44vyH2AL+%XV)oEqYRF%%e1_T(G$S%@Ul"MEyWt+4T"ͶhŒ*#`T;Y5A|g*ʮԒQqt) +mG9/}!85wG#xٿR6TV cU{K#-&58PQɟvYm3an>N2-wڷ(,pZt(e}gΝ1K^&xdF 98=iYյVH~4)|f@~0,p_1 dd]%gǺ4:<*>.Z-cej=[L(.Jy |.PEΤe)@ BgzJrrtҰMIxAms ςWJ]o+vOneH.]f);ϭ+3ty2|yLx[7*Zق/k"(`Es'ʹ9ҺR)fsT4ebTrLo 7c{hypAwS.c]OO>(SEvUj `^ YV ՐY5dJ[ @!cd"1Z(LxˎdUH0F?'ecdb.\SKZX XUƠ&Hm^Yu|J;C"}ҥU7AurNeO4{xn*}ksL*㊊BW ^9Q"eC AM=k8{mō5O,<@}7v,Q tmЃFE3еl 7e+163z*R7'^x#݇l8e#N'W;ǣqp 4,+*$]اD a^08ڵFZvEdex٠L)SK\X (%k# Zk|%w{*r5a pd|M~T;Q+\o20qulO e3AǨ0p%4F6<@hq^ӅQVW3nyM\ZǗoG'{iVAEV k>^Zt:5L%}=$|,hy1ǂ:r 69m=&g,d;$J ʕuCf#o炨[ذo> U&aQ$6~A6X$Ik4X6U5eڐrgQ:  +"?)"w1xcr ȁEe]Yz|.^&WV0â)L@- @R ;jV56n@s"$nWR姽k c.NmeVjUωAPjʜ coFp3: U}e} 6fYApC*& i8'9) q&j>v]Gѳ-zuπiyX--Zt﨓Y*d澒E ↼X7a"@* @kP_- 3zM.ta; f<늇ndMLNSt+j3g\_Xn3ΑWUrQ q fP]VXvu*.' ^AT1$ʝc3bKllΤ /0A;kU&'NRZ9*Hb;%${u2g:!8A /qnVT\tϴќ8L|E/Ā=:l +z6ctGcJַդp-q#(8kL|mf/~mPN7Wwc>YH& }NmQ%L6g1 נ֭'w[,:S3J~)'\YD|{(C9a.[IPe5qFwq;F97r$ii}ǎqP∅d&Jo<Dhi|KRnb{}J;]b%q̫ +Ҳ}# `=>Ơm Rv 9u9ukX$4݀PP8oJ'G$KHPrUJʠ4'm|=@Yv;]QY,|`ApŽY--*O5뜘T[{҇M`ֹ-hOj7[917 ҿnVF;{r03fq`SbOv&R޾ :uM[ؖJ+ O(W/*F ;Kb,[[\q\н ze}ȗx=VAnvi%?iY7^> @4>7v-.;pIWFҢ3\O[aI8L] ~ @²Z Ԕ͚;r@0\AP9=bzxh* f DeU0B 2YZVr\R`OWL\sJryꛉ@g UL6Z ''/N?7WL%0Hʸs, roYYh?FvA/[U:+WYMyRiY%0x[a $36B,OK7 !{tx\juRur<$s5+9_]>D'-eAJ*&D0˹yI\nvH!SG"л| W3E8)dyDYX̪ZVBa0v ؗ'{Mڃ& @>lLՠ>T&JR%+w I$'Agl@T.>oUn0 RuG 쓛v(s'=gP]h0y@k nFu-(+z:cA'ש@ D *@!9Y\t%Ti!1ǚrw/n'^'SYel(3⣋w'qV *ϘrB’ l,d @ܹ-KkIgdyh9r!9ݷ鉬da#VO% :.J q1ql*`~|"@hB `{h\ߟkBaS/=OeLOq#U+OnU4WF},1G>  iAb𙣎2TNI!}lT\UW\ )QZD-?ʲjA*`$ؐT\Қsy:t3(HH7ޙa҄/|ԋOʝdXcZnO|17y?eЖz-(Z*L-WƂ.}F`>R%,ĵ@rv Ou8e7dƈjG 9ٿ;ް2\NX xy\RG@$.= $ + /<+Zs&Pxu\tYۧ{H?Loʊ@_+j]TDf'*@#:ATʁ4#Xh(eUdRoyoC /?}AS/>Okل95a\WfܧK ` ?rbɞ#J\ qWVYG UW_ʨ1eR겪CyYи̨/ #dc}TDF1  b3˚ɺ6 j @~ ܅N"|9߶\8z4-蟠F *€qlI?i ~˲:w]h(iSӽ~^;aN>*$׫'ʏJӍ"ЕɦJ"{o * xok^ .DL;^NZ6T$fƠ+!It0eq\N{ cf2yˆqPvpArge<.Kr2tu;z! DنͥEߛ p|@ ի2|ul=_yYY[Ԭ%KjԐժɲUdy  X#ˡdG"x+C8XR,>"CbERe4*?I4yV&;8O\[,@ۻ{Zo#OR1 U9Ds>lp^\!\+a|2l@Mt6 TT\,@炃%qa_,Z*QP KØ:-^;QA*xPt-V|1XIJ #jVoP_ySUMPc7;g@\< G#OmHu7t<[t~[*1UL$TdTm2A7IMJƣ&ånҠ iب4i4iM:Yo/=_n-ok.6A/6/4aϼ,kՑ5QUkJ5dtyXǩq2&6^بPEȸ22LiI*SJK$P$ 1,qpt֖‰L0x Ѭv83x\Ot'$B߭]b3–L+{9fX6\ǂzhT+8W ?wۢ [uuѤsK[@ '(O^Lx?a.J7\O݌ E!.Hy5Q]1e9DZRee4EqqPL.],y4eD_-IL-c)񠸞J\m-]bl%zV"ۮ6+LeRejHJ5[(%ΓMfK&oK&3$4j> P@LX;_TgDa+e`kvW(ERGʕul4ͽ9Cke}Creٸu$]/ \),  K'er^)^I[{ &UmخH:$FAQIT5UnD].eZ/ "X %D%̑gIߖ⍦JW'K+x$)^MȐkG T>T\dp_7H ]OYu( !eǸ_A?m ><y @Bj?"~nOLaft̚g-ݛn&w朣KD{3;]e&ڬCZtKysQ恔7UN|]޾}[\"O| ivJbTi c &P$cA {[A'@v6 $]hL&]6I,*%VOtǵa h,QڦIdezD`ʴZ"eZ.K&/8>["u;  r-yΙ6i+'u ieX0.L0gq'i|gZܛ䤈-a 3K=v2!|ŗr27mtKZ%J|D_ W\3@ Ȼ&<@,X#N$ nvA[N iT"ZHD+Z$aQ}10Lʌ ' .pQ0~ӪU=Ipq̾,T;1⼹0zdJP(X5/͛K?2o4H*t\$[,6N3!0mE#GOևA9b3d=@Ĵ>L B0-!dZ!-J0ztyu2qQܺu+W$̉sPFP  ߿19*_d,tƏJ7zꁸїI&Lk *8E V-|]L>j wVK4]StU8A} p_aX V+X@Jn(X&uGzCwȱL (!SxU'%́i1Ϙ~|&06ȹl,+#о: p'et5.Uju'Kf &Lπ?ܹY=##i4\:$mwHDH[ @B<9́@-RN囤TiD5%%ߘo27)XdbyVL< 0au_AF{~ۤ2o$x8jT4l1B VEMc}tQ: fJ\ 4q p` ueɾʖ}u/xn>% +}yPZ);Ө[ = FX4us΁P5VgR+-KIn8,vd]e˾<;RύFߴ-Ґ}Du.-.9ā{SyhUt>_ju!%kӌM`ToBו}+%UǾ~2L T!jhU/YI)RT)h}u{q["MxZ(^`QyuFϽ@xje^W'@Nq /q\t8Be4y45Q?^41%8#U <J=6H2t|/7?c+<$'(n T /dR׫99G8_rsyN8q6C%IRIR _h W,aۤsCv=aWY2?g 44.%_W_Gd^:i, Apache Isis™ SimpleApp
Isis Logo

This app has been generated using Apache Isis' SimpleApp archetype, to create a purposefully minimal application that nevertheless includes fixture data, integration tests and BDD specs.

The app itself consists of a single domain class, SimpleObject, along with an equally simple (factory/repository) domain service, SimpleObjects.

To access the app:

  • wicket/

    provides accesses to a generic UI for end-users, Isis' Wicket Viewer. As its name suggests, this viewer is built on top of Apache Wicket™.

  • restful/

    provides access to a RESTful API conformant with the Restful Objects spec. This is part of Apache Isis Core. The implementation technology is JBoss RestEasy.

The default user/password is sven/pass (as configured in the shiro.ini file).

java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/css/000077500000000000000000000000001312550536300254005ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/css/application.css000066400000000000000000000014731312550536300304220ustar00rootroot00000000000000/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/images/000077500000000000000000000000001312550536300260555ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/images/spinning-icon.gif000066400000000000000000000122221312550536300313160ustar00rootroot00000000000000GIF89a(EEEmmm! NETSCAPE2.0!"Created with Chimply.com"! ,((ڋ޼{ڄb扦6nL +*L،JuEUqٮ}}HNk NV1ȦgxᗈHhW2Xih` 998W *!9y[8iZ{ :+a<-A=H !@~\an. _m-!?HoOp,'lsW3[< =8H @I4A? Q6ty>+fD`y~tPd(#q4z)B!-dj>/sL1E_Š%iFY;­\%pE̽+.=|O7 NAFa yC! ,(Ɔ޼E L mbŇL*&(TU:DcOnN'lAٌSnu'D`xXeIy(RYy 2 Hi1yj)z P ں;[{{< <A\pZ, }D}mM8\[P 1PX+LNa:.O=On$5d^|MW/2HlEQE 7xdBFyAʀ3=8HpAQ -(krI+;D54S.'SM:귫vLy`? Sd颵hK*i`_v-g >6qU4rN((]Ôa[FWqSƛtfSף\ZOLe8ÅZwgޑU#97!ي?Xї F{nÑ?_}<_A4oHW1h! "1!]H$~ao%ȉ8B! ,(X0I!ͻ%di(욾p tmx+mpFo!:OtJZvdz5J.Sm|NVk]nKpqwsy{X >x}i-Z.ttSU5Ķk+ű";ѹ9ֹ ۸߷sU :r ౛ .@;ρs6hyh0U\iV gn) Cb"KV4s!0"%^r""H (c4w#:F#!A␀XgGV$1IIEV&$jm)& ]h)F&lBIH! ,(h0I8`(zZihVck,Ϙ`xmH,ȣ/tJZTGr]6-ZgaNxy_N7^oLqrxtz|Y @y~j/s|[0—suSV7l-μuʊUя;# TN?y 7!_=~ `!` >0W'z& y4tL_7ɮ  $ []~0&8:4E4W:y>z,$\”vVfm R 5Q#t;yps bnfƟy4qQ_gWszW`qsa80rn!hHe3^|u١iݴw6[\û7p[rstUuHev'uw"dWF$GPHUMXH9%sFV dl\v9%p򗦐٦ tg'xFPDI3z'F*)^8饘.Pi ! ,(0I8ͻ`(dihlp,tm{rwGpH,rk:(1ΜXvzJ[wކpdL~-m`@qeuUw ~ZopJyyZ\BE-WCs1ŜʛΚ\E 2 [ s0C=g&sA?eV$#SqˇͰV ℂ*K(a P(-,2b0Fs@.eϗ>وlͨM͔diGILS$Ea\Q!GPI I֝b7䬰XO?U0tWQGўԚ+[pF%FWH,%'Uw P_Ugۖo_7Ujy>c6˻`/>;}ktY]vXk L<%Ƌ5c]C-Y.eu_>Ma|IP"e0 ڀh #%"?@aXa؃Hav 'x`)Ň1A}sIFK)5iZ饋b6rkmƣshZ6ߝ>FHf ')GIgi X!8(ZzxH*xֺژXy;[{ٛ9ZnwP\Br 5DP]@vMWQz" 2ȑ$K<2ʕ,[| 3̙4kڼ;java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/scripts/000077500000000000000000000000001312550536300262775ustar00rootroot00000000000000java-design-patterns-1.16.0/naked-objects/webapp/src/main/webapp/scripts/application.js000066400000000000000000000022471312550536300311450ustar00rootroot00000000000000/* * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ $(document).ready(function() { /// here... });java-design-patterns-1.16.0/null-object/000077500000000000000000000000001312550536300200465ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/README.md000066400000000000000000000023051312550536300213250ustar00rootroot00000000000000--- layout: pattern title: Null Object folder: null-object permalink: /patterns/null-object/ pumlid: JSV14SCm20J0Lk829Fxf1cF6bWSX3JhYzfDdVhjRSx4yDCDU5p3NcoZugMV3bNik3HaETLGPdPhbm-2WcpzS3btjz38PqF15dTSFv6bMndwhW1Jo_vhHwynkNm00 categories: Behavioral tags: - Java - Difficulty-Beginner --- ## Intent In most object-oriented languages, such as Java or C#, references may be null. These references need to be checked to ensure they are not null before invoking any methods, because methods typically cannot be invoked on null references. Instead of using a null reference to convey absence of an object (for instance, a non-existent customer), one uses an object which implements the expected interface, but whose method body is empty. The advantage of this approach over a working default implementation is that a Null Object is very predictable and has no side effects: it does nothing. ![alt text](./etc/null-object.png "Null Object") ## Applicability Use the Null Object pattern when * you want to avoid explicit null checks and keep the algorithm elegant and easy to read. ## Credits * [Pattern Languages of Program Design](http://www.amazon.com/Pattern-Languages-Program-Design-Coplien/dp/0201607344/ref=sr_1_1) java-design-patterns-1.16.0/null-object/etc/000077500000000000000000000000001312550536300206215ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/etc/null-object.png000066400000000000000000000333651312550536300235570ustar00rootroot00000000000000PNG  IHDR9_6IDATxo&}]li_ݼ:m^rmqv/wc,ß,dc,qv1Cly',lg5dU"cEZe{']tڑr/W]U]]]QO?c!a@6&/dI}/?'o/g7_z|$L 76m0Naɉ;w3/9LZF5^,$lcQݗp$9耿Í?~㉗Y[G^ yݣ;C0F,>egzwCtGiܢ>$w+|Ȩ̌OUvɨK8YOz[ϑ?d陻" ӷm2= ҌDiTM@_"#^I U)9GN/dI>+o=w?/d὇?^{{B|?IV$24f\9n4/Ӵr3 F6#a꾄%DX;Grw] WK8YY N5X")?>T9MKwdF r-8NՉ6&#a꾄%D~+u_'rO-C ?e-aY|'GvbQxb5u LT%,'ž_O}q}QJn;̌4OCv/)|@LMDu_ɒ|",o=7-=~ϼKozzo~z(Pa)-ge[ДaMG`N~T%,3F!]}ñ;nGenY,f 0p(>PjnKk22|izT%,?NÓ>ߛǞ FsCN  a ,l , saaaa3 4 ÜAXؠAX  0g6h7[Mx2ZČaDG^hU̫_Zz lD'P,T['r~j܅Jenn>޵-4\3\ R1seDߒvA|²","a+ $G- (¢T@QxOV|)0H§+ILIhf <ɾ al;i|]WL[*"=@%g g@l@z‡ߥctD k129_3#>*}sd3> E lU'qx+^XѺ-¯"_YoVIf֮}","aD"!;8VV#Q]܃'_l| TaG [ٙ!WUofp+ZFX҆4FG[z$FcQ!@XDֱܜ8H8>M^e.HHD ɿz+2o2}?S AX (gan(AXiǝ&@9A0 a ,l , saa2agf.@PIi+vSdIµ<@6ɒ@XAXؠAX  FG@L½lV  FůtuO%l_rEЇ͹pZAJR(ҨAæ,g,  Fm#ɋ ['z7~^or _O= G  BӤI2sC/-f9nP8[N9iM22@$yi dcNg9'w>uo% iʽ&xaB RZ[B(edǹ&Cu hcLi6ҒGcf}#2RtKaJsb5f9[B?zZqVzxҕL"e_ Q+˷isq`񭨄bt35a>' b%˪d i8z|y(Af +D te*v߽&,?l:KaוS_}ؒSJW2 Ϗ%l8vmɎ-VnVVuYnnb$kȘُIrA”=cHJ/GnO\KdI6 0T,)K??OK؟ȮlG yd  ܗ#GyU}]7۱h+Pَ"T}Y@(;%\-`Or3uc A^8k7 {j7~t/Y&kh,x5? >/Պ>Oeڗo)Է/(ZY@X :8Nu㻯ʝ}ow;>L8=)&,;P+^HޟśqX--(:+ַ/(΄%ֺg/dA~^;`WQ%@ pbgqpV*>2UŁlH 3 }aDD :NԥZ匸i͐hky36,͇y.Da]vaV n6,ӥDa]vqIN{؎Rf:Sav , saaaa3 4 ÜAXؠAX  šs&Wue 4ՓZ#oS|̸GE7k$L,[PF}"bt g&ڊWuقJ{ڀ%,"Lj)ae5Pt1^n1fl"^[/p9wwni3ƫu dTeJ([9A7>p1Y;KXD)ameWr{dKٗ$mi&߮ށ:@v/bHXWHf7y!Qr.o3gMvoLxh$,"߈#a-fWƫzLuI#,Q*vX#1G ݽ ^=E}$^Q-I;;G]KvSDSN-e.&^T{(̽2s_W۽/a˸nuU=j4c|{m_ u me@^w+aNav , saaaa3 4 ÜAXؠAX  $ɛ^"NTLXahmZsnG2&}"bt Px͈шW$oۏ)aHķ=v0d=J b}$ls.u^(--y-#|El k9c<'鏲e!2+^ e7N- d@v/bH2?|aʁ0AAɛE}$ܗQ-i"|ElO ;1>۳?Җ?H&߯"{_–-#|3veu ٌ[F2&+aNU^-#|X' 0g ;h9A0 a ,l , saaa:]5g{9dO~k lmKn}h#giMK}"bt k/c|՜%qp$s'!]Ez}$l9[Ӵ@yi:Y@W8I^JTEl k9cvXxv* @xU>c;^YxucTk_L"b;F …q2Ux8ފ7Qp֘$ YjJܗ۟[5l$g,~11I ^UoH&aF!&4 O⥄t05얶/0AE=޹7Ġ%Po#a¥c(UB[iS Mq[8_X!cخ!aϝ;5i7ސRᔞt |i|̹?Ӈ6F}dǽsι#GQ؇%H0M0# p]\ k׮ DlWogY/ڀm2aZ'2CL$ qѐ:/+ SdK7$9;vɦ"(^ noo !bgpj^ 2T{1[*N.bH';}HǡGМ :¹stc9SxV,nPfzZ-`{Jةvx&b)lwZ^3;sZ7eT%4cXOjSps ۰~?~nnn2]Dl 6sÕ\?׏9R%v3ۜWpX?w\ǠҕX l"F:x`O)_gkjLD1 MuIVX҉ ro|e $c J䤃*m`s2i3:‚G!:wܮ] |k}+޹s!\vF@XoDz:c9FZZZ"gmԾ7bvv? V!8$ [T"DrhAְ q0a }sڳg榩@X!;lСCmaMtPc)T"_ S7 IXPyq-v+kA"C bf~5C 6 [ ai U&lBPYNuKD] E^Yt 9MX?G]v={luA7APg4a [NqFߓ [CP9MXtUHuAr Lܳgf0aT)C%,9׶Wb^C1u }KXMwkjPW'lMA-WK:a+] %yD\Vޫ^e;5JMto fхi//)SHlUήTL,T4E~-{ %|43C"ZPjH*V6(ۏ&lf+'!KX8&iG,p4 6:ogp_w 7MgIMiNzOJQ9m6/Bphiz" KNN% R`K!ڳg7l9)"5=lmm,vRV@) ;M{jN8`MZ{Du-,,8u;b!y@Xr{%|O*UW]u 7tܹ/xvv;tV`< 4رmx;.Do{.2k- J ;7wrI)qb9 ))3 Х%ڙ3gfffU]YY*!, AN uR]A uR²ѹ;wa!AZ$,ڵ֜ A%5Bح`qdkqVb [ڬۣMX`+齒Ν;Ї Tssm1N}FRFMQc;}z2,Yv-AT6æWKOc #l0@6*}҂vҒ' ؋.K.GVNk]OdϞ=W]u& Oº"{!Au ,.]@Xw Ba5 A u ,.Woգotm/ea!&ܗ_Yyd!- \7FM] BW>s,5d=2YAXړ{k-O^=ȚG6aT ,A ®}롻7>=z?xVurh7mcVR ; Ө%a!*!'OǾy-'"GK?76ŽrWMH {nг\Ǯy8:/u/Yk~]Π6<ɏleMJ ?Brtns'W@#|>쩸OJ6&SB1C FJڬ Brw~;~uoOEsro2YC|({haa!w9Aؿs?:]Oɚ{NGi?%m҇Z^+a!w9AX_[}]ooE(P%,D`JW0 ,A6~}ߺo"kxrktZd[+ ACy t{w/_#&@", ºk|AX] a!w ºk|AX] a!w5EVz{ͶV'#1;xX&))@X]a{AX3 ߕCXZvagm?ab%^2Ĵ 0 BQJSihpfy<6"aG\\VV{oWBP",p%17)"Ei"|LA)JB%6!a/YIGC:&dI Kw ^ߋoa!SRVrRe:n@a>fHk I:ɂUdS2:G}Tp2=f}P AV &#Kh]߁ǀ.U<a!;rAj<׸'*;rʡ9f%a!CMqتe G]DuX*Iqd63xͽ(:*s rueǘ f:A|,vYr$Uފ(L_ A]a _ ,.ְ_ ,.]@Xw Ba5 A u ,;<3srIi12 /a}X\ a!w ºk|t+\ ߅> A u ,.]@Xw Ba5 A u ,V hIXk${k;xƢtK"fΨqf+e T|eJrN Rf6m|.ax?/-]GKb)#8. AP9i?m_}[OrZ:Sn3`kkT֛?g`cv? r0MKmV鋢%߉h3B|C@Xꑊ {w>wځoy:S_RJRʨ(M`=%g:jq4$ifA3Nmė 5}9&`MˏKbG^7=yKVrq \8%Ĕv3䔶,egLJVMQ!R3'n=y_/YnvcCSU~u0f_- ( iɲ a!g*&ێz+{0Yru,هe%Vt,VʞQEX+oSB4ռ~׏>Wئ`:SrA^0Jg,eGxW-CXB?[랓fk6dOOщ.g#:2;HT,Fpҹs|V#ٸ@[ڶ5Zu7 e쩴dLue&|>V2~X^l7 ߅Z ºk|AX] a!w a9CP)ൠ,j@TVkEHAEכBkEZq`"\60kHa[ʚ x2n,BNa!jƁIJ&t)"!ek AP57 M.R@JrY| ,A-8PVZmAcHAPkE^Br-j0.R nV, APZqPHXi "JZusZqPLXi "qܾ"8^& AS/jTpe@XzR㠂/BPԗ^Qe@Xꘐ[]@Xw Ba5 A u ,.]Z%l[K ^K java-design-patterns-1.16.0/null-object/etc/null-object.urm.puml000066400000000000000000000016241312550536300245430ustar00rootroot00000000000000@startuml package com.iluwatar.nullobject { class App { + App() + main(args : String[]) {static} } interface Node { + getLeft() : Node {abstract} + getName() : String {abstract} + getRight() : Node {abstract} + getTreeSize() : int {abstract} + walk() {abstract} } class NodeImpl { - LOGGER : Logger {static} - left : Node - name : String - right : Node + NodeImpl(name : String, left : Node, right : Node) + getLeft() : Node + getName() : String + getRight() : Node + getTreeSize() : int + walk() } class NullNode { - instance : NullNode {static} - NullNode() + getInstance() : NullNode {static} + getLeft() : Node + getName() : String + getRight() : Node + getTreeSize() : int + walk() } } NullNode --> "-instance" NullNode NodeImpl --> "-left" Node NodeImpl ..|> Node NullNode ..|> Node @endumljava-design-patterns-1.16.0/null-object/pom.xml000066400000000000000000000036021312550536300213640ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 null-object junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/null-object/src/000077500000000000000000000000001312550536300206355ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/main/000077500000000000000000000000001312550536300215615ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/main/java/000077500000000000000000000000001312550536300225025ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/main/java/com/000077500000000000000000000000001312550536300232605ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251105ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/main/java/com/iluwatar/nullobject/000077500000000000000000000000001312550536300272515ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/main/java/com/iluwatar/nullobject/App.java000066400000000000000000000036741312550536300306460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; /** * * Null Object pattern replaces null values with neutral objects. Many times this simplifies * algorithms since no extra null checks are needed. *

* In this example we build a binary tree where the nodes are either normal or Null Objects. No null * values are used in the tree making the traversal easy. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Node root = new NodeImpl("1", new NodeImpl("11", new NodeImpl("111", NullNode.getInstance(), NullNode.getInstance()), NullNode.getInstance()), new NodeImpl("12", NullNode.getInstance(), new NodeImpl("122", NullNode.getInstance(), NullNode.getInstance()))); root.walk(); } } java-design-patterns-1.16.0/null-object/src/main/java/com/iluwatar/nullobject/Node.java000066400000000000000000000025621312550536300310060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; /** * * Interface for binary tree node. * */ public interface Node { String getName(); int getTreeSize(); Node getLeft(); Node getRight(); void walk(); } java-design-patterns-1.16.0/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java000066400000000000000000000042521312550536300316260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Implementation for binary tree's normal nodes. * */ public class NodeImpl implements Node { private static final Logger LOGGER = LoggerFactory.getLogger(NodeImpl.class); private final String name; private final Node left; private final Node right; /** * Constructor */ public NodeImpl(String name, Node left, Node right) { this.name = name; this.left = left; this.right = right; } @Override public int getTreeSize() { return 1 + left.getTreeSize() + right.getTreeSize(); } @Override public Node getLeft() { return left; } @Override public Node getRight() { return right; } @Override public String getName() { return name; } @Override public void walk() { LOGGER.info(name); if (left.getTreeSize() > 0) { left.walk(); } if (right.getTreeSize() > 0) { right.walk(); } } } java-design-patterns-1.16.0/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java000066400000000000000000000034271312550536300316420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; /** * * Null Object implementation for binary tree node. *

* Implemented as Singleton, since all the NullNodes are the same. * */ public final class NullNode implements Node { private static NullNode instance = new NullNode(); private NullNode() {} public static NullNode getInstance() { return instance; } @Override public int getTreeSize() { return 0; } @Override public Node getLeft() { return null; } @Override public Node getRight() { return null; } @Override public String getName() { return null; } @Override public void walk() { // Do nothing } } java-design-patterns-1.16.0/null-object/src/test/000077500000000000000000000000001312550536300216145ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/test/java/000077500000000000000000000000001312550536300225355ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/test/java/com/000077500000000000000000000000001312550536300233135ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251435ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/test/java/com/iluwatar/nullobject/000077500000000000000000000000001312550536300273045ustar00rootroot00000000000000java-design-patterns-1.16.0/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java000066400000000000000000000024771312550536300315410ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java000066400000000000000000000036261312550536300325360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; import org.junit.Test; import static org.junit.Assert.*; /** * Date: 12/26/15 - 11:47 PM * * @author Jeroen Meulemeester */ public class NullNodeTest { /** * Verify if {@link NullNode#getInstance()} actually returns the same object instance */ @Test public void testGetInstance() { final NullNode instance = NullNode.getInstance(); assertNotNull(instance); assertSame(instance, NullNode.getInstance()); } @Test public void testFields() { final NullNode node = NullNode.getInstance(); assertEquals(0, node.getTreeSize()); assertNull(node.getName()); assertNull(node.getLeft()); assertNull(node.getRight()); } @Test public void testWalk() throws Exception { NullNode.getInstance().walk(); } } java-design-patterns-1.16.0/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java000066400000000000000000000120631312550536300317100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.nullobject; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.*; /** * Date: 12/26/15 - 11:44 PM * * @author Jeroen Meulemeester */ public class TreeTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * During the tests, the same tree structure will be used, shown below. End points will be * terminated with the {@link NullNode} instance. * * 

   * root
   * ├── level1_a
   * │   ├── level2_a
   * │   │   ├── level3_a
   * │   │   └── level3_b
   * │   └── level2_b
   * └── level1_b
   *
*/ private static final Node TREE_ROOT; static { final NodeImpl level1B = new NodeImpl("level1_b", NullNode.getInstance(), NullNode.getInstance()); final NodeImpl level2B = new NodeImpl("level2_b", NullNode.getInstance(), NullNode.getInstance()); final NodeImpl level3A = new NodeImpl("level3_a", NullNode.getInstance(), NullNode.getInstance()); final NodeImpl level3B = new NodeImpl("level3_b", NullNode.getInstance(), NullNode.getInstance()); final NodeImpl level2A = new NodeImpl("level2_a", level3A, level3B); final NodeImpl level1A = new NodeImpl("level1_a", level2A, level2B); TREE_ROOT = new NodeImpl("root", level1A, level1B); } /** * Verify the number of items in the tree. The root has 6 children so we expect a {@link * Node#getTreeSize()} of 7 {@link Node}s in total. */ @Test public void testTreeSize() { assertEquals(7, TREE_ROOT.getTreeSize()); } /** * Walk through the tree and verify if every item is handled */ @Test public void testWalk() { TREE_ROOT.walk(); assertTrue(appender.logContains("root")); assertTrue(appender.logContains("level1_a")); assertTrue(appender.logContains("level2_a")); assertTrue(appender.logContains("level3_a")); assertTrue(appender.logContains("level3_b")); assertTrue(appender.logContains("level2_b")); assertTrue(appender.logContains("level1_b")); assertEquals(7, appender.getLogSize()); } @Test public void testGetLeft() throws Exception { final Node level1 = TREE_ROOT.getLeft(); assertNotNull(level1); assertEquals("level1_a", level1.getName()); assertEquals(5, level1.getTreeSize()); final Node level2 = level1.getLeft(); assertNotNull(level2); assertEquals("level2_a", level2.getName()); assertEquals(3, level2.getTreeSize()); final Node level3 = level2.getLeft(); assertNotNull(level3); assertEquals("level3_a", level3.getName()); assertEquals(1, level3.getTreeSize()); assertSame(NullNode.getInstance(), level3.getRight()); assertSame(NullNode.getInstance(), level3.getLeft()); } @Test public void testGetRight() throws Exception { final Node level1 = TREE_ROOT.getRight(); assertNotNull(level1); assertEquals("level1_b", level1.getName()); assertEquals(1, level1.getTreeSize()); assertSame(NullNode.getInstance(), level1.getRight()); assertSame(NullNode.getInstance(), level1.getLeft()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getMessage().equals(message)); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/object-mother/000077500000000000000000000000001312550536300203725ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/README.md000066400000000000000000000021121312550536300216450ustar00rootroot00000000000000--- layout: pattern title: Object Mother folder: object-mother permalink: /patterns/object-mother/ pumlid: LOr13iCW30JlVKNx0E3UKxxYW9KGWK7sklb-wR6dtLbfj9k15DxRurKbDo_isfudCEsTaj8TZuhJTpVMF0GiY7dqL9lVjDHqqOT2OQk7X4a0grZgPAkaiL-S4Vh0kOYH_vVeskFyVMyiPUKN categories: Creational tags: - Java - Difficulty-Beginner --- ## Object Mother Define a factory of immutable content with separated builder and factory interfaces. ![alt text](./etc/object-mother.png "Object Mother") ## Applicability Use the Object Mother pattern when * You want consistent objects over several tests * you want to reduce code for creation of objects in tests * every test should run with fresh data ## Credits * [Answer by David Brown](http://stackoverflow.com/questions/923319/what-is-an-objectmother) to the stackoverflow question: [What is an ObjectMother?](http://stackoverflow.com/questions/923319/what-is-an-objectmother) * [c2wiki - Object Mother](http://c2.com/cgi/wiki?ObjectMother) * [Nat Pryce - Test Data Builders: an alternative to the Object Mother pattern](http://www.natpryce.com/articles/000714.html) java-design-patterns-1.16.0/object-mother/etc/000077500000000000000000000000001312550536300211455ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/etc/object-mother.png000066400000000000000000000463711312550536300244300ustar00rootroot00000000000000PNG  IHDRqLIDATxm\y?E`Cc vXJP\FEJ7%"䰖{MYWd1.rIF+lӥRҴިXԢLIHB_-?n̜93sΞ{^fg?<8;wyv;ϙg0}+ J '(12q5#(12!5l-OP8 C8 C8 C8 Cx6iP;Grp|ALFѤ7ؤJJq|jUI,4cnj;JY(O sbONJ/'PZርd.914c \Xb[ *cИdpYv,+>*1VPbe%JLSTaaswUPb_ %Va(/@]h0C.կǾr_>oxmQUf(/@]+{Ƴ}gɕK̫{دs%*=-ܣ˜%xį {_wk~/=,LTxQhnL@U<~3x?K;?xO^yٷ%΃ShUg=9-(Lvb6ymo^d9ߝJ|c޼}W|U\{7}O DtBl* gZﹸP댹#o)1,UV߻y5W>_w~s-Llwy|[7wリ-5^.%DLdD.wkLw *o">x^?2?vˬ>qkrS:8 YJ,L@U?u[7:/~u~/]_|l雷 +LD!y[vƙgu'櫿~ϵ:y?X]~y?rslq?*3sbNTz'8}>_Q7_?7X)qV>\;vzc@q}%4nD$`(w^>}R>7~GJ\+e~#Ŵ31V{1h[=9qlZJw_kM%JGI2!+T&r뼪z⁞)Ey}O4+e*1c`պܪӅr[6Mg^ *xVdqϪ僚Z=~WJ u1ߕxu %Va(/@]h0C.aJ싡P]1GGuOQb 0l@C.aXgJL&w (qqL@P0ɲL(1%ê+1,d@]P0ɲL(1%rL(1e%:\Yg+vIē),_;%J uiOWhײ:Ju&KG}C`PV}7f7U#?\Fۢ3gmkFrQ*m[wzڷRac|=3/FbrG0SD5H3ٞdYXn#~xQ[҅BӃY]K K_Ť uG+쫭n4L=KL%V58}RXX&l0lMXT=vٸ}%N@8ROi= %UO\zVo(/w:ᗔ˗Jޜ#iˠT&iXtYt:7WM%ƚ18<,⺱>mgS[:\/!YT.u#d:Zbrl^Vbr^v:fB3VbE=Dy%m780@5:}bOGT+ҟo&Va(/F#:Q{|5PS9%,ϢϏWɽ?i5)Y9\4O+*XK敥3;: C}1CR%&;f}e@R'}h/m^Tb,n%X'0 %hzr6,8&u9Hgɢ$l&ω=: C}1i'qRdǴ0S] FlĮ muּr;Cs/)n63gkt a؜J<³ſr;CsֽRҹuKݧm%?)br;wo8|#(q6ӏQ5mDEt JܽPr1͊_jssB;ibYR C%%N:Ŀu,-6tn@w:%pFI~bHK!ͭ'.%%+)[@fK_JJc컫伬{'cW⿾w'။nۢkpFĪfό_m+=vTye duhp9/1+Wwǎ}71-JDyѯPOi]4[ջLƜu$`m-9ۖ7ׁ=|1]:;>t~ۢDb)9 z~@F_f*ĚI{uYire̖(/w:3m7}7 ߢ:I帅ʚ0|RVh;@8{Vr=h# du@}19ɭ+F/ ʟUrｼ×ƏT62ondWW:v4}8ey&d#%3r/=nMuiuTb4L=ҙ}O}Ē&/?DrQX+:JU -Om˂J,i>g2a~g>~W%g?yPXeb%._h0a.n>Տ ۉtG8VFhdՋ6De4ÒZD}q: C}1Ǐ~|~Ƨn_M~ۢD>RE/XPL%60 %hz3ۿ'?woD N'qQ9:k}q: C}1_}l>{=Wt~oαxoW_G7 Z6#l! 8@[ľ StBno׎}[2<-2Q8|Va+qi2mU17g}ݹ_ ï.#=Ov}qAð9[L(q;Cs/)n6|/__\N@Мuo8|#!3mzG]`:9qkɿ/\-K Ο%0 %hz$P_tx3?ʙ[wzE|}|!b`sMt8ws뮢 {b4L=K ľ S8B2 (JLô8aw_ώ SМK -{^p,0!ab# P lЈk[ZRAs/)u\b4L=KJݶ֌w7#^C9*?BB+`4L=K 0l%>_ؘZLt#CJlC6Aq%%j+ O߽蹷8u/[%vRsd-Gzn_1ZNR񝀎aV0b F$Zmȶ9lPK辳y㴴S((U) Kb*;-Vi#<^;S9px(w_4\VO:6ܼyMP#og0QY%Y/9WJ0.Iuy'cPb~I)qYKvI_\k~e2b%8:VwC/Wzsbͩ(N@Ǡ8@Re,,m;8Mʽ;乲vڿ֥.m'B^~4HN;t J/) /JwL%֒Oqv\nՂ_J#߹;N^|~!^Rf+TbmHi&?-05M7tС3k8@RNoO&Dq橫gS_p2 @l4w)궭C~c=/bO~򓒚;YEw?sX$~M4-m6|ZnN'XkΗ?|LO}bG KްOQPگٳ'|]5r~kF5|;X$~6i4E+ 㣣Z#rsY}G:L8k׮[nٳ-jڌ&oѳ,<>⭪_J'x㍢[ }/ۊ80iTȰc!B<;|~Rkr8K+aJ|…G+z%sJ싉<‰ԧ>uUW8kRfB4K2 'iX/zn.nn._^dq+&:Z|LP{y9}KT[8r1@zEWE?XEXomub5SC:nJEԨ}Czbl&[32sx!t+s}Q3܅es *9 :={??c۴aJ싡čc!7ʢrj:a,q :TbYVb{:,gȫfCoԯ ,E'?I: C}1ښ? !7ʢrEJ4R|Ffditz; s:|hK] naJ4HEw:y:ÿO>={$wJͣLԺ17g^!p]L4` Y7˺zJʎ@7//X=%fze+"CJܽ@Rn*/e_JnWBǠ/s5;_uL$:$(q7m*bz#%pF ~}CYLLlN@Ǡ8Be_Yc镐'ppF ~}(F#8|_~QOfg2qF ~ľ S;|g2s+~3U2ex[e C}1)q>'eJ3nևZPj*k~: C}1)r'eVB%TNyg^&aJ0Hw<)3;lҷv lIԨ>n~Mve@[ľ S9|Ǔ2*-~N%.Lh0a"vRAdrUYt:-)Lh0arR8kV^V7mu֧3N@ǔ;O|y8|#a~ס҈-W2b+

fN&aJ0H0)SZ.Mh0a"xRQb#%K7qo0 %hz;u+(e7mub4L=R]NʜCiqx'n@[0+A6)?qo8 G^ľ^sMsմJJu%L  o◙ul)1+^$(q7Ki/۰zJJW Jܽ@e_JJW Jܽ@e_JJW Jܽ@rwlPi+ _azet!0 ~YM_zSW'PVl/~v[L(i_|C˶C./ulPb_ %VlPb_ %Va(/@]h0C.aJ싡P0 %Pb mub(1ԅ: k^FWL5&t]G.(q6ϗe%1%@ðJ<3etgX*JIrʂҌ;[| #-}'R2Zhiݶq.Wyi/=_W"vS&Y2߱,^3'L *ttOӖp]Z=%2kIn6t2.JNi8˶3q.r'Ar_ht88eVO4L}R婤NN9SKrxٿ݊wڟ|w /k 2N٥S*9/KV#fK)^xgLQ;rj=/SSm]q.O+伌vtVg)D+:_N(qq.O[y)(1ԧ崒bLN9E>/JDc}^(J u1~iXxq. %Pbmuq. %Pb mub(1ԅ: C}1B[ľJ uPb_ %Va(/@]hð8ZdϭZھɄev#;P8 Gs^+df˵QTSY56%@ðJ<#LuLVr簴W%KjjjVrJę̑/Ϧ6k}J ж63*1jTdzBXdՙ`-r=mT)qvJVK-V̉[)*)Uȳ!^kNj;/k ItPWCJ%3gx4qv;9eafE1^O%f!L9`.8◳B8BY+\FE3*vRUr^Q⼤E?7=J~UNS:JiȌ6/4, /U3+l4vx0i_IVwr*l2 Ց8ZOr^VQ,!,8Q[ŸCgk[3/04s(񯢧X%yޢ+7:Vi9/m92Qb"Ke8TbGPӾ :]LϮ4> v)q!yas6 J uY ~=-/+KHkgumR4;bKƫ'rMC(1f *tݺ nH%Pbj]Pmk;b(1ԅ: C}1B[ľJ uJk;-3 K%N%A0`YA0`YA0`YA0`Yi[UR|VhʱK2+ȴ{|fJYRD6QPb(\x"YRļ33@-cZe.!̱ %J R7<}szԕbCtJN kZ$lh3d"3L`e;m RSh CV"%>£zN0WN՗-,J̬Y?ב:}F3h]H]厢]gZZ˟qVO#X CV"%pW69.^BSoN]ۙK&2]gw ᝣ|TN'Ǝ%%;{f%X)G~vD/EL%6.EG+Rb9q}7}(1P?6.my@9Ixlu%6;:m'5 _;:].N_nΈ@DɈw}6_lvs5F)VWbqFM;([%kGV%vŇYLbT rQn-ŴdWuJ + ]R⻟ܠBJyc(1a(1a(1a(1, \@=A%eF+1-[vzG?}TtJ`%?AC! c+1?AC! c ~0)1x J5Zc$^]AC! cePb-U$4&T=y ~f\(%RkȕZ.Pbg%HRgVgWf8_ձd]R-xj(1~ ^PW+s ͔NinD7;:rBKg}b5*U٤QԢ[#'vȳQBcXZQRœ.oihm8TV8bl/KxN 1x2(qARPS]SŶTUT:1K R %0k[ %0kPbPb%J %0kPbPb%J %0kPbPb %~W?śUlEPbq%|B?={7o VPbY%rcxow47)yc{XSJbQyDm!m/ֹu[S.7e(1~ ^Ӡ櫢7G}1x?^<*z*L+q&L֌E JkuԊZȞvJUYJ_?J 81xMJvOgɑG}[bo-çouJ^Hfr"%2fHv{߸$ULJeoXdn z8Q֜'ދJP(1@~ ^Ӡwk>cD}~[x~kn|51]S UyuFw冦ʬ URDY͜Ķ=uQ-ߦZ_DKF%0ko~kISgo'N&Id,o*Sbkߙ}%Vwy%JGESSKXW4knu_#~/]_|l雷 KdXIGL{~aRVbc_be}be .Q 5y%.A%~Wk?t?::~y?ro$\XɌu:c^x~UϤ]J,/#sbCKcXƷOs_=pS.="=}7p;`05 #YJeV7;e󉍁ʵN.`[)6]*#~w*qi?iV1~}߼}?;AWl]\{FoC5+4Sԧ[ر.>J "1xMwJ,9ֺʽtH֠oGw&j4W8K9.lLEc jejqJUf.gWb_*J P+%jɧR&IR˫NgFbJ,!E.*7޾*A7WK:ߑ}|ܛOm\*J P#%7|2sCRt(8$T#ŒAN˯J 6ߗm6Q)o8ˎu(1@coXTH LVn;/rvf)qY~ ^sbGC 3!n,WZXOZ<21p*zu^Usb=@OۢYPbkS7O7j(1~ ^W?=gj%6?AC! c+1?AC! c+1?ٵ{  c6O AנX1x JJ aנX1x #FlA5X C5(1Vb(1~ ^c%C5ux {?׻H`J aTW=/|8~zFl.XC5uX۵6?AC! cEӓQ~μ-8hxM-sthK2_Ы%ENI 軔]j};lC! cr%>_ؘZ# 5/+Jmɡ-L"&JY]wN^P 5\Xߥ uWb=ZWKC5%J|w?7z'N]9!6Km?)%V}eR"Kh[VIjƎ]lSh}Ni cU%ujvX#D/ybVQ}GAbbPbH辳y㴴S(4rm$Bv?hQ3(n9Ne;TLR\FT!>k(}/ƿ3Fu4IoVkC! c"%pW69.^BCSu:䤽TuR}2T\_sisܾ^+B(C OX{qF3ug %0kG~vD/E[D:8[]F 8x'鱥^JkF?)R}jK[6!6v< 8y>5¶iXIh%6v)5Q,:\g°yta$F]!:mQ"4@5%#߹;N^|~!^ꢞj@nD+)"FQŤs4;z#g-.|:?bK|;$(`^c%vŇYLbc}FsOOZd2U,&kʕ! VM[,)J ״J aנX1x JJ aנX1xM%˯O~C؈_*V %0kj)d/ѿT`J a̧ĒkPb4Vb(1~ ^SKMEKfS,Qw).cU[|\sKTvTʓci1xMyDڥؘD!re],V}*q$s,6c̅3?)Q{so=q !*3ItZl{9D/m4ZR09eA%qMϗP>!4FJ#PU98*܎cp"]|Q DH75Y%򗡽q??TPA{QbH辳y㴴S(2,L*P}(N6l6:pʶi ςT9VJ,D+)̇23.f^JuAUJi\F9vC5EJ|ձOmr\ZfR=ڜY7wU'ٹArm$ORb?=3顑~Q?Q"RPrS>uYa}VŎC5EJ|#n?w{b;"`FpsQ.3*N[U$cjCnNm(`sIPC5EJ|OzicC6D^'N[T HcJEĮʺ0aJe:TUԕDN78_tz$1xM n|8yykņxꪖ 2FNɸqG52)qҞJfg2#br^[nkbp]!$>RکITX(1~ ^Sp2IlT[M{yV:3f1-|1xMc%VA{&t%rl-n`ҳ1x JJ aנX1x"Jg{↢$1x̀>1Vl(1~ ^SGɊrC5\LC5)Z5?!:J aRbESWN&ܰW-@/gQo}tU NJT 3C! cr%>dK1m9qJOP~ߺC5EJ|G=/E^'ˊ2eYy]4嶸rj܎㻕X\_#C]PUc93.pu%Pkc˛_9x) :=V^Ϯ\IJЭzbTُ)9S5} R.i'8~C5EJ|#n?w{b;"}Fy %vvweHS߿*1xMu%PkbC! c:JLVĕ3?čb<7?O%K֪1x iPb+N5ΰSD,b9:Lp,0?)W#/HVSGJ+MXrb(1~ ^S7<}szԕbCT٣g؈3@Fkv6b۲ 1cQ珐e* ):?Q]8ՓF:RbUq҉? TL1`?)R/U7_0i>>J + ~ ^SW?s_'#x) k)dW a`R#c[k,NPb[>D-/EUJ)>륍K]Oz,:mŁSH$]+zu[JmJtz3s28~ڙ. %U?)uνq Ҫc2!{WRR}Ė3FlYL3F?#PbK-?Y졪U#тE ה(.>b5mvwjvTB3f1-|y %0kʕI=\/d %0k]V %0kPbPbf%޳=XĝBakbC! c:JLVĕ3?čb<7?O%K֪1x iPb+N5"\I%L[_ɹO(Xʪ hPb\x"YRlL[xN\e+RiiM٬%*[v %0kJn[OrBl?{LvhF,r[$Wdbϻh,2N8E|ZrL8ŵ9uI#dd]_KR力_J PH辳y㴴S(dYTY6K.d t*kd)_;ٰʐ8%/)տTJg2lPb*5EJ|ձOmr\ZG]dLJʳĎ륍K]OThS#+14vt+zZl(Uy>%Nܚ:F;ۣ䑶L;\@Tp8d_Fz:cttT?)Rba׍'/om>/:<d5Ғ5b R&ţb-QSoPb 5%J,쮋'Fۍ~#fGt[YPb\ʒ9Bun:J aXC5(1Vb(1~ ^Qb*5X1xM%&+J aRs1aJ a̧ĒkPb4Vb(1~ ^SKMEUB_۴ iMY,ѾcХ'L[\DOW1gttu %0kʕȋ'.ƴ%RE9kN%v:uŰت,g3?)Q{so=q !*3ItZl{ F5;0AkJld}2kG1B^X2)*oP ;ݹh]ѓK ; @a%k ;{7NK;%^BNQKۗTbu񥰢Q٬YLJ aה+qЖtRIPbfm(1~ ^c%C5(= J ~ ^3OJ aנX1xͮ]5b ^#ܣohOPb>A@Io JIENDB`java-design-patterns-1.16.0/object-mother/etc/object-mother.ucls000066400000000000000000000072261312550536300246060ustar00rootroot00000000000000 java-design-patterns-1.16.0/object-mother/etc/object-mother.urm.puml000066400000000000000000000020421312550536300254060ustar00rootroot00000000000000@startuml package com.iluwatar.objectmother { class King { ~ isDrunk : boolean ~ isHappy : boolean + King() + flirt(queen : Queen) + isHappy() : boolean + makeDrunk() + makeHappy() + makeSober() + makeUnhappy() } class Queen { - isDrunk : boolean - isFlirty : boolean - isHappy : boolean + Queen() + getFlirted(king : King) : boolean + isFlirty() : boolean + makeDrunk() + makeHappy() + makeSober() + makeUnhappy() + setFlirtiness(flirtiness : boolean) } interface Royalty { + makeDrunk() {abstract} + makeHappy() {abstract} + makeSober() {abstract} + makeUnhappy() {abstract} } class RoyaltyObjectMother { + RoyaltyObjectMother() + createDrunkKing() : King {static} + createFlirtyQueen() : Queen {static} + createHappyDrunkKing() : King {static} + createHappyKing() : King {static} + createNotFlirtyQueen() : Queen {static} + createSoberUnhappyKing() : King {static} } } King ..|> Royalty Queen ..|> Royalty @endumljava-design-patterns-1.16.0/object-mother/pom.xml000066400000000000000000000037301312550536300217120ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 object-mother junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/object-mother/src/000077500000000000000000000000001312550536300211615ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/000077500000000000000000000000001312550536300221055ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/java/000077500000000000000000000000001312550536300230265ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/java/com/000077500000000000000000000000001312550536300236045ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300254345ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/java/com/iluwatar/objectmother/000077500000000000000000000000001312550536300301215ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/java/com/iluwatar/objectmother/King.java000066400000000000000000000036271312550536300316640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.objectmother; /** * Defines all attributes and behaviour related to the King */ public class King implements Royalty { boolean isDrunk = false; boolean isHappy = false; @Override public void makeDrunk() { isDrunk = true; } @Override public void makeSober() { isDrunk = false; } @Override public void makeHappy() { isHappy = true; } @Override public void makeUnhappy() { isHappy = false; } public boolean isHappy() { return isHappy; } /** * Method to flirt to a queen. * @param queen Queen which should be flirted. */ public void flirt(Queen queen) { boolean flirtStatus = queen.getFlirted(this); if (flirtStatus == false) { this.makeUnhappy(); } else { this.makeHappy(); } } } java-design-patterns-1.16.0/object-mother/src/main/java/com/iluwatar/objectmother/Queen.java000066400000000000000000000041431312550536300320430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.objectmother; /** * Defines all attributes and behaviour related to the Queen */ public class Queen implements Royalty { private boolean isDrunk = false; private boolean isHappy = false; private boolean isFlirty = false; @Override public void makeDrunk() { isDrunk = true; } @Override public void makeSober() { isDrunk = false; } @Override public void makeHappy() { isHappy = true; } @Override public void makeUnhappy() { isHappy = false; } public boolean isFlirty() { return isFlirty; } public void setFlirtiness(boolean flirtiness) { this.isFlirty = flirtiness; } /** * Method which is called when the king is flirting to a queen. * @param king King who initialized the flirt. * @return A value which describes if the flirt was successful or not. */ public boolean getFlirted(King king) { if (this.isFlirty && king.isHappy && !king.isDrunk) { return true; } return false; } } java-design-patterns-1.16.0/object-mother/src/main/java/com/iluwatar/objectmother/Royalty.java000066400000000000000000000024751312550536300324370ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.objectmother; /** * Interface contracting Royalty Behaviour */ public interface Royalty { void makeDrunk(); void makeSober(); void makeHappy(); void makeUnhappy(); } RoyaltyObjectMother.java000066400000000000000000000052331312550536300346610ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/main/java/com/iluwatar/objectmother/** * The MIT License * Copyright (c) 2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.objectmother; /** * Object Mother Pattern generating Royalty Types */ public final class RoyaltyObjectMother { /** * Method to create a sober and unhappy king. The standard paramters are set. * @return An instance of {@link com.iluwatar.objectmother.King} with the standard properties. */ public static King createSoberUnhappyKing() { return new King(); } /** * Method of the object mother to create a drunk king. * @return A drunk {@link com.iluwatar.objectmother.King}. */ public static King createDrunkKing() { King king = new King(); king.makeDrunk(); return king; } /** * Method to create a happy king. * @return A happy {@link com.iluwatar.objectmother.King}. */ public static King createHappyKing() { King king = new King(); king.makeHappy(); return king; } /** * Method to create a happy and drunk king. * @return A drunk and happy {@link com.iluwatar.objectmother.King}. */ public static King createHappyDrunkKing() { King king = new King(); king.makeHappy(); king.makeDrunk(); return king; } /** * Method to create a flirty queen. * @return A flirty {@link com.iluwatar.objectmother.Queen}. */ public static Queen createFlirtyQueen() { Queen queen = new Queen(); queen.setFlirtiness(true); return queen; } /** * Method to create a not flirty queen. * @return A not flirty {@link com.iluwatar.objectmother.Queen}. */ public static Queen createNotFlirtyQueen() { return new Queen(); } } java-design-patterns-1.16.0/object-mother/src/test/000077500000000000000000000000001312550536300221405ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/test/java/000077500000000000000000000000001312550536300230615ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/test/java/com/000077500000000000000000000000001312550536300236375ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300254675ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/test/java/com/iluwatar/objectmother/000077500000000000000000000000001312550536300301545ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/test/java/com/iluwatar/objectmother/test/000077500000000000000000000000001312550536300311335ustar00rootroot00000000000000RoyaltyObjectMotherTest.java000066400000000000000000000067601312550536300365410ustar00rootroot00000000000000java-design-patterns-1.16.0/object-mother/src/test/java/com/iluwatar/objectmother/test/** * The MIT License * Copyright (c) 2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.objectmother.test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import org.junit.Test; import com.iluwatar.objectmother.King; import com.iluwatar.objectmother.Queen; import com.iluwatar.objectmother.Royalty; import com.iluwatar.objectmother.RoyaltyObjectMother; /** * Test Generation of Royalty Types using the object-mother */ public class RoyaltyObjectMotherTest { @Test public void unsuccessfulKingFlirt() { King soberUnhappyKing = RoyaltyObjectMother.createSoberUnhappyKing(); Queen flirtyQueen = RoyaltyObjectMother.createFlirtyQueen(); soberUnhappyKing.flirt(flirtyQueen); assertFalse(soberUnhappyKing.isHappy()); } @Test public void queenIsBlockingFlirtCauseDrunkKing() { King drunkUnhappyKing = RoyaltyObjectMother.createDrunkKing(); Queen notFlirtyQueen = RoyaltyObjectMother.createNotFlirtyQueen(); drunkUnhappyKing.flirt(notFlirtyQueen); assertFalse(drunkUnhappyKing.isHappy()); } @Test public void queenIsBlockingFlirt() { King soberHappyKing = RoyaltyObjectMother.createHappyKing(); Queen notFlirtyQueen = RoyaltyObjectMother.createNotFlirtyQueen(); soberHappyKing.flirt(notFlirtyQueen); assertFalse(soberHappyKing.isHappy()); } @Test public void successfullKingFlirt() { King soberHappyKing = RoyaltyObjectMother.createHappyKing(); Queen flirtyQueen = RoyaltyObjectMother.createFlirtyQueen(); soberHappyKing.flirt(flirtyQueen); assertTrue(soberHappyKing.isHappy()); } @Test public void testQueenType() { Royalty flirtyQueen = RoyaltyObjectMother.createFlirtyQueen(); Royalty notFlirtyQueen = RoyaltyObjectMother.createNotFlirtyQueen(); assertEquals(flirtyQueen.getClass(), Queen.class); assertEquals(notFlirtyQueen.getClass(), Queen.class); } @Test public void testKingType() { Royalty drunkKing = RoyaltyObjectMother.createDrunkKing(); Royalty happyDrunkKing = RoyaltyObjectMother.createHappyDrunkKing(); Royalty happyKing = RoyaltyObjectMother.createHappyKing(); Royalty soberUnhappyKing = RoyaltyObjectMother.createSoberUnhappyKing(); assertEquals(drunkKing.getClass(), King.class); assertEquals(happyDrunkKing.getClass(), King.class); assertEquals(happyKing.getClass(), King.class); assertEquals(soberUnhappyKing.getClass(), King.class); } } java-design-patterns-1.16.0/object-pool/000077500000000000000000000000001312550536300200455ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/README.md000066400000000000000000000014431312550536300213260ustar00rootroot00000000000000--- layout: pattern title: Object Pool folder: object-pool permalink: /patterns/object-pool/ pumlid: JSV94SCm2030Lk829Fxf1cF6bWU1XYDkFtdcjxiD9Qc3o-LrPQvu0pW-_HnvrLx1JgR9cfrimf1wCD7XnW-sWsESsXPcicl0nFW1RB-PiYqp0KxwVo-VVTMKBm00 categories: Creational tags: - Java - Difficulty-Beginner - Performance --- ## Intent When objects are expensive to create and they are needed only for short periods of time it is advantageous to utilize the Object Pool pattern. The Object Pool provides a cache for instantiated objects tracking which ones are in use and which are available. ![alt text](./etc/object-pool.png "Object Pool") ## Applicability Use the Object Pool pattern when * the objects are expensive to create (allocation cost) * you need a large number of short-lived objects (memory fragmentation) java-design-patterns-1.16.0/object-pool/etc/000077500000000000000000000000001312550536300206205ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/etc/object-pool.png000066400000000000000000000212551312550536300235500ustar00rootroot00000000000000PNG  IHDR#NB("tIDATx]Uw^%I/B 7FbLJZ6%M_R [)V Z<[Z *kJrP%- DJJ[%1nzǼk̞Yϓk={7kq *_OZ!AUh7:"uQONJ|=2DI2#H3@L7f4 a tivyOvmn G2JE:I *b;z2JFfnWO_\懋ë9G'\+{ aJʨב*LM)R'AWIO.3Q)|aR#HH!%"]<|H@2G]DJ)ښM*]W%^N+":hŌaYU/tu/V=z4U02(k.iz4M#\WwXmĨ^Цq*M+$-.{P|h @^rHz۴Žkmx/Tj $qTQ"/nIy{}1>) jT׈e QMŬ ni0YNZk n iH@0f4;JҜ/M^ ivX)xMuגmr=AH#7˛bVzI+bHz R|={}#NؠYSCF)h=ҭגKz,4RXr/ N4iluE捪=&0d'N!k(es(rp˅,Qa㫌3~7lL4 תf7{T+~7#7_2"x/r]"\ll"-C_$-ߍ܃/xuQycM%Ƨ7wǟrCq֔9߬)l@>_\¹r8'E#qUv &Q`u|Lwb"yx^KIO~|6Eq╭Wj;L[?u87\9pLCT$iv]5X̛#G'oGWORH"A 80 K)Ͱ܃ ̞(!2y {I;6#B\% Ց">A_%hJii<$i|vX#o \7b49?GV-^I/=9w_^s/`=M q*̯\iam݅JS)_5DK~z&}ZpMN{4o%Yw{|Hv8䚽ɧ%dI.?,Qa Kh<-.1y2 sygio{`&&˻/y`ٲǮ^l_we\A>kL|#!RUSBQ54CrMe<{Q&KO<1m9J &/ʅܲ'dbBXnVdwz,ru3>_H^45-l n+bVN`@0f4; n iH@0HqϙgH-"/;-wHd?T~Qcmz#n`\n~? bu[q_$ ".N;2J9I+$e[__.f'=7s2`iĖ]ZvԻAI%Opf^Y@?̔/q)=sￜ2JE9IK PFʵ-Cۑ]w"?E(%.hߦY]&"/KBYa5Mc"^&L,ap Ki*IPfS @0f4; n iH@0=i Ӂ:8/8I*6DM:=n iH@fi??$F6/hvF 7/hAfi=C6:i|J9ѲSk,&XlҨ=f$ʚY!sKp%'h2JFܧZǤ{ ޴^cDy6MiU;\#L,A\|; 2&6P )&!IHS;GͷA}Cé~TQK_\4۴d#X?O[d48InҖr_|>G6j=IHʿdYCkZo=4 a%T9ފLp1a󽉳xdR8I sPոD>SW_ hnvByGфw&,))v2J58IQIĕDjҮ/n>;ys7 o?QµE)t4hfV 5ҚHZ>' kY0b:v*st7proh3-Ip?8t@C32HL&EAHI HFV𤩳HSjI:HGtu۱m$11i zDާq_D˛2Je9Цwiԩ#QR*ttc-6=M^[(dD3囔~jRYN4uAj,igbNm?<)qŞ (fٍ=q6.bi9zs d#-UĩYZ\"o_O}".[lODbS>{b~E!ODJPiNDD7]G7oi v>Η\__x_Jwjاߎh?Et'Bl?װ*e tivH3@L7fB˽=H Byv'Yf +4ACVA %A찜]G @ #?- )k=w 2vlx115eSl<c!$bu9#-X:Bg/8]?޻LWP6p_mfF8BBk"ik%[07@sM}0pv&֎VbpckD)y7{ëR.H,Tp 9AԈȗj(E9Ik5ૡR&藟#51x?ysjh3S3M3D`x0! /NܡZjj(E9Ik{oc]aeC8R5>zO;/;@Ȧb7V6^ނ.c2xYHKsFyZH?h@mvr_":.?ҡAV,VGUl#-Y̵a{rѤ;0uف_f>*;BtJfaC$t-5> '~Htu-)Lcېk(;I|g$N 473XiJ}IkYJZ n iH@0f4; n iH@JH6Lu WSCF)?1gCRTm'zLJZpbHX(~IRCF)ĸΞne %}iD=&"-Q8&<`%'~\)o`QֳqyD9PGQ3_!ռwDc줥 \x|MzF.lt9 #-+8tQ̗CՐP— -m8/5366R 89T2B/ҭ1e|it='-Ʊklj=*2UđUYu8*i%]ۚ,q#n:i$v z'9HsFs{O~+؋Yš2f'cta0bހ405!Z*DI t;*W][A9evu\N+5bi!}<][AyevuҤN5QC/ ٧&\D#~5JU%cb]u ?Xl1"Advutk'"28Qx2BD0[[A9ؘk)l icD&kf5HX &bi h >4 'f4L4f@H3@}i&HOEֺ%AJ\G۸1HR6.a ҠT*(:f:K0iP*sݚ%AJE\f cRA11GK0iP*sݺ%AJ͊6h cR#ƈ1HR@}i&HO Di h >4 'VX#Cvȶk… Ϟ=[Y@,HFAxg>ei+Wvuɲ4i]@ {Hۿ5kƍwU@ {H#ƹ9q/Ӂ AwSNj/kA,!mϞ=v}NdYBҥKG}ϯt H i"j䆭 U66==}JR i>}4tƓvEi?v| HƓF A񤑮cLɹ[ BƓ&JH 2S%H̔m~ 3e_4L 2S%H̔m~ 3e_4L 2S%H̔m~ 3e_4L 2S%H̔m~ 3e_4L 2S%H̔m~ 3e_4L 2S%H̔m~ 3e_4L%E3U0Vߣ?O55{X5$imSݤ@Z@T@HHiPi B AU`N}g扉jk6Iݭ 46IփOn{MF/z-IݳM36F[[:ŷ_xћA^z-޳DGFzd+ y2946rx -AZT iHZf7{ѿzKe㻑f@*!*`??kn߳4ܰj0q4= i'=&o46 Jž=^xϒovO>{_;>fzigilbis-OE> WaM-{}?{mA^{_S)b=ʨp3=_iXQi=BUV nY{דWMRTR{@ZTf6,}d͕h{#H4 4U!Ҡ*@T@HHiPj8i?)suڦzA AZT;it?)|.ꍂpy4֦G8``У3}4Ǎ1AT7i9ւWzx%!6awYst` r] AT3i9N8y!OQҼp0<=@-c4oҦe -\ӐƏޠʢxtIc*izH`,&wY4^& G6KO\(ҠT?i464U!Ҡ*@T@HHiPJZ Ӂ)R2MhЦAU4 4U!Ҡ*'"OD&ihӠ*@T@HP9 m<#K>mxҖrخ}LimSYqHk@HPeG6͛gUlst^ǎvnq! Ҡ4*՗fl8'".ftwx"? '{V6@ڵz3o&-AN4rOڑ9fgyĹi9% .$ mK]\ '6CޒD!<+0GO7;{KTYLQ4!;wh3O4(VyI–׶n;-6$f!MR)r{->;169q3I'6iP%o9nJޒD![8)P 6EGtoҠ_1sWzٸbI>=;ȉ={*r)AH<Odk۷!A겍{ʯ""{|A +b#TyKOFF+߳ O2f,k(!e&Ҡ*@T@HHiPi B AU4 51OـonFڱ"mltv8)3"AZU i.cH,6Fe[wl~Ll571W Z"AZUiGf.r>y<?~dEJ0wV,FF A Ңf mH7Hkv S3G98;h_<6FӐon%|Ow^4j5X iV?h@mv1G6U?MsV@㣡͈iV1ODLcv`Wy4OD8raܴ&'"!lqO+iVaO?ebyʲЕǡ)\ *Y8imHiPi B AU4 % @ʼng &\Y! 4B 7awIENDB`java-design-patterns-1.16.0/object-pool/etc/object-pool.ucls000066400000000000000000000054641312550536300237360ustar00rootroot00000000000000 java-design-patterns-1.16.0/object-pool/etc/object-pool.urm.puml000066400000000000000000000011321312550536300245330ustar00rootroot00000000000000@startuml package com.iluwatar.object.pool { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } abstract class ObjectPool { - available : Set - inUse : Set + ObjectPool() + checkIn(instance : T) + checkOut() : T # create() : T {abstract} + toString() : String } class Oliphaunt { - counter : int {static} - id : int + Oliphaunt() + getId() : int + toString() : String } class OliphauntPool { + OliphauntPool() # create() : Oliphaunt } } OliphauntPool --|> ObjectPool @endumljava-design-patterns-1.16.0/object-pool/pom.xml000066400000000000000000000033641312550536300213700ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 object-pool junit junit test java-design-patterns-1.16.0/object-pool/src/000077500000000000000000000000001312550536300206345ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/000077500000000000000000000000001312550536300215605ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/java/000077500000000000000000000000001312550536300225015ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/java/com/000077500000000000000000000000001312550536300232575ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251075ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/object/000077500000000000000000000000001312550536300263555ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/object/pool/000077500000000000000000000000001312550536300273265ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/object/pool/App.java000066400000000000000000000067271312550536300307250ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.object.pool; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * When it is necessary to work with a large number of objects that are particularly expensive to * instantiate and each object is only needed for a short period of time, the performance of an * entire application may be adversely affected. An object pool design pattern may be deemed * desirable in cases such as these. *

* The object pool design pattern creates a set of objects that may be reused. When a new object is * needed, it is requested from the pool. If a previously prepared object is available it is * returned immediately, avoiding the instantiation cost. If no objects are present in the pool, a * new item is created and returned. When the object has been used and is no longer needed, it is * returned to the pool, allowing it to be used again in the future without repeating the * computationally expensive instantiation process. It is important to note that once an object has * been used and returned, existing references will become invalid. *

* In this example we have created {@link OliphauntPool} inheriting from generic {@link ObjectPool}. * {@link Oliphaunt}s can be checked out from the pool and later returned to it. The pool tracks * created instances and their status (available, inUse). * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { OliphauntPool pool = new OliphauntPool(); LOGGER.info(pool.toString()); Oliphaunt oliphaunt1 = pool.checkOut(); LOGGER.info("Checked out {}", oliphaunt1); LOGGER.info(pool.toString()); Oliphaunt oliphaunt2 = pool.checkOut(); LOGGER.info("Checked out {}", oliphaunt2); Oliphaunt oliphaunt3 = pool.checkOut(); LOGGER.info("Checked out {}", oliphaunt3); LOGGER.info(pool.toString()); LOGGER.info("Checking in {}", oliphaunt1); pool.checkIn(oliphaunt1); LOGGER.info("Checking in {}", oliphaunt2); pool.checkIn(oliphaunt2); LOGGER.info(pool.toString()); Oliphaunt oliphaunt4 = pool.checkOut(); LOGGER.info("Checked out {}", oliphaunt4); Oliphaunt oliphaunt5 = pool.checkOut(); LOGGER.info("Checked out {}", oliphaunt5); LOGGER.info(pool.toString()); } } java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java000066400000000000000000000037041312550536300322350ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.object.pool; import java.util.HashSet; import java.util.Set; /** * Generic object pool * @param Type T of Object in the Pool */ public abstract class ObjectPool { private Set available = new HashSet<>(); private Set inUse = new HashSet<>(); protected abstract T create(); /** * Checkout object from pool */ public synchronized T checkOut() { if (available.isEmpty()) { available.add(create()); } T instance = available.iterator().next(); available.remove(instance); inUse.add(instance); return instance; } public synchronized void checkIn(T instance) { inUse.remove(instance); available.add(instance); } @Override public String toString() { return String.format("Pool available=%d inUse=%d", available.size(), inUse.size()); } } java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java000066400000000000000000000031531312550536300321360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.object.pool; /** * * Oliphaunts are expensive to create * */ public class Oliphaunt { private static int counter = 1; private final int id; /** * Constructor */ public Oliphaunt() { id = counter++; try { Thread.sleep(1000); } catch (InterruptedException e) { e.printStackTrace(); } } public int getId() { return id; } @Override public String toString() { return String.format("Oliphaunt id=%d", id); } } java-design-patterns-1.16.0/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java000066400000000000000000000025171312550536300327730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.object.pool; /** * * Oliphaunt object pool * */ public class OliphauntPool extends ObjectPool { @Override protected Oliphaunt create() { return new Oliphaunt(); } } java-design-patterns-1.16.0/object-pool/src/test/000077500000000000000000000000001312550536300216135ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/000077500000000000000000000000001312550536300225345ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/com/000077500000000000000000000000001312550536300233125ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251425ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/com/iluwatar/object/000077500000000000000000000000001312550536300264105ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/com/iluwatar/object/pool/000077500000000000000000000000001312550536300273615ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java000066400000000000000000000025001312550536300316010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.object.pool; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } OliphauntPoolTest.java000066400000000000000000000111261312550536300336030ustar00rootroot00000000000000java-design-patterns-1.16.0/object-pool/src/test/java/com/iluwatar/object/pool/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.object.pool; import org.junit.Test; import java.util.Arrays; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotSame; import static org.junit.Assert.assertSame; import static org.junit.Assert.assertTrue; /** * Date: 12/27/15 - 1:05 AM * * @author Jeroen Meulemeester */ public class OliphauntPoolTest { /** * Use the same object 100 times subsequently. This should not take much time since the heavy * object instantiation is done only once. Verify if we get the same object each time. */ @Test(timeout = 5000) public void testSubsequentCheckinCheckout() { final OliphauntPool pool = new OliphauntPool(); assertEquals(pool.toString(), "Pool available=0 inUse=0"); final Oliphaunt expectedOliphaunt = pool.checkOut(); assertEquals(pool.toString(), "Pool available=0 inUse=1"); pool.checkIn(expectedOliphaunt); assertEquals(pool.toString(), "Pool available=1 inUse=0"); for (int i = 0; i < 100; i++) { final Oliphaunt oliphaunt = pool.checkOut(); assertEquals(pool.toString(), "Pool available=0 inUse=1"); assertSame(expectedOliphaunt, oliphaunt); assertEquals(expectedOliphaunt.getId(), oliphaunt.getId()); assertEquals(expectedOliphaunt.toString(), oliphaunt.toString()); pool.checkIn(oliphaunt); assertEquals(pool.toString(), "Pool available=1 inUse=0"); } } /** * Use the same object 100 times subsequently. This should not take much time since the heavy * object instantiation is done only once. Verify if we get the same object each time. */ @Test(timeout = 5000) public void testConcurrentCheckinCheckout() { final OliphauntPool pool = new OliphauntPool(); assertEquals(pool.toString(), "Pool available=0 inUse=0"); final Oliphaunt firstOliphaunt = pool.checkOut(); assertEquals(pool.toString(), "Pool available=0 inUse=1"); final Oliphaunt secondOliphaunt = pool.checkOut(); assertEquals(pool.toString(), "Pool available=0 inUse=2"); assertNotSame(firstOliphaunt, secondOliphaunt); assertEquals(firstOliphaunt.getId() + 1, secondOliphaunt.getId()); // After checking in the second, we should get the same when checking out a new oliphaunt ... pool.checkIn(secondOliphaunt); assertEquals(pool.toString(), "Pool available=1 inUse=1"); final Oliphaunt oliphaunt3 = pool.checkOut(); assertEquals(pool.toString(), "Pool available=0 inUse=2"); assertSame(secondOliphaunt, oliphaunt3); // ... and the same applies for the first one pool.checkIn(firstOliphaunt); assertEquals(pool.toString(), "Pool available=1 inUse=1"); final Oliphaunt oliphaunt4 = pool.checkOut(); assertEquals(pool.toString(), "Pool available=0 inUse=2"); assertSame(firstOliphaunt, oliphaunt4); // When both oliphaunt return to the pool, we should still get the same instances pool.checkIn(firstOliphaunt); assertEquals(pool.toString(), "Pool available=1 inUse=1"); pool.checkIn(secondOliphaunt); assertEquals(pool.toString(), "Pool available=2 inUse=0"); // The order of the returned instances is not determined, so just put them in a list // and verify if both expected instances are in there. final List oliphaunts = Arrays.asList(pool.checkOut(), pool.checkOut()); assertEquals(pool.toString(), "Pool available=0 inUse=2"); assertTrue(oliphaunts.contains(firstOliphaunt)); assertTrue(oliphaunts.contains(secondOliphaunt)); } }java-design-patterns-1.16.0/observer/000077500000000000000000000000001312550536300174575ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/README.md000066400000000000000000000034601312550536300207410ustar00rootroot00000000000000--- layout: pattern title: Observer folder: observer permalink: /patterns/observer/ pumlid: FSkn4OGm30NHLg00hFow4KO3PcpP8tr1-pYwx6smQz5Suv2mkbp0y1-HyPlEWYlsSB7S5Q98kJSgDLu66ztyy7Q8brEtmO2OEZNs2Uhxl9u9GVv72cjfHAiV categories: Behavioral tags: - Java - Difficulty-Beginner - Gang Of Four - Reactive --- ## Also known as Dependents, Publish-Subscribe ## Intent Define a one-to-many dependency between objects so that when one object changes state, all its dependents are notified and updated automatically. ![alt text](./etc/observer_1.png "Observer") ## Applicability Use the Observer pattern in any of the following situations * when an abstraction has two aspects, one dependent on the other. Encapsulating these aspects in separate objects lets you vary and reuse them independently * when a change to one object requires changing others, and you don't know how many objects need to be changed * when an object should be able to notify other objects without making assumptions about who these objects are. In other words, you don't want these objects tightly coupled ## Typical Use Case * changing in one object leads to a change in other objects ## Real world examples * [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html) * [java.util.EventListener](http://docs.oracle.com/javase/8/docs/api/java/util/EventListener.html) * [javax.servlet.http.HttpSessionBindingListener](http://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpSessionBindingListener.html) * [RxJava](https://github.com/ReactiveX/RxJava) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) * [Java Generics and Collections](http://www.amazon.com/Java-Generics-Collections-Maurice-Naftalin/dp/0596527756/) java-design-patterns-1.16.0/observer/etc/000077500000000000000000000000001312550536300202325ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/etc/observer.png000066400000000000000000000474031312550536300225770ustar00rootroot00000000000000PNG  IHDRڴNIDATx}\}]Kd?b%RҡX=,!*@QJŽ Z6⌘;'FKuT)Ju*gݥ.Ee^z~o>_Owon x|W i@E,9 !To `%`5 @ŠwAB6 #jA_ z'!h#|10BڭN2StOFa(ac#0hD+pNr,(ac#0hĐAd ~ D?(Fۇ6bNz!, lEH:o(bM ,.7Jjr#SzQ1`0‰7B/bճ H~im4{d<kNϒlTYtFJbR61ߞW0Bsқϐ)")gHLa7C%$hVyB-D v L Wlj0¢q aEӛ̐`t*.Of" #Z5/`J_q}PȿDD_ #z7B/7AI6:[~dNݙ^ڥ1ttҔ1j͚O$b!лz!,?˯a J2Wf7QTZMJ)Ǩ@?¬9L ,sx_ #ω7B/O"CydGŇVc{'8&曛Tvg C!ŗք90 o"[5 _ z'!h#|10BŠwAB6 #jA_ z'!h#|10BŠwA[񃋷<_/~VrMRתI/0 # 0ƂL,rAJr;HSg-*gن{f/M4aGr̄F48>=NXl u~oucxD/Cމ[xhKu# M*nB (l BwrLRD{_HW~!X(Vg!\h<f3# N&Mc]I+n?>&yT2YKA'n{7O]wr$?|kcC(዇c &*[i۝o`k`c@7c5UW8 f<ߑp_XOA[o:qS&U٧~w1|SFy #D$2gymyK'c3ߤEbne( %s)֕_l,08׍ /Ss*[ ykplQ|}tH߼}\|x?7~xi;82Ѭ g'YlȇдSp YKA@t\޳ zv>ֿ;[ܭDSԁr3̷:%,{CUG7u0Ib X.a!R$-wPտo/҅H?ٛN|?$A0/%@ _r # &n/^Q؏SՅ>;~W?e6 mk)wsݯ-{g&~y+Kux@?e L܎0e iy+GG-b━Ioc@WnpF3?>`fA`{ @Z o}~}ߺ[G:\{7wO-*LBo)w55h/D CݺX.apHf6YXUm^ڤ7cZp[5:?tGo:q^/&)]z|0~)e`/60B/WKd|1`5 8nu|65EJ $#s7D5e}qd0,BUo$)-24EDGg6 8) Ry(b9Z_G/gz#6kjmm"v88^{ 0h0񟘿_%u)M Q% L89FAA7Ea) A-t;{ϙo>y䂼|`D ̄4%T.v0h xyH$ ,}G.eFh,GiJpc a ԔR0*bl6[K1 oDY9Vv0h ]ȿ%IY|._SK%:cxH#LDv0PXW#d3q1Ry1Ѵ@pJQ|N0h {'}ec֥Y(d9B.(RfWBFh_Thu2aTY[#\K֝,0׻D/M e\y {wn⎥ G /:$~x|C#|0ۿF',o{ayV(FX=N7$}v7e2V3_ #Ґ`]Xڱm[5/Yx=g/׏ /K$dc|#bS|_7G78wGp ?ZN7J󈻂EEtb ` >}ֵ5ȧA& UXKgo#߱e9 jўa7 ɀ9 )l;*{-'AGw-Ͻxʓ%IT^ (`9I3oI<ܙ/ҿL]9w?-A>|׎$!/I-\PdhَJx$IRڴE955Tm%s=ճ̳@;bqb~a0zw~DCb/({)i[U/M\Ȯ?wO_$e C q#l2HFy~K[N+ڢȕ"ہ6LٖGE0>*FXo#om۰€gQk3{΃m^FaI=֓{2b,ITF *wpws*FXs#kllZdvbU2 [ChPF呛 G-K~U`}P#Zye6G(b䖴8Rٛ^,_ #FX6X(l nM>UV'}fbH#ld灰QX kIb;a X !@A`5 m/FP/j@E, AN[ZA1|( <*L4 "A@M}W(-r`PwAii6{}BA:}[ܭ/`dFTrSo\|wҀ_XmO${w;*dci#un0 $dnnw-ް K'a?m` FHAV.znc@/,`dzw9}'O~\鶳sѽx(@/ P'J׬cP'ϟ+<^w1U&wφxMVl:4׋[niA$D0$ZXC&AGw-Ͻxʓ%IT:+bKi,ɝ'|'tJѤpvO3ξW tY؀HUNNuC}m7LMJRN'45"~a|}#I?B^DpȽu׺Oe=ewjK.бe]KvK}B.?&Ӛ}IK+/R0MO 7-] &KKK0LGv~fn{b $+ ׳pn <8躶䜅BƍّI]+#l\k^Lo:)]+"_'v3hVqBL6/^! {'}ec֥YhjO3L fzL8Nhͦo!?JJμ9Bjh+~iӦK.! w'XpK RciXz N G%?>'OT¥*2VaurmDw.EW&Q^oZnH*$+k¸r*n@/,sɅ&гvõh<)^lZ^@eCpuK"-3I+ul5SrO{!"Kއ@O[osNlhX Bc42 \`5~A0"H ~ A0[ T2! pA0X^^~}8Q NZ]]] @D(BSSS;XCDՅa 'þk4A`4T@vNv@s9MI( H`D`/J -~, Bc!` _tbr0VA`~(y< Ahyf ޽L7Wv]wĜS3 [gwv B  (&&AGw-Ͻxʓ%IKqONϣ=");=z-&۩is'}j A؀- 0 w>>|׎$!/I-^H" 뉅wD9cgE8DKz1tA l~5~aW?3s$Bۗ#ɺUv/׵+is*TA#k]]/@/L`هs珝'[fI([|/t^H]hΩQLăAA,d0Q0 {wn⎥ G /<|W]\H36|D_X$o} A? XCP3B@}0wP1! Cr>egtY^2p>{SP2`\UO{!EA I8! +WD 9 A8ceew @Hd"^ RoA~ P| c4]>w~`p`BF|b ,\sb=.'%7IAts1M\D}QF_h?ƴ  AF 'yZќU; FǔAi ƈع),`mwL%$Eȣ慞[Y15 8@I>.|Q|#kCq% J$0F)0778@/l?+Wfo#$k{8k7_8B.gjz_lgz4#hd"~˾kQ?` _/$)Bm7oO.ď3;'n>Bw^~]7 (MT y@x-q@++( k6&r~@?ɠ0?eW^y@{#S!D"PEP;XAٖ ts4B˾kQ Bna`M9 ATuE 8<@ɞ'Dx TB~MPE"w@Ȁ ')@آD(B/jĀ|fp=,..n޼-!/۷w-YU뾫2~^{.]]ZD0$  0lQ _x‚NB |È TZCXc@ -آo1<iϩ)ߵ C4"Uauuu˖-N]o۶w-A˗/O` AvUk  ,,..nڴi¥ ;w\YY] `x@a#1555R ݓE"S6oތ>==H /[l+Wm/'Ж$jz1i3KY"Q@عs'Ѱk}ߵ  -7^ڽ c'mؒ B#! *HIf![]r?.nkܖDN?\5FPY0 YCP3}$G!/]t80`w7=0>As΁ {6 6 þIآA6HcF])5-M(ZOWe]%~[%/^Xn`MʏߕΕR#h[G_X ׫Fiz@)ORi Dn?Q\6A I aM|5?S{YH:qvډb<2&4tZfoԒ1+-!&95qDG/ B&,Z3UX_Sm۶}nK ~ؽ{ҒZ FNYN_ºڏs0>0K1,U0 ~.ZI3D}7GkM=- A K.ISXCta^2?Hun~]O~8xߤ(tEZU+f ;w5e- j A>&B jCZW&5kS~] Nt-[!N%$opM1i ¿fŹ9%'AAw dS|Eű[h_Tlkӈ C҅Q 5nRZAVR&{#H +\$p]WmIT>@AF'P2BzvO^kҥK * \,]oAN+]0- KPpҔ@*Uel޼9[!A@ &mQY4}Ӻ]?Cc%,A z&eWǹ2my yȶ$!rO`=fuunWUAZ W k޴hHߩ$qBmf@j\Y}pD0ϢH$Q|2P2 _dI =M82:VWWlقuC̩ɴFh&Iҁ}U[@`.`[Lq?0W2!+Ui/_޼ykwB5B"@3]hD,.kQ?rJ;b߾}k"S X__'ck4M d@3(<ذ1̀ ȸ8AR/@A4 C^aAM65l0@υ8 K)c ;U$OCƛj ԕr*ܔ>f/0!QIu|^j!IM;Z/N|Rjъj wɇr!kn,J2QJo('S r0X ~O;+xs%̡1\A )xQ@2w3?m=LQRRMh/ WUAN}F2䂍r<Ҙ?~J{SmU[3PA oTШy ui멽א<)B#,kQK(uFa)em,2{fW3_矽{oxlA͒cA KG_w_%|?| Bxw_-[>sjB^LmP)g^Rp䬼nw&T=^ ^`m^|e .pg7%yŋgLGw,/ a#)-^V|)j֧[Rr^_ї#BGp^q==-vaϢ?M?RIXNNsyub'\ĕ O}s*!/ 8} $O]RBg븃U!|;o[Ǟ"ї$;uۍW.)GdF):i}(o+-ǝ zt+|#T{oyϗn~74em?wL߳f! 8-!+^@@߸?>EH9ܛ ?E% st,¶*H)?x̯q/m+C+vQ A lrjʇ0Bd:/?%\nfi2h h/ {ooNr-&){oZ~a쀺xVu2.4ӡ=/?W]|5rC(LB5d ??c'}!2,- rH (g%G+)^@@']E}ߒȻSmg8,[pi~7 zObuH?;uZ|ؽ]F'|jB}ʀ+PT7T>fڦ u`<)@|/-ۿ~7^|xyy?]i+y#,SGKS[pݻq1TW +o>~w3u|ϐwknYn usd5}1oցR~(js@4ΗPY:p7{Kyͅ=o ;4m! ܕm*#Mp˿{x6\E ,0sU ;4}ъj F;;eoO>|gԗx{>٥}?G}7NY}qjE@{\_ ֗Ii%A]|1H APSfs[!A AJptBb@{ G'+^@@/)! A AJptBb@{!t_mߛm^3T%s$LhA3+@{/.Hx1sAFh p cʑq,?=9ǯ%*nN6iNMKʤs'SmwvۖuQE쩻i+{]uh-vNPF3 ͭOVpBP4y_6k%`f+^@@ kɺ 0DBb@{ G'+^@@/)! A AJptBb@{ajZ`hE5Z1[#ӣh/  p  %8:!\|1H ӫ/"rO%[BH=5P\B4h/ @A =42 ל7 eNeH%zbE5 >{T!hYWз` ;ygZ,("!{K+"Z@OS⮔3 jiܑ9$ *Tk%f%@{!8APN&b'd9a /X:rmI%W}i逸@֑|7/&S^iYbA"bL Êj 񟘿_%Z&dі0<S bMc7/a֙)4kIeY@_(5TR zS"5 tDv@{w<{3|y)ѻ'rlT#NrҲUIx5!XǖIkCJ$ar ( qEIIQC[.'kH+v.EN-O)@#=jiq4GVTS`_~t 돧[89.8řfBP>! 'X5Q*2!W)6nGn7M=C/~yH$LnžI_6d,RyXtਔ%A h/ |Տs<@%/Iщ:.!/ ~84PiDh~A]} Ai/{'}eh\l]%B#N˦7MnE[ڈt}MD]$AP^@@{wn⎥ G /<4@^]6Ul,2xga߅^CBW`w{>vH.ޅ.;:Lu9Rs)oTAb+wl-)7TLrh/ l,΍ތvC!pE[%CgH A-NWPGA QmSA C-@{VAmm+0A '|BW[2(A;e)򳚪ҭ2#ebLnCqVVTSAR%2X bGԞoG3W,9&䨭`@{ JHk>rKiGUK8GmA C Y觽ik>s;mqGAP&^ # prԖ@{0@TQڲh/8Q[y p 1 p 1 p A' J A *[B`)[ !\`b /R-w] ¶BƣZVq٩~hwTXjN Ah/UdND)ɼѦF}WܝqB˗Ek5ꔁ8`]C] pтAAE7`9;b@VZAL<^ ѣO)rA^㏯9oO2gdsѓ|5>S@NpAZ9[RТaqd#}O6Rn%n"ݾ0gn'@{0X! "`45'7q?tijb'ڶZqs ɎJ#iWHÊxM&J (h/ Žci6rA^j]{4U,ECvA;DZI:QENmEHL`H, &jdKb$8m8ɵm@P,Z+ݲ!]+K)*(,VUS=!F "&xױj`6zh+U8JE"E@ Tp#6B`EMطgNSj s*$Z@WT H%ZZj@7A0*^ ~}d46lL9XסwȭUqx/BwB\=eRTAT)+zBC DPQh/䞁 h/?TwqAP)^ !+^ !+^ ?8=yPbgNWTA vȿ<h/ HA S|~O-yB^38ecDWM#^ `2`?K[_{H8h'nSQ}rUCQA@{0!.ckgL}<_H= odr` =42 %=A, p$9;<g.|[čRTtN-$qq={vwK=!e";@Xy[i]Tܗ ѪiGfA6!GҮI]QqN%R4&lrD[Oq`S_q'URtA{NmD^EOR--n5+^ # WV˳N=1V)EjhPQ$w?!S:ȳC PzB h/XD(^ґ@{0@TCHJ@{0@T p 1 p 1 p 1 p ajҷ5  -D"@{0@4@{0@4@{0Vk~;=(h/`˟R`O (h/WA} p aAǟI(gpy1 TћIc@(Sс=C\˺h~Ź"`A-覥E߱ (h/ 8z'oWg@]T(d}g8:R$5PP p "v<{3|y}.3郣rNEwF9cpt<Ő{GeN=Í˕[wm11q={vwc=od(a L`ˏZ{a'K(e#-=gh"hQ,׳F~|-GҮ:@uE9H1Ґ}H{`]6Z>)ukAP+L_8|# GKh8PLcu^{6QHdADZ& $~dg'/yI@ 'dILhh,EY4'VZ`{>䞣=?<غ4K@!P֏˕UAPMM jeQ;?q҅_z\r>_C/l`vï!& ] ]dSl-_K kzn_IW*H @A55 ^ #mL䙬/AE5HWj&pcNU!\` H'Չ vAUSM|h/ DW CW CWj)}[SAI@#eIENDB`java-design-patterns-1.16.0/observer/etc/observer.ucls000066400000000000000000000116211312550536300227520ustar00rootroot00000000000000 java-design-patterns-1.16.0/observer/etc/observer.urm.puml000066400000000000000000000042011312550536300235570ustar00rootroot00000000000000@startuml left to right direction package com.iluwatar.observer { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Hobbits { - LOGGER : Logger {static} + Hobbits() + update(currentWeather : WeatherType) } class Orcs { - LOGGER : Logger {static} + Orcs() + update(currentWeather : WeatherType) } class Weather { - LOGGER : Logger {static} - currentWeather : WeatherType - observers : List + Weather() + addObserver(obs : WeatherObserver) - notifyObservers() + removeObserver(obs : WeatherObserver) + timePasses() } interface WeatherObserver { + update(WeatherType) {abstract} } enum WeatherType { + COLD {static} + RAINY {static} + SUNNY {static} + WINDY {static} + toString() : String + valueOf(name : String) : WeatherType {static} + values() : WeatherType[] {static} } } package com.iluwatar.observer.generic { class GHobbits { - LOGGER : Logger {static} + GHobbits() + update(weather : GWeather, weatherType : WeatherType) } class GOrcs { - LOGGER : Logger {static} + GOrcs() + update(weather : GWeather, weatherType : WeatherType) } class GWeather { - LOGGER : Logger {static} - currentWeather : WeatherType + GWeather() + timePasses() } abstract class Observable, A> { # observers : List> + Observable, A>() + addObserver(observer : O extends Observer) + notifyObservers(argument : A) + removeObserver(observer : O extends Observer) } interface Observer, O extends Observer, A> { + update(S extends Observable, A) {abstract} } interface Race { } } Weather --> "-currentWeather" WeatherType GWeather --> "-currentWeather" WeatherType Weather --> "-observers" WeatherObserver Hobbits ..|> WeatherObserver Orcs ..|> WeatherObserver GHobbits ..|> Race GOrcs ..|> Race GWeather --|> Observable Race --|> Observer @enduml java-design-patterns-1.16.0/observer/etc/observer_1.png000066400000000000000000000777761312550536300230370ustar00rootroot00000000000000PNG  IHDRLe>IDATx]XGFѠ( **`{ *lccC,(* !QbƘX/7vo9v}xfggg疙ٝϊ#㬔.@ T@ $@ 2XD`p/D韨`"fJ``)IAz`$= a㟑!$هܲgjgg…m}޼9txhR*@00ԃ1_C#Q\|0JAHۻRuckR$= FzY|`% oHH-= TLlٲTRiƀ7oR9ۻdCvə̙0D8ڦM=¶kWOYWlkРJNc)XVC6~Bazpwt_\NT:<|]۶܉UH<+$sq)gȮ$= ;~bLXp 6ɵ7mZgCB&jUܹqp8dZz0cƀEF0_?3f2(F˖b„ʕK2X͚5ڵqrԩuѯ_'@il|W#⒤U}}FGϕ,ޓ'{Q*<{_noof7<@ bbխZ#_8 ?&M2_H[C۶l"+P`j褗.]XK\끋KAݝ+T(?qbo~ܚ͛Qg*X -sD 2ē= |aCݿɝ`+ƭ];2Y{:l٢|*(W( bХKnݚ[i>H&KQxʛZqnRQQs{CuV4|1$'փic.}{j,֯"ij޽[!"E穏 d(rug*Fm<̚5֦P<ҥ-=0R = Z I 'OjM0Viz&ӇOaK0&@R[< tb޽Kǰ$=PQ/ b$=H5 ZӼF틡ƉС]XgD8hXd@̔Q`^-6Q-Z6;z`錤Fet@҃d*zw3޹þ @ûw{rpVpހ1\ȞHz`TXI7t=P|}Ku,9l4^=ׇcϟti8c錤FtFKWÈW"Y6^$sضm&$*j d ϴ/dOg$=0* h@ar/[1xH]xIt=^=olmmA?6q=Ç#rrmȐq g錤F !3ΈB&{6p1#FʾZ7J-c9h13FP=`TjP t Ɗc =0_Y:6xɟB$ZT( *Za phcիF0dϐ &߾kذxiAh;_Z+{J\b[]X0~9u2EV$s ФIu8٬YMXq3i7 K` g6`Q:f 4}p_3gɂp-?&H.DѥCVij[ovAz G#g;gЋd-x=}Uch%Qv6FߎLLڕ1?<̓%޸q*ضmr Cyj ^Y| ݱc#GG;t_?67oB  CLq-0'=ز6'>>A2'O ۻ-ң7m\jl pΜ!8D-~ڠ{Rś;wcvAz2z-AHUk$=0*n@V &dd ڃLc Cao܈qD׷/{.ʒoOOw\VR ᯿.[+ygMf`|48@k8,]0"ܨSFl|mat"3f̀z81#Gvcd`;nKvvoZE]-FE B=Kj/Z0pQK+/UO_hAti &, UEdtq֭蘘y4iRt0FgcqtVi4?xl˩`EF\WL>$|E`D`n^Y }o׮yZM .HB \ ߽zFߎ,={6M.A?aê2b֬%J4ۅ"\f#͛QfJwXonMs!@'X2gfmf-8Օ3$~X@XvD;d˖a 1D`d~ARHz`T݀l@& ӃgCcv}}rwVۧO+ DdBnn5x^޽ If5,[PX;va~mdrfz6xJAH€+˗0豱c]-FAZth7Pr~ &~Ku& i ܥKvɦMӎ[>iأG׃s_ݩKtgSR>C˕+!HUX$ȑ'cntPh)$=0* b@~^5~~Ag 1qV+S+VSleΜH0fLѣߍy!®.-ZWp@WLʔ)UTI=;th lhA޼93{)M .Ht餞!>-y}߮Ox_LP$Yz fqrsE1b1>-CWϕ<b`CGW,髯25n\1-K2dBfVO85}BKtZ=غJ3޽,~BP<{f/_4F/ X?ll8FMmxa2sY4OH %i|'ME0bOdϟK.Ab7Yn>ɓ.xS]@0U4󋞴\=I+DOqS_( hȑd@R%:5n|PL@9=c]ܫU.N9ő,'rFrEytq)8ga˗s?rrx$Dz= ͍>Oi]7%6EL @M=;, 9+^!l`%6EL @զy-dd@̔rD߿̶c#gVYl;TǪ!=gn-F3%[?突^=c3aPÅ\52hޒIz`T1c袱O_ƧO0WI9=2~x |n?;7nNJ~8+\f^-FE0 oz@̙Y E-4iy01j/߭WcZ[JoF-F d4s|Zt 錖թS#ڑ *jNnMqB˗u]C`tӿgzmL6m.?.hm4ލAu뺕+DD tZv'{N0ݻ ?ٰ@0vX֧Kp.+/ˆgV-F HH…s4#`&_Oe>1ݻ}?J4~|/\=@ [[˖MΓOm8oVAj:ytR gy4 {2E]4o $=0*`@F1ϴ},ׯѕӬ J%xԺvH`ѣGqrd7X1czp ޽KGPR~תUDO@- s6B@NPRHz`T{{С!:II^:اO+{WWGܻH|z1wJ.飏^7q!HǎYg$$ծ]}[ysٳxO^|HTI ~kh0- Kn/he[KRIH h$=0*Ȁ)IH ԴE*$QALIz`jZ"xȐ`?'LZ>hEz`L1SZ UE郤F3%AHI 2 fJ҃ԑ"=KJXD@Se,DSDS uE郤FXԧ_|X| iуO@ۅVC#DK$Q4/ťs\U+st.l0˗9Dz yѣXM-9"A]݄C>|0/ : kDK!Qo׎O [ic_]" mH$O۷ʜ69%W׮]1!5CII?N}nٍ}/uT! TLlٲTR NYi Eq>J>>+W/Ÿn)G6XQuRW = Z I ܞ!Y?ՃpEK)uӦ5.vm;LQ^N񍈘@w}۲em7#zVj={V0pv΅ lybc.vvaaojf_%8yr?{{A'{Q;wb]# Φ J57:z._$l4NJ,@{9 c۱钙˴Bܜ!\O08tw(>;Gdh$A"С]uΘ1[/_N_-=<ň щvuu@{elgp8OOwa_84V(!x6waӧq+V,}2G*T(d>EJaݺ>bc J=i~l{կ_ ǟZJf..HBBƀL_$l6z2B(Y||~m`pύ{:vl$S<XXZXXgSp N4VO: 4tRٲEmbvvd>#VH-=رcvӦ5 t(VZ{{[ w`|eRHz`Th@Y$ŀӼ]-E-22 {TQ@[ ξ >BCh)V>w,4+Pfu|+V,c/avqGÝwc$@2}넼ys(Q}:fnǭ٠A2svAz@i4 Y˔H|l)hٲeɜٺX1g~MH͚%@xXrUV긻^=Ζ%KF`Jruua"_jJ\0J1cTŋɬ͛O &|˫%%d*2i=`)F!:s"ѫ5 ,c!/yO?ٳgsy=`bv>[h2ɓ߼yxbsÇ?~<ҥK1%OZ7hPG_N`1_؍h4 =xUW]ve˗/o߾}j;pTLO1Z]-ViӃ֮]~m=qD6mةcǎkӧOf7))T,ٳC͙33g٩S'䵬SH?.IHHȟ?{p8r1c  -SLl٪T?/^|P?]"GCPx}3esޢ'j"QLܹs'w!!!>lժU```bbbŊߏƺr@}}}مݾ}kĈH c1c)S r-[D'Oײymoݺ;Л7o0\XnԨQ#66V2ϋ/B NH̔iՃ2%⿇Hԇiу͛7WPoܸq)]zs"ᠠZj=ҥKs=ȑ#Kz9=߲eÇ[c<:}d;wOBX 1cH2a遙0z $-~!Ճ~eSGxVA/ O857oބu.UKp1Xg}ZݻcFE: yC3HHY|v>|˩CDj%S^r ֣Gsޑђv= 2~Ga߸qMz@tevXOi>5~}qHd*+<1q!^KBGczu?{.\Dy<&,,cPS.RփBssJo܈6 "bIz`TȼpN?X˜:?vd~z74ɷ_Ab4@^Jѳ~~ADK&A0|;whAфΜ ˙Ӟ9alҤ:b`@XX M]=ɪ-Vz/%dp爻ȑ]~Y 9r6lPd HѴAI_͉艃 _d[: M];tl)_ MW ~*YNݻ>>>BU7 ѴV zOOwNaP̈Nɋz7ɷt)sABUH/U3f8rd% SKyC&.ҡpW+P|"T߿ׯ_|}ٓ'O=z{ݾ}͛k׮^z .ov̙'O?~_:rȡC<{޽{׮]QQQ;v숌ܲe͛7ljժࠠe˖-^x…͛3gN@@ӧN:eʔI&M0;vѣG9|C{춶6662eb{+/66Ӂ741ӿbjLɘ1#W_}%K3;;;GG\r999˗/ ,\pѢEaK,Yte˖/_rUV^z5jժUNz5hРQFM4m޼y-ZjզM;vڵk===ӯ_à4hȐ!_7n'N~ӧϟ?r "b<DK$/2 @GFi1 H{CoDK! h$=0`Q$= Z"IǏ߿ګȀ)U QNxZ߿N:Em׮ǏeR~SN3gL-DЃ*UJD LѮH| ҥ [xeg暒՚zGWJ+Ce<%+Lizgg3gμ}ǧw޺R?~nݺfT оyZ}0ť[jMUۣY}+:Hۻ"I ={4nܘ^+!C"""hX=N4Ksh ۶ͬP8>>|GWMf pl\Zȑof3 3 cXC^~W}[o<ܹsw/ZSg%tE6nI۶~DY2ޢbŊݻ/w~-Pz4})zC{(C1{{۪UKՏ.?g $̕~YgϮ)a[22&f,V7E'=χ]%]CB&:wn<.UԳ=j'pE6sj$5o܈pc_$Y7T- g?9B0H?>o}둠-F2\Α4>$ vYɚd$:5k׺ҥ49?C , 0zE:GEy:-KqWqXaXQ }FH5lgŨN0t`gJ1uHޢϞ=˒%|z/J?> qƌrO04}GҳGd[2ĉP@h)9=`Ϟ@|. MrEF7lc[2D'~"kޒfv Tl ~T +Ƥ]u䌾9zH2Ix"gWqG pB=ԺZS|VV>ɨh9y끮a(Zٳg/P@F7oޘaz4.774ÿa$Gi0tx\a0R㛷d$@S Ki+V0l,xRsfkUwĪ%BWkGWn.ϬYlmm ʃ}@W0-YwFN#d HѸߜzݖwFr&.o4}߾Md6(HFSřp7bZ1x]wŹo{tU=+]A9di끱!o@q)9=1=HG^'kVc>9JoۯBUZ#SHwИ0`,^F]i݂ɷ ҃\)^ ,\ёe@ғ4% bQIz`Tŀ4cCQiEz`L1S-F3%Iz`T1S[=P0F5{ Sϳ2S"=0*Dӛ_#VӇ&Fz`Tӛ_VӟFz`T'wJ?p -gP%z MkngϮt9s7kV ,40m.ZZ9o5ƒ[E4No_Top..ׯMvb&z&&.҃ zs֬A׮m\SŧN<-6KO/]F[٢԰a߱S2z %MLU M]Gn-6D%iݺ. 1㔤,=t_VSo5"2P7?+^˼HQ^|HY&ܶ[rm<2~' F0dVm.u #j*Fz`T@hӠ!idzKyCo)>фIn-C@m.u #j*Fz`TȼpN?  j-/iZT؝ɷ@h-Hũ_VSo5BFR~d#8Az &J< M]=9EhZ[pRn!屢Qȷ4H 4\f\#"f@Йb/iBdۅM&-6KU/|i|$Ehwy>i)SkP5^|HI?M[H;' LШIjqry/i M][M̷Qa("%<%956ӓ741IH i ohb-FEZ G3,dɷ Њ b$= Z"I 2 fJ% b$= ҥff4pb4%UIيu3g ef2_]DӓȐL q?0zՖW'_hOw Nޗg*_]DӊH!*H/G>t(m3C4 ԨQn nb]z:L24MોhzfTA[ޙ;Dܰ[003[#nb]z:'Mોhzf>EMw&a7Ytޡi9]wKL˗g_]DӓHp[_>JkDc0uz4I=q&a7Ӄg΄aL{Ӗm\KOg^dZ8"FzpwWCPbX8SGv0J6.vݥ3/q2-_fI|uMO"z Taly:{@hܧ unb]z:'>eƙW$=0*Ң-^WlCV&xÇc3ʌ_[ ٔwtlmmXX$LtvӴ G>yt}ڰ[H6.vݥ3/dB_fE4=I/rvv1UV1CI?e_@/A]?ߒ97m\KOg^ZɄL㫋hz=}D1 !!cqlncsR3?xw矛%|Nիzވ ǃ`Ҟ==D\.# k:J%z)ef_]DӓHu е¸֭hsysFr %KD=ӿG]8uF_߾s2 `ӦiuTbaho%ѣ۱ڒsdL櫋hzi{e7dp8OOwa_8 9w\r&}4eoRO2Uׯ$3Oq:$= Z"ILXg1yr3prE4hPs%g 1z Ҡmٲ{.bK jqBdLgWO = Z ILX4֟7 ;aԩK.=|kcMk qQׯ3]=h)$=0*8a>5?G 8is%gsKd> y,Qt̾l[yAd*!Iz`Tq:تUwoի' ;.94=<|X$G@/,>UPME̜=]%$= Z"IOXOs%gTtٳgsY|Ѓ% xy|7o&t&\޷okIg2<}G̑F遙2zpY}1 ~5$c SCed'NĞԞ=`z?E11ϯU  l1ȑ0Vݧt&\.}%aLIz`T)SM\4_H@Ogat{BAI'bbO `lYލ/  Tfy,]:IЃ̙gb`'zH.O>Kf$=0*H̔׃/&NdLփ Kg_%'Z~Dh 3n'T\Da"Mky/!kfJLj=rcKf$=0*Lh#h}F\F-RLhڴ;^^wzR0H:D8h- 4su[̾cc=yru]9)i,O}%aLIz`TQ4t]gtv΅tjeNum}(?_PCO Ux&Nʉ' |Q8#:˸(bt&/!kfG"5Ѵ1F[|ՠU/㧃o޵mL,R~ v*8EfD/I'rFF*}~6qō] H4ީx6$vTo)22 {l"JsQ,_ hذ*o狛*iDK!QFhl:@rɓk˗/EcS?6lsClw[}Nō]B IUu~[)y>z52.n1 o<2z7^Tcʔ)J@0@%|:S(X1,du@AV`z޹vŋGM xl(EU􀐞`.z@"*@z@HO =0S3%*@z@HO =0Sn&H@&I1ULb = $@z@ T2I@ d@P$)*IR AU H@&I1ULb = $@z@ T2I@ d@P$)*IR AU H@&I1ULb = $@z@ T2I@ d@P$)*IR AU H@&I1ULb = $@z@ T2I@ d@P$)*IR AU H@&I1ULb = $@z@ T2I@ d@P$)*IR AU H@&I1ULb = $@z@ T2I@ $=zlٲJB_߿{a C ASNѢE۵kcɫܹsΝ;_vÇ/&@+=8p@۶m iD^^^9roo޼wp*UB$rxbN>ݫW/wwҥKw,Ν;Sӧ̙3o߾166j;wA~իk֬qㆇGӦM99֭[͛7GMի]t 1b%%%Y[[FGGjՊ}/EZzgϞƍB"3߼yӠAϙ3ǐ@ X<ҏ̟?v, k{=A̙D.#m۶-Z4**8TVg2ep-[6'O 6ϟ?%=J]+V޽; xg% q.^gF _~5@`ذaΐ+WSNA*WGX_pÇ_;99>d݉'T>n޼ ^tiڶmۆʷh)^"V߿,G @ փׯڵkӦMc۷ogȐӧЃ|| {CK$"~C8<==Ǎ@0ҕp+Cqb^z3a Kw!^={vB5jľy捉Hoz`F\ =A(ڿ@ d@P$)*IR AU H@&I1ULI/,1bA VJW@%a?6l [}҃(W(g_~!Z&,{n?{n9Vvttd15Iz@0)!y48PH,"@ =>S `j!j T3҃ǏJ21׷o҅K*͛COL\Qb  Hz@055*Ç#;vHA^-6Q,/_hѢaqЃc֠ )F*K.AgK,Ծ}W#e" 4tR2EeRJ)߼y:KsloﶒɄO|̝;1{r8w{np%cPlť ~nIJ$=PJxmPDo+w.y8Ž_!)>yr-°lHȄV갔;7'}Ku,9l4^=ׇcϟti8˿~~~L$"P+jjRrt-aHs}FN}mfK&c 6H 8HÑ{99pp6dHg8Px\n!IR)jС worv8|8X2rŊqkNF͛Q2Y{:l٢0SArEU.]tt:_N_2۷Y$$1ϟ ^$s@ >P t ƊcY'󗌤j H̆cx1 E6_O2!U9&kǨA'tsCvə̙xNpR =xӁBwa1fիVK[5C+Jv.]"?Ё 8CMWm3= Az'ts;c S}{۲ed﬒0womX/zy1+&%7:z., .rȝeC Ńe8CFLWm#=dZY Y zl((hlZxt9 |n0dP8KvFԩS$3䩒 mxLVK =nNHb[StaN'G7̐Sp6<KjiQ ݜ@x.փ9nnhu+vz ̍,UN%wFFHf mxLVK"Q 2zd򀽽ɓk[b HHóf9>!C:PmUԯGO' iv-x"K>jiXxyZ;}|XR A]`p$pq) >L)(PmTmSOE뇍LjpDP>FH!'sS4 =FЭp̔J|Z韡"TmS[Ff~ѓvޒpy74i).ckIW_eo}|uF`(_FkB rg۷w .P3U[-M2TmSm=1Fk׶#8lԨ*+pvdѯ?} _-[ԩ;^8Ɲ,ZDeچjmFD!~rgr*cՐfMvzЃؚJNČ~ٜ7phoo}Sn= g&$Vvy#7s^;FUUT}׍sgq& ??>yճvX5x^D=xLI)GG; =:E['vT}?Lڥ!8%a ^LkZ46ZsFMр_:1xojj$1;-cW~vwnbpVEWlC OG.T\bou d_OqAqɼx1"4tҩSP{y!3[.wܰTs#BI@}ō~ &3n LךdlsvHcu-FU>p`;%?چZ=TشB5}OsV1- /jذ*Na!Ѹ|b}e3g)s=(]0N >1qN-[4,w޼.W'iv40K=mg߿iia9,Ұ?7brp8KsL{Кdv=F&vРkNFsrv΅[9SAzi$uRt eE?E1ZbSFٲeALΜ˗aiX5kڴF~mg$s\O2"aahbcCǎnBCVK,`yIL,$ -4rIBH,Y^m7l[5 -rYhʏ=^ ްa)S5(QӬGf#FtYA[m~N,[۶!s+gfU1`.:"3[o=o}1cOfժ<=5<Kji`z*wM}mjγZs#!|ݲcv}}rV_˜ DdBnn5x^޽ If5,!UByXb='1əYU~tH,ϖGo'F!F,ܧ3)}4GW,髯25n\֭hNmG9K`p`]KpIֺ@WΒV:u*1U@FfvJ~)ީ5"s yix3 C_ƧO-o1U[-M3Nҙwv#NJE0v2ϟKn%dڜ%m_ElMk):%ןmxoz@̧wji`z@4_K0nMT9>yr CtnѢvN'QQsuk*_| NխoFGm3F84[ upҥ 7޽ӥK֭V\-iF0^v'{Na”*Uh^mΪji@z@TmxR-CB&q.D;wȠAqxUKslHxr"޽[9{8~|/\=@K ݲ%y˗-'?>ڸq~J4 = *C}ޛ7o"##;v%KTHsFu[Η?ׯX^z0bDW/JsԺvH`ѣGq͂[+GW S<~ujL%lٲ\!)փ)C!C:CW5qGQmFTm4 HP OW,4K>;h8qHa=6?{޾+CO`qdiS:^2RףG%@!(hQayvu[bk3ji@z:i&mxe z7'?,B0kzmDϻBܧO4yru]uE d{7&$dB&!H֬YMN9:ݿ{e~eʌjiX$$URJ&nn7d1Wla.c3ʤ^.]8Cvv 6,,eZ mV\ OZ6Y5JSc|VEf P<\j/V̹dBP ]gqFL֧OiSH| :#5hPe,9rd_\, &w8\|L U+w͇!/0 !H#x:?G^gچ'_-"6=q:oQs=Sކ ~=z4|'U[-MϢ ;9?{v[^-r{YmfGoBC')SCxsZC6zKIIcd `n7rd7KY2 C~(ʟnfA]Boz*ٿiϞu=B ׮]n7OggwݖMϑ͢kL?&կ_w"\QɼjiT&z 1qEŊ%XǀE0Ǐߎ ƕ+r߾}l"lM/F({aI57:z.@ziӴ:u*0n`p'#9#?o}޼/o ЪUvs$g4$4<̙0{D c+Q4P3[dd^^F넠1ÙmE/,+ .U<ҀȇӚ܍-mF0kL6Y@ gҲLD"TTI昒9C(xM QDz+3z+Sq|/s6Dc/FEE? eʴiE,);ǎ"s7 Dڼ9#keY7󋈈0T7" oV}@!eGbbbϞ=UW!kx!DA1`~X[C!ʎg}č, !f @3>#BBH"ͨ`oBBd!I38> HBH"BT0$iB)~B~@ $"B!4BT4!RB~@!fp|@ f!D*4BT!@? !RA? ? Hf!b l__XE4իU)ڽ{yÆuUM6n٭[ܔￏVĉ9l4 M3I? (l<%K&ݻe:й>vl>0"v_jeeyZ͛66U/^LQ-AѴ֐0F[j"4AMg!h]kԨҥoH7i95kPN nݺ(-.. ͭvj1G[ZVF%~ب5ܿ=}H[[k* M@C!%vI? c~ o_d߾jղZjUu3ylOW{73::eˆ[Z5[ {Ą /s'¢rFFzz0P@aAd458x4A~L!CbD5Dѣ{֮޴i/\8_nȄP~}[kLS|:NJ`ݢÚ55DE{YeD6`wB&7[[W;99_reiȐ^^=DD1EӦ oҤ%>?`oj $`$vv80xq'~@H~P._N5xr?77$򗤘xjk̨q"!JH@B$~@i !B?4 ^ N}2ih~TBB$~PJm[|@!;6{x͛"H4BoQmI7g'}YѶv7۵sT)*o<=}PB$~8#)ՠQmQP?46 `u3=֭-[fkD? DB-5FEYjѐw,=ۑ$O_Xf4Qt 028~*|m4ocS}/md~~6QQAׯ"޾;x)3l4U;th1yϝ;R~@Z.FxIߨmvXhQ(# <-mӦA%ᇍ)HXXTm(ピhi- *iԨ.~`m]ELJoP[7 +Gfj,!B?xh3#֎w cF@iÅ+yWݍɓ hee29ׄĪ,yu޽,+xz:k~*J-!B?xh?8>H IE]KE96ȑnw}{qu}EWH7k9YYؾ}s8fLN9O?GG:sNW_-3U(/"!(4]\~Y;t遵 vv^^=ĕ" ǎmZpn۶ r`ذuFܷ/b -[6 Y= /kk~J-!B?(% vZ1{Uc4r @.]+oO7U~Ǝ[!_}Cf*pxx, y@'Ԣ"!kᜁc{>/s'ԩDqըX]:م ;BB$~@i !B?4 P~@( D? DB"!J_{llHPo+reג%4o }{͛G|ޯ_7D? DB޽,^^D8>xpݭ[ rs>.XۦM+bU׮TjضmYo ?HH3o^p.egݻK_a/͛ۋ_pq۽{Fo:c]n˩"p0͚5HM-rfD? DB(**hhw$6X<~չg-tSj={ԠH%oTL>fdDP97ћ7̦[Z,Sڰ!L̙SD? DBheq̘~_|1O_zIIb1-mo48]DnH~1ǰa#lݧsE|#Fuwqt*G(!A1ڱcu3L샨=u0,^ݻ?~p e7+ݻ?^+]K,^2 LQ0Ȉܹ-Fo^MCb֬W!Atfb~25+Wv[l1#~xU P~@( D? DB"!J;+V f ZBJUP~@( D? DB"!L4 ( TB~@i !B?4 )~k[/6R,c"!z|9T8Hh˨G )7~k/\(SݺqWSXi"!GW^}mo^iҤ~ݽݻ'^B$"OWWđs'sܱvm+El:vlRW8E4OH~O  S+W~`@{Xxñ#G۩ysݻsu|/tG跶!,DlyǎE"}fzzJ2%("!2GOǑO#?Azؾ}A >5'gmJOm|FZQQA)]߸qfnqժY8"Pٳ}FF &~;nCH,"SLtt/6p)z?RYiӬ6m3ɇ$$iذnrǷne@?wn[͚V fG'[B$D:?kXZجݳԞYXD~oW#&M ?h^䄅_GX[W7n,!3sUeP h1l|&nZEdꗹs':wf6iR?.. ~ЪUClٔ.]D_&&νy3޾} 0n7W>thU5OHt~0&19rܔй;C Ey/2 mָq=|իiÇtD+¢!@HțQQAzx^V~~N>/zjPj~Z#-!"@־oeܰ!H`Qؒ%ڴi\5 L}?-+#~98Ա۷ӵk8;BGׯ٢"!24~kx ӑŔM@7x~4/o0C si ;4׉~@Heݟ׭Hw̙d b33W]3>FW~@( D? DB"!JH@B$~z'P+3򃌌^hfogFwKN9'O&!AAb177R*8 _գZ5Kb EZ7V2C7D7k֠~@Խ{Y8$ L6{;C+WNtСXLJP%";;['7Q!~@HΏf~_ֿw$|Ȑ#G`|) $$iӦC()::E *UEb1rCB…NNU(6QQYD& իWKndS!Z~ƍիQ~qĸ ToسgEՃԟ!shMڭ[#<Ķ GMLTe~@j=P 3sU۶M7Eu"_[a3ZH3".͜+b"+VGsN? D~̏vdEe4UWa ]ﾋEGw1\./sӦZKvJDOeƆ` ""4jȁO<9lkYYudk0SU?P$~pVF54/nӛ!n>{кzjNcc6ܿ -T9t%m(U-PAq Jg-]:fM+_ }NN谇7ґ>OWB[l j!^4j{};)~Tb5i\Lc?P$~.m83ԟ!Fbόq%!aTϹ"!"BJWҟFMf:0][2Jqff8! ;lF11_+QpyNJ,ř)HȓT9 P~@( D? DB"!}-+V@#B B)~@!D_2^:IENDB`java-design-patterns-1.16.0/observer/pom.xml000066400000000000000000000035771312550536300210100ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 observer junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/observer/src/000077500000000000000000000000001312550536300202465ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/000077500000000000000000000000001312550536300211725ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/java/000077500000000000000000000000001312550536300221135ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/java/com/000077500000000000000000000000001312550536300226715ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300245215ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/000077500000000000000000000000001312550536300263505ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/App.java000066400000000000000000000056041312550536300277400ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import com.iluwatar.observer.generic.GHobbits; import com.iluwatar.observer.generic.GOrcs; import com.iluwatar.observer.generic.GWeather; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Observer pattern is a software design pattern in which an object, called the subject, * maintains a list of its dependents, called observers, and notifies them automatically of any * state changes, usually by calling one of their methods. It is mainly used to implement * distributed event handling systems. The Observer pattern is also a key part in the familiar * model–view–controller (MVC) architectural pattern. The Observer pattern is implemented in * numerous programming libraries and systems, including almost all GUI toolkits. *

* In this example {@link Weather} has a state that can be observed. The {@link Orcs} and * {@link Hobbits} register as observers and receive notifications when the {@link Weather} changes. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Weather weather = new Weather(); weather.addObserver(new Orcs()); weather.addObserver(new Hobbits()); weather.timePasses(); weather.timePasses(); weather.timePasses(); weather.timePasses(); // Generic observer inspired by Java Generics and Collection by Naftalin & Wadler LOGGER.info("--Running generic version--"); GWeather gWeather = new GWeather(); gWeather.addObserver(new GOrcs()); gWeather.addObserver(new GHobbits()); gWeather.timePasses(); gWeather.timePasses(); gWeather.timePasses(); gWeather.timePasses(); } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/Hobbits.java000066400000000000000000000036251312550536300306130ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Hobbits * */ public class Hobbits implements WeatherObserver { private static final Logger LOGGER = LoggerFactory.getLogger(Hobbits.class); @Override public void update(WeatherType currentWeather) { switch (currentWeather) { case COLD: LOGGER.info("The hobbits are shivering in the cold weather."); break; case RAINY: LOGGER.info("The hobbits look for cover from the rain."); break; case SUNNY: LOGGER.info("The happy hobbits bade in the warm sun."); break; case WINDY: LOGGER.info("The hobbits hold their hats tightly in the windy weather."); break; default: break; } } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/Orcs.java000066400000000000000000000035211312550536300301220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Orcs * */ public class Orcs implements WeatherObserver { private static final Logger LOGGER = LoggerFactory.getLogger(Orcs.class); @Override public void update(WeatherType currentWeather) { switch (currentWeather) { case COLD: LOGGER.info("The orcs are freezing cold."); break; case RAINY: LOGGER.info("The orcs are dripping wet."); break; case SUNNY: LOGGER.info("The sun hurts the orcs' eyes."); break; case WINDY: LOGGER.info("The orc smell almost vanishes in the wind."); break; default: break; } } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/Weather.java000066400000000000000000000043611312550536300306160ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.List; /** * * Weather can be observed by implementing {@link WeatherObserver} interface and registering as * listener. * */ public class Weather { private static final Logger LOGGER = LoggerFactory.getLogger(Weather.class); private WeatherType currentWeather; private List observers; public Weather() { observers = new ArrayList<>(); currentWeather = WeatherType.SUNNY; } public void addObserver(WeatherObserver obs) { observers.add(obs); } public void removeObserver(WeatherObserver obs) { observers.remove(obs); } /** * Makes time pass for weather */ public void timePasses() { WeatherType[] enumValues = WeatherType.values(); currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length]; LOGGER.info("The weather changed to {}.", currentWeather); notifyObservers(); } private void notifyObservers() { for (WeatherObserver obs : observers) { obs.update(currentWeather); } } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java000066400000000000000000000024641312550536300323300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; /** * * Observer interface. * */ public interface WeatherObserver { void update(WeatherType currentWeather); } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/WeatherType.java000066400000000000000000000025221312550536300314550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; /** * * WeatherType enumeration * */ public enum WeatherType { SUNNY, RAINY, WINDY, COLD; @Override public String toString() { return this.name().toLowerCase(); } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/000077500000000000000000000000001312550536300277645ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java000066400000000000000000000037131312550536300323340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * GHobbits * */ public class GHobbits implements Race { private static final Logger LOGGER = LoggerFactory.getLogger(GHobbits.class); @Override public void update(GWeather weather, WeatherType weatherType) { switch (weatherType) { case COLD: LOGGER.info("The hobbits are shivering in the cold weather."); break; case RAINY: LOGGER.info("The hobbits look for cover from the rain."); break; case SUNNY: LOGGER.info("The happy hobbits bade in the warm sun."); break; case WINDY: LOGGER.info("The hobbits hold their hats tightly in the windy weather."); break; default: break; } } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java000066400000000000000000000036071312550536300316520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * GOrcs * */ public class GOrcs implements Race { private static final Logger LOGGER = LoggerFactory.getLogger(GOrcs.class); @Override public void update(GWeather weather, WeatherType weatherType) { switch (weatherType) { case COLD: LOGGER.info("The orcs are freezing cold."); break; case RAINY: LOGGER.info("The orcs are dripping wet."); break; case SUNNY: LOGGER.info("The sun hurts the orcs' eyes."); break; case WINDY: LOGGER.info("The orc smell almost vanishes in the wind."); break; default: break; } } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java000066400000000000000000000035421312550536300323410ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * GWeather * */ public class GWeather extends Observable { private static final Logger LOGGER = LoggerFactory.getLogger(GWeather.class); private WeatherType currentWeather; public GWeather() { currentWeather = WeatherType.SUNNY; } /** * Makes time pass for weather */ public void timePasses() { WeatherType[] enumValues = WeatherType.values(); currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length]; LOGGER.info("The weather changed to {}.", currentWeather); notifyObservers(currentWeather); } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/Observable.java000066400000000000000000000037211312550536300327160ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import java.util.List; import java.util.concurrent.CopyOnWriteArrayList; /** * Generic observer inspired by Java Generics and Collection by Naftalin & Wadler * * @param Subject * @param Observer * @param Argument type */ public abstract class Observable, O extends Observer, A> { protected List observers; public Observable() { this.observers = new CopyOnWriteArrayList<>(); } public void addObserver(O observer) { this.observers.add(observer); } public void removeObserver(O observer) { this.observers.remove(observer); } /** * Notify observers */ @SuppressWarnings("unchecked") public void notifyObservers(A argument) { for (O observer : observers) { observer.update((S) this, argument); } } } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/Observer.java000066400000000000000000000025761312550536300324300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; /** * Observer * @param Observable * @param Observer * @param Action */ public interface Observer, O extends Observer, A> { void update(S subject, A argument); } java-design-patterns-1.16.0/observer/src/main/java/com/iluwatar/observer/generic/Race.java000066400000000000000000000024531312550536300315050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; /** * * Race * */ public interface Race extends Observer { } java-design-patterns-1.16.0/observer/src/test/000077500000000000000000000000001312550536300212255ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/000077500000000000000000000000001312550536300221465ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/com/000077500000000000000000000000001312550536300227245ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300245545ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/000077500000000000000000000000001312550536300264035ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/AppTest.java000066400000000000000000000024751312550536300306360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java000066400000000000000000000045371312550536300315110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import java.util.ArrayList; import java.util.Collection; import java.util.List; /** * Date: 12/27/15 - 12:07 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class HobbitsTest extends WeatherObserverTest { @Parameterized.Parameters public static Collection data() { final List testData = new ArrayList<>(); testData.add(new Object[]{WeatherType.SUNNY, "The happy hobbits bade in the warm sun."}); testData.add(new Object[]{WeatherType.RAINY, "The hobbits look for cover from the rain."}); testData.add(new Object[]{WeatherType.WINDY, "The hobbits hold their hats tightly in the windy weather."}); testData.add(new Object[]{WeatherType.COLD, "The hobbits are shivering in the cold weather."}); return testData; } /** * Create a new test with the given weather and expected response * * @param weather The weather that should be unleashed on the observer * @param response The expected response from the observer */ public HobbitsTest(final WeatherType weather, final String response) { super(weather, response, Hobbits::new); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/OrcsTest.java000066400000000000000000000044301312550536300310150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import java.util.ArrayList; import java.util.Collection; import java.util.List; /** * Date: 12/27/15 - 12:07 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class OrcsTest extends WeatherObserverTest { @Parameterized.Parameters public static Collection data() { final List testData = new ArrayList<>(); testData.add(new Object[]{WeatherType.SUNNY, "The sun hurts the orcs' eyes."}); testData.add(new Object[]{WeatherType.RAINY, "The orcs are dripping wet."}); testData.add(new Object[]{WeatherType.WINDY, "The orc smell almost vanishes in the wind."}); testData.add(new Object[]{WeatherType.COLD, "The orcs are freezing cold."}); return testData; } /** * Create a new test with the given weather and expected response * * @param weather The weather that should be unleashed on the observer * @param response The expected response from the observer */ public OrcsTest(final WeatherType weather, final String response) { super(weather, response, Orcs::new); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/WeatherObserverTest.java000066400000000000000000000054431312550536300332230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import static org.junit.Assert.assertEquals; import com.iluwatar.observer.utils.InMemoryAppender; import java.util.function.Supplier; import org.junit.After; import org.junit.Before; import org.junit.Test; /** * Date: 12/27/15 - 11:44 AM * Weather Observer Tests * @param Type of WeatherObserver * @author Jeroen Meulemeester */ public abstract class WeatherObserverTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * The observer instance factory */ private final Supplier factory; /** * The weather type currently tested */ private final WeatherType weather; /** * The expected response from the observer */ private final String response; /** * Create a new test instance using the given parameters * * @param weather The weather currently being tested * @param response The expected response from the observer * @param factory The factory, used to create an instance of the tested observer */ WeatherObserverTest(final WeatherType weather, final String response, final Supplier factory) { this.weather = weather; this.response = response; this.factory = factory; } /** * Verify if the weather has the expected influence on the observer */ @Test public void testObserver() { final O observer = this.factory.get(); assertEquals(0, appender.getLogSize()); observer.update(this.weather); assertEquals(response, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/WeatherTest.java000066400000000000000000000063171312550536300315140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer; import com.iluwatar.observer.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.mockito.InOrder; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.inOrder; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; /** * Date: 12/27/15 - 11:08 AM * * @author Jeroen Meulemeester */ public class WeatherTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Weather.class); } @After public void tearDown() { appender.stop(); } /** * Add a {@link WeatherObserver}, verify if it gets notified of a weather change, remove the * observer again and verify that there are no more notifications. */ @Test public void testAddRemoveObserver() { final WeatherObserver observer = mock(WeatherObserver.class); final Weather weather = new Weather(); weather.addObserver(observer); verifyZeroInteractions(observer); weather.timePasses(); assertEquals("The weather changed to rainy.", appender.getLastMessage()); verify(observer).update(WeatherType.RAINY); weather.removeObserver(observer); weather.timePasses(); assertEquals("The weather changed to windy.", appender.getLastMessage()); verifyNoMoreInteractions(observer); assertEquals(2, appender.getLogSize()); } /** * Verify if the weather passes in the order of the {@link WeatherType}s */ @Test public void testTimePasses() { final WeatherObserver observer = mock(WeatherObserver.class); final Weather weather = new Weather(); weather.addObserver(observer); final InOrder inOrder = inOrder(observer); final WeatherType[] weatherTypes = WeatherType.values(); for (int i = 1; i < 20; i++) { weather.timePasses(); inOrder.verify(observer).update(weatherTypes[i % weatherTypes.length]); } verifyNoMoreInteractions(observer); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/generic/000077500000000000000000000000001312550536300300175ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java000066400000000000000000000047471312550536300332370ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.Hobbits; import com.iluwatar.observer.WeatherObserverTest; import com.iluwatar.observer.WeatherType; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import java.util.ArrayList; import java.util.Collection; import java.util.List; /** * Date: 12/27/15 - 12:07 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class GHobbitsTest extends ObserverTest { @Parameterized.Parameters public static Collection data() { final List testData = new ArrayList<>(); testData.add(new Object[]{WeatherType.SUNNY, "The happy hobbits bade in the warm sun."}); testData.add(new Object[]{WeatherType.RAINY, "The hobbits look for cover from the rain."}); testData.add(new Object[]{WeatherType.WINDY, "The hobbits hold their hats tightly in the windy weather."}); testData.add(new Object[]{WeatherType.COLD, "The hobbits are shivering in the cold weather."}); return testData; } /** * Create a new test with the given weather and expected response * * @param weather The weather that should be unleashed on the observer * @param response The expected response from the observer */ public GHobbitsTest(final WeatherType weather, final String response) { super(weather, response, GHobbits::new); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java000066400000000000000000000061151312550536300332330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherObserver; import com.iluwatar.observer.WeatherType; import com.iluwatar.observer.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.mockito.InOrder; import static org.junit.Assert.assertEquals; import static org.mockito.Mockito.*; /** * Date: 12/27/15 - 11:08 AM * * @author Jeroen Meulemeester */ public class GWeatherTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(GWeather.class); } @After public void tearDown() { appender.stop(); } /** * Add a {@link WeatherObserver}, verify if it gets notified of a weather change, remove the * observer again and verify that there are no more notifications. */ @Test public void testAddRemoveObserver() { final Race observer = mock(Race.class); final GWeather weather = new GWeather(); weather.addObserver(observer); verifyZeroInteractions(observer); weather.timePasses(); assertEquals("The weather changed to rainy.", appender.getLastMessage()); verify(observer).update(weather, WeatherType.RAINY); weather.removeObserver(observer); weather.timePasses(); assertEquals("The weather changed to windy.", appender.getLastMessage()); verifyNoMoreInteractions(observer); assertEquals(2, appender.getLogSize()); } /** * Verify if the weather passes in the order of the {@link WeatherType}s */ @Test public void testTimePasses() { final Race observer = mock(Race.class); final GWeather weather = new GWeather(); weather.addObserver(observer); final InOrder inOrder = inOrder(observer); final WeatherType[] weatherTypes = WeatherType.values(); for (int i = 1; i < 20; i++) { weather.timePasses(); inOrder.verify(observer).update(weather, weatherTypes[i % weatherTypes.length]); } verifyNoMoreInteractions(observer); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/generic/ObserverTest.java000066400000000000000000000055001312550536300333110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import static org.junit.Assert.assertEquals; import com.iluwatar.observer.WeatherType; import com.iluwatar.observer.utils.InMemoryAppender; import java.util.function.Supplier; import org.junit.After; import org.junit.Before; import org.junit.Test; /** * Date: 12/27/15 - 11:44 AM * Test for Observers * @param Type of Observer * @author Jeroen Meulemeester */ public abstract class ObserverTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * The observer instance factory */ private final Supplier factory; /** * The weather type currently tested */ private final WeatherType weather; /** * The expected response from the observer */ private final String response; /** * Create a new test instance using the given parameters * * @param weather The weather currently being tested * @param response The expected response from the observer * @param factory The factory, used to create an instance of the tested observer */ ObserverTest(final WeatherType weather, final String response, final Supplier factory) { this.weather = weather; this.response = response; this.factory = factory; } /** * Verify if the weather has the expected influence on the observer */ @Test public void testObserver() { final O observer = this.factory.get(); assertEquals(0, appender.getLogSize()); observer.update(null, this.weather); assertEquals(this.response, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java000066400000000000000000000045061312550536300324350ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import java.util.ArrayList; import java.util.Collection; import java.util.List; /** * Date: 12/27/15 - 12:07 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class OrcsTest extends ObserverTest { @Parameterized.Parameters public static Collection data() { final List testData = new ArrayList<>(); testData.add(new Object[]{WeatherType.SUNNY, "The sun hurts the orcs' eyes."}); testData.add(new Object[]{WeatherType.RAINY, "The orcs are dripping wet."}); testData.add(new Object[]{WeatherType.WINDY, "The orc smell almost vanishes in the wind."}); testData.add(new Object[]{WeatherType.COLD, "The orcs are freezing cold."}); return testData; } /** * Create a new test with the given weather and expected response * * @param weather The weather that should be unleashed on the observer * @param response The expected response from the observer */ public OrcsTest(final WeatherType weather, final String response) { super(weather, response, GOrcs::new); } } java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/utils/000077500000000000000000000000001312550536300275435ustar00rootroot00000000000000java-design-patterns-1.16.0/observer/src/test/java/com/iluwatar/observer/utils/InMemoryAppender.java000066400000000000000000000040021312550536300336200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.observer.utils; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; /** * InMemory Log Appender Util. */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } } java-design-patterns-1.16.0/page-object/000077500000000000000000000000001312550536300200105ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/README.md000066400000000000000000000017051312550536300212720ustar00rootroot00000000000000--- layout: pattern title: Page Object folder: page-object permalink: /patterns/page-object/ categories: Testing tags: - Java - Difficulty-Intermediate --- ## Intent Page Object encapsulates the UI, hiding the underlying UI widgetry of an application (commonly a web application) and providing an application-specific API to allow the manipulation of UI components required for tests. In doing so, it allows the test class itself to focus on the test logic instead. ![alt text](./etc/page-object.png "Page Object") ## Applicability Use the Page Object pattern when * You are writing automated tests for your web application and you want to separate the UI manipulation required for the tests from the actual test logic. * Make your tests less brittle, and more readable and robust ## Credits * [Martin Fowler - PageObject](http://martinfowler.com/bliki/PageObject.html) * [Selenium - Page Objects](https://github.com/SeleniumHQ/selenium/wiki/PageObjects) java-design-patterns-1.16.0/page-object/etc/000077500000000000000000000000001312550536300205635ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/etc/page-object.png000066400000000000000000001410401312550536300234510ustar00rootroot00000000000000PNG  IHDRZIDATx \ JE=R"lJr Z\rKZJhv]Z,H.Ξ=s:N3;̼3<ΜL9 QN$07(`n)_ T M#tQH4@ F`n4F07>`\bDTٳsq47O^ߒZa~~zhPGGk+oޜu |KJ07>)KswfE+,qs3hۓ'TIm5fLII7Si>XYH٘K֩c~NJs3FOr=rd!77mȐ.zf#P#!*07AHirGW^Lɍq *f۸pa x{]f-?m)9ymM}̍55m[kv޼_CуvvvMA% Hi={iiUXbwWMVVի;$/]:ϟ'TZɓD8#i^}+JHXu*In 'کpŕ07#eË۴qr儗/STʘ3j0vAmwMV׷ya͘~i6jϻ͍5坙6miUCCQ>#7ïfyZvmBn% H=P|TTN-ML O^/rݺ)[̤{*VMQ-I5ٲ{ukq͘޾MNMjMrrR8s#w ɓD[ۚQQ!3g6Pi/ )xq+J,'7nV/Y2[;+~~Dm,,Lɠ<ի'Ըt)9'' J]CttOϦޝʎP2[ s @QssRqW n9*S' sC vEN + @}pymcB0QYm7oߦ1 2  FTܐq1:y)ARYdL9)̌K|GJ[07>QqssRzy=Ƈ$8.s7S}zNMomf}٧4Iߗ  FT0vḦYordyr+%ްH{vm کwa۷ѤOXI.ԴjV -m%55׷Uվ+\\Of]Gv4lѢQ@Ĉ=DB]L4hao,)x?QFl7✝&,lد뚙YZR?PAժkkW׋֫gK,f]kddS=y @y0.1쮍fz/M~ gx5 M:mѽIXgѣh>{솬LVVvK~͙3/G==n;9vl9MzyQy׮9T>}z=iA @y0.1{i@CSW}Av{s`ߍ:.Kmg=bwh4hPz߿f=}z,2rT͛;hSo]Bگ_R9/LŊZ4'PBɓL6hҤϹTS07>Qqs3tkHGfzN=K;-Iz#٫G\3]a\.]Z}}}+9##*?|xɓ_cbm܉gwz|zUoٲ>'Y  FTܜn?]CƇxt'V]Ds ̈ˬ}؅ʿ=mWW_Y]TprsrR?&07ĈRX²_{{/38拯T.mNw˵$OCcll_ի;hՒ%c#5biY=zP/_#Êsq  F`n4F07>`\bFcsq  FJŅOyllǼٳ+V+9;$d?  FJܼys*''#͕+ۺuk[@F|+ujvI?  Fͻw<=ҵ…-t-53_V{OIYC Msׯvdզ˩SQ;w37_K|;wTr{mTaϮ]4jTIKK-[fffBꌃ+KzСY۶. rbT>kVPϞ}t8}z=3.2;K}{?Ha?p`y_9n\RRvm'ҥ507qis=7Q_~ً&=:H]%]ճɓ ­Ak) ''*L6LM"sC+C̞=h[{ֵclWt꒛[=ďZxXo-,LYa BRW7wfd$VMcr7_L@6ĉ `\bDLPn2(cAj֬oh2)i{Mŋ[{hܼ|ͅ [ ޽:vl1ʃ:u;[J,jO BVnԨν{ z`$޾MAZ ==Hd=wԩaC2M)N>y`EΝxĈ9rd1}p7&' %x\~nn]Y vFٳg]ca]Fޝn™y1cgW W>p. 5പի"SB#}S$!awڵ \uUS8ee$7s g(#憮Æuӣc؅=]EZoisذ}nm:/z͡^Sl] s ]ee&e(gN|M^ޙϓdj.wߢN{wco?"Փwl4}Μ 4:Y!ĈseɓO?mңG͝7oCǏh֬.%$  F(/e~Frs^N; sq  F`n4F07>`\b|r@3S)t4T @ÝMQ9ܹ̍#07# @̍ى HT(h,5BYܐa);l^z;(B07>Q`nYREXYU~vVV\ͲecvmC==uI˗fG/O$JXCC=[ۚRQk{"W'NYؠIK~9̙oޜn1Vb0.1R wW՞ǽ{ 47,-MSR(T3sý$j۹nTsrR77d_hIIyvv5iZ̻7407`\bon8~-"l6eJܹ#Jܐm4ܴj 55EE[ҩS榝8ݞV`uA|;ujh}\4{w+:oddb7{O | 37L$->^}vIϓ.]UǸq}s=Yx[{3gxŊZn˗{Vy93g6hiU z`$ Ϛt`Ν[Q%zqΦMlmk#|ssq Z 4hiTkme̞==Xĉ%kn ?pCDCFncaj׮gnHgn=ڟY%KHJOߨW567UVa]gg;*\9ˍUn4 Q;7dhĚQȶljdd`ooIREo_/ȋܾk<`O1MZں˗co܈~WF%nxM&$,֮tz!/77ܓof ƍ2U^  Q`nhkFi ?sRbrrdJhV:VɫAAf,~HsoMkh,Wϖon8Ù;g'rH07Ĉs3#i37ФLݻquu$@{lYȋ[V/ǘ-!%m@waT CQNF{Dʛ<*)iWP`\bDX/)ِJm,Qb[zz+UҲremnlԴ#KWugg`NiA۷)inHi ԙaú/`\bT-i?Ч"K$}G);ks'{yˠ07>řOۼk8P^}^L45+h/j<YǘxA P`\bwn  F`n4F07>`\bFcsq$`n|0.1R$s[9J>5HqMqgn[ז_:4z?{MfZں jK~H93Puܸ_L}{ɌD- OS FTwR%in vc/Im5fLi@i[.__$vd??&M jvP$0.11wn||Z\ II\\LTHIYӰ6k[ ܹj*:4w/**HO?zumj\ih##˱Tٻw{5+jӪUvoʴenn_ 'OR| Q$ot>8o¯2ŭ׍ 1@#NHRj^fGjϝPYATI]ܹUff/WŋGߺ[mnnZ*:*Ԭiͩ~n YnnTan F>hnYSo$2$7 |}_[pOWOoss$GEPeVV=NN6TE2]I]s6W]-UpF$fS{;}z}hr)WOU~2E;sP @(67ǣP3{|ϓ R]E||D>v=xpgC(Ԩa޽ׯv]]m[T]rՒ?=~…_w`q#^=ۤU*y`\bDIX\+W\K*\\KMv""FQKK.w}l"//7ٟ>ի_M1z6MGG[pss?Z(h9YlgS#ϷeϷ7633Zn ճ522`GMWw]Nll(][>]g lƅd665.]z,3l6l*$mJ<#d.-EnF 4VCyǀq>sfE&nܹt5\SR|q YVMӫLu{fjήf:VW ]ۂwWr*Oh+U0IK֝:&7my< cĈ2-sen!p|FF"ѣ#r۳_)j>Ycan|0.1gj`n|0.1s1̍#07# @h`n|0.1s1̍#˗J r`\bh  F`n4F07>`\b(Fݴf6;rHF07>Qx|ۏٚP/կ_>}zV 2HQ͍Ԣ߃M lmk.Z4.//+'۷O&32*gn[ז_:4z7>-m]1T_ԮΜHy.]ZT @|\Wѣ>:}!CPa޼/bkNsoĉM߿++in vnS9''׷՘1} yޝ@Ά;v^t, @u|-%cnHnn6mNNN6zz7v8w.ݷo_zz6e))k674#QVIȑTHOhcSUR(ss&'L?yk sSVҡC{2++IK ҃V8sCcuʕmF722|9*{nOڐaw^07qfґe:5\= 憮]*Uzȍqdk.\aú{{Q[G\iS'[ۚTIuccC?D^d~lTUP7ں5r@:F$;ӂ*WZJjɥUP~֬ ܹUffmOO]ɁT @(07]c' xʦ3˨@R}ϙܐ!͙3\Rpv.|ʕ؂6Mg>#**E gjOys U#166ѩS={>C֯B~%;$/S䮁 uŋd*NRy׮9 +in䮖MժU$qvk)Ҁ>6L)܌vα{.GQ4Im!gprq\Is3fKQèMfƍ25re37_=< 5t^ eg IPzII27@ _ ϟ%]-q7;:ZMsP0.1Rњ3;i\J?b3n][2T>p`!y*9{%66EI=2`hUh׮Ylg+l dnWj~5:mwFqq&99)|s#wfh~֭sP0.1R;M4Iʘ%KtVRpkϽN+@7)iyWfnXP [!A^ժ?ztjԨa>O/l ,ԁ3۴qa ^=ƦƥK>sf onV!ikWz0+7man* F 37AQ""-8FRsCWzWWdž ֵ RENtذ;VMӫL..̯VإKNZr6M dnճmή&Y+SHڵ-ȸߩS;7fn||ZTE[.UZ%;$ @EĈ=7~aڤهC@Efd$&܉?qb%+==1DK/}{؀>o&O{|1Cc"uP`\bD񿂏9+8>eYA |igWH۵k2 S6. an|0.1Ro-3W =Qa|96-mfHzh\\xioE`n|0.1R*U`\bFcsq  F`n4F07>)LkQrHF07>)LO^A,ZbW{?O" Z07>)amo׽?c23s5Kys+^=1"bdB¢aú533ZUoߦUקǛ?<`طh̽{]瞟~Upgw/ؠ{4{HsqI1qLm6kTx<)(U]ۜ;-¾}6o&okmm'&?YRzzo܈_}{fv܊Yj"[۷iVG(ܸqZ^Y9,l{o]"ǖ  jGFb J{dffԽ{[E07>Qln&Y^ D=, +WN3Onnښ5ڷwe?Ց S5 0rd'OnԨMWK n̛f 4668{vӕ+ >=Fc֭mVVҥK&&T(/z,^jojiԨutssBCΛE6656uz0k9kVQ˖ݘ[9rd`67"bu``S'?..љ93p~l@7"ڲe˗/N:͟?B $07@(xsWM}8 4u*7%z6-'' d)6lJ'WwЬܓœ޼9E2}c̿<8 w]~ܲ 11_X|L?=֮qDC8 #07 {fܸq>>>\eFFٝWUg޼yƍ2T|R401s1*[o߾ݼys//xt̀Nebݻwaaa+ #.]\gϞikk?yDٳgk׮=dEMgϞmۚ%M ̭[ʕ+G>OIvvvPP~yYXX!rʪUWݎ;֮];CCßYWW4 ҥKtTovqѢEBwMxz!t_nnn7o/h&7Pf%%%YYYzJ'Ok: gΜ;*ʕ+7n(tGh999@ˑO2/V-{fӦM*\vť{?/s4jժߟ}yyye+ܹsTB=R޼y3ydssG @Ƒ#GSRRp А?p>>'O5j@9_HC̍t 㓙ٷo_''/ ̈́y%~˄7G}v j L޽knnn``Hó4wիLI^.[۶mw07@v9իWsO={>yꤙ?Id*:bt钊A MܹsիW߱cd&888((H؎Æ [v-ĉ˾?…  s4dSSCIWOFFFW^&͛˗/ܹsѮM/SSS @07@sؿw}'tG[[cǎ-\OOOJ*TSNJߚM2۷B`nCW .A[[I&G޹s'y #]vmܸ1@ҥK_.tGԕ7jH^+֭366^z P{fΜrrrtttmTqFӦM;uCL~~Q7n~}*t_07@=p႙>*6mׯǍgnn~ sԀT  gѢEcǎ 97r4>|Mrr|9ҡC{<}wk(=`nJcǎիA޽{fffBB-Y@isTիW[XX#"Zj=_mժ)t_4`n2gΜڵkBʘv%%% ;s{ 4 r?aÆxr3r˗ qqy z}@C} lٲeff}#k׮ ˗Ç=}}@*ׯ{͛ Pz3fi|$07@UxEz["^/s .ԃM(c{D;`(I+dȗ*Tf*9a@C?޸m[~ۯ2 #L!;pW۷S07JC0O.:9땙y?S07gN` 9RzQ>4=yr,d R<<}z CC::Z;8XFէkРBL<R&dVjLswfE+,p4ɓD*3$yڅV0#ǏvڵB4de%-]:N+??;wTJ113l*7nB68o .*P3<-H;6!RsS6B~ Xtjժ5tldB~ >RenNԩV[7e˖Ty^BŊZ&&fFݺO/DճeKQ,{uk N͘޾MNMjUQyY쨨~͙3 [)K!G# /^֮]GfIί p>q:u~ɒ1ݺxa??wVI6Rϟ')hi665.]Ċ͆ S%R^[{z6}4Uv؜_CݦlNn ڷo_޽{*)(57 D6)bCC=Ç]]6'#\w˱o_==XYA3N!!k׶00ХSogpǖ1 }~sRBh3^^^͛7}62DLQY0efDe_f W<~ FdV~~ˍY%%d JR)@PiHnf]zA~~~,H#s`n 4TXfyfĉǎCfA'H%sA!řlaa1f̘W^! M 3+33,Hcs`n 4dfmݺ8222??i`n  Ϭwnݺ}2 Rw9{)}`+wYF^A%%2RIT*Rf兇!/j*07 6&$~ J-mIA%rseJEHr֦1)W*$KUȬ~~YYY"ϬbKIIɋr00r1:y)aY #pjH ~:9ٔFj=|(}\Cc+j- jWh`n@jJ" RU2+'''88&--MU|Q0O\,$ȑ¥t2SCoɜF&{*KlFd##Zr|ɒ1kLR)-yvWO 3g M&$,Ԕ`nJ[J" Rd֡CW>mڴoߊ-/ I9RT0vḦYǎrdyr+[GiЭ!ҋPxib'?>͒/Mfl/YׯS4&^L#O9_վZ5:u"?_U<)mc*$KUY=ܹs&M_.*j(67nn(,۵kz],(P~]8;Qލ͛Sr0^sM@-ԫ[n4j[GBmѓ3 Y2#2MV _K ^Oea49z?oKeZ;wnEe&T֮eQu ++J{{1clYړ>TKZװI.-զ M%3T-mgONJ4IWfRL!.)HƍhjR2AS2FuT$/UHf]Ȉ'/ ӬJSܹh6pHX^511 MFGOg͐#IM]^>} _w QIX'"7 ,YN:ϞJ^fD&-3ܤD-MR…_QL.D9sg>}}[$ U37dYX=`ԍM"G [CE82s؉_R9mI{7U#{ծ0>xoZ5}VOƂfa# =]fDsfyxO?m)onH.l뤟;knT9ڵ-*t|ժfvaԫW{lc}@W//7NSe MKSI$_*JKK*j65)$%E'T|p̍iUVBAtz25>ƣ\g=< =y ,iĈLÇTI{/}trHY_Q<"_CRtssF\Ľ9vl9}~e{cw)T?fL*?y}D2mzjti]ݻ=ES䟬;~3-`nJ[J" RUidhoo?hjf)_$ozIՑ( W P3VA!%,k>c:anHK>t\ի'JnRE?l: FÆuϠ37nnڴqĞT:pTiC6cutŃC .Y"wql}HE=,WpaC{ qKaJ}֮D4rR .2ڥHTUzgbb|H,lC{7..-UXJ> GH ew5_*SLx'\JWJ+r2#V8ի︰Z 5U|͚I372k_K-Y2 Pի=ܹ#"G ]ڝ}*WI7oYyc ۻ' eK=NOGO?mB-?@,cT-KUJ" RUfֽ{ڷoߺuwjdf)/~v޽3sO֮- \? GH n鱠溜KYYIϞx~TQolc,y$2ӓ'K[ΝlN>XfoM`nLJάHcc[jdfTݻ 1ʄGJ96R^M8Ç`sϫ`n:l2,%H$G`n4P/nܹm5Zm,A@%"u RUe֫WƌcaaRRHrR @Pi3رc5k֜8q7oYTB07T*z䉟_ YTB07T*YTB07TBfA  A!d$N 4ЏUgNX1^}ٹsvH@5rDu/Y2Eu_RWsͩ +WuV}שD!ąQ (dLQ17ޝlJG…-tG׷USRPE{k];firT#q߾ |I^}ޘ ^^nO8:Ztv{𰿿g׮m5~`iie2_Hqp:~|"uW:4kŒ ,EIүO{xJ ~{֬==pzj2;Kؾw|9p`y_9n\RRvm'ҥ5(,Q!9Af!S)%egnvqQQ!M>ztQR>R:TիgK'W҅[DqS8:9PaڴA`jj#1{̓צn*֎JV`333/މC0e#ڳg' ;K]mܙVhjZ577o2ǍK1eJ+?#G#H3 L`䗝!uk(7ԍyLRfum?dRҪ;K ~TGvC w．GDzp@@'j-Ñ?e4ɷ޻_jЮ! oߦԠBl,7g)N{ ׷,7X"|$<}Ԡ4s'QMsA4>)ȔF~ٙ#GӇ w~3aB ^HVM&VVC,p$/Iǎ*1#;5ztΤϓ(/ǂή&^A YyδUdիW#?_ˆvG"ec ٳ,-յkZ!uUee$i9sޖe 1in#ȑg2/;sC`ذo؅Ş(;rÑ|(ᘑH\'JvkNR`{jOԨVs'I'͛SYYIT;wKdE7v8p`P|}[ח[#F q4vevVۻw{Gq_Vq/N^ڧOJ˗c8472 L)/"3):ېy;հ7gɈeu{a+$ϻ(bz Ajxg\ͦM*X2CpyO",dt 2E ^ڽ{̭E> JCjYש3fVocSNt c.hu[7kvd??RISľ*"Ǐի=E UΟC} -,LsdSlsCR%)iW{;'KKӔ5rXŻPXrKA,ʵh2*찰75PIbaFd5u4ydURhPW 9wQ>Z%!5ͬ 8ǧŏ?H ^1yPAKknj0b%ʙC8g)S Xe*7jTG^K5 ^lsCU[ҩSQ\XrèbQ.Z5HM& ;,{5>yr͠A:tt>w.ʕmF722pq^po|[Ki@A 12#2,ԦM *S7H?H(YPR̒{~5Nt,_>NAKkn޽{[֠HFTRTR(]O>tRlZQy_ Xő#K%J t]:+-UlsC (I/,=ƍX.5b)L,?+Vgڶmx[J7{X23ģ%IHAI!f "Mֹs+RȩѸ/Qb6v/##%ǘٳaCdɘHA,u3Sv>BQcm[//7&) b>g`ELOߨW5ŪUJ_gg;*\9*sv6"Jb) `Аݤ#Ƹ"E 㳠4%hYfWHua,I*רa1e RIMSIIsQ,BLB R_R*:}z2t()nG5$o8`w"iǎ]6h/b3URjkW~$*lT+t,RVc{ͬ} *\٦Fii._q#NIºZ|9viXC$GUґ-5,'cMdZN0~|?a,17H%5Mb%?(iզ(zu)1q9E2=Ʀ6ԱnH 1#PD7=X1Ӵt=M>èdcQ.H,vXc^=[~,rΝP37wfynL2*5,'4p/$yڵ-*cQwnD,eDHq-&WWG:7Q `|5ttI3Բe}(֭,e](cnd6͝3]ٳQ4ymrrèdcQ.ŢzX,_*I -"͈BL'KXMЪVpU;s^^؈\XW%2ݾ=,++:g< שSD 44UX1V-sRx{YDR%-;+WN9$>}:PAs#i37.lqvXQ2}f&7J6Ba-^,ʬŢ |VeϷr*JJ`%c=@aذr@`FºʻwusW'9т,(,( if)+Sܚ=FpK cI!&/L07H%Hr07e):JxQHI;MHa>܉gI 2ݽ1evO~U45y;;KX*TRusS$=}zletBuYmDyN{֬ 2FhyQ!햔ɂ2[H$J&DA 1@YP*T*Iwn U9!HŅ̂)H%!JC,HTB!4̂)H%!JC,HR|U^R#USʚ%Qdg|2E@ϞQTjF3!5@,2 TdsË<|_~Q__dhgk[sѢQ\3VVջti-ӏU&ի[׶V-k;\{+Takc~Z2774%YX{7NXiooYA&N.Ų3e~EuEHyB#K,d8Ub_KK|_#Cժ=M?W%p+ z!6yw)>ܬOQ}``AIaG{~.lg}Kds))v2 %N)kn8N|_YM>۷M0wV}-<^"XA))xYϞƒU֮tTg2w8' ۩SKGGs;K\ih##˗6ͧI2 |T Ṕh \,d8U]#99)t*Ub}Kbk2g4xq+kcAbx4&Q"(G~ȑ˗#YXXP.^<֭5s XQۍO23x7ѧ- сI_*5+ xp_έVK~ΦM*.v2 %N)kn/a@Rr<΂$:l֖-3%3eJHXD*)j4qruu$͟ Jݻeޅn][B2QRٳ>SQ-Y2F"u;1=}^eL:(V*SR8;Qa ^^n> (%@,crh !Y┒?X#_Uς2-m˱7nI?$ޒTN߾^(_ş6YQȑt;}\ Y|$W2Q2(!-]8.aǍ2U^ A)bhѮ1Bf!ĩbeaA$jcի;HRceff*xʔ%NdPP3%<3f$}ɧK$tP֫gfI%\P9}JFP2hGY,q{lj\2AN!IOPRs'Ow&iw tgF DL@xQZo&(((*JQ05I. &r AayHT@ HQ0:^0KMHi)MюuOjﵷެyk1cwXDwDb#;vB ,ddYYD3ɍ*j2J̙c\-|,sgȑCt?]\22ހ0T-ς54To-,tlJӣYm/ұIMffB@{{TaǏgtd +ׯw> (ضm9jㅇћ jh`!k'ko "ϒ'Cn۷+խ# dS7í[tBB~~dɆ``g5Yi]pg۷PAQњ6WLG秤m޽\%)@!XZ,Qg{>p_$"66G dMvy<@E'$ >@E'$ >@E'$ >@E'$ >@E'44TvP~#oaZޮP]'(x9Эڵ ۼr`- k'4YZ@Վ T[[6@!X ygc>9uj̙CB&oSͭEX=xzc򚿿ˬ78؏ 2-F9m84hSUUܹ_ye>u?ᎎ6D(4%0rЭ[\g0LN.qggOn0y87fc_~9%2ϝ+?}gA&Dwѣ[aa3^^n컦WZY]o޼QQX/By 3JԿxL3_/t'Æ 8~Gѻw%ul 5Z3Awi&k'k8ȳȳ_sQvdzf25 q<響ӣǏe+3Ø1T.'Bss3V>:E~'d?0G`ժo-l&ko<S쬜86k9~i/C]rG^)CL)`fLȳYD\IN5J{ۘ1c!sÆv~:)XWW3?\Bl!LNn "ϒ'cab1.!&2b`WpիXZv}۶-ׯJ jظqEzz9!˴)-Mh7ʀNLW([3AwH9/ȳȳ 3LO卍5Yz$?'0VnIn:*dH Ɇ` k'HY-=,# ??%5{׵pK ccԙ, u6:>vlu,|JIvvlzz4g91,}i&k'HY҄1l\h}rC 4F < O!H }< O!H }< O!H }< O!H }< O$$\[_vv.Y$ӕB/ =< OtR)B0g "7IB0g䉖'\C0%4F F,{֪,*>o2kxFpߓO5<M#2i„P醆I|""^^k SS#[HC0V!=5 gh.& I_ M# 7o3hV򫯶?$N1wW^jggO wt߰!Ba[(x( oǒ_EδiPܹ]BFur$V2|suϞw<=]OIyߋeVV~a׮L\ii*GnׯDÇ3{/0:7ޘ-ZܸQϛP(?'ZC{-Z-F} #:R[# @=}\l!XU1(`T`$"AAaT έKԐț2搛i&z? ؃`nѣ͛'O?{ԏ 駽o`ذHLL:~8~Gwk-ǫF/?s&]aeܲ10ΝM^-=w6}x럅)wF_ QvDaԙ CZG&# V]A$VQwEkgChƎM#sɓ}Gθq#01DQX0JhFYBkkWϜ9^s5$& fJNtH}f֤!C1?,;uXR5I`͛ߔ!Xh%hF#,aC, SA_~TڅFݐț2𦦑şĦ?Cdv{V9ܳh΀>{@2xG ,sʰKҏ?-Mcc[o` ]p: A9,-{dxeN`bE(F1,F̒֬yƆ^hhP犊~~5 :2_5kǢ-Z-?kW۱[6>K"h`1 k'ԳD{D  &qG.$7Dޤ75ܘ$V$&LzCI8DL]]1fر,P`]30&aӖBGygӠh:ihDU9jz#+k!ΰ$O2sre\^$6tDgB1c*%&kAtd]̈́ VTljèɲgiSD bNF+A5 gU^fwj˗<QkuC"oRFn+\\KIN~5(h0gĈii*O!V PӧUz*x۶RcP!LXx~Deo)~>Aacǎ` B _ mm 90eg/vgcȇjOl]?TljE-K{y}(VFk0R .E46$$5y䆼UOhr3p_fHryBrYBJY~),cG0gݺBaGoowX ZZv՝*1 f'N| dwd lL3V&Wի@۷+J pU 镕 Gi~ur++sn5h`ٲ9oe$j5Y6 ll,o:$C4k dmhF#,͜z/Ο [{ yS,_>isxFErbI8lvۜrV;U7nTs9Ë #ΝIv) &뮞z FժF^^b$cdMhXh*Zy ojh2"ְC;oǎlzuZ ߿t̘a.Mg]]q 0Nk'%p{j~&9Fnr$;;6==ZxPjks7κڵn呐l6RYMv}O$!HrAE'$ >@E'$ >@E'$ >@E'$ >@E'w~3͕&(K YYMȍ5#66LЦNkeet077ci#wVݺY8;;]5ر;wGS X+n qn?ťe`:22 d<խ0Fk FYήFHIZu&/Mpt[r=[`kkUVN>yyeh~ᛔ Cn !L֮?k7ȳt{V ɍ3Roj}rsԎs'.Z4ӵ6getsgaeA6,XsghMxxuϞwpz>)){idڴqڵ2+epZ%( }J#GݺuhU`$Tnhݻk 9srsbb&%}͛lcc3a;BGWb1.o`|@}KN~U8h2D Y{vu@%Dn5m75,-McFBWcG`0ɓ}y\x&LxMmۖKӧcűݣG3g؇XE+/ZYġ]ǨYBkkWϜ9#?sgӫWKEUE@pC0nׯ_zʯ{7+N߿GP,:ş~  a71{Ocoos@L==ڳ=[__dgс& P" sHk f,Ô),!O (.^Pݖjbg1Zy!^xesXSv`W1ʈF ?Rdh* U&MV0 MWWGҲ+(Es4ql0WUepX&t^,ݢ46@+la NQ!7>2Z B0Fk ϒgwQ Ea7Roj1HHL:pLd#"C8uBy[tЇ "g }'b99qlD+FY\F+F .w/31ypM"h*PWW p֬6Cر,P`]3PF{eJ"|sܽm7`ӃFݫ.)YhkzFF!X۟hY*3.=K4j(ڨܨzSȍӺaPb)4 "#RpCխ[ݻ͛!hZ[WTlĤ; J3N9~<)bpF "[k ̟hiRJO^^n_|߿v,9Ul;-18--R)B0dd^kW3_dNWOOWn@yP>۶-ǖ B& X&C4?k7ȳY]6HܛFn I.OH.KH)K@/c2i0D1WիXZv}9s</o{,1LMvd)ܸq PS))a}.-QuQap66pEmJKSvwnBh% (a8@(bbNnRULY&N|6舞FF!X۟믃F,9xhxP{S(ɉ%qHPA!u)yb!{ع3 6 EХ ؇%բ gt^^"O7izTpNՍB!XA95 ko-5 gά|$ x_||O]giu?:f̰K312BH3+e`R5NN=Gbcf;uNܻW-,[ qnn/$# d<}:/44%F %l0LN8ȳȳ'7*QPeWn}>*/0gN@nnBLܤiơEk&M)-Me {`yL}͛lcc3f]YApUP+WJ4e zxB=A,3+k[? .Ç?)m;wE3==]kks|%4$,,y9fii{m6ˉjh3gWn:ԣG7+N߿7G$ ƍ-"~>O?텭_Xhmm}3O0RS&7ʫWKPNN60YFƍ e#ihpHVF vIwwwi9kf&kos Y ,YifgG:d2(kz+ަ[7 3vuu,- +F a.J!rذقefY8h&7+Bqn^v?X reǡ'?%`&k'ko RgM#7IP),Í޽꒒ uufǎeuFn( 6kMb!gO[Bj"p>̢(?~$Lr篿ENQњC%\\Եb@˗5H|t,Mv Ln  ȅbMmvY j60.rӶBr] H@L X߾%'2=<\lK 2||W}啩iA+AV`Μ܄II`Aj>M|晿(>fP~ qԎs'~;;g}…=~~7l`%'M)-MU(Y?}_աCL8i,lXPѢӵ!޳c򚿿lhݻotm*9tHdetsgaeAE'yh`iaV1TR_}{oɊdC9w}kh&yS,AҠ~ɓ9ܖj"7:.[ھbAjt-%ADn*Dp }J:y|U0>r46 _?xўg[Y?R$rr`[QQ1EWZݶm[zGT~h޺u޼YSB /^ +`Ka PnML:`~hNpabZrN&|(2V55MM;Žw:~Ewh?][ xdd~n(_Xr&ݸq#X^~)I1@O+%uly9wFvx럅&A!X*bOXJr(:5#( 7rZ<ɐdr3%':`ɾS[3kҐJ(拋bXd\`4e¨!ΝI+v ;uX+* E%Ha~  enn2I ~BZ5 aZ1+?}T] ĪDzz#Y&мfؼMa)35X-X0*K U\\X!mV$H3? iiٕ<>Ut$u7Mk%7귥D%o27Qf#zЖ-amht-#M%7h (B)Zv5 #M#7?]?#?r׉M ilySptʊ^8~G _ ɍ8#R b*?{@2xB ,sʰKX`.8ZgQ>`f ͋?i!WP3-2O!4/O ׆)35X[̟PL'KQE'QԄ4A!XkW7Tc †]t$u7Mk5Hn4;yx 7SXG/\[Yz`˖6Qe4yH@S񑦑ĊĤIq( ihU`X μJN>!ƍKF`9.&,ر,P<]4Z=mٹ_@0|w~)n6`,MMBsy n^~>f$'4Yo S; YY+ q\ְ/:&  X ё$Z c t ޽Xg]]44BH3+ nz^)Iw[YF c}pojks7nWdgǦGKWe% u[Ɇ1y..ȳ/O P&,|?lCЮǟ Ũ=8 GO!^O^ӧBC|mm[6"]\T sh\ SS#u鑞 ٳlYYf͐hF&kޅm}F"7$rપ 'z啩8 7~i[lv'+ͭED1AΩS;Νh ;;kOOڇ۲={a>)){<<\ }Μ܄II`9ޅL8ipa/˺ب!t}KN~9ӦcePI> ̬3bu,l">t *oR*{"}PGBr3`@y&X>_}lOx 5@v?ᎎ6DY`ȡ[.Έ`F}E Lhҥ"]SsٷAAW/ضm9j rDE[~/M&r:̴a`#rC"w#+Gne偁 gB, 4[kϝ+"^YxxЄ #k<;^gɓ}wQaaa3^^nWZYġ$YuGyA LM;Žw_e V}vW mQ?<~/ӑwVܩ)T}? kj6VӱG ƍ`fE(G*~"tbiQmذL96XN ڹ)Yt4#dɍvaQ6/"t&ͻ@5k|kٲ9hǰ ͷo_QWW{@Xy+ˆc2푐0€1JBrSU y#tY\ kkskfNSfD ųDGXM"4&ͻܼY.v>/L~~yqzD (P%K^itMfFnEɍh_DԮ ES6HHL:pLaҗ.! (&+k!_tQњC~?#i 1F\r{pPWWlnnvX6=@y}y~ihD{KJ֣rxTN&MSB a`#=b5kM1PSgO[V hosr5DnDId$7xISڤyW3fXrg\VhΝI %v|yɃvʼ^FnEɍh_DԮ ESvZ7# rqJ,_"SXov5;s&il^%76D^~jkk󊊍scǎ`.LvG~!5(hP#E C~%Vҽu>/ '7m냌*C/u6ܐ]\XȞU(VF?amM ^B`xFzٳ*zQ^^J[mm7]2MCBFg>&=))9ZȠ]$J_E~GDV#ְXEޫ eN%>~>J..{3@3fإKE葯g]D•Ό$7 {X|P~ܐ] xqJIvvlzz4bHTWow-(P !Y팴%7M0Է_~"7$r v "7y ܅B0 A rC"wLh rC'ܐ](1 "7$r v "7y ܅Bqa"V/LP!-EDnH.4kz9& =ړ_ .Z4%uFE:v,Tbc~;w{ۤ쵪VV@nk.4FJnC4'׶%&3G0vS40ܐ]ϏC_ޫoWzlhlvO煆>:4T(_V3[[4Mq !rݜSE-sG0vS40ܐ]ZHn2||pp+S@nw|owbYY+YXt>| ԩsN\hkmm+g;8>%5/YY+k~wϙ37),G 3odg ضo)|y1\M}  wt߰!䓔ΝM:Jvؗ4iӓ'sBB&M4Xѭ[&M)-MU(_ѡ6mY .ջw1ڇg9r֭E{3p7" 4ʕMݜnx 7 ʢD W޽j00J߾%'*tsv)DnH.C4x$Eѣ۶mGa/Ȃ % v ?}gA&T(th?; 'OAwFg{yo^ZjeeQQX (|fGUb14~"x+f 6ibb>Á'N||aVǏ|#hObj1.%uŮ?>cYƍVa }!<}i!ވ<ŋ۷+9sqnNBch+~[WxAwqG/3jS40ܐ])9!KښYU ܙY qҲ+9x} L @,$$S. 凂A X&d,$ef.vG%h@vvԩcYz;sXoFC7X&b),hw!Fc#ȿO)hOAn|YXwV C!-̞y7L.*VzYSO4}FY|6lyebP/|*:IhxmkQ ( S\4m-TnK)DnH.BOȏub!2e9^@\]ʏ\^|}=YIŋg.[6e:+BAp.$ U,2g *b'=.;KP?VI+ў!U ._4b0LيkksENM>Çx#,>S//0` !:IhxmkQMcc F f7*xM rC"wM+&=ġ$"SXf%FyKE9Z9d_"]TfPgş=!8??zrrXH6o=(Y]]1vǎeakfO{e|}!b+wc1Dwr#hOQ K(׷CBnfiS o`WAO_x#,>Vn/31y0ݜ׶44T{KJ֣_4=Plth`!h NfD..zCCd |M~׮fg#mV\KfÆ!BIpC0◵yEFڱcGxLB-]rAAʌ18--R0ly(.LWOOGb^ JBrZ]Zxj`uzy|ڵ2u_ӊ"SݧMByG̎EƚpvWtiN֢& W~۶^TvrM rC"w I.OH.KH)K@/c2UF"`Y__.Jn(=<\Zze۷+5`D~z9:ڇMƍK =9 ;v 5Yn!0+B43%FT+ў?ᕕ(tX0:BsD[!ަ4`״TkoD%ݓ򚹹SO4#͉BOImeQ*+TX&N| 6E Ec[^9<"9$ CiE2upvvXva˫UG#7$$9Q{qX}Dn]+cׯ6eʷЅ|y_S;}:/4A8֪bB6"]\jdh^[yym2*_u8{-+Kky* rCBB>@"Gi!y+LŊ rӿ_'ݾv'+ͭE rN1wEfY{z>,g;8>%5/YY+~gs&_}.7o3ǎeo)y1\M}  wt߰!BFnWN_ӦCA><}I=4ɧ4Ubf{H_^CL8iI4݌*{&L'Fur!mU!! E;YZ^Wm۶偁RS#B, k$[Ν+Zux럅M0RӱI|˗-Xs&ˍ}R++8IJ5~!y0,$:ş~ڋU6 [b-6l ĤV~96'N|UÌvb6h_},C:@OUU^բQ2y55MM;Žw:Guo 7n4/B1܀ctl&Y! h!7SrC ;5& ع3t]]1.,i]Y_б%[pww$ӣǏ2gXf2oowT? zV ;;_A@"GDnL+&=ġ$"SXf%FyKE9Z9d_"]TfPgş=p~~"{vɉcuqW(/o` +677;v, }]X2pϞ/D7AS25Nn>XʕM%7:͂e󎗗pq֢ ѱ-Yo 60VA䆄D]H(ȍӺaPb)2|ߵٙ3H/\8=.%QraC{Opayʎ;-c Dmlm*>9ՠBeFthll'2/\Gtm* sN/KўVW*eP 11 Ҳk}}9_wr-FbBy}4بj"7CU!!Q9&r3p_fHryBrYBJY~R,55¢ HL@7^Qrk+6W/"}v2 l۶_^AzƍK p9!r/dݺX80x{8`dOrPMm:v4,/Ptdsg¡~~++?fP[8?77AGr{ml,o:MiiFU4:Zu! hy6gT$'!CbX#W)u46h/sb!{U|Z+= rvݢ`B*/k DC3z 2{vdCC9?~]KTiK"2- "7$$$r Q+8ni؝OIyauhM3fإKEh׳N!\%VA䆄|DҺo(n9\)ΎMO<+46zۺv@&dl rCBB>@"G!ZDnHHH(DnDnHHH(DnDnHHH(DnDnHHH(DnDnHHH(DnZ׮_߼YJ}q?Ga#9J{iWKHo5/:ds3N?X2֪_^}>6c?98t:"ݽO DnHHH(FMnz駽,M͂H?ɯ0ll,Ϟ}kP0Hf4 N }v4z>M7ʗFٿ?'rm@!!! TUeu?ᎎ6D{>M#y晿]ݓ'sBB&M487䛙uju}w1*71e>hV8m8 ݠANQCCe=<>P9srsbb&%CܨU3\R#GݺunDnHHT|D,-Mc_@BW,=zt۶my}}y`H,E+"~s P?}gA&T(th?} Oۍ Ϝrc2ɉCIQQ8{0VA]Nn2 `6l kl?|{{'>ºJǮ_駽XAP4{Sӎqq/ݻd=ʘ,_>qق S'Sb/Z[o߾xM?^5z'P]D]~GS_ݏbCBƍ`fEhKpZyLdT> 2Vs!wc.j-! h!7SrC ;5& ع34i[X,-gbgoJVA֟]HO?~$&a˼Q UlJ^vXIn6X&)S|Y$?ao5#-. ^z]eL b?_h[௏WTST` r@5wfńFBm)`͛v!;;vԱ,=xp_J!Qf9#7`xݺYB,PnDnHHT|D,t]'6L"SX&11<,,PE?ʊͷB1ȕ+ÐɖXaɯΞYxesXS;bE(bNn򌍻( -S2KAW`b hvQ?TtXV=T-&f.  #ffQyD + %8&5oboofptBr^ J3;;k :sxr>VsFnpbmmιs֢a!!Q9&rcXt0!%27.5ʃ/]**,L>PMV!C:颢5C:+1_w"@NN[@]DOHn~S[[ N6_hysgO[ƍ vQP>Aŕ?P> 3`@􂓛={rQU/:LLܠ}L*A\Izdf.+Q'7Y > 6F}1(n-! h"7NfD..zCCd |M~׮fg#pD͆ iS=j\wY[WTl;v# K,g!Q(!#7.Vģ aWpJllvFo{?gN #Œ`F%Ht?Kˮk;d۶^ cA&_@bByڵW3 #F NKTyFe1ȍnDnHHT|D/\\\R_@"GEkؿ#*v`y|\\]gF%c tH}}=T• mDnHHH(Rԕ+%ٱ~A1ͩޤc׮WgDnHHH(R#7B+         ɍ.1$=|go+C EFEŽ4xpAEfW ߄&uX֝;UطTX/rT|Xa@`++s[7 ggk`.ܐQ܄L0a$c򅿓&DDhkrst^hO%Fٿ?[mrr>*A8{֪,ƳuA䆄|DBrSUCW^>4ͭEv ԩsN\hkmms++?p"8؏}7*LM; `pJIiiBInӰ*?۷dtdϞwpا}Jk^,S]{cӷcɯbXL r݃t0|Μ܄IIP̛7gϱcY 7{n Wc}  wt߰!B܀xik>m84ܹ]*x9r֭EPܐQi H zѣGmۖחJM:v4 'O=R++8b5KH|} Zo@ w&g{yVDUG{BaįkH0f0ni֯_ʯ87+N  /^poşWa2ML:R'ȱ9p ĉu=1be܀tlc%!!! h!7SrC ;5& ع3t]]17*X-蹙˼Qͭp᪉XZveip VG?enݺ-آ`ǯkA&䀑tn-Tf͛dgN:>)$7 vi0LҚȍ2ŗA_vrm)k@`ժ5 c%!!! h"7?]?#?r׉M IL  ܿt0,zz2?W1Xja'rc1_:K;Xdz]]3-2OlQekz+<`` POe-2/;;kh͜9^0€FϞ- NnXtmҿ4ѣ[uU Z9w[tu65DnHHQ4ĊĤIq( ٸqɨQ,}RQaarV!CADSTfPgşBByQ+_]S,@A޽{44T FwMك)@NN[EA[UGeuuŠ 15kM1Ɏ:}:(/̬3*=mY/tܸQIosrÕo*Q\X9!rCB„|D8V %/),7 g#p6l`Oby 8IP? 9 [8c^x%:yS55@FwM݊ "cǎ` 2۶-BubEVW1r- kʒ_ -#E>~~Jk..{k3fإKEHzIYZ A䆄|D"7WdgǦGBMBmmNuk To۵?p "7$$$r"7v "7$$$r"7v "7$$$r"7v "7$$$r"7v "7$$$r"7v "7$$$riwʵ-=|go+CDnHHH("7{iྃ9`oM5ر;wGݻW^ɩ'~9wrẃn,֮]S&q!!! H܄L0a${qCCI>/(ښܜ>y3pdt(\R"Zh!`H.7hq BJ иoqÈрkDε/:j:9!9=WoΗ7wKN׎9t8ngZ/+4ڧl7$1pS[[oiiֹ󗉉3#cLfofֺo_'@ <3fdgdzWVRmrqq{੮VlقUV&5pӵ͜9ߡ/t)[W_BCGΛdmmX^.g99V4ۍ9  CA.v0 ;|$7ݺN2Z"1>kF?Nec)՚SƎ ~qsIׯւ؀KA nH$Z$1q,La/޽<=]=*paO6WrE{tbF}^8l / …!j1imC8 `C٢QLtP5z 8]߮enn"&cA;#8x7C1Yn֜Є(Ϟ 1޽`??wodX֭?J%9|c]Zj,A nH$Z$1#Xt"=4 \6@}E_ Sk_G NNgɓC(9tZZ{/2= G]pcnn`޽ ETzr@#55gs/e^p HڶfDm=+ƍ=ztfGKpu1sƌ`m'Nx f 7Zy?e6I7 \'|ߙ-Z.Օ.Y2Y*Ν/[|q-`{Fz(eٲffݻeоxq/'s>h^yl΂QQbc. A fmmQa> 3tz7ǎmCj߳6`l;\~劂;0\pODjR Qe_2.H;;K81/^PqkkK ֡|Eed,ٳ 0E^n#-&({„;we~Ztcn LHi^9 zȜrJVǠѝ;~!!>[Ds:qnXqƭp>ܴoołońWW++37uA?nH$Z$1JtZ4M 'E/.ر͛㨑(@}xu~?{vV RQ5Tdaa Laq"{gϾ\ZM&g `_p,@wJȐ!XvFxʪÇ\nn'5UU%&OK~=RR%b4W8_ݽg`0WWGozg #S6#!h ĨO*+ 23WFp KJTU) 1e0I ܐnH$Z$1̀D5@n nH$Z$1̀D5@n nH$Z$1 PͽHfD"H%D"H%D"HNJh19@IENDB`java-design-patterns-1.16.0/page-object/etc/page-object.ucls000066400000000000000000000013011312550536300236260ustar00rootroot00000000000000 java-design-patterns-1.16.0/page-object/etc/page-object.urm.puml000066400000000000000000000001701312550536300244420ustar00rootroot00000000000000@startuml package com.iluwatar.pageobject { class App { - App() + main(args : String[]) {static} } } @endumljava-design-patterns-1.16.0/page-object/pom.xml000066400000000000000000000036711312550536300213340ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 page-object junit junit test net.sourceforge.htmlunit htmlunit java-design-patterns-1.16.0/page-object/src/000077500000000000000000000000001312550536300205775ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/000077500000000000000000000000001312550536300215235ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/java/000077500000000000000000000000001312550536300224445ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/java/com/000077500000000000000000000000001312550536300232225ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300250525ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/java/com/iluwatar/pageobject/000077500000000000000000000000001312550536300271555ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/java/com/iluwatar/pageobject/App.java000066400000000000000000000074501312550536300305460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject; import java.awt.Desktop; import java.io.File; import java.io.IOException; /** * Page Object pattern wraps an UI component with an application specific API allowing you to * manipulate the UI elements without having to dig around with the underlying UI technology used. This is * especially useful for testing as it means your tests will be less brittle. Your tests can concentrate on * the actual test cases where as the manipulation of the UI can be left to the internals of the page object * itself. * *

* Due to this reason, it has become very popular within the test automation community. * In particular, it is very common in that the page object is used to represent the html pages of a * web application that is under test. This web application is referred to as AUT (Application Under Test). * A web browser automation tool/framework like Selenium for instance, is then used to drive the automating * of the browser navigation and user actions journeys through this web application. Your test class would * therefore only be responsible for particular test cases and page object would be used by the test class * for UI manipulation required for the tests. * *

* In this implementation rather than using Selenium, the HtmlUnit library is used as a replacement to * represent the specific html elements and to drive the browser. The purpose of this example is just to * provide a simple version that showcase the intentions of this pattern and how this pattern is used * in order to understand it. */ public final class App { private App() { } /** * Application entry point * *

* The application under development is a web application. Normally you would probably have a * backend that is probably implemented in an object-oriented language (e.g. Java) that serves * the frontend which comprises of a series of HTML, CSS, JS etc... * *

* For illustrations purposes only, a very simple static html app is used here. This main method * just fires up this simple web app in a default browser. * * @param args arguments */ public static void main(String[] args) { try { File applicationFile = new File(App.class.getClassLoader().getResource("sample-ui/login.html").getPath()); // should work for unix like OS (mac, unix etc...) if (Desktop.isDesktopSupported()) { Desktop.getDesktop().open(applicationFile); } else { // java Desktop not supported - above unlikely to work for Windows so try following instead... Runtime.getRuntime().exec("cmd.exe start " + applicationFile); } } catch (IOException ex) { ex.printStackTrace(); } } } java-design-patterns-1.16.0/page-object/src/main/resources/000077500000000000000000000000001312550536300235355ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/000077500000000000000000000000001312550536300254315ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/album-list.html000066400000000000000000000037041312550536300303740ustar00rootroot00000000000000 Album List

My Album Viewer

Album Title Album Year Album Rating Number of Songs Artist
21 2011 A 11 Adele
java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/album-page.html000066400000000000000000000055101312550536300303320ustar00rootroot00000000000000 Album Page

21

Title:
Artist:
Year:
Rating:
Number of Songs:
java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/css/000077500000000000000000000000001312550536300262215ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/css/album-list.css000066400000000000000000000050561312550536300310120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ table { font-size: 16px; border-collapse: collapse; } th { background-color: #FFFFFF; border: 1px solid black; color: black; width: 150px; height: 20px; } td { border: 1px solid black; background-color: white; } th, td { padding: 15px; text-align: left; }java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/css/style.css000066400000000000000000000045071312550536300301010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ body { font-family: "Trebuchet MS", Arial, Helvetica, sans-serif; }java-design-patterns-1.16.0/page-object/src/main/resources/sample-ui/login.html000066400000000000000000000033111312550536300274250ustar00rootroot00000000000000 Login

Login

Username:
Password:
java-design-patterns-1.16.0/page-object/src/test/000077500000000000000000000000001312550536300215565ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/test/java/000077500000000000000000000000001312550536300224775ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/test/java/com/000077500000000000000000000000001312550536300232555ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251055ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/000077500000000000000000000000001312550536300272105ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java000066400000000000000000000034631312550536300334120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject; import static org.junit.Assert.assertTrue; import com.gargoylesoftware.htmlunit.WebClient; import com.iluwatar.pageobject.pages.AlbumListPage; import com.iluwatar.pageobject.pages.AlbumPage; import org.junit.Before; import org.junit.Test; /** * Test Album Selection and Album Listing */ public class AlbumListPageTest { private AlbumListPage albumListPage = new AlbumListPage(new WebClient()); @Before public void setUp() { albumListPage.navigateToPage(); } @Test public void testSelectAlbum() { AlbumPage albumPage = albumListPage.selectAlbum("21"); albumPage.navigateToPage(); assertTrue(albumPage.isAt()); } } java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java000066400000000000000000000041661312550536300325570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject; import static org.junit.Assert.assertTrue; import com.gargoylesoftware.htmlunit.WebClient; import com.iluwatar.pageobject.pages.AlbumListPage; import com.iluwatar.pageobject.pages.AlbumPage; import org.junit.Before; import org.junit.Test; /** * Test Album Page Operations */ public class AlbumPageTest { private AlbumPage albumPage = new AlbumPage(new WebClient()); @Before public void setUp() { albumPage.navigateToPage(); } @Test public void testSaveAlbum() { AlbumPage albumPageAfterChanges = albumPage .changeAlbumTitle("25") .changeArtist("Adele Laurie Blue Adkins") .changeAlbumYear(2015) .changeAlbumRating("B") .changeNumberOfSongs(20) .saveChanges(); assertTrue(albumPageAfterChanges.isAt()); } @Test public void testCancelChanges() { AlbumListPage albumListPage = albumPage.cancelChanges(); albumListPage.navigateToPage(); assertTrue(albumListPage.isAt()); } } java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java000066400000000000000000000035261312550536300325660ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject; import static org.junit.Assert.assertTrue; import com.gargoylesoftware.htmlunit.WebClient; import com.iluwatar.pageobject.pages.AlbumListPage; import com.iluwatar.pageobject.pages.LoginPage; import org.junit.Before; import org.junit.Test; /** * Test Login Page Object */ public class LoginPageTest { private LoginPage loginPage = new LoginPage(new WebClient()); @Before public void setUp() { loginPage.navigateToPage(); } @Test public void testLogin() { AlbumListPage albumListPage = loginPage .enterUsername("admin") .enterPassword("password") .login(); albumListPage.navigateToPage(); assertTrue(albumListPage.isAt()); } } java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/pages/000077500000000000000000000000001312550536300303075ustar00rootroot00000000000000AlbumListPage.java000066400000000000000000000056071312550536300335740ustar00rootroot00000000000000java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/pages/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject.pages; import com.gargoylesoftware.htmlunit.WebClient; import com.gargoylesoftware.htmlunit.html.HtmlAnchor; import com.gargoylesoftware.htmlunit.html.HtmlPage; import java.io.IOException; import java.util.List; /** * Page Object encapsulating the Album List page (album-list.html) */ public class AlbumListPage extends Page { private static final String ALBUM_LIST_HTML_FILE = "album-list.html"; private static final String PAGE_URL = "file:" + AUT_PATH + ALBUM_LIST_HTML_FILE; private HtmlPage page; /** * Constructor */ public AlbumListPage(WebClient webClient) { super(webClient); } /** * Navigates to the Album List Page * * @return {@link AlbumListPage} */ public AlbumListPage navigateToPage() { try { page = this.webClient.getPage(PAGE_URL); } catch (IOException e) { e.printStackTrace(); } return this; } /** * {@inheritDoc} */ @Override public boolean isAt() { return "Album List".equals(page.getTitleText()); } /** * Selects an album by the given album title * * @param albumTitle the title of the album to click * @return the album page */ public AlbumPage selectAlbum(String albumTitle) { // uses XPath to find list of html anchor tags with the class album in it List albumLinks = (List) page.getByXPath("//tr[@class='album']//a"); for (HtmlAnchor anchor : albumLinks) { if (anchor.getTextContent().equals(albumTitle)) { try { anchor.click(); return new AlbumPage(webClient); } catch (IOException e) { e.printStackTrace(); } } } throw new IllegalArgumentException("No links with the album title: " + albumTitle); } } java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumPage.java000066400000000000000000000117661312550536300330220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject.pages; import com.gargoylesoftware.htmlunit.WebClient; import com.gargoylesoftware.htmlunit.html.HtmlNumberInput; import com.gargoylesoftware.htmlunit.html.HtmlOption; import com.gargoylesoftware.htmlunit.html.HtmlPage; import com.gargoylesoftware.htmlunit.html.HtmlSelect; import com.gargoylesoftware.htmlunit.html.HtmlSubmitInput; import com.gargoylesoftware.htmlunit.html.HtmlTextInput; import java.io.IOException; /** * Page Object encapsulating the Album Page (album-page.html) */ public class AlbumPage extends Page { private static final String ALBUM_PAGE_HTML_FILE = "album-page.html"; private static final String PAGE_URL = "file:" + AUT_PATH + ALBUM_PAGE_HTML_FILE; private HtmlPage page; /** * Constructor */ public AlbumPage(WebClient webClient) { super(webClient); } /** * Navigates to the album page * * @return {@link AlbumPage} */ public AlbumPage navigateToPage() { try { page = this.webClient.getPage(PAGE_URL); } catch (IOException e) { e.printStackTrace(); } return this; } /** * {@inheritDoc} */ @Override public boolean isAt() { return "Album Page".equals(page.getTitleText()); } /** * Sets the album title input text field * * @param albumTitle the new album title value to set * @return {@link AlbumPage} */ public AlbumPage changeAlbumTitle(String albumTitle) { HtmlTextInput albumTitleInputTextField = (HtmlTextInput) page.getElementById("albumTitle"); albumTitleInputTextField.setText(albumTitle); return this; } /** * Sets the artist input text field * * @param artist the new artist value to set * @return {@link AlbumPage} */ public AlbumPage changeArtist(String artist) { HtmlTextInput artistInputTextField = (HtmlTextInput) page.getElementById("albumArtist"); artistInputTextField.setText(artist); return this; } /** * Selects the select's option value based on the year value given * * @param year the new year value to set * @return {@link AlbumPage} */ public AlbumPage changeAlbumYear(int year) { HtmlSelect albumYearSelectOption = (HtmlSelect) page.getElementById("albumYear"); HtmlOption yearOption = albumYearSelectOption.getOptionByValue(Integer.toString(year)); albumYearSelectOption.setSelectedAttribute(yearOption, true); return this; } /** * Sets the album rating input text field * * @param albumRating the new album rating value to set * @return {@link AlbumPage} */ public AlbumPage changeAlbumRating(String albumRating) { HtmlTextInput albumRatingInputTextField = (HtmlTextInput) page.getElementById("albumRating"); albumRatingInputTextField.setText(albumRating); return this; } /** * Sets the number of songs number input field * * @param numberOfSongs the new number of songs value to be set * @return {@link AlbumPage} */ public AlbumPage changeNumberOfSongs(int numberOfSongs) { HtmlNumberInput numberOfSongsNumberField = (HtmlNumberInput) page.getElementById("numberOfSongs"); numberOfSongsNumberField.setText(Integer.toString(numberOfSongs)); return this; } /** * Cancel changes made by clicking the cancel button * * @return {@link AlbumListPage} */ public AlbumListPage cancelChanges() { HtmlSubmitInput cancelButton = (HtmlSubmitInput) page.getElementById("cancelButton"); try { cancelButton.click(); } catch (IOException e) { e.printStackTrace(); } return new AlbumListPage(webClient); } /** * Saves changes made by clicking the save button * * @return {@link AlbumPage} */ public AlbumPage saveChanges() { HtmlSubmitInput saveButton = (HtmlSubmitInput) page.getElementById("saveButton"); try { saveButton.click(); } catch (IOException e) { e.printStackTrace(); } return this; } } java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/pages/LoginPage.java000066400000000000000000000066711312550536300330310ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject.pages; import com.gargoylesoftware.htmlunit.WebClient; import com.gargoylesoftware.htmlunit.html.HtmlPage; import com.gargoylesoftware.htmlunit.html.HtmlPasswordInput; import com.gargoylesoftware.htmlunit.html.HtmlSubmitInput; import com.gargoylesoftware.htmlunit.html.HtmlTextInput; import java.io.IOException; /** * Page Object encapsulating the Login Page (login.html) */ public class LoginPage extends Page { private static final String LOGIN_PAGE_HTML_FILE = "login.html"; private static final String PAGE_URL = "file:" + AUT_PATH + LOGIN_PAGE_HTML_FILE; private HtmlPage page; /** * Constructor * * @param webClient {@link WebClient} */ public LoginPage(WebClient webClient) { super(webClient); } /** * Navigates to the Login page * * @return {@link LoginPage} */ public LoginPage navigateToPage() { try { page = this.webClient.getPage(PAGE_URL); } catch (IOException e) { e.printStackTrace(); } return this; } /** * {@inheritDoc} */ @Override public boolean isAt() { return "Login".equals(page.getTitleText()); } /** * Enters the username into the username input text field * * @param username the username to enter * @return {@link LoginPage} */ public LoginPage enterUsername(String username) { HtmlTextInput usernameInputTextField = (HtmlTextInput) page.getElementById("username"); usernameInputTextField.setText(username); return this; } /** * Enters the password into the password input password field * * @param password the password to enter * @return {@link LoginPage} */ public LoginPage enterPassword(String password) { HtmlPasswordInput passwordInputPasswordField = (HtmlPasswordInput) page.getElementById("password"); passwordInputPasswordField.setText(password); return this; } /** * Clicking on the login button to 'login' * * @return {@link AlbumListPage} * - this is the page that user gets navigated to once successfully logged in */ public AlbumListPage login() { HtmlSubmitInput loginButton = (HtmlSubmitInput) page.getElementById("loginButton"); try { loginButton.click(); } catch (IOException e) { e.printStackTrace(); } return new AlbumListPage(webClient); } } java-design-patterns-1.16.0/page-object/src/test/java/com/iluwatar/pageobject/pages/Page.java000066400000000000000000000035211312550536300320270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä *

* Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: *

* The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. *

* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.pageobject.pages; import com.gargoylesoftware.htmlunit.WebClient; /** * Encapsulation for a generic 'Page' */ public abstract class Page { /** * Application Under Test path * This directory location is where html web pages are located */ public static final String AUT_PATH = "src/main/resources/sample-ui/"; protected final WebClient webClient; /** * Constructor * * @param webClient {@link WebClient} */ public Page(WebClient webClient) { this.webClient = webClient; } /** * Checks that the current page is actually the page this page object represents * * @return true if so, otherwise false */ public abstract boolean isAt(); } java-design-patterns-1.16.0/poison-pill/000077500000000000000000000000001312550536300200755ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/README.md000066400000000000000000000013231312550536300213530ustar00rootroot00000000000000--- layout: pattern title: Poison Pill folder: poison-pill permalink: /patterns/poison-pill/ pumlid: JSZ14SCm20NHLf82BExfXiYCJGOX3NpYzkDZRllsgTwjTgcmnmciV145N-rGdFMkbEZJ8OxMvo2rkXWSzE4lRxka7huj1YGyQN3UGMjgpdkh6Gdwlrl5QAk6_G00 categories: Other tags: - Java - Difficulty-Intermediate - Reactive --- ## Intent Poison Pill is known predefined data item that allows to provide graceful shutdown for separate distributed consumption process. ![alt text](./etc/poison-pill.png "Poison Pill") ## Applicability Use the Poison Pill idiom when * need to send signal from one thread/process to another to terminate ## Real world examples * [akka.actor.PoisonPill](http://doc.akka.io/docs/akka/2.1.4/java/untyped-actors.html) java-design-patterns-1.16.0/poison-pill/etc/000077500000000000000000000000001312550536300206505ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/etc/poison-pill.png000066400000000000000000000367311312550536300236350ustar00rootroot00000000000000PNG  IHDR@ac=IDATx_՝wUȉ#` uF(  xT@xG&&BGA~`Qal 3%nQg,06ȏӲ(ݎn߾m# :cwX)Imukq/Y⹊XA~b%}|sm%RZ߄ `!AM2n&ֲނ- ?@bY}Zlٶ{ܝxA~D 3gm1nikVVbېA~Dm%ugswm&;{F=wuݑ PȏLT06ȏL<* L< # `!ģ ?@006ȏL<* L< #t_\ydz_~jmĴ(trA~k?+^s1)1=ux(wA~hSu ~򵳯؉R=º>4/]z7H}k3Ν;( lOVwbIIXHXal eSgO~y;o+x[09}5ҭ -GG7|i#T_'f{nm]Kg 1|h06ȏL/ >[{NX6G~t|^ӿG7w[F>[Zj9!ܶ6,¤,L>MUY1~Wh;W>H3dң8xW|2-B1+^&vv9+&ĬgzA #,?sx%GxoJ}g=uҞU n\/70 0Ias债włCpϲ]yMn-"KcrӂPt'EM970wML<@u es|㟎S7=w_|oԡۿ~Sϝ;(\o 8 >AqiE' QS];>|.>i餭0ox ?@Js(i:ʙ w x)yLǗh⥓N+оtɭN[lViط\&݈&&:ȏL}k[O.h΁ǟ9.roX!}Ay?Pz.Uf.ҽ2ĞXˠ{E1#51A~4{t;ޡqOk;p2n4rY< Ѽ&^|'CwWO.ŕƥcV ~yk~x0O&1o\Q4Mk_tSPGA?9ptx_ߵK?+Mje򕿋k'_wn/YwRq܋KQxҘiҖZ*++r7_PGAOlN'g߾d-صLiQv𥨢DJ syhaKܥ `!(w﫹{C36-uW&wє돛oGG7(al x ?@006ȏL<* L< # `!ģ ?@006ȏLDckvGdO-06ȏ8َɘzajl6[)}? !h4:olW>eKCxGA\^w+3ʈ{cyA~elMWW`!hTn@OfN8}7׾O*uG.@C!?@2Q ?@006ȏL<* L< # `!ģ ?@006ȏIDMݑ P0#(:X ?@006ȏL<* L< # ~a־,$&ƗMZA~2¾O\~7j&BP#Q ?@ N3~/M>(L< # xSVtZgg.L< #5M|Uʧ`0@~ Mf|!]uz6|SXN)5ֶqqK-L|f*ɵ1 n&Y'qo6ֺ)t]kT( 78jz0 &>0nht:hvn(\ŖW^1[Io<"L<#f/G/l+ls-eS&>]^+&-}g[2ȏL?xSt[^[lr?m7[Rc' lg|zn&Bi2͜YT1:i}nClsw+R?v}`plf>&#߷yiڷE%n#&BW"tt*e16ȏUT06ȏL<* L< # `!ģ ?@006ȏIDMݑ P0#(:X ?@006ȏL<* L< # ?vj&Bogy[WL#Q ?@Ԣ[IT06ȏL<* L< #iwyWy]U6CdL< #m Wv7=? &[eLyMU^lm0@~8|,>~61!fSY=ez\6NokL>4K:3vp@~L7+gv]N1+ u3LnWUwոTk,\bR- ?@lu ?3f\pu}T:.q[vG̭}L<@; ?@l- \9VW1+ ]qٚ>d.[& Fȏ)\vhG9:萘c@: 7zyY;3 } cb!p¯^1wZ1!ff.}맛r8fc\%n{/Z6 k&B6>-bRLgUU7gal }alqܽ&CӮb (al xT@xG&&BGA~`Qal xT@xG&&BGA~Tm嬾% ]xGۀ>ڡoz~@Lnyi9u=6b !p9Y|pdmbBkڂru' ?@lt?\p`3hSn٠Jmu\+al 6zͺYdž_֋YQXf5%JrW3ymk ?@l- \9VW1+ ukyp})6b ?@lt١ w.ykhЦCbbQ89:c1^J+u{n+VW ?@W~FVLYoPQ̮F' ȕtBal n/&ńu~ ?@z1 ;)I[A~eQal xT@xG&&BGA~`Qal xT@xG&&BGA~T'fe5ce&Bvƫlv'0y>FZ_yު(06ȏ3WOv&&ĬbZ'&B:cS=8:l ?@lu?\p`3hSygV0fkG_ȏ[fݬc돯LcŬ(Ԝ0m蘍a╦9J22 `!,XrppZ-^Ŭ(}*xwA~؜C\<ѡMGmqnOױ5Tf>G6al +fc#ÿX+&Ĭ~Z\%z;QxG۰>9ml)-oB3h\غiVÍ6Z[u2QyL<@u0yw=NVY# 4nݎqtcM[˶ۆ4\ `$wL}5vn3]maceܽ5)iG P@^0KxhS|P"0#/u0H<@Scx%L<'x*T0(0H<@SG/B=&ٓgԼiQR{Z)L@u02bT( ~Vx/?cRbzQ^{'L<'yƠ$> n:kg_yx{u}ii?y i}k3Q.^%L<@u02T=RJpΞSwhVNwνOW6=Jlf1/r^]%s8c-2KY(&Ɠ"7 a2x/9e 2m%RZ߄u^7i'iS|HT0D䩴k}FV'E-7ll|&~)ߟ#MO[!11u/=mdԡ;devȻvsF0H<@ˈS{0۩*k$ޱ{ܝiEqCEp?o?m<}r߽mHDħW#_-#"OJNfƚm5m% ZћLhC\w>x;ا}`χdei<.l0H<@ˈS8w7kfHþ{s_ ٓ{t;ޡq ?-]ĻIK)w/Mӧ {V7c[nؙ2eJSz}MO̜~o8EZ&5=M|4Daӥ5w-1000g[ccc3f(<Hm0q3o_Z&^Ŵ(I;xT0%rȑYfr{<E-1jЌM o|x]4\a믿pRxeQ~ZeBQ=&&\nݪ8p`…ϙ2_)@!; ʤBըGyՉs%]_ɓ'op޼yj-s:\V''DHL<ʫX+a_dŋ_˗kRB]-K2SgO;Sfo[$o^aQnŒ^ >X;N2cǎ˗םQZdQÇ}9:>uxNr_͹s>:9lT0b~0Ɠ^9}ёBq{/URڷ5&ɖ%gO{r/n ݥ²MsM9:9r/&D{䉙c&6,O)rT,}(L{Z*.Œ^K<\tc p7x%G>1MH&}d}4sx%-)ݟ ~kCBz@ԑm[aĄtґ_4& նxoiM%+^Yfmjg2ϴSx0y56h}ϔo'7$~b 5kƍLRwGO45EU 5XGS$š:uӓ'VHLLKgO;uYfCzc» l}70Fϔxcβv-ֱxKzsmAȁZH_S<%:o"Ʒl)XO7ϓL;^ܺo6]sӼ9}i ;u3m[flݥ$76DƨBr#9Tגl,]\t܂P_g~uk}G#|L<;3?([0Ÿ9'=ڵtߚi#~#6΁ǟ9.roX!YvO|.K[𼋻:&%DlגfVp@W>B&(0X1Wt@X݈fk݈mYM&$'SgO~iwx{>v俶 w-f;xy{O+tO/ e;&~ժJ'd,mvMج^'nRpxxKz\t% 6MPaCb;:z#*k/X>% '$-H>Co鉙3o? GW1]˾te(F]m9+{9?^iOx׊%1Vi\E>T*Ə]Kq:Os%?31uœG-v$o~rKxق]ī%G!GKz-% 5Bv,ZQΞ{C36-uW&wѠZGKz%<Bv,(T0(bIqBYP7<7^oG>:jWˢB r+Jy(ޑ[Բ"PEģ܊%} W2:) )̶ղ"PE2IXQGMY}ֈw<$(Im~R\=6ղ"PEJ)#/Œ^ >G<؜rm--.`e-b[On~amO#'~`tpk+&EIc+ղb*&V,\!i-sXԍo1.h݈mYMne`/=Z'Wݺ])1-JDyc+ղSe0(bI0b'ǛJNfmuFlkU646a+Drxzf3~oRbZt: 1<]2yBsQ 1,tIe-E>rKEҽiߨ-.z=0~lE'ĻNrN:1sbBʚ2sVPxj}LDʰ.LfwĄ+eQYN*)&4EWyfOo\ʧ*׿=(bIz/oc}YryEt[5P蟴FJ1r6Ik`8ҵ puy{ҘPtqP&fQ9 DZbVߐd6,[P*EaŦq/ڝ|[WFۭLf^P,U0&^j/rYqv\KF (0A %|~^urV{۞,}ɏlәyC|2ubD]d"kܸFgQh]ʙM]Wl\7:Wg3H۵k=oޕ0+p5wRiS,o=\]ތ`׈@P" P;^w!YO2o|c^ÿJ6,9J}>L=P&Vm 5b%=clnwDz}l_ B=Vg5AIMɤ̘:u 0b7c95W4 D4 |PBeS%~:0wߢ;_uF%Bط~t܍{fFG7iXosS9Oƶ|85ӠO4|^uz*Rsuo_jgMjIնck(SIM] YR8o /ϙ^" PonCO=vگFNhzN]\2'S8'_<> K'% }{EMd=:Y]y^&>ӎ;J:=BA5"t븏[0m,Q޲մuZy7Nf_yM|יO'~*sPD?a.ns1/os.]?d_iʞg/?7~xZ+\LͤO_Z5]>9NԿ HErH,kwfEte^)L6J/(>FQGp"4IMߵ߮nv63KP.9Zwu<1cb_\λ[M<" lc/^eW(I'r?mzI\ 8 T x9ad[x^3`3eЮӲ;7 COW'Zq3|ijT|4PE*h'8a:MJy/&>%Xr1BU# uvaQѢ:wOjMyYZewRXK>6'%>kU|.cr_i\SQ<;nĿfav,&MP"0+ǥҲwZ> ,;@P'ii|>P%6GnO2q׌= | uԮE*RLS{gbT,[o]vy>О(Pѓ҅Uɧ)yà9P|3k:j-300PvhT*R?xԣbxƵ v1eʔoQD>_⓿:#-fmOsw7 Dtx֭_GLe}.=})E8xǁk,DHx[Mx.^N ˗/0o޼믿~gΜIFCO n"\^ݻs7_M&?88(3D^xT$OD}ͻ־,K\QxҘiҖ1ŌT "^xAT8O@Kq8:-{&&Uﴕo~a%:gguŊ.\p.m_+ s=G,s1cF݇4Xx]wu5t8Ů0kuٮ64&mw\+ɳ?f^pEaġnNa(D(N2eǎ>Ʈ}.7&>c_D}ru SpF_T*}D_;ߎ13kz3*4Mv a RrEWꂛyX!Sɑ # +mocQAՏ(>޶^ՎRB@w'Miob 0P]5ؗqՑ|FvcH-f[VJDTliCTg~i}LѠ':F)RV]<(FJcڙ|h|56h% A]syRQaVJW[Jjn]XKW.*=lGY{52JU'V&(RVQ< 1r1u腎| \Lt]jEσģ>քoT}hBP7ϕ"SWf;՘((MʛHJNבR PE 8Mc @`6#nЫex1=B]+ 6}'Lt1jG&{.!p}6s1x7)OO0_ղ"PEģ*1V:B7?BB<*eEDGKz%<~NS;>S0KH.͊!e(RZ]DHFQ^Œ^ >0P]-." U$g2!oV5"x ڡoz~@LXvcUk} 4]6DwTw wkq;|Y;N,GKzJ\e+MR?l-a,>~61!fSCb5 \9;EiG'f3\lѮYɫJl؂V"uyV3vC'g{ee-ϔ&>Տy">]<҅;uN[kwsplJ5㨿euC)a`\P)A,PGE>Be?\p`3hn0ѝx2fV0fkǘz/%7D#n KGMcXոO xʿW@[Mg$\ ̀r9_bpD[+R̝~/1oJ=Ʒ%zuDφqB>Bu ?3P-W ՙHW;gGzQW(q$cDW^ʊ([K!g[JpKtxuʵ-~OLwF•0 nί~Ӂ%/G^fqf(jIm!^*m}Adla\J.qDV#H_-hAv @" lrÖK}t\ūnQe;C%l>;'+n ,4MƞWbɩp:3K+uǧ%Ң ~Z.֯^1wZ1!fc9I;7M*I5}R:q&Dr{(cJMGǩ:wm[r1 b_:mfF^-dƜ@7!U]6kMqϕ8}lG!ƉYø[#8ۦEpG jy! =Qq I)&>חk1+RcUlI [nX`W73s٨=\/y3o%8VZib b4֖R#5PӎucU|&=(1-OC/6JMG]StGWybYw˽Ꮅ4Ti07dˆI:|'@10eIB)}xn$_Tts[eXk?:jW˒ *R g;vQKzm156Z v,Q"ģKz%<A]-K2DHx[W¸ղ$CDGKz%<#jeO!p1BըGyՉq%]_*BըGyՉ U$L<-L<'TC/؎R0(0=#wDwu0]V}x%<08<՜,>~61!f\$%G i_Voظٻh*[aZ wǦ"&IX|̮+)fE`޷w/k=Эcc󎮢mwR^3O;c 0L [,98rqbVj\l0zLWO[vXL|~lXqEr6WWm 0L²C\<ѡMG-|L7.7ީ 3>_Ǧ3n4QOixH0 _ݽb 862bBڜV9\m)ϱ-锌l *|&竟Mkm%1u $<<Qg|w,R}c˶l 0$0|@3ZX?ݚOU4xo&Sn OEqo,r@*R6ݙuAot(L<'x*T0(0PEģx2iu &yh x%L<@s#/a&y 0KxP/К\p7XR0į>ڡoz~@Lx{eeLh^&~G\{?ybF'QIaD6Vp7n_0!į|  rfPsxhMѫ}DaCfݬc돯LcŬ(Mm\)tKkfxc#0!߰e+Gj*fE'h&~١ w.ykhЦCbbQ9n;4F"a[{qldkń5<Ǭ &3leL|4߿|xib ;*|7PxPÞ젵LaC &(L<@s#/a&y 0Kx怉G^4lҤ:DxUD& 2?fbjIENDB`java-design-patterns-1.16.0/poison-pill/etc/poison-pill.ucls000066400000000000000000000132011312550536300240020ustar00rootroot00000000000000 java-design-patterns-1.16.0/poison-pill/etc/poison-pill.urm.puml000066400000000000000000000035131312550536300246200ustar00rootroot00000000000000@startuml package com.iluwatar.poison.pill { class App { + App() + main(args : String[]) {static} } class Consumer { - LOGGER : Logger {static} - name : String - queue : MqSubscribePoint + Consumer(name : String, queue : MqSubscribePoint) + consume() } interface Message { + POISON_PILL : Message {static} + addHeader(Headers, String) {abstract} + getBody() : String {abstract} + getHeader(Headers) : String {abstract} + getHeaders() : Map {abstract} + setBody(String) {abstract} } enum Headers { + DATE {static} + SENDER {static} + valueOf(name : String) : Headers {static} + values() : Headers[] {static} } interface MessageQueue { } interface MqPublishPoint { + put(Message) {abstract} } interface MqSubscribePoint { + take() : Message {abstract} } class Producer { - LOGGER : Logger {static} - isStopped : boolean - name : String - queue : MqPublishPoint + Producer(name : String, queue : MqPublishPoint) + send(body : String) + stop() } class SimpleMessage { - body : String - headers : Map + SimpleMessage() + addHeader(header : Headers, value : String) + getBody() : String + getHeader(header : Headers) : String + getHeaders() : Map + setBody(body : String) } class SimpleMessageQueue { - queue : BlockingQueue + SimpleMessageQueue(bound : int) + put(msg : Message) + take() : Message } } SimpleMessageQueue --> "-queue" Message Consumer --> "-queue" MqSubscribePoint Headers ..+ Message Producer --> "-queue" MqPublishPoint Message --> "-POISON_PILL" Message MessageQueue --|> MqPublishPoint MessageQueue --|> MqSubscribePoint SimpleMessage ..|> Message SimpleMessageQueue ..|> MessageQueue @endumljava-design-patterns-1.16.0/poison-pill/pom.xml000066400000000000000000000036021312550536300214130ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 poison-pill junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/poison-pill/src/000077500000000000000000000000001312550536300206645ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/000077500000000000000000000000001312550536300216105ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/000077500000000000000000000000001312550536300225315ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/com/000077500000000000000000000000001312550536300233075ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251375ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/000077500000000000000000000000001312550536300264465ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/000077500000000000000000000000001312550536300274065ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java000066400000000000000000000050311312550536300307700ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; /** * One of the possible approaches to terminate Producer-Consumer pattern is using the Poison Pill * idiom. If you use Poison Pill as the termination signal then Producer is responsible to notify * Consumer that the exchange is over and reject any further messages. The Consumer receiving Poison * Pill will stop reading messages from the queue. You must also ensure that the Poison Pill will be * the last message that will be read from the queue (if you have prioritized queue then this can be * tricky). *

* In simple cases the Poison Pill can be just a null-reference, but holding a unique separate * shared object-marker (with name "Poison" or "Poison Pill") is more clear and self describing. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { MessageQueue queue = new SimpleMessageQueue(10000); final Producer producer = new Producer("PRODUCER_1", queue); final Consumer consumer = new Consumer("CONSUMER_1", queue); new Thread() { @Override public void run() { consumer.consume(); } }.start(); new Thread() { @Override public void run() { producer.send("hand shake"); producer.send("some very important information"); producer.send("bye!"); producer.stop(); } }.start(); } } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java000066400000000000000000000043401312550536300320450ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import com.iluwatar.poison.pill.Message.Headers; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Class responsible for receiving and handling submitted to the queue messages */ public class Consumer { private static final Logger LOGGER = LoggerFactory.getLogger(Consumer.class); private final MqSubscribePoint queue; private final String name; public Consumer(String name, MqSubscribePoint queue) { this.name = name; this.queue = queue; } /** * Consume message */ public void consume() { while (true) { Message msg; try { msg = queue.take(); if (Message.POISON_PILL.equals(msg)) { LOGGER.info("Consumer {} receive request to terminate.", name); break; } } catch (InterruptedException e) { // allow thread to exit LOGGER.error("Exception caught.", e); return; } String sender = msg.getHeader(Headers.SENDER); String body = msg.getBody(); LOGGER.info("Message [{}] from [{}] received by [{}]", body, sender, name); } } } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java000066400000000000000000000043141312550536300316370ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import java.util.Map; /** * Interface that implements the Message pattern and represents an inbound or outbound message as * part of an {@link Producer}-{@link Consumer} exchange. */ public interface Message { Message POISON_PILL = new Message() { @Override public void addHeader(Headers header, String value) { throw poison(); } @Override public String getHeader(Headers header) { throw poison(); } @Override public Map getHeaders() { throw poison(); } @Override public void setBody(String body) { throw poison(); } @Override public String getBody() { throw poison(); } private RuntimeException poison() { return new UnsupportedOperationException("Poison"); } }; /** * Enumeration of Type of Headers */ public enum Headers { DATE, SENDER } void addHeader(Headers header, String value); String getHeader(Headers header); Map getHeaders(); void setBody(String body); String getBody(); } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java000066400000000000000000000025211312550536300326420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; /** * Represents abstraction of channel (or pipe) that bounds {@link Producer} and {@link Consumer} */ public interface MessageQueue extends MqPublishPoint, MqSubscribePoint { } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/MqPublishPoint.java000066400000000000000000000024561312550536300331760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; /** * Endpoint to publish {@link Message} to queue */ public interface MqPublishPoint { void put(Message msg) throws InterruptedException; } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/MqSubscribePoint.java000066400000000000000000000024541312550536300335070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; /** * Endpoint to retrieve {@link Message} from queue */ public interface MqSubscribePoint { Message take() throws InterruptedException; } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java000066400000000000000000000051021312550536300320320ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import java.util.Date; import com.iluwatar.poison.pill.Message.Headers; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Class responsible for producing unit of work that can be expressed as message and submitted to * queue */ public class Producer { private static final Logger LOGGER = LoggerFactory.getLogger(Producer.class); private final MqPublishPoint queue; private final String name; private boolean isStopped; /** * Constructor */ public Producer(String name, MqPublishPoint queue) { this.name = name; this.queue = queue; this.isStopped = false; } /** * Send message to queue */ public void send(String body) { if (isStopped) { throw new IllegalStateException(String.format( "Producer %s was stopped and fail to deliver requested message [%s].", body, name)); } Message msg = new SimpleMessage(); msg.addHeader(Headers.DATE, new Date().toString()); msg.addHeader(Headers.SENDER, name); msg.setBody(body); try { queue.put(msg); } catch (InterruptedException e) { // allow thread to exit LOGGER.error("Exception caught.", e); } } /** * Stop system by sending poison pill */ public void stop() { isStopped = true; try { queue.put(Message.POISON_PILL); } catch (InterruptedException e) { // allow thread to exit LOGGER.error("Exception caught.", e); } } } java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java000066400000000000000000000035361312550536300330160ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import java.util.Collections; import java.util.HashMap; import java.util.Map; /** * {@link Message} basic implementation */ public class SimpleMessage implements Message { private Map headers = new HashMap<>(); private String body; @Override public void addHeader(Headers header, String value) { headers.put(header, value); } @Override public String getHeader(Headers header) { return headers.get(header); } @Override public Map getHeaders() { return Collections.unmodifiableMap(headers); } @Override public void setBody(String body) { this.body = body; } @Override public String getBody() { return body; } } SimpleMessageQueue.java000066400000000000000000000032521312550536300337370ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/main/java/com/iluwatar/poison/pill/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import java.util.concurrent.ArrayBlockingQueue; import java.util.concurrent.BlockingQueue; /** * Bounded blocking queue wrapper */ public class SimpleMessageQueue implements MessageQueue { private final BlockingQueue queue; public SimpleMessageQueue(int bound) { queue = new ArrayBlockingQueue<>(bound); } @Override public void put(Message msg) throws InterruptedException { queue.put(msg); } @Override public Message take() throws InterruptedException { return queue.take(); } } java-design-patterns-1.16.0/poison-pill/src/test/000077500000000000000000000000001312550536300216435ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/000077500000000000000000000000001312550536300225645ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/000077500000000000000000000000001312550536300233425ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251725ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/000077500000000000000000000000001312550536300265015ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/pill/000077500000000000000000000000001312550536300274415ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java000066400000000000000000000025001312550536300316610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java000066400000000000000000000070111312550536300327360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.time.LocalDateTime; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertTrue; /** * Date: 12/27/15 - 9:45 PM * * @author Jeroen Meulemeester */ public class ConsumerTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Consumer.class); } @After public void tearDown() { appender.stop(); } @Test public void testConsume() throws Exception { final Message[] messages = new Message[]{ createMessage("you", "Hello!"), createMessage("me", "Hi!"), Message.POISON_PILL, createMessage("late_for_the_party", "Hello? Anyone here?"), }; final MessageQueue queue = new SimpleMessageQueue(messages.length); for (final Message message : messages) { queue.put(message); } new Consumer("NSA", queue).consume(); assertTrue(appender.logContains("Message [Hello!] from [you] received by [NSA]")); assertTrue(appender.logContains("Message [Hi!] from [me] received by [NSA]")); assertTrue(appender.logContains("Consumer NSA receive request to terminate.")); } /** * Create a new message from the given sender with the given message body * * @param sender The sender's name * @param message The message body * @return The message instance */ private static Message createMessage(final String sender, final String message) { final SimpleMessage msg = new SimpleMessage(); msg.addHeader(Message.Headers.SENDER, sender); msg.addHeader(Message.Headers.DATE, LocalDateTime.now().toString()); msg.setBody(message); return msg; } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getFormattedMessage().equals(message)); } } } PoisonMessageTest.java000066400000000000000000000041721312550536300336450ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/pill/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import org.junit.Test; import static com.iluwatar.poison.pill.Message.Headers; import static com.iluwatar.poison.pill.Message.POISON_PILL; /** * Date: 12/27/15 - 10:30 PM * * @author Jeroen Meulemeester */ public class PoisonMessageTest { @Test(expected = UnsupportedOperationException.class) public void testAddHeader() throws Exception { POISON_PILL.addHeader(Headers.SENDER, "sender"); } @Test(expected = UnsupportedOperationException.class) public void testGetHeader() throws Exception { POISON_PILL.getHeader(Headers.SENDER); } @Test(expected = UnsupportedOperationException.class) public void testGetHeaders() throws Exception { POISON_PILL.getHeaders(); } @Test(expected = UnsupportedOperationException.class) public void testSetBody() throws Exception { POISON_PILL.setBody("Test message."); } @Test(expected = UnsupportedOperationException.class) public void testGetBody() throws Exception { POISON_PILL.getBody(); } } java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java000066400000000000000000000061341312550536300327330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import org.junit.Test; import org.mockito.ArgumentCaptor; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.fail; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; /** * Date: 12/27/15 - 10:32 PM * * @author Jeroen Meulemeester */ public class ProducerTest { @Test public void testSend() throws Exception { final MqPublishPoint publishPoint = mock(MqPublishPoint.class); final Producer producer = new Producer("producer", publishPoint); verifyZeroInteractions(publishPoint); producer.send("Hello!"); final ArgumentCaptor messageCaptor = ArgumentCaptor.forClass(Message.class); verify(publishPoint).put(messageCaptor.capture()); final Message message = messageCaptor.getValue(); assertNotNull(message); assertEquals("producer", message.getHeader(Message.Headers.SENDER)); assertNotNull(message.getHeader(Message.Headers.DATE)); assertEquals("Hello!", message.getBody()); verifyNoMoreInteractions(publishPoint); } @Test public void testStop() throws Exception { final MqPublishPoint publishPoint = mock(MqPublishPoint.class); final Producer producer = new Producer("producer", publishPoint); verifyZeroInteractions(publishPoint); producer.stop(); verify(publishPoint).put(eq(Message.POISON_PILL)); try { producer.send("Hello!"); fail("Expected 'IllegalStateException' at this point, since the producer has stopped!"); } catch (IllegalStateException e) { assertNotNull(e); assertNotNull(e.getMessage()); assertEquals("Producer Hello! was stopped and fail to deliver requested message [producer].", e.getMessage()); } verifyNoMoreInteractions(publishPoint); } } SimpleMessageTest.java000066400000000000000000000043111312550536300336220ustar00rootroot00000000000000java-design-patterns-1.16.0/poison-pill/src/test/java/com/iluwatar/poison/pill/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.poison.pill; import org.junit.Test; import java.util.Map; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertTrue; /** * Date: 12/27/15 - 10:25 PM * * @author Jeroen Meulemeester */ public class SimpleMessageTest { @Test public void testGetHeaders() { final SimpleMessage message = new SimpleMessage(); assertNotNull(message.getHeaders()); assertTrue(message.getHeaders().isEmpty()); final String senderName = "test"; message.addHeader(Message.Headers.SENDER, senderName); assertNotNull(message.getHeaders()); assertFalse(message.getHeaders().isEmpty()); assertEquals(senderName, message.getHeaders().get(Message.Headers.SENDER)); } @Test(expected = UnsupportedOperationException.class) public void testUnModifiableHeaders() { final SimpleMessage message = new SimpleMessage(); final Map headers = message.getHeaders(); headers.put(Message.Headers.SENDER, "test"); } }java-design-patterns-1.16.0/pom.xml000066400000000000000000000475071312550536300171620ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 pom 2014 UTF-8 5.0.1.Final 4.2.4.RELEASE 1.3.3.RELEASE 1.9.2.RELEASE 1.4.190 4.12 3.0 0.7.2.201409121644 1.4 2.16.1 19.0 1.15.1 1.10.19 4.12.1 4.5.2 2.22 1.4.4 4.0 3.3.0 1.7.21 1.1.7 abstract-factory tls builder factory-method prototype singleton adapter bridge composite dao data-mapper decorator facade flyweight proxy chain command interpreter iterator mediator memento model-view-presenter observer state strategy template-method visitor double-checked-locking servant service-locator null-object event-aggregator callback execute-around property intercepting-filter producer-consumer poison-pill reader-writer-lock lazy-loading service-layer specification tolerant-reader model-view-controller flux double-dispatch multiton resource-acquisition-is-initialization thread-pool twin private-class-data object-pool dependency-injection naked-objects front-controller repository async-method-invocation monostate step-builder business-delegate half-sync-half-async layers message-channel fluentinterface reactor caching publish-subscribe delegation event-driven-architecture api-gateway factory-kit feature-toggle value-object module monad mute-idiom mutex semaphore hexagonal abstract-document aggregator-microservices promise page-object event-asynchronous event-queue queue-load-leveling object-mother data-bus converter guarded-suspension balking extension-objects marker org.hibernate hibernate-core ${hibernate.version} org.hibernate hibernate-entitymanager ${hibernate.version} org.springframework spring-test ${spring.version} org.springframework.boot spring-boot-dependencies ${spring-boot.version} pom import org.springframework.data spring-data-jpa ${spring-data.version} org.springframework spring-webmvc ${spring.version} org.springframework.boot spring-boot-starter-web ${spring-boot.version} org.apache.httpcomponents httpclient ${apache-httpcomponents.version} com.h2database h2 ${h2.version} commons-dbcp commons-dbcp ${commons-dbcp.version} org.apache.camel camel-core ${camel.version} org.apache.camel camel-stream ${camel.version} junit junit ${junit.version} test org.mockito mockito-core ${mockito.version} test com.google.guava guava ${guava.version} com.github.stefanbirkner system-rules ${systemrules.version} test de.bechte.junit junit-hierarchicalcontextrunner ${hierarchical-junit-runner-version} test net.sourceforge.htmlunit htmlunit ${htmlunit.version} test com.google.inject guice ${guice.version} org.mongodb mongo-java-driver ${mongo-java-driver.version} org.slf4j slf4j-api ${slf4j.version} ch.qos.logback logback-classic ${logback.version} ch.qos.logback logback-core ${logback.version} org.eclipse.m2e lifecycle-mapping 1.0.0 org.jacoco jacoco-maven-plugin [0.6.2,) prepare-agent com.github.markusmo3.urm urm-maven-plugin [1.4.1,) map org.apache.maven.plugins maven-compiler-plugin ${compiler.version} 1.8 1.8 org.jacoco jacoco-maven-plugin ${jacoco.version} prepare-agent prepare-agent org.apache.maven.plugins maven-checkstyle-plugin 2.17 validate check validate checkstyle.xml checkstyle-suppressions.xml UTF-8 true true true org.apache.maven.plugins maven-surefire-plugin 2.18.1 org.apache.maven.surefire surefire-junit47 2.18.1 -Xmx1024M ${argLine} org.apache.maven.plugins maven-pmd-plugin 3.6 true 5 true check exclude-pmd.properties com.mycila license-maven-plugin 2.11

com/mycila/maven/plugin/license/templates/MIT.txt
Ilkka Seppälä true install-format install format com.github.markusmo3.urm urm-maven-plugin ${urm.version} process-classes map ${project.basedir}/etc com.iluwatar java-design-patterns org.apache.maven.plugins maven-pmd-plugin 3.6 java-design-patterns-1.16.0/private-class-data/000077500000000000000000000000001312550536300213145ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/README.md000066400000000000000000000013001312550536300225650ustar00rootroot00000000000000--- layout: pattern title: Private Class Data folder: private-class-data permalink: /patterns/private-class-data/ pumlid: RShR3SCm243HLTe1RFwx3S4eeSB4uf6itmpGlwkZ-nOZhS7b-ZeoLtm07E--InwrLR3JQScMdSu9edLZeiCNBso3GtPh2pFPBM1YF07BvSBaHeeHRJm_SD8VxkMphvhw0m00 categories: Other tags: - Java - Difficulty-Beginner - Idiom --- ## Intent Private Class Data design pattern seeks to reduce exposure of attributes by limiting their visibility. It reduces the number of class attributes by encapsulating them in single Data object. ![alt text](./etc/private-class-data.png "Private Class Data") ## Applicability Use the Private Class Data pattern when * you want to prevent write access to class data members java-design-patterns-1.16.0/private-class-data/etc/000077500000000000000000000000001312550536300220675ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/etc/private-class-data.png000066400000000000000000000250471312550536300262710ustar00rootroot00000000000000PNG  IHDR2<)IDATxE/1HD 71i j9JHICJ᤼*6T*`ߵ7ZixmĊF $}SP%'$`bH /x/3;_wvg_{|wf=3ݹt&S/A.` Aay%_@Չg奅2Z`&Ò1GTq~V,\a\sX" Xe`( `;%0r;lknyU~Zr9 ,+誢XFEd, DK XRUEXʙh#exįew6o%ZWǃTZQgh%m;Kt]Q),=ȹe7FER+?q,{Oպ/KtQEKޘ{ҒB ỊKI!=r۱DA{F[KՋ?02`Y^iRv*FDAQUEX|H@.eAc1dgN/lTmQZQ_,ˡϖ(観RaN EYԨ/o*XeI0x`8\K|,}2DQw.KDaK߹ ,,}2D,_}#_ɵlglOSG..AasIK_7A2},8GXҾ+WN̛Oտx}]xzKU?U#l#D8₨wZ~_@Z[B cn؅ޓ{νV^ ?<]ۧxb\l1>H銣v,u6,Pvr߼h//:3l<{ly*NͦX$ ?$r2 R92 x+ Xy;zUa,7޾eW>[~I]= oaiC1jJ:)y'%*ɶLi O\"K&J(V1#yZeҁs 5%)䁍EW{m\re6_|QٕLh>#OJ(-hւ(?mB],+4,I`RĬO+ׄT[˯ܼAڲ,xo62 ~KdS㓸T8'mre R?NLRa,͚Ў*0Aeۇ;?s_z{rg?-;b?<+ǥN,\-XNWz[Zjj|{_w{O{ zێ`=#}nD6-XNWbܡ`?igK uԄVTd쑋۸O|g}{'^ZP2 ߿q֭z|˶ɖF 8 ,'uv^ж+~v#B l _ lK߹ ,,}2DQw.KDaK߹ ,*,GdtՌckM9j˩e]I ˉT`S87gt,gu%K1J]IYztav6.G<餸t\eaG|A WvR2вԏ -(%b(STohG+:u!suu:s9,C-+LXjY.<:FRAP◃p0GW(ip\T^f@ +0[xq$TvLͦ&E5Ee]yç87E/~J!qGXՐO+Ǘ~/9K"̲´'&Xe`( `;%0\sX" Xe`( ;]ЁʱD- ů*8:Qw.KDaK߹ ,,}rUB ]>meAk9%0aV6U,Zd<͠/%AS,/`9Dä?c_;Ҝˎ٤i9J۞i(/ws),CvKҎmt6gKɭ,IkQ-(i}߬eVO[ ?:%0j-?X=2%l-2"$ZTe!Tnb+{ww}EK5?lie~bs;*H 8yۍ.͗ZUjmL.͕8+,[ [?y)_5ĚXEW,&'敗ۺTA-g饋cwǮAQae]O?ilL#u⼗̛oI{˾Xr][z:ib <42 , X~[ڵ=qll^,my~zo5}H^޸ZM`prX8c7zf3+lceSI63;k&V{6˟%J-%+Lnb c)]X|>cc9zvu6K=lX]w9o|"eĕGUwfS|<.&3,:;E?H-\J? rskaIHYpĴ,SQw.KDaR[p{Θfij=IrX" oSyN$I%bKO`cyVsX" cF,r'p2AK?+ۅ30k"e`()+v'(ϫ9s"e`(ZK\Ii,E$`gO.# rZΝ@ L8]&ƶ`^K՝"hs 23j艵-N5<Qm <+^K;YF.acoy=AKdZeqbO,˺$7%~ "iw.ʭ,0G.׍Bt`ƛcT:Gҁ֩ uc9;w\ۦas,+0G.׍8mD l-{? ,}rXNʻ+H쌷|IoZOg.XeXNp'3\e1pDsX"Qw.KDaRwٕjQCje`( zXvL])Ļ`\¨g|! 7α=̐Uiݺ :Ђ,XN%˳D4ehZ^^n+4#ܣ ^/lc]}-Dze)7t foY,N!w1Tte7k9rlp'F3sGIWaY`dVܶқC?,h[*Ty,%]XUy,%]XUy,%]XUy,%]XUy,%]&t:>7 *UCXʋU4>it{UBT hAұ=yG%ԩ5[*TyHŝ@i-$/QMF* R*k{⸛e/Ns[cZE?Jڙ΁P`'pVVϬcc9zvu6Kk ݦ*>Z8$wi>Ny]>)<,]~@6rU?H1;?ԧ` -ֆÒב jTyH˶GUBXUy,%]XUy,%]XUy,%]XUyX3YM n`T 6gs'XiqrzX.Ù ƺ~7>vA;l0z_g,b46-3`H 6+r'{d#NΨ߉;$-ΞBu.Uf~ `"w2%J19́is*uF>Zh,۫`"wB,㦬ӱ8L8H)<ȝK2MD s{OM`"w<, K|I.=˧Eb)eoS . XMJRb;` lEȂe(ݡbi XBPʞ8shnbK$t)xOY|&RHWXBP=p"'` A,!% rDNHoOm%7| XBk׮Ç'KoKh>g?4 laj,!r fehMXB%LeMXB44 h*i06` k$6`/t Jb%2U T'<)+XB\KX ` 5xow\֤5J*?9+K{]m2o9*[ffi*%$#%,%$XB\K+MMGmq a#מ?Hm_qH6fTdb#ݭg,` )X;UN{rϹw^>S{Y#uVbD}(yy,i\9dYS]7=|o?sN ~3wB%qT8A6KPk[fc*ׂ쳌Yxx_-w?|o&qvN7IG H-X<5"0Gm*<2[lO,:KvzZW{m\re6_|QYc(0PH^|HM|[ӄ|"?&5nbS~Z˯ܼAqڲ,xo62 ~"Uj7bV3Mk-SҞXBuqۇ;?_z{rg||p\=:ZK)"lv26{KL>&֑XBuOO-\yGzێ`=Ic([0tK՜AdD*ahSd쑋۸O|gc/f{L&` {ݱ?튟~k1'2,!`I.%,%$XBrK$qx캗j- Ω^XByjK1MSo^:u#g/hp?bI;c9isyKK@a)xE-ygy,V\,cl4xh֚Xp:tR[5Y{[Iȕ2~9~GIe,3?KZ5Zݍr,~4ݔ&ӗ 2~` Q]>|Ҏ%o OwIL3R̬D+](Z,!"jwO"%$XB\KX ` M֭Q+JX.:h-E%,%$XB\KX ` 5kuӝxi6PX.&FE%'(˷,{df lMVeV Ӎ5mz6Yod+,VLy2sf׬Gl` Q!س%cXfkV,;FZ*gR*5>((٦ ӠKȗ )XZFm|RUN,2ZfKȗJKwgfHs4V,q8K}ܲ{i̹E|5lb%]hX ?gJ,ޠŖvQcR <'k.':o]>}<H$XB\KX ` Kr,!`I.%,%$jKm9c2^9,q) NߐQɘrӁ%dѼ3H*q'KՅ@>7 E,!Jηޝ:+B R}pf %dQ!"eEy39s[E,!Lr]cM܋XB5N?I~v v./` YԘ;Q]\XYɋXBa8$XB\KX ` Kr,!`I.%,%$jtviy<1 n¶*&.uEԗX0t` U!J;X੖@l%TVG^<{L`L,!@vXBe՘;(WkfpXRcY’DJ` UUR3ȷ,T I5N < IZvhq|`YS̀Tcwtu@l%TVN@-%,%$XB\KX ` Kr,!`I.%,v'{9 %C` 5N -VIpjCہ%԰;B6H]:ֹ'd:uv'PZK/6˺y<{ӠĒu'О-M_ t' VZmŒM` 5N %(lOXBmмϖhe6в[\x ,!ښ' w儕udgNOyCXBX[T?KZKj,!XXB\KX ` Kr,ɺut Jb%2U T%蠵%$ k>˟+//WE ` Mݐyl껨,m/dKX ` }+yv8*97} o&Pw?+W]e11|2[* X?d`)cc9zvu6Kk ݦ*>Z8$w2NJ,oeqL{SGT$wi IF(  bw%%~ Dza}`pX:Rb8a$XB\KX ` Kr,!`I.%,<`7φȞW.dۻ Ǹ`V)@۩KPX3fe1yLѳֺ0z>ǸJ>XBӺ彡ѫ OtsJ^} |9iK(Cc\`2J>jhAi2* r|c<1B%f-ifiePfcR-=K3i=C7(o\,B,N`ВVoN~kxR_&n(wVO ]S1%T( #kZwgtai`bi ԁPraYʝz9Xn,c.qo2v4zO ݴUՍ%Tr|ʸ.z a=(w^3%RMqdQ֔ɳ#P9`9`%,%$XB\KX ` Kr,GAr꾘#xKȢ|, (!sD r_^(K)1 |xo$oY4E,!\Xs'p-T.ـ,raIΝh>R$gt^ȅe &.TE,!\Xs'PVt>.q!"E9]> ĩÅeA^(p |yKȢ,;/` Y4XB\KX ` Kr,!`I.%,%$j;A<\ LG)VK}~l#*|, DYJw6d;,;pǬGS82xebРʅ%9whKg i@*+ GAZs/>C eA%TV.,W Ks, % $N < K6X⟘gYФ*ˇ;%]]>ebDИ*8wl%TV4e;,;j,!`I.%,%$XB\KX ` ̝"j;X:~ %2w}*ۓ9PraI՝@-4e}ɴկN`|3)"XBN`mQ)ů˝&,K%$XB\KhnXLU XB9K"d$Ѩtn-IENDB`java-design-patterns-1.16.0/private-class-data/etc/private-class-data.ucls000066400000000000000000000060321312550536300264440ustar00rootroot00000000000000 java-design-patterns-1.16.0/private-class-data/etc/private-class-data.urm.puml000066400000000000000000000016041312550536300272550ustar00rootroot00000000000000@startuml package com.iluwatar.privateclassdata { class App { + App() + main(args : String[]) {static} } class ImmutableStew { - LOGGER : Logger {static} - data : StewData + ImmutableStew(numPotatoes : int, numCarrots : int, numMeat : int, numPeppers : int) + mix() } class Stew { - LOGGER : Logger {static} - numCarrots : int - numMeat : int - numPeppers : int - numPotatoes : int + Stew(numPotatoes : int, numCarrots : int, numMeat : int, numPeppers : int) + mix() + taste() } class StewData { - numCarrots : int - numMeat : int - numPeppers : int - numPotatoes : int + StewData(numPotatoes : int, numCarrots : int, numMeat : int, numPeppers : int) + getNumCarrots() : int + getNumMeat() : int + getNumPeppers() : int + getNumPotatoes() : int } } ImmutableStew --> "-data" StewData @endumljava-design-patterns-1.16.0/private-class-data/pom.xml000066400000000000000000000036111312550536300226320ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 private-class-data junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/private-class-data/src/000077500000000000000000000000001312550536300221035ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/000077500000000000000000000000001312550536300230275ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/000077500000000000000000000000001312550536300237505ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/com/000077500000000000000000000000001312550536300245265ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300263565ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/com/iluwatar/privateclassdata/000077500000000000000000000000001312550536300317105ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java000066400000000000000000000047271312550536300333050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; /** * * The Private Class Data design pattern seeks to reduce exposure of attributes by limiting their * visibility. It reduces the number of class attributes by encapsulating them in single data * object. It allows the class designer to remove write privilege of attributes that are intended to * be set only during construction, even from methods of the target class. *

* In the example we have normal {@link Stew} class with some ingredients given in constructor. Then * we have methods to enumerate the ingredients and to taste the stew. The method for tasting the * stew alters the private members of the {@link Stew} class. * * The problem is solved with the Private Class Data pattern. We introduce {@link ImmutableStew} * class that contains {@link StewData}. The private data members of {@link Stew} are now in * {@link StewData} and cannot be altered by {@link ImmutableStew} methods. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // stew is mutable Stew stew = new Stew(1, 2, 3, 4); stew.mix(); stew.taste(); stew.mix(); // immutable stew protected with Private Class Data pattern ImmutableStew immutableStew = new ImmutableStew(2, 4, 3, 6); immutableStew.mix(); } } ImmutableStew.java000066400000000000000000000036171312550536300352650ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/com/iluwatar/privateclassdata/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Immutable stew class, protected with Private Class Data pattern * */ public class ImmutableStew { private static final Logger LOGGER = LoggerFactory.getLogger(ImmutableStew.class); private StewData data; public ImmutableStew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) { data = new StewData(numPotatoes, numCarrots, numMeat, numPeppers); } /** * Mix the stew */ public void mix() { LOGGER.info("Mixing the immutable stew we find: {} potatoes, {} carrots, {} meat and {} peppers", data.getNumPotatoes(), data.getNumCarrots(), data.getNumMeat(), data.getNumPeppers()); } } java-design-patterns-1.16.0/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java000066400000000000000000000044061312550536300335010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Mutable stew class * */ public class Stew { private static final Logger LOGGER = LoggerFactory.getLogger(Stew.class); private int numPotatoes; private int numCarrots; private int numMeat; private int numPeppers; /** * Constructor */ public Stew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) { this.numPotatoes = numPotatoes; this.numCarrots = numCarrots; this.numMeat = numMeat; this.numPeppers = numPeppers; } /** * Mix the stew */ public void mix() { LOGGER.info("Mixing the stew we find: {} potatoes, {} carrots, {} meat and {} peppers", numPotatoes, numCarrots, numMeat, numPeppers); } /** * Taste the stew */ public void taste() { LOGGER.info("Tasting the stew"); if (numPotatoes > 0) { numPotatoes--; } if (numCarrots > 0) { numCarrots--; } if (numMeat > 0) { numMeat--; } if (numPeppers > 0) { numPeppers--; } } } StewData.java000066400000000000000000000035431312550536300342150ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/main/java/com/iluwatar/privateclassdata/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; /** * * Stew ingredients * */ public class StewData { private int numPotatoes; private int numCarrots; private int numMeat; private int numPeppers; /** * Constructor */ public StewData(int numPotatoes, int numCarrots, int numMeat, int numPeppers) { this.numPotatoes = numPotatoes; this.numCarrots = numCarrots; this.numMeat = numMeat; this.numPeppers = numPeppers; } public int getNumPotatoes() { return numPotatoes; } public int getNumCarrots() { return numCarrots; } public int getNumMeat() { return numMeat; } public int getNumPeppers() { return numPeppers; } } java-design-patterns-1.16.0/private-class-data/src/test/000077500000000000000000000000001312550536300230625ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/000077500000000000000000000000001312550536300240035ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/000077500000000000000000000000001312550536300245615ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300264115ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/privateclassdata/000077500000000000000000000000001312550536300317435ustar00rootroot00000000000000AppTest.java000066400000000000000000000025051312550536300341110ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/privateclassdata/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } ImmutableStewTest.java000066400000000000000000000050621312550536300361540ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/privateclassdata/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; import com.iluwatar.privateclassdata.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/27/15 - 10:46 PM * * @author Jeroen Meulemeester */ public class ImmutableStewTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * Verify if mixing the stew doesn't change the internal state */ @Test public void testMix() { final Stew stew = new Stew(1, 2, 3, 4); final String expectedMessage = "Mixing the stew we find: 1 potatoes, 2 carrots, 3 meat and 4 peppers"; for (int i = 0; i < 20; i++) { stew.mix(); assertEquals(expectedMessage, appender.getLastMessage()); } assertEquals(20, appender.getLogSize()); } /** * Verify if tasting the stew actually removes one of each ingredient */ @Test public void testDrink() { final Stew stew = new Stew(1, 2, 3, 4); stew.mix(); assertEquals("Mixing the stew we find: 1 potatoes, 2 carrots, 3 meat and 4 peppers", appender.getLastMessage()); stew.taste(); assertEquals("Tasting the stew", appender.getLastMessage()); stew.mix(); assertEquals("Mixing the stew we find: 0 potatoes, 1 carrots, 2 meat and 3 peppers", appender.getLastMessage()); } } StewTest.java000066400000000000000000000041071312550536300343130ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/privateclassdata/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata; import com.iluwatar.privateclassdata.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/27/15 - 10:46 PM * * @author Jeroen Meulemeester */ public class StewTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * Verify if mixing the stew doesn't change the internal state */ @Test public void testMix() { final ImmutableStew stew = new ImmutableStew(1, 2, 3, 4); final String expectedMessage = "Mixing the immutable stew we find: 1 potatoes, " + "2 carrots, 3 meat and 4 peppers"; for (int i = 0; i < 20; i++) { stew.mix(); assertEquals(expectedMessage, appender.getLastMessage()); } assertEquals(20, appender.getLogSize()); } } java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/privateclassdata/utils/000077500000000000000000000000001312550536300331035ustar00rootroot00000000000000InMemoryAppender.java000066400000000000000000000036161312550536300371130ustar00rootroot00000000000000java-design-patterns-1.16.0/private-class-data/src/test/java/com/iluwatar/privateclassdata/utils/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.privateclassdata.utils; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; /** * InMemory Log Appender Util. */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } } java-design-patterns-1.16.0/producer-consumer/000077500000000000000000000000001312550536300213045ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/README.md000066400000000000000000000014421312550536300225640ustar00rootroot00000000000000--- layout: pattern title: Producer Consumer folder: producer-consumer permalink: /patterns/producer-consumer/ pumlid: PSjB3iCW303HgxG70Ezx6zTO2HKso9_a-c7VtUX9y-vA8nkdZTSPiVm3O7ZNeyUPttGscXgiKMaAz94t1XhyyCBIsFkXPM44cpe8-WvODbiIMzcdfspXe7-jQL9NodW0 categories: Concurrency tags: - Java - Difficulty-Intermediate - I/O - Reactive --- ## Intent Producer Consumer Design pattern is a classic concurrency pattern which reduces coupling between Producer and Consumer by separating Identification of work with Execution of Work. ![alt text](./etc/producer-consumer.png "Producer Consumer") ## Applicability Use the Producer Consumer idiom when * decouple system by separate work in two process produce and consume. * addresses the issue of different timing require to produce work or consuming work java-design-patterns-1.16.0/producer-consumer/etc/000077500000000000000000000000001312550536300220575ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/etc/producer-consumer.png000066400000000000000000000647621312550536300262600ustar00rootroot00000000000000PNG  IHDR\iIDATxXU ( @c%bÂQG#1ر%EQQAD"("?sƨ,XPINvfwuy3g̜YNyg9E3ޢh"(A€)򿞃:W~ N N Jeg'< 3yoOs{9wȚ5U# xŧGԫW*o@DH-޾ػwɓ#u- $ vbҤ ]x2O1xo@!غhe"''%4tk5o׮ŪT[l4ںdÆncBr߾GM?Er1o'$&*-GK^Bpx6eť*]J4xo@!xeނ:r?}T<Ǩy :ӧ7Svlo(45 x 950,/;w.(z7oy pa":ǏZ=yZLDq"CPh8o!zݻ)[eI4]]]TL"cd #Zy8;W yH&?{oXўש:::znZ(˄h2_jeeIi vЈیae'NOfBC(t t!#];hBt °L{R,1xNBF5wUiѢqKޞtӧ I) ?bkkEf(#$AjUa4-o@!غ 3ay[0QPzEPK))ػŋJ1%x `Bs3_׀ayh/L[@ZE-4cBgm ǰm `t#H*I |YSE\ÆnI;0 QY)?՗ A*"DF50Ilj K1ԐebނJI9?8vDٝD6[حMps陷Fޖ.rСTS?^I709 Q/& )ނNۋniwV<ݜQ<59RJ.Ewc԰*8NJyՈUE¯[UxWRF  y С- ]B!},Mr"vx ;[PjccEW^sjpY`do/AhZCb]QD Uq"&fk 'uLD6oތSʏq ͫF`.BBgg W|(޶mAt-..Umœ?iMy#EY;J-8m߾6ɷMyt+ilhЮ %oQryQdL[l2lSkNqreR~Sh^5b)~і {2LŮ^bO:8<<ʢn^.NrlǏ˽OٱcaNVV^NW(Lfԏ;&&&%[FŊ_]Lty 2.߻e8+0Qw"_o.{Ѡ+)o8o[Pq$oY8~|slQz~idoXP8J1NyՈVHPF[ 4hBT 6mlʗӧ5ڤcN4Z{_`BsdkԨܽ{ ^֊–%t虘 ͏[YorVE_ lA/XrŴk׈Ōۛf?'An6 DQi#Kr ڤBFv"K${{[*7ӧ)A.EcBc83h(+X,zw~ǼqF\+ ('a_K=NTKOa'[q7cr';D"^xvĀuD%c(x GNm"_Iٮ[~ZULik~];~~`BƢC, %3+Wqu+^4?F(41i-~і cϕ/=w[P7>b~bԨ&#ct'9h60YͰ<-aiӀ6و )L;D$"HB|:,Ll͏ƟqmIO?>$:HJWŁ ?hKxqO&Kn;i?ܧfeG{.tikkPvXG9=9KFt虪/4A1W3t(^۶ Z'YX7 cނ>b{l4̙-_%JX<fX`3st[@RU#8P?BgsPxCSOӤ; 6)1٧ߩǎAjrb_իW`T ˓-Lw$Uh^5S?\N=;l23k>O EbE4mZk1ܯIU S-s֩L1V}fvV5,OP=x HмjDG,1l3+kItc5m a]CAQw/Q#5B~X=x HмjDo@*y 6\'1Pt n4{+S ^\u+~H- BUB{f׭[#)iBŬRf |R,-,?;gvv֯^SPy_k$ *4[),|oѿrYfu f2c`FzQF^mYTW]P H -bb}QQsgAWAQUsyՈ*Nf!Tz'^[w"f2c ==)Iw'(:x H -^:F Loq={@}>> oj?)3*> OoV3#j >$JqfvjM^L8n-k-<ؓ>[OZ8v,;B| 2o{jAy۶ )ЩSG~ԬY8I0c4pesfKm]D{z}>u׮ŝ;B./޾0thWl\[?t|~)Kt@n4SLll0밅TPӎD= NT#T'[Sca6ғf`j0(Ds HмjDP ͫFt[q0(x Hмj_q0K0.uqvv^jU޽)ԩS={d,HMM_ Rok$JPXw$ m>-4¯8P%tW'&&^tA>^^= --E޻w&***++kSL)PJx@"yZz r,~u%5 0B~t/t#Ԯ[UV,LC17o<'˗/((Hj܂- =իW8|; ̙3c;ݮMk5gJfp0B~t/t#^GU" 'O ѣGY5kuE7oޔRz $Q:H _%P{A j}(e7 W 0Boal_NG(_~T>GBBBǎYYtsscvb...SNAnݺ.OrJET&D}O+}n:ap7gk}$Q[I-&??[מ.ͭx|e{{[j^ݶmêUv}ll26k9*LEF-PXq00)NG]Er.^KoooV>^ZT)*T "sssmmmO>Mᨨ(*o޼RiW8CoW ug'&D$LO`w6[+y^"t[n Q)I+V]-?>Dpv w)ԔyS*@;Y:zO(aJݻRR}j4z .%xŝ; {.5EB:ݪRBR<+|W!,f0i}Xo-8V2eL4☫X]Cx œ&-x H-s玿?a`,Bْ%K:FfCtuF"D0PqUE~n!|XUU P<$UyիW/^xYNNǏ/8q"###==ѣNNNNJJ:p@||}bccwܹcǎm۶EEEm޼922rk׮ [jշ~lٲŋ/X`޼ys̙9s3O>uTj&L0nܸ1cƌ9r_|ӿ}ݻGݻwҥKN:vخ]֭[lٲyM6mԨQ իWvmwwwWW5j899UVr+Vtpp>ҲDE~da!5‡U ]p 3{X쮰JuŊ:TVs *PK0uSL3uISWM6uyhт:r;t@];uSgO]>u +@lѣGQ 0qDd F KAƂC&d>V\IFHxx8Y2(dSȬe!BL Y24dk:tٝcǎ!D6Y"2Fd$U"DSVV)S="kE/:Jaw"$,v,\ҡND U=ݜԘCn-a`~ J0אRRr6n~lw/C'+Ne_Ls/H{NB(1bwʖIIY_wΕcnֻYY -8oo& )NDu˫e^^ P #GZlԻwGI~-YϠ[@l)9?.aӦ%6t;y2Ri9E,q_1Դ%'_n#G֭kOk֬NKhJ r=M[2.lbmۂBC'~I/߯Tҹs^~*/ҪUe˚PB-zb.Vyݽ{ rOo~ѣ{_/:'} /nA\ʟ"22[X;wd|rh&_ݤS%{J-p7)).ݭ[ nʕ+<$'&&vЁ]fgg*ĉcbbƏoC nL,LQ:IElb-+p'Nl@nkd dkX2f2,l*7ƍ3-dB?w+׉+KZP4e)}FNJf#?""?gϟӎ/_Tpx 0π[Y>D7=l w2gA+ڷjrI\<ӧ͸e%.]{ nWf' IwJ2ioI5Ga14& [j5dH1xY5`_x1cXݻwdf-00KKo\_uۛ6ͮU_Rx߾k;)4M.qi8QkĝC/[)-b1 [(ɤ~&UU+DOy&o&E*%3e)L8eՀݺu>>>,SdI[`(^a݉vT&\T\];xa+)qdJ4 66tRl[Nx0E>ƍv[)+&~&UUy]R^,MTJfr@SM uaj͛s\]]է/ +T;B>Q4krZhuϟj\tNwT.q2Dfѱ"{{[Kșt2TMMY19s7T[>`Dd}5MTJf@-kCm=w  ^V X_|G%''S`С3f`G>?  Pä1cz3KVT?`˝2v`*#ӓڷo 29˫%͸v-fݸG~AU&-~AhBbwBo!l7Ӧ [QFz)BNU#j*Nb?1eI[hC֫Wݻt%IS&7gl ?(Y-Dg͉.['[;eggM,qҒwWa91mBUb^# i"iR5a+:^¢U \mڵkq#jw%o' )"b?od, 8x-sis1]4gee/ZHvv2W%P =ݜԘBzBx ]MlDoAtcTqҒw+4QUq-0"f&EӰd ̟?VzuwR7oQdW.[޽DU9Ԥ>9gώP\<{eCL *AU&-~to *BoҧlKi3)J0Wqܜez:5j: мjDUmOH~+T'Pz.]ѱC9oyme˔)* tӧې VVժ}D;^Sϛ  ?ނHs玤HE74fINsqZR9*Ս='8zɟD?0pk5gJn C-{^R3#ͫFT~)A s)@J ^_ a֭NkOm[E͑ur?`ҲıcMHHND2GvZfGE/YCHȄ(}i򧨡JSu6o#E~S*9#*oWȩ8TWwZŎlG_LyYCPEy,'NNDw1Et"nAw/FS'zNi޽D/̝;2>~"Zܓ /nAZʟ"d22s;ʕ]S4q~!ҬYmNw_W!=%7#*oW☫P}t+)!RI]r\2Gloy\D~!oam]%S9tF?tjr 悿Y¦r?ڸq*o!g:sf|7n+EBzJ&qUR'4A1W3[S/@~ۮP1cDl"ݬYӽr0q⹗c075%.]{ nG8|"ϟQb^iӦ DO!=%K#GoIW☫Prfpy:T)KE+M1EtBJaR^^zB fZtkvb1cv^Ҥ;Bh܎gC~[h1E ٠%,@λwy$Rr{~Q )YX8#.4A1W3Bio8326{.:ch9c&RF4y 9`wS-7s J4,66tRgl"ނ\{.5Űd)?/FMrvԶmCrDO!=%;57#*BQ[[䣪K) ?B曡\$1E{Kٳ5UvY8X8Cj:ŋ[POgaGU=֭%z E7b=l|̡C:x񗮮ʗP˫%gKN#ނOPbGb30oƍCB&(TOǟOP2o +Wv)t1+π$J7ނWҡݩ"ѝSe&4[~FI\ZKohd6 CwرYzi ̓?*{,~$Q[p+MXٲ6ܨчXNkDQUqZw2gAxŊZyق[ЧuhԨ&Z fN'TY( x HtND[5qLU愫)g@Ƌn}P ѣ߷hQRr_~هXNQTU)rMkr׭oRyT$Ra {Ct<|L)Fπ$Jo~;^%,K2'B}-ux[.B^|yștՒn׵8g-ddFx|WBʒi)2 P-0%U`oq;-\:r?W].<ltղe}bc׵ìUMT( Bt;ёmyySN-jpx1debJqbOG6/,*X]/]2G0/]/"/^ĉuH|j̃ *~\Dމl۾}A#566V/}ϫ~vSP)#j<׭!m8XU0o!嵱o[N?|+U8 /]%]4g8ֵv@#΅ϐ3p;ёmw/;edmkM !rOe:8ls=B,bw%l\Ddݕ ֵSUp]; !g(p;ёml@2vv''{!:L5իuttnZ6-DBiT]Iu(*~xqrD}ÇIt?ɩRxx2πŀܲeBxA[,*\b];\+ϐ3O8NNtٱc7o2B)a=;RC3ulsBt`!Ty* !s89;Qo޳gk6kOY/CqvS||:ӎa[,l ͫF-pEdx'*?Ft zɜFbE*$1o(-c:\PKB$Q-nAy([@{oq>> Pgwȳg(kOk֬"r DWSXL鳬P$Jo~'#iӇ<|4fLof237XX;wd|rED׎]FVY\DSH#oQ6d)^L#oam]%]DNt8Qo!\L[fo!e;ފ.Őb]DNt8ѕau;x PR-,vG֊s^ b-jvb D];Nt;bzX4{ )ݱd?4{ȉ'ҝp1=no@ P:U{fBl9+)v@Ϡ< i,Un>T"rkljt'\L}h/|PRTqv ̝u]#dv: c2N/|PR } NK- uB_<o Xk@x RoZ T-R@K @ h)RH-@*)H h-޼ysf`["GiٲS޽=z$۷}g``-0Ibccԩj*)ԩS={d,HMM_ R %oAi*Utܹׯ_f5))NQ|J3ի.]jE׫W%HKKcݳ>|)S R %oAС _vLhn_zնme˖FǺuZj«VPp ͛7JY˗/E3o/`[`5D> c'OzG20k,kk,yQ)uOo0yOfidL/,e֭!99U-D}֭=曡l-DNLIժ11iTdalނCJ3CP!!('uLDbC1nތcյۥMyް!ӧ1oY%MpxBOOڄoS?~ņ}j|"8x<:5DƂy lv毿npdLx <´ʼn.߻]EVΝa>SU\ C6HZOG~Ry/CA@&- @kPy A@*x Y[-Tdoa@kPy A@*x Y[,ϣΜ9\dg'^=/^UZ,t-^:*[?cϞ?h oP*{7oݱcOeĉukѯ_Ե .niݺ5~:}ԪDZc/\8yݻL`y۶ )ЩSG~ԬYMΝ:ѪAW:&ERVuؼyLJ>ڻw)eͭڡC)K}쳦[{$$ৡMԡCcaBI/ݻyFnώ_')ې!]bB6nI1/Fk˫%%0j)@&<Ȃ-"#gEKb/8aB_ڼw/QB@ttP#G'=ݑhǴptp:w_~ٴsbEZ[?ڶ-l,5kVz\2"*ؿ}S +TǏdvXa|o,pV<;%_Θ1Nrr]0j)@&<Ȃ-Me\nsԨ{pӦ_KSR ޝglݻzoy*/鞞nߩOݵkqΟ~턡Cwvq(=_[YAכ74SLll0밅TP|ROv$GAFɩ>L7ͭkbPUK2A@|o:i@ ǞS`~>}zlYtX uxqosb>)ԩMd}m6 ޼9޼yғ')ԃZϜ~…m'( QIpޢSfC}QY꼹4X?=?fRK[7=Q ͞(Ay?m.X0>fCW-%?YGΝ?@׈^ԟyxPWû{cE%oAR.={:+{#nmO{zp"--Eztk>rd2^I…cq(wFut߰۾}KC[ ԫ"TL*} _ۻg  {ťK15832XE Vx t*N:`M]Deg'kLC7O(P'*XL|ha.P4Ji.PN_ߛy|Wo֠ S;kǎwZ,L[@o֠ x sZ,-Uh *0W[5<Ȣh",  *(f"xn x sZ,-Uh *0W[5<Ȣxdlf,x Y[7lϒRRr6n~l3gīW)e[5A@f-=-kFʕrokR⬬:Z,x4lX72={{E=E1]~ZfgώnK{^oN`;޽n}8uj}?݆Ez*>w޿PxFJO$eiYرbғo~ܪ9Ν?a6thW?.Eq9*UBB&t*-'ݧOaҘ19`aQlܑ˯]Y7nđ lF ^]=!K`"==^a4hJ"EF| ˫eh{mlfe>)H+V] /nAg_?ǏQݹw"tiŊ7oh8[P$|bt&NN n - ?z%g?yB˗wRe%YoԢE=twiӀE]P-vXXn I̙-ourrRHt@wwG-3҉ @Rމw{2eJԵu8S ,ljNXƍ3-0WPyFoq#`%Å۴t)5IG Lْ?6mX/G~ϼEP#g5˗|@ŊnތQ(O6YZ|;[p:<Gx Td[p)Eu~}ETkvb ,ӥKs_hի1 [3oA{q}]XfZ˖Y &g=9 ݺ]&B޽Iw~ mqނ۝-8y .QQs-0WPyWz ڝufo:]5%.y¶o3({q\K1ԯ՚yWw*eyfq_4E^Mϝ; ӧ7޽^"(yÇcc<.AA)@ɠ.]$Ҳĝ; ҽÇIt57nĵksYoQ=uU:o}Jނ2ʲZ(;YdXrlTq837^;:V1c(%4t2]4g`͚iC?NxF2|Sǹxq 2t|{T"n/["#gzGe3a[5<BDz5ҙ-t6dɬϏyGv-699wXضmC5@kPyNE!U:̛7*$ds%WZ,xڵ>uvs¦^Q/x Y -Tdoa@kPy A@*x Y[-Tdoa@kPyobWZZ87զ|͙3B8w-Td![گ[-f^<o֠ 9…mܺw/[cE[hQ0?o˹sQٯ_{ʌ[5ܐ@kPyNމ\\9={B4ԯy+\%LddbE8[PLJ(3o'{i o֠ 9r^!<<-_Tx eʔfkqVF*-ṇdW6mX/[p:-t+x Yh\J5b)[KHh *vJ5ܹ(;;Kb՚[,-Kܹ`^<o֠ M-WζJ?㼅CPazUޢKŋ[&!x Yp^ׯӟDǹ};66VQQs}ʔAL@ѢE= :8!p_L Lb1ŋ[xz6[ʟҳH-,͝;2>~9^_XyFIǍ޽E^|y4qwrĿ.r{.6۷onpo@@jEb?1_T-*y)S3W@o Ub^# i"{ rҭ[eRq#Κ޽Iwik; w|DGjp_%o1hP  Td[T[>`Dd}5M,qNBnnӛY^O([޽DE{Ph ЎKz ;toa*%e yvqނbN{zYb 4?)[tҼxq Y3ں$.ǏSEE۶ SSײH%u8ӡwwt~)2r&jUѣ{q/>:Z套)Sٳ#  Tdf,g _u[?ࠄMys=l(r Ct榲߯_]MNc;}aKRNm[RLEh *PIߠRei?ϟV0oި Ε㗳  tV_?2o1kuɊ9ݼ'Ӧ پ뙷HO`^Ӕ)z nP'6::Y-vvSnݪna6kI#uKNNU@PBtvw a/@bKk!1tRWR -tp _Rdf&dSi߻V֦'$9;]"#nx彽&Gݵ8VUe[^|i[ L$1̵+:76ːL6-*hX^RFZ_jqP"G{ @߃_޽kpIMݢVor;y\pp@kk9KU"` ^YPWIů!fɔ٩,A<Ig!F%I-&j- &[LԀ[ L$@4<Hn1Qnh0y܂ߟ|uMOq̇:[ L$b?pjB͞_ԙ3wbȓ`\$ŖBcҫzZ$$k#ZT?BL&9MZalmmh݂Bjoo7kI,]; 5$ggKdMh1ڵE4oo!Yx彽&Gݵ8GHM|}H&;v?*?BI[0~@\˹˫sc JhӢBKKYM%%i<=[ԅV-[wtL׫3xDGHs1[XE0' n8I j|TJz|nQzy9;ZN%mmQG- &Y{51a6kMNNgƃ9ip D$𬲉p D$5I-&j- &[LԀ[ L$@4<HbҤ߁ ˎ.V0y0-0-0h컸dIENDB`java-design-patterns-1.16.0/producer-consumer/etc/producer-consumer.ucls000066400000000000000000000106711312550536300264300ustar00rootroot00000000000000 java-design-patterns-1.16.0/producer-consumer/etc/producer-consumer.urm.puml000066400000000000000000000015011312550536300272310ustar00rootroot00000000000000@startuml package com.iluwatar.producer.consumer { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Consumer { - LOGGER : Logger {static} - name : String - queue : ItemQueue + Consumer(name : String, queue : ItemQueue) + consume() } class Item { - id : int - producer : String + Item(producer : String, id : int) + getId() : int + getProducer() : String } class ItemQueue { - queue : BlockingQueue + ItemQueue() + put(item : Item) + take() : Item } class Producer { - itemId : int - name : String - queue : ItemQueue + Producer(name : String, queue : ItemQueue) + produce() } } Consumer --> "-queue" ItemQueue Producer --> "-queue" ItemQueue ItemQueue --> "-queue" Item @endumljava-design-patterns-1.16.0/producer-consumer/pom.xml000066400000000000000000000036101312550536300226210ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 producer-consumer junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/producer-consumer/src/000077500000000000000000000000001312550536300220735ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/000077500000000000000000000000001312550536300230175ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/000077500000000000000000000000001312550536300237405ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/000077500000000000000000000000001312550536300245165ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300263465ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/000077500000000000000000000000001312550536300301715ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/consumer/000077500000000000000000000000001312550536300320245ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java000066400000000000000000000056451312550536300334210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * Producer Consumer Design pattern is a classic concurrency or threading pattern which reduces coupling between * Producer and Consumer by separating Identification of work with Execution of Work. *

* In producer consumer design pattern a shared queue is used to control the flow and this separation allows you to code * producer and consumer separately. It also addresses the issue of different timing require to produce item or * consuming item. by using producer consumer pattern both Producer and Consumer Thread can work with different speed. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { ItemQueue queue = new ItemQueue(); ExecutorService executorService = Executors.newFixedThreadPool(5); for (int i = 0; i < 2; i++) { final Producer producer = new Producer("Producer_" + i, queue); executorService.submit(() -> { while (true) { producer.produce(); } }); } for (int i = 0; i < 3; i++) { final Consumer consumer = new Consumer("Consumer_" + i, queue); executorService.submit(() -> { while (true) { consumer.consume(); } }); } executorService.shutdown(); try { executorService.awaitTermination(10, TimeUnit.SECONDS); executorService.shutdownNow(); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown"); } } } Consumer.java000066400000000000000000000034701312550536300344070ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/consumer/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Class responsible for consume the {@link Item} produced by {@link Producer} */ public class Consumer { private static final Logger LOGGER = LoggerFactory.getLogger(Consumer.class); private final ItemQueue queue; private final String name; public Consumer(String name, ItemQueue queue) { this.name = name; this.queue = queue; } /** * Consume item from the queue */ public void consume() throws InterruptedException { Item item = queue.take(); LOGGER.info("Consumer [{}] consume item [{}] produced by [{}]", name, item.getId(), item.getProducer()); } } java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java000066400000000000000000000027721312550536300335750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; /** * Class take part of an {@link Producer}-{@link Consumer} exchange. */ public class Item { private String producer; private int id; public Item(String producer, int id) { this.id = id; this.producer = producer; } public int getId() { return id; } public String getProducer() { return producer; } } ItemQueue.java000066400000000000000000000031761312550536300345220ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/consumer/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import java.util.concurrent.BlockingQueue; import java.util.concurrent.LinkedBlockingQueue; /** * Class as a channel for {@link Producer}-{@link Consumer} exchange. */ public class ItemQueue { private BlockingQueue queue; public ItemQueue() { queue = new LinkedBlockingQueue<>(5); } public void put(Item item) throws InterruptedException { queue.put(item); } public Item take() throws InterruptedException { return queue.take(); } } Producer.java000066400000000000000000000033661312550536300344030ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/main/java/com/iluwatar/producer/consumer/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import java.util.Random; /** * Class responsible for producing unit of work that can be expressed as {@link Item} and submitted * to queue */ public class Producer { private final ItemQueue queue; private final String name; private int itemId; public Producer(String name, ItemQueue queue) { this.name = name; this.queue = queue; } /** * Put item in the queue */ public void produce() throws InterruptedException { Item item = new Item(name, itemId++); queue.put(item); Random random = new Random(); Thread.sleep(random.nextInt(2000)); } } java-design-patterns-1.16.0/producer-consumer/src/test/000077500000000000000000000000001312550536300230525ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/000077500000000000000000000000001312550536300237735ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/000077500000000000000000000000001312550536300245515ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300264015ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/iluwatar/producer/000077500000000000000000000000001312550536300302245ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/iluwatar/producer/consumer/000077500000000000000000000000001312550536300320575ustar00rootroot00000000000000AppTest.java000066400000000000000000000025301312550536300342230ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/iluwatar/producer/consumer/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } ConsumerTest.java000066400000000000000000000035221312550536300353000ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/iluwatar/producer/consumer/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import org.junit.Test; import static org.mockito.Mockito.*; /** * Date: 12/27/15 - 11:01 PM * * @author Jeroen Meulemeester */ public class ConsumerTest { private static final int ITEM_COUNT = 5; @Test public void testConsume() throws Exception { final ItemQueue queue = spy(new ItemQueue()); for (int id = 0; id < ITEM_COUNT; id++) { queue.put(new Item("producer", id)); } reset(queue); // Don't count the preparation above as interactions with the queue final Consumer consumer = new Consumer("consumer", queue); for (int id = 0; id < ITEM_COUNT; id++) { consumer.consume(); } verify(queue, times(ITEM_COUNT)).take(); } } ProducerTest.java000066400000000000000000000033731312550536300352740ustar00rootroot00000000000000java-design-patterns-1.16.0/producer-consumer/src/test/java/com/iluwatar/producer/consumer/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.producer.consumer; import org.junit.Test; import static org.mockito.Matchers.any; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/28/15 - 12:12 AM * * @author Jeroen Meulemeester */ public class ProducerTest { @Test(timeout = 6000) public void testProduce() throws Exception { final ItemQueue queue = mock(ItemQueue.class); final Producer producer = new Producer("producer", queue); producer.produce(); verify(queue).put(any(Item.class)); verifyNoMoreInteractions(queue); } }java-design-patterns-1.16.0/promise/000077500000000000000000000000001312550536300173065ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/README.md000066400000000000000000000031001312550536300205570ustar00rootroot00000000000000--- layout: pattern title: Promise folder: promise permalink: /patterns/promise/ pumlid: DOqv4i8m301xNW4FYDLJvIl2rYHYBDcZWtmVKr3jDZkxUw15IhyzM6lFHcdzVaPCVm8ONkNWEFELJbQ71ccKEWIuvuKhXJT-S6laVEWsCO9C7GHz2KmRmav0KVzUqgJCtsydROjV categories: Concurrency tags: - Java - Functional - Reactive - Difficulty-Intermediate --- ## Also known as CompletableFuture ## Intent A Promise represents a proxy for a value not necessarily known when the promise is created. It allows you to associate dependent promises to an asynchronous action's eventual success value or failure reason. Promises are a way to write async code that still appears as though it is executing in a synchronous way. ![alt text](./etc/promise.png "Promise") ## Applicability Promise pattern is applicable in concurrent programming when some work needs to be done asynchronously and: * code maintainablity and readability suffers due to callback hell. * you need to compose promises and need better error handling for asynchronous tasks. * you want to use functional style of programming. ## Real world examples * [java.util.concurrent.CompletableFuture](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html) * [Guava ListenableFuture](https://github.com/google/guava/wiki/ListenableFutureExplained) ## Related Patterns * Async Method Invocation * Callback ## Credits * [You are missing the point to Promises](https://gist.github.com/domenic/3889970) * [Functional style callbacks using CompleteableFuture](https://www.infoq.com/articles/Functional-Style-Callbacks-Using-CompletableFuture) java-design-patterns-1.16.0/promise/etc/000077500000000000000000000000001312550536300200615ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/etc/promise.png000066400000000000000000001635121312550536300222550ustar00rootroot00000000000000PNG  IHDR|ndQIDATx Xe->+KS>L\24bP9Ȧ"  " n (.⾁* ZW_,Kq?| 빸ywރr|9g޼ =7lQãXXiP:tYQSt%nagkk2j9رvBwڼjf&&:YY1nn-Z4:4(frj'?ɓffz..Cg 4HPW(?M"߹sǥ 32I>H}m?d7^O'A^:XֱcJwm)/ c>:nocȑUYS;wU=;!ڹbƓR石ha4GGKт2N(E+NA\t8XYlժ+{s]üygwP(%]I'&)tt/Æ `9KPh/n_pn,qd,!R>B|,33,sX'*\޽Ԉ tMI tvy2)kkwz5Oay5ʜΒN:#"{JOR3'{ 5J~ c??>}>YbH' "uHDf(qtLNM#$7-XP}1=??ehbɓGm^(|D\ÇGMHʫP:RPT"' <`q6l3U@:hIC2sv޽ 9\EN]SFP_~mڴIFF0vxt޹s[;9q/rP??'Aҩp/.a>dgʏս$QR>NDJTt PHR>@:U% "ҩ*@$NU H'"|R?l_ݳ&6eW:R>Գt_"＄#,M nu"H'"|O$4z!7gn jSʆ-(Xw|ffzM6y-޽{Ef5!3(ECIo_5~;ebZ#-3XZld^^k3'O^$32WKsر#쉣lx!H' JPoҹ2tمkd{?Vxe(NHKg@+(IFHgQ;8سkWMv*ظNeP#(hfxZӻw-iwmլYӴq7'Lek'Ov~۷n]un3f8~VH'JPo=iLLlϱE;)tN:…,WU'N%ev /Fxz̦Mښg4u>~| 5[mCC'YiXZkӧG;vl};u m"藖B:PPzN-Y2tZ ̍߰E;ۤoNi:`v` Wסl_ZOsx 2H;~i(LJJJ Kywm`;|3n]l;N`{tL:?NLȑ%%)/#!!l䠠جY͛5mڄ'O3lE<~%kԇS7~?UhC.]@}@)M:NLa}l[CmPxܒ+iLcIKL:٧9)RRiq ʳ{w;;M4vtԛt7 Jx@zNJ2ܲi2ɃcN7xC_㒒dҥ=-Z4p*WסyG֭ 22^+H~I^=eBB< ׮]xA:(EC}>3}.C7N]txsVZT(11·jE-I͚5eOД #%ݵe::Xpoƍ͛7kҤˬt PzF"2KWۍs<~{(#m@$|ǼrL?W-)w& "/ "ҩ*@$NU H'"|tJ@: (ESU H@) NDJZ377~ֈ1fz`}R>ʙΟ~%E[:>-irb/ "J'aB7us2|9_O^ͣ+W|Lܶi[jߟ:TWGQQ2SF:++ )o߸Q8fŔ)#hےh`!JKSe::!qq5=4nGeF&@M@)A:ϝQXXdNN䗒HOf2ɉg'Jgtz;|VK$NN6L6 5{x2;䗴5hҥ8|xhѸA:PPz˗s&Mq2"SaPsQKER$jԚ&.^<W*5I'kx{60vx)SFȌ@@)A:gn' M ;ylNm,22ۭZ@.?gʤ3.·%ʊ9}zC|c՗e4Q̎\vV}f͢KȌM R>ԃtěN6ROǕ+{7m k{SU΀R# V9;gΙ1YQuqp(1c,޹s֭YMd?b]2(YfGI99Y2ѣeF&@M@)^tY )uۘR>>@:U% "ҩ*@$,jPF8ө"@$NU H'"|tJ@: (ESU H@) NDJTt PIcZR㯿J s6.o;nW2L 8A)D+Sccgb{]]+tA)j9YF fr20ihgOÇGǏ042ҎyyÇzxښei&p;mҿ58K{cvwb++#{ZU=9K$ffzAA?3Ɍ_IFEMG7~Si@:!(EC iٹg֬*M-t͍'C?g0]ȌJC ځ<(}Ef2qh66}Y,ԩ SS]da۶o,"0ೂ1-:~||#?~m&I aР>Ԡ1ϟ%4 "AtwGyXE41:ڋ[|X@ ;تU+WHQ%9))ݧ`DOy}JB`AZl~ny?|x:]Gu 6wVL6! qW_Sqǯ$yy5 H'"|P&f&DFRl%e؊=Ⱥçxy677P(Rқ0 E??'5FNڳrsoCaΝB:pw^~-'1uUR7 2 H'"|F"4VE -*:"*jZLLJzҺ~ {WNDJP#ff/aLF=;p;-[Lt P=, "ҩ*@$NU H'"|tJ@: (ESU H@) NDJTt PHR>t%Od/,twҴ4,s'2|9ظKHz*ݍ:χocaahdCM= ;~{ m۶y2|VP6EPhD>lyNT"AtwGyXEڭ[GOOݻ<~\f;=:N+jʕ$dfk5]41:ڋۄ\VKKLBG[z"i_xtIX''kn@id^\v:3!7,lrdTw^_>lyNT"At6Vq0(EJKgճչ55={vfשY:޽))6rLȨ?'d%%)WÃ=~ʯEY]K>ܔΤ$?R),甜<[>lyNT"Atvs;+{C?i m[SxFaNann̮)޽kWMZEB`AU-_[^ J$$mׯߧ.ãL(/]#-ki&5_^ }ј4i:ktʤ33lՄИPjtt~uHM$u렇]vu֑L}zbn)^^IL Y@q>}>Ύe2G&&:~~N}27ɬ%1BBpr0,-M}ȤK#!u >>[ >@$LU H'"|tJ@: (ESU H@) NDJTt PHR>@:U% "ҩ*@$/#EEɓ&$/\jڴI^ZGG{=~\2=wa2koS t?^NΝ5X[[̀Sccg0rZ (EC9g"Lj(S˗s ,- {޽DZ:)~m߻ﶺHhs>H&b^^v&F?}ZFɅ -, ס->yRֱc;wq54`o9XY402H>I><:~ e|M :R> v'l{fͪDjТBLJcvZA2Iѫژ5,#|w[ϸqVl+G:u*T45hw9m" YARgwGSC $!9(E2霵/q籊))/[w/yT^:?Pmaa##esY$ZZffz::eg:9YsC]{N2smLHߑ|\~w paN[jI$5|P&CE;#hYbwnn9))/۶E:A7nv^Z:^͓HQgKKCǏKj<\_Rtҥ=5\^'ejh{Cffz4fh `AGZlNtd@)Igf٪ y1y0[FIy\M¸G&}q.]:DEMn;ׅ E }ظ&DO(77n6vl_2;phevWQSW*hssH'@",ҼNZY7(lTr}R>ȤK#!lqqܲ%\p* "_*@$NU H'"|tJ@: (ESU H@) NDJTt PHR>@:U% "s۶<{̻͛d'q?5<)DNDJ𺥳P"g툈3٧vk {wq-.\`'t PsD5Ԑ_K8vQii*E uAޞ1ɓݹsШiԸHoR͢v޻{ӧeZZ;W=R> v'l{fͪDjТL;7ƅ Y-Z4++KK7Ί{Ȫ 33=ZyR֩S{/^%u#4 .yb H'"|F"4VE -tz5oj }DKK?k֦i11ެ^ZׯT( "G&^D 䎎FF+V}6qqܲ%\pSt P| R>@:U% "ҩ*@$NU H'"|tJ@: (ESUҩ4I!FN 1kPb "8"JX xkx @#my&pٗL8;|q?hٲ95(JJR'M8~Ϻs.@aOnp|}m&D'??[4'OƱjC @yGBD#"Π+N$ffz/3BSCkkwv@zmj|!… 7c-Ն A*RqD5Ԑ_KEhjdmeeTZZL,, ס-R{{ 'O:vlwΡ*)3s8Ơ8|ɨQO)܅tH'6lq`O_qH>23T&asFGEMG7~7okݻ/6Ҭ`[:?KCrw?ZKK3g6UC!?PEj8"m}v5JA2v"-ƅ Y-Z4++K#Q7Ί{Ȫ &Ne;Ǔ|5,#1}w[w!3It~G/vѪ޽ 3T&ast:)!1A:WT/榱`18Er<'%G%^Eѱ++#{ZQgvr޼ :k,o[ui{_EnsO#O U,g#gf٪ y1y0[FI>w:ĉ2q/2??'R;wшUOu^Fs]$z.'=J )s!C.}MtrٍDOEEN$%33,NX0Cew05bb]SRm؟t)kkwz5Oaߧ=;K?С48W!ZV&2T_}|l 3[TiCS',L Z@۫5--?̯h5u:(܅W(sԫgwb8D?%77[Gerlʌ!ٸ144t{>W~~R˖9Y';+ߙ9{]5o(d)mәԇ3)aC1''y*|F A*Rqf$j(.:iSX1G ?(Eff+W:AG-[mwb8G&1ɜ;gm>pB֭ SnJzj6?O:sf7[yqq^$ I`̌ٞ9%f#-Μ9HyfÇ޽{Ha @ zvXPMKukK_md36NɘNN}7U}_n6wm4Ԏ0 ^n… HHH z:TSifdpLgO'tY}ВC"7zA.9R]ag~=ڏ_- &!Ԉtfم At,\L{;PdQ3.mM83.2bWؙ_Nb:thg&!2NNnS7/3F;MyM#^[QT}.iGp41ɉʊiҤ1rdJ5kjee0 .<뛐 |ns^>/3՟zeR~9ښ+V̥T'' B||i1 ej^6i[)?~Myyҥ۶E;0P99LLK:(iFR ZΖM22rjRӧe" M>k4*3@lP:OUP[$Oo31![x:-{fePcX˳gF:w"sv!#1ׯ|9g${RC++#ڄN<7*j^Hqj^:ZΖM֭ffz3f8Wkk lɉLJ3@lP:|gS, 3/CǎtfdΫVtb::Z=ztn={<'(hbLwnn9r{!%ɓ4&e Ć2l28(,`QANH9$MLI tvaYCZ:PZ:?.q{tr*}(==]Yj hs# g:A$==RYP% xdeen)*.g:ACt\Y@Átb'N8 nz@NL'h8$$$ࣜ2PJPc $rPPU$ Feee֭iN1:TtK:Tt 6PP N!==]WWWY: *鴶6/9Nee3(رFTx5 u޽Ç!;T7$ѣcɉС͛E 5 uޤy&ܰ!DY·ocaahdCyvTӵfEN\UfUtʏLk ,- {޽Dft33=!3Nppp*j@=H?n'ϓHw\qŒt"9F,Yp;ez}:O8\~L:7LJc#_V~}"'Ke %!G9U $ԁzNA\t>zt, ~`V-\Ky&$'ϖf;e)o֭KȀeo,q5!@@M@|,33,ĉ 3.w05bb]SRm>-L)kkwz5OaǏٳ3:gҩpQwd2۷f epႃгu5 u>o$*/psq8:Z&'Ϧ̈CCC'-XP};??ehbɓGm077w~ڻw/UƍB&n>I}:uj/aC1''y*| ^D"I$2sv޽ÇG+*v4 5$KnӦM22nkn:ښ?u vs:>ܴ)LfQl7lTVV =$Q=QC@:$x$ꂚ:Tt6<.\кuk)DOPP  Ns4INU Hg#==])5 uҩ*lHI $H!Q\\;I5Ke.kg.u04ѕڔ\3 rf5 u YJ9ù@6lnӜ $eIfbhG_ \Wm@iFiҤ'|qc2gѰSUQQοZjihXojXPt/U t $框jB>ۊ"T[.R3~+AR\\ܺukg^1I :u ׵?bf))RܩB"ɣy&?Q}cb)yjogOC֯b}t鐛71BӲesD_Z:OKDԲ1#lڴIyy^A3%Y=q7o)N֠Iҫ Xas-i|h 54to~21 Z6YS 'ot60jB4 N8X}:>]hIA !FCFJ+ԩ#/\" #kE23nCYիΝ_%oƦ/CGI;j}RTn+-ȑ۷٘ OsYۑ͛7͚5=:Vt <~\Jjnn0YHEvyedӮe~ɂzn,pt6pz5 u@ٙN$XU?Wb3rb;sƥͰI'sSɓ8 dݨA9NiW˖swښiy&[H62AAVRi&Ԗ,G F34tۤC}]asQZ:oEB׽4 6ҥnj&(Ή\Ӧ߼pk/O|޸%mn[CjٱgleZ|Zܱ#`͆ W'|ãǏ6l%\ٛ.sS7wK0f;V}4>~&%X&-̒<(!2R|eIƎglR(;֒z9UTt(';*I^6w2C] K2w_,?V}=??|VmY{ܰ!DƍKPn#\]ԇ7ٳ|?Œ߸4IKg۶w\LGmDa '}]P u낌.tW 44^v{&q:P:)B$,bۺi DDOjM4 5_,N4Mhj~@)ӧf$:u$`žacۗлwז-t#dI>}>y3ׯb5v숢a-`{y66Enj GT|YLdOBlf'+>*5S裏pa:L:w~z ՞)ڔ6NUDN7$$DY j@ Y:U%1:wC:AM@Y:|@:+'== Ij.*N}ρWPP NU߱>&@:U% '$$INU H!z^AM@tJ@:EN3WPPD%[F/!djd)Z.\P\\,,&J:YΟ~%H\<}ZFk^+tJ]]]<#I=AM@xYYYho?pH }ƍ1c,L1|wm gΙ󹭭ɓ'=̈́_&MڧNeo>ml_?@#SWס=e#$..C^֬Y`J{?qb-eܽ{h8ɓFfC:Պt5 uJgtbճDb\Z,-Murް!Ǒ\V ŋk#۔g,]m[s; LNti{6m$5N@ȭl$##&%=}Zv.2NД+FC:\UWsPP^tN>`)HD~gbCxtZ ʊرgntElCFH1c,_?prΤIVVF '2yoT4齐Sռu-[]fpo1&ؒO2ҩnOTgPP^t$'ϦYg._>KuuZ'fW $tt${蘓Z5{xvOOPĘ9s>sBJJ'iLnm-g&y۷9ULZZ)ޛ7.]T$ԁW+7ne>f;wݺup8+2#$Rq;-, eJL6ω֚sCg_OI@fף4gΙ12y`گ^lmM||%Zͪeܻ!CtҫmIiGt6xt$P:!»_wL)|}}$HS7^y QM D jjT%PՁ2 7? ѱƍTv۶ biiطoo! ,pTSC^Ǣvٜ@Η{>Ll'~͛?}Zv~uo J<9A @:9M00aCLs|6FFqq>nNe>]jVT'yyÇzxښeN69v{=c#]Н6_NVVm͆/? Yh2{ɏsdn u~S@y'!!!BH'nΝ?.UI'hJJ -ihȒ%z=|nN:XֱcJwm)/ zY66}YE55?sPճ;kT=bƓR石ha4GGKт2j8!O$ H' 4ŋkH"$q p2تU+WR޽Ry&$'ϖ -%]I'&)tt/Æ `9KPh/n_pn,qd,noz(\)'<)̌!;ĉ 3.w05bb]SRm>- s~>]^S؁teΒz%%)tFDL tgN::)*j8~~N}|l 38!q%Η r>77[Gerlʌ!ٸ1nI-[6gDgM0xp?j+曍&&:xr}>iˏaC0''*|FmG55DT(P@yyG}Ӝ@:_AYdΝa`г{N6p;uu{XZOmnn@~%i&V؁E yΡn:kƽAHJ½І}|+?W'\$"7ǎ_ m\8ԌYکS,Om[߼YD6`gKi+kkcZ$36u G~L4 A}}󻄚ʳ C@:Mo־x-;S*Zt'?Lh/|X''kև2܃Ƒ6w$bʳk@:MqఢGq-RRa& jP:7em$?r),甜<[>Ƒ6R"? g=? QM Q)cbEJJyB#E5Sxy]Cݻ՟43ӣM(ciiH<~\jdWfhk3ɪ^^gO|d(ͅ |}}4u ~**2-u MghM33lՄИPjtL7'?LHP3FNڳrsoCaΝB:pw^~-'1uUR7 2 k9Y~WE;/! jS QoRÛEI+S1*jZLLJzҺ~%)(W {г j+?/YN>Af9i/BoJ)Ԧ e޽_Ν55kJ?g{A_B]kWM_~.Ą Ԑff/aLF=5rBqܲ%\z POyJt9Ο~Kig2i-ښoظoacWW,س{Pjഴ3Ș鵘PbŊ))슞zjjh<*YX]{BI_ñ‹,C旟pu+4d.<|ʈBj8OO5kڡC[rONʠ11obpS1%K;whѢAOdԓgnvp'<2r*9.m蚝Ѧcv23czJC){*(h&w')hzd,3 -[DkόU5|S@y*|}}Ӆ>`mm_flmiI߾!uiN;gd`آԇu^v!6mVbW~>~}5:ujOj8}(j^=jՋZV6xp?*%6ҥCnnn7x7++e>$lڴIyy^v)۪}Ivɒ]! o9H' igਦᛞp…>ɠ}޽Ç!;Igee!;Oݺu~_[sJt9<|>dN6k)!s7l6Yh/&ˏC6Iv\\XoƦ/ǩSGRj8QcHI^^lsJmOja OsJVC4;+##e,/,ƍۊ=D}G55D T4P <tȞ7oA BeK׺RSs)x)cFR$t) ](A Sh4PB%ra}3;^#2՚}:T>ߧg{^k}kXX]KNLc8hl֬# ttp虙+7jd_ YU?/ut?˭0FII$|eM{w7T tw=ܱ#HHN" *`v{`q/: a\͚5bÆld ֯e 12j0.r`uKNq#W+NЦo`u鷩U3@`YC5bs~?M$NOb1t u]j&>&Ap&🬂Gy"ٛMeX;JpII3``]e1 K"A+;9\ШlNbWyNݻ[*1%&& `9N$NQw[uޱ`n[1’HǻߓX8{Ggcn8Ku_H۩ƍW! ]C<^[fj PY颩x"S`>=8G㜘81^^;#Ӻ"v)S<GXaf%;zbQ8BywSS%aNNCUX$the bxIoSfIwXbP0mĉV;9;rZjn6$7mLnwGިή*OPYY Sj)X'K^i66];wn Nd7n5HIYJ:ey*NGQ>_WHЩ/_ٙ=vU%4Z5T]TzZI$+Ü6mZqCjh3:zճdii ;T-T>>>$*jʊXLXa˜2PHSm*s"Q$tɪZ5Te^}ШcQǣrQ4){aFx(O>ڵk{ĉMf"nMS׽9r@t&$1/BC} c*@u~#O5Lӹ%V :dMJICdϫp8bi{۷wnavpr cVYXap4!U9{cqvEϋ,/\خ0FaxA"H"h:$J"A'U3@UVfp$͍1bq`S=7?gРsS^LeoY*// t.tLՁ 7CLB0!s^޻7.).e0?|xΒ%4(SfRR N%hӱC/Qrؗ9vΝϒjYgCJٱXs̼x)fx DNm?fy{;`OʦVқ ƯO grGeSR&&&ĝ*Hy= zGJ3v}Ō0bGNΛ߾Ξ=홛APT V9Ўp?|xQ#c6Ӧj%N 4sȑb!C_ϱqVn4frnٲ*^HYYsX"':Oܹ]jUJ2ŋ'f_\cϻw GUPۊO$O"$m5~2ԪSTxX\谔a`f.aam[] y?< @>BdobϞ塡GGO6e5pww(-M6B ڴi`c?mfG)ffobunsscDDLfGt$MJ9%ec͛ss˪NV>_|ei0~Dζ,櫯v EP+WҫY :kߗ/Z$k<'6j(tTHI=wG'rQM1sX+z@[Hw۹`J%=s|z^O 3cc6Dq1~7vH }Neӕ5lh J~p<۪gNGW+-N4v>oիDN2YuSfIwXbP/,ȨAnak.113m=$db)_ɪmES{TZZJע@;f탈!LSfJپ) ߼yťo ' Ƹ}ZZv)ssLMBTzB 9c7n^UBstH 5MlLk]dl۷oU)yz"cX[;rIF;F[dd^(i-nʕeÐ!vllcCR$᠓wOό;;5k+ˤƛ:U])ȕDzI&nj PJ*ab`[BB(#/ر#OPj7ť/ \<䓭GP.]zҌ;mԩ/ h AZ2wb UPNx a ˹ph6 0T<5x\EZI$$U7j*9|&XD|n|SYY?/Bo~)+VLc1aa~ׇ<<ww3g>vhٳT4;{ _=Թs;^- Hr.<ܳgggN6m 3IS477ǜ.J"A'U3@UV՗ :}ɞWp""0t۷oŋ)Hڵk-nD $͍1bq`IFc$wJ; T;9tj<==bs +/LVުTzgm t,&2O޹sT%E#6)J5}r޽ѵ{=}JKـh:dN2vl୚aJy7;{2 M]>{,x1є xҷj[ɽfr3^ƪY :dm!*=]aOIQQ3R^ C9:r@}s{ܺ6ټܶ[,¶>-aa~nVV;ɃBA"㏢w Gwصky{2J%Qs߾(zvM7n|tRHݻ^uǎ%D>յ_II5Y#6V$JІV]\I> :!͚5k`m8A@gQQuTP$t9'$4oo""<{vv|!C<<5m_EDL&aU_vhp{$.zz: LJpЙEpB;wn'OYݻ[ pĹQQSVV_ƠS" d=`zi6V$/546ŽA7pS$՝:U+u%CEEEXD|~~lMA}73o1:zڲe{1_vN w--;ܺ\|* 2D68ׯ;AZ5T]76 ;VtRzƩ)tV :ۭ?dN /)Lxw 7駬umOxk.O&kMMx  >|CO٫^Y$uϡCePlϟY^A}+<<!͛G4iDiV$TM:Qj-!v[duLx2yzz8kW[ϻqȘؼH7)ʕt+w@u˗O1}''DΟ߷o>}^-\kbX ?~(* Ѩ;uj "D]U~Hޒs7n5HIYԛ=di// k9U# UY'FG#GD,Q#cܯ W1I&Sd*//t WJX N%hӱCb]r<uxQ?ȺkoHBUVU#{DUp vU@d,RfW׬:U+u;dUMuKC'_`6+U#U*tdtr3vU'\&&&4fEЩZIԷduZ_[5UVU#Ν>,qㆀNaW:u*85.J"A'U#Utd[''ɓG::SLU\t!OD,^J=wj~5^ɚkتKIWeG[O|1SbsAz)J"A'U#U)啞`Gg;;KxyU^`\tNSVћXV :dխJQ+֧ ܤ~Z%T+d֧VTMQ+֛Y^^nnn錐'T+d֛VT}Q+֛ 褙MTV :dխ7JOWœުkP$t+)Isҥo6n餣G׏>///8qժcG3gg/إB/Z$0C&?`j8s.L2v(aNjFU#A477t.H TCn!{DPaI=daD*Cgt4n$g"צM{iyɓ23cEm۶D=GKR| K^P'Nl5#zЪ^Ub=(RTӹ ):-qKL\xK_e%n3Z6zµO7eggfM0b֎9pҤHץJH:v>}1α w[mbc/cݻ[g~Exp?Hdl۷oUB.-*-M&Ç @eqEyu{…llJf?`113sVܸa\O8 Uytμs~/^L"Q6Vǧ@DЩ+IC#ij?9hzlm-\#d!yF޽co× nvhvJK_e%sDj؄ssغx-X%@@VAo qr<9Hk._//oo֬׿z~֫W篾 S6 w.?\rɓG җ*O ʰ;vDt~;3ƨ(VV0ffo+cW yo)k`P.l nӦ9H`;8`o2pƮ^=s':D2tuxb|HU͍sww@石G(d!yl:\ќ)h$Zeu@q>{BJf,"R>ͳgg2cPӦa3g>Hp*@'oC xi=;IKiW[O4BCX1֯שS@U lbLL ҥT>|Kz,\^K^n??/2QY >>DyVd۬`VOܹZ:%H йo_gr}m5Žǎ%y~r7kvNaJnUųfr~""&,$"S*hP{Nڲeڊ %dhԱ(OG%^ooʠ{7e_6my^%vm/ĉM-_>ń&&GV.> ı@o4gV)'V{>wnv@+#y׮< Іsҧϻ@?()*ub++K$Q]CgyyHd\_Z.Wu*]GI;~"#+rf! *tEС +dʒXWnϤ!sU8Hyg]p]?fOn<ҤIC<}z13ixOls.Bםmq5<^lggyvd}]844SF)bN;GY>]e6[LMx~΀GWxSS%NNw9O:tb++K$QMrЊA+2d]q1hl,\tVZ!dW]t 3v"\45X':tjj?PQ@<{Buuу2Zeu@g` b#c"c"p$F|+Wҭy,_>uƌ&BxyP١EUUB5P:8 ſGu:PxqToբSH7ǠA3W~P#HvEǏM))'h V \8Cqy?: WVѢ\g:%&}V(+lwǸzE(phXeOh!dW]t 3v"\bH$j~Qy7;{xɃFVVTʠz %?$-*Nz%b]9ixmGΐ~T+d֡VT[I_Owr&iڤeDz% q*B'թ:u LLL<$m96ic$^UibX!T+Ţ@tc bZj:'m,$ b8zH^ D8DRՈ:I#6%. wҍ,T:Wt]K\!ME׹fEI+YYY {$$M~kR]Ըp{zzA"$JKKYTTě[D"1Ș*>u$ ]и:I$(ns[ cl{@^™711ӵD$u$ ߃k:;zLyAdbh@`K*r*ƻ$wU EI2P2b+!xcPR )4 v-A'Ѕb4 dhR>բbQp2'mA'khΘd8R]C*鲦BR&N/4%~R͍DSmbn:I I=I ӕx&RL:I$H$TUbO5PDj5 ҫDR,'k9 鵪 PcАjS||<ΉjIXGOjHH-Z^ӹgyzzI]QEC"U!p'{NU"z+R*--%iQEC"UW&&&Q*IDYCeffq֝ponnNgXD qrKj:/$R&bLQPwH$4"~*Ŧny/Hz#Κ!Q](>>R3QEC"(`{I":U VGb +u=U4$R$JMLL!:UD"D΅^ b*諨!j*^^tTuTΪ*vDѓ"|UծJKKi8dCU4$Rm5EEEEC"|%[YYћZyeITѐH/6'u$:_Ir";Փ%hH: ٜHU%TjeeEiPDC}[IZ.j\P+қtU4$RI$Ag5%PKz`lDR233ͩ"i:Iu2Vn!-Թj^JKaź%PwU4$Ŧܠ=I#N*++EĽۡQH2NI­?GҸ:IusssӒĉ*I***JYtV&6s{b5E b I#"Ll*pMBĦk"R')U4$V}]D55I#"L*L'U4$)>>%SBeVHӹ4MLL茑*ITZZ*'Im"䩬 Ee:bO7K+鼐]TѐH+|TZBQIgD ՒJE)/R}SWRE zT"U|CDtH5U4$ D"t.H#NrT'uI5U4$K\!F:Q蕱B5&d BKTC8t+D]I+hH$Qii9MBRM Нp6<==e:e gB 2dVHӹ.I*D5 e Ş`/CN'ܸRMR*I= $UG (&Ct.HET2ĊD2ЫCR2@<Ą*o#hH$=ƕD4B8E"Qii3B2EC"d=Ѵ'${,**¸CoIꗞW4$ГēCg||< u崲y%HꗞW4$R|$/NOOOOd pɺo iVz^ѐH$ްy:qːb7e!ID")X,f3BҰ:q:G}W'H y?p4+}hH$RJW Y @.OOOYr1Ό;ҽ%I D؈5J3$$nR/I+T}fSii4$N ݻwoҤom8 I&}hH$ 111Ӷ5TT+\ L ="$H|G2\UL1nV$Iu1 A'ܯ \IftH$ebmXfff-p'$}V[œD;tHobbR[Q:d&t[ڽ'$N$Zbĉ3t֖]\IX_ S^^8qUǎfζ_| G3Y0]%tD"挤["$H 'v$謾=:y&%1WϪ9th%>{v᜜6mZݻwL5t)_)!W*%&$:I$+C w 'tMMT#:>=3nvvk#.^Lai,,̮\I%\Rܽвt NN6ζ}vZ[<^wta JWtzNQtH$%HTk:D"?/VÙA'/)io<~|jժKLDg߿0E'fApÄP/ر#ȶ8U UCVʠ3>>FD":I$RMUVVJ}:{}~)KI*@gg2cPӦ NHL+Laœ&Apo۩S@U `"{ǂ}Đ+ n52j a 8߿|ҤoբSWz]_߿HdvEVP27g"$Hu"S!}tʭ$.kT'bv$$˚D"չ@"A'$]$UTTdeeŽj'$˚D"OOXLI&+7A'I/E5DR0drtRtYH$uS]*6}~\iN^.knt*qT:洝g,`F&j57LIKeM"- F,ͺvjQw{IӼAV}|Ʒn/ZXX&r&$&HABTbsa㗏XD޳3trYzVTԔիwT~ө?زeQJʲEc7KJZ pm6A'I/E5DR:oKS%t# |0oNN3?ߟ-?/^La`({Tyܶ>}566jӦ?KX+ۭIF dg65}m۷NN'Vl޴Q#cg|۽"{93apOMq8¬nH3k7iNtRtYH$uS]7l+ށStmSg4iXb},.\8@-ccg"֭f͚ȑ3gƪ;"XYYS^=//Qffl E"kt?(JJb-(ȨCiiJ^D~Vho*QQSDSeM?S^SxE$%CܣvZa!|0ww7h..ЬY,6lhb""&c1FF >^uKNq#Ww)_~9N55}[[m&$&HABON?(3 {,~wjƞE{{xo'伽_^WYtJwG!ĉÍ-v "Gpi.@#,,0ImK=:s&$&HAge<ƈO_r0zEExLRrRV:ᒒdk.FF b(NiޭZ4lhܭ[njXÇwhܸaϞ]p}@yYJLIKeM"-N%YZqǁ>I0b䉓&$&HArTDc[퇿iu3A'I/E5DR:d&$&HA'$]$I"$˚D"[drtRtYH$uLVnN^.kntMIKeM"-rnn޽Rիgi<33l :Iz)I$EYV:pN#lpPk54A'I/E5DR:9zx ݽ[8zSF{RRaqNN6qqǻ;x?nLJ0ܲeˆ"|bJ-ɗ_9=#0d9nVV;ȋqDQn]`A~6nm5s2y&N4O~رCL|l#$.H$VJD5ο3(ʕ5k7n-.`,Οi|?m:=f/Ǎs--MY.l߾/&" R&&ɉcO:y8.pP(ӧ{#pR*[[ܲLX1-!!?K^=D 4'On1}#zYI/fd2gl{ q~CO`܇~e33c3oq@gZJ+Gs9AA@!C xwG#pV^=-,pt=k{z..}'LpOY/ >DI&kچ5s]7{Æp,=% 할3%eKy|@'HY__#`ܹ7=ccgƅs$Ey)ɭfnY&ϝEQ1/޻wڵGhHdV[/m8߽[8jу=<=xpcyy^=P]>xC9?tP_8Њ=ts|Trr ޽).ҵkX^<8Ǖ?CpHd}v.W-C ftWc[0yGhHdV[/mtZ>$^Z/ >DЩ}M0ٳNmBVbl{-tzYI$:G'Oܤ$5xAgyyHd|?,x6T;KrHy Vm6dre':kׯ,\8Ʀkjq\\&Hvb KcaavJ:/g:֎9pҤF9&njqnѢ٬Y/.Yd"6߿'Z==zffƊf3lOGo'ON#lmd<:vյߩSN*oo*bQrs〰lp?,\R |Ɛkhl{![/ >DYkG^q1 Դi_=ݻ[ … p{Ne 3g>ڱpϞҥH<|NQ""&aVݻw,8؇je1X/۞LD iH/Z%1cϝۦ0ڵD 6vII \?Ɣ=ne[&`QX$P$:-[(It $?4p?084ԷOwׯc c5^=TېʭD"}bw6/Ǚ %ڹ3lx˗ 7dD׮3eС+L:?|CO,?ںӧgd#yB(D"k`'5U1T1Z^=TېʭD"+N˗llv wJ;ζ˗O1}''$q#ȨAJ2&`Vԩ-{F۷448:e|lاϻ٫Q4~zPmC&+^|LjeC ZI,u\WƋLY=骕Di־^#b#$h*d5L&SC&lN2LmlOV :d2=^na{wZK74 Nbz߾ىm~5~Q)7ANBM1š쐀9FsE]x#:p3LV WӏlOۃ<,m۾ŦA{ca]]:Ѭ?xpB&7(q@Xs6V.)Iq,FW.9ooOho%7zi" K̈y5fxD~>?d+J,`S8S> ?ll<*jٛHxAkCk{FM?7"E^&N\(99q/..}Q)D<^+HֽtP%$2K.ܪ@\&YyAcZW`>=8G01q.bD;wFQí)7nȞ];gϡCVY t~Nb ]>=0n B8HTVO XT r*{#ѭKv :|FT܉s׾Fst0"ԏ0R _rtl*dm0A.99\Шڵ 393Ѵ6Q#aWlz}|ǖUXϞ5k^nܸĮNA=L2'{^OS%t#mqY>^lggy*s߾lw qo&|EjA|6SwG'rQ{؏#Zyr[wxzlC+dS px0<0oDd۞٫ؐIhsٳgCo`'k: 7|xvbyU>ͽvk*;OVh*d5L&SC&ז/_S* Ț3! a}zT&$Ɇh*.5̋bF1XLI&! Tkne>ܕT+fxyNwQ :Ư1\rdV2M{bM$o?K7ճ8r66]٠UŋZRA'զL6@S7/ydBx[§,g b1pTh~r9q /DbFwݻ[`޾իiQFk.g>}=sc`A 3$on?wni %/`mDxS%GI&k! Tk谉}gg0 g]f3ƥüM.+d_zL^--;"իǦe5pww(-M69onhUPٲPL||sV^fMp#GΜ9;vD|^Zn;v%GЩV]J&|%ֵ$dLml_CO3~v`EJ'zf}:7oV]ҠA}Mϋ o80 DkՈnj;w*N9?x!*F$lҤk?2 M//9N]?ίR}lۯ_wa<ӒKpXbPVqcvM7n|tRHݻ^5?@1h9JJ5~uTk谉b;Ja]_ ̠svޓNooQff,sn"0ֲ)X466jȨK%@xJd[oa۵kݣKUzyt@C$hȁb!vׯu+k7mGykmqb[YE +wڱ}stΝۥJx[,q^xa =</Jow=xT/V'@LmoӦU,y x=M4{s@RK^PA'_C'ǟ w.GJ,{B1p}^YN8+kVZxfHJZރ>J:oko8@L__޶?bl{e`" \˺̌e9 p,-Mad%Mŋmz7t*t鲊6~*>5x10++ /YcÈɲ3;hPo{tkb,;=쀌 3Gʿ^?ujݻ:石4i4a;&QÌ1 {ϓ'oEd~ ЫEf7oAҫWg NTճ͛"A~~”)Ho Nr9AA>Cu۶u.*ڈ;>m'n+@am5~2 ĆH n[7E۷7E28pބ'[ٗY¾K]j%ɼ..}۷o7g;?p KdhH5kBI ׅ>w۹`J%=s|z^R*!@#Mdd"Yyp|7ٳѣNP3a6e@"ccgloKNB$x<(Ȩٛ >A'`nq3ɸ"=={#,\˜1󁏹qeUA'o+8Yt)ϸ6c-#Ԉ s8gOHZiތEDʧ tfguB篿ܹ|O?eA` (/QQSVVL`;HYqFI םA;f탈'N:/9N\NNVӧ{){~ܮ]Q[|褬q-*"{/ |9kyJ:KA'o+8޽[8jу=<=xp;d^^Wtjԗ :} ǔǏo:?(21iV)E];gOv8k?/pa;}+p7oiҤA'&6Ot/_NJ6'0c 11yޗUU-+{X怡!"|B B"*&8pŲ+^ԫ`!sj>ԬfZV6i]'o>l9=Y{~׻]{e/Dײ(D(=7d_\\hޝC:o:ŅDD_YH|uI:]NSFy,=ڤ`h_n^FUP:>`Ժ+bdHGkϹs']8^Ψmas0d0qyh}2 jqxͳ a-鎿x⌌+WL3L: ƽ=m }t󩧞'w|{ H' +}<0p/SO 49~`54/^l1&GC@:IԳ:~II.}ܺ>``0ā{{Kxa0>B, 2z8116>|z&qDT&`@tGC8h7˗w #*j@>]Ο/yKqvٲԿErSQ;uz|VW 9d~e?>?..9цkҢ9|xXEFSW1ϸq {"!7E{1d0:t޽{@n5^f~;ud6 >tZͧ⧟{mNҥS,IZ|-rs遢&əϜ)\(C PVS|~8bPPWX=M:I=:M0gpaǺuY?]ۏ4ÇW{*"SII~f۶On2_M:Ϝ)?{Ç}?gĈ>hϡ~}YBbF2Dn9tBnbzc`5Mj"&$H'm^reG3'鉋<}.UL:58VJ[$UvI'Ly;D@>5G߿֭>"{zؔjC:A撒MOz|?L޹s[/۷/B̙^ݺ#`_~>AEt[ LJ)1%e$85k,KK 1fLC-_?m.-J0thŴI mj=WJ'Oѻwgи=:Ss #`$PI·߼9'4~agz2cQ:>``0j3ܰ o_'qHu*N!"NYYԭAN񲣺ce N0=[Լy/d0 VsM̖9G)͜_@eQTQ8%  z'!C׮OMvlWTTApNO cȑ}AccC0ajժXBNYz'33g Aq'֭]-6n򸲐N`-2_]R΃kצӡCCus&yG7Ԫϰگ/8kd){ 6BmsIW.+ڑm^̽^>&*=˻l^#6N#N񂣺föiĵ_)^pT׌w'$ʓy1{Z +^H~MxQ]3FezդV߿U`T<0YYԭAqt5c] us Cqabna0 +^HRϐ]̳:V;>ʰ#i{~n]{QsQ aed06= F-w|``FpgXL: = Fmw|`ܣ];8%(/_^ƍw5q￿p^uUCʕx34uajQ'""ڴyy&u>L[hn ozj1ƍs,IL~}R:'>>֭#VZH%.[KVt^uk)??ӧ7U;fu=rdMNîsӴiCS4R t&'GРU}.p22bŹP͕zIkO ;qovh^%|i[?/._TfNzFj׶Z,Y pǷyڧOjTxNZ8G@@>5G߿֭>"1?Fj% 4r̘|Mdg7~})bΟ/ݻs@۶m ||9ztCk͒3<9s^^o_t֑fW1wR]dn`N(W.-J0tj q~Ϝݺ#飑 bt"_+ZtbNJ 7U|ggQjj#mׯ{?kX*|}qb֟;w'q6--ZJu=p`TbzzLbS \OR/K6EZuZٳE͛>39ZJir-[:C[[`_*<<2d0msOpAMSJ>X8 \M9ҩ$!v"棏6*>Vg ^$ XRZ*m„[<hIII.~Ufj+WΠM,_>T>4iDن ~v++{Rbn1ӧ7>{ ݼyX݆`zCJ&DV`mOv~|_r5 FA0˂ä >l5Uyhj[hx~;@Vd:k’Izަ(\BG75 yLcҩ5;ł߯ r6o C~YޣL: j3ܰ o_'qHu"!!=ZLKСSؽ{)SžZ5 ٶmf8cƌkLf3QQhaxx AXnj RS#9cսpa|QS#ŋ)%fWWgpwofK crФJ漄0%sOٳE F0ՙ*3ge3g>|& __*w Y)kL: s>ow9 atC]h_u_bFdd?TEJDt,[\UPTK]ݜjqY6fS䢩H/)TM߾>`vwrWE 1i09KnzQ.gRV2:#`PzA/0]aD X/XZaͳM45U<\(%ׯBNjw]ݸre~> wHO-:z8 P\rL7 ?E(e ~*oܸ>`h|L!G\p|JTÈKUkC7V=1[334s~i&E!RFќ ERʑNT}˔| )znݝ[x9RS#==-DQ<yIV͐H0q gM8 Q+,Ű-3"rCKS-V{}MW+Qo3Z|_jA`Ny1P3t A./\&ݴu|eS>By}*6gvs~Ŵ@`emWN"vYyN֎tph.M.&a<=&̅6]6&o*[^H_]n]SӦZ8Qܢ~w&cB)"Y(!s| j;F)Jt .+@<=i?+fǢϵl gY(|M/ksf7燮YL V*/-*$>23c;uz^=l_ӷ f\ [;aF;N#ݺrߡMSFM/7Yr6ïP r0oysl[u4WE .WRMZhzvgF5覭s-BgYX| lXn]j`03 {!F<|wݻu&ZB [tz݈ïP ;XJ"/}Bɫ"7G:~r悛ŋ;\˦}JTÈKUkMC7;>ʰia_#ډe2*GWT<0VNSMzVC_; VT誂;>ʰ/`0l{Z +I'็pԎbb6n 6f Cu+ 6 >㳰0d09Tqٸ3t>`N UcMV_;:zO4tuuu6oQ1#eKg( CjAm<ټyuB#֯?vA-0>>>Q9/ ą;w.QOބșuI'apȹ* hj399bԨjR2U|kx )##ƍw..mڴY5!|ڵ/ۺu34oֹIVډ|Ck{R:R zR X1#29sftZZkt%I'apȹGIy;|7~za Gn?usGy`c Ji@aRvΝzy߾}|(d[RۯODDPݢ޺uD f7-:thV;eL 5kXM=iS/oomț⒁Ą AzzLb*,\PuG>&ӧF 2>_sr&%WC6+Hckp&GI@i0sY=.͙"T.l7hܸիU|Lp_={> 04KI'apȹGg .HiJ!C!g)HOypرc?\bJGGP@G>`xH[[7xɒ$SO8alAS^VRr匱ceD޴(ѣd=qK^}pIMov1դS]4-l\ ʥдb!+ +ߗ2߼9'4~agz*ׅ:|gaa`5r17L~+7lCǗ|"RFM:i,S6QgwVkּ$A`޽ YSPΖiF-^hUT0< mH'9h:WOKqxPK+' 9j/v_sGFtsg̯*Yar17<7<+{O!"iԤS؛4;{|zz:ҥ2TM-W@&z·̌PL"8:52/o& Qҩڏ.nhQI/^t*8@9i+ ԫ`= =[Լ_ | PyG`eo}K~Vض5[ݖsM̖9G)͜_@eQTA7oժpͧhZh0մo2%/؂!55b)*ZxP--Ⱦ!蛊V(? P\MѴ5Seez ĸP }o $lSdK]Mwy.:$BIRz13׼/e{1⦇,w|CӢk?&˧*'bhyRˤO R9aF #v/X5k֬| c%o*f1R/r V+#+wNjܜ2:ܣ3E\JB[ )"/}STnnn/yI ,,I7IMӧ ?X v~e")E;W[?Df5oj˖Γ& WHhV|ָ9ij8`024ڏɛvbعsIݺc78bz++Cyؐ2*!;> NîsH-Oʫ5:LI|CCt\]~(0Л6m@njrjYXt2v {G[h'H*0kX c̘|@J4I'+u|uXP}֭#͚5o9C<ϟ/6mmyV\2p`$HOILC&Μխ;&ӧܹmAAȤ3(}<= |Rg~P{ܸ`t~ѢR@##b >vl G!NO.ΦEkc=RFA3j;> A daaCQCry\Ú*gջ\9cAFTZ$ͥKe>K&E7o۷`?ߌS( Y 5<}z+,dwv!*j=w p`|s.hL 4iVװr^&'Map>4u>,NZ2s#e˺4ftn,,,ss[a==\Yϖ-A!JFAA]ҢQ/ڵ._>-""+ad"PH%Id:L_#էopzʻ~e Q5&,)ܬYXX-Hˢ1'M@ ~qHup/7w^"Pzݻsrr7qlwQi9..j߾>8kqrO:ãtvUAH5 !!S."2Q^pydш̌E`%u> k4i@#%']PR_ӃFէopM)_͠5Špfaa#1[334s~i&E!RH6ujGϞLԤSpsS?[+!{ƌ nܸ~Vp/A4ҩSusG[m2/..N61vuGA@wt![)!~9SةP~츉A?v%z(Fvy^0_HtUI:˺4ftn,,,D+'_<'kG:8s'[!z.kbo`͚ڢC:'oՋ f\ ;Nn,,,}`0t8pfaa0d0!5 I'&,)ܬYXX-L: }0dqHfbma`I'C 7kk NCL:YRYX[t2`͚¤Nn,,,֖*΍ooE:/,gekGʧ7/^,J˗ƆTJ3fDl Co<\ R7oޤn݇.S;w.QR> n7LL~} ֩󠛛+< V5XNn,,,֖+WvyF:#F?hP㗘#.71*]ۿ[{!|;~WϬ bȻ VO993:--ĉo١N߾}Kԑj^~(072uvI !5 EtG`" _^||HgPP#xz2ďVnఴ4r̘|P) xs#pM~퇑%%DD-:z[G">>=4=͚5}&3( *vZM&OܹW)ThnJHP\>kXsΟ/>}4)(}fəd{wv۶m\vٰm^\(&ƍ_h3ǎAJ0_;wv&gd =&&eLOILCBV P6"0da1'ܬYXX-:3 y)%?`Ei@:x!;ࠔ ||)hG(.}9OƍdIPJ"RVf ʪUi& Aɓojщht*>𫯊&Q@o?0$P^9ӧ7.`]7_~m'AxեKe>KP.aA܉m!BO(dQ?rdeXXnCjE ;A&jѢ)LoС%" F iRE`bNYX[̑omH|?CD#!!=)СF:,j͚4 ;??ݻ|nGɦMxqf XٌQkצ- THڧ #Jfə(5nΜt*99W.Q'Ʊckԑ Z5 ٶm&ʮi؁kV9҉KA ..tŊS琐F…[ϒO'W'Qn&RT 'NU#4"0da1'ܬYXX-H}ʳdl"T|:1كdgOOQ'\TV۷x:~D$8:52/of 쎍 ټ9}锟t(םHRff,P6G:gώSIIKNsuȖ-AwW+YAUοv$\v}$PEmwvnDϧMbQ(Ov` V@D B:tTj#4"0da1'ܬYXX-Hˢ1'M@ ~qHu'ߠ72ڳUp!@NfDSœ "M4#ݻwD>1DV@Aڵ{jA[| 舓S=MYVntb3J ٛ7w^sP֨ w,v.zKƍsw<.k(]߰*ᴴ[P[_ӃFSDS6P@s&5R&,,愛5 2W蜝9K3, 4Uf!!=5H[RR8xs-Sr-͚5ޱ`$#G eCrzukzSxPDA!CB{l2FBmOvEE *w:5gg-$(D3(+pԩݺ#C[%k(]߰:ƍwu}L!q{d~!L:MI:#4gR#E`bNYX[tEఆ&u5!@'D9;wy: t^ L8xbp877˗w6Nn,,,O&X>u&x333SկۜԜ5-[o* !!lÆ6=I'C 7kk o`I'C 7kk NCL:YRYX[t2`͚¤Nn,,,& >t8pfaa0d0!5 >KbnR͚ƅI' K N6p%M=)IENDB`java-design-patterns-1.16.0/promise/etc/promise.ucls000066400000000000000000000154011312550536300224300ustar00rootroot00000000000000 java-design-patterns-1.16.0/promise/etc/promise.urm.puml000066400000000000000000000047701312550536300232500ustar00rootroot00000000000000@startuml left to right direction package com.iluwatar.promise { class App { - DEFAULT_URL : String {static} - LOGGER : Logger {static} - executor : ExecutorService - stopLatch : CountDownLatch - App() - calculateLineCount() - calculateLowestFrequencyChar() - characterFrequency() : Promise> - countLines() : Promise - download(urlString : String) : Promise - lowestFrequencyChar() : Promise + main(args : String[]) {static} - promiseUsage() - stop() - taskCompleted() } class Promise { - exceptionHandler : Consumer - fulfillmentAction : Runnable + Promise() + fulfill(value : T) + fulfillExceptionally(exception : Exception) + fulfillInAsync(task : Callable, executor : Executor) : Promise - handleException(exception : Exception) + onError(exceptionHandler : Consumer) : Promise - postFulfillment() + thenAccept(action : Consumer) : Promise + thenApply(func : Function) : Promise } -class ConsumeAction { - action : Consumer - dest : Promise - src : Promise - ConsumeAction(src : Promise, dest : Promise, action : Consumer) + run() } -class TransformAction { - dest : Promise - func : Function - src : Promise - TransformAction(src : Promise, dest : Promise, func : Function) + run() } ~class PromiseSupport { - COMPLETED : int {static} - FAILED : int {static} - RUNNING : int {static} - exception : Exception - lock : Object - state : int - value : T ~ PromiseSupport() + cancel(mayInterruptIfRunning : boolean) : boolean ~ fulfill(value : T) ~ fulfillExceptionally(exception : Exception) + get() : T + get(timeout : long, unit : TimeUnit) : T + isCancelled() : boolean + isDone() : boolean } class Utility { - LOGGER : Logger {static} + Utility() + characterFrequency(fileLocation : String) : Map {static} + countLines(fileLocation : String) : Integer {static} + downloadFile(urlString : String) : String {static} + lowestFrequencyChar(charFrequency : Map) : Character {static} } } TransformAction --+ Promise TransformAction --> "-src" Promise ConsumeAction --+ Promise ConsumeAction --> "-src" Promise Promise --|> PromiseSupport @enduml java-design-patterns-1.16.0/promise/pom.xml000066400000000000000000000035761312550536300206360ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 promise junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/promise/src/000077500000000000000000000000001312550536300200755ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/main/000077500000000000000000000000001312550536300210215ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/main/java/000077500000000000000000000000001312550536300217425ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/main/java/com/000077500000000000000000000000001312550536300225205ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243505ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/main/java/com/iluwatar/promise/000077500000000000000000000000001312550536300260265ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/main/java/com/iluwatar/promise/App.java000066400000000000000000000141411312550536300274120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.promise; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.Map; import java.util.concurrent.CompletableFuture; import java.util.concurrent.CountDownLatch; import java.util.concurrent.ExecutionException; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; /** * * The Promise object is used for asynchronous computations. A Promise represents an operation * that hasn't completed yet, but is expected in the future. * *

A Promise represents a proxy for a value not necessarily known when the promise is created. It * allows you to associate dependent promises to an asynchronous action's eventual success value or * failure reason. This lets asynchronous methods return values like synchronous methods: instead * of the final value, the asynchronous method returns a promise of having a value at some point * in the future. * *

Promises provide a few advantages over callback objects: *

    *
  • Functional composition and error handling *
  • Prevents callback hell and provides callback aggregation *
* *

* In this application the usage of promise is demonstrated with two examples: *

    *
  • Count Lines: In this example a file is downloaded and its line count is calculated. * The calculated line count is then consumed and printed on console. *
  • Lowest Character Frequency: In this example a file is downloaded and its lowest frequency * character is found and printed on console. This happens via a chain of promises, we start with * a file download promise, then a promise of character frequency, then a promise of lowest frequency * character which is finally consumed and result is printed on console. *
* * @see CompletableFuture */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); private static final String DEFAULT_URL = "https://raw.githubusercontent.com/iluwatar/java-design-patterns/Promise/promise/README.md"; private final ExecutorService executor; private final CountDownLatch stopLatch; private App() { executor = Executors.newFixedThreadPool(2); stopLatch = new CountDownLatch(2); } /** * Program entry point * @param args arguments * @throws InterruptedException if main thread is interrupted. * @throws ExecutionException if an execution error occurs. */ public static void main(String[] args) throws InterruptedException, ExecutionException { App app = new App(); try { app.promiseUsage(); } finally { app.stop(); } } private void promiseUsage() { calculateLineCount(); calculateLowestFrequencyChar(); } /* * Calculate the lowest frequency character and when that promise is fulfilled, * consume the result in a Consumer */ private void calculateLowestFrequencyChar() { lowestFrequencyChar() .thenAccept( charFrequency -> { LOGGER.info("Char with lowest frequency is: {}", charFrequency); taskCompleted(); } ); } /* * Calculate the line count and when that promise is fulfilled, consume the result * in a Consumer */ private void calculateLineCount() { countLines() .thenAccept( count -> { LOGGER.info("Line count is: {}", count); taskCompleted(); } ); } /* * Calculate the character frequency of a file and when that promise is fulfilled, * then promise to apply function to calculate lowest character frequency. */ private Promise lowestFrequencyChar() { return characterFrequency() .thenApply(Utility::lowestFrequencyChar); } /* * Download the file at DEFAULT_URL and when that promise is fulfilled, * then promise to apply function to calculate character frequency. */ private Promise> characterFrequency() { return download(DEFAULT_URL) .thenApply(Utility::characterFrequency); } /* * Download the file at DEFAULT_URL and when that promise is fulfilled, * then promise to apply function to count lines in that file. */ private Promise countLines() { return download(DEFAULT_URL) .thenApply(Utility::countLines); } /* * Return a promise to provide the local absolute path of the file downloaded in background. * This is an async method and does not wait until the file is downloaded. */ private Promise download(String urlString) { Promise downloadPromise = new Promise() .fulfillInAsync( () -> { return Utility.downloadFile(urlString); }, executor) .onError( throwable -> { throwable.printStackTrace(); taskCompleted(); } ); return downloadPromise; } private void stop() throws InterruptedException { stopLatch.await(); executor.shutdownNow(); } private void taskCompleted() { stopLatch.countDown(); } } java-design-patterns-1.16.0/promise/src/main/java/com/iluwatar/promise/Promise.java000066400000000000000000000142721312550536300303150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.promise; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; import java.util.concurrent.Executor; import java.util.function.Consumer; import java.util.function.Function; /** * A Promise represents a proxy for a value not necessarily known when the promise is created. It * allows you to associate dependent promises to an asynchronous action's eventual success value or * failure reason. This lets asynchronous methods return values like synchronous methods: instead * of the final value, the asynchronous method returns a promise of having a value at some point * in the future. * * @param type of result. */ public class Promise extends PromiseSupport { private Runnable fulfillmentAction; private Consumer exceptionHandler; /** * Creates a promise that will be fulfilled in future. */ public Promise() { } /** * Fulfills the promise with the provided value. * @param value the fulfilled value that can be accessed using {@link #get()}. */ @Override public void fulfill(T value) { super.fulfill(value); postFulfillment(); } /** * Fulfills the promise with exception due to error in execution. * @param exception the exception will be wrapped in {@link ExecutionException} * when accessing the value using {@link #get()}. */ @Override public void fulfillExceptionally(Exception exception) { super.fulfillExceptionally(exception); handleException(exception); postFulfillment(); } private void handleException(Exception exception) { if (exceptionHandler == null) { return; } exceptionHandler.accept(exception); } private void postFulfillment() { if (fulfillmentAction == null) { return; } fulfillmentAction.run(); } /** * Executes the task using the executor in other thread and fulfills the promise returned * once the task completes either successfully or with an exception. * * @param task the task that will provide the value to fulfill the promise. * @param executor the executor in which the task should be run. * @return a promise that represents the result of running the task provided. */ public Promise fulfillInAsync(final Callable task, Executor executor) { executor.execute(() -> { try { fulfill(task.call()); } catch (Exception ex) { fulfillExceptionally(ex); } }); return this; } /** * Returns a new promise that, when this promise is fulfilled normally, is fulfilled with * result of this promise as argument to the action provided. * @param action action to be executed. * @return a new promise. */ public Promise thenAccept(Consumer action) { Promise dest = new Promise<>(); fulfillmentAction = new ConsumeAction(this, dest, action); return dest; } /** * Set the exception handler on this promise. * @param exceptionHandler a consumer that will handle the exception occurred while fulfilling * the promise. * @return this */ public Promise onError(Consumer exceptionHandler) { this.exceptionHandler = exceptionHandler; return this; } /** * Returns a new promise that, when this promise is fulfilled normally, is fulfilled with * result of this promise as argument to the function provided. * @param func function to be executed. * @return a new promise. */ public Promise thenApply(Function func) { Promise dest = new Promise<>(); fulfillmentAction = new TransformAction(this, dest, func); return dest; } /** * Accesses the value from source promise and calls the consumer, then fulfills the * destination promise. */ private class ConsumeAction implements Runnable { private final Promise src; private final Promise dest; private final Consumer action; private ConsumeAction(Promise src, Promise dest, Consumer action) { this.src = src; this.dest = dest; this.action = action; } @Override public void run() { try { action.accept(src.get()); dest.fulfill(null); } catch (Throwable throwable) { dest.fulfillExceptionally((Exception) throwable.getCause()); } } } /** * Accesses the value from source promise, then fulfills the destination promise using the * transformed value. The source value is transformed using the transformation function. */ private class TransformAction implements Runnable { private final Promise src; private final Promise dest; private final Function func; private TransformAction(Promise src, Promise dest, Function func) { this.src = src; this.dest = dest; this.func = func; } @Override public void run() { try { dest.fulfill(func.apply(src.get())); } catch (Throwable throwable) { dest.fulfillExceptionally((Exception) throwable.getCause()); } } } }java-design-patterns-1.16.0/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java000066400000000000000000000064721312550536300317150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.promise; import java.util.concurrent.ExecutionException; import java.util.concurrent.Future; import java.util.concurrent.TimeUnit; import java.util.concurrent.TimeoutException; /** * A really simplified implementation of future that allows completing it successfully with a value * or exceptionally with an exception. */ class PromiseSupport implements Future { private static final int RUNNING = 1; private static final int FAILED = 2; private static final int COMPLETED = 3; private final Object lock; private volatile int state = RUNNING; private T value; private Exception exception; PromiseSupport() { this.lock = new Object(); } void fulfill(T value) { this.value = value; this.state = COMPLETED; synchronized (lock) { lock.notifyAll(); } } void fulfillExceptionally(Exception exception) { this.exception = exception; this.state = FAILED; synchronized (lock) { lock.notifyAll(); } } @Override public boolean cancel(boolean mayInterruptIfRunning) { return false; } @Override public boolean isCancelled() { return false; } @Override public boolean isDone() { return state > RUNNING; } @Override public T get() throws InterruptedException, ExecutionException { if (state == COMPLETED) { return value; } else if (state == FAILED) { throw new ExecutionException(exception); } else { synchronized (lock) { lock.wait(); if (state == COMPLETED) { return value; } else { throw new ExecutionException(exception); } } } } @Override public T get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException { if (state == COMPLETED) { return value; } else if (state == FAILED) { throw new ExecutionException(exception); } else { synchronized (lock) { lock.wait(unit.toMillis(timeout)); if (state == COMPLETED) { return value; } else if (state == FAILED) { throw new ExecutionException(exception); } else { throw new TimeoutException(); } } } } }java-design-patterns-1.16.0/promise/src/main/java/com/iluwatar/promise/Utility.java000066400000000000000000000112301312550536300303310ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.promise; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.BufferedReader; import java.io.File; import java.io.FileReader; import java.io.FileWriter; import java.io.IOException; import java.io.InputStreamReader; import java.io.Reader; import java.net.MalformedURLException; import java.net.URL; import java.util.HashMap; import java.util.Iterator; import java.util.Map; import java.util.Map.Entry; /** * Utility to perform various operations */ public class Utility { private static final Logger LOGGER = LoggerFactory.getLogger(Utility.class); /** * Calculates character frequency of the file provided. * @param fileLocation location of the file. * @return a map of character to its frequency, an empty map if file does not exist. */ public static Map characterFrequency(String fileLocation) { Map characterToFrequency = new HashMap<>(); try (Reader reader = new FileReader(fileLocation); BufferedReader bufferedReader = new BufferedReader(reader)) { for (String line; (line = bufferedReader.readLine()) != null;) { for (char c : line.toCharArray()) { if (!characterToFrequency.containsKey(c)) { characterToFrequency.put(c, 1); } else { characterToFrequency.put(c, characterToFrequency.get(c) + 1); } } } } catch (IOException ex) { ex.printStackTrace(); } return characterToFrequency; } /** * @return the character with lowest frequency if it exists, {@code Optional.empty()} otherwise. */ public static Character lowestFrequencyChar(Map charFrequency) { Character lowestFrequencyChar = null; Iterator> iterator = charFrequency.entrySet().iterator(); Entry entry = iterator.next(); int minFrequency = entry.getValue(); lowestFrequencyChar = entry.getKey(); while (iterator.hasNext()) { entry = iterator.next(); if (entry.getValue() < minFrequency) { minFrequency = entry.getValue(); lowestFrequencyChar = entry.getKey(); } } return lowestFrequencyChar; } /** * @return number of lines in the file at provided location. 0 if file does not exist. */ public static Integer countLines(String fileLocation) { int lineCount = 0; try (Reader reader = new FileReader(fileLocation); BufferedReader bufferedReader = new BufferedReader(reader)) { while (bufferedReader.readLine() != null) { lineCount++; } } catch (IOException ex) { ex.printStackTrace(); } return lineCount; } /** * Downloads the contents from the given urlString, and stores it in a temporary directory. * @return the absolute path of the file downloaded. */ public static String downloadFile(String urlString) throws MalformedURLException, IOException { LOGGER.info("Downloading contents from url: {}", urlString); URL url = new URL(urlString); File file = File.createTempFile("promise_pattern", null); try (Reader reader = new InputStreamReader(url.openStream()); BufferedReader bufferedReader = new BufferedReader(reader); FileWriter writer = new FileWriter(file)) { for (String line; (line = bufferedReader.readLine()) != null; ) { writer.write(line); writer.write("\n"); } LOGGER.info("File downloaded at: {}", file.getAbsolutePath()); return file.getAbsolutePath(); } catch (IOException ex) { throw ex; } } } java-design-patterns-1.16.0/promise/src/test/000077500000000000000000000000001312550536300210545ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/test/java/000077500000000000000000000000001312550536300217755ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/test/java/com/000077500000000000000000000000001312550536300225535ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300244035ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/test/java/com/iluwatar/promise/000077500000000000000000000000001312550536300260615ustar00rootroot00000000000000java-design-patterns-1.16.0/promise/src/test/java/com/iluwatar/promise/AppTest.java000066400000000000000000000026061312550536300303100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.promise; import java.util.concurrent.ExecutionException; import org.junit.Test; /** * * Application test. */ public class AppTest { @Test public void testApp() throws InterruptedException, ExecutionException { App.main(null); } } java-design-patterns-1.16.0/promise/src/test/java/com/iluwatar/promise/PromiseTest.java000066400000000000000000000212611312550536300312040ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.promise; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import static org.junit.Assert.fail; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; import java.util.concurrent.Executor; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import java.util.concurrent.TimeoutException; import java.util.function.Consumer; import java.util.function.Function; import org.junit.Before; import org.junit.Rule; import org.junit.Test; import org.junit.rules.ExpectedException; /** * Tests Promise class. */ public class PromiseTest { private Executor executor; private Promise promise; @Rule public ExpectedException exception = ExpectedException.none(); @Before public void setUp() { executor = Executors.newSingleThreadExecutor(); promise = new Promise<>(); } @Test public void promiseIsFulfilledWithTheResultantValueOfExecutingTheTask() throws InterruptedException, ExecutionException { promise.fulfillInAsync(new NumberCrunchingTask(), executor); assertEquals(NumberCrunchingTask.CRUNCHED_NUMBER, promise.get()); assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } @Test public void promiseIsFulfilledWithAnExceptionIfTaskThrowsAnException() throws InterruptedException, ExecutionException, TimeoutException { testWaitingForeverForPromiseToBeFulfilled(); testWaitingSomeTimeForPromiseToBeFulfilled(); } private void testWaitingForeverForPromiseToBeFulfilled() throws InterruptedException, TimeoutException { Promise promise = new Promise<>(); promise.fulfillInAsync(new Callable() { @Override public Integer call() throws Exception { throw new RuntimeException("Barf!"); } }, executor); try { promise.get(); fail("Fetching promise should result in exception if the task threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } try { promise.get(1000, TimeUnit.SECONDS); fail("Fetching promise should result in exception if the task threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } } private void testWaitingSomeTimeForPromiseToBeFulfilled() throws InterruptedException, TimeoutException { Promise promise = new Promise<>(); promise.fulfillInAsync(new Callable() { @Override public Integer call() throws Exception { throw new RuntimeException("Barf!"); } }, executor); try { promise.get(1000, TimeUnit.SECONDS); fail("Fetching promise should result in exception if the task threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } try { promise.get(); fail("Fetching promise should result in exception if the task threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } } @Test public void dependentPromiseIsFulfilledAfterTheConsumerConsumesTheResultOfThisPromise() throws InterruptedException, ExecutionException { Promise dependentPromise = promise .fulfillInAsync(new NumberCrunchingTask(), executor) .thenAccept(value -> { assertEquals(NumberCrunchingTask.CRUNCHED_NUMBER, value); }); dependentPromise.get(); assertTrue(dependentPromise.isDone()); assertFalse(dependentPromise.isCancelled()); } @Test public void dependentPromiseIsFulfilledWithAnExceptionIfConsumerThrowsAnException() throws InterruptedException, ExecutionException, TimeoutException { Promise dependentPromise = promise .fulfillInAsync(new NumberCrunchingTask(), executor) .thenAccept(new Consumer() { @Override public void accept(Integer value) { throw new RuntimeException("Barf!"); } }); try { dependentPromise.get(); fail("Fetching dependent promise should result in exception " + "if the action threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } try { dependentPromise.get(1000, TimeUnit.SECONDS); fail("Fetching dependent promise should result in exception " + "if the action threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } } @Test public void dependentPromiseIsFulfilledAfterTheFunctionTransformsTheResultOfThisPromise() throws InterruptedException, ExecutionException { Promise dependentPromise = promise .fulfillInAsync(new NumberCrunchingTask(), executor) .thenApply(value -> { assertEquals(NumberCrunchingTask.CRUNCHED_NUMBER, value); return String.valueOf(value); }); assertEquals(String.valueOf(NumberCrunchingTask.CRUNCHED_NUMBER), dependentPromise.get()); assertTrue(dependentPromise.isDone()); assertFalse(dependentPromise.isCancelled()); } @Test public void dependentPromiseIsFulfilledWithAnExceptionIfTheFunctionThrowsException() throws InterruptedException, ExecutionException, TimeoutException { Promise dependentPromise = promise .fulfillInAsync(new NumberCrunchingTask(), executor) .thenApply(new Function() { @Override public String apply(Integer value) { throw new RuntimeException("Barf!"); } }); try { dependentPromise.get(); fail("Fetching dependent promise should result in exception " + "if the function threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } try { dependentPromise.get(1000, TimeUnit.SECONDS); fail("Fetching dependent promise should result in exception " + "if the function threw an exception"); } catch (ExecutionException ex) { assertTrue(promise.isDone()); assertFalse(promise.isCancelled()); } } @Test public void fetchingAnAlreadyFulfilledPromiseReturnsTheFulfilledValueImmediately() throws InterruptedException, ExecutionException, TimeoutException { Promise promise = new Promise<>(); promise.fulfill(NumberCrunchingTask.CRUNCHED_NUMBER); promise.get(1000, TimeUnit.SECONDS); } @SuppressWarnings("unchecked") @Test public void exceptionHandlerIsCalledWhenPromiseIsFulfilledExceptionally() { Promise promise = new Promise<>(); Consumer exceptionHandler = mock(Consumer.class); promise.onError(exceptionHandler); Exception exception = new Exception("barf!"); promise.fulfillExceptionally(exception); verify(exceptionHandler).accept(eq(exception)); } private static class NumberCrunchingTask implements Callable { private static final Integer CRUNCHED_NUMBER = Integer.MAX_VALUE; @Override public Integer call() throws Exception { // Do number crunching Thread.sleep(100); return CRUNCHED_NUMBER; } } } java-design-patterns-1.16.0/property/000077500000000000000000000000001312550536300175145ustar00rootroot00000000000000java-design-patterns-1.16.0/property/README.md000066400000000000000000000013041312550536300207710ustar00rootroot00000000000000--- layout: pattern title: Property folder: property permalink: /patterns/property/ pumlid: FSV13OCm30NGLTe1YEziumOBKYMEPN-3s9wUUdlltRJst2Izlmx0OYLolihUSEGdGxnEXIXAdODQpul1Jby-UTaasgwBCI2kGOFZ1pAV9ewR1FMVaZwAvUWF categories: Creational tags: - Java - Difficulty-Beginner --- ## Intent Create hierarchy of objects and new objects using already existing objects as parents. ![alt text](./etc/property.png "Property") ## Applicability Use the Property pattern when * when you like to have objects with dynamic set of fields and prototype inheritance ## Real world examples * [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Inheritance_and_the_prototype_chain) prototype inheritance java-design-patterns-1.16.0/property/etc/000077500000000000000000000000001312550536300202675ustar00rootroot00000000000000java-design-patterns-1.16.0/property/etc/property.png000066400000000000000000000470601312550536300226700ustar00rootroot00000000000000PNG  IHDRzMIDATx}{fU}6M?OҤֶNcTB3iT#V;Jˠ/B\  ŞP Z.oUglMO֏s9iIq[}[{_okߟu}"A b@ C 3Z8 ,=!<ZIr!G?Nu <` y@iF\75W y1=qChBC>hz_mFp>a=$[[#<9\ߵ@^CH^0wY?eԅWrHJFZ7XٱVe8pffcsQ!k7搧ZT.P!1P-=n!e:1ƚ|A7uUNrҍO_O\Ow2[3YH^k|;'.ݱ?/dlgH=v5Ly^-|odu5h1 yp`Jw_ul7o|=[O:+.Qd֋]*7n:巜7Ho'X:<ԕWr]˶,2_6+LGX$Gt~GiR.I>(Q `9t`Wza̷}/]56񮱒<4):y|h0cEWce[\?+%=.f-+ck?sos]~x_{ѭ=f~|/XC. ezvw{׎7WQ*`]}z!(c!mዷWc?7ؿl>xNK|%_(zW@ O  2褒A1PSS$+|ge9clk Vz;u֭{#oa1AL<@$6 yH0m@<`ڀ y@i$8%/Xϱ߽ t7ԃW@7 QAbIj]-%vVjܟG~9\,c 9gll{H\nH7W+[N^&ծVK|#䁫p;Ç<Oq,Q=Af^SŏR?r%PVo>rA5;%4HF]&2=[&psA!ig/yj4\$Vfٗb翱soz}gV=_ **m#\&l;p䁫p|InPu+QqQ8{(_+DǘjPCMad ӠH W3|r!6of<)|%i˩^&\+M,C yj,\muyԏ& )~V֒(OHdWFe%P,|~i+2#pI䁫p;h5̯7V[Ks|E5sl#[ș[$5eBx0$\a|܊v^ y.F'}$o W$ H L<@$6h۱9 ,=1Cx [$6 yH0m8J^O1,Iηzu3' >D"y`.\b;Uu@;4g"@f!YphoN<Բ.U->~G>kKoq)tIM[ٍ ]C|`> 9ZIwi@K_**S_E8S\%_>zo^e [rK4Ɋ*jUN/ $ r\/J~ Y ?iaDwOiI 9:U/uq+ =hNV hB{]^Ֆlj]Jܪ}Mυ&=]4d̓LdDŽ^ wxa)*I 7%g 4Z,yY2ozRމjQ9"_WMϩѣ籼,Fv*K^~ri/˜k<\k %oLJ^wy2$ wAwwiv#gm&$Tj(M!K^R'yՃ( |RRvEцr՜CȒ'VI lr-%7'(Y6Ws֋Z$0X?tD  Wɫ9C֗}i]\詤w TG6Z.s^$Cvzxs`ӆ5qEΐicWu(!F8Y׉$i_!ĖC7<U%/9~/oW>-x9EY6D&yԨl =\t} gVFw`Bz\>s/[Gɫ슬qu<b6ziTzJVJ˙7~%A#);rDEޟsϾ.lmg6cUYd6B İK%O+FZ$϶yb "YzNBPRY3I%9.80(yW<7*q'W5ʥ JSBʵ.e[?D%璘߸oz؟lִ4ߣL@E[-CVɍ>r_o{p?Õ_'[)$s곩bڂ虼v&$3.yt'Z(ywpKO->RLִ%FM=df<<Ϙ 1ruٟ~'nϯc O5SVmᫌr]Z&4I|S.y'MfmڪMP-l !5eb9Q<+y WɃ+L}1&K^OpE yPE;z+Z\sR>GWo@^U OVLWE'WdX E5F486Y GH0mkL W]<˕fV9 V!Ƀ+2׏+MBFVk![hU0pDB L?h^苃Ya&xI %+Ƞf^KE} Z G%AaB zAA}[C7Nl ~[ԯFGe5" "xzn]hOs9%]\&L*aqkE`V!Xɛ+r;x^w~H&[cK'~7s'V!Lɛ+|)MVRZ!|qe֗P WdL9{hܻmPҦ2YaX G%oҮ"٪LHq 4Gcl z8gv2K7i"k}V4U:E6Jg@حTD{+}BJ޴]VZ*?1<~ڟ겭 8gH0i"SU7R5DQzpΐ<`4(yɔ]閷tT\YY4V󓮪{s猺<`<)yd]u |ҡ8*7:a4yDAV"knf-\`%o2婐ժI&h{k9A]9~ypE yC}j (@>Wtra+\mF(B51 :ok +Pk =\<)xNL|_){)CiU򪰻"g#aG3ӗt#]-1m/eH0m3"mȒynߖɔ#<"-*y \e ` M$ϒg/n;O/($@k8J^ +YoE?C]^5\Q rDm:}bAcɳ"r$蹼~$WɫhjDUJ(LxPBxH-LK+4$i&ƃs@pȺɰ7OA 9 y8J^ +r  U`bŔM%Xҍ/\g c&ƃs/yEKw c KY9XHCv+[xdç41#x܌Ir 4DcKȎ% W+ɛqVDWЙr 4Fɳ1"@srEֹ-ըW+jlW677/.@s@J+LΞH%Vlew9P\:J5Q@H.@c@J^⊬ ³&y={Gp9S+2-V)$<{e#[l?-me $o%xnp<"Jp7(2F\%3$O苞1ޠ>Xʨ+3c+7[vE&]Υw"8$ԟ]ej)} n  Wɫlb! Drbr%jK{2$6Z\m⫁[I$'| K,!y*y \tHOoEq2&#,]9 y8J^ +2Y+'"Hk\*Q? d KOLT. Z(Ci]kk.O](M\1S eH^2Yv~h,yvWd"jN[pJfPUzKu7 Y%VWdZLuyBjh-yPX,Ƚ@ H^h#yg['NuryPT,b({EծժlVj,AOH my冮:3'Y((yή԰|w׃01#@svEVGY)W # {<}>Ʈu3ky \hhA~$5vEN7r nW頀/@J^,dRm,7Y7dq|S+|-HTeB,۝\[{dBGɃ+\5{fMA{U<LFƄԧr>Xʨ+0SmS4S} FWdV;Ο76z&0w㎄As/[zF?vKLIް)sbƾvL{3ޢ3)3@3sзl .@ (yNZBU^{'^q[J i,*Jҧ:GfOKGwY/<'4U%NRv>=(yiI7$Wsh,K6*$OG>We~9nIeyH^bIκc})?pCCl yP"fd g!B <Y+ٸ3 yP yvWd8nsUN܌L4v$ZƐ<2!yꫯ>p@Y[*LujCg+=W*VFp6!&vLe {p6 Hb`YVWY+ٸ; yqGݳgϩS51K$1B+CxguW x$/XΎ+ՒB!<ũS666.$HS0{G ~.vCx:@$#!e4$R_q3:7/g!벰&3K.@Gt& Hb8|^ yWdR-W̻+JJ/ܶ-nuH3 yqѽ{:&I+2)ؐ8ʂДRP$QNjO<, yBRf9"~y%ޯtW&WsϨX2%|, yA⩧:묳!I^cWdd&7'LIk6LV`C?wV:lBW$4tJi $ϙ,91#|[uyn~BӾ.˙,3CabqE,icB÷nRԛ{8$[XSWQKCP2o`*!,ы}!ܹEJد??gw@lﻍ7 yK =|ũ,++ؽ{'_0ų>cb%s=wkk+?.0ޱ`EF !Lhq>vZ6|+ 3kf0!L1P:JƠi1EټZ,mmٴ\,g>wίx H^1UzYqՂ- ]OG?;P(GcH'w~ɋ3on}(_Ij\ȹ2MǺ-zj˥. 6䊿;]xc[٣?w駟F H^Pe^ݯ^(2ѯιPw^|Jٺ8ɪ5&#a{, {nӖs H^Al%hر#%nQ !tw:U4*AOwӝg7eE@bP%BB. W. kTԵKCJ^peG2ypR=y> yghCf6{%r!^ k^ucĉlw\^˝χOӝD"EJP歸.RQƗ38iVܔԩS{A&ZtL~Ν;1Fx()IrrvCmAۼڭ> H'&5r[5AÝIR_wȑ#͖$oB!s}g]B{k:y'U<7PޞOS=;0#Pg~ w9ʬf]}.!eݬl+H"xCx9 nTG#o+H"?|9V%ZŜMޛ:J^B ܜ+H"3cCUחsKR.>-U-'?Ii݆!|j_Na*sW-wD6C58p d3yZk*k֋W%ef=XQrZJΧjW긜^Ύ*řHG/+54ˍr q-_ky7<:rʆW꣑At%vHbKT*7$IV\?[>)iطKMCKLO| ^gTfT˗fI'}tVY)W(;2O"^ :nNL ٍMKC.{e 68,Pgv4KhmR,< ~yDzJ{E*!z}-SRr4Iy+)8 Vi&y|(X)I%x"#7'Fe4Ƈ䥡ڪ4V뜠44-@_qBQ(!dj RFD3H^J^vUЋ /[fkzGEoX{@c`zCL.|W^+/yQ'*WQ]O2(h2xAS򒬄{_wyҗ6cl`/I蘉%Oeu9cAf4>vEhhKcTSYM%4M$nG@y y勝cQ}II+IF_l2̂X)fl\BO9$ V8} zd0S"̿ -+nOH[)ufeC 8gt@_㇚ZO(s pE5村fwVXN)[H.T;aj$3<9Ry2Pna;/v5*Bɛ$b H^Ͳm6䅁8 y@@#$H^rD]KT< yi"` q ʎ >@P% c6]u~XRK^p%`DM-gBYb̀yH^G lyWn`x靗&Y6ۨJ,gBYώF(4Tf2[]A]5?cS OM/.2l_; +蛏SwV[nVYGp$>emN(IhѨ(ylDljtε.=!~2<~'nɛ obB2T"9NzJQD@A򔢃V6j| yi@\ v9 ɫmgd+廧I `ad:?A)4I}hPpTb$$%n~ŝo7ܒ쳅WV nSY'"NjI]"syYq;KrvW?< (y \]v~[nSIcղ!b{Q":FMb$/YӚWU]yɧ~H{ ,%(;6OKC*y}CjJEvw%?Dt^0uЍpc;zHKZguE^Eb8: yxH^5pELr)21NٱyH^*] } f|Wp"%b644 T"R5ڑܠnQ^Fj-t{ {l8hG&ɼ!R<>xQӟ*$ߘC!y}nIeyȉuFGVry|-ry1*$ߘMJ^LVc\b;9H0ɋaJ^buE_`Xb;= -pB2\E74&d<& yiW`1[ɋ9@0H^OpE3$/[uxKdu?d3n Tngcwʎ >@P% 7Wdyt`%.ky]-Q0v .ꊼ7x44D)'@|䥡J^cWd~s^fj+ywK]K@egWzM&tcQ>I]lܒ!y@@0PY:D=lcuK0CuṋO*$/ "'JsI4ﺼHݒ/y:g3dă b!y0S9&ۼBp:[rgqEn!;&=׻s'Y0Sz]ÀViS7ߛ“lA%VwE6mUɖ[GTIv{\ ^*<&$OJ^hiᇎS["*['#~n 6-ҡ!y$yQC~" P\I bߜ_3dd)E'0^J[q61А3zprm{rcɋ3 java-design-patterns-1.16.0/property/etc/property.urm.puml000066400000000000000000000024631312550536300236610ustar00rootroot00000000000000@startuml package com.iluwatar.property { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Character { - name : String - properties : Map - prototype : Prototype - type : Type + Character() + Character(name : String, prototype : Character) + Character(type : Type, prototype : Prototype) + get(stat : Stats) : Integer + has(stat : Stats) : boolean + name() : String + remove(stat : Stats) + set(stat : Stats, val : Integer) + toString() : String + type() : Type } enum Type { + MAGE {static} + ROGUE {static} + WARRIOR {static} + valueOf(name : String) : Type {static} + values() : Type[] {static} } interface Prototype { + get(Stats) : Integer {abstract} + has(Stats) : boolean {abstract} + remove(Stats) {abstract} + set(Stats, Integer) {abstract} } enum Stats { + AGILITY {static} + ARMOR {static} + ATTACK_POWER {static} + ENERGY {static} + INTELLECT {static} + RAGE {static} + SPIRIT {static} + STRENGTH {static} + valueOf(name : String) : Stats {static} + values() : Stats[] {static} } } Character --> "-prototype" Prototype Type ..+ Character Character --> "-type" Type Character ..|> Prototype @endumljava-design-patterns-1.16.0/property/pom.xml000066400000000000000000000033611312550536300210340ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 property junit junit test java-design-patterns-1.16.0/property/src/000077500000000000000000000000001312550536300203035ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/main/000077500000000000000000000000001312550536300212275ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/main/java/000077500000000000000000000000001312550536300221505ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/main/java/com/000077500000000000000000000000001312550536300227265ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300245565ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/main/java/com/iluwatar/property/000077500000000000000000000000001312550536300264425ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/main/java/com/iluwatar/property/App.java000066400000000000000000000063341312550536300300330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.property; import com.iluwatar.property.Character.Type; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Property pattern is also known as Prototype inheritance. *

* In prototype inheritance instead of classes, as opposite to Java class inheritance, objects are * used to create another objects and object hierarchies. Hierarchies are created using prototype * chain through delegation: every object has link to parent object. Any base (parent) object can be * amended at runtime (by adding or removal of some property), and all child objects will be * affected as result. *

* In this example we demonstrate {@link Character} instantiation using the Property pattern. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { /* set up */ Prototype charProto = new Character(); charProto.set(Stats.STRENGTH, 10); charProto.set(Stats.AGILITY, 10); charProto.set(Stats.ARMOR, 10); charProto.set(Stats.ATTACK_POWER, 10); Character mageProto = new Character(Type.MAGE, charProto); mageProto.set(Stats.INTELLECT, 15); mageProto.set(Stats.SPIRIT, 10); Character warProto = new Character(Type.WARRIOR, charProto); warProto.set(Stats.RAGE, 15); warProto.set(Stats.ARMOR, 15); // boost default armor for warrior Character rogueProto = new Character(Type.ROGUE, charProto); rogueProto.set(Stats.ENERGY, 15); rogueProto.set(Stats.AGILITY, 15); // boost default agility for rogue /* usage */ Character mag = new Character("Player_1", mageProto); mag.set(Stats.ARMOR, 8); LOGGER.info(mag.toString()); Character warrior = new Character("Player_2", warProto); LOGGER.info(warrior.toString()); Character rogue = new Character("Player_3", rogueProto); LOGGER.info(rogue.toString()); Character rogueDouble = new Character("Player_4", rogue); rogueDouble.set(Stats.ATTACK_POWER, 12); LOGGER.info(rogueDouble.toString()); } } java-design-patterns-1.16.0/property/src/main/java/com/iluwatar/property/Character.java000066400000000000000000000066621312550536300312130ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.property; import java.util.HashMap; import java.util.Map; /** * Represents Character in game and his abilities (base stats). */ public class Character implements Prototype { /** * Enumeration of Character types */ public enum Type { WARRIOR, MAGE, ROGUE } private final Prototype prototype; private final Map properties = new HashMap<>(); private String name; private Type type; /** * Constructor */ public Character() { this.prototype = new Prototype() { // Null-value object @Override public Integer get(Stats stat) { return null; } @Override public boolean has(Stats stat) { return false; } @Override public void set(Stats stat, Integer val) {} @Override public void remove(Stats stat) {} }; } public Character(Type type, Prototype prototype) { this.type = type; this.prototype = prototype; } /** * Constructor */ public Character(String name, Character prototype) { this.name = name; this.type = prototype.type; this.prototype = prototype; } public String name() { return name; } public Type type() { return type; } @Override public Integer get(Stats stat) { boolean containsValue = properties.containsKey(stat); if (containsValue) { return properties.get(stat); } else { return prototype.get(stat); } } @Override public boolean has(Stats stat) { return get(stat) != null; } @Override public void set(Stats stat, Integer val) { properties.put(stat, val); } @Override public void remove(Stats stat) { properties.put(stat, null); } @Override public String toString() { StringBuilder builder = new StringBuilder(); if (name != null) { builder.append("Player: ").append(name).append('\n'); } if (type != null) { builder.append("Character type: ").append(type.name()).append('\n'); } builder.append("Stats:\n"); for (Stats stat : Stats.values()) { Integer value = this.get(stat); if (value == null) { continue; } builder.append(" - ").append(stat.name()).append(':').append(value).append('\n'); } return builder.toString(); } } java-design-patterns-1.16.0/property/src/main/java/com/iluwatar/property/Prototype.java000066400000000000000000000025411312550536300313140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.property; /** * Interface for prototype inheritance */ public interface Prototype { Integer get(Stats stat); boolean has(Stats stat); void set(Stats stat, Integer val); void remove(Stats stat); } java-design-patterns-1.16.0/property/src/main/java/com/iluwatar/property/Stats.java000066400000000000000000000024651312550536300304120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.property; /** * All possible attributes that Character can have */ public enum Stats { AGILITY, STRENGTH, ATTACK_POWER, ARMOR, INTELLECT, SPIRIT, ENERGY, RAGE } java-design-patterns-1.16.0/property/src/test/000077500000000000000000000000001312550536300212625ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/test/java/000077500000000000000000000000001312550536300222035ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/test/java/com/000077500000000000000000000000001312550536300227615ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300246115ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/test/java/com/iluwatar/property/000077500000000000000000000000001312550536300264755ustar00rootroot00000000000000java-design-patterns-1.16.0/property/src/test/java/com/iluwatar/property/AppTest.java000066400000000000000000000024751312550536300307300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.property; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/property/src/test/java/com/iluwatar/property/CharacterTest.java000066400000000000000000000101611312550536300320730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.property; import org.junit.Test; import static com.iluwatar.property.Character.Type; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; /** * Date: 12/28/15 - 7:46 PM * * @author Jeroen Meulemeester */ public class CharacterTest { @Test public void testPrototypeStats() throws Exception { final Character prototype = new Character(); for (final Stats stat : Stats.values()) { assertFalse(prototype.has(stat)); assertNull(prototype.get(stat)); final Integer expectedValue = stat.ordinal(); prototype.set(stat, expectedValue); assertTrue(prototype.has(stat)); assertEquals(expectedValue, prototype.get(stat)); prototype.remove(stat); assertFalse(prototype.has(stat)); assertNull(prototype.get(stat)); } } @Test public void testCharacterStats() throws Exception { final Character prototype = new Character(); for (final Stats stat : Stats.values()) { prototype.set(stat, stat.ordinal()); } final Character mage = new Character(Type.MAGE, prototype); for (final Stats stat : Stats.values()) { final Integer expectedValue = stat.ordinal(); assertTrue(mage.has(stat)); assertEquals(expectedValue, mage.get(stat)); } } @Test public void testToString() throws Exception { final Character prototype = new Character(); prototype.set(Stats.ARMOR, 1); prototype.set(Stats.AGILITY, 2); prototype.set(Stats.INTELLECT, 3); assertEquals("Stats:\n - AGILITY:2\n - ARMOR:1\n - INTELLECT:3\n", prototype.toString()); final Character stupid = new Character(Type.ROGUE, prototype); stupid.remove(Stats.INTELLECT); assertEquals("Character type: ROGUE\nStats:\n - AGILITY:2\n - ARMOR:1\n", stupid.toString()); final Character weak = new Character("weak", prototype); weak.remove(Stats.ARMOR); assertEquals("Player: weak\nStats:\n - AGILITY:2\n - INTELLECT:3\n", weak.toString()); } @Test public void testName() throws Exception { final Character prototype = new Character(); prototype.set(Stats.ARMOR, 1); prototype.set(Stats.INTELLECT, 2); assertNull(prototype.name()); final Character stupid = new Character(Type.ROGUE, prototype); stupid.remove(Stats.INTELLECT); assertNull(stupid.name()); final Character weak = new Character("weak", prototype); weak.remove(Stats.ARMOR); assertEquals("weak", weak.name()); } @Test public void testType() throws Exception { final Character prototype = new Character(); prototype.set(Stats.ARMOR, 1); prototype.set(Stats.INTELLECT, 2); assertNull(prototype.type()); final Character stupid = new Character(Type.ROGUE, prototype); stupid.remove(Stats.INTELLECT); assertEquals(Type.ROGUE, stupid.type()); final Character weak = new Character("weak", prototype); weak.remove(Stats.ARMOR); assertNull(weak.type()); } }java-design-patterns-1.16.0/prototype/000077500000000000000000000000001312550536300176755ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/README.md000066400000000000000000000025441312550536300211610ustar00rootroot00000000000000--- layout: pattern title: Prototype folder: prototype permalink: /patterns/prototype/ pumlid: HSV13OCm30NGLM00udktCS62eCInxE-YRj_UUdjlRLfx7fBUbmkmU14vF-Lik7BF4AzJ8OfIvw3Mys6mqyrltWw9Tkfc38XhqE3uWSmd9Zuc9AZ_bVHHB4V_0W00 categories: Creational tags: - Java - Gang Of Four - Difficulty-Beginner --- ## Intent Specify the kinds of objects to create using a prototypical instance, and create new objects by copying this prototype. ![alt text](./etc/prototype_1.png "Prototype") ## Applicability Use the Prototype pattern when a system should be independent of how its products are created, composed and represented; and * when the classes to instantiate are specified at run-time, for example, by dynamic loading; or * to avoid building a class hierarchy of factories that parallels the class hierarchy of products; or * when instances of a class can have one of only a few different combinations of state. It may be more convenient to install a corresponding number of prototypes and clone them rather than instantiating the class manually, each time with the appropriate state ## Real world examples * [java.lang.Object#clone()](http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone%28%29) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/prototype/etc/000077500000000000000000000000001312550536300204505ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/etc/prototype.png000066400000000000000000001115671312550536300232360ustar00rootroot00000000000000PNG  IHDR2>IDATx,W}d^0 l )x=avG/mp5smLƄk0&.ƌ-s y\g#Ziew6&D&HN9TuuuթSUߏ~TWW>:[@N@r175t#dD(:%*G ͺ,E@HA`d H \T,3(!&Yeg% 1pPBRM  K@b:!ޒQ[Nj*iYeRd H \QxY2\y'NW DSǖ K@b:BR3cO9Zւ?:KBDK{0l,V K@b:CR3̪*~>2,BXDcVX$q!N.ҝv-l,VM$H!4}؋@3m3kvLjgP`}N& g6UEc/Au@ CҰ'c;QV7L`Cz3V'=I/(lgb/@T YYEZ"Gv7|=x ]b'auV7!wYEL}ݣ! B]EƜ=.4RwblI %L\RH=^XEQ.&ZCx0apfoMw'#?NUNV K@b:E!7_b1XbDvrt!'?QæJʒq-Au@I51,;,"jb%0XvYE $ K` $@HA`d H \T,3(BUH:u=  K@b:C_ںw^pMW,5Q44,;," IO<0Wlm46W50=U0 $H1$%M{{ғK֣Yb-w^-zY2I5;N\C#% kK%bB~+*6T~oRg% 1pPDZ!/mQ<|`= .y/֑(K4}Owݗʤ$ d bK(".m}zoFHh0`*Չ0\GV&l*,޳8p˒TɞȒ $H+$rVo _s?lѿs 002^w}ɟ-~KG_Mp~K)qtO#.P-:Bwf\yތ/'#m.;y姮}q!;ٟ5'  l{Q|&}ð1'?l*,P'%|Բ$W67wI,l:Ca?[Z @ķ 58Y6ߕV$F1_W)YCCGtTnHJ^y-65ɸQQC~cNVEƻK:l*,Me:dwVqCel-ZUb y)|&%yY\zHK[}#Z ~2AH7Pܫ}{Rz$߰)uPcq5p ?߬``t<7Ar' XB8:qa`Py:)rC5aSq} Yrb 7.0(!tRE%(!'K-h {*&2l:d Au@I51,;,"jb%0XvYE $ K` $@HA`d H \mHj.fMn{L-*i K@b:E!)dadce% 1pPD $e {ܘfc` ܶ4F{xǹ.-nfj1` {=|?ӷ|觃.]:Xv-y66AH \YE!)U0:b ,(:-=d[ %I<'$< n>$Y$%TPd?ӽJ#'kqg0#.m¦|t $BRI}s owDAQnŎfΟ6>UOU Ιä?Sz9٧nB%4% B:7!],,"Ď`Qe#KkbSm[ O byJ.HtK[ȯU< ,K _TH K@b:-ZKX>X2ĘIrO_H OR-ԬNvhbv%I BZJt $-q.1I<ӵ=Vk>յ KOS'e% 1pPDCҘ,L_0Y e% 1pPBRM Yt $@HA`d H \T,3(!&Yeg% 1pPđ#ԀЍj%[ $@H6AғEQ,jef9>_u@I51,;,"jb%0XvYE`\&`; K@R:Xa)(=YAa5t2/Pt:d Au@n\~?*8dYeg% 1pPD0AFqFɬ VH,"&%W5d%d H \1,[2Hmopli&HSX $ܔ% CB\eLf]ln;?N'lZi'ѺW ?͟;-epF^㵷T4r>Џ TaW:@u@!]6m $QD%vhFi^V Y2F =l Lh:AC _8 (S :(æ0-Mo(U;$MoOxtAh~[+XdX{[ǎfUޮ@i*'!s*C93|lIVKįef-x&3"̔b;kE!\焦p"2pPD,˦h%}`biV=s"jhmT+_YWXONZl$:*;J\T&W kk`M$O8 *A3q" $KaX*e,V(q=ql\+RWS9$ 떀"Uq!"v KrocPb>I-ݺ&OVyE $ K1o &lHLn% 1pPDCR  K@b: C/5g K` $$$}I_e2,;,"&% &% K`7("Y-=?o\IaMM8_ad YEI\nRT"&f.*%6Fgb4-&JP%in% 1pPDtHzik$66֒3#BXL10 '[&@a.d욆".iG.qnH,},""Bk~/y49 X%jvrЬaR q \"_[yk, bRȟ̫G Uܰ)4lcXda 3 ~I > , $ Ig__|rпwcYڍ̈  &H\Q82!owrk]^~aSLiJ0__tGp ?.OB[ոi}).q^LoL@Yieb% 1pPDXHO|mÓ/t_|qS H.2|:D*KB:V9 jj$53atҔ.[!=2ۊ[x`7촢udO#+41(",$}C.KN0y3v|WL"[2 e쏼nHH =Szo9;.}KH#7A8gYE37zg?qڸߦabHjp|*yibyCiou?*MHSy5_`rE9[|kyQn6.\ (=@bEȒҐU K@b:݃ۯzS'>Fo_1,p%H,Zy; XvO5fMXD ?*l eIiYyc[K2ӎo%۲(YQ`d H \!K8 6x?QG7[kP!xdUi]7,1gk(KFq)FxR r[imvܸip-41("ZjܨBb9¦it&.!vT#WJ6LkKOς2$|#|& K@b:eRI`u1meIlLgdXYEh: /6띕צlcDZ!p< :6I1,@>PpOlooScg_)&,>hG]6׵7ik[h~ˋ ~%v@:ěG`-LT޴Hjb@,RH,..JCdmJz/vczum I'8%8qO6FoؒQ"B?7n-%I-x8ˀnwAK~ !d?- K@b:C?;m*q+ ~&D^q^G"J!8 6HgwwN-Au0;3q;4\ Úb[:Y%n&.rҙ4I*6p8|xw{VVVsLRr%A\dL~Ĉ%_Au@5۬Vuh1;;>Jh H|Y2YAu@)&aӿǎӳķ\I=0Y-$$HH3L K`Ǐhk% 1pP.[[[6+ &$Bfff|S p&.4YEH58(;2}X $*tnnXDJ bbkknxt:%[ ^ /:9Jr ZfX,l)&E,eB!!=;;;Ngffn&1,J@0S)͊6=a~/=mad nCVzmuWM ,++(YQ>M2*,Lvww{LՊݺ10MJK[D]J`X^@%p RNEʔ/aB"r`Ѳ?s}o\6S?L!y"RKʀ@&S>9H]W&@H!=3%|c7=_8iڠC"ia\dpke6 .6ܯJNd*_zc`n͖+RKJj@t:wqQ֘ i~Izyɒ;~ı3/3CpO@ |{{opiy 8^-ɈG'Ŀow035)ge}Eu eY䝊(qb=[ ^& L>'?i$K;B89gK{:9;C߅_QyFx$K ,=++d \ҤܚdTjY2)6,)&K^Td-4d$Kaeߴy$ TMAA]:^A@zG,988`6̿D"٬Y)?,Wʠ@)_NZd{{-li1mlRUc!TlI0,e޲Qݥʤʣ}58L0Zg)%`M2"$%l1DgM83JQ l6R4 -f}#żS" K$ VMLȒu6ۯn!fۈ)Czd0Y^vm=nADd,$H֒15{AWW@*GXd&Kvvvl%[ 1];OG$K'cƖD+pHs K\QJ d ZD BqgѠh::2y;,>+l~b88q57E.[HJzv uCTIֺm& rQT@f0 M^ <#T:3|ZeAX_~\MBSrdLֶsxxHْ9`1Jʒfw*H@h('T[ x2I@6lnWn8~0s_SY{iGGk-K|)D$0(]%fggjv @p$A ĝo_,b"aR$59x7'}"H~49׬R Y"L5YR)Ƽ@O\@~BSPYIHA b~&K|*d lUW^o8Gku[vdZKBȑ#O )vMǎckt=J.p"T5lu%Q%6ZCDo\U%n 3z`?яu_ngffJj. w*fgg-gߪ\w !N6KUV{nY`5ǔS`)ޞa9iv(;!7bU%,:My$z]C}`KOGH.ME3RLUCm Q&n91:RQG9L>UJ@9ܜ';lߕd!5d tgu4q|"5J e]tm-xEK@)&񱿿رV5e˒ei)2GrcÜ\1=0"Z*JIK@)j6$ !l_T(%{$Hz^vpRtȒv|6RxI)&l^ΘCOSPVIP]aBƐ&eRZ|sss晲bB:jnP X 8T\Pf]\\"4,!@IQYql;_OQ@"5C`XPPUJ 7f!-Oe1},ȓ׀1??ﶙa3(Ɂw:,Iz6i,KSdIe(pp XDRp 8խ7Us d.mgȸ ^uGhl[xhb%JedZܳh:,I ETmXN)G V;[ƅH]R7?YݝCĞwfZl>s>&%oy=PHHeIN,)/dIe(bhv\ Ucr"B\";! ϾpG:[ixG0>Uwv}>=>,2hW{9h\14Ωʗ4,@ɋ"*-TW"}@g߈V .'-CBΩʗ4,@SE1^<" ΞqL;ߧ|gg̴m@Y|@24ߝKҵ+DZ%L| 5җ%:dDzs%l|kI ]AYVR{+z<+JO—+ҞK΂l6z?88Td&KrDp-a;eL\Y"2.0a V^c ;tğG[TzV$|>0"PcF|U{$c}%ڗ4,@9E0**677gggꆤ0 $2H B:Ԉa"BR|A$Y"PibҢDv=33vww50,k,I E(ĤEawppzX[[ $2H NG𖹳_چ $2eQ4S[Q=kkkFKxcJ|\{`YdIe("ߢŗnW?~:}#mS>_+Vםnommp'=05Ydȱ(:tr=g{h{ԏVt8CH67l1BD>|CRGu|o^K߸o6=+e% @ D~{?u7^z?wIztX8pM+bggh|{#C ^ ^Uո;zw5g$wZ9dI]^a:ȅ|'&zpy.!pQc/}oH{3+}m/ɖ ;ӧ7wC` dIe("pŗ?K1Y)~auE~^kl1C&~Y u'Z29W䖖 5w@?h~QUA,I E|śϳ4<COW3: "^ ++*9WMoz1vq}`{-?:HĂMdz#KL*`!Y5VVw, |ѝS:9^,Iv{dI)A\‘+Wnn/%J~;<#7aG'WkU8^?vE.!+++L4-Xhp>0f}[z1ʐַ>݁yPEʅ/}]R b>t!],w9>}wCC! >?½oQ;d_ƮWc{Ng+/h,{n(nE>ђ2Qe^ )Οj| PD.;N\3Wvwp> _'c,ǖnNyP!H*ҢKdI2msXqAZN%|=g)?:Wx/![Y}E2vų__|Wɒ=i'_w=OضfpY"z#(ZR?fx9XqA\‘}O8OGחYcO?aV۷qxGv`픖a!j*=74摊`2gk?}]mCvu돯q%%UʒN\839!K,@y#ǿy-?c7OC[/k^ZD m\Gs.&u΂=|rJ%SY":^_'BW H26Z3詬!iz { CFY}GO͵;n<0_;sg}:L\Q22]yׅmB}yg:k`[dIe("p^y-6퉊S}8AFԸv(T㚬(,^w+ m;:C ~Q2id>* | H26=tr-'fJo7\}O>9}Q3qIdaȐqCel-ZړqUpͼ.G+.2uQm/g>| N?eaf`:!,R((,{MsȅConpUe-_Lv-@Մ'?WAn@ͦ]u7cߤ=&G|qU3mm';af{9XqA Ɇ*K`c!i뚕cO*߼[kگ3nўܳ] J.m,I ET!)MZTL>A0dV4g ܥj,I E(&/*.sIvAmIޛ|0dIe(E&p`YdIe(E&p`YdIe(E&p`YdIe(E&p`YdIe(E&p`YdIe("ۢ\]98=[҆#|> K,@"#|>, K,@hY ÝI7`j}mG-ްVp8ץsK{Nw S!Z{'~90_]K|>= $mNJ EE8р*.߶s1)v KJq.Bw#$q\+`7#'a^%3e6E|>L-K e󑲓dIe(B($8^̕VѲ3{& G2VeiST+9pgJ/'M^ȵ&^p>&6HܤYd#{Sk;2{TdG Y<%x%S{ȯUwj(*|`*Y)+ RvR,I EhQKʊ*v#%'-Z$lOJnש^+FqK8ԩHI $2Q S:C-1Vʶz@K?P8nBbwkɳQ> Z);A$Y"E[7#n}8-%ʞ=祮D׬QEɧ!1P(?2)m eZեLdII-G+.21]QT yZ Gb| SGNJ E ҬWT-)V);A$Y"PibG`|@3+ K,@(41#0 > K,@(41#0 > K,@(41#0 > K,@G\R@7>Pq GATj%,@(4 &!G[\ KPD VCHZy-G+.2HC8 $2HC8 $2Ě>0 K&Y"Pib9M > M+'Ea57 >r,@(41#0 > K,@En\~?*wkɬ |> l% @EQ`?FfG|Vh,I ELp_Z&+D8BdIe(bpdoOqtɛtoplWZ/YQ1 G t6N9{K Ém˹\ѝ>|nMpgr+- m% @:oCI3*M#B_ se** kҞsyw J}c/K $5 1U`MtOnton| gA+ICFYd.<3ϵic* % v 5/.iL,v" ajYR') gaJ7>ƾ t*ҐA$Y""k~/y4mпBʏ!_SΪ#{ 1aKc`mJG33]fqf/> zayK8O]p NRT`ξnT74"{ 7>0K,3!,[g $2V\#igyMoqχ'0m;ّ o 0Van[N *xƾ˜qGrNUx')ؙ/Q=>}t RH.M q*' ~+?OC9} PDXQO|mÓ/ CkjMw'J %2 ÑX>0ȼ z[;.H9NRTpn+G.np_)-ī[M% +PR+.2Voybsw[vi,+ )|%m J4 GbRd"61v;6wXrKcܢ:IQ}CyOw̳xxobIОNz"+B)NCI} PDXQt8sөgz+m)}5)Z+t UΠDp$fU =[/ˑ$AYR ')j._[\#M4jtY>V\e("("{ԉ?&.p]ᛯ7;TgH,pa?aبg^`lN>eusaw\Zԛ[\%MDžj+OgXqApsWhCrd;zufog3`U/TWx|`AXk[x~"M7Wᝤ> k!7w+pAon} FolI( *dpi(dG4*Zg8R +T(ܢ *$ȎYQIɾ ĕacY"GbZx6)Iޛ役L[dIe((E]NKeG;I|cYI\ t!+,I E(*!`L`X $2M810gx h@`Ns2 O0(| MmdQ dIe("vQd`67*|F3"oū-S\T|<(CNlhb$SABUB*Vuu=z#ބ]+jT K,@E]ʾ#rt4[Qޤ0[| 9c:Hjf6)d=:xe9e}-.*jR1m}@ 7r;;H1RK G<{pSo`RhfF4l3altm]njbkTM| PDXQt?sۏ8vìy]:˚V@ ;ҫ@=B.̋c5%;P!aI4 G r ,%qŸHL 0ѺC/%[1obDT>0)mпøW}L5\)(>ʏ +ēH=-r(&\|7w]O{B7nqRe+53XqA'Ο8Iۆ'_)kN_X＂ܑӮdpJ s^l j#E/ ^! (!)LXj>`ͽݎJaגz1U oooVIS1jvܛ8U4zy\AopjSz@: R4!I87SWY@P?(zC.KN0y{:^0:G:ekGB/@Wȹ?'*ǻ[T܀m9iHOI} i7zMH7\rIݞ;ra0/%MC0q5c:/5J|ˀ[byN\ *WI X־T>eoTn颋. +n={gn:SqEM;#"/M'p+54ٝ=s.QC陳5 C҂sW|S?Zp3-WC!}ꅛ|`}}?mlnnzfI_ڦ=_đV m+ʒo* $#7<9ˏOWpdId)pxxHرcXh4Hؠ"*R)aEٻ_mN<}6ߨ:rv_N0pC鑾6.^aWG6DH..8:xLf|@xaPȟz&F%@>@O}S4mƑ#G: L} 4 ܗ=)Z{䭱CB.&iǻd $5@|e$d E*.b*H:?g?n}F#dw{;Bcn^m09IG^9jKͯetW8D]\gHZp>:z[?%Ҝ >P̺޻]Q$ VE/[FvX*>O!Fu\Yo9ǛO%Jї'jA-">b, fsff ᒤRH^b܌%{-i.镾}zr>0^JgwwN-Au8ANXk ~˲`s%)}M5Hu2KĥIRC} Y@XHsssnd/\*n|@/8>h4"ihIDsƯ[A$Y@B a;;;Zi.\Q| X}`{{lJǸ6fw= $2_0-q&(410Lk6[fBu1,I 䬭tMNv(0XYYY\\_k^F1v |dIe$d//rK5"M !) >^ƖGӯdA$Y@j6v{ߕkccc~~^#G. S:>;Er^kkk@ V,dqxxHܜ;tĝk{{hsG?Ƽ4?q\/S4l>s,w{p}zf4ȒdIeL ^a,e@ oxë_tB.좋.;!q~|sE*C/՟ٟMqy|e>;;=,T$YR,I XPtjXW1k666&n!4 %xK/;-qGgN24{Kټܕ ~'Vad 7dT̛hoJR4Ȓ :T'҄y C!#GN?¦8<MBb뛙uGm J띝z2~,f6,"t,۟~}G;CN03 ĭ )ʷGm ݠ܍eߒptBvzg?ޙJ,Ô@h CR#zƹ |]WVVJȝ&j]/…;z'U J;{Q٘F><;;KIڧ+L>'?i$K;B89gK{:9;C߅_QyFx$K d p˒fT*W&pT]Sl7??]M%>?rj&K^-քK -"4șAqdl(ȂjM_6$Qe}詌%dw{MLc3qu^2cwg;3qIA1\%0wi KAJ KY* E?߰B"Ă)y 7e)bST((HlB^y5NsYTƯ[RL,I TI,)\?u*R/.oӳngggDioޭ(\ W}핯|sG@ksq K,Ղ0 ]J)_N0q :gOMQ0z%\wuE @AZTFnMY`%uƛG:`b YdI"eBZ].+hzFmo{W_ͷ 0>h2lx hF\cKH2Y\lOW) $2P ʻv[6Vݺ 96E~^Ъq lxQ8򾲲X~mhXYd(?, iUDs+ѯAS LPWPz*AH"NBkvf;;_=e% @2CA;@;*دJ ġd]sHfY*Ⳃ; LT, vީQlRd (6z=K|S0*TR; J<)rZ,u-vgx)㰽MEީڱKEY_< PH(kU~#z RJǏJfjЧ P<ԙy'$sש;@;0[ʄ9Df HjstPd@"CMݮBߕhcACCT#@z88+P K@aX^^o\z)h* `"Jߕ˅1Z:Pz K@ڪ^:F0&(&;@G*~?0%@k:)ЫAvFI#D!(.%@_666zLJ*cR 5dkkXYaPV.$*, !YB$ThEh2O3Gө`J8<@ugѫ1StM%ݭx)^ pwZ,J888hۍFm>?T}Pn4VJ/% s)q@JeWN44ЕK +WVVN.% C(&0a`%"i"@{z`' lYY4\ֱIF0j4XH e eNl@1% }^* $vvv]‚oG~vv+@4988hUPcAq"@SI@Е+*;t z-qh6S%A4scE4)|YYRy0Pammn )䝊RjNJ^)2Yӫ k*hBy}DNE>=MXdd H0YǤM%@Ƈ2 ڀ,I0 6Ѡ$;0D[gDŽ2H01^IxO 3a`LAIMt:yHJIP KPnѯ4+++y Tk`  r%My1T,q}vv材BO/n alll睊":$HHE%ﴀbYƳcF:1V *.@4hRK U$ayyU S2fީ`6< (CoY, ɒ_ 7 L 7 3-G0dnE05Ot#Z>AhmyқsXC1E05Oэh4NG DkSަE׃Pæ7xL`doɨ- ?Cw5 =YsxxHjdnn5+bymhұ yfFl<6I|cT*Y2\y'*ڭRܬ Vb~m(WY< nz>]%e2%fu1ZG{]\Xڋ?ۓv0]%."}@1*EA_`4M&>\׋^#3j,ws\=̯q!N.ҝvYBa=YFoi ]xEV/69M~_66Vl!7Ґ%vB7Cz|9H9 &f1[&.iD3SNq{҅yzvXi."UP'cIQ6"U~UOۤ6>0YC|5, k6ۜ$?ΣQhlHVIOh ;CInOZsL<=? B$n۔ߋWU< nیnnnj,!7th-g`‘1[aK~.HwX6Bxj?O%&cx&Uok>>(^kD?k3^>v솅㻊ΞqsL; _.< "S? nmE\!a3;v,>]m-,zv/Cͦ+vvm ı[Ž<ߚ4ͻw'{tgfZ__ڮхW`&.vnS=/_We4j ABdnnn>]miZdy]ee1X4ױDŽ\LINĦ}6VEy? }$1px~UEOd;;;O4|#a!6{cYyX/1xl (AhmݭF1zy/1xlJ888 :d֖%B+i+݂y/1x,١PnOԧ >Ahm>7Pæ7xL`)Z^_YY K~2 c`xt j(ait}`qq1f'Y|t~^___O<-Mo"6J K.[99L|@b6`j X-m*m-YK[7|ΫnSWiOyE}1?>mi|غf1f%ou}Owݗmv&Kc._}3àn7͝LinlO ߪc4% 獞Jwjm|`yy7Vj`S)%/E"gy\;{HPrM]Js+J)ӆ %l"N);'e"|Rl'*OyK] ܬH!c(;򁏕T7v[{לbtD*}Uj6%qbYGo~׶>Ϯn=7h>q܊r𸓻|Ù5#kwT/ݥje!@!'7t>|{&݃~<d'Sx ڼGCs @A'(.N/dI˧>VbOS8]e, gXQs eZ677Y}8~зu q_,SI0AqzHq喺C/I^ٵcAT4 ?dBC\啋_MB9gwgvfΞݝ\ݝ3@_ D{vKx|{Ŀ秾g }DfZX=TYސ`K_UA̓BB :$>xߞ>q+`}%j>*-* 27<՚jDnKZꪡYcC8iIKJ沪44kꓷڸeq2okgK)~B`}T)mֺm>z[c>[2Ϻtw?;< @BJ\26R4&-&ρ84䨴.Kp Ah2|l6J1- \]"8AEȏ mLվx@ D0..r"G`ل[(Ep AdnIТ" .(B~iM%A\'!@6-.r"G`ل[(Ep AdnblrW; Tt6[ނMgm.E+2P Clx-Tm9PDN&( ɕIuL+lώj{ʔ]Mg,rqŶ~r[mkzX)+Ι/"IE[įLv9vfmj^~t6+"eFy< P'`(61SWp6i`CƆ-rȩia29Ump2v~;J[ek͒ 9/2D3fyGwCEkIgXc]q]8p"I6T#A`c:kJyGue_S\MU^~2tq'iȩҎJqf%63-d3ćYtbd*V8"pI 0xawKx62N~>-1VvwESb=KU) BT.aq6c+EpW6a T#a`c#ޒfw\pGr $َ.Ӣ{x^P񨈉 X) 4P ߖI[TRlt]qهD;ʹvN?|]TIZqZl BT.Ɓq6b-EpW6mFF3q0JhHx3rl2iEQ ө6;bQm?WۊY9c/P12q6b3Ep Wa6ma|llx_ddim:ʻ:]+Ԣ"B( S \邴606 r̅y(dlEMMPRJ xiݒDE.]P pKENPwA#HC0l- Z]"8AEȏ $hQtu!?4&[r]"!(0YBE?0@ zKou!?4Ȧ-q,.r"G`ل[(Ep AdnIТ" .(B~iMfO |Fp pB'@'Ak7 Ap AdBENPwA#HC0l- Z]"8AEȏ [2짾ꧣObȂ]P %`/bcILQ]]p AdS?ndo)%ETta`D .(B~iM%GÔ_;C69h[=mOfiks*$,$BP"'m F;bvŞE4#Jgna$BQeuj:6p5b%mM iۧJ L ڶ W6zĵvuyT<3+VpokϡK;JZ@ņpҦUdtGj/^M֤3`EN \WnlO&8+020޶l%޽xރrJlO\i3/y A Ygy<d9YkުmAHc2$BQ \AZLiLljAQ+}6PΆ[O:}.pQl|7o~H2P~SuPtJq2W>Y($ɏڸ~9@`it"wƲ@ņp"RL{EȢ,(׿: 2rEYjS6)S^ :&6KJ[IR X LR m@3nw^:ƙ7?R)vjBY(CU^J\;L S]'>zόnn@FqҪ*/䍢7 # (v-p.ow16PԱ+Hm#6TWDև{k- ԋXm-hvKxvr:?N%ZA\Г^oLeB \]'e "INZӬ2[cD[Gi18 aEk!6d|  _&Vzj@#n/x꙳7tN?Nc▨~_Yufi|bn eBFsup-LV_Lxd)rm m2[!ã="&-ڷmf]>yώ 7'6]:%v:M3*2I\uF/˕NsphL`ub`ga+} BP"'mݒP1`N+bEka6KQŭ XmNl8}~>vօo?#6znnJ_DIWVh<ͺD3.|$zǶle*䤵[Uet=bAwGm܄obhޭ+Hs$mݶMɒՏmȀyompau'oO&6 ]K(sѭ9OA8cy͹$Ŭoy8f'63P7jZɑTl'yiSL[/YZDv&*CU9ֺm#87`ylWfim{ L TVm-Xg9X\4)ħ&(Wr Ц 6-tK ]pW`S4iV[1006m[R8Gw;bBxVE+ItAj?o…ݒEE.]P pKENPwA#HC0l?}'w?oG")00u!?4Ȧn}|%7˿~SEF"G`ԏ["Y|[JI]Qp Adny!󺧦0/%O\wzhϡd) LE NQl;yYE4Khjcܥ׬LBHzUٲNg{\qG鑶N㡖wkYZ5%n:eG/TTA\+Ts"7잧MF<zGgmd}H'm bDiEVLwbu[XN:Pm](w*إ(;J֍D́vk-k 02be`޽R?%޽xރrJlO\Jio3Wcɳ-lm` {Հ=,[d*"Ipj_W3scdFQ7 RHk_g{6[/W R 0ce鉊R?8%ɫӷ>zņ)sCR:E2+CY()*w@RbdKeVs " _Tg N[قEK$ȶ.O5)r~$oEw]B VgŞ9IO$]Y?DjL2ж0"%թ~hvKξ҉7μBOSm-UqՓ<H/N 4"qҪ0Ϋ>jLja(Ue8u4V[֮LIzu,إ(;JCyI$ sE4tvO >k1+f{ t,>Q r*Ǵ(\&ꖪ 1MZn[:63P5j%Gd"'I8*jlGSU,ja2ەfLZ2 %QԱbP(9Z7ц|<ʫ4SSfЄY˦O*BOSrH}98Y-i(t*tI(HEϕ.H뤆x4yֱ00R? ^ 7fM.8 CaSiekG`$,UCQT %A9d@WT肓`65AQ+].hqPs&nwH!8 $FQtu!?4&ܒEE.]P pKENPwA#HC0l- Z]"8AEȏ $hQtu!?4&_nɊUHk9π8rZh L%UtaNd6?[oNä47/:SPd+HV\P]dSK [RlXVLy<E ,2(\ęH-*N3-&Ѡ"OAݔϵImŚt>`ꖜ{{)lʔE" -ܒd9ɟZT$Ѡ"(#H3ʑ*Ţ: 0Н 'ן:yuG]?-FZK':ZTEF{{Ω볉\W50oʫwW9E%kaN$꺋g_SAcg:ɮؘ2|NP J("H Z:t, +6ݝU/MA-9K'8W ]?N5ZGw[etW2ӫ6˼z볉@4|WP`:iq|[iWx0p2 'Ru_7:݄GdMR҂&mGuz]J2|_ܒ;u~OS]V͊gi}! Ү)/o)9@ ɀ̫nj o*5R"Tn97PE4i?N.SI:B/# 0F[r'z썧3OScWr]`)=șڦvJ۔[:` d@N娛;&<)iJz=  -t3ȼկYM0s``lmrKN_{ۻps{bإSbmMoh6tnor3Tn BYoSfڭ6SA-m>g&Y> dNd^ZYmevׄ-%,Evz EPiAV13\ +ۦ``|mᖌyRE'EFAQ4ʐ?sKO ۖINE\'I AEPԳ ͢aH3F[06}a€&8qE lb-p [9" .(B~iM%A\'!@6-.r"G`ل[(Ep AdnIТ" .(B~iMc%Ղ/. ]z O)naNďEݾ0FOnÍN 2.s4+%=s@8#(,(ruV ꖜ{{)ٴ5&5^9@ @$HHpa-yN^k?(6OfEamOAӶLvܜTV)w+N]Z\E6Ie!A'%s@8#("H4600nm-9K'8W ]?NK?`ZOY~Șf/پ̬"VWW\^d)< AAѶqkvnN:Ri5[݄E#E|%JVq % INQ'x0p'~EPiFƭmڹ%wxѫgx:9W;fSnIY`3Y M6خl'x0p'~EPiFƭmڹ%=w ]=q)j67yYfNl~Rғy<8?"(4Hm6gOK.!~Y-UeH^Y돽󒒞9@ AAmi=y|5a\E&K9mYU;3IIjE|2'pGPEim``fk $lUqSJz10"8h dQѾ 0Fn!Umm[WJz00'pGPvP$HlIpa#Zw-J\I[Js@8#(n;(ruo [(Ep AdnIТ" .(B~iM%A\'!@6ݒ! 1F(" F-l@ BpK@ @ @ yIENDB`java-design-patterns-1.16.0/prototype/etc/prototype.ucls000066400000000000000000000254741312550536300234210ustar00rootroot00000000000000 java-design-patterns-1.16.0/prototype/etc/prototype.urm.puml000066400000000000000000000033111312550536300242140ustar00rootroot00000000000000@startuml package com.iluwatar.prototype { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } abstract class Beast { + Beast() + clone() : Beast {abstract} } class ElfBeast { + ElfBeast() + clone() : Beast + toString() : String } class ElfMage { + ElfMage() + clone() : Mage + toString() : String } class ElfWarlord { + ElfWarlord() + clone() : Warlord + toString() : String } interface HeroFactory { + createBeast() : Beast {abstract} + createMage() : Mage {abstract} + createWarlord() : Warlord {abstract} } class HeroFactoryImpl { - beast : Beast - mage : Mage - warlord : Warlord + HeroFactoryImpl(mage : Mage, warlord : Warlord, beast : Beast) + createBeast() : Beast + createMage() : Mage + createWarlord() : Warlord } abstract class Mage { + Mage() + clone() : Mage {abstract} } class OrcBeast { + OrcBeast() + clone() : Beast + toString() : String } class OrcMage { + OrcMage() + clone() : Mage + toString() : String } class OrcWarlord { + OrcWarlord() + clone() : Warlord + toString() : String } abstract class Prototype { + Prototype() + clone() : Object {abstract} } abstract class Warlord { + Warlord() + clone() : Warlord {abstract} } } HeroFactoryImpl --> "-beast" Beast HeroFactoryImpl --> "-warlord" Warlord HeroFactoryImpl --> "-mage" Mage Beast --|> Prototype ElfBeast --|> Beast ElfMage --|> Mage ElfWarlord --|> Warlord HeroFactoryImpl ..|> HeroFactory Mage --|> Prototype OrcBeast --|> Beast OrcMage --|> Mage OrcWarlord --|> Warlord Warlord --|> Prototype @endumljava-design-patterns-1.16.0/prototype/etc/prototype_1.png000066400000000000000000002766041312550536300234620ustar00rootroot00000000000000PNG  IHDRv}KIDATxXUAņ%hDj *h RDcl!(c؍ %X%AA`A("Bb5Ƙc%ޮbA7VEayއ̙3g;eB!].kdd633x0ǎ ֶCٲe-ЕXԢn#FZ!6et e+iQ,UBkKvA\jժ9u*^GEaLȑ (Öusܨ^^D>xw͚ɲʹ- S\ٙ3]I;' rew&11}Ȩ\p;oLL-_Wj4خ_OCWhw(>6/QI"al^E%$AD.!ݕq9q"5ohHxO*&wfTZƍTf&#cef UjEFNj׮B{(ʗ/]ݖ-͛%;|Fzxg뮤Ebh0W Q6]:;;4lXwٲqg԰grOS: Ax{w ٶmד jmQh#j~m}u6m$ =Hq|2,J4S(Յ{TCccp,A4Eb0W Q6E#=<׬ivի'o0򲢣7i7մio߮v۸1X(f%)E%'wu_^RMX/ߡhvlRbblkHil%-J);=Qv%ܨs_nJ_4ZhtϞUW||\D%m3͚M5{BWfTbrh%kQ嗸OCyԨvj OE\%D~Q7nzxDҺu& fT_{we^Ģە/otDI66ₙE 4@ׯ/PitǠE(=u֭4;'H^^J/L6/ OTeݾW;,E(>-\%DТJ_ТQ UB --\%DТJ_ТQ UB --\%DE}~UxXA ގ2j;hQ(*!ʦH-jÊ O?13SʨAFǏk^%Doꑗ:/iA"D)0W Q6EgQP>[osQQSQ9wHGǦff:uuNP!ڵ[ZxNQ~tg_ϜIDʗ7BW͛D]:tdNΟ? qq!(B *!ʦ,jܐ(QXWSbr[haQc8WDٲeEZAw4lXٳUfAbErB]6uj*T0BspE-^zd.R^Iz Awvb&aWm6CA+ֶx`A+< 7kxlR^^Z!*!ʦ,ʿWGGE!ĺIL~!ޱ ,j׮(t<8PRŚ5CDw_e?-F`KNff*j/Pvm!j(KP(Q uԩ.}wV1s璠SuL"ꝜZ+O"DA0W Q6Ew-;Gu%n:(_hkQy"¢B۶Ǝ?K:>Yh!11NbRHK|',jΜA"ЃhyNzLL0yrHU\ݨQ=ͭ˖-ciY 7}@nұR!#SpDqeE!\%DE=sw׏69M}uϠf_>B߾]%[Of M jU$lX-Ȣ֬ѣ| :th ʭ[ۊfÆl߾_51L+6mPK"R(Z! J)"B_G_MxiS߭zo\:, Tzĉ&|(\hHέELLQۢf !@NwpX9)0ӬYCTbm}ԣ2+kjѻwgc+'Т!UBMYAݿ0,y°"5 ۢP/7$0mMwo>]LM@=kժҬ,ٳ]1l2(͎MV* :\݄ ZEmJlڕ+iQ*!ʦH-Js}6?XSK,mu|Q ݻYniFr7XʨLER`lڢ"ӗE\۽{QER`lhQiiKk׮nmm1^-\%DТJ_ТQ UB --\%DТJ_ТQ UB --\%DٔJ=a‡11S۷.]:VRE(RiQxE:~=;}[ (BseS-ɓC>]9Q>tӧKFJ4HN?p`7mU&bR;v, .,j۶9sD\]okD,jus|yW߾]{pnٲ8`aaaÌ[4fm>LK[EralJEEEMB##'-X0j1yjx<_P iڴ 2KA=,Jӧwk<~%;$-\%DٔXb:hQ(*!ʆUER`lhQ/hQ(*!ʆUER`lʖ-CJxO[B^*!ʦ E(kQ(*!ʆUER`lhQ/hQ(*!ʆUER`l]NR`lZT2EB`lhQ/hQ(*!ʆUER`lhQ/hQ(*!ʆUER`lhQ3oF`^=hQ(*!ʦXԌu|2^9lXOT^}?/yyYż(BseS,ɓC$Fv.<\_K@t^ǜ8;d(ƆDDڋ"hQ(*!FEMHY\a ?d8ɩEݺ5F :v,f`O۟ڵ=bS7Z9|8 5}t0ll,F{xQ@+'RSxK!b۶9ְsGvFTʎ)%%Bss3|{QvefFiQ2UB3npǿ^&5\fMׯzyuYcǂWS*W6 xq_c`S!GlyHnu+ @oE]$:GxlOoOkƮAti yBaOQE!\%DdQcv/pt?ITٲ%yDܹG7¢`&2rRvIG{*Q>q"۷ºZhRFOv1gAMkyyYf pٲqb_~9Uxl.QF]4YkEb0W Q6YL}Dz/Xm}Q6mNRH=˙>͚5T(EǠهAJYGTrNUҥ]-1m4o8fLQ<=RR"D977c<%a(BseâzČ?~/#I8׬i5T/A #rCwXpjJ&11/>v,rTecjƉOfϚ ToO1~y{wZWHަݷmK?iQ(*!Fǯ˻sm](`RMDD_OU?ߋUkcc`-|Ժu& fTã4S+W6"ۧ ibbliY Xl\U @'9KVZ޽(WwO#ED(w:4O@ĿƓ'`Wy4[RxIA<7d,h8tMfrllT.9#ED(p͒Ϟt$ΝKt-\%DТ^0~)&+kk{g^1hQ(*!ʆUER`lhQ/hQ(*!ʆUER`lhQ/hQ(*!ʆUER`lhQ3oF`^=hQ(*!ʦXԌ_1ʕMիWڵͿq?/#\m=hQ(*!ʦ$X4bٹc͙3ѱk\Cxؐ\{Q-\%D趨 )`Pmp*'u17ر==<ֿwoFJ{{k33S^Dtt;;+S7Z9|8 5}t0ll,F{uA.iٲ(`yyY$4_vx'kt5m]EvZ! seâzČ?~/#I.Y,*j^^""rr cǂWS*W6 xq_c`SaGlynQyVޮ\٭𘰰PI>jԨ/:vt O" ٳԨ_ҥ5 ?;}zkQE!\%DdQcv/pt?ITٲ%yDܹG7¢&2rRvIG@P(ܾբE#7\۷k~ﹹ]o6A>D…5jTQ(__k?&tEP(BseSEtI IT REiӆԩ.ϞLoccIggf["ߩA*T0m/ӧS 67jff:jPiYYI1v4ְ"Z;-J)Ȣ,41?&/&Qf:؋ٳIᰨMR v@27i7&)ih,Y"/nnƍyyYv-lРnd$i"ȍF z,E\%DdQgDOg=PpYJ6Wɓq(ApPu=Tbrcb[h{XhtϞQqiR466p.E\A+'`.7?*jj׮m0nnm1QV2:6Mo]¾}+]SkEb0W Q6:~]uݧkV Fm""LM߰pwowzE/VaCkPuh޺IgVT cN^Dx_IL  7VVu,,=<߽FV+EhYj{ln^5%%N"Đalt`tR(Bt !hEIq7x5uuYNpP[66>AgenѢ޷-0C)Z >޾}Q+_E ٭(fxz:O:,c؄VEf!EK鶨;w#"7q9s&QG-*:zZ ٲ%TLJ-L}FF]#\+%%BC^^֐!^ffD୭-!XJt-0C)ZJEAY>oZ`?N먔B(̂9eRn5˫hY3YhР$a/:vt~=ɸʕM~=AFŇFatT֠Ef!EKi0#rK}J)$s'ĉXU#"ܺVݻ鹹UVq#UP{{kٱI%öms_>DH `g,A"D7BjQ]:;;4lXwٲqg!YԳg9ӧX֩S5k(x{w xz:<.L?o211F_ݬR(>͞2eyU33Q>6iנM`AlXle)Z!aRbq`G5Z#[z f򲢣7i TӦ RP}m`UOdx8bEH&>~o͐,J4q#À5hP72rvMvZ ޿leZ!aRzqF!+ڕpΝ[߻ݺ)[~Ѣ={vT_+qW&tnfRX1ʪαc1|űZsڵ(vɓCtsk gҮ1xVEf!EXq#ã}Ŋff._պu& fT_{weͤ4FUb>HK(V/ s Ʀ]-0C)ZhQ"nJӸ/ri&nR=~]*!zSk[IKn +Cr>+(nޫ1((b*6k2O>ss1zb' ׿c}RQ9jpu]ݺ5 ŋ;G$ B[ٲejԨRA Kr(\-c9z}8iߩ4-ujҔCzW<lٸk?iӬueaa^%Z!DʐW<=}}ÇtWv<س[7Gqwf<=Z:,cuQД|6hH9kĀd߂Ƿ׭?왍C7N붨+Wv~j*7nl6T7.Ǿ'xWʹsG::6533ԩ߮z%{~ߵvꖖ;^S߻Ùׯ=bD3gޮʗ7BW͛D]:tdNΟ? qq!ul*LH?Tɩѓ, bzy>z_aQ`΅:(nm+6EH)2糄0|\txVJ)$s'ĉXU#"L8RSj7ReIs$a۶9/| ~0![#6Gᗥ[TAxOJўuenNsz!6~ptGu"k_ž4OCXܹ#Qh۶رgI' M133=$&cIL rE͙3; ZbW 'խ[m3G%O颽icC@QZd ƍ-ENZbU([7}E!#s¤XEH)2p3|vvve0RdQ8:OoccC97kP4􂚉M,."P*5)SWŹaԨM5ĀM`AlXl%…[Ѝ:;b{92nʢ/M~pu^n D)ґ*&}}$>T/onǒ~uFa]nnm/ ^|9cS_3.u$t (li[|Qܹ5&Ҳ%k46 ҙEH)2UgFzxYС5WOްa*ʼM4V|^oڴX շoW|(+V4h'7߬#dQ=4Akbe+y.4%ߢ;c=SUC>Ou/޹`a Q(`_} jU$lX-Ȣ֬zؓQSlذ7?~+)%>0XTu;H%8K+Q\5, PL"(BJ!~>;ztJ_nοh=;HѦ^=siXG3)VoeUرUY]JZl8c4Ngw8v kNGBS- 1+yn1-9tr\:, Tzb„p)uEvf^&&(K_dQ| OO';8Ti֬'S( QdѱR!z,h UvuͰbZ!ʐ"=ñGqdt.|>nҤف*UhQLI>jԨ^*&ćiɢd{˂ZAp`l5< (UH9L{5(FCTϻw} $0mMg>}zתUYYĿ͎M`™MZ֭aĦߏ kQH?1#>M-RaeH1nJӸ/ri&nR= mDm/맕QB!BXgR0 Q".޽[BKn +Cx>Q^HK[ZvukkGJ?;:HWb0 эaeg< ? /!1 G{C%D7!<(\pc(7ư2$Ͼ;QԘKڇ\<B"Gᒰ1 /!1 ,dRSW'%N!=P_"gG(4x^Wj">~ OWNn޻tXoRKn +C{>*6k2O>ss1zb'Yڱcg+~'?rɩ_C{@w:\{-J;ư2D糡'u 5h'wH;sdܔE_G>ͳeߘK$QqgrtQX_Т윷o}nOMר =_BtcXѳةϪ!':uiH\^wY0W[*V4F KPH\.;{꟫VUjiQX_Т /!1 lVbiݺ-=bZr= ~9~፹R+cٳ#*%R'L尰*5ҞţE1_BtcXTaz+w0E5 hCML Wܺ5 66w念C^e˖A|DX,:%D7!%|ݱ>twK?GO[c$u FKn +CJL]^|Bܵ%W DHư2L܌4~5Y(}Q::aV|ƣpý`x.~1_BtcX:rKn +Cx>Qˉr эaeH%X {.mE1%D7!8=zt077-zmQX /!1 )ٓ'}vm9rdÇF}ԧOh<nۼ[VM,gg#vX:\XԶmsBo['NĢ[7˗w۵G-OTb 6̸u+Mc0˴< (rKn +C|5 ~`#ի)[ۢyp,B6m+ zPFO"BaʔX033α~NHӧ6iwҵ(Y!u*=Ni֌wn*((ư2,j7KÆ빢;Mk;,jLO_G7IZD֢u__ɓm6<XѥK n*5ҞGbλ+b{Kn +CRR"FŸ~=n@ĉgTV9// %j`QJH A?F RXN-<9Ԯ]3ݻв%KƨK<ĉX ڳ`Q0(E-a͛})t_BtcXR O ݻ[ۜu$98XßTZԕ+ע_OٳA AUd NNN-;wQ =UD]tIU,*77_KjxqP΅~; R+/`̘]p_}+ `V-I`'cC[H׵:.[6Nc:idT>1 mV65koYU[^}>tإpaXRlOcٳBvy4tǏdggQ?,jժGVwWF, B/3nVZ,ĉXU\z̥`ggz-*,lĀjD߶۷ϓ/8, ox#N Ň 6T/_\vrF*ZEaŵaQ I%EOo%&<צ]u zyTT…(&=:8`GǦX_ iozK5jTPIXEMQFMʎ_vTxS:vt" Jy._B^ ZT^3gx \lٙ/1 J8$*6DtRXTdvݹQ8}e-B@腰(M]]EऎĽ`T%q߲%yhёY}g<:U,DfQ&&Ƣٸqj66(_H|aP+ID!!С5 A<ۏfʮH #+J֢گ{nnmk׮.'Ɏ_vT۶&''ǫPi}E.]AT>.[/q+<QEظ˻d{ְ3k׮ިQ=?^Т0[0,c.ZW,5`̰ɢdW,=}9ls¢d_FUH_OF^NuF:N֢S !%#mV-XrUTԮ]`.*k( +jolR8 +ChQs.sm](`R[|P̭Zҽ{ 6 )!uu;PV$Qw)l5]:>>r ~͑ 7milљ3{.-[B z_7nEv<~qwn ;ܹ?7466DeZT=qml,x_gr:uj)Qlܿaaa>s氹sG6lXwǎ:[7E/cqܹdz/!1 ˋCu6e Ϣ`90ė]ڵ=[nO1YY 7Kvm0cٲqF e-; -VL0:rKn +Cx>Q^Pn0 эaeg< ? /!1 ysa< ZC%D7!/~>{𧈿QL0-`ʐ(E_Q̛7~QE o/5%D7!nQOf[ZPر~1DzD)KE͘AY'cÆ,ײv}1Q`ʐWF/-mwiРƃ_0N2KccC""~Q) Y\\z̥G@t^zW /!1 }>X<U.#MfM<(4t9~]47ڳgGqܗDxz:DrnnƛoxF _fip*'u174رWmm߻?#c˵k{"a!ojespjaX"t>+WN=. **ZaTT+:[AѱۛWMI(3^%ư2DN'?@TXw%bӦY"Kq({C1<9ҨDӧ.;4:+0:rKn +Cx>Q^Pn0 эaeg< ? /!1 yޜr-(/#GaZC%D7!/eQ'?є< Ӣ /!1 )EC>̼yippX/E-CŶg2^$ư2hر~1{Y[[ԭ[F*omwXh0cG_[@o*hѨwεjUJ<8!//umWffdV6< kSB,J{Gqٲq0SFF垫5YYw4 {f VEI=.^ܩCxժUNO_ӧً5lȾT"fӕ*.AkhQQ,JvG",lĀjDxܾ}T(R.%a_BtcX|6!ex *E?ՠA#F^[[| vqieaahhxtt;;+S7p=|8JbO~Y_,`O锒No w2ӧ lcc==3npǿ^_\-C8.-[^_lܼ*Dэ03Oȑ 7o~Q-W,ŝ0ݝJ+W6.|a%K`֭4FF傃ر@wOoY,11ɸ6me- ѥKkPX3,5˫Y3̙*UL֯v\rQ_υL:Lj4[wxk""Ҟpj v`~~*+J;C{zJ/\؁tѣnYMSS>J޲}F=̒0B /!1 )|6f¾qA GWDz((o΢ ;wœ(:qVםU+ܬYCpJZ}}g%.qtwl8WWGQSu[ڵK'wss3S 10DFNԩE*{ݖ-͛%85þcggJ]QڑdAxxOH;th{ｃIAǺϐS}$0cgsAc 6ư2L}Dz((O?a‡ϞnQNugg!4#׋.pIJNol\-Jznnj?iGu[ S VLoqq!۶p"0~@N^KU/=aڴ!8cޙŴjv\le_SHDT"ڲТR.B%)!J$%-uo֛kgZIi\<LK) l@CK11)j|Ӱ-qasM,0C?ڵ|4ͯ;vAA뉱NEu!!ǍG//&&8B  C8(Aǒ` ի#`{dOF<`-)ԑIY i*-M5uOO HGdsN>Nlcc 28̟! @K%%0KR˻wT Cd0a(gVo1ڵCA㊊=UzP9 !-ÃrѯKw@{(³xLQjQ߱]JBy9KGBUU&h<rJTUvvp$3I( eS q.4uda4|baqV:C8M$N '\Zaaի|zj|Q,7eЍ1JF7UR?`SZ}}ޡ<r>ޜc|.pd iuBC56 ~"*J)9y/IQ !!&N(ի$|DM# 92qcu&tjNUE0Eqgwdg z,l\>8}!8᫰:lkux>갉  _&_,,j_gg*,|>8}!; ak4(lbk0Eaaq>C+LQ`55Y?^A;{Y Dvt/.R`r&&,G\~_EUW_GEhc0Eaaq>C+Q(mĔs/۽{ȑ8/BO{Zc8 !XXgtz (\~dAjjJ+V,s'bL߾**223kKڡ)-Ð! 5gO7tu5 "dKM=8x*s]]6p4իJ--«C+++TУ"bm8 !XX!nL4x|d{IIոuyy<<$'ᲬTLǛ7::NE/y8#??+ff#, ܀޿}1~~+AA9kxp y$1jȷ&N }<}zNУ"bm8 !XXUS۾oBa*mΞ8'T~*@Q&4m`zzP NCӧ@]a~\qܹ&M2eT'$RKJ& CMP޹Nq\/nf&I$ 8n>*|y11(-THQQ;Ӻ\5&rT_UYZZW}>--P7bD"J͟oS[LQ"':%X5u[k#PIn߱]JBy9K '' A=߿vPaccKJvy"c>| ,m}KݘHw0*LCYX~= ׮*.NZcDMDg`gtKPI6뤥V77]RJ(f00 @Ck"#ӵ2aΝ%<8;$ D_W pba1tC23en2PVQvrG*,ֆ)JԄ)JN|`a Vzk/ATsX*!KS#:eggjN&[k SI)åL4 S^뭱1h˗lhhU.a0Es= 5EcI߾tu5֬^-i+) fa{7.)qq  Sד t*NQff#KKWʴv<?(֭ŋ{)D~۷Pr]2EqZpV!~ӧ),, S65LQ&',kGǏ8TFP"#ݭơsL BٌkiiQFP%`A˗πՁUPS!XX(lkDM<\O$$:'ge$(ʷI}^U٭Lii*e3})}#(++E~l>C+LQ0Ex\Рwo (IS|[Xo`K˱ ͐ݿJJJRK(?|xA(._K^yXXXV AY)S!XX~c_` YZƍP 1({eXؖPYTԹD]]65Y &fjkvD GۣrUU&AQ\&7(8@S˗/˫Q8cJ g,,,vݾ} {%ф C+*2""4.hӳ JrT3ڨzN B==MJr|-{ γ GY) Kl)%))Y]]-vܹpBጅŮS+-Mӵ4]SB59s*shFۢ>}zI֭y,|- jo*((ppƪPSSupb@) YYYK%ʷ7PʨZLQXXXmG¼b+--pǎ344pXXd a¢MB߽{'6"!LQڲ|# ԳgW^ sīWO ) SVoD 9"hԩXX0EaaaY FHGGѣGBÇJJJ?~X\0EaaaMr# ԿyPЊ+X\wEN r7=v0Eaaa I܈ <8??_~AIIɓ'J@rr[dP= YZfJO䖏ǡQDKb.,j(_':) KFhĈ7o f*sZjE* ╼73*gf#YMAY;vPRCRSJII,7ΝNf쉴(,,,E׍(رciW^YYYwy'oߌnuQmüCuƣG^)C( 1,:z' PC ƌj0Eaaawx# dllAРaÆ E~X\|G-Z~6-D޿m֬ ::~~+ (,,,Qɓ'_r̟O>>${Qv[%_6i{؉m#VO e˕+ Ck"涨OIE<=&8IMM {TSld@P5jU`(I$( 8 vZ,E(ЬYitTXXՁ䄛 ՟dm[SEyq/\TS%%% ΜLQh%!iʔQ!!+ 7kֿu(%ut4LMG9('l±f7E(ӧaÆe˖Vߣ;yڛfY5g@olG7ĉCw-d ҁKKS( ?*TUe66Acs皠ϜuqJQST2LQX”(܈-Z(::^@eee***dQj?DtJ:l<Ǩۓ||S'-#3fa (HUPK+WB@;1r,QWF}{gO}}.]$n$%lli҅U1E)%L(SDD^|SPPД)S-K@P`Ns× [ Pb4t9;JK J7o&!jl̳5Nɓxu)u8qhD6wpDܼyLGGj:O4 Z ?_*>0Ea M"r# |#G7褤V;yCWN=z?kJKS%&cca ;۔VTdUE>~':Xҷo/]] 5k~z곳 C0Ea M"r# jժ W.\8p`}}=ݎ`MNt kmf6rٲ׏NTr/\+NQ3PrLK˱qSԭ[yG(+iXX|܈۷n/'ccpjjuSji*3IOa.U^NGGƸ0C%{ڡ)-Ð!\\lΞA-/^lMٌ] ZOpUtp +F& Ȉئ>}E}z*uIi7(VZja1kWIyyiw. W___?-__o3gN@eC/ϭ[XEQPW {K]]bc}gsZ#:tЊ+B <<ݎ` ::C@tq11.??&k9cgϞy$%`8#G6,CC7cKr^刢v ׍@tǏW`}{GFB؝;d4uO[w̺pa8$ QUD) l>LK%%^Jբ8`V^CaDF(<<|ҥt{A>}Vsd= uۻw?ς.ڗ08 z%#VD_;R+4m, (66s>=ׯ߷>{QN3c%EUVf"Ϗ3߲9)SF*zո hk3H> CU1E)% (ɓ',X@M@YYǏt;$|r z7lXyL~rMAA.( E[P(*>*+ QIcFFsFs:` &c?xp%d&:QST2LQXވ={vΜ9t{I...t{$ l=s)SFETW_wrH20~b0ѣTe|OQ%%ӧ@?2f͚!ko7Bǎ8uɒiJ_(/OrY 0Ea B|# 8c >(**>}nG^‰UU,<-O6ۦ!OZPS[M9K*6e!QJNN:u*^4ݻwϜ9n/^8:ZTn[:5q P7X(,KoDRRRUWWƍt;%%jQ6Nxr9-q 2(,-kk !@erǏ*+3Yэ@jE!cA jDF(==}ĉt{ѼN:5bĈFca(E* ╼73*gf#Y[:v젤$Y22] "1LJJv`B,[R)ef׮5wcaH# ehhH ( XnGXlHQ754q>Jum4O{xVЫcpca1EG|$~ŊPF)Ss{@ݻ1PfyQ1g>%7@yyyF ^]]M#X*FXlp{ZptXi\>xmo P~Q|w/]r_B3Ѝ(]] O{C2''ʦ#:rd3̼ݻ+jh߼̙>hP+g9;[ttg(೑# Tɾfe5308xCLQXb%?Jj֬Y~~~t{%htCTg̍~x 떟X 6?l1!#:YvaW 0c ҂~fjbckkӒ2s 47`]Jvz5LQb0K ==M({INVY_'mAĊSFE< =~&V$̾T^^"90(,1܈=|o߾t{_~t{%%dE2 -q7 qL3NLlzJ-_\9HZ&t4a7\ 5Ǐo>}zf11 )A}Ϟ*򐼼41Pb?̲߼y駟*++SVVvK)J&䄛 ՟adm[SEyq/=7E1(*<| "X5O~YoSYS ih/ER,9 fٙϟ9,KEEI{{ 4) K\$F7@/^Рۋt{%~O Yt;yڛfY5gĠolGb+dd,I. -o D(-=Ke~Ba_*++& &]\l:`э(Л7oTUUe־r ݎ`Ut@yQ+'O( [:r5%7F5f@CC¼) LE[R(0c! aʕP60῿!"^@2Є CgG|ٗvk|Sh٥(,x݈+))Eu6448 SMD))f3; _:7l)|BjX75mo@5*h1¨Q:0HLQgO(*9ճ/_Q?*aYt SKnD>}$''Gѣt{%N%d]b0ڛrB_]=9Ee%qׯj`Z)ڵ+^KUU˗/t;%6jItfmO;G cmD0EaRbw#|ƨst{-Z}vq'6S((0E/{NAA>vԩ>`TTT+HrGx}VSI{lMTզ SVkqիW/Gܹs…t{%j E}r3aeg'_lzåKC%Z_?[Y˦=zU1E)ųukEt{***nݺE#Xb(Ç,-խ pUQQRN{TyA/= E=xpzb+T>};0pѓ稊)M(,uVQ%%%t{;fhhHXb y],9Btyelu0EarB]{~YD[SNݿ?^`>| Jrn"SL.\8(%倃ecc((ᤫhhh0`@ohj消o_ B3 g||6(oQUt)>d8@L~~4Ps,-Ξ=1304HJe3;pOGlY;o]>>E%$*PǏW`}{!63 Gܹ&Ӧ*;Xf]#)--b׮]Uz𡒒ǏvKtTt;)nL0 6|PQq&,:Idi(E'Ozr(0kMf0 Q4:v~Z.22]!2>45UUuu5!!O40 GCoJ fnd**2hEUѥ˗׮oذXgf;tvB5@Qsqa0L" 4fd4x`?<`2VP@N ,hP-XXdUVVHk5bĈ7o\kccCX"*y=(nJJRɯ-,Lz5ϞAO ˞:eggISp̙LQ]} xESB[]fM6Bǎ8uɒiJ_(/OrY]={6^AcǎΦ W^YYYt;%Li*K~C<#/_^WIsT]BVU2 [޸p !ͦ%j) {UWWw޽{t;gdd;lذF9Ntfo/EG ހލ+.NmFUQ(l-2LQX+((ښn/#4FqI9,jQST2LQX\ׯjjjmloFTNNbK@YԢ*6eԑ#G,--o6mŋϚ3g^`pt)M(,nT[[f9ss*,,TPPx=ݎ`ZYFMQzvǎI%@b9EDD?5o޼X6lذl2!u&6S((Ў#bjveo,z--6ĉt{=n8~`.\0pz_``{Yd16ұcmmg}%$:> IM=lM KT i H&!a6N@&&Qefa}}myyiTii9@r*Gea*mx@Ӧ.[6=DEOSׂBl)P'11Y~!1wWE%T?4,lKKj) gG!%4hPK%7-Vo޼ٯ_?tEhΝ_~eٶm} IرήfƍҚ1cǏ9lhh={ݻ#`Tt^k#PInѣT¾~Y*+3tt4Ȳ\1PC&L**LQq,"'q lphiTm-E"eT(RRRB|(`8ȫY6mD$ݻgoob EE)S<{X]]x>**JOOOZZ* z cbb*333mll?rXMMݻ/n%chh)J!:D<|$`B<Yϛ7,`оit*ֺh񐐍'Lh䄣Jc!Eʥnd**2ZUCQEɎʍ-ʣ*)FC!==b!ɠwqpp۷oZZAQ5!^Bl~-Kˊ $ EAXҥ޽{Vح[ɓ'H*7Q]]x z5;pK![߱cG!\zU555?Մ yrbbbAAÁÇ111o޼͸~s˓&MBBzM\zu\\ʕ+1E8GLPt))Imh%& ^ Fg}Y9ИS^vv"ޔ.@Qܧ"B ހj=Km,֐޲B %&QUK0E(={pss@D82jA3d^=99Ǐz֖gϔΟ?=n( HNJJ!  ^~mooɠ"DgΜb())Eeh`TE3"L]*F)^v=,, (QFMJ+--///,-!.?zHښ3EA{NNN+ X;w2 MibbsoXRRݻw,>}&gnjLee%κh8$` ''Ņ+IVMM իW`ooeT' Zw, SEՖQBaϞU;w:qkg)ۋϵk߆lt rˍ@{Q9*2ԥbd՟ rHQ?KIIihh@} {b0CVRRٳy8SѣGi @Q9  zAE ϟBvܙ )>>~֬YĤXDII 21YXXٳgYИe>?}縸8؀pL8xi =\O0E0EZTmE7;*#h00իWwwwGoog(l}ڵ|4|׎;|t2(h=)/DQ (SaeDMz`d" @1 2aB>K %PnrrMEEK .[Yh_ `0Alvy̙(ةh͚5D-ؤH3S%¢FJIQ@crݻ1LUuuksQDUdK0Ea:uÇɶV,,,X*n߾}r)_ƍv ^=EAAaƍLQm)"QO1;**[YC,~옻*l𳔔ƏPO3(JJrhM&(Ƞh:u(,=zp{[ҕ+W&OL4ԩS#F`ɞf'''EEm۶{(޲5e/%熆ʥKid:fvT[6R%)f$L'gPm*u(,3f IM=lMP{nH0.W@&&9NcTmoUK0Eaw^n޼9bĈ۵Q͚5 ".^`VnݲVSS۷oJ~fs|d{IIոus.ts7M _T~ᲬTLT::N%T}<}zQCKLBEo bR0:QST2LQX-Kp[U~~>9Iz{ӳg߿OxzzVKkaabk9=z`Es.Eu&*33dCnG(/O([PEfekkd(sCo05?vQFULQm0EOC hӾu}Ҙvד$/L--_6۾55s.Ej[۷/AUU0 f/"…SRR88X66! j-~IDQU1E)×)b?~XIIHV!}C  *++SVV$RSS ?^WWRq8}T~bb?看@QDj~!n1wMHPTBi -q(sCzYcb<EQNoTm=E/S~wppF7o瑐vZ'޽{uLD0K(+99yȑ?}4x &v*YP իxx,s2L뿅/^v8L%%9EQ,-MC&L(i G" cD;7|lBPQQӧO f.={ݻnݺ}ŋpRAA>vMH Gw2jkk\%jllLHHҥKw`G^㿷`eUUUFy/&ϟ?円|))0`#ZU98\$>e/,,Lz5ϞAomjt rKJQy-_1=K ,1,++]oU1r23,M /W\ q˗t;%$Q䋕*K~[-9y/-E/zܼ[7?盢#G6&/\C9X)H*^ngrcI~_bY/*ncko7~cXjݪR@~5iҤ ~u+@ŷo/EG ހ bﳣ>],رzHFMMU4X(GetÆ71޹`ia1o^iiA[VTd$$8'Ֆ"ݪxM ۢ&BOO`nwwKJJQd 4GR@CBB444[Mnn.;ejʎJ[#.AA둝< HyyGq22]_NVSS'Nx@#g!!cIr^yW-=KPR;>޽Vm)3l7VwiimZzuǎ̍(†YKܷooݺ%!:`u/EqሹhkVg,ww>y_÷[TTd@L|09*eh`TӭX2rۉp8*ϑmBϟwޭ2gΜw n |lڑ2&;*78g*WW۝;|}]`CL2[rλJnqss"![#dr _7r+7 ޶l[KYYy…>p#eMvD t@z`>]ĞZOʼAA,Ny!![#dr _ S@7 ޶l[>]QQqO<Π#eMvT#ŕ JPUU$ogg޳ JEϔG([޽^UW_OnUf2öh _ S@78nۦ Ѷ޿qF˗?\C ؀\U)QCiߏ?]lvT#,:yғGYX!?v]VV e>SJaP]%d0_$3odGt693lw;!vnbJQI(OɄ5Bᱤo^`k̅o ^лm[5k?'@+;оWԔ wNLSKgLE46PH%7Qh,L9XyWkkY2ӭMe7eʔw]|!,QNar#ٳ'&{BI.7n@vիI,qe={I{{ Ң(g`}wvdϞ*? GDFYǎ*x0LQJJ̰Аֿݻ/]ŋUUU{S0yY=J2$~PSK߼ƩSBӧ甕aGG?DFdD}"BpվٳI&XYYWr>qX KNoRFz򶍏>s%]1 "UUݺɔR6# 66mKCBn)IIdQ++EHYm˥޽;g???zRS7n9?Q*D7ov 4#/EeH8Pefa'8xgc$'hDFPpfڗ5?}`Ç{yyݾ}dzYa2,p‘Mʯ_.]ghhлĆL,ۖ2wXoXSKo_ܛjSRRІÇgۖmTTK^=6&{ YXXXV AYɗm۬nݺemmo߾J³q͑T0˗kD%]=#C ː 1S޷nG \]m{N"!'hDƒPfڗqeX~+~"f`Z8H/HOy߸ja1FYYeTa *:w˦]v\ Ыj6kWI{P%-e܀a,4ԍ&7(8@_ۖrss-,,444?_ōlP*smp=r{!C ql! b#2x !'hDƒPfڗvey={Ə/++kccqyԚ GzEz'*W0ahEEFD62wSoS;t+a41Ynb2B TBH-^n,QVkR*33DKK+,,ׯ|j&#dw.Q*vDh)! *== IbȈ׮*.N<e8qbΜ9rrrcƌ{Ak:K-:qXp‘^p+0D:IƏ]ښΜ994#mQ>=!2֭WZbR$ v 8leQjjҧ@h6#hĞ,??zvJ:@,u,_܈tCGđ&~Mvk^re՚{^fիW/ A:UXj#eei,]M3HE=TW_g#{ ߷Ç9.99yȑ?}tCCo{Jj}6G"]sS 2weY+,Lz5ϞAoe|uGC8߬w2 Ϟ%Z;I8V$$:5 ^J~7 &gݻ;j(yys{$w|P ^(/OOϡC*((,\ٳ_hp8 -mUUըQ6oLW;UViiiNedd;DJؠHc#-OdG={mq dR& u=z@yy:D|ja1&>/''|0ޢ"ੲ229*gW-C# ]["kgii)++ t9/4B8Fn{2fFjppp`ْΝqo;B;z4=ҢMvToog''+r &R)n߾xEUUf3ٳvN'__ kG)ӡrvr0*E̙3s΅^x!d|ïIWs"BQ7-t8o{(ׂ`§namhѢSR*4i|mG0E{Q'nl7N_O eTdII/a0B5}h00ի#{D^]% ZOF=u Sjjj SPP ui_mu;Ey'Vu9-q 2(3K, l0K{*ɩi7ݴiѣz۷UUUEI0iEqcv,(s<<hB/28:9g>E'<`"μgOI2%EQJnyn ݣGq׭c5k֨w˖-@`">C~a{:88lݺ}Y-~쨁AGǞ/ģ!!]] mmf>ga1p1wYY)Ui()UrKJJrhMťnݺm6sժU׮]ğZZ~Ξ̙&_J5D&_`r4C.Gcڣ|cRR7B6 ǎܬAAe{Y(@5#Fɛ7qY=ŀCWԩ#=ZysnnΜW%K$߿8_Vz)ju G}sٻ/1geШ$CB**3cJT)y=%) 7gKd_ww}wHý{og}>:oO=z0_lblLUUE%QݺCYi8k^&0]NNc/--I\_jc@-qKOIJrrr ,MCܹ2̆ 6o޼Ǐ߿_v'gH&v"Χ(zɦM_XX((2z266,**~9 p6lX~eA00| 1ys-[j?4Q1b z*//OSggHQq~-Q57|?ӑw9~00߇ N説,dWrr-GaC"8b{ ~ܱ.ϞԘ1ܲe}9qcRDũDeL#m; ւC:Z|}2\(V;e~r0|\*te`IWGO sG*~@ҹs[)`HkN5r 5Q?A(~zSuT] \M-C %U,e5KiiijjFΝ-Z4h n;WJo?s!(ɓ||--;!VvV DfAL&uhud[6TS٨QCĤUPh/]qJ_T|/2ut:M&<}BQ2TG6U2b/QTB%s0V~x-,];sf[qq6e!f"ѽjʺoөGBC&%9t(%GXKKJ ^>e5j԰~z-( q44ɔիnډ8U55U)Y\b;~e ߿`ϞdޫWHG# kV [#c'-I ZwFNNY#7B#x,Y2Şp۶Oo߾%)X䑮][l_Hr p oT5"-C %U,5K\\pݺuȈUW & HLLZ D<7IkR|͚6͍F=b3+h~ zS iqJ-Qq;!Q`[nǐju| gfnFR:ы&Hi=d}CT*ZBaCӥC"ƹmu/payxͱCc3lٲqgss#"~}נA}Ⱦd?}À]e@շj5mC%P'ү˗QN~iQ.w8ƌ',_bOK")6v)%$5$$Rl#I,.hT = 2p` ˰PŹbqq@dDSQ'!TΉ+e8CV#F x( [ rS[3ڗg7"l[7,ru{5= l5R|ڐd#niirXPAM Kq]ǐdHPjr&d8&`ӦJѨʎ*Ϛ5钒Sh[ R\4jH2${ y0OVhk4rd'!zz!ڙ.Efp2W&Wfl[L 6"-C Pqފ02UU,X4Zl*)D8Gر7ѲN1hdf!$YNHlPr-AQg::VkFwƌEE"g:Ą@NA.ٳm[7oҲ#\]Z\\xQ.0EVYdbSqD8~"z]cgםtt6MMMԀ `\6o:.D?3utڔ͚i^Lrr"k@YIOfPH ؖ2Đp(9nW_<\rE((LTR۹sɓ')6Nk+V_.|C\O=^>GԀf֭|NJ6rrrȭ[ ]Qs85xB`ݺid `jډqB5P#WӀmigɐ>i*f-aFҕ8rơ֯Nmr^^F.ϟ1m` q>-/߈D1** DAN M&رgώ+qa}BL"$3,dlKm%"!VY*- :7gB8>}ĬY#)9͕+q5 I1z.'fy_D9}1Dxbrs9yq'Rfbj(Ni@ƶVB)bUGQk%ΘydrơȊ{֩# PĴkׂ1@LBB ' ɓeeyGZ@]ZcjPeG{V@L>mm&q$-U81m28ѵ.x5Tt?L:ѱװa}If([Eu<ܲ0,[hM =x0u8*E~~q:5<}nn-:uj4!wZVPuPeF&Zl+Dߍ4UՕ?}PxPӦrs$ӏ&;L8 paq SP y&詊Ç'NAO '@*\c ɧ$'ӋXeۢ]G6s'12rڵSA@_333D`߾dO@\Bmo?Sa[2t"/< "qjfR*{ٲqYB彅:y.GEQ߿E!p!|Q#d_\`Oxq''/ WE e\uh˖M),6ڵD,EI6}4rmY pqK-Nʶ3gԥ r6kWGödOff+,߶mz.]UvvCB&V/^zz:89=@Ӷh[ %aiaa3ڴşrإ(:wnK!Gs3zrv^x"Nśׯ++5A+Pe /HR|Ba)AQ)>8)v-__ 5- ŵfDB,-U81^t*>4٣`y߶m F-fS(o (}}~Vܽ{I0a0^/E6$bl0׶E Txzl[XgkǼ蒒S9t*իl /ձ&P&&dAС}\\`hNNd^&>>0`ii {vJ(UN?^6< b EგO CIIlwFeʼnn_))k>P8P U%U\jA$\{ReEfW㺬YNYxS.ɗ/|o k[]':-5u) yxlCBBYt\۶jLϕLXvho+''Y}{EMEh"/MMeeS6JXh^H|-~ *m5 z nʼn4`M`V H>SCC̙m|QQ vZӧ)C'6vq { ͭQd^P45n,Kd#PfS(o ]: jѢid|^ٳۡ<^3}B?EI׶E1cj--Pzre7+B`#kkOiS$B4u\]^޼&iF-s^c!>9BQ|SYܿo@hgWcl석yH.;ڣ#ക{>\\]n`;w.]n** 2LLZOHs綜(cm4QrqDE|߈MnzС}UU۴]jRu8x]ZBzMYmI(_&mQQQ!!!?~ `ffֲeK999YY٪} 1!(0!1gw!xnj'<5~Ƅݓ#"|.ѡC+D }{۷4n, ըQ'~ ޽=QZl 0/sNrr$ӧPԗ/-de b }]IX׮xa-c G\9QtOC_`!Q㄄^S0Fh[Gk_m۰aC3n ԿaÆ͛7/88822rǏBֶjBLHD(<й2۰e}Qd0݂-C\ PֶW"@-#( ÇURr F$z(V'aA EdDE-طooޤ_G߅ŞXCCYDsŐ;8*5PD}4[XrFW fyR,S_sfls===^o!&$.󓃑gVC,wONr=z];jq%B:~.\!(JYYWDhӺus}}m03.8Lj\½{(F24t ݻG2DT4 U t M>xpI-^M.QGԫW^977Ĥue99;.Qȏ㊊r`55%4Wxٲq%ŀB-g?Fݺur^H%qFFBQ?v ͠ѶO@H7od߿khh ˙h}fY1ѓDx/D&wT (o׃#AQ{wsʔBQ_"5<<9Q*[;7ϩSGFWW r27th_, p6)ߟBC"8U&iCn:Պj{>GQbDadHg;~'u֮"I$€Uc8tg|ĉsId] P%/ ~9x0 z2&Ύ@YY7o҈ѱױca$\\ݬ']vט066ڇ=yö]p*/מw]jޏydz#iCMZ"(m[]̙m433$zp EAطZm[@fJ! І0AQQiiA;AQq7$}V\y1(!)8h}}m~ٳG͛燮^CP/#cK7ӧ,xZ!Ǚ3)%JFDQ,ԩ e1^kpTImPHH}OIf[^s~#p\Y`R 8Eݽ3^+?82Zn%tbԢE{{\\z{5k$I BU ?Bmoݺ;׿ /^877۷oU(P8 eC%GxNZ2m-~m rF>{v{e=O:CXƍenaW%`p'z<ؾ}K9QM':~lg΁BQQeBjjJ PKϝ;sBHB{VPhQ6UGckHݻq[vpN|\ѣkv\I o+:j E ZjA@_hhcZ/w/ i*mg-aFҕ8r!(˗\# 3 A jxl ر=zG|0K\#(yxo߾Pl+ht$''ԩS .ԩʰaâ={VC E@t퐈qn|ݢ|0$\0ځ{w$asQ\( |>T"~~Y#z͉ $/F٨Q:uʖrH ]wdΟѦ.Q !f CyRI)B2pB`IIΜFn۶ӧ,l~wZ~z^&D ۍqƄDH(qvT22AQnnшDؤO`85d5')m- :7gB8E!0z QZ$RXt\۶j۷,d3݁eE-Y2(F(ۜ>ŞhؖktѣG߿"x"66]UUCs9qDiiiվT"!,>5oXdP~kF#'grgq!)y.@rr9=,Cu]cO>ôpq8!տ,[6l7rnbv-237[YufI~Pff;\9QA1' j9(455 u, ** =mwܩRѺ+W[YYڮ_UB$A3(oeN 4ТE 2!LA~;9&<ޱcU|_bo'''EFrd'+Q(J"UuLP!'+99| ZǏ/E&O_`DjO?Dj}ι'Ix 2rM89ݻ7 ’bۊӇQ!O>:_T 82 e>zӦ͏ԠF)**ùs7n,j'C08/_rfPJy= ⚵JВDʶ:._ ߲eӣGזeǏ laaHmFnZ~|߾}Q\tǏ5:₢P'>MP(ֶ}8ѱګ(ŝP+1ˉPZZ:|۷oKz#J,+۾xkײd9d|Zj7oG߶դ_uڴiFFFF}Ⅸ[-dQaa3ڴuuz0!(w]"1YM69/KzuXUÉ*jCyD+cK4iii}]4 ͛zӧ,qQ߀k[q`q=z}Ç̞=;==DyI\nqq\T߿?i,ߥW( e47--UwRL(,vrMbo۶|Q|)U]x%$<>a`^:ʊ?Î;x_~޽{~~>H\#,(JAQbh[Q4!00BAAvڵ7nbW$JKOgWE],7E%%W.%"gB)w󽂂 %%2TT޽Kb@ F +/Kq kcK4]v m>###.yqq8%K\#̠(--5:thҤIZjڴ)xo޼f5\$&Nt߿ @˻NkذdߨQۡC[ᖅpڠ EWNa'2 66ӑ񶶶^LuslѩSb5hڵ ëL۶-~4襦[l>,$$L(ثy!Y6EƍrrCI}{EUp?^ =Ox)_alI>DEEuUWW=z3ׯO1N cjPxei,~W$ݿ?""EIIl…YYY_|BR5wY>-A{mv9@CO ej.aT P{}w=Rag%qcYC5(.ΦPTw㕜=8+cK9sfرC=v9!&&ޞDxܹsyeP 4lZ|rlZe^ɪ;}%Ku릠iӦ;wT<vs"CBIkWGE237{{d7<ؒz/**&(] x8ή{Hd/R==zmg`@QCy؝^!٧OYы>{|7c67o $D F-s^c!>*9c+P+;BZ>Dׯ׮] xdhhf\rs&MnݺumuMqB5Px#WӀ²-5 RѸ=L"lK;߿5_RRRAAAOհ>v,,]Cg֙7?TUU5(HHT9(*)iĉ^K4fi G`%gUd3-(0q(~_Իw=7UV'k vw2ĚˉF19F^II zX.|7iiiÆ SQQ300p̘1qqq0N cj&mKnF .g4DCB&!k?pvvވoFۊ5aGGG=z,[ U߷oxcְwDžW랗]Rrj8'$SS'{D/z7DQ۷pd@:/C..e99zx{qT*-=]X@P[ (dpT+:JĊſy&ҥKdddaaa񋊊TUU?KrPp$RFԭ[;ˀds52UTTՕwo&rs A-ԭaۿ;'hmre9-mՏy ɖE*/HWW{@Ϟ`7@5m+TZZ9Ν;+++nݺhdZtqq6%rE j@-YPdk|dgg/\zUKKl9hW~TX=&*y4iO {۶VVI"MM .^b#O7 7{j܈tϞF*) 4MLZ];DpΜQ͛kkvɓ{m+ի={xzzjiiL<ȑ#+fPT-b1kn߾={lMMT}+M$ LILnHiSur9x…|#Gt槪R1jLɩ7T\#_DE^rhrv wwʿ:Jg7 fՃ-[X[!X-&k9{w5Se*-  =bĈ0iLb99Y2 ob^]f͚0ZAQŧ)**ڹsg޽.\x}%N_ב5mo?@O8:oLT̐ߟظql *Juko[_#Xb<,94 5rBPرNOBd-2 `(cs挚:uin,A(oH)igP0. / II.5[ŊUX .?^EEȑ#|N $ ᒌjemۂW~û|vf`Kq)PAU4Ԁ5)CU2^+ΰ< kW۷Eػ.ֿOm- :7gB8@j(٨Q÷o6XZv@{,G@EE֭R6_PqB P#b Sr$lʙWϞ^ ؄ttt4!$,Y2Iu;+?0z\UU޽$A[V8hbE")((شiSǎ[njժϟX֒넮_ӤR+*ƻ\۸翲!SUI+WvSe<8H%U#Fѣ=YgDe%%||d꫾kq Zq3f%q237wbD(9'Onz5,ڽoAn !<998QIHի@6뇠@$OUb")D^$J 52ZGIƍs7σoj| ~^; tWG.N 'ȶ+"BBB !gl552?΁0F0yPY zր@FS'z GDeq-/qc/p͍ڵk7N|| r]ǔ549<ؼˏ.7g RR_֭cffHfV;thgVDÑx)*%%:udf`T)-o@*آ#iѧN' uB@Y3RFGGN!(C"TU*&]eg;OA]#F޹s -s JMx l][ ƿ_O?D@Po{?HvIYY[v~`1``)Γeysm%%VL:5 矼UDNI_|dy3^@2e(+zUtҤ!x(#ZEn"ubq̠(H瓱1|zIblJ PN/lQkpn/Pu뼙3Ql_L~h0tc:s~gP42m(jcc'Fr߱'~G]IdTIuAcΝD*Kb'F Ĥ5~~.*11p%P^Y>yy*>gdlB|H<= IHDSظl!C $p(@1mР>׻p!S@Z4kѵ1?H"'.\50F%Ѷ­ğ"!V,CW_ysea'N?8qɒ`9Z $lm7DB OM]G AEhw^@(2i([gώ"ܢESܺw/G4hkă tp 2Ϩ!$뀸r ^>rruVM%T^^4ArD7'CQO'.bj([ \X9_ΔE3˺ޗ<$}$2 PNNsjӧ)׃}6|#QSSںu .]mժx{ 'QAAAhh(~VDJ(22QF"bŊ;Z^^~ݺu"J6Sttt.]N"KDQ)KSUUk7yl;9b_ARTg XRrɩ7"b4({hoXdP~kF#'}4qAAnx26P>C1gώr&j.EIS瓈(n-ƌԴiSf,޿/(ZKׯ[ ʢ(=> !! tr~n:͛kR Ύl#c:p||`X،tr(kyQԻwΧPbbb~J"O7o444611YfHz_n'^/%\j'=xÇt+"T{l9*?LmPq̫W㼼z}u^L6U4iHI)zED%OosPTlR*yF;%{% 655 BdWtuh,jM:::v,5xNAQRΜt>0O?f͚9snE$vܩk׮M޺uK"J"ׁǫ(IW0`Z)㠝f{%ȳ%seRS׵jՌŋnjˋN9zt-`rLoӝz ( ȉC>>=EݽtVds [t1jѢl?{ u&&Lep߾f99;:VEI9{1O)S?n-$<==QHqD۷E>^^ /Ȍ }fff`S$Am[Œ+Qp$.!{\n2( HH y$ʕE} `hk9Ef^ߟ"gW ߣG{߻Df ?{vDZ{r3j3O .4i҄T^F(f͚':_SS+W.}ڵkIdFHW^` ]o}`f`ɠ9+rƹt)Y3 ,5k$P)&( ѣ6xy9GPKkVW[[´}9scׯ!(jɒjF1R͍\b4_ȋvYAGbXk"4K"L(Guݻw]x.-\ptk!v$Au8cyl_\B˗\_s[nծ] "ܼyNI#!:x0bGPTlRc7n<9Iiu'b{ȓ')GZ@ӬceP3*K֭c&gTF(铼<~EUVV+(((|SȌ >l``P[HM^iVojՌ+,3ֶ'y3qc[:uՕڴ-)9Eԇ' wY=237$Y[U\ hVA+djUUׯQJvbt\4NUQTbʹsG-^]D޿?i,ߥj̠JǏ߿O"Iwţ GDdggw1f}a.!5#4@Nj޼yaa!݊GokfH`? ^CV`7d? N !/@޾۷1sz2̰cGc+WNTPh 11ut4\<6oqijjp6"ꜝA€t** >e4+XE &~}Aܒ  4hŊtk!>c {CpN') <899YY[n„ r8^Fi&n-Ĉwӏ&; PGx.= f*g&8N'Q @DHş%E' ]?L:ѱװa} MIY3j-bo:,,LOwѵAA:x084t %%ȧ閟ꑵ݀ӝ-:ujC"ջv-+(uj(|vsc3T>:tȨnE$޽СCޙIzzz【{||Hu8%?<Ëݻ'k 6oԩSt+".$/e]._ o۲eSr"ci#w?yBUpbbb%w$FF_v)CY'ȩ X$$nɬ-^Q=R@QdiE^x0''( #WWMJZb{al\&{ y>AQ?0viM6yf q@;&&FԹpB)^/.|kЭX:hAE]gڵܨ7o{?u;СPѣ@Qdre#|Q2AQ/_UvvCB&xz:89=@Łxo!>ҧP C3g΄[ )+W4jHKKk߾}\vm q@EDD@.d/m6QgZ mtk!$6Ġc¦O_={μy񤪪ׯ@QDEAQII&Nte7Ϡۙ=ڃ?|,۸q&Z,[_@ bfu ( vCUc3$._ [㇅ņ LLLklՌ3j86^ /jxm+MMMn&)$6Ġ($??!CE7 ㋢^M___mzǎt ,vwС}Y-\\:rr"{2 TZz0 %wX~b'\(++fr_pʕ+E ^/DMGƆ5CB;w}nEh&1tе%E..#ʩUdg?||3~Jᖖtk!%t}uuugX,]޽͛k>k^n-h8hӈcpuAQEzZ!j,FBCCΝKK<@Yb6:.nwֿ$)Q, dE"fPT4l0Z.8袍7N:ׯ_ommMWRLa+87oҪ3#t9'?xjȫ_ʠ()gEC[3݊H>G(**Ϗܿ޵k۷ӥ ۥKh.ͭ?Mkaa)D.5k$9F 5,)9+%O8A"@?~ݻƍV{nqㆦghA*0Vĉ=^%7$dγgGO n:͛kRH_X(?S;Cu0$}J_^h޼yG[ )!q#8l0zuwqqW%K 2n-!rQc 0xfgl@g^PӧSeҴICJJNso""撧7Qbc7ܹ 1$@6Sȶ숎 ]]޼I#BG^ǎ͚i.Jaj0}Qk_zE"@GPYmSﰰPP`wN._ޕֶ}INu+K-6V|\\z{${e!g }D;VEI93(~ѣGfiacpp0ZMǏ0`ZΝ;;6:sLӦM VI:IWH\B'6viܲe0 pԡC+~$ʕ| k9f3^޿?@cb66H";v,&%2r~|^ٳJ!aX%̠(^ի8 ?I8p]v5O)''‚n-h^^^tk!4ei- :7gB8.6kfF14#@?rp- 0zGZ//?FA`qmjkYXo1gt? y=,Y2H(FʹQXO IhW9AQR ⢗/_jhht+" f͚>}nE .t҅n-ӧO-ZHOO[i>.xƼu݊?ӭ725g (v- Mv(]͍O ߼IKLaX#%Eb˖-tk!%4bĈEѭ{:uւq݊H=zs݊$E+>2W,̠(PLLL׮]_VD(==E%%%t+"ׯ/>WQB76ڸqoƠ(blc-<|6 ?xp:,^M.߾MWOaMnnِRٹs[+]Β z捖֕+WVDI@RPPZ}[n-:޽{TT݊%V,ȼjդ#mHxyVFT> ĉeDtdt^^6pӬ9yQy̙fF& EegG UUE>D Сr9ӝBQԱ,8K.nl{(}ڋ/V'cQx2bm GbʞXqQ莌5WAgG*-==rx[v̙&aΝK7o[S6mD4ݘdbŜڵKLLw'+R~Dzd4=V9mmxz:|̙&֯ޫ ޻$޺3fd|KN$MB_AA^R~Dzd4x_ft_lʕqynbv-237E̙&UOd8cΙ3 ٳ }yw_^ EQ^MyAB(//GTޕ/8}0Pŋ; J9$#ml;\h<2s&ss>y%k!:u*ZH ;::ҭEm߾}H( e47--U4RL( hÇ۶mh<%^<+[ѧ)j[ʅ'㕐t :x)j6 _*oߢuQ:yg$?(m[]"xq'[dX mm5~:(F$JKGAQ|=Ϝ>{Hq囻PJQ^N#*;Ս|S8x0,%e9`"xa|"MLL *W˼3˟O EʢP>4E?{Dqv((UU{[A`{+6]lXV,Pºv{GRr?_Bd;I9dr愜;3wM 3ӉłBjՠ_Tyρ> ͛2E"cTwcJ+YYwMɉF!ǶF]~V^E bfkklȯ_O*LPQ 6mA/բ+c+~#۷nmɩ(5$'GL̬(z;B6߃bp__KPSa֢E3gj" Q2q9d(tKd3џⰰR01)\u\)AE)>(4t9$Z&5y(2RQ~62dŋ5QյiMLɝxF]:vpՙ+Ψ3P埧бdISRBϪ@7 б^=6up_A~;fϞ=311u&"A(=U&.|>B%KJ U6Őׇ *J*;uj&KLLE),KOmccneeFy(2QQ>IѣGߢ63fܹs5Qt&&V6@]2fPBlgF[b+W?S ,?8} k%%kC3Y.eySS;abŊzꥤh"SeⲒə' ?wO,N3àǗ;f̑}:/#e@f8*ySǶeGuSSD W׺)R=CֹSvMضb۽lY…戠րҊ]!cPlH-̠4 ZF'1'#QӦhkkwT{SQiW#&ڱcG*UeGH͙3gرY=Yt4'*Xʨ,w*M{$fnҏ5 $dX)˖dO9HUQMua?62%f**&&""""j(;nEСC5Q{24lƌ-[DZ].ߒԺ-.KΝ;gnnL6N@Q|?ѣ&jLRz?x߿DTh=IF_qqôHB y1}"XyUgʼnmZ5C5+{*J~IjNcIII۶mS^,' ʎNvDQ}vML=,Ka6|ݻk"*Ş,;*KF]QQ4#Wȑ%K_Gu+T(ˉ4+KGF1g!> J4eK=u̘n2E,>^Qv7/MԬ@T1{:}Dp\7-xݘFU˝;ɕ+'b@XCu<ѨXB\~A4Q8)|K}<22RQԉ=7p8 S룷XxEFG0~Ӭ: ?8^-8\Ed4F3 (#} ӡ[W.ӨQu do*UbĞ+ Yש|mjKV޺u:KR`f1?gKKӧOX^ );tʕ+YtJdm {,2q߄>oM7 l0#xY\Vӆ ww_)Vَ;*WL:derw;th1Hy83 Cw2:qb01=뀮]:dqahWz{4X&;^pFc/sʒѲTYLItNhG++KR&0^6 E= C%_`sg'~3?䗤o![L[:th޽U/O3l|Ν;ʕD͚ȵ#>$lA~xΑYxϦ0z\rΝ gXѢ1LǙd^^m̊n8˗x 5T gLE}^޾/֭^ys}87d5{v߅ ;;(alm]3qʟߨf͊#GvekWf&L]pт=fd,2 Z Ñ |,l[}L F39B!S6uO_lIaN C~Ijir,.]jRQZ6QkkkMԬ@rlscDAύ 6M`]BVҥ&JT.ܺ#l`Z{{j׮ 6qS?5qbObEtTv}̈́ J`p32ۮ]]8I4eym J "f/^011qㆨѡYԙ,S8Oq ~-*9NU'5atW-mSszKV80>I 2[Sĵk[bWvub E1 [/!%ck֌۾},uuaWݡC'Ob|yTR1V^]NOċ͢eA(wwKYwE01W^ϟ>رN1򓏙«i4{ɺg&$ZFi뙊Ztiƍz6/u111 DUNAsP}5\ЮnY>Oˮ_a*Js,o.SQC=ѿ̙j)6@Uvev0v輪P$16jǏ@i1)V^O**%%aÆ8E˂Q8P" /!eEp3D^F1P´] 1򓏙«i4{[6%i듊bo߾ 9ߨϛ7&jD 4ܶ}G}z`E/M}~@=m 7%*ˑ(viTd64d#19p`ܹQ`͡e-s΅jQ胭c/] p,\8?R~ɪ(p]cc'OF͉FFy_>p-~8/l@ͅ&f7CQ% ]ԤI AO>M [K h4HE铊j߾)Sqb$J6r̩5$ČݘFV4gyk]!RR"=Z9Q&v(NٳkF e߾֭rY: H"v[6[۷@/~wq?th'Yjwm?MPKG.)Z`޼Yڎ%MQ,ͺC ٳgYvPs2R)[Y\ZllYᨭ[(bdXRhw!'O53+&i(=7X8p۷o8VzD􆂱rl[$:$tRDQ?~MIru,_lwZaF+_8"b4 0U5GYP;;[lbzƢECp7eKf}ʕEf/^433{Ui126@l㌦j(=7(=[n>\jDVnxX Vy> nI"r%K>\j5zDtX=o_wn3A_ѣ ptl\&K%ӧЌ߿{w$},%KI!pzҥ(Ui]_:زe#Qc%Sx5bTL}]fjjl nlg)M**.29նm#v!|yk e:{ԕ)SFe $%ebYll,Ԧ!($eTYLq$%%v֭Sqc;KieSQ:`LTet4)"\?#zR>Ifaaa֟>}BѡؓiCE'Vߔ,lٿ crCId*ӫW_qdժUׇRqc;Kie̋bOѫ_t:{լYWK=L0ӧEP\($e:/={v.]Uc )>=X_eѯE&Q?GƄK*JG"r:(pѫLR&nEGG[XX={V:EbOR|hةSիsw0>&h5f+R O<*_:2r9{Ga F:fL7lOXѦ@{#Wlֈ>vlWK~r]Z*eÇw&i:w<~x42E2PQ:{9::;vPO&)=̂ʗ//nLHOth7n}[}?az0(" Wc~pB1Ξ=[ (_:1 /^c.>>KMO!!K ^Ç^^m^]/ny{BB푊(G-]tllU)lX$DRQ{Եl288Xj $25Ma֮]I&^-dTY2zǎ2 8_ D" Wc^zl:cbBa(Rk]f=-W˗O*P{w+5*_6jTm*RQ#..ȑ#&z痥4LExTPQ:{Եo~׮]Ws*jYllΜK]f/_433v5J*J%%&G& VIW͍{|A4|x)Sz'0ҡYҔɓ{P!:$׈V|QvD:RQc„ :u6Mt~IT8eUqv%Euݺu۴i꜊=vmK ٺu~M D%(U^|> ipi+?AzLlԨ:4ۃ6l?pp߾yl9 *_2a[7o411yXjjDMIG]߾}׮]+zZVQIIgkA\;hQClU23vuƻUYj @1<|PCpev;P\'a|30`AVT^ub'|2 },[{΃3;v#-¬I&-P儞Re73y3hSE(0Ph8[r\dnn,$A@YF@ ݽ1F TBWK^Ν8 iӐT&HIIiРʕ+ES.!qA-]TjH7NdqYzl/KB޾}KxNS'NhpE /v„88r| ΐ.dLZTma(,߿oll# O*.Weh?a vvV..u0F/"Ƽ|(TMjvLTXVյ̆  DV8ۡϚ]`_O*TQ ]/ [lIaHN6lpppr:(CQF͛7OjHFue0۷=l_*=y*MB ]޳e/oj۶pB SQb9nn޼ܹ^:3o5\&ҿ_/ ӬY3O f:Peh@[ NoIIgӔTq9h:JZ&$莉{%޽{gffvq%ehQ7i$ѫr aȞ|xȑ]uXϟÊ+3T.A)QQvv΋ɦPcUYN0 ˖,.KX,k۠dsRӼ2D^YRR?ﯹ XFkAqϲȑ#EV=f͚%J4h9ڴkפyڑNTPzˢ'08kݺ+!(Kվ}Sl@ iӫիڳg>}ZA*LJĄbcӿ* \|7ohS]GTLAqT',,TR_|f)Ƕ^[pEK ƞLRX|:yKNHs{s 07n?itCEe۸g*_\krmC+V_j)$eZ8;;; TLEMʥz{mذW^W+@2(N:u2&&F E"ܸgp]ccϟk~ǶeGu[nҥJ? ʴf"tRQzn3Uhڴŋ5Wc#J-ꂂڶm+zti-bbb,--O:#t RQznLٴiS54mʎ(;t萋̙~-9D3b߾}ʕ'VUǏ>} OtGuuZRQ2-ٛ7oLMME L:(q8w!SЗYx;+< _i4QvDEݥKW.z$e?CCU5b 6ҿۡCS^wGN\WRwҢ9~| G8Gu+T(RoO2ظ0zWz{4Z'{dIS\} z-8 YޟeDBBBJvޭNGu7oެXՒq 3GGks ɢjyd\۰:b162Mc8݅ IϞف1_llL<{Hwf8ᥦqҳ}U&&&j3322Z $I0v횩Wx9@HUTߠYW2}GcؙQׯBy(ے#OR,ul}|4`|߇G.bBPUhr(&Mj"XBoH [-8 YޟǏP΢eLXICܹŭ3GTڞj˱zi9&MԮ];AX*te\\ɓw`F!޽t)re[j1gInF VVf^^m;n̖ڐ>Wh/_N`̬({vOHhӿooo-hV:?2= DC@jr O~OKf߾}PBPPG)jLȨ .Tîؓ(UàǗ;fU`Aݺm|m9 YB&_Q˟K*۷֙U%wYH,* ?Hиٙ3g,,,B#$I++i^ԨQOaAjϞײ5'D{{@NĶ>ӧ֩LZWb[oL Qgggw]qT󎞷Kl'$;wՋʫb**)*3Oj@6(_A&0'x;BpCTYL 'ccpt]e0J*׮]YX!GQd+W6 k'|rԩUU0߿,^>yr]" s'WhS?\7RX@'XR% d]m"o9qr;x`2ebccy;BTDN4nnnfujŭSI )ZA{)S2Q'%2rvdi'VoSQg;{ٲL}{P7O}@Ϟ-YwwB?]Q/6lg4lX ޼C%,ې7)scƌRQznR8޽RJ 6kذSĭ3@ReɵkWNskɯcL F MLEyx8vԬy%JIWSrLL( ˆe6iq(UR.moNdrwT\A&0c}x/^RQznO4>} ŶEprr ΌI.^/Y4́yE~޽ˤi7ovO XDNܻ|yklР[*99b„ffE)0xpG)AEeM a&iӦիk30!? i^}ʐ!Cׇ,VZ۷O:3 $UxHH8#,1Lٲ>Y/U=~t_P4* fcc|,u9QH(ɕ*短سoTFM6vDdJ,:اO6t%;ݻ[@Reҥ#T)cjZ-* 7@\\T j)(h.+|(,_޺Z5gbQ*U*=kw~= iV\puUXm"oR4,^q)))!䢐pBiڴ)o/9 7biݹ̙5l._&9(;d7//5kֈ[@RefQQ!J U1@R E`O6L Ԓ ?HФfiHNN]GHE!<Ν;:wL^Ea]E%ս >RJv $Wkk배0ގ?u~$Kd*ťN6 A;zC_숒fϞ=n8q$%)BeDddx;BhF!5{u~$KTe^-Z4l0q$%)B)azq$qU33ov?,1*Jfн\[:)}L aϟ?*U!4-RRR֯_ۑ,;wvB6nسgOq2)r9Rt_v RBBA8NDҰe˴TeGHm۶Ν;[X[߽;g,}Wx$Ǭ,Su6b^D ^zejjz ގ(@dAeGBԶm[qTSEALܻXBʥJp|`U1ulPIY)Yxϟ)t SN&LbcReGBv!qT󎞷KW̝;ŋ`Ui34=(ǬLnjooB#F'$$666#%ӝRN8ѸqcqT'}GAFFy\ځdYd+{hZBR_8ujUzU-,Loes嘕BH-fΜ B#L  B#7*JWL [dddڵŭS.,Sd&NٽKdܹsM'8xDi'Vo(Z*Ye䘕BӧOMLLn߾B|t& 2~xѧ (-˗/WVM:I?vi\bc-h gǎUaϞ|yֲJCA sJ!Tgח7Rƍ^2HEi٤нݺuB ֩N֋K4Msq#FtFPջ|esN9ffTnݕ+Wv]BBjༀժUx; ,Q&ѣG666֩Nք3ϔ-kҮRbԯo϶>4Wk\!;VaY)Y711yoG1ѱ($$źuj׮-kԔ,Q&իW%JNuҷR5+S${.&&{wggHyrF`|F7ob{Sf6Wiz( Ǭ,݋BB"}ի%*c,IFMIB$tENuҷ2[tD*eLM<<Yb0yVvvV..u޿f6WizQY)YVIHHRJ`` oGн($$BG PGE8׳)_&Ɏ($1..H:J ۪Ὶ~&n6WizQY)Y6ￋ/Bt2 Y[[PSe5b !bQ:.I<nc \i嘕HeÇc Bt5 |\rQu%f*Y79gvvV3Q:.I<?(n&XTQesBScV"a 0r=But5 L:]v$Kde,KG0۲eLNĄotNvD$v:ĢE~A UEI$̲ѣG!|B]t8 .ܹs$KdťN6 Ag_ZvD>H_|)b$e lӣGCPݎBB4idɒ%$KTedBvDr:ҥK?|P IEI$fÇ%J믿x;BnG!ejԨۑNlKƲ#J%v!VX͛"VH*JR&0S;vO !G!5/~Eގdu%2rN 3,ZȎ(dNXzK.X!(IDLMZj5}t^G{ѻ$Kd% [LHh!;t\x::uDDDXUKn 35y7x;Bd}BB [ZZ~#Adꘆ#uI6m*b(yի S21|\L"a>V[͔ zFIHHXbPPoG/!n̎(tBɪ(!#LQ*TM'_e 3IIIiذҥKy;Bd=BB̜9UV>dˎ(tw¬oUPԩUU0߿{RPQ'Otwo\X6mz}ٵk[<=] 06.\~zdtBFVYB*T|ӫB%3 5ILLZy;"M#d͛7j(+T?}+~b@[铠*R3f UdYL$fO>z:i޼9o/DC*J_%J{[tADP53f UL"a -,,Ξ="s6 lcccvD4(Y%J{[vm߾}EP*JJRI$4ğYbxގQHd-[Ξ=bB,Q"ۦMu&bRVQh 3Ѷm)S=B"`O?%$$vDL(Y%J{۹sgDTL"a9^|ijj?vPG!%>}Td3gvDd(Y%J{ۿI$4ʺu~dގQHŝG"(Y%J{;zhfDTL"ai7n "C " UpB%x;">,Q%ҽׯ__ IEI$f޽{&&&=B"S~͛7vD#PD-'KHv5kXTǏǡ5T*)^5^urrCBB9~~~+o/4%KrDtoOʕEPM<ˠ-,LLL ׬YʕuႿ0.K$ūv0V^= # % %<ݻ%ҽݻwlٲ"VN )RXg/fkkQ(偬:<ū0/_633{ oGP>m4^hɪ(&KH3KKK+T'}|Z!S򆇯f? NX٣G W׺*͛זeu9xiii;ѱ۩<ū0cǎԩo/Vٿr;CU^DwޙX:[|NUg>^؀p [`>ɂ AUˡ4!)^ٷoݷox;B|@XbEÆ SRRx; (YM:ݛ۷oŪMBZa.TlP-66,p֭U1Ԝ,ժW᎛Zp@Lta„ cQhȼz͛,QMt{zXUwQVHwdt*aBm1mUsqiׯ_cpUގ 'B{PDuNt:qkדVVfӦ`^k-kFqqaƍ5kLJJ툡cQh9r6..#ڃ%j9Yt*U\vMtBES-fDxqM:aƋ_u0t = ҥK=z#Z%j9YtZjbզ+*@L:aƋ?x#G1nܸ.]BPl;[ D|&TL:aƑ B:Eq ׯ_vDPl;ݛSHHXI'8TV-Y#M( z^#dv@׻VZ۷OHEIʤf|v횩Wx;bP k׮S$J%KT:vcjt&~~Y]gĉ۷텁BQh}V-rPD5iս{^f[CD*';BtmѼ%d9*k͚5 ^dɏ?vɎJ+oG\EI)YtT,Y ǰTNv훝݁x;PQ2=J(5zh___^6铥ɓ'y;bXHdGh)SЬC]QQzcQQ'O>}:o/BK`\LZ;R9&&&/^gHE={qx{Aڣscƌ! 7ntR^TA(##8:FZ۷fff.]툡@*JoYfrr2oGC*ʠTTׯ_~}Ah911#(ŋ%jӤI,X}B8;;ϝ;(W^Æ Ap >>ٳgi*U͛\\"-c{vD!>}ϼ!>/M7npr 8xƍ_ڄTxŊi)9uꔽ x{{ Orrڵky;琊7f̘Ѻuk^O0=AhׯRB*Jɓ'Ox;B7nرc/_ (|]"3eʔmB!W4kl… `nee&P`TҮ]x;nZZ$ގ$?uꔌrMddx;NΝ; 򊋋3x^zB?!' AHϟ-Ztݺu0p>y;""",,,bbbx;BҢQFkצqa[[ۯ_vD $&&VReǎ!ɱjժܹsSȑ#y{oy|}}]\\x{Aߡ%  CzyގԆuG<|#(/2-Ec֭UVMLL@mXiѢŜ9sx{AB*T!q\]]g͚ ڰk׮ʕ+'$$v T(B<}ۼ *111%K<{,oG8wHEYlY XfBM * AQTԇGQ%VRR"NSBaCxLJc3kV-K*04ԩj*ގԆuϗ(Q2RCJNػwoTStգG gglƞlѢСDQQ2I*n266~9oGtjúGRRRշlHKF**&&oXr> R3\M?sywJ7˫b;ww{^:x_3z)RTsPny;;+||JNRQqssCmXXh-POH* eŋAܽS* oA\m%ggqD7dǎ];Na1V.mP*Ja ۷hذ!7o*޽]zp￷WST!*W}vގ6ԆugϞܽ{#*j׮ٹsZtDRY;ӫ׷Rg c':X?} =YhSְ{ȯvp`":R;wRT!Ν;WD(ގ0ԆumN>w\ؠA5[[eF~zR4**%%r[pʶ@6 }iZ'K<ٚ?{}vy z-R!A18/G(I* Æ CmXطo_y;BQ2<<|k]S"gϮUs͚qSyNLӧW {vUilIAE)BdPWM'"bW_NRQ4MHHoGtj:×/_O8ȐL3\;4ˉ'+g mݺ!Vޘ턡ЧOJ b(+W63SͺuE)aƉbg浡p>)I*,GBڰ0bĈ=z NW׺)R=C5*UTz, :wvj׮ VRLc-kYp~?ޓT@ZA~YY1({eIEsذaI /_.^wx;BP?ft4޿Q%*Xʨ,w*M{HENTT_݃ڰ/lܸ# _FjF*۷oYa` 6Ad(RQ ڰy򥉉ɭ[x;BC*T<͛7y;KP:;v4io/B%HE"tUVխ[799#:aIs2ev TB=%3P'Ta4h`ٲe KXcǎv TEEuJd[.Ywv=c'-ԚKRQarccOvD76,]Ǝ۵kW^DPEE/x2tl8fؖBTQ)) g%&{HEY\]]y{P(ׯ_711y oG" d jLk>=x+N?0#2PQ !G?ߟUr'[T$&&VZu֭ KuY#5sW"n;>hlݴ޽]ݙ3 &~v회 X[g" ڶmK*#EH#Go:Ԇ%Ǜ7o̮]2Ug#P=7c.kz ۲%YP1;ݝ+b^-F rr…cOڕV-5+\:thsjРիQ%{r˃7ooTXcNbW/8Wy~Z+W6ΗߚC] D(BG=toG$ a?f^DvPj>/';U ]fh4M-G,F?dISvXYĄΜ;lW$ ^։hooؕ'lUTrxb(l/Tmlk/vrr3}ZlϘяTZ[[#҅ڰ8~ׯ_y;B!kQ4%FhۮќMv]~ps(#B /QB fР.s>Ǘ/QΜ9lm|kll{zf$x ݑ~477$w"+t^ 6r9fL z0@*iz=h ^Hj۷oe˖=x oG"(WQ}6m41qP', ~ic\Lڭ9ht[}Tgolm-փE0ml[IIgML cL5~'/0TsʦJJeX ߚ}ىb խ[E{"thssގHjb:tAdLѳӨê^ユ}@8eǗu^PD cTȦۇGxbe||?'OajӧPlѢ zT/ KNȗJti |9+WN[d8^~}pFFy_KI 4簖-C75-"LZ22ʋG,RIX׮xY-{tjӼymlɓLJw_<Ь/lvO#E:cuގHjÒ?U-M:(Yꭽ4mpyٶoN+Lk{àY*w\9k|{ zh=[~a6T[4jhżԆӳgÇ D@oTTV ,,LڵkagRƍvt"•3RQq=GvDBP̩S(荊Ҏ"ts:;;BBPI||| RQ&))z ԆyӦM^h"E=/_655}-oG$anܿXbϞ=A(RQ!0vN:BP憣Ex{Ab]E9k6o|KG"+[lpp0oGCm[l^zRRoGBLؓjk׶nݐTA(ɓVVV111 aDGG(QA**)鬷c-K};=xp-uɕ(]n*eV4f`ߙڽ{@YjƍƆÇG)*~}8;;~}ñUիC DGK޽Lǎ-%E8^^^g s_~A*jƉ{aΝW]`eYkԨg@ca#0租Jcĉz 5HAEUh zӧWCEr|{ w획wRעҿmOfе(?~,Ydxx8oGxBmXۜ={aGWA l߾}PPPF* ۷=l_*=y*jĈ.xgϖظ|yS۶_O2uR@n.ykϝ;իnnJʣ~RQػwor}nP*+W޹s'oG" _~}ӦM+uԩJ*:6?3rdWh1cR.VPb(*]Rv펝/3XFՓ֩SS(dْ%ÙƲ۠-(0m((WWXhYW:L0 UΝ Bgy[YY;QT2:˫MvM7>.TnIժA?R)TQo1O޿kݺ+!.woCm|tzٲOVJ11ؘ9oiMEABBBBB҅+Bzի5K?~ sʕ'O~K)X`…-jllljjZxqss%K*UTҥ˔)cggW|+OUTA7Vz5jԪUN:kРAF4i믿6kťEnnn[n۶mv0hܹs׮]uٳg޽{۷_~ 4hА!C 6bĈQF3fܸqjL4iʔ)ӦM9sٳ! ѧ.X`ѢE/^tW\zk⼿qFM6mٲe۶m۷o߹s޽{C9rѣǏ ;yӧϜ9_.\tҕ+W]v7o޾}ݻǏ>}˗_~?|O>}%66۷o DdI@TX[[#}}}g<{2Ku֭xe#>} M'!·D4Tߢ}!3B"lذacYj 1jѵG7]>:~t8uB@"@(@.@4@:@@ȀԀ(4@LXdp|āЁ܁ $0>?H@AABHCDLEHF(9R!UQͮbŊtP:SB༇so/8@͒0,HfCf_ԥKv4!ÿ+&&fݺuCg:,::X}͛7,b_xC>y#Dܻw1|[nܸHPC0_z|eŋϟG`;w;<<'N@"ԏ;h A>|1`}{A޽k.4;v!lݺ4?-bÆ h]YMcժUh+V@Ylْ%KFL.\2|4___9s̚5 fƌL:mgh>'ND ?~<+ѣєF4|CA <mjhVGѸ3}MW^u ~C[C[@sԩZ\ǎڷovצMVZl myhNNNhhM6ET4nܘ5U֭[ vh g͚5BgU^jʕ+cWR% *T`r0,[,Ƅ`F=(QH333'MLL aYH 5 *1gˇ!ƢyŠ4w܈O4pΖ:עNtBoN }\\\:3tio{C'DzZZZSD׈$:Kt8}EW*WkTN]/:`t%cFN]5:lv8 SG׎8:{tC@ @@@@%@+@C4@:@@@F@L@R@X@^@d@j@pP!"=z(4@LXAtA@@@@@@@@`1Iay.BEAKM>  2 b |/0H12234h5 i |/T ͛! ! !!!!!!!"!%!(!+/251ʂ $0><{n#Ftx?.[36LhsGw,VБ#3*),ƻzrc۶ #Ea DC}xq+zbCnvysplRBSH!I4WFy_-ƫLHEߞWD5KE7j#cH131F"?6g{ݻʜgk}slW=+u0a{;\I<=G^~}:ʢFul3E)>>iΝM<Zp2*tp)%"MIOЮ͛9I::meem pϞWJHܜ;'DrK5<\~~OFM3hj$RD3aUUGgϞttv ƌ\X@AxCEeo>xl%)؇YiJd?ɢg;VxinL܈"]tv-,JWWV&$,sv mlzQ+u63*^"ne ւ:Y+E[䯣C ZTqr ~p(kkKV-Q!)+yV߱#ĉF9!Y}??9֏?^=kWSTVJ誘Nq&Z:=750(3_:En6"ꑑ"3WUmiΓ4RȑnnNOf%R_rDGm]]Dix'nkײK^ jv-E ΢gwM Hés6[jQ=s<97`Y\_ݍ4ʛ^dnnڷoJK"OlD̙ϩ.eձ͛9U9:ڜ:@AxCI'EG *uhEQYlhoaх$C,(9?inǍ9IyRϞfx\\0٘},:`?zTlb޽|XZrt*E>HbnU rNuLXYqEA1CDpuX r-.ee/jeeQ__dQ)F9#^aoE .RS#MKj]tVjM m9 7٢, V, VF -Jisy_h`Q9 X|Uv(twX "b Qx9RR[+c_ VWjj}(fݢ>,60S}+˕E&??O ¢K} g͚pqdnnʽ 'ON4l4, rͶgXPl_xQ(4˵ҥt E쥚l)==Gʛ̄JE]ٯ_?F֥f ɉe_%?gmm9lXtr1EK[ZedD慆077%%nkۛ}-x˖ސ+W;w¢ xwqtˋgLl|rM(Nt8y2q͚ff¯JH16|{l޼DtJ7BARE*}@k9 u`ࡲ]:32##oϭ3=|Xd7>y35yy8A2H[RH 0m҈/U`n.\T8;Eym۶::q  b#ŽpވȽ{?UY`QvPgQ:kEuy랕utHA>?]M#=Z~VT;j*&&Οj0d3zzw8}3}vݻwJVfysrq#}Ndb$??[73Uq[Ȣ؅[ S*zu-/âx@xCEYlTB/RPLh|7//Y1ɇi㖬zLtrY 9y>O7gdDرINau2RGqv??ϐ#nnNKIG-ۊ~^>xBjEETo4ÇrXoao]|sã1pMA>uuZY}}a}EWM2ېaBȹ1cs.VVJ?.7oiСClV߱#{,[Jci:;BaZZݻ2$pTH6eef<6cDcaTC>ыH;H8VE_5];tnnNL֬ttJmAHb-{f~=KJvsآѩSIs//3smo33aǎF^^]PaadERhs Kq )iLy(&̍MTQ/U|PyJ}}a]]bD$rNL\!o4nP ޺s{۩T8]t7Bu>(Z;aokįS[+1¾E/W*)Ӻu31(Z;aoUS#MIY[X^LrU(Z;aofX07`Q( 07`Q( 07`Q( 07ڴh>s1_9 2^X˜/IENDB`java-design-patterns-1.16.0/prototype/pom.xml000066400000000000000000000036001312550536300212110ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 prototype junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/prototype/src/000077500000000000000000000000001312550536300204645ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/main/000077500000000000000000000000001312550536300214105ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/main/java/000077500000000000000000000000001312550536300223315ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/main/java/com/000077500000000000000000000000001312550536300231075ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300247375ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/000077500000000000000000000000001312550536300270045ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/App.java000066400000000000000000000053611312550536300303740ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Prototype pattern is a creational design pattern in software development. It is used when the * type of objects to create is determined by a prototypical instance, which is cloned to produce * new objects. This pattern is used to: - avoid subclasses of an object creator in the client * application, like the abstract factory pattern does. - avoid the inherent cost of creating a new * object in the standard way (e.g., using the 'new' keyword) *

* In this example we have a factory class ({@link HeroFactoryImpl}) producing objects by cloning * the existing ones. The factory's prototype objects are given as constructor parameters. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { HeroFactory factory; Mage mage; Warlord warlord; Beast beast; factory = new HeroFactoryImpl(new ElfMage(), new ElfWarlord(), new ElfBeast()); mage = factory.createMage(); warlord = factory.createWarlord(); beast = factory.createBeast(); LOGGER.info(mage.toString()); LOGGER.info(warlord.toString()); LOGGER.info(beast.toString()); factory = new HeroFactoryImpl(new OrcMage(), new OrcWarlord(), new OrcBeast()); mage = factory.createMage(); warlord = factory.createWarlord(); beast = factory.createBeast(); LOGGER.info(mage.toString()); LOGGER.info(warlord.toString()); LOGGER.info(beast.toString()); } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/Beast.java000066400000000000000000000024651312550536300307140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * Beast * */ public abstract class Beast extends Prototype { @Override public abstract Beast clone() throws CloneNotSupportedException; } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java000066400000000000000000000026451312550536300313430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * ElfBeast * */ public class ElfBeast extends Beast { public ElfBeast() {} @Override public Beast clone() throws CloneNotSupportedException { return new ElfBeast(); } @Override public String toString() { return "Elven eagle"; } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java000066400000000000000000000026361312550536300311560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * ElfMage * */ public class ElfMage extends Mage { public ElfMage() {} @Override public Mage clone() throws CloneNotSupportedException { return new ElfMage(); } @Override public String toString() { return "Elven mage"; } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java000066400000000000000000000026631312550536300317170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * ElfWarlord * */ public class ElfWarlord extends Warlord { public ElfWarlord() {} @Override public Warlord clone() throws CloneNotSupportedException { return new ElfWarlord(); } @Override public String toString() { return "Elven warlord"; } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java000066400000000000000000000025401312550536300320750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * Interface for the factory class. * */ public interface HeroFactory { Mage createMage(); Warlord createWarlord(); Beast createBeast(); } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java000066400000000000000000000041221312550536300327150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * Concrete factory class. * */ public class HeroFactoryImpl implements HeroFactory { private Mage mage; private Warlord warlord; private Beast beast; /** * Constructor */ public HeroFactoryImpl(Mage mage, Warlord warlord, Beast beast) { this.mage = mage; this.warlord = warlord; this.beast = beast; } /** * Create mage */ public Mage createMage() { try { return mage.clone(); } catch (CloneNotSupportedException e) { return null; } } /** * Create warlord */ public Warlord createWarlord() { try { return warlord.clone(); } catch (CloneNotSupportedException e) { return null; } } /** * Create beast */ public Beast createBeast() { try { return beast.clone(); } catch (CloneNotSupportedException e) { return null; } } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/Mage.java000066400000000000000000000024621312550536300305240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * Mage * */ public abstract class Mage extends Prototype { @Override public abstract Mage clone() throws CloneNotSupportedException; } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java000066400000000000000000000026451312550536300313600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * OrcBeast * */ public class OrcBeast extends Beast { public OrcBeast() {} @Override public Beast clone() throws CloneNotSupportedException { return new OrcBeast(); } @Override public String toString() { return "Orcish wolf"; } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java000066400000000000000000000026371312550536300311740ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * OrcMage * */ public class OrcMage extends Mage { public OrcMage() {} @Override public Mage clone() throws CloneNotSupportedException { return new OrcMage(); } @Override public String toString() { return "Orcish mage"; } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java000066400000000000000000000026641312550536300317350ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * OrcWarlord * */ public class OrcWarlord extends Warlord { public OrcWarlord() {} @Override public Warlord clone() throws CloneNotSupportedException { return new OrcWarlord(); } @Override public String toString() { return "Orcish warlord"; } } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/Prototype.java000066400000000000000000000025011312550536300316520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * Prototype * */ public abstract class Prototype implements Cloneable { @Override public abstract Object clone() throws CloneNotSupportedException; } java-design-patterns-1.16.0/prototype/src/main/java/com/iluwatar/prototype/Warlord.java000066400000000000000000000024731312550536300312670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; /** * * Warlord * */ public abstract class Warlord extends Prototype { @Override public abstract Warlord clone() throws CloneNotSupportedException; } java-design-patterns-1.16.0/prototype/src/test/000077500000000000000000000000001312550536300214435ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/test/java/000077500000000000000000000000001312550536300223645ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/test/java/com/000077500000000000000000000000001312550536300231425ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247725ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/test/java/com/iluwatar/prototype/000077500000000000000000000000001312550536300270375ustar00rootroot00000000000000java-design-patterns-1.16.0/prototype/src/test/java/com/iluwatar/prototype/AppTest.java000066400000000000000000000024761312550536300312730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/prototype/src/test/java/com/iluwatar/prototype/HeroFactoryImplTest.java000066400000000000000000000043351312550536300336160ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; import org.junit.Test; import static org.junit.Assert.assertNull; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.when; /** * Date: 12/28/15 - 8:34 PM * * @author Jeroen Meulemeester */ public class HeroFactoryImplTest { @Test public void testFactory() throws Exception { final Mage mage = mock(Mage.class); final Warlord warlord = mock(Warlord.class); final Beast beast = mock(Beast.class); when(mage.clone()).thenThrow(CloneNotSupportedException.class); when(warlord.clone()).thenThrow(CloneNotSupportedException.class); when(beast.clone()).thenThrow(CloneNotSupportedException.class); final HeroFactoryImpl factory = new HeroFactoryImpl(mage, warlord, beast); assertNull(factory.createMage()); assertNull(factory.createWarlord()); assertNull(factory.createBeast()); verify(mage).clone(); verify(warlord).clone(); verify(beast).clone(); verifyNoMoreInteractions(mage, warlord, beast); } }java-design-patterns-1.16.0/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java000066400000000000000000000060231312550536300325500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.prototype; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNotSame; import static org.junit.Assert.assertSame; import java.util.Arrays; import java.util.Collection; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; /** * Date: 12/28/15 - 8:45 PM * @param

Prototype * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class PrototypeTest

{ @Parameterized.Parameters public static Collection data() { return Arrays.asList( new Object[]{new OrcBeast(), "Orcish wolf"}, new Object[]{new OrcMage(), "Orcish mage"}, new Object[]{new OrcWarlord(), "Orcish warlord"}, new Object[]{new ElfBeast(), "Elven eagle"}, new Object[]{new ElfMage(), "Elven mage"}, new Object[]{new ElfWarlord(), "Elven warlord"} ); } /** * The tested prototype instance */ private final Prototype testedPrototype; /** * The expected {@link Prototype#toString()} value */ private final String expectedToString; /** * Create a new test instance, using the given test object and expected value * * @param testedPrototype The tested prototype instance * @param expectedToString The expected {@link Prototype#toString()} value */ public PrototypeTest(final Prototype testedPrototype, final String expectedToString) { this.expectedToString = expectedToString; this.testedPrototype = testedPrototype; } @Test public void testPrototype() throws Exception { assertEquals(this.expectedToString, this.testedPrototype.toString()); final Object clone = this.testedPrototype.clone(); assertNotNull(clone); assertNotSame(clone, this.testedPrototype); assertSame(this.testedPrototype.getClass(), clone.getClass()); } } java-design-patterns-1.16.0/proxy/000077500000000000000000000000001312550536300170115ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/README.md000066400000000000000000000033611312550536300202730ustar00rootroot00000000000000--- layout: pattern title: Proxy folder: proxy permalink: /patterns/proxy/ pumlid: 9SR13OCm30NGLM00udktCS62eCI9x6yesrEfx_Jcehd69c5rEe3X7oBZE-q5HwpXOhahH95oRrHgt0msEldYPHClkow30J5rQko_qB3-VKYG_qjXBOrezGK0 categories: Structural tags: - Java - Gang Of Four - Difficulty-Beginner --- ## Also known as Surrogate ## Intent Provide a surrogate or placeholder for another object to control access to it. ![alt text](./etc/proxy.png "Proxy") ## Applicability Proxy is applicable whenever there is a need for a more versatile or sophisticated reference to an object than a simple pointer. Here are several common situations in which the Proxy pattern is applicable * Remote proxy provides a local representative for an object in a different address space. * Virtual proxy creates expensive objects on demand. * Protection proxy controls access to the original object. Protection proxies are useful when objects should have different access rights. ## Typical Use Case * Control access to another object * Lazy initialization * Implement logging * Facilitate network connection * Count references to an object ## Tutorials * [Controlling Access With Proxy Pattern](http://java-design-patterns.com/blog/controlling-access-with-proxy-pattern/) ## Presentations * [Proxy](https://github.com/iluwatar/java-design-patterns/tree/master/proxy/etc/presentation.html) ## Real world examples * [java.lang.reflect.Proxy](http://docs.oracle.com/javase/8/docs/api/java/lang/reflect/Proxy.html) * [Apache Commons Proxy](https://commons.apache.org/proper/commons-proxy/) * Mocking frameworks Mockito, Powermock, EasyMock ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/proxy/etc/000077500000000000000000000000001312550536300175645ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/etc/presentation.html000066400000000000000000000052531312550536300231720ustar00rootroot00000000000000 Title java-design-patterns-1.16.0/proxy/etc/proxy-concept.png000066400000000000000000000605751312550536300231210ustar00rootroot00000000000000PNG  IHDRh.kzTXtmxGraphModelMTҳH}W\WpI6$o4`0j:%>7\!f7 { 'lrE(z2`wgRߗōc BN}wa0[|( #B5?? }i`s0!0'~1_(|nôib%KꝑG bw5 MיB0V*x_>@̺f0~Ƿ荅ĀZm߈UƃsFG VU2(S8/Dg޷82aԓeN9b8ϥLY]g4XbC&ͭrPv 4fkw܎;l:ާu,?޿/vsy^Z% EҌ)HLsnQb4*eR:9\lh>2,XM7|JGY 1B3SFoϻk7Wä݅ĻVP8LwϪRpk674G}vIy Wtrp֏P'It/9GLF9Tt}rQM$=Zo0zi3d_:!b.WZڰS.~誇P`dW%]u֨ל0)CK4 "S{K tI|p]m6N1Nj$Eb}E~ Mߞ3),s0)#tuny0vQ,۞I5U"m2Q4.^ªB~rz ."W)9">(0LZ]6، B@xv5aL96[mS&d&n􊵉\ՒGet?Vbb .Bvt !*Eč]$!}vzI_Pƭ hrI/2DIMC:ٝ HIo~$OV2s0In zӐ.~Va `Mu_dp,Ve}+_!?.wO> IDATx^TUKnTlkwVF ;o *9xZw]=̜߿    Z@+&II&S%XMjNjgfl0 fշ(_jnV֔7J26cYM@(ct[%'P~ųI`(C͌H_v_ik~eZ5UQ5զcI@k_0 ʯa83__ik(J⒀i5 7fӱ$5ʯx _.U$ڷof͚1+Vڈ+V8qK׮2dVdF5,pFH5 7|۷غu o[~f8vڍrׯ'w.\qS}I󰳳?|$I3g?}iB_3mXV!@e #% 0Ç1s ,_۴Pa۷-Kf|W\AƍPv>t~w| d͖Mdϑ٘6m}Wwwď_x -ŋH>={k899ӧOȔ1,[ĉCkرѣGLjQТEKu^>}Lj5ưño^t3eF>}PXz03k-j["ʯ%:l55֥<;w}ة3&L.g6m!CpYZ۵Ş+Wn 2XIi1f(zNNr?3f4v؅$IMVKÇ@pa%VVVX`>lقvpIؠ~ȟ?? m nܸpqK.px9zo`{?"MxoErtPiiRbH02eLMX*kk{m}eEXpk~=/iӐ#gNP鳰psbDKnݲP~-Y["@վ>|p۶mXfO l*]!Yx5bƌw [7Q|YܻH)czx̛RJKjK}67 n^I~cǎ]8sW%?j/˗ȗ7'Jc'NAU l4%Kg'ܺy gRi޵CCGTC*ݴ66۷Znui3&Mٳ#ڵkCUnnsR Yb!cF#u4zDZLSFkj-2ʯ)NjNjg~`1#dbD-EkQʚʯ)j(ނ,? 7x& נZx`-ע5%"e5a[E'P~ųI`~_}ws7qE<2d 5k۴-^޿ۼYc?NH'\v;||wNN@\6R<Lې50S")zm]PzUTR7ĝ;~0n ;cm cGYvt 3O:4xaġ "3 @5Fd̓W*8>;h*m^[իEǍcF܅*:{zF~g̈K M5Ȓ%+ZD~D~Ǎg3g[k7ԯѽk',\0?WcROo CCQnM A1e Ϙϟ?O9j,6jZ5-\C?e$`|r@51[x藀|/Q~ ⌳gN&Nlc+ C"wDRHg VVV8}*g*^x[6Ug4_7moUEFʼnS) &K4|* (E Ǐ8~R~X/_լq>P~)3f: 6/:Elb_3Ëϱc;Vk}/]E B߬ٲa*֭)w(ʗ{7n\uDscĈGO_!A([ үp2CϮطw/F#W<3j5 &&Jg|յU+C{j֬ƫwUxͿp9D5P3dD*{)K#~Q6JD~1~ cWWT7MʯkF;b&3 ę0~ ʕ +͛7jSۗ/_{*vA Тek4ݻ*+ۦƋ1b\BJ:VGMnjz ׭QR˨9s׷̚)=F ȲCa`GT(W ΝǼE*ݘ1cZhKbGǬd;5FF~~3mkWK"W\s%H?c&M˗?DǨ1?%QmMȖ 6F~y4)hbJ5W<,_v?ɯd'Q`!9۷JlޤW4 NjYۻbŊSg}`ʯ~;U'٤k6miP~ \7ri٬|I3I]ȯ$='ȯA`A&ѣ?NA Ѣqz)kNͫߺP~W qكah3K'`L8LwD~Lŀ}inܸݺ(޳ʗ+]4i"Fl֥zΙs{Ή !S:dvڃB k{ǻw2y4i nsMḴ~_y y#a!s(ǫI@_mhϹ2N~d~_%JēǏѦuKܿW{M5W .-'N'Ϩ'Ng,TgD>;vlnNSyCcncGQv lش*T4QIb%KY HkFA%#\,@BF~M8Lwޤq;}hJGw./QRljeaf/ՖQVm)%yrcN8YwݒkʯI~ύД_40 ʯi%fx8"W;hw2"N]$9v(w T/Y`%J̙3cm?_.dɒϝCѢ04;D(5>Afzb$ePwwwF́,=/qP~ [ԫ=D~UAwGL0njGYнk'$IɓQTq53dD6w>5ovvqcGǏX~3*Vl!"ǥgOk!| ah3K'(bc}\_?C P";Hb$9rz-ri3fhq"=~ZEV.sgsH,9n!kF~!м<0+σB VXTϡF /'-P~eDMiW^"mj4h])J79R~uo,*ʯak̅4_ 3BmVx.Zacșxxc?$ #7\1F q|.{):/x{̗Cѥ[ψ'h)h^fC5F2֢Q~ 2_pf.$ (8k۷fA6N:~E~ȯDte},{DnV^y͟, ;v,D4 oݺ… Q^==v1 |oV 1"Ez)k8CqfǬW*K:tj_ٌ_ WV7iҤȝ;7:vjD(ߍ"+W[nT$IM'VH0[e2Wɯ6ҫK} Ӊ29y`@f$=È+V 3dLFS$3<+_rs; r j֬ ks96 <ZRK̛7OI}f`r\\\|MH'ryXbk+)Obg.n۶M-mXm۶U]WV6 vMEJrpd2yRDDf=Ҕ7J(h֬Z"K{4m/ ΚO0A=.$8AjkqD~e͗4Oold +]oH+#yV)^777uO`ܧ3i$lٲO:J.s̐'=x7nTKH#8I>}R?K.\PyȑCeL$kyB@Gnʗ H搧]h.g9 ";O:U 殮jbٲe1~x@&7n@dِ嗼rkҤz>Id#a<"L yJEQZp)KD,#r)+ړ"MCݻWoE","_n]3y2Ԯ][d|~yԩS* 1'5,=kʯqQNGSX뫢[V-e`iw瘟-֑}ߋ͆7ڴiJTY#?dH502U~ăB@"R^y4y j>Fu%-{U{dCDo%QdI"^vM<Ċ 666j)z'2:99K2d/0k,h=RchڴiUWaM֮BUkZoy~ԪVg.!YwA׿[bخx ӧN]s. $2Տw-HBΠ]Fz_HM~Q_Aց5oGC*{*_"_]4eAծ%k/cͳI 4\H07,uw [4? +0o7<|p_EpGT$gv(_ N:{w`)_0͍W/_"Og6caa\OX'IsE_;{ TGCQPp[ycxS~ IDAT˫_<ISgլR- 2Sf.:% -e?sʡ{amEV, %E^6O]1DUɷ,%2I x*Y} ,\,DsgűT]>bƊCGiHlްF;ʓc'MC )mb=|sE֨^.V,[dpMMݗRjⲤB:mCLZNiB?kl{ᯉe^j'T`+x蟀w˟ B&2Er}hֲ=Μ:k~ *ʏ%+7drJL{Կ-+7?/k7B6J.>ūTwXvq7n*AnpU|seChT2w"{8z:ܻ׺tׯ^y;nZ #󰚍Rz GThظ>++&LJX CđהJU/SrޱGDj@_5adE+qUtu[v#Nܾ`l{۷oPJ)>xI&CNqJ_='M_" 5 oa))cuZ]{bٿ[^!LM ޛ {vɰ`^}D̘Կꌴ6*+p+P׮^FJ%&dHmcgoŵϐvUׇtX>6HtSۦJEdȍޡHlߌ]>0jܿ;W.+"0CߢQ4{dz/z L<{=CUp {L/1^l0'`z].OU?W`t7j(y iw0i:2eʊf +!E7o\ dF̙ Ԙ9лƖkqp]>5 wnas7j?$BǮѯgG.Z.WGNP۹}RK`Ț-J5l0G wnuN{rfI["]8~0N^ ,&"وVPvL@- x9dYɩ !cܷ_H4kP6BMեΜD,},]7_Ŕw"ĶҢ hujڤ~~ϵJ'[.y]3#o_7rֶ]s[WkZ7gʗ̯6oަ k6{6zQ^9_}&{e-{"lTWi8yz=յ˟3#vBڕq}Ɣ8~:LA"9h"ҹM]m){u!S*4jCin([wÐ=q̏:j];#O0{Pk4{sg¼+qULw [dZR(2l,2M}GW.= id0g敃f#yk#_-Q/Cp6oXGȯ-r#֬ZY B9j*ڜ׳9pNm8\y4܋˗|ѫ#JK.F+)lڲ]`‡1yZ۷{إSKke+k-o6$8rz eWJMWC]1a#\̇CNs]lvP뛷8u謊Iȱc7ĶWϵ K5LCr!O5m^rEqFrE1tx{V2t3`zYjZG󜏥6a"xoیEA3;{^_=f02w ]o7xLq&`z/lۂ#cˎآ{Ȟ)-1Wup܏lcЧdjS#mv !NmXzow0ߛy]PGDA{;J /;D: S'Ľ~{& {)@vJdnكgOB|Xq'gȤ"W.ŨSp^_e3m^O67W?‰+Vl\y(taҟ wlyB=qEh\SK6|A0e<)W nb8xJfϔ[wVkuwܮf~]xvxu*10}ټK͐unڣπajg{)֮N s]7SKKVQ6~F]($4N `F~6o\K<'Ș9+ ';YsP=YEwޓf;v3"tޛ8LKNzo(\Z&{FMM~ez﯊ű jczo\8ѢG][hݾ!q[Cj*髁2I}G(^3eu({fUߜ>e0tTL5S=sREԅfW,=%Wߙ@ȻVA7ȺA}-]ESEJ[4#AWǏPrq|Nﭘ8Q lV>f2 *ED~YiVN]Xr!{Scz$$H`c'*vUAȑ3-_kXN+mW ͘&!čS#nxѹ bŎ\Bj۳zđD~%=xY?F۸m?ҤޫS N_Γ--MAڳ? ~-iNu^uYF {Z$~yJ-aܙ? P~ \9*}AI% '5M[bz#"iؠ}IdM"O{LEzA)i o7LE=]f[dXyL߭l{Z7\q/͸U~XS~-Y&MuHKawbR$`82x 0߿.3Dz$@{1i A͛7H*߿ D /7R:3%<#GѸqc >$@FAK5B 7I˖-C&Mp]FͻY;0Z_ʯvNH|HWwܹh߾aFͧ}Y0%_ʯ)WH hFlpE.\_lḰku 0bAb2k ƢR~ͼz$@Iר,Ff0ol_ʯeX{ .^3q PP~) ^eW/( @ P~)a*<H#/ڱ$@#@71%  Zԗ_v "@FVc$@fL ,Q_F͸j$`(_#, )kԗ_Sl]Lk5 0*D}5caH"P~)YI 6aڅ @@$@:#/:τH@K C7)$@$:F} - /Ww) X4N<!rx-ŋϞ=C߾}1|pfʓ ŔI,۷Xg;;;ܺuZ7VHp(_6D$`xӱ.@$8Q~#$@C7ik֔!ʯMH c*8D5. 2tLXv0(ѓY   I4 IfM׬;8+G$`\x1`iH pZbgI"o:ْ 8DׁH F7fF$@!8D嗃H F7fF$@p}{E$@$@S D6CFvd$@D7 jlV!ʯvMH c:i8D5Ғ 4tLXx0 (fёY   iKILל7F$`dx1aqH pZ`gI"o:E hp@$@#P3# pA$@#P3# o_r.lH'@e l>I,o:ج* )C_#, ^IHHHH P~)F5Y, c CNҥ8jɓ-qQT\9UXbpHH@P~)& @D~gώOȪkB:aLH_/$@$.=vڵkǏׯț7/бcG{ݺuC>}0i$lٲ1c % .rȡ ІM$@F ?~||ѣG#\]]q%ݻw/Ə[*r:uR-[6ԭ[7oD8qФIԮ]e˖U]v $P# })μy K/-EX] R~#ڇx= kƌDg+Vϟ?D-٣T~GvvvoߢJ*T]vSI,߿?8~(oaeejժ~H$gHEKWb$@f@ WPT)|]IDĉɓ6ɹ#FOf͚UAo>{Cnx;q6mڤ"UHfH DK5PWc6$@H 4mݺ5J.=Ν;8{,fΜ".ɓ;2eʨ_Y ׯ+{ƙ3gмysQHoUV5E,3 @$R~#1k c'Ҳ[[[SLQ[,Y8UT1g"M6]błZ 傓_OOOH2d/0k,h=RkӦM hCKզ\   0i_ʯIw`HHH!@j_x. 4/פ;0 O$`Zx1biI pcfHo:F0, XC_ * @dM'[ p[@$@#P3# pA$@#P3# o˓y W' wBgIDAT@pb7݇ vxю&=C_*H$@nd 0R_ʯvMH c:i8D5Ғ 4tLXx0 (fёY   iKILל7F$`dx1aqH pZ`gI"o:E hp@$@#P3# pA$@#P3# o.lH'@e l>I,o:ج* )C_#, 9M[u""qkZ=%0it$`8Q~͢#$@A7h'̙!ʯ9o֍Hcd ␀8Dn* Dt"<%8D巁H F7fF$@!8D嗃H F7fF$@p"\x O˞A$81} Xt,YU0R(F5Y, s$9*DE״z,KK$`x1cI,pEGf%HLo:N,% 3C_s߬ M! $qkݞU&,DyK$!qo o:C͌HB q/ o:C͌H(|E" =H pb7 ' XPc$`8Q~kX$@H7slU։L!ʯiXH c“Y8D5J hCڜsIIK ge$@" o"R~#ڇx= @0(jC@P~)AH X2~tH LFoH$8/7⽈) F@(a$FR<"NKx/b $@e )E'@F1 /@P~#V(_: O&\?1oݻ ċٳPdU,ҦI O>aX~-<~ZuLvرc1wwWtvEb;7h>-ysQh1df$r],%`P~)b 聀 L~'dKO>\wWڍ۰ R:d Lv=z!o޼س{7,={cP[nټ PxpŋH:{.E•.IZKR~ %!'8Qݷ``" ػ *cFcyxj׮s+V,pAK G%$@'&I5Rdɒy ojcӦx6k|}q9\~ ߾}CLefԭ]=~ -^ &%UV,YC q {ywJJ{Xx)4l\Rp68Od5=vٯұIuE=>$'gHx}Ȓ% ._ʽlJԮS7&4c2kP̢ P~)`I@_dp}od4q3n>~m[e`7ψ#<ƌ½{wHѸISȯ& ۷oa9Q{eT k"@~Gnم%Jڵ]v|6lB1%J%r|+UF}UƌC~~jޭҾ7W__EKR~ %+:c>5{uYXn*UV-bp9D5Jʔz#]I z#Ox-rG.0EE~-DSԭSK_7N,F~5d$,/_  =o =C֌KG Ѵq} 4K#3W. ∴P"4y F ];wo0pJ"˕Ѫu[;d[7:%J'@N7o+:#p6.S'|<8_ʯEttV M@{.۸aZ4kje+uQ?#F,ER~-$`h2 md=:-Yb|Û P~@I@(_~7H@@WZL*.#fٰQR~cP$`(ނ-?װeR~-ړ=d͍@xskT( KzwăH$ %5==r57(PBsA5(Z,+ %o5&1$ȯQ7 g61aرlP~uM鑀}N֎x5S~#)@ }z?(P8@5vaH >}eFPFR$ B^8;;cy`c1H@+SNݻ~z)/ 舀Wu1wIb2eZW\z掂#ؼy3ׯcǎA/yK_siIփ L@ M7A7w!^x8^@$C_dR$`ID~uҥߝ{vI>ϐ&1=Rt3hתRa_͹|o 7x X:~D~lZ)gOcXj\[7c?\:t(Γ`?6TiO7ix%[':ϰ\5]2:p V L6v=IbtΞB*ѻP,3"w?z(<~n*ϟcw5F6#CԮKpDg.UR9t`/ޱMhJEvIѭvSqA 4`rQ+.pwȝ5-@xl8vAX0ph8֨ I?~dJ{G~%E\(5׬\~SS~-m`}Ih P~iX00n"[w˟ B&~DNѬe{9upT(KVnBȹϙ[/[2KWn;~(_"/nޅl9\;|W(ck/l94oTT߃ ʈ->ШNe?v޽EL)qu6a{c9> )n߂x؀j7.]8q{q=}7پFf;Jӧ3w^VE|E~.]| ˨^D` pcۮKgfUnwjTIl!`;T9v _훱g/Y߳wL$`(8 D'! 8}jU-atdʔVWB(勾?o޸=`ʍ3.!u`ư]NcƵ8qf.T͚;~0yV@j5qXYc׳# -KCޚ8rE:Ԩ\WGlUz^aT9ZhwuBރ3K*ߺgc8tJ`94YFcj HH!JN]S'ׯ?d$5Zu^æsgNMze[k>t\ׯb uDݻthb[EW|uڤ~{ڃb$@$'_ p "% c_=T(=-/ h%@~=WnĚU!?kAZ1GMO@z4'"qi Q+O~摃{q/zwD2vi\E8֨v%%M[ rؠ^=;R|vtJ~sz] v咒~M%Z. @BU$qжCWL9aC\hױ*۾;-;!5v:"{werؾ# p 7 x !P~ AyPGDA{;|W_|ݹ'jigϞbĐ>?y&3K2|{mT"v<{J;>C&\r)Fw.6/'nԚ# h"MUǏp-Ċ_~;4Wuq8J-]ئ1/{hѸl@ *}9ay(SfOńCqĕ@͞)8޹]muͯy.c<)f.sȜ} CV;kuOѰv%wJmҾZZGwIȯ>2M  P~g+H^o|;EEh**Rڢau "<~8~6vzo1J`'1QPQ,7'% }ϢM:8tO*s(YҤŊ5"];4ޣ&ĉ1c? G.m,̝+UC^4 zvĺȯ\$?rH_5߸Yk,"éب k 9u U_@v[t}WK.bUr݈j[6;k` $ۮy]4lT7ri;i(L \5=sPqYH'69㑞/g泋_Sdvu}3oíu'o6@ #ni\G.X@N`~_~ƻ]e6m~H@[W C#@ Z@֟@)>6z:ٱ!Eo"R}~=@)~'Ш@ F3Vm PU?"6E@,oH+:oUP(~[ G1TrH7RWo ,oW\uoUP(~[ {G1(oH VSrjE@[L@) }?goD zhX`~l~⪣l~jF@[L@)X,9ǝ%@@ª) @ȴb1>IENDB`java-design-patterns-1.16.0/proxy/etc/proxy-concept.xml000066400000000000000000000050021312550536300231150ustar00rootroot00000000000000 7Vhtb5swEP41kbYPnQJuaPexeVv3YVK1aur60YEL8WowM05K+utnYxswkC6p2rSbmkoNfnx3vpfnLsAATZLiC8fZ6huLgA78YVQM0HTg+x4KPPmlkK1GziwQcxIZoRq4Jg9gwKFB1ySC3BEUjFFBMhcMWZpCKBwMc87uXbElo+6pGY6hA1yHmHbRGxKJlUbPR8MavwQSr+zJ3tDsLHB4F3O2Ts15Ax8ty4/eTrC1ZeTzFY7YfQNCswGacMaEvkqKCVCVW5s2rTffsVv5zSEV+yica4UNpmuwHgdUqo4z5Z3YmowEv9fKpXGCeUzSAbqQu8OskP8lWAam8BPBMr132tgTUIgTTEls9ELpG/DapryKzXd5MmkAOJEGx7S7+qpsLHEIFeyqOBZl/KR9yoJ3EAtcrxe/FKtq7UVbVmJZG1txlTLLZRudtzvQJ6WYwlI0crzLdje8PpdfxgMlW9b4ww15wDz6qKU3TLJuT/d8xzF/A1wQ2Z4XmkXTkmdjw6mpdmjMpNSSlt20JJLlaLxkqTDDxfPNeo4TQtVYugS6AWVVlU4kVAkpGak6YZTx8mTbvWicC87uoLEzLD+KahxHRMbb2Juezrz5qIpEuQ/Fzhb1qsaXAxVYAoJvpYhR8M/NrDCz1A6h+3owVeNk5Q4lMxDNMIwr0/VAkBdmJvTPB+vumxoQVTd+B0yP1awR2fQGbFOuHPcf68g8w+lBPSLddnUquPTl9VvlhYmPfJf4fcz3TnuYHzwH8f23TPwrzortO+X/O8oHnkv5s9ERGY/eIuN336VNqCrE/k3wj99SzAL19zw0G70iy7pPHLNCQBrlnQpJ8EI9y8nVgrLwTsYuIZv8QC/nZVmmQzfjMg98+1Phn0Z2eWv3CiIaW3J1awxoDyDqPBu28iq9ZGsegnuLJCTtQTQeq7rpbybYJpMDxYJs3CP7MmzMXTGiWL+jlAi1aqQ9NUrNB8GWHd/7iyEdXsdQWe8qxP0o8PmoFPCaBKiL/tOoVAQodw5v1SeSxn8nzUGkQd37sR85PEYYlkHq8kXN6wjnK4gMLZp0MZTwOpSoZ0mXSE8sPnov/mHF77s12V35lKVQ9izmomd8NOZFKWLWbULs8RPSJcvz/YToEI/CiKD1hqF643AsSsgi4W1DLFMC+eEO1wzTFvfkm1zWb1y1eP1aG83+AA==java-design-patterns-1.16.0/proxy/etc/proxy.png000066400000000000000000000546511312550536300214660ustar00rootroot00000000000000PNG  IHDRS4y`YpIDATx] \Y}-˺$$B"TJDrK ɛZڔ[( \\V Kn]vڿwweYkwe34533ysy~=s"@ BBM@ @L 67  U_B-A=Mu =^C$֖ 4;hkRG.JR-$KɦDf*I,{$I$BlK m7Ρ]VcUIn1cLǎmuhmmVP'6=DTԁAOjXJͧ?6[6?{V~91yy+Te]aaS>-CۿG۔'CcZ;PmKd|NqBœ~z೺Ϻ̙}mm-BC'![Y2gGN?*7?~YW۷nwIOsb\Z)-x@E[,EӽG5L?у[nqi޺U"펡1bϽCְt.ɓKYW´'ac?xg@;Ŏ˪>;PmKtAi32h{H[Ƌ۶m $LԦMyL}{+}! cjj#ٓɋ 'ñsYa8;PmKtAiV:6d?]q*c^k88X1˹ p!{PsKn74l÷ bP?ue^(̬Y@ eƠKc?Νb1ZAT[Rd>k}dP%ecIF vY*1-@Bœ\mҠh3,,L2pD7ۋJ`lf֕V?Y"hc1\%Q!׾}+=+g wڢ-"^#͚ڪ͌?Q/occnjj'W͛睔bnc4kք} 3 GgQuڷήϙ3WoE/})T5[BFlK$m&;h RG.JR-$KɦDf*I,{$I$BlK6_ov7*e:ˆ!֖;vjKiӦTXScڼ{xsv[acDuw:yM2ȷf_숸C;95PlȡGܥK33vv}aD9>WRT׮AV˖211l >ڦڇ _{QϞwSmP;N곥7 kS C+2p455BQghX1YNHcK `ĽuC"ܤ?+Æ70xD|~5ya9~|] |af+GZV'mVO?63kU/]ځrakXy9Aoa= ])@_*Nٙ;[,FSx8l`[yGٹ3?ݶ-iy98X}~TQQĹ"6#ȪC+WJ ٸHm[Θ1I@Jooۀs&W!Cz߸/}kOڄØ%5/ҜR'R2 צ^ڴiȳg_MIiD!MN-޾[̔WO>مC x=<><#3R_P~q/|=1A;)%ͺ92#53w,8nzf_qߓd]ɋ/U|3'k2:uk[2G~_I5x,N~?4 eH6wFrsY9h^|Ӧ`/s}v%l.\I{K$yk onޥmۖg1Gҥ'5CUV[ZVOxl)I<|9;i׮: A>3_R /amnC=Η\n>1ɛg,5lcOѫ8dnr;#c!n/愆(==J˖"%KХttW6i޼QH!~Ϟ;9Yca/7W{cw\飆 cf9d_NbX~o | 1n^⩿>R'R2 M}i. KNSQ}wcSSfsc^k'!a;Y/amru]糖 D{,cq2wZbpڤ?AAA.&Nt~} s+-mOZTIkj6qw/VoC<90 [y4$Vĕc݀.X`ڔ)z=f<'78$q9.[/??EHٳQj"Q$̌S RmOZTIkj6Ϟ=ۗ _^Ⱜl x01&vm25Z777nǎe[GSq 5&D>l'f]x\{7JK{QeH;0wch|ȠJZS˴#<nDRKzu/gS*)O9}"֭j.q~*pرmo[Zq=6sQ;Օm?"nѰaCCS٨Q=Aׯ۔[2KHT wЌ7v`A&Sӈ3gҽ]R])QT12}߅ }>-Cռn:9rtN}m!$dB"6mZgw&m?jI Yis[y0ϟ 3RԽMP.Kwp^FVPQm6tB (t_2t,)I533F6?ztR-Z_(r.9dHo4ٳ=yRkɓggGILj;l;8X:m5FT)ށ2+- :0$dҔ)-ϞéB774tK2a Y8m5AKkڴgӧל'6=DH2kNXt/Bit<2orPU*#w c U39etg5D\G]R'WMWrTzs4]pk4o\um[n-slȑ,9s&lٲts˖?|Bv;ȯ0ltCۻ7$%%۷;CpPO ǎm)t2ktCww[~>ۀڵ=}p5itkZ9݋`m'fޥ#i/\JEOzz?Ν^k*8i3LK46n߱c۱cP)o?(Y$z:]Vx*+w,t W ^ЗWP+0e1Ƣ01qq( QQh%5 q0vwaEf)-p aRRyY&H:!p9e;Ũ={v靖6ˬf)^Φcv]pJVFE 8]W2X#*N0ۀ/nH YNٌ{ nPڌ 84nZ'5OM6]~Zw/ gF#,?qHdӧ D?xͦsS/33̜!Oz;.s͛7x;ULT!;RzB(kabFyi&={vfޱc–-LKǐ6R,'Mg'8d%K,[]C?"i22%qNNP- ~H:WF% ;h RG.QQmQA[H=Muj3_ܺU˷nտq~;}پVs$f‡gΤ#ĉԩM,aû&)SS>֨QCܫ|!co#7nĊwԯ_ӧ$qwߝ믧%إd2)}/veO;EqkZPС r *[HE)Oj"YJH6%v2zеa.}Fkf$(rP&ȒLmVDG۷۶iLDE%VTP3ϟV<(9Ӄ-ISUuulW9.ʿ޾…lWu` H ijUԌW+tbe[S6\Þ&"񾪯vILφ7OJ bj}C.]!@Oa2D.^Ǽ(Hh3Axl/FեձE D< =ִigx/阒T33c6kjl} l$n:0$dҔ)gӧC}R3ۥNH=jME<=lk*fnU|ĭOSc32NB]qy{{'OJ7oˋqWĉNǎmxӎD{]+KW~~"dOof6m8n~.)x/1S1$+o!Q۶-1RͷC,{ ,&ʶf-KY6#p{[Bh?aŮm>h[u,ZP?'--*EoFVkq+_d:ڵ^Y[$K 99/w̅@8z\Vެn>Q#٦r)~FLG|w 6s+bi,{ vYkVbm'Lpt65mڄժArbHiSyhsjưa_+:[T媪6C$.sEuz?t+=zt}jTܿ?tż0Bx/YIĔo555b۰3n!+7sBS*]r;MSAAm{1$JU3Pz杜iz Zj)Vu&aN*-F ;m9͡^4~H0lYrCu֬6)q_]aر-{4xXP_/m`"{$\lբE!k~ۥKx e.^'j!i~~a^߻w SIR{TH<)Eؽ{'7kfUN[B1իNCj "F51T $0Z`Iy'AC!R"i3<3t$Ŧ{s6.h,IU6'_+iG}w`ff rƌ1l"7j!" v֑t\Hv _'\QO/iWx(QIWX!(3>Lq0Vw/kg__7m￟hh]F߾[w~:Pη9LZQq-t/ap _ʨHA^$?ώ=-[󄳅ϞϜ遇9-|aY8:gC?-##mֱ6KQ{O6i36FW>~{ ]+(IHjf1 prBx)qq ~3hmm 0FQZuT٬ޥKMPߍK6K[Vjn*?ȱ&De)(kabFH&gyy+-q.6"FʹQּ͛݇I˧ ˖3qm[|}|DDD(i)ft.dÝx1G$v YCcmǎeo",-!q7|^RO嗊/Z=⧟^Jm*ĪkݸfE%t ǚDe)aV~C_ⱸq8#R"yv-]~[LHũ- Fȼ? M❶I;E={PNյW^pg-,^N?s&}^l9,''ZB^ͳzXF6K `%?p޳ee[̌٢FkքߋiʦrYUq)N[jn*?ȱ&i3QY w3CFm L/I\^ LV<;֖@Cs5sRRt kϞ YNju֭"@zR!7Nq g_ s 7oDHf͚N΂d<Γ6ē4Vc$IϺw$}ﰔVؘ#1}B^|C+nl}rY/9w㒩|6x5jn*ΚDe)WŁ3'061xf?}ZѺ@CwҥK±:zlzVFQzqUZJ w#(It Ӧ6`J4ȍ7"fAY ~ \-j64=R#ipYm6U;!Uk)2>+++Y,6ȦjMfA[BKyyy4Nj}Df*IPyK沟RB >]YmH9ˠKNdA[""",--eN"KiMٴ^)mVۮuk6wRUUU+W%K tufPI~hرCٙ3=vzvnߓ7NT_[3] wRlz͛7CCCkE LPff|Jk,gqs:9d]Xݶ_[6k T```ƍdplJ.B2Ybp\":p^SS#= ldiV :i6k kTQQ9BΟR!i~,Yq_7isuԲH-͚ѯ_.>[΍YW;xZ&S`?|H3yP5MQ7UR%%%֔iLA:$V9oYWߛŬb+zػ57R6aׁ>Xd"f_u%f:Q戣)l@ʙWUuulvT;*?,X0M$^ Ibz|K9NKK]KR?( Ꙃ*dXM Ӗ3蟛۠ zz۱c|mW lkfM(WIntQ8035?~*f~$ l"q\O052oiSDF "R䬠֓`SB,k葧Mammfkkq%yʮC⦽zu $K$gܮl-fnXLq^ظ}ZZ0qT=Q6%+o&*K5(OTU#K!IuDeI= %fb8VuR:If]i3QYRfh׮7,$mUME}겤ט'kv5KlHn'K5kSB.xd S I,5jAS6%+ͼL4/D z=<<߿/= @LT*dqhhhnnC  ռԩM ZZpMMvQgO:İS0#cJ֭Fa v寠 YBY8zqjj B 4E9h [T\H_n#Ν߾}(|SЦM ׮16nm~朚Ξ=ni*95uJӧezu iJp "WMB!m3oW2*R!/ K$~?Qآ[,27.H.̙}mm-BC'|99Yge-EVn85~#\'&f&ttA}6ڛ44]As80pǥ{ܿ?'ڵf'v_O lytaHۢu"7oցG7sK6oܸqhh B 9Z.o~ "=~~':;! P;w)@$_A ))a,o/(-ܲ{|P2TD.d Ɯm풙J j"gӡ9s&@k3J8mڈ97{ ,+ۂ6پ=ݽ{ FtDꎴY%t钗>EbytqPP67dy<CDJc 礥E>|x[|?x/o *ћYTT^f# ɶH?CysFF~4Tm.V?"Q5[ē6 7ogtttvv6M&YfV)f>qHd RÆ~}/Sz5r“?\$]r\:n'+')5ss6n ߹3ѣH>_`$iK'.dwixG<8ڬՏYU(//7669)@WԬͳ2%ǭ.C!ɾbͻefAK- ϕ+焄9l#UjBD? T9>p`/drr^4r~8 JȲ-ffP ׬ x1V,}#d*k^ͳ!?"VpT/xEEE.@4 2jk`zIePfn:N>ϝ@X&ϜI(PY6C#""LzuBQm8Dn=ÇgH LC 2җþso>7iJ ҧOz*s5ʺeYT?uO߿?44|e~(cv]pJVFE 8Nz\!Cz}IS::>># `;=H'vsdT$[G ~^"6&&1;;;jl-[# E fkkk:召|}pjxGxLJ7n vqs@i-<ȑčufI)+ UUU^^^CtA^fm;+o˛_19{6}ȗ#Ι3zYZmۖy޻7ڵ; Lܲ"yfr̉x˸=C2X-o*;: Fc.]:0)~W_??,l w 1g8y{df.a^Q7977˴#@8jF#,?qH~@clgCkk!Ē7;#c!2a!>.(H ֭#"~?k3t{ 1|رC1>@2~ȊK9m&UU0#|׮l'r5 4@fzEfʖ.@ @l5cH1#CD$& ʏo mKOY~b mNM]ˇ ^-*Zge±9/o?`@sp!LWh'O^6...\:Vl6g^QK^ʕ+׭['UP6OpK<X8tDӔm133~,kքB̤ګWi_|wn]e Mʕ\KK1!a2Z4O"留UN[$ٳYX~LsXNN4+ Zl%@E 9g^h8NjU9LJk3|Ӟ=;X$ vVwح[G6 >>oL De)mtsf@^6Ƶyҥ-@ fnPeSE4Ջ@ 46Vyftt29DDD0GRisuj`d֬Y3Zh@ 6L+**rʅ <G@ a,x̚.@ hZʃ~l>ڵkGR=vhJ{ʊ M"-fL?6 EEE0 Y=8pqrr B  AkJ@?670a%.]D'AyZ+N~lWܼyYf.@ 45qRɻЏ$/ɍ@ 4>ׯ4ݕc{Fb(ySGhhuW|@hL}|| OpLL̐!CgϞɓΝ;3lҤIܺuW^^?~|)777'',w~lO~gϞ!cǎL2@rHeӦ.@ 84׮]ӧW?aoo̙3g:t×}}ݳgώ9]>gΜ-[l.܏k׮]hLKK7o+$m惛UYYImym^j{O>nɊ+%;ammsfdqFyx]BȈmE @ڼn:1qڜf8wsO===srr4hЈ#~x,++333H#f͚/Q?ׯ_"]̆2111hL={G866"~x^hQpKMZ}||?~,_Glϐokkk ye6&"=fI !GDb lNMM#F\\iРԚ ܸq|.]6m@BBJgfxdl@ ( j3meee522* -,--}}}5@ 7|yc??+WNý355U0ZF[0`/hU/@p$"333=<<́і "'44TUcA6߿M6?<j%^bh @fN...8'+~79^x4Ջ@ fhI='-09XZZT/@"WEM$!-apLL H{ -]xEEE"ZՋ@ f(1_ Cek 5b=!Kz=T/@RZEFFF'i#$6>?N3A!tm\]]mccVٔ.6]omtڵ111Æ HPyzzk@%h6^^^ 4?INdFڵks0XnC2@ ?MP؛UVV*[@  f?DS%̦zËz@s6 ]/]ϧҾ m֤6nZWVv@ H56mڸٿ?Q&=y8vZ;T%5jN<HcAi3把7n `bZ&.Yc孨om~ ˟<)mڴvO>A9afb[4Ջ@ ;w@Y] _3gz {oeɜ9^:6:u`HȤ)S\!gӧBի:8X ;0pǥH6:+kc^{шҥVVݭ6o^b$x1r.-HV%Y$2bbbb@)͟-mhɌ[RRXd߾/_ޱ~)8}hB:6C۶m _1{]ӧ)ϞM9Җ%3g–-eK>s͛7Y߃TgůiXwCwXV],- uV  t(A,_+'FZ!3!ĉȮ] qjӦyepY Xis\\q{8 <ਨ$s,}+/鬸S.5+yu15jsu,z:/@ f% rw)3D`׮8Oa30鮋ˀ x14\۲AQ:&g0aLS6㦽zuaY33G"fM(^6KԩM66Pk2{ǥ[ľ}+=+^ H(f͚eff"PTTŶ ruu:ti7n@ |~_WC II!]= 7wLfڳgg{#3Ő2Z[EY?%N!M6ڵ+dbahi3@ h[̏y]6bDYa}}ݐ3[N$0p,M-5lX7?oJȪ 5kBơ5?!m&QmNO9bI0{G_p2_`lYS.lE #lo޹3n4YYKvƿr?bp-FEtj81iiȪC+Wi35e.\/\߿gƯ#%m۶1c Nٓ.;s2-,LCq#_I rE =yccs}" K\YIÇg5jaÆ_|s|GS@[[ $}l:yD'.vZm駹}ʶ nS6߹S 2 ۷nj6xW?_z5_=z;5i3@ u|r|Gm2"d"~mcgាn(nٳh檞9i3K`2cc_%@4YƢW/Y͛ᰰp §OU}U?yR ˾v^kTUu_II!?4a#~H8uQ[6>PGO d^AiϨoǎjh&9Vġ^FD4nGg|VQ6- d9޽{7"%Đ游@9\?0bpEVv .Ʌ MR#[ Mԩ%113OM6׿d&m&B}.ڜB31c;0F 8kBގjC@ }sZ˴yH[7~8u!|mlV^T,S}VěSAn={V2<{Ϝ1m$;z4v}f@ eҰm\tWy Ą,7OyÆ نʜed,DСdŜЗ? G{n-!WCUp7o֧)͞={$ N=o8(؃%}w=fݹsӧ6ǥ@Pm};jעهN q28ڤ?9 ϟ=q{-,L}`rӦMJ sqcǶG%K<>_p l"g MRRT/+ԑ#{vFi@  >zWĬ _ b$HL ZA7*H:Oi6AI>T@HI  ,66AX m&m&@LL aA\Xܺu q%m&@y|j^m!m&6߻w|x gx<'NtBoZ:mڈ1c쒒BBC'-^'ʌ7 #27‡%5u1d7ѣ>># 0p![">3ssXF7/p7p $ ?gǏK?1x%zjU18%$́]NNC\Amp M믧G>SZi>yr,qčʝ(@Ϟ50&@$ĖHi3@ yqܮ`Pee[Bhqڵ= KAm͍۱c<_~h $ֳfy@fx\{7JK{QeH;qoNxuff@ Ji3NQ7o^z.LL[+m޲eqFBD.Y Ã'~mi#-faaᚂ$D<.網nKӮBXIIQ?&m&ڠ&8l??'BN?4HhÇDE@⬵ٮ]qH;:'Dryߓ礗CB& s $ ĉY<8=z+#̤@-4?O[ T@PH5Gy i3@  f͒@ i3i3@ ff@  fB=A&ցf  ,66AX m&m&@LL a悩40@ 7L a@ i3i3@ ff@  ͤ@HI  ,66AXP6)?+ƌ+/ڧSX ZZpiLMvQ|x_LM]`4"#},g;}QMϟWrӲ^~!%s#m&J6w+Y)P:s 8RCB&MN40xcQ2 rrZ:y08Qabbx󼳳NqѣlٲW\ϞϜao"4tˇYΙnp/'(m=ḳgGG &f&n3{'OJYdfHL :fm;+o˛_19{6}H[3gts۶-+#woµk{1.q˖?|1B7o/'ϟϜ8ر 0رI#K =d8[RRX<|y?C!`LХK&}lW_G~)8ޡCk0Dz{df.a!i3@ ꌚQ%Oſx"&..ظ=\a,**rdgXivv}Xb0Ͽ\1vIs"ݺuDo#|mro!3;v(HYq)MoM"P~V |k&(h<+ I PgԬF^3+38D$?MbȡN#9mXBSSa_}YYp9m[G?+%PG\?f.+0`ɓW͠ˀ x1YdfHL :fmx,.8nuq)+bffY׬ Ik3ĵW5&bͻefAn-i+&}5cBœpeKh9?D.~Ȩ]uﴙϞ=3gFrrYdfHL :C`Ι!$./ZӬZlcc/gǥ ߴgp|'ݺUv֑ ϝ@9!6&& 9xN15MJ $q?{V09;;ysxY&Pz$Pf''YdfHL :CP+LbB@N2J_28*L6V`#]!m&B}@ڬc$m&B@LL a@ i3i3@ ff@  fB=A&ցd@ a@ a@ a)IENDB`java-design-patterns-1.16.0/proxy/etc/proxy.ucls000066400000000000000000000107741312550536300216460ustar00rootroot00000000000000 java-design-patterns-1.16.0/proxy/etc/proxy.urm.puml000066400000000000000000000013031312550536300224430ustar00rootroot00000000000000@startuml package com.iluwatar.proxy { class App { + App() + main(args : String[]) {static} } class IvoryTower { - LOGGER : Logger {static} + IvoryTower() + enter(wizard : Wizard) } class Wizard { - name : String + Wizard(name : String) + toString() : String } interface WizardTower { + enter(Wizard) {abstract} } class WizardTowerProxy { - LOGGER : Logger {static} - NUM_WIZARDS_ALLOWED : int {static} - numWizards : int - tower : WizardTower + WizardTowerProxy(tower : WizardTower) + enter(wizard : Wizard) } } WizardTowerProxy --> "-tower" WizardTower IvoryTower ..|> WizardTower WizardTowerProxy ..|> WizardTower @endumljava-design-patterns-1.16.0/proxy/pom.xml000066400000000000000000000035741312550536300203370ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 proxy junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/proxy/src/000077500000000000000000000000001312550536300176005ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/main/000077500000000000000000000000001312550536300205245ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/main/java/000077500000000000000000000000001312550536300214455ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/main/java/com/000077500000000000000000000000001312550536300222235ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300240535ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/proxy/000077500000000000000000000000001312550536300252345ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/proxy/App.java000066400000000000000000000045301312550536300266210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; /** * * A proxy, in its most general form, is a class functioning as an interface to something else. The * proxy could interface to anything: a network connection, a large object in memory, a file, or * some other resource that is expensive or impossible to duplicate. In short, a proxy is a wrapper * or agent object that is being called by the client to access the real serving object behind the * scenes. *

* The Proxy design pattern allows you to provide an interface to other objects by creating a * wrapper class as the proxy. The wrapper class, which is the proxy, can add additional * functionality to the object of interest without changing the object's code. *

* In this example the proxy ({@link WizardTowerProxy}) controls access to the actual object ( * {@link IvoryTower}). * */ public class App { /** * Program entry point */ public static void main(String[] args) { WizardTowerProxy proxy = new WizardTowerProxy(new IvoryTower()); proxy.enter(new Wizard("Red wizard")); proxy.enter(new Wizard("White wizard")); proxy.enter(new Wizard("Black wizard")); proxy.enter(new Wizard("Green wizard")); proxy.enter(new Wizard("Brown wizard")); } } java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java000066400000000000000000000030101312550536300302220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The object to be proxyed. * */ public class IvoryTower implements WizardTower { private static final Logger LOGGER = LoggerFactory.getLogger(IvoryTower.class); public void enter(Wizard wizard) { LOGGER.info("{} enters the tower.", wizard); } } java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/proxy/Wizard.java000066400000000000000000000025371312550536300273460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; /** * * Wizard * */ public class Wizard { private final String name; public Wizard(String name) { this.name = name; } @Override public String toString() { return name; } } java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java000066400000000000000000000023661312550536300303670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; /** * WizardTower interface */ public interface WizardTower { void enter(Wizard wizard); } java-design-patterns-1.16.0/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java000066400000000000000000000035131312550536300314240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The proxy controlling access to the {@link IvoryTower}. * */ public class WizardTowerProxy implements WizardTower { private static final Logger LOGGER = LoggerFactory.getLogger(WizardTowerProxy.class); private static final int NUM_WIZARDS_ALLOWED = 3; private int numWizards; private final WizardTower tower; public WizardTowerProxy(WizardTower tower) { this.tower = tower; } @Override public void enter(Wizard wizard) { if (numWizards < NUM_WIZARDS_ALLOWED) { tower.enter(wizard); numWizards++; } else { LOGGER.info("{} is not allowed to enter!", wizard); } } } java-design-patterns-1.16.0/proxy/src/test/000077500000000000000000000000001312550536300205575ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/test/java/000077500000000000000000000000001312550536300215005ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/test/java/com/000077500000000000000000000000001312550536300222565ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300241065ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/000077500000000000000000000000001312550536300252675ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/AppTest.java000066400000000000000000000024721312550536300275170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java000066400000000000000000000044271312550536300311320ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; import com.iluwatar.proxy.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import java.util.Arrays; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; /** * Tests for {@link IvoryTower} */ public class IvoryTowerTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(IvoryTower.class); } @After public void tearDown() { appender.stop(); } @Test public void testEnter() throws Exception { final Wizard[] wizards = new Wizard[]{ new Wizard("Gandalf"), new Wizard("Dumbledore"), new Wizard("Oz"), new Wizard("Merlin") }; IvoryTower tower = new IvoryTower(); for (Wizard wizard : wizards) { tower.enter(wizard); } assertTrue(appender.logContains("Gandalf enters the tower.")); assertTrue(appender.logContains("Dumbledore enters the tower.")); assertTrue(appender.logContains("Oz enters the tower.")); assertTrue(appender.logContains("Merlin enters the tower.")); assertEquals(4, appender.getLogSize()); } } java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java000066400000000000000000000030071312550536300302320ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Tests for {@link Wizard} */ public class WizardTest { @Test public void testToString() throws Exception { final String[] wizardNames = {"Gandalf", "Dumbledore", "Oz", "Merlin"}; for (String name : wizardNames) { assertEquals(name, new Wizard(name).toString()); } } }java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java000066400000000000000000000044421312550536300323210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy; import com.iluwatar.proxy.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; /** * Tests for {@link WizardTowerProxy} */ public class WizardTowerProxyTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } @Test public void testEnter() throws Exception { final Wizard[] wizards = new Wizard[]{ new Wizard("Gandalf"), new Wizard("Dumbledore"), new Wizard("Oz"), new Wizard("Merlin") }; final WizardTowerProxy proxy = new WizardTowerProxy(new IvoryTower()); for (Wizard wizard : wizards) { proxy.enter(wizard); } assertTrue(appender.logContains("Gandalf enters the tower.")); assertTrue(appender.logContains("Dumbledore enters the tower.")); assertTrue(appender.logContains("Oz enters the tower.")); assertTrue(appender.logContains("Merlin is not allowed to enter!")); assertEquals(4, appender.getLogSize()); } } java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/utils/000077500000000000000000000000001312550536300264275ustar00rootroot00000000000000java-design-patterns-1.16.0/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java000066400000000000000000000040521312550536300325110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.proxy.utils; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; /** * InMemory Log Appender Util. */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getFormattedMessage().equals(message)); } public int getLogSize() { return log.size(); } } java-design-patterns-1.16.0/publish-subscribe/000077500000000000000000000000001312550536300212555ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/.gitignore000066400000000000000000000000111312550536300232350ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/publish-subscribe/README.md000066400000000000000000000011321312550536300225310ustar00rootroot00000000000000--- layout: pattern title: Publish Subscribe folder: publish-subscribe permalink: /patterns/publish-subscribe/ categories: Integration tags: - Java - EIP - Apache Camel™ --- ## Intent Broadcast messages from sender to all the interested receivers. ![alt text](./etc/publish-subscribe.png "Publish Subscribe Channel") ## Applicability Use the Publish Subscribe Channel pattern when * two or more applications need to communicate using a messaging system for broadcasts. ## Credits * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/publish-subscribe/etc/000077500000000000000000000000001312550536300220305ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/etc/publish-subscribe.png000066400000000000000000000661351312550536300261760ustar00rootroot00000000000000PNG  IHDR Yl$IDATxo$G}=ʋ(yt/~z{9,tB''+΃F,ƈ5p>^/8#}Nwkb' #nPMPy/U{QwjF(8XAԻP-Ŀiѷ \c3IUJ)@@PpP.P%|00 z  ^B@(o/t.x$|00Z(xk9@=``(cTv glFCN$|  b, >eIf<`KHivݗ'aq"NڝD0FE n VR3cNm)d. b< EG(.D3CE~@QæyNgwwȊRVoMgxb +!~\; dN(ZS$QXksrڝKD\00۰nloz}KC΢'D1/d.8rQQ ^rW/\K(8``((x > ^rW/\)76NjW|ٗ/,|6iFeۇC;T՝m ර0M:,)#6rS;7Ol|z_Gyoۋ/}]zץ3>f=۽I}]Ow[3Hl.nS1mR4zwHv+m%"U?h G@@)ѥǗO>S⥷~vOYs"})ǯfDSALWL7兺o3+07PpPa`( U>xW.2k7g"?|n9o تa:aDdVT MuBi0Q<ʻu"FשQ8 zE#3KΓů}GG/ī9lI"m2JI$?T^3Dޯ^~^"'嚟E:SóRp9& CP.c ~﹣Ǘ?b[Qu!r!4-D}j:;%tU[\^1_w aWGW(! a`(Z7)Gf>;+?!:\)8ir > ^rW/\K(8``((x > ^rW/\K(8``(Gl*b}u(8``((xꃂ@008_6,ؚ=NC28Z)z}R~MNfNS@݈lZ=U џK^o~+5/mG\ S㿌=# 00hww*Zv_%Cç e땔*jp3S[g7OTmaР}Hc-Am՜EIѾK٭ ';# 00HD޶k2آ Ğ89)Q-DO_;KX<%_F$<# 00(WJ;q0;s)4oU9T VpBJ΁PK]gD rg\ x!CDíTZ (<(x3@H5\ نNf6krJӸ zϮ8\))xgD r p2t*O>2WDϮY(Qg"G@ZE'NIV悓H(8``() 24'|00̢$|00 z  ^B@@PpP.{W7-r@at:P(8FPK0Pp'P(8?(    z@=a@0@aPO0Pp'P(8?(    z@=a@0@aPO0Pp'P(8?n155Ut5r1tVVV"2ZqU0Pp~zz:"P(8f}iwww{{{@0>7Ѿt…VPp[[[fSÇ766\B@`LOO}ׯ8p ceeev={vqq޾}|?ܿNQU3(8,uq[ nP,5pg9p!(8@ˁ@ A.@1ˁ@ Ardj Pw1d #B u)u2o!t9FL(8@%s4bB* ;@ PIr'PpJB#RVc}O4 $t9Gl+pr, PIrd|~r,Po; o-l'_ʄT:w)$aYoEw zpgGȿSv=%pK(8@%sȑ*-ZJό;y+61ENi!?l) Gʨa/-.yDIe ֞UGSpJӘ6D:jXr"K-ŷM:K5y]S@(8@sȑm+G^D}3ky*!PO!q3U!Z7?6h,Y7[1_#NŜ,ǚC" .Gނ|y#B*T:wi_Q(]I>fid/A?%/%9T~P+卸&йH#.u}G>Γů}GG/ījuP9hY\LŸc(I%tب7yE  ;@4tOsG/#=Ŷ`֔7\onő W^4}ૣ+.fQ$ OCsd2;&йV sF߹{~;{OI>K~Tp, GgD`r^r3Pp:w)&2 GPp҈ $t9FL(8@%s4bB* ;@ PIr'PpJB#Wp+V*c(8@%sA cr$#=FX`kr8;hh?۳8#n4ۍȦSfK?crQVgD :wC]JuW)0Hz%e S#a,>toV^Y [ݪp3;@uB}M3[@س'gP7=ӻ U+&[,aQr(8@#+"|P<؉)xߙK xu%Rx˨uUu%^R$<# 1йHR[v" ngjuDFrdsm\p1KdkfL/4ʠWpjɉ q" yFbsȑ<<NBpZŶ@F](us`p: %Uݹ9,CDuQpH;@SR;T悓JPpJB#E( 24M(8@%sȑO(8@%s4bB* ;@ PIr'PpJB#0*.A 3:T҂@f,--uHP? PGPC R j d΁vww=0??@jNKq, 5F%u@0HlnnNMM>#nR@ a7Pp% ~V>J (8?HZjdjjjsssBPp! ~LB fooojj@ aYZZϤ(j ^ɤ4j G!pZCsݬ D0/--eX 5l62,I<nPK SSS@ aD̋E0@<9 j j(1 G0@ SSS9@ a(r (8?@ a(+Q5͝G0@ Qp! ~gjOpj@qͻmt2D \:* :ayP4(8@q;E\!#+Uh5RF*cevUfkc+GЇʻ%B/hVag$  Pi Rp ʴo}ᨰ׭Ҧ_z{ Pe4:nj?)~%DŽGSp*!Qu7?677m7?JQp!(8@s(cmmOWۏ@ A~AB\pi}`K1w믩N,%o'Ta 0E[L(ҾVוZfמTGbEa%LPpHgKa=v%t*LB&oLܷO?c3^6mgw"'3 7@z&Yܰ7~ٌli"͎ήȿSv=%pPp  =඀j%[+ Gw WlK!smcQKEG(.DMC~ؘL(t<;Cv!+J-6Z5meg"b +!H(8B Spc(;{ksx0\Z‰(B99)DJ7@z&R߆mwvf{=["wՕ=q'B IVp+E`גě?gҠ@o(Bd/w3hw" oL%ou oVoY2xy >'+  7@zr'`BH N*6 7@zPpR P҃M(8B TlB&o Y8lWPp  =a ~퍍O{=Ծ['ŶW .kZ*Pp  =Z¼g$ 'N aB&o\sT?<[K#n4 PSkol.y͗}9Y(VC$nlS y_Tܽ5m%9ʲv9KA Gm&џPp  =>{wW__y/7a(p >}"S}9eV;ؐw'nB&o'x)[}ħ$F[cO!Les½hW&?0G[ ܆=uČݝZSP吳e,!-DnAui EHLPM}+(߾v}&8x7}#;xV|k`ZZ>T,waU3l쩃n%/ʷSٚ96eS'gJx {qа?ŭ**`g g7PpɄ =@\^/f?>#m.]+3ݼ4#x/(nՖ0:}ŋ7QaU6%fz꧂$3qK1lQxTW]([֥/ PQS.9pdwWzW~vu {D˝{;^%`RVtEQn/om7_^ū"_}S@pSi``UĩuBm dЗT͕^ 5">fݙO&(8@$e&F`]/~}죝'?sߋ_K^<}WWV]&K!^y>!Ox0uVZ*EqV奸-ޢ7+Rsl#uAr[P8rse\[V?~9}1m(޶_0Ƞ *e=w'>xZWl=ǩŶp:÷_hGZSϰxRݵˡX~(/jo!8$*CqjgJp![@ eQe53؇ 2_'  N sF߹{~;{JOz![3h a3#fO7I}& .u/ٯ- ȷnEyq,IϔfG=̀D'LINǡg3{Cn:ޖPq [h3AIjgi)(Vy(!%@҃Դ&*?۝m2ZVv6~PpbӨQnWPbMZmx;k]7A\fQB@҃MYMD1'Pp H N*6 TlPN3 A҃~g  |wwweeefff߾}VkiiikkQAQ2(ׅm>|XwY]].^t(PpΪp lv['`yG}kW=R~MNfNS@+ 4{כu[s.=cRw)gLU2*cU& (8@z Qp󡅦; nJOA+)Uwg0n_wշ($\{۶j΢Wh߂Vq ~=zĉilee)('(8@zPAĺm{&ގ-j=qruSޣ8[\!Qk"o)'pIѺ> 8_\\[[[¼w:KK6WJ;q0wo xu%Rx>Z`!Z%QYR(x%I39#gϞݨP"3Qp)ZrRjk5T:lI8tk9ިP"SJ6t.ߘp5Y[Sme+~vхVKLl6i$+ˁ_CD*9}#?/R*y2zkwmTJ,"OkjȄTSL/g@Pf痖fvR‡Ś|6[:WihJd\1P^-ry9=/;0u+ m1bjrL G. dFæmNgw fYl>Ϋjh9S(IHet? ebo9 Y `t+S;LwגX=t:N rI*^ٔƷx-0 zO.~兄C%y*vrvGj\ppG!n_{YO&HR(Dj/ض䖧_fu !D'vdE!~vow#tZgΧ$%o޲dBvc$Sp(߁'Y%5QpHƶGsTx\qE 33b>|-N NB {TpCCt\ h1 (8m`X/[^Wޕ(k6z.X[[kuB]@Qp'kw3(Ӿ[qQCKSSSڡcG`h7HY)Q!ꅀG _!ӎv!GLkoT+Zs (8@jPpXf@|ߟPFa(8\pi[o_I%oyn%NCn S~ O>ǟbOZԞ(>sɫlvRVD?oNMMe>Pph0sVbدs1=|MH< ~u@`|[$\(>(8@j .Cg_G{ ^M"y$ Dǵad+'!*Q–Xq,_9W giii~~>Qp4낯<<}S^=wīLaq9!Q .[t(?njRpᕱ?0=P c%@P- ?ysſ9^{u\eNRfrHK5dLE zOt |+:O<֟Pp ` .^_=sY|cC$ Ppfskk+QpԄ)8 &P,PpԠ(8TV@RPY.\S(8@jPp*TNAQp2v{mm-QpԠ(8T(8@jPp*Pp!G⬭̋ER3y >x\ɪ G H @p\eI݆;[ݖ0yTn-p;dkrg7sFd Z\k=QެVzkF_ڎ(8fa(8@j(x8P¶㯮*>*[VQCܝBYg7OTmae- ?}%޶-ٚ0,--gX  >Xm/d0۱E \=qrWޣ8[\$j7\y-\w&}ez 5 (#>vBa wfohr@]ɩ2jkDgA`R_ZZʪ4 5G>h9D<܃5UIagglfGR3\p;Y '[sez9iV*BsE+x@]p!PpԤ_EN'Cw!8Se^Z/RvQt9('qgAdz 51 Yr2??XjZ~kV)|bdggG&EWHPI џ^5Łbckkl]")ZZ~)KwͅHZ E7 %'깫89==NI;rq]y0agϞ]\\t\YYt:֧XrR^'_ZϪbY}=l? I@8w5@}ؿ(Ԛt2WesF0~_6]a.eUw fs;del=q}J,"OkjȄTSL/g@0x^=w5@MX__oZN gPj%[+>&~ WlK!/lkD(ivNNo-L HGyg ځ2S8AaX[[kC] PfffVWW};~mHæmNgw fYl>Ϋjh9S(IHet? İpj:.| ' LhN<0ݵ^K6c5Ol;\鴎8.R&Qp Cm/b.xGy!~Poxh bQ336pWw9 ] Q^8ٝm/-OBCԉGO nԕɊ(P3f`ݍH]ZfTL-]%>TIN;ghh%Ns Jb[U כnbٍJ6T0Tgb(8H`m[;޻wg05呱U0ZZD+Dv!ڝvc2J PHHiU5FWϩc,!g{y/^y"Zv|{|k֧*Cda ~`&lF#4-+~trVB&Zk(Fij9 ~ݳUOⲕEܯ'S5'ZCMNZKE,;1>4,0; \Xg@.2Z0@iz4Ҳ46zU5FWOW'nyc7?!?yԱgվC7MMtc6_`u"u%3tnIhTGF}ŎK/ik$8ы-xcsuJç1R6,~zf6@!f,z+%CGRH˒|jd{ĭOZs_mK@\^!:ۊFbWC`Wv7m8KZOF̭j%9mlµO)$b Ulm5l?ޖ.ö]k[d~ͦT$ǹr=@}j/GP<)H˔7gjཥk>~sɿx/Ŷ#㫗EQt&CZi. D\\> 6$5o&moAlYBQpʆchkZ@9!Md%<+o~O^~rbϽī+8曈"[tedO#Jמ=D吨ࠀLbMuoLc<(C_T,%`b鑬\U#uW[>};psU)s/o׍!?ǔ&P [Cٳ9:0iM*ks+=KN?dk_M^>e(4=|jdtL'o}oN7_pҋb߯G ,J!8npf%G=墄!5DAĔώuĪGQVhhz$+1WJEk?gv=+ol=*%zLbFs-o޸A&1Z+Md%spU |k=I⮽q{o}ڷ|{ ikh hyU5P Jܯ$I{g$>xد8(Rù}s! lZk6Z[=uCeM^\UZOb[䁛_9k{7|jonnW@W^D(K,LWVV:n!HGeR)sӝ(uCh|j_ItjW|w_X8mҷ%/@`ROŸ =7,)OʷyV!fSVy?= qTW0zח\UZO[ߛ?W6ke~W~+x^lK_u錓?ba~o YrTY˅Hp Exom=˜7)|֊|Ow[ գglIn{=,vJ{vz=5Ջqy/%0W@'(q֓wtOo<)+}O_[]<%8ᏧB8#vJwD}ɏW7-vNйv|}opcՈ^?Fã};Qp{|]!)oNƵǴV{5Tm-[]NrI>F a Od LٞlOnDeR!>#vĥ@!-Kg<>ٻϮ. £ZVi6+++C _t4%=EVp\$m?\;"LD(*v+7黤AjSܝk惏_n_P=PHcUdDkol#_8Q=zf.FXɰ);Pg inr i#+xx o|h!Flkouك&mQZW# =]oVDIwDk/ >F >XK E5@r"nAcSbCA(N/~HTnẳwoxѣ}g{k_Q_ыo1j`-sL:2 JxU ?63w)D7|[VW_#$#nкŜ.Ƿ}_;!u{LI3TS\+߼9*<ػ .1+s* :d@(x,(8$#Ic{=|G.bٝ7o:zFb/)j=2=jCVD|6!Z&Mܖ]6ɘ?6Z;]2kJÉC#KvV]opUG>h9D<|(XVInfFZwWuW @(x$[3O9I6 J yU5ʲ.xR]'q<`Ӱߵ݈h5Z7A#Y7F .;XP;ILCVsfĜ0xHVbQ(8^BMb*-s-l0*4=|j_ -nS cGopU |k=MbB+Md%<(%zBĄWJ yU5R(}j@+%Qf~m |glsL nzj#glΐB'??+CPj(pA(!R7r2F|}}]]!xW惢=N"Fzl.'^uٴcIUB̧\f[3lG\ S㿌~E1ݘ˝񓝂fiޞuF|ffju:+0>0U~hZvBw(U2їV*sP S#a4: ?}5{9^} ֨oU8+BV NQ:Wը߿ggG(0A0m/d0cHrs.w}q,!NYʸ"'pHTnẳEc \ReO32fW6;dEc \|BQ .͉~_tux2膜vX+l8wg|X)wbxJ@ l6AZ)8 `(;;;333Q+`)@y Rq&V 7M.|ߨ̰(@y r{[R<Z)8 `(9RRN F\|- 낷{I_Ȝ$@zvwwWWW K ܨ P*MߵEhuv^UpX[[۷oJ(Q+' h@55VtE nJ\pi˛7.O_P] L?CLO@bѵ(/(Q+' "kz]5+H<(0;%Q+RA goooiiRpD܅ߨ(tP677FoRAZ s5]HoJ `'777HaRp(tP[[RF(8@ sVUtE Q+T$ sjIXN;j Q+' P*\6/ٳsssհpV .@ƚ.;??//"qav]TZ)8QpRA dwwW(;A\׭?քWl7j{ $@4.]:(\YYt:EU)Z)8QpRA ??[SP|o2dQ+RA o 1W)+Z)D^t={7GYYYWuߨ P*haDn'F(8@ Cnnne>==LrBoJTLMMSWl=b@M]a^BZ)8QpRA !٫Bfp7??sW򕕕n?yuL Q+&w7`jE8Pvk<:4C~Ui >:N?A^$ nj$BÜD{XkP &BÜD{XkP &BÜD{XkP &BÜD{XkP &Rj/ӡ㉊HGݻ'gfZZk¯ȩ x?|bȯ*hl+prZeU$b)Eq*pZ6>)x{!0mO?"`fՉDK`Ż 3T V*J U"l~+[҈la.DR%;/' O{wϻ!+c&Jp̪3<ٮ7{ɬ=@]E a< x+C~Uɸa7iH_ؖ>B:M3'$>F(.D3mC{qwW4oC1o Sp(1B0̢Dž萳>xo0W,f>_3maZņ $2vp?r'7*A?(k=J{R퀢-q!8:%j0 2=駷fw#G8MYYѶz.tZGT)q!8:< x$1~Wt͞8Q \pQ+K|!v\Sp+EBk8^AͅZ[~MX{]*׃׭mw)]C9vz',oTTV'&lȗ;3ڣ"賄Ë EfAÜ4a Wؗ#w{4C@䗢ڣNΤн0L iОQqN0,ʆXdBm 0'1=V LDpq O%i†0pQp`I7|B$ kڅ{EB~p0h#{- ^4aC~)zҖ7o\鲥"|j,dsݺ[CÜ4a _t]L.z!_Z@Bo {  ^4aCD/o ]lW!g ^}C63,7$ kyޅ}e_mh_b01xu_ տӽ0Y8l_Đ_U'1 |';{}˷NmQ_y\(y/AC~Uh&~+ #$ {k~׾ya~y-ޭ2I9*W60\>k%m8!p%0mjeKYVE&]ņxw`ϠȖ#d{&=/-=Ķ#9פ=~oOLߑ@t#SP F,\篜{V_Xɍ! ^q_8٥8"Yy[{CtVVV^6̰n ɝd)bzugʑC? 3l.[湾xUQ;C!ɚj;;*"a1B_B. ~O=镍Zo_^hji2r!JZs ]m%"sA4@Oïgݫ"=Zy~ru#҃_ao1z^hvނOC:4; ~ҥ۠I{VOgtM҇ut[_]:y|=%zowğSh~)w[72dF_}gC{ BD"N uV_t: J쩃wEX[ܳtHg>ϟl%+?I fo;^;#tU-O:PN5:҇oexM}+܏߾v}&8x7}#;xV?zՔo4rZ:* 3GaY{G @1>=d -,BŐh%w2 OOCէ1 AQ'5*1Huz9dyMQ"'+:ۇVKP'6!xPaN!8_>\3?>є!iCmWnq@^I/}O<Ć3jYi 1ndo-1wܩ<ŨY /gfa^OIݻ_8 PZ6CK %Um_:2S*3h>Jie.?} 8Bp WQ<'c/ sa&#BI%$8,P1!intj3N2IX/?]\zhмb/ 3Gark|%'Ő_*f Ȭ!8?}=1 G{ߠ C~`9 { @1 G{ߠ C~`9 { J?~li7::p`UV`U~NIENDB`java-design-patterns-1.16.0/publish-subscribe/etc/publish-subscribe.ucls000066400000000000000000000300501312550536300263430ustar00rootroot00000000000000 java-design-patterns-1.16.0/publish-subscribe/etc/publish-subscribe.urm.puml000066400000000000000000000002361312550536300271570ustar00rootroot00000000000000@startuml package com.iluwatar.publish.subscribe { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } } @endumljava-design-patterns-1.16.0/publish-subscribe/pom.xml000066400000000000000000000036141312550536300225760ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 publish-subscribe org.apache.camel camel-core org.apache.camel camel-stream junit junit java-design-patterns-1.16.0/publish-subscribe/src/000077500000000000000000000000001312550536300220445ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/000077500000000000000000000000001312550536300227705ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/java/000077500000000000000000000000001312550536300237115ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/java/com/000077500000000000000000000000001312550536300244675ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300263175ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/java/com/iluwatar/publish/000077500000000000000000000000001312550536300277655ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/java/com/iluwatar/publish/subscribe/000077500000000000000000000000001312550536300317465ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/java/com/iluwatar/publish/subscribe/App.java000066400000000000000000000063201312550536300333320ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.publish.subscribe; import org.apache.camel.CamelContext; import org.apache.camel.ProducerTemplate; import org.apache.camel.builder.RouteBuilder; import org.apache.camel.impl.DefaultCamelContext; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * There are well-established patterns for implementing broadcasting. The Observer pattern describes * the need to decouple observers from their subject (that is, the originator of the event) so that * the subject can easily provide event notification to all interested observers no matter how many * observers there are (even none). The Publish-Subscribe pattern expands upon Observer by adding * the notion of an event channel for communicating event notifications. *

* A Publish-Subscribe Channel works like this: It has one input channel that splits into multiple * output channels, one for each subscriber. When an event is published into the channel, the * Publish-Subscribe Channel delivers a copy of the message to each of the output channels. Each * output end of the channel has only one subscriber, which is allowed to consume a message only * once. In this way, each subscriber gets the message only once, and consumed copies disappear from * their channels. *

* In this example we use Apache Camel to establish a Publish-Subscribe Channel from "direct-origin" * to "mock:foo", "mock:bar" and "stream:out". * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) throws Exception { CamelContext context = new DefaultCamelContext(); context.addRoutes(new RouteBuilder() { @Override public void configure() throws Exception { from("direct:origin").multicast().to("mock:foo", "mock:bar", "stream:out"); } }); ProducerTemplate template = context.createProducerTemplate(); context.start(); context.getRoutes().stream().forEach(r -> LOGGER.info(r.toString())); template.sendBody("direct:origin", "Hello from origin"); context.stop(); } } java-design-patterns-1.16.0/publish-subscribe/src/main/resources/000077500000000000000000000000001312550536300250025ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/main/resources/logback.xml000066400000000000000000000040031312550536300271230ustar00rootroot00000000000000 publish-subscribe.log publish-subscribe-%d.log 5 %-5p [%d{ISO8601,UTC}] %c: %m%n %-5p [%d{ISO8601,UTC}] %c: %m%n java-design-patterns-1.16.0/publish-subscribe/src/test/000077500000000000000000000000001312550536300230235ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/test/java/000077500000000000000000000000001312550536300237445ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/test/java/com/000077500000000000000000000000001312550536300245225ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300263525ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/test/java/com/iluwatar/publish/000077500000000000000000000000001312550536300300205ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/test/java/com/iluwatar/publish/subscribe/000077500000000000000000000000001312550536300320015ustar00rootroot00000000000000AppTest.java000066400000000000000000000025271312550536300341530ustar00rootroot00000000000000java-design-patterns-1.16.0/publish-subscribe/src/test/java/com/iluwatar/publish/subscribe/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.publish.subscribe; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/queue-load-leveling/000077500000000000000000000000001312550536300214745ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/README.md000066400000000000000000000031041312550536300227510ustar00rootroot00000000000000--- layout: pattern title: Queue based load leveling folder: queue-load-leveling permalink: /patterns/queue-load-leveling/ pumlid: ROux3W8n30LxJW47IDnJxLLCOcM376VnP_VwX9xgZKOQwMtcg1w3RuykXQDIADztzyEU08fNRjttU8MHbYbEuhdC0PtZmfN26qzCbQmtIGUwauh1G5i0dw2Wn1DhOZg9kpGWB_zy3Xtv-FtOIEhQBm00 categories: Other tags: - Java - Difficulty-Intermediate - Performance --- ## Intent Use a queue that acts as a buffer between a task and a service that it invokes in order to smooth intermittent heavy loads that may otherwise cause the service to fail or the task to time out. This pattern can help to minimize the impact of peaks in demand on availability and responsiveness for both the task and the service. ![alt text](./etc/queue-load-leveling.gif "queue-load-leveling") ## Applicability * This pattern is ideally suited to any type of application that uses services that may be subject to overloading. * This pattern might not be suitable if the application expects a response from the service with minimal latency. ## Tutorials * [Queue-Based Load Leveling Pattern](http://java-design-patterns.com/blog/queue-load-leveling/) ## Real world example * A Microsoft Azure web role stores data by using a separate storage service. If a large number of instances of the web role run concurrently, it is possible that the storage service could be overwhelmed and be unable to respond to requests quickly enough to prevent these requests from timing out or failing. ## Credits * [Microsoft Cloud Design Patterns: Queue-Based Load Leveling Pattern](https://msdn.microsoft.com/en-us/library/dn589783.aspx) java-design-patterns-1.16.0/queue-load-leveling/etc/000077500000000000000000000000001312550536300222475ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/etc/queue-load-leveling.gif000066400000000000000000000353261312550536300266130ustar00rootroot00000000000000GIF89a@|]qK`9Phowx3M2G}ЫܿàǛ$v>ڻ{zagطҰcwF^R^ơmpgjYa.}E6J>OwɮϳXm^jkzly茼FW|Tj@X-(bS捠BOw爐/J!z4@YuI.`Ms_tҝƐqVpϙVqvd?_ClJeo䗈r`}leTϮaOztżiYo]\I^NUBxxf,@|H*\ȰÇ#JHŋ3jȱǏ CIɓ(S\ɲ˗0cʜI͛8sϟ@ JѣH*]ʴӧP.E)իXjʵŠKٳhӪ]˶۷pʝKnT˷߿[È+^̘.aKL峏F̹3 ӟE גUd nUͻﲲCM8h t䔃|.bWu{_sIGI=}l⧯~_ѶO5Ou A~U^=%` :G!f!&j(/*9X0xZ(G.Ȟ4&!:,EIWd eQ %_jp_g !^8#kC!gyfvgi (~ ]睔BJ>PF-*$ЩfɤK:+)R'n'Xz\#Vju&[sֺ,fkve*lakV;j.n&k+]<+ K-%a'%| +k 2f'qˁ4_(G֬sv7oD_6sH'FC'bG?-mKgXWX\V5FWw-v\Qme__lupOEkmwvZz=Xϭ @@@~{in8ㇷk@# ^(͜MYgy'Dqov 4@@\1 ߺg;g{|%Wh `@$ @nbϨ]oyCi<^@*` $%)SyBr%Gc.aF,}<  :AP#BZT+ ZA6@  A6EP\ ~੮Eۀp"=dKX#&q*dS[aqz,c85\ğW,@ I h"V'z|" 81."g$! GX$4I(Q"%YX2ـNp@)PhAI4,6ole?I蒗 )Lbf13KIv1tR.Fuр Vd 8Eq,'47N2k$n(iE'>O~"Ӝ!;]5oZiH؋YA3`@!:Ҏ i42 Z5ҕT /LSn5(u@ђ=$<_s̀4 (3i2iLRio_ X*5t+:=˜db+d9@SkQ .K+$@V!e7ك&AEe_Y23ĭI =&8PTylK7t][@en*/I0~=rj ӍGi;^Qx.wmJ2kC b̾< 3vxql2"R0'݇w:7r8o0=,b C.b~ʼnSqCX 2Iq1Ch)ǑBx d塷BVl^e0yOvrDx"^(K̊;rmSbiXe.ipb3>{e(9!}n`{y'r=I,Ԝ9xIZ3~|qb'$x ^4{b-h$n.EpOZ]M2hf!z?*`[ʯ&%I;4ɖ3-kiRƾ6lCɱ98miu[2Ic n)?Z9eζõ1j; vs^> ;( dwVxW:K/t..ʫߣlbi^}m/+OK*ΏO=Os>ż/ /n ~3 t aB(C9 ;@ X3?0Q xyc(F`jdLD^2&)_*(hTT^w:p"sb'0"z>xhDhHn޶tW3CX47e'wf>&\ȁ6(pbwxTx[]z-rf9 E0)sA7N؀&hlKYh m%CX~j)'J/ute6= z.r҇G(giv7>>f舺Vk r7hȸy؋,hF؈qT&P6qs%\F/--a(gQa)EGxEڨ,.k6s /~&0hPD1Wވ qr) y6}39ɸwm؃qybqIҘy"7{@ٌV8r8U!9 )zcA1qH1{ƋDL(Cي8XMi{\Yp8xTpFkU90âk9TCDeiQɒ?IWò APfdSU5{xȡʠ!*d$j/&7YcՈ1 xJyʔ 9gB0Zh"yrqY* פ4r§bQFpE fVw)zN1uzjE{C )m0tgvęyKY sPz{n*HJI$ji(s0& Z h-bWsSiSzcMMoe.*Mas8u,-t(gƤ}7`Bfki cOjHZ7 YV*Z*ɥZn IISsBTofJpfG1WH\&^: kT*R000R0sʲ:{fIǯ⠏:}HY{-7IU` PTzwڳ6ODWdWyKwM |WWeIjpx uss^:Jຶޢ~_ y]v5 1{!["M+w%xŜۺѹ{Vh#HL.z ]{hʻ~ڼ:{t+T[9{V˶ѽѫ;:(?.ɂǢ&z .*P'ƣ_IzPyZJ,]j+@ qxA)p*kZgFx8uҪAA-؂ָd)|Eg0x/ک[R Kx[J )u&壙Ğjyx};Z6zȪVܑk65q+YgGJّ0e| 3>e:tjEZ˷ Du/ҮȀmȫB^ꁝN.4N7^~v=`۝^l=ڸk-B>q^~ǭ9i;~5nag\j]c>]~{SInh۴uZɞ_A ̭?-{f.E^\Qto0O2cc1-~%?TS=K?[薭9U?7!K_`IV3Gd_lp[t|Jj3.Ta_ڑ(_6O.ueoj5O.>{>?]*Eoac^3%oں ;Fџ4xqy/yʯo?d 0`Dp‚ NXE5nG!ET(dȆST鰥ʄ&]Xs ͛9/ʔ %ȕAKEu*Jq%QMONZUYnCR hĥQ],ؒbߒk6f݊er_t{̉eXmڼmŻnҲ+'xgE M6õ 3љr䚩!;^T㘿->ʚqɕKz[/ .M2uin{yՓ>}XoϛZ7[߸@q~:>̨ϡ<[@T9)Tj2PO< - +STqō6 k'݂!Bm<\#۱>lѵn< bI(ԭ(})K쬹"o(fc:.Ds4+t{r9Ck3,N>d/=*PA"PDjC4!t+ F/RSN;eLOO4H5~DuFUcUYVuWDoUTPe]WbOuXdU3Xg9RiNUmUTV[pc6R8WU/oו\TK]zյ^=yVxH^2_?;8a+VI#V_pe#6Omc;cCydK6:Dye[vec^9fsyg{gzh6zg;ziviZ `jz멫k{ljV{vmlE{nnouٻ7/ q[.\ɟF! s+5=j \kmN1/Y/;[m;/w_GZ۱~]SC>Aj/^z食Rc%}iX SE 21k%Xu8H61N$7 rS&DVIQl'(M9pK:)%3sKe2^ɣ("YQfThGVP4HM5TۨR1)ITh)iOvSTHPJ9nFRO]Sz%U%B,`B,*@XEPMum[pW.ha T!86@@  `DeRzJiۂ0d ]^1Ne<`@PV&lD+0a _001k_Gڥ B$0G;F[ŽsYB`5G&иNKu@ @@  P@o^> p;IV5-! &4hU ha!h@  A6_Qĝc؎Ac:xtbXC 0y b0;(I(q`$2 P(`#swl?eFs9asqVYN D.2Ton,\ 5AQl&,ʿoryy\g8dž21 HfC;WU=44`-pAY`R3qx^3v|]PP7 9z$أ  ^mcՑ.k5&uR53c`86߰ 3 j@ TXgs͞uڷ3U- 8KWk@VԖN9g)9C}?Ա*Ā.-*t 7`;[Y~us1m{dzV<>69{x!R1c7^|Inn)Ʊ)zϚBB?<< D8D[B$"'-,C\0bB):D#JtE5DhZSl$?$QEITu8DHDVBWdsqD?4%IBFq$B0&XiFj#sCp 'wFtgT[1CA2 7"3L$Ar;GASE*+`*|/VTLBUҺ$>35++UwԠADPjTUQ7A|ڿEωҡUTs2%@9YRO]Z%'e5DPLr&Xfj/[ۘ۸ɪt[[ɦ-ܜ-UU]\U\=ζJ\C  u'!\"=[m]1 8 $)[]M$T=7-8 ԍTKBQkQ.+R\ӈ[SuNj^R^eTA%T^]*T'3VJUM_ٙSUUmՌVSlDzʼn]*`  QVf]Vg=`}}YfFZ5 .bwWy$x;ݱ(%:UC^aCٙU؅mXVEE`btT[a&^ ّ-YdYNߊMG"UaL&bQ陝=5Ԏ]TZb%Zbc9n EǯmM^~4ז<9dx+_%dEDqd]dIV٪GDdMVuMdOM`QIReS>IeUfeuRLUyUF XYқDm;3Pb[^_HKeavfhnЭdVf,<4nF} ӆ _}?'e,=+NW=&j^? A-T0:ԥq{"g3^c,FÂDw&d`UegՀzhPmYYjԃ ` nh.NhvWq-H _"ß a~e< qnj fÖbvib>)'ٱ6[%GnY/wi|i_)ܵkSo@B8ZN6Nks i5B_]-t6l}uOTEOJ,tQmd2u=dndU[nY˴"vm] va_/v_/vdd_avg?gv‘vj/jsvmߗmvvpopwh$wssOw?Uwvv*wyǖyݵw|Wcwsw~wwpxv/xm?xv_xioxvxgx_vxcx7xx78`IO핗cIye$|1i-a x!s zzgq{8{OP{ؠywh{Ӷ{'Wl //O|/IyG|ʏxЧx/>}OO|o}}?q}}Gx}}R{_xy)7G~U>|}7{O~Ga_uu&2G 1gRO8VפK>f,h „ 2l0'Rh"F3r̸ƏG,1Ô*Wl%̘2gҬi&Μ ESO hQAMhS.YάZr+ذbV4ŏ"!4 ɷrNe:U*Z>/ǖ%i\vֵ8mJO=̚7skTGte>JL塟gӮmvТ+VG=>\4xjc9U&,]UK\;Ȏg|:o^rvrX2x᛿? {'r| XvՀZx!(qQu_UaO!e"-Jb18cx#9 #=G: 9$y$IV$M:JJ9^6>y%Y%]zaI$_icei9' 'GY'}v'GP0@.'(F@"Y֡](E,@< D{z+a>`@$ zv*姸*LNDTAh`o(a#e,ʝ̪LF~!l-+nksݒKc*A "0 @ &(PTmlEr=&0 ;'\k(=|\^2I; +@ .H ?/>4ٶ:<@@1BÊ3z8Dv]6} 3P@C 4Py O;D'w+ks{^:姃=9E8汳ɹpzɾ5~[W_ޒO>'|#=kbo/tT>B?~Za{y~>J};Iï?Ŀ< {HN>ΉDA rQ\ sJc ]fE\ER%LF?}gr)Pd%? UJrp$~XQ0c#qt僮K>юe-+Yqz ~} ;zHb>R&8|M ':*Nq2d)Ϝhhtgy&*ħ)v(B]O*) g"*щR(F3Q>Y(CP!HILs*})AXRLeR:9OUSp; IT6H%RH¦:T͝2rЄf]ժ2JҚVdqO$g V̕}e5+ hTR)LV2U@:jotv,iLm +~='LL'CXղDZ7+ٮ{i+A@&-ְm?ZJt%asiW׶=4EDi@c].svE'ؙҪ )UjN^uo8k_෤/,X\U~+T!/`)¢0h @BaEAxòBL x&~$0u}qOG+yoJX+..[HYU)PX9 rC"r@_%|b&wy|'O{_G.YV=2Yz.yӣ,gDWじ|wx~x.~_oBLPu`_2R6 `EMzʕ }mҌW{|Vuh\Ӯ "MIWAV6EZUViJn !AY}%/V3N*ekVnuOMm^_/]g`M !T!Wi! ٚ G _;"T#2˰۱%$FZ%6G j`'KU8ŕETݷqb+ P#-R #]+ԜD0"3" ݖM! }rc<9:*:cz~#6J` vN d((O " 5VN}BB %:ÔDF@ϦWaٖY:VJnb0!Gv$EjYEҵR;bŤL yខ! Z!*$*ƞ1JdQ]E %&ⲕ}&~!WN=^Qb ~A!\rU%-ZIAI"QbN!fIk^V_'("bU&&&^vc:o=,_+ib1$(s%hI@׹.$ՙ\4bei LZelfI_9'ԗ)rfAxKDgȣ}%v>[wwZx^vw_'Uz JrҞWU|B{6q$&A6y_fH y!&Ĵr64f zۡ\(kԆN`Eݶ"%0Efb`VpIޥN%fj2EZ#!aޔ]O"_`(bbu\"b miDf(MZΡ.f6 VhdP""V!X梘2i`Ih!B*_ӤRjLXs灢ijDT9 nxg Ъ*h{6{j檮٪*+3;java-design-patterns-1.16.0/queue-load-leveling/etc/queue-load-leveling.ucls000066400000000000000000000123401312550536300270030ustar00rootroot00000000000000 java-design-patterns-1.16.0/queue-load-leveling/etc/queue-load-leveling.urm.puml000066400000000000000000000020501312550536300276110ustar00rootroot00000000000000@startuml package com.iluwatar.queue.load.leveling { class App { - LOGGER : Logger {static} - SHUTDOWN_TIME : int {static} + App() + main(args : String[]) {static} } class Message { - msg : String + Message(msg : String) + getMsg() : String + toString() : String } class MessageQueue { - LOGGER : Logger {static} - blkQueue : BlockingQueue + MessageQueue() + retrieveMsg() : Message + submitMsg(msg : Message) } class ServiceExecutor { - LOGGER : Logger {static} - msgQueue : MessageQueue + ServiceExecutor(msgQueue : MessageQueue) + run() } interface Task { + submit(Message) {abstract} } class TaskGenerator { - LOGGER : Logger {static} - msgCount : int - msgQueue : MessageQueue + TaskGenerator(msgQueue : MessageQueue, msgCount : int) + run() + submit(msg : Message) } } MessageQueue --> "-blkQueue" Message ServiceExecutor --> "-msgQueue" MessageQueue TaskGenerator --> "-msgQueue" MessageQueue TaskGenerator ..|> Task @endumljava-design-patterns-1.16.0/queue-load-leveling/pom.xml000066400000000000000000000033671312550536300230220ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 queue-load-leveling junit junit test java-design-patterns-1.16.0/queue-load-leveling/src/000077500000000000000000000000001312550536300222635ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/000077500000000000000000000000001312550536300232075ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/000077500000000000000000000000001312550536300241305ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/000077500000000000000000000000001312550536300247065ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300265365ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/000077500000000000000000000000001312550536300276625ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/000077500000000000000000000000001312550536300306015ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/000077500000000000000000000000001312550536300324065ustar00rootroot00000000000000App.java000066400000000000000000000124741312550536300337220ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Many solutions in the cloud involve running tasks that invoke services. In this environment, * if a service is subjected to intermittent heavy loads, it can cause performance or reliability issues. *

* A service could be a component that is part of the same solution as the tasks that utilize it, or it * could be a third-party service providing access to frequently used resources such as a cache or a storage service. * If the same service is utilized by a number of tasks running concurrently, it can be difficult to predict the * volume of requests to which the service might be subjected at any given point in time. *

* We will build a queue-based-load-leveling to solve above problem. * Refactor the solution and introduce a queue between the task and the service. * The task and the service run asynchronously. The task posts a message containing the data required * by the service to a queue. The queue acts as a buffer, storing the message until it is retrieved * by the service. The service retrieves the messages from the queue and processes them. * Requests from a number of tasks, which can be generated at a highly variable rate, can be passed * to the service through the same message queue. *

* The queue effectively decouples the tasks from the service, and the service can handle the messages * at its own pace irrespective of the volume of requests from concurrent tasks. Additionally, * there is no delay to a task if the service is not available at the time it posts a message to the queue. *

* In this example we have a class {@link MessageQueue} to hold the message {@link Message} objects. * All the worker threads {@link TaskGenerator} will submit the messages to the MessageQueue. * The service executor class {@link ServiceExecutor} will pick up one task at a time from the Queue and * execute them. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); //Executor shut down time limit. private static final int SHUTDOWN_TIME = 15; /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // An Executor that provides methods to manage termination and methods that can // produce a Future for tracking progress of one or more asynchronous tasks. ExecutorService executor = null; try { // Create a MessageQueue object. MessageQueue msgQueue = new MessageQueue(); LOGGER.info("Submitting TaskGenerators and ServiceExecutor threads."); // Create three TaskGenerator threads. Each of them will submit different number of jobs. Runnable taskRunnable1 = new TaskGenerator(msgQueue, 5); Runnable taskRunnable2 = new TaskGenerator(msgQueue, 1); Runnable taskRunnable3 = new TaskGenerator(msgQueue, 2); // Create e service which should process the submitted jobs. Runnable srvRunnable = new ServiceExecutor(msgQueue); // Create a ThreadPool of 2 threads and // submit all Runnable task for execution to executor.. executor = Executors.newFixedThreadPool(2); executor.submit(taskRunnable1); executor.submit(taskRunnable2); executor.submit(taskRunnable3); // submitting serviceExecutor thread to the Executor service. executor.submit(srvRunnable); // Initiates an orderly shutdown. LOGGER.info("Intiating shutdown. Executor will shutdown only after all the Threads are completed."); executor.shutdown(); // Wait for SHUTDOWN_TIME seconds for all the threads to complete // their tasks and then shut down the executor and then exit. if ( !executor.awaitTermination(SHUTDOWN_TIME, TimeUnit.SECONDS) ) { LOGGER.info("Executor was shut down and Exiting."); executor.shutdownNow(); } } catch (InterruptedException ie) { LOGGER.error(ie.getMessage()); } catch (Exception e) { LOGGER.error(e.getMessage()); } } }Message.java000066400000000000000000000027751312550536300345710ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; /** * Message class with only one parameter. * */ public class Message { private final String msg; // Parameter constructor. public Message(String msg) { super(); this.msg = msg; } // Get Method for attribute msg. public String getMsg() { return msg; } @Override public String toString() { return msg; } }MessageQueue.java000066400000000000000000000047431312550536300355730ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import java.util.concurrent.ArrayBlockingQueue; import java.util.concurrent.BlockingQueue; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * MessageQueue class. * In this class we will create a Blocking Queue and * submit/retrieve all the messages from it. */ public class MessageQueue { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); private final BlockingQueue blkQueue; // Default constructor when called creates Blocking Queue object. public MessageQueue() { this.blkQueue = new ArrayBlockingQueue(1024); } /** * All the TaskGenerator threads will call this method to insert the * Messages in to the Blocking Queue. */ public void submitMsg(Message msg) { try { if (null != msg) { blkQueue.add(msg); } } catch (Exception e) { LOGGER.error(e.getMessage()); } } /** * All the messages will be retrieved by the ServiceExecutor by * calling this method and process them. * Retrieves and removes the head of this queue, or returns null if this queue is empty. */ public Message retrieveMsg() { Message retrievedMsg = null; try { retrievedMsg = blkQueue.poll(); } catch (Exception e) { LOGGER.error(e.getMessage()); } return retrievedMsg; } }ServiceExecutor.java000066400000000000000000000042631312550536300363160ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * ServiceExecuotr class. * This class will pick up Messages one by one from * the Blocking Queue and process them. */ public class ServiceExecutor implements Runnable { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); private final MessageQueue msgQueue; public ServiceExecutor(MessageQueue msgQueue) { this.msgQueue = msgQueue; } /** * The ServiceExecutor thread will retrieve each message and process it. */ public void run() { try { while (!Thread.currentThread().isInterrupted()) { Message msg = msgQueue.retrieveMsg(); if (null != msg) { LOGGER.info(msg.toString() + " is served."); } else { LOGGER.info("Service Executor: Waiting for Messages to serve .. "); } Thread.sleep(1000); } } catch (InterruptedException ie) { LOGGER.error(ie.getMessage()); } catch (Exception e) { LOGGER.error(e.getMessage()); } } }Task.java000066400000000000000000000023621312550536300340770ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; /** * Task Interface. * */ public interface Task { void submit(Message msg); } TaskGenerator.java000066400000000000000000000056011312550536300357450ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * TaskGenerator class. * Each TaskGenerator thread will be a Worker which submit's messages to the queue. * We need to mention the message count for each of the TaskGenerator threads. * */ public class TaskGenerator implements Task, Runnable { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); // MessageQueue reference using which we will submit our messages. private final MessageQueue msgQueue; // Total message count that a TaskGenerator will submit. private final int msgCount; // Parameterized constructor. public TaskGenerator(MessageQueue msgQueue, int msgCount) { this.msgQueue = msgQueue; this.msgCount = msgCount; } /** * Submit messages to the Blocking Queue. */ public void submit(Message msg) { try { this.msgQueue.submitMsg(msg); } catch (Exception e) { LOGGER.error(e.getMessage()); } } /** * Each TaskGenerator thread will submit all the messages to the Queue. * After every message submission TaskGenerator thread will sleep for 1 second. */ public void run() { int count = this.msgCount; try { while (count > 0) { String statusMsg = "Message-" + count + " submitted by " + Thread.currentThread().getName(); this.submit(new Message(statusMsg)); LOGGER.info(statusMsg); // reduce the message count. count--; // Make the current thread to sleep after every Message submission. Thread.sleep(1000); } } catch (InterruptedException ie) { LOGGER.error(ie.getMessage()); } catch (Exception e) { LOGGER.error(e.getMessage()); } } }java-design-patterns-1.16.0/queue-load-leveling/src/test/000077500000000000000000000000001312550536300232425ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/000077500000000000000000000000001312550536300241635ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/000077500000000000000000000000001312550536300247415ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300265715ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/000077500000000000000000000000001312550536300277155ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/load/000077500000000000000000000000001312550536300306345ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/000077500000000000000000000000001312550536300324415ustar00rootroot00000000000000AppTest.java000066400000000000000000000025521312550536300346110ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import java.io.IOException; import org.junit.Test; /** * Application Test */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } }MessageQueueTest.java000066400000000000000000000032001312550536300364510ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import static org.junit.Assert.assertEquals; import org.junit.Test; /** * * Test case for submitting and retrieving messages from Blocking Queue. * */ public class MessageQueueTest { @Test public void messageQueueTest() { MessageQueue msgQueue = new MessageQueue(); // submit message msgQueue.submitMsg(new Message("MessageQueue Test")); // retrieve message assertEquals(msgQueue.retrieveMsg().getMsg(), "MessageQueue Test"); } } MessageTest.java000066400000000000000000000030241312550536300354500ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * * Test case for creating and checking the Message. * */ public class MessageTest { @Test public void messageTest() { // Parameterized constructor test. String testMsg = "Message Test"; Message msg = new Message(testMsg); assertEquals(msg.getMsg(), testMsg); } } TaskGenSrvExeTest.java000066400000000000000000000034711312550536300365630ustar00rootroot00000000000000java-design-patterns-1.16.0/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.queue.load.leveling; import org.junit.Test; /** * * Test case for submitting Message to Blocking Queue by TaskGenerator * and retrieve the message by ServiceExecutor. * */ public class TaskGenSrvExeTest { @Test public void taskGeneratorTest() { MessageQueue msgQueue = new MessageQueue(); // Create a task generator thread with 1 job to submit. Runnable taskRunnable = new TaskGenerator(msgQueue, 1); Thread taskGenThr = new Thread(taskRunnable); taskGenThr.start(); // Create a service executor thread. Runnable srvRunnable = new ServiceExecutor(msgQueue); Thread srvExeThr = new Thread(srvRunnable); srvExeThr.start(); } } java-design-patterns-1.16.0/reactor/000077500000000000000000000000001312550536300172675ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/README.md000066400000000000000000000030431312550536300205460ustar00rootroot00000000000000--- layout: pattern title: Reactor folder: reactor permalink: /patterns/reactor/ pumlid: DSR14OGm20NGLjO23FVj1f7Hx2Ga0nzjVxtuJc-f9YrtJM-V4vZn9NA-or5nvfQXBiEWXYAZKsrvCzZfnnUlkqOzR9qCg5jGvtX2hYmOJWfvNz9xcTdR7m00 pumlformat: svg categories: Concurrency tags: - Java - Difficulty-Expert - I/O --- ## Intent The Reactor design pattern handles service requests that are delivered concurrently to an application by one or more clients. The application can register specific handlers for processing which are called by reactor on specific events. Dispatching of event handlers is performed by an initiation dispatcher, which manages the registered event handlers. Demultiplexing of service requests is performed by a synchronous event demultiplexer. ![Reactor](./etc/reactor.png "Reactor") ## Applicability Use Reactor pattern when * a server application needs to handle concurrent service requests from multiple clients. * a server application needs to be available for receiving requests from new clients even when handling older client requests. * a server must maximize throughput, minimize latency and use CPU efficiently without blocking. ## Real world examples * [Spring Reactor](http://projectreactor.io/) ## Credits * [Douglas C. Schmidt - Reactor](https://www.dre.vanderbilt.edu/~schmidt/PDF/Reactor.pdf) * [Pattern Oriented Software Architecture Vol I-V](http://www.amazon.com/Pattern-Oriented-Software-Architecture-Volume-Patterns/dp/0471958697) * [Doug Lea - Scalable IO in Java](http://gee.cs.oswego.edu/dl/cpjslides/nio.pdf) * [Netty](http://netty.io/) java-design-patterns-1.16.0/reactor/etc/000077500000000000000000000000001312550536300200425ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/etc/reactor.png000066400000000000000000003655541312550536300222310ustar00rootroot00000000000000PNG  IHDR33IDATx]\G6EI̧ Fc*APP + B(vT$ƚDcQgMw;qfgggfw߇}@ @ 5@ @  @ : @ JP@ _$@ TRHI j2v@(A"#APM@Ǝ@ % 5H$r$5H  D B5;@ `Y`֠A@2S\7fL/iݺɹs[C~Պ B5;@ Ԡb>}z9KN-`B/#۸΃JϜ|^9Dy$5H,'.A/@:AjP_Ϛ={Q͛ˑ_(>T7&fQԩdVM&.XTعsAӒ5㬭^zzoyyZAF 8Q%$L/)`66w/yPfG!֬CF>{Xtyc,,7@ ._j{7wӦ! 27w 2DHj@ B3!&^^W+ែ|xpWަ..V\֭(ff?C\acԠ vm%==Tp]iܝ-$5H,'DR@ 1_.JM 2s]|(QQf\f7EiѢ{]~9EW92 08chO@L ʼٳcٱ8;hB4 ظʕCIRpJ$5H !șPӧGv6]n?9nn6[̝[\u|f-?޵OsehkkHGi<Df 7o^b9Dy$5H,h(MR@B˜ iwul׮.60hcѢ S C7k|?9y2 p|ر?~۶M-u_E|,,ml ukPfo>BR͂pҬ^$LGR͂p\Hj@ Bh3A$V4I 4 a)Js!A@ X9$5H,h(U˰=@*Ӄ~gHq#h4€S~D"Q$I@HHƍY,NQNRD"|H6 ;ȑA4Db&mvyL:-4r+bA@I !9L22"p6 |Xq$F,'DRՂf +Ɲ/_wݹ3BJMw!Va&apch3zXna¶30}T篿Al۴iO?ĩE&l]AG{`n{T0j"ɸ4 d*ԠӣG&(ay҄5X\gcc7o><ܸNZ?sf͛{Kr dLb٩/U/f1 -DS0v-& ;:wܸ8V.`dqʔʔ#Jȸ4 d*ԠٳG1yBy9Ç;ٙLH% rnAY6`@ϱc;;[Ł:Ծ~S=lZ[ZꧥE\v-'' q7@tD733F\Ϸ&%VCT/a&asߘֲ9cΥ#G%98;.9fNO o`lܩVDÖ vaa6Y:55s6847Hhjk?G24GuPA\bޙ@53ӓ4 )ΆkݺjK2npJ$5h*ݻ09P\f5ٳcѾLn}&H/qN $mn{2F?^^}M d`>۳"$ߧ~ a-M_ ?@^HƍYj.љ]zjԠq ]pWަ..Vp2nڋ;AٳGjAepM rj²u&Hmp~=XaN [ 9kK\wCӦ3(/äM .QX%s_]كH5 wt1 uf۾}ќ9a6%E׮K~ -] ХKs綢L\XU3y>XJ =:thĺusP2#c)җ/fe޻wѣ#d+Ee6:6rڇ A\6 A|JoT`~]7t7lsZӧG5k5<=ΘfL왛w]Vo,W?5 `7œx$*q= k@q+!0iȰ 7rKp*j 먁VK\oRw81n`njF^@ .\Da:vIf !؅ڤE*̈́aZ5?V͚#Iwׯ'||C(4N} ɸ4 Z`ep;1HӃKR@ѣp 3feK(܋sKօ8N,eǻc ٳ[,-qxW^(@rZTsNl޼=ʊeKr dl:2qg1>y?}ΗJ ?{8yѾ;BYaN "1: MKfvZgώծ]o_s{lm?IDcK:Q'gBf^^< fM^(/\رre L(_ lZqjN2n͂py% LœڵkS֤IɓdXA\2%%uj#A!{Os.#xz:B\] p lmPƍ5ON^ ~xm6eG! <ewb ȼ;9Or dLQۙVN x7nn>3&o58+) ǡ@ ޹s?kv,?;wFȤG%҅uq#z2 :՝IĄO>~&%wGȄg[fӤA\AgL[,1;vl͛zyEzhgy?hJͽu|La 5H$ˇ0iȰL×CGo4/3<"'H]mg|5(A4Y͚7i`@BALHo_\m=xpD9̌:HtiᇵcUԪU7MjPɸ4 mpwJPKprxw ,ŋj׮ժUc6N2sn̳WfXr6l9qc=pܸ}z^% 8$Cr de|ƺv_O×D#7fA 84vŧǚ1\Z"54Ex$EF`QQG͚3fi߬YCg_yr#>^ZZ̳|d/ed,̌.W_I}_K& ]|wpɖ-ܻK[YHjH$a&a'9q#h4ڀyƌY''BB5lNws ?*7'gY& خfD￧<~\d”?: L!=n܀Cml ͽ^\<,Y0:odt^0iȰɸ4 n1_!{utΖz~]7AzuΖlV$PFW MsG󱛛_H_ ܹMڵThNMNNH#~Gj2ԠqW'!-<ƈ4r9a&a'9q#hS$AM"$_.bjPv;={TevӰ dAr Z`؋`GG2nzB&%'/ܹclmbc/"cfݺ9H#se`Ɲ$7緍|AԌ Y#G:?t(^vl`X+'Æ?u^!Jp/\W>ivm޼wF :#~5F|gkP.$F,h'V&I j Ǻnw& -g!=Ƹlc##/)1c!iHO!

qlQ;HƍYNL^|H#S:.#tc?M=d;cccML5u;SS |QumjBڵ";eʨAe] q#5jUäM~~ޠA~..V?|xxذ>>.nn6Gti׳ #6iӀ:9Y0#L֭}aẎ[F !. tBk̘~}\/){xq\MqՠΈA+o<(2lf- 7fA 8\U wVjA,RĤy9m5>;za>}Gg_<UVAw=xpH"g Fm˫/}Tg@ՠD6 A_+%U]ᾠ@Ӧ];P :?\5!9L2D"G2nj02rJTEjsMH[33e&rRH|äM N$r$F,hg0ͻܾ _~9]p69yܹc5/,\Ǫ; "3C Z{{XZZqe~͂CAe6 5?aoM<,ՒvنEQ{Dr d؉Dd 2L /_f,ٙ>YZ(IJ߿lƌ*Ac 237n2 Co_Pu7E풭A$5H$ˇ0iȰɸ4 d;}߸ݯ_I*YZݿ#GV1UᎹ‚̂k[fgL >|xx֬ݦNu׸ʤDb&mv"#7fA 8ppHc۷/!sTp\aAdf-TL ~͆GHxhI !9Lڄu" PCs}zT"+b &3_ s1Qʋ,S .35w8d -l7RD"$I@HHƍY ~ލjNRD"|H6 ;ȑA)]&&EEjI5'A"X>$I@HHƍY NT5ٱ;vkޗO䛚ȿFIr d؉Dd2DHjPKXjmo{}HayU{¨J)&H ;a&TNdAS_$jgNT5H y..Vѣ# b7aۀ=!p1FӃF8;[~?b(1mn%1=;!}TrÆ緍|AԌDަׯgd`СxA>usZ<6 U{*Ikl\32A+i6b;8=E_- 9L2D"G2n͂:qBLS-F32r [$o_ܥKcbZ5<<MsapWBB0ZWs+P..@ᎧO'XsgŋQ%gdeŲ;A>څZq qh”)W \|S!C~+Agdޯ1bKL<~|ڿ0iȰɸ4 d*Ԡ9y!m69Y;-- Ci'W^ܵk1# wY>>.W{N œVC_!fF9CqM&Jp/\WW,_ 4FYffzjha&a'9q#hȀU"A3&fZ| $sΜ;px#TR Xի^<п1cHΎ !eVbb߃]\%ry7W,_^g 4F,<|s٬#$IatMsj5Ǹu=$˝d̉*Ԡy~ޠACعX=~azyBҥvv&_BfpפI$I]"X$F,TN6_RnDY&-]=  uC}|\5|͚;ujicc/)L^i'uCS^*TR*_߰m*KT@2nyDHjH$a&+EڵkֱcKB4qjPQEF{K &a;Odk~3*AtzUWݻ%*I2nyDHjH$a&(6A h$$(2WVV݂FDDLˆ/8|`pG䘚Lce=:ffƠN.nZ[ZꧥE~]Դ[}Ϟc~=L/==:;;o_sOOG''1cq} jѱa; hDH%+?2Q]$F,gNTDb&msਔ֯.\yוyp6MnefBRX'N%K&bJB;LcVCY3K"}ylW3 yt2V X& j@ jäE!Ǚo5r5/ +Paaٜ!re {s _9 Λn o4^{X}q[5)1q+Z`9K=< `~i' ;ڶm풞U!cf'AaiĂwDm5S@$F,3(dWP/XɬAsD"\H6AaoaCap"_SoA ?'N8K/Xͯy͚Yl%.X ᯥAA++WҡHuli\L)8sײe.q}^#Aɸ4 SB8b% H,äMg؛ŸMϘ)e>qL~N k ; >M ^*45=yr#_)G& }Wŋtk2-Yy:u>rԴ1Dmcn-iq+|%o9H۝;#PX"Yl'OQs]Cq>&VAZ)ZEHƍYPI VJQ.t))&&ffzm^.1V*P(&A"X>$I ϰ{FXy 42'4*' AAEfL/$+nl!`vȑU5{D(ȪKṽ`2e@cNK?o۶)[)h/s@qQddV/&Xoϟfazuk2LF1z]7ߠ@ O\dD2n͂JjCB7ˌF>V"??A\jPD1I !9L.iO¡Ȱ ڿ{ T_T=We_C޻wPcE$F,(A 2c)KDsr sΖٲ^\f /Bg{]$nѩwv{H % (vcR5Y>j@ jäEЙ͜ $+%L*]Ujp4}RM. 7c7HPYKYf!C֬& 5s (M|A"XzäM N$r$F,3dRY3K"?&֝;v57535(/]@i[MA"XzäM N$r$F,3dRVV5Uy%}}kfjP_D$5H$ˇ0iȰɸ4 2AűCfjPJ+WґHM21}D G)Aq~JjH ғ&mv"#7fAW&(DYKY02S^d. ۹s]>}('5sok % (M|#5H$KOr d؉DdAK= L8I !9L2D"G2nB.B7S*N5::v/*JTM-.3_nܹҮ=cwv`ea[YupyZd"Cܹ ׳Jݮ8GܢL5͛s((/nW|w_5m9&.N& n uvkjȨW_mۛ饧GN6OK7 {H*4m©Anq bں[H85;{w>}x}s W::)cJ/oHŃcӤD뀹y'ֳSЁ/OdA7эSY6mfAWokBt3BgD%IƍY 5HTo2#Յːaevm ֬%F>Ê2BlVаÏ?n߳'F"ݳn95JՌgc7@ܱҵ+(S .Y2y;ԧ+;AެXwx$RgÂ@>wnmÂ[dRtvv,r^̀@@>|xR*HqSfh  C]5l?_b %#o( O-IByS~yC*Q7ow֯;i@=H<4|&~u+7S5!h:ʲCZj`5DfJA@j+P OءH8/#ޟd͚Yl5 X&e,<;sjNN?qb}ǎ-=>=Zv9s(3q@.-(/nW|w|5xnn:궂΄_V~؆Fw C6ׇΠ|5݂Pu1 {/7w@ .Z4]9a7J7GPpƾ?;L"c/oHŃ}Νڼy?Ȑ}|\44I{-VҟNqWor eY!om̵j=w6HTdՠDgNwu TbǦg̔28D&Dž˖RjLJol -'7:ujɭpΏڧ9냠u+7S5!h:ʲCk \1j&$7fA5({x >F|VN^=*@hdNhTN( /#q/]m`EL Q!.BIa:N 63Ã? 8=|xx^ .gZ.]q2`)_!UAo AƳtxD"s$Ҡ85kϖ[g3X,>$r&(^ l6$ɸ4 *A61HӃՙE.iO¡Ȱ oXCx(Rڄy.*^{VDC0iʲCkb Vl6$ɸ4 eT6 (.\Pں[V;thٱ^L ˗Sggj+W Q%V3Y$~KDyLMR06m^&NӦo߾"IPE&(^ 㯆Tl6$ɸ4 J2*^,w]paDرg^ԣGGP .ǻڵXjǍPj}H$j a&wBgD%… իg#ѣJvD u^ %BK7%(Otʕ4oo'' SS]W 4i/)\%7nd7mD*JPww{33=ZtQ>`>Q_-S36v:/,G&el`]ٳ'ںY=XqQG/@ZZTϞ(ܷÇev: H,&wBgD%Ɍ[qq1~IIIL 2}XC *%BA\6ɍ%KssWѕ_aZ5<ɯ]?lH7kHD9MXd˗Q΀[2ٳc\H?4D:,}G?DO1c8n+&f􊉙&AC c[;Db/رSR"]R &/ODb!Amv"ƭr&T+%(S66j]<<%ҷ&Lp;}:YO5ANm߾9аgnk}w$Ҁ_?n'xӦpљSe?R_܁O:`@OWW?;wIF8RD"$5M N$r,/&L0زeK $ *,A7n vHgz2^tjjj۾#@Z52/)i񮙙1 2/]?c֬\Wr{A3n n/));Oy)S;0y 3jΝ.ȨDbԠ6 ;ȱҌ_\\ELɝ;wKe a< =P8ș 9V+5V0헖 j(ZHq=>{,;;oРA ,fjPxb-Z2Q#NT ,W˖-!l Pw_:ģQ"}i>iKbBE:;wF(_zoضmauP ?ѱ{QQD%A\doOhqΝNB͚5;|/w57ogϞHգ=_zejjzIR %AB"\K3k+ xqIII-@BcJ3Q\gcc|KNHenwsR2`B pdiEFv'F[XXܺuD*  (2|#8##m۶uqqA̙3Q[JJjX$5H(=`يǸ8(CuwY oxb$1|Puؙڿ!@B|,[[#{{33Cׯ˶ ehm-$dc5ttr3E`Ӧ?~Ϫ2\xϞ{w02xT2;ۦMOԹ2E>yx8XX$+xV2ǥvAJ$5H(%`GɿKFrx@yƞpP9pTʌsW.C˗̛7ws7m 9}:RM"͛xz(ƍu?gssW@iU2zKuѾ'N={"l$ͯ ,$5X\d+V^IPQ Jtt^Q-$5H(%`|\PΖ8ygY &Q!ϙo5r5/sŽmz{GzUȩY@ϕ+\]YάY#22zx8pUݺ]fʯ\Iܹ g!N ,--inX&,p.I x2vEUԠdP^IjP#*9iFkN͂qL~;#ث}5k-%;CۛySUɓӨgO#G`+,qx>} 5>X_ڤe!yrOd&v%dW n0/<|"?G_-gՌ޽M^ʹп|9Upٳc& 42ؽ{g33=tܸeŠΞ2~kff !~3fɝ:xp@Orfqq~:7o^8e`q}/fgFdWǏc!uFC&Ae0^߼y興KLLYѣGx@ r9Q!|AjHHjP5̽ER>>.l;wh휀N̄H@k evrT( U11:O8 q>HaNś11ݷ/N\g`us|ҩiFFNasz =a%zM;КAȹaÆ8ŋÇ355A;ґ𰰰yZd"C仺ZZZuߟ{'sҥaaaJ Q!\@jHHjP5B _)KPhcNQQ&Qȱ39yr#;{~^~=̐ ֺu\^(|V]VH{uN"Ֆʪ۱c&& 7oeIaQD&74Э[{dwI׳XkH5MIhҤŷTW_ ưFC&j/x]v_fB5jٳg(Ӵiϟ#ܳgܹSn]N B7BX!2;k4ij6*$D Ulͥ qz_W&.63ӓH d˅$VI tqqaigg炂/_[e`,Yr,--958o޼֭[[K=kLO pԩ6lWR䀦 i(A%$9$hJ_MAڀ9jW7$ $227_Yӓ2L ,Xݻsj0<<m)^?CR^~}8sD!K0(hBB)@jHHjPP2{d* LHJJ҂ J/44tܹ8}a:&_ϲ5713KOFNun%v܆:Hظ6_(>LCeocwv"Bqѷׯ6|($V& n uv+sq22 vĝHwB%&&1UHVV݂F]8AũP챶2(T6/^έ[{e9Yo32zx8p dzu0yyPGa"D"ww9kHxylM"]ºre PCvy *X~{ݹs@wCC(prAE砊=jKկLOR2j%hB}6*L4q1S |2| ;xQ4k2l e".>Dw8u*5k-L0kxFlbzzt6MPX@̝[PhʕteDuJѕ+fCF>{d!wFŝR1s.U ֢|AO{{\Uɓ5PR|5= [!5HQ ¦eի{^iarg&MhdԱ{ffz!ˬ?'<M~ӿ!=\(;`/tظSFR*!GXfB[VVݸuj(toɒɒEF =*nTBj5PZ L[, mS >ztkv1"4?0SP`֬~~> #Bh_\ySkڵ7VBdE PK~mŋJ=JRA) .\Hf D_u> ".@*=unII)Qϟݺu&@Tj^ ^{'e!AfAɠВM JxpA@XXwF}\ѣYUqq~ǻy{89Y{HQ|ccJ ˒]u׭UӧKT-]:cZRv#m C uڵLܠu7{[0baawoT.NZdԯСx4&Ae`umTXMؙ͜ $T}@oW`)}(Ӧo߾H(#I 4 JFIhW'˗6ͽkoȆa+! Ʈ\IHm۔R#.OH4ɳ2[{p嗔v횙w8d*ڵ=;ƪRH>|NZc!vkD]pV"]>3 Ԯ]pD*hW, ݲ<X:Pl!<2&Lp33۲%TM#cGP􌬞(..6*D"hh*"#=>~[;thqjt%Y^C, ދ]t*TQ^^ɔ׾}qח/ի#GVLʵk]l yvUk@Њ/6kԩdP.0ԩhkլ~ToV6z@q-B@nd82vAsQ ȑ APЛ7/bK1Ǐw̌؛7E zCϘ5k$W/={v8atX/,l1߿RȔ)#FL5qcCf2H3 YnҥǏco>%.eΝukɦ I QaZZC($9$h:03)i~qq^˖_3$dDx3 3gtvRS^j&o_en0ǏY3Msg`=:bb ŭDFN/_Nֿ%k[7GLΝ@WQGoqo*1qrp::؂Xn2ց*(X۳%  >hBA"#Af,AL~Db rʪ[;*NW_uɢwo v@8`nГHc {I/AA!аCn$I3A+))M48p`?Zp#}$ο~=vFqkW/'7޿ׯ_\HMzΝʦ'OfhlX{j 8r\uP6*q'4 5H$r$5H,T\Ph(i$K[vo dT_uQ@U)$47HPڨPAjHHjYk20hϽY'nn6kՓ T!APHKK 5 D 2DHjPz AyFr&D 2DHjPz{U6*l)mTXQ+O/5/t7̙J^;>%%DLO_mpE/:^w,YtP2=EF\}߅VX7mꨊut^TXAĪORAJ$5H(=hnPjp*PoA-^c!,Ty\9%ɩA(ۮ]9#uw 5BRE* Q%$jۨ6*jPL_Ƃ !QGH4hazw8ŋLLMucb|Nβze cz4p۴p͛7WYXP3 ^1$dCc5t3Eׯgۛ|zz4r6|\rFN=F85(,ԯ_wTw|P3kn;ej󯭬C27rzv TW:nHY"E=] XTU.M>+ͅ,PPdS5QTwWAE7dSTdp%,Lϯ4w 2n 8 ˝>3Ϲ{{{{),v PJlqZ mAbHj>r] .[0..j*p&\Ks~`S)d 7ofB.ңGgYR<|1->JA3ieH+w5hPRyyx&x8B@@U,7(ÇWZ5i{o -h\I|$.%@St%'(Hq|/hӦw7;lE)I  j%%%!!!b>L 9uC /pl¨'4tȨ ʉIIIFr~t(@edKx+TXأGE R͞1ڇY=eq999lAdN B޿3_H|ҥS.T ҋw7nd; 'Mr۷/Դ*֊gjP&wFFmWe pBWn mA A}&A DyD ~r/6aTsjb_:Z jґjʾXBHBϞBӧOo(:\~GwB̴h!$HgOR¯u#Eӣ͍@V3fLG~YL J7;e4:8c/r0:{vkjLN^ܳgOOyglp2씕jHQ453'OߛeTI-u9wi@j@Դ\&=+O?(sR.%ǣipnԈqϫJLGG7Պ|iC:Ҳ+9TlY>UR$AAB-:>_j 9E E6 FhAAxMBdfk˗D@.2cgvvf8r..Vckk2.B9g{E8/Z5Ƴ1a@ۛCAMeх @w0X"#G׭[;T U_S,_ŃE  DgX &z{YءCk6Ԗ W fΩW-nĩR%YCbNhO6~ Ak(EXNK[hx&'/8K͚5AډHL bpWI{WLZ@(ɞx/UH~s&R uʾK*@j>AB*eTLoq8)hdX;{7M MҶR=*AmU#59^C*Z$h]+$5H.8).A~殴3߿A}r5ff]D;"??qwllLS1o| l9W>6UU)}^^ٮ8ɓ(U,$i're}d 70R)5Yb&Jj4Qnnښl hѣ3FC ;=G= j$ -TXӨؙ͌f5CƸ;[XA終C0D&JY?|v$hT1Ey/ٳ[! Kǖ'&ݸ , "\l֬ [GեÇH8|?6o"CRk2ڷ.& [zx8)3*?A&_'9勸BoXriժ) 2L8}]j{q&㗂?;hÆOgYCeDҥ4#6+׈|4e&kPl %LcGh8zP!!-TX媈D څL 5_ڏӱ'l~cSNV;pa1߾lٴ\>neuޮ9sFhm ~hzoEEiNf a{VT1ի]7‹ut<<;;ovT66_Ŧ!ngtGxq-S! {6L"n\ Ws|r!C>x0eCeh`_#d@”%ܚ8˗Pz(<|IGhNUX#vA,HQ&-Tf D څL n] Iѣ'B?_Ξ]:3 `ƍ @O gO"#g.~Ӈ ~>:u( ]h|  :th͆+UqԂp˖E<~\ȦZA grg)TG; ` BBj ȑ A 5D Q{/_˾{h0WX3ORA}M-TX$9$h&4O$}YW& <`THj>A棤$..P$B Hx#Vo$ $hhJMC,G 6l(tժqqqBBGKB hH +ERAϕ*l-G\ti-իxbkW `BBG5tIRJ A}/t5A 4ZTt@4bO>c3&$AbHj>S C*r3Q> 8ﳳ/?##EDs5c\*/ AjX)VZ 6@8؋A , h:0e;+S`ce6LA(Q95(k<(PC ^i"(8uI r*۞ 8A+U=`A ] ]S2\ݸNmGe|u‚P'޻ >I DujA*dӮrb8..N$ [jUZ 222X144əQ)5:{PIjH$CV J  ]Gqq1DTi %AVtG T*d63 i5fM…_&"{wxƏRYLGG7^MWڻeˢԁXI Duj/TȾ^gUMĵDSBe_a8qpZڲFIN^cMf11*r`|kdt ʸ秼\\,,=?7wY saX:CvDwD~~BؘٸqA3dh#G:: }"mmM"ƒGW1?=^*烨Il/+LM;+Kݺu+k׶МG;G  פ$5Scǎ%V`Ybf`߾ovKggǶjzjܹwVl!j&M 2@2BзbǢKv~nH'ƥ9yxE/ٳ[! KXbbЍ|Oe)˗O׬Y۷i]>|XÇcnmfLŏ srb== pF??e`,9y1r&B+8L8r%[MH3oX.g*uk%"u|y/Wb$5ĽXwA ttpsiԨ?"2?:~.͛NϙA~‹woѐJ\Κ>puFԠ"bB?8de._Xܼywƍb%~~~4ФIcVK"AQ:}BfsM[I=98xbh$|rٳK?#q=0N&{D,^w䲯ʾ3{V_l?}vApIIjPwX\5p,w!!a,Cw Ұ۬1>dIe?l8žޮni `_"N͕6oAٱL@#,D$P zJbT P ڜ#""XoӦMeF{\ ٚ"5UOmE&F.A{2g8lj$A]#$X.]J33ܡCQ=;J$`t3>C~ȩWﭔ%2Ǐ \??8)Ox.++cwΝaJeV6$BRZPaHHzB|ϷF7Oя_t)K5{섄Ŝ+ȆO޿B(ܹs2b, %v>*WQhhe˸u5lpŊ:Չ"A"I VlB6X\zQ LMM={0[nk_p!6:W{Æ ͛7oѢ/һwoP&n/,,,Ξ=/wC$.'Oԭ[W1vO>!k׮*H$~~~ɨUtÇRWт ׯoddW _X)$` mpgϞ Php 5j$JgϞ?n߾ 6R~V ..!t-4*^EK.1cUD@NI DuHj*DVvBH?檧@AQ7q+6!HhWQI_]tA/y:] $5`!##C,WP!]B'%t-7.]@9TJ AghB8f/.WOwkƐ6/qjG{ %OBMb_}zזKPƅ??beaa+=hP{bfҎoߵ+L$ꈽ#7~Ƥ8Y}" :9Yy(] ͛aW?w@R !\g*Bׂ>p%е tƥ9yxE{ .|Vgg/^*JL q#[|:bfMnVy$>s!“'[~]QĄ%03&f ?}zL.֬ y3C֏M$Z5e="O+]pgI+HjPsi* v+(=̜33W(SL\ɻ;vgMHjP\\,?299Y$B+aT*%a%b?K+N bȶ޽{x8'-;v45jlr|e&sܺս{;c K:)"b*@pΜ7;,-2˸q[B͞,ڽ;WӻvmXۯNV'J'BRK݂ҡd7K~j\IO+isȊCBad[7ǽ;3~m*Ze )SzhР>n ᘱ6Y ߮_[l/W?$5XaSTp j5Wg4ڵkP$P(W?hXxA_cFh^&sŊ'Kbn2cg|1?ɉ U4oXŴF0p”%Є"u|yIn[,b.}U,t`_\DUHjPs91%&R2vO=>+vs|veMpwOoР׭ 1==JЧWb5Xf 㰋Եk 9#4CV)Un ҌOR5(@@Ab>,'HhFJA\\H$N<_uT?@90*ƁIOohd):Yg]@큁Px>,s Y_~СBpYaAM6 ƍa^L:IǏ D+XYԠf̹6%zySLIث4nEƸ8?`W=:@SM,AܢL8YXĊŦZLcyj$3ݙKL zw+̙W֭,ZW>Ǐ;֥_O 5X$5Xvc:^PăVL!E E6 F8kիŋI:9Y½1߅p۷YY#-F4#6w9K{~A}k٭?/0YA@ښrN..Մ\;KZARЬxENN+Gxm(+<"/HXꆽ\L{o]M{ wiԨaWX2T.[v 9 ++w* gDا x)

sf Nuȇ'$5X`KCU(B"pEЁ@TfF&aɓ*$"bHԱo_??ō%I jϜ+ltq~+Fw&noUwСb=eG"I V ]&HjtN"؇ZݫC0 ] BMOkA W'V{DtI;w֩L6K|1-Te Rߑ΃M'i _X)$`U JB~g6.TV8Ŵ$PuNI DuHjP=-Tf|%ir=AHHD"v|ubHjH$CRj-!ZP!j ] BA$'Չ"A"I V R>.Tf)5h7:oHUA%}uYw- HTU$vqд ٴ"PB-#..N$ ] A[Q_]`5 ~I.OR:˜ݻÓX1SuU [AzPU⚰PD"%83.{d=$5T[ ^/(ȳ^UY5+FqqX͟<P!9JJJh"YA=Դ\&`O YLGG7^MWeˢ@9\仹 *G2e}SR`wYlܹc~ƍ Q={vAS7I.\5ߎ gp޾=vH%;2D9m{ȑ'K>ߍJ˜P+eyBv޼83g(m ~n̄FBڠMhr@LAe_a8qpZڲF=:\W&Nሪip9k538p PL̬uyFCfrfPgbbZׯW.^ )WqRZ~~ fBœX}dG|\)&"K13TJe?(̕2L6mT|I zyy [k "s6H h b_}zzqOKtq0@ܕvvf4Ͻ{a13 _oߵ+L$ꈽ#5n LJrei're[vneu6,l2\Sc_1}&A^mBb:J&76pZ|:6,ȈB`o5 r(gh0؇#ogOh$`Se˦qp,Ǎxʔ!J˜P+ec<++cMϗԠ]&!ct{7L G53AfvqNAP=`\ꜜןGLQ4[ .|Vggv+޸ X.rY&Дy]>|Xp,1yɓ-Z|ЪUSFGȶAKerr͚ΓԠ2&fVB Νv\l:qXJ%,AP~m<<\]`ל9wG 8xbTONNܹcv\FnemT[R) yyŨ w2꯴)7T[O& ip A ŴP)u/8o&q z Ί[[ԴӪU/\emm̷/[6-,l2\† WwVįNMfeWf7n`Z2.bMԠ|?Çۻ<~\aȑ?C~_yjoΆ1(sڴg+b..VKN`D.Oo(%;DJ᪁1~zѣ'Nɿa 6n\z2lϞŋ'DFΈMFGpO:t˖E<~\/y{L3޴i(R.bM QkHjPj)Ot *lr4X,zA ^;=vCyQy&zgڹzusqrtxqrr319~|="ۛe2~vXljee؛a`СUx Ν\m!S<{v+eΟim]: RD"Q Ms Jv[sh*ȨBhU6@op"Qj7lx42,w جc|y/ իa23W~:J$5H$աAh///PEP![g N$ BQof4[a9!C'OnƂ5D:75:R@svBEZSv@op"Qj$$7F 堹.*DV^7G$`-1N'VoP HTKJJX]RO-T/0k }:9Y6k$ `T))?~P˖M۶5pp0?~'ƏAjI 5D:y5ȖA򢡡5>}ԯ_ȑµzرcXVYu5ط($S2bZ5}zjܹwVl!V/I 5D:a5x5X,h^4@o33}{HyjٳG;ۛ[X̂Ѿ:iJ8m֭RѲ9ce6d[[O\| zIj$5H$աNZ约zP!Auw`b޽_8]#SdIIdŵ[ɓ>嫯YY#p9lڴ`j05Ojl{m Vdi0!^]X]l5(k< EA@xCԠT* H$[M- *&Px`5_ׯ jSAAnn65\Df=~KHÏy \935Ox?vۿ?TiKYB2wlajAʓ V7H$ՠ.AHAZ;DP!7xuˢ(?3giu+?!3oؤyF9zU˧`bw~jdݼ2#0~Ν?E035Xf'ObavMٳ=zfMG2-j&A1H݃LRD"QdS\W Ԑy*4iZ@ojgqqYww92;vNZtC6|"O,߿7eFhgg0ݮL D֭+mncbRW5lryf͛YVVW+}iC:ҲkA*nO _MHjH$CPRT$bXk@7iҤRҮ j5D&Ҕ,.СQϞ|yH|)3f|uh?S[))K.3LJ &Lp۷x@'{(? UŦݹ3Li ކMMU eTcĉ틬byd)JG/ w :bƍ߱1).Nű89Yy(bvvqn_0^լ<H$V#W űyJha-C"T}Dnrr2!Kg 5H$ BQƥ9yxEq_pah OXlˋ4T mڴ \SS#??ռw"ɓ~!23C-_>$O[rCC'A{a],[6m޼OoCY4V?OX.wL[Be5kSQC^vbliG372j4m`gL̬?<mj5T%EmTb9hiDH$ppBA"Qj?_Zq\M9fڴ9}Р>c}6|_Hl? vuIN?^&M[[ԴӪUKDZavHrFn4ı^Mڵ-/^J׍?_*QʷCsMu+{҉|NY(=wngk2? £GؿR\jܫhy_(o]ac"&]jMSI 64~-TOgV$!ÎEi86aTS\2fLP#G:BA>}%KePzh8PhlɒŬVgZO>iqn޺u]̂ɋ̛7K-Y'ܼS 㗅̘ߎcQ0''sMM`F۶su7HR 4<|3erYhdԆZ&uZ Ei` @DCBA"Qjl>!?3Pι&qnMlv4ϱc3p8v9WRohCC'vΞ`d 22Z, ɴ%$sÈ>\SݲeQf3#/ ٸqߎ'߳'b D4tA͛ ~~}VLE@ƛEL58w\v&82WhqFN:pavP1SϞ=(&fL>*Z)7An66&XQ .Z4iadŽ˗EIp -&i&Z!  Eh:%G--T茗 R[# 5D zGخy(42/4*/D/SNf |~Kˮ?̬W_mî%K! ,9_|{vc3g4vҳg(R;==J&BqN.O&؄i'qq~2T* d[x..V؛a`СUC"2%+8{vgUՠ◩`S!]iĵ3 MZ2GkN#G@wOEqcqq$%͓ea>yr۾}C5׸;\ȑ,Cg^ڐS_9ʕ#ׯ৙Hvj,))aSPV95^Pa 59Wj$.c=Ͼ3PC heģaKf5秚6m_x^&8 c*Xˬ65ʗ|563 `Ԛ5.c\`| YG68pɓ1QbݺuP(cVMh5j㏹BB/, .Z4m[qH;h_:p9wZL$V;5Y B@ xyy׮] jT*H a>@j0,{5DAUmn"5fFq|f#u/!CgشigJ?YmjP/ST"@ѱ25d 7 ۉI &%5ʙBFr[ě w{ƕ>}GQ1-AP3 ~HA( DBs5)hxKO_=߭Ee?~)?3cg8 62jFHpopڹ5_~\q uD%VTTrp0*{4gxʾCd<[SIlCV!z ;4-(Xkjٳ2P[HQP ~ !'\ZdS\!zi>sEI\:,l(`u4ߢŇc猻v%?;wrcddD)ٟ*R1+f(&Ų!`};L\תUӷު;vIJ|z})ظq Ob}$j2M e*DcW00S,61aq^begg6q`[[/L[S˗D!DQ3>C~nO2Dleedoo^#@KˮƳg{ˢ֭+" 7%uR)|h!iҤ.=_P}Qo\5őo*>_OL49@EG4mڤe˦]ij gmط/~"cӧ;4hL77f\ DIG6K>þzu#G:vOݻw^Ї_j4xp_YN+|7,ԩCׯы#ڻw9eVopf͚`\2.pmڴbDEZL{7-p۶zoQ= mlٴ(V]O3X5RjpR 5y.dH*g)nucކv-).HυYwmO c{r[tݡCq?{v1m u+Νܾ}EHɏ@K?26nߥ3[NcrAP :x0^)G%{/^ΎE{Yg={"6mZ _P2[WnPu+W⸰YfXb^&k@k^[LZ[n\+A$j2y `aa[XE[}~,?_*9&ksϐH$2^-TCDz>fa`ҾW/vD,tEMY@.>$ML2 Mavnkk66& ԇXz뭺=rsW*  $O`QƍY 5!3s/ _ 䨀瀴ep.PZl y cl/Y^,F577fRY=VwuYq۶Uf Պ7~Giaq!A&W':LaՠT*D.@]W>,Top݂җn`5fL9V=rL縑ŏy-JM8LND`M4Ʈ; =YNS/6…].Ȩ #f qT݈X&]svww00hoف]H%pS.5}2NJ`<|Xo"fYܕ˗"VC$j2I Du(,))a+?mAqq1NJtnBY]]PSl"%c7M!"3>_hiW'<7Mgw(葴i&cǺdgǂVF%&aׁq'$̑'nA-AOIڴi>2dSh:wE87w%¨E/]J{DqnȔ'ʊQdpN.ΘYǎtn\]ۼ/Tu+ ٞ<F6ٌL'NUQjjvY=VDNNaNmd14B)gn/4-O'$5Hd$P5-':J> ~\Q@Ot &wfd7">N:׮e͟~:!O #k O((Xkhؒ^ ON={ܼ6gؼy!̙3 Q..VJ,\8n:Ph2c9cv/EJشqwɅ@EAuٳ Ⱙ,BiRB^b&g5v Z6"Uz"T8Zw)ƚSPfW<:e˦ \[Tfm Z_drbUXڊk]cн=ztJש U52j$UlQp!!«&&!|⸅ NE 5H$ BRmA50^/t#G:eP1gNloonaa3 q!{&Lp8ZŁmccdee-0" /ڭ[;oV\_bjƍO>kS)>\ѽ|Y=~\r10hvN.$ݻyPM773Ξigg`niuhdgtGL8##_4L bT8g1Se jkv삘5 (`+^W8p b# UޕS^SpCNӦMX+yMovAԤFW޽f :|xݺu@59۵3@JZ} ^&mX,Ѽ I  A[PU5=`\ꜜןGJX̓Gѣ !)iL.Z+@ ^)SNE"WiN c`9Cu?~Ӧ'WLr~e˧n/Jz߾".~z"0ydժ2eÁHӧëagb޽۶g%Ʉ%蜜X Xn̄Rp >,T RR8(''K q !Ts+*7VU!ʻrk ENpfqyMoO>i9p~A7/6m(6fȍ]?!î/Պeл H$LP q℮&W2 [P:NI  A[P%5 s⤿0*ƁfpO OցӨQ bN £m^5hl>9y1\ \uS\_w<7~pe~rGÉav!a K&-d>8wo/^VT~.3ԠL<%56CX׬ ٹPӇ)}@ ʻrk %>n?י3[ʫפFI[Nlo.v g] x,A4r/wq sZjxyybC*$5srb3V#ZXmܸ6 ^$h ;^؄Q1dqOHJJ7j3 /8Kxst^85>͝;8GaaS\_"oqNʅwpÆo΄_~g !aA wCC'1|5Ⱦ;|x\t K2{PͮXG1o#4&d*z5)k|ƍ2/0p$}"MM;/+K J6ݻyYWR&U|Qf4K&2CqB3Pmmsʾ *}دwjd~GseKQ( GRmA` ~r/6aTq%/\X:hСU=ׯٳ'wipy=;]\oB, `btvp+oWlގcJ?:ők(> UB[(/p[7L)h<_~Ƀ f'ũW-6_:ʬ 1J]$T6ztՆBߌzpc$Û(&fֺuē 8hYك:1 ăСUkkcْ%Q-+P -v5BȽ};{$7+GG $*~Dm wr7n ^XS QJt,\R\Q 2;2e6Re‡ Ft4m+O]\0yN6tlWz ]\ؤ\ٱ0"TIӧ7vizzrp@ Ə4`@'7(Tct)e^Aq`7Re<ړEf(第/Ij- 5H$UkmR>(v6io*78(I D, @B٬ ^Nop"Q$h H DUY޻Mj}:X,Z N$ BRmA"*68"ʁpNwPaFFFs78(I DT|xyyaJ(7i҄&Z*78(I A@xw[\\ Kij85  AQAW΂Bׂk3*#I@o ] BP{7oH Rup$IIDFbSΒل֒{5buΫ2 (#h J5HRx &L/=L6I]t!uj T_ (#h J)0A$"Tp:bH$t8xh] B*4 I |0TAqq19D ГPZ iҤ Bׂ>*XP3`-]:p>zFFF!sٙe>L$%? bg(3M& D$ZjQiiiHHkAp{ 4BjzUTi2Y&$ ERIf'@i…o֞=+Ccםծ]q{f[UV{ƳȪ}{ P\6(ȭ x.Ο߆#G֌e|!C vcգ*cvr\^.ϙ圕gdebYyJS/Ou䩐S2nZ "jMD)))"l999^vG9rdԨQoVڕG  8yK9K<^ * ӻw~z 8sܸq#Gdh"l" uww777gϞSN^%\l`SR4%7kNRvٿ?yC&Ov_*uAla[X|vK**2j#dyZZ$U55Fիyys[phh:htGG 0|:1=}I#{һtyta]/ni@t!~oA` ?Ў[jrLWTdѠ<a[kזA~Ysttg;ʪ$?^֩Wd婨SE4Bv *jITZZ@M~w^nݺծ];WZ8ۛ7oFd׮]`"DbTUUF E$~@7b`.]ݻ]]݋/YǎsDMMNLL =7==d<X 6%ɢЃɞ;BvWXDTQlׯ@h-ŌXW^$~LrNMnnOI1FD<ƍKL$Elܸg Lf EWX׬ GZ1e0*|ħ:cj$/o#K:Xh6k׎XSJTTY 8G$ϣ;wtOoUI~Sϯ6SQ C݉IT }$%322]+V9G.] }){vǒEFF˟޵+̙L,wܹ $ _Mz*+<}tt GAa+W_}U콾D 5ԄߡA @ xڵ}7EUY4(O)8kj]eIn rovv@~1aPY:j<u D(IJ"56v,߽{{TUU}!¢ȷpB$8|p6m\r9sss "ajjʧAlc ]&? jhhڲ̙37m$+%`, ̎^8: : u~Lc`Orȟ֭}I;\ѧpaݶ-f7d=zz}r˖M1c4:1164쟗Ja(2,+AܣKPΝ#q=`UXE}M:ȢAyJ5yxmTYܶOSbb(e@ٳrį$?^֩W;??YՑBNH< - I*`&k`@Rq`ѣGfff^^^vvveee/\Hn۶ X;aKKˠgϞ]|YOO~ٲe3fUWWkjj2011144ӠH Hz 7IQQQFFF:::60U]]ٳ"x,D4T(2vXe$˧%$4|Rxʀjmm;wW "jBUUUz4h3q{}TPQQ\r.X=iѢd۷+zQ3LKd3L ,9|3qvvT5sǎe"$ ER,B,@AH4mDM5g?EM?>1~bf4^KDܹZփ,CRݭurr=+֭suQ!q\T "=ruikmə3,O 5ԊGrDňbAPD-DjlW666[nٳgNNk]!;QUݾ]y󒂂q*'ǎx|b1coLKAKU(??1WamM?/GOx5NQz,gLR4ϧk #fCQ?E 11ޯ wo ݺu]DB1 I(* ] R=8 ZXXL68W41e兣O_{NMnnO]?fFbIl]pFtImɈc77ksƁ%K& 򌉙̞kք`1yy+Y 7.&E|0ݻr%w ]v?V@*n D$Z}1(tNm۶}In0pidiDA[jMIFtiZ "ԩ#&iiN?lFbPJ :Zl /P S+ "[##R4(OVT ¦.KK͛XQ%?@4( "jPii)_$$[ 5vY݂2mEvű->~|1@k;a$_S>|M@S x=Umڴr%fc'XOk}g|SO%J ?ƯE>,255tdCMḱg ~P۶ IWT~rUUEEsACd4wmD~R .\nfm/&H#h¼-G55U+-w9˗,[6eƌѶH4Vry"~<ne5=g(2 ^^RH<>Qd_o̥lQ*VG{x`6(=1 I(ԪٳkAK].@2,i%'n}PʈT˗OKHVx51N[[Ν# L4H*BBBhu~ =dJH*kfWxM^Y LecgϊOjhEjc z3Ћˁ#GtѣܜqXz'ǎGb5Nld"6=d%b^jatOO{PbajY1dhLnn&$ ERN={J(YD].e0oCnfZc$WAt>nnVƍH<`̟v~.Id@'>h`0`9䗲d$63?nս{ųfy2tCVfAPD-U锑Pt-H9\gʳcڟ>֘ki##'Ez{;=^=SӁ}͂Z0K 744cc.](YI KZ|?eh͚Jk!+fAPD-DK666={LII-uʀ1??Y<1kA֭р _z6mZ'jp s続`c}@8G蔟ϖ-QɌ!a~ YIL4H&77 "jʥzGTIq`FF<˥fIn~{wv\]GOѲeSfmkkd߲;K5s4X]}TS{}fb 8 J S)kuӦATp\ût騮mׇk/>$d1YYqFFZut4qa>{V?\^՝Cy*X4 I(DTQQ!T^d,7aO&sXZEE>yrvx^q#NlTT[$B-^oJ&DUfG#W=buPG:Vd9M4H*@zq  LeR[FZ`\VAěDr2מ< ".'99r~Y^13y[l_ '55_QSknx1^ 6 Cd婨cKI@&$ ERIzd"$ɲ4%7kNRTݻyV L'܀I_{&ӥˋ_xq;[,/~QA\qNm2@я?eA1cP.{H(+7~l1rvbOQnajYy*X)RIBTeP@Z4G92 dYVB =#dwE?^EDJYdMLANdkݲq€W~U3+'/o#Wrݻ;n޹3ץC;}zRpGȁf ))!TԱR$  "jJJЈkT_D4H&eY iEИؒؿ]EDJưD m|S6CrG!O(Mmi1IOݽ[-X1=8xRpGȁ=ipժ0Yy*X)RIBTRsTNNN=r  Le%IY!yĞ_,"R2֭ *+sڴi tMR/s{Wss54Ԁa|Vo++7EY bGdƏ-;b@>|#YSQJᗒL4H*^EsoDWeŗL E1 [ i00;zo脂h!R2 1iɗ_fx3p-vyKg{|Vo++ύ"ӽȬX1]$1 <` 8Pc&sNjw"??bx')Cy*X)RIBT pB_ 68lM4W)QǘF ^7rӶ l!h]q|́`Q*͛YY/ѣjnVl /_>-!!;G^%M4H*XAUD4Q*]dF1/?hRR1[lٔ7Oa> "+yl kFZ'Sal8sϚc2ׇL4H?~{mG‚ҝg%ڷ~GťX4,1A[[3Fk>x0E$~5k2y !sYk_% +drh$QKU`19\ue-SoZ%;e'8&pzi`D[xq{˖h=zn+p݉"ܹX;{Xcc֭[aFظqa^]۶}zO?GCC={41bi'}6YV} 3E(ew ( 0 L4H*FbRQQS8]SKr:hm~nGlf,oEܑÊJZx[]P~O=~|ԩ=D޸q<]$` hDdQZDjkipD>׬ vmdA E"ye~(>* E oF& D$ZbQt-@&Ae՟1{b#gdψ Z+W j߾hqeKԻھ=';ٳ"4kLOpE?Fn?[o=~<_ W[X"AUUQ4JDJWWcO>KیiAAn`HkAѶEALah9FD3 BA`onAPD-ZRJˁLDo Ds #ob3,7m=ZY ;Z|tt4\EĉOյo^55,<WsMNm$7 "j-===t"P)92 _]x{ܶw}b9b+sA, ~M^ML X5lL:TVu꤂ti'p3g<G"-[LL::Ĉekk0tom׮ՠ̠ Hx;h$Hmϟɓwv636 ;VU;;ŋll>-SSYk~nݻܹ<=JMNͶ駽}YG/ иvm_&GVIB /q  LeA-Yso\_z-NqWNG P=:e˦X1>x <<p6fM8_Gb6 W_}.}pݺ,+MnX+.^ka+VZ>|x%^b~˧EFN*RUHƶk׎,|EFFV "j' Fѵ~8P={ 2 dYVB =#dwE?^EDJᄅy;czwժk !oҹs[ٌ,˹4ϞblLMzy9Fec/qVYLrlT)emJ23g2u&,"$ G/o" VЀWUTT@΂{_Dd2YxCukj548&$obi6mZ~=y}IiA_"/\:s'[=\6.1H G2pʙu3i҈rUeg'xxH={ltt'J$KYvNdDn#G֌a)g-AVu&,"$ GrѠ¯(kXX!As ])d2Y'yd{.~H4^IIIh׮-iɒI*xL0>~F\T ħ/nQ[qi㗣8Z2׍TG>ӧb_:ںu+lUUUԭ[S6"ٳO?f> uwF[{Py@SG2$ƶQ bM2Y$n9hZ(&LtdYVB ̎^8: : u~L/Pqv6 fscMlm ;1YYqjj^3y}g?\G2 s.qƗ.#kÈ],/̰۷/8x̝;Gih?!!X*U o ,~;пK@)sFV F" 6Y+mp ])J;c32\9Sy=?|x 4f>bo%A.=yCкKT\JbL}SSC~OQٳf|y QlV*d!Za$`2߆2ѕT~m駽ZjJ49gH{̿fkFD jAxv^"aڸzz},-~.l73yi2'>%_ #$%Htt4IE`et騮foot6con 5IdR+Eƅf5r ~<({h)SŲ ^^`Y^ tn]+Wr@Kv"~xիwlXy\vnT<eqpX| jƌR[I 9$3+SAL+h+#Oܠ6L4H&77+[7D%ϟk`}Y1hٽ{dgd4j~I%\^>`TѢ sZ[[{{#D/Ȱ3+loC666={LIIiD] Ws6*{\6ҥ99/FuNN!ďcw\AAn+clT<]|W <w)S<.sNIf.I,_ZTej_YEunh;1rhLnnVnT> =={V<}ZVk gF!E;v9h?bz?CzIFhUa,۷ 7o^"ȶazzڃ!?Y݆8Pt]\/'%ZvH<`ٳ[g\,lJmYY9k HUumm;h2۲%Dh}Ąz%'f^},<棏fرׅŬZȽ{㭭9:ZܻW̕ϙLV~+'^IDM q83J!ɲ4%7kNRR/]).i{9~< S>xɓ۪lHvkքWVhjv>*9ãKv7nx-zXϱmyyV/$C̼y>IIXY~6dyL4H6DRѕB&eY i0`玐ix=)ovfy9icVm{U,gKLa/1sd?T'^8 ::(.n*[n]̙YgLD$hɺnCār2,JH-ĖX,"R2Ͷm1Sd)S<6lXgKf\gҤ7.d1j׮9ȑ5#FXJACC? y^1H/++9+lh$55<}gSj?ΩFkm8$+L&7'yd{.~H4Z PUUԫW7zmڴ(,+=}?>ѱӧ:ںu+MML UbCY))!"0Xۻw[9+lh$5)ٿ8uHf b\56Dj(H$@[S#/N(Fz"%ٽtX,:dW_}xbm:, k#"|tu{#8wo߿'&06v*Ұpouu56=ݻEÇ[8: 󒒏9ɂzthȧq~,-8~?+?JsU@ػww |CnCā-\)d24ۥ;oZWs`)X]|yQlV*,ɍiAPDhr#J~8"U/[`*3ص>}>ׯ~PUUUJJ qHW LVyl }=~xرVVV^^^fffC!붶&&&Æ vvv6?~qRRV۷9s&¡FFF 3Ǎghh8rH{-¶(,Pwwwssy-+L&+Ddrs3 I(j"42|[D Tjկ #VÙwW>)eˢ p׮uu{]~ېs ޽{=<<uVv8\j۷oo޼]v}bŴ4'UUUkjj***ttqqAի#F v޽{սxbAAUx1QSSڂRdBL4H&77 &B2#'OWsu.، >*~n=#? ͥWWW37ٿ?IxeQ~'#VZ:8]~ې 8 \b s4x%MMܧOgw,YdddJJʓ'O"""{7np4dɒxҰ0(ĉLuuukttt222fW"]tD7b8rdͨQ QܡCcWVl:ܿOzܜ#7\n}̦ { Pu|C\l…o֞=+$Bά^#{sBxmPGɘ۷ }}]P];ZZ=duK`VVfDϳg*ϩ_ʅc }{̫^~XSJF4H&77 &Bϖkγ~v7*۽&ܘ_~b2鰗Eu쨂dXIIjT.zuΝKr6x`XSSQʒ͛7/555--ۛ$i0::z\q ?r%#4•{TT''޿?]{5~}7A^*p) N]r&*<{D#,%Bά?]dm=ݻ;n l4Ulqѣ^Z1f]Z<[ZZpӠ)D$ /UgGc>h_l\A~h kxMovp1虱E͘1DuVc5R+mH׮]؃m۶ "̙3{nCEII o…Hp6m\rܹs),,A?ԔO\__Lj^v~ipT6;';]^kAKLbAA*x& <hHnr~7qG>?~|bx';F\s ٢EL 嗼?{Q*=\ +A^^H& 9jH#3ȶ}v3gz>{Vޭ[꿇ᨩu@7 ^_ܬP0q57e:99 }CC Pj߾$n+;hC3,pQٳT᯿wŽeULeRA` |S'OV9;6v*8ɷhvStV+~SߐNY?haj ~ś*,\ C"1.vI私iE1(X-[6契oaq ӣG<<<̼ ^p:n۶ X;aKKˠgϞ]|YOO~ٲe3f̰dlabbbhhǧAnGt5'e`Q*&Ţ :zr&}|#=}I#g;#HTU;_ύ:EXcJ+VL3ƎY*=ܽ{=P{zqiFs k?8Jg7u nozkxL~s &E"+OI7d7~'JM:_ 6BRGDЃɞ;BvWXDdܴ%kքfb3>qS\\S>yr2"‡=y67nǠ˫n7XA ܾ}ѣ+?fJ/7**J2/]͟v~rˑ;Fٮ_bfѢ!ZϔRRB.]ک-0-772I>܂˒%gpI 8A>>ähfuPGI}` b3u(vsgKw&Y?YpRZx;9yv=g,\48Ƚ{w /Պԕ熬@q-55@.) q`.iAMbcS%Irʊ8Pհt~9 ͩWCC{CEH&z|7dh M4( [D )-ۥXDdt1NWd?v~zHƁ~ß~O^DgQT~ :+KJ֊liNɅE[_ ,-^7os׶V}MnhV-/^܎!YJ W _;|dA3(YԨȠ/ԍ؆ e `wE`RpY?Yfv?T嗼Z[,wo~߇_<ӠTjoR~MYeQy>2NTxM=GFN rpa;ܻor$'tV+~SW4#AD/MP nI3l%ٲ%Dh6OhWrlV$_l ۷ٳm׮ 4pBk~<~x'MXldZ+|8%%dԑ?khjj$X|\JaL⁆nV˿;u/L0PD4dMF+%0;zo脂h!R*ټy>9+0Jlv^S"wM>+z]3fFCơn ~һw?_.6ff:46Ŷ"qGewz>g ::UYs6:g% 8z…6~mᲒ,/"<"/o%$ SQdά''&2:]vġCH*R e "AG@Oc0~_!a~A030cc>QdStV+~SW4#^"ۊ-Fd*=}{#ŮG$f/OreO8|՝;Gj S'6ړd< n7|H#ň()iAٹ­Y=eb׸+UЕ+H.U͛zaQ.0xj׆]hNsݲKRd펬EF6@ɑJKv8>Rє|:/7&ҥkk3Dw+! Iٳ[XߧχK}Vݽ[1ݺsEEkޖ}|m޼SK%^ΏǕ3ڵ}̙LyttIu3gz;;.w/w`E^]"C~!ŋ5?!(bɘLff{hY܋yرRBf7%I>}r['MqBl[vNdDSSsV JI geKԌ& /??g-"&<i3bCS8:XY :vlHIjnC/''xQEE???DbH&Z0HioB&IF Q[ii}Ƚn<ܬL0P4?)/IJ'XVq˖Y^|n]-n'Q4vNďTQzu]q?hHkW_}]\ې߅VTT4NeE&ehLnnn0RӐ`mJ&hz!n|Z?EVX#ڵkez+U~]OM2U ײӜ+  #5U *D/7g~r"KgϞQuuu>}d/jiil2`UU7Օ<ʚPKۅoXA2~M4H&77 FjV"lmHrwg~.oĸ8gך999Ksa௽~}vnnر۷9XsNZ[Zd 3vrv6Y9ܭ[,+!Xo#``̙LVCC2G*CRQ'ke5LhLG B醑HDMJx{F/44ʕ+cbbd_t5'e`Q*Ua#pvK**2jX,(Hut4yOrڵGDZXXgie4Cē&^Y_Wk{=ׯ ƍs04?r K+ɏzu` p2D$hoC0{kʕ`EN[[?TQQA`r,J ̎^8: : u~Lsvm1hjvcl6o3` F@J \-\yqT]}d2^4Ow^Vn+ [Ͻ `ii"1 v 0c?}_USx/j:=}I#;Ltya]/n~;d%4 I("l~ېRM.Pqإ;oZWs`)X|Z+C˗OKHx'wQx#ɒVB%K&%&}21,Z䯮ut432K`ovɓ>nnVƍ.ĉO-{8l;|o˿=_y*ɏWF>d%4 I("l6T/ӸT2;/ZiGa,;)d)+! I3h`lԥK%Ӽ`ZZ{ qOu$}) :_Ϟ]矟+ O%1lY M4Hh,QMN_2,R>[ٿ7mڴ|\YEG-\;ÇW!+Wrn!8mj <ܛvnTï^4pVUO"`5Nxq'EW Le%Ay>i~𨳳jҤփ2C$Fm`XY]GOѲeSfn{B8mjΝۣ(}Oȯ밙nC"&Ph ÍJ4H&eYiiL&7Fmz1L3~6sm^`pc28,,,tuuqz-t2&$F%6U؜MzPWG#F5Ȱ$IZR +'^IA.l뭷YJW1@eeN˖hk}g<}Zk^ݵ+s۾=F 5{8&ᨨٳgHHH#׊:vcZ(iZZ)*D"7AEEEP. ((^R wTA*̾*+24Mo;={9of߼gfg7n,w- ( FchpĉFX_QD?VR/tt ﳨ(K0WJ w>Q;w2eoq%@ɢҳzzzjA޽;Z RD,$ATW ?ϖ#CSӧ[nyVZܾcbt6IË1l!Ѿ=?|_}<ہt;;3sKGz$wx'{{s ٰ\͚55dݹs=̺=5oܸ}v5JKNB! us6NM攒uժ鲷8 ٪0y{|ɢH)m̐K @?( ( kR.}K^<8'MzzA}:mݺ N) ?0T\fzi'$ h, أGw/Stڝ;;w.\LHXCB}搑I}8.uvFF5-;޽;xCV([ҥ4 U Lྉf~&*QZ|݆.BU@jH5ڂ'b,Hx-8D(v[ Դ+|x]pb\\4&-m#mL ^S'__#G<{'5Ő-\]m^}O?Sffss߇С5Ɲ!,ֹs[jYG_P, m2tx6;RD,$AT] 6~&<";D4wd6nQ޽;CM5jԐ鹸#,+)C ޸qYxL "ѣǎ" )5ӉM 75xBBD+[HjP 9MLLX &J@кBtp0ׯ'p˦5NN477.AHWqqH/W% ti{ʮrsUm8ioq_OX h ĸON@!"i6lE?z}B0wv{Ҙf޾P\9{0 wfi$ߒ%%SIOZi 1駻֐_3zI v}$1?pThVI8t qXY lHZ2]tpĘ~P-Eu٭Z*TA~M8Xqذgn`Y-Wĝ;{wT\5bFmAՠoJSaQaanA0Y7a[)o? C\b@H;~D׮ڷojt6g.{KM]~Ĥ94̙c`S'6)4$ҲG߾J HrENn8 IQOa=B?(:jA1=~;ekۧ It16p?xE =ژs^_O?tP˧0##~Ĉ'q2L >~|ƦOrrdiuvv :]~ŸG7hPuo?`ǎaYT:Փ'DqOjNA[PUd LT"?~*D]!嚪%£@i[@ PY144R7P@jk.3%ӟs ([UԴfkV?AZKOO? _F`͚v2OZ:Q#G*N5mڄ`"y ;LI[v@? A:)ub 011&sVa.(M,Gj(ۉw{Ԫѫ2;-W r.&\hoo_|yt6V4^H Og=7lVjAsw7YvJZЃg>II+8Ukܸqgώ,ZqejÒ9*WFFoΐj˼ׯ':EmA5CLvˁBMOBMH e8|`/ooE Dj0;!Cp9zzMD IphJJG e8aDXz|:8,,[X}eA01qY߾? -˗wtn8eX8Sƍ#,:ՍiBwl|_N6i2:EmAn4CLJ=acÃxO?l"A[z IO(H hQӦ3-&`58v={v41ҫW9s5p6Q< x&66}p\jda _1$AYj]3o$hRSS}||E 0&lSwFU[NFtaoErbQcI^-Y5ϯ D@[_c5C-{S ?tDYE0BG A@y@_c6Cl 0..NOO!hL A"Qjl7@skf(55АmA 瓠 5H$B *A3EϜHss#KƝBBK:p Dp!UH5^ٟD'~2.'!PAABkzG ЃJ$etrQjG_vg7 N) 梢,T_!".B 5FFɬfDOD NU@vt DYHj-2aP|$ fd>ҲNJpȤד';ۛ[Xo΃,#F < )늋 d-n5k:k;,Z[Ff Jxx8lU9\j:'\̬cرuaaBmm,_>? 66}`㺦Bsrr_:P#3:JA~|wD&AZjeWwcWoɋGo~f"ӧ7oٳ>;|sz)ufzBBN) Ct15,~_)SӮ /4,7^; aAA$juL7fUЇ8D^~ԚJ5xAraƯ.5KNBwBAg::Z2 ÇFT ojڴIU@TjϒPTf?M$j/GDT] =/`Asn!"i lYXO) ۛ_Ӌ!!^[ڼj~:7İf痢pڿ?۹y/_!TÇ`iJ|:WD}:wn#,ƍ#б,Zq𩑑Tp Pիgxk:76H h;hn3AP)5ixH>FT] 6~&<";D4cЂrcA跄NvjP Մjٳwx]cj[5A "WI5ZYd#og@ \9y@WIj@.$&&] PjظӍGD} u}8uXx׮P6YK#"ٳKߧ lqf:¹ÿoߪkvsz,Dnhl(-Oef 5~Oe ,Tqz,٫WG8oMl@Z+_(H0jMi O"R 5S5nڣphJJѽ{g820aH|O?mmmUL ZT[|[Nu2Ċwp0YT裏>`%8F#d&/)5%Prׂ@1TX 3MQ:Y©eK=y_{\^-֬ HL\C?.׮/L2ox\U(-w‰X>l/{D)SFT24#)ą"eￔKYA_(FHj-Mu*,*#,:# >)C 71Ar崙3ٙߊ۴y )[۞=;"o^y:u2|aQw[>~"&|p5l6|1)i;\K0Y_9Rѿ#4/okiBPs@(m@9Ad|Ҳ4[(xOGGK.]~e2 NHX8}(/^jaaE޾%;0}۷i&p @b5|')mݺ%3˻`7iF=:Ȋy3]jmp13BVF\&%?͇,Rq~8*Qgx㝌;1ŋS0H$VYqfG}aSӮ,& `]'ͺuAj%BDRmAV0l3QW ZEZ5=:f߾\"Y!:thojdiٛju%V%:r6G.,Lɀ }edlN([|@4̯]?v=" l6vz 0le Vy}wz }بQC|jc6?o?<- w7DU;U\MΝXYbN_jӋ-[AmV>L鍂 1چ IŪ$GSnZjң\+WvYTH.*JWaR7-sְ&_pj "\iN .No jpl}VގP3D >>>rׂ@IOo^Yw:(uAlr&5taa~ j7̚UzБ#k.xp/̀2ر5T !?$I0ũ^Jd[&K}@SӮ(ĉ8Y6m2I=zt}/_h)j|v\QɜM& GOOjZ[W>Lݖ=X;Ӱ۷DvJZ"<]l2[oSp+W!ݶ>HdY_}&uڂ}^իgԫۀw;͐BqVRPZ5z8 [[o?om90͔)#o_:3l~ `M@@Y=}zŋ}؄O >X>g;ǎyhN3%%Z B?@.nݺx˖/ _ CX ٵ+t1.SzVĤ.^V=8~];6<(-trw~a+߿ѽ!DtV+*W.P0j]5H P?1?Ǥkiƌ["NFOBܹo36jҭ[;ZP/?رc)a˧0S?|@<TQQ.m甫h"h.X2%h߾O?ۿ?Bj )Hځ˖M˽{7-ȉg%d#ĉ8`OhΊg)QȵmbN"Nz("W;=P0 E /<3lX(IZN3tV+*{_EIj- 5f@BCCiA 'o7LYN=FF ջwɰ!- ^~S`yd} ɑ[\rC/nLW(L7LY 8kx`ݻve:Jj%&.Sz[ʆ{o>XȶVZ$I /ng+rJCγZIPb푺amA%5CBGD xrX&_?ĿYWAg+k/|U/9NQviike\R7- 5T3D AA :r>qHEnL|nڱ*ΣGchdBB.KtS:EmA%A@ 'e!uR:KjĄtĉDYH0ԠΒ!(((044B8( F[ 8Yd lqgls89&{Q(,@A AWAjH ,~dl?B#wdVk ,@)]@jHZd?2aP|y3ҲǑ#kyǡYf?y;~}~A119FnnƩ||7<8ˬA=:ߠA}̺}I;۱c'@IY| 3 k(66}<<7&5H x4Ql'N$kZ jeWwcWoɋG-]: ;w2w\^P)UbBBCݝ>uLɠ4]}Рr#fM;!22-q2<|8jHUi& T&0G$BQ@OW58D ϹvmNGy,yO^ SHT\ VV"ȨP+WNcAAЇL X5ד`mj6&hhn{{jme/) y{;vVZ hr.k*͖KiɑF=;xKsIK,~SX ҥ-ƲIK5_H UG q87mCD Ӡ eݽզ[~aa~K>>rׂ@Ejo˕J CZ5Ӌ8,ᇣf"J˽?[_fpJ:lXg7K3VĊ~'"{{"h<ݣVtdQ-[{V~& GҡCk^U٩9OHՠoJSaQaanA0g-)> lNfׯ21oni3g3A>Yqq>4p6_Ec .Xll@L<~|aHhooU'N=d"44ƴ ,>Ç%.x@"Ƒ#kNu.,,]: >/\Ҳ˧̙G̺yy EK'ΝdPG{-Zݾ!ӋȈ1b.@25"ɑUʪץK)oMtZ %5Ν\Fڵ.c[jqޙ+Wvݺu~Ba[6 ?B]b k~t~1D5?dLGuq~ɩ{?(U…Xߋhܸ,;r?E8'>~P8OH8䠦 蝙Z;v, Ɨ+dXo6v}BB6H(SY|zbuк i?ֶ>Jww.ۗL>S·3hK/]rs߇lР~l q-͆/ah<VjP ~e2BazgTdjPŀi¶mL!QH39;\_ZN>!j}NjCF h&PRpnwrdɤg7;wns~=9O_WhDaw³P_AA02b@53+]ʦS2J :wfIcv*kWꄷj…Wmwi*o zpiW61jE7;xP#<5(b@4oa%'H-4h!޽3gNѽ'ԠRsD=@n4Tvvf?th5Cq [v{7O" GE ;4ԗu  ބ}LA}3+^0_̀R ))FqJe8aR;K+C iA\{wC~|1jECTZPׇg$m1x Nn1 {֭p`'0~*3 9G 2FWR:Ku>d999 B H$˥XM@ifEgr)?sf#J ˿qJci" )pA84VZ J*蓹 ? qd◂YCLHbEKK[˗EJ׬ ٳI^:Ιv*kO/Zl5r|}]Uv&7}tZF ٳݥ17C ݻä[ pDevvf#Gt,fms :ܵ+%Mi?!u|P=D"\jla)8F~A};Je9s^x~~UZ*O QuH|A3n;tz$W@T&y~.o٬S'ggkSҌmD*k[wR:Kyj4r_QvYK1 w?胎[Wv7hٟ3,U6tZQԠSs=D"\dWePI$Bh}'#5TC斚i::ZlWg&M-:th`~N4nRs\&M"QjECD=!A:2Bi"s6f)>}zVZܻwjjʕ]n/; fHZQ@O~5xx2ȿi8gls89;+/kCVfK+xfEffv --{<?(&f6⑌vCmlxx8gIj6[4pG iӧCBpuy?tوߢE7Γ&-l߾ddeۗfvmNh ME|{̞l]F Q9.V@&( !*}|%k\>V܆ODdħ2wX۩9OHԠˮ`yǮnߒE D$A0##ђmJ xvZj6z\7p o iЧD؎"6#<|8jH۩M $2ח*~z/PG NLHXvwmN=+^_|ld 3֭cΞ 췯2GYaB4(ȣo6GSs\&@ rG=Uݪ焤,dD{>0HÃ窪瞈ux 94y5>52ҟ D7 777[b\\`ZZGzr; N^h3X5 j7J{F}|gvƸ;#w-YRΩS7~"ϝ:m+N+4O;;3Ihg:vl}nK38& M6ow EL@VP'[?qƍ]:&M]VZEHUNaˎ\9x뜼o/*5t/6С>·9T299ŭ<6sC÷%02j%{o~mW?IDA 㪪 ?s"pHQ2_B5r4 (]C\\ ,W r@PiX5ד`H=qLbꠙY7==<ɽ~Is~LCq&aV 2'Ovyf:8;[/g{7V(LgOPeme*Ps\,A{צOϒzЭ[W_}544T9U[r[iQJ6M,v,XE'N1c8ߺuJ,55{íZj8qآE-flKk7mݺeem4WUu5&}rrܴJ')L#Ow[[sʾhF=˳0ó0wv{e*mG: /leR5BH r9.011Yx1=KAzrssS_Qsk%ΞuC | 78FR W?[oF>`9?(iN"Ǎ~|aH*"Pbb"qEjH$Kq-ψ#85_Ǒ₀7txaa5+u&4qGN7>;2d>=&a71 gGK36Խ; u8:4_]Сu-=۽q㗺ukSPw[@@хxH#߸qU._Pu;FpXv)szDR#RvmTa_Y[Ch*2m|&* pXerUGG؄ýӲw2 H rAmHLL a#T,zzz,pNN5+u]L;e ^: fj?}zMcܾ} =Sc!ɀMTZ!mdPSQiF8:ZrJA36tyjbcHEqq>服M2JauH2rΒQu'IL!~ӦMF;LI[v@:[w=}߾0 HK:@@cS, ,̾BYkT' ^/6zj70rqf9ōCڵgU~}>kookyFFqó84r4>a"iphի{WQOw#̦B"G f}q~)*׶6c@m'QlIH #}Pt_bB5ҝ*"ߦp=>tha?.+EeFر& go"- SrsGgFqʔSGpݲ%R.^R dcIХ>xp"+hNBjPg ftH$˥XC4Eϒڀ;/~FYڀtMN ll(%n9&kø_ExɒI?j;5lb-(0ٱcO  / PtH?wwߥLR6l_$20Y]qʭv377Bz躥K'"#l@0ᄄm- )RdOBfd㞰ͮbi"5ԜAOcM׎}V 0߾Nl H=KjCAA4>44T8PvŽ/ut|/=OIX銳|#i70x*_NS۷/i֬oHI8 rr6kFϞ_~ѣ1*@ٙ5i;8 gyÆWBUf7nر;Y8to5}FGxggk>.?r.ERe$8W?`ttUuj{Թ=5焤,dD,׍H>5&&&xz ===0 b JH>Tv z/si D1B)X|ih-n+cPDcQV-ڶ?uj]X_R}%jNBjPgLXM5Z(%$Ӣ{%i]۶kb 4ٙ! &m0Dj>C/[dRx5Sk̜9i&?q"Seտff`Tfo#$K 7%um_/bŊ͚5;w.ZFuukKڵӏ>uUUH jxԌzli#=N`Zb~GH"UH;df"C^y><˶Y| =))+^_}ݾ}I4yֶ7i=ZXjz=K~E/_ѷoF"="H)RwoÆ/w-Ҡ{P[\ܜ0gbTK8djwUbT1HzUN~ggg,gIɁ,.\/EJ8[E$\&7Et8jy;q3ώNKz$LbT ބruA8!a!t護ވ6]I}ta[~Er;jjh;DBP @8 lR SSog4mڤw'OEΝUFA'~s'O%i"" bD;+ؒ͋"#U^(κ; ?df|<8򎩼E(ӢK. 0td!=Kjp^(ġڶn* Q(j+j,dc\vo./kYPa6Qfa,*I.,L\EN8 S8dҽ{g>loQQ'X朖S ՠ(؇@9RQOs/}2. l4j"##?r ygyxvvf*/Yݺu19~U1HtUXv"Ohܕ`duUq Djj*PUM:M^}_m(n`唃rWs!4mH,_>5|F &۩+ر5RFFl.S֓"0u~=N>6mի2Ԡ9J{7K8St"Mf1lXժU޽;daSSyDXej%h!P kn* A@V59%)&m}=S2Tx=m3Fm -mݶdUr_n4tի{4/ Yޓ'.mCO?gg }d*/Al)y6%r]ۿaC?UyT"Z}9.]`C_(**ɑ" VH BuNf|%1'-J 7u瘬 |qVt $TˀL8lРTf3yskҬYo9zA **o^޽;#1t82RڵA0?tWÆ/nrÆ"U7Vd#{4a ^zQ;;sK;ѣ]+4m>zuleKc*oX!..GZTPkЙn`T1Ej@ V4[2Q&O#u$̴b ZZRFnչyAw }|y3ʪ8ysȻ&%pwwXdСVyy[wƎ6m$|>>qQQͨQ |GԠ1Y>|xvܸS3ҘDX4i8Jn*MP)^?f EAk=9a\:NRZMqmdܵ 8ua^GPKj8o8oݺr!>!:煢>}'Oϛ7iDByx8򉣢fnݺSN~N2Ǐ!*BdYt4חL,:wn̙cG;]uUiJ=Z 5Mjjj%h hJ 4ܵ)Ԓy3ul-~!V?xlH#:TL!vc6Ϙ1:3s}iyEEΊ::Zz{;4mH^pmY ҡG H,b CCCu@5ZRg ,_>%::˖M޷o%ҳ*`lޛȋ ㍉SS\%+*l5Rm+fw?ejl b^갫ҔzjAjH$Kq4MҞ5ZRL> JO.?t|Ϟz?!l^V{{s5x~q\GT|wfm7v̓gEyEE@7QIÇ}!{oe鶫ҔzA"X.54P[PTTNj[}udZAqUR6֐$Rs\,A+@Uj !ihfU_}u(?^@+9JSAFED"QӨ9.͵>>>OU8RjPͻRQl￟ey3}a&&]Μ(G#G*RÇώ7xT1c}](Zxҋ>}Tmv 㥕QyDQy؃g-?t쏁Qs\,AÑH Tj/ '(d?Дz`S`2*j&$yDbbfoڴyy[=<fvaH!@hݸq^uvm?Ǐw*(HZ>ȯ:irylNrRCΝ]v.%%ZQrRjzZ& :*7}Q/L^W_dU^o\UVFzDQyO~OOGcd tb RZ ʠn* :PsLH,b B&3 aުA͋DR6B$Qs\,AcJۗ ?_I@*rUAv-"X.54w.R),[E#5H2ߕRE$˥Xf AZjnnn`eA*rUABC3EDRs\,A3HA !JU8R*jPT/m&v,IMu]?ДzA=H$Gq Djjܵ  Er*P 5JjH$KR2CjA_GQQ[&M^uRA.PE&&&PRD"\$ک\ !w-e!''1c^A.PEҚD"QIjPI'] j )AnKjPv$h{ї@ hn HAj!l5 ))ri_A.PEUhlH$GR`;B#TBZ8%8띐1$TH rIj>>>rׂ&0/?ׄr# r*ByޤDb$5HP zv|3I]v$h*ީ/a;eD A ܵ nnn4Q Kہhe"/(UF *Nx0=%j#AqqqYm?iAZ]@.PhLQYD A CCCY$Ȏ8@sPܵ 2 UԠ,VG zz:uڮm[ƍ_Bp! GTɩ_~Ԇ _ѣRfr/.ίH'yAԴkTgp̙~~U؁*\_]4wʰ^{}" $5(w-j-eI52 ڄBNH^ kbdv}|Y hР b$AS~ghhHj@\&* Ԩ5E瞈ux 9ҔR5jPJ#f,CHwJL\Ő-WPիg{W 4RttNOgɂ=7lƔ۶׮ȑ5Ϟ山;l‰qq m)QQ3˸v FZZGՠȂP Ν. u B;cLE/~TmML645 tHCDJS h]+|zz:Il1"5xvBaD#;>$ wfi"?|xv Kk駻֐_3zI]z4*g,eq4S(I x$&&bEEEzzz׈Ar@Vij7%vwԩ0l7 RRjS"KP8AAQׯ216s;;Ǐ/ƍ#eOA >}z 6#1[{yۗL"ZxikwdzHS!޽3g;;[$$T2rcTNW;-!h֫`WBkU&t) GDß&N6b@UT.uܦ[v_jPӾGAZ5UB*/g7 NՇ r+Vq̠{{"PU#RNjPh j8?%% ;TƠsDG,\81!a}h<سhoPҥ¿8kUf|c8˼B4(ȣo6Gʘ:BAB \y>faCA@u嵵|fdCLl-iiSћGsܸh(GR tԚ4ɖ.\i*wߥmϡ(\MG$+M O@eimaYfY u떷nĂcWD)^^C^o )lSSΝ#RGP[\ HNy#fP.\XTlΜw7(2Xڭ -U~iTzc}&99 ~ ;ϷߦDDC'sIU>wcD:yw2:)W7 ς$ٳݥ17Cȑݻ,)iOZ׸Kl1>~ԩnCX!2O`O(*ʻwX(x@$kTMDvXoYiL! APq<[(hGO=Tt!rXjj65ܻw޽;{֤1 Yrjpcڳ:K=|8 1vi&A R¥;CxMxSpE>lݺ NY20wfz[ )%ɄZeT> ڃυ+?*H߬\#_PJo " !x ain&KiV# ھ}p駻ћrʇST:Q'N-11QZi)5FQW_43ֹsOO'tqp0_r̙cX{ְII+V'<.o٬S'ެdm4gE[PsϞpѡ~" (,,q?|$<"R&<|*Y7lFՆŠm}Ҕi4ty;thn7hl)1qAYc BSK zd@2|oD'H-Kk+=n˖6B0Ŀf0@[ B58|Rz-˗O$R /"5(fP3F >q"ƦFR ܼ/(b_-|) ԏӽ!βS҂>ǃ*DtV+^޽Өy\毩jr"QTC3AP9hLCτGdGÜ"R]̕+pP:·p!Ҕi4Ҙ+| "(>,J/- n}~=xoP~Բ*;#7j݋!a·j/Ez-aa~l!T 23׋Ԡ蛕{#LIo(5Xڭ }n0U~iTz=m]'s=|8ԴÇ%cR5(z8ZIuCUջS$5H$FRABeQPP 㖾61-Pr>>qHat(G7裏>vpRKSJWDEdg>'Aז_VD2lZizA_~9٤eA R~n3E7l.\8Wߜ!*`\oJXZ  S|Gy >j.ToVS*rޡl6C7o:.Q,`i/"%%˜zE)& [Z*n[Zw[Z/ݐ+)ʿ#|8ZI%0I  Gj](Dn:fD-XM6 R /M)_)Ȗ= @W{99:wn".ȑ!Jg"/},nPte?3nµ+6:;A4-ޔHxViik\B5JEȈYǧO/(tsV-pP1ʱc_`iBXĚ5={vD{8g;VKeA몲 3d< GD *2҇ST:QANW XI r EAA+wc LTP&FjhRYqXEk+BOjD!I  GjPYʸo>fN/:FҘ]{gWE\0r%sWPTVW@APLWp-%qIAQ܅4+VfK.=943rY|~9sls̹{g9~ԦMҮ^*tnNc])`%7͘[r ܴi֭;9Y?zmLRD4H" G4HVZ OQDE4XfqҲK'iNbMf뾔ϝ4ǐϜ+8mE@EC]F[E rDdezC"MDeYs玶eK9 >~|w]mlLp7(M/%UT-("{~oPZ2gdmkko'l7]Czi0:k p֩svGFҹ9A޽{uXƐH$=`7i0ݻ3/^ds xkҤG', ]=gm\/ayY J3._J};o& vCP"EA EKT{Υhw'QQJdVdvB 6u!3lX6m# oDbխ[ȑ5 C~-[6Q:>NqUei)AhF~cH$~hToů!#|tx߀6vf/;wU3 6l?fd1( ;۶moh~^)nn5ļzai̹?r鰨Ϝg?2CN x)=}7Y~,, 4cժU;xpYZv,?0j L8t/҃#|t7D"魈K%,323g6\y:gr__H˖M4SV7o&` ;Ng[ f|Dvv"eNDѰ0+N+W㏣1/^XMѸMEX_یNN<=g8wAz֩c4dH_4Z08:Z#Tn:wnSV l'A=42C2!Hz+Ԁ7ƈ0 S`ukTTTŏk.72"&%M;v=9/Yi^YΘ_'9"+߽hPq׮X Ҙ4mn-1{X敀c&o6.u"4,1+gk) ޼cl\kv8]CC#r B..=svŋiժUt01i#K\8TP*$CңhAIy"$zai0(5.nG/cŷ >~НQ,1O?D~<ݣG'jժ1hPO ?Wwߋ33k-AWFdFF<'7Cliw07ӱcːŹkL&'{>E >xp7cS?nk]]>vPD$!,̧~}c`AA1AMph͚u`ו+{?>Pd:DLTdiPCF 4"G .ŹkL׮09qb-꯿N QŽ=zY6@o̬CIգth#0a+8kFC{A;hPO__W^=+Zx?(E8_9W/O;>>νz H!AII ?фcbs`=O)ANIJj)K\6ozy&b7ߤuȨߠ1r@|HG1CP >>׌LLTd3jCO qo{ 85wJE3 "|2VyÇWrEF/6m4}R}ˌi3oX[6E Dk=99Iζ]|ŏ?rk֬sEz[۷_0XV^-gOg@VqmA2D4H" " ®9{.;9#Fw#Hճu$h#$+mڴի:lߘwLK?\kHaњ< FG̘r С,fe˦ef.qڙ ,[&h022x,wo7H"UI$^pTvCK}9jtQ=ԍ_}kkSyy9 n{RE4 y%r`tAt̑t4%Y,A0ݽ=/)iz4{e2Q…qqX|IʐA &~hk?|x }t=rC O* W^-46xx!] T2\Zujx&- WD$: rDd2_3~c3b׎ˍˉωB~M"iDk?xpmfC]wvh=j@`H"za|^d,[&hNzz:>>Ψ_D"U |.QY;~ۣߝGE)Ymg yS_2j)(XէO׺uiNNU:UJKv"/oŁPܲe5s)m呞8 $I3[}0Rn]pcׇ)>lyh`&\hB||q :3ֿ~XCD!sE= ~aQɝ92] 6e?O@4IO_-# \FF5;vln5kzIZ5n)yϞiUd,sJTJnʕ"2ښ ]\zhDs rDdecf.a+L PA1=PH$=!Ҡoʴm*ZsGC;/ΉޠpѠY5kC&3:ըQYFKN!|]b[;a?OE∈֭# z(NX]KjQC"1®S։w]k٪ A''keQÝ;sG G?6lߪUڵkwrhxR6R=D$h#$ޮ^i&ݶ~cH$R2Dt^cf4ۛW6e}ڸԉOr ҰČW3Ɲ7s@M];t()4t8[B H:u l1RnnϞM޽={/…ոq`jdo_ϙ&Je[xA۷[^ `u<8Ԋ3^~̥{{;!ƍ ޶-Z۬-zx!<Ŵjժ :~| ]Icĉ^nll{I$= G4H=zAmT -ݻE8/;R|o3 B2jM]eK/=o^+T4) Oؽ{1zxMԬY{kԨ {eӰ V ]Y.c2mnm2T))x2AzXUeٓqq8Wgn_~Ν|Ni-{!|zK)+ ]ى;wlҥuޘcfq}UecD FI$Aiy@#;?{- H?5rde#EA@z  FF#21iܥKGNB[""@\XQ(υ,$$LAe+m![fmYlBܼ9-["r"̲yV}֭2r'ohP*3\C*͊*w*m-e 4. 3$So D@"  _?ޣhOvVGOZ3%i@ "zY&[z"Naj4gNNnUCNuibb''aj";ÇǤ$T簛`lqm2Tk׆#2##S=rkCCcfU-ALBV{رweܹ{ffKKZ\1_MRݹaO|ewomȐ8ORSbs@-Sg[9 TӞMJ<93|:qK7n,_~= d ~=ߵ[Doę3r䀱cN\8\c  ڵ3ٲ%6FD=^uU{_liW~uvTemƐH$}!sEmg۽&pnFԥW|FBʑ+)h37߬Mܺu.7w9frܵ+@G!yd2 0ĉ\o_'$b5gkkbɨRS6 ѣs^ފ>}֯o;}AF@5lՏblQ5͛*v98Xw,Mpn͚u+WhOZ\1_MRMbI<8Wg0so0=.\؉wu9{6uŊ8/]Jg+ U3;Q<řob/A5&#%:pA ŋ k6FD=^uUp#O9A2mڴiD"1" BQ8;0" $6{`/RHPRt) "\T\T͛r S7+NƵk֬an1ܹQMD85Pڷ Sm2T99I]]uo6[V xԨQ޾;z44**=jc>ldqoXi~~OSA{Ծ ($ĉb'y޽A/؅ -/=bp 4g @Ç;׳p ADwѢ |-fhpggѣ@\8DD.=(aBdv1ǫjIc[[=:Ө ȴM6]zUmxL +آI ®9{.;9#F$RiU+<'WP SV8ܹ-S?p6ONw- .d׮  @JOqvw]3gsg z5>>4;;q֬Qx^&~u__|޽kr/\A1 iūkD=^uUbbo0_UUW~uًn3=s蝵G_QHeݻÆ>c9r@H÷QB/vtMׯg!2s"$ԉh#$6mtU]R̀'[ojrs#p޽A/l.\wo<#F8kE`'__wׯgx ADwѢ |-fhpggѣ@\yr/\zP…4⥍QcdW]1ƶfIU YU^iddddd/d840eժsΝے8gaR`jBxp X igw>5s;w 8k(i<_/&Z߽{׮ _$45F c117l:xk@WD4 iitoLf@׻w 7|݃?2r䀐OOoݣ._h_Bdx߄ ^aa>۷o7vյTt2##^C|-|3~"^9lXʨС#OoK]_NZoe&|$̾ťGQz4hڴ۷G G4H" dʶ*{L'VW,'E ڙt򯿊uiP\믇mْR(wQi-22ɓ 5kt^A`LxVd{@'bėT65muvto_iDJ7ި7co9ˑH?`HbKNowb*#*Iwju(z $^d vvg; ?. } 4ݸq_{ǧ}4!a Ze~}ɓ .q00 j߻޽99I 5[0xڴd8ܹx_Twۀ.#G>-vȐcƸFiH#A W/syE7<8H=MWUGԂ4(' ,+Ai]ȩhyѢ ::ӈ Oy5b.\~l4xܖ>9RpIAhD*ݷ63I`S88iE46pv~@bAY믾INéIógS xD9Xj`74=jB'ʕ= B 84mZ<6by५֪Amjٳ'niPZKpoC?hАdіlT=A_,H8{nQ^.bd}KD|  vi Iϥ: T N?cZZMD 0D`Æ$h0:z,gar ) Vœ' {5_~9tWDDВ%,;-bwP{^=cܹ-h1cGdga7ާN-VF`A`q yMc=ǙiPWJj-W^/YF[֦ŋ'*< J~JkDW~Ѡao`w/foHKcx1ł=ͽzK%]rҌ˗oۼ9BvpB] Io: T 90 :H?:MD 4E֦hDZaa>V_PY {X 4(߸iqN^aYT:vl6HaSYXt >A Zؘ~GBy3bTTJ.72_le%KwmނAiѠ4D_?KÍi|)h.V_9!S\_Ó|@j:Ԧ]b_=Tv-uh`Dgϊ22q?sfl N?<@||9ҿXٳŋi0h&`Rwd3>zt";;{ٵ'%ceiqT6Rp9RwA"U3b׎ˍˉωB~M"i48̞䳳n+L YV-&'/֭=AIy<8ֶm tÇ\]{!4޾Ii#cƸf}T TXu|ũP I"cbXEF'ONߑNZЫ9 9s Q]"?bëC?h& moiӪU3d(_,'%M;v=9`].9i]bHHeK$jJ=5KcHz. ShD*!)!k ,D:NuS1-J1iݺ[:oR׶?Z:opU ߬Y?,ݥMyh MsRevL|}]?>%~)zWSSrr M+r{^ܶ-Z)Z!TRpY92~I 45s [a $Nիg=e632uԔ);v/K1ӛ D*Y.r#OtF"I$b71AT3\V@GΟ >(VHwNEˋM WWR=ZkgXrb%-uk;g:NVF#dfRgEy4xjBfBZ"#/bpj4Xڵ3 TWR}֭[iNNR6M/I,=}>\.paGl{ȇ4R{^ފ>ܘ8L/ 4_]s$&"ix" D4ȏNaa>`O c:<&f&w~>"/2gafgם!SntiacCQaa>V&Bײ%&-_ (c)~e^Aƍ*<8ֶm F)kT#d _I"cbXEFo$w֪Amjzz:esS(GL)oL`!)>` }4ٟf;ׯgK~޷or~u /7pfg'b~+0p0dQ-BIУG'j6TZ)fzS#,{X]+2M>m\D'9iXbqm _ŋiժUt/\؉?>/WcQM~0'Xplj  prV~ C6 l`aANbniO`tX9p`O6VhJHLX3g6b`nDV`ӠA]){\cYd@RpnBGVʪo/2C]SBEX6u/0Eeb O(R`H3f|2+Az"V6hphӠB]H._`Ә͛#4#u4]f8X٬Y#< &0Z9=^p m&J+LocDee{eG r]8AXF qrӃ0|ԬY\Fŀ_~Ν<,-;? $jŤM!l4D.T7@h`$V, 枯}ZR^dAJ2owede%O0eKt$Rvu=1HG:Ahjv7w‹,*mgdU).=Am|2ED-Yښ484Ҡ:B]H^m-DC9Rg?+WΘ8qp\fgםݍd1sc~"EN,'nHb712yu?>nP(LF٬',щU1CoouV.u+m4%FA\ouN5V2[V*@MV, FG3ոq,K#[l/^LSGrn@ml\ŰQQ!,Wfvm'[l dSDN^.:wP wѢE;]V?lO41q6bONa~ƥMjb9n(gUe*<_@'4O&v4zGSMղA_Hc`&#:0?9{_RtQ-`nHb712*(5.nG_<1iǼ o}toD;X✜ѣ~!mON"̬4mL59N D4ȿ5'[lVH}nrY<~f᳠O ?>{H;S=l0F^! ]0…kq2K1åh=&?,3}˖H?AiӁڸ+P̕b7Տ_Sbʟ>c+{5kꫯ ښ5W"[:RZƄJ=` ji(ի{1484@|ͮw{wbCw曘4P}t ƜSymM `&Mb P O~>N;II1ӛ`Idv uw#!`}~;vlxĄ)PxdoF,Zխ[~}cTV w>'N, C{+ ʖ&0v?g.@AStaa>H`vLaQH89lԨ݋/[/_t: =O(Gyy+0";){\DebK@[ kjժ=ztelj^@t)\Vx?nڴQtXFelmxN3CJo a_2Yj%qLP05iܸy,ˤITw:qdEZG7ٞ=qj +Z^+V3~.䤤ⰫSU>GM|)e#e-Ire HRdˆI7{lΡ:=zG/c$۶Ek(Gi+pk֬ή; ,F x<{&E!xy|I1ӛ`?|#>`LlN>l keظv͚5bjoIܹQM?A'ԩcP" r'YFո2Ѡli C|||(-ZI- \S WsGpffٝ=S=z1zbɿݥK8;L",3\:umP|$av {@_~9 -0]T~t_e`0& ))._?|ȇm2 Kˎ0_?؆y "AuHӗ[~y*w]ULV֭/wzW|ѣ3.I\|0l"ZNo9agǂ>tR+rL<_@'4i͜b>̡un/%4x"U3) K@9{.;9#F$ K.E]iA={Vl H}ø竘de%>~| ukϞa-<`M& KdTWiz"l^=ҥMӦ23o9۶E_׶6}z FҦlmۂ=w|Iͫ(A  OB Z \6R=`e HR|2llL!~|3tiC$ ހH!LocDՙsEיִ?R_|Z?@AD% {epJ),Ld]ҿ o:ts!=oeFJM ;^P4uDVOa%gFF5ycժU?ދ{ƍ '7ߤAq}vGGuLM[qϗe<ݿ_FJHGDUyH$KhD+)fzS#$FD% TRRp*Z3;T>U[F!caׅ_0J*e/Ա]Ad23ߟ=m[4{W~كSS`>{V4P]p\tp`j& /]Jǡ kkS@&n@+Nܩϛի{N SLLiDGEI07H))rVy8'xbHJ NޔLjI$RRp)w @[t^=cgϊM`nno8ȩ֭[GX[2ZfTW)rpx#NNg;+poyz:ۀ(~}cVwF]տj`nJ11ݹ3Ջ| 'N㏣QҴi}UVcSFʶ.{V ;1*\v jHSQui%ѣww-ktw}{hoA*l&IK HꤘMyhD", 2ppbTwp4 FYRr4n/Z4 T׮bbƳ@*y  NޔLjI$RRpn#wP!|}TvUРæM=z) # 5L%1/A1©on>>ذe,ttl"AƓ'{44dH1czTƧf?t(iP޽[ׯggdmkko <~| {캣 Kx8ASN4kϞjALo WHRr4&jD4H"b71AT3\@gʒҝ:0̋Jݷ63I`S =}szZj@#G`{]\z8TplޟEfG`%ݻ|y۷6oPΞ=qkH޺kl\MMJ.3P͚5bH [q̹^$UI$uRܾ[xiu˄իjf _yH];+Utrdoپ-CWW)LocD;w=<켼G>q8!CRSbs~,Κ5 ?KTl46))TόVVƍ ˗_np(l_w֭=*Q<6r䀱cN~ _Oi-|1 j񪫚؃ǜmbOI1% t_o${Lڴ陳UOl"Rf(6Ȩ&G|s vm?޽94ȧf& $61<4PR;uzvZlܧO`6h?N& 1&w(Q-}zG2" dyFio9 ]]{ fԒ۷vmwjmrɺe%_Lu;_6GMpa{0Ƞ= KUbWW)LocDI!Ƀ];!aճYX F2x&x͚e~;4`pDž ;.gϦX1?ϗ.B\jfVV" Dob/A5&#%:pA ZQcdW]ŋ'#ON9<)fΠUy硺#8#~ܨ( RȄYf~AAC?8}ښ{|0zX۶-0iA>40t/^1m믓Hњ9w YF`<;:NF xㄵ ^d3"/2T5+I$P1ds$oOٍջy3GTKCQ<4}eGkkxH|YFUɹbȄ-LKU׀=~]-7k+]RW 1 #LMMvEڃΟ(-Aԇ|۷]QpKW~`kayy+MPMnrNuzL\WléϞg`@N.?|~= ?Հ+\( l;z.ql`yٴn֭\wTZc|yI,'fIK$'TؤIC1uTTHu1@FvPZ,V?f{>Lo{{jVa [2 EWۥ}·SKJ۪UO 1zJqK:wn ;SDi >d]xN[J:ӈ+^ SV8ܹ-S?p6ONw- .d׮   Hɓ>>쥎3eBGDެY|L&Z߽{׮ _b WQ'#{FČǐ:*V.~c~(UYK:Ahjv7^L0Rar' mh; $u'fI `akFr@IF+EG5l3Ų] -'x; mRI@W^yKNocM[`ɽ+Ap&>iR풺v4=ޤ3fGGkL{]!}fx1M+ubDw 7|#.\9r@H÷QB/_B$. |onnkǩ! p)v޾0cǖx@kᛁa 4;LJNx!u$O 1%c:\Z,;i|TT') i &6y;~2e ¬fϞ8`ÇŷJW1K'|;.mKfzBJ%]״i!^[J:ӈI$RRpYGHg.U5k?`h/75u,,LaE)E>@C{mRON’E"N?dJ ٣PJ:` jI$)l.72 ":F>)ommz^"Q&%MNlo9yH,=>%ؘ~GhSXYu)3g6v60%e4OvJwI]^ ,M_Z Cu1{vv[J:ӈI$RRp+9RZ<\7yAtTΜ.+JHO,lbqaa>RON’E"Nccǣ%ﵒC$)XzBd0 #[n`! MYJ#-Yڹsҥԩ#x?-T\;@ϞԱOjAh`يvLSQ[&~EZjlѢ ,OvJwI]^ ,M_Z C𓄣ϟ:[J:ӈI$RRp+9RCl†h/ՌPȑXIW''W)h#sc1y|5 He O ȀtN@ W[&E*3) HRW4(r{|oH2ҠȑXIW''Ysb4x?8 \ +<_@?4ȕ䓩B$\} ҭ[gSfeR˫rJ1ӛ D*Y.uE"GJr`۶ƍqNۓExM"U<9Ҡȟ>&{oPA!,AIMy_4HFFFt8NUTӔ /_~'qXcM6rhiʴXkkS[[3s~ϞUlKP>xm]ulehDR'LocD$d)fΠe4pp,]:4طo'ONsN5kt^A@KLxXhjxCVݷaQQ! >xPco0wvEfhUvv" ~1 x۝;]u&ITW~$H%K1% twLK?\kHa P H@ ֭1 s6<97`kˁP͝;zժ63]TҰ0pԩuҼ4idf.qCiڙHqVΝ1G5l3Ģ՜X豱.ʕ3uMӣvvf/qs]uA_8H$=b71AT3\@gЪz|%r`tAt̑t4~43~`a9]3?9y {e& zt15muf4oرЁʱckP6ɓҼ4i㵤O Q.^<14t4kxƒ՜X|c1aa>@ʨ+M 0S=USxLW^U3֐EI8XR H:VӠIi3g4 D0֭Qlւ QM#b)D@_|woslz{;Xt@FŏJ.G߇pRcؓS=)MЯ%)}i$i^mEeȈ6eOTb:j@4Qx˖ab6 O?[`~jco5|5XpJu5U^LLZl¿zeohRpmGU3){][ͳja}*H$nhРU4kvt\nT\NT|Nk)L1W^!Mjokk cm۶t)Ҳcv&.˗ww<&Mzp*w,իa37L{mOҼ@B/2O^d8{;A]:uO>DGXٳ0? y3 ꔙS[jvAu_:֠/R]MLILBp޾k+m]e={,Ź:mHlӘ|,)B}.#"HboBVVy'q}kJȚ (͛9ii|_'[n~V/J&HZa7*)D>$AWl3ސv-jB'+W[Dvl+; HG"*U.Hz( 45s t/4N66ճuK'M)Swx_!i)=AɤO&) V\zf!%L[&#:ԞWϘϝB>mFii֦8-<]6tgQM ѣ嗋K\^-(XQe-C5dL"U3\ tE$AKOh|2qZd ~}c|oHwI;SBG԰,DcIV1O޿Ilk/%%F,OZԽ[*d%cʤ&-A $LdNMU2߹f!%La 5uQʻ:Ӵ+"Oٍ*RS9LR*|#VZ egD4 ^e'Yfىu~L}YӧXZv6ݿ?Axi%c꥘&-A $Ld[СeV0cFi3ސvHJcI ʽ?iB4;|crvTJea) ^W+-Dچ={<=8 Ƶ4=U˗1N};oD6kֈ5s=/o7z8!CJ/mpuD"U3\Vw;1t~HʻpJ{5O&^U򨊯iP~p3z[Æ9TJe{4(}#VZ wo{Wu ^m-Dz{w,ٜ9˖MFoDDZ I* d6A?4ȑOL/NgG4ᴡAm&ݽoBCTLn"m֣Gg) 7=:0*B?6{_Rt oFEYaAK2e I+$J4ᴡAmȈ6e@ GL*GRѠive7~PڵD4(|U ҳK&&٤IÇ5ћ!oEfiIQK2e_I  N4ᴡAm, ܹMnti3uy5*z- J ᯿Nzz:e㌪ SԽh/#1۶E#ഐgdE!~hU̥ڼ5+L%cE%$hDR'pZz)GU㈩ ^2& d6]_BG%"N{1bjy۷ܹ-%]Wov&Bز-m69S=: $I$u }qT4X/HڈK2e[_˼-'X]V{1R4xv^׮]M.Eq`]Ƶ.Jl6Y5kHH"$ԉ7\V'H/h$Si_Vby.+\_O?k(З} N2Ӑ!}njqws=lX?c:2 ٳo`}/+\3ǹ˗w#ce<7B d'Q=VV `3.whDR'pD$IpIl ([0bIE>ζ@>𧭭 Et-,:|0[o5A(hÆ&xa/UyWg(Lڵ]m^{͈%ȷPZlv) ޹Ϡh^ N4I$6LVw˿h=!N~XFwx:";1w҅p`R-1qjNocY[.A= ,(X%ȷPZlvmhPZ/I$u G4H" dʶ[eo4(~XFwx:RdK(Aaa>V͔:mo2e س'¢Ç4  f 2 3-V!}߾%< eiPZ/ /jII֭QŗLRhz H$mD%<+[ᓢJefih[~[NN؋mlL?# 4mU:)&3;uz;(hK,|R ۺ5Jo H6p`OzeiPZ/ P G4H" dʶ[eoEJOK ׹׿ϞOjAh`يvLNZB/2ۿ5c4p^Q1Ggzy9JiPZѠ>\ML%dbU[ZvKUH7&vB?Oe{۴iۻʼm5nlk?%eC4L(D+TҼ.2@B}j&)YM;M3Lmu٬I뾞\^30=ϔTI[$}G7j$I;rI8~v"=Knw(@0p`9ǂo9uj/ވ I;j7֨0[_ӓ*ɾt~HFP $i\. gw;]C.b(@0@ԠLc2)pWC).Ԡ)Q٘@/80[TI[$}G73{o "|-j&}?2gaGqƧ/oxvY#ǯxggae gK}jupRkܶ_qO[[Cz8 g#>hfvBϭ&jeBbb"f?`ixOja;**Tw4h%l jNN&|N8RnC .PjHlL“:GwzR%ٗnWވk/_y޹S{4@˰Ԡe TngɅ g/Ԡ:+먺CG ,'>sݠT(|S|#fӾՔ ?f4UU+0t |ɷ[Z}4p6I3@ԠLuuE&]E0IWfc /y)J/ݲ߯ ;ҽ6`Qz$KKTj#o;2vll'uQ^HXAukRDڄ,ٿ̣0mZޯIQ q&hU%ӿv,zɥ jݵ52e @IuP?Y/PG OnT*iRuT**\7h5F\Y|Tp GBٷo5$ࢄ@iiN\諸"޼)=9yelΜ٧,/_4cF|hήT6y&8*Ay)j^W$4%zTmm 7t#@ݿ_~+zDp?PWWYTreg%u5(3Aӕu4v16جBuVS}2);{۷R/رZX0+k( s$ A (5HE7Žk\l$'^p|"0<<>t~gz/j쨈**Q4]#Ԡ1.YR} -zFƨd$fw)S^sKJ5:q@ xQ W_Qel9bDp^nkmez Euc+z9n\_ٷo5ޫ?WV.2$w7FGU.h%l%LA"aG ډZ$G5xt9n{DD/qMz?=.. >?>z/!.rbx ܯ"Mi}dd3g~HbIQ+de}w3&1yܕ--9;v5ET+flYL{;faTVG 35e1]Y]dzgUQ贌q={c00I*\7h5.   ɹOi0}`[Mw5t23'y2^n.h%l%LA"a3~8U3靐j_SSq.ΣG > rI8W^^SUEE:d(ٕI5HV{#Wio-JveR ވk\}$NJ.q%wDž+JveR A$%l\I]bz)QJ]T$iE7j$I;rI8WRqתة^JT/i*9뻒dW& IZ$I\ƕTܵ*v {U*JvevR5hrTnKKuϞƖ*k3+s75`926M%[U2!8Y͊C}1f,vTT}(5ˌ?Η<Zҭ/ SrezoMK)/_$$tԾjo(=4[hhvGyÛ G'{#IC.NJ*lɧ%CɮQoK/_o35!陓[i#L6(2%Ϫbb"'G&5m++waٽxԨ;D֖-a=AE[ ڗYA vv]QQNtt_+;?!.Y!Jpp+7wjKN]@UrI8(`>BZ6z>$=s6 0 3bc#SV"jP=mRþ;lnޠB%УU(ݚ˕%svp+7Gj*ف$yp6I3@?_K|΢0c=9 /z ~aEI >ec 7?t@eW_0q1"" 8]Vitk PORR r5 w:W̙wv:j_'ʋ++a}Ν(;8a_ >f|N_39y0>jj Һ{:cFرf^VN T%K.A5H:gܲ^>!2' w/V).79OxR0#"zIMO"je1tZFƸ=L*Vitkؓ7 {jk={]5'E s`F;ڛ&ʻq:pEWtoM58a'TW 45(-] cI^~y1`W*m&CZ_a$yp6I3p X-`ՊPό0qϚBL;ģG NpEFQ^PXiDD̜;ܹT:yhgѢ[{1$yp6I3 ^ߧEX}?!MrQ]gj.WV\\|tv+7Ž{W4\dS^b?쯫+*:5٨ .zzY%%A@UrI8Thj$to5{mڜO$%vۼJw޽g lՃJe0,'EJ\. g+`R ;j0zoV׻Ի1zCv|+Æ$%-+zPiJJ̙wCfeMYd!T%K.At0IҊto,2)/eKֆWzxyٓBxJ\. gjVbb">Rn?xli3RUR֐>ۃagȸ>$<}y[U2!8YϿ݋}1fAvTT@.mxcUƲO?=;%%e%c^?^# ֬{pRk&k`nhUcZc|S|6}^GΙ3aܸS&CJ5`VZ `A:RZOto Ivp6^Ёk@Pv=sfT$Ͷm/N/.n8$$~RIAb,;}Qj]S</$ܩS{e¶YZ]]t^~e-dH+[3mZJy"#nU{Da*ueQ~l={Zڥ**͛oNN,X 8I$I\Άoҷn؀2ijZ#S LI쳪oLj%,, WV.5ee4fQ7OiVl\+Q .ں =}\PntԾlOBq 5حuEE9}|KZZdI9ZOto Ivp6럏ee%|^V  Ȍo>A:5Y7a؝Q 67oP!P_F&N)@ .fuk.W|RRWνwg=MQJ &8PSرZfeMھ}u||?̰`b-'iDfZҽT$I!KٰQk>}YflW]Py/<([SSLK̴䌻#0 AN_^*Wo)Vw" C<~?ѭgb#niazuG*+^ddkl|05.L m*fZb%g NA] .q4D5<<1Bk~ w<..J> |sw:ۡ /fӦ+V< EH[[3- fZrA]A 5m+(h,ȦNc]wnn0}6u@LKiTAA5H:{MS5?)7_NS3?ןY8]03-9Lp  A 5YrtY\]k]!;M{,mԨ ?}뮻nui)wG`S@AtuP fA0ڰw]`/}t̴̴jPP A `sj e liI'3-y$ՠ$ A (5HEAA5HA>I~5ⓤM^#0)   NDAA5HAA\-P Tj  Z$; AAq@5Hv"R A  j_r;AAAtEP AAAtEP AAAtE java-design-patterns-1.16.0/reactor/etc/reactor.urm.puml000066400000000000000000000122671312550536300232120ustar00rootroot00000000000000@startuml left to right direction package com.iluwatar.reactor.framework { abstract class AbstractNioChannel { - channel : SelectableChannel - channelToPendingWrites : Map> - handler : ChannelHandler - reactor : NioReactor + AbstractNioChannel(handler : ChannelHandler, channel : SelectableChannel) + bind() {abstract} # doWrite(Object, SelectionKey) {abstract} ~ flush(key : SelectionKey) + getHandler() : ChannelHandler + getInterestedOps() : int {abstract} + getJavaChannel() : SelectableChannel + read(SelectionKey) : Object {abstract} ~ setReactor(reactor : NioReactor) + write(data : Object, key : SelectionKey) } interface ChannelHandler { + handleChannelRead(AbstractNioChannel, Object, SelectionKey) {abstract} } interface Dispatcher { + onChannelReadEvent(AbstractNioChannel, Object, SelectionKey) {abstract} + stop() {abstract} } class NioDatagramChannel { - LOGGER : Logger {static} - port : int + NioDatagramChannel(port : int, handler : ChannelHandler) + bind() # doWrite(pendingWrite : Object, key : SelectionKey) + getInterestedOps() : int + getJavaChannel() : DatagramChannel + read(key : SelectionKey) : DatagramPacket + write(data : Object, key : SelectionKey) } class DatagramPacket { - data : ByteBuffer - receiver : SocketAddress - sender : SocketAddress + DatagramPacket(data : ByteBuffer) + getData() : ByteBuffer + getReceiver() : SocketAddress + getSender() : SocketAddress + setReceiver(receiver : SocketAddress) + setSender(sender : SocketAddress) } class NioReactor { - LOGGER : Logger {static} - dispatcher : Dispatcher - pendingCommands : Queue - reactorMain : ExecutorService - selector : Selector + NioReactor(dispatcher : Dispatcher) + changeOps(key : SelectionKey, interestedOps : int) - dispatchReadEvent(key : SelectionKey, readObject : Object) - eventLoop() - onChannelAcceptable(key : SelectionKey) - onChannelReadable(key : SelectionKey) - onChannelWritable(key : SelectionKey) {static} - processKey(key : SelectionKey) - processPendingCommands() + registerChannel(channel : AbstractNioChannel) : NioReactor + start() + stop() } ~class ChangeKeyOpsCommand { - interestedOps : int - key : SelectionKey + ChangeKeyOpsCommand(this$0 : SelectionKey, key : int) + run() + toString() : String } class NioServerSocketChannel { - LOGGER : Logger {static} - port : int + NioServerSocketChannel(port : int, handler : ChannelHandler) + bind() # doWrite(pendingWrite : Object, key : SelectionKey) + getInterestedOps() : int + getJavaChannel() : ServerSocketChannel + read(key : SelectionKey) : ByteBuffer } class SameThreadDispatcher { + SameThreadDispatcher() + onChannelReadEvent(channel : AbstractNioChannel, readObject : Object, key : SelectionKey) + stop() } class ThreadPoolDispatcher { - executorService : ExecutorService + ThreadPoolDispatcher(poolSize : int) + onChannelReadEvent(channel : AbstractNioChannel, readObject : Object, key : SelectionKey) + stop() } } package com.iluwatar.reactor.app { class App { - channels : List - dispatcher : Dispatcher - reactor : NioReactor + App(dispatcher : Dispatcher) + main(args : String[]) {static} + start() + stop() - tcpChannel(port : int, handler : ChannelHandler) : AbstractNioChannel - udpChannel(port : int, handler : ChannelHandler) : AbstractNioChannel } class AppClient { - LOGGER : Logger {static} - service : ExecutorService + AppClient() - artificialDelayOf(millis : long) {static} + main(args : String[]) {static} + start() + stop() } ~class TcpLoggingClient { - clientName : String - serverPort : int + TcpLoggingClient(clientName : String, serverPort : int) + run() - sendLogRequests(writer : PrintWriter, inputStream : InputStream) } ~class UdpLoggingClient { - clientName : String - remoteAddress : InetSocketAddress + UdpLoggingClient(clientName : String, port : int) + run() } class LoggingHandler { - ACK : byte[] {static} - LOGGER : Logger {static} + LoggingHandler() - doLogging(data : ByteBuffer) {static} + handleChannelRead(channel : AbstractNioChannel, readObject : Object, key : SelectionKey) - sendReply(channel : AbstractNioChannel, incomingPacket : DatagramPacket, key : SelectionKey) {static} - sendReply(channel : AbstractNioChannel, key : SelectionKey) {static} } } AbstractNioChannel --> "-handler" ChannelHandler UdpLoggingClient ..+ AppClient TcpLoggingClient ..+ AppClient AbstractNioChannel --> "-reactor" NioReactor NioReactor --> "-dispatcher" Dispatcher App --> "-reactor" NioReactor App --> "-channels" AbstractNioChannel DatagramPacket ..+ NioDatagramChannel App --> "-dispatcher" Dispatcher ChangeKeyOpsCommand --+ NioReactor LoggingHandler ..|> ChannelHandler NioDatagramChannel --|> AbstractNioChannel NioServerSocketChannel --|> AbstractNioChannel SameThreadDispatcher ..|> Dispatcher ThreadPoolDispatcher ..|> Dispatcher @enduml java-design-patterns-1.16.0/reactor/pom.xml000066400000000000000000000033601312550536300206060ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 reactor junit junit test java-design-patterns-1.16.0/reactor/src/000077500000000000000000000000001312550536300200565ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/000077500000000000000000000000001312550536300210025ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/000077500000000000000000000000001312550536300217235ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/000077500000000000000000000000001312550536300225015ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243315ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/000077500000000000000000000000001312550536300257705ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/app/000077500000000000000000000000001312550536300265505ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/app/App.java000066400000000000000000000133741312550536300301430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.app; import java.io.IOException; import java.util.ArrayList; import java.util.List; import com.iluwatar.reactor.framework.AbstractNioChannel; import com.iluwatar.reactor.framework.ChannelHandler; import com.iluwatar.reactor.framework.Dispatcher; import com.iluwatar.reactor.framework.NioDatagramChannel; import com.iluwatar.reactor.framework.NioReactor; import com.iluwatar.reactor.framework.NioServerSocketChannel; import com.iluwatar.reactor.framework.ThreadPoolDispatcher; /** * This application demonstrates Reactor pattern. The example demonstrated is a Distributed Logging * Service where it listens on multiple TCP or UDP sockets for incoming log requests. * *

* INTENT
* The Reactor design pattern handles service requests that are delivered concurrently to an * application by one or more clients. The application can register specific handlers for processing * which are called by reactor on specific events. * *

* PROBLEM
* Server applications in a distributed system must handle multiple clients that send them service * requests. Following forces need to be resolved: *

    *
  • Availability
    • *
  • Efficiency
    • *
  • Programming Simplicity
    • *
  • Adaptability
    • *
* *

* PARTICIPANTS
*

    *
  • Synchronous Event De-multiplexer
    • {@link NioReactor} plays the role of synchronous event * de-multiplexer. It waits for events on multiple channels registered to it in an event loop. * *

    *

  • Initiation Dispatcher
    • {@link NioReactor} plays this role as the application specific * {@link ChannelHandler}s are registered to the reactor. * *

    *

  • Handle
    • {@link AbstractNioChannel} acts as a handle that is registered to the reactor. * When any events occur on a handle, reactor calls the appropriate handler. * *

    *

  • Event Handler
    • {@link ChannelHandler} acts as an event handler, which is bound to a * channel and is called back when any event occurs on any of its associated handles. Application * logic resides in event handlers. *
* *

* The application utilizes single thread to listen for requests on all ports. It does not create a * separate thread for each client, which provides better scalability under load (number of clients * increase). * *

* The example uses Java NIO framework to implement the Reactor. * */ public class App { private NioReactor reactor; private List channels = new ArrayList<>(); private Dispatcher dispatcher; /** * Creates an instance of App which will use provided dispatcher for dispatching events on * reactor. * * @param dispatcher the dispatcher that will be used to dispatch events. */ public App(Dispatcher dispatcher) { this.dispatcher = dispatcher; } /** * App entry. */ public static void main(String[] args) throws IOException { new App(new ThreadPoolDispatcher(2)).start(); } /** * Starts the NIO reactor. * * @throws IOException if any channel fails to bind. */ public void start() throws IOException { /* * The application can customize its event dispatching mechanism. */ reactor = new NioReactor(dispatcher); /* * This represents application specific business logic that dispatcher will call on appropriate * events. These events are read events in our example. */ LoggingHandler loggingHandler = new LoggingHandler(); /* * Our application binds to multiple channels and uses same logging handler to handle incoming * log requests. */ reactor.registerChannel(tcpChannel(6666, loggingHandler)) .registerChannel(tcpChannel(6667, loggingHandler)) .registerChannel(udpChannel(6668, loggingHandler)).start(); } /** * Stops the NIO reactor. This is a blocking call. * * @throws InterruptedException if interrupted while stopping the reactor. * @throws IOException if any I/O error occurs */ public void stop() throws InterruptedException, IOException { reactor.stop(); dispatcher.stop(); for (AbstractNioChannel channel : channels) { channel.getJavaChannel().close(); } } private AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException { NioServerSocketChannel channel = new NioServerSocketChannel(port, handler); channel.bind(); channels.add(channel); return channel; } private AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException { NioDatagramChannel channel = new NioDatagramChannel(port, handler); channel.bind(); channels.add(channel); return channel; } } java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java000066400000000000000000000137611312550536300313020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.app; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import java.io.PrintWriter; import java.net.DatagramPacket; import java.net.DatagramSocket; import java.net.InetAddress; import java.net.InetSocketAddress; import java.net.Socket; import java.net.UnknownHostException; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * Represents the clients of Reactor pattern. Multiple clients are run concurrently and send logging * requests to Reactor. */ public class AppClient { private static final Logger LOGGER = LoggerFactory.getLogger(AppClient.class); private final ExecutorService service = Executors.newFixedThreadPool(4); /** * App client entry. * * @throws IOException if any I/O error occurs. */ public static void main(String[] args) throws IOException { AppClient appClient = new AppClient(); appClient.start(); } /** * Starts the logging clients. * * @throws IOException if any I/O error occurs. */ public void start() throws IOException { service.execute(new TcpLoggingClient("Client 1", 6666)); service.execute(new TcpLoggingClient("Client 2", 6667)); service.execute(new UdpLoggingClient("Client 3", 6668)); service.execute(new UdpLoggingClient("Client 4", 6668)); } /** * Stops logging clients. This is a blocking call. */ public void stop() { service.shutdown(); if (!service.isTerminated()) { service.shutdownNow(); try { service.awaitTermination(1000, TimeUnit.SECONDS); } catch (InterruptedException e) { e.printStackTrace(); } } } private static void artificialDelayOf(long millis) { try { Thread.sleep(millis); } catch (InterruptedException e) { e.printStackTrace(); } } /** * A logging client that sends requests to Reactor on TCP socket. */ static class TcpLoggingClient implements Runnable { private final int serverPort; private final String clientName; /** * Creates a new TCP logging client. * * @param clientName the name of the client to be sent in logging requests. * @param port the port on which client will send logging requests. */ public TcpLoggingClient(String clientName, int serverPort) { this.clientName = clientName; this.serverPort = serverPort; } public void run() { try (Socket socket = new Socket(InetAddress.getLocalHost(), serverPort)) { OutputStream outputStream = socket.getOutputStream(); PrintWriter writer = new PrintWriter(outputStream); sendLogRequests(writer, socket.getInputStream()); } catch (IOException e) { e.printStackTrace(); throw new RuntimeException(e); } } private void sendLogRequests(PrintWriter writer, InputStream inputStream) throws IOException { for (int i = 0; i < 4; i++) { writer.println(clientName + " - Log request: " + i); writer.flush(); byte[] data = new byte[1024]; int read = inputStream.read(data, 0, data.length); if (read == 0) { LOGGER.info("Read zero bytes"); } else { LOGGER.info(new String(data, 0, read)); } artificialDelayOf(100); } } } /** * A logging client that sends requests to Reactor on UDP socket. */ static class UdpLoggingClient implements Runnable { private final String clientName; private final InetSocketAddress remoteAddress; /** * Creates a new UDP logging client. * * @param clientName the name of the client to be sent in logging requests. * @param port the port on which client will send logging requests. * @throws UnknownHostException if localhost is unknown */ public UdpLoggingClient(String clientName, int port) throws UnknownHostException { this.clientName = clientName; this.remoteAddress = new InetSocketAddress(InetAddress.getLocalHost(), port); } @Override public void run() { try (DatagramSocket socket = new DatagramSocket()) { for (int i = 0; i < 4; i++) { String message = clientName + " - Log request: " + i; DatagramPacket request = new DatagramPacket(message.getBytes(), message.getBytes().length, remoteAddress); socket.send(request); byte[] data = new byte[1024]; DatagramPacket reply = new DatagramPacket(data, data.length); socket.receive(reply); if (reply.getLength() == 0) { LOGGER.info("Read zero bytes"); } else { LOGGER.info(new String(reply.getData(), 0, reply.getLength())); } artificialDelayOf(100); } } catch (IOException e1) { e1.printStackTrace(); } } } } java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java000066400000000000000000000064721312550536300323100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.app; import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; import com.iluwatar.reactor.framework.AbstractNioChannel; import com.iluwatar.reactor.framework.ChannelHandler; import com.iluwatar.reactor.framework.NioDatagramChannel.DatagramPacket; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Logging server application logic. It logs the incoming requests on standard console and returns a * canned acknowledgement back to the remote peer. */ public class LoggingHandler implements ChannelHandler { private static final Logger LOGGER = LoggerFactory.getLogger(LoggingHandler.class); private static final byte[] ACK = "Data logged successfully".getBytes(); /** * Decodes the received data and logs it on standard console. */ @Override public void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key) { /* * As this handler is attached with both TCP and UDP channels we need to check whether the data * received is a ByteBuffer (from TCP channel) or a DatagramPacket (from UDP channel). */ if (readObject instanceof ByteBuffer) { doLogging((ByteBuffer) readObject); sendReply(channel, key); } else if (readObject instanceof DatagramPacket) { DatagramPacket datagram = (DatagramPacket) readObject; doLogging(datagram.getData()); sendReply(channel, datagram, key); } else { throw new IllegalStateException("Unknown data received"); } } private static void sendReply(AbstractNioChannel channel, DatagramPacket incomingPacket, SelectionKey key) { /* * Create a reply acknowledgement datagram packet setting the receiver to the sender of incoming * message. */ DatagramPacket replyPacket = new DatagramPacket(ByteBuffer.wrap(ACK)); replyPacket.setReceiver(incomingPacket.getSender()); channel.write(replyPacket, key); } private static void sendReply(AbstractNioChannel channel, SelectionKey key) { ByteBuffer buffer = ByteBuffer.wrap(ACK); channel.write(buffer, key); } private static void doLogging(ByteBuffer data) { // assuming UTF-8 :( LOGGER.info(new String(data.array(), 0, data.limit())); } } java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/000077500000000000000000000000001312550536300277655ustar00rootroot00000000000000AbstractNioChannel.java000066400000000000000000000137421312550536300342620ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import java.io.IOException; import java.nio.channels.SelectableChannel; import java.nio.channels.SelectionKey; import java.nio.channels.Selector; import java.util.Map; import java.util.Queue; import java.util.concurrent.ConcurrentHashMap; import java.util.concurrent.ConcurrentLinkedQueue; /** * This represents the Handle of Reactor pattern. These are resources managed by OS which can * be submitted to {@link NioReactor}. * *

* This class serves has the responsibility of reading the data when a read event occurs and writing * the data back when the channel is writable. It leaves the reading and writing of data on the * concrete implementation. It provides a block writing mechanism wherein when any * {@link ChannelHandler} wants to write data back, it queues the data in pending write queue and * clears it in block manner. This provides better throughput. */ public abstract class AbstractNioChannel { private final SelectableChannel channel; private final ChannelHandler handler; private final Map> channelToPendingWrites = new ConcurrentHashMap<>(); private NioReactor reactor; /** * Creates a new channel. * * @param handler which will handle events occurring on this channel. * @param channel a NIO channel to be wrapped. */ public AbstractNioChannel(ChannelHandler handler, SelectableChannel channel) { this.handler = handler; this.channel = channel; } /** * Injects the reactor in this channel. */ void setReactor(NioReactor reactor) { this.reactor = reactor; } /** * @return the wrapped NIO channel. */ public SelectableChannel getJavaChannel() { return channel; } /** * The operation in which the channel is interested, this operation is provided to * {@link Selector}. * * @return interested operation. * @see SelectionKey */ public abstract int getInterestedOps(); /** * Binds the channel on provided port. * * @throws IOException if any I/O error occurs. */ public abstract void bind() throws IOException; /** * Reads the data using the key and returns the read data. The underlying channel should be * fetched using {@link SelectionKey#channel()}. * * @param key the key on which read event occurred. * @return data read. * @throws IOException if any I/O error occurs. */ public abstract Object read(SelectionKey key) throws IOException; /** * @return the handler associated with this channel. */ public ChannelHandler getHandler() { return handler; } /* * Called from the context of reactor thread when the key becomes writable. The channel writes the * whole pending block of data at once. */ void flush(SelectionKey key) throws IOException { Queue pendingWrites = channelToPendingWrites.get(key.channel()); while (true) { Object pendingWrite = pendingWrites.poll(); if (pendingWrite == null) { // We don't have anything more to write so channel is interested in reading more data reactor.changeOps(key, SelectionKey.OP_READ); break; } // ask the concrete channel to make sense of data and write it to java channel doWrite(pendingWrite, key); } } /** * Writes the data to the channel. * * @param pendingWrite the data to be written on channel. * @param key the key which is writable. * @throws IOException if any I/O error occurs. */ protected abstract void doWrite(Object pendingWrite, SelectionKey key) throws IOException; /** * Queues the data for writing. The data is not guaranteed to be written on underlying channel * when this method returns. It will be written when the channel is flushed. * *

* This method is used by the {@link ChannelHandler} to send reply back to the client.
* Example: * * 

   * 
   * {@literal @}Override
   * public void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key) {
   *   byte[] data = ((ByteBuffer)readObject).array();
   *   ByteBuffer buffer = ByteBuffer.wrap("Server reply".getBytes());
   *   channel.write(buffer, key);
   * }
   * 
   *
* * @param data the data to be written on underlying channel. * @param key the key which is writable. */ public void write(Object data, SelectionKey key) { Queue pendingWrites = this.channelToPendingWrites.get(key.channel()); if (pendingWrites == null) { synchronized (this.channelToPendingWrites) { pendingWrites = this.channelToPendingWrites.get(key.channel()); if (pendingWrites == null) { pendingWrites = new ConcurrentLinkedQueue<>(); this.channelToPendingWrites.put(key.channel(), pendingWrites); } } } pendingWrites.add(data); reactor.changeOps(key, SelectionKey.OP_WRITE); } } java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java000066400000000000000000000037211312550536300335010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import java.nio.channels.SelectionKey; /** * Represents the EventHandler of Reactor pattern. It handles the incoming events dispatched * to it by the {@link Dispatcher}. This is where the application logic resides. * *

* A {@link ChannelHandler} can be associated with one or many {@link AbstractNioChannel}s, and * whenever an event occurs on any of the associated channels, the handler is notified of the event. */ public interface ChannelHandler { /** * Called when the {@code channel} receives some data from remote peer. * * @param channel the channel from which the data was received. * @param readObject the data read. * @param key the key on which read event occurred. */ void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key); } java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java000066400000000000000000000054041312550536300327210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import java.nio.channels.SelectionKey; /** * Represents the event dispatching strategy. When {@link NioReactor} senses any event on the * registered {@link AbstractNioChannel}s then it de-multiplexes the event type, read or write or * connect, and then calls the {@link Dispatcher} to dispatch the read events. This decouples the * I/O processing from application specific processing.
* Dispatcher should call the {@link ChannelHandler} associated with the channel on which event * occurred. * *

* The application can customize the way in which event is dispatched such as using the reactor * thread to dispatch event to channels or use a worker pool to do the non I/O processing. * * @see SameThreadDispatcher * @see ThreadPoolDispatcher */ public interface Dispatcher { /** * This hook method is called when read event occurs on particular channel. The data read is * provided in readObject. The implementation should dispatch this read event to the * associated {@link ChannelHandler} of channel. * *

* The type of readObject depends on the channel on which data was received. * * @param channel on which read event occurred * @param readObject object read by channel * @param key on which event occurred */ void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key); /** * Stops dispatching events and cleans up any acquired resources such as threads. * * @throws InterruptedException if interrupted while stopping dispatcher. */ void stop() throws InterruptedException; } NioDatagramChannel.java000066400000000000000000000133521312550536300342340ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.IOException; import java.net.InetAddress; import java.net.InetSocketAddress; import java.net.SocketAddress; import java.nio.ByteBuffer; import java.nio.channels.DatagramChannel; import java.nio.channels.SelectionKey; /** * A wrapper over {@link DatagramChannel} which can read and write data on a DatagramChannel. */ public class NioDatagramChannel extends AbstractNioChannel { private static final Logger LOGGER = LoggerFactory.getLogger(NioDatagramChannel.class); private final int port; /** * Creates a {@link DatagramChannel} which will bind at provided port and use handler * to handle incoming events on this channel. *

* Note the constructor does not bind the socket, {@link #bind()} method should be called for * binding the socket. * * @param port the port to be bound to listen for incoming datagram requests. * @param handler the handler to be used for handling incoming requests on this channel. * @throws IOException if any I/O error occurs. */ public NioDatagramChannel(int port, ChannelHandler handler) throws IOException { super(handler, DatagramChannel.open()); this.port = port; } @Override public int getInterestedOps() { /* * there is no need to accept connections in UDP, so the channel shows interest in reading data. */ return SelectionKey.OP_READ; } /** * Reads and returns a {@link DatagramPacket} from the underlying channel. * * @return the datagram packet read having the sender address. */ @Override public DatagramPacket read(SelectionKey key) throws IOException { ByteBuffer buffer = ByteBuffer.allocate(1024); SocketAddress sender = ((DatagramChannel) key.channel()).receive(buffer); /* * It is required to create a DatagramPacket because we need to preserve which socket address * acts as destination for sending reply packets. */ buffer.flip(); DatagramPacket packet = new DatagramPacket(buffer); packet.setSender(sender); return packet; } /** * @return the underlying datagram channel. */ @Override public DatagramChannel getJavaChannel() { return (DatagramChannel) super.getJavaChannel(); } /** * Binds UDP socket on the provided port. * * @throws IOException if any I/O error occurs. */ @Override public void bind() throws IOException { getJavaChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port)); getJavaChannel().configureBlocking(false); LOGGER.info("Bound UDP socket at port: {}", port); } /** * Writes the pending {@link DatagramPacket} to the underlying channel sending data to the * intended receiver of the packet. */ @Override protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException { DatagramPacket pendingPacket = (DatagramPacket) pendingWrite; getJavaChannel().send(pendingPacket.getData(), pendingPacket.getReceiver()); } /** * Writes the outgoing {@link DatagramPacket} to the channel. The intended receiver of the * datagram packet must be set in the data using * {@link DatagramPacket#setReceiver(SocketAddress)}. */ @Override public void write(Object data, SelectionKey key) { super.write(data, key); } /** * Container of data used for {@link NioDatagramChannel} to communicate with remote peer. */ public static class DatagramPacket { private SocketAddress sender; private ByteBuffer data; private SocketAddress receiver; /** * Creates a container with underlying data. * * @param data the underlying message to be written on channel. */ public DatagramPacket(ByteBuffer data) { this.data = data; } /** * @return the sender address. */ public SocketAddress getSender() { return sender; } /** * Sets the sender address of this packet. * * @param sender the sender address. */ public void setSender(SocketAddress sender) { this.sender = sender; } /** * @return the receiver address. */ public SocketAddress getReceiver() { return receiver; } /** * Sets the intended receiver address. This must be set when writing to the channel. * * @param receiver the receiver address. */ public void setReceiver(SocketAddress receiver) { this.receiver = receiver; } /** * @return the underlying message that will be written on channel. */ public ByteBuffer getData() { return data; } } } java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java000066400000000000000000000223301312550536300326750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.IOException; import java.nio.channels.SelectionKey; import java.nio.channels.Selector; import java.nio.channels.ServerSocketChannel; import java.nio.channels.SocketChannel; import java.util.Iterator; import java.util.Queue; import java.util.Set; import java.util.concurrent.ConcurrentLinkedQueue; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * This class acts as Synchronous Event De-multiplexer and Initiation Dispatcher of Reactor pattern. Multiple handles * i.e. {@link AbstractNioChannel}s can be registered to the reactor and it blocks for events from all these handles. * Whenever an event occurs on any of the registered handles, it synchronously de-multiplexes the event which can be any * of read, write or accept, and dispatches the event to the appropriate {@link ChannelHandler} using the * {@link Dispatcher}. * *

* Implementation: A NIO reactor runs in its own thread when it is started using {@link #start()} method. * {@link NioReactor} uses {@link Selector} for realizing Synchronous Event De-multiplexing. * *

* NOTE: This is one of the ways to implement NIO reactor and it does not take care of all possible edge cases which are * required in a real application. This implementation is meant to demonstrate the fundamental concepts that lie behind * Reactor pattern. */ public class NioReactor { private static final Logger LOGGER = LoggerFactory.getLogger(NioReactor.class); private final Selector selector; private final Dispatcher dispatcher; /** * All the work of altering the SelectionKey operations and Selector operations are performed in the context of main * event loop of reactor. So when any channel needs to change its readability or writability, a new command is added * in the command queue and then the event loop picks up the command and executes it in next iteration. */ private final Queue pendingCommands = new ConcurrentLinkedQueue<>(); private final ExecutorService reactorMain = Executors.newSingleThreadExecutor(); /** * Creates a reactor which will use provided {@code dispatcher} to dispatch events. The application can provide * various implementations of dispatcher which suits its needs. * * @param dispatcher * a non-null dispatcher used to dispatch events on registered channels. * @throws IOException * if any I/O error occurs. */ public NioReactor(Dispatcher dispatcher) throws IOException { this.dispatcher = dispatcher; this.selector = Selector.open(); } /** * Starts the reactor event loop in a new thread. * * @throws IOException * if any I/O error occurs. */ public void start() throws IOException { reactorMain.execute(() -> { try { LOGGER.info("Reactor started, waiting for events..."); eventLoop(); } catch (IOException e) { e.printStackTrace(); } }); } /** * Stops the reactor and related resources such as dispatcher. * * @throws InterruptedException * if interrupted while stopping the reactor. * @throws IOException * if any I/O error occurs. */ public void stop() throws InterruptedException, IOException { reactorMain.shutdownNow(); selector.wakeup(); reactorMain.awaitTermination(4, TimeUnit.SECONDS); selector.close(); } /** * Registers a new channel (handle) with this reactor. Reactor will start waiting for events on this channel and * notify of any events. While registering the channel the reactor uses {@link AbstractNioChannel#getInterestedOps()} * to know about the interested operation of this channel. * * @param channel * a new channel on which reactor will wait for events. The channel must be bound prior to being registered. * @return this * @throws IOException * if any I/O error occurs. */ public NioReactor registerChannel(AbstractNioChannel channel) throws IOException { SelectionKey key = channel.getJavaChannel().register(selector, channel.getInterestedOps()); key.attach(channel); channel.setReactor(this); return this; } private void eventLoop() throws IOException { while (true) { // honor interrupt request if (Thread.interrupted()) { break; } // honor any pending commands first processPendingCommands(); /* * Synchronous event de-multiplexing happens here, this is blocking call which returns when it is possible to * initiate non-blocking operation on any of the registered channels. */ selector.select(); /* * Represents the events that have occurred on registered handles. */ Set keys = selector.selectedKeys(); Iterator iterator = keys.iterator(); while (iterator.hasNext()) { SelectionKey key = iterator.next(); if (!key.isValid()) { iterator.remove(); continue; } processKey(key); } keys.clear(); } } private void processPendingCommands() { Iterator iterator = pendingCommands.iterator(); while (iterator.hasNext()) { Runnable command = iterator.next(); command.run(); iterator.remove(); } } /* * Initiation dispatcher logic, it checks the type of event and notifier application specific event handler to handle * the event. */ private void processKey(SelectionKey key) throws IOException { if (key.isAcceptable()) { onChannelAcceptable(key); } else if (key.isReadable()) { onChannelReadable(key); } else if (key.isWritable()) { onChannelWritable(key); } } private static void onChannelWritable(SelectionKey key) throws IOException { AbstractNioChannel channel = (AbstractNioChannel) key.attachment(); channel.flush(key); } private void onChannelReadable(SelectionKey key) { try { // reads the incoming data in context of reactor main loop. Can this be improved? Object readObject = ((AbstractNioChannel) key.attachment()).read(key); dispatchReadEvent(key, readObject); } catch (IOException e) { try { key.channel().close(); } catch (IOException e1) { e1.printStackTrace(); } } } /* * Uses the application provided dispatcher to dispatch events to application handler. */ private void dispatchReadEvent(SelectionKey key, Object readObject) { dispatcher.onChannelReadEvent((AbstractNioChannel) key.attachment(), readObject, key); } private void onChannelAcceptable(SelectionKey key) throws IOException { ServerSocketChannel serverSocketChannel = (ServerSocketChannel) key.channel(); SocketChannel socketChannel = serverSocketChannel.accept(); socketChannel.configureBlocking(false); SelectionKey readKey = socketChannel.register(selector, SelectionKey.OP_READ); readKey.attach(key.attachment()); } /** * Queues the change of operations request of a channel, which will change the interested operations of the channel * sometime in future. *

* This is a non-blocking method and does not guarantee that the operations have changed when this method returns. * * @param key * the key for which operations have to be changed. * @param interestedOps * the new interest operations. */ public void changeOps(SelectionKey key, int interestedOps) { pendingCommands.add(new ChangeKeyOpsCommand(key, interestedOps)); selector.wakeup(); } /** * A command that changes the interested operations of the key provided. */ class ChangeKeyOpsCommand implements Runnable { private SelectionKey key; private int interestedOps; public ChangeKeyOpsCommand(SelectionKey key, int interestedOps) { this.key = key; this.interestedOps = interestedOps; } public void run() { key.interestOps(interestedOps); } @Override public String toString() { return "Change of ops to: " + interestedOps; } } } NioServerSocketChannel.java000066400000000000000000000102521312550536300351270ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.IOException; import java.net.InetAddress; import java.net.InetSocketAddress; import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; import java.nio.channels.ServerSocketChannel; import java.nio.channels.SocketChannel; /** * A wrapper over {@link NioServerSocketChannel} which can read and write data on a * {@link SocketChannel}. */ public class NioServerSocketChannel extends AbstractNioChannel { private static final Logger LOGGER = LoggerFactory.getLogger(NioServerSocketChannel.class); private final int port; /** * Creates a {@link ServerSocketChannel} which will bind at provided port and use * handler to handle incoming events on this channel. *

* Note the constructor does not bind the socket, {@link #bind()} method should be called for * binding the socket. * * @param port the port on which channel will be bound to accept incoming connection requests. * @param handler the handler that will handle incoming requests on this channel. * @throws IOException if any I/O error occurs. */ public NioServerSocketChannel(int port, ChannelHandler handler) throws IOException { super(handler, ServerSocketChannel.open()); this.port = port; } @Override public int getInterestedOps() { // being a server socket channel it is interested in accepting connection from remote peers. return SelectionKey.OP_ACCEPT; } /** * @return the underlying {@link ServerSocketChannel}. */ @Override public ServerSocketChannel getJavaChannel() { return (ServerSocketChannel) super.getJavaChannel(); } /** * Reads and returns {@link ByteBuffer} from the underlying {@link SocketChannel} represented by * the key. Due to the fact that there is a dedicated channel for each client * connection we don't need to store the sender. */ @Override public ByteBuffer read(SelectionKey key) throws IOException { SocketChannel socketChannel = (SocketChannel) key.channel(); ByteBuffer buffer = ByteBuffer.allocate(1024); int read = socketChannel.read(buffer); buffer.flip(); if (read == -1) { throw new IOException("Socket closed"); } return buffer; } /** * Binds TCP socket on the provided port. * * @throws IOException if any I/O error occurs. */ @Override public void bind() throws IOException { ((ServerSocketChannel) getJavaChannel()).socket().bind( new InetSocketAddress(InetAddress.getLocalHost(), port)); ((ServerSocketChannel) getJavaChannel()).configureBlocking(false); LOGGER.info("Bound TCP socket at port: {}", port); } /** * Writes the pending {@link ByteBuffer} to the underlying channel sending data to the intended * receiver of the packet. */ @Override protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException { ByteBuffer pendingBuffer = (ByteBuffer) pendingWrite; ((SocketChannel) key.channel()).write(pendingBuffer); } } SameThreadDispatcher.java000066400000000000000000000043341312550536300346010ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import java.nio.channels.SelectionKey; /** * Dispatches the events in the context of caller thread. This implementation is a good fit for * small applications where there are limited clients. Using this implementation limits the * scalability because the I/O thread performs the application specific processing. * *

* For better performance use {@link ThreadPoolDispatcher}. * * @see ThreadPoolDispatcher */ public class SameThreadDispatcher implements Dispatcher { /** * Dispatches the read event in the context of caller thread.
* Note this is a blocking call. It returns only after the associated handler has handled the read * event. */ @Override public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { /* * Calls the associated handler to notify the read event where application specific code * resides. */ channel.getHandler().handleChannelRead(channel, readObject, key); } /** * No resources to free. */ @Override public void stop() { // no-op } } ThreadPoolDispatcher.java000066400000000000000000000052271312550536300346270ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/main/java/com/iluwatar/reactor/framework/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.framework; import java.nio.channels.SelectionKey; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; /** * An implementation that uses a pool of worker threads to dispatch the events. This provides better * scalability as the application specific processing is not performed in the context of I/O * (reactor) thread. */ public class ThreadPoolDispatcher implements Dispatcher { private final ExecutorService executorService; /** * Creates a pooled dispatcher with tunable pool size. * * @param poolSize number of pooled threads */ public ThreadPoolDispatcher(int poolSize) { this.executorService = Executors.newFixedThreadPool(poolSize); } /** * Submits the work of dispatching the read event to worker pool, where it gets picked up by * worker threads.
* Note that this is a non-blocking call and returns immediately. It is not guaranteed that the * event has been handled by associated handler. */ @Override public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { executorService.execute(() -> channel.getHandler().handleChannelRead(channel, readObject, key)); } /** * Stops the pool of workers. * * @throws InterruptedException if interrupted while stopping pool of workers. */ @Override public void stop() throws InterruptedException { executorService.shutdown(); executorService.awaitTermination(4, TimeUnit.SECONDS); } } java-design-patterns-1.16.0/reactor/src/test/000077500000000000000000000000001312550536300210355ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/test/java/000077500000000000000000000000001312550536300217565ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/test/java/com/000077500000000000000000000000001312550536300225345ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300243645ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/test/java/com/iluwatar/reactor/000077500000000000000000000000001312550536300260235ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/test/java/com/iluwatar/reactor/app/000077500000000000000000000000001312550536300266035ustar00rootroot00000000000000java-design-patterns-1.16.0/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java000066400000000000000000000054171312550536300317140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reactor.app; import java.io.IOException; import org.junit.Test; import com.iluwatar.reactor.framework.SameThreadDispatcher; import com.iluwatar.reactor.framework.ThreadPoolDispatcher; /** * * This class tests the Distributed Logging service by starting a Reactor and then sending it * concurrent logging requests using multiple clients. */ public class ReactorTest { /** * Test the application using pooled thread dispatcher. * * @throws IOException if any I/O error occurs. * @throws InterruptedException if interrupted while stopping the application. */ @Test public void testAppUsingThreadPoolDispatcher() throws IOException, InterruptedException { App app = new App(new ThreadPoolDispatcher(2)); app.start(); AppClient client = new AppClient(); client.start(); // allow clients to send requests. Artificial delay. try { Thread.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } client.stop(); app.stop(); } /** * Test the application using same thread dispatcher. * * @throws IOException if any I/O error occurs. * @throws InterruptedException if interrupted while stopping the application. */ @Test public void testAppUsingSameThreadDispatcher() throws IOException, InterruptedException { App app = new App(new SameThreadDispatcher()); app.start(); AppClient client = new AppClient(); client.start(); // allow clients to send requests. Artificial delay. try { Thread.sleep(2000); } catch (InterruptedException e) { e.printStackTrace(); } client.stop(); app.stop(); } } java-design-patterns-1.16.0/reader-writer-lock/000077500000000000000000000000001312550536300213325ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/README.md000066400000000000000000000027121312550536300226130ustar00rootroot00000000000000--- layout: pattern title: Reader Writer Lock folder: reader-writer-lock permalink: /patterns/reader-writer-lock/ pumlid: RSZB4S8m303HLg00MtUw4R8cCP5bZpwuVL80jttxx4gIZTFaSKOiVm4OxdhqEFETpaPJWpKgpG5TScEWmGU_M1fxFxGiZ61JXu5-1nXZOolR-gqYaoxWe3-xfeswSiWF categories: Concurrency tags: - Java - Difficulty-Intermediate - I/O - Performance --- **Intent:** Suppose we have a shared memory area with the basic constraints detailed above. It is possible to protect the shared data behind a mutual exclusion mutex, in which case no two threads can access the data at the same time. However, this solution is suboptimal, because it is possible that a reader R1 might have the lock, and then another reader R2 requests access. It would be foolish for R2 to wait until R1 was done before starting its own read operation; instead, R2 should start right away. This is the motivation for the Reader Writer Lock pattern. ![alt text](./etc/reader-writer-lock.png "Reader writer lock") **Applicability:** Application need to increase the performance of resource synchronize for multiple thread, in particularly there are mixed read/write operations. **Real world examples:** * [Java Reader Writer Lock](https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/locks/ReadWriteLock.html) **Credits** * [Readers–writer lock](https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock) * [Readers–writers_problem](https://en.wikipedia.org/wiki/Readers%E2%80%93writers_problem)java-design-patterns-1.16.0/reader-writer-lock/etc/000077500000000000000000000000001312550536300221055ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/etc/reader-writer-lock.png000066400000000000000000001153071312550536300263240ustar00rootroot00000000000000PNG  IHDRc+\IDATx} X6J* 5WDQ1W\qWK5pW/bŨIܣhEJvk6azsytqHHHHHHH ;@BBBBBi!$!!!!!1&cHQ0q6T hVsأO{Lt`wM&TYh2!G!{h 4 \&$(ĔvR!f˄%1a>혀ByTڼ /zo"Es:O*|XtZ*z%`ԨOF~f7ިaNĔ)a$?_v )SxqOULՍNݾG;=yrpDp:8g鴭8E m{SJ6B}xWt鸇ӍdM'aԁrJpzX6 10;b%,]]]PF>}U>^8:iREF Q:S@kBi[юE ո=)mznLޭ9|xUN-Kv?rd0sꨍ!ʕ^s~cX&2*xpܻjT)wTk?O7#ر9L2FftV))$8S\SƝ1qc_Ƶ4½ّE揼z-6Rcİ5*٫&>pKkU:̱)Ӷbs{ )mz^.S2`CFÜc- =7_c[Sڇ1Dop 昒`)) pHdy3ĔvbJ$)mz 1݃@0 gJ# 1݃@0̔ 6RS:)  $X bJ1%`ĔKaOLcaqc,h9[ÑF{)S AC`))c.艉Q H7|yg2ŋrF?Ĕ9 ' }C?h^bJQk<㌽S?=Џ^< N;kկ_?|WBgH:sZSv;gd*׮}6zt/]ޖNmE#*d$"EѮ]sFZrTسg{&W^ m/6%) S|81S&?L6;:?oI.xfRS!'++i%.b,]i<i[т Y9_Llk?X&j|(΂Y0 5dI7.Ĕz낐S]ހ C[%/NhO巟_m o#kkɓ#rapF9dHLa\ ڴ~\_^sF1ԧ,Fί|Db5kV3g{ޥ%SZ9_Ly~atCjz+[dJexpX>QC˖.'gJs4wJ3%ȻY8/_߆ǏD%ʕˢc,l)fכo֑Go zyo)w_wt#: q2MÁ> +|r:_L !KkNIHNApa /XʟYsv._kժ֤QWxjH̞)WJ"Bs߱cWL:_1EP թSťPooЂ:KhgJ35 Zj+M6”iTsUK uyzHt$cʛ7֭3mĔvކ5(gp— 1DdF^jWV-ZÕɡnK޽T\ս:0|̖Nr%3} ݾ}SIgآE .l>P1uJfj#j&X:Y[ Hi9Zə|&bJwuu _%ϞM`4,n=ƔUk۶8ZaD ׅ׈h)qznĹإ߮wn7`ӗ;NndEAXXxP֫xY~ >kԨ u^eȾ̛7i&`/~\IR֠SZ9( !5t Y27ot~p)7 k4S&&"Et `H!)ȷΟͯ ~y(S47[w{5whD¤ [7mc:gt 䤧@+s@/n ٗH׬YϯǏ?T֠SZ9fzXCj*c:vlk-T 2`FJ 1%\g䇆p@bn ;3%{Zmseb®_p90%np&X9?ܼ;yX{`* ȁsq)r`¤ ,?Jn_ʗ/_dtX|/*k)Qss|45`d7Tmw4cCV!ͣFF([i!pa2{\̆ kJ9jܸ+9x;0O1%DMNJ抑Ү_p90%0#S0lJҬ?'ҽVn63݇g{Ma>"/jUƯnaJ`8PՄ ߏϺ-ѻ}޶mnʹs H{{{6:wncLp nOCn,(h2cJ5-xƬ0Nih3Ds8_Ȕ}OLl~]{-vRҙ t(S&ALIĔbJ$) ҡ@LI 1%RSn>Gz9d\Ǐ3ԩ)[g3LJlWbJ@JkTQڼ1%RS>}zѣt+~6:*vRS 5Ĕȷ0͔q$22}~f'F ܹUo@ǯW_r~>|xaޏf.]Λ7B]m6Bϯٝ;JZϜقf7nٳ}׮> d;f+zl8>O3^sX<}ի<wovft^}ժ}4rĈ͛,t֭3kb}u<|@^A a4?S!?jWWE60LIoA1%~Ȑ W&رu8aSX2CF_SJ9F';;8I#󸯸ϷuZժ4+LFT$f_EYС݂7[nf{.\l^Q&3:TG9zϧs޼722%))mC#LIoӅMhmk_qe}1M=fH+8:͓띠򨜁٢ ëĔFL=4”6]؄6ߦbJ$4”6ݎަS:) St;zNLP $LB#LIo%yNLP $LB#L@os.!{S&)$LY= &@HH4+6L)NS:ȧ$L ]v bJ1%`ĔKALP $L`)) ĔI2v*wĔv'bJ{í[W!eBׅV>+i>=,,/3q& !cS2:Q)yJ-<d eDcē'NXD*UU\gׯC_~ 4{ $X 1%.k>tǏ3ň)-1%ELY` <QI;j׮b)k hqIqIlp/W"h4rUz $X 7lt;0y{{1=;2.nSwԩeZ*cG(֭+4rw/_%L([6edl ORÆuLvƾ-8i^vӶb J6l >+R`Dܵkn᥍ӛ3py?ٹ xkŊYC10x_mi\cW!j^֬RjO?%z/ŋǀ)kԨѥx:2++sVNG\'5bJP)at'1e<رuȉwGf~s4Tk||4|MX .^Ltss]~I{7t.>N lh{Ӛ4"IM{q'J3kTH'7o&+jݹs&…]J=KS *BuMN^Ę23s5ۯR 4 5+m8 S^5TO[Pzy<9",,LǍ 2<S=}R3y ĔKvAr S[nɒ˗/ LɟZ5ܽ ?m/d GQmf``83VС Kno鴭XBr=j,b`d QdL)<\^?cg2A6`3*>yrSX -m9Le._>l R,T_9w. !͙RآR3q[o%譖!S^84sWrc{ꐐÂBժUYo8U=eدrJr G|^n: aa9#caD7ehܮ߆i[Fz" uM:>>p$]1cz],py)ׯ'L޿;~%SfdcJap&[n`O*ˌ ցY+ sLbJ $9dJ^Ri ukŊq+, )2)C?fW` G|wS)ڵ polxn.]Fh^K3FU߆i[Fz" d`o݌={Keo͛g0 <\^?g]vP!gJΝsRX9kժy"!<} >h67o&߾ *9܌Cأg v9w.#C&0'61iiT_;i[Fz"Ԋ G6 \x5kx<0\lE.dʇKrCU83 0̋ i[" bSr{?B_Z'U^}Ef=,Z6m gJaJ=Bjvʔ*:)KK722bJ8p f1f0IG#.܀H`.*?ՃQ^^Q!]D~Gã8ތXvӶb{J'R+emYѢsȇgPG^WB8P0ȀQQ)h,Gy, 1 vL={g RDZ^:lQ\'52e-y K`p٥nWD9LPn^R9Ϟe*cɚTB`ƕρ q,$2WNO_k㧣LC̔yX3Q2?ԩvpmm!{S:Yzu{LPZfʼyO?bJ1%`ZfʼyO?bJ1%`eJKa{!hĔbJ$) ybJ1%`ĔKALP $L`))G@bJ_8 ) /zyU,U[&Ogʰ{WESZ $w廉˗XP[7_kv3?[=VPN`Ԩʍ9;e ЁbJ{\DeHxq߫VS2N]}=SZ$)9е!"߿۷_-|(sVGR?~ubJP)Owxx',핕䞕6;Jv…]m6…!6R?s?τO|~˶0]+\yFоvaJ'Nl`z=>[k<̂pƹ\KΔ@l2fm.9ٹ)c/١r̙-F.6WiL)3%FO ܥ˫MQ@'p?nذGqɓp>yrHYش^mkΨs1eGNNҥcϝKhڴvժ6kӶb ) #*C+ q$;w%`)( _&hpyoҖ4aP?/]5/6WiL)i Dp/^qGvnr.q}vai\P@y!g.)$߀_n \tJO&SZ#֨2!3k2̂p֩S(TIhHmm.֭3AQ^0ĔFNY h GȆ}zp{44$Lrા?MJťo3%߀_n 3ĉa,n15b ) !#c%gJ>&,g\2++dI7ʠ ͸_{oHV@P?;)mu]h D2%/)dJn'^^Rɔa׮9cL )dBB t?>>F0ܠ93%Ya3nhEϊ,{A+6ٳ…]/o]|G҅CaoB uaD#:cO)^x 77Δ%Ŧ(/ U-Z0W}7)oNAU|9魷SZ#֨2.u0g.$l)#q$zLVp PmmT)m[ ¡0~vʫ ?!aLIK@43T^{M3d 2|<^jQ\ް8qWwݛɔ@\dԀ/=>v#4B"r `v3Ps 8S}E.xamm[`İ5*S<0r(V1y!mvXnroͻrQEa/^LĝKo6mF6Ka/LiÛ9(A Krǚ?]}h)i 6a;&Oj<]ĔB.ALKMo~}ƍӖ.gϝ) 2Smҡ@LI hĔbJ$4˔9-mS:) p<8l 1݃@0 bʼ#-!{S&ALIb,Pg_ NdB nwԸ'bJp"ґ`C'|gp%:uZTϕ+I褏q҅0t20!=yrhԁ%JR\e{lCjĔKALP 40e*T`"vé]~pCoG}|vddp@@'6Hbc^+ Ъp+zhJ-`)) ÔrLO_Ԇ{Q5jTRx䔠 gJg +gSRĘ-֭/<­[V!)h^֬̎ ;țt;|.Z^͚Pğ~JDU@FVV|έ*CIddDoP +]_&dZ3佻sIMO{Gl~>@nnO|9wo?<܀Ǎ *< V% ǔ`GhРɋ LQP@۸qV^5 9dճLu;d߾իɓ#Ma[hc79;;%05Hθ }@O`˄ةȗ)OƑ~ـD'`WuGqU0H8u-\8N:b *6t"ia=|, zc Sd)ICҖ/_tWCPgVț۱cdXcDҹ͛ӫy ~hpm, -ɓ~>'۷϶Ed)8YS2iq8X: PsW#\fr{ I.0{=ch}6y[_>ʼnP v-Ӷb)LF5zt/Qì10 zLD~ܿgdʌzLi$VP|arSV+gJa[11C *o-]>'m`)g9s~]rBpp[O4ڵ$ JQ0 P2>BXo+P)-[btVL2%/dJaN]3g'2ɱ̟~JDpaLkܮ]}}p0f0g8#wK71c{f̡ i?aL )~dqpaW.(v,`Wa4QŊ̽{?B-~13>9[իgW\XX3p48S :{6{\2G [G[hQ]E-)i |?B3:5Xr:qǍ*` xrp17mO͚MIY *¥YZ !F[>׆ae[0 >}0 Ղ@*!S (WFvO? 懿vco)DC1.*M?C\-ד0 JpӫWIǩNKd@nDEsdQP2t hB|, 34K @倞=3z#¶F&[SSj !3eq'~2v옃+CWfM|8a@{H r}<֨-0eEY&BJCȔ¥%ʕh С䇇]`/LiD}0͛z99[|wΣ(A a|am.maTsX2^`GL);c^|iA*xt|`>pިϫC,c1Y3'WULbk̘5KŽ33y`/LɔC𥆆GșR"&\Eb|΄KK+#.}¿3;iRM9i[) [Ҏ'5S,xH]Y`S!1ԘYiYLb"_߆E5\`IǔJ^ 3FHϙpireڅ݇x{{U@>~WGl̙Nۊ+=p(#?}cJ 6vxop7 lƽJrp8Su4SV3A+s5nhhƂdtc+Zk3)HB6ghpj¥%ʕ]AԂԏ_0&@OhA,S_˜r9xXB=n7.\U@]FƔiu!1͔g]?6eF@d*K_?d2!4VB)ⶂ `mSjh9H.mx/߫ޚM3)%mL/Uh)i ơ=zr {aJRh)i ơ-$X bJ$4ȔD t(S&Ah ALP $LBL) ҡ@LI f2@/1C@0|Ȕ+aLI b<i`)lƔŋ1̪9Y2AuS,͘x ԛYթ˸6S) B} hvNM]Ŭّqqs/^s:b&,fJTmv[Zd,nY>KF9NۊZ1Z3[$?1lh K!۶bvI2ٖժyv|n,ߤ6!oR}019ރ`M`jԨ۫WxRF9NۊZ1ZSbBǛEά3d@y1 5n\E)16G%SJBXƔlx>6v8no_,{x~ӶVVl0N~Yҽf3+.,[6u,ҥ=Ƀ@{a .}Fu#)U|/+t4Sὤ[SlIfA`Jtcs/^s:b&bFmӅKfM3˨ sv B 9{6pas92$:zLqmT9Bn@Lg%ZaΘfJs6zĬMsK~NӶbVྪqZ Yⶬh gQ\22V 5DҽDC^^)rׯc߾&Qm2e^Y+zX/x>SJ9R!VQ3fL r9n S{ZaΘ/<XO`J)UHE6:4ȔyX367”v F{2K .S1%`d<~/+tALI R#:CLi $LBL){zn) ĔIh)|S:)  $X 1S(Db/'DLINB$!R"M6b]H }S,1%IHXǀo/,:u@L}S,1%I5! Kuj2oo/:gGMS8-Ho9p̭[ Q20U7<=K ˩ƍ}-[?p`d*T1%RSc&DFϟd'9;d 'Nlx8#0:uxv23WF +"SX#=$rΜa}ʕ6iR}<jv3I9MDF Yflp/Wq+V{}U)y?P)Ϝ2`aOlY=Ĕ$JH{HT+r׮W6fLoΔ`6cCf^Eӭ[%p0ȁoƒtŢ*V˗q}'L=u*Ν:!:vlzxg@V䇜=RHωq.^<le^fώ|;ճdI7/?\)W/1bT!`FV,5lXwpqc_˖Xtέc|8 QBDDŋv+IK/SΔq6lZv"EMP S䪐&0 Jr۽{ "&cʋ\ׯrrR~kݼ\k||4+Xjr֙mxgg;_ϟ.)Z0<<$@ bn͚MIY *uv.=hޏ8U8 Xsp!-aa5ĉa(XM0 >}0E.]ZaJd֬ W92pQam"4Py#رV[vc$ ǝ`J4{06'L)~ĸݹs`Ȑ v#$U!!QM0}XjoCfLphx0,dA`(٢EwSdGVLJɓC;ߎsY_׬M Ç=$XIeKa+C4o^O4/߾}S=2|E !!, >O1{8aܗWӳtZrSyBmXm.&V oun,yUk~ BAHQ3愙)4g$BXICGLIBCc>,937K=1ѽ >eUr%9\IzI=<92;9mٳ#Rnem6b_*R؊'6N3**w/]QBbbl^b01s~z7zLK»(|L)!ʋxgƍkfI1@=hQΔ _1V]؜03pqK1u@)x3R4>tĔ$*=$1mv|8e +38^ qŘrwc=ڵ pGϯ? G,~} lSa~*x W\vPd %gJa+C=˄g$:4ڍ?֭?0<9tL2%Uɔ2p-c^\jӧ؂a`yU} ۜ)˔)?qg lNəR8ԩg|6Ƈ$WD51”6}8aݮi de4/KaL 6:sf 3g 77W/>>7}H΂qS+~ BPhB7n"?Dҭ^<[  oڂ[lIF-8dI7Ry)oL2'<{6pa1ht ^-ݔ(Q 5mZW7iiA=%| 39S yF; n[f%bJ ijb)4=siWLRn`^:puuT ,;X&"_w@ Ut޽TV205&>drb 1%^seWǔFJvzlb4EFsN-T/cJdd44SC8ױo_$Πŋœ)1-ZԫVL^+jN)_gܩ4n\A/x(ZÇĔ$6SV}r GYٳLNr0Ӱz`Œ>46'Li4:bJ녴D51VM3 4㤅 GMa_-ZdUꙔ'XgƔuT rnڴ6؈i:Wi޼,_>} ]8dBB-Y2|c0p¸/bʢE tZrNJ3r(L)mf$]JVСX>wBC֮s'p+`kԌ9a&gJSX/=$1lhB9#/0~|1czѣk'݋y 0аS '+Wʕ/Nã{#CYY%K ٸq-LHE9S6lXX}vasLΔO#$^H{HTcL pWLGdk6Iq̙gwk(O׌ѣtx߾轧\}%{& o݌={8^ |,&=d@@ EL$BW*BȔ±]l<yp9EOZt5c19S)S)Mc. 39S?M愮$$FH{HTcQ6}8aݮi qFPPI3g1c{0&psseoaUqq۷o)Mɔoڴvxx'C5,\8wڰmk֬dW%##tieSX#=$}2]sVLJɓCd\p46g۶Y,r x&T['աC|Ɣ c?f ( VMlѢݻfX +UMޫЀk?YIBiAhiaυ)#tqOJ)ῲz@:!!QM1e{GKʁyΔ/^4Gqw"#G,L9zt/`,bL̐űƍk§`Jiʔ`rJr\$1@4lXE ]sa&gJa/_:u  _}|)){YC')IS;>2S gGY}䁈rwLڵ pklxҥ=bEO{{{-]:N2̔<$Y8'8$a&Qй>}Xf/,SKS"څ#(03 ֩So7#gϞDj̟ $FH{HTcQ6}8aݮi pܾ}SȠc)oL2GA pΜOqƌ!ٳ GjZV~}IU~FU8DtQ6}:$Җߺ\MϏLΔ.;m$] 5kV"$$%!!QM1eFgμq=b: L TR`N-KeL)(9oWWJʀWΟY=PWEh)ױo_L 7E%8#kdm(=}Kŋ} œ)QmU׊z̔}U~ƾƍk5hrȢE ?|NLiĔ$ijb)+տC9cĮ=~qnIr*3_5UY2s,eK OAw2x޿!!QM1g]%ln=˗|}^i˗l%Ĕ$ij?}ʊ\}gۼ3C $FH{HTɔ1%5BCS4 bJkD5!$hĔ$ijBLI,)IՄYSX#=$ 1eɓCwܺcy֜!!QM)L6w廉yr/OYiH;_>|J2eJ k >w|7V˙RxvpY/Tgѡe^ H`p7ٯↃ)3 &DBCc>,95jTHLիCBB I ԩad˕+s܈#J=;W$<)jL"DW$y@+yZΔ+9S9}v!S h9[?_h?1bN؀ 1 (3bb (J)QI`vnwFS,薟}nj~:zt-1%D51ƔLaxŔʀbcVc~aY͒5 $dJk֬W8x;X@|c9S*&%}׌ O-g椻sΔp؛_~>%|/!SYdS"~})?t# gQy{EOϞeQ3qV˙Rxv˖Oz/]ڃ=o(ܡ=iS4Μ.{ .P߿gdXrĔ$XԭMN~k轮D9ze-[`pOɒn{ f`ăۂťЍ֌n-BO.Q#0%cM[ CL paejHH;J NdΘ1?xd˙@(6m@xߝ'Oa|lM/l^<[ . /rٳ 8s9rdHt M>~|/a<8XZ >sfˋGqY.?Ӭxp<\[P/QbJ ijb)4=siW50ƍk5h6-ZÇrkΰ˰TBU\t+3B( ;rd#y0 =R\TT8gJ0H28oLzZnHDD_۶mKvPjQ{}L/$ G[xQP#2=<ŷpơ7եR2;`jJrՁDBCcJ/PXd`nxEӲZ- 8߾_F:Oy "V"(y&MjGLyv`DWyU6*j02hϞe24o@LIb&Ƙҳyf%m Ϛc|Aښa _`$!ѸSLƏ߭[7U䔒sFŋ[R>,M6=r˷fX233kժf/IH4/Ĕ$/B jqXXXXbcct%JHÅ U Y>fX֭BHHD)Il H$R :uT~cǎ͙3$~Z ٗq,ׯ_?5òx}?;bJHPP￯b ~)۶m+W?~||U-;'O.]t?ѣG˗/k~DBLIײzF1bSKVuV)Cj?YPYffĹw f .T$$ZbJ<7nSjagΜ+UW_;v7Obaa㓚3f̰fX>\vmkGBb'BLIֲeKիHIIٸqcvX&XsРANNNy+u̘1nBzHSL>}ĉQӧaK.|O~pYYYќ ;dӦMPkX>c!bJ<X}Rp(K*7 ˷ޤ\=... RkXܹNzHS<{H"wͥ6m{\1vMju=$D)IN=ڨQ\/]˗/s~??>Lh]I>bJѣGRڵ۸qc.U02iҤh+SΡCTDBLh_giӦ_~?9ҹs]vYT?|Ds:W_UT)o2'&&vEW}]3NBBLhjv07?6yH0/nݺu֭[WZ[nw1~H=ΝkrTtRs;bS^|L2*θ9zrcIHR)F$RSS={v\\ܩSߩSZjر#~Ł5Q97h-88_Nh7qʗ(Q"((,3##UVÆ  syƍ-[8pPO8Qn]c={6f̘*}||кIyٲe{D|I6gsP"7o*~Gb 2ȅ J*{ӧOS 7klʕ*θu=1$$y,Ĕv#;wFE!!!K,A,_˗/aaCY1ΔUp]?5!B\p!< Q(ݶm { FsժU;tPe˖իWZ>DO<1rI? ɽgD8eH9so(d24>111՝q#zTqbJM {{QFbbb^1H:#ȃ*rʔ)0dr!B=z4EiXIفʋ9 cڸq/^9Ԁv,c2i7GeE>Nkԩ\|W=fvFTwA҆]>$$y/Ĕp bccanݺUbE0K:[.;DɔIII~~~ΫW27"dʙ3gk (Wfٲe[f.]aޗtS|CIlURRK|K4B*-Zk%DDQm-SEmK4:ۙ;M{|9ssϼ9wf^N˗/ҥKX'\?w#\7/] Jo=ˠ~[KǏgly汯5k0t_z5_|7npt_8S E]dԅ bsM<<<"wbk^f͚H{|xѡCp]r \7L:}˓'ɓ'oBCC6,Z]~W 4`ǎX\7LX;͞=K.JY`` b:u KiJ߿Y_8S /&[|)q3gNh umvaN1c OOO*Dl9s`(___ ^y>}hμwhܿ۽{7V޽{-D7Ѹtͦ2,zԩ+Kp]x®p>>>z:;u;?=VCw@p)-۷o*2ظ԰ 7oL8%J8s kGGGC-[Y'/ݴ&42dfΜǒ\y'rJB T@y֑&,vAeUG̝;ч ANItXӡ,A],q\8tqСCHHê9{ 1rHVJ3&&Z:/\:3 .]*Zt o1o:\^e|] $菨@%/¢D6mtAIؼysr̹0kz֯_߽{w'rJߋ+F:uߟ\F  ëp}\S/^YfG0;) 8{޽m>ܕ2S ˻rqYv?~o߾śMjV"LrJB[nƍkٲeppp]Ql8phѢNNNo;Tҽ{wVo@0/) 3g֭[+ P]Pf BBBW. #VZU;w)طoGBΞ=PtA5x7-kٳg{yy! \)gF 1pcE (DיKDsӍil:H)^$$Z(R$1DHNI)!QHbyn$4)REzsN(kW+W.]R)pȞCb⒚5+:]$D2ρMf:Sw0c۶]ہݻ;65| L/!NSR'98$)$֭9sެXT``_qҩ[b"#CT)7oڵ+1 \~rChn>t\\u۶9ʿ%~G \@ҥN>\}}K@l(NS9)MArJqH)K #{>ܳv%O?|x%ڐ,lDĤΝ-{xq qٳls9ºu5mꎓ'<}z}// /IIN鈔ƔƖD2l>~睜\b=qbz Ln噜wn|]ۡ'tWsn\b4GظhSl'=x!x9xQ;LrJG44$$%ܺuV&?̝;N:KLJJRHJJ+VW^m4** '|ǎ;47c<~|=h:E%1#ρx{,P o`3L//;EChvNHi@(RƗ}wаH/\dʕy\lΜ9=J Z,4BI.Zl/KϞijU݌f&㑐`i\Dh 4X/^<޾e<^z|NS2MR(Rf#GV3پѢE۷._>bR={T.Mr``s boDrr8,[LGW+*e-{GQ-5GԪUǏ] (=6&os8NSRF&98$$  .]ZNe??_Ã? jӭ[ v*TwϾX9hSɒޘ̾Aӗ䔮$D0޸_^!O]"EK}ms}eHN)HrJqH)I э$$Z(R$1DHNI)!QHbzhSCH"9%$D"!ErJHN)"ECԋD REʌѤ~;?6z>+"9eHilLSCHNb¶̃6j|F놽~f&?GQYOyLciB2[ɏ15uR"e.ԙnꖐMG7$72iٔ-S|5SLoN6C\}gٮ^/lt..|9jT4Or(% ݸ -Pg䔂Oc?əMysbݓ'\ƞ= 0`ϞCJcFrJqH)I7G 'fwټݧvL<KrwK1cZ&.;mz gZm.YyY6ӥIL`4V:']읥K'F<.>gb㔔ƌ(R&>9lER6]m ?npN4=CnSf ÇlK[_YZ.oqaƥKLX{>竲OrJ+N{x[=Yq}ԦhBJ=…/Y?;7 ֘?SR!QL$1mﶰā/ xo[5dag,^s=vhh5/w@ ӿDE]GsxV\z۶9Рڵ+!r劣%10f<+W*Uʠ=t(=BѺj|yY=Gc4V:%/ HE%F͜|0jղuk ۷oFaE K)) (R&a/՚vΞ'}g iS uv?cuvۗ-D;NРAu -[IsO?9%Q?~_=eb[BUzJC˗HnG>===~ <Ē11 ׯ5̇IL2Ś7vq{IN)8Idђ%9]Gц#:xSRAHHbnA077ѭ]Ul8%hǫ;w4. [xrbO2=+V*(.P /ˑSΘ1m,z7Ⱦ}8+jӦ>/|8,߷o{׬aտjU(:4f.1c&MvqS0i}kPz9 +B v^䓱HR!DҘED$qͺ/Nԟ//­KdU4Ov聾xxb=P S;^j,Qe>I̙3ه]CZ6U&:u*- Ұa~I &FVЎ$9ӛj~}gѢOVo'P$[#2TIF6sʄh`ppSRAHHb۶^#_7vZ^K/l]0(A cN/E픕+Ƴ% H 7oMua6lѢذhGG+n`\rBSvg)4uiRo9y2QN9m_Zǎ=~V P<ݻ ;%198$$Hn \:!6zmRy>'O~r`ɒs6mU8@^|[ߞ8{wo7on`Eᒗ݈}h DڵFDLr{EHN)N4/Νg{z#fN$ɝ?Hf4]OoSY| v.=mҘREt~~}3^]? +~}M#]}5/Z4O5iob>–-M6B7~0cv>7o^6m_G\kӶmK꥗ԪUPʕoeԦM31JJ59wʔ!ݺի5d; (͋/.LbRRl?7lgkx|"؇&Lbn۵kݻ[Rb()-ƦD jZ:x>zcĈmu_ V)wA:[%'$@ĉcBbG lw6gsvSk׆으3>lozw7z7_~9eiKsE>6CtAoi\kH 1t(R!1cY*?D~ ~ NѸO|RȑUX*:;w`ٷo ڽ0}p~/n߿C΍_yif~?m>= ձ qZ (&f:H9mĈ "c^c"E ~ͧVJcJc Q2Cbmjc5n\_<=>ѣDH İ5B888PI-~\j֬4&'AdVĉ4SFbXOl#GTRaaCf?Z-?f%9 c^cdkj(v7PS[ M",:4H,9$<3⢤~l)1U2l$XHb1s[. 5!aqF5՗ u+iӆ?OW~Daa]m[#߽ߩS#g2k!4m#1|"؇&V3F`nI44@E*nyhP^ oܝ6XڔBUͧ筺,6/~9]ڇ~zM9f)Ii,$1o'tJl$D"!ErJHN)"ECԋD RE$) 98$I Q/S-@rJqHٳDiL0;ܘƦDFqNFהDӍil:H)^$$Z(R$1DHNI)!QHbzhSCHѭ@w,GE*-Ɖ:1]SO7 QHbzhSCH"9%$DJ(_t,7^ﺶ M4M└Dg$D_f2H4ܞ?'ca)͛ƌ̙MrJqHJj׃mԟ? {̙jҤի;rxF}2]dJX{<l8gd>o#sƏ%T*M4u+(QdIoǻkf.mp׮]Id6')!Q\w6E6[ {iLf5^%Qt'ԙ׮ 3MVʕl,^z3sJJ, 98$+[%%-/S{6 1ctСaʥh<ս{K*m_[@^Τʑ`Kl^_/jԨf_ .6s\;vlmݻ͛~6Z&rJu8%8}nZ}!Uɛ77:7nF8#FrF&98$+Bi޼lʥٖNŊ8^,s└'98$3irwHLF6:4|zJ.:i@JS8gSBڴχ’).Z X…/gφ'm؏u=9&f:Q}MX(W=Tm,ђ4S6S.\6̒}}!<~| z6o2|޼5S8%%IN)"Db֪wgܔ[/M~/mF, }޿)A\.m{7Y:f ۮ]Xڟ8Sϩ~1*O'~C$$,0{O^*.whI)Lc"I5cgҥ)20yŊORHS hvJJfsREʙT}.xq Ukoֹs~:)~Ofk9s@,j gfL\E1cGRAYNƙ3M[^C}W^iקO[4pubV }{FKҠNV y,C>EȫS/,ÃsNfybЀNIiLL/)!QI̐L1u3OEToiP2̈́AAmukk,YC:%11$Drr+Dl袸a[CCe5)^z# 11$Dr~{3hdR^RwИNPCrJqH)#`&q YCJckREC%wJ5HN)"ECԋD RE$) 98$I Q/S-@rJqH)^$$Z(R*+odS $D2NIi,)!QL$1TV$!IN)"`]ܥKS]6C>߿ȑ= =vlBeIҘ&98$.lZ" <}ʔ!XԩBeaҘ(NrJqH)]+NW/PYy9hL4&(RWR?wÿ+V4SRKrJqH)W'%-jsahI 0 蔔REʕbglܹ̓ؔ=^(iI 0 蔔REʕbASL HBeK:%11$DrX͛<ؗ\R4&(Rn//N*+op)JcbzHN)"e̤Fah462)!Q%1D#hSCH"9%$D"!ErJHN)"ECԋD RE$) 98$I䔦&1#98$+Kaҥٳ.'Nl|>ojղ}TžѤNIiHiHN)"edyx?./|$JsSjnOiLilUH)$&%h޽%]\َ| ȋ>zt;thXr餤eYi jm ٿJ=}YAHL >v*X0_ϟ;~GR{.ׯB%!1ƔHcAHR,ޕLb4K߸ 8P=Wų8Y9r<-ێ bq^׺2 CV3[ ypݺxY%?YwS {#H 1t(Rp xؗ+-^ܳ!*ao44@EJb.\}wXBBVx]$uQ {VMJqTİqPl ޵k*ao44@Eʕb񮗀WK}9@.iSK$JjeĨۚ%(ƀh&,Ʊ:֔پgWK̦M3۶?b Ua$Ҙil:H)WRމĀ.] 9@>=WPG㨄=^)!hlׅ&Oܤ EPLP {cH 1t(Rץs9s =*v pV4` Yu@>Ӹ` +WbR8bw{Z~?FJcJc Q\/ϙiJXNʾЦ=klG㫩^_۰_ =R4v02#SCHX+T/3#GV2V'N*aiLT(MJc$D3\8tdƌcO% 딖!qREJ!f) 98$I Q/S-@rJqH)^$$Z(R$1DHNI)!QHbzhSCHTb>IN^R(R.JH1?؄L/5*Nkgz9디DNrJqH)W$F>;IhR4&IN)"b{.6IL;ϮY;c_ RL޼k׮tPZ޾ҽ4SRS$M"Jx^leV}EuMq5%m9rwձ]4+KH:%1)t(R[kWTה חO>fwivrѬP6̀?Wkt/!锔ƔfIcAHR,^-1n)1/f}v͂Y>%%)$d0I&%Ҙ8$DrXZbul*kJL˧Y]4;hV ZkгyLU%tJJcJc Q\)<-n#16ՙ\ڵ%R_y}v͂Y~Q]4UR6XI$Ҙil:H)W+OY3U-1ʿ+3Q).ԗw^]໣woP=S/s'$CiLil46$[!k[//Xݾ໣9ۮY=&tJ8$Dr~{}kVTחTݘ4S*REJtTQ]_R}vҰNRKKrJqH)4рS%98$I Q/S-@rJqH)^$$Z(R$1DHNI)!QHbzhSCHTb)oWJNi7WWJN)"ĸXjuk?'={6OO޵kDxV^;/ ~/D޻u΍=JTof2uJJc4&hBH"1n/yK4…/36Nz%K۵kySI )3@rJqH)W$m ی樆ƍࡏ#Z@ڵ{a@9yrQ|6Hxlݻ%Ja?$$,T3p`nsNBji79!Uɛ7wڕpLH 1t(R%9f _~~dTzUʖ-pÀٳg4~Z*z{ܽ{#pݿY\މhN6%% [eAc֬x Ę1}Ο߂3] f'9rwtLH 1t(RN$9f r}~:):qzO,rT\މO#}K%c\r@yцVbK5hάrPyl#1ƔHcAH9S秊h5G?+1%YgH~1=D@<^5̙|`V5Bsz$nj:N79cWia&LM4gk44@EʑĘXk_? j3g֥94Y\O,k׆i^%?:þQR4) "(Ro7~J,L%*V[|/IuMgۧ& 1Hil=H)We[YY,>c^uWlИ4Sfؒ(RK QZZ)ҒRE$) 98$I Q/S-@rJqH)^$$Z(R$1DHNI)!Q %1̍dӬng )c)!Q 1))IV\RRȑ=,@ k׮h^wTz>MuM1Ni44!98$$fmֿvkܽ߱cQz~^Xw^^Ѫng%wJ )!Q\G돷o߀~q\'ؒrxxpDĤ[rxF]ŭ5j/SA/ob^A|d^)Mv_44@Eʹ8/Y@\89m'$GڳgA%ϜX_iu؇^G|dEUѦn/PS[ M"Db,Y@\8N,iS=z8o[P"jSR֭{'K㠬ܮZյm|H 1t(R$FXfqq8Q!:*LիuTT5Z,#ڬx c:X)*>6=Mv_44@EʑĈ,f:ӧJʕ%Kzyi01OActt8wƋf4OQյm|H 1t(R$FXfN;\h!vrVVP!/O] -SѣOR_x cVCNytVx]]VpdEUѦn/PS[ M"JxG9Y3udzgD~ƏW y?S%%=%Sw^OQVx#>2M֒n 1ƔHcAH^,^j;'_.g|0199ѳEGVצwRݰ2)J㧤4$98$Gumzmw q*)IN)"e71>Ymzmw DFJcSCH"9%$D"!ErJHN)"ECԋD RE$) 98$I Q/S-@rJqHٳDiL0;ܘƦE@ g $) @pd.WlIENDB`java-design-patterns-1.16.0/reader-writer-lock/etc/reader-writer-lock.ucls000066400000000000000000000121731312550536300265030ustar00rootroot00000000000000 java-design-patterns-1.16.0/reader-writer-lock/etc/reader-writer-lock.urm.puml000066400000000000000000000026741312550536300273210ustar00rootroot00000000000000@startuml package com.iluwatar.reader.writer.lock { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Reader { - LOGGER : Logger {static} - name : String - readLock : Lock + Reader(name : String, readLock : Lock) + read() + run() } class ReaderWriterLock { - currentReaderCount : int - globalMutex : Set - readerLock : ReadLock - readerMutex : Object - writerLock : WriteLock + ReaderWriterLock() - doesReaderOwnThisLock() : boolean - doesWriterOwnThisLock() : boolean - isLockFree() : boolean + readLock() : Lock - waitUninterruptibly(o : Object) {static} + writeLock() : Lock } -class ReadLock { - ReadLock() + lock() + lockInterruptibly() + newCondition() : Condition + tryLock() : boolean + tryLock(time : long, unit : TimeUnit) : boolean + unlock() } -class WriteLock { - WriteLock() + lock() + lockInterruptibly() + newCondition() : Condition + tryLock() : boolean + tryLock(time : long, unit : TimeUnit) : boolean + unlock() } class Writer { - LOGGER : Logger {static} - name : String - writeLock : Lock + Writer(name : String, writeLock : Lock) + run() + write() } } ReaderWriterLock --> "-readerLock" ReadLock ReadLock --+ ReaderWriterLock WriteLock --+ ReaderWriterLock ReaderWriterLock --> "-writerLock" WriteLock @endumljava-design-patterns-1.16.0/reader-writer-lock/pom.xml000066400000000000000000000037271312550536300226600ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 reader-writer-lock junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/reader-writer-lock/src/000077500000000000000000000000001312550536300221215ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/000077500000000000000000000000001312550536300230455ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/000077500000000000000000000000001312550536300237665ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/000077500000000000000000000000001312550536300245445ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300263745ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/000077500000000000000000000000001312550536300276365ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/000077500000000000000000000000001312550536300311525ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/000077500000000000000000000000001312550536300321025ustar00rootroot00000000000000App.java000066400000000000000000000063411312550536300334120ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import java.util.stream.IntStream; /** * * In a multiple thread applications, the threads may try to synchronize the shared resources * regardless of read or write operation. It leads to a low performance especially in a "read more * write less" system as indeed the read operations are thread-safe to another read operation. *

* Reader writer lock is a synchronization primitive that try to resolve this problem. This pattern * allows concurrent access for read-only operations, while write operations require exclusive * access. This means that multiple threads can read the data in parallel but an exclusive lock is * needed for writing or modifying data. When a writer is writing the data, all other writers or * readers will be blocked until the writer is finished writing. * *

* This example use two mutex to demonstrate the concurrent access of multiple readers and writers. * * * @author hongshuwei@gmail.com */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { ExecutorService executeService = Executors.newFixedThreadPool(10); ReaderWriterLock lock = new ReaderWriterLock(); // Start 5 readers IntStream.range(0, 5) .forEach(i -> executeService.submit(new Reader("Reader " + i, lock.readLock()))); // Start 5 writers IntStream.range(0, 5) .forEach(i -> executeService.submit(new Writer("Writer " + i, lock.writeLock()))); // In the system console, it can see that the read operations are executed concurrently while // write operations are exclusive. executeService.shutdown(); try { executeService.awaitTermination(5, TimeUnit.SECONDS); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown"); } } } Reader.java000066400000000000000000000037451312550536300341010ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.locks.Lock; /** * Reader class, read when it acquired the read lock */ public class Reader implements Runnable { private static final Logger LOGGER = LoggerFactory.getLogger(Reader.class); private Lock readLock; private String name; public Reader(String name, Lock readLock) { this.name = name; this.readLock = readLock; } @Override public void run() { readLock.lock(); try { read(); } catch (InterruptedException e) { e.printStackTrace(); } finally { readLock.unlock(); } } /** * Simulate the read operation * */ public void read() throws InterruptedException { LOGGER.info("{} begin", name); Thread.sleep(250); LOGGER.info("{} finish", name); } } ReaderWriterLock.java000066400000000000000000000155751312550536300361130ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import java.util.HashSet; import java.util.Set; import java.util.concurrent.TimeUnit; import java.util.concurrent.locks.Condition; import java.util.concurrent.locks.Lock; import java.util.concurrent.locks.ReadWriteLock; /** * Class responsible for control the access for reader or writer * * Allows multiple readers to hold the lock at same time, but if any writer holds the lock then * readers wait. If reader holds the lock then writer waits. This lock is not fair. */ public class ReaderWriterLock implements ReadWriteLock { private Object readerMutex = new Object(); private int currentReaderCount; /** * Global mutex is used to indicate that whether reader or writer gets the lock in the moment. *

* 1. When it contains the reference of {@link readerLock}, it means that the lock is acquired by * the reader, another reader can also do the read operation concurrently.
* 2. When it contains the reference of reference of {@link writerLock}, it means that the lock is * acquired by the writer exclusively, no more reader or writer can get the lock. *

* This is the most important field in this class to control the access for reader/writer. */ private Set globalMutex = new HashSet<>(); private ReadLock readerLock = new ReadLock(); private WriteLock writerLock = new WriteLock(); @Override public Lock readLock() { return readerLock; } @Override public Lock writeLock() { return writerLock; } /** * return true when globalMutex hold the reference of writerLock */ private boolean doesWriterOwnThisLock() { return globalMutex.contains(writerLock); } /** * return true when globalMutex hold the reference of readerLock */ private boolean doesReaderOwnThisLock() { return globalMutex.contains(readerLock); } /** * Nobody get the lock when globalMutex contains nothing * */ private boolean isLockFree() { return globalMutex.isEmpty(); } private static void waitUninterruptibly(Object o) { try { o.wait(); } catch (InterruptedException e) { e.printStackTrace(); } } /** * Reader Lock, can be access for more than one reader concurrently if no writer get the lock */ private class ReadLock implements Lock { @Override public void lock() { synchronized (readerMutex) { currentReaderCount++; if (currentReaderCount == 1) { // Try to get the globalMutex lock for the first reader synchronized (globalMutex) { while (true) { // If the no one get the lock or the lock is locked by reader, just set the reference // to the globalMutex to indicate that the lock is locked by Reader. if (isLockFree() || doesReaderOwnThisLock()) { globalMutex.add(this); break; } else { // If lock is acquired by the write, let the thread wait until the writer release // the lock waitUninterruptibly(globalMutex); } } } } } } @Override public void unlock() { synchronized (readerMutex) { currentReaderCount--; // Release the lock only when it is the last reader, it is ensure that the lock is released // when all reader is completely. if (currentReaderCount == 0) { synchronized (globalMutex) { // Notify the waiter, mostly the writer globalMutex.remove(this); globalMutex.notifyAll(); } } } } @Override public void lockInterruptibly() throws InterruptedException { throw new UnsupportedOperationException(); } @Override public boolean tryLock() { throw new UnsupportedOperationException(); } @Override public boolean tryLock(long time, TimeUnit unit) throws InterruptedException { throw new UnsupportedOperationException(); } @Override public Condition newCondition() { throw new UnsupportedOperationException(); } } /** * Writer Lock, can only be accessed by one writer concurrently */ private class WriteLock implements Lock { @Override public void lock() { synchronized (globalMutex) { while (true) { // When there is no one acquired the lock, just put the writeLock reference to the // globalMutex to indicate that the lock is acquired by one writer. // It is ensure that writer can only get the lock when no reader/writer acquired the lock. if (isLockFree()) { globalMutex.add(this); break; } else if (doesWriterOwnThisLock()) { // Wait when other writer get the lock waitUninterruptibly(globalMutex); } else if (doesReaderOwnThisLock()) { // Wait when other reader get the lock waitUninterruptibly(globalMutex); } else { throw new AssertionError("it should never reach here"); } } } } @Override public void unlock() { synchronized (globalMutex) { globalMutex.remove(this); // Notify the waiter, other writer or reader globalMutex.notifyAll(); } } @Override public void lockInterruptibly() throws InterruptedException { throw new UnsupportedOperationException(); } @Override public boolean tryLock() { throw new UnsupportedOperationException(); } @Override public boolean tryLock(long time, TimeUnit unit) throws InterruptedException { throw new UnsupportedOperationException(); } @Override public Condition newCondition() { throw new UnsupportedOperationException(); } } } Writer.java000066400000000000000000000037531312550536300341520ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.locks.Lock; /** * Writer class, write when it acquired the write lock */ public class Writer implements Runnable { private static final Logger LOGGER = LoggerFactory.getLogger(Writer.class); private Lock writeLock; private String name; public Writer(String name, Lock writeLock) { this.name = name; this.writeLock = writeLock; } @Override public void run() { writeLock.lock(); try { write(); } catch (InterruptedException e) { e.printStackTrace(); } finally { writeLock.unlock(); } } /** * Simulate the write operation */ public void write() throws InterruptedException { LOGGER.info("{} begin", name); Thread.sleep(250); LOGGER.info("{} finish", name); } } java-design-patterns-1.16.0/reader-writer-lock/src/test/000077500000000000000000000000001312550536300231005ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/000077500000000000000000000000001312550536300240215ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/000077500000000000000000000000001312550536300245775ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300264275ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/000077500000000000000000000000001312550536300276715ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/000077500000000000000000000000001312550536300312055ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/000077500000000000000000000000001312550536300321355ustar00rootroot00000000000000AppTest.java000066400000000000000000000025221312550536300343020ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import org.junit.Test; /** * Application test */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } ReaderAndWriterTest.java000066400000000000000000000074121312550536300366070ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import com.iluwatar.reader.writer.lock.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import static org.junit.Assert.assertTrue; /** * @author hongshuwei@gmail.com */ public class ReaderAndWriterTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } private static final Logger LOGGER = LoggerFactory.getLogger(ReaderAndWriterTest.class); /** * Verify reader and writer can only get the lock to read and write orderly */ @Test public void testReadAndWrite() throws Exception { ReaderWriterLock lock = new ReaderWriterLock(); Reader reader1 = new Reader("Reader 1", lock.readLock()); Writer writer1 = new Writer("Writer 1", lock.writeLock()); ExecutorService executeService = Executors.newFixedThreadPool(2); executeService.submit(reader1); // Let reader1 execute first Thread.sleep(150); executeService.submit(writer1); executeService.shutdown(); try { executeService.awaitTermination(10, TimeUnit.SECONDS); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown", e); } assertTrue(appender.logContains("Reader 1 begin")); assertTrue(appender.logContains("Reader 1 finish")); assertTrue(appender.logContains("Writer 1 begin")); assertTrue(appender.logContains("Writer 1 finish")); } /** * Verify reader and writer can only get the lock to read and write orderly */ @Test public void testWriteAndRead() throws Exception { ExecutorService executeService = Executors.newFixedThreadPool(2); ReaderWriterLock lock = new ReaderWriterLock(); Reader reader1 = new Reader("Reader 1", lock.readLock()); Writer writer1 = new Writer("Writer 1", lock.writeLock()); executeService.submit(writer1); // Let writer1 execute first Thread.sleep(150); executeService.submit(reader1); executeService.shutdown(); try { executeService.awaitTermination(10, TimeUnit.SECONDS); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown", e); } assertTrue(appender.logContains("Writer 1 begin")); assertTrue(appender.logContains("Writer 1 finish")); assertTrue(appender.logContains("Reader 1 begin")); assertTrue(appender.logContains("Reader 1 finish")); } } ReaderTest.java000066400000000000000000000057061312550536300347730ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import com.iluwatar.reader.writer.lock.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import static junit.framework.TestCase.assertTrue; import static org.mockito.Mockito.spy; /** * @author hongshuwei@gmail.com */ public class ReaderTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Reader.class); } @After public void tearDown() { appender.stop(); } private static final Logger LOGGER = LoggerFactory.getLogger(ReaderTest.class); /** * Verify that multiple readers can get the read lock concurrently */ @Test public void testRead() throws Exception { ExecutorService executeService = Executors.newFixedThreadPool(2); ReaderWriterLock lock = new ReaderWriterLock(); Reader reader1 = spy(new Reader("Reader 1", lock.readLock())); Reader reader2 = spy(new Reader("Reader 2", lock.readLock())); executeService.submit(reader1); Thread.sleep(150); executeService.submit(reader2); executeService.shutdown(); try { executeService.awaitTermination(10, TimeUnit.SECONDS); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown", e); } // Read operation will hold the read lock 250 milliseconds, so here we prove that multiple reads // can be performed in the same time. assertTrue(appender.logContains("Reader 1 begin")); assertTrue(appender.logContains("Reader 2 begin")); assertTrue(appender.logContains("Reader 1 finish")); assertTrue(appender.logContains("Reader 2 finish")); } } WriterTest.java000066400000000000000000000060361312550536300350420ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock; import com.iluwatar.reader.writer.lock.utils.InMemoryAppender; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.TimeUnit; import static org.junit.Assert.assertTrue; import static org.mockito.Mockito.spy; /** * @author hongshuwei@gmail.com */ public class WriterTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(Writer.class); } @After public void tearDown() { appender.stop(); } private static final Logger LOGGER = LoggerFactory.getLogger(WriterTest.class); /** * Verify that multiple writers will get the lock in order. */ @Test public void testWrite() throws Exception { ExecutorService executeService = Executors.newFixedThreadPool(2); ReaderWriterLock lock = new ReaderWriterLock(); Writer writer1 = spy(new Writer("Writer 1", lock.writeLock())); Writer writer2 = spy(new Writer("Writer 2", lock.writeLock())); executeService.submit(writer1); // Let write1 execute first Thread.sleep(150); executeService.submit(writer2); executeService.shutdown(); try { executeService.awaitTermination(10, TimeUnit.SECONDS); } catch (InterruptedException e) { LOGGER.error("Error waiting for ExecutorService shutdown", e); } // Write operation will hold the write lock 250 milliseconds, so here we verify that when two // writer execute concurrently, the second writer can only writes only when the first one is // finished. assertTrue(appender.logContains("Writer 1 begin")); assertTrue(appender.logContains("Writer 1 finish")); assertTrue(appender.logContains("Writer 2 begin")); assertTrue(appender.logContains("Writer 2 finish")); } } java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/utils/000077500000000000000000000000001312550536300332755ustar00rootroot00000000000000InMemoryAppender.java000066400000000000000000000037761312550536300373140ustar00rootroot00000000000000java-design-patterns-1.16.0/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/utils/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.reader.writer.lock.utils; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; /** * InMemory Log Appender Util. */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender(Class clazz) { ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this); start(); } public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getFormattedMessage().equals(message)); } } java-design-patterns-1.16.0/repository/000077500000000000000000000000001312550536300200475ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/README.md000066400000000000000000000023621312550536300213310ustar00rootroot00000000000000--- layout: pattern title: Repository folder: repository permalink: /patterns/repository/ pumlid: JSV13OCm30NGLM00udktCS42eyI9xE-YRjyUUtjlLQij3qblomNCU14vF-LKNBbdYDTX44EfevEsV1ZiTFERjqD2Jzic0-8Mr3b-89SvGZ7yGuBwrvBUoypUlW00 categories: Persistence Tier tags: - Java - Difficulty-Intermediate - Spring --- ## Intent Repository layer is added between the domain and data mapping layers to isolate domain objects from details of the database access code and to minimize scattering and duplication of query code. The Repository pattern is especially useful in systems where number of domain classes is large or heavy querying is utilized. ![alt text](./etc/repository.png "Repository") ## Applicability Use the Repository pattern when * the number of domain objects is large * you want to avoid duplication of query code * you want to keep the database querying code in single place * you have multiple data sources ## Real world examples * [Spring Data](http://projects.spring.io/spring-data/) ## Credits * [Don’t use DAO, use Repository](http://thinkinginobjects.com/2012/08/26/dont-use-dao-use-repository/) * [Advanced Spring Data JPA - Specifications and Querydsl](https://spring.io/blog/2011/04/26/advanced-spring-data-jpa-specifications-and-querydsl/) java-design-patterns-1.16.0/repository/etc/000077500000000000000000000000001312550536300206225ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/etc/repository.png000066400000000000000000001537261312550536300235650ustar00rootroot00000000000000PNG  IHDR~#2םIDATx xLWސĒ I*ĒUA,VKe%XD*!hmvZA-i;Lf~3Ϲ93ssN)!B!ĸ(B!BZ>!B!,tRU݋B!) Padg%B!oA'B!|#Z>!B ߹6:hB!25[EX\>{Iի3Gٹ_o-B!D>ڶm3l~.2(Y%0ĂO!"CcwGD[Dž Z2i4'V#Flzt-ҰyO=KEɏ>૯>XL={65ְiӌV\ouT\JfgnQ~// /MK&-B!肒-[fYxܓ'g[ݻ99ߚ+feXYUysbR@]\[`y49REҞI'B!ŎIIYв}ghTgϲMZ^ի(*..rb"~q)H9H-_c OfM<|菠9(%xQ3iB!DG۷Du^j~1sŊ׮Kʖ5y83&fZvtE% ډgA{n׿uAK5矙*%zjyykn܅f@jDEdeDטI'B!Cw!B y !Bdk`gݽ B9zo|B!br?b`"n*%3S+Z>!B 1hˇ7 YhWKw/]:!**pƌoU IIB|B!b!1J4oO_|rҿyYɺ@3Y#9dH훞=V\nZgۻ*:z36333mq)U>y󆖖[7U":n4ɾjU u|B!c1DzAYkѶsF1zO׍D[1e4Zݻ-[b3(x&~5en؅t eʔ.__۷ϭXk]3f 5OrLmFӧYجTɬZ5=jAo-B!D7 xgĞ?2H4 |W0f!U,fM*U,󟸔Hk2샋Cʟ<9(,޽޽Mf"ݫW_~نBll 矿ٟamۦCVcs#Wo-B!D{F zw`ۗ={Pc}WW\~ *Vf-W_lwu7.% ˷4Oċ>$0xyb;Ϟe ZBڲe66 O!"s ?Y:U#>TOypwઑ={SKK6uj߾moo_C*y޽YX @M30(ǁOomm%vm6O!B õCdz&|!gڙ{Ⱦ+a=v-hC&ȑ5tagL;vlݟf~VV˕3Am'oT7B!p-e>1MM9k|<"gŰ3WpARԴܤI&Ne:vl۷؁QKj.66h1v7Ů6m~Y|B!b wc_ bFk|ġC֭W>hvr#.wrGYϞmōtW 'IZ>!B1@ &q u z ]SNR<~yRk|B!X>(A'B!|#Z>!B y !Bd-ȃO!"ChF|B!B7B!Z-B!DϚ8ؠ)S|_;w/R !BdZG2h'O֭ۯHA'B!:'OӮѵ=#//^fd,Cy{boFo/_> Zt=p J!9y̙ OH> hDoG_vNFxz6z5wv]lܸ.D&`ccv۷wڶm.S^ݻ#J9~ep=_i5%er_ѩSqm4}d^S_jzyphK۷=-B!X~tC qt|TTGkR6ĦM3@"..aC;$]:dH+v3|GG[$&O'G8l2{ϝڠ:S6n +YAKF|;wDZۼygϲZx*Of9s>AHKQDs碏?ĴiCJiB!'Ln]9lXwi/fz_H;{- aG0#z:6|JʠAty`lPX:\űDƍ^n5bOz޸p!QKÚ<ٹ1|B!Rttb}Ǐ4i6}Oʕ?΄7X8l F?ܺu'Ohᄸw/ˆ/ k{Hl# -d"')iޘ1: 7G=VEY]3f .~0kֈ; !BHщb{hӡû٫CvĻ:h~ֶ߸š[Vu(]гg[$ϗOB=:pn:3g~KlRΟf~iwOVM];&Mm>W,T^m4C,9N^^\I)W7 !BH{el>{ʵݹ2Ofݻk׸K{kɓ_z#hy^Mi۶iR !BdIӠb*o6{.Q|B!Bs;#UUfvT] ˴-B!D[9 ֭̈/u…"}o`VVEfF2''{$"#Ƿo\d^=%hB!2%,b`0QO? ZRgܸ~fժǎK=rdM!̓'-B!DK%X 7ly)˟1cxǎ-D:7wGҥI W(Y~\\t ZB!Ȑ>%l?q"y{,ϞׯTkRo%LyOf5j"|uGy %/&iӔO'B!uVYӺO%˷JMP|e[Qffj?{vKAbk[[V Z>!Bog{Ǐ3oإ̅ ii"yL&zi Z>!B щ:ϰ>޾Fr|7`O!"C^KG\v99CZ>!B y]-QȠB!Z-B!D!B y-Ν 7ÐO!"C^WOKtpQjժ͚9?+Oʿ+àB!Ȑ+WJO_ӧY'*<اR87w۬B!Ȑ'i̘UX:8יi4wpTzd?zB񔌌e..>>ׯGIǛ;p௜Ǐ3"ثW[zjݻl`Nޫ_6iidBl֬i>];7{9-B!|t21§sgwd9?zt[y{z6%K.7kmmA?vl׮Vdz|};OԿ`s*qƌe˚/ @U"xWde41)Ir|DժY&&:hgWC^N'B!EʡnVVE:#c=wlTG6"bsQT?׮-E"]QQ-Z8ቈg8:jiҡCnj /HWdgCS|FFFo߾\z -B!/aQ -_#kׯijgӦ E~UZtV6$NH7j6|!sҥ$}4Դʖ/ڠb 8Pd!B #\IYvzdxqO# Z>!B y !Bd-ȃO!"ChF|B!B7B!Z-B!DI{3J,hB!2DF`SFժU-5s<~ѣ%5B!X>¹;b Z>!B )8sȐ.k69?ӭ[+ȑ5ݻF:uz~}zРNcRĉάLst57/ߤIÇsz(١û'xx4^_<%#cqNBxiEWxڻw6Ȅ9جY:<|TvnzWyZ>!BQx,ӦZ޸ԩJΞݒٹ nܸ.٫LL}<&]La;FΜ=֭o==#%K.Qرu0_#_]`̹s[9ceMP_*yn+WRVJmHT[ebb^] <-B!(SXoPٛ04ڍ@NAh+"wsr6*#1VԀffvm)q슊 l OD`uhU:z̘h*]+@bGmʖ7WOB!C%,b`0Q>͚!B14^ꖟqǏ3SRz!͒o:[ $˗Z蘘i o+ +T|tfqr2 OH樜M!B14^\E=];73  ?>BKG:.ų||li.. ͚5O?C#dsr^kkFb%d_ wDt6ŪFX??o>-B!D!B y !Bd-ȃO!"ChF|B!B7B!|g Ӈm0hB!2@-ODk<اv~ !BdHY~L4GG[sM;|8Zd&$quuY:<|Tvn"3#c;EQRm99;tx'i̘UX'b٫W[^Z|B!"Q<L<ѵn}mV211ԩ877G;ȼv-R%ؠǍ'jX` KJW`PLa(?bOȼ}{7Z{JʳgzhZ>!B )r{7='g#wEDuvtd훋WOآ#ΞhpʖoeUQdfd,srWZ>!BKX`ã?{=mPxyUZt.70p(pzaS17/bR\9~ڴ|Z>!BKXTRcb5h`޾}nÆvHŅkAI'/'kF+h|B!R8^\Eꖿpn'}|<}.7o0KO_rbR6Me ѵ|wveGzϞ_nSrWݡ ?hB!2xˇp7mZšAYFTX GGOncc-]xdstuu8x+immQxرEٲ& Z>!BQ8ƮO "EzM]OD"?ݡ ?hB!2Du~upQ5]ye|B!߾r%e鑑yiO!"Ctk -B!D!B y !BdtRU݋B!7(sB!oA'B!|#Z>!B y5W~e?yP"|B!*~#~AB[zWj Z>!B yuW仛7w*!,-j̛7d,vܸ~?.]8SVmhA'B!iwOW\iEV؜CtC#"ݪ -hB!2xQ|D WDF2KKsw":uz~x 4{k~3,lx.X'x{r%9'O4Ә1Tpuu8q"VrOM鼼ު-B!D'.*e/ o*[>l;!aNr&׮"*U2 yܸ~(ĤLP'7mѪNCɳg\haafԋmO9|8LPψ>;V)ٶm.|B!R(;~p'WGe-BJ5|'Y>~1c8[p{7wton^^<;II>܏@…b/jXUE˗VPnWBbmPA'B!/o؊# T.#,?3sʼng?zt@O:B_z).]Jׯ_[x4kVXD߿8/:X~zDΑ#kq8lODmzk Z>!B yw Mg_w&6n'%k߾yrgٰ DN^^qfJ;QQ3f ر؛t򥅁d/&am|~گXڠO!"C^l?6`Gl"00;zt-ұAu<9lSڵsC&Cwazs99> kmEuꖏ\ҵknڠB !=AߝB1^lgyD 3$|g}YG,Y2^^-WWR_/YǙݺnccݩ{#3<|iZo@Ϟݢ=z<9x.-vl q&(]c&{!/ήƶIMfjSqXchz m1QC|xoM? ~WL%p;K| ^beKW{В)BґgϲMZ^իrwЄ9^^TL QFH?'YԩC`$AK`o)| :A5V|Xdp<o(1B]Gx8hldk )i&a) j1QC|xuW߾T aiin޼%3CbHKtpQjժ͚9?+ xc$Iz(p.]8S3x ʁQ:W-g+>_v:2ae˚3Aܠȿ@g(~\.HUbRHSВC2ڷ˗a?85nɒ "0feċK޿?Jڥ1$C]G.LQFAݤP|5<}5y`kk+|^=GaaBCqZtӧ+Ws"]OO99 y~#/Ec1*  x#䁴~$dk@|t;QQ9!D>;*h޼SΡ|ZTН0]PTꀎ-'ipYFTXA:=ٷo=ڈb"[~ǎ-`?9KLǣ{ghFppA7ndkcy`ccaE7S(;~p'WGe-BJ55"1Pav_WZYSPo}"/'WjCVBQB* z㥫W %p U@h}'~V\ڵTEmqP?$P[bbXŊe#oT6mJTXb\p"w߭ NAaCoD B[YQv r_d*)Ρ>̴V7 2]&Dk ''eMPRG6l)|+I~~2XQ޽J7T{heUQڥ gp Cz mpb۷VkД $R Ρu%kan0rN^^_rd…ĴH޼y&"=wO8ƍ*ofp Cz mpbN;i"YIgϲ[nۋ3ll<_Z5x_\jŤa/|uiyX8cm  i2tr:/!Ĉy_28q"63sEyJڵ##li~wR@3xڥC{gD~H#*%3SCjo_,m[!B]G4y{{-4rfcpbļru~6/ ޷aű 9"FUDlYRcbRZ.Hl)%ASJ K~"7wǏ&r:B M^ ?0sH7 |~ڬ.E %.gċ*կ51|#9u{7:\Oyb/H/]:Aa3)i,r_}aJ -(66hOˡAo!$yڶ[ۛucW';Lj">wnGU=p@%v}iffcUXK]/*TU!Ĉya宻<,kڿSgLHCDyDv0gkU!q1kl~g϶+W[ٟ={۷w;;97;:z36 4k8~|e!ռyCKK֭KEE=a6prLJ=j$^XϴT$4 Zޘ?{/klCVH)ޟFކhMmy}lfgw޼، eo/ITѡEb3UJ5ef]/10v7+T0]`sL/x=k)zPY-*Bd-C3+wCoD]ΈQoET^MoAA@4;4(s;6d@8*V{ >$j2ʙ8:">qhlVdVemtlb %,ϞP䌌eӦ &Z_hlB2-Z8.LtڵfrDG}:~کZjSy[>6rb1:_+r:Be_9vḨk{w'!윅 84^ at`h)) lC*WcSw3Co,]/\k -qwo-N׫WkOwiy7ޭ<ղrUn( ^sb<0r=n@^kuFןa}1Z|֬i]t)@];7Ema!ĐrqYQlo4^6Fll|@>>klB/ٶmSߖZȿ*}E{TN/^P;`WL460$-WrիH Ԧ\R^% c٠謵uy"Fo麑~+0p׮-EA'Mpze[PSPplB} ?|G[t  LMˡt}W_-+W %:G !FA[ÇoV<1ia/ʹ|_;q BԖ$xŨˇֶ4۷o">n\?KIBe,-89هKL C(Tս፵%l{ذnbSX>> HIpk& A<ZkiFA-WlZjSy[X ''g_ GFe5 xgĞ?2H4 |W0f!U,QϞm#GDӲ-xё?|9Y ~ zۻW|Ӧ[8R -KtB=XCaԮUG DN~!c.ܸlPs0̐ ]wU!vnPq9H#1Gܺe͎e RD~ݺڷo.Źs[HފNݻH@&>鑖~ ҃ѽŇصm\uI(8VZ$Yp + -(劂-_KmoKtq3 ^R;9=ZXw(q˱侫Fw~.p"p%K&狚hYY’[a,_MskԨ*HHW{7,9j1zJ-?'gScK r_zG8|`n^{[ȇM#k+T^Z"̙iǎ~ieU\9v|Feџgyu.Q˿u7|.'$\fVJgd,+mZQPKRۂs' + P#% d]`VTOypwઑ={S ^}jԨKN*4iG*[|??oV/M:5MLt."(_bWAʧ Zsb'$quuY:<|pKKsL+ׯDN^m<6%s5zֶz@@_Ub.@@vwwb qʕ+y{r%9'O4Ә1T@ O` 9Ek;NݣuXMث\ G,z\21qǥV(v@>4 Z` jڴi*J~iwq[";v=u*&I% ٳ? --W#|w MmѣGѰND]G Cdz&|!g޽:?-aث~YݻTE8ۯ_{䄆iYԃ*U= c=>/2o|nHZV -KtBZEB:,EB}s[UĤpss{~ڵT̳ЂǍȿ~,[X>f.La_K\q_D۶M!H@2p8Bٚ5S/^L۷gs1w)S:8xٽea/*?Ò&w$!GE Сu^4ל…NNDGٳ".X.DKY>KK}m& ˁXEko+̙*zAi[_c`bRFj{{I>BL\7泩I3g휏G|7fhe sݻZB~ղ-ߎ` .t72]]1^J%ղQ^rbƎ?aQYJ7իi ltٳ[Ą~nX<7"b| q/M΁#:beUQdfd, [P20g]Z:?NވǨyz.P~}Ɵz8ҥ$}*M#[(ʇS|!_Wrȡ*:ͳDz{0<"WN# o}wS RBѷoH{zwŖ͂qc[wDa(70pH<^HԩC0U^E |ث[ #deyPT߸q"4Z[M#k?g56(C3x-_>lK .4o*9vQ :t2Zr.>6ؽ{oVqp7otCo2D{pbļk=4~lI1Dr7wYX/iTH3|GU䛴s!妦^}Xa'NBO{{˯\ҵk!)ׯ8Ǐ3!sr6>}רۊ-_c20DP/ 9v!Ad\G !F̋-X,aBv Ac/2UEGOncc-]!dh76]]JdvآlYtUZԬiݧχ{x4X&0x+⿨VnlffZP|qF/g+W;6,,:.0^WHQCSo߶[o~BSJ "Ezw?R^?TWI gX eo_#9y~ѧgϲ[nۑnŤbt` iW{t!p68j1bW\IYvzd58hFN`~/0DW^"G !FLY>0V}zK7.cIץb:qDZASr%w-^B]pb<իF%u<98bOvnpܣG>|菼{j+n4Om'aW˖DI5$'ϟ9Sa* sG)G|}n}ԯ_[\EՔ޽uڲqw.k߾[e׶msјzj޽XQ/ѦOݮڞ=~;Z<;WtT\6Mtyׯ^^:Z%rm_򽝼,>s!Ĉyʮ{TDGO: OGEΟ?zԨؼv-iHl4kEo5lh޽K "ՠ|>RXɓGQ91[s6hNIwm kWnwyϞecU>REs| (ii8hv\6m(^z;)<:D\! #oqTLݺ isذn_._Ǎ%8vl]h3~ ޺uv4_2hP'FdP+Y:T->ZcbpK_͛%07.\HT|f:Owv#~Z" yQCc[}j6 ^2]755߿?& \Ǚ9|!(Z,F?SQr֍<9آ޽t,2@ 99aH(H.BIJ7f߫K#GyPW<ȑ55cp^^f88({A!9j1bJO$b(oq )6`)y~}媴ܠB3xt]t??o|C#W "O}E>oVWTn‏|؆8ȗ="n%3OB1vMGbOwI-QO?ljdZ]w{`ӧ۴iڧχXr8+/5@Cʕ3 :D\! #D-S0"Oh|̆bׅ<"b+<.C%_JPyy* I{aXB#֮qSDZxگ2_z#hy^Mi۶i]Dȡ" yQCS*G+W„9QXLcRS'&VQcfMQOEV5/1yL7>4|PI5B3]lZzfޥ:Co%0BV #?1uQN.K}PߋYU+7v:Wٳ[]KE"66(7wogqۻoߞMX UZ|u8Kɕ\q__haafԋmG)S:8xe]j,077G;R%F!H,X0Ţ">胯\Q+v jfpZҕLȡ‡9j1b e]cꨬEH`S@BtRҼ#آݻHzRkݺ$"bp˗!"S/\,Ҩ~XUEJS-+W~!mbw/vznܥ(klfp Cz 2(2G !F̋-?n9&2<}5y`kk+KKѣ?O:ܼ|Ut)I'LWTRrf ;U-߿, [˗{Țk?o|@"ʖfj[Ņb^Q$r 99vA$!Ĉyw Mg_w&6\&//]g,IGE&%͓N+O?{n.s߰!DŋIX-L?c[tnҥKݹfP|XTll~ŊϕE޽)n(klfp Cz mpbļk=4~lI1Dr)ڹšp_X>ѵ|vv#LԴիϿ*,ĉXPoV+W\ڵTߖ4V"ЛiVH_Fo+W|G3ӗ`ЦMSewssUHfMު&(rC 9X_WJdAlyK58lWHΐ!Hx,ErwnlmXw%K&Į;([,c'2r|ժ>}>\ãoa۷Lkz}E_yKVVH[[[ mߣGuE~[nh!!ޮ#T-\b۷VkД $؃ǽɞ<9x.b­?3UnjaCȀ+W "EzX<ƍ/0GQoE)xːUȡ"G !FLa}:=nݺn/b=gX eo_#9yo$O%r)( r:HQCS}RqDlf抢sJڵ##l9ׯU_ nh]CoD Bõ|Ffp^RL)_QJZfpv]9vlژ#oQJî!ޮ#8d51|#9 r:HQCC7 ή!ޮ#8d51ou[XP;w2T]fw۷w2T:ѤǐCo/3_{Ov{{;oQ!ĈуO>ѣ׮+V|./_>ǣ7n\~y`_.?~7--FUZ4kxxr#K*kru0hPB}?u,~R%3D*ڹfO)ޮq8n%vv5r:7GD Cwh d_UE B'O@=իW|9Y҅l2Ho1Vy/trJK~4kѢ5R87wG Eru*>_壷>3gg͛7%бG|([6ܹHw}[=uZS+h)ʡ}ſb!]g*zpb'$quuY:<|Tvn"3#c};ӫW[ 3{{'&fyy9yr=&>QE?zBrOM鼼ު&,yԴ܁Q&P|lQj޽k8Ԓ1cz%x'NjyruыJ.WXz mk[= #vqHʕ_̽{QX~IX]Z<]Ͱ Da]yr:_ ESZ_.BOTKpb'.*e/{ϝZebbةSqnnvvg[MJfA|};O?Pۿ ߈_̙xѣkoӳ92"1x? ;DT>sٶmS Ax-kC|ejŤFfe41)Ir| ZRLa8ֈ>;Ba/J׽{7}J]_5!ʖ?{gpuiӌw?do/2Uk ʕ3AS56;{]Z޸ @ɳg\haafԋm/'͓aoEbG/ (>C`t 4R }cZFUQ!ZxB XWƫg!0Ǝ?aQYJ7iLB[pE!ɍPvrYZz(=(VeDXg:36&1~|][4Sx˗af0tUCVcE\HfpQLY*Jӷ}A!ft]WhnXdO*[~oYE|6߿[#FeCv]wl$TvM#(hPn6)i0䠵)OAp5͓ao/TVx(L4>;D_Q)'7VSЀ.]Ƃ_>rdxb_(D?#!Ŗ͂qc[wDa(70pH<^ԩC0 it)I.`敼ٳiӆbSZtlDy8cnm|lhi|/[6qbmP½d:hf8 㫱 x4 X[[ay0zG}>?(X;NcduK.%O})PYԀjؒ͛gb@I}LbziA4Ĥ'fʕ+VxOL̴ ~q۷mN纺h<b|(_9\JY!%mh| !0*4YwqwÆĶms==s Z~ *I [܀ <̔BGر؛tjl {(RY/ ( WdL- : b5-Hxቪb B[~Ə >)?&T-,ӗ@5ڴi*Tz nl`룆e&V`*'oVS,{{tlTklrkLXQQrr6{BB9TZN)RY/ (&FFIEcK, }_ch|_WnDUG !F̋-X,aBv Ac/2Uֶ4Qbf\MWWʖ5ٿ?J8]'=[69t֬g\j"BW!HiH0L ctsq"AL.B32Ei<̈B.1$Rq9tR:y}^^{{w^x!{*kήwFfSC'`4>,,L76pA(# UvneGWPR70Й8c>3jNM\^l2ԓ-P9#>dZVUU12j]f7(תsx e}D2'1~ۏʕȜ3gR(_4qď45$KosKzHP?X)pV\ZZ8K< V&fp *]͸;tLL.T)HY| WVɯ_g+9';'d,\v`K9dV/_|_/}q+ç>Cey $eQ}{Mp3m(I<MTՠ!XI;~5{kquÅ) `.gzkj2TmWT4`PK # Wֆsr̞)x]i)WճVO{-ʵ=r,-M)^X\e#!DIUcUX{ǹYY{k(=?5np6٧f`T=+çT߆6\\Ut֐H |r2\KfVO{-IaN" A^)0jе=QEg "Wp+>dfeג$RZYC")p.Y>$:t֐H ,|2\KfVO{-N"55$(_ Wp蒙^KHiMg Rp/-|X\VRQۭ++qF$O? UOō VuM˖M)P/uoٲh…($ 1t)Ϡ/OQYYV5"\ffu7]I$;ECeI$VR7 QݻGyy1ӦB߶mkˈoGVLLPXO5Q>DjzɓZlȑwP ^tTI$R5T3_VnFC!!_͖̌f&?~Z=_8;jj-@D{L1k8MMݼyήκuޕ;9&' s**OMK _.'6{x8a׮"rAVVfO9 :mXfII6YD[۞3<ǯtfq"B 9ㅅIl(šc5Xו(D"58?իW4rZUT=J׳>DB|z0ʕ[^~d$ N: Ş<n L<]_c a ?gظq#PЫWg `zN7*Ln#f͚ |Q ִipР&M@@#myam6qq!Ss= b GbZ/۹sQU& ݺuѭ[qꪻv-Opuu`5?bt Q>DjXz!.8yAA??55UCC枫'vTq EcbbZhAGD"IL?:zG켣wDdG"YMH #'"baOÀ~м@?IWW@Q>Oʆى kkIG`i1VIlD@3?_~8K.3gch)_C ,,LЗeرO۶}-b,$J"ݔZ>r"q/S^::mڨ͙3d4p3; xԑWTYt: `mffctʊdhsb4X>wAbϟ .\8e^O~~n8

b2;w.4|pŋ kVQi~^›(:O>yH.BN΢-NoA O$*..UrN̠E lͧ|Ξ.ކĞ~gB5yy1ف\nn4%Wb<(D"5,qsеkԺwk,Ҭs?{nѢŹstTI$һnʟ.#$50$%04% -S/SV476541C7aNJ::o֬iff9Po~]--ͺu3Yb&pŋ _Y[vv3264hX8[5x ِ3wKF+`=::>øq= bd_~H凇R`ďI$Rɓ/_DzzoHwWOQs+Ծ}vMGD"ILOoi$$(˗'>MysMPXпJ8+ݑSRgJpu+.-- @cbDڪί_g1RM(D"Ս>|5kVvN<)>$  zbG555X+WqTݻ'I$Ro_ޤD 2h̠Anߎ:_04 :T/1q 0*??A,n|T7z՘1cp`55\yG׀ueUdvT/_5hР>@D"U:ۺwnntVVdYX{썟pQQ {=4Q>D5駟_iEf_"}ˎjEEE@@ٳg DRp'HfPPSޱ(n*@H$RQ(D"ժà?Q^]v[nwdJ"H|7Q>D%/X4//Oޱ(/\{yB"ꋈD$6T\\zHޱ֪UN:%@H$RQ(D"ո^ڹs9s攕;ҿ.@H$%/.N+)ɐ; ]Z1-D$fsNyB[nYZZzxx|RޱH$yJlWN!nffާKrgbf?? ^<9jGeeY"k+ /ߵI$R jպ$M/^puuݻ)XH$Tהi4m:=}#2˳ׯ15Փ/3L6cb|k+ /G;D$F>ښl(Zn]vDjYeeef`:ކefdl4kFmX? ubԩV,+--/\䓁,]c Bҥh#>ڵٳ;L墩ssJZjnn֢w.D{Qr֬q(9|x764Yλ`''0.)..NCֶgff8^b~8 a].%4|TӧҰtĉۯYFށH$9HVʟyMS_{am6qq!W췱171y;Ar֪GN'O~FCIg/YÆݰ?~`UeeEىAսzuF̙M6<1q йI3P̙cGEkb/~3D&J6nQ<'gP4Sbx02SCX# $֮n"!1lnqrwHYA#'HMgΜ w ֮/^w,$N%収;H}Yzǎ X#"oi:|!ssc؝-l2ijLF+n2 4#>j@IUUVrIG`i7VI D--u;n?T>,Hz]vikkOT}zxx͛D"՝M?us('G`*pd|y/%Kwuu59߹0u!!;W)-wځ|w3KNG>Z0a4JX;g,ݣGGT(1,Hz7ox{{TڴiNJJ!HuwS~ǠD0/g ir8GG1WElJwnQ>1GE-_!|'iƏ!2rXY|BSxQ>DzСC^\\,XH5,==+W;Tz7q@EdLyH˖*w$'Ljee& [͞Vcu,_Yxm۶~ gnGMEE)/H$~ر u~3ٳgD"ծM3VEx"ae*2EܹXPә߸qZ ,O27k4//maa4۲SӦ:#gѢ)2R>ںYn&+V/^dH³띑ʲ44Z=~i fo__A#'HrT||޽{ի/իD"բdz~N<%#Enťen՛7T7ߌKJ2Xr..N)Y˳xxtwwG "6i)(D"E˗/7008!պoߎ\BB!H%YߤI /^d mj6n\QqfР^o#=`U~~B-5T7(D"ɢ/^?_~TG:wuD"ռjW v^>ѲA;77:++(%6VƤu4|NSN}ꕼc!թ߿?`'''z̚DR<막I$tD-[k.--Mށh--Ç;Tc"WpH$z̙3w~ yBxb-ZDoP%CD n|$ 8pt_>:t#yB"WD n|$K.uaɒ%f޼y3|ccc|N Dz/əJJ2|f>~|#iLO":t萶6;RVll,>'Gw $k_l:p33C==--->}/]eۅ QR"v3˓F}TVU%6ѻwD$S```h$rss D߼9Vm[oDfyy>zr{8//fڴQHT! PhUۊ F#'HRTRRҿ{;RQaa|KyB",q6j: efdl4CرvEE)?~Z(??AESii{B' d3f.E{x8a׮Ξ1e//MMu++ܿף;9/EYơnLre֪ׯz hSsC'O~F+@Պ3˗ѬYan?z"{MN3g7m5&M@`#mQڵXŋ?>2FDƍQ9fJ F&7O/1BnqQqH ƍmBppllMLCXc7X v\D׹sCCC+88ŋD"UA2Q^ ,8rd5!;4[<}͍b//l2fSQ> e54ZqHIٰ0VJsN=zKJbxw&%! /^x\,sǎ|wwwܶnC0g%%ѣT4jkۓEhbkD$ID111 EH H|ߟֺ9#L~ohFmΜ %Kuu59߹!2uW)-wځ|w3KNG>Z05JX;g,ݣGGT(1sGG)!2rvq4i؞=]C٪7*.N{?}I$ǎ;`"yBR(ݻwo߾<. n7Z2=7~ٹs  U/^жgNXJ{XBZja͛GZTs'L0L_Λ=ƎY)ڶmA@x]1AU1<ؚO9=7'??a`Y:PME^^Lyyv`'7aիu8;$'HПiii9}ׯ_;%M3VEx"ae*2eʲƺ:#F|uy T(`魬cf͚[AH!{g%&@H .zD[_;mܒ%{ӧ7oNo Շ{%4hWWWzDo"WpH[nu}̙eee򎅤*--uss)((w,$(_MO")N<ٮ]M6;Ib CCCzD?"WpHm۶褧;oijj$R=Q(DRHltG˳ڍQksp!˓,DQMO")ttto.@H$b  .;IIUהi4(g?11ѻs:3m( 1E5Q>ڸqc333TZZZw $2(ȑUVVf:mXfFfKK6mƎ+*JACP.Flqd}-eUlX$C__8 i[۞ /2e:j͍DQMO"5t͚5֭[D.]dddDHu/Y)~#,7MEB|Ņ\D$n_Pptԑ~~n|g4TXTQqٳK;vGNɟ2pڵ^cܹM4g;rH$rgq|$Q=/KرyD->M_?dnn,}2w/7n0۪kiiUD--u~۶}-)_Claa*;vH$Rו+W:u`ryB"JKK'MDHuwSOk]ʉXD.\8/_|ɒijj-tu59߹gk{{MMu33CUU*++>g??oHcˆ(D"s%''޽[ށH5+W$Rݔ41(=(x>Ed'$| Sg8OPUUp!*//NMݠѣT٫B mڨpss\$Hufgg;EHuwS> XD& \]]5=}#{`k%%ȼxq7=;߻@~%]ׯRUm۶~ H?(E:sĉI$W^}VVVoߖw,$R>n``!\q+"TUZZ:y>}ܽ{WޱHr}\zDY+Iz{o„ "ĞuqqӁD)+IB## yB"~gTS"Wp'7n܈D"p{ﾒTwZjxDz+ӧL&7t~y şhؔ_Z(0nDO&۲_G&We˦zu˳ڍQksp![鍾|ymeU!MdfFEN&'Jn|2<ys?CLLܩίYL6 |AQY F[ 'kir&'㚧,w6j: efdl4CرvEE)?~Zň-No_ES:rdNhl{{ʪlB>/2e:*͍i$C__mO`̙c fǯtf͡m[;;,,L7"ѣ+Q>Y1|$jη3wg(}חٳg'/Y1LOoy r:??y}"!Z=|z֭U_?A2GNbOVڟ??ٳK;vG ܸqqq!DfiΝ٤I　( |9VQ,b GbZ/4sb nݺ֭8uu]': ֗͛G!# <Ɋ\3HzfSNGR Cwow!x;3 o|rL*S^ ,8rd--}YKD6+ɧ| V,3#c@6!wwm۾"Lۂ6֢֭9l{O\fР^lmXQ>>ɝ;k!L8Z,`#ߌ7ݴi9qAC #hU%1&'5 QOk]ʉXD& >C~롣^vΜ %KW|Nm45­Ztuuxۖ…Y/e/* |Y|1xQB

HҮ][kR29s}Vᬼxq7Ҡy7cq>~|;ykP<ՃͿr v;,&'sy »j41(=(x>Ed`H)>vIIkmGD,LH+*prBT^^ AE9jmsGG3Xj)rwss\O4l,._chƍӸ&ޏp߾@|rC+#sDz&gC3W ĿX3Lbl\'/s8cG;ة3Ɋj|5h^Ci\57Z2=7~g' G7Tew/ COg_,V[󡲪ڶmA]566gn76~6Us `Q^٣GG~]\av(ܠaVzs_Ȑy8ӗ.BWWqo*+0g0#<5y(b)քLb(,y PWgĭI I M DnTd˔e}@cc]CC#>dq<2g++ӧ5kڱ޽֬xVF7띑Y Fq Nzd7e:ad!!2}@--u &N(>u*vɌ\{2d޹S QTnLWݻDY-[a.$ xNv6]/1&'3Ӽ:p6-!AIH`Qb/OÇ"dK[q1\`p twwqY11A2n\3脍d꿉2:'giLtc[$ھΝw׭^ Ǝco*+yӦy_@psscp"od{0UwRZJ5y(C& U4k5kDd2YMOi^@MD&'Jn|2<&W"d%7Q>LV+d(L&+Dd2YMO&rⴒkʥc@4Q>LVrdqPe_:Uڴp33C==--->}b%n*…/OQYYVP?Mҙ;}G~?ÕcOA9rL?&'㚧7oNcsĵm[oyzSSʶBႂU //fڴQ,S[+0n3}F#M^΂߿iV37KK3ؑD l E\?~lޥQQQJFc@ W4?uX.+JK _n'6{x8a׮Ν9|x?|y)#\45խrs}?rd tBCg۰L''[oAk!mk333&W`&.ҡ'oߨ3 k uĦlYԤIc}6d[a=Q۶:z7k֔ܫWg@Vl+eUF;*3,ۯ^CPrW'o8rT$>y36߼yD]]u׮% Æe/+7lDִiρ 3mC@ `̙cGim6qq!W췱171cUnʟ2pڵ^ؤ&WTr o-joՉiaO5nnQQKwXdkhb-,L` D#m7"A^DI|E}V $^?*e~g! hqwtoeeF/*J=z@6j}dy؆=;͟[SOmۺsg+gq70lb{HjҤaѣcj㇠bzh42r@8ߏԩ#.1!Ne᫯>e NHJZ{JՌ`bffhdn͚9ܑ,OrfuF DNs0|gS7i<_W qOsdQOk]ʉXD& ܸ||rr`-pBw**ͯ^Cv׮Z>dsO?u]p2˼|y/쬬Hssc~_ v2MBB?4*jihl$,ۿr}A775CbŊlFO _M67Kj„(EMasNB0jGHtPgeT_^t֪mƍܪUK,ܹa & e8hFA;;b?G\U`5ә)>x81ǩ͞ͻ};.qڸ᪅U1ZHFlCďsq&}vOK G+ w $&%"R(2UAAǃ`,"_˿pt28ȑU66Xj!{wysigЦ~776)\g+lXܩX.uc>#; q8 qn X3X8c@=3 Ɖ#}LMzGtEH5oGTGnSY=3ʇ~e@|0=a c=v Jّ~ώQG zh|sU9@@a[۞|%ZŠ@z|<@=.Q*JO<ؚlAϞ.bDQQJPoMF*qo]A{~;}0W~']33#`| .K WnIChEJV|_M鴴pd_\=+g}wJ,Θ ƍ[{{peJ*k(6v1뿉Uꄮg7zL<92rсˑ00D(x _#r,WʌFT˞>},_YS>eUq+"q~} +(r0E}+nanX̙=.r_><`Elŧ|\fljΜ c^Y>|\Q>heӦy\ cDYThم]ce C}O&WN//[6ӧY==-50x;(?+3hP/,o{H)3;vlg\d^ f92߻7ʂi.C]5ʇsKzHP?XX@l\JߺYa阘 .]g[+tl[}xM_VޚpX=|-[g/ӼyS Goڵ eoe...c^'BHsBNRZ)[kc5޵k [nL4i$&ze#,O'NBn] f ҃+kL&>8(_\i j/0ʿN 6m2|x?1.Y FΝKѨ|YvS>.lkQ~eA xOsd*S>I 9̀}1o,8xpB1??&W`&\2lغSf-I^9rgJϧUO>y{w߽}vi`ciingTGgbneЃt)[8sجH,޻E_h֥WFz1c.Es߾&jcSY+WΒ5Qim \#&W g>u.zw李jke+/;:w~~ݗ#>p!JV_M6or0BAHov4޴#R(y"d Mß}6 3۷;* ZD i٧9/Oqptrz-{,/eFQ>u Nc܍1OOg EZp_Y\aS>J&Wxrno?z΃} n$|E&ÇUMV|SO=gel>M5z&WT8!7 y4Q>աE.#ؼ~,/|"@ӷv✜=m6m۶ȧ|мF+t쨿y|+ Ri., W*eq>_}{=d S>Y!M~igjQZ0v !Wdr¯^4&W"eqNΞ#mMLtu5?޽r\R1pC dE2Q>Zk4T&W"d%7Q>:'gVKNVh.CLD&'Jn|2 o߼92(L&+dV(cG߶m>} ˏZjnn؍2)+ai֡C*MpM&%'tFcPy Y#zhlQ>JZZ9jÀ }}mvSmO0>/_;e//MMu++h?٥?l|;6vEGDJY~r_k|2<O^O>(Y&'W4AnЮ2収;HqV-YޣGGp>J>jaa>={vg܁ ߕf•m`]b0ydi ?ED,4D[ٿ€Qw&rm7"54Žc-6`\q͙3v!`Ia-ξ-[`ՀVNEp5$&8y8CCg ?bg ɣ];Sc{\\GЫWgԉL`h{2 EVj矿g-r9ǎmH{ܸ'~|VJJZ+>L/GWUU|9$'r0='gϼy|}]YNv6FKLSSk9߹p3jCH"Ο '78ܹx\5sfT ں@8w7{vE-YN%>033*G+c<:th%޸q[ur] P;?f.|hX۷;.-oKZ5kѢ) @<\J>]S5b|2kмj41(=(x>EdH=*j)p:=`|QjYY>&&z`۾~ղ 66_ G,hƍRfzx߾@F87p6r5ܽ2OCd"nO\`Dk:c'?|?7szƩSG ?cH/^d0i>|x%NÐͅIS@hf'5Pcr_? y0mmb51t#\dDx֭8/51TؼgN 4'K7QR5h^C]57Z2=7~䗑HyO>8:w~8pv M^m8}5(h|=>`wl82ǐ@]]u"/mt۶Y炷1?{v@x)VQiQg+ㇹs',pEX(uuR(.Dq_  ٳt 6lOj8gAg"p`jS;(g=ewҮ][\I(1q YZ bsbɓYd0QR5h^C]5ʟ.#$50$%04% -S/#ԁ5ZZaU8IСc|741CӕQ>pN @7SáUUU_?2jiL1aH ;HhI5kʾ&'C>ҙ3q)>}4?¹"O8U>LIO?z# D磁^z4/Wq͵~cu woYk4_-Dq)#77 ^O蒛7oʾ$+4AJ*?}kkm[C썁 1=5WS, i P}4>\ZvQA0Q>$Cd}%/R9T*sHLVn~+Lnn "{$ۅ Q!/]:mƺ:wq/,LB/Dd+ҽlWN|yrԨʲ޳*(L&+dX(?//dMAܺuрV VVfJ([W+5+}/]]iwΌdq(.}D,"_fɒijj-tu59߹^^.TO(ҥq †0rJg*6m̙*-@"1/Z4 gF N%9}(~U"Ȉj Vbd<3-HQb0 $w>~W׮dg1nܸ:[p1CD ;mHfT>͛GF*vW3?(&%MVr9drBR>8Wa/~i3#d2Y\5o|!rTRC:>~uo)#GRʲP^D?,1QS'ڵe_vt%Ƽq㼏>d9oŅ\1"#q[Ilb/ح;0. 4>J Fasd_)BUUÞS"6mybw.ap@BCgH`DQ؝}{j$޿$rLVr WTeWIאdz%渺Et|l/7qfnzJ3Ǣ\M&FFk\/z>b2qŋq Rre?@ *Fl&'L2qic"%;w~ pܹTNٶmY11A;w,'Ov;bnG=pٲ!%obF9HJzOؘ=7+ \OqAˋ)/ dIdăxX>ԙoe: `9\Na<2Ν4zFG:E)_%cL&]SlǻH8PUR5$>%쀗/Ys_T2imT&..}8=dr]5ʟ.#$50$%04% -S)Rly:p?}z+?@/zxڴQZ46]h Z[w4X1k_c:#F|^bgTǵ~f\`{@ݻoajDf})10d::0U |c)??L\$6 l52j3/#7_b+8%޹g9KN?3Ɓ¶{,d25B {~ qЗ8PUR5$>Uyyȟ^>3>2yǎDdrv6-!AIH`Qb1\\]ZK-3w@ٕŀkcw}EH |s?t*勏yd25B {X) qҡǫkH|LK<\؋SQi~j,ˣ__ׅ '˗ ywj&M$Ѥ忿q4Uҥ r?UU__Ԫ2R~e3I|vWt&+2X9:4%C"$^xOcZ9ƜEl˧|+k_ e(LnЖo~:)͍ʊ&Oo\Eu^- ʌOܗu6Iw.Q\ |&+2,w/M@!>E H*+Ǵbi( ŅjՒ}̦9dGRQUzm9P>Y^oJ;j&+2LoABID|A%ǫ$kH|fLdH´Yzcc]VM?H[.of}2A(_\?)L&r_~5Dd6H9n݊KK gz_F&m|%2Q>LVr˝_04 :T/1qC"6Q(L&+¤ݻϥǙn|%2Q>LVrddoܸI+Q>LVf7"'JF)Dyd2(L&+I<2MO&D$YE}Ln&'c|z>oٲ^0-5RL&3N|Dj?IOFAoޜ/_<hMF&̍h.L&+\>IFO7~lޥQQQJFcڶm<0홙ˋ>/2eYnnHmr?dr2Q>LVdyO7oQWWݵkI~~ða}Ykn8̕9wng&f9sȑ**" Dd2YyLOU߇:-f:o[۞,Cȼ'ъefdl0;d2XdMeL&IꝔ0W {{OssrƧ|1wuA@O&ڠ?13 cͺ8$+,-|X/2Y9MOU|_ G,hƍpODd2]{<2rWf˖cq4ѪU֭U9_feEى 1t)F"sp!JJP{[čbԨʲj D$Y%\~azqʇUT߻jWSkS^٣GGMGiS>W2ܰ\yn"+SKjpn۶uzFq^TڴQR8#kw&`UUkOчDeHQ(La'rAQ0 #'D{{0f5+efL7ݝ9A9>gkg[aÆqeb)M|( MVml]]?To׮x,ʽ X GsQÃ;P5姤r]]rab#Gaook/^yE.Z𴳫BhAgd6oh^8GH9~<)%J=ζyП>s}I WCB NeB,o9gg{׮m7VxZ^2}fk֭qc'/;R9J.fZ8qVm+=eUbTYQ] 5[, Es-Q~QA0tZZs@'Nq㣰`z(Z@-'O~E!(n]+Wv ܍nm"ʏ8ᇳI= XUC/gЍQ~NBqaMQDROo:K]2>jkkG7l~v%K&kׂR.^Ȉt)ή6+_MbN}(55RMtbU515|UUzw]whڸw5 W$'2r60ᡙPO8p_n|>xUXS>^cgX]2b; ~#Qǀ=͉Z5k=&f_MS>6,X ]#+7027nZ\]3dHrsk8e@Jz޼GVnHO #ܻx12k=!% LQ:)Zf:JKaaW;w׫WbgkL,LjTוascs"%u /.~DɊSі 6Ǔ۷/3}3RgYCCLO*Uƾ}IyL$h{ÆhX&|6Ɣb*Ic3ӓ4QeL_&R?;ֱcK @_]\fz+..9;{osRVŔϦתU>V ﱊ9۷$w-M ([^Yݤ UTbUe=ƔϦ*b+|Ų|15X,VES>Ū:bgkۺzL}^?Rr"1X#|6{ygoRQwv~XTtƍpŔbZI)_wuu}"(|Sf;[_l">lo_駩eROoy:Ν52,Ŋ)_x9~TW=2UϦJO{&ݹ0&?yFnȀ ڇr@ץ5b0ùŞ>aȐ *ʕP =ȰXGF&_#,jK|%-Z1/o$Zk\٨ԸS6BQwXdf͚ И1}îsQP2mڠM]15 оzaWVڶ}߿ѣ+-6D%ZE_,$YI, 1_3`@QS 3mu<OqqhE O4=赈jʇY,ܻw'dFy啿8)qBČXftGiS^ )(Hom]Сd ]}I!!uur]iXXF|k׶v+Ÿk/](J۷1lWKGCD<{6~w' g%MQ5Nƍwo?thPCݾ}?LBQR}Zn⍿tiMر _T2{| '?PN<I/؄ъNAvS x QDQ|E4fMX-|6fz̛+ Ev[yv7o~iO6B?/LGbFF3}}0!Fw855_4sG}O=՘hX?ًWvx締4eb4>])_|̆-Q4›)͔N6qǩG̃J h%a#)ikJD !ON NoѼܯ߫h S.,f۶aĢOW\hWA?6zѢ Jݼy:sR&/g;8Rڵk% zJ( ڬ];m<$ĿK?;5" 0׬iرU1"#eg/. 4t ~.;88qbݍS·kvjPTk DsM-^ȈUAY{\DQjAoG Ǩ.c:>6GzFD* ~Wb߿F"tykW{Gͩ@LB[=!j׮ZI)B1NEEYl-I㣽bG|̆Kc t oz<|6Sfl̋عq[Nd|DAΝ}m==]:ujc߈Uʀ/=u3f ׺aC{,Iw˷UiflcAς?A3ϸcbIw&JkDԩ{hQQaԷJ83g6"Td0lԯ_Ǩv"zW~xBǫgŪ*=YP+;UW~E$ (ږ. $&"G v %e; )pᛴ Zuuҕ&j$J |ȑB:>T;8'Kk+'a4jh֬by`Vڵouvvض- XA۷ҥuxxK'Q} (aHd[GK'fi̒KLlzؘVF_=QvGao`$ᇳ) _֬,*똡⣏'uCԼп5Nހ]G)ƸԎ5j@詚ȌIPM?.|~2E`D1.֫W֭i|/m>z¨_aMX-|6f*ΫFu]<76:'h,*nUH/'I3Y%L}cT9 V܇謚pQS6D믂Ūd*=YPT길pkW'oQQbdi )imN}ض8Uf-Zxz{ČS]!|V!T^=.c:m0Bz Q`KmV=ڦ;P;u@'ck"]hܑ 9GG;yPP;8Ll8)S[LWG<۫}vgg7D&>/_|Q4To׮x oj15O98 =gz J=<0_ر@VV*ڷto%c*[b`O=. aZ  }M[qIC .z9jEbT&iLB̊.(,Zv%j_dRS#, "J|LTrij1<=ڄ^Y]n+=N疦ÇW<<ԏJ`IQ!k C%]1p^1bUt1X#|6cŪbgXUGLlz<UŔbZUs~* GY,VS>^+C=˖^0Q dgWF/(o?Bi jةGw:{(\֬Y3uSTw6mPӦnn CC?4JHתUmoM/;bboo۹lQwcVz (ݝ;Չ߄S~jUhC??{8pVIRP ^#wlZuwNx0D`ʎ :}zÐ!AM7n|Խ{CJ 5eO֢v/4k.oڵر 򈰛vcz.={ы֋N:x1-q bS=: Z[f镓;o֭1[T))_)~GL|8u7aMllllɸc3e޽;av"/;\EzO?M<ԬY[#ή6vug}ͭaDD!^8m眝F| %e[ڏ#3N뛶 ۮ]}ﱱ㍗i[{\DuuT&iSWd c |S`*6i^ԩ 3gAA*Q/yzIVVG( jL xJw3ֵ1Mֽ{xwwnԨ+WNyyK >^@*-( po!RS>g-bC.Ԕm>fÈiLFtjо@ބظc3e)Үz$69awυ [mmm֮qRVH. (QfMu*SdKMreƏ(v۶8+vQݚ5aOPP;ٹsi'ݸQXX0.|vm DsM-^Ȉ%P4QTZ@O*fV{EE}AQ/6oapRp 2v"=/IIB4zR~% uY)޽;ݻwbCD߷o~^}4qtRu ~1񽵄&l |66i2csaߍ㶜\q_D6ax~64FnBGAAsi.: BfMh{ƌ! &N|3""2= .͜9 ߤU+ +vઽ-%=.i✜pD  7u|FU'zѣ}|V[occ]l&EX>]xaú㤫)DfBB-wo K) a_Ln_p0…h)_|Q)7ђW)j}l[ ΍ΟʛHTP+;UW~EyƝ[ٽ|9}bxqQdDqŋ))3dH̜O ߤU͊!"@ܐ4Q{CɁ/9:9PH}S<}9 uwwNN,/KP> @vV-kb5rDjkg~0+Zr%7o:;;lB\%=}.Qw:<ҥǨ>FdIdP>eJ㣥|iF+܄ \bgcc})3F MN&/>" uoe֮=F?A͉밝 L^P ?{6 |ppD`3g6b9lѢtW"=6uU&]QJ& 8 v1 oY3sg_$+`(ߘKZG#@01OSwj )tc"3_gJ8Yߧ+>>zB?Ajix6x^R/ Q>\aډ/h)_|7W)$EXxV)j}l忕<(vOTQ[>Ԩa茋 vu}yE+ {V 暔4qc~^>l;>~vtA1p@VZvQN-HC&dL=cSz5z%4 sa@)07sK)ߘ0ٻ7N N:štc;w$Hto<C!wʔDfCD<۫`I f+品t/4>k0V^[To׮x oj1峱UM㾏͔Q]W-ύΉ>J%P7mGqOz\DQ]__=`54(\HKLӘ煄]zQXv JiվluF>X@,9DZI㣕viÆh-Brij1峱UM㾏͔~$MlS>Ūbgcc})cgX]LlllUӸc3eL,)j}l)bUt1峱UM㾏͔UݕqVٌ)S>vlEIENDB`java-design-patterns-1.16.0/repository/etc/repository.ucls000066400000000000000000000107271312550536300237400ustar00rootroot00000000000000 java-design-patterns-1.16.0/repository/etc/repository.urm.puml000066400000000000000000000027661312550536300245550ustar00rootroot00000000000000@startuml package com.iluwatar.repository { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class AppConfig { - LOGGER : Logger {static} + AppConfig() + dataSource() : DataSource + entityManagerFactory() : LocalContainerEntityManagerFactoryBean - jpaProperties() : Properties {static} + main(args : String[]) {static} + transactionManager() : JpaTransactionManager } class Person { - age : int - id : Long - name : String - surname : String + Person() + Person(name : String, surname : String, age : int) + equals(obj : Object) : boolean + getAge() : int + getId() : Long + getName() : String + getSurname() : String + hashCode() : int + setAge(age : int) + setId(id : Long) + setName(name : String) + setSurname(surname : String) + toString() : String } interface PersonRepository { + findByName(String) : Person {abstract} } class PersonSpecifications { + PersonSpecifications() } class AgeBetweenSpec { - from : int - to : int + AgeBetweenSpec(from : int, to : int) + toPredicate(root : Root, query : CriteriaQuery, cb : CriteriaBuilder) : Predicate } class NameEqualSpec { + name : String + NameEqualSpec(name : String) + toPredicate(root : Root, query : CriteriaQuery, cb : CriteriaBuilder) : Predicate } } NameEqualSpec ..+ PersonSpecifications AgeBetweenSpec ..+ PersonSpecifications @endumljava-design-patterns-1.16.0/repository/pom.xml000066400000000000000000000051611312550536300213670ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 repository org.springframework spring-test org.springframework.data spring-data-jpa org.hibernate hibernate-entitymanager commons-dbcp commons-dbcp com.h2database h2 junit junit test com.google.guava guava java-design-patterns-1.16.0/repository/src/000077500000000000000000000000001312550536300206365ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/000077500000000000000000000000001312550536300215625ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/java/000077500000000000000000000000001312550536300225035ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/java/com/000077500000000000000000000000001312550536300232615ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251115ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/repository/000077500000000000000000000000001312550536300273305ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/repository/App.java000066400000000000000000000101661312550536300307170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import java.util.List; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.context.support.ClassPathXmlApplicationContext; /** * Repository pattern mediates between the domain and data mapping layers using a collection-like * interface for accessing domain objects. A system with complex domain model often benefits from a * layer that isolates domain objects from the details of the database access code and in such * systems it can be worthwhile to build another layer of abstraction over the mapping layer where * query construction code is concentrated. This becomes more important when there are a large * number of domain classes or heavy querying. In these cases particularly, adding this layer helps * minimize duplicate query logic. *

* In this example we utilize Spring Data to automatically generate a repository for us from the * {@link Person} domain object. Using the {@link PersonRepository} we perform CRUD operations on * the entity, moreover, the query by {@link org.springframework.data.jpa.domain.Specification} are * also performed. Underneath we have configured in-memory H2 database for which schema is created * and dropped on each run. */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( "applicationContext.xml"); PersonRepository repository = context.getBean(PersonRepository.class); Person peter = new Person("Peter", "Sagan", 17); Person nasta = new Person("Nasta", "Kuzminova", 25); Person john = new Person("John", "lawrence", 35); Person terry = new Person("Terry", "Law", 36); // Add new Person records repository.save(peter); repository.save(nasta); repository.save(john); repository.save(terry); // Count Person records LOGGER.info("Count Person records: {}", repository.count()); // Print all records List persons = (List) repository.findAll(); for (Person person : persons) { LOGGER.info(person.toString()); } // Update Person nasta.setName("Barbora"); nasta.setSurname("Spotakova"); repository.save(nasta); LOGGER.info("Find by id 2: {}", repository.findOne(2L)); // Remove record from Person repository.delete(2L); // count records LOGGER.info("Count Person records: {}", repository.count()); // find by name Person p = repository.findOne(new PersonSpecifications.NameEqualSpec("John")); LOGGER.info("Find by John is {}", p); // find by age persons = repository.findAll(new PersonSpecifications.AgeBetweenSpec(20, 40)); LOGGER.info("Find Person with age between 20,40: "); for (Person person : persons) { LOGGER.info(person.toString()); } repository.deleteAll(); context.close(); } } java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/repository/AppConfig.java000066400000000000000000000123261312550536300320450ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import java.sql.SQLException; import java.util.List; import java.util.Properties; import javax.sql.DataSource; import org.apache.commons.dbcp.BasicDataSource; import org.hibernate.jpa.HibernatePersistenceProvider; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.context.annotation.AnnotationConfigApplicationContext; import org.springframework.context.annotation.Bean; import org.springframework.data.jpa.repository.config.EnableJpaRepositories; import org.springframework.orm.jpa.JpaTransactionManager; import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean; /** * This is the same example as in {@link App} but with annotations based * configuration for Spring. * */ @EnableJpaRepositories public class AppConfig { private static final Logger LOGGER = LoggerFactory.getLogger(AppConfig.class); /** * Creation of H2 db * * @return A new Instance of DataSource */ @Bean(destroyMethod = "close") public DataSource dataSource() { BasicDataSource basicDataSource = new BasicDataSource(); basicDataSource.setDriverClassName("org.h2.Driver"); basicDataSource.setUrl("jdbc:h2:~/databases/person"); basicDataSource.setUsername("sa"); basicDataSource.setPassword("sa"); return (DataSource) basicDataSource; } /** * Factory to create a especific instance of Entity Manager */ @Bean public LocalContainerEntityManagerFactoryBean entityManagerFactory() { LocalContainerEntityManagerFactoryBean entityManager = new LocalContainerEntityManagerFactoryBean(); entityManager.setDataSource(dataSource()); entityManager.setPackagesToScan("com.iluwatar"); entityManager.setPersistenceProvider(new HibernatePersistenceProvider()); entityManager.setJpaProperties(jpaProperties()); return entityManager; } /** * Properties for Jpa */ private static Properties jpaProperties() { Properties properties = new Properties(); properties.setProperty("hibernate.dialect", "org.hibernate.dialect.H2Dialect"); properties.setProperty("hibernate.hbm2ddl.auto", "create-drop"); return properties; } /** * Get transaction manager */ @Bean public JpaTransactionManager transactionManager() throws SQLException { JpaTransactionManager transactionManager = new JpaTransactionManager(); transactionManager.setEntityManagerFactory(entityManagerFactory().getObject()); return transactionManager; } /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext( AppConfig.class); PersonRepository repository = context.getBean(PersonRepository.class); Person peter = new Person("Peter", "Sagan", 17); Person nasta = new Person("Nasta", "Kuzminova", 25); Person john = new Person("John", "lawrence", 35); Person terry = new Person("Terry", "Law", 36); // Add new Person records repository.save(peter); repository.save(nasta); repository.save(john); repository.save(terry); // Count Person records LOGGER.info("Count Person records: {}", repository.count()); // Print all records List persons = (List) repository.findAll(); for (Person person : persons) { LOGGER.info(person.toString()); } // Update Person nasta.setName("Barbora"); nasta.setSurname("Spotakova"); repository.save(nasta); LOGGER.info("Find by id 2: {}", repository.findOne(2L)); // Remove record from Person repository.delete(2L); // count records LOGGER.info("Count Person records: {}", repository.count()); // find by name Person p = repository.findOne(new PersonSpecifications.NameEqualSpec("John")); LOGGER.info("Find by John is {}", p); // find by age persons = repository.findAll(new PersonSpecifications.AgeBetweenSpec(20, 40)); LOGGER.info("Find Person with age between 20,40: "); for (Person person : persons) { LOGGER.info(person.toString()); } context.close(); } } java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/repository/Person.java000066400000000000000000000064611312550536300314500ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; /** * * Person entity * */ @Entity public class Person { @Id @GeneratedValue private Long id; private String name; private String surname; private int age; public Person() { } /** * Constructor */ public Person(String name, String surname, int age) { this.name = name; this.surname = surname; this.age = age; } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getSurname() { return surname; } public void setSurname(String surname) { this.surname = surname; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } @Override public String toString() { return "Person [id=" + id + ", name=" + name + ", surname=" + surname + ", age=" + age + "]"; } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + age; result = prime * result + (id == null ? 0 : id.hashCode()); result = prime * result + (name == null ? 0 : name.hashCode()); result = prime * result + (surname == null ? 0 : surname.hashCode()); return result; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } Person other = (Person) obj; if (age != other.age) { return false; } if (id == null) { if (other.id != null) { return false; } } else if (!id.equals(other.id)) { return false; } if (name == null) { if (other.name != null) { return false; } } else if (!name.equals(other.name)) { return false; } if (surname == null) { if (other.surname != null) { return false; } } else if (!surname.equals(other.surname)) { return false; } return true; } } java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/repository/PersonRepository.java000066400000000000000000000030261312550536300335420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import org.springframework.data.jpa.repository.JpaSpecificationExecutor; import org.springframework.data.repository.CrudRepository; import org.springframework.stereotype.Repository; /** * * Person repository * */ @Repository public interface PersonRepository extends CrudRepository, JpaSpecificationExecutor { Person findByName(String name); } PersonSpecifications.java000066400000000000000000000046101312550536300342470ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/java/com/iluwatar/repository/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import javax.persistence.criteria.CriteriaBuilder; import javax.persistence.criteria.CriteriaQuery; import javax.persistence.criteria.Predicate; import javax.persistence.criteria.Root; import org.springframework.data.jpa.domain.Specification; /** * Helper class, includes vary Specification as the abstraction of sql query criteria */ public class PersonSpecifications { /** * Specifications stating the Between (From - To) Age Specification */ public static class AgeBetweenSpec implements Specification { private int from; private int to; public AgeBetweenSpec(int from, int to) { this.from = from; this.to = to; } @Override public Predicate toPredicate(Root root, CriteriaQuery query, CriteriaBuilder cb) { return cb.between(root.get("age"), from, to); } } /** * Name specification * */ public static class NameEqualSpec implements Specification { public String name; public NameEqualSpec(String name) { this.name = name; } /** * Get predicate */ public Predicate toPredicate(Root root, CriteriaQuery query, CriteriaBuilder cb) { return cb.equal(root.get("name"), this.name); } } } java-design-patterns-1.16.0/repository/src/main/resources/000077500000000000000000000000001312550536300235745ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/resources/META-INF/000077500000000000000000000000001312550536300247345ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/main/resources/META-INF/persistence.xml000066400000000000000000000027411312550536300300060ustar00rootroot00000000000000 java-design-patterns-1.16.0/repository/src/main/resources/applicationContext.xml000066400000000000000000000060711312550536300301720ustar00rootroot00000000000000 java-design-patterns-1.16.0/repository/src/main/resources/logback.xml000066400000000000000000000037651312550536300257330ustar00rootroot00000000000000 repository.log repository-%d.log 5 %-5p [%d{ISO8601,UTC}] %c: %m%n %-5p [%d{ISO8601,UTC}] %c: %m%n java-design-patterns-1.16.0/repository/src/test/000077500000000000000000000000001312550536300216155ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/test/java/000077500000000000000000000000001312550536300225365ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/test/java/com/000077500000000000000000000000001312550536300233145ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251445ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/test/java/com/iluwatar/repository/000077500000000000000000000000001312550536300273635ustar00rootroot00000000000000AnnotationBasedRepositoryTest.java000066400000000000000000000075171312550536300361720ustar00rootroot00000000000000java-design-patterns-1.16.0/repository/src/test/java/com/iluwatar/repository/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; import java.util.Arrays; import java.util.List; import javax.annotation.Resource; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.test.context.ContextConfiguration; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; import org.springframework.test.context.support.AnnotationConfigContextLoader; import com.google.common.collect.Lists; /** * Test case to test the functions of {@link PersonRepository}, beside the CRUD functions, the query * by {@link org.springframework.data.jpa.domain.Specification} are also test. * */ @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(classes = { AppConfig.class }, loader = AnnotationConfigContextLoader.class) public class AnnotationBasedRepositoryTest { @Resource private PersonRepository repository; Person peter = new Person("Peter", "Sagan", 17); Person nasta = new Person("Nasta", "Kuzminova", 25); Person john = new Person("John", "lawrence", 35); Person terry = new Person("Terry", "Law", 36); List persons = Arrays.asList(peter, nasta, john, terry); /** * Prepare data for test */ @Before public void setup() { repository.save(persons); } @Test public void testFindAll() { List actuals = Lists.newArrayList(repository.findAll()); assertTrue(actuals.containsAll(persons) && persons.containsAll(actuals)); } @Test public void testSave() { Person terry = repository.findByName("Terry"); terry.setSurname("Lee"); terry.setAge(47); repository.save(terry); terry = repository.findByName("Terry"); assertEquals(terry.getSurname(), "Lee"); assertEquals(47, terry.getAge()); } @Test public void testDelete() { Person terry = repository.findByName("Terry"); repository.delete(terry); assertEquals(3, repository.count()); assertNull(repository.findByName("Terry")); } @Test public void testCount() { assertEquals(4, repository.count()); } @Test public void testFindAllByAgeBetweenSpec() { List persons = repository.findAll(new PersonSpecifications.AgeBetweenSpec(20, 40)); assertEquals(3, persons.size()); assertTrue(persons.stream().allMatch((item) -> { return item.getAge() > 20 && item.getAge() < 40; })); } @Test public void testFindOneByNameEqualSpec() { Person actual = repository.findOne(new PersonSpecifications.NameEqualSpec("Terry")); assertEquals(terry, actual); } @After public void cleanup() { repository.deleteAll(); } } java-design-patterns-1.16.0/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java000066400000000000000000000047731312550536300327470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertTrue; import java.sql.ResultSet; import java.sql.SQLException; import javax.sql.DataSource; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.test.context.ContextConfiguration; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; import org.springframework.test.context.support.AnnotationConfigContextLoader; import org.springframework.transaction.annotation.Transactional; /** * This case is Just for test the Annotation Based configuration * */ @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(classes = { AppConfig.class }, loader = AnnotationConfigContextLoader.class) public class AppConfigTest { @Autowired DataSource dataSource; /** * Test for bean instance */ @Test public void testDataSource() { assertNotNull(dataSource); } /** * Test for correct query execution */ @Test @Transactional public void testQuery() throws SQLException { ResultSet resultSet = dataSource.getConnection().createStatement().executeQuery("SELECT 1"); String result = null; String expected = "1"; while (resultSet.next()) { result = resultSet.getString(1); } assertTrue(result.equals(expected)); } } java-design-patterns-1.16.0/repository/src/test/java/com/iluwatar/repository/AppTest.java000066400000000000000000000026111312550536300316060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import org.junit.Test; import java.io.IOException; /** * Tests that Repository example runs without errors. */ public class AppTest { @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java000066400000000000000000000073241312550536300332530ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.repository; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; import java.util.Arrays; import java.util.List; import javax.annotation.Resource; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.test.context.ContextConfiguration; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; import com.google.common.collect.Lists; /** * Test case to test the functions of {@link PersonRepository}, beside the CRUD functions, the query * by {@link org.springframework.data.jpa.domain.Specification} are also test. */ @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(locations = { "classpath:applicationContext.xml" }) public class RepositoryTest { @Resource private PersonRepository repository; Person peter = new Person("Peter", "Sagan", 17); Person nasta = new Person("Nasta", "Kuzminova", 25); Person john = new Person("John", "lawrence", 35); Person terry = new Person("Terry", "Law", 36); List persons = Arrays.asList(peter, nasta, john, terry); /** * Prepare data for test */ @Before public void setup() { repository.save(persons); } @Test public void testFindAll() { List actuals = Lists.newArrayList(repository.findAll()); assertTrue(actuals.containsAll(persons) && persons.containsAll(actuals)); } @Test public void testSave() { Person terry = repository.findByName("Terry"); terry.setSurname("Lee"); terry.setAge(47); repository.save(terry); terry = repository.findByName("Terry"); assertEquals(terry.getSurname(), "Lee"); assertEquals(47, terry.getAge()); } @Test public void testDelete() { Person terry = repository.findByName("Terry"); repository.delete(terry); assertEquals(3, repository.count()); assertNull(repository.findByName("Terry")); } @Test public void testCount() { assertEquals(4, repository.count()); } @Test public void testFindAllByAgeBetweenSpec() { List persons = repository.findAll(new PersonSpecifications.AgeBetweenSpec(20, 40)); assertEquals(3, persons.size()); assertTrue(persons.stream().allMatch((item) -> { return item.getAge() > 20 && item.getAge() < 40; })); } @Test public void testFindOneByNameEqualSpec() { Person actual = repository.findOne(new PersonSpecifications.NameEqualSpec("Terry")); assertEquals(terry, actual); } @After public void cleanup() { repository.deleteAll(); } } java-design-patterns-1.16.0/resource-acquisition-is-initialization/000077500000000000000000000000001312550536300254435ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/README.md000066400000000000000000000013711312550536300267240ustar00rootroot00000000000000--- layout: pattern title: Resource Acquisition Is Initialization folder: resource-acquisition-is-initialization permalink: /patterns/resource-acquisition-is-initialization/ pumlid: ZShR3S8m343HLUW0YV_PnhXMQvGumOzMOdhA1lqxkhgBABLSEQqzzeZfJm33isuIUxxIsMXei4QbqK5QdXXeyCO3oyekcvQ94MpgqD4lWB6FDEA2z4bn2HbQn8leHMponNy13hgvrhHUP_Rs0m00 categories: Other tags: - Java - Difficulty-Beginner - Idiom --- ## Intent Resource Acquisition Is Initialization pattern can be used to implement exception safe resource management. ![alt text](./etc/resource-acquisition-is-initialization.png "Resource Acquisition Is Initialization") ## Applicability Use the Resource Acquisition Is Initialization pattern when * you have resources that must be closed in every condition java-design-patterns-1.16.0/resource-acquisition-is-initialization/etc/000077500000000000000000000000001312550536300262165ustar00rootroot00000000000000resource-acquisition-is-initialization.png000066400000000000000000000072601312550536300364650ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/etcPNG  IHDRpCX"wIDATx]ݏ7 X)7҈@WiSMU%4tS Uq%)%! &qm.!DQ#6MiSJS>A[$Jx;Ǟ;c=OWs=3g{<>h NCt(P@@q(Df# FAS?`b;DLA3w#SSS…ZiE=ifj!I(7 .v[}15EUAcstڑXw݅%9OrJTGIQM9h9Ke ȅWWs!1dL{ ҅TUTDn9NE^,ʄ`FLvLl|~U!#]U.$EU0x'*"ט\wR2~@ZXRٰVw=h"RbYJ0~ȵ!׫};Z-;]>FIO$^Cak4s# :Ӄ^{Ku-8Ed4G6$2/k8@#UAE"DÇߢ"rMiJ!lQl<*\<*\<*\<*\<*\<*\؉ky S_ǶmxFد]ο?>{G ڹX<dM ?{4ɔ&*cSڅdYh: 3D%ϓ/ztb{g}ٷ>]s8o^0 -(JT6TWވjwX+jgv_y@s3Rԝ#'3hHVTsnpa21[ ˓3Be?H0#'wl;﮽r?^:x3 dGҽgySѿVE'byylVq=Y$)d_2%;,.;0#9B)5!]Me*[7u{냏nMn3Ǝ1wc) W xjs]][G(NJ$╨* {j`jA*Q/MA%sԬSBn* Q}sG몷oX_ v?a*.v%\TFUaW%Y߻nqOǴIW )dmKr_,p@VR7FbWnؽp\wx gn,}SbR:r2B}Ɣav]Ӗ PiH}Uu"r݊'}c<uK%N}hv]#Q[o?{oख़/~rM'lm{(*kŎ.4Qݿb!Hk@Q1̾zl:=?peO l) {MhxGUuA>ŠxOU&68ˁ {5 N*P C>c-,9*]{'6ui˶YZQF nƜoH{,}+vmDTH >mwįM=l1LVGYʙ9 OTD.]-fdqem4,p@,;$)*"Wnt[dL+*-IvʅD{ EEJL^jwpL >;}Q,%Q`MĹw#SSSS.U(4Mw wRyZ`QOSS.*zTm<@E* #p6jOQ&խٞDWS'-tSf%%9NT;_v}g> E,ʐݯq5:od,DO_S, dRe1'# *c;ŪP],dQeST-z(X"E$NTך</4u@)tҦ_"*tz9eb5Ee.*HAxO)ʣ2_<ЖG;Q}_ޱܮϰ_E *UˎJvL#IwDeh^|LPJ?UHv<G;QM/XwCo0{,Xw|EڋJa=6_\3]**tVhdz,?\TF#tZTa [* vbz's򡹿mQanC21hZdW-KڳcEX"h~=#Le>0lnvT2/&TpHͳ>dPm(Ӊ:vưpnRS0)$?iuÑ3d|LW4\ޝH<hlcQ4T>aW[D+hFEЎy#=9cUeּW<<*\<*\<*\<*\<*\%Y?6pZ䋓HjܼRL"]rWn0T%@;䮲/jD~SwUd\^3Ss k'ge.}ďyuW?}ܹ}3%Ni> W<=VQYWA;6" 15bVQ~ZU[3^{ARKe}ܹzՂ+WdO:OzRb!w<ݏpnK&_io3+OR!15b!waLS ୨}+0ߩ{U(*7D.Aj%D.HTD.HTD.pQZuGD(hBPľkj@aTǁDE>8}IENDB`resource-acquisition-is-initialization.ucls000066400000000000000000000041701312550536300366440ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/etc resource-acquisition-is-initialization.urm.puml000066400000000000000000000005551312550536300374600ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/etc@startuml package com.iluwatar.resource.acquisition.is.initialization { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class SlidingDoor { - LOGGER : Logger {static} + SlidingDoor() + close() } class TreasureChest { - LOGGER : Logger {static} + TreasureChest() + close() } } @endumljava-design-patterns-1.16.0/resource-acquisition-is-initialization/pom.xml000066400000000000000000000036351312550536300267670ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 resource-acquisition-is-initialization junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/000077500000000000000000000000001312550536300262325ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/000077500000000000000000000000001312550536300271565ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/000077500000000000000000000000001312550536300300775ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/000077500000000000000000000000001312550536300306555ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300325055ustar00rootroot00000000000000resource/000077500000000000000000000000001312550536300342555ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwataracquisition/000077500000000000000000000000001312550536300366055ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceis/000077500000000000000000000000001312550536300372205ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisitioninitialization/000077500000000000000000000000001312550536300422475ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/isApp.java000066400000000000000000000052241312550536300436350ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.resource.acquisition.is.initialization; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Resource Acquisition Is Initialization pattern was developed for exception safe resource * management by C++ creator Bjarne Stroustrup. *

* In RAII resource is tied to object lifetime: resource allocation is done during object creation * while resource deallocation is done during object destruction. *

* In Java RAII is achieved with try-with-resources statement and interfaces {@link Closeable} and * {@link AutoCloseable}. The try-with-resources statement ensures that each resource is closed at * the end of the statement. Any object that implements {@link java.lang.AutoCloseable}, which * includes all objects which implement {@link java.io.Closeable}, can be used as a resource. * * In this example, {@link SlidingDoor} implements {@link AutoCloseable} and {@link TreasureChest} * implements {@link Closeable}. Running the example, we can observe that both resources are * automatically closed. *

* http://docs.oracle.com/javase/7/docs/technotes/guides/language/try-with-resources.html * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) throws Exception { try (SlidingDoor slidingDoor = new SlidingDoor()) { LOGGER.info("Walking in."); } try (TreasureChest treasureChest = new TreasureChest()) { LOGGER.info("Looting contents."); } } } SlidingDoor.java000066400000000000000000000031131312550536300453250ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.resource.acquisition.is.initialization; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * SlidingDoor resource * */ public class SlidingDoor implements AutoCloseable { private static final Logger LOGGER = LoggerFactory.getLogger(SlidingDoor.class); public SlidingDoor() { LOGGER.info("Sliding door opens."); } @Override public void close() throws Exception { LOGGER.info("Sliding door closes."); } } TreasureChest.java000066400000000000000000000032141312550536300456730ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.resource.acquisition.is.initialization; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.Closeable; import java.io.IOException; /** * * TreasureChest resource * */ public class TreasureChest implements Closeable { private static final Logger LOGGER = LoggerFactory.getLogger(TreasureChest.class); public TreasureChest() { LOGGER.info("Treasure chest opens."); } @Override public void close() throws IOException { LOGGER.info("Treasure chest closes."); } } java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/000077500000000000000000000000001312550536300272115ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/000077500000000000000000000000001312550536300301325ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/000077500000000000000000000000001312550536300307105ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300325405ustar00rootroot00000000000000resource/000077500000000000000000000000001312550536300343105ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwataracquisition/000077500000000000000000000000001312550536300366405ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resourceis/000077500000000000000000000000001312550536300372535ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisitioninitialization/000077500000000000000000000000001312550536300423025ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/isAppTest.java000066400000000000000000000025541312550536300445330ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.resource.acquisition.is.initialization; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } ClosableTest.java000066400000000000000000000053421312550536300455350ustar00rootroot00000000000000java-design-patterns-1.16.0/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.resource.acquisition.is.initialization; import static org.junit.Assert.assertTrue; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import java.util.LinkedList; import java.util.List; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; /** * Date: 12/28/15 - 9:31 PM * * @author Jeroen Meulemeester */ public class ClosableTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } @Test public void testOpenClose() throws Exception { try (final SlidingDoor door = new SlidingDoor(); final TreasureChest chest = new TreasureChest()) { assertTrue(appender.logContains("Sliding door opens.")); assertTrue(appender.logContains("Treasure chest opens.")); } assertTrue(appender.logContains("Treasure chest closes.")); assertTrue(appender.logContains("Sliding door closes.")); } /** * Logging Appender Implementation */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getMessage().equals(message)); } } } java-design-patterns-1.16.0/semaphore/000077500000000000000000000000001312550536300176135ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/README.md000066400000000000000000000017541312550536300211010ustar00rootroot00000000000000--- layout: pattern title: Semaphore folder: semaphore permalink: /patterns/semaphore/ pumlid: HSV14SCm20J0Lk82BFxf1ikCfOn06ZZizfDVVhjRjphobFJnQi2ADv7pKwwEbaU6U9q6CPGwbVh8Xy5E7xvvFoNwPVjYGDo2bEC72b5URRgGeFvNqhMirF45 categories: Concurrency tags: - Java - Difficulty-Intermediate --- ## Also known as Counting Semaphore ## Intent Create a lock which mediates access to a pool of resources. Only a limited number of threads, specified at the creation of the semaphore, can access the resources at any given time. A semaphore which only allows one concurrent access to a resource is called a binary semaphore. ![alt text](./etc/semaphore.png "Semaphore") ## Applicability Use a Semaphore when * you have a pool of resources to allocate to different threads * concurrent access to a resource could lead to a race condition ## Credits * [Semaphore(programming)] (http://en.wikipedia.org/wiki/Semaphore_(programming)) * [Semaphores] (http://tutorials.jenkov.com/java-concurrency/semaphores.html) java-design-patterns-1.16.0/semaphore/etc/000077500000000000000000000000001312550536300203665ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/etc/semaphore.png000066400000000000000000000726111312550536300230660ustar00rootroot00000000000000PNG  IHDR8o /uPIDATxmřyf!F1 `Ǻq/alސ: "4+sEC #cR%K‚x-/ZrY@) 0tWYY" ]›LZ!I  wE0 >m)(n( E_eeII=%6a"30IE,{xtJQAʒtS;t ~fgtH}%S:%0J;N/K0AJljc(n;G<_WMRU0tWYYP*nӣNg%|Ll?$]z۟(!җޝ?DI˔UVt J|tӧxzsoDgx֧a3g4^!䮵՟鉳OmCNFoXGҥ_@^܈k)<@-NCXO~֏KMi6mtՓBaV*?,D?{^ym^;GVuڹR$^eeRZF Zʒ{{~+Ԩ6?駈i}wf4 wgi '٬n~[7^ɘ֢8ߪwӻ.@=xo|V.ōԵd%*w|{ĨH_x~~$F8$!ҁ "vJw; 黟3Ox'/9+dëo.o{1R#Ӊ)JѶŗQ^l{^O,0?ݼf>v]=Z7̎$sZ. 0w)k&7mɯ4:I-kyH8V\$W7KĄɷ1M@kZ2fklu= V|ࣥ''o-K|`TcO׎'D[)__]_KR$ߒ<43DZM#]^ꗬͱ'zo|aNyHe9;>b]-b=_OM!6o4'/q%+nˆ e.nutAQÃzܚ5[LC{# d]q]UuNfw6N|W8w%w' ;/pq#*+K1gq?tijxW7GC3 EK LM}?}qg,b,> DRޚ2[$#OOo,ң]۽M eDoڳfԖOox|+KIб&lUVb }ɯ~=kџ>/G~m31,i|~VN pطֻ3`Qc*1)r*,%m{c &Lv7D: yҍ??}Gm*_]{"֓Oc](Ig E]h74n+Nz½KUSI DSNRb 9y龯dЏ_7ӟ>smBl놓/L9y!w7 tK*Ү5G7W"*!aW>x]`#Ĉ49b^9F>^Tk~G=ɈklcJPDEYoJѶwX5EzSDЮӻ'֑t%RUtrva8BP 8<[ j]H(mQ)6D:/H%yݗy7?#O?YtbڭZ%,UU-YX8>J9Z'G@Npw'>^|ŕa<"_7.'ۢEhuU*X5xp'O"]J:tWYYxҘ*7Uj"v:4GKNNɱ'[>iR\ E\ee%y&m1U*-^zwGV1}NGz Ji/H+̲e@!]ptv% 'd荏Yĝx!Ƿ~ɷ,gGnHg  H*iȬuRZD:7#J|Ӟ5l|z[_MRx.*Yed!.*+ -/;DZw_mbn͑^`颯^(A]KVYBUbd}bWDlu[ E\eeAQE3"[~ E_eeAQĈ'D&iL˗RLC煬A .A;p=-(Kd5x_eeAQE;& y /*xw|%ӂ7;b~]h$aZk-,"++EFQE:L bOs퉴QyKw5N<=ȶv: %u M{;H7"++EF{SUB*KX :M6Ɖ}ض=md+Miv@(<;̝ Vt{)`z(8 c~sl73+_4F 0cTt"ݾiv_}毾7ZV .{q\U*GyǙ4ٰu:P:] }+;0}YCrEf͕A)BD+EF{+{qW{> H*_:V_Ezo<9q׎$1M8W><N t3WJѶ^ܕ/AtTaDc'_|$lsS)Rm7JȒ=y`^R˦޽{UZY;q˩gm'K>D>O\ys DZ&*n!7zASA0q dVX޶ZXXoStdKp=joڪϻLXϤo} ;۞H Hlo)Ėn,&xFaλїUVBO7[0RǙ e7&)36g6;;KP&ߘnr9eL(3G-$ҿ{&m;4ֶ흸)ὄf/D4޳b]?I'1!`,I =eig*"KJhmd??oK?lm넧nawAL#¼Nl:#\@:'CtCq S(ҽP]AuR4ܡLL+iY"M6.o9r<MI{G *%i(Eۮp{"pwŘh;árZ),5KV.|P:/Kon[2&oPM,luʹGmqpeRmLM< L˼JuzM)rOztX2&BH ]hМESJ"cR޵Kg ("8#$Y)uKKZ!mۖ/_r_ę^XXi zqJ*/guEX Q"=ЅrM8֍Hv:\4ж KV, Hw#bLR*Pnu蒖,fgg6I^JB,H 1dk]SޜD:8K,|{RBa >*Y>]0 N_鷧37*JTC 7P]R+m Flٲ!^۩BU*9ޖXyZ*{X:W:^eeꇱ[ FZSf+h{9\U]FWTS&U;77N̫,--PTgffmBŅluu[CU|Q% 3iUV[æݝ>WhB/gJTN1_Df] wa&LDHu__4[w& ǫWY൙%am+.WxҰnjw/=,,yaQ遹, n,9+Wq4ێO:̤SNs(.uŝwdtyAp5krj 䴉L.޽xmKw'dCij''|\rgҷ>o{mO#HR̩X*B LjtDV']UVBl'`iPh"]J&}|$/_Υ59uM4R t`h3Ƕn{''s"m-2lZ>/D=Hx?EH4i,:` r/Y4qWXA\mH8ߩ4F6@n=i03HGC:'pW׺x{w ҺZ%;???==MDx׉=<q$ʟ֕AAutv -mc19i,իij] Yk1{l-GT"Rʟ֕Jh4/T zcRl\p*HtJ3;;KhO@REi\ ""]AS}"% ͭt_ Mu1^q)>.BAd*/ ^:" J q|IWZX#"yg\qcADU9XBb__s)Q=f҈ 'oť!G\ ""]A,,,˗2DI#G-KtBAA A6!"x;6wVmYDOTh5x@ALgwx> - mR . . @EFGGݦiJDOÄh~%h%RL4٨/_}!,Rڢc$vzyv- T0 (x}7=, t&pݨ;Wâw4Whvbk鼉rc(@%"ʋR4??/,DY<^?TP~nAP.<4s钏"KZbqqOY\f քS$I9w\RDyɡ֡|2MD.x:iz)%鄝\~4i " &3'8ͳLɇ{v . @QmdE28= U m pLAEv!h%hC 14PݻwONN>2,cEN ]6DHE9xܜ(\"o.O'4UrDM@Ydw ˖][=\dvQB/-->2QHC֠XlիWeEHCޠ} %" z@HCޠUz‚(k)<Dɓ'eKKK_=&4P"ӲIb@^|sL@*,,,+]!(顡Y٧@iHU4MSYntպkȭX34@* #P7.j4%i@n+WH >/D(eF`T ˗/'-(i/_^brJ|3J^[oLdk/-- nHi@@,> C " `۶mX0Rod@#t7aT4ϕ+WNMQF+R B" :mı۟8te[ÈŽ;Sқ" C<˗/> IK=e“  D~U& Ү&ݻw &J]o6 NirXC" Dgppp~~^Y2<<|Ig@ɀHkE_@+)0u܊),(i nny 艴" V4)@Oi@Hz"HCoqqQYP2iD",iRH+z)ҳ@ǡZcuwu9KRk 3D@Hz"(H#ڈitHDZAF1)Lm%nq}ؘbzy8 qkl1e):82￙@hE n5jNEyءD8{klS 2% h6ZP>1(E7{>HXG>8;@`DZ&F+lϓfynQ;fM"1\OZUn~@ G7m"]&!:133h4d=V鉳OmCNFoXGҥ+%DZ =V$iğw=ۿ6/ggw#B:m-UZ"@ӯ V4@ODһć]~f8oo#4?mf륽dX7!" @:iE"{O?34瞼p{;@ z*׮l)@sxѫ>5;؆lZ9HKc|'ҊD"frӆM]|x/<@<h5<[2WTrGm]ދ sC CN "- 4@ODuY3y|Go%F6n]uhspzEӗ!(x,cl`\xbii@Hz"HI]{_Vް.~yp&yO:O[XQhkSh찼G ҀHDZH®U65hɾo7O=qr=6L5d\-atH 긶iD:' m۶ig@@ODһ?{uzWw둷~0||+̈́'Ϥ2 ։kfiiIYP>iOe8e}-%34d _Qk#lymg!XEm" ί>O2xX7{b=oA{ '@ NqQetXE;`]ZcFsrԉR嬶J G“ u sDzDhD\eb܍H#V1lXz5HGsg}AcO2ⰾ=ۘ ҽthEO:Hnzf"{ddq2H3XG,lǃ!W\Y|'ҊDϤ"mAsi~ ]u7;ͥ\w@gҵ;aɉIdXD,..> J z"U=L&HDԠ' 4DZA =VTR{b_r' 4DZAL}DZH+DԠ' 4DZA =V,[vm  Sfggd"5xcffh> J z"HC" @jiD" iRH+ i}DZH+^g@)AOi@H z"HC" @ji "j81iԄ;> DZFGG'''e=V QZ!h4fffd=Vċ_\[(lD$ޜZcX*1fk#-?BDԠ'Ҋ"w#߰HլSD m%n KY"q_;=u@+1"]N =Vti3$D-7lޜ4s=WtU:xܲݣ.)CCCRH+:B 3bۗ'"u@tI4MSYPJiEgp3\+s'vw!" @jiE'QnjǼqǢ.#iRH+TxKHH‚' 4DZAe=V@!  5艴" V4AO銈t_@+)0C$H+Rj(4Zlٵ\IمG " T+wWFAW@ Q)hPA}wE^ JJsJY *V$7ͮ˱w>\z_)w@͑Ji4IAՊ< !T3VHa"=G Nj!Lp֬b"Rtqs?Kqdp *V$inW)wiLWpmH3u7<;Uxۍv?@3)%NI_Ч@ t^xߝP>1(E{ f:o*l}pw)u Ч@Պl^< nr)(Z~jZ3b:؈ipX͗g0+us>4IF#lED:K&-{yB_ j&N)^jET߽7}ykG&k[=o5le`ӈ,p>= :'DKA'"]IS@Պc'_|$➋L=,eፈyFCBMmO(Я#c^ҨHe4Zw_wdS;sύ qƊ7vETx6p; n`ד3Fi6m+krd4Zﻳό{| Gξ jۯfK)H Ş$rsCzK9|pxi=ZﻳM6=wyr_s_Gbw䡙#D[Hzvg7~'К$gc6jn44TPHe uY3y|Go%F6n]uhT@ tu@ׇvfw'ZT+ y}w.u 9oV"¥//n>xp'O:Hkƈ4{xs;l"A栂jD:/S^_{aתCC|o7O=qr=6L5dfH;ccBOzӢsв@ D%DH|3; ^.Zl;itɴ,hPA"9w. J6rQ Ư~΀AGo|t͚'lƣ?pKq~bGwU=dhu=pc̻ξrD sI UY[z *VDٸ3ض%I"*Hg,NJ(z4 i_jET߽6zcйI0ؖzsh{I9BaNݖ@.:! *Vݷ4}&~l 4]l{?qf s&y9#cFH&?|nO}1t^xA }Cg`[h;4ZQdߝM=g:!)hPA}wE iI5+o$9@ t^xߝwA|ds.YA LW4?)h)ᬦIW V{LYΪp[vVbӝg=?ꦓ]:v Xú?9d *V@2nz/tFurb]YiaO7SW,l(=p+>d}[%+hPA")w{ ËNJ49>}l8/;"ϝeA'9$#ѳ~d *V@2$trvs@ݿBY9q`-Lw'>LWo@ t^x]ɂdr TP]ߝ#:[9lhmiPEPA"9w. J6eytOHz]Эfle);f9JD )1}|xg]Qk|.*ϓ EQ5AڠYZZԧ>uU'Rb4|]T @qPAALNN={dHHCAE@B达O|'ɶ)+YŮl:-bօ[g:Vwִ\H` ѣDlBeNYsGd8n7A1%  W\!3^ÛO챋GRY'e0Pߜka~sPXgޜX*{2`GNc:D*((F "ϋdt:Dzo<9q׎$1r8A?ݠd"m  @[l5S%$" **((F].5D'O쿰1s?H"YJW"ޜ-iK 8) F兏xC⠂`ntig:Q"}ݑ[N8m;_$Lg]1;ь_? KPAAA\mNI IyZ$J>Co:7~8X= ]4Dek]y vp*~TP & 1nin_}Mt/ EڞEH[N8~wʭ}& Uh4PTP tF_zc,Q%4@PA ~1ui>@#Ҳ " H"4DTTP +W>H $088h&f.,cᙕ4DTTP{RO nn/m!m4DTTPЙ4蟲}h6D" **p IBiTM% 'ur-!4z͗&P{'%* @!Ҡ"ꀧr-l-Km}7ȿ,#`8G=ctF iPPAuzeļ*j %' ws "?WvZ8&qӁ1' ZN Ʒ7(f.1۰M^E:QJ&v'9w. J6z'!7zq\)HA OB!&N{{hۓN&F׽Sk={QA>̲+W6GD; cfp(fÍaMBfEDh *pÍDŽTYs\F!@'PA MD(*(D:#i4@@!Ҡ" @3H $D" **(D:#i4@@!Ҡ" @3H $HEu5VwWii0xFw0GaQ4TP tFEzQ,(H']0VΚ餑+%?!Ҡ: @3#^|x)=v( ƈbVMo#(~08+"$sН|TJ.F /fĀHʀ $0:::99),JLHx'G_^81$D2.zt U֎qJ匁{Dq3`Y^:DTTP 6ϢD'O쿰1s?HS"h'͏w!Ҽ;Au:*T%DTTP tFD#qv#I 4S8" sc1H* $HHo=}`͇?tnqzA"O5*j;fuAb?pAHg$f-ko%c Ch:lKh݉cBW:{Mc!wN}bTP tF_zc,'{+ V $HLx: " *(D:#X" **(D:#i4@@!Ҡ" @3H $D" **(D:#i4@@!Ҡ" LOOo۶MY4DTTP F!,JLLjX^4|tZb-*k4PTP tFEzQ,(H]4J`tˊI\ " H"^ÛO챋G`P) rb]q%E̖0*"1 4@Dxr#Im[ȹ%A -vMy9 H"(ؾ;f'IPۢK;e?vVxP DĠ @3%ٸ3ض%IP5f~ZQY4 $HHo=}`͇?tnqzAEz2 n[Tv=-݀CTP tFb&ܾ^A>2Al3k̚M`W}xU"m=]38f *(D:#`=t1 [:U:HAHgDc-kZHu:)}4k`GT4D:#XTHѭ7[gז=.C+DH"LvaӦQ7S]WZ 7E 2YsnȯtH ]HW 4iϢ@iW2iN_q$liu9jHg"HS7wŝbwN"r'D3O[Mo\<|9i tF 9m7pC__hioܚ=MIپn~D"]) @ پ};D:G>y$iR!_LNNwT(f5N͉4SڨW|y i tR` q7~򓟄H(KKK˖-tW^%W{qq5j)DH"%L` 1<<|뭷fiZdW*2LZcug|h"M3ğ&W4HwDLiʶmۦ/_/;eAF󅽊 :$ڛM&@4P 4D:{m襋u/>{xl V, /`F8tP6zѫiRo]29&&G?P7ۆNŀH @BhF]g:JwƓ//wHŞ4DiŦVR3CU;D+9+wLQPt^hRn#t: " $N@˯\%W8?~#I0ҳc4$M2%+fQ#GGӈt`<4P4D{憆H,nQ"}ݑ[N8m;_$v#!ms5^/;$~4H+b C @ ]BtbʕTXw;Z>Co:7~8X= B wǞ^pu{)D:C\ @n++WcW}3M?4ӽd| dh5&q}oCBr²9\SPNY6nRw~4'E _PE `=t1 ^66hn"݆N@> u!z@nbSw9ӽzYt: H@A|uEl֥H@i tKKKCCCsss ŋt: dHGAzvvc6nCA@ BL79!ҲD HKsw"-C k3:m,4H @LNNvٲkk ȕˑ-Ì[vM4 4@eDLpGsٿ-iۇ&: yH|/an E詰ПHH TCW0i뫧h%t[i#i ꉴߦI&wi'4D\-e |4DDHz"6Y(Ip ct" r" PKD^, J 9G Ԥ "~9զRH5D:H^<4ȑ*v@*(/ tE:JUIg: rZ%PJt@ ;(RTGgff ,]Q #U(jTDgggd td%P*Q襥%'$ѿjH_< w@Y~Ȁ: RsG TFc& Mb, @AR(*Xг,/]zATvjV_j,@AP ~BӠ}DZ?H(Ӡ#>"AA iHgitĀC-f}P;ޜ%)Q3L " :QP9R1-H*B}l2j 0ml%nq}ؘbzy8 qkl1e):82D8" T:  P Y"j4‹4SYwC_DZ q-n֔$/@@Atj!C>1(E7{>HXG>8;@`D( tP E=io4l/Gio['ǎYF דE+Oht0}Ϥ5u}O@vq,rX^N3ii@AE:ܹZ!h"ܒm6+*O老WB{ydlX8EiHt@A"4,A+BG}E " Z?+QP g "]qШ3tuA{ Z?HWg "]qШ3tuA{ Z?HWwynO5>G7m"Jg銣TB%6tuQ=O}huz75}:.e銣N0KlH{&J}ʻ/ko~Ff}?iwFW^iϦbmVY\FHWٍݨ}l٥wӻ.7}flv3[,1H"Q#݇Z w?3zg柦sO^8rWW[ ~]\5NXKoDneP>U`|?`H}A+Fv4jtjHܴajs'x/<@<\ ~D:sf8,snߞ(I#]I5PAoX5,Og\qϗnxVbd/nU<~0x*0:H}3|q@CY{k_Otőݨڮ܍݇Znϖ/ :}oV"¥//n>xp'O:H]jlKtϥv{4Pڮ ݇ZО®U65h)<9y˱G40q,mhI2BkB{co?`[?>|3; ^AH{?~|3i6V&U( A"yգ7>fw6N|W8w%w'߲EȪ!O-QMT z E?l:9-T DF EL=k6Lm֍Ƿd F5DӨayD(՞/;DZw_mv7D(RA ڳ~8hD=g銣NF\ "]]iϰ "]qiԈkA"A+ v yKNCHW3,_HW:Q\;5Hw9?cE2F+A GzN. Bz{Y:+i uv)D:y 쵾r7ӟ?/pR @K}r@}-%sUII3ٛ2ll]yWv?kɴ6(bIfsOҷg E:I\d"[UPN:08D(AF}QVA g)5B٥5f4Z,N34PzV?dD|U DH'k4(<5Փ|HW36sw$\eb̷(&G֛c$3t|>:$#ѳ~(tN.jv(]ХRwz&'1Ϥ!@6{EdvE6#&;!t@z؜:$e}ǃU DHĵs n'r|9YS E,1]G.NϤͶ@ݵ|4@ݻwvӝ¬ [V&s˷3ZܝDXɰ?.x?( ".g\;e "]]i%4s "]qiԥkA:lFA ڳ~8hD=g銃FA ڳ~8hD=g銃FA˲eր^2]Lji,hY(br0tuQ=r0tQQ#]&HW%3,A+N݇Z@3tɻQ#]BۡP ~897jXh;tjR b2dw^/Uo<@ {mUh;Z@t(#dطc HKgfo)ԨS֟~ tC"mwZ9ٷIqZax[ BKӞ3TnMn!|-Wu۞[W0JVbuݯ$+pNk MDjϺr1ݓSfH'ֶF)֡y@@Dڮ?|ϙ̑3Ÿ'Iq6'9ޗ+*%37Liys':T_L:bHgQ}$i^܇4ۇAoa?q^?8_T_|N׀3wԟu|׼w-HbE12ui3t@3tu(,ȓzwQ_GxmӜԌZ{QӈI?|;^z!H4.aǜm wDZ?HW.=+ =zQRA'6F;>o(ҁ k|Y̹}+!7'4$|mcX1@3tu(Ϥw|O|w\1Q-7d>Ɇ}Ǐ FCHW{Ld;BU4"]7p&wD$iϰr)SRć&%eW1P4ڿ`;0;a:9V)-\>j!#l0|د4E..igHu5("By KUv`?n["]] Y=CFGf9cE+6 Uum 9O8W|m)@7$z|uڿ_}oϥZX 3«(.=vQ2U鎡,/S8YW_нH~O eEg ?BšCչCGı$ݽ?膤"*„=s}:eDĪVXš"Ժ1t˝8֕&{Q % il`hnoBBe&pat7tu2mr Qnݛ_2PӨJܞyeViۇFHlո DķsGd7A6ڡc#e [LH)J;0DDh.ҕ4tui^|x)=v(  aA"ff/Z=u|oL1F9S WA+DZ?HW7}ykGw;R!>m/kMݴ}9K 꽷B-ntHg՞?>q~bGy5ys'vMA;bzguL{{*8EMK&Ҋ .i "]]uG6n95#$GMA8 ~4"=_bbPetHg՞>Co:7~8X= |XOTte a[ ia݇ZԢooin_}Mt/ EĶvH Į]7qW,ab5VdF3WȆjL^ "]q D=w銻mt)cD=g銓Q#]9 "]] Dtߨڮ,.i "]q4 D@3tŁHg 'pd-I,FbyD.i "]qu|h;;${ђ.uoUxU1/3M4G!"A+NLNڮ5kKzAVrCۍyY=_h;|<=o/oYCo4.B$ "A+NT"zηc:vʔ^Ǘ߰d[(tP^8G {qܓU- 29WO1D 1!!Nf!'Qwn6I ]WoLغs:rzEhEQy^pnAR4YW$6jtjUDERzqP)HWF&%<p⎒<,W"1%K"> H#%nݧ,XwfӝDXm?f @8MHWFMh;ıpD;9Bh\W(^N|+R:}nE9W݀'+䶱PE+kqQ8UCVF=' t"λch;'N̽s>҈v\:WvRc\K_A<]lEh~ѣz՞= ݁ <.6:Q7ϫ40tʼnfh;O=,(]  +X DWE0cn "]qEL1Ps,jb,| %+o;5':|N;>J0 H\HWl:N|2Ow>2W0q,7ҵg i "]]ty|E-+XD@3tuѭ=δf#؉ "]qtk0tA{ Z?HWg "]qШ3tuA{ Z?HWg "]qШ3tuA{ Fz% "]e D7CGt "A+NLڮsڂyKEޔ1tuHgը m1\rxcbYv& HW,"-X*Tʔ اbߪu dTj@Au:G]3*^?&$FC-gs!\6 wݨ}EW lByA--!Aoq-w#e7-Sשמyw mM9_N%$1qLFC-rz|%huX=`9E,i[[]tNa{  +v=WAK.ذڿm "=&m_?UMHg9U 3Pxz.y"AAi " H H&e8 _ԡd\،ϊ3?d݇ZċιtYP]QH{ot#r[" tj#^|x)=v( C 1`4>t;BÊA -1Fx6(n _@ TKvbo"7FDJ/r=+n‡⅄t" tj%;^|їv|$7΋Ȋe!Gqi3qF-brrIUT* x:^4L/ꗗ Oac~$F*}#pBe ꓷU5Omڂ'X)_'R++7'$Hr݇ZDuG6n95#$G#Lkv_xf] fGj5z,YJ,N[xe ށC-Dzm>sύ %;7ߖX]24kڀlؚؒ&߾ݣ4Dqa XKXXz7gYqɲxfYg dgQ}}]ͦZ~Ʊ\L' ue!]=4E?kyC&{ SrTd Đq iG.3!]?U.f#XdG%0#nj %0#C´\t{%0#!^ i LEHWB>r핐´\m)V_% )! I iH"3KIENDB`java-design-patterns-1.16.0/semaphore/etc/semaphore.urm.puml000066400000000000000000000022631312550536300240550ustar00rootroot00000000000000@startuml package com.iluwatar.semaphore { class App { + App() + main(args : String[]) {static} } class Fruit { - type : FruitType + Fruit(type : FruitType) + getType() : FruitType + toString() : String } enum FruitType { + APPLE {static} + LEMON {static} + ORANGE {static} + valueOf(name : String) : FruitType {static} + values() : FruitType[] {static} } class FruitBowl { - fruit : List + FruitBowl() + countFruit() : int + put(f : Fruit) + take() : Fruit + toString() : String } class FruitShop { - available : boolean[] - bowls : FruitBowl[] - semaphore : Semaphore + FruitShop() + countFruit() : int + returnBowl(bowl : FruitBowl) + takeBowl() : FruitBowl } interface Lock { + acquire() {abstract} + release() {abstract} } class Semaphore { - counter : int - licenses : int + Semaphore(licenses : int) + acquire() + getAvailableLicenses() : int + getNumLicenses() : int + release() } } FruitType ..+ Fruit Fruit --> "-type" FruitType FruitShop --> "-semaphore" Semaphore FruitBowl --> "-fruit" Fruit Semaphore ..|> Lock @endumljava-design-patterns-1.16.0/semaphore/pom.xml000066400000000000000000000033571312550536300211400ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 semaphore junit junit test java-design-patterns-1.16.0/semaphore/src/000077500000000000000000000000001312550536300204025ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/main/000077500000000000000000000000001312550536300213265ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/main/java/000077500000000000000000000000001312550536300222475ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/main/java/com/000077500000000000000000000000001312550536300230255ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300246555ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/000077500000000000000000000000001312550536300266405ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/App.java000066400000000000000000000040421312550536300302230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; /** * A Semaphore mediates access by a group of threads to a pool of resources. *

* In this example a group of customers are taking fruit from a fruit shop. * There is a bowl each of apples, oranges and lemons. Only one customer can * access a bowl simultaneously. A Semaphore is used to indicate how many * resources are currently available and must be acquired in order for a bowl * to be given to a customer. Customers continually try to take fruit until * there is no fruit left in the shop. */ public class App { /** * main method */ public static void main(String[] args) { FruitShop shop = new FruitShop(); new Customer("Peter", shop).start(); new Customer("Paul", shop).start(); new Customer("Mary", shop).start(); new Customer("John", shop).start(); new Customer("Ringo", shop).start(); new Customer("George", shop).start(); } } java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/Customer.java000066400000000000000000000045551312550536300313150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * A Customer attempts to repeatedly take Fruit from the FruitShop by * taking Fruit from FruitBowl instances. */ public class Customer extends Thread { private static final Logger LOGGER = LoggerFactory.getLogger(Customer.class); /** * Name of the Customer. */ private final String name; /** * The FruitShop he is using. */ private final FruitShop fruitShop; /** * Their bowl of Fruit. */ private final FruitBowl fruitBowl; /** * Customer constructor */ public Customer(String name, FruitShop fruitShop) { this.name = name; this.fruitShop = fruitShop; this.fruitBowl = new FruitBowl(); } /** * The Customer repeatedly takes Fruit from the FruitShop until no Fruit * remains. */ public void run() { while (fruitShop.countFruit() > 0) { FruitBowl bowl = fruitShop.takeBowl(); Fruit fruit; if (bowl != null && (fruit = bowl.take()) != null) { LOGGER.info("{} took an {}", name, fruit); fruitBowl.put(fruit); fruitShop.returnBowl(bowl); } } LOGGER.info("{} took {}", name, fruitBowl); } } java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/Fruit.java000066400000000000000000000033361312550536300306010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; /** * Fruit is a resource stored in a FruitBowl. */ public class Fruit { /** * Enumeration of Fruit Types */ public static enum FruitType { ORANGE, APPLE, LEMON } private FruitType type; public Fruit(FruitType type) { this.type = type; } public FruitType getType() { return type; } /** * toString method */ public String toString() { switch (type) { case ORANGE: return "Orange"; case APPLE: return "Apple"; case LEMON: return "Lemon"; default: return ""; } } } java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/FruitBowl.java000066400000000000000000000044571312550536300314320ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; import java.util.List; import java.util.ArrayList; /** * A FruitBowl contains Fruit. */ public class FruitBowl { private List fruit = new ArrayList<>(); /** * * @return The amount of Fruit left in the bowl. */ public int countFruit() { return fruit.size(); } /** * Put an item of Fruit into the bowl. * * @param f fruit */ public void put(Fruit f) { fruit.add(f); } /** * Take an item of Fruit out of the bowl. * @return The Fruit taken out of the bowl, or null if empty. */ public Fruit take() { if (fruit.isEmpty()) { return null; } else { return fruit.remove(0); } } /** * toString method */ public String toString() { int apples = 0; int oranges = 0; int lemons = 0; for (Fruit f : fruit) { switch (f.getType()) { case APPLE: apples++; break; case ORANGE: oranges++; break; case LEMON: lemons++; break; default: } } return apples + " Apples, " + oranges + " Oranges, and " + lemons + " Lemons"; } } java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/FruitShop.java000066400000000000000000000065131312550536300314330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; /** * A FruitShop contains three FruitBowl instances and controls access to them. */ public class FruitShop { /** * The FruitBowl instances stored in the class. */ private FruitBowl[] bowls = { new FruitBowl(), new FruitBowl(), new FruitBowl() }; /** * Access flags for each of the FruitBowl instances. */ private boolean[] available = { true, true, true }; /** * The Semaphore that controls access to the class resources. */ private Semaphore semaphore; /** * FruitShop constructor */ public FruitShop() { for (int i = 0; i < 100; i++) { bowls[0].put(new Fruit(Fruit.FruitType.APPLE)); bowls[1].put(new Fruit(Fruit.FruitType.ORANGE)); bowls[2].put(new Fruit(Fruit.FruitType.LEMON)); } semaphore = new Semaphore(3); } /** * * @return The amount of Fruit left in the shop. */ public synchronized int countFruit() { return bowls[0].countFruit() + bowls[1].countFruit() + bowls[2].countFruit(); } /** * Method called by Customer to get a FruitBowl from the shop. This method * will try to acquire the Semaphore before returning the first available * FruitBowl. */ public synchronized FruitBowl takeBowl() { FruitBowl bowl = null; try { semaphore.acquire(); if (available[0]) { bowl = bowls[0]; available[0] = false; } else if (available[1]) { bowl = bowls[1]; available[1] = false; } else if (available[2]) { bowl = bowls[2]; available[2] = false; } } catch (InterruptedException e) { e.printStackTrace(); } finally { semaphore.release(); } return bowl; } /** * Method called by a Customer instance to return a FruitBowl to the shop. * This method releases the Semaphore, making the FruitBowl available to * another Customer. */ public synchronized void returnBowl(FruitBowl bowl) { if (bowl == bowls[0]) { available[0] = true; } else if (bowl == bowls[1]) { available[1] = true; } else if (bowl == bowls[2]) { available [2] = true; } } } java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/Lock.java000066400000000000000000000025201312550536300303720ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; /** * Lock is an interface for a lock which can be acquired and released. */ public interface Lock { void acquire() throws InterruptedException; void release(); } java-design-patterns-1.16.0/semaphore/src/main/java/com/iluwatar/semaphore/Semaphore.java000066400000000000000000000044021312550536300314260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; /** * Semaphore is an implementation of a semaphore lock. */ public class Semaphore implements Lock { private final int licenses; /** * The number of concurrent resource accesses which are allowed. */ private int counter; public Semaphore(int licenses) { this.licenses = licenses; this.counter = licenses; } /** * Returns the number of licenses managed by the Semaphore */ public int getNumLicenses() { return licenses; } /** * Returns the number of available licenses */ public int getAvailableLicenses() { return counter; } /** * Method called by a thread to acquire the lock. If there are no resources * available this will wait until the lock has been released to re-attempt * the acquire. */ public synchronized void acquire() throws InterruptedException { while (counter == 0) { wait(); } counter = counter - 1; } /** * Method called by a thread to release the lock. */ public synchronized void release() { if (counter < licenses) { counter = counter + 1; notify(); } } } java-design-patterns-1.16.0/semaphore/src/test/000077500000000000000000000000001312550536300213615ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/test/java/000077500000000000000000000000001312550536300223025ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/test/java/com/000077500000000000000000000000001312550536300230605ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247105ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/test/java/com/iluwatar/semaphore/000077500000000000000000000000001312550536300266735ustar00rootroot00000000000000java-design-patterns-1.16.0/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java000066400000000000000000000025571312550536300311270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; import org.junit.Test; import java.io.IOException; /** * Application Test Entrypoint */ public class AppTest{ @Test public void test() throws IOException { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/semaphore/src/test/java/com/iluwatar/semaphore/FruitBowlTest.java000066400000000000000000000033301312550536300323120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; import org.junit.Test; import static org.junit.Assert.*; /** * Test taking from and putting Fruit into a FruitBowl */ public class FruitBowlTest { @Test public void fruitBowlTest() { FruitBowl fbowl = new FruitBowl(); assertEquals(fbowl.countFruit(), 0); for (int i = 1; i <= 10; i++) { fbowl.put(new Fruit(Fruit.FruitType.LEMON)); assertEquals(fbowl.countFruit(), i); } for (int i = 9; i >= 0; i--) { assertNotNull(fbowl.take()); assertEquals(fbowl.countFruit(), i); } assertNull(fbowl.take()); } } java-design-patterns-1.16.0/semaphore/src/test/java/com/iluwatar/semaphore/SemaphoreTest.java000066400000000000000000000035321312550536300323240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.semaphore; import org.junit.Test; import static org.junit.Assert.*; /** * Test case for acquiring and releasing a Semaphore */ public class SemaphoreTest { @Test public void acquireReleaseTest() { Semaphore sphore = new Semaphore(3); assertEquals(sphore.getAvailableLicenses(), 3); for (int i = 2; i >= 0; i--) { try { sphore.acquire(); assertEquals(sphore.getAvailableLicenses(), i); } catch (InterruptedException e) { fail(e.toString()); } } for (int i = 1; i <= 3; i++) { sphore.release(); assertEquals(sphore.getAvailableLicenses(), i); } sphore.release(); assertEquals(sphore.getAvailableLicenses(), 3); } } java-design-patterns-1.16.0/servant/000077500000000000000000000000001312550536300173125ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/README.md000066400000000000000000000015611312550536300205740ustar00rootroot00000000000000--- layout: pattern title: Servant folder: servant permalink: /patterns/servant/ pumlid: DSkn4O0m20NGLNG0G-ys63cDbv0SV7HzRUnUy-QYkSOkONKwWU4haV6JZe8pjd2nt1MYIBatAZKU1XjTVFEoYvT3by60c3erzW_qdPiL9CY_KrXB8rfz0G00 categories: Structural tags: - Java - Difficulty-Beginner --- ## Intent Servant is used for providing some behavior to a group of classes. Instead of defining that behavior in each class - or when we cannot factor out this behavior in the common parent class - it is defined once in the Servant. ![alt text](./etc/servant-pattern.png "Servant") ## Applicability Use the Servant pattern when * when we want some objects to perform a common action and don't want to define this action as a method in every class. ## Credits * [Let's Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf) java-design-patterns-1.16.0/servant/etc/000077500000000000000000000000001312550536300200655ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/etc/servant-pattern.png000066400000000000000000000726271312550536300237460ustar00rootroot00000000000000PNG  IHDRp"u^IDATxo}X!K  `  (4 9XQ)1\;0THR"3TȖQ9iKlq +,lg&L."T=O=]zꚪy@i]`ȑi@`D~]\ 4*Hعi#Ts3|;;G afv vPALxw3ݝijb;|j]kzVWDzafv v^d罹Vksy&ZRZ`ʢݾo#o#);뽝Ε⥷H .Pנ&Τ|W])ȏÅ׮KEvY׌8L|,ԵMض|[x :6Ad:EWF4s3|;;[CXz;_ &imJlnu޹v/Rk* 4'VV6;߉;:3v~@™ 5;/\عid٘rZ6S?TS|Sנ…&9B ;7÷0Ms vn&v\wH\Z9BŨPE[G$B֫Bg;wG*yPA"ęm p/ߙ=qa,֔^*dA83ع;WΣBu[/\_b×K/*Z83շsrm Tr#'].u"bߕ)O& ?xW޸v^qf;'1m`IՇuU|ߎ=ɏ\{^֩o|l;ՋMxY~V9Oٹ >vnI83wNncz- /\}=/.Ag?<uz<[w+m=ϴд#MK!Lv-rkH#Ww7ɏ~_/?zd{dc"9̦cegvFm po^>W~ ߼̝_K/~H7<_g>S ]v{lћ;PqfswD[GJxO|\~9W,5i/G.g;wG*yT/gO>-~˜M! vhUD3#z9ZI`&m f]̵3&nLhUFQsOMoI7w 8>ȘtBX!L-|D\h~=J^Y祭׈GTݱv<zxns33-^:{o,ڥ[Pxx0{\G-j4E3SK;1>ABb0ve韗^#jtUO)3%G}YN wڽɪS8&҉3,+e A5!L-|r~Ci;"yT=I.h5<#O GGsJ>H?H~aEp"ę8ձs25:@Gnl=&ڹhzhΧ(BZ(E;g{穕^zyTA w`{\msAdw1]TOQ83~i=f2;KPOhU^Q~ Mq<;OoS!L]?qĸqe]D[;?BDӼ~]]gvޟ,1vEPZgvd֫Bg;wG*yPA"ęm p!TqfswD[|P&G\eߕ;wG-p!TqfswD[G$BSm `$BRSm `$B2ƴu*H83%9i#TqfJsr;G TwƴQm;{FsNO*BJ;'1mvϣ{}#$\d|Q-D3S' RSr֫<7>{gQH,>p֎|;krߙwy&=s¼eus3רe#Tqf*Ԕƴ*`8}L,ffd F#C1Gvd&M_G~TZΑM0+;Wytwr3 ^6.ۊn}Ԃt'g{Ƭ^1%;OGݦf#B֫zweXR.m`$Bv_!e Wl;˽QtMf5dzT̷K8#tD[#ݴO^zA"ęk/m-'MLXo?g"")UY.vj%ںMWWW|o_ *.B\vwק_c1mx{ܥNo{;y׽]H,Rm&:2Q\ڵ&PE3|J@gT3vAR:FGӤjVs<+i$#Tqf3g6ey>2`ORGᴩGf|;HYM}2~).MfK^q=MU4-̐<~x PG7?b< WƯ1Áwxj#]O#4ZعKDE\ у>qf_u ^JlP¯1{sGAo-m)5-I4,\7w^&T5`^ oooϣsoprmᵭC/fpͻ~V58TpdYT&! vhIOytw/_yJRצ_cWY yJIHCM B?5j">Qm^e?2rVyt'p΋X]~aһ|蚸e;wG*u̱xw±yRڦ_c&ӼHv`;*T83ع;Wy@/=r7.R1^ywoP }QNL-B!Os!ph/C5PzpPmڇ  iGSR ;7B֫@Σ)GuM(B֫Bg;wG*yPA"ę\E֫vPA"ę\M֫vPA"ęΥ_ͨO[9Bg;wG*#Tqf9>qb_Ɏ{̵i%5.;A[/ٹʬ54m'XWr .aͱyfyegfωD8%C*F35 heQi%%I N@%SKkƒvjj9!p;ϕYʁK/+k)IH[3#rI3I}L'k”'XW'Yڒ^E2t}OdV,jR"ęny4Iz\d59m)&Jc Gk ISY4geb}FǛe6*BI yi`;miL2ʕ8Rr5aG/Q&;iU`Q9L} y05'qaGꂫUy$ g%/G86Z.B\ӜZJ7Y;PՏs-țΣL[remeHԻ|w|'Υbtg1ar]RfbM=GE3jӜ>G?ThU`Q2V+jq,/BB)U Iʡ24uT)ȏՒid\;iU`Q2䣻g2iuص28zW^9G16yjd:kX.cSw΍24uTdW)r-Z㌓Gŵ24u`^&:ңJ%47Z.B?j6Cb ! swD[G$B#z*H83cyФWD33_HIs vnvw$jpsskkk%5'*Jع1<`,q`fn*^e]__ْ;G afy2Os_$榐S7N[&Ȍr[=z‚}„eT'dރ'&iPILs#Ȅ&M͟U2f}} D6i)d!Ur &.6[u4ƫ)N׃ہY]]meuWP\(Ժ4`٤D*k2H9Ox*Fie/;q_k-tc'YYpԵrW5&Ia_}|bATI`ήnpA5 %ydY)M%/:mrԾv2<" fBtާ&+7%Z$R|Ng&L/K%_RF７,|2q:^tTp%kN]{yӨz6Y&R_~eܛ/\[xmP7K2@ϖ2s{~Jkb6 Tc&j<_N#7 uO|a,m̸/>oyRv. /v[IᒦfkQs9S&y6|J_|v`"3e=ݾ|򕷯]/JiǬ0+,;Wnޫ]y/X K֓!s]]@5QI~cRThZШ⫁,;ʦ5m~ݑoCywtHuOV_'kZ/y; [[[\ZZ* e? n?+^cy2g5w ٞٽx޽;چ΃%ڹ<5۹ઝ'm&1exhڮˠReͻk7i.껏g1GoI>/ḻxw±y2Ҁg) f,e(s vnol{榓88>+ voaw(.思Cilooai?fJq!Z 8v%s޽^z@CidG$9;cそCU^~ .```P!D7!@u9vUիWvA}wnCF>??rCݦgMڢ`Pin삀?~] IΡ6q‚蠗] IΡ6\p`P'6t;7Ρ~8p0wnC-;taBwnC^.KKKeds7[]]-PcDb;G%*Kt 7Ξ=jPa^)9@t,,,D/]/55;(Çc$6=t<Xk$j vP ܻwY{ei Q5ZTǏmҷX ꠷Z-Pwsj!|_;wNvPQ=z;{{{t͡`իL^4S~APwsn9#-?Ki?` nSJy`wQj KKK߱s7; P'VWW^;_g;g;kwz9s=xB|W1'y`z#]tӋK鼝:K<wdl䚡j1ڹKƣp޹]> Ws硂իv{˴s4=aC41&vw>'/o}>'BbG/t냉%=JLk- Ǐ^yOdٵ|Ϟʧ>e!#_cɿeRnʼ[a.5)KA϶}"y`ooo ^__V$zg?OWp˾+ Qid?=XG 2ٹo_v(`0QA;.#4W弽_IJX#tk_]G=ȧy¼3_zWC&y.ϴΝ 7g\XdsOӽd_Ν Us_عP`;wCعP`;wCعP`;wCعP`;wCعP`;wCعP`,;u<yPr3ֻm֗u d \l6y`0Q\y:~dwsZs硂D)vt0j{5JqMދ.K_x/]etYZ9oj0\G-j:vy8n~tQwECj<^8ꝧ7v(*LTwiӏ*k &ʲs4]aC aC aC aC>؂#łs'Ԣw:T0vхDVf;noN G/ˇ;}-;)B,;? '^z1 RIc]5=5Mw%$|e +KX &ۗ^@+XebYA|ټح[A5˷X &O>rs'=K`1{gQ,[+3 ;<ZWlyݖ6c;o$T00< @/=r7.2A=ޣpGPPވG@ C5PC ;w*L?+\Ao ) ;w*LohΝ عΝ عΝ عΝ عΝ عΝ عΝ عΝ ӵSDfz(`"dB ]9ms硂o\'y ӵ_4E1BΡjP``雝;łx=?I;dHJINM厸6^w:3rr\qepDqޜf+F?J30$qΝ Yv~N-bXL4b{vlbAg:mv}5x qXMva)V3 \Uy`0e=ݾ|򕷯]/JyJe ӛҍrA;WucoE|y]-L⿩KUB兝; &O>rs'=K2*uS5~ gPYnja;*B,;?sc7N_{kڝg,c+beb3`o3і\5݇y}zXۡ>P`(Nk߸$KuԳcө-Se>7CNwx@vax &?T{sĂNAo{*jv3ilr"ԨK-D̓?5$r+^#qUL; &ۗ^@+XHj>SmV4k.bb moλ}ő{xɒJ+dp1~ڏԡDGn.x)Vjy C'G<6u·Hm/k`0egn=sko-^Eple^ەu8YvlH#l3mȽvl⍤lRQxѕ.qI,6GVecNl>MyؙQ8ٿǣO=,M`0a㷟&ؒf7JvH3䃏;w*Ld7_8֋nbe% iuM*x-Tr*IKoꭑ/F/SMo3X,RGrGJÊ; &ۗ^@+X5&B>ɍl ,3R˾mGtyA|/rs'=K`ɛz;OyRPcN5} sg;*Ld[q[,>{gQ,[+3-6 h\FiMG? lg۵{ eA ?8퐄 G>vGW^% ^*V阎(\/ecYGӧEWgD^|}N\8nNQ8΅C5`جRͭi; &vJ>g ;w*L4ΝvQb;Elmyc8aC ߸O*Ƴyv;Nk%IgCO1`0a_}|bA腇9K¤)AnПvҳTґiM7'u4ȡ̹bD=*tKv|GG.|G=qD5`v{ccSReѰ }ԩSe;=Y ,Sgleeٳe;w?tXtM/D](89?/߻wGK`󫫫;G:rHR?X,ԂV=98ѣG7775ޫF`v+DP{spceǏG+Cy9=|:1KeoKk &>ѣGK(jOmW񬂉`PozǵZ[[T-?9t萸.wそ@9!S훛_è\0a?? 9LvFsG?p?޽{,vwwE+RGF`_җE.(DzDZ)Ͻ{9<a}}}mmR~e'Z;={IQ;LvN&S#D… そ#84n֔8fsp%5 @CD܍u~٥T>e l5g{1+ v. ;Atj.:|0w!?9@9rHM'RD_ֱ8P49|M: [[[evPQ׏9Rv)`eaaQwvgvvƠ`P{8Z.]t vPifgg.TPs7<.E0Cޜ:uj}}R].9@ XXXXYY)P]s1{{{?jzs.VƬ.--] Klmm#G :`PKΞ=[v)Jccc@;=9Ԓgիevȑ#[[[eL  ;ZPvʧ5|"sڃ@y]J@s#NZYY)`ȑ#=D`P?ooo] jj٥ .\(P&9ԌWW 5g׆@(;pSN{cN69Y vub}}n]"u7p,3/֚ vG)P9ԉٽKQiWD`PGk9,--1!ns,,,]:;zpQw6G٥`&իW7j*Ou/--]ά2΃8yms:<79>w\Pdr*r|٥=v;4u;s޽Pus4{{{;׸Rv)s4k>;;[v)ȑ#ev 6=.L*^٥:9TÇ G/N!z<9Tv]v)\C|. 0Ms l{] 7];2;;Vv)ի evP GH tAnl9@5J^ؐ ɍ ;("l#k,AmsdM9% v ;Α5a[]g;8vm.:NhCy>ئ  Vksdail٢MA9%*a;TK"`(E}qFDrot0YDVk5AB]S!a4RvP ;ݙT(T6 BܑRluvY׌WVVc vF"7#E8D#Zj jy"脽]#ih|5ile66@*aۈ7SHQ=mO6J0 4xRiv{aW+&Zc "6TVo#CQufhw62N255IcYkl9@T,f+| (1&)+rQ6[){E+E"kj&VJc 6MO9&D ;GքX@aȚsKa(Yv` "l#k,AmsdM9%}w_>ߟ73{bY)Tv>hZ;DM#lJ"ԞOݺK,b}eiM(u)SOl[_w_ӿ7&zvY; 3)*8;fqs*$MRKv`Eؔ<歧o>w[EёFe;R_3[8.oy*KU;ԛQ?>u:ε) ;zRxR`ru9mʷχ95rt]v~,;\+ªzﻛ?G~qsyk{^<#}=|(posz{7k*|MK~=L?{1sQ7 +o^yXo?$myd!!d{C[՗IrvfG9%*aaȚsKa(Yv` "l#k,AmsdM9%` tAnl9@05O-zȖZ@msdM9% v ;Α5a 6P9&D ;GքX@aȚsKLa{]6?Mvi;=)6Aus[MXS2-w DTG;W4 ;9>$KzsA(LÜbbr3̴Z3ݝn; L<إ8NtA\#WWZ8l?2ZE*=2ail46k ;(~iaxEX/v@G0M\ُE("¥ZYBP~p9!8Y#cFcذsa-"iJ}8~lMV.ebk*R鑱KcYkl9@0^9.GcC"|&sM.QGSx*/-=2ail46k ;()TB$2Fh|RaN^ADM6*hlvP kw IO'hzQ4^ A觓ѹa N#,fa2IE5UT9% v ;Α5a 6P9&D ;GքX@aȚsKa(Yv` "l#k,AmsdM9% v ;n_NY{/Ǧ:9,QD[qsj,a\ Hb(vYNx1f:A螟*qSe9lGS\;Uil76@FX?axIĩ0)u"dpVg9Ѝ)Y$TQSFcذsa-"l1j4t:&I.Z3RkV2.'46ƆHrKm<O5֏qfkxu45y+k46vP SD7(H %V;)ʋAW&+†㟙OtkPW#,fabfy!f9wiz:i [@NVNh:Lqg+5QLج56@&E*$dgHv^hl ;D"l3$sjpo+$_@46+,Q;GքX@aȚsKa(Yv` "l#k,AmsdM9% v ;Α5a 6P9&ϻ9|}ѳkwΚ9h4 ;D&"lUG;Y4 ;9JrMiΊяgsg,kdSq|EgP9زV5|c dhSPY6;˽D̊SAG Q(wFKr=Ht=R ߺy ]iYsۍ ;(62+8rjj"w}euMaS{2KքY)}ZjJu9ail46k ;(k3?hQa8-fQM bkܭ'¦RYkTnΊ46Ɔ;vtÔ҃Q:nM:jghi_:]Wvج56@,/,.O'#^ ßN>O$nGXZc d;RP?=jhVsKT;me?v[Cc+D9%J,5QY,AmsdM9% v ;Α5a 6P9&D ;GքX@aȚsKa(Yv`DX5}xRkSgN=zRe5cSvZf4$9JVTn9#U)'u@9dtZ Əv` s5' ŌSJuy;݋m?ĎJHWX \,;O)wJ9Ѣ5sM߱}'['%K~,;t:3 Ffm&\`9#C#ZU# j;aTRCFi( .ddڽ$RSq38e+G ]:(d!ʖo ẉ%Ԕ-Q*;1Dغ4^#ݐ./*3]z9#C#lac{Khٷ8 唝gn02O}Tsgo~k?eQ߱#CIc{7C~k#۸+XG;Dcع٘-GԠھWoJ#yʣ~CBCoF~ǔC -Cem`QV{9lڽ$gʩlvOKTMfKn9b6ޠ̣ezՔ-Q*;146@vmyloR9FYxn'o'09;8jsUwJ:w귑:[~|;146@Fsy=qz0\"yN:̡TY;{׮afc{^Sd]iS[j;oF~ǔ-v` s=q?? }Q0`k ?-Sܙa`4*k{0uml?px[9S("qsr37`{ˑaa|7;wRO:{^gÜLN-k U5|r= 6> !5魣ho“bGzA׸? T{N-bXO߳2JOBqETikk;DV廗}%Px)Vۄ<롡prqGq*R9&YO>rs'=KR&y\j545Q,az؍Zvg;bʼX)orh,=lsdM9% c'^zto\ ej{t3\yl'ߣ M Yv` s}sh#Yv` {6:$|AknS9&D,;?p-hhSJh-yj;GԢw`"l#k,AmsdM9% T<T9%vfE5v` 켁KX;osdM9%&^8y~ƈ3$3q5HV]<=7")"U9%uWw2+vnV5<ؔG᤬}}).D9% W8}/xX/y̓Sak,,> .䔩R)^dU\"$ԟ_Z/Mqf:^MMaaϽɵ׶^ uC+mn;~/JfqNDn f%`-=UVU-lBD;}pA@ނX"+tW޾wE+md;<U(YSc$woGA )Y[Ʀs ov^\ 6YOݙ -UW,Ll#R:99og.̸28l"8xoN;^1QRf&qil9d\ذsɊ|k[/!^ Ix=;btʁ`RyA3x u*尼ivժyƖNlN5e㥩ذsɊ=ݾ|򕷯]/Jya :F B;W(woE`8 ZTՌnV46dn`LJY ;({'p΋X)oeAz?ό*kCbZat?FW4sJ,az؍Zvg;bʼX,{<יi0m9x>Yl =j,LSGPfy[z=ٜLkT ol9@Nz؉]{Ăxnz Hw1eIyA9>+iMU<-Q8J ;(CzsoĂUF2_ y6h*%;9Q SմsXv`#,9.D ;GքX@aȚsKa(Yv` "l#k,AmsdM9% v ;Α5a(7Ž6`:ZN";ٙe-s< ;=hgs(JVhXao\ %Dž t :b8*ꪝش~+ZUv` C}'N7޹.K% t:3~z&ty2+L2zogd~'~|\[ɥ%h/F'O'?|ボ;C>xq9?*hC tord[o:JL|^jVhX"+ž{k mx)Vk*_AR5r6DliAzt97 "F/S.#;-pxJ2'lX^(!AY5;2i1S?l]iV;AZ53 \&Xao\ ӏ#v[eU3|V#:s@iTaS&Xa|7;wRAݰ[S RM ' N?4OAwSAzTiM7'+'L&t#F|hc=Ng_6~CjV2zo''^ЛhC>Sinl3M;DV= '^z1 RSJ( S"f"#禌B[:jJJCn;Bo#.fy۠Du4)f7!]& Mly!O6^^l,RbM;DV廗}%Px)VjsS)&i&ā&s=;&G [#@rS%GW{gQ,[+SSL 9˲s`FƏVr/p/x#i3Kml*SPvp~q] ;R&X"+ =}KܽvKbAT= @\/ tR.N>xCڻ(Ʀ혶F}7fVծLlpYg8y6uz㥉G٤sK"㷟;$8e1o4_E~ (VT&Xa-IROQմsgTWIchHEsdM9% v ;Α5a 6P9&D ;GքX@aȚsKa(Yv` "l#k,QtI/fz7sԐA^G3xSyTj䆝WYx.m;9ž߸ϻ)Ǝq)otҧ8dJKܠjP;V.d-*v` C}'N7޹.KmLS5t0D8{kQ~;Q٭1DZd aRPD3Jz!sVf~1"l}.ߏhB(jhv۪42k;({N-bXL4~T?z Ef8rOE復}ԿQ )¨9^KcKd +E_}jh8.SxsɊ=ݾ|򕷯]/Jyt>tM[^&""ak4.N.<Su%7V5ilT{LՔZońѢj?rŅX"+Gn.MkA G=x ^zH{l1 (d#ƓPjnMw_3ILNMΓy3IOYFwj~c&cQ]Z MرZ{5ئ4o ku\ LuxաsO_^lz?;ˎ,l=fּeڢdDϤwkiLO)wkKif葓\leHuq:ߦ.ZO@f$`V{pv~{& jncNfLS| :"OTwpy>vwL|LsOm*\-mjh=_Ic-SG+Uz,8ZrKI@g.ڨUt w}h_䃞ʂZ7awP'dNĔl<6Yj"z?ii 4t~ΧїUilf-lZL5CɂjIVߨdT*rg6%N緞Wݓ_'Y OdUmˡT*$;QE)G^,Uy1Ow[blǫC|tNw^<nʫ(>=$GGppL;xtU,Ȫ>C͘D&U'-zGsMS|S0W`8t.Uz,8 ad 7@yC]np@1Ή t<@# t<@# t<@# t<@l:EQ' ~>(+nY&9aO3:[?NӇu5W oҞV>ֿ$Zt:d߇SYU}!*K p& ^@'϶~ DLl-+ВVZj/8"}P*eZVAQov>~.J}8z;iZRjOg>U=^kgjOU9}XXfײnMyn5[Z t~y{=uDVQ&+(*/$;{lKk:7RbLʖJ75ٞ.k'h1nRk<` +},JA[Fyx~xttSV25Vn\s:~Uͷz&Fl:腼} g-L\|ˋ^gwyyّhݸ4\Q$׹y˙-5zs;;zA!It'nZ_d;\:K java-design-patterns-1.16.0/servant/etc/servant.urm.puml000066400000000000000000000024251312550536300232530ustar00rootroot00000000000000@startuml package com.iluwatar.servant { class App { - LOGGER : Logger {static} ~ jenkins : Servant {static} ~ travis : Servant {static} + App() + main(args : String[]) {static} + scenario(servant : Servant, compliment : int) {static} } class King { - complimentReceived : boolean - isDrunk : boolean - isHappy : boolean - isHungry : boolean + King() + changeMood() + getDrink() + getFed() + getMood() : boolean + receiveCompliments() } class Queen { - complimentReceived : boolean - isDrunk : boolean - isFlirty : boolean - isHappy : boolean - isHungry : boolean + Queen() + changeMood() + getDrink() + getFed() + getMood() : boolean + receiveCompliments() + setFlirtiness(f : boolean) } ~interface Royalty { + changeMood() {abstract} + getDrink() {abstract} + getFed() {abstract} + getMood() : boolean {abstract} + receiveCompliments() {abstract} } class Servant { + name : String + Servant(name : String) + checkIfYouWillBeHanged(tableGuests : List) : boolean + feed(r : Royalty) + giveCompliments(r : Royalty) + giveWine(r : Royalty) } } App --> "-jenkins" Servant King ..|> Royalty Queen ..|> Royalty @endumljava-design-patterns-1.16.0/servant/pom.xml000066400000000000000000000035761312550536300206420ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 servant junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/servant/src/000077500000000000000000000000001312550536300201015ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/etc/000077500000000000000000000000001312550536300206545ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/etc/servant.jpg000066400000000000000000004074551312550536300230570ustar00rootroot00000000000000JFIF``AdobeeCC" }!1AQa"q2#BR$3br %&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz w!1AQaq"2B #3Rbr $4%&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz ?(((((((((((((((((((((mwg#iiw^ ~/[~=z\$Msgqr2E?Qg??_ax^[}s?0t/G<z(_\?yQg??z(޾ ?~G"`޾ 7€9oE(3E:w[}s?0t/G<z(_\?yQg??z(޾ ?~G"`޾ 7€9oE(3E:؇ u{xsĚ/ᖋ|I 15:FYwKg𔷲^%i}3>#9} i~oC<,0qTөGRTh{7 jԂ)b$T暥]dO7˩Jkb=jSF%S8G M֧[\EV}s?0t/G<~W=/k /5( O~;W~"CZ]:>zR+Zn)w~M>9?eOZ/|Ln> ែ> x? nw !ymM׭4IyncsJOQjNÚRs,(QaڄҔdKE8lDcݕ*E/G<E(3z ZxRT쭬coi8mgXkŚg?!*|J4u-BMËm6 ִ[Owzm3G7:kYӍIF)֨ЩJԩգB״\:麑sJ7iC6*N:YUBh)VrV|E(?e):pITT+'"`_\?yu;?FW "`_\?yu;?FP-E:??~]NQ}C/G<E(3S}Co__rQg??}s?0u__?@"`_\?yu;?FP-E:??~]NQ}C/G<ͩn؞&O m>q/ &6RywAfLyj__r ?U(((((((((((((((((((((((((((((qZO:?|1]"`bw?€-y߯Z3U]{z(י=_U޿ 7?€-y߯Z3U]{z(י=_U޿ 7?€-y߯Z3U]{z(י=_U޿ 7?€-y߯Z3W;iеQtiwֳ-/MmcIcGʩ|;/~+7!^j)^ti5νh;z9+N4ۭWMݤxA~o~j-CTѼUIc◇FԼwxKymuG"Új6rI+?4]5Oû?^ W;mO/kڃS־"h/'|;xwúz^m|6<:}n;FWs,:tFJ9haܹN'9QkBJZ[dy^>Z3:J|،J$*aGkF)*\ᧄ}9E^C5}Þ nפЬA,ngI 0/0|BcgZǹ4{X;K^~k/G=е{{9[~!_'ǃwz!}3Z֮j8yFU0t~nK2%YBJJT})Q(ӣZ4'R5KԭyF|c:ʝ:a?f/o`w?oN"e k߶GƯ<`&JLԚ_O%Ɩ$wX},j׎5q:_k_Qi??ڊֿx~ G#Zoa(F(4QֵEƟJ'k7?05F<;j+kZOy%k_Qi??ڊֿx~ G#Zoa(F(4QֵEƟJ'k7?05F<;j+kZOy%k_Qi??ڊֿx~ G#Zoa(F(4QֵEƟJ'k7?05F<;j+kZOy%k_Qi??ڊֿx~ G#Zoa(_>i 5KOSUV`u^>Ih,qG"R@ ( ( ( ( ( (8xrx UYZtX|O&gYǞ0=vr[Y&B-̢6_¯x)'ԼρuL_Kxþ!M>mAQK%2˚>/)M}o1l>0kg{; `oakps~кޮSCֵ[ƍIjܿ;s_Y<%~jZ~GOº_&׎5?ػo_)hiU>%I7-[MsO%Znw=Od'Nj7ᶍi=j=LJlZM=V E/ _Sռ-j:=_?g xcS|k#4%ݏ[Nyc|4u2O|Wkɬ\_D6?;s_Y<%~txOe<՗O ha^[lon"Ӎƣ)c}:o-=ߊ!V_ ֿ%@/x֩}Yw1#S^kmBCC.xK =c:?O^tD> kMNj׼L,޷ZE/n^Dr^TJ(Ui”kZ:JvJTU9~>u,a,9}jUujQaF3*ʐrJZB!Q}(qTυ>2}j7|/AU fK?غMqkz 1xگ,;s,<# ,6"6 /l+mV|+{HwoxZ=RAJW6d?&!aƟgß(Cc+N6wqMO^|ÿS}^5|,|AX`-N|x3e7V^M|'վ4xE#\xⷂe/KeMXZ<{w `OIbG*9JBh(VU#[Rn5*(jta㈔*GNp֯|8^SʎǞ_UU 8tP[,4bt)*{yeyyw=GVW}!G}!@w=GVW}!G}!@w=GVW}!G}!@w=GVW}!G}!@w=GVW}!G}!@KoO_:c_ƻgqAgֽ ( ( ( ( ( (8Oxf/}OxMJ!u|5.|@M#T> 3[տt/xYKmZq[%]Džxˏx~'l'{sJ5"t~o=? fiv.a|1˳ n&gaVJXjQ&IV焜*J0UaZT)NQ'9v W,cq5(Uա:ZT94EN|E:?l_xRӴP~լOF>(~6mx~7>=/|[iڅ|,QPZok`h~c4c/㤿 <OV+1%+*x=I),L' PTgJ<_b_Ӟǿ_Pxž;E$w-TsoxOƚym<x M~9gx^+4 8xW^G{şP}WZo_ 7oi?'~^$gǿĿ?ZG|nMԿ o]|_g]6ÿ4xc'eyrPǿoxk^|]/h~4c>'6a{AlbiuMgZn-4/Nk-ViQ=L.?o4Լy':.M#~?jOQizFc3&u/U-<{mCZcH!4_Soړ?~%3߆>*C|wIмMCּ/1|Am'úO蚗FVN=ZF 5k?si־!#s zލxE>!=ki'״KԵ Ú<#ڥ:E|9iOo>Guh?2x~+|Bо<]w?#P~'i~?o-?ho < {|&͞o|3Wƿ6U 4k, i/_Pdoŏ&g_i{~0 |[Oj^ ׵}KO|5,ס/<>gOOW:-sPļCMa/ 6~!M 흆aBR񦟪i+M'+=FGd'?i#3oO~ix3'wǏjO|s>w|B[[F?gYni:Y_8<+CӾo~?OX|W~~7/^M?þ:k [š%Jß>'}3H'mQ񌖷7Z=`/|K:/''4 sþ$eh:[E{k.s^g47v=E"_[n`ğ"{?E>/񏇼5-ÿ~8zΣdx/~+𽯊S(M÷>$ 4$-0i?Lm+Þ Q_׼KGϋ <x{^.O'O vsxþ fu_ZtuρZfR-Ag޳%<kYxVҗX?K©qx[▿OYj?ehzߎ) ǁOx^24Cִx_~mĞsyZj>iڞum{es=Jǿp?MO}F޾=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^zzh=4o_^#߈9۞!x׏Nv"=(((((((%g!?kӏ ЃOm5&BU:i _Z~w=@ppeyw=@ppeyw=@ppeyw=@ppeyw=@.߇55nmV_ t_ xķ7|+q[ZxsDgeϊ`I-x;D&gzk\ *g/2hKy=)cu/_dxc?-fZ/t[S|4-J?e KCX,0y ;Itk1jv{,rizrj5;M&I-4Kۨla]ST4=1.jOѴo~'?ᖁ?-ľk OԬ/MBh:OI.nu'L]Ɖ.ak6>&\__Kۯ؎ǚ}޻]]Z^|'K_u$kMuhVo/l3#oKPyg,ta a?:GJGg>y,E?~.<xZ:?)MLj&oh#uMS>K{7NyXj6MۭkHKXZ5+9`Fky>?[/ ^2u^Z -D┏8%/D:xlB3[,n. ;,GׄX#k(M#]oo[l1+KK?n%a">RӭeWƟuhwJYC>>ؿ{kOVop,5|Uy)IRӝYsNn0MƜ"TN rSkQЋ]Z!Jj0NsQ9'&O K|TkCc[ލㅞ=Ҽ+=V=.ᾍ?KVӦΥ +c$ve)#K^Xt>vXZ.x /H`MӬmͿno_U|4h|CH&Z~k)leмu'!56eX-;F)GggCI[/g W\Dz[WҐkR{'x fch,ltlhV%s#['Tğe(KC_14hx~³U&uOIRS??? /?Vj/g W?s'CJ?uOIR4{LdIau~qKHdo9FG_b_vQ@ó?ؓOG0un i?`غfh6ˢ1BJEb2(?߰/ca?؇IHUbĒǧ?@CȖ]€ }UE| QѤ̟a~)]0iYik8X-,|=YbQvg!Aff*xg|E?<-?^)}/?I,x??e}3*^A?^%Zf56=B[>ƃsCt?ΙkOs{?U۵;˽BE̒>sYkV<4(P^Mԅ_Gk[_1CMmgMM3׀h{s7o |go| [uzƧZ?[o?~QҼ~?+Lͦ??`/"7G?~oA[hg>G|8 ~~ O|:4-s|;o j/{_m?g㟍~п_e½- fT_FM :ƳAx'zy]Mx3i_Ę__ԧ?J#GßwoڒOo>KNß)%aI~Ⱥo]_ C~KU]?a^$~߾ x#^񏄾|b/w]'㖡{%<#eg}|EO#^mmg|CcN4I^-D>sa&G b+MB ;0x~KJn?iMG]d~? xLj~ ~iۻOuoР<o3☟÷ϩ[ҼEKN£ ڧgoφ |/Z޳~?1gFh)[/|\5g%~xZn +o jMaasusci, |aG_O?ĿP/:)F7 pwSw8xB+ش+ x?R%KK ׾ x| '[i~/2-_߂=Kwu+w?]]x״_xv?KO_-T~^ύ_Oo)ePW]?^їkH4K?3մg.NW|;ᯑ!^Ui6^?ᯇ>.dgⶳ l|oĿG?g/ ܟi:ރ? ;YXxźd:nsJ|x{k ;x[U-4W=׆01ѴM;S\<h?[˟kFEὥiEΑ_^dдvf~|j/:k X~͖G~ >*dcagi;owßSᗊ<3v?M?j:5ט?Jx_Ic/B!e\>g֪a(@oG?J5<5oÞ?~k:ޫ_?ÿ4? kx/ĺ-WLMVQK{s> ~˟7ok++|V߅~1_ž·/~1g>!KZ!_ xs:F_K@֧?ogźͧ|)W~'[kV4]kZ{gZizlW7:eݵ0=JLoڳ߆>)KÝ&^|7C^h π~_BҾ O&44Kto46:Sm5ipK|v2b1fV ^L5:rXw9>Z7t۔ۧ9 ĸ^,ጷ8U֌5z^x+TN~ƥl%YM91GRS*Po}y3Ú߃?<_tzw Yejz7} 7V6 q_τ<iv׊|Oxx\jE1;ia+||/d  i6^Mk]^ºދk}6=)&1u̿c oCG7tmcַ}B<1_ڻI?gV' l ?x+R<uK↣⏌>% ƶ΁{+jrxOu/ړXn" [{-],>~=Cy\Z/w<^5o_ &oR<=VvY~~|]ϋ$amVg> GE~,|Xes_xm|cL'<3xa5z ~ɞ'O</O'ǯv.ߊ_xR50k9d_xk]~Ms *k/g'x7+?so>&6|BϏ~ xZƭqOꚠ[S w+мe'׼ O.ìoiuO&?ZF2kxK/> ~~7c៊5߳+ xZm?~GF]:χx:է|W+H[~?6P#_3+W~-A|  x\/h"Qþeyo=jNYw/7w{_X~z/?Z4xJeO 4'5^v5ZoϞ 5 6w^4xTg^^·$?˿&o^/׼SslW?$:mеVOj%v!OOτw|W񎐾 ࿺MoÞ WOkCZZfufi vw 8U_Z_xgM/~6 |k|AHMׯa75^}ka~'x>S~OvAkXm+h4KY%g*+_Pφ}H_P_ٗ%k_|''h ق/__|WKW?k|=f[^x.'N)$~*F]xW??c?{Gö ԣ7b>k~p?k^Sk?_=#@qqd4y4QVO=#G=#@qqd4y4QVO=#G=#@qqd4y4QVO=#G=#@F9v{}kk~CJtm6KOxG8ТXOC>cfD3#|Ski/x|ex:RM_RI/ O㻚WҴ[M7MYeԧ-cUԾϊ|x:S?unࡿ@[eu~<7<m?|bWSN;#tڮ ZtNj/~^<9rn'\'?|Q:6KI/m[S]_|siocT@3 s<+|pTT0bR8UBTjrR^B0XRxЅZu>O3%tz//RN?a<*Gj4ױ_GTӧR?g?#|qσ8MN'@׬5? XG徝 6Ŀj>|>' T4o~w [>~߶7?>MW~՟G{@OeO=sNЬ~4Z ^QOuNtU6_x?~~aПw߉?΋xk¾"D|"xZ)|!엩Ky~#A:w ]ZiexBk<=e۶[ͯxjgw7C|h~7gO e||//xㆯᏎZ]<  |`r#x>'񆏭Zxr;Mţ^+kC>/|_|.|>?w_ 4Ʃ/S>&7!gIJ0i)_>*x 5C>5|Ǻ^9ž&?x|;k/k%?5h-#Szbm|.g(?Bl^/x^!?f|<ҭ8qj^8.O;?P-Ŀt~<[?~/S PCԺmf+a)L$𽦇+gV<36x{_/|->V>'n;xsߌ'~2Gy?_ xԾ|A;WS 惯]H^ps)o@n_gɼ]^!7oOhK/-^x odUkf{x0]<[!l>|3~2~Z׍~7oxsPF_u#W_|Ieo⮣#^cKϗź7U캏 3/ßZ~>>.c~/OW7| a\Q᫝ؼKi^Utk wmOLmGς,ߏ>&x ௉u?߇zoكTּ)_ CAx/>!ON񟆬|9}[$xV^;V->.u}WVռ/?& i:k@;ǡ?ƍUwAϠƀ-o7CU}4o>zh=5WyѼhOx?]~F?_ [ǡ?ƍUwAϠƀ-o7CU}4o>zh=5WyѼhOx?]~F?_ [ǡ?ƍUwAϠƀ-o?B|\6?_Q^7?9^ V(((((((jn⏉γ6{ijڶyize|-u7rEkecek 7ww2omoM"F g5>WG=SL'kr:Z]:S4 j 4 8?~ A|OeU=_[O|AI"x_Mo@<9aߍ:5:[9>|M]wPO.|71߳O_>/Rm>O[<'&߂'kC?ǥ|AU_G׵)/-m>$?|p eGgyW}ya3u*AOƥaj)U?,f~]JXnSFWV0(1:)ҜTXN"^t__(5ٓLo|S$? x37'J톙dYiz65zݙңu5L6~e7|sǿş |7]s }χ|aO |]ƽQKgYj+C7|I{_j7̟j_*iO[Ѿ!_hL_>|Mo|Ycߎ~(5w&|t \|R񖜖Y|qx82Z10¹9P?hRp߽™_pY ajagƌ0kn"T*օFgFSui5R̗}y?_ΧokP|qmw[=wMRx'SW%'Vl*~x' y㟆 |1gƏH؇:'" K@]7Qל#;> <}_/F|q^|O{O/٦~,S>6x/A?~&3Iي ͟bςi7Krkz|OxkV_?W<=Fç~2$k?Ii?iw*WOJCi/_A?>/_fƞ)O4G+[|WdJV k?|AE|3~)ȗb[.Vq5o^7M3:? > S¾Ц|= /?ػF|+7?o>5?:$?ku_??g~;4xO}wKz._ou:&tH݀g}y?_g>7|ZWcmo/هl>xG}w0od>)_ٷr|g7^O?Olg-d k??eyݧKG+)<' S~15;2Y|AGϊ |5ߊ8x7.];>(UO4G+<ןfu|AWxN|+[韷O%ENOtO|yq|Lghω|-oE<[X~c_~ ^[}?$|lq_ž۳? [6o~E/ĭ* %өx5'}> g hߵԞ?~W?֍υ:|#7b/^<]>+ob=ՔZ?fGצ{_?`O/-|?Ҵ#~O xoFZ5:nj7vZd߇3hky?G}#_¿ |~h0WZZ_ <;/Ý-𗂠smx+FԤ4;ỿxwIHu]Oo|;#L~2|+Wǿ>/<3%އ*m4X>"34]m5۸lw^Ωm~y?G}xo/߿mhx |-I-+6-K-?"KjZgj7+O~O#|R/e7>?W%PnqhOsj:uu߳F7>3/Q S? . Zfkߏ4G(O¿'LSG0q  =o xoU'?8F_OZ]įZk8#[φ>$}??+i?W?"ď?m/imԯ|9g¶Z/¯oi{Nм=Wt>=2Eh-O=&Oto[)M&4G(O¾sQI&xc[ſ<;ߋm1~vuix/ᕟg?/kIдg^𾑦h6>֮4F~^ ߌgEx'oǚGq!| <95ڷ??5~÷k!CH>IMx{ϊ55]im?}y?_O >I/_H';'r|Hq8GMG[4{⛘h,|e?-ax]5/O%+&'oxk;Be[o xVbi($>O4G+տK8x2—?pd(/' \k<s֫qI|t5)m4'JEL,ߺ h((((((~+qૃS8~\?>_τ/N|m|?{g:cS>񆥡x巆ot#~X8M-?T//<~|x;'~42Z5O)}KD;?OxZ:uYO񞻩it\F| e|y,Ul=q9ՅIэ*]ԝ?<%xzUa)jpӜ`: TZUiTЧNm|E&|<ƽxK&෈uk 7ԓS|,1گxrz|Eh;Soox/_ǿ;G86xR'|U+?i5? i_<)2]F0gx+?Iu_x?A.sF2^ h>(~5+] YR|)O*\]|\ᏆG |L:W|m=mK}^lOqX<52 ѠUL]y{>Y*pJxfҒra8d'8M}<6" -xV^s_kZ-c"&hW7KԵ6Nvwl-x\Χ|1]Ih>uۋ x+z|G}i՞2X.m R{}>htN5[mt+aOSmO%$sj M't?$ּ##|aj3nĽg'M z?fJү ׼8 BW/|;!xn?>?u7k%Gį։<EFּs)|K_<'SL]|J<-.mV-lotgo|iDžiQ׵^-|'SFW]|Xm?~2c%ŝC<w{_Ɵ*> ꟴυơǖ^#](?~0< U>1|At|X%"|]|p%[ӵOh+Gohu4C}M-<]asÿٷK i\hwSw7TBwR|'<+j Kw~ |2^ÏwĿ#|WdhehZUnZ]6Xm/ x!4|Hy}m v2E? >#hM?!x+'fnoto'elgŸC/[8%}Αgk焾$_%};ŚGş|`\acO?گ)X|E}u|&>$:M~ڧ;r|WOeSA|g_/iwir:Wյ(>|tُ-3:_M  Ġ&g5ŭ~:4_|Oq7į|9^?;/ S?:?j~+Ko5|sx-ƥA}bBMiuk}jƋZ^Z~:ŕݤ?6:&_f@3 {'/|>-wg?f=>g|S jZ_ž׮>C5ilz^SG ,-+[9; ZfjWu_QZYڞ_>/&/3 /S ң񷉵'l[+ ^$\D~*l/᥽)= ,){f|Rƚ]7c G^Qk 36ĿW_^Excu(;>_xw w.,)'=7ZO`=3þѵokWi͵?s_4[#O;|[xV{wgw#|4F^P}lo?<i#τ?j/ |;t)욟+oZM7cH#RZ|Aƽ3v"~)o ~/ܺφU-m5/w~xOO wB|w᥅~67?>he,5+ȿ% xsJkxW__ҴKT~,|A5C1p:~7&1I;~ο~%~ZƿZؒ[ƟxW~m7ő{5Ún7OǿOy߯Z.okѿ{ToGǿOy߯Z.okѿ{ToGǿOy߯Z.okѿ{ToGǿOy߯Z.ok992_k-Il6Z~ѶE>4>7ڿhK(]wT|IgEmOJ USbӫ8Rq:% *TE(qjҒ|X.Jef'NahbJxW*uԄւQjE(4~^L#OujzM|AxQoҚ(/e_7 /rV<2QoERh'h|1E(+~)JMatuVh@t?h ?nwL[S-şn>*VxORZCO>!׵K4+{{ {{Ho?$WKh3El$`__M-[Ѭ$C? [oe/gxZ ׵ X _:ƥFm?Oe(/ ~_ sx37<'O;E;[ii[zFgkp"Cmio *(_׍ h?o*Ǟ𗈼 ~ÿϢ[ڷ^'NMxS.5B=OQOַWְG2H 9G2H 9_f@-gٿI~@mGNj5 'G4x- זPZ\/3:^G{s:i.PEPEPEPEPEPEPEPEP|ZO%|hUsM:/-h^5-",5McDqMG>=gğ7Hz?Of˥VT0x_%9хzNssTJNiTjSSGx<|?ta 9hƤ5Rd9TjԣNF:gwψt>wRIj$π>"x /ZsuC/LѾ/|_Ŀͤ1IC}g7s<3%yj.evFڊڪ3`W=Y|Ge(e_?MC%σ|-⟍i/_>(Yj *}߇:Z޹MzZφ~~/xKoM~!I~|*o?l#W\𗌼:$>.NL|/M'NĹNY2ec4J|&&5fR)*VңBSsT)1O,O8 yW˥TO,ZP\]Bڞ6y/T+ }Aoo_?(~*-wh|7ž>S~|^9*j>":_m도?_Wz{=1+yoV~.|X׾g_/h?>oٓQ״#KR7~xX?<>. ]Gí/7Rs= sRIϟd~oo__+P6 j]s,5_;}o~/7ŏj%hDԾ xo|OY>>ImZ͇|QxCWwn? x_O|zi+~S/'G?qۯ~'>kOwƐY4y௉:/_>6o@>WIJ GU|m4tQx@uj~׵@ {z+?lڣſWxڧ_dW|j%֙ - *w/|sK5 B k o'?y?0Y'o/⟉K Oړ_>+7O/nS_7/MŚg |'?>#sѼ%//z֝?H7o(/{=n  Ҵd > Zx@ǟW Ҵ=߅2zWq @{g:!K/ᮉY9ď||]/ξ>х-붯ke֙'y~fgQM <#$>Yt?|Wºxㆃ ? h}W^mx>ŚQAWO|)OĿ^R~2nо"^<t##|F{/52j9}G_%C_ fK {Y,g iM⟊h^+}x}|)}7H;{z(޿ W-յ}Ge?__  -xCK4 |U+6/_:XiZoo sL7[z6xrVŖEKC|Yc\ރSNJ/w?xv\C}ľ7t tmWRּ_7II}Aoo_~7|ej߄>M潡k5~_ ?l?ҼeXaug2Xj7&Ěv~ iG%oxK!T4=3ĚeƏ[Οr WWR, ; nxn` mхbP Cq? |? i/sie{Ÿ ~?' svlb1t0P..(Ҭ,:9+rTQZuBĘ I:85ZC Z8IFuZ)RRƌNdх ֥JG- Sg"վxy|)w|'iHTnj'ᯇMi?z\5< Zxx|o4hz^dzuj~Ͽ5 ,|$?|!#9_CҬ4o j(5 f^Lm-SS2iqQGA(>5еώ>=gxǿ/ |nҾ(]~<|Y/4{OWKqg/Wi>?ڏQp~9x^-K2o75mmfZlZOӼwC i67+d ~􈵽ZmcL?GfUkbj:XѭIeԪ:֕5j~ڼ)TSjri|d\'gC0+RcJxiQu)ROZh񘚵15%(R,EIRG/S࿂4x{>C@g_ᾇS@xT<#fZYxS^|)bX`.=himu:>_W}ZKCy7? :=COӠ;R I[{[4Ǘ|>?c|fX0 |mHŸ+B?_~">,s¯MO~Ki j6<5j Xw~"G43C;?iSO|=M ڦ ~ѱ|UOCVuj,𭞓%?F307o ⏆?w/?ux+ΎHeKZn M,Rci[Dl=> G~xPJ֯ğ^3{dZu?MH{Vi}+Mh5<rƾ><{.|m odA\_;A__j|g/CDWφfE-_E? k??xG߄.0|t7kMgV?|CwƍGM'|3_5Ms~Ż=k /~$}}+vzNcFz :m]ho[xu;;Kk 㗌lYH]?g-[z]'CE?i{|jNsŞ^/^~moxc IjW<-lj|I+|Vkicʟ}K<~-R@|->Oᖗiſ x^;ѬQx]+/>'y~|Y]I&C (~-|$~|Q~8ӵo4K3g[tV+;CxQ힛:Z-0~|hW? <]xp|>q KxWZ曢9V6< [v>E5/VYD|>~ƐտeٯTd& _{>7~ ]>sil᷃'F;7zӴ_ߎP|%|m3I/_ &<O i h7O߇U_ZS'ď=oLm/Xy{kG×gS# |WxWOOxUbi O_wuCşaյ|[GM|E]R[ ;kVK6x| I|Jƞ$SK-χ_|Oa[C?5WSׂ}WR}Cvdžм=*+c7 VԤv>5ǿ>*i_xO⿇~_:iO/tMWT<=xK:ׇuroy5  Ğu@U__ |IO |;__j^ u_ ^/=շ>#i:/u7MixP<-?~yO+⯉4_I#ovZ߄?z ׈PcYt_ut]NM5լDžۗ M N^Ggú| Y›o>W!n|6/x~9o.|K KlO'__W_5h~!xS^-n>i.~4}V_·^/Ѵk:wm%8OwxSHCasv?<ž2gQ.o:U.5fռ%+3\ؓ]w7\ÿٛ=#ޭ?qSW*]WO__|9yφk[-_]ϿoTg x/c3j͟f~ozG<] 7O>$iZN<SU_Wri-uo&oZ?|_|A1x|a&Kǿ)w[|m1?ƭ'!c|=vl:L~%x֚$:E!j.} Cf//42^'x n:o'tfS4m#J_7+ j+MrNѼIx#Z ҵKf4,߳_<7ūKE~Кg7ωW.hZo |g~xOW |s~!-4m?o.~,E{_~u]:x'~ xQkV#>$/c\]uk_~߳?{GO,WIb~3. WԾ$h~0ޱ7!3E^H!Q93^w$|%g|? oMՍkM@m.,nM֟cqy/_^Yf߀;tS~2?uc^ԼUOW9}mk|K>%ߌWRY| hz_xsCc/ƫ4~/ ]=_x>?1'Jh_ƿ?O)C.}Go Z?({"?y/ex\K5 5{5|Ai|;>=ѼUM?]LJ4}I>^Ɵ|i^Ѿ+kzώ[-‹,ǦxbOOᧁmgxcOo"K/c%XOh? ^!}gW~E|#%~}.i~uO/zUw|3M\u(m@-߯Z3W k_Y?Px|5,k x?=_{*φZƿ߯ZΛ3cZƿY ЭgmB5ZٙU?Vba$+,QEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEW ŧ|yEſxwǞ -;/^5爾:AӏnZb,3bWbe:A߻S% qIrSbܥ9| D_8ia3+ŪQSyoIFzC ReO?6Q9y O⮑x,5}'Y%ϼ?_jmSVh$tÿ m?x~>)|%~0x~$;D|7s/W?>?3Wÿ~1|> G_A? 'WQv|2+ vRZ67&_Bg)} eٻO^??l/D-[x;_o@ o4>/?^ >$EDžo^ < ult*+< Ӟ-h).xPu-[_|=ǀn_ a;ּ oC}O쮵+_j>)澾*пW(_G φ|S=3 '׈/|9WӾ=-3c-~%|$?{=G#zPx\-/I+OX.+3~־"bꗿ~'~؟_;|Mρ6v/u;4חZe~_9d@> |ψZƹW|Ugö>? J5KRmkAԿG֣|7mqo_i" <_it#`߰ݜPoIx-#ᶟ*xxJ&忴O?ߴ>4j.d |Ccz >x㶃~( uI 7o|C<)uk?Z(ĿL?xh'/j~ g?g6:-O~/|PѼ!E?4]V׉~!~|&?{[_[~@Y~4/R?Ov?~ xweexYUj<#>.i~Ծ0~ ~~?g_j/Ծ-'m5Ǟ#u_w //𯁼=toP${Ok~jǃY:σ~Ͼ&~?Q/vW7"W&4/?'졣|)>1/io>q7?||614 G}گfv|Nl[K|[74ߜa;yؖ_h'__7+}W>&-t%Z -Gz /g~a^5?7ك.)~=m)?c,|Og񼺏>"k~,ҼGo MX+-~x;oߎ؋ߋ~|K'<|>3{|k拤xW:͟=|1sxSɡx65ȵ">~>(|=^?ƓS sjW6S]GV>/W"5ut3?ڣözn߶|E~ڗ~+xK_oJ:g]G3~:_!Ꮐ>1'=^E*xjo@g٧XH<< }o_x (((((((((((((((((((((((((((((((((((((((_ڧ-g|d~xRS/jh?k/7> 5^!MoGXyAҨ`|~l_t~$|&K{/X~$ xQ/|A WV.rYmYş>X[G7O]oOOS{&! px~ږڇA>:~x?Z<Cݧٗ~>Z>4j||X5ռ;ᯈ|c躋4jӴ~K;W[(8u=R$MFԨ((((((((((((((((((((((((((((((((((((((((((((( $|8 *i#^~> |O{?FTfƩ ,ZVϰF_?zN1j.ڵΝ:?|=4OO Bol) 8協}EPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEP^!2|oҿiٷ|t-PƉAOF֭qmy{J=ǚ~فiui66[Oso$-{}|a~_Oi~i7U gd v(nNc@[/jw?{?FP{z*Q}Cs{z(޿ }Co__\޿ 7?¼=5?6ӾkZ_~!_xW^Nؾh*.bе-F7z[2wEkIZ|!ŷ "<'?/e2Vg`[/i0xxSlIct|)>.&<߅+_Lׁƙni}|DzjhtBUEo6z z/t.O?"y$ӵ Ωoogcwyu4Jzo C%D/O{-k?iZ& Nޯ_FMGN($޿ O'Wzw>+j@/!ıxKAg5}6]_[ՒEҠ{Bο>jo$/ux_[ |O!e(~Y>'jZ/x_Oyej7ZI}8m^Wz׊> ']GZ4||Ꮑ={i^-a|_F×k%͕[FW0t~z>)*? [}4=go!)jyׁVƙoj#ׯt^Kxyt;>"ʟc=xg[ٯDƺ}#7OM}˦xLu.YWW>ɺ坽Q~o__'o do_A|P-S+zi1/WѴ j7><(!ocž|^(o_k1 =I/-|\ u8tj^3hP&zGwNG>޿ 7?©__?@7?{?FP{z*Q}Cs{z+ON_ax-s8EՃh(((((((((((((((((((((((((((((((((+><qP[/j?Ïlv5w>g֣S?a(ߙ=_TG?J{~jg֣Gj~E/-2+%|IMG 4Gqq~Xg=oþ7}záSn7/k_F~}kFVO,|cw^4x L״;.Ý_GuĿYEC3 _爟ybjTHKRUp#<>9SCԴ05)ҩcZ5S*Ug_=_g֯_.??gk (<5nஞ^Ҽox.R|W]KRf.v/AZњ^tOO&7U*|q.4-ee^Sºem?k>#iYx~Ub_sCZGZ{'pxi⣋V*JX5iV3ǖ:s*MTqqq-n&Xzh=5WyѼhOx?לT%5ÿWv1Ko x{Q紎L?i kc|kLt.+ d{%4_=Ŀ5i-RVn BLѴ u]xO~7C|;ľ"G4|84 x/įZ4x("Ǎn?y 5^gċ xꯪkzMC,4mAw?e/Z|Y\4 =extkǪko4Boi6>UuV=lƿ,3xBo|czω_xjOh7y {GycjVZ7~Q]/p2Oi_*woqmW?u>k?4˽/UΧ}Cot;V.j7#?_/ riM:rRPJU'*t*r)9pm'>TMݤgTRXRZcRiIJ~-s7ʛQl3UִKF5k 2mo/4ۦ[j:mͦapa7V׶mE~; >-k^$^"F:ψGOxX|SkRQx56?j -kOG>kZo6_ŏG5/ENTUISg:JrT8)(NPORdqRM);'V:n!:pV8J!Qxn⚌ 䛊Ox?Mתh <;_x4 <'FG՛Z_<^#\? }>!~⶘-5->VEïxWχ>4];[Y=*u Fm °jؾנgsjZ[[H[ǡ?ƍUwAϠƀ-o7CU}4o>zh=5WyѼhO~sϯ~!jyӾsOM?5wtQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEx8nυ<7ssq{=2i]2IfY-IeFgGfwv,X@֏0x|- '+?&[O!i֏0x|- '+?&[O!i֏0x|- '+?&[O!׉4-ž׼)Dth>R+#ZMԬ(UwVW3YX,iM48e񧊡~ h׋n.M?#ںw~ 2>YZχt[}6ڟu2$ߍ|F}׍<{?m5߉3WLD'i70eE6VZ.d|- '+?&[O!;MNNE [ZZmUӼ#zuZԵywkmjޫgid~_-|Uq3Vi_ō{ăP- {\񶣪YXhs\iWw:^eh-zg!^ 7 BBoAy&'|ү|34A֢uMwǷ O7 h>-o^J%ίY k5WM4CЛoi?@?Z<WM4CЛoi?@?Z<WM4CЛoi?@?Z<WM4CЛoi?@?Z}|UjBBoAw_ `[Cw0A^:$qC QQFƊUB(袊(((((((((((((((((((((((((((((((((+ [ލ㿈5$ѯumgZݷf/=|F_-msNÝwXĚªѼC#ƚW1}sv|ju3xO:o H4kHa>R|)GotqN7x7GGz'o7G_]k[/?x^5o7|r9<_J7W> ?fk_MO5Ǘzoκ&?ৎ~ G)>wjk\STk^.iZo7LmK-.xL3(*hS &gNpcITn8yh'?x+6p\W|vCᔲZ҄ru]zcj G^Xxc1!G K0 <|>oh?>|W_K?KG#/۾%ֵ>t qŷ/ƈ_ ?+W]+GT,5/xku~ϋ?hϊuX~0|o~ gn%_Z`Ÿzgw A2 G_@|9x(g4W>xo'wgkRMB×r|r'wIWog|9_.>A<,||UoǪx*TӵsUM*VPh|+Ӿ6Ӻ74$C4??d=kV?F}_Z5;/ |;?>YKFL_?l|A?GN/~+›HN x|Awy_i,ٗmϱizO#/ӴMn!wǟ4S/^񿅭~'7+2< |_Tl~$h17|Bּ;Q< NĚ1nuo q+_ ~>-x|GxZ2>,i7(> Ol4;3L? f?|@~ŪxTӼEbiS}IGng-aCcU~'rtU+x+@ǚxN+/vU<`)k_T:]A8;~#]߇=O #/~ ~>/뚷¿k>+D׏5oּk}m'N6)y韷߇(߇~5|AWşۇ'?Wb_W~)xLφ|ˬX/:|3koQuy,k| <9M~|?~~|whg3kxGwśx ֐޿Zm-GLm>ĒW??]?Ç9|,񗅾!~׾9Ҿ'xZt9]'~L-e 5zqƋ uxxLԵ`?bύ^(c7񽖁x#7 _MGa-_T5k=V.{]OZ5}>;xuMB%0x~_xWt[|=潩x+Oo?!a>euvZvj\Mi[vzO a(TCǡ?ƀ.y?S=4oҏ0x~Ox?Ѽzh?JSowJ ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( B?~/Ѿ\G׼S.e.0zVtOu[qڤ^._ks ^7ƅ~4E|:|)oπƟogYxI#@Ҿ!/^+4_hm_¾;+xF {+\C`s*`8JMӣ&ѥVqYӧ^Fu!^)ƣ8ԜcN~'c1x 1`aVx=8{*i֭JbaV xSS*j89TvR>W:/sV& ?fO?|O_xC9|Q~)|IYZOw_v<7uJIE\3K/1 0 UxR ׎)VQ >e^aRbpʵLEz 0L=fPeR~_/|Egڅ_xS /ٺo |:C_]O6Fq"O֬4 QmuxS_2?~'|a]uk}4٫Zޱ>|>/|>5_iE{iO^6~72w[_o/>*~,OFG񇋿fOIOgx^֬~*^|Eo߈2i~C_ ~2|==vmoBMc[ޣx%3Ϥ¾0Ox^*еy-uo x@u=xNB45x-hRGw>k SΥ<o#QѮu"þ"/g<'~mfTyƿ qN}?T?@Ծx SDwoKC_ %񇉼-=OxM̦Zм7[|2/So}sC-#e_P$].-6It CU/Vǿ_:\~ OeRh"$>|Jo'mt% +ѵ,]]* ߵ߄t|=7uڧskF~&|$|%__-|<SH~#xOǾ /f NN_ j N>5 <hx \/|M|g8Ki94'OO?5n/á߆<9{c׼h}5g|~?~2֥ZGS?d}{Oŏ񷄵|A jz<=\.S_-[ӽSy Hx_g?,?cW.~zO[~d>#xPMƟ~=|JFOxY*.g_AѴ?\}4o>֏0xsyѼj?Z<~F?_~`h@7AϠƩ?\}4o>֏0xsyg!0x|-9tG~:?}x=((((((((((((((((((((((((((((((((((+> sO/xc t+2 cD{K T5nJ-x-{۸biI[Jw?>(|1=5ZFSž**? hd/XVi5 7>.ՠŭcᦃK_VyeKmgOΝ6)TBUZ]4UJUjB4֨F~Ny<)J8JNPNQSN^Ƃ64U*тX}CMoCt#W< k 4ž/^8#Ǻu­\[{O|75Գxkĺe>o/?#]dxSzU+zZ[}TԮ:VQ>h7/}O? > |9x; xV}x'</?=O\!Ѽ⟇Mc/h|^|q-}@q7$h6d-e/ڋ >FhIx+_;-5/x^՟º\ϧz[^AC Uה1(a*t:T$֯BTN51 ʫ~0Yk_ OBY#&Y:0RJt|TYa1ʐg֣H j7GX׎g?0hvڗ/xG xV^E*ƿi?? kᜟ>* ோ^ ycRo3|/t[OY|=?>>Z׃_ź F/@y߯Z Il #v5k|6AN~Ǐ'cI>^K4(nOe~h I6bŚ^+O>=<3߃_>0xW7¿k2f_I>$k)[mNK.|!φ> 5ڀ~߯Z3W=C?h Yh|=D]xvl~+g{&{>'Gmo\YVqNV5&g'fό^>$xkN _w??';Sh^ _t/_ S E_h@umoBi? h.?3Q{~jK%Ɵu/|2h>(BOmsgG|m\xZֹߋ.asLM |i9|6|>:&^wk>x⷇-oxV/xO}wXѭ,4-=_g֯?eA5#cMkAk|4]1x>,|eBxsV1^4~)>0xkV?٫P)7оOdž+KΚyMПjؾMx+ gƺ7 jd?oG[_?}/֏Lc/`{\ ּKU=_g֪FP3Q{~jAoo_Z=_g֪FP3Q{~jAoo_Z=_zG³}|Eu^DsS?9z5Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@~p|F/|/*Zm正އ x{Ğt__nǮxsXҵh /3~@x?ÿ@?~/ևS~1h_<_[O躯+X$U^/ i; {_/z1f 6SZ0~|.&4aF2,JLM(ӝiգ N!*J-39`pf2eB'{:ZԆ)Vh s,EJ uT$yWƯ%GûυwZG3x?/ xu sd>>%7<%o xKZo ռj_ؐRx)4BRMzkm_ojux|@𧆴x?HU">_ O_]M9%?O~ٟn&7 >=txŸ|xG/~)xIև j^&Ǎ~nxm|Y~> _g=~x%'_2=› B𿌼_7"x78<-1g񷉼{ +JQ˭} 7s,χ~ӬGivW oK5}x/#>"~ |/D ߀#e/?&gD_i~!w|6O"axWUk'"\Sþÿ |3WO xk:MxVI҄[\jjV|ξ8Ѽy5|Ҵwϋz7t߈"~_ 4_H~h6 5?g"\~8Լ%>osB?o_¶ڏzI)Gl|%~|Ao<mx3?i.T~&|U{hc~-Qg |O@? 'x<oų_|9oI-4m#Of]𮫮|-wKUW]F<׌n~!Цc˿ĚDzψ|cusm^Z[M.xĞ19g|]>;oQV_o+MOzZ_|u6!=oŞLNXkNm?]'/~0i>i[_txN/cltJĺ֘m*ajw6NlXoYyGៃ>|-O>ώ~?o sS.5Cº!۾|Gڵ+sH5Գ*QB6~ {%7ڗ.zGw+t=|Zx'uGL𗋼ykxC֯|_*/_׋j+|3/ց}O dgFyCԼk6񞱥6~8{6|6lb_|ou5 x:MOO{^~2/CѾ^YU}Puxo7>!<CAү|QM7ˤ 6A6]ݭ65(Fg[?(@>,|@%t)|'t/ n>n5= >k>Mx^Q7;WfZ8>"hm{QCRPދM7?I^!ռ =5 > JZY}e=/Ug=w~? නߋ|O:¿#=wK[ЦegD_ Rѵ.O[_Ͽ?iGo]q\/? J;Cf??ؿ%vO]\K֧h[nme~ ui0]R(ㅷA^«m׎~!4Ʀ[pl|;㏅?cm7n|3wqh  SǞռIm;oV?n/I>&REe&Դ.>6:[|3׼L|k=zh=5gl=+¿f_l_>"V_%>/yusῃGmZ;ƹKk >Z]{_>x⯍=_¾𦱨h"ֵMJLծ4[G z3{kx<x6K~uzOx?>0~x/>Jk<;S:7|&sVWA_)~+|U}|:ҼS>ICOWM?࠿tڍ=7//xj xK')Vz75߉nEi_,nU?A|" ~ }ϼzh=5I ozAԧ4o_G?:_-_WgՏhzh=5WyѼhO\OςmON{CQo*( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( >e~߳n:dBǺ^xuk O~\@.ҼI/ޫ_>>xK}coFw5O?xIgk:5ohP?kG k¾׼A {MtC̰Y_⧙P¦.*U"2 tt9Q珗a^UfpV(bg8ŵΟ=)TMB$Go\_iW>5~ j Ok?~ -FkVyg+/4?_i C|W|O ]~.V_b? ]YE|b59|Fix%e?Ǩ|3ſ4χl"į/ƟvÞ\zG:֥_Ox?}HCoW|x?^#ƛ(_෋?h/>9I D>|D  VŲY|ſk^/t\/?Hxx_?n ˾|K_R?hmk? cNJtm'ƝcĿ>#:ϊ> ~h^0E"x?|*/~ |7hۯi͇5x=gu]/A,ZshֺΥa{uǡ?ƀ?>⿀|-)MApčON qgߌZ<}[4h?|-;k {/źNji+`wo>0k~_WYl?Km _|Yo6>.6qEo>xOU_Z~6QcV׼E-{VM D.-_WԮ7O$Z#h !ïk~:|c; Ǥ߱&|9GS3ᏀIt5|BNΟSĞ$tm>]g:iQ]}{m 7ߥjo_ /hzEҵ]g<++L wcM5 jڵgs4WXr+ϯ1G<7ӿb l/O|L,??ZbW69|;汬xzޭ?o44 G5cxO-_Z5ş k~ ouo7C~eE)k> zN/d4[{Z%,~&/2yi[i^7s]>ҬWOcW4_xoV>&k|q/4{/j Lj>լ|?-y5,Kj~&|;-;U7C~txK W>|kG^(SF'={~>>!|.Ҿ!xf2^i? Xx:};^/ cw_kߴ-?? O|!mo~'G"jfm/⇆OW|aׇ~1xkUCmͼzh=4#Z~ Ŀ( c^8~5@k0ZxF/x-"DԾ']hxiq+wiT=4o{FT=4o{^xSoWo<oƟx=.((((((((((((((((((((((((((((((((((?|sҼo/UyNƉw_گuO G7ιد< |7=otoan/8'b)NZGRF ʌFN5i%Ṟ9V7-X*,La*ZHVYҍZiէ NƝhJ59/w3x 7"xwς>O_$Wƾ-īoZ;]B_ƞw|?oxr"E-_Ƕ?|@G >wgϳ~^&I^9 '/_-g |Q|;?+'h~?E > O x'RW[EφmSҾ k^ռM}zς|FxV%ku Vu=}3~Km>xUQ'#Oo>+Oc~,i6^|7N'WB/[A:q7f|CV 9%˜"{5 t7$$<%)~7Yo'ITJqkcYT5hwRJK/0*xV^-|3~7i >9ߺ'oW㏂/u|/?~>4د <oo /cڮf5\x:_ >%-߉m8o 7?hp/+bIƿP_G_|y>!+M%BkPǮa)|:< ooZ|I|,m⻫+YY')O?~Y]*kۍ/<%xzlܷΟs_O=qM#w5w~_~)3oߵg__?f?~ -ږo A{V+/??F[w[||G|5mğJKz)|QC0Ǐ>RgcR~&? ?dOB?ƽ*į~%||ukw42W 5=^&ᮇ|D6+2Z[׮mE|l>y?ĝŚ:j|-O~ 3ӿgZ g_x |#=mNMcF(}uC5{(D[ ͡x[< O/Ae_|W<#/|Sŝ3ď_l~67WkcO7Kߵ?W_:/>:5;KxO7~W#͎5_Mv^?\|j6U_};O9mf9@g>\6Ï@S (((((+SuُqW>7~uޡe/%O,f:g9)K)x+Ro(e?h+ύ3/ [|=#׊|U&o5ᯍ RJk6࿈$-{SqxºTQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQE|Cs]OŭG>$ cោ.twKG+*Y\C_'HyG/@`fiw.|C? Ϧm|,ϊo7W+Ocᧂ<L>W lҽ izۼ,XZYI$*dwrXTQEQEQEQEQEQE߈?gZiQy|/yktXoj[VMK^f?'m%x`}IQOɼ$ѼNcHd "o.h^9|X$W|<(~ßGxV,/ud|s{cƺƿM>|65_tψۯ}n?@袊(((((((((((((((((((((((((((((/-,mե1\[|=6żxee)cfDetb7' ?eO4? >>3qz3||g2yϏ|C^;:+C̽h?7Ί?<n>!/G' ?eO4? >>3qz3||g2yϏ|C^;:+C̽h?7Ί?<n>!/G' ?e S⿃ZMN֊x+^g>$[coPyo|#u;T&>֕ MK}"gĽ{?g;'ƿh}ߎk<>7 >9N-cK-^>'?O7^/75O k4o 3m7J{!S#bW >>3qz?<n>!/@yϏ|C^O4?gEqh?7||g2\ΗWWJս]j[6Oemw5Cqy8$TLLP!,:j((/-,mե1\[|=6żxee)cfDetb7' ?eO4? >>3qz/>$iO4= Xx|9_@Ѽ= ޳1K~6:v}k:M^JyϏ|C^O4?}g~!Ӽ[~$\]|PSZ~(=RLKmvyϏ|C^;:+C̽h?7Ί?<n>!/G' ?eO4? >>3qz3||g2yϏ|C^;:+C̽h?7Ί?<n>!/G' ?eO4? >>3qz3||g2yϏ|C^;:+C̽h?7ΊthU֭PWlj>{+kt:ͨؤ$bb aPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEPEP{1 ,}=5:||>(O`u%v>g֠ ;ǡ?ƍUoGOx?o3Q{~jzh=5[y߯Z,7CV=_g֠ ;ǡ?ƍUo_I_?NcWSC^kKܲgOx?=[ƿ ٷ_Ν~8x[_!f ~ZxF~4.oe_z}/Ž\Zτn-u1e:/[h7ீj$W>|'Cռa~Ϳ/)/l+g"M+)?u-54Kۻ"wzOӚP*HQwl-JjN.u*ե^5]7O_wnJUj~ʜTT.g/a%*yRU=FOx??y­Wտɭ~ȇxXwI~$k{?x}/Sl5-XKp_Jg֯#1oսKT"Pnn*JZ:NzYŦ{ynm~xV1 S^*j4N^$gx?Ѽzj=_yY=4o{~j|9 (8,Lc@Kj¸ONxo=? c]O ;?FUmFO ;?FUmFO ;?FUmFO ;?FUmFO ;?FUm_G탫Qtkhtꖚ?5iG"]Z|[5ͨU~(: >4g'2Re[jZn ΅Z%V+|.‹ &h_'.UYSl6pU*C,$+8^ܱnYS\9dFRrS5NJy1ZJ*#qqz(޾ /_S[Cgmew|úׅ|+xF/?3gďT:$-D_N_>!>8Hg/c B<x^;[:'4¿|5-)tO[.ba7,7 SR4R.T!JTԱTcuWMB2g`3\M<6MTJSˍ9('Z5%%iYJ5% Cz(޾ zh=5Җwǡ?ƍ@wǡ?ƍ@wǡ?ƍ@wǡ?ƍ@L>Wi\=gx>q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@sx̟^oo_p<5ʺSAoo_V?'f,o_U}Oh? ;FUlS2}OhQA['f.5ڃV|'_7eOo׼3eZxw1|6%¿ៈWN4}\5=o:c+xC{z(޿ _6:h:V/ > |Et_iK_h0[|V`,.u_ ϣ:m~%ڧx񷇡񶮿 GGa~.Mm*C▩& + {W4}G]VU}FZ;o`FW???<i^(tf|=5x/Q0Zx%l,߆Zd6~iEnu WP/F5g㞭|8-׾|u;/DxZ ;yuC jѦ|˧kx` ?#H-a_f_|4ݷuOw'^}h^|w'|iuF{ygq/~ o D]O,W4:_|ux!x\ t?_1ǣv/ZjF[u{ 9t(g&g+>%9iaoZ?un&KuĿ1z#մ? i,ڮ"~Oo^oeMRjNiÞRPvZa(%Z ^֬RS1%9^M$FWşۥk>4ލM6m -s?"`|:$CI?Fx>סPEP

s"w}? e]O> gx?Ѽzj=_Y=4o{~j嶏/jm_{ƾں |3:-x7Z?++5^Px}u[]VY k_}~nXhmyf;k :i.&--c/6Ygˍ|ɥV˻1zkwO | ҼQ?-^v{}#Z_C|`е=WJKoYk ɣ-%j:]o^'Mj =[@l-׾|u;/DxZ ;yuC Ѧ|˧kx` ?#Hmշ}ؒI$I+$I-]>=4ocށV o:ok8,cF"]=v ? xU2.i{iC<~Aۋ%+Y7>^w /U)jaoZ=un&wĿ1z#մ? i,~o7C~z|YVKi$<3mOо"_k>#7{/ #iu/xB/i |Cڏ4{g|lz'g~0hix'<}sBֿ&ƾ׉mx[>#>)xȼёtMkKMktGo7CV=_g֠ ;ǡ?ƍUoGOx?o3Q{~jzh=5[y߯Z97? csG*?' >sG*#OГ/'4BOГ/'4Bz(޾ ?' >sG*?' >sG*¾v?fxO>*l{ kO/}?}nn-t S_K/i?4ӯ,/.5SԿ' >sG*?' >sG*O 5AQ)P5Y >r[O^ 8(5;nF²ٽwRx~Kmhחvq~exC=#E燿|[/Owy}3Aÿk zt"hoA< BO A< BO <?5}N]iR|Eu>o%~ooxznq뷺ob8| n~'NMx.Ӆ/iSxt73=5O 6[ZxGD7ۮ O|%T O|%T__?\G '_NhG '_Nh@Q}C O|%T O|%T__?\G '_NhG '_Nh@Q}C O|%T O|%TL>WWh:|Cѿ4M#FOwy6M:(߇Ϗx c<4:ں3Wx#> _.!{ 77&m*Ii,IfFi%Fgٝر$x5wg֣_#֋T_#֋Ty߯Z3WJZ/!QJZ/!Pq{~j[xǚWu|7ЮWO|@o xzZԴF}/Gkۋ",kJZ/!QJZ/!Pীu_~>!X>C[m⟈bG";N0l;-x/ǚFyOL4|;N/>o`ǧB&_f %xG  %xG ȼI#.Yx/Wψz'ox~P[]_ xFߋ߆*Q5nij1z>P~oV֜-|9k xt73=u+? h;CktH-3} ^+?MhG ^+?Mh@Ǚ=_px5x5wg֣_#֋T_#֋Ty߯Z3WJZ/!QJZ/!Pq{~j||3wɳ>@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@_6>^/4Q?x?IT*>1oڎx7|QC7Ky渹8RdGG~(|%;HZ6?Z}"gX*Y.텪,n|Y}ū{M{F/jG,{M*RU_^ny cMk֍iqmO;#?FE>>|RďZodOW6:kj^ P[eS2},r~SY~yf8Ix.e⡈7R:КIagUezTOr'p 噔'tpYuLU*:X<x똌3aʼ+7uz:ŮÞ/(xT3ܚ*xzw_I_[_x?'e6~|5񕗇lh/؇܏_C(cįKiZ}-|QRQ;OHG{gs:h~|Hms6jzO7|@ol{M~(|"ԛ5};:žh힝pxC V~9mkwƏ+39߈^)kQ:hM+XmoIxk\ 7zV/? |lqԫ ի 8­YƌRSZMS>0d7ʳeqׯs ӡMObpJhnIN-JN? B- /vOLPu/Lßhf~06]CCu?ğ]jZx&Ln|(oIl~ g'U4aZ-5X^~76 n)Mk:GtOFm|]xwǿ:_OuTω~k?>fiud'J7.ޱUxgWM> SU3[f]kK݇~߲66|~y4|(՗ЯOMִσ> >'+Kំk?|-?T|' k~? п Oڟ⧊I7aO+T/¾Ozg@x~3Ah^ MԵh?/MfH(оOƋco> CM|Kt;hv>4|FWF<}s}_o>|mǟ_#$w^|"'㟉>ƚ_4~42>> A,Q5kmLEmy XHh^;~~ѶzW+~> _g|s~jω~:kƣbi.+Gjo*|]ᯍZ_ӾZ\i߈==m~(Y_5|a^}C%5v~I4OAxW |HtJ?.i_|!⿉_WjKKK巂>FMs>^x?xFP-~ k㟄W;OxUůuOx2>Q{@t KyMT/_7z -?_>[Ϩ|5ğkZvi)xGSUyiV׌2(Ef5/ X?tkvzO>ҏe9?a)<3$^ɢ|jZu5İzޫn%񕿁~*h5 RoڇoYxr>+<+ iڣW >*|c^;|J<|H>#Yn u(?þ$~_&~?lhsWďf0x;_ox&Y~|+}I/-#W|[>vއ3e~'|i⿈?c.♾0ֵk㦋AҵV-t?8Gό>γwkѣ;P}JakࡊZ0Ӎ|<*՜JhΥ%8E9=C .H|>Y8Iz0:F'VI2Ѥ"k KooU_;~Ϳō#Cgo_:x_(~ no_HTҾ9мi.nFODе3W?~Rt9l?fo^m3>6ikτ^j^_I}֥Zo-zjxF蟎VxtK?wᏈ׾A7|[>C;ޅM_H+M[xX?Z?io |_sV> 5~՗?okߋĿz|-֙M m/?mkvk^ ^Ծ.h-'zon1Mi { ~:|-k{y?h*xē~⸵O^7+} Di-|@O7j/GOkZ$= 4K^SVo _| ď|oΉ~4} h>F߃;|QzGĿN)xgcOgoxDmwW:ecW|y?O~+_~9|iIKN,뿳QЬBZԄV;j?Kw~ďxgxrc|_ƚ7Kg᦯wl|Y;]wX~ OTw6OޓhWOQ/_|6k_ ~zw;۟1|?7/5ۭk?H~D_.>о5X?dߴ5mz]|-Guk?|~1i|^ǿAu!;'FMs>^x?xFP-~ k|ehPټSxo^⿊ƯᅏĿ2ox[>㟄W;?UŽ[ |?|e/C񾗯k>' oxak;xO1i/AmO t;/H|&o 7 kz_U߈4M;?h ?/ g_|>)|6Nj|!OW+ |q'Z֝|6Fkx +M*gCo|.?Nx k'D 6&~ tǺߊ>-xokAԼKi~(D|~>8 [hžwiWt/gK Ee6: RWuFKصXt/D={z(޿ 3FOY޿ 7?«dѓ3@w?>4d{z*O>4g{z(޿ 3FOY޿ 7?«dѓ3@-I??2g:A'(*((((((((((((((((((~x{VghZ z\׼i UҼAs擤i?x:}犵 z_EzYuWN5MFwG$7?O1dῆw:V&"ᮿk/%Σ/úҵRYkz/<wv:k~#٪$?ƿx8🁾KOuş{c'yAuuwAV&Ѵˑ,3Z'Fph.c&e +_RIsyX̻(#|'9.mcsɰ8[ O2̔qFWiK$SV~>"9쿲^ 𯌓KgSn5~/i/4wG-ټg3/<}'sw?=wL|+?_w=3Vįx#M?|_|/QxtkOƺRK5JɺƳmZ?&Wjh`%G=, ?hKfwǏ' F%ρm>5Z|TM{Ǻn`qU*2ʱUZX*Uja}YFNRf&{Ø'2ѡظӆ# VV4)^|ٷMI~kѿ{__%{ CT|!W_CY|O ׊uxO!wgj uc??/3Ny[[|[{➭|1Xxe_>1?W YJESS'?nOm.-cV|% x| O/'x 煉~|osY>νe/xֱ?qxy|W?>>?sG|AG]?66~\яV=ׯ Gk3~:> j>L~^&/|g | B?m_$9=ik.jx7J>:;|0o6:x;Ú焴u%CXפOOL4_^wa1xgQw?_x?5+ Sޝ?*'j!?EKׄWoj?/S i:֯o]j:n5??-~7~.>$6#|vGD?oOMy ǿ ࿈:u_?!/o:ψ>1R#C㿅?>_a|UHOم4M/K?_x_C/q?h_[T |LGG>Z>-CD|6?~4=1sKU񟇼x?`3:txC_7=t<M-ڮiZڎ~|Ehx/3|BvP$+v?φ^jax$k׶:W4ow=WwE}tORώu'0IN5ZNK{ǿXȵ]7z6#|{^ B w^-4O[Y <9mH|֗V6<^xsA۾ 4x3⧎zW|F>#G@׏Qh_^ 3BZׅo=gUq+M_kWPb<|a|Ye&?|Cmx__ò=׮ |Umt??F|q|/oO>թYk_hks?=shA>V XhX5?|e>+>twƾ#7t+?%-Dji_._5_",Yj# >|Yj?=_ğyfgQ`SOow?jCaX?oهό~*x+'as7^<5%? mk,[:s.W–6 $#~#5|Amy`dkOƟ% QxA/+Wxc=~,rğ wZUoeO7~~hZg]>2O]7گBͱf?Z/ i?_e'x^uMSzsC >(|B׿5o*cgkˡjWM+/Lju '@[>_^~ߴg ?b/'??S?och>~$t;N|.ߵ׈#?{k>,ռeƞ-#GW |>oaX״R ha ߄Q:q]^k4jW>|6]x9xKW5oşya'_h7Id6K7 yf_O{z'/ ;xWv?CL|/+ǞtLj~ .cQ|WivZ^U_3YakGѶ?VGC7?)_ GBx?[k4|3~E(2ůj~ _-B.o=} MBIN >7|: ,5mk_!|!KRÞ+5w(|Sml?v7ex宣ߍ_km2ƿ.|_q'%>0K{ ?ω._>|G|E+e C;] N{Zd~0C?i9i"~F{k+–ڧ,<f/ O|s 6OGa|;ӿgS^׀#|D]Q?gش |9MG xM'ZԴ.{7KoKj?f~?4?| >; D?o_M㉾ ǟ |࿈:u_?|!/o:׈>2|R+Cυz?G_jaD"|R|Fx>g8O8 |_ p?|W4xᕯb4O h#KO\Cio5_{|U ^>|` JGAq_{1≼--Z-χumK%u9WS ~>_cAv5|IWm<ş '3O7$Bk5+7;;þ!<'xgw:4׼:|ST1ow1ĿmӵM?~~:ÏO9bg>~9Ovߊt],]?ok~)}2jM};WP^~a8OxEh>h߄8 K>*o> [i_V]~ kǨmw|57?>~Ο~?M/%x[eO߅iֵx5x&=GŶRj~?V;/? SC>_ xK]:KwٺŇ#>9վ7ϧj,쵯|5ğ~մx!ǟP_u+Mc|tO 5?|d>+>twƾ#3tw>+?-Dnk_.c_x^Ŗ>-ֵe> ׵?i?|I`ן ?7]k§'@?߉|I| 5oi| xS`J,o?||Lizmo|$վ xNğxzƵ=Z-|S,켟SvjĿJto5?k 3E?bC~2~՞_ZMO &w}2A-wRo'?t߂>&Y \Ae|8xh?lh/٧zl3؏2π |9Ƨ={K@?[$|P?/i+h|0u[9C>he5+ؿ& xoN{h}[c:Xjz{3_炿`ON~iWeq2ۣ')3Ax2h>=uxG[ >37 žl!k| bG-7?Ƹ_x񏏾 z¿]O7<?mֵO韷?Zt1׫Wiz&?FxO[((((((((((((((((((!yD`jVK )&)ZHR"rQg(@ tPbxYKb '/'߳w߇>)V^.Oÿ gǞ7?u[: : -/|/궚'h~_-oxsXڟ|_?A|I>M-φ? hks":1Z|ˇ:|:YqSd(Ռ=K´Ї#͈ r\JSt.uON|;3 _0PI HPI g$&w+_bwyѼk=c 226HcǏ ?ƶ_ O<:.#i.[[xx³J׃dXI:+e㯄 Gw~xAot۩lu{/kP/a(/$)mX卐m_گ1T}_گ1T$o|.]*^m5?j~x^'[w61tWGV?F &X` x»U*x»U*wAϠƀ0/xg W>/xg WB6)? /mg^4-NWVgZd- #Sѵ8- h|3 xsxAUxWWCxc:}xÚsyk^Zjz>]iuo{eq=J ?WjQ?WjV?_yۼe@ ]Gۼe@ ][Ϡƍ~@_n<3vUn<3vUn>7Aa}_گ1T}_گ1Uh}4?WjQ?WjV?_yۼe@ ]Gۼe@ ][Ϡƍ~@_n<3vUn<3vUn>7ATt}?L;W||;:&l^^ϴw寛bxç<^@Q@->ū -mÚ?;yi)&Q+֒HY $n-[ǐHtĤ+uԱ!<$ p+?Of߃_ U>-Լ]y~Y":W'OkS/x'Nx6?wo/|Ki5{,^;Ҧu#DhǮuC x/?QF=^,|m[6[F>/a(/$)mX卐l1}1$o/.]*^m5?j~x^( w1txWGV?F &X` l|-El|-Eo__?@l|-El|-EMxþ(SνxN|E۝CB{+xC[OwqZυUk>${xHmN mF(+ xx ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( (?*#_;|oľ0o/G |<ҵ}Gᆬ1wVvxx¾-/;i~"J_D-˚'c@_jW~IxD%⟃:˟? >0j:5kz|5G|y|0džm?tx?FF{{ l> y1Ut3Jpa qxsx0Oގ!ԕ F#ZSR+BOpsf9Xf3(7J:eR kU =**~bl] U<?5&>-NJenQmGVπ~>*KxIޡ⿊Ucxv&'ODݮۤ1A^~/x'Ꮒto'|š-OK}Mc iM׳yy%osu4GsqjO(?~Hά% )6Si^C~mC$T`S'xAF^M$$ S:t4~͟-75m|[7_>"y6|3> M7~뿎x8MGz{߇5g]/G3{šƯ};G>:|V?~,xZ/럁xM~_4 MXVAakoQE~o__?L?XgS}/ցECz|IaZ#|Yk/|Y~9㯍^$ſf |TWvgψ^2m @w*Tov]mb[18 ߵ> l'?h)` !s ~o__rZO'м-Ět vm۵k;(o[k}OTEğo-ύnbU[4?e|H[n?~6k.|5{63x,xďRx6'{_V9р_?åx%/?mO~:ůkIQ|t>wĿ&Wx+?7 izIhkK__?@z~㌟xoq_۟{NOK<ÕW?$S?AG߰Wos4g]-O>}(Q}Ck_^z}Co__Z=ף_^__?@=ת?FPz7Q}Ck_^z}Co__Z=ף_^__?@=ת?FP~!\(<^^"=3dQEW?g$F'W~𓿃u/ |U{xK,~ xj?COl%EEi~~K||?O[lj?EF}w<*:J\0JxZ8M9n |-kߵ6nu/h֞0<5qs—~!L~~̟g}o/ >v#Vf=xkQ_}*@|e MnnmyEy/ G|0F-gxSAWto |=3Hy/$rH~3Q)e'֜#Փv&*m+h}ͨd]xJ, yQp()$!:sN9Fٯc~ |& _&tZSO!ɦ|R%w?>)Ţ>3Լ7_iwzƟT-hG_=şKQD^*gc_Oō;|e<oxl_xBO_ڟ~!|7ië_nլΏխMS}Qۿ6$@>SCgS~|5C7ř/\imSxgX/dm|)^ :.'?l<4ΓV=Ɵf= h_} ,w 3^8cL~+἞O=|h{߅?d?%, TY?_ sI>Eqx>Ԯ0)!~+ͮx}zLvsKF xh\|k|GkᏊ<w>_]z/ִ]?⟈a'G7ƥ[h>3мQ_>kz?!~2-<5|?QO1|x|3 ˾_c]K mp¯_xiķ>֓^~6Uy?)xwMO>:#|Lc~/_|Kxg|G?tm[T{դ'Z<=,1Ki?~|K>2x[I <;¾GG4~< QtmWGg)/'x/*qO~w C͗u+?k_ ~ϟ/Nd|B[ZcP?d ?[/]A 㿆6yi-w5j_J?7>Oy߁.]|XL3xko~E7/׈qo |.ϋ'_ 'Զ~*&N/>j֚ooBo5Gž.kkWo2o(*>OPDžj~<Q'7ET Hi'!M2=I}jx4i5-R=/Z}1D>W/ \g};RAeℶ.ڃL/y+_+R{G|ӼY-G/vKNoC?h?RgIg|Ln+Jl_>#JΕÿ|yk_i|= rM-KXmFc?o|^?O$>9+\lN'[MU¯x6&9wf-+@.b|;;,{m3N!>0nҼ+ /x׼_=?=&| 𮛣xf^zgUM>@Cǡ?ƫy߯Z3PFOg֣gx?Ѽzj=_Y=4o{~jşKsK7l|1F7V(20x#@g'|6)i|V;߅jtǾO-WGƸ?ĿyRj Y`еrBXg>~ l~]:z5?|o?XghΙmzRuYts>^M}N.H<15>.xz<=|^oto ~k > 7q|~MorŞ KoI⵻TSƩq~q[RU6CQ)zs)ףQJtZR>*BJ3OC9nR$rʎ J*>ʦy'Nc Wbe)pT+jP!M|7_~w<1-|<oOX_oq?&|Wi<|{ >~_|M9Y3WL.l߆>擨|ORO|#]a}{M;Q~,|V[G=/5.ᏆmПn=O_ |Q{5J9TVꓕO1y?$Y0T*08ҩ[^P\*0)?8{*SQR3>'O^|mxCR Ҭt].W\W | xv/ogq~*'gý=OC'ԺƩ?4ޅP|X ~Ğ |I ~6?  xx?ֺ[xnk$Ю?zOR?| )EF7+m[Ks ]i>o_?,~#[⟊7x Ta/9߆>0&ĞFO缓Դz|SдZѿg[o%D|t:GT Pÿ |+/ٹ4oIg9xA.躦T|a}c^?\Fj:ߵg_ |x.!x{N+(xcP?d ?w[7\Aφ_,?6i^Oz5ׄ|Ou|/լn}sw>yi-?joQ?eXi7'~vji2Zxᶕ;^$lj/+vך亲k^,|.Ry*O^7C?Y ;_>j֚oo|CouGž0kkWo|1(O7?^|'s?DZ/~ |N~2|.m[Ÿ|;jfXSL,bN֯gJR#YK<o#xX|u? hٷPA>)Kk|qςמ_·s->i7;Ş2~#x+Y>*o4V>փ.>/~?Cǟ>8_V>'~&GÍ+isG›|aR~.~FZ>:kmxO~! <_)4xſ 4Y)<bm!x+[wbҴk6'Ú Ӽ '>NN>HJ7l^6߅x'šn?WY{v^uWCi}{~jg֣[yѼhϙ=_V}4o>{~jg֣[yѼhS­1k¼"ž! w< ^@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@Q@o ~ >[ž}X厅^GqZ3|CcoS ?|@W~xg^^yO<",׎<⯌^!U??="~>?ljt~*i e;eƹOZ_uUSwcxlMh9w̪ x*14UjOUN1uk5\EeTp6/*;KSQ7$ ahաbx*/?~_|k/_]O|9}ڎxR [QOkz.鿴|kQ-5nu H79|=|\4_|(1/$2\xwtO/h3OԬ5Hb[6aKmwn>|fkqc >/$3ߴ>$|2mvďx#qx*OPxDӼ[k Uѱ~4?g!5]?? WvWfZ~|m~Xo_j> STh4UJUW%ZOV|A_Z3__+oojf>*FT7;Z{ ofaΝOoNм1O\E0i-oxNj?|t{V$:ÿ&/濧|ďkfM@R|Q~οSx{R'1/ĿxK[>7, |@"/ڦk_~?gGO~| "_ Gşh 𿋼O~1jvv=ymxcO7l?~ 6/Ĉ|B x+\eEiq|BӾ4xO?K] Ǿ%e^m:ʹG-<1x+↡F1EO|)/Ļ\[vٮOODώ8~"|!|>S QZ}U/_?KA/4ߍ~+/o~-(~2|LԾ.]m[|'SV>*}vzvM/w `zi~ku߃:/ſZ ˫N |;ztɪkfF4Z*]Gi%+{le ~ٿu?h f>-l;M'S75 6Zм=aZo{=ZLbngWoZeCk F׼SsUi?_/<um;&5X`=xLAټײ}3L>qoSg/!W]_Ru'oOo MjMF-sO_{socx6ZxM Ԡnsᧁh_čobUO !|:7ßz>v~ uOj^΁cxA׵=n=:??x⿀<-e "z|i'yizƝX3U&> ռG3O `Oڇ?h>AcI>'Q??|GYW|)ÿ] ㆙vSFPO?Lό=e[njg/G jIǏZ<ysc3F|_l-n_;itbcgkχ;OnxoTER⟁gqV]ޏx-u1ꖺ힝qj]}wmi$+q:ֶ/ҡSρ%ZռSz~/<)Oz'|C) 4xL{go[x~}_CmYo'guaM;#Zc]X~/Vt~Ǎj IKྩS=h~xws>_x;?'jů|K}_7%b4MF _េ|+gb]@n.b_n4/-6׼s4?G|W wIxOu6u}ZºxúX]z~C=c,~#[+ ?C~(oW{c}zm{@Z@ޙ4?\X|h'QmXxWxį_cdS<[?w⏆~'ce >)-c]ß~*k_~Y|=Ə@πX6vjhtD|iKui_7φns&so_| gIx{X״S%/Ýc_Ff|zyuXGx C3ύ6/-n⮓R7<5V?>&|2V !xG|u~qE>xNO4#M_=ll>i4QEƓ׾ ?%🂵?^;Gws?|^ 8ׂOuV?'CQT=dž|qi|-uxSoxGL^&??^:?gSⷈ>0x~1x7_|"_>%~~)kC8%hO|M|*s5x~!Tu;:'}RUh{EFIV%UNNUceQFj)^o|96e(ԡ4GNUE4 )ҩRR_>CkzNs/?q-/5YK?~-tkk_6'ù~"uWO |Ekm#S?ȵswKg| ᷁>$ǏxWz/x-kO׈tEZ^=7^;5[}~Ymo8|>i}S_uz?/9&^x ~W:z~Z'Ɵxλ-Czм=i|Czֿ$_V|?l/%>k"O^x'/KX|վx_5xe⯈^ˣ|F𞹧.Լ]y<x K jP߉oߴ7#F0)_πvu#M ?躧? \@Ӽ^ڞp [y\ΞtGƏ? Osc"|cAx]3Vbum/UӼkQzO|Iׂ~#Wz_ER~¿~ 7/ S{#|Ou? cy>Em߃ڶLi^){x[kimO?}⿃a5~^߅~_O*Owo?u:xKgtWFzTkI![/DQ?uMDkxY<;MWK7PM?<1] 0ֵkf-m_ 5(GO#ᧀt~Yx~ox==z>ğ j|qy\>xk_mk~aOڋYI>) ǽ—O;[g<ko~_z`[⎡A[kC t~>bCn<~w}?GW_h1]OKD~5V^i;w+aZg/ |Ky|ׯul|-M^x—zgм]qckc$^h'Pҿ-;߳gb|;oڣ➥|'o~h_j|? \xՍ9+I."ЬӮkAϠƫoo_@wAϠƫoo_@wAϠƫoo_@ bx< ^^O=?'dQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQE_ |**x? yw\K-//^,񏊵Bd<3]Xu,pLޟ_=dt&4/ k|xǟ|A<5^tx{P?m?;?^Ryྯ?xĿ~3_ƚĽ{C_xKƣZx[L4[־>ңg5-h-wo.D}?z/ON" |I-<+gºĿ AK?Ks=3ӲȥQl,6zXŊ*x*x|Li8YutU`6B T)C ,IecTL&_*ؚ8-*14+`O)` J Ft:P_4G|=h}7Ht@4{XtE-#J(bt ;{X"͏'Ac&gѾ%d;૫|YwE~(oM#ž82uh q^M.އw~^9񽎁:LtO߀Sk'?%𦛭j ~_Rv_7_.2:MIUԊmFpU!N抩NI8FW.1 7:U0X5YP))T%Bu(-GSMFM$޽z+ύy5[{>< IOW%oiMըgW 'Zf^|@^&̾x^>._2G_OGsO>|u_H5ςk?lZ?!;|G[KWk[ xgǚGkGm?| 7ր[?FW!ŅOo-[_]|1ƽ>ᯇ%OX|=Eysžޗu_yxd>/zz7uCI짫x~x<| DŽ,t߈7?fw]^5 JCOu#@uw{V?a"ᯅSm@[z(޾ g/ٛ!I57M⨼%B%"3}sq۫I|A*߄c]mF\=T?m:Wï?o?S~>g//[R񦻤|V>6o,iI7x9-4m#ww%!~ O Gez_oïG ucKO/ %7g-s,A3Ht'Q}CWy߯Z-o__?U|oGQ}CWy߯Z-o__?U|oGQ}CWy߯Z;vx?&xO+ ǃ5{Qe4cw=G([x1aľ!ރ}c|߈:|=3ږyj#x[Ñ[|Hg X^7N_WOG/Sq+? .GoKo |7'"ߍ'DR'įѼS3¿|+|K-|}d?G dR(6{RzXbN<<>&4ixRMcVX*_e_q1*K &/lM~jnu'Suc%NIb#:ujuSaZv/t=>F};д;};F4 ;#Ct8}.l2,mbEA{{z+K'E~9ˠx63&]_+߃'K |?o~|4ό0xᎹGl]:iu4+ПWcύ4 gߴ>|^?l~*,n4oPW?4 Sn^5|:DWK̤%N*Rjiu"QHS4SiNG˱xL~NL+ FT%JtJq5 PJ.1QQI3{z(޿ _|5?Sx?vWdPAW[?a4?WjFD֙|u׮l~-h?>|'1/x~F.?/O5 g⏉|E ொi~exl|Q|OCb3vҞQA/"7[lIqh~?a>{N~?|u_x H5ςGK?xúlZ7u :+-^*n|C9!s H=m'_ xo>  ]A?+i>޿ 7?¿ς_~&>|/4OxUj^=lj|c=FFwSF k^' ~FKoikԺ>*=<<x^> 4> ?xN|1oS?gkoxY?C]I4ƴ7?&?~޺k. _1}__Gƿ_yEׅ< 2 ~'xņt|a$|C ~߲ax'4+^jkY?<<6LFWw?oطÿh"'&;7j|?O? |9o|·V>aO |D}_~3|ɾ.$4nZ޿ 7?ª@?P{z*k{z(޿ EZ޿ 7?ª@7I?2zx3|=}_6>):^e,&UU˅ .b1OӊUhJtةXz.-8ԖN.xwmaO Jq9JTl_>lzާ-K񆫮xY:^~"o?[[J/eFdot}5|q;?w<JumƋP?[|j׼#߆_<HM⟉ ¿&Yh0Eu&QGSx>tW[|e:ſ> |Oi^:`[ + k~2ox[|;/[XouTfW+qZi̯~aa26<)ӣnhKr3InJJIJO~\ ᯉ| [[G|G*OR4߄Ihxk|nM[| /?ۓ o|2`Md={7lh2~> O/rM?I &MVo =Cƞ5_~| ῆ>xĺM3U/I|Dsm#FaԼK-RBt] [}#Hl}SyׁQ|@_ߴih(/C]\~<u| '3<] ؋g!/@|]>|qW߈9;xsw'm{w=I4ƙiA_:Zwo햡e 3W[Ϡƍ~_.|?t-GuW?%!m}4o>à !r~пd3{uO_5?u)wSH[Ҡot kVmgVҼWPؿQ5 +~ҚO xo_t/ xKoFx xho>7A|(?k-GEkC~?wmc6iw_zM};·ÿR/+i>=Ҽ!qN &Ѣm@O^5憀<yѼk?O^5憏Sv}4o>Sve_hhAϠƽe_hh?k?Yx}~F?_x?k?Yx?O^5憀<yѼk?O^5憏Sv7hž!gx3|U}+\fž[UѬoak)qw;.g8}R٬m4 V(૿x/?+OCyz%:O<1CVZ_iZ][G ѥΪ%~L'^/ѾZOW~*xNCL&kD_zƍN|5oI(ѴcS5j2Ѭ0wu~iySuêlXL2S ^^]]QSTbєaS\Zq,/]? gpapsv,x8^օ|&"# RSNQ8Ϟ~h|/uIm4=[_5]s:į־ׄK{o7TxGH՟촨,M_?h 1a>iڶm/ᾧt?~-íxSŸ \x#Wz1>%x7S@&Zi>)R^t;k P)ŚOOzv zN5G_>'P1o7C[UZ㛏6)ڼ>cgc0|0.75/ ?_Og~^=>%~>ß|h4'/S෌`>z#5 |,ռ[=ς=D^\3خxC(ՕyѧR=8biUtNueO٩Wx2*q ~a1kW~' |)xৄi>}o?$|=mk'Ņϋlt7⮛jg4</)S~>|S_/[xg_ $Kþ%d6xexWZiPxR=g\zT*p0NrsQVNRrmճr<Od8e< K V:GNGBRJ*q8E/o2~;Z?~wxk&O'.Ğ(>KEM|C<3O Cz8O ?f? |7KOk |'?EYi? x?;RO'A~S *8$?g~·&x|k?㏅>3Ifi~ / ?,b<_Ex3g_YOS)㗎Zm<Pm kI[xbZ}_C?>k@ǶjkZwa%,: ^?[` 2};Goj./c>C?>*i?gV3«?|F04_j uj{SfH|}cyZ?(&/:]0ka|'>%9?e?g&}c>/_o>jYmͿo/?XiZ1O0k?@߉oj_xG} I G‰gM#W cfwMFu񆑩ۯ<_Zcj읩|t_ 'CTm?xP|]_(_ۛ-" 'Box/?ʠ(Wx῍q9Ծj IO_>γk{{;4ZZwkc^}4xQ$4Pb? j?߲bYf ٞ> C z^5)q9PEPEPEPEPEPEPEPS1K[~κ?­RW}:nx_NGjmGU6xo|Gx\dx:P {*t*ZTJt$R'o+1f8.Kc,6jэz1L&*Gx*tK[ *Gw9~>:yi-k;ſލo|~45A^xo'_x}^=g]YNO x?fNz$9o/ڏ~%Q|5<9_gO#]k_fo |.փ3__׋h>? zDojS"k?7W5UԩTI9IS`&&'ogyT2,.qxyvuW[YR*Z8N5 Tp_t|tI~3-o|Gm!WZּ]2Wx]׎|hI/=<5wk(x32eGXpω.|JMS3'½N;m^V|/Sh(xŗ?~|3_?-Cwv~ AxZN[{ R֭5[_$k:|1>*O:-ğ MǾ׋,=xĔ4Ozď]xkĶ^,O'?ρOE-?iH}.?]ϰO~ - {WcBO+|w+/^.[|^>i_~ǏxG>G/)|REĽG_ |cao[ω~3u_kY!}o?|i<{/x~+>5~VϢ7úT^4o~|> xkMK@վ.|7ҭ<'X066šv./E<}B&U@^hv_?惫,6hx@~2:ͅ厱y{[št~W|f,~9| x:DGZ] >&ÿ^ ŞWLz&?xFW4 Sa">YOЉ_P|A]Gů_</kⶻ|JܗWԼW.0L7#7Ǐ'oEC_w㸾1x_guY^Kc | i[K '/xoRҵ[mVV'_Wவ|d?O#73x'_u(>i5K|Dғ:oRV:ŧٿex^?}Q=g X/u+-E4m[ |%&(4-s¾,t'~6hu  _ޡ;7Ư~+ҵ>+o9Ե/x!fُ_>hg/<+|=| !| 2Umh+`6zU̾*4_?hAًvj-xK> C^>[ύڽx JZֲ5ZSK񎻨xO/E<}B&U^gO t g 0|?o/^&4=/|@"ִiC3]Ҵbe+ا~ *+PAE|5R.>1ixe}S?#ዏ w´ Uq$կ| %k?AS\m|Am+.uHut=]+6ΩejͦGx)E}Co__h)5+? Ugo__?U/k$ӭ>x Ph_\w@DsoTm?M񖊺o4iI sö"!sC D&ԼY@|E#şhzGw;⟌ |RоˮZeM im.dlwP?j~Q}CDojS"k?7W5T}Co__h)5+? Ugo__?Z?xMg 檏E<}B&U@ H?L?<_JW|9ϊ| M[__&|T+| m|,?uԾ4]|^~=|5ռy0 \|E3"𥞑 ^ah?yo? h/!IseЧ485fk3=#ź/!tJ94Z{Aope_^ ,U:Ψ֭^RayAEu gYԅ*ߙqcs湖G|^ac0xQRZQX-*x78q%?P_%ǃ< ώ1|i1B~_t={zVOx@zϟNi?'៉?u[t_ڇ@+ϺwO]ŨxƾZOۓQ(_ 5]=V?>0ii8Nχ|#}PԿ|1M"B4^UaikNPۻ%ʼҞ&^Z|*79NmmɹJRmRm}A2+8 CB8j5ӂ:1J1RPRPr_cGC}< ^x;B_)+wi? 5o3o6~?58^GW]F_Qzo.KŞ*uyo🈼u,գj?i|aL֮>|ׇeߋk˯ZSxLg_|'~̞ s?Qy~ȿ5/ _WكTǃ|@g^X_ി/.5;7|Q/??'~|T>8<9qR?hnUֱ |{Կॺ?]WgC#Q$/u{Y𗌯t/ (?=~ ~?${qi;/,m<S ĖB|k i$jw4ox[K:_ g.-0IN~̟4 PԾ~>=c|Eխ< vkڵE6vĝKӵ-wOC,,?Li_' ?Pk/MV~%mOg߃^=>(. XMV| <1oR>0пo[/ʚ ,<_BiҾ ʿ~$x⏎#g }Cښ|7 {[xjVV ?Go :o>_şڷw?O_q.$&_EuKZv?bQ@կռ'Vi*CQ:O5^|g~xD_tt??ƖQx^<|O8._O~ <9H|0xwE/+ߵ?Km5?Ěំ^?hG_&7L>>x?03o2K o x/u Zv~#xP{xoh$ð[kgb:g-_j~j]6Gᯍ է|u|`5FiE;?j Me>~~eo#z)x G<q|!Z8s4&?~ O=j_  xż ^$n/RA^Cc]k$c-m{goEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEQEjava-design-patterns-1.16.0/servant/src/etc/servant.svg000066400000000000000000001565501312550536300230730ustar00rootroot00000000000000 UML diagram java-design-patterns App (from iluwatar) main(String[*]): void scenario(Servant[0..1], Integer): void King (from iluwatar) isHappy: Boolean complimentReceived: Boolean getFed(): void getDrink(): void receiveCompliments(): void changeMood(): void getMood(): Boolean Queen (from iluwatar) isHappy: Boolean complimentReceived: Boolean getFed(): void getDrink(): void receiveCompliments(): void changeMood(): void getMood(): Boolean setFlirtiness(Boolean): void « Interface » Royalty (from iluwatar) getFed(): void getDrink(): void changeMood(): void receiveCompliments(): void getMood(): Boolean Servant (from iluwatar) name: String[0..1] Servant(String[0..1]): void feed(Royalty[0..1]): void giveWine(Royalty[0..1]): void GiveCompliments(Royalty[0..1]): void checkIfYouWillBeHanged(Royalty[*]): Boolean 1..* « use » java-design-patterns-1.16.0/servant/src/etc/servant.xml000066400000000000000000001264341312550536300230720ustar00rootroot00000000000000

java-design-patterns-1.16.0/servant/src/main/000077500000000000000000000000001312550536300210255ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/main/java/000077500000000000000000000000001312550536300217465ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/main/java/com/000077500000000000000000000000001312550536300225245ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243545ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/servant/000077500000000000000000000000001312550536300260365ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/servant/App.java000066400000000000000000000053431312550536300274260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.List; /** * Servant offers some functionality to a group of classes without defining that functionality in * each of them. A Servant is a class whose instance provides methods that take care of a desired * service, while objects for which the servant does something, are taken as parameters. *

* In this example {@link Servant} is serving {@link King} and {@link Queen}. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); static Servant jenkins = new Servant("Jenkins"); static Servant travis = new Servant("Travis"); /** * Program entry point */ public static void main(String[] args) { scenario(jenkins, 1); scenario(travis, 0); } /** * Can add a List with enum Actions for variable scenarios */ public static void scenario(Servant servant, int compliment) { King k = new King(); Queen q = new Queen(); List guests = new ArrayList<>(); guests.add(k); guests.add(q); // feed servant.feed(k); servant.feed(q); // serve drinks servant.giveWine(k); servant.giveWine(q); // compliment servant.giveCompliments(guests.get(compliment)); // outcome of the night for (Royalty r : guests) { r.changeMood(); } // check your luck if (servant.checkIfYouWillBeHanged(guests)) { LOGGER.info("{} will live another day", servant.name); } else { LOGGER.info("Poor {}. His days are numbered", servant.name); } } } java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/servant/King.java000066400000000000000000000034101312550536300275670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; /** * * King * */ public class King implements Royalty { private boolean isDrunk; private boolean isHungry = true; private boolean isHappy; private boolean complimentReceived; @Override public void getFed() { isHungry = false; } @Override public void getDrink() { isDrunk = true; } public void receiveCompliments() { complimentReceived = true; } @Override public void changeMood() { if (!isHungry && isDrunk) { isHappy = true; } if (complimentReceived) { isHappy = false; } } @Override public boolean getMood() { return isHappy; } } java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/servant/Queen.java000066400000000000000000000035321312550536300277610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; /** * * Queen * */ public class Queen implements Royalty { private boolean isDrunk = true; private boolean isHungry; private boolean isHappy; private boolean isFlirty = true; private boolean complimentReceived; @Override public void getFed() { isHungry = false; } @Override public void getDrink() { isDrunk = true; } public void receiveCompliments() { complimentReceived = true; } @Override public void changeMood() { if (complimentReceived && isFlirty && isDrunk && !isHungry) { isHappy = true; } } @Override public boolean getMood() { return isHappy; } public void setFlirtiness(boolean f) { this.isFlirty = f; } } java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/servant/Royalty.java000066400000000000000000000024701312550536300303470ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; /** * * Royalty * */ interface Royalty { void getFed(); void getDrink(); void changeMood(); void receiveCompliments(); boolean getMood(); } java-design-patterns-1.16.0/servant/src/main/java/com/iluwatar/servant/Servant.java000066400000000000000000000034431312550536300303270ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; import java.util.List; /** * * Servant * */ public class Servant { public String name; /** * Constructor */ public Servant(String name) { this.name = name; } public void feed(Royalty r) { r.getFed(); } public void giveWine(Royalty r) { r.getDrink(); } public void giveCompliments(Royalty r) { r.receiveCompliments(); } /** * Check if we will be hanged */ public boolean checkIfYouWillBeHanged(List tableGuests) { boolean anotherDay = true; for (Royalty r : tableGuests) { if (!r.getMood()) { anotherDay = false; } } return anotherDay; } } java-design-patterns-1.16.0/servant/src/test/000077500000000000000000000000001312550536300210605ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/test/java/000077500000000000000000000000001312550536300220015ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/test/java/com/000077500000000000000000000000001312550536300225575ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300244075ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/test/java/com/iluwatar/servant/000077500000000000000000000000001312550536300260715ustar00rootroot00000000000000java-design-patterns-1.16.0/servant/src/test/java/com/iluwatar/servant/AppTest.java000066400000000000000000000024741312550536300303230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/servant/src/test/java/com/iluwatar/servant/KingTest.java000066400000000000000000000054221312550536300304670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; import org.junit.Test; import static org.junit.Assert.*; /** * Date: 12/28/15 - 9:40 PM * * @author Jeroen Meulemeester */ public class KingTest { @Test public void testHungrySoberUncomplimentedKing() { final King king = new King(); king.changeMood(); assertFalse(king.getMood()); } @Test public void testFedSoberUncomplimentedKing() { final King king = new King(); king.getFed(); king.changeMood(); assertFalse(king.getMood()); } @Test public void testHungryDrunkUncomplimentedKing() { final King king = new King(); king.getDrink(); king.changeMood(); assertFalse(king.getMood()); } @Test public void testHungrySoberComplimentedKing() { final King king = new King(); king.receiveCompliments(); king.changeMood(); assertFalse(king.getMood()); } @Test public void testFedDrunkUncomplimentedKing() { final King king = new King(); king.getFed(); king.getDrink(); king.changeMood(); assertTrue(king.getMood()); } @Test public void testFedSoberComplimentedKing() { final King king = new King(); king.getFed(); king.receiveCompliments(); king.changeMood(); assertFalse(king.getMood()); } @Test public void testFedDrunkComplimentedKing() { final King king = new King(); king.getFed(); king.getDrink(); king.receiveCompliments(); king.changeMood(); assertFalse(king.getMood()); } @Test public void testHungryDrunkComplimentedKing() { final King king = new King(); king.getDrink(); king.receiveCompliments(); king.changeMood(); assertFalse(king.getMood()); } }java-design-patterns-1.16.0/servant/src/test/java/com/iluwatar/servant/QueenTest.java000066400000000000000000000041351312550536300306540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; import org.junit.Test; import static org.junit.Assert.*; /** * Date: 12/28/15 - 9:52 PM * * @author Jeroen Meulemeester */ public class QueenTest { @Test public void testNotFlirtyUncomplemented() throws Exception { final Queen queen = new Queen(); queen.setFlirtiness(false); queen.changeMood(); assertFalse(queen.getMood()); } @Test public void testNotFlirtyComplemented() throws Exception { final Queen queen = new Queen(); queen.setFlirtiness(false); queen.receiveCompliments(); queen.changeMood(); assertFalse(queen.getMood()); } @Test public void testFlirtyUncomplemented() throws Exception { final Queen queen = new Queen(); queen.changeMood(); assertFalse(queen.getMood()); } @Test public void testFlirtyComplemented() throws Exception { final Queen queen = new Queen(); queen.receiveCompliments(); queen.changeMood(); assertTrue(queen.getMood()); } }java-design-patterns-1.16.0/servant/src/test/java/com/iluwatar/servant/ServantTest.java000066400000000000000000000061171312550536300312230ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servant; import org.junit.Test; import java.util.ArrayList; import java.util.List; import static org.junit.Assert.*; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.when; /** * Date: 12/28/15 - 10:02 PM * * @author Jeroen Meulemeester */ public class ServantTest { @Test public void testFeed() throws Exception { final Royalty royalty = mock(Royalty.class); final Servant servant = new Servant("test"); servant.feed(royalty); verify(royalty).getFed(); verifyNoMoreInteractions(royalty); } @Test public void testGiveWine() throws Exception { final Royalty royalty = mock(Royalty.class); final Servant servant = new Servant("test"); servant.giveWine(royalty); verify(royalty).getDrink(); verifyNoMoreInteractions(royalty); } @Test public void testGiveCompliments() throws Exception { final Royalty royalty = mock(Royalty.class); final Servant servant = new Servant("test"); servant.giveCompliments(royalty); verify(royalty).receiveCompliments(); verifyNoMoreInteractions(royalty); } @Test public void testCheckIfYouWillBeHanged() throws Exception { final Royalty goodMoodRoyalty = mock(Royalty.class); when(goodMoodRoyalty.getMood()).thenReturn(true); final Royalty badMoodRoyalty = mock(Royalty.class); when(badMoodRoyalty.getMood()).thenReturn(true); final List goodCompany = new ArrayList<>(); goodCompany.add(goodMoodRoyalty); goodCompany.add(goodMoodRoyalty); goodCompany.add(goodMoodRoyalty); final List badCompany = new ArrayList<>(); goodCompany.add(goodMoodRoyalty); goodCompany.add(goodMoodRoyalty); goodCompany.add(badMoodRoyalty); assertTrue(new Servant("test").checkIfYouWillBeHanged(goodCompany)); assertTrue(new Servant("test").checkIfYouWillBeHanged(badCompany)); } }java-design-patterns-1.16.0/service-layer/000077500000000000000000000000001312550536300204025ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/README.md000066400000000000000000000023031312550536300216570ustar00rootroot00000000000000--- layout: pattern title: Service Layer folder: service-layer permalink: /patterns/service-layer/ pumlid: LOl93SCm3C1MQGUmzUysgY8aAcJ5q96WszVV_aW2V8gHriRb-ZWoPxm07E--Inxrhc2dqv8jEvq3HEl6H8SFNjWs3jcjJSnaju21iG3MSmbnK_mkuwJ_qij7dpNq1m00 categories: Architectural tags: - Java - Difficulty-Intermediate --- ## Intent Service Layer is an abstraction over domain logic. Typically applications require multiple kinds of interfaces to the data they store and logic they implement: data loaders, user interfaces, integration gateways, and others. Despite their different purposes, these interfaces often need common interactions with the application to access and manipulate its data and invoke its business logic. The Service Layer fulfills this role. ![alt text](./etc/service-layer.png "Service Layer") ## Applicability Use the Service Layer pattern when * you want to encapsulate domain logic under API * you need to implement multiple interfaces with common logic and data ## Credits * [Martin Fowler - Service Layer](http://martinfowler.com/eaaCatalog/serviceLayer.html) * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) java-design-patterns-1.16.0/service-layer/bin/000077500000000000000000000000001312550536300211525ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/bin/pom.xml000066400000000000000000000037031312550536300224720ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.0-SNAPSHOT dao org.hibernate hibernate-core com.h2database h2 junit junit test java-design-patterns-1.16.0/service-layer/etc/000077500000000000000000000000001312550536300211555ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/etc/service-layer.png000066400000000000000000002575561312550536300244610ustar00rootroot00000000000000PNG  IHDRq_5IDATxo3]{KUHPiK0KpRrx\1:rcræ&nI:Nٴ8!OJCKP`sRiS5u HZos{ete=5k{A79@- NTC4O7vP 1M0 zD` 1DL}h08Q!@ >A79@-N.NۜpGp~}A79@-v و"j CK`7vPKq?YayJ¹+͋v$+՗3L BA79@- Nу_e?)`6Cq >;Z\h)Ny-g XJAtf)7vPˆigu:Xlq'^MwNx}#F\. y.g XB z zA79@- N.Yz ~E1@7ۮ?p݈:K^[Xq9c'A@osZ$?мxxngw0Xr$&(͇ o1A@osZ^O^<}ݩ\ivA: {gKhɘĺvC :@9@-A Nw8/82 zbLn(>kK78_>]b>|u#1B_ 4}h18?F@CCybu6ny|FV!cnAW(F;%z1M0 zD` 1DL}h08Q!@ >A79@- NTC4O7vP 1M0 zD` 1J|o숵@osZ m_z|- w<~x-v/|_eſoՃ@osZ8$bu1P|T4?xo!^_&20A79@-N\$ozXn_powЫvW"qd;~1`r?}o;/~Oſ~#?xѼunL$*'ik;U:v;A79@-[N$?k&{+gVA1Z !H~w[_ՅaĸF^i^l^ mA8ʏ Gl{lG^vM'}hl38<7_pN˅F $d k-|/ol}/<7>96xyiBLM-ryn]469fuà;3 zԲgLwËڳgo ̎s"moq5!eL;v:XB2l1\a 1H~=o;/~Zlo'c=Ng9mg =]|fwqڦWoݗ}dlǍu- ǚff#?keN¯ zԲkLTϼ[u\.{|s>޼ǾCw\=?xԙ {Cm ix;3q[wuoOoGxӵpG/ѵٮyL>6˽q n|viuM-˗>αfs  ZԒbpnhdC G8֯Wچ.\Cdݦ-'ねbh&،]QѷVo|毾o݅nM45kvm]|i26mn ll釶Lta/9o;H~jfpiz"cƻ\_l; yɋF iϼM 4?m>_ӣy~?vR|Iq6ш[>ii.tۦŮ_w7 /[;~if9[YtBsZ9&q.Vc܁jtq9`8lfC4fkin;27='ZHYq<`hͻmӒVڦHFk2r`7v.B,zxI<9@- N,?h~kl`{E~pa 7Ƙ]!u%@ qom?#z1xOyxײ3)fNs˳-pp[Ͳ6mae-+%vU<;{ ;BxԲd1-'h`0peHm筗,S c-um'ĿXbo}G{w8y/ksM z /|Ap?b ]-b}I^' 9 D;%d1kni oje_]/41M5^zg;Oſ?|zYbCfmmG S'y=IJYmܹ;9ٟb|,ǧZDo'[Ē{3 qLK japYD2+1McHjapB0 &|@osZ h o'*c!`'F; b& japB0 &|@osZ "_卧/, zԲ # ծ56F;% # ]6'Jbaـ+恱4l_v,]]ׯd_td;Y?Zwlv\l鴐 c!GTXYcک̚*y5ɬ RkE lf E8k w'E7A^qNt b03` 1,{ݴ6/.̆z>lNK7: c-]NŶ6+2F;68aD!iDbhl~ݚOɿӅ3Jpk Zf(9@-AF2F t?8i+ͣ=;?c{,l/ %~Db(jlښ[֙dִMng){-=B~j #G v|ir2)ޭ5I}TqӖ}'&A79@- NTC4O7vP 1Đ*MQ>q c/3wm{o; 3v 7k[>9,OB-k[o@osZ18 /.+@ LGm}ꤒHT: ^i^pq rGweo*cM }"l7W̓f'1ۥqT%G4B"Ymf4l/~6ϻ8K뱰Sza?%7vP.kxvo˷GwmaW_|׬~01Đ?oĿ_}+L.zwҖK3&M6Kvo歧/lڒt9]O_}Gi1t V߬mc` 1ߨF+&lqΚ̙/ |w\k۸`+Bgמ?/9@-+\{ܙL\K&[zޛW|Σsܵ` 1xU;੫ݥ%\w=[hRgKl[sko9@-KDr1LxxN.?f?oM?8/fokkVپS];lYLj%֩Xb-`vP*ջ zԲm~pA79@- NTC{{LD]C!Z1PH!@ksZ h o'*c!`'F; bh&u;ףw_\zE zD` 1zo>%^Ho@osZ m-rjapB0ڪ 8'l c#ĕEMx>~Ѽ2ʉ&;o`'+Vi9&Qabh)Ie~\jםJґR zD޸u6Ĩ1Đ7~Ey @`R4A|\~p5;.d}h<854?Ȩ1ĐO|g{S/~_|\?Z>YqpƜ??[5hﺑBks?h?rOT]\X^OWlvdŽRAo'+1yټ2ݒb@ GUF O˟;rŏb57L\%Gx=nj͙nw}mj~'ͫО9i+0]yv_s/탾@osZn\0S0ۋm-.QQc!&>FXh֘ws.47l-IF8l-k[_w\4ݩl$}h<8 ~\.S9AreF W=v*?&W(.i_پf,C{2{KlfknRoA~=j$q#V*hb=u0j[{+מ=~cFQ,\[urlsw>nc'+i~pb=u0jE_Gp9n1iזok>_mA m}E;%.L^tlKhTfbȧ ?|nrldsƜ6r0W/bA;%I 7KZx< /Tu0ocK }hkp6QQcx5tq{u~kj zK(1` 1&;ceޅ!1jdz= Uu0KLl zD` 1DL}h08Q!@ >A79@- NTC4O7vP+MdW@ Hhvʟٟ5[ne4\.}-&)?8~^\$͎1JgI*phA~79@^I)ٙ:+WlZDXbMMRoAe6ʬl`:8 ?t:]n03tVlX,jzxxwT*9oiflJJݰc:ys],V 6b>L&dD1ĮAt:\Nh4lV_?}^gp)3.=jw'酸$NXfnʒs.;l^1r0<ةXQ atڼhTRFa:u:pv:ty&iWw~wwƌ$e x̜B{}n {l)Y6Bkږ,kPv9 A>/%lەRsf0tp8, {?\>V];p^JyA,f$/CR0?Y=G2m5d h鳳3^'J)u~?JuIVrfy}{>G~ȺeKtWDgY9[ͱКs/b^皫e eR4:<kˬ.U*0AC;DC.+^>;;!k!_Dr\(s-p8-s*.Wsm;}$W:?鶅*0AC;DCd2\$]R~N+ 4?rXh^#yvpfsy2Z":̛!ނrr(zi[]^Tf%T:F;Dh4* k4RIJyv핳-f2YlDі.^HN!83yz"GG岹$/uKނp4o|_ʹAZ0F;DIrѨ^!? bjSƴAZLӜE~ 1 ٬܏\.W*d]E0tn?g?@~ 0rżT*%k\:NJ&D}-$+%>E ? Rh.T*emT`0HPvA@~  ūS-?(Zb(h2?ة:+}by~|۬HϯE=F;h$ Ko>mɾ?"^O҂Nr[C~Al$ūfYi=~;?{|Ѷ87Ui|L_yX>M`M$wa[e暕fޜ6F FhuE ~?J.l6gxG>-Y\?InI%1]S{5'joۖ\!A~Es5<.'Ql6U^W/kt:\Nv)T'd.]O|}xH+~ Sx9}Ask~Ж\}ۜA[AhL&3ed G_z PW~׾r|G=/nmBj.s$?Jh l64V*KDKPI|x/U :+s @osZ Bݖ]E"?(z.Et|-O VΟ/oY_Ka\_<D_| 4n7E$VT*Ol4RIv)J ?Hf{> L׸g!^Fs#`T^ן>x)v[@ sR1Xx>y&Xy  FQ.v o9!{GńILzg;D`1 BpxxKwn馫WFS@ $(JFCv)4GHVsb??7~EBfʞNt,_A"tX1Ή^D. օv''r*d2׷z.Kht7.VD\v)2{}o|G:fJy0w~=IzT%Ǧ5ӷ"|Nu*b; η[AN#:BO&RL&sB=|>լ~?J.VD=jw+??risOQ,t$8'87˻M&MgMrp}-)~4$.K)KqKƩ˖v}ID'К( ~djkR>#<"~ A37ΠUNsfɾB3fIəᖒs{גŻ\TA˒i!mO8q-l e/vW. $FpooOj hfUtssRlK2Lד]^W=v*?&W(ٴ9}>P,ųw#(L&e> !?V#<]Jv)}>@4DxVlPVZ3s=g ??,<&8Y`b3?hV%*BNvHĐCG^T'd"H,b\. \.g<=, ѩH)V!%?h2dT*9l CozkRI 3 W@tsx*}p84Q0bb4h4D%Q%f^bՒ]') mH~dMnl@vF. K-B>?;;] |: P-?h^g2QI6h;DeYktkmkj??B$?HAS7,9 rĨCDMvA#FYhJ%٥jB/~q%A7D/V'*B*"QqK&bA FQ^ORb̉XB$?HF&qTU#QXb5`]k ]Wb$qS3 WʆaV3$7O^F-?8}lQ>tй.^봛D9ڷr2w~Iz$?-WO?r4ZS}]i^̶v&]t:RLӳ$F&GveD~/FhKZ&kNP(d2Vƽ~#w?w,Bjl$g ]L]4X޵+L_{}ʒat~pl[Vk~d$ !&/7s@D_h.4F#1"5 SM;څW~>FX2qnmfÅkgBO5mA[ND& &qE7qirYv)dvlVv)BtTv) ^ZV&) $y_zC_Xh_mf~ʚI$?V'?h2dr4w];H T|{KqK|(F4|Jb8OwC^W={ŭXh_m.\>SÊ H<==#Qi;lg28;;KOӱ} @ikZ**J m>'ys;>~kWT/ďu ͤ~tԒ  ,b4d2Y,ww?@sfD)͆3AqVKe"TqK@hAZMR?|4ta#/&á = 9`KDg`\_#~_.STZ57??n,]4tհeb ?dMJ]!SsjR:!a L`{^X,Rz.f 2$8:..,F#%IQsztAqnӇ74ٸxrKK lg #Q@?s1=_>^NfFbQ4 b֔=۟%WTN 2򃌛vH&\.h4H@hOb`Bwv٬R4b`_(RTtj|o剢xU*mtҕ;E` 2tx#ߥRD!vT.R'1cL&{}o|G|r`IT^.$ZMs|6$8u*L2ߩf8)DaPhZ_DNtAŢRNdB(Ns5hۙLF{G>-Y\?d4wѼ2˵rpBc6< +p~]ώ78/$pٲ/ ?(8ۈv(\t]1ډ܍SR(ĘD#sb|.bӭWx84:Bjyg 뵂[\%-KiI2RtcH&S9``0d2d^/N.ZD5b(^\.|cwOoŏbb=?hz뵂5g~~p6mpv-hxY_Jv .'=9F-r\ە]h`p8LhFܪj2,˺Эk?xqk(V[>ВyWK~pJcd ad%ɚ(,Q *HD;0k-]iP] `0(dZ}/瓼_G:K?zL|i~yIL92rAF/:`$ `3s\^C ٥ŸEv)`+~߸ϗhpO~P{MǷDQp_gv9pybׇ;ޝ$ܞ_4taZ/vb8Rӓ sS6@~`0HzOs1NRST'Y`b ?9h4D>L(h瀱~d欫V.H"1MyQ.NNbb ?]( 9`|l6K_a ٥Pe5hۢ5'3e#:^̞@B5`$ 3L**tv, 1%ѵK~Np.jJnWvYdP~?DDLz=%hw\! h$Qbx,N /A~PKF0=QV939Z. KaWfc>%já gXvqTA~ zzh& 91!9ėdYI sQӸ A\NRb,^.Z>A~0&D8If2zN@|!a6"-\r E1#^sE~ qs~~n|B@L!|lt:Mu<#D䳿/FV>v*J9$4/,K:%GyckIL_,VN\l_oZ1ނvیN-3Q3vqtxxXdBķ+vlVv)KLTvY"`#ٷG|R9HXS~AN%Q&Lۭ3QgRL&IbGeB{{{\r\e@,W|o剢xP̞4tB ?ؾ0~$.;C ?(, V0=!^xRD+ETt:͌K;%LFZ?Z>O{}o|GGrmҴe+r[Fo5?x!֜T,+ͼu<82cI\gI܈ nŽ=4@;m2 h4e"bRА8'7T*%tuoPדxG>-Y\?7ۋYn3g㌛'A\B\/5?hf,:pi~x^(,v[v`99B#٥MrKI<$ WVW;??cu&:漞͙hԼЭk?xqk(nt?̻s__Y~plD$?L* $ vv܆)G mV>d2;po<ꗪ-;B~.~.?hٖb[К(GD; 窫]hۢ#Q%d:fՉ8fCVl6˝`~a?|#sbkB6Tų:_]}D ?@BqFJ&RD!uAgHnWvA$:7bQv)"@+j۹ Ky9yrY~Ph^_P{Ak04 3QsHG;؝⮎3x%%ZL&S(8WlF řghDsfJ~p2gp:S=A~;b$ ũx:BA[z]4KRD[OA bX,+n'E(?< G'?8Bxqg`XA~&bb& {9Gg` jRPp8C#3(Ɗ m Bc$ M@8h!Ѧf2k\Q]`0q1mjNf_[ /A~z] Q sЍg2 fY2bT*%|#:>>"tއ !(qbv9]n w G>?;;] Mp6ObW,S%_hm߾0Oso r/`!NbI$  ­ijwļW nnPHL51G#EXVyZD% LZG~hb%1]%^lVv)ٙΉ!p-/AcTtJR2$Q`K^'Zܶ)L 'wc'v4y&_[7h23Q(ZVŰB#.rU! r{iס!9 Ί^P Q`u!E퀨ɢ>.`FzJP/Dr0p^hiFp[pq]Z&rLV%d$w }1GRđqRIf2 @D\.3dZ媮ܑZƵ@F#kgdX@~v~~fL~JdB[$('bL&:mVK df$ ޞ8g(` ? l9r~~ddBgUqJT*ܩRp8gN3QtdLI(ӆI$sRl0i.Ng 3 /"9k\ hH,LJ%Y@<D$z.cvCh4DMv)kۙLFGIGr0 ٥[@?Daە]"!?!ic (HSTP8??]@Da6]\ "r9.pzL&CT zL&ُ)(4Cm莒(G~Q"ڧl6; d܇(ޞѳedHG~*zl>  L&CvX]/TGFS3QȭC9bdEeo$p٥VU,es#3(&D Al—.#MB F&Q d~l.Eq:fd2V%,XA!vl /ZJax 拁kQ5@rPY1{ Da:VAW*R` .˲Kh$i|qpRZ#,@rPe/A2Upzj5=A AHnD<.sT*%.Aʼncmoozy,k^Ӹ#?ݮ0ƋZ&P(d2V%,H(C/ϟ+,r**Bqf4* Ph4Jt}\.'ڋv-,p8\nN#RkWK&| *D+c$ E_h0[):::~4pzzdxHFZ_As_vq`mbY*ɤh}HN!YR`C2 x40ZV*-#]tDȘBYg $QG~PYN:%*h RTXby"qHcQ31]B@ ?y٥Vtד] kۢ#zAZMRrHFs=GD)XE<D~&ᛙ3oB5q"DLWUZVH$mё3$ +`&QyVmdwFEtxl`0$m.9(T^!X; S# 4p,k/1< vzKD7VA®bqزl6ET<"`z _m>X(j$ _pe p,= ["B28[d2m~N# Fk1*A(R*9YSpe pzޮ["®/.下wlPo[V** [>GbT Kr[%Q P6n8f2=zKD7vQŗwh4dX, P`Z̃ @D a& S(?\l8':osrE3|w|΃jQGa_FARoaZU\.X#SVm_9Эu* ?G׹gbz9y3Q g0 %|f~V]u#z.G0vQw;z; ę?LVpӊzPEn0뤒Ҽ׼gb& z g0 %"*}'v$^ >js좣ŗ; Uo~XL&z=7F#"2ZTZ"R`3jjtQ_V{'C"rE /=[ e? 8^ugG -t]8ؑrv\nGCDwA^j}bdŗ2; Džޞ T*j4xT(Uc'@+d~dټbogZF,@?/⚭S m3| Q:?I~0=Qwww~O8*ŵb-u-3x%'=]cߚOoGӍ.4cFX` l6YOzeP,'sqbr9֨rLnYV*F'* ɖ/-+ׁK+Ӫ2|KsMm]ԭD9apz^\NRNPJTK^VWfU?+lp~YX#:fj CN8*{=ԩX*F7RYX ΗO=ϺnZlkq,cnaT)qF!$/?8.SoxUTФ2:-*8֋MPcT B`O8DaXlۜp p" "'䋋/9 mZ3[VPIr! p" "'䋋/9 mZc& ɤt:N8ĊA~8`ԁŗwN6AeyP-B;AArfAl8_\|qOhT "(CG/O>֏[;GKJBP#8_\|qGV0t=SbVf#ָ,>]yZ,T]4 ND#'ӈFW?xo!^bJ”odcZEwj̋+͋iU]LW0N몶ºȁŗawJO,;1wfAkpe j-+~|<[kFbXҿ.@Xmtt'*'{Ɖ(b;T,BNdGU~P{-|_T~׼MήQA;-]Zz%7wch gu(?Q #?p\\|qkp;l-~MR~0Zlħ?>y~X"S/k:${nxQ{C_J9tfIeiu4NXϿtũ3^bTx9j|nZǂ:=N:gº#w }mXܗ5+󢚟ԯ,irc֬2Ѹ8s">iϟ0ҬlKw]a^vZVbS<`ԫJȖfU,Y$>@÷tZˤ*(|r24>D|4^k?'y #}4~?!ֱW`/].qyTbSYu's'iw’>Uȹ@,m,[%wd3ӕJRYH{‰h4 ʩy~ Wm?˷| Ƿ#w]o8~S g!x*/_Iw*|~YŤҎOmG]]%W(ӳӳº#w }# G蘾~qjXټZVi֯]5Fpw|In6~;=fZy@PbrE4 ^I Z=㕪%,<孀s#U[OZ'F rokwFM?>7 ">ϝ?շ됵kݳ/y=j|S?֭7/=fa־[N8@X7]O=a~C6?ǧ֘?_2IyWIgRDEu.irX \r(|r24>D|4^k}/QChPlWlwՉq֬2Ѭ|*aӧEKDϜ0_e5m w}z-+f)2lqzby+v3=5)yr24>D|4^k}]s J?ҲޮkWIu8s,ŋ|IzX6ċ/Cyn>Dž5+|هP *m}vYiNv|kfو??z=7~?bɃŧŻ/?O~,D|4^kc_g'~.}}SovsڄHĚ|b~{ͯX4u'qm_rܩzvۚ{x>IJbXoլxQl>[[$iMkuBlD;`~O{wmOnk,9E[/ 4+e$oj{6z"rvk9vVli%EKJRYHh}‰h4 ʩ~Шmo;yݿO'GMu={zV?߃\Hh}DUɭ_x,q}f7Ʃ* ':6>p^\|qۯ뿰Aq1k}.Z Fl[NմKu1ZVf#Z{{z_Kv .CV4OѶ[:zjkVggm<{>G-[},oq>9kڟp";o/ȵr"?x93ߝ{t~ߟo>hRp w *9jl|Ƚ2S'|*Ԑ_ke6^oOx+CzWBB/*Z`MC}\AGψ _FԭPԟ&A~T.O!X9$:Z` WΏ 6_FԭPԟ&A~Tb1.c JZ` Al8/.下wp' *s̃ @Dh P6; 6;p_\|qOhT Ђl$wAlppq%]>MPcT B N8A~88S,[p989A "C(Al8(Lo+}&,07Moײ_0b׹֒^h;.%Mf~D48t;X?h=v,<1 &a?(_ _#T9S<<4RuԩΟzQi 2>XB%'`nDJK`D}1VQQ2>XB%'`nDJ˒7-chCU*R";Y(9lҪ5ѹQ $u˝eDU#*|nIjcRMnݗŠz@XT QħPnA)餬QIG2 .֋Q.#ePj1+7(M`2I/F*dѓ|_o7UStS&3bhUlS,hn?ȁLb{>kjv>6C.#TQP  %G:] , !A07eXge~9mU5.Ub8W&7Q+8.~^)P =KN܈ > B+LY yGź 0KM@̍p@iY$cX LY yGzrO~3ş s09!<0,P` q{c2c|[~vן7.֧k0NyZmuo4isM&Oi0kj٪L{},8.֣Ĉ07<S &b@m *PZ_Av#9>il}=am7w^fy{{1{2F!m쒷wa 3+nBQ.n=FA1З̂#b=zAT| )mOP 1Q 6b(-c֞gJs gT)gσFzOAnГ@]G:ܽw-1|%={r֕۶+\EBEue{r'B$ a/Rx󨋽k1BEu3zc(]ݽI>H9˚WrlW b拙]ہL+뭩"`53aq _{n26tbp'ʳSӇIxrr[UFE/=)C-kO/:P GRp()}覄@b_>ݯ{wGdc@V8_O}#Vp Q ޖwh1Tv1ǎ&bn4fkxbHGlȴXoMA[pXpSQniU56j%ʴ}8vL,4{a'좗JõNUҥPVƜ]%%̄@tQhp/w_w[R 81sǶ5 o9JcwRZ#Ŝsv*;TM:kobf9?gLj*/svAEٸ&-x?hVbV}˱3~ع~攝nc·D,C-kO-:P GRp()S%']p\o^K>YWj= ]3{#r+iT _xѭ.ǂz3sXڌ%>s5eDt*AsyPJtSm>!|e^8J_L{ol8^׵{^*Rj9\{JՁE+K ¡ӥL5Xϰ).. ִ[X+$<1+%`:nhjZJꈤp߯"0J%:oNRЇ*ΩK\BC;@7`r t:t: Q T߄[!X _! |Y!1!=|?9z"r s 꼙0vPSyu`*%phLNw Vt:TT!4axCO\WHxb.bVG̡Vw*zkJl(x+1I%CKίV(HC; Ǿ@.:3Ga)"l_Q(-w` Ds  Q2BwQR{ur(8 .֕-w`*Ds  Q 2QEhpNL(7XW܁>XB%'`nDJ8OLӽmjhcqG{;c]9kciYOi0eҰ=w79=y1OX[: Db.3Mi+|J@̍p@i?ٍM&>[![sFie^s|@㳽=VSZf( .y{U;A)3Mi+|J@̍p@ic5ر< 0J[߅ЭGWZ3b}f6TFwAfP DrU\'349~ql?6bp>$L +.CsuŜ#^]"*w/1bhTWk3k ܓd5tͶ!-v"d*-u7 P-AduXy*J|AgϩX`/s^˼ܔ [gW- ]yi~~IQ'qF3O -IUAR?l>09YXSNxE-So$.'JG=^'ۃfv;*=5݃~"eV'J%?j zwdvЋ0 $e *;I_=w]C-?Иu:gL?Π^Bs#IKI5+97:7Il̰6: eݨWJK1+R.P0Ad1Yh_[vzM̹&  !AzcpmBf9|XTU( PTIrʻ~'|D>lUdv|{ꢿ-v|RX{j+_YV:H>vXYʿ5A38;\g̎bwhi8#ށV;LJ amFTeejmD"UJVsB;@@\yʤ镫TGOtN>Ьvd+OЊ#A;GZ;@|Gg= &[W9~j[lDaA]e~roߝ~xltof G͞V"rG?>9n;Bx;[v?aEfo4gMu1GUF/'6H@U6kvX ggUznez$H^u8^nՉ .Tep>OT,nq'hI eA N%$}ltƎ3WἇdE7ҁ:~sdٝq=-'! [, uus\eu򖋀:Ʃ,zEbsN1lE f>YS}l?ws{GR&;,Az*=FuG² J)X | X.7R3] ;\<o껽{}{/J6:vcМ#Jp۟#Ў !_OK'-faf(Bxcbhv+Ь7s\tohIьCkC]0j f:a=i;&r5㾹Wҋ+Չ :0Ue+O-NA&%P %F;wgg?<{3Elt.ݖ8dm_9&O !Շqك;oV^A 3IU1U|Ef+HM4!ĹeŐTUfưc]f8Yg5?08qYo:P~qkt"$A9U!~iӇ{qwCmI:v+R>ĜDŽvTn?TxowysAY@U1Ua3Ic?(6s `m{ݬ%G 0dVznYꣴ:V8§X?@9;.w;{.!lajW fi?}q m=쏟p%"#?Շ>gg,5A־TI-c*%TbM[Y PZe?źeŐ]fΘFW{[;r=ٮ.vsIUz,yws_ ,_)T$CR?Ki;bcbQ'!-wZ=sJM0Q AԄ\ 7u;)+!Bu:*&>A?hL1@#n!$DE8Ú8w:ŤH`(zQ?!!<>f!fQJoEiP! EO`D}i .օs`v"$l`bz#Rp\D$)5X?IT`a1(-)r "QჅ!\rB FT8L7{ӧ__~¯NE;OkpTT L@̍p@il~'2ǿ!_(Jw-(b]eX ( ֚ X p>á %9 ˊ t '=XWl6[VS\@)"|fG%WApuu%: *!Ep+UoW-ac}^J`0Nn +wp 2JFvH.(N N#:$"Բp d_tn z[ ,w `+u`D/ HHm|jUQAc<)PI%,nSko?v8 .]u Bt* H4E(ኯib$Dʹ#Nk/Ov>#e7IJiir1p?Q?_u 7 w΃A~cn( tp0"VHv\#P(+D/^v+(zvӻGp˨}lZiS',a?B/[GGJdr\}nv7Jv%H׭Y5` 3 ۭIӑ2 h枮ۣ[Ǧ5XGj0O 3 T1zqkOѾPBtdb䔲 <ÕCHFځӀtLGn@֧vQٴv]/ee6R&=5{mKҿ;d~ϴ&SD/DB%}iGwL>!_FϞTИ|z eDvdV*%VHZ`}G&5j \vZ:ڶnm:tnEDSAeZo;A2l^db| u3RaE2m.wy<%twh} F,)Y&Cv_.*YJb.BD/h0NJ?F~`OJ6oֆQ=8k9lk.PJ`խvlA箽:lAvW|Z̬.u Fthr$^Кf"p%hr+tdƟ<e-v?k)5,yyS 0"|~yy):*![wn^KesK~.rGI(aVaŮizv=.u TthB$^0ٿC"UWWgvZTAwLSܼ>t5ǾF4*U _=l e}0"~@ _wx< MdK&"p?(!O; 1+V6Q;iϸ=ݬd Úɣ5BB0N1!BO7^ޫOH>}Y1'Jj7hSXz(n}p?fL̜Oe?Xj2>l6 MQ?fo0`Ħz ?:: dş66{;8wowTItלo.:ٹ{)uX8/"j%:*!?H w>= kݥٻВ[3_% &Drz82\ݒ^phMٯQɩ Ahd.(ɢ@_[_1ʶ_m 3*ɐf N^-/<5M[.2 ??};qgdվKe^z``۹~yVzLց_He.: !?^'ZnR`}n3'] f*y2 _PHx OӻwZfX-Il6[ȇ^75MKkLG5Jlu`D(Asg{=YP2Eh .(A -h$:$I.5ܸT1ƒfix<&jo6nj4 brIlu`D؟?%/ A (#] `Be@r@!u @aj@$@E«ժhInr!,J ?O~3ş /lp*B`lfo@tߥC2^,fs^{o٣GZ`<"-C_Tᰌo N%A̙7XGPV̧|>/Z AG^c|CT/oX*B`nve(!\.S C26V+˒vfAKTR1G.67-czÎԢiO9˒-Z$ F~ 5A/!YH E{;'^&XR"Rt*CXsg/~ܽ]JRS:XOnEӞe8vhMxj.6XXhxD^7vs s>c/..`0:-,5:#̪}$s?3I.Q7$1ϛͦTPK?+@RG0yBu4{:l]xmOaLgx[PR$VUySމoV?KcS]v8XGDb8<<ƸlD#bٍW< u̟ӱJcbZbGvQG2S˾ ^.j1h4"/MANnrˢ}GGt0Ltx"9,Ct"䗹O["$&IkER!|탷N{?Zc J6zu׫V!% >]8ARn1Y!k?{{Օe7e'~@ {ux|%7k}tLݵ\p/w̍^Tz`XjT;f yoAZ̬.4 .(f\2{Vj~:jvz=J"h2={uz;ghjlC`R 5j8a?gzxXNz?ݯ{wGdc@T?3L`Ws{zo?;צp$JTJխN?IZ܁#fT maXS\@a$za58d9-ȇq ]T in6>q& _G\ds^;i{Jnu@E/6l.Na iS;wgg?<{3Elt eէ/^L?|NCA)?J{M4#l!ΖN>=?],\#Pbab' - 0Hu4v`h}**AA]h46sDՉ@4w.1s >aeN`)?g\^^F]9 CO7^ޫOH>}v/>;+_U᜔sԿS0;ꅎ9RBP-GAcƄb;=AhP 9XG@r@H? xu,74"̀0jjJM!AVRgt/)M6;7XiaXta?B|ϝpq|3V#(ΜRReAw(?-ۅphM(&}h@ 9XG$zF,@f@H0g~5t߁A~YmvSȾ SZ:O$7K9qq:eо_LƼpk9l;/\&RD؟'He;EBI0Q%k1ٌɛ E]f͜v!~p@H4Mѩ. QU 0| o6hTVI UIqMEa bQEBI_nePקfўBb6 ,$\Șsj}Ɏq-ŲM8rc#w}yA*|9(m[З1ʊdK6';h B0?%R<|]v\}j6{3-L*s:dAFNOp@v[T0?QN,Yep" j<Nޛ?zۏ"vM|U0t u @zBt* HF%Nl6GpfĴQ|a&#_ni6?iD ׶W|5=^'h UN +jP~W?#|TFwS<7[iUkqlVrk ^dsjPwrUoۭnn~˼/LĠGL3 7iɧȓcGmQcn@])fK/NleMq*bŖR-"+奦iS*>x;&ds7쪧g*;_~}∮Plg_ Z#S`}Bop@Hf\NpHx͋Ph4ѹ8"%`\aM=q\:Y}oWb rk1Xm<#ElEK; 7d_3siƘӤNLuuН< =;9\i,XE-Z"E" `4N?F~`OJ6:vst5KS=_8~nv vV3y=13٢)a݂1bE'Hh :BHÊRF[W*0{6nO{'~ {&+deFJ[<NMm49?jTnqO;ف_))j?7,v U~_}{x%_Fz4>܉Vgf@`7t xu @Lt* H@%Z#iC--4ϣ~?`HJ׫V?]X#=]3;sk ꮱCeb-#Kr̆~?;sP:ͱ;ف_),tjP~;O^ypK6:v Ūk_p^&$x^,1)a݂0b9ld$j Q 0lawҘt̝U# `LV|뿆n80n8[vs{o1إq( 4&oA~cZlQjFO&Γ4-bŖR-"熓z-:"$_|z'`.9[1[:0ҡ[0\#P(+E/!AVBemvp3#uőV~fo #$";njj[`ޝؾ3B!jzȣB/c!  5^i;rKXȱ /.16 : B|ϝpq|`cuu,fFv.e59i\nvG/`4`-=c.(ـFN`F/aAo™hҸ;c*^&xz|~S8uKоl~^_ǾauSJ&ǘAݣ[s<5C 7 w"lk{~^YHeb{bUlKXȱ|X $NS0Q G$RL\( - .(nѩ.J.E/2ߐ&o"|uPΛϷw(<{tsv;W-OJHOF{R{UKGU,L$u @fX :Ei%iZ-UCT5| lf)V d(?Hi,+D`>F#ѩP46`O{zZ4QFu,L$u @X.~(DEj6WWW?yH#ꆯaxyj³ZJf؅X(b)Vh4*b|1X:;A&.(Yb^Wk 6#rt|>'_ы ,|JBopD؟;N€?X e: c\\\`f@f^ժUU2U z% _/WϓEx`iPX i&\#P((p8VFquuE*|]v\}j6{Sx΃` ?sL @POcp@r8NpQoZy&)!QKdkmQuzcn'!e*e AzSF'=yQ-B?h>H5gƠD D؟#Nޛ?zۏvoiYF01KWYnC͋ON8|p}}}xxX.Z@!QVf9ϙt: <ߒ+"Q'4=uޫt^}Z}~4^iDŽq&+=}o],!_Fn玪`fUpvekJ}}ADWF@;!κڲyg\tSnsjor( f˽899X,zL>ú W{*t;MV8C}~ƿ͙6jP3~|(u5nfI\ RIƘj@`\tSnsfZu @ -x,:Ea$jX6ՕTEBݶzŸ/R!QvHʸEv֖W>YFKl= PV(>5+??dtnGwK}6>c#Nabap~E+G9ntv!D_" gꃋu 8fz.:* :y@&7%E _&;h4R̀͢?@`b hC~^\\NEjjFc8w(^:YjĀD؟5Z?@`b DYLu}\.Ij8j /|d<kvuuDNUP^gĀTD؟5s `$A0,v/:%f)w t:zboݺupp :Q+ ԋx X?Y .\.[TrJhPa6idR"`0VS%4MY@RjtDnWs8ցndS}V6eTY.-\P h4˥d rSQ@hFn3<* R"bpm'B:99jO'Y !:Ed.L ri{bTh"+oV')oe_ᧄ`Ahp ':<%Z R<\]]5 ѩ( g贤krAvhDQIG2Gt$ QB'gv\i޸9W&7tg AiAV6 901"H4hvIFN2y1`czaQkImԢD@N_^yӏ䗏۾SU?NG˳0Aj1v5՟X':Njurq+C-o:^1/JpiL&GnNț!Ť t ݦŒ9@b2$vS1=ȦkyԹ8IVu-t *^ ʑpnY@i\\\LSѩ(>x;&dsaX 7;ayf ۍF'O?g3(5\;7dߋjǴw;{ kXg1mR{3nTb &b%: F^'Ѫ`Zfhl$[693\Zb{=Ldz`t vS7tNNN 9Q#kѩe $_|z'`Q\2>~~X3Fg^{(>KqntpyJ꣮PTzwT%QX"-Y T?Y`\NEA${}ۏ{{㾣 =tYn_& }F`j9ʒ!Ť t &du| m3,JȌ$Jf\\5:bot^Iˡ)z\"sc@Gݴslɑxu˞eHT6Abb HtU@Du,=$N Yh4 a(y.dy 0zb4Az0#cN42){LUAot+Y.4S1"ŢCyoY.z]jVw5,ΐ@ x7MqrrRBl(P ,s\$i= (%:vT& D`Zc&)\VK 7z7 %z$Ǫ `@jL ,\$1<@Z+QMӤuCA "hDZᰜ /5gRl%N,e.\&U?@`b 7TiIP֭[S! Rzz NC*zvhFUZ-%*gBV]ձX\u`gVF?ha$6r/&[. {:uc>uQl.\__j5ѩtZV{^ux,:qyyIDKa>r!}Rm|yXO{+;YZg)?LԺe2:A@z,z.:EBbL/HkjNEfDEN6f!]igI 'A!=w]!QORY,T',aa1SkǕMj "?Fctdnu J-QQbҎy2em&-hvÕ7gDuMXiL&GnNo6y>l}^3KBm 6X? IڜS!;NEX,Vl 6i jurrRVgؔkkˉR_ޏ|BݨBv;L=4'?\w~}L{3Z?t3{᳘6IV:3ZRbڲqHt}d} A<E@ZW1$ngdD-v^ZMs'h4`Hs@Q{ux|%Qӹ|bu X6/Xg=a)ŝ0O(FxLG&_Qg%sǍR,-ty.`Zy~@rDx Nf~{{YWH*rYvEBnc0:A@LS/QcZv}}-:)hUU5y,ɂbz 5&eɉ$K$UY>yß=ȇ;]e 9t,;X;u댌>Y߆Y"m3jnݺU1jHוnE}yyIrp"$_|zއEl/9shG 2aqX`0% @Z(?fJ2X?hƀ̠%(NX,ZVD/-V- H.n4`8L/[f`?@2X?%F`0 f p|@rhZ6p.r: Q A;tLA)dpP}A$/w: Q jU>8ժfD1@fZtBf!81R$/yy)* "?@5X?( j5ѩ.?~BjzjRtZd1̩$X 뺨C ) .E .*7 -^$O$:!aZNSS1*@stJ \J䊻36jpp6iUl#U9cDIb|,97*]N,?C̊g*Ǐ .C4p pF!:n#=aeՂ?..I4AlFnTyx":ECݪR;j糜͔d3 ɴ%̷ At*z& xk5H4өl36^^^VTV( qjB@^K>$j;|~hre/|WZ7t9RZe2}1J6 ' 4H`ِv;ݻWة٬Z>z`0^qo̸899 P~W?#|ۍ1TsIh5͑3D_Gɱg>~A[NݠGإǶ6lC[Prcs@7Z33ǵ#[+{F/)8CƂIdS M/vGTZͧs+Opѩ2\U_ޏ|B^hcLhhq.si ?V\ȞY[Lgl1*\NlFS]>qi9 Wortr[@\gq NrdhH7X5M4x0`E#9Гcz'|\._BX  נ {ux|%9㙍pLB8ػb7OyI|BE`ַ#ܗS є#F_u1&)Ԩa)( H #@!ѐh4WWWBNX,vDK/*5i!s )/ŵժJt1H?ݯ{wGd#ݻnS}Qfk>9~kp8ATO+F;fN@KE)h˞u.\՛ 8=$O\.;N^ $ ZBT2Tt*@ _wɗ&x{^<}x!@z ٪wW@ues1?ٮs7=m\Nl6H{. 1PtGi "HswAf3d@HyΕFnYƒHK j??`긾&Mt* P 7sg/~%XT7kl[D *!5IL{=S]bPK*t9ű9ۀ^8Cg箮& |Fa!Qkd}kx'sxgǏӟt:q%)2-#?c孩*7#zܽHIQXL2LY0|[nW.~^?h4E'81!^kp8٬n#Ut:%zO xHR Bo^֏6 /'MBL&s;F_8A`9$i[i 脸VH$4 t9{'DŽͨLAU(b PPF ]ۊD]XI\.;N^Ǩaӝo 74ʍ3"Tz$7Nt* ` ?ByB`X4 ߲uVjurrRVi*9%=z4H!ek| AZn-?|VX?$] %#xNR)ٺv\i$eJgs@`1k%@:h lUFLJD-o]*~f|h4@oZs1gE.wb"?ʻ~'|D>t3 XM}sġ̷cdby@gRHajE0&nì1= usDzmŔM .g߈BgjvaZdL)Hc Ӵ\.:S '''0(9>x;&d#-M ~' c2c>I?G0Ӱ٧vO#{6gnaJ6n!gߞu@;an}({w+ ':%*8!ں@ HD .:jZE0IC xV @,P[f`co?duX;$;4nqm]COI|BEmAd;[ ƙ1RaЭXŔ5jXoęZ.8&"A^(AVeizn#2<*usR;<Cu !ѓ=#|W;#WkT.6>| @o;TO+FfzvK60{?L4fwnb2g*+BB]p֑nvĸj^KY ;N1?n"$: E?|ΓWgo~xF>ܹ蒍\/1Гsvp<3 hYP4{` ^p O`2 ^_,lnWU׫V˖H. bk[pa:v:ѩ(,yG+R`O,sqgUGU z]Y@ <6Xi%_)OcbAJSn 9mRn${&,B0N/..D?~C$[ 0b.NF_ ^D0SIy*DIO|r1vCf^b@΀?!z]Is! PR) >u}?)Al:< ҠaRIXZï|+TtMӚf9{9ԥzTe0Ӆa"v^diAP%kO O(9.&$kZ3\*̂fYB Z`?tJq \]]ڲ$$ c ` ?Jk“$Al2$pѩpfZ}*v s$#L;caIt@)Nwv?@<8GMӪ*bk@% -:nU:izWjƓ(F# d-pXհPZ0| 2.מJ|jDIGt+eZ?UB SՊt4 |Uk rR:A mXUf C$6j9&\ *vUB.ۨrt:Mr{T*OSQdn.?U9֢h0+99<,?xޯMn|6FԒl%\sjbEWC_3o0ʉfril-gT(nKy69N;N>*6M;儴z:!%|>FSQdpд>mC kiFt+JIXZt U+a\ cZalN9An}ѐLC]Z CRY`^xaLHt䯍el;(揞;{.gpi3HzkǕ鍠 ?RxeQECdsJq(fh4i%# THUorD,@~LSRcJKƆKk(6S_^yӏ䗏50Lo%oqXsɑmYퟚ9 wr<%墜`n jnjam'16Iqr>VL?g2.NYۋp袡P1J4=V~33o?=cZݩT(hD0괉A"]a <ǵZ$X2`}agzt7(DP#ndj oF 1M: F8fv,V̍Y+ EMoY[>>9#OW+:މ'AFv[t*b' %$Jju0k7SUZk(a+فƃѩqVCoP899A)Ѻgm,:L@;5c{=Z̕+W.SX BR5mw#o(aedVEc[%Hˬr@Dyј`fv'vR'3O{/Λ/=9ytˮYG3tXTY5ALIS4;CHmPinݡ=2L67&LKaUk,Kʢ5Pם+0PӇR^).)nňb\_v5۵Ԏb ],=g2P("(nRDeXA>x#7>iۣ_Q &C)|-I[TN mĦ*KKIݺCŦ>+ߎBʝeԕ;R$'893t/o$ljab.kn?>т$&6E)v zUxn+ZBgkkkeeTLYtwww~~Ϙ6Ѧ=}tAj;;;; UA횈c&c^6/|q_bgL_H?$O6*[fA,TuMC}0wG O0%/ewēӐ/\ZG<QMI|p娄 ^~o' %}@#zS1ZeQbY\\,zpp0777u`kkkii qD2n:\Aʏj[NH֝k};̃[\u!>F,LT*F*7nݡ=2LVRa'09/' OTʉy0'o$Ic5=Hvd0 ]W<h+WN͛7EtD,7 :aY`QWk-FiL_d~~~iiInz]*Q֝KϝڸbCuAžn+ UN^5x9uO5_\MJez4mU0gZ ^lgj^R,, ݲ腀*!~=ˀv_oW@S $Ѱd.ٹub~l8&J>i{ %> ^?}εS*Vϴ2T4I֭?vY)a+++24j*dQ~-ihhid ]&|̓*SpԂ^E֠#1%-2'E:)JjOyCplW{%,,$*ZO+++[[[]L.>SVX6uxD___~:$’T[ec>M:./%1i'ru!,S[Xs qөjooLeYi͉x={^~ pp$잹 vvvN#jF/.ALC41 6~fQьrhuWӤv,9)Ě  2 ,--1/j@"A 0AL3hp}@̙3HFsE-Rkr<: M 0 (I T4>b 4x>fuuekkkeeTKYTvjYԑ;ܼy… ÀLDnlYRu~B߳g֝NϜyc`*D-b5x>MawwwqqTxhQ-ڍ4oݺvDd٩U4{J!ui~~g-Ӂ>f @ ѮhզjKdQ˲k꺻YloogՒӶ2׮]vh6ס7"XxI߀fkβ5uoQQJ5bٳg nݺ%4g̢t]؆pY4fUeVyZhnnמ"}%XcYI̡YY:c1%qG*DtDˢn>}ҙ%/^;`׮](>SwZ4pi+( qwa|ԅ{OڸbCq@9N)Ts;:Nok .$F#*6/[?#EjL#L+,--^vNNND#zooC[rT VPr?+++[[[;;;;{D577wʕgI'{~o?{'ņ:`,yCu_饜+>]VX9`M\ܾR5O&%qG KgZəE4*q\B!'zj`tqϫ3j} C-OTkŋOw>YӞ]aw_(;)smM}U w9;W uMPOIzf @2r}6Haiiҳ<J\KX,˚uGT juNZR*%oxwK_uY|;CE5Y uwJ\\*;)t!9rlRA#A0/t猨|ӧO)\ǀRϰvvviZ>H'MSnv!Ws*3(=?ȍOW|;CZH/K'imIڢrZ@o{S/~؄Y`i)[/L\g_W_x q~/v?HiSr^{F`5)[/ \(M)9A%C}Sb;x>fz̢rD%s11.--v4JݩFA,K8XfFJ)[#B:m#^(cAo(f Z΃I)1\UrSy @l=x>0 )] ZD IEK̵g2MCy2[k8nKuS-iK3gÌe=[7&el \aHDuzÜ7:s3w‚P Tw*jckk˙ڪ*Zn EaQ1C5:ʈޔ7p }d;{fk}yc5f-C<۷e7k‹gYYY!\˲z^KFrEٙ9m9XȢ/\P7Z%TDY5(΍E QA<V[u>^D+lv ?zZ~qO:U2O-@pZu8q&-Yj#+W.^Xw**͛w!f nX%b˵eC)Ce$Č:?ԓi?|[:?jA{}o} s\@V eghU߶ak{{{피D"U3DInɉ09&GMgG~{d pL;[y3n>8+;Q ^tٳ^ܬ \ Zvvvg醖hd85˲ YUR[;X%LY%*7o֝:a~6 o}oS#y;2C  gBUY Z˪Mݩhzd:SI΁£=S"*L4*A? .(LH'QM涶NKmoM'NZ`=F9A0T`s nwvC fw9ޗHcFsttWŎ5Hdp1пŵkX4EQ3=[nݩ(gv :mҸT6t߷ 0}Ѩ/ 9e)Ȋ+++v0FvL lTNNNDVvO]g5]5ڴV7??/ZOX Zm[YTpwwWβ]-̙3~ ܥ)  AT"oT>^[]]m[oL@ęP/EsT8T6 9*}m$R@n=p"K 'Y(!S:x2ڢNfApZ~֠Y4vפ`"B}ˠFF>XMB(}Rk# .Qm1+4xsjj4nYؙI4YM_D4vnsіDtfwww?U>gϞM;?%&\ 2nbI9>>^XX3OjHE7=35U:A` ֮hRuݝ2 /BFT[*AjF ,<2"0oܹ,ZȫM~Ŕ}5(f*0Mݩ z.\2 y #ʪh!De/7e&6AܾWDDu`L .%ν$V')kl?1T(1@,Z9sf+6Msv Y L\f8$2^ŠB;V0cksF;2[8pݕ`|G$(xY^4'9))`p1(1}ɘҹr_+Z(<{I &P#E䰺*j٘8VZ(~JNUhQkYYY73s@ٰ8 K'9 (ߓ_Uu"'t>`wZ5ĭ[n7AQ[ nT< ;kwqQO?ro}#7BU=x{}+8y)x%Nٗ^~yw;UFH wT#pQbA@ '''F#i+EW#FmA.U(CŏEĥ''ɢ }PzQt Т#cWJ)9E2{- /K".C*®6QvٯTį!} XM佴dxNC |եc纵;:GzL7aQ .Dutܘ{mɄ`FKa % ^vFl1I=P/ޕ9H)tmP--IɢEj}y&џRBsίtx/dO]M_aw~JYv%x)`.{2?𻪨AS1胠@gϞ^2xp'qwX }yG3M>oz`@{zє}rК .9>jyAVK=/۳A}ӕ+[SAgZx?hb rΛ;_}ڵkvp$真n~/@L`n{|:o背ٯAPYͶT,LiBG}:}2X~2TIy⩶]N\ 9r?Z3h9s$UcD5l*z]5E}p%A"h<9P3"z"Wh8屨zNE6I" +}9{l+4iۗvʛUJO}Qk7Er"-5v$jϢvOF[@ 4$P8d "ђ`qqQ.z6"$Jp!Ǥ0TIoND@3sr,җ;7?C踺WQyu],9eS{G7Ph677) xAT|"o֖VĔ}M&a([:/<!2һ; /uhey(5bȏ(ip+Cx2eejKT裺&Uj~eV)0mM-ݦԈ,|>}mhƃ>cK;?6U&} 0)'''~_V3Li ~G,hGy"{^`:jKI-,ME^G Efyb@;]ů>xؘßV Nw]~}kd|YޢUyHz#xci[NYT9 zDt!3ߴ!DFW9haL~o̵#mTwB!/կ(BgD(v Ze3OP`":DrT8N+UD8mQʤ,orO3`jU󅀠^ZR LP; g(_l 0—x3Sl!3gĿN fp1̈K~v3 ^"]E*jMzFAYTD"~(Ꮑx<|x||,29n8wtz8F;s=dTbjjv gW-,,nM7#տ aᱝJTEkVV2HVs]̈?'d?m^R w]8m3gΈ&=WZ L?(e,Sx>u34Wըp*W캴<>>vVӪÚm}>}"Z#4?F wj0 {ﾻ̄#UhZڵk-!"+hgE(r3ۢuz̙^'(WVVԝ0ԝ~7|wDcpyyH>^J$}$P4씱” N:|N pDMozS l|J͛7EKY42aگ]XX8s挈!Eq^!|_v>1~w»[WsLD% Խ[wB LOů++@9UY0/$Q"d<(ky23@@[j̜0='''^ϲjne,h:av(86[kdf k0mY׍sVsk׮E)Žb o#3cX ik`0GGG ͈t"+xl4lxL[C988fiqn2ƽb o#3cX ik`<.\F"ZYYqqXy>fA5f` 4jVdG7ֽ:Vlx o~ЫYkJ i,f4lVCTu:+\;w=O"DL6A%9*9| 5TYTK#37(h$H3JS>A[*~07r/X4~}۷u#kY'i >*[,0mA%Y3h~#3b4,hZ+=3K 4u n 6 e7' EϛG{$OrN)ʝ؍koJw:L{c8<ʳ4xa$ʼncz˃`6`MT]S'YԤ,JfnQКPдyJIY׍rttT{\tJ7qR'\;TZʛvQmGc5LWbu$eQţE8C6~:9ؖ5ȢeQ2s֠P ,M@www˾VR̮\?8vmKz1AEbGI;s>,ǫ E_ï-}K)RT陕LB qdѤk͊z:-IWȻ Y+<)IWȻC999z*a@5KP7%Ǿowؓ}ej9/VvVh&K2̍T;:9V4Ȣ&gQ2s֠P ,Mufκn m… œ+ITn[sCq͉D=Y7 L)2;]$Y@gw:ɢX˗9i- *Y47 ZXдyJSh\-,,t}E/x! p@r"H6`|;iB\Ed$"SE3A%U9ޚfvingo%٩Ne *yY4 1 M[k4QqX2L+ [˳ 7%._1I\'"/n(03^hVS͌`1/ ttlPEMʢaS@a&=Y׍U_p P_o5fhPa123>goooqq^ }@ F k1͆5A0C!m|ib o#3cX ik`3胂+N+xl4lxL[CsMۨ8 WUb | .tt;Gtzk7`k,w+V(hPa123>U")wA>OJ_^=wl{9o~~瑟BG>xדmTa(kykc?~?bOjѠߚbdf͍jx(nZ K0Wǫ67< N gb wtn{;!нK_|vq tد<>Əjwo[Ҷ /X(S)O?ҵ1-+azku?ٍQ̬.hAseR:NP -3ox7{l1?cJΜu Jp[Z8ZX$b|~ɍ~?뵿n>W{'-uatF++?O1-qɦZ' 7o5fgfm&郁.9-VESMdx7',_x9p͞lKUrPHް>CPⲠrA{3?+_=vwNj^7uG>/|տwk7u@cnpxnXu ZX@gqsw_<[{-WqL/UQkJ=\L67o m:ۄ4r8˽YK\+c`4aqs+j`+hZ%gκn u^Xqp[ƏbNq9gYs}_WXlᕗ>#s_T *e n8I+vVvE')X@gq[W_C{93aI7#ҿyyx1YG v^ n=2nuƬug<[5x2v36aA<ɄZHL̙~gC3Ev$NO)cK-ˎ9D 荕{aj&-nAA@Zk=/K V!rѢa"*9suc X[\\<99D}kN{?y"_;?د/|}鏋cSa >m΅s}kj~1yL5>?cN^v> Q##\{sjtg<9jQ͙Yg3hgTٿlJ`bΔȟ"?,yfYѩܜ+%snF7;+ڹ-eN;s'gNeX. tɜu4f}P4YלKw:?'կOƻ6|wYy 5ơaiIYWڌ?5e5f޿w>~?;œ{(OnPGUƬniNU 3f;i*ۜu :%(Z|K̙^$#,H[B1.x)I6pOpE$}W}/|eK_kKaQ.QB+u$^;{Qj!3bw5f~7Lo[~bۉk"={r{Skx jFe6gfm‚d?;Syk̦3sXax1.ˊюRv/Lmxz'o"/م!U.(Y>5?O???坵zeܝdžC_HBuǤؔU.ćsM]3x׾OϿ$b>蒲zH̚>#Ԟ$f2i*ۜu HE͙3胎<,+Z5FSkn-TKd/E4J%suc$v΃q9ߺO[6Eu_CgOG2H)5:){vSՂV[@gqwyً߉=o֓ڣbViy"XVT67om:ۄ-:טSH9<+-;g_RyvY4k JJIڽ0FSkvNŧˈrj"/م!U.H}k~'o|>O.'Ŀb#O?k,) IjUŔEޫM2yRtF+ǻ]w_U~З_5W͋9ux&RjFeN36IAS$}P3S:ʥ BB\,㠻S|tdFJ ؄IEWul&x\$U.prr,y==O? bOLTDg%m'\-e ?:ro5fޟGGٟ=z&T/(ܦE`)v3f#i*:[kL:09gʪbʰ},CH/xq Sp/Lmx&Y4Gʱʑ:B"2}EUr_pa?0k~n~/]x|gĿ?;|$48)& ]3hxԕoPVX44^K}IB\W LJN7r*y"ϻ_r7'`;ܖ^_?snqhGN…y18w{I ;;xNj|q4DW ҳJzdjt:Sumpd< 3u};2b`]߽ϪkhfiJ~4+ ?jhѶq!3&qk ǕouZ9*GFS-W}ʫ/0V>)t:NjrxfH0]׷"3k- V]%X<@cKS#=3LAb'odc> u>RԙƽJؓ)xʞ!>B'G &OVj3xOO!fOZ1D.n>BNjrxf0%Wy Cc 3<h LI}+:*pm#+f`ZLpY7sIhJkl4lxL[C+  6 *1Ffư6}+׶hPa123>0%A٢JN:XAk wΊwE7`m }4A%ĵm6TXčam6<LI>>8Ln:Nw8?\lЕ{kJkl4lxL[CL}?2M;CwTC;+w>(1s5N5Bw/m9FC9͌sH8%=%= 3AE3-6"6ffuxO'E)6rv(2{g~OʍQ\GhmTg)S$St]}2EQ ~^H*׌/V(-#ǵatVK׊ v|,.ʺ# ϸ>O3XL ڿ~Ed_-tJA)Z> lVk:L@)SQ} tޓ6P0Mxצ{loǵKXz)-T$?Yʦde%ff hp+6|9V5b̍냪W? u 6z3߲HN}`JfzR1}1A%)/}__{Rl-a(S,_6J~2b)8ڔ/ S"kS쏽AϾasP/iRZ)DGuxMx^ENIkof3jd!>O #R[+09+&38KM]3G.)##k}>\XF@uQZ5ɜuRkE;ǕX88LWG4]3$9G^=;_ڳ:LE%s)ysmX/ {VmGd;~  U0ѵ`^ =+kF%ݝ'}ԯc>HkhƋ>XN.ڜA*~$7RIZ*YQNU"7R }0e3=H)PPeUg3g]7(E6A%I .r].bg0u\S{oUę 4$ Uۡӥ_n^&_9sbYpl>Hkh ^Pvd&,/Rߢ@OIJRUNjXWl}0URL{>$jmTgՙ%}`J#ށ ${#7>iۣ_Q km3Q4Yl"W ZC>? :s%ٓd+f1P$54㩴Erpʝ^7Af{D#W_$2rhNpL)ɋ}"tʓ냪FNqSk(#fmTgY%Y׍ !ɽl޴[@g/|q_bg|qm%>~74YO|Dch|듶=Ը6ݸ m#eOՐS=Q NOoEfOy7`gli0'Iϊ<9%;)7fٗ}8PQZ] 6<@Ov3vu;=A1QL1A%)Cw=+W/}}]lcrƵ愂;[7rUppKƣBrƵo^ϼN/k'7'R9 O:~S?8JY!5zV`XD9գ2G%]eLl H]`Ҭ,:sN %]Y׍ }+;އo|Ɲ?Ƶ~*-hO҃{MU_mlECLk %0<㯻7uhIsxKƿ /T'ڗR:٤o3||rtDsբCh<ʍvp7JVPt(ufκn Pf]3x$-\KZa %'ԴmPidD+,adf,XfxQaS{7A%:^jMǺPSk%/ ['ύ2<@ܨ41A)ֽb 0A%::^yN:Wߊ%is`9F0As2!ir# 23 }`Jtt,IlzFm[s1u@g;X){<j v\/*,ݽ>XuhW *0|8 0L}?2A1R By>v4)wZ˒"h،F3>h/sNJ MW纙p=).;֓wL2/f]8 &gO&/>AG$ł6o;c0#n™M=;V,HfzzfK|(ΚB wFRff?h)`?`cT K2(ѽ'OmyS}8`ma}йB:P3y=Vvt>"QZyt#Cl&5ͩ;#y6ñ0#C)^ 7__us£;侄c! 67@${vVgG3tX<&̵x]|pLzx5}wb}IN_A%4KE?U }0e<{" nQ#8 f&}6Ŭ4ڈp7<ֻʥ˯^vͺ,>`u*MPVoZ!QX_ YwsC_>}(Ozv|>`k԰.ڶ#P*l&Dž ) ')|{~Q(vƢ>x]H!V`$ s4Gb}Y"+TKb=卒1<76yoqpDRf>ء7L ')|}Ϝ~՗7KbV_ OTanZzzٝS7&gOv,=Sٗ'f=:J V7@ᤄw ^zbC|ST?H _0*3g~TNZ/25$zȜ1mn/2>SπG AA3(;qOņ‼`x]ofKp08e==BJ]W^&X~,&_"#/Ო13ѵՈP*l UO?; D4]:ʙ`q(`6gμP"w՝it+́h`S]>Rfc~k P8懯ƈ\nõMzt7|8 0,L_#n!|Űڍ8 ̆ +ψp_1v#C$]|_xo^'aq nq(`6 /~Qsb: ߈p1v#CTNZ47(A ݈P*lfNj 6']zeKޘuaӃ%ئH'67@̨Z?ru"Lt =r'Gо^Nh 9.*&FRf3qvp0iLP>(b;7ɞX^#n™M}bPЫRʉSN!;گbq(`6֣{OڸbcX$`yTrvXwx#n™$|0x+DhKՖv9_X]{#CI '{~o?{'ņ(Pph $}p:"!ZdG8W.S:&6( W n t8<<-?]CqZHhK_u$2s|q䳜DRjjq(`6I#/~կ?uQL HקHFy+N z/'e/rlwyjhH4cE,7@#O[rE4U9Z9Lz,qSw+#NV% O測+_5#罾vFRf`ޥW.]~keQL$ Bq50/'s+tN" .1(W>{ߚ /3'K7-OJF 5WF"ˈP*l۞WIbgFUXN,%S^H`"I=;7#HT  gUFUkB/8f_h2c) qP;#CI x3w卫/m<҆8;CUFD?8o&?hz5`F3SOT\a8Y2yl}0Ӑ&mq(`6I;̃[\u!>Ǝ' U9%gҹvd0 e6(לjAwқoj{י=NGC' y?x٤{с;M/ވP*lR,aܩ;o/6hȅXϾ2/TILbR7@ 7\ƄQ:''_tIl'>/aJFRf``u; IVb P8Yqv@#Ci>ht_HZL#nAT0#Ci>Y=\iNF>4]XQFRfc~k P8VġT`aq+nq(`6Xڽ럯$L#nAİڍ8 &uŏ:ൿNl^'aq nq(`6ҩWKF>aq>@JxaĵZl.vx6i4ˈpf6sCD9%һ8`1։_d$&>e'{yM7|8 0.b4.u[}&&*v|E g6}p2D>px[;#r$",-Gt^bSIYFRf`=䩍;o/6FIb,d119م}RB#n™$|0M煎sq*RsZIӓۧ2/Xl-_8 &%K׾מt^P%T:7.:ozC:bI$o8HաbC]&;W+=;D6X"2jn g5!fEw.{8uüqv(GǍ3懝[g$bwM/v%[ő.,IND| 0NBȋgg+O{v]|;cGn"UNC"w몠|B ὶFWcc;ȕ\%$;ZUDzр*vx!XmbL3S@JMRz^tˮYG3Y je6 Un'0A5n(O*Pܓh  A;CF~J#n™)|U냙ѝ$Ac0wd'&ٌYM9UҭCf`'3Ѝ>}>*)5-%ORf`=?ȍOW|;k;"BӇاn+JT['U}@f _`ztw9 .<7\X,4Z"'3Ѝ}fl98?XkfSNAP*l^]}yK!6oaw<cr'}hł$ ɞ*`7@UsYp'={o)c.]kN@ؾ.æsח\U1A5T$X>t3nrņ;FLċ܏yF -8 &Ș| UNjW1 qTLkN}0y^B;'D`9/{㡠j],vȘPI =.}HB]bZjRf` {NmyS}t܉vŏStWN!q,gS$oL{ X_eկM5(׼`k..+/FpS-֊'JO@w$'_";RIJlSAIf0 ~li P8Xۇ8 ̦=7o WN,V#nAÈCFRf&}׌$ѱH>Xۇ8 ̆ +ψp_1v#C!3(W ݈P*l j7|8 0,<#n!|Űڍ8 ̆ +ψp_1v#C!:\ú:8r vF3cj iƓn:>QMeq y\"#P"S'1uxWBZkx[L<'jD{11|8 0A:Ŷ{MV0 gu a=px[;$ e/Y*R;qze yJj}0ޫoQh_X#")ej8 &=ztSwT_lTLJooRut0(iH/LU^UdzI3 iJ[ՈH;e,U3kVbq(`6)_}gLgh[A54j?ASTr T{TO7`9s:XF3}*Ð,a8uFqXW_#U r$w-z^𬸵|<&wzwM/N0h_yJ )>9OE@JMRȋgg+O{v]|;Çu]Uۻ~tW1W%Ʈ;i dcqLk\.F&C2NVTJ~u,d^oET1x 8d鉓hC'fQWj+Ȉpf _3z#hdv|sH5xw@bxk]N$+E paZKEf& d~֚1N(`6I/|q_bgz7Ŭl3>X7@jY':]8j{)CnbkNLNW2{)J,!u2!&)v𡻞yp땫.61f hxqLkN}0y;' O`9\/{ꕑ<9] O1=ɠԩM&OaR؟SnT>lXw3&%ϝڸbC} ^^E+^,;7\/B>I 6(׼2L-.ثʆ/FpSu.֊'JyHpr([,W<بTrMnDD%bCߺ2FMFRf`Mb͆VnqNq+f;ޗhU28 f+yl,Ul,j P8u،k wj })L2|8 0,gH}x(O[l,b P8u،`]}i7|8 0,<#n!|Űڍ8 ̆ +ψp_1v#C!3(W ݈P*l ̙7vVD1h_0 VuA<\úp~ș>,/lhTZ&G[*胉>m/M>ޓ6ؘI*Dt;&9Y˝aaDL4Ah~lR|^I!>*9jels;ɪ`Sv=RI`pБ9g+/Gֆ=`YNl {d]S@ f>YӞ]aR׹SޮϹ;2bps\= =o,+ ;]I+9.)[ IX+.z5(v&JuD=O@T~qޑ&^?/z nAc^D4J[(S^@ f=?ȍOW|;cGCwD}0](lCڜ<8>q}6nN:uq Z`6I/|q_bgVr_<}T}prT¬0@ f>ÇzW^ȣzq0Gfo25_7d }_0}P7>wj۟ 1;ǒbbo0ro&_4TWV]?pl ْ}H1Ah#~lZ]!*Z5Ah~l46qAbC6@FK}.δ1t SĚah٠b Z`6Xy>m/ V@ f>ghԠ:=V rAl&;u+=4Ah~l*eY;V9.k :Kq/iV|D, I{Ɲ?3IEQ}py8;oa-wzkc6sCU:0Ah~lR|^I!>*s;v:a9pZ7~a/rl[`hS/|G,Y @kn: *g_<, Zg Iy~eiϮbg*H`Rfoxk/r`^CX(tmg58  csC' ?@kh$oxwK_uY|;CzXH>>wSBYSm+hvI !2v*H"]>m/M>x#7>iۣ_Q씏 :E:}uwea%ҹcfa)0% m[C(Z`6I/|q_bgۜNySTѻQT1T_3>H@ f>ÇzW^cd?17׼uE$?x op}Æ>m/M>(;qOņ`A<@S:R?#a[xS!%n(sݏgI>m/M>8m&:`l:MR@ f3>(UWmU TmhЙe/änA׹]_/;swZ)A ۶^k1$ gW 郞,8NNYRJ8Cp Jw|'zeAۻ8'_/uDX:$pg 1(ďPwnow>z)[47/i/=~鲞p3n̼=[v/ߞ'l*"XrbK-z: tqV,|w闯p3 jY*[b՞zo8Ŗm=w>x˓{*%4AH/iٟG~LJ}5qWfp7-oW$ ٹvX$NX}Ma[ qFf?/iC};w퇃k6_\Ax>oz8j+|[:!/wn_\ Hc_dz3%m`ҕZ7qV0FY{[w)ίoP_vN!\vFj_vAu%`~I|P /iݕ|!0%mA0FM>vWA藴]}>8F<3>Ļ Gv=Ɋ];*84RƣRei- C`Kڮ(Bh|p`Y6E dW -3o-žލ\A藴Oxzgzpp(**+dXO\}Oخ `_"ߡ_A藴ٯ}p>vayP+˴f`EPlŠ誈ϖ ocwiwMlRfm巊-jͳb_]VuCm\0\F+|7~|ӿ߮4| '*Z͏)r mu>]2jW"ߓj<^f^qFmuq[m}ւϻw,paF+|ãd2uU_6[$VQ5_Wo}L#[bbV_%Dŝi4uPؒߵ=oZk:(3%m]_?xţ/?]֓oNTw؈_k崵U_WJm7Tr`-;w>X^Nw |w闯prqU[û7ұ3WS*SZgm7Wܳm^=lv} wA_֕zgѻ}oq͆AU%Zgp8 wȲIy/GwZo2k{`Dyyzޖ`|0/3~8hܿxҶ7#o3Zn[^\ xITuƳMǁ`EV]u]Õ|!0%mEjW{\\Aܕ̭B_v|unURn.]A藴]r굃եIV>,*D] /ib%`~I|P /iݕ|!0%mA0FM>vWA藴]}>8F<3>,]pv0Mi$۴rxTzk7 /i|0 f{Ye$J\]E^ ^5[f=Q9Bnwޢ|!0%m?ޙ޿l?\*?sJ x>|}xQ^1lΧƮHk| :+4EX־$6nWZ[zճڞԲ"G>GA藴uotYO¿c8Kh+crzZ_hJ8jtM|Ewj?x?ud3/2)njQ>P|w闯p=D_Z\&PUq=s6nkp\mF+|`[>8A8_֕zgѻ}o~Mm}k%U_cWfpk8:e٤oFn?|0/3~8hf}w5S *b}aot~<;i^;lڿͳJvzj_\ogśZ0F?H ߺ0FM>ꤹTo.K>6આ5,)e%`~I|P /iݕ|!0%mA0FM>vWA藴J>kGw8;&Õ ]?7 /i|pͳ8/[h.d Bټ嚋|i> - C`K'<3~8TTTIN‰ۛegd4>8_su.#{j!}+,#w!`K6>|}xQ^1\VY [w]hyVIY8J>3 +F[ڟrU[|otD(`~I[W>O$>5L8VK}7osU֓ 6Y:'|0%m]?qW/_Mdt,~K`"28qֿM4ڒgtv{F藴u僡ޙ}w>}|g |l\ՄwG4/y x\ПgiU֟p|0/3~8hܿx X[;FEYo4ѯq _\U;yƤJ>|"2~:܍g%`~Iۥ%7.;;g7!bK.9pS?ypWx3K>/V^A藴J>6]_&T+ C`Kjw%`~I5僋=|KɅpv0MAwo}p'v6n/ C`Kڮ(S,іEc '{ʟe\6 \/igRQQ%jdRK,S&^ݾ.reNgOFン֋{&%2%m={?|Eߟ4qU.Nd{Wd7Mku7l;ay3ϵs=Kށl>+:,jMpIF+|7~|ӿ߮4| 'h^[1n1w/?YUWddpm.ՕkSzoX޹3iwCĭYJW[΄;,V~f6A_֕_Gy͏p_׺s:\˓JH^eX|U[|/6]߼XLJepYF+|xz PlMa+:9nd߰U;s%~J|p=mpyA_֕~N9=~54{NvA-XkYEq]ㆭmLOY:?ؖ.N櫔ptH`~I[W>G~LJ}5\8)L{zDm]7l4:ػ>תnY=6?X<(ک|0/3~8hfL0z?cT_ f5nx+iZGsWY:qyفpIF?wʷϲ7*ް0Fui?b3ǝ|!0%mk lI"%`~I խ* C`Kjw%`~I|P /iݕ|!0%mA0FmI6ڛ\l[N.x4ˊ,A S*0Fzyv [{>ȏwDm6|_֟>bdsz-&'֢4 藴ٯ}p>\6,-Nf2j93/io64duN-_~fA._.&.NT ?-* C`KںǿG?NpzI5+fkof{'0^,CMVZ_X!&zLr򩗿O&]) C`Kں>><(QNvA묰dqWIY8:}I\KIJiQMw$_A藴uotYO¿c8Y\?/-EWɖvw+VQZ|̀[i#\O\/p$^qyK>|w闯p#kML+2>t/Q]lJ ;Wh .Fgwf݇_Y8D<]7Fs)uV_ 6&Odp|0/3~8h`hTɃood,Vf͋izf#+W4Ohbɭ) C`K뫎y|{]6-jYA藴|>oM̳to(%`~I-3Mw Q%`~IMm( C`Kjw%`~I|P /iݕ|!0%mA0FmbRvh2xCM\QOTQA藴]*n9};w -fk*K>|OL}Z.؜dYWWz0F'|O~ӿr"V[/՝I\4Mx-NMn6[]Vwpeӡ8+yV|jz /i̓: FV̼;Ɋp>UϷ/2hB"[q VΖ]U&ґ'םݴ0F+|ãdzgżq<|x}}%k^'t8rQѴYO;i%`~I[W>O$>dulLf+nw֓nZ_֕~N9=~54{N6"}eF\#-VA藴Ow> cxmDiwv7ro+uq7 /iC};w퇃 [ŋۂjkr[ \kdZ غD_֟*s^6^Gx=Qq_ҖX>R$[ϳ+YU|!0%m5W1SW5y'( C`KڒUB%`~I|P /iݕ|!0%mo`0\A. 8;گiIENDB`java-design-patterns-1.16.0/service-layer/etc/service-layer.ucls000066400000000000000000000341531312550536300246250ustar00rootroot00000000000000 java-design-patterns-1.16.0/service-layer/etc/service-layer.urm.puml000066400000000000000000000110711312550536300254300ustar00rootroot00000000000000@startuml left to right direction package com.iluwatar.servicelayer.hibernate { class HibernateUtil { - LOGGER : Logger {static} - sessionFactory : SessionFactory {static} - HibernateUtil() + dropSession() {static} + getSessionFactory() : SessionFactory {static} } } package com.iluwatar.servicelayer.common { abstract class BaseEntity { - version : Long + BaseEntity() + getId() : Long {abstract} + getName() : String {abstract} + setId(Long) {abstract} + setName(String) {abstract} } interface Dao { + delete(E extends BaseEntity) {abstract} + find(Long) : E extends BaseEntity {abstract} + findAll() : List {abstract} + merge(E extends BaseEntity) : E extends BaseEntity {abstract} + persist(E extends BaseEntity) {abstract} } abstract class DaoBaseImpl { # persistentClass : Class + DaoBaseImpl() + delete(entity : E extends BaseEntity) + find(id : Long) : E extends BaseEntity + findAll() : List # getSession() : Session + merge(entity : E extends BaseEntity) : E extends BaseEntity + persist(entity : E extends BaseEntity) } } package com.iluwatar.servicelayer.magic { interface MagicService { + findAllSpellbooks() : List {abstract} + findAllSpells() : List {abstract} + findAllWizards() : List {abstract} + findWizardsWithSpell(String) : List {abstract} + findWizardsWithSpellbook(String) : List {abstract} } class MagicServiceImpl { - spellDao : SpellDao - spellbookDao : SpellbookDao - wizardDao : WizardDao + MagicServiceImpl(wizardDao : WizardDao, spellbookDao : SpellbookDao, spellDao : SpellDao) + findAllSpellbooks() : List + findAllSpells() : List + findAllWizards() : List + findWizardsWithSpell(name : String) : List + findWizardsWithSpellbook(name : String) : List } } package com.iluwatar.servicelayer.wizard { class Wizard { - id : Long - name : String - spellbooks : Set + Wizard() + Wizard(name : String) + addSpellbook(spellbook : Spellbook) + getId() : Long + getName() : String + getSpellbooks() : Set + setId(id : Long) + setName(name : String) + setSpellbooks(spellbooks : Set) + toString() : String } interface WizardDao { + findByName(String) : Wizard {abstract} } class WizardDaoImpl { + WizardDaoImpl() + findByName(name : String) : Wizard } } package com.iluwatar.servicelayer.spellbook { class Spellbook { - id : Long - name : String - spells : Set - wizards : Set + Spellbook() + Spellbook(name : String) + addSpell(spell : Spell) + getId() : Long + getName() : String + getSpells() : Set + getWizards() : Set + setId(id : Long) + setName(name : String) + setSpells(spells : Set) + setWizards(wizards : Set) + toString() : String } interface SpellbookDao { + findByName(String) : Spellbook {abstract} } class SpellbookDaoImpl { + SpellbookDaoImpl() + findByName(name : String) : Spellbook } } package com.iluwatar.servicelayer.spell { class Spell { - id : Long - name : String - spellbook : Spellbook + Spell() + Spell(name : String) + getId() : Long + getName() : String + getSpellbook() : Spellbook + setId(id : Long) + setName(name : String) + setSpellbook(spellbook : Spellbook) + toString() : String } interface SpellDao { + findByName(String) : Spell {abstract} } class SpellDaoImpl { + SpellDaoImpl() + findByName(name : String) : Spell } } package com.iluwatar.servicelayer.app { class App { - LOGGER : Logger {static} + App() + initData() {static} + main(args : String[]) {static} + queryData() {static} } } MagicServiceImpl --> "-wizardDao" WizardDao MagicServiceImpl --> "-spellbookDao" SpellbookDao MagicServiceImpl --> "-spellDao" SpellDao Spellbook --> "-spells" Spell Spellbook --> "-wizards" Wizard DaoBaseImpl ..|> Dao MagicServiceImpl ..|> MagicService Spell --|> BaseEntity SpellDao --|> Dao SpellDaoImpl ..|> SpellDao SpellDaoImpl --|> DaoBaseImpl Spellbook --|> BaseEntity SpellbookDao --|> Dao SpellbookDaoImpl ..|> SpellbookDao SpellbookDaoImpl --|> DaoBaseImpl Wizard --|> BaseEntity WizardDao --|> Dao WizardDaoImpl ..|> WizardDao WizardDaoImpl --|> DaoBaseImpl @enduml java-design-patterns-1.16.0/service-layer/pom.xml000066400000000000000000000041251312550536300217210ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 service-layer org.hibernate hibernate-core com.h2database h2 junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/service-layer/src/000077500000000000000000000000001312550536300211715ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/000077500000000000000000000000001312550536300221155ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/000077500000000000000000000000001312550536300230365ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/000077500000000000000000000000001312550536300236145ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300254445ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/000077500000000000000000000000001312550536300301415ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/app/000077500000000000000000000000001312550536300307215ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java000066400000000000000000000203111312550536300323010ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.app; import java.util.List; import com.iluwatar.servicelayer.magic.MagicService; import com.iluwatar.servicelayer.magic.MagicServiceImpl; import com.iluwatar.servicelayer.spell.Spell; import com.iluwatar.servicelayer.spell.SpellDao; import com.iluwatar.servicelayer.spell.SpellDaoImpl; import com.iluwatar.servicelayer.spellbook.Spellbook; import com.iluwatar.servicelayer.spellbook.SpellbookDao; import com.iluwatar.servicelayer.spellbook.SpellbookDaoImpl; import com.iluwatar.servicelayer.wizard.Wizard; import com.iluwatar.servicelayer.wizard.WizardDao; import com.iluwatar.servicelayer.wizard.WizardDaoImpl; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Service layer defines an application's boundary with a layer of services that establishes a set * of available operations and coordinates the application's response in each operation. *

* Enterprise applications typically require different kinds of interfaces to the data they store * and the logic they implement: data loaders, user interfaces, integration gateways, and others. * Despite their different purposes, these interfaces often need common interactions with the * application to access and manipulate its data and invoke its business logic. The interactions may * be complex, involving transactions across multiple resources and the coordination of several * responses to an action. Encoding the logic of the interactions separately in each interface * causes a lot of duplication. *

* The example application demonstrates interactions between a client ({@link App}) and a service ( * {@link MagicService}). The service is implemented with 3-layer architecture (entity, dao, * service). For persistence the example uses in-memory H2 database which is populated on each * application startup. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // populate the in-memory database initData(); // query the data using the service queryData(); } /** * Initialize data */ public static void initData() { // spells Spell spell1 = new Spell("Ice dart"); Spell spell2 = new Spell("Invisibility"); Spell spell3 = new Spell("Stun bolt"); Spell spell4 = new Spell("Confusion"); Spell spell5 = new Spell("Darkness"); Spell spell6 = new Spell("Fireball"); Spell spell7 = new Spell("Enchant weapon"); Spell spell8 = new Spell("Rock armour"); Spell spell9 = new Spell("Light"); Spell spell10 = new Spell("Bee swarm"); Spell spell11 = new Spell("Haste"); Spell spell12 = new Spell("Levitation"); Spell spell13 = new Spell("Magic lock"); Spell spell14 = new Spell("Summon hell bat"); Spell spell15 = new Spell("Water walking"); Spell spell16 = new Spell("Magic storm"); Spell spell17 = new Spell("Entangle"); SpellDao spellDao = new SpellDaoImpl(); spellDao.persist(spell1); spellDao.persist(spell2); spellDao.persist(spell3); spellDao.persist(spell4); spellDao.persist(spell5); spellDao.persist(spell6); spellDao.persist(spell7); spellDao.persist(spell8); spellDao.persist(spell9); spellDao.persist(spell10); spellDao.persist(spell11); spellDao.persist(spell12); spellDao.persist(spell13); spellDao.persist(spell14); spellDao.persist(spell15); spellDao.persist(spell16); spellDao.persist(spell17); // spellbooks SpellbookDao spellbookDao = new SpellbookDaoImpl(); Spellbook spellbook1 = new Spellbook("Book of Orgymon"); spellbookDao.persist(spellbook1); spellbook1.addSpell(spell1); spellbook1.addSpell(spell2); spellbook1.addSpell(spell3); spellbook1.addSpell(spell4); spellbookDao.merge(spellbook1); Spellbook spellbook2 = new Spellbook("Book of Aras"); spellbookDao.persist(spellbook2); spellbook2.addSpell(spell5); spellbook2.addSpell(spell6); spellbookDao.merge(spellbook2); Spellbook spellbook3 = new Spellbook("Book of Kritior"); spellbookDao.persist(spellbook3); spellbook3.addSpell(spell7); spellbook3.addSpell(spell8); spellbook3.addSpell(spell9); spellbookDao.merge(spellbook3); Spellbook spellbook4 = new Spellbook("Book of Tamaex"); spellbookDao.persist(spellbook4); spellbook4.addSpell(spell10); spellbook4.addSpell(spell11); spellbook4.addSpell(spell12); spellbookDao.merge(spellbook4); Spellbook spellbook5 = new Spellbook("Book of Idores"); spellbookDao.persist(spellbook5); spellbook5.addSpell(spell13); spellbookDao.merge(spellbook5); Spellbook spellbook6 = new Spellbook("Book of Opaen"); spellbookDao.persist(spellbook6); spellbook6.addSpell(spell14); spellbook6.addSpell(spell15); spellbookDao.merge(spellbook6); Spellbook spellbook7 = new Spellbook("Book of Kihione"); spellbookDao.persist(spellbook7); spellbook7.addSpell(spell16); spellbook7.addSpell(spell17); spellbookDao.merge(spellbook7); // wizards WizardDao wizardDao = new WizardDaoImpl(); Wizard wizard1 = new Wizard("Aderlard Boud"); wizardDao.persist(wizard1); wizard1.addSpellbook(spellbookDao.findByName("Book of Orgymon")); wizard1.addSpellbook(spellbookDao.findByName("Book of Aras")); wizardDao.merge(wizard1); Wizard wizard2 = new Wizard("Anaxis Bajraktari"); wizardDao.persist(wizard2); wizard2.addSpellbook(spellbookDao.findByName("Book of Kritior")); wizard2.addSpellbook(spellbookDao.findByName("Book of Tamaex")); wizardDao.merge(wizard2); Wizard wizard3 = new Wizard("Xuban Munoa"); wizardDao.persist(wizard3); wizard3.addSpellbook(spellbookDao.findByName("Book of Idores")); wizard3.addSpellbook(spellbookDao.findByName("Book of Opaen")); wizardDao.merge(wizard3); Wizard wizard4 = new Wizard("Blasius Dehooge"); wizardDao.persist(wizard4); wizard4.addSpellbook(spellbookDao.findByName("Book of Kihione")); wizardDao.merge(wizard4); } /** * Query the data */ public static void queryData() { MagicService service = new MagicServiceImpl(new WizardDaoImpl(), new SpellbookDaoImpl(), new SpellDaoImpl()); LOGGER.info("Enumerating all wizards"); for (Wizard w : service.findAllWizards()) { LOGGER.info(w.getName()); } LOGGER.info("Enumerating all spellbooks"); for (Spellbook s : service.findAllSpellbooks()) { LOGGER.info(s.getName()); } LOGGER.info("Enumerating all spells"); for (Spell s : service.findAllSpells()) { LOGGER.info(s.getName()); } LOGGER.info("Find wizards with spellbook 'Book of Idores'"); List wizardsWithSpellbook = service.findWizardsWithSpellbook("Book of Idores"); for (Wizard w : wizardsWithSpellbook) { LOGGER.info("{} has 'Book of Idores'", w.getName()); } LOGGER.info("Find wizards with spell 'Fireball'"); List wizardsWithSpell = service.findWizardsWithSpell("Fireball"); for (Wizard w : wizardsWithSpell) { LOGGER.info("{} has 'Fireball'", w.getName()); } } } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/common/000077500000000000000000000000001312550536300314315ustar00rootroot00000000000000BaseEntity.java000066400000000000000000000040211312550536300342610ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/common/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.common; import javax.persistence.Inheritance; import javax.persistence.InheritanceType; import javax.persistence.MappedSuperclass; import javax.persistence.Version; /** * * Base class for entities. * */ @MappedSuperclass @Inheritance(strategy = InheritanceType.TABLE_PER_CLASS) public abstract class BaseEntity { @Version private Long version; /** * Indicates the unique id of this entity * * @return The id of the entity, or 'null' when not persisted */ public abstract Long getId(); /** * Set the id of this entity * * @param id The new id */ public abstract void setId(Long id); /** * Get the name of this entity * * @return The name of the entity */ public abstract String getName(); /** * Set the name of this entity * * @param name The new name */ public abstract void setName(final String name); } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java000066400000000000000000000026231312550536300330020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.common; import java.util.List; /** * * Dao interface. * * @param * */ public interface Dao { E find(Long id); void persist(E entity); E merge(E entity); void delete(E entity); List findAll(); } DaoBaseImpl.java000066400000000000000000000103031312550536300343320ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/common/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.common; import java.lang.reflect.ParameterizedType; import java.util.List; import org.hibernate.Criteria; import org.hibernate.Session; import org.hibernate.SessionFactory; import org.hibernate.Transaction; import org.hibernate.criterion.Restrictions; import com.iluwatar.servicelayer.hibernate.HibernateUtil; /** * * Base class for Dao implementations. * * @param * */ public abstract class DaoBaseImpl implements Dao { @SuppressWarnings("unchecked") protected Class persistentClass = (Class) ((ParameterizedType) getClass() .getGenericSuperclass()).getActualTypeArguments()[0]; /* * Making this getSessionFactory() instead of getSession() so that it is the responsibility * of the caller to open as well as close the session (prevents potential resource leak). */ protected SessionFactory getSessionFactory() { return HibernateUtil.getSessionFactory(); } @Override public E find(Long id) { Session session = getSessionFactory().openSession(); Transaction tx = null; E result = null; try { tx = session.beginTransaction(); Criteria criteria = session.createCriteria(persistentClass); criteria.add(Restrictions.idEq(id)); result = (E) criteria.uniqueResult(); tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } return result; } @Override public void persist(E entity) { Session session = getSessionFactory().openSession(); Transaction tx = null; try { tx = session.beginTransaction(); session.persist(entity); tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } } @Override public E merge(E entity) { Session session = getSessionFactory().openSession(); Transaction tx = null; E result = null; try { tx = session.beginTransaction(); result = (E) session.merge(entity); tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } return result; } @Override public void delete(E entity) { Session session = getSessionFactory().openSession(); Transaction tx = null; try { tx = session.beginTransaction(); session.delete(entity); tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } } @Override public List findAll() { Session session = getSessionFactory().openSession(); Transaction tx = null; List result = null; try { tx = session.beginTransaction(); Criteria criteria = session.createCriteria(persistentClass); result = criteria.list(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } return result; } } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/000077500000000000000000000000001312550536300321025ustar00rootroot00000000000000HibernateUtil.java000066400000000000000000000060571312550536300354350ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.hibernate; import com.iluwatar.servicelayer.spell.Spell; import com.iluwatar.servicelayer.spellbook.Spellbook; import com.iluwatar.servicelayer.wizard.Wizard; import org.hibernate.SessionFactory; import org.hibernate.cfg.Configuration; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Produces the Hibernate {@link SessionFactory}. */ public final class HibernateUtil { private static final Logger LOGGER = LoggerFactory.getLogger(HibernateUtil.class); /** * The cached session factory */ private static volatile SessionFactory sessionFactory; private HibernateUtil() { } /** * Create the current session factory instance, create a new one when there is none yet. * * @return The session factory */ public static synchronized SessionFactory getSessionFactory() { if (sessionFactory == null) { try { sessionFactory = new Configuration().addAnnotatedClass(Wizard.class).addAnnotatedClass(Spellbook.class) .addAnnotatedClass(Spell.class) .setProperty("hibernate.dialect", "org.hibernate.dialect.H2Dialect") .setProperty("hibernate.connection.url", "jdbc:h2:mem:test;DB_CLOSE_DELAY=-1") .setProperty("hibernate.current_session_context_class", "thread") .setProperty("hibernate.show_sql", "false") .setProperty("hibernate.hbm2ddl.auto", "create-drop").buildSessionFactory(); } catch (Throwable ex) { LOGGER.error("Initial SessionFactory creation failed.", ex); throw new ExceptionInInitializerError(ex); } } return sessionFactory; } /** * Drop the current connection, resulting in a create-drop clean database next time. This is * mainly used for JUnit testing since one test should not influence the other */ public static void dropSession() { getSessionFactory().close(); sessionFactory = null; } } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/magic/000077500000000000000000000000001312550536300312215ustar00rootroot00000000000000MagicService.java000066400000000000000000000031541312550536300343510ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/magic/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.magic; import java.util.List; import com.iluwatar.servicelayer.spell.Spell; import com.iluwatar.servicelayer.spellbook.Spellbook; import com.iluwatar.servicelayer.wizard.Wizard; /** * * Service interface. * */ public interface MagicService { List findAllWizards(); List findAllSpellbooks(); List findAllSpells(); List findWizardsWithSpellbook(String name); List findWizardsWithSpell(String name); } MagicServiceImpl.java000066400000000000000000000051401312550536300351700ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/magic/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.magic; import java.util.ArrayList; import java.util.List; import com.iluwatar.servicelayer.spell.Spell; import com.iluwatar.servicelayer.spell.SpellDao; import com.iluwatar.servicelayer.spellbook.Spellbook; import com.iluwatar.servicelayer.spellbook.SpellbookDao; import com.iluwatar.servicelayer.wizard.Wizard; import com.iluwatar.servicelayer.wizard.WizardDao; /** * * Service implementation. * */ public class MagicServiceImpl implements MagicService { private WizardDao wizardDao; private SpellbookDao spellbookDao; private SpellDao spellDao; /** * Constructor */ public MagicServiceImpl(WizardDao wizardDao, SpellbookDao spellbookDao, SpellDao spellDao) { this.wizardDao = wizardDao; this.spellbookDao = spellbookDao; this.spellDao = spellDao; } @Override public List findAllWizards() { return wizardDao.findAll(); } @Override public List findAllSpellbooks() { return spellbookDao.findAll(); } @Override public List findAllSpells() { return spellDao.findAll(); } @Override public List findWizardsWithSpellbook(String name) { Spellbook spellbook = spellbookDao.findByName(name); return new ArrayList<>(spellbook.getWizards()); } @Override public List findWizardsWithSpell(String name) { Spell spell = spellDao.findByName(name); Spellbook spellbook = spell.getSpellbook(); return new ArrayList<>(spellbook.getWizards()); } } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spell/000077500000000000000000000000001312550536300312605ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java000066400000000000000000000045151312550536300332070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spell; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.JoinColumn; import javax.persistence.ManyToOne; import javax.persistence.Table; import com.iluwatar.servicelayer.common.BaseEntity; import com.iluwatar.servicelayer.spellbook.Spellbook; /** * * Spell entity. * */ @Entity @Table(name = "SPELL") public class Spell extends BaseEntity { private String name; @Id @GeneratedValue @Column(name = "SPELL_ID") private Long id; @ManyToOne @JoinColumn(name = "SPELLBOOK_ID_FK", referencedColumnName = "SPELLBOOK_ID") private Spellbook spellbook; public Spell() {} public Spell(String name) { this(); this.name = name; } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Spellbook getSpellbook() { return spellbook; } public void setSpellbook(Spellbook spellbook) { this.spellbook = spellbook; } @Override public String toString() { return name; } } SpellDao.java000066400000000000000000000025131312550536300335500ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spell/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spell; import com.iluwatar.servicelayer.common.Dao; /** * * SpellDao interface. * */ public interface SpellDao extends Dao { Spell findByName(String name); } SpellDaoImpl.java000066400000000000000000000040211312550536300343660ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spell/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spell; import com.iluwatar.servicelayer.common.DaoBaseImpl; import org.hibernate.Criteria; import org.hibernate.Session; import org.hibernate.Transaction; import org.hibernate.criterion.Restrictions; /** * * SpellDao implementation. * */ public class SpellDaoImpl extends DaoBaseImpl implements SpellDao { @Override public Spell findByName(String name) { Session session = getSessionFactory().openSession(); Transaction tx = null; Spell result = null; try { tx = session.beginTransaction(); Criteria criteria = session.createCriteria(persistentClass); criteria.add(Restrictions.eq("name", name)); result = (Spell) criteria.uniqueResult(); tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } return result; } } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/000077500000000000000000000000001312550536300321335ustar00rootroot00000000000000Spellbook.java000066400000000000000000000056021312550536300346540ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spellbook; import java.util.HashSet; import java.util.Set; import javax.persistence.CascadeType; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.FetchType; import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.ManyToMany; import javax.persistence.OneToMany; import javax.persistence.Table; import com.iluwatar.servicelayer.common.BaseEntity; import com.iluwatar.servicelayer.spell.Spell; import com.iluwatar.servicelayer.wizard.Wizard; /** * * Spellbook entity. * */ @Entity @Table(name = "SPELLBOOK") public class Spellbook extends BaseEntity { @Id @GeneratedValue @Column(name = "SPELLBOOK_ID") private Long id; private String name; @ManyToMany(mappedBy = "spellbooks", fetch = FetchType.EAGER) private Set wizards; @OneToMany(mappedBy = "spellbook", orphanRemoval = true, cascade = CascadeType.ALL) private Set spells; public Spellbook() { spells = new HashSet<>(); wizards = new HashSet<>(); } public Spellbook(String name) { this(); this.name = name; } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Set getWizards() { return wizards; } public void setWizards(Set wizards) { this.wizards = wizards; } public Set getSpells() { return spells; } public void setSpells(Set spells) { this.spells = spells; } public void addSpell(Spell spell) { spell.setSpellbook(this); spells.add(spell); } @Override public String toString() { return name; } } SpellbookDao.java000066400000000000000000000025371312550536300353040ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spellbook; import com.iluwatar.servicelayer.common.Dao; /** * * SpellbookDao interface. * */ public interface SpellbookDao extends Dao { Spellbook findByName(String name); } SpellbookDaoImpl.java000066400000000000000000000041651312550536300361250ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spellbook; import org.hibernate.Criteria; import org.hibernate.Session; import org.hibernate.Transaction; import org.hibernate.criterion.Restrictions; import com.iluwatar.servicelayer.common.DaoBaseImpl; /** * * SpellbookDao implementation. * */ public class SpellbookDaoImpl extends DaoBaseImpl implements SpellbookDao { @Override public Spellbook findByName(String name) { Session session = getSessionFactory().openSession(); Transaction tx = null; Spellbook result = null; try { tx = session.beginTransaction(); Criteria criteria = session.createCriteria(persistentClass); criteria.add(Restrictions.eq("name", name)); result = (Spellbook) criteria.uniqueResult(); result.getSpells().size(); result.getWizards().size(); tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } return result; } } java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/000077500000000000000000000000001312550536300314415ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java000066400000000000000000000050131312550536300335430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.wizard; import java.util.HashSet; import java.util.Set; import javax.persistence.CascadeType; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.ManyToMany; import javax.persistence.Table; import com.iluwatar.servicelayer.common.BaseEntity; import com.iluwatar.servicelayer.spellbook.Spellbook; /** * * Wizard entity. * */ @Entity @Table(name = "WIZARD") public class Wizard extends BaseEntity { @Id @GeneratedValue @Column(name = "WIZARD_ID") private Long id; private String name; @ManyToMany(cascade = CascadeType.ALL) private Set spellbooks; public Wizard() { spellbooks = new HashSet<>(); } public Wizard(String name) { this(); this.name = name; } public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Set getSpellbooks() { return spellbooks; } public void setSpellbooks(Set spellbooks) { this.spellbooks = spellbooks; } public void addSpellbook(Spellbook spellbook) { spellbook.getWizards().add(this); spellbooks.add(spellbook); } @Override public String toString() { return name; } } WizardDao.java000066400000000000000000000025201312550536300341100ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.wizard; import com.iluwatar.servicelayer.common.Dao; /** * * WizardDao interface. * */ public interface WizardDao extends Dao { Wizard findByName(String name); } WizardDaoImpl.java000066400000000000000000000042501312550536300347340ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.wizard; import org.hibernate.Criteria; import org.hibernate.Session; import org.hibernate.Transaction; import org.hibernate.criterion.Restrictions; import com.iluwatar.servicelayer.common.DaoBaseImpl; import com.iluwatar.servicelayer.spellbook.Spellbook; /** * * WizardDao implementation. * */ public class WizardDaoImpl extends DaoBaseImpl implements WizardDao { @Override public Wizard findByName(String name) { Session session = getSessionFactory().openSession(); Transaction tx = null; Wizard result = null; try { tx = session.beginTransaction(); Criteria criteria = session.createCriteria(persistentClass); criteria.add(Restrictions.eq("name", name)); result = (Wizard) criteria.uniqueResult(); for (Spellbook s : result.getSpellbooks()) { s.getSpells().size(); } tx.commit(); } catch (Exception e) { if (tx != null) { tx.rollback(); } throw e; } finally { session.close(); } return result; } } java-design-patterns-1.16.0/service-layer/src/main/resources/000077500000000000000000000000001312550536300241275ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/main/resources/logback.xml000066400000000000000000000042031312550536300262520ustar00rootroot00000000000000 service-layer.log service-layer-%d.log 5 %-5p [%d{ISO8601,UTC}] %c: %m%n %-5p [%d{ISO8601,UTC}] %c: %m%n java-design-patterns-1.16.0/service-layer/src/test/000077500000000000000000000000001312550536300221505ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/000077500000000000000000000000001312550536300230715ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/000077500000000000000000000000001312550536300236475ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300254775ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/000077500000000000000000000000001312550536300301745ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/app/000077500000000000000000000000001312550536300307545ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java000066400000000000000000000027641312550536300332100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.app; import com.iluwatar.servicelayer.hibernate.HibernateUtil; import org.junit.After; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } @After public void tearDown() throws Exception { HibernateUtil.dropSession(); } } java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/common/000077500000000000000000000000001312550536300314645ustar00rootroot00000000000000BaseDaoTest.java000066400000000000000000000106661312550536300344170ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/common/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.common; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; import com.iluwatar.servicelayer.hibernate.HibernateUtil; import java.util.List; import java.util.concurrent.atomic.AtomicInteger; import java.util.function.Function; import org.junit.After; import org.junit.Before; import org.junit.Test; /** * Date: 12/28/15 - 10:53 PM * Test for Base Data Access Objects * @param Type of Base Entity * @param Type of Dao Base Implementation * @author Jeroen Meulemeester */ public abstract class BaseDaoTest> { /** * The number of entities stored before each test */ private static final int INITIAL_COUNT = 5; /** * The unique id generator, shared between all entities */ private static final AtomicInteger ID_GENERATOR = new AtomicInteger(); /** * Factory, used to create new entity instances with the given name */ private final Function factory; /** * The tested data access object */ private final D dao; /** * Create a new test using the given factory and dao * * @param factory The factory, used to create new entity instances with the given name * @param dao The tested data access object */ public BaseDaoTest(final Function factory, final D dao) { this.factory = factory; this.dao = dao; } @Before public void setUp() throws Exception { for (int i = 0; i < INITIAL_COUNT; i++) { final String className = dao.persistentClass.getSimpleName(); final String entityName = String.format("%s%d", className, ID_GENERATOR.incrementAndGet()); this.dao.persist(this.factory.apply(entityName)); } } @After public void tearDown() throws Exception { HibernateUtil.dropSession(); } protected final D getDao() { return this.dao; } @Test public void testFind() throws Exception { final List all = this.dao.findAll(); for (final E entity : all) { final E byId = this.dao.find(entity.getId()); assertNotNull(byId); assertEquals(byId.getId(), byId.getId()); } } @Test public void testDelete() throws Exception { final List originalEntities = this.dao.findAll(); this.dao.delete(originalEntities.get(1)); this.dao.delete(originalEntities.get(2)); final List entitiesLeft = this.dao.findAll(); assertNotNull(entitiesLeft); assertEquals(INITIAL_COUNT - 2, entitiesLeft.size()); } @Test public void testFindAll() throws Exception { final List all = this.dao.findAll(); assertNotNull(all); assertEquals(INITIAL_COUNT, all.size()); } @Test public void testSetId() throws Exception { final E entity = this.factory.apply("name"); assertNull(entity.getId()); final Long expectedId = Long.valueOf(1); entity.setId(expectedId); assertEquals(expectedId, entity.getId()); } @Test public void testSetName() throws Exception { final E entity = this.factory.apply("name"); assertEquals("name", entity.getName()); assertEquals("name", entity.toString()); final String expectedName = "new name"; entity.setName(expectedName); assertEquals(expectedName, entity.getName()); assertEquals(expectedName, entity.toString()); } } java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/magic/000077500000000000000000000000001312550536300312545ustar00rootroot00000000000000MagicServiceImplTest.java000066400000000000000000000134431312550536300360700ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/magic/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.magic; import com.iluwatar.servicelayer.spell.Spell; import com.iluwatar.servicelayer.spell.SpellDao; import com.iluwatar.servicelayer.spellbook.Spellbook; import com.iluwatar.servicelayer.spellbook.SpellbookDao; import com.iluwatar.servicelayer.wizard.Wizard; import com.iluwatar.servicelayer.wizard.WizardDao; import org.junit.Test; import java.util.HashSet; import java.util.List; import java.util.Set; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; import static org.mockito.Mockito.when; /** * Date: 12/29/15 - 12:06 AM * * @author Jeroen Meulemeester */ public class MagicServiceImplTest { @Test public void testFindAllWizards() throws Exception { final WizardDao wizardDao = mock(WizardDao.class); final SpellbookDao spellbookDao = mock(SpellbookDao.class); final SpellDao spellDao = mock(SpellDao.class); final MagicServiceImpl service = new MagicServiceImpl(wizardDao, spellbookDao, spellDao); verifyZeroInteractions(wizardDao, spellbookDao, spellDao); service.findAllWizards(); verify(wizardDao).findAll(); verifyNoMoreInteractions(wizardDao, spellbookDao, spellDao); } @Test public void testFindAllSpellbooks() throws Exception { final WizardDao wizardDao = mock(WizardDao.class); final SpellbookDao spellbookDao = mock(SpellbookDao.class); final SpellDao spellDao = mock(SpellDao.class); final MagicServiceImpl service = new MagicServiceImpl(wizardDao, spellbookDao, spellDao); verifyZeroInteractions(wizardDao, spellbookDao, spellDao); service.findAllSpellbooks(); verify(spellbookDao).findAll(); verifyNoMoreInteractions(wizardDao, spellbookDao, spellDao); } @Test public void testFindAllSpells() throws Exception { final WizardDao wizardDao = mock(WizardDao.class); final SpellbookDao spellbookDao = mock(SpellbookDao.class); final SpellDao spellDao = mock(SpellDao.class); final MagicServiceImpl service = new MagicServiceImpl(wizardDao, spellbookDao, spellDao); verifyZeroInteractions(wizardDao, spellbookDao, spellDao); service.findAllSpells(); verify(spellDao).findAll(); verifyNoMoreInteractions(wizardDao, spellbookDao, spellDao); } @Test public void testFindWizardsWithSpellbook() throws Exception { final String bookname = "bookname"; final Spellbook spellbook = mock(Spellbook.class); final Set wizards = new HashSet<>(); wizards.add(mock(Wizard.class)); wizards.add(mock(Wizard.class)); wizards.add(mock(Wizard.class)); when(spellbook.getWizards()).thenReturn(wizards); final SpellbookDao spellbookDao = mock(SpellbookDao.class); when(spellbookDao.findByName(eq(bookname))).thenReturn(spellbook); final WizardDao wizardDao = mock(WizardDao.class); final SpellDao spellDao = mock(SpellDao.class); final MagicServiceImpl service = new MagicServiceImpl(wizardDao, spellbookDao, spellDao); verifyZeroInteractions(wizardDao, spellbookDao, spellDao, spellbook); final List result = service.findWizardsWithSpellbook(bookname); verify(spellbookDao).findByName(eq(bookname)); verify(spellbook).getWizards(); assertNotNull(result); assertEquals(3, result.size()); verifyNoMoreInteractions(wizardDao, spellbookDao, spellDao); } @Test public void testFindWizardsWithSpell() throws Exception { final Set wizards = new HashSet<>(); wizards.add(mock(Wizard.class)); wizards.add(mock(Wizard.class)); wizards.add(mock(Wizard.class)); final Spellbook spellbook = mock(Spellbook.class); when(spellbook.getWizards()).thenReturn(wizards); final SpellbookDao spellbookDao = mock(SpellbookDao.class); final WizardDao wizardDao = mock(WizardDao.class); final Spell spell = mock(Spell.class); when(spell.getSpellbook()).thenReturn(spellbook); final String spellName = "spellname"; final SpellDao spellDao = mock(SpellDao.class); when(spellDao.findByName(eq(spellName))).thenReturn(spell); final MagicServiceImpl service = new MagicServiceImpl(wizardDao, spellbookDao, spellDao); verifyZeroInteractions(wizardDao, spellbookDao, spellDao, spellbook); final List result = service.findWizardsWithSpell(spellName); verify(spellDao).findByName(eq(spellName)); verify(spellbook).getWizards(); assertNotNull(result); assertEquals(3, result.size()); verifyNoMoreInteractions(wizardDao, spellbookDao, spellDao); } } java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/spell/000077500000000000000000000000001312550536300313135ustar00rootroot00000000000000SpellDaoImplTest.java000066400000000000000000000037441312550536300352740ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/spell/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spell; import com.iluwatar.servicelayer.common.BaseDaoTest; import org.junit.Test; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/28/15 - 11:02 PM * * @author Jeroen Meulemeester */ public class SpellDaoImplTest extends BaseDaoTest { public SpellDaoImplTest() { super(Spell::new, new SpellDaoImpl()); } @Test public void testFindByName() throws Exception { final SpellDaoImpl dao = getDao(); final List allSpells = dao.findAll(); for (final Spell spell : allSpells) { final Spell spellByName = dao.findByName(spell.getName()); assertNotNull(spellByName); assertEquals(spell.getId(), spellByName.getId()); assertEquals(spell.getName(), spellByName.getName()); } } } java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/000077500000000000000000000000001312550536300321665ustar00rootroot00000000000000SpellbookDaoImplTest.java000066400000000000000000000040121312550536300370070ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.spellbook; import com.iluwatar.servicelayer.common.BaseDaoTest; import org.junit.Test; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/28/15 - 11:44 PM * * @author Jeroen Meulemeester */ public class SpellbookDaoImplTest extends BaseDaoTest { public SpellbookDaoImplTest() { super(Spellbook::new, new SpellbookDaoImpl()); } @Test public void testFindByName() throws Exception { final SpellbookDaoImpl dao = getDao(); final List allBooks = dao.findAll(); for (final Spellbook book : allBooks) { final Spellbook spellByName = dao.findByName(book.getName()); assertNotNull(spellByName); assertEquals(book.getId(), spellByName.getId()); assertEquals(book.getName(), spellByName.getName()); } } } java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/000077500000000000000000000000001312550536300314745ustar00rootroot00000000000000WizardDaoImplTest.java000066400000000000000000000037351312550536300356360ustar00rootroot00000000000000java-design-patterns-1.16.0/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelayer.wizard; import com.iluwatar.servicelayer.common.BaseDaoTest; import org.junit.Test; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/28/15 - 11:46 PM * * @author Jeroen Meulemeester */ public class WizardDaoImplTest extends BaseDaoTest { public WizardDaoImplTest() { super(Wizard::new, new WizardDaoImpl()); } @Test public void testFindByName() throws Exception { final WizardDaoImpl dao = getDao(); final List allWizards = dao.findAll(); for (final Wizard spell : allWizards) { final Wizard byName = dao.findByName(spell.getName()); assertNotNull(byName); assertEquals(spell.getId(), byName.getId()); assertEquals(spell.getName(), byName.getName()); } } } java-design-patterns-1.16.0/service-locator/000077500000000000000000000000001312550536300207315ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/README.md000066400000000000000000000031031312550536300222050ustar00rootroot00000000000000--- layout: pattern title: Service Locator folder: service-locator permalink: /patterns/service-locator/ pumlid: NSjB3iCm203HgxG7iDdtDeIWX0fZYqzo_MRTtUX9ynOZhPtBzNLchlW0EDxza3nhgs2dQScMdUO0qRenqU6B5xQTGmvh2pFPBM1WF07FSmbnqqcOqu6J_gsNZxvgw0y0 categories: Structural tags: - Java - Difficulty-Beginner - Performance --- ## Intent Encapsulate the processes involved in obtaining a service with a strong abstraction layer. ![alt text](./etc/service-locator.png "Service Locator") ## Applicability The service locator pattern is applicable whenever we want to locate/fetch various services using JNDI which, typically, is a redundant and expensive lookup. The service Locator pattern addresses this expensive lookup by making use of caching techniques ie. for the very first time a particular service is requested, the service Locator looks up in JNDI, fetched the relevant service and then finally caches this service object. Now, further lookups of the same service via Service Locator is done in its cache which improves the performance of application to great extent. ## Typical Use Case * when network hits are expensive and time consuming * lookups of services are done quite frequently * large number of services are being used ## Consequences * Violates Interface Segregation Principle (ISP) by providing pattern consumers with an access to a number of services that they don't potentially need. * Creates hidden dependencies that can break the clients at runtime. ## Credits * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/service-locator/etc/000077500000000000000000000000001312550536300215045ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/etc/service-locator.png000066400000000000000000000401771312550536300253240ustar00rootroot00000000000000PNG  IHDRz5P@FIDATx}m%E5&'&Ώ?&hAON\=r r :"pPfdPpУ{@W3@X!9cG5נܷꮪ~<ݫꭧߪzkX*پu :je[(`"[`%7⇭`dL`Ql r3"Bn@܌/!7#"At{}f=f!7m K㖛IHrӖ~$?[ql&z;e$l~<ӯ$0ʽ~Z7ジR֣ׄk2Rwdw.iv rK ‡$7y̚R7Jc%K]?F3eaw4+1 ,͇@Wrcr K7;gؘΏovRhv ?rKke78T)N׏Q'=+Rxv' ލs|XZ rFtiηEf c\*4e`ItgH=1 , c72TU8YR^̈Chk:0Iڟ (=MZFy3#XZ AnX_.7 i<Ɣ8! B*7`G܀~ !7_BnFD 藐r%fD܀~ !7_BnFD kw]&%#XYn<a+{~ Go(2ؼC;K +ܴYUڼ>{:}0)72wG~~x7?8q-ϒfIFF>>ܤh\L9?)VctkQ6g0rL&7O_>ӿx'񍗨\\-lN|jVs2ZTgmH3\ɍ;K3ћ\r+'wj¾2[_&;2y $N]-4&RUm6%?x>Zgh* f6~1j`E/h L(74gDgU{jaKn=|WEv`Ə~s߇J{plMYw 2TaߞTŚLm9j*vs}){!=0NNONzˍ, Iqsl`]_r#<83ꇿ~^Plo>C睹]ܐ!!ͬiJkrsQEM1t? љrB. 2__O%"ŠОsj|I'4e £?z7zd4z7Ǒ!W#'j**_]lM?C(=(3bzYeUeȫ^'7f4f$5 g  t*7w}֡]ͯ˩9>|=<|/ί:coˎ}Ʊgsl#7p5rӫhO2  dLRnh^ ߙ2Hxg]p䊏?;#~5j)7[s. f/ rӏh%`&ڛh~IiVМWseFc;\)g׹fw:s{M=xwbyNnq#Qeѐ 61:brci9z/\_&Ǽ=:eIMqX(Bv㒛npo\y\xWl=.Rj6grP8+y_g"76 [_5MN;B/kRQZ2ϥue7f+/sn譟D}3_bLr 茑 88BnFD 藐r%fD܀~ !7_BnFD 藐r%fD܀~Cneث;M%m3"MdtrK Nz7x)R =M9Cg/do'AU&"iBf٧G_=j\+d%֪s<~>Z&{<ӺU erKVRE,f$[ˮږ$Dz,b'SS+vگ%A,*_r;E<`S)IU392S.N"7H,ma"H- />GYWJ^Wb'ljsi!ۤ'ŕaߩ]" ,-K3(qXlʊ;L;j&sj\)%˃?T[L"bJdrKL ػɖO˧M˗u9cdr.Em5ܐE'_Br-4~ Vn,f @n1Kky>vg+w?w2ݘWߔ Ry)e%D5p|h^Zy:ۭ-L͚]p Sn-]i[vŤ1n4ӻЏa-Z~;k{{ -;j(冬MSX`GJĜri[Yʐ}21s$VU7pUtj%UVVq3 g|D#άu5p2=̹́8(;$Aalb2l:N ٰ*UM+XN&:M摨Fz6kr4alpi6ZxDfi'7+קN|MejSgJBSޒ_r)nVZn6VcdQ:eV,[ir՚%fGdvrg}'zbOgY;µ}indu#[+Y4⚥ny%r+m7{7wz7K+&Bͯy)6Ŀ1rS98n64XlٔNBdgte%SInlXɢ${(Ŵֵ^doyH@r)4HZW+ᛥ^s3kKRnRڸ=SJIeW&BR*r+1VJHNDJS{3%Ĥ ʥuՙ4󍹴v)r|2XYBnF&K`YBnTVoL 1r3\ar%fD܀~ "7[~ĉzAN"7Bh EvB͈88)N؃'԰%ɷ ߖڠj҇a߃Ht(r]g_ ؤr(H&V.,J2@7t VrSº3Ζ0a(6*.#7r쵆*oU!y#uZ;'F؍1JI@i-7\5s7+:Ĩn- Lf$WsgD/ZuIYr4.~e+1[8w>uFzvMRKk pls9 7vgV;&Gu0TaY)7W H.8.MSB:ӽL@Ȼi͏6‰&WȣR;'@Xm\ol v R\&H Sҍ}ڇei妕EUl],ؤr0[`0eⱿ(n FnȖg!R1CiU/Ԫ]V.P$E"7m,JFs7WM-ͯw8)b{2[몵|X ݻiͯJ&~mo9-h~KHwtP؍rto_X2 GoĆM+jk^l]G+Y1;i1UՀ S˝o$EՒ &=R-@< BofU8L5[T]04%p-d٤rXYn)pg=R^3#x*CɾH-+H#ܵʍ pm/F#7=>L>j|_B@@ ze=rC@Y@P,G@n(P# 7(   ze=rC4'X"eP, ]t tt)7Npi  zHb iMMy5e+TK^-ZhLu?'͞H[Rot5&erS\ MnŠ6I #,@ZZY稺;E&4߬vPS#6\Rur՜dr#ILݕ/E@n6?vi{OvMMQ8ʉA ڱpg GTT]>PrC;VH?Z}gJ:z!S\%;  I޹M\ml=3m$- +7 *@67alƩK (#,iU&4H&\ʬXqxKq؀fӅLɎ$zPLQC1ytaߝnłNn  ze=rC@Y@P,KݻԩSTn~񫏋 ;|p/_Bċ/x駗N)7b/~wiARnlAnsP'6 7=J'6 7=JG \#M rצpj)QAT/ۂE+$C'87gn/!7#"K͈r3"Bn@lO'ݧY`cFrӖ~8nYT K/ R#ܴ%, 7uZn6ҕ w7Ht}9zy_HL˽~Z7ジR֣ׄk2Rwdw.iv rK ‡$7y̚R7Jc%K]?F3eaw4+1 ,͇@Wrcr K7;gؘΏovRhv ?rKke78T)N׏Q'Q$O+Iw㜰4Q#.Gl|%=M5XRzrK؍UU%NlV3bFZߚ!L'+JeQ }C&V ) bCb1%~|eH8zd !7_BnFD 藐r%fD܀~ !7_BnFD 藐r7y''.w}ao?k]m{q͸>́G lbׯ-/)"姜]2}鯼W<F,7qYT[|ׯ]7c7?s{oy^n2MEYȘi"jOr#[SE>'x">4.@neByX{]?,~矽џ>"mO*~}7h%e|PSc6~1jDZk4٣T}Hlm^Dv\ʳt'fuRD6U^Oek.×q}}U?zf7}/ q =JY mW1Z8t'ӭɋȍ U4 7㶨,dD%Eơi19]K]ȍl&Ϣ3n~o{Aqwγwwg)(4R[*_RpY"RAHi΋ .# -7{ ,JIJ./auܯ:nn8z/ٷm|/Xd'mNB)/Y_s^r,XoWjmhQr#wqӹ~k|;_{S_ja咛) S^>/kiHv XE.6Ui,7 ѣXXn>+/ #mGr!e!@"y[ɚזyw"j8Q8ݟἙ_FOzw_ugo"Q[`MnFL 8RBnrr%fD܀~ !7_BnFD 藐r%fD܀~Cneث;M%m3"MdtrK Nz7x)R =ɍsC'Scv58̡wo'S?i H&3)fSE_=ݳ}3k\:$D`jUCbUGQYQedMTˮږ$^, bXnh$G(O(ؕVM+LYx{])IU3q2S.N"7H,ma"Hέ />GYR4YbUiwF\=fMzR\6%b4ɍ2']ʦ oSf2k_ɕR_4LV3sRl2ދ) ,- K31`&|}Z>m'O^yͯ+'{pe(jSTE»gi&Zz9&?b2J1T1˹+SҶZn~jWJ{ّMxv Xڐ-m9ij5e<|}vnjM'$cd =9TuM7+*駚R?.;mz%1,Ebi+  7`̄܌/!7#"K͈r3"Bn@܌/yٶ DXZ 9wzr%fD܀~l+7ɯ lw܀~فM],= ICTn(x7WNL=~iHVD"+aT /rzfrwLSkIJbxNeD ʍI[ZY86vg+w?wH_A0BrVu٩ xZCgrfʰ]:ɔ]HO6Lo*]Թ?mk{{ -;# ^A+pŕs`捇v;f7eLr`aGf[ϾCO?۟/6>&vJ/+fþhL4h 8H(7o_yЁ}Rlc^AO T:+.e~xc(Ôk&{.6LO "#a~3_/x3%`w75D4r3b#w6r3V#rmz01@/y7xA 0ȍBn@\FnQi(_Y?gKwRh;%Re;%qNsT\vn %_- ~ p2X5pܰ?)܌Õ0BnFD 藫|_7=y/Wsq&4~?` !7_v#7Įh"˞_cyȧvlXd㳳Δa]M(غhw8]cC^u'7Dcfaܰc_nk%cFS˩%dFŎ\fC;g4>ܴW D; ܲB9̤*m*܃H6MkV=FQaQf*}ji >6}%i)l"Z`ܴ ;"@:ƕa[*^ +M(JƧLЋw*Z QZ ܑj]B3(7,J`?vA)3v9a,fjs4>ܴӸ|CnHjY!~9d7GS%hz2%lkcJ-X }[46ȍ'fHrSwLd 7ӿ5rr3:Bn@܌/!7#"K͈Qn0DΉ? N:w^W1 xM2sj*1@|rӈÇ۷UTQ6,Vc_瞐zO}_(\4& C%mK_@Y眐zq:uCPuSQ% Wsk ֧嘟8Y>M@k]Ec;7:3՞ ̭Uj6Q4?6K} %4!ЦسlZ26M4?>T]`etFRNo/7Z`MpV,L)X,?ڸGwڌ֛3s.Ò In܄6^U4GV!^>MlP%prxAwhod5댤- W`ĸZM>ȍ>>7lMY pm|#1 _w` rGt0Bb5gʕkH@n 6~ 6~pmr9!7%x&rBn2 ޣLLohrMͯ^nV^bI&A%7~ ܤkBW:èEzJ^=ڄ0!@nڄ0Wr3zk'N1 _}MP#ݴܘ&4ͯVnBq6!h~:d7Sм|7{ȍc AG/Vn9)7pmDGዌ6a3#MD \`c6!r9&7pmB&rJn8!`48JnMiP} pm‡h~+-2&\ ESɖ[r+)> Ч'P,=V>}48Dn ]E-|ՌpMc=$w& 7[ݷ@n:+h#.OܘjF*ՈrMA6oP ~J{")G-Ӗ1cnt ^#  \h~ܴ}.{1^ #7̀U4?.p_3kG`Tn& Lbn>@f@./'Oܛ)" 6Ÿ7SL0nk3, 3D @ʸͰ  erfpRnbrfpSn \!r9c6C&rF)7pmm;mDQͫ'("| ǎS pm ȍgK*63Sȑ#b0k3h@n!͠ s /*B\rC{޽"t: 7A@<}_Bk 7رc/!\}v( 6qrO*B\8B\h iڵU6r;pmb&8tִ6 KX`Η\ #tEO*<ѝܜ:'2L> Bk^WOZa6it'7W Ґ,3K`};@nō(3,fJ'Gid msI4[-f]f%8.Z:՝?~J\1% 7a"]oS٬\sTmD"rjj$ۆKNRH͙ˮo~3z7&L$=?~mU'|ѮHۥ=U϶A6x*'iٙz_3pS U$o3Rnh*'ޛ`SLIV/dˣdgFBoR( |@noJ yb6/rnT)Hݰrv\%wBn"&HңL>(r%h6ԣ(jmV G p)rcȎE N|r*@ ִvj?5 I".&MsO~F\Yp`܄l ߯g̻sڭBkX BhmmM~r:fH 0|_b&4t:/8fH Pz4dػwodDM`&'Sx&z@n9眳k.]h2%2z\1r.^x8/b:h%\1r4jGx=pI]a2lH 5C[@/H0`{LWrA)7pm0*['NQ \r3sE=C/idr6B@ﺀŹ&7Ե#HlM2@n8wyp!Bnk#۷W=6 |k_Bn2Nx$2Y,#}-KBȍpm{185fsg}!KB͛&85۷nDQ-+~@n1I^#dȟh(bk@n$PրDIȍ@[r%!7"g\Nv/L-_e|%P1oq5cr-+7]]b7wDȍѵl]/0짭Z :c҈tc>ߑ8K-% cg 1S&A.HML!7MxXAaHyI&P"ЏTe#+ RkPHϪr4^X.+ڑ\K 1&xэܘ]'6&F1f)~]o{)b4v?&\w#uO&eOZ FSc^$;VL9Ő$(nMFeԂQ/21ܰ).ٻec7El&cjr:\(XMy<0Ts2věx"F?r]4va: j%v18]{3ōhg6P#7`τ8( q5 7Qr(bk@n$PրDIȍ@[r%!7"FPr#.{b"!7"F8r/P~-?(=~Q|QW}v%za@[# n_߸煣׌b[ušZӏ@ng}}O_ٛWqD,0 Dȍ9W?ӂ}مlxr~yrJ>5lq M;fl ;MŻfN) yAn!Ǯ8ዿsͥG3f#c)34rs?kCe")ZEirC8!/M@[#rC{O0__wyߔR$@*HTQ,)Eq.9QLIL r?PAnv7/}W//]oTlgr(MN)^FuXP&@)4./M@[#~֕vރfvbzpND!6`3N}&ȍ7oˎ~Ƨ߈=׮Joj\"rM}s6P%J} (bk 7Ǘ|37=Kyo_9Q>|+ǘ+?(bk"7\_9^b5e '7+7'k^5‘tԗnջy ̙Z@[#("PրDIȍ@[r%!7"&JBnEl M8( q5 7Qr(bk+7rQwsML;e8EBnܔ˙A:(B=fQ/6ZX7'N#A=$U6I+/{gӉ4W A[vkչtTz [&{<tuWJP֐冴/f?kلƬT۲ݷ$CE!bhc5q 3iT֪չĔ)r+%9* [r"w%)P֐q+s'm4Ei4sҢR)i4YbUiwF\=`*MzR\6;Kr(bkrP &oK|$($%Wb%Qܠ&:bːI^L@nEl ү}%qc՝\$U/ ]hnjj4)"q0eøòrCIGjֲbwM̎+#1Ҷa4:N'?+c7ّMx@[cujurQ|zBɇ_LNfLӤRui/ȍk !7"&JBnEl M8( q5 7Qr(bk@n$Pض DM(bk@n$PրDIȍ@[CQCM(bk@n$PրDIȍ@[r%!7"&JBnEl r. -۪՚-R2R%Pp$7jD GքcKbW,7Y1r(bkuvg+w?wt$놬W+(k(K_WKs+ Ty~GFʼhdZ:&EHRB .h^*q@ 7El \;/|h/Sn)VFVPJv+"ۋZυMZtfu@][1-07Z[p,-'(bkeLȍa[G᫏k8&qO>Mc(ȍaXM> &Q3T4NnX qz:&29_qtE&>͔*74/r1P0(|1r(bkyq5Œ> _d8%!7"&JBnEl M8( q5 7Qr(bk$7 1۰EAr(bk CnZMk El GVd [d ElU)d-9vdy|Oӓj( +C>F !7"j}i '$v{d5#&DS@fO2ɝV-""J}e۞ {$iSRMQrHEQ:-""*}OiO/#h~Vre2`rLN+sA" (bkU4?n>MtdgzUL ` 5j[D;N|He&kʠ-)VsѡkKEl}8xtLi?6@-!`}/ƽb" @[c bRBnElh1)!7"FDr!7"FLr8( q5 7Qr(bklvZ}[Vr#KҮIENDB`java-design-patterns-1.16.0/service-locator/etc/service-locator.ucls000066400000000000000000000116701312550536300255020ustar00rootroot00000000000000 java-design-patterns-1.16.0/service-locator/etc/service-locator.urm.puml000066400000000000000000000017561312550536300263170ustar00rootroot00000000000000@startuml package com.iluwatar.servicelocator { class App { + App() + main(args : String[]) {static} } class InitContext { - LOGGER : Logger {static} + InitContext() + lookup(serviceName : String) : Object } interface Service { + execute() {abstract} + getId() : int {abstract} + getName() : String {abstract} } class ServiceCache { - LOGGER : Logger {static} - serviceCache : Map + ServiceCache() + addService(newService : Service) + getService(serviceName : String) : Service } class ServiceImpl { - LOGGER : Logger {static} - id : int - serviceName : String + ServiceImpl(serviceName : String) + execute() + getId() : int + getName() : String } class ServiceLocator { - serviceCache : ServiceCache {static} - ServiceLocator() + getService(serviceJndiName : String) : Service {static} } } ServiceLocator --> "-serviceCache" ServiceCache ServiceImpl ..|> Service @endumljava-design-patterns-1.16.0/service-locator/pom.xml000066400000000000000000000033701312550536300222510ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 service-locator junit junit test java-design-patterns-1.16.0/service-locator/src/000077500000000000000000000000001312550536300215205ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/000077500000000000000000000000001312550536300224445ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/000077500000000000000000000000001312550536300233655ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/000077500000000000000000000000001312550536300241435ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300257735ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/000077500000000000000000000000001312550536300310175ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/App.java000066400000000000000000000041671312550536300324120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; /** * * The Service Locator pattern is a design pattern used in software development to encapsulate the * processes involved in obtaining a service with a strong abstraction layer. This pattern uses a * central registry known as the "service locator", which on request returns the information * necessary to perform a certain task. *

* In this example we use the Service locator pattern to lookup JNDI-services and cache them for * subsequent requests. *

* * @author saifasif * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Service service = ServiceLocator.getService("jndi/serviceA"); service.execute(); service = ServiceLocator.getService("jndi/serviceB"); service.execute(); service = ServiceLocator.getService("jndi/serviceA"); service.execute(); service = ServiceLocator.getService("jndi/serviceA"); service.execute(); } } InitContext.java000066400000000000000000000042131312550536300340530ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * For JNDI lookup of services from the web.xml. Will match name of the service name that is being * requested and return a newly created service object with the name * * @author saifasif */ public class InitContext { private static final Logger LOGGER = LoggerFactory.getLogger(InitContext.class); /** * Perform the lookup based on the service name. The returned object will need to be casted into a * {@link Service} * * @param serviceName a string * @return an {@link Object} */ public Object lookup(String serviceName) { if (serviceName.equals("jndi/serviceA")) { LOGGER.info("Looking up service A and creating new service for A"); return new ServiceImpl("jndi/serviceA"); } else if (serviceName.equals("jndi/serviceB")) { LOGGER.info("Looking up service B and creating new service for B"); return new ServiceImpl("jndi/serviceB"); } else { return null; } } } java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java000066400000000000000000000032121312550536300332600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; /** * This is going to be the parent service interface which we will use to create our services. All * services will have a

  • service name
  • unique id
  • execution work flow
    • * * @author saifasif * */ public interface Service { /* * The human readable name of the service */ String getName(); /* * Unique ID of the particular service */ int getId(); /* * The workflow method that defines what this service does */ void execute(); } ServiceCache.java000066400000000000000000000051751312550536300341370ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.HashMap; import java.util.Map; /** * The service cache implementation which will cache services that are being created. On first hit, * the cache will be empty and thus any service that is being requested, will be created fresh and * then placed into the cache map. On next hit, if same service name will be requested, it will be * returned from the cache * * @author saifasif */ public class ServiceCache { private static final Logger LOGGER = LoggerFactory.getLogger(ServiceCache.class); private final Map serviceCache; public ServiceCache() { serviceCache = new HashMap<>(); } /** * Get the service from the cache. null if no service is found matching the name * * @param serviceName a string * @return {@link Service} */ public Service getService(String serviceName) { Service cachedService = null; for (String serviceJndiName : serviceCache.keySet()) { if (serviceJndiName.equals(serviceName)) { cachedService = serviceCache.get(serviceJndiName); LOGGER.info("(cache call) Fetched service {}({}) from cache... !", cachedService.getName(), cachedService.getId()); } } return cachedService; } /** * Adds the service into the cache map * * @param newService a {@link Service} */ public void addService(Service newService) { serviceCache.put(newService.getName(), newService); } } ServiceImpl.java000066400000000000000000000042461312550536300340330ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * This is a single service implementation of a sample service. This is the actual service that will * process the request. The reference for this service is to be looked upon in the JNDI server that * can be set in the web.xml deployment descriptor * * @author saifasif */ public class ServiceImpl implements Service { private static final Logger LOGGER = LoggerFactory.getLogger(ServiceImpl.class); private final String serviceName; private final int id; /** * Constructor */ public ServiceImpl(String serviceName) { // set the service name this.serviceName = serviceName; // Generate a random id to this service object this.id = (int) Math.floor(Math.random() * 1000) + 1; } @Override public String getName() { return serviceName; } @Override public int getId() { return id; } @Override public void execute() { LOGGER.info("Service {} is now executing with id {}", getName(), getId()); } } ServiceLocator.java000066400000000000000000000045131312550536300345320ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/main/java/com/iluwatar/servicelocator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; /** * The service locator module. Will fetch service from cache, otherwise creates a fresh service and * update cache * * @author saifasif */ public final class ServiceLocator { private static ServiceCache serviceCache = new ServiceCache(); private ServiceLocator() { } /** * Fetch the service with the name param from the cache first, if no service is found, lookup the * service from the {@link InitContext} and then add the newly created service into the cache map * for future requests. * * @param serviceJndiName a string * @return {@link Service} */ public static Service getService(String serviceJndiName) { Service serviceObj = serviceCache.getService(serviceJndiName); if (serviceObj != null) { return serviceObj; } else { /* * If we are unable to retrive anything from cache, then lookup the service and add it in the * cache map */ InitContext ctx = new InitContext(); serviceObj = (Service) ctx.lookup(serviceJndiName); if (serviceObj != null) { // Only cache a service if it actually exists serviceCache.addService(serviceObj); } return serviceObj; } } } java-design-patterns-1.16.0/service-locator/src/test/000077500000000000000000000000001312550536300224775ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/test/java/000077500000000000000000000000001312550536300234205ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/test/java/com/000077500000000000000000000000001312550536300241765ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300260265ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/test/java/com/iluwatar/servicelocator/000077500000000000000000000000001312550536300310525ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java000066400000000000000000000025031312550536300332750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } ServiceLocatorTest.java000066400000000000000000000046271312550536300354330ustar00rootroot00000000000000java-design-patterns-1.16.0/service-locator/src/test/java/com/iluwatar/servicelocator/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.servicelocator; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertSame; import static org.junit.Assert.assertTrue; /** * Date: 12/29/15 - 19:07 PM * * @author Jeroen Meulemeester */ public class ServiceLocatorTest { /** * Verify if we just receive 'null' when requesting a non-existing service */ @Test public void testGetNonExistentService() { assertNull(ServiceLocator.getService("fantastic/unicorn/service")); assertNull(ServiceLocator.getService("another/fantastic/unicorn/service")); } /** * Verify if we get the same cached instance when requesting the same service twice */ @Test public void testServiceCache() { final String[] serviceNames = new String[]{ "jndi/serviceA", "jndi/serviceB" }; for (final String serviceName : serviceNames) { final Service service = ServiceLocator.getService(serviceName); assertNotNull(service); assertEquals(serviceName, service.getName()); assertTrue(service.getId() > 0); // The id is generated randomly, but the minimum value is '1' assertSame(service, ServiceLocator.getService(serviceName)); } } }java-design-patterns-1.16.0/singleton/000077500000000000000000000000001312550536300176325ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/README.md000066400000000000000000000035031312550536300211120ustar00rootroot00000000000000--- layout: pattern title: Singleton folder: singleton permalink: /patterns/singleton/ pumlid: HSV14SCm20J0Lk82BFxf1ikCh0n26ZZizfDVVhjRjwfvIhg-Bc35cyZvAQtZoYD3l4w364gTWxhcms2d3z-ydnAzsRuO4BUWmV43HRUcWcaagF-Lz55M3lq2 categories: Creational tags: - Java - Gang Of Four - Difficulty-Beginner --- ## Intent Ensure a class only has one instance, and provide a global point of access to it. ![alt text](./etc/singleton_1.png "Singleton") ## Applicability Use the Singleton pattern when * there must be exactly one instance of a class, and it must be accessible to clients from a well-known access point * when the sole instance should be extensible by subclassing, and clients should be able to use an extended instance without modifying their code ## Typical Use Case * the logging class * managing a connection to a database * file manager ## Real world examples * [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29) * [java.awt.Desktop#getDesktop()](http://docs.oracle.com/javase/8/docs/api/java/awt/Desktop.html#getDesktop--) * [java.lang.System#getSecurityManager()](http://docs.oracle.com/javase/8/docs/api/java/lang/System.html#getSecurityManager--) ## Consequences * Violates Single Responsibility Principle (SRP) by controlling their own creation and lifecycle. * Encourages using a global shared instance which prevents an object and resources used by this object from being deallocated. * Creates tightly coupled code that is difficult to test. * Makes it almost impossible to subclass a Singleton. ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) * [Effective Java (2nd Edition)](http://www.amazon.com/Effective-Java-Edition-Joshua-Bloch/dp/0321356683) java-design-patterns-1.16.0/singleton/etc/000077500000000000000000000000001312550536300204055ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/etc/singleton.png000066400000000000000000000534241312550536300231250ustar00rootroot00000000000000PNG  IHDRșrVIDATxo%W}}!:G;!$1: l4\Mu"hƴ ͓=3{1ncozl0! HӀyl|Klȴ2 HnխsS֭:U諙us:{O.ԦY\t1,URcS@e) b:V.m PM h!R56Tv4X:(zuY޶M9yD BUA/jX:(zuY޶M9yD BUA/jX:(zuY޶M9yD BUA/jX:(zuY޶M9yD BUA/jX:(zuY޶fw[f`k$olDHޱʍU:WYCRD5@m*6hU=oqm{u6}J1|ln"b/.RH֎mq=\=52 ƮmsVT"4Z=譩RۛlTVGlE M/z*&o[ ѦW^TC\hl ֤ >%K9FڍuJFw.xE%uHt[k·ÃG0a<7{RLU ا:[45R띶WƖFlEԬۡY((ZZim Pu4`VHmNލ;>J,qWucWڴel$ݘ`pW@T(_mP)kӤӪc#/m^į_ww u%(J)j*c">rj6^9ۑM޶PMc1wʙ~I=wUîp"OGT](MM)8n\ssu;U^O*ElihfuAZ%.ڼr2Q UnyRHBZ-ZH/o[ hl/qr\^عSsO$m.VQF-_\UoÝ ^Qr|mCȻiy=M#0cQz:HsD̦A>rjjvh\Ekm P~Mc׊5gz488EָO&^[2JF/Q6ܹ}WKVlmRYl6Φ24b-.R\fֶր`yTOzJ+UzPF‡9K'nfTt' w.xӊJQ5U6;\Gf_-_5\r띮9+xP[)4赶Km*v&OJI7Z!Pۃ)qaAo'MM"+~{)olDHNzT)#5cd>PicjӜ[kіsIOjQkW#"̪ۡYh ,o[ ަAep'R zQD"AkElp'R zQD"AkElp'R zQD"AkElp'R zQD"AkElp'R zQD"AkElp'R zQD"AkElp'R zQD"AkE:m翹|Y{Guhh #B(WmGs'?k`KgͮFG,W%S{4Ym P4'z$h~=)x}#vyϭAPhE{wӲmee7}?v >@[U|:P܃O/^=}yv5b&A-3ǝ@3-mlUׄ.BNvv S)B)XE?exGԡNHv]+hU 0cW,(% RRt~Ƽ=Co KWgv7Ӊ9 6eP, Ua4m%t< l zsٟ~'R|kv>h_޳b3ri?/h݊؂W%lI~^ζۙoLyk38T#&A<-eVMw̧@UŷӛBFSUx lQ-_kCaML76^=_[ nn7>dg bO죩cq'xWzkꌻ/:.3Q*|Q'Dŋb7<0[>{NZIHsi4]Fu@n?TڙBʚ1kf.{<3_޳#W{lhOxM}qEV*پ5N26¶fpr>AH,/xt1c*тMuvEYv!q˙B:n^Om&+[Oj(fn~i;32]w}z|m*G?rsckͫ@Woo#ZJICE< &P(̛BfI<|<.`*\q@w^۵yG %^gnz25E6b_jR1N^&#]b:a:ƻj}V2eQ iM,a٘7'^ΟWo}w])S 'A"u+b ^ߚz5q Cjv1PMVL\;3Bc+Lۦ !ֵ'rW*C^4#=^F7I aI'Mո͔Tcm P̦w'zٓA|7>~S+ys0ADQ(DSgd[:&}n[<8 E⸴eۼ #p|cM#l\RecrQQx`KHk:7-u~ːE*\y%,p>3[^)rgW>3_;ve6:62֭-xU2kSO?.l5Y.mci4+\C:?Q+͂ONo44΍C^4gtOY :&Y-yrZ k--l*=O~囆~A~xf㡯;ްteA\^Upc/T'wG[o[Zl G ؔm7=Iq(F`so~<"jDvU4*-Avp8\.;CP-((åɥjl#prmҷ΢}݆3:IOli CKH; SN4-C^Ūpb^yN7i 2i4\ZJ t K|SF>_ݼfU` "7]C!TiNyYۙBFPqZztӓPIOnoiA׬]q-)&k*&/?;=;|}O?~=o U֬ҊH#Rm=siZ|ֶVmӆV1&͙-5.RXJY-c{k܊W09P!l(Npi泄 *v^ i n09dg]Lsi&ܓamSM#T ܤgi|ݾac4gKFmCVp8Q5?۹ *v^ ikԼ>3 ^[do*/Y:M|UkFbo7ZTOHCJx V[0݉2v+͂'Ni 7JHCtNN5Zy!//^4e6U.%MT@m6~8wu違_8av|4ZUB6KCzYe"UM\/7/)a/{p '"8TR̜TI3pG=jP=jjl *&T46=b!r*^WNTG޶PM#Ԝq%LO8ײT]FY/P7qWnX$>$YdJ|luMMrќ4C. n_G G-PM+;QZXVDS@SPm* F3}+ Ans_ 'Fc4f8dˆRHRqawţVsigwg~G罭G-PԦ6֦6Gl#Djc_ZMMAl'VRʮl*(3UHBII}n-tREw' ;5@mRXժkN44<&rF?S'bw0f4mWU"Tzݽ_yoQ A/QXVDS@SPm*i2ܣ8mu H6\ISQrH'еޣI0]lzԤzzKmjamju6BTV+E?T'o[ IOj5SV΍Z&#dpmq>wuf'&W lJsҰi%QcQ A/mQVWNm Pe4Hp'F֣AoD"j赢f`>lrY/yD Հz1SXSVh .o[ 霼 w"*Š5KD,BV,o[ 霼 w"*Š5KD,BV,o[ 霼 w"*Š5KD,BV,o[ 霼 w"*Š5KD,BV,o[ H|a=]cY ƦS@tz]M9|u%@TMM!"^+B]-@`tNކ;PbЋ%"^+B]-@`tNކ;PbЋ%"^+B]-@`tNކο*P"%}wo] B9ɧA/˧EUZBXBsxSOcEV0f?];PhKeG1b ԅV ftN=_]I%ӑ[L0r"DP)bB9VPlpWGnA7Ap6v7Qλ~7f4h6G- pɧAo.ǼRH57!J5 98 ?2ZM_ Zli6XB%Vyl"*Rszm P4ᮎA\%C-345WFg\iЛ_ٳd4)٪ >1 e(ŊK͈OH"ʗ-@LgnٸUy3ڿ?THކ>m*~(Ƹ$MPHln˧Aog>q1?LHΪb nE9 YfM3ABL5jBSi򎨡|E*$o]}ODA/?o~HJC)`P_-#̏m3Mo I.4HU(.{6ƳF4N> z汣ʞa_ ^EM"vP*% ju.+-[ `- mrkظk[) `r4%Ϧ[o?ׄzFAB\5jBSiD w{~~w[odv~fG泙nd1MOz4ʼͦ{mTgG[_0RwhT>64eOzQ͂R{]ˮ|/7|sϜfAؠk aͦ9ƠwD77ߨT "„:QӇnxvK;3P ꐗJ9EjYBψ iϞ!ڱ7fE-B|ӦfIwӤ+aT1M&H|Cj4mBi0Pv3f!!d4sϥKk7 ^͢b4caBe}.`ӴNɭsz(L6TFkٖͭ3b;H9,:vcě?[V&R`0AsT=z&Z;,6+6F]%D,3_F44Φ:/~:%΋1-n,$o;cӼ.=1Qc6bal%ܣzRIMKyS6)e5BSA/B&HEcnv{*-UswAInx;K/xIi&Zf&޴fA|rE-ﳋ1u\?':2J>PU4i 4jFbO$G3D cBqi,gpi^}L#_h4^oI/0a&;FIf|B&/w.V¥P**?gw"tcp=3cXE;w|mI"YVN'ˤij;{Z=i=6GMnہxIo7/z/yڮfA7|'9f٥3OR 9KV+6IG~J- -@h6d]aB#' d]zr=8˜}MǬԸI'雂r+"٪צcZzJ#` N,w~emsK96̳i歚&L?  freG*QI'.1a/Q-E /uo %ȺQcifVKP7XSe4)Y4M:ArB%[$[L(d1IKrdWaIDfL^]"{s]!4o fA/BDlSUkOMBZQ3ezX-@ -@t[{[bR<-4r'^Ϥ q ?f^,uPZJi91™3=Jgb&-L_4(9.Y3?Tp4'"4fE׊PUM[X (ȗlȵxb Hƚ):~d]sB^ JATգ,ũ9+KF z56,"7i:FD~/OPXvu[?/'h23_fWy\8j굪UO˵O ]SaUBߩ{rô:M[ ҦI(Z*4g-@4>:Zb{,on&pgP7TW @?}C^'BF*-i4Mvp+L.Q Ɨʞ]BƠjJv-cJ 9P~m+'~'?AFe4 :,L5_JnMg PN6͑?w}~WǾp";"?-l_R,䖊x({0e&ç3*ݥ;H&G>X%SvZTl)Ls W㭫 ktJ*"䛩oIOwsss}}=x /uѣ5>X,My;RsG qӥ~_/}DjXo0L/)sdhzrk]N) ӵWcu޹j^;ol:ZFD~/OP_I\ꥨa_ۮZ'$=X]Ҷ0jatʑ0iݏ:e.MjͲg}+_ۿB.ӧkh:,Y{W0JZJYbiOiMLn[so>vhH P6͇Y…c=lwKݾ _V6poh)TeF$/Bm/pنF?.d-^HMפ^Gķ lӁ͞]__܌^_|ԩSA3gTD`4z.kSJ;K {˯9 3]Ş_z&_TkՔ_Znm\PSal TٵHֈk\5wi:Fl.OPljm(F߶A߮F&tt4J1}cj3~Ԧfp45UzС`j,tYHvwmq3;I9y͂&;A+RL}АmywNܽ 6JIaFP%͍"D/ceWʿs$b[f`E(]:Ko٘V4h.5W{ -Ν[YYY\\(c+Ǧ1YoIj|\TPS|M7=,? S©qTٍu!t!Ƶ.MGԈI[cԎ 2 cvOuTf8Ϲ߂^| Ц9Q#i oo/貞:u*‍^+BBn<;k7Ǧw$s3dZ)t;zT@MϯKpogQG^lBK)L267^OO AxxYO(khәT`p`Oγ!#_ZZRCLNc1jl !S3ML594*oN)&s o%oӸT<Ʊv4i]ۭ˓ǥC7`$W=@p>j]s.Miͬѣ JZ)4 nl[coM,73+4iT@Msػ>ǃo:l4ZWPԅ~Ϥ*Z~qmJ`XM0Je7=˧_'/xD̄1.xD`6̙ɞ?.!]XN~*_Si14Nܸ6MSyjjvsaԌd6} Ji3N*qMc hdsssee% zi,軦fӨK(U@`{"/#hHء-@8-!|O}Eϖ2OoNS c{KؒS4 /<[:O~pakpҒ\@ch,s~:&Xz7ޞk-V{ץFJ4ަqLƵ.MGԈIM.;!Uq `;'m: e rA̻55sgΜ z/_+i,tY7v<1ͮIAr_RMfCZ p} /7F a45G噏ǯKΖuP.W fOYy^[~ gӾk7JxғZnmu/hM_ٕIp&w' l j476QS#v6d uxv6C7p+FEo;j%z+cP NziqVOZUSY^^+ih:,H5BƎӓw7(&6=BΒtc[ piٽC[MS|)Fq\}U_AGT%h[tԊmv+Mut,Z=*Im P%4|'rGPSxwuꐷNƚoK :V z=UM|3g55b[6L:Z989ȩ$6 ` Ղ[0lZ``iA}X^^ޞk.B8z|O vqfJY6o>9g8<(+:4vIaR8E+AMhWlLX/qA>4Lo8d!${Vl<%Ԟ$5!Y矊`q ]$Ms]}o<TjP_"Pc̽"#'l+,IWTck ժ\H1WyhF|eQ}2r{_# (Þdli)'_wD{?nZ $0ƺ\EJRw u!bOj+++,A@C(R82i/^puE?rrmizͦ."cMYYkC8-<&F_٦li=dsj!LQm.6aX_}P 6Jen|銴r뚽"O9(I݁TZ h1gΜY\\\^^ٙw^A 0#-th4_.~B 05-<r彽˦y/]zc-[M Ha}lv<Br;43d 9d!.!<4ϧ4ElPЦ tO}Egvh_(LȆצ$uR"f$`6'`> -I%>/忨J94Ѩ);ʚl//;ʎ'/}N%=輴83_B%Iɏ7Y^[pF OzRStQv;IO5W@ b>H`4>49i5/IWN@ :gΜ)7e(D ;wnii,+Y>Y๝֦[iE;r:פA.\rXJhi!u zeSq Ή+DI MFSj4-6 M_04_~>WIVBgi0~mi9!aM⌤hƐ14z%$&d3O=xaxtMOgO?m%:{dz+[;̦ɬ;S&cʣ(2k,ΛMSd 4Bi:#l`i}+"'^A.]h|OѵiTCZE\&]ذ6MQqEc-tc\F+6MrBPM!t6M3@wFrYLْ֚hIOQjUՔ >)M3/{S8=I[liIOzji}zmmm޹,//ooo;lpy|t…ŹfUM0 kLh4sa}=o29~fwwyggСCS#q%/zh-&Nc4Ȥ!gm_r,N,..^pm_h4PM˚&?e#U243PM1 9!"[dFW^qL$*]0pn{{{yyyr`@ud ɦ tKhcp[-YI wڦ+6GGCPwvb4nӌo*grM7H% ]IU4c* @[ȳiBCCsQhaYl'"#,,.vmfw\#S6 /4 l?"4W,kH0OƒEM3l94S#6M:9v#zX }2!y? r==8pҥiJރMdD% -w,'#e#2M8Dώ4Ѧ=#Bd|tG,2yMk\t+GKIs+5;lM)1MT._x9;رc'O,7M lpb ^t{{{% MP>hii777KL<|Ν;J4|N>VVjL4sԩGT`]!$]JR94SMTNMP>kkkO=t l)Ŧ9tPfMP>~ܹs3&x…R|F,)loo///Th43Dtl9pŋ8Si 6 p"4 ^ c 4/`#lZ`0M㏰ij6?¦c U44c[s0_hM3Z nSMn0_(ɦ#ݓAOMpFƮvl` |affl"ge螌'7+IJdQc(Q(v*%#vlF` |azfbRhqqO>cs$x-L vUQQlӔ[FI"ڍR4 ”6関[;LhK?Sܦ&-ohJq;6 0_o6dA=W4.7=f7B֌vi1*֦:&d_y*hpp8>\d?%ޒQ#ndmV` |'=fȂ|@0zE|'w<4N0>;xjdFv/d)},pKpyN1$MP *iij6?¦c 4/`#lZ`0M㏰ij6?¦c 4/4s睟o=._M`KFMP mO=.o?{,RG[ ᮰qw?޸:%ln4̣4` |Ŧ9#r?uO|~mea0_ȵi>go|?'w?a`4 c 6}j'{z|'{b˻'/x=O^ FZ#~=Zw<k ݠna?1k8;/4mtMg^D_[}dcB){ΈjduJAq[JyReǦ c <G?rs4_{o^uo ^\}-zզfĆ~NOTOAWdhFrf#˃M rm6ow'zٓ|7>~S+ysEMc(I$d٤3V~G~ bnL3ːMy˵<4` |!צyϓAxk5woakl62{M#Mc*6 w0_ȵiΫo;nN>}t[w <"7=R(bozRfȻ ;6 0_ȵiïz?~˯cB624KNv~ a9"6|6;/4S;ao-o{uEhla_N@nk l2\l`0hw?c.=u*]Y ¦c 6M¦`0M㏰ij6MMP i6 @-0_G4` |a1lMP i6 @-0_Mя(7يdRa1fxhӔ/6 @3a04[^nfKAlhk?^k `l oN6Nwf}7_OJ1ȉ>N-,ddN\*sc M#8&K2KD`k?qIt'`E"0[ĸI?lL^(E}d0Liciw\4'͐ 6 @0_lm; x"l]afnfb6M4$I:cCLV-X*]Q(ً$eFzWla0i2<$C!Nʶi&FddČ{z:#Pf.7lӈjO6 0_b6Mh ddNV$bW'.Yfh f4c Ƶib+6ʹ6OMVK+(yފji\צ$.6 W0_IO:&raBSfc,[$u1'.{,?}Wi(&=%͉JK6 0_Pl~Uy¦c 4ESc2eiZ1lMP i6 @-0_G4` |a1p"4 =fxi6?¦c 4/`#lZ`0Mc671/`#lZ`0M㏰ijBfu5njO4` |ݦY;"f'6 @-0_(jhijL6F:wSrw]3I iZ 1nzjMl zap:y?Hng7~0⻣$Uf25t-M/lkG<$*آLWQI]BÃy(M9JI+wٲ'2mȄw)ODW(M0_4GwD4ߨ4-i53"41vI[fN_I-!5{i1Ms~v#7-ElM3Qr>bN2bw2YGƚ 6 @+a0`i^߻Kkkn>"6|o4,8);lV` |fӼ.=1QWF4b4fJ6:IĞLkӸe4ͦy/ri QR -KG?)~?=IMƗIOŦ>3T 6 @;`0Mc \3̽4` |ƮɄݍ`1l6 @-0_G4` |a1p"4^M4^g3cIENDB`java-design-patterns-1.16.0/singleton/etc/singleton.ucls000066400000000000000000000144371312550536300233100ustar00rootroot00000000000000 java-design-patterns-1.16.0/singleton/etc/singleton.urm.puml000066400000000000000000000025771312550536300241230ustar00rootroot00000000000000@startuml package com.iluwatar.singleton { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } enum EnumIvoryTower { + INSTANCE {static} + toString() : String + valueOf(name : String) : EnumIvoryTower {static} + values() : EnumIvoryTower[] {static} } class InitializingOnDemandHolderIdiom { - InitializingOnDemandHolderIdiom() + getInstance() : InitializingOnDemandHolderIdiom {static} } -class HelperHolder { - INSTANCE : InitializingOnDemandHolderIdiom {static} - HelperHolder() } class IvoryTower { - INSTANCE : IvoryTower {static} - IvoryTower() + getInstance() : IvoryTower {static} } class ThreadSafeDoubleCheckLocking { - instance : ThreadSafeDoubleCheckLocking {static} - ThreadSafeDoubleCheckLocking() + getInstance() : ThreadSafeDoubleCheckLocking {static} } class ThreadSafeLazyLoadedIvoryTower { - instance : ThreadSafeLazyLoadedIvoryTower {static} - ThreadSafeLazyLoadedIvoryTower() + getInstance() : ThreadSafeLazyLoadedIvoryTower {static} } } IvoryTower --> "-INSTANCE" IvoryTower ThreadSafeDoubleCheckLocking --> "-instance" ThreadSafeDoubleCheckLocking ThreadSafeLazyLoadedIvoryTower --> "-instance" ThreadSafeLazyLoadedIvoryTower HelperHolder ..+ InitializingOnDemandHolderIdiom HelperHolder --> "-INSTANCE" InitializingOnDemandHolderIdiom @endumljava-design-patterns-1.16.0/singleton/etc/singleton_1.png000066400000000000000000000400411312550536300233340ustar00rootroot00000000000000PNG  IHDRh(^?IDATx]XEFD@%jRTBRlD`-HQQ (,AKc~FQĈ 77N3;;;}%! %t‡1JBiM_RpJQ"X$DbH$jLby{oQMp5G"㳤 9-7GAggZ[7|$ ? o۶ر8ՙ%.Cvswn=a̘ס8wf5% h^-Z4qz5EE?¤fmۚ3q ټy+ (ȋ졫T..;%E ف=k6mZ?227FDp f7)I8*41J4Wҥ$9.S# ׀qqS{Je)8۷ԘmpZشimN kҹ|yb#FxtpR85DIQe~DP7乹zz:OŢvm],@xqh1m'Cqxqऒ$IŎ͚/[u~~LFN8L>ܼI(ܪU3V)11ø[7'o1~QGGecDF8x- jdTkоP Cq 8TICf5"  uZ͛;eȼu+j*--M1%VVT_?ׁ7l)>-Uvp96 ^ (wȇ3Y15ho&QSpT̄tdiڵa-Z4A%czrH= LFFX(qŊ && ΜIHGɚ5Hd<^ qqS]]aLO!9h6/w8L$ EL春`!w/ή܁suukp??7_N,ɓ4oHOO|ϞpkӸR$D !DNnuމP{C# ϟJU1X$ H$jL"1I8D$ 92$n\?CyFl_ a)H^>U",]ڝc(r(yYWK߭y/FUʠ+UK$!.cl9p%Ճ?&|{$gYӑ7=e[W;o߾8P~lʕ\\VZMݻFa]*FWf5+_}Ki)ժU)~T}/OpKGk|2yߥ 칸{jjn͂!f7)ڗm޾]"pd7mZF ŋG.?dʕW诿RTX3XX~#t^X¡^*$׌ jf*;۷hmH_Ͻ6\bdZp]Vǖ-,,Lj燁-yim<$wP޽;jѢɼy#9ĉx?? 4t,=:b~˖}R%>LO_ּandΜQʕqDN@@w$Y*.\Q:Xᔝ=VU\"'p ssaTHFPq/)3ާOg8l`W0; ҸW&$(pG;v3 KЍcGlQJz лolCD4 ;m[soo ws%uv5_Nc{z3˸ٰa]Ta>ō ㅩI;WfMN8pW6FVfCACc:h'kr"YV7nSЅ#H *"+}7*f(b)k\w l[A޾,҆ 3Rvrz ǿJ }o<j3z aN7HOfuWS86,]:]X'O-DյD# ]S^>9ǦM.HAz-+0wHƬG5s 6/^|  ocT lPi1mff%}wpV-L0uvm+61gbsg;Vq* ab?؄|''[Ս7S]e lIDÐeDw3BkFOI8=&̇]|{~MrzPh?=%QVr|l蛬bpA駭Ə6nl[$ҰW 3tǼF㏳Ϊch),Q} nń+&'*#Pf\jr s*nb?T-))g$R'\Kܚ^"e'36Gb0ՍnW@ٽ8|.==;p٩SSq"(p|asڐO`jJ [yސ!+4KMn۶Ç℃##C'9+W~<Ӽy#,v<<> 2^" i]Yu,[KQzX1k";2kr¡1* ٱo33Wp屜f3^2p(?x'}T{\"e'p bW WE#[Pv/0.>;0$4/>GVq"(*f &e֥r6[g_pU|=0'sp?~o&=/FŁ1Hsa;}HתCiI׺ʬ ƨ,cZkB& ֮feeҖWf?6NۦM Vq*rI#롨h\w%uaz,-MრmHsbH8Ǭom/?rZڜ;^*!&lzcwi}/!mkkn*XMfewiOجY3n vǟ9̚p(k 7;trtYe//'-7Ϭ0fif׷+WNE}:geDcoZ5 men߾hΜL8GEHXcps/8J˖Mϟ(Iy^z~={:iӂ464nl~ ]۶-@c͛dd,-S&*# Q]M6/&L^(tԨؼ]KgT,CbbDӻ٥ w@8aaCQ(>>.'No2O"ji&q(ڸ1 ~*I8r„66ukKooy6$W$Yӧ7x{;sUx#?? =LyFF@MڣGA>DbdN;0Ɉ=A$~@!cDxx\ e͠ /^x)xcJ$vUKTIKGGwe˦%~i֜YffظN:z|bqL_~鍒,Ж_߆d]%hMd/ٴi}Vȹ;K[%Ҁ'O?G٥q.KƍXرR/ڻwDoDzXŋIH8Iٞ- ?qcDt;X1qfuYDQ9_}p ֵgДO3QL_˃X&5kVHn 3޾"xi_dpZ[7g%۰ZȔѣW\iɒ1,8{p#$?7M!@Sxm,Pdy0~d/&p,>Q<ޞ׀:tx#=.\{rXQJgވ9?3`ܼ Kcaۅ{1mZ n 9޺laMGGVIኳZa#7?+$oC]!깒uW c^kcg3-# bOټ%%28a9Æ4od{D\x{ HCRR"f.xfgraaC"M4v\$)'-ᨬp8H[. $--MGte cYl`ٳ M`Yܬ*b('g7[=(p3dŘ0oH=/ԯopY@02kV[-)O352z9;e=hG"}læ{#r50%-/怣G >K''N077רʌ3^|Rj=u]U5AFFDJj$p W5;th5r0Zؘa*ƍ-˖} O>07B`}ժUH11iUf APx89h׮ [ɹ?m浆QۤI=4,5=Yf++)u, ;ޞ#5N…DY)ruqiه CH;w/kq,uױcRc(n\&r0ez'&4ITp2s;aHdyhԆ:T}ͱ7n =<<8wѣ mmmϞ=̂@}}MFFF"O>8[XXԬYm۶ǎSfؿȑ#deeLi,De<}zèQ11`܆moLjTȯ\rxx8ݻ#sӦMNNN999.\U˗sssqw^xqԩG+3u֍=zDGG߿P, `$%F+E|rlBvv,Ǥ$'h`v,@VHNN655MKK{!Dfo9?X[[+3y֭[̛7o>}:&&>O "Q/Ç&=%=~x˖-(,, 322š"44 GQQQAL#xDDD 6LӦM@n" qR\vMV88Ϟ={aAAAzz:\x p[ZZo(jee;v2oܸ͍k۷!C$D,REqŹB,0=<< ־wޒ%KzMiѢ2#{5.\4ܖ3gBN:,sp{CA$"`i| IƍvdzzzVZ5++~ܹsuuuyXnNND =tпr~`&"`9<}%=~X6^YW8B(&m)o&2VWXʌ=47U, ?EJɚa2G#<<\ɟ: 4XAӥ n87{kzV,q~⛕5ci7p\v-11q۷3gF3Px`8ښ5jd5յOZoބmMv;ѣٳoUɨ2!rf_`xH_&:qB]p2ߌ⛽_|39q,Xޏ@,((({xO08-U+?խyBbvoF޸OXky6p?U\)<|8n6mda-\E̫Qx0Z,@G6I<NMphQ|f v?3P8(`˖}\L8x>).U0fsJς`/^`*F57n1o?E({7S?а͛7CD' %fiL8x> (uVaaCj *F54lXv6ISL Q|3C"}5u!!!ׯ_SѣW^ $d""r1+%<&=}1AԹQx,_>sMoHE6ISLpP|3+F9ɓ'}'OΟ?s} r>J&9ƽ{cvdDŽ7Ҙ9Y@k;Gppyf5Y\-Xp*kShlo&fߌW8$wzϰ,zX0 u耠 /· Z9Z :Fp^= v3XŬUQxHkc4uY&) ?m{,odLp0,YX6HC`Wٳarx>= 孨f`.&rؤ ?E(yE!555**꿃\d~>RݬWP'f%NuD$CWW  2"g A$)5̎;z{{?zHE>}̟?&H82ccgϾzjܸqʟ8qH';wv҅\zU___YФ"QT_8bcc r"+0Q wKp̛7/d9EEETC *2"##Dp0Xz˫^Z$BYkٳgرAͰg9gϞeU@/_ܰaC۶m[lj* `ŋzٳ )So\  0]N W Zo&%%6jԨsˬ_~zzl@(z1c  p2;7/ [dÖ-[n*AɎM4Yhܿ,H8ɓ %44ʕ+qA}vXXXݺu{ꕙYI81ٳg/_,$B]<<<ի7k֬AA T _~e5{JB;@A 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcpAA 4 @$AcV8*U"\﯊vn/(Qv.AHH8DL! 1I8h;b {oCCpʳpuj=x 7Gd߾]V[}+LMy Mf;9p!V-˗(0;>b7N'SSIQA (3زe&Kǿ~}Hup`>~DP7乹zz:OŢvm],@xqh1S-Cqxqऒ$mR%=}mf˖}"SN8L>ܼI(ܪU3V)11ø[7'o1~QGGecpZ(,<6Ȩ6&}9(p"b$8mуcvn]CVfNY~2oJZJAAv|tKKS|q)u@ fJ'x1z]1\ aᄃ A30hLV9|x SϛIQ ӧ7 9̵kZh%K$z>>.,DF0`QQLL9Fɚ5Hd<^ qqS]]aLO!9h6/w8L v@9|9fixXo=Kkiccw``]ܢ׷K(q!͛77g+pZg54nlAsh$r(ro@VuW94~TsI8h; $CpH8DL! 1I8h;C$퀲_7Ҁywi>DI!(cؾzØ)S$'Jz jc^>Ď"G?hpv@Y .cl9p%Ճ?&|{$gYBêURӑ78=%B!(3z7)]ʐkÞ,e#wf7)ڗm޾]1_"$2kƏXwd5;nv~osې{mņɬp imݜʕ7mFEJ_sGײ edTcGl9{. fbb6w8kOmڴ`//XLNAΝݻA-̛7}Zŝ !(3p]wx=zq_2n;bC8 6e!=q ֬R%-(lVU]99YvʕWhH_l~@fUfpFjPfv oi{VHxB6D:""2Ѷ9[6kfܹ* mp`%f{7?f=sOfu0s'+ ǃ01ilBD:#}Vlbbfv22>yTU3i8?;8XGC}V =i`4 CPbixF鋑pum'EWFݺ_ko"APG^S7roD:7v~M5Ç#vm2SR"f!|$ҕ61J1;:1rΟ|_ӱk :1u76H8V[[E!zL809mH'8d!kC|W|ip. ʀ~ild`j⣏rs; ⦲%އOEPa\"}#FF怄tM:pr'Vp퀲VlsUߤ̺tOw-ڳ/v8*VQz 23dmڴ]=լLať\Cqpݺiج^#KKS hҜcϕӠVl !(8f}k3}IݵHar%;?{@B0e zmY4`6D/{t_Nʕ)*K~*Uzc*8G"u@Sg|04ԃNM4xAiU$h;,itwߕ/v8>Fj Ǚ3 16#LL ښ5'VMbC!JCPf}{Kt/}cLntH8* De,隥OLH(. sV ֭w'l/q㼄R@}ʒCp^8ʞ{.CرDI8h;"GF /\*xcʒ$CP’CpH8DL! 1I8h;C$ GR܉%$̜:5ཌྷ<~g{Cp*/_|,qd?Ppv@ׯø=ujBCvЧO第(p@wmU&a)#9y~T(G*nn=Giٲ%җGKϵgO6mZDцƍ֯!k۶hy h$CP>#.na=x1)&fEF;ZJc/#L\؃ T{;,l(*8qĉ-[a+?YZy6n_(rv@ n0>֭Q,ݾ H eNZ8p7a9 q10tn:rΜI:[׮lY bOe¡hԩiQ[[ׯ4fุ~Mz`q>ahfٳ UC$ m_=(S館p`IJh`߾]VrjκunLssw]GR̙_l߾hӦ;ڰ*owڗ^;Щ Bb!0D r,mIHy_((E wΝQv>hpv*pu|t,#W Gnn'{1׮%K88X2/oQ{p͚Yf~~07z n+vn׀{VЩKC/8̼ ʳ?C=.T) >"# mgEioفW8:"11"9y>cg=#* `,Lx+WNXF֦pځB!ih޼QJJdoM F4h`֭4fgraaC$h;@pm.Rx^Oz'Q&m/==Y*i=~]#m 5 5!p<؅Æ`YuL"{\,ykn)rQBJ8,>=n@݀@飖mpifFFX/?9v,3 ϚԺAV8^8P!> Q(z hbO=fZ[7RHdmѵ#'N077רʌ3^|=*p4i}wBY"GpHK_NܮQ::Mh|ypX_(uܷ*v$F/\HHrY'@k͛ښ:Z..m9ٵkBG8 wQׯqϟDZD )VŰ٭! oG2TYXƍ\Z||?8Ν=zٳgYPPߴiHx 5kmرcʌwpp0669r$,XFERF 2>tQg67n"h{f#X̥ F~ʕw6mrrrɹpBZ._ݽ{ŋSN=z(((][n\\#::bǏ/\0p01nA~lBvv >KڵkLZB"994--J^^<~Z`mm͛[n2o޼y阘{{<) Fp[ycp?>~CT+++eF/_ޱcGyƍ0nnn\{n߾ *;\Xp?<8\]]!djkk߻woɒ%z&vhBF.\@n̙3GzzzNBNBB98DnAJ޼UDBZ[ATPƍwɓ'ZjVV s6133Cݜ Amkk{Сb$jM?6*XzoG9O>e @aa:FA?́DD4 ~lF v@-UfAAա>f Tjw}فl-M*_z}Qb>fĥVGf9G;6͊$$|8ښ5jd5;OZoJnM6ϝ߿ `rdTD-,Lj֬޶cqkܿq#}(6 T uYh1p$%%xyyegg vUTTDФ ?>Hl6\n] ۵055F-\ZoJN/*:F#F~ʕÇFfoxl46'g7 [/&A20=C5h`?I/S|ݴd+++|6o>99Y͇ Ǹ%r:-cL2˖}L8xcp).U0kfV1FxqkXY Nں9E#_c@b6IP`\|3^===_zՀv|+Vx와7^A*{#̜MdG\aVdip,@Xױ]†Ն+Uİ>}-^#AÆm'o 7S&_vww a[**p4YoXqOl"S nhOY3\ܘǔ ;=}1a*O4% ,'p˄7R1xN(.2>.-Z4Q&X6eMR c?fʄC"Uqjj @(-x8nkV퍌H6`4` V 1$/ VAB8k@]?cUZeg ~ƕn,^#`tX4̬1겈>MR k%mˇLpwY`l/Rh/cǤ.`_"Ք={4|iCno .5#Ga:F rؤb+T PZ0yb>ffƊ_s^(0ɒCpG8 %j1(3(**K$ GfffǎMMM=zJaaa>}ϟ_2AAp,Ch}b5jԨsˬ_~zzlCMpAQQĉ7o~ҥҰ%KAAgMAAqqqFFF+qZ[]\̬W_fI8Jtq Yr)h$ rGx{{TPR]\ByW۴is֭[#(U%/DEE5lP6TAPm6b!f 7IENDB`java-design-patterns-1.16.0/singleton/pom.xml000066400000000000000000000033621312550536300211530ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 singleton junit junit test java-design-patterns-1.16.0/singleton/src/000077500000000000000000000000001312550536300204215ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/000077500000000000000000000000001312550536300213455ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/000077500000000000000000000000001312550536300222665ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/000077500000000000000000000000001312550536300230445ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300246745ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/000077500000000000000000000000001312550536300266765ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/App.java000066400000000000000000000121261312550536300302630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Singleton pattern ensures that the class can have only one existing instance per Java classloader * instance and provides global access to it. *

    * One of the risks of this pattern is that bugs resulting from setting a singleton up in a * distributed environment can be tricky to debug, since it will work fine if you debug with a * single classloader. Additionally, these problems can crop up a while after the implementation of * a singleton, since they may start out synchronous and only become async with time, so you it may * not be clear why you are seeing certain changes in behaviour. *

    * There are many ways to implement the Singleton. The first one is the eagerly initialized instance * in {@link IvoryTower}. Eager initialization implies that the implementation is thread safe. If * you can afford giving up control of the instantiation moment, then this implementation will suit * you fine. *

    * The other option to implement eagerly initialized Singleton is enum based Singleton. The example * is found in {@link EnumIvoryTower}. At first glance the code looks short and simple. However, you * should be aware of the downsides including committing to implementation strategy, extending the * enum class, serializability and restrictions to coding. These are extensively discussed in Stack * Overflow: * http://programmers.stackexchange.com/questions/179386/what-are-the-downsides-of-implementing * -a-singleton-with-javas-enum *

    * {@link ThreadSafeLazyLoadedIvoryTower} is a Singleton implementation that is initialized on * demand. The downside is that it is very slow to access since the whole access method is * synchronized. *

    * Another Singleton implementation that is initialized on demand is found in * {@link ThreadSafeDoubleCheckLocking}. It is somewhat faster than * {@link ThreadSafeLazyLoadedIvoryTower} since it doesn't synchronize the whole access method but * only the method internals on specific conditions. *

    * Yet another way to implement thread safe lazily initialized Singleton can be found in * {@link InitializingOnDemandHolderIdiom}. However, this implementation requires at least Java 8 * API level to work. */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point. * * @param args command line args */ public static void main(String[] args) { // eagerly initialized singleton IvoryTower ivoryTower1 = IvoryTower.getInstance(); IvoryTower ivoryTower2 = IvoryTower.getInstance(); LOGGER.info("ivoryTower1={}", ivoryTower1); LOGGER.info("ivoryTower2={}", ivoryTower2); // lazily initialized singleton ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower.getInstance(); ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower.getInstance(); LOGGER.info("threadSafeIvoryTower1={}", threadSafeIvoryTower1); LOGGER.info("threadSafeIvoryTower2={}", threadSafeIvoryTower2); // enum singleton EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE; EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE; LOGGER.info("enumIvoryTower1={}", enumIvoryTower1); LOGGER.info("enumIvoryTower2={}", enumIvoryTower2); // double checked locking ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance(); LOGGER.info(dcl1.toString()); ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance(); LOGGER.info(dcl2.toString()); // initialize on demand holder idiom InitializingOnDemandHolderIdiom demandHolderIdiom = InitializingOnDemandHolderIdiom.getInstance(); LOGGER.info(demandHolderIdiom.toString()); InitializingOnDemandHolderIdiom demandHolderIdiom2 = InitializingOnDemandHolderIdiom.getInstance(); LOGGER.info(demandHolderIdiom2.toString()); } } java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java000066400000000000000000000026321312550536300325220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Enum based singleton implementation. Effective Java 2nd Edition (Joshua Bloch) p. 18 */ public enum EnumIvoryTower { INSTANCE; @Override public String toString() { return getDeclaringClass().getCanonicalName() + "@" + hashCode(); } } InitializingOnDemandHolderIdiom.java000066400000000000000000000044411312550536300356450ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * The Initialize-on-demand-holder idiom is a secure way of creating a lazy initialized singleton * object in Java. *

    * The technique is as lazy as possible and works in all known versions of Java. It takes advantage * of language guarantees about class initialization, and will therefore work correctly in all * Java-compliant compilers and virtual machines. *

    * The inner class is referenced no earlier (and therefore loaded no earlier by the class loader) than * the moment that getInstance() is called. Thus, this solution is thread-safe without requiring special * language constructs (i.e. volatile or synchronized). * */ public final class InitializingOnDemandHolderIdiom { /** * Private constructor. */ private InitializingOnDemandHolderIdiom() {} /** * @return Singleton instance */ public static InitializingOnDemandHolderIdiom getInstance() { return HelperHolder.INSTANCE; } /** * Provides the lazy-loaded Singleton instance. */ private static class HelperHolder { private static final InitializingOnDemandHolderIdiom INSTANCE = new InitializingOnDemandHolderIdiom(); } } java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java000066400000000000000000000033341312550536300316750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Singleton class. Eagerly initialized static instance guarantees thread safety. */ public final class IvoryTower { /** * Private constructor so nobody can instantiate the class. */ private IvoryTower() {} /** * Static to class instance of the class. */ private static final IvoryTower INSTANCE = new IvoryTower(); /** * To be called by user to obtain instance of the class. * * @return instance of the singleton. */ public static IvoryTower getInstance() { return INSTANCE; } } ThreadSafeDoubleCheckLocking.java000066400000000000000000000060361312550536300350750ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Double check locking *

    * http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html *

    * Broken under Java 1.4. * * @author mortezaadi@gmail.com */ public final class ThreadSafeDoubleCheckLocking { private static volatile ThreadSafeDoubleCheckLocking instance; /** * private constructor to prevent client from instantiating. */ private ThreadSafeDoubleCheckLocking() { // to prevent instantiating by Reflection call if (instance != null) { throw new IllegalStateException("Already initialized."); } } /** * Public accessor. * * @return an instance of the class. */ public static ThreadSafeDoubleCheckLocking getInstance() { // local variable increases performance by 25 percent // Joshua Bloch "Effective Java, Second Edition", p. 283-284 ThreadSafeDoubleCheckLocking result = instance; // Check if singleton instance is initialized. If it is initialized then we can return the instance. if (result == null) { // It is not initialized but we cannot be sure because some other thread might have initialized it // in the meanwhile. So to make sure we need to lock on an object to get mutual exclusion. synchronized (ThreadSafeDoubleCheckLocking.class) { // Again assign the instance to local variable to check if it was initialized by some other thread // while current thread was blocked to enter the locked zone. If it was initialized then we can // return the previously created instance just like the previous null check. result = instance; if (result == null) { // The instance is still not initialized so we can safely (no other thread can enter this zone) // create an instance and make it our singleton instance. instance = result = new ThreadSafeDoubleCheckLocking(); } } } return result; } } ThreadSafeLazyLoadedIvoryTower.java000066400000000000000000000035141312550536300355160ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/main/java/com/iluwatar/singleton/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Thread-safe Singleton class. The instance is lazily initialized and thus needs synchronization * mechanism. * * Note: if created by reflection then a singleton will not be created but multiple options in the * same classloader */ public final class ThreadSafeLazyLoadedIvoryTower { private static ThreadSafeLazyLoadedIvoryTower instance; private ThreadSafeLazyLoadedIvoryTower() {} /** * The instance gets created only when it is called for first time. Lazy-loading */ public static synchronized ThreadSafeLazyLoadedIvoryTower getInstance() { if (instance == null) { instance = new ThreadSafeLazyLoadedIvoryTower(); } return instance; } } java-design-patterns-1.16.0/singleton/src/test/000077500000000000000000000000001312550536300214005ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/000077500000000000000000000000001312550536300223215ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/000077500000000000000000000000001312550536300230775ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247275ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/000077500000000000000000000000001312550536300267315ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/AppTest.java000066400000000000000000000024761312550536300311650ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/EnumIvoryTowerTest.java000066400000000000000000000027261312550536300334210ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Date: 12/29/15 - 19:20 PM * * @author Jeroen Meulemeester */ public class EnumIvoryTowerTest extends SingletonTest { /** * Create a new singleton test instance using the given 'getInstance' method */ public EnumIvoryTowerTest() { super(() -> EnumIvoryTower.INSTANCE); } } InitializingOnDemandHolderIdiomTest.java000066400000000000000000000030271312550536300365370ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Date: 12/29/15 - 19:22 PM * * @author Jeroen Meulemeester */ public class InitializingOnDemandHolderIdiomTest extends SingletonTest { /** * Create a new singleton test instance using the given 'getInstance' method */ public InitializingOnDemandHolderIdiomTest() { super(InitializingOnDemandHolderIdiom::getInstance); } }java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/IvoryTowerTest.java000066400000000000000000000027031312550536300325670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Date: 12/29/15 - 19:23 PM * * @author Jeroen Meulemeester */ public class IvoryTowerTest extends SingletonTest { /** * Create a new singleton test instance using the given 'getInstance' method */ public IvoryTowerTest() { super(IvoryTower::getInstance); } }java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java000066400000000000000000000075351312550536300324100ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertSame; import java.util.ArrayList; import java.util.List; import java.util.concurrent.Callable; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; import java.util.function.Supplier; import org.junit.Test; /** * This class provides several test case that test singleton construction. * * The first proves that multiple calls to the singleton getInstance object are the same when called * in the SAME thread. The second proves that multiple calls to the singleton getInstance object are * the same when called in the DIFFERENT thread. * * Date: 12/29/15 - 19:25 PM * @param Supplier method generating singletons * @author Jeroen Meulemeester * @author Richard Jones */ public abstract class SingletonTest { /** * The singleton's getInstance method */ private final Supplier singletonInstanceMethod; /** * Create a new singleton test instance using the given 'getInstance' method * * @param singletonInstanceMethod The singleton's getInstance method */ public SingletonTest(final Supplier singletonInstanceMethod) { this.singletonInstanceMethod = singletonInstanceMethod; } /** * Test the singleton in a non-concurrent setting */ @Test public void testMultipleCallsReturnTheSameObjectInSameThread() { // Create several instances in the same calling thread S instance1 = this.singletonInstanceMethod.get(); S instance2 = this.singletonInstanceMethod.get(); S instance3 = this.singletonInstanceMethod.get(); // now check they are equal assertSame(instance1, instance2); assertSame(instance1, instance3); assertSame(instance2, instance3); } /** * Test singleton instance in a concurrent setting */ @Test(timeout = 10000) public void testMultipleCallsReturnTheSameObjectInDifferentThreads() throws Exception { // Create 10000 tasks and inside each callable instantiate the singleton class final List> tasks = new ArrayList<>(); for (int i = 0; i < 10000; i++) { tasks.add(this.singletonInstanceMethod::get); } // Use up to 8 concurrent threads to handle the tasks final ExecutorService executorService = Executors.newFixedThreadPool(8); final List> results = executorService.invokeAll(tasks); // wait for all of the threads to complete final S expectedInstance = this.singletonInstanceMethod.get(); for (Future res : results) { final S instance = res.get(); assertNotNull(instance); assertSame(expectedInstance, instance); } // tidy up the executor executorService.shutdown(); } } ThreadSafeDoubleCheckLockingTest.java000066400000000000000000000030131312550536300357600ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Date: 12/29/15 - 19:26 PM * * @author Jeroen Meulemeester */ public class ThreadSafeDoubleCheckLockingTest extends SingletonTest { /** * Create a new singleton test instance using the given 'getInstance' method */ public ThreadSafeDoubleCheckLockingTest() { super(ThreadSafeDoubleCheckLocking::getInstance); } }ThreadSafeLazyLoadedIvoryTowerTest.java000066400000000000000000000030241312550536300364050ustar00rootroot00000000000000java-design-patterns-1.16.0/singleton/src/test/java/com/iluwatar/singleton/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.singleton; /** * Date: 12/29/15 - 19:26 PM * * @author Jeroen Meulemeester */ public class ThreadSafeLazyLoadedIvoryTowerTest extends SingletonTest { /** * Create a new singleton test instance using the given 'getInstance' method */ public ThreadSafeLazyLoadedIvoryTowerTest() { super(ThreadSafeLazyLoadedIvoryTower::getInstance); } } java-design-patterns-1.16.0/specification/000077500000000000000000000000001312550536300204505ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/README.md000066400000000000000000000017531312550536300217350ustar00rootroot00000000000000--- layout: pattern title: Specification folder: specification permalink: /patterns/specification/ pumlid: LSX14i8m20NGg-W16lRU1YcsE0d9mCTUNxVkthoxkVJQjQBVJc3bWoZuQeVXh6UbXao7EfhCGTRhOd3Gcp-yxPfs-BOOqF2amVa3vLAnbmd3ffD2_gTLZBPgz2y0 categories: Behavioral tags: - Java - Difficulty-Beginner --- ## Also known as Filter, Criteria ## Intent Specification pattern separates the statement of how to match a candidate, from the candidate object that it is matched against. As well as its usefulness in selection, it is also valuable for validation and for building to order ![alt text](./etc/specification.png "Specification") ## Applicability Use the Specification pattern when * you need to select a subset of objects based on some criteria, and to refresh the selection at various times * you need to check that only suitable objects are used for a certain role (validation) ## Related patterns * Repository ## Credits * [Martin Fowler - Specifications](http://martinfowler.com/apsupp/spec.pdf) java-design-patterns-1.16.0/specification/etc/000077500000000000000000000000001312550536300212235ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/etc/specification.png000066400000000000000000001404211312550536300245530ustar00rootroot00000000000000PNG  IHDR@~IDATx{}&ڰ`$f /`9Le4p8ȱ[2HC8x(Wè)1ДT$W3eC9zE~h($t b7@`Ou=OU}>4Ow~;>8V&@, `|]-嵲;`@ XpC@H.a KlA?``Q{Ț̙]kCE$Ca;a@ ̑LE$Ca;a@ ̑LE$Ca;a@ ̑LE$Ca;a@ ̑LEd:9̔X;6/-{yp{ꄺ X:X0Da -+"k vm~Ju+\\Y^ `HEF!,cB(,sEd58(j;3.;-;({/&0VQItkKa@PQ uja &;QXdJU\mllA%1>BDZu\XTN*-.2"`B}JUժh9E@kUY_̇X}Ai5]ۉ+`a&@(U)s3*žGEܢxpE,L.]CPo0"Na;a@PS tDa -PD`1D   Da -PD`1D   Da -PD`1D   Da -PD`1D   Da -PD2۽S)Ju+*D3P'@s$&%@hfw>=:}̓SQk۽=/Q=u,0GBj2QXd^xf{|v?~AX`ND [_o?~>+mSU9B3P'+`ɝf< F,aYDa -\k1}/<+pw׿M|jUmo,{o_[yao+lQ)w'>O\qO{O/~e Lܽ,+fa@Ñ4{h?rL=ïd {l ;{KFh~Gټ KlT1o5*ׅET,:?fc%ٖoD wן[+_=cl#% Þ:!/Kiv 򁲞|TTa]\;Q5Q Q0F1B;E4PXd wZ'׾׿{s=›_G} ,lE-JU0?+#A:ؓ];9[hQw?qŋ?Y_|>7K\ B毰iq "`:^ϯɉw3k!lfG +|7VMQʗQ4KF4(&h(,Dh ʶD h1[|iM?{>CSâ+yC:ŏ1i#7(a?E+=Go[c,߂%[3x&#lc#?Ks7u﮽vQW=}f[^r ÝvaB1߰{E2t҅SЯx }0=*½2+XJO1RWE.`ڿ^, [n,$Nj]mwhwļ>J./y <Vȏ@0zmP{o\yo]iwwHpՠ& r_*~ %] lrmaP)hВϨ>"I~/?Bs5-LZnw^~&kO_mO{3IUL=W-% Ĉ-3P'"`:K|GJia u$=І/Ba̋ک[z H{R~Z/pGs><]m<kD#4#e7@䁬Xi"?TF_Km޷0E|ϟ}a[?xhP+M Gُ(L!;4L/%<!Ya`0D.ֈfmx@ {~,;X$ w6]pOS)lWW)ʐQM.D=w[=6PX: };X]"?Οx{ǏA{Mw~yΘĚ>_]Tht.s(iά:atFU﩮K˟Ɍt> G;Ϋ|_ˋDF`IzԊ4%sb %5JYT|z? fjOQI<<"\j`XA{d.DE!e2+;LsyG*K]Vdž@䁬Xi"?o|gK?mGwүX8P.=|v E~pRAb.cFwF͐+J3 cݵaCgZ;l?yD_{rOwm1 `EӌR noPdJVxR3[ 4T5x6[ψy }2gd2+;Ls}GXT\j >S`X4-;>OS'mѝW61䑃2:zztE.0%7OP6 b]種~wqgT V44t(V8~7z#wQ !:* R~'y!UG4c,/w:۹|)w0|TX'e%f,NaHVbTB]mwskZG4*nh|&D~yrk7-޶ ;IM{JSJ3(+Dˡq-|CQĦW!TK+y_$^b J${9W3؂ϴ;~G`+Y{`{O2  B.VN3vPwSq£ Y2=%%V')ڏ>V Z X#)bɏQj-nLchӮGs|;k>rmϏuw3Ԍ3Z\%M3, d3k/IeJ:t!}E%t%dGm8WiSha}{{6}6ԫ!*XV/./TE y XfRwSPG'`in0y*wp\mw6B;M LNh >S6LQ5sVffՅQSts&c=Plv> [O>+K3J}Fv` {~N3,]# KGPTS'j: (j!/+mt̔>MG2jO8}2B##?AϴB=uBp `e#=OI -_i? HKBѼGRFVo8:`@"3 :0Rü#J{ȏ("AgZwT!ž:#!`5(,AyJ7:O` d omHU18]@RKyR@1uGPE$CL+*D3P'@s$&#p~7)/ZsvºLєZ\ tR+1d X 3;a@ ̑L<CѪKῢHnϗi"&`)RŻ0,a?b`YE$CL+*D3P'@s$&#(6OW!HECHUu6ٰSR4+!MHŭm/RK}R!SuLB X 3;a@ ̑L<EU.2bǞ&e*WҿēZV!,hJ c3Vv>   Da>c] x-vϴB=u,0GBj2QX:)X ;KX`@L+JsG5S 63P'Tk.;Y`BRX ;'{ةǛDp 0^HWL+B1&dZ;_bόQU\[cy|]-W֚ Xe.;Y X9=&PXdgGpO,v*O)kP0Qx;QTzćO{1WVj82Z\HM@2etںzFXB6dmMXuk\uJ>JL.d+La0!L(@<ևȏv͇PJhQn/O [W=aaJՠm<]>ӊWySmCPlU@Yjچ'e4NJ':A)|S37G~ px(*e-` Ms}zA_PK>9>&iE\wTW>AU98TK)% ojX{FY'`ٵ)fpRVfL0,N gB-,] oX ;XVIEvX3\Tq69DuAgZ1UKř?O:4ZU/>{fm褀UON)WQ>f X0!Lkpҁh-_ݵ㫴M{Jp6;KaҌNZ3iAMG^K5$5j/Π.m8.=gZ1UKřF`ɷ57Eym`fm褀UOƐlpR6fJX0!Lkp~yI۴+_F<\0.7s\`Q h-}sݽg]2e䣼LAů!Qʮ)]=ot1 3c ;ίԔ 1ŒU^lsfhC+Z5 +'`յY.rS1 L9jla+=gx/'M{hak<_1!c=`vZ>ӊQQ-u:*j*|D =r\y#3l!ֳj@VtP:SS&ݬMud҃rd `BΙPc KPow[o\9w<@{JiAqBH1!`õ u%|wG09hj=e@3]^s7,,Vbc KZZ:}wLUⓟK"q=FWWڞR ПN9vodV 0\aV}:gXAϴ˫l${c9+UVSY]v1wF8;?r"ĝE*w(*d۝׆!`9V5+w}O"__`Wf/M<ªd0QVӹDz u%|pGbc9G+V)jƓh2 iAN$;C(i lla\SM|캧>~D"?W.z㗆VF aC~2kJL+*s^VgN0T#R!uu;uG?HXMfc KZ7~zeǿ&mǮjX, X# "?eg+3;k5^&L=Z)DaFRd,d6t 7n˷M}qgnOyb?6!ip!¸1lRNpMl,"a!?ccoSقZu]ZJc:.%-&6Je,m,|3c;QD D ,QL.aac KZw~s[?u~iϮ(JU}Zaq}k}9Ez u%|+ -'V!dAȫa. C>WC/ʃV@Uᆀ̑]k^wѿk,WveO/MB]Z./6%}?]YWՅkIL+*ڳ+V֗c["Q=ӚFwpfhؗ W!t-aw ; 7yˇ۽kw5#WC"J,howW}=K*n23N!4"?nfg3;kϰX!`5-,]y^-|>}Ck+g3֌VUgXim ,y #? X 3QG "mxI6ݶxsD`cfm ,y #? X 3\lD?<_qX{FY,27Z(W^kfg~a0ʬ X3Q$`~b_nX{l laX Kam5 O}ǺyA$ZybB*3,BoY)G**)ҿ5dg%V&%W_5֞+Zh2!`V5 O}Ǻyh}VA֛VVBo+@ts1⸿૸^,+YeX{f * ,y #?߼k}u&0k:v =<ɍaf!3a0JwyKq\j,֌VCܙH b% B94@'8PRjdܯs:?8}_&}>/{'iXr%cˉRIz[@iXmw`X;t-,]C5Yȏ@XM!쩷8VxF/K|B͏ZB0gZapGcpԼ6諘,`DjCwϫiű,Fo3Xk_~ON}عGUmo8+ĕU\:y,˃FYԹ Vak^&|Iwi5T@bMV>D~5VO]F`٨:Nl #iwzװ|iLSUXc6/A5]P"{. i}|֧>P_Ͻ o~p©Oخ0m 6>#ZL+H! tXՅKLZm:An=fD~Reg+1,1?5`4J7,`!?30N/Mjo t%ağ<k == G`9L=HSh~-7-Oq7/~;9z+a2I89ɖ,"M@PQ=Zb55:ݕMF_,6KMKw&5{Q,Z-tH2Ss L<`SEHlUr]A6o?d v29k:^&4=e-6̅ȏ@hЧ۲[pP3g׎ƲN{l%%||CߢOzvD@+FL3  { #7﷮~m;p?4LSb4#'ٓ 3,ia~9BSp,gqOy0mW0 :n_4ꦖJ}-@jLIktrw'm+*\h#vJo`D֪\9Z+]V =`W)]_PJ1.WhTa&pZU ɣ[U#N5)uBߕ5xXA}! 7e5} Q'#̜ȏ@ٹ*-(6 VU4Vg}߁[wxС^7`egOdhq_b`-`dC)i̗>Yo;okSzXaHcs8c ^}-gr@{@}rnܻ"X5s#Leq_k*;3=-,]CU̲F`ñWqXglU>ܗ_G%`F~b+0gZwT!6֞XY{=ҭ||o{1vt':*$~N!d8uI3ȞQճ5N!_sj X?cNq7}W);C@[a8V}!Rlo6(ߐ2#Ygb}ej>̼XvhyL6V]S)߬TbpXrZ%))ph9.̇ȏ@A3;k)tk>ߝ~?z>iwHaCaOqyI꓊C3 gd'oZ_bq/\y-Gvxe*mlY\2 &bǤLl\b.,Pk5{*`ŲØUN{Iwiy@Q߬"gC.Dqv\1 j=*s_b~QDy.b3"?dgEgZwT!6֞[_unZmvn=>iHՐ#VllbY@ gNM<9 ~m}}/}Sc] Ű2>B/lw/{ߕ;6w + V'F*6Yic  Ax2g.FiX_݁<dg,N)D3ܴ:6` 7c]6j@ny+7Z8X1>΢6fm ,̊T)XW^{Oۥ[ Vwjd,`0N!Z0UT\&:֠a5VRXu:pm ,jTD}Z HTb/ė)(Djj&u'NqP2: $w$zGV"`zw5Y;~V,U Mq `0A; 5 S`.UbZ`X  >?6Sī)ޟfˬ(`y7)_)O#ZX۽ b\#@7 ,jT)Xd#` Zn@UZ}CSp]629c#p?ƐMn-x">SO+ b`"^}df׉~24(i^[jXS0B+:\h gU׆ɬH@ȏuAS=b X#)n0|"Sқ ١Q[ .YB5 OhzGrL, j5F/gх~%֜vѤ봬j++*`3ae*u y ,ȏ9;>y]4muAܣX_5b.SygLI8]~!vu"<i L+ ˾W5;/IK-ePK#|Z\~ug2+E+VK #qQ8pE X.Lfc K׀ @ A낖ٻwG^?L_Bw_qaaY!m66KXjhC1eA-挊s1k(BeDSi^UigATHRöW1Da5C|!LzэHTً7\$-c8xZkj X*I8]clV \2EgO*FTpiͱ}N2oU-*AƯEtχRk%n=)A\E&pC c-,]CGʏϟ_XX,de]/?ueGSJɴեql3*hN`&p)Fv,Q7Ψij 婞au"_rnTw3d*<M>|kjpLYDa.s6o"u u+R.,o!e)`yWE8Q9ݠk='R-'<0\?<5B"y5JB{̭E;Sx>{A)$ Tz+Le~=GQs-?QuÆ yIrΗ?cNq7}W'[\+Y^h48¨/UIi X,CG(7Ya˟%;P<(="yHR;Dg8JcGe}h,sWKSqFEgz~-ӻՖBrK(6f>39Y@3Ϳ2W"̰_{>U[O[ ߟ- B*T &zHvX9;D 5џ*H׉ ^tI-l9+ɴeivrd BU(gʈR:+fm-\:c"]I{y D%?uV3ɬB;4?l@9 ulrW E(s+,39 ^uI) 2H5KlGXtBRcJ/N2C vX9;L&w݋PVQsb ?* -p |׉uNhCU9m]ps8QOlw-iAQH/klll{)?|0Fn3RJ3rzr]x/ `ղo<=ތUU{iS‚NlIJc9[((;7ukBwr\zwX8@Q<;յ\A /mӦo{HO`u ڰ@*Euy%yaP;̊9s}/ F7.i]6+qU5!hs"!(l D<4ByAZK+  a,` ?ets~ chMPhֆ X9vyeA] h`,aVD ޽X78aڠdQĖ&S챱ZT!DISg  B +\h4{ SΏP"A8@I+@#`rH#cЬ  ;̆9]#[Wf?{4J;d5vi3$* $,.)%e;c&<FrsU!T(rE!?" ;Hl}~'Bd!үdin=7ABY+`5cE,0tyN!{+qTpZ I+ve[JyF~qzNtLT`)$r򁔝ײʏBda"! arrҰb,`0N! v]GTŢ,}Wg~jfhtt@'ٗ]ga2fm ,LT.O]ێ:qI_i'&4 +'0.L^ԼA( Xm, 켖m~ j@b:%zGVxPE!HeF )QqrvX{{bXPAЫ _+,0G `5 >tyjq-KӴKfP0 p[W5),aizH,;;1SBڠGfBOAbܓ ͩRP5 Y {.ΐr ڰV @K_x_۽o_:}`KsA_4X wk @L1,1Z]F  9#v/lXRuC# #3Nцaikj+F%ISC2WaFUO-0=iH"B,-tٗT0!0 N<|l6iEwS>=֦rQlwv[}F>| k~-Ί61$摘[Z+A53c8?Ʀd4+؃7<5' *!s5/OМ+ԟH È\! X!f8P+]kCݹйb |N=`λOhP$78vFg[Еh_#;kXzE_4]tk8OrhN% S9%%0Z {.֐rVZTT\L( lHssDA`]wzoRW+_jbSK9eͿVž5\4:;*jK Bl99(S+9.;z+ϟ=}\2Y%Ei G\-hFTŌ+);W.>%N6W=9QʴSOW,JAgdPPx6 |}mvrɴK*'yJrrNiz \ Jj XjjP=NS  ?Bs]_t+˺ !2:pm+-*Y.&`1@.;_ێ:qI_i'mA)G ӚEE?ٳHAlVnWRv]f5}h(S \! Xim+-Y&`1@.;<#;2L':KM8qOAU̕+AYQ-c7쀀jERJW^{Oۥ2P hPPm ?~^ *qWb  \Rd1 s%2+3{AHJ`)AjG )Wķɗ?KW~m@Ң `B@a@W1p0gN<|l6T f؋biw "km"m rbϴ <@V *fȬ6FQ5#|N=Pc$T _ U䕀VT5 ,vqm4L©fpcSTNZstQWjgZ!^][{DD?mm爴s)\ya["3VkM `\Ң^ 0!0 'sh#Y*b#|N=P1+8%OTT5Jw% $|+觛]+nkϣԁ Ҋ\(I#sX X 3,!?wx?rA )d_!π>ac9Md]\Ք1+ j /ت_T&!`z + +w`ˑ^?pjyز4M;erhK]ոSQe{:>> Y#OSijW{S?a1Ч2l=g̹֙ 1k1sGX[u_OGZsJ4 Y&C?~^ *˭Kϔi[+3֑9@ ׄ㪛hiB/.̕VGfv' O(FS$hbCЧ2l=U_e6SYVKMXYkb`sl#OVcdx6PkNz +`nu! aP , a0UO1 厣>2RݚkHz K1 QN򲲂,pe ̚V؃7<5' *1cmV +0Fװk{h+Zfd ;rH(*塱^ 0!0d--p\FXwS8m2c|Ԣ\rAq`"gZapG^5,_b5N!T0F\PO1EVZ4 Y&Tni S ޽X78aڠdрʽLwk؝+ƈel~S5Ptz-nxEa/.Vrf0 5AıAL;̵N/Mj/)AgЧ*l=Cͨ!`Ec`B@aHYx_|ΰ`U"G>h#v,!xq3!j2cF LgO Z\T9UU>>ӊct*70kF S6֞!`g!`Ec`B@a@ \ytN!{+5/N R7B1՞T3J(l J7\eB=EH6Vd+` 35;fG=LN#0FUacuVZ4 Y&`ךA/xmfwnM,rtXWT7Z,R\X+ms-i.XܒUAGijbcVZBJz +€7Z3l9+ɴeivr#W誆5%:cp"QRQ3XVvQ!6֞a!hL( (~+5!;_۽o_:}`KsA_4X wk @ qG`ih B 5XVvQ!6֞a!hL( (~+59;u⡷_wcӴN- RfQlwv[}FF?RB8`{ ijbcVZBJz +PB͎ш7Yݍ~-tFxMϩ΋5GRH%|*ڳ VʕnlHemHj)BhL( *`mH7;|b5h2خMEϩRegv"T\,V 1X{N]h^.諗|A NaeiJ[XuDc`B@a0޻OFEe{./_?*xS,s*/̤l1{1Y+X"3U!6֞SՁꥴTD'RwUG4 Y&C}ów8y'~6諦:U {AŵB(eJ /iKW=zV CT領?P Ύoذa۶mKKKh1`1ϴBl='+TrT%T4K8Ar{|"hh=:W/lj3aN^:цj)X/dPtٺ2٣W',[Ư&|=,nſ_lpLYeȼBQ\LwmAqV tAg]O)T^^gϞɟ:tٳg_bbiEfHYr%-.rڱdoLp(ziO'{I{F3J|-W3Em֜@V AWx_v{}_?do?}\2 J)kE[s+Gm^E3F$źڤ~!Vg)T^v{ꚜmڣL  !|ܑUJ+ *D+&P3*kϩZ oҬzit×97ﰊ/j /^ZsJ4 Y&]}[o;6=w'}lu/ 7jZ9z s8s%q6329 UBm;wСCSSSccc{9y_@gZᤀ%5cM`c9MX2Hv"njWV/S'o}Z+Ix/n5Dc`B@a;?Ȏ85ǁBydi|f)Xv+JL+.q354U{ -aK bl=\BJz +€7. nɃA᭷u链N6:2y2ӊF. +m!`Ec`B@a@ \yny/>9ڠRK ,u$KL0<0Awdk LiECjX{{[ U֜z +jF4>GF ʘHP3N<|l6i\2L2ChȌb\03`gZE{Xs ) CiUL6 :c% %|ۿ7xa;o{vٹ`.zLRH,tV@a@kNx %`B@a()@\oEl/!Q{,h٫&|;ޱqFnE{lrrn$Uvv%K, e>3& `UgN5'0!0OFꑴ5.Bka9lqaAV6l^?dWR  +U6g& Ul :R HPZ ޽X78aڠdQМL0LyA(qЄf%$흶nmxxThqٳ` QՐA̐M)wT!ž:֜@J bz+ϟ=}|2˲e6PiUj ^e8ϛo}(t-F,5YB=u9  AWż~J;d;lAoRL_=eʬ)}AΟ?С7t 6/q&&&z-F,5yB=u9  AWż᭷u链N6M4j`_8Nt8u=`@٫V!`^ozzڟḺJ;qN{J)~Ű>3oW^{Oۥ $R&]sq-KӴKf=-. +W9- ( nuܹ={PI#.^Hw~_)!``1,C?x6J $`I/L( *;4GUJcū?T;/qu>’E XXʬqpAu+lJGZXXEoh={X5q)wFag67 ̲04ž:֜@J`bu⡷_wcӴNBB*N}h@ڄ_0jR j^a:s\@P@|݊ngyynӽPJ]$~<,k,1Sln J`lfO3 gP,Pɛ >d ` Z3r0I~_-gN5'0!0d]8Μ9s\@P@|݊p鱱1k}}}Æ +++֔a_T# {W.+|%*xS`tg:SdF9KK-D3P'^H PR XKml;>[;wlذkyy00% gqOy0mWEh@^f0c826 V[Qⅅ?@]G>h#v,!UGUjC]F<78,R|:tP#U‰zſs]| }5w%iZB enWHg5'0!0zxFҭ.)={!2.;_v{}_?do?}\2?A Ñ;Ҍhf,^ԦeSJ cZ)pfv|_"iRVebSTKHnIw{Xs ) ,_Tе---ԭ$G F|[o;6=w'}lf^OaaGp?e;P:K,'06X)pfv^w"A2V X;+PXZYک*K=u9  ϳZ$]̌UOMM ]vy-Gvxeic4G`Tڊ`ꮹ=9hΩsiLSVUn ,Ya]x;~ϼ߾*1L!fqY/as e)0zu7Xs ) Z@Af]UbAneB?0o1^۽o_:}`KsA_4Xz^->:XQ:n+K|lZڔMMUWB=;_w<޻^HAck=yTW|Y#^H CU0nu%J?11Q|++ -F]'zuW>6M4QL0F XnLZb*DÝŨnv2,*VUtS`D= ;_ny/ B2OF}1c0'Ui\'b`@5'0!* - (`T݊m6SJ6gFkfa}@痷$iVǺJ*{C#E^ԋ :1Y G=u9  ,[^YY#+q=./X%#iVdgLNΑhP{Xs ))TnA tNLL+Хl1s^iq5{!#4+Q P{Xs )tTqA t+/t7n:bZ4+\vG RtTA(=u9  P ݯݲ[ X'fQ{Xs )HTtA t'MOOCVWWs|#CkܡCȓTm N5'0!FupҥpTL݊nnyƍJ-F,^z%9KKKsssIȑ&=VWW)U(b`V;Xs ) TzAn5666==s5#:4>>NPWJ={}{bb(oB{P$ LLL$QvP'^H Y  H[ӿ65#ggg+MjS1>>NOnSZqV΢-EAPǰFdrr2N7C(! N5'0!Ҡ  H[N+dDv_8Atsd8u=`@AHC=Mаasssx".J?3ЏS*FNGF/Jʳg`I/L- (n0nEaaapFamm=yƍ =aŸ[8SOƖi%R-xcS4B K~E{h>z-[7tnDmGF/JJg`I/L- (Zk+++۶mK[QoiiTW?̀ C残n:sm}}/}Xb`G idQt!AHk=װJy35RXїe ~q9\I 9  @P}:/LB\)qEjRhjjJ__wx_6iۙy:ax^'bU&. _:QSPP;;Fyְ7mڤ#\9\UWeyP8V!W=@UkNx %`BPWuA)u]S?ܩILiF2Lь=ìiϟz ΫUE[´;e ~\=+= 5'0!j=(_XZZ#R {b]XX'cJ2X8 j0 c2z?ex||N2Vvzz񌄪eXs )  H[cYZZ577Wq@˗5A1GFKbJxaoï@G=rd=KWL*e% $R&UDRN 6zV333e5STee$k1`e_=¤Q9wSыK@`I/L*/ ( niL|+eF\+ʼiMJu];Xs )ф׭%/OOlyy9!X?5M%#bi6mH^ N5'0!p Y@P@zq5>>N-*2=ٍ7淮Zk9b7a\C VuB`I/LAsAw:==XWVi=9C}-+_;β\uU欺}bW.{2VU B, HF- (#ԭO<>⊅윛J3?z韾kʾ'@9{ee_~gЁ1 hE' %`BP0 AJ::w=@zzv;U3#ğ)e׭/GzvTuzP#4Axj%^;XZZ9e_u+W \>ЊN@J [4sAu+ ~T{:T3Ʀ5j2)N~jlNLzAȗr豔}9r N|CO ЊN@J =Lt+jUä$XadZ={,,,raܹsd0W| Aӷ+zb^n9gh4hE' %`B _@P@&H>L%]h!JK=~|ZRi& vc!b$ @3Vt@}R&d[!DIjl#ĕ 23gmЧO<ȉQ(7,hMn#MZIH Xd[VVVmFǡ_ zԛ6mxl:9Qcqv-)>̱ưHBLˡ$L2z^*nEO366u =11 K)4,&,p), h@VzDfPoϞ=dN /8,j-S s|wy2YNMM۾]K =%e,,@@-Vt@}R&4X@Ќt+PCF++2GX.&AmL80cF5J6= .AП<~!dO@>\:G#vb^ 4#C݊{":T,W|P2װ<;;[92C®qP@OC{e]z=QASdXI Pv7l$AP?`A+2ԭtM6ѣƠQ\6ٳ6 Aղ<@ٗ ~'ONMMaPVO\ijX>,]fq4>:vBt$ZNgj _\ 0 0!qn凸NGcb\[|GGF[Tdl  TV8H+Wz݊N-MhZᨸtC`VJ``~zjFB@4`B#խYח 谈֔ EYXX4@L+= Yauu/*A@%bG:k܊su:-JV} m۶1j!~bP+׏ˆl)!@LXJWQgP@#Gs5ȫ„ s* E/g ^ Z_0@Ia,P&:*S `R!s݊@ Y d\L@If  `eu7Y{AXMTG  &F5 *%LMMMLL`!@2 A.RuX___XXjnn2Nj:LX@0 2׭A+zP[ŋ;[L-Pg d(Ί91\pXMTG y AB\eAEQR+`lKN@q90N`KKKe_ D@uH `J[A|ebbj ,6mg )0[ Bv~@q@x`yyk@) =C_cP?nd6|HN@qΞ=KZvrmzzML,XMTG  f_!Ciee^ Fe^G%zs5G1"?'OU<Ξ=KO<3B:P+Uotc<Aů-3◟O?X… ea~`HfFv300P `\}+q9DlmyyA,D?uP_f*eY#ґ+BiEDGtW [ңiHnbbXcGfg_y=Hd\7XDzpCDUd{{VŴSWH=/\xzcWR y2%zLwgt;ʭLVsssyVΝs}{na}XѝB"oX ћ z{{{Ǐwl,M Az@)-5/}Z{^Zf?~kgv^>*Gڣuebb|?+_jd /}]PS<74b Xh")w)vf>eOeY#ׯ555uIcט}>Ӆ (FtDGF̅ kmm =rm-SB'(be筘fT:ޓ_Ļm|δKFNwFwuǩߗ+G9ԁX"JBc˲;6;;{l!މ%(23Ȣ\ʄ'76n|rbr|B̷>r芀舎舎݄ݕ҃3F+JjI1"Q1]H%TqJ.0kSM~#O_K.R)4<>ydݿ嘛bN8OR$dt7H"~̡ [-/?h`P "zɃ+BCAzp0&0h H-|jb⢥zSy.puq  Do` zAz@"҃$<: yw[DZ;/--Y  Do` zAz@"҃"9vwںS5INoS8={vyyyrrr~~^H?. Do`T¡ =Hh8XDzpCDco^/,\-`Ad1G鍍qZ^`pEh` zp(H~XcGfg_y=yR`ٷ@70*P4X? }ys ?h9I=y]r1-8O~w>t'z1-6'QO7,˽qHs``UX,B#X2U:\)͞^υ`49cT>``dbOeߺE߿^{˥f\Ni2H'|owƗ2[>b`Lp&^F*ReYTϓ~ BkܢgڤkD+oG#{NC^nY֋{F )ۏB |s zOtf!KC̿JF*PB0bk%nz\A@ ?|՗n;"{p;>zX[3h0\A)b @ݩ V)"cV7 T '"Y;rxȗ~??.}ȟ|x7eTDi{c[[w.,\sl7Dp *ʢĥęHQߟ{1Vԇ@׼P,*ifq胖FLdj[^B@E>BwouZGiR3Q6=%%Cc1]U"= Tok3zP뭿{3-_l  ˚P`}ʗ+ VRXM꡷hBXȘr*hI -&>UpADk~׬}W~e{1^y[p^{:oi``I=ީGbzE.uJeQE?ORLOa`[N.=U9B!plV ,$33ݫ!; G'tl|Ik e.\MNen.LBԎMGMbփ^coYğ\]O~m:7δ3_nA1c'aM\`a`P Y샨f)$OnymG?)6.C伈G~~s-Dƻby/d) ,iЀ%VEW(eɢȡoBnJa`[N/ t\dwNgSbXr5"nL\ `>5\Qc"wEzG 5Fj@Å`X#HJ 4X_s?[~KGv7yK7ck剁 %Z7[Q+5 V "cFBy By2IJ @<G#g޿K oP4% oݹ𦗤i\&JiY@90$BۑT' ? |LL.DUbm H/PV .$Ո=E7g n595ҠBMbO>΃^-B;4: _aYTo'5! . v9i+,L KpDmnbHt%[Tɾ=n{nGG?޿Mӄ"chn5j'x5)@X JRhϓVkܢgڼU^Zz}LkJ`u`EA#n&i6(RhQKg)wj&s7y<(9cd(j @b~]/{Cn㱻?{+ħ55='2q\+JXGX`9rHB9-&)?tAĉq>v5yC𱿸>%wzG⯘s"Ɓ,=fd3J-F ՓK%GkI(bF^^ʭC+~|'~W~7_1-*5*4i .I^j'ر:0|#>t'ʞ X*i`͸-˯۔F[Hf71p'rGۿN-OO}Was[]OνoU@>2OMB7G%έ7Kh% ~QB煠L9S|T"= T")m5HHkjT@<kp%J4 ,"=ymD$[UsDt D'(\tsHČ$N,LoDCߪ@70*P4 ,"=&,kر#@)T$DmobjZPybuZ.=oB|5,? '[գ<̘ DGRm ѫs!:#z~4X޳Lw'4?zL=-iZ{j}twg?smWwܙwggO9N[>`{~MZ%MʹcvV} Yઉ/>篹t/8B#Ve >ޱV8AȺ|xrr5oo' | mpECzpJb`Iwۏ=8pzpfT8رfsX ۟|j-9~AYL5ukIKVMyf- ʃFqv BJwvu֕޳;_j%t_ ]u=] g``B9I(_"o7ֲꥧDGtDGtDGnAz@)uF()RH'oqe'j'z+]˷h>):rJ!?=Sd*Ծ ,i9r,X+z?H`Z=E B㿰Y<99)v-շky^n[lX}ZC舎舎舎e҃Ss\KFȾ 5vXp ,?3Wb蝻ŗ^nQ.X>龛eZS=؟y_nx3 }m!2sĿX3S( [Է?**xi` zCAzp0BbdRG^<5?G (Jl1za-:Q@$q8ʇRfN :D=D7 =``Q'\^>@%KK׉>cyrٕNOOVh$MTbyrȓƒ'70 J8 'kg~e"ĄH{o81~D7lVVV'''666p.Ȯ '{5*>O^NCtsHN.s.s>&n8vg#kkkknnNO@p~~~mmͤUb+[УgQoA H%z&=M _#H& %Xkkk {{{GUmx[;wnTi=O>6$ Do` z@!=Hh84![xXV,`-=nvk cљ9%}dϑYk#ʒڰ7 V*kyyd0Lv%\2kKjqy Ǐ155x"mDX%9 1>sK@70*P4\ ,F^9;ݙV{u[:Eɱ?KQ_u37AV+oxK-eY#gۻk9b>H&95hʥEU96˲666D8p@>\e54 s7S*#:҃3>pG}g,oaӟvs/s*Mměvg[*X+d(Aǒ떩N͠s[ni3 IVS.5ʑfx9-MD bZIfV▵^(OBHU:*N :D9E7 =k`M|SOp_boeys'`~TRm݄~Gj1bXV4;4;p+voҹk Nk׊k4V"( #լkJ"\ $12ARG$>¡|U G#:1iPfÙ?3˱K9iT:*^dC1 +8]>ma%Mz@Mepf1QPgXMg7Sbr}aȫHIޓp2|en`E 7]5Kĉ5H q=0;լQȖ'XJ}rMgv@+:I_A6mDyBtYa=Fh`0%*zXYyF΄v 7o|2T¡6=DWb!IhXSۻވ"sU$4bY9j޺N ,gIk`ٻ-k`~X(%4~A3+sʥс=QZ>ĵܒ؏iRm$@vk\GPjdbBtIa=2dz)QUG"az&TUt݉B7WUIJ8çGq2"}m@I^xplt9[SipbEUS\r1}T(rWWPX/W,PK2kXs5&Fշ.ܼjEBXCaMDF./:/>{ńWZ/KuisN .gJݴ THJ m.K V܈ D*x=S'HQBBjJe7ߪ 5]*1J$Zs3Qz#*QZT9cWT.= <+cv 7 *KsC< apb̾XVtd-RYG!̐5 Ki殫ӧǩ0 ㉦GY"-{Syr?}ЋĿbC#'DYÅRx73!}5!,@Fޜ:GP7r (%*aU{Asa0NdH3zPU\|t]F^ME^6;weF^h$CCzD$4V|5,*a`JX"7dOU]Qbv̍Un=)Ҵ}-oy G2>)QUѓjV{Mj% *j$z3?TqY&EYdC_z/5kTT.= ``鑱SFD٢77=~swNcV)&m,bLʘmÛ2p]^3l>U]󦾄7H A}?yPMSGUmj`_5* U=k`%[;NY ,iUk0Z`o#Q›][gbB^FCA#'x*C˔#*VnP R ma73I0*M#D^Hu>R\ U}?ԑnPXѦƽ 3$b|W#J8æ]2f4:X啾6MHV}%r〈,&4 D_:mIR")5U]+}lQK-"}XU\wVdLgJTUH9Hm Z^VK.kR8TU^|PߔQ#yΦ=g5I? a5@EzĎeUk0\&BL؋Mw㏊GDyL71dWyLyR{”seJ4^A; ]a+T%*P/= }m@.s.s>&n8vg#e!eʓ:ź^ꔮ9\ D/"jM]IDcc_HJ8K:H_&|$Y şa&*o)Oj;4Uw^r_J4StXkV?΄f#躨P |QkiBhg!KMǑnx%A"t'rGnbdWJqOͥT: fQj4ϼ N :Q !=Hh8X>ܙQ%.?O]22L;x&1VWofC4+uex[L71ٕc 5QoGLz| w ASQRu4OX0GU ,b9EaXXDz``&9EaXXDz``&9no?2b^$h7TP?"e2ȮD.s.s>&n8vODj"JXXGP6a4<Ȯb r&v /{jc9`^W,^Qv`a{k92WQԆ{xf9Je`e̮xVk[F+}$til!vVyov% ,ȉ\ ,F^]θj`)ƁӾ;AMWil=S"!TՏy,ny#٦ 3{,`*XwDwb nW}F1jJ UCt閩L dQh3M$UM.O?KLO=uB,ۍc{VT7!#Oeb[mz'd|l?Bّ]:#5=S?z/#MR xM&Vc"rٿ{?S+ʕci]MrDVW<|: e>V{F+2X2*8[JXXSB/0 +ۺnsY:JeZj`{ K?:J뗘?H HJ ykJ;DVJi`yuU:514VcI}`^$C-Үk`[ %u&̌4V Z?ԞNܣjө9Qf+7,CMe|L22F!te7!aBw]aohTKT3F!̚],Z׹sGM6y?N=EbF!t?.Ut*E``@Nm`UXx rH ,$0 '0"L rH ,$0 '0"L rH ,$0 '0"L rH ,$0 'd`[Luۭ {'쨃EvXEX OVGlVh՘<zSWkӚlaR*]@&GJ`Yÿvf`8i~J1{l/vU۝q 6Y^_cP``@NG?!~Lu}`#۫;)Ӿz {fwY=;`ﭪZ 3&Ȯ 8 ,ɡ,pe ?mGQd(А(Ev'0 'Wk{d-M)qj^uyUΘ *Xb0;h d1ԦL B9QQ͚Y5Sm'~}$դdW rhCigzZxŌ~6lc X& *yNnP{h6TKBitwtKŰ՝~JXJhhU70~[~hw<~7xJ+.P`[AЯbWQqZ 폺޺`;AřZޝEL*oi{QmeGu;ݠbZ.i11Tv%T[*oͨI_<z>O ˗.%Gk3#}Y؛:_WcŶiیpFtk&)S-3MsB]/H.8`I_v68<C 3&.CZF㤯J@zM_7:˚zq鏾A[o[Ze'ݴvފ9q1J!n32Si/&9w"l11Tv ͍FJ_<zuzMGĿeI^܊W$cn`EV X }D\-6%OeKbJ.C¿|Ln4R ԛ| _zϗx//m&T3] +T[XL5Ǔ85Urt7fYJ.CFcJ@z/oB̌3ԧuRX`.f`i׊u"mMɵrtb%Qvw%=-7#}UMĻP j{:56 -j`қ [ъ^vXAWޭP+V+JNR=CEi9F!( FhȿyBF5E ԛ;q_sRQB KXXDBn}&tGf,+c`5VL95HW(ܪ:8X>S``@N``遁EXI``@N``遁EXI``@N``遁ED% ^ 謧,n-Zw0'VŘlQkC@)2x:ü;5ǎU.j`]7Xy'}@xV都[AZlWw :Fi ,T9uoycobBRVh0/UEIXW^g-Z;,8Uq{b/} V_q java-design-patterns-1.16.0/specification/etc/specification.urm.puml000066400000000000000000000046311312550536300255500ustar00rootroot00000000000000@startuml package com.iluwatar.specification.creature { abstract class AbstractCreature { - color : Color - movement : Movement - name : String - size : Size + AbstractCreature(name : String, size : Size, movement : Movement, color : Color) + getColor() : Color + getMovement() : Movement + getName() : String + getSize() : Size + toString() : String } interface Creature { + getColor() : Color {abstract} + getMovement() : Movement {abstract} + getName() : String {abstract} + getSize() : Size {abstract} } class Dragon { + Dragon() } class Goblin { + Goblin() } class KillerBee { + KillerBee() } class Octopus { + Octopus() } class Shark { + Shark() } class Troll { + Troll() } } package com.iluwatar.specification.property { enum Color { + DARK {static} + GREEN {static} + LIGHT {static} + RED {static} - title : String + toString() : String + valueOf(name : String) : Color {static} + values() : Color[] {static} } enum Movement { + FLYING {static} + SWIMMING {static} + WALKING {static} - title : String + toString() : String + valueOf(name : String) : Movement {static} + values() : Movement[] {static} } enum Size { + LARGE {static} + NORMAL {static} + SMALL {static} - title : String + toString() : String + valueOf(name : String) : Size {static} + values() : Size[] {static} } } package com.iluwatar.specification.selector { class ColorSelector { - c : Color + ColorSelector(c : Color) + test(t : Creature) : boolean } class MovementSelector { - m : Movement + MovementSelector(m : Movement) + test(t : Creature) : boolean } class SizeSelector { - s : Size + SizeSelector(s : Size) + test(t : Creature) : boolean } } package com.iluwatar.specification.app { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } } SizeSelector --> "-s" Size AbstractCreature --> "-color" Color MovementSelector --> "-m" Movement AbstractCreature --> "-movement" Movement AbstractCreature --> "-size" Size ColorSelector --> "-c" Color AbstractCreature ..|> Creature Dragon --|> AbstractCreature Goblin --|> AbstractCreature KillerBee --|> AbstractCreature Octopus --|> AbstractCreature Shark --|> AbstractCreature Troll --|> AbstractCreature @endumljava-design-patterns-1.16.0/specification/pom.xml000066400000000000000000000036041312550536300217700ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 specification junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/specification/src/000077500000000000000000000000001312550536300212375ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/000077500000000000000000000000001312550536300221635ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/000077500000000000000000000000001312550536300231045ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/000077500000000000000000000000001312550536300236625ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300255125ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/000077500000000000000000000000001312550536300303325ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/app/000077500000000000000000000000001312550536300311125ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/app/App.java000066400000000000000000000073661312550536300325110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.app; import java.util.Arrays; import java.util.List; import java.util.stream.Collectors; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.creature.Dragon; import com.iluwatar.specification.creature.Goblin; import com.iluwatar.specification.creature.KillerBee; import com.iluwatar.specification.creature.Octopus; import com.iluwatar.specification.creature.Shark; import com.iluwatar.specification.creature.Troll; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.selector.ColorSelector; import com.iluwatar.specification.selector.MovementSelector; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The central idea of the Specification pattern is to separate the statement of how to match a * candidate, from the candidate object that it is matched against. As well as its usefulness in * selection, it is also valuable for validation and for building to order. *

    * In this example we have a pool of creatures with different properties. We then have defined * separate selection rules (Specifications) that we apply to the collection and as output receive * only the creatures that match the selection criteria. *

    * http://martinfowler.com/apsupp/spec.pdf * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) { // initialize creatures list List creatures = Arrays.asList(new Goblin(), new Octopus(), new Dragon(), new Shark(), new Troll(), new KillerBee()); // find all walking creatures LOGGER.info("Find all walking creatures"); List walkingCreatures = creatures.stream().filter(new MovementSelector(Movement.WALKING)) .collect(Collectors.toList()); walkingCreatures.stream().forEach(c -> LOGGER.info(c.toString())); // find all dark creatures LOGGER.info("Find all dark creatures"); List darkCreatures = creatures.stream().filter(new ColorSelector(Color.DARK)).collect(Collectors.toList()); darkCreatures.stream().forEach(c -> LOGGER.info(c.toString())); // find all red and flying creatures LOGGER.info("Find all red and flying creatures"); List redAndFlyingCreatures = creatures.stream() .filter(new ColorSelector(Color.RED).and(new MovementSelector(Movement.FLYING))) .collect(Collectors.toList()); redAndFlyingCreatures.stream().forEach(c -> LOGGER.info(c.toString())); } } java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/000077500000000000000000000000001312550536300321445ustar00rootroot00000000000000AbstractCreature.java000066400000000000000000000041721312550536300361720ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Base class for concrete creatures. * */ public abstract class AbstractCreature implements Creature { private String name; private Size size; private Movement movement; private Color color; /** * Constructor */ public AbstractCreature(String name, Size size, Movement movement, Color color) { this.name = name; this.size = size; this.movement = movement; this.color = color; } @Override public String toString() { return String.format("%s [size=%s, movement=%s, color=%s]", name, size, movement, color); } @Override public String getName() { return name; } @Override public Size getSize() { return size; } @Override public Movement getMovement() { return movement; } @Override public Color getColor() { return color; } } Creature.java000066400000000000000000000027341312550536300345100ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Creature interface. * */ public interface Creature { String getName(); Size getSize(); Movement getMovement(); Color getColor(); } Dragon.java000066400000000000000000000027521312550536300341500ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Dragon creature. * */ public class Dragon extends AbstractCreature { public Dragon() { super("Dragon", Size.LARGE, Movement.FLYING, Color.RED); } } Goblin.java000066400000000000000000000027551312550536300341530ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Goblin creature. * */ public class Goblin extends AbstractCreature { public Goblin() { super("Goblin", Size.SMALL, Movement.WALKING, Color.GREEN); } } KillerBee.java000066400000000000000000000027701312550536300345740ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * KillerBee creature. * */ public class KillerBee extends AbstractCreature { public KillerBee() { super("KillerBee", Size.SMALL, Movement.FLYING, Color.LIGHT); } } Octopus.java000066400000000000000000000027621312550536300343730ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Octopus creature. * */ public class Octopus extends AbstractCreature { public Octopus() { super("Octopus", Size.NORMAL, Movement.SWIMMING, Color.DARK); } } Shark.java000066400000000000000000000027531312550536300340070ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Shark creature. * */ public class Shark extends AbstractCreature { public Shark() { super("Shark", Size.NORMAL, Movement.SWIMMING, Color.LIGHT); } } Troll.java000066400000000000000000000027501312550536300340300ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; /** * * Troll creature. * */ public class Troll extends AbstractCreature { public Troll() { super("Troll", Size.LARGE, Movement.WALKING, Color.DARK); } } java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/property/000077500000000000000000000000001312550536300322165ustar00rootroot00000000000000Color.java000066400000000000000000000026521312550536300340650ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/property/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.property; /** * * Color property. * */ public enum Color { DARK("dark"), LIGHT("light"), GREEN("green"), RED("red"); private String title; Color(String title) { this.title = title; } @Override public String toString() { return title; } } Movement.java000066400000000000000000000026651312550536300346050ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/property/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.property; /** * * Movement property. * */ public enum Movement { WALKING("walking"), SWIMMING("swimming"), FLYING("flying"); private String title; Movement(String title) { this.title = title; } @Override public String toString() { return title; } } Size.java000066400000000000000000000026361312550536300337230ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/property/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.property; /** * * Size property. * */ public enum Size { SMALL("small"), NORMAL("normal"), LARGE("large"); private String title; Size(String title) { this.title = title; } @Override public String toString() { return title; } } java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/selector/000077500000000000000000000000001312550536300321525ustar00rootroot00000000000000ColorSelector.java000066400000000000000000000030761312550536300355230ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/selector/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.selector; import java.util.function.Predicate; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.property.Color; /** * * Color selector. * */ public class ColorSelector implements Predicate { private final Color c; public ColorSelector(Color c) { this.c = c; } @Override public boolean test(Creature t) { return t.getColor().equals(c); } } MovementSelector.java000066400000000000000000000031231312550536300362300ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/selector/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.selector; import java.util.function.Predicate; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.property.Movement; /** * * Movement selector. * */ public class MovementSelector implements Predicate { private final Movement m; public MovementSelector(Movement m) { this.m = m; } @Override public boolean test(Creature t) { return t.getMovement().equals(m); } } SizeSelector.java000066400000000000000000000030671312550536300353570ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/main/java/com/iluwatar/specification/selector/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.selector; import java.util.function.Predicate; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.property.Size; /** * * Size selector. * */ public class SizeSelector implements Predicate { private final Size s; public SizeSelector(Size s) { this.s = s; } @Override public boolean test(Creature t) { return t.getSize().equals(s); } } java-design-patterns-1.16.0/specification/src/test/000077500000000000000000000000001312550536300222165ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/000077500000000000000000000000001312550536300231375ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/000077500000000000000000000000001312550536300237155ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300255455ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/000077500000000000000000000000001312550536300303655ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/app/000077500000000000000000000000001312550536300311455ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/app/AppTest.java000066400000000000000000000025061312550536300333730ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.app; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/creature/000077500000000000000000000000001312550536300321775ustar00rootroot00000000000000CreatureTest.java000066400000000000000000000103401312550536300353730ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/creature/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import com.iluwatar.specification.property.Size; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import java.util.Arrays; import java.util.Collection; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/29/15 - 7:47 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class CreatureTest { /** * @return The tested {@link Creature} instance and its expected specs */ @Parameterized.Parameters public static Collection data() { return Arrays.asList( new Object[]{new Dragon(), "Dragon", Size.LARGE, Movement.FLYING, Color.RED}, new Object[]{new Goblin(), "Goblin", Size.SMALL, Movement.WALKING, Color.GREEN}, new Object[]{new KillerBee(), "KillerBee", Size.SMALL, Movement.FLYING, Color.LIGHT}, new Object[]{new Octopus(), "Octopus", Size.NORMAL, Movement.SWIMMING, Color.DARK}, new Object[]{new Shark(), "Shark", Size.NORMAL, Movement.SWIMMING, Color.LIGHT}, new Object[]{new Troll(), "Troll", Size.LARGE, Movement.WALKING, Color.DARK} ); } /** * The tested creature */ private final Creature testedCreature; /** * The expected name of the tested creature */ private final String name; /** * The expected size of the tested creature */ private final Size size; /** * The expected movement type of the tested creature */ private final Movement movement; /** * The expected color of the tested creature */ private final Color color; /** * @param testedCreature The tested creature * @param name The expected name of the creature * @param size The expected size of the creature * @param movement The expected movement type of the creature * @param color The expected color of the creature */ public CreatureTest(final Creature testedCreature, final String name, final Size size, final Movement movement, final Color color) { this.testedCreature = testedCreature; this.name = name; this.size = size; this.movement = movement; this.color = color; } @Test public void testGetName() throws Exception { assertEquals(this.name, this.testedCreature.getName()); } @Test public void testGetSize() throws Exception { assertEquals(this.size, this.testedCreature.getSize()); } @Test public void testGetMovement() throws Exception { assertEquals(this.movement, this.testedCreature.getMovement()); } @Test public void testGetColor() throws Exception { assertEquals(this.color, this.testedCreature.getColor()); } @Test public void testToString() throws Exception { final String toString = this.testedCreature.toString(); assertNotNull(toString); assertEquals( String.format("%s [size=%s, movement=%s, color=%s]", name, size, movement, color), toString ); } }java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/selector/000077500000000000000000000000001312550536300322055ustar00rootroot00000000000000ColorSelectorTest.java000066400000000000000000000040751312550536300364160ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/selector/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.selector; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.property.Color; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.when; /** * Date: 12/29/15 - 7:35 PM * * @author Jeroen Meulemeester */ public class ColorSelectorTest { /** * Verify if the color selector gives the correct results */ @Test public void testColor() { final Creature greenCreature = mock(Creature.class); when(greenCreature.getColor()).thenReturn(Color.GREEN); final Creature redCreature = mock(Creature.class); when(redCreature.getColor()).thenReturn(Color.RED); final ColorSelector greenSelector = new ColorSelector(Color.GREEN); assertTrue(greenSelector.test(greenCreature)); assertFalse(greenSelector.test(redCreature)); } }MovementSelectorTest.java000066400000000000000000000042641312550536300371320ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/selector/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.selector; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.property.Color; import com.iluwatar.specification.property.Movement; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.when; /** * Date: 12/29/15 - 7:37 PM * * @author Jeroen Meulemeester */ public class MovementSelectorTest { /** * Verify if the movement selector gives the correct results */ @Test public void testMovement() { final Creature swimmingCreature = mock(Creature.class); when(swimmingCreature.getMovement()).thenReturn(Movement.SWIMMING); final Creature flyingCreature = mock(Creature.class); when(flyingCreature.getMovement()).thenReturn(Movement.FLYING); final MovementSelector swimmingSelector = new MovementSelector(Movement.SWIMMING); assertTrue(swimmingSelector.test(swimmingCreature)); assertFalse(swimmingSelector.test(flyingCreature)); } }SizeSelectorTest.java000066400000000000000000000041061312550536300362450ustar00rootroot00000000000000java-design-patterns-1.16.0/specification/src/test/java/com/iluwatar/specification/selector/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.specification.selector; import com.iluwatar.specification.creature.Creature; import com.iluwatar.specification.property.Size; import org.junit.Test; import static org.junit.Assert.assertFalse; import static org.junit.Assert.assertTrue; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.when; /** * Date: 12/29/15 - 7:43 PM * * @author Jeroen Meulemeester */ public class SizeSelectorTest { /** * Verify if the size selector gives the correct results */ @Test public void testMovement() { final Creature normalCreature = mock(Creature.class); when(normalCreature.getSize()).thenReturn(Size.NORMAL); final Creature smallCreature = mock(Creature.class); when(smallCreature.getSize()).thenReturn(Size.SMALL); final SizeSelector normalSelector = new SizeSelector(Size.NORMAL); assertTrue(normalSelector.test(normalCreature)); assertFalse(normalSelector.test(smallCreature)); } } java-design-patterns-1.16.0/state/000077500000000000000000000000001312550536300167505ustar00rootroot00000000000000java-design-patterns-1.16.0/state/README.md000066400000000000000000000033541312550536300202340ustar00rootroot00000000000000--- layout: pattern title: State folder: state permalink: /patterns/state/ pumlid: 9SRH3O0m20N0LNG0ox_RO2LQqz867hg-9jxNpKLpZLt2wdG2mrSYuoST1MTiuMAvAqIHSczKQZmCDhhuvcKNBuSkWm4nTMhiNyZ141BaVocifH6jlW00 categories: Behavioral tags: - Java - Difficulty-Intermediate - Gang Of Four --- ## Also known as Objects for States ## Intent Allow an object to alter its behavior when its internal state changes. The object will appear to change its class. ![alt text](./etc/state_1.png "State") ## Applicability Use the State pattern in either of the following cases * an object's behavior depends on its state, and it must change its behavior at run-time depending on that state * operations have large, multipart conditional statements that depend on the object's state. This state is usually represented by one or more enumerated constants. Often, several operations will contain this same conditional structure. The State pattern puts each branch of the conditional in a separate class. This lets you treat the object's state as an object in its own right that can vary independently from other objects. ## Real world examples * [javax.faces.lifecycle.Lifecycle#execute()](http://docs.oracle.com/javaee/7/api/javax/faces/lifecycle/Lifecycle.html#execute-javax.faces.context.FacesContext-) controlled by [FacesServlet](http://docs.oracle.com/javaee/7/api/javax/faces/webapp/FacesServlet.html), the behavior is dependent on current phase of lifecycle. * [JDiameter - Diameter State Machine](https://github.com/npathai/jdiameter/blob/master/core/jdiameter/api/src/main/java/org/jdiameter/api/app/State.java) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/state/etc/000077500000000000000000000000001312550536300175235ustar00rootroot00000000000000java-design-patterns-1.16.0/state/etc/state.png000066400000000000000000000425311312550536300213560ustar00rootroot00000000000000PNG  IHDRxSr& E IDATx}}peu:-CVqQx_3I֌<Y2X!80D3HyFx!# bWʩCJƅ-9MMHUVm}{~[}O:)F ' j@tJeX0'7?h2S h, h" h" h" h2]4R(m03RaiWZuJj X3KGȉ{ЬimYX}z+~zRm !tuPozt^1ݧ :sM'GVN!F*YH3)r7Q+uby]s%Krt|VLG[O_h`ff2!I38~~zkEw P"9])j:c ̌tRDFF]gs9OBGZW&_V`ff7GTuM9vsOmہ6OQUnJTEf'i\9U}F^] YdCI@?z[[e!Yx9{PUBȉ&Jivq1zk3 f.yt+WRi : ORmrI4C * * * * * * =Ѽʯ5~F8~]R>)7r.Dsٯ1˘]U,]ZgY.mo EFDۊ85z~l~%9vHI4>zez'Ov_}b/Rq2[hK}lh:cjNXhHͩ') lSKyg/~Mbͦ*G"ʳ]*4\li:cgN=Z#NGla Ɉ&ozKk_k|CϾ4٭`r'4\}{y6? u=BԢS|3aG}l/"ln7-w.ׂ~H43+L'q׿Q;b6"錑9hEs4qdS KעBN=M퐌hsw箾oݾc/erSO?;ecGxM .C5RSV1A(<(H41Fhz"(Ԭ8$DS`;Q 9_tt@wvO_鯾}4;7nۿи{nAJU|C ^ha>SS+#hEh4#8*NJ4Ŵ[37}~sz/=Ⱦ<^[zUEDvjSox: k|TNhYXhzX]WVO| UhRM퐌h>s{/6{9 G~ٷjM0 y&&pwVJU^tZ}-YF$\K9JI4=YQ4N/aURQr)L;%vX]#.ݿp5_?xͣ_vRDfOzj!^=@TC@zc("E :dXDۊdPN/Z_oHǎ^w2PvX%~m#~ϵRۥWCOKJL4,җMSM%)Is)5tusKt@4R);@\@DS@DS@DS@DS@DS@Dn 1xIJY)2ѤtCKj 3K (>ҪismZy纻ؗۮռbVJ}Y2.߁512'1Svߴ7 Qdze%rN7}&߲DB5(ǥ/wߦ錑-(,L4 Gοܝ5~B$`[eX1|oEHiUU$MgLfFjfq/} l5Y믓(knBr-}гBD338WR>45]2Q7VGJ1yB{Th`ftf2qofܯpy{s(3Bx$~+k]iQ@ds40,S>ahM;ЏhMs _[UAUꞤ錑-(,v $Th MUD!MUD!MUD!MUD!MUD!5 [S 9]RGN P@4U P@4U PDٻ!0\I CB( B(ɉ+~c'^?h`N唤D3uM vA@tR9U gTD)"S$MF3L5n{D ӧ88xrb E%\4t"f*Tc~fNVxzUu /DaN; ;-̯E4W}7>8qv>r%)sf;bN(M=Cufrc?$LUSm Rq3HZn7xgr>&ڜ"FuB*Ði:_M4w>5˓O? %J9x/#}埆cT62QB~%Cs9ݷ]H7߫ ?_/9fH0^~&9N~oNjW>]|+GiaYb0>t,T &ok*٣3 ƹCY}9i,{y80Z>TPsJb~iFسncbb;/^TFN hT4u")^IYBh`N5$f=~ 32d-fW!rH40SK3ž^Ga/ѡ@6(eH0ZT\sJb~iFK2Ǩ :3RYȵ ̩Ҍg2T"PlK\k9$Sq)aOibJENBt5rUX:\' jNI[z…\-@:4^Dӷ,&R0sU@4KBhr.2^DS@DS@DS@EM4^).x#x,//g_oLLLfS4R3ќhq4MѕVj%4J,y󓓓ԭ|bJ3GcY Yh CCCԭMMMQ 1>0nН=K|6nZZZJj";a Tn䁱$Ҷ"bl^:aeeett޽{}nooZE0w=+%0nEu:?c^ ,fmmmhh&###E˂c+@FMA_60cUDzKfxNk9l5oHhK9cN u+*Tٙ.Ѭ޽&xe,@!]`\%!Kd]PR$b زBGKKKKۨ)4dd{~@!-aϢmK;DErlz&bܷ8E-zL [ѰuM:L^v)E< aMX2c* P|ee-y&:NbbŝƳƭIu@-*🳺;]b7=vImB$ojw^!`hzљe6Yi_w+ _*Nz'CO{rᚭmI5 uB O-Iv`DS<P0L4;;;w չJ;:O䯢2(I!Qힰq``@1I#Ѩ~Żoq?i7=\5LuT("L4%owZ2s}sQ1A6LrgGgy?F!WM.[ȿrY2}S`hhD6&Pv&#0as *_iƧM+n@(}Ӡ}mg-I*lCahz],wv{:IaʽNo&M&~Z vo M_Slhy>jww2}cOG6^ö `h=ޫ{#(3:P^) T0.EHl̄1cxxFQfr$"vm)~/<̴މ@hT{!(3!`֋(3NCދHde $6hbޯ٦^A`8e~ihxxodONN׫YM۞\ammy,ѧGSzxd~/B&8s~GXcdJH==3!ɃOdEoDcAwc_y{1oKfdވ 0lÛ"0ݵkur,*(h2^o{}&pDuaKfؠ"6͕{U%ctVyrbfggƃ̙3ޒF:q+xD\a$[ne޽؎_[o\!8y/*`lts9xk}wUWͅ@݊*"LLLJ{x`u,&?W)"6hJo\lyŲT7MT @xIhwhhkM A?G -zxR  N!*D$ U/G4[x|. )V{1N4s@ޔƔ0tcDc'rTd0A97DbH#p_Ng e"Fdbh)unnx`͂uLշpC\ {MB* &rT&:C3"]zY;r~JqJ<ͮ9e rhtnEXERS2ѓ)D9AJ]`TDDXc{ZQhHc.QWBLKb0"{4"obK̵q.K9tRb{"p'e"U%jDQ D,sxxz7DCR h/L!R,@xhpihhDOл /}ٳgp D"aϐv ')%)> 6|?Y;Zl5K!oU?'Nb@HI +Dsٯ1~]U,]鯣?F[wkoцY pлy#&g=^}/~>}w\)DJa-Y.!.//'-+a#|=@;_z?=n esʞfs{h+10:D!6  =%91'WDsc7=m{CϾ4٭`rilm5j2{/YVBemJcXshP+ьbv&)+tMְh;1ћX lY^ս?F%> QyY!9#Ѩ ɉD4;;;pЏsE4ld4K_z4?>v?y䊋^+%.yu5C'.ƍC"*1R!F>‹hVVVr lZ єJ-tz;-5RZx!flBdaݻw#L0G7fؽ2MJDcarrș!"큁X-!9+++@殕U8ݍQ.n S&Ǭ|kǛuq)[%@J={l ~n7cMw#i:9n]Hnot*Vl-w "u>=& xo\<-xGh,&5Qryj 7Q_^[O ӴP #K4\CC4hB:iq:I4VFA%r-q -';'5 ( %EhZuϗqs38 a'N!^hҀ^s4nOK4\ H=MkiKV&%DdD{n) R'vSф:2^Ȼzk)ptT!wI[!8[UQ'[=!#el8(R'6t kA@ NDJe>p' f1FEDΔ Y 36‹d`@ȣֽ@xM)R777u0޽єJ8.=P$`̌S  <2";)A4&77A4RA4g_:o}dDSRdԝK d{kM)RϞ=;00X`&KSSS55x4ՖKVW{khzh,l48ޝWM)Au ' R@333I,M#+W?O?"~ DSJ(u{{hFΦ_>. $ _r,)%+p?*egչtM)A1I /G}p -;D9}ϛhJ x'$:Y!xunl='jN>E8MKZ+$Ťhu_ˇrđ%8 %eQc:M^xS?22:o~~DS5+UG4蚛ݖ,QI4qT\ÜD#LGy-MThn 7h bnnn٣/{a][lD5nE۝Nqƣ%?D) RX!n[_>zv>H:V5Z2"4\ #j,/?1DSM+ٳ/__o E%gKG"3HoèT ^ڽ]u4S3hJ z2bs=!`ʛ'u)% Ѹ2gTwfrr,- R^̰67Wt !%Ż{ R^D WM4KK{אɑM)AThkkׯw Yz W7t YM)| W*?G#AAb<tBE)BxO$ R^< 7IH.EKdJ4>~)% .1^ v[EEJspD~hJ za/@ RP; 9k5~kG8QLSԆsy ䷒( 6 DSJ+5@4{XlaD-YB 0}b_N3z{ [u&D DWjh=Eؓh2q&=z𭔨N3F._X.?gG|e4tmrr DWjhvv^W^ag%|Gun@ &*SqdAVh?΁ʎh:}єJ׷G*J#g9!MU,Amtʱ$,)+* }ƵTZd:cw]@4 z*={v1՛M-5!L_osjCmqhZvs~A4RDXPr>[@4Rus4UBcO٭)%蕪# KC--Ւ Wh؀21DSJ+Cq!>@4RCŀ* k M)AaIfg~qgt)%>t:(h)%j~`hY  ;}G!r@4RMFeXD"59?F?v- R^=J#%|hi;5;ov@4R{"CCwlHz)%if "d, DSJ+5ws4I)%LL7;)YmM)A>Ѹ23Oⲱ#hJ zA4+Lb1\l]*2jAݗZ R^hŅ3\o}dV-1)SS2>DSJ+5hZ=/|.CctAzgfgԒ Wj\/do~k}ܮ_7]N@A纱ƛݤ ʦ%deXoTA4J͝?|S돺r}d^jnbZD駌+^% ntds~d䣁p o+UG4ﺯ~G^9H</>V@?gFߓD)DesjWh57?9y-eY}T**c% vxI(I%&:I R^:9x}'n^j/@'].mFs초^XZ:D, *^:aOUO-ʟs{ܚzc*Gh$۲A4UR I_8;>x+F18 #}%^/P2:t^ZD3:/}hJ z&N=k03s%CG v|,&{Zmwd!h؈.Wjdpt=dR7V`ETA=Q5/_K(~& Wj{ڳzzd|TU3(儿ur{4' DSz+5{YG׃0Gf`ܺ3MIA4{{77<1&W|GWjD|Y}* R^)M'T21y4M)Afxӣ)yyDSJ+5=Y\{f yɏєJ8.=P$`D*677WWW[hd_ݻWVVlhXng d_/cۙ%'#]SP~ett4JjT mVt'''*J"u+:ed\f5JF7ẹɬ:A%&'^__Ϭ(P*D<11Aۆ\ VQA6E4Thȑ"% \ZDIY.$O@Ffgg ڳ\DWlBDӱz;2llooeZD [֡I2 .a!v9*& Ѵ :_D݌JhH!*G4¤l;&\ [$9#E4qO[e β+7}#nK|22WnE45jV)<5 ܢrD#B5vvi XCXD#D޽{C-*G4G9 .͍A&& Ϩ`kIs"=-E4 <9*J4β=G#8sTO@O( uy~v: I MﯷÈfnn sTh&&&>3KQ-0iH4FciiOaDɏ Ѭ16=LE6FR99dTh:VrjJDc*ͮ]tT'&&&@分ajjjnnNN|yF0rFHpuݻiܢDӱήgj  0&?]> a_1_4@QQau@,F~ f蜩H~h?@+ (t4l;KKKFH/aj@ ;Dӱ\x".90![!fx30PP*MDɕԌzv@oO  0 z{P@4Y&̂ޞ@49 `.lMk\Rޢ 6.DPޞz$k!t?硹 vuyt`]Z{֊7婏75JsJKޞmTpCnfלӥ/NN}y}\Xk6!)̾)Ddz{E4FDjya )hoE7-J+eʁL] qA4@<a0Rz~?3Ob-HNDR*ES@%hޞMeWjt/('M5,ڣ s4@~AoO=-o 5fR,4x?'B~40Gc'['&J8쬍zk)֥##['ռ`o]̂ޞR!H2fAoO  0 z{P@4Y&̂ޞ@49 `ɡh'MD=hx?m<7>ͮY y@4@9@oOy o>W_}®Y KWoU `DN4MnzΣ맾7keYFjod=M ߪ?,Cm-DչeǾrv $f6 P-,}7_bnҏ^ڲS37$GL%zy`6;@4@I@oODśNuy ltx/waQC1zr +@4@@oODӚGӸ?ݤîY O._rstwUCDCvӥR-vXDӍ`WtY'w-K.o&IQJUح /w߂h\ޞ!xo\<?&!ؤf9J+7o)- ʟh2SD tZ&[DKsT-qH@D@A4YS<te ߪDSHR/Dz{J:G4MDfd>lM351YҖL.J*Du@4@.@oOu !PG;ԭޚn=!)CwI[!g"9ȨUꞀh\ޞ%Ĥޞ@49 `ɡh'MD=hr( , DCfAoOր).Rhjh'5x4Q&̂ޞ@49 `ɡh'L ̂hjh'5x4Q&̂ޞ@49 `ɡh'MD=hr( ,)#^`G,7ɎU9=jˎPۢ ̂ޞ2$^hX> -'VE)qs Ddz{ 'V{ iMc;!+O8كޞBo}'?x'^;.GMG!0Xr~ll΅Q;^ũ(xO *#ޞtDs_<`Y@w,*{OQ wP$8B9ЭH>IWOܙVrsoޞtD_>|#,QvFݘ?z)&2d-,W:[JWxzT?(Ε._Xs[ C' ۓh57?9y-eYM3AQCAoHsΤلD#U$MD:2 + #wƣgf0{Yvoy4ƉFmp#Az2T#nVۦ2|q+u壇a죔'|2"!JglKs+!ΰ(е` s4@@oO!D__o u+BwU@;rI/TBꭅpx HotMw[fLã2= :h'M IoeZ@4Y&wg: 4 DCfAoO  0 z{P@4Y&̂ޞ@49 `hΦ)G=hz{ '"eM4G=Mli8 |=4t^M sgW."hbޞtD=a/An|:O\x X'aO\9!V:x X'aO$a}/"hbޞJ!xi 0 z{*d/mfAoO #- ,DS2fAoO  0 z{P@4Y5 g`J T'J D@IENDB`java-design-patterns-1.16.0/state/etc/state.ucls000066400000000000000000000110731312550536300215350ustar00rootroot00000000000000 java-design-patterns-1.16.0/state/etc/state.urm.puml000066400000000000000000000014611312550536300223460ustar00rootroot00000000000000@startuml package com.iluwatar.state { class AngryState { - LOGGER : Logger {static} - mammoth : Mammoth + AngryState(mammoth : Mammoth) + observe() + onEnterState() } class App { + App() + main(args : String[]) {static} } class Mammoth { - state : State + Mammoth() - changeStateTo(newState : State) + observe() + timePasses() + toString() : String } class PeacefulState { - LOGGER : Logger {static} - mammoth : Mammoth + PeacefulState(mammoth : Mammoth) + observe() + onEnterState() } interface State { + observe() {abstract} + onEnterState() {abstract} } } PeacefulState --> "-mammoth" Mammoth AngryState --> "-mammoth" Mammoth Mammoth --> "-state" State AngryState ..|> State PeacefulState ..|> State @endumljava-design-patterns-1.16.0/state/etc/state_1.png000066400000000000000000001021361312550536300215740ustar00rootroot00000000000000PNG  IHDR!I%IDATx]\K"*]c7F,QQbAb%K.,+*Ƃ,5Ɵ1DMYػ}gnvv{oo&@ Ȥ@pALW_m$XNmÊ |CO1\}@׉ YQNmEBu"h(*Bu"hbA[*ajj´i}˗/^\1_8'VQ:@QNmFy6rҳgk?:Ši\F"((}WHR]!F :u%1164tdٲ:thQ*7%"bJ %r|zru uk0kgeI?:Kwknw@&|w69/2DjCyo" ֕l%1 u"hj1 ;(Lp6 CϜY2qOnӦ>k٩{kLm&ѣ+JMdlհݻ1/FzvN8=Jbeu"hj1s",]::%JSF…͂!><8暔i\<݋m& hjUoˌ"ΝsAE ?ֈ//ml˕( DTog *l٘'O,T1Jjj”)}ʕ+VP>4\k02r&֭ Ļl3&?kvkP"e^:5iROO<9  1A3(/GV]'6zfV͟5WO\~**o܈Κ5Kr򉈈)+%IJ%YΝm0M0@d1yDD G#2lhjM09uj-W/[IBtڀ l6O4iRcM*[-Ѯ]CCtИUBЦHOBRRfX1DBmd} %֮D(=On֬VJIThôjCy$F!XNmF c^x='{֭}5jZكr! lЄ-4e„eqss'`Qd{@,- ^5h(NNmFaarܽc;i= `E+D($bA Fѳht1E+DQ,(Z]'6@g!F :>X9[/2jTYE+Db{Hm1!j"klz/_`"ּzuȮ ʏht?ڨ1ŌSv˱SkD{{o$%Gqb$:ر寿1Kr qΟ]uLE+D8a|5F3y$D*/(Yd#YVa5<0JѢDKQ]'6 ;b kV>½w|gh Xc(%JʗϭUw?A'ի2G6/X0_b"n@)3iR3.B,RtB&Lne& S{F}ͺK_֬Y ,Qo<=(/(k@׉ p(~=V?*^ }Bn_sF2(.4 ;v/ jYz-Ps k/e۷-Xos FִLvmXߴi !BLo^1KFy̘ sb ĉJO'\ Qslakbw*4lkRFP&))6k,o=l(bf~xۯ_;s D>OKߨޟD͸UQo-<,pu?5z֋jڴzD)Y31!"G-3QWwP@^F!,dV,;px+9OB Q><'?9#zqOu1.ՙ口bK)Cx1R(-Ac}֯9EP*mlvJvР'NQC *ajj´i} ŋd{;z(T|yMΫeHDxQ^g lodBCWlWQ?>ʙmjxQV'2 dO%ZTQzlWmifyBﾀFV8\1`1lHy-kuZ+)){&'q#%rnh'!O `БeСFYd)1u^cD[{gϙ6~t,9(ܼ=Y/e]{qwYx!5P{{wQ$?qxcG yV!F=|x ._fRQpC3Qs  z6YN[fl3Q]Qn"eˬ }1;x12wn+Wְ~pu,T(z C}K*[)(|vssEi\<݋m& hjUoYDFaιϟdz]LkD*Ob= yVѻ^}֠oR^˖y$B%QRSLS\BqʥX31dk䧟tu.5A(=zujҤys bZfP__'K$?7Q,)Z2Zz7~'V^=qq#:k,'""TXkϞ*dgN:wna4m9rdk1.!(= J@h6ԩP_Aڿl%@g!O |z l6O4iRcMbF,Z4]!С) V`k&ʊcK(tF0WPbOI"CxfjDe?Lk678JEB8(c^x='{֭}5jZكr! lЄ-4-O>7"X4**ZLkO~qqm8m^6wᑥKG]p|?9ލ4cIIWϞ}mi 'xqӸ 2XhB8*,ZD}ڠpҶ :C5j oC(9cVFAzKT(*@aҤ81>> ):4*V|ݧڼyV"OqJhZϱccLkkAVu[7 9)e˞=ÇG_ k+WQzs (eإC(CE$Q]S.GBx^@!NGm?7pݰ%.n%]b||t<9~`X |b= yV0QH$>K&G~9iQbnZŁ"m>˚5  O1(wYݯ,[X1vLzzv Q`06 7nGEzIlӸ },i"?OwWRjZ𽓪_e yVl-!?g]^@ALq!O QO2T/yثp%)Z1 6Fq#7h+m֯_;T޾a{>/^ps=?D<{u65BhFɜ٥Hϛ76+T(HFII9[c 6MV#UO~&fI"DDLv0M=z<8 _>-޹zugՋ\hDGÊ :4Λ7CFc;6e:thI҅?#֬Y矷SZw@(+?}Wp~pDS1ʋld 5T 1=a^7`i֬۷-o(/o9C?:h^qq4okvUV3ϑ#Ξ y<_rssO#:098ӟ<[o߈;+"K5mZ#>>LuDS2 a:ajth (GT)jxjjޅpE(;w΅K~" ͛O)_ Qguk_ڶmGN_?NnthPÇnnO~ u% oQ)m߽|ۻ(̏1Jbb,#}|FquN3&Fʰ |Jz>ʕSwr=Ÿpܭ[˵k?qjBS2Jx>}^)ti[X؄ !Oɖ-,22rfJ%Q8vlxsYxK+T(¤I=q"fv`tOСGl>GeGŊcC7|}=oJ~b=g-g > [TJ0FAᣏZ|:55(LdPP>`*W.%NQX+Y>:bDѣ@"eq;̫X?'Nf6, z=;92vlt~5k׮xn0 szb (0ʓ'q៘Mcǎ9-Z2 q=ZiS ^QL8:psYla>F3 q-3_d)Oӗhz6eYlYW..fEFhwRvmzD"B8Q kvqna}ys''0 M,0 ‹A:"Qj޺u+CbAQK ˖`pa3XD0LQ@H'œ}8gȞ3BUP)m#2 &ʖ-]dEFj⨐1Fќ9߆zujƌ${lne\sZfLs!O ( i^/Q&ܽS7>) D||Xz>xm xxbb, M#G޼yӨނ}6[qWņ7 5j 2 Vѥ?`̞=(W 0 uu^X\E5kYҸquMd'OǏ99@gیh*"X1a;9"?Q=ɓgĈR^l#gO`۵Ơ+OJ $3ukʘوe3߽{Kĉ=7aԳgkL0}{JCN,'C")ZU"`?;f=m,]0:o݋0=,[)މzQoH(<Y~x|G, 5k\_=KϟVнS 9\SŚ!͚ʗۻ($Wzm\MҚOO1{Ag!O fk PZSFŋGɎsRSf~?tB~b=Q,)ZU4TMӥ5 R4ȣ`|>>e[l`{'Ag!O }zؚMEٽ{1+[״X3ÇG>S壍PP-oAwa?-W |z(kr2o^^n5kV8wn#gJ;р&l+ILYYzHRa{Jhe;w1ǚJ&z{zhQ0͛;6v`Xh⑥Jy +eϲ|TE=D\N8fOIGQSOGWի(Kd1[筬nl;Iks\-Rs޼͚b{2Ⳳgv?t^m%CGMňQLm$KQI)I)'Â}nT 0>ݘ6mcN8 Cݻlu{2sfaB^o@/;aTTŋjU(Yd_vOF|֬Yے%]*m%/]Ped"e}7&Sm5 1-Y9Qv7Fie_F 0;̚1잌=:*~ntٳ!Gj)&e}KQO)I(vֿGg- `TdĶݒv+ʨ6X|lUYDEH3"(m)2 K1q4({2bTUTEKqPl[)(]~8`OI /29t}zXb͚uWzCPb5i/2G/F.۞O[S!ӧc7|){`Q*i3}&kۯA01j9ѳd[IZ龍ҥ(졉c$O l(ž<8 _>-޹zu'| (0 4ر={n]ѹnMF (=oYDLaްXgޅdNKQCyV`hg xq%ڵ]ժEA ͟?}_yeSkdK49F1iQ){ސAM]e`0дh0 L_fdʀ}Zވދ2 օȓ'׾q7`wwYx!Uz=URΝ(nطoۭ[Y={/{NuHmВΝsT)]DQQ<A(iQ[7Q1AGVl-[f5l{nŋs^q4DJB:qSmgԩ{kL=EHk'G~dz]m׮yo{x]'6`QQvF0JlYVWTYɒ^ ?PX؄u+'&Bp.;K1'%"@s^)ihڏ"S5Ǝ$F!NmX֍`jʊ`KzujҤys 駽qP|ܸ-T02r&بuכ˞NȪ-2رAFCN%F!Nm #{8nF)P /(}`qqvj&H ;'v,(oÆia[_SѴYEFYtP(@׉ ddG٭YS4h+j֬VJITbc\ϜY/)F"E< Ο+ihڏ"FPgϾFpCBt@p4ݺV[rR^eck#:i׮!UwȾ|X}}O\#(RF6h"5=Eb'G~LՖeٲ1n .]'F!Nm {8ۺQ70?11VZ C\ bz;9Z6/O0sn!F :'Xa;9:htڀ0LQNm96!F :b= 1V@׉ YQNmEBu"h..H t$''O>R[}V! d˖m7oT[j F!PJOOO j2q#F ^'xQxA>"EԮ][mRn>|ԨQy!^!xQaزe dĉ;v쨶RFϵvB ?~֭["9rڪp}(Q"115WBBBV n0πd_/_k׮N@*jgu]zJ m@p:̚5K0ٺuzJF>y|\zǀw%)S(;NR[?7U`n ooEUI ?~4mpppfRSSUT`nqp̙\3яR~EF @LȫY(_O?AОZd ""LJNM(, ynQF O͍=Zm-Vm@P F yېJ.ܻwpG\U%BpppM;V~%K-+LΝk7_C>|H"?a%ԩS|˗m`.!//˗Fݻ4h7o^]1J?)FѥKXF eQٳg>s {믿aÆm۶mȐ!ak~XS}ʕǎKP(p=z <@-^ڸqENPBΜ9W)S0..)?[Dcǎʕ+wСҥK8Zf͟b!!z>}`wβ&/^ Μ9 `Tn2ZjUPW^ AB 0N1cڶmʘPbb W>>>ib(&c5W\8umLѣGVRE0gXf PVoHF  -='?,AAC~oooV?eʔqƱ2LNQ1  T\Y0 |N|tĈ y:a`|Zl^lC8GB^~%99f͚VR[B% v0 pe47'(A?p]1 vZ___\J!QNL yzcqرjkAHtg=<<" Cr=//X!X (+DQ#G.\Ԣ"G%81'cƌ]() oo][Fe]4()1{lt(¿r]rEmEi@6Jp28?MgF/_^Vd!XmLpțBjjjkA(9 y(o.TP||ڊB6Jp8wB^1 \XAdù"QڵkW ȃlm8}B^1 óg*Ti&!Ȁlm8}B^1sϟ~S[1F "Qի"7@6J*tA"Ejjjf͜r7MlU8@b+OV[ %hIȋ F1ETTTҥ=z"@6J$A"~Km-l=*!/E?޾}ڊ^l18ր;OO?CmE(Ao y(0{&MA6JtAb^jРVD %h :Lȋ F 65F >"QDdddr>}"(AmB^15޽B %hMȋ FIII%JV[l9!/J:u֭[j+G4='EXSA6J:Oȋ F)))uYdڊdA y(իW=<<~'F \"Qҋʕ+StH% F;v9rZd~A y)Ql-"z(SPB(رc^^^wQ[]l#(!o b1a„m۪.@6J71xeVA6J3K& '^D'QA yYdrvF1|oH4'Rtr%h)QHb)(NA y Fqy:(.(:4 28J?eT Ӧ-_xr Çw~8OXSFADb31z 7*) 8׫Wv+g=[չw/OZ7bDA F/u%[gqrU(:oURvr. Çw.P /m*E0ğ9e0  ܦM}ֲS֬(LGW,%(=l2aC߻wc.^̝ʕ5>p`{||)|5 v'QšgFqʤ9pP%ea'ھ}BKG\)(_?lఛkRRӧqyw/F(UeuE;炊<___j۶ٖ+,NnF"͡J~εog *l٘'O,T o:ʔ>0BqʥX31n]l3&?kvթIzzzqw9lX'Pi Ay||/>B68TdJ*:R89TIY۹kO\#[z맢ƍY$'RbIP`HTT:ܹYP߆ C D/Oȑ=>>LAPp~xD=jM09uj-W/[gqrU0 %/,\gn`i%xI[n< h׮`!`6Exb-4eŊ%J:wn`,k~"u"'7kV+%$*[xaZV:YFN*Z$C귔1Ǽ=lt־5WbAr6h2aB2eOzD=`- ^5b68lTwR',Tg&Ys֚fqzxk`ݴF]!F7zJ*$C'B^!Fj=%UtNJʂEBb;5zJ*$C1FvpkTpUR:e!F=%oUR;9!Fd:oURv`iwoʨQҜ@Ql1NC]kޥ AFL3ۢ)/_8?策o p%(E'͡J~ڨ1ŌSv˱SkD{{o$K*{.d{;aV/;75kժ=~'#$'pV68*b7*) ;9s N>paOgsC~^T'I3fmTqD89TIYɹ֎15S|`х{FksѾ&HOys-zVVq]2ݺܲeVʥ<<܆ -j۶{:-ǍH0◿ d7 t]m 2S…XW6wnʕo'uV[D kWtu͎2}$>X1xpގ3H~} $vT)㻝?,Y2|"Xd٠ ?f-A(̞=68z!KBds/_fY%57r8|ssM =:F9~t)}>}Bn_sS0xwc/W2FNoQ. (#h` !\.]eII]T0z|Xhmc@dB򉷳^=qʈܬY->DhAvӕ9w$Kf8@JӲi="EK§9~hEC[fukcOeQ;6ΝC[/;*1ѧ7s(e i}%#/Bc`xE#FHMEÇwdAFoURvbȌU?[ԥWOg\WWg?-"HGa&ڽv Y`s"E뼺^QFN lZZc6Y`NɓiM¡=[ fn՝Zbp"#{D dFޞ>9:[XW^S\Qlbte 0G\D!_,&dx۶Fṑ>(6M7(LopP%eaWF : i2/AxNɧ݋  *bV9_g^ŧ̓~e`obe6jj?>fvӛ94ʣb.g.ǒ[ُ ( ggd)h4͡JތboY_ڳ)IlrLaTW;Bb;a \"\5(רQGUΟd!'e Ε+駽eEFoURZgg7|A%0+!jmv҂y{]`:+"(NFo}P0(qxhA:d˖rRГ2 bŒ,ʙ={PΜo2F,(ba?2s(gL"BoK:-#0 8 O\)]ʕQopP%eAQ!Fv5z28sy<쾊$1n,7r8|s FѨ2z7*) r. 1 ׉p8|spڶmqm8£iÇG.wRQls=I͡J9ŋOeQΟԮ]CտBb;IoUR<8WJA:4kV 3?6S:vl h*WC ki 턃2FٹsyCCռySʗ/~fչuk_ڶmPZYJPS<8lthP\blf8*͡Jʂ ܧEW/]6aaC~}sk˖Ylș* b2#0 [eҤ81>> ):4}*V|ݧڼy&[!F<=C5vlt~5k׮xn0]_{zٳڷo$"(O1FAӭ[ˉ{1EwBB!nףG6mQ (Оm6̏~ä9pP%es8Vmvmט1AǏ&6eț7wr 0  4*!B\)ԨQuV$%łئ[: "(T9ۨ':L*oUR<88& ={u>m@lUlsr% o2ݻ1Uzg! bs_{J||Xz>xm ڀ&&Ƣ<1S7'TpUR8UFo34ۼzu菽aKMQl?Fo*TpUR<;!F<=%$CEbAQlFOIE;9 'P%esXbSRNN 8TIY\$voTTD89TIY.xFG&D͡JʂKbAFpP%eAΥQ!Fd:oUR\bAFpP%eAΥQ!F< FNK̼D(}H&oUR\L 2z7*) r. 1 ׉p8|s Ҩ2z7*)8໫uIJO}IխEBb;(yPfd54ߕqITRu.QlFOipvqqQ[""9q2(ϟ߿Huψ(E'!p8zuXlkȑeE<<vcw %("v iYFGzoURk܁f ޽_Θ8Gp@Vs=Z 9_>7__'عs.b7o(1GϞ[zw\رl-1#dkǎMvr913իàfңqq+Vvw١Ccen]P(Yd4ʕء%b9j૵hի;7^E#< >4ߐјCKJ.GVvӧq 7]vPP'͡J‚s8綱_?{RR,"/ӧ믯0^A=M5ZFE\YV4LHX1}ڴ{.ܲeVUY0kրYYdԵkCmȗ.mp4+q4ѫl+U*Y, ҷo[ c˗e:WsqF2ժ;{v(xG5/>Fڞ>9 `eM6fYF&[7 %MC9Α#]-*_?5 +#*vꚝ>fLP۶ XAY> a5Ї}W\9ѣGWTRZuk)Fo682(tX*/rav+ hvl4'V3(h]p0\Y;3h?r,oQi {La z ac(kw_05*p„M"H-\9᥍U Qhtٳ!.GaDSg*6ϨK<駽AW8$ (>j;xpqϞ'sM8:nG w|tĈ.b#|2!0a=iRO 682r׋1x7on=Qп!Q((Xl,9Wl9jx+ޢR?1%<Y'"DFlVq4Q*U*)v{|?:C~bXwU"XDĔKӗ8g|֕x-ŨH0D' 茙%x3Bt"2lү&(Κ5e˺qIYkWO,Nn##C#FԩS fLsq^pQlX7=q0bvBFd#'P%eaιEn3$fF@^ .Q<&IOtss\ cz&5d)S*,̜ٟQQ!ލ!8ѭ[`@0²e㳣03љq kRFy$Ngqs3(8 b*9cFGf1bHP(0LFe{fdsq%w SnӦ>&ײ&&b#x+>>Z›w((Xl,,8Wu^Ul}P[ MKk.RQ p% a:cwx~V\ a>*V0B01{ A<{0x|ɓkعI5v>,M;?(QX\]]"#g2 yz1bH1 F=L% 託n g71ʞ !(%H6rURo3@B3kg>a]f0Ub.(㢈,~sGa,/gT[\HyLYmQlGFQ0FlN6O6>eW1 %l,aLLR]h3t0L Qj1_<?Dִvd$yhGa"!pFEȞ+(gatǎ9FBF&i&9*) G.Hq.[6F[4./n 2۶m!bۑ9F9_aMk.՝h"N$BF&i&9*) ZHBb;2<4(!0P:-1 b>FٌcznsK(4qb#F(h]p FѨ%Mv\A#Z=W4DJ6s8|s FѨ24C9Fv[#Nl,ȹ4*(^'͡J9-?RbFOp8|sPܹNbŒeR-,B|}п(aիS/dvD89TIY8ˤ !MS^8__U8'Qt",ҳ LuB(eoURYUvP8WyYoE`"ogVȮyj] hsfAA~6L̬*]&"FȪ-2ҥńʗ_ֹQl%5<̈pURYUvPGA~>  5ra0욧F"E<,II]2LEH]ШYEFǍp^UϞ} ֹQl%5<̈pURYU['V[rR^ec c֮]C#fcld7]tKG@@eR7!#N1U[zKyٲ1/P.s\(MfI8*)/*N(D70a[Jk,/*+I5j3y=nvPPÌ8 'P%eRJI5 1FqNJ EwT :Jj4y',Qt((MfI8*) b 1䡬(Wsr6sNqkz>rdwQ//5+;њu]Ql1NC#AYII9U X!oܱQ~#KJ4ĺ(E'͡JBeXϟԣG;㏯s"۸cǦh ;-/znLَc!@ȂWiS*T(3ʿ6<Jb;Qt",_v.ӧ ^U1ك.dӦ?xp1.߾RauYࣗ,u.åK%gά~Jb;Qt+0eJ|m׈4+1䡩h"y^pP%e2 qķQLƟRkժ oqCDĔKӗ!NܿVu%F$7*۷oϟ?_m-tE'͡JÇK޼yڊd1NC8ǣG|855UmE􁒇:4 2XxyyݺuKmEtQט7o޽{ւ Xϟ=R[=l5VXQv픔Q( 55… oV[l;﫭 Fݺu޽Zd3gC;(iꫯ(Ud `֭˗ڊ b$&&zJmEt Q6_ F[n.\xj+w19 .Yn]\\ڊQA||Obbڊb %h V7oZbYDEEծ];))ImEA6J h( W!Qo :Çj+h(A{1cZ8(F;vŋւF ה%Fbڵ?3Q&ѣ(]HBdBoH0ܹsgذaW\Q[ F 7|sepQgϞկ_ڵj+B(AHMM}Nr"F!QE$Qu%'',n'_|m۶o\j>:"0D.[nxfe ǢE(4>jp`tiRSG(*k׮} ٳgW^bwTQ m$IތoܹS쎀*> x۹bBf#G={V^> xիһӔ+Ԫh ɗHc L; /(={ m‰QrssO;^.Q$'FF Q Yz){Oy0ʴiӦO.v/#}Lpp_-v/䍒0gRG 7 G藯nEQrssG?Hv@`ڴibUQJKK}}}7m$vG> EEE>yTQ=:xQ%I={?IQb/QZhARGo߾-v/^H죀#ʞ={fJ({MLL@HjB6l[oݑ*#%,^GhF:(dݺubH(~PDQ$4RPP#vGN> @U9}o\7J(wrrZ~Q^rEQ~7Q!F n7ov> v'OݑJaFINNn֬٭[-F,X]^T 5ӧOwq];th;w݋1^ u@[^|ݑ 0R{xx '> v1(ꐐ~3Ʒ bcc |Ac4 e|c| xi@$$$t`o&6.,]tbcG5_n .,**zQp50 :d.Mk^Q?ޣG֭[><77Wg?>jԨ˗Wۯ¹sƌ#=l 0 7nL:/ْ'Y[[P vvv> o׮IΝ鰫6))ɉ>I+XXXϜ9[^.\bnnܽ{W^.]aL``!C^⃻vٳgvvkׯOrdׯK.^H^XE###߿ڸQo&׫iӦEGGQ(h}n:..PL=iiiT訸6,,k׮吇(Qm\(7n7nZi([tQP٣*skɵPoڴ)E !^pFYYق 7oҡCQ `+!%,[?dyjjkD0#(矿ȹsӧOsrr#P!8#<<ի2Ӕ۷)777{D(6mby2_ݺu5gQ(˗/W[lׯy|0`2 ֩S'33s͚5C OOO[[[TԠA/RIddꝾJF9tP׮]Y>55Uh; QH111___{{Ĭ, ٵkdԩŒ׮]gD4Jzzp/""/(h8pcJJҪVZz뉈FYrb U8&VƍϜ9SLSLYjz"QN8T(#+`(hƍׯN"Lx _Zȵ7o[gP)"""5j{Ogff6l0##CQ(onnJ&\ <|p„ 1110`*h=C,)(zP(qrrI06mjҤɬY P΀b!La=3@!V\)$55<'Fʰ3`$n)d=(EEE5޽K%M6E%z0 /;5|p]C2WWׅ 5'Ln|3`7իE Qt!EuFW}( WDFA 0j/nITMԗ]=\BQ$pb F<`ѣ#wF 0%7'jjAk7 N**:Uv>pEsNjn+0 j߿ܹ- idֳg'*NÆׯGJOΟJ_r0 .Q?N akkzvB%/h׮IΝuLܽ{)ojFrec5jlIFC۲zǤ NN6ff&Z/GN0ݽsll,);q):uSj5)O>F`1JFF<ě53'{BU*:j_Ay2G-[><9ztM橭j:רQ}ѢzxtɯT{jC׋ cimJ5k~p*:׫Wb_RФ-;0uAj,Q?h8}}'5(@NQYFuJK5ii;$/(24hP/??Ӥ Msr(TPСCYϺv@MQqc ($gfƫM;ɪݽw6 K_ a\Pɳ^]\۴YI RV`$;;QeJÆ ڷoA/값[+/&0!ǑQX5E\PߤI7A*/K_8} B00 teԩ0wnM%'oR[q㼈THGZj_2%[ONƌ۶@"jFj/tٽ{d֘Qnn=z8j3g/K_0aB`×.mcbBD]<9y|[Ě5CdQ++DuZlڢEhHy*cJu&O<}ԠA#$22ѱ-FQn_^εkQ6mt`jI_V{j a \Qrrt:.$$R twr 8x1//#zj1])$JKIq9نRjRBCgPKj0;L(5H 0]<'3\g5*YMme(`2x͕;XRaP`"y0 `CH0.Q !( F1H 0"y0 (Τr&7vSJDpFd?.:婄/,Vz^%zϞevx{gKǎo>p!7YY56'աBjYYFcn^jٲee)0 `"eةc;%֟gK qaڴ;w+Y}k֬A 88SR]U?:wŷv)<F: @DL5=߃"B'f{*[r[')>L!EիdE捄Yٸqޮ]K(@jP_( Sכ41S;{^ 0qca;=p+%֟W(ό2~PbRzzaRٷo*(=~¢1lT(+V|Bw0&ԂQ.(C5ia|FFQJ(Mmo͟|2of ;wgrܜɱ8*Q KnswV]~aZ w/]aÜ//u_:yT~jx-Z}u 0э"ɟ;l' [^ϞysҜ2`? l{X0#tp! F<`0!$E`(`Ƀ\BQ$pb F<`0!$E`Q/H^uD.0 W`QN=}FreС=E.0 W`(Sx/^(,<9mA')iUۻ?oK\\)8jҏQ[b'23)NnO{{봴1c ҩ-IK˦ =:j;;#G(@`([|>i`\٪U>d$->xХLF6aITTPeDN8XhAQڵkE'O #POO Y&OSM!FQ]sg{ｭO(\O̞m[8y~Xo(ci11qe.]6|x/F)(HbFgݻlwCB>&Cddcܸ66FQ]E}h 0}%!!dΝfܹe9뗔&2 M4‹)S<_™QzTZܵkJ|&sLKI*2 FZ @F!g 17))=;1i` ķs'`2$rք|vf-ehQ1 ۺw㼼 ]FE&/t:zxt.((35cϥ0ZB:kvqc5EhDÆBӡC(v,}(fYϺvq"%jB fb7Ξ֭-HN%+CCg8:{?~wGX$!?)|VB[ի[K}Q <\40(1h鱥MǗ"*_]Oė.m#IWϟjoo-+/&<7o$82 jRBkqq_֩S &&..JRZDq %dĨ}Խ`ٳgbΜF 0bj̤3cKTXgɒ)`V^BpįQT+ G|2;Bed[>[EBxWɯyjn8336ǎu۸qb d̘~m , eݺʎa>.((c]&^?.뷾T3ufy`F!'簐NLBO4wbDF::%(T!(ȏ2*&&B kړIVOys#Kf; z-h$??`HR}wr70 `h2o󧃾61$(>2ZgŊOիceՌ7nl%o_TQ'Z5~l:Xӡ&9yL~E0 %Am2IUNbotwrH%8x Is\];'%m` B(ߴiC0//#zk?(>׳7n@z`>.|Jv0eʫC\h7L~)Um>NC߱cY~ !9i?fH 0iE,WNKywtEE`(jSjj)`.Q !( F1H 0"y0 `CH0.Q !( @F0 *`Z7ٳ;8n&=O\ ET 0HFi۶GÆvz)n!! 0? Q;U!L\9(YqgyߵkIϞه]_ލ{UJ4)aPU0 >#S'[ qzgϟдiC33iFT*Q2UL\9(͚?))X8e*S%Δ0 *`ZÑ]GЁ Nrqq-[>d*5e*S%Δ0 *`ZÑBVڵC6Vt:gV--wcG gLh S.(`nGŸ%ǰ23*%CrFU @oa0 *`0LS.(`H(ƞ`Ƀ\BQ$pb F<`0!$E`T^ ;-`F`Vۮ1IENDB`java-design-patterns-1.16.0/state/pom.xml000066400000000000000000000035741312550536300202760ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 state junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/state/src/000077500000000000000000000000001312550536300175375ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/main/000077500000000000000000000000001312550536300204635ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/main/java/000077500000000000000000000000001312550536300214045ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/main/java/com/000077500000000000000000000000001312550536300221625ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300240125ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/state/000077500000000000000000000000001312550536300251325ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/state/AngryState.java000066400000000000000000000032741312550536300300640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Angry state. * */ public class AngryState implements State { private static final Logger LOGGER = LoggerFactory.getLogger(AngryState.class); private Mammoth mammoth; public AngryState(Mammoth mammoth) { this.mammoth = mammoth; } @Override public void observe() { LOGGER.info("{} is furious!", mammoth); } @Override public void onEnterState() { LOGGER.info("{} gets angry!", mammoth); } } java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/state/App.java000066400000000000000000000035401312550536300265170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; /** * * In State pattern the container object has an internal state object that defines the current * behavior. The state object can be changed to alter the behavior. *

    * This can be a cleaner way for an object to change its behavior at runtime without resorting to * large monolithic conditional statements and thus improves maintainability. *

    * In this example the {@link Mammoth} changes its behavior as time passes by. * */ public class App { /** * Program entry point */ public static void main(String[] args) { Mammoth mammoth = new Mammoth(); mammoth.observe(); mammoth.timePasses(); mammoth.observe(); mammoth.timePasses(); mammoth.observe(); } } java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/state/Mammoth.java000066400000000000000000000035631312550536300274060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; /** * * Mammoth has internal state that defines its behavior. * */ public class Mammoth { private State state; public Mammoth() { state = new PeacefulState(this); } /** * Makes time pass for the mammoth */ public void timePasses() { if (state.getClass().equals(PeacefulState.class)) { changeStateTo(new AngryState(this)); } else { changeStateTo(new PeacefulState(this)); } } private void changeStateTo(State newState) { this.state = newState; this.state.onEnterState(); } @Override public String toString() { return "The mammoth"; } public void observe() { this.state.observe(); } } java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/state/PeacefulState.java000066400000000000000000000033221312550536300305220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Peaceful state. * */ public class PeacefulState implements State { private static final Logger LOGGER = LoggerFactory.getLogger(PeacefulState.class); private Mammoth mammoth; public PeacefulState(Mammoth mammoth) { this.mammoth = mammoth; } @Override public void observe() { LOGGER.info("{} is calm and peaceful.", mammoth); } @Override public void onEnterState() { LOGGER.info("{} calms down.", mammoth); } } java-design-patterns-1.16.0/state/src/main/java/com/iluwatar/state/State.java000066400000000000000000000024451312550536300270620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; /** * * State interface. * */ public interface State { void onEnterState(); void observe(); } java-design-patterns-1.16.0/state/src/test/000077500000000000000000000000001312550536300205165ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/test/java/000077500000000000000000000000001312550536300214375ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/test/java/com/000077500000000000000000000000001312550536300222155ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300240455ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/test/java/com/iluwatar/state/000077500000000000000000000000001312550536300251655ustar00rootroot00000000000000java-design-patterns-1.16.0/state/src/test/java/com/iluwatar/state/AppTest.java000066400000000000000000000024711312550536300274140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/state/src/test/java/com/iluwatar/state/MammothTest.java000066400000000000000000000067361312550536300303060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.state; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; /** * Date: 12/29/15 - 8:27 PM * * @author Jeroen Meulemeester */ public class MammothTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * Switch to a complete mammoth 'mood'-cycle and verify if the observed mood matches the expected * value. */ @Test public void testTimePasses() { final Mammoth mammoth = new Mammoth(); mammoth.observe(); assertEquals("The mammoth is calm and peaceful.", appender.getLastMessage()); assertEquals(1 , appender.getLogSize()); mammoth.timePasses(); assertEquals("The mammoth gets angry!", appender.getLastMessage()); assertEquals(2 , appender.getLogSize()); mammoth.observe(); assertEquals("The mammoth is furious!", appender.getLastMessage()); assertEquals(3 , appender.getLogSize()); mammoth.timePasses(); assertEquals("The mammoth calms down.", appender.getLastMessage()); assertEquals(4 , appender.getLogSize()); mammoth.observe(); assertEquals("The mammoth is calm and peaceful.", appender.getLastMessage()); assertEquals(5 , appender.getLogSize()); } /** * Verify if {@link Mammoth#toString()} gives the expected value */ @Test public void testToString() { final String toString = new Mammoth().toString(); assertNotNull(toString); assertEquals("The mammoth", toString); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } } } java-design-patterns-1.16.0/step-builder/000077500000000000000000000000001312550536300202275ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/README.md000066400000000000000000000021351312550536300215070ustar00rootroot00000000000000--- layout: pattern title: Step Builder folder: step-builder permalink: /patterns/step-builder/ pumlid: LOZ93SCm3C1MQGQmzUysYYqaAcJ5q96i7t_x8KXkh4soKvfypeZfNm33fnuSP-xfPEtI88tQhW4i-M2WmGzlB9sS3oqJ8yZKOQ0lWOLPzcJfAoZQtwXfeyuSyW80 categories: Creational tags: - Java - Difficulty-Intermediate --- ## Intent An extension of the Builder pattern that fully guides the user through the creation of the object with no chances of confusion. The user experience will be much more improved by the fact that he will only see the next step methods available, NO build method until is the right time to build the object. ![alt text](./etc/step-builder.png "Step Builder") ## Applicability Use the Step Builder pattern when the algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled the construction process must allow different representations for the object that's constructed when in the process of constructing the order is important. ## Credits * [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) java-design-patterns-1.16.0/step-builder/etc/000077500000000000000000000000001312550536300210025ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/etc/step-builder.png000066400000000000000000002244061312550536300241170ustar00rootroot00000000000000PNG  IHDRWj(IDATx] \OgPRDS)D%i"=PBʖ<$$QbQ1l8Ϧ1fmc{}R>}{9sνTQ@ ^U.@ @ ‹@ *o1O  JT~bI@ $$'AFB %BJA#PDV!xk&@*7*dq$'\3AVT01eΝMѼyð0OOرhђ_]Sj{L dDF2ReC?vEZbz>~ߥK9{\뉒 #*yxs"dʆ_'ڌt^1ϓCuТE!~Ȑ^N%#PXicc&Nוۼqc#Y)>˗w!Ν<)@zq|Vj@cAU޼~kܸ]w ~8C0 !q]5) SNNbACVR GfhTy֭"iSDH7W&NqY-k=G-Z411q ثW\۞99|Հbƃ/Lsr~8:WVVOzSW1!~]۩S3з/)#g)>~sFc蘙Yz{ 8m3g [nFpTA&M?%;;^xڮ ,,ڝ=ZRT4 D51*k`N?A;;ҥ}jĸ{:ѓ~]褮]Mc ic,>^Pzb8RęT1!Dwgk11޹sÇ;mm6rvX]0U5&`*Or*Zq#FR&INrd+9H Yk"O<7]FCe3 W?M57'*8"G=7y'ԆCu֝zOtdBr*қQY~Y3|݋0b$7 Tِ~:}Th2^;&(fpѣfմiZjv!+k"ϝKmQeOz,%/ձc+#(lI_~V_TVY11A%%faCݵ+yyI/q Uz-kl*#ˆA|PHFlG?0M>`;v"|%;>u.~ ի틏iaѮjժ99zjoڇl."#q]ۅ h2@9sƼmfaǎE ͒섄_}Aoq2.1"ē"#<~r\RGOR&0N>cb}a?t#J:m޹spѧO) ̬MuOL5kְ1?D#Z=cW?=^m[IZjiqvslagg\jƛo6!^^rΒ|̶<2nĉ (Ke|pT2;u릍re_{F?p`ԑ5j0%BuBFJO+VLkܸ~VM|}9K #L7WX3z0r m~K@A,bj'%=kZ%Ȅ5LOpq[jߏ&SaOYX{[;w.Z!{jժ9vm!}`GA8!a6ޢEcښS_I7c8n:,^?kౙG^cAcvH3_O?esI<،^vӴi9vT~''[f݂Ytk1Ay~:.'yʃ('v<)I~SwF'Ou9Kjњ[#͢F& mk22bLwj_߰Fԩ#֙~ұk&P1O~:o=hΛval?CBYʿwdX6-[6ai~\,˿\+'0j_|pGǸw6O߷xIv,~~EOa)#6& mW㹦ڵ]h^k׮=o{Uiv#^,`ňquSVx?qq8Jsv^ c֭=th 7~@ X!O`Դ%'$C> c«.5\3A ɫN9-5e ;o֎K# pߑW8G0L?1dۡC+uB#8\a1q;jݺPV=Z%GeIKQ8:x0np{ww{|mlX ڲe>Ww9]dK=hso32b͙36O@+(3T&)Ζ_ R.jjfX+ cTЫ~BMO_ҥS 5kfE<=Pat0 mj{NN"Ba>ƍ-,: р?^E@z>x`s4"K ?%g[jHmjjfB!|gϲ!fdd\|aDnܸDFF={ cOOOpRR]ZZqqq&&&᪈ccI&ZiXCdʆ^/CDk>?JpĈH zcC̊:z\ j|\sK^^‡J']0NIIvJc]BTw ܹs?> K.ܱ.,Ó_v^ (2gvaeF]صɮ׋G>DC*>jAIL4@0~5j*LH rb(P>I?)}T5fRW QE7do&[p)=} _~dOa.D䥕~R<5 kHXܮ]νti1yhnZhq<رc͛#F޽˱w}Lv5=x0?ku9ںcq }BC;v,j OOwąy8Ĥ@InJRm'!mº|œ\3AOr#pSRɓ۷m1G CΝ[7ei fؖ-ɳgSzde0 })(,¨qc8mcU''H%DBW1$(LJJ8DY$V~?ŔӪ/P<5 $7*# ,ܼyCM3}}5z2e:J-;ΜeiiBW}Վp-[滸&MrW0~~PN,iTf[wI 'T(U?q)5'm&Yv\ mqK7i? _H6#ӗ CnGgSi*~fx,Y3Oz|jOٞ %aa~O*ߧoh.!ha^^Rjj֬v/6kL.[ϐ@P~H ǟ뢟&Mr߰! ̘zU%'uO~?čDSӖglA h;rJz~]U:ރ8v,W$7%VǏti8{~M !h!so%ݻwҘr)=5k }fϏh|[njdTCV,E;'4ǻF 'ԏ)|~x&uo{jܧmllpKՀ[# PPL?,{@%zZ^C::5lX}Yz^?ܹ:U8$1N(g@ J*!3`c3gz=&T2OlHUU8F+wctdǪH+deq˜D\ HV~:d' g /*p-<),d_:^ 8p``Wzo熑#p@hy A| JI ibիViO6EZ{ OXƲwHǎ^uUJz8!U}|F0FqSǪH+n׻wt>"yy*&OX1mΜ1 T%t ¾Nȹ6LT% >%d 4Tn Z4 CZ~?ޅ]Li)aZZf_ 7jOѤI1&胲F\_?_|ϼ*fi˖^^hHnoI%ӍvxN_  W200md31c׹zl"|F#R-h5ss%н7Vj2JOdN]/Zt?𧝬i AV41N^:|xr޽ӹskZ^CݥG3t1OP^Zڵ֭ݾw/Ug7F/eT~B40z{b3i)!sϏ8'зo_^AAtU\\SV0gcbl"|F #41Z,g%?xhݺP8قͲUV*~R$+D?|'aNI֣G31NJ=1cccc ߛk#K>13+Tb%URGh-7q,yNBGYj2JOd触fbJ~e$3U/z JBaa!~mll5+IIIoV;$FFF%UHHHIhT@dCeD7I?UrPH~R>54SRR Tj$xI @EiIC*7*eǏڠAkC4p:S9~1w9yIF===Ϟ=[ʍdFY,ͽVV7%}|_Bt~9~_L},' C~R>5222֭e kHXCcWNj_V.뽎7>/^X ȐҬSYP05Ν;tPzǛF2ReC]ʧ`ݻq&k%s'B,dHi;߀IYθ|rllJBBBY'%$7*# 'kk_r_N@nX? \ Q־,\a $7*'.eI}tY?/"=-' 7]^^Rjj֬v/6kL_/ϭޥ3wxO|UH:h2 ]^X(=&FFFI?T!RUBnOwbKOO.뽖wXN@"~P;z~ZXc2pܵ:ddTcHYv epeOO糰Z^R@('ݟj_?t\ﵼ>/~~\d O!B}#X{s*.@Vo'av3Oc8p7o_-._ ePا~S ܳcV7G{Oqzְa}PYFITb+DGG EJO+rm7/GoP{[ӧ{Bv\|T@LpwիW?]?m33c7\'N@aYAApOF55m ĥ۲eyl*t*/,#g-AI {L0dbb$uq "娟ğW fZcƮsD$?{[fym1ͭ_vvOOmذoiOǻp5LhyC!--+f~R;k ܛ:c Oʲ-qz̴8h-d.o;::֩S 'E9'|wT=rœsyH~s{{dihÇ?;x1ml+ŽO1,=07>ݓ˟I"FN?A,7OJZ^|R/,Ӏ/\ئ=& K`x%?OSXqΘf~H~~5H{nPѿu1_?Amԯ_LsddolR- O?n:߱]IIFF5į-'‚8=b,-MOo=~=&/ *qqqiii4TM?H?)zOK9,; ~O#O@f~J]j׮Unܽ{)"a}ڶmѵyIA`+rԱc+sϏ8R8{NOJO/P ȹw.mOL'A3ٳGTjA HVSl\)epݘ1NHNW&T`{{{K]`0 HV  5I?i$x~~/%@՛ }ԸU3YhuGI7ƌq/ʭ嚖%XxqA79'q>}է%NMڗsJ, mlb gIO'50|Y"##cJ]BYAOC{xu+~|!36~G+'XYΘ~8yyIM|jYΕ+tOpSRq ֬YC6T [ ޾}[PR@ T T)M?ݚ_~Ҹ+]zddİĂX\ X1mΜ18$2ś%\R/猫f1l6yJy'˗Ν[PPRRG) dTĥ'kr)<ܟ-Q`xףGw2\M0Rr[ڽ{M/ʕOHPڬ,Y3O1h@6钒BBBؘAy ;%:?݉'_怐ϓ,xVN~}8̬MRR?ܻwd@+8y؃PPEM\KO lc b$N" ~"--ȈRGPpg9A)b"""+P"JOZRiZi201iѮ]`*X4ȶAz͚5}@͛{mm;[Yku.q\KOvǻԣF 'A@iaaO7)%@'99?{…m66f$~*4d T[D{)uԡYZ_n]z0tL,w~- Z&}79pzKK2ɖ\*K[$D;ΝۧOoPFG1?[oylx1]a1?ׯkI?eVsAQO|;n{]++Ӯ]MCڭ[-o8Ort|kذ>}Zٳ6}gO`i흝{w>5ubċ9ںcq }BC;v,j OO CI $Ldqd{ρƟʈ˗/GGGA3O OS'hѫ~wżys/OOĩQrA1r 'B^ʧ`/޽˯^M_|G&ge0 {A`!ȑaa~s`MUjmI9/uZc̳0ip@r!ڶmΌ{e0uk$TB$tO SRq ֬YCr3ѓő=rF/b5ӧ/L'A?i&'= Ec #O.!NJF.L#\+Suw,> tqg3|yٹs11r ,٢Ttk:~ c, ""ơggϘ1jL/ KKe&_})?|S|L__F^g8hٳSb1Dz<ٝ4oPK!=e|={Zdi$wտ?3XLӦ $7=YsԒ.!~IǼqcoI1~w7m F 6v 8˹rq_w.%>Ez hΟ U$΄Ĝ9xsP~RÇzY@Cև)ʸ?@텔Kàz^? …m:~ӍKO0dma)OgV ]6kF@(l!~]۩Sk. bfo#N\Ε;\3$>=bسzAWYXCQR|9AVqNLX?ݠZrǰ;(G=߰! i23c3f:\\|=~m[ӧiڴE-I 6@ݻwʕ~tO0.oA;+F,l9Aΐ\?am}|0$ٷ/3|=ROaͳAcF~8hN?;sH駫Wř V׮8, F$$['0**4ЬY^tV/،C ģgKA=QWNMdsbk??&&΁32ѡC+v:h/ƏwAFHO^qqq4Ta~bd2ĉ☉]۴i!"Sxp˖!1uŝr~"##b ŋiř`ȁd IU&dIdc.lc$ŐSEƍ, |B3kl**M]dz 3JJE?q]aq\ħQݻw:w.UlQӭ[`zVVON~EU$Q?] hiS3gJKN_*/˒-b}էuGݵ+akg2w}Lv5ex=3g lsusdѓqT&oxz:흝{wҞ-qI $? H(Pyaidc3Yɏ6%ӍбlcxӧS8IIn\f _=jWn:ujţ 䁶ٮZ5c˖ܹcYo6B^^rԩdvTM5z}`YA^ʧ`E 0;// AD_Z1aJ$j5l6矂LAF3iH?(H%DBW1ԭ[m6GpDɫL,l+._,u)*5 B?s=x![R@Vm&G;mw'%Z%ȄOPB:NNΎϚ\jՂ G?|8^){PZ5O-Z48q8O={Z\Fޜ +n}]ǯX?5i.*cIaa~lנAgϦΜoiil䫯vJ:..}Qɡ տ?wdwv[ʉ4m@j/#{4...RR l,?c d%L0OC6sOdX)Ȅ?!6vȑիW{]R\|B29~+}7dVGSHV|W ~ڴ){FxɒI{sP~R㏇֭ ޽$>_? …mP97c1?pbH~JO_sbnG30~bGq{'(9`"جoJ g!!!gϞWs[kVF #5<>pxVEqСUMff@7LVWhNzRjUǠׯaٺC'|o!bnkOJ˒-t/O1y AciiAaafM?G]׿CД:hj̙-8 nݻwʕtJ{ǎ%^&Gh g~ב6dF{_B^w[C!M|6mլY4N?~=#?Cjτ4Mu]s]]1 yZY&&Ή xW,,ک ПFxƌQhjժ 9SoB;Oݽ9AV(OﶶQvm =z=~< >=5kWN;wno߳5Ϗc^FF5:th]-U?AӍ5ƟKXy%A'pӚs;}'?|;eʈ AؘAͨxwh<]o@ʯWϸNggcK ϺukwA]!Yx?qqPlnժ tXBlYU2$>I H%s^Ɵ!]䅌 KA0RK(m!B>ē⒗Dw~-n׻wtH;>-AYs s ?PXXHO>T.͟:&u;~/?%H?eDI9@4lؐ A'+hN> LlA֪H~B0DO|т-2ydd VETdd$~i A䑉~-ZIOƜA LlA֪H~65qDzzl\V LlA֪H~ҌiӦϗydd VER~B @CqBC))KVwѣk7}B[#_Md_'~+ ZJIIeErrc,(Ғ~"ZQ'ddKݻ^^yͭ߸qFt 9uBW"t O޽t@DΘ1ANm8CGlpt| D~x''[xQ>z6vuP\|BP$~io>!eϞO8 [~1H b[?=| ] ej;%"ONI'|MFo޹sK,-M4׽>Yu`H?u"fAB# عs1a{,CxYkBL,\81gl*6bGiOp}2}[oh'*dIHk\{7%%l,=2ߴ)bcoOb޸q6ʕԢe88[~1H bZ-ڭ[- ƬsvRiB7DGOFw}ʴkWSCwY}XZ[wGHpIO!_qܼ֊d蜰÷o__.=J !դlbtKp.]ڧ.P*{11ia|y'1+`tYY'b$,7Hh>>Cj {x qc/7pͱ~'$KQ?AlA@,[4rCX_V֊+W҇1? zHsm2+~~m,{{<; 3"}FF R~Ѻ9s`33 ^"Kk~=CLOl #%ZpSȑհ `P[7UToA Ea 0 EE`#}nFT6ǒ@D99:Bٸq1c`M(7B*!'#۷m\~"{Y]W"p7%S~-X,/4r Q>=WW$,7HhpKXtʐ!^f6" aD$ =ÿ`EA VExHLCZX<#=$u>**qq|6ڵ!@"K:3~ J(ζH+9JO>[. b~R+o˗wfҲ4[l.5TlͭdIIp wܵ:ƉGcrq۳T_?Meɓ!hm,4mڀڵ]0gScqV-1eOC Ck#s}9$Tvk$4_~96|= ~=O~:w.uh'" splm8g#zffmMɏ[{,}ff GI`?}ZC!GǑ'?_ڟ~FJ\}7Gْ~"hGK)O;w.K!\TjA_T?U=㏇Pϻwzjy~ y&Qrry[)TzYlG3(~b-)~aج3tj:̰kWSd+*COV1L?'"OJF0L#ׯ+ |jvG f[M^QrTHe ǟċӤI6!@z*ݻ Ľ{G,,ڡ/OWƋS'vv]o~?ȣGA P`wqDV(ɉsrMM[9eV(0T{J:-U<ǍHɁ3\~Oo?ccX1MSU.>J0+,dNJ'n3lI _lܹAA:.*:6u*MϏC!AZ6>=5kGVe7v2ڵ]^Zڵ!bXVi44hjfҗ ǏwAGƟFO֒\U;1ꟙY v8G9s(eĭ|r\sqƍ?X*[#%JE2Rق%Z ؘI^1 L?D3\cz -ј5ݸͫWӡu~x`:)TWmذEHHƕlDIHF*[o׻w++S4OH^1 O?1r3☉]۴i"'NdyB\۶m+FbղeۧT*d$'NTkfA@ :9 Ĵo8Ĵ Cc(ZoAAdl!y*2RJ2RU$DԉquT (oƍOI_1bTy kU$I?ub\={RRR.6NJJ2Q#""liLF Pu#}o1fK`e*ՐW<$)Q@RA֪HW?>jlL5~=݆ KUixbKQneERA֪HT?-ܿiҶ๙2"lp%*' 5߾}IR'$7RhF`*rOI"G=7y'ԆCHBIBv# ydmƋXrϐ6aq~䕊Oϟ^kU ^8?G3fjڴAZ5u됕Υ6m(߲'_z.Ң:vledTe<|dEu)))&&&RA(⡻biH^Z(;4z 7ësc_܋͢K`Թ\AlW?¢]ժUsrnڇl.Rjkv$ڠ w8jΜ1/hyڴi5t~" hFx~*}"D'U>I>)[Po~2qS^# KQбlΝg>}:駀36ם?<>yR0i׬Y0/ZƯ~{8d۶(jҥm+s>;U3|rc&NpPGY-[#=SQ[7m+_խ[NZν9[b(`T*b׵Azk׆#NkW è  4iF "_3-zzf #.pI!!;$,bϛ¾Vf˥NC4J2'Y^uLP(;dp|UƟN^?%bE QmqrfqQCV 2a¢ ..}V:ujT5ˋ)2߹sqV VVyV 8 t~=5'$Q ݾ}`'l"n:,^xSXٺuSb7}#xL8ǿ: /3:RD -z8 a;My6n\%-,pgL ݏm#{t -N03kǀ˗wN잝FkʔW|-8/ZCnHe~ibFZYDb[ZrqJ%..}Q?wuźOXoi+ eN?>c{Q~c'z?{o 3i;*Y6p?.^LӨBCB\M1zrgϦ"0|=d2wfO8!73guXBZ5!!J&!22W_x֗՞O8رQ ׯ{TPTYu+1vٳgQieCYUY-T\-9 F]M (;F/Ɏ/`{>E5jذ$pڵ]kzv+^z]ȹW/ 7!_ԩp\\0qwG?{R'[nC|n%jR qQn((r۷+SA s.]?-&"i k5kz'~B<7I:9ooߍ;ի˲;w./]uBwĪ:GMRwq,'tYSsZPl1V# ;－O?e;;Ay4^Zf.lCZO7˦@,֪ѬI\-9B<.]&i~R%e{8</ˆ''?K"Afep'@IF"s܇3ff_l"FI@~J~r%=]vv]F|8̬MRR({GYϏCOl419oŁMt*hj̙-8#B\aJuKS$:@t{:th6Nebai*.>&S?l7fe~ibFZ9QkhV$uwedČ4[κXw܋RIX?~٨+F;Yߑ~* vѰaCX!\Pd.7HTLvԲ(C$?@?AS5jƟI-,ϝ5 ;wno߳qxvh mР}/6#C [TtͽpVV}Z]KI{XU~MrȨ$;#WRVZ*Br_ ΋qsiq|ԑDJoAٴ_VZZ5:%g]#{NΥb`7s/J'(H.'f`SE}…m66fW6pG˺XK3Ʃ|_.ߗ_,7JrV i@&Y1$Dԉrv͕jڎv# ZވFԛ{־޽XYZ[w<}:EA{O,_4z[TO(GkdCOD([\TTԪU R #% ([#%*:Q)::ZRH2R5RY"I+)Q@y)AE֪P~"DcJ] @FJPFJ` kU$RRӗZ5%^w SK[FPi-(Pnhĉ;%oH ZI'ƗOǎ%,XP'%;*5R(+#%A֪HN?ݿt>ν}}9axy9I7~ 9!4t,قu+Lpd^,<)ؽ{61cqÇۻ#ѣ "q.υlpt| D~x''wFGc@q A}N={Z@?ԂlŐIE999 6#O 䑉H *Olm0hճB!&.M3g@qk,hOg쳔=z@<>W$ OD\J{))8ec9[_/6vmQHx$Vas޼g+U\M-)<ܟ} g/L*T, 䑉H *O>>CJǀ7"q[Ν@ βeA#G:eepr%}p#ؘCHk˖\=lnvɒI,{νqFȈAʏ>Z7glff><~<KP$~iqׯgԂ I-2(RƜ(w#-G I`MX~KoyԢEuktvfAA/W-BK.Prr0RFIjJcWG >y3gp*9epӟt!Cz׬{H~B-?' >aԉ)TsNN"@6nIECV!=$u>**qq|6ڵ!@"K:3~ J(ζ*H'KKˌ i!>| /rr+[u>1q? 7`/ss~MFo2{g4A[ c/t,^)JTA?9ҁŗ~b(6/>CTGyӹsG; mgh/ddν!bT?tj4@ݻ\3gH ɍOJ=QZL/܉Hm7/Gӧ{W^ޠA˧{VE9bxEP"I*u xK^Q"R1TT4P/@=f~VZQq{:sfؗYxf׬yg̬y/|+͛q{@OzᎥM@'~ &` %bU/^NSV.=yr؂Ԁ:Q?X +ic+$=*~]V6W - #-.]ӷ TBUB5ӧĿ9N3Nl~r3`Ɯ$~0_Ng{pPgpuakQ*PL#O泹sj4֮Zw\ٹ`g>b . ۸1:6v \S,K `+)}ɖpҋYf orQ^fnDxI{(^H)/ `lvvܬY~(ZԯW/w4OO1KEPv&MI)Y"! ;ol3;%do$f،9[YfIO][\\}'9~o1,6 l͒3=qj8?qɒZ'S;I. X^<4c e+64*jbQQ 姘 ͋ϝD<!I@ӵ\{YRG>Ȉr%ųռy'}Dn@ 1?P~?%ԲD"̀^gnG#1?n'[~>I6cVևYwb (س)'RN''g"{pq~%E.w:&i^U$b %:5UqG ex4sfƍт%ȒdܸAOMOe֭C]GqŋCɕS6a$ť3Y'ϨP_搎VU֭KK#GR6OOG]]w:Wp ^Y1``Ӱ׷|1;do')79f0N(? Bׯ~b>}LDz(#O\dKsyyy9B3}'鴼7$K,[UX()F._{[xzI} gg[ w{Ѹt޹s"ˣG,ŝ kolʕ}={vt=YTN{E0 :vt"pYwwo?y* \wq؁SAZqq@U}tbvT,,\8UaveƓL3le}u'ib~ ~b>},>ɉx0R7n'!!+"{FM9C7e$./\ *~bb&Wk`J*)I#"=Ǎ,?~pa KQORn2͘U[RLs*=ß?qɑ%/wܩ W/1Lwώѵk{ӧ3wU71g+9e8JdbfGvveVgOR.8?j%K4?>222j')DTklIq~%\yoqOR.8?j%K44k')DTklIq~% \xLOR.8?jJ~JOrto޽ϝ!hsΞ=Z\ܟ6|%UnZgMs;txƍBA; ޽R@⭵\QQѪU+f_ܬߔJnTӞ= ~}vuR,c'޽=eF2WNN;jԫطIꋷޚҭKaa2f9ΜѣSedvǎ;rdKHs C3Ɵ#4!!Ύ(@#]ӷonʹJByKHH8qҭ^d ?]0B,,@Gʯ_/h׮:)ƍB2N;P֭~XEV5ӧD;wt_>cT0o:~m᷂ۖ *OdfƐ|Xu?"sϓiՆc /0{{{Yv_9vFdyj+fYe& Lm櫯>P1T ڛP uӬY-))!!df!ca}`yx8C/ة 8rYYK.}4sf KҘ@YҢ$29?,0\hS``wd:Oy<fO=th'7 10i:vtI4|ڴ k'Fb~93xhL%6iHOX ;nt+)IsqiÉbqn:9wd 8r$a}+i߬[i4ҭPiMVpS÷- Q )(--BPYY:E "M?>/iɻ ph߲%KJf\9z_4!HN= &$AO?} 3{hW686 C Cp&BI1\@7(J~OU;?/Szzjfy*++'n jv.ٻOX(.C l?y:r}5FոLvv# yB0psk>}~^)2J*~ػwYNpP%a:"3ҳg\rdB~ :Vjs-))Qj'N$$$( n*2}!%KPYy> }dܸA(p:|U e<ѿ7;&G$bCC٣ƍBYVͣC?>IN(GGƍܹ:[ŶZ_Yկ_=;;c*[dF!o=<<0˻@*d2=?]ps^)-RMo@];EyȐ^MO_ۡ3AYgmQm|~tRƍ'3q' 1lìڰLOxglR'FH8 j|@\OZ#iG '$[oM~uBR1ͦLNR]Сw?۱ɓuўTxj~߾=ztBcn>,e$>s& ر\*lIfnIgfʓ쥖a=ß JYi4ZaGN#ML@Ʊ\?ђU%? 8\6,'//u~~ӆ 9ӧ$ݵ+;D ܼy0##55u;+QNJTBg**6ڞ\~f18gĥ"R-E:uttMX~RmG4NRx RC~"ϟn$TO[.0!G6lX_O_~C }w#}6== ֭C8k3go2yyM4šFHfw%%i..Ϝª*J~bdcxq~RTO÷- Q )?"~T >۪ڎ4'On>/S''G2K'pԩAmƎ{{'.R b9 ];vQH;{hʕ}={v>y,q!_^ǎNdմUU'W;w:::*uq~ROjv.ٻOX(.a;xڎ4q' D}XjORIIZٳ}|`s6l+NBBBEE"W.+jԨWtБ4mQ?]dy|i*,˰C؎.U ;WihUKfk{L7 ۨc<*s<#Ob!&!?%f79i2-4]OI)GiBq}`$]ho}Ž4Nm# 駣mw c¥WTXXDŽD6mFz8:"cMK?$ #]#F'\OVx(.8nUq&gb ?B{?4`mm?U ^q,'Ӭe'Aq}H햻eK,ɗ4o͚l&Z'0ʮ"'gePP?x? ^VBpBδiAXrL%z 4gưK1YgN&11^ז\PbGwsH,8?Aqk[W-t1c{:MNNga1 J,WTlշR?=ٙIL5Iuv2{…I%SbG8qܹss1FCcڥlW'.Id!~ws]vHKQې!益:CI᜜΂|lĥq~2LO;u될رw1̟+f rph6~`6 ;:MD(%|yߡC~bz5o_ÒYv3gʏQ>C*Ɵ,| tvvDp܎byW'.IT~0`XΛٷo 9vvMV/zz|ݼyͭes<72XO^^"owgzjiiHM]TV./]ʓTʱ"@۶mA \EI033?āI SQ,ocĥ?Ѯ&YuA "2>'r9o &Es~٤ICSwH6cb+;R5ڛP Y~C,\8n)#G/.NY`,m;77yN ڻw)Ch͚%GNROyF`T0+kIPP^#ZV`3['_' & هi,QU*'9aAE3t9:π5 [yd ME).QQR.{Q$ N^^")Fވ>ϯp!gt7oȈrMM]JÆJ謷[EV1?VQ~|y!KЌ'OD h 쳭$Z=L!BG+W4U/}I &<ݩ IQTl K(&5T-G2M'(.. -<%W^ *oj/6 % b{#HڀvvM̱SW+Wݯŋ{$lq~zOo3vSacϟa<ـ8?[G\]k? X& ERL͉ O]܅[q&R٢ݬYdhjy.Y2w*fr~ ?Vs} BqIvhKHb{`9}$Mn0:ψ~O  f^Cr$?*)I#ʞ=<=r~V]#wh:B4*#x{̡ZOՊsbLăLqZ49ָO#":"=eHmۖ}?~=L U٘%*~{/⋍ƍy C}&={4c֮O*GDҥԠ[7D7֨D~+W\|:&'&q(,|XL#Ff~~ݱTGl3tVO4gưK1Yo:{LUeXdSu㜠+"lIg+.Dn72O^L!=Iӟ%&UD'Nl|' ECV'̊=]4oذn"-Rwwo/hBf\irE=%KQ 6,?e&Sܯ->8t[ Vǔ5gӂw$^|M`ٗ_~HN߶mSpq/^DϞ]WL`oߔ޽{[[SKJ҄%>;\>ָsÆ%O#|O11f[iqE5xKj9? Ռs:c(" 6:eS_ך=riOK$Neعs%7P'.,q~s"7tݰ$p~28?q'"c']Hǯ,)O\&mSzz}~ܓh2\Hq~R8?qD6O_ۡ7n ΂(9=ս{*[k-e8?qDL"Sn:$h9v]Lvvm[oMtͅdc'޽=I^gO A ޷_?O:߼y@G2~}vuR,a>s&GN; OQ,!aΝ+R4TRÇ'BBQ@ 8A'.IT~0`Xx[}B]իˇ5ӧiXXx;ѡXrF!(y=b2d \^Ю]+AqC0o:~mۖA u\EIRaff Iu@R?B*'.#K%=~T|}:,lժšd:$$Θ^+dA5fX NpAM4>W@5ko.C1e رpḍccٿ8e@P_|SЦII q%C%"WTl}Qt!Cz<̚,9:ZԯW/w83g t$bȒ- Vĥ?`ZI rӕBǛڵCZZ*jC\NN_c~\Z^eF\1jO$Oا{B;<=]&TK: wѣ;$+7? uv'>UNJTNg݀bb~2<ԩAttĀyyM4"c;w8x'qZ#$þ+)Isqi}LVW^N—_搣^%?mݺߑ# WDx08?.bKN3my. xmBvG|yCy &0+)v)aΟ5kVpqq vo7e^.7 bb9@Uzp"ϔKfO4|x_Ru:9)8i?Aqqa~6!ky . ĒO?}ٳGc9O/8-63g fQP6;lq ǯ~zg:x{{qn:5M;v Q,ojs<@p=lX>!!pacܸAqq9)nj񏊚$@Q8 ChڻG|}ҸN/~bݻ%>OB ^L[d o@ᠠ~h'X،$.bW{]Iĭ~+B^rXZq3lyZ |Sm,˰]J0Ci+cc2(A@ϱssO$}ih/B-A5kFDlz Tcgh>~&i͋1Kz%];\.&f2}'clfXR᧺,/CeBqK FOkb\ uAAdqh)A;޹/ !://#^ם…Gl=)\˕%ůິ*\%OR]O.pӧoUU=~ӤICɧ30uOu".񅇬Z5;mZЗ_Gz~\HZB[E +g& "#b(OT|aFDx̒zh*U$qk|K| .V+n%~rLLٽ ^EDt>}$(n()IC_2Œwip {Fyx裌(&hc0 ̮_ 4IڨSB*_=ی+iy+oI<X83BP\RTm:u:C~>{h2NxOpV;;;o `!_wE%O ݒ ߻Wqo0n  Ν;Fԏ^Iy9GK@("o:4I,FIl_wۇ%r~71,$qyRL`VRL&Ȍ?/અ=~JA1TO$&p\* 9-\h}O\2e{d`Je.Oj'.+'.YYo0ĥq~28?q'.#K%eq~%O\FJ$%K:[4{' d00szz}~A&g2*IiGl^jt! jRwEi6gO_ۡ3򜜕Θ'wPU)K%e^ףGN޷o޳'aРWۯ'&yztBF;3Yc2cr9?%$¯R42pp_``]; tvvD2W Hq~R8?qD5 F%3`4G-5ӧD;wt_>ӿ]~RN}o۶ 5OP Uw]^Ю]+̌1q@RV*O\FJdcD{v;uj3YتUs22&hLF&n(haItt(u޿_6iPs j [9^T ~2_7bNT\BZLгbkx6mZxx8C[;|*?$(_^+2;kVxPv5.O\FJĭv=|gu tB_>}:9c1]\H0}D׮"Qې!טbb&7GbFa+7/?ђ,?A7oȈrMM]$Ξ!0C_#aOw튧n01?_Q~ IvH mj _qĦ쥖LAip.+Ȣ2~Kv;$]b r;&':X#]+f*úwhO2;:MDiQQJh._އ5#id(F6GѾ@C>yr 8oۅsh*3loϟn$&6-C+w6mZ`k׷w4U+)Isqi[nr 'eRG6lX_SJlqK%R? ߶(dwD7`.1l427=zf ..N(Rݼy%v/}z{H{…\]?BU!wlg'fw* 6ujV7v@e8?qDk5;ݧڀY,ta;v!޾}""K6`I=fKfhO s4iD+"@F$}%5dH/4Tno, OTRV}(zv쎫e8?qD᧺,/CeBI1q@W0Ł} 11)AGNܹACDR;|x_wڪ rOIʳH-ůfCjGџW$ (ol]Ѱ_M`¬>*ݽ[B>3Fl…, d8-G~AK%.ӌӹs[ ڞǎKvo/kWමeK;pIæ9"φMct;6muxQW|ho P6cdh6;M.RyHIq~%59KvusAK=.ӌdٷo 9vvMV/bo]*rָ&f2}ش:X:HX2ݎM3w7mʕ}fj>UHHz_Ih3]+j%K'39A%9idXpƍѱS Ʋ~E? daSLZvD,l$ir,n'Ą 3I3hw|y6;E"6)O\N~2kKvusAK=.ӌs^i84/GEM,*JaJ`0CڇMÎ/xLR '',ǝ v "4e[Qeٝ"]T'.YR'?/dWw0GB:͘<_wL*h_?"fO3HRiuגvC7ŊPs>]I wd /+=54v)<ڤ,O6q'ǮERDHʖN~2_yɮ`'79yky#H'z>lZvD,}ldNOA3f5c+  AW1BS욐r4v)lR𓁏 X,?鬊:??**J)գN~2kc/u`ʕ}&H]#FbWP6XTjxТ.~ԚdEv8p@|q~2jOK_j}Dfٯ{Va,IM]TvD$?+BL]5 Ю>M V?&q˛J\ BZTVO\*'DRڤjO\b|p[,u1ujPq7bICm"PW&H ,ޞ"Ɋd+NƍguQ|p)O\*S'IՐhIne͛32\SS9~?gzMѝ;5LvSXXNNNsέqK%R?UojHpOR*~-H~p[,uϕ+zp_Ggu}?bHU6belF+**%'' ,9eĥdf{[UԐ^VgL:?٬Y3/tҠA|||0ҖK%R? aIDԾ6,O&-TWF.((pttݹsgd^}HT" l_ }?v$O\ze2330SzzzZZ}|| QfܹNNN'N"q~ROr2=C-~)''}?v$O\zU+q:=D<1cܹsZW.+R-'&)+Kg4!^"|x9/g+J=$l!'7Gj_u,ɿ:qDccc唷cc*@ģ:/ 'jBJ1Yy8l$ кuȋ!îeK,D{b"6)O\$j4BKiiif&9i8'E b~AZ.3&+M#/EǏOo޼ ϰ+NDPb"6)č*++I؄gt\}L&}60->M#/dgc @24J\OʓC unyUK3:•*E b~AJ6}~%'+WlA5xďB+6m/a Çב.v+j+j%K?s9賁AO+6Md,0ri]s xYhGx'OnĥKyd4@y?lnG2;쎴M!盖Ya.QHq~RTOUf^b)&RSri\SC{9~Q U$df8p AzBI.-[b󋤤yk1%nnmӣa`ρ}֮)|e8jԫ8 O20f.$ώayQP* 06lf ϟJ5l/E8;;ׯ_?00022zj<<<-:~R[ Td'2>߽1B.~xvzNPG.b}>?vbō!Lrk4"_@%_>P~^^}1BB<9{833QYYiZҰu%%%K, z42 6Rϟ,fBLDF7r׮GFѣәX\T}~rr#uXXf/9~9,,O6EqNNNξs'N3f" ĥKn7sa~RUZR|3~R'[ׯ[򝑅mt+99Ã* /P^^n&$$G'TvM`\XXhU[.]Լysld9`ȢG>h޽{-Fkj%Km 3K6cs}7K+' {?j%Km ۋ"RӦM)R-6oޜ?y!&K8?ټ 6lĉJd` Қ߽T >9YxHIq~%O6ŃYee%7S4MHH Kh/(PS9::6)O\ܦ`f JJJ$AN>>>J0b8!&K8?TN8ȨܹS1@J]-{m6s~(={4NOrto޽ϝ!z&lҤ_}AdţjK8?KHHP g4GJ76ݥ!׹:|n! , ?L.-]ږ,Z Z D$kFЬUѡS-iMm̊AE"##嵣z]%-y3R#R-$z  lD$OOn\Ƞ#Gf9գGʏI;8h+ÇsU:kH+ۿ? VVR~" )tSݻW LY4]vHKߠ!Cz%'ϯ?lMmo߾JҔnH5D=GՆ6lBmBvG|yCy &0+)C;p Az_3}HLܹssv8̟W{ɶm~'@գGwðAO'Onln:ԩH ?e`>`[bobLhh ȉLhaWڴiruk/)9ᇢ%AAzrGD|% YQAOqfښ4ixROU28{zAvBލ8f e8xaQ bf: :P A*$m`^xJpK0z'vVEeeYíe7?P3 8 7n ZaaJT˲nYffvR. X^<4c eN B -[ڑBn/@%'g]nb~0l b~y4^zQNU2EVO>ْHʼ(|ذ'x.@P,a Vi`i' ,z͚%LI6|C3xvqq ;kf{GfSg0UOIbhJ^-Yاt+|}}DaBcfQZE/fP\f֥&`ȑԆ 0}wD;/!/OJJ\\Z9t!Gҥ<O5ԩ~d?tյH?Ɂeqn.ahܹ82#| j1?ʡ$iDb>|x_w:{B#I&@7oȈrMM]$5Zv3=ue˖>m鐐 SO{ c Omoԉ6iB괼7$K,[UX(.AČ;ǏO.\8Kti w'tZZ ~z;:"asvGAOkyqa?ʃ-Yv93xhL%=b :Bw";[(,A]Gqv/% N !5Zv3=Àp36K{;wriЍa% b&EڮƸq[gT11^T=~,|YٳGW9X(0'ᅧdMCvvMP&6v _n•+zү'K2kfjZnC@lZd=3O,Lvm? Bә5z׀-!PxQJX6(#[Xm*f [a}vΝ3fޠA'5a~RU`" ld%,«9?q Rs%5~򦬩ܹ!cd ?qBq~2YE0O,dĉJ7CM,q~&hj6jH166?" UO@v0RmRdZd ;)nEL富mxHIq~%O6FldbƌIII6F v cƌQy'޽{9ZxHIq~%O6+ f oodA*((H)o`_’wyjj%KҥKdׯ7o\(oi5!6)O\f Fi79qQJBBB{Xnf5~(={4NOrto޽ϝ!-lҤ:kH~򝯾 2rB6q~%O6f yBQ}6l2mݺɩFYSfnf֐JGV^qPЎ, ?L.-]6.{JU2WXl6O߿]#ub)K,F {0::RFZ}}:ŋ$njzhl|q~2+ YF`ʔ)ӧO_dIddҍR|||VAN,lCjdQ II$CWѣۇ䭷&yztRXّ# ΜBʏwXNנA ޷_?Ͻ{WIj"83Mgmt]( B8FP&cڵ֭K- 9;;8Tx̴C{}~7#2'l!ciTB˕%aQ?U ) rBť5X0 BZ\L wʙK4r(?n($J]2kI]0EE)pn {%m3izٵpn0335T'#d1w]dy|i*,Jݼy0##! vrk }}irrVOZӀ^gngk\_mH^P~P˖᧗^zQiC>r$џNL)//,*ԠX XNhzHtr15kFDBjJJxHH 96`Zݾ}.&;ϯ;]˅ 9ӧ$W ?HebK67}f`dqLR7f4gưK1Yzǩbb&>"i{HnƏ\*WI,KP6SŤ0B{@@O;&'6v _٣[%kLשSBfHZPun {m3izٵpn03UӨQD/ _N`EGjduf| {K ҵ]1aGNOgb /⧏ UՅekX 's <"/ 4J VK.hu{.S$TYU9?q3,pc6E}K?y:$Tشr2`o+*@{g ??2JΟ5b/~kWG:X@:ˋLR7&U~⪅dn3_03\R_O*OlI&=$i;dBM`"'gePP?P? TVBpBδiAXrL%Vq2&%%1xHIq~%O63sΥ]]ۄz5_*NCI-@%'I9PhMv{"Ecfp{{]b'#d1!&K8?۬M;wn7iPL%'ф#GRugYHO5ȄB] P~p! ݺv ?CM,K%S>xdƌ_OG۶m `tIOg"$' 'vǏO~yvϞ]J i\"v{5IU 6)O\f`ԹsFL>`tIOg"$' 'v*B//>VdܼysHHIfpr\d|6&ꌟ6)O\fϟL(~2ZdȈz?sݹs$= yvKʒiZ9M4> _RaWgG9:7n\Y2}d_lcϟ}J2v>oV2ӽ{Od@f4&frizLFN6-M׹:L8Yᬳ)ϭN`oj4Ͱ$::R: 8 \uB:lYv;wfO6&S$Uq3lȢ:RWTAJ23^mۖ0Fy>>n]?xmA'ZwU\߷Go>VaOZq%vϜBʏwX.F ; &ɣ13幵?DVt9이06dH5'&\!q#1?lYܖd9?٘Lu2ٹI98|ۢoP J dfƐ2HjР+=8$%͛;w̃Ǜ6mLR#&/i̲Xb/.!trz$MC:W zׯ޽ȿ&(?n'[MO\2OF3}` |Sm,˄-Z<*' Zm„6#]U򍈆S?4{-$N2$55KEYYKx-' TeVy45Yz] ̓nnmv/;~MBUFUK4rz$kM׹ TGUwPpwߴͺL iw CLXxTՙs%KPYl ecǶ*o޼Y˖0İ:jϨʤ֭S ޡY|'M` %:wpt +>l/2 5kf2U^aAܩ+pu2htR}Vx-8T(wlwHp HL:Z)MoWa ,s)D(Q#Gs# /yeĈxdt @AOǪE?Ҳ(!6v@\gC+=:ٷo)Px~O{kB2.IOi؅%V|O{Xl>HOYR~B۹sW_|Qlڴ@Kgʊ]%d Կˠ柌N`T,$į⛉㗛GeJ :ئLczb ^?^/,S ~']$矖5đ 0rj> eoquGjeՎ̙vhmwe'6"{֧O%k]^mۖ0w~zt.t֭QR]R-6F=2&)H5d/PFa Xr5$q#姄 R?J],a=kb1oO::)9;Dˣ'<*Ǚ ݽG# QOHDDL >qͺڴi`΢#Yf8g\߅+w\~6y&1~<Y+lTW柌NO&i Fz[ L[y(J몭MMME?͜q/g?9_ iطOskO[ O!NLTO'qw~ءó3g+(HD'd_@N>>ww1Bj۶x TWkk!q| .'$݉T4'2Lvrr󫫫_Dj$l>7kb {gf3rD99A{S֭SZ=ꫯr??㧤,:z0( _G$ޮ3ĉO>2"#}iīv?DvIwNR &iOdB r*..]pNN޺!I?]mʈ TY^3*ݻ_e\rNXFj.\8񓃃^|q$pl5tj !!l…C آ%d6o>%eźus񏧝r]EEo dKpgZ?<|>} |cVjRIhH5I#~"Tu:L]̤mY;>>vksm9%UӶm+2)..K+kl/5W'LjꙘpV{Xo?ڴi9~ŋ,_;lLP͛匟M}E3PDCIFI ׍7tpݒuQ4c9GmG#'(//MSni$3Zdt ˆ42Mꐐ*NNH!4OeTpj -gݎ[x͑_83I~dmLFD5ˮz ?i״F+UKmՒ`0-meVϰ<B8-| Ǿ}bƌj V㡂nӦ!N_~M sb~tE|:4[MK$~"Si Af!Hꥻ?tPyyx2~uK5CMN~.1?)ACNU0z=Ŝ|픖ܱ,5hz!s2xGWl֮3 86bަMbKJJlmmccchLCOF'm0d; I-aWyzwssugA_{m}q1z18ڶm 'cֽ{粲#F doP2|G~z?S65)|w큦jIÿ:O/<#gX],d._N:v|.$ė3:;ڻw-'E `gg0TWM5`C^^kŚeɅĢE(؁Edb-~BLHHJU$R-;eۑB ߜܹRTܹqxɾ}{>?)iES0otɇ`n:_04O'mGPҥ#[phmo:[<*!\ `*=֣Ǧa[nROu$=p|kN%|lWX6pU\"|^)Pl4+,L[1|ECgϜyömK w(p_ΖQĉ7+a@ד,';w΄ǥf5N?O6̅jT bzeu D5cUV⋦... hḦL̴uZ^[Cr쭿m7),#3{v`ic x j];~U0": 9? XS]W/?OCNN+qI<_?|ݻ ߅-;{M`0 i Ze~6s8ɒ…C@@'UU{YNvW}tGbP1cI;J\-Q#~,GlYZ۲e!PCdor{!<@qpKJ!SU>bVWdj1 VP@?-%O2bٲ={VΚ8dK#N, 26tF}92qo_6]Ɉ]BL,d^7w޽3ޮ*M|eBǙn6Юm[҈p')+ۡz{a<U2:j6I!.YZRnCd ˀ~""&r(pc0"@\\…SػP2|ouЀ޽Jp Pé'|8Sygtl ~姽{ײ'Wc1o^݄sYYlbbT?CNXuԐ!N ʕ(\U}rrԋ/DK_a9,A_+/?1Jyy:32oo`fٿ^M| ̴b?#BOO%q[IO47js 7zK<X4 ﴙ|ȠA0Ae~z=0;: 1̛7 [,LA$Oqʖ5C)|_ƯǠֲ3X ^շxV;1՗^%yر kin83?woPZʁh[b ,||`,Gb.yZ) ͸|ii+!xpKql6j(,Lds<(ӿ]]i.*hS0'bަ{o'ګY|ėH]Rgˡ-ZĶ3O[Nꎟ_/?:aa7!;;wJ&NO⋛('F$+?ӨQ\%tg&"_nN!4G[{|V(8 ~k|ceEn&x@PpImm1%v? Нi1T~ /'"+?m?nQ^|qqCqF/(HDO[b**QT\z&Lhjnhdɚh_`h8 G)X̋.]@zD]L&+))䁹vFJ+]߽a< M;-ܱc9 H=?! ܹsfĈsN5r愓$׬ saLBӧd=('q'Y+H%+WNgֻ̞J+FOF''4ڿL#766¢\*hT]sד&W`' g{_~yH~ؠA^jfܸ<ŭ[73f \tOMfbea#^=/,LDd̘RÆRѣN|w?TpI?$>e ?e+GR &iOd Y/cZn6j 7ёi1I 6hFD’ skOOOѕnHgQ4I#~" NMM3zM5g32:Q4I#~" 駧>|?ݓ(99ߑkZl:zdLRA4'2I)Sٙ(]| j&fZl:Bv ?idOPUU'6@wO$ֿ$$& WDFz55uu6- qwoP۷+f{b>1+*{L3.6$$dȑR;bXlbHOQSڠpSۂ^gAؿnTixp}X8]ybJ& ?yyA t7? S늊f͚hwn~ҷ 7Whr7`fb`0zLbc#cԷ,$uM'Nn۶UB+H/^` Nbp?XW+;1N:v|.$ėm;3nPg^lo{*1٠8=tN=1Llo93`Pghϥ:=*?n8ҷ3WO ?1#z2B899"$$Lh褦 [vpű/2v˶#Cvbw?G&ںԩ[_g b4`c=ztAƻ&hgϦx^v#vCzXC.''ޜ6͟zʿ {WW{;gocc sa[(ϢWOyy,-$FHw?ėg3'n@~ 4'2q"55V`swwVO&fFS[Cr쭿m7),ЂI1cIK>;{M`0 i N+kq,?Se`ڵn`~Ő+۷+?t{Iv|?ܹqd߾=Pjg|?XY@*8͛vv6@lYĞᚕ7oc秬XF` ?SHbtcQ xS¬PIB EvR!:O?x"SXAC5p-|~}EλltMo*Saa"+ߩ. 4-A|{xxTVVj^^?`kkkggNdbFOF'UmpNFa'K6!62$'1d,\8o XJ ܖ[X<`{h|t^%F1@K/bO%.ǎm㚷IXԌÇ7=  wOEyў=826i2}{ >1\ i߾͟.-Ч:!?eg CfY ɿ|QLCw~wT^D'|RK=o±{"Ez"ab+UpчeĄcDCb@54e1(_~)E`l'lY(PHo8 ղⳈ=õpxZ|Mz=[ѣ j/? g4w jğK) ֨6@ cccSff&?i1a,N5joQE[ObrqwssLyf9#'L58IaYh *4F L ~[@'3-6F///ڄ[6h`~⤃e5< HB5t0)wց@(eŤ ihDm$1DfFFT;bccq?X_m@ZV vAiBbc;pK>_u^Pc4:ѐjFDQm O8)H͙EX V\<װC1+)6s.6RϗZl EvRDCIFFh0Sߜo'зokNp`gμb۶% >>i(>;[:hv15wC~z?S6< \ 8VZw^h1h6*ѐjFD?A:4zX8ȑ-|sҲݖ- } O]o,ga8/Z4۷osN ۷+\)B:#FHyspnʼn"к}nĶ4dt!$L##~҃_u^ύؖIyHƥb?[̠ 겍V& ܺuj'`Dž \\W^R]O Pyf[ێ:LHrKKKЉjkk[jenq퉟TLUsd; HL<[Ny0E,\8ܽu{lPcPgk'z޻W)FN{Dm;v<| 8VZw^h1eddh6h7 ##~҃hLH2pG/[F ёQm"~21'#UMM'1-d*Id%%%ZV͹"ɉsp1aW#jJ@(.MA5k֢S޽}J.A/EFZl:zdLRh JI.Uԩ/d`m?5% ] 8Ѧ e7[ۅ>?a#2R*d?v<&3.#~҃$R8:?'` 2`?\vLcggs8ܳgUxxO %x\O 5_R2~NYZI>#O:qΜ@6H2p'l21겍WMN@<֭~&x\Cq 楤@ΝpMw͛7秬X뤰0ں=+u$RSS)Ԗ L?AUUUzMN@|t1cI'd:cAI\/59?;̢͞XZv)n*?=xpXYQO4ⷢtIJ1?AaaaZ) x*x\?<ݯ_M;v,g$.ɳ8~CqH񴴕޹s9K3w0|/ˋgEUl7'~*,Ld^zH柌Nuuu XSS#zJ#~҃W1~U|8\A` Y5] 8ѦB~oPXZOA'tBׄ!l{U Pc$hQmjvb~mtѯ_O秬X77G~IO١˗ ~0  w)PTn7oެegڴi٫8>=zt vuWpiH@QGNRI$ wk?'N bSZ#j11Ib^UI])?{#2'=('''$$Dvcl]l*hI3@Iemz!RAQ"'bDFUWWjZzobFdOʛVpB㠈cQm"~21bcxKI窟0B㠈c?A4Di1j6XѩR{o'%V[cHAJ q1"#~҃t4?E럔[mQ"EE+EO&ňIBjL̨1Тm)99Vj/I[c8e!RqPıRdq\Ȩ6^?i1IL~~~fNN㔭CqL˗ ~0 і6ƆJGN2syyyK^C~0KSBȈ4yq]8ohqhTuـ'+++sБK.w:hLO+J^II$`̭[ qv\p~%%ە{a4= l֬{zzgebt#ف|Ν0֝784wٴ員L#d7O$'M||`GbݺuJý SB{;Qێ)bt4l'w>{I!֝784vٸ$j֭[:L̴NIf.Zj0c䨑#ݹD! +0!d8ydKv?tia51]'ف^?)ĞѺ}$]vpppqqn/]\]]-zJk#ƚ"vh"AJHH/&bW9]} hnTZ\k^hfh[[[B(vUYYiggG-͛7 in.'28~=݈hWe VDh+zD%Z8o-X;p`cvHNiТvM[JMMmժ=柘0O>~TSB!z]-NJ U8;ڻw-\8dvvLcggs8ܳgUxxO % {WWdVw޽sYَ#4|G~z?S64qw۶^jrӳeU[=$9XOyy,-$FHBN8gN {lwYbP a\lDw^b$TeeeDD :UAA^rss>Y#~ ط,} F1?S;차 7l9;w.gϦVاv턣-_/[CTթ Y^kw>@"I{B~1b7:~BC+3t!Yffl(B(*3lBf\hܢTODž>xpҥ# 'rʕ"O>/8/tR=oWW{ʉhtċnമL U-7?ȪKj/!R"zxFIzj!3)?Qd)33UVtl2%fynD럤 tO:BoQС0,mۖ7H$J)?b+++z322¤B'{niM0)R'2~¸>rH]U]]M>ÇB粵%Zj/ ]QQQIIIR{W?4=[[YYnܸD_ #ah;ƀEIU]]+ZSMMMHH=-" \Od*M4~x_l8JHH0_b Bk  G蝤D럤 OTPP`ggg23 oؾδDt>$l`B^z$22kH ۷+f{b~t4a~EEjfZx ֻwO?}[ۅ>4ԕ66mڴ2/A)ߙf5rIK#,F@JOSCDDC#O&O:\`oy;)vj6͒S!SMM $Tuu5$n /3'VZsI5󋌌%enϤ-Z| ط~>c~nyҥ `]v\lOǎ͞XZrrxg`ڵӃgቕU;z~BWujIva;x'Ufw+92?1B=KM+ A'g֭[LBKHH0Ǧf%4R26_翾|}GVCd*!AӦM^߄;wx%22^&MG`Χ YX<`|}p5FaGenÇkȳ; ,hѢ_!(! P J H+O\_ J>HL:Z@ԥՔb%6n߮P0MwҲ;id;"WAA"FOd*{zzJ텹KUGB~?蔟4#..mĩṂhG$"~jJJJB"~"SiEDDTWWKYKQיU}tl_Kq3Ow ?`5|;v쐳gӑ)#.O=᝛hձspu̜9N| ^dd-ǙJ&L[ߗ)1vDR/~GmR%zJ3~7K(<KGTĉ7َF?Xʊe`&%-~E Iar5{xY  ꌗħ8p`c`0PԿT$97 D٪rHZTyy9?=2O={Y(Q:wnK^R*7'dm߾4,l۞ҧOw$7aqބg=O?,?OcXĕ|ɩ'8(IFI;G4v S!"Yz3^D{ĐߎCa5>xpVA)5Yyjf>CZA*;w?LO_շo_L 9G& #$'wŻ9fdwШY%cK}8F߽pJNЇÛvx~x~J su{PjG$ݸqM648Fӭ[)j)&&wHPʽ{νRRVB%c NN.?i }Xj֏unqμyvw ??hϞU(PXخ]kV8++ɩ͑H+-L ?[OS$po9WR\IBg9Ԏ]ѢO*lhe7A4|y6s݄O蕦N`;gN {oUᦿ%%Yҥ#'NFѵDP~}ԯd\4SSSԈ-0S߾=ZOOFcuGݻۍ'9#< UIb~B8gWbċihoyǾ-ێ {AvJQnz~½igϦx׮ptp˖&fora? BEǎmUVT`>ɁFf~mmm߾}ӳh#kkkzxG\[Cr쭿m7),- V]f<|x3{MNN&E+VLU -X0YX?'Z/VTfhdEdzӪʦ?)i/_*U2իgŋyylO֩%'DVWY  tSVg7Ν(/޵<5C3~RzI#OJMRȬK[42CA׮pry^eivF$ Gׄqr6b;jz?Cm}tOM]5c(1?SZQMVK!^LpVYY)-Z);,D\bi8$f"SX>f`Pi|5w@g]"#]]eIӦ;:UǏ*\?ɣlxA(>duuu47?j;2g%$$̛7Oj/HF&֏/'"D"222ضmIv$&^}u:>:4_O3]ݺu٭[̭(VD럤 njONNvrrݬu&N١3aC<:+|;kdjO{>}9;b٩SG8 S\̈ OAYw\~6y&3جLǬڑiCj/Hƪ'IA~5$Ժh LUUҌ}[aiq'O8a*66699Yj/HF,j$P\R{a j4?11ns“ApUd'#))::zR{a j ?qvm\8`ww }mm^ BR뙒lOfhԓ͛Gaǵ+ZDz,""~"~2M>HM5lƍvvvѠ)"~"~"ĢOǢ'TBBB||^])))4u'cQg_5QOOZZ" fLSSSS^^^]]ɗddde2n~ÇGEEnaaaHgffzyypvN~dee4ވLu'c )A°daaF9Q`(e*v@c.ldb]mpL֭v_}U\ ^f E`BI'''VQvae>Pee%3== Us"AN$ʀ67ҥ ݃ F5 flLk"Odf8q۶% pډ-sr'n0d{@&f6/RvRv Q.KJxv_10Rvb37R. nsTLR4dڢ]A4 ynɓ;׮I 'F T.؍{=zPTԋ/4?n&x@%p"< S+T+tCaD2m'# 4~x NSXM? -E 6cMcTUUEEE clP`~G#Gddnݜx$W!ތo.KM] X~.1gF/q!/o9X 2q5kf^zXff XyTqzLnC5~h^jn?H-j${<^嗧 Y999QjRR Q+ 鐐j( kcc4[nj;_!?﫯'>=bnacccvګW/T+1cW_tpK z0wZN;?Dj Xl9eU3ޘ3'L3yp>xH!^{uj̙q|V~41cq(_P￟bT><|｝`/3? Ojn?JX4d>L`cZh|Þ$X&A8%'G  RpIʕY=gCqJQ?AXJfmm<)+ ~I>0ի%@%B)?}ޗ_-$~86hP?*ظqC17o?ŭ[73f \tOMfbea#^=/,LDd̘RÆRѣN|w?TpI?$>e ?VX4D2+aOMM+66V.7&IiшH$5lPaaa '??Hb'c$ 𓞍dOǢ^DD?H$H$GD"'H 4Iq b>R4D"?$RUU^U԰Uz=I,''I"=?Hb??H$D"5HOO$XX4D"%lc4IOǢ^D 'I$ZDz,""~"~"HDjH$hhDDFj/*j*E$$Vmmmrr^U԰UH$H$GD"Sn՗9t(ePr]X3fx1?:z{8$ķcPxժei^- &~"Ī'#$֭S5~.$]p/p^s2T2f(ӿ3z 'I,ZDz,H$St8R~>ãO~=rxNb${éSG;8Ι^$ $MZ4_J۶mÒޮ.]:rěm(sgˌȿsLxllY*})EF?Μ8JHx/ d' +9xp# EHEO$Xj)`+}[ +Wu_gSVVi,,Lnٳk'm8558ܲex wyepFVٹ9vlKl S_&L矊ޘ;w"7n۷W#~"A԰I$RgomqL~- V]f<|x3{MNN+kךOƢ+ia|}Ұq:<˼??HKd޵|mT#!2i,~b~^^eIYNb~*,Ld{zհxq_!fee;|||s`܉OpF77nj_~Nǎqg◐* u|~8 Hf%ZDz,H$TMRȬK[4 4t3hڵNN=ݫ,-Έ:!?eg cl^=w.#(ȇoݍ~鞚?j֭Qb~??hϞU GWsx%22^ߗEDL$MhWï?vlp8 ?Ҳ&6vBO~6j8#jq$>Pގ́{^p/<|<- Eth ቟H$s5lY?p있kMHL:Z`d&JHHJ$QE[X$t#7o3rb ߈H7nnZj/*j*E$BD"~'#$D∟H$RDDD")?H$H$h鱨#"~"~"ĢOǢ'I,''?H R%?D҇hH4D"H$&OǢFoly (!H$8,ADbHd "(AAD"X$rfkSyIO̦/73TwRBH "#wT@FGTo2vU/KTd2\.ȧ [R1"xnCF*o6~*jv*w:|nUNFUg5Cj*y^TR}џ!$^z~P  P :=UxE@V3*@eq-Z_:f޿:AT\t?0ߟd?9a{ {z7`#Eo ˲z=oq=@gܭ(ޟą ?ĽF̌P= ހOo'޿z (@xF>ހ!|*Cj tF\zFl63cf@pFy̌ !(OQĜGg(`A^z>K5?:#X,g88#BI{7eGg,`>BI_NF'IENDB`java-design-patterns-1.16.0/step-builder/etc/step-builder.ucls000066400000000000000000000230161312550536300242730ustar00rootroot00000000000000 java-design-patterns-1.16.0/step-builder/etc/step-builder.urm.puml000066400000000000000000000051201312550536300251000ustar00rootroot00000000000000@startuml package com.iluwatar.stepbuilder { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class Character { - abilities : List - fighterClass : String - name : String - spell : String - weapon : String - wizardClass : String + Character(name : String) + getAbilities() : List + getFighterClass() : String + getName() : String + getSpell() : String + getWeapon() : String + getWizardClass() : String + setAbilities(abilities : List) + setFighterClass(fighterClass : String) + setName(name : String) + setSpell(spell : String) + setWeapon(weapon : String) + setWizardClass(wizardClass : String) + toString() : String } class CharacterStepBuilder { - CharacterStepBuilder() + newBuilder() : NameStep {static} } interface AbilityStep { + noAbilities() : BuildStep {abstract} + noMoreAbilities() : BuildStep {abstract} + withAbility(String) : AbilityStep {abstract} } interface BuildStep { + build() : Character {abstract} } -class CharacterSteps { - abilities : List - fighterClass : String - name : String - spell : String - weapon : String - wizardClass : String - CharacterSteps() + build() : Character + fighterClass(fighterClass : String) : WeaponStep + name(name : String) : ClassStep + noAbilities() : BuildStep + noMoreAbilities() : BuildStep + noSpell() : BuildStep + noWeapon() : BuildStep + withAbility(ability : String) : AbilityStep + withSpell(spell : String) : AbilityStep + withWeapon(weapon : String) : AbilityStep + wizardClass(wizardClass : String) : SpellStep } interface ClassStep { + fighterClass(String) : WeaponStep {abstract} + wizardClass(String) : SpellStep {abstract} } interface NameStep { + name(String) : ClassStep {abstract} } interface SpellStep { + noSpell() : BuildStep {abstract} + withSpell(String) : AbilityStep {abstract} } interface WeaponStep { + noWeapon() : BuildStep {abstract} + withWeapon(String) : AbilityStep {abstract} } } WeaponStep ..+ CharacterStepBuilder CharacterSteps ..+ CharacterStepBuilder AbilityStep ..+ CharacterStepBuilder SpellStep ..+ CharacterStepBuilder ClassStep ..+ CharacterStepBuilder NameStep ..+ CharacterStepBuilder BuildStep ..+ CharacterStepBuilder CharacterSteps ..|> NameStep CharacterSteps ..|> ClassStep CharacterSteps ..|> WeaponStep CharacterSteps ..|> SpellStep CharacterSteps ..|> AbilityStep CharacterSteps ..|> BuildStep @endumljava-design-patterns-1.16.0/step-builder/pom.xml000066400000000000000000000034231312550536300215460ustar00rootroot00000000000000 4.0.0 java-design-patterns com.iluwatar 1.16.0 step-builder junit junit test java-design-patterns-1.16.0/step-builder/src/000077500000000000000000000000001312550536300210165ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/000077500000000000000000000000001312550536300217425ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/java/000077500000000000000000000000001312550536300226635ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/java/com/000077500000000000000000000000001312550536300234415ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300252715ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/java/com/iluwatar/stepbuilder/000077500000000000000000000000001312550536300276135ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java000066400000000000000000000063321312550536300312020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.stepbuilder; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * Step Builder Pattern * *

    * Intent
    * An extension of the Builder pattern that fully guides the user through the creation of the object * with no chances of confusion.
    * The user experience will be much more improved by the fact that he will only see the next step * methods available, NO build method until is the right time to build the object. * *

    * Implementation *

      * The concept is simple: * *
    • Write creational steps inner classes or interfaces where each method knows what can be * displayed next.
      • * *
    • Implement all your steps interfaces in an inner static class.
      • * *
    • Last step is the BuildStep, in charge of creating the object you need to build.
      • *
    * *

    * Applicability
    * Use the Step Builder pattern when the algorithm for creating a complex object should be * independent of the parts that make up the object and how they're assembled the construction * process must allow different representations for the object that's constructed when in the * process of constructing the order is important. *

    * http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Character warrior = CharacterStepBuilder.newBuilder().name("Amberjill").fighterClass("Paladin") .withWeapon("Sword").noAbilities().build(); LOGGER.info(warrior.toString()); Character mage = CharacterStepBuilder.newBuilder().name("Riobard").wizardClass("Sorcerer") .withSpell("Fireball").withAbility("Fire Aura").withAbility("Teleport") .noMoreAbilities().build(); LOGGER.info(mage.toString()); Character thief = CharacterStepBuilder.newBuilder().name("Desmond").fighterClass("Rogue").noWeapon().build(); LOGGER.info(thief.toString()); } } java-design-patterns-1.16.0/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java000066400000000000000000000054411312550536300323560ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.stepbuilder; import java.util.List; /** * The class with many parameters. */ public class Character { private String name; private String fighterClass; private String wizardClass; private String weapon; private String spell; private List abilities; public Character(String name) { this.name = name; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getFighterClass() { return fighterClass; } public void setFighterClass(String fighterClass) { this.fighterClass = fighterClass; } public String getWizardClass() { return wizardClass; } public void setWizardClass(String wizardClass) { this.wizardClass = wizardClass; } public String getWeapon() { return weapon; } public void setWeapon(String weapon) { this.weapon = weapon; } public String getSpell() { return spell; } public void setSpell(String spell) { this.spell = spell; } public List getAbilities() { return abilities; } public void setAbilities(List abilities) { this.abilities = abilities; } @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("This is a ") .append(fighterClass != null ? fighterClass : wizardClass) .append(" named ") .append(name) .append(" armed with a ") .append(weapon != null ? weapon : spell != null ? spell : "with nothing") .append(abilities != null ? " and wielding " + abilities + " abilities" : "") .append('.'); return sb.toString(); } } CharacterStepBuilder.java000066400000000000000000000112351312550536300344400ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/main/java/com/iluwatar/stepbuilder/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.stepbuilder; import java.util.ArrayList; import java.util.List; /** * The Step Builder class. */ public final class CharacterStepBuilder { private CharacterStepBuilder() {} public static NameStep newBuilder() { return new CharacterSteps(); } /** * First Builder Step in charge of the Character name. Next Step available : ClassStep */ public interface NameStep { ClassStep name(String name); } /** * This step is in charge of setting the Character class (fighter or wizard). Fighter choice : * Next Step available : WeaponStep Wizard choice : Next Step available : SpellStep */ public interface ClassStep { WeaponStep fighterClass(String fighterClass); SpellStep wizardClass(String wizardClass); } /** * This step is in charge of the weapon. Weapon choice : Next Step available : AbilityStep No * weapon choice : Next Step available : BuildStep */ public interface WeaponStep { AbilityStep withWeapon(String weapon); BuildStep noWeapon(); } /** * This step is in charge of the spell. Spell choice : Next Step available : AbilityStep No spell * choice : Next Step available : BuildStep */ public interface SpellStep { AbilityStep withSpell(String spell); BuildStep noSpell(); } /** * This step is in charge of abilities. Next Step available : BuildStep */ public interface AbilityStep { AbilityStep withAbility(String ability); BuildStep noMoreAbilities(); BuildStep noAbilities(); } /** * This is the final step in charge of building the Character Object. Validation should be here. */ public interface BuildStep { Character build(); } /** * Step Builder implementation. */ private static class CharacterSteps implements NameStep, ClassStep, WeaponStep, SpellStep, AbilityStep, BuildStep { private String name; private String fighterClass; private String wizardClass; private String weapon; private String spell; private List abilities = new ArrayList<>(); @Override public ClassStep name(String name) { this.name = name; return this; } @Override public WeaponStep fighterClass(String fighterClass) { this.fighterClass = fighterClass; return this; } @Override public SpellStep wizardClass(String wizardClass) { this.wizardClass = wizardClass; return this; } @Override public AbilityStep withWeapon(String weapon) { this.weapon = weapon; return this; } @Override public BuildStep noWeapon() { return this; } @Override public AbilityStep withSpell(String spell) { this.spell = spell; return this; } @Override public BuildStep noSpell() { return this; } @Override public AbilityStep withAbility(String ability) { this.abilities.add(ability); return this; } @Override public BuildStep noMoreAbilities() { return this; } @Override public BuildStep noAbilities() { return this; } @Override public Character build() { Character character = new Character(name); if (fighterClass != null) { character.setFighterClass(fighterClass); } else { character.setWizardClass(wizardClass); } if (weapon != null) { character.setWeapon(weapon); } else { character.setSpell(spell); } if (!abilities.isEmpty()) { character.setAbilities(abilities); } return character; } } } java-design-patterns-1.16.0/step-builder/src/test/000077500000000000000000000000001312550536300217755ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/test/java/000077500000000000000000000000001312550536300227165ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/test/java/com/000077500000000000000000000000001312550536300234745ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300253245ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/test/java/com/iluwatar/stepbuilder/000077500000000000000000000000001312550536300276465ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java000066400000000000000000000025001312550536300320660ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.stepbuilder; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } CharacterStepBuilderTest.java000066400000000000000000000127241312550536300353370ustar00rootroot00000000000000java-design-patterns-1.16.0/step-builder/src/test/java/com/iluwatar/stepbuilder/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.stepbuilder; import org.junit.Test; import java.util.List; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import static org.junit.Assert.assertNull; import static org.junit.Assert.assertTrue; /** * Date: 12/29/15 - 9:21 PM * * @author Jeroen Meulemeester */ public class CharacterStepBuilderTest { /** * Build a new wizard {@link Character} and verify if it has the expected attributes */ @Test public void testBuildWizard() { final Character character = CharacterStepBuilder.newBuilder() .name("Merlin") .wizardClass("alchemist") .withSpell("poison") .withAbility("invisibility") .withAbility("wisdom") .noMoreAbilities() .build(); assertEquals("Merlin", character.getName()); assertEquals("alchemist", character.getWizardClass()); assertEquals("poison", character.getSpell()); assertNotNull(character.toString()); final List abilities = character.getAbilities(); assertNotNull(abilities); assertEquals(2, abilities.size()); assertTrue(abilities.contains("invisibility")); assertTrue(abilities.contains("wisdom")); } /** * Build a new wizard {@link Character} without spell or abilities and verify if it has the * expected attributes */ @Test public void testBuildPoorWizard() { final Character character = CharacterStepBuilder.newBuilder() .name("Merlin") .wizardClass("alchemist") .noSpell() .build(); assertEquals("Merlin", character.getName()); assertEquals("alchemist", character.getWizardClass()); assertNull(character.getSpell()); assertNull(character.getAbilities()); assertNotNull(character.toString()); } /** * Build a new wizard {@link Character} and verify if it has the expected attributes */ @Test public void testBuildWeakWizard() { final Character character = CharacterStepBuilder.newBuilder() .name("Merlin") .wizardClass("alchemist") .withSpell("poison") .noAbilities() .build(); assertEquals("Merlin", character.getName()); assertEquals("alchemist", character.getWizardClass()); assertEquals("poison", character.getSpell()); assertNull(character.getAbilities()); assertNotNull(character.toString()); } /** * Build a new warrior {@link Character} and verify if it has the expected attributes */ @Test public void testBuildWarrior() { final Character character = CharacterStepBuilder.newBuilder() .name("Cuauhtemoc") .fighterClass("aztec") .withWeapon("spear") .withAbility("speed") .withAbility("strength") .noMoreAbilities() .build(); assertEquals("Cuauhtemoc", character.getName()); assertEquals("aztec", character.getFighterClass()); assertEquals("spear", character.getWeapon()); assertNotNull(character.toString()); final List abilities = character.getAbilities(); assertNotNull(abilities); assertEquals(2, abilities.size()); assertTrue(abilities.contains("speed")); assertTrue(abilities.contains("strength")); } /** * Build a new wizard {@link Character} without weapon and abilities and verify if it has the * expected attributes */ @Test public void testBuildPoorWarrior() { final Character character = CharacterStepBuilder.newBuilder() .name("Poor warrior") .fighterClass("none") .noWeapon() .build(); assertEquals("Poor warrior", character.getName()); assertEquals("none", character.getFighterClass()); assertNull(character.getWeapon()); assertNull(character.getAbilities()); assertNotNull(character.toString()); } /** * Build a new warrior {@link Character} without any abilities, but with a weapon and verify if it * has the expected attributes */ @Test public void testBuildWeakWarrior() { final Character character = CharacterStepBuilder.newBuilder() .name("Weak warrior") .fighterClass("none") .withWeapon("Slingshot") .noAbilities() .build(); assertEquals("Weak warrior", character.getName()); assertEquals("none", character.getFighterClass()); assertEquals("Slingshot", character.getWeapon()); assertNull(character.getAbilities()); assertNotNull(character.toString()); } }java-design-patterns-1.16.0/strategy/000077500000000000000000000000001312550536300174725ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/README.md000066400000000000000000000031421312550536300207510ustar00rootroot00000000000000--- layout: pattern title: Strategy folder: strategy permalink: /patterns/strategy/ pumlid: FSV13OCm30NGLM00udktCS4AGOaJsTz5tRwSkBstLiqj3WbhombC_n0PtwbKdB67Y-MX44NAerDjSJFOwE8lRuTuBRfD1iJKgRC_88SnfFn8aD-ai9vczFO7 categories: Behavioral tags: - Java - Difficulty-Beginner - Gang Of Four --- ## Also known as Policy ## Intent Define a family of algorithms, encapsulate each one, and make them interchangeable. Strategy lets the algorithm vary independently from clients that use it. ![alt text](./etc/strategy_1.png "Strategy") ## Applicability Use the Strategy pattern when * many related classes differ only in their behavior. Strategies provide a way to configure a class either one of many behaviors * you need different variants of an algorithm. for example, you might define algorithms reflecting different space/time trade-offs. Strategies can be used when these variants are implemented as a class hierarchy of algorithms * an algorithm uses data that clients shouldn't know about. Use the Strategy pattern to avoid exposing complex, algorithm-specific data structures * a class defines many behaviors, and these appear as multiple conditional statements in its operations. Instead of many conditionals, move related conditional branches into their own Strategy class ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) * [Functional Programming in Java: Harnessing the Power of Java 8 Lambda Expressions](http://www.amazon.com/Functional-Programming-Java-Harnessing-Expressions/dp/1937785467/ref=sr_1_1) java-design-patterns-1.16.0/strategy/etc/000077500000000000000000000000001312550536300202455ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/etc/strategy.png000066400000000000000000000360411312550536300226210ustar00rootroot00000000000000PNG  IHDR-|;IDATx}ml-yF~ ׬4*D݆L XqmKPEBD)W Q|$ݰVyȦU|lJe*sk[}TE 1@GĖE&h{]ō?9;1sٝy< svg}ggfgcugS@ԃT\.X.7TIJ`0r ]pbD,{Ha!+ "=$tX3`076e L"" bCB5fs`3XÕV/1:cP}lx0+2o{{2;~bp׊L`Wxen͏ewѫa \@>lﰼ h fxWpo02ܻWb2@2m\)3LƅĝL&;6RBck +\3o{,aeTâ+PĨqAImFhde*lYvF'Q,ꝥҙ`WΘ7½s"]ew"FӵDu؛ږlz4LyXSwЍ`Wn7½M)eny{MD<4L0'7lLB{b^ጹ}#;g?(ҥX{/btkƇn'v3SiW 7ޓwó;-*R0+F fJc0V%;h` a0uiNqMVy֐IN;>r07½|:prna7 !Zuit'W9`Wܾ 68fFI \"=$tX3`076e L"" bCB5fs`3Xa$+ "=$tX3`076e L"" bC߸گ,yM~L^䕹"|2J3 1)J3ב|ty*kM lÝܒ0q|8ge!EM,[! ^ΕΤ:R]:ywko_'v>›DUhJ0 1 3Ko֗5-s]+Fƃy//.Zrs{jHktiU,ՌKʝ:].䁉{'D_K^J4W_##'PɹELå8ጕo׊{0E%_:I+lnXdq4$njX;!l3+ԫb:dMn>mOӣ/Ο.ˇ/dM谏r-xIr_|Go; ?m$40M~LnHȝJȗwr+ù-םCZegl[MmImkeEiIfZӴ_+lnX[SX(W_Lyq_%EyoiO,Չm`;\PnZ>|溙?ګ]W?>? ƇO7^s|JZz-`ϘO+ F_hN<3ά4aZ*ϯVoMh52WsQ/.yeYfs{B5RzNV?j0]ϑ%cҍОXҫn ڲzVɡ?~>'=iTZ@",C5f:LflX^Fl욑p[} ^]֬dYC lb2=2<'^SWqw{cȄ^:p3Bda[[ϐ䁉ݧȹ[zw/kW2~us֗z2a o]z2ͲkԹґD}`M0VIͫ^ꈕm6W,TC 9 |l$& 4~IG%tXD{byHf^$"QϹ koM7}ƍI_<[x$9$G 纰W?2ZK2LKVlr:zklk̺5U;gr5ے0&zQvKanZfs{B5$<'-_Rc i Wxl~TBE'jFtjq/͚<0aUǿ;KOw%<~7p=9.MmY fQpbdHQEdB2eK;&zQv7N_սQ䘕-7W!tX֫Ă4Wxl^TBE*j&]fsCIaM$6٣y|Ä"ȘU"$7AVr2GWKLrSW҄ >-f[7V`S0쒏A3o07Wp333%.'Kj͌J谈ŲWsS3pv9#Y!k\ 7 &?:S-R.?aC32([;Nc+;anXu )О 3cA-嚽]z^*YZTdj0KetXQ+{cnPϩխ$<"fktX{0 _gH*_:aE썹A=5S =6G~^ۥQ`076e L"" bCB5fs`3Xa$+ "=$tX3`076e L"" bCZSq$"7CA)g3?I7fc^ᕹ"|lv, nmo369+·= }t$,XNkzf}f[yJm&eVAKɭ>@,^yJ}4Zy-./( f<;lf hS0+6+·mCb^0"#," vtטF6LSK/$[1-ٙlHG,3'KDk;ٗKK9_DdO9 fxE^a"|ۢ1)yxy:LXfP;&ffU6|PḭB6m|9<$^$w$^׵`WT+·s.WiZ˕0$Ce,oJNe*LNYerNINPD D= +l1WoW۾ѢXWaa1uz+D5G :*&YQ*r]r5;_Ng&z[^QWbn߶k -exxU^ K.j3&Msm8NQlUGe;,P%?w>Ux5mjЦXW%7f:L2%35Ih\@ѝ\`wQU]Tlf!K6fs`3Xa$+ "=$tX3`076ea:0+ =7^|" bCl$^f!ÚIWAD,{uol_/W߽T3A0%bCNSk٨~@J's !a)%ة` R"=tJK*swh^+ҋ}v#B):[7m2?r~\Mv&[UsKuŠ4+K#w],2x, Ql 2/GqrbCRi<;BrkHQɮcmi cf[Us9+%Dsu@-.lKhF!l B2/yN.cyFk*P9ELׅC4ːwpY9Γa.ww*@i.Q>2PnnGoKӱc4Hz*bG]h|hv7?w볝?F6ȿu0ri i|RbM|&ӤPW|M+|66ifBo,%ڐ3',,bj}npjnE]C-4E4. Aե\IXS-0n]&]KU #D%$l"~<;-tQ+`(vtVc'Rqh»bo;N_pGRriyB-*m\I74(#Ça%ʼnEWbڂha09Oi1IUŞ#hqW͝Ζm eQ+kT8Zr]t~(WMk.k)j_$}Xf 1+ֳj}y|`+gξz6b,!}ES&Ť/[2Vd 'FeJ {!#dwn\ius-sI-ELfuYs7ﮕRǂ}8rKc9顋ILjQs+t{g\//TCq;IRsr B'ɶp*e ;SYaFΓa%Ҿ9:w )`-EUrڢr]B=C܍km.đ\:ˇkR*%VvZB#WP:䅇>O{/&Wo,j{+SjPޭObŨؼʋ׹Zah֐0#0M~{Fм4⮚[.C[-õ IV3q uͬr'~׺kY0Gr~,6ŲņGb \?ڻ뚯ݱʹ3wWLcÌLJfwӟ(4b$]*\z2̏?$Ѿ"7p|d;Jq[UskFJnKʚYwsʬ#G_l@,f]:;FOjC0»/>B_%:m TG:yqa! P >kG1T"׽~J\3w ;MLLg8OS:{´y MVfkv.%[s]+ϰ2̒a^[J%u!S.C1. ޲f4UUC2}&:nFp:]μrg#ϒN.W l#^xPRيkݩqɻ36V:O˛K,._LG~ASb0y<0#sk&$R,gɪ,/BbF/Yi̒y!d*o090G.l9{7l%Rٱ`26aJɿe颒ie{r8n~"IoN$$(pth&S? xI6ݒgǼ )J^bj[2b*n* +LSU%GGG8ܰ'Qu`(vCW܋ϽpN7Nmq o%bmN shlf{  D5<^0#sg2[;򛂘g58鴠Y66Я4cS)zL4Y=LU%nMBWT dډ'u{?ڻ뚯ݱʹ3wWJleKeJX9A2 l0[ZZ:5٘03s앧 #N9bk~n2~TߋϘtފ, 7>Lbv-}SC.TU ȱ|e"eT9##UI LSƦ_H͘LccR|W6+PT)J7W6n^Rl4G%ښޥ3gLc32l e޺A="N#yK̎MQb6}I%F|p{vbά.l(o*%CS8J `b!nΌou,.ʠsGj#-%fnk)K:i*^ %9)tlc>L^Ȳ4ofpw];˰g"KQOBv$VO!oʺkJ*pI:ful>[ZZ-]!t:˗_ZZvz}_IJk&vh6s8O̝ q{ᣣ}Dѝe L//_vi˹$szz}!G,{H"\ฃhjjj TyG!@ ftnt[&O l^GA`LS<c[ a G//ppFPlZi&r&!sTäMCS, XYs4]9tgf4L9`~`$SNT%a#ܛ?ɚ=[o"谆pk l0By(~jx::ޝZ(dg[-kqN ./js 9`~LLNNnllԝ谹s!C]lo}돑 "YߊjiE^({I8J"~pd']_ێ;O!1i;i&yV9v$aJq8Åm 9NaK7m{_8M6X";dqSkSe#B v2hkoXXa:s@ޞvFZo2w5_csg f8651w0vԼ<饾<>,;: KtX9`~RсRhSSSd=oV u{I;}_SSV/dF^~;㣭 l#~;D0a~~~nnn8k.Ǎs0.}hfʲ:s@ܤnmm՝n*t=u|`|;sB0ҥKs!ΈKۛml0:,Li= )8:uҵ+0J0.CGk:%ANl_z9`~.cpC)V;0u ^ظq`:ByDaLOOw]K&DVyE0i}ҥk %t{qpppԩP^KLL\!@A;:8ɵ3b/fffj`A΅ ꛛsQtSnllԝ E7Dݹ8qDժ;#01ݺ3b/0Ճ9nX߅zWkkk: pa/v*OΈX]]Հ82(I-@My̠Fuax#êA2sE"À`{{x3$^ Hɣ`=4V599 SIZ16660WXA\2u읝: h hy]vd謩 } 򢵴0 ER_/,,ԝ:AWh6D"fE39tnehooouu\4DםmSFH@^(0|N~GGGX`| 633NMMa>x@~T%O5+6&,,,lmm՝&&RE7@ށTtZR{5&fxAY &eaٙm/b.ZA?ģbpFDbO@ ޮ;/U=U;TCA @-D! 0`kkknnΓ{yT 2MNT[N+V3ip;~dUmJ%A8[ӹ? oZugjtp'\X"qm(3b-:?(m*6WYSxt4==}pDWe8E|5a oll87$םBTQ)O}V2%cJ0ٍv8y&?P: X]]h X}>IH1LG=;%`+2#Iu؛ U4tXO8d1`0}w_[[kKU zÈ_-,,X6t 򊿴ԤBԝDq>ӯ^W+Lk^l3_m+t >/ : ytxq3@|H ubR F0kODG#{`LhZxm199)/DtRC39bVWW1iA&( X@@ieggs$Du򗿤"dM6660.y\@@ *`hM6,fEqScťK6퇾cNry\d,M}cK#w͇Svՠh 1: ƈyb"{<䈸GDqbzBpcnWG!0*0;;;WdnmKX;fcŹG fP_-//x@@E x:dilb$4Tbh6b"3ƺQtT "eY.ňR\ZZ}pu[&ЌINA\7Ü\tTڥz@9*f?`tHdmM$@] a; F"{ΎbE7khӦ-Ja2)vvE nD"ΗFj۰駟?hJ)vvMOOlSؘQSJ,,,wuW I_co&buu(03s山0%`| ysI\a?^~~.i[d>^: thH*W^ye<611qö}q~ j@ `5@CB@Հ .q Vv V LVk/q: \tZúgQN`:-j: \F}:l=͓[4YCI:b'щpכ [pO>%*$Mk Xh/8iJIC-XtX*JKtf iP&C+J3QqHm ^QHoI)UL9B@-Xu/wO >5?HTIi:,>7׍O^E9ug0[q=}A"rgbF$ɥs9P.jҜSZh njԠՆV$%J^1m:L9`,ca>0JF}:2{tpUڰ&bdI#4WTೌ_/*;U[u<_ r)ZuFœL?T ~%^4{Iga!t-X 0Аa"`5@CB@Հ .q V: 4$t-X 0Аa"`5@CB@?6νGK۷|[KɞڥX#E nj(uؓ_1_ڃQmS&2c}&4V *CÌK0p[#b߻Rm祘J4G|__xjaEGUk=M.q VCaoۮzxL'ldϟ>'GI^+^ۧ^2LQ+Tu5k1aI%s)E nj:lܵ˄i~!Cx^쭽ĉt:i;YdF v:)+t GQs׏?"K43TKWϸ]*cefXB2o[!v>o@IӼݟp;$MB%+Y)zb}3@!/Da"T* S^=v0 *tS7-C@xvg>&!Ms6aal3ז1A<D8F]qmHd)pC1LɘRCҸշ q VCa7>O򟞤i.n-&{OްG2p4&Ҍځ%~CK u"cy:,c7SG3e0p[wݷ\⩗d?z瞥h$nVč_RSܡCRok% </u:,#>)o[Hm~o[~|Uw};'oxd]uP%F taE+%2u;ٟ7|/iPU@̛|a0`5|Dlr={O^=a9z",l?KFVh:)Y&2a9ۥЬJUa̢Ea_]]tVdFZ ͨs;&y2t-X I R[z;&y2t-X [tر_'=,e2t-X th7E nj@: \thH0p[a!E nj@LX$f~̄: \F:,YPX<D̶R(ƢѼ=u9̥axGpOk U`N"Ͼ4 ﰙtnX0p[U0F2HH]%ˆJU-6ndKa;ĉY[3ِYI҇Vwr/sɞQWQSt(a{a"ؖd{4;a3@߰3J: ٴݎ(3d{ܑx]0D njTÄN4N$"lIoSZ/0P)LNV7GSq&QƠFB魴U,>10Uv&Ͻ/lSu$t8 -XƇC3>c҄bGI-nR:ruX U: < njdl2+T]+YDj&RIkDhxTuQ9 ۲/*fgg/fQGМPY%E nj@Yx1,lTS: thH0p[a!E nj@: \J Ѐ= 4c0p[a!E nj@: \8}pa`5f q V: 4$t-X 0Аa"`5@CB@Հ .q V: 4$t-X&l}|< mwa7X/E njH QKQ~'Kt؀a"`5uؽ;O^%Q0aQcVKt؀a"`52tuܭv~Ͽ j4 E 2OA,ĔI\t[N8vJT9;AY%Op誋aa(`5t:~馭s{ja`VNOTBtwFw_|[A64iOh̾2R·T`Z0NJE %ʯ5UKGl@A@pcWs0p@0p[aO: \Ft3!@0p[MaX .q V: 4$t-X 0Аa"`5&&UVt@=a8 N!eIENDB`java-design-patterns-1.16.0/strategy/etc/strategy.ucls000066400000000000000000000113441312550536300230020ustar00rootroot00000000000000 java-design-patterns-1.16.0/strategy/etc/strategy.urm.puml000066400000000000000000000015751312550536300236200ustar00rootroot00000000000000@startuml package com.iluwatar.strategy { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class DragonSlayer { - strategy : DragonSlayingStrategy + DragonSlayer(strategy : DragonSlayingStrategy) + changeStrategy(strategy : DragonSlayingStrategy) + goToBattle() } interface DragonSlayingStrategy { + execute() {abstract} } class MeleeStrategy { - LOGGER : Logger {static} + MeleeStrategy() + execute() } class ProjectileStrategy { - LOGGER : Logger {static} + ProjectileStrategy() + execute() } class SpellStrategy { - LOGGER : Logger {static} + SpellStrategy() + execute() } } DragonSlayer --> "-strategy" DragonSlayingStrategy MeleeStrategy ..|> DragonSlayingStrategy ProjectileStrategy ..|> DragonSlayingStrategy SpellStrategy ..|> DragonSlayingStrategy @endumljava-design-patterns-1.16.0/strategy/etc/strategy_1.png000066400000000000000000000702471312550536300230470ustar00rootroot00000000000000PNG  IHDRFpnIDATxXG1VDjQPbņF1=ĂQT( QT5cMbłu7q[(wy{fggwgwfwnƂ# BAD@FA$i~eA]d z܄~rq222]LU^A422ݍ$&$Lw#I30 I3f{q IMIZxͮ{?Oh8|xW.;$ 򸅏zIMI=~<ۻի%-<|r* _3A7oB1S4ҹsr^={J22mom]\AACD}mD7 SzIMIA?K E%/i9}z-ܐ.7,lbXΝ[\9^4o.PhxI=æM?4i⚚…"E ^EӇM$<Ԍ$&$MͶlN#߼9&/i⤤lT:ageUɓ->`A\\EKm-on**j'H =nB?H4-6v~Ʈ+^dԳg xI{.y~J pYO&jh0f߆-6qI=۷I&+jm]hذ0MCq b$44C4mvhH۶_Z;R34tڵƍɢũ+5u.%k^gx@|ML˸!IOt7%qEc:픘ݕO iJ,ВF)=nJ,&$f3NFF)+l4ά;I2h$i4]gSbv'I;q6WX@~_Xn+24%qE%I8KZPA뇏 ;_-׉22e!f,Le\d#ngnݜ% Ugji;'o?CIW7~~p.4w0lh}jQX3Ψmʞ7%qEcv&V܃{,+~a 8b!}&i>Ij>8PX'iޅȜyiM cyϫ,h 7J5q6͍fyfy߾M&'D&/'Hʱbc<~==^^NOpG !V3v!8-(hj-m8DD4)+՚f3nY`Z߻|K;zV5'} imMhٴv|xMIk׮!|'-F)5uohxt8Ug $*/KN+">61fuNs|w@@7CA@w C/uxIC9j8ўS T]=revLޔXLDSbv7|XYg!vl`NDo9aI5rsX]om]߅TDVűlY;xn00Ap!TJl -81I+T(?۵eLlQx/7n,]:UzLrmMţh|`-ll\(rpׯ_}0)Khަ˸!IfO^7iWCxp#C#',i{qC|}i^M 6?é\*E֭Ci -%N nݿ.={aʓ'w|ybfgW킂vCZl4ɱc{b'%M[|8Gh^چ͛;4NNH._ުviJ,㊆$~m>9q6qlN+~={Wryt 폽#yI[z6Vsvgʕ&r{.&!pCNJ(yS] nboժ}x]BI;th̆ݻO`?'4mT[Zys7kVy<0]M?A4n}1czInuYٿKh 5=Wk[[F\'Z]XnQ͝[/ZpuX?OvTz! NX1KH޵mE.:99yIlpwwoĉq*˗e I4Ne\yJƐO5N!Cr/~{Ξ\I_G<<]%6OUdd ĉ~07n;)ɋ/_ު0[foBAheO 2%qEcDy)}V:%fwY+{ÇWh޽@SbW4"iz͞lyΡCdϸI igάk׮a KO12qqKqt;wOF)2hB=g[ɞq'nJ,($M8wynӦc|yU@=KYRCBơ9Pb޼aE]wHt7%qEcy܇wOf3Aϛܹ?iР:&E]wHt7%qEcy0''K˼'L?AS.CFF)+4}gKHXnȑ($tPl5/$vQv4-*jƘ1="" \xb2hB=g6E7xb?Oȓ'7s%K;$idȽY׳urԔXQH^祥(` 8Ћـ^yfDIIʕq(IZ͛cyՅ>#ÆuhةS I뎽5j|bXjWQ߹sm6k졜lV=|WANIwzwv֡CZ<#ڵߣ@ھ}"/d:˸1 I=oٲ9Rsan,i3fL̙9i;$iYŨq :+l޻}ݴXdd`j8t} | il #GB i89ԩ-[fb[V}Nk/\e2hE8gcFG =ټshW>yoZ]\bףGO$Mtewݑ=(F߿O?f?!i#GvTuu:/!Y4zl3~|o֭ Dݾۻw!ϳ5!#ݔX Iew|BF)+4ALwSbW4 4Nٝ`@.]d Ing@ISD>!#3SbW44;I2h *i4 dw422Me\Thv;$idd˸1v AAA#F}? !ݡ!ƠF)HҞ>} I+ZÅf|BFf2fe$a#n~Νn_M 71SJv 22M)ed I9O:" O>\8OFf`H(۷o1Xb=4ݝYp oJ)&Iew)b4&i9W9a/_yp7k5KO71}48_6Q(f ,Hڃpx"aVVԩytU.,qt/]xV}Vx&&֬Y)ۯ5rd_~ 7=u*![. ~^ f/^n߾QFFYQvG4GVųAkP*e}8mыjƜ[sȿS7yH4%fwm$`.# `!؄0f wQţjcdz28x,ժU='l d.mQ -Z0DzN r*^Ϟ%JE}ͱ%ݼ3$d\+؄GŭL~yHj4:·}ڢՌ9 гgFe!rbCaErOm8tlSZbb沩PU\yƟ<jRl7veg@@qzϯg]Y˝̙u| ?5ӧ׵{b_ŋ^c7mZ &Eu0ݸ#qץ_ԈcU6؄0fSUl9!Nj w##GXDVÀ6m0ODQ5&_n6n*`-_ŋ^S-^oЯ-ͩ*hdŇkB&sBIӼh$]Z(i·}ڢՌ9[7X4%qEC&)1k'g4 oZiN ?x ð*ڵh8l_(@Kԏ Py{7srr`ZY_ h޼PϢۤikR၁pƌ*\@j>({Sɒ6*{w7q>Sէ8gFVX{JKh$]]s'·}ڢՌ93㫩$irD>q[*ASZV3PիWm׮> 9euTvqqD}ƌA솅M,_:Kٳ,hPK[8-/ZBzyFuQ|0?v…a. ]A\][yXf*&pҒ- }YHvQ͔H,Zpz!*C$3.OÑŇv="ի,a͛C6]X'@Cß ы2ի B$*g6tL".-*0C=m|L$D˸Ɍ}ͣVԩMX4.v̺CB?#]rӦk߯,h7vDI”XM%MplK~6-LF]_P߾vKbþ `%ԛ׮E{spE5cbTԌl2hS޾Mrp(Ѿ}L'?H&g. }s%#ݔXMvx[W-*T(}Ff:xqLF]422Me\*is1ի͆ Ə=}@snZagWc&lp'3(BFF)+$sqIOğ=e޽KTqڱc{>xo/QON033'g. I2h>.i[{]r96'On.wO^<")쓳Qv$LwSbW44]յrt.\ruuàvbpfU7oo!z gc&lE^IIf K-35eO #GBjv 2h>.i4ӳs֭3߽K6͐͟- fc&l0%fwJ,Lk^IBdzX] : }ժUX~g޼a5j| dI{{;lD=9xqLfSbvgdHÇW4lX-}P+!3|ioj ̂itʜƳ2ym$ !V< M4ț(1SwͮJ|RI1 ǷQz=Όg lm&k߾Ȭ>}@BEՔӲ*.<R˴浑$'V=89)s+W}]_xq~ E9;k%m3l0%fE©+ .|\tʢK!3}eZHPV =yn $HF&I1vޭ[gɌ͌g$ݳ2260п_BZh;:sZV:}UeѥdeZHjO&۶hw=z/.vsIf zir{VF.]:xttKJǺ,,Lk^IB0Vûtqu_nG#km0$ IӔݳ22_# p!a:O򵨤tʢK!R˴浑$'V}26$=Pٲveز D)E{Gf iJY˩>9tLTDW:kUeѥdeZHB8ή(?,:DHT%KF/nK4c Z?:IM%{GƢ*eBjѕLbcm O˾2ym$ jGu"҉˸ɤAQO2fw˲1]jּ60̰j%qEUI@y 6)&QI'Ӫ:D"Ѵ aaJ,FǦ.lyYO%4&iddlJ,&Ɠ OI21$6uj7M$idd˸j oXn]ʕm͚նcpb}tv8~*<&tNTh7mnJ,&3Z##؄e~ZBuΜY9yDmҳq]ZI21霨q4Ht7%qE=ZC? dQ|;thܨܱKt64qRLL:Mh7QHt7%qE=ZC?؟da'3sר)Ft6S5)\&&&i4(f(il,EM SbW4ٳpMIMzTxzM II&a$ǧ9[O`AK۟n׆rs/&j(YeK6``LɔXMj--i}t*~*<&Ĥs$4{{;~aXQc:f W|3w|T)+YZZD'j }RLL:'*i46k1&i!۷oQZN- rc׮.̏ 5̔Le\Be>iNpLt7mKDʪֺ̛PDC2I9spPАqzUT)dGCi[ [838X2S2%qEc3gTxj&:$ @KGbu}-fd֥ ,im> G%5G`,)˸IHXOEF3)4ѐj/ɛ77:C "kJ‘ 0̔Le\o/L][>edk1%M4ʗ/3WzAdMI]"Y8)+4-22VyJhH&i܉]|LoJ/;xI]"efqddJ,㊆$~H]Vq-fF8۷:u5kV6Ƈ d$ 2CFFF߾}˕+tZҧOmV\9===<wׯq,FN:ոqbŊ&IAdM65i$55… EtRZZtIIIs2eΝ;ӧOwwwDZ|Ȼw؈[n9{/_lkk3׭[,v9tإq GMӲeKz*$Sۍ 6,**jȐ!$i @F)MLLKubrr2d{qJJ = Y0dHHH (3K,iժ;d3ǖ(Q͛jQ=z07^ImIAJ۷&LCP*WyɓK*ոqիsI4iį7n7~y&i[n˗/kڴf$m̙ 〽ҟHӀ$ t?Eן?X[BIV;$<te˖iMMV\ dnt/}k$ii@F!,, Aiiiy-XcǎYH袕ӧ9zլY'R3>>n޼9/i,YRJwՌ޽A}9 I#L4 Aʗ/ooo߶m'OM6yٰa/iЭ:u길6cƌ… ?{tB 9;;;vdg.~~~_~h|$ WDѻw3CqAF$iy^xcOzzfԷoߪy!3Cի"޼ysf]zBgN4&K-[EO>e  44 I#8ϦN:{+ܹgΜ:t(zl.01H}ڵk,Y/(ܵk״Bs<GFIAp$iaGFIAp$iaGFIAp$i\? A!$iTܼP!_BNHBܹshѢo>HŊc>a;jLҨF9$i`[&hCFʆu iE#4P6I.AAA IHr m {ȝC y'~D͂R1W( EBF&a$if %;Pԓ$0$"1ݾ )Q?$<5% O^{&o߈ܹʕEiJOrM֭]nv 9շ1<޽HSϯȑݱ79yuܟLΝ 6 Z믑lm}޽='dC$ia'%m˖PŋGysLSSҠ"))D͚YY|$E ?xO4!?rrBI4/ gƍH &4^xQ7[ƍX<Xԓ$0"qxѣ!m~akk}JQk~OTyH \jolVZvK7__upi4%'MI۪տo,o 邤 $MrKnȅA'LJZ-9$I# %T օ N..͘1p+nZ4gn`HZ6 )LIوDՑu%E%M傃G =NSuNhFfPĘ%YZZ? gK`ns#(sH|G-"1~I#HJxBIIB O(42 #I3[( EBF&a$if %WSܹ?UZ"#߽K"|ykf"X=RrY/nf؏F֭]Çwշet74P$jvԾ'ڴ0ogC؋0|x&i˗ 4u46G5zirJ(`9;v̙5k'ʟ?ߵkY Ns(bvxt3wFfPDMV%Mf;pG[|$_E?լYiȐ=슆MݷoN(ܽZ+Va|wY[$n$̡'cp{E3camm0$ gUZ;5u蔰޽ V`iǧ9MjӦ;ADϫ,h 7okD?l͛JpgkF}Mȧ5NXplgGfo*V,=vl% ={Ԩ:P,_;J_]vEsIV\nϞ`Qڵp̘1H:J7KfPDMyElcma0&z9 kznv'<|2A\'OSSGuXΩ /6v9F>6fuxQ'N9s; . ·𲄞h|p_ kɡ%nG:bJu|tjG[]"Z(7$$q$if%"b ҥcWٲvܰaG~3::n'D_`z˖߿^n܈YttVզ~^<7|`}"-wУAlP^rUT[ P-]Xup/g6l+yΗ/zLT슲]PP^T_=tW˖#9vlO1P6CuN͛;E%M#1MIS;*(hNNK._*%%I3s( E&i]}Թὣg;>~;Ws#/iWOfժ*p;;ʕ9|X 7%=Eԩ_^ nxUˉCY>tkt >BYأG,-VV!o͚oVMD.q;+SnnPGvɓapwvAkU(I,IC O( Ys/3о鹵&fְaM={k|^R< "l:B<< _կ_LsqqD*p7N2p5CZTea%(T(WSjٳBYǧ9}]$Mv#Vr9l䝘XXA3`v$if% t*|8X%{ysg-ܢEǃ~ hܺDIfIJxBh4C+{؈ÇWKh޽@#,IB O(c3gֵkװBҥJ|E%K8:ϝ;nG:JY4P$ idFk$if %| LHJxB(ZrHJxBIIB O(42 #I3[( EBF&a$if %

    pء؄0̤I} _ o7nİ]}VQ#`M(iP4ѓ^G6aBgmfyx4] 5%mh߀nlWR*44P$$a^~Q#vUb011s[o>R+C[KG_;Wn&i'Aں0Jݻ /unlÀ6m]nʕѣ-^)cA?۳'xyp`S4دF(`yB$< ۾p˗?7/i؛'OnI532- ή(?[V>>8Ϟ=`AKгKp_ڒ% v%IIB O(Awa%&H& "M?V3=Ɇ zl7niu%u"ґ-"1Z޽Knڴ_퀻qc׿=Jd$if %}ٳgwʕ+B\.\(w\׫W/8Q?_~Ypa777t~WcG(4vYz&M$''c3** n#SNթS]tIpϞ=Z*IOO߱cǠAʗ/w^z%_ BFY> |222g[l7b'Gpp0i ?퓱[ݺu3$8H"o^^^o߾Ϝ9Sl7o7͛7w~\vmʕc۶mYf8J @Fɓ'7o˗/o̙DL0~Tz QztH"3،1ѣGRSSkXθqMҌG5GZti= $ 2Ν;IHH܅zi6ƎoGj[nm$l AFzj˖-k cyCCC>FQQ 3tѦOޠAE(4<3t2e#өS(5Oy}QfM6gv1#IAdW^=hѢ}7785OYF̙#K`ڴi#߾}{^%$;$iy޾} m@={xԩSԩSBǏ_m۶b+5.]g=$ L&t$ 2I޽;vX+W8EDD VVV:t[Foܸ1c #yMJ3$i>&oVX1+Q `k֬aJpBhܑ5k.wDc$ \!FNgA~嗪Ùg޽{ a~ٳDF2^_ ^^^iiirG$hHFFIA;w͛w #b<{s?;.AFz`#._|ic |sΕ;qAF:CggKr9'''c qʕ+WrX !$i!NbbQ|F3R^= ahHBяz);!w,rYΝI<$i!otRٲeESN<… rDž0$ik׮?g۶mO<;9ѣGgY8"!I#Alƍ)))rGNʢ1#&IAYf5GSʔ)UBFXNt#b _^D caPIIIPׯ_"G I#;wnѢEg'Oۜݫ] avXbrǂ~HsٳrGDv5j(c!СCX4 I#̚ǏorGDn޼iccc>#b4 d&L40knݺec%ؼY4ψ @F)^jڴi@@!׫WOXY$0Smf9 `ѢEj.#Bd40k޽kؾ};4͛7rG $iٱtRgg <899ٔ17Hŋey-۝uRSS@* 40wn!w,tZl?BHsҥK%Jسg1:\\\bЄtю;Gllq!t$0 ={x3gB$w,CFiD޽+w,ϟϙ3k׮B 4yM䎈QcǎVZ Rw͘!I#L]v4nMmҟ>Ç4i©^eB4 =`h6oO?B4dY~}rnݺ%wDAJJ.w,+VxEz`TɵkΝ"t!66ErBIMIaRzjŊIIIrGD;vz}QϏ?.,W. "S0IAƍ sԩ.]-_;Nz r___oooeUHv l(4iRJJ^ 44Ѕ㏊@uk=hccCm%I#9:a|2~ݻ~q+qIųk׮%K^rEdq 5K_~)]4z%Çqff ߽K2ʕ9;;˫WG៘Zf%SS"qI }2QbXISD]30JJJJKK{ꕾmsN vIݽރ~<ã]쐴^>ꙹ%I3ʭ Vt0T{܏prrnvjZ*OR|Bkvf7hY;{^:wOܾgOZ*k!##oօʕ+4DFq#;g$@)ˌ_Ҩn *ʕ+uIn %JGf*c4pCR6}F,d-W/UPZ4n|*aӦ4qMMwBd"/]ڢ΃pk&l&)ˌYҨn *.ɽeL<ŋGysLS3RR6rxb,E⬬ >y&HѢ tQ4n|*a۶Y˜/_ঢfH{ꕸFiK>b)i~׷nF䎍߸kŊ,YZ*{A+ i [[cVz_{x޸'Ont|?Z4SuUunNՍ , }˔E&SY ,h@!!4}V!E=3F@J}Vv3NIg *M&3g1D5o^'=`Tn>͙["oT,:ʢg@jB砅vS'KQ$9FU2YEBbFD6--N./3t u/85}Hd ۳2}Vg} 23j˕7u34ȉLU SH1xTN\Hfs 2}VBЌA&KJCɝӉkltV*9WH1 PrtE22feBbì$̈́$MdYE/#I313rI;q6WX@~_XnДb$i2@5$̘%-pb(٠Egg/z//_H]D;{b5d6R.ilWhJЭ:S[O9y-G.Jzɫ8]YyfժthJeQ[*n>kFF^QK\Hfs$MY&lgka$#DcڐF3 ]ĩpB$~̧S(5E7eD-}W>pMJ7=y~;]w~n A$Y|y\|bco2ٳ5+1$dCyW{wW_(V̙JU|}Yר}p!C+6ԩnZ,ixz6!GI[[jeE81=,ܹð(FIL.Iӫ$-wOp5OI2}KZ]] l u0|x Qbc{?CYHA$}ՑQ36?*cƌA@vΝ[Ur={SSlRޅUV]m496`AK!Q,Xۿ!F}2Q%iz5ۙ/_ƪm/8ոVT%MF0JoˈZrR{.[՜% Ϧ7ݣig"x,wg$ ~JpשS% nnu9ՠ… Z$MUT)$ -~$>5uohM~2Ed'->?l d lv%#2}r߰aMm(ȮO&@"a8<^HfCf;4TѪ㍎]yIӥ-ınˈfr79.zvvl`NDo9a {in܈YttVXl6IZBقx}l={P_ȑa73p%MU81IC?)PҥcWٲv_xl00#܄b3%eEpW[i5d64%MNG O˰ 8MUj: ѧ3^v^yñuL^tik #q2p7 zOGFNX>xk~l?zЯ-N8bDW^DaGYC)4م8K\E4qDǺRZ- Fx2;Pпg- $͛;%Q$9`O&IC> ʔfL\hrUj:,| qicЫKZrj8L.˗:y24]HL yѬ~wwvyt 폽|=p2 3p$ l^[իziZhsC"=ΆJ"4x[ATSc&jAiӋCf;/iP-HF(i4ҵ􆼌Xhe~'Lw~ڿˇéUˉƼBKFl/i()2i]^j4`/dy'&ĭR<;6]]L MQA#rPą4g7ID1H'۸+6LZ[ŁK&NcYY ֒xV`e/ԡ0Чg ݢECC %MF0ސMIc:gy.+w _#3fWlk 6P}Ld|>`a=zS'S!ʖ-?^mWM>5ICp8X–%8)Z02Ot|4H"k#hCkڷ tbF}O8 4l"Io8!3xre8a#Z[aO/Y>vGp!R(i4ҵ􆼌Jjt |vs}sgdrYs3Ic9!--y"=sr<vG441X Xf0'hK\Hfs"k#qд9|x񭂽a x!BI"*j3"i%j4ۅFvvE>uik _ y&iY4)> ݽZ.>~)23 |v^y I Xd -7oXM4p *tY[8繁it4^v]LF0ڐ4&M\W 3gֵkװB(_|Qc͵%m&z I Xd 1IU%}NUˉGm*[i;"c^OIO/YdҖ- y #Iͬ'cƿ؁5o^ DDE+iN( (٠AިWȆ?upZ$>dK li%wNI d BsT+Ve8V6իWIq:O/ْ1ȲHLHd`Led$޸= 1Ǜo$iiq LK EAFfF&fёBe=Ҍ q14 1fL)сŋGʞF怼YyvvE7od?ggzF&a^}} Kmf̩>Z{p?RrqwwNl.n:4Uˉ}G֮>--Nmsgg4%s:q"#Ԍ$OPir"&BB͛7lЯyM~`sDFVVSMܷo{ † ֐46Pk„>8ȑHNx{7;u*|˖jU+SYsƍlj=$Q$9`5Q *MN$Ѿ¥OϫvHȑ9'd?9˫)={$ 9g6޺uf@nߎݻmzh񒦹 tH\Hfs$MYfFw'49{_i(_ر=9,YŊ+ʢA0 !#Q8 PA1F (N <(A&!B0 %Q HT,B5ewuu{ɩuzݿ;*X R4ݻأG.]O,G9`xl41,xpD{unLY հ48xp/HPZ ˦eiGnnEB/('B ubR"֭bf3gv8Q{"KS X2e+T(_PsOnS2k\< ha^e niTV /9J,M2U$w5q@I PJDp &Ye*I ,Ma PJDp bi(*Ž pEe KS j;:Bf7BY.6Rn@D8 eAwij6AAr[\GP(E4H0BY.)FX=g!@,l+DHp ehH=(4A,#ZMPs2r,M1JhiZڄGof6~L4K.)F,2X$K*G~<Ќza]nfi]XOozL9Z&}Zka~xDyyرO;VXNo}c;د>x474g.1/;,d3??A4xCV#$NޞH׮mN(~ ɳEmC!*A#`G[qv_1fi þ5`dd]9bD_2LUC:`cѣcgf5lԔK—U^>}:/Ѩ[uAq`., oUBԩ_h4_[2…Gk&FY<=lW`RRa7أG~r"6}49q!awD*a3Y9뮻8]y2f9UDH`XIۙ=pxkhSgf5l䱤L"/nQ'<\/Ѩ|} ^„`iu…B_@~v~UA\=:^믿8rAlη4:1M4Fo'VvfiX`#tõ%K13zf&,J)m֦4,|y$`u`kD*jiyyO⧥WƸ]*coKuL}AoiHeX'4g˖Y;Ј!իW'..+E苑رBY~{Q:Bf7 ]\! DƶmgNHv1aݺ=ֽƈk;vdʼFEL- Wc"wf5lT/qEIXr XKm`U~ݘeJڬYT۶|e&sڵ@QK3<&طoW4XŅout-:)$1c7|Kg,y {KIId~Gw?>+гgG|$_6Fun@0%aSzUd4Jx O -]:=-a5^ÆpH;^سgǃG,bG`vniY"#"kEf5lT/vBlbd3\Fiq%=eJ1 M<זgĸ4-Z5W!E #+reun@0%fiRaf oCVA[a _ٴw-M*N"$04 i;4Æ*$O7\QD^ Tni$ԇO<1f֬11MڢC n!4%G3>># @0%fiƽ01a0~bGpK3a 5D&po'eT0' .//2{[*#K&4)J&,vX^ Ae:wn'8^n$7N4%''y Y+ùgܓ'߅ą*)YH&oijLBEFi{0i@A\-4ͼ't--];c^SrdCo[_y%U1,w+V[2%PQQL.PPs3׫<05*,XY, ]qC t\\,;ɜTEgѧNmm4 ܳ\"'di2J&-%F@JÑ ͳ֢fфHRk׮>8eʿϹk2ը||HJ3xp/?;A5pA bdi2J&-%PQQL.PPs?׫8+^z|͹:ܳ<{v'*S2 [Fi{i@A_|2Ր*S2 G'K'9d4-ԓ\\GPĞI8:L jv&J&-%pt!!  @ L4[J&$( -#dvdpLIQ:AAr[\GʲLBE4KR%r+݀G.)J&bYZMPX6F.hHi='A2ۄ4AI= !4HF 6,M.2M\ #AAAbyIENDB`java-design-patterns-1.16.0/strategy/pom.xml000066400000000000000000000035771312550536300210230ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 strategy junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/strategy/src/000077500000000000000000000000001312550536300202615ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/main/000077500000000000000000000000001312550536300212055ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/main/java/000077500000000000000000000000001312550536300221265ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/main/java/com/000077500000000000000000000000001312550536300227045ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300245345ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/000077500000000000000000000000001312550536300263765ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/App.java000066400000000000000000000061571312550536300277720ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * The Strategy pattern (also known as the policy pattern) is a software design pattern that enables * an algorithm's behavior to be selected at runtime. *

    * Before Java 8 the Strategies needed to be separate classes forcing the developer * to write lots of boilerplate code. With modern Java it is easy to pass behavior * with method references and lambdas making the code shorter and more readable. *

    * In this example ({@link DragonSlayingStrategy}) encapsulates an algorithm. The containing object * ({@link DragonSlayer}) can alter its behavior by changing its strategy. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { // GoF Strategy pattern LOGGER.info("Green dragon spotted ahead!"); DragonSlayer dragonSlayer = new DragonSlayer(new MeleeStrategy()); dragonSlayer.goToBattle(); LOGGER.info("Red dragon emerges."); dragonSlayer.changeStrategy(new ProjectileStrategy()); dragonSlayer.goToBattle(); LOGGER.info("Black dragon lands before you."); dragonSlayer.changeStrategy(new SpellStrategy()); dragonSlayer.goToBattle(); // Java 8 Strategy pattern LOGGER.info("Green dragon spotted ahead!"); dragonSlayer = new DragonSlayer( () -> LOGGER.info("With your Excalibur you severe the dragon's head!")); dragonSlayer.goToBattle(); LOGGER.info("Red dragon emerges."); dragonSlayer.changeStrategy(() -> LOGGER.info( "You shoot the dragon with the magical crossbow and it falls dead on the ground!")); dragonSlayer.goToBattle(); LOGGER.info("Black dragon lands before you."); dragonSlayer.changeStrategy(() -> LOGGER.info( "You cast the spell of disintegration and the dragon vaporizes in a pile of dust!")); dragonSlayer.goToBattle(); } } java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/DragonSlayer.java000066400000000000000000000031241312550536300316330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; /** * * DragonSlayer uses different strategies to slay the dragon. * */ public class DragonSlayer { private DragonSlayingStrategy strategy; public DragonSlayer(DragonSlayingStrategy strategy) { this.strategy = strategy; } public void changeStrategy(DragonSlayingStrategy strategy) { this.strategy = strategy; } public void goToBattle() { strategy.execute(); } } java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/DragonSlayingStrategy.java000066400000000000000000000024671312550536300335360ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; /** * * Strategy interface. * */ @FunctionalInterface public interface DragonSlayingStrategy { void execute(); } java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java000066400000000000000000000030441312550536300320140ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Melee strategy. * */ public class MeleeStrategy implements DragonSlayingStrategy { private static final Logger LOGGER = LoggerFactory.getLogger(MeleeStrategy.class); @Override public void execute() { LOGGER.info("With your Excalibur you sever the dragon's head!"); } } java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java000066400000000000000000000031221312550536300330620ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Projectile strategy. * */ public class ProjectileStrategy implements DragonSlayingStrategy { private static final Logger LOGGER = LoggerFactory.getLogger(ProjectileStrategy.class); @Override public void execute() { LOGGER.info("You shoot the dragon with the magical crossbow and it falls dead on the ground!"); } } java-design-patterns-1.16.0/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java000066400000000000000000000031061312550536300320430ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Spell strategy. * */ public class SpellStrategy implements DragonSlayingStrategy { private static final Logger LOGGER = LoggerFactory.getLogger(SpellStrategy.class); @Override public void execute() { LOGGER.info("You cast the spell of disintegration and the dragon vaporizes in a pile of dust!"); } } java-design-patterns-1.16.0/strategy/src/test/000077500000000000000000000000001312550536300212405ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/test/java/000077500000000000000000000000001312550536300221615ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/test/java/com/000077500000000000000000000000001312550536300227375ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300245675ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/test/java/com/iluwatar/strategy/000077500000000000000000000000001312550536300264315ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/test/java/com/iluwatar/strategy/AppTest.java000066400000000000000000000024751312550536300306640ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java000066400000000000000000000046571312550536300325420ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import org.junit.Test; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/29/15 - 10:50 PM * * @author Jeroen Meulemeester */ public class DragonSlayerTest { /** * Verify if the dragon slayer uses the strategy during battle */ @Test public void testGoToBattle() { final DragonSlayingStrategy strategy = mock(DragonSlayingStrategy.class); final DragonSlayer dragonSlayer = new DragonSlayer(strategy); dragonSlayer.goToBattle(); verify(strategy).execute(); verifyNoMoreInteractions(strategy); } /** * Verify if the dragon slayer uses the new strategy during battle after a change of strategy */ @Test public void testChangeStrategy() throws Exception { final DragonSlayingStrategy initialStrategy = mock(DragonSlayingStrategy.class); final DragonSlayer dragonSlayer = new DragonSlayer(initialStrategy); dragonSlayer.goToBattle(); verify(initialStrategy).execute(); final DragonSlayingStrategy newStrategy = mock(DragonSlayingStrategy.class); dragonSlayer.changeStrategy(newStrategy); dragonSlayer.goToBattle(); verify(newStrategy).execute(); verifyNoMoreInteractions(initialStrategy, newStrategy); } }DragonSlayingStrategyTest.java000066400000000000000000000074611312550536300343510ustar00rootroot00000000000000java-design-patterns-1.16.0/strategy/src/test/java/com/iluwatar/strategy/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.strategy; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.slf4j.LoggerFactory; import java.util.Arrays; import java.util.Collection; import java.util.LinkedList; import java.util.List; import static org.junit.Assert.assertEquals; /** * Date: 12/29/15 - 10:58 PM * * @author Jeroen Meulemeester */ @RunWith(Parameterized.class) public class DragonSlayingStrategyTest { /** * @return The test parameters for each cycle */ @Parameterized.Parameters public static Collection data() { return Arrays.asList( new Object[]{ new MeleeStrategy(), "With your Excalibur you sever the dragon's head!" }, new Object[]{ new ProjectileStrategy(), "You shoot the dragon with the magical crossbow and it falls dead on the ground!" }, new Object[]{ new SpellStrategy(), "You cast the spell of disintegration and the dragon vaporizes in a pile of dust!" } ); } /** * The tested strategy */ private final DragonSlayingStrategy strategy; /** * The expected action in the log */ private final String expectedResult; private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * Create a new test instance for the given strategy * * @param strategy The tested strategy * @param expectedResult The expected result */ public DragonSlayingStrategyTest(final DragonSlayingStrategy strategy, final String expectedResult) { this.strategy = strategy; this.expectedResult = expectedResult; } /** * Test if executing the strategy gives the correct response */ @Test public void testExecute() { this.strategy.execute(); assertEquals(this.expectedResult, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } } } java-design-patterns-1.16.0/template-method/000077500000000000000000000000001312550536300207215ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/README.md000066400000000000000000000030001312550536300221710ustar00rootroot00000000000000--- layout: pattern title: Template method folder: template-method permalink: /patterns/template-method/ pumlid: NSZ13SCW30NGLPe1mFTkuu0Lg6n0vZjPlpttzlIEFef6bN1zDM3jDv7paw-E5cTiyJ87P22NQTGr7WOxVVZcL6NtQwJ5WFZOPBn_88WjPKWoGPkL1EN_ShZb5QPV categories: Behavioral tags: - Java - Difficulty-Beginner - Gang Of Four --- ## Intent Define the skeleton of an algorithm in an operation, deferring some steps to subclasses. Template method lets subclasses redefine certain steps of an algorithm without changing the algorithm's structure. ![alt text](./etc/template-method_1.png "Template Method") ## Applicability The Template Method pattern should be used * to implement the invariant parts of an algorithm once and leave it up to subclasses to implement the behavior that can vary * when common behavior among subclasses should be factored and localized in a common class to avoid code duplication. This is good example of "refactoring to generalize" as described by Opdyke and Johnson. You first identify the differences in the existing code and then separate the differences into new operations. Finally, you replace the differing code with a template method that calls one of these new operations * to control subclasses extensions. You can define a template method that calls "hook" operations at specific points, thereby permitting extensions only at those points ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/template-method/etc/000077500000000000000000000000001312550536300214745ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/etc/template-method.png000066400000000000000000000427671312550536300253130ustar00rootroot00000000000000PNG  IHDR 5EIDATx}m}HT?T*]D R*m쨒AMk "mBġD倝ޮkzMjbʵNK`G)Q#&n"Z%_-?g_󺳻svg<]흳;3;ggfg~x^P<9ܟ`vR @;vyKS<%)p@8 O W8S VЬ8 O hGx|O 䎐KHϷ'VNs[7w:e)=tx m"橣@xl;ylWrh+]*:՗"y2~橣@^7~s G˻;eǟ;Sp+l%O>SyiԤ<Ƴ(Tc:0i)5mmۺV^ٌ=ebj[yY.i,(Hy*|SG<^g}[ݰ;kffo<KT 6C<Sk>u|d+<]B .!OvyKS<%)p@8:,OC2w6u8b'kty 'jiBSQ4+O:t=3u|-x0(ZcRm&!i,x$UWYv%dr=F9XU$({R$0*S Q4(OD)Ru 'I6^[AYܛ%+D/(K|=ogVBvDG1Zʫ8K|R|`k!O9yRjFa_d7wb)H3Cs%j ,v&D)=,9SRݠJxh 橣hg){SUy"D#MiFF(*njLDmX.{J_nЪ4hܙsX)EUtP Ӿ_a&BGYy"o8jɓ񶂼6%STEd&r틗{PuMnVHB,.2$kty :wIr^B U"TiV^'-ΝF3ɖl:)O-UHS0'|ƫxeyӔ0Tj 7MՔ< Z!)p|?|_ؿ:Ӑhs!gJey+0p89fRM)OiҊ GhfF'w*BWӬrޗXӈgJ|CN{GpPʃ_s(DSmc⍫N[Jw;M.!9v/]=>ڷ)pcwk Gٿ,P'Νu܁׳ J-Ojro_EX45{{﫰XUb iBN>w]o"Y` yVIarN|ƞ4 .Wᕬki}wJ/[ޗXM3yQiǮ;xǞ/9%vp݁h+Ou]dH'<g™X",e)mBYWa|T>橣g̗g׏a_<*'Oƞ +')~LG5"S OJd+ؓC Oxb;P`sE'< 9<#rk ;A=ŗ;ީجS>_+4"Uy(%XOVEm'E'kD)kNNc:nS:#vCP WPy ]' y '<]B .!Ov<+g54*yx5MSp/Oj](utSP<<2팦e݇V~ɜS,SSɓL!Alpq˝Py/AO</N *b c=ےOY*KkL))pms*?mT\9<v1!@ql))px'O؃7|,ՆܜB<]B .!Oc͚K{M0m)y|BY .\XfM۹ gϞ]~}۹ FyΝ; Oشi O;|۹ \rŋ O@x֮]v.yɓ'~۹ h۾}{۹ hLB ;@zvv.y`5^e Uk׮} 'T O/^KhbS%<E;iː4Pl((;!?Uܪ OǏߴiSzAziBiD"'Q\Ua$-QTe,//ܹ3=/飑= ,@f ~ZzD,,,>|X̑<)  DRcNIPcfY~ٳg!OiPd{QӚ5k.\ Fy O32JÅFcOrC{iP(Oc-W;ܥP\Xy 'MH.i iPm.)\@6'M8` hp1y\@'58` h۶mzsp1yTG]3b^yI]c 4>.3yFA%s1~x4G4Xb@vx`0[yZm>O|@p'?vFyr?@ fmdyrf9P (Ag<@ : <J O %>Py)!Otb7?rg򞐧@ :i<l+ 3x#Oǣ})-J᪻W[%>PG']ƔD XR!OJZ']שK>!хẸus˓2W8b o@ :C[Olh"7^.Ccܩ#[=Q/$e tn=Jgchn8EJ{ #iHQBG14K@ :.I-RG"ptҳӝC80&]jVv2_f (AgF(EW1-+Py!>Py)!OtH y3@@JS}RB% +ۯ@ :Ô7~n~jcַP\67,x7_/GSgy"f&y'(qE+2:i}lq~J]"3^7JS}<>k7}؎3??-$b]\HભJ#;z\K m/Djɥͅ<J~瑯>8?;䙽'zq7c%Ҹ/bقx]D6݋/4(Agp+O~Ͼ,_~³_&̎D4%4ݕpi!' _++$Xg~HQ LJbqu0/ PVu~W?0kn6ڥ%yI[2+ӥ4P&mDW(0ϊ r&{)6{'_t_-ߺ2o۰7pĖoط#\?ɍ`كRTc鰱|ܣZҟe)Tw+PЄU@VdEȶPeIBv;[nĜj)*J.IF,@ :BWJVvwb)+%y6U%wCk.h)ۙSZ=,9SRݠJx8/Q% jys0H)E$ iD!@_(,o/\&S*xII Ӿ_aW$p<J:'>PP[R/1 .&r`QȹK6[7th_nT(AgٹlCa_UήߑH{:}<Jt_.bhfSSG&-ԓU:(C<J tqg_r]|i.u>퍲:hS#Weor\Lb8[p{=U*o-2?Wmw!Ot<nٿ,P:dKuJܮ6ݖ wR {O==/KF]hkvٝp<$_6ykP0%y2VWU~_P ԤرPpGewT(Agg^hGtFH k&k3z:B% tfx8o4uwE55ߚE/y璌*ES},Oa͋s]q;sd[!]ܫvi^"Eqg "/u%~:l=;YIhf7J1cPf+B% y:}O&'OR>'_UڸbgKϸꝮD..ROU8Rido.U@$) /RBT{q4Y@ :NN=}wO\{6@⊄Lk}V a䝂J{jHe><4ʬ-Fi% :yz=O_=ibU.m޾#i(*ZR5②+~j4Ȝ VƦ&KyCvjbyP`[^wW2[#rƕ6 +d-'LRՊU &GZ$ޭ1.PUy3Ɵ_DMv5^,o\>Tܸ8%sҏǛDw+zLIpeTBf^$*eV#>PP8Ȩ)]6]:o"5F,Y@P)K{y|R Y@ :C<n̐[*7@ :C yR4Lu hL)*gaB% 5Ƀj-ݎ&Uj<Jty3@@JS}Gƽ6ekD9y3i\-SSrVt nD9 =܃e^!vِSMId) c@ :YFoiF@7|Ⱦs6{@Aтͱ؅SMKOa̢U ONtByVtLt y3̲Py)!OtH y3"OӒdoOfu!!OtY/VM<T(Ag0'|ƫlM;h7J$ Q}Gdi 2*|PyGTh{U[B% :yw=x?eҙYߍh8y=/>P&jyJMJjGr ˝xB/+B_L#]NT.?\D 4mYӜT(AgPq9<J'2cMf y3)O`[<J O %>Py)!Ot5k.@ fmdy ʶs6lmS8'?m;#annFQy?~׾qƶ,//p n;/@E@}mڴ… ;vؾ}{dX\xqaa%Q@:m۶eUB4(N,ey{=VӄAK.]v#&n1={ձ~ꪶ-XuhS+%VR5H6A}38y$l/={vms^VzJѣm K`Uk~~~ D;w=rȥ^B0 @&Osss*)?1)YokaͶX%ж@cUN|d'ޜs O{]5O>/0`B< Tf׀y%^.#MZIΉ۹A(Oxw5 X ,p<l1999 GhRbRP,8Ubpx<)рW44uN"ãϺaE*# w "#"b[̒ EI8 &O y% K% l'PK.!O']B@-!O`{O-|7ݴvvBZ/s ӮO1/83&;v-,\y([2M-`fb,8#X鹶9v$ZvKJ`[Q\ѬnKS4?be@̵ybްt|'O#gyģWw7ΡΝe( DߑLwdq`HRH&]©HjǓTV#TҨ);yDI0?5SfFӫ9m kW˷8R6,ob|c/?emZOYhHfP<~"G\ޙi۞>,.D2ɼ:wTJ'ڋI<!Zlى!P̵װ<}l}xGzg?ym}qxm+ ے6N'ҍ=Ϗ9]jkyb#TҨSa7j%&>7{#WS͵+w~?|'K{Oo9}PlRy" '%ŧܙe> ɇytZ$-њg]JUh!UjybUQ( I%n}9Ҋ7"tM0QO<҅w0@"@̵׊<g}[ˣci ?;'O``%@vo<@u5uyP:O6NTF94(( u ˓͖$)Hzsg-'.6mb蓲ʙ~5aXx; 27<8HQJu*s.O@< ;pE݆kH!rP<~RBW)m*(]UX'%e m {ZPDbUi q^j)JWYU0CG\Rc֊*~hˇ̪r&RƟ% e~Q`^ڹ?)OXع :'ے;hEn:3Qb0f}<Jy3VTtqAF1q{lbEsȓ6 #{$OWmѣˢCy@0PO#W|j&Cَ Vaz ,=ڮgv'f@}N_CտpFy\fRq+gUiaʫ. 6λKm29ⓥ{mJ4I&ʘVc-X>w]o"Y`A2YYSֿp'ŝY^%9Wq4ZXZE/THMce|*c.+O[=v;xiϩO-,@4Isk=O֓"v۫,Q!O5Qʓ|}ͷ1:G<% 𞛞#+Cǒ&$:-tw쵣lR!Sh@W)Gèe?&5i?d0"1M,oǟuفр@Jz6җ4grzWvWxC6Nj40>B|sZh#OhW\l#7E&Hf_́1cz5U!'pzʘ!OND[<$=2fȓ˔Bi:!OJj y% K% l'PK.!O']6%O9ɩ"iFkZx,; AzzϝRк<#+әUѲqX̔ջ h@Xบ˓)fI%O7sX=c*<eG5!rV# 9 yag 'PK.!O']B@-!O`Ů̳<g= :l&K8TYf@nOvf*B&,'c]Wdi! X4edz&<Տ2\ t-SXXr-t$XhUDݥȥ&>ah,8ZIO38,XE|J s7|94GlTkA|G#_Jx&<gy,t'ȕr6Ce<٠AugBq4 X ,p\Vl|r%p̵ java-design-patterns-1.16.0/template-method/etc/template-method.urm.puml000066400000000000000000000017341312550536300262730ustar00rootroot00000000000000@startuml package com.iluwatar.templatemethod { class App { + App() + main(args : String[]) {static} } class HalflingThief { - method : StealingMethod + HalflingThief(method : StealingMethod) + changeMethod(method : StealingMethod) + steal() } class HitAndRunMethod { - LOGGER : Logger {static} + HitAndRunMethod() # confuseTarget(target : String) # pickTarget() : String # stealTheItem(target : String) } abstract class StealingMethod { - LOGGER : Logger {static} + StealingMethod() # confuseTarget(String) {abstract} # pickTarget() : String {abstract} + steal() # stealTheItem(String) {abstract} } class SubtleMethod { - LOGGER : Logger {static} + SubtleMethod() # confuseTarget(target : String) # pickTarget() : String # stealTheItem(target : String) } } HalflingThief --> "-method" StealingMethod HitAndRunMethod --|> StealingMethod SubtleMethod --|> StealingMethod @endumljava-design-patterns-1.16.0/template-method/etc/template-method_1.png000066400000000000000000001034401312550536300255150ustar00rootroot00000000000000PNG  IHDRIDATx x EhH"=DklU%"HA Ck4FZ DHikok-{'ͽw}?̙3g̜3̛# K AJ 0$'ENT%@0"P9'2237ՉJ:!9!:!9!:!91=~_:(HN Dˆ<|*0##mʔޥ`CvxSSW\V:Ql9'Nh4t_$_<Pgذ!W؅f*HN Dˆ(RN}!''D Phx9-aYСĹ_DsxÎ`wS3g*r®|YObTv-]XT/idIFFڤI܊-+V, a4tu8՛vŘ6XA7r9-cwwuurt2+fC bT)J4 $'tTGDhyBG\|ܚ5yzb?X,8i۶ YZb۵ln /'% @JtE ]94 MWi0Ш.:-VN=zOmIe16$[%zuXϾ9iMFuI \LWi0Ш.:L+4HNhTWGu)$&9!)J4 9ՕQ]?INdaMCNvѨ.:@rB& Sh *FuI,2鴮1ÿ\mvC9׊̀+44Nb5 'v._7ll8fHט jK=GԖAx gRÉJP3k)\ -GShL4FuYI,w9fT,l7\>xƦsj'yϞss#MXYrqq`餤E6Xg)Nc,aZkO#G>GU[V%cQ]vZNN_M Iv"|s9} _f2cpeF/*T& M޸*'lWr4_A9Y)$Iyeh~V}E<9k v,v9XEts+X2fiS{y+'pTlvw|+c_TӇ#hWn{aѣ-lbyj!d>>NÇYW.Ν۵k\\93eՖ)J4 $'tYT.sl v+=b2>ځN{b~y&'njŒ/acmۆټymr§dcl!(>?&cb&j׮ɒ%]?<+ BN| ;oRu릪mQfҥ!1cFj%:OZUy ;9rxIM+OlCFXZ#k}/DɣG/ݻZB̀KY.kRpw3g00N wɎw*+9ii^x#GvV]߸qMNL2=coJԪ-GShHN$6">yԝ86avG7n[V O ^5Ydwرcܹ]O$MA_ 2Kpek''vvX31٧Ok>L؜r75{u,L ;{ Y#:aDj%:Ok֏hm'b_2həWOvY嵼;sDzeK`Yϖ,>ͭ0[F?9quub۷$!!vYkfCNWۍrܚ6[4-GShKN,mObs86{c7 a^wG/:kŊqHo]?xtpag/Q2,l1##}F'bߡCc'W3`>^K~RV￠cg왇_;.Skz "'{.BD@@2gUdOҪT̛ڀr,`cw̘.G-7 09x1f$+ăJ~:I,S)$zuXѧ>E9jZi M3\s9qcgf997jT}ժս{z ʕs\_`cV4-GShBN;^Y``=SAr©bngvY3اO"#C1}Æi8&0VOzbXShBN;^S ʓ'Z/^\,zzts+NeFv/Qhт^H%+fcϗf~ȌDAzuo$6$'d0_,$ZKh!4.dc̢H%ҥy. طx`o#_<'54-$6$'d0_,$[=ڗ? _6m75{!?:vl%. vi΢H%.;Ŗ.%ˬuzȜ;wE=ke3p9ќE' 9ɉ7%'}x#$37_\yJvBB0s˖yy=}Kn,VV`_݌}ɉ,:'͛#8?s('gϮcɴD`Frb GLYt s8wԸqM'Oy:eȐoСeX 1qn[RoY~~GD%9/<[g͞=S}AjH4mZý؊wssoު_ժP&2QBY3ڬ2 ۷/Y)J4 %'97f>Nb#J?ЫWK$.\;oސAa7NgC6lV.ٳ%_a@N||ܑ?;VLIpl%(/n<s/_R|fw9kiM|*2Sh&'/_WWGgIl$qRgFuӧmYOvɈ0GaUNmӦ>xq <.]m˖͚}1p֮nZlY믛yzr9 ˫XSh&'2şĖ|RɾHFN̘.Kvv.m*@NSENX_er©d~]"dӢE90Gܹ$4gANF(s0_Nb#b'#$$mۆpVzuWP __O7+9sGw*U?~_bjArS̕(-$'t Y~.~ C[˪+e}+ҹ?X//l5M۶ YY岵a餤ޥԖh2l|~5<=K"šF ӧ“'zZ}~=GW٧Okd޹cVk8y(>j))ժyqlY`$ShHN$6"9yؕ9qrp!AwQɒs0>po=`gK8@ZϻwGju^Nr;UAFENPN8"#CkD@Da5ɥUNF^7E=4^kI{B&X4{ŋG͚}Ʃ٭[C;,y?>֭0uAּI2n1Kðd*vAA #́KɩmlЉYop2fQZ}X[?hٲlE!!>ȉfݻHPU02mMWTݽ}/W-HNy't-'UGpc `}3tLN.^Gz䚇 :'OmmmkS{.So<֨Es|hSPEik= $W޽[A𘜈_ǿ<W&88خ^=ڵবWluqqضm6t QW$ -J4 $'tN?!t,.OÆudV~U&'Yx4FFT ۻDZ''{ DbHDElڴ >?K豵kWD`.mr*sN’#Ç/X029A믛AcYؽ{d@B9<|0|:vԨ:9vlPN% -J4 8X':u:|/&)\FN*_߾Gzǎ9,pr¿@ /?h~uM9* T6̵kvl֭jnXEҾz#/'l߾mP,/'u}6o^e޼U.8R7aB9ԩ$ -J4 8XG:$h="),bO=aH42h x+ٍ-'$98&'/A߰auF9T]66Η ͩVaiB2 O,)XX({>r!x(:IVj(z(=wnB3g⠣Px``=@Di䗡%\A9bFemzjjpʐo#횂&"'ΪWRw3fG_Qo9Lpw/  T,McpyEaKcf5Ҿz#/'0t;6TZKtwX 7ly(`gqs+ -ti3ˌ *QT''J~Z•h )'%igl qXoTvaFByr9oWbM43?CӾ>KH&'`V(Z}v JzzG ֯v4$4_[ܮ]# dvř':F=>٧N;ҥ9HU{QwvM+4*'G1ڵ9ƍޏ=.8iN[ch&ř':Frukך5FΜKM]}0Vt7_A'93N*2ea_cty o6Eh&L8ȋ3!Nt\MWi2 mw)ʑ'5{fzfkܯ_fj2!Nt ,LWi2 ָq͂<=K7Tr/…xL /f3ĉNb!9!)J4 ]F]hkk믱έ%%-A]yhp3D'ސ%ˉ.#""Tpa({MěLN0ȋ qXoHNdaMN?:Bu sRR(G"+W.[+&_$E32!Nt덹ɉ%%](߈3~I32!NtD`r>NV40*MWi0ECeM8ˬ8I7=r38YѠ$'r7_rrޞ-[fɌ 2!NtMvƪυѮT"9A(@=rYS2M;愄rbE %wB',qz|O:~C.mIB.q|yKLss_}ŊDc $)J4 $'tŽGĹ_+8Yhd8.NN$^* LWi 9؈dlƏh7dWP+el`` A2㫋DKA2ٙDӠg4rW!Z[B8"}k|)rPqВwv.؂h 2H&;Sh [CBB8'cccb&4n\@ 9rzK(Zx!A9؂h 2H&;Shr*'0J 7ý![&8'cc@X->g] ɺ: nɔ-(w"dL+4HKt8AgHYX1\5j>ԦKjF~pagld|l,ɓD;X~dEc dL+4)'ZANXSجadt4_AhjNΞ]׭[,ЬgWlmРZɒ  ck/㇃uu}}=ϜA0ll9O(--Y/?eݻhw)ح[gaD ٳ5n\BNL3M'Y gydt4_AhXX Lʅ?UZ =Skѕ~":(usB?zt_~YmT8lyXcEc,vJkS޹sb/_RcBBjTQ9L2M' )J4 ƈֆGܪKc,e~ɞ-}6\@sՀ@$?JK[bi/6*j$ﾛ]NL0M'1 ,LWi0L4Fݞ%YzҤ^Gҕ*A_/:Ly5:pdٳp!^('7%;|xر]Y&rban?INdaMa1 ?)'˄>. YG9LBTrhF\rban?INdaMa1je}N0 }i!H@B"nAmɃI(*9y a%Dc.'>*'Ag'OXt<wO܇AmQN8Xk62.$$-)*'D?j (ƍ(4-DM8(>o |jQ,iS8z܉ )$6dxvz"j+ӧ5EVkAURmdxu=Jx4h@0/ /f9SɉsiB,٨Qu&'Xr;J6S4k@7y9j7^N+Ѡ20r:1p,$ΕhÇS2 h2e,nc[LsX9;ݿвe2IIBBs}@5WݻH#^,>W>y=4XFwb XIh rp~R˖uqì]iS"Xݭؑu4yݻxց=~;JxjxJ8_iGɉ8JeT?uj-z@{,l Yvdhzz*VOϒ_TtJx蚭zDcG ( $'RON*]NҫWKaph*YAb :PfUYؽ{6)Uf%EGt^=R1W£)M'qV'.cc,Un |$:HVAVV~}A|*g#^EfkQ)+`F¿m@s oC6o@zȐL-7}h`G}nuQ&zF]0V#^^=R1Wڣрb@0"Y XN {D>SAjS=Wر s}/*܇A6L׬$'6bxJ8_i (t #EN8Ƣ7an L4v]EZ];7Q);DR P,# FDDc| (t #bVr©ƲY39*j$+Idq3IN DˆɉAH2YɉAH2YɉAH2YɉAHK(6 t BfL:5##CZ:$'!3 kAꐜpvv~Ե uHNBf+VƍRׂ !9!qUkAꐜ9Ե uHNBfTZɓRׂ !9!gI] P ɓ߼ys oo쮛RZ5 }U$ӓO4i, mHKK8q]Qׯ_ T-IVΰaØÀS_gԨQÇg9ǎ}Buə3g"322EOHN#ArBY_?NהĦM+޸qJU\*o߾\%==ӧY>~xaN||=QFϞ=cEٵk0 9! AȌy 3 K!9!dxRׂ !9!r޽{K] P dF\\?n 7on׮Ե uHNBf$&&lRZ:$'!3ۤI~0HNBDDD1%)))~~~,3,,,$$Dz?<>|a85krE9U#LHNBܾ}֭[gΜ\2rbbbH䐜l`ʅ w+Vo>+E@rB9(?޽{G L 9!9O> nѢw}'uu_HNBNAqtt+R abHNBf ۧO_~L%>ڵkoŢFxqHKddM˭hтXblz6LCPSi]o}okke}PNDKx]] Pyv+b&D3IN5aY"#G[P!ǣGWf._>n͚ȼ~=1OoScc'/=TI*T`kAK:thܹڵS8kŘoW(^^NDKp}P 豚9ǎD E3INMaY"0;uj-53! VU˕sCZǩ,eJp$<}e1ޖ.^8\ 'NDKиqw"Y 96*9LBjBh1ۻWRÌłmې,ر]˖-`or"Zh tdIWT ҥ#A#950,19a>'2CГla?j昹-0,HNjBX-0,!9X#91[aYBrbFrbPTr_[AQ2f$'f 5 !K .'Oulʄ!'UmS#91caYbX9s1Tac1C:(/^x1TV###-== "sRZ!HLgZU1m:[5%hIvN~zsǮolJ. 9ypoVVB.''=wnUكPi!HCzƌz׼yCrK塢E ̏tHTH2~|MkC(jBJNN_Mm=b&|ԀGD];ٹ@<֬w^023w*Ӯ]#̆'%-Zln{נs66y/XNdd(ʷ˗?vJmGvmQ%+ϝٳ$'J%+C{[݋yv;SquP|}=uyGNi 9:aV"8 ~6 v.UPc͠wuuS2:n>ͭ0V?5jԮ]1## VVZ۶Ʀ^Lޗ_%%%: 61`@۳ga zYFP->>&( zݺU25wHwM\l"B \%02QYiiת}DaPPr٭n1֠w Uo=4[eخ:nރ&3} k~~gĝ>Wnt (`vɒXN-˔)4> HI o؉Y]AMP` XrAu{lMԯ_S}9&ohhf0j#gOP*ׯ'rZP$.0\.TF؍DPPrRcZ#dz'G2iM`HkQ+<~D`tUѥ>wa]W7NGH3ʕ6# G:1q.ҸT_Gzé>_4]qImۆH39޽vdKGaiڎ$'/$w`&y5'X*~۱c+ǖ./IJIB Cz'ugM2~tg=UCEcq޺u=Kn,,VEa:ujĥKP#Y`2<FY22P8.2L0+_O0H}~^HN 5 !K %'׎Ѧ۪O^=EHaLg']W lalWOkĞLڴ7t}ٹW⍽(_>TÆщ۷3C7k,DsApSt&"}H߽iwsBM~2ޣ̙3jժ`[[aYb(9%.2A&&3Hw\ާ@.ܻw+Dժ嬬2ɳZ5/8{/}Yl4IέGۂ*V,4{O.|]qb_mGǝm=wbS.><#.gʔZpPeߴ)i޻ڎܼL>'o.&k:{pO^|u{Aڑ(jBPNNoW}:,_%jĀm vfEgY $:b =n̙pwBNF d_?Z6nK,mtl]ΘluP HE *kW-[2_~'W]dGw}x%czV5Va[T.Η_<Ȅ/"|e'yHHN 5 !K +'W g13~.|ƥi7n 填W#yhbprayٟQ.OǏgj{:oX(*jFrbPr";;uj-Ӱa\aFrbPh:E,W-4$ l!d ɉɉB C5%$'k$'f 5 !KHN,HNjBX=븸)gǏ/^Y۷Ae[,"9;0,L`Mp!>:zyCw]7 ĆS5Pϫ0>} ݱbJJ4c+AA ~%}0-g{'֤֯ɧ(e@ CYɨQ׮Oz۶,k;dĈN*D~Z{.k9yx<]47ۖ-35,"b ֭]ݺhٲ_7,)YXK~HN5 !Kd!'wG?1]8՗ } 9a9h8,>㯿,կ_ݻkW=} }b!6Kg~ܹš 'P#ɉ2!d,ضmCii^:ܫWK' ܹ# K%T=+TPv*f ))uTӻw+hƛ7G}Z#ΝZĉoRSRU'G믱^nٲ۷넎FrbP$';;HN^©.\{wŢ{սke޼CEIV%J޺Oq"'| s.'έg9UPuBG#91[aY]NF^7E=4^ţ;{H4߉YoP,{:JOGGdKNBwog2:twn3$Ξ]׭[C;,y?~֭0 ={P5X[?hٲlE!!hց޽ʔ)>xp{"?J*Xx¦+U*^t`^N/_*^.aHNjBhVq#Ǐw"Iz,3}zzv  ֮]ɓdإK`.pA8 P"rd6_bHDElڴ B9IOOܿӳ)LND |eoxR8H`/ԩ2 _NUY&ƍҥʕH.$'%YɉӒce)?{vLLkc…x8'E ?##mҤ^ L2?fo8;+˄ $4fϞݻ`+LD ~+pCH ֑91 N53r[fV?RAr"kaY+>t1*_L"S֭j`wHG/;|y~9;v̩P#+9_ra4f7EMNPVmby9x^NOۼymyVVH-^<߇19v-Nx:uj|8ɥDP$+90At=a!.Nvڴ$A'$D? ܾCX4!Xla[Cʹ.'$%6&'/^'ց ͹s߿?ž9N ܽ[(?Jr 950,*+CMk \]pŊF^i{dG^df(ѣ+0 xUxG1?2bb&`C%K%y9ر *]ukatM9͞=ͭ0ҥ,3*j$D Wl :߾MurRAr"kaYvaFBb?"4?=ի GMu\Q}h*O& s>K,~4>mFrbPD^_d>J.s<ɫ7~i??k%FrbPD^rukך5F9Y| coˀFrbPDvrBf(#91[aYBrbFrbPbl!dI6+4j={CɉB CȒlp`1Urb$'f 5 !K%'5rzӧjGlk-0,1@۬`(z~r͚Ʌ ;>$}~޲eP~dҥ""&& \rEe˖/Qٳ4Keea$'f 5 !Ktt1 ];Egݾ xս7lfN֭-tٳ0(AFFڕ+[}u릲o Keb$'f 5 !K>*'VNiÇew;1ci!ޥ>?.]ٗQԪU_bb\wcvr\yCX֭PZNMV-F GQ۷8[&,,kals/o)UJnI__ϟ^ͩx1ssA e::q᫴{w SFHdU=2%$SHn4:jږ,Ϝ-ׯك8Փ 綄Ftg^M([Яbulr!(2p#/:A<=KFE6@l:vlirL[[ z`~E~z76`ћ?~~5k0Gę3Uk>©\a}D&dco>[hHNjBh}E؝E{k._}en޽ׄSŧ}ae߳gt|CNǏ?@] Ge>/3+yL, ˳Zccc'!ѳgK,>ʽЎʗ+K+Z&=mfI 2? GVOr 90,JNɸ4/Ҽ9wnU.΄u%J"'9y _cXz.;r!,* or֮ҐKEnn@ɬX?#j,!!šV+bJ$ ܹp|@'ה.],I.$'2%Zv%ȸYj @zJJ#SmېS:*JO&~y5^=_N7򬜷oS!3s맱غX7n\S ZjQ#kV-WlsjȐyH4>?,[6CƜʥ !]lo޸1xb<_>"wDn;3C#91[aYU||Ӓi4熆v0- //7tȑ'N!Aw<~|wN~ͣ1,}: O\ |}=kժпɓ{Mқ5˗Ӣ|ۻT^-(E#X/Yň^/?*~zkpuuWf9#Ftb0%hHNjB|&Ϊ_֭8UV0{֔]RfRҢ[ςH0r K+W~K44±ZFMKHNjBEጌ4ۿn~p!_`/60+34|x08Ro2HNjB-'p;g%{ޱc{ݻgݺ))l$UFrbPX-0,!9X#91[aYBrbFrbP1Z-0,hk$'f 5 !K$x~B eڃEHNjBH+'(֮]#K$#g不YD7?ͽ{{$'f 5 !KQG}$Ρ26D7/JQ$91[aYhFE W:"2! cS2ŭsWXzӦpFXLl>}Znĉ6W-"o&h츍"oo-[6ZPC!8ŋjٲ.D.P$5-vlݺޓ'ɧO N,d!nǵo'OŶأǗ "5rذX &jfEh츍"qxQ1$]K,\j~s8 ޏD.P$'5-C+4C"ѷ?ԂF}QO?*"3sQ3X$ c(\fA\&u5ȉ0tɉC CȒDcԌgBaޡCurb! l *RB 8՛޽[DUEf hj"a[P8Ϟ=NZ[??$'%9ƨoq)| B.,hBytl.˔)zU#qtgy3e0Gm  ;dW?(]y 4mZ͍ɉ\!dIN1j[Ľ]>t;kրk YxzAX]+es% ^Vw|Μ/-LqEEB;W6EPC~b.h, kӦ>ɉ!dIN1r9U"E ~y%Z Y7e˺MQ% :v*R' 0s54-23}0Gcm  Cc!,E0Q=WE]$90,I4F͘|DBq.zgaЊp :Yì"3z~pЛ3w*{褼$'%9ƨ3H(P4N"ZhĹ}}L?Kc:l:/j۷oB@$@$'%9ƨ3QP3hDB+Nқ2" bY8$vhĉ=G̫?uDvP$b& #O'1[%2GŔu1+#91[aYB_V3E]HNjB.fe$'f 5 !KHN,HNjBX-0,!9X#91[aYBrbFrbPbl!d)eWFFrbPr2yrlŃJM]^rY~rĈN-Me妖]=YɉB CɻwGQ`ª ܹ={dEFQf]M#91[aY]NF^7E=М ]REXd@89thY*Ԁ^;.:'bI@@>\˗/~ԩ =?hӦp6wǎ9,: ֻu+s94֭*U*^t`@ C-r*ndQ?.B$0ƍ?ˏ ^ѣ}(;?"'.n =d_Ex1Br䚇B k Vz6Up؋/oвe]6뫯Xbի WOv-18)+uVmf=FrBr"aY q~ O-`јDp{xKLu v+:zl6GrBr"aYXOm>-yZ`8&)\cwwuurt2+( /''#RhAޮ_OH4zLVXZ('H0 > ۰ad, 3ǰaàFNdԨ[IrBr"aY+>t1*_L"S oߦ5n ^NQ9-To}ϩ^~T!k!K;uj|8aCƝ;pӧeAS`7o`e ~/'_|} ɉ\!dIVr'aFIa{f C=)\&&fB5!! tܐd}{5ȉb  kݺ Ԡ\97N C׬OѥX^?~D XX'N:wn=J2crrL…x@ C-2i I@݋,ڢ笋'5%KFGBfWR>ʌxqH(' T;th_= +80كlmm CK.]wITH(PǎMHNHN5 !KQx؎9Hd 9HgBҥ9K_?Ok7VxKOOe:Gf$'f 5 !K#+iWH^(yl$'f 5 !KJN8 퉏amY-0,179!3-0,!9X#91[aYBrbFrbPbl!dU.2AK}P[._|RBO:5##C >I&٫.f͚uԹtu!L A|gϞiϯm۶=z:`[p ~MHNBW^TRHHHzz:DeٲeRH? ˗/ 7ED}ϟ?&&M{xap9ݻwR׋0<$'Ç)eכ;vԯ_Ѹq㰰0EP7ԃ >|RWhݺ52 9!۷*TغuD߿_D}I]"D?7o.u-,+V޽{RW$'s5˗/K]fر-[D 9!,vM:UZX:~iTT!䄰hSL9PBgϞ" Tlٲw"?YB ^">KXXX۶m:u4p@kA a\r"x䉇ǎ;mHN EY'%--p7nܐ"D 9!,˿}VL>QFRW$'s77ÇK]"K޿_^+Bd3fL׮]]z +B aY?Ν;RW8[n-S̳gϤ$'eѠA%KH] BWBBBu&u- 9!,uUVRWЕ/^x{{_^䄰?~\XǏK]"{>}HNKa>,X??v9$'Ep… ?|PѼy'J]B$'AgTV+Bϝ;w-JB,_nݺ4Zٳdɒb-$'¹w+EPڵ8$'իåa޼yb +B@rB(cǎ/^ӧRWDXY",4=ݻwUTٸqQ>V8'2 4U8 $< ¨DFF6iDZX$'k$'y󦋋˅ E@rbFrB( &H] K~`z#9!Nrr˗/ #9yp/j_C6eJooR^^nC;ys+W.+HN%//;wJ] c۷9q"F{{Z$!塀:Æu !'?.|4SB#9!̌3Zn-u-, iɓr܂\%NqW6m gK1'$$Pt1᦭s߻ϹukݑjrY۷={tt+UHD@T>j ! %H` 4"H $@@zAzB Hob5҂$`hx<"( =r߸3;ٴs>O>3wfn={gΞ/QU7Ɨ2p=bDB~ݠPl X60֨m֧=;w~}͚ %&,U 36zv1yz\C[Bq 'lc,Kd0G5;`rl'ON `hV#}rwx ã>>w&T{m'55{$HDjƅmr5zq"'i߾ T-]c~A!IٳSS+WDsJi11pmS,Ouw#_[<<ܱ(߇ '5<}zrҤ޾>y ~hK.C)t M6Ɖbc"[[kt Wa4C\Μ9xt J1IŊ(Kfݻܸqby졻?힔)J0W(Z &7'5`L}p&%%'O#-t.W7ǜA/9IS?}z#ymm! ѤI_=nݤeK|Ѣ*C>Ŋ $&rX?glR,|ykUT&7kVɓ(l5C[[NI\ds>f8?c8q6a=fy(ƍ}5jT⏩C<=sb!!-:vlB M嗋yyyg6րY/ %Rj&31w'ΩwY5۷i6F=U5&9%ƉI$}d0gNƲ>uY (q?81ɜ'`| M=|2Pd IX?~7ی#w|-=!{QI*}r 4~1NL2 3\ QcFS?:#ґWo3Ȋ(.lܸzΜ9(sjeK'!Zwvɖͭ@/ОEbcpڴ~TM/t8`A|{+QI.Lhr5z-bd>?s wc'$~{꤇/O3 sq ^dɗ0^pĞ=};{l/kp c`Zb`'NrȎKºu+SI8:/cH+IFڑ}?NtK={u__x!'|(۷pǎ9?~+/hQ[c~K8 ( H [Dr2KO:uj/_޲eK̙62N պu]2KW/ƉN@;__QB7pkWӨQ>['y۶r`l1W0ƉbdZ.qUpK.DuCnbv REƏqf*( K(D[auĈ.sǀ7`u)G4l @x 8f< Jp%XllJBC :V{:*Xݼy}ɓ`5W !AIѢQ?ďqq"'Mk81yvrUxeJs 5ZמզQDPͰ7`FC;}㫱a4,׬Y,\8.oPެY-l37O8?,$$2v#pbXNJy,[6ctW,,WW*7Xmڴ,@ q"'%< ;gul47y{C o8D=;!C܊c1 wk\+`oO X=md޼a(JGw8@~~Nl=?)JhC)V,w ,DʐiꉌW41w 1N2J7NhkDI3iQBdޣ= ;Ο}nذN+W6rdWIѢ<*jNK$ʔ-uY,_,w]= l{p+WnQv J͢ٳ`7ͣJJOޟ{ :JbN΅V?{.Lƍ{ QTՍX[jOg 'P&ɬ*_o`LLiO{ b>>>z%%,Zj8* c'5ghpih@8YbڵY3qX/A.8XU츪_5XF%$ [KL *\2eXehc8g@z ͚5@}J=Vq `{Сe3zu՞'z/gD9.]q fKUpNToذƮX^|BVG=%WϞG@L1LCC:@A$b("'. ތd^u+.&A,'ܻwت1xQ)³Ck|:+1C:{eI'&},1Y&pf6]y0:z*,X0\47}g8ߎxzjTdjN1S]5uj_1 78 D3NXqbR\oBىU{. #Y_ɀ LñJQ R$bo8= D3NXqbjvz~8sϞ$z"N0{ w ѳJz ON\GؑFq$;] ͛J7iA\ rq’D>z%5]VG@휆&9qzlq$b+U*Ms} K1NL2XD~ܹݡI%yr ՞8]}1?|𥗒I l"',I81RWRuʕcn}n({nnu1۶͢K[v$F3NXqb\o?Na a*z]\ P[]1d^L۶ݞ?'o'Nh>%.6M 1NPA;6ԩu}گ_[ТjUD͛V۷T<3 WX&@:%G AASz^\v`? f nbٴ,X!ƉӊիA}vJ~XOObbUBY'&Yck8aI"ƉI&I`|',I81ɲD`c2Xh$}3`Y2C,K1>& +$4E3ћlnY'8Ie }3`Y2C, 1X1NXqbqV$bdǤl8G?7'M2pSVn<;1ǸI+ K1NL2 `nY81ǸI+7ؔRuwғj;'bSq"'nEc)V:81'ҊqbKաta??NQbdi8%]>߿x" Y3lPbP+Mߏ?W^u?:4.0= oQT_DLm3HJ^X=W_E?zi۶[iqbxiےfu|yV(K\mɓ''pp)${lŊ>*O/_6NDɹs[E[/pd'}brىJ/ֺ>XP4s7cȋ7}z: r>}lUoP\?^(pr*Ut=Xp#G!C:Z5_:p`QK˔);o|?}6q Rvͭ\_QBNڴbZ~hѢEbdi8jiLc?>A%X긿9sPΜ9Zt騫WwSza~je Np1c^ZAݻPo&!nϛcӦׯ '@߿\,@ؼaXh~ Oܷo_+wnw0ns׫VW?;6P8mZ? ͍N><:itf~;Dٲ% CDͺ8A!&4m}dX@n90gBAA ų|޺_|j 9dlSћl 7=,Y2C*,bFA6]D!zEtE,^*V78zQ1̠7[NO7 X]R9swao߶@ J&N%pRb:u*.]<+=1K7NV _OX<vB[vmCD1138~\ /\}6n\UGD3M2 /f֊9!pвN*U'N(8ׯm1̸OX0 m^@!LYĀI-Hh]{G#ǭ(eKX}.ƉI`|oYOg@4YfL=W#Ftɟ .Lé\o("bhǎM[31SAU=X 5{|N.ƉI`|ɠA$LnvxT ƀ̙Mw 1]1cf3oQOO8ٹs8pKPlkq}Lc#Л0ھ}vf41NLN hڕN76lF ( B +U*XBq JArUi[8q}LcH+ƉI`|{ūq A^p2鋇_~Nūova ޣ}tuk~>&1N$KO0~prZW_E;_Νxmu⭞Z5Dq}LcH+ƉI`|;)(>"bhPPC5j`]o8ZZ<І',I81o'N((Lb7P`p8_]k#gvZE/'q$bd4qƲZI8qaٓ|,)81ɤcS3N)A 9'&DZ1NJɃ ]{ܹ?hP0e} zGEM};m Ц_~IY<*5Nv;@~ARԩu9rd>޽ .]ډcc#ΟU|R Ϟ|aPfIQɓkϨcBPq"'B"[KͥVXg K/}8ImfQbut"lU''Pa!).p˗?䯍s7ؙ|AfIQ8н<'$cH+ rzret=r}L) ۅ hp:0FOO7qԩPI4J>\ģ2aBOZ>{v3k )&_fI5Nq1{yN(ƉI8VR2..xv₽ ˨3ߴ~G<|xT+֯_=l1@CxuUjDGOPԿ{̯Xb -@11̦M_nH17Kq".@t/ 81ɤ 8[ٕUBsvg';w΁ H=crv?>Çw>ؔ 'cTۡCeQ{;wⁱD&5_nPl'_HL\fIQ8ѽ<'$`|!e0㦾=d{L_z)?7`Pr吺,^<2O~57V[8Q#JQfoGWG $4pV[|}}(֛%-[ĉs61NL2-s0 bSV$)NЀ+BW{pBl2`g7K*9'&s0$S~a1c4$o]`Q%_H/ƉI/'9!& -_>Bivy&qbq0Z`REbdO<_cH+ƉI$Ƀe0ƉbdDZ1NL2`|Iq"'&[I`|̱8{P^-XYeȤT)2P4 \H{P29UHtIIի818y.d1NL 3*3G*BN鞎q`Ҋqb%&ŃbQpR\nƍcJ1~d1Q,Oڂ)yJ|)"b(mw23 ") m,ںgtju \r?£F0Nii8Q86Õ+^^Ov-.$n͒p~;f'\2V-W\~8aêy=.^ܡA&O/0m5k&~t/*Pky8q1ND(b4M%`*y, _ Fqq=~)6;?"SEX0qA=w~t8J8q1NdOmЮy\0%AɧO8yI}}} D NdfsREX姀ĄmԳUӍ&̖'4ƉbIM0s:Trٲa`wH8_gwC8?Kbi818%1ƉV.'&}ItJX"D7C|mZK+p VrD81$ĉ1N#$R17iSlIA-K`KLNƉF it5hS32eΛ|6*׭pb| ;ժk/jܸ:H?\/у=M]Fo1ND-4 " ͛h)fH'p֬g@6d+PalnWV qFxi%zM6ƉbBAͧ!Exze"m%٥*pnjޮ]Zw&L`OSћli8!ٓBAZ| Rĉxir8dV8 R%.fܸh\2у=M]Fo1NdOmju)fQdV8M]'..W7'ZI/'6M< n> id "Pqb{\d`|$ ƗғB7MȘͧ! 8Ql$kMRĉ%zM6Ʒ2X@h4$ R3J @'&s0$uzlqbq0>Kb\,у-1NL2ƧeɃe0ƉbdO˒`i818%Ɨ'Ҋqbq0>-K/1N$`|Z<_ĎMNÿ^4ll7Lq" gcĸg1N0MF8V6 }&DZ1N$4nhi8aиg1NMBFҚ:MFƖ8accccce?~*1NIENDB`java-design-patterns-1.16.0/template-method/pom.xml000066400000000000000000000036061312550536300222430ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 template-method junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/template-method/src/000077500000000000000000000000001312550536300215105ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/000077500000000000000000000000001312550536300224345ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/000077500000000000000000000000001312550536300233555ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/000077500000000000000000000000001312550536300241335ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300257635ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/templatemethod/000077500000000000000000000000001312550536300307775ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/templatemethod/App.java000066400000000000000000000034261312550536300323670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; /** * * Template Method defines a skeleton for an algorithm. The algorithm subclasses provide * implementation for the blank parts. *

    * In this example {@link HalflingThief} contains {@link StealingMethod} that can be changed. First * the thief hits with {@link HitAndRunMethod} and then with {@link SubtleMethod}. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { HalflingThief thief = new HalflingThief(new HitAndRunMethod()); thief.steal(); thief.changeMethod(new SubtleMethod()); thief.steal(); } } HalflingThief.java000066400000000000000000000027731312550536300343000ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; /** * * Halfling thief uses {@link StealingMethod} to steal. * */ public class HalflingThief { private StealingMethod method; public HalflingThief(StealingMethod method) { this.method = method; } public void steal() { method.steal(); } public void changeMethod(StealingMethod method) { this.method = method; } } HitAndRunMethod.java000066400000000000000000000033711312550536300345640ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * HitAndRunMethod implementation of {@link StealingMethod}. * */ public class HitAndRunMethod extends StealingMethod { private static final Logger LOGGER = LoggerFactory.getLogger(HitAndRunMethod.class); @Override protected String pickTarget() { return "old goblin woman"; } @Override protected void confuseTarget(String target) { LOGGER.info("Approach the {} from behind.", target); } @Override protected void stealTheItem(String target) { LOGGER.info("Grab the handbag and run away fast!"); } } StealingMethod.java000066400000000000000000000034701312550536300344760ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * StealingMethod defines skeleton for the algorithm. * */ public abstract class StealingMethod { private static final Logger LOGGER = LoggerFactory.getLogger(StealingMethod.class); protected abstract String pickTarget(); protected abstract void confuseTarget(String target); protected abstract void stealTheItem(String target); /** * Steal */ public void steal() { String target = pickTarget(); LOGGER.info("The target has been chosen as {}.", target); confuseTarget(target); stealTheItem(target); } } SubtleMethod.java000066400000000000000000000034171312550536300341670ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/main/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * SubtleMethod implementation of {@link StealingMethod}. * */ public class SubtleMethod extends StealingMethod { private static final Logger LOGGER = LoggerFactory.getLogger(SubtleMethod.class); @Override protected String pickTarget() { return "shop keeper"; } @Override protected void confuseTarget(String target) { LOGGER.info("Approach the {} with tears running and hug him!", target); } @Override protected void stealTheItem(String target) { LOGGER.info("While in close contact grab the {}'s wallet.", target); } } java-design-patterns-1.16.0/template-method/src/test/000077500000000000000000000000001312550536300224675ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/000077500000000000000000000000001312550536300234105ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/000077500000000000000000000000001312550536300241665ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300260165ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/templatemethod/000077500000000000000000000000001312550536300310325ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java000066400000000000000000000025031312550536300332550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } HalflingThiefTest.java000066400000000000000000000044341312550536300351670ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; import org.junit.Test; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; /** * Date: 12/29/15 - 18:15 PM * * @author Jeroen Meulemeester */ public class HalflingThiefTest { /** * Verify if the thief uses the provided stealing method */ @Test public void testSteal() { final StealingMethod method = mock(StealingMethod.class); final HalflingThief thief = new HalflingThief(method); thief.steal(); verify(method).steal(); verifyNoMoreInteractions(method); } /** * Verify if the thief uses the provided stealing method, and the new method after changing it */ @Test public void testChangeMethod() { final StealingMethod initialMethod = mock(StealingMethod.class); final HalflingThief thief = new HalflingThief(initialMethod); thief.steal(); verify(initialMethod).steal(); final StealingMethod newMethod = mock(StealingMethod.class); thief.changeMethod(newMethod); thief.steal(); verify(newMethod).steal(); verifyNoMoreInteractions(initialMethod, newMethod); } }HitAndRunMethodTest.java000066400000000000000000000032141312550536300354530ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; /** * Date: 12/30/15 - 18:12 PM * * @author Jeroen Meulemeester */ public class HitAndRunMethodTest extends StealingMethodTest { /** * Create a new test for the {@link HitAndRunMethod} */ public HitAndRunMethodTest() { super( new HitAndRunMethod(), "old goblin woman", "The target has been chosen as old goblin woman.", "Approach the old goblin woman from behind.", "Grab the handbag and run away fast!" ); } }StealingMethodTest.java000066400000000000000000000117161312550536300353730ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import java.util.LinkedList; import java.util.List; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; /** * Date: 12/30/15 - 18:12 PM * @param Type of StealingMethod * @author Jeroen Meulemeester */ public abstract class StealingMethodTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * The tested stealing method */ private final M method; /** * The expected target */ private final String expectedTarget; /** * The expected target picking result */ private final String expectedTargetResult; /** * The expected confusion method */ private final String expectedConfuseMethod; /** * The expected stealing method */ private final String expectedStealMethod; /** * Create a new test for the given stealing method, together with the expected results * * @param method The tested stealing method * @param expectedTarget The expected target name * @param expectedTargetResult The expected target picking result * @param expectedConfuseMethod The expected confusion method * @param expectedStealMethod The expected stealing method */ public StealingMethodTest(final M method, String expectedTarget, final String expectedTargetResult, final String expectedConfuseMethod, final String expectedStealMethod) { this.method = method; this.expectedTarget = expectedTarget; this.expectedTargetResult = expectedTargetResult; this.expectedConfuseMethod = expectedConfuseMethod; this.expectedStealMethod = expectedStealMethod; } /** * Verify if the thief picks the correct target */ @Test public void testPickTarget() { assertEquals(expectedTarget, this.method.pickTarget()); } /** * Verify if the target confusing step goes as planned */ @Test public void testConfuseTarget() { assertEquals(0, appender.getLogSize()); this.method.confuseTarget(this.expectedTarget); assertEquals(this.expectedConfuseMethod, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } /** * Verify if the stealing step goes as planned */ @Test public void testStealTheItem() { assertEquals(0, appender.getLogSize()); this.method.stealTheItem(this.expectedTarget); assertEquals(this.expectedStealMethod, appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } /** * Verify if the complete steal process goes as planned */ @Test public void testSteal() { this.method.steal(); assertTrue(appender.logContains(this.expectedTargetResult)); assertTrue(appender.logContains(this.expectedConfuseMethod)); assertTrue(appender.logContains(this.expectedStealMethod)); assertEquals(3, appender.getLogSize()); } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getFormattedMessage().equals(message)); } } } SubtleMethodTest.java000066400000000000000000000032231312550536300350550ustar00rootroot00000000000000java-design-patterns-1.16.0/template-method/src/test/java/com/iluwatar/templatemethod/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.templatemethod; /** * Date: 12/30/15 - 18:19 PM * * @author Jeroen Meulemeester */ public class SubtleMethodTest extends StealingMethodTest { /** * Create a new test for the {@link SubtleMethod} */ public SubtleMethodTest() { super( new SubtleMethod(), "shop keeper", "The target has been chosen as shop keeper.", "Approach the shop keeper with tears running and hug him!", "While in close contact grab the shop keeper's wallet." ); } }java-design-patterns-1.16.0/thread-pool/000077500000000000000000000000001312550536300200465ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/README.md000066400000000000000000000015221312550536300213250ustar00rootroot00000000000000--- layout: pattern title: Thread Pool folder: thread-pool permalink: /patterns/thread-pool/ pumlid: JSV14SCW30J0Lk82GFzq8uF6a1624IUx_UIPt-xHhMXK2TTN0zP-4pa_-UfeSSOMBzCWXbpceAxnCDZfmpUdAhjVbXO3uhPfyFw1q5oufZMdag3yFuUFl6Be5m00 categories: Concurrency tags: - Java - Difficulty-Intermediate - Performance --- ## Intent It is often the case that tasks to be executed are short-lived and the number of tasks is large. Creating a new thread for each task would make the system spend more time creating and destroying the threads than executing the actual tasks. Thread Pool solves this problem by reusing existing threads and eliminating the latency of creating new threads. ![alt text](./etc/thread-pool.png "Thread Pool") ## Applicability Use the Thread Pool pattern when * you have a large number of short-lived tasks to be executed in parallel java-design-patterns-1.16.0/thread-pool/etc/000077500000000000000000000000001312550536300206215ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/etc/thread-pool.png000066400000000000000000000347141312550536300235560ustar00rootroot00000000000000PNG  IHDRs*f9IDATx_Uw^%ڋ 7&jBK㟲)!mR8RXV %n(S-Zix*Н@Ыn% G( d_kz֬''sffϬ=ϳ{5LhuA,⁲رrv(L̿h_v@Y,( er;,P`\nG1ʲx1/BY=*z{ #hA$I>MɇDJʕao+u"j=v+v(FLz}̖k1n8NZDUC,}.CPQVLЦ` >ʢyLwU?</7ʕ7,O17à,=.#ՠ,=.e&v@Y,( er;,P`\nLȯ,g^][x`K?ٰ^,Xr;r*0A;[xl=[T[$Ɠ<LM)( p.#0NO?]zh]ܶ@Jq'w:D-Pr;uyXk;OyJ:=5Z.qȟud4ӎPHr;ڇvp,==ɖe[pU$jxk5[4Dsb YF3 ^Yv t A,geY{`-v{{G3 lJ+~grFa"a/iQO%T,CD#r;uvV޽ig. _g}/^"?$%W|)v(Z1i&W=<>ۑwv}W3ǟ8{r̵Y+^*vx;JP.I' Xts)@Yz\n|ѝm2<Ƌ?6 ^_>n}M[H>W$ ~(IY! ZYX,g^]W ov|rlȜ#*gQK)'({O 8,>xk{嫏lVq( \2KT kW,VA7@Y py%ZqMntd+˖ٚp>ّu&EI "BY5p9ew:}}ko1ot܎C( er;,P`\nL퀲@Y pP( 0.e&vԯ,KzX( (܎$-BpRtloxuOOWo( seY5QP{*Up( ܎<%s\ Lށ4.y/ 9rBr;BYNJ+`e_*V}vE/\~4=+d}@Æ/N,CY@Y\^\Y=53y2"].ULC-d%jjeJYny盎xt!~PzAm›mUTJhIÊ+WPήkIAYz\n,5=6e+]_>Q 5* 7$Ș_c)CP,(I!nBY\n,߿wmJyϰ$ .€E:!󓤙w 8,/]ZL١,@.R﹅[` c+S{55dCPsex3~QDr;4#_ߴoza?ؿݼ7,gFYn 5ΒVp}%]gJyW0xr;wo~]g@&|wX:7To }J5`8^h\gyb ϳ܎V+ ngp\nG˕f2?& ePKڮ,v@Y,( er;,P`\nG]Ѧn0C0P`\nGMʒ&#+ u"\ɲ)TYuʯ?@T` >RG\c$E CY@sT_u6'͗cF@Y@sT&\'U T".W<( z_} >EubtՓrD%bx( ((Kw9 4bwXPb;@Y@s@,m۶;w.WmPx@YZ̎;8+ [϶Q(<,-w'>7[beakzei7|%V4X@@Y l  ,'nʂ hP7[ ,heA) ,!@Y:k0eA4( ʕr`׶nr [-ʰ8u8e$P( p&@Y3p0 IR`vR1#F%̀IZ,ArK,^`Ke9`}~trq'b5_6_eP ʲ过Я& 57^$I7%+B*WԉPd+KXڡ33[8l7EǸ;QjexJW 8$CYFfDCX3A- '+ nԔZIp=$Y{:}<,&!Aj\oBd9"Wr9j'$rm+#Zu yWbXzo(^'P NF6caWڇ3zsJg&A=p0Iϳ$\gO|EN eC\q{CE$+ '`( 8@Y,8e$P( p&iL*DLIW3.]-W<0lXwp [f~( 0&XYv| ʶny4jte[{t顩ZY=Y e>BY@^`ʔuXk;OyJ*C , yl ͵#( &LY}h G҃yO/N?ړӤ2:D<-9P`LR=e▇_ ;[=wc#7'SR~x.b0hT,rk,/}»;Ό-\p%{֭޷+R 2ɄɤjxtO8pSYy`*,_޻~}o޷q =s'7pفl9Ф} eʆC7L FBAY@n`ʔ[\oÖ7^_0:un݂őH75Qv䝡,H`ʔ̫KܶC7q|ގ _n>meHZ|6D ҷy{=QMTyy`ʔ/s;;ss_|x=ۚ4|+ $%Tr\IT@\.k7=uӑ/[fkb4|#IMTp^epW e$~ethVx/BXY$uJH$( (8$SYo.KbsY)CiHWz%2ZIj fs7gQmP2p0I{ʢ|qO:v88-.,n@Y@$mw$E a^' ~7''sUeI,D`qeQg_&&Ĩmm( 8$׼!@%!˕HugQ*K[KPLR~I7|+DRU{CJý!Pp0 :CY3p0 I,P Leg`( 8XH̍}c؂ko y`+ea"~dt8UY꯷7(K灃IzC~W_DpP`LRB隠,8IYAY,}&)'b"8( 0&ɝSk,8$wN%s`Bru)SC,8OIe$B"8( 0&\g( p&@Y3p0 I,P Leg`䔃g`䔃g`䔃g`\9xT~t-m(K灃IrY Cá7ixJw,&ɕS`e@&h\ @Y@A$9o_mɞtsNqW3I,69m$KM) W`9K_.٦H5O6%mԚy`brʥ%jD*+$$jȶft8r#(4]!Y>T4#$䔳VTŖz=hEsܯZIrg~J52_Q4*U*AY:LoF"BY^5ia ZroHVAY:LP Leg`( 8@Y,8e$P( p&Y(vmv/(( mY+p0 I,P Lb,ӋN>uOO$ʲkM9lz|t8VY_unP+)<;?Y0yH y`zC(ee [ڲn) 8D,>{ _90Fp Ue ʒsJ&(˕~گ|-i+yLIQ$m \f$7#f|j8 ="e2ٽكI(eЮv9'/[,ł|G3'|:m% LB)o2^ED@ $Ml`38@Y,8e$P( p&@Y3p0I"*+M=V:B^a_er\K)Uf-Pg3I WMI,=&(\fE1Zθ>fS(K5% 8D3SNȨg{&fWgȴw޺ JB2e!ؕβ$sUVu{ eBg+/5mIxeL&CĮg>cǎpP$P)K]sέXe߼y[,$PR]afa-?#gĚ0RC-5י`X@YHV8oʁ][voúmR"Ν .EsZ$0v,%~6" `X ˂5 eѓjضmyc;  5xwYm}+.xXmEr?ka wYre<4eDj9rG?Q֗JA V[PL⡖|g\ `Mz t@Y2 Z6KAƶm:$d Hݟx}18p`ǎPgX}/'NlذA DqgϮZJʒ >w;Ce D-q5kl޼Y(%'}.Xk%]rC'CY>QAٳgm}쳟ca(K!O:Er=\}լt糟de)ZHXc.65kVXQw:DRKKKV]}e) Sݥ2(KaH ]6(K1hrbA@YA9DRΝc]!zeO|,笉^w)D R7oF.A@Yy( %/,uOX,yApDʒ >B5>Q3СC۶m}eɅ~?P 5(;,YWRŝ{~uO(,ZjiiRő_qݥ5(#] >QC8}eq)o DMR6j'Q+?=9B,>exz5R?9(Kg ؠ,0( b , *(p0;)OTAY "UXY&']=%]E[]`}.Y ǟ/w"[eeZ_Uը,d=kg ފF'+B*WԉbjRDW-:%J*Ar he'ivz)iם(2W$НR+#/S ."Wϗ%xz&UA_ [߄6K%<2Cy,x0,9\fƓ }Nd(# HY]gL?zxk~.dE?6V}8 &qVy> +4z?eAtl+K%>":,P2|8}cʂjD5RY`EVAYzaPXeAY`eUlP^VAYzaPXeAY`yu麇o⁹/dú[2[SweZ+%P'`.;[xlc1OHS$43& -y$>bP,2z>Q+qt%PSecLr:eaNO?]zh]ܶ:~W2H_7M\iuMA&TٸJp2 Brm 0}ȑ;OyJ?zj HOCg,lWwf4 ]hv,ZγXY,+M0Ȍ%򔤖`+7!G*˵wYz0zgqzמdyysztXʳ9RBH7%BegDx^P~<iK2/b+[@HTRT/O>j7KbT,klٸ6s'ώ>5Gn`/g6>NtuM%HY)*!;88EtXŵO\e4Ta듴cB@Y+`Z+P.%1U(]߈sT]y_>s]ܝ_g.^=V[iEj4F_&@]oH,bi6%ʒP|KHƀfK lKe5jT![,vѥЅû[Mw@Xj46b|yM}o޷q =s'7pفm4U)NᮈrS,/SƋ?6 ޏ̿}pxŹ~@;ItST.ui,a*w_!یK3da(Sl8E1h,UmIUKQYμtm:t|xrlŽ!u SzCo)h4+(,A32chK} X #wqB@Y,K[CKsU!19( t%\q3\4 |&!b&LW|@Y]5\ssCt'#.?[,3.e2>JO Q}< j (_eB*q?j3A?ValqI%ss4NY]\E \E>t7\)x~ks\1MTDW!$eW%xx~-1~t ʂ1,pWGv=O`O.NJRIUc5GY^^c' Giυq8/I,sI j F) H*6(K/ ؠ,0( b , *6(K/ ʲby!CPRCmmX6@oeUlP^V*_/-瘱dgn\{cMX 3Uh!@LF) bf,)P)lB,u W!a'x"dK% f;H:C)6?fL_HMw6JYKQ!ϓV]d派ʭ1CeѶ` mf8SxzI1fSڤPM^.)՘d´w)IFYٻ(7W b,2(qf4N=xqi,}c)6 Ǟrm qjh:/+ٟ9]/.P[ﱤ ExxYxN]  ZlW6[]A bCi%cFv$:cmQX= /JqO֊Qu#^l@*`,o.哝%8@nP,ICҔ-OR(U+dque\LҞ&/. %5ׯx׉w^knZKwTlFTekһXҜAYItTw}a6bSO)ktFސבKYe],YE-JQ(3 ›c4_iuk yZ5)Ԅ e;UYN#U*TE ^6~t>{YOq/uHG&l1Ib:w]NeI=CiZ6POOXi"mn6LeGF6},e"M=ZVg /6 KSXkAYzaPXeQ7G=\Y*7(K ^h,Z{à, *6(K/ ʂ79t T  , *2ĺOSw?T)%ʂXU5\e Z,.Y1R_ ) bV6'h4oxLStRUki̟&Sm̺mUE.BΘ+Ck< Q/P[<<+BX:1Qeٜ4hK #tdaWg&jWPEYn}.Wslau_>yts@A,~ӓj\1bIqm+CYaRRPZY|~}lEQT EI{zdR+kLbL9*4# >!q 2/OP:RJ'OC)wѢbd4,ٱt,6Ezg KTE*-|ӱO=a/[)즓:9|%& vtV !3!\E'"~O[It6hːYd6PYbI7=B\/Gh"C_ؽ&{ؿl(!n{!_Q|-^i/^Po˓::ՠ+4A:墴!ݵқ||qSv+e+4!R ' Zre{!%J2^.G^_N%WtG_my:,Fn y0aݠқl=~磊Dž}-[[)F@å͢ 2ף~/ 77)E}:>MkU*Q,esm B 6Vv:f,̾6iC>¾-/аgX] {!,wϬK<NDAGXYbISXJ_j,هeJo~)d n 4vZ); >yp])EdWѬ;e 'dg{Pv,*B>nhTeXv:,\W\oHY`/e13]=.)Z7흵<e1豢X, LkuP *6(K/ ؠ,0( b , *%y4'+{UK%STTzʂXj,{H9\ҹur9_UIA,u, EY<`cqC\DW($[cUVU0jFFܑn+JՙyqYn..xng5%ߚ,6ƒCS.5PNWtGST3rs?%nO,ƒCS֩s9##gU('z+y.R1MV} java-design-patterns-1.16.0/thread-pool/etc/thread-pool.urm.puml000066400000000000000000000014511312550536300245410ustar00rootroot00000000000000@startuml package com.iluwatar.threadpool { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class CoffeeMakingTask { - TIME_PER_CUP : int {static} + CoffeeMakingTask(numCups : int) + toString() : String } class PotatoPeelingTask { - TIME_PER_POTATO : int {static} + PotatoPeelingTask(numPotatoes : int) + toString() : String } abstract class Task { - ID_GENERATOR : AtomicInteger {static} - id : int - timeMs : int + Task(timeMs : int) + getId() : int + getTimeMs() : int + toString() : String } class Worker { - LOGGER : Logger {static} - task : Task + Worker(task : Task) + run() } } Worker --> "-task" Task CoffeeMakingTask --|> Task PotatoPeelingTask --|> Task @endumljava-design-patterns-1.16.0/thread-pool/pom.xml000066400000000000000000000036021312550536300213640ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 thread-pool junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/thread-pool/src/000077500000000000000000000000001312550536300206355ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/main/000077500000000000000000000000001312550536300215615ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/main/java/000077500000000000000000000000001312550536300225025ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/main/java/com/000077500000000000000000000000001312550536300232605ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300251105ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/threadpool/000077500000000000000000000000001312550536300272515ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/threadpool/App.java000066400000000000000000000076161312550536300306460ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.util.ArrayList; import java.util.List; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; /** * * Thread Pool pattern is where a number of threads are created to perform a number of tasks, which * are usually organized in a queue. The results from the tasks being executed might also be placed * in a queue, or the tasks might return no result. Typically, there are many more tasks than * threads. As soon as a thread completes its task, it will request the next task from the queue * until all tasks have been completed. The thread can then terminate, or sleep until there are new * tasks available. *

    * In this example we create a list of tasks presenting work to be done. Each task is then wrapped * into a {@link Worker} object that implements {@link Runnable}. We create an * {@link ExecutorService} with fixed number of threads (Thread Pool) and use them to execute the * {@link Worker}s. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point * * @param args command line args */ public static void main(String[] args) { LOGGER.info("Program started"); // Create a list of tasks to be executed List tasks = new ArrayList<>(); tasks.add(new PotatoPeelingTask(3)); tasks.add(new PotatoPeelingTask(6)); tasks.add(new CoffeeMakingTask(2)); tasks.add(new CoffeeMakingTask(6)); tasks.add(new PotatoPeelingTask(4)); tasks.add(new CoffeeMakingTask(2)); tasks.add(new PotatoPeelingTask(4)); tasks.add(new CoffeeMakingTask(9)); tasks.add(new PotatoPeelingTask(3)); tasks.add(new CoffeeMakingTask(2)); tasks.add(new PotatoPeelingTask(4)); tasks.add(new CoffeeMakingTask(2)); tasks.add(new CoffeeMakingTask(7)); tasks.add(new PotatoPeelingTask(4)); tasks.add(new PotatoPeelingTask(5)); // Creates a thread pool that reuses a fixed number of threads operating off a shared // unbounded queue. At any point, at most nThreads threads will be active processing // tasks. If additional tasks are submitted when all threads are active, they will wait // in the queue until a thread is available. ExecutorService executor = Executors.newFixedThreadPool(3); // Allocate new worker for each task // The worker is executed when a thread becomes // available in the thread pool for (int i = 0; i < tasks.size(); i++) { Runnable worker = new Worker(tasks.get(i)); executor.execute(worker); } // All tasks were executed, now shutdown executor.shutdown(); while (!executor.isTerminated()) { Thread.yield(); } LOGGER.info("Program finished"); } } java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/threadpool/CoffeeMakingTask.java000066400000000000000000000030061312550536300332540ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; /** * * CoffeeMakingTask is a concrete task * */ public class CoffeeMakingTask extends Task { private static final int TIME_PER_CUP = 100; public CoffeeMakingTask(int numCups) { super(numCups * TIME_PER_CUP); } @Override public String toString() { return String.format("%s %s", this.getClass().getSimpleName(), super.toString()); } } java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/threadpool/PotatoPeelingTask.java000066400000000000000000000030261312550536300335120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; /** * * PotatoPeelingTask is a concrete task * */ public class PotatoPeelingTask extends Task { private static final int TIME_PER_POTATO = 200; public PotatoPeelingTask(int numPotatoes) { super(numPotatoes * TIME_PER_POTATO); } @Override public String toString() { return String.format("%s %s", this.getClass().getSimpleName(), super.toString()); } } java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/threadpool/Task.java000066400000000000000000000033171312550536300310220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; import java.util.concurrent.atomic.AtomicInteger; /** * * Abstract base class for tasks * */ public abstract class Task { private static final AtomicInteger ID_GENERATOR = new AtomicInteger(); private final int id; private final int timeMs; public Task(final int timeMs) { this.id = ID_GENERATOR.incrementAndGet(); this.timeMs = timeMs; } public int getId() { return id; } public int getTimeMs() { return timeMs; } @Override public String toString() { return String.format("id=%d timeMs=%d", id, timeMs); } } java-design-patterns-1.16.0/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java000066400000000000000000000034121312550536300313650ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * Worker implements {@link Runnable} and thus can be executed by {@link ExecutorService} * */ public class Worker implements Runnable { private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class); private final Task task; public Worker(final Task task) { this.task = task; } @Override public void run() { LOGGER.info("{} processing {}", Thread.currentThread().getName(), task.toString()); try { Thread.sleep(task.getTimeMs()); } catch (InterruptedException e) { e.printStackTrace(); } } } java-design-patterns-1.16.0/thread-pool/src/test/000077500000000000000000000000001312550536300216145ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/000077500000000000000000000000001312550536300225355ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/com/000077500000000000000000000000001312550536300233135ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300251435ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/threadpool/000077500000000000000000000000001312550536300273045ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java000066400000000000000000000025201312550536300315260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; import org.junit.Test; /** * Application test * * @author ilkka * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } CoffeeMakingTaskTest.java000066400000000000000000000026461312550536300341010ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/threadpool/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; /** * Date: 12/30/15 - 18:23 PM * * @author Jeroen Meulemeester */ public class CoffeeMakingTaskTest extends TaskTest { /** * Create a new test instance */ public CoffeeMakingTaskTest() { super(CoffeeMakingTask::new, 100); } } PotatoPeelingTaskTest.java000066400000000000000000000026511312550536300343310ustar00rootroot00000000000000java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/threadpool/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; /** * Date: 12/30/15 - 18:23 PM * * @author Jeroen Meulemeester */ public class PotatoPeelingTaskTest extends TaskTest { /** * Create a new test instance */ public PotatoPeelingTaskTest() { super(PotatoPeelingTask::new, 200); } }java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java000066400000000000000000000107151312550536300317150ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; import java.util.ArrayList; import java.util.List; import java.util.Objects; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; import java.util.function.Function; import java.util.function.IntFunction; import java.util.function.ToIntFunction; import java.util.stream.Collectors; import org.junit.Test; /** * Date: 12/30/15 - 18:22 PM * Test for Tasks using a Thread Pool * @param Type of Task * @author Jeroen Meulemeester */ public abstract class TaskTest { /** * The number of tasks used during the concurrency test */ private static final int TASK_COUNT = 128 * 1024; /** * The number of threads used during the concurrency test */ private static final int THREAD_COUNT = 8; /** * The task factory, used to create new test items */ private final IntFunction factory; /** * The expected time needed to run the task 1 single time, in milli seconds */ private final int expectedExecutionTime; /** * Create a new test instance * * @param factory The task factory, used to create new test items * @param expectedExecutionTime The expected time needed to run the task 1 time, in milli seconds */ public TaskTest(final IntFunction factory, final int expectedExecutionTime) { this.factory = factory; this.expectedExecutionTime = expectedExecutionTime; } /** * Verify if the generated id is unique for each task, even if the tasks are created in separate * threads */ @Test(timeout = 10000) public void testIdGeneration() throws Exception { final ExecutorService service = Executors.newFixedThreadPool(THREAD_COUNT); final List> tasks = new ArrayList<>(); for (int i = 0; i < TASK_COUNT; i++) { tasks.add(() -> factory.apply(1).getId()); } final List ids = service.invokeAll(tasks) .stream() .map(TaskTest::get) .filter(Objects::nonNull) .collect(Collectors.toList()); service.shutdownNow(); final long uniqueIdCount = ids.stream() .distinct() .count(); assertEquals(TASK_COUNT, ids.size()); assertEquals(TASK_COUNT, uniqueIdCount); } /** * Verify if the time per execution of a task matches the actual time required to execute the task * a given number of times */ @Test public void testTimeMs() { for (int i = 0; i < 10; i++) { assertEquals(this.expectedExecutionTime * i, this.factory.apply(i).getTimeMs()); } } /** * Verify if the task has some sort of {@link T#toString()}, different from 'null' */ @Test public void testToString() { assertNotNull(this.factory.apply(0).toString()); } /** * Extract the result from a future or returns 'null' when an exception occurred * * @param future The future we want the result from * @param The result type * @return The result or 'null' when a checked exception occurred */ private static O get(Future future) { try { return future.get(); } catch (InterruptedException | ExecutionException e) { return null; } } } java-design-patterns-1.16.0/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java000066400000000000000000000034111312550536300322570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.threadpool; import org.junit.Test; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; /** * Date: 12/30/15 - 18:21 PM * * @author Jeroen Meulemeester */ public class WorkerTest { /** * Verify if a worker does the actual job */ @Test public void testRun() { final Task task = mock(Task.class); final Worker worker = new Worker(task); verifyZeroInteractions(task); worker.run(); verify(task).getTimeMs(); verifyNoMoreInteractions(task); } }java-design-patterns-1.16.0/tls/000077500000000000000000000000001312550536300164325ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/README.md000066400000000000000000000015361312550536300177160ustar00rootroot00000000000000--- layout: pattern title: Thread Local Storage folder: tls permalink: /patterns/tls/ pumlid: categories: Concurrency tags: - Java - Difficulty-Intermediate --- ## Intent Securing variables global to a thread against being spoiled by other threads. That is needed if you use class variables or static variables in your Callable object or Runnable object that are not read-only. ![alt text](./etc/tls.png "Thread Local Storage") ## Applicability Use the Thread Local Storage in any of the following situations * when you use class variables in your Callable / Runnalbe object that are not read-only and you use the same Callable instance in more than one thread running in parallel * when you use static variables in your Callable / Runnable object that are not read-only and more than one instances of the Callable / Runnalbe may run in parallel threads. java-design-patterns-1.16.0/tls/etc/000077500000000000000000000000001312550536300172055ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/etc/tls.png000066400000000000000000001033151312550536300205200ustar00rootroot00000000000000PNG  IHDR\AaIDATx}]W}}?HVVF CyT%vh0AybpCrB*$N$;@'7! j  Π Q7YgZ諫}Y{={w N:˖-o@Ɉ\ '8"3T9,8@ <: N'/΂ p1,8Յ`nRT\&#g*N ;<:K@c Wk8h;<:KXIuEel2gU @WY,NӦF/Mno!"ilỳ0ouK%f87d5д0+lq x~tZco' ƙFbY@ 41N1^DUayg֌yҴ '-@gQ-Mbs/NXz- ߪq]2ضǸOҭ @{YP |p/r:-K:*h5[I_%ǻ0=*, ' e,N@w~ XFazК_nMN1['4퓱,N IhzڕշsQHq^{='* ?7lK[Nd'@gIt7,w1ܗ[+;ȭ.;,N`|[>w75>n"מzx0|PR?[sAok J e!t_% On8}ϝߕ7~*66A f'>]려2{p$Vcz/ΒN~?}]/ʺڿߪ}ybuu19s*^K(W#0( _%p q}}Cl@fP||5/ICX $O1LqDoG8h/<:KJ' /[kV=f' @{Y; p1,8@ <: N'/΂ p1,8@ <: N'/bwK27pZ] Rl, 4Ny,h|.FEbeoYl$I8>TPk}#궆l΍N']@gID@,[7L`=Mpw:hg{d΍'p$qMHt A^::_?t_%c?/q%{'`}a SdÜ7Y5N/Β L&1Qj|!x|iu&طMdXt_%] :Nhۘ'Pg,N zAyK)|J~z4o -iN i9ӡu: i9v8^I7bO%H7vPB 艄ٰ;á# ']@g;,I8h/<: xec#_^'p8 p1,8@ <:ˆ @Ɉ\ '82N:;<: N'/΂ p1,z @{ tu Yp8x~tN _'@g bYp8x~tp07KӕVK` +._V'p|/~4Ѷ $obJl,N~/ʼX( xA?\Xno,1N?}o'^z@,# ٧z ,[ǫr}Cjp^x~t;ɳ:!>j2> ØޱβnBҞ[%_^{`xC_}FK<jp4Ν;y;&I}>8V}27w4f'iyG >p4}Z/QbwBDDT>PtIJv zTp(ad< N&yq17z[7tVO3ŲT MK4b vb\(A 'b׮]NL&L,P8:dk{&ǜ W[2{0/(+S9NfE붕=\JNC0 N&Z'4FK㡿F[A杸eNIqu NC0 N^At{˓4!&@vB^I? '!F@'ŏ?n/ړ%>^ [IQDClk܉lƕ`!Dab A<qHېƶsb;5U8hitX$pT8h7o$qƺ ApT8h,tB=NpXB=N ?Nj SlAcNpT8(F/чo/gU ŚsPpX@:̗O;}+|١z5e8Kt.ai%C+O~Ǔ~}".?]W{#;{g5ەN Xޱ5 zw=]Vak0;F>898m?'^+q >yj/L~yՏ?q[i2\T/#8j[i(pXLzܱC7?OW}y׃ŷyujYnnhbk$77 5npXqTN`Vu_GosbGF|kp6'`tQh>K`f`  uՀ(@"W^{fuŲXcgfw]AQDN`=( 䘵9%@ _YЉOw{mFA5E8h, TN ''@5P'P 8z*@ SP'P 8z*4~Հ@"؂B@5p='POB@5Z0:pN. ķ @c P 8 'WlAcNp-T'0 =Fpa5,Fޕd#}޺ܨ Tp='RN@D%1j@O#*\cJxxir27=d$Z)4'R P~az ט[ɢ5g6)V8h,8'R)o3i}l@0JwH_M[X@K%{Q$׍i|)%Z2+@ TrW`9RAоߒf=\c 'P'P 8*,w~P? iL .z>;h@@Kp-4Ob:֊`  uՀhnZ4Đ B=N uՀ@ @c P 8z*-h, TN 'sP`Æ7[G@ TuTB=4lZtfB3Nj!j X|XpBB4j p7Eg$4~pp* >"؂B4j k4 Ҿ]]&huZ};qM_LW/܋B8PUBtlL0eF8h, @ *+*ӊM[SN@7&d){*^8h,8BN؊M[S'\hiltmHf87sӰA(0X9Kpa697ہR:5^嗝.[.d4L Oj@myItNw 1J0B@1Ŧ9Jfm+`O;m} )S8tܶamJ%zmdguPmͼN6&3ə7{RʠjKwc}7JӶ!"1JJ,.5 tH3 } ЖJ9HUVޱN@{N+hxiMӗVOx'Ƶz 5,; x]`i! Ǐd:PAnIv|xKj -?ҿ_$Ee2*< n?vZXF"]/[I#ZldV[A8PDP}|3xq6/>%ݪNK0vn, H]2k[{BС)wA%ѡ;Q8!B)tAhݩy6/N騿 JRFOX>qDt{B)]&qDtp|~e5 B(ʠ'oKw: p[ B(ʠOĝ"Og$B2P|h]yItNG}T[5N'5CQc¯ҌW OeУ nѝ>^~e/_~ΫA,5* :(fR^L;e&YS~6f.3R'"D((qwzJzKڧӕXb1S%8F@y*r k 9' B2 >@yIp|^y{?@yIp'#鑏\}})V<9'oZNvK!݁AYBq'ǯZ=Di[&cO k=+֓2)-d^%yrI3_R^W#_ {[EPQ6/ D]ykKd?w}B$HeΘ`p_E.*54S,N8LMw)g10uzѶZ/Ǿ*"Doc:tz'`j`9A,O.m!BFۼ$u١|c/N/߽+$.;?:|\v&і~lmW(N9U@Mq*r%qg10ń5be>ӛQH1 NXUHvif'\~IcM&8кe p`;(LdB $]ӑ2dm="D(ԣtWЎtfTЫi:5ɁE4HJm^˯ZN\?{˻- /ܨCz41}R ZԠx':&WF!BT 2J9LO9Hxx6 51& ' dJxһ6_ß{>W,ك׈o ri-=N uNeP4(R9aHaFs;eAr>q B;7_7{p+gx"ExP*u*:+B2Aqn BQzFr !6hw{ۆK[YGj8 9(PY yI2˯|'vܻ=_{8k6 '"D( G6R a2ǰ/&Z5|m_o"T 5Y#s9ʼ3V'>qW1Wۼ Nx p!B2Aq'LˉMD{ùS>#]B`UKZr;5u>/d$Wۼ2U(@Jk!$$Wo>_ Wv *2ҝT'$1GϪ>m?RoȓrX'`OOo'PEoy9 pdu>W|B9DPF6^u'@WSHy49̭lN mnҧkTGn V+Hl4 rMk+C՞^,;4~͛X* B2&>H?Jw|[Wa'WKaCy@r`OO,mJ8f R:AΚݙw4zp 8 g < ZDd9\8rqqCWb0ůa[{>7 (VePY|n3if x yAp6uQDʒh#X $O1qj:5{X}rm38xk 7>=B+p Ѽz,wqmqZ"Ạtۼ$pJ~v#n >=׸ZwZ9i S.e)nJ# 8K{>[qqpI(ecI֘OG39 ަ)VFMa%B2 >@yIpgSh֛*P$ ?; /\IOȵR͵l v;ڴْ1'ʞE4/*T)f[S>-YJ:k*?t/B2 >@yIpN'`/WBp("iю頫~#iӠIc>Ӝ9d"jKwzPP-sa4QDQrUy29rf87G{&7wN9['vN@HuioےKSr~LWI{ AQg?kJ!B2A|$n.~ RU##(̍[rUy0ed>g`,=kqZ{ Ȋ&> + D#5束0 D|c'҉ ۼ$:~0bnub<[a˻3#J6,"[}7My@쁻:N'Y:nRj35d;s9H2|Wk*4(WҼy@$s&Ci"D(m6/P(H2˃(47[s6fE= t%X. x_kd6hM!|jı& vY"D(m6/u M$ڀ<ԋ@/ڏ֞ Y1I;Bm"D(Q6/λ^S?N@J:ŵzo9}J㿍ɆF)"D(f)׍ۼ$zp;( V -8~=ڛ4H>mpP?ֺ[=NަGM*JeЎi T+nNGVB "A&qDtGBЕ)wD%ѕ;T8!B)tAh]yItNG} lzC |(▯q݈M+ʡ#w: ʠ#RFK#w:p!BRʃ;"nQNj@Pz2xm^Q5N`ϯBbٺBe!BFۼ$QU_BDPQ6/ tj|?+P&"jK;Znk(_dD&yioUwԋ,YB"jKjf1RL prosPL3YN bo: d+P%"@)B+6?y|ewGNG֠q*rҀaS$8Bc(:\82 >@6`ӦM?[#pV+x}e?uXnpH8?&FszCjp44Q} $qSJysEef2hnv(3mGVdzS`)seBy( @Ч'ڬAf'?/}QXqc`if7|:xuHt&(=*+ +%c:{&Q.QkE\@ FIN_Uj]o̿/Bywwj[I#71O.qiPkcO0fUIMI049!BU'P8(9p;#bB9-^_]}+%1G[݄{z'Socwh[ }CuIi# NU*@P$~^z^;C>wqȑϞ=&ɹs \n:iewo_|kk7 3oߢ:Q8 Mkr NN5_82 FI 9ydQJN@-ĥˋ #/p'sΩ(x} %9˫+(Ymg5w.O;y QDX?O?{Ofz U82 F)ϟ?/M6@[#:o)?mrcewo}]Jk~n'KG-hw:AyA^0ڶdȏeuAx4va9y -oz"@PE߾o|_ n0CY/G=Vf' Z'@ M.mQ:1,E2es_o|b|KQ.L6mkGq*gPzW/G(Q82D%jpePH $YK,RIPm;vTyt۝~۳_wjguB|+ЧrtD1 i%#dNw@mN ?f"ct-یPKv x(VFSF$ V% L+ _E8!B)?Hkd5n2JO|m F z_^Lsäh%&s#3fȶJ=ۼ$lw'nGpDH?r0V!p!BRHtH&q2Jn]-2b-i8u ^QaLsG N Kv>+Nx>w+J%ydm|:4×#dN!DP N Hip9L4Mgs{-yL}KN?7ۼ$bo[_8z[łI`M+'fN!DP )֎>;릹խ3q̓-li6{tdyIz(bAbz0}$i@"B'`\[=~^@{}tCd?^Q%QZdf(Jp 㷩6hTaJj Uo-Z-b-eO qnulWiݛQ~l6%K~3 'PMp _r:\ T%CRN }fa^sY}9#I5ޤj8t(|=qvh* P:JNQNt/7 tNQ֯PTXu^UE̲L:p%Z(Xrb dN$Q |מ_E 4vRGN?NuK3=LVV}8{d2ٿ޽{wA|PKt!@Idk!$a+xoYىg'(N.dQ׍@RAУAӦMnٲE,ǎP(LN@xw+깲9ogo {7+R‚R5.qTuP)DX &;eٳG7nԃP(|N2:}d@n4,N q qbk+q'No۶m8"_[[K7jp%QCA4J8JXؗrk:7ceCN@艃otmdH &UibOU=' b%ϋÆ F6lx1dQ 8[)CKѿ45S:Nx "z3M[oO:a|kOemP5o-4Y'` Ν;ʓ'O.\(YJL9؉o_~7ү̋ HZ8"N q+誘S.^(bSN~׮]"^WMoRLu6o 1wՏ'FWOXv#n lA)K |LGkWD*d郹FURk S U1>\,A8Q A@,bJ$jdjmlwmݩO} QT9W4U5O9N}vOÙeK bj2<: 5E8Q… "?ywߴH\_-͟7{@ToVc_{`xC_YDeVs^ WNBe HY` 7m$+VoϞ=[Ы?H#G{ QvR_u^|uYUL'P lP ^';domd|إ_Y&kS{dߢY^z1%Rd*@X֋!@iyFFl`ҏ 4Y24.\%JТ1`v'uɘ ~2LQ;<##f+ W@kȈdB@Y?$[ޭ x;裏F~W,5bg6lT~-a:ŕ6*OBWiBıҵ8#| F3Xo6W.|)g]? hn(F:V}G*$[R!xqL]HU;< XI7~J6&,N2[ʋVθ=Aj8'56ҵgƎ'S3h&5s% D3B) $M7,j,ׄ~ͯ DϺHRPT;n{:ێ=WZF+GɌg[4K~Pm;֬Z˳];^{Q6tqav[q?B:E+Apŝ;wuO N1)e1100RkG!L#_h?.^4??qF}a{e\*smm+wG"k5oV4κ?XqU 0:j9γɛ6bhT5*' 4EEh4zr){U,r/ #Ua\1OXmUkxɱqsi.[ \jߟrtc2y?A)qmՌ.#OR29^GMS6'nl7FO"r=t#~XgVޮL+YMG~=9/)?}:%P#i,N ei,o|ưԎBI_'.B2F4<4r{(keLkh~, Ҏn=D}NH)Gi*&NWqdrvFK5㹸;%x-\W[T/k=%mE}hU(}Ybz2dP'`U|DLN sTuȪ 3⤕twWJ#2E }PlN`=Z9G'`j͒y*{]mU*&.CUuD:  X+s+O OƠ~!J ?BYh(kB i`:Nxuq[xDLN A׊_W-mSäGWf[j4ӟ9ܲtCH& 'O=ZUorMhBgOlusp\gvkiHet| u|UuzB՟_}1H~TL0vPܵ+Am L'h+Q(+!ح?8eh(csV%np4N5AՎ^Dj=mirO@k2ǔNJbAYճ7np}Za9k׀:}=JӒפl!K|2Yn EN$b߷]ztu@i6B7*iz}c&7˪^Θzuc4j|HØ"Hs&͌ }q3ӒץRi^)jp%'/k4ȍw탪{t1nkl0#x8cjk4N!v\cAP3*fod]-(SJmTpe)jp%[D.WS'j۠#Ɏkb&ob-# D -&f5 J=z v F@߬#'(Q D̝~f˻~}ǁWWW_/eFM;zngiJ˶cZ%G>񭃔6ۃں&Z+A5 v}kx22z {U8so_|kk7 3oߢ|}:(x6&K;m6(8uW̃!N@$~Uj]o̿/# Q!(8dyh[PJN$`_%֨ib"_O;Jcj7cbS?\OdS!sk&+OVb/QMO(V"#T#m[ c*tmTK'dS-ڦQ8Rc[N 6 lz{J%YsF{CBѵQ6/ٜB5+0UjH)N\ 룥n+ضWwK:w{U;B!Boﺛ{w8]J9:Է$%;u۸}V06W%@V6'Rۑ 2SIQMc]_9 #^es_fn lݧ?wʼn~ApX$v󵏴oXp叮yIdq|~e5 0Pϕ vepΞXn ;uq9T#f"AL|W=t G}kX42H(wtmTK"_zlN M~TMZUy~l0͌=MU;Bm!Bzn+`NchhiFQqD&'PL COZ-Tbb@boy*qJkyqSy/Bf'R[?d8c6N:p~lۈxisW# "AN@*B96/|ṟ}:t UB9x`/ PTn xFۼ$b߷]Hq[gkgq06?y0ƺ Þ9KbM^]"E^j/˪=* z v#%89t.RTmo-:=٧lb|2bDU;ʀ)jK" OK_%֨i& a n3|Ƒ|=hs۶5+4ƯY5 Kf8qyԫ#lcPfXU#¥ 88QՎ:,B2A%ns-_un5y%r㰼zEʛ_qQXklV]XzG][uk& =n4?˓'POEP6^/ &{tf˻~}ǁWWW_/eFM!objy%JH<&{L ɹ3J@ov2'w=ӟw}+:ѮVQIN k9 S pI,//?\@so_|kk7 3oߢU2ʆCjM:Y&N`:EiJ'*R8DN쭧hܒxzD7U-L[glp\b5@S'= {@ ԩSugGxRm R&3y[7wM[] dRSO4n̪a}NF_\4vb]3zh}>Q4R9/e䱃⮿= Ssٺ bJUuS_b:}@8>>A2B'a6nH 4IU^p|Up:h}J1_ 2 'cǎԝ h 8&YOjq/?W¬'#i TpY0РZՏ'FWOX ɂ<ɜ-G;H6{q)@& ؼyd2;#P?8jes={u>yA_'GRM)`*Z80??_w.~p^{`xC_+Nx>w+J%YrpU#@>Ο?qFK՝ܹsϞ=uAzC,pзQKO @:r V@XvO=ywQ`N4'_m`ČPE ڑ#G@6Ο?2f;>J= pBE '0 th!29͏6"P1*Z8xڅR p n8(z"ePp0Lhr ͇_))uB Ν;[w.8M4B=N.\pرs1sM'PO( \upm۶seiikN 'P,v:|ݹq ]YY;#\juM3yxȰ2yv YS6B 'y2 aw<}4i0<_AN'n&fGFMNp.\yf: @X\\<{lݹQ'1 Ύ@MN MP;dƍRH$x}uEMCm 4"wpa4LdgaMEM#~o#mGo1[Y]zS->2 'U.^xܹs- x˗(KQӄT@>mOg vWm'ܗ"u5.7OCy7qV%&*jpqiB],--՝h wwj[Mcj-Vׂu%t=.OnPdڹ[h[Y󦝅(Z`5H8ئMBmFGaHI*'pf˻~}ǁWWW_/eFK49NN)w(azVYh'Z'@0(©SAz9/>ٵoFzYE9\' 47o\'`: G8:fmmmyy\@_Pw.eso/AX#>'eC J&Ri`p20n 'lq'$P(smذZ]v߿\@H V:~V6W:c q=vr% [-]B-c 'PɄbZ3۳g +1fO 'PT @3 V9jppM6M&3Dl@~y C*P  at'Oם h+8z*@ІN 'P1{eh(ϋUݹv@ T͛رc`FpT8VØT0;8z*@-;w0#gϞ;wxFs|_2[Ǔa0=pV C ŋm۶TwF?~Æ +++ug@N qy ,3\w.#u/?WL+3jNU8<jDsG0dFAP,Տ'FWOX D Cmy84pJC5.74 ch{pvߡ,h'+@;ԝ hdƍkkkugC;ɳ:!>j2=,t[)zopN k}~[3 *v BprEzC&N:%@ݹN^{`xC_x>wP,\8/VZ# CI[t3ƨ: 'DGq/ ;G Uo[_8z[łM3 ~^\6큩Se@p!O 4 TOQD?QDł9MAid/Fi G&";/P'+@sX[[۸q#k.z Cy]'hǎ;ydݹfm6@yEc! '|P*;jUO0BhΝ;i N{blwZh ;v;P?{a jB=NP sK Sd2Y\\;Pԝ 8z*@c T\xq˖-"@ 4l@?NԩSuzDG7pt {Adosr?}?@'>hF%ܙ~ϻCh8щN4{>c;ȸoPWlNf+s>:+@K'l;ǎpBݹ(sa:+@K;wUw. ?l۶9" t HÃR!P:Z )Nn5Ν;|ݹ'*@L&+++u!,ٳg@N 'j6oL vsN&F@ Fm¶߿'PO6itf@ tsmܸ ŋ7o^^^;#Qju^ag"+Si:hΟ2Lfx(s`)|ʤEP] tSNQ-p&޽{ʝ@t*߭á:tjY}a¤Lilʠ̔ ڄ4> n<=Ȯ Mo5'P (@gp,--՝r9&& So)k%haFv#Rki7Ts@V^px|ёsN`kjwQ)zwcY=iځ3Zԓ̌1(W.w #  \8Kcǎ1dMe9r;t/\i&*druo)oϟIe v7=7Ǘ.j|se:233c@|_q<.hjp|`ugp饗^r%xh8z*@l@ɈYݿth+8zN|x r@P[Qy Sޭ<ܴ x3aE u3tġPku7ibwviS.hsBg.{p'ּ[Qr<'`_# #CRNgښ+jWg! HqEOS@xsT@SޭyiSLq=:A@S'ДwkI*-)We;"琛 Nmz'Ou2d[sahmNH,Nǁ2S/?&"\sV:"+Gs 3-JƮ{6^C7@iR^p;'+琛N>kΛ|ݔ` {:ЇSNg#x|zz;0WK b[E["ZHf>?S.3sz'+t||h3v:۬t]_ fr iz-x=r+ƭA%}BY5 E|=GBR.QAAUpb/TC7@ wi}Lm\XaH)9PtIJ#msM*'=rG/KnyݏRq徍#Gĭ+v)pcP@R/ѬN?wbD9gpHo h^[X omk\RL|BX?sFl<ܤruo)oϟ K͖X'`yL2:T@*NYi:w㕤Nělmoҍ%^4kSee*'`܉֬hݶҶ*琛d'7|CHoV}j@ &#?L[IuݺrKN yOS?['27@ ^'`䗫i佥ldI0z4NNp(CDߢAmpC*p|܏wA!qݎFs q@ /pȖoL e:4xsT@kͨ׆4!VrWO@y %sɺʲZ.3 Pcśn;HgvPpږFZq-UoMTk+;@N Z^Vs%E1'wk8&:^dmil;7,fI(@b*OPP]F9?N!7@nE9'POśx r ׼CH,8[ 27@Pyp Běp<| Běp<ܴuPSU0y:w*N[$琛 Nmz'O9?uXpVfxYFV ҝJP߉!)O[R1i?Aܭ]hN Yr}9@4L4n +Ams\sőgb.ԙ0w"dEP9N;;O~:+p~Qq?OsW{?'>M">N`Fkqr;GiӅqŽn?S豗O?y]|߱]Zh?xNȓ+}xC~FESJ7=GJ= P,rj[qQ.p`(lvh4篷ԦԶsQapL2s u&A\43cy^8OZ *_^|O\{|ֿ;>c'@z6@y O"svt>d+O}g+L|[_~e-wlMu~/zp6f D;Q+iN@ޤy ([1,ۃCtdn[~K/#q7_g^#=L{a+Cu<\r1<j5VZ B3mtMo Uk|XkTp&vѰbl-mͻYr@P}xʇN|bǽ󅏈׏o*r@P[Qy Sޭ<xsTVTxCnpT9*w+@xw޼RzPomW[fJ%\W 'p@8tn1{,8~@Rw[o6!琛NMΧ.ԛnyܐؐfzQ~ ʶR/:~x'C0=UjxsTN N4<ܤro#~[G/IRPSD>)6ԏn-pgPtAlid;NߕiY[LQ`,ň:cpz0ΚhdXJolw:sM*'[7>hk@ iLYLy N7@ *䕮z+[[n z}Yx86J)6P ~z’ǖ9& _g#+d~j 4átJz]*O OL9*}N<~mOxC^VK:uNUdF /rgamȞ"|R_H L3Ck[VCfllVƸV@,{#i >8!?U]?V[t|>|ݥ~㙎R/9c,v,M6 YK2"Bux!bƲb-Qw-ߖ΃5Y=Fऴ Um58iOnEj#T,:ˁ[C ,@sxWY:}Npqc<X<6 m AjP? oJo,?Cr.T~"']::;ejsO-ftG/@sxt擿+=qE18D(?\p3O`\ M+sfsX3)@ BG>j8̺+-{v8w 9D |^7;z+즍>7^58"LGNyb; tƧ*TRE3:١w 9D |~pҷ/GܵO@^ۘ( n*?y`<n5: >"ĝ`ph{4;oOZRݴH=_S'بYC}s'P/儿VējP}G76O@<;wZTq8ʴ.[s+ds X[K3a2A3I@yf' TÅZojkI͸v}ve09;":os@f7Ӑ8]C4qSR> ," w rȁ*8HX[29e^.F%?%f92B8owQl߫vpGUy[ q60NoWԿf͒.^\!drD TlSy'u%[|{:0NSpr>pe2BYv:"N߮ N*вO\' g9jJ#fi29Ʀ'Тض}N(>8'p{JE~ fwhtyl3t1W7+tww-m' .&' U8?L0ۥyt1rRޘǧ"w࡫(9?L0]G޺f4V'&ϑ]NņϺB9]C41:(ݭ~ԁe<)&;tuM4kvz %w 9DhW.N?X8084=hfp׭|w::Hȏvsrl:T9ʰ_pwz^F1H]^ew 9D zV(_84L'8vJ d=gV73;"<084=h:Go>ѣ7|~Q:pbVgڲbSd}>X؜w 9D |^7;z+& =~['` 8CX (k{3;",084=hZ9oTcC 8nA\x2:3L>tĝ`ph{4;oOZRo0@ZNxQ> t@'Z9`|2 INO ҔJs X,ɭyM>B;w BfGG9`1@H/0Ly`Ey1};OC4qQ) 0qo=N@`>kBɌ6Y'20BK(?%3}Wώ3kp=Eq0g>Pz?'ԃ*N^y_K6h5tGMcrwZ#0g,ЖC&qF'+Wn_ _-Z-egjKt?r~}3+g:z$8.H윾=0C=bBs @]:GJ}ƴ"Nl {?r횣?Gm5ԧ<:Q i! tBŝ`Z c hd>0e'n.1b:uسyqWb}nچG-TN@.]H58Ns @9bOR>'P*w}En:N}cN OzN+Oӡh){p(qKC֝N@/(ͣ~QMN@'A tR <Ir'i gAN9Xb )>6g![X5Tl@^1sN@_;hX @*:;dG=*`p M 88NiX @*p'Aekhh:?'P8 @8 @8 r b>^+ @,4T @44T @44T~{%Z  @*;_U/=D $DCHŬN@;K( @44Ttrrk^bǬdAh\R8Nx}2ZYY<;V%Uʷc\F8鵇~ ő;c}r?4\ Vq* t }m =gN}fyT8r^P @* t,p M  " 'tR@'tR@'tR@'tR@'tRq N fP/JpW$Q**DCH@N@:KE\ 4=Tct*DCHE \[O?S,ry@ 4. Ws׼8xo> 66۞=Vm fVp}[/>7ee0Qkz>r.E}'tRsyzԾz6e4*=kmuO>Ċڿp!L7l<*] .rp M >';_쨷j1tFZmˆv`d ȩfp*|zzv8Xh:9G8틗WU}Gw6N@ XcAv5 -'`>P 4UqԾOۥ0ʡO@*|N`Wlkkԋ/n}R&WOeQ('~)'M >'gٸ~w ٧a@qm`Lmd?bb_0]?\h–oΗ`"^tQBާ^;hmd<ödaʊ8|HVxtc\}cTQb^hh:;Y4/S#ԜOuNG,r n @44TtNX*'R C p M B+DCHN DCHN DCHN DCHN DCH18'V +#za^*<ӓ ɤTNb '$m)YA_đNsW0};WtRv?OuA `'Мg'Ep>WGKɌhh:8goxoyMPo=!tfNcPm̏6(y5?Z xV T]^ڸ̕U3)c#ꟹx;UuAN+h5U/.6N.}ܭ|v}Vm4wBi88M6\ƾc9WZ@YE+G?!;/tGhefqvXJ0]{^=uh~I #/2K%pB}>'@H '+g~{o{[F;dox?Ti!"n`at7'; x')?;nzJQ{h@hAٱ@Y{ms}\oN@/(whB(sچ N@Y;CHE (p*ꅼO̚6@bc"ǽdӅͧڸvsxlANݪa )&6g![ X5ڡo.U4c{<$ح! @44T,+q9Bj'tR WSs /:|8}ek|:[ _7NAyhh: hh: hh:8uҒ}qtXTp'I'p'&-4IENDB`java-design-patterns-1.16.0/tls/etc/tls.ucls000066400000000000000000000114561312550536300207060ustar00rootroot00000000000000 java-design-patterns-1.16.0/tls/etc/tls.urm.puml000066400000000000000000000011071312550536300215070ustar00rootroot00000000000000@startuml package com.iluwatar.tls { class App { + App() + main(args : String[]) {static} - printAndCountDates(res : Result) : int {static} - printAndCountExceptions(res : Result) : int {static} } class DateFormatCallable { - dateValue : String - df : ThreadLocal + DateFormatCallable(inDateFormat : String, inDateValue : String) + call() : Result } class Result { - dateList : List - exceptionList : List + Result() + getDateList() : List + getExceptionList() : List } } @endumljava-design-patterns-1.16.0/tls/pom.xml000066400000000000000000000034751312550536300177600ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 tls junit junit test java-design-patterns-1.16.0/tls/src/000077500000000000000000000000001312550536300172215ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/main/000077500000000000000000000000001312550536300201455ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/main/java/000077500000000000000000000000001312550536300210665ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/main/java/com/000077500000000000000000000000001312550536300216445ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300234745ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/main/java/com/iluwatar/tls/000077500000000000000000000000001312550536300242765ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/main/java/com/iluwatar/tls/App.java000066400000000000000000000133051312550536300256630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Thomas Bauer * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tls; import java.util.Calendar; import java.util.Date; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; /** * ThreadLocal pattern *

    * This App shows how to create an isolated space per each thread. In this * example the usage of SimpleDateFormat is made to be thread-safe. This is an * example of the ThreadLocal pattern. *

    * By applying the ThreadLocal pattern you can keep track of application * instances or locale settings throughout the handling of a request. The * ThreadLocal class works like a static variable, with the exception that it is * only bound to the current thread! This allows us to use static variables in a * thread-safe way. *

    * In Java, thread-local variables are implemented by the ThreadLocal class * object. ThreadLocal holds a variable of type T, which is accessible via get/set * methods. *

    * SimpleDateFormat is one of the basic Java classes and is not thread-safe. If * you do not isolate the instance of SimpleDateFormat per each thread then * problems arise. *

    * App converts the String date value 15/12/2015 to the Date format using the * Java class SimpleDateFormat. It does this 20 times using 4 threads, each doing * it 5 times. With the usage of as ThreadLocal in DateFormatCallable everything * runs well. But if you comment out the ThreadLocal variant (marked with "//TLTL") * and comment in the non ThreadLocal variant (marked with "//NTLNTL") you can * see what will happen without the ThreadLocal. Most likely you will get incorrect * date values and / or exceptions. *

    * This example clearly show what will happen when using non thread-safe classes * in a thread. In real life this may happen one in of 1.000 or 10.000 conversions * and those are really hard to find errors. * * @author Thomas Bauer, 2017 */ public class App { /** * Program entry point * * @param args * command line args */ public static void main(String[] args) { int counterDateValues = 0; int counterExceptions = 0; // Create a callable DateFormatCallable callableDf = new DateFormatCallable("dd/MM/yyyy", "15/12/2015"); // start 4 threads, each using the same Callable instance ExecutorService executor = Executors.newCachedThreadPool(); Future futureResult1 = executor.submit(callableDf); Future futureResult2 = executor.submit(callableDf); Future futureResult3 = executor.submit(callableDf); Future futureResult4 = executor.submit(callableDf); try { Result[] result = new Result[4]; result[0] = futureResult1.get(); result[1] = futureResult2.get(); result[2] = futureResult3.get(); result[3] = futureResult4.get(); // Print results of thread executions (converted dates and raised exceptions) // and count them for (int i = 0; i < result.length; i++) { counterDateValues = counterDateValues + printAndCountDates(result[i]); counterExceptions = counterExceptions + printAndCountExceptions(result[i]); } // a correct run should deliver 20 times 15.12.2015 // and a correct run shouldn't deliver any exception System.out.println("The List dateList contains " + counterDateValues + " date values"); System.out.println("The List exceptionList contains " + counterExceptions + " exceptions"); } catch (Exception e) { System.out.println("Abnormal end of program. Program throws exception: " + e); } executor.shutdown(); } /** * Print result (date values) of a thread execution and count dates * * @param res contains results of a thread execution */ private static int printAndCountDates(Result res) { // a correct run should deliver 5 times 15.12.2015 per each thread int counter = 0; for (Date dt : res.getDateList()) { counter++; Calendar cal = Calendar.getInstance(); cal.setTime(dt); // Formatted output of the date value: DD.MM.YYYY System.out.println( cal.get(Calendar.DAY_OF_MONTH) + "." + cal.get(Calendar.MONTH) + "." + +cal.get(Calendar.YEAR)); } return counter; } /** * Print result (exceptions) of a thread execution and count exceptions * * @param res contains results of a thread execution * @return number of dates */ private static int printAndCountExceptions(Result res) { // a correct run shouldn't deliver any exception int counter = 0; for (String ex : res.getExceptionList()) { counter++; System.out.println(ex); } return counter; } } java-design-patterns-1.16.0/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java000066400000000000000000000076601312550536300306200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Thomas Bauer * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tls; import java.text.DateFormat; import java.text.SimpleDateFormat; import java.util.concurrent.Callable; /** * DateFormatCallable converts string dates to a date format using * SimpleDateFormat. The date format and the date value will be passed to the * Callable by the constructor. The constructor creates a instance of * SimpleDateFormat and stores it in a ThreadLocal class variable. For the * complete description of the example see {@link App} * * You can comment out the code marked with //TLTL and comment in the * code marked //NTLNTL. Then you can see what will happen if you do not * use the ThreadLocal. For details see the description of {@link App} * * @author Thomas Bauer, 2017 */ public class DateFormatCallable implements Callable { // class variables (members) private ThreadLocal df; //TLTL // private DateFormat df; //NTLNTL private String dateValue; // for dateValue Thread Local not needed /** * The date format and the date value are passed to the constructor * * @param inDateFormat * string date format string, e.g. "dd/MM/yyyy" * @param inDateValue * string date value, e.g. "21/06/2016" */ public DateFormatCallable(String inDateFormat, String inDateValue) { final String idf = inDateFormat; //TLTL this.df = new ThreadLocal() { //TLTL @Override //TLTL protected DateFormat initialValue() { //TLTL return new SimpleDateFormat(idf); //TLTL } //TLTL }; //TLTL // this.df = new SimpleDateFormat(inDateFormat); //NTLNTL this.dateValue = inDateValue; } /** * @see java.util.concurrent.Callable#call() */ @Override public Result call() { System.out.println(Thread.currentThread() + " started executing..."); Result result = new Result(); // Convert date value to date 5 times for (int i = 1; i <= 5; i++) { try { // this is the statement where it is important to have the // instance of SimpleDateFormat locally // Create the date value and store it in dateList result.getDateList().add(this.df.get().parse(this.dateValue)); //TLTL // result.getDateList().add(this.df.parse(this.dateValue)); //NTLNTL } catch (Exception e) { // write the Exception to a list and continue work result.getExceptionList().add(e.getClass() + ": " + e.getMessage()); } } System.out.println(Thread.currentThread() + " finished processing part of the thread"); return result; } } java-design-patterns-1.16.0/tls/src/main/java/com/iluwatar/tls/Result.java000066400000000000000000000041351312550536300264220ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ /* * Fiducia IT AG, All rights reserved. Use is subject to license terms. */ package com.iluwatar.tls; import java.util.ArrayList; import java.util.Date; import java.util.List; /** * Result object that will be returned by the Callable {@link DateFormatCallable} * used in {@link App} * * @author Thomas Bauer, 2017 */ public class Result { // A list to collect the date values created in one thread private List dateList = new ArrayList(); // A list to collect Exceptions thrown in one threads (should be none in // this example) private List exceptionList = new ArrayList(); /** * * @return List of date values collected within an thread execution */ public List getDateList() { return dateList; } /** * * @return List of exceptions thrown within an thread execution */ public List getExceptionList() { return exceptionList; } } java-design-patterns-1.16.0/tls/src/test/000077500000000000000000000000001312550536300202005ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/000077500000000000000000000000001312550536300211215ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/com/000077500000000000000000000000001312550536300216775ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300235275ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/com/iluwatar/tls/000077500000000000000000000000001312550536300243315ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/com/iluwatar/tls/AppTest.java000066400000000000000000000026231312550536300265570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Thomas Bauer * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tls; import org.junit.Test; /** * Tests that thread local storage example runs without errors. * * @author Thomas Bauer, January 2017 * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java000066400000000000000000000117451312550536300315120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2016 Thomas Bauer * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tls; import java.util.ArrayList; import java.util.Arrays; import java.util.Calendar; import java.util.Date; import java.util.List; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; import org.junit.BeforeClass; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.fail; /** * * Test of the Callable * * In this test {@link DateFormatCallable} is tested with only one thread (i.e. without concurrency situation) *

    * After a successful run 5 date values should be in the result object. All dates should have * the same value (15.11.2015). To avoid problems with time zone not the date instances themselves * are compared by the test. For the test the dates are converted into string format DD.MM.YYY *

    * Additionally the number of list entries are tested for both the list with the date values * and the list with the exceptions * * @author Thomas Bauer, January 2017 * */ public class DateFormatCallableTest { // Class variables used in setup() have to be static because setup() has to be static /** * Result object given back by DateFormatCallable * -- Array with converted date values * -- Array with thrown exceptions */ static Result result; /** * The date values created by the run of of DateFormatRunnalbe. List will be filled in the setup() method */ static List createdDateValues = new ArrayList(); /** * Expected number of date values in the date value list created by the run of DateFormatRunnalbe */ int expectedCounterDateValues = 5; /** * Expected number of exceptions in the exception list created by the run of DateFormatRunnalbe. */ int expectedCounterExceptions = 0; /** * Expected content of the list containing the date values created by the run of DateFormatRunnalbe */ List expectedDateValues = Arrays.asList("15.11.2015", "15.11.2015", "15.11.2015", "15.11.2015", "15.11.2015"); /** * Run Callable and prepare results for usage in the test methods */ @BeforeClass public static void setup() { // Create a callable DateFormatCallable callableDf = new DateFormatCallable("dd/MM/yyyy", "15/12/2015"); // start thread using the Callable instance ExecutorService executor = Executors.newCachedThreadPool(); Future futureResult = executor.submit(callableDf); try { result = futureResult.get(); createdDateValues = convertDatesToString(result); } catch (Exception e) { fail("Setup failed: " + e); } executor.shutdown(); } private static List convertDatesToString(Result res) { // Format date value as DD.MM.YYYY if (res == null || res.getDateList() == null || res.getDateList().size() == 0) { return null; } List returnList = new ArrayList(); for (Date dt : res.getDateList()) { Calendar cal = Calendar.getInstance(); cal.setTime(dt); returnList.add(cal.get(Calendar.DAY_OF_MONTH) + "." + cal.get(Calendar.MONTH) + "." + cal.get(Calendar.YEAR)); } return returnList; } /** * Test date values after the run of DateFormatRunnalbe. A correct run should deliver 5 times 15.12.2015 */ @Test public void testDateValues() { assertEquals(expectedDateValues, createdDateValues); } /** * Test number of dates in the list after the run of DateFormatRunnalbe. A correct run should deliver 5 date values */ @Test public void testCounterDateValues() { assertEquals(expectedCounterDateValues, result.getDateList().size()); } /** * Test number of Exceptions in the list after the run of DateFormatRunnalbe. A correct run should deliver * no exceptions */ @Test public void testCounterExceptions() { assertEquals(expectedCounterExceptions, result.getExceptionList().size()); } } DateFormatCallableTestIncorrectDateFormat.java000066400000000000000000000107261312550536300352510ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/com/iluwatar/tls/** * The MIT License * Copyright (c) 2016 Thomas Bauer * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tls; import java.util.ArrayList; import java.util.Arrays; import java.util.List; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; import org.junit.BeforeClass; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.fail; /** * * Test of the Callable * * In this test {@link DateFormatCallable} is tested with only one thread (i.e. without concurrency situation) *

    * An incorrect formatted date is passed to the Callable * After a successful run 0 date values and 5 exceptions should be in the result object. * * @author Thomas Bauer, January 2017 * */ public class DateFormatCallableTestIncorrectDateFormat { // Class variables used in setup() have to be static because setup() has to be static /** * Result object given back by DateFormatCallable * -- Array with converted date values * -- Array with thrown exceptions */ static Result result; /** * The date values created by the run of DateFormatRunnalbe. List will be filled in the setup() method */ static List createdExceptions = new ArrayList(); /** * Expected number of date values in the date value list created by the run of DateFormatRunnalbe */ int expectedCounterDateValues = 0; /** * Expected number of exceptions in the exception list created by the run of DateFormatRunnalbe. */ int expectedCounterExceptions = 5; /** * Expected content of the list containing the exceptions created by the run of DateFormatRunnalbe */ List expectedExceptions = Arrays.asList("class java.text.ParseException: Unparseable date: \"15.12.2015\"", "class java.text.ParseException: Unparseable date: \"15.12.2015\"", "class java.text.ParseException: Unparseable date: \"15.12.2015\"", "class java.text.ParseException: Unparseable date: \"15.12.2015\"", "class java.text.ParseException: Unparseable date: \"15.12.2015\""); /** * Run Callable and prepare results for usage in the test methods */ @BeforeClass public static void setup() { // Create a callable. Pass a string date value not matching the format string DateFormatCallable callableDf = new DateFormatCallable("dd/MM/yyyy", "15.12.2015"); // start thread using the Callable instance ExecutorService executor = Executors.newCachedThreadPool(); Future futureResult = executor.submit(callableDf); try { result = futureResult.get(); } catch (Exception e) { fail("Setup failed: " + e); } executor.shutdown(); } /** * Test Exceptions after the run of DateFormatRunnalbe. A correct run should deliver 5 times the * same exception */ @Test public void testExecptions() { assertEquals(expectedExceptions, result.getExceptionList()); } /** * Test number of dates in the list after the run of DateFormatRunnalbe. A correct run should deliver no date values */ @Test public void testCounterDateValues() { assertEquals(expectedCounterDateValues, result.getDateList().size()); } /** * Test number of Exceptions in the list after the run of DateFormatRunnalbe. A correct run should * deliver 5 exceptions */ @Test public void testCounterExceptions() { assertEquals(expectedCounterExceptions, result.getExceptionList().size()); } } DateFormatCallableTestMultiThread.java000066400000000000000000000132411312550536300335670ustar00rootroot00000000000000java-design-patterns-1.16.0/tls/src/test/java/com/iluwatar/tls/** * The MIT License * Copyright (c) 2016 Thomas Bauer * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tls; import java.util.ArrayList; import java.util.Arrays; import java.util.Calendar; import java.util.Date; import java.util.List; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.Future; import org.junit.BeforeClass; import org.junit.Test; import static org.junit.Assert.assertEquals; import static org.junit.Assert.fail; /** * * Test of the Callable * * In this test {@link DateFormatCallable} is used by 4 threads in parallel *

    * After a successful run 5 date values should be in the result object of each thread. All dates * should have the same value (15.11.2015). To avoid problems with time zone not the date instances * themselves are compared by the test. For the test the dates are converted into string format DD.MM.YYY *

    * Additionally the number of list entries are tested for both the list with the date values * and the list with the exceptions * * @author Thomas Bauer, January 2017 * */ public class DateFormatCallableTestMultiThread { // Class variables used in setup() have to be static because setup() has to be static /** * Result object given back by DateFormatCallable, one for each thread * -- Array with converted date values * -- Array with thrown exceptions */ static Result[] result = new Result[4]; /** * The date values created by the run of of DateFormatRunnalbe. List will be filled in the setup() method */ @SuppressWarnings("serial") static class StringArrayList extends ArrayList { /* nothing needed here */ } static List[] createdDateValues = new StringArrayList[4]; /** * Expected number of date values in the date value list created by each thread */ int expectedCounterDateValues = 5; /** * Expected number of exceptions in the exception list created by each thread */ int expectedCounterExceptions = 0; /** * Expected content of the list containing the date values created by each thread */ List expectedDateValues = Arrays.asList("15.11.2015", "15.11.2015", "15.11.2015", "15.11.2015", "15.11.2015"); /** * Run Callable and prepare results for usage in the test methods */ @BeforeClass public static void setup() { // Create a callable DateFormatCallable callableDf = new DateFormatCallable("dd/MM/yyyy", "15/12/2015"); // start thread using the Callable instance ExecutorService executor = Executors.newCachedThreadPool(); Future futureResult1 = executor.submit(callableDf); Future futureResult2 = executor.submit(callableDf); Future futureResult3 = executor.submit(callableDf); Future futureResult4 = executor.submit(callableDf); try { result[0] = futureResult1.get(); result[1] = futureResult2.get(); result[2] = futureResult3.get(); result[3] = futureResult4.get(); for (int i = 0; i < result.length; i++) { createdDateValues[i] = convertDatesToString(result[i]); } } catch (Exception e) { fail("Setup failed: " + e); } executor.shutdown(); } private static List convertDatesToString(Result res) { // Format date value as DD.MM.YYYY if (res == null || res.getDateList() == null || res.getDateList().size() == 0) { return null; } List returnList = new StringArrayList(); for (Date dt : res.getDateList()) { Calendar cal = Calendar.getInstance(); cal.setTime(dt); returnList.add(cal.get(Calendar.DAY_OF_MONTH) + "." + cal.get(Calendar.MONTH) + "." + cal.get(Calendar.YEAR)); } return returnList; } /** * Test date values after the run of DateFormatRunnalbe. A correct run should deliver 5 times 15.12.2015 * by each thread */ @Test public void testDateValues() { for (int i = 0; i < createdDateValues.length; i++) { assertEquals(expectedDateValues, createdDateValues[i]); } } /** * Test number of dates in the list after the run of DateFormatRunnalbe. A correct run should * deliver 5 date values by each thread */ @Test public void testCounterDateValues() { for (int i = 0; i < result.length; i++) { assertEquals(expectedCounterDateValues, result[i].getDateList().size()); } } /** * Test number of Exceptions in the list after the run of DateFormatRunnalbe. A correct run should * deliver no exceptions */ @Test public void testCounterExceptions() { for (int i = 0; i < result.length; i++) { assertEquals(expectedCounterExceptions, result[i].getExceptionList().size()); } } } java-design-patterns-1.16.0/tolerant-reader/000077500000000000000000000000001312550536300207205ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/README.md000066400000000000000000000015501312550536300222000ustar00rootroot00000000000000--- layout: pattern title: Tolerant Reader folder: tolerant-reader permalink: /patterns/tolerant-reader/ pumlid: NSZ14SCm20NHLf829ExfXaYChGn26lZ4xSVdtFRjSrZJx9AkZnFOyI9olkenSEOxGxmjWnXgMvE6viLWfmz_kNI9SLZP38XRqEIuWx1Kd0t5XVjjGVj_DNtMdLD_ categories: Integration tags: - Java - Difficulty-Beginner --- ## Intent Tolerant Reader is an integration pattern that helps creating robust communication systems. The idea is to be as tolerant as possible when reading data from another service. This way, when the communication schema changes, the readers must not break. ![alt text](./etc/tolerant-reader.png "Tolerant Reader") ## Applicability Use the Tolerant Reader pattern when * the communication schema can evolve and change and yet the receiving side should not break ## Credits * [Martin Fowler - Tolerant Reader](http://martinfowler.com/bliki/TolerantReader.html) java-design-patterns-1.16.0/tolerant-reader/etc/000077500000000000000000000000001312550536300214735ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/etc/tolerant-reader.png000066400000000000000000000500421312550536300252720ustar00rootroot00000000000000PNG  IHDR7wOIDATx_%Ga毲GyE~qɌHbFĖ 5xq@ fc2fchgl|xQ& ]G?]3DH:ݧs>]?UTw1RF@ T Vpo6DF:/w T V k2H@K@`#Dƞ~Z*!*5P)QJFJ=dȴ0 liE}&*5P)G6/L BTRcO?-'*5iֆ^$Tp~>URcO?-!yF. !e7:EW yݣKM/"iث?yWmѢ [fm4]*rT{h G=z8wky^zMq{^^mqy󽺛F^Wm\(zw[ܖP\B[.dFDl% *5Q;Nwϙ߈(on>9?G?C~~qCb$JLuu(7ȑc v}1=X%o:*5Q[/qy[oG~8?q׭'߯MeI3aT[JmTY(Jy){$ZxsHRyL *1)Tj%$R;:vᔈҿ\wO-kOa-mUȷTXKH!_ʟrM*Uc[CwhT{h _8vw߷[7COo{/oѝ9;%:3VT!H ܛ1L *4ƞ~ZB"*?x_8_YFoۓgWs 2M^PzƖR?ف/XddC6` S) fRia%$R';㎯|hO>ǿғ83W:]=Qf 7G*Q͞LOaﲳ2To0Q\ny{|ޯ=p3XQ%ʨRU/WLtE,SjlKcO?-!)e]|C_:;RcO?-!5=%*5P)QJFJ=T 6BTj%RRcO?-{h l@K@`#Dƞ~ZB*5E }qk>=d[Cƞ~ZB*JJKTj%4RyyvEypgHT:6VFXNNcfכݦlG]LlUzrE1]C3n{gK>)4)ߙ=n*ƞ~ZB*% F!sӊwQKNKɺR-_WVIQ/e]_hW(~Sr(W1(uGTQ!|sxJR`%4R~~Ӭ-W w7T1k_9X=2rT]G 5-|<˟KEZcO?-+`MԢ.N*deWѐcDCFj5@ɬ=Tj}=xg{R-E,Zq_mKi5&3U~´C@Khx\,RtO6 SjǥWTH=.e~jcO?- ?J9+wezy+;j[>n1~9~ Șexc]Eט+DA?sPF0R)8vRcO?-{h l@K@`#Dƞ~Z*!*5P)Qo6X"#u;*@+ؠ-m#0JFJ=T 6BTj%h*5+/;AvKu揝'.(KpDƞ~ZRBKAuIt#LT~I,c;,9^lU@uIRE7Pnt+&^zue}k|& W%ys?d/ |ļkGF1J2ҫT g_kXYN% UņGP}egW6?1nNnʼnv$*5PRL*/?sWY=$ݟyfvM/_zS=ps1VuA՝hbC$[a)¦@c"߹]9#yRL wQq U ^q_Ts?\{W׭֕vIy/|cM2qɋݢ@A*uѣ"+D3E*%y:ЮLzUӢRZYZ/mg)UxVT,K@$6./Vin*/mkO&UQݯ|cP)[7,O\S/RJca1U)oZq;d@nr]Mcemkz֙=R}U*ݧw >{KjBYF΍'x]@2Se$wF65O066nHZAJĊfDŽq`*:d-=ɸTb uKu;O3_&^z*jv7ZH*؋_?s> ΫwJ%DgAoDm@yU">ƘxTyExULF%2i\=>8%yP)!E{O7_:?@}򳏾?w*T>jJMW*T***LR2ܸhunLUs~7?śqOO_SkKK{&/C0teZ#Gf~)ȳwJ) 3f)6ձ}/qލUʼ7W*Y9~wmlU5Mh]n}pWm;w<{֓{w]|qu\L4JIӍ,ay){$+[zTCg+5@-j%gTDpg<b~]./s_x7v_<>TثuG_/Vg&%Dz[]ʟZDɌ -c )KW=r!3~1,q^Tȴ&yRO}CoW~?9͛VGwdqi\-UR -Y. 2 UJ)!dEBnYTj6&qRrdyĘɟu?ߞ|?Wdqgl) SQ'd y֑jacJI%NJ6ޥR| "0ҋJFx>N~w>|_|ۏ'_qgxן%J7U[1$Ut2r*>nj4ewEK.-d.Zc-q T 6yD{BH-qϙ}W3D]qD;j{S4o>.ΞP,3}}{#\^T 6y':+/(J2қb#LT ٫wf5.ev@d<R-eCsFd=0N5.es*&#`*UZԺX@my=R W)-OHDt/Q}ڒ(wvTұ^ eVj } QV=ޯ'>]C3n{gK>)0˜qz^+PF[^mWWݬyR`"QCs]$ߏA*55B6/NJճdy`y~Sr(W1(uGTQ!|sx!G5Xx>TMQRiRb)k5LHYm^ꑑc]u”E䴸GL7:jLrT2|vL4TT^lOVԢEuE6⾪ۖj|Mf\󫔱RuKow]pPLT QNiBJ@`_xu=)(N UcfBYY/s7E`O CywxqN?G@}޶@ rl%Njuzu+.bj_-U~Y畖vL 14lDh۩2PȠ-KS]fUNJd7xݧOˋb(ot^܄}eիǏ߿Ç/]Tؖ2{M V;61і69 =rؘy>+)ϟL&7tܴTи}ôvԖrY3hZ P 2[R]}ejִZ@<5u\ʴ)|P?veUjt<{Bt:ű88q[;>wܡC|AѮhl&sEc[+z['s 1nըYs?-ct@#RWt\Qx q|ڵxwwW(ŋrBQN:5+E[;ﱩx>{mM&N N!*JRسgϊLEK. $*%NZ"@@-ձCT }e:Bn馼#~wL'wTjv;u7 c"')=w7 q|}&;**u;ϞpLs% {Q)Sbu#d0| T}F3+%m>+Y&kbbTxK/*a<* A.6RɩLQ&{۔[5lLR&# TS?7L=׶kտ)uiNd Ӄ`7JCP^,Qnq&R~=çāW kվ2L'Tf):VS/{7v)Wtg/LumltUa(w'//)r&Ec0mojs C|Ja[0/T3=W=/8}\+NjKa95nJ%dUt+y^< %d{c۝SIQx}`m&ib׭R=ѝr&淭@*Uezׅ+Qyޏ~sTW+WjCXTj`RZ*[+̧h9r2biL G\P x6JuJ9z]\6^WѨu]Xz>u>J=p~'^:Nw'͙oVfkڹJ-*\c{"϶#vZ9Vǰ+f $s_TTy_*@HV[krw`;|A'~wSw>~ q fUTf6*~ʹű_=fd:?,MKo`[$6pu%cau܋Jx>ЙgW櫘e7`|m)ꤤ^!by3級>Q[ h9k-|jU)WﲝԒ*n٢o L *5_W2|`iae$X|{v|okM֖ŠM&#b#hH͒/ Qt@`_x@-yRLvUpW/_|W!(.ؘxglXQ>OplLR&#`]*w K/*a<3;eVЬG&1`y3pro _뚙{xݷmw1VT+yJva>3i5nt FR(L:wbiKVcҖӠR C[M!yʹb~jϺ#| yO1za_x Xz1bF_d#]񓩇PE޾^T֍;W])^ty$:&9eVdԏb(޾^TSsϺ#|=5ϠWҟp}/lWIJWAy&^zQ)gUl]fOx&^zQ)cެ2Uܚ$ jwe?+{xE`#Ly*Tc#]o]ԥkb#CjGNU9ΞKY9PoK@z ߚejed!h3ldv^Z6U"/e<R]CM TW+մf6^^ -WYhݿ7ήX{w#;Jќ37tTFM T|YZZT,Y`L7jsp,IZUpCe<RpTL TY/-SW)ZwOʷ;\&#}eVvRSl" jWkKXRxy K@,KyfN JY;\&#^W&^z*piG6S⯎ږdVy`UFI$ly>W/+/uZerHLԼFzgN'G ޻ Z~/ڽm_Kw^X]GpjLR&#^~4{7h{umڕoH1ҋJFx>z͋6q!(NjVk ^$ #8-&^zQ)АWu#Z?r𢭿=}Y,*ej>z'K/*a<k Z~y !]ыAzKo*%罕M8W hȫ>AUnޠj5N{ug^NH*ey7łV*.-U?U󢵼.y =a]ZϬŭDyLaTͩh^[jѫRXQR2|Q)8B&^zmEVˋ~3bREe<P)W&^zm*WoqƸc=+^T*"J2(P-y nf,RRF׶2|U{Y@9ÒFl^72!4@oR?5 T^ҥK]"iUj6nM k+^{j*WvtJY@ 0/{ʠ-ƚmƭi 0/{8~8-*#&*55qܹoƍ]G$9RRcO?X׮]: ){A#mﾛ?l‰'PuJFJ=A0:%j{k"J|p$S{A=p׻HRm[VzVbMj(tES{A8qٳgEpT+^Qޑv;4Ցx RcO?h#oQ9T-^kƗŸo]!mW+{,æNlM3KG)J=%\xq]6jѫ׬R4]Kۮםy%=NG`k % G)J==:uj̻(TE^_}ә[ @6P6?qx RcO?h׮]?J뚃RSz]+f4_7BtЍS{A8~d2PT*WoR>kM*홫*ƞ~'NMfyzǥ|q)S[\ Ӹ7$R}Fƞ~ (DCfx]geB{BE2d:6o¨a2lnnvxp2lܫ7ٗ.Ǒx RcO?7n?XZ*ejt-S{A|;w(mƽz}0*5-drѮ#:&*5BotցJFJ=+\z]ǢERRcO? ׯ_?pӧH[@`#Dƞ~!P xO T 6BTjŋ'N:#Jͷ~-k5ۧ ̷]f KTj#TJb%D[G$YoPnN6,{A d[ͫ_k;.Tj$V^RcO?HCZPzeBW՜P gfo[]z6 Cu;#xVcO?HW^MZj!"pl;\zkʪ0[yA9D۷w]k:MDZw V^RcO?nױXQ{AX{Apҥō{Ap쟴o6X"#u;*s8p-g J۷o0.]mZ*zWv.>|}:t눀JDz|7ntM|T Ν;p@ױٳG88tJ~ѩn7 )ќ:: ]RvڡC7޸7NHN8qѮcBqqysmnnv2P)0(ؿlq)}#P)0L8.]4Lj'E[ST 'Nxbױ.>|  Ds4Q./p JB& B eR:X8@0qq~'rN#P)0dAmN2=J_:-)ӁhHyMu4AZ@(41ztY 7nܘL&t%%T xAK.u P* AhӧJ/"`D~?uD,!TM,ƈ],ƈ^EH U @d0j={};* QCn7x눌, ,w}7* 0իW:{|<T xA@Amhc1a=R D馛nŗUR  vww]/_{@d(._i\ T xA wu T xA`SN }UJ8pӨ ,W^=~hB>|@qtzM7P)Y:Ο??L2??۷Ξ=uT xAi瓟Эc4@R ~} j@@ l2_nHlT *! '*bJAÉJ@ D@lRdȴ0 liEoD@lRg1=QxqgR*Q)T4|qfkC^s/*8 ?S"*bJsȅ!,fSJ!o{joWR/"i=V糙ex9~}&*b+sڦ 3 Ic ܸH?[R 6P)a8Q)0 T BNT *! '*bJAÉJ@ D@lR?g|>q,t+"*b^cǷ>q^NQAB-Ksվ!oc,JE))UJ@"PHo<ޓ/>׿N?/>ݮ ABY/d։J@k__8O^}w[ۢE%uZ=ZU?K.1ŦM>.Q)TȳG.-_zMq{^MKav\khSn-\R\ѦR%%=eLj u[TuR 6Py9ss?ion>9?G?C~~qOq-;uR**\JE@X`q=`J#U~߮KHD@lRm>p w~uޖÿ'(n=w=~Ou[ǥLj6a$wռ E)/ed![ I?T*RUXimأܾFT *6E;wNu)i}݂/v/{ORVD6J9;\Y KSR5]Fe7բjlKc[v9J}KN *bjO}Co|o޴卷>=g6?w')F=~J5*id{0f7T/ʭRFXֆ)^J$*Q)T|o<{//,?oOׇy@\u+4yA[J{d݃[[ _` # h1L$J|*Us=GT *';㎯|hO>ǿғ83WYEV& !csįR >4쉙PewEK4.剼9Eܔ'CZ6Q)T );9{< cqF+Ιr_mBp3s V8.U=AP։J@/}{#Q)0 T BNT *! '*bJAÉJ@ D@lRpR 6P)a8Q)T*o0Qnީˆ澿ٸ5ff,2ݍ T*9Rj Tj ݢ&UQ  Jte_GG!rȤ763ޞ[gDxLhKdJpTcX#'J[E&4XG *8*kD R0R 6Rwm]gd3./j uZ朖]wUr=/:/-D@l,RңadR 6Rg#f^#dv E,]Tp HdX۟p͝vW{ĝl8,R 63DmݡllJv nU5*5Q*hI:; {”Jpԟ^z?|;8'Zl*81(g[Fz! f--峂'*báR~=çāWz.ǭR#.)vI kRFԆ18/{=uKRDT+EO(ٚd=G6ȹqKdvbD@lT~cOI6cߢjꦲOL݊X|}k;+d|Ycqz?1ɖ sC3P#S" *WqTCTqxTMd Q)6ONcſr& ƕ~Wj7]Ww/Ʉaupg_4XףZիFy)JL0VKQ/-5TnK i)K J'>O_8fkHg5cEfQE<˕W~ q c+S V)y6.+#RrT!*J-icTZWܴRLgq)c) 1b\jPD@l8TJ3Ltq` YgZ1PT V7#m)aRH[6ϖ~V"zuܦmk=9l۔uyv(R)  J(jRc>zaJ5ji쨜)1bJ5S{ٍu-ftQ)0 T BNT 2*W/c'*b#\R 6U) 02Q)kS_ java-design-patterns-1.16.0/tolerant-reader/etc/tolerant-reader.urm.puml000066400000000000000000000023141312550536300262640ustar00rootroot00000000000000@startuml package com.iluwatar.tolerantreader { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class RainbowFish { - age : int - lengthMeters : int - name : String - serialVersionUID : long {static} - weightTons : int + RainbowFish(name : String, age : int, lengthMeters : int, weightTons : int) + getAge() : int + getLengthMeters() : int + getName() : String + getWeightTons() : int } class RainbowFishSerializer { - RainbowFishSerializer() + readV1(filename : String) : RainbowFish {static} + writeV1(rainbowFish : RainbowFish, filename : String) {static} + writeV2(rainbowFish : RainbowFishV2, filename : String) {static} } class RainbowFishV2 { - angry : boolean - hungry : boolean - serialVersionUID : long {static} - sleeping : boolean + RainbowFishV2(name : String, age : int, lengthMeters : int, weightTons : int) + RainbowFishV2(name : String, age : int, lengthMeters : int, weightTons : int, sleeping : boolean, hungry : boolean, angry : boolean) + getAngry() : boolean + getHungry() : boolean + getSleeping() : boolean } } RainbowFishV2 --|> RainbowFish @endumljava-design-patterns-1.16.0/tolerant-reader/pom.xml000066400000000000000000000033701312550536300222400ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 tolerant-reader junit junit test java-design-patterns-1.16.0/tolerant-reader/src/000077500000000000000000000000001312550536300215075ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/000077500000000000000000000000001312550536300224335ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/000077500000000000000000000000001312550536300233545ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/000077500000000000000000000000001312550536300241325ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300257625ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/000077500000000000000000000000001312550536300307755ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java000066400000000000000000000073331312550536300323660ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import java.io.IOException; /** * * Tolerant Reader is an integration pattern that helps creating robust communication systems. The * idea is to be as tolerant as possible when reading data from another service. This way, when the * communication schema changes, the readers must not break. *

    * In this example we use Java serialization to write representations of {@link RainbowFish} objects * to file. {@link RainbowFish} is the initial version which we can easily read and write using * {@link RainbowFishSerializer} methods. {@link RainbowFish} then evolves to {@link RainbowFishV2} * and we again write it to file with a method designed to do just that. However, the reader client * does not know about the new format and still reads with the method designed for V1 schema. * Fortunately the reading method has been designed with the Tolerant Reader pattern and does not * break even though {@link RainbowFishV2} has new fields that are serialized. * */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * Program entry point */ public static void main(String[] args) throws IOException, ClassNotFoundException { // Write V1 RainbowFish fishV1 = new RainbowFish("Zed", 10, 11, 12); LOGGER.info("fishV1 name={} age={} length={} weight={}", fishV1.getName(), fishV1.getAge(), fishV1.getLengthMeters(), fishV1.getWeightTons()); RainbowFishSerializer.writeV1(fishV1, "fish1.out"); // Read V1 RainbowFish deserializedFishV1 = RainbowFishSerializer.readV1("fish1.out"); LOGGER.info("deserializedFishV1 name={} age={} length={} weight={}", deserializedFishV1.getName(), deserializedFishV1.getAge(), deserializedFishV1.getLengthMeters(), deserializedFishV1.getWeightTons()); // Write V2 RainbowFishV2 fishV2 = new RainbowFishV2("Scar", 5, 12, 15, true, true, true); LOGGER.info( "fishV2 name={} age={} length={} weight={} sleeping={} hungry={} angry={}", fishV2.getName(), fishV2.getAge(), fishV2.getLengthMeters(), fishV2.getWeightTons(), fishV2.getHungry(), fishV2.getAngry(), fishV2.getSleeping()); RainbowFishSerializer.writeV2(fishV2, "fish2.out"); // Read V2 with V1 method RainbowFish deserializedFishV2 = RainbowFishSerializer.readV1("fish2.out"); LOGGER.info("deserializedFishV2 name={} age={} length={} weight={}", deserializedFishV2.getName(), deserializedFishV2.getAge(), deserializedFishV2.getLengthMeters(), deserializedFishV2.getWeightTons()); } } RainbowFish.java000066400000000000000000000035701312550536300340010ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import java.io.Serializable; /** * * RainbowFish is the initial schema * */ public class RainbowFish implements Serializable { private static final long serialVersionUID = 1L; private String name; private int age; private int lengthMeters; private int weightTons; /** * Constructor */ public RainbowFish(String name, int age, int lengthMeters, int weightTons) { this.name = name; this.age = age; this.lengthMeters = lengthMeters; this.weightTons = weightTons; } public String getName() { return name; } public int getAge() { return age; } public int getLengthMeters() { return lengthMeters; } public int getWeightTons() { return weightTons; } } RainbowFishSerializer.java000066400000000000000000000073441312550536300360360ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.IOException; import java.io.ObjectInputStream; import java.io.ObjectOutputStream; import java.util.HashMap; import java.util.Map; /** * * RainbowFishSerializer provides methods for reading and writing {@link RainbowFish} objects to * file. Tolerant Reader pattern is implemented here by serializing maps instead of * {@link RainbowFish} objects. This way the reader does not break even though new properties are * added to the schema. * */ public final class RainbowFishSerializer { private RainbowFishSerializer() { } /** * Write V1 RainbowFish to file */ public static void writeV1(RainbowFish rainbowFish, String filename) throws IOException { Map map = new HashMap<>(); map.put("name", rainbowFish.getName()); map.put("age", String.format("%d", rainbowFish.getAge())); map.put("lengthMeters", String.format("%d", rainbowFish.getLengthMeters())); map.put("weightTons", String.format("%d", rainbowFish.getWeightTons())); try (FileOutputStream fileOut = new FileOutputStream(filename); ObjectOutputStream objOut = new ObjectOutputStream(fileOut)) { objOut.writeObject(map); } } /** * Write V2 RainbowFish to file */ public static void writeV2(RainbowFishV2 rainbowFish, String filename) throws IOException { Map map = new HashMap<>(); map.put("name", rainbowFish.getName()); map.put("age", String.format("%d", rainbowFish.getAge())); map.put("lengthMeters", String.format("%d", rainbowFish.getLengthMeters())); map.put("weightTons", String.format("%d", rainbowFish.getWeightTons())); map.put("angry", Boolean.toString(rainbowFish.getAngry())); map.put("hungry", Boolean.toString(rainbowFish.getHungry())); map.put("sleeping", Boolean.toString(rainbowFish.getSleeping())); try (FileOutputStream fileOut = new FileOutputStream(filename); ObjectOutputStream objOut = new ObjectOutputStream(fileOut)) { objOut.writeObject(map); } } /** * Read V1 RainbowFish from file */ public static RainbowFish readV1(String filename) throws IOException, ClassNotFoundException { Map map = null; try (FileInputStream fileIn = new FileInputStream(filename); ObjectInputStream objIn = new ObjectInputStream(fileIn)) { map = (Map) objIn.readObject(); } return new RainbowFish(map.get("name"), Integer.parseInt(map.get("age")), Integer.parseInt(map.get("lengthMeters")), Integer.parseInt(map.get("weightTons"))); } } RainbowFishV2.java000066400000000000000000000037421312550536300342120ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; /** * * RainbowFishV2 is the evolved schema * */ public class RainbowFishV2 extends RainbowFish { private static final long serialVersionUID = 1L; private boolean sleeping; private boolean hungry; private boolean angry; public RainbowFishV2(String name, int age, int lengthMeters, int weightTons) { super(name, age, lengthMeters, weightTons); } /** * Constructor */ public RainbowFishV2(String name, int age, int lengthMeters, int weightTons, boolean sleeping, boolean hungry, boolean angry) { this(name, age, lengthMeters, weightTons); this.sleeping = sleeping; this.hungry = hungry; this.angry = angry; } public boolean getSleeping() { return sleeping; } public boolean getHungry() { return hungry; } public boolean getAngry() { return angry; } } java-design-patterns-1.16.0/tolerant-reader/src/test/000077500000000000000000000000001312550536300224665ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/000077500000000000000000000000001312550536300234075ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/000077500000000000000000000000001312550536300241655ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300260155ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/000077500000000000000000000000001312550536300310305ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java000066400000000000000000000031731312550536300332570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import org.junit.After; import org.junit.Before; import org.junit.Test; import java.io.File; import java.io.IOException; /** * * Application test * */ public class AppTest { @Test public void test() throws ClassNotFoundException, IOException { String[] args = {}; App.main(args); } @Before @After public void cleanup() { File file1 = new File("fish1.out"); file1.delete(); File file2 = new File("fish2.out"); file2.delete(); } } RainbowFishSerializerTest.java000066400000000000000000000061311312550536300367220ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import org.junit.Rule; import org.junit.Test; import org.junit.rules.TemporaryFolder; import java.io.File; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotSame; /** * Date: 12/30/15 - 18:39 PM * * @author Jeroen Meulemeester */ public class RainbowFishSerializerTest { /** * Create a temporary folder, used to generate files in during this test */ @Rule public final TemporaryFolder testFolder = new TemporaryFolder(); /** * Rainbow fish version 1 used during the tests */ private static final RainbowFish V1 = new RainbowFish("version1", 1, 2, 3); /** * Rainbow fish version 2 used during the tests */ private static final RainbowFishV2 V2 = new RainbowFishV2("version2", 4, 5, 6, true, false, true); /** * Verify if a fish, written as version 1 can be read back as version 1 */ @Test public void testWriteV1ReadV1() throws Exception { final File outputFile = this.testFolder.newFile(); RainbowFishSerializer.writeV1(V1, outputFile.getPath()); final RainbowFish fish = RainbowFishSerializer.readV1(outputFile.getPath()); assertNotSame(V1, fish); assertEquals(V1.getName(), fish.getName()); assertEquals(V1.getAge(), fish.getAge()); assertEquals(V1.getLengthMeters(), fish.getLengthMeters()); assertEquals(V1.getWeightTons(), fish.getWeightTons()); } /** * Verify if a fish, written as version 2 can be read back as version 1 */ @Test public void testWriteV2ReadV1() throws Exception { final File outputFile = this.testFolder.newFile(); RainbowFishSerializer.writeV2(V2, outputFile.getPath()); final RainbowFish fish = RainbowFishSerializer.readV1(outputFile.getPath()); assertNotSame(V2, fish); assertEquals(V2.getName(), fish.getName()); assertEquals(V2.getAge(), fish.getAge()); assertEquals(V2.getLengthMeters(), fish.getLengthMeters()); assertEquals(V2.getWeightTons(), fish.getWeightTons()); } }RainbowFishTest.java000066400000000000000000000032671312550536300346770ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/30/15 - 18:34 PM * * @author Jeroen Meulemeester */ public class RainbowFishTest { /** * Verify if the getters of a {@link RainbowFish} return the expected values */ @Test public void testValues() { final RainbowFish fish = new RainbowFish("name", 1, 2, 3); assertEquals("name", fish.getName()); assertEquals(1, fish.getAge()); assertEquals(2, fish.getLengthMeters()); assertEquals(3, fish.getWeightTons()); } }RainbowFishV2Test.java000066400000000000000000000035221312550536300351010ustar00rootroot00000000000000java-design-patterns-1.16.0/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.tolerantreader; import org.junit.Test; import static org.junit.Assert.assertEquals; /** * Date: 12/30/15 - 18:35 PM * * @author Jeroen Meulemeester */ public class RainbowFishV2Test { /** * Verify if the getters of a {@link RainbowFish} return the expected values */ @Test public void testValues() { final RainbowFishV2 fish = new RainbowFishV2("name", 1, 2, 3, false, true, false); assertEquals("name", fish.getName()); assertEquals(1, fish.getAge()); assertEquals(2, fish.getLengthMeters()); assertEquals(3, fish.getWeightTons()); assertEquals(false, fish.getSleeping()); assertEquals(true, fish.getHungry()); assertEquals(false, fish.getAngry()); } }java-design-patterns-1.16.0/twin/000077500000000000000000000000001312550536300166115ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/.gitignore000066400000000000000000000000111312550536300205710ustar00rootroot00000000000000/target/ java-design-patterns-1.16.0/twin/README.md000066400000000000000000000013741312550536300200750ustar00rootroot00000000000000--- layout: pattern title: Twin folder: twin permalink: /patterns/twin/ pumlid: 7SR13OCm30NGLUW0n7UsCS42eyH4zdUpFbNVwNtKQij3qjjo0ICs8kTPJiMLUuPuVGnYAFNff2qdWvrk_l9wIEXfws10t88wno-4gKQ2-az9xsLaRoy0 categories: Creational tags: - Java - Difficulty-Intermediate --- ## Intent Twin pattern is a design pattern which provides a standard solution to simulate multiple inheritance in java ![alt text](./etc/twin.png "Twin") ## Applicability Use the Twin idiom when * to simulate multiple inheritance in a language that does not support this feature. * to avoid certain problems of multiple inheritance such as name clashes. ## Credits * [Twin – A Design Pattern for Modeling Multiple Inheritance](http://www.ssw.uni-linz.ac.at/Research/Papers/Moe99/Paper.pdf) java-design-patterns-1.16.0/twin/etc/000077500000000000000000000000001312550536300173645ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/etc/twin.png000066400000000000000000000717621312550536300210700ustar00rootroot00000000000000PNG  IHDR:`sIDATx]XVр (" VVl#(b+bE {ATBN[5VTd7fsr{q{gvvfvvgogAO H A:ϟ@ N!qPҝBALT I ALT I AK|yDuf:*BC8/U`f橩ST\6ۇxt͚4~CRgAE:|r3gbG}x>{vwR<=ޝCϞ )d$u&TsZZ…#}|߼ Vcc'WRHڵlR-LFF<9\jy+'bV<i֭S9ɔ`2Ə.l-]Lo^K@&sTTlɓQyt:ARgAE:3^l$4E:o$Y3  ᇦĶi"A)S Ud=̷$c<稄f*N6FoHL }VgIL RgZHL RgZHL RgZHL RgZHL }UgĄxM yu>}TK6s?8IK+i$u&Tns%C1"k83SkǻwYf~|+47I  i3cɻ/H|1ƞZWڵQw 8Vhhoy5k&hI |)XBrJlZQzr\e3۷`iϷw<ճuz;wFxѢ8ܹzy@RgAE:/vOVqҼ39/[֦P!|!waٲlȑ5n\J"_Jtqqslgg]j/lԨmqք;6+YG73E\;wp qq(y8'3"tUwZsrj~1Y+#~{DHm[8NW ︢EMml E$>>Q(IgȨq/\ʼpa==K" [m*ep.-F77˗7ˢ4~I {vMWn'V!ްa*:qyyg+(s8_|eHL ]UgMf{FNfwןqq`Hço߾1Nyh_>)??soР:LZ۷8F1Ecf~?>kbo$3kw^&3'6;p[$J˒4~I ": J{ ?r5u /ߧ^iEN'8gPNŋ gD;ej#rieeÇ_E …_b,ڨQ 'E=v8 6 K'u&Χ/r۬~_{|?iY={O] B.yۻwK(T(==̙ߋL@-XܔdJ)qa"|yÉ޽Kq!z\㝽Ei+IRgAE:9Orw_нoI3/ݣ^İ˔˫k5sN ,^z5x, /n^@~h+ݡƒu\b n.&9"+V,@ ̦(y8 3"tX9@LvﴢUE/ˆ"͌оfH}x{E${ʔHPnDFE",ԙ@P>{.EEu?TĬ>,ԙ@P:'}Zpa]zzjppWO]LIYsܱF+W.77޽3u޹s6[͛$=~G\,[ÄnZwV#D$[ݺ)/^βkHT%|b"PTWD9kNuI 3*ۣB :3'qRUNeN>2-[ªU+@r~g6x \J9&L背QP4?w.vǎYd5Uɛò6ou j^V.ԙ@P:ΣGI{8]pUo 96Oŋb|u~63qذ,APyy5\]HeO,X8άڙUFuau޿_sukרQ~c{qu,-~t2bdV0{}y|,SgN͚8ѰauիD&hyPt^.nĂ̪ML 2tXޝ:yԚuqq`Gʕ+}Otvva M,ps疜-755q㚰 XZZ"ewO,X83@̘#l2"2?> ;7KǏw fgyu&j'I ALT I ALT I ALT I ALT I ʟ? Н4ح =D0j u& u& u& *lgZlgA5:BRgAE:BRgAEN9]&ԫ8g'4.D-$3"r-`v,YyV;NOO}xeȽ:K5~ٲѮժV-_b5*:X_MRrLñ\3rdc߿?'__#$u&ThGڨT _ϭX4 y\n:u*gIKKre3'qpሚ5+q 555fGacWTThÆՑ=Rg~fC0goҧ֫Wիk\^CeĎ2 NsnX_'qYSAA33OMXK8:8ر;fLOQSk&Msy޻e$: &S\Ѽ30ƵLHL hZ۰İL&"$ڰat̸qPUMٳ'ZD+W.˒j(,6m\r`B9uLw&:zƵLHn8B{^u}DȞ/6%YB|3›6MOKKc,;;,MўN߽K177pab5kV"sR_z0A0,~U52c>Rg5Cހ%M'^l'@})r۶pWj&&PvʱPdh:`AϜ6%[ ]lt"&NN..'Nb{yun۶aFWlMm͛NIY"?}:^ٛ7FG]RgJlG+#"MW+ӧ?>+ C%Uq2Yºի- oƇRY;_ ɾC@]œo֬֝;{vssa_dE ֪@;!Qwǣ<9} Q~8`??D\jvԩ*W.d֍-ƾNS:>0'wdU):ٗiwR<=ޝCϞ 25*gԙ~شą G8:4y3NA$:ˮm[8KgOd@`2C]¢Hٲ6A16*`XQz Ij ֭dIKkDYp^^MXʮ][Z5N0Ϥ ^KغuFӦ.O-EV©)ԛNHLT u}`h?`.Y23@A$O^ZxⰹWޥ+fAd0YlB|77 l.ŻdYpۻ-aJOƜ䥟`2djjˈRg>>9aBkbEBec8w82!#sĤ%PgJw߻{8q!*O]{XTvJÕ%2:zܺuS8ɰ*Xӧk-nZ_?L &c=’-]Lo^K@&sTTlɓQytz spg>~Ek._>:""9D.[qѢ[kH 퇂{z&-yfZ _eXCaa$/O rJ]Hg*ꏼ: 3uz'Z,jY'gP-|\lٲ6H7n,V,wުWM5$ʣ G^, ¢Bp׷MN-XXA2+U*cnn|7΂%FdCQ1 dc BNk0P ^^M r =ԪD''{4`/Զz l mJ!YӦ.|..g /RĄw[r~A9xbB+"9dqqqlƍƎ%D5QC/^򥰒k-(}޿?89g2sR_#":tp{!ƅ#2$nQ[ n߾10! pG[Xk5>IN^M+P^ҽ{f $ WwƗ,i#㮋FUu8gPy5$>0wFAZ%9~x)ZԔ}졩E:3f bܼe^(c_at`k˵jUWҼ3@2&0ΰС:(L͛:X^ j wBq|\N, E1,VYI`2C=< z/o :\ܔyH9rdy!eX~Mo֬[7N8Q1%D5QY;8Qǻ)Yt}I;' øqű7{Xӧaf :thas} )Yv5$>0z ![^%~;6C]sx7mԦM]ZG+[֦jl3c+$IIQHnCp80۷o,DQY;hQF+_˟v||)SO:}&Z-0Ї)5'yS#}yd,|]Zg_]SO9Ayʱ|iX5jTݕQ~&WCCAPL(L)Kşd!r$'/gS5s Ţ 퇊|ҩ1!m4"nCPFqH/ÇYW"j9u}`h?TQ簽K ʁƍcDnXK'CǏeLVwG±pjuOظqZjjC QC 3cɻ/H|1ƞZ=m4ͤC|B8rd)k%,ݑ@쵓uBUgNS#wSDž&];#g,h~ūWU+weliRguԙ~n/vOVB_ݿ8iv#|ŭfbYrp{P;fURںXH/{]5+uF|LGuҲYCw?/ݔ_ /&E5t(CPϟF:B: XVǜ\?7fc=!M\rȨ@ɒ]bsi .l\@~^RbׯZ-3griUԩ\հYt dɟ?_ޫ)S>|p̙ʕ+h_Zvm +TP\^z={OILT IՍ غajMq_v>v65'}"Pwz;pfuϒK:S%KF" .CVu2c #{.<>b؄-Llu۷Kp-\Z5ߦM1{a,Ymڴׯq?`=z+[[]v}mb%;[( 2eWjʧ8wPP7o}{+!Ii*WӲe̲|-ܺ A>l nV ҂[F.?B7B&  g _X Տ, ғG!C:r#xI%P#ӗNu j1Ƿ\?Zu6 Y"_+LKÇ٪wͱ 6ԬYʾ`~]R8:By˗/[XX}ooo˗?_~ 7o_+FuA}V[g;!_*6o+$2'q^aTd- GPKÆA B{ K }+.Z4oNwlVP2zŬA< MG[S$Xu¶m,Xp˖-XlY"E\\\N%YS3,3g}2/^L2ݻw5kD666^^^8m۾6qo 'V8ǃ̋.WϜ16.'{Vv: Nh`W*e%pߺY5( ^쉇a-0Q$$罫0w:{²`p>t,F0狧H/#xցAPjo޼Q2%e esȏ?zJ'OF޽{?7 0Y W5x(@("7}¾cv_;؎o)%1qYx![μOFlΛ,椥eQl@= ת刃 ֍q㸊Zqɜ;貑QO׮m# b#x HwAk6 ];S"qc'/؃awur\l٫^FF(ݻ++WS)k%pߺYHo42d۶Ch/e٭Zeti֛J_Wإ /"a zC>/ؚ20z » 2ȑ=X$=;툈 +HP$B)'EB!&rݬp.UGEB؟SJ@oK,wf+>lKuÿvm'xtxײa#a #xi CAPL( ° }c #VY!]fE&Ȗj(84&.FG]R\t[nmٲeذaH)""WCI;RguYNxΝcǎEFF? MD~Im b:fEPY}nƾ557l:qb_=NhlllbbҨQ#X-g0u&=I lzzErD-T7nXZZ6mڴZjVVVݻw_vݻw5zJԙ:={"gnZwVʕc9oS6Oβ 1kN$/EzhӶmѣZNxΝ5jݾ};&&׷xUT6l/GM\:BRguCM3;faV-I`g&Y6֭3g/?['9y9wuW^mۖ$33gnٲw}fTRgZHnIMl3433ft?gRw'  SZ2j)7 Q-NP:CF/w){h[ l3yuƱyc;X`Z "3EtjsISS7ٷo{Vr;{ 28NMQc/Sg] Rzz6fSe'ܳgϜ9sZ VW{> T{ 6~`!gnovյԩ2y$򼊐uLN]׮!P=lo+&TjsGku;[BV$~q1FE 4L; c++"3Smq%WU~XڪU]R TŠ\dD}묄=@`Ut /&C4YY/6MQXMWd-6PUVÔ={">Senly||(ɝRguC\uƈ@TJʣWgsrrr&Mʗ/߱cϟ+.]̞=[vTTBF⬄=DDA7_SH Rl:߿UV,͛o߾=((H+Y(JSh7SH >g 6)Ά5kX[[W2SRR/_Qװ׏._83o,Js }qdwY%'u64l2""Enf5==dɒGAܸqlorr'O ZΜFG>:ݻgii{+++WOV@ufffeʔm,&!!A:]꬗$)#A!222 AIb!'ӧO_1 Z#AѣauBMԙjs'>33|0bq u6wTRgZ͝ .BCChˆQӱDhmDP;=ADW\c: @ksG%u& "BpVDhm*߼I~6B}m "" 222K$ @ksGU:9Sr=w.A#G8>-Zj+Q"[ND-kֵ2G I3>65+{j6wzXgUoݺejjZZIU3|~Xx-ZW?yrE[vX'pYr*a !u&Zl) ؛3Glܸm!C:AΠΰjeѺu\%KIY1iλ ̒W5bOlOX gwl>Rg(011Q0iJoȱo%m5jTda  `fV@ިІ %0~By*<#^M*g7ouTgb\I3!CMLMYz"3n%X%NffC0YW -A 2b0lm~aeH #yub<~:jtq!oc 19;N<&Rx^6/dCs2P%^7o ܧO_ְ;uj93q\”5aGw̘,OZ#X%YuLdU/ԙd?>|xwfq-J0Wg;}!Ξ)/H ق]\eٲM8;{ oyu;@$1E6/Çc.. lj +/V͛d߿ a3ԓMs 555/(l''u&BL(#bʃ4/,^fBNQ`x2y6,7o3\ˢ髃4P Bg|4n֬֝;{4;ͅ}mjFhj('OlߞupHA..tI:DjtqALT i 3Q-jFD]\ZJi^ZHjtq;u&&-:WU-޽WA 1jFTgf8+6?~@5@P 5ŋ˗$B?{<| ߶4~hĈ?4--ҥ %JX }Ј^&yΝa>xK@Z,ۻ+V,}WXy~@XǎEIW&_ qgs#B07oqes|p ̜Mjtq!oW*e%Y41Ӄ' 6zʦ˖yuvssPssS5*ȑ= )cu26kVۭ[xq}:ٮ7ve#4P B(ի&%-tiCr8Q40{'O;7{.5 nwQQ]<0l_?ãۅ,;н{>D.eo_Re jFFy.ի+@׮ةS NvM0i/A`xqa3cŮX10']C֑|yC"&ϟBx!m6<qP$_*s N@5@P |DDAsT)ǜu9384`aþ|˖uVdwPR#s2k 68'rT%f6mUF5]LKthm\||Ϙ1He jFbF}qŃ640~WI>Jjk[/Wb]\ho!!SX&h\e# T5к5<9q(]\h:4P ԙ@5@P RgZHA..Hj! T5 u&4P ⿫?>A,;i[4|΢fΐfbb_MW@:: 9Ú5kZRgqAW3ghٲeDDD-4]A@,.jݳ|ݻw5]A@,.j 4hΜ9] ut5sggG"_5]A@,.j*>33a"MW@"ϟ_U+:+q#F! d; JAXr劝3 G,6j*f~@ pbRA 8RgAW3{|Ag3jVY\qqq-[܅x RgqAW3{tY< ut52W$₮fA]@ qAW3Ǡ.H cP$ACC\1 !.j At5s Z@cP$ACC\1 !.j At5s  hh 9uAA44] ₮fA]@ qAW3Ǡ.H cP$ACC\1 !.j At5s  hh 9uAA44] ₮fA]@ qAW3Ǡ.H cP$ACC\1 !.j A]bIݚ#u]MɕH4P ԙ@5@P RgZHA..Hsɗ/hLjtq!~*03ԩ*W.dÇc?~;':=*S6R'HA..tO.h8ܷ;JrEԮ<0g۶prϞȀod҇62*>rߪl >¢Hٲ6A16*`XQ:AjtqK )6[ɒPk׶+ɫ3vA./\X0T/LjRvjժqx&%-/_Vn: u댦M]>=[51d<#N'SS夁jF;v̂dȌ#y ʕ͜mP/^677}*ݻb̞=;('$An: slz|TP0'Nھ}Hm& T5%u滹T`t騷oSDrߪsfɓ;9ٗ*eիW` nlI^ &cMH mYϟONںEஐc$Cq 8dICFj?i Ņ3cQ5*QĉU֭{ 4xlUC^9sjY.HsnׯI1~xpa(>l%`z,X0G5 0BecN\ @5@P TgƋ3hQ͛5k&8:#~?Дض>>Y$4eXCa_JT˕+uN"U[z<'e; 3uz'Z,jY'jF: &\ "웊ԩv@3oNZdyQ Ulސ]\:5HjtqALT i 3Q-jFD]\:B pwFLT : F2ﻴKzDŽ_ҷѬFkeh$uތ2$ ۻqxh8Fu@|?)tbDYc&IU"$4{'ﾴ#zɛ{j6"}WQ*P eў==?ޯ+^.4,'yσL-=9**46vڵ{nV*>2lggM7I=唤ιbtj;W/N~qk;`}(IlmlԨ,YeܖqB,S7 G\IwA޽KQQm#Y}4~YD! :4幭C|B8rd) %JX%%-^F?3>[׃].==58g.]Z@~~[Fŕ+b˱cwLw=gPN'k#Цpʕ˲X>|X#$Y[7ŋYv89>u` @}P^b];Q9w$uF=<2Xp^Y;~: B}LuF%KZ9J͍q7I(;<_ xSPWj$J" *CEܿ![֭]FAغn0p2bdV藁><>3'Qfjedhذ:U"tsN"̝Օ+]\tĂ̪MP(Ӡ68uj KDW2:||B>UGblBI_< mF R:\Rܷꌾ/X$9 Ԩƍk0zɇ,Wg|bIj5:QBغt86Y|ɫ ꌰo Nu608IQAm<;ݑ8_ury>U&6v2Öbٷl #u&" ͆<̅:;9}"ǛQal`3IQ)mU&#s9ԣG;*dDL$*ERgA{isOUԙMAePۊKc`&63=IL[pnAHiuCl*U)b 9༴΂u&nѥEغuFӦ.O-EϘ1`A#\ŋCnŲH[0;[j^Ϟ4#Ǐc/ v%$ 6m "7F;7ߵk4R4W0`Jpaׯ̟)9d d ܼgnnOލǽg*/?k:\ͲYyM?|4mq@`afumC aii "YAJس@իW@)5".4W0`JYD 2b.O#&6K _0?k: ̌/,yi?I7LNK@NC2*PϟOgm] x Ezo(q!ѕLeC8g&Y{⑒3yOn"O\4W0`JYBYUQ3|xwia Fg-Xɓ,'M&Ă$uDި39uӏ.uS*PwR=;OH pzUc}^t{f6|Hmڸ1r*dH6!I\0.RP%-Yp`Θ1Dy/+ɫ`bc'y7!fϞH)x^ORgA:S79D,R11[1CπB aa >..̬0ƍ 3kV@!߈>=M>@Q&AEP._3-:(i`v`Rr3D2?,\N"0qJ֨QQ^$΂uX`8{C>>9RgB^~ANĥV2θiC_p3n׮kh 426.]:7m(5bpd,dccB Ν=,e}8(28bK*^ܼLݿ5W6ȟ)&-pzibN޾$*ޅ FJ&S`AϜm >AW#R{9G,uK!1GAv^=;%M7d`v|xZd T\jj% Huz"Rr$I I?x59% s!3QOH,eKRgYNwHja>Rg!(]}&u&΂Q$u& IALwIu1I:@>Rge>:u2>:΂Pe8%&DD=! TeNI:s.<+LWqJNh΂PE?f:׃۱h\!2I!ӈ8]RgB n>[׻zu:'%-G`ʔ)O4^^M`#YGOD :3&={k5y3hk\ys.XZC)I:8N[:KlH3xbN(P.]Z\'Oț2sxJj޼53@OJޥ.]BDuY٪3ñ^uQ휗Ey+y֬!A+U*TRpG:xq| s眜T<(N#QCeĎ2 NefBpQFy98ر(v̘,VJݹ30u0[꜑!xv߿_8RqrNhZ۰İL&"dQgwS<ʨss^[kգGq9jX-uҥ䅇SV.\D63gΌr劇67aÆYYY!˗?v)CmTgyogcMDJaxpXbL$N(e(!9/YuFҲͶ^*Fj-u~ǃGFF"&44Ȉ)5$ŋƙ3g (0m4ҁ۷W@کNj:/[ 6k,""W^O<߿m۸oՙWdRgá ǏG?yr`>Q_ÇMtt4ժUz9Gl$u& uN۶m[`+W@Q?M4a H D=Ω3u.3Q-̧Q.MLT IALwIL: F9]([s$uDNF.:3':`Tgjj²+T썘yEQK`\Uxxr2{T \#""F,ʏ2mS?9=WgY'vvP7bF+^Zd+5b54מ\ ksbņ.9Ug"U˃Q?:z儼J>aiEmۆl٣e..Lag {#:ي!qŊeѺu!q҆>}<۵kM99>=0ā>۶{DxsB+#dZHks^u7Jֽ^~O23OvQd-Tge|ztnXDh]]\\u˖0tNBt+Eu/-=?(z$ς?*WObYO.Mqpc7-AQ۱weŃFaii_Z-}'ꬌoY/M}+EC bs,K+^Z{0Piufp9q''H3S)~2Jz;㮬eyNo'rڨF+܄`G$a0YYOp3'Eu/-=X:+WObNʓ ͛2eK. 毌u+Uu}! @hy?9mTge|: ˻>(Dk}Yl 'yIؤ3Xy({iEji^ticccKKKpɭ[VUU97nܲe@6E|A^_^HQ@I$d6maTg/CHu;Pvb=E m*..>}w ˛0aw Kr755]vҤI8nj ܓ***6mt1H·OPgD0 h b9s&>}z@[v20_px[UgҮۉD7#:zR>zh>}fΜyܹ?gϞ=`̞={B/^\__?~駟.,,Gܒ}>s>8>BQMٴQ;캣8MxĆZy7ח2C999Fz6orgΜillD;J.]#F`x)NNL</̦-x*LMj)1ch.xС 6̛7oذa;v>|xeeM>pAsssMMͬY =o@·CIuSO$:'i :;m niwjR/+Vt{$w}.XsU:gΜ\p!a@`UUU苳ΣSFvSN<&i : 0NM ]dI|? .|ᇻw9hР'|7ؿx}֮][RRQXXXQQQWWDlzV1lpInX0Rq'Nؾ}/8~^zu]ʧ~zY _H0ri@755ŭa* O>\6Vg%lU)[=uݻW\9qn---;2eʚ5ks̙e˖dee1UKxKVg%^AĭB[]]=u|uAAAYYYMMMsslj^eՙi rrVC^eՙi rrVC^eՙ&G樂Ր ̫NVgbrrVCZe'3AI1K99q!A[2oTu铭`GɎpv8$Lz/ĭm$Ugw_pwl[&I1*$ĭ~Ykhr.Za=ipNLx>٤M:psHlm)(8Q +bfrN@Ĭ/>٤db( ~z 5 .:grcJI'&4v4lҁCR %3 ?=]R3M1ΤdGLOY`[ ƍ:grcJI'&%On-MZsHdu&RСMii=|,.3֋!DSJ:(t79$D: NPffZ׮7Ν:schI7ECRL$3@'On;{vwøIëmKI1$ڤ&!dufZBVgmʸOVg%du&\:3-!3 ^eՙi YI*3LKLWdu;[Z>lyqdu&a*3̭r^~/!O;/[7c֕I.wXI{_Ŝ㞕̐:`u67Tu&%ϝkઇaSҡCƑ#o'p2B}lLWgi\>v.#b:Kgn{ܸ!oO?}'OnQ /)vUsm:]WZ:WZ[8!-jn޼L>ݺgssfd\'92_ uv?#.P=;C!(ܩ39hM|:wΖ%ŅqWgSZ«nF8o ˦oA}/kq$d LP_*q$%jk#Gp}%y[>{N%3_uv?k8.Pg X^ȱc!E4J'wJu&I7pΐM,= K4c= ex9ЅTcd)[N"J\BiC ɗGPDZG;s.^\q՝{!d/ 0vK:+.;ujq&ɝRD;}jH]H~0\GnEţR?mh!Ma(BC LRfe ]ً/κ)2D?g;iN+OguN@d': QA4Gk1"& {>ĉ#PHB@L :{wWg}+~a ~3>v2v|_Ԧ7D-X0E>P̴럃ްa7gϛ88fL᭷F\/\ڋ:GQşItr\|b>sB;2!E? W\'>>BUqL̦A^q2 E3hiqSle ]ً/xLu[V =DUg4kÇ->) 0 x}}ܹuO(;UWWt [B.\8 aL %&cCF# _;Qrgj':'~z RΐoZ|iW C:AKģRL :; FBP'{VC>%૿D$* ^uЪr?gAt[A?.H'ӏFVg~z wRàq;fA"'&~Huv.~^7ЅT6FO}L.dBz_~{oC,.l:xO#-pIgu&&=-NiaufZBVgmp߸qQ)-LKLWdufZBVg%3:Uf.Yՙ2slrfJ@du&ZWqiUks&LD/;V1E:/83% W~Vg&L9uH{ѢcRl1Q4u90TS0 EVsȍFں=1QuE?RQS F;\V6|93 ,3ՙjI(:ëzX{<iMzx,23ӎی pJ G{ׯct׿Nc=("$L 23ՙuV3NީJ=[`JJ:1(zX{<Τv _F\T:Sf. }S̔@3SXIԌ7V1<%"PP҉FJ9tu&,]Zϟp b׻wWPTY~u6PpfJ)$@jy+GoI(a(da%:FGPCNb)X$(,D3gLOfR)q)NL6Vϡ3iҡ_q[9[Ȫ$:;df 3 ?=SAJ=[`JJ:1(VAޙ4&=0|򟸟_uUkuLNR[<ΜLOJ=[`JJ:(zXmNH"$:938}Vg~z UV1<%"PP)YI$6z Oc>$0tlpfJ@du&R=I(:YՙD2sPt:3-!3 ^eՙi YI*3LKLWdufZBVg%ɱ;eL"T6͆~xԩKCY؝duf0|"l]cPN>Zϱ;e`DP(:!($_^>%3Aen9}޲j})KVg'FY?F>Gk!z9v,Y *s1C& C;X؝duf0|"l8̱;e`DQ,sNY:3>F S OQՙ Vgf duf0|ՙY `ufBVg'Xՙ-!g$ɷ*g0,/!#X #`uf00?ڿ&vwqIENDB`java-design-patterns-1.16.0/twin/etc/twin.ucls000066400000000000000000000107631312550536300212440ustar00rootroot00000000000000 java-design-patterns-1.16.0/twin/etc/twin.urm.puml000066400000000000000000000007711312550536300220530ustar00rootroot00000000000000@startuml package com.iluwatar.twin { class App { + App() + main(args : String[]) {static} - waiting() {static} } class BallItem { - LOGGER : Logger {static} - isSuspended : boolean - twin : BallThread + BallItem() + click() + doDraw() + move() + setTwin(twin : BallThread) } abstract class GameItem { - LOGGER : Logger {static} + GameItem() + click() {abstract} + doDraw() {abstract} + draw() } } BallItem --|> GameItem @endumljava-design-patterns-1.16.0/twin/pom.xml000066400000000000000000000035731312550536300201360ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 twin junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/twin/src/000077500000000000000000000000001312550536300174005ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/main/000077500000000000000000000000001312550536300203245ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/main/java/000077500000000000000000000000001312550536300212455ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/main/java/com/000077500000000000000000000000001312550536300220235ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300236535ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/main/java/com/iluwatar/twin/000077500000000000000000000000001312550536300246345ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/main/java/com/iluwatar/twin/App.java000066400000000000000000000041241312550536300262200ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; /** * Twin pattern is a design pattern which provides a standard solution to simulate multiple * inheritance in java. *

    * In this example, the essence of the Twin pattern is the {@link BallItem} class and * {@link BallThread} class represent the twin objects to coordinate with each other(via the twin * reference) like a single class inheriting from {@link GameItem} and {@link Thread}. */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) throws Exception { BallItem ballItem = new BallItem(); BallThread ballThread = new BallThread(); ballItem.setTwin(ballThread); ballThread.setTwin(ballItem); ballThread.start(); waiting(); ballItem.click(); waiting(); ballItem.click(); waiting(); // exit ballThread.stopMe(); } private static void waiting() throws Exception { Thread.sleep(750); } } java-design-patterns-1.16.0/twin/src/main/java/com/iluwatar/twin/BallItem.java000066400000000000000000000037101312550536300271710ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * This class represents a Ball which extends {@link GameItem} and implements the logic for ball * item, like move and draw. It hold a reference of {@link BallThread} to delegate the suspend and * resume task. */ public class BallItem extends GameItem { private static final Logger LOGGER = LoggerFactory.getLogger(BallItem.class); private boolean isSuspended; private BallThread twin; public void setTwin(BallThread twin) { this.twin = twin; } @Override public void doDraw() { LOGGER.info("doDraw"); } public void move() { LOGGER.info("move"); } @Override public void click() { isSuspended = !isSuspended; if (isSuspended) { twin.suspendMe(); } else { twin.resumeMe(); } } } java-design-patterns-1.16.0/twin/src/main/java/com/iluwatar/twin/BallThread.java000066400000000000000000000044221312550536300275030ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * This class is a UI thread for drawing the {@link BallItem}, and provide the method for suspend * and resume. It hold the reference of {@link BallItem} to delegate the draw task. * */ public class BallThread extends Thread { private static final Logger LOGGER = LoggerFactory.getLogger(BallThread.class); private BallItem twin; private volatile boolean isSuspended; private volatile boolean isRunning = true; public void setTwin(BallItem twin) { this.twin = twin; } /** * Run the thread */ public void run() { while (isRunning) { if (!isSuspended) { twin.draw(); twin.move(); } try { Thread.sleep(250); } catch (InterruptedException e) { throw new RuntimeException(e); } } } public void suspendMe() { isSuspended = true; LOGGER.info("Begin to suspend BallThread"); } public void resumeMe() { isSuspended = false; LOGGER.info("Begin to resume BallThread"); } public void stopMe() { this.isRunning = false; this.isSuspended = true; } } java-design-patterns-1.16.0/twin/src/main/java/com/iluwatar/twin/GameItem.java000066400000000000000000000031511312550536300271670ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * GameItem is a common class which provides some common methods for game object. */ public abstract class GameItem { private static final Logger LOGGER = LoggerFactory.getLogger(GameItem.class); /** * Template method, do some common logic before draw */ public void draw() { LOGGER.info("draw"); doDraw(); } public abstract void doDraw(); public abstract void click(); } java-design-patterns-1.16.0/twin/src/test/000077500000000000000000000000001312550536300203575ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/test/java/000077500000000000000000000000001312550536300213005ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/test/java/com/000077500000000000000000000000001312550536300220565ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300237065ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/test/java/com/iluwatar/twin/000077500000000000000000000000001312550536300246675ustar00rootroot00000000000000java-design-patterns-1.16.0/twin/src/test/java/com/iluwatar/twin/AppTest.java000066400000000000000000000025121312550536300271120ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() throws Exception { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/twin/src/test/java/com/iluwatar/twin/BallItemTest.java000066400000000000000000000072751312550536300300760ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertTrue; import static org.mockito.Mockito.inOrder; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verifyNoMoreInteractions; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import java.util.LinkedList; import java.util.List; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.mockito.InOrder; import org.slf4j.LoggerFactory; /** * Date: 12/30/15 - 18:44 PM * * @author Jeroen Meulemeester */ public class BallItemTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } @Test public void testClick() { final BallThread ballThread = mock(BallThread.class); final BallItem ballItem = new BallItem(); ballItem.setTwin(ballThread); final InOrder inOrder = inOrder(ballThread); for (int i = 0; i < 10; i++) { ballItem.click(); inOrder.verify(ballThread).suspendMe(); ballItem.click(); inOrder.verify(ballThread).resumeMe(); } inOrder.verifyNoMoreInteractions(); } @Test public void testDoDraw() { final BallItem ballItem = new BallItem(); final BallThread ballThread = mock(BallThread.class); ballItem.setTwin(ballThread); ballItem.draw(); assertTrue(appender.logContains("draw")); assertTrue(appender.logContains("doDraw")); verifyNoMoreInteractions(ballThread); assertEquals(2, appender.getLogSize()); } @Test public void testMove() { final BallItem ballItem = new BallItem(); final BallThread ballThread = mock(BallThread.class); ballItem.setTwin(ballThread); ballItem.move(); assertTrue(appender.logContains("move")); verifyNoMoreInteractions(ballThread); assertEquals(1, appender.getLogSize()); } /** * Logging Appender Implementation */ public class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public boolean logContains(String message) { return log.stream().anyMatch(event -> event.getMessage().equals(message)); } public int getLogSize() { return log.size(); } } } java-design-patterns-1.16.0/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java000066400000000000000000000066701312550536300304050ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.twin; import org.junit.Test; import static java.lang.Thread.UncaughtExceptionHandler; import static java.lang.Thread.sleep; import static org.mockito.Matchers.any; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.timeout; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import static org.mockito.Mockito.verifyZeroInteractions; /** * Date: 12/30/15 - 18:55 PM * * @author Jeroen Meulemeester */ public class BallThreadTest { /** * Verify if the {@link BallThread} can be resumed */ @Test(timeout = 5000) public void testSuspend() throws Exception { final BallThread ballThread = new BallThread(); final BallItem ballItem = mock(BallItem.class); ballThread.setTwin(ballItem); ballThread.start(); verify(ballItem, timeout(2000).atLeastOnce()).draw(); verify(ballItem, timeout(2000).atLeastOnce()).move(); ballThread.suspendMe(); sleep(1000); ballThread.stopMe(); ballThread.join(); verifyNoMoreInteractions(ballItem); } /** * Verify if the {@link BallThread} can be resumed */ @Test(timeout = 5000) public void testResume() throws Exception { final BallThread ballThread = new BallThread(); final BallItem ballItem = mock(BallItem.class); ballThread.setTwin(ballItem); ballThread.suspendMe(); ballThread.start(); sleep(1000); verifyZeroInteractions(ballItem); ballThread.resumeMe(); verify(ballItem, timeout(2000).atLeastOnce()).draw(); verify(ballItem, timeout(2000).atLeastOnce()).move(); ballThread.stopMe(); ballThread.join(); verifyNoMoreInteractions(ballItem); } /** * Verify if the {@link BallThread} is interruptible */ @Test(timeout = 5000) public void testInterrupt() throws Exception { final BallThread ballThread = new BallThread(); final UncaughtExceptionHandler exceptionHandler = mock(UncaughtExceptionHandler.class); ballThread.setUncaughtExceptionHandler(exceptionHandler); ballThread.setTwin(mock(BallItem.class)); ballThread.start(); ballThread.interrupt(); ballThread.join(); verify(exceptionHandler).uncaughtException(eq(ballThread), any(RuntimeException.class)); verifyNoMoreInteractions(exceptionHandler); } }java-design-patterns-1.16.0/update-ghpages.sh000066400000000000000000000032661312550536300210710ustar00rootroot00000000000000#!/bin/bash # # The MIT License # Copyright (c) 2014-2016 Ilkka Seppälä # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. # # Clone gh-pages git clone -b gh-pages "https://${GH_REF}" ghpagesclone cd ghpagesclone # Init and update submodule to latest git submodule update --init --recursive git submodule update --remote # Setup Git git config user.name "Travis-CI" git config user.email "travis@no.reply" # If there is a new version of the master branch if git status | grep patterns > /dev/null 2>&1 then # it should be committed git add . git commit -m ":sparkles: :up: Automagic Update via Travis-CI" git push --quiet "https://${GH_TOKEN}:x-oauth-basic@${GH_REF}" gh-pages > /dev/null 2>&1 fi java-design-patterns-1.16.0/value-object/000077500000000000000000000000001312550536300202105ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/README.md000066400000000000000000000023671312550536300214770ustar00rootroot00000000000000--- layout: pattern title: Value Object folder: value-object permalink: /patterns/value-object/ pumlid: LSZ13SCm20NGLTe1RExTXX2KECBOmfza_VRQszDxDnVBNJFiTG9pVOY2dteqdBdbqf3XK4ULqQbPFWmEklZcikjgXvV9W8Olwhn-e9ijjOpjKW4fv2zgHgypktq1 categories: Creational tags: - Java - Difficulty-Beginner --- ## Intent Provide objects which follow value semantics rather than reference semantics. This means value objects' equality are not based on identity. Two value objects are equal when they have the same value, not necessarily being the same object. ![alt text](./etc/value-object.png "Value Object") ## Applicability Use the Value Object when * you need to measure the objects' equality based on the objects' value ## Real world examples * [java.util.Optional](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html) * [java.time.LocalDate](https://docs.oracle.com/javase/8/docs/api/java/time/LocalDate.html) * [joda-time, money, beans](http://www.joda.org/) ## Credits * [Patterns of Enterprise Application Architecture](http://www.martinfowler.com/books/eaa.html) * [VALJOs - Value Java Objects : Stephen Colebourne's blog](http://blog.joda.org/2014/03/valjos-value-java-objects.html) * [Value Object : Wikipedia](https://en.wikipedia.org/wiki/Value_object) java-design-patterns-1.16.0/value-object/etc/000077500000000000000000000000001312550536300207635ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/etc/value-object.png000066400000000000000000000116411312550536300240540ustar00rootroot00000000000000PNG  IHDR hIDATxmEO4~$W?Ac ȍhJZ.%MI%pbJ!sH ossޙ}y;ӛЂ`}TftW{tha@"3 残0aF!ŒB-<:;ugkh} fd DŽ:ɥH3IeD_g'ɿZ!x<K\'0֌z%b!A*HYh3I#3-DbqE9=o1K/Q?i1WsF޺#fk3WΚce0yh+m2++fgY1<sT*Ơ?;4F٤1gY4-Iꥹ͞\36T]F}!Q519sMc*̤"(DQ0aF!ŒB|>veWܷ}fkj?wyɟnrswbk?Vs_p䎧xwFUGۖ)ÞE9He|R-bB' \efC[D]^ |f+Ӣ.fy}p"Qf,G7o8x?؋o=c{4G]Ga[1q쌈,uD AMǼb5vT|c?tӟ7&l`i20KÎhF j3olAݫ;aw{,ͯ{;1.\zΕv>w2$%9Rbf\fk"G!yjwvrh;} ]lL8G od,7Rj AJ6bP/ k3a/v]M>$xz땟=gnZ3/ g1rFj =E_MW_y`wfS߾ kL'+Yݕ}^a 0GϾcŚkٸF}fk$ځyWߴuw5{͐s5Iӈ0aF!ŒB3 5h.ziKf~)_G٘*AW#抏?R'3ל^ȘLپY$6ܽ¶i۳_`Jhujr6a.s)]ae>G~_G&.U䠆c6"R10aF!ŒBA!rGP#(TBm.ِ{%pF`2=Qfs3ԴB%G\<`BF-MYf\(M&%G2=(tr$P3yFL&Gң6߈-6eJݰTv`}#Mc s{$lF;$HE =i;T4`54?tAj,fTc1|0aF!ŒBBi<`&HsC&HUBmv LQ:,oSݍ7sHRAdq#٭Q07 s$ m`p}Lj3 f"(DQ0aF!3Mر&D5DQhz̓|^ﵟ Դ?wUx{هχX?%)ŒB%4r4:L2DoW8r}lG0/Od ?+SXNbbl ,Ӥ6!b".qvyz;׹=d_>v`{YlF83oCm,GRyc ?f镜F_)|df(?e0n)YoSF2!1R\LhT^SS쪭Oo~j5e'1K\4j'̞1 LK1Som/ VP]9f|7N>t,&$e@xcFqn2TL*>YO.<-~j? :3Ѩ=e~PBηáឲ#0aF!ŒBBtdbI p+PY4Ĝ,I5(3_r4I4Sqh|pYg ޛsvwiAhy&;FjwLy~ݓcX?5*w4Ϫ#u:41 p|s}bSH}e+-ˊ&=PdH.)0~쎗w<3h'Vj%7lL\07JPf̧Y{oyP+[ wL=1b2+n0W㢙C\/,>p‡J#%{ci^7163M&N`tԫ/.޸=}`_d  0D>ߢrkc#X).03̯TCJJETLc$ELJaF!/?GK CP:fREQ0aF!ŒBua#ٛtd?lG X㎘fG HE[Rn̚{}tn#JdrHwG _s7Փ}H؃ʇ="-5-Қ̈o|*]鰴\ʇ=}⿄`؈clW}.+f'9 u#+f7r,Ya]B6XiaBGHW`09#.L/ߵ),4AJjnU^pw=!8f"(DQ0aF!ŒBœaH믐 +^äf8RU8]&1Iwh v-V1_z[M I># [^V0J𘹺0ɇٿ{$3kkC;UacKK0w`fbc5\.(0wd-ofj^m䓎8Lr?yv845a IY=R;0)3q"(DQ0aF!ŒB3 Յ9=*(W<*#5xܘK{%Ɛ]x4sY x4sYt`9zؕS0gc ׌8KsY 6 hM#]x4 ܠSQ.Mgcyw ̓fG:(OpǣGyjL̴Ӗ)|M3qsq̖֍\#i%aӺ=h皧jhue*=JËuk֔Grv.)U"HsL֔#5GL*"ŒB3 f"(DQ0P '"N=|lX'="K_xzzqN=M <׈j*K\jǃXG [޳>8I9repEKi\(n$eGࡀ8@̆UA68L[#0"cH Sr,bG"#f xkx^x(dF;e~v؆7ٌDW3ȡ{ kwNIj{$pN $0caF!ŒB3 f"(DQS؃]C.''oHEϥ!KB#`g9rG)"P;L4DC'",^15zc>花w͑O*Ɯo9,^lό.Q#g"Gв8Kiqm>siQ҆Z]4iV=b7qzYi𾛆Y.n@жlavZT=b7R1U@>Fۆ9XR.fmig]fWfbP~$:3QZ3#%85jݲ{m t5c䛹xS Z.>=0INXV)UHG0sxuֳd:d+{?i3)yW+}/]Q;>1jaF!ŒB3 ,9GKLKŒb!(|dIENDB`java-design-patterns-1.16.0/value-object/etc/value-object.ucls000066400000000000000000000026121312550536300242340ustar00rootroot00000000000000 java-design-patterns-1.16.0/value-object/etc/value-object.urm.puml000066400000000000000000000010441312550536300250430ustar00rootroot00000000000000@startuml package com.iluwatar.value.object { class App { - LOGGER : Logger {static} + App() + main(args : String[]) {static} } class HeroStat { - intelligence : int - luck : int - strength : int - HeroStat(strength : int, intelligence : int, luck : int) + equals(obj : Object) : boolean + getIntelligence() : int + getLuck() : int + getStrength() : int + hashCode() : int + toString() : String + valueOf(strength : int, intelligence : int, luck : int) : HeroStat {static} } } @endumljava-design-patterns-1.16.0/value-object/pom.xml000066400000000000000000000037751312550536300215410ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 value-object com.google.guava guava-testlib 19.0 test junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/value-object/src/000077500000000000000000000000001312550536300207775ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/000077500000000000000000000000001312550536300217235ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/java/000077500000000000000000000000001312550536300226445ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/java/com/000077500000000000000000000000001312550536300234225ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300252525ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/java/com/iluwatar/value/000077500000000000000000000000001312550536300263665ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/java/com/iluwatar/value/object/000077500000000000000000000000001312550536300276345ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/main/java/com/iluwatar/value/object/App.java000066400000000000000000000052031312550536300312170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.value.object; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * A Value Object are objects which follow value semantics rather than reference semantics. This * means value objects' equality are not based on identity. Two value objects are equal when they * have the same value, not necessarily being the same object.. * * Value Objects must override equals(), hashCode() to check the equality with values. * Value Objects should be immutable so declare members final. * Obtain instances by static factory methods. * The elements of the state must be other values, including primitive types. * Provide methods, typically simple getters, to get the elements of the state. * A Value Object must check equality with equals() not == * * For more specific and strict rules to implement value objects check the rules from Stephen * Colebourne's term VALJO : http://blog.joda.org/2014/03/valjos-value-java-objects.html */ public class App { private static final Logger LOGGER = LoggerFactory.getLogger(App.class); /** * This practice creates three HeroStats(Value object) and checks equality between those. */ public static void main(String[] args) { HeroStat statA = HeroStat.valueOf(10, 5, 0); HeroStat statB = HeroStat.valueOf(10, 5, 0); HeroStat statC = HeroStat.valueOf(5, 1, 8); LOGGER.info(statA.toString()); LOGGER.info("Is statA and statB equal : {}", statA.equals(statB)); LOGGER.info("Is statA and statC equal : {}", statA.equals(statC)); } } java-design-patterns-1.16.0/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java000066400000000000000000000061511312550536300322330ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.value.object; /** * HeroStat is a value object * * {@link http://docs.oracle.com/javase/8/docs/api/java/lang/doc-files/ValueBased.html} */ public class HeroStat { // Stats for a hero private final int strength; private final int intelligence; private final int luck; // All constructors must be private. private HeroStat(int strength, int intelligence, int luck) { super(); this.strength = strength; this.intelligence = intelligence; this.luck = luck; } // Static factory method to create new instances. public static HeroStat valueOf(int strength, int intelligence, int luck) { return new HeroStat(strength, intelligence, luck); } public int getStrength() { return strength; } public int getIntelligence() { return intelligence; } public int getLuck() { return luck; } /* * Recommended to provide a static factory method capable of creating an instance from the formal * string representation declared like this. public static HeroStat parse(String string) {} */ // toString, hashCode, equals @Override public String toString() { return "HeroStat [strength=" + strength + ", intelligence=" + intelligence + ", luck=" + luck + "]"; } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + intelligence; result = prime * result + luck; result = prime * result + strength; return result; } @Override public boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } HeroStat other = (HeroStat) obj; if (intelligence != other.intelligence) { return false; } if (luck != other.luck) { return false; } if (strength != other.strength) { return false; } return true; } // The clone() method should not be public. Just don't override it. } java-design-patterns-1.16.0/value-object/src/test/000077500000000000000000000000001312550536300217565ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/test/java/000077500000000000000000000000001312550536300226775ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/test/java/com/000077500000000000000000000000001312550536300234555ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300253055ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/test/java/com/iluwatar/value/000077500000000000000000000000001312550536300264215ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/test/java/com/iluwatar/value/object/000077500000000000000000000000001312550536300276675ustar00rootroot00000000000000java-design-patterns-1.16.0/value-object/src/test/java/com/iluwatar/value/object/AppTest.java000066400000000000000000000024721312550536300321170ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.value.object; import org.junit.Test; /** * Application test */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java000066400000000000000000000044741312550536300331340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.value.object; import static org.hamcrest.CoreMatchers.is; import static org.hamcrest.CoreMatchers.not; import static org.junit.Assert.assertThat; import com.google.common.testing.EqualsTester; import org.junit.Test; /** * Unit test for HeroStat. */ public class HeroStatTest { /** * Tester for equals() and hashCode() methods of a class. Using guava's EqualsTester. * * @see http://static.javadoc.io/com.google.guava/guava-testlib/19.0/com/google/common/testing/ * EqualsTester.html */ @Test public void testEquals() { HeroStat heroStatA = HeroStat.valueOf(3, 9, 2); HeroStat heroStatB = HeroStat.valueOf(3, 9, 2); new EqualsTester().addEqualityGroup(heroStatA, heroStatB).testEquals(); } /** * The toString() for two equal values must be the same. For two non-equal values it must be * different. */ @Test public void testToString() { HeroStat heroStatA = HeroStat.valueOf(3, 9, 2); HeroStat heroStatB = HeroStat.valueOf(3, 9, 2); HeroStat heroStatC = HeroStat.valueOf(3, 9, 8); assertThat(heroStatA.toString(), is(heroStatB.toString())); assertThat(heroStatA.toString(), is(not(heroStatC.toString()))); } } java-design-patterns-1.16.0/visitor/000077500000000000000000000000001312550536300173275ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/README.md000066400000000000000000000047061312550536300206150ustar00rootroot00000000000000--- layout: pattern title: Visitor folder: visitor permalink: /patterns/visitor/ pumlid: DSR14OGm20NGLhG0mtsxmSWeJa8oyD7sTo_xJczLgoqFIM_B1Spu43c_vLHSkMU8rs4GGwcZaxPy6UnqyyFR8Q6dRPC1SGlg7B_Gew4OJeBwVqdlPMPlNm00 categories: Behavioral tags: - Java - Difficulty-Intermediate - Gang Of Four --- ## Intent Represent an operation to be performed on the elements of an object structure. Visitor lets you define a new operation without changing the classes of the elements on which it operates. ![alt text](./etc/visitor_1.png "Visitor") ## Applicability Use the Visitor pattern when * an object structure contains many classes of objects with differing interfaces, and you want to perform operations on these objects that depend on their concrete classes * many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them * the classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes ## Real world examples * [Apache Wicket](https://github.com/apache/wicket) component tree, see [MarkupContainer](https://github.com/apache/wicket/blob/b60ec64d0b50a611a9549809c9ab216f0ffa3ae3/wicket-core/src/main/java/org/apache/wicket/MarkupContainer.java) * [javax.lang.model.element.AnnotationValue](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/AnnotationValue.html) and [AnnotationValueVisitor](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/AnnotationValueVisitor.html) * [javax.lang.model.element.Element](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/Element.html) and [Element Visitor](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/ElementVisitor.html) * [java.nio.file.FileVisitor](http://docs.oracle.com/javase/8/docs/api/java/nio/file/FileVisitor.html) ## Credits * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) java-design-patterns-1.16.0/visitor/etc/000077500000000000000000000000001312550536300201025ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/etc/visitor.png000066400000000000000000000544061312550536300223200ustar00rootroot00000000000000PNG  IHDR?8ӖXIDATxl%}M# B pm@P,QhUL9 ĭ$f%ܸMYvLRޥײdu P`S Zl\ `ϝ̜uw|< sΜeh%  L8^ L8^ L8^ L8^G㳗ر}h @ 5Ө#&5qQ؁Ib?^Lۯ{l,V[>*FMa7qĨ#&LQgv7z[kg@"8 GԄ8qDMGё~/{9m̵Vz بL?@D-) ]lL4<#dQ-GQ+DQQ\d#ߦ.,uiz}mԽt(ۉvel@44∌$8"c}%YgG،5ȉd/I## Q ]֡lo>dRPCI^ +s=׮>ݏ*_^QG9Qo Jȉe/PpdNX7K9Ȑ[=OON2]UfOʮ0fi^9b?YlPG|KuJ6Oڦ/&:o+Ozvx?ߢ O>=kscYw#ud9Q8٧`Kȉe/E܇4Ew+lfuުX5dNn]9ɘBmttlLG|}/#yCjﾷowa,O~w'ħ0oW\w_#cmg9Q쥠yj82mFYc=蟋wi#ghIO髳L2 |r͜9ۏ2y :YؤǦ939r e/Ⱦ/Q4p[nw|7^~s:_/?[|4YI?,YU|K9Q쥨S]jݦWnx't\WZ,Ӳ b#+DF="10Qb&8€S]/v>J1~;Y{?9q'_,|4+ANL+QT '*s`?1 }b}ޑu#}?|3&іv6˴fӠU)p4%.`%69h# j>Ԏ^'&:s?٧>1jG|g?I-a#3 |XLyY@NT5{9(@XYR3iYfᲱ C-8<؏ g/ f+vfm# #qh5ladtuf0׌8B8'ً {V B8B8'ً {V B8B8'ً {V B8B8'ً {V B8B8'ً {V B8B8'ً {V B8B8"';o v_R ~ 3 PITqGXIMkQHb?^|f*8&#lbިuY\NH㽀 ^[^tm-bKW;_Y:n)yW*C1M~Qj$*^>*U3 8G8GTx|t۾ W__yY|{es=XR5~W b:E"Pi8~CG"T#DRQnmPYi8G8RЌWMeYO)q=ȻF.UYȎ-(E؏0DQ[>5Ӱ#pЊ! Hp PTdZ$JE]nLO-::^fN%*U^>*S3 8"8Ga#ʷյ;K nwLN? Oq bbSGaDQ>5Ӱ##pD #uD䦩IدbmEwx)\UK}z'lQb:4^5>*kT3 8G8GT34v\ozC1ۏ9u5FicR]ixs&^f/M#pL#p,LQ֟L8^ L8^ L8^ L8^ L8^ L,}h ʖ%*!%,@F#){@YbBehd/ZMj&eehd/ZMj&eehd/ZMj&ee+k~p>ܣ  ڇ9؋`ZG@(G@${d/jR3A(G@(G@${d/jR3A(G@("8季d_?Wot؏|GDj&eeVo|_,J`:^G? >##52q2+n0d/EIRu%52q2ꈽرY|MO:GZ-C;\k;Or;umүHb? f/[t'Hg/r!#m;+  #E\Z3X#6WB9"B  9B,l$n&'v_Hh-rd/1/j{#{rVƢXď 3sYjTæs\SeVvD"sWCZǶ}`Λ_ ; e/^BklKO𭥽/wEr"oxsȲ`-45J* a8hbUk6*Uu= #`jYA;qWĂW^8 o֘H:-_fvB*^G%ۇi=t6E|:t3ǼYa >mk5jw_M?DpHM(jx8)R4e5SFrC~R[+qMuYUGrFXLo|lTCV}l8\x>ϋʘS _KqT߉e/[ReTs(*K.zW imO["KާnWBJ(O92Jr"G,Vf1"c}+>e}d'zVic: 1I237m5DSZ舛j~wxfFLKZ 4ôENâs̚Rc,E͐B&uETاߕ .M %Zk~b݇1sYjͤ0#b=fv\S]V)ً^r\TwWCI_ D }Յw++2)EvH2 QO^2aAU*?z$d/2O$i*O?c%XQc4e5S#TBa[1$f/#Rfi%d${jڧ'.<}ξ|򳗖msbY*>:UKf;^!*! ;{CMͤ~7Rm\l1sYj͔>)ڱ[ ((DK~wdGBGyK}wNo|}Sj7O6w! .] ^R'ݶf做ی^">mm-xrݵÇթ{IMizZG =EM~L)Tu}/Jҳd3\SIV-%Wwh{({^}l|sSB6AStl,aN=Mb1!PTγ<΢هK]~T L%T9xE}qCVg)cɏ<{ԙٷYEF,֦fRg}d:С HjгϚfl'I.qMYiGhv !3CW ST:b4TmE%XP ^͵A*L?b6fGd\#-^B gr*n>-ߕ2@=yHĚI;ۤ5DG@HCato;^O3kR<%y%59!{ćӋ 3sYlfWDjטb3]8q4D%9)pKHho'{R3A(G@(G@HTI;Pw쫣{!Vw B8B8g9A&52q2q4NA&52q2q4NYTW^:8`aaa\Yd/rR3A(G@(Ge-3Jya&νk[w+;>>_299+n&3e  +{S[ʳ5.ĂƐ8XFFe*&5#pGX1*EfgNJ<λM?+<1{pNYI(uEU{s,RlV̈́#sZS1q,y sb̟Ha^Jw1E\߭ _@y0UCtN0CVͪpD@@iwRv:⮯>z߫oωzu,)e "> ^τYSXI|Xvzyk-[ڭ4CzRNdyfp~iK^VWWµk3fre/>KӇjS; 178\1d0"CVcUp8G4' ]}yXn&%.KCӮvc/u5ߊ$i9Qc)jn~QlNJ)tnQ{T9'Y5i?y1tZ" ø7nX__?|p,Iw%cGW 1l(è YEVf8GPGTۧϼscWL> 6J"U=/gK, IttPK,m;HL=fڒlooNNNVq DvLJɭڨ!&13$aFe*58Gf: '/>1W+VFFdREQ>{^+^4EﲳPDCN)ÉFw4u?+{ߟ߻_@vˇ8݇C薒0*CVUp8G4'.<}ξ|򳗖msb^9s%`؋~&vً&^[yhOz+tJՍ7&''#w%ӤO-m=HT6aT"Z31Qц2*9BG_zpsJ,HZ%e:oەsߋwoi*qIng/jQRj{\R>c5@.1rlFӏje0U3)( 2dY՚ G#pDS!ܧዃZ5UPdpRH}߭]\ 4wPYMբ&-֖7Kߏis%Y}brUZHPiQ!FR̐fQaD"+[3#ph#`B+Qzw5izUZaf=q'8BbvMwFӯmՓ~\̣1dITqeGK!1ObG6[˞?8f d/=lQf*8ZR#%Y4{鶽%XHDogX7 h5 # #q^;LdJ3Nˀ {V B8B8gEXLFghf d/jR3A(G@(DG:1PG+Gcd/ ^Dg>__, iG>Rv)q뭷[2??;h@R"^դLL#GOt.Di8~ ?Z&=S?S+++rڵiwxAR"D_ճ=J2gZN]EY+f5iR#p#JaYq?|o(H*E}'o[bWl.]J{Q :ѿĠyϱ4NL8"l8,S#!VСCm~tCE^ًEiwvv&&&OC-AOL7{yl90 sæztSr~sj&8"l84k=bɎqĵkVVVDrrxDJ3smzQ~Jd/" vNgggE(|Ql6335I?c/mqGZҪ`Ɍ#WrWĂ798:zHkD8wj_Zc햿&[{Izl[Jy9tz5lAJ]eKsuR1"%rLzo#ph#Dzbbbqq1e>°K2|aE155a:?c-|n.vEſbVdWaN |O5#j,Op'Jd7"q]yfUktub)dkDo#ph#0R6vd0BD4www>,?H`/.\ *?c-TۧϼscW0'F{02f~?~X'1}AҮe ·tu:;+͔ #p8 eVHZD2\n;==-P[;زVEC(Z~!;{>ɋ;|LʦhSGk`?IBRww|;qW5SDa{ʙP3Er:r1zQ ٔI #p8@4'&&7],,, A<,HQr__VѳP~^N\x}sg/-fN׍ UN|:*4cWj9fF3fJ:%{G#ppqV5wjv_vMd)ڏ /.̌}\wyK}wNf36>/&*qS;+GsyBDzݭhs9#eH:i #p8™&ZɿK$kXqj5>>*M qyqI LΧA~ƚ!4LMXGT|{WIg S 4<%-%bΚ?L_hW4ϓ_r:KWxG#pDqUYd0wދҽ&MGzTTSf(mCPg[]N/ֶժC#pL# `uuUnɻ"JjW??yb"=tИ ;KP ^s S헲ߣ\>iCGqOjDYBH}e%jV"0>>/¯ʯ70l"{1xp˹sY#V8G#|qDnN Ç[t]\\YT.{Iw塇*PL${u%m5eeN:˱j:OgTŽ_E%Iʠ! {V2q2:BEfbqR?3?#T.{rkD>%h^դLLښ_x}}}~~]b-\v@&m5eeqhٗ +91 # 9#.|6bpK1DX0$ '{~+kE=_y MNKߧ5i8B]:i!wTIH], ^PSWL\z>^̅B:h+{뫏jsbAlT0vGZOR߽n/ Bv{Ídߓsm _锭/,lhq.c햻F [+yvJ]m;{+;=uORym{[ G#pDquóU*#ΎMhyj~wx6xh< ˙D vǺ[J%]K9r)As {G#pD]=11Qg!jTkKF '/>1W+VFk/xvSkqs%~9b43a,c)^eľ.~gP3E=C[38G;BZV-_璄ٲK1jLMM} ąo;7^Z~ҲXm}Nlmtݨ aJtL8͐z^"]R').ǿ^˳KҔPf#pUqĵkDvuuu46"uc ݝhԈS3;}Ϟ) lZ)k?j":w-uui=O~uvv&(q8GT"uzlb 8m,@sUd}b#s)Ykkrd-w8P݉qsN] XG/@{JtVgwE S;$%h.ykzG#pD5qƍ9-`kkkffRF=(mu1!9hm[ A18qD#;;;SSS#w-i[O듓oP0Ջߣ'mzG JQ/Awt_?>>AۭVRaemڞI[fGԌ8b@ʎ~h...6~4]ϯ] 0@I[ B8B#D}rrR- $VHɣp5 # :bqqjqC5|X醏d/jVP&PJY nW.E8R+C>4e,8Xnx nC䷈f(tl;( D#(sssL`||tNLL0N {B4DSXyA\vMVիܘƒ "ݲK&nOKSu0Ru_r:55ŃXXXO٥333%j`;1 @C (7nhZN ÇRX і`Z]=@*QWSQ0RQ첀FÝKL MMM] ̺ڀT "V9pK8>>@8uh{aX &4)@ RܩYE0RElmm1ʅXDBhELNNrTA*ެ q}qq 牉 ԑ9.~KQ \zUČ*Wd/pX"] tV7nXXX` gffbNFBXYYMK 6vwwE%G g9rnF䥨011lB&U4)@DJNA˱*LD/("iᶄ`XJ#Ud/>-0 ?Dw%ynH( >+ PWkAj'E{GP:vvv&''777.H%155ų  {;K*pߋU llʊh ~Ç]B fmT4)@ >>>c/@Ӣ^XX( 8==ӟnWRb {ΎۯL2.8ue`{{[$Ҩq@0mlp,,,p`@k׮:tY!7UvA%Ңj]L3!HtW-C4h{)e^]F>??_v)ꀫW Yԟ&h ZKYI`ccCMW.wUd/)8гYv`D =\_>>>^v)j4eY`eJ٥;H5 $ {{2ңׯ_?|0@$m  "Ǟ+ 4)@sO302̜W{ VȔ]q8?0  - h.D;obb5677Ek7?K=99Iѐ 2C!]zl h4_~d2e>˂.f}@Vˍ`)CE۝. d/ Ӣ2(5A氻tMԩSL @SSS<4b` 2pdl-^ATw9mxgdZrOy&rMhXI/wQR"n"kAŤ&䜙їr8|pdW`DNH820ml:=ܖ\4(E8+ڈ/8eJo711S7E@@"/% %DLMMBSyr:ȏHB(PPyb=۱.H!B(W\_4 [:^Hd;g2<@9_܈τ$D"*DsKSOl@ҳU(A@.7%O: R'|A$ȏH&cƍ4l7]؃sA@aD3ψ>2WXk׮?#wy' ;;;&Ҭ}h @vQ" Q Dai4Qf/Ŏ;+ 4^Uw;fA3j(Q!*D50^Ȇ0Xomb`"kGoWi^߿NW Q'BTI@69 ‘F6 {s:#Ζ3YǞ9%ApݨwfecY;׾.a'cBTZ"{@" i@DT84NA64NDQA${ D@h!i@DT84NA64NDQA${ D@h!i@DT84NA64NDQA${ D@h!i@DT84NQaobY)T&xOǾ8k=w\,5gEN$7$6YTZI@6쌀}+/HZ|Ss)^}*~7Y>gύc_][N%kw^57%"IXT,*n;NtƊJ+-%Yv ٰ0M< O _\eFWً}݆7^Oik@⩏.7{{?^?_yן2*% uU: JNiPV%)1N6STZDid/Ek7]~|/ѓ]~E׾Nw='@_aev~홙߻;?x+r7-gY{ PlQ3JgQE7'4Xrlrf/& ٰ*|x'=wfg]Jy J]Q"[1Hc4eϽ IDR7w.f-|i?'?~X{++OIRYRG-v^mBY@+QmRZp-EeTrH/rsʠqrlFXeЉ΀"{@" |}ٽα?DVV"hN7J D?J4 9>LHnOqY;_Gh˿wW>+(jLm%JBi&86qfC;d\Qhx2)5 h|}ɠ^JU)JS+;W)Sr΀"{@" |`fSw_G,݅g_ݸ^0516o݉jicҷnX]glj4ewM'G7b;[}ǼEN\eg3Yyш=\;"QtLJcQ ,Se|gʠޘ9f+- 5 ;=/O+lmgwOn/{ًȘ6hFGQOr®vQY6O\XGgueFw/v~tuK$G;JmZMvGTQ!9J*~AqAJKBMag@QUpvV}す?+]/bY{XV|K%s{Gß|C|l%shb{{9FFB k`[nw|7^~s:_/?[|nYYjeܵo({j[iuVJbVE?" ӗxdlJPѻGv zHQkc'.XM]\& )ًH;ȴosm mQwܳrObYժ7zӟ<1bZOLVNGJ\ڃ\>y: қ6հf%EEF +;w5 bﾷ~v:'ޢJgɒE`E%mp ;# l8i@DTLښQA${ D@h!i@DT#e2nJ4NA64NDQA${ D@h!i@DT84NA64NDQA${ D@h!i@DT84NA64NDQA${ D@h!i@DT84N{/`n!&&H$허*!DTٗQ$ ٰ=VEXRi7@jQ!*a"{@DkmgG:{5A괎t:Ziemvxbocn?ا 6fE?uִ[~{rsJޕMS*5p!rJ^mkbBTZ"{@!DR v~<7x$/&W9B,_)BsBSHYQ5Ff?Ρg~Gk&@(Q!*D%*X Τ,KH pm۩ #*i,[Pbh(8<>mkbBTZ"{@e/@p<QtB[Ю? 6(=&%{)("*DUDEU^x.JJMrE0xۏ9!FizαمG? GX+BT z !B8(&VQADT8^ZH84NDlMQADT8^ZH84NDlMQADT8^ZH84NDl:1,%fq *`^chфq"*hc " q"*h ' B I'Ɖq " q"*h ' ?`!Ɓqp>1z4i"*h c/d-$mh 'I@6B&Ɖq"*hd/d-dEu,4NDQA${ d/BVM0'_,J`:4NDl@ Y67BDQA${ &رnO:-aXke ƽΑVg2-wL]X6ARi,&)qcyqnEgAPQ P#g="aԼLQQG c/j Ӕc.2㶻[:B?{l,GJc!N)oZȴ#bj،^ȣ?6ETèy)"{@,y sb9SBOf2Ck鶖E=;"~/l#P2{jJ!6LۡN*M赑uH zD}_>'ĿsÃYI5N#/'XIcko@9[q U%vctW/ClkPchƞkkJGoŘ'I%SRZ#-r]UQegP0K^<~+4&@T+RW6R0EEEIwsᵫ/ 2D~ä_2|͆8"Ow6GNKP~K+"NhmĎ|Jk#nDG2L䢇}FoR$*.D%EH z$Ej~wx6DMx3GLnh V*اߕr.Cl#Ҳ}+ׯ ",\.;%;bֆ*vX],7:UHnQm`="WN^|cWT6`q%1{ 6sDIyURaR +^є!)F~>Pv5䈔ch${QY\s;%kG7i* @e]>gJ-Qm`=" Ovo.epX٬>麭턴$}WڋK},k6!9&Xczً2Q)0唸BmmTUTy'{OH5uH z$E@;}Ϟ) l}vX2Guٷ9*ݒ&W得J9B ѻV H#PSYps5y|kk߸^*%@e^ViN!WF@T#y("{@(ܧ.m̱ nJ]A%JкYJ}򉶢Ƶ2ʠD^HU(Cl#tnJfku4R)b3:e̱~D2L:L;Yy k&^#=֘^ceH?lZ&h M;34^TCiF*̆ &^FE# e/6iDNIlm Mv/0&%n`lT6`/{}0FVѨS%b{i!CC3Ecû)Հl`lT764NDQA${ D@h!i@DT84NA64NDQA${ D@h!i@DT84NA64NDQA${ &#`U9? ߒ漀jϣQl-a./E 5~A yLQʉ}z<0*JD%Q!DE%D@^IGeM~24`{2ϽB-&ny1Hﱤ4Vq0#W QEJQ~>;o~aN, '_P&X]N/&{I,P1Bi[E_tX#0*tJDJ zD}_>'ĿɶE;NiܫA ETa<꽂X%R݄o)甧ˎ-,6S Xl\~;hED>Fҏ#,ծԨaX BJtedU`2< < #0BT QUKTd/O{7^_Rf+l )(}jlV#A;tÝ(p)~+RwٕlU)gZ$]JH!^pDy.Ԫ½*VLmwBiHxdŎB Q!*DU-QGROyX)oӎ݇{T a%h"|DQ[ޕlcЖa}u";wVF Iҏ#WP;@R .kP3BJɇLJ Q!*DU-QGR>ɋ;|L?ƈɦg/fᘃ!.+m3!Fr:r1zQ Iү#tWPm O&BscP3B}1iTR Q!*DU-QGR^wK126u&~%^䗑ho+jCue^:U(ړ_ٲ6V} r{m(wytN Q!*DU-QGJ|sSB6kx%8i*j7~L |VgM3f/[4NZ+į\ m9O[%^u *|'(hUޝ)TT MuebeMOިBT zGp(X]N/ֶ `Bo!uDDeJ"2Ca_M툰a* 'mm3B-0QIDTfH@6싀jxi+n9kD ܩ9*#* DDed/dþ!mh 'I@6B&Ɖq"*hd/d-$mh 'I@6B&Ɖq"*hd/d-$mh 'I@6LF{r* Ky]E,*u:;q.}^C׺M'.$mLOilD%jK"DT_JD! (&YW8A&~Ez}땽5{5 Ip0钍$Q LD%*J>;o~aN,3qzqtX/oK ˆ+d8"6o52d#*=DTQʼn$lD}_>'ĿJp^SՑ\q^Fk֧{>8^=i9rٔ.NI%zh/'qc햻F߲g%7QBWwv{:y(ևJ9Bv%֌E+jUI"^ѕ""*DUDEIwsᵫ/~7vr]Gf$G, Q!*DU-QGR>ɋ;|L؋o;'ՍM*}/8[r8 t建Ů$T0%h.bI}RԞGcGYm$%BT QUKTd/O\x}sg/-fNmj^dđ1Ț!N(# 1g]tMrDf&fwu1tl4%eQ!*D%*Hw>҃o=SbA̹ 7Z}6X;uh }/sӺp2 >uQ,$l#$2->R><c;10*|U rIT.]܌Zݕ¨JО]RPBà3(""Ld#(EDT Q!j=# G{6 oQQI!R"8ՀQI@6: Q/&,ivfoUIl!R"(QEI@6*+ s[dGQug&"/%Q ~)Ud/dr6 q"*h ' B I'Ɖq " q"*h ' 8tCcX!KQ@T8dQ@5@.|',񎐗IENDB`java-design-patterns-1.16.0/visitor/etc/visitor.ucls000066400000000000000000000160011312550536300224670ustar00rootroot00000000000000 java-design-patterns-1.16.0/visitor/etc/visitor.urm.puml000066400000000000000000000027731312550536300233130ustar00rootroot00000000000000@startuml package com.iluwatar.visitor { class App { + App() + main(args : String[]) {static} } class Commander { + Commander(children : Unit[]) + accept(visitor : UnitVisitor) + toString() : String } class CommanderVisitor { - LOGGER : Logger {static} + CommanderVisitor() + visitCommander(commander : Commander) + visitSergeant(sergeant : Sergeant) + visitSoldier(soldier : Soldier) } class Sergeant { + Sergeant(children : Unit[]) + accept(visitor : UnitVisitor) + toString() : String } class SergeantVisitor { - LOGGER : Logger {static} + SergeantVisitor() + visitCommander(commander : Commander) + visitSergeant(sergeant : Sergeant) + visitSoldier(soldier : Soldier) } class Soldier { + Soldier(children : Unit[]) + accept(visitor : UnitVisitor) + toString() : String } class SoldierVisitor { - LOGGER : Logger {static} + SoldierVisitor() + visitCommander(commander : Commander) + visitSergeant(sergeant : Sergeant) + visitSoldier(soldier : Soldier) } abstract class Unit { - children : Unit[] + Unit(children : Unit[]) + accept(visitor : UnitVisitor) } interface UnitVisitor { + visitCommander(Commander) {abstract} + visitSergeant(Sergeant) {abstract} + visitSoldier(Soldier) {abstract} } } Commander --|> Unit CommanderVisitor ..|> UnitVisitor Sergeant --|> Unit SergeantVisitor ..|> UnitVisitor Soldier --|> Unit SoldierVisitor ..|> UnitVisitor @endumljava-design-patterns-1.16.0/visitor/etc/visitor_1.png000066400000000000000000001337461312550536300225450ustar00rootroot00000000000000PNG  IHDRM.IDATx x Wƭ AĒ֒EU[,}* *QD4B*&( Yj})AS랚o:wrsC;}ϙ3gΜw9{fN>((((2K(CP(yh@QEi$}GӖ<(b( Zh=BQ*JPH-Lj(X%(JC; /BQ*JPܺ-ٕaz+UON^Q?^k1Tb( tdSK>[7y3$=젖~X2Z(J%V Ґ PݻUs?%"bkbE֭.fΛ6)ccj&S`ׯc\ٱsgOj1!--y%KTa1(6 DV6`R E*AQjj"K6N6)[F9aI 6<|joݻr$dYZryͲԢƍ36q#_6(af6wq88(H6Tb( Y5li-_MGʖē'$(Q0n`^bjjc75jxziMl܉ѣfl=tBQ*JPZ;7iUJŋ>xd"RXCӦ ^ݥ\H\f׷ A`ƒaf2^ooo4r FIA-9p ]Fe˖^=wOO5*Ϟ=xIzҥH&{_}=>'O'ԢCZZ2P섂c,I-Ei(PۻUo:q#ޜwL%K9<|OqL1Tb( )jukR E*AQ"z0Tb( Zh=BQ*JPH-Lj(X%(JCZ&PJ!=Sc~рF볰ˆx0Tb( Z- b$a_x6~X?dX9dYD`.Z(J%V Ґ>hRoFmӾ>yٽ)3ЪfMhg[P|թS==&{zbɟ?_2sSQl&PJ!Rc}䘉{NV6T)u*BW]+E͟?26v9(Hb,~ *;;;7HBB#ܦ͛Mf!aÚaeƛMFBQ*JPtH-}VC+E wg{m;5]uE?ؓ?^*gRc͛?|y;W~ӵkRJTdn]Æuurr zʎ,Y쭷ݠZo(6b])2^vɒqNLӦ^3yv1vlM4ZPQሚ5wE[&PTFb( ZZ벬_xZs‡apFN UR~„'N|)uVGo*f*^pѢvLB k" )4 9jԨlgWKķmO \}ٲ%xXpн {%1Rt8^(]ߟwFj!̙Cis:u .poMj*AQ!Ա֡{k9pV?yFv f4 }=q׮-{aú8v옏p˖%>uPt݋KJGK[XpF3۷wX1iƙg`:| ,Ν1£G,Wի`< B}*"ټSwȀSUiT9_ `_݊O?-ZԓE>p1ˣNLj(X%(JC:֡ޚ;1fK!]y^w8fmVhKyEŸ%KƵj@t[cG|1a1D]d12 y1$]/_+:RX`;iR ή0D6lR Cܰj֬'#7]:p]BQ*JPtH-,~}x%L,H|zûeـ7}z F< j\2ϞJtwB,[?j(WyՊ hMeZEV_=]4G̔)/%J?xdL$Gѣ`ΝMSƍ3۷X)TK/o2+Z(J%V ҐCnu[>prLk^ŽV Z{$ELޭa Btի7A/\*55)=Pn-dj(+'!߿a% +MjP,P ~:_vrL$OGGDL;zto?wt,nԢܹ-  :uI!\W&PJ!R ֭'qfO{`/)ѝK˼n3tɂC.`gWx„ǿ'ɛoxz ԒQ>>]LS{%,99ygDMiL-!\FȀG*TRWTis|q~\=[cR E*AQ'pֺ˲A=Vb0>FYϝҮ]VE~ /^*ۯ_MF|6o Z'c"Cz*R%=gl6M-f}(E.??_Ĕ/_F96VI$ ׬Yivm!RQ|nZZ|HFj(+EiH"*6yH?ϾMCᾳg(yF޼:*&&X ٰȑ1OnZ$%-CijU]|V5iu@ömfPPVZ2ۻ.Z5u[ݽɓQiݺѣeǎMԩ&^S28;;];ݪU_=^eErӤRU4%<|A8u*:,ly#kv֫.GH7Ze0;w\@-5SdžZ9ҹ?Fl)֞=UO z7,EI-Ei(OQ˸q}֭ ukFkP˘1dtLDZma+Wv׮C{UH-EI-Ei(OQΝ=׭c[LTiiɠjXLP͟?!OIi֬_lذ&|^"0GKR<'OFT0^jX}Z(J%V Ppo.۴yС4 "!ҤWqu-'Zn܈tԩi~LvN׮-|>XƵ h&{7Y>4^Ej(JU4E855I"#߹i'ORTC#Fl*oBQ*JP :4Tb( Zh=BQ*JPH-Lj(X%(JCZ&PJQŅU%V P>ku|BQEiBRU4Dj`R E*AQ"z0Tb( q4.q4.E*AQ{-Z(b( Zh=BQ*JPH-Lj(X%(JCYkO)Nc̓h[2Tb( O-Ϳ-x%XmɤRU4UjQlUw$&Y}?z֭oŧ c&PJnn˗)S=`7}Ǐ4ig#>u?QU"38fL~xp_o%[^Z(J%V ЋC޽TK~$eQUT_q,U&׫\5P˗kn+31g'OF Ah(kR E*AQ2M-w.,s$Ѹ 8&%'$,yz,Ysgw!ر}ڵk^[rX)$dx˖E[<<\+RnG̉_nK; ǟ֭zu-jwTdhMQN"+Uz%8xdJ{GaP `o+WvO;C^ eIxo&PJ!1rlqO|,*;̙C *غu?[Ek;K |ynjCV,X m=Uٲ%cbeC+hӧ+Gu[??_`Ϙ1)ܾ}cD޾HO?ԫW@?QiaCI7ƍ36q#{Ϝ,39wn5\~El+ӢE,[I-Ei(#jFm>ðH㔇1rdHbĄMlذݻ0Utc[j _|1UPV<%]U@-IIj֬"ϝ;CkԨ,TZZl=}~XJҸqm ȫWQ¥KʔqP~}]jŻ+5Tb( eD-g J g; TA{Ep]S?d zrJ˾x1]{%r^'/'N|)EsCӦ R`I/(y?*; ^V24샂@\x7?rddڵ_Zeh@%7'Es ;ujLƉ&vv}trX>ey"g]+Vɨ'ORjժ*.Uĵk;Ew߭xo&PJ!q[g`8 f* DgZN< /Y2>PM +Qu@wvvx+Dzn5jT={(mۆ(cC$IA-ii !vݻ9v../YΜl|u0tt,~^wVjR E*AQ2\3&&*믃7nk?>&!ao4 ݿI9ΆwMgm+QQAr~Z(J%V ҐE|~ iƌ!!ëT)/$:j֬I ,^$5Tb( YZ+Wv];}:#W\+:zvN˶Mj(X%(JCVBQ*JPH-Lj(X%(JCZ&PJ!R Z(J%V փI-EiHrNBjjRnѣn}kvM Z(J%V PR%&VM>$$,vss._L2qXdF9''>+XݺMWc}:]_\6Tb( e/E._nzy2jb+ **(4tTv}IJPLS 0^;thMfpl\??_9--dPdJ^ &XA֭vZ˅ qvv9`&DRҲΝM\y:!lSVUWrG Fbc"i׮{4޹3T2HRS*T({NV5n\aMjA2XI-Eit?z_,DS;txKw{I_7lƍ_~P3UoN 9sHB[nu5k> kpܖ2en 9qKkvbw/o01%ì @L/nѢ`G=7Yy/ejZ(J%V PF2=6|t3a4%&9:y3^VlSr=+{\"_ ȿ`?bٸqmW~#CCXfꈵTЀ ּ{7ƶ+"6ti{Qrmjdߤf{1.UBQ*JP23%3oED6ݰ!Xy?y2eJ''ǒ%bL-9+ ]S{[€G0n\ѣ{U))T'ʕ}bݽ%#|?&I2{,UBQ*JP2y=E;""UѲO(;Ԥ7Ғw_rԂ~}enX:̜9mۆ"s'AEc;֯TA6oժK^{p! %)pޭVd,2XI-Ei(#j3;p|`]x/HUVTB{wxԖ-PgUR lgWwvp C)cb/zF߇+Vɨ'ORjժ*)? 8u*T %yZ## rVACR%])^b<ٳTU}eY6Tb( r>'@zjեKsմNsvvj׮zb%m۰Pѻ׬Yap ᐐv../>sfGx/[=1~]ʒ%caX&%-a_cq` NN&7Y^`&PJ!O>O>#]ÇM\%l$qAit7ng&{믃&]>o߶ʘ\.@TTE`]&PJ!=?~Y:k4iuBſ]BQ*JP Hq!+,wEGѤRU47֛I-EiBRU4Dj`R E*AQ"z0Tb( Zh=BQ*JP@-w$&YJ?z֭oYBUläRU4Ԣ|yUӧz ܜ˗/S{;iS.d"Y‡uVZZrv@YRU4Ԃ>Wɳ'"T%O,\8J5R!|dDY¨QZ(Jb( ;7#`vΛ6ع~~\iiK,V+ UݺNqB]D$!a w-޵Xd>5rwt-[xyU2e"iŊA9q~ڍ٣tidrxTǧ&UPΝ7n\a[aG/_ߦWP aZ=&V Ґ j9'KYU çvwʕ? 6nٴ׍D 3g6˫nލMO?4sB nGVյk;Idd h?fLo0a>ضmٳ_-[2&&ׯQr:}:4p[EGI ?c`Dg߾}cU별XlѢ`Gbwƿ1k|:իYΝR֭! $&V PF2=6|t3a4G/޻KG7o˝"U}~X_*bH~zĄMlذݻ0pU0zwc[j _|1U0V<%ӆ6 PZ͏5(Ku6t[ E|߾mWl@Q7-bwo_i֬XZ(Job( eD-g J g; T%maCǧM׭ PR qc|ٸ7{(s"oT.mC&xN 4VF^/F{2^3 q -V%{Zbb!m6._ޞ?;w_aѢ1r ׯ$P*AQʈZ+0dW  R+:UP޽D%Omٲ>:ZtD샂@ʘŋ޸A#kE_Xd$&.a4o^O0V w1(Fժdr(Uĵk;%ÿ6,[=K^oL+rdԓ')~jUU@ǏGN6%P*AQ21}V-O 5ժK",wii]]9;;kZڶmXPAtk֬0c$KC^^n Fd&T$25 }|zn5jT={(@.wݤe"R%XH''Gē귀CB۹ d9sf,^2Tb( e/(_jb?> ތ{%G!uò1czS-Ç:tx+--9y2dkR E*AQ^jA|vӫӺu7555ǧOwѻ'OF Am鸢BCG=^4OR E)V Ґijsx?ki,狞[$st%KTaSuk*- P)ʕ:II:w.UoS#ĉ/kG]Jv@Vm`kለiŊA&#G&^^nǏG[̩Ukѣ{],#BDkݽ{&w&q*T(+jܸ6w<.hפ2!V Ґ j9'KYU çvwʕ?6nٴ׍D 3g6˫nލcKL\"&C61k|rB\^Zn &1Ο?_H_ZN5''DŽGC~kOF~[E/+gX@3_=q ,(SaE{NEddR~̘ޒaDI@H n ٳԖ nѢ`G=y\/kR EEi(#jFm>ðHe{q9Xxµ5zг>Ld>Ls ^A0xW`Ȯ@@*{+VtB|^ZçlY^=Z`;¿tҥ\];)=<\?w+rdԓ')~UqV{ ;uj*n{t]KFSUME pp?rd-‘kCSJvmq{|j0dGU%⚻&PiJPLmcU~v EdzҥUZZ2zSN5Bߦ\*TP Ș8W_'C)҄ sqy]3_w$իVFٳ/^$^xl2{|Gb,vJ0Cٻ{{MJZ&/qtt,LAQ~Jk5LU4dgعgL$ȸ{7QseW 6r{$Ŝ,"( 0Qm㊊ 2>.M>.]&PJ!~Y:kd4p!.Bj(X%(JCl+,^l뻢Ճr¤RU4Dj`R E*AQ"z0Tb( Zh=BQ*JPH-Lj(X%(JC( 硥EKEf̘a"Pe;"P8(>A(*{-EeH-EQEYH-ExlǵPbBQTZ(FZ((Z(A^ EQ(R EQ9(k(*P"PEQe"PQrPBQT6 EQ9(k(*Ej((:Dj(*{-EeH-E8lrPBQT6BQEQuBQTZ(FZ(Aq\ EQ(6(Exl((P"Pʟ?@QBQTO??-] lD(CrPo߶t)(Z(Ak'Ot)(Z(A^ҥK.EQ6"R EQEQ!R EQ9/Ӗ.EQ6"R EQ9ݻoڴҥ(FDj(*{1K(l] K/YtEYH-Eevzjؖ-[~yV'Ep$l֭[7on?ty~y: I-ky윔CdjJR25ezqҥ/\T/b"Qϧ|ZΧI-<;i=XyvR֫!C(cZ8sZhbڷo2f޼yCTy; /BפPzz?,Ǵl266ւECy_u[2>+CW^9vW-~bRKΚL"&،&M4qD~bi"QY O|7ҿO nތG855ǧO);֠8L#m&SӤɓ'%>l~Qժt}|HBD4bŊԭ[]С7m%RLu_%\cPqiiv(YXJӌAQx77gv$Ҍ8ڤ[}$>l~Ǘ_.8}:Dl_*`đ#km:%Rvʕ4޳gi5& 9l8iS7eCgl6`?|¡j,m[ܹ;~>3V*6oEcHrF(?Xц߾޽D\::5f2@ OO7Ͳf[}~X3F6m:zmBI]/^ttt3V*;7iUJŋ>xd"RXM6zurJ#q͚UD_ߦ6!||KɄy1%EÓ')Swrr݁)1Hp %viAj!S$SS6-ZL4<[_}@Xvʖ-yJ+&];/*T0--9"bZvkU[Yzh٧Ou$sd\ar Z ʢ[@w68&%e CPiAjԶԔ (,,D|JeGp`yz]zJj._S[DHS״&^tkc"%RxxZ5YR 9Omٲ>H٦͛`WN3l"LvZ8Yd|6/dj4hKцZQG{zў={hE^Zu\M$=qZ'~A3@ B2g"L^Rՠy}{7yNӜd,>Փ1yĶO-&LֹI-4iR gEL[ZhZӤ:ϚBפZ2\W䵻BYZhԒkCWʞ=K3Z;} 1E2L_LjI-~Mjyq[jR _cSԯ̒mr R gMjkRˋ؂ZHϨĉ/k7rdҥ܎T]n-]_ߕӭdb(ر}ڵk^I9#+۷q˗.3I0H-Cnh@OYaXTBפ'Q @3f |y;۾ӗ4޾By^D 01С `۶y {{S ƻCe˖Dn܈G׮4P& vжE_O$Aѣ&O(ɰq|z!o`(lo( щHsrѺ2-|Z^$%-! ذaMd9U2P EߡMfժUU$p!uʶI0H-& 47Mi_ۼޔqhՌm3&4Sٳ_y{-Tx}_:]+S8<2ѣd w ?xpG$iNn4`w"k}QKVFKK13G*$7yI-mNj!)iD?qw$)OJ@-" AS %[ԒqNdr=wʟp*~jt(0OE͟?26v9(HbLLjYٲ>$d86oM9h)8;;a[jͱ%K ڵFqԷo۫WjU'9΃NjyA[jR IA-2SK\gZﯥKN@-hnɒqo)[lLLf69 %#Y5j`ćkesvMcZŗ^*$n)Gh൒%5kVV{Q:4+v4Mz0][*UZ5O?H\޾vW 8o䌚xN6A8UfP ر}d4ӠHjU>?iZpTT 3' XD#Nh4%zlŊI"f1czV7v*X\3%AeDς A$ TwmFț82z,+QBfV&R|fuor5'd ӧueYZ6@ I2psN*nMjȇrЬcO_;'%,b0C$]*7zn s綈L)SH&!^~Κ"Zx0?A!X9;a… *yHѠGס#e#_BY~MflPKY7S bM@ X%pç*tW+,XM7,e899mzL-&n٩YEMۼI-&֭'qfO{`/) =cǞY4~xZS~ܖDӍU$aL-Jv@c=T XՋMzJx9u;RWTi`wJ hA d ao(}ٹ3 p!Tjx{ijQY@dψZkZL 91ܜS'mZLh5uezc`|"%k׮hO {uk*0䭔mO?ETZi#ͷ>\.m2&??_ė/_F2 k֬4:ڵMf}(G<:Z^<3%Q=@02]6#.j ǧ j1psNȊnچMjԸ6yH?ϾMf}hU %_zA!f`ǡ_e؝jJT3GHYd?@x̙Cg3z*R%$F3MPdɉᙞ:u5ܦc)cĎ_#6Ǥ:Z_"e%aPy^r`6pI-9KLxW#A95DFnR g;ji٤2įۦ3_q4fIax_(b@{h<87EBYZhԒ>}7Lٻq1U|6m/"%$nR gMjkRKNxypʴw8 8hLrzbz fؼ67EBYZhԒ;0_#,+bq{_H#7A-01D^"MjI-~Mj zwCv&q>m gJ-2~5ygnl7E=~{8oAϝɝ; ʤZ&~}ڮqŬ?>{-B!aH&LRK^"Mjѿ5/H-'N|٩SSLjsȤ~]7zwu:$ˆwٰn#BOyZ%%SXH&EcsSdI-9m3Cvnٲ>GG ֭ER2$OX[V'`U&^9l6o֬Ee˜uvuhժ[b/Zn;pwؤNjY(ڵUn(L.w/ו&d9dRKNwƿ_̧v+`yČgă`מ]j !vZrS Saaq׮W]2 2F2L*'޽K 砼{Pxi'xjA #6oT2UL, ƫy QoR Z&,}/' >=J]6b2#@7ިSZ<tyg֭!"~ j37 67Ѥ`8 vҤ~_}i6oBB\k,)x#QoR Z&䜁&9~pH>}(AFEǎ#mO-$nRKN{P1?n 0dxTiiD Et&M:Z2"foذ&|^"0GKfB* QoR Z&Lt27 asŋqϽ;$̴ M&q tiFСո -}//7jVZ^յ~ZxbX2t=`q;>mqq۸qm2|hw"HyZԺ55Mjˏɋ/w$dɓvn*oB֯I-4iR gMjdjBӚ&y֤Z&дI-t5֯I-4iR gMjkR Mk"UCHEQag 2fZWGjrsEO~ZΧyLMAJ։Ί9E9Ϋh"Mi婪.tkR gMjkRe.tkR gMjkRe.tkT  ƥ|]yu|KVkYs :Ϋh"Mi.thR gMjkR MkZ"ym2~oy_mK&55sjiMo+@_mK~qj!S9eR Mk*EVݹ6[/mELMI-4iknn˗)S=hkܿ?n=իS&M>l2GnDUӧzthupټm<,"@?i*sظqfӦ^7ndufyۻq``[eSߢE=2?IlC-D{j 8kG]Jv`kለiŊ &#G&^^nǏ1KDu};7EУGihf7{lg""S>Zʕ(_lܸX h.^F͚kq-mذ&zۊ.'{D*VpJeP=+Wɗ%Tҥm@+aW?IlYLzϞ84jFBBԩ䘐u`Fמ>Sȑn} 3D1c0c72`vΝ"ɓekHH:LMq޽{W ,]7hAA{ga4?#/ :߿hxJyeܸ>RRVO/WдRP*R9іaZDzT4R_ߦ*js #G"M1K*@oŊ9-[VJGJj RTkvʋ[mV5j13hQ;ѳ+T(3LZqN&X1F8);WFMdjdvΝ]yͱ2x ǭCxX\UԳ;kYd^^nFq׫:twqvvj׮ѽ{n]7)i#OGIbҥppwhBP˂8$ΝŽMjdvmAj18:[j]$"Oi `"Z]o܈h\ 2ͯm1:wt q%ܷo[ tN8k"ĉjE0>'OKCP VFٳ/^$Mj]"۹O-=ao6Q54ce_5иjm֬m…8ɆejfjXEeFnORىunRKVǰ7CqS5?~u֮]eW5ǏG&'~}Wt:{Zh埓]yӦY";7KSC\)x(rƍk;I2(9BYZhںEk$ڡ["ܽ+WN,2r @Rq1ȳg2&5 E VmR gMjk+s&gw/155ѱ͛YBdO7IFs\ePŸ Vr 9.^ e]Q P9o9;u"= e+9DžuE-CPt'BΡM:Qt5дCsnϜZ9Ta2S'ʛBͺEPtKS : L6qvDZHΡ:325RgNDj`Qġ[h\25"gNDj`RMCuyL SBӚ&9]osdjԢܟ"S[p66LjI-3Zoyjɹ.rr #JheZ1'N|ٯ_#{.LT 9Kh{eZ'tP-Y&׫玶FʳgsKhLv EI)*8B pܜR9Kh{eZ8]J(mx(YB64|e$9;;+WRbat mo ]Q Kn?sj!S[ E 3Ndk׮3PW #JheZ8]Pt S Z"S[ԉZhC%Eɟ9%2NBC ,mEϜZBgNDj`Qġz-mE7k4.Z"S[ԉH-Cjѧ9ݶ3Z%m։mϤ͡ }VMm։tR5[yPXq:vE"S4SD{%G!O7g}6s\6γ)jm6O-Y}ZnpRS||$;K"OacǕ;kZKܹ-uKM̞SB`Lgȸ{7і+w& y֤Z.j.卭9Q ׭uTsrrLHX|:͏79%4gtv ,SdٳԖKʕ5H-t5֯Zra 0ͽkNԀNDۧc&"lZМ"-Sdq yZ}ȶ0?I-~mEԒ ]zbLaR53vss1Ӧ ?=U*:Zk͟SBsLgPNaK% kp(:~躣kgOa2sۊ%&E_ѳ+T(m5'jPPw79%4gtv t\¹0 P -WE)j!SeNӲd,]:յܱcO*U9QË)9 D[H)2l츤\XC¡CsZ"lKeÏwe'@x_}"N|NG1Ez,)9 D[(Ȱʝ5F-Ρع<\j!SmNda&N4'jx?,&fȰʝ5tE-.q(3PtLMŶ;MK'Cl/>E>;kZ8]PgS Z"S?>iZlO7E8sy(zBlwփuE-Ρsy(zBlwփuE-s(?=sj!SeyEqEQT %v$F"V41Dk`.(P0b AQb-o?[łrG&rwޖ_^sw3Y@`bS- ܊L܊u+zƅVzzvZ`b0X bř MlMr;S C~hx7jџVbWASb&S-@Gn޼icc-tC@L »AS۠Z䇿ݺuU膀" &^j˗/]4rL AȌ'~W Ɂ &^j-7oɁ[сP&.3jyѲeh[:!dz'B˅ j֬ B %ܹ|rL(P-^ {J&P ܸq#::ZVT _233۴i#t+r/.]n@@@@ܹs[n9;vWVT _۷ j4j˱cv-t+r/+W;vЭdee%'' j4jKFFƁn@@%00088XVT _w![P-P-~INN_n@@7**JVT _vyq[P-P-~?sЭk׮]B Zwy[P-P-~zЭhѣB Zf͚l[P-P-~Y|n@@ʕ+B Zp'O j4j˼y^z%t+r/fff/_9ٳg Lj4j T _LLzZ @_@@@Z//ЛZ/P-~}-}/P-P-~j k &~j4j T _p_ @_7 T T _p/ZZ _p/Z Zk-}Mk-}i\k @o\k i%Lԡ/Qh? a/0I >;2A0LZo&P-r_1(e`|ľ{ ?iZ@1@.jQxTA1]բI 򲂂>[z:d& |gfF5n\KՋA\k@l;AiC57G~ahԻj>g{R(޽{A }~OL)5A1jբѣk;x{_%Sŭccs,ݴilm e%wZ륱[sg/'99Bŭk9e՘Cͦ;;Ӊ4fJѭP 0(-{P* ^ݚ$ʕmHm;%SݭiɈc6P &퍉ճg[Vr׮grr6έ5ְu]M9sfKroWa_|чNNNMK u0(XխoG^|ׯkTwkӧ7+$a.>++ǏHV/_$bpqq6έ5֐0NR/24pF'BC'?W{ \kR J5;k4$|={kZ݊=KגyyYqRnذ+~˖ݻQ?daaNeJ[Zc o9smyR CŨt t"t { sk *bA)C5yPdn+U>|x̨6|Kׯ'*eXE Q$Y4dƍA1{*LH.jJ[k PP3Hv7GFNS9rd5NA~Rtk @eJ&bP1^!ۭLgv虵k;P%{gn2ɨLj |Dy}/Fi gFXT T*u$V8xv,//իL?`1#(j8բ OnMmv݁?؞qK56kݳvP.{._߉McC޺RHۿ5{NB5{|,@FDZ:%U۴OiV2|QeADkP-$;g$NnۥMk&y޼9lOA 6>~Pp)A @#Q-E^ݽ)I6mҤ6 %JTh?TLբ n=dđ_|ž_si$˗/kjZ͑ɓPʩq-[6С/D̫WwQMB'8ؗ~+ONHIY֨Q*U*LY!ː{O?P˫?*ءCn:ac2={&nhŊQqOyؔyd&DʕmX\TPQS:$zhdT or]#E5t1#aIhiK֫W;[RWd&n?'z|G^Km =0˦Z(4m c t7m<3)M^2qqACxUjlTeiv,}=77m OgD4G54i0-m^"TZBkbF!qȓ"!}vuFNɘYʪE{j@ZLMKvʕSȧ*+ީ[~X@J֍ڲ%L'uܒ3jvGn-!D5t1#aIhi CiZ %9eT\LHBCƇ[=" "c%zܸ~VM^NdAZ %9eT\LHBCƓ['-usɠ_~:w"z-x^NG-i޼)71}^&5s>f+uK2J:$"ϩl-|6L233墂P܌jOM"B*n-!D5fJ3[埍-ƌ܇yB$Qqo+gA}&ˡnrBB| bJrD˨RGG" inM5гQ׎5^)M9*ٱcH,Y\Es?}zKTkLeR-yyY>>KޚTϟ߮EGl͚U)]LӐf['" i˃)ڿT 某4xBW2ISاOR&߲ *䈖Qr1AF" inMtȱ}>^8^FggoNָ+77$ukc R$V%'glF㋧k~i\TB'yJ{o0#aUh~{bBnEwz% ͂.h"-Jba$4lrkX{|pA˃* P-KөՓaQ~an'ӛg ~a#(8.P_qQQAQrY jQEln +y/ ֲ<({D4Sc3ӧjeWf.]: ILAy/ ֲ\dAz5KS+W~`ٸKܗ.%I=ZҨQ=J,?u{tvԴdv'O ! $BݠZT[ǗuyP4gK.ŖbKPTlsZmoJlisX<;n }'$0բ Zf=$|˃N2k֬\W_/bz>x(vtŻPpmٌ܇yBnP-ɭ~qqA}}Q' ~.E2#%EZ˫=׶m\{ 9{'ҷo'Sѱ +Ʈ{,gFK' ~aADhT*rr/ZNwK{|IpQs1rdO:/RlsǎWMTVaXѪdOW]Zʕ033}"6ZZb6#aDh0(էcFC"ϻS$@#=}5HJZ8d'mԨ5SiWvEr5޽(4 )'7D-ޥnl^g˛7 ةWvMf Qm7l}*~a5N} qB<>݊]ޮl]I$WQ[kO souuuf6c\}'1 JzѐǭcbfΞhq)/UߟȞ*eKHN'VАAYsM3g32"IP.4<)[_I٭wm'- B<>^+c./`eeAgWi˖ 6m;)<0cŊwrAtDss3ٻWC2#aOh`P*АvǭLqc9ztoYE4yҤrĈ-اOٳtZ(T:};uQXXR!{ ֳgO?lPR-껨 +xBRQM +xBRQMfb=x| ‡ExBVl#4lpk,{ҥK/11˗KLJ(>L@@^A= X E LN*::yyy+`@a' O  xBVljQ|Yލk.V_`{{iӦ矚J ߹(fO@>yo'4`6>]ɲW?ӧOsa׮]S*)-)2Ju: JeUDd=>f"Nb3B ;v|L/ѣG?Af x? .[K={@#gLuϝ;׷o_sssҥKچ=lX/[U.]v% WҲ4E¯pL0quu>yߠJHߨQMG*>j8[[[RXɧIuuֺnO %Z4#j0%)rXZHUZdZ T }'tү>ii+Pi]p˜tG i7yxO<trrǗ.%ZYY|7׮%tlI$5J0 w&Mjږ'-FR/^dh{\BpLt͙3T)S".[@IqDʩF'3jQ 65$-$tv 6)S̟n"Z9Ĺ19{,Y`(ٳ$q讀)J ڹ2@pdw$j!2YoF@c9~=ePG̔kܹ~$8 z«J̜9\n-!t00O2;zt H%?5H9բq=J(4lâ'욚o_+mRrW2˔1WsVN"kV,0 >L%WTFբeoll`N(g׮ 814哸6IJZعsK$ZV-k;߿=75w,| 9*j$ZB@܇yBA)fO6 577;{6^㈔S-\)ѣBCV[N9<,%8lop`JA*VX[N>J4,yyӛ߼9KCߟ{}- oowR4ɓq?(kڳ!!eeeqJQg+2ro'1}ZnDRv ęvBF}枂yz- P-20#aeP0+$qDʩFQB!`w:5ia!{(AMYZHcX~x8 s$;Ο߮Mps\)e<{wVL#jl CrR֮·U_TV-MW4IT>=U߫Z(K2ݱczf/_pk QՂ@EjF<ˠ!!^=11zݻwS4H9բq=J(4l{|] Mɲ%[T~Qm*)Ui*!ZC#vQ<?7%͸S_n-! Zh}'thذ H8:VaFszBƣG W9СիtT hrd7-ڹҠy_Tբt޾橣^$oe}Dqș\G iT<Gw/eYdsFZt_'|XH{'jQEn S1#uH7X>,V$ڽKtȓA"Q)}O(HgrM:y‡ wT*pk,yyYX>,NнZT[ePjaт]բ Zf= &Vt20UҚjy ja"ѠZT[1];ׅ +Y,ӳrVޖ2gUcK22"~vk S)t\SmyoIKʔ1?{6N j p%I!QfX 5΂Oi/o4VS֭5,όU/m ek__/iý"1fttբ^- +ݥKUKBBBFj9qûuFӧ...wܡN6l؄ *TzI80\`PlP-FSܹx+ǎmg%1K[uL̬wSHҗCzrqqA͍уu$z1Sw/e̘> ߽{x v@5`kNt)Q]*Vڹ3<uV<ήTRLLݻw{A ]}Y>}!xbŊwIB S-YYYAAAw}vrnܸ1bĈI&)/,YrٔףG}1`PTcFCQO%-žE{ "ǏoTω֪UC:AQQ){zeofͪ9^\I$''2,YOjS&" rOIe*(tThގ>+Ed{CjQGpբj:[|x۶m5bk׮?~EٲeY^u١CVZ,--Y&hժգ|Ο?_^=Ej)_<+ްaTAF{DYWRL"0qԨsf$I$2Ly_48 LzvJysd4, =>~.n$##AFnݾL}*)-[BH65ýݔ)CH]GjQG އGm%BBBF(ıcǜKѠZL9rS-=1| )*J\~]~MAR .Fcc3s"j{ʕSڶua^ݕCҹsKrY@}PΕ+?[RVƍJ[fٳ|K9stڊHڿD  o+4Y%2p`!C<7n Mpo|$ZMP-@ W\#˗/\m۶,իwjQ-˗/gw6mTK XfRRRΝ7+je(Hv۝9_m)S̙-& \=4 c6PN\\xv qǎyT[p/@_ҤIpw$p%cbfuԜZE!ѠZJ(8i8B1@ fuY%OVͶjJl䡱NТ@xjQEV<믿ʔ)sJ?>((ɓgϞ}jɱ(GG~Z6R#JCYVřpٲe=KW_颟agg{MјCN9͑g#?{{[KٕO2j?TcjLnI^h$<|CejjEy*I{vO};rQ~;:;R$t EX}8""ҒI׮]޽[HBXbŊժU4hj!V\I5ӁϭB6R#JCYBPɤ_kGԪ0ÌHR*}~i!K'=z:/PY^ϫW,4TKQ}&6Ňsss>|X_zc-^~MJ J1(zѐWH3Yj.aPf>j1cJ;߹wǎyk~0sVdX3lH۠ZT[ÊmF܇iQ-fff&0{lL'40(-A"۠Z|8XT* Ǘ-[+33She`P-e`P-}2XTZ .YAZVVZ%$$yFh0e`P-e`P-?,*@v+,$\j֬jժA]L{AAhX}رcÇSRgϞ bRݻ E5biLSlf6@ բc]Ǎ5Zd s9??2e^REբn}dj gg{ثYz4(,(-5GZL4@ բc]իvvvvRATբ.n}$V*/V/]:F 2]SqHg"1#ͱ,qƂ _4(1T*>\sEsdujn%i[ iz=>G PiČ7ZLN  JuiH E]fj?slY;U:rd7}^R%İ3g4o^ɎU#e2? yo.?h 0(ŠTcFCˬQ'ѣEgS>JyhPbdg1Ѡ|MeXf^}߿pvv7 pe]b7@<բ.FϟLHOUs̅ ٤nx E]f*Ο$;vlCÆ5G*~oM U'N__/N,+#8?ĠZ `:ZUKTTԧ~r={F/^X_nnslR] jQEY? c.%`mBIvS\܄^нZT[Z䍋)A9ɓ'~kt20U0kTf((C^^"/)GF+ԩ^0j)"&P-7>iӦq7SH޼y3f777= RT0(| JH^Pri{{{vE:;;_rE/@H^x# w$XbEj/ݫj@/ `LnJTؼysZ $yZ-z+{Br=<<4|kT @ׯQ>5p{J.<P==vm_Ŀwk!,TfK4-8[jc'☤Wqݺ k-kթSׯSf.FQϡfSUNc&T 2ad{Ruk]%s7..;͝Wl$}vdi-86ZYYY4jXCnn&I;0RH9hP-#}*+ܽRO S-R??2{Y=G @ &fVv^Y[[mh_jXt ڳtС]nӰa]^Q_XÃo:ZG_Q: J 0@xv״W޷>d&n?'z|k-̮_OZrJ-nHH>}pҤd*T%;pӦ`Nq@=J$q*Rfjj,ͪھ}mca^|qZ>â>zwƸ-3Ϣ]=⫭/Doժ)S6O8(,l,%jv )م ;jaWGh_?qW-pOjU35-٥G$J0qp̩[~X0@xC!řTKA52J:'&uކIj[:mygfFA ?fPk4q zFWJSdavbBnKߌKk;p]O>?֨Z(Kʗ/=]K yyY>>KގL?]j szP-#sG!:4Zs??xŽgwLy@A޻1111qeKY#[idE:# IB`f`֬Y=:MOϖcas\#xhP-c =zqrRB֍~MүA`f1T a@Z03E@ xOe?,ԩor?. j5jTOJ=9mѢ۷*nHFmNg+ٓA" ̙HR-T9n>^~urZwm'-Z#2eʐѣ{-ZԿrR-& ʹ#FP/קOٳtZ0thӇ1Kƒ 3lX=~igg{eբSPP- jIND˗wN<ԩCiɓ66rs3IR-ղ}ʊ~Q=I:^QCQܺcrns `R_σ$>^PȈlӦ=>I/=zF/wA` f99*yy>a{˼ysDΔK@ LBҧOo9'%ZnQ6R-I͞=T %6o(Xj f\VBn\Q777;t(LM].Bvqqvg~ޭ[u?}z !asj:ujjP?,66^=GKM9uaúM0B+ɷxsSǁ޽Mrrvբ;]|\ہUKNNzժ>L\@`0f+n)?Zyd)%hS̙3T)SOϖ˖\e޾\E\\Ѝ?уgeE |E.T:11̙-͛sr+sI;}}(Kɒ%HCPI??=P\eQ=좋բ"72H T aZ~Z= ^j` 3w-`3));^~}/]JLM]۶~ys0LIln^QRx ZE~d ϞےG`E?//C&Wҽ*R-66BB|WTKv׮% (ST 0@xQ-d{6lvŊlbɸ(w/eYdsw쥴 ZA@ P- ѢZzM?S#,m8w.ʱc~}==[*T:&fݻ)={svrrqqA7n8bDL>jԩCK3{(jˢCѢZ%K̞=j&}УGҿ-ʵB eb+u]gl=~z%/&XYY|7׮%QmMMK}=Í=ez .ρ>k׮~Rz=ѻThsg8 2yP- )HxۏGHڤL2ziܸ"idg9ZjH Wϑ RL?N4eo1~բZʗ/2W7lXCY(QϠY*{4W2!a]RBjJ,oӦ1LnD4thufp$zHiSSIi{;:th҇ P T!i!CIeGяk*ڵse!$wԨsf$Q]Dՙ+SٳĎb33Ӌs0S%M]ݺ R-xDڵ=+͑3ږ?~ JDHT #ޔ3*CU)xy߲%Qo/i{)S]Gj@(fOAaQvMͷ6)SLll`NIFo/]\9m[V]a9II ;wn?Iల M@9W`jZ2''׮%!*nsޤjDvƍjw/%77sϞNNv+3gL׮؁7nXÇZ+d8Ӑ!7Ѧz[|w˦MP- )HN9<,%8lop`JAe,gwvgW,kK2gl>W!M@ر Ըq-쾖;Qm"f7oAƦ,s̘>[7")~]E62[$JHKY:5VQcH4(z/KҧOo~5 Z7/є z@jUVbi{'H=O:˫=T B0@x܍)|פ m_n7..;͝Wlg_ϰ}׮MјrʡfWWgvO xa) :T)SQwwoe!D5֨abſw WpMj?TcjLnI^h$<|CejU S|Y)-@t۷#WL巣XъΠA@ 3Gg] gJTTț7GT2ךMՒa`Tǽ{)*_M+5pW_ o=J^ Y!*m.ȴU&0ѠZ03G<)_&hyyY:4Hڵsv-wj ;w1O{'23oj(>~.j X 0@xZd`P-"j T a@Z03Ԝt*"٫ A`foG|y+*VhլY' :Jy)"٤I#={4|`P-£jQy,)RK'֨aWQTƍڀӧ7Ӥ7ohĠZ03Gj:y)[џ{qsgozjoowR ^^>d١Cpnnfj z:p`ݻuk]n_aO6>uaúM0B+WW':06U =9{6ܓ}rrҫVЦM㌌H4@$@ Ӧ}2ǪzCm9srxmx 0@x R-kj}MIU˜9cvm2oD S7o^O2I緳ǎmhذ XMBڴ),&f`oo4=}5Kf/_-T ahkL0tb99w-إK+Xz۶P+,McЮ,ys6XDbP-#={noo;{q5j޽eu]nڵ$7@$@ 4.0.0 com.iluwatar java-design-patterns 1.16.0 visitor junit junit test org.mockito mockito-core test java-design-patterns-1.16.0/visitor/src/000077500000000000000000000000001312550536300201165ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/main/000077500000000000000000000000001312550536300210425ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/main/java/000077500000000000000000000000001312550536300217635ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/main/java/com/000077500000000000000000000000001312550536300225415ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300243715ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/000077500000000000000000000000001312550536300260705ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/App.java000066400000000000000000000040131312550536300274510ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; /** * * Visitor pattern defines mechanism to apply operations on nodes in hierarchy. New operations can * be added without altering the node interface. *

    * In this example there is a unit hierarchy beginning from {@link Commander}. This hierarchy is * traversed by visitors. {@link SoldierVisitor} applies its operation on {@link Soldier}s, * {@link SergeantVisitor} on {@link Sergeant}s and so on. * */ public class App { /** * Program entry point * * @param args command line args */ public static void main(String[] args) { Commander commander = new Commander(new Sergeant(new Soldier(), new Soldier(), new Soldier()), new Sergeant( new Soldier(), new Soldier(), new Soldier())); commander.accept(new SoldierVisitor()); commander.accept(new SergeantVisitor()); commander.accept(new CommanderVisitor()); } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/Commander.java000066400000000000000000000030131312550536300306350ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; /** * * Commander * */ public class Commander extends Unit { public Commander(Unit... children) { super(children); } @Override public void accept(UnitVisitor visitor) { visitor.visitCommander(this); super.accept(visitor); } @Override public String toString() { return "commander"; } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java000066400000000000000000000033261312550536300322240ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * CommanderVisitor * */ public class CommanderVisitor implements UnitVisitor { private static final Logger LOGGER = LoggerFactory.getLogger(CommanderVisitor.class); @Override public void visitSoldier(Soldier soldier) { // Do nothing } @Override public void visitSergeant(Sergeant sergeant) { // Do nothing } @Override public void visitCommander(Commander commander) { LOGGER.info("Good to see you {}", commander); } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/Sergeant.java000066400000000000000000000030061312550536300305020ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; /** * * Sergeant * */ public class Sergeant extends Unit { public Sergeant(Unit... children) { super(children); } @Override public void accept(UnitVisitor visitor) { visitor.visitSergeant(this); super.accept(visitor); } @Override public String toString() { return "sergeant"; } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java000066400000000000000000000033101312550536300320600ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * SergeantVisitor * */ public class SergeantVisitor implements UnitVisitor { private static final Logger LOGGER = LoggerFactory.getLogger(SergeantVisitor.class); @Override public void visitSoldier(Soldier soldier) { // Do nothing } @Override public void visitSergeant(Sergeant sergeant) { LOGGER.info("Hello {}", sergeant); } @Override public void visitCommander(Commander commander) { // Do nothing } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/Soldier.java000066400000000000000000000030011312550536300303260ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; /** * * Soldier * */ public class Soldier extends Unit { public Soldier(Unit... children) { super(children); } @Override public void accept(UnitVisitor visitor) { visitor.visitSoldier(this); super.accept(visitor); } @Override public String toString() { return "soldier"; } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java000066400000000000000000000033101312550536300317110ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import org.slf4j.Logger; import org.slf4j.LoggerFactory; /** * * SoldierVisitor * */ public class SoldierVisitor implements UnitVisitor { private static final Logger LOGGER = LoggerFactory.getLogger(SoldierVisitor.class); @Override public void visitSoldier(Soldier soldier) { LOGGER.info("Greetings {}", soldier); } @Override public void visitSergeant(Sergeant sergeant) { // Do nothing } @Override public void visitCommander(Commander commander) { // Do nothing } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/Unit.java000066400000000000000000000030251312550536300276520ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; /** * * Interface for the nodes in hierarchy. * */ public abstract class Unit { private Unit[] children; public Unit(Unit... children) { this.children = children; } /** * Accept visitor */ public void accept(UnitVisitor visitor) { for (Unit child : children) { child.accept(visitor); } } } java-design-patterns-1.16.0/visitor/src/main/java/com/iluwatar/visitor/UnitVisitor.java000066400000000000000000000026041312550536300312340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; /** * * Visitor interface. * */ public interface UnitVisitor { void visitSoldier(Soldier soldier); void visitSergeant(Sergeant sergeant); void visitCommander(Commander commander); } java-design-patterns-1.16.0/visitor/src/test/000077500000000000000000000000001312550536300210755ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/test/java/000077500000000000000000000000001312550536300220165ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/test/java/com/000077500000000000000000000000001312550536300225745ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300244245ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/000077500000000000000000000000001312550536300261235ustar00rootroot00000000000000java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/AppTest.java000066400000000000000000000024741312550536300303550ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import org.junit.Test; /** * * Application test * */ public class AppTest { @Test public void test() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/CommanderTest.java000066400000000000000000000031701312550536300315340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.verify; /** * Date: 12/30/15 - 19:45 PM * * @author Jeroen Meulemeester */ public class CommanderTest extends UnitTest { /** * Create a new test instance for the given {@link Commander} */ public CommanderTest() { super(Commander::new); } @Override void verifyVisit(Commander unit, UnitVisitor mockedVisitor) { verify(mockedVisitor).visitCommander(eq(unit)); } }java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/CommanderVisitorTest.java000066400000000000000000000031101312550536300331060ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import java.util.Optional; /** * Date: 12/30/15 - 18:43 PM * * @author Jeroen Meulemeester */ public class CommanderVisitorTest extends VisitorTest { /** * Create a new test instance for the given visitor */ public CommanderVisitorTest() { super( new CommanderVisitor(), Optional.of("Good to see you commander"), Optional.empty(), Optional.empty() ); } } java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/SergeantTest.java000066400000000000000000000031611312550536300313770ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.verify; /** * Date: 12/30/15 - 19:45 PM * * @author Jeroen Meulemeester */ public class SergeantTest extends UnitTest { /** * Create a new test instance for the given {@link Sergeant} */ public SergeantTest() { super(Sergeant::new); } @Override void verifyVisit(Sergeant unit, UnitVisitor mockedVisitor) { verify(mockedVisitor).visitSergeant(eq(unit)); } }java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/SergeantVisitorTest.java000066400000000000000000000030711312550536300327570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import java.util.Optional; /** * Date: 12/30/15 - 18:36 PM * * @author Jeroen Meulemeester */ public class SergeantVisitorTest extends VisitorTest { /** * Create a new test instance for the given visitor */ public SergeantVisitorTest() { super( new SergeantVisitor(), Optional.empty(), Optional.of("Hello sergeant"), Optional.empty() ); } } java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/SoldierTest.java000066400000000000000000000031521312550536300312300ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.verify; /** * Date: 12/30/15 - 19:45 PM * * @author Jeroen Meulemeester */ public class SoldierTest extends UnitTest { /** * Create a new test instance for the given {@link Soldier} */ public SoldierTest() { super(Soldier::new); } @Override void verifyVisit(Soldier unit, UnitVisitor mockedVisitor) { verify(mockedVisitor).visitSoldier(eq(unit)); } }java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/SoldierVisitorTest.java000066400000000000000000000030701312550536300326070ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import java.util.Optional; /** * Date: 12/30/15 - 18:59 PM * * @author Jeroen Meulemeester */ public class SoldierVisitorTest extends VisitorTest { /** * Create a new test instance for the given visitor */ public SoldierVisitorTest() { super( new SoldierVisitor(), Optional.empty(), Optional.empty(), Optional.of("Greetings soldier") ); } } java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java000066400000000000000000000053571312550536300305570ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import static org.mockito.Matchers.eq; import static org.mockito.Mockito.mock; import static org.mockito.Mockito.verify; import static org.mockito.Mockito.verifyNoMoreInteractions; import java.util.Arrays; import java.util.function.Function; import org.junit.Test; /** * Date: 12/30/15 - 18:59 PM * Test related to Units * @param Type of Unit * @author Jeroen Meulemeester */ public abstract class UnitTest { /** * Factory to create new instances of the tested unit */ private final Function factory; /** * Create a new test instance for the given unit type {@link U} * * @param factory Factory to create new instances of the tested unit */ public UnitTest(final Function factory) { this.factory = factory; } @Test public void testAccept() throws Exception { final Unit[] children = new Unit[5]; Arrays.setAll(children, (i) -> mock(Unit.class)); final U unit = this.factory.apply(children); final UnitVisitor visitor = mock(UnitVisitor.class); unit.accept(visitor); verifyVisit(unit, visitor); for (final Unit child : children) { verify(child).accept(eq(visitor)); } verifyNoMoreInteractions(children); verifyNoMoreInteractions(visitor); } /** * Verify if the correct visit method is called on the mock, depending on the tested instance * * @param unit The tested unit instance * @param mockedVisitor The mocked {@link UnitVisitor} who should have gotten a visit by the unit */ abstract void verifyVisit(final U unit, final UnitVisitor mockedVisitor); } java-design-patterns-1.16.0/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java000066400000000000000000000105111312550536300312630ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.visitor; import static org.junit.Assert.assertEquals; import ch.qos.logback.classic.Logger; import ch.qos.logback.classic.spi.ILoggingEvent; import ch.qos.logback.core.AppenderBase; import java.util.LinkedList; import java.util.List; import java.util.Optional; import org.junit.After; import org.junit.Before; import org.junit.Test; import org.slf4j.LoggerFactory; /** * Date: 12/30/15 - 18:59 PM * Test case for Visitor Pattern * @param Type of UnitVisitor * @author Jeroen Meulemeester */ public abstract class VisitorTest { private InMemoryAppender appender; @Before public void setUp() { appender = new InMemoryAppender(); } @After public void tearDown() { appender.stop(); } /** * The tested visitor instance */ private final V visitor; /** * The optional expected response when being visited by a commander */ private final Optional commanderResponse; /** * The optional expected response when being visited by a sergeant */ private final Optional sergeantResponse; /** * The optional expected response when being visited by a soldier */ private final Optional soldierResponse; /** * Create a new test instance for the given visitor * * @param commanderResponse The optional expected response when being visited by a commander * @param sergeantResponse The optional expected response when being visited by a sergeant * @param soldierResponse The optional expected response when being visited by a soldier */ public VisitorTest(final V visitor, final Optional commanderResponse, final Optional sergeantResponse, final Optional soldierResponse) { this.visitor = visitor; this.commanderResponse = commanderResponse; this.sergeantResponse = sergeantResponse; this.soldierResponse = soldierResponse; } @Test public void testVisitCommander() { this.visitor.visitCommander(new Commander()); if (this.commanderResponse.isPresent()) { assertEquals(this.commanderResponse.get(), appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } @Test public void testVisitSergeant() { this.visitor.visitSergeant(new Sergeant()); if (this.sergeantResponse.isPresent()) { assertEquals(this.sergeantResponse.get(), appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } @Test public void testVisitSoldier() { this.visitor.visitSoldier(new Soldier()); if (this.soldierResponse.isPresent()) { assertEquals(this.soldierResponse.get(), appender.getLastMessage()); assertEquals(1, appender.getLogSize()); } } private class InMemoryAppender extends AppenderBase { private List log = new LinkedList<>(); public InMemoryAppender() { ((Logger) LoggerFactory.getLogger("root")).addAppender(this); start(); } @Override protected void append(ILoggingEvent eventObject) { log.add(eventObject); } public int getLogSize() { return log.size(); } public String getLastMessage() { return log.get(log.size() - 1).getFormattedMessage(); } } }

    * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; import java.util.Objects; /** * User DTO class */ public class UserDto { private String firstName; private String lastName; private boolean isActive; private String email; /** * @param firstName user's first name * @param lastName user's last name * @param isActive flag indicating whether the user is active * @param email user's email address */ public UserDto(String firstName, String lastName, boolean isActive, String email) { this.firstName = firstName; this.lastName = lastName; this.isActive = isActive; this.email = email; } public String getFirstName() { return firstName; } public String getLastName() { return lastName; } public boolean isActive() { return isActive; } public String getEmail() { return email; } @Override public boolean equals(Object o) { if (this == o) { return true; } if (o == null || getClass() != o.getClass()) { return false; } UserDto userDto = (UserDto) o; return isActive == userDto.isActive && Objects.equals(firstName, userDto.firstName) && Objects .equals(lastName, userDto.lastName) && Objects.equals(email, userDto.email); } @Override public int hashCode() { return Objects.hash(firstName, lastName, isActive, email); } @Override public String toString() { return "UserDto{" + "firstName='" + firstName + '\'' + ", lastName='" + lastName + '\'' + ", isActive=" + isActive + ", email='" + email + '\'' + '}'; } } java-design-patterns-1.16.0/converter/src/test/000077500000000000000000000000001312550536300214055ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/test/java/000077500000000000000000000000001312550536300223265ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/test/java/com/000077500000000000000000000000001312550536300231045ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/test/java/com/iluwatar/000077500000000000000000000000001312550536300247345ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/test/java/com/iluwatar/converter/000077500000000000000000000000001312550536300267435ustar00rootroot00000000000000java-design-patterns-1.16.0/converter/src/test/java/com/iluwatar/converter/AppTest.java000066400000000000000000000024741312550536300311750ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; import org.junit.Test; /** * App running test */ public class AppTest { @Test public void testMain() { String[] args = {}; App.main(args); } } java-design-patterns-1.16.0/converter/src/test/java/com/iluwatar/converter/ConverterTest.java000066400000000000000000000066761312550536300324340ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.converter; import com.google.common.collect.Lists; import org.junit.Test; import java.util.ArrayList; import java.util.List; import java.util.Random; import static junit.framework.TestCase.assertEquals; /** * Tests for {@link Converter} */ public class ConverterTest { private UserConverter userConverter = new UserConverter(); /** * Tests whether a converter created of opposite functions holds equality as a bijection. */ @Test public void testConversionsStartingFromDomain() { User u1 = new User("Tom", "Hanks", true, "tom@hanks.com"); User u2 = userConverter.convertFromDto(userConverter.convertFromEntity(u1)); assertEquals(u1, u2); } /** * Tests whether a converter created of opposite functions holds equality as a bijection. */ @Test public void testConversionsStartingFromDto() { UserDto u1 = new UserDto("Tom", "Hanks", true, "tom@hanks.com"); UserDto u2 = userConverter.convertFromEntity(userConverter.convertFromDto(u1)); assertEquals(u1, u2); } /** * Tests the custom users converter. Thanks to Java8 lambdas, converter can be easily and * cleanly instantiated allowing various different conversion strategies to be implemented. */ @Test public void testCustomConverter() { Converter converter = new Converter<>( userDto -> new User(userDto.getFirstName(), userDto.getLastName(), userDto.isActive(), String.valueOf(new Random().nextInt())), user -> new UserDto(user.getFirstName(), user.getLastName(), user.isActive(), user.getFirstName().toLowerCase() + user.getLastName().toLowerCase() + "@whatever.com")); User u1 = new User("John", "Doe", false, "12324"); UserDto userDto = converter.convertFromEntity(u1); assertEquals(userDto.getEmail(), "johndoe@whatever.com"); } /** * Test whether converting a collection of Users to DTO Users and then converting them back to domain * users returns an equal collection. */ @Test public void testCollectionConversion() { ArrayList users = Lists.newArrayList(new User("Camile", "Tough", false, "124sad"), new User("Marti", "Luther", true, "42309fd"), new User("Kate", "Smith", true, "if0243")); List fromDtos = userConverter.createFromDtos(userConverter.createFromEntities(users)); assertEquals(fromDtos, users); } } java-design-patterns-1.16.0/dao/000077500000000000000000000000001312550536300163735ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/README.md000066400000000000000000000014111312550536300176470ustar00rootroot00000000000000--- layout: pattern title: Data Access Object folder: dao permalink: /patterns/dao/ pumlid: 5SR14OKW30N0LhG0oVrt4o6ZE12Ov4NR_thQNQlc5aN2sd82qtz4naywAixOmyNoK8WYvT6fjdWOR7JnpLiHhuTkam4nTUhiRwZm847-J64zpUZj3m00 categories: Persistence Tier tags: - Java - Difficulty-Beginner --- ## Intent Object provides an abstract interface to some type of database or other persistence mechanism. ![alt text](./etc/dao.png "Data Access Object") ## Applicability Use the Data Access Object in any of the following situations * when you want to consolidate how the data layer is accessed * when you want to avoid writing multiple data retrieval/persistence layers ## Credits * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) java-design-patterns-1.16.0/dao/etc/000077500000000000000000000000001312550536300171465ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/etc/dao.png000066400000000000000000001155471312550536300204340ustar00rootroot00000000000000PNG  IHDRVX.IDATx XѫF . "QP !rhą*.(In0zccj6|Tdzfdf~y>]]]=5]힪JZB!BP B!<ҜB!ҜJDgE!<ψ(q'hJ2JsB!ʀJs9!exFTҜB2`<#\yFiN!D0a9˫/[EF{?n_B<=۶mi/FiN!D0QÇ/5?LIlݸq^%Sk~qiO99!exFTGHK2&O|͚hc_cx{x8-X0~dTܹz<3saϞCC}}|\qϳfc`iCyH`qޅn !!>ժU޽Qgg;7Vݤ=BHa<#_ohns~A4jONEukݹsd޼B߫|H;:6 PBEn{2d~i o7lXW\DBI%'O ~0d۵{㫯65|9`4]G&K<.n̙a,Is^bb͞"""[~}ț7s z( !xFTGM2 ;6@ \]xzҬ]}tfRaHU"ҜB2`<#96+u4<۷Oܰa*U*sܸ~7n,{oA}IJxxy9x}+rJsB! 񌨎2~ye߆)9W闟9Xzwa}"x<{FdH:)2߫QOOgh_5kD^윜j)p~&g CʸaúժU?vCxlmE }œ'Wnz*ի=>,kG"sU4iЎ֭U~G~ZEڽ[͘1<**XW}rƍp7VoNyM(I9P'8fc*Duiӄ=fmF,<"UPubHō[ѵk;Il/g֨ܛo6ݻw}_zٳt޵+ᵧz ?==z#JqOmΝ[)z啗FBOüs꾯Ow;|x)y>Xk&[4)ũ 66QeC7 QpՁޫ`bik?y [/2ϝ; ^"/Ǡ4]Dޚ̅7o戜H)|dnPC?iht;vtxH$%Ù>{Vu{KP_xΟv3gdk 4kXMH9@iNSSll:y`A]S`biN#-IwWʬY-m~q06e5j<ŪU̚5Bwi4(AWxVl.2/^4tp{Z/"1cP8T2+W~?N[@Q\{x8C_}JV^x([[kc5a"9My.NU(Ƚ">CׅZqdž ,|H_lT8\>=y}v䉉ܿ$͑c'NvJ+ el9RZn=V''ONSح[tʤyi1W ҽ-l47X-RP?ּڼUddP))(2ǫֶtF޽ 41*ũ 66QeݵS J=iN!;V -uG}ڶm9eJH߾O=Fa/}ͦ]|͚hhc!T|Z6:rtlvh+Y/fLPKF?mk¸EJsmSY^jƒҼcG0__FFbz_?P2i~Ԛmڣfc*DuuNyk' 5oA]=pkXXQ-&f5t?Y2MJHK/elyP(#{׮mUj-lDa[+V@WڿØ={Z^}msŃ\!_YlmG޽5k¸EKK2&O\)'h渰0n"}*_:wn^p۵mڴؾ}C"]QSll:!rCY;!l焰Nxt9IP4E2԰Fu1FNLHsIX[֝;G=mm]۷gJXbС=\EW^=CoQl  Ao{<4vqMTGDOs/?Bsټ>&<*4vqMTj#qH /--ZU=/}pܤI'yׁ5lXW(vvv/_4A؉+7o(. vR. 9kW"֊- ""u/{TkTFn 3vldɻY6&&fԩFde-^pv}H%$sww Ho>ڵl!n/F#O-Y=fd$J {lTFn .L(f=7lqrj޴i w;5OOYF6îʕMM ݸq04ԷNMqmڿ7׭[4X[cTFn NSSll:g[D'8My.NU`V1n 48U&BG]7nKI>rǍg~1n }h]`cա]bi~`ckOB4'4Sll: :͛9׮e1bD=;~ņԙX:uSb >9<))\H˧ -|$BddP֯#g69sf}HϯGHtrRƠA^;p`KMw{y3& ,\/^.48U&ü{QHٓt ~D,. Z&Z<8**x($u%lBCF=S{/rӦoْysɒw32]s=?;|VMCbHHszu6{b"PN ^5罐v/4ujMbߟǗԽX<5uȼlY9x@ U;`8$f0R{„r_afXr*^f:=h1n](Kfߎ1ӷrۜM&v2Λ6mo{PW^.NU0ov-O}=:ۡ7e0^4~͘4?wnҥ 8~wDD v wD8Urs7o0--AϏWŋ;;uj ;6@/3AqBi^;y*liQٯ}f5uX_-}.WSll:g[D'x ,hyF}(_]tpAH_s2vhj&& zq/uk8n\?U֭Cf?eTFn ^JArW UÅY>"X`zȐqʪ4/7啗>$%1q# :~ũ 66Q3-"0+ࣻGϟi0$bu4)Gzwƴ>zt_?;t+Sll:g[D'x +i9[[BNsa'Ӷg_1;]JGi*<&fV^7ljiCX.NU`V1n %QZ;7fudԆ):&;׃Wc66֮g}Fi*\$ߏVRKNr2vqMTG%D"B%JSyM&vzki1\>/}?^yAaX+=OR%A k^i*vm[DD"`XNr2vqMT#qH/\h?_B>z{θD_r,?rNh4_lj[mڴZJ߾w14V,c*Du0r+OӽzaX@r>GW6KL;i2vqMT#qH/<ֲw4 ;4d(ũ 66Q3-"܌Fi^F.NU( gE,J48U&[yƸE$xӔgTFn NSSll:g[D'8My.NU`V1n 48U&[yƸE$xvJܸ1.%ecaw/7ُ]`cȭ>WQ.SZA[gK=[HϯGHtrRƠA^;p`KMw{y3& ,\/^ZSll::r#4j4"BbXԓqq#)ht;W-ƍu2E:T|{Q۷>;tFFbz_?P/NZXθEʥܹ س'ܹ X]fMرXuҥQH@vis2ٍ{-K9,yk~?rժiH,^ iYfJ-ũ 66Q# +t? ZcHjhV.]\96msH`j֬1f̣]km2d%t˙ڿKׯoDgĝ;Gyi$~aWVbCɤQ}zzwC̅=zt@|mӦ̙aاTK'vrj8eK[b->/+~ȉxq {t]~`W-b Kkײb'>lo8azߘ4?wn+Dߥ9.D7۽#"}C^k > ԭZyii z~\-`^.^٩S+00zMfJ-ũ 66Q"3]crnHsBōD#iӫWU^ήo6ܬRXJVZDl=4Fȫ<)([ CoذR~|@D!BVP[ZzaoIc[m]-ו"xMT@^0\6֭_Ŀy3qCҜHc*Du ncbM'ͳvmyB:d7;:6{Fŋ;?| 'M4a"h7!K.\8^*_Wʫ3lGL(Є2tH(G"uvԵk;xj Mb86hT=35wqӏLT@^kDc&2n Js]`ca,rŻ-<7+fnfLBf nKCs֡Cͭ'h d6-G#"P&:995?thwߥկ_gN՝*kݲkoa;n\?W|z8wn+85kĨQoE„q`ho:5;WE{kF2!ϜY߾Fub!ĉwjQڿ_K+W̢>[(PӔgTcˇ-=07vL$͛uE+WJΞvBhQ`61"4)ũ 66Q#tq'ҤWa, j[DҜ)))%KKp,A4`cȭ<+]b|&%%^%GqӥCiK'b'MTG%JsY%5/ť%ע(\PӔg檂MTGYGnaQ[(6+WQkײ2qq#S}A5^2t X^=|ǸEʇ7ӻ7f'Jũ 66Q# +t? Z(~~xq$&3=l߶msݺuH(dQ"g۶-Isiѣɦ+7o}۷CK(D[8 f׮DЕf9#",yWj(DUff"C*tР43.NU0,>~BO,©gWm^*Cd߽{L[(/^kwȠ8bsO\PIo/瞫fl@4.Nb k٨s׮y3ʪT5 "zz:s]\>#\UP8I L)im?W˙[vAAݻ2uݙ!Z41vqMTlܬ1 1H- S7ϭ[w!Z}IPiZ6""*IٺO|B"K*iڴcju9s^tss#C%NKsi_B5 H@a7n S&a1?Bp1̙5.n]n'ߩS+qS߄4)d?dd$K-gdʼno{rV:F{".NU0=V|scwDz._ܼXGTr%ٳ_s < ]n.~uCYqHf2 ˖E!ѱ & JJ {ti .JcTw1Oߍ|-p@&X&=6ر62{01nL&zu_UfS{&UTC9y =25vqMT_Vipcd[=)c"48U&,<.nccG{#X^d"Orra ҝ[ys`qF\C獘(MώMW62w{啗>$ऑ_>$f!.NU0{ 6`ܟE8u$'O c06 9sfܹڶm["=ĉ͛7YءCKo> -Iszqm ]!yqוf9#",ybWR֋"iMF>YkDQ!-Q\;7[Hs -)4xZ%7n[-ݻ.7Ra]8et HsFJ`kTcwL, "ybbMhIV֢ի~M=_~s-0ww 1ڵڵ<7oXYՀF9m?_ ɮ-ΞΈ纸}G&9utlv1x /^ܩ'upDn= ߣA|woҜ)řL?Ĵ i ݹ%?vm˗3u ѝa4nсKri54iɩ@`d.\H78?D>72&7vqMTlܬ1 1H- S7Ϲs[^*5kĨQoAdCaAHC`CF{7nDSf&Yo`ۻfĈ^(b̙(bs`My\[(3#"9"~#E]}};@@ ~i9)S>LH hA&mgM߼|ޥ8N_z酾}=}.;Xi[bժUt6(F-&߫ч"cvJ8U&DX1aK̍= ,>uXiOʠZfI)qHf2iY֛;;MTƍqU\a3Bd $1i.à&O,"cә&7vqMT'F v,Ǝ ذa٫Qzc"Lb( IL +Ͻv-[*"x辺\Xi+%aڽW_il~|nOgũ 66Q|YqHf2 i.5aLLhIKKpvL8…y#Ekƈb.cE"&$cCsc~:.NU4W1nL&1!&i%n۾q=&)4uPC{76 To҈pjϦƘtɍ]`cAi`u S&b&Ќ8U&\yƸE$JsϙN%u3i 4Ub&DuT4W1n 48U&[yƸE$xӔgTFn NSSll:3r{{5Mm; {ȐZuEܵKfׯsme9My.NUi8*.n;tFFbzKLK`ήիt( 0$ ~=D]`ca:rOػP<[ EͭU~~]ݺ ޽!=<Ȼ{tgNڷ4[yx8-X0"C͚5ƌy&iӆ`r"EP~l۲n.]0X ݝ<=۴i}<'Ll3f bf=:!̙a(=&Y2nأa췵:5A.]\:995(H\ow/ ٳch+*)^θELP,iQ.+a~Fɍ]`ca"r]W.]251Tfz(k~`qwnI:COX# o2}ǎ^b+ʫ*ٳ4}Ԣԩ5?DvqMT`A@;&|bN<ߵk;$ṉ!9B[Ĉdش)^嗽=W <&fԩFde-^oԢ@GfwC:ŝZ`NAbDkj`m|Tu?O?2!ѓZp|q(AGh_9).řL?*L<%7wV6#45vծmurn 06cD>ʢ )7ZC\\KʢKscUa%_W;xl@![f85&/ T1nL&Y6F;(իB!<Śjl'&#B 4כblj֒Āqۘ47VUPc,׬N324'*\yƸE$J3{PlCtsk')Z0&k ∀MTqHf2˙7?J66Wd]\+!vf1iʍ%r)7c*DuP+Di&@x>`%0Hsiʍ%r)7c*DuP+DiN9sީD4i85&qH)ũ 66Q3-"|֬"gDD%BJWjzQD^ƤyϞ%ihQ|r%9yRPҰa]!ͥ @=LiN!D%0aL7X9|6XS7ϦM/}jcB_ShPBRcQJw@ )22H"v-7sj@U2m|Tb\O?Ȅ4WFOhukݺh .P|=aS>z9!xFT1ilܬ1 1H- S7r^ mss ٦M ∈@Qi5iR_({UA[Kûo8[NM6#(nޚ#zAC95hn]n'ߩS+q߄4WFOōcxiv%v0᭷GrVphf5-9!xFTi+Fw_>l遹g"NJ'egP~+RE _o6JsB!ʀ6nB"4'BugB>77$$Ok!T(͉HIIٳ:76ʅ'ZBwڕB4'B@I{m])bH4ݺu-sB!ʆҜ=I'9:'Z2hhh><B4'B\~wNh>ޅd:htsWB)(͉*rŠh( !(Jspn偫,"B"4'JF dB!T(͉IOO,O+.;'0(͉2)(ܵ e BQD888HB!¡4' \=;B9QTijCܵ BDQ_-DI!DPEٟ$???))ܵ BJ9Q|xϰ[!Th(͉HII,!9Q"u5BP 9u%$$o %RA4'r+++2'zp9! 9Pk6B!JsR!('p!9x@;88!4x3[!T,(I$%%U sB!JsR('!::ܵ B9H"QPPkA! JsR>Rb{B!9$%%q0)1999TB,JsRHOO"$<<Bp(IsׂB!l4'MJ!Q|K(!ҜX.5 IјBa(͉Eq,BQ糨IّB@(͉%ҨQ#1'e B@(͉%q,BQ!Ă"h4|)7BBB{#b9P "sׂ>B@iN,c!B(͉EnZiDŽB,Jsb~rrrx˜ .XYYVB9!pX !Ҝhsׂ?B1#l@5jԈgB1/'\tdB!fҜ|sׂ@B!fҜsׂieeʼnBJsRpJ!4'oFBJsR~'%%\IK!<4'AA!!… !AiNZT\xaI!|4'eo= Mzz9!rҜ-HG-K&RP2FјB!JsRDGGsQ 5⫲!)LDy@_ B!e 9y򤤤XYY~9!BH4'OH|sׂ2!'''$$ܵ L(ɓ7ˉ/C!]neenB!TH(ҜGD!BiN(\NFRRB!BiNJznRp9!' 9y | !<)(Irr.\`eeB䄄N 4'%'==O Dd*BP@QN|K(!RBiN t9! B!Ҝ>Ŝc R(I1ɡ VVVOBHɠ4'E… 54'4)))BJ9)|x3!EBJ9y<! %BHq4'" hsׂBHҜ<c!p9!CiNIBaAHIIIqpp0w-!T(͉QvCBJ N"D!P~9!BHyBiN cZNB!EҜ#F9!Ot#X(͉ !BJsIII᫅);yB19 .p8,!eJAAB!R~p!PGo7w-Q|!PFIII1w-QѼ&"ҜBBCi^8#󒟟?!Bi^7ByFxyL!DҜBWJ!DJs5¿ x>BP .@F2B!ZJsBb1w-!JsG)b@s9!Jsbɤ4jԈ')!JsUR!HJJ4'5Ci|rrr (ZBT效1Rt5j)B:4jOДj愔?'Zၐ*}/!XP)دBZၐ*}/!XTԄg1;:DGݻw錌zj_~dԩ5?۴@Hc9jq7A% ˒.eL<ɩ5<ڿݻ pvq[`,g"s[2HeK[]k  qM۷[7Vݤ=f7BKWo% K_jXqܺu=}< PuֺsȼyMϿ}{{y+ S^ 0.Z!Jzu3Ŷg@LiΛ { !HsĀΝ[vq.]\:=|~ڍ" ,ỸaúBykW_mk|r NXټyCB:apC]Ow" ""[~}ț7s zQ&y}/!±i.Y~~jH:Y' a^4k : EիWeÇwi$swwBH߷v-[ 6ŋ?LAW׬32=f7B W%M ⤹0<|ɩyӦ Л߽{ܹyz:Ϛ5bԨ vUljL fƍulҤnu/G3۷hn]ޢښ;dx XTk ¾bX4=qcx ~7AB, Js!U^BH4W1<R_% Js!U^BH4W1<R_% Js!U^BHx4?y*/xxBp𘽳)(i{ !1<6=(kEMS/fh2Bʟr{bƾR,LIsohOm9mNwGQ&;O>IQQ;&&/)yڻۑdc(nRHHszx!ѱYӦ D-l|$ZVJvowʼnrGB@I1nZ9z4Yr֭_G@,?Çyb3XϚ5rc|R׿߫*I#g^윜j)p~&g C1 Ճ?v _ [[kP=51]cG-_?Y{&bqʩCnnΟf;ax Č4/bUn-[-FƓ5baT{% UCV 6f}w`CG߇<{v# ;}b}7["9T)'ҭZֹsk(ʁܵ+5իj4pr&:_{V!z啗pm EnE!U\.Vށqq#VtNpx"//AW}fn:w@);i^'bQ:_o8lҪAiN1#FS OO4ON1\w>zp^رb5VV5—-Y4E&BQ%貑EcGW_?[A?υl[ ]ڵULvuo۶%sB%E湹ˑ[ 8} 51QG-_.CC}Ah~3 w5kh& %{"m.]KN~i7:9sbjLQ JsB1uu_Tt?%4z2mK~Fc}GϚ5Bү#Fk7lտnzaQH3"QJehH-gHQZ^D":: NfQ ^y [VIG.~%'&NH*2:wPѱѣɏ?:3Xf TGr|̘.b ք3RvҼdwO|}?T JsB1\ yy_GoOHKs凵R"Jsm0$$i=I-[V^޾ zy_aLtְǕ+?km2m%>pBJ{ C օ̽~X0^SnGb9wVUVA rZ=&o$כŶv\T[c& %{b:_ -0(lt,@ ruȠ4'Ǽ ^? 0, 9 Hã-pOvļ@HSv\['ƚר\..Oky#}/!Čó^],RZ;1;0_'AK検 azЯAJB0=WI^ ye!A$}/AFҼ LU @i^Y@*IKQ(i3o*?ڵpf﵁dx *YJa,J >4 UCQW$Q%(K_߭Ouk5*ϯ߮Z4Ӧ t7obd=\@;R""o_^!'O6իP2]8?u߶mٓcGE-϶]Ǐ GɬfR0#Wˉ13&Δߣfwac!52>~ |2.[3aB 6Ң?{vti}j 9ztGEYwǜ35u֭Dбw-Ւ0ϦkߔFɬfR0#W$}/QIVNW^ߝ;?6ǎ}'/o?yiS{kzƺub>}H}z"Is;5kv-hEɬfb:A%4j}]ǎ-TtRWF2<AJx?:8X,$4/*:0hܹ`G^*4mjuz %i9$W}zBs]vqjiSҰa=Vl8:n2WY.8ZҼ2 LUWЏ~k(9T{FTlBׯ_%'w t2T$wZذaw#mo߮:zt)TF "tط/^}@\oܸF;xЩ%'g>,? ݯ,G d]i4dx Ӄ~U-* o5UZ !tqwQڅ ېUCSS'+3H%ȥ9 #J* i&+Cdٳ,Ise-3fHL+ե,Guƞ /RAY4',p}QLEdWЏ6nLϊ;Ν/HJ7uꐌB% ݱcsmKr (}z #4*o<$͕Ǝ8UYQĤIAۿpaĭ[{Th>YJH0=9'Ts߆Dx"da=gt,5˗BOhJ^ނj^))ۻ[HAP4?~|@~ohA\YΝyxC_eb­[ A*-PWB2<AJx:[ТYF@>mގ3g;OOd駜^K.6i~vMCJٹ%IAJbk Ɓۿ=GYN39/[RWF2<AJ|zXziiɷg8CB0=I^"# ' 9|fa1{'c{s$2<)W3PДarkuOXak$mKp^xZLL{~n re\\u LNy%Iqe<&?_e·{yDf!==ǍN͚՟{)r]ժآEO?}?--7WZҥܧ˃~>Mϲ_Т_CwQ`\U~2s;wn*jٺu^uoĢ =<\m8ŋ;0< 6sh5m_~YNiPi^Ҩ^no֬,l>¨rbGG[gvv6pL$ ?cg CHsHž}8C qU1F!  q !VV ي1ܘ1}8~|9vf#F); Lbw$X`h:=mSvDj4[ ؄FGXWVq$nM@X^dx ӣ4S%ӧ# rPG^ 実~ʩ[uz'J#ÃZ8:By()yꄾW$i{. ܸ؄}Op"RɕjX|1n^ UJ !>}l_?[B#O\$ a/6 oܺuԿXO>'̗ [w41ӱ <\ #F6|*9,ˆhVpMVև8P^VM;vlY\ܻ1pdFq! [4J/J狁MC(nI[]Im+#R۔7.ѥX.\ئePPW@i֬Q:AAi_Ԏ*!7PqFI6%OZ-~0B&F^)@Giu9BSf4QgIJ}oIڵkr_|׷J>|MU9xdzaJMO>[E>Yi ԉ =a.Jfo3ubynnnAAA... 4iܹȃ k?~rO?TnK. 5>c lnڴ ]0=ztǎ{vuu.lقӧ ;BC救B_%-nذ! +WԬYj_o% = rұJ~KLvÇ}5 GA˥9ܾ}lVcI& >zHi^iy UW)gNμիMPQVևs7{FJH0=WI^ՂYHi^,&׬N\Ϯ_?[lؑҿ6,lʕqʢ֮Mptuvnigg!ˏ׮>׵v<_Z+g!R~^wGNQF0!ҼXGCzxK :<>~r趶M~e7ׯsrRPS>(>\Vs/HCs11Dzy Խqc/=ѻcǖ?۞ap@V)CH߫ZP)w߭۽;HN^`RFTlzy9vv1.ݏ?0B|_-/\1qbJb4c$ =Æ )dee-9sƐGR.)%~:*8r\Ӈ&&&"6 Fy_-uf1򫯲4Z)p }vMC7pұƆ m7HhYH lM$}@&*IkvIi^@*I[J̞=NԒ;v:tQ%$CJH0=WIرcw޽}vKzCbΝgΜIiNV\RWF2<AJ "Yl[nmڴҜ4dx Ӄ~- óDzΜ9qqq%|:iNL=jvFax ~- [ IAJH0=WI@.ǏgҜ44_3Μ Ӳ5جYdm>P'ǧáCyI9_O]aaVSvm=_+BE$A$}oi7ݽ{ϟcǰKJPP4oܸ0Κ5_['~i?zΜokdܹmLL(jAzy Խqc](+>|x\Ϲ azp.X*{K9siӦm۶b~{-[|7jժʕ+ ,ҜTFGH_CB>oݠ]8.q^^..vH`j׮9~|\>颢;1}:B C( !C ֻ}{wH?!!zpzWKfA2QHVM?~+nڔ4h;zt)잞1-7oN92fMgNЅM4Fs*޽]]PY:A< BYєSW4'CyeCN980 ldXnıFVG:`@߾t(]Yٝ6mAרQ-+C/6fL$_5, {"$yÖ.yLL(9;{‰HMXET./\֬Y#yk1 @QTBNZmc[*6.݄"gD #DaUH l;Ly*ƌW ӀS=A[afR,*Mz))-i+k&Bqnq{xl(i.*y|PybF+M{q0~@ !($1q١C4i~iߢEcxRPvR0hsB99P K3G&NNE(OF/'ODոwŊ8ySND8=!Dy*( S=A[af%-*vB2EYxHhT#OE4ƬXSO0@2.'1n[4pRڵ:NՕ+yOѬSVb^ $ڃի~N0=8aS&[oVrbq,$SZ1`ُiY6fcV fQĉ${lO>mٶmspHs„Uf azpʃU-Lެ^q!Ң J?ѩWҵO\]0^Jk@~4#<iY!ɔ5*-"(S1y (ۛ LNyX}oFyKs°[ZVz |l/_h ̧ < /v\8r' Y=EH&<#M{4㒗ZϞ݌уp/^*"==vCӦVׯ[ܺa@XQ׎_Ѻxp9Wl\4Goܹ-:\>q?DX B:4'<,{ʃB4 qBqhpFJZV2Mq t`(K"0<<-sz_OEr֭uR2UjW:{r˩pb9s=}Ko V4{3ʖ azpCENyB^բ4̤͠W \a%ɵ_0&Jؑb9NL|b-ri~~뻥07\=KJY4ɑJ+•\\0'H5 LNyH)CH߫Zf⧛3g6U"r0LS2 Jʊv\۱ck44ҐZ Z6nLrt1C.izVV_r?zye!A$}jQfZ7b{(VXLwXI2QY,QQoVv^ikYz^ia_QO@u6&&޽Ho:A Ç0`m/;vJs 4Ny_59>4ܑ""rMI{G޽>.**:.(B,8v 8j׮9~onM> l Vpbbs͛GFLG3F`377gNM:5jcV]ХCS:5*-RѩNyZ?!!zpE# Aj4'3&Δߣ%y^"sbqza ɠpP;w~aCb@6\ɫY:BtsFTVz֯_pVzE8ۗ.lf#F)۩lƂ_d] ſr] 4ip~?oǩG_̙M իw_B֭KNm}eJ!' @E^{7vAzSʃҜ 2ǓyyxtlDi'+,S??,&&T|FEw`TTp5jTpa$:l>Ξ#_x!ԩ66 ? MH-rFD \0bWjpZ5E^رe 3T/ZެY#yK}8w)NB)O ~OBeOyPQx4>[ܞ?70@J[^SGG&&Z!-#f&7/_^\۶hXLݹKN<}=|Q"IAᔥ:u^<8DyfM ϯ4G$S֨Ny 4߿? TNyX!%(~|9(͢HC;E>zz: M_߭l*Ł`oFIyގh⊓#Hsz! %(k,ւNy( BS=a{ 0 OӇ&&&"6 Fy٧ǨQBe zzH{;D*,\tm@xұco4 nٹ%"ܫuZ^F~Ps'ODbE|6ډ'(Bĕ&A  G;שQiDTzz: M_ߍu˭[{0 6jT>d{z1:\>sfQ~u~@3XK%6viT"4' NyMyQx4ݘ>41/6176)7 a0@.x.qٹ%:|%\O~vMCuv!`@[Ku޼ҫ^*~}x{JW?eJ0nnDB !pbBKZիW'3 'NujTZJ:-Oo۶93v;9AT8pCW-oʃ 2A9wȴ=qۢf;8k֘$Ug Zzu[b8HX}/AeC_81;YI S Jw WifE0=8a8+┇!%('Hu LNyΊ8a{ 0 故 azЯAJB0=WI^ ye!A$}/AFҼ LU @i^Y@*IKQ4',frJJO^ ]ADyqB0mHDE]AAAAA PAA*̩IeuIENDB`java-design-patterns-1.16.0/dao/etc/dao.ucls000066400000000000000000000110761312550536300206060ustar00rootroot00000000000000 java-design-patterns-1.16.0/dao/etc/dao.urm.puml000066400000000000000000000041361312550536300214160ustar00rootroot00000000000000@startuml package com.iluwatar.dao { class App { - DB_URL : String {static} - log : Logger {static} + App() - addCustomers(customerDao : CustomerDao) {static} - createDataSource() : DataSource {static} - createSchema(dataSource : DataSource) {static} - deleteSchema(dataSource : DataSource) {static} + generateSampleCustomers() : List {static} + main(args : String[]) {static} - performOperationsUsing(customerDao : CustomerDao) {static} } class Customer { - firstName : String - id : int - lastName : String + Customer(id : int, firstName : String, lastName : String) + equals(that : Object) : boolean + getFirstName() : String + getId() : int + getLastName() : String + hashCode() : int + setFirstName(firstName : String) + setId(id : int) + setLastName(lastName : String) + toString() : String } interface CustomerDao { + add(Customer) : boolean {abstract} + delete(Customer) : boolean {abstract} + getAll() : Stream {abstract} + getById(int) : Optional {abstract} + update(Customer) : boolean {abstract} } class CustomerSchemaSql { + CREATE_SCHEMA_SQL : String {static} + DELETE_SCHEMA_SQL : String {static} - CustomerSchemaSql() } class DbCustomerDao { - dataSource : DataSource + DbCustomerDao(dataSource : DataSource) + add(customer : Customer) : boolean - createCustomer(resultSet : ResultSet) : Customer + delete(customer : Customer) : boolean + getAll() : Stream + getById(id : int) : Optional - getConnection() : Connection - mutedClose(connection : Connection) + update(customer : Customer) : boolean } class InMemoryCustomerDao { - idToCustomer : Map + InMemoryCustomerDao() + add(customer : Customer) : boolean + delete(customer : Customer) : boolean + getAll() : Stream + getById(id : int) : Optional + update(customer : Customer) : boolean } } DbCustomerDao ..|> CustomerDao InMemoryCustomerDao ..|> CustomerDao @endumljava-design-patterns-1.16.0/dao/pom.xml000066400000000000000000000070101312550536300177060ustar00rootroot00000000000000 4.0.0 com.iluwatar java-design-patterns 1.16.0 dao junit junit test log4j log4j com.h2database h2 de.bechte.junit junit-hierarchicalcontextrunner org.mockito mockito-core src/main/resources src/main/resources log4j.xml .. org.apache.maven.plugins maven-jar-plugin 2.6 log4j.xml true java-design-patterns-1.16.0/dao/src/000077500000000000000000000000001312550536300171625ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/000077500000000000000000000000001312550536300201065ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/java/000077500000000000000000000000001312550536300210275ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/java/com/000077500000000000000000000000001312550536300216055ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/000077500000000000000000000000001312550536300234355ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/000077500000000000000000000000001312550536300242005ustar00rootroot00000000000000java-design-patterns-1.16.0/dao/src/main/java/com/iluwatar/dao/App.java000066400000000000000000000122121312550536300255610ustar00rootroot00000000000000/** * The MIT License * Copyright (c) 2014-2016 Ilkka Seppälä * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.iluwatar.dao; import java.sql.Connection; import java.sql.SQLException; import java.sql.Statement; import java.util.ArrayList; import java.util.List; import java.util.stream.Stream; import javax.sql.DataSource; import org.apache.log4j.Logger; import org.h2.jdbcx.JdbcDataSource; /** * Data Access Object (DAO) is an object that provides an abstract interface to some type of * database or other persistence mechanism. By mapping application calls to the persistence layer, * DAO provide some specific data operations without exposing details of the database. This * isolation supports the Single responsibility principle. It separates what data accesses the * application needs, in terms of domain-specific objects and data types (the public interface of * the DAO), from how these needs can be satisfied with a specific DBMS. * *